agent-orchestrator-mcp-server 0.8.3 → 0.8.6

package/package.json

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

package/shared/orchestrator-client/orchestrator-client.d.ts

@@ -32,14 +32,14 @@ export declare function mapAgentRoot(raw: RawAgentRoot): AgentRootInfo;
 export interface IAgentOrchestratorClient {
     listSessions(options?: {
         status?: SessionStatus;
-        agent_type?: string;
+        agent_runtime?: string;
         show_archived?: boolean;
         page?: number;
         per_page?: number;
     }): Promise<SessionsResponse>;
     searchSessions(query: string, options?: {
         status?: SessionStatus;
-        agent_type?: string;
+        agent_runtime?: string;
         show_archived?: boolean;
         page?: number;
         per_page?: number;
@@ -159,14 +159,14 @@ export declare class AgentOrchestratorClient implements IAgentOrchestratorClient
     private requestText;
     listSessions(options?: {
         status?: SessionStatus;
-        agent_type?: string;
+        agent_runtime?: string;
         show_archived?: boolean;
         page?: number;
         per_page?: number;
     }): Promise<SessionsResponse>;
     searchSessions(query: string, options?: {
         status?: SessionStatus;
-        agent_type?: string;
+        agent_runtime?: string;
         show_archived?: boolean;
         page?: number;
         per_page?: number;

package/shared/orchestrator-client/orchestrator-client.integration-mock.js

@@ -14,7 +14,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 slug: 'test-session-1',
                 title: 'Test Session 1',
                 status: 'running',
-                agent_type: 'claude_code',
+                agent_runtime: 'claude_code',
                 prompt: 'Test prompt',
                 git_root: 'https://github.com/example/repo.git',
                 branch: 'main',
@@ -75,8 +75,8 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
             if (options?.status) {
                 sessions = sessions.filter((s) => s.status === options.status);
             }
-            if (options?.agent_type) {
-                sessions = sessions.filter((s) => s.agent_type === options.agent_type);
+            if (options?.agent_runtime) {
+                sessions = sessions.filter((s) => s.agent_runtime === options.agent_runtime);
             }
             if (!options?.show_archived) {
                 sessions = sessions.filter((s) => s.status !== 'archived');
@@ -138,7 +138,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 slug: data.slug || null,
                 title: data.title || 'New Session',
                 status: 'waiting',
-                agent_type: data.agent_type || 'claude_code',
+                agent_runtime: data.agent_runtime || 'claude_code',
                 prompt: data.prompt || null,
                 git_root: data.git_root || null,
                 branch: data.branch || 'main',

package/shared/tools/get-session.js

@@ -54,7 +54,7 @@ function formatSessionDetails(session, includeTranscript) {
         '### Basic Information',
         `- **ID:** ${session.id}`,
         `- **Status:** ${session.status}`,
-        `- **Agent Type:** ${session.agent_type}`,
+        `- **Agent Runtime:** ${session.agent_runtime}`,
     ];
     if (session.slug)
         lines.push(`- **Slug:** ${session.slug}`);

package/shared/tools/search-sessions.d.ts

@@ -5,14 +5,14 @@ export declare const QuickSearchSessionsSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     query: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<["waiting", "running", "needs_input", "failed", "archived"]>>;
-    agent_type: z.ZodOptional<z.ZodString>;
+    agent_runtime: z.ZodOptional<z.ZodString>;
     show_archived: z.ZodOptional<z.ZodBoolean>;
     page: z.ZodOptional<z.ZodNumber>;
     per_page: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     per_page?: number | undefined;
     status?: "waiting" | "running" | "needs_input" | "failed" | "archived" | undefined;
-    agent_type?: string | undefined;
+    agent_runtime?: string | undefined;
     show_archived?: boolean | undefined;
     page?: number | undefined;
     id?: number | undefined;
@@ -20,7 +20,7 @@ export declare const QuickSearchSessionsSchema: z.ZodObject<{
 }, {
     per_page?: number | undefined;
     status?: "waiting" | "running" | "needs_input" | "failed" | "archived" | undefined;
-    agent_type?: string | undefined;
+    agent_runtime?: string | undefined;
     show_archived?: boolean | undefined;
     page?: number | undefined;
     id?: number | undefined;
@@ -46,9 +46,9 @@ export declare function quickSearchSessionsTool(_server: Server, clientFactory:
                 enum: string[];
                 description: "Filter results by status. Options: \"waiting\", \"running\", \"needs_input\", \"failed\", \"archived\"";
             };
-            agent_type: {
+            agent_runtime: {
                 type: string;
-                description: "Filter results by agent type.";
+                description: "Filter results by agent runtime.";
             };
             show_archived: {
                 type: string;

package/shared/tools/search-sessions.js

@@ -3,7 +3,7 @@ const PARAM_DESCRIPTIONS = {
     id: 'Get a specific session by ID. When provided, other filters are ignored.',
     query: 'Search query to find sessions. Matches against session title only — this is a simple title search, not a full-text or semantic search. Leave empty to list all sessions.',
     status: 'Filter results by status. Options: "waiting", "running", "needs_input", "failed", "archived"',
-    agent_type: 'Filter results by agent type.',
+    agent_runtime: 'Filter results by agent runtime.',
     show_archived: 'Include archived sessions in results. Default: false',
     page: 'Page number for pagination. Default: 1',
     per_page: 'Number of results per page (1-100). Default: 25',
@@ -15,7 +15,7 @@ export const QuickSearchSessionsSchema = z.object({
         .enum(['waiting', 'running', 'needs_input', 'failed', 'archived'])
         .optional()
         .describe(PARAM_DESCRIPTIONS.status),
-    agent_type: z.string().optional().describe(PARAM_DESCRIPTIONS.agent_type),
+    agent_runtime: z.string().optional().describe(PARAM_DESCRIPTIONS.agent_runtime),
     show_archived: z.boolean().optional().describe(PARAM_DESCRIPTIONS.show_archived),
     page: z.number().min(1).optional().describe(PARAM_DESCRIPTIONS.page),
     per_page: z.number().min(1).max(100).optional().describe(PARAM_DESCRIPTIONS.per_page),
@@ -45,7 +45,7 @@ function formatSession(session) {
         `### ${session.title} (ID: ${session.id})`,
         '',
         `- **Status:** ${session.status}`,
-        `- **Agent Type:** ${session.agent_type}`,
+        `- **Agent Runtime:** ${session.agent_runtime}`,
     ];
     if (session.slug)
         lines.push(`- **Slug:** ${session.slug}`);
@@ -87,9 +87,9 @@ export function quickSearchSessionsTool(_server, clientFactory) {
                     enum: ['waiting', 'running', 'needs_input', 'failed', 'archived'],
                     description: PARAM_DESCRIPTIONS.status,
                 },
-                agent_type: {
+                agent_runtime: {
                     type: 'string',
-                    description: PARAM_DESCRIPTIONS.agent_type,
+                    description: PARAM_DESCRIPTIONS.agent_runtime,
                 },
                 show_archived: {
                     type: 'boolean',
@@ -132,7 +132,7 @@ export function quickSearchSessionsTool(_server, clientFactory) {
                     // Use search endpoint (title-only search, no content search)
                     const response = await client.searchSessions(validatedArgs.query, {
                         status: validatedArgs.status,
-                        agent_type: validatedArgs.agent_type,
+                        agent_runtime: validatedArgs.agent_runtime,
                         show_archived: validatedArgs.show_archived,
                         page: validatedArgs.page,
                         per_page: validatedArgs.per_page,
@@ -144,7 +144,7 @@ export function quickSearchSessionsTool(_server, clientFactory) {
                     // Use list endpoint
                     const response = await client.listSessions({
                         status: validatedArgs.status,
-                        agent_type: validatedArgs.agent_type,
+                        agent_runtime: validatedArgs.agent_runtime,
                         show_archived: validatedArgs.show_archived,
                         page: validatedArgs.page,
                         per_page: validatedArgs.per_page,

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

@@ -2,7 +2,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { z } from 'zod';
 import type { IAgentOrchestratorClient } from '../orchestrator-client/orchestrator-client.js';
 export declare const StartSessionSchema: z.ZodObject<{
-    agent_type: z.ZodOptional<z.ZodString>;
+    agent_runtime: z.ZodOptional<z.ZodString>;
     prompt: z.ZodOptional<z.ZodString>;
     agent_root: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
@@ -16,7 +16,7 @@ export declare const StartSessionSchema: z.ZodObject<{
     custom_metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     auto_compact_window: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    agent_type?: string | undefined;
+    agent_runtime?: string | undefined;
     skills?: string[] | undefined;
     plugins?: string[] | undefined;
     prompt?: string | undefined;
@@ -30,7 +30,7 @@ export declare const StartSessionSchema: z.ZodObject<{
     custom_metadata?: Record<string, unknown> | undefined;
     auto_compact_window?: number | undefined;
 }, {
-    agent_type?: string | undefined;
+    agent_runtime?: string | undefined;
     skills?: string[] | undefined;
     plugins?: string[] | undefined;
     prompt?: string | undefined;
@@ -50,9 +50,9 @@ export declare function startSessionTool(_server: Server, clientFactory: () => I
     inputSchema: {
         type: "object";
         properties: {
-            agent_type: {
+            agent_runtime: {
                 type: string;
-                description: "Agent type for the session. Currently only \"claude_code\" is supported. Default: \"claude_code\"";
+                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_type: 'Agent type for the session. Currently only "claude_code" is supported. Default: "claude_code"',
+    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. ' +
@@ -25,7 +32,7 @@ const PARAM_DESCRIPTIONS = {
         'Compaction thrashing is currently the only known reason to set this preemptively.',
 };
 export const StartSessionSchema = z.object({
-    agent_type: z.string().optional().describe(PARAM_DESCRIPTIONS.agent_type),
+    agent_runtime: z.string().optional().describe(PARAM_DESCRIPTIONS.agent_runtime),
     prompt: z.string().optional().describe(PARAM_DESCRIPTIONS.prompt),
     agent_root: z.string().optional().describe(PARAM_DESCRIPTIONS.agent_root),
     title: z.string().optional().describe(PARAM_DESCRIPTIONS.title),
@@ -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
@@ -71,9 +80,9 @@ export function startSessionTool(_server, clientFactory) {
         inputSchema: {
             type: 'object',
             properties: {
-                agent_type: {
+                agent_runtime: {
                     type: 'string',
-                    description: PARAM_DESCRIPTIONS.agent_type,
+                    description: PARAM_DESCRIPTIONS.agent_runtime,
                 },
                 prompt: {
                     type: 'string',

package/shared/tools/wake-me-up-later.js

@@ -214,12 +214,12 @@ export function wakeMeUpLaterTool(_server, clientFactory) {
                 // The Rails Trigger model requires agent_root_name, but for per-session
                 // wake-up triggers (reuse_session + last_session_id + one-time schedule)
                 // the value is never used to spawn a session — the target session is
-                // always reused. Prefer the canonical metadata value. The agent_type
+                // always reused. Prefer the canonical metadata value. The agent_runtime
                 // fallback is a best-effort for pre-migration sessions without an
-                // agent_root_key; if agent_type isn't a registered agent root, the
+                // agent_root_key; if agent_runtime isn't a registered agent root, the
                 // createTrigger call will fail loudly with a 422 rather than proceed
                 // with a bad value — which is what we want.
-                const agentRootName = session.metadata?.agent_root_key || session.agent_type;
+                const agentRootName = session.metadata?.agent_root_key || session.agent_runtime;
                 let trigger;
                 try {
                     trigger = await client.createTrigger({

package/shared/tools/wake-me-up-when-session-changes-state.js

@@ -229,9 +229,9 @@ export function wakeMeUpWhenSessionChangesStateTool(_server, clientFactory) {
                 // The Rails Trigger model requires agent_root_name, but for per-session
                 // wake-up triggers (reuse_session + last_session_id + one-time event)
                 // the value is never used to spawn a session — the target session is
-                // always reused. Prefer the canonical metadata value with agent_type as
+                // always reused. Prefer the canonical metadata value with agent_runtime as
                 // a legacy fallback (matches wake_me_up_later behavior).
-                const agentRootName = session.metadata?.agent_root_key || session.agent_type;
+                const agentRootName = session.metadata?.agent_root_key || session.agent_runtime;
                 let trigger;
                 try {
                     trigger = await client.createTrigger({

package/shared/types.d.ts

@@ -15,7 +15,7 @@ export interface Session {
     slug: string | null;
     title: string;
     status: SessionStatus;
-    agent_type: string;
+    agent_runtime: string;
     prompt: string | null;
     git_root: string | null;
     branch: string | null;
@@ -135,7 +135,7 @@ export interface SendPushNotificationResponse {
     session_id: number;
 }
 export interface CreateSessionRequest {
-    agent_type?: string;
+    agent_runtime?: string;
     prompt?: string;
     git_root?: string;
     branch?: string;