@agent-commons/cli 0.1.4 → 0.1.6

package/dist/bin.js

@@ -24,11 +24,17 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/bin.ts
-var import_commander12 = require("commander");
+var import_commander16 = require("commander");
+var import_path3 = require("path");
+var import_os3 = require("os");
+var import_child_process2 = require("child_process");
 
 // src/commands/login.ts
 var import_commander = require("commander");
 var readline = __toESM(require("readline"));
+var import_fs2 = require("fs");
+var import_path2 = require("path");
+var import_os2 = require("os");
 
 // src/config.ts
 var import_fs = require("fs");
@@ -37,7 +43,8 @@ var import_path = require("path");
 var import_sdk = require("@agent-commons/sdk");
 var CONFIG_DIR = (0, import_path.join)((0, import_os.homedir)(), ".agc");
 var CONFIG_FILE = (0, import_path.join)(CONFIG_DIR, "config.json");
-var DEFAULT_API_URL = process.env.AGC_API_URL ?? "http://localhost:3001";
+var DEFAULT_API_URL = process.env.AGC_API_URL ?? "https://api.agentcommons.io";
+var DEFAULT_APP_URL = "https://www.agentcommons.io";
 function loadConfig() {
   const fromEnv = {
     ...process.env.AGC_API_URL && { apiUrl: process.env.AGC_API_URL },
@@ -81,6 +88,7 @@ function makeClient(overrides) {
 // src/ui.ts
 var import_chalk = __toESM(require("chalk"));
 var import_ora = __toESM(require("ora"));
+var import_child_process = require("child_process");
 var c = {
   primary: (s) => import_chalk.default.cyan(s),
   success: (s) => import_chalk.default.green(s),
@@ -98,6 +106,80 @@ var sym = {
   bullet: import_chalk.default.dim("\u2022"),
   dot: import_chalk.default.dim("\xB7")
 };
+function banner(version = "0.1.4") {
+  const line = import_chalk.default.cyan("  \u2500".padEnd(2) + "\u2500".repeat(44));
+  console.log("");
+  console.log(line);
+  console.log(
+    import_chalk.default.cyan("  \u2502 ") + import_chalk.default.bold.white(" \u25C8  Agent Commons") + import_chalk.default.dim("  \xB7  CLI") + "  " + import_chalk.default.cyan(`v${version}`)
+  );
+  console.log(import_chalk.default.cyan("  \u2502 ") + import_chalk.default.dim("  The Open AI Agent Network  \xB7  agentcommons.io"));
+  console.log(line);
+  console.log("");
+}
+function step(n, total, title) {
+  const fraction = import_chalk.default.dim(`${n}/${total}`);
+  console.log(`
+${import_chalk.default.cyan.bold("  Step " + n)} ${fraction}  ${import_chalk.default.bold(title)}`);
+  console.log(import_chalk.default.dim("  " + "\u2500".repeat(38)));
+}
+async function select(prompt2, choices) {
+  if (!process.stdin.isTTY) {
+    return choices[0].value;
+  }
+  let idx = 0;
+  const total = choices.length;
+  const render = (first = false) => {
+    if (!first) {
+      process.stdout.write(`\x1B[${total + 2}A\x1B[0J`);
+    }
+    console.log("\n" + import_chalk.default.bold("  " + prompt2));
+    for (let i = 0; i < total; i++) {
+      const { label, hint } = choices[i];
+      if (i === idx) {
+        const hintStr = hint ? import_chalk.default.dim("  " + hint) : "";
+        process.stdout.write(import_chalk.default.cyan("  \u203A ") + import_chalk.default.bold.white(label) + hintStr + "\n");
+      } else {
+        process.stdout.write(import_chalk.default.dim("    " + label) + "\n");
+      }
+    }
+  };
+  render(true);
+  return new Promise((resolve) => {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding("utf8");
+    const handler = (data) => {
+      const key = String(data);
+      if (key === "\x1B[A" || key === "k") {
+        idx = (idx - 1 + total) % total;
+        render();
+      } else if (key === "\x1B[B" || key === "j") {
+        idx = (idx + 1) % total;
+        render();
+      } else if (key === "\r" || key === "\n" || key === " ") {
+        cleanup();
+        process.stdout.write("\n");
+        resolve(choices[idx].value);
+      } else if (key === "") {
+        cleanup();
+        process.stdout.write("\n");
+        process.exit(130);
+      }
+    };
+    const cleanup = () => {
+      process.stdin.removeListener("data", handler);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+    };
+    process.stdin.on("data", handler);
+  });
+}
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? `open "${url}"` : process.platform === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`;
+  (0, import_child_process.exec)(cmd, () => {
+  });
+}
 function spin(text) {
   return (0, import_ora.default)({ text, color: "cyan" }).start();
 }
@@ -174,6 +256,7 @@ function statusBadge(status) {
 }
 
 // src/commands/login.ts
+var CONFIG_FILE2 = (0, import_path2.join)((0, import_os2.homedir)(), ".agc", "config.json");
 function prompt(question, hidden = false) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
@@ -202,26 +285,70 @@ function loginCommand() {
   cmd.option("--api-url <url>", "API base URL", DEFAULT_API_URL).option("--api-key <key>", "API key (or set AGC_API_KEY env var)").option("--initiator <id>", "Default initiator ID (wallet address or user ID)").action(async (opts) => {
     try {
       const current = loadConfig();
-      const apiUrl = opts.apiUrl !== DEFAULT_API_URL ? opts.apiUrl : await prompt(`API URL [${current.apiUrl ?? DEFAULT_API_URL}]: `) || (current.apiUrl ?? DEFAULT_API_URL);
-      const appUrl = apiUrl.includes("localhost") ? "http://localhost:3000" : apiUrl.replace(/\/api$/, "").replace("api.", "").replace(":3001", ":3000");
+      const isFirstRun = !(0, import_fs2.existsSync)(CONFIG_FILE2);
+      banner();
+      if (isFirstRun) {
+        console.log(c.bold("  Welcome to Agent Commons CLI!"));
+        console.log(c.dim("  Let's get you set up in three quick steps.\n"));
+      } else {
+        console.log(c.bold("  Update your credentials"));
+        console.log(c.dim("  Press Enter to keep existing values.\n"));
+      }
+      step(1, 3, "API Endpoint");
+      const defaultUrl = current.apiUrl ?? DEFAULT_API_URL;
+      let apiUrl;
+      if (opts.apiUrl !== DEFAULT_API_URL) {
+        apiUrl = opts.apiUrl;
+        console.log(`  ${c.dim("Using:")} ${apiUrl}`);
+      } else {
+        const answer = await prompt(
+          `  ${c.dim("URL")} [${c.dim(defaultUrl)}]: `
+        );
+        apiUrl = answer || defaultUrl;
+      }
+      console.log(`  ${sym.ok} ${c.dim("Endpoint:")} ${c.primary(apiUrl)}`);
+      const appUrl = apiUrl.includes("localhost") ? "http://localhost:3000" : DEFAULT_APP_URL;
+      const settingsUrl = `${appUrl}/settings`;
+      step(2, 3, "API Key");
       let apiKey = opts.apiKey;
       if (!apiKey) {
-        console.log(`
-  Generate an API key at:
-  ${c.bold(`${appUrl}/settings/api-keys`)}
+        console.log(`  ${sym.arrow} Opening your browser to generate an API key\u2026`);
+        console.log(`  ${c.dim(settingsUrl)}
 `);
-        apiKey = await prompt(`API Key (sk-ac-...): `);
+        openBrowser(settingsUrl);
+        console.log(c.dim("  Once you have your key, paste it below."));
+        console.log(c.dim("  (Keys look like:  sk-ac-xxxxxxxxxxxxxxxx)\n"));
+        apiKey = await prompt(`  ${c.dim("API Key:")} `);
         if (!apiKey) apiKey = current.apiKey;
       }
+      if (!apiKey) {
+        console.log(`
+  ${c.warn("\u26A0")}  No API key provided \u2014 you can set one later with ${c.bold("agc config set apiKey <key>")}`);
+      } else {
+        console.log(`  ${sym.ok} ${c.dim("Key saved:")} ****${apiKey.slice(-4)}`);
+      }
+      step(3, 3, "Your Identity");
       let initiator = opts.initiator;
       if (!initiator) {
-        initiator = await prompt(`Wallet address (0x...): `);
+        const defaultInitiator = current.initiator ?? "";
+        const hint = defaultInitiator ? `[${c.dim(defaultInitiator.slice(0, 8) + "\u2026")}] ` : "";
+        initiator = await prompt(`  ${c.dim("Wallet address (0x\u2026):")} ${hint}`);
         if (!initiator) initiator = current.initiator;
       }
+      if (!initiator) {
+        console.log(`  ${c.warn("\u26A0")}  No wallet address \u2014 set one later with ${c.bold("agc config set initiator <address>")}`);
+      } else {
+        console.log(`  ${sym.ok} ${c.dim("Address:")} ${c.id(initiator.slice(0, 10) + "\u2026" + initiator.slice(-6))}`);
+      }
       saveConfig({ apiUrl, apiKey, initiator });
       console.log(`
-${sym.ok} Credentials saved to ~/.agc/config.json`);
-      console.log(c.dim("  Run `agc whoami` to verify the connection."));
+  ${sym.ok} ${c.success("All set!")}  Credentials saved to ${c.dim("~/.agc/config.json")}`);
+      console.log(`
+  ${c.dim("Next steps:")}`);
+      console.log(`  ${sym.arrow} ${c.dim("Run")} ${c.bold("agc")} ${c.dim("for an interactive menu")}`);
+      console.log(`  ${sym.arrow} ${c.dim("Run")} ${c.bold("agc whoami")} ${c.dim("to verify your connection")}`);
+      console.log(`  ${sym.arrow} ${c.dim("Run")} ${c.bold("agc chat --agent <id>")} ${c.dim("to start chatting")}
+`);
     } catch (err) {
       printError(err);
       process.exit(1);
@@ -381,6 +508,76 @@ ${sym.ok} Agent created`);
       process.exit(1);
     }
   });
+  const autonomy = cmd.command("autonomy").description("Manage agent heartbeat / autonomy");
+  autonomy.command("status").description("Show autonomy status for an agent").requiredOption("--agent <agentId>", "Agent ID").option("--json", "Output as JSON").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin("Fetching autonomy status\u2026");
+    try {
+      const res = await client.agents.getAutonomy(opts.agent);
+      spinner.stop();
+      const s = res.data;
+      if (opts.json) return jsonOut(s);
+      console.log(`
+${c.bold("Autonomy Status")}`);
+      detail([
+        ["Enabled", s.enabled ? c.bold("yes") : "no"],
+        ["Interval", s.intervalSec ? `${s.intervalSec}s` : "n/a"],
+        ["Armed", s.isArmed ? c.bold("yes") : "no"],
+        ["Last beat", s.lastBeatAt ? new Date(s.lastBeatAt).toLocaleString() : "never"],
+        ["Next beat", s.nextBeatAt ? new Date(s.nextBeatAt).toLocaleString() : "n/a"]
+      ]);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  autonomy.command("enable").description("Enable autonomous heartbeat for an agent").requiredOption("--agent <agentId>", "Agent ID").option("--interval <seconds>", "Heartbeat interval in seconds (min 30)", "300").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin("Enabling autonomy\u2026");
+    try {
+      await client.agents.setAutonomy(opts.agent, {
+        enabled: true,
+        intervalSec: parseInt(opts.interval, 10)
+      });
+      spinner.stop();
+      console.log(`
+${sym.ok} Autonomy enabled for agent ${c.id(opts.agent)}`);
+      console.log(c.dim(`  Heartbeat every ${opts.interval}s`));
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  autonomy.command("disable").description("Disable autonomous heartbeat for an agent").requiredOption("--agent <agentId>", "Agent ID").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin("Disabling autonomy\u2026");
+    try {
+      await client.agents.setAutonomy(opts.agent, { enabled: false });
+      spinner.stop();
+      console.log(`
+${sym.ok} Autonomy disabled for agent ${c.id(opts.agent)}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  autonomy.command("trigger").description("Trigger a single heartbeat beat immediately").requiredOption("--agent <agentId>", "Agent ID").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin("Triggering heartbeat\u2026");
+    try {
+      await client.agents.triggerHeartbeat(opts.agent);
+      spinner.stop();
+      console.log(`
+${sym.ok} Heartbeat triggered for agent ${c.id(opts.agent)}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
   return cmd;
 }
 
@@ -388,33 +585,29 @@ ${sym.ok} Agent created`);
 var import_commander3 = require("commander");
 function sessionsCommand() {
   const cmd = new import_commander3.Command("sessions").description("Manage chat sessions");
-  cmd.command("list").description("List sessions for the current initiator + agent").option("--agent <agentId>", "Filter by agent ID").option("--json", "Output as JSON").action(async (opts) => {
+  cmd.command("list").description("List sessions \u2014 all for the current user, or filtered by agent").option("--agent <agentId>", "Filter by agent ID (default: all agents)").option("--json", "Output as JSON").action(async (opts) => {
     const cfg = loadConfig();
     if (!cfg.initiator) {
       console.error(c.error("No initiator set. Run `agc login` first."));
       process.exit(1);
     }
-    const agentId = opts.agent ?? cfg.defaultAgentId;
-    if (!agentId) {
-      console.error(c.error("Specify --agent <agentId> or set defaultAgentId with `agc config set defaultAgentId <id>`"));
-      process.exit(1);
-    }
     const spinner = spin("Fetching sessions\u2026");
     try {
       const client = makeClient();
-      const res = await client.sessions.list(agentId, cfg.initiator);
+      const agentId = opts.agent ?? cfg.defaultAgentId;
+      const res = agentId ? await client.sessions.list(agentId, cfg.initiator) : await client.sessions.listByUser(cfg.initiator);
       const sessions = res?.data ?? res ?? [];
       spinner.stop();
       if (opts.json) return jsonOut(sessions);
-      section(`Sessions (${sessions.length})`);
+      section(`Sessions (${sessions.length})${agentId ? ` \u2014 agent ${agentId.slice(0, 8)}\u2026` : " \u2014 all agents"}`);
       table(
         sessions.map((s) => ({
           ID: s.sessionId.slice(0, 8) + "\u2026",
+          Agent: s.agentId ? s.agentId.slice(0, 8) + "\u2026" : "",
           Title: s.title ?? c.dim("(untitled)"),
-          Model: s.model?.modelId ?? s.model?.name ?? "",
           Created: relativeTime(s.createdAt)
         })),
-        ["ID", "Title", "Model", "Created"]
+        ["ID", "Agent", "Title", "Created"]
       );
     } catch (err) {
       spinner.stop();
@@ -666,9 +859,24 @@ function workflowCommand() {
 ${sym.ok} Execution started: ${c.id(execution.executionId)}`);
       console.log(`   Status: ${statusBadge(execution.status)}`);
       if (!opts.watch) {
+        const result = execution.result ?? execution.outputData;
         if (execution.status === "completed") {
           console.log("\n" + c.label("Result"));
-          console.log("  " + JSON.stringify(execution.result ?? execution.outputData, null, 2));
+          console.log("  " + JSON.stringify(result, null, 2));
+          const steps = execution.stepResults ?? execution.nodeResults;
+          if (steps && Object.keys(steps).length > 0) {
+            console.log("\n" + c.label("Step Results"));
+            for (const [nodeId, step2] of Object.entries(steps)) {
+              const icon = step2.status === "success" ? sym.ok : step2.status === "error" ? sym.fail : "\xB7";
+              const dur = step2.duration != null ? c.dim(` (${(step2.duration / 1e3).toFixed(2)}s)`) : "";
+              console.log(`  ${icon} ${c.id(nodeId)}${dur}`);
+              if (step2.error) console.log(`    ${c.error(step2.error)}`);
+              else if (step2.output !== void 0) console.log(`    ${JSON.stringify(step2.output, null, 2).replace(/\n/g, "\n    ")}`);
+            }
+          }
+        } else {
+          console.log(c.dim(`
+  Workflow is ${execution.status}. Use --watch to stream progress.`));
         }
         return;
       }
@@ -682,10 +890,20 @@ ${sym.ok} Execution started: ${c.id(execution.executionId)}`);
           console.log(`
 ${sym.ok} ${c.success("Completed")}`);
           const e = event;
-          if (e.outputData) {
+          if (e.outputData != null) {
             console.log("\n" + c.label("Output"));
             console.log("  " + JSON.stringify(e.outputData, null, 2));
           }
+          if (e.nodeResults && Object.keys(e.nodeResults).length > 0) {
+            console.log("\n" + c.label("Step Results"));
+            for (const [nodeId, step2] of Object.entries(e.nodeResults)) {
+              const icon = step2.status === "success" ? sym.ok : step2.status === "error" ? sym.fail : "\xB7";
+              const dur = step2.duration != null ? c.dim(` (${(step2.duration / 1e3).toFixed(2)}s)`) : "";
+              console.log(`  ${icon} ${c.id(nodeId)}${dur}`);
+              if (step2.error) console.log(`    ${c.error(step2.error)}`);
+              else if (step2.output !== void 0) console.log(`    ${JSON.stringify(step2.output, null, 2).replace(/\n/g, "\n    ")}`);
+            }
+          }
           break;
         } else if (event.type === "failed" || event.type === "cancelled") {
           process.stdout.write("\n");
@@ -1929,8 +2147,78 @@ ${sym.ok} ${c.bold("Wallet created")}`);
       process.exit(1);
     }
   });
+  cmd.command("send").description("Send USDC (or ETH) from an agent wallet to another address").requiredOption("--agent <agentId>", "Agent ID").requiredOption("--to <address>", "Recipient address (0x\u2026)").requiredOption("--amount <amount>", "Amount to send (e.g. 10.5)").option("--token <symbol>", "Token to send: USDC or ETH (default: USDC)", "USDC").option("--wallet <walletId>", "Specific wallet ID (defaults to primary)").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin("Preparing transfer\u2026");
+    try {
+      let walletId = opts.wallet;
+      if (!walletId) {
+        const primary = await client.wallets.primary(opts.agent);
+        const w = primary?.data ?? primary;
+        if (!w?.id) {
+          spinner.stop();
+          console.error(c.error(`No wallet found for agent ${opts.agent}. Run: agc wallet create --agent ${opts.agent}`));
+          process.exit(1);
+        }
+        walletId = w.id;
+      }
+      spinner.text = `Sending ${opts.amount} ${opts.token} \u2192 ${opts.to}\u2026`;
+      const result = await client.wallets.transfer(walletId, {
+        toAddress: opts.to,
+        amount: opts.amount,
+        tokenSymbol: opts.token
+      });
+      const tx = result?.txHash ?? result?.data?.txHash ?? result;
+      spinner.stop();
+      console.log(`
+${c.bold("Transfer sent")}`);
+      detail([
+        ["Amount", `${opts.amount} ${opts.token}`],
+        ["To", opts.to],
+        ["Tx Hash", c.id(tx)]
+      ]);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("x402-fetch").description("Fetch a URL using an agent wallet to pay any x402 (402 Payment Required) challenge").requiredOption("--agent <agentId>", "Agent ID").requiredOption("--url <url>", "Target URL to fetch").option("--method <method>", "HTTP method", "GET").option("--header <header>", "Extra header in Key:Value format (repeatable)", collect, []).option("--body <body>", "Request body string").option("--json", "Output response as JSON").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin(`Fetching ${opts.url}\u2026`);
+    try {
+      const headers = {};
+      for (const h of opts.header) {
+        const idx = h.indexOf(":");
+        if (idx > 0) headers[h.slice(0, idx).trim()] = h.slice(idx + 1).trim();
+      }
+      const res = await client.wallets.x402Fetch(opts.agent, {
+        url: opts.url,
+        method: opts.method,
+        headers: Object.keys(headers).length ? headers : void 0,
+        body: opts.body
+      });
+      spinner.stop();
+      if (opts.json) return jsonOut(res);
+      console.log(`
+${c.bold("Response")}  status ${res.status}`);
+      if (res.status === 200) {
+        console.log(c.dim(JSON.stringify(res.body, null, 2).slice(0, 1e3)));
+      } else {
+        console.log(c.warn(JSON.stringify(res.body, null, 2)));
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
   return cmd;
 }
+function collect(val, acc) {
+  acc.push(val);
+  return acc;
+}
 function chainName(chainId) {
   const names = {
     "84532": "Base Sepolia",
@@ -1941,9 +2229,446 @@ function chainName(chainId) {
   return names[chainId] ?? `chain ${chainId}`;
 }
 
+// src/commands/models.ts
+var import_commander12 = require("commander");
+function modelsCommand() {
+  const cmd = new import_commander12.Command("models").description("List available LLM models");
+  cmd.command("ls").description("List all available models grouped by provider").option("--provider <name>", "Filter by provider (openai, anthropic, google, mistral, groq, ollama)").option("--json", "Output as JSON").action(async (opts) => {
+    const client = makeClient();
+    const spinner = spin("Fetching models\u2026");
+    try {
+      const res = await client.models.list();
+      spinner.stop();
+      const all = res?.data ?? res ?? [];
+      if (opts.json) return jsonOut(all);
+      const filtered = opts.provider ? all.filter((m) => m.provider === opts.provider) : all;
+      if (filtered.length === 0) {
+        console.log(c.warn("  No models found."));
+        return;
+      }
+      const grouped = {};
+      for (const m of filtered) {
+        if (!grouped[m.provider]) grouped[m.provider] = [];
+        grouped[m.provider].push(m);
+      }
+      for (const [provider, models] of Object.entries(grouped)) {
+        console.log(`
+${c.bold(provider.toUpperCase())}`);
+        for (const m of models) {
+          const tags = [
+            m.tier,
+            m.supportsTools ? "tools" : "",
+            m.supportsVision ? "vision" : ""
+          ].filter(Boolean).join(", ");
+          const price = m.inputPricePer1kTokens > 0 ? c.dim(` ($${m.inputPricePer1kTokens}/$${m.outputPricePer1kTokens} /1k)`) : c.dim(" (free/local)");
+          console.log(`  ${c.id(m.modelId.padEnd(36))} ${m.displayName.padEnd(24)} ${c.dim(tags)}${price}`);
+        }
+      }
+      console.log();
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  return cmd;
+}
+
+// src/commands/memory.ts
+var import_commander13 = require("commander");
+function memoryCommand() {
+  const cmd = new import_commander13.Command("memory").description("View and manage agent memories");
+  cmd.command("list").description("List memories for an agent").option("--agent <agentId>", "Agent ID (defaults to configured agent)").option("--type <type>", "Filter by type: episodic | semantic | procedural").option("--limit <n>", "Max results", "50").option("--json", "Output as JSON").action(async (opts) => {
+    const cfg = loadConfig();
+    const agentId = opts.agent ?? cfg.defaultAgentId;
+    if (!agentId) {
+      console.error(c.error("Specify --agent <agentId> or set defaultAgentId"));
+      process.exit(1);
+    }
+    const spinner = spin("Fetching memories\u2026");
+    try {
+      const client = makeClient();
+      const res = await client.memory.list(agentId, {
+        type: opts.type,
+        limit: parseInt(opts.limit, 10)
+      });
+      const memories = res?.data ?? res ?? [];
+      spinner.stop();
+      if (opts.json) return jsonOut(memories);
+      section(`Memories for ${agentId.slice(0, 12)}\u2026 (${memories.length})`);
+      if (memories.length === 0) {
+        console.log(c.dim("  No memories yet"));
+        return;
+      }
+      table(
+        memories.map((m) => ({
+          ID: m.memoryId?.slice(0, 8) + "\u2026",
+          Type: m.memoryType ?? "",
+          Content: (m.content ?? "").slice(0, 60),
+          Created: relativeTime(m.createdAt)
+        })),
+        ["ID", "Type", "Content", "Created"]
+      );
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("stats").description("Show memory statistics for an agent").option("--agent <agentId>", "Agent ID").option("--json", "Output as JSON").action(async (opts) => {
+    const cfg = loadConfig();
+    const agentId = opts.agent ?? cfg.defaultAgentId;
+    if (!agentId) {
+      console.error(c.error("Specify --agent <agentId>"));
+      process.exit(1);
+    }
+    const spinner = spin("Fetching stats\u2026");
+    try {
+      const client = makeClient();
+      const res = await client.memory.stats(agentId);
+      const stats = res?.data ?? res;
+      spinner.stop();
+      if (opts.json) return jsonOut(stats);
+      section("Memory Stats");
+      detail([
+        ["Total", String(stats.totalCount ?? 0)],
+        ["Episodic", String(stats.episodicCount ?? 0)],
+        ["Semantic", String(stats.semanticCount ?? 0)],
+        ["Procedural", String(stats.proceduralCount ?? 0)]
+      ]);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("create").description("Manually add a memory for an agent").requiredOption("--agent <agentId>", "Agent ID").requiredOption("--content <text>", "Memory content").option("--type <type>", "Memory type: episodic | semantic | procedural", "semantic").option("--json", "Output as JSON").action(async (opts) => {
+    const spinner = spin("Creating memory\u2026");
+    try {
+      const client = makeClient();
+      const res = await client.memory.create({
+        agentId: opts.agent,
+        content: opts.content,
+        memoryType: opts.type
+      });
+      const memory = res?.data ?? res;
+      spinner.stop();
+      if (opts.json) return jsonOut(memory);
+      console.log(`
+${sym.ok} Memory created`);
+      detail([
+        ["ID", c.id(memory.memoryId)],
+        ["Type", memory.memoryType ?? ""],
+        ["Content", memory.content ?? ""]
+      ]);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("delete <memoryId>").description("Delete a memory by ID").option("--json", "Output as JSON").action(async (memoryId, opts) => {
+    const spinner = spin("Deleting memory\u2026");
+    try {
+      const client = makeClient();
+      await client.memory.delete(memoryId);
+      spinner.stop();
+      if (opts.json) return jsonOut({ deleted: true, memoryId });
+      console.log(`
+${sym.ok} Memory ${c.id(memoryId)} deleted`);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("search <query>").description("Semantic search over agent memories").option("--agent <agentId>", "Agent ID").option("--limit <n>", "Max results", "10").option("--json", "Output as JSON").action(async (query, opts) => {
+    const cfg = loadConfig();
+    const agentId = opts.agent ?? cfg.defaultAgentId;
+    if (!agentId) {
+      console.error(c.error("Specify --agent <agentId>"));
+      process.exit(1);
+    }
+    const spinner = spin("Searching memories\u2026");
+    try {
+      const client = makeClient();
+      const res = await client.memory.retrieve(agentId, query, parseInt(opts.limit, 10));
+      const memories = res?.data ?? res ?? [];
+      spinner.stop();
+      if (opts.json) return jsonOut(memories);
+      section(`Search results (${memories.length})`);
+      if (memories.length === 0) {
+        console.log(c.dim("  No relevant memories found"));
+        return;
+      }
+      memories.forEach((m, i) => {
+        console.log(`
+  ${c.dim(`${i + 1}.`)} ${m.content ?? ""}`);
+        console.log(`     ${c.dim(`type: ${m.memoryType ?? ""} \xB7 ${relativeTime(m.createdAt)}`)}`);
+      });
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  return cmd;
+}
+
+// src/commands/usage.ts
+var import_commander14 = require("commander");
+function usageCommand() {
+  const cmd = new import_commander14.Command("usage").description("View token usage and cost by agent");
+  cmd.command("agents").description("Show usage summary for all your agents").option("--owner <address>", "Owner address (defaults to configured initiator)").option("--from <date>", "Start date (ISO, e.g. 2025-01-01)").option("--to <date>", "End date (ISO)").option("--json", "Output as JSON").action(async (opts) => {
+    const cfg = loadConfig();
+    const owner = opts.owner ?? cfg.initiator;
+    if (!owner) {
+      console.error(c.error("Specify --owner or run `agc login` first"));
+      process.exit(1);
+    }
+    const spinner = spin("Fetching agents\u2026");
+    try {
+      const client = makeClient();
+      const agentsRes = await client.agents.list(owner);
+      const agents = agentsRes?.data ?? [];
+      spinner.stop();
+      if (agents.length === 0) {
+        console.log(c.dim("No agents found"));
+        return;
+      }
+      spin("Fetching usage\u2026");
+      const rows = await Promise.allSettled(
+        agents.map(
+          (a) => client.usage.getAgentUsage(a.agentId, {
+            from: opts.from,
+            to: opts.to
+          }).then((r) => ({
+            agentId: a.agentId,
+            name: a.name || a.agentId.slice(0, 12),
+            ...r?.data ?? r ?? {}
+          }))
+        )
+      );
+      const data = rows.filter((r) => r.status === "fulfilled").map((r) => r.value);
+      if (opts.json) return jsonOut(data);
+      let totalTokens = 0, totalCost = 0, totalCalls = 0;
+      data.forEach((r) => {
+        totalTokens += r.totalTokens ?? 0;
+        totalCost += r.totalCostUsd ?? 0;
+        totalCalls += r.callCount ?? 0;
+      });
+      section("Usage Summary");
+      detail([
+        ["Total tokens", totalTokens.toLocaleString()],
+        ["Total cost", `$${totalCost.toFixed(4)} USD`],
+        ["LLM calls", totalCalls.toLocaleString()]
+      ]);
+      const active = data.filter((r) => (r.totalTokens ?? 0) > 0);
+      if (active.length) {
+        console.log("");
+        table(
+          active.sort((a, b) => (b.totalCostUsd ?? 0) - (a.totalCostUsd ?? 0)).map((r) => ({
+            Agent: r.name,
+            Calls: (r.callCount ?? 0).toLocaleString(),
+            Tokens: (r.totalTokens ?? 0).toLocaleString(),
+            "Cost $": (r.totalCostUsd ?? 0).toFixed(4)
+          })),
+          ["Agent", "Calls", "Tokens", "Cost $"]
+        );
+      }
+    } catch (err) {
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("agent <agentId>").description("Show detailed usage for a specific agent").option("--from <date>", "Start date (ISO)").option("--to <date>", "End date (ISO)").option("--json", "Output as JSON").action(async (agentId, opts) => {
+    const spinner = spin("Fetching usage\u2026");
+    try {
+      const client = makeClient();
+      const res = await client.usage.getAgentUsage(agentId, {
+        from: opts.from,
+        to: opts.to
+      });
+      const data = res?.data ?? res;
+      spinner.stop();
+      if (opts.json) return jsonOut(data);
+      section(`Usage \u2014 ${agentId.slice(0, 12)}\u2026`);
+      detail([
+        ["Calls", (data.callCount ?? 0).toLocaleString()],
+        ["Input tokens", (data.totalInputTokens ?? 0).toLocaleString()],
+        ["Output tokens", (data.totalOutputTokens ?? 0).toLocaleString()],
+        ["Total tokens", (data.totalTokens ?? 0).toLocaleString()],
+        ["Cost", `$${(data.totalCostUsd ?? 0).toFixed(6)} USD`]
+      ]);
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  return cmd;
+}
+
+// src/commands/logs.ts
+var import_commander15 = require("commander");
+var STATUS_COLOR = {
+  success: (s) => c.bold(s),
+  error: (s) => c.error(s),
+  warning: (s) => c.warn(s)
+};
+function colorStatus(status) {
+  return (STATUS_COLOR[status] ?? c.dim)(status);
+}
+function logsCommand() {
+  const cmd = new import_commander15.Command("logs").description("View agent activity logs");
+  cmd.command("list").alias("ls").description("List recent log entries for an agent").option("--agent <agentId>", "Agent ID (defaults to configured agent)").option("--session <sessionId>", "Filter by session ID").option("--status <status>", "Filter: success | error | warning").option("--limit <n>", "Max entries to show", "50").option("--json", "Output as JSON").action(async (opts) => {
+    const cfg = loadConfig();
+    const agentId = opts.agent ?? cfg.defaultAgentId;
+    if (!agentId) {
+      console.error(c.error("Specify --agent <agentId> or set defaultAgentId"));
+      process.exit(1);
+    }
+    const spinner = spin("Fetching logs\u2026");
+    try {
+      const client = makeClient();
+      const qs = new URLSearchParams({ limit: opts.limit });
+      if (opts.session) qs.set("sessionId", opts.session);
+      const res = await client.request("GET", `/v1/logs/agents/${agentId}?${qs}`);
+      let logs = res?.data ?? res ?? [];
+      if (opts.status) logs = logs.filter((l) => l.status === opts.status);
+      spinner.stop();
+      if (opts.json) return jsonOut(logs);
+      section(`Logs \u2014 ${agentId.slice(0, 12)}\u2026 (${logs.length})`);
+      if (logs.length === 0) {
+        console.log(c.dim("  No logs yet"));
+        return;
+      }
+      logs.forEach((l) => {
+        const tools = (l.tools ?? []).length > 0 ? ` ${c.dim(`[${l.tools.length} tools]`)}` : "";
+        const rt = l.responseTime > 0 ? c.dim(` ${l.responseTime}ms`) : "";
+        console.log(
+          `  ${colorStatus((l.status ?? "info").padEnd(7))}  ${c.bold(l.action ?? "")}${rt}${tools}`
+        );
+        if (l.message) {
+          console.log(`  ${" ".repeat(10)}${c.dim(l.message.slice(0, 80))}`);
+        }
+        console.log(`  ${" ".repeat(10)}${c.dim(relativeTime(l.timestamp))}`);
+        console.log("");
+      });
+    } catch (err) {
+      spin("").stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  cmd.command("errors").description("Show only error log entries for an agent").option("--agent <agentId>", "Agent ID").option("--limit <n>", "Max entries", "20").option("--json", "Output as JSON").action(async (opts) => {
+    const cfg = loadConfig();
+    const agentId = opts.agent ?? cfg.defaultAgentId;
+    if (!agentId) {
+      console.error(c.error("Specify --agent <agentId>"));
+      process.exit(1);
+    }
+    const spinner = spin("Fetching error logs\u2026");
+    try {
+      const client = makeClient();
+      const res = await client.request("GET", `/v1/logs/agents/${agentId}?limit=${opts.limit}`);
+      const errors = (res?.data ?? []).filter((l) => l.status === "error");
+      spinner.stop();
+      if (opts.json) return jsonOut(errors);
+      section(`Errors \u2014 ${agentId.slice(0, 12)}\u2026 (${errors.length})`);
+      if (errors.length === 0) {
+        console.log(`${sym.ok} No errors found`);
+        return;
+      }
+      errors.forEach((l) => {
+        console.log(`  ${c.error("\u2716")} ${c.bold(l.action ?? "")}  ${c.dim(relativeTime(l.timestamp))}`);
+        if (l.message) console.log(`    ${c.dim(l.message)}`);
+        console.log("");
+      });
+    } catch (err) {
+      spinner.stop();
+      printError(err);
+      process.exit(1);
+    }
+  });
+  return cmd;
+}
+
 // src/bin.ts
-var program = new import_commander12.Command();
-program.name("agc").description("Agent Commons CLI \u2014 interact with the Agent Commons platform").version("0.1.0", "-v, --version");
+var CONFIG_FILE3 = (0, import_path3.join)((0, import_os3.homedir)(), ".agc", "config.json");
+async function interactiveMenu() {
+  banner();
+  const cfg = loadConfig();
+  const isSetup = !!(cfg.apiKey && cfg.initiator);
+  if (!isSetup) {
+    console.log(c.bold("  Welcome to Agent Commons CLI!"));
+    console.log(c.dim("  Looks like this is your first time here \u2014 let's get you set up.\n"));
+    console.log(`  ${sym.arrow} Running ${c.bold("agc login")} to configure your credentials\u2026
+`);
+    runSubcommand(["login"]);
+    return;
+  }
+  console.log(
+    `  ${c.dim("Connected to")}  ${c.primary(cfg.apiUrl)}  ${c.dim("\xB7")}  ${c.dim("Wallet")} ${c.id(cfg.initiator.slice(0, 8) + "\u2026" + cfg.initiator.slice(-4))}
+`
+  );
+  const action = await select("What would you like to do?", [
+    { label: "Chat with an agent", value: "chat", hint: "agc chat" },
+    { label: "Run an agent (one-shot)", value: "run", hint: "agc run" },
+    { label: "View sessions", value: "sessions", hint: "agc sessions list" },
+    { label: "Manage agents", value: "agents", hint: "agc agents list" },
+    { label: "Tasks", value: "tasks", hint: "agc task list" },
+    { label: "Workflows", value: "workflows", hint: "agc workflow list" },
+    { label: "MCP servers", value: "mcp", hint: "agc mcp list" },
+    { label: "Skills", value: "skills", hint: "agc skills list" },
+    { label: "Wallet & balance", value: "wallet", hint: "agc wallet balance" },
+    { label: "Usage & cost", value: "usage", hint: "agc usage" },
+    { label: "Logs", value: "logs", hint: "agc logs" },
+    { label: "Config & credentials", value: "config", hint: "agc config get" },
+    { label: "Exit", value: "exit" }
+  ]);
+  if (action === "exit") {
+    process.exit(0);
+  }
+  const commandMap = {
+    chat: cfg.defaultAgentId ? ["chat", "--agent", cfg.defaultAgentId] : ["chat", "--agent"],
+    run: cfg.defaultAgentId ? ["run", "--agent", cfg.defaultAgentId, "--message"] : ["run", "--agent"],
+    sessions: ["sessions", "list"],
+    agents: ["agents", "list"],
+    tasks: ["task", "list"],
+    workflows: ["workflow", "list"],
+    mcp: ["mcp", "list"],
+    skills: ["skills", "list"],
+    wallet: ["wallet", "balance"],
+    usage: ["usage"],
+    logs: ["logs"],
+    config: ["config", "get"],
+    exit: []
+  };
+  if ((action === "chat" || action === "run") && !cfg.defaultAgentId) {
+    console.log(
+      `
+  ${c.warn("\u26A0")}  No default agent configured.
+  ${sym.arrow} ${c.dim("Run")} ${c.bold("agc agents list")} ${c.dim("to find an agent ID, then")}
+  ${sym.arrow} ${c.dim("Run")} ${c.bold("agc config set defaultAgentId <id>")} ${c.dim("to set a default.")}
+`
+    );
+    console.log(`  ${c.dim("Or pass it directly:  ")}${c.bold(`agc ${action} --agent <id>`)}
+`);
+    return;
+  }
+  runSubcommand(commandMap[action]);
+}
+function runSubcommand(args) {
+  const child = (0, import_child_process2.spawn)(process.argv[0], [process.argv[1], ...args], {
+    stdio: "inherit"
+  });
+  child.on("exit", (code) => process.exit(code ?? 0));
+}
+var program = new import_commander16.Command();
+program.name("agc").description("Agent Commons CLI \u2014 interact with the Agent Commons platform").version("0.1.4", "-v, --version").action(async () => {
+  await interactiveMenu();
+});
 program.addCommand(loginCommand());
 program.addCommand(logoutCommand());
 program.addCommand(whoamiCommand());
@@ -1958,9 +2683,17 @@ program.addCommand(chatCommand());
 program.addCommand(mcpCommand());
 program.addCommand(skillsCommand());
 program.addCommand(walletCommand());
+program.addCommand(modelsCommand());
+program.addCommand(memoryCommand());
+program.addCommand(usageCommand());
+program.addCommand(logsCommand());
 program.on("command:*", () => {
-  console.error(`Unknown command: ${program.args.join(" ")}
-Run \`agc --help\` to see available commands.`);
+  console.error(
+    `
+  ${c.error("Unknown command:")} ${program.args.join(" ")}
+  Run ${c.bold("agc --help")} to see available commands, or just ${c.bold("agc")} for the interactive menu.
+`
+  );
   process.exit(1);
 });
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-commons/cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Agent Commons CLI — chat, run, and manage agents from your terminal",
   "license": "MIT",
   "bin": {
@@ -14,7 +14,7 @@
     "commander": "^12.1.0",
     "chalk": "^5.3.0",
     "ora": "^8.1.1",
-    "@agent-commons/sdk": "0.1.4"
+    "@agent-commons/sdk": "0.1.6"
   },
   "devDependencies": {
     "tsup": "^8.3.5",