@picahq/cli 1.9.2 → 1.9.3

package/dist/index.js

@@ -5,7 +5,7 @@ import { createRequire } from "module";
 import { Command } from "commander";
 
 // src/commands/init.ts
-import * as p2 from "@clack/prompts";
+import * as p3 from "@clack/prompts";
 import pc3 from "picocolors";
 
 // src/lib/config.ts
@@ -113,11 +113,11 @@ import fs2 from "fs";
 import path2 from "path";
 import os2 from "os";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
-function expandPath(p6) {
-  if (p6.startsWith("~/")) {
-    return path2.join(os2.homedir(), p6.slice(2));
+function expandPath(p7) {
+  if (p7.startsWith("~/")) {
+    return path2.join(os2.homedir(), p7.slice(2));
   }
-  return p6;
+  return p7;
 }
 function getClaudeDesktopConfigPath() {
   switch (process.platform) {
@@ -337,11 +337,11 @@ var PicaApi = class {
     try {
       await this.listConnections();
       return true;
-    } catch (error) {
-      if (error instanceof ApiError && error.status === 401) {
+    } catch (error2) {
+      if (error2 instanceof ApiError && error2.status === 401) {
         return false;
       }
-      throw error;
+      throw error2;
     }
   }
   async listConnections() {
@@ -606,15 +606,52 @@ async function openApiKeyPage() {
 }
 
 // src/commands/config.ts
-import * as p from "@clack/prompts";
+import * as p2 from "@clack/prompts";
 import pc from "picocolors";
+
+// src/lib/output.ts
+import * as p from "@clack/prompts";
+var _agentMode = false;
+function setAgentMode(value) {
+  _agentMode = value;
+}
+function isAgentMode() {
+  return _agentMode || process.env.PICA_AGENT === "1";
+}
+function createSpinner() {
+  if (isAgentMode()) {
+    return { start() {
+    }, stop() {
+    } };
+  }
+  return p.spinner();
+}
+function intro2(msg) {
+  if (!isAgentMode()) p.intro(msg);
+}
+function json(data) {
+  process.stdout.write(JSON.stringify(data) + "\n");
+}
+function error(message, exitCode = 1) {
+  if (isAgentMode()) {
+    json({ error: message });
+  } else {
+    p.cancel(message);
+  }
+  process.exit(exitCode);
+}
+
+// src/commands/config.ts
 async function configCommand() {
+  if (isAgentMode()) {
+    error("This command requires interactive input. Run without --agent.");
+  }
   const config = readConfig();
   if (!config) {
-    p.log.error(`No Pica config found. Run ${pc.cyan("pica init")} first.`);
+    p2.log.error(`No Pica config found. Run ${pc.cyan("pica init")} first.`);
     return;
   }
-  p.intro(pc.bgCyan(pc.black(" Pica Access Control ")));
+  p2.intro(pc.bgCyan(pc.black(" Pica Access Control ")));
   const current = getAccessControl();
   console.log();
   console.log(`  ${pc.bold("Current Access Control")}`);
@@ -624,7 +661,7 @@ async function configCommand() {
   console.log(`  ${pc.dim("Action IDs:")}    ${formatList(current.actionIds)}`);
   console.log(`  ${pc.dim("Knowledge only:")} ${current.knowledgeAgent ? "yes" : "no"}`);
   console.log();
-  const permissions = await p.select({
+  const permissions = await p2.select({
     message: "Permission level",
     options: [
       { value: "admin", label: "Admin", hint: "Full access (GET, POST, PUT, PATCH, DELETE)" },
@@ -633,11 +670,11 @@ async function configCommand() {
     ],
     initialValue: current.permissions ?? "admin"
   });
-  if (p.isCancel(permissions)) {
-    p.outro("No changes made.");
+  if (p2.isCancel(permissions)) {
+    p2.outro("No changes made.");
     return;
   }
-  const connectionMode = await p.select({
+  const connectionMode = await p2.select({
     message: "Connection scope",
     options: [
       { value: "all", label: "All connections" },
@@ -645,23 +682,23 @@ async function configCommand() {
     ],
     initialValue: current.connectionKeys ? "specific" : "all"
   });
-  if (p.isCancel(connectionMode)) {
-    p.outro("No changes made.");
+  if (p2.isCancel(connectionMode)) {
+    p2.outro("No changes made.");
     return;
   }
   let connectionKeys;
   if (connectionMode === "specific") {
     connectionKeys = await selectConnections(config.apiKey);
     if (connectionKeys === void 0) {
-      p.outro("No changes made.");
+      p2.outro("No changes made.");
       return;
     }
     if (connectionKeys.length === 0) {
-      p.log.info(`No connections found. Defaulting to all. Use ${pc.cyan("pica add")} to connect platforms.`);
+      p2.log.info(`No connections found. Defaulting to all. Use ${pc.cyan("pica add")} to connect platforms.`);
       connectionKeys = void 0;
     }
   }
-  const actionMode = await p.select({
+  const actionMode = await p2.select({
     message: "Action scope",
     options: [
       { value: "all", label: "All actions" },
@@ -669,13 +706,13 @@ async function configCommand() {
     ],
     initialValue: current.actionIds ? "specific" : "all"
   });
-  if (p.isCancel(actionMode)) {
-    p.outro("No changes made.");
+  if (p2.isCancel(actionMode)) {
+    p2.outro("No changes made.");
     return;
   }
   let actionIds;
   if (actionMode === "specific") {
-    const actionInput = await p.text({
+    const actionInput = await p2.text({
       message: "Enter action IDs (comma-separated):",
       placeholder: "action-id-1, action-id-2",
       initialValue: current.actionIds?.join(", ") ?? "",
@@ -684,18 +721,18 @@ async function configCommand() {
         return void 0;
       }
     });
-    if (p.isCancel(actionInput)) {
-      p.outro("No changes made.");
+    if (p2.isCancel(actionInput)) {
+      p2.outro("No changes made.");
       return;
     }
     actionIds = actionInput.split(",").map((s) => s.trim()).filter(Boolean);
   }
-  const knowledgeAgent = await p.confirm({
+  const knowledgeAgent = await p2.confirm({
     message: "Enable knowledge-only mode? (disables action execution)",
     initialValue: current.knowledgeAgent ?? false
   });
-  if (p.isCancel(knowledgeAgent)) {
-    p.outro("No changes made.");
+  if (p2.isCancel(knowledgeAgent)) {
+    p2.outro("No changes made.");
     return;
   }
   const settings = {
@@ -719,22 +756,22 @@ async function configCommand() {
     }
   }
   if (reinstalled.length > 0) {
-    p.log.success(`Updated MCP configs: ${reinstalled.join(", ")}`);
+    p2.log.success(`Updated MCP configs: ${reinstalled.join(", ")}`);
   }
-  p.outro("Access control updated.");
+  p2.outro("Access control updated.");
 }
 async function selectConnections(apiKey) {
-  const spinner6 = p.spinner();
-  spinner6.start("Fetching connections...");
+  const spinner5 = p2.spinner();
+  spinner5.start("Fetching connections...");
   let connections;
   try {
     const api = new PicaApi(apiKey);
     const rawConnections = await api.listConnections();
     connections = rawConnections.map((c) => ({ platform: c.platform, key: c.key }));
-    spinner6.stop(`Found ${connections.length} connection(s)`);
+    spinner5.stop(`Found ${connections.length} connection(s)`);
   } catch {
-    spinner6.stop("Could not fetch connections");
-    const manual = await p.text({
+    spinner5.stop("Could not fetch connections");
+    const manual = await p2.text({
       message: "Enter connection keys manually (comma-separated):",
       placeholder: "conn_key_1, conn_key_2",
       validate: (value) => {
@@ -742,13 +779,13 @@ async function selectConnections(apiKey) {
         return void 0;
       }
     });
-    if (p.isCancel(manual)) return void 0;
+    if (p2.isCancel(manual)) return void 0;
     return manual.split(",").map((s) => s.trim()).filter(Boolean);
   }
   if (connections.length === 0) {
     return [];
   }
-  const selected = await p.multiselect({
+  const selected = await p2.multiselect({
     message: "Select connections:",
     options: connections.map((c) => ({
       value: c.key,
@@ -756,7 +793,7 @@ async function selectConnections(apiKey) {
       hint: c.key
     }))
   });
-  if (p.isCancel(selected)) return void 0;
+  if (p2.isCancel(selected)) return void 0;
   return selected;
 }
 function formatList(list) {
@@ -806,9 +843,12 @@ function stripAnsi(str) {
 
 // src/commands/init.ts
 async function initCommand(options) {
+  if (isAgentMode()) {
+    error("This command requires interactive input. Run without --agent.");
+  }
   const existingConfig = readConfig();
   if (existingConfig) {
-    p2.intro(pc3.bgCyan(pc3.black(" Pica ")));
+    p3.intro(pc3.bgCyan(pc3.black(" Pica ")));
     await handleExistingConfig(existingConfig.apiKey, options);
     return;
   }
@@ -880,12 +920,12 @@ async function handleExistingConfig(apiKey, options) {
     value: "start-fresh",
     label: "Start fresh (reconfigure everything)"
   });
-  const action = await p2.select({
+  const action = await p3.select({
     message: "What would you like to do?",
     options: actionOptions
   });
-  if (p2.isCancel(action)) {
-    p2.outro("No changes made.");
+  if (p3.isCancel(action)) {
+    p3.outro("No changes made.");
     return;
   }
   switch (action) {
@@ -907,20 +947,20 @@ async function handleExistingConfig(apiKey, options) {
   }
 }
 async function handleUpdateKey(statuses) {
-  p2.note(`Get your API key at:
+  p3.note(`Get your API key at:
 ${pc3.cyan(getApiKeyUrl())}`, "API Key");
-  const openBrowser = await p2.confirm({
+  const openBrowser = await p3.confirm({
     message: "Open browser to get API key?",
     initialValue: true
   });
-  if (p2.isCancel(openBrowser)) {
-    p2.cancel("Cancelled.");
+  if (p3.isCancel(openBrowser)) {
+    p3.cancel("Cancelled.");
     process.exit(0);
   }
   if (openBrowser) {
     await openApiKeyPage();
   }
-  const newKey = await p2.text({
+  const newKey = await p3.text({
     message: "Enter your new Pica API key:",
     placeholder: "sk_live_...",
     validate: (value) => {
@@ -931,20 +971,20 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
       return void 0;
     }
   });
-  if (p2.isCancel(newKey)) {
-    p2.cancel("Cancelled.");
+  if (p3.isCancel(newKey)) {
+    p3.cancel("Cancelled.");
     process.exit(0);
   }
-  const spinner6 = p2.spinner();
-  spinner6.start("Validating API key...");
+  const spinner5 = p3.spinner();
+  spinner5.start("Validating API key...");
   const api = new PicaApi(newKey);
   const isValid = await api.validateApiKey();
   if (!isValid) {
-    spinner6.stop("Invalid API key");
-    p2.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
+    spinner5.stop("Invalid API key");
+    p3.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
     process.exit(1);
   }
-  spinner6.stop("API key validated");
+  spinner5.stop("API key validated");
   const ac = getAccessControl();
   const reinstalled = [];
   for (const s of statuses) {
@@ -965,107 +1005,107 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
     accessControl: config?.accessControl
   });
   if (reinstalled.length > 0) {
-    p2.log.success(`Updated MCP configs: ${reinstalled.join(", ")}`);
+    p3.log.success(`Updated MCP configs: ${reinstalled.join(", ")}`);
   }
-  p2.outro("API key updated.");
+  p3.outro("API key updated.");
 }
 async function handleInstallMore(apiKey, missing) {
   const ac = getAccessControl();
   if (missing.length === 1) {
     const agent = missing[0].agent;
-    const confirm3 = await p2.confirm({
+    const confirm3 = await p3.confirm({
       message: `Install Pica MCP to ${agent.name}?`,
       initialValue: true
     });
-    if (p2.isCancel(confirm3) || !confirm3) {
-      p2.outro("No changes made.");
+    if (p3.isCancel(confirm3) || !confirm3) {
+      p3.outro("No changes made.");
       return;
     }
     installMcpConfig(agent, apiKey, "global", ac);
     updateConfigAgents(agent.id);
-    p2.log.success(`${agent.name}: MCP installed`);
-    p2.outro("Done.");
+    p3.log.success(`${agent.name}: MCP installed`);
+    p3.outro("Done.");
     return;
   }
-  const selected = await p2.multiselect({
+  const selected = await p3.multiselect({
     message: "Select agents to install MCP:",
     options: missing.map((s) => ({
       value: s.agent.id,
       label: s.agent.name
     }))
   });
-  if (p2.isCancel(selected)) {
-    p2.outro("No changes made.");
+  if (p3.isCancel(selected)) {
+    p3.outro("No changes made.");
     return;
   }
   const agents = missing.filter((s) => selected.includes(s.agent.id));
   for (const s of agents) {
     installMcpConfig(s.agent, apiKey, "global", ac);
     updateConfigAgents(s.agent.id);
-    p2.log.success(`${s.agent.name}: MCP installed`);
+    p3.log.success(`${s.agent.name}: MCP installed`);
   }
-  p2.outro("Done.");
+  p3.outro("Done.");
 }
 async function handleInstallProject(apiKey, missing) {
   const ac = getAccessControl();
   if (missing.length === 1) {
     const agent = missing[0].agent;
-    const confirm3 = await p2.confirm({
+    const confirm3 = await p3.confirm({
       message: `Install project-level MCP for ${agent.name}?`,
       initialValue: true
     });
-    if (p2.isCancel(confirm3) || !confirm3) {
-      p2.outro("No changes made.");
+    if (p3.isCancel(confirm3) || !confirm3) {
+      p3.outro("No changes made.");
       return;
     }
     installMcpConfig(agent, apiKey, "project", ac);
     const configPath = getAgentConfigPath(agent, "project");
-    p2.log.success(`${agent.name}: ${configPath} created`);
-    p2.note(
+    p3.log.success(`${agent.name}: ${configPath} created`);
+    p3.note(
       pc3.yellow("Project config files can be committed to share with your team.\n") + pc3.yellow("Team members will need their own API key."),
       "Tip"
     );
-    p2.outro("Done.");
+    p3.outro("Done.");
     return;
   }
-  const selected = await p2.multiselect({
+  const selected = await p3.multiselect({
     message: "Select agents for project-level MCP:",
     options: missing.map((s) => ({
       value: s.agent.id,
       label: s.agent.name
     }))
   });
-  if (p2.isCancel(selected)) {
-    p2.outro("No changes made.");
+  if (p3.isCancel(selected)) {
+    p3.outro("No changes made.");
     return;
   }
   const agents = missing.filter((s) => selected.includes(s.agent.id));
   for (const s of agents) {
     installMcpConfig(s.agent, apiKey, "project", ac);
     const configPath = getAgentConfigPath(s.agent, "project");
-    p2.log.success(`${s.agent.name}: ${configPath} created`);
+    p3.log.success(`${s.agent.name}: ${configPath} created`);
   }
-  p2.note(
+  p3.note(
     pc3.yellow("Project config files can be committed to share with your team.\n") + pc3.yellow("Team members will need their own API key."),
     "Tip"
   );
-  p2.outro("Done.");
+  p3.outro("Done.");
 }
 async function freshSetup(options) {
-  p2.note(`Get your API key at:
+  p3.note(`Get your API key at:
 ${pc3.cyan(getApiKeyUrl())}`, "API Key");
-  const openBrowser = await p2.confirm({
+  const openBrowser = await p3.confirm({
     message: "Open browser to get API key?",
     initialValue: true
   });
-  if (p2.isCancel(openBrowser)) {
-    p2.cancel("Setup cancelled.");
+  if (p3.isCancel(openBrowser)) {
+    p3.cancel("Setup cancelled.");
     process.exit(0);
   }
   if (openBrowser) {
     await openApiKeyPage();
   }
-  const apiKey = await p2.text({
+  const apiKey = await p3.text({
     message: "Enter your Pica API key:",
     placeholder: "sk_live_...",
     validate: (value) => {
@@ -1076,27 +1116,27 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
       return void 0;
     }
   });
-  if (p2.isCancel(apiKey)) {
-    p2.cancel("Setup cancelled.");
+  if (p3.isCancel(apiKey)) {
+    p3.cancel("Setup cancelled.");
     process.exit(0);
   }
-  const spinner6 = p2.spinner();
-  spinner6.start("Validating API key...");
+  const spinner5 = p3.spinner();
+  spinner5.start("Validating API key...");
   const api = new PicaApi(apiKey);
   const isValid = await api.validateApiKey();
   if (!isValid) {
-    spinner6.stop("Invalid API key");
-    p2.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
+    spinner5.stop("Invalid API key");
+    p3.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
     process.exit(1);
   }
-  spinner6.stop("API key validated");
+  spinner5.stop("API key validated");
   writeConfig({
     apiKey,
     installedAgents: [],
     createdAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   const allAgents = getAllAgents();
-  const agentChoice = await p2.select({
+  const agentChoice = await p3.select({
     message: "Where do you want to install the MCP?",
     options: [
       {
@@ -1110,8 +1150,8 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
       }))
     ]
   });
-  if (p2.isCancel(agentChoice)) {
-    p2.cancel("Setup cancelled.");
+  if (p3.isCancel(agentChoice)) {
+    p3.cancel("Setup cancelled.");
     process.exit(0);
   }
   const selectedAgents = agentChoice === "all" ? allAgents : allAgents.filter((a) => a.id === agentChoice);
@@ -1122,7 +1162,7 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
   } else if (options.project) {
     scope = "project";
   } else if (hasProjectScopeAgent) {
-    const scopeChoice = await p2.select({
+    const scopeChoice = await p3.select({
       message: "How do you want to install it?",
       options: [
         {
@@ -1137,8 +1177,8 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
         }
       ]
     });
-    if (p2.isCancel(scopeChoice)) {
-      p2.cancel("Setup cancelled.");
+    if (p3.isCancel(scopeChoice)) {
+      p3.cancel("Setup cancelled.");
       process.exit(0);
     }
     scope = scopeChoice;
@@ -1148,12 +1188,12 @@ ${pc3.cyan(getApiKeyUrl())}`, "API Key");
     const nonProjectAgents = selectedAgents.filter((a) => !supportsProjectScope(a));
     if (projectAgents.length === 0) {
       const supported = allAgents.filter((a) => supportsProjectScope(a)).map((a) => a.name).join(", ");
-      p2.note(
+      p3.note(
         `${selectedAgents.map((a) => a.name).join(", ")} does not support project-level MCP.
 Project scope is supported by: ${supported}`,
         "Not Supported"
       );
-      p2.cancel("Run again and choose global scope or a different agent.");
+      p3.cancel("Run again and choose global scope or a different agent.");
       process.exit(1);
     }
     for (const agent of projectAgents) {
@@ -1161,15 +1201,15 @@ Project scope is supported by: ${supported}`,
       installMcpConfig(agent, apiKey, "project");
       const configPath = getAgentConfigPath(agent, "project");
       const status = wasInstalled ? "updated" : "created";
-      p2.log.success(`${agent.name}: ${configPath} ${status}`);
+      p3.log.success(`${agent.name}: ${configPath} ${status}`);
     }
     if (nonProjectAgents.length > 0) {
-      p2.log.info(`Installing globally for agents without project scope support:`);
+      p3.log.info(`Installing globally for agents without project scope support:`);
       for (const agent of nonProjectAgents) {
         const wasInstalled = isMcpInstalled(agent, "global");
         installMcpConfig(agent, apiKey, "global");
         const status = wasInstalled ? "updated" : "installed";
-        p2.log.success(`${agent.name}: MCP ${status} (global)`);
+        p3.log.success(`${agent.name}: MCP ${status} (global)`);
       }
     }
     const allInstalled = [...projectAgents, ...nonProjectAgents];
@@ -1192,9 +1232,9 @@ ${globalPaths}
 `;
     }
     summary += pc3.yellow("Note: Project config files can be committed to share with your team.\n") + pc3.yellow("Team members will need their own API key.");
-    p2.note(summary, "Setup Complete");
+    p3.note(summary, "Setup Complete");
     await promptConnectIntegrations(apiKey);
-    p2.outro("Your AI agents now have access to Pica integrations!");
+    p3.outro("Your AI agents now have access to Pica integrations!");
     return;
   }
   const installedAgentIds = [];
@@ -1203,19 +1243,19 @@ ${globalPaths}
     installMcpConfig(agent, apiKey, "global");
     installedAgentIds.push(agent.id);
     const status = wasInstalled ? "updated" : "installed";
-    p2.log.success(`${agent.name}: MCP ${status}`);
+    p3.log.success(`${agent.name}: MCP ${status}`);
   }
   writeConfig({
     apiKey,
     installedAgents: installedAgentIds,
     createdAt: (/* @__PURE__ */ new Date()).toISOString()
   });
-  p2.note(
+  p3.note(
     `Config saved to: ${pc3.dim(getConfigPath())}`,
     "Setup Complete"
   );
   await promptConnectIntegrations(apiKey);
-  p2.outro("Your AI agents now have access to Pica integrations!");
+  p3.outro("Your AI agents now have access to Pica integrations!");
 }
 function printBanner() {
   console.log();
@@ -1264,48 +1304,48 @@ async function promptConnectIntegrations(apiKey) {
       { value: "skip", label: "Skip for now", hint: "you can always run pica add later" }
     ];
     const message = first ? "Connect your first integration?" : "Connect another?";
-    const choice = await p2.select({ message, options });
-    if (p2.isCancel(choice) || choice === "skip") {
+    const choice = await p3.select({ message, options });
+    if (p3.isCancel(choice) || choice === "skip") {
       break;
     }
     if (choice === "more") {
       try {
         await open2("https://app.picaos.com/connections");
-        p2.log.info("Opened Pica dashboard in browser.");
+        p3.log.info("Opened Pica dashboard in browser.");
       } catch {
-        p2.note("https://app.picaos.com/connections", "Open in browser");
+        p3.note("https://app.picaos.com/connections", "Open in browser");
       }
-      p2.log.info(`Connect from the dashboard, or use ${pc3.cyan("pica add <platform>")}`);
+      p3.log.info(`Connect from the dashboard, or use ${pc3.cyan("pica add <platform>")}`);
       break;
     }
     const platform = choice;
     const integration = TOP_INTEGRATIONS.find((i) => i.value === platform);
     const label = integration?.label ?? platform;
-    p2.log.info(`Opening browser to connect ${pc3.cyan(label)}...`);
+    p3.log.info(`Opening browser to connect ${pc3.cyan(label)}...`);
     try {
       await openConnectionPage(platform);
     } catch {
       const url = getConnectionUrl(platform);
-      p2.log.warn("Could not open browser automatically.");
-      p2.note(url, "Open manually");
+      p3.log.warn("Could not open browser automatically.");
+      p3.note(url, "Open manually");
     }
-    const spinner6 = p2.spinner();
-    spinner6.start("Waiting for connection... (complete auth in browser)");
+    const spinner5 = p3.spinner();
+    spinner5.start("Waiting for connection... (complete auth in browser)");
     try {
       await api.waitForConnection(platform, 5 * 60 * 1e3, 5e3);
-      spinner6.stop(`${label} connected!`);
-      p2.log.success(`${pc3.green("\u2713")} ${label} is now available to your AI agents`);
+      spinner5.stop(`${label} connected!`);
+      p3.log.success(`${pc3.green("\u2713")} ${label} is now available to your AI agents`);
       connected.push(platform);
       first = false;
-    } catch (error) {
-      spinner6.stop("Connection timed out");
-      if (error instanceof TimeoutError) {
-        p2.log.warn(`No worries. Connect later with: ${pc3.cyan(`pica add ${platform}`)}`);
+    } catch (error2) {
+      spinner5.stop("Connection timed out");
+      if (error2 instanceof TimeoutError) {
+        p3.log.warn(`No worries. Connect later with: ${pc3.cyan(`pica add ${platform}`)}`);
       }
       first = false;
     }
     if (TOP_INTEGRATIONS.every((i) => connected.includes(i.value))) {
-      p2.log.success("All top integrations connected!");
+      p3.log.success("All top integrations connected!");
       break;
     }
   }
@@ -1324,23 +1364,23 @@ function updateConfigAgents(agentId) {
 }
 
 // src/commands/connection.ts
-import * as p3 from "@clack/prompts";
+import * as p4 from "@clack/prompts";
 import pc4 from "picocolors";
 
 // src/lib/platforms.ts
 function findPlatform(platforms, query) {
   const normalizedQuery = query.toLowerCase().trim();
   const exact = platforms.find(
-    (p6) => p6.platform.toLowerCase() === normalizedQuery || p6.name.toLowerCase() === normalizedQuery
+    (p7) => p7.platform.toLowerCase() === normalizedQuery || p7.name.toLowerCase() === normalizedQuery
   );
   if (exact) return exact;
   return null;
 }
 function findSimilarPlatforms(platforms, query, limit = 3) {
   const normalizedQuery = query.toLowerCase().trim();
-  const scored = platforms.map((p6) => {
-    const name = p6.name.toLowerCase();
-    const slug = p6.platform.toLowerCase();
+  const scored = platforms.map((p7) => {
+    const name = p7.name.toLowerCase();
+    const slug = p7.platform.toLowerCase();
     let score = 0;
     if (name.includes(normalizedQuery) || slug.includes(normalizedQuery)) {
       score = 10;
@@ -1349,7 +1389,7 @@ function findSimilarPlatforms(platforms, query, limit = 3) {
     } else {
       score = countMatchingChars(normalizedQuery, slug);
     }
-    return { platform: p6, score };
+    return { platform: p7, score };
   }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score).slice(0, limit);
   return scored.map((item) => item.platform);
 }
@@ -1364,22 +1404,25 @@ function countMatchingChars(a, b) {
 
 // src/commands/connection.ts
 async function connectionAddCommand(platformArg) {
-  p3.intro(pc4.bgCyan(pc4.black(" Pica ")));
+  if (isAgentMode()) {
+    error("This command requires interactive input. Run without --agent.");
+  }
+  p4.intro(pc4.bgCyan(pc4.black(" Pica ")));
   const apiKey = getApiKey();
   if (!apiKey) {
-    p3.cancel("Not configured. Run `pica init` first.");
+    p4.cancel("Not configured. Run `pica init` first.");
     process.exit(1);
   }
   const api = new PicaApi(apiKey);
-  const spinner6 = p3.spinner();
-  spinner6.start("Loading platforms...");
+  const spinner5 = p4.spinner();
+  spinner5.start("Loading platforms...");
   let platforms;
   try {
     platforms = await api.listPlatforms();
-    spinner6.stop(`${platforms.length} platforms available`);
-  } catch (error) {
-    spinner6.stop("Failed to load platforms");
-    p3.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+    spinner5.stop(`${platforms.length} platforms available`);
+  } catch (error2) {
+    spinner5.stop("Failed to load platforms");
+    p4.cancel(`Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`);
     process.exit(1);
   }
   let platform;
@@ -1390,29 +1433,29 @@ async function connectionAddCommand(platformArg) {
     } else {
       const similar = findSimilarPlatforms(platforms, platformArg);
       if (similar.length > 0) {
-        p3.log.warn(`Unknown platform: ${platformArg}`);
-        const suggestion = await p3.select({
+        p4.log.warn(`Unknown platform: ${platformArg}`);
+        const suggestion = await p4.select({
           message: "Did you mean:",
           options: [
             ...similar.map((s) => ({ value: s.platform, label: `${s.name} (${s.platform})` })),
             { value: "__other__", label: "None of these" }
           ]
         });
-        if (p3.isCancel(suggestion) || suggestion === "__other__") {
-          p3.note(`Run ${pc4.cyan("pica platforms")} to see all available platforms.`);
-          p3.cancel("Connection cancelled.");
+        if (p4.isCancel(suggestion) || suggestion === "__other__") {
+          p4.note(`Run ${pc4.cyan("pica platforms")} to see all available platforms.`);
+          p4.cancel("Connection cancelled.");
           process.exit(0);
         }
         platform = suggestion;
       } else {
-        p3.cancel(`Unknown platform: ${platformArg}
+        p4.cancel(`Unknown platform: ${platformArg}
 
 Run ${pc4.cyan("pica platforms")} to see available platforms.`);
         process.exit(1);
       }
     }
   } else {
-    const platformInput = await p3.text({
+    const platformInput = await p4.text({
       message: "Which platform do you want to connect?",
       placeholder: "gmail, slack, hubspot...",
       validate: (value) => {
@@ -1420,41 +1463,41 @@ Run ${pc4.cyan("pica platforms")} to see available platforms.`);
         return void 0;
       }
     });
-    if (p3.isCancel(platformInput)) {
-      p3.cancel("Connection cancelled.");
+    if (p4.isCancel(platformInput)) {
+      p4.cancel("Connection cancelled.");
       process.exit(0);
     }
     const found = findPlatform(platforms, platformInput);
     if (found) {
       platform = found.platform;
     } else {
-      p3.cancel(`Unknown platform: ${platformInput}
+      p4.cancel(`Unknown platform: ${platformInput}
 
 Run ${pc4.cyan("pica platforms")} to see available platforms.`);
       process.exit(1);
     }
   }
   const url = getConnectionUrl(platform);
-  p3.log.info(`Opening browser to connect ${pc4.cyan(platform)}...`);
-  p3.note(pc4.dim(url), "URL");
+  p4.log.info(`Opening browser to connect ${pc4.cyan(platform)}...`);
+  p4.note(pc4.dim(url), "URL");
   try {
     await openConnectionPage(platform);
   } catch {
-    p3.log.warn("Could not open browser automatically.");
-    p3.note(`Open this URL manually:
+    p4.log.warn("Could not open browser automatically.");
+    p4.note(`Open this URL manually:
 ${url}`);
   }
-  const pollSpinner = p3.spinner();
+  const pollSpinner = p4.spinner();
   pollSpinner.start("Waiting for connection... (complete auth in browser)");
   try {
     const connection2 = await api.waitForConnection(platform, 5 * 60 * 1e3, 5e3);
     pollSpinner.stop(`${platform} connected!`);
-    p3.log.success(`${pc4.green("\u2713")} ${connection2.platform} is now available to your AI agents.`);
-    p3.outro("Connection complete!");
-  } catch (error) {
+    p4.log.success(`${pc4.green("\u2713")} ${connection2.platform} is now available to your AI agents.`);
+    p4.outro("Connection complete!");
+  } catch (error2) {
     pollSpinner.stop("Connection timed out");
-    if (error instanceof TimeoutError) {
-      p3.note(
+    if (error2 instanceof TimeoutError) {
+      p4.note(
         `Possible issues:
   - OAuth flow was not completed in the browser
   - Browser popup was blocked
@@ -1464,7 +1507,7 @@ Try again with: ${pc4.cyan(`pica connection add ${platform}`)}`,
         "Timed Out"
       );
     } else {
-      p3.log.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      p4.log.error(`Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`);
     }
     process.exit(1);
   }
@@ -1472,17 +1515,26 @@ Try again with: ${pc4.cyan(`pica connection add ${platform}`)}`,
 async function connectionListCommand() {
   const apiKey = getApiKey();
   if (!apiKey) {
-    p3.cancel("Not configured. Run `pica init` first.");
-    process.exit(1);
+    error("Not configured. Run `pica init` first.");
   }
   const api = new PicaApi(apiKey);
-  const spinner6 = p3.spinner();
-  spinner6.start("Loading connections...");
+  const spinner5 = createSpinner();
+  spinner5.start("Loading connections...");
   try {
     const connections = await api.listConnections();
-    spinner6.stop(`${connections.length} connection${connections.length === 1 ? "" : "s"} found`);
+    if (isAgentMode()) {
+      json({
+        connections: connections.map((conn) => ({
+          platform: conn.platform,
+          state: conn.state,
+          key: conn.key
+        }))
+      });
+      return;
+    }
+    spinner5.stop(`${connections.length} connection${connections.length === 1 ? "" : "s"} found`);
     if (connections.length === 0) {
-      p3.note(
+      p4.note(
         `No connections yet.
 
 Add one with: ${pc4.cyan("pica connection add gmail")}`,
@@ -1507,11 +1559,10 @@ Add one with: ${pc4.cyan("pica connection add gmail")}`,
       rows
     );
     console.log();
-    p3.note(`Add more with: ${pc4.cyan("pica connection add <platform>")}`, "Tip");
-  } catch (error) {
-    spinner6.stop("Failed to load connections");
-    p3.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-    process.exit(1);
+    p4.note(`Add more with: ${pc4.cyan("pica connection add <platform>")}`, "Tip");
+  } catch (error2) {
+    spinner5.stop("Failed to load connections");
+    error(`Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`);
   }
 }
 function getStatusIndicator(state) {
@@ -1528,22 +1579,28 @@ function getStatusIndicator(state) {
 }
 
 // src/commands/platforms.ts
-import * as p4 from "@clack/prompts";
+import * as p5 from "@clack/prompts";
 import pc5 from "picocolors";
 async function platformsCommand(options) {
   const apiKey = getApiKey();
   if (!apiKey) {
-    p4.cancel("Not configured. Run `pica init` first.");
-    process.exit(1);
+    error("Not configured. Run `pica init` first.");
+  }
+  if (isAgentMode()) {
+    options.json = true;
   }
   const api = new PicaApi(apiKey);
-  const spinner6 = p4.spinner();
-  spinner6.start("Loading platforms...");
+  const spinner5 = createSpinner();
+  spinner5.start("Loading platforms...");
   try {
     const platforms = await api.listPlatforms();
-    spinner6.stop(`${platforms.length} platforms available`);
+    spinner5.stop(`${platforms.length} platforms available`);
     if (options.json) {
-      console.log(JSON.stringify(platforms, null, 2));
+      if (isAgentMode()) {
+        json({ platforms });
+      } else {
+        console.log(JSON.stringify(platforms, null, 2));
+      }
       return;
     }
     const byCategory = /* @__PURE__ */ new Map();
@@ -1559,7 +1616,7 @@ async function platformsCommand(options) {
       const categoryPlatforms = byCategory.get(options.category);
       if (!categoryPlatforms) {
         const categories = [...byCategory.keys()].sort();
-        p4.note(`Available categories:
+        p5.note(`Available categories:
   ${categories.join(", ")}`, "Unknown Category");
         process.exit(1);
       }
@@ -1591,22 +1648,20 @@ async function platformsCommand(options) {
       );
     }
     console.log();
-    p4.note(`Connect with: ${pc5.cyan("pica connection add <platform>")}`, "Tip");
-  } catch (error) {
-    spinner6.stop("Failed to load platforms");
-    p4.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-    process.exit(1);
+    p5.note(`Connect with: ${pc5.cyan("pica connection add <platform>")}`, "Tip");
+  } catch (error2) {
+    spinner5.stop("Failed to load platforms");
+    error(`Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`);
   }
 }
 
 // src/commands/actions.ts
-import * as p5 from "@clack/prompts";
+import * as p6 from "@clack/prompts";
 import pc6 from "picocolors";
 function getConfig() {
   const apiKey = getApiKey();
   if (!apiKey) {
-    p5.cancel("Not configured. Run `pica init` first.");
-    process.exit(1);
+    error("Not configured. Run `pica init` first.");
   }
   const ac = getAccessControlFromAllSources();
   const permissions = ac.permissions || "admin";
@@ -1615,12 +1670,19 @@ function getConfig() {
   const knowledgeAgent = ac.knowledgeAgent || false;
   return { apiKey, permissions, connectionKeys, actionIds, knowledgeAgent };
 }
+function parseJsonArg(value, argName) {
+  try {
+    return JSON.parse(value);
+  } catch {
+    error(`Invalid JSON for ${argName}: ${value}`);
+  }
+}
 async function actionsSearchCommand(platform, query, options) {
-  p5.intro(pc6.bgCyan(pc6.black(" Pica ")));
+  intro2(pc6.bgCyan(pc6.black(" Pica ")));
   const { apiKey, permissions, actionIds, knowledgeAgent } = getConfig();
   const api = new PicaApi(apiKey);
-  const spinner6 = p5.spinner();
-  spinner6.start(`Searching actions on ${pc6.cyan(platform)} for "${query}"...`);
+  const spinner5 = createSpinner();
+  spinner5.start(`Searching actions on ${pc6.cyan(platform)} for "${query}"...`);
   try {
     const agentType = knowledgeAgent ? "knowledge" : options.type;
     let actions2 = await api.searchActions(platform, query, agentType);
@@ -1632,9 +1694,13 @@ async function actionsSearchCommand(platform, query, options) {
       method: action.method,
       path: action.path
     }));
+    if (isAgentMode()) {
+      json({ actions: cleanedActions });
+      return;
+    }
     if (cleanedActions.length === 0) {
-      spinner6.stop("No actions found");
-      p5.note(
+      spinner5.stop("No actions found");
+      p6.note(
         `No actions found for platform '${platform}' matching query '${query}'.
 
 Suggestions:
@@ -1651,7 +1717,7 @@ Examples of good queries:
       );
       return;
     }
-    spinner6.stop(
+    spinner5.stop(
       `Found ${cleanedActions.length} action(s) for '${platform}' matching '${query}'`
     );
     console.log();
@@ -1671,49 +1737,45 @@ Examples of good queries:
       rows
     );
     console.log();
-    p5.note(
+    p6.note(
       `Get details: ${pc6.cyan(`pica actions knowledge ${platform} <actionId>`)}
 Execute:     ${pc6.cyan(`pica actions execute ${platform} <actionId> <connectionKey>`)}`,
       "Next Steps"
     );
-  } catch (error) {
-    spinner6.stop("Search failed");
-    p5.cancel(
-      `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+  } catch (error2) {
+    spinner5.stop("Search failed");
+    error(
+      `Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`
     );
-    process.exit(1);
   }
 }
 async function actionsKnowledgeCommand(platform, actionId) {
-  p5.intro(pc6.bgCyan(pc6.black(" Pica ")));
+  intro2(pc6.bgCyan(pc6.black(" Pica ")));
   const { apiKey, actionIds, connectionKeys } = getConfig();
   const api = new PicaApi(apiKey);
   if (!isActionAllowed(actionId, actionIds)) {
-    p5.cancel(`Action "${actionId}" is not in the allowed action list.`);
-    process.exit(1);
+    error(`Action "${actionId}" is not in the allowed action list.`);
   }
   if (!connectionKeys.includes("*")) {
-    const spinner7 = p5.spinner();
-    spinner7.start("Checking connections...");
+    const spinner6 = createSpinner();
+    spinner6.start("Checking connections...");
     try {
       const connections = await api.listConnections();
       const connectedPlatforms = connections.map((c) => c.platform);
       if (!connectedPlatforms.includes(platform)) {
-        spinner7.stop("Platform not connected");
-        p5.cancel(`Platform "${platform}" has no allowed connections.`);
-        process.exit(1);
+        spinner6.stop("Platform not connected");
+        error(`Platform "${platform}" has no allowed connections.`);
       }
-      spinner7.stop("Connection verified");
-    } catch (error) {
-      spinner7.stop("Failed to check connections");
-      p5.cancel(
-        `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+      spinner6.stop("Connection verified");
+    } catch (error2) {
+      spinner6.stop("Failed to check connections");
+      error(
+        `Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`
       );
-      process.exit(1);
     }
   }
-  const spinner6 = p5.spinner();
-  spinner6.start(`Loading knowledge for action ${pc6.dim(actionId)}...`);
+  const spinner5 = createSpinner();
+  spinner5.start(`Loading knowledge for action ${pc6.dim(actionId)}...`);
   try {
     const { knowledge, method } = await api.getActionKnowledge(actionId);
     const knowledgeWithGuidance = buildActionKnowledgeWithGuidance(
@@ -1722,58 +1784,56 @@ async function actionsKnowledgeCommand(platform, actionId) {
       platform,
       actionId
     );
-    spinner6.stop("Knowledge loaded");
+    if (isAgentMode()) {
+      json({ knowledge: knowledgeWithGuidance, method });
+      return;
+    }
+    spinner5.stop("Knowledge loaded");
     console.log();
     console.log(knowledgeWithGuidance);
     console.log();
-    p5.note(
+    p6.note(
       `Execute: ${pc6.cyan(`pica actions execute ${platform} ${actionId} <connectionKey>`)}`,
       "Next Step"
     );
-  } catch (error) {
-    spinner6.stop("Failed to load knowledge");
-    p5.cancel(
-      `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+  } catch (error2) {
+    spinner5.stop("Failed to load knowledge");
+    error(
+      `Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`
     );
-    process.exit(1);
   }
 }
 async function actionsExecuteCommand(platform, actionId, connectionKey, options) {
-  p5.intro(pc6.bgCyan(pc6.black(" Pica ")));
+  intro2(pc6.bgCyan(pc6.black(" Pica ")));
   const { apiKey, permissions, actionIds, connectionKeys, knowledgeAgent } = getConfig();
   if (knowledgeAgent) {
-    p5.cancel(
-      `Action execution is disabled (knowledge-only mode).
-Configure with: ${pc6.cyan("pica config")}`
+    error(
+      "Action execution is disabled (knowledge-only mode)."
     );
-    process.exit(1);
   }
   if (!isActionAllowed(actionId, actionIds)) {
-    p5.cancel(`Action "${actionId}" is not in the allowed action list.`);
-    process.exit(1);
+    error(`Action "${actionId}" is not in the allowed action list.`);
   }
   if (!connectionKeys.includes("*") && !connectionKeys.includes(connectionKey)) {
-    p5.cancel(`Connection key "${connectionKey}" is not allowed.`);
-    process.exit(1);
+    error(`Connection key "${connectionKey}" is not allowed.`);
   }
   const api = new PicaApi(apiKey);
-  const spinner6 = p5.spinner();
-  spinner6.start("Loading action details...");
+  const spinner5 = createSpinner();
+  spinner5.start("Loading action details...");
   try {
     const actionDetails = await api.getActionDetails(actionId);
     if (!isMethodAllowed(actionDetails.method, permissions)) {
-      spinner6.stop("Permission denied");
-      p5.cancel(
+      spinner5.stop("Permission denied");
+      error(
         `Method "${actionDetails.method}" is not allowed under "${permissions}" permission level.`
       );
-      process.exit(1);
     }
-    spinner6.stop(`Action: ${actionDetails.title} [${actionDetails.method}]`);
+    spinner5.stop(`Action: ${actionDetails.title} [${actionDetails.method}]`);
     const data = options.data ? parseJsonArg(options.data, "--data") : void 0;
     const pathVariables = options.pathVars ? parseJsonArg(options.pathVars, "--path-vars") : void 0;
     const queryParams = options.queryParams ? parseJsonArg(options.queryParams, "--query-params") : void 0;
     const headers = options.headers ? parseJsonArg(options.headers, "--headers") : void 0;
-    const execSpinner = p5.spinner();
+    const execSpinner = createSpinner();
     execSpinner.start("Executing action...");
     const result = await api.executePassthroughRequest(
       {
@@ -1790,6 +1850,16 @@ Configure with: ${pc6.cyan("pica config")}`
       actionDetails
     );
     execSpinner.stop("Action executed successfully");
+    if (isAgentMode()) {
+      json({
+        request: {
+          method: result.requestConfig.method,
+          url: result.requestConfig.url
+        },
+        response: result.responseData
+      });
+      return;
+    }
     console.log();
     console.log(pc6.dim("Request:"));
     console.log(
@@ -1800,20 +1870,11 @@ Configure with: ${pc6.cyan("pica config")}`
     console.log();
     console.log(pc6.bold("Response:"));
     console.log(JSON.stringify(result.responseData, null, 2));
-  } catch (error) {
-    spinner6.stop("Execution failed");
-    p5.cancel(
-      `Error: ${error instanceof Error ? error.message : "Unknown error"}`
+  } catch (error2) {
+    spinner5.stop("Execution failed");
+    error(
+      `Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`
     );
-    process.exit(1);
-  }
-}
-function parseJsonArg(value, argName) {
-  try {
-    return JSON.parse(value);
-  } catch {
-    p5.cancel(`Invalid JSON for ${argName}: ${value}`);
-    process.exit(1);
   }
 }
 function colorMethod(method) {
@@ -1837,7 +1898,7 @@ function colorMethod(method) {
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var program = new Command();
-program.name("pica").description(`Pica CLI \u2014 Connect AI agents to 200+ platforms through one interface.
+program.name("pica").option("--agent", "Machine-readable JSON output (no colors, spinners, or prompts)").description(`Pica CLI \u2014 Connect AI agents to 200+ platforms through one interface.
 
   Setup:
     pica init                              Set up API key and install MCP server
@@ -1865,6 +1926,12 @@ program.name("pica").description(`Pica CLI \u2014 Connect AI agents to 200+ plat
 
   Platform names are always kebab-case (e.g. hub-spot, ship-station, google-calendar).
   Run 'pica platforms' to browse all 200+ available platforms.`).version(version);
+program.hook("preAction", (thisCommand) => {
+  const opts = program.opts();
+  if (opts.agent) {
+    setAgentMode(true);
+  }
+});
 program.command("init").description("Set up Pica and install MCP to your AI agents").option("-y, --yes", "Skip confirmations").option("-g, --global", "Install MCP globally (available in all projects)").option("-p, --project", "Install MCP for this project only (creates .mcp.json)").action(async (options) => {
   await initCommand(options);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picahq/cli",
-  "version": "1.9.2",
+  "version": "1.9.3",
   "description": "CLI for managing Pica",
   "type": "module",
   "files": [