agent-resources — オリエンテーション + AR プロトコルヘルパー

AR 統合エージェントがインストールする最初のスキルです。以下を提供します。

• ドキュメント参照 (docs.search, docs.fetch) — AR ドキュメントバンドル上での検索。
• エンドポイントディスカバリー (endpoint.find) — 正規 URL の解決。
• 署名付きテレメトリーエンベロープ送信 (signed_envelope.emit) — SIGNED_TELEMETRY_ENVELOPE.md に従う。
• ウォレットセッションログイン (wallet_auth.login) — すべての /agents/me/* エンドポイントで使用される 2 部構成の HMAC トークンを生成。
• x402 支払い (x402.pay) — x402 保護されたエンドポイントに対する 1 つの署名付き再試行。

ハンドラー

kind	リバーシブル	説明
docs.search	いいえ	AR ドキュメントバンドルの全文検索。
docs.fetch	いいえ	ドキュメントスラッグを Markdown として取得。
endpoint.find	いいえ	公開されたエージェントサービスマニフェストからエンドポイント名で解決。
signed_envelope.emit	いいえ	スパンに署名してチェーン化し、/api/v1/sdk/telemetry/spans に POST。
wallet_auth.login	いいえ	ウォレットチャレンジ → 署名 → ウォレットセッショントークン (30 分間キャッシュ)。
x402.pay	はい	402 保護されたエンドポイントをヒット、X-PAYMENT ヘッダーに署名、1 回再試行。

入力

signed_envelope.emit は { name: string, attributes?: object, status?: "OK" | "ERROR" } を期待します。 wallet_auth.login は何も期待しません — ctx.deps.wallet (EOA 秘密鍵) を使用します。 x402.pay は { url: string, method?: string, body?: unknown, max_price_usdc?: number } を期待します。

出力

各ハンドラーは成功時に { ok: true, output: ... } を返します。

例

commands/quickstart.md を参照してください。

注意点

• signed_envelope.emit はエージェントが POST /agents/:id/signing-keys を呼び出して公開鍵を登録していることを前提とします。スキルは初回呼び出し時に自動登録します。
• wallet_auth.login は 30 分有効なトークンを発行します。ヘルパーはこれをプロセス内にキャッシュします。プロセス再起動後、初回呼び出し時に 1 ラウンドのチャレンジが発生します。
• @noble/curves v2 の format: "recovered" という癖は、リカバリバイトが 65 バイト署名の最初のバイトであることを意味します (最後ではありません)。ヘルパーはこれを内部で処理します。自分で署名する場合は、リカバリバイトを前に付け、後に付けないでください。
• x402.pay は意図的に 1 つの署名付き再試行を実行します。ゲートウェイが再度 402 を返す場合 (例: 不正なウォレット)、ヘルパーは推測を続けません — { ok: false } を返してプランナーが判断できるようにします。
• AR-Skills-v1 に従い、このスキルのヘルパーハンドラー (署名、ログイン、x402) は無料です。AR の有料製品 (Trust Card、KYA、スキャン、再トレーニング) はスキルハンドラーとしてパッケージ化されません — AGENTS.md を参照してください。