@orchagent/cli 0.3.117 → 0.3.119

package/dist/commands/index.js

@@ -45,6 +45,7 @@ const metrics_1 = require("./metrics");
 const dag_1 = require("./dag");
 const completion_1 = require("./completion");
 const validate_1 = require("./validate");
+const storage_1 = require("./storage");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, logout_1.registerLogoutCommand)(program);
@@ -90,4 +91,5 @@ function registerCommands(program) {
     (0, dag_1.registerDagCommand)(program);
     (0, completion_1.registerCompletionCommand)(program);
     (0, validate_1.registerValidateCommand)(program);
+    (0, storage_1.registerStorageCommand)(program);
 }

package/dist/commands/storage.js

@@ -0,0 +1,351 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStorageCommand = registerStorageCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+// ============================================
+// HELPERS
+// ============================================
+const NAMESPACE_RE = /^[a-z][a-z0-9-]{0,63}$/;
+const KEY_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/;
+async function resolveWorkspaceId(config, slug) {
+    const configFile = await (0, config_1.loadConfig)();
+    const targetSlug = slug ?? configFile.workspace;
+    const response = await (0, api_1.request)(config, 'GET', '/workspaces');
+    if (targetSlug) {
+        const workspace = response.workspaces.find((w) => w.slug === targetSlug);
+        if (!workspace) {
+            throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+        }
+        return workspace.id;
+    }
+    if (response.workspaces.length === 0) {
+        throw new errors_1.CliError('No workspaces found. Create one with `orch workspace create <name>`.');
+    }
+    if (response.workspaces.length === 1) {
+        return response.workspaces[0].id;
+    }
+    const slugs = response.workspaces.map((w) => w.slug).join(', ');
+    throw new errors_1.CliError(`Multiple workspaces available: ${slugs}\n` +
+        'Specify one with --workspace <slug> or run `orch workspace use <slug>`.');
+}
+function validateNamespace(ns) {
+    if (!NAMESPACE_RE.test(ns)) {
+        throw new errors_1.CliError(`Invalid namespace '${ns}'.\n\n` +
+            'Namespaces must:\n' +
+            '  - Start with a lowercase letter\n' +
+            '  - Be 1-64 chars of lowercase letters, digits, and hyphens\n\n' +
+            'Examples: signals, my-data, competitors');
+    }
+}
+function validateKey(key) {
+    if (!KEY_RE.test(key)) {
+        throw new errors_1.CliError(`Invalid key '${key}'.\n\n` +
+            'Keys must:\n' +
+            '  - Start with a letter or digit\n' +
+            '  - Be 1-256 chars of letters, digits, dots, hyphens, and underscores\n\n' +
+            'Examples: 2026-03-05, config.v2, weekly-report');
+    }
+}
+function formatDate(iso) {
+    if (!iso)
+        return '-';
+    return new Date(iso).toLocaleString();
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+async function readStdin() {
+    if (process.stdin.isTTY) {
+        throw new errors_1.CliError('No JSON value provided.\n\n' +
+            'Usage:\n' +
+            '  orch storage set <ns> <key> \'{"k":"v"}\'      Inline JSON\n' +
+            '  orch storage set <ns> <key> @file.json        Read from file\n' +
+            '  echo \'{"k":"v"}\' | orch storage set <ns> <key> -   Read from stdin\n' +
+            '  cat data.json | orch storage set <ns> <key>   Pipe (implicit stdin)');
+    }
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.from(chunk));
+    }
+    if (!chunks.length) {
+        throw new errors_1.CliError('No data received on stdin.');
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+async function parseJsonArg(arg) {
+    let raw;
+    if (!arg || arg === '-') {
+        // Read from stdin
+        raw = await readStdin();
+    }
+    else if (arg.startsWith('@')) {
+        // Support @file.json and @- syntax
+        const source = arg.slice(1);
+        if (source === '-') {
+            raw = await readStdin();
+        }
+        else {
+            const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+            try {
+                raw = await fs.readFile(source, 'utf-8');
+            }
+            catch (err) {
+                if (err.code === 'ENOENT') {
+                    throw new errors_1.CliError(`File not found: ${source}`);
+                }
+                throw new errors_1.CliError(`Failed to read ${source}: ${err.message}`);
+            }
+        }
+    }
+    else {
+        raw = arg;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new errors_1.CliError('Invalid JSON value.\n\n' +
+            'Pass valid JSON, @file.json, or pipe via stdin:\n' +
+            '  orch storage set signals 2026-03-05 \'{"pending": []}\'\n' +
+            '  orch storage set signals 2026-03-05 @data.json\n' +
+            '  echo \'{"pending": []}\' | orch storage set signals 2026-03-05 -');
+    }
+}
+// ============================================
+// COMMAND REGISTRATION
+// ============================================
+function registerStorageCommand(program) {
+    const storage = program
+        .command('storage')
+        .description('Manage agent storage (persistent shared key-value documents)')
+        .action(() => { storage.help(); });
+    // orch storage list [namespace]
+    storage
+        .command('list [namespace]')
+        .description('List namespaces, or list keys in a namespace')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--limit <n>', 'Max keys to return (default: 100)', '100')
+        .option('--cursor <cursor>', 'Pagination cursor from previous response')
+        .option('--json', 'Output as JSON')
+        .action(async (namespace, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const headers = { 'X-Workspace-Id': workspaceId };
+        if (!namespace) {
+            // List namespaces
+            const result = await (0, api_1.request)(config, 'GET', '/storage', { headers });
+            if (options.json) {
+                (0, output_1.printJson)(result);
+                return;
+            }
+            if (result.namespaces.length === 0) {
+                process.stdout.write('No storage namespaces found.\n');
+                process.stdout.write(chalk_1.default.gray('\nCreate one: orch storage set my-namespace my-key \'{"hello": "world"}\'\n'));
+                return;
+            }
+            for (const ns of result.namespaces) {
+                process.stdout.write(`  ${ns}\n`);
+            }
+            process.stdout.write(chalk_1.default.gray(`\n${result.namespaces.length} namespace(s)\n`));
+        }
+        else {
+            // List keys in namespace
+            validateNamespace(namespace);
+            const limit = parseInt(options.limit ?? '100', 10);
+            let path = `/storage/${namespace}?limit=${limit}`;
+            if (options.cursor)
+                path += `&cursor=${encodeURIComponent(options.cursor)}`;
+            const result = await (0, api_1.request)(config, 'GET', path, { headers });
+            if (options.json) {
+                (0, output_1.printJson)(result);
+                return;
+            }
+            if (result.keys.length === 0) {
+                process.stdout.write(`No keys found in namespace '${namespace}'.\n`);
+                return;
+            }
+            for (const key of result.keys) {
+                process.stdout.write(`  ${key}\n`);
+            }
+            const countText = `${result.keys.length} key(s)`;
+            process.stdout.write(chalk_1.default.gray(`\n${countText}`));
+            if (result.has_more) {
+                process.stdout.write(chalk_1.default.gray(` (more available, use --cursor "${result.cursor}")`));
+            }
+            process.stdout.write('\n');
+        }
+    });
+    // orch storage get <namespace> <key>
+    storage
+        .command('get <namespace> <key>')
+        .description('Get a document by namespace and key')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--json', 'Output as JSON (full response with metadata)')
+        .option('--raw', 'Output only the value (no metadata)')
+        .action(async (namespace, key, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        validateNamespace(namespace);
+        validateKey(key);
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const result = await (0, api_1.request)(config, 'GET', `/storage/${namespace}/${key}`, { headers: { 'X-Workspace-Id': workspaceId } });
+        if (options.raw) {
+            process.stdout.write(JSON.stringify(result.value, null, 2) + '\n');
+            return;
+        }
+        if (options.json) {
+            (0, output_1.printJson)(result);
+            return;
+        }
+        // Pretty output
+        process.stdout.write(chalk_1.default.gray(`namespace: ${result.namespace}  key: ${result.key}  `) +
+            chalk_1.default.gray(`v${result.version}  ${formatBytes(result.size_bytes)}  `) +
+            chalk_1.default.gray(`updated: ${formatDate(result.updated_at)} by ${result.updated_by}\n\n`));
+        process.stdout.write(JSON.stringify(result.value, null, 2) + '\n');
+    });
+    // orch storage set <namespace> <key> [value]
+    storage
+        .command('set <namespace> <key> [value]')
+        .description('Create or update a document (JSON string, @file.json, or - for stdin)')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--version <n>', 'Expected version for compare-and-swap (CAS)')
+        .action(async (namespace, key, value, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        validateNamespace(namespace);
+        validateKey(key);
+        const parsed = await parseJsonArg(value);
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const headers = {
+            'X-Workspace-Id': workspaceId,
+            'X-Orchagent-Client': 'cli',
+            'Content-Type': 'application/json',
+        };
+        if (options.version) {
+            headers['If-Match'] = options.version;
+        }
+        const result = await (0, api_1.request)(config, 'PUT', `/storage/${namespace}/${key}`, {
+            body: JSON.stringify(parsed),
+            headers,
+        });
+        process.stdout.write(chalk_1.default.green('\u2713') +
+            ` ${namespace}/${key} ` +
+            chalk_1.default.gray(`v${result.version} (${formatBytes(result.size_bytes)})\n`));
+    });
+    // orch storage patch <namespace> <key> [value]
+    storage
+        .command('patch <namespace> <key> [value]')
+        .description('Merge-patch a document (JSON string, @file.json, or - for stdin)')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .action(async (namespace, key, value, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        validateNamespace(namespace);
+        validateKey(key);
+        const parsed = await parseJsonArg(value);
+        if (typeof parsed !== 'object' || Array.isArray(parsed) || parsed === null) {
+            throw new errors_1.CliError('Patch value must be a JSON object (not array or primitive).');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const result = await (0, api_1.request)(config, 'PATCH', `/storage/${namespace}/${key}`, {
+            body: JSON.stringify(parsed),
+            headers: {
+                'X-Workspace-Id': workspaceId,
+                'X-Orchagent-Client': 'cli',
+                'Content-Type': 'application/json',
+            },
+        });
+        process.stdout.write(chalk_1.default.green('\u2713') +
+            ` Patched ${namespace}/${key} ` +
+            chalk_1.default.gray(`v${result.version} (${formatBytes(result.size_bytes)})\n`));
+    });
+    // orch storage delete <namespace> [key]
+    storage
+        .command('delete <namespace> [key]')
+        .description('Delete a document, or all documents in a namespace (with --all)')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--all', 'Delete all documents in the namespace')
+        .action(async (namespace, key, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        validateNamespace(namespace);
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const headers = {
+            'X-Workspace-Id': workspaceId,
+            'X-Orchagent-Client': 'cli',
+        };
+        if (options.all) {
+            // Delete entire namespace
+            const result = await (0, api_1.request)(config, 'DELETE', `/storage/${namespace}`, { headers });
+            process.stdout.write(chalk_1.default.green('\u2713') +
+                ` Deleted namespace '${namespace}' (${result.documents_deleted ?? 0} document(s))\n`);
+        }
+        else if (key) {
+            // Delete single document
+            validateKey(key);
+            await (0, api_1.request)(config, 'DELETE', `/storage/${namespace}/${key}`, { headers });
+            process.stdout.write(chalk_1.default.green('\u2713') + ` Deleted ${namespace}/${key}\n`);
+        }
+        else {
+            throw new errors_1.CliError('Specify a key to delete, or use --all to delete the entire namespace.\n\n' +
+                'Examples:\n' +
+                `  orch storage delete ${namespace} my-key\n` +
+                `  orch storage delete ${namespace} --all`);
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.3.117",
+  "version": "0.3.119",
   "description": "Command-line interface for orchagent — deploy and run AI agents for your team",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",