prefix-safe-json 0.0.1-alpha.3 → 0.1.0

package/dist/coordinator/types.d.ts

@@ -1,104 +0,0 @@
-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";
-    /**
-     * Result of validating `parser.stableValue` against the JSON Schema
-     * registered for this call's tool name (see `toolSchemas` on
-     * `createToolCallStreamCoordinator`). `undefined` when no schema was
-     * registered for this tool, or the call never reached a "complete"
-     * outcome (there's nothing meaningful to validate). This is a *separate*
-     * concern from `parser.executable` — that flag means "the data is
-     * structurally complete and wasn't fabricated by truncation"; this one
-     * means "the data matches the shape the tool declared it needs." Both
-     * must hold for the coordinator's own `executable` (on the
-     * `tool_call_finished` event) to be true.
-     */
-    readonly schemaValid?: boolean;
-}
-/**
- * A JSON Schema object (draft-07, matching ajv's default). Kept as `object`
- * rather than a specific type-checked shape so callers can pass whatever
- * JSON Schema library/types they already have without a forced dependency
- * on this package's own schema typings.
- */
-export type JsonSchemaLike = object;
-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

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

package/dist/coordinator/types.js

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

package/dist/coordinator/types.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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

@@ -1,28 +0,0 @@
-// ---------------------------------------------------------------------------
-// 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

@@ -1 +0,0 @@
-{"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"}

package/dist/diagnostics/factory.d.ts

@@ -1,8 +0,0 @@
-import type { Diagnostic } from "../types.js";
-type Severity = Diagnostic["severity"];
-/**
- * Creates a Diagnostic object.
- */
-export declare function createDiagnostic(code: string, severity: Severity, byteOffset: number, message: string, recoverable: boolean, path?: string): Diagnostic;
-export {};
-//# sourceMappingURL=factory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/diagnostics/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;AAEvC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,UAAU,CAYZ"}

package/dist/diagnostics/factory.js

@@ -1,17 +0,0 @@
-/**
- * Creates a Diagnostic object.
- */
-export function createDiagnostic(code, severity, byteOffset, message, recoverable, path) {
-    const diag = {
-        code,
-        severity,
-        byteOffset,
-        message,
-        recoverable,
-    };
-    if (path !== undefined) {
-        diag.path = path;
-    }
-    return diag;
-}
-//# sourceMappingURL=factory.js.map

package/dist/diagnostics/factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/diagnostics/factory.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,QAAkB,EAClB,UAAkB,EAClB,OAAe,EACf,WAAoB,EACpB,IAAa;IAEb,MAAM,IAAI,GAAe;QACvB,IAAI;QACJ,QAAQ;QACR,UAAU;QACV,OAAO;QACP,WAAW;KACZ,CAAC;IACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/gate/decide.d.ts

@@ -1,20 +0,0 @@
-import { CoordinatorDiagnostic, ToolCallState } from "../coordinator/types.js";
-import { StreamEndReason } from "../coordinator/protocol.js";
-import { ExecuteDecision, NonExecutableDecision } from "./types.js";
-export interface DecisionContext {
-    /**
-     * The stream-level end reason - what actually happened to the underlying
-     * provider stream, not any single call's own (possibly still-"collecting")
-     * status. Stream-wide fail-closed conditions (provider_error) key off this
-     * rather than per-call state.
-     */
-    readonly streamEndReason: StreamEndReason;
-    /**
-     * The coordinator's full, unfiltered diagnostics list (`snapshot().diagnostics`).
-     * `decideExecution` splits this into per-call (`internalId` matches) and
-     * global (`internalId` undefined) subsets itself.
-     */
-    readonly diagnostics: readonly CoordinatorDiagnostic[];
-}
-export declare function decideExecution(call: ToolCallState, ctx: DecisionContext): ExecuteDecision | NonExecutableDecision;
-//# sourceMappingURL=decide.d.ts.map

package/dist/gate/decide.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/gate/decide.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAmB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACxD;AAeD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,eAAe,GACnB,eAAe,GAAG,qBAAqB,CAmHzC"}

package/dist/gate/decide.js

@@ -1,127 +0,0 @@
-// ---------------------------------------------------------------------------
-// Pure execution-decision mapping.
-//
-// Deliberately a standalone function (no coordinator/adapter dependency) so
-// the entire decision table can be unit-tested directly against hand-built
-// ToolCallState fixtures, without spinning up a full push()/finish()
-// pipeline for every row of the table.
-//
-// Priority order matters and is intentional: every fail-closed disqualifier
-// (resource limits, provider errors, content-policy terminations, schema
-// mismatches, malformed content, positively-observed truncation) is checked
-// before the single positive "execute" branch. "execute" is reached only
-// once nothing above has disqualified the call - it is the last positive
-// case, never the first check made, so a future status value that happens
-// to superficially resemble "complete" still can't skip the checks ahead of
-// it.
-// ---------------------------------------------------------------------------
-import { DiagnosticCode } from "../diagnostics/codes.js";
-import { CONTENT_FILTERED_DIAGNOSTIC_CODE } from "../coordinator/diagnostic-codes.js";
-const PARSER_RESOURCE_LIMIT_CODES = new Set([
-    DiagnosticCode.E_LIMIT_DEPTH,
-    DiagnosticCode.E_LIMIT_INPUT_BYTES,
-    DiagnosticCode.E_LIMIT_STRING_BYTES,
-    DiagnosticCode.E_LIMIT_EVENT_QUEUE,
-]);
-const COORDINATOR_RESOURCE_LIMIT_CODES = new Set([
-    "E_COORDINATOR_LIMIT_CALLS",
-    "E_COORDINATOR_LIMIT_EVENTS",
-    "E_TOOL_NAME_LIMIT",
-]);
-export function decideExecution(call, ctx) {
-    const parserDiagnostics = call.parser.diagnostics;
-    const callCoordinatorDiagnostics = ctx.diagnostics.filter((d) => d.internalId === call.internalId);
-    const globalCoordinatorDiagnostics = ctx.diagnostics.filter((d) => d.internalId === undefined);
-    const coordinatorDiagnostics = [
-        ...globalCoordinatorDiagnostics,
-        ...callCoordinatorDiagnostics,
-    ];
-    const common = {
-        internalId: call.internalId,
-        toolCallId: call.toolCallId,
-        toolIndex: call.toolIndex,
-        name: call.name,
-        stableValue: call.parser.stableValue,
-        parserDiagnostics,
-        coordinatorDiagnostics,
-    };
-    function reject(reason) {
-        return { ...common, action: "reject", executable: false, reason };
-    }
-    function retry(reason) {
-        return { ...common, action: "retry", executable: false, reason };
-    }
-    // --- Universal fail-closed checks ---------------------------------------
-    // Evaluated first and unconditionally, regardless of call.status, so a
-    // resource limit, a provider-side failure, or a content-policy
-    // termination always wins over whatever the structural status looks like.
-    const hasResourceLimit = parserDiagnostics.some((d) => PARSER_RESOURCE_LIMIT_CODES.has(d.code)) ||
-        callCoordinatorDiagnostics.some((d) => COORDINATOR_RESOURCE_LIMIT_CODES.has(d.code)) ||
-        globalCoordinatorDiagnostics.some((d) => d.code === "E_COORDINATOR_LIMIT_EVENTS");
-    if (hasResourceLimit) {
-        return reject("resource_limit");
-    }
-    if (ctx.streamEndReason === "provider_error") {
-        return reject("provider_error");
-    }
-    const isContentFiltered = globalCoordinatorDiagnostics.some((d) => d.code === CONTENT_FILTERED_DIAGNOSTIC_CODE);
-    if (isContentFiltered) {
-        return reject("content_filtered");
-    }
-    // --- Status-specific handling --------------------------------------------
-    // Exhaustive over ToolCallState["status"] with no `default`: if a future
-    // coordinator version adds a new status literal without a matching case
-    // here, `noImplicitReturns` fails the build - not a silent runtime gap.
-    switch (call.status) {
-        case "complete": {
-            if (call.schemaValid === false) {
-                return reject("schema_invalid");
-            }
-            // The ONLY positive branch in this entire function, reached only
-            // after every disqualifying check above has already passed. The
-            // `call.name !== undefined` check is defensive/redundant with the
-            // coordinator's own invariant (a call only reaches status "complete"
-            // when its name is known) - narrowing on it here is what lets
-            // `ExecuteDecision.name` be typed as a required `string` instead of
-            // `string | undefined`, so it never needs re-checking at every call
-            // site. If the invariant were ever violated, this still fails closed
-            // to "stream_incomplete" rather than fabricating a name.
-            if (call.parser.executable === true &&
-                call.parser.stableValue !== undefined &&
-                call.name !== undefined) {
-                const decision = {
-                    ...common,
-                    name: call.name,
-                    action: "execute",
-                    executable: true,
-                    reason: "complete",
-                    value: call.parser.stableValue,
-                };
-                return decision;
-            }
-            // Root closed, syntactically valid, but not trusted: the parser's
-            // own executable contract failed it (stream-end-reason mismatch or
-            // trailing data), even though nothing here required a repair.
-            return retry("stream_incomplete");
-        }
-        case "truncated":
-            // The parser positively observed an open string/number/literal or an
-            // unclosed container - a real, raw mid-value cut, not a matter of
-            // interpretation.
-            return retry("truncated");
-        case "invalid":
-            // Duplicate key, unexpected token, or a missing/conflicting tool
-            // identity - a genuine content defect, independent of how the stream
-            // ended.
-            return reject("malformed");
-        case "salvaged":
-            // Root only closed via a safe-container-closing repair; the JSON
-            // *looks* complete, but provider metadata never confirmed genuine
-            // completion. This is the container-level truncation case.
-            return retry("stream_incomplete");
-        case "cancelled":
-        case "collecting":
-            return retry("stream_incomplete");
-    }
-}
-//# sourceMappingURL=decide.js.map

package/dist/gate/decide.js.map

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

package/dist/gate/gate.d.ts

@@ -1,25 +0,0 @@
-import { CoordinatorLimits, JsonSchemaLike } from "../coordinator/types.js";
-import { ParserOptions } from "../types.js";
-import { ToolCallExecutionGate } from "./types.js";
-/**
- * Creates a fail-closed execution-decision gate for streamed LLM tool calls.
- * Wraps a `ToolCallStreamCoordinator` (same constructor arguments) and adds
- * exactly one operation: turn each call's settled state into an
- * `ExecutionDecision` (`execute` / `retry` / `reject`) via a deterministic,
- * fully-typed decision table. See `docs/EXECUTION_GATE.md`.
- *
- * ```ts
- * const gate = createToolCallExecutionGate(undefined, undefined, {
- *   write_file: { type: "object", required: ["path", "content"], properties: {
- *     path: { type: "string" }, content: { type: "string" } } },
- * });
- * for (const raw of providerEvents) {
- *   for (const normalized of adapter.push(raw)) gate.push(normalized);
- * }
- * for (const decision of gate.finish().decisions) {
- *   if (decision.action === "execute") await tools[decision.name](decision.value);
- * }
- * ```
- */
-export declare function createToolCallExecutionGate(limits?: Partial<CoordinatorLimits>, parserOptions?: ParserOptions, toolSchemas?: Record<string, JsonSchemaLike>): ToolCallExecutionGate;
-//# sourceMappingURL=gate.d.ts.map

package/dist/gate/gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/gate/gate.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,iBAAiB,EAEjB,cAAc,EAGf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAEL,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AA+DpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,aAAa,CAAC,EAAE,aAAa,EAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAC3C,qBAAqB,CAEvB"}

package/dist/gate/gate.js

@@ -1,80 +0,0 @@
-// ---------------------------------------------------------------------------
-// ToolCallExecutionGate — high-level execution safety layer.
-//
-// Built by composition over ToolCallStreamCoordinator, not by extending or
-// reimplementing it: the gate holds a coordinator instance and adds exactly
-// one thing coordinator state doesn't already capture - which stream-end
-// reason actually got applied - then maps every ToolCallState through the
-// pure decideExecution() table. No re-parsing, no duplicate event pipeline.
-// ---------------------------------------------------------------------------
-import { createToolCallStreamCoordinator } from "../coordinator/coordinator.js";
-import { decideExecution } from "./decide.js";
-class DefaultToolCallExecutionGate {
-    coordinator;
-    // Mirrors the coordinator's own "first provider_stream_end (from push(),
-    // or from finish()'s meta if none arrived) wins" rule - see push()/finish()
-    // below and DefaultToolCallStreamCoordinator.finish()'s matching
-    // `if (!this.isFinished)` guard.
-    streamEndReason;
-    streamEndCaptured = false;
-    constructor(limits, parserOptions, toolSchemas) {
-        this.coordinator = createToolCallStreamCoordinator(limits, parserOptions, toolSchemas);
-    }
-    push(event) {
-        if (event.type === "provider_stream_end" && !this.streamEndCaptured) {
-            this.streamEndCaptured = true;
-            this.streamEndReason = event.reason;
-        }
-        return this.coordinator.push(event);
-    }
-    snapshot() {
-        const snap = this.coordinator.snapshot();
-        const ctx = {
-            // Pre-finish, no stream-end reason has been observed yet ("unknown"
-            // is a neutral placeholder here, not a claim anything went wrong) -
-            // every in-flight call is still "collecting" regardless, so this
-            // never influences whether something looks executable.
-            streamEndReason: this.streamEndReason ?? "unknown",
-            diagnostics: snap.diagnostics,
-        };
-        return snap.calls.map((call) => decideExecution(call, ctx));
-    }
-    drainEvents() {
-        return this.coordinator.drainEvents();
-    }
-    finish(meta) {
-        if (!this.streamEndCaptured) {
-            this.streamEndCaptured = true;
-            this.streamEndReason = meta?.reason ?? "unknown";
-        }
-        const result = this.coordinator.finish(meta);
-        const diagnostics = this.coordinator.snapshot().diagnostics;
-        const ctx = { streamEndReason: this.streamEndReason ?? "unknown", diagnostics };
-        const decisions = result.calls.map((call) => decideExecution(call, ctx));
-        return { decisions, diagnostics };
-    }
-}
-/**
- * Creates a fail-closed execution-decision gate for streamed LLM tool calls.
- * Wraps a `ToolCallStreamCoordinator` (same constructor arguments) and adds
- * exactly one operation: turn each call's settled state into an
- * `ExecutionDecision` (`execute` / `retry` / `reject`) via a deterministic,
- * fully-typed decision table. See `docs/EXECUTION_GATE.md`.
- *
- * ```ts
- * const gate = createToolCallExecutionGate(undefined, undefined, {
- *   write_file: { type: "object", required: ["path", "content"], properties: {
- *     path: { type: "string" }, content: { type: "string" } } },
- * });
- * for (const raw of providerEvents) {
- *   for (const normalized of adapter.push(raw)) gate.push(normalized);
- * }
- * for (const decision of gate.finish().decisions) {
- *   if (decision.action === "execute") await tools[decision.name](decision.value);
- * }
- * ```
- */
-export function createToolCallExecutionGate(limits, parserOptions, toolSchemas) {
-    return new DefaultToolCallExecutionGate(limits, parserOptions, toolSchemas);
-}
-//# sourceMappingURL=gate.js.map

package/dist/gate/gate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/gate/gate.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6DAA6D;AAC7D,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAE9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAUhF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,MAAM,4BAA4B;IACf,WAAW,CAA4B;IAExD,yEAAyE;IACzE,4EAA4E;IAC5E,iEAAiE;IACjE,iCAAiC;IACzB,eAAe,CAA8B;IAC7C,iBAAiB,GAAG,KAAK,CAAC;IAElC,YACE,MAAmC,EACnC,aAA6B,EAC7B,WAA4C;QAE5C,IAAI,CAAC,WAAW,GAAG,+BAA+B,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,CAAC,KAAgC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAC9B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QACN,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG;YACV,oEAAoE;YACpE,oEAAoE;YACpE,iEAAiE;YACjE,uDAAuD;YACvD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS;YAClD,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,IAGN;QACC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAC9B,IAAI,CAAC,eAAe,GAAG,IAAI,EAAE,MAAM,IAAI,SAAS,CAAC;QACnD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC;QAC5D,MAAM,GAAG,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,SAAS,EAAE,WAAW,EAAE,CAAC;QAChF,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAEzE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACpC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC,EACnC,aAA6B,EAC7B,WAA4C;IAE5C,OAAO,IAAI,4BAA4B,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AAC9E,CAAC"}

package/dist/gate/types.d.ts

@@ -1,122 +0,0 @@
-import { JsonValue, Diagnostic } from "../types.js";
-import { CoordinatorDiagnostic, CoordinatorPushResult, ToolCallCoordinatorEvent } from "../coordinator/types.js";
-import { NormalizedToolStreamEvent, StreamEndReason } from "../coordinator/protocol.js";
-/**
- * What to do with a tool call right now.
- *
- * - `"execute"`: the arguments are complete, unfabricated, and (if a schema
- *   was registered for this tool) schema-valid. Safe to run.
- * - `"retry"`: the provider's output was incomplete or truncated. There is
- *   nothing wrong with the data received so far - there just isn't a
- *   trustworthy complete value yet. Re-request/continue generation.
- * - `"reject"`: the data itself is the problem (malformed JSON, a schema
- *   mismatch, a resource limit, a provider-side error, or a content-policy
- *   termination). Re-sending the exact same partial input will not fix it.
- */
-export type ExecutionAction = "execute" | "retry" | "reject";
-/**
- * Machine-readable classification of *why* an `ExecutionAction` was chosen.
- * See `docs/EXECUTION_GATE.md` for the full decision table.
- */
-export type ExecutionReason = "complete" | "truncated" | "stream_incomplete" | "schema_invalid" | "malformed" | "resource_limit" | "provider_error" | "content_filtered" | "unknown";
-interface ExecutionDecisionCommon {
-    /** The coordinator's internal call identifier (see `ToolCallState.internalId`). */
-    readonly internalId: string;
-    readonly toolCallId?: string;
-    readonly toolIndex?: number;
-    readonly name?: string;
-    /**
-     * Whatever was safely committed for this call, complete or not - present
-     * for both executable and non-executable decisions so a caller can see
-     * *what part* of a rejected/retried call was genuinely received (e.g. a
-     * `path` field that arrived before a `content` field got cut off).
-     * Never the source of truth for whether it's safe to act on - that's
-     * `action`/`executable`. Absent only when nothing was ever committed.
-     */
-    readonly stableValue?: JsonValue;
-    /** This call's own parser diagnostics, verbatim (`ToolCallState.parser.diagnostics`). */
-    readonly parserDiagnostics: readonly Diagnostic[];
-    /** Coordinator-level diagnostics attributable to this call, verbatim. */
-    readonly coordinatorDiagnostics: readonly CoordinatorDiagnostic[];
-}
-/**
- * The one and only shape a decision can have when `action === "execute"`.
- * `value` is a real, present `JsonValue` here - never `undefined`, never
- * optional - because this is the single positive case: everything else in
- * the gate exists to rule this out unless it's genuinely earned.
- */
-export interface ExecuteDecision extends ExecutionDecisionCommon {
-    readonly action: "execute";
-    readonly executable: true;
-    readonly reason: "complete";
-    readonly value: JsonValue;
-    /**
-     * Narrowed to required here (unlike the inherited `name?: string`):
-     * the coordinator only ever transitions a call to `status: "complete"`
-     * when `name` is defined (see `DefaultToolCallStreamCoordinator.finishCall`
-     * - a call with no name is forced to `"invalid"` instead), so every
-     * `ExecuteDecision` genuinely has one. Encoding that here means
-     * `tools[decision.name](decision.value)` type-checks directly after
-     * narrowing on `action === "execute"`, with no non-null assertion needed.
-     */
-    readonly name: string;
-}
-/**
- * Every other outcome. `value` does not exist on this type at all (not
- * `undefined` - absent) - TypeScript itself refuses code that reads a
- * "final executable value" off a call the gate did not clear for execution.
- */
-export interface NonExecutableDecision extends ExecutionDecisionCommon {
-    readonly action: "retry" | "reject";
-    readonly executable: false;
-    readonly reason: Exclude<ExecutionReason, "complete">;
-}
-/**
- * `ExecuteDecision | NonExecutableDecision` - a discriminated union on
- * `action` (and redundantly on `executable`, for callers who prefer that
- * check). Narrowing on either field gives you the right shape:
- *
- * ```ts
- * if (decision.action === "execute") {
- *   await tools[decision.name](decision.value); // JsonValue, not JsonValue|undefined
- * }
- * ```
- */
-export type ExecutionDecision = ExecuteDecision | NonExecutableDecision;
-export interface ToolCallExecutionGateFinalResult {
-    /** One decision per tool call the coordinator ever created. */
-    readonly decisions: readonly ExecutionDecision[];
-    /**
-     * The full, unfiltered coordinator diagnostics list (same as
-     * `coordinator.snapshot().diagnostics`) - includes diagnostics with no
-     * associated call, e.g. `E_COORDINATOR_LIMIT_CALLS` fires for a call that
-     * hit the concurrent-call limit before a `ToolCallState` could even be
-     * created for it, so it can never appear in `decisions`.
-     */
-    readonly diagnostics: readonly CoordinatorDiagnostic[];
-}
-/**
- * High-level fail-closed execution decision layer built on top of
- * `ToolCallStreamCoordinator`. Answers one question per tool call: is it
- * safe to execute right now? Callers never need to touch parser lexical
- * state, coordinator event mechanics, or JSON Pointer paths - push provider
- * events in, read `ExecutionDecision`s out.
- */
-export interface ToolCallExecutionGate {
-    push(event: NormalizedToolStreamEvent): CoordinatorPushResult;
-    /**
-     * In-flight view. Every decision here is `"retry"` or `"reject"` -
-     * `"execute"` is only ever returned once the stream has genuinely
-     * finished (see `finish()`), since schema validity and prefix-safety are
-     * both only meaningful once a call has settled.
-     */
-    snapshot(): readonly ExecutionDecision[];
-    /** Drains the underlying coordinator's raw event queue, for advanced/UI consumers. */
-    drainEvents(): readonly ToolCallCoordinatorEvent[];
-    finish(meta?: {
-        reason?: StreamEndReason;
-        providerReason?: string;
-    }): ToolCallExecutionGateFinalResult;
-}
-export {};
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gate/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,CAAC;AAEd,UAAU,uBAAuB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IAEjC,yFAAyF;IACzF,QAAQ,CAAC,iBAAiB,EAAE,SAAS,UAAU,EAAE,CAAC;IAElD,yEAAyE;IACzE,QAAQ,CAAC,sBAAsB,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnE;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAE1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;CACvD;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,qBAAqB,CAAC;AAExE,MAAM,WAAW,gCAAgC;IAC/C,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACxD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,KAAK,EAAE,yBAAyB,GAAG,qBAAqB,CAAC;IAE9D;;;;;OAKG;IACH,QAAQ,IAAI,SAAS,iBAAiB,EAAE,CAAC;IAEzC,sFAAsF;IACtF,WAAW,IAAI,SAAS,wBAAwB,EAAE,CAAC;IAEnD,MAAM,CAAC,IAAI,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,gCAAgC,CAAC;CACtC"}

package/dist/gate/types.js

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

package/dist/gate/types.js.map

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