@codespar/cli 0.2.0

package/README.md

@@ -0,0 +1,116 @@
+# @codespar/cli
+
+Command-line interface for [CodeSpar](https://codespar.dev) — authenticate, inspect servers, execute tools, and manage sessions from your terminal.
+
+## Install
+
+```bash
+npm install -g @codespar/cli
+```
+
+Verify:
+
+```bash
+codespar --version
+```
+
+## Quick start
+
+```bash
+# One-time: authenticate with your API key
+codespar login
+
+# Inspect the catalog
+codespar servers list
+codespar servers show stripe
+codespar tools list --server asaas
+codespar tools show codespar_pay
+
+# Run a one-shot tool call
+codespar execute codespar_pay \
+  --server asaas \
+  --input '{"method":"pix","amount":15000,"currency":"BRL"}'
+
+# Manage sessions
+codespar sessions list
+codespar sessions show ses_abc123 --logs
+codespar sessions close ses_abc123
+```
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `login` | Save your API key to `~/.codespar/config.json` |
+| `logout` | Clear the stored API key |
+| `whoami` | Show authenticated user, org, project, and key scopes |
+| `servers list` | List the server catalog (filter by `--category`, `--region`) |
+| `servers show <id>` | Show a server's details and tools |
+| `tools list` | List tools (filter by `--server`) |
+| `tools show <name>` | Show a tool's full input/output schema |
+| `execute <tool>` | Run a single tool call in a throwaway session |
+| `sessions list` | List recent sessions (filter by `--status`, `--limit`) |
+| `sessions show <id>` | Show session details (add `--logs` for tool calls) |
+| `sessions close <id>` | Close an active session |
+| `connect list` | List active Connect Links per user |
+| `connect start <server>` | Start an OAuth Connect Link flow (add `--open` to launch it) |
+| `connect revoke <server>` | Revoke a connection |
+| `logs tail` | Stream tool-call logs in real time (filter by `--server`, `--status`, `--tool`) |
+| `init <name>` | Scaffold a new commerce agent from a template |
+
+### Templates available via `init`
+
+| Slug | Stack | What you get |
+|------|-------|--------------|
+| `pix-agent` | Node + OpenAI | Minimal Pix charge + WhatsApp notify loop |
+| `ecommerce-checkout` | Node + Claude | Full Complete Loop: checkout → invoice → ship → notify |
+| `streaming-chat` | Next.js + Vercel AI | Token-by-token streaming commerce chat |
+| `multi-tenant` | Next.js + OpenAI | One API key, N tenants, per-tenant billing |
+
+Every command supports:
+
+- `--json` — machine-readable JSON output (pipe into `jq`)
+- `--api-key <key>` — override the stored key
+- `--base-url <url>` — point at a custom API (staging, self-hosted)
+
+## Configuration
+
+Resolution order (first match wins):
+
+1. Command-line flags (`--api-key`, `--base-url`)
+2. Environment variables (`CODESPAR_API_KEY`, `CODESPAR_BASE_URL`)
+3. Config file at `~/.codespar/config.json` (chmod 600)
+
+## Scripting
+
+Output is valid JSON on stdout and human messages on stderr, so you can pipe cleanly:
+
+```bash
+# IDs of all servers that handle Pix
+codespar servers list --json \
+  | jq -r '.[] | select(.capabilities | contains(["pix"])) | .id'
+
+# p95 latency of the last 100 stripe calls in a session
+codespar sessions show ses_abc123 --logs --json \
+  | jq '[.logs[] | select(.server == "stripe") | .duration_ms] | sort | .[95]'
+```
+
+Use `--json` explicitly when piping — the CLI defaults to tables in a TTY.
+
+## Development
+
+This package lives in the `codespar-core` monorepo.
+
+```bash
+# From repo root
+npm install
+npm run build --workspace @codespar/cli
+npm run typecheck --workspace @codespar/cli
+
+# Run the local build directly
+node packages/cli/dist/index.js --help
+```
+
+## License
+
+MIT © CodeSpar

package/dist/api.js

@@ -0,0 +1,62 @@
+import { CliError } from "./config.js";
+/**
+ * Thin fetch wrapper around the CodeSpar REST API. The SDK doesn't expose
+ * every endpoint the CLI needs (catalog listings, session bookkeeping),
+ * so we hit the HTTP surface directly with the user's API key.
+ */
+export class ApiClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async get(path, query) {
+        return this.request("GET", path, undefined, query);
+    }
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    async delete(path) {
+        return this.request("DELETE", path);
+    }
+    async request(method, path, body, query) {
+        const url = new URL(path.startsWith("/") ? path : `/${path}`, this.config.baseUrl);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, v);
+            }
+        }
+        let res;
+        try {
+            res = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                    "Content-Type": "application/json",
+                    "User-Agent": "codespar-cli/0.1.0",
+                },
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            throw new CliError(`Network error calling ${method} ${url.pathname}: ${err.message}`);
+        }
+        if (!res.ok) {
+            let detail = "";
+            try {
+                const errBody = (await res.json());
+                detail = errBody.message ?? errBody.error ?? "";
+            }
+            catch {
+                detail = await res.text().catch(() => "");
+            }
+            const prefix = `${method} ${url.pathname} → ${res.status}`;
+            throw new CliError(detail ? `${prefix}: ${detail}` : prefix);
+        }
+        // 204 No Content
+        if (res.status === 204)
+            return undefined;
+        return (await res.json());
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/commands/connect.js

@@ -0,0 +1,71 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { CliError } from "../config.js";
+import { info, json, success, table } from "../output.js";
+const execAsync = promisify(exec);
+export async function listConnectionsCommand(client, opts) {
+    const data = await client.get("/v1/connections", {
+        user: opts.user,
+        status: opts.status,
+    });
+    if (opts.json) {
+        json(data.data);
+        return;
+    }
+    table(["SERVER", "USER", "STATUS", "CONNECTED", "EXPIRES"], data.data.map((c) => [
+        c.server,
+        c.user_id ?? "-",
+        c.status,
+        c.connected_at ? new Date(c.connected_at).toISOString().slice(0, 10) : "-",
+        c.expires_at ? new Date(c.expires_at).toISOString().slice(0, 10) : "-",
+    ]));
+}
+/**
+ * Start a Connect Link flow for a server. Prints the authorization URL so
+ * the user can click or share it; optionally opens it in the default browser.
+ * This is the CLI equivalent of `session.authorize(serverId)`.
+ */
+export async function startConnectCommand(client, server, opts) {
+    if (!server)
+        throw new CliError("Server id is required. Example: `codespar connect start stripe`");
+    const userId = opts.user ?? "cli-user";
+    const res = await client.post("/v1/connections", { server, user_id: userId });
+    if (opts.json) {
+        json(res);
+        return;
+    }
+    info(`Connect ${server} for user ${userId}:`);
+    process.stdout.write(`\n  ${res.connect_url}\n\n`);
+    if (res.expires_at) {
+        info(`Link expires ${new Date(res.expires_at).toLocaleString()}`);
+    }
+    if (opts.open) {
+        await openInBrowser(res.connect_url).catch(() => {
+            // Silent fail — user can copy/paste from stdout.
+        });
+    }
+    else {
+        info("Tip: pass --open to launch the link in your browser automatically.");
+    }
+}
+export async function revokeConnectCommand(client, server, opts) {
+    if (!server)
+        throw new CliError("Server id is required. Example: `codespar connect revoke stripe`");
+    const userId = opts.user ?? "cli-user";
+    await client.delete(`/v1/connections/${encodeURIComponent(server)}?user=${encodeURIComponent(userId)}`);
+    success(`Revoked ${server} for user ${userId}.`);
+}
+/**
+ * Opens a URL in the system's default browser. Uses `open` on macOS,
+ * `xdg-open` on Linux, `start` on Windows. Intentionally minimal — we
+ * don't bring in `open`/`openurl` npm packages just for this.
+ */
+async function openInBrowser(url) {
+    const cmd = process.platform === "darwin"
+        ? `open ${JSON.stringify(url)}`
+        : process.platform === "win32"
+            ? `start "" ${JSON.stringify(url)}`
+            : `xdg-open ${JSON.stringify(url)}`;
+    await execAsync(cmd);
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

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

package/dist/commands/execute.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import { CodeSpar } from "@codespar/sdk";
+import { CliError } from "../config.js";
+import { json, success } from "../output.js";
+/**
+ * One-shot tool execution. Opens a session, calls execute(), closes.
+ * For multi-step flows or long sessions, use the SDK directly.
+ */
+export async function executeCommand(toolName, opts) {
+    if (!toolName)
+        throw new CliError("Tool name is required. Example: `codespar execute codespar_pay --input '{...}'`");
+    if (!opts.server)
+        throw new CliError("--server is required (e.g. --server asaas)");
+    const input = await resolveInput(opts);
+    const userId = opts.user ?? "cli-user";
+    const cs = new CodeSpar({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+    const session = await cs.create(userId, { servers: [opts.server] });
+    try {
+        const result = await session.execute(toolName, input);
+        if (opts.json) {
+            json(result);
+            return;
+        }
+        if (result.success) {
+            success(`${toolName} succeeded in ${result.duration ?? "?"}ms`);
+        }
+        else {
+            process.stderr.write(`Tool call failed: ${result.error ?? "unknown error"}\n`);
+        }
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    }
+    finally {
+        await session.close();
+    }
+}
+async function resolveInput(opts) {
+    if (opts.input && opts.inputFile) {
+        throw new CliError("Pass either --input or --input-file, not both.");
+    }
+    if (opts.inputFile) {
+        const raw = await readFile(opts.inputFile, "utf-8");
+        return parseJson(raw, opts.inputFile);
+    }
+    if (opts.input)
+        return parseJson(opts.input, "--input");
+    return {};
+}
+function parseJson(raw, source) {
+    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=execute.js.map

package/dist/commands/execute.js.map

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

package/dist/commands/init.js

@@ -0,0 +1,130 @@
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { CliError } from "../config.js";
+import { c, info, success } from "../output.js";
+const TEMPLATES = [
+    {
+        slug: "pix-agent",
+        label: "Pix Payment Agent",
+        description: "Minimal Pix charge + WhatsApp notification via OpenAI",
+        framework: "OpenAI",
+    },
+    {
+        slug: "ecommerce-checkout",
+        label: "E-Commerce Checkout",
+        description: "Full Complete Loop: checkout → invoice → ship → notify (Claude)",
+        framework: "Claude",
+    },
+    {
+        slug: "streaming-chat",
+        label: "Streaming Chat",
+        description: "Next.js 15 + Vercel AI SDK with token-by-token streaming",
+        framework: "Next.js + Vercel AI",
+    },
+    {
+        slug: "multi-tenant",
+        label: "Multi-Tenant Agent",
+        description: "SaaS pattern — one API key, N tenants, per-tenant billing",
+        framework: "Next.js + OpenAI",
+    },
+];
+export async function initCommand(name, opts) {
+    if (!name)
+        throw new CliError("Project name is required. Example: `codespar init my-agent`");
+    if (!/^[a-z0-9][a-z0-9-_]*$/i.test(name)) {
+        throw new CliError("Project name must start with a letter/number and contain only letters, digits, dashes, and underscores.");
+    }
+    const target = resolve(process.cwd(), name);
+    // Refuse to clobber an existing non-empty directory.
+    try {
+        const existing = await readdir(target);
+        if (existing.length > 0) {
+            throw new CliError(`Directory ${name}/ already exists and is not empty. Choose a different name or delete it first.`);
+        }
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    const template = await pickTemplate(opts);
+    info(`Creating ${c.bold(name)} using the ${c.bold(template.label)} template...`);
+    const templatesRoot = resolveTemplatesDir();
+    const source = join(templatesRoot, template.slug);
+    await copyTemplate(source, target, { name });
+    process.stdout.write("\n");
+    success(`Created ${name}/`);
+    process.stdout.write([
+        "",
+        "Next steps:",
+        `  cd ${name}`,
+        "  cp .env.example .env   # then fill in your keys",
+        "  npm install",
+        "  npm run dev",
+        "",
+    ].join("\n"));
+}
+async function pickTemplate(opts) {
+    if (opts.template) {
+        const t = TEMPLATES.find((x) => x.slug === opts.template);
+        if (!t) {
+            throw new CliError(`Unknown template "${opts.template}". Available: ${TEMPLATES.map((x) => x.slug).join(", ")}`);
+        }
+        return t;
+    }
+    if (opts.yes)
+        return TEMPLATES[0];
+    // Interactive pick
+    process.stdout.write(c.bold("Choose a template:\n\n"));
+    TEMPLATES.forEach((t, i) => {
+        process.stdout.write(`  ${c.blue(`${i + 1}.`)} ${c.bold(t.label)} ${c.dim(`(${t.framework})`)}\n`);
+        process.stdout.write(`     ${c.dim(t.description)}\n\n`);
+    });
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const answer = (await rl.question(`Pick a number [1-${TEMPLATES.length}] (default 1): `)).trim();
+        const index = answer === "" ? 0 : Number.parseInt(answer, 10) - 1;
+        if (Number.isNaN(index) || index < 0 || index >= TEMPLATES.length) {
+            throw new CliError(`Invalid choice: ${answer}`);
+        }
+        return TEMPLATES[index];
+    }
+    finally {
+        rl.close();
+    }
+}
+function resolveTemplatesDir() {
+    // When running from dist/, __dirname is packages/cli/dist/commands.
+    // Templates live at packages/cli/templates, so go up two levels.
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..", "templates");
+}
+async function copyTemplate(source, target, vars) {
+    const stats = await stat(source).catch(() => null);
+    if (!stats)
+        throw new CliError(`Template not found at ${source}. Is the package installation corrupted?`);
+    await mkdir(target, { recursive: true });
+    const entries = await readdir(source, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(source, entry.name);
+        // Substitute placeholders in file names too (rare but cheap)
+        const outName = substituteAll(entry.name, vars);
+        const dstPath = join(target, outName);
+        if (entry.isDirectory()) {
+            await copyTemplate(srcPath, dstPath, vars);
+            continue;
+        }
+        // Binary detection is heuristic — read as utf-8 and substitute if
+        // it decodes cleanly. Good enough for templates which are all text.
+        const buf = await readFile(srcPath);
+        const text = buf.toString("utf-8");
+        const rendered = substituteAll(text, vars);
+        await writeFile(dstPath, rendered, "utf-8");
+    }
+}
+function substituteAll(source, vars) {
+    return source.replace(/\{\{(\w+)\}\}/g, (match, key) => vars[key] ?? match);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/login.js

@@ -0,0 +1,55 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { saveConfig, CliError } from "../config.js";
+import { ApiClient } from "../api.js";
+import { success, info } from "../output.js";
+/**
+ * Store an API key on disk. If `--api-key` is passed we use it directly;
+ * otherwise we prompt the user interactively. After saving we call
+ * /v1/whoami to validate that the key actually works — fail-fast is
+ * friendlier than saving a bad key and failing on the next command.
+ */
+export async function loginCommand(opts) {
+    let apiKey = opts.apiKey;
+    if (!apiKey) {
+        info("Get your API key at https://codespar.dev/dashboard/settings?tab=api-keys");
+        const rl = createInterface({ input, output });
+        try {
+            apiKey = (await rl.question("API key: ")).trim();
+        }
+        finally {
+            rl.close();
+        }
+    }
+    if (!apiKey)
+        throw new CliError("API key is required.");
+    if (!apiKey.startsWith("csk_")) {
+        throw new CliError("That doesn't look like a CodeSpar key — they start with `csk_live_` or `csk_test_`.");
+    }
+    const baseUrl = opts.baseUrl ?? process.env.CODESPAR_BASE_URL ?? "https://api.codespar.dev";
+    // Validate before saving so we don't persist a typo.
+    const client = new ApiClient({ apiKey, baseUrl });
+    const me = await client.get("/v1/whoami");
+    await saveConfig({ apiKey, baseUrl });
+    success(`Logged in as ${me.user?.email ?? me.user?.id ?? "unknown user"}`);
+    if (me.organization?.name) {
+        info(`Organization: ${me.organization.name}`);
+    }
+}
+export async function whoamiCommand(client, asJson) {
+    const me = await client.get("/v1/whoami");
+    if (asJson) {
+        const { json } = await import("../output.js");
+        json(me);
+        return;
+    }
+    const { kv } = await import("../output.js");
+    kv([
+        ["User", me.user?.email ?? me.user?.id ?? "(unknown)"],
+        ["Organization", me.organization?.name ?? "(none)"],
+        ["Project", me.project?.name ?? me.project?.id ?? "(none)"],
+        ["Key env", me.key?.environment ?? "(unknown)"],
+        ["Scopes", me.key?.scopes?.join(", ") ?? "(all)"],
+    ]);
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/logs.js

@@ -0,0 +1,74 @@
+import { CliError } from "../config.js";
+import { c, json } from "../output.js";
+/**
+ * Stream execution logs live from /v1/logs/stream (SSE).
+ * Falls through on Ctrl-C — we don't need a clean shutdown, the server
+ * will close the connection when stdin closes.
+ */
+export async function tailLogsCommand(config, opts) {
+    const url = new URL("/v1/logs/stream", config.baseUrl);
+    if (opts.server)
+        url.searchParams.set("server", opts.server);
+    if (opts.status)
+        url.searchParams.set("status", opts.status);
+    if (opts.tool)
+        url.searchParams.set("tool", opts.tool);
+    if (opts.limit)
+        url.searchParams.set("limit", opts.limit);
+    let res;
+    try {
+        res = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                Accept: "text/event-stream",
+            },
+        });
+    }
+    catch (err) {
+        throw new CliError(`Failed to connect: ${err.message}`);
+    }
+    if (!res.ok || !res.body) {
+        throw new CliError(`Log stream returned ${res.status}. Check your API key.`);
+    }
+    process.stderr.write(c.dim("Tailing logs — press Ctrl-C to stop\n\n"));
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        // SSE frames are separated by a blank line (\n\n).
+        const frames = buffer.split("\n\n");
+        buffer = frames.pop() ?? "";
+        for (const frame of frames) {
+            const dataLines = frame
+                .split("\n")
+                .filter((l) => l.startsWith("data: "))
+                .map((l) => l.slice(6));
+            if (dataLines.length === 0)
+                continue;
+            try {
+                const entry = JSON.parse(dataLines.join("\n"));
+                printEntry(entry, opts.json ?? false);
+            }
+            catch {
+                // Ignore malformed frames (keep-alives, comments)
+            }
+        }
+    }
+}
+function printEntry(entry, asJson) {
+    if (asJson) {
+        json(entry);
+        return;
+    }
+    const time = entry.called_at ? new Date(entry.called_at).toISOString().slice(11, 19) : "--:--:--";
+    const statusColor = entry.status === "success" ? c.green : entry.status === "error" ? c.red : c.yellow;
+    const statusLabel = statusColor(entry.status.toUpperCase().padEnd(7));
+    const durationStr = entry.duration_ms !== undefined ? `${entry.duration_ms}ms` : "";
+    const suffix = entry.error ? ` ${c.red(entry.error)}` : "";
+    process.stdout.write(`${c.gray(time)}  ${statusLabel}  ${entry.tool.padEnd(24)}  ${c.dim(entry.server.padEnd(16))}  ${c.dim(durationStr)}${suffix}\n`);
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

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