@holokai/holo-sdk 1.4.1

package/dist/client/merge.js

@@ -0,0 +1,185 @@
+/**
+ * Accumulates {@link HoloStreamEvent} deltas into a complete {@link HoloResponse}.
+ *
+ * Feed events via {@link push}, then call {@link toResponse} to get the assembled result.
+ * Used internally by {@link HoloStream} but can also be used standalone.
+ */
+export class HoloStreamAccumulator {
+    id = '';
+    model;
+    created;
+    textParts = [];
+    reasoningParts = [];
+    toolCalls = new Map();
+    invalidToolCalls = [];
+    usage;
+    finishReason = null;
+    /** Process a single stream event, merging its data into the accumulated state. */
+    push(event) {
+        switch (event.type) {
+            case 'response.created':
+                if (event.response) {
+                    if (event.response.id)
+                        this.id = event.response.id;
+                    this.model = event.response.model;
+                    this.created = event.response.created;
+                }
+                break;
+            case 'response.output_text.delta':
+                if (event.delta) {
+                    this.textParts.push(event.delta);
+                }
+                break;
+            case 'response.reasoning.delta':
+                if (event.delta) {
+                    this.reasoningParts.push(event.delta);
+                }
+                break;
+            case 'response.tool_call.delta':
+                if (event.tool_call_delta && event.index !== undefined) {
+                    const existing = this.toolCalls.get(event.index) ?? { name: '', arguments: '' };
+                    if (event.tool_call_delta.id)
+                        existing.id = event.tool_call_delta.id;
+                    if (event.tool_call_delta.name)
+                        existing.name += event.tool_call_delta.name;
+                    if (event.tool_call_delta.arguments_delta)
+                        existing.arguments += event.tool_call_delta.arguments_delta;
+                    this.toolCalls.set(event.index, existing);
+                }
+                break;
+            case 'response.content_block.start':
+            case 'response.content_block.delta':
+            case 'response.content_block.stop':
+            case 'response.message.start':
+            case 'response.message.stop':
+                break;
+            case 'response.usage':
+                if (event.usage)
+                    this.usage = event.usage;
+                break;
+            case 'response.completed':
+                if (event.response)
+                    return;
+                if (event.usage)
+                    this.usage = event.usage;
+                if (event.finish_reason !== undefined)
+                    this.finishReason = event.finish_reason;
+                break;
+            case 'response.failed':
+                this.finishReason = 'error';
+                break;
+        }
+    }
+    /** Assemble all accumulated deltas into a complete {@link HoloResponse}. */
+    toResponse() {
+        const text = this.textParts.join('');
+        const reasoning = this.reasoningParts.join('');
+        const hasText = text.length > 0;
+        const hasReasoning = reasoning.length > 0;
+        const hasToolCalls = this.toolCalls.size > 0;
+        const output = [];
+        if (hasText || hasReasoning || hasToolCalls) {
+            const isStructured = hasReasoning || hasToolCalls;
+            if (isStructured) {
+                const contentBlocks = [];
+                if (hasReasoning) {
+                    const block = { type: 'reasoning' };
+                    block.text = reasoning;
+                    contentBlocks.push(block);
+                }
+                if (hasText) {
+                    const block = { type: 'text', text };
+                    contentBlocks.push(block);
+                }
+                if (hasToolCalls) {
+                    const toolCallBlocks = this.buildToolCallBlocks();
+                    contentBlocks.push(...toolCallBlocks);
+                }
+                const message = { role: 'assistant', content: contentBlocks };
+                if (hasToolCalls) {
+                    message.tool_calls = this.buildToolCallProjections();
+                    if (this.invalidToolCalls.length > 0) {
+                        message.invalid_tool_calls = this.invalidToolCalls;
+                    }
+                }
+                output.push(message);
+            }
+            else {
+                output.push({ role: 'assistant', content: text });
+            }
+        }
+        const response = {
+            model: this.model ?? '',
+            output,
+            created: this.created ?? Date.now(),
+            finish_reason: this.finishReason,
+            usage: this.usage ?? {},
+        };
+        if (this.id)
+            response.id = this.id;
+        return response;
+    }
+    /** Return the concatenated text output accumulated so far. */
+    getText() {
+        return this.textParts.join('');
+    }
+    buildToolCallBlocks() {
+        const blocks = [];
+        for (const [, tc] of [...this.toolCalls.entries()].sort((a, b) => a[0] - b[0])) {
+            const parsed = this.parseArguments(tc.arguments);
+            const block = {
+                type: 'tool_call',
+                name: tc.name,
+                arguments: parsed ?? {},
+            };
+            if (tc.id)
+                block.id = tc.id;
+            if (parsed === null) {
+                block.raw_arguments = tc.arguments;
+                const invalid = {
+                    error: 'Failed to parse tool call arguments as JSON',
+                    raw_arguments: tc.arguments,
+                };
+                if (tc.id)
+                    invalid.id = tc.id;
+                if (tc.name)
+                    invalid.name = tc.name;
+                this.invalidToolCalls.push(invalid);
+            }
+            blocks.push(block);
+        }
+        return blocks;
+    }
+    buildToolCallProjections() {
+        const calls = [];
+        for (const [, tc] of [...this.toolCalls.entries()].sort((a, b) => a[0] - b[0])) {
+            const parsed = this.parseArguments(tc.arguments);
+            const call = {
+                type: 'function',
+                function: {
+                    name: tc.name,
+                    arguments: parsed ?? {},
+                },
+            };
+            if (tc.id)
+                call.id = tc.id;
+            calls.push(call);
+        }
+        return calls;
+    }
+    parseArguments(raw) {
+        if (!raw)
+            return {};
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+            return {};
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=merge.js.map

package/dist/client/merge.js.map

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

package/dist/client/output.d.ts

@@ -0,0 +1,26 @@
+import type { HoloInvalidToolCall, HoloMessage, HoloResponse, HoloToolCall } from '@holokai/holo-types/holo';
+/** Extract concatenated text from a single message. Returns `''` if content is not text-based. */
+export declare function getMessageText(message: HoloMessage): string;
+/** Extract concatenated reasoning text from a single message. Returns `''` if no reasoning blocks. */
+export declare function getMessageReasoning(message: HoloMessage): string;
+/**
+ * Extract tool calls from a single message.
+ * Prefers `message.tool_calls` projection if present and non-empty; otherwise falls back to content blocks.
+ */
+export declare function getMessageToolCalls(message: HoloMessage): HoloToolCall[];
+/** Extract invalid tool calls from a single message. */
+export declare function getMessageInvalidToolCalls(message: HoloMessage): HoloInvalidToolCall[];
+/** Aggregation helpers for extracting structured data from a {@link HoloResponse}. */
+export declare const HoloOutput: {
+    /** Concatenate all assistant text across output messages. */
+    text(response: HoloResponse): string;
+    /** Concatenate all reasoning text across output messages. */
+    reasoning(response: HoloResponse): string;
+    /** Collect all tool calls across output messages in order. */
+    toolCalls(response: HoloResponse): HoloToolCall[];
+    /** Collect all invalid tool calls across output messages in order. */
+    invalidToolCalls(response: HoloResponse): HoloInvalidToolCall[];
+    /** Return the last message in the output array, or `undefined` if empty. */
+    lastMessage(response: HoloResponse): HoloMessage | undefined;
+};
+//# sourceMappingURL=output.d.ts.map

package/dist/client/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/client/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,mBAAmB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG5G,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAM3D;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAMhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,EAAE,CAexE;AAED,wDAAwD;AACxD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB,EAAE,CAEtF;AAED,sFAAsF;AACtF,eAAO,MAAM,UAAU;IACnB,6DAA6D;mBAC9C,YAAY,GAAG,MAAM;IAOpC,6DAA6D;wBACzC,YAAY,GAAG,MAAM;IAOzC,8DAA8D;wBAC1C,YAAY,GAAG,YAAY,EAAE;IAIjD,sEAAsE;+BAC3C,YAAY,GAAG,mBAAmB,EAAE;IAI/D,4EAA4E;0BACtD,YAAY,GAAG,WAAW,GAAG,SAAS;CAG/D,CAAC"}

package/dist/client/output.js

@@ -0,0 +1,75 @@
+import { isReasoningContent, isTextContent, isToolCallContent } from '../holo';
+/** Extract concatenated text from a single message. Returns `''` if content is not text-based. */
+export function getMessageText(message) {
+    if (typeof message.content === 'string')
+        return message.content;
+    return message.content
+        .filter(isTextContent)
+        .map(b => b.text)
+        .join('');
+}
+/** Extract concatenated reasoning text from a single message. Returns `''` if no reasoning blocks. */
+export function getMessageReasoning(message) {
+    if (typeof message.content === 'string')
+        return '';
+    return message.content
+        .filter(isReasoningContent)
+        .map(b => b.text ?? '')
+        .join('');
+}
+/**
+ * Extract tool calls from a single message.
+ * Prefers `message.tool_calls` projection if present and non-empty; otherwise falls back to content blocks.
+ */
+export function getMessageToolCalls(message) {
+    if (message.tool_calls && message.tool_calls.length > 0) {
+        return message.tool_calls;
+    }
+    if (!Array.isArray(message.content))
+        return [];
+    return message.content
+        .filter(isToolCallContent)
+        .map(block => {
+        const call = {
+            type: 'function',
+            function: { name: block.name, arguments: block.arguments },
+        };
+        if (block.id)
+            call.id = block.id;
+        return call;
+    });
+}
+/** Extract invalid tool calls from a single message. */
+export function getMessageInvalidToolCalls(message) {
+    return message.invalid_tool_calls ?? [];
+}
+/** Aggregation helpers for extracting structured data from a {@link HoloResponse}. */
+export const HoloOutput = {
+    /** Concatenate all assistant text across output messages. */
+    text(response) {
+        return response.output
+            .filter(m => m.role === 'assistant')
+            .map(getMessageText)
+            .join('');
+    },
+    /** Concatenate all reasoning text across output messages. */
+    reasoning(response) {
+        return response.output
+            .filter(m => m.role === 'assistant')
+            .map(getMessageReasoning)
+            .join('');
+    },
+    /** Collect all tool calls across output messages in order. */
+    toolCalls(response) {
+        return response.output.flatMap(getMessageToolCalls);
+    },
+    /** Collect all invalid tool calls across output messages in order. */
+    invalidToolCalls(response) {
+        return response.output.flatMap(getMessageInvalidToolCalls);
+    },
+    /** Return the last message in the output array, or `undefined` if empty. */
+    lastMessage(response) {
+        return response.output[response.output.length - 1];
+    },
+};
+//# sourceMappingURL=output.js.map

package/dist/client/output.js.map

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

package/dist/client/runner.d.ts

@@ -0,0 +1,92 @@
+import type { HoloContent, HoloMessage, HoloResponse, HoloTool, HoloToolChoice } from '@holokai/holo-types/holo';
+import type { HoloStream } from './stream';
+import type { HoloChatParams } from './types';
+/** Extracted tool call information passed to the user's tool handler. */
+export interface HoloToolCallInfo {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * The result returned by a tool handler, sent back to the model as a tool message.
+ * @see {@link HoloContentToolResult} for the content-block representation.
+ */
+export interface HoloToolResult {
+    tool_call_id: string;
+    content: string | HoloContent[];
+    is_error?: boolean;
+}
+/**
+ * Configuration for {@link HoloToolRunner}.
+ *
+ * @example
+ * ```ts
+ * const runner = client.chat.runner({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'What is the weather in SF?' }],
+ *   tools: [weatherTool],
+ *   toolHandler: async (call) => {
+ *     const result = await executeWeatherLookup(call.arguments);
+ *     return { tool_call_id: call.id, content: JSON.stringify(result) };
+ *   },
+ * });
+ * const response = await runner.finalResponse();
+ * ```
+ */
+export interface HoloToolRunnerOptions {
+    messages: HoloMessage[];
+    tools: HoloTool[];
+    /** Async callback invoked for each tool call. Return the result to feed back to the model. */
+    toolHandler: (call: HoloToolCallInfo) => Promise<HoloToolResult>;
+    model?: string;
+    application?: string;
+    provider?: string;
+    thread_id?: string;
+    branch?: string;
+    temperature?: number;
+    max_tokens?: number;
+    tool_choice?: HoloToolChoice;
+    /** Maximum number of tool-call round-trips before returning the last response (default: 50). */
+    maxIterations?: number;
+}
+type EventHandler<T> = (data: T) => void;
+type RunnerEventMap = {
+    'text.delta': string;
+    'tool_calls': HoloToolCallInfo[];
+    'tool_result': {
+        id: string;
+        result: HoloToolResult;
+    };
+    'iteration': {
+        index: number;
+        response: HoloResponse;
+    };
+    'error': Error;
+};
+type RunnerEventType = keyof RunnerEventMap;
+/**
+ * Agentic tool-use loop that streams requests, executes tool calls, and feeds results back until the model stops calling tools.
+ *
+ * @remarks Create via {@link ChatNamespace.runner} rather than constructing directly.
+ *
+ * @see {@link HoloToolRunnerOptions} for configuration.
+ * @see {@link HoloStream} for the underlying streaming interface.
+ */
+export declare class HoloToolRunner {
+    private readonly options;
+    private readonly streamFn;
+    private handlers;
+    private abortController;
+    private aborted;
+    private currentStream;
+    constructor(streamFn: (params: HoloChatParams) => Promise<HoloStream>, options: HoloToolRunnerOptions);
+    /** Register an event handler for runner lifecycle events. */
+    on<K extends RunnerEventType>(event: K, fn: EventHandler<RunnerEventMap[K]>): this;
+    /** Abort the runner, cancelling any in-flight stream. */
+    abort(): void;
+    /** Execute the tool loop and return the final model response (after all tool calls are resolved). */
+    finalResponse(): Promise<HoloResponse>;
+    private emit;
+}
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/client/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/client/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAChH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAG5C,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8FAA8F;IAC9F,WAAW,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzC,KAAK,cAAc,GAAG;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,aAAa,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC;IACtD,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IACvD,OAAO,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,KAAK,eAAe,GAAG,MAAM,cAAc,CAAC;AAE5C;;;;;;;GAOG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;IAC3E,OAAO,CAAC,QAAQ,CAAmD;IACnE,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAyB;gBAG1C,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,EACzD,OAAO,EAAE,qBAAqB;IAMlC,6DAA6D;IAC7D,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAOlF,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAMb,qGAAqG;IAC/F,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAiF5C,OAAO,CAAC,IAAI;CAWf"}

package/dist/client/runner.js

@@ -0,0 +1,121 @@
+import { HoloOutput } from './output';
+/**
+ * Agentic tool-use loop that streams requests, executes tool calls, and feeds results back until the model stops calling tools.
+ *
+ * @remarks Create via {@link ChatNamespace.runner} rather than constructing directly.
+ *
+ * @see {@link HoloToolRunnerOptions} for configuration.
+ * @see {@link HoloStream} for the underlying streaming interface.
+ */
+export class HoloToolRunner {
+    options;
+    streamFn;
+    handlers = new Map();
+    abortController = new AbortController();
+    aborted = false;
+    currentStream;
+    constructor(streamFn, options) {
+        this.streamFn = streamFn;
+        this.options = options;
+    }
+    /** Register an event handler for runner lifecycle events. */
+    on(event, fn) {
+        const handlers = this.handlers.get(event) ?? [];
+        handlers.push(fn);
+        this.handlers.set(event, handlers);
+        return this;
+    }
+    /** Abort the runner, cancelling any in-flight stream. */
+    abort() {
+        this.aborted = true;
+        this.currentStream?.abort();
+        this.abortController.abort();
+    }
+    /** Execute the tool loop and return the final model response (after all tool calls are resolved). */
+    async finalResponse() {
+        const maxIterations = this.options.maxIterations ?? 50;
+        const messages = [...this.options.messages];
+        let lastResponse;
+        for (let i = 0; i < maxIterations; i++) {
+            if (this.aborted) {
+                throw new Error('Runner aborted');
+            }
+            const params = { messages };
+            if (this.options.model !== undefined)
+                params.model = this.options.model;
+            if (this.options.tools)
+                params.tools = this.options.tools;
+            if (this.options.tool_choice)
+                params.tool_choice = this.options.tool_choice;
+            if (this.options.application !== undefined)
+                params.application = this.options.application;
+            if (this.options.provider !== undefined)
+                params.provider = this.options.provider;
+            if (this.options.thread_id !== undefined)
+                params.thread_id = this.options.thread_id;
+            if (this.options.branch !== undefined)
+                params.branch = this.options.branch;
+            if (this.options.temperature !== undefined)
+                params.temperature = this.options.temperature;
+            if (this.options.max_tokens !== undefined)
+                params.max_tokens = this.options.max_tokens;
+            const stream = await this.streamFn(params);
+            this.currentStream = stream;
+            stream.on('response.output_text.delta', (delta) => {
+                this.emit('text.delta', delta);
+            });
+            const response = await stream.finalResponse();
+            this.currentStream = undefined;
+            lastResponse = response;
+            this.emit('iteration', { index: i, response });
+            const hasToolCallsInOutput = response.output?.some((m) => m.tool_calls?.length || (Array.isArray(m.content) && m.content.some((b) => b.type === 'tool_call')));
+            if (response.finish_reason !== 'tool_calls' && !hasToolCallsInOutput) {
+                return response;
+            }
+            const rawCalls = HoloOutput.toolCalls(response);
+            const toolCalls = rawCalls.map(tc => ({
+                id: tc.id ?? '',
+                name: tc.function.name,
+                arguments: tc.function.arguments,
+            }));
+            if (toolCalls.length === 0) {
+                return response;
+            }
+            this.emit('tool_calls', toolCalls);
+            const assistantMessage = response.output?.[response.output.length - 1];
+            if (assistantMessage) {
+                messages.push(assistantMessage);
+            }
+            const results = await Promise.all(toolCalls.map(async (call) => {
+                const result = await this.options.toolHandler(call);
+                this.emit('tool_result', { id: call.id, result });
+                return result;
+            }));
+            for (const result of results) {
+                const toolMessage = {
+                    role: 'tool',
+                    content: result.content,
+                    tool_call_id: result.tool_call_id,
+                };
+                messages.push(toolMessage);
+            }
+        }
+        if (lastResponse)
+            return lastResponse;
+        throw new Error('Runner did not produce a response');
+    }
+    emit(event, data) {
+        const handlers = this.handlers.get(event);
+        if (!handlers?.length)
+            return;
+        for (const h of handlers) {
+            try {
+                h(data);
+            }
+            catch (e) {
+                this.emit('error', e instanceof Error ? e : new Error(String(e)));
+            }
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/client/runner.js.map

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

package/dist/client/sse.d.ts

@@ -0,0 +1,3 @@
+import type { HoloStreamEvent } from '@holokai/holo-types/holo';
+export declare function parseSSEStream(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<HoloStreamEvent>;
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/client/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAE9D,wBAAuB,cAAc,CACjC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,GACrB,cAAc,CAAC,eAAe,CAAC,CAmCjC"}

package/dist/client/sse.js

@@ -0,0 +1,72 @@
+export async function* parseSSEStream(body, signal) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            if (signal?.aborted)
+                break;
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            buffer = buffer.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+            const events = extractEvents(buffer);
+            buffer = events.remaining;
+            for (const event of events.parsed) {
+                yield event;
+            }
+        }
+        // Flush any remaining bytes from the decoder
+        const flushed = decoder.decode();
+        if (flushed) {
+            buffer += flushed.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+            const events = extractEvents(buffer);
+            for (const event of events.parsed) {
+                yield event;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function extractEvents(buffer) {
+    const parsed = [];
+    let remaining = buffer;
+    while (true) {
+        const doubleNewline = remaining.indexOf('\n\n');
+        if (doubleNewline === -1)
+            break;
+        const block = remaining.slice(0, doubleNewline);
+        remaining = remaining.slice(doubleNewline + 2);
+        const event = parseSSEBlock(block);
+        if (event) {
+            parsed.push(event);
+        }
+    }
+    return { parsed, remaining };
+}
+function parseSSEBlock(block) {
+    const dataLines = [];
+    for (const line of block.split('\n')) {
+        if (line.startsWith('data: ')) {
+            dataLines.push(line.slice(6));
+        }
+        else if (line.startsWith('data:')) {
+            dataLines.push(line.slice(5));
+        }
+    }
+    if (dataLines.length === 0)
+        return null;
+    const data = dataLines.join('\n');
+    if (data === '[DONE]')
+        return null;
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/client/sse.js.map

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