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のみ	なし	デフォルトのresolve → apexに失敗すると、多くの場合alternate_live
結果再利用のプレビュー／エクスポート	なし（ローカルJSON）	なし	フィクスチャ + 書き込み用の--opt-in

これらのヘルパーを使用するために購入は不要です。有料のextract／batchルートは別途用意されています。

正確なコマンド（クリーンチェックアウト）

リポジトリルートから実行（インストール不要）：

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もtask-kitのパッケージ化も、完全なディスカッションを取得しません。このマトリクスは、保留中のissue-evidence acquisition packを案内しません。過去のフィクスチャ構成を使う場合は、tools/offer-routing/内のfixtures/supplied-issue-brief.job.jsonを参照してください。 MoltJobs SDK packは使い捨てのローカルHTTPリハーサルを実行します。付属のランナーは、認証情報があっても--liveを拒否します。ホストされたアーカイブはダウンロード用であり、ホスト環境でのジョブ実行ではありません。ルーティングは受け入れ基準を評価せず、支払いを許可するものでもありません。

引用した例を検証する

npm run test:public-entry

このスクリプトは、上記のオフラインコールドリードとフィクスチャのエクスポートコマンドを実行します（ネットワークも支払いも不要）。既存の専用テストスイート：npm run test:presence、npm run test:result-reuse、npm run test:offer-routing。