@oddkin/ai 0.0.0-stage → 1.0.0-beta.0

package/dist/sources/sources.template.js

@@ -0,0 +1,43 @@
+import { html, repeat } from '@oddkin/core/template';
+import { displayHost, safeUrl } from '../markdown/url.js';
+/** Anatomy: a heading labelling an ordered `list` of `item`s; each item is focusable for reveal. */
+export const sourcesTemplate = (host) => {
+    const t = host._strings;
+    const revealed = host._revealed.value;
+    return html `<section
+    class="base"
+    part="base"
+    aria-labelledby="heading"
+    ?hidden=${!host.sources.length}
+  >
+    <p id="heading" class="heading">${host.label || t.heading}</p>
+    <ol part="list" class="list">
+      ${repeat(host.sources, (s) => s.sourceId, (s) => {
+        const url = s.url ? safeUrl(s.url) : undefined;
+        const title = s.title || displayHost(url) || t.untitled;
+        return html `<li
+            part="item"
+            class="item"
+            tabindex="-1"
+            data-source-id=${s.sourceId}
+            data-revealed=${revealed === s.sourceId ? 'true' : 'false'}
+          >
+            ${url
+            ? html `<a
+                    class="title"
+                    href=${url}
+                    rel="noopener noreferrer nofollow"
+                    target="_blank"
+                    >${title}</a
+                  >`
+            : html `<span class="title">${title}</span>`}
+            <span class="muted" ?hidden=${!s.publisher && !url}
+              >${s.publisher ?? displayHost(url) ?? ''}</span
+            >
+            <span class="excerpt" ?hidden=${!s.excerpt}>${s.excerpt ?? ''}</span>
+          </li>`;
+    })}
+    </ol>
+  </section>`;
+};
+//# sourceMappingURL=sources.template.js.map

package/dist/sources/sources.template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.template.js","sourceRoot":"","sources":["../../src/sources/sources.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG1D,oGAAoG;AACpG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAmB,EAAE,EAAE;IACrD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IACtC,OAAO,IAAI,CAAA;;;;cAIC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;;sCAEI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO;;QAErD,MAAM,CACN,IAAI,CAAC,OAAO,EACZ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EACjB,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;QACxD,OAAO,IAAI,CAAA;;;;6BAIQ,CAAC,CAAC,QAAQ;4BACX,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;cAGxD,GAAG;YACD,CAAC,CAAC,IAAI,CAAA;;2BAEK,GAAG;;;uBAGP,KAAK;oBACR;YACJ,CAAC,CAAC,IAAI,CAAA,uBAAuB,KAAK,SACtC;0CAC8B,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,GAAG;iBAC7C,CAAC,CAAC,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE;;4CAEV,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE;gBACzD,CAAC;IACT,CAAC,CACF;;aAEM,CAAC;AACd,CAAC,CAAC"}

package/dist/stream/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@oddkin/ai/stream` — SSE parsing, the AI SDK UI message stream adapter, and the deterministic
+ * simulation transport. DOM-free.
+ */
+export { SseParser, createSseDecoder, readSse } from './sse.js';
+export type { SseEvent } from './sse.js';
+export { UI_MESSAGE_STREAM_HEADER, UI_MESSAGE_STREAM_VERSION, UiMessageStreamReader, createUiMessageStreamTransport, toUiMessage, } from './ui-message-stream.js';
+export type { StreamDiagnostic, UiMessageStreamTransportOptions } from './ui-message-stream.js';
+export { chunkText, createSimulatedTransport, streamTextSteps } from './simulation.js';
+export type { Script, ScriptStep, SimulatedTransport, SimulationControls, SimulationOptions, } from './simulation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/stream/index.js

@@ -0,0 +1,8 @@
+/**
+ * `@oddkin/ai/stream` — SSE parsing, the AI SDK UI message stream adapter, and the deterministic
+ * simulation transport. DOM-free.
+ */
+export { SseParser, createSseDecoder, readSse } from './sse.js';
+export { UI_MESSAGE_STREAM_HEADER, UI_MESSAGE_STREAM_VERSION, UiMessageStreamReader, createUiMessageStreamTransport, toUiMessage, } from './ui-message-stream.js';
+export { chunkText, createSimulatedTransport, streamTextSteps } from './simulation.js';
+//# sourceMappingURL=index.js.map

package/dist/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/stream/simulation.d.ts

@@ -0,0 +1,58 @@
+import type { AiEvent, Capabilities, ConversationSnapshot, ConversationTransport, DecisionOutcome, PublicError, SendRequest } from '../contracts/types.js';
+export type ScriptStep = 
+/** Deliver `event` `after` ms after the previous step. */
+{
+    readonly after: number;
+    readonly event: AiEvent;
+}
+/** End the connection without a terminal event (a dropped stream). */
+ | {
+    readonly after: number;
+    readonly drop: true;
+}
+/** Pause until the approval is decided, then continue with the matching steps. */
+ | {
+    readonly after: number;
+    readonly awaitDecision: string;
+    readonly approve: readonly ScriptStep[];
+    readonly reject: readonly ScriptStep[];
+};
+export type Script = (request: SendRequest) => readonly ScriptStep[];
+export interface SimulationControls {
+    /** Reject the next send with this error before acceptance. */
+    failNextSend?: PublicError | undefined;
+    /** ms before a send is accepted. */
+    acceptDelay: number;
+    stopBehavior: 'cancel' | 'already-finished' | 'unknown' | 'fail';
+    stopDelay: number;
+    decisionOutcome: DecisionOutcome | 'fail';
+    decisionDelay: number;
+    /** Events re-delivered on resume to exercise deduplication. */
+    replayOverlap: number;
+    feedbackDelay: number;
+    failFeedback: boolean;
+    historyDelay: number;
+}
+export interface SimulatedTransport extends ConversationTransport {
+    readonly simulated: true;
+    readonly controls: SimulationControls;
+    /** Pending timers across all simulated runs (zero when idle). */
+    readonly pendingTimers: number;
+    /** Simulate the server pushing an event for an attempt now (e.g. a late event). */
+    inject(attemptId: string, event: AiEvent): void;
+    /** Stop all timers. */
+    dispose(): void;
+}
+export interface SimulationOptions {
+    readonly script: Script;
+    readonly capabilities?: Capabilities;
+    readonly controls?: Partial<SimulationControls>;
+    /** Pages returned by `loadHistory`, newest page first. */
+    readonly history?: readonly ConversationSnapshot[];
+}
+export declare function createSimulatedTransport(options: SimulationOptions): SimulatedTransport;
+/** Split text into streamed deltas of `size` code points (never inside a surrogate pair). */
+export declare function chunkText(text: string, size?: number): string[];
+/** Steps streaming `text` into one text part. */
+export declare function streamTextSteps(partId: string, text: string, every?: number, size?: number): ScriptStep[];
+//# sourceMappingURL=simulation.d.ts.map

package/dist/stream/simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../../src/stream/simulation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,OAAO,EAGP,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EAGf,WAAW,EACX,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,UAAU;AACpB,0DAA0D;AACxD;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AACrD,sEAAsE;GACpE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE;AACjD,kFAAkF;GAChF;IACE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;CACxC,CAAC;AAEN,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,UAAU,EAAE,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,eAAe,GAAG,MAAM,CAAC;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mFAAmF;IACnF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,uBAAuB;IACvB,OAAO,IAAI,IAAI,CAAC;CACjB;AAkCD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB,CA2MvF;AAID,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,EAAE,CAK1D;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,IAAI,SAAI,GAAG,UAAU,EAAE,CAShG"}

package/dist/stream/simulation.js

@@ -0,0 +1,257 @@
+/**
+ * A deterministic, clearly simulated transport for tests, demos, and race reproduction. Scripts
+ * describe the server's events with delays; the simulated server keeps producing while the
+ * client is disconnected, numbers every event (`seq`) so a resumed connection can replay an
+ * overlap that the controller deduplicates, and exposes controls for acceptance failure, stop
+ * outcomes and delays, decision outcomes, and history pages. Not a protocol: no network.
+ */
+import { toPublicError } from '../contracts/normalize.js';
+const TERMINAL = new Set(['finish', 'abort', 'error']);
+const DEFAULT_CAPABILITIES = {
+    send: { available: true },
+    stop: { available: true },
+    disconnect: { available: true },
+    reconnect: { available: true },
+    resume: { available: true },
+    retry: { available: true },
+    regenerate: { available: true },
+    edit: { available: true },
+    switchBranch: { available: true },
+    respondToApproval: { available: true },
+    history: { available: true },
+    feedback: { available: true },
+    attachments: { available: true },
+};
+export function createSimulatedTransport(options) {
+    const controls = {
+        acceptDelay: 120,
+        stopBehavior: 'cancel',
+        stopDelay: 250,
+        decisionOutcome: 'accepted',
+        decisionDelay: 250,
+        replayOverlap: 3,
+        feedbackDelay: 200,
+        failFeedback: false,
+        historyDelay: 300,
+        ...options.controls,
+    };
+    const runs = new Map();
+    const timers = new Set();
+    const historyPages = [...(options.history ?? [])];
+    const wait = (ms) => new Promise((resolve) => {
+        const id = setTimeout(() => {
+            timers.delete(id);
+            resolve();
+        }, ms);
+        timers.add(id);
+    });
+    const later = (ms, fn) => {
+        const id = setTimeout(() => {
+            timers.delete(id);
+            fn();
+        }, ms);
+        timers.add(id);
+        return id;
+    };
+    const produce = (run, event) => {
+        if (run.ended)
+            return;
+        const seq = run.produced.length;
+        run.produced.push({ ...event, seq });
+        if (TERMINAL.has(event.type))
+            run.ended = true;
+        flush(run);
+    };
+    const flush = (run) => {
+        // Pushes even to inactive sinks: isolating late events is the controller's job.
+        while (run.sink && run.delivered < run.produced.length) {
+            run.sink.push(run.produced[run.delivered++]);
+        }
+        if (run.sink && run.ended && run.delivered >= run.produced.length) {
+            const sink = run.sink;
+            run.sink = undefined;
+            sink.close();
+        }
+    };
+    const advance = (run) => {
+        if (run.ended || run.waiting || run.timer !== undefined)
+            return;
+        const step = run.queue.shift();
+        if (!step)
+            return;
+        run.timer = later(step.after, () => {
+            run.timer = undefined;
+            if (run.ended)
+                return;
+            if ('event' in step)
+                produce(run, step.event);
+            else if ('drop' in step) {
+                run.dropped = true;
+                const sink = run.sink;
+                run.sink = undefined;
+                sink?.close();
+            }
+            else {
+                run.waiting = step.awaitDecision;
+                run.branches = { approve: step.approve, reject: step.reject };
+                return;
+            }
+            advance(run);
+        });
+    };
+    const transport = {
+        simulated: true,
+        controls,
+        capabilities: { ...DEFAULT_CAPABILITIES, ...options.capabilities },
+        get pendingTimers() {
+            return timers.size;
+        },
+        async send(request, sink) {
+            await wait(controls.acceptDelay);
+            const failure = controls.failNextSend;
+            if (failure) {
+                controls.failNextSend = undefined;
+                throw failure;
+            }
+            const run = {
+                target: {
+                    conversationId: request.conversationId,
+                    runId: request.runId,
+                    attemptId: request.attemptId,
+                },
+                queue: [...options.script(request)],
+                produced: [],
+                delivered: 0,
+                sink,
+                timer: undefined,
+                ended: false,
+                waiting: undefined,
+                branches: undefined,
+                dropped: false,
+            };
+            runs.set(request.attemptId, run);
+            produce(run, { type: 'attempt-accepted' });
+            advance(run);
+        },
+        disconnect(target) {
+            const run = runs.get(target.attemptId);
+            if (run)
+                run.sink = undefined;
+        },
+        async resume(target, sink) {
+            await wait(controls.acceptDelay);
+            const run = runs.get(target.attemptId);
+            if (!run)
+                throw { code: 'ai.resume.notFound', message: 'There is no response to resume.' };
+            run.sink = sink;
+            run.dropped = false;
+            run.delivered = Math.max(0, run.delivered - controls.replayOverlap);
+            flush(run);
+        },
+        async stop(target) {
+            await wait(controls.stopDelay);
+            const run = runs.get(target.attemptId);
+            if (!run)
+                return 'not-found';
+            if (run.ended)
+                return 'already-finished';
+            switch (controls.stopBehavior) {
+                case 'fail':
+                    throw { code: 'ai.stop.failed', message: 'The stop request failed.', retryable: true };
+                case 'unknown':
+                    return 'unknown';
+                case 'already-finished':
+                    return 'already-finished';
+                case 'cancel':
+                    if (run.timer !== undefined)
+                        clearTimeout(run.timer);
+                    timers.delete(run.timer);
+                    run.timer = undefined;
+                    run.queue = [];
+                    run.waiting = undefined;
+                    produce(run, { type: 'abort', reason: 'stopped' });
+                    return 'cancelled';
+            }
+        },
+        async decide(decision) {
+            await wait(controls.decisionDelay);
+            if (controls.decisionOutcome === 'fail')
+                throw toPublicError({
+                    code: 'ai.approval.failed',
+                    message: 'The decision could not be recorded.',
+                    retryable: true,
+                }, {
+                    code: 'ai.approval.failed',
+                    message: 'The decision could not be recorded.',
+                });
+            const outcome = controls.decisionOutcome;
+            const run = runs.get(decision.attemptId);
+            if (outcome === 'accepted' && run && run.waiting === decision.approvalId && run.branches) {
+                const branch = decision.decision === 'approve' ? run.branches.approve : run.branches.reject;
+                run.waiting = undefined;
+                run.branches = undefined;
+                produce(run, {
+                    type: 'approval-resolved',
+                    approvalId: decision.approvalId,
+                    revision: decision.revision,
+                    status: decision.decision === 'approve' ? 'approved' : 'rejected',
+                });
+                run.queue = [...branch, ...run.queue];
+                advance(run);
+            }
+            return outcome;
+        },
+        async loadHistory(conversationId) {
+            await wait(controls.historyDelay);
+            const page = historyPages.shift();
+            if (!page)
+                return { conversationId, messages: [], hasMoreHistory: false };
+            return { ...page, hasMoreHistory: historyPages.length > 0 };
+        },
+        async submitFeedback(_feedback) {
+            await wait(controls.feedbackDelay);
+            if (controls.failFeedback)
+                throw {
+                    code: 'ai.feedback.failed',
+                    message: 'Feedback could not be sent.',
+                    retryable: true,
+                };
+        },
+        inject(attemptId, event) {
+            const run = runs.get(attemptId);
+            if (!run)
+                return;
+            run.ended = false;
+            produce(run, event);
+        },
+        dispose() {
+            for (const id of timers)
+                clearTimeout(id);
+            timers.clear();
+            for (const run of runs.values())
+                run.timer = undefined;
+        },
+    };
+    return transport;
+}
+// ---- Script helpers ----
+/** Split text into streamed deltas of `size` code points (never inside a surrogate pair). */
+export function chunkText(text, size = 6) {
+    const points = Array.from(text);
+    const out = [];
+    for (let i = 0; i < points.length; i += size)
+        out.push(points.slice(i, i + size).join(''));
+    return out;
+}
+/** Steps streaming `text` into one text part. */
+export function streamTextSteps(partId, text, every = 30, size = 6) {
+    return [
+        { after: every, event: { type: 'text-start', partId } },
+        ...chunkText(text, size).map((delta) => ({
+            after: every,
+            event: { type: 'text-delta', partId, delta },
+        })),
+        { after: every, event: { type: 'text-end', partId } },
+    ];
+}
+//# sourceMappingURL=simulation.js.map

package/dist/stream/simulation.js.map

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

package/dist/stream/sse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Server-sent events parsing per the WHATWG HTML "event stream interpretation" rules: UTF-8
+ * decoding with a streaming decoder (multi-byte characters split across chunks are kept), one
+ * leading BOM stripped, CRLF / LF / CR line endings (a CR at a chunk end paired with a LF at the
+ * next chunk start counts once), comments, `field: value` with one optional space removed,
+ * `data` lines joined with LF, `id` without NULL persisting across events, `retry` digits only,
+ * and an unterminated event discarded at end of stream. DOM-free.
+ * https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+ */
+export interface SseEvent {
+    /** `event` field, or `message`. */
+    readonly type: string;
+    readonly data: string;
+    /** Last event id buffer at dispatch time (persists across events). */
+    readonly lastEventId: string;
+}
+export declare class SseParser {
+    #private;
+    constructor(emit: (event: SseEvent) => void, onRetry?: (ms: number) => void);
+    /** Feed decoded text. */
+    feed(text: string): void;
+    /** End of stream: a pending, unterminated event is discarded (as the specification requires). */
+    end(): void;
+}
+/** Synchronous byte-level decoder: push arbitrary byte chunks, receive complete events. */
+export declare function createSseDecoder(onRetry?: (ms: number) => void): {
+    push(bytes: Uint8Array): SseEvent[];
+    end(): SseEvent[];
+};
+/** Read events from a byte stream (e.g. `response.body`). Stops when `signal` aborts. */
+export declare function readSse(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<SseEvent, void, undefined>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/stream/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/stream/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,SAAS;;IAWpB,YAAY,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAG1E;IAED,yBAAyB;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2BvB;IAED,iGAAiG;IACjG,GAAG,IAAI,IAAI,CAMV;CA0CF;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG;IAChE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE,CAAC;IACpC,GAAG,IAAI,QAAQ,EAAE,CAAC;CACnB,CAoBA;AAED,yFAAyF;AACzF,wBAAuB,OAAO,CAC5B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAiB3C"}

package/dist/stream/sse.js

@@ -0,0 +1,155 @@
+/**
+ * Server-sent events parsing per the WHATWG HTML "event stream interpretation" rules: UTF-8
+ * decoding with a streaming decoder (multi-byte characters split across chunks are kept), one
+ * leading BOM stripped, CRLF / LF / CR line endings (a CR at a chunk end paired with a LF at the
+ * next chunk start counts once), comments, `field: value` with one optional space removed,
+ * `data` lines joined with LF, `id` without NULL persisting across events, `retry` digits only,
+ * and an unterminated event discarded at end of stream. DOM-free.
+ * https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation
+ */
+export class SseParser {
+    #buffer = '';
+    #pendingCR = false;
+    #data = '';
+    #hasData = false;
+    #type = '';
+    #lastEventId = '';
+    #started = false;
+    #emit;
+    #retry;
+    constructor(emit, onRetry) {
+        this.#emit = emit;
+        this.#retry = onRetry;
+    }
+    /** Feed decoded text. */
+    feed(text) {
+        if (!this.#started) {
+            this.#started = text.length > 0;
+            if (text.charCodeAt(0) === 0xfeff)
+                text = text.slice(1);
+        }
+        let start = 0;
+        for (let i = 0; i < text.length; i++) {
+            const code = text.charCodeAt(i);
+            if (this.#pendingCR) {
+                this.#pendingCR = false;
+                if (code === 0x0a && i === start && this.#buffer === '') {
+                    start = i + 1;
+                    continue;
+                }
+            }
+            if (code === 0x0a || code === 0x0d) {
+                this.#line(this.#buffer + text.slice(start, i));
+                this.#buffer = '';
+                if (code === 0x0d) {
+                    if (i + 1 < text.length) {
+                        if (text.charCodeAt(i + 1) === 0x0a)
+                            i++;
+                    }
+                    else
+                        this.#pendingCR = true;
+                }
+                start = i + 1;
+            }
+        }
+        this.#buffer += text.slice(start);
+    }
+    /** End of stream: a pending, unterminated event is discarded (as the specification requires). */
+    end() {
+        this.#buffer = '';
+        this.#data = '';
+        this.#hasData = false;
+        this.#type = '';
+        this.#pendingCR = false;
+    }
+    #line(line) {
+        if (line === '')
+            return this.#dispatch();
+        if (line.charCodeAt(0) === 0x3a)
+            return; // comment
+        const colon = line.indexOf(':');
+        let field = line;
+        let value = '';
+        if (colon !== -1) {
+            field = line.slice(0, colon);
+            value = line.slice(colon + 1);
+            if (value.charCodeAt(0) === 0x20)
+                value = value.slice(1);
+        }
+        switch (field) {
+            case 'event':
+                this.#type = value;
+                break;
+            case 'data':
+                this.#data += `${value}\n`;
+                this.#hasData = true;
+                break;
+            case 'id':
+                if (!value.includes('\u0000'))
+                    this.#lastEventId = value;
+                break;
+            case 'retry':
+                if (/^[0-9]+$/.test(value))
+                    this.#retry?.(Number(value));
+                break;
+        }
+    }
+    #dispatch() {
+        if (!this.#hasData) {
+            this.#type = '';
+            return;
+        }
+        const data = this.#data.endsWith('\n') ? this.#data.slice(0, -1) : this.#data;
+        const event = { type: this.#type || 'message', data, lastEventId: this.#lastEventId };
+        this.#data = '';
+        this.#hasData = false;
+        this.#type = '';
+        this.#emit(event);
+    }
+}
+/** Synchronous byte-level decoder: push arbitrary byte chunks, receive complete events. */
+export function createSseDecoder(onRetry) {
+    const decoder = new TextDecoder('utf-8');
+    let out = [];
+    const parser = new SseParser((event) => out.push(event), onRetry);
+    const take = () => {
+        const events = out;
+        out = [];
+        return events;
+    };
+    return {
+        push(bytes) {
+            parser.feed(decoder.decode(bytes, { stream: true }));
+            return take();
+        },
+        end() {
+            parser.feed(decoder.decode());
+            parser.end();
+            return take();
+        },
+    };
+}
+/** Read events from a byte stream (e.g. `response.body`). Stops when `signal` aborts. */
+export async function* readSse(stream, signal) {
+    const reader = stream.getReader();
+    const decoder = createSseDecoder();
+    const onAbort = () => void reader.cancel(signal?.reason).catch(() => { });
+    signal?.addEventListener('abort', onAbort, { once: true });
+    try {
+        for (;;) {
+            if (signal?.aborted)
+                return;
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            yield* decoder.push(value);
+        }
+        if (!signal?.aborted)
+            yield* decoder.end();
+    }
+    finally {
+        signal?.removeEventListener('abort', onAbort);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/stream/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/stream/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,OAAO,SAAS;IACpB,OAAO,GAAG,EAAE,CAAC;IACb,UAAU,GAAG,KAAK,CAAC;IACnB,KAAK,GAAG,EAAE,CAAC;IACX,QAAQ,GAAG,KAAK,CAAC;IACjB,KAAK,GAAG,EAAE,CAAC;IACX,YAAY,GAAG,EAAE,CAAC;IAClB,QAAQ,GAAG,KAAK,CAAC;IACR,KAAK,CAA4B;IACjC,MAAM,CAAqC;IAEpD,YAAY,IAA+B,EAAE,OAA8B;QACzE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,yBAAyB;IACzB,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;gBACxB,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;oBACxD,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,SAAS;gBACX,CAAC;YACH,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBAChD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;gBAClB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;wBACxB,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;4BAAE,CAAC,EAAE,CAAC;oBAC3C,CAAC;;wBAAM,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBAChC,CAAC;gBACD,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,iGAAiG;IACjG,GAAG;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,UAAU;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC7B,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;gBACnB,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC;gBAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,IAAI;gBACP,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;gBACzD,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzD,MAAM;QACV,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9E,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACtF,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;CACF;AAED,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,OAA8B;IAI7D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,GAAG,GAAe,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,MAAM,MAAM,GAAG,GAAG,CAAC;QACnB,GAAG,GAAG,EAAE,CAAC;QACT,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,OAAO;QACL,IAAI,CAAC,KAAK;YACR,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,GAAG;YACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,CAC5B,MAAkC,EAClC,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,SAAS,CAAC;YACR,IAAI,MAAM,EAAE,OAAO;gBAAE,OAAO;YAC5B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,OAAO;YAAE,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7C,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}