@namzu/sdk 15.1.0 → 17.0.0

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog
 
+## 17.0.0
+
+### Major Changes
+
+- 8348589: **A declared provider chain now falls over.** It was validated, doctor-checked and capability-refused, and nothing ever used it — `providers[1..N]` were decoration. They are not any more.
+
+  **If you have one provider, nothing changes.** A one-member chain composes to exactly the previous behaviour, byte for byte, and emits no new events.
+
+  **If you have declared fallbacks, they will now be used.** Your primary still gets its full retry budget first, and a `Retry-After` is still honoured before anything moves — but a rejected credential, a missing model, an exhausted rate limit or an outage now advances to the next member instead of failing the turn. The scope is the turn: your next message starts at the primary again.
+
+  namzu will not fall over on a failure that is a property of your _request_ — a context overflow, a rejected request, a refusal — because the identical request fails identically on the next provider.
+
+  **Every swap is announced.** A new `provider_fallback` run event, `provider.fallback` on the wire, and a transcript line in the CLI naming the member that failed, why, and the member now serving.
+
+  **That announcement is why this is a major.** `RunEvent` and `StreamEventType` are wider, so a consumer that switches exhaustively over either — with no `default` and a `never` check — stops compiling until it adds an arm. That is not a hypothetical: the SDK's own A2A mapper, SSE mapper and run reporter all do it, and the compiler named all three in this change, exactly as it did in 12.0.0 when `plan_completed` and `plan_failed` were added and that release went out as a major for this reason. Widening a union a consumer reads is a break in this repo whatever the ecosystem convention is; the fix is one `case` per new member.
+
+  **A fallover loses the prompt cache**, so the rest of the turn re-reads your whole context at full price. That is the largest single cost of running a chain and it is worth ordering the chain accordingly.
+
+  **Breaking for one combination, and only that one:** `query()` now throws `invalid_config` when `pricing` is passed together with a chain of more than one member. One pricing table cannot price two members, so the reported total — and `runConfig.costLimitUsd`, which is enforced from it — would be wrong by an unbounded margin and silently so. To keep pricing, declare one member; to keep the chain, drop `pricing`. No existing caller can hit this, because the chain is only reachable through the new `fallbackProviders` option.
+
+  New in `@namzu/sdk`: `withProviderFallback`, `ProviderChainMember`, `WithProviderFallbackOptions`, `QueryParams.fallbackProviders`, `StreamChunk.fallback`, `ProviderFallbackNotice`.
+
+  A fallback with no credential is left out of the chain and named at launch, rather than discovered as a 401 on the day your primary goes down. Sub-agents resolve their provider independently and do not inherit the chain.
+
+## 16.0.0
+
+### Major Changes
+
+- 61b5cc8: `parseFrontmatter` refuses a block-sequence list instead of silently dropping it.
+
+  ```yaml
+  ---
+  allowed-tools:
+    - Read
+    - Bash
+  ---
+  ```
+
+  Those lines carry no `:`, so they were skipped, and the key came back **absent**
+  — not empty, absent. Meanwhile the flow form `[Read, Bash]` threw. One spelling
+  of a list was a hard error and the other was silence, and the silent one is the
+  spelling people actually write, because the block form is the natural YAML for
+  a list.
+
+  **What breaks.** A file whose frontmatter uses a `- ` list now throws where it
+  previously parsed. If you load skills or commands from files you did not write,
+  one of them may start being refused.
+
+  **What to do.** Write the value on one line:
+
+  ```yaml
+  allowed-tools: Read, Bash
+  ```
+
+  The error names the key and the file.
+
+  **Why this is worth a major rather than left alone.** The file that now throws
+  was never working. `allowed-tools` is a capability list: a skill that asked for
+  `Bash`, had the request silently discarded, and ran without it is
+  indistinguishable — from the author's side and from the log's — from a skill
+  that never asked. That is a capability quietly not granted, which is worse than
+  a file that will not load, because the second one tells you.
+
+  In `@namzu/cli` this surfaces as it should: the skill is listed with `⚠` and the
+  parse error rather than disappearing, and the rest of the roster keeps working.
+
+  Not affected: an ordinary indented mapping still parses, and a hyphen inside a
+  value — `description: a - b` — is prose, not a list, and is left alone.
+
 ## 15.1.0
 
 ### Minor Changes

package/dist/bridge/a2a/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAGd,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AA0PzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAO3F;AAED,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,yBAAmB,CAAA"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAGd,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AA0QzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAO3F;AAED,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,yBAAmB,CAAA"}

package/dist/bridge/a2a/mapper.js

@@ -63,6 +63,19 @@ const MAPPING = {
             },
         ],
     }),
+    // A swap is news for a remote peer for the same reason it is news for a
+    // local operator: the answer arriving next was produced by a provider the
+    // peer did not ask for. Still `running` — the run did not fail, it moved.
+    provider_fallback: (e, ctx) => statusEvent(e.runId, 'running', false, ctx, {
+        role: 'agent',
+        parts: [
+            {
+                kind: 'text',
+                text: `Provider ${e.fromProviderId}${e.fromModel ? ` (${e.fromModel})` : ''} could not serve ` +
+                    `(${e.code}); continuing on ${e.toProviderId}${e.toModel ? ` (${e.toModel})` : ''}`,
+            },
+        ],
+    }),
     tool_completed: (e, ctx) => artifactEvent(e.runId, ctx, {
         artifactId: `tool-${e.toolName}-${Date.now()}`,
         name: `${e.toolName} result`,

package/dist/bridge/a2a/mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"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"}

package/dist/bridge/sse/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AAseD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,GAAG,IAAI,CAkB3F;AAED,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,4BAAsB,CAAA"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AAufD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,GAAG,IAAI,CAkB3F;AAED,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,4BAAsB,CAAA"}

package/dist/bridge/sse/mapper.js

@@ -119,6 +119,22 @@ const MAPPING = {
             server_directed: e.serverDirected,
         }),
     },
+    provider_fallback: {
+        wire: 'provider.fallback',
+        transform: (e, runId) => ({
+            run_id: runId,
+            iteration: e.iteration,
+            from_index: e.fromIndex,
+            from_provider_id: e.fromProviderId,
+            from_model: e.fromModel,
+            to_index: e.toIndex,
+            to_provider_id: e.toProviderId,
+            to_model: e.toModel,
+            code: e.code,
+            status: e.status,
+            reason: e.reason,
+        }),
+    },
     user_question_asked: {
         wire: 'question.asked',
         transform: (e, runId) => ({

package/dist/bridge/sse/mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"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"}

package/dist/contracts/api.d.ts

@@ -133,7 +133,14 @@ export type StreamEventType = 'run.started' | 'run.completed' | 'run.failed' | '
  * whole backoff, so a run that is about to succeed is indistinguishable
  * from one that has hung.
  */
- | 'provider.retry' | 'tool.executing'
+ | 'provider.retry'
+/**
+ * A member of the provider chain could not serve and a later member has
+ * taken over. Wire-visible because a client that is not told has no way to
+ * know the answer it is reading came from a provider it did not ask for —
+ * at a different price, and possibly a different quality.
+ */
+ | 'provider.fallback' | 'tool.executing'
 /** Ephemeral progress from a long-running tool. Not in the transcript. */
  | 'tool.progress' | 'tool.completed' | 'tool.error' | 'tool.input_started' | 'tool.input_delta' | 'tool.input_completed' | 'token.usage' | 'message.created' | 'message.delta' | 'message.completed'
 /**

package/dist/contracts/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/contracts/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/contracts/api.ts"],"names":[],"mappings":"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"}

package/dist/provider/fallback.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Advance through a declared provider chain when a member cannot serve.
+ *
+ * The sibling of `withProviderRetry`, one level out: retry asks "will the SAME
+ * member succeed if I ask again?", this asks "will ANOTHER member succeed if I
+ * ask it instead?". They compose in exactly one order —
+ * `fallback(retry(m0), retry(m1), …)` — and that order is the policy, not an
+ * implementation detail:
+ *
+ *  - the primary is the operator's choice and gets its retries first, so a
+ *    throttle or a 5xx only reaches this decorator once the inner budget is
+ *    spent;
+ *  - a failure the inner loop refuses to retry (`auth`, `not_found`) arrives
+ *    here immediately, which is what "fall over at once on a bad credential"
+ *    means — retrying a wrong key just spends the turn;
+ *  - a server-directed `Retry-After` is honoured by the inner loop before any
+ *    error escapes, so a transient wait is a wait and not a swap.
+ *
+ * None of those three behaviours is implemented here. They fall out of the
+ * nesting, which is why `query()` builds the composition rather than letting a
+ * host assemble it in whichever order it happens to pick.
+ */
+import type { LLMProvider } from '../types/provider/index.js';
+import type { Logger } from '../utils/logger.js';
+/**
+ * One member of the chain: a constructed provider, and the model to ask it for.
+ *
+ * `model` overrides {@link ChatCompletionParams.model} for this member's
+ * requests and nothing else. Every shipped driver reads that field
+ * (`params.model`, or `params.model || <its configured default>`), so a member
+ * needs no reconstruction to be asked for a different model — which is what
+ * keeps this decorator ignorant of credentials, base URLs and registries. A
+ * chain is an ordered list of (provider, model); building one is the host's
+ * job, walking it is this file's.
+ *
+ * Absent means "whatever the request already asked for", which is the right
+ * default for a member declared without a model: the registry default was
+ * resolved into the request before it got here.
+ */
+export interface ProviderChainMember {
+    readonly provider: LLMProvider;
+    readonly model?: string;
+}
+export interface WithProviderFallbackOptions {
+    readonly log?: Logger;
+}
+/**
+ * Wrap an ordered chain so a member that cannot serve is replaced in place.
+ *
+ * ## The cursor's lifetime IS the scope
+ *
+ * Once this decorator advances, every later request in its life goes to the new
+ * member; the chain never rewinds. That is deliberate and it is how "the
+ * primary is restored at each new user message" is implemented — by NOT
+ * implementing it. `query()` builds one of these per call and a host's call is
+ * its turn, so the cursor cannot outlive the turn because the object cannot.
+ * There is no reset to forget to call, and no way for a rate limit at 14:00 to
+ * leave an operator on a cheaper model at 17:00.
+ *
+ * Rewinding within the turn would be the alternative, and it is worse: the
+ * member that just failed would be re-asked on the next iteration of the same
+ * turn, which is a retry wearing a chain's clothes and which the inner
+ * decorator already declined to do.
+ *
+ * ## Each member is tried at most once per turn, and the whole chain is walked
+ *
+ * A chain of N members yields up to N attempts, not one. An operator who
+ * declares four members and is served only by the second on a bad day has been
+ * given three decorative entries — that is the declared-but-undriven defect
+ * this file exists to remove, and stopping after one step would reintroduce it
+ * at position 2 instead of position 1. When the last member fails, its error is
+ * thrown untouched and ordinary error handling takes over.
+ *
+ * ## Once output is out, there is no fallback
+ *
+ * Inherited from retry, for the same reason and not a weaker one: a stream that
+ * has emitted bytes cannot be restarted without duplicating them, and the
+ * consumer has already appended them to a message it is rendering. A mid-stream
+ * failure after output is surfaced, never swapped. See {@link isOutputChunk} —
+ * the definition of "output" is where this property is actually won or lost.
+ *
+ * ## Capabilities are the head's
+ *
+ * The getters below are transparent, so a run negotiates tools, vision and
+ * documents ONCE against `members[0]` and keeps that answer after a swap. This
+ * is a real limitation and it is why the host is expected to refuse a chain
+ * whose members disagree before ever building one (`@namzu/cli` does, and only
+ * runs a mismatched chain when the operator has said so explicitly). Taking the
+ * intersection here instead would cost the primary a capability on every run to
+ * guard against a failure that happens rarely.
+ */
+export declare function withProviderFallback(members: readonly ProviderChainMember[], options?: WithProviderFallbackOptions): LLMProvider;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/provider/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/provider/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAwB,WAAW,EAAe,MAAM,4BAA4B,CAAA;AAChG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACrB;AAgGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,OAAO,GAAE,2BAAgC,GACvC,WAAW,CA0Gb"}

package/dist/provider/fallback.js

@@ -0,0 +1,265 @@
+/**
+ * Advance through a declared provider chain when a member cannot serve.
+ *
+ * The sibling of `withProviderRetry`, one level out: retry asks "will the SAME
+ * member succeed if I ask again?", this asks "will ANOTHER member succeed if I
+ * ask it instead?". They compose in exactly one order —
+ * `fallback(retry(m0), retry(m1), …)` — and that order is the policy, not an
+ * implementation detail:
+ *
+ *  - the primary is the operator's choice and gets its retries first, so a
+ *    throttle or a 5xx only reaches this decorator once the inner budget is
+ *    spent;
+ *  - a failure the inner loop refuses to retry (`auth`, `not_found`) arrives
+ *    here immediately, which is what "fall over at once on a bad credential"
+ *    means — retrying a wrong key just spends the turn;
+ *  - a server-directed `Retry-After` is honoured by the inner loop before any
+ *    error escapes, so a transient wait is a wait and not a swap.
+ *
+ * None of those three behaviours is implemented here. They fall out of the
+ * nesting, which is why `query()` builds the composition rather than letting a
+ * host assemble it in whichever order it happens to pick.
+ */
+import { classifyProviderError, isAbortError } from '../types/provider/errors.js';
+/**
+ * Failures that are a property of the REQUEST rather than of the member serving
+ * it.
+ *
+ * This is the whole decision, stated once. A request fault reproduces
+ * identically on the next member, so falling over would spend a second
+ * provider's money to buy the same error. Everything else — a throttle, an
+ * outage, a rejected credential, a model this provider does not have, a stream
+ * that came back malformed — is a fact about the member, and the next member is
+ * worth asking.
+ *
+ * The three entries, and what each of them being here means:
+ *
+ * - `context_length_exceeded` — the run's own remedy is compaction, which sheds
+ *   history and asks again. Falling over instead would carry the same oversized
+ *   prompt to a provider that has not been given the chance to fit it. Note the
+ *   limit of that reasoning: a chain MAY pair a small window with a larger one,
+ *   and then a fallback genuinely could have succeeded. Compaction is still
+ *   preferred because it is cheaper and it keeps the operator on the provider
+ *   they chose.
+ * - `invalid_request` — namzu built a request the provider rejected. The
+ *   counter-case is real and is recorded here rather than hidden: drivers
+ *   translate the same tool schema differently onto the wire, so a 400 about a
+ *   JSON Schema dialect (see `provider/errors.ts`) is provider-specific and
+ *   another member might accept it. Abort still wins, because the common case
+ *   is a request that is wrong everywhere, and spending the entire chain to
+ *   rediscover one defect is the worse failure.
+ * - `content_filter` — a refusal. No shipped driver reaches this through a
+ *   THROW today: the drivers that surface a filtered completion do so as
+ *   `finishReason: 'content_filter'`, which is a finished stream, not an error.
+ *   The input that makes this entry fire is a driver that throws instead — the
+ *   classifier maps a `content_policy_violation` structural code onto it, and
+ *   `ProviderError` is a public type a third-party driver constructs directly.
+ *   Named rather than omitted for that reason; see
+ *   `docs/conventions/a-check-that-cannot-fail.md` for why an unnameable one
+ *   would have been left out.
+ */
+const REQUEST_FAULT_CODES = new Set([
+    'context_length_exceeded',
+    'invalid_request',
+    'content_filter',
+]);
+/**
+ * Does this failure justify asking the next member?
+ *
+ * The classification is taken from `classifyProviderError` and not re-derived.
+ * A second classifier that disagreed with the first would be two answers to one
+ * question, and the retry decorator already stands on that same answer.
+ *
+ * `status === 404` is read ALONGSIDE the code, and it is not a second opinion —
+ * it is a second field of the one classification. A 404 reaches `not_found`
+ * only on the unclassified path (`codeFromStatus`). A driver that classified
+ * its own 404 into a `ProviderRequestError` gets `kind: 'bad_request'` from
+ * `classifyProviderHttpStatus`, which `KIND_TO_CODE` maps to
+ * `invalid_request` — a request fault, so the run would ABORT on a model the
+ * next member may well have. The status survives on both paths; the code does
+ * not, so the status is what this reads.
+ */
+function shouldFallOver(err, providerId) {
+    const classified = classifyProviderError(err, providerId);
+    if (classified.status === 404)
+        return true;
+    return !REQUEST_FAULT_CODES.has(classified.code);
+}
+/**
+ * Has the consumer already been handed something a restart would duplicate?
+ *
+ * Deliberately NOT the retry decorator's rule, and the difference is the bug
+ * this function exists to prevent. Retry treats every chunk that is not
+ * error-only as output, which is correct INSIDE retry because each attempt
+ * starts with the flag cleared. Reused one level out it is wrong in the worst
+ * possible place: the inner decorator emits a backoff notice through this
+ * stream on its way to sleeping, that notice is not error-only, and a fallback
+ * reading it as output would refuse to advance for the rest of the turn — for
+ * the 429/5xx path, which is the main reason a chain is declared at all.
+ *
+ * So this asks the narrow question instead: did a chunk carry something the
+ * orchestrator turned into a visible event? `text_delta`, tool-input fragments
+ * and their per-tool boundary, reasoning blocks and citations all did.
+ * `usage`, `finishReason` and the two control notices did not.
+ */
+function isOutputChunk(chunk) {
+    if (chunk.retry !== undefined || chunk.fallback !== undefined)
+        return false;
+    const { content, toolCalls, toolCallEnd, reasoning, citation } = chunk.delta;
+    return Boolean(content ||
+        toolCalls?.length ||
+        toolCallEnd ||
+        reasoning !== undefined ||
+        citation !== undefined);
+}
+/**
+ * Wrap an ordered chain so a member that cannot serve is replaced in place.
+ *
+ * ## The cursor's lifetime IS the scope
+ *
+ * Once this decorator advances, every later request in its life goes to the new
+ * member; the chain never rewinds. That is deliberate and it is how "the
+ * primary is restored at each new user message" is implemented — by NOT
+ * implementing it. `query()` builds one of these per call and a host's call is
+ * its turn, so the cursor cannot outlive the turn because the object cannot.
+ * There is no reset to forget to call, and no way for a rate limit at 14:00 to
+ * leave an operator on a cheaper model at 17:00.
+ *
+ * Rewinding within the turn would be the alternative, and it is worse: the
+ * member that just failed would be re-asked on the next iteration of the same
+ * turn, which is a retry wearing a chain's clothes and which the inner
+ * decorator already declined to do.
+ *
+ * ## Each member is tried at most once per turn, and the whole chain is walked
+ *
+ * A chain of N members yields up to N attempts, not one. An operator who
+ * declares four members and is served only by the second on a bad day has been
+ * given three decorative entries — that is the declared-but-undriven defect
+ * this file exists to remove, and stopping after one step would reintroduce it
+ * at position 2 instead of position 1. When the last member fails, its error is
+ * thrown untouched and ordinary error handling takes over.
+ *
+ * ## Once output is out, there is no fallback
+ *
+ * Inherited from retry, for the same reason and not a weaker one: a stream that
+ * has emitted bytes cannot be restarted without duplicating them, and the
+ * consumer has already appended them to a message it is rendering. A mid-stream
+ * failure after output is surfaced, never swapped. See {@link isOutputChunk} —
+ * the definition of "output" is where this property is actually won or lost.
+ *
+ * ## Capabilities are the head's
+ *
+ * The getters below are transparent, so a run negotiates tools, vision and
+ * documents ONCE against `members[0]` and keeps that answer after a swap. This
+ * is a real limitation and it is why the host is expected to refuse a chain
+ * whose members disagree before ever building one (`@namzu/cli` does, and only
+ * runs a mismatched chain when the operator has said so explicitly). Taking the
+ * intersection here instead would cost the primary a capability on every run to
+ * guard against a failure that happens rarely.
+ */
+export function withProviderFallback(members, options = {}) {
+    const first = members[0];
+    if (!first) {
+        throw new Error('withProviderFallback needs at least one member');
+    }
+    // A one-member chain is the identity. Returning the provider itself rather
+    // than a wrapper that can never advance keeps the no-chain path byte-identical
+    // to what it was before this file existed.
+    if (members.length === 1)
+        return first.provider;
+    const log = options.log;
+    let cursor = 0;
+    async function* chatStream(params) {
+        for (;;) {
+            const member = members[cursor];
+            // Unreachable while `cursor` only ever moves to an index this loop has
+            // bounds-checked below; kept because the alternative on a future edit is
+            // calling `chatStream` on undefined, which names neither the field nor
+            // the fix.
+            if (!member)
+                throw new Error(`provider chain has no member at position ${cursor}`);
+            const request = member.model !== undefined ? { ...params, model: member.model } : params;
+            let produced = false;
+            try {
+                for await (const chunk of member.provider.chatStream(request)) {
+                    if (isOutputChunk(chunk))
+                        produced = true;
+                    yield chunk;
+                }
+                return;
+            }
+            catch (err) {
+                // A Stop is control flow, not a provider failure. Without this the
+                // classifier — which has no concept of cancellation — would file an
+                // abort as some ordinary failure and the run would walk the entire
+                // chain re-issuing an already-cancelled request, one member at a
+                // time, instead of settling as `cancelled`. The retry decorator
+                // guards the same way and for the same reason.
+                if (isAbortError(err) || params.signal?.aborted)
+                    throw err;
+                const next = cursor + 1;
+                const to = members[next];
+                if (produced || !to || !shouldFallOver(err, member.provider.id)) {
+                    log?.warn('Provider chain: not falling over', {
+                        provider: member.provider.id,
+                        position: cursor,
+                        reason: produced
+                            ? 'stream already produced output — cannot restart without duplicating it'
+                            : !to
+                                ? 'chain exhausted'
+                                : 'the failure is a property of the request, not of the provider',
+                    });
+                    throw err;
+                }
+                const classified = classifyProviderError(err, member.provider.id);
+                cursor = next;
+                log?.warn('Provider chain: falling over', {
+                    from: member.provider.id,
+                    fromPosition: cursor - 1,
+                    to: to.provider.id,
+                    toPosition: cursor,
+                    code: classified.code,
+                    status: classified.status,
+                });
+                // In-band, exactly like the retry notice and for the same reason: the
+                // consumer is blocked inside this iterator, so the stream is the only
+                // channel that reaches it at the moment the swap happens rather than
+                // after the replacement request has already run.
+                yield {
+                    id: '',
+                    delta: {},
+                    fallback: {
+                        fromIndex: cursor - 1,
+                        fromProviderId: member.provider.id,
+                        ...(member.model !== undefined ? { fromModel: member.model } : {}),
+                        toIndex: cursor,
+                        toProviderId: to.provider.id,
+                        ...(to.model !== undefined ? { toModel: to.model } : {}),
+                        code: classified.code,
+                        ...(classified.status !== undefined ? { status: classified.status } : {}),
+                        reason: classified.message,
+                    },
+                };
+            }
+        }
+    }
+    // Transparent to capability negotiation and identity, like the retry
+    // decorator. The head's declarations are what a run is configured from; see
+    // the note on capabilities above for the limitation that carries.
+    return {
+        get id() {
+            return first.provider.id;
+        },
+        get name() {
+            return first.provider.name;
+        },
+        get capabilities() {
+            return first.provider.capabilities;
+        },
+        chatStream,
+        ...(first.provider.listModels ? { listModels: () => first.provider.listModels?.() } : {}),
+        ...(first.provider.healthCheck ? { healthCheck: () => first.provider.healthCheck?.() } : {}),
+        ...(first.provider.doctorCheck ? { doctorCheck: () => first.provider.doctorCheck?.() } : {}),
+    };
+}
+//# sourceMappingURL=fallback.js.map

package/dist/provider/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/provider/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AA4BjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACxD,yBAAyB;IACzB,iBAAiB;IACjB,gBAAgB;CAChB,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,SAAS,cAAc,CAAC,GAAY,EAAE,UAAkB;IACvD,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACzD,IAAI,UAAU,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC1C,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,aAAa,CAAC,KAAkB;IACxC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC3E,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,KAAK,CAAA;IAC5E,OAAO,OAAO,CACb,OAAO;QACN,SAAS,EAAE,MAAM;QACjB,WAAW;QACX,SAAS,KAAK,SAAS;QACvB,QAAQ,KAAK,SAAS,CACvB,CAAA;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAuC,EACvC,UAAuC,EAAE;IAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IAClE,CAAC;IACD,2EAA2E;IAC3E,+EAA+E;IAC/E,2CAA2C;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAA;IAE/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IACvB,IAAI,MAAM,GAAG,CAAC,CAAA;IAEd,KAAK,SAAS,CAAC,CAAC,UAAU,CAAC,MAA4B;QACtD,SAAS,CAAC;YACT,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;YAC9B,uEAAuE;YACvE,yEAAyE;YACzE,uEAAuE;YACvE,WAAW;YACX,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,EAAE,CAAC,CAAA;YAElF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;YACxF,IAAI,QAAQ,GAAG,KAAK,CAAA;YACpB,IAAI,CAAC;gBACJ,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC/D,IAAI,aAAa,CAAC,KAAK,CAAC;wBAAE,QAAQ,GAAG,IAAI,CAAA;oBACzC,MAAM,KAAK,CAAA;gBACZ,CAAC;gBACD,OAAM;YACP,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,mEAAmE;gBACnE,oEAAoE;gBACpE,mEAAmE;gBACnE,iEAAiE;gBACjE,gEAAgE;gBAChE,+CAA+C;gBAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO;oBAAE,MAAM,GAAG,CAAA;gBAE1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAA;gBACvB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;gBACxB,IAAI,QAAQ,IAAI,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBACjE,GAAG,EAAE,IAAI,CAAC,kCAAkC,EAAE;wBAC7C,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;wBAC5B,QAAQ,EAAE,MAAM;wBAChB,MAAM,EAAE,QAAQ;4BACf,CAAC,CAAC,wEAAwE;4BAC1E,CAAC,CAAC,CAAC,EAAE;gCACJ,CAAC,CAAC,iBAAiB;gCACnB,CAAC,CAAC,+DAA+D;qBACnE,CAAC,CAAA;oBACF,MAAM,GAAG,CAAA;gBACV,CAAC;gBAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;gBACjE,MAAM,GAAG,IAAI,CAAA;gBACb,GAAG,EAAE,IAAI,CAAC,8BAA8B,EAAE;oBACzC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;oBACxB,YAAY,EAAE,MAAM,GAAG,CAAC;oBACxB,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE;oBAClB,UAAU,EAAE,MAAM;oBAClB,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,MAAM,EAAE,UAAU,CAAC,MAAM;iBACzB,CAAC,CAAA;gBAEF,sEAAsE;gBACtE,sEAAsE;gBACtE,qEAAqE;gBACrE,iDAAiD;gBACjD,MAAM;oBACL,EAAE,EAAE,EAAE;oBACN,KAAK,EAAE,EAAE;oBACT,QAAQ,EAAE;wBACT,SAAS,EAAE,MAAM,GAAG,CAAC;wBACrB,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;wBAClC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClE,OAAO,EAAE,MAAM;wBACf,YAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE;wBAC5B,GAAG,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACxD,IAAI,EAAE,UAAU,CAAC,IAAI;wBACrB,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzE,MAAM,EAAE,UAAU,CAAC,OAAO;qBAC1B;iBACD,CAAA;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,qEAAqE;IACrE,4EAA4E;IAC5E,kEAAkE;IAClE,OAAO;QACN,IAAI,EAAE;YACL,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAA;QACzB,CAAC;QACD,IAAI,IAAI;YACP,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC3B,CAAC;QACD,IAAI,YAAY;YACf,OAAO,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAA;QACnC,CAAC;QACD,UAAU;QACV,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAA;AACjB,CAAC"}