@solidactions/cli 1.9.0 → 1.10.1

package/dist/commands/oauth-actions-list.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oauthActionsList = oauthActionsList;
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../utils/api");
+async function oauthActionsList(platform, options) {
+    const config = await (0, api_1.requireConfigWithWorkspace)();
+    try {
+        const params = { platform };
+        if (options.limit)
+            params.limit = String(options.limit);
+        const response = await axios_1.default.get(`${config.host}/api/v1/oauth-actions`, {
+            headers: (0, api_1.getApiHeaders)(config),
+            params,
+        });
+        const actions = response.data.oauth_actions || [];
+        if (options.json) {
+            process.stdout.write(JSON.stringify(actions, null, 2) + '\n');
+            return;
+        }
+        if (actions.length === 0) {
+            console.log('No actions found.');
+            return;
+        }
+        for (const a of actions) {
+            const method = (a.method || 'GET').toUpperCase().padEnd(6);
+            console.log(`${chalk_1.default.cyan(method)} ${chalk_1.default.white(a.path.padEnd(50))} ${chalk_1.default.gray('— ' + (a.title || ''))}`);
+        }
+        console.log('');
+        console.log(chalk_1.default.gray(`${actions.length} action(s) — use "solidactions oauth-actions search ${platform} <query>" to narrow, or "oauth-actions show ${platform} <action_id>" for detail.`));
+    }
+    catch (error) {
+        if (error.response?.status === 401) {
+            console.error(chalk_1.default.red('Authentication failed. Run "solidactions login <api-key>".'));
+        }
+        else if (error.response) {
+            console.error(chalk_1.default.red(`Failed: ${error.response.status}`), error.response.data);
+        }
+        else {
+            console.error(chalk_1.default.red('Connection failed:'), error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/oauth-actions-search.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oauthActionsSearch = oauthActionsSearch;
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../utils/api");
+async function oauthActionsSearch(platform, query, options) {
+    const config = await (0, api_1.requireConfigWithWorkspace)();
+    try {
+        const params = { platform };
+        if (query)
+            params.q = query;
+        if (options.method)
+            params.method = options.method;
+        if (options.limit)
+            params.limit = String(options.limit);
+        const response = await axios_1.default.get(`${config.host}/api/v1/oauth-actions`, {
+            headers: (0, api_1.getApiHeaders)(config),
+            params,
+        });
+        const actions = response.data.oauth_actions || [];
+        if (options.json) {
+            process.stdout.write(JSON.stringify(actions, null, 2) + '\n');
+            return;
+        }
+        if (actions.length === 0) {
+            console.log('No actions found.');
+            return;
+        }
+        for (const a of actions) {
+            const method = (a.method || 'GET').toUpperCase().padEnd(6);
+            const path = a.path || '';
+            const title = a.title || '';
+            console.log(`${chalk_1.default.cyan(method)} ${chalk_1.default.white(path.padEnd(55))} ${chalk_1.default.gray('— ' + title)}`);
+            if (a.tags?.length) {
+                console.log(chalk_1.default.gray(`  tags: ${a.tags.join(', ')}`));
+            }
+            console.log(chalk_1.default.gray(`  action_id: ${a.action_id}`));
+            console.log('');
+        }
+        console.log(chalk_1.default.gray(`${actions.length} action(s) found.`));
+        console.log(chalk_1.default.gray(`Run 'solidactions oauth-actions show ${platform} <action_id>' for full schema + paste-ready snippet.`));
+    }
+    catch (error) {
+        if (error.response?.status === 401) {
+            console.error(chalk_1.default.red('Authentication failed. Run "solidactions login <api-key>" to re-configure.'));
+        }
+        else if (error.response) {
+            console.error(chalk_1.default.red(`Failed: ${error.response.status}`), error.response.data);
+        }
+        else {
+            console.error(chalk_1.default.red('Connection failed:'), error.message);
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/oauth-actions-show.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oauthActionsShow = oauthActionsShow;
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../utils/api");
+async function oauthActionsShow(platform, actionId, options) {
+    const config = await (0, api_1.requireConfigWithWorkspace)();
+    try {
+        const response = await axios_1.default.get(`${config.host}/api/v1/oauth-actions/${platform}/${encodeURIComponent(actionId)}`, {
+            headers: (0, api_1.getApiHeaders)(config),
+        });
+        const action = response.data.oauth_action;
+        if (options.json) {
+            process.stdout.write(JSON.stringify(action, null, 2) + '\n');
+            return;
+        }
+        renderHumanReadable(action);
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            console.error(chalk_1.default.red(`Action not found: ${platform}/${actionId}`));
+        }
+        else if (error.response?.status === 401) {
+            console.error(chalk_1.default.red('Authentication failed. Run "solidactions login <api-key>".'));
+        }
+        else if (error.response) {
+            console.error(chalk_1.default.red(`Failed: ${error.response.status}`), error.response.data);
+        }
+        else {
+            console.error(chalk_1.default.red('Connection failed:'), error.message);
+        }
+        process.exit(1);
+    }
+}
+function renderHumanReadable(action) {
+    const method = (action.method || 'GET').toUpperCase();
+    const ioSchema = action.io_schema || {};
+    const example = ioSchema.ioExample?.input;
+    console.log(chalk_1.default.bold(action.title));
+    console.log(chalk_1.default.cyan(`${method} ${action.path}`));
+    console.log(chalk_1.default.gray(`action_id: ${action.action_id}`));
+    if (action.tags?.length)
+        console.log(chalk_1.default.gray(`tags: ${action.tags.join(', ')}`));
+    console.log('');
+    const inputDesc = ioSchema.inputSchema?.description;
+    if (inputDesc) {
+        console.log(chalk_1.default.bold('Description:'));
+        console.log(indent(inputDesc));
+        console.log('');
+    }
+    if (example?.path && Object.keys(example.path).length) {
+        console.log(chalk_1.default.bold('Path parameters (example values):'));
+        console.log(chalk_1.default.gray(indent(JSON.stringify(example.path, null, 2))));
+        console.log('');
+    }
+    if (example?.query && Object.keys(example.query).length) {
+        console.log(chalk_1.default.bold('Query parameters (example values):'));
+        console.log(chalk_1.default.gray(indent(JSON.stringify(example.query, null, 2))));
+        console.log('');
+    }
+    if (example?.body !== undefined && example.body !== null) {
+        console.log(chalk_1.default.bold('Example request body:'));
+        console.log(chalk_1.default.gray(indent(JSON.stringify(example.body, null, 2))));
+        console.log('');
+    }
+    if (ioSchema.ioExample?.output !== undefined) {
+        console.log(chalk_1.default.bold('Example response:'));
+        console.log(chalk_1.default.gray(indent(JSON.stringify(ioSchema.ioExample.output, null, 2))));
+        console.log('');
+    }
+    console.log(chalk_1.default.bold('Paste-ready snippet:'));
+    console.log(chalk_1.default.gray(indent(buildSnippet(action))));
+}
+/**
+ * Render a fetch() call against the SA proxy with `{{name}}` path placeholders
+ * rewritten to `${name}` template-literal slots, query parameters appended,
+ * and the example body inlined verbatim (so the AI substitutes values into the
+ * known-good shape rather than inferring it from JSON Schema).
+ */
+function buildSnippet(action) {
+    const method = (action.method || 'GET').toUpperCase();
+    const platform = action.platform;
+    const platformEnv = platform.toUpperCase().replace(/-/g, '_');
+    const example = action.io_schema?.ioExample?.input;
+    const pathTemplate = (action.path || '').replace(/\{\{\s*([^}]+?)\s*\}\}/g, (_m, name) => '${' + name.trim() + '}');
+    const queryEntries = example?.query ? Object.entries(example.query) : [];
+    const queryString = queryEntries.length
+        ? '?' + queryEntries.flatMap(([k, v]) => {
+            const encodedKey = encodeURIComponent(k);
+            const items = Array.isArray(v) ? v : [v];
+            return items.map((item) => `${encodedKey}=\${encodeURIComponent(${JSON.stringify(item)})}`);
+        }).join('&')
+        : '';
+    const proxyHeaders = {
+        'Authorization': '__PROXY_AUTH__',
+        'X-SA-Connection': '__SA_CONNECTION__',
+    };
+    const exampleHeaders = example?.headers || {};
+    for (const [k, v] of Object.entries(exampleHeaders)) {
+        if (isProxyManagedHeader(k))
+            continue;
+        proxyHeaders[k] = v;
+    }
+    if (example?.body !== undefined && example.body !== null && !proxyHeaders['Content-Type']) {
+        proxyHeaders['Content-Type'] = 'application/json';
+    }
+    const headersBlock = Object.entries(proxyHeaders)
+        .map(([k, v]) => {
+        if (v === '__PROXY_AUTH__')
+            return `      'Authorization': \`Bearer \${process.env.SA_PROXY_TOKEN}\`,`;
+        if (v === '__SA_CONNECTION__')
+            return `      'X-SA-Connection': process.env.${platformEnv},`;
+        return `      ${JSON.stringify(k)}: ${JSON.stringify(v)},`;
+    })
+        .join('\n');
+    const lines = [];
+    lines.push('const res = await fetch(');
+    lines.push(`  \`\${process.env.SA_PROXY_URL}/${platform}${pathTemplate}${queryString}\`,`);
+    lines.push('  {');
+    lines.push(`    method: '${method}',`);
+    lines.push('    headers: {');
+    lines.push(headersBlock);
+    lines.push('    },');
+    if (example?.body !== undefined && example.body !== null) {
+        const bodyJson = JSON.stringify(example.body, null, 2)
+            .split('\n')
+            .map((l, i) => (i === 0 ? l : '    ' + l))
+            .join('\n');
+        if (typeof example.body === 'object' && example.body !== null && 'connectionKey' in example.body) {
+            lines.push(`    // connectionKey: copy verbatim — the proxy rewrites it server-side from your X-SA-Connection header.`);
+        }
+        lines.push(`    body: JSON.stringify(${bodyJson}),`);
+    }
+    lines.push('  }');
+    lines.push(');');
+    lines.push('const data = await res.json();');
+    return lines.join('\n');
+}
+function indent(text, prefix = '  ') {
+    return text.split('\n').map(line => prefix + line).join('\n');
+}
+/**
+ * Defense-in-depth: even though the SAA API sanitizes `Authorization`,
+ * `x-pica-*`, and `x-one-*` out of `ioExample.input.headers` before serving,
+ * filter them again here so any future drift can't leak proxy internals into
+ * a workflow's outbound request.
+ */
+function isProxyManagedHeader(name) {
+    const lower = name.toLowerCase();
+    return lower === 'authorization'
+        || lower.startsWith('x-pica-')
+        || lower.startsWith('x-one-');
+}

package/dist/index.js

@@ -28,6 +28,9 @@ const webhook_list_1 = require("./commands/webhook-list");
 const dev_1 = require("./commands/dev");
 const ai_init_1 = require("./commands/ai-init");
 const ai_examples_1 = require("./commands/ai-examples");
+const oauth_actions_search_1 = require("./commands/oauth-actions-search");
+const oauth_actions_list_1 = require("./commands/oauth-actions-list");
+const oauth_actions_show_1 = require("./commands/oauth-actions-show");
 const workspaces_1 = require("./commands/workspaces");
 const config_1 = require("./utils/config");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -338,6 +341,34 @@ workspace
     await (0, workspaces_1.workspaceSet)(input, opts);
 });
 // =============================================================================
+// oauth-actions <subcommand>
+// =============================================================================
+const oauthActionsCmd = program.command('oauth-actions').description('Discover OAuth-backed API operations callable via the SA proxy');
+oauthActionsCmd
+    .command('search <platform> [query]')
+    .description('Search available actions for a connected platform')
+    .option('--method <method>', 'Filter by HTTP method (GET, POST, etc.)')
+    .option('--limit <n>', 'Maximum results to return', (v) => parseInt(v, 10))
+    .option('--json', 'Emit raw JSON for AI/script consumption')
+    .action((platform, query, options) => {
+    (0, oauth_actions_search_1.oauthActionsSearch)(platform, query, options);
+});
+oauthActionsCmd
+    .command('list <platform>')
+    .description('List actions for a connected platform')
+    .option('--limit <n>', 'Maximum results to return', (v) => parseInt(v, 10))
+    .option('--json', 'Emit raw JSON for AI/script consumption')
+    .action((platform, options) => {
+    (0, oauth_actions_list_1.oauthActionsList)(platform, options);
+});
+oauthActionsCmd
+    .command('show <platform> <action-id>')
+    .description('Show full schema, example body, and a paste-ready fetch snippet for one action')
+    .option('--json', 'Emit raw JSON for AI/script consumption')
+    .action((platform, actionId, options) => {
+    (0, oauth_actions_show_1.oauthActionsShow)(platform, actionId, options);
+});
+// =============================================================================
 // ai <subcommand>
 // =============================================================================
 const ai = program.command('ai').description('AI helper tools');

package/dist/utils/skills.js

@@ -14,6 +14,7 @@ const SKILL_NAMES = [
     'solidactions-getting-started',
     'solidactions-workflow-coding',
     'solidactions-deploy-and-config',
+    'solidactions-pica-actions',
 ];
 const EXAMPLES_OWNER = 'SolidActions';
 const EXAMPLES_REPO = 'solidactions-examples';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidactions/cli",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "SolidActions CLI - Deploy and manage workflow automation",
   "main": "dist/index.js",
   "bin": {