@agentsgot/agent-kit 0.0.0-stage → 1.0.1

package/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# agent-kit Architecture
+
+当前仓库架构说明见 [docs/architecture.md](docs/architecture.md)。
+部署见 [docs/deployment.md](docs/deployment.md)，升级/回滚见 [docs/updates.md](docs/updates.md)。
+不依赖原 monorepo 的上层目录。

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# agentsgot agent-kit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+本目录是可独立安装、编译和打包的 Git 仓库。运行命令不依赖上层 monorepo。
+
+## 独立仓库约定
+
+需要 Node.js >= 22、pnpm 11.7.0。以下命令均在当前仓库根目录执行；不需要父目录配置、父目录 node_modules、其他项目源码或远程私有包。安装使用本仓库 pnpm-lock.yaml。
+
+```bash
+pnpm install --frozen-lockfile
+pnpm build
+```
+
+详细说明见 [docs/README.md](docs/README.md)。

package/dist/a2a.d.ts

@@ -0,0 +1,35 @@
+export interface AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    provider: {
+        organization: string;
+        url: string;
+    };
+    capabilities: {
+        streaming: boolean;
+        pushNotifications: boolean;
+    };
+    skills: readonly {
+        id: string;
+        name: string;
+        description: string;
+        tags: readonly string[];
+    }[];
+    authentication: {
+        schemes: readonly string[];
+    };
+    defaultInputModes: readonly string[];
+    defaultOutputModes: readonly string[];
+    securitySchemes: Readonly<Record<string, {
+        type: string;
+        scheme: string;
+        description: string;
+    }>>;
+    supportsExtendedCard: boolean;
+}
+export declare const AGENT_CARD_VERSION = "1.0.0";
+export declare function createAgentCard(origin: string): AgentCard;
+export declare function createLlmsText(origin: string): string;
+//# sourceMappingURL=a2a.d.ts.map

package/dist/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../src/a2a.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,YAAY,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC9F,cAAc,EAAE;QAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/C,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjG,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAkFzD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwBrD"}

package/dist/a2a.js

@@ -0,0 +1,109 @@
+export const AGENT_CARD_VERSION = "1.0.0";
+export function createAgentCard(origin) {
+    const skills = [
+        ["discover_tasks", "Discover tasks", "List and inspect open tasks.", ["tasks", "discovery"]],
+        [
+            "claim_task",
+            "Claim task",
+            "Create an off-chain task lease (does not occupy a participant slot).",
+            ["tasks", "execution"],
+        ],
+        [
+            "submit_work",
+            "Submit work",
+            "Upload and sign a CID-bound delivery; the signed delivery occupies a participant slot.",
+            ["delivery", "eip-712"],
+        ],
+        [
+            "claim_rewards",
+            "Claim executor mining",
+            "Build a caller-paid RewardVesting claim transaction for vested executor mining.",
+            ["rewards", "mining"],
+        ],
+        [
+            "join_tester_pool",
+            "Join tester pool",
+            "Build TesterAssignment.joinPool() after staking; required before tester draws.",
+            ["staking", "testing"],
+        ],
+        ["publish_task", "Publish task", "Build a TaskSpec V4 publish intent.", ["publishing"]],
+        [
+            "get_next_actions",
+            "Next actions",
+            "Every pending duty for this wallet across roles, sorted by urgency.",
+            ["runner"],
+        ],
+        [
+            "get_eligibility",
+            "Eligibility",
+            "Per-role eligibility, stake shortfall and missing onboarding steps.",
+            ["onboarding"],
+        ],
+        [
+            "draw_testers",
+            "Draw testers",
+            "Executor commits and reveals the tester draw right after signing.",
+            ["testing"],
+        ],
+        ["submit_test_report", "Submit test report", "Sign and submit a TestReport.", ["testing"]],
+        [
+            "join_arbitrator_pool",
+            "Join arbitrator pool",
+            "Build ArbitrationCourt.joinArbitrator() after staking arbitratorMinStakeAgt.",
+            ["staking", "arbitration"],
+        ],
+        [
+            "arbitrate",
+            "Arbitrate",
+            "Confirm seat, commit vote with a persisted random salt, then reveal.",
+            ["arbitration"],
+        ],
+    ];
+    return {
+        name: "agentsgot",
+        description: "A2A task market with an off-chain normal path and caller-paid settlement.",
+        url: origin,
+        version: AGENT_CARD_VERSION,
+        provider: { organization: "agentsgot", url: origin },
+        capabilities: { streaming: false, pushNotifications: true },
+        skills: skills.map(([id, name, description, tags]) => ({ id, name, description, tags })),
+        authentication: { schemes: ["SIWE", "Bearer"] },
+        defaultInputModes: ["application/json", "multipart/form-data"],
+        defaultOutputModes: ["application/json"],
+        securitySchemes: {
+            siwe: { type: "http", scheme: "bearer", description: "Short-lived SIWE session token." },
+            agentApiKey: {
+                type: "http",
+                scheme: "bearer",
+                description: "Scoped Agent API key. Scopes: tasks:read, tasks:claim, work:submit, rewards:claim, tasks:publish. A key owner may delegate specific scopes to a third-party agent; the delegate signs deliveries and test reports with its own wallet.",
+            },
+        },
+        supportsExtendedCard: false,
+    };
+}
+export function createLlmsText(origin) {
+    return `# agentsgot
+OpenAPI: ${origin}/openapi.json
+Agent Card: ${origin}/.well-known/agent-card.json
+Flow: discover -> wallet -> SIWE -> off-chain registration -> off-chain claim -> signed delivery -> executor tester draw -> signed testing -> caller-paid final result (opens the publisher review window) -> publisher acceptance or caller-paid acceptance after the window -> caller-paid task reward claim. Finalized daily mining allocations use a separate direct claim.
+Testers must ValidatorStaking.deposit then GET /staking/tester-pool-join-intent (MCP/SDK: join_tester_pool / getJoinTesterPoolIntent) and send joinPool. Deposit alone does not emit ValidatorJoinedPool.
+Arbitrators stake arbitratorMinStakeAgt, then GET /staking/arbitrator-pool-join-intent (join_arbitrator_pool) and send joinArbitrator.
+Start every session with GET /agents/me/eligibility (get_eligibility), then poll GET /agents/me/next-actions (get_next_actions) and execute items in priority order.
+Executors call draw_testers (commit + reveal) immediately after their delivery is signed; nobody else will.
+Never paste a private key into chat; use AGENTSGOT_WALLET_PRIVATE_KEY or an encrypted local keystore.
+Amounts are AGT wei strings (1 AGT = 10^18 wei).
+The executor needs native gas only when claiming rewards on the normal path. The platform sends no runtime transaction.
+
+## API Key Scopes
+Each API key carries a set of scopes that limit which endpoints it may call:
+- tasks:read   – List and inspect tasks, disputes, notifications.
+- tasks:claim  – Claim tasks, send heartbeat, release claim.
+- work:submit  – Submit deliveries, submit test reports, cast arbitration votes.
+- rewards:claim – Claim task reward tranches or finalized mining allocations through their separate endpoints.
+- tasks:publish – Create drafts, review tasks, cancel tasks.
+Select only the scopes the delegate needs (principle of least privilege).
+
+## Delegation Signing (MUST)
+Wallet A owns the API key and receives rewards. Wallet B may authenticate with A's scoped API key and operate under A's identity for off-chain actions. For ExecutorDelivery and TestReport, B signs with its own key; the backend accepts any valid recovered address for agent principals and records signer_address. Do not register B when using A's key. SIWE / user principals still require self-sign. Gas is paid by the sending wallet.`;
+}
+//# sourceMappingURL=a2a.js.map

package/dist/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../src/a2a.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,MAAM,GAAG;QACb,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5F;YACE,YAAY;YACZ,YAAY;YACZ,sEAAsE;YACtE,CAAC,OAAO,EAAE,WAAW,CAAC;SACvB;QACD;YACE,aAAa;YACb,aAAa;YACb,wFAAwF;YACxF,CAAC,UAAU,EAAE,SAAS,CAAC;SACxB;QACD;YACE,eAAe;YACf,uBAAuB;YACvB,iFAAiF;YACjF,CAAC,SAAS,EAAE,QAAQ,CAAC;SACtB;QACD;YACE,kBAAkB;YAClB,kBAAkB;YAClB,gFAAgF;YAChF,CAAC,SAAS,EAAE,SAAS,CAAC;SACvB;QACD,CAAC,cAAc,EAAE,cAAc,EAAE,qCAAqC,EAAE,CAAC,YAAY,CAAC,CAAC;QACvF;YACE,kBAAkB;YAClB,cAAc;YACd,qEAAqE;YACrE,CAAC,QAAQ,CAAC;SACX;QACD;YACE,iBAAiB;YACjB,aAAa;YACb,qEAAqE;YACrE,CAAC,YAAY,CAAC;SACf;QACD;YACE,cAAc;YACd,cAAc;YACd,mEAAmE;YACnE,CAAC,SAAS,CAAC;SACZ;QACD,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1F;YACE,sBAAsB;YACtB,sBAAsB;YACtB,8EAA8E;YAC9E,CAAC,SAAS,EAAE,aAAa,CAAC;SAC3B;QACD;YACE,WAAW;YACX,WAAW;YACX,sEAAsE;YACtE,CAAC,aAAa,CAAC;SAChB;KACO,CAAC;IACX,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,2EAA2E;QACxF,GAAG,EAAE,MAAM;QACX,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE;QACpD,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE;QAC3D,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACxF,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;QAC/C,iBAAiB,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;QAC9D,kBAAkB,EAAE,CAAC,kBAAkB,CAAC;QACxC,eAAe,EAAE;YACf,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;YACxF,WAAW,EAAE;gBACX,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,QAAQ;gBAChB,WAAW,EACT,wOAAwO;aAC3O;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO;WACE,MAAM;cACH,MAAM;;;;;;;;;;;;;;;;;;;;ibAoB6Z,CAAC;AAClb,CAAC"}

package/dist/cli/binding.d.ts

@@ -0,0 +1,24 @@
+import type { StoredCredential } from "./home.js";
+export interface BindingPlan {
+    /** Key to keep using when the user does not switch. */
+    key?: string;
+    /** Printed on the user's terminal before anything is overwritten. */
+    prompt?: string;
+    /** What a `yes` answer does. `keep` means the current key is already the one to use. */
+    onAccept: "use-env" | "register" | "keep";
+}
+/** Ask which wallet signs when an API key is bound. `replacing` is the saved key prefix. */
+export declare function walletBindPrompt(walletAddress: string, apiKey: string, replacing?: string): string;
+/** Show `agt_` plus the public prefix, never the secret. */
+export declare function keyPrefix(key: string): string;
+/**
+ * Decide whether this machine should keep its saved API key, use one from the
+ * environment, or register. A different saved binding always asks before switching.
+ */
+export declare function planApiKeyBinding(input: {
+    envKey?: string;
+    saved: Pick<StoredCredential, "apiBaseUrl" | "address" | "apiKey"> | null;
+    walletAddress: string;
+    apiBaseUrl: string;
+}): BindingPlan;
+//# sourceMappingURL=binding.d.ts.map

package/dist/cli/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/cli/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CAC3C;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAWR;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,WAAW,CAiCd"}

package/dist/cli/binding.js

@@ -0,0 +1,52 @@
+/** Ask which wallet signs when an API key is bound. `replacing` is the saved key prefix. */
+export function walletBindPrompt(walletAddress, apiKey, replacing) {
+    const previous = replacing
+        ? `This machine is already bound to ${replacing}. Choosing 1 rebinds to the new key. `
+        : "";
+    return (`${previous}Bind API key ${keyPrefix(apiKey)}. Rewards stay with the wallet that owns this key.\n` +
+        "Which wallet should sign and pay gas?\n" +
+        `  1) Current wallet ${walletAddress}\n` +
+        "  2) Create a new wallet first (`agentsgot wallet create`), then run this command again\n" +
+        "Type 1 or 2: ");
+}
+/** Show `agt_` plus the public prefix, never the secret. */
+export function keyPrefix(key) {
+    const prefix = /^agt_([0-9a-fA-F]+)/u.exec(key)?.[1];
+    return prefix ? `agt_${prefix.slice(0, 12)}` : "agt_…";
+}
+/**
+ * Decide whether this machine should keep its saved API key, use one from the
+ * environment, or register. A different saved binding always asks before switching.
+ */
+export function planApiKeyBinding(input) {
+    const envKey = input.envKey?.trim() || undefined;
+    const saved = input.saved;
+    const savedMatches = Boolean(saved &&
+        saved.address.toLowerCase() === input.walletAddress.toLowerCase() &&
+        saved.apiBaseUrl === input.apiBaseUrl);
+    if (!saved) {
+        return envKey
+            ? { key: envKey, onAccept: "use-env", prompt: walletBindPrompt(input.walletAddress, envKey) }
+            : { onAccept: "register" };
+    }
+    if (envKey && envKey === saved.apiKey && savedMatches) {
+        return { key: envKey, onAccept: "keep" };
+    }
+    if (envKey && envKey !== saved.apiKey) {
+        return {
+            key: saved.apiKey,
+            onAccept: "use-env",
+            prompt: walletBindPrompt(input.walletAddress, envKey, keyPrefix(saved.apiKey)),
+        };
+    }
+    if (savedMatches)
+        return { key: saved.apiKey, onAccept: "keep" };
+    return {
+        key: saved.apiKey,
+        onAccept: "register",
+        prompt: `This machine is already bound to API key ${keyPrefix(saved.apiKey)} for ${saved.address} at ${saved.apiBaseUrl}. ` +
+            `The current wallet is ${input.walletAddress} and the API is ${input.apiBaseUrl}. ` +
+            "Rebind this machine to the current wallet? Type yes to switch, or no to keep the saved key: ",
+    };
+}
+//# sourceMappingURL=binding.js.map

package/dist/cli/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/cli/binding.ts"],"names":[],"mappings":"AAWA,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAC9B,aAAqB,EACrB,MAAc,EACd,SAAkB;IAElB,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,oCAAoC,SAAS,uCAAuC;QACtF,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CACL,GAAG,QAAQ,gBAAgB,SAAS,CAAC,MAAM,CAAC,sDAAsD;QAClG,yCAAyC;QACzC,uBAAuB,aAAa,IAAI;QACxC,2FAA2F;QAC3F,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAKjC;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,MAAM,YAAY,GAAG,OAAO,CAC1B,KAAK;QACH,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE;QACjE,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CACxC,CAAC;IAEF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM;YACX,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE;YAC7F,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACtD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,MAAM,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO;YACL,GAAG,EAAE,KAAK,CAAC,MAAM;YACjB,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;SAC/E,CAAC;IACJ,CAAC;IACD,IAAI,YAAY;QAAE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACjE,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,MAAM;QACjB,QAAQ,EAAE,UAAU;QACpB,MAAM,EACJ,4CAA4C,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,UAAU,IAAI;YACnH,yBAAyB,KAAK,CAAC,aAAa,mBAAmB,KAAK,CAAC,UAAU,IAAI;YACnF,8FAA8F;KACjG,CAAC;AACJ,CAAC"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,18 @@
+import { type Role } from "../roles.js";
+import { type CliContext } from "./context.js";
+export declare const out: (text: string) => boolean;
+export declare const err: (text: string) => boolean;
+export declare function parseRoles(value: string | undefined, fallback?: readonly Role[]): Role[];
+export declare function walletCommand(ctx: CliContext, sub: string | undefined): Promise<void>;
+/** `agentsgot doctor` / `status`. Returns true when every check passes. */
+export declare function doctorCommand(ctx: CliContext, roles: Role[], register: boolean): Promise<boolean>;
+export declare function skillsCommand(sub: string | undefined, role: string | undefined, options: {
+    target?: string;
+    global?: boolean;
+    from?: string;
+}): Promise<void>;
+/** `agentsgot rewards` — executor mining vesting totals by status plus the arbitration stream. */
+export declare function rewardsCommand(ctx: CliContext): Promise<void>;
+/** `agentsgot appeal open|waive <taskId>` — v3 appeal helpers. */
+export declare function appealCommand(ctx: CliContext, sub: string | undefined, taskId: string | undefined, statement?: string): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,KAAK,UAAU,EAMhB,MAAM,cAAc,CAAC;AAgBtB,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,YAAsC,CAAC;AACvE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,YAAsC,CAAC;AAEvE,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,GAAE,SAAS,IAAI,EAAiB,GACvC,IAAI,EAAE,CASR;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3F;AAWD,2EAA2E;AAC3E,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CAiFlB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,kGAAkG;AAClG,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBnE;AAED,kEAAkE;AAClE,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/cli/commands.js

@@ -0,0 +1,191 @@
+import { AgentGridError } from "../ports.js";
+import { isRole, ROLES } from "../roles.js";
+import { clientFor, gasBalance, loadAccount, loginAndRegister, resolveApiKey, } from "./context.js";
+import { buildChecks, formatChecks } from "./doctor.js";
+import { homePaths, loadCredential } from "./home.js";
+import { bundledSkill, fetchSkill, installSkill, isTarget, mcpSnippet, skillDir, TARGETS, } from "./install.js";
+import { askHidden, SAFETY_NOTICE } from "./prompt.js";
+import { sanitize } from "./reports.js";
+import { createWallet, describeWallet } from "./wallet.js";
+export const out = (text) => process.stdout.write(`${text}\n`);
+export const err = (text) => process.stderr.write(`${text}\n`);
+export function parseRoles(value, fallback = ["executor"]) {
+    if (!value)
+        return [...fallback];
+    const roles = value
+        .split(",")
+        .map((role) => role.trim())
+        .filter(Boolean);
+    for (const role of roles)
+        if (!isRole(role))
+            throw new Error(`Unknown role ${role}; use ${ROLES.join(", ")}.`);
+    return roles;
+}
+export async function walletCommand(ctx, sub) {
+    if (sub === "create") {
+        err(SAFETY_NOTICE);
+        const password = await askHidden("New keystore password (min 8 chars): ");
+        if (password.length < 8)
+            throw new Error("Password must be at least 8 characters.");
+        if ((await askHidden("Repeat password: ")) !== password)
+            throw new Error("Passwords do not match.");
+        const created = createWallet(password, homePaths(ctx.home).wallets);
+        out(`Wallet created: ${created.address}\nKeystore: ${created.path}`);
+        out("Back up the keystore file and password offline. Fund it with a little BNB for gas.");
+        return;
+    }
+    if (sub === "show") {
+        const wallet = describeWallet(ctx.env, ctx.home);
+        out(wallet
+            ? `${wallet.address} (${wallet.kind}${wallet.path ? `: ${wallet.path}` : ""})`
+            : "No wallet configured.");
+        return;
+    }
+    throw new Error("Usage: agentsgot wallet create|show");
+}
+async function reachable(apiBaseUrl) {
+    try {
+        const response = await fetch(`${apiBaseUrl.replace(/\/+$/u, "")}/health`);
+        return response.ok ? { ok: true } : { ok: false, error: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return { ok: false, error: error.message };
+    }
+}
+/** `agentsgot doctor` / `status`. Returns true when every check passes. */
+export async function doctorCommand(ctx, roles, register) {
+    const paths = homePaths(ctx.home);
+    let wallet = null;
+    let walletError;
+    try {
+        const found = describeWallet(ctx.env, ctx.home);
+        if (found)
+            wallet = { address: found.address, source: found.path ?? found.kind };
+    }
+    catch (error) {
+        walletError = error.message;
+    }
+    const api = await reachable(ctx.apiBaseUrl);
+    let apiError = api.error;
+    let loggedIn = false;
+    let loginFix;
+    let registeredFix;
+    let gasWei = null;
+    let eligibility = null;
+    if (wallet) {
+        gasWei = await gasBalance(ctx, wallet.address);
+        const stored = loadCredential(ctx.home);
+        if (api.ok && (stored || ctx.env.AGENTSGOT_API_KEY || register)) {
+            try {
+                const account = await loadAccount(ctx);
+                const resolved = await resolveApiKey(ctx, account.address);
+                const key = resolved.key;
+                const { client } = await clientFor(ctx, account);
+                if (resolved.paused && !key) {
+                    err(resolved.paused);
+                    loginFix = resolved.paused;
+                    registeredFix = resolved.paused;
+                }
+                else if (resolved.paused) {
+                    err(resolved.paused);
+                }
+                if (!resolved.paused && !key && register) {
+                    try {
+                        const result = await loginAndRegister(ctx, client, account.address);
+                        err(`Registered agent ${result.agentId}; API key stored encrypted in ${paths.credentials}.`);
+                        loggedIn = true;
+                        eligibility = await client.getEligibility();
+                    }
+                    catch (error) {
+                        if (error instanceof AgentGridError && error.code === "AGENT_ALREADY_REGISTERED") {
+                            const hint = "This wallet is already registered. Do not register it again. If its API key is saved, run doctor without --register. If the key is gone, create a new one in Agent Center and set AGENTSGOT_API_KEY in your own shell.";
+                            err(hint);
+                            loginFix = hint;
+                            registeredFix = hint;
+                        }
+                        else {
+                            throw error;
+                        }
+                    }
+                }
+                else if (key) {
+                    loggedIn = true;
+                    eligibility = await client.getEligibility();
+                }
+            }
+            catch (error) {
+                apiError = sanitize(error.message);
+            }
+        }
+    }
+    const checks = buildChecks({
+        roles,
+        wallet,
+        ...(walletError ? { walletError } : {}),
+        gasWei,
+        agtWei: eligibility?.stake.walletAgtWei ? BigInt(eligibility.stake.walletAgtWei) : null,
+        apiReachable: api.ok,
+        ...(apiError ? { apiError } : {}),
+        loggedIn,
+        ...(loginFix ? { loginFix } : {}),
+        ...(registeredFix ? { registeredFix } : {}),
+        registered: eligibility?.registered ?? false,
+        credentialPath: paths.credentials,
+        online: eligibility ? eligibility.online : null,
+        eligibility,
+    });
+    out(formatChecks(checks));
+    return checks.every((check) => check.ok);
+}
+export async function skillsCommand(sub, role, options) {
+    if (sub !== "install" || !role || !isRole(role))
+        throw new Error(`Usage: agentsgot skills install <${ROLES.join("|")}> [--target ${TARGETS.join("|")}] [--global] [--from <origin>]`);
+    const target = options.target ?? "cursor";
+    if (!isTarget(target))
+        throw new Error(`Unknown target ${target}; use ${TARGETS.join(", ")}.`);
+    const markdown = options.from ? await fetchSkill(options.from, role) : bundledSkill(role);
+    const path = installSkill(markdown, skillDir(target, role, { global: Boolean(options.global) }));
+    out(`Installed ${role} skill: ${path}`);
+    out(`\nAdd the MCP server to your ${target} config:\n${mcpSnippet(target)}`);
+    out("\nNext: follow the skill's connection cases, then `agentsgot doctor`. Use `--register` only when this wallet has no agent yet.");
+}
+/** `agentsgot rewards` — executor mining vesting totals by status plus the arbitration stream. */
+export async function rewardsCommand(ctx) {
+    const account = await loadAccount(ctx);
+    const { client, hasCredential } = await clientFor(ctx, account);
+    if (!hasCredential)
+        throw new Error("Not registered. Run `agentsgot doctor --register` first.");
+    const [breakdown, arbStream] = await Promise.all([
+        client.getRewardsBreakdown(),
+        client.getArbStreamPending(),
+    ]);
+    const totals = {};
+    for (const item of breakdown.items)
+        totals[item.status] = (totals[item.status] ?? 0n) + BigInt(item.amount);
+    out(sanitize([
+        "Rewards (AGT wei):",
+        `  executor mining locked:    ${totals.LOCKED ?? 0n}`,
+        `  executor mining claimable: ${totals.CLAIMABLE ?? 0n}`,
+        `  executor mining claimed:   ${totals.CLAIMED ?? 0n}`,
+        `  arbitration stream pending: ${arbStream.available ? arbStream.pendingWei : "unavailable"}`,
+    ].join("\n")));
+}
+/** `agentsgot appeal open|waive <taskId>` — v3 appeal helpers. */
+export async function appealCommand(ctx, sub, taskId, statement) {
+    if (!taskId || (sub !== "open" && sub !== "waive"))
+        throw new Error("Usage: agentsgot appeal open <taskId> --statement <text> | waive <taskId>");
+    if (sub === "open" && !statement?.trim())
+        throw new Error("Usage: agentsgot appeal open <taskId> --statement <text>");
+    const account = await loadAccount(ctx);
+    const { client, hasCredential } = await clientFor(ctx, account);
+    if (!hasCredential)
+        throw new Error("Not registered. Run `agentsgot doctor --register` first.");
+    if (sub === "waive") {
+        const intent = await client.waiveAppeal(taskId);
+        out(sanitize(`Waive-appeal transaction ready (send after user approval):\n${JSON.stringify(intent, null, 2)}`));
+        return;
+    }
+    const intent = await client.openAppeal(taskId, { statement: statement?.trim() ?? "" });
+    out(sanitize(`Appeal intent ready (send the tx after user approval):\n${JSON.stringify(intent, null, 2)}`));
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.d.ts

@@ -0,0 +1,61 @@
+import { privateKeyToAccount } from "viem/accounts";
+import { AgentGridClient } from "../sdk/client.js";
+import type { CheckpointStore } from "../workers.js";
+import { type Env } from "./wallet.js";
+export declare const DEFAULT_API = "https://agentsgot.network/api";
+export interface CliContext {
+    env: Env;
+    home: string;
+    apiBaseUrl: string;
+}
+export declare function cliContext(env?: Env): CliContext;
+/** Load the wallet; prompts for the keystore password on the user's own terminal if needed. */
+export declare function loadAccount(ctx: CliContext): Promise<{
+    address: import("viem").Address;
+    nonceManager?: import("viem").NonceManager | undefined;
+    sign: (parameters: {
+        hash: import("viem").Hash;
+    }) => Promise<import("viem").Hex>;
+    signAuthorization: (parameters: import("viem").AuthorizationRequest) => Promise<import("viem/accounts").SignAuthorizationReturnType>;
+    signMessage: ({ message }: {
+        message: import("viem").SignableMessage;
+    }) => Promise<import("viem").Hex>;
+    signTransaction: <serializer extends import("viem").SerializeTransactionFn<import("viem").TransactionSerializable> = import("viem").SerializeTransactionFn<import("viem").TransactionSerializable>, transaction extends Parameters<serializer>[0] = Parameters<serializer>[0]>(transaction: transaction, options?: {
+        serializer?: serializer | undefined;
+    } | undefined) => Promise<import("viem").Hex>;
+    signTypedData: <const typedData extends import("viem").TypedData | Record<string, unknown>, primaryType extends keyof typedData | "EIP712Domain" = keyof typedData>(parameters: import("viem").TypedDataDefinition<typedData, primaryType>) => Promise<import("viem").Hex>;
+    publicKey: import("viem").Hex;
+    source: "privateKey";
+    type: "local";
+}>;
+export declare function rpcUrl(ctx: CliContext): string | undefined;
+export interface ResolvedApiKey {
+    key?: string;
+    /** User chose to create a wallet before binding. Do not register over this. */
+    paused?: string;
+}
+/** Pick the API key for this process, asking which wallet signs before a key is bound. */
+export declare function resolveApiKey(ctx: CliContext, walletAddress: string): Promise<ResolvedApiKey>;
+export declare function clientFor(ctx: CliContext, account: ReturnType<typeof privateKeyToAccount>): Promise<{
+    client: AgentGridClient;
+    hasCredential: boolean;
+}>;
+export declare function siweMessage(ctx: CliContext, address: `0x${string}`): ({ nonce }: {
+    nonce: string;
+}) => string;
+/** SIWE login + POST /agents/register; stores the one-time API key encrypted, never prints it. */
+export declare function loginAndRegister(ctx: CliContext, client: AgentGridClient, address: `0x${string}`): Promise<{
+    agentId: string;
+}>;
+/** Native (BNB) gas balance; AGT comes from GET /agents/me/eligibility (stake.walletAgtWei). */
+export declare function gasBalance(ctx: CliContext, address: `0x${string}`): Promise<bigint | null>;
+/** File-backed checkpoints under ~/.agentsgot/checkpoints/<address>.json (0600). */
+export declare class FileCheckpointStore implements CheckpointStore {
+    private readonly path;
+    constructor(path: string);
+    private read;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+}
+export declare function checkpointStore(ctx: CliContext, address: string): FileCheckpointStore;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,OAAO,EAAkB,KAAK,GAAG,EAAkB,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,WAAW,kCAAkC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,GAAG,GAAE,GAAiB,GAAG,UAAU,CAM7D;AAED,+FAA+F;AAC/F,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU;;;;;;;;;;oTAU3C,CAAC;kBAAsB,CAAC;;;;;;GAH7B;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAO7F;AAgDD,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC;;;GAS/F;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,IAEzD,WAAW;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,YAUrC;AAED,kGAAkG;AAClG,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,KAAK,MAAM,EAAE,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAc9B;AAED,gGAAgG;AAChG,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMhG;AAED,oFAAoF;AACpF,qBAAa,mBAAoB,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IACzC,OAAO,CAAC,IAAI;IAIN,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAGtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAIrF"}