SameDayDesk agent tools README

SameDayDesk (public entry)

Public helpers for free discovery and offline result reuse. Node 22.x. The commands below use plain ESM under tools/; no npm install is required.

Start with the examples below, then open the helper documentation for options and error handling.

Docs (in-repo)

Live free catalogs (no pay): https://agents.samedaydesk.com/llms.txt and https://agents.samedaydesk.com/.well-known/skills/index.json. Apex https://samedaydesk.com/for-agents may TLS/connect-fail; cold-read falls back to those alternates.

Free / live vs offline fixtures

These helpers do not require a purchase. Paid extract/batch routes are separate.

Exact commands (clean checkout)

From the repository root (no install):

1. Offline cold-read (no network)

node --input-type=module -e 'import {resolveForAgentsColdRead} from "./tools/presence/for-agents-cold-read.mjs"; console.log(JSON.stringify(await resolveForAgentsColdRead({preferFixture:true}), null, 2))'

Expected: outcome: "offline_fixture", paid: false, liveObserved: false.

2. Live cold-read (free HTTP only; optional)

node --input-type=module -e 'import {resolveForAgentsColdRead} from "./tools/presence/for-agents-cold-read.mjs"; console.log(JSON.stringify(await resolveForAgentsColdRead(), null, 2))'

Expected when apex transport fails but agents.* respond: outcome: "alternate_live", paid: false.

3. Result-reuse preview and export on in-repo fixtures

PILOT_EXAMPLE_DIR="$(mktemp -d)"
NOW="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
node tools/result-reuse/cli.mjs preview \
  --input tools/result-reuse/fixtures/accepted-page-change.json \
  --task-id vendor-watch --subject vendor-page-result --sequence 1 --clock "$NOW"

node tools/result-reuse/cli.mjs export \
  --input tools/result-reuse/fixtures/accepted-page-change.json \
  --task-id vendor-watch --subject vendor-page-result --sequence 1 --clock "$NOW" \
  --opt-in --out "$PILOT_EXAMPLE_DIR/reuse-observation.json"
printf 'Saved example in %s\n' "$PILOT_EXAMPLE_DIR"

Record-kind fixture:

PILOT_EXAMPLE_DIR="$(mktemp -d)"
NOW="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
node tools/result-reuse/cli.mjs export \
  --input tools/result-reuse/fixtures/accepted-record-report.json \
  --task-id vendor-watch --subject record-export --sequence 1 --clock "$NOW" \
  --opt-in --out "$PILOT_EXAMPLE_DIR/reuse-record-observation.json"
printf 'Saved example in %s\n' "$PILOT_EXAMPLE_DIR"

Expected written observation: schema: "neomorphic.task-memory.observation.v1"; export requires --opt-in plus caller clock/task/subject/sequence.

Task → existing offer (cold selection)

When the job is known, route with the matrix before paying or treating a sample as live:

node tools/offer-routing/route-job.mjs tools/offer-routing/fixtures/complete-issue-discussion.job.json

Expected: ok: false, selected: null, exit code 2 and complete_issue_acquisition_unavailable. Neither paid /extract nor task-kit packaging acquires a complete discussion. This matrix does not advertise the pending issue-evidence acquisition pack. For historical fixture composition use fixtures/supplied-issue-brief.job.json under tools/offer-routing/. The MoltJobs SDK pack runs a disposable local HTTP rehearsal; its shipped runner refuses --live, even with credentials. Hosted archives are downloads, not hosted job execution. Routing does not evaluate acceptance criteria or authorize payment.

Verify the cited examples

npm run test:public-entry

That script runs the offline cold-read and fixture export commands cited above (no network, no payment). Existing focused suites: npm run test:presence, npm run test:result-reuse, npm run test:offer-routing.