@codespar/cli 0.3.0 → 0.5.0

package/dist/commands/mandate.js

@@ -0,0 +1,85 @@
+import { ApiClient } from "../api.js";
+import { CliError } from "../config.js";
+import { info, json, kv, success } from "../output.js";
+/**
+ * Create a consumer mandate — the agent's "allowance / wallet" — end to end.
+ *
+ * Runs the directed-pay consent flow the way an org backend would:
+ *   1. POST /v1/consents/init      (authed) mints a one-shot token carrying the
+ *      intent (purpose, caps, currency, allowlist).
+ *   2. POST /v1/consents/:token/submit (public) provisions the consumer funding
+ *      source and signs the mandate with the consumer secret.
+ * Prints the mandate id you then hand to `codespar spend`. The consumer's
+ * on-chain wallet (for usdc-onchain) is derived from the consumer id, so the
+ * same consumer keeps the same wallet across mandates.
+ */
+export async function mandateCreateCommand(opts) {
+    if (!opts.consumer)
+        throw new CliError("--consumer <id> is required.");
+    if (!opts.agent)
+        throw new CliError("--agent <id> is required.");
+    if (!opts.purpose)
+        throw new CliError("--purpose <text> is required.");
+    const allowlist = (opts.payee ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (allowlist.length === 0) {
+        throw new CliError("--payee is required (allowlisted payee: x402 URL, EVM address, or Pix key; comma-separated for several).");
+    }
+    const capMinor = Number(opts.cap);
+    const perTxMinor = Number(opts.perTxCap);
+    const ttl = Number(opts.ttl);
+    if (!Number.isInteger(capMinor) || capMinor <= 0) {
+        throw new CliError("--cap must be a positive integer in minor units (cents).");
+    }
+    if (!Number.isInteger(perTxMinor) || perTxMinor <= 0) {
+        throw new CliError("--per-tx-cap must be a positive integer in minor units (cents).");
+    }
+    if (!Number.isInteger(ttl) || ttl <= 0) {
+        throw new CliError("--ttl must be a positive integer (seconds).");
+    }
+    const client = new ApiClient({
+        apiKey: opts.apiKey,
+        baseUrl: opts.baseUrl,
+        project: opts.project,
+    });
+    // 1. Mint the consent token (authed).
+    const init = await client.post("/v1/consents/init", {
+        agent_id: opts.agent,
+        intent: {
+            purpose: opts.purpose,
+            cap_minor: capMinor,
+            per_tx_cap_minor: perTxMinor,
+            currency: opts.currency,
+            mandate_ttl_seconds: ttl,
+            merchant_allowlist: allowlist,
+            merchant_pin_kind: opts.pinKind,
+        },
+    });
+    // 2. Submit the consumer side → funding source + signed mandate (public; the
+    //    token in the URL is the auth, so an extra bearer header is ignored).
+    const submit = await client.post(`/v1/consents/${encodeURIComponent(init.token)}/submit`, {
+        consumer_id: opts.consumer,
+        rail: opts.rail,
+        provider_token: opts.providerToken ?? `${opts.rail}:${opts.consumer}`,
+    });
+    if (opts.json) {
+        json(submit);
+        return;
+    }
+    const mandateId = submit.mandate_id ?? "(unknown)";
+    success("mandate created");
+    kv([
+        ["mandate", mandateId],
+        ["consumer", opts.consumer],
+        ["agent", opts.agent],
+        ["purpose", opts.purpose],
+        ["allowlist", allowlist.join(", ")],
+        ["per-tx cap", `${perTxMinor} ${opts.currency} (minor)`],
+        ["total cap", `${capMinor} ${opts.currency} (minor)`],
+        ["rail", opts.rail],
+    ]);
+    info(`Spend against it:\n  codespar spend --mandate ${mandateId} --payee ${allowlist[0]} --amount 1 --agent ${opts.agent}`);
+}
+//# sourceMappingURL=mandate.js.map

package/dist/commands/mandate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandate.js","sourceRoot":"","sources":["../../src/commands/mandate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqBvD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAA0B;IACnE,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,2BAA2B,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;SACjC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAChB,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,QAAQ,CAAC,0DAA0D,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,QAAQ,CAAC,iEAAiE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,QAAQ,CAAC,6CAA6C,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAwC,mBAAmB,EAAE;QACzF,QAAQ,EAAE,IAAI,CAAC,KAAK;QACpB,MAAM,EAAE;YACN,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,QAAQ;YACnB,gBAAgB,EAAE,UAAU;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,mBAAmB,EAAE,GAAG;YACxB,kBAAkB,EAAE,SAAS;YAC7B,iBAAiB,EAAE,IAAI,CAAC,OAAO;SAChC;KACF,CAAC,CAAC;IAEH,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EACvD;QACE,WAAW,EAAE,IAAI,CAAC,QAAQ;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,aAAa,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE;KACtE,CACF,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAI,MAAM,CAAC,UAAqB,IAAI,WAAW,CAAC;IAC/D,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC;QACD,CAAC,SAAS,EAAE,SAAS,CAAC;QACtB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC3B,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;QACrB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;QACzB,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC,YAAY,EAAE,GAAG,UAAU,IAAI,IAAI,CAAC,QAAQ,UAAU,CAAC;QACxD,CAAC,WAAW,EAAE,GAAG,QAAQ,IAAI,IAAI,CAAC,QAAQ,UAAU,CAAC;QACrD,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;KACpB,CAAC,CAAC;IACH,IAAI,CACF,iDAAiD,SAAS,YAAY,SAAS,CAAC,CAAC,CAAC,uBAAuB,IAAI,CAAC,KAAK,EAAE,CACtH,CAAC;AACJ,CAAC"}

package/dist/commands/meta-input.js

@@ -0,0 +1,33 @@
+import { readFile } from "node:fs/promises";
+import { CliError } from "../config.js";
+/**
+ * Resolve a meta-tool command's args from `--input '<json>'` or
+ * `--input-file <path>`. Shared by the `ledger` / `issue` commands (and
+ * a good target for charge/ship to migrate onto). Returns a parsed JSON
+ * object or throws a CliError with an actionable message.
+ */
+export async function resolveMetaInput(opts, name, example) {
+    if (opts.input && opts.inputFile) {
+        throw new CliError("Pass either --input or --input-file, not both.");
+    }
+    if (!opts.input && !opts.inputFile) {
+        throw new CliError(`${name} requires --input '<json>' or --input-file <path>. Example: --input '${example}'`);
+    }
+    const raw = opts.inputFile
+        ? await readFile(opts.inputFile, "utf-8")
+        : opts.input;
+    const source = opts.inputFile ?? "--input";
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new CliError(`${source} must be a JSON object.`);
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new CliError(`${source} is not valid JSON: ${err.message}`);
+    }
+}
+//# sourceMappingURL=meta-input.js.map

package/dist/commands/meta-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-input.js","sourceRoot":"","sources":["../../src/commands/meta-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA4C,EAC5C,IAAY,EACZ,OAAe;IAEf,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAAC,gDAAgD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,wEAAwE,OAAO,GAAG,CAC1F,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS;QACxB,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACzC,CAAC,CAAE,IAAI,CAAC,KAAgB,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,QAAQ,CAAC,GAAG,MAAM,yBAAyB,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,MAAM,GAAG,CAAC;QACvC,MAAM,IAAI,QAAQ,CAAC,GAAG,MAAM,uBAAwB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/dist/commands/payment-status.js

@@ -0,0 +1,80 @@
+import { CodeSpar } from "@codespar/sdk";
+import { CliError } from "../config.js";
+import { info, json, success, warn } from "../output.js";
+const DEFAULT_TIMEOUT_MS = 600_000;
+/**
+ * Wraps `session.paymentStatus(toolCallId)` (default: poll once) and
+ * `session.paymentStatusStream(toolCallId, ...)` when `--stream` is
+ * passed. Ctrl+C aborts the stream cleanly via AbortController.
+ */
+export async function paymentStatusCommand(toolCallId, opts) {
+    if (!toolCallId) {
+        throw new CliError("tool-call id is required. Example: `codespar payment-status tcl_abc123`");
+    }
+    const timeoutMs = opts.timeout ? Number(opts.timeout) : DEFAULT_TIMEOUT_MS;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new CliError("--timeout must be a positive integer (milliseconds).");
+    }
+    const userId = opts.user ?? "cli-user";
+    const cs = new CodeSpar({ apiKey: opts.apiKey, baseUrl: opts.baseUrl, projectId: opts.project });
+    const session = await cs.create(userId, { servers: [] });
+    try {
+        if (opts.stream) {
+            await runStream(session, toolCallId, timeoutMs, Boolean(opts.json));
+        }
+        else {
+            const result = await session.paymentStatus(toolCallId);
+            renderResult(result, Boolean(opts.json));
+        }
+    }
+    finally {
+        await session.close();
+    }
+}
+async function runStream(session, toolCallId, timeoutMs, asJson) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const onSigint = () => {
+        warn("Aborted by user.");
+        controller.abort();
+    };
+    process.on("SIGINT", onSigint);
+    try {
+        let updates = 0;
+        const final = await session.paymentStatusStream(toolCallId, {
+            signal: controller.signal,
+            onUpdate: (envelope) => {
+                updates++;
+                if (asJson) {
+                    json(envelope);
+                }
+                else {
+                    info(`update #${updates}: payment_status=${envelope.payment_status}  events=${envelope.events.length}`);
+                }
+            },
+        });
+        renderResult(final, asJson);
+    }
+    catch (err) {
+        if (err.name === "AbortError") {
+            throw new CliError("payment-status stream timed out or was aborted.");
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timer);
+        process.off("SIGINT", onSigint);
+    }
+}
+function renderResult(result, asJson) {
+    if (asJson) {
+        json(result);
+        return;
+    }
+    success(`payment_status: ${result.payment_status}`);
+    info(`tool_call_id: ${result.tool_call_id}`);
+    info(`original_status: ${result.original_status}`);
+    info(`idempotency_key: ${result.idempotency_key ?? "-"}`);
+    info(`events: ${result.events.length}`);
+}
+//# sourceMappingURL=payment-status.js.map

package/dist/commands/payment-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-status.js","sourceRoot":"","sources":["../../src/commands/payment-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAYzD,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,IAAiC;IAEjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAChB,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,QAAQ,CAAC,sDAAsD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACvD,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,OAAgD,EAChD,UAAkB,EAClB,SAAiB,EACjB,MAAe;IAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACzB,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,IAAI,CAAC;QACH,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,UAAU,EAAE;YAC1D,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACrB,OAAO,EAAE,CAAC;gBACV,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACN,IAAI,CACF,WAAW,OAAO,oBAAoB,QAAQ,CAAC,cAAc,YAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAClG,CAAC;gBACJ,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAAa,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACzC,MAAM,IAAI,QAAQ,CAAC,iDAAiD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAA2B,EAAE,MAAe;IAChE,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IACD,OAAO,CAAC,mBAAmB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,oBAAoB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,oBAAoB,MAAM,CAAC,eAAe,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/commands/ship.js

@@ -0,0 +1,53 @@
+import { CodeSpar } from "@codespar/sdk";
+import { CliError } from "../config.js";
+import { info, json, success } from "../output.js";
+import { resolveMetaInput } from "./meta-input.js";
+const EXAMPLE = '{"action":"quote","origin":{"postal_code":"01310100"},"destination":{"postal_code":"22041011"},"items":[{"weight_g":500}]}';
+/**
+ * Wraps `session.ship(args)`. Three actions over a unified envelope —
+ * `label`, `quote`, `track`. Like charge, the meta-tool picks the
+ * carrier so no `--server` is required.
+ */
+export async function shipCommand(opts) {
+    const args = (await resolveMetaInput(opts, "ship", EXAMPLE));
+    validateShipArgs(args);
+    const userId = opts.user ?? "cli-user";
+    const cs = new CodeSpar({ apiKey: opts.apiKey, baseUrl: opts.baseUrl, projectId: opts.project });
+    const session = await cs.create(userId, { servers: [] });
+    try {
+        const result = await session.ship(args);
+        if (opts.json) {
+            json(result);
+            return;
+        }
+        success(`ship ${result.id} → ${result.status}`);
+        if (result.tracking_code)
+            info(`Tracking: ${result.tracking_code}`);
+        if (result.carrier)
+            info(`Carrier: ${result.carrier}`);
+        if (result.label_url)
+            info(`Label URL: ${result.label_url}`);
+        if (result.estimated_delivery)
+            info(`ETA: ${result.estimated_delivery}`);
+        if (typeof result.cost_minor === "number")
+            info(`Cost (minor units): ${result.cost_minor}`);
+    }
+    finally {
+        await session.close();
+    }
+}
+function validateShipArgs(args) {
+    if (!args.action || !["label", "quote", "track"].includes(args.action)) {
+        throw new CliError("ship.action must be one of: label, quote, track.");
+    }
+    if (args.action === "track" && !args.tracking_code) {
+        throw new CliError("ship.tracking_code is required when action=track.");
+    }
+    if ((args.action === "label" || args.action === "quote") && (!args.origin || !args.destination)) {
+        throw new CliError("ship.origin and ship.destination are required when action=label|quote.");
+    }
+    if ((args.action === "label" || args.action === "quote") && (!args.items || args.items.length === 0)) {
+        throw new CliError("ship.items must contain at least one item when action=label|quote.");
+    }
+}
+//# sourceMappingURL=ship.js.map

package/dist/commands/ship.js.map

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

package/dist/commands/spend.js

@@ -0,0 +1,41 @@
+import { ApiClient } from "../api.js";
+import { CliError } from "../config.js";
+import { info, json, success } from "../output.js";
+/**
+ * Execute an agentic spend against a consumer mandate:
+ *   POST /v1/consumers/mandates/:id/spend  { amount_minor, payee, agent_id }
+ *
+ * The SDK doesn't expose the consumer-mandate spend flow, so we hit the REST
+ * endpoint directly. The backend reconstructs + signs the stored mandate,
+ * runs the per-tx cap gate, and dispatches the rail by payee shape:
+ *   - Pix key / BR Code  → Pix (pix-celcoin / PSP)
+ *   - EVM address        → direct USDC transfer on Base (CDP)
+ *   - http(s) URL        → x402 pay-per-call (USDC on Base, settled on-chain)
+ */
+export async function spendCommand(opts) {
+    if (!opts.mandate)
+        throw new CliError("--mandate <id> is required.");
+    if (!opts.payee) {
+        throw new CliError("--payee is required (a Pix key, EVM address, or x402 resource URL).");
+    }
+    const amountMinor = Number(opts.amount);
+    if (!Number.isInteger(amountMinor) || amountMinor <= 0) {
+        throw new CliError("--amount must be a positive integer in minor units (cents).");
+    }
+    if (!opts.agent)
+        throw new CliError("--agent <id> is required.");
+    const client = new ApiClient({
+        apiKey: opts.apiKey,
+        baseUrl: opts.baseUrl,
+        project: opts.project,
+    });
+    const result = await client.post(`/v1/consumers/mandates/${encodeURIComponent(opts.mandate)}/spend`, { amount_minor: amountMinor, payee: opts.payee, agent_id: opts.agent });
+    if (opts.json) {
+        json(result);
+        return;
+    }
+    success("spend executed");
+    info("The on-chain tx / receipt is in the response below:");
+    json(result);
+}
+//# sourceMappingURL=spend.js.map

package/dist/commands/spend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend.js","sourceRoot":"","sources":["../../src/commands/spend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAanD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAChB,qEAAqE,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,QAAQ,CAAC,6DAA6D,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,2BAA2B,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,0BAA0B,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAClE,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CACvE,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IACD,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1B,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,CAAC;AACf,CAAC"}

package/dist/commands/verification-status.js

@@ -0,0 +1,82 @@
+import { CodeSpar } from "@codespar/sdk";
+import { CliError } from "../config.js";
+import { info, json, success, warn } from "../output.js";
+const DEFAULT_TIMEOUT_MS = 600_000;
+/**
+ * KYC sibling of payment-status. Default poll once; `--stream` opens
+ * an SSE channel and prints each `update` until the terminal frame.
+ * Ctrl+C cancels via AbortController.
+ */
+export async function verificationStatusCommand(toolCallId, opts) {
+    if (!toolCallId) {
+        throw new CliError("tool-call id is required. Example: `codespar verification-status tcl_abc123`");
+    }
+    const timeoutMs = opts.timeout ? Number(opts.timeout) : DEFAULT_TIMEOUT_MS;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new CliError("--timeout must be a positive integer (milliseconds).");
+    }
+    const userId = opts.user ?? "cli-user";
+    const cs = new CodeSpar({ apiKey: opts.apiKey, baseUrl: opts.baseUrl, projectId: opts.project });
+    const session = await cs.create(userId, { servers: [] });
+    try {
+        if (opts.stream) {
+            await runStream(session, toolCallId, timeoutMs, Boolean(opts.json));
+        }
+        else {
+            const result = await session.verificationStatus(toolCallId);
+            renderResult(result, Boolean(opts.json));
+        }
+    }
+    finally {
+        await session.close();
+    }
+}
+async function runStream(session, toolCallId, timeoutMs, asJson) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const onSigint = () => {
+        warn("Aborted by user.");
+        controller.abort();
+    };
+    process.on("SIGINT", onSigint);
+    try {
+        let updates = 0;
+        const final = await session.verificationStatusStream(toolCallId, {
+            signal: controller.signal,
+            onUpdate: (envelope) => {
+                updates++;
+                if (asJson) {
+                    json(envelope);
+                }
+                else {
+                    info(`update #${updates}: verification_status=${envelope.verification_status}  events=${envelope.events.length}`);
+                }
+            },
+        });
+        renderResult(final, asJson);
+    }
+    catch (err) {
+        if (err.name === "AbortError") {
+            throw new CliError("verification-status stream timed out or was aborted.");
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timer);
+        process.off("SIGINT", onSigint);
+    }
+}
+function renderResult(result, asJson) {
+    if (asJson) {
+        json(result);
+        return;
+    }
+    success(`verification_status: ${result.verification_status}`);
+    info(`tool_call_id: ${result.tool_call_id}`);
+    info(`original_status: ${result.original_status}`);
+    info(`idempotency_key: ${result.idempotency_key ?? "-"}`);
+    if (result.hosted_url)
+        info(`hosted_url: ${result.hosted_url}`);
+    info(`events: ${result.events.length}`);
+}
+//# sourceMappingURL=verification-status.js.map

package/dist/commands/verification-status.js.map

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

package/dist/commands/wizard.js

@@ -0,0 +1,107 @@
+import { CodeSpar } from "@codespar/sdk";
+import { CliError } from "../config.js";
+import { c, info, json, kv, success, table } from "../output.js";
+/**
+ * Wraps `session.connectionWizard(options)`. The SDK expects a
+ * `ConnectionWizardOptions` (action defaults to "list" without a
+ * server_id, "status" with one). The CLI takes the server-id as the
+ * positional argument; pass nothing to list all connections.
+ */
+export async function wizardCommand(serverId, opts) {
+    if (opts.action && !["list", "status", "initiate"].includes(opts.action)) {
+        throw new CliError("--action must be one of: list, status, initiate.");
+    }
+    if (opts.environment && !["live", "test"].includes(opts.environment)) {
+        throw new CliError("--environment must be 'live' or 'test'.");
+    }
+    const wizardOpts = {};
+    if (serverId)
+        wizardOpts.server_id = serverId;
+    if (opts.action)
+        wizardOpts.action = opts.action;
+    if (opts.country)
+        wizardOpts.country = opts.country;
+    if (opts.environment)
+        wizardOpts.environment = opts.environment;
+    if (opts.returnTo)
+        wizardOpts.return_to = opts.returnTo;
+    const userId = opts.user ?? "cli-user";
+    const cs = new CodeSpar({ apiKey: opts.apiKey, baseUrl: opts.baseUrl, projectId: opts.project });
+    const session = await cs.create(userId, { servers: [] });
+    try {
+        const result = await session.connectionWizard(wizardOpts);
+        if (opts.json) {
+            json(result);
+            return;
+        }
+        renderWizardResult(result);
+    }
+    finally {
+        await session.close();
+    }
+}
+function renderWizardResult(result) {
+    if (result.action === "list") {
+        if (result.connections.length === 0) {
+            process.stderr.write(c.dim("(no connections)\n"));
+            return;
+        }
+        table(["SERVER", "AUTH", "STATUS", "DIFFICULTY", "CONNECTED"], result.connections.map((row) => [
+            row.server_id,
+            row.auth_type,
+            row.status,
+            row.difficulty,
+            row.connected_at ? new Date(row.connected_at).toISOString().slice(0, 10) : "-",
+        ]));
+        return;
+    }
+    if (result.action === "status") {
+        if (!result.status) {
+            process.stderr.write(c.dim("(no status returned)\n"));
+            return;
+        }
+        const s = result.status;
+        success(`${s.server_id} → ${s.status}`);
+        kv([
+            ["display_name", s.display_name],
+            ["auth_type", s.auth_type],
+            ["difficulty", s.difficulty],
+            ["connected_at", s.connected_at ?? "-"],
+        ]);
+        return;
+    }
+    if (result.action === "initiate") {
+        if (!result.initiate) {
+            process.stderr.write(c.dim("(no instructions returned)\n"));
+            return;
+        }
+        const i = result.initiate;
+        success(`${i.display_name} (${i.auth_type}) → ${i.status}`);
+        kv([
+            ["server_id", i.server_id],
+            ["difficulty", i.difficulty],
+            ["connect_url", i.connect_url],
+            ["next_action", i.next_action],
+        ]);
+        if (i.required_secrets.length > 0) {
+            process.stdout.write("\n");
+            info("Required secrets:");
+            for (const s of i.required_secrets) {
+                process.stdout.write(`  - ${s.name}${s.hint ? `  ${c.dim(`(${s.hint})`)}` : ""}\n`);
+            }
+        }
+        if (i.instructions.length > 0) {
+            process.stdout.write("\n");
+            info("Instructions:");
+            i.instructions.forEach((line, idx) => process.stdout.write(`  ${idx + 1}. ${line}\n`));
+        }
+        if (i.known_pitfalls.length > 0) {
+            process.stdout.write("\n");
+            info("Known pitfalls:");
+            for (const p of i.known_pitfalls) {
+                process.stdout.write(`  - ${p}\n`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=wizard.js.map

package/dist/commands/wizard.js.map

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