@orchagent/cli 0.3.70 → 0.3.72

package/dist/commands/init.js

@@ -87,6 +87,185 @@ def main():
 if __name__ == "__main__":
     main()
 `;
+const CODE_TEMPLATE_JS = `/**
+ * orchagent tool entrypoint.
+ *
+ * Reads JSON input from stdin, processes it, and writes JSON output to stdout.
+ * This is the standard orchagent tool protocol.
+ *
+ * Usage:
+ *   echo '{"input": "hello"}' | node main.js
+ */
+
+const fs = require('fs');
+
+function main() {
+  const raw = fs.readFileSync('/dev/stdin', 'utf-8');
+  let data;
+  try {
+    data = raw.trim() ? JSON.parse(raw) : {};
+  } catch {
+    console.log(JSON.stringify({ error: 'Invalid JSON input' }));
+    process.exit(1);
+  }
+
+  const input = data.input || '';
+
+  // --- Your logic here ---
+  // To use workspace secrets, add them to "required_secrets" in orchagent.json:
+  //   "required_secrets": ["MY_API_KEY"]
+  // Then access via: process.env.MY_API_KEY
+  const result = \`Received: \${input}\`;
+  // --- End your logic ---
+
+  console.log(JSON.stringify({ result }));
+}
+
+main();
+`;
+const DISCORD_MAIN_JS = `/**
+ * Discord bot agent — powered by Claude.
+ *
+ * Listens for messages in configured channels and responds using the Anthropic API.
+ *
+ * Local development:
+ *   1. Copy .env.example to .env and fill in your tokens
+ *   2. npm install
+ *   3. node main.js
+ */
+
+const { Client, GatewayIntentBits } = require('discord.js');
+const Anthropic = require('@anthropic-ai/sdk');
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+
+const DISCORD_BOT_TOKEN = process.env.DISCORD_BOT_TOKEN || '';
+const ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY || '';
+const DISCORD_CHANNEL_IDS = process.env.DISCORD_CHANNEL_IDS || '';
+
+const MODEL = process.env.MODEL || 'claude-sonnet-4-5-20250929';
+const MAX_TOKENS = parseInt(process.env.MAX_TOKENS || '1024', 10);
+
+const SYSTEM_PROMPT = \`\\
+You are a helpful assistant in a Discord server.
+
+Be concise and friendly. Use code blocks for code examples.
+Keep responses under 1800 characters (Discord limit is 2000).\`;
+
+
+// ---------------------------------------------------------------------------
+// Anthropic API
+// ---------------------------------------------------------------------------
+
+async function askClaude(client, userMessage) {
+  const response = await client.messages.create({
+    model: MODEL,
+    max_tokens: MAX_TOKENS,
+    system: SYSTEM_PROMPT,
+    messages: [{ role: 'user', content: userMessage }],
+  });
+  return response.content[0].text;
+}
+
+
+// ---------------------------------------------------------------------------
+// Discord bot
+// ---------------------------------------------------------------------------
+
+function parseChannelIds(raw) {
+  return new Set(
+    raw.split(',')
+      .map(s => s.trim())
+      .filter(s => /^\\d+$/.test(s))
+  );
+}
+
+function main() {
+  if (!DISCORD_BOT_TOKEN) {
+    console.error('DISCORD_BOT_TOKEN not set');
+    process.exit(1);
+  }
+  if (!ANTHROPIC_API_KEY) {
+    console.error('ANTHROPIC_API_KEY not set');
+    process.exit(1);
+  }
+  if (!DISCORD_CHANNEL_IDS) {
+    console.error('DISCORD_CHANNEL_IDS not set — add comma-separated channel IDs');
+    process.exit(1);
+  }
+
+  const allowedChannels = parseChannelIds(DISCORD_CHANNEL_IDS);
+  if (allowedChannels.size === 0) {
+    console.error('No valid channel IDs in DISCORD_CHANNEL_IDS:', DISCORD_CHANNEL_IDS);
+    process.exit(1);
+  }
+
+  console.log(\`Starting bot — model: \${MODEL}, channels: \${[...allowedChannels].join(', ')}\`);
+
+  const anthropic = new Anthropic({ apiKey: ANTHROPIC_API_KEY });
+
+  const bot = new Client({
+    intents: [
+      GatewayIntentBits.Guilds,
+      GatewayIntentBits.GuildMessages,
+      GatewayIntentBits.MessageContent,
+    ],
+  });
+
+  bot.on('ready', () => {
+    console.log(\`Bot connected as \${bot.user.tag}\`);
+  });
+
+  bot.on('messageCreate', async (message) => {
+    if (message.author.bot || !message.content.trim()) return;
+
+    const channelId = message.channelId;
+    const parentId = message.channel.parentId;
+    if (!allowedChannels.has(channelId) && !allowedChannels.has(parentId)) return;
+
+    console.log(\`Message from \${message.author.tag}: \${message.content.slice(0, 100)}\`);
+
+    try {
+      await message.channel.sendTyping();
+      const answer = await askClaude(anthropic, message.content);
+      const trimmed = answer.length > 1900 ? answer.slice(0, 1897) + '...' : answer;
+      await message.reply(trimmed);
+    } catch (err) {
+      console.error('Anthropic API error:', err.message || err);
+      await message.reply('Sorry, I ran into an issue. Please try again.');
+    }
+  });
+
+  bot.login(DISCORD_BOT_TOKEN);
+}
+
+main();
+`;
+const DISCORD_PACKAGE_JSON = `{
+  "name": "discord-bot",
+  "private": true,
+  "type": "commonjs",
+  "dependencies": {
+    "discord.js": "^14.16.0",
+    "@anthropic-ai/sdk": "^0.30.0"
+  }
+}
+`;
+const DISCORD_JS_ENV_EXAMPLE = `# Required — get your bot token from https://discord.com/developers/applications
+DISCORD_BOT_TOKEN=
+
+# Required for local dev — auto-injected in production via supported_providers
+ANTHROPIC_API_KEY=
+
+# Required — comma-separated Discord channel IDs where the bot should respond
+DISCORD_CHANNEL_IDS=
+
+# Optional — customize the model and response length
+# MODEL=claude-sonnet-4-5-20250929
+# MAX_TOKENS=1024
+`;
 function readmeTemplate(agentName, flavor) {
     if (flavor === 'support_agent') {
         return `# ${agentName}
@@ -335,6 +514,70 @@ if __name__ == "__main__":
 `;
 const ORCHESTRATOR_REQUIREMENTS = `orchagent-sdk>=0.1.0
 `;
+const ORCHESTRATOR_MAIN_JS = `/**
+ * orchagent orchestrator entrypoint.
+ *
+ * Reads JSON input from stdin, calls dependency agents via the orchagent SDK,
+ * and writes JSON output to stdout.
+ *
+ * Usage:
+ *   echo '{"task": "do something"}' | node main.js
+ */
+
+const fs = require('fs');
+const { AgentClient } = require('orchagent-sdk');
+
+async function main() {
+  // Read JSON input from stdin
+  const raw = fs.readFileSync('/dev/stdin', 'utf-8');
+  let data;
+  try {
+    data = raw.trim() ? JSON.parse(raw) : {};
+  } catch {
+    console.log(JSON.stringify({ error: 'Invalid JSON input' }));
+    process.exit(1);
+  }
+
+  const task = data.task || '';
+
+  // --- Your orchestration logic here ---
+  // The AgentClient reads ORCHAGENT_SERVICE_KEY from the environment automatically.
+  // Do NOT add ORCHAGENT_SERVICE_KEY to required_secrets — the gateway injects it.
+  const client = new AgentClient();
+
+  // Call a dependency agent (must be listed in manifest.dependencies)
+  const result = await client.call('org/agent-name@v1', { input: task });
+
+  // You can chain multiple calls, run them in parallel, or add conditional logic:
+  //
+  // Sequential:
+  //   const result2 = await client.call('org/another-agent@v1', { input: result });
+  //
+  // Parallel:
+  //   const [r1, r2] = await Promise.all([
+  //     client.call('org/agent-a@v1', { input: task }),
+  //     client.call('org/agent-b@v1', { input: task }),
+  //   ]);
+  // --- End orchestration logic ---
+
+  // Write JSON output to stdout
+  console.log(JSON.stringify({ result, success: true }));
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});
+`;
+const ORCHESTRATOR_PACKAGE_JSON = `{
+  "name": "orchestrator",
+  "private": true,
+  "type": "commonjs",
+  "dependencies": {
+    "orchagent-sdk": "^0.1.0"
+  }
+}
+`;
 const DISCORD_MAIN_PY = `"""
 Discord bot agent — powered by Claude.
 
@@ -525,7 +768,8 @@ function registerInitCommand(program) {
         .option('--type <type>', 'Type: prompt, tool, agent, or skill (legacy aliases: agentic, code)', 'prompt')
         .option('--orchestrator', 'Create an orchestrator agent with dependency scaffolding and SDK boilerplate')
         .option('--run-mode <mode>', 'Run mode for agents: on_demand or always_on', 'on_demand')
-        .option('--template <name>', 'Start from a template (available: support-agent, discord, github-weekly-summary)')
+        .option('--language <lang>', 'Language: python or javascript (default: python)', 'python')
+        .option('--template <name>', 'Start from a template (available: support-agent, discord, discord-js, github-weekly-summary)')
         .action(async (name, options) => {
         const cwd = process.cwd();
         let runMode = (options.runMode || 'on_demand').trim().toLowerCase();
@@ -539,9 +783,20 @@ function registerInitCommand(program) {
             }
             initMode = { type: 'agent', flavor: 'orchestrator' };
         }
+        // Validate --language option
+        const language = (options.language || 'python').trim().toLowerCase();
+        if (!['python', 'javascript', 'js', 'typescript', 'ts'].includes(language)) {
+            throw new errors_1.CliError(`Invalid --language '${options.language}'. Use 'python' or 'javascript'.`);
+        }
+        const isJavaScript = ['javascript', 'js', 'typescript', 'ts'].includes(language);
+        // Block unsupported JS flavors
+        if (isJavaScript && initMode.flavor === 'managed_loop') {
+            throw new errors_1.CliError('JavaScript agent-type agents are not yet supported. Use --type tool for JavaScript agents.');
+        }
+        // JS orchestrators are now supported via the orchagent-sdk npm package
         if (options.template) {
             const template = options.template.trim().toLowerCase();
-            const validTemplates = ['support-agent', 'discord', 'github-weekly-summary'];
+            const validTemplates = ['support-agent', 'discord', 'discord-js', 'github-weekly-summary'];
             if (!validTemplates.includes(template)) {
                 throw new errors_1.CliError(`Unknown --template '${template}'. Available templates: ${validTemplates.join(', ')}`);
             }
@@ -559,6 +814,10 @@ function registerInitCommand(program) {
                 initMode = { type: 'agent', flavor: 'discord' };
                 runMode = 'always_on';
             }
+            else if (template === 'discord-js') {
+                initMode = { type: 'agent', flavor: 'discord_js' };
+                runMode = 'always_on';
+            }
             else if (template === 'github-weekly-summary') {
                 initMode = { type: 'agent', flavor: 'github_weekly_summary' };
             }
@@ -672,6 +931,7 @@ function registerInitCommand(program) {
             process.stdout.write(`  ${s + 2}. Copy .env.example to .env and add platform tokens\n`);
             process.stdout.write(`  ${s + 3}. Test locally: pip install -r requirements.txt && python main.py\n`);
             process.stdout.write(`  ${s + 4}. Deploy: orch publish && orch service deploy\n`);
+            process.stdout.write(`\n  Skill: orch skill install orchagent/agent-builder — gives your AI the full platform builder reference\n`);
             return;
         }
         // Handle github-weekly-summary template separately (own file set + output)
@@ -727,6 +987,57 @@ function registerInitCommand(program) {
             process.stdout.write(`  ${s + 3}. orch run <org>/${agentName}            Test it\n`);
             process.stdout.write(`  ${s + 4}. orch schedule create <org>/${agentName} --cron "0 9 * * 1"   Schedule weekly\n`);
             process.stdout.write(`\n  See README.md for full setup guide.\n`);
+            process.stdout.write(`\n  Skill: orch skill install orchagent/agent-builder — gives your AI the full platform builder reference\n`);
+            return;
+        }
+        // Handle discord-js template separately (JS Discord bot)
+        if (initMode.flavor === 'discord_js') {
+            const manifestPath = path_1.default.join(targetDir, 'orchagent.json');
+            // Check if already initialized
+            try {
+                await promises_1.default.access(manifestPath);
+                throw new errors_1.CliError(`Already initialized (orchagent.json exists in ${name ? name + '/' : 'current directory'})`);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    throw err;
+                }
+            }
+            const manifest = {
+                name: agentName,
+                type: 'agent',
+                description: 'An always-on Discord bot powered by Claude (JavaScript)',
+                run_mode: 'always_on',
+                runtime: { command: 'node main.js' },
+                entrypoint: 'main.js',
+                supported_providers: ['anthropic'],
+                required_secrets: ['DISCORD_BOT_TOKEN', 'DISCORD_CHANNEL_IDS'],
+                tags: ['discord', 'always-on', 'javascript'],
+            };
+            await promises_1.default.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'main.js'), DISCORD_MAIN_JS);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'package.json'), DISCORD_PACKAGE_JSON);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, '.env.example'), DISCORD_JS_ENV_EXAMPLE);
+            await promises_1.default.writeFile(path_1.default.join(targetDir, 'README.md'), readmeTemplate(agentName, 'discord'));
+            const prefix = name ? name + '/' : '';
+            process.stdout.write(`\nInitialized JS Discord bot "${agentName}" in ${targetDir}\n`);
+            process.stdout.write(`\nFiles created:\n`);
+            process.stdout.write(`  ${prefix}orchagent.json    - Agent configuration\n`);
+            process.stdout.write(`  ${prefix}main.js           - Discord bot (discord.js + Anthropic)\n`);
+            process.stdout.write(`  ${prefix}package.json      - npm dependencies\n`);
+            process.stdout.write(`  ${prefix}.env.example      - Environment variables template\n`);
+            process.stdout.write(`  ${prefix}README.md         - Setup guide\n`);
+            process.stdout.write(`\nNext steps:\n`);
+            const stepNum = name ? 2 : 1;
+            if (name) {
+                process.stdout.write(`  1. cd ${name}\n`);
+            }
+            process.stdout.write(`  ${stepNum}. Create a Discord bot at https://discord.com/developers/applications\n`);
+            process.stdout.write(`  ${stepNum + 1}. Enable Message Content Intent in bot settings\n`);
+            process.stdout.write(`  ${stepNum + 2}. Copy .env.example to .env and fill in your tokens\n`);
+            process.stdout.write(`  ${stepNum + 3}. Test locally: npm install && node main.js\n`);
+            process.stdout.write(`  ${stepNum + 4}. Deploy: orch publish\n`);
+            process.stdout.write(`\n  Skill: orch skill install orchagent/agent-builder — gives your AI the full platform builder reference\n`);
             return;
         }
         const manifestPath = path_1.default.join(targetDir, 'orchagent.json');
@@ -752,7 +1063,13 @@ function registerInitCommand(program) {
         manifest.run_mode = runMode;
         if (initMode.flavor === 'orchestrator') {
             manifest.description = 'An orchestrator agent that coordinates other agents';
-            manifest.runtime = { command: 'python main.py' };
+            if (isJavaScript) {
+                manifest.runtime = { command: 'node main.js' };
+                manifest.entrypoint = 'main.js';
+            }
+            else {
+                manifest.runtime = { command: 'python main.py' };
+            }
             manifest.manifest = {
                 manifest_version: 1,
                 dependencies: [{ id: 'org/agent-name', version: 'v1' }],
@@ -777,15 +1094,25 @@ function registerInitCommand(program) {
         }
         else if (initMode.flavor === 'code_runtime') {
             manifest.description = 'A code-runtime agent';
-            manifest.runtime = { command: 'python main.py' };
+            if (isJavaScript) {
+                manifest.runtime = { command: 'node main.js' };
+                manifest.entrypoint = 'main.js';
+            }
+            else {
+                manifest.runtime = { command: 'python main.py' };
+            }
             manifest.required_secrets = [];
         }
         await promises_1.default.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
         if (initMode.flavor === 'orchestrator') {
-            const entrypointPath = path_1.default.join(targetDir, 'main.py');
-            const requirementsPath = path_1.default.join(targetDir, 'requirements.txt');
-            await promises_1.default.writeFile(entrypointPath, ORCHESTRATOR_MAIN_PY);
-            await promises_1.default.writeFile(requirementsPath, ORCHESTRATOR_REQUIREMENTS);
+            if (isJavaScript) {
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'main.js'), ORCHESTRATOR_MAIN_JS);
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'package.json'), ORCHESTRATOR_PACKAGE_JSON);
+            }
+            else {
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'main.py'), ORCHESTRATOR_MAIN_PY);
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'requirements.txt'), ORCHESTRATOR_REQUIREMENTS);
+            }
             await promises_1.default.writeFile(schemaPath, AGENT_SCHEMA_TEMPLATE);
         }
         else if (initMode.flavor === 'discord') {
@@ -797,8 +1124,18 @@ function registerInitCommand(program) {
             await promises_1.default.writeFile(envExamplePath, DISCORD_ENV_EXAMPLE);
         }
         else if (initMode.flavor === 'code_runtime') {
-            const entrypointPath = path_1.default.join(targetDir, 'main.py');
-            await promises_1.default.writeFile(entrypointPath, CODE_TEMPLATE_PY);
+            if (isJavaScript) {
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'main.js'), CODE_TEMPLATE_JS);
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'package.json'), JSON.stringify({
+                    name: agentName,
+                    private: true,
+                    type: 'commonjs',
+                    dependencies: {},
+                }, null, 2) + '\n');
+            }
+            else {
+                await promises_1.default.writeFile(path_1.default.join(targetDir, 'main.py'), CODE_TEMPLATE_PY);
+            }
             await promises_1.default.writeFile(schemaPath, SCHEMA_TEMPLATE);
         }
         else if (initMode.flavor === 'managed_loop') {
@@ -817,8 +1154,14 @@ function registerInitCommand(program) {
         const prefix = name ? name + '/' : '';
         process.stdout.write(`  ${prefix}orchagent.json    - Agent configuration\n`);
         if (initMode.flavor === 'orchestrator') {
-            process.stdout.write(`  ${prefix}main.py           - Orchestrator entrypoint (SDK calls)\n`);
-            process.stdout.write(`  ${prefix}requirements.txt  - Python dependencies (orchagent-sdk)\n`);
+            if (isJavaScript) {
+                process.stdout.write(`  ${prefix}main.js           - Orchestrator entrypoint (SDK calls)\n`);
+                process.stdout.write(`  ${prefix}package.json      - npm dependencies (orchagent-sdk)\n`);
+            }
+            else {
+                process.stdout.write(`  ${prefix}main.py           - Orchestrator entrypoint (SDK calls)\n`);
+                process.stdout.write(`  ${prefix}requirements.txt  - Python dependencies (orchagent-sdk)\n`);
+            }
         }
         else if (initMode.flavor === 'discord') {
             process.stdout.write(`  ${prefix}main.py           - Discord bot (discord.py + Anthropic)\n`);
@@ -826,7 +1169,13 @@ function registerInitCommand(program) {
             process.stdout.write(`  ${prefix}.env.example      - Environment variables template\n`);
         }
         else if (initMode.flavor === 'code_runtime') {
-            process.stdout.write(`  ${prefix}main.py           - Agent entrypoint (stdin/stdout JSON)\n`);
+            if (isJavaScript) {
+                process.stdout.write(`  ${prefix}main.js           - Agent entrypoint (stdin/stdout JSON)\n`);
+                process.stdout.write(`  ${prefix}package.json      - npm dependencies\n`);
+            }
+            else {
+                process.stdout.write(`  ${prefix}main.py           - Agent entrypoint (stdin/stdout JSON)\n`);
+            }
         }
         else {
             process.stdout.write(`  ${prefix}prompt.md         - Prompt template\n`);
@@ -844,7 +1193,12 @@ function registerInitCommand(program) {
                 process.stdout.write(`  1. cd ${name}\n`);
             }
             process.stdout.write(`  ${stepNum}. Update manifest.dependencies in orchagent.json with your actual agents\n`);
-            process.stdout.write(`  ${stepNum + 1}. Edit main.py with your orchestration logic\n`);
+            if (isJavaScript) {
+                process.stdout.write(`  ${stepNum + 1}. Edit main.js with your orchestration logic\n`);
+            }
+            else {
+                process.stdout.write(`  ${stepNum + 1}. Edit main.py with your orchestration logic\n`);
+            }
             process.stdout.write(`  ${stepNum + 2}. Publish dependency agents first, then: orchagent publish\n`);
         }
         else if (initMode.flavor === 'discord') {
@@ -863,10 +1217,18 @@ function registerInitCommand(program) {
             if (name) {
                 process.stdout.write(`  1. cd ${name}\n`);
             }
-            process.stdout.write(`  ${stepNum}. Edit main.py with your agent logic\n`);
-            process.stdout.write(`  ${stepNum + 1}. Edit schema.json with your input/output schemas\n`);
-            process.stdout.write(`  ${stepNum + 2}. Test: echo '{"input": "test"}' | python main.py\n`);
-            process.stdout.write(`  ${stepNum + 3}. Run: orchagent publish\n`);
+            if (isJavaScript) {
+                process.stdout.write(`  ${stepNum}. Edit main.js with your agent logic\n`);
+                process.stdout.write(`  ${stepNum + 1}. Edit schema.json with your input/output schemas\n`);
+                process.stdout.write(`  ${stepNum + 2}. Test: echo '{"input": "test"}' | node main.js\n`);
+                process.stdout.write(`  ${stepNum + 3}. Run: orchagent publish\n`);
+            }
+            else {
+                process.stdout.write(`  ${stepNum}. Edit main.py with your agent logic\n`);
+                process.stdout.write(`  ${stepNum + 1}. Edit schema.json with your input/output schemas\n`);
+                process.stdout.write(`  ${stepNum + 2}. Test: echo '{"input": "test"}' | python main.py\n`);
+                process.stdout.write(`  ${stepNum + 3}. Run: orchagent publish\n`);
+            }
         }
         else {
             const stepNum = name ? 2 : 1;
@@ -877,5 +1239,6 @@ function registerInitCommand(program) {
             process.stdout.write(`  ${stepNum + 1}. Edit schema.json with your input/output schemas\n`);
             process.stdout.write(`  ${stepNum + 2}. Run: orchagent publish\n`);
         }
+        process.stdout.write(`\n  Skill: orch skill install orchagent/agent-builder — gives your AI the full platform builder reference\n`);
     });
 }

package/dist/commands/publish.js

@@ -80,7 +80,9 @@ async function scanUndeclaredEnvVars(agentDir, requiredSecrets) {
         /os\.getenv\s*\(\s*['"]([A-Z][A-Z0-9_]*)['"]/g,
     ];
     const found = new Set();
-    // Scan .py files in the agent directory (up to 2 levels deep)
+    // JS/TS env var access pattern
+    const jsEnvPattern = /process\.env\.([A-Z_][A-Z0-9_]*)/g;
+    // Scan .py/.js/.ts files in the agent directory (up to 2 levels deep)
     async function scanDir(dir, depth) {
         let entries;
         try {
@@ -112,6 +114,19 @@ async function scanUndeclaredEnvVars(agentDir, requiredSecrets) {
                     // Skip unreadable files
                 }
             }
+            else if (entry.isFile() && (name.endsWith('.js') || name.endsWith('.ts'))) {
+                try {
+                    const content = await promises_1.default.readFile(fullPath, 'utf-8');
+                    jsEnvPattern.lastIndex = 0;
+                    let m;
+                    while ((m = jsEnvPattern.exec(content)) !== null) { // eslint-disable-line no-cond-assign
+                        found.add(m[1]);
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
         }
     }
     await scanDir(agentDir, 0);
@@ -147,6 +162,19 @@ async function detectSdkCompatible(agentDir) {
     catch {
         // File doesn't exist
     }
+    // Check package.json (JS/TS agents)
+    const pkgJsonPath = path_1.default.join(agentDir, 'package.json');
+    try {
+        const content = await promises_1.default.readFile(pkgJsonPath, 'utf-8');
+        const pkgJson = JSON.parse(content);
+        const deps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };
+        if (deps['orchagent-sdk'] || deps['@orchagent/sdk']) {
+            return true;
+        }
+    }
+    catch {
+        // File doesn't exist or invalid JSON
+    }
     return false;
 }
 async function parseSkillMd(filePath) {
@@ -886,6 +914,26 @@ function registerPublishCommand(program) {
                     catch {
                         // Optional
                     }
+                    // Include package.json + lockfile for JS agents (overrides DEFAULT_EXCLUDES)
+                    const pkgPath = path_1.default.join(cwd, 'package.json');
+                    try {
+                        await promises_1.default.access(pkgPath);
+                        includePatterns.push('package.json');
+                        process.stdout.write(`  Including package.json for sandbox dependencies\n`);
+                        // Include lockfile for deterministic installs (npm ci)
+                        const lockPath = path_1.default.join(cwd, 'package-lock.json');
+                        try {
+                            await promises_1.default.access(lockPath);
+                            includePatterns.push('package-lock.json');
+                            process.stdout.write(`  Including package-lock.json for deterministic installs\n`);
+                        }
+                        catch {
+                            // No lockfile — npm install will be used instead of npm ci
+                        }
+                    }
+                    catch {
+                        // No package.json — not a JS agent
+                    }
                 }
                 const bundleResult = await (0, bundle_1.createCodeBundle)(cwd, bundlePath, {
                     entrypoint: bundleEntrypoint,
@@ -992,5 +1040,6 @@ function registerPublishCommand(program) {
             process.stdout.write(`\nNote: Hosted code execution is in beta. Contact support for full deployment.\n`);
         }
         process.stdout.write(`\nView analytics and usage: https://orchagent.io/dashboard\n`);
+        process.stdout.write(`\nSkill: orch skill install orchagent/agent-builder — gives your AI the full platform builder reference\n`);
     });
 }

package/dist/commands/run.js

@@ -69,6 +69,16 @@ const DOWNSTREAM_REMAINING_ENV = 'ORCHAGENT_DOWNSTREAM_REMAINING';
 const CONTENT_FIELD_NAMES = ['code', 'content', 'text', 'source', 'input', 'file_content', 'body'];
 // Keys that might indicate local file path references in JSON payloads
 const LOCAL_PATH_KEYS = ['path', 'directory', 'file', 'filepath', 'dir', 'folder', 'local'];
+/**
+ * Return the correct local command for a given entrypoint file extension.
+ * Uses `python3` (not `python`) to match existing behavior on macOS/Linux.
+ */
+function localCommandForEntrypoint(entrypoint) {
+    if (entrypoint.endsWith('.js') || entrypoint.endsWith('.mjs') || entrypoint.endsWith('.cjs')) {
+        return 'node';
+    }
+    return 'python3';
+}
 function parseAgentRef(value) {
     const [ref, versionPart] = value.split('@');
     const version = versionPart?.trim() || DEFAULT_VERSION;
@@ -652,25 +662,6 @@ async function detectAllLlmKeys(supportedProviders, config) {
             }
         }
     }
-    if (config?.apiKey) {
-        try {
-            const { fetchLlmKeys } = await Promise.resolve().then(() => __importStar(require('../lib/api')));
-            const serverKeys = await fetchLlmKeys(config);
-            for (const serverKey of serverKeys) {
-                if (!seen.has(serverKey.provider)) {
-                    seen.add(serverKey.provider);
-                    providers.push({
-                        provider: serverKey.provider,
-                        apiKey: serverKey.api_key,
-                        model: serverKey.model || (0, llm_1.getDefaultModel)(serverKey.provider),
-                    });
-                }
-            }
-        }
-        catch {
-            // Server fetch failed, continue with what we have
-        }
-    }
     return providers;
 }
 async function executePromptLocally(agentData, inputData, skillPrompts = [], config, providerOverride, modelOverride) {
@@ -1062,6 +1053,32 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
                 throw err;
             }
         }
+        // Install npm dependencies if package.json exists (JS agents)
+        const pkgJsonPath = path_1.default.join(extractDir, 'package.json');
+        try {
+            await promises_1.default.access(pkgJsonPath);
+            await (0, spinner_1.withSpinner)('Installing npm dependencies...', async () => {
+                const lockfilePath = path_1.default.join(extractDir, 'package-lock.json');
+                let useNpmCi = false;
+                try {
+                    await promises_1.default.access(lockfilePath);
+                    useNpmCi = true;
+                }
+                catch { /* no lockfile */ }
+                const npmArgs = useNpmCi
+                    ? ['ci', '--no-audit', '--no-fund']
+                    : ['install', '--production', '--no-audit', '--no-fund'];
+                const { code } = await runCommand('npm', npmArgs);
+                if (code !== 0) {
+                    throw new errors_1.CliError('Failed to install npm dependencies');
+                }
+            }, { successText: 'npm dependencies installed' });
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
         const entrypoint = agentData.entrypoint || 'sandbox_main.py';
         const entrypointPath = path_1.default.join(extractDir, entrypoint);
         try {
@@ -1116,7 +1133,8 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
                 }
             }
         }
-        process.stderr.write(`\nRunning: python3 ${entrypoint}\n\n`);
+        const execCmd = localCommandForEntrypoint(entrypoint);
+        process.stderr.write(`\nRunning: ${execCmd} ${entrypoint}\n\n`);
         const subprocessEnv = { ...process.env };
         if (config.apiKey) {
             subprocessEnv.ORCHAGENT_SERVICE_KEY = config.apiKey;
@@ -1133,7 +1151,7 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
             subprocessEnv[MAX_HOPS_ENV] = String(manifest.manifest?.max_hops || 10);
             subprocessEnv[DOWNSTREAM_REMAINING_ENV] = String(manifest.manifest?.per_call_downstream_cap || 100);
         }
-        const proc = (0, child_process_1.spawn)('python3', [entrypointPath], {
+        const proc = (0, child_process_1.spawn)(execCmd, [entrypointPath], {
             cwd: extractDir,
             stdio: ['pipe', 'pipe', 'pipe'],
             env: subprocessEnv,
@@ -1442,7 +1460,11 @@ async function executeLocalFromDir(dirPath, args, options) {
         return;
     }
     // Code runtime agents with bundle
-    const entrypoint = manifest.entrypoint || 'sandbox_main.py';
+    const runtimeObj = manifest.runtime;
+    const runtimeCommand = runtimeObj?.command;
+    const entrypoint = manifest.entrypoint
+        || (runtimeCommand ? runtimeCommand.split(' ').pop() || 'sandbox_main.py' : null)
+        || 'sandbox_main.py';
     const entrypointPath = path_1.default.join(resolved, entrypoint);
     try {
         await promises_1.default.access(entrypointPath);
@@ -1492,6 +1514,29 @@ async function executeLocalFromDir(dirPath, args, options) {
     catch {
         // No requirements.txt
     }
+    // Install npm dependencies if package.json exists (JS agents)
+    const localPkgJsonPath = path_1.default.join(resolved, 'package.json');
+    try {
+        await promises_1.default.access(localPkgJsonPath);
+        const lockfilePath = path_1.default.join(resolved, 'package-lock.json');
+        let useNpmCi = false;
+        try {
+            await promises_1.default.access(lockfilePath);
+            useNpmCi = true;
+        }
+        catch { /* no lockfile */ }
+        const npmArgs = useNpmCi
+            ? ['ci', '--no-audit', '--no-fund']
+            : ['install', '--production', '--no-audit', '--no-fund'];
+        process.stderr.write('Installing npm dependencies...\n');
+        const { code } = await runCommand('npm', npmArgs);
+        if (code !== 0) {
+            process.stderr.write('Warning: Failed to install npm dependencies\n');
+        }
+    }
+    catch {
+        // No package.json
+    }
     // Check for keyed file/mount injection (tool path)
     const toolFileArgs = options.file ?? [];
     const toolKeyedFiles = toolFileArgs.filter(a => isKeyedFileArg(a) !== null);
@@ -1517,13 +1562,14 @@ async function executeLocalFromDir(dirPath, args, options) {
     else if (args.length > 0) {
         inputJson = JSON.stringify({ input: args[0] });
     }
-    process.stderr.write(`\nRunning: python3 ${entrypoint}\n\n`);
+    const localExecCmd = localCommandForEntrypoint(entrypoint);
+    process.stderr.write(`\nRunning: ${localExecCmd} ${entrypoint}\n\n`);
     const subprocessEnv = { ...process.env };
     if (config.apiKey) {
         subprocessEnv.ORCHAGENT_SERVICE_KEY = config.apiKey;
         subprocessEnv.ORCHAGENT_API_URL = config.apiUrl;
     }
-    const proc = (0, child_process_1.spawn)('python3', [entrypointPath], {
+    const proc = (0, child_process_1.spawn)(localExecCmd, [entrypointPath], {
         cwd: resolved,
         stdio: ['pipe', 'pipe', 'pipe'],
         env: subprocessEnv,

package/dist/lib/api.js

@@ -46,7 +46,7 @@ exports.updateOrg = updateOrg;
 exports.getPublicAgent = getPublicAgent;
 exports.listMyAgents = listMyAgents;
 exports.createAgent = createAgent;
-exports.fetchLlmKeys = fetchLlmKeys;
+exports.listLlmKeys = listLlmKeys;
 exports.downloadCodeBundle = downloadCodeBundle;
 exports.uploadCodeBundle = uploadCodeBundle;
 exports.getMyAgent = getMyAgent;
@@ -306,9 +306,8 @@ async function createAgent(config, data, workspaceId) {
         headers,
     });
 }
-async function fetchLlmKeys(config) {
-    const result = await request(config, 'GET', '/llm-keys/export');
-    return result.keys;
+async function listLlmKeys(config) {
+    return request(config, 'GET', '/llm-keys');
 }
 /**
  * Download a code-runtime bundle for local execution.

package/dist/lib/bundle.js

@@ -44,7 +44,7 @@ const DEFAULT_EXCLUDES = [
     'npm-debug.log',
     'yarn-error.log',
     'package.json',
-    'package-lock.json',
+    // package-lock.json intentionally NOT excluded — included explicitly for JS agents
     'yarn.lock',
     'bun.lockb',
     'tsconfig.json',

package/dist/lib/doctor/checks/llm.js

@@ -87,7 +87,7 @@ async function runLlmChecks(options) {
         try {
             const config = await (0, config_1.getResolvedConfig)();
             if (config.apiKey) {
-                const keys = await (0, api_1.fetchLlmKeys)(config);
+                const keys = await (0, api_1.listLlmKeys)(config);
                 serverProviders = keys.map((k) => k.provider);
             }
         }

package/dist/lib/llm.js

@@ -5,39 +5,6 @@
  * Centralized LLM provider configuration and utilities.
  * Used by run, call, and skill commands.
  */
-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;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_MODELS = exports.PROVIDER_ENV_VARS = exports.LlmError = void 0;
 exports.isRateLimitError = isRateLimitError;
@@ -107,37 +74,10 @@ function detectLlmKeyFromEnv(supportedProviders) {
  * Checks local env vars first, then fetches from server if available.
  * Returns provider, key, and optionally the model from server config.
  */
-async function detectLlmKey(supportedProviders, config) {
-    // 1. Check local env vars first (fast path)
-    const envKey = detectLlmKeyFromEnv(supportedProviders);
-    if (envKey)
-        return envKey;
-    // 2. If no env var, try server
-    if (config?.apiKey) {
-        try {
-            const { fetchLlmKeys } = await Promise.resolve().then(() => __importStar(require('./api')));
-            const serverKeys = await fetchLlmKeys(config);
-            for (const provider of supportedProviders) {
-                if (provider === 'any') {
-                    // Return first available key
-                    if (serverKeys.length > 0) {
-                        const first = serverKeys[0];
-                        return { provider: first.provider, key: first.api_key, model: first.model };
-                    }
-                }
-                else {
-                    const match = serverKeys.find((k) => k.provider === provider);
-                    if (match) {
-                        return { provider: match.provider, key: match.api_key, model: match.model };
-                    }
-                }
-            }
-        }
-        catch {
-            // Server fetch failed, continue without
-        }
-    }
-    return null;
+async function detectLlmKey(supportedProviders, _config) {
+    // LLM keys are only available from local env vars.
+    // Server-stored keys are never exported (security best practice).
+    return detectLlmKeyFromEnv(supportedProviders);
 }
 /**
  * Get the default model for a provider.

package/package.json

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