@mantle-agent/cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,52 @@
-# Temporary Holding Version
+# @mantle-agent/cli
 
-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.
+`mantle-agent`: connect any AI agent (Claude Code, Codex, Grok Bot, OpenClaw, …) to a Mantle Agent Account. The
+same tools are available as CLI commands (`--json`, stable error codes) and as an MCP server.
+
+```bash
+npm install -g @mantle-agent/cli
+mantle-agent connect --api https://agent-api.example --name my-agent --host claude-code
+# open the printed link, compare the fingerprint, approve and authorize limits on the confirmation page
+```
+
+| Command | MCP tool | |
+|---|---|---|
+| `guide` | — | Usage and safety rules for agents. Agents should read this first. |
+| `connect --api <url> [--no-wait] [limits]` | — | Link this agent to an account and propose limits; the owner claims and confirms in one visit |
+| `install-skill [--host\|--dir]` | — | Copy the skill into Claude Code / Codex skills directories |
+| `status` | `status` | Balance, remaining limits, credentials, recent trades |
+| `quote buy <token> <amount>` | `quote` | Price a trade |
+| `trade buy\|sell <token> <amount> [--request-id]` | `trade` | Quote + execute, waits for confirmation |
+| `trade-status <intentId>` | `trade_status` | |
+| `runtime` / `pause` | `runtime_status` / `pause` | Scheduled runs |
+| `stop` | `stop` | Emergency stop (revokes this agent's credentials; returns the owner's revoke link) |
+| `authorize [limits]` | `request_authorize` | Ask the owner to authorize trading |
+| `renew --days <n>` / `revoke` | `request_renew` / `request_revoke` | Ask the owner to extend / revoke |
+| `withdraw <MNT\|token> <amount\|all> --to <addr>` | `request_withdraw` | Ask the owner to withdraw (address from the owner) |
+| `auto-run [...] \| --off` / `resume` | `request_auto_run` / `request_resume` | Ask the owner to change scheduled runs |
+| `request-status [id]` | `request_status` | What the owner did with a request |
+| `run --host <h> -- <cmd…>` | — | One scheduled run under a lease (for cron) |
+| `schedule --host <h>` | — | Prints a cron entry (does not install it) |
+| `mcp` | — | MCP server on stdio |
+
+Amounts are whole units with 18 decimals (`--wei` for raw integers). State lives in `~/.mantle-agent`
+(`--home` / `MANTLE_AGENT_HOME`); the agent key and credentials are written `0600` and never printed.
+
+Everything the owner decides is asked for **in the chat**: the agent runs one of the request commands and relays the
+link and summary; the owner confirms on the page with a passkey (nothing to fill in there). `limits` are
+`--per-trade 2 --period 10 --period-hours 24 --total 20 --days 7 --slippage 2` (MNT, %; these are the defaults).
+
+**Hosts with skills** (Claude Code, Codex): `mantle-agent install-skill` (or `--host claude-code|codex`, `--dir <skills
+dir>`), then just say *"connect my Mantle agent account, API is <API_URL>"*. The agent runs `connect --no-wait`, shows
+you the link, code and fingerprint, and picks up the approval on its next `status`.
+
+**Other hosts that can run commands** (Grok Bot, OpenClaw, …) need one instruction: *"Use the `mantle-agent` command
+for my Mantle Agent Account; run `mantle-agent guide` first and follow it."*
+
+**MCP hosts**: `claude mcp add mantle-agent -- mantle-agent mcp`, or in a JSON config:
+
+```json
+{ "mcpServers": { "mantle-agent": { "command": "mantle-agent", "args": ["mcp"] } } }
+```
+
+The skill (`skill/mantle-agent/SKILL.md`) is the same text `mantle-agent guide` prints.

package/dist/api.d.ts

@@ -0,0 +1,22 @@
+import type { CredentialKind, Credentials } from "./store.js";
+/** A failure with the API's stable error code (or a local one), surfaced as-is by CLI and MCP. */
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(code: string, message: string, details?: unknown | undefined);
+}
+/** Thin client over the Agent API. Each call picks the narrowest credential that can make it. */
+export declare class AgentApi {
+    readonly baseUrl: string;
+    private readonly credentials;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, credentials: Credentials | null, fetchImpl?: typeof fetch);
+    request<T>(method: "GET" | "POST", path: string, opts?: {
+        auth?: CredentialKind;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<{
+        status: number;
+        body: T;
+    }>;
+}

package/dist/api.js

@@ -0,0 +1,48 @@
+/** A failure with the API's stable error code (or a local one), surfaced as-is by CLI and MCP. */
+export class CliError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+    }
+}
+/** Thin client over the Agent API. Each call picks the narrowest credential that can make it. */
+export class AgentApi {
+    baseUrl;
+    credentials;
+    fetchImpl;
+    constructor(baseUrl, credentials, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.credentials = credentials;
+        this.fetchImpl = fetchImpl;
+    }
+    async request(method, path, opts = {}) {
+        const headers = { ...opts.headers };
+        if (opts.body !== undefined)
+            headers["content-type"] = "application/json";
+        if (opts.auth) {
+            const credential = this.credentials?.[opts.auth];
+            if (!credential)
+                throw new CliError("NOT_CONNECTED", "no credentials; run `mantle-agent connect` first");
+            headers["authorization"] = `Bearer ${credential.token}`;
+        }
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                ...(opts.body === undefined ? {} : { body: JSON.stringify(opts.body) }),
+            });
+        }
+        catch (err) {
+            throw new CliError("API_UNREACHABLE", `cannot reach ${this.baseUrl}`, { reason: String(err) });
+        }
+        const body = (await res.json().catch(() => ({})));
+        if (res.status >= 400)
+            throw new CliError(body.code ?? `HTTP_${res.status}`, body.message ?? res.statusText, body.details);
+        return { status: res.status, body };
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEtB;IAEA;IAHX,YACW,IAAY,EACrB,OAAe,EACN,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAU;IAG5B,CAAC;CACF;AAED,iGAAiG;AACjG,MAAM,OAAO,QAAQ;IAER;IACQ;IACA;IAHnB,YACW,OAAe,EACP,WAA+B,EAC/B,YAA0B,KAAK;QAFvC,YAAO,GAAP,OAAO,CAAQ;QACP,gBAAW,GAAX,WAAW,CAAoB;QAC/B,cAAS,GAAT,SAAS,CAAsB;IAC/C,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,MAAsB,EACtB,IAAY,EACZ,OAAoF,EAAE;QAEtF,MAAM,OAAO,GAA2B,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC1E,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,kDAAkD,CAAC,CAAC;YACzG,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;gBACnD,MAAM;gBACN,OAAO;gBACP,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aACxE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAA+D,CAAC;QAChH,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3H,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "./cli.js";
+process.exitCode = await main(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+export type Io = {
+    out(line: string): void;
+    err(line: string): void;
+};
+/** Runs one CLI invocation; returns the exit code (0 ok, 1 failed, 2 usage). */
+export declare function main(argv: string[], io?: Io, fetchImpl?: typeof fetch): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,277 @@
+import { readFileSync } from "node:fs";
+import { hostname } from "node:os";
+import { parseArgs } from "node:util";
+import { z } from "zod";
+import { AgentClient, ClientError as CliError } from "@mantle-agent/client";
+import { connect, finishPendingClaim } from "./connect.js";
+import { serveStdio } from "./mcp.js";
+import { runScheduled, schedule } from "./run.js";
+import { installSkill, SKILL_FILE } from "./skill.js";
+import { Store } from "./store.js";
+import { limitsFrom, limitsInput, pauseTool, requestAuthorizeTool, requestAutoRunTool, requestRenewTool, requestResumeTool, requestRevokeTool, requestStatusTool, requestWithdrawTool, quoteTool, runtimeStatusTool, statusTool, stopTool, tradeStatusTool, tradeTool, } from "./tools.js";
+const stdio = { out: (l) => process.stdout.write(`${l}\n`), err: (l) => process.stderr.write(`${l}\n`) };
+const USAGE = `mantle-agent — connect an AI agent to a Mantle Agent Account
+
+Agents: run \`mantle-agent guide\` first — it explains every command and the rules you must follow.
+
+Usage:
+  mantle-agent guide               how to use this tool and the safety rules (read this first)
+  mantle-agent connect --api <url> [--name <agent name>] [--host <claude-code|codex|...>] [--no-wait] [--force]
+                       [limits] [--no-authorize]
+                                   --no-wait: print the link for the owner and return; run again to check
+                                   proposes the limits (defaults below) so the owner claims and authorizes in one visit
+  mantle-agent install-skill [--host <claude-code|codex>] [--dir <skills dir>]
+  mantle-agent status
+  mantle-agent quote <buy|sell> <token> <amount> [--wei]
+  mantle-agent trade <buy|sell> <token> <amount> [--wei] [--request-id <id>] [--no-wait]
+  mantle-agent trade-status <intentId>
+  mantle-agent stop
+  mantle-agent runtime             auto-run status (schedule, budgets, current run)
+  mantle-agent pause               pause auto-run (only the owner can resume)
+
+Ask the owner (prints a link + summary; the owner confirms with a passkey):
+  mantle-agent authorize [limits]
+  mantle-agent renew [--days 7]
+  mantle-agent revoke
+  mantle-agent withdraw <MNT|token> <amount|all> --to <owner's address>
+  mantle-agent auto-run [--every <hours>] [--max-trades-per-run 2] [--max-trades-per-day 10]
+                        [--max-spend-per-day 5] [--max-llm-usd-per-day 5] | --off
+  mantle-agent resume              resume auto-run
+  mantle-agent request-status [requestId]
+  limits: [--per-trade 2] [--period 10] [--period-hours 24] [--total 20] [--days 7] [--slippage 2]   (MNT, %)
+
+  mantle-agent run --host <h> -- <agent command…>   one scheduled run under a lease (for cron)
+  mantle-agent schedule --host <claude-code|codex|…> print a cron entry for scheduled runs
+  mantle-agent mcp                 start the MCP server on stdio (same tools)
+
+Global flags: --json (machine-readable output), --home <dir> (default ~/.mantle-agent)
+Amounts are whole units (MNT for buys, tokens for sells) unless --wei is given.`;
+const COMMANDS = new Set(["guide", "connect", "status", "quote", "trade", "trade-status", "stop", "runtime", "pause", "run", "schedule", "mcp", "install-skill",
+    "authorize", "renew", "revoke", "withdraw", "auto-run", "resume", "request-status"]);
+/** Runs one CLI invocation; returns the exit code (0 ok, 1 failed, 2 usage). */
+export async function main(argv, io = stdio, fetchImpl = fetch) {
+    // Everything after `--` is the host command for `run`.
+    const split = argv.indexOf("--");
+    const hostCommand = split >= 0 ? argv.slice(split + 1) : [];
+    if (split >= 0)
+        argv = argv.slice(0, split);
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                json: { type: "boolean", default: false },
+                home: { type: "string" },
+                api: { type: "string" },
+                name: { type: "string" },
+                host: { type: "string" },
+                dir: { type: "string" },
+                wei: { type: "boolean", default: false },
+                "request-id": { type: "string" },
+                "no-wait": { type: "boolean", default: false },
+                force: { type: "boolean", default: false },
+                "no-authorize": { type: "boolean", default: false },
+                "per-trade": { type: "string" },
+                period: { type: "string" },
+                "period-hours": { type: "string" },
+                total: { type: "string" },
+                days: { type: "string" },
+                slippage: { type: "string" },
+                to: { type: "string" },
+                every: { type: "string" },
+                "max-trades-per-run": { type: "string" },
+                "max-trades-per-day": { type: "string" },
+                "max-spend-per-day": { type: "string" },
+                "max-llm-usd-per-day": { type: "string" },
+                off: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+        });
+    }
+    catch (err) {
+        io.err(String(err.message));
+        io.err(USAGE);
+        return 2;
+    }
+    const { values: flags, positionals } = parsed;
+    const [command, ...args] = positionals;
+    if (!command || flags.help) {
+        io.out(USAGE);
+        return command ? 0 : 2;
+    }
+    if (!COMMANDS.has(command)) {
+        io.err(`unknown command: ${command}`);
+        io.err(USAGE);
+        return 2;
+    }
+    if (command === "guide") {
+        io.out(readFileSync(SKILL_FILE, "utf8"));
+        return 0;
+    }
+    const store = new Store(flags.home);
+    const emit = (value, human) => io.out(flags.json ? JSON.stringify(value) : (human ?? JSON.stringify(value, null, 2)));
+    const num = (v) => (v === undefined ? undefined : Number(v));
+    const limitFlags = {
+        ...(flags["per-trade"] ? { perTrade: flags["per-trade"] } : {}),
+        ...(flags.period ? { period: flags.period } : {}),
+        ...(flags["period-hours"] ? { periodHours: num(flags["period-hours"]) } : {}),
+        ...(flags.total ? { total: flags.total } : {}),
+        ...(flags.days ? { days: num(flags.days) } : {}),
+        ...(flags.slippage ? { slippagePercent: num(flags.slippage) } : {}),
+    };
+    try {
+        if (command === "connect") {
+            const apiUrl = flags.api ?? process.env["MANTLE_AGENT_API"] ?? store.pendingClaim()?.apiUrl ?? store.config()?.apiUrl;
+            if (!apiUrl)
+                throw new CliError("INVALID_REQUEST", "--api <url> is required the first time");
+            const existing = store.config();
+            if (existing?.agentId && store.credentials() && !flags.force) {
+                // One identity per home: connecting again would replace this agent's credentials.
+                throw new CliError("ALREADY_CONNECTED", `already connected as "${existing.name}" (${existing.agentId}); use --force to replace it, or --home <dir> / MANTLE_AGENT_HOME for a second agent`, { agentId: existing.agentId, name: existing.name, home: store.dir });
+            }
+            const wait = !flags["no-wait"];
+            const result = await connect(store, {
+                apiUrl,
+                name: flags.name ?? "agent",
+                host: flags.host ?? hostname(),
+                wait,
+                fetchImpl,
+                ...(flags["no-authorize"] ? {} : { authorize: limitsFrom(validate(limitsInput, limitFlags)) }),
+                onClaim: (claim) => {
+                    // With --no-wait the single result line below carries the claim; don't print it twice.
+                    if (wait || !flags.json) {
+                        emit({ event: "claim", ...claim }, `Open ${claim.claimUrl}\nConfirm code ${claim.userCode} and check the key fingerprint ${claim.fingerprint}.` +
+                            (claim.proposal ? `\nThen confirm these limits:\n  ${claim.proposal.join("\n  ")}` : "") +
+                            (wait ? "\nWaiting for approval…" : ""));
+                    }
+                },
+            });
+            if (result.status === "connected") {
+                emit({ event: "connected", agentId: result.agentId, fingerprint: result.fingerprint }, `Connected as agent ${result.agentId}. Credentials saved to ${store.dir}.`);
+            }
+            else {
+                const { claimUrl, userCode, fingerprint, expiresAt, proposal } = result.claim;
+                emit({ event: "awaiting_owner_approval", claimUrl, userCode, fingerprint, expiresAt, proposedLimits: proposal }, `Waiting for the owner. Run \`mantle-agent connect\` or \`mantle-agent status\` again after they approve.`);
+            }
+            return 0;
+        }
+        if (command === "install-skill") {
+            const result = installSkill({ ...(flags.host ? { host: flags.host } : {}), ...(flags.dir ? { dir: flags.dir } : {}) });
+            emit(result, result.installed.length ? `Installed:\n${result.installed.join("\n")}` : "No host found; use --host or --dir.");
+            return 0;
+        }
+        if (command === "schedule") {
+            const result = schedule(store, { host: flags.host ?? "claude-code", cli: "mantle-agent" });
+            emit(result, `${result.note}\n\n${result.cron}\n\nPrompt for each run: ${result.promptFile}`);
+            return 0;
+        }
+        // Pick up an approval that happened since `connect --no-wait`. Still pending: explain how to finish, unless an
+        // earlier connection exists (reconnecting), which keeps working meanwhile.
+        if (store.pendingClaim()) {
+            await finishPendingClaim(store, fetchImpl).catch((err) => {
+                if (!store.config())
+                    throw err;
+            });
+        }
+        const config = store.config();
+        if (!config)
+            throw new CliError("NOT_CONNECTED", "not connected yet; run `mantle-agent connect --api <url> --no-wait`");
+        const lease = process.env["MANTLE_AGENT_LEASE"];
+        const ctx = {
+            client: new AgentClient(config.apiUrl, store.credentials(), { fetch: fetchImpl, ...(lease ? { leaseId: lease } : {}) }),
+        };
+        if (command === "run") {
+            if (hostCommand.length === 0)
+                throw new CliError("INVALID_REQUEST", "usage: mantle-agent run --host <h> -- <agent command…>");
+            return await runScheduled(ctx.client, {
+                host: flags.host ?? config.host ?? hostname(),
+                command: hostCommand,
+                emit: (event) => emit(event),
+            });
+        }
+        if (command === "mcp") {
+            await serveStdio(ctx);
+            return 0;
+        }
+        const unit = flags.wei ? "wei" : undefined;
+        const trade = () => {
+            const [side, token, amount] = args;
+            return { side: side, token: token, amount: amount, ...(unit ? { unit } : {}) };
+        };
+        let result;
+        switch (command) {
+            case "status":
+                result = await statusTool.run(ctx, {});
+                break;
+            case "quote":
+                result = await quoteTool.run(ctx, validate(quoteTool.input, trade()));
+                break;
+            case "trade":
+                result = await tradeTool.run(ctx, validate(tradeTool.input, {
+                    ...trade(),
+                    ...(flags["request-id"] ? { requestId: flags["request-id"] } : {}),
+                    wait: !flags["no-wait"],
+                }));
+                break;
+            case "trade-status":
+                result = await tradeStatusTool.run(ctx, validate(tradeStatusTool.input, { intentId: args[0] }));
+                break;
+            case "stop":
+                result = await stopTool.run(ctx, {});
+                break;
+            case "runtime":
+                result = await runtimeStatusTool.run(ctx, {});
+                break;
+            case "pause":
+                result = await pauseTool.run(ctx, {});
+                break;
+            case "authorize":
+                result = await requestAuthorizeTool.run(ctx, validate(requestAuthorizeTool.input, limitFlags));
+                break;
+            case "renew":
+                result = await requestRenewTool.run(ctx, validate(requestRenewTool.input, { days: num(flags.days) ?? 7 }));
+                break;
+            case "revoke":
+                result = await requestRevokeTool.run(ctx, {});
+                break;
+            case "withdraw":
+                result = await requestWithdrawTool.run(ctx, validate(requestWithdrawTool.input, { asset: args[0], amount: args[1], to: flags.to }));
+                break;
+            case "auto-run":
+                result = await requestAutoRunTool.run(ctx, validate(requestAutoRunTool.input, {
+                    enabled: !flags.off,
+                    ...(flags.every ? { everyHours: num(flags.every) } : {}),
+                    ...(flags["max-trades-per-run"] ? { maxTradesPerRun: num(flags["max-trades-per-run"]) } : {}),
+                    ...(flags["max-trades-per-day"] ? { maxTradesPerDay: num(flags["max-trades-per-day"]) } : {}),
+                    ...(flags["max-spend-per-day"] ? { maxSpendPerDay: flags["max-spend-per-day"] } : {}),
+                    ...(flags["max-llm-usd-per-day"] ? { maxLlmUsdPerDay: num(flags["max-llm-usd-per-day"]) } : {}),
+                }));
+                break;
+            case "resume":
+                result = await requestResumeTool.run(ctx, {});
+                break;
+            case "request-status":
+                result = await requestStatusTool.run(ctx, validate(requestStatusTool.input, args[0] ? { requestId: args[0] } : {}));
+                break;
+        }
+        emit(result);
+        return 0;
+    }
+    catch (err) {
+        const e = err instanceof CliError ? err : new CliError("INTERNAL", String(err));
+        if (flags.json)
+            io.out(JSON.stringify({ error: { code: e.code, message: e.message, details: e.details } }));
+        else
+            io.err(`error ${e.code}: ${e.message}`);
+        return 1;
+    }
+}
+function validate(shape, input) {
+    const parsed = z.object(shape).safeParse(input);
+    if (!parsed.success) {
+        throw new CliError("INVALID_REQUEST", parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; "));
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/connect.d.ts

@@ -0,0 +1,31 @@
+import { type Claim, type Fetch, type SessionLimits } from "@mantle-agent/client";
+import type { PendingClaim, Store } from "./store.js";
+export type ClaimInfo = Claim;
+export type ConnectResult = {
+    status: "connected";
+    agentId: string;
+    fingerprint: string;
+} | {
+    status: "pending";
+    claim: PendingClaim;
+};
+/**
+ * `mantle-agent connect`: the SDK's claim flow with the agent key kept in the local store. The fingerprint the
+ * owner sees is computed here from the local key; a server reporting a different one is refused.
+ *
+ * With `wait: false` it returns as soon as the owner has the link, so an agent can hand it over and end its turn;
+ * running it again (or `status`) reuses the same claim until it is approved or expires.
+ */
+export declare function connect(store: Store, params: {
+    apiUrl: string;
+    name: string;
+    host: string;
+    wait: boolean;
+    /** Limits to propose with the claim; the owner confirms them right after claiming. */
+    authorize?: SessionLimits;
+    onClaim: (claim: ClaimInfo) => void | Promise<void>;
+    pollMs?: number;
+    fetchImpl?: Fetch;
+}): Promise<ConnectResult>;
+/** For commands run before the owner approved: finish a pending claim if it was approved since, else explain. */
+export declare function finishPendingClaim(store: Store, fetchImpl?: Fetch): Promise<void>;

package/dist/connect.js

@@ -0,0 +1,70 @@
+import { ClientError, exchangeClaim, startClaim } from "@mantle-agent/client";
+/**
+ * `mantle-agent connect`: the SDK's claim flow with the agent key kept in the local store. The fingerprint the
+ * owner sees is computed here from the local key; a server reporting a different one is refused.
+ *
+ * With `wait: false` it returns as soon as the owner has the link, so an agent can hand it over and end its turn;
+ * running it again (or `status`) reuses the same claim until it is approved or expires.
+ */
+export async function connect(store, params) {
+    const key = store.agentKey();
+    const fetchOpt = params.fetchImpl ? { fetch: params.fetchImpl } : {};
+    const proposalKey = params.authorize ? JSON.stringify(params.authorize, (_k, v) => (typeof v === "bigint" ? v.toString() : v)) : null;
+    let claim = store.pendingClaim();
+    // A new claim when the proposed limits changed (the owner asked for different numbers), not only on expiry.
+    const reusable = claim && claim.apiUrl === params.apiUrl && Date.parse(claim.expiresAt) > Date.now() && (claim.proposalKey ?? null) === proposalKey;
+    if (!claim || !reusable) {
+        const started = await startClaim({
+            baseUrl: params.apiUrl,
+            agentName: params.name,
+            host: params.host,
+            key,
+            ...(params.authorize ? { authorize: params.authorize } : {}),
+            ...fetchOpt,
+        });
+        if (started.fingerprint !== key.fingerprint) {
+            throw new ClientError("FINGERPRINT_MISMATCH", "server reported a different key fingerprint; do not approve this claim");
+        }
+        claim = { ...started, apiUrl: params.apiUrl, name: params.name, host: params.host, proposalKey };
+        store.savePendingClaim(claim);
+    }
+    await params.onClaim(claim);
+    return checkClaim(store, claim, { wait: params.wait, ...(params.pollMs !== undefined ? { pollMs: params.pollMs } : {}), ...fetchOpt });
+}
+/** Exchanges a started claim for credentials once the owner approved it (once, or polling with `wait`). */
+async function checkClaim(store, claim, opts) {
+    const key = store.agentKey();
+    for (;;) {
+        let result;
+        try {
+            result = await exchangeClaim({ baseUrl: claim.apiUrl, claimId: claim.claimId, key, ...(opts.fetch ? { fetch: opts.fetch } : {}) });
+        }
+        catch (err) {
+            if (err instanceof ClientError && (err.code === "CLAIM_EXPIRED" || err.code === "CLAIM_USED" || err.code === "NOT_FOUND")) {
+                store.savePendingClaim(null);
+            }
+            throw err;
+        }
+        if (result.status === "exchanged") {
+            store.saveCredentials(result.credentials);
+            store.saveConfig({ apiUrl: claim.apiUrl, agentId: result.agentId, name: claim.name, host: claim.host });
+            store.savePendingClaim(null);
+            return { status: "connected", agentId: result.agentId, fingerprint: key.fingerprint };
+        }
+        if (!opts.wait)
+            return { status: "pending", claim };
+        await new Promise((r) => setTimeout(r, opts.pollMs ?? 2_000));
+    }
+}
+/** For commands run before the owner approved: finish a pending claim if it was approved since, else explain. */
+export async function finishPendingClaim(store, fetchImpl) {
+    const pending = store.pendingClaim();
+    if (!pending)
+        throw new ClientError("NOT_CONNECTED", "not connected yet; run `mantle-agent connect --api <url> --no-wait`");
+    const result = await checkClaim(store, pending, { wait: false, ...(fetchImpl ? { fetch: fetchImpl } : {}) });
+    if (result.status === "pending") {
+        const { claimUrl, userCode, fingerprint, expiresAt } = result.claim;
+        throw new ClientError("AWAITING_OWNER_APPROVAL", `the owner has not approved yet: open ${claimUrl}, confirm code ${userCode} and fingerprint ${fingerprint}`, { claimUrl, userCode, fingerprint, expiresAt });
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { AgentClient, ClientError } from "@mantle-agent/client";
+export { main, type Io } from "./cli.js";
+export { connect, type ClaimInfo } from "./connect.js";
+export { createMcpServer, serveStdio } from "./mcp.js";
+export { runScheduled, schedule } from "./run.js";
+export { Store, fingerprintOf, type Config, type Credentials } from "./store.js";
+export { tools, type Tool, type ToolContext } from "./tools.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+export { AgentClient, ClientError } from "@mantle-agent/client";
+export { main } from "./cli.js";
+export { connect } from "./connect.js";
+export { createMcpServer, serveStdio } from "./mcp.js";
+export { runScheduled, schedule } from "./run.js";
+export { Store, fingerprintOf } from "./store.js";
+export { tools } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAW,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAkB,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAiC,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,KAAK,EAA+B,MAAM,YAAY,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolContext } from "./tools.js";
+/**
+ * Same tools as the CLI, as MCP tools. Errors come back as tool results with the API's stable code, so the
+ * model can react to e.g. PER_TRADE_CAP_EXCEEDED instead of retrying blindly.
+ */
+export declare function createMcpServer(ctx: ToolContext): McpServer;
+export declare function serveStdio(ctx: ToolContext): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,32 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ClientError as CliError } from "@mantle-agent/client";
+import { tools } from "./tools.js";
+const VERSION = "0.1.0";
+/**
+ * Same tools as the CLI, as MCP tools. Errors come back as tool results with the API's stable code, so the
+ * model can react to e.g. PER_TRADE_CAP_EXCEEDED instead of retrying blindly.
+ */
+export function createMcpServer(ctx) {
+    const server = new McpServer({ name: "mantle-agent", version: VERSION });
+    for (const tool of tools) {
+        server.registerTool(tool.name, { title: tool.title, description: tool.description, inputSchema: tool.input }, async (input) => {
+            try {
+                const result = await tool.run(ctx, input ?? {});
+                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            }
+            catch (err) {
+                const e = err instanceof CliError ? err : new CliError("INTERNAL", String(err));
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: JSON.stringify({ code: e.code, message: e.message, details: e.details }) }],
+                };
+            }
+        });
+    }
+    return server;
+}
+export async function serveStdio(ctx) {
+    await createMcpServer(ctx).connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map