slot-flight 0.1.0

package/dist/slot/frame/parser.d.ts

@@ -0,0 +1,27 @@
+export type SlotFrameParserEvent = {
+    type: "slot-start";
+    slot: string;
+} | {
+    type: "slot-delta";
+    slot: string;
+    delta: string;
+    value: string;
+} | {
+    type: "slot-complete";
+    slot: string;
+    value: string;
+};
+export declare class SlotFrameParser {
+    private readonly slotsById;
+    private state;
+    private buffer;
+    private current;
+    private readonly completed;
+    constructor(slotsById: Map<string, string>);
+    push(chunk: string): SlotFrameParserEvent[];
+    finish(): void;
+    private flushValue;
+    private dropLeadingBlankLines;
+    private mightBePartialHeader;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/slot/frame/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/slot/frame/parser.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,qBAAa,eAAe;IAYd,OAAO,CAAC,QAAQ,CAAC,SAAS;IAXtC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAMD;IACd,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAElB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAE3D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAsE3C,MAAM,IAAI,IAAI;IAgBd,OAAO,CAAC,UAAU;IAyDlB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,oBAAoB;CAG7B"}

package/dist/slot/frame/parser.js

@@ -0,0 +1,143 @@
+import { SlotFlightSlotProtocolError } from "../../errors.js";
+export class SlotFrameParser {
+    slotsById;
+    state = "headers";
+    buffer = "";
+    current;
+    completed = new Set();
+    constructor(slotsById) {
+        this.slotsById = slotsById;
+    }
+    push(chunk) {
+        this.buffer += chunk;
+        const events = [];
+        while (true) {
+            if (this.state === "headers") {
+                this.dropLeadingBlankLines();
+                if (this.buffer.length === 0) {
+                    return events;
+                }
+                const headerMatch = /^<(?<id>\d+)>/.exec(this.buffer);
+                if (headerMatch?.groups === undefined) {
+                    // Chunks can split a header after "<" or the id digits. Wait for
+                    // more bytes before treating the buffered prefix as invalid output.
+                    if (this.mightBePartialHeader()) {
+                        return events;
+                    }
+                    const slotLineEnd = this.buffer.indexOf("\n");
+                    const received = slotLineEnd === -1
+                        ? this.buffer
+                        : this.buffer.slice(0, slotLineEnd);
+                    throw new SlotFlightSlotProtocolError(`Expected slot id header but received "${received}".`, true);
+                }
+                const id = headerMatch.groups.id;
+                const header = headerMatch[0];
+                if (this.buffer.length < header.length) {
+                    return events;
+                }
+                const path = this.slotsById.get(id);
+                if (path === undefined) {
+                    throw new SlotFlightSlotProtocolError(`Received unregistered slot id "${id}".`, false);
+                }
+                if (this.completed.has(path)) {
+                    throw new SlotFlightSlotProtocolError(`Received duplicate slot "${path}".`, false);
+                }
+                this.current = { id, path, value: "" };
+                this.buffer = this.buffer.slice(header.length);
+                if (this.buffer.startsWith("\r\n")) {
+                    this.buffer = this.buffer.slice(2);
+                }
+                else if (this.buffer.startsWith("\n")) {
+                    this.buffer = this.buffer.slice(1);
+                }
+                this.state = "value";
+                events.push({ type: "slot-start", slot: path });
+            }
+            if (this.state === "value") {
+                const flushed = this.flushValue();
+                events.push(...flushed.events);
+                if (!flushed.completedFrame) {
+                    return events;
+                }
+            }
+        }
+    }
+    finish() {
+        this.dropLeadingBlankLines();
+        if (this.state !== "headers" || this.current !== undefined) {
+            throw new SlotFlightSlotProtocolError("Slot stream ended before closing delimiter.", true);
+        }
+        if (this.buffer.length > 0) {
+            throw new SlotFlightSlotProtocolError(`Unexpected trailing content after slot frames: "${this.buffer}".`, true);
+        }
+    }
+    flushValue() {
+        if (this.current === undefined) {
+            return { events: [], completedFrame: false };
+        }
+        const events = [];
+        const closing = `</${this.current.id}>`;
+        const closingIndex = this.buffer.indexOf(closing);
+        if (closingIndex !== -1) {
+            const delta = stripOneTrailingLineBreak(this.buffer.slice(0, closingIndex));
+            if (delta.length > 0) {
+                this.current.value += delta;
+                events.push({
+                    type: "slot-delta",
+                    slot: this.current.path,
+                    delta,
+                    value: this.current.value
+                });
+            }
+            events.push({
+                type: "slot-complete",
+                slot: this.current.path,
+                value: this.current.value
+            });
+            this.completed.add(this.current.path);
+            this.buffer = this.buffer.slice(closingIndex + closing.length);
+            this.current = undefined;
+            this.state = "headers";
+            return { events, completedFrame: true };
+        }
+        // Keep a delimiter-sized suffix in the buffer so a close tag split across
+        // chunks is not accidentally emitted as value text.
+        const keep = closing.length + 1;
+        if (this.buffer.length <= keep) {
+            return { events, completedFrame: false };
+        }
+        const deltaEnd = this.buffer.length - keep;
+        const delta = this.buffer.slice(0, deltaEnd);
+        this.buffer = this.buffer.slice(deltaEnd);
+        this.current.value += delta;
+        events.push({
+            type: "slot-delta",
+            slot: this.current.path,
+            delta,
+            value: this.current.value
+        });
+        return { events, completedFrame: false };
+    }
+    dropLeadingBlankLines() {
+        while (this.buffer.startsWith("\n") || this.buffer.startsWith("\r\n")) {
+            this.buffer = this.buffer.startsWith("\r\n")
+                ? this.buffer.slice(2)
+                : this.buffer.slice(1);
+        }
+    }
+    mightBePartialHeader() {
+        return /^<\d*$/.test(this.buffer);
+    }
+}
+function stripOneTrailingLineBreak(value) {
+    // Multiline frames commonly place the close tag on its own line; that
+    // protocol newline should not become part of the slot value.
+    if (value.endsWith("\r\n")) {
+        return value.slice(0, -2);
+    }
+    if (value.endsWith("\n")) {
+        return value.slice(0, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=parser.js.map

package/dist/slot/frame/parser.js.map

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

package/dist/slot/frame/prompt.d.ts

@@ -0,0 +1,4 @@
+import type { SlotFlightPrompt, SlotFrameRequest } from "../../types.js";
+export declare function createSlotFramePrompt(slots: SlotFrameRequest[], prompt: SlotFlightPrompt | undefined): string;
+export declare function defaultSlotFramePrompt(slots: SlotFrameRequest[]): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/slot/frame/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/slot/frame/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EAAE,EACzB,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,MAAM,CAUR;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAkCxE"}

package/dist/slot/frame/prompt.js

@@ -0,0 +1,59 @@
+export function createSlotFramePrompt(slots, prompt) {
+    const request = {
+        prompt: "",
+        slots,
+        attempt: Math.max(...slots.map((slot) => slot.attempt))
+    };
+    return typeof prompt === "function"
+        ? prompt(request)
+        : (prompt ?? defaultSlotFramePrompt(slots));
+}
+export function defaultSlotFramePrompt(slots) {
+    const slotList = slots.map(formatSlotPromptEntry).join("\n\n");
+    return [
+        "You are filling slots for a server-owned JSON object.",
+        "Do not emit JSON.",
+        "The server owns the object shape, paths, validation, retries, and assembly.",
+        "",
+        "OUTPUT CONTRACT",
+        "- Emit exactly one frame for each requested slot.",
+        "- Emit frames in the same order as the slot list.",
+        "- Copy each open and close tag exactly.",
+        "- Do not emit unrequested ids, JSON paths, markdown, code fences, commentary, bullets, or explanations.",
+        "- Do not omit a frame. If a value is uncertain, make the best valid value for that slot.",
+        "- Do not include a closing tag string inside a value.",
+        "",
+        "FRAME SHAPE",
+        "- Prefer one-line frames for concise values:",
+        "<1>raw slot value only</1>",
+        "- Use multiline frames only when the value itself needs multiple lines:",
+        "<1>",
+        "raw multiline slot value only",
+        "</1>",
+        "- After writing a value, immediately write the exact closing tag for that id.",
+        "",
+        "VALUE RULES",
+        "- For mode: text, emit the raw value only. Do not wrap it in quotes unless quotes are part of the value.",
+        "- For mode: json, emit one syntactically valid JSON value inside the frame body and nothing else.",
+        "- JSON strings, arrays, and objects must use valid JSON syntax with double-quoted strings.",
+        "- Respect each slot instruction, especially enum labels, length limits, item counts, and requested language.",
+        "- A retry attempt means the previous frame or value for that slot failed parsing, protocol checks, or validation. Produce a corrected value only for the requested retry slot.",
+        "",
+        "SLOTS",
+        slotList
+    ].join("\n");
+}
+function formatSlotPromptEntry(slot) {
+    return [
+        `- id: ${slot.id}`,
+        `  path: ${slot.path}`,
+        `  mode: ${slot.mode}`,
+        `  attempt: ${slot.attempt}`,
+        `  open: <${slot.id}>`,
+        `  close: </${slot.id}>`,
+        slot.prompt ? `  instruction: ${slot.prompt}` : undefined
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/slot/frame/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/slot/frame/prompt.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,qBAAqB,CACnC,KAAyB,EACzB,MAAoC;IAEpC,MAAM,OAAO,GAA4B;QACvC,MAAM,EAAE,EAAE;QACV,KAAK;QACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACxD,CAAC;IAEF,OAAO,OAAO,MAAM,KAAK,UAAU;QACjC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAyB;IAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,OAAO;QACL,uDAAuD;QACvD,mBAAmB;QACnB,6EAA6E;QAC7E,EAAE;QACF,iBAAiB;QACjB,mDAAmD;QACnD,mDAAmD;QACnD,yCAAyC;QACzC,yGAAyG;QACzG,0FAA0F;QAC1F,uDAAuD;QACvD,EAAE;QACF,aAAa;QACb,8CAA8C;QAC9C,4BAA4B;QAC5B,yEAAyE;QACzE,KAAK;QACL,+BAA+B;QAC/B,MAAM;QACN,+EAA+E;QAC/E,EAAE;QACF,aAAa;QACb,0GAA0G;QAC1G,mGAAmG;QACnG,4FAA4F;QAC5F,8GAA8G;QAC9G,gLAAgL;QAChL,EAAE;QACF,OAAO;QACP,QAAQ;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAsB;IACnD,OAAO;QACL,SAAS,IAAI,CAAC,EAAE,EAAE;QAClB,WAAW,IAAI,CAAC,IAAI,EAAE;QACtB,WAAW,IAAI,CAAC,IAAI,EAAE;QACtB,cAAc,IAAI,CAAC,OAAO,EAAE;QAC5B,YAAY,IAAI,CAAC,EAAE,GAAG;QACtB,cAAc,IAAI,CAAC,EAAE,GAAG;QACxB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;KAC1D;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { SlotFrameRequest } from "../../types.js";
+import type { CompiledSlot } from "../plan.js";
+export declare function createSlotId(index: number): string;
+export declare function createSlotFrameRequests(slots: CompiledSlot[], attempts: ReadonlyMap<string, number>): SlotFrameRequest[];
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/slot/frame/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,gBAAgB,EAAE,CAoBpB"}

package/dist/slot/frame/request.js

@@ -0,0 +1,23 @@
+export function createSlotId(index) {
+    return String(index + 1);
+}
+export function createSlotFrameRequests(slots, attempts) {
+    // Frame ids are local to this provider request. Retried subsets get compact
+    // ids again, while the server keeps the stable mapping back to slot paths.
+    return slots.map((slot, index) => {
+        const frame = {
+            id: createSlotId(index),
+            path: slot.path,
+            templatePath: slot.definition.path,
+            prompt: "",
+            attempt: attempts.get(slot.path) ?? 1,
+            mode: slot.definition.mode ?? "text"
+        };
+        frame.prompt =
+            typeof slot.definition.prompt === "function"
+                ? slot.definition.prompt(frame)
+                : (slot.definition.prompt ?? "");
+        return frame;
+    });
+}
+//# sourceMappingURL=request.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/slot/frame/request.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAqB,EACrB,QAAqC;IAErC,4EAA4E;IAC5E,2EAA2E;IAC3E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAqB;YAC9B,EAAE,EAAE,YAAY,CAAC,KAAK,CAAC;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAClC,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,MAAM;SACrC,CAAC;QAEF,KAAK,CAAC,MAAM;YACV,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,UAAU;gBAC1C,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/B,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAErC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/slot/index.d.ts

@@ -0,0 +1,9 @@
+export { runSlotFrameStream, type SlotExecutionOptions } from "./execution/index.js";
+export { SlotFrameParser } from "./frame/parser.js";
+export { createSlotFramePrompt, defaultSlotFramePrompt } from "./frame/prompt.js";
+export { createSlotFrameRequests, createSlotId } from "./frame/request.js";
+export { type SlotObjectOptions, type SlotObjectOutput, slotObject } from "./object/definition.js";
+export { type CompletedSlot, createSlotObjectStream, type SlotObjectDebugStream, type SlotObjectReadableStreamOptions, type SlotObjectResponseOptions, type SlotObjectStream, type SlotObjectStreamFormat, type SlotObjectStreamSource } from "./object/stream.js";
+export { concretePathToJsonPointer, expandSlotPath, parseConcretePath, parseSlotTemplate, setPathValue } from "./path.js";
+export { type CompiledSlot, compileSlotPlan } from "./plan.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/slot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,UAAU,EACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,aAAa,EAClB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,YAAY,EACjB,eAAe,EAChB,MAAM,WAAW,CAAC"}

package/dist/slot/index.js

@@ -0,0 +1,9 @@
+export { runSlotFrameStream } from "./execution/index.js";
+export { SlotFrameParser } from "./frame/parser.js";
+export { createSlotFramePrompt, defaultSlotFramePrompt } from "./frame/prompt.js";
+export { createSlotFrameRequests, createSlotId } from "./frame/request.js";
+export { slotObject } from "./object/definition.js";
+export { createSlotObjectStream } from "./object/stream.js";
+export { concretePathToJsonPointer, expandSlotPath, parseConcretePath, parseSlotTemplate, setPathValue } from "./path.js";
+export { compileSlotPlan } from "./plan.js";
+//# sourceMappingURL=index.js.map

package/dist/slot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/slot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,UAAU,EACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,sBAAsB,EAOvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,eAAe,EAChB,MAAM,WAAW,CAAC"}

package/dist/slot/object/definition.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { SlotDefinition } from "../../types.js";
+export interface SlotObjectOptions<TSchema extends z.ZodTypeAny> {
+    schema: TSchema;
+    prompt?: string;
+    maxRetries?: number;
+}
+export interface SlotObjectOutput<TSchema extends z.ZodTypeAny> extends SlotObjectOptions<TSchema> {
+    slots: SlotDefinition[];
+}
+export declare function slotObject<TSchema extends z.ZodTypeAny>(options: SlotObjectOptions<TSchema>): SlotObjectOutput<TSchema>;
+//# sourceMappingURL=definition.d.ts.map

package/dist/slot/object/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/slot/object/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,CAC5D,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IAClC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EACrD,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAClC,gBAAgB,CAAC,OAAO,CAAC,CAK3B"}

package/dist/slot/object/definition.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { SlotFlightConfigurationError } from "../../errors.js";
+export function slotObject(options) {
+    return {
+        ...options,
+        slots: inferSlots(options.schema)
+    };
+}
+function inferSlots(schema) {
+    const root = unwrapSchema(schema);
+    if (!(root instanceof z.ZodObject)) {
+        throw new SlotFlightConfigurationError("slotObject() requires a Zod object schema.");
+    }
+    const slots = Object.entries(root.shape).flatMap(([key, child]) => inferSlotAtPath(child, key));
+    if (slots.length === 0) {
+        throw new SlotFlightConfigurationError("slotObject() requires at least one schema field with .describe().");
+    }
+    return slots;
+}
+function inferSlotAtPath(schema, path) {
+    const unwrapped = unwrapSchema(schema);
+    const prompt = schema.description;
+    if (prompt !== undefined) {
+        return [
+            {
+                path,
+                prompt,
+                schema,
+                mode: isJsonValueSchema(unwrapped) ? "json" : "text"
+            }
+        ];
+    }
+    if (unwrapped instanceof z.ZodObject) {
+        return Object.entries(unwrapped.shape).flatMap(([key, child]) => inferSlotAtPath(child, `${path}.${key}`));
+    }
+    throw new SlotFlightConfigurationError(`Schema field "${path}" must use .describe() to become a slot.`);
+}
+function isJsonValueSchema(schema) {
+    return schema instanceof z.ZodArray || schema instanceof z.ZodObject;
+}
+function unwrapSchema(schema) {
+    let current = schema;
+    // Slot inference should follow the value shape through common wrappers such
+    // as optional/default, because those wrappers do not change the JSON path.
+    while (current instanceof z.ZodOptional ||
+        current instanceof z.ZodNullable ||
+        current instanceof z.ZodDefault ||
+        current instanceof z.ZodCatch) {
+        current = current._def.innerType;
+    }
+    return current;
+}
+//# sourceMappingURL=definition.js.map

package/dist/slot/object/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/slot/object/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAc/D,MAAM,UAAU,UAAU,CACxB,OAAmC;IAEnC,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAoB;IACtC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,4BAA4B,CACpC,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAChE,eAAe,CAAC,KAAqB,EAAE,GAAG,CAAC,CAC5C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,4BAA4B,CACpC,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB,EAAE,IAAY;IACzD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;IAElC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO;YACL;gBACE,IAAI;gBACJ,MAAM;gBACN,MAAM;gBACN,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;aACrD;SACF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAC9D,eAAe,CAAC,KAAqB,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,4BAA4B,CACpC,iBAAiB,IAAI,0CAA0C,CAChE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAoB;IAC7C,OAAO,MAAM,YAAY,CAAC,CAAC,QAAQ,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,MAAoB;IACxC,IAAI,OAAO,GAAG,MAAM,CAAC;IAErB,4EAA4E;IAC5E,2EAA2E;IAC3E,OACE,OAAO,YAAY,CAAC,CAAC,WAAW;QAChC,OAAO,YAAY,CAAC,CAAC,WAAW;QAChC,OAAO,YAAY,CAAC,CAAC,UAAU;QAC/B,OAAO,YAAY,CAAC,CAAC,QAAQ,EAC7B,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/slot/object/projections.d.ts

@@ -0,0 +1,6 @@
+import type { SlotFlightEvent } from "../../types.js";
+import type { CompletedSlot } from "./stream.js";
+export declare function partialObjectIterator<T>(events: AsyncIterable<SlotFlightEvent>): AsyncGenerator<Partial<T>>;
+export declare function completedSlotIterator<T>(events: AsyncIterable<SlotFlightEvent>): AsyncGenerator<CompletedSlot<T>>;
+export declare function completedEventIterator(events: AsyncIterable<SlotFlightEvent>): AsyncGenerator<SlotFlightEvent>;
+//# sourceMappingURL=projections.d.ts.map

package/dist/slot/object/projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.d.ts","sourceRoot":"","sources":["../../../src/slot/object/projections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAuB,qBAAqB,CAAC,CAAC,EAC5C,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,GACrC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAM5B;AAED,wBAAuB,qBAAqB,CAAC,CAAC,EAC5C,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,GACrC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAUlC;AAED,wBAAuB,sBAAsB,CAC3C,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,GACrC,cAAc,CAAC,eAAe,CAAC,CAMjC"}

package/dist/slot/object/projections.js

@@ -0,0 +1,37 @@
+export async function* partialObjectIterator(events) {
+    for await (const event of events) {
+        if (eventHasState(event)) {
+            yield event.state;
+        }
+    }
+}
+export async function* completedSlotIterator(events) {
+    for await (const event of events) {
+        if (event.type === "slot-complete") {
+            yield {
+                slot: event.slot,
+                value: event.value,
+                state: event.state
+            };
+        }
+    }
+}
+export async function* completedEventIterator(events) {
+    for await (const event of events) {
+        if (isCompletedOutputEvent(event)) {
+            yield event;
+        }
+    }
+}
+function eventHasState(event) {
+    return (event.type === "slot-delta" ||
+        event.type === "slot-complete" ||
+        event.type === "done");
+}
+function isCompletedOutputEvent(event) {
+    return (event.type === "slot-complete" ||
+        event.type === "slot-retry" ||
+        event.type === "slot-error" ||
+        event.type === "done");
+}
+//# sourceMappingURL=projections.js.map

package/dist/slot/object/projections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.js","sourceRoot":"","sources":["../../../src/slot/object/projections.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,qBAAqB,CAC1C,MAAsC;IAEtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,CAAC,KAAmB,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,qBAAqB,CAC1C,MAAsC;IAEtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,MAAM;gBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,KAAK,CAAC,KAAmB;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAC3C,MAAsC;IAEtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAsB;IAG3C,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,KAAK,CAAC,IAAI,KAAK,eAAe;QAC9B,KAAK,CAAC,IAAI,KAAK,MAAM,CACtB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAsB;IACpD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,eAAe;QAC9B,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,KAAK,CAAC,IAAI,KAAK,MAAM,CACtB,CAAC;AACJ,CAAC"}

package/dist/slot/object/run.d.ts

@@ -0,0 +1,18 @@
+import type { SlotFlightEvent } from "../../types.js";
+export declare class SlotObjectRun {
+    private readonly source;
+    private readonly cancelSource?;
+    private consumedBy;
+    private sourceIterator;
+    private resolveFinal;
+    private rejectFinal;
+    private readonly finalObjectPromise;
+    constructor(source: AsyncIterable<SlotFlightEvent>, cancelSource?: (() => void) | undefined);
+    get finalObject(): Promise<unknown>;
+    events(consumer: string): AsyncGenerator<SlotFlightEvent>;
+    cancel(): void;
+    private startFinalObjectDrain;
+    private claim;
+    private readEvents;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/slot/object/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/slot/object/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,qBAAa,aAAa;IAStB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAThC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAA4B;IAE/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAmB;gBAGnC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,YAAY,CAAC,GAAE,MAAM,IAAI,aAAA;IAS5C,IAAI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAKlC;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC;IAOzD,MAAM,IAAI,IAAI;IAKd,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,KAAK;YAUE,UAAU;CA0C1B"}

package/dist/slot/object/run.js

@@ -0,0 +1,94 @@
+import { SlotFlightStreamError } from "../../errors.js";
+export class SlotObjectRun {
+    source;
+    cancelSource;
+    consumedBy;
+    sourceIterator;
+    resolveFinal;
+    rejectFinal;
+    finalObjectPromise;
+    constructor(source, cancelSource) {
+        this.source = source;
+        this.cancelSource = cancelSource;
+        this.finalObjectPromise = new Promise((resolve, reject) => {
+            this.resolveFinal = resolve;
+            this.rejectFinal = reject;
+        });
+        this.finalObjectPromise.catch(() => undefined);
+    }
+    get finalObject() {
+        if (this.consumedBy === undefined) {
+            this.startFinalObjectDrain();
+        }
+        return this.finalObjectPromise;
+    }
+    events(consumer) {
+        // SlotObjectRun deliberately has no event history or fan-out. A run has one
+        // live consumer so slow views cannot force unbounded buffering.
+        this.claim(consumer);
+        return this.readEvents();
+    }
+    cancel() {
+        this.cancelSource?.();
+        void this.sourceIterator?.return?.();
+    }
+    startFinalObjectDrain() {
+        this.claim("finalObject");
+        void (async () => {
+            try {
+                for await (const _event of this.readEvents()) {
+                    // Drain the source so finalObject can be used without selecting a
+                    // stream view; readEvents resolves the promise when it sees "done".
+                }
+            }
+            catch {
+                // readEvents already rejects finalObject with the same error.
+            }
+        })();
+    }
+    claim(consumer) {
+        if (this.consumedBy !== undefined) {
+            throw new SlotFlightStreamError(`SlotObjectStream is already being consumed by ${this.consumedBy}. Choose one stream view per run.`);
+        }
+        this.consumedBy = consumer;
+    }
+    async *readEvents() {
+        const iterator = this.source[Symbol.asyncIterator]();
+        this.sourceIterator = iterator;
+        let sawDone = false;
+        let completed = false;
+        let finalState;
+        try {
+            while (true) {
+                const next = await iterator.next();
+                if (next.done) {
+                    break;
+                }
+                const event = next.value;
+                if (event.type === "done") {
+                    sawDone = true;
+                    finalState = event.state;
+                }
+                yield event;
+            }
+            if (!sawDone) {
+                throw new SlotFlightStreamError("SlotObjectStream source completed without a done event.");
+            }
+            completed = true;
+            this.resolveFinal(finalState);
+        }
+        catch (error) {
+            this.rejectFinal(error);
+            throw error;
+        }
+        finally {
+            this.sourceIterator = undefined;
+            if (!completed) {
+                this.cancel();
+                await iterator.return?.();
+                this.rejectFinal(new DOMException("Stream cancelled", "AbortError"));
+            }
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/slot/object/run.js.map

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

package/dist/slot/object/stream.d.ts

@@ -0,0 +1,34 @@
+import type { SlotFlightEvent } from "../../types.js";
+export interface CompletedSlot<T = unknown> {
+    slot: string;
+    value: unknown;
+    state: Partial<T>;
+}
+export type SlotObjectStreamSource = "completed" | "partial" | "events";
+export type SlotObjectStreamFormat = "sse" | "ndjson";
+export interface SlotObjectReadableStreamOptions {
+    source?: SlotObjectStreamSource;
+    format?: SlotObjectStreamFormat;
+}
+export interface SlotObjectResponseOptions {
+    format?: SlotObjectStreamFormat;
+    status?: number;
+    statusText?: string;
+    headers?: HeadersInit;
+}
+export interface SlotObjectDebugStream<T> {
+    readonly partialObjectStream: AsyncIterable<Partial<T>>;
+    readonly slotEventStream: AsyncIterable<SlotFlightEvent>;
+    toReadableStream(options?: SlotObjectReadableStreamOptions): ReadableStream<Uint8Array>;
+}
+export interface SlotObjectStream<T> {
+    readonly completedSlotStream: AsyncIterable<CompletedSlot<T>>;
+    readonly finalObject: Promise<T>;
+    readonly debug: SlotObjectDebugStream<T>;
+    toResponse(options?: SlotObjectResponseOptions): Response;
+}
+export interface SlotObjectStreamOptions {
+    cancel?: () => void;
+}
+export declare function createSlotObjectStream<T>(source: AsyncIterable<SlotFlightEvent>, options?: SlotObjectStreamOptions): SlotObjectStream<T>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/slot/object/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/slot/object/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACnB;AAED,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACzD,gBAAgB,CACd,OAAO,CAAC,EAAE,+BAA+B,GACxC,cAAc,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,QAAQ,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAAC,CAAC,CAAC,CA0BrB"}