zidane 6.0.0 → 6.1.0

package/README.md

@@ -118,6 +118,31 @@ await agent.run({
 
 Precedence: `run.behavior` > `agent.behavior` > defaults.
 
+### Provider/model fallback
+
+`provider` also accepts an array, and `model` an ordered fallback list:
+
+```ts
+const agent = createAgent({
+  provider: [anthropic({ ... }), openrouter({ ... })], // names must be unique
+})
+
+await agent.run({
+  prompt: '…',
+  model: [
+    { provider: 'anthropic', model: 'claude-sonnet-4-5' },     // primary
+    { provider: 'openrouter', model: 'anthropic/claude-sonnet-4-5' },
+    'claude-haiku-4-5',   // bare string fans out across ALL providers, in order
+  ],
+})
+```
+
+The run resolves this into an ordered target list (`resolveModelTargets`). When a stream fails terminally on the active target — retry budget exhausted, or a non-retryable provider error like auth/billing — with nothing streamed yet, the loop advances to the next target and re-issues (tools are reformatted for the new provider's wire shape; messages are canonical, so no translation is needed). `context_exceeded` never falls back — it keeps its own overflow-recovery path.
+
+Fallback is **run-sticky**: once a run advances, it stays on that target; the next `run()` starts from the primary again. Each advancement fires the `model:fallback` hook (`from`, `to`, `targetIndex`, `err`); only the LAST target's terminal failure reaches `stream:error`. A plain `model: 'id'` with multiple providers means "try this model on every provider"; omitting `model` falls back across each provider's `meta.defaultModel`. Per-turn attribution is preserved via `TurnUsage.modelId` (the session run record's `providerName` keeps the primary's name).
+
+Two sizing notes: `maxTokens` and the thinking budget are NOT re-derived on fallback — they carry over from the primary, so size them for the smallest model in the chain (a target that rejects the carried budget just burns one advancement). In multi-provider setups every provider needs a non-empty, unique `name`. The auto-compact window DOES re-derive on fallback: object entries may carry a `contextWindow` (your catalog's value for that model), which re-bases even an explicit `autoCompact.contextWindow`; without it, meta-sourced windows re-resolve from the new provider's `meta.contextWindow` and explicit windows stay as set.
+
 ## CLI
 
 ```bash
@@ -508,6 +533,8 @@ definePreset({
 })
 ```
 
+Pass `models` (or `spawnTool.withModels(catalog)` at agent-build time) to let the model pick a per-spawn model: the schema gains a `model` field, entries are routed to the provider that serves them, and large catalogs defer to `createModelSearchTool(catalog)` instead of bloating the schema. Per-call `input.model` > subagent-type `model` > `createSpawnTool({ model })` > inherit the parent's. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details.
+
 ## Interaction Tool
 
 Pause the agent and request structured input. Not in any preset by default. `onRequest` may be async — the agent waits. Return a string or object.

package/dist/{acp-Irby04Us.js → acp-cfR8T19u.js}

@@ -1,12 +1,12 @@
 import { c as resolveReadStateMap, r as hashContent, s as readStateKey } from "./read-state-Dq_TXUX1.js";
 import { l as toolResultToText } from "./types-BIarq1qE.js";
-import { st as basic_default, t as createAgent } from "./agent-DkSmGkDM.js";
-import { n as createProcessContext } from "./contexts-Vone3qQQ.js";
+import { lt as basic_default, t as createAgent } from "./agent-DZRA7wip.js";
+import { n as createProcessContext } from "./contexts-BIbcfBFH.js";
 import { l as errorMessage } from "./errors-DJUxZg9b.js";
 import { t as effectiveInputFromTurn } from "./stats-DAKBEKjc.js";
-import { C as defaultPromptMessage } from "./openai-compat-BvgYGSR1.js";
-import { o as loadSession, t as createSession } from "./session-CsdDIPY8.js";
-import { r as fetchUrl } from "./fetch-url-CWE8X5OD.js";
+import { C as defaultPromptMessage } from "./openai-compat-B0kqvZqN.js";
+import { o as loadSession, t as createSession } from "./session-CsKzK8-P.js";
+import { r as fetchUrl } from "./fetch-url-_5WKWpbQ.js";
 import { webSearch } from "./tools/web-search.js";
 import { basename, resolve } from "node:path";
 import { Buffer } from "node:buffer";
@@ -978,7 +978,7 @@ const MODE_CONFIG_ID = "mode";
 const THINKING_CONFIG_ID = "thinking";
 const MODEL_OPTION_CONFIG_PREFIX = "model_option:";
 const PLAN_MODE_ID = "plan";
-const PLAN_READ_ONLY_TOOLS = new Set([
+const PLAN_READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
 	"read_file",
 	"list_files",
 	"grep",
@@ -1068,7 +1068,7 @@ var AcpServerImpl = class {
 		return ((this.options.model ? this.modelChoices.find((choice) => choice.id === this.options.model || choice.model === this.options.model) : void 0) ?? this.modelChoices[0]).id;
 	}
 	buildDefaultConfigOptions(userConfig) {
-		const reserved = new Set([MODE_CONFIG_ID]);
+		const reserved = /* @__PURE__ */ new Set([MODE_CONFIG_ID]);
 		const options = [{
 			id: MODE_CONFIG_ID,
 			name: "Mode",
@@ -1920,4 +1920,4 @@ function runAcpStdioServer(options) {
 //#endregion
 export { createJsonRpcConnection as _, wrapToolsForAcpClient as a, sessionBlocksToAcp as c, StartUsageError as d, buildStartLocalOptions as f, JsonRpcRemoteError as g, startProviderNames as h, withAcpDefaultTools as i, stopReasonFromRun as l, startLocalArgOptions as m, AcpProtocolError as n, acpMcpServersToZidane as o, parseStartArgValues as p, createAcpServer as r, acpPromptToPromptParts as s, runAcpStdioServer as t, toolResultToAcpContent as u };
 
-//# sourceMappingURL=acp-Irby04Us.js.map
+//# sourceMappingURL=acp-cfR8T19u.js.map