@orchagent/cli 0.3.99 → 0.3.100

package/dist/commands/agent-keys.js

@@ -28,7 +28,7 @@ async function resolveAgentId(config, ref) {
     }
     // Use the latest version
     const latest = matching.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime())[0];
-    return { agent: latest, agentId: latest.id, orgSlug: latest.org_slug ?? resolvedOrg ?? '' };
+    return { agent: latest, agentId: latest.id, orgSlug: latest.org_slug ?? resolvedOrg ?? '', workspaceId };
 }
 function registerAgentKeysCommand(program) {
     const agentKeys = program
@@ -42,8 +42,8 @@ function registerAgentKeysCommand(program) {
         if (!config.apiKey) {
             throw new errors_1.CliError('Missing API key. Run `orchagent login` first.');
         }
-        const { agent, agentId, orgSlug } = await resolveAgentId(config, ref);
-        const result = await (0, api_1.listAgentKeys)(config, agentId);
+        const { agent, agentId, orgSlug, workspaceId } = await resolveAgentId(config, ref);
+        const result = await (0, api_1.listAgentKeys)(config, agentId, workspaceId);
         // Load locally-saved keys for this agent
         const localKeys = await (0, key_store_1.loadServiceKeys)(orgSlug, agent.name);
         const localPrefixes = new Set(localKeys.map(k => k.prefix));
@@ -76,8 +76,8 @@ function registerAgentKeysCommand(program) {
         if (!config.apiKey) {
             throw new errors_1.CliError('Missing API key. Run `orchagent login` first.');
         }
-        const { agent, orgSlug } = await resolveAgentId(config, ref);
-        const result = await (0, api_1.createAgentKey)(config, agent.id);
+        const { agent, orgSlug, workspaceId } = await resolveAgentId(config, ref);
+        const result = await (0, api_1.createAgentKey)(config, agent.id, workspaceId);
         process.stdout.write(`\nNew service key for ${agent.name}:\n\n`);
         process.stdout.write(`  ${result.key}\n\n`);
         try {
@@ -96,8 +96,8 @@ function registerAgentKeysCommand(program) {
         if (!config.apiKey) {
             throw new errors_1.CliError('Missing API key. Run `orchagent login` first.');
         }
-        const { agent, agentId } = await resolveAgentId(config, ref);
-        await (0, api_1.deleteAgentKey)(config, agentId, keyId);
+        const { agent, agentId, workspaceId } = await resolveAgentId(config, ref);
+        await (0, api_1.deleteAgentKey)(config, agentId, keyId, workspaceId);
         process.stdout.write(`Deleted key ${keyId} from ${agent.name}.\n`);
     });
 }

package/dist/commands/estimate.js

@@ -43,9 +43,10 @@ function registerEstimateCommand(program) {
             process.exit(1);
         }
         const { agent, version } = parsed;
+        const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(config, org);
         let data;
         try {
-            data = await (0, api_1.getAgentCostEstimate)(config, org, agent, version);
+            data = await (0, api_1.getAgentCostEstimate)(config, org, agent, version, workspaceId);
         }
         catch (err) {
             if (err instanceof api_1.ApiError && err.status === 404) {

package/dist/commands/init.js

@@ -412,7 +412,8 @@ import asyncio
 import json
 import sys
 
-from orchagent import AgentClient
+# pip install orchagent-sdk  (package name)
+from orchagent import AgentClient  # module name
 
 
 async def run():
@@ -503,7 +504,8 @@ import asyncio
 import json
 import sys
 
-from orchagent import AgentClient
+# pip install orchagent-sdk  (package name)
+from orchagent import AgentClient  # module name
 
 
 async def run():
@@ -589,7 +591,8 @@ import asyncio
 import json
 import sys
 
-from orchagent import AgentClient
+# pip install orchagent-sdk  (package name)
+from orchagent import AgentClient  # module name
 
 
 async def run():
@@ -1207,7 +1210,8 @@ import asyncio
 import json
 import sys
 
-from orchagent import AgentClient
+# pip install orchagent-sdk  (package name)
+from orchagent import AgentClient  # module name
 
 
 def main():

package/dist/commands/pull.js

@@ -292,7 +292,7 @@ function buildManifest(data) {
     return manifest;
 }
 // ─── Bundle Download + Extraction ───────────────────────────────────────────
-async function downloadBundle(config, org, agent, version, agentId) {
+async function downloadBundle(config, org, agent, version, agentId, workspaceId) {
     try {
         return await (0, api_1.downloadCodeBundle)(config, org, agent, version);
     }
@@ -305,7 +305,7 @@ async function downloadBundle(config, org, agent, version, agentId) {
     }
     if (config.apiKey && agentId) {
         try {
-            return await (0, api_1.downloadCodeBundleAuthenticated)(config, agentId);
+            return await (0, api_1.downloadCodeBundleAuthenticated)(config, agentId, workspaceId);
         }
         catch (err) {
             if (!(err instanceof api_1.ApiError) || err.status !== 404)
@@ -411,7 +411,7 @@ Examples:
         // and exit-code 1.
         if (engine === 'code_runtime' && data.has_bundle) {
             write('Downloading code bundle...\n');
-            const bundle = await downloadBundle(config, org, data.name, data.version, data.agentId);
+            const bundle = await downloadBundle(config, org, data.name, data.version, data.agentId, workspaceId);
             if (bundle) {
                 const tempDir = path_1.default.join(os_1.default.tmpdir(), `orchagent-pull-${Date.now()}`);
                 const zipPath = path_1.default.join(tempDir, 'bundle.zip');

package/dist/commands/run.js

@@ -656,7 +656,7 @@ async function downloadAgent(config, org, agent, version, workspaceId) {
         entrypoint: targetAgent.entrypoint,
     };
 }
-async function downloadBundleWithFallback(config, org, agentName, version, agentId) {
+async function downloadBundleWithFallback(config, org, agentName, version, agentId, workspaceId) {
     try {
         return await (0, api_1.downloadCodeBundle)(config, org, agentName, version);
     }
@@ -667,7 +667,7 @@ async function downloadBundleWithFallback(config, org, agentName, version, agent
     if (!config.apiKey || !agentId) {
         throw new api_1.ApiError(`Bundle for '${org}/${agentName}@${version}' not found`, 404);
     }
-    return await (0, api_1.downloadCodeBundleAuthenticated)(config, agentId);
+    return await (0, api_1.downloadCodeBundleAuthenticated)(config, agentId, workspaceId);
 }
 async function checkDependencies(config, dependencies) {
     const results = [];
@@ -738,7 +738,7 @@ async function downloadSkillDependency(config, ref, defaultOrg) {
     const skillData = await (0, api_1.publicRequest)(config, `/public/agents/${org}/${parsed.skill}/${parsed.version}/download`);
     await saveAgentLocally(org, parsed.skill, skillData);
 }
-async function downloadDependenciesRecursively(config, depStatuses, visited = new Set()) {
+async function downloadDependenciesRecursively(config, depStatuses, visited = new Set(), workspaceId) {
     for (const status of depStatuses) {
         if (!status.downloadable || !status.agentData)
             continue;
@@ -750,7 +750,7 @@ async function downloadDependenciesRecursively(config, depStatuses, visited = ne
         await (0, spinner_1.withSpinner)(`Downloading dependency: ${depRef}...`, async () => {
             await saveAgentLocally(org, agent, status.agentData);
             if (status.agentData.has_bundle) {
-                await saveBundleLocally(config, org, agent, status.dep.version, status.agentData.id);
+                await saveBundleLocally(config, org, agent, status.dep.version, status.agentData.id, workspaceId);
             }
             if (resolveExecutionEngine(status.agentData) === 'code_runtime' && (status.agentData.source_url || status.agentData.pip_package)) {
                 await installTool(status.agentData);
@@ -767,7 +767,7 @@ async function downloadDependenciesRecursively(config, depStatuses, visited = ne
         }
         if (status.agentData.dependencies && status.agentData.dependencies.length > 0) {
             const nestedStatuses = await checkDependencies(config, status.agentData.dependencies);
-            await downloadDependenciesRecursively(config, nestedStatuses, visited);
+            await downloadDependenciesRecursively(config, nestedStatuses, visited, workspaceId);
         }
     }
 }
@@ -1168,7 +1168,7 @@ async function unzipBundle(zipPath, destDir) {
         });
     });
 }
-async function executeBundleAgent(config, org, agentName, version, agentData, args, inputOption) {
+async function executeBundleAgent(config, org, agentName, version, agentData, args, inputOption, workspaceId) {
     const userCwd = process.cwd();
     const tempDir = path_1.default.join(os_1.default.tmpdir(), `orchagent-${agentName}-${Date.now()}`);
     await promises_1.default.mkdir(tempDir, { recursive: true });
@@ -1176,7 +1176,7 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
     const extractDir = path_1.default.join(tempDir, 'agent');
     try {
         const bundleBuffer = await (0, spinner_1.withSpinner)(`Downloading ${org}/${agentName}@${version} bundle...`, async () => {
-            const buffer = await downloadBundleWithFallback(config, org, agentName, version, agentData.id);
+            const buffer = await downloadBundleWithFallback(config, org, agentName, version, agentData.id, workspaceId);
             await promises_1.default.writeFile(bundleZip, buffer);
             return buffer;
         }, { successText: (buf) => `Downloaded bundle (${buf.length} bytes)` });
@@ -1391,7 +1391,7 @@ async function saveAgentLocally(org, agent, agentData) {
     }
     return agentDir;
 }
-async function saveBundleLocally(config, org, agent, version, agentId) {
+async function saveBundleLocally(config, org, agent, version, agentId, workspaceId) {
     const agentDir = path_1.default.join(AGENTS_DIR, org, agent);
     const bundleDir = path_1.default.join(agentDir, 'bundle');
     const metaPath = path_1.default.join(agentDir, 'agent.json');
@@ -1411,7 +1411,7 @@ async function saveBundleLocally(config, org, agent, version, agentId) {
     catch {
         // Metadata doesn't exist, need to download
     }
-    const bundleBuffer = await (0, spinner_1.withSpinner)(`Downloading bundle for ${org}/${agent}@${version}...`, async () => downloadBundleWithFallback(config, org, agent, version, agentId), { successText: `Downloaded bundle for ${org}/${agent}@${version}` });
+    const bundleBuffer = await (0, spinner_1.withSpinner)(`Downloading bundle for ${org}/${agent}@${version}...`, async () => downloadBundleWithFallback(config, org, agent, version, agentId, workspaceId), { successText: `Downloaded bundle for ${org}/${agent}@${version}` });
     const tempZip = path_1.default.join(os_1.default.tmpdir(), `bundle-${Date.now()}.zip`);
     await promises_1.default.writeFile(tempZip, bundleBuffer);
     try {
@@ -2764,7 +2764,7 @@ async function executeLocal(agentRef, args, options) {
             process.stderr.write(`  orch run ${org}/${parsed.agent}@${parsed.version} --data '{...}'\n\n`);
             process.exit(0);
         }
-        await downloadDependenciesRecursively(resolved, depStatuses);
+        await downloadDependenciesRecursively(resolved, depStatuses, new Set(), workspaceId);
     }
     // Check if user is overriding locked skills
     const agentSkillsLocked = agentData.skills_locked;
@@ -2806,7 +2806,7 @@ async function executeLocal(agentRef, args, options) {
                 });
                 bundleInput = injected.body;
             }
-            await executeBundleAgent(resolved, org, parsed.agent, parsed.version, agentData, args, bundleInput);
+            await executeBundleAgent(resolved, org, parsed.agent, parsed.version, agentData, args, bundleInput, workspaceId);
             return;
         }
         if (agentData.run_command && (agentData.source_url || agentData.pip_package)) {

package/dist/commands/security.js

@@ -196,6 +196,8 @@ Examples:
             throw new errors_1.CliError('Missing org. Use org/agent or set default org.');
         }
         const agentId = `${org}/${parsed.agent}/${parsed.version}`;
+        // Resolve workspace context for the target org
+        const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(resolved, org);
         // Detect LLM key for the scan
         let llmKey;
         let llmProvider;
@@ -208,7 +210,13 @@ Examples:
             llmProvider = options.provider;
         }
         else {
-            const detected = await (0, llm_1.detectLlmKey)(['any'], resolved);
+            // Respect --provider preference when detecting local keys
+            let providersToCheck = ['any'];
+            if (options.provider) {
+                (0, llm_1.validateProvider)(options.provider);
+                providersToCheck = [options.provider];
+            }
+            const detected = await (0, llm_1.detectLlmKey)(providersToCheck, resolved);
             if (detected) {
                 llmKey = detected.key;
                 llmProvider = detected.provider;
@@ -236,6 +244,9 @@ Examples:
             'Content-Type': 'application/json',
             Authorization: `Bearer ${resolved.apiKey}`,
         };
+        if (workspaceId) {
+            headers['X-Workspace-Id'] = workspaceId;
+        }
         if (llmKey) {
             headers['X-LLM-API-Key'] = llmKey;
         }

package/dist/commands/test.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NO_LLM_KEY_FIXTURE_MESSAGE = void 0;
 exports.registerTestCommand = registerTestCommand;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
@@ -18,6 +19,15 @@ const config_1 = require("../lib/config");
 const llm_1 = require("../lib/llm");
 const bundle_1 = require("../lib/bundle");
 const test_mock_runner_1 = require("../lib/test-mock-runner");
+// ─── Constants ────────────────────────────────────────────────────────────────
+exports.NO_LLM_KEY_FIXTURE_MESSAGE = 'No LLM API key found for fixture tests.\n\n' +
+    'Fixture tests run locally on your machine and cannot access workspace vault keys.\n' +
+    'Set a local environment variable:\n\n' +
+    '  export OPENAI_API_KEY=sk-...\n' +
+    '  export ANTHROPIC_API_KEY=sk-ant-...\n' +
+    '  export GEMINI_API_KEY=AI...\n\n' +
+    'Or add it to a .env file in your agent directory.\n\n' +
+    'To run with vault keys instead, use: orch run --cloud';
 // ─── Utility functions ───────────────────────────────────────────────────────
 function validateFixture(data, fixturePath) {
     const fileName = path_1.default.basename(fixturePath);
@@ -511,11 +521,10 @@ async function runPromptFixtureTests(agentDir, fixtures, verbose, config) {
     catch {
         // Schema is optional
     }
-    // Detect LLM key
+    // Detect LLM key — fixture tests run locally, so vault keys can't be used
     const detected = await (0, llm_1.detectLlmKey)(['any'], config);
     if (!detected) {
-        throw new errors_1.CliError('No LLM key found for fixture tests.\n' +
-            'Set an environment variable (e.g., OPENAI_API_KEY) or run `orch secrets set <PROVIDER>_API_KEY <key>`');
+        throw new errors_1.CliError(exports.NO_LLM_KEY_FIXTURE_MESSAGE);
     }
     const { provider, key, model: serverModel } = detected;
     const model = serverModel ?? (0, llm_1.getDefaultModel)(provider);

package/dist/commands/tree.js

@@ -27,7 +27,9 @@ function registerTreeCommand(program) {
             throw new errors_1.CliError('Missing org. Use org/agent format or set default org.');
         }
         const { agent, version } = parsed;
-        const tree = await (0, api_1.request)(config, 'GET', `/agents/${org}/${agent}/${version}/tree`);
+        // Resolve workspace context for team workspaces
+        const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(config, org);
+        const tree = await (0, api_1.request)(config, 'GET', `/agents/${org}/${agent}/${version}/tree`, ...(workspaceId ? [{ headers: { 'X-Workspace-Id': workspaceId } }] : []));
         if (options.json) {
             console.log(JSON.stringify(tree, null, 2));
             return;

package/dist/lib/api.js

@@ -284,8 +284,14 @@ async function updateOrg(config, payload) {
 async function getPublicAgent(config, org, agent, version) {
     return publicRequest(config, `/public/agents/${org}/${agent}/${version}`);
 }
-async function getAgentCostEstimate(config, org, agent, version) {
-    return publicRequest(config, `/public/agents/${org}/${agent}/${version}/cost-estimate`);
+async function getAgentCostEstimate(config, org, agent, version, workspaceId) {
+    const path = `/public/agents/${org}/${agent}/${version}/cost-estimate`;
+    if (workspaceId && config.apiKey) {
+        return request(config, 'GET', path, {
+            headers: { 'X-Workspace-Id': workspaceId },
+        });
+    }
+    return publicRequest(config, path);
 }
 async function listMyAgents(config, workspaceId) {
     const headers = {};
@@ -402,15 +408,16 @@ async function resolveWorkspaceIdForOrg(config, orgSlug) {
 /**
  * Download a tool bundle for a private agent using authenticated endpoint.
  */
-async function downloadCodeBundleAuthenticated(config, agentId) {
+async function downloadCodeBundleAuthenticated(config, agentId, workspaceId) {
     if (!config.apiKey) {
         throw new ApiError('Missing API key for authenticated bundle download', 401);
     }
-    const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/bundle`, {
-        headers: {
-            Authorization: `Bearer ${config.apiKey}`,
-        },
-    });
+    const headers = {
+        Authorization: `Bearer ${config.apiKey}`,
+    };
+    if (workspaceId)
+        headers['X-Workspace-Id'] = workspaceId;
+    const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/bundle`, { headers });
     if (!response.ok) {
         const text = await response.text();
         let message = response.statusText;
@@ -548,12 +555,21 @@ async function setWorkspaceDefaultEnvironment(config, workspaceId, environmentId
         headers: { 'Content-Type': 'application/json' },
     });
 }
-async function listAgentKeys(config, agentId) {
-    return request(config, 'GET', `/agents/${agentId}/keys`);
+async function listAgentKeys(config, agentId, workspaceId) {
+    const headers = {};
+    if (workspaceId)
+        headers['X-Workspace-Id'] = workspaceId;
+    return request(config, 'GET', `/agents/${agentId}/keys`, { headers });
 }
-async function createAgentKey(config, agentId) {
-    return request(config, 'POST', `/agents/${agentId}/keys`);
+async function createAgentKey(config, agentId, workspaceId) {
+    const headers = {};
+    if (workspaceId)
+        headers['X-Workspace-Id'] = workspaceId;
+    return request(config, 'POST', `/agents/${agentId}/keys`, { headers });
 }
-async function deleteAgentKey(config, agentId, keyId) {
-    return request(config, 'DELETE', `/agents/${agentId}/keys/${keyId}`);
+async function deleteAgentKey(config, agentId, keyId, workspaceId) {
+    const headers = {};
+    if (workspaceId)
+        headers['X-Workspace-Id'] = workspaceId;
+    return request(config, 'DELETE', `/agents/${agentId}/keys/${keyId}`, { headers });
 }

package/package.json

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