prefix-safe-json 0.0.1-alpha.0

package/dist/providers/openai.d.ts

@@ -0,0 +1,48 @@
+import { ProviderName, NormalizedToolStreamEvent, StreamEndReason } from "../coordinator/protocol.js";
+import { ProviderStreamAdapter } from "./adapter.js";
+interface OpenAIFunctionCallDelta {
+    name?: string;
+    arguments?: string;
+}
+interface OpenAIChoice {
+    delta?: {
+        function_call?: OpenAIFunctionCallDelta;
+        tool_calls?: unknown;
+    };
+    finish_reason?: string | null;
+}
+export interface OpenAIEvent {
+    choices?: OpenAIChoice[];
+    type?: string;
+    output_index?: number;
+    item?: {
+        type?: string;
+        id?: string;
+        call_id?: string;
+        name?: string;
+        arguments?: string;
+    };
+    item_id?: string;
+    delta?: string;
+    arguments?: string;
+    response?: {
+        status?: string;
+    };
+}
+export declare class OpenAIStreamAdapter implements ProviderStreamAdapter<unknown> {
+    readonly provider: ProviderName;
+    private sequence;
+    private compatibleAdapter;
+    private hasLegacyFunctionCall;
+    private legacySourceKey;
+    private accumulatedArguments;
+    private receivedDeltas;
+    private finished;
+    push(rawEvent: unknown): readonly NormalizedToolStreamEvent[];
+    finish(meta?: {
+        reason?: StreamEndReason;
+        providerReason?: string;
+    }): readonly NormalizedToolStreamEvent[];
+}
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,UAAU,uBAAuB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,uBAAuB,CAAC;QACxC,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,qBAAa,mBAAoB,YAAW,qBAAqB,CAAC,OAAO,CAAC;IACxE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAK;IAGrB,OAAO,CAAC,iBAAiB,CAAuC;IAGhE,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,eAAe,CAA0B;IAGjD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,cAAc,CAAqB;IAE3C,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,yBAAyB,EAAE;IAkL7D,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,yBAAyB,EAAE;CAiB3G"}

package/dist/providers/openai.js

@@ -0,0 +1,205 @@
+import { OpenAICompatibleStreamAdapter } from "./openai-compatible.js";
+export class OpenAIStreamAdapter {
+    provider = "openai";
+    sequence = 0;
+    // Delegating tool_calls format to compatible adapter
+    compatibleAdapter = new OpenAICompatibleStreamAdapter();
+    // For function_call (legacy)
+    hasLegacyFunctionCall = false;
+    legacySourceKey = "legacy-function-call";
+    // For Responses API
+    accumulatedArguments = new Map();
+    receivedDeltas = new Set();
+    finished = false;
+    push(rawEvent) {
+        if (this.finished)
+            return [];
+        const events = [];
+        if (!rawEvent || typeof rawEvent !== "object") {
+            events.push({
+                type: "provider_diagnostic",
+                sequence: ++this.sequence,
+                provider: this.provider,
+                code: "E_PROVIDER_EVENT_MALFORMED",
+                severity: "error",
+                message: "Raw event is not an object",
+            });
+            return events;
+        }
+        const chunk = rawEvent;
+        // Handle Responses API
+        if (chunk.type?.startsWith("response.") || chunk.type === "error") {
+            if (chunk.type === "error") {
+                events.push({
+                    type: "provider_stream_end",
+                    sequence: ++this.sequence,
+                    provider: this.provider,
+                    reason: "provider_error",
+                    providerReason: "error",
+                });
+                this.finished = true;
+                return events;
+            }
+            if (chunk.type === "response.output_item.added" && chunk.item?.type === "function_call" && chunk.item.id) {
+                events.push({
+                    type: "tool_call_start",
+                    sequence: ++this.sequence,
+                    provider: this.provider,
+                    callRef: { sourceKey: `output-item:${chunk.item.id}` },
+                    toolCallId: chunk.item.call_id,
+                    name: chunk.item.name,
+                });
+            }
+            else if (chunk.type === "response.function_call_arguments.delta" && chunk.item_id && chunk.delta) {
+                this.receivedDeltas.add(chunk.item_id);
+                const acc = this.accumulatedArguments.get(chunk.item_id) ?? "";
+                this.accumulatedArguments.set(chunk.item_id, acc + chunk.delta);
+                events.push({
+                    type: "tool_call_arguments_delta",
+                    sequence: ++this.sequence,
+                    provider: this.provider,
+                    callRef: { sourceKey: `output-item:${chunk.item_id}` },
+                    delta: chunk.delta,
+                });
+            }
+            else if (chunk.type === "response.function_call_arguments.done" && chunk.item_id && chunk.arguments !== undefined) {
+                const acc = this.accumulatedArguments.get(chunk.item_id) ?? "";
+                const hasDeltas = this.receivedDeltas.has(chunk.item_id);
+                if (!hasDeltas && chunk.arguments.length > 0) {
+                    // No deltas, just final arguments.
+                    events.push({
+                        type: "tool_call_arguments_delta",
+                        sequence: ++this.sequence,
+                        provider: this.provider,
+                        callRef: { sourceKey: `output-item:${chunk.item_id}` },
+                        delta: chunk.arguments,
+                    });
+                    this.accumulatedArguments.set(chunk.item_id, chunk.arguments);
+                }
+                else if (hasDeltas && chunk.arguments !== acc) {
+                    events.push({
+                        type: "provider_diagnostic",
+                        sequence: ++this.sequence,
+                        provider: this.provider,
+                        callRef: { sourceKey: `output-item:${chunk.item_id}` },
+                        code: "E_FINAL_ARGUMENTS_CONFLICT",
+                        severity: "error",
+                        message: "Final arguments do not match accumulated deltas",
+                    });
+                }
+            }
+            else if (chunk.type === "response.output_item.done" && chunk.item?.id) {
+                events.push({
+                    type: "tool_call_end",
+                    sequence: ++this.sequence,
+                    provider: this.provider,
+                    callRef: { sourceKey: `output-item:${chunk.item.id}` },
+                    reason: "complete", // Default complete for item done
+                });
+            }
+            else if (chunk.type === "response.completed") {
+                events.push({
+                    type: "provider_stream_end",
+                    sequence: ++this.sequence,
+                    provider: this.provider,
+                    reason: "complete",
+                    providerReason: chunk.response?.status,
+                });
+                this.finished = true;
+            }
+            else if (chunk.type === "response.incomplete") {
+                events.push({
+                    type: "provider_stream_end",
+                    sequence: ++this.sequence,
+                    provider: this.provider,
+                    reason: "cancelled", // Incomplete treated as cancelled
+                    providerReason: chunk.response?.status,
+                });
+                this.finished = true;
+            }
+            return events;
+        }
+        // Check if it's the standard tool_calls format
+        if (chunk.choices?.[0]?.delta?.tool_calls !== undefined) {
+            // Delegate to OpenAICompatibleStreamAdapter
+            const compatibleEvents = this.compatibleAdapter.push(rawEvent);
+            // Map provider name to "openai"
+            return compatibleEvents.map(e => ({ ...e, provider: this.provider, sequence: ++this.sequence }));
+        }
+        // Handle legacy function_call format
+        if (Array.isArray(chunk.choices)) {
+            for (const choice of chunk.choices) {
+                if (choice.delta?.function_call) {
+                    const fc = choice.delta.function_call;
+                    if (!this.hasLegacyFunctionCall) {
+                        this.hasLegacyFunctionCall = true;
+                        events.push({
+                            type: "tool_call_start",
+                            sequence: ++this.sequence,
+                            provider: this.provider,
+                            callRef: { sourceKey: this.legacySourceKey },
+                            toolIndex: 0,
+                            name: fc.name,
+                        });
+                    }
+                    else if (fc.name) {
+                        events.push({
+                            type: "tool_call_name_delta",
+                            sequence: ++this.sequence,
+                            provider: this.provider,
+                            callRef: { sourceKey: this.legacySourceKey },
+                            delta: fc.name,
+                        });
+                    }
+                    if (fc.arguments) {
+                        events.push({
+                            type: "tool_call_arguments_delta",
+                            sequence: ++this.sequence,
+                            provider: this.provider,
+                            callRef: { sourceKey: this.legacySourceKey },
+                            delta: fc.arguments,
+                        });
+                    }
+                }
+                if (choice.finish_reason != null) {
+                    let reason = "unknown";
+                    if (choice.finish_reason === "stop" || choice.finish_reason === "function_call" || choice.finish_reason === "tool_calls") {
+                        reason = "complete";
+                    }
+                    else if (choice.finish_reason === "length") {
+                        reason = "length";
+                    }
+                    else if (choice.finish_reason === "cancelled") {
+                        reason = "cancelled";
+                    }
+                    events.push({
+                        type: "provider_stream_end",
+                        sequence: ++this.sequence,
+                        provider: this.provider,
+                        reason,
+                        providerReason: choice.finish_reason,
+                    });
+                    this.finished = true;
+                }
+            }
+        }
+        return events;
+    }
+    finish(meta) {
+        if (this.finished)
+            return [];
+        this.finished = true;
+        const compatibleEvents = this.compatibleAdapter.finish(meta);
+        if (compatibleEvents.length > 0 && !this.hasLegacyFunctionCall) {
+            return compatibleEvents.map(e => ({ ...e, provider: this.provider, sequence: ++this.sequence }));
+        }
+        return [{
+                type: "provider_stream_end",
+                sequence: ++this.sequence,
+                provider: this.provider,
+                reason: meta?.reason ?? "unknown",
+                providerReason: meta?.providerReason,
+            }];
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/providers/openrouter.d.ts

@@ -0,0 +1,35 @@
+import { ProviderName, NormalizedToolStreamEvent, StreamEndReason } from "../coordinator/protocol.js";
+import { ProviderStreamAdapter } from "./adapter.js";
+export interface OpenRouterChoice {
+    index?: number;
+    delta?: {
+        tool_calls?: Array<{
+            index?: number;
+            id?: string;
+            type?: string;
+            function?: {
+                name?: string;
+                arguments?: string;
+            };
+        }>;
+        reasoning?: string;
+    };
+    finish_reason?: string | null;
+    error?: unknown;
+}
+export interface OpenRouterEvent {
+    choices?: OpenRouterChoice[];
+    error?: unknown;
+}
+export declare class OpenRouterStreamAdapter implements ProviderStreamAdapter<unknown> {
+    readonly provider: ProviderName;
+    private sequence;
+    private compatibleAdapter;
+    private finished;
+    push(rawEvent: unknown): readonly NormalizedToolStreamEvent[];
+    finish(meta?: {
+        reason?: StreamEndReason;
+        providerReason?: string;
+    }): readonly NormalizedToolStreamEvent[];
+}
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/providers/openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,KAAK,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE;gBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,SAAS,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;SAClD,CAAC,CAAC;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,uBAAwB,YAAW,qBAAqB,CAAC,OAAO,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAK;IAGrB,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,yBAAyB,EAAE;IA4C7D,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,yBAAyB,EAAE;CAO3G"}

package/dist/providers/openrouter.js

@@ -0,0 +1,55 @@
+import { OpenAICompatibleStreamAdapter } from "./openai-compatible.js";
+export class OpenRouterStreamAdapter {
+    provider = "openrouter";
+    sequence = 0;
+    // Delegate standard tool_call formats to compatible adapter
+    compatibleAdapter = new OpenAICompatibleStreamAdapter();
+    finished = false;
+    push(rawEvent) {
+        if (this.finished)
+            return [];
+        const events = [];
+        if (!rawEvent || typeof rawEvent !== "object") {
+            events.push({
+                type: "provider_diagnostic",
+                sequence: ++this.sequence,
+                provider: this.provider,
+                code: "E_PROVIDER_EVENT_MALFORMED",
+                severity: "error",
+                message: "Raw event is not an object",
+            });
+            return events;
+        }
+        const chunk = rawEvent;
+        // Check for provider-level errors
+        if (chunk.error) {
+            events.push({
+                type: "provider_diagnostic",
+                sequence: ++this.sequence,
+                provider: this.provider,
+                code: "E_PROVIDER_ERROR",
+                severity: "error",
+                message: typeof chunk.error === "string" ? chunk.error : JSON.stringify(chunk.error)
+            });
+            const compatibleEvents = this.compatibleAdapter.finish({ reason: "provider_error", providerReason: "error" });
+            for (const e of compatibleEvents) {
+                events.push({ ...e, provider: this.provider, sequence: ++this.sequence });
+            }
+            this.finished = true;
+            return events;
+        }
+        const compatibleEvents = this.compatibleAdapter.push(chunk);
+        for (const e of compatibleEvents) {
+            events.push({ ...e, provider: this.provider, sequence: ++this.sequence });
+        }
+        return events;
+    }
+    finish(meta) {
+        if (this.finished)
+            return [];
+        this.finished = true;
+        const compatibleEvents = this.compatibleAdapter.finish(meta);
+        return compatibleEvents.map(e => ({ ...e, provider: this.provider, sequence: ++this.sequence }));
+    }
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/providers/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../../src/providers/openrouter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAsBvE,MAAM,OAAO,uBAAuB;IACzB,QAAQ,GAAiB,YAAY,CAAC;IACvC,QAAQ,GAAG,CAAC,CAAC;IAErB,4DAA4D;IACpD,iBAAiB,GAAG,IAAI,6BAA6B,EAAE,CAAC;IACxD,QAAQ,GAAG,KAAK,CAAC;IAEzB,IAAI,CAAC,QAAiB;QACpB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAE7B,MAAM,MAAM,GAAgC,EAAE,CAAC;QAE/C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,4BAA4B;gBAClC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,4BAA4B;aACtC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,QAA2B,CAAC;QAE1C,kCAAkC;QAClC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,kBAAkB;gBACxB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;aACrF,CAAC,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9G,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO,MAAM,CAAC;QACjB,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAA4D;QACjE,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACnG,CAAC;CACF"}

package/dist/semantic/builder.d.ts

@@ -0,0 +1,55 @@
+import type { ParserEvent, JsonValue, Diagnostic, RepairAction } from "../types.js";
+/**
+ * Manages the monotonic event queue.
+ * Events are never retracted once emitted.
+ */
+export declare class EventBuilder {
+    private queue;
+    private sequence;
+    private maxQueued;
+    private terminal;
+    constructor(maxQueuedEvents: number);
+    /** Current sequence number. */
+    get currentSequence(): number;
+    get isTerminal(): boolean;
+    /** Number of events in the queue. */
+    get queueLength(): number;
+    /**
+     * Emit a value_committed event.
+     */
+    emitValueCommitted(path: string, value: JsonValue, byteRange: readonly [number, number]): void;
+    /**
+     * Emit a container_closed event.
+     */
+    emitContainerClosed(path: string, container: "object" | "array"): void;
+    /**
+     * Emit a repair_applied event.
+     */
+    emitRepairApplied(repair: RepairAction): void;
+    /**
+     * Emit a diagnostic event.
+     */
+    emitDiagnostic(diagnostic: Diagnostic): void;
+    /**
+     * Emit a document_complete event.
+     */
+    emitDocumentComplete(executable: boolean): void;
+    /**
+     * Emit a stream_finished event.
+     */
+    emitStreamFinished(outcome: "valid" | "truncated" | "salvaged" | "invalid"): void;
+    /**
+     * Drain all pending events and clear the queue.
+     * Returns a frozen array.
+     */
+    drain(): readonly ParserEvent[];
+    /**
+     * Get the number of events emitted during the current push cycle.
+     * Call resetPushCount() before push processing.
+     */
+    private pushEmitCount;
+    resetPushCount(): void;
+    get emittedDuringPush(): number;
+    private enqueue;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/semantic/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/semantic/builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,eAAe,EAAE,MAAM;IAInC,+BAA+B;IAC/B,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,qCAAqC;IACrC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,IAAI;IAWP;;OAEG;IACH,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,GAAG,OAAO,GAC5B,IAAI;IASP;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAQ7C;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAQ5C;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAQ/C;;OAEG;IACH,kBAAkB,CAChB,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GACtD,IAAI;IAQP;;;OAGG;IACH,KAAK,IAAI,SAAS,WAAW,EAAE;IAM/B;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAK;IAE1B,cAAc,IAAI,IAAI;IAItB,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,OAAO,CAAC,OAAO;CAwBhB"}

package/dist/semantic/builder.js

@@ -0,0 +1,140 @@
+// ---------------------------------------------------------------------------
+// Semantic Event Builder
+// ---------------------------------------------------------------------------
+//
+// Accumulates parser events and manages the event queue.
+// Events are emitted monotonically with increasing sequence numbers.
+// drainEvents() returns pending events and clears the queue.
+// ---------------------------------------------------------------------------
+/**
+ * Manages the monotonic event queue.
+ * Events are never retracted once emitted.
+ */
+export class EventBuilder {
+    queue = [];
+    sequence = 0;
+    maxQueued;
+    terminal = false;
+    constructor(maxQueuedEvents) {
+        this.maxQueued = maxQueuedEvents;
+    }
+    /** Current sequence number. */
+    get currentSequence() {
+        return this.sequence;
+    }
+    get isTerminal() {
+        return this.terminal;
+    }
+    /** Number of events in the queue. */
+    get queueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Emit a value_committed event.
+     */
+    emitValueCommitted(path, value, byteRange) {
+        this.enqueue({
+            type: "value_committed",
+            sequence: this.sequence++,
+            path,
+            operation: "add",
+            value,
+            byteRange,
+        });
+    }
+    /**
+     * Emit a container_closed event.
+     */
+    emitContainerClosed(path, container) {
+        this.enqueue({
+            type: "container_closed",
+            sequence: this.sequence++,
+            path,
+            container,
+        });
+    }
+    /**
+     * Emit a repair_applied event.
+     */
+    emitRepairApplied(repair) {
+        this.enqueue({
+            type: "repair_applied",
+            sequence: this.sequence++,
+            repair,
+        });
+    }
+    /**
+     * Emit a diagnostic event.
+     */
+    emitDiagnostic(diagnostic) {
+        this.enqueue({
+            type: "diagnostic",
+            sequence: this.sequence++,
+            diagnostic,
+        });
+    }
+    /**
+     * Emit a document_complete event.
+     */
+    emitDocumentComplete(executable) {
+        this.enqueue({
+            type: "document_complete",
+            sequence: this.sequence++,
+            executable,
+        });
+    }
+    /**
+     * Emit a stream_finished event.
+     */
+    emitStreamFinished(outcome) {
+        this.enqueue({
+            type: "stream_finished",
+            sequence: this.sequence++,
+            outcome,
+        });
+    }
+    /**
+     * Drain all pending events and clear the queue.
+     * Returns a frozen array.
+     */
+    drain() {
+        const events = this.queue;
+        this.queue = [];
+        return Object.freeze(events);
+    }
+    /**
+     * Get the number of events emitted during the current push cycle.
+     * Call resetPushCount() before push processing.
+     */
+    pushEmitCount = 0;
+    resetPushCount() {
+        this.pushEmitCount = 0;
+    }
+    get emittedDuringPush() {
+        return this.pushEmitCount;
+    }
+    enqueue(event) {
+        if (this.terminal)
+            return; // Stop accepting semantic progress, don't report as emitted
+        if (this.queue.length >= this.maxQueued) {
+            this.terminal = true;
+            // Emit terminal diagnostic if capacity theoretically permitted (i.e. we just push one more)
+            this.queue.push({
+                type: "diagnostic",
+                sequence: this.sequence++,
+                diagnostic: {
+                    code: "E_LIMIT_EVENT_QUEUE",
+                    severity: "fatal",
+                    byteOffset: 0, // Event builder doesn't track exact byte offset
+                    recoverable: false,
+                    message: "Event queue capacity exceeded",
+                }
+            });
+            this.pushEmitCount++;
+            return;
+        }
+        this.queue.push(event);
+        this.pushEmitCount++;
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/semantic/builder.js.map

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

package/dist/semantic/events.d.ts

@@ -0,0 +1,2 @@
+export type { ParserEvent, ValueCommittedEvent, ContainerClosedEvent, RepairAppliedEvent, DiagnosticEvent, DocumentCompleteEvent, StreamFinishedEvent, } from "../types.js";
+//# sourceMappingURL=events.d.ts.map

package/dist/semantic/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/semantic/events.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/semantic/events.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Semantic event types — re-exported for convenience
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=events.js.map

package/dist/semantic/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/semantic/events.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E"}

package/dist/semantic/snapshot.d.ts

@@ -0,0 +1,49 @@
+import type { JsonValue, ParserEvent } from "../types.js";
+import type { GrammarFrame } from "../grammar/frame.js";
+/**
+ * Maintains the stable value by processing committed events.
+ * Only committed values appear in the stable value.
+ */
+export declare class SnapshotBuilder {
+    private root;
+    private hasRoot;
+    /**
+     * Maps each open container's grammar frame to its corresponding node in
+     * the stable-value tree, so a newly-opened child container can attach
+     * directly to its parent in O(1) via initContainerForFrame() instead of
+     * re-parsing a JSON Pointer path string and re-walking from the root on
+     * every single container open (see initContainerForFrame).
+     */
+    private frameNodes;
+    /**
+     * Process a value_committed event and integrate it into the stable value.
+     */
+    processEvent(event: ParserEvent): void;
+    /**
+     * Initialize the root as an object container.
+     * `frame` is registered so child containers can find it in O(1).
+     */
+    initRootObject(frame?: GrammarFrame): void;
+    /**
+     * Initialize the root as an array container.
+     * `frame` is registered so child containers can find it in O(1).
+     */
+    initRootArray(frame?: GrammarFrame): void;
+    /**
+     * Initialize a nested container for the given (already-pushed) grammar
+     * frame, attaching it directly to its parent's node.
+     *
+     * Uses frame._parent/_segment (see grammar/frame.ts) plus the frameNodes
+     * map instead of re-parsing frame.path and walking the tree from the
+     * root on every call — that walk is O(depth), and calling it once for
+     * every one of N nested containers made opening N levels cost O(N^2)
+     * total, independent of the grammar-stack path-string fix.
+     */
+    initContainerForFrame(frame: GrammarFrame, type: "object" | "array"): void;
+    /**
+     * Get a deep clone of the current stable value.
+     */
+    getStableValue(): JsonValue | undefined;
+    get hasRootValue(): boolean;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/semantic/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/semantic/snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAyB,WAAW,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,CAA0C;IAE5D;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA+CtC;;;OAGG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAQ1C;;;OAGG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAQzC;;;;;;;;;OASG;IACH,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI;IA2B1E;;OAEG;IACH,cAAc,IAAI,SAAS,GAAG,SAAS;IAKvC,IAAI,YAAY,IAAI,OAAO,CAE1B;CACF"}