@orchagent/cli 0.3.42 → 0.3.44

package/dist/commands/init.js

@@ -46,10 +46,10 @@ const SCHEMA_TEMPLATE = `{
 }
 `;
 const CODE_TEMPLATE_PY = `"""
-orchagent code agent entrypoint.
+orchagent tool entrypoint.
 
 Reads JSON input from stdin, processes it, and writes JSON output to stdout.
-This is the standard orchagent code agent protocol.
+This is the standard orchagent tool protocol.
 
 Usage:
   echo '{"input": "hello"}' | python main.py
@@ -82,35 +82,35 @@ if __name__ == "__main__":
     main()
 `;
 function readmeTemplate(agentName, type) {
-    const callExample = type === 'code'
-        ? `orchagent call ${agentName} input-file.txt`
-        : `orchagent call ${agentName} --data '{"${type === 'agentic' ? 'task' : 'input'}": "Hello world"}'`;
-    const runExample = type === 'code'
-        ? `orchagent run ${agentName} --input '{"file_path": "src/app.py"}'`
-        : `orchagent run ${agentName} --input '{"${type === 'agentic' ? 'task' : 'input'}": "Hello world"}'`;
+    const cloudExample = type === 'tool'
+        ? `orchagent run ${agentName} input-file.txt`
+        : `orchagent run ${agentName} --data '{"${type === 'agent' ? 'task' : 'input'}": "Hello world"}'`;
+    const localExample = type === 'tool'
+        ? `orchagent run ${agentName} --local --data '{"file_path": "src/app.py"}'`
+        : `orchagent run ${agentName} --local --data '{"${type === 'agent' ? 'task' : 'input'}": "Hello world"}'`;
     return `# ${agentName}
 
 A brief description of what this agent does.
 
 ## Usage
 
-### Server execution
+### Cloud execution (default)
 
 \`\`\`sh
-${callExample}
+${cloudExample}
 \`\`\`
 
 ### Local execution
 
 \`\`\`sh
-${runExample}
+${localExample}
 \`\`\`
 
 ## Input
 
 | Field | Type | Description |
 |-------|------|-------------|
-| \`${type === 'agentic' ? 'task' : 'input'}\` | string | ${type === 'agentic' ? 'The task to perform' : 'The input to process'} |
+| \`${type === 'agent' ? 'task' : 'input'}\` | string | ${type === 'agent' ? 'The task to perform' : 'The input to process'} |
 
 ## Output
 
@@ -119,10 +119,10 @@ ${runExample}
 | \`result\` | string | The agent's response |
 `;
 }
-const AGENTIC_MANIFEST_TEMPLATE = `{
+const AGENT_MANIFEST_TEMPLATE = `{
   "name": "my-agent",
-  "description": "An agentic AI agent with tool use",
-  "type": "agentic",
+  "description": "An AI agent with tool use",
+  "type": "agent",
   "supported_providers": ["anthropic"],
   "max_turns": 25,
   "custom_tools": [
@@ -134,7 +134,7 @@ const AGENTIC_MANIFEST_TEMPLATE = `{
   ]
 }
 `;
-const AGENTIC_PROMPT_TEMPLATE = `You are a helpful AI agent with access to a sandboxed environment.
+const AGENT_PROMPT_TEMPLATE = `You are a helpful AI agent with access to a sandboxed environment.
 
 Given the input, complete the task using the available tools:
 - Use bash to run commands
@@ -146,7 +146,7 @@ Input: The caller's input will be provided as JSON.
 
 Work step by step, verify your results, and submit the final output.
 `;
-const AGENTIC_SCHEMA_TEMPLATE = `{
+const AGENT_SCHEMA_TEMPLATE = `{
   "input": {
     "type": "object",
     "properties": {
@@ -188,7 +188,7 @@ function registerInitCommand(program) {
         .command('init')
         .description('Initialize a new agent project')
         .argument('[name]', 'Agent name (default: current directory name)')
-        .option('--type <type>', 'Type: prompt, code, agentic, or skill (default: prompt)', 'prompt')
+        .option('--type <type>', 'Type: prompt, tool, agent, or skill (default: prompt)', 'prompt')
         .action(async (name, options) => {
         const cwd = process.cwd();
         // When a name is provided, create a subdirectory for the project
@@ -242,20 +242,20 @@ function registerInitCommand(program) {
             }
         }
         // Create manifest and type-specific files
-        if (options.type === 'agentic') {
-            const manifest = JSON.parse(AGENTIC_MANIFEST_TEMPLATE);
+        if (options.type === 'agent') {
+            const manifest = JSON.parse(AGENT_MANIFEST_TEMPLATE);
             manifest.name = agentName;
             await promises_1.default.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
-            await promises_1.default.writeFile(promptPath, AGENTIC_PROMPT_TEMPLATE);
-            await promises_1.default.writeFile(schemaPath, AGENTIC_SCHEMA_TEMPLATE);
+            await promises_1.default.writeFile(promptPath, AGENT_PROMPT_TEMPLATE);
+            await promises_1.default.writeFile(schemaPath, AGENT_SCHEMA_TEMPLATE);
         }
         else {
             const manifest = JSON.parse(MANIFEST_TEMPLATE);
             manifest.name = agentName;
-            manifest.type = ['code', 'skill'].includes(options.type) ? options.type : 'prompt';
+            manifest.type = ['tool', 'skill'].includes(options.type) ? options.type : 'prompt';
             await promises_1.default.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
-            // Create prompt template (for prompt-based agents) or entrypoint (for code agents)
-            if (options.type === 'code') {
+            // Create prompt template (for prompt-based agents) or entrypoint (for tool agents)
+            if (options.type === 'tool') {
                 const entrypointPath = path_1.default.join(targetDir, 'main.py');
                 await promises_1.default.writeFile(entrypointPath, CODE_TEMPLATE_PY);
             }
@@ -272,7 +272,7 @@ function registerInitCommand(program) {
         process.stdout.write(`\nFiles created:\n`);
         const prefix = name ? name + '/' : '';
         process.stdout.write(`  ${prefix}orchagent.json - Agent configuration\n`);
-        if (options.type === 'code') {
+        if (options.type === 'tool') {
             process.stdout.write(`  ${prefix}main.py        - Agent entrypoint (stdin/stdout JSON)\n`);
         }
         else {
@@ -281,7 +281,7 @@ function registerInitCommand(program) {
         process.stdout.write(`  ${prefix}schema.json    - Input/output schemas\n`);
         process.stdout.write(`  ${prefix}README.md      - Agent documentation\n`);
         process.stdout.write(`\nNext steps:\n`);
-        if (options.type === 'agentic') {
+        if (options.type === 'agent') {
             const stepNum = name ? 2 : 1;
             if (name) {
                 process.stdout.write(`  1. cd ${name}\n`);
@@ -291,7 +291,7 @@ function registerInitCommand(program) {
             process.stdout.write(`  ${stepNum + 2}. Edit schema.json with your input/output schemas\n`);
             process.stdout.write(`  ${stepNum + 3}. Run: orchagent publish\n`);
         }
-        else if (options.type !== 'code') {
+        else if (options.type !== 'tool') {
             const stepNum = name ? 2 : 1;
             if (name) {
                 process.stdout.write(`  1. cd ${name}\n`);

package/dist/commands/install.js

@@ -76,14 +76,14 @@ async function downloadAgentWithFallback(config, org, name, version) {
                 // Non-owner - block with helpful message
                 const price = (0, pricing_1.formatPrice)(publicMeta);
                 throw new errors_1.CliError(`This agent is paid (${price}) and runs on server only.\n\n` +
-                    `Use: orch call ${org}/${name}@${version} --input '{...}'`);
+                    `Use: orch run ${org}/${name}@${version} --data '{...}'`);
             }
         }
         else {
             // Not authenticated - block
             const price = (0, pricing_1.formatPrice)(publicMeta);
             throw new errors_1.CliError(`This agent is paid (${price}) and runs on server only.\n\n` +
-                `Use: orch call ${org}/${name}@${version} --input '{...}'`);
+                `Use: orch run ${org}/${name}@${version} --data '{...}'`);
         }
     }
     // Check if download is disabled (server-only agent)
@@ -115,7 +115,7 @@ async function downloadAgentWithFallback(config, org, name, version) {
             }
         }
         throw new errors_1.CliError(`This agent is server-only and cannot be downloaded.\n\n` +
-            `Use: orch call ${org}/${name}@${version} --input '{...}'`);
+            `Use: orch run ${org}/${name}@${version} --data '{...}'`);
     }
     // Free agent - proceed normally with public data
     if (publicMeta) {
@@ -161,7 +161,7 @@ function registerInstallCommand(program) {
         .option('--json', 'Output result as JSON (for automation/tooling)')
         .addHelpText('after', `
 Note: Paid agents cannot be installed locally - they run on server only.
-      Use 'orch call' to execute paid agents.
+      Use 'orch run' to execute paid agents.
 `)
         .action(async (agentArg, options) => {
         const jsonMode = options.json === true;

package/dist/commands/pricing.js

@@ -13,7 +13,7 @@ function registerPricingCommand(program) {
         .command('pricing <agent> <mode>')
         .description('Set pricing for your agent (free or per-call in USD)')
         .option('--local-download', 'Allow users to download and run locally')
-        .option('--no-local-download', 'Restrict to server-only (orch call)')
+        .option('--no-local-download', 'Restrict to server-only (cloud execution)')
         .action(async (agentRef, mode, options) => {
         const resolved = await (0, config_1.getResolvedConfig)();
         // Parse agent reference

package/dist/commands/publish.js

@@ -317,7 +317,7 @@ function registerPublishCommand(program) {
                 `These must be nested under a "manifest" key. Example:\n\n` +
                 `  {\n` +
                 `    "name": "${manifest.name}",\n` +
-                `    "type": "${manifest.type || 'code'}",\n` +
+                `    "type": "${manifest.type || 'tool'}",\n` +
                 `    "manifest": {\n` +
                 `      "manifest_version": 1,\n` +
                 `      "dependencies": [...],\n` +
@@ -328,16 +328,16 @@ function registerPublishCommand(program) {
                 `  }\n\n` +
                 `See docs/manifest.md for details.`);
         }
-        // Read prompt (for prompt-based, agentic, and skill agents)
+        // Read prompt (for prompt-based, agent, and skill agents)
         let prompt;
-        if (manifest.type === 'prompt' || manifest.type === 'skill' || manifest.type === 'agentic') {
+        if (manifest.type === 'prompt' || manifest.type === 'skill' || manifest.type === 'agent') {
             const promptPath = path_1.default.join(cwd, 'prompt.md');
             try {
                 prompt = await promises_1.default.readFile(promptPath, 'utf-8');
             }
             catch (err) {
                 if (err.code === 'ENOENT') {
-                    const agentTypeName = manifest.type === 'skill' ? 'skill' : manifest.type === 'agentic' ? 'agentic agent' : 'prompt-based agent';
+                    const agentTypeName = manifest.type === 'skill' ? 'skill' : manifest.type === 'agent' ? 'agent' : 'prompt-based agent';
                     throw new errors_1.CliError(`No prompt.md found for ${agentTypeName}.\n\n` +
                         'Create a prompt.md file in the current directory with your prompt template.\n' +
                         'See: https://orchagent.io/docs/publishing');
@@ -345,8 +345,8 @@ function registerPublishCommand(program) {
                 throw err;
             }
         }
-        // For agentic agents, validate custom_tools and build manifest
-        if (manifest.type === 'agentic') {
+        // For agent type, validate custom_tools and build manifest
+        if (manifest.type === 'agent') {
             // Validate custom_tools format
             if (manifest.custom_tools) {
                 const reservedNames = new Set(['bash', 'read_file', 'write_file', 'list_files', 'submit_result']);
@@ -372,18 +372,18 @@ function registerPublishCommand(program) {
                     throw new errors_1.CliError('max_turns must be a number between 1 and 50');
                 }
             }
-            // Store agentic config in manifest field
-            const agenticManifest = {
+            // Store agent config in manifest field
+            const agentManifest = {
                 ...(manifest.manifest || {}),
             };
             if (manifest.custom_tools) {
-                agenticManifest.custom_tools = manifest.custom_tools;
+                agentManifest.custom_tools = manifest.custom_tools;
             }
             if (manifest.max_turns) {
-                agenticManifest.max_turns = manifest.max_turns;
+                agentManifest.max_turns = manifest.max_turns;
             }
-            manifest.manifest = agenticManifest;
-            // Agentic agents default to anthropic provider
+            manifest.manifest = agentManifest;
+            // Agent type defaults to anthropic provider
             if (!manifest.supported_providers) {
                 manifest.supported_providers = ['anthropic'];
             }
@@ -407,7 +407,7 @@ function registerPublishCommand(program) {
             }
         }
         // For prompt/skill agents, derive input schema from template variables if needed
-        // (Agentic agents use schema.json directly — no template variable derivation)
+        // (Agent type uses schema.json directly — no template variable derivation)
         if (prompt && (manifest.type === 'prompt' || manifest.type === 'skill')) {
             const templateVars = extractTemplateVariables(prompt);
             if (templateVars.length > 0) {
@@ -434,13 +434,13 @@ function registerPublishCommand(program) {
                 }
             }
         }
-        // For code-based agents, either --url is required OR we bundle the code
-        // For agentic agents, use internal placeholder (no user code, platform handles execution)
+        // For tool-based agents, either --url is required OR we bundle the code
+        // For agent type, use internal placeholder (no user code, platform handles execution)
         let agentUrl = options.url;
         let shouldUploadBundle = false;
-        if (manifest.type === 'agentic') {
-            // Agentic agents don't need a URL or code bundle
-            agentUrl = agentUrl || 'https://agentic-agent.internal';
+        if (manifest.type === 'agent') {
+            // Agent type doesn't need a URL or code bundle
+            agentUrl = agentUrl || 'https://agent.internal';
             // But they can include a Dockerfile for custom environments
             if (options.docker) {
                 const dockerfilePath = path_1.default.join(cwd, 'Dockerfile');
@@ -454,27 +454,27 @@ function registerPublishCommand(program) {
                 }
             }
         }
-        else if (manifest.type === 'code' && !options.url) {
+        else if (manifest.type === 'tool' && !options.url) {
             // Check if this looks like a Python or JS project that can be bundled
             const entrypoint = manifest.entrypoint || await (0, bundle_1.detectEntrypoint)(cwd);
             if (entrypoint) {
-                // This is a hosted code agent - we'll bundle and upload
+                // This is a hosted tool - we'll bundle and upload
                 shouldUploadBundle = true;
                 // Set a placeholder URL that tells the gateway to use sandbox execution
-                agentUrl = 'https://code-agent.internal';
-                process.stdout.write(`Detected code project with entrypoint: ${entrypoint}\n`);
+                agentUrl = 'https://tool.internal';
+                process.stdout.write(`Detected tool project with entrypoint: ${entrypoint}\n`);
             }
             else {
-                throw new errors_1.CliError('Code agent requires either --url <url> or an entry point file (main.py, app.py, index.js, etc.)');
+                throw new errors_1.CliError('Tool requires either --url <url> or an entry point file (main.py, app.py, index.js, etc.)');
             }
         }
         // Get org info
         const org = await (0, api_1.getOrg)(config);
         // Default to 'any' provider if not specified
         const supportedProviders = manifest.supported_providers || ['any'];
-        // Detect SDK compatibility for code agents
+        // Detect SDK compatibility for tool agents
         let sdkCompatible = false;
-        if (manifest.type === 'code') {
+        if (manifest.type === 'tool') {
             sdkCompatible = await detectSdkCompatible(cwd);
             if (sdkCompatible && !options.dryRun) {
                 process.stdout.write(`SDK detected - agent will be marked as Local Ready\n`);
@@ -502,8 +502,8 @@ function registerPublishCommand(program) {
                     process.stderr.write(`  ✓ Input schema derived from template variables: ${vars.join(', ')}\n`);
                 }
             }
-            else if (manifest.type === 'agentic') {
-                // Agentic agent validations
+            else if (manifest.type === 'agent') {
+                // Agent type validations
                 const promptBytes = prompt ? Buffer.byteLength(prompt, 'utf-8') : 0;
                 process.stderr.write(`  ✓ prompt.md found (${promptBytes.toLocaleString()} bytes)\n`);
                 if (schemaFromFile) {
@@ -514,8 +514,8 @@ function registerPublishCommand(program) {
                 process.stderr.write(`  ✓ Custom tools: ${customToolCount}\n`);
                 process.stderr.write(`  ✓ Max turns: ${manifest.max_turns || 25}\n`);
             }
-            else if (manifest.type === 'code') {
-                // Code agent validations
+            else if (manifest.type === 'tool') {
+                // Tool agent validations
                 const entrypoint = manifest.entrypoint || await (0, bundle_1.detectEntrypoint)(cwd);
                 process.stderr.write(`  ✓ Entrypoint: ${entrypoint}\n`);
                 if (sdkCompatible) {
@@ -523,7 +523,7 @@ function registerPublishCommand(program) {
                 }
             }
             process.stderr.write(`  ✓ Authentication valid (org: ${org.slug})\n`);
-            // For code agents with bundles, show bundle preview
+            // For tools with bundles, show bundle preview
             if (shouldUploadBundle) {
                 const bundlePreview = await (0, bundle_1.previewBundle)(cwd, {
                     entrypoint: manifest.entrypoint,
@@ -577,7 +577,7 @@ function registerPublishCommand(program) {
                 is_public: options.public ? true : false,
                 supported_providers: supportedProviders,
                 default_models: manifest.default_models,
-                // Local run fields for code agents
+                // Local run fields for tool agents
                 source_url: manifest.source_url,
                 pip_package: manifest.pip_package,
                 run_command: manifest.run_command,
@@ -595,7 +595,7 @@ function registerPublishCommand(program) {
         }
         const assignedVersion = result.agent?.version || 'v1';
         const agentId = result.agent?.id;
-        // Upload code bundle if this is a hosted code agent or agentic agent with --docker
+        // Upload code bundle if this is a hosted tool agent or agent type with --docker
         if (shouldUploadBundle && agentId) {
             process.stdout.write(`\nBundling code...\n`);
             const tempDir = await promises_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'orchagent-bundle-'));
@@ -614,8 +614,8 @@ function registerPublishCommand(program) {
                         throw new errors_1.CliError('--docker flag specified but no Dockerfile found in project directory');
                     }
                 }
-                // For agentic agents, also include requirements.txt if present
-                if (manifest.type === 'agentic') {
+                // For agent type, also include requirements.txt if present
+                if (manifest.type === 'agent') {
                     const reqPath = path_1.default.join(cwd, 'requirements.txt');
                     try {
                         await promises_1.default.access(reqPath);
@@ -627,10 +627,10 @@ function registerPublishCommand(program) {
                     }
                 }
                 const bundleResult = await (0, bundle_1.createCodeBundle)(cwd, bundlePath, {
-                    entrypoint: manifest.type === 'agentic' ? undefined : manifest.entrypoint,
+                    entrypoint: manifest.type === 'agent' ? undefined : manifest.entrypoint,
                     exclude: manifest.bundle?.exclude,
                     include: includePatterns.length > 0 ? includePatterns : undefined,
-                    skipEntrypointCheck: manifest.type === 'agentic',
+                    skipEntrypointCheck: manifest.type === 'agent',
                 });
                 process.stdout.write(`  Created bundle: ${bundleResult.fileCount} files, ${(bundleResult.sizeBytes / 1024).toFixed(1)}KB\n`);
                 // Validate bundle size