@holokai/holo-sdk 1.4.1

package/dist/client/stream.d.ts

@@ -0,0 +1,60 @@
+import type { HoloResponse, HoloStreamEvent } from '@holokai/holo-types/holo';
+type EventHandler<T> = (data: T) => void;
+interface ToolCallDelta {
+    id?: string;
+    name?: string;
+    arguments_delta?: string;
+}
+/**
+ * Async-iterable stream of {@link HoloStreamEvent} objects from a streaming chat request.
+ *
+ * Can be consumed in three ways:
+ * 1. **`for await`** — iterate over raw events
+ * 2. **`.on()`** — register typed event handlers, then iterate or call a terminal method
+ * 3. **`.text()` / `.finalResponse()`** — convenience methods that consume the stream and return the result
+ *
+ * @remarks A `HoloStream` can only be iterated once. Call {@link abort} to cancel an in-flight stream.
+ *
+ * @example
+ * ```ts
+ * const stream = await client.chat.stream({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello' }],
+ * });
+ *
+ * for await (const event of stream) {
+ *   if (event.type === 'response.output_text.delta') {
+ *     process.stdout.write(event.delta ?? '');
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link HoloStreamEvent} for the event payload shape.
+ * @see {@link HoloStreamAccumulator} for the underlying delta-merging logic.
+ */
+export declare class HoloStream implements AsyncIterable<HoloStreamEvent> {
+    private readonly events;
+    private readonly abortController;
+    private readonly accumulator;
+    private completedResponse?;
+    private failedError?;
+    private iterationStarted;
+    private eventHandlers;
+    constructor(events: AsyncGenerator<HoloStreamEvent>, abortController: AbortController);
+    [Symbol.asyncIterator](): AsyncIterator<HoloStreamEvent>;
+    on(event: 'response.output_text.delta', fn: EventHandler<string>): this;
+    on(event: 'response.tool_call.delta', fn: EventHandler<ToolCallDelta>): this;
+    on(event: 'response.reasoning.delta', fn: EventHandler<string>): this;
+    on(event: 'response.completed', fn: EventHandler<HoloResponse>): this;
+    on(event: 'response.failed', fn: EventHandler<Error>): this;
+    /** Consume the entire stream and return the concatenated text output. */
+    text(): Promise<string>;
+    /** Consume the entire stream and return the assembled {@link HoloResponse}. */
+    finalResponse(): Promise<HoloResponse>;
+    /** Cancel the in-flight stream. */
+    abort(): void;
+    private consume;
+    private dispatchEvent;
+}
+export {};
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/client/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAI5E,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzC,UAAU,aAAa;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,UAAW,YAAW,aAAa,CAAC,eAAe,CAAC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,iBAAiB,CAAC,CAAe;IACzC,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAA+C;gBAExD,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,EAAE,eAAe,EAAE,eAAe;IAKrF,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC;IA4BxD,EAAE,CAAC,KAAK,EAAE,4BAA4B,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI;IACvE,EAAE,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAAE,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI;IAC5E,EAAE,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAAE,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI;IACrE,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,IAAI;IACrE,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI;IAS3D,yEAAyE;IACnE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAM7B,+EAA+E;IACzE,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAgB5C,mCAAmC;IACnC,KAAK,IAAI,IAAI;YAIC,OAAO;IAQrB,OAAO,CAAC,aAAa;CAsBxB"}

package/dist/client/stream.js

@@ -0,0 +1,137 @@
+import { HoloStreamAccumulator } from './merge';
+import { HoloStreamError } from './errors';
+/**
+ * Async-iterable stream of {@link HoloStreamEvent} objects from a streaming chat request.
+ *
+ * Can be consumed in three ways:
+ * 1. **`for await`** — iterate over raw events
+ * 2. **`.on()`** — register typed event handlers, then iterate or call a terminal method
+ * 3. **`.text()` / `.finalResponse()`** — convenience methods that consume the stream and return the result
+ *
+ * @remarks A `HoloStream` can only be iterated once. Call {@link abort} to cancel an in-flight stream.
+ *
+ * @example
+ * ```ts
+ * const stream = await client.chat.stream({
+ *   model: 'gpt-4o',
+ *   messages: [{ role: 'user', content: 'Hello' }],
+ * });
+ *
+ * for await (const event of stream) {
+ *   if (event.type === 'response.output_text.delta') {
+ *     process.stdout.write(event.delta ?? '');
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link HoloStreamEvent} for the event payload shape.
+ * @see {@link HoloStreamAccumulator} for the underlying delta-merging logic.
+ */
+export class HoloStream {
+    events;
+    abortController;
+    accumulator = new HoloStreamAccumulator();
+    completedResponse;
+    failedError;
+    iterationStarted = false;
+    eventHandlers = new Map();
+    constructor(events, abortController) {
+        this.events = events;
+        this.abortController = abortController;
+    }
+    [Symbol.asyncIterator]() {
+        if (this.iterationStarted) {
+            throw new Error('HoloStream can only be iterated once');
+        }
+        this.iterationStarted = true;
+        const self = this;
+        return {
+            async next() {
+                const result = await self.events.next();
+                if (result.done)
+                    return { done: true, value: undefined };
+                const event = result.value;
+                self.accumulator.push(event);
+                self.dispatchEvent(event);
+                if (event.type === 'response.completed' && event.response) {
+                    self.completedResponse = event.response;
+                }
+                if (event.type === 'response.failed') {
+                    self.failedError = new HoloStreamError(event.error?.message ?? 'Stream failed', event);
+                }
+                return { done: false, value: event };
+            },
+        };
+    }
+    /** Register an event handler. Handlers fire during iteration (either explicit or via terminal methods). */
+    on(event, fn) {
+        const handlers = this.eventHandlers.get(event) ?? [];
+        handlers.push(fn);
+        this.eventHandlers.set(event, handlers);
+        return this;
+    }
+    /** Consume the entire stream and return the concatenated text output. */
+    async text() {
+        await this.consume();
+        if (this.failedError)
+            throw this.failedError;
+        return this.accumulator.getText();
+    }
+    /** Consume the entire stream and return the assembled {@link HoloResponse}. */
+    async finalResponse() {
+        await this.consume();
+        if (this.failedError)
+            throw this.failedError;
+        const accumulated = this.accumulator.toResponse();
+        // If the server says tool_calls but the completedResponse is missing them, use accumulator
+        if (this.completedResponse?.finish_reason === 'tool_calls') {
+            const hasToolCalls = this.completedResponse.output?.some((m) => m.tool_calls?.length || (Array.isArray(m.content) && m.content.some((b) => b.type === 'tool_call')));
+            if (!hasToolCalls && accumulated.output?.length)
+                return accumulated;
+        }
+        if (this.completedResponse?.output?.length)
+            return this.completedResponse;
+        if (accumulated.output.length)
+            return accumulated;
+        return this.completedResponse ?? accumulated;
+    }
+    /** Cancel the in-flight stream. */
+    abort() {
+        this.abortController.abort();
+    }
+    async consume() {
+        if (this.completedResponse || this.failedError)
+            return;
+        for await (const _event of this) {
+            // iteration handles accumulation via [Symbol.asyncIterator]
+        }
+    }
+    dispatchEvent(event) {
+        const handlers = this.eventHandlers.get(event.type);
+        if (!handlers?.length)
+            return;
+        switch (event.type) {
+            case 'response.output_text.delta':
+                for (const h of handlers)
+                    h(event.delta ?? '');
+                break;
+            case 'response.reasoning.delta':
+                for (const h of handlers)
+                    h(event.delta ?? '');
+                break;
+            case 'response.tool_call.delta':
+                for (const h of handlers)
+                    h(event.tool_call_delta ?? {});
+                break;
+            case 'response.completed':
+                for (const h of handlers)
+                    h(event.response ?? this.accumulator.toResponse());
+                break;
+            case 'response.failed':
+                for (const h of handlers)
+                    h(new HoloStreamError(event.error?.message ?? 'Stream failed', event));
+                break;
+        }
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/client/stream.js.map

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

package/dist/client/transport.d.ts

@@ -0,0 +1,42 @@
+interface TransportRequestOptions {
+    method: string;
+    path: string;
+    body?: unknown | undefined;
+    signal?: AbortSignal | undefined;
+    headers?: Record<string, string> | undefined;
+}
+interface TransportStreamOptions {
+    path: string;
+    body: unknown;
+    signal?: AbortSignal | undefined;
+    headers?: Record<string, string> | undefined;
+}
+interface TransportStreamResult {
+    body: ReadableStream<Uint8Array>;
+    response: Response;
+}
+interface HoloTransport {
+    request<T>(options: TransportRequestOptions): Promise<T>;
+    streamRequest(options: TransportStreamOptions): Promise<TransportStreamResult>;
+}
+declare class FetchTransport implements HoloTransport {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly _fetch;
+    private readonly timeout?;
+    private readonly userAgent;
+    constructor(options: {
+        baseUrl: string;
+        token: string;
+        fetch?: typeof globalThis.fetch | undefined;
+        timeout?: number | undefined;
+    });
+    request<T>(options: TransportRequestOptions): Promise<T>;
+    streamRequest(options: TransportStreamOptions): Promise<TransportStreamResult>;
+    private handleErrorResponse;
+    private applyTimeout;
+    private classifyAbortError;
+}
+export { FetchTransport };
+export type { HoloTransport, TransportRequestOptions, TransportStreamOptions, TransportStreamResult };
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAEA,UAAU,uBAAuB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAChD;AAED,UAAU,sBAAsB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAChD;AAED,UAAU,qBAAqB;IAC3B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAKD,UAAU,aAAa;IACnB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzD,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAClF;AAeD,cAAM,cAAe,YAAW,aAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;QAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC;IAQK,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IA4BxD,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAgCtE,mBAAmB;IAwBjC,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,kBAAkB;CAa7B;AAED,OAAO,EAAC,cAAc,EAAC,CAAC;AACxB,YAAY,EAAC,aAAa,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,qBAAqB,EAAC,CAAC"}

package/dist/client/transport.js

@@ -0,0 +1,129 @@
+import { HoloApiError, HoloTimeoutError } from './errors';
+function getUserAgent() {
+    const base = 'holo-sdk-js';
+    try {
+        const { createRequire } = require('module');
+        const require_ = createRequire(import.meta.url);
+        const pkg = require_('../../../package.json');
+        if (pkg.version)
+            return `${base}/${pkg.version}`;
+    }
+    catch {
+        // Bundler or browser — silently degrade
+    }
+    return base;
+}
+class FetchTransport {
+    baseUrl;
+    token;
+    _fetch;
+    timeout;
+    userAgent;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.token = options.token;
+        this._fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        if (options.timeout !== undefined)
+            this.timeout = options.timeout;
+        this.userAgent = getUserAgent();
+    }
+    async request(options) {
+        const url = `${this.baseUrl}/holo/api/v1${options.path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.token}`,
+            'User-Agent': this.userAgent,
+            ...options.headers,
+        };
+        if (options.body)
+            headers['Content-Type'] = 'application/json';
+        const init = { method: options.method, headers };
+        if (options.body)
+            init.body = JSON.stringify(options.body);
+        const effectiveSignal = this.applyTimeout(options.signal);
+        if (effectiveSignal)
+            init.signal = effectiveSignal;
+        try {
+            const response = await this._fetch(url, init);
+            if (!response.ok) {
+                await this.handleErrorResponse(response);
+            }
+            return response.json();
+        }
+        catch (e) {
+            throw this.classifyAbortError(e, options.signal);
+        }
+    }
+    async streamRequest(options) {
+        const url = `${this.baseUrl}/holo/api/v1${options.path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.token}`,
+            'Content-Type': 'application/json',
+            'Accept': 'text/event-stream',
+            'User-Agent': this.userAgent,
+            ...options.headers,
+        };
+        const init = { method: 'POST', headers, body: JSON.stringify(options.body) };
+        const effectiveSignal = this.applyTimeout(options.signal);
+        if (effectiveSignal)
+            init.signal = effectiveSignal;
+        try {
+            const response = await this._fetch(url, init);
+            if (!response.ok) {
+                await this.handleErrorResponse(response);
+            }
+            if (!response.body) {
+                throw new HoloApiError('No response body for stream', 500);
+            }
+            return { body: response.body, response };
+        }
+        catch (e) {
+            throw this.classifyAbortError(e, options.signal);
+        }
+    }
+    async handleErrorResponse(response) {
+        let errorBody;
+        let code;
+        const text = await response.text();
+        try {
+            errorBody = JSON.parse(text);
+            const body = errorBody;
+            if (typeof body === 'object' && body !== null) {
+                code = typeof body.code === 'string' ? body.code
+                    : typeof body.error === 'object' && body.error !== null
+                        ? String(body.error.code ?? '')
+                        : undefined;
+            }
+        }
+        catch {
+            errorBody = text;
+        }
+        throw new HoloApiError(`HTTP ${response.status}: ${response.statusText}`, response.status, code || undefined, errorBody);
+    }
+    applyTimeout(externalSignal) {
+        if (!this.timeout && !externalSignal)
+            return undefined;
+        if (!this.timeout)
+            return externalSignal;
+        const timeoutSignal = AbortSignal.timeout(this.timeout);
+        if (!externalSignal)
+            return timeoutSignal;
+        return AbortSignal.any([externalSignal, timeoutSignal]);
+    }
+    classifyAbortError(e, externalSignal) {
+        if (e instanceof HoloApiError || e instanceof HoloTimeoutError)
+            return e;
+        if (e instanceof DOMException && e.name === 'AbortError') {
+            if (externalSignal?.aborted)
+                return e;
+            if (this.timeout)
+                return new HoloTimeoutError(this.timeout);
+        }
+        if (e instanceof DOMException && e.name === 'TimeoutError') {
+            if (this.timeout)
+                return new HoloTimeoutError(this.timeout);
+        }
+        return e;
+    }
+}
+export { FetchTransport };
+//# sourceMappingURL=transport.js.map

package/dist/client/transport.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,41 @@
+import type { HoloApplicationInfo, HoloCountTokensParams, HoloCountTokensResponse, HoloEmbedParams, HoloEmbedResponse, HoloGenerateParams, HoloMessage, HoloModelInfo, HoloModelListParams, HoloRequest, HoloRequestMetadata } from '@holokai/holo-types/holo';
+/** Parameters accepted by {@link ChatNamespace.create} and {@link ChatNamespace.stream}. */
+export interface HoloChatParams {
+    model?: string;
+    messages: HoloMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    top_k?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    seed?: number;
+    stop_sequences?: string[];
+    tools?: HoloRequest['tools'];
+    tool_choice?: HoloRequest['tool_choice'];
+    response_format?: HoloRequest['response_format'];
+    metadata?: HoloRequestMetadata | null;
+    service_tier?: HoloRequest['service_tier'];
+    provider?: string;
+    application?: string;
+    thread_id?: string;
+    branch?: string;
+    protocol?: string;
+}
+/** Configuration options for {@link HoloClient}. */
+export interface HoloClientOptions {
+    /** Base URL of the Holo API (e.g. `'https://holo.example.com'`). Trailing slashes are stripped. */
+    baseUrl: string;
+    /** Bearer token for authentication (JWT or HoloToken). */
+    token: string;
+    /** Model identifier used when no model is specified per-request. */
+    defaultModel?: string;
+    /** Application slug used when no application is specified per-request. */
+    defaultApplication?: string;
+    /** Custom `fetch` implementation (defaults to `globalThis.fetch`). Useful for testing or custom transports. */
+    fetch?: typeof globalThis.fetch;
+    /** Request timeout in milliseconds. */
+    timeout?: number;
+}
+export type { HoloModelInfo, HoloApplicationInfo, HoloRequest, HoloGenerateParams, HoloEmbedParams, HoloEmbedResponse, HoloCountTokensParams, HoloCountTokensResponse, HoloModelListParams, };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACtB,MAAM,0BAA0B,CAAC;AAElC,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAC9B,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+GAA+G;IAC/G,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EACR,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAC/C,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EACtD,qBAAqB,EAAE,uBAAuB,EAAE,mBAAmB,GACtE,CAAC"}

package/dist/client/types.js

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

package/dist/client/types.js.map

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

package/dist/core/async-event-queue.d.ts

@@ -0,0 +1,11 @@
+export declare class AsyncEventQueue<T> implements AsyncIterable<T> {
+    private q;
+    private pending;
+    private ended;
+    private err;
+    push(item: T): void;
+    end(): void;
+    fail(e: any): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+//# sourceMappingURL=async-event-queue.d.ts.map

package/dist/core/async-event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-event-queue.d.ts","sourceRoot":"","sources":["../../src/core/async-event-queue.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,CAAC,CAAW;IACpB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,GAAG,CAAa;IAExB,IAAI,CAAC,IAAI,EAAE,CAAC;IAOZ,GAAG;IAKH,IAAI,CAAC,CAAC,EAAE,GAAG;IAKX,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAU7C"}

package/dist/core/async-event-queue.js

@@ -0,0 +1,38 @@
+export class AsyncEventQueue {
+    q = [];
+    pending = [];
+    ended = false;
+    err = null;
+    push(item) {
+        if (this.ended)
+            return;
+        const r = this.pending.shift();
+        if (r)
+            r({ value: item, done: false });
+        else
+            this.q.push(item);
+    }
+    end() {
+        this.ended = true;
+        while (this.pending.length)
+            this.pending.shift()({ value: undefined, done: true });
+    }
+    fail(e) {
+        this.err = e;
+        this.end();
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.err)
+                    return Promise.reject(this.err);
+                if (this.q.length)
+                    return Promise.resolve({ value: this.q.shift(), done: false });
+                if (this.ended)
+                    return Promise.resolve({ value: undefined, done: true });
+                return new Promise(resolve => this.pending.push(resolve));
+            },
+        };
+    }
+}
+//# sourceMappingURL=async-event-queue.js.map

package/dist/core/async-event-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-event-queue.js","sourceRoot":"","sources":["../../src/core/async-event-queue.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IAChB,CAAC,GAAQ,EAAE,CAAC;IACZ,OAAO,GAAuC,EAAE,CAAC;IACjD,KAAK,GAAG,KAAK,CAAC;IACd,GAAG,GAAQ,IAAI,CAAC;IAExB,IAAI,CAAC,IAAO;QACR,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC;YAAE,CAAC,CAAC,EAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;;YAChC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG;QACC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC,EAAC,KAAK,EAAE,SAAgB,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC,CAAM;QACP,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QAClB,OAAO;YACH,IAAI,EAAE,GAAG,EAAE;gBACP,IAAI,IAAI,CAAC,GAAG;oBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9C,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;gBACjF,IAAI,IAAI,CAAC,KAAK;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAC,KAAK,EAAE,SAAgB,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;gBAC9E,OAAO,IAAI,OAAO,CAAoB,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACjF,CAAC;SACJ,CAAC;IACN,CAAC;CACJ"}

package/dist/core/binary.d.ts

@@ -0,0 +1,3 @@
+export declare function uint8ToDataUrl(bytes: Uint8Array, mime?: string): string;
+export declare function isUint8Array(value: any): value is Uint8Array;
+//# sourceMappingURL=binary.d.ts.map

package/dist/core/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/core/binary.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,SAAc,GAAG,MAAM,CAE5E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,UAAU,CAM5D"}

package/dist/core/binary.js

@@ -0,0 +1,11 @@
+export function uint8ToDataUrl(bytes, mime = "image/png") {
+    return `data:${mime};base64,${Buffer.from(bytes).toString("base64")}`;
+}
+export function isUint8Array(value) {
+    return value &&
+        typeof value === 'object' &&
+        typeof value.byteLength === 'number' &&
+        typeof value.buffer === 'object' &&
+        value.constructor?.name === 'Uint8Array';
+}
+//# sourceMappingURL=binary.js.map

package/dist/core/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/core/binary.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,IAAI,GAAG,WAAW;IAChE,OAAO,QAAQ,IAAI,WAAW,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAU;IACnC,OAAO,KAAK;QACR,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,YAAY,CAAC;AACjD,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,11 @@
+import { HoloErrorCode } from '@holokai/holo-types/holo';
+export declare class HoloError extends Error {
+    readonly statusCode: number;
+    readonly code: HoloErrorCode;
+    constructor(statusCode: number, message: string, code?: HoloErrorCode);
+    static notFound(resource: string): HoloError;
+    static badRequest(message: string): HoloError;
+    static unauthorized(message?: string): HoloError;
+    static forbidden(message?: string): HoloError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAEvD,qBAAa,SAAU,SAAQ,KAAK;aAEZ,UAAU,EAAE,MAAM;aAElB,IAAI,EAAE,aAAa;gBAFnB,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,aAA4C;IAMtE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAI5C,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAI7C,MAAM,CAAC,YAAY,CAAC,OAAO,SAAiB,GAAG,SAAS;IAIxD,MAAM,CAAC,SAAS,CAAC,OAAO,SAAc,GAAG,SAAS;CAGrD"}

package/dist/core/errors.js

@@ -0,0 +1,24 @@
+import { HoloErrorCode } from '@holokai/holo-types/holo';
+export class HoloError extends Error {
+    statusCode;
+    code;
+    constructor(statusCode, message, code = HoloErrorCode.INTERNAL_ERROR) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = 'HoloError';
+    }
+    static notFound(resource) {
+        return new HoloError(404, `${resource} not found`, HoloErrorCode.NOT_FOUND);
+    }
+    static badRequest(message) {
+        return new HoloError(400, message, HoloErrorCode.VALIDATION_ERROR);
+    }
+    static unauthorized(message = 'Unauthorized') {
+        return new HoloError(401, message, HoloErrorCode.UNAUTHORIZED);
+    }
+    static forbidden(message = 'Forbidden') {
+        return new HoloError(403, message, HoloErrorCode.FORBIDDEN);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAEvD,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEZ;IAEA;IAHpB,YACoB,UAAkB,EAClC,OAAe,EACC,OAAsB,aAAa,CAAC,cAAc;QAElE,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAElB,SAAI,GAAJ,IAAI,CAA8C;QAGlE,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,QAAgB;QAC5B,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,QAAQ,YAAY,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,OAAe;QAC7B,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAO,GAAG,cAAc;QACxC,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,WAAW;QAClC,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACJ"}

package/dist/core/headers.d.ts

@@ -0,0 +1,3 @@
+export declare function pickHeadersByPrefix(headers: Record<string, string | string[] | undefined>, prefixes?: string[]): Record<string, string>;
+export declare function filterForwardableHeaders(headers: Record<string, string | string[] | undefined>): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/core/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/core/headers.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,QAAQ,GAAE,MAAM,EAAmB,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBxB;AAcD,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACvD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB"}

package/dist/core/headers.js

@@ -0,0 +1,42 @@
+export function pickHeadersByPrefix(headers, prefixes = ["anthropic-"]) {
+    if (!headers)
+        return {};
+    const lowerPrefixes = prefixes.map(p => p.toLowerCase());
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (v == null)
+            continue;
+        const keyLower = k.toLowerCase();
+        const matches = lowerPrefixes.some(p => keyLower.startsWith(p));
+        if (!matches)
+            continue;
+        out[k] = Array.isArray(v) ? v.join(",") : String(v);
+    }
+    return out;
+}
+const BLOCKED_HEADERS = new Set([
+    'host',
+    'connection',
+    'keep-alive',
+    'transfer-encoding',
+    'upgrade',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'te',
+    'trailer',
+]);
+export function filterForwardableHeaders(headers) {
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (v == null)
+            continue;
+        const keyLower = k.toLowerCase();
+        if (BLOCKED_HEADERS.has(keyLower))
+            continue;
+        if (keyLower.startsWith('proxy-'))
+            continue;
+        out[k] = Array.isArray(v) ? v.join(",") : String(v);
+    }
+    return out;
+}
+//# sourceMappingURL=headers.js.map

package/dist/core/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/core/headers.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAC/B,OAAsD,EACtD,WAAqB,CAAC,YAAY,CAAC;IAEnC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI;YAAE,SAAS;QAExB,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,SAAS;IACT,oBAAoB;IACpB,qBAAqB;IACrB,IAAI;IACJ,SAAS;CACZ,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACpC,OAAsD;IAEtD,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI;YAAE,SAAS;QAExB,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAEjC,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QAE5C,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}