slot-flight 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+import type { z } from "zod";
+export declare class SlotFlightError extends Error {
+}
+export declare class SlotFlightConfigurationError extends SlotFlightError {
+    constructor(message: string);
+}
+export declare class SlotFlightValidationError extends SlotFlightError {
+    readonly path: string;
+    readonly issues: z.ZodIssue[];
+    constructor(path: string, issues: z.ZodIssue[]);
+}
+export declare class SlotFlightSlotProtocolError extends SlotFlightError {
+    readonly retryable: boolean;
+    constructor(message: string, retryable: boolean);
+}
+export declare class SlotFlightJsonParseError extends SlotFlightError {
+    readonly path: string;
+    constructor(path: string, reason: string);
+}
+export declare class SlotFlightStreamError extends SlotFlightError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,qBAAa,4BAA6B,SAAQ,eAAe;gBACnD,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,yBAA0B,SAAQ,eAAe;IAE1D,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBADpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAKhC;AAED,qBAAa,2BAA4B,SAAQ,eAAe;IAG5D,QAAQ,CAAC,SAAS,EAAE,OAAO;gBAD3B,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,OAAO;CAK9B;AAED,qBAAa,wBAAyB,SAAQ,eAAe;IAEzD,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM;CAKjB;AAED,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,41 @@
+export class SlotFlightError extends Error {
+}
+export class SlotFlightConfigurationError extends SlotFlightError {
+    constructor(message) {
+        super(message);
+        this.name = "SlotFlightConfigurationError";
+    }
+}
+export class SlotFlightValidationError extends SlotFlightError {
+    path;
+    issues;
+    constructor(path, issues) {
+        super(`Slot "${path}" failed validation.`);
+        this.path = path;
+        this.issues = issues;
+        this.name = "SlotFlightValidationError";
+    }
+}
+export class SlotFlightSlotProtocolError extends SlotFlightError {
+    retryable;
+    constructor(message, retryable) {
+        super(message);
+        this.retryable = retryable;
+        this.name = "SlotFlightSlotProtocolError";
+    }
+}
+export class SlotFlightJsonParseError extends SlotFlightError {
+    path;
+    constructor(path, reason) {
+        super(`Slot "${path}" did not emit valid JSON: ${reason}`);
+        this.path = path;
+        this.name = "SlotFlightJsonParseError";
+    }
+}
+export class SlotFlightStreamError extends SlotFlightError {
+    constructor(message) {
+        super(message);
+        this.name = "SlotFlightStreamError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAE7C,MAAM,OAAO,4BAA6B,SAAQ,eAAe;IAC/D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAEjD;IACA;IAFX,YACW,IAAY,EACZ,MAAoB;QAE7B,KAAK,CAAC,SAAS,IAAI,sBAAsB,CAAC,CAAC;QAHlC,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAc;QAG7B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,eAAe;IAGnD;IAFX,YACE,OAAe,EACN,SAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,cAAS,GAAT,SAAS,CAAS;QAG3B,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,eAAe;IAEhD;IADX,YACW,IAAY,EACrB,MAAc;QAEd,KAAK,CAAC,SAAS,IAAI,8BAA8B,MAAM,EAAE,CAAC,CAAC;QAHlD,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { CompletedSlot, SlotObjectDebugStream, SlotObjectOptions, SlotObjectResponseOptions, SlotObjectStream, SlotObjectStreamFormat } from "./slot/index.js";
+export { slotObject } from "./slot/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { slotObject } from "./slot/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/slot/execution/events.d.ts

@@ -0,0 +1,15 @@
+import type { SlotFrameParser } from "../frame/parser.js";
+import type { CompiledSlot } from "../plan.js";
+import type { PendingFailure, SlotExecutionEvent } from "./types.js";
+export declare function consumeFrameStream({ stream, parser, slots, attempts, state, completed, failures, signal, cloneState }: {
+    stream: AsyncIterable<string>;
+    parser: SlotFrameParser;
+    slots: CompiledSlot[];
+    attempts: Map<string, number>;
+    state: unknown;
+    completed: Set<string>;
+    failures: Map<string, PendingFailure>;
+    signal: AbortSignal;
+    cloneState: <T>(value: T) => T;
+}): AsyncGenerator<SlotExecutionEvent>;
+//# sourceMappingURL=events.d.ts.map

package/dist/slot/execution/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/events.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAEhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAuB,kBAAkB,CAAC,EACxC,MAAM,EACN,MAAM,EACN,KAAK,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,EACR,MAAM,EACN,UAAU,EACX,EAAE;IACD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAChC,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAiBrC"}

package/dist/slot/execution/events.js

@@ -0,0 +1,114 @@
+import { SlotFlightJsonParseError, SlotFlightSlotProtocolError, SlotFlightValidationError } from "../../errors.js";
+import { setPathValue } from "../path.js";
+import { abortable, normalizeError } from "./scope.js";
+export async function* consumeFrameStream({ stream, parser, slots, attempts, state, completed, failures, signal, cloneState }) {
+    for await (const chunk of abortable(stream, signal)) {
+        for (const frameEvent of parser.push(chunk)) {
+            const event = handleFrameEvent({
+                frameEvent,
+                slots,
+                attempts,
+                state,
+                completed,
+                failures,
+                cloneState
+            });
+            if (event !== undefined) {
+                yield event;
+            }
+        }
+    }
+}
+function handleFrameEvent({ frameEvent, slots, attempts, state, completed, failures, cloneState }) {
+    if (frameEvent.type === "slot-start") {
+        return {
+            type: "slot-start",
+            slot: frameEvent.slot,
+            attempt: attempts.get(frameEvent.slot) ?? 1,
+            state: cloneState(state)
+        };
+    }
+    if (frameEvent.type === "slot-delta") {
+        // Partial state intentionally contains raw streaming text. The complete
+        // event replaces it with the parsed and validated value.
+        setPathValue(state, frameEvent.slot, frameEvent.value);
+        return {
+            type: "slot-delta",
+            slot: frameEvent.slot,
+            attempt: attempts.get(frameEvent.slot) ?? 1,
+            delta: frameEvent.delta,
+            value: frameEvent.value,
+            state: cloneState(state)
+        };
+    }
+    return completeSlotFrame({
+        frameEvent,
+        slots,
+        attempts,
+        state,
+        completed,
+        failures,
+        cloneState
+    });
+}
+function completeSlotFrame({ frameEvent, slots, attempts, state, completed, failures, cloneState }) {
+    const slot = mustFindSlot(slots, frameEvent.slot);
+    const attempt = attempts.get(slot.path) ?? 1;
+    const parsedValue = parseSlotValue(slot, frameEvent.value);
+    if (!parsedValue.success) {
+        // The frame arrived, but the value is unusable. Mark it completed for this
+        // pass so missing-slot detection does not add a second failure for it.
+        failures.set(slot.path, {
+            slot,
+            attempt,
+            error: parsedValue.error,
+            retryable: true
+        });
+        completed.add(slot.path);
+        return undefined;
+    }
+    const validated = slot.definition.schema.safeParse(parsedValue.value);
+    if (!validated.success) {
+        // Zod failures are slot-local: retry this slot without regenerating slots
+        // that already produced validated values.
+        failures.set(slot.path, {
+            slot,
+            attempt,
+            error: new SlotFlightValidationError(slot.path, validated.error.issues),
+            retryable: true
+        });
+        completed.add(slot.path);
+        return undefined;
+    }
+    setPathValue(state, slot.path, validated.data);
+    completed.add(slot.path);
+    return {
+        type: "slot-complete",
+        slot: slot.path,
+        attempt,
+        value: validated.data,
+        state: cloneState(state)
+    };
+}
+function mustFindSlot(slots, path) {
+    const slot = slots.find((candidate) => candidate.path === path);
+    if (slot === undefined) {
+        throw new SlotFlightSlotProtocolError(`Received unregistered slot "${path}".`, false);
+    }
+    return slot;
+}
+function parseSlotValue(slot, rawValue) {
+    if (slot.definition.mode !== "json") {
+        return { success: true, value: rawValue };
+    }
+    try {
+        return { success: true, value: JSON.parse(rawValue) };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: new SlotFlightJsonParseError(slot.path, normalizeError(error).message)
+        };
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/slot/execution/events.js.map

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

package/dist/slot/execution/failures.d.ts

@@ -0,0 +1,14 @@
+import type { CompiledSlot } from "../plan.js";
+import type { PendingFailure, SlotExecutionEvent } from "./types.js";
+export declare function recordMissingSlots(slots: CompiledSlot[], completed: ReadonlySet<string>, failures: Map<string, PendingFailure>, attempts: ReadonlyMap<string, number>): void;
+export declare function recordFrameFailure(slots: CompiledSlot[], completed: ReadonlySet<string>, failures: Map<string, PendingFailure>, attempts: ReadonlyMap<string, number>, error: Error, retryable: boolean): void;
+export declare function nextPendingSlots({ failures, remaining, attempts, maxRetries, state, cloneState }: {
+    failures: Map<string, PendingFailure>;
+    remaining: CompiledSlot[];
+    attempts: Map<string, number>;
+    maxRetries: number;
+    state: unknown;
+    cloneState: <T>(value: T) => T;
+}): AsyncGenerator<SlotExecutionEvent, CompiledSlot[]>;
+export declare function frameSlotErrors(slots: CompiledSlot[], attempts: ReadonlyMap<string, number>, error: Error, state: unknown, cloneState: <T>(value: T) => T): AsyncGenerator<SlotExecutionEvent>;
+//# sourceMappingURL=failures.d.ts.map

package/dist/slot/execution/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/failures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EAAE,EACrB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,IAAI,CAgBN;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EAAE,EACrB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,OAAO,GACjB,IAAI,CAWN;AAED,wBAAuB,gBAAgB,CAAC,EACtC,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,EACL,UAAU,EACX,EAAE;IACD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAChC,GAAG,cAAc,CAAC,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAkCrD;AAED,wBAAuB,eAAe,CACpC,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAC7B,cAAc,CAAC,kBAAkB,CAAC,CAUpC"}

package/dist/slot/execution/failures.js

@@ -0,0 +1,71 @@
+import { SlotFlightSlotProtocolError } from "../../errors.js";
+export function recordMissingSlots(slots, completed, failures, attempts) {
+    // Missing frames are slot failures, not whole-run failures. This keeps retry
+    // scoped to the smallest unit the engine can safely regenerate.
+    for (const slot of slots) {
+        if (!completed.has(slot.path) && !failures.has(slot.path)) {
+            failures.set(slot.path, {
+                slot,
+                attempt: attempts.get(slot.path) ?? 1,
+                error: new SlotFlightSlotProtocolError(`Slot "${slot.path}" was not emitted by the stream.`, true),
+                retryable: true
+            });
+        }
+    }
+}
+export function recordFrameFailure(slots, completed, failures, attempts, error, retryable) {
+    for (const slot of slots) {
+        if (!completed.has(slot.path) && !failures.has(slot.path)) {
+            failures.set(slot.path, {
+                slot,
+                attempt: attempts.get(slot.path) ?? 1,
+                error,
+                retryable
+            });
+        }
+    }
+}
+export async function* nextPendingSlots({ failures, remaining, attempts, maxRetries, state, cloneState }) {
+    if (failures.size === 0) {
+        return remaining;
+    }
+    const retrySlots = [];
+    for (const failure of failures.values()) {
+        const maxAttempts = (failure.slot.definition.maxRetries ?? maxRetries) + 1;
+        if (failure.retryable && failure.attempt < maxAttempts) {
+            yield {
+                type: "slot-retry",
+                slot: failure.slot.path,
+                attempt: failure.attempt,
+                error: failure.error,
+                state: cloneState(state)
+            };
+            attempts.set(failure.slot.path, failure.attempt + 1);
+            retrySlots.push(failure.slot);
+            continue;
+        }
+        yield {
+            type: "slot-error",
+            slot: failure.slot.path,
+            attempt: failure.attempt,
+            error: failure.error,
+            state: cloneState(state)
+        };
+        throw failure.error;
+    }
+    // Retry failed slots before moving on so partial state progresses in the same
+    // order callers requested, while already validated slots are not regenerated.
+    return [...retrySlots, ...remaining];
+}
+export async function* frameSlotErrors(slots, attempts, error, state, cloneState) {
+    for (const slot of slots) {
+        yield {
+            type: "slot-error",
+            slot: slot.path,
+            attempt: attempts.get(slot.path) ?? 1,
+            error,
+            state: cloneState(state)
+        };
+    }
+}
+//# sourceMappingURL=failures.js.map

package/dist/slot/execution/failures.js.map

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

package/dist/slot/execution/frame-request.d.ts

@@ -0,0 +1,13 @@
+import type { SlotFlightPrompt, SlotGenerator } from "../../types.js";
+import type { CompiledSlot } from "../plan.js";
+import type { PendingFailure, SlotExecutionEvent } from "./types.js";
+export declare function runFrameRequest({ slots, attempts, state, generate, prompt, signal, cloneState }: {
+    slots: CompiledSlot[];
+    attempts: Map<string, number>;
+    state: unknown;
+    generate: SlotGenerator;
+    prompt?: SlotFlightPrompt;
+    signal?: AbortSignal;
+    cloneState: <T>(value: T) => T;
+}): AsyncGenerator<SlotExecutionEvent, Map<string, PendingFailure>>;
+//# sourceMappingURL=frame-request.d.ts.map

package/dist/slot/execution/frame-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-request.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/frame-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAuB,eAAe,CAAC,EACrC,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EACX,EAAE;IACD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAChC,GAAG,cAAc,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAqDlE"}

package/dist/slot/execution/frame-request.js

@@ -0,0 +1,45 @@
+import { SlotFrameParser } from "../frame/parser.js";
+import { createSlotFrameRequests } from "../frame/request.js";
+import { consumeFrameStream } from "./events.js";
+import { frameSlotErrors, recordFrameFailure, recordMissingSlots } from "./failures.js";
+import { createSlotFlightRequest } from "./request.js";
+import { createRequestScope, isAbortError, isRetryableSlotProtocolError, normalizeError } from "./scope.js";
+export async function* runFrameRequest({ slots, attempts, state, generate, prompt, signal, cloneState }) {
+    const requestScope = createRequestScope(signal);
+    const frameRequests = createSlotFrameRequests(slots, attempts);
+    const request = createSlotFlightRequest(frameRequests, prompt, requestScope.signal);
+    const completed = new Set();
+    const failures = new Map();
+    try {
+        const stream = await generate(request);
+        const parser = new SlotFrameParser(new Map(frameRequests.map((slot) => [slot.id, slot.path])));
+        yield* consumeFrameStream({
+            stream,
+            parser,
+            slots,
+            attempts,
+            state,
+            completed,
+            failures,
+            signal: request.signal,
+            cloneState
+        });
+        parser.finish();
+        recordMissingSlots(slots, completed, failures, attempts);
+    }
+    catch (error) {
+        const normalized = normalizeError(error);
+        if (isAbortError(normalized, signal)) {
+            yield* frameSlotErrors(slots, attempts, normalized, state, cloneState);
+            throw normalized;
+        }
+        // Provider/runtime failures are recorded for incomplete slots but are not
+        // retried unless the parser can prove this was a recoverable protocol miss.
+        recordFrameFailure(slots, completed, failures, attempts, normalized, isRetryableSlotProtocolError(normalized));
+    }
+    finally {
+        requestScope.cleanup();
+    }
+    return failures;
+}
+//# sourceMappingURL=frame-request.js.map

package/dist/slot/execution/frame-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-request.js","sourceRoot":"","sources":["../../../src/slot/execution/frame-request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,EAC5B,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CAAC,EACrC,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EASX;IACC,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,uBAAuB,CACrC,aAAa,EACb,MAAM,EACN,YAAY,CAAC,MAAM,CACpB,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,eAAe,CAChC,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3D,CAAC;QAEF,KAAK,CAAC,CAAC,kBAAkB,CAAC;YACxB,MAAM;YACN,MAAM;YACN,KAAK;YACL,QAAQ;YACR,KAAK;YACL,SAAS;YACT,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACvE,MAAM,UAAU,CAAC;QACnB,CAAC;QAED,0EAA0E;QAC1E,4EAA4E;QAC5E,kBAAkB,CAChB,KAAK,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,4BAA4B,CAAC,UAAU,CAAC,CACzC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/slot/execution/index.d.ts

@@ -0,0 +1,4 @@
+import type { SlotExecutionEvent, SlotExecutionOptions } from "./types.js";
+export type { SlotExecutionOptions } from "./types.js";
+export declare function runSlotFrameStream({ slots, state, generate, prompt, maxRetries, signal, cloneState }: SlotExecutionOptions): AsyncGenerator<SlotExecutionEvent, void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/slot/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAuB,kBAAkB,CAAC,EACxC,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,UAAU,EACV,MAAM,EACN,UAAU,EACX,EAAE,oBAAoB,GAAG,cAAc,CAAC,kBAAkB,EAAE,IAAI,CAAC,CA4BjE"}

package/dist/slot/execution/index.js

@@ -0,0 +1,30 @@
+import { nextPendingSlots } from "./failures.js";
+import { runFrameRequest } from "./frame-request.js";
+import { throwIfAborted } from "./scope.js";
+export async function* runSlotFrameStream({ slots, state, generate, prompt, maxRetries, signal, cloneState }) {
+    const attempts = new Map(slots.map((slot) => [slot.path, 1]));
+    let pending = [...slots];
+    while (pending.length > 0) {
+        throwIfAborted(signal);
+        // Each pass asks for every currently pending slot in one frame stream.
+        // Completed slots drop out; only retryable failures come back as pending.
+        const failures = yield* runFrameRequest({
+            slots: pending,
+            attempts,
+            state,
+            generate,
+            prompt,
+            signal,
+            cloneState
+        });
+        pending = yield* nextPendingSlots({
+            failures,
+            remaining: [],
+            attempts,
+            maxRetries,
+            state,
+            cloneState
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/slot/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/slot/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CAAC,EACxC,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,UAAU,EACV,MAAM,EACN,UAAU,EACW;IACrB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAEzB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,uEAAuE;QACvE,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;YACtC,KAAK,EAAE,OAAO;YACd,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,MAAM;YACN,MAAM;YACN,UAAU;SACX,CAAC,CAAC;QAEH,OAAO,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;YAChC,QAAQ;YACR,SAAS,EAAE,EAAE;YACb,QAAQ;YACR,UAAU;YACV,KAAK;YACL,UAAU;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/slot/execution/request.d.ts

@@ -0,0 +1,3 @@
+import type { SlotFlightPrompt, SlotFlightRequest } from "../../types.js";
+export declare function createSlotFlightRequest(frameRequests: SlotFlightRequest["slots"], prompt: SlotFlightPrompt | undefined, signal: AbortSignal): SlotFlightRequest;
+//# sourceMappingURL=request.d.ts.map

package/dist/slot/execution/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG1E,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,iBAAiB,CAAC,OAAO,CAAC,EACzC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,MAAM,EAAE,WAAW,GAClB,iBAAiB,CAOnB"}

package/dist/slot/execution/request.js

@@ -0,0 +1,10 @@
+import { createSlotFramePrompt } from "../frame/prompt.js";
+export function createSlotFlightRequest(frameRequests, prompt, signal) {
+    return {
+        prompt: createSlotFramePrompt(frameRequests, prompt),
+        slots: frameRequests,
+        attempt: Math.max(...frameRequests.map((slot) => slot.attempt)),
+        signal
+    };
+}
+//# sourceMappingURL=request.js.map

package/dist/slot/execution/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/slot/execution/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,UAAU,uBAAuB,CACrC,aAAyC,EACzC,MAAoC,EACpC,MAAmB;IAEnB,OAAO;QACL,MAAM,EAAE,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC;QACpD,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/slot/execution/scope.d.ts

@@ -0,0 +1,10 @@
+export declare function createRequestScope(parentSignal: AbortSignal | undefined): {
+    signal: AbortSignal;
+    cleanup: () => void;
+};
+export declare function abortable<T>(stream: AsyncIterable<T>, signal: AbortSignal): AsyncGenerator<T>;
+export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+export declare function normalizeError(error: unknown): Error;
+export declare function isAbortError(error: Error, parentSignal: AbortSignal | undefined): boolean;
+export declare function isRetryableSlotProtocolError(error: Error): boolean;
+//# sourceMappingURL=scope.d.ts.map

package/dist/slot/execution/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/scope.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,GAAG;IACzE,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAUA;AAED,wBAAuB,SAAS,CAAC,CAAC,EAChC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,WAAW,GAClB,cAAc,CAAC,CAAC,CAAC,CAyBnB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAIpE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAMpD;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,WAAW,GAAG,SAAS,GACpC,OAAO,CAET;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAElE"}

package/dist/slot/execution/scope.js

@@ -0,0 +1,85 @@
+import { SlotFlightSlotProtocolError } from "../../errors.js";
+export function createRequestScope(parentSignal) {
+    // One signal controls the provider request, parser consumption, and caller
+    // cancellation for a single frame stream.
+    const controller = new AbortController();
+    const cleanupAbort = linkAbortSignal(parentSignal, controller);
+    return {
+        signal: controller.signal,
+        cleanup: cleanupAbort
+    };
+}
+export async function* abortable(stream, signal) {
+    const iterator = stream[Symbol.asyncIterator]();
+    const abort = createAbortPromise(signal);
+    let completed = false;
+    try {
+        while (true) {
+            const next = await Promise.race([iterator.next(), abort.promise]);
+            throwIfAborted(signal);
+            if (next.done) {
+                completed = true;
+                return;
+            }
+            yield next.value;
+        }
+    }
+    finally {
+        if (!completed) {
+            // Give SDK streams a chance to release sockets/readers when cancellation
+            // interrupts a frame stream mid-iteration.
+            await iterator.return?.();
+        }
+        abort.cleanup();
+    }
+}
+export function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw signal.reason ?? new DOMException("Aborted", "AbortError");
+    }
+}
+export function normalizeError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}
+export function isAbortError(error, parentSignal) {
+    return parentSignal?.aborted === true || error.name === "AbortError";
+}
+export function isRetryableSlotProtocolError(error) {
+    return error instanceof SlotFlightSlotProtocolError && error.retryable;
+}
+function createAbortPromise(signal) {
+    if (signal.aborted) {
+        return {
+            promise: Promise.reject(signal.reason ?? new DOMException("Aborted", "AbortError")),
+            cleanup: () => undefined
+        };
+    }
+    let rejectAbort;
+    const promise = new Promise((_, reject) => {
+        rejectAbort = reject;
+    });
+    const onAbort = () => {
+        rejectAbort(signal.reason ?? new DOMException("Aborted", "AbortError"));
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    return {
+        promise,
+        cleanup: () => signal.removeEventListener("abort", onAbort)
+    };
+}
+function linkAbortSignal(parent, child) {
+    if (parent === undefined) {
+        return () => undefined;
+    }
+    if (parent.aborted) {
+        child.abort(parent.reason);
+        return () => undefined;
+    }
+    const abort = () => child.abort(parent.reason);
+    parent.addEventListener("abort", abort, { once: true });
+    return () => parent.removeEventListener("abort", abort);
+}
+//# sourceMappingURL=scope.js.map

package/dist/slot/execution/scope.js.map

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

package/dist/slot/execution/types.d.ts

@@ -0,0 +1,21 @@
+import type { SlotFlightEvent, SlotFlightPrompt, SlotGenerator } from "../../types.js";
+import type { CompiledSlot } from "../plan.js";
+export interface SlotExecutionOptions {
+    slots: CompiledSlot[];
+    state: unknown;
+    generate: SlotGenerator;
+    prompt?: SlotFlightPrompt;
+    maxRetries: number;
+    signal?: AbortSignal;
+    cloneState: <T>(value: T) => T;
+}
+export type SlotExecutionEvent = Exclude<SlotFlightEvent, {
+    type: "done";
+}>;
+export interface PendingFailure {
+    slot: CompiledSlot;
+    attempt: number;
+    error: Error;
+    retryable: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/slot/execution/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/slot/execution/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/slot/execution/types.js

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

package/dist/slot/execution/types.js.map

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