@zhixuan92/multi-model-agent-core 0.4.0 → 1.1.0

package/README.md

@@ -1,16 +1,8 @@
 # @zhixuan92/multi-model-agent-core
 
-**Runtime library for [`multi-model-agent`](https://github.com/zhixuan312/multi-model-agent) — import it to run multi-provider agent tasks directly from your own Node program.**
+**Runtime library for multi-model-agent.** Import it to run multi-provider agent tasks directly from your own Node program — same routing, supervision, and review pipeline, no MCP client needed.
 
-Use this package when you want to embed the same routing and dispatch logic inside your own process instead of going through an MCP client. It ships:
-
-- **Provider runners** — Claude (`@anthropic-ai/claude-agent-sdk`), Codex (OpenAI Responses API with `codex login` or `OPENAI_API_KEY`), and any OpenAI-compatible endpoint.
-- **Routing engine** — capability filter → quality tier filter → cheapest qualifying provider, with the full escalation chain walked automatically on failure.
-- **`runTasks`** — a single function that takes a task array and a config, runs them in parallel, and returns one result per task (usage, costUSD, savedCostUSD, files touched, status, escalation log).
-- **Config schema** — Zod-validated loader for `~/.multi-model/config.json` so callers get the same config contract as the MCP server.
-- **Sandboxed tool layer** — `readFile`, `writeFile`, `grep`, `glob`, `listFiles`, `runShell` with `cwd-only` confinement via `fs.realpath`, size caps, and per-call enforcement.
-
-> **If you just want a `delegate_tasks` tool in Claude Code / Claude Desktop / Codex CLI**, install [`@zhixuan92/multi-model-agent-mcp`](https://www.npmjs.com/package/@zhixuan92/multi-model-agent-mcp) instead — it wraps this library in an MCP stdio server. You don't need `-core` directly for that.
+> **Just want your AI assistant to delegate work?** Install [`@zhixuan92/multi-model-agent-mcp`](https://www.npmjs.com/package/@zhixuan92/multi-model-agent-mcp) instead — it wraps this library in an MCP server.
 
 ## Install
 
@@ -18,104 +10,52 @@ Use this package when you want to embed the same routing and dispatch logic insi
 npm install @zhixuan92/multi-model-agent-core
 ```
 
-Requires Node `>= 22`. ESM only.
+Requires Node >= 22. ESM only.
 
-## What's exported
+## Quick example
 
 ```ts
-import {
-  // Config
-  loadConfigFromFile,
-  parseConfig,
-  multiModelConfigSchema,
-
-  // Provider factory + dispatch
-  createProvider,
-  runTasks,
-
-  // Routing helpers
-  selectProviderForTask,
-  getProviderEligibility,
-  getBaseCapabilities,
-  resolveTaskCapabilities,
-  findModelProfile,
-  getEffectiveCostTier,
-} from '@zhixuan92/multi-model-agent-core';
-
-import type {
-  MultiModelConfig,
-  ProviderConfig,
-  TaskSpec,
-  RunResult,
-  RunStatus,
-  Tier,
-  Capability,
-  CostTier,
-  Effort,
-  SandboxPolicy,
-} from '@zhixuan92/multi-model-agent-core';
-```
-
-Subpath exports are available for tree-shaking-friendly imports:
-
-| Subpath | What |
-| --- | --- |
-| `./config/schema` | `parseConfig`, `multiModelConfigSchema` |
-| `./config/load` | `loadConfigFromFile` |
-| `./routing/capabilities` | base provider capability table |
-| `./routing/model-profiles` | tier/cost defaults per model name prefix |
-| `./routing/select-provider-for-task` | routing decision |
-| `./routing/get-provider-eligibility` | per-provider eligibility breakdown with reasons |
-| `./routing/resolve-task-capabilities` | merges per-task overrides into provider capabilities |
-| `./provider` | `createProvider` factory |
-| `./run-tasks` | `runTasks` parallel dispatcher |
-| `./types` | all shared types |
+import { loadConfigFromFile } from '@zhixuan92/multi-model-agent-core/config/load';
+import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
 
-## Quick example
+const config = await loadConfigFromFile();
 
-```ts
-import { runTasks } from '@zhixuan92/multi-model-agent-core';
-
-const config = {
-  providers: {
-    claude: { type: 'claude', model: 'claude-sonnet-4-6' },
-    codex: { type: 'codex', model: 'gpt-5-codex' },
-  },
-  defaults: { maxTurns: 200, timeoutMs: 600_000, tools: 'full' },
-};
-
-const results = await runTasks(
-  [
-    { prompt: 'Refactor auth.ts to use JWT.', tier: 'reasoning', requiredCapabilities: ['file_read', 'file_write'] },
-    { prompt: 'List all .ts files.', tier: 'trivial', requiredCapabilities: ['glob'] },
-  ],
-  config,
-);
+const results = await runTasks([
+  { prompt: 'Refactor auth.ts to use JWT.', agentType: 'complex' },
+  { prompt: 'Write unit tests for auth module.', agentType: 'standard' },
+], config);
 
 for (const r of results) {
-  console.log(r.status, r.output);
+  console.log(r.status, r.usage.costUSD, r.output);
 }
 ```
 
-`runTasks` runs each task on the cheapest eligible provider in parallel and returns a result per task. Pin a task to a specific provider by adding `provider: 'claude'`.
-
-## Sandbox
-
-File tools enforce `sandboxPolicy: 'cwd-only'` by default — paths must resolve (via `fs.realpath`) inside the task's `cwd`. `runShell` is hard-disabled under `cwd-only`. `readFile` rejects targets larger than 50 MiB and `writeFile` rejects content larger than 100 MiB before touching memory or disk.
-
-## Updating
-
-Bump via `npm install @zhixuan92/multi-model-agent-core@latest` (or `npm update`). The package is on **0.x semver**: any MINOR bump (`0.2.x → 0.3.0`) may change the config schema, the `runTasks` task shape, or exported types. PATCH bumps (`0.3.0 → 0.3.1`) are strictly backwards-compatible bug fixes.
+## What's inside
 
-Always skim [`CHANGELOG.md`](https://github.com/zhixuan312/multi-model-agent/blob/HEAD/CHANGELOG.md) before picking up a new MINOR version — if it calls out a schema change, update your config loader and any stored task specs before upgrading. Subpath exports listed above are part of the public API contract and are versioned together with the main entry point.
+- **Provider runners** — Claude, Codex, and any OpenAI-compatible endpoint
+- **Routing engine** — capability filter → agent type → cheapest qualifier
+- **`runTasks`** — parallel dispatch, returns per-task results with usage, cost, files touched, status, and escalation log
+- **Reviewed lifecycle** — spec review + quality review by a different agent
+- **Config schema** — Zod-validated, same contract as the MCP server
+- **Sandboxed tools** — `readFile`, `writeFile`, `grep`, `glob`, `listFiles`, `runShell` with `cwd-only` confinement
 
-If you also depend on `@zhixuan92/multi-model-agent-mcp`, keep the two packages on matching MINOR versions — the MCP server declares a `^0.X.0` range on this library and mismatched versions can surface as type drift or schema validation errors.
+## Subpath exports
 
-## Documentation
+| Subpath | What |
+|---|---|
+| `./config/schema` | `parseConfig`, `multiModelConfigSchema` |
+| `./config/load` | `loadConfigFromFile` |
+| `./routing/select-provider-for-task` | Routing decision |
+| `./routing/get-provider-eligibility` | Per-provider eligibility with reasons |
+| `./routing/capabilities` | Base provider capability table |
+| `./routing/model-profiles` | Cost/tier defaults per model |
+| `./provider` | `createProvider` factory |
+| `./run-tasks` | `runTasks` parallel dispatcher |
+| `./types` | All shared types |
 
-Full docs, configuration reference, supported providers, and the routing matrix live in the project README:
+## Full documentation
 
-→ **<https://github.com/zhixuan312/multi-model-agent#readme>**
+→ **[github.com/zhixuan312/multi-model-agent](https://github.com/zhixuan312/multi-model-agent)**
 
 ## License
 

package/dist/config/load.js

@@ -1,24 +1,24 @@
 import fs from 'fs';
 import { multiModelConfigSchema } from './schema.js';
 /**
- * Warn if any openai-compatible provider in the parsed config carries an
- * inline `apiKey` instead of using `apiKeyEnv`. The schema permits both for
- * backwards compatibility, but storing a plaintext API key in a config file
- * that may end up in a backup, dotfile repo, or git is a footgun. We surface
- * the issue at load time, once, so the operator notices.
+ * Warn if any openai-compatible agent in the parsed config carries an
+ * inline `apiKey` instead of using `apiKeyEnv`. The schema permits both,
+ * but storing a plaintext API key in a config file that may end up in a
+ * backup, dotfile repo, or git is a footgun. We surface the issue at load
+ * time, once, so the operator notices.
  */
 function warnOnInlineApiKey(config, configPath) {
     const offenders = [];
-    for (const [name, provider] of Object.entries(config.providers)) {
-        if (provider.type === 'openai-compatible' &&
-            typeof provider.apiKey === 'string') {
+    for (const [name, agent] of Object.entries(config.agents)) {
+        if (agent.type === 'openai-compatible' &&
+            typeof agent.apiKey === 'string') {
             offenders.push(name);
         }
     }
     if (offenders.length > 0) {
         // eslint-disable-next-line no-console
         console.warn(`[multi-model-agent] WARNING: ${configPath} stores an inline \`apiKey\` for ` +
-            `provider(s): ${offenders.join(', ')}. Prefer \`apiKeyEnv\` and read the key ` +
+            `agent(s): ${offenders.join(', ')}. Prefer \`apiKeyEnv\` and read the key ` +
             `from an environment variable so it never lands in version control.`);
     }
 }

package/dist/config/load.js.map

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,MAAwB,EAAE,UAAkB;IACtE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,IACE,QAAQ,CAAC,IAAI,KAAK,mBAAmB;YACrC,OAAQ,QAAiC,CAAC,MAAM,KAAK,QAAQ,EAC7D,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,gCAAgC,UAAU,mCAAmC;YAC3E,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C;YAC9E,oEAAoE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACvC,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjD,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChG,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,MAAwB,EAAE,UAAkB;IACtE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IACE,KAAK,CAAC,IAAI,KAAK,mBAAmB;YAClC,OAAQ,KAA8B,CAAC,MAAM,KAAK,QAAQ,EAC1D,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,gCAAgC,UAAU,mCAAmC;YAC3E,aAAa,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C;YAC3E,oEAAoE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACvC,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjD,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChG,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/config/schema.d.ts

@@ -1,285 +1,179 @@
 import { z } from 'zod';
 import type { MultiModelConfig } from '../types.js';
-export declare const codexProviderConfigSchema: z.ZodObject<{
-    type: z.ZodLiteral<"codex">;
-    model: z.ZodString;
-    effort: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        none: "none";
-    }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        "cwd-only": "cwd-only";
-    }>>;
-    hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        web_search: "web_search";
-        image_generation: "image_generation";
-        code_interpreter: "code_interpreter";
-    }>>>;
-    costTier: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        free: "free";
-    }>>;
-    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const claudeProviderConfigSchema: z.ZodObject<{
-    type: z.ZodLiteral<"claude">;
-    model: z.ZodString;
-    effort: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        none: "none";
-    }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        "cwd-only": "cwd-only";
-    }>>;
-    hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        web_search: "web_search";
-        image_generation: "image_generation";
-        code_interpreter: "code_interpreter";
-    }>>>;
-    costTier: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        free: "free";
-    }>>;
-    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const openAICompatibleProviderConfigSchema: z.ZodObject<{
-    type: z.ZodLiteral<"openai-compatible">;
-    model: z.ZodString;
-    baseUrl: z.ZodString;
-    apiKey: z.ZodOptional<z.ZodString>;
-    apiKeyEnv: z.ZodOptional<z.ZodString>;
-    effort: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        none: "none";
-    }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        "cwd-only": "cwd-only";
-    }>>;
-    hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        web_search: "web_search";
-        image_generation: "image_generation";
-        code_interpreter: "code_interpreter";
-    }>>>;
-    costTier: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        free: "free";
-    }>>;
-    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"codex">;
-    model: z.ZodString;
-    effort: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        none: "none";
-    }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        "cwd-only": "cwd-only";
-    }>>;
-    hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        web_search: "web_search";
-        image_generation: "image_generation";
-        code_interpreter: "code_interpreter";
-    }>>>;
-    costTier: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        free: "free";
-    }>>;
-    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"claude">;
-    model: z.ZodString;
-    effort: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        none: "none";
-    }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        "cwd-only": "cwd-only";
-    }>>;
-    hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        web_search: "web_search";
-        image_generation: "image_generation";
-        code_interpreter: "code_interpreter";
-    }>>>;
-    costTier: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        free: "free";
-    }>>;
-    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"openai-compatible">;
-    model: z.ZodString;
-    baseUrl: z.ZodString;
-    apiKey: z.ZodOptional<z.ZodString>;
-    apiKeyEnv: z.ZodOptional<z.ZodString>;
-    effort: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        none: "none";
-    }>>;
-    maxTurns: z.ZodOptional<z.ZodNumber>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        "cwd-only": "cwd-only";
-    }>>;
-    hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        web_search: "web_search";
-        image_generation: "image_generation";
-        code_interpreter: "code_interpreter";
-    }>>>;
-    costTier: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-        free: "free";
-    }>>;
-    inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-    inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>], "type">;
 export declare const multiModelConfigSchema: z.ZodObject<{
-    providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"codex">;
-        model: z.ZodString;
-        effort: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
-            low: "low";
-            none: "none";
-        }>>;
-        maxTurns: z.ZodOptional<z.ZodNumber>;
-        timeoutMs: z.ZodOptional<z.ZodNumber>;
-        sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            "cwd-only": "cwd-only";
-        }>>;
-        hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            web_search: "web_search";
-            image_generation: "image_generation";
-            code_interpreter: "code_interpreter";
-        }>>>;
-        costTier: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
-            low: "low";
-            free: "free";
-        }>>;
-        inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-        outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-        inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"claude">;
-        model: z.ZodString;
-        effort: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
-            low: "low";
-            none: "none";
-        }>>;
-        maxTurns: z.ZodOptional<z.ZodNumber>;
-        timeoutMs: z.ZodOptional<z.ZodNumber>;
-        sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            "cwd-only": "cwd-only";
-        }>>;
-        hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            web_search: "web_search";
-            image_generation: "image_generation";
-            code_interpreter: "code_interpreter";
-        }>>>;
-        costTier: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
-            low: "low";
-            free: "free";
-        }>>;
-        inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-        outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-        inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"openai-compatible">;
-        model: z.ZodString;
-        baseUrl: z.ZodString;
-        apiKey: z.ZodOptional<z.ZodString>;
-        apiKeyEnv: z.ZodOptional<z.ZodString>;
-        effort: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
-            low: "low";
-            none: "none";
-        }>>;
-        maxTurns: z.ZodOptional<z.ZodNumber>;
-        timeoutMs: z.ZodOptional<z.ZodNumber>;
-        sandboxPolicy: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            "cwd-only": "cwd-only";
-        }>>;
-        hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            web_search: "web_search";
-            image_generation: "image_generation";
-            code_interpreter: "code_interpreter";
-        }>>>;
-        costTier: z.ZodOptional<z.ZodEnum<{
-            high: "high";
-            medium: "medium";
-            low: "low";
-            free: "free";
-        }>>;
-        inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-        outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
-        inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>], "type">>>;
+    agents: z.ZodObject<{
+        standard: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            model: z.ZodString;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                web_fetch: "web_fetch";
+            }>>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+                none: "none";
+            }>>;
+            inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                "cwd-only": "cwd-only";
+            }>>;
+            inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"openai-compatible">;
+            baseUrl: z.ZodString;
+            apiKey: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+            }>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            model: z.ZodString;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                web_fetch: "web_fetch";
+            }>>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+                none: "none";
+            }>>;
+            inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                "cwd-only": "cwd-only";
+            }>>;
+            inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"claude">;
+            hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                image_generation: "image_generation";
+                code_interpreter: "code_interpreter";
+            }>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            model: z.ZodString;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                web_fetch: "web_fetch";
+            }>>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+                none: "none";
+            }>>;
+            inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                "cwd-only": "cwd-only";
+            }>>;
+            inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"codex">;
+            hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                image_generation: "image_generation";
+                code_interpreter: "code_interpreter";
+            }>>>;
+        }, z.core.$strict>], "type">;
+        complex: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            model: z.ZodString;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                web_fetch: "web_fetch";
+            }>>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+                none: "none";
+            }>>;
+            inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                "cwd-only": "cwd-only";
+            }>>;
+            inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"openai-compatible">;
+            baseUrl: z.ZodString;
+            apiKey: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+            }>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            model: z.ZodString;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                web_fetch: "web_fetch";
+            }>>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+                none: "none";
+            }>>;
+            inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                "cwd-only": "cwd-only";
+            }>>;
+            inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"claude">;
+            hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                image_generation: "image_generation";
+                code_interpreter: "code_interpreter";
+            }>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            model: z.ZodString;
+            capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                web_fetch: "web_fetch";
+            }>>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+                none: "none";
+            }>>;
+            inputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            outputCostPerMTok: z.ZodOptional<z.ZodNumber>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                "cwd-only": "cwd-only";
+            }>>;
+            inputTokenSoftLimit: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodLiteral<"codex">;
+            hostedTools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                web_search: "web_search";
+                image_generation: "image_generation";
+                code_interpreter: "code_interpreter";
+            }>>>;
+        }, z.core.$strict>], "type">;
+    }, z.core.$strip>;
     defaults: z.ZodDefault<z.ZodObject<{
         maxTurns: z.ZodDefault<z.ZodNumber>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;
         tools: z.ZodDefault<z.ZodEnum<{
+            readonly: "readonly";
             none: "none";
             full: "full";
         }>>;