@picahq/cli 1.3.0 → 1.5.0

package/README.md

@@ -96,45 +96,6 @@ pica platforms
 pica platforms -c "CRM"
 ```
 
-### Search actions
-
-Find available API actions on any connected platform:
-
-```bash
-pica search gmail "send email"
-pica search slack "post message"
-pica search stripe "list payments"
-```
-
-```
-  POST    /gmail/v1/users/{{userId}}/messages/send
-         Send Message
-         conn_mod_def::ABC123::XYZ789
-```
-
-### Read API docs
-
-```bash
-pica actions knowledge <actionId>
-pica actions k <actionId> --full    # no truncation
-```
-
-Shows method, path, path variables, parameter schemas, and request/response examples.
-
-### Execute an action
-
-```bash
-pica exec <actionId> \
-  -c live::gmail::default::abc123 \
-  -d '{"to": "test@example.com", "subject": "Hello", "body": "Hi there"}' \
-  -p userId=me
-```
-
-If you omit flags, the CLI prompts interactively:
-- Auto-selects the connection if only one exists for the platform
-- Prompts for each `{{path variable}}` not provided via `-p`
-- Prompts for the request body on POST/PUT/PATCH if `-d` is missing
-
 ## Commands
 
 | Command | Description |
@@ -143,9 +104,6 @@ If you omit flags, the CLI prompts interactively:
 | `pica add <platform>` | Connect a platform via OAuth |
 | `pica list` | List connections with keys |
 | `pica platforms` | Browse available platforms |
-| `pica search <platform> [query]` | Search for actions |
-| `pica actions knowledge <id>` | Get API docs for an action |
-| `pica exec <id>` | Execute an action |
 
 Every command supports `--json` for machine-readable output.
 
@@ -155,9 +113,6 @@ Every command supports `--json` for machine-readable output.
 |-------|------|
 | `pica ls` | `pica list` |
 | `pica p` | `pica platforms` |
-| `pica a search` | `pica actions search` |
-| `pica a k` | `pica actions knowledge` |
-| `pica a x` | `pica actions execute` |
 
 ## How it works
 
@@ -193,11 +148,9 @@ src/
     init.ts             # pica init (setup, status display, targeted actions)
     connection.ts       # pica add, pica list
     platforms.ts        # pica platforms
-    actions.ts          # pica search, actions knowledge, exec
   lib/
     api.ts              # HTTP client for Pica API
     types.ts            # TypeScript interfaces
-    actions.ts          # Action ID normalization, path variable helpers
     config.ts           # ~/.pica/config.json read/write
     agents.ts           # Agent detection, MCP config, status reporting
     platforms.ts        # Platform search and fuzzy matching

package/dist/index.js

@@ -46,11 +46,11 @@ function getApiKey() {
 import fs2 from "fs";
 import path2 from "path";
 import os2 from "os";
-function expandPath(p5) {
-  if (p5.startsWith("~/")) {
-    return path2.join(os2.homedir(), p5.slice(2));
+function expandPath(p4) {
+  if (p4.startsWith("~/")) {
+    return path2.join(os2.homedir(), p4.slice(2));
   }
-  return p5;
+  return p4;
 }
 function getClaudeDesktopConfigPath() {
   switch (process.platform) {
@@ -186,40 +186,6 @@ function getAgentStatuses() {
   });
 }
 
-// src/lib/actions.ts
-var ACTION_ID_PREFIX = "conn_mod_def::";
-function normalizeActionId(id) {
-  if (id.startsWith(ACTION_ID_PREFIX)) return id;
-  return `${ACTION_ID_PREFIX}${id}`;
-}
-function extractPathVariables(path3) {
-  const matches = path3.match(/\{\{(\w+)\}\}/g);
-  if (!matches) return [];
-  return matches.map((m) => m.replace(/\{\{|\}\}/g, ""));
-}
-function replacePathVariables(path3, vars) {
-  let result = path3;
-  for (const [key, value] of Object.entries(vars)) {
-    result = result.replace(`{{${key}}}`, encodeURIComponent(value));
-  }
-  return result;
-}
-function resolveTemplateVariables(path3, data, pathVars) {
-  const variables = extractPathVariables(path3);
-  const merged = { ...pathVars };
-  const remaining = { ...data };
-  for (const v of variables) {
-    if (!merged[v] && data[v] != null) {
-      merged[v] = String(data[v]);
-      delete remaining[v];
-    }
-  }
-  return {
-    resolvedPath: replacePathVariables(path3, merged),
-    remainingData: remaining
-  };
-}
-
 // src/lib/api.ts
 var API_BASE = "https://api.picaos.com/v1";
 var ApiError = class extends Error {
@@ -256,8 +222,8 @@ var PicaApi = class {
     }
     const response = await fetch(url, fetchOpts);
     if (!response.ok) {
-      const text4 = await response.text();
-      throw new ApiError(response.status, text4 || `HTTP ${response.status}`);
+      const text3 = await response.text();
+      throw new ApiError(response.status, text3 || `HTTP ${response.status}`);
     }
     return response.json();
   }
@@ -288,45 +254,6 @@ var PicaApi = class {
     } while (page <= totalPages);
     return allPlatforms;
   }
-  async searchActions(platform, query, limit = 10) {
-    const queryParams = {
-      limit: String(limit),
-      executeAgent: "true"
-    };
-    if (query) queryParams.query = query;
-    const response = await this.requestFull({
-      path: `/available-actions/search/${encodeURIComponent(platform)}`,
-      queryParams
-    });
-    return response.rows || [];
-  }
-  async getActionKnowledge(actionId) {
-    const normalized = normalizeActionId(actionId);
-    const response = await this.requestFull({
-      path: "/knowledge",
-      queryParams: { _id: normalized }
-    });
-    return response.rows?.[0] ?? null;
-  }
-  async executeAction(opts) {
-    const headers = {
-      "x-pica-connection-key": opts.connectionKey,
-      "x-pica-action-id": normalizeActionId(opts.actionId),
-      ...opts.headers
-    };
-    if (opts.isFormData) {
-      headers["Content-Type"] = "multipart/form-data";
-    } else if (opts.isFormUrlEncoded) {
-      headers["Content-Type"] = "application/x-www-form-urlencoded";
-    }
-    return this.requestFull({
-      path: `/passthrough${opts.path}`,
-      method: opts.method.toUpperCase(),
-      body: opts.data,
-      headers,
-      queryParams: opts.queryParams
-    });
-  }
   async waitForConnection(platform, timeoutMs = 5 * 60 * 1e3, pollIntervalMs = 5e3, onPoll) {
     const startTime = Date.now();
     const existingConnections = await this.listConnections();
@@ -372,6 +299,9 @@ async function openApiKeyPage() {
   await open(getApiKeyUrl());
 }
 
+// src/commands/init.ts
+import open2 from "open";
+
 // src/lib/table.ts
 import pc from "picocolors";
 function printTable(columns, rows) {
@@ -410,12 +340,13 @@ function stripAnsi(str) {
 
 // src/commands/init.ts
 async function initCommand(options) {
-  p.intro(pc2.bgCyan(pc2.black(" Pica ")));
   const existingConfig = readConfig();
   if (existingConfig) {
+    p.intro(pc2.bgCyan(pc2.black(" Pica ")));
     await handleExistingConfig(existingConfig.apiKey, options);
     return;
   }
+  printBanner();
   await freshSetup(options);
 }
 async function handleExistingConfig(apiKey, options) {
@@ -521,16 +452,16 @@ ${pc2.cyan(getApiKeyUrl())}`, "API Key");
     p.cancel("Cancelled.");
     process.exit(0);
   }
-  const spinner5 = p.spinner();
-  spinner5.start("Validating API key...");
+  const spinner4 = p.spinner();
+  spinner4.start("Validating API key...");
   const api = new PicaApi(newKey);
   const isValid = await api.validateApiKey();
   if (!isValid) {
-    spinner5.stop("Invalid API key");
+    spinner4.stop("Invalid API key");
     p.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
     process.exit(1);
   }
-  spinner5.stop("API key validated");
+  spinner4.stop("API key validated");
   const reinstalled = [];
   for (const s of statuses) {
     if (s.globalMcp) {
@@ -662,16 +593,16 @@ ${pc2.cyan(getApiKeyUrl())}`, "API Key");
     p.cancel("Setup cancelled.");
     process.exit(0);
   }
-  const spinner5 = p.spinner();
-  spinner5.start("Validating API key...");
+  const spinner4 = p.spinner();
+  spinner4.start("Validating API key...");
   const api = new PicaApi(apiKey);
   const isValid = await api.validateApiKey();
   if (!isValid) {
-    spinner5.stop("Invalid API key");
+    spinner4.stop("Invalid API key");
     p.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
     process.exit(1);
   }
-  spinner5.stop("API key validated");
+  spinner4.stop("API key validated");
   writeConfig({
     apiKey,
     installedAgents: [],
@@ -773,11 +704,10 @@ ${globalPaths}
 
 `;
     }
-    summary += pc2.yellow("Note: Project config files can be committed to share with your team.\n") + pc2.yellow("Team members will need their own API key.\n\n") + `Next steps:
-  ${pc2.cyan("pica add gmail")}       - Connect Gmail
-  ${pc2.cyan("pica platforms")}        - See all 200+ integrations`;
+    summary += pc2.yellow("Note: Project config files can be committed to share with your team.\n") + pc2.yellow("Team members will need their own API key.");
     p.note(summary, "Setup Complete");
-    p.outro("Pica MCP installed!");
+    await promptConnectIntegrations(apiKey);
+    p.outro("Your AI agents now have access to Pica integrations!");
     return;
   }
   const installedAgentIds = [];
@@ -794,16 +724,105 @@ ${globalPaths}
     createdAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   p.note(
-    `Config saved to: ${pc2.dim(getConfigPath())}
-
-Next steps:
-  ${pc2.cyan("pica add gmail")}       - Connect Gmail
-  ${pc2.cyan("pica platforms")}        - See all 200+ integrations
-  ${pc2.cyan("pica connection list")}  - View your connections`,
+    `Config saved to: ${pc2.dim(getConfigPath())}`,
     "Setup Complete"
   );
+  await promptConnectIntegrations(apiKey);
   p.outro("Your AI agents now have access to Pica integrations!");
 }
+function printBanner() {
+  console.log();
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588"));
+  console.log(pc2.cyan("  \u2588\u2588\u2588\u2588\u2588            \u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588    \u2588\u2588\u2588\u2588\u2588"));
+  console.log();
+  console.log(pc2.dim("  U N I V E R S A L   I N T E G R A T I O N S   F O R   A I"));
+  console.log();
+}
+var TOP_INTEGRATIONS = [
+  { value: "gmail", label: "Gmail", hint: "Read and send emails" },
+  { value: "google-calendar", label: "Google Calendar", hint: "Manage events and schedules" },
+  { value: "notion", label: "Notion", hint: "Access pages, databases, and docs" }
+];
+async function promptConnectIntegrations(apiKey) {
+  const api = new PicaApi(apiKey);
+  const connected = [];
+  try {
+    const existing = await api.listConnections();
+    for (const conn of existing) {
+      const match = TOP_INTEGRATIONS.find(
+        (i) => i.value === conn.platform.toLowerCase()
+      );
+      if (match) connected.push(match.value);
+    }
+  } catch {
+  }
+  let first = true;
+  while (true) {
+    const available = TOP_INTEGRATIONS.filter((i) => !connected.includes(i.value));
+    const options = [
+      ...available.map((i) => ({
+        value: i.value,
+        label: i.label,
+        hint: i.hint
+      })),
+      { value: "more", label: "Browse all 200+ platforms" },
+      { 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 p.select({ message, options });
+    if (p.isCancel(choice) || choice === "skip") {
+      break;
+    }
+    if (choice === "more") {
+      try {
+        await open2("https://app.picaos.com/connections");
+        p.log.info("Opened Pica dashboard in browser.");
+      } catch {
+        p.note("https://app.picaos.com/connections", "Open in browser");
+      }
+      p.log.info(`Connect from the dashboard, or use ${pc2.cyan("pica add <platform>")}`);
+      break;
+    }
+    const platform = choice;
+    const integration = TOP_INTEGRATIONS.find((i) => i.value === platform);
+    const label = integration?.label ?? platform;
+    p.log.info(`Opening browser to connect ${pc2.cyan(label)}...`);
+    try {
+      await openConnectionPage(platform);
+    } catch {
+      const url = getConnectionUrl(platform);
+      p.log.warn("Could not open browser automatically.");
+      p.note(url, "Open manually");
+    }
+    const spinner4 = p.spinner();
+    spinner4.start("Waiting for connection... (complete auth in browser)");
+    try {
+      await api.waitForConnection(platform, 5 * 60 * 1e3, 5e3);
+      spinner4.stop(`${label} connected!`);
+      p.log.success(`${pc2.green("\u2713")} ${label} is now available to your AI agents`);
+      connected.push(platform);
+      first = false;
+    } catch (error) {
+      spinner4.stop("Connection timed out");
+      if (error instanceof TimeoutError) {
+        p.log.warn(`No worries. Connect later with: ${pc2.cyan(`pica add ${platform}`)}`);
+      }
+      first = false;
+    }
+    if (TOP_INTEGRATIONS.every((i) => connected.includes(i.value))) {
+      p.log.success("All top integrations connected!");
+      break;
+    }
+  }
+}
 function maskApiKey(key) {
   if (key.length <= 12) return key.slice(0, 8) + "...";
   return key.slice(0, 8) + "..." + key.slice(-4);
@@ -825,16 +844,16 @@ import pc3 from "picocolors";
 function findPlatform(platforms, query) {
   const normalizedQuery = query.toLowerCase().trim();
   const exact = platforms.find(
-    (p5) => p5.platform.toLowerCase() === normalizedQuery || p5.name.toLowerCase() === normalizedQuery
+    (p4) => p4.platform.toLowerCase() === normalizedQuery || p4.name.toLowerCase() === normalizedQuery
   );
   if (exact) return exact;
   return null;
 }
 function findSimilarPlatforms(platforms, query, limit = 3) {
   const normalizedQuery = query.toLowerCase().trim();
-  const scored = platforms.map((p5) => {
-    const name = p5.name.toLowerCase();
-    const slug = p5.platform.toLowerCase();
+  const scored = platforms.map((p4) => {
+    const name = p4.name.toLowerCase();
+    const slug = p4.platform.toLowerCase();
     let score = 0;
     if (name.includes(normalizedQuery) || slug.includes(normalizedQuery)) {
       score = 10;
@@ -843,7 +862,7 @@ function findSimilarPlatforms(platforms, query, limit = 3) {
     } else {
       score = countMatchingChars(normalizedQuery, slug);
     }
-    return { platform: p5, score };
+    return { platform: p4, score };
   }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score).slice(0, limit);
   return scored.map((item) => item.platform);
 }
@@ -865,14 +884,14 @@ async function connectionAddCommand(platformArg) {
     process.exit(1);
   }
   const api = new PicaApi(apiKey);
-  const spinner5 = p2.spinner();
-  spinner5.start("Loading platforms...");
+  const spinner4 = p2.spinner();
+  spinner4.start("Loading platforms...");
   let platforms;
   try {
     platforms = await api.listPlatforms();
-    spinner5.stop(`${platforms.length} platforms available`);
+    spinner4.stop(`${platforms.length} platforms available`);
   } catch (error) {
-    spinner5.stop("Failed to load platforms");
+    spinner4.stop("Failed to load platforms");
     p2.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
     process.exit(1);
   }
@@ -970,11 +989,11 @@ async function connectionListCommand() {
     process.exit(1);
   }
   const api = new PicaApi(apiKey);
-  const spinner5 = p2.spinner();
-  spinner5.start("Loading connections...");
+  const spinner4 = p2.spinner();
+  spinner4.start("Loading connections...");
   try {
     const connections = await api.listConnections();
-    spinner5.stop(`${connections.length} connection${connections.length === 1 ? "" : "s"} found`);
+    spinner4.stop(`${connections.length} connection${connections.length === 1 ? "" : "s"} found`);
     if (connections.length === 0) {
       p2.note(
         `No connections yet.
@@ -1003,7 +1022,7 @@ Add one with: ${pc3.cyan("pica connection add gmail")}`,
     console.log();
     p2.note(`Add more with: ${pc3.cyan("pica connection add <platform>")}`, "Tip");
   } catch (error) {
-    spinner5.stop("Failed to load connections");
+    spinner4.stop("Failed to load connections");
     p2.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
     process.exit(1);
   }
@@ -1031,11 +1050,11 @@ async function platformsCommand(options) {
     process.exit(1);
   }
   const api = new PicaApi(apiKey);
-  const spinner5 = p3.spinner();
-  spinner5.start("Loading platforms...");
+  const spinner4 = p3.spinner();
+  spinner4.start("Loading platforms...");
   try {
     const platforms = await api.listPlatforms();
-    spinner5.stop(`${platforms.length} platforms available`);
+    spinner4.stop(`${platforms.length} platforms available`);
     if (options.json) {
       console.log(JSON.stringify(platforms, null, 2));
       return;
@@ -1087,317 +1106,12 @@ async function platformsCommand(options) {
     console.log();
     p3.note(`Connect with: ${pc4.cyan("pica connection add <platform>")}`, "Tip");
   } catch (error) {
-    spinner5.stop("Failed to load platforms");
+    spinner4.stop("Failed to load platforms");
     p3.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
     process.exit(1);
   }
 }
 
-// src/commands/actions.ts
-import * as p4 from "@clack/prompts";
-import pc5 from "picocolors";
-function getApi() {
-  const apiKey = getApiKey();
-  if (!apiKey) {
-    p4.cancel("Not configured. Run `pica init` first.");
-    process.exit(1);
-  }
-  return new PicaApi(apiKey);
-}
-function colorMethod(method) {
-  const m = method.toUpperCase();
-  switch (m) {
-    case "GET":
-      return pc5.green(m);
-    case "POST":
-      return pc5.yellow(m);
-    case "PUT":
-      return pc5.blue(m);
-    case "PATCH":
-      return pc5.cyan(m);
-    case "DELETE":
-      return pc5.red(m);
-    default:
-      return pc5.dim(m);
-  }
-}
-function padMethod(method) {
-  return method.toUpperCase().padEnd(7);
-}
-async function actionsSearchCommand(platform, query, options = {}) {
-  const api = getApi();
-  if (!query) {
-    const input = await p4.text({
-      message: `Search actions on ${pc5.cyan(platform)}:`,
-      placeholder: "send email, create contact, list orders..."
-    });
-    if (p4.isCancel(input)) {
-      p4.cancel("Cancelled.");
-      process.exit(0);
-    }
-    query = input;
-  }
-  const spinner5 = p4.spinner();
-  spinner5.start(`Searching ${platform} actions...`);
-  try {
-    const limit = options.limit ? parseInt(options.limit, 10) : 10;
-    const actions2 = await api.searchActions(platform, query, limit);
-    spinner5.stop(`${actions2.length} action${actions2.length === 1 ? "" : "s"} found`);
-    if (options.json) {
-      console.log(JSON.stringify(actions2, null, 2));
-      return;
-    }
-    if (actions2.length === 0) {
-      p4.note(`No actions found for "${query}" on ${platform}.`, "No Results");
-      return;
-    }
-    console.log();
-    const rows = actions2.map((action) => ({
-      method: colorMethod(padMethod(action.method)),
-      path: action.path,
-      title: action.title,
-      id: action._id
-    }));
-    printTable(
-      [
-        { key: "method", label: "Method" },
-        { key: "title", label: "Title" },
-        { key: "path", label: "Path", color: pc5.dim },
-        { key: "id", label: "Action ID", color: pc5.dim }
-      ],
-      rows
-    );
-    console.log();
-    p4.note(
-      `Get docs:  ${pc5.cyan("pica actions knowledge <actionId>")}
-Execute:   ${pc5.cyan("pica actions execute <actionId>")}`,
-      "Next Steps"
-    );
-  } catch (error) {
-    spinner5.stop("Search failed");
-    p4.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-    process.exit(1);
-  }
-}
-async function actionsKnowledgeCommand(actionId, options = {}) {
-  const api = getApi();
-  const spinner5 = p4.spinner();
-  spinner5.start("Loading action knowledge...");
-  try {
-    const knowledge = await api.getActionKnowledge(actionId);
-    spinner5.stop("Action knowledge loaded");
-    if (!knowledge) {
-      p4.cancel(`No knowledge found for action: ${actionId}`);
-      process.exit(1);
-    }
-    if (options.json) {
-      console.log(JSON.stringify(knowledge, null, 2));
-      return;
-    }
-    printKnowledge(knowledge, options.full);
-  } catch (error) {
-    spinner5.stop("Failed to load knowledge");
-    p4.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-    process.exit(1);
-  }
-}
-function printKnowledge(k, full) {
-  console.log();
-  console.log(pc5.bold(`  ${k.title}`));
-  console.log();
-  console.log(`  Platform:  ${pc5.cyan(k.connectionPlatform)}`);
-  console.log(`  Method:    ${colorMethod(k.method)}`);
-  console.log(`  Path:      ${k.path}`);
-  console.log(`  Base URL:  ${pc5.dim(k.baseUrl)}`);
-  if (k.tags?.length) {
-    console.log(`  Tags:      ${k.tags.map((t) => pc5.dim(t)).join(", ")}`);
-  }
-  const pathVars = extractPathVariables(k.path);
-  if (pathVars.length > 0) {
-    console.log(`  Path Vars: ${pathVars.map((v) => pc5.yellow(`{{${v}}}`)).join(", ")}`);
-  }
-  console.log(`  Active:    ${k.active ? pc5.green("yes") : pc5.red("no")}`);
-  console.log(`  ID:        ${pc5.dim(k._id)}`);
-  if (k.knowledge) {
-    console.log();
-    console.log(pc5.bold("  API Documentation"));
-    console.log(pc5.dim("  " + "\u2500".repeat(40)));
-    console.log();
-    const lines = k.knowledge.split("\n");
-    const displayLines = full ? lines : lines.slice(0, 50);
-    for (const line of displayLines) {
-      console.log(`  ${line}`);
-    }
-    if (!full && lines.length > 50) {
-      console.log();
-      console.log(pc5.dim(`  ... ${lines.length - 50} more lines. Use --full to see all.`));
-    }
-  }
-  console.log();
-}
-async function actionsExecuteCommand(actionId, options = {}) {
-  const api = getApi();
-  const spinner5 = p4.spinner();
-  spinner5.start("Loading action details...");
-  let knowledge;
-  try {
-    const k = await api.getActionKnowledge(actionId);
-    if (!k) {
-      spinner5.stop("Action not found");
-      p4.cancel(`No action found for: ${actionId}`);
-      process.exit(1);
-    }
-    knowledge = k;
-    spinner5.stop(`${colorMethod(knowledge.method)} ${knowledge.path}`);
-  } catch (error) {
-    spinner5.stop("Failed to load action");
-    p4.cancel(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-    process.exit(1);
-  }
-  let connectionKey = options.connection;
-  if (!connectionKey) {
-    connectionKey = await resolveConnection(api, knowledge.connectionPlatform);
-  }
-  const pathVarMap = parseKeyValuePairs(options.pathVar || []);
-  const pathVars = extractPathVariables(knowledge.path);
-  for (const v of pathVars) {
-    if (!pathVarMap[v]) {
-      const input = await p4.text({
-        message: `Value for path variable ${pc5.yellow(`{{${v}}}`)}:`,
-        validate: (val) => val.trim() ? void 0 : "Value is required"
-      });
-      if (p4.isCancel(input)) {
-        p4.cancel("Cancelled.");
-        process.exit(0);
-      }
-      pathVarMap[v] = input;
-    }
-  }
-  let bodyData = {};
-  if (options.data) {
-    try {
-      bodyData = JSON.parse(options.data);
-    } catch {
-      p4.cancel("Invalid JSON in --data flag.");
-      process.exit(1);
-    }
-  } else if (!["GET", "DELETE", "HEAD"].includes(knowledge.method.toUpperCase())) {
-    const input = await p4.text({
-      message: "Request body (JSON):",
-      placeholder: '{"key": "value"} or leave empty'
-    });
-    if (p4.isCancel(input)) {
-      p4.cancel("Cancelled.");
-      process.exit(0);
-    }
-    if (input.trim()) {
-      try {
-        bodyData = JSON.parse(input);
-      } catch {
-        p4.cancel("Invalid JSON.");
-        process.exit(1);
-      }
-    }
-  }
-  const queryParams = parseKeyValuePairs(options.query || []);
-  const { resolvedPath, remainingData } = resolveTemplateVariables(
-    knowledge.path,
-    bodyData,
-    pathVarMap
-  );
-  console.log();
-  console.log(pc5.bold("  Request Summary"));
-  console.log(`  ${colorMethod(knowledge.method)} ${knowledge.baseUrl}${resolvedPath}`);
-  console.log(`  Connection: ${pc5.dim(connectionKey)}`);
-  if (Object.keys(remainingData).length > 0) {
-    console.log(`  Body: ${pc5.dim(JSON.stringify(remainingData))}`);
-  }
-  if (Object.keys(queryParams).length > 0) {
-    console.log(`  Query: ${pc5.dim(JSON.stringify(queryParams))}`);
-  }
-  console.log();
-  const execSpinner = p4.spinner();
-  execSpinner.start("Executing...");
-  try {
-    const result = await api.executeAction({
-      method: knowledge.method,
-      path: resolvedPath,
-      actionId,
-      connectionKey,
-      data: Object.keys(remainingData).length > 0 ? remainingData : void 0,
-      queryParams: Object.keys(queryParams).length > 0 ? queryParams : void 0,
-      isFormData: options.formData,
-      isFormUrlEncoded: options.formUrlencoded
-    });
-    execSpinner.stop(pc5.green("Success"));
-    if (options.json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.log();
-      console.log(pc5.bold("  Response"));
-      console.log(pc5.dim("  " + "\u2500".repeat(40)));
-      console.log();
-      console.log(formatResponse(result));
-      console.log();
-    }
-  } catch (error) {
-    execSpinner.stop(pc5.red("Failed"));
-    const msg = error instanceof Error ? error.message : "Unknown error";
-    p4.cancel(`Execution failed: ${msg}`);
-    process.exit(1);
-  }
-}
-async function resolveConnection(api, platform) {
-  const spinner5 = p4.spinner();
-  spinner5.start("Loading connections...");
-  const connections = await api.listConnections();
-  const matching = connections.filter(
-    (c) => c.platform.toLowerCase() === platform.toLowerCase()
-  );
-  spinner5.stop(`${matching.length} ${platform} connection${matching.length === 1 ? "" : "s"} found`);
-  if (matching.length === 0) {
-    p4.cancel(
-      `No ${platform} connections found.
-
-Add one with: ${pc5.cyan(`pica connection add ${platform}`)}`
-    );
-    process.exit(1);
-  }
-  if (matching.length === 1) {
-    p4.log.info(`Using connection: ${pc5.dim(matching[0].key)}`);
-    return matching[0].key;
-  }
-  const selected = await p4.select({
-    message: `Multiple ${platform} connections found. Which one?`,
-    options: matching.map((c) => ({
-      value: c.key,
-      label: `${c.key}`,
-      hint: c.state
-    }))
-  });
-  if (p4.isCancel(selected)) {
-    p4.cancel("Cancelled.");
-    process.exit(0);
-  }
-  return selected;
-}
-function parseKeyValuePairs(pairs) {
-  const result = {};
-  for (const pair of pairs) {
-    const eqIdx = pair.indexOf("=");
-    if (eqIdx === -1) continue;
-    const key = pair.slice(0, eqIdx);
-    const value = pair.slice(eqIdx + 1);
-    result[key] = value;
-  }
-  return result;
-}
-function formatResponse(data, indent = 2) {
-  const prefix = " ".repeat(indent);
-  const json = JSON.stringify(data, null, 2);
-  return json.split("\n").map((line) => `${prefix}${line}`).join("\n");
-}
-
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -1422,23 +1136,4 @@ program.command("add [platform]").description("Shortcut for: connection add").ac
 program.command("list").alias("ls").description("Shortcut for: connection list").action(async () => {
   await connectionListCommand();
 });
-var actions = program.command("actions").alias("a").description("Discover and execute platform actions");
-actions.command("search <platform> [query]").description("Search actions on a platform").option("--json", "Output as JSON").option("-l, --limit <limit>", "Max results", "10").action(async (platform, query, options) => {
-  await actionsSearchCommand(platform, query, options);
-});
-actions.command("knowledge <actionId>").alias("k").description("Get API docs for an action").option("--json", "Output as JSON").option("--full", "Show full knowledge (no truncation)").action(async (actionId, options) => {
-  await actionsKnowledgeCommand(actionId, options);
-});
-actions.command("execute <actionId>").alias("x").description("Execute an action").option("-c, --connection <key>", "Connection key to use").option("-d, --data <json>", "Request body as JSON").option("-p, --path-var <key=value...>", "Path variable", collectValues).option("-q, --query <key=value...>", "Query parameter", collectValues).option("--form-data", "Send as multipart/form-data").option("--form-urlencoded", "Send as application/x-www-form-urlencoded").option("--json", "Output as JSON").action(async (actionId, options) => {
-  await actionsExecuteCommand(actionId, options);
-});
-program.command("search <platform> [query]").description("Shortcut for: actions search").option("--json", "Output as JSON").option("-l, --limit <limit>", "Max results", "10").action(async (platform, query, options) => {
-  await actionsSearchCommand(platform, query, options);
-});
-program.command("exec <actionId>").description("Shortcut for: actions execute").option("-c, --connection <key>", "Connection key to use").option("-d, --data <json>", "Request body as JSON").option("-p, --path-var <key=value...>", "Path variable", collectValues).option("-q, --query <key=value...>", "Query parameter", collectValues).option("--form-data", "Send as multipart/form-data").option("--form-urlencoded", "Send as application/x-www-form-urlencoded").option("--json", "Output as JSON").action(async (actionId, options) => {
-  await actionsExecuteCommand(actionId, options);
-});
-function collectValues(value, previous) {
-  return (previous || []).concat([value]);
-}
 program.parse();

package/package.json

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