agent-orchestrator-mcp-server 0.8.5 → 0.8.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-orchestrator-mcp-server",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "Local implementation of agent-orchestrator MCP server",
   "main": "build/index.js",
   "type": "module",

package/shared/tools/start-session.d.ts

@@ -52,7 +52,7 @@ export declare function startSessionTool(_server: Server, clientFactory: () => I
         properties: {
             agent_runtime: {
                 type: string;
-                description: "Per-spawn agent runtime override. When omitted, the session adopts the agent_root's default_runtime, falling back to \"claude_code\". Currently only \"claude_code\" is registered.";
+                description: string;
             };
             prompt: {
                 type: string;
@@ -102,7 +102,7 @@ export declare function startSessionTool(_server: Server, clientFactory: () => I
             };
             config: {
                 type: string;
-                description: "Additional configuration as a JSON object.";
+                description: string;
             };
             custom_metadata: {
                 type: string;

package/shared/tools/start-session.js

@@ -2,7 +2,10 @@ import { z } from 'zod';
 import { parseAllowedAgentRoots, validateAgentRootConstraints } from '../allowed-agent-roots.js';
 import { getConfigsCache, setConfigsCache } from '../cache/configs-cache.js';
 const PARAM_DESCRIPTIONS = {
-    agent_runtime: 'Per-spawn agent runtime override. When omitted, the session adopts the agent_root\'s default_runtime, falling back to "claude_code". Currently only "claude_code" is registered.',
+    agent_runtime: 'Per-spawn agent runtime override. Valid values are "claude_code" (Claude Code) and "codex" (OpenAI Codex CLI). ' +
+        'When omitted, the session adopts the agent_root\'s default_runtime, falling back to "claude_code". ' +
+        "Call get_configs to see each agent root's default_runtime. Pair with `config.model` to pick a model valid for the chosen runtime " +
+        '(e.g. "opus"/"sonnet"/"haiku" for claude_code, "gpt-5.5"/"gpt-5.4" for codex).',
     prompt: 'Initial prompt for the agent. If provided, the agent job is automatically queued. Omit for a clone-only session.',
     agent_root: 'Agent root name from get_configs. The API resolves git_root, branch, subdirectory, default_model, and other defaults from the agent root configuration. Always pass this so the session inherits the correct repository, model, and settings.',
     title: 'STRONGLY RECOMMENDED: Always set a title — treat it as effectively required. ' +
@@ -16,7 +19,11 @@ const PARAM_DESCRIPTIONS = {
     mcp_servers: 'List of MCP server names to enable for this session. Example: ["github-development", "slack"]',
     skills: 'List of skill names to enable for this session. Always include the agent root\'s default_skills from get_configs as the starting point — omitting skills means the session gets none. Add extras as needed; removing a default should be rare and intentional. Example: ["discovery-classify", "publish-and-pr"]',
     plugins: 'List of plugin names to enable for this session. Plugins extend agent capabilities with additional integrations. Example: ["my-plugin"]',
-    config: 'Additional configuration as a JSON object.',
+    config: 'Additional configuration as a JSON object. Use `config.model` to choose the agent model for this session ' +
+        '(e.g. {"model": "gpt-5.4"} for a codex runtime, or {"model": "sonnet"} for claude_code). ' +
+        "The model must be valid for the resolved agent_runtime; call get_configs to see each agent root's default_model. " +
+        "When omitted, the session uses the agent root's default_model (or the runtime's default model). " +
+        "An explicit config.model always takes precedence over the agent root's default_model.",
     custom_metadata: 'User-defined metadata as a JSON object. Useful for tracking tickets, projects, etc.',
     auto_compact_window: 'Optional per-session auto-compact (context) window override, in tokens. ' +
         '**You should generally rely on the default of 200,000** — omit this parameter and the API default applies. ' +
@@ -59,6 +66,8 @@ const TOOL_DESCRIPTION = `Start a new agent session in the Agent Orchestrator.
 - **MCP servers:** Start with \`default_mcp_servers\`. Drop servers the task doesn't need (least-privilege). Add extras when the task requires tools beyond the defaults. When \`ALLOWED_AGENT_ROOTS\` is active, you cannot add servers beyond the defaults.
 - **Skills:** Start with \`default_skills\`. You can freely add skills beyond the defaults. Removing a default skill should be rare and intentional — only when you have a specific reason, like replacing a skill with a more capable variant that covers the same ground. Skills are lightweight text files with no blast radius, so keeping all defaults costs nothing.
 
+**Runtime and model selection:** Pass \`agent_runtime\` to override which agent runtime the session uses — \`claude_code\` (Claude Code) or \`codex\` (OpenAI Codex CLI). Pass \`config: { model: "..." }\` to choose the model (e.g. \`opus\`/\`sonnet\`/\`haiku\` for claude_code, \`gpt-5.5\`/\`gpt-5.4\` for codex). Both are optional: when omitted, the session inherits the agent root's \`default_runtime\` and \`default_model\`. Call get_configs to discover each root's defaults and pick a model that is valid for the chosen runtime.
+
 **Use cases:**
 - Start a new agent task on a repository
 - Create a session to work on a specific branch