@graphrefly/graphrefly 0.27.0 → 0.29.0

package/dist/{meta-CbznRPYJ.d.ts → meta-CX7YsOzp.d.cts}

@@ -1,4 +1,4 @@
-import { v as NodeDescribeKind, N as Node, A as Actor } from './node-BmerH3kS.js';
+import { e as NodeDescribeKind, a as Node, A as Actor } from './node-Dd6wHSib.cjs';
 
 /**
  * JSON-shaped slice of a node for `Graph.describe()`
@@ -25,11 +25,11 @@ type DescribeNodeOutput = {
         timestamp_ns: number;
     }>;
     /**
-     * Latest reason annotation attached via `graph.trace(path, reason)`,
-     * when present. Populated by `Graph.describe` only — `describeNode`
-     * has no graph context.
+     * Latest annotation attached via `graph.trace(path, annotation)` or via
+     * `graph.add(node, { name: path, annotation })`, when present. Populated by
+     * `Graph.describe` only — `describeNode` has no graph context.
      */
-    reason?: string;
+    annotation?: string;
 };
 /** Detail level for progressive disclosure (Phase 3.3b). */
 type DescribeDetail = "minimal" | "standard" | "full";

package/dist/{meta-BxCA7rcr.d.cts → meta-CckhhFRd.d.ts}

@@ -1,4 +1,4 @@
-import { v as NodeDescribeKind, N as Node, A as Actor } from './node-BmerH3kS.cjs';
+import { e as NodeDescribeKind, a as Node, A as Actor } from './node-Dd6wHSib.js';
 
 /**
  * JSON-shaped slice of a node for `Graph.describe()`
@@ -25,11 +25,11 @@ type DescribeNodeOutput = {
         timestamp_ns: number;
     }>;
     /**
-     * Latest reason annotation attached via `graph.trace(path, reason)`,
-     * when present. Populated by `Graph.describe` only — `describeNode`
-     * has no graph context.
+     * Latest annotation attached via `graph.trace(path, annotation)` or via
+     * `graph.add(node, { name: path, annotation })`, when present. Populated by
+     * `Graph.describe` only — `describeNode` has no graph context.
      */
-    reason?: string;
+    annotation?: string;
 };
 /** Detail level for progressive disclosure (Phase 3.3b). */
 type DescribeDetail = "minimal" | "standard" | "full";

package/dist/{node-BmerH3kS.d.cts → node-Dd6wHSib.d.cts}

@@ -600,12 +600,31 @@ type NodeTransportOptions = {
 };
 /**
  * Cleanup return shape from a node {@link NodeFn}.
- * - `() => void` — fires before the next fn run AND on deactivation (default).
- * - `{ deactivation: () => void }` — fires only on deactivation (persistent
- *   resources that should survive across fn re-runs).
+ *
+ * Two forms, discriminated on return type:
+ *
+ * - `() => void` — fires before the next fn run AND on deactivation AND on
+ *   INVALIDATE. The simplest form: one cleanup function for every transition
+ *   away from the current run. Use when the same teardown logic applies to
+ *   all three.
+ *
+ * - `{ beforeRun?, deactivate?, invalidate? }` — granular hooks. Each hook
+ *   fires exactly once on its named transition; missing hooks are no-ops.
+ *   Use when only some transitions should flush resources (e.g. a measurement
+ *   cache that should survive re-runs but reset on deactivation).
+ *
+ *   - `beforeRun` fires before the next fn invocation (same point as the
+ *     function-form cleanup's pre-run hook).
+ *   - `deactivate` fires on deactivation (last-sink unsubscribe or TEARDOWN).
+ *   - `invalidate` fires on INVALIDATE (spec v0.4 graph-wide flush signal).
+ *
+ * Closure access: both forms are declared inside `NodeFn`, so hooks see the
+ * same closure as the fn body (per-run locals, `ctx.store`, dep refs).
  */
 type NodeFnCleanup = (() => void) | {
-    deactivation: () => void;
+    beforeRun?: () => void;
+    deactivate?: () => void;
+    invalidate?: () => void;
 };
 /**
  * Fn-time context exposing per-wave metadata and a per-node persistent
@@ -647,8 +666,10 @@ interface FnCtx {
  *   the latest; iterate for multi-emission processing.
  *
  * Emission is explicit via `actions.emit(v)` (sugar: equals + framing) or
- * `actions.down(msgs)` (raw). Return a cleanup function (or
- * `{ deactivation }`) to register teardown — any non-cleanup return value
+ * `actions.down(msgs)` (raw). Return a cleanup shape to register teardown:
+ * `() => void` (fires on every transition) or
+ * `{ beforeRun?, deactivate?, invalidate? }` (each hook fires on its named
+ * transition only). See {@link NodeFnCleanup}. Any non-cleanup return value
  * is ignored. The `| void` leg lets arrow-block bodies satisfy `NodeFn`
  * without an explicit `return undefined`.
  *
@@ -679,6 +700,29 @@ interface NodeOptions<T = unknown> {
      * explicitly via `ctx.terminalDeps`.
      */
     errorWhenDepsError?: boolean;
+    /**
+     * First-run gate (§2.7). When `false` (default — matches the universal
+     * contract "fn does not fire until every declared dep has delivered"), fn
+     * is held until every declared dep has delivered at least one DATA or
+     * terminal. Sugar constructors (`derived`, `effect`) inherit the default
+     * so multi-parent activation produces one combined initial wave
+     * `[[START], [DIRTY], [DATA, fn(init...)]]` instead of the sequential
+     * `[[START], [DIRTY], [RESOLVED], [DIRTY], [DATA]]` shape produced by
+     * per-dep push-on-subscribe firings.
+     *
+     * When `true`, fn fires as soon as `_dirtyDepCount === 0` regardless of
+     * whether any dep is still sentinel. Operators like `withLatestFrom`,
+     * `valve`, and worker-bridge aggregators that deliberately fire on
+     * partial deps pass `partial: true` explicitly. Zero-dep producer-pattern
+     * factories (`stratify`, `budgetGate`, etc.) are unaffected either way —
+     * an empty `_deps` array has nothing for the gate to hold on.
+     *
+     * Gate scope: applies only until fn has fired once (`_hasCalledFnOnce`).
+     * Subsequent waves, INVALIDATE, and `_addDep` do not re-gate. Terminal
+     * reset (resubscribable node reconnect) resets `_hasCalledFnOnce` and
+     * re-arms the gate.
+     */
+    partial?: boolean;
     /**
      * Tier-2 PAUSE/RESUME handling.
      * - `true` (default): wave completion suppressed while paused; fn fires
@@ -756,8 +800,9 @@ interface Node<T = unknown> {
  * - `true` — dep sent COMPLETE.
  * - anything else — dep sent ERROR with that payload.
  *
- * Edge case: an ERROR carrying an `undefined` payload is indistinguishable
- * from "live". Pass meaningful error values (Error objects, domain tags).
+ * `[ERROR, undefined]` is rejected at the dispatch boundary (`_emit`) per
+ * spec §1.2 — `undefined` would collide with the "live" encoding here.
+ * Always pass meaningful error values (Error objects, domain tags).
  */
 interface DepRecord {
     readonly node: Node;
@@ -885,6 +930,15 @@ declare class NodeImpl<T = unknown> implements Node<T> {
     readonly _autoComplete: boolean;
     readonly _autoError: boolean;
     readonly _pausable: boolean | "resumeAll";
+    /**
+     * @internal First-run-gate override. `false` (default) holds fn until every
+     * dep has delivered DATA or a terminal — spec §2.7 first-run gate. `true`
+     * disables the gate; fn fires as soon as `_dirtyDepCount === 0`, regardless
+     * of dep sentinel state. Operators that need partial firing
+     * (`withLatestFrom`, `valve`, worker-bridge aggregators) pass
+     * `partial: true` explicitly at construction.
+     */
+    readonly _partial: boolean;
     readonly _guard: NodeGuard | undefined;
     /**
      * @internal Additional guards stacked at runtime via {@link NodeImpl._pushGuard}
@@ -1092,8 +1146,14 @@ declare class NodeImpl<T = unknown> implements Node<T> {
     private _maybeRunFnOnSettlement;
     private _maybeAutoTerminalAfterWave;
     /**
-     * @internal Runs the node fn once. Default cleanup (function form) fires
-     * before the new run; `{ deactivation }` cleanup survives.
+     * @internal Runs the node fn once.
+     *
+     * Cleanup firing:
+     * - Function-form cleanup — fires here (pre-run) AND on deactivation AND
+     *   on INVALIDATE. Cleared before the new fn runs.
+     * - Object-form cleanup — only `beforeRun` fires here; `deactivate` and
+     *   `invalidate` hooks survive across re-runs. The cleanup reference
+     *   itself is preserved so `deactivate`/`invalidate` still fire later.
      */
     private _execFn;
     private _clearWaveFlags;
@@ -1212,4 +1272,4 @@ declare class NodeImpl<T = unknown> implements Node<T> {
  */
 declare function node<T = unknown>(depsOrFn?: readonly Node[] | NodeFn | NodeOptions<T>, fnOrOpts?: NodeFn | NodeOptions<T>, optsArg?: NodeOptions<T>): Node<T>;
 
-export { START_MSG as $, type Actor as A, type NodeInspectorHook as B, COMPLETE as C, DATA as D, ERROR as E, type FnCtx as F, type GlobalInspectorEvent as G, type HashFn as H, INVALIDATE as I, type NodeInspectorHookEvent as J, type NodeSink as K, type NodeStatus as L, type Message as M, type Node as N, type NodeTransportOptions as O, type PolicyRuleData as P, type NodeVersionInfo as Q, type OnMessageHandler as R, type OnSubscribeHandler as S, PAUSE as T, type PolicyAllow as U, type PolicyDeny as V, RESOLVED as W, RESOLVED_MSG as X, RESOLVED_ONLY_BATCH as Y, RESUME as Z, START as _, type NodeOptions as a, type SubscribeContext as a0, TEARDOWN as a1, TEARDOWN_MSG as a2, TEARDOWN_ONLY_BATCH as a3, type V0 as a4, type V1 as a5, type VersioningLevel as a6, type VersioningOptions as a7, accessHintForGuard as a8, advanceVersion as a9, configure as aa, createVersioning as ab, defaultConfig as ac, defaultHash as ad, isV1 as ae, node as af, normalizeActor as ag, policy as ah, policyFromRules as ai, registerBuiltins as aj, COMPLETE_MSG as b, COMPLETE_ONLY_BATCH as c, DEFAULT_ACTOR as d, DIRTY as e, DIRTY_MSG as f, DIRTY_ONLY_BATCH as g, type DepRecord as h, type GlobalInspectorHook as i, GraphReFlyConfig as j, type GuardAction as k, GuardDenied as l, type GuardDeniedDetails as m, INVALIDATE_MSG as n, INVALIDATE_ONLY_BATCH as o, type MessageContext as p, type MessageTypeRegistration as q, type MessageTypeRegistrationInput as r, type Messages as s, type NodeActions as t, type NodeCtx as u, type NodeDescribeKind as v, type NodeFn as w, type NodeFnCleanup as x, type NodeGuard as y, NodeImpl as z };
+export { START as $, type Actor as A, type NodeInspectorHook as B, COMPLETE as C, DATA as D, ERROR as E, type FnCtx as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, type NodeInspectorHookEvent as J, type NodeSink as K, type NodeStatus as L, type Message as M, type NodeOptions as N, type NodeTransportOptions as O, type PolicyRuleData as P, type NodeVersionInfo as Q, type OnMessageHandler as R, type OnSubscribeHandler as S, PAUSE as T, type PolicyAllow as U, type VersioningLevel as V, type PolicyDeny as W, RESOLVED as X, RESOLVED_MSG as Y, RESOLVED_ONLY_BATCH as Z, RESUME as _, type Node as a, START_MSG as a0, type SubscribeContext as a1, TEARDOWN as a2, TEARDOWN_MSG as a3, TEARDOWN_ONLY_BATCH as a4, type V0 as a5, type V1 as a6, type VersioningOptions as a7, accessHintForGuard as a8, advanceVersion as a9, configure as aa, createVersioning as ab, defaultConfig as ac, defaultHash as ad, isV1 as ae, node as af, normalizeActor as ag, policy as ah, policyFromRules as ai, registerBuiltins as aj, type Messages as b, type NodeActions as c, type NodeFnCleanup as d, type NodeDescribeKind as e, COMPLETE_MSG as f, COMPLETE_ONLY_BATCH as g, DEFAULT_ACTOR as h, DIRTY as i, DIRTY_MSG as j, DIRTY_ONLY_BATCH as k, type DepRecord as l, type GlobalInspectorEvent as m, type GlobalInspectorHook as n, GraphReFlyConfig as o, GuardDenied as p, type GuardDeniedDetails as q, INVALIDATE_MSG as r, INVALIDATE_ONLY_BATCH as s, type MessageContext as t, type MessageTypeRegistration as u, type MessageTypeRegistrationInput as v, type NodeCtx as w, type NodeFn as x, type NodeGuard as y, NodeImpl as z };

package/dist/{node-BmerH3kS.d.ts → node-Dd6wHSib.d.ts}

@@ -600,12 +600,31 @@ type NodeTransportOptions = {
 };
 /**
  * Cleanup return shape from a node {@link NodeFn}.
- * - `() => void` — fires before the next fn run AND on deactivation (default).
- * - `{ deactivation: () => void }` — fires only on deactivation (persistent
- *   resources that should survive across fn re-runs).
+ *
+ * Two forms, discriminated on return type:
+ *
+ * - `() => void` — fires before the next fn run AND on deactivation AND on
+ *   INVALIDATE. The simplest form: one cleanup function for every transition
+ *   away from the current run. Use when the same teardown logic applies to
+ *   all three.
+ *
+ * - `{ beforeRun?, deactivate?, invalidate? }` — granular hooks. Each hook
+ *   fires exactly once on its named transition; missing hooks are no-ops.
+ *   Use when only some transitions should flush resources (e.g. a measurement
+ *   cache that should survive re-runs but reset on deactivation).
+ *
+ *   - `beforeRun` fires before the next fn invocation (same point as the
+ *     function-form cleanup's pre-run hook).
+ *   - `deactivate` fires on deactivation (last-sink unsubscribe or TEARDOWN).
+ *   - `invalidate` fires on INVALIDATE (spec v0.4 graph-wide flush signal).
+ *
+ * Closure access: both forms are declared inside `NodeFn`, so hooks see the
+ * same closure as the fn body (per-run locals, `ctx.store`, dep refs).
  */
 type NodeFnCleanup = (() => void) | {
-    deactivation: () => void;
+    beforeRun?: () => void;
+    deactivate?: () => void;
+    invalidate?: () => void;
 };
 /**
  * Fn-time context exposing per-wave metadata and a per-node persistent
@@ -647,8 +666,10 @@ interface FnCtx {
  *   the latest; iterate for multi-emission processing.
  *
  * Emission is explicit via `actions.emit(v)` (sugar: equals + framing) or
- * `actions.down(msgs)` (raw). Return a cleanup function (or
- * `{ deactivation }`) to register teardown — any non-cleanup return value
+ * `actions.down(msgs)` (raw). Return a cleanup shape to register teardown:
+ * `() => void` (fires on every transition) or
+ * `{ beforeRun?, deactivate?, invalidate? }` (each hook fires on its named
+ * transition only). See {@link NodeFnCleanup}. Any non-cleanup return value
  * is ignored. The `| void` leg lets arrow-block bodies satisfy `NodeFn`
  * without an explicit `return undefined`.
  *
@@ -679,6 +700,29 @@ interface NodeOptions<T = unknown> {
      * explicitly via `ctx.terminalDeps`.
      */
     errorWhenDepsError?: boolean;
+    /**
+     * First-run gate (§2.7). When `false` (default — matches the universal
+     * contract "fn does not fire until every declared dep has delivered"), fn
+     * is held until every declared dep has delivered at least one DATA or
+     * terminal. Sugar constructors (`derived`, `effect`) inherit the default
+     * so multi-parent activation produces one combined initial wave
+     * `[[START], [DIRTY], [DATA, fn(init...)]]` instead of the sequential
+     * `[[START], [DIRTY], [RESOLVED], [DIRTY], [DATA]]` shape produced by
+     * per-dep push-on-subscribe firings.
+     *
+     * When `true`, fn fires as soon as `_dirtyDepCount === 0` regardless of
+     * whether any dep is still sentinel. Operators like `withLatestFrom`,
+     * `valve`, and worker-bridge aggregators that deliberately fire on
+     * partial deps pass `partial: true` explicitly. Zero-dep producer-pattern
+     * factories (`stratify`, `budgetGate`, etc.) are unaffected either way —
+     * an empty `_deps` array has nothing for the gate to hold on.
+     *
+     * Gate scope: applies only until fn has fired once (`_hasCalledFnOnce`).
+     * Subsequent waves, INVALIDATE, and `_addDep` do not re-gate. Terminal
+     * reset (resubscribable node reconnect) resets `_hasCalledFnOnce` and
+     * re-arms the gate.
+     */
+    partial?: boolean;
     /**
      * Tier-2 PAUSE/RESUME handling.
      * - `true` (default): wave completion suppressed while paused; fn fires
@@ -756,8 +800,9 @@ interface Node<T = unknown> {
  * - `true` — dep sent COMPLETE.
  * - anything else — dep sent ERROR with that payload.
  *
- * Edge case: an ERROR carrying an `undefined` payload is indistinguishable
- * from "live". Pass meaningful error values (Error objects, domain tags).
+ * `[ERROR, undefined]` is rejected at the dispatch boundary (`_emit`) per
+ * spec §1.2 — `undefined` would collide with the "live" encoding here.
+ * Always pass meaningful error values (Error objects, domain tags).
  */
 interface DepRecord {
     readonly node: Node;
@@ -885,6 +930,15 @@ declare class NodeImpl<T = unknown> implements Node<T> {
     readonly _autoComplete: boolean;
     readonly _autoError: boolean;
     readonly _pausable: boolean | "resumeAll";
+    /**
+     * @internal First-run-gate override. `false` (default) holds fn until every
+     * dep has delivered DATA or a terminal — spec §2.7 first-run gate. `true`
+     * disables the gate; fn fires as soon as `_dirtyDepCount === 0`, regardless
+     * of dep sentinel state. Operators that need partial firing
+     * (`withLatestFrom`, `valve`, worker-bridge aggregators) pass
+     * `partial: true` explicitly at construction.
+     */
+    readonly _partial: boolean;
     readonly _guard: NodeGuard | undefined;
     /**
      * @internal Additional guards stacked at runtime via {@link NodeImpl._pushGuard}
@@ -1092,8 +1146,14 @@ declare class NodeImpl<T = unknown> implements Node<T> {
     private _maybeRunFnOnSettlement;
     private _maybeAutoTerminalAfterWave;
     /**
-     * @internal Runs the node fn once. Default cleanup (function form) fires
-     * before the new run; `{ deactivation }` cleanup survives.
+     * @internal Runs the node fn once.
+     *
+     * Cleanup firing:
+     * - Function-form cleanup — fires here (pre-run) AND on deactivation AND
+     *   on INVALIDATE. Cleared before the new fn runs.
+     * - Object-form cleanup — only `beforeRun` fires here; `deactivate` and
+     *   `invalidate` hooks survive across re-runs. The cleanup reference
+     *   itself is preserved so `deactivate`/`invalidate` still fire later.
      */
     private _execFn;
     private _clearWaveFlags;
@@ -1212,4 +1272,4 @@ declare class NodeImpl<T = unknown> implements Node<T> {
  */
 declare function node<T = unknown>(depsOrFn?: readonly Node[] | NodeFn | NodeOptions<T>, fnOrOpts?: NodeFn | NodeOptions<T>, optsArg?: NodeOptions<T>): Node<T>;
 
-export { START_MSG as $, type Actor as A, type NodeInspectorHook as B, COMPLETE as C, DATA as D, ERROR as E, type FnCtx as F, type GlobalInspectorEvent as G, type HashFn as H, INVALIDATE as I, type NodeInspectorHookEvent as J, type NodeSink as K, type NodeStatus as L, type Message as M, type Node as N, type NodeTransportOptions as O, type PolicyRuleData as P, type NodeVersionInfo as Q, type OnMessageHandler as R, type OnSubscribeHandler as S, PAUSE as T, type PolicyAllow as U, type PolicyDeny as V, RESOLVED as W, RESOLVED_MSG as X, RESOLVED_ONLY_BATCH as Y, RESUME as Z, START as _, type NodeOptions as a, type SubscribeContext as a0, TEARDOWN as a1, TEARDOWN_MSG as a2, TEARDOWN_ONLY_BATCH as a3, type V0 as a4, type V1 as a5, type VersioningLevel as a6, type VersioningOptions as a7, accessHintForGuard as a8, advanceVersion as a9, configure as aa, createVersioning as ab, defaultConfig as ac, defaultHash as ad, isV1 as ae, node as af, normalizeActor as ag, policy as ah, policyFromRules as ai, registerBuiltins as aj, COMPLETE_MSG as b, COMPLETE_ONLY_BATCH as c, DEFAULT_ACTOR as d, DIRTY as e, DIRTY_MSG as f, DIRTY_ONLY_BATCH as g, type DepRecord as h, type GlobalInspectorHook as i, GraphReFlyConfig as j, type GuardAction as k, GuardDenied as l, type GuardDeniedDetails as m, INVALIDATE_MSG as n, INVALIDATE_ONLY_BATCH as o, type MessageContext as p, type MessageTypeRegistration as q, type MessageTypeRegistrationInput as r, type Messages as s, type NodeActions as t, type NodeCtx as u, type NodeDescribeKind as v, type NodeFn as w, type NodeFnCleanup as x, type NodeGuard as y, NodeImpl as z };
+export { START as $, type Actor as A, type NodeInspectorHook as B, COMPLETE as C, DATA as D, ERROR as E, type FnCtx as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, type NodeInspectorHookEvent as J, type NodeSink as K, type NodeStatus as L, type Message as M, type NodeOptions as N, type NodeTransportOptions as O, type PolicyRuleData as P, type NodeVersionInfo as Q, type OnMessageHandler as R, type OnSubscribeHandler as S, PAUSE as T, type PolicyAllow as U, type VersioningLevel as V, type PolicyDeny as W, RESOLVED as X, RESOLVED_MSG as Y, RESOLVED_ONLY_BATCH as Z, RESUME as _, type Node as a, START_MSG as a0, type SubscribeContext as a1, TEARDOWN as a2, TEARDOWN_MSG as a3, TEARDOWN_ONLY_BATCH as a4, type V0 as a5, type V1 as a6, type VersioningOptions as a7, accessHintForGuard as a8, advanceVersion as a9, configure as aa, createVersioning as ab, defaultConfig as ac, defaultHash as ad, isV1 as ae, node as af, normalizeActor as ag, policy as ah, policyFromRules as ai, registerBuiltins as aj, type Messages as b, type NodeActions as c, type NodeFnCleanup as d, type NodeDescribeKind as e, COMPLETE_MSG as f, COMPLETE_ONLY_BATCH as g, DEFAULT_ACTOR as h, DIRTY as i, DIRTY_MSG as j, DIRTY_ONLY_BATCH as k, type DepRecord as l, type GlobalInspectorEvent as m, type GlobalInspectorHook as n, GraphReFlyConfig as o, GuardDenied as p, type GuardDeniedDetails as q, INVALIDATE_MSG as r, INVALIDATE_ONLY_BATCH as s, type MessageContext as t, type MessageTypeRegistration as u, type MessageTypeRegistrationInput as v, type NodeCtx as w, type NodeFn as x, type NodeGuard as y, NodeImpl as z };

package/dist/{observable-BgGUwcqp.d.ts → observable-BZJgo616.d.ts}

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { N as Node, s as Messages } from './node-BmerH3kS.js';
+import { a as Node, b as Messages } from './node-Dd6wHSib.js';
 
 /** Options for {@link toObservable}. */
 type ToObservableOptions = {

package/dist/{observable-DJt_AxzQ.d.cts → observable-kwzpLvbi.d.cts}

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { N as Node, s as Messages } from './node-BmerH3kS.cjs';
+import { a as Node, b as Messages } from './node-Dd6wHSib.cjs';
 
 /** Options for {@link toObservable}. */
 type ToObservableOptions = {

package/dist/patterns/ai/browser.cjs

@@ -0,0 +1,25 @@
+"use strict";var Ie=Object.create;var P=Object.defineProperty;var Ue=Object.getOwnPropertyDescriptor;var De=Object.getOwnPropertyNames;var Fe=Object.getPrototypeOf,Ke=Object.prototype.hasOwnProperty;var M=(e,t)=>()=>(e&&(t=e(e=0)),t);var je=(e,t)=>{for(var r in t)P(e,r,{get:t[r],enumerable:!0})},te=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of De(t))!Ke.call(e,i)&&i!==r&&P(e,i,{get:()=>t[i],enumerable:!(n=Ue(t,i))||n.enumerable});return e};var Be=(e,t,r)=>(r=e!=null?Ie(Fe(e)):{},te(t||!e||!e.__esModule?P(r,"default",{value:e,enumerable:!0}):r,e)),Ge=e=>te(P({},"__esModule",{value:!0}),e);function h(){return Math.trunc(performance.now()*1e6)}function I(){return Date.now()*1e6}var A=M(()=>{"use strict"});var T,V=M(()=>{"use strict";T=class{_timer;_gen=0;start(t,r){this.cancel(),this._gen+=1;let n=this._gen;this._timer=setTimeout(()=>{this._timer=void 0,n===this._gen&&r()},t)}cancel(){this._timer!==void 0&&(clearTimeout(this._timer),this._timer=void 0)}get pending(){return this._timer!==void 0}}});var Xe,de,ue,pe,Qe,Ze,Y,fe,et,tt,nt,Kt,rt,ot,jt,Bt,Gt,$t,Wt,me=M(()=>{"use strict";Xe=Symbol.for("graphrefly/START"),de=Symbol.for("graphrefly/DATA"),ue=Symbol.for("graphrefly/DIRTY"),pe=Symbol.for("graphrefly/RESOLVED"),Qe=Symbol.for("graphrefly/INVALIDATE"),Ze=Symbol.for("graphrefly/TEARDOWN"),Y=Symbol.for("graphrefly/COMPLETE"),fe=Symbol.for("graphrefly/ERROR"),et=Object.freeze([ue]),tt=Object.freeze([pe]),nt=Object.freeze([Qe]),Kt=Object.freeze([Xe]),rt=Object.freeze([Y]),ot=Object.freeze([Ze]),jt=Object.freeze([et]),Bt=Object.freeze([tt]),Gt=Object.freeze([nt]),$t=Object.freeze([rt]),Wt=Object.freeze([ot])});function ge(e){return new Promise((t,r)=>{let n=!1,i=!1,a;a=e.subscribe(s=>{for(let o of s){if(n)return;if(o[0]===de){n=!0,t(o[1]),a?(a(),a=void 0):i=!0;return}if(o[0]===fe){n=!0,r(o[1]),a?(a(),a=void 0):i=!0;return}if(o[0]===Y){n=!0,r(new Error("completed without DATA")),a?(a(),a=void 0):i=!0;return}}}),i&&(a?.(),a=void 0)})}var ye=M(()=>{"use strict";me()});function At(e){return e<0?0:e}function Ne(e){let t=Math.max(1,e?.failureThreshold??5),r=At(e?.cooldownNs??30*1e9),n=e?.cooldown??null,i=Math.max(1,e?.halfOpenMax??1),a=e?.now??h,s="closed",o=0,c=0,u=0,l=r,d=0;function p(){if(!n)return r;let g=n(c);return g!==null?g:r}function m(){s="open",l=p(),u=a(),d=0}return{canExecute(){return s==="closed"?!0:s==="open"?a()-u>=l?(s="half-open",d=1,!0):!1:d<i?(d++,!0):!1},recordSuccess(){s==="half-open"?(s="closed",o=0,c=0):s==="closed"&&(o=0)},recordFailure(g){if(s==="half-open"){c++,m();return}s==="closed"&&(o++,o>=t&&m())},get state(){return s},get failureCount(){return o},reset(){s="closed",o=0,c=0,d=0}}}var Pe=M(()=>{"use strict";A()});var Tt={};je(Tt,{chromeNanoAdapter:()=>C,cloudFirstPreset:()=>xt,localFirstPreset:()=>Lt,offlinePreset:()=>Rt,webllmAdapter:()=>S});module.exports=Ge(Tt);A();function ne(){let e=new Error("aborted");return e.name="AbortError",e}function C(e={}){let t=e.streamMode??"accumulated",r=e.navigatorOverride??globalThis.navigator,n=()=>{let o=r?.ai;if(!o?.languageModel)throw new Error("chromeNanoAdapter: Chrome AI languageModel not available (requires Chrome 131+ with flag/OT).");return o},i=async o=>n().languageModel.create({systemPrompt:o?.systemPrompt??e.systemPrompt,temperature:o?.temperature??e.temperature,topK:e.topK,signal:o?.signal}),a=o=>{let c=[];for(let u of o)u.role!=="system"&&c.push(`${u.role}: ${u.content}`);return c.join(`
+
+`)},s=()=>({input:{regular:0},output:{regular:0}});return{provider:"chrome-nano",model:"chrome-nano",async invoke(o,c){let u=await i(c);try{let l=a(o),d=h(),p=await u.prompt(l,{signal:c?.signal}),m=Math.max(0,(h()-d)/1e6);return{content:p,usage:s(),finishReason:"stop",latencyMs:m,model:"chrome-nano",provider:"chrome-nano"}}finally{u.destroy?.()}},async*stream(o,c){let u=await i(c);try{let l=a(o);if(t==="delta")for await(let d of u.promptStreaming(l,{signal:c?.signal})){if(c?.signal?.aborted)throw ne();d&&(yield{type:"token",delta:d})}else{let d="";for await(let p of u.promptStreaming(l,{signal:c?.signal})){if(c?.signal?.aborted)throw ne();let m=p.startsWith(d)?p.slice(d.length):p;d=p,m&&(yield{type:"token",delta:m})}}yield{type:"usage",usage:s()},yield{type:"finish",reason:"stop"}}finally{u.destroy?.()}}}}A();function $e(){let e=new Error("aborted");return e.name="AbortError",e}function S(e){let t=e.engine,r=async()=>{if(t)return t;if(!We(e.navigatorOverride))throw new Error("webllmAdapter: WebGPU not available in this environment");let s=(await import("@mlc-ai/web-llm").catch(()=>{throw new Error("webllmAdapter: @mlc-ai/web-llm not installed. Add it as a peer dependency or pass opts.engine.")})).CreateMLCEngine;if(!s)throw new Error("webllmAdapter: @mlc-ai/web-llm missing CreateMLCEngine export");return t=await s(e.model,{initProgressCallback:e.initProgressCallback}),t},n=(a,s)=>{let o=[];s?.systemPrompt&&o.push({role:"system",content:s.systemPrompt});for(let c of a)o.push({role:c.role==="tool"?"user":c.role,content:c.content});return o},i=a=>({input:{regular:a?.prompt_tokens??0},output:{regular:a?.completion_tokens??0},raw:a});return{provider:"webllm",model:e.model,async invoke(a,s){let o=await r(),c=h(),u=await o.chat.completions.create({model:s?.model??e.model,messages:n(a,s),max_tokens:s?.maxTokens,temperature:s?.temperature},{signal:s?.signal}),l=Math.max(0,(h()-c)/1e6),d=u.choices?.[0];return{content:d?.message?.content??"",usage:i(u.usage),finishReason:d?.finish_reason,latencyMs:l,model:e.model,provider:"webllm"}},async*stream(a,s){let c=await(await r()).chat.completions.create({model:s?.model??e.model,messages:n(a,s),max_tokens:s?.maxTokens,temperature:s?.temperature,stream:!0},{signal:s?.signal}),u,l;for await(let d of c){if(s?.signal?.aborted)throw $e();let p=d.choices?.[0];p?.delta?.content&&(yield{type:"token",delta:p.delta.content}),p?.finish_reason&&(l=p.finish_reason),d.usage&&(u=d.usage)}u&&(yield{type:"usage",usage:i(u)}),yield{type:"finish",reason:l??"stop"}}}}function We(e){let t=e??globalThis.navigator;return!!(t&&"gpu"in t&&t.gpu)}A();function ae(e={}){return e.sdk?Ye(e):He(e)}function U(e,t,r,n){let i=t?.model??r;if(!i)throw new Error("anthropicAdapter: model must be set via options.model or invokeOpts.model");let{system:a,chat:s}=Je(e,t?.systemPrompt),o={model:i,messages:s.map(qe),max_tokens:t?.maxTokens??4096};return a&&(o.system=a),t?.temperature!=null&&(o.temperature=t.temperature),t?.tools&&t.tools.length>0&&(o.tools=t.tools.map(Ve)),t?.maxReasoningTokens!=null&&(o.thinking={type:"enabled",budget_tokens:t.maxReasoningTokens}),t?.cacheHint,n&&(o.stream=!0),t?.providerExtras&&Object.assign(o,t.providerExtras),o}function Je(e,t){let r=[];t&&r.push(t);let n=[];for(let i of e)i.role==="system"?r.push(i.content):n.push(i);return{system:r.length>0?r.join(`
+
+`):void 0,chat:n}}function qe(e){if(e.role==="tool")return{role:"user",content:[{type:"tool_result",tool_use_id:e.toolCallId,content:e.content}]};if(e.role==="assistant"&&e.toolCalls&&e.toolCalls.length>0){let t=[];e.content&&t.push({type:"text",text:e.content});for(let r of e.toolCalls)t.push({type:"tool_use",id:r.id,name:r.name,input:r.arguments});return{role:"assistant",content:t}}return{role:e.role,content:e.content}}function Ve(e){return{name:e.name,description:e.description,input_schema:e.parameters}}function D(e,t){if(!e)return{...t};let r={...e};return t.input_tokens!=null&&(r.input_tokens=t.input_tokens),t.output_tokens!=null&&(r.output_tokens=t.output_tokens),t.cache_read_input_tokens!=null&&(r.cache_read_input_tokens=t.cache_read_input_tokens),t.cache_creation_input_tokens!=null&&(r.cache_creation_input_tokens=t.cache_creation_input_tokens),t.cache_creation&&(r.cache_creation={...e.cache_creation??{},...t.cache_creation}),t.server_tool_use&&(r.server_tool_use={...e.server_tool_use??{},...t.server_tool_use}),r}function q(e){let t={input:{regular:e?.input_tokens??0},output:{regular:e?.output_tokens??0},raw:e};return e?.cache_read_input_tokens&&(t.input.cacheRead=e.cache_read_input_tokens),e?.cache_creation?(e.cache_creation.ephemeral_5m_input_tokens&&(t.input.cacheWrite5m=e.cache_creation.ephemeral_5m_input_tokens),e.cache_creation.ephemeral_1h_input_tokens&&(t.input.cacheWrite1h=e.cache_creation.ephemeral_1h_input_tokens)):e?.cache_creation_input_tokens&&(t.input.cacheWrite5m=e.cache_creation_input_tokens),e?.server_tool_use?.web_search_requests&&(t.auxiliary={webSearchRequests:e.server_tool_use.web_search_requests}),t}function ie(e,t){let r=[],n=[];for(let i of e.content)if(i.type==="text"&&typeof i.text=="string")r.push(i.text);else if(i.type==="tool_use"){let a=i;n.push({id:a.id,name:a.name,arguments:a.input??{}})}return{content:r.join(""),toolCalls:n.length>0?n:void 0,usage:q(e.usage),finishReason:e.stop_reason,latencyMs:t,model:e.model,provider:"anthropic"}}function He(e){let t=e.apiKey??globalThis.process?.env?.ANTHROPIC_API_KEY,r=e.baseURL??"https://api.anthropic.com",n=e.anthropicVersion??"2023-06-01",i=e.fetchImpl??fetch,a=()=>{if(!t)throw new Error("anthropicAdapter: apiKey required for invoke/stream (or provide opts.sdk)");return{"x-api-key":t,"anthropic-version":n,"content-type":"application/json",...e.headers??{}}};return{provider:"anthropic",model:e.model,async invoke(s,o){let c=U(s,o,e.model,!1),u=h(),l=await i(`${r}/v1/messages`,{method:"POST",headers:a(),body:JSON.stringify(c),signal:o?.signal});if(!l.ok)throw await se(l);let d=await l.json(),p=Math.max(0,(h()-u)/1e6);return ie(d,p)},async*stream(s,o){let c=U(s,o,e.model,!0),u=await i(`${r}/v1/messages`,{method:"POST",headers:{...a(),accept:"text/event-stream"},body:JSON.stringify(c),signal:o?.signal});if(!u.ok)throw await se(u);if(!u.body)throw new Error("anthropicAdapter: streaming response has no body");let l,d,p=new Map;for await(let m of ze(u.body)){let w=m.data;if(!w)continue;let g;try{g=JSON.parse(w)}catch{continue}switch(g.type){case"message_start":{l=D(l,g.message.usage);break}case"content_block_start":{let f=g,y=f.content_block;y.type==="tool_use"&&(p.set(f.index,{id:String(y.id??""),name:String(y.name??""),argBuf:""}),yield{type:"tool-call-delta",delta:{id:String(y.id??""),name:String(y.name??"")}});break}case"content_block_delta":{let f=g,y=f.delta;if(y.type==="text_delta"&&typeof y.text=="string")yield{type:"token",delta:y.text};else if(y.type==="input_json_delta"&&typeof y.partial_json=="string"){let k=p.get(f.index);k&&(k.argBuf+=y.partial_json),yield{type:"tool-call-delta",delta:{argumentsDelta:y.partial_json}}}else y.type==="thinking_delta"&&typeof y.thinking=="string"&&(yield{type:"thinking",delta:y.thinking});break}case"message_delta":{let f=g;f.delta.stop_reason&&(d=f.delta.stop_reason),f.delta.usage&&(l=D(l,f.delta.usage));break}case"message_stop":break}}l&&(yield{type:"usage",usage:q(l)}),yield{type:"finish",reason:d??"stop"}}}}function Ye(e){let t=e.sdk;if(!t)throw new Error("sdkBackedAnthropic: sdk instance required");return{provider:"anthropic",model:e.model,async invoke(r,n){let i=U(r,n,e.model,!1),a=h(),s=await t.messages.create(i,{signal:n?.signal}),o=Math.max(0,(h()-a)/1e6);return ie(s,o)},async*stream(r,n){if(!t.messages.stream)throw new Error("sdkBackedAnthropic: SDK instance does not expose .messages.stream");let i=U(r,n,e.model,!0),a,s;for await(let o of t.messages.stream(i,{signal:n?.signal}))switch(o.type){case"message_start":a=D(a,o.message.usage);break;case"content_block_delta":{let c=o.delta;c?.type==="text_delta"&&typeof c.text=="string"?yield{type:"token",delta:c.text}:c?.type==="input_json_delta"&&typeof c.partial_json=="string"?yield{type:"tool-call-delta",delta:{argumentsDelta:c.partial_json}}:c?.type==="thinking_delta"&&typeof c.thinking=="string"&&(yield{type:"thinking",delta:c.thinking});break}case"message_delta":{let c=o;c.delta.stop_reason&&(s=c.delta.stop_reason),c.delta.usage&&(a=D(a,c.delta.usage));break}}a&&(yield{type:"usage",usage:q(a)}),yield{type:"finish",reason:s??"stop"}}}}async function*ze(e){let t=e.getReader(),r=new TextDecoder,n="";try{for(;;){let{done:i,value:a}=await t.read();if(i){n.length>0&&(yield re(n));return}n+=r.decode(a,{stream:!0});let s=oe(n);for(;s!==null;){let o=n.slice(0,s.index);n=n.slice(s.index+s.length);let c=re(o);(c.data||c.event)&&(yield c),s=oe(n)}}}finally{t.releaseLock()}}function re(e){let t={},r=[];for(let n of e.split(`
+`)){let i=n.endsWith("\r")?n.slice(0,-1):n;if(!i||i.startsWith(":"))continue;let a=i.indexOf(":"),s=a===-1?i:i.slice(0,a),o=a===-1?"":i.slice(a+1).replace(/^ /,"");s==="data"?r.push(o):s==="event"?t.event=o:s==="id"&&(t.id=o)}return r.length>0&&(t.data=r.join(`
+`)),t}function oe(e){let t=e.indexOf(`\r
+\r
+`),r=e.indexOf(`
+
+`),n=null;return t!==-1&&(n={index:t,length:4}),r!==-1&&(n===null||r<n.index)&&(n={index:r,length:2}),n}async function se(e){let t;try{t=await e.text()}catch{t=""}let r=new Error(`Anthropic API ${e.status}: ${e.statusText}${t?` \u2014 ${t}`:""}`);return r.status=e.status,r.headers=e.headers,r}V();function F(){let e=new Error("aborted");return e.name="AbortError",e}function ce(e,t){return e<=0?Promise.resolve():t?.aborted?Promise.reject(F()):new Promise((r,n)=>{let i=new T,a,s=()=>{i.cancel(),t&&a&&t.removeEventListener("abort",a)};i.start(e,()=>{s(),r()}),t&&(a=()=>{s(),n(F())},t.addEventListener("abort",a,{once:!0}))})}function K(e={}){let t=e.provider??"dry-run",r=e.model??"dry-run-v1",n=e.latencyMs??0,i=Math.max(1,e.streamChunkSize??16),a=e.respond??(o=>{let c=[...o].reverse().find(u=>u.role==="user");return c?`echo: ${c.content}`:"dry-run: no user message"}),s=e.usage??((o,c)=>{let u=o.reduce((l,d)=>l+d.content.length,0);return{input:{regular:Math.ceil(u/4)},output:{regular:Math.ceil(c.length/4)}}});return{provider:t,model:r,async invoke(o,c){if(await ce(n,c?.signal),c?.signal?.aborted)throw F();let u=a(o,c),l=s(o,u);return{content:u,usage:l,finishReason:"stop",model:c?.model??r,provider:t,tier:c?.tier,metadata:{dryRun:!0}}},async*stream(o,c){let u=a(o,c),l=s(o,u),d=Math.ceil(u.length/i)||1,p=n>0?n/d:0;for(let m=0;m<u.length;m+=i){if(c?.signal?.aborted)throw F();await ce(p,c?.signal),yield{type:"token",delta:u.slice(m,m+i)}}yield{type:"usage",usage:l},yield{type:"finish",reason:"stop"}}}}A();async function j(e){let t=typeof e=="string"?new TextEncoder().encode(e):e,r=await globalThis.crypto.subtle.digest("SHA-256",t),n=new Uint8Array(r),i="";for(let a=0;a<n.length;a++)i+=le[n[a]];return i}var le=new Array(256);for(let e=0;e<256;e++)le[e]=e.toString(16).padStart(2,"0");function H(){let e=new Map;return{save(t,r){e.set(t,JSON.parse(JSON.stringify(r)))},load(t){let r=e.get(t);return r===void 0?null:JSON.parse(JSON.stringify(r))},clear(t){e.delete(t)},list(){return[...e.keys()].sort()}}}A();ye();function he(e,t={}){let r=t.keyFn??(i=>String(i)),n=new Map;return i=>{let a=r(i),s=n.get(a);if(s)return s;let o=e(i),c;o!=null&&typeof o.then=="function"?c=Promise.resolve(o):o!=null&&typeof o=="object"&&"subscribe"in o&&"cache"in o?c=ge(o):o!=null&&typeof o=="object"&&Symbol.asyncIterator in o?c=(async()=>{let d=o[Symbol.asyncIterator]();try{let{value:p,done:m}=await d.next();if(m)throw new Error("singleFromAny: factory returned empty async iterable");return p}finally{await d.return?.()}})():o!=null&&typeof o=="object"&&Symbol.iterator in o?c=(async()=>{let d=o[Symbol.iterator]();try{let{value:p,done:m}=d.next();if(m)throw new Error("singleFromAny: factory returned empty iterable");return p}finally{d.return?.()}})():c=Promise.resolve(o);let u,l=()=>{n.get(a)===u&&n.delete(a)};return u=c.then(d=>(l(),d),d=>{throw l(),d}),n.set(a,u),u}}V();var E=class extends Error{constructor(r,n){super(`withReplayCache: no cached response for ${n} (key=${r}, mode=read-strict)`);this.key=r;this.method=n}name="ReplayCacheMissError"};function be(e,t){let r=t.mode??"read-write",n=t.cacheStreaming??!1,i=t.captureStreamCadence??!1,a=t.replaySpeed??1,s=t.keyPrefix??"llm-replay",o=t.storage,c=r==="read"||r==="read-strict",u=async(g,f)=>{if(t.keyFn){let R=t.keyFn;if(R.length<=1){let v={messages:g,opts:f,context:f?.keyContext},b=await R(v);return`${s}:${b}`}let N=await R(g,f);return`${s}:${N}`}let{signal:y,keyContext:k,...x}=f??{},_=z({messages:g,opts:x}),O=await j(_);return`${s}:${O}`},l=async g=>{if(r==="write-only")return;let f=await o.load(g);if(f!=null)try{return typeof f=="string"?JSON.parse(f):f}catch{return}},d=async g=>(await l(g))?.response,p=async(g,f,y)=>{if(c)return;let k={response:f,storedAtNs:I(),...y?{streamChunks:y.chunks,streamCadenceMs:y.delaysMs}:{}};await o.save(g,k)},m=g=>g<=0?Promise.resolve():new Promise(f=>{new T().start(g,()=>f())}),w=he(async({messages:g,invokeOpts:f})=>{let y=e.invoke(g,f);return await st(y)},{keyFn:({_precomputedKey:g})=>g});return{provider:e.provider,model:e.model,capabilities:e.capabilities?.bind(e),async invoke(g,f){let y=await u(g,f),k=await d(y);if(k)return{...k,metadata:{...k.metadata??{},replayCache:"hit"}};if(r==="read-strict")throw new E(y,"invoke");let x=await w({messages:g,invokeOpts:f,_precomputedKey:y});return await p(y,x),x},async*stream(g,f){if(!n){for await(let b of e.stream(g,f))yield b;return}let y=await u(g,f),k=await l(y);if(k){let b=k.response;if(k.streamChunks&&k.streamCadenceMs)for(let L=0;L<k.streamChunks.length;L++){let J=k.streamCadenceMs[L]??0,ee=a>0?J/a:0;ee>0&&await m(ee),yield{type:"token",delta:k.streamChunks[L]?.delta??""}}else b.content&&(yield{type:"token",delta:b.content});b.usage&&(yield{type:"usage",usage:b.usage}),yield{type:"finish",reason:b.finishReason??"stop"};return}if(r==="read-strict")throw new E(y,"stream");let x="",_,O,R=[],N=[],v;for await(let b of e.stream(g,f)){if(b.type==="token"&&(x+=b.delta,i)){let L=h(),J=v===void 0?0:(L-v)/1e6;N.push(J),v=L,R.push({delta:b.delta})}b.type==="usage"&&(_=b.usage),b.type==="finish"&&(O=b.reason),yield b}if(x||_){let b={content:x,usage:_??{input:{regular:0},output:{regular:0}},finishReason:O,model:e.model??f?.model??"",provider:e.provider};await p(y,b,i?{chunks:R,delaysMs:N}:void 0)}}}}function z(e){let t=new Set,r=n=>{if(n===null||typeof n!="object")return n;let i=n;if(t.has(i))return{__cycle:!0};t.add(i);try{if(Array.isArray(n))return n.map(r);let a={};for(let s of Object.keys(n).sort())a[s]=r(n[s]);return a}finally{t.delete(i)}};return JSON.stringify(r(e))}async function st(e){if(e!=null&&typeof e.then=="function")return await e;if(e&&typeof e=="object"&&"content"in e)return e;throw new Error("withReplayCache: adapter.invoke must return Promise or LLMResponse (Node input not supported in cache path)")}function ke(e,t){return{content:"[fallback: no cached response available for this request]",usage:{input:{regular:0},output:{regular:0}},finishReason:"stop",model:t,provider:e,metadata:{degraded:!0,reason:"no-fixture"}}}function we(e,t,r){return typeof e=="string"?{content:e,usage:{input:{regular:0},output:{regular:0}},finishReason:"stop",model:r,provider:t,metadata:{degraded:!0,reason:"respond"}}:e}async function at(e,t){if("key"in e)return e.key;let r=z({messages:e.messages,opts:e.invokeOpts??{}}),n=await j(r);return`${t}:${n}`}function it(e){let t={response:e.response,storedAtNs:I()};if("key"in e&&e.stream){let r=e.stream.chunks.filter(n=>n.type==="token");return{...t,streamChunks:r.map(n=>({delta:n.delta})),streamCadenceMs:e.stream.delaysMs??r.map(()=>0)}}return t}function ct(e,t){let r=[];if(e.fixtures!=null&&r.push("fixtures"),e.fixturesStorage!=null&&r.push("fixturesStorage"),r.length>1)throw new TypeError(`fallbackAdapter: \`fixtures\` and \`fixturesStorage\` are mutually exclusive; got both ${r.join(" and ")}. Pick one source. For filesystem directories use the node subpath's \`fallbackAdapter\`.`);if(e.fixtures){let n=H(),i=e.fixtures,a=(async()=>{for(let s of i){let o=await at(s,t);await n.save(o,it(s))}})();return a.catch(()=>{}),{tier:n,seedReady:a}}return e.fixturesStorage?{tier:e.fixturesStorage,seedReady:Promise.resolve()}:{tier:void 0,seedReady:Promise.resolve()}}function Ae(e={}){let t=e.provider??"fallback",r=e.model??"fallback",n=e.onMiss??"respond",i=e.keyPrefix??"fallback",a=e.record?e.record.adapter:n==="throw"?K({provider:t,model:r,respond:()=>"[unreachable: read-strict mode throws on miss]"}):{provider:t,model:r,async invoke(l,d){let p=e.respond?e.respond(l,d):ke(t,r);return we(p,t,r)},async*stream(l,d){let p=e.respond?e.respond(l,d):ke(t,r),m=we(p,t,r);yield{type:"token",delta:m.content},m.usage&&(yield{type:"usage",usage:m.usage}),yield{type:"finish",reason:m.finishReason??"stop"}}},s,o=Promise.resolve();if(e.record){if(!e.record.storage)throw new TypeError("fallbackAdapter: `record.storage` is required in record mode. For filesystem `record.dir` convenience, use the node subpath's `fallbackAdapter`.");s=e.record.storage}else{let l=ct(e,i);s=l.tier??H(),o=l.seedReady}let c=e.record?"read-write":n==="throw"?"read-strict":"read",u=be(a,{storage:s,mode:c,keyPrefix:i,cacheStreaming:!0,captureStreamCadence:!0,replaySpeed:e.replaySpeed,...e.keyFn?{keyFn:e.keyFn}:{}});return{provider:t,model:r,capabilities:u.capabilities?.bind(u),async invoke(l,d){return await o,u.invoke(l,d)},async*stream(l,d){await o;for await(let p of u.stream(l,d))yield p}}}A();function Te(e={}){return e.sdk?pt(e):ut(e)}function B(e,t){let r=[],n=[];t?.systemPrompt&&r.push(t.systemPrompt);for(let s of e){if(s.role==="system"){r.push(s.content);continue}if(s.role==="tool"){n.push({role:"user",parts:[{functionResponse:{name:s.name??s.toolCallId??"tool",response:{result:s.content}}}]});continue}if(s.role==="assistant"&&s.toolCalls&&s.toolCalls.length>0){let o=[];s.content&&o.push({text:s.content});for(let c of s.toolCalls)o.push({functionCall:{name:c.name,args:c.arguments}});n.push({role:"model",parts:o});continue}n.push({role:s.role==="assistant"?"model":"user",parts:[{text:s.content}]})}let i={contents:n};r.length>0&&(i.systemInstruction={role:"system",parts:[{text:r.join(`
+
+`)}]});let a={};return t?.maxTokens!=null&&(a.maxOutputTokens=t.maxTokens),t?.temperature!=null&&(a.temperature=t.temperature),t?.maxReasoningTokens!=null&&(a.thinkingConfig={thinkingBudget:t.maxReasoningTokens}),Object.keys(a).length>0&&(i.generationConfig=a),t?.tools&&t.tools.length>0&&(i.tools=[{functionDeclarations:t.tools.map(lt)}]),t?.providerExtras&&Object.assign(i,t.providerExtras),i}function lt(e){return{name:e.name,description:e.description,parameters:e.parameters}}function X(e){let t={input:{regular:0},output:{regular:0},raw:e};if(!e)return t;let r=e.promptTokenCount??0,n=e.cachedContentTokenCount??0;if(t.input.regular=Math.max(0,r-n),n>0&&(t.input.cacheRead=n),e.toolUsePromptTokenCount&&(t.input.toolUse=e.toolUsePromptTokenCount),e.promptTokensDetails)for(let i of e.promptTokensDetails){let a=i.modality?.toLowerCase();a==="image"?t.input.image=(t.input.image??0)+i.tokenCount:a==="audio"?t.input.audio=(t.input.audio??0)+i.tokenCount:a==="video"&&(t.input.video=(t.input.video??0)+i.tokenCount)}return t.output.regular=e.candidatesTokenCount??0,e.thoughtsTokenCount&&(t.output.reasoning=e.thoughtsTokenCount),t}function _e(e,t){let r=e.candidates?.[0],n=r?.content?.parts??[],i=[],a=[],s=0;for(let o of n)typeof o.text=="string"&&i.push(o.text),o.functionCall&&a.push({id:`${o.functionCall.name}-${s++}`,name:o.functionCall.name,arguments:o.functionCall.args??{}});return{content:i.join(""),toolCalls:a.length>0?a:void 0,usage:X(e.usageMetadata),finishReason:r?.finishReason,latencyMs:t,model:e.modelVersion,provider:"google"}}function dt(e){if(e.apiKey)return e.apiKey;let t=globalThis.process?.env;return t?.GOOGLE_API_KEY??t?.GEMINI_API_KEY}function ut(e){let t=e.baseURL??"https://generativelanguage.googleapis.com/v1beta",r=e.fetchImpl??fetch,n=a=>{let s=a?.model??e.model;if(!s)throw new Error("googleAdapter: model must be set via options.model or invokeOpts.model");return s},i=()=>{let a=dt(e);if(!a)throw new Error("googleAdapter: apiKey required for invoke/stream");return`key=${encodeURIComponent(a)}`};return{provider:"google",model:e.model,async invoke(a,s){let o=n(s),c=B(a,s),u=h(),l=`${t}/models/${encodeURIComponent(o)}:generateContent?${i()}`,d=await r(l,{method:"POST",headers:{"content-type":"application/json",...e.headers??{}},body:JSON.stringify(c),signal:s?.signal});if(!d.ok)throw await Re(d);let p=await d.json(),m=Math.max(0,(h()-u)/1e6);return _e(p,m)},async*stream(a,s){let o=n(s),c=B(a,s),u=`${t}/models/${encodeURIComponent(o)}:streamGenerateContent?alt=sse&${i()}`,l=await r(u,{method:"POST",headers:{"content-type":"application/json",accept:"text/event-stream",...e.headers??{}},body:JSON.stringify(c),signal:s?.signal});if(!l.ok)throw await Re(l);if(!l.body)throw new Error("googleAdapter: streaming response has no body");let d,p;for await(let m of ft(l.body)){if(!m.data)continue;let w;try{w=JSON.parse(m.data)}catch{continue}let g=w.candidates?.[0];for(let f of g?.content?.parts??[])typeof f.text=="string"&&(f.thought?yield{type:"thinking",delta:f.text}:yield{type:"token",delta:f.text}),f.functionCall&&(yield{type:"tool-call-delta",delta:{name:f.functionCall.name,argumentsDelta:JSON.stringify(f.functionCall.args??{})}});g?.finishReason&&(p=g.finishReason),w.usageMetadata&&(d=w.usageMetadata)}d&&(yield{type:"usage",usage:X(d)}),yield{type:"finish",reason:p??"stop"}}}}function pt(e){let t=e.sdk;if(!t)throw new Error("sdkBackedGoogle: sdk instance required");return{provider:"google",model:e.model,async invoke(r,n){let i=B(r,n),a=n?.model??e.model;if(!a)throw new Error("googleAdapter: model required");let s=h(),o=await t.models.generateContent({...i,model:a},{signal:n?.signal}),c=Math.max(0,(h()-s)/1e6);return _e(o,c)},async*stream(r,n){if(!t.models.generateContentStream)throw new Error("sdkBackedGoogle: SDK instance does not expose generateContentStream");let i=B(r,n),a=n?.model??e.model;if(!a)throw new Error("googleAdapter: model required");let s,o;for await(let c of t.models.generateContentStream({...i,model:a},{signal:n?.signal})){let u=c.candidates?.[0];for(let l of u?.content?.parts??[])typeof l.text=="string"&&(l.thought?yield{type:"thinking",delta:l.text}:yield{type:"token",delta:l.text}),l.functionCall&&(yield{type:"tool-call-delta",delta:{name:l.functionCall.name,argumentsDelta:JSON.stringify(l.functionCall.args??{})}});u?.finishReason&&(o=u.finishReason),c.usageMetadata&&(s=c.usageMetadata)}s&&(yield{type:"usage",usage:X(s)}),yield{type:"finish",reason:o??"stop"}}}}async function*ft(e){let t=e.getReader(),r=new TextDecoder,n="";try{for(;;){let{done:i,value:a}=await t.read();if(i){n.length>0&&(yield xe(n));return}n+=r.decode(a,{stream:!0});let s=Le(n);for(;s!==null;){let o=n.slice(0,s.index);n=n.slice(s.index+s.length);let c=xe(o);(c.data||c.event)&&(yield c),s=Le(n)}}}finally{t.releaseLock()}}function xe(e){let t={},r=[];for(let n of e.split(`
+`)){let i=n.endsWith("\r")?n.slice(0,-1):n;if(!i||i.startsWith(":"))continue;let a=i.indexOf(":"),s=a===-1?i:i.slice(0,a),o=a===-1?"":i.slice(a+1).replace(/^ /,"");s==="data"?r.push(o):s==="event"?t.event=o:s==="id"&&(t.id=o)}return r.length>0&&(t.data=r.join(`
+`)),t}function Le(e){let t=e.indexOf(`\r
+\r
+`),r=e.indexOf(`
+
+`),n=null;return t!==-1&&(n={index:t,length:4}),r!==-1&&(n===null||r<n.index)&&(n={index:r,length:2}),n}async function Re(e){let t;try{t=await e.text()}catch{t=""}let r=new Error(`Google API ${e.status}: ${e.statusText}${t?` \u2014 ${t}`:""}`);return r.status=e.status,r.headers=e.headers,r}A();var mt={openai:{baseURL:"https://api.openai.com/v1",apiKeyEnv:"OPENAI_API_KEY",provider:"openai"},openrouter:{baseURL:"https://openrouter.ai/api/v1",apiKeyEnv:"OPENROUTER_API_KEY",provider:"openrouter"},groq:{baseURL:"https://api.groq.com/openai/v1",apiKeyEnv:"GROQ_API_KEY",provider:"groq"},ollama:{baseURL:"http://localhost:11434/v1",provider:"ollama"},deepseek:{baseURL:"https://api.deepseek.com/v1",apiKeyEnv:"DEEPSEEK_API_KEY",provider:"deepseek"},xai:{baseURL:"https://api.x.ai/v1",apiKeyEnv:"XAI_API_KEY",provider:"xai"}};function Se(e={}){return e.sdk?kt(e):bt(e)}function G(e,t,r,n,i){let a=t?.model??r;if(!a)throw new Error("openAICompatAdapter: model must be set via options.model or invokeOpts.model");let s=e.map(gt);t?.systemPrompt&&!e.some(c=>c.role==="system")&&s.unshift({role:"system",content:t.systemPrompt});let o={model:a,messages:s};return t?.maxTokens!=null&&(o.max_tokens=t.maxTokens),t?.temperature!=null&&(o.temperature=t.temperature),t?.tools&&t.tools.length>0&&(o.tools=t.tools.map(yt)),t?.maxReasoningTokens!=null&&(o.reasoning={max_tokens:t.maxReasoningTokens}),n&&(o.stream=!0,o.stream_options={include_usage:!0}),i&&Object.assign(o,i),t?.providerExtras&&Object.assign(o,t.providerExtras),o}function gt(e){return e.role==="tool"?{role:"tool",tool_call_id:e.toolCallId,content:e.content}:e.role==="assistant"&&e.toolCalls&&e.toolCalls.length>0?{role:"assistant",content:e.content||null,tool_calls:e.toolCalls.map(t=>({id:t.id,type:"function",function:{name:t.name,arguments:JSON.stringify(t.arguments)}}))}:{role:e.role,content:e.content}}function yt(e){return{type:"function",function:{name:e.name,description:e.description,parameters:e.parameters}}}function Q(e){let t={input:{regular:0},output:{regular:0},raw:e};if(!e)return t;let r=e.prompt_tokens??0,n=e.prompt_tokens_details?.cached_tokens??0;e.prompt_cache_hit_tokens!=null?(n=e.prompt_cache_hit_tokens,t.input.regular=e.prompt_cache_miss_tokens??Math.max(0,r-n)):t.input.regular=Math.max(0,r-n),n>0&&(t.input.cacheRead=n),e.prompt_tokens_details?.audio_tokens&&(t.input.audio=e.prompt_tokens_details.audio_tokens);let i=e.completion_tokens??0,a=e.completion_tokens_details?.reasoning_tokens??0;return t.output.regular=Math.max(0,i-a),a>0&&(t.output.reasoning=a),e.completion_tokens_details?.audio_tokens&&(t.output.audio=e.completion_tokens_details.audio_tokens),e.completion_tokens_details?.accepted_prediction_tokens&&(t.output.predictionAccepted=e.completion_tokens_details.accepted_prediction_tokens),e.completion_tokens_details?.rejected_prediction_tokens&&(t.output.predictionRejected=e.completion_tokens_details.rejected_prediction_tokens),t}function Ee(e,t,r){let n=e.choices[0],i=n?.message,a=i?.content??"",s=(i?.tool_calls??[]).map(o=>({id:o.id,name:o.function.name,arguments:ht(o.function.arguments)}));return{content:a,toolCalls:s.length>0?s:void 0,usage:Q(e.usage),finishReason:n?.finish_reason,latencyMs:t,model:e.model,provider:r}}function ht(e){try{let t=JSON.parse(e);return typeof t=="object"&&t!=null?t:{_raw:e}}catch{return{_raw:e}}}function Oe(e){let t=e.preset??"openai",r=mt[t],n=e.baseURL??r.baseURL,i=e.provider??r.provider,a=r.apiKeyEnv,s=e.apiKey??(a?globalThis.process?.env?.[a]:void 0);return{provider:i,baseURL:n,apiKey:s}}function bt(e){let{provider:t,baseURL:r,apiKey:n}=Oe(e),i=e.fetchImpl??fetch,a=t!=="ollama",s=()=>{let o={"content-type":"application/json",...e.headers??{}};if(a){if(!n)throw new Error(`openAICompatAdapter[${t}]: apiKey required for invoke/stream`);o.authorization=`Bearer ${n}`}return o};return{provider:t,model:e.model,async invoke(o,c){let u=G(o,c,e.model,!1,e.bodyExtras),l=h(),d=await i(`${r}/chat/completions`,{method:"POST",headers:s(),body:JSON.stringify(u),signal:c?.signal});if(!d.ok)throw await Ce(d,t);let p=await d.json(),m=Math.max(0,(h()-l)/1e6);return Ee(p,m,t)},async*stream(o,c){let u=G(o,c,e.model,!0,e.bodyExtras),l=await i(`${r}/chat/completions`,{method:"POST",headers:{...s(),accept:"text/event-stream"},body:JSON.stringify(u),signal:c?.signal});if(!l.ok)throw await Ce(l,t);if(!l.body)throw new Error(`openAICompatAdapter[${t}]: streaming response has no body`);let d,p;for await(let m of wt(l.body)){if(!m.data||m.data==="[DONE]")continue;let w;try{w=JSON.parse(m.data)}catch{continue}let g=w.choices;if(g){let f=g[0];if(f?.delta?.content&&(yield{type:"token",delta:f.delta.content}),f?.delta?.reasoning_content&&(yield{type:"thinking",delta:f.delta.reasoning_content}),f?.delta?.tool_calls)for(let y of f.delta.tool_calls)yield{type:"tool-call-delta",delta:{id:y.id,name:y.function?.name,argumentsDelta:y.function?.arguments}};f?.finish_reason&&(p=f.finish_reason)}w.usage&&(d=w.usage,yield{type:"usage",usage:Q(d)})}yield{type:"finish",reason:p??"stop"}}}}function kt(e){let t=e.sdk;if(!t)throw new Error("sdkBackedOpenAI: sdk instance required");let{provider:r}=Oe(e);return{provider:r,model:e.model,async invoke(n,i){let a=G(n,i,e.model,!1,e.bodyExtras),s=h(),o=await t.chat.completions.create(a,{signal:i?.signal}),c=Math.max(0,(h()-s)/1e6);return Ee(o,c,r)},async*stream(n,i){let a=G(n,i,e.model,!0,e.bodyExtras),s=await t.chat.completions.create(a,{signal:i?.signal}),o,c;for await(let u of s){let l=u.choices;if(l){let p=l[0];if(p?.delta?.content&&(yield{type:"token",delta:p.delta.content}),p?.delta?.reasoning_content&&(yield{type:"thinking",delta:p.delta.reasoning_content}),p?.delta?.tool_calls)for(let m of p.delta.tool_calls)yield{type:"tool-call-delta",delta:{id:m.id,name:m.function?.name,argumentsDelta:m.function?.arguments}};p?.finish_reason&&(c=p.finish_reason)}let d=u.usage;d&&(o=d,yield{type:"usage",usage:Q(d)})}yield{type:"finish",reason:c??"stop"}}}}async function*wt(e){let t=e.getReader(),r=new TextDecoder,n="";try{for(;;){let{done:i,value:a}=await t.read();if(i){n.length>0&&(yield ve(n));return}n+=r.decode(a,{stream:!0});let s=Me(n);for(;s!==null;){let o=n.slice(0,s.index);n=n.slice(s.index+s.length);let c=ve(o);(c.data||c.event)&&(yield c),s=Me(n)}}}finally{t.releaseLock()}}function ve(e){let t={},r=[];for(let n of e.split(`
+`)){let i=n.endsWith("\r")?n.slice(0,-1):n;if(!i||i.startsWith(":"))continue;let a=i.indexOf(":"),s=a===-1?i:i.slice(0,a),o=a===-1?"":i.slice(a+1).replace(/^ /,"");s==="data"?r.push(o):s==="event"?t.event=o:s==="id"&&(t.id=o)}return r.length>0&&(t.data=r.join(`
+`)),t}function Me(e){let t=e.indexOf(`\r
+\r
+`),r=e.indexOf(`
+
+`),n=null;return t!==-1&&(n={index:t,length:4}),r!==-1&&(n===null||r<n.index)&&(n={index:r,length:2}),n}async function Ce(e,t){let r;try{r=await e.text()}catch{r=""}let n=new Error(`${t} API ${e.status}: ${e.statusText}${r?` \u2014 ${r}`:""}`);return n.status=e.status,n.headers=e.headers,n}function Z(e){switch(e.provider){case"anthropic":{let t={apiKey:e.apiKey,model:e.model,baseURL:e.baseURL,headers:e.headers,sdk:e.sdk,fetchImpl:e.fetchImpl,...e.extras};return ae(t)}case"google":{let t={apiKey:e.apiKey,model:e.model,baseURL:e.baseURL,headers:e.headers,sdk:e.sdk,fetchImpl:e.fetchImpl,...e.extras};return Te(t)}case"dry-run":{let t={model:e.model,...e.extras};return K(t)}case"fallback":{let t={provider:e.provider,model:e.model,...e.extras};return Ae(t)}case"openai":case"openrouter":case"groq":case"ollama":case"deepseek":case"xai":{let t={preset:e.provider,apiKey:e.apiKey,model:e.model,baseURL:e.baseURL,headers:e.headers,bodyExtras:e.bodyExtras,sdk:e.sdk,fetchImpl:e.fetchImpl,...e.extras};return Se(t)}default:{let t=e.provider;throw new Error(`createAdapter: unknown provider: ${String(t)}`)}}}Pe();var $=class extends Error{name="AllTiersExhaustedError";skipped;failed;constructor(t){let r=[];t.failed.size>0&&r.push(`failed=[${[...t.failed.keys()].join(",")}]`),t.skipped.length>0&&r.push(`skipped=[${t.skipped.map(n=>`${n.name}(${n.reason})`).join(",")}]`),super(`All LLM adapter tiers exhausted: ${r.join(" ")}`),this.skipped=t.skipped,this.failed=t.failed}};function W(e,t={}){if(e.length===0)throw new RangeError("cascadingLlmAdapter: tiers must be non-empty");let r=e.map(i=>({name:i.name,adapter:i.adapter,filter:i.filter,breaker:i.breaker?"canExecute"in i.breaker?i.breaker:Ne(i.breaker):void 0})),n=t.streamRetryBeforeFirstChunk??!0;return{provider:"cascading",model:void 0,async invoke(i,a){let s=[],o=new Map;for(let u=0;u<r.length;u++){let l=r[u];if(l.filter&&!l.filter(i,a)){s.push({name:l.name,reason:"filter"});continue}if(l.breaker&&!l.breaker.canExecute()){s.push({name:l.name,reason:"breaker"});continue}try{let d=await Promise.resolve(l.adapter.invoke(i,a));return l.breaker?.recordSuccess(),{...d,metadata:{...d.metadata??{},tier:l.name}}}catch(d){o.set(l.name,d),l.breaker?.recordFailure(d);let p=r[u+1];p&&t.onFallback?.(l.name,p.name,d)}}let c={skipped:s,failed:o};throw t.onExhausted?.(c),new $(c)},async*stream(i,a){let s=[],o=new Map;for(let u=0;u<r.length;u++){let l=r[u];if(l.filter&&!l.filter(i,a)){s.push({name:l.name,reason:"filter"});continue}if(l.breaker&&!l.breaker.canExecute()){s.push({name:l.name,reason:"breaker"});continue}let d=!1;try{for await(let p of l.adapter.stream(i,a))d=!0,yield p;l.breaker?.recordSuccess();return}catch(p){if(o.set(l.name,p),l.breaker?.recordFailure(p),d||!n)throw p;let m=r[u+1];m&&t.onFallback?.(l.name,m.name,p)}}let c={skipped:s,failed:o};throw t.onExhausted?.(c),new $(c)}}}function xt(e){let t=[{name:"cloud",adapter:Z(e.cloud)}];return e.webllmModel&&t.push({name:"webllm",adapter:S({model:e.webllmModel})}),e.chromeNano!==!1&&t.push({name:"chrome-nano",adapter:C(),filter:(r,n)=>!n?.tools||n.tools.length===0}),W(t,e.cascade)}function Lt(e){let t=[{name:"ollama",adapter:Z({provider:"ollama",model:e.ollamaModel,baseURL:e.ollamaBaseURL})}];return e.webllmModel&&t.push({name:"webllm",adapter:S({model:e.webllmModel})}),e.chromeNano!==!1&&t.push({name:"chrome-nano",adapter:C(),filter:(r,n)=>!n?.tools||n.tools.length===0}),W(t,e.cascade)}function Rt(e){let t=[{name:"webllm",adapter:S({model:e.webllmModel})}];return e.chromeNano!==!1&&t.push({name:"chrome-nano",adapter:C(),filter:(r,n)=>!n?.tools||n.tools.length===0}),W(t,e.cascade)}0&&(module.exports={chromeNanoAdapter,cloudFirstPreset,localFirstPreset,offlinePreset,webllmAdapter});

package/dist/patterns/ai/browser.d.cts

@@ -0,0 +1,127 @@
+import { L as LLMAdapter } from '../../types-O3GzJY2U.cjs';
+import { c as createAdapter, C as CascadingLlmAdapterOptions } from '../../cascading-CcAgRacD.cjs';
+import '../../extra/sources.cjs';
+import '../../node-Dd6wHSib.cjs';
+import '../../resilience-uBz4yvYB.cjs';
+
+/**
+ * ChromeNanoAdapter — Chrome Built-in AI Prompt API.
+ *
+ * Uses `navigator.ai.languageModel` (Chrome 131+, origin trial / flag gated).
+ * Zero download, instant startup — but limited capability (no tool use on
+ * most versions, no rich system prompts on some).
+ *
+ * **Stream mode:** Chrome AI has historically switched between emitting
+ * accumulated (each chunk is the full text so far) and delta (each chunk is
+ * only the new tokens) streams across versions. Default `streamMode: "accumulated"`
+ * matches current behavior; pass `"delta"` if you've verified your browser
+ * emits pure deltas.
+ */
+
+interface ChromeNanoAdapterOptions {
+    /** Override the navigator object (for tests). */
+    navigatorOverride?: Navigator;
+    /** Initial system prompt for the session (Chrome AI supports it in 131+). */
+    systemPrompt?: string;
+    /** Temperature (0..1). */
+    temperature?: number;
+    /** Top-K sampling (Chrome AI only). */
+    topK?: number;
+    /**
+     * Stream chunk shape. `"accumulated"` (default) — each chunk contains the
+     * full cumulative text; adapter computes deltas by string diffing.
+     * `"delta"` — each chunk already contains only the new tokens; adapter
+     * forwards directly.
+     */
+    streamMode?: "accumulated" | "delta";
+}
+declare function chromeNanoAdapter(opts?: ChromeNanoAdapterOptions): LLMAdapter;
+
+/**
+ * WebLLMAdapter — browser-only, WebGPU-based inference via `@mlc-ai/web-llm`.
+ *
+ * Dynamic import + WebGPU feature detection. No server dependency. Typical
+ * use: fallback tier in `cascadingLlmAdapter` after a BYOK cloud adapter.
+ */
+
+interface WebLLMAdapterOptions {
+    model: string;
+    /**
+     * User-provided engine instance (from `CreateMLCEngine(...)`). If omitted,
+     * the adapter lazy-creates one on first call via dynamic import.
+     */
+    engine?: WebLLMEngineLike;
+    /** Pass-through to `CreateMLCEngine`. */
+    initProgressCallback?: (progress: unknown) => void;
+    /** Navigator override (for tests). */
+    navigatorOverride?: Navigator;
+}
+interface WebLLMEngineLike {
+    chat: {
+        completions: {
+            create(params: Record<string, unknown>, opts?: {
+                signal?: AbortSignal;
+            }): Promise<{
+                choices: ReadonlyArray<{
+                    message?: {
+                        content?: string;
+                    };
+                    finish_reason?: string;
+                }>;
+                usage?: {
+                    prompt_tokens?: number;
+                    completion_tokens?: number;
+                };
+            }>;
+        };
+    };
+}
+declare function webllmAdapter(opts: WebLLMAdapterOptions): LLMAdapter;
+
+/**
+ * Curated `cascadingLlmAdapter` presets that depend on browser-only adapters
+ * (`webllmAdapter`, `chromeNanoAdapter`).
+ *
+ * Split out from `routing/presets.ts` so that importing `patterns/ai` in a
+ * Node bundle doesn't transitively pull in `@mlc-ai/web-llm` / Chrome Nano
+ * dynamic imports, and so browser-only consumers can opt in cleanly via
+ * the `@graphrefly/graphrefly/patterns/ai/browser` subpath.
+ *
+ * @module
+ */
+
+interface CloudFirstPresetOptions {
+    /** BYOK config — passed directly to `createAdapter`. */
+    cloud: Parameters<typeof createAdapter>[0];
+    /** WebLLM model name. Pass `null` to skip the WebLLM tier. */
+    webllmModel?: string | null;
+    /** Pass `null` to skip the Chrome Nano tier. */
+    chromeNano?: boolean;
+    /** Cascade options. */
+    cascade?: CascadingLlmAdapterOptions;
+}
+/**
+ * Cloud-first with local fallback: BYOK → WebLLM → Chrome Nano.
+ */
+declare function cloudFirstPreset(opts: CloudFirstPresetOptions): LLMAdapter;
+interface LocalFirstPresetOptions {
+    /** Ollama model. */
+    ollamaModel: string;
+    /** Ollama base URL. Default http://localhost:11434/v1. */
+    ollamaBaseURL?: string;
+    webllmModel?: string | null;
+    chromeNano?: boolean;
+    cascade?: CascadingLlmAdapterOptions;
+}
+/**
+ * Local-first: nothing leaves the machine. Ollama → WebLLM → Chrome Nano.
+ */
+declare function localFirstPreset(opts: LocalFirstPresetOptions): LLMAdapter;
+interface OfflinePresetOptions {
+    webllmModel: string;
+    chromeNano?: boolean;
+    cascade?: CascadingLlmAdapterOptions;
+}
+declare function offlinePreset(opts: OfflinePresetOptions): LLMAdapter;
+
+export { type ChromeNanoAdapterOptions, type CloudFirstPresetOptions, type LocalFirstPresetOptions, type OfflinePresetOptions, type WebLLMAdapterOptions, type WebLLMEngineLike, chromeNanoAdapter, cloudFirstPreset, localFirstPreset, offlinePreset, webllmAdapter };