prefix-safe-json 0.0.1-alpha.0

package/dist/coordinator/coordinator.js

@@ -0,0 +1,407 @@
+import { createParser } from "../parser.js";
+import { DEFAULT_COORDINATOR_LIMITS } from "./types.js";
+class CoordinatorCallState {
+    internalId;
+    provider;
+    toolCallId;
+    toolIndex;
+    name;
+    nameComplete = false;
+    argumentStreamClosed = false;
+    parser;
+    status = "collecting";
+    constructor(internalId, provider, parser) {
+        this.internalId = internalId;
+        this.provider = provider;
+        this.parser = parser;
+    }
+}
+export class DefaultToolCallStreamCoordinator {
+    limits;
+    parserOptions;
+    calls = new Map();
+    sourceKeyToInternalId = new Map();
+    callCounter = 0;
+    eventQueue = [];
+    diagnostics = [];
+    eventsProcessed = 0;
+    globalSequence = 0;
+    isFinished = false;
+    /**
+     * @param limits Coordinator-level limits (concurrent tool calls, tool name
+     *   size, etc.) — distinct from `parserOptions`, which configures each
+     *   underlying per-call IncrementalJsonParser (limits, repairs). Previously
+     *   there was no way to pass the latter through at all; every parser the
+     *   coordinator created was hardcoded to library defaults.
+     */
+    constructor(limits, parserOptions) {
+        this.limits = { ...DEFAULT_COORDINATOR_LIMITS, ...limits };
+        this.parserOptions = parserOptions;
+    }
+    push(event) {
+        if (this.isFinished) {
+            this.addDiagnostic({
+                code: "E_EVENT_AFTER_STREAM_END",
+                severity: "error",
+                message: "Event pushed after stream end",
+            });
+            return { accepted: false };
+        }
+        if (this.eventsProcessed >= this.limits.maxNormalizedEvents) {
+            this.addDiagnostic({
+                code: "E_COORDINATOR_LIMIT_EVENTS",
+                severity: "fatal",
+                message: "Maximum normalized events exceeded",
+            });
+            return { accepted: false };
+        }
+        this.eventsProcessed++;
+        switch (event.type) {
+            case "tool_call_start":
+                this.handleStart(event);
+                break;
+            case "tool_call_identity":
+                this.handleIdentity(event);
+                break;
+            case "tool_call_name_delta":
+                this.handleNameDelta(event);
+                break;
+            case "tool_call_arguments_delta":
+                this.handleArgumentsDelta(event);
+                break;
+            case "tool_call_end":
+                this.handleCallEnd(event);
+                break;
+            case "provider_diagnostic":
+                this.handleProviderDiagnostic(event);
+                break;
+            case "provider_stream_end":
+                this.handleStreamEnd(event);
+                break;
+        }
+        return { accepted: true };
+    }
+    handleStart(event) {
+        const sourceKey = event.callRef.sourceKey;
+        const existingId = this.sourceKeyToInternalId.get(sourceKey);
+        if (existingId !== undefined) {
+            this.addDiagnostic({
+                code: "E_DUPLICATE_TOOL_CALL_START",
+                severity: "error",
+                internalId: existingId,
+                message: `Duplicate start for tool call sourceKey: ${sourceKey}`,
+            });
+            return;
+        }
+        if (this.calls.size >= this.limits.maxToolCalls) {
+            this.addDiagnostic({
+                code: "E_COORDINATOR_LIMIT_CALLS",
+                severity: "error",
+                message: "Maximum tool calls exceeded",
+            });
+            return;
+        }
+        const internalId = `call-${this.callCounter++}`;
+        this.sourceKeyToInternalId.set(sourceKey, internalId);
+        const parser = createParser(this.parserOptions);
+        const call = new CoordinatorCallState(internalId, event.provider, parser);
+        if (event.toolCallId !== undefined)
+            call.toolCallId = event.toolCallId;
+        if (event.toolIndex !== undefined)
+            call.toolIndex = event.toolIndex;
+        if (event.name !== undefined)
+            call.name = event.name;
+        this.calls.set(internalId, call);
+        this.eventQueue.push({
+            type: "tool_call_discovered",
+            sequence: this.globalSequence++,
+            internalId,
+            provider: event.provider,
+        });
+        if (event.toolCallId !== undefined || event.toolIndex !== undefined) {
+            this.eventQueue.push({
+                type: "tool_call_identity_updated",
+                sequence: this.globalSequence++,
+                internalId,
+                toolCallId: event.toolCallId,
+                toolIndex: event.toolIndex,
+            });
+        }
+    }
+    handleIdentity(event) {
+        const internalId = this.sourceKeyToInternalId.get(event.callRef.sourceKey);
+        if (!internalId)
+            return;
+        const call = this.getCall(internalId);
+        if (!call)
+            return;
+        let changed = false;
+        if (event.toolCallId !== undefined) {
+            if (call.toolCallId !== undefined && call.toolCallId !== event.toolCallId) {
+                this.addDiagnostic({
+                    code: "E_PROVIDER_IDENTITY_CONFLICT",
+                    severity: "error",
+                    internalId: call.internalId,
+                    message: `Conflicting ID: had ${call.toolCallId}, got ${event.toolCallId}`,
+                });
+                call.status = "invalid";
+            }
+            else if (call.toolCallId === undefined) {
+                call.toolCallId = event.toolCallId;
+                changed = true;
+            }
+        }
+        if (event.toolIndex !== undefined) {
+            if (call.toolIndex !== undefined && call.toolIndex !== event.toolIndex) {
+                this.addDiagnostic({
+                    code: "E_PROVIDER_INDEX_CONFLICT",
+                    severity: "error",
+                    internalId: call.internalId,
+                    message: `Conflicting index: had ${call.toolIndex}, got ${event.toolIndex}`,
+                });
+                call.status = "invalid";
+            }
+            else if (call.toolIndex === undefined) {
+                call.toolIndex = event.toolIndex;
+                changed = true;
+            }
+        }
+        if (changed) {
+            this.eventQueue.push({
+                type: "tool_call_identity_updated",
+                sequence: this.globalSequence++,
+                internalId: call.internalId,
+                toolCallId: call.toolCallId,
+                toolIndex: call.toolIndex,
+            });
+        }
+    }
+    handleNameDelta(event) {
+        const internalId = this.sourceKeyToInternalId.get(event.callRef.sourceKey);
+        if (!internalId)
+            return;
+        const call = this.getCall(internalId);
+        if (!call)
+            return;
+        if (call.status !== "collecting") {
+            this.addDiagnostic({
+                code: "E_NAME_DELTA_AFTER_END",
+                severity: "error",
+                internalId: call.internalId,
+                message: "Name delta after call ended",
+            });
+            return;
+        }
+        call.name = (call.name ?? "") + event.delta;
+        if (call.name.length > this.limits.maxToolNameBytes) {
+            this.addDiagnostic({
+                code: "E_TOOL_NAME_LIMIT",
+                severity: "error",
+                internalId: call.internalId,
+                message: "Tool name exceeded maximum length",
+            });
+            call.status = "invalid";
+        }
+        this.eventQueue.push({
+            type: "tool_name_updated",
+            sequence: event.sequence,
+            internalId: call.internalId,
+            name: call.name,
+            complete: false,
+        });
+    }
+    handleArgumentsDelta(event) {
+        const internalId = this.sourceKeyToInternalId.get(event.callRef.sourceKey);
+        if (!internalId)
+            return;
+        const call = this.getCall(internalId);
+        if (!call)
+            return;
+        if (call.status !== "collecting") {
+            this.addDiagnostic({
+                code: "E_ARGUMENT_DELTA_AFTER_END",
+                severity: "error",
+                internalId: call.internalId,
+                message: "Argument delta after call ended",
+            });
+            return;
+        }
+        call.parser.push(event.delta);
+        // Drain parser events and map them to coordinator events
+        const parserEvents = call.parser.drainEvents();
+        for (const pe of parserEvents) {
+            this.eventQueue.push({
+                type: "tool_argument_event",
+                sequence: this.globalSequence++,
+                internalId: call.internalId,
+                event: pe,
+            });
+        }
+    }
+    handleCallEnd(event) {
+        const internalId = this.sourceKeyToInternalId.get(event.callRef.sourceKey);
+        if (!internalId)
+            return;
+        const call = this.getCall(internalId);
+        if (!call)
+            return;
+        if (call.status !== "collecting")
+            return;
+        call.nameComplete = true;
+        call.argumentStreamClosed = true;
+        if (call.name !== undefined) {
+            this.eventQueue.push({
+                type: "tool_name_updated",
+                sequence: this.globalSequence++,
+                internalId: call.internalId,
+                name: call.name,
+                complete: true,
+            });
+        }
+        else {
+            this.addDiagnostic({
+                code: "E_TOOL_NAME_MISSING",
+                severity: "error",
+                internalId: call.internalId,
+                message: "Tool name missing at end",
+            });
+        }
+    }
+    finishCall(call, reason) {
+        if (call.status !== "collecting")
+            return;
+        // For individual call end, we pass reason to the internal parser
+        const res = call.parser.finish({ reason });
+        // Determine the mapped coordinator outcome
+        let outcome = "invalid";
+        if (res.outcome === "valid") {
+            outcome = "complete";
+            if (call.name === undefined || this.hasCallConflict(call)) {
+                outcome = "invalid";
+            }
+        }
+        else if (res.outcome === "truncated") {
+            outcome = "truncated";
+        }
+        else if (res.outcome === "salvaged") {
+            outcome = "salvaged";
+        }
+        if (reason === "cancelled")
+            outcome = "cancelled";
+        call.status = outcome;
+        // Drain remaining parser events
+        const parserEvents = call.parser.drainEvents();
+        for (const pe of parserEvents) {
+            this.eventQueue.push({
+                type: "tool_argument_event",
+                sequence: this.globalSequence++,
+                internalId: call.internalId,
+                event: pe,
+            });
+        }
+        // Determine executable according to Executable Policy
+        const executable = outcome === "complete" && res.executable;
+        this.eventQueue.push({
+            type: "tool_call_finished",
+            sequence: this.globalSequence++,
+            internalId: call.internalId,
+            outcome,
+            executable,
+        });
+    }
+    hasCallConflict(call) {
+        return this.diagnostics.some(d => d.internalId === call.internalId && (d.severity === "error" || d.severity === "fatal"));
+    }
+    handleProviderDiagnostic(event) {
+        const internalId = event.callRef ? this.sourceKeyToInternalId.get(event.callRef.sourceKey) : undefined;
+        this.addDiagnostic({
+            code: event.code,
+            severity: event.severity,
+            message: event.message,
+            internalId,
+        });
+    }
+    handleStreamEnd(event) {
+        this.isFinished = true;
+        // Close all open calls
+        for (const call of this.calls.values()) {
+            if (call.status === "collecting") {
+                if (!call.argumentStreamClosed) {
+                    this.addDiagnostic({
+                        code: "E_STREAM_ENDED_WITH_OPEN_CALL",
+                        severity: "error",
+                        internalId: call.internalId,
+                        message: "Stream ended with open call",
+                    });
+                }
+                this.finishCall(call, event.reason);
+            }
+        }
+        this.eventQueue.push({
+            type: "provider_stream_finished",
+            sequence: this.globalSequence++,
+            reason: event.reason,
+        });
+    }
+    getCall(internalId) {
+        const call = this.calls.get(internalId);
+        if (!call) {
+            this.addDiagnostic({
+                code: "E_TOOL_CALL_NOT_FOUND",
+                severity: "error",
+                internalId,
+                message: `Tool call ${internalId} not found`,
+            });
+            return undefined;
+        }
+        return call;
+    }
+    addDiagnostic(diag) {
+        this.diagnostics.push(diag);
+        this.eventQueue.push({
+            type: "coordinator_diagnostic",
+            sequence: this.globalSequence++,
+            diagnostic: diag,
+        });
+    }
+    snapshot() {
+        return {
+            calls: Array.from(this.calls.values()).map((c) => ({
+                internalId: c.internalId,
+                provider: c.provider,
+                toolCallId: c.toolCallId,
+                toolIndex: c.toolIndex,
+                name: c.name,
+                nameComplete: c.nameComplete,
+                parser: c.parser.snapshot(),
+                status: c.status,
+            })),
+            diagnostics: [...this.diagnostics],
+            eventsProcessed: this.eventsProcessed,
+            isFinished: this.isFinished,
+        };
+    }
+    drainEvents() {
+        const events = this.eventQueue;
+        this.eventQueue = [];
+        return events;
+    }
+    finish(meta) {
+        if (!this.isFinished) {
+            this.handleStreamEnd({
+                type: "provider_stream_end",
+                sequence: this.eventsProcessed + 1,
+                provider: "unknown",
+                reason: meta?.reason ?? "unknown",
+                providerReason: meta?.providerReason,
+            });
+        }
+        return {
+            calls: this.snapshot().calls,
+        };
+    }
+}
+export function createToolCallStreamCoordinator(limits, parserOptions) {
+    return new DefaultToolCallStreamCoordinator(limits, parserOptions);
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/coordinator/coordinator.js.map

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

package/dist/coordinator/protocol.d.ts

@@ -0,0 +1,61 @@
+export type ProviderName = "openai" | "anthropic" | "gemini" | "openrouter" | "openai-compatible" | "unknown";
+export interface NormalizedEventBase {
+    /**
+     * Deterministic sequence number assigned by the stream coordinator.
+     */
+    readonly sequence: number;
+    readonly provider: ProviderName;
+    readonly rawEventType?: string;
+    readonly providerRequestId?: string;
+}
+export type NormalizedToolStreamEvent = ToolCallStartEvent | ToolCallIdentityEvent | ToolCallNameDeltaEvent | ToolCallArgumentsDeltaEvent | ToolCallEndEvent | ProviderDiagnosticEvent | ProviderStreamEndEvent;
+export interface ToolCallStartEvent extends NormalizedEventBase {
+    readonly type: "tool_call_start";
+    readonly callRef: ProviderCallRef;
+    readonly toolCallId?: string;
+    readonly toolIndex?: number;
+    readonly name?: string;
+}
+export interface ToolCallIdentityEvent extends NormalizedEventBase {
+    readonly type: "tool_call_identity";
+    readonly callRef: ProviderCallRef;
+    readonly toolCallId?: string;
+    readonly toolIndex?: number;
+}
+export interface ToolCallNameDeltaEvent extends NormalizedEventBase {
+    readonly type: "tool_call_name_delta";
+    readonly callRef: ProviderCallRef;
+    readonly delta: string;
+}
+export interface ToolCallArgumentsDeltaEvent extends NormalizedEventBase {
+    readonly type: "tool_call_arguments_delta";
+    readonly callRef: ProviderCallRef;
+    readonly delta: string | Uint8Array;
+}
+export type StreamEndReason = "complete" | "length" | "cancelled" | "provider_error" | "network_error" | "unknown";
+export interface ToolCallEndEvent extends NormalizedEventBase {
+    readonly type: "tool_call_end";
+    readonly callRef: ProviderCallRef;
+    readonly reason: StreamEndReason;
+    readonly providerReason?: string;
+}
+export interface ProviderDiagnosticEvent extends NormalizedEventBase {
+    readonly type: "provider_diagnostic";
+    readonly code: string;
+    readonly severity: "info" | "warning" | "error" | "fatal";
+    readonly message: string;
+    readonly callRef?: ProviderCallRef;
+}
+export interface ProviderStreamEndEvent extends NormalizedEventBase {
+    readonly type: "provider_stream_end";
+    readonly reason: StreamEndReason;
+    readonly providerReason?: string;
+}
+export interface ProviderCallRef {
+    /**
+     * Deterministic provider-local identity.
+     * e.g. "content-block:0"
+     */
+    readonly sourceKey: string;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/coordinator/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/coordinator/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,mBAAmB,GACnB,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,MAAM,yBAAyB,GACjC,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,2BAA2B,GAC3B,gBAAgB,GAChB,uBAAuB,GACvB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;CACrC;AAED,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,QAAQ,GACR,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/coordinator/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/coordinator/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/coordinator/protocol.ts"],"names":[],"mappings":""}

package/dist/coordinator/types.d.ts

@@ -0,0 +1,84 @@
+import { ParserSnapshot, ParserEvent } from "../types.js";
+import { NormalizedToolStreamEvent, ProviderName, StreamEndReason } from "./protocol.js";
+export interface CoordinatorLimits {
+    readonly maxToolCalls: number;
+    readonly maxToolNameBytes: number;
+    readonly maxTrailingDataBytes: number;
+    readonly maxNormalizedEvents: number;
+}
+export declare const DEFAULT_COORDINATOR_LIMITS: CoordinatorLimits;
+export interface ToolCallState {
+    readonly internalId: string;
+    readonly provider: ProviderName;
+    readonly toolCallId?: string;
+    readonly toolIndex?: number;
+    readonly name?: string;
+    readonly nameComplete: boolean;
+    readonly parser: ParserSnapshot;
+    readonly status: "collecting" | "complete" | "truncated" | "salvaged" | "invalid" | "cancelled";
+}
+export interface ToolCallCoordinatorSnapshot {
+    readonly calls: readonly ToolCallState[];
+    readonly diagnostics: readonly CoordinatorDiagnostic[];
+    readonly eventsProcessed: number;
+    readonly isFinished: boolean;
+}
+export type ToolCallCoordinatorEvent = {
+    readonly type: "tool_call_discovered";
+    readonly sequence: number;
+    readonly internalId: string;
+    readonly provider: ProviderName;
+} | {
+    readonly type: "tool_call_identity_updated";
+    readonly sequence: number;
+    readonly internalId: string;
+    readonly toolCallId?: string;
+    readonly toolIndex?: number;
+} | {
+    readonly type: "tool_name_updated";
+    readonly sequence: number;
+    readonly internalId: string;
+    readonly name: string;
+    readonly complete: boolean;
+} | {
+    readonly type: "tool_argument_event";
+    readonly sequence: number;
+    readonly internalId: string;
+    readonly event: ParserEvent;
+} | {
+    readonly type: "tool_call_finished";
+    readonly sequence: number;
+    readonly internalId: string;
+    readonly outcome: "complete" | "truncated" | "salvaged" | "invalid" | "cancelled";
+    readonly executable: boolean;
+} | {
+    readonly type: "coordinator_diagnostic";
+    readonly sequence: number;
+    readonly diagnostic: CoordinatorDiagnostic;
+} | {
+    readonly type: "provider_stream_finished";
+    readonly sequence: number;
+    readonly reason: StreamEndReason;
+};
+export interface CoordinatorDiagnostic {
+    readonly code: string;
+    readonly severity: "info" | "warning" | "error" | "fatal";
+    readonly message: string;
+    readonly internalId?: string;
+}
+export interface CoordinatorPushResult {
+    readonly accepted: boolean;
+}
+export interface ToolCallCoordinatorFinalResult {
+    readonly calls: readonly ToolCallState[];
+}
+export interface ToolCallStreamCoordinator {
+    push(event: NormalizedToolStreamEvent): CoordinatorPushResult;
+    snapshot(): ToolCallCoordinatorSnapshot;
+    drainEvents(): readonly ToolCallCoordinatorEvent[];
+    finish(meta?: {
+        reason?: StreamEndReason;
+        providerReason?: string;
+    }): ToolCallCoordinatorFinalResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/coordinator/types.d.ts.map

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

package/dist/coordinator/types.js

@@ -0,0 +1,7 @@
+export const DEFAULT_COORDINATOR_LIMITS = {
+    maxToolCalls: 128,
+    maxToolNameBytes: 1024,
+    maxTrailingDataBytes: 65536,
+    maxNormalizedEvents: 100000,
+};
+//# sourceMappingURL=types.js.map

package/dist/coordinator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/coordinator/types.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D,YAAY,EAAE,GAAG;IACjB,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,MAAM;CAC5B,CAAC"}

package/dist/diagnostics/codes.d.ts

@@ -0,0 +1,24 @@
+/** All known diagnostic codes. */
+export declare const DiagnosticCode: {
+    readonly E_UNEXPECTED_TOKEN: "E_UNEXPECTED_TOKEN";
+    readonly E_DUPLICATE_KEY: "E_DUPLICATE_KEY";
+    readonly E_INCOMPLETE_UTF8: "E_INCOMPLETE_UTF8";
+    readonly E_INVALID_UTF8: "E_INVALID_UTF8";
+    readonly E_INCOMPLETE_UNICODE_ESCAPE: "E_INCOMPLETE_UNICODE_ESCAPE";
+    readonly E_INVALID_UNICODE_ESCAPE: "E_INVALID_UNICODE_ESCAPE";
+    readonly E_UNPAIRED_SURROGATE: "E_UNPAIRED_SURROGATE";
+    readonly E_UNTERMINATED_STRING: "E_UNTERMINATED_STRING";
+    readonly E_INCOMPLETE_NUMBER: "E_INCOMPLETE_NUMBER";
+    readonly E_INCOMPLETE_LITERAL: "E_INCOMPLETE_LITERAL";
+    readonly E_TRAILING_DATA: "E_TRAILING_DATA";
+    readonly E_STREAM_TRUNCATED: "E_STREAM_TRUNCATED";
+    readonly E_LIMIT_DEPTH: "E_LIMIT_DEPTH";
+    readonly E_LIMIT_INPUT_BYTES: "E_LIMIT_INPUT_BYTES";
+    readonly E_LIMIT_STRING_BYTES: "E_LIMIT_STRING_BYTES";
+    readonly E_LIMIT_EVENT_QUEUE: "E_LIMIT_EVENT_QUEUE";
+    readonly E_PUSH_AFTER_FINISH: "E_PUSH_AFTER_FINISH";
+    readonly W_RAW_CONTROL_CHARACTER: "W_RAW_CONTROL_CHARACTER";
+    readonly W_TRAILING_TEXT_ISOLATED: "W_TRAILING_TEXT_ISOLATED";
+};
+export type DiagnosticCodeValue = (typeof DiagnosticCode)[keyof typeof DiagnosticCode];
+//# sourceMappingURL=codes.d.ts.map

package/dist/diagnostics/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/diagnostics/codes.ts"],"names":[],"mappings":"AAIA,kCAAkC;AAClC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/dist/diagnostics/codes.js

@@ -0,0 +1,28 @@
+// ---------------------------------------------------------------------------
+// Diagnostic codes
+// ---------------------------------------------------------------------------
+/** All known diagnostic codes. */
+export const DiagnosticCode = {
+    // --- Errors ---
+    E_UNEXPECTED_TOKEN: "E_UNEXPECTED_TOKEN",
+    E_DUPLICATE_KEY: "E_DUPLICATE_KEY",
+    E_INCOMPLETE_UTF8: "E_INCOMPLETE_UTF8",
+    E_INVALID_UTF8: "E_INVALID_UTF8",
+    E_INCOMPLETE_UNICODE_ESCAPE: "E_INCOMPLETE_UNICODE_ESCAPE",
+    E_INVALID_UNICODE_ESCAPE: "E_INVALID_UNICODE_ESCAPE",
+    E_UNPAIRED_SURROGATE: "E_UNPAIRED_SURROGATE",
+    E_UNTERMINATED_STRING: "E_UNTERMINATED_STRING",
+    E_INCOMPLETE_NUMBER: "E_INCOMPLETE_NUMBER",
+    E_INCOMPLETE_LITERAL: "E_INCOMPLETE_LITERAL",
+    E_TRAILING_DATA: "E_TRAILING_DATA",
+    E_STREAM_TRUNCATED: "E_STREAM_TRUNCATED",
+    E_LIMIT_DEPTH: "E_LIMIT_DEPTH",
+    E_LIMIT_INPUT_BYTES: "E_LIMIT_INPUT_BYTES",
+    E_LIMIT_STRING_BYTES: "E_LIMIT_STRING_BYTES",
+    E_LIMIT_EVENT_QUEUE: "E_LIMIT_EVENT_QUEUE",
+    E_PUSH_AFTER_FINISH: "E_PUSH_AFTER_FINISH",
+    // --- Warnings ---
+    W_RAW_CONTROL_CHARACTER: "W_RAW_CONTROL_CHARACTER",
+    W_TRAILING_TEXT_ISOLATED: "W_TRAILING_TEXT_ISOLATED",
+};
+//# sourceMappingURL=codes.js.map

package/dist/diagnostics/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/diagnostics/codes.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,iBAAiB;IACjB,kBAAkB,EAAE,oBAAoB;IACxC,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;IAChC,2BAA2B,EAAE,6BAA6B;IAC1D,wBAAwB,EAAE,0BAA0B;IACpD,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAE1C,mBAAmB;IACnB,uBAAuB,EAAE,yBAAyB;IAClD,wBAAwB,EAAE,0BAA0B;CAC5C,CAAC"}