@holokai/sdk 0.1.0

package/dist/provider/base.js

@@ -0,0 +1,169 @@
+import { AsyncEventQueue } from "./types";
+import { ClassLogger, pickDefined, pickHeadersByPrefix, filterForwardableHeaders } from "../core/index";
+export class BaseProvider extends ClassLogger {
+    name;
+    family;
+    version;
+    _config;
+    models = {};
+    client;
+    auditor;
+    translator;
+    responseFactory;
+    constructor(name, family, version, _config) {
+        super();
+        this.name = name;
+        this.family = family;
+        this.version = version;
+        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();
+        if (request.isPassthrough) {
+            return this.handlePassthrough(request, q);
+        }
+        const { requestId, payload, rawRequest } = request;
+        const requestPayload = payload;
+        const start = Date.now();
+        let fullText = "";
+        const metrics = {
+            timeToFirstToken: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            totalProcessingTime: 0,
+        };
+        const push = this.createEventPusher(q, requestId);
+        const ctx = pickDefined({
+            requestType: request.type,
+            headers: rawRequest.headers,
+            query: rawRequest.query,
+            emitStreamEvent: (event) => push({ type: "stream_event", event }),
+            emitTextDelta: (text) => {
+                if (!metrics.timeToFirstToken)
+                    metrics.timeToFirstToken = Date.now() - start;
+                fullText += text;
+                push({ type: "text_delta", text });
+            },
+        });
+        let run;
+        try {
+            run = await this.handleRequest(requestPayload, ctx);
+        }
+        catch (e) {
+            push({ type: "error", error: await this.handleError(e) });
+            q.end();
+            return q;
+        }
+        // IMPORTANT: do not await here — return q immediately for streaming
+        void (async () => {
+            try {
+                const final = await run.final();
+                metrics.inputTokens = final?.usage?.input_tokens ?? 0;
+                metrics.outputTokens = final?.usage?.output_tokens ?? 0;
+                metrics.totalProcessingTime = Date.now() - start;
+                push({
+                    type: "done",
+                    message: final,
+                    text: fullText.length ? fullText : JSON.stringify(final),
+                    metrics
+                });
+            }
+            catch (e) {
+                push({ type: "error", error: await this.handleError(e) });
+            }
+            finally {
+                q.end();
+            }
+        })();
+        return q;
+    }
+    getHeaders(request, config) {
+        const headers = {
+            ...filterForwardableHeaders(request.rawRequest.headers),
+            ...pickHeadersByPrefix(request.rawRequest.headers, [this.name.toLowerCase() + '-']),
+        };
+        if (config.apiKey) {
+            headers['authorization'] = `Bearer ${config.apiKey}`;
+        }
+        return headers;
+    }
+    createEventPusher(q, requestId) {
+        let seq = 0;
+        return (ev) => {
+            q.push({ ...ev, requestId, seq: seq++, ts: Date.now() });
+        };
+    }
+    async handlePassthrough(request, q) {
+        const { requestId, passthroughPath, rawRequest, payload } = request;
+        const start = Date.now();
+        const push = this.createEventPusher(q, requestId);
+        void (async () => {
+            try {
+                const config = this._config;
+                if (!config?.baseUrl) {
+                    push({ type: "error", error: { message: 'Provider config missing baseUrl' }, status: 500 });
+                    q.end();
+                    return;
+                }
+                const queryString = new URLSearchParams(rawRequest.query).toString();
+                const targetUrl = `${config.baseUrl}${passthroughPath}${queryString ? '?' + queryString : ''}`;
+                const fetchResponse = await fetch(targetUrl, {
+                    method: rawRequest.method,
+                    headers: this.getHeaders(request, config),
+                    body: JSON.stringify(payload),
+                    signal: AbortSignal.timeout(config.timeout || 120000)
+                });
+                const contentType = fetchResponse.headers.get('content-type') || '';
+                const isStreaming = contentType.includes('text/event-stream') || contentType.includes('stream');
+                if (isStreaming && fetchResponse.body) {
+                    const reader = fetchResponse.body.getReader();
+                    const decoder = new TextDecoder();
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        push({ type: "stream_event", event: { raw: decoder.decode(value, { stream: true }) } });
+                    }
+                }
+                else {
+                    const responseText = await fetchResponse.text();
+                    push({
+                        type: "done",
+                        message: JSON.parse(responseText),
+                        text: responseText,
+                        metrics: { timeToFirstToken: 0, inputTokens: 0, outputTokens: 0, totalProcessingTime: Date.now() - start }
+                    });
+                    q.end();
+                    return;
+                }
+                push({
+                    type: "done",
+                    message: { status: 'completed' },
+                    text: '',
+                    metrics: { timeToFirstToken: 0, inputTokens: 0, outputTokens: 0, totalProcessingTime: Date.now() - start }
+                });
+            }
+            catch (error) {
+                push({ type: "error", error: { message: error.message }, status: 500 });
+            }
+            finally {
+                q.end();
+            }
+        })();
+        return q;
+    }
+    get id() {
+        return this._config.id;
+    }
+}
+//# 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/index.d.ts

@@ -0,0 +1,6 @@
+export * from './auditor';
+export * from './translator';
+export * from './base';
+export * from './types';
+export * from './wire';
+//# 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,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/dist/provider/index.js

@@ -0,0 +1,6 @@
+export * from './auditor';
+export * from './translator';
+export * from './base';
+export * from './types';
+export * from './wire';
+//# 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,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

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

@@ -0,0 +1,32 @@
+import { HoloMessage, HoloRequest, HoloResponse, HoloStreamChunk } from "../../holo/index";
+import { ClassLogger } from "../../core/index";
+export interface IProviderTranslator {
+    toHoloRequest(request: any): Promise<Partial<HoloRequest>>;
+    fromHoloRequest(request: HoloRequest): Promise<Partial<any>>;
+    toHoloMessages(messages: any[]): Promise<Partial<HoloMessage>[]>;
+    fromHoloMessages(messages: HoloMessage[]): Promise<Partial<any>[]>;
+    toHoloResponse(response: any): Promise<Partial<HoloResponse>>;
+    fromHoloResponse(response: HoloResponse): Promise<Partial<any>>;
+    fromHoloStreamChunks(chunks: HoloStreamChunk[]): Promise<unknown>;
+}
+export type TranslateOptions = {
+    /** true: THolo -> TProvider; false: TProvider -> THolo */
+    fromHolo?: boolean;
+    /** validate & strip undeclared keys on the target */
+    validateTarget?: boolean;
+    /** when validation fails, return {} instead of throwing */
+    failQuietly?: boolean;
+};
+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,EAAC,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAChC,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3D,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7D,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAEjE,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEnE,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAE9D,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhE,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAGF,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/index";
+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,kBAAkB,CAAC;AA4B7C,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 { TranslateOptions } from "./base";
+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,EAAC,gBAAgB,EAAC,MAAM,QAAQ,CAAC;AAExC,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/types.d.ts

@@ -0,0 +1,107 @@
+import { RequestType } from "../holo/index";
+import { HoloWorkerRequest, WorkerResponseEnvelope } from "../core/worker/index";
+import { IAuditor } from "./auditor/index";
+import { IProviderTranslator } from "./translator/index";
+import { LlmRequest, LlmResponse } from "../core/entities/index";
+export type ProviderEvent = {
+    type: "stream_event";
+    requestId: string;
+    seq: number;
+    event: any;
+    ts: number;
+} | {
+    type: "text_delta";
+    requestId: string;
+    seq: number;
+    text: string;
+    ts: number;
+} | {
+    type: "done";
+    requestId: string;
+    seq: number;
+    message: any;
+    text: string;
+    metrics?: any;
+    ts: number;
+} | {
+    type: "error";
+    requestId: string;
+    seq: number;
+    error: any;
+    status?: number;
+    headers?: Record<string, string>;
+    ts: number;
+};
+export type ProviderEnvelope = {
+    model_slug: string;
+    system_prompt?: string;
+};
+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>;
+}
+export type ProviderContext = {
+    requestType?: RequestType;
+    headers?: Record<string, string | string[]>;
+    query?: Record<string, string>;
+    emitStreamEvent: (event: any) => void;
+    emitTextDelta: (text: string) => void;
+};
+export type RunHandle<Final> = {
+    final: () => Promise<Final>;
+    cancel?: () => void;
+};
+export interface ProviderCapabilities {
+    streaming: boolean;
+    tools: boolean;
+    vision: boolean;
+    functionCalling: boolean;
+    maxTokens: number;
+}
+/**
+ * Model information interface
+ */
+export interface ModelInfo {
+    id: string;
+    name?: string;
+    description?: string;
+    size?: number;
+    parameterCount?: string;
+    quantization?: string;
+    family?: string;
+    parentModel?: string;
+    format?: string;
+    [key: string]: any;
+}
+export interface AIRequestStat {
+    type: RequestType;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    success: number;
+    error: number;
+}
+export interface IProvider {
+    name: string;
+    family: string;
+    version: string;
+    auditor: IAuditor;
+    translator: IProviderTranslator;
+    responseFactory: IResponseFactory;
+    getModels(allowedModels: string[] | true): Promise<any>;
+    processWorkerRequest(request: HoloWorkerRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncEventQueue<ProviderEvent>>;
+    auditRequest(workerRequest: HoloWorkerRequest): Promise<LlmRequest>;
+    auditResponse(workerEnvelope: WorkerResponseEnvelope, providerEvent: ProviderEvent): Promise<LlmResponse>;
+}
+export interface IResponseFactory {
+    createError(message: string, code?: string): any;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/provider/types.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=types.js.map

package/dist/provider/types.js.map

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

@@ -0,0 +1,50 @@
+import { ClassLogger } from '../../core/index';
+import { ProviderEvent } from '../types';
+import type { RequestType } from '../../holo/index';
+export type WireChunk = {
+    requestId: string;
+    seq: number;
+    eventSeq?: number;
+    headers?: Record<string, string>;
+    status?: number;
+    body: string;
+    done?: true;
+};
+export interface IWireAdapter {
+    requestId: string;
+    isStreaming: boolean;
+    fromProviderEvent(ev: ProviderEvent): WireChunk[];
+}
+export interface WireAdapterParams {
+    requestId: string;
+    isStreaming: boolean;
+    requestType: RequestType;
+}
+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): WireChunk[];
+    protected nonStreamingHeaders(): Record<string, string>;
+    protected streamingHeaders(): Record<string, string>;
+    protected defaultHeadersForFirst(ev: ProviderEvent): Record<string, string>;
+    protected stringifyResponse(err: string | Error): string;
+    protected chunkify(response: any, ev: ProviderEvent, done?: true, override?: {
+        status?: number;
+        headers?: Record<string, string>;
+    }): WireChunk;
+    protected fromNonStreaming(ev: ProviderEvent): WireChunk[];
+    protected fromStreaming(ev: ProviderEvent): WireChunk[];
+    protected onStreamEvent(ev: Extract<ProviderEvent, {
+        type: 'stream_event';
+    }>): WireChunk[];
+    protected onDoneStreaming(ev: Extract<ProviderEvent, {
+        type: 'done';
+    }>): WireChunk[];
+    protected onErrorStreaming(ev: Extract<ProviderEvent, {
+        type: 'error';
+    }>): WireChunk[];
+    abstract formatWire(data: any): 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,EAAc,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IAErB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,SAAS,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC5B;AAED,8BAAsB,eAAgB,SAAQ,WAAY,YAAW,YAAY;aAKzD,SAAS,EAAE,MAAM;aACjB,WAAW,EAAE,OAAO;IALxC,OAAO,SAAK;gBAIQ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO;IAKxC,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,SAAS,EAAE;IAMjD,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;IAI3E,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM;IAIxD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE;QACzE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,GAAG,SAAS;IAgCb,SAAS,CAAC,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,SAAS,EAAE;IAW1D,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,SAAS,EAAE;IAcvD,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,GAAG,SAAS,EAAE;IAI1F,SAAS,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,EAAE;IAIpF,SAAS,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,SAAS,EAAE;IAQtF,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM;CACzC"}