@artos-commerce/ucp-cli 0.1.0

package/README.md

@@ -0,0 +1,177 @@
+# @artos-commerce/ucp-cli
+
+Command-line tools for building **agents on Artos** (the Universal Commerce
+Protocol). Scaffold an agent UCP profile, run connectivity diagnostics, inspect a
+store's UCP profile, search the cross-store catalog, and drive a full
+cart → checkout → purchase flow (plus buyer-account tools) — without hand-rolling
+the UCP transport, headers, or signing.
+
+It is the **Build track** companion to
+[`@artos-commerce/ucp-client`](https://www.npmjs.com/package/@artos-commerce/ucp-client):
+the CLI uses the SDK under the hood. If you only want an agent (Claude, Cursor)
+to shop, use the hosted **Connect** bridge instead — see the
+[Artos agent docs](https://docs.artos.sh/agents).
+
+## Install
+
+```bash
+npm install -g @artos-commerce/ucp-cli
+# or run ad hoc:
+npx @artos-commerce/ucp-cli --help
+```
+
+Requires **Node 20+**. The crypto settlement rail's `@mysten/sui` is **not**
+needed for any CLI command.
+
+## Configuration
+
+Every command resolves its connection from flags first, then the environment,
+then defaults:
+
+| Setting | Flag | Env | Default |
+| --- | --- | --- | --- |
+| Artos API base URL | `--api` | `ARTOS_BASE_URL` | `https://api.artos.sh` |
+| Platform API key | `--key` | `UCP_PLATFORM_API_KEY` | _(none — anonymous)_ |
+| Agent profile URL | `--profile` | `PLATFORM_PROFILE_URL` | _(none)_ |
+
+Catalog discovery is anonymous, so `catalog search` and `discover` work with no
+key. **Cart, checkout, and purchase** need a real platform key
+(`UCP_PLATFORM_API_KEY`). **`purchase confirm`** additionally needs your agent
+signing key (`AGENT_PRIVATE_JWK` + `AGENT_KID`) so it can mint the AP2 mandate,
+and **`account`** (and any buyer-bound call) needs a buyer OAuth bearer
+(`ARTOS_BUYER_BEARER`). The CLI settles the **card / $0** rails; for crypto
+settlement, use the SDK directly.
+
+## Commands
+
+### `artos init [name]`
+
+Scaffolds a runnable **Build-track** starter project: `package.json`,
+`tsconfig.json`, `.env.example`, and a `src/index.ts` wired with `UcpClient`,
+`createCheckoutHandlers`, `createAccountHandlers`, and `OAuthClient` (a
+search → checkout demo plus account-tool and buyer-OAuth examples). Refuses to
+overwrite a directory that already has a `package.json`.
+
+```bash
+artos init my-agent           # → ./my-agent
+artos init my-agent --out /path/to/dir
+cd my-agent && npm install && cp .env.example .env && npm start
+```
+
+### `artos profile init`
+
+Generates an EC P-256 signing keypair and a UCP profile document.
+
+```bash
+artos profile init --out ./agent-profile --url https://your-app.example/.well-known/ucp
+```
+
+Writes `ucp.json` (host it publicly at the `--url`) and `private-jwk.json`
+(**secret** — load as `AGENT_PRIVATE_JWK`, never commit). Prints the env vars to
+export.
+
+### `artos doctor`
+
+Checks your connection to Artos: platform key, the API's UCP discovery profile,
+the OAuth Authorization Server metadata, and (when configured) your published
+agent profile. Exits non-zero on any failure.
+
+```bash
+artos doctor
+artos doctor --api https://api.dev.artos.sh --profile https://your-app.example/.well-known/ucp
+```
+
+### `artos conformance [--store <slug>]`
+
+Runs a battery of live UCP conformance checks against a deployment: the platform
+discovery profile and its declared UCP version, the OAuth metadata (endpoints,
+PKCE `S256`, `offline_access` / `purchase:complete` scopes), the cross-store
+catalog search, the buyer-bound `401` + `WWW-Authenticate` relay contract, and —
+when a store is given — that the store publishes signing keys for AP2
+verification. Exits non-zero if any required check fails (warnings don't fail the
+run), so it drops straight into CI. Add `--json` for a machine-readable report.
+
+```bash
+artos conformance --api https://api.dev.artos.sh --key "$UCP_PLATFORM_API_KEY"
+artos conformance --store acme --json
+```
+
+### `artos discover --store <slug>`
+
+Fetches a store's UCP profile and prints its protocol version, signing keys,
+payment handlers, and capabilities.
+
+```bash
+artos discover --store about-you
+artos discover --store about-you --json
+```
+
+### `artos catalog search <query>`
+
+Searches the cross-store catalog with the correct UCP headers. `--max` is in
+major units (dollars) and is converted to minor units for you.
+
+```bash
+artos catalog search "running shoes" --max 150 --currency USD
+artos catalog search shoes --json
+```
+
+### `artos cart <create|view|update>`
+
+Manages a store cart. `--item` is repeatable and takes a variant id with an
+optional `:quantity` (default 1).
+
+```bash
+artos cart create --store about-you --item <variantId>:2 --item <variantId>
+artos cart view   --store about-you --id <cartId>
+artos cart update --store about-you --id <cartId> --item <variantId>:3
+```
+
+### `artos checkout <create|view|update>`
+
+Manages a store checkout. Build it from a cart (`--cart`) or line items
+(`--item`), and set nested fields with `--set` (dotted keys nest, e.g.
+`--set shipping_address.country=US`).
+
+```bash
+artos checkout create --store about-you --cart <cartId> --set shipping_address.country=US
+artos checkout view   --store about-you --id <checkoutId>
+artos checkout update --store about-you --id <checkoutId> --set buyer.email=you@example.com
+```
+
+### `artos purchase confirm`
+
+Re-prices the checkout, verifies the store's signed terms, mints the AP2
+mandate, and places the order on the **card / $0** rail. Needs
+`AGENT_PRIVATE_JWK` + `AGENT_KID`. Exit codes: `0` placed, `2` action required
+(escalation / pick a rail with `--pay`), `1` error.
+
+```bash
+artos purchase confirm --store about-you --id <checkoutId> --pay sh.artos.card
+artos purchase confirm --store about-you --id <checkoutId> --coupon   # apply best coupon
+```
+
+### `artos account <list|call> [tool]`
+
+Lists or calls buyer-account tools (`get_buyer_context`, `list_my_orders`, …).
+Buyer-bound, so it needs `ARTOS_BUYER_BEARER`.
+
+```bash
+artos account list
+artos account call list_my_orders --args '{"limit":5}'
+artos account call get_buyer_context --set verbose=true
+```
+
+## Development
+
+```bash
+npm install
+npm run check   # lint + typecheck + test:coverage + build
+```
+
+See [AGENTS.md](AGENTS.md) for the conventions (the `Io` seam, sui-free SDK
+subpaths, the testing bar) every change must follow.
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,35 @@
+import { UcpClient } from '@artos-commerce/ucp-client/ucp';
+import type { UcpResponse } from '@artos-commerce/ucp-client/ucp';
+import { Ap2Signer } from '@artos-commerce/ucp-client/ap2';
+import { type CheckoutOutcome, type ConfirmPurchaseInput } from '@artos-commerce/ucp-client/checkout';
+import type { CliConfig } from './config.js';
+import type { Io } from './io.js';
+/** Buyer bearer env var (server-side OAuth token for buyer-bound calls). */
+export declare function buyerToken(env: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Builds the AP2 signer. With `AGENT_PRIVATE_JWK` set it uses the real key (whose
+ * public half must be in the published profile, so minted mandates verify);
+ * otherwise it generates an ephemeral key so read/write cart + checkout commands
+ * (which never mint a verifiable mandate) still work without agent credentials.
+ */
+export declare function buildSigner(env: NodeJS.ProcessEnv): Promise<Ap2Signer>;
+/** The store-tool call surface cart/checkout commands operate over. */
+export interface StoreCaller {
+    call: (slug: string, name: string, args: Record<string, unknown>, opts?: {
+        idempotent?: boolean;
+        auth?: 'platform' | 'buyer';
+    }) => Promise<UcpResponse>;
+}
+/** Adapts a {@link UcpClient} to the {@link StoreCaller} seam. */
+export declare function storeCaller(client: UcpClient): StoreCaller;
+/** The buyer-account tool surface the `account` command operates over. */
+export interface AccountCaller {
+    listAccountTools: UcpClient['listAccountTools'];
+    callAccountTool: UcpClient['callAccountTool'];
+}
+/** Constructs a UCP client carrying the (optional) buyer bearer. */
+export declare function buildClient(cfg: CliConfig, io: Io): UcpClient;
+/** A bound `confirmPurchase` function (the only place that needs the signer). */
+export type ConfirmFn = (input: ConfirmPurchaseInput) => Promise<CheckoutOutcome>;
+/** Wires the checkout handlers and returns its `confirmPurchase`. Card/$0 only. */
+export declare function buildConfirm(cfg: CliConfig, io: Io): Promise<ConfirmFn>;

package/dist/agent.js

@@ -0,0 +1,46 @@
+import { webcrypto } from 'node:crypto';
+import { UcpClient } from '@artos-commerce/ucp-client/ucp';
+import { Ap2Signer } from '@artos-commerce/ucp-client/ap2';
+import { createCheckoutHandlers, } from '@artos-commerce/ucp-client/checkout';
+/** Buyer bearer env var (server-side OAuth token for buyer-bound calls). */
+export function buyerToken(env) {
+    return env.ARTOS_BUYER_BEARER?.trim() || undefined;
+}
+/**
+ * Builds the AP2 signer. With `AGENT_PRIVATE_JWK` set it uses the real key (whose
+ * public half must be in the published profile, so minted mandates verify);
+ * otherwise it generates an ephemeral key so read/write cart + checkout commands
+ * (which never mint a verifiable mandate) still work without agent credentials.
+ */
+export async function buildSigner(env) {
+    const raw = env.AGENT_PRIVATE_JWK?.trim();
+    if (raw) {
+        const jwk = JSON.parse(raw);
+        return new Ap2Signer(jwk, env.AGENT_KID?.trim() || jwk.kid || '');
+    }
+    const pair = await webcrypto.subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, true, ['sign', 'verify']);
+    const jwk = (await webcrypto.subtle.exportKey('jwk', pair.privateKey));
+    return new Ap2Signer(jwk, 'ephemeral');
+}
+/** Adapts a {@link UcpClient} to the {@link StoreCaller} seam. */
+export function storeCaller(client) {
+    return {
+        call: (slug, name, args, opts) => client.callStoreTool(slug, name, args, opts),
+    };
+}
+/** Constructs a UCP client carrying the (optional) buyer bearer. */
+export function buildClient(cfg, io) {
+    return new UcpClient({
+        artosBaseUrl: cfg.artosBaseUrl,
+        platformApiKey: cfg.platformApiKey,
+        platformProfileUrl: cfg.platformProfileUrl,
+    }, { fetch: io.fetch, buyerToken: buyerToken(io.env) });
+}
+/** Wires the checkout handlers and returns its `confirmPurchase`. Card/$0 only. */
+export async function buildConfirm(cfg, io) {
+    const client = buildClient(cfg, io);
+    const signer = await buildSigner(io.env);
+    const handlers = createCheckoutHandlers({ client, signer });
+    return (input) => handlers.confirmPurchase(input);
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EACL,sBAAsB,GAGvB,MAAM,qCAAqC,CAAC;AAI7C,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,GAAsB;IAC/C,OAAO,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAsB;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC1C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkC,CAAC;QAC7D,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,WAAW,CAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,EACtC,IAAI,EACJ,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,SAAS,CAC3C,KAAK,EACL,IAAI,CAAC,UAAU,CAChB,CAAkC,CAAC;IACpC,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACzC,CAAC;AAYD,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,MAAiB;IAC3C,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAC/B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;KAC/C,CAAC;AACJ,CAAC;AAQD,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,GAAc,EAAE,EAAM;IAChD,OAAO,IAAI,SAAS,CAClB;QACE,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;KAC3C,EACD,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CACpD,CAAC;AACJ,CAAC;AAOD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,EAAM;IACvD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/dist/args.d.ts

@@ -0,0 +1,20 @@
+import type { CheckoutLineItem } from '@artos-commerce/ucp-client/checkout';
+/**
+ * Parses repeated `--item` values into UCP line items. Each value is a variant
+ * id with an optional `:quantity` suffix (default 1), e.g. `v123` or `v123:2`.
+ */
+export declare function parseItems(values: string[]): CheckoutLineItem[];
+/** UCP line-item wire shape (`{ item: { id }, quantity }`). */
+export declare function lineItems(items: CheckoutLineItem[]): Array<{
+    item: {
+        id: string;
+    };
+    quantity: number;
+}>;
+/**
+ * Parses repeated `--set key=value` pairs into a (possibly nested) object. Dotted
+ * keys build nested objects, e.g. `shipping_address.country=US` →
+ * `{ shipping_address: { country: 'US' } }`. `true`/`false` become booleans;
+ * everything else stays a string.
+ */
+export declare function parseSet(pairs: string[]): Record<string, unknown>;

package/dist/args.js

@@ -0,0 +1,58 @@
+/**
+ * Parses repeated `--item` values into UCP line items. Each value is a variant
+ * id with an optional `:quantity` suffix (default 1), e.g. `v123` or `v123:2`.
+ */
+export function parseItems(values) {
+    return values.map((raw) => {
+        const [id, qty] = raw.split(':');
+        const quantity = qty ? Number(qty) : 1;
+        if (!id || Number.isNaN(quantity) || quantity <= 0) {
+            throw new Error(`Invalid --item "${raw}" (expected "<variantId>" or "<variantId>:<qty>").`);
+        }
+        return { id, quantity };
+    });
+}
+/** UCP line-item wire shape (`{ item: { id }, quantity }`). */
+export function lineItems(items) {
+    return items.map((i) => ({ item: { id: i.id }, quantity: i.quantity ?? 1 }));
+}
+/**
+ * Coerces a `--set` value to a boolean for the literals `true`/`false`, leaving
+ * everything else a string. Numbers are intentionally NOT coerced — fields like
+ * `postal_code=94016` / `02134` must stay strings (and lose no leading zeros).
+ */
+function coerce(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return value;
+}
+/**
+ * Parses repeated `--set key=value` pairs into a (possibly nested) object. Dotted
+ * keys build nested objects, e.g. `shipping_address.country=US` →
+ * `{ shipping_address: { country: 'US' } }`. `true`/`false` become booleans;
+ * everything else stays a string.
+ */
+export function parseSet(pairs) {
+    const out = {};
+    for (const pair of pairs) {
+        const eq = pair.indexOf('=');
+        if (eq <= 0) {
+            throw new Error(`Invalid --set "${pair}" (expected "key=value").`);
+        }
+        const path = pair.slice(0, eq).split('.');
+        const value = coerce(pair.slice(eq + 1));
+        let node = out;
+        for (let i = 0; i < path.length - 1; i++) {
+            const key = path[i];
+            if (typeof node[key] !== 'object' || node[key] === null) {
+                node[key] = {};
+            }
+            node = node[key];
+        }
+        node[path[path.length - 1]] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACxB,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,oDAAoD,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,SAAS,CACvB,KAAyB;IAEzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,KAAa;IAC3B,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAe;IACtC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,2BAA2B,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,GAAG,GAAG,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACxD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,GAAG,CAA4B,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+import type { Io } from './io.js';
+export declare const HELP = "artos \u2014 CLI for building agents on Artos (UCP)\n\nUsage:\n  artos <command> [subcommand] [options]\n\nCommands:\n  init [name]                   Scaffold a Build-track agent starter project\n  profile init                  Generate an agent UCP profile + signing keypair\n  doctor                        Check connectivity: API, OAuth, agent profile\n  conformance [--store <slug>]  Run live UCP conformance checks\n  discover --store <slug>       Inspect a store's UCP profile\n  catalog search <query>        Search the cross-store catalog\n  cart <create|view|update>     Manage a store cart\n  checkout <create|view|update> Manage a store checkout\n  purchase confirm              Re-price, sign the mandate, and place the order\n  account <list|call> [tool]    List or call buyer-account tools\n\nGlobal options:\n  --api <url>       Artos API base URL (env ARTOS_BASE_URL)\n  --key <key>       Platform API key (env UCP_PLATFORM_API_KEY)\n  --profile <url>   Agent profile URL (env PLATFORM_PROFILE_URL)\n  --json            Machine-readable JSON output\n  -h, --help        Show this help\n\nCommand options:\n  init              [name]  --out <dir>\n  profile init      --out <dir>  --url <profileUrl>  --kid <kid>\n  catalog search    --max <price>  --currency <code>\n  cart / checkout   --store <slug>  --id <id>  --cart <cartId>\n                    --item <variantId[:qty]> (repeatable)\n                    --set <key=value> (repeatable; dotted keys nest)\n  purchase confirm  --store <slug>  --id <checkoutId>  --pay <handlerId>\n                    --mandate <uuid>  --coupon | --no-coupon\n  account call      <tool>  --set <key=value>  --args <json>\n\nAuth env: AGENT_PRIVATE_JWK + AGENT_KID (mandate signing, purchase),\n          ARTOS_BUYER_BEARER (buyer-bound calls: account, crypto).\n";
+/**
+ * Parses argv and dispatches to a command, returning the process exit code.
+ * All side effects flow through {@link Io}, so this is fully unit-testable.
+ */
+export declare function run(argv: string[], io: Io): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,250 @@
+import { parseArgs } from 'node:util';
+import { join } from 'node:path';
+import { resolveConfig } from './config.js';
+import { runDoctor, formatReport } from './doctor.js';
+import { runConformance, formatConformance } from './conformance.js';
+import { generateAgentProfile } from './profile.js';
+import { parseItems, parseSet } from './args.js';
+import { buildClient, buildConfirm, buyerToken, storeCaller } from './agent.js';
+import { catalogSearch } from './commands/catalog-search.js';
+import { discover } from './commands/discover.js';
+import { profileInit } from './commands/profile-init.js';
+import { initProject } from './commands/init.js';
+import { cart } from './commands/cart.js';
+import { checkout } from './commands/checkout.js';
+import { purchaseConfirm } from './commands/purchase.js';
+import { account } from './commands/account.js';
+export const HELP = `artos — CLI for building agents on Artos (UCP)
+
+Usage:
+  artos <command> [subcommand] [options]
+
+Commands:
+  init [name]                   Scaffold a Build-track agent starter project
+  profile init                  Generate an agent UCP profile + signing keypair
+  doctor                        Check connectivity: API, OAuth, agent profile
+  conformance [--store <slug>]  Run live UCP conformance checks
+  discover --store <slug>       Inspect a store's UCP profile
+  catalog search <query>        Search the cross-store catalog
+  cart <create|view|update>     Manage a store cart
+  checkout <create|view|update> Manage a store checkout
+  purchase confirm              Re-price, sign the mandate, and place the order
+  account <list|call> [tool]    List or call buyer-account tools
+
+Global options:
+  --api <url>       Artos API base URL (env ARTOS_BASE_URL)
+  --key <key>       Platform API key (env UCP_PLATFORM_API_KEY)
+  --profile <url>   Agent profile URL (env PLATFORM_PROFILE_URL)
+  --json            Machine-readable JSON output
+  -h, --help        Show this help
+
+Command options:
+  init              [name]  --out <dir>
+  profile init      --out <dir>  --url <profileUrl>  --kid <kid>
+  catalog search    --max <price>  --currency <code>
+  cart / checkout   --store <slug>  --id <id>  --cart <cartId>
+                    --item <variantId[:qty]> (repeatable)
+                    --set <key=value> (repeatable; dotted keys nest)
+  purchase confirm  --store <slug>  --id <checkoutId>  --pay <handlerId>
+                    --mandate <uuid>  --coupon | --no-coupon
+  account call      <tool>  --set <key=value>  --args <json>
+
+Auth env: AGENT_PRIVATE_JWK + AGENT_KID (mandate signing, purchase),
+          ARTOS_BUYER_BEARER (buyer-bound calls: account, crypto).
+`;
+/** Builds a JSON GET helper that throws on a non-2xx response. */
+function makeFetchJson(fetchFn) {
+    return async (url) => {
+        const res = await fetchFn(url, { headers: { accept: 'application/json' } });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        return (await res.json());
+    };
+}
+/** Tri-state coupon flag from `--coupon` / `--no-coupon`. */
+function couponChoice(values) {
+    if (values.coupon === true)
+        return true;
+    if (values['no-coupon'] === true)
+        return false;
+    return undefined;
+}
+/**
+ * Parses argv and dispatches to a command, returning the process exit code.
+ * All side effects flow through {@link Io}, so this is fully unit-testable.
+ */
+export async function run(argv, io) {
+    let values;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                api: { type: 'string' },
+                key: { type: 'string' },
+                profile: { type: 'string' },
+                out: { type: 'string' },
+                url: { type: 'string' },
+                kid: { type: 'string' },
+                store: { type: 'string' },
+                max: { type: 'string' },
+                currency: { type: 'string' },
+                id: { type: 'string' },
+                cart: { type: 'string' },
+                pay: { type: 'string' },
+                mandate: { type: 'string' },
+                args: { type: 'string' },
+                item: { type: 'string', multiple: true },
+                set: { type: 'string', multiple: true },
+                coupon: { type: 'boolean' },
+                'no-coupon': { type: 'boolean' },
+                json: { type: 'boolean' },
+                help: { type: 'boolean', short: 'h' },
+            },
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (err) {
+        io.error(err.message);
+        io.error(HELP);
+        return 1;
+    }
+    if (values.help || positionals.length === 0) {
+        io.write(HELP);
+        return 0;
+    }
+    const flags = {
+        api: values.api,
+        key: values.key,
+        profile: values.profile,
+    };
+    const cfg = resolveConfig(io.env, flags);
+    const [command, sub, ...rest] = positionals;
+    const json = values.json === true;
+    const store = values.store ?? '';
+    const id = values.id;
+    const itemVals = values.item ?? [];
+    const setVals = values.set ?? [];
+    try {
+        switch (command) {
+            case 'doctor': {
+                const report = await runDoctor({ cfg, fetch: io.fetch });
+                io.write(formatReport(report));
+                return report.ok ? 0 : 1;
+            }
+            case 'conformance': {
+                const report = await runConformance({
+                    cfg,
+                    fetch: io.fetch,
+                    search: () => buildClient(cfg, io).globalSearch({
+                        query: 'test',
+                        pagination: { limit: 1 },
+                    }),
+                }, { store: store || undefined });
+                io.write(json ? JSON.stringify(report, null, 2) : formatConformance(report));
+                return report.ok ? 0 : 1;
+            }
+            case 'discover': {
+                return await discover({ fetchJson: makeFetchJson(io.fetch), baseUrl: cfg.artosBaseUrl, io }, { store, json });
+            }
+            case 'catalog': {
+                if (sub !== 'search') {
+                    io.error(`Unknown catalog subcommand: ${sub ?? '(none)'} (try "search")`);
+                    return 1;
+                }
+                const max = values.max != null ? Number(values.max) : undefined;
+                if (max != null && Number.isNaN(max)) {
+                    io.error('--max must be a number (major units, e.g. 150).');
+                    return 1;
+                }
+                return await catalogSearch({ client: buildClient(cfg, io), io }, {
+                    query: rest.join(' '),
+                    max,
+                    currency: values.currency,
+                    json,
+                });
+            }
+            case 'init': {
+                const name = sub ?? 'artos-agent-starter';
+                const outDir = values.out ?? join(io.cwd, name);
+                return initProject({ io }, { name, outDir });
+            }
+            case 'profile': {
+                if (sub !== 'init') {
+                    io.error(`Unknown profile subcommand: ${sub ?? '(none)'} (try "init")`);
+                    return 1;
+                }
+                const outDir = values.out ??
+                    join(io.cwd, 'artos-agent-profile');
+                const url = values.url ??
+                    'https://your-app.example/.well-known/ucp';
+                return await profileInit({
+                    generate: generateAgentProfile,
+                    mkdir: io.mkdir,
+                    writeFile: io.writeFile,
+                    io,
+                }, { outDir, url, kid: values.kid });
+            }
+            case 'cart': {
+                return await cart({ store: storeCaller(buildClient(cfg, io)), io }, {
+                    action: (sub ?? 'view'),
+                    store,
+                    id,
+                    items: parseItems(itemVals),
+                    json,
+                });
+            }
+            case 'checkout': {
+                return await checkout({ store: storeCaller(buildClient(cfg, io)), io }, {
+                    action: (sub ?? 'view'),
+                    store,
+                    id,
+                    cartId: values.cart,
+                    items: parseItems(itemVals),
+                    set: parseSet(setVals),
+                    json,
+                });
+            }
+            case 'purchase': {
+                if (sub !== 'confirm') {
+                    io.error(`Unknown purchase subcommand: ${sub ?? '(none)'} (try "confirm")`);
+                    return 1;
+                }
+                const confirm = await buildConfirm(cfg, io);
+                return await purchaseConfirm({ confirm, io }, {
+                    store,
+                    id: id ?? '',
+                    pay: values.pay,
+                    mandate: values.mandate,
+                    applyCoupon: couponChoice(values),
+                    json,
+                });
+            }
+            case 'account': {
+                const action = sub === 'call' ? 'call' : 'list';
+                let toolArgs = {};
+                if (values.args) {
+                    toolArgs = JSON.parse(values.args);
+                }
+                if (setVals.length)
+                    toolArgs = { ...toolArgs, ...parseSet(setVals) };
+                return await account({
+                    account: buildClient(cfg, io),
+                    hasBuyer: Boolean(buyerToken(io.env)),
+                    io,
+                }, { action, tool: rest[0], toolArgs, json });
+            }
+            default:
+                io.error(`Unknown command: ${command}`);
+                io.write(HELP);
+                return 1;
+        }
+    }
+    catch (err) {
+        io.error(`artos: ${err.message}`);
+        return 1;
+    }
+}
+//# 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/commands/account.d.ts

@@ -0,0 +1,19 @@
+import type { AccountCaller } from '../agent.js';
+import type { Io } from '../io.js';
+export type AccountAction = 'list' | 'call';
+export interface AccountArgs {
+    action: AccountAction;
+    /** Tool name for `account call <tool>`. */
+    tool?: string;
+    /** Arguments object for `account call` (from `--set`/`--args`). */
+    toolArgs?: Record<string, unknown>;
+    json?: boolean;
+}
+export interface AccountDeps {
+    account: AccountCaller;
+    /** Whether a buyer bearer is configured (account tools are buyer-bound). */
+    hasBuyer: boolean;
+    io: Pick<Io, 'write' | 'error'>;
+}
+/** Lists or calls buyer-account tools (require ARTOS_BUYER_BEARER). */
+export declare function account(deps: AccountDeps, args: AccountArgs): Promise<number>;