@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/provider-fallback.js

@@ -0,0 +1,72 @@
+// SPDX-License-Identifier: MIT
+import { Route } from "./pipeline-bus.js";
+import * as make from "./packet-factories.js";
+import { TimerScheduler } from "./scheduler.js";
+export class ProviderFallback {
+    providers;
+    opts;
+    unavailable = new Set();
+    recoveryTimers = new Set();
+    scheduler;
+    constructor(providers, opts) {
+        this.providers = providers;
+        this.opts = opts;
+        this.scheduler = opts.scheduler ?? new TimerScheduler();
+    }
+    async send(req) {
+        let lastError = null;
+        for (const provider of this.providers) {
+            if (this.unavailable.has(provider.id))
+                continue;
+            try {
+                return await provider.send(req, AbortSignal.timeout(this.opts.attemptTimeoutMs));
+            }
+            catch (err) {
+                lastError = err;
+                this.markUnavailable(provider);
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error("all fallback providers unavailable");
+    }
+    close() {
+        for (const providerId of this.recoveryTimers)
+            this.scheduler.cancel(recoveryKey(providerId));
+        this.recoveryTimers.clear();
+        this.unavailable.clear();
+    }
+    markUnavailable(provider) {
+        if (!this.unavailable.has(provider.id)) {
+            this.unavailable.add(provider.id);
+            this.metric(`${provider.id}.availability_changed`, "unavailable");
+        }
+        this.scheduleRecoveryProbe(provider);
+    }
+    scheduleRecoveryProbe(provider) {
+        if (this.recoveryTimers.has(provider.id))
+            return;
+        const runProbe = async () => {
+            this.recoveryTimers.delete(provider.id);
+            try {
+                if (await provider.healthProbe(AbortSignal.timeout(this.opts.attemptTimeoutMs))) {
+                    this.unavailable.delete(provider.id);
+                    this.metric(`${provider.id}.availability_changed`, "available");
+                    return;
+                }
+            }
+            catch {
+                // Probe failure keeps the provider unavailable and schedules the next probe.
+            }
+            this.recoveryTimers.add(provider.id);
+            this.scheduler.schedule(recoveryKey(provider.id), this.opts.recoveryProbeIntervalMs, () => void runProbe());
+        };
+        this.recoveryTimers.add(provider.id);
+        this.scheduler.schedule(recoveryKey(provider.id), this.opts.recoveryProbeIntervalMs, () => void runProbe());
+    }
+    metric(name, value) {
+        this.opts.bus.push(Route.Background, make.metric(this.opts.contextId, name, value));
+    }
+}
+function recoveryKey(providerId) {
+    return `voice.provider_fallback.recovery:${providerId}`;
+}
+//# sourceMappingURL=provider-fallback.js.map

package/dist/provider-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-fallback.js","sourceRoot":"","sources":["../src/provider-fallback.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,KAAK,EAAoB,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAgBhE,MAAM,OAAO,gBAAgB;IAMR;IACA;IANF,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,SAAS,CAAY;IAEtC,YACmB,SAAmD,EACnD,IAA6B;QAD7B,cAAS,GAAT,SAAS,CAA0C;QACnD,SAAI,GAAJ,IAAI,CAAyB;QAE9C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,cAAc,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAS;QAClB,IAAI,SAAS,GAAY,IAAI,CAAC;QAC9B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAE,SAAS;YAChD,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,CAAC;gBAChB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QACD,MAAM,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACjG,CAAC;IAED,KAAK;QACH,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,cAAc;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,eAAe,CAAC,QAAuC;QAC7D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,uBAAuB,EAAE,aAAa,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAEO,qBAAqB,CAAC,QAAuC;QACnE,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO;QACjD,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;YACzC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC;gBACH,IAAI,MAAM,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;oBAChF,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACrC,IAAI,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,uBAAuB,EAAE,WAAW,CAAC,CAAC;oBAChE,OAAO;gBACT,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6EAA6E;YAC/E,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC9G,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC9G,CAAC;IAEO,MAAM,CAAC,IAAY,EAAE,KAAa;QACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACtF,CAAC;CACF;AAED,SAAS,WAAW,CAAC,UAAkB;IACrC,OAAO,oCAAoC,UAAU,EAAE,CAAC;AAC1D,CAAC"}

package/dist/reasoner-hedge.d.ts

@@ -0,0 +1,21 @@
+import { type PipelineBus } from "./pipeline-bus.js";
+import type { Reasoner, ReasonerTurn, ReasoningPart } from "./reasoner.js";
+import { type Scheduler } from "./scheduler.js";
+export interface HedgedReasonerOptions {
+    readonly primary: Reasoner;
+    readonly backup: Reasoner;
+    readonly hedgeAfterMs: number;
+    readonly bus?: PipelineBus;
+    readonly contextId?: string;
+    readonly scheduler?: Scheduler;
+}
+export declare class HedgedReasoner implements Reasoner {
+    private readonly opts;
+    private readonly scheduler;
+    constructor(opts: HedgedReasonerOptions);
+    stream(turn: ReasonerTurn): AsyncIterable<ReasoningPart>;
+    private doStream;
+    private raceToCommit;
+    private metric;
+}
+//# sourceMappingURL=reasoner-hedge.d.ts.map

package/dist/reasoner-hedge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner-hedge.d.ts","sourceRoot":"","sources":["../src/reasoner-hedge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAyBD,qBAAa,cAAe,YAAW,QAAQ;IAGjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAET,IAAI,EAAE,qBAAqB;IAIxD,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC;YAIzC,QAAQ;YAeT,YAAY;IAyI1B,OAAO,CAAC,MAAM;CAGf"}

package/dist/reasoner-hedge.js

@@ -0,0 +1,170 @@
+// SPDX-License-Identifier: MIT
+import { Route } from "./pipeline-bus.js";
+import * as make from "./packet-factories.js";
+import { TimerScheduler } from "./scheduler.js";
+const asRacer = (who, next) => next
+    .then((result) => ({ who, result }))
+    .catch((err) => ({
+    who,
+    result: {
+        done: false,
+        value: {
+            type: "error",
+            cause: err instanceof Error ? err : new Error(String(err)),
+            recoverable: true,
+        },
+    },
+}));
+export class HedgedReasoner {
+    opts;
+    scheduler;
+    constructor(opts) {
+        this.opts = opts;
+        this.scheduler = opts.scheduler ?? new TimerScheduler();
+    }
+    stream(turn) {
+        return this.doStream(turn);
+    }
+    async *doStream(turn) {
+        const commit = await this.raceToCommit(turn);
+        if (!commit.ok) {
+            yield commit.error;
+            return;
+        }
+        yield commit.first;
+        let tail = await commit.iter.next();
+        while (!tail.done) {
+            yield tail.value;
+            tail = await commit.iter.next();
+        }
+    }
+    async raceToCommit(turn) {
+        const pc = new AbortController();
+        const bc = new AbortController();
+        if (turn.signal.aborted) {
+            pc.abort();
+            bc.abort();
+            return { ok: false, error: abortedError() };
+        }
+        turn.signal.addEventListener("abort", () => {
+            pc.abort();
+            bc.abort();
+        }, { once: true });
+        let committed = false;
+        let primaryExhausted = false;
+        let backupExhausted = false;
+        let lastError = null;
+        const primaryIter = this.opts.primary.stream({ ...turn, signal: pc.signal })[Symbol.asyncIterator]();
+        let primaryNext = primaryIter.next();
+        let backupIter = null;
+        let backupNext = null;
+        let repollRace = null;
+        const ensureBackup = () => {
+            if (backupIter)
+                return;
+            backupIter = this.opts.backup.stream({ ...turn, signal: bc.signal })[Symbol.asyncIterator]();
+            backupNext = backupIter.next();
+            this.metric("hedge.fired", "1");
+            repollRace?.();
+        };
+        this.scheduler.schedule("hedge", this.opts.hedgeAfterMs, () => {
+            if (!committed)
+                ensureBackup();
+        });
+        while (!committed) {
+            const raced = await new Promise((resolve) => {
+                const racers = [];
+                if (!primaryExhausted) {
+                    racers.push(asRacer("primary", primaryNext));
+                }
+                if (backupNext && !backupExhausted) {
+                    racers.push(asRacer("backup", backupNext));
+                }
+                if (racers.length === 0) {
+                    repollRace = null;
+                    resolve("repoll");
+                    return;
+                }
+                repollRace = () => resolve("repoll");
+                void Promise.race(racers).then((winner) => {
+                    repollRace = null;
+                    resolve(winner);
+                });
+            });
+            if (raced === "repoll") {
+                if (primaryExhausted && (backupExhausted || !backupNext)) {
+                    return { ok: false, error: lastError ?? abortedError() };
+                }
+                continue;
+            }
+            const { who, result } = raced;
+            if (result.done) {
+                if (who === "primary") {
+                    primaryExhausted = true;
+                    if (!backupIter) {
+                        this.scheduler.cancel("hedge");
+                        ensureBackup();
+                    }
+                    else if (backupExhausted) {
+                        return { ok: false, error: lastError ?? abortedError() };
+                    }
+                }
+                else {
+                    backupExhausted = true;
+                    if (primaryExhausted) {
+                        return { ok: false, error: lastError ?? abortedError() };
+                    }
+                }
+                continue;
+            }
+            const part = result.value;
+            if (part.type === "error") {
+                lastError = part;
+                if (who === "primary") {
+                    primaryExhausted = true;
+                    if (!backupIter) {
+                        this.scheduler.cancel("hedge");
+                        ensureBackup();
+                    }
+                    if (backupExhausted) {
+                        return { ok: false, error: part };
+                    }
+                }
+                else {
+                    backupExhausted = true;
+                    if (primaryExhausted) {
+                        return { ok: false, error: part };
+                    }
+                }
+                continue;
+            }
+            committed = true;
+            this.scheduler.cancel("hedge");
+            if (who === "primary") {
+                bc.abort();
+                releaseIterator(backupIter);
+                this.metric("hedge.committed_to", "primary");
+                return { ok: true, winner: "primary", first: part, iter: primaryIter };
+            }
+            pc.abort();
+            releaseIterator(primaryIter);
+            this.metric("hedge.committed_to", "backup");
+            return { ok: true, winner: "backup", first: part, iter: backupIter };
+        }
+        return { ok: false, error: lastError ?? abortedError() };
+    }
+    metric(name, value) {
+        this.opts.bus?.push(Route.Background, make.metric(this.opts.contextId ?? "", name, value));
+    }
+}
+function releaseIterator(iter) {
+    if (!iter)
+        return;
+    const release = iter.return;
+    if (release)
+        void release.call(iter, undefined);
+}
+function abortedError() {
+    return { type: "error", cause: new Error("aborted"), recoverable: true };
+}
+//# sourceMappingURL=reasoner-hedge.js.map

package/dist/reasoner-hedge.js.map

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

package/dist/reasoner-route.d.ts

@@ -0,0 +1,24 @@
+import { type PipelineBus } from "./pipeline-bus.js";
+import type { Reasoner, ReasonerTurn, ReasoningPart } from "./reasoner.js";
+export interface ReasonerRoute {
+    readonly id: string;
+    readonly reasoner: Reasoner;
+}
+export interface RoutingReasonerOptions {
+    readonly routes: readonly ReasonerRoute[];
+    readonly classify: (turn: ReasonerTurn) => string | Promise<string>;
+    readonly speculateRouteId?: string;
+    readonly bus?: PipelineBus;
+    readonly contextId?: string;
+}
+export declare class RoutingReasoner implements Reasoner {
+    private readonly opts;
+    constructor(opts: RoutingReasonerOptions);
+    stream(turn: ReasonerTurn): AsyncIterable<ReasoningPart>;
+    private doStream;
+    private streamWithSpeculation;
+    private forwardRoute;
+    private resolveRoute;
+    private metric;
+}
+//# sourceMappingURL=reasoner-route.d.ts.map

package/dist/reasoner-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner-route.d.ts","sourceRoot":"","sources":["../src/reasoner-route.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,eAAgB,YAAW,QAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,sBAAsB;IAEzD,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC;YAIzC,QAAQ;YAeR,qBAAqB;YAiCrB,YAAY;IAqB3B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,MAAM;CAGf"}

package/dist/reasoner-route.js

@@ -0,0 +1,87 @@
+// SPDX-License-Identifier: MIT
+import { Route } from "./pipeline-bus.js";
+import * as make from "./packet-factories.js";
+export class RoutingReasoner {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    stream(turn) {
+        return this.doStream(turn);
+    }
+    async *doStream(turn) {
+        if (turn.signal.aborted)
+            return;
+        if (this.opts.speculateRouteId !== undefined) {
+            yield* this.streamWithSpeculation(turn);
+            return;
+        }
+        const routeId = await this.opts.classify(turn);
+        const route = this.resolveRoute(routeId);
+        this.metric("route.selected", routeId);
+        const iter = route.reasoner.stream({ ...turn, signal: turn.signal })[Symbol.asyncIterator]();
+        yield* this.forwardRoute(iter, undefined, turn.signal);
+    }
+    async *streamWithSpeculation(turn) {
+        const specId = this.opts.speculateRouteId;
+        const specRoute = this.resolveRoute(specId);
+        const child = new AbortController();
+        if (turn.signal.aborted) {
+            child.abort();
+            return;
+        }
+        turn.signal.addEventListener("abort", () => child.abort(), { once: true });
+        const specIter = specRoute.reasoner.stream({ ...turn, signal: child.signal })[Symbol.asyncIterator]();
+        const specNext = specIter.next();
+        const classifiedId = await this.opts.classify(turn);
+        if (classifiedId === specId) {
+            this.metric("route.selected", classifiedId);
+            yield* this.forwardRoute(specIter, specNext, turn.signal);
+            return;
+        }
+        child.abort();
+        releaseIterator(specIter);
+        void specNext.catch(() => undefined);
+        this.metric("route.mispredict", "1");
+        const route = this.resolveRoute(classifiedId);
+        this.metric("route.selected", classifiedId);
+        const iter = route.reasoner.stream({ ...turn, signal: turn.signal })[Symbol.asyncIterator]();
+        yield* this.forwardRoute(iter, undefined, turn.signal);
+    }
+    async *forwardRoute(iter, first, signal) {
+        try {
+            let next = first ? await first : await iter.next();
+            while (!next.done) {
+                if (signal.aborted)
+                    return;
+                yield next.value;
+                next = await iter.next();
+            }
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                cause: err instanceof Error ? err : new Error(String(err)),
+                recoverable: true,
+            };
+        }
+    }
+    resolveRoute(id) {
+        const route = this.opts.routes.find((r) => r.id === id);
+        if (!route) {
+            throw new Error(`RoutingReasoner: unknown route id "${id}"`);
+        }
+        return route;
+    }
+    metric(name, value) {
+        this.opts.bus?.push(Route.Background, make.metric(this.opts.contextId ?? "", name, value));
+    }
+}
+function releaseIterator(iter) {
+    if (!iter)
+        return;
+    const release = iter.return;
+    if (release)
+        void release.call(iter, undefined);
+}
+//# sourceMappingURL=reasoner-route.js.map

package/dist/reasoner-route.js.map

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

package/dist/reasoner-session-store.d.ts

@@ -0,0 +1,18 @@
+import type { ReasonerMessage } from "./reasoner.js";
+/**
+ * Durable per-session reasoner conversation history. `save` persists the full
+ * (already bounded) history snapshot — snapshot semantics, not append, because
+ * barge-in truncation rewrites earlier messages to the heard prefix (G25).
+ */
+export interface ReasonerSessionStore {
+    load(sessionId: string): Promise<readonly ReasonerMessage[]> | readonly ReasonerMessage[];
+    save(sessionId: string, messages: readonly ReasonerMessage[]): Promise<void> | void;
+    clear(sessionId: string): Promise<void> | void;
+}
+export declare class InMemoryReasonerSessionStore implements ReasonerSessionStore {
+    private readonly sessions;
+    load(sessionId: string): readonly ReasonerMessage[];
+    save(sessionId: string, messages: readonly ReasonerMessage[]): void;
+    clear(sessionId: string): void;
+}
+//# sourceMappingURL=reasoner-session-store.d.ts.map

package/dist/reasoner-session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner-session-store.d.ts","sourceRoot":"","sources":["../src/reasoner-session-store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,GAAG,SAAS,eAAe,EAAE,CAAC;IAC1F,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD;AAED,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAE1E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE;IAInD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;IAInE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAG/B"}

package/dist/reasoner-session-store.js

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — durable reasoner session state (G4, RFC bimodel-delegate-seam)
+//
+// The bridge owns conversation history (reasoner.ts §4.5); this seam makes that
+// history durable so a reasoner resumes with the same context after a host
+// eviction/reconnect instead of restarting amnesiac. Concrete backends: the
+// in-memory impl below (Node/tests), a DO-SQLite impl in @kuralle-syrinx/cf-agents.
+export class InMemoryReasonerSessionStore {
+    sessions = new Map();
+    load(sessionId) {
+        return this.sessions.get(sessionId) ?? [];
+    }
+    save(sessionId, messages) {
+        this.sessions.set(sessionId, [...messages]);
+    }
+    clear(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+}
+//# sourceMappingURL=reasoner-session-store.js.map

package/dist/reasoner-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner-session-store.js","sourceRoot":"","sources":["../src/reasoner-session-store.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,oFAAoF;AACpF,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,4EAA4E;AAC5E,oFAAoF;AAepF,MAAM,OAAO,4BAA4B;IACtB,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE1E,IAAI,CAAC,SAAiB;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,QAAoC;QAC1D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/reasoner.d.ts

@@ -0,0 +1,97 @@
+/** A reasoning backend reduced to one normalized pull-stream per turn. */
+export interface Reasoner {
+    /** Add transient steering context consumed by the next turn, when supported. */
+    injectContext?(text: string): void;
+    /**
+     * Drive one reasoning turn. The returned async-iterable IS the response.
+     * Cancellation (barge-in) is via `turn.signal` (abort) — the adapter forwards
+     * it into the backend stream and into tool execution.
+     *
+     * LATENCY INVARIANT (non-negotiable, see §7a): the adapter MUST yield every
+     * part the instant the backend produces it — NO buffering, NO awaiting the
+     * stream to completion, NO batching. The first `text-delta` must reach the
+     * caller as soon as the backend's first token lands. The seam adds at most one
+     * microtask + a synchronous object remap per part; it must add no I/O hop.
+     */
+    stream(turn: ReasonerTurn): AsyncIterable<ReasoningPart>;
+}
+export interface ReasonerTurn {
+    /** Finalized user transcript for this turn (from `eos.turn_complete`). */
+    readonly userText: string;
+    /** Full prior conversation context. The BRIDGE owns history (see §4.5). */
+    readonly messages: readonly ReasonerMessage[];
+    /**
+     * The front-model delegate tool-call arguments that triggered this turn, verbatim — so a
+     * realtime front can pass structured context (e.g. `reply_language`) to the reasoner beyond
+     * the extracted `userText`. Absent for cascade STT turns.
+     */
+    readonly toolArgs?: Record<string, unknown>;
+    /** Barge-in / supersede cancellation. */
+    readonly signal: AbortSignal;
+    /** Present only when resuming a previously-suspended run (step 3). */
+    readonly resume?: {
+        readonly runId: string;
+        readonly data: unknown;
+    };
+}
+export interface ReasonerMessage {
+    readonly role: "system" | "user" | "assistant" | "tool";
+    readonly content: string;
+    readonly toolCallId?: string;
+}
+/** Normalized output — the union of what AI SDK + Mastra can produce, minus noise. */
+export type ReasoningPart = {
+    readonly type: "text-delta";
+    readonly text: string;
+} | {
+    readonly type: "tool-call";
+    readonly toolId: string;
+    readonly toolName: string;
+    readonly args: Record<string, unknown>;
+} | {
+    readonly type: "tool-result";
+    readonly toolId: string;
+    readonly toolName: string;
+    readonly result: string;
+} | {
+    readonly type: "control";
+    readonly name: string;
+    readonly payload: unknown;
+} | {
+    readonly type: "blocked";
+    readonly userFacingMessage: string;
+    readonly payload?: unknown;
+} | {
+    readonly type: "suspended";
+    readonly runId: string;
+    readonly toolId?: string;
+    readonly prompt?: string;
+    readonly payload: unknown;
+} | {
+    readonly type: "error";
+    readonly cause: Error;
+    readonly recoverable: boolean;
+} | {
+    readonly type: "finish";
+    readonly reason: "stop" | "tool" | "length";
+    readonly text: string;
+    /**
+     * Billable token usage for this turn, when the backend reports it. Optional —
+     * a reasoner that cannot report usage omits it, and the metering path treats a
+     * missing field as "unknown", never zero. Consumed into `usage.recorded`.
+     */
+    readonly usage?: ReasonerUsage;
+};
+/** Token usage a reasoner may attach to its terminal `finish` part. */
+export interface ReasonerUsage {
+    /** Provider slug (e.g. "openai"), for low-cardinality cost attribution. */
+    readonly provider?: string;
+    /** Model id (e.g. "gpt-4.1-mini"). Without this, spend cannot be attributed to a model. */
+    readonly model?: string;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly totalTokens?: number;
+    readonly cachedInputTokens?: number;
+    readonly reasoningTokens?: number;
+}
+//# sourceMappingURL=reasoner.d.ts.map

package/dist/reasoner.d.ts.map

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

package/dist/reasoner.js

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Reasoner seam
+//
+// A reasoning backend reduced to one normalized pull-stream per turn. Frameworks
+// (AI SDK ToolLoopAgent, Mastra Agent, raw streamText) become a Reasoner via
+// adapters; the bridge drives the seam, not the framework. See RFC §4.2.
+export {};
+//# sourceMappingURL=reasoner.js.map

package/dist/reasoner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner.js","sourceRoot":"","sources":["../src/reasoner.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,mCAAmC;AACnC,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,yEAAyE"}

package/dist/retry.d.ts

@@ -0,0 +1,31 @@
+export interface RetryConfig {
+    readonly maxAttempts: number;
+    readonly baseDelayMs: number;
+    readonly maxDelayMs: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Retry profile for long-lived voice-provider WebSockets (STT/TTS).
+ *
+ * Keeps the SAME fast first reconnect as the default (~125-250 ms) so a transient
+ * blip during a live call recovers without dead air, but raises the backoff cap to
+ * 10 s and allows more attempts so a persistent provider failure (rate limit /
+ * outage) is retried patiently instead of giving up after ~2 s. This intentionally
+ * does NOT use a multi-second *floor* (a 4 s first-retry would mean seconds of dead
+ * air on a live call); "every 10 ms matters" applies to the first reconnect, patient
+ * backoff applies only after repeated failures.
+ */
+export declare const VOICE_PROVIDER_RETRY_CONFIG: RetryConfig;
+export declare const VOICE_PROVIDER_OUTAGE_RETRY_CONFIG: RetryConfig;
+export declare function readRetryConfig(config: Record<string, unknown>): RetryConfig;
+/** Read retry config for a voice-provider WebSocket; defaults to the patient-backoff profile. */
+export declare function readProviderRetryConfig(config: Record<string, unknown>): RetryConfig;
+export declare function retryDelayMs(attemptIndex: number, config: RetryConfig): number;
+/**
+ * Equal-jitter backoff: half the deterministic exponential delay plus a random half.
+ * Spreads out retries so many sessions hitting the same provider rate/concurrency limit
+ * at once don't reconnect in lockstep (thundering herd). `rng` is injectable for tests.
+ */
+export declare function retryDelayWithJitterMs(attemptIndex: number, config: RetryConfig, rng?: () => number): number;
+export declare function waitForRetryDelay(attemptIndex: number, config: RetryConfig, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAIzC,CAAC;AAEF,eAAO,MAAM,kCAAkC,EAAE,WAIhD,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAE5E;AAED,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAMpF;AAUD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,EACnB,GAAG,GAAE,MAAM,MAAoB,GAC9B,MAAM,CAIR;AAED,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAetH"}