SameDayDesk agent tools

SameDayDesk（公开入口）

用于免费发现和离线结果复用的公共辅助工具。Node 22.x。以下命令使用 tools/ 下的纯 ESM；无需运行 npm install。

先从以下示例开始，然后打开辅助工具文档查看选项和错误处理方式。

文档（仓库内）

文档	用途
tools/presence/FOR-AGENTS-COLD-READ.md	apex TLS/连接失败时进行免费发现
tools/presence/REGISTRY-CONSUMER.md	MCP Registry version=latest 陷阱
tools/result-reuse/README.md	离线来源 → 任务记忆观察记录
tools/offer-routing/README.md	任务 → 现有 SameDayDesk/Neomorphic 服务
tools/offer-routing/capability-limits-matrix.json	机器可读的能力/限制矩阵

实时免费目录（无需付费）：https://agents.samedaydesk.com/llms.txt 和 https://agents.samedaydesk.com/.well-known/skills/index.json。apex https://samedaydesk.com/for-agents 可能发生 TLS/连接失败；冷读会回退到这些备用地址。

免费/实时与离线样例

模式	网络	付费	方式
离线样例冷读	无	无	preferFixture: true → outcome: "offline_fixture"
实时冷读	仅免费 HTTP	无	默认解析 → apex 失败时通常为 alternate_live
结果复用预览/导出	无（本地 JSON）	无	样例 + --opt-in 以写入

这些辅助工具无需购买。付费提取/批处理路由是独立的。

精确命令（干净检出）

在仓库根目录运行（无需安装）：

1. 离线冷读（无网络）

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))'

预期结果：outcome: "offline_fixture"、paid: false、liveObserved: false。

2. 实时冷读（仅免费 HTTP；可选）

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

当 apex 传输失败但 agents.* 有响应时，预期结果：outcome: "alternate_live"、paid: false。

3. 对仓库内样例进行结果复用预览和导出

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"

记录类型样例：

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"

预期写入的观察记录：schema: "neomorphic.task-memory.observation.v1"；导出需要 --opt-in，以及调用方提供的时钟/任务/主体/序列。

任务 → 现有服务（冷选择）

已知任务时，先使用矩阵进行路由，再考虑付费或将样例视为实时数据：

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

预期结果：ok: false、selected: null、退出代码 2，以及 complete_issue_acquisition_unavailable。付费 /extract 和任务套件打包都无法获取完整讨论串。此矩阵不会宣传待发布的议题证据采集包。若要查看历史样例组合，请使用 tools/offer-routing/ 下的 fixtures/supplied-issue-brief.job.json。 MoltJobs SDK 包会运行一次临时的本地 HTTP 演练；其随附运行器即使提供了凭据也会拒绝 --live。托管归档是下载内容，并非托管式任务执行。路由不会评估验收标准，也不会授权付款。

验证引用的示例

npm run test:public-entry

该脚本会运行上述引用的离线冷读和样例导出命令（无网络、无付费）。现有专项测试套件：npm run test:presence、npm run test:result-reuse、npm run test:offer-routing。