@orchagent/cli 0.3.56 → 0.3.57

package/dist/commands/fork.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerForkCommand = registerForkCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const agent_ref_1 = require("../lib/agent-ref");
+const errors_1 = require("../lib/errors");
+const analytics_1 = require("../lib/analytics");
+const output_1 = require("../lib/output");
+function getWorkspaceAuthError(err) {
+    if (!(err instanceof api_1.ApiError) || (err.status !== 401 && err.status !== 403)) {
+        return null;
+    }
+    const message = err.message.toLowerCase();
+    if (message.includes('workspace targeting') ||
+        message.includes('specified workspace') ||
+        message.includes('user authentication') ||
+        message.includes('clerk')) {
+        return new errors_1.CliError('Forking into a specific workspace requires a user session key. Run `orch login` (browser sign-in, without `--key`) and retry.');
+    }
+    return null;
+}
+async function resolveWorkspace(config, workspaceSlug) {
+    const response = await (0, api_1.request)(config, 'GET', '/workspaces');
+    const workspace = response.workspaces.find((w) => w.slug === workspaceSlug);
+    if (!workspace) {
+        throw new errors_1.CliError(`Workspace '${workspaceSlug}' not found. Run \`orchagent workspace list\` to see available workspaces.`);
+    }
+    return workspace;
+}
+function registerForkCommand(program) {
+    program
+        .command('fork <agent>')
+        .description('Fork a public agent into your workspace')
+        .option('--name <new-name>', 'Rename the forked agent')
+        .option('-w, --workspace <workspace-slug>', 'Target workspace slug')
+        .option('--json', 'Output raw JSON')
+        .addHelpText('after', `
+Examples:
+  orch fork orchagent/my-discord-agent
+  orch fork orchagent/my-discord-agent --workspace acme-corp
+  orch fork orchagent/my-discord-agent --name customer-support-bot
+  orch fork orchagent/my-discord-agent@v2 --json
+`)
+        .action(async (agentRef, options) => {
+        const write = (message) => {
+            if (!options.json)
+                process.stdout.write(message);
+        };
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Not logged in. Run `orchagent login` first.');
+        }
+        const { org, agent, version } = (0, agent_ref_1.parseAgentRef)(agentRef);
+        write('Resolving source agent...\n');
+        const source = await (0, api_1.getPublicAgent)(config, org, agent, version);
+        if (!source.id) {
+            throw new errors_1.CliError(`Could not resolve source agent ID for '${org}/${agent}@${version}'.`);
+        }
+        let targetWorkspace = null;
+        if (options.workspace) {
+            write('Resolving target workspace...\n');
+            targetWorkspace = await resolveWorkspace(config, options.workspace);
+        }
+        write('Forking agent...\n');
+        const payload = {};
+        if (targetWorkspace)
+            payload.workspace_id = targetWorkspace.id;
+        const requestedName = options.name?.trim();
+        if (requestedName)
+            payload.new_name = requestedName;
+        let result;
+        try {
+            result = await (0, api_1.forkAgent)(config, source.id, payload);
+        }
+        catch (err) {
+            const authErr = getWorkspaceAuthError(err);
+            if (authErr)
+                throw authErr;
+            throw err;
+        }
+        await (0, analytics_1.track)('cli_fork', {
+            source_org: org,
+            source_agent: agent,
+            source_version: version,
+            target_workspace: targetWorkspace?.slug ?? null,
+        });
+        if (options.json) {
+            (0, output_1.printJson)(result);
+            return;
+        }
+        const forked = result.agent;
+        const targetOrgSlug = forked.org_slug ?? targetWorkspace?.slug ?? 'current-workspace';
+        write(`\n${chalk_1.default.green('\u2713')} Forked ${org}/${agent}@${version}\n`);
+        write(`  New agent: ${targetOrgSlug}/${forked.name}@${forked.version}\n`);
+        if (targetWorkspace) {
+            write(`  Workspace: ${targetWorkspace.name} (${targetWorkspace.slug})\n`);
+        }
+        if (result.service_key) {
+            write(`\nService key (save this - shown only once):\n`);
+            write(`  ${result.service_key}\n`);
+        }
+    });
+}

package/dist/commands/index.js

@@ -12,6 +12,7 @@ const run_1 = require("./run");
 const info_1 = require("./info");
 const skill_1 = require("./skill");
 const delete_1 = require("./delete");
+const fork_1 = require("./fork");
 const github_1 = require("./github");
 const doctor_1 = require("./doctor");
 const status_1 = require("./status");
@@ -43,6 +44,7 @@ function registerCommands(program) {
     (0, keys_1.registerKeysCommand)(program);
     (0, skill_1.registerSkillCommand)(program);
     (0, delete_1.registerDeleteCommand)(program);
+    (0, fork_1.registerForkCommand)(program);
     (0, github_1.registerGitHubCommand)(program);
     (0, doctor_1.registerDoctorCommand)(program);
     (0, status_1.registerStatusCommand)(program);

package/dist/index.js

@@ -61,6 +61,7 @@ program
 Quick Reference:
   run   Run an agent (cloud by default, --local for local execution)
   info  Show agent details and input/output schemas
+  fork  Fork a public template into your workspace
 
 Installation:
   npm install -g @orchagent/cli   Install globally (then use: orch)

package/dist/lib/api.js

@@ -54,6 +54,7 @@ exports.getAgentWithFallback = getAgentWithFallback;
 exports.downloadCodeBundleAuthenticated = downloadCodeBundleAuthenticated;
 exports.checkAgentDelete = checkAgentDelete;
 exports.deleteAgent = deleteAgent;
+exports.forkAgent = forkAgent;
 exports.checkAgentTransfer = checkAgentTransfer;
 exports.transferAgent = transferAgent;
 exports.previewAgentVersion = previewAgentVersion;
@@ -368,6 +369,15 @@ async function deleteAgent(config, agentId, confirmationName) {
     const params = confirmationName ? `?confirmation_name=${encodeURIComponent(confirmationName)}` : '';
     return request(config, 'DELETE', `/agents/${agentId}${params}`);
 }
+/**
+ * Fork a public agent into the caller's workspace (or an explicit workspace_id).
+ */
+async function forkAgent(config, sourceAgentId, data = {}) {
+    return request(config, 'POST', `/agents/${sourceAgentId}/fork`, {
+        body: JSON.stringify(data),
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
 /**
  * Check if an agent can be transferred to another workspace.
  */

package/package.json

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