@codespar/cli 0.2.0

package/dist/commands/servers.js

@@ -0,0 +1,48 @@
+import { CliError } from "../config.js";
+import { json, kv, table } from "../output.js";
+export async function listServersCommand(client, opts) {
+    const data = await client.get("/v1/servers", {
+        category: opts.category,
+        region: opts.region,
+    });
+    if (opts.json) {
+        json(data.data);
+        return;
+    }
+    table(["ID", "NAME", "CATEGORY", "REGION", "TOOLS", "STATUS"], data.data.map((s) => [
+        s.id,
+        s.name,
+        s.category ?? "-",
+        s.region ?? "-",
+        String(s.tool_count ?? "-"),
+        s.status ?? "-",
+    ]));
+}
+export async function showServerCommand(client, id, opts) {
+    if (!id)
+        throw new CliError("Server id is required. Example: `codespar servers show stripe`");
+    const server = await client.get(`/v1/servers/${encodeURIComponent(id)}`);
+    if (opts.json) {
+        json(server);
+        return;
+    }
+    kv([
+        ["ID", server.id],
+        ["Name", server.name],
+        ["Category", server.category ?? "-"],
+        ["Region", server.region ?? "-"],
+        ["Status", server.status ?? "-"],
+        ["Auth", server.auth_type ?? "-"],
+        ["Tools", String(server.tool_count ?? server.tools?.length ?? "-")],
+    ]);
+    if (server.description) {
+        process.stdout.write(`\n${server.description}\n`);
+    }
+    if (server.tools && server.tools.length > 0) {
+        process.stdout.write("\nTools:\n");
+        for (const t of server.tools) {
+            process.stdout.write(`  • ${t.name}${t.description ? ` — ${t.description}` : ""}\n`);
+        }
+    }
+}
+//# sourceMappingURL=servers.js.map

package/dist/commands/servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.js","sourceRoot":"","sources":["../../src/commands/servers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAyB/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAiB,EAAE,IAAiB;IAC3E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAA4B,aAAa,EAAE;QACtE,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,KAAK,CACH,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EACvD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACnB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,QAAQ,IAAI,GAAG;QACjB,CAAC,CAAC,MAAM,IAAI,GAAG;QACf,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC;QAC3B,CAAC,CAAC,MAAM,IAAI,GAAG;KAChB,CAAC,CACH,CAAC;AACJ,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiB,EACjB,EAAU,EACV,IAAiB;IAEjB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,QAAQ,CAAC,gEAAgE,CAAC,CAAC;IAE9F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAe,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAEvF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IAED,EAAE,CAAC;QACD,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QACjB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;QACpC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;QAChC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;QAChC,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;QACjC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,CAAC,CAAC;KACpE,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/sessions.js

@@ -0,0 +1,62 @@
+import { CliError } from "../config.js";
+import { json, kv, success, table } from "../output.js";
+export async function listSessionsCommand(client, opts) {
+    const data = await client.get("/v1/sessions", {
+        status: opts.status,
+        limit: opts.limit,
+    });
+    if (opts.json) {
+        json(data.data);
+        return;
+    }
+    table(["ID", "USER", "STATUS", "SERVERS", "TOOL CALLS", "CREATED"], data.data.map((s) => [
+        s.id,
+        s.user_id ?? "-",
+        s.status ?? "-",
+        (s.servers ?? []).join(", "),
+        String(s.tool_call_count ?? 0),
+        s.created_at ? new Date(s.created_at).toISOString().slice(0, 19).replace("T", " ") : "-",
+    ]));
+}
+export async function showSessionCommand(client, id, opts) {
+    if (!id)
+        throw new CliError("Session id is required.");
+    const session = await client.get(`/v1/sessions/${encodeURIComponent(id)}`);
+    if (opts.json) {
+        if (opts.logs) {
+            const logs = await client.get(`/v1/sessions/${encodeURIComponent(id)}/logs`);
+            json({ session, logs: logs.data });
+        }
+        else {
+            json(session);
+        }
+        return;
+    }
+    kv([
+        ["ID", session.id],
+        ["User", session.user_id ?? "-"],
+        ["Status", session.status ?? "-"],
+        ["Servers", (session.servers ?? []).join(", ")],
+        ["Tool calls", String(session.tool_call_count ?? 0)],
+        ["Created", session.created_at ?? "-"],
+        ["Closed", session.closed_at ?? "-"],
+    ]);
+    if (opts.logs) {
+        const logs = await client.get(`/v1/sessions/${encodeURIComponent(id)}/logs`);
+        process.stdout.write("\nLogs:\n");
+        table(["TOOL", "SERVER", "STATUS", "MS", "AT"], logs.data.map((l) => [
+            l.tool,
+            l.server,
+            l.status,
+            String(l.duration_ms ?? "-"),
+            l.called_at ? new Date(l.called_at).toISOString().slice(11, 19) : "-",
+        ]));
+    }
+}
+export async function closeSessionCommand(client, id) {
+    if (!id)
+        throw new CliError("Session id is required.");
+    await client.post(`/v1/sessions/${encodeURIComponent(id)}/close`);
+    success(`Session ${id} closed.`);
+}
+//# sourceMappingURL=sessions.js.map

package/dist/commands/sessions.js.map

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

package/dist/commands/tools.js

@@ -0,0 +1,43 @@
+import { CliError } from "../config.js";
+import { json, kv, table } from "../output.js";
+export async function listToolsCommand(client, opts) {
+    const data = await client.get("/v1/tools", {
+        server: opts.server,
+    });
+    if (opts.json) {
+        json(data.data);
+        return;
+    }
+    table(["NAME", "SERVER", "DESCRIPTION"], data.data.map((t) => [
+        t.name,
+        t.server,
+        truncate(t.description ?? "", 60),
+    ]));
+}
+export async function showToolCommand(client, name, opts) {
+    if (!name)
+        throw new CliError("Tool name is required. Example: `codespar tools show codespar_pay`");
+    const tool = await client.get(`/v1/tools/${encodeURIComponent(name)}`);
+    if (opts.json) {
+        json(tool);
+        return;
+    }
+    kv([
+        ["Name", tool.name],
+        ["Server", tool.server],
+    ]);
+    if (tool.description)
+        process.stdout.write(`\n${tool.description}\n`);
+    if (tool.input_schema) {
+        process.stdout.write("\nInput schema:\n");
+        process.stdout.write(JSON.stringify(tool.input_schema, null, 2) + "\n");
+    }
+    if (tool.output_schema) {
+        process.stdout.write("\nOutput schema:\n");
+        process.stdout.write(JSON.stringify(tool.output_schema, null, 2) + "\n");
+    }
+}
+function truncate(s, n) {
+    return s.length <= n ? s : s.slice(0, n - 1) + "…";
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAkB/C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAiB,EAAE,IAAiB;IACzE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAA0B,WAAW,EAAE;QAClE,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,KAAK,CACH,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,EACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACnB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,MAAM;QACR,QAAQ,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,EAAE,CAAC;KAClC,CAAC,CACH,CAAC;AACJ,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,IAAY,EACZ,IAAiB;IAEjB,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,QAAQ,CAAC,oEAAoE,CAAC,CAAC;IAEpG,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAa,aAAa,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEnF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,CAAC;QACX,OAAO;IACT,CAAC;IAED,EAAE,CAAC;QACD,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAEtE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACrD,CAAC"}

package/dist/config.js

@@ -0,0 +1,57 @@
+import { readFile, writeFile, mkdir, chmod } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const CONFIG_DIR = join(homedir(), ".codespar");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+export async function loadConfig() {
+    const fromEnv = {
+        apiKey: process.env.CODESPAR_API_KEY,
+        project: process.env.CODESPAR_PROJECT,
+        baseUrl: process.env.CODESPAR_BASE_URL,
+    };
+    let fromFile = {};
+    try {
+        const raw = await readFile(CONFIG_FILE, "utf-8");
+        fromFile = JSON.parse(raw);
+    }
+    catch {
+        // No config file yet — that's fine, login will create it.
+    }
+    // Env wins over file; command-line flags override both at the call site.
+    return {
+        apiKey: fromEnv.apiKey ?? fromFile.apiKey,
+        project: fromEnv.project ?? fromFile.project,
+        baseUrl: fromEnv.baseUrl ?? fromFile.baseUrl ?? "https://api.codespar.dev",
+    };
+}
+export async function saveConfig(patch) {
+    await mkdir(dirname(CONFIG_FILE), { recursive: true });
+    let existing = {};
+    try {
+        existing = JSON.parse(await readFile(CONFIG_FILE, "utf-8"));
+    }
+    catch {
+        // fresh file
+    }
+    const next = { ...existing, ...patch };
+    await writeFile(CONFIG_FILE, JSON.stringify(next, null, 2) + "\n", "utf-8");
+    // File contains an API key — restrict to owner only.
+    await chmod(CONFIG_FILE, 0o600);
+}
+export function requireApiKey(config) {
+    if (!config.apiKey) {
+        throw new CliError("Not logged in. Run `codespar login` or set CODESPAR_API_KEY.");
+    }
+    return config.apiKey;
+}
+/**
+ * Error that should be printed to stderr and exit 1 without a stack trace.
+ * Anything else bubbling up is treated as a bug and prints the stack.
+ */
+export class CliError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CliError";
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiB1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,OAAO,GAAc;QACzB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACpC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACrC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;KACvC,CAAC;IAEF,IAAI,QAAQ,GAAc,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IAED,yEAAyE;IACzE,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;QAC5C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,0BAA0B;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAyB;IACxD,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvD,IAAI,QAAQ,GAAc,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAc,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,aAAa;IACf,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IACvC,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5E,qDAAqD;IACrD,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,QAAQ,CAChB,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/index.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { ApiClient } from "./api.js";
+import { CliError, loadConfig, requireApiKey } from "./config.js";
+import { loginCommand, whoamiCommand } from "./commands/login.js";
+import { listServersCommand, showServerCommand } from "./commands/servers.js";
+import { listToolsCommand, showToolCommand } from "./commands/tools.js";
+import { executeCommand } from "./commands/execute.js";
+import { closeSessionCommand, listSessionsCommand, showSessionCommand, } from "./commands/sessions.js";
+import { listConnectionsCommand, revokeConnectCommand, startConnectCommand, } from "./commands/connect.js";
+import { tailLogsCommand } from "./commands/logs.js";
+import { initCommand } from "./commands/init.js";
+import { c } from "./output.js";
+const VERSION = "0.2.0";
+const program = new Command();
+program
+    .name("codespar")
+    .description("CodeSpar CLI — authenticate, inspect servers, execute tools, manage sessions.")
+    .version(VERSION, "-v, --version")
+    .option("--api-key <key>", "CodeSpar API key (overrides config + env)")
+    .option("--base-url <url>", "API base URL (overrides config + env)")
+    .option("--json", "Output machine-readable JSON instead of tables");
+/** Build an authenticated ApiClient from config + CLI-level flags. */
+async function authedClient() {
+    const config = await loadConfig();
+    const root = program.opts();
+    const apiKey = root.apiKey ?? requireApiKey(config);
+    const baseUrl = root.baseUrl ?? config.baseUrl ?? "https://api.codespar.dev";
+    return new ApiClient({ apiKey, baseUrl });
+}
+function rootJsonFlag() {
+    return Boolean(program.opts().json);
+}
+// ============ auth ============
+program
+    .command("login")
+    .description("Authenticate and save your API key to ~/.codespar/config.json")
+    .option("--api-key <key>", "API key (prompts if omitted)")
+    .action(async (opts) => {
+    const root = program.opts();
+    await loginCommand({ apiKey: opts.apiKey, baseUrl: root.baseUrl });
+});
+program
+    .command("whoami")
+    .description("Show the authenticated user, org, project, and key scopes")
+    .action(async () => {
+    const client = await authedClient();
+    await whoamiCommand(client, rootJsonFlag());
+});
+program
+    .command("logout")
+    .description("Clear the stored API key")
+    .action(async () => {
+    const { saveConfig } = await import("./config.js");
+    await saveConfig({ apiKey: undefined });
+    const { success } = await import("./output.js");
+    success("Logged out.");
+});
+// ============ servers ============
+const servers = program.command("servers").description("Browse the server catalog");
+servers
+    .command("list")
+    .description("List servers")
+    .option("-c, --category <name>", "Filter by category")
+    .option("-r, --region <code>", "Filter by region (e.g. BR, MX)")
+    .action(async (opts) => {
+    const client = await authedClient();
+    await listServersCommand(client, { ...opts, json: rootJsonFlag() });
+});
+servers
+    .command("show <id>")
+    .description("Show details of a server")
+    .action(async (id) => {
+    const client = await authedClient();
+    await showServerCommand(client, id, { json: rootJsonFlag() });
+});
+// ============ tools ============
+const tools = program.command("tools").description("Inspect tools exposed by servers");
+tools
+    .command("list")
+    .description("List tools")
+    .option("-s, --server <id>", "Filter by server")
+    .action(async (opts) => {
+    const client = await authedClient();
+    await listToolsCommand(client, { ...opts, json: rootJsonFlag() });
+});
+tools
+    .command("show <name>")
+    .description("Show a tool's full schema")
+    .action(async (name) => {
+    const client = await authedClient();
+    await showToolCommand(client, name, { json: rootJsonFlag() });
+});
+// ============ execute ============
+program
+    .command("execute <tool>")
+    .description("Run a single tool call (creates a throwaway session)")
+    .requiredOption("-s, --server <id>", "Server to open the session against")
+    .option("-i, --input <json>", "Input as JSON string")
+    .option("-f, --input-file <path>", "Input as JSON file path")
+    .option("-u, --user <id>", "User id for the session (default: cli-user)")
+    .action(async (tool, opts) => {
+    const config = await loadConfig();
+    const root = program.opts();
+    const apiKey = root.apiKey ?? requireApiKey(config);
+    const baseUrl = root.baseUrl ?? config.baseUrl ?? "https://api.codespar.dev";
+    await executeCommand(tool, {
+        ...opts,
+        apiKey,
+        baseUrl,
+        json: rootJsonFlag(),
+    });
+});
+// ============ sessions ============
+const sessions = program.command("sessions").description("Inspect and manage sessions");
+sessions
+    .command("list")
+    .description("List recent sessions")
+    .option("--status <s>", "Filter by status: active, closed, error")
+    .option("--limit <n>", "Max results (default 50)")
+    .action(async (opts) => {
+    const client = await authedClient();
+    await listSessionsCommand(client, { ...opts, json: rootJsonFlag() });
+});
+sessions
+    .command("show <id>")
+    .description("Show a session's details")
+    .option("--logs", "Also include tool-call logs")
+    .action(async (id, opts) => {
+    const client = await authedClient();
+    await showSessionCommand(client, id, { ...opts, json: rootJsonFlag() });
+});
+sessions
+    .command("close <id>")
+    .description("Close an active session")
+    .action(async (id) => {
+    const client = await authedClient();
+    await closeSessionCommand(client, id);
+});
+// ============ connect ============
+const connect = program.command("connect").description("Manage Connect Links for end-user provider OAuth");
+connect
+    .command("list")
+    .description("List active connections")
+    .option("-u, --user <id>", "Filter by user")
+    .option("--status <s>", "Filter by status: connected, pending, revoked, expired")
+    .action(async (opts) => {
+    const client = await authedClient();
+    await listConnectionsCommand(client, { ...opts, json: rootJsonFlag() });
+});
+connect
+    .command("start <server>")
+    .description("Start a Connect Link flow for a server")
+    .option("-u, --user <id>", "User id (default: cli-user)")
+    .option("--open", "Open the link in the system browser")
+    .action(async (server, opts) => {
+    const client = await authedClient();
+    await startConnectCommand(client, server, { ...opts, json: rootJsonFlag() });
+});
+connect
+    .command("revoke <server>")
+    .description("Revoke an existing connection")
+    .option("-u, --user <id>", "User id (default: cli-user)")
+    .action(async (server, opts) => {
+    const client = await authedClient();
+    await revokeConnectCommand(client, server, opts);
+});
+// ============ logs ============
+const logs = program.command("logs").description("Inspect tool-call execution logs");
+logs
+    .command("tail")
+    .description("Stream logs in real time (SSE)")
+    .option("-s, --server <id>", "Filter by server")
+    .option("--status <s>", "Filter by status: success, error, running")
+    .option("-t, --tool <name>", "Filter by tool name")
+    .option("--limit <n>", "Request up to N backfilled entries before tailing")
+    .action(async (opts) => {
+    const config = await loadConfig();
+    const root = program.opts();
+    const apiKey = root.apiKey ?? requireApiKey(config);
+    const baseUrl = root.baseUrl ?? config.baseUrl ?? "https://api.codespar.dev";
+    await tailLogsCommand({ apiKey, baseUrl }, { ...opts, json: rootJsonFlag() });
+});
+// ============ init ============
+program
+    .command("init <name>")
+    .description("Scaffold a new commerce agent from a template")
+    .option("-t, --template <slug>", "Template slug (pix-agent, ecommerce-checkout, streaming-chat, multi-tenant)")
+    .option("-y, --yes", "Use default template without prompting")
+    .action(async (name, opts) => {
+    await initCommand(name, opts);
+});
+// ============ global error handling ============
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            process.stderr.write(`${c.red("✗")} ${err.message}\n`);
+            process.exit(1);
+        }
+        // Unexpected error — show stack so we can debug.
+        process.stderr.write(`${c.red("✗ internal error:")}\n`);
+        process.stderr.write(String(err.stack ?? err) + "\n");
+        process.exit(2);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output.js

@@ -0,0 +1,54 @@
+/**
+ * Output helpers. Zero deps — ANSI color codes directly, disabled when
+ * `NO_COLOR` is set, `FORCE_COLOR=0`, or stdout is not a TTY. This keeps
+ * piped output (`| jq`, `| grep`) plain text without us having to strip.
+ */
+const USE_COLOR = process.env.NO_COLOR === undefined &&
+    process.env.FORCE_COLOR !== "0" &&
+    (process.env.FORCE_COLOR !== undefined || process.stdout.isTTY);
+function wrap(open, close) {
+    return (s) => (USE_COLOR ? `\x1b[${open}m${s}\x1b[${close}m` : s);
+}
+export const c = {
+    dim: wrap("2", "22"),
+    bold: wrap("1", "22"),
+    green: wrap("32", "39"),
+    red: wrap("31", "39"),
+    yellow: wrap("33", "39"),
+    blue: wrap("34", "39"),
+    gray: wrap("90", "39"),
+};
+/** Print a compact key/value block. Used for `whoami` and `servers show`. */
+export function kv(pairs) {
+    const width = Math.max(...pairs.map(([k]) => k.length));
+    for (const [k, v] of pairs) {
+        process.stdout.write(`${c.gray(k.padEnd(width))}  ${v}\n`);
+    }
+}
+/** Print a table with aligned columns. `headers` are shown in bold gray. */
+export function table(headers, rows) {
+    if (rows.length === 0) {
+        process.stderr.write(c.dim("(no results)\n"));
+        return;
+    }
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
+    const fmt = (cells) => cells.map((cell, i) => cell.padEnd(widths[i])).join("  ");
+    process.stdout.write(c.bold(c.gray(fmt(headers))) + "\n");
+    for (const row of rows)
+        process.stdout.write(fmt(row) + "\n");
+}
+/** Print valid JSON to stdout — for `--json` flag / scripting. */
+export function json(value) {
+    process.stdout.write(JSON.stringify(value, null, 2) + "\n");
+}
+/** Info message to stderr (keeps stdout clean for scripting). */
+export function info(msg) {
+    process.stderr.write(`${c.blue("ℹ")} ${msg}\n`);
+}
+export function success(msg) {
+    process.stderr.write(`${c.green("✓")} ${msg}\n`);
+}
+export function warn(msg) {
+    process.stderr.write(`${c.yellow("⚠")} ${msg}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@codespar/cli",
+  "version": "0.2.0",
+  "description": "CodeSpar CLI — authenticate, browse servers, execute tools, manage sessions, stream logs, and scaffold projects from your terminal.",
+  "type": "module",
+  "bin": {
+    "codespar": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "codespar",
+    "ai-agent",
+    "commerce",
+    "mcp",
+    "pix",
+    "latam"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codespar/codespar-core",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://codespar.dev/docs/cli",
+  "bugs": {
+    "url": "https://github.com/codespar/codespar-core/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@codespar/sdk": "^0.2.0",
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^5.8.0"
+  }
+}

package/templates/ecommerce-checkout/.env.example

@@ -0,0 +1,2 @@
+CODESPAR_API_KEY=csk_live_...
+ANTHROPIC_API_KEY=sk-ant-...

package/templates/ecommerce-checkout/README.md

@@ -0,0 +1,22 @@
+# {{name}}
+
+End-to-end e-commerce checkout agent scaffolded by `codespar init`.
+
+## Setup
+
+```bash
+cp .env.example .env
+# Fill in CODESPAR_API_KEY and ANTHROPIC_API_KEY
+
+npm install
+npm run dev
+```
+
+## What it does
+
+Handles the full Complete Loop: product discovery → checkout → invoice (NF-e) → shipping → WhatsApp notification. Uses Claude as the reasoning engine.
+
+## Learn more
+
+- [E-Commerce Checkout cookbook](https://codespar.dev/docs/cookbooks/ecommerce-checkout)
+- [Claude provider reference](https://codespar.dev/docs/providers/claude)

package/templates/ecommerce-checkout/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@codespar/sdk": "^0.2.0",
+    "@codespar/claude": "^0.2.0",
+    "@anthropic-ai/sdk": "^0.40.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}