@kuralle-syrinx/core 4.4.0 → 4.5.0

package/dist/iu-ledger.js

@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Incremental-Unit ledger (IU substrate, RFC incremental-unit-substrate)
+export class InMemoryIuLedger {
+    onEvent;
+    maxContexts;
+    byCtx = new Map();
+    constructor(onEvent = () => { }, maxContexts = 256) {
+        this.onEvent = onEvent;
+        this.maxContexts = maxContexts;
+    }
+    add(iu) {
+        const ctx = iu.id.contextId;
+        if (!this.byCtx.has(ctx) && this.byCtx.size >= this.maxContexts) {
+            const oldest = this.byCtx.keys().next().value;
+            if (oldest !== undefined)
+                this.byCtx.delete(oldest);
+        }
+        this.ctxMap(ctx).set(iu.id.iuId, iu);
+    }
+    commit(id, prefix) {
+        const ctxMap = this.byCtx.get(id.contextId);
+        if (!ctxMap) {
+            this.onEvent({ kind: "unknown_iu", op: "commit", id });
+            return;
+        }
+        const iu = ctxMap.get(id.iuId);
+        if (!iu) {
+            this.onEvent({ kind: "unknown_iu", op: "commit", id });
+            return;
+        }
+        if (iu.state !== "hypothesized") {
+            this.onEvent({ kind: "terminal_op", op: "commit", id, state: iu.state });
+            return;
+        }
+        iu.state = "committed";
+        if (prefix) {
+            iu.committedPrefix = prefix;
+        }
+    }
+    revoke(id) {
+        const ctxMap = this.byCtx.get(id.contextId);
+        if (!ctxMap) {
+            this.onEvent({ kind: "unknown_iu", op: "revoke", id });
+            return;
+        }
+        const iu = ctxMap.get(id.iuId);
+        if (!iu) {
+            this.onEvent({ kind: "unknown_iu", op: "revoke", id });
+            return;
+        }
+        if (iu.state !== "hypothesized") {
+            this.onEvent({ kind: "terminal_op", op: "revoke", id, state: iu.state });
+            return;
+        }
+        iu.state = "revoked";
+    }
+    get(id) {
+        const ctxMap = this.byCtx.get(id.contextId);
+        if (!ctxMap) {
+            return undefined;
+        }
+        return ctxMap.get(id.iuId);
+    }
+    latest(contextId, kind) {
+        const ctxMap = this.byCtx.get(contextId);
+        if (!ctxMap) {
+            return undefined;
+        }
+        let found;
+        for (const iu of ctxMap.values()) {
+            if (iu.kind === kind) {
+                found = iu;
+            }
+        }
+        return found;
+    }
+    clear(contextId) {
+        this.byCtx.delete(contextId);
+    }
+    ctxMap(contextId) {
+        let map = this.byCtx.get(contextId);
+        if (!map) {
+            map = new Map();
+            this.byCtx.set(contextId, map);
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=iu-ledger.js.map

package/dist/iu-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iu-ledger.js","sourceRoot":"","sources":["../src/iu-ledger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,4FAA4F;AAiB5F,MAAM,OAAO,gBAAgB;IAIR;IACA;IAJF,KAAK,GAAG,IAAI,GAAG,EAAwC,CAAC;IAEzE,YACmB,UAAwC,GAAG,EAAE,GAAE,CAAC,EAChD,cAAsB,GAAG;QADzB,YAAO,GAAP,OAAO,CAAyC;QAChD,gBAAW,GAAX,WAAW,CAAc;IACzC,CAAC;IAEJ,GAAG,CAAC,EAAmB;QACrB,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,EAAqB,EAAE,MAAwC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,KAAK,GAAG,WAAW,CAAC;QACvB,IAAI,MAAM,EAAE,CAAC;YACX,EAAE,CAAC,eAAe,GAAG,MAAM,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,EAAqB;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QACD,EAAE,CAAC,KAAK,GAAG,SAAS,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,EAAqB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,IAA6B;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAkC,CAAC;QACvC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACrB,KAAK,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAEO,MAAM,CAAC,SAAiB;QAC9B,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/latency-filler-fixtures.d.ts

@@ -0,0 +1,7 @@
+export interface LatencyFillerFixture {
+    readonly id: string;
+    readonly userText: string;
+    readonly expectedConnective: string;
+}
+export declare const LATENCY_FILLER_FIXTURES: readonly LatencyFillerFixture[];
+//# sourceMappingURL=latency-filler-fixtures.d.ts.map

package/dist/latency-filler-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-filler-fixtures.d.ts","sourceRoot":"","sources":["../src/latency-filler-fixtures.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAKzD,CAAC"}

package/dist/latency-filler-fixtures.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: MIT
+//
+// Labeled utterances for latency-filler connective selection tests.
+export const LATENCY_FILLER_FIXTURES = [
+    { id: "question", userText: "Can I still add Biology 101?", expectedConnective: "Well," },
+    { id: "thanks", userText: "Thanks for checking that.", expectedConnective: "Right," },
+    { id: "statement-0", userText: "I need the late add form.", expectedConnective: "So," },
+    { id: "statement-1", userText: "My hold is blocking registration.", expectedConnective: "Well," },
+];
+//# sourceMappingURL=latency-filler-fixtures.js.map

package/dist/latency-filler-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-filler-fixtures.js","sourceRoot":"","sources":["../src/latency-filler-fixtures.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,oEAAoE;AAQpE,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACtE,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,OAAO,EAAE;IACzF,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,QAAQ,EAAE;IACrF,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,KAAK,EAAE;IACvF,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,mCAAmC,EAAE,kBAAkB,EAAE,OAAO,EAAE;CACzF,CAAC"}

package/dist/latency-filler.d.ts

@@ -0,0 +1,29 @@
+export declare const LATENCY_FILLER_CONNECTIVES: readonly ["So,", "Well,", "Right,", "Okay,", "Hmm,"];
+export type LatencyFillerConnective = (typeof LATENCY_FILLER_CONNECTIVES)[number];
+export interface LatencyFillerState {
+    readonly text: string;
+    active: boolean;
+    spliced: boolean;
+    cancelled: boolean;
+    readonly startedAtMs: number;
+}
+export interface LatencyFillerConfig {
+    readonly enabled?: boolean;
+}
+export declare class LatencyFillerController {
+    private readonly enabled;
+    private turnIndex;
+    private readonly states;
+    constructor(config?: LatencyFillerConfig);
+    isEnabled(): boolean;
+    start(contextId: string, userText: string, nowMs?: number): string | null;
+    getState(contextId: string): LatencyFillerState | undefined;
+    isActive(contextId: string): boolean;
+    isFillerOnly(contextId: string): boolean;
+    spliceLlmDelta(contextId: string, delta: string): string;
+    cancel(contextId: string): LatencyFillerState | null;
+    clear(contextId: string): void;
+}
+export declare function selectLatencyFillerConnective(userText: string, turnIndex: number): string;
+export declare function stripRedundantFillerPrefix(fillerText: string, llmText: string): string;
+//# sourceMappingURL=latency-filler.d.ts.map

package/dist/latency-filler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-filler.d.ts","sourceRoot":"","sources":["../src/latency-filler.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,0BAA0B,sDAM7B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAEpD,MAAM,GAAE,mBAAwB;IAI5C,SAAS,IAAI,OAAO;IAIpB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,MAAM,GAAG,IAAI;IAe7E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI3D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKpC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKxC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAOxD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAQpD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAG/B;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMzF;AAQD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBtF"}

package/dist/latency-filler.js

@@ -0,0 +1,102 @@
+// SPDX-License-Identifier: MIT
+//
+// VE-03 / G24 — latency-hiding dual-track filler (DDTSR direction).
+// Emits a short discourse connective at endpoint while the main LLM spins up.
+export const LATENCY_FILLER_CONNECTIVES = [
+    "So,",
+    "Well,",
+    "Right,",
+    "Okay,",
+    "Hmm,",
+];
+export class LatencyFillerController {
+    enabled;
+    turnIndex = 0;
+    states = new Map();
+    constructor(config = {}) {
+        this.enabled = config.enabled === true;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    start(contextId, userText, nowMs = Date.now()) {
+        if (!this.enabled)
+            return null;
+        if (this.states.has(contextId))
+            return null;
+        const text = selectLatencyFillerConnective(userText, this.turnIndex);
+        this.turnIndex += 1;
+        this.states.set(contextId, {
+            text,
+            active: true,
+            spliced: false,
+            cancelled: false,
+            startedAtMs: nowMs,
+        });
+        return text;
+    }
+    getState(contextId) {
+        return this.states.get(contextId);
+    }
+    isActive(contextId) {
+        const state = this.states.get(contextId);
+        return state?.active === true && state.cancelled !== true;
+    }
+    isFillerOnly(contextId) {
+        const state = this.states.get(contextId);
+        return state?.active === true && state.spliced !== true && state.cancelled !== true;
+    }
+    spliceLlmDelta(contextId, delta) {
+        const state = this.states.get(contextId);
+        if (!state || state.cancelled || state.spliced)
+            return delta;
+        state.spliced = true;
+        return stripRedundantFillerPrefix(state.text, delta);
+    }
+    cancel(contextId) {
+        const state = this.states.get(contextId);
+        if (!state || state.cancelled)
+            return null;
+        state.cancelled = true;
+        state.active = false;
+        return state;
+    }
+    clear(contextId) {
+        this.states.delete(contextId);
+    }
+}
+export function selectLatencyFillerConnective(userText, turnIndex) {
+    const trimmed = userText.trim().toLowerCase();
+    if (trimmed.endsWith("?"))
+        return "Well,";
+    if (/\b(thanks|thank you)\b/.test(trimmed))
+        return "Right,";
+    const pool = LATENCY_FILLER_CONNECTIVES;
+    return pool[((turnIndex % pool.length) + pool.length) % pool.length];
+}
+function fillerPrefixBoundary(lowerBody, prefixLen) {
+    if (prefixLen >= lowerBody.length)
+        return true;
+    const next = lowerBody[prefixLen];
+    return /[\s,.!?…:;—\-]/.test(next);
+}
+export function stripRedundantFillerPrefix(fillerText, llmText) {
+    const fillerWord = fillerText.replace(/[.,!?…\s]+$/g, "").trim().toLowerCase();
+    if (!fillerWord)
+        return llmText;
+    const body = llmText.trimStart();
+    const lowerBody = body.toLowerCase();
+    if (lowerBody.startsWith(fillerWord) && fillerPrefixBoundary(lowerBody, fillerWord.length)) {
+        let rest = body.slice(fillerWord.length);
+        rest = rest.replace(/^[\s,]+/, "");
+        return rest;
+    }
+    const withPunct = `${fillerWord},`;
+    if (lowerBody.startsWith(withPunct) && fillerPrefixBoundary(lowerBody, withPunct.length)) {
+        let rest = body.slice(withPunct.length);
+        rest = rest.replace(/^[\s,]+/, "");
+        return rest;
+    }
+    return llmText;
+}
+//# sourceMappingURL=latency-filler.js.map

package/dist/latency-filler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-filler.js","sourceRoot":"","sources":["../src/latency-filler.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,oEAAoE;AACpE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK;IACL,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;CACE,CAAC;AAgBX,MAAM,OAAO,uBAAuB;IACjB,OAAO,CAAU;IAC1B,SAAS,GAAG,CAAC,CAAC;IACL,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEhE,YAAY,SAA8B,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACzC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;QAC3D,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,IAAI,GAAG,6BAA6B,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE;YACzB,IAAI;YACJ,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,CAAC,SAAiB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IAC5D,CAAC;IAED,YAAY,CAAC,SAAiB;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACtF,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,KAAa;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC7D,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,OAAO,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3C,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB,EAAE,SAAiB;IAC/E,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5D,MAAM,IAAI,GAAG,0BAA0B,CAAC;IACxC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAE,CAAC;AACxE,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB,EAAE,SAAiB;IAChE,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAE,CAAC;IACnC,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAkB,EAAE,OAAe;IAC5E,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/E,IAAI,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC;IAEhC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3F,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,UAAU,GAAG,CAAC;IACnC,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACzF,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/mode-switcher.d.ts

@@ -0,0 +1,24 @@
+import type { PipelineBus } from "./pipeline-bus.js";
+import type { ModeSwitchRequestedPacket } from "./packets.js";
+import { type InitStep as InitStepType } from "./init-chain.js";
+export interface ModeSwitchHandlers {
+    /** Steps to run when switching from text to audio mode. */
+    textToAudioSteps: InitStepType[];
+    /** Steps to run when switching from audio to text mode (teardown). */
+    audioToTextCleanups: Array<() => Promise<void>>;
+}
+export declare class ModeSwitcher {
+    private currentMode;
+    private readonly bus;
+    private handlers;
+    constructor(bus: PipelineBus, initialMode?: "text" | "audio");
+    /** Register the init/teardown steps. Call once during session setup. */
+    register(handlers: ModeSwitchHandlers): void;
+    /** Get the current mode. */
+    get mode(): "text" | "audio";
+    /** Handle a mode switch request from the bus. */
+    handleSwitchRequested(pkt: ModeSwitchRequestedPacket): Promise<void>;
+    private switchToAudio;
+    private switchToText;
+}
+//# sourceMappingURL=mode-switcher.d.ts.map

package/dist/mode-switcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-switcher.d.ts","sourceRoot":"","sources":["../src/mode-switcher.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAgB,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAM9E,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,sEAAsE;IACtE,mBAAmB,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CACjD;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,GAAG,EAAE,WAAW,EAAE,WAAW,GAAE,MAAM,GAAG,OAAiB;IAKrE,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI5C,4BAA4B;IAC5B,IAAI,IAAI,IAAI,MAAM,GAAG,OAAO,CAE3B;IAED,iDAAiD;IAC3C,qBAAqB,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;YAe5D,aAAa;YAoBb,YAAY;CAmB3B"}

package/dist/mode-switcher.js

@@ -0,0 +1,83 @@
+// SPDX-License-Identifier: MIT
+//
+// Syrinx Kernel v2 — Mode Switcher
+//
+// Handles text ↔ audio mode transitions mid-session.
+// Text→Audio: serial init of audio pipeline (STT, TTS, VAD, EOS, Denoiser)
+// Audio→Text: confirm text mode immediately, teardown audio components in background
+//
+// Design decision: audio→text confirms immediately so the user can send text
+// without waiting for STT/TTS/VAD/EOS WebSocket connections to close.
+import { Route } from "./pipeline-bus.js";
+import { runInitChain } from "./init-chain.js";
+// =============================================================================
+// Switcher
+// =============================================================================
+export class ModeSwitcher {
+    currentMode;
+    bus;
+    handlers = null;
+    constructor(bus, initialMode = "audio") {
+        this.bus = bus;
+        this.currentMode = initialMode;
+    }
+    /** Register the init/teardown steps. Call once during session setup. */
+    register(handlers) {
+        this.handlers = handlers;
+    }
+    /** Get the current mode. */
+    get mode() {
+        return this.currentMode;
+    }
+    /** Handle a mode switch request from the bus. */
+    async handleSwitchRequested(pkt) {
+        if (pkt.mode === this.currentMode)
+            return;
+        if (!this.handlers)
+            return;
+        if (pkt.mode === "audio") {
+            await this.switchToAudio(pkt.contextId);
+        }
+        else {
+            await this.switchToText(pkt.contextId);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private
+    // ---------------------------------------------------------------------------
+    async switchToAudio(contextId) {
+        if (!this.handlers)
+            return;
+        try {
+            await runInitChain(this.bus, this.handlers.textToAudioSteps);
+            this.currentMode = "audio";
+            const completed = {
+                kind: "mode.switch_completed",
+                contextId,
+                timestampMs: Date.now(),
+                mode: "audio",
+            };
+            this.bus.push(Route.Main, completed);
+        }
+        catch (err) {
+            // Init chain already emitted init.failed — re-throw for session handler
+            throw err;
+        }
+    }
+    async switchToText(contextId) {
+        // Confirm text mode immediately — don't wait for teardown
+        this.currentMode = "text";
+        const completed = {
+            kind: "mode.switch_completed",
+            contextId,
+            timestampMs: Date.now(),
+            mode: "text",
+        };
+        this.bus.push(Route.Main, completed);
+        // Teardown audio components in background
+        if (this.handlers?.audioToTextCleanups) {
+            void Promise.allSettled(this.handlers.audioToTextCleanups.map((fn) => fn()));
+        }
+    }
+}
+//# sourceMappingURL=mode-switcher.js.map

package/dist/mode-switcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-switcher.js","sourceRoot":"","sources":["../src/mode-switcher.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,mCAAmC;AACnC,EAAE;AACF,qDAAqD;AACrD,2EAA2E;AAC3E,qFAAqF;AACrF,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AAGtE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK1C,OAAO,EAAE,YAAY,EAAiC,MAAM,iBAAiB,CAAC;AAa9E,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,MAAM,OAAO,YAAY;IACf,WAAW,CAAmB;IACrB,GAAG,CAAc;IAC1B,QAAQ,GAA8B,IAAI,CAAC;IAEnD,YAAY,GAAgB,EAAE,cAAgC,OAAO;QACnE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,QAAQ,CAAC,QAA4B;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,qBAAqB,CAAC,GAA8B;QACxD,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW;YAAE,OAAO;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAEtE,KAAK,CAAC,aAAa,CAAC,SAAiB;QAC3C,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3B,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;YAC7D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;YAE3B,MAAM,SAAS,GAA8B;gBAC3C,IAAI,EAAE,uBAAuB;gBAC7B,SAAS;gBACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;gBACvB,IAAI,EAAE,OAAO;aACd,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,wEAAwE;YACxE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,SAAiB;QAC1C,0DAA0D;QAC1D,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAE1B,MAAM,SAAS,GAA8B;YAC3C,IAAI,EAAE,uBAAuB;YAC7B,SAAS;YACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;YACvB,IAAI,EAAE,MAAM;SACb,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAErC,0CAA0C;QAC1C,IAAI,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;YACvC,KAAK,OAAO,CAAC,UAAU,CACrB,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/observability-observer.d.ts

@@ -0,0 +1,36 @@
+import { type PipelineBus } from "./pipeline-bus.js";
+import { type MetricsExporter, type ObservabilityLayer } from "./observability.js";
+export interface ObservabilityDims {
+    readonly provider: string;
+    readonly model: string;
+    readonly region: string;
+    readonly layer?: ObservabilityLayer;
+}
+export interface ObservabilityObserverDeps {
+    readonly bus: PipelineBus;
+    readonly exporter: MetricsExporter;
+    readonly sessionId: string;
+    readonly dims: ObservabilityDims;
+    readonly getContextId: () => string;
+}
+export declare class ObservabilityObserver {
+    private readonly deps;
+    private readonly boundaryTimes;
+    private readonly stageDims;
+    private readonly agentStartedEmitted;
+    private readonly unsubscribes;
+    constructor(deps: ObservabilityObserverDeps);
+    wire(disposers?: Array<() => void>): void;
+    dispose(): void;
+    private speechId;
+    private onVadSpeechStarted;
+    private onVadSpeechEnded;
+    private onTurnComplete;
+    private onTtsAudio;
+    private onTtsEnd;
+    private onInterruptDetected;
+    private emitBoundary;
+    private mergeStageDims;
+    private dimsFor;
+}
+//# sourceMappingURL=observability-observer.d.ts.map

package/dist/observability-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-observer.d.ts","sourceRoot":"","sources":["../src/observability-observer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAYnG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC;CACrC;AAKD,qBAAa,qBAAqB;IAMpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAEzB,IAAI,EAAE,yBAAyB;IAE5D,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IA8BzC,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,YAAY;IAqDpB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,OAAO;CAahB"}

package/dist/observability-observer.js

@@ -0,0 +1,141 @@
+// SPDX-License-Identifier: MIT
+import { Route } from "./pipeline-bus.js";
+import { monotonicNowMs } from "./observability.js";
+import * as make from "./packet-factories.js";
+export class ObservabilityObserver {
+    deps;
+    boundaryTimes = new Map();
+    stageDims = new Map();
+    agentStartedEmitted = new Set();
+    unsubscribes = [];
+    constructor(deps) {
+        this.deps = deps;
+    }
+    wire(disposers) {
+        const reg = (unsub) => {
+            this.unsubscribes.push(unsub);
+            disposers?.push(unsub);
+        };
+        reg(this.deps.bus.on("vad.speech_started", (pkt) => this.onVadSpeechStarted(pkt)));
+        reg(this.deps.bus.on("vad.speech_ended", (pkt) => this.onVadSpeechEnded(pkt)));
+        reg(this.deps.bus.on("eos.turn_complete", (pkt) => this.onTurnComplete(pkt)));
+        reg(this.deps.bus.on("tts.audio", (pkt) => this.onTtsAudio(pkt)));
+        reg(this.deps.bus.on("tts.end", (pkt) => this.onTtsEnd(pkt)));
+        reg(this.deps.bus.on("interrupt.detected", (pkt) => this.onInterruptDetected(pkt)));
+    }
+    dispose() {
+        for (const unsub of this.unsubscribes)
+            unsub();
+        this.unsubscribes.length = 0;
+        this.boundaryTimes.clear();
+        this.stageDims.clear();
+        this.agentStartedEmitted.clear();
+    }
+    speechId(contextId) {
+        return contextId || this.deps.getContextId();
+    }
+    onVadSpeechStarted(pkt) {
+        this.emitBoundary(this.speechId(pkt.contextId), "user_started_speaking");
+    }
+    onVadSpeechEnded(pkt) {
+        this.emitBoundary(this.speechId(pkt.contextId), "user_stopped_speaking");
+    }
+    onTurnComplete(pkt) {
+        const provider = pkt.transcripts[0]?.provider;
+        if (provider)
+            this.mergeStageDims(this.speechId(pkt.contextId), provider);
+        this.emitBoundary(this.speechId(pkt.contextId), "agent_thinking");
+    }
+    onTtsAudio(pkt) {
+        const id = pkt.contextId;
+        if (pkt.provider)
+            this.mergeStageDims(id, pkt.provider);
+        if (this.agentStartedEmitted.has(id))
+            return;
+        this.agentStartedEmitted.add(id);
+        this.emitBoundary(id, "agent_started_speaking");
+    }
+    onTtsEnd(pkt) {
+        this.emitBoundary(this.speechId(pkt.contextId), "agent_audio_done");
+    }
+    onInterruptDetected(pkt) {
+        this.stageDims.set(this.speechId(pkt.contextId), {
+            ...this.stageDims.get(this.speechId(pkt.contextId)),
+            cancelled: true,
+        });
+        this.emitBoundary(this.speechId(pkt.contextId), "interruption", true);
+    }
+    emitBoundary(speechId, boundary, cancelled = false) {
+        const now = monotonicNowMs();
+        let times = this.boundaryTimes.get(speechId);
+        if (!times) {
+            times = {};
+            this.boundaryTimes.set(speechId, times);
+        }
+        const dims = this.dimsFor(speechId, cancelled);
+        const tags = {
+            provider: dims.provider,
+            model: dims.model,
+            region: dims.region,
+            cancelled: dims.cancelled ? "true" : "false",
+            layer: dims.layer ?? "conversation",
+        };
+        if (boundary === "agent_started_speaking") {
+            const stopped = times.user_stopped_speaking;
+            if (stopped !== undefined) {
+                const delta = now - stopped;
+                if (delta >= 0)
+                    this.deps.exporter.observeHistogram("v2v_ms", delta, tags);
+            }
+            const thinking = times.agent_thinking;
+            if (thinking !== undefined) {
+                const delta = now - thinking;
+                if (delta >= 0)
+                    this.deps.exporter.observeHistogram("thinking_ms", delta, tags);
+            }
+        }
+        else if (boundary === "agent_audio_done") {
+            const started = times.agent_started_speaking;
+            if (started !== undefined) {
+                const delta = now - started;
+                if (delta >= 0)
+                    this.deps.exporter.observeHistogram("agent_speech_ms", delta, tags);
+            }
+        }
+        times[boundary] = now;
+        this.deps.bus.push(Route.Background, make.turnBoundary(speechId, Date.now(), {
+            boundary,
+            sessionId: this.deps.sessionId,
+            speechId,
+            monotonicMs: now,
+            provider: dims.provider,
+            model: dims.model,
+            region: dims.region,
+            cancelled: dims.cancelled || undefined,
+        }));
+    }
+    mergeStageDims(speechId, provider) {
+        const current = this.stageDims.get(speechId) ?? {};
+        this.stageDims.set(speechId, {
+            ...current,
+            provider: readString(provider["name"], readString(provider["provider"], current.provider)),
+            model: readString(provider["model"], current.model),
+            region: readString(provider["region"], current.region),
+            cancelled: typeof provider["cancelled"] === "boolean" ? provider["cancelled"] : current.cancelled,
+        });
+    }
+    dimsFor(speechId, cancelled) {
+        const stage = this.stageDims.get(speechId) ?? {};
+        return {
+            provider: stage.provider ?? this.deps.dims.provider,
+            model: stage.model ?? this.deps.dims.model,
+            region: stage.region ?? this.deps.dims.region,
+            layer: stage.layer ?? this.deps.dims.layer ?? "conversation",
+            cancelled: cancelled || stage.cancelled === true,
+        };
+    }
+}
+function readString(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+//# sourceMappingURL=observability-observer.js.map

package/dist/observability-observer.js.map

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

package/dist/observability.d.ts

@@ -0,0 +1,68 @@
+import type { TurnBoundaryEventPacket } from "./packets.js";
+/** Monotonic clock immune to system-clock adjustments; ms since an arbitrary origin. */
+export declare function monotonicNowMs(): number;
+export type ObservabilityLayer = "infrastructure" | "conversation";
+export type TurnLocalizationVerdict = ObservabilityLayer | "none";
+export interface TurnLocalizationSignals {
+    readonly infrastructureBreached: boolean;
+    readonly conversationFlagged: boolean;
+}
+export declare function localizeTurn(signals: TurnLocalizationSignals): TurnLocalizationVerdict;
+/** One step of a reconstructed turn timeline, with elapsed ms since the prior boundary. */
+export interface TurnTimelineStep {
+    readonly boundary: TurnBoundaryEventPacket["boundary"];
+    readonly speechId: string;
+    readonly monotonicMs: number;
+    /** ms since the previous boundary in this reconstruction (0 for the first). */
+    readonly sincePrevMs: number;
+    readonly cancelled: boolean;
+}
+/**
+ * Incident reconstruction (VE-07.5): given the `obs.turn_boundary` events for one
+ * session id, return the ordered turn timeline with inter-boundary deltas so a
+ * developer can replay what happened from a single session id.
+ */
+export declare function reconstructTurnTimeline(events: readonly TurnBoundaryEventPacket[], sessionId: string, speechId?: string): TurnTimelineStep[];
+export interface MetricTags {
+    readonly [key: string]: string | undefined;
+    readonly layer?: ObservabilityLayer;
+}
+export interface SpanHandle {
+    end(tags?: MetricTags): void;
+}
+/** Export seam — implementations (Prometheus/OTel) live in optional packages, NOT here. */
+export interface MetricsExporter {
+    observeHistogram(name: string, valueMs: number, tags: MetricTags): void;
+    /**
+     * A monotonic count (tokens, characters, audio-seconds). Counters, not histograms:
+     * usage sums to a bill, latency distributes to a percentile — different instruments.
+     * Optional so an existing exporter that predates it still satisfies the interface;
+     * producers call it as `exporter.observeCounter?.(...)`.
+     */
+    observeCounter?(name: string, value: number, tags: MetricTags): void;
+    startSpan(name: string, tags: MetricTags): SpanHandle;
+}
+/** Default no-op exporter (core never depends on a backend). */
+export declare const noopMetricsExporter: MetricsExporter;
+/** In-memory exporter for tests + incident reconstruction. */
+export declare class InMemoryMetricsExporter implements MetricsExporter {
+    readonly histograms: Array<{
+        name: string;
+        valueMs: number;
+        tags: MetricTags;
+    }>;
+    readonly counters: Array<{
+        name: string;
+        value: number;
+        tags: MetricTags;
+    }>;
+    readonly spans: Array<{
+        name: string;
+        tags: MetricTags;
+        durationMs?: number;
+    }>;
+    observeHistogram(name: string, valueMs: number, tags: MetricTags): void;
+    observeCounter(name: string, value: number, tags: MetricTags): void;
+    startSpan(name: string, tags: MetricTags): SpanHandle;
+}
+//# sourceMappingURL=observability.d.ts.map