@agentled/cli 0.1.1

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Agentled CLI — Zero context-window cost access to workflows, apps, and knowledge.
+ *
+ * Usage:
+ *   agentled auth login --key wsk_...
+ *   agentled workflows list
+ *   agentled apps test web-scraping scrape --input '{"url": "..."}'
+ *
+ * Environment variables:
+ *   AGENTLED_API_KEY  — Workspace API key (wsk_*)
+ *   AGENTLED_URL      — Base URL (default: https://www.agentled.app)
+ *   AGENTLED_WORKSPACE — Saved workspace id, alias, or name to target
+ */
+import { Command } from 'commander';
+import { registerAuthCommands } from './commands/auth.js';
+import { registerWorkflowCommands } from './commands/workflows.js';
+import { registerExecutionCommands } from './commands/executions.js';
+import { registerAppCommands } from './commands/apps.js';
+import { registerKnowledgeCommands } from './commands/knowledge.js';
+import { registerAiCommands } from './commands/ai.js';
+import { registerWorkspaceCommands } from './commands/workspace.js';
+import { registerDoCommand } from './commands/do.js';
+import { registerChatCommands } from './commands/chat.js';
+import { registerOnboardingCommands } from './commands/onboarding.js';
+const program = new Command();
+program
+    .name('agentled')
+    .description('Agentled CLI — manage workflows, apps, and knowledge. Optimized for AI agents.')
+    .version('0.1.1')
+    .option('--workspace <workspace>', 'Use a saved workspace by id, alias, or name for this command');
+program.hook('preAction', (_thisCommand, actionCommand) => {
+    const workspace = actionCommand.optsWithGlobals().workspace;
+    if (workspace) {
+        process.env.AGENTLED_WORKSPACE = workspace;
+    }
+});
+// Register all command groups
+registerAuthCommands(program);
+registerWorkflowCommands(program);
+registerExecutionCommands(program);
+registerAppCommands(program);
+registerKnowledgeCommands(program);
+registerAiCommands(program);
+registerWorkspaceCommands(program);
+registerDoCommand(program);
+registerChatCommands(program);
+registerOnboardingCommands(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,gFAAgF,CAAC;KAC7F,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,yBAAyB,EAAE,8DAA8D,CAAC,CAAC;AAEvG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,aAAa,CAAC,eAAe,EAAE,CAAC,SAAS,CAAC;IAC5D,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAC/C,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8BAA8B;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC3B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAEpC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/browser-auth.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Browser-based authentication for `agentled auth login`.
+ *
+ * 1. Starts a temporary HTTP server on localhost
+ * 2. Opens the browser to /cli/authorize?port=...&state=...
+ * 3. Waits for the callback with a signed JWT code
+ * 4. Exchanges the code for the raw API key via /api/cli/exchange
+ *
+ * Uses only Node.js built-ins (http, crypto, child_process).
+ */
+export interface BrowserLoginResult {
+    apiKey: string;
+    workspaceId: string;
+    workspaceName: string;
+    userId?: string;
+    userEmail?: string;
+    userName?: string;
+    isNewUser: boolean;
+    baseUrl: string;
+}
+/**
+ * Run the browser-based login flow.
+ */
+export declare function browserLogin(baseUrl: string): Promise<BrowserLoginResult>;

package/dist/utils/browser-auth.js

@@ -0,0 +1,172 @@
+/**
+ * Browser-based authentication for `agentled auth login`.
+ *
+ * 1. Starts a temporary HTTP server on localhost
+ * 2. Opens the browser to /cli/authorize?port=...&state=...
+ * 3. Waits for the callback with a signed JWT code
+ * 4. Exchanges the code for the raw API key via /api/cli/exchange
+ *
+ * Uses only Node.js built-ins (http, crypto, child_process).
+ */
+/* eslint-disable no-console */
+import * as http from 'node:http';
+import * as crypto from 'node:crypto';
+import { spawn } from 'node:child_process';
+import * as net from 'node:net';
+const TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+const PORT_RANGE_START = 9876;
+const PORT_RANGE_END = 9999;
+/**
+ * Find an available port in the range.
+ */
+function findFreePort(start, end) {
+    return new Promise((resolve, reject) => {
+        const tryPort = (port) => {
+            if (port > end) {
+                reject(new Error(`No free port found in range ${start}-${end}`));
+                return;
+            }
+            const server = net.createServer();
+            server.once('error', () => tryPort(port + 1));
+            server.once('listening', () => {
+                server.close(() => resolve(port));
+            });
+            server.listen(port, '127.0.0.1');
+        };
+        tryPort(start);
+    });
+}
+/**
+ * Open a URL in the user's default browser.
+ * Uses spawn with argument arrays to avoid shell injection.
+ */
+function openBrowser(targetUrl) {
+    const platform = process.platform;
+    let cmd;
+    let args;
+    if (platform === 'darwin') {
+        cmd = 'open';
+        args = [targetUrl];
+    }
+    else if (platform === 'win32') {
+        cmd = 'cmd';
+        args = ['/c', 'start', '', targetUrl];
+    }
+    else {
+        cmd = 'xdg-open';
+        args = [targetUrl];
+    }
+    const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+    child.unref();
+    child.on('error', () => {
+        // Silently fail — the URL is printed to the terminal as fallback
+    });
+}
+const SUCCESS_HTML = `<!DOCTYPE html>
+<html>
+<head><title>Agentled CLI</title></head>
+<body style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; display: flex; justify-content: center; align-items: center; min-height: 100vh; margin: 0; background: #f9fafb;">
+<div style="text-align: center; padding: 2rem;">
+  <div style="width: 48px; height: 48px; margin: 0 auto 1rem; background: #d1fae5; border-radius: 50%; display: flex; align-items: center; justify-content: center;">
+    <svg width="24" height="24" fill="none" viewBox="0 0 24 24" stroke="#059669" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7"/></svg>
+  </div>
+  <h1 style="font-size: 1.25rem; font-weight: 600; color: #111827; margin: 0 0 0.5rem;">Authentication Successful</h1>
+  <p style="color: #6b7280; font-size: 0.875rem;">You can close this tab and return to the CLI.</p>
+</div>
+</body>
+</html>`;
+function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+const ERROR_HTML = (msg) => `<!DOCTYPE html>
+<html>
+<head><title>Agentled CLI</title></head>
+<body style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; display: flex; justify-content: center; align-items: center; min-height: 100vh; margin: 0; background: #f9fafb;">
+<div style="text-align: center; padding: 2rem;">
+  <h1 style="font-size: 1.25rem; font-weight: 600; color: #991b1b;">Authentication Failed</h1>
+  <p style="color: #6b7280; font-size: 0.875rem;">${escapeHtml(msg)}</p>
+</div>
+</body>
+</html>`;
+/**
+ * Run the browser-based login flow.
+ */
+export async function browserLogin(baseUrl) {
+    const state = crypto.randomBytes(16).toString('hex');
+    const port = await findFreePort(PORT_RANGE_START, PORT_RANGE_END);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const server = http.createServer(async (req, res) => {
+            if (settled)
+                return;
+            const parsed = new URL(req.url || '', `http://127.0.0.1:${port}`);
+            if (parsed.pathname !== '/callback') {
+                res.writeHead(404);
+                res.end('Not found');
+                return;
+            }
+            const callbackState = parsed.searchParams.get('state') || '';
+            const code = parsed.searchParams.get('code') || '';
+            // Verify state (CSRF protection)
+            if (callbackState !== state) {
+                res.writeHead(400, { 'Content-Type': 'text/html' });
+                res.end(ERROR_HTML('State mismatch. Possible CSRF attack.'));
+                return;
+            }
+            if (!code) {
+                res.writeHead(400, { 'Content-Type': 'text/html' });
+                res.end(ERROR_HTML('No authorization code received.'));
+                return;
+            }
+            // Serve success page immediately
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(SUCCESS_HTML);
+            // Exchange code for API key
+            try {
+                const exchangeRes = await fetch(`${baseUrl}/api/cli/exchange`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ code }),
+                });
+                if (!exchangeRes.ok) {
+                    const data = await exchangeRes.json().catch(() => ({}));
+                    throw new Error(data.error || `HTTP ${exchangeRes.status}`);
+                }
+                const result = await exchangeRes.json();
+                settled = true;
+                cleanup();
+                resolve(result);
+            }
+            catch (err) {
+                settled = true;
+                cleanup();
+                reject(new Error(`Code exchange failed: ${err.message}`));
+            }
+        });
+        // Timeout handler
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                cleanup();
+                reject(new Error('Login timed out. No response from browser within 5 minutes.'));
+            }
+        }, TIMEOUT_MS);
+        function cleanup() {
+            clearTimeout(timer);
+            server.close();
+        }
+        server.listen(port, '127.0.0.1', () => {
+            const authorizeUrl = `${baseUrl}/en/cli/authorize?port=${port}&state=${encodeURIComponent(state)}`;
+            console.error(`Opening browser to authenticate...`);
+            console.error(`If the browser doesn't open, visit:\n  ${authorizeUrl}\n`);
+            openBrowser(authorizeUrl);
+        });
+        server.on('error', (err) => {
+            if (!settled) {
+                settled = true;
+                reject(new Error(`Failed to start local server: ${err.message}`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=browser-auth.js.map

package/dist/utils/browser-auth.js.map

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

package/dist/utils/output.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Output formatting utilities.
+ *
+ * Default: JSON (optimized for AI agent parsing)
+ * --format table: Human-readable tables
+ * --format minimal: Compact single-line output for piping
+ */
+export type OutputFormat = 'json' | 'table' | 'minimal';
+export declare function formatOutput(data: any, format?: OutputFormat): string;
+export declare function printOutput(data: any, format?: OutputFormat): void;
+export declare function printError(message: string): void;

package/dist/utils/output.js

@@ -0,0 +1,56 @@
+/**
+ * Output formatting utilities.
+ *
+ * Default: JSON (optimized for AI agent parsing)
+ * --format table: Human-readable tables
+ * --format minimal: Compact single-line output for piping
+ */
+export function formatOutput(data, format = 'json') {
+    switch (format) {
+        case 'json':
+            return JSON.stringify(data, null, 2);
+        case 'minimal':
+            if (Array.isArray(data)) {
+                return data.map(item => {
+                    if (typeof item === 'object' && item !== null) {
+                        return item.id || item.name || JSON.stringify(item);
+                    }
+                    return String(item);
+                }).join('\n');
+            }
+            if (typeof data === 'object' && data !== null) {
+                return Object.entries(data)
+                    .map(([k, v]) => `${k}=${typeof v === 'object' ? JSON.stringify(v) : v}`)
+                    .join('\n');
+            }
+            return String(data);
+        case 'table':
+            if (Array.isArray(data) && data.length > 0) {
+                const keys = Object.keys(data[0]);
+                const widths = keys.map(k => Math.max(k.length, ...data.map(row => String(row[k] ?? '').length)));
+                // Cap column widths
+                const maxWidth = 40;
+                const cappedWidths = widths.map(w => Math.min(w, maxWidth));
+                const header = keys.map((k, i) => k.padEnd(cappedWidths[i])).join('  ');
+                const separator = cappedWidths.map(w => '-'.repeat(w)).join('  ');
+                const rows = data.map(row => keys.map((k, i) => {
+                    const val = String(row[k] ?? '');
+                    return val.length > maxWidth
+                        ? val.slice(0, maxWidth - 3) + '...'
+                        : val.padEnd(cappedWidths[i]);
+                }).join('  '));
+                return [header, separator, ...rows].join('\n');
+            }
+            return formatOutput(data, 'json');
+        default:
+            return JSON.stringify(data, null, 2);
+    }
+}
+export function printOutput(data, format = 'json') {
+    console.log(formatOutput(data, format));
+}
+export function printError(message) {
+    console.error(`Error: ${message}`);
+    process.exit(1);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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