@holokai/holo-sdk 1.4.1

package/dist/provider/base.js

@@ -0,0 +1,185 @@
+import { ProtocolCapability } from "@holokai/holo-types/entities";
+import { AsyncEventQueue, ClassLogger, countTokens, pickDefined } from "../core";
+export class BaseProvider extends ClassLogger {
+    id;
+    name;
+    plugin;
+    _config;
+    auditor;
+    translator;
+    responseFactory;
+    models = {};
+    client;
+    constructor(id, name, plugin, _config) {
+        super();
+        this.id = id;
+        this.name = name;
+        this.plugin = plugin;
+        this._config = _config;
+        this.client = this.createClient();
+        this.auditor = this.createAuditor();
+        this.translator = this.createTranslator();
+        this.responseFactory = this.createResponseFactory();
+    }
+    async auditRequest(workerRequest) {
+        return this.auditor.auditRequest(workerRequest);
+    }
+    async auditResponse(workerEnvelope, providerEvent) {
+        return this.auditor.auditResponse(workerEnvelope, providerEvent);
+    }
+    async processWorkerRequest(request, _opts) {
+        const q = new AsyncEventQueue();
+        const { requestId, protocol, payload, httpRequestDetails } = request;
+        const requestPayload = request.isHoloNative
+            ? await this.translatePayload(protocol?.capability, payload, protocol?.name)
+            : payload;
+        let fullText = "";
+        const metrics = {
+            startTime: Date.now(),
+            timeToFirstToken: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: 0,
+            totalProcessingTime: 0,
+        };
+        const push = this.createEventPusher(q, requestId);
+        const query = { ...(httpRequestDetails?.query ?? {}) };
+        if (request.isHoloNative && request.isStreaming) {
+            query.alt = 'sse';
+            query.stream = 'true';
+        }
+        const ctx = pickDefined({
+            protocol,
+            headers: httpRequestDetails?.headers,
+            query,
+            emitStreamEvent: (event) => push({ type: "stream_event", event }),
+            emitTextDelta: (text) => {
+                if (metrics.timeToFirstToken === 0) {
+                    metrics.firstTime = Date.now();
+                    metrics.timeToFirstToken = metrics.firstTime - metrics.startTime;
+                }
+                if (text != null) {
+                    fullText += text;
+                    push({ type: "text_delta", text });
+                }
+            },
+            emitToolCallDelta: (index, delta) => push({ type: "tool_call_delta", index, delta }),
+        });
+        let runner;
+        try {
+            runner = await this.createRequestRunner(requestPayload, ctx);
+        }
+        catch (e) {
+            metrics.endTime = Date.now();
+            metrics.totalProcessingTime = metrics.endTime - metrics.startTime;
+            metrics.outputTokens = countTokens(fullText);
+            const handledError = await this.handleError(e);
+            push({
+                type: "error",
+                error: handledError,
+                text: e.message,
+                status: this.getErrorStatus(e, handledError),
+                headers: e?.headers,
+                metrics,
+                acc: fullText
+            });
+            q.end();
+            return q;
+        }
+        // IMPORTANT: do not await here — return q immediately for streaming
+        void (async () => {
+            try {
+                const final = await runner.start();
+                if (metrics.timeToFirstToken === 0) {
+                    metrics.firstTime = Date.now();
+                    metrics.timeToFirstToken = metrics.firstTime - metrics.startTime;
+                }
+                metrics.endTime = Date.now();
+                metrics.totalProcessingTime = metrics.endTime - metrics.startTime;
+                metrics.outputTokens = countTokens(fullText);
+                if (request.isHoloNative && protocol?.capability === ProtocolCapability.EMBED && this.translator.toHoloEmbedResponse) {
+                    const normalized = await this.translator.toHoloEmbedResponse(final);
+                    push({ type: "done", message: normalized, text: '', metrics });
+                }
+                else {
+                    if (!fullText && request.isHoloNative && final) {
+                        try {
+                            const translated = await this.translator.toHoloResponse(final);
+                            const extractedText = (translated.output ?? [])
+                                .filter((m) => m.role === 'assistant')
+                                .map((m) => typeof m.content === 'string' ? m.content : '')
+                                .join('');
+                            if (extractedText)
+                                fullText = extractedText;
+                        }
+                        catch { /* best-effort fallback */
+                        }
+                    }
+                    const holoResponse = (request.isHoloNative && !request.isStreaming) ? {
+                        id: requestId,
+                        model: await this.getModelNameFromRequest(requestPayload) ?? '',
+                        output: fullText ? [{ role: 'assistant', content: fullText }] : [],
+                        created: Date.now(),
+                        finish_reason: this.auditor.mapFinishReason(final, protocol?.name),
+                        usage: this.auditor.mapUsage(final, protocol?.name),
+                    } : undefined;
+                    push({
+                        type: "done",
+                        message: final,
+                        text: fullText,
+                        holoResponse,
+                        metrics
+                    });
+                }
+            }
+            catch (e) {
+                metrics.endTime = Date.now();
+                metrics.totalProcessingTime = metrics.endTime - metrics.startTime;
+                metrics.outputTokens = countTokens(fullText);
+                const handledError = await this.handleError(e);
+                push({
+                    type: "error",
+                    error: handledError,
+                    text: e.message,
+                    status: this.getErrorStatus(e, handledError),
+                    headers: e?.headers,
+                    metrics
+                });
+            }
+            finally {
+                q.end();
+            }
+        })();
+        return q;
+    }
+    getErrorStatus(e, handledError) {
+        return e?.status ?? e?.statusCode ?? handledError?.error?.code;
+    }
+    async translatePayload(capability, payload, _protocolName) {
+        switch (capability) {
+            case ProtocolCapability.GENERATE:
+                if (this.translator.fromHoloGenerateRequest) {
+                    return this.translator.fromHoloGenerateRequest(payload);
+                }
+                break;
+            case ProtocolCapability.EMBED:
+                if (this.translator.fromHoloEmbedRequest) {
+                    return this.translator.fromHoloEmbedRequest(payload);
+                }
+                break;
+            case ProtocolCapability.METRICS:
+                if (this.translator.fromHoloCountTokensRequest) {
+                    return this.translator.fromHoloCountTokensRequest(payload);
+                }
+                break;
+        }
+        return this.translator.fromHoloRequest(payload);
+    }
+    createEventPusher(q, requestId) {
+        let seq = 0;
+        return (ev) => {
+            q.push({ ...ev, requestId, seq: seq++, ts: Date.now() });
+        };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/provider/base.js.map

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

package/dist/provider/event-processor.d.ts

@@ -0,0 +1,13 @@
+import { IWireAdapter, ProviderDoneEvent, ProviderErrorEvent, ProviderEvent } from '@holokai/holo-types/provider';
+import type { HoloWorkerRequest, WorkerResponseEnvelope } from '@holokai/holo-types/worker';
+export interface ProviderEventResult {
+    text: string | undefined;
+    final?: HoloWorkerRequest;
+}
+export declare function processProviderEvents(events: AsyncIterable<ProviderEvent>, wireAdapter: IWireAdapter, workerRequest: HoloWorkerRequest, envelope: WorkerResponseEnvelope, publisher: {
+    publishChunk(sourceId: string, requestId: string, data: object): Promise<void>;
+    publishFinal(final: HoloWorkerRequest & {
+        providerEvent: ProviderDoneEvent | ProviderErrorEvent;
+    }): Promise<void>;
+}): Promise<ProviderEventResult>;
+//# sourceMappingURL=event-processor.d.ts.map

package/dist/provider/event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.d.ts","sourceRoot":"","sources":["../../src/provider/event-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EAEhB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAC,iBAAiB,EAAE,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAE1F,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,EACpC,WAAW,EAAE,YAAY,EACzB,aAAa,EAAE,iBAAiB,EAChC,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE;IACP,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG;QACpC,aAAa,EAAE,iBAAiB,GAAG,kBAAkB,CAAA;KACxD,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB,GACF,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}

package/dist/provider/event-processor.js

@@ -0,0 +1,22 @@
+import { ProviderEventType } from '@holokai/holo-types/provider';
+export async function processProviderEvents(events, wireAdapter, workerRequest, envelope, publisher) {
+    const result = { text: '' };
+    for await (const evt of events) {
+        if (evt.type === ProviderEventType.TEXT_DELTA)
+            result.text += evt.text;
+        for (const chunk of await wireAdapter.fromProviderEvent(evt)) {
+            await publisher.publishChunk(envelope.source_id, envelope.request_id, chunk);
+        }
+        if (evt.type === ProviderEventType.DONE || evt.type === ProviderEventType.ERROR) {
+            result.text = evt.type === ProviderEventType.DONE ? evt.text : evt.acc;
+            const final = { ...workerRequest, providerEvent: evt };
+            if (envelope.worker_id)
+                final.workerId = envelope.worker_id;
+            result.final = final;
+            await publisher.publishFinal(final);
+            break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=event-processor.js.map

package/dist/provider/event-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.js","sourceRoot":"","sources":["../../src/provider/event-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,iBAAiB,EACpB,MAAM,8BAA8B,CAAC;AAQtC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,MAAoC,EACpC,WAAyB,EACzB,aAAgC,EAChC,QAAgC,EAChC,SAKC;IAED,MAAM,MAAM,GAAwB,EAAC,IAAI,EAAE,EAAE,EAAC,CAAC;IAC/C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC,UAAU;YAAE,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QACvE,KAAK,MAAM,KAAK,IAAI,MAAM,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC,KAAK,EAAE,CAAC;YAC9E,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YACvE,MAAM,KAAK,GAAG,EAAC,GAAG,aAAa,EAAE,aAAa,EAAE,GAAG,EAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC;YAC5D,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YACrB,MAAM,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM;QACV,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/provider/index.d.ts

@@ -0,0 +1,7 @@
+export * from './auditor';
+export * from './translator';
+export * from './base';
+export * from './wire';
+export * from './event-processor';
+export * from './worker-request-factory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC"}

package/dist/provider/index.js

@@ -0,0 +1,7 @@
+export * from './auditor';
+export * from './translator';
+export * from './base';
+export * from './wire';
+export * from './event-processor';
+export * from './worker-request-factory';
+//# sourceMappingURL=index.js.map

package/dist/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC"}

package/dist/provider/translator/base.d.ts

@@ -0,0 +1,15 @@
+import type { TranslateOptions } from "@holokai/holo-types/provider";
+import { ClassLogger } from "../../core";
+export declare abstract class BaseTranslator<THolo, TProvider> extends ClassLogger {
+    protected abstract holoDefaults: any;
+    protected abstract providerDefaults: any;
+    translate<TSource, TTarget>(source: TSource, options: TranslateOptions): Promise<Partial<TTarget>>;
+    translateArray<TSource, TTarget>(items: TSource[] | undefined, options: TranslateOptions): Promise<TTarget[]>;
+    fromHolo(source: THolo, validateTarget?: boolean): Promise<Partial<TProvider>>;
+    fromHoloArray(items: THolo[] | undefined, validateTarget?: boolean): Promise<TProvider[]>;
+    toHolo(target: TProvider, validateTarget?: boolean): Promise<Partial<THolo>>;
+    toHoloArray(items: TProvider[] | undefined, validateTarget?: boolean): Promise<THolo[]>;
+    protected abstract fromHoloImpl(source: THolo): Promise<Partial<TProvider>>;
+    protected abstract toHoloImpl(source: TProvider): Promise<Partial<THolo>>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/provider/translator/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/provider/translator/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAGvC,8BAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,CAAE,SAAQ,WAAW;IAEtE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC;IAEnC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAelG,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAS7G,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAI5E,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIvF,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAI1E,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI3F,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE3E,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;CAC5E"}

package/dist/provider/translator/base.js

@@ -0,0 +1,33 @@
+import { ClassLogger } from "../../core";
+export class BaseTranslator extends ClassLogger {
+    async translate(source, options) {
+        const { fromHolo = true } = options;
+        const defaults = fromHolo ? this.providerDefaults : this.holoDefaults;
+        const partial = fromHolo
+            ? (await this.fromHoloImpl(source))
+            : (await this.toHoloImpl(source));
+        return {
+            ...(defaults ?? {}),
+            ...(partial ?? {}),
+        };
+    }
+    async translateArray(items, options) {
+        if (!items?.length)
+            return [];
+        const results = await Promise.all(items.map(item => this.translate(item, options))); // Remove .bind(this)
+        return results.filter(item => Object.keys(item).length > 0);
+    }
+    async fromHolo(source, validateTarget = false) {
+        return await this.translate(source, { fromHolo: true, validateTarget });
+    }
+    async fromHoloArray(items, validateTarget = false) {
+        return await this.translateArray(items, { fromHolo: true, validateTarget });
+    }
+    async toHolo(target, validateTarget = false) {
+        return await this.translate(target, { fromHolo: false, validateTarget });
+    }
+    async toHoloArray(items, validateTarget = false) {
+        return await this.translateArray(items, { fromHolo: false, validateTarget });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/provider/translator/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/provider/translator/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAGvC,MAAM,OAAgB,cAAiC,SAAQ,WAAW;IAKtE,KAAK,CAAC,SAAS,CAAmB,MAAe,EAAE,OAAyB;QACxE,MAAM,EAAC,QAAQ,GAAG,IAAI,EAAC,GAAG,OAAO,CAAC;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QAEtE,MAAM,OAAO,GAAqB,QAAQ;YACtC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,MAA0B,CAAC,CAAgC;YACtF,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,MAA8B,CAAC,CAAgC,CAAC;QAE7F,OAAO;YACH,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;YACnB,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACrB,CAAC;IACN,CAAC;IAGD,KAAK,CAAC,cAAc,CAAmB,KAA4B,EAAE,OAAyB;QAC1F,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,OAAO,EAAE,CAAC;QAE9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAC/C,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB;QAE1D,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAc,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAa,EAAE,cAAc,GAAG,KAAK;QAChD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAmB,MAAM,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAC,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAA0B,EAAE,cAAc,GAAG,KAAK;QAClE,OAAO,MAAM,IAAI,CAAC,cAAc,CAAmB,KAAK,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAC,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAiB,EAAE,cAAc,GAAG,KAAK;QAClD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAmB,MAAM,EAAE,EAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAA8B,EAAE,cAAc,GAAG,KAAK;QACpE,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,EAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC,CAAC;IAC/E,CAAC;CAKJ"}

package/dist/provider/translator/index.d.ts

@@ -0,0 +1,3 @@
+export * from './stream';
+export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/translator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/provider/translator/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}

package/dist/provider/translator/index.js

@@ -0,0 +1,3 @@
+export * from './stream';
+export * from './base';
+//# sourceMappingURL=index.js.map

package/dist/provider/translator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/provider/translator/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}

package/dist/provider/translator/stream.d.ts

@@ -0,0 +1,24 @@
+import type { TranslateOptions } from "@holokai/holo-types/provider";
+export declare abstract class StreamTranslator<THolo, TProvider> {
+    /** Validators for single streaming chunks (not full messages) */
+    protected abstract providerDefaults: Partial<TProvider>;
+    protected abstract holoDefaults: Partial<THolo>;
+    /**
+     * Translate a single streaming chunk to 0..N target chunks.
+     * - Validates the source (as a complete chunk of its type).
+     * - Does NOT merge defaults (deltas are partial by design).
+     * - Optionally validates each emitted target chunk and strips undeclared keys.
+     */
+    translateMany<TSource, TTarget>(source: TSource, options: TranslateOptions): Promise<Partial<TTarget>[]>;
+    /**
+     * Batch helper: many sources → flattened output stream.
+     */
+    translateManyArray<TSource, TTarget>(items: TSource[] | undefined, options: TranslateOptions): Promise<Partial<TTarget>[]>;
+    fromHoloMany(source: THolo, validateTarget?: boolean): Promise<Partial<TProvider>[]>;
+    fromHoloManyArray(items: THolo[] | undefined, validateTarget?: boolean): Promise<Partial<TProvider>[]>;
+    toHoloMany(target: TProvider, validateTarget?: boolean): Promise<Partial<THolo>[]>;
+    toHoloManyArray(items: TProvider[] | undefined, validateTarget?: boolean): Promise<Partial<THolo>[]>;
+    protected abstract fromHoloManyImpl(source: THolo): Promise<Partial<TProvider>[]>;
+    protected abstract toHoloManyImpl(source: TProvider): Promise<Partial<THolo>[]>;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/provider/translator/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/provider/translator/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,8BAA8B,CAAC;AAEnE,8BAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS;IACnD,iEAAiE;IACjE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhD;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,EAChC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IA0B9B;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,OAAO,EACrC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,EAC5B,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAOxB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAIlF,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAIpG,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IAIhF,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IAKxG,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAEjF,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;CAClF"}

package/dist/provider/translator/stream.js

@@ -0,0 +1,50 @@
+export class StreamTranslator {
+    /**
+     * Translate a single streaming chunk to 0..N target chunks.
+     * - Validates the source (as a complete chunk of its type).
+     * - Does NOT merge defaults (deltas are partial by design).
+     * - Optionally validates each emitted target chunk and strips undeclared keys.
+     */
+    async translateMany(source, options) {
+        const { fromHolo = true } = options;
+        const defaults = (fromHolo ? this.providerDefaults : this.holoDefaults) ?? {};
+        // 2) Impl: single → many
+        const emitted = fromHolo
+            ? await this.fromHoloManyImpl(source)
+            : await this.toHoloManyImpl(source);
+        if (!Array.isArray(emitted) || emitted.length === 0)
+            return [];
+        // 3) Apply defaults per item
+        const withDefaults = emitted.map(item => ({ ...defaults, ...(item ?? {}) }));
+        const cleaned = [];
+        for (const item of withDefaults) {
+            const obj = item;
+            if (obj && Object.keys(obj).length > 0)
+                cleaned.push(obj);
+        }
+        return cleaned;
+    }
+    /**
+     * Batch helper: many sources → flattened output stream.
+     */
+    async translateManyArray(items, options) {
+        if (!items?.length)
+            return [];
+        const batches = await Promise.all(items.map(item => this.translateMany(item, options)));
+        return batches.flat().filter(o => o && Object.keys(o).length > 0);
+    }
+    // Convenience wrappers
+    async fromHoloMany(source, validateTarget = false) {
+        return this.translateMany(source, { fromHolo: true, validateTarget });
+    }
+    async fromHoloManyArray(items, validateTarget = false) {
+        return this.translateManyArray(items, { fromHolo: true, validateTarget });
+    }
+    async toHoloMany(target, validateTarget = false) {
+        return this.translateMany(target, { fromHolo: false, validateTarget });
+    }
+    async toHoloManyArray(items, validateTarget = false) {
+        return this.translateManyArray(items, { fromHolo: false, validateTarget });
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/provider/translator/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/provider/translator/stream.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,gBAAgB;IAKlC;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACf,MAAe,EACf,OAAyB;QAEzB,MAAM,EACF,QAAQ,GAAG,IAAI,EAClB,GAAG,OAAO,CAAC;QAEZ,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAE9E,yBAAyB;QACzB,MAAM,OAAO,GAAuB,QAAQ;YACxC,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAA0B,CAAkC;YAC1F,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAA8B,CAAkC,CAAC;QAEjG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE/D,6BAA6B;QAC7B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAC,GAAG,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC;QAE3E,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAwB,CAAC;YACrC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACpB,KAA4B,EAC5B,OAAyB;QAEzB,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,OAAO,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAmB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1G,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,YAAY,CAAC,MAAa,EAAE,cAAc,GAAG,KAAK;QACpD,OAAO,IAAI,CAAC,aAAa,CAAmB,MAAM,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAC,CAAC,CAAC;IAC1F,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,KAA0B,EAAE,cAAc,GAAG,KAAK;QACtE,OAAO,IAAI,CAAC,kBAAkB,CAAmB,KAAK,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAC,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAiB,EAAE,cAAc,GAAG,KAAK;QACtD,OAAO,IAAI,CAAC,aAAa,CAAmB,MAAM,EAAE,EAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAA8B,EAAE,cAAc,GAAG,KAAK;QACxE,OAAO,IAAI,CAAC,kBAAkB,CAAmB,KAAK,EAAE,EAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC,CAAC;IAC/F,CAAC;CAMJ"}

package/dist/provider/wire/base.d.ts

@@ -0,0 +1,39 @@
+import { ClassLogger } from '../../core';
+import type { IWireAdapter, ProviderEvent, WireChunk } from '@holokai/holo-types/provider';
+export declare abstract class BaseWireAdapter extends ClassLogger implements IWireAdapter {
+    readonly requestId: string;
+    readonly isStreaming: boolean;
+    wireSeq: number;
+    constructor(requestId: string, isStreaming: boolean);
+    fromProviderEvent(ev: ProviderEvent): Promise<WireChunk[]>;
+    abstract formatWire(data: any): string;
+    protected nonStreamingHeaders(): Record<string, string>;
+    protected streamingHeaders(): Record<string, string>;
+    protected defaultHeadersForFirst(ev: ProviderEvent): Record<string, string>;
+    protected chunkify(ev: ProviderEvent, bodyFn: (ev: any) => Promise<string>, done?: true, options?: {
+        fullText?: string;
+        status?: number;
+        headers?: Record<string, string>;
+    }): Promise<WireChunk>;
+    protected fromNonStreaming(ev: ProviderEvent): Promise<WireChunk[]>;
+    protected fromStreaming(ev: ProviderEvent): Promise<WireChunk[]>;
+    protected onStreamEvent(ev: Extract<ProviderEvent, {
+        type: 'stream_event';
+    }>): Promise<WireChunk[]>;
+    protected onDoneStreaming(ev: Extract<ProviderEvent, {
+        type: 'done';
+    }>): Promise<WireChunk[]>;
+    protected onErrorStreaming(ev: Extract<ProviderEvent, {
+        type: 'error';
+    }>): Promise<WireChunk[]>;
+    protected defaultDoneStreamFormatter(ev: Extract<ProviderEvent, {
+        type: 'done';
+    }>): Promise<string>;
+    protected defaultStreamErrorFormatter(ev: Extract<ProviderEvent, {
+        type: 'error';
+    }>): Promise<string>;
+    protected defaultStreamEventFormatter(ev: Extract<ProviderEvent, {
+        type: 'stream_event';
+    }>): Promise<string>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/provider/wire/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/provider/wire/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAA4B,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAC,YAAY,EAAE,aAAa,EAAE,SAAS,EAAC,MAAM,8BAA8B,CAAC;AAEzF,8BAAsB,eAAgB,SAAQ,WAAY,YAAW,YAAY;aAIzD,SAAS,EAAE,MAAM;aACjB,WAAW,EAAE,OAAO;IAJxC,OAAO,SAAK;gBAGQ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO;IAKlC,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKhE,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM;IAGtC,SAAS,CAAC,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvD,SAAS,CAAC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQpD,SAAS,CAAC,sBAAsB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAI3D,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;QACrG,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,GAAG,OAAO,CAAC,SAAS,CAAC;cAiCN,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;cAezD,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;cActD,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;cAIzF,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;cAInF,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;cAQrF,0BAA0B,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;cAIzF,2BAA2B,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;cAI3F,2BAA2B,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAGrH"}

package/dist/provider/wire/base.js

@@ -0,0 +1,106 @@
+import { ClassLogger, pickDefined, stringifyAny } from '../../core';
+export class BaseWireAdapter extends ClassLogger {
+    requestId;
+    isStreaming;
+    wireSeq = 0;
+    constructor(requestId, isStreaming) {
+        super();
+        this.requestId = requestId;
+        this.isStreaming = isStreaming;
+    }
+    async fromProviderEvent(ev) {
+        if (!this.isStreaming)
+            return this.fromNonStreaming(ev);
+        return this.fromStreaming(ev);
+    }
+    // --- defaults ---
+    nonStreamingHeaders() {
+        return { 'Content-Type': 'application/json' };
+    }
+    streamingHeaders() {
+        return {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        };
+    }
+    defaultHeadersForFirst(ev) {
+        return (ev.type === 'error' || !this.isStreaming) ? this.nonStreamingHeaders() : this.streamingHeaders();
+    }
+    async chunkify(ev, bodyFn, done, options) {
+        const isFirst = this.wireSeq == 0;
+        const seq = this.wireSeq++;
+        const body = await bodyFn(ev);
+        const fullText = options?.fullText;
+        const chunk = pickDefined({
+            fullText,
+            requestId: this.requestId,
+            seq,
+            eventSeq: ev.seq,
+            body,
+            done,
+        });
+        if (isFirst) {
+            const status = options?.status ?? (ev.type === 'error' ? (ev.status ?? 400) : 200);
+            const headers = options?.headers ??
+                (ev.type === 'error' && ev.headers ? ev.headers : undefined) ?? this.defaultHeadersForFirst(ev);
+            chunk.status = status;
+            chunk.headers = headers;
+        }
+        else {
+            // generally do NOT send headers/status after first chunk; allow explicit override if needed
+            if (options?.status !== undefined)
+                chunk.status = options.status;
+            if (options?.headers)
+                chunk.headers = options.headers;
+        }
+        return chunk;
+    }
+    // --- non-streaming ---
+    async fromNonStreaming(ev) {
+        if (ev.type === 'done') {
+            return [await this.chunkify(ev, async (ev) => stringifyAny(ev.message), true)];
+        }
+        if (ev.type === 'error') {
+            return [await this.chunkify(ev, async (ev) => stringifyAny(ev.error), true, pickDefined({ status: ev.status ?? 400, headers: ev.headers }))];
+        }
+        return [];
+    }
+    // --- streaming ---
+    async fromStreaming(ev) {
+        switch (ev.type) {
+            case 'stream_event':
+                return this.onStreamEvent(ev);
+            case 'done':
+                return this.onDoneStreaming(ev);
+            case 'error':
+                return this.onErrorStreaming(ev);
+            case 'text_delta':
+            default:
+                return [];
+        }
+    }
+    async onStreamEvent(ev) {
+        return [await this.chunkify(ev, this.defaultStreamEventFormatter.bind(this))];
+    }
+    async onDoneStreaming(ev) {
+        return [await this.chunkify(ev, this.defaultDoneStreamFormatter.bind(this), true, { fullText: ev.text })];
+    }
+    async onErrorStreaming(ev) {
+        if (this.wireSeq === 0) {
+            return await this.fromNonStreaming(ev);
+        }
+        // Mid-stream: default behavior (provider adapters should usually override)
+        return [await this.chunkify(ev, this.defaultStreamErrorFormatter.bind(this), true)];
+    }
+    async defaultDoneStreamFormatter(ev) {
+        return this.formatWire(ev.message);
+    }
+    async defaultStreamErrorFormatter(ev) {
+        return stringifyAny(ev.error);
+    }
+    async defaultStreamEventFormatter(ev) {
+        return this.formatWire(ev.event);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/provider/wire/base.js.map

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

package/dist/provider/wire/holo.wire.adapter.d.ts

@@ -0,0 +1,33 @@
+import type { ProviderEvent, WireChunk } from '@holokai/holo-types/provider';
+import type { HoloStreamEvent } from '@holokai/holo-types/holo';
+import type { ProtocolCapability } from '@holokai/holo-types/entities';
+import { BaseWireAdapter } from './base';
+export declare class HoloWireAdapter extends BaseWireAdapter {
+    private textAccumulator;
+    private toolCalls;
+    private responseId?;
+    private model?;
+    private firstEvent;
+    private readonly capability;
+    constructor(requestId: string, isStreaming: boolean, initialModel?: string, capability?: ProtocolCapability);
+    formatWire(data: string | HoloStreamEvent): string;
+    emitCreated(id: string, model: string): HoloStreamEvent;
+    emitTextDelta(index: number, text: string): HoloStreamEvent;
+    emitReasoningDelta(index: number, text: string): HoloStreamEvent;
+    emitToolCallDelta(index: number, delta: {
+        id?: string;
+        name?: string;
+        arguments_delta?: string;
+    }): HoloStreamEvent;
+    emitHoloEvent(ev: ProviderEvent, holoEvent: HoloStreamEvent): Promise<WireChunk[]>;
+    protected fromNonStreaming(ev: ProviderEvent): Promise<WireChunk[]>;
+    protected fromStreaming(ev: ProviderEvent): Promise<WireChunk[]>;
+    protected onDoneStreaming(ev: Extract<ProviderEvent, {
+        type: 'done';
+    }>): Promise<WireChunk[]>;
+    protected onErrorStreaming(ev: Extract<ProviderEvent, {
+        type: 'error';
+    }>): Promise<WireChunk[]>;
+    private buildFinalResponse;
+}
+//# sourceMappingURL=holo.wire.adapter.d.ts.map