@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dist/components/ollama/index.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaBackendError = exports.OllamaBackend = void 0;
+exports.registerOllamaBackend = registerOllamaBackend;
+/**
+ * Ollama backend (#629, Phase 2 of #510).
+ *
+ * Implements `ModelBackend` against a local or remote Ollama HTTP API.
+ * Exports `OllamaBackend` directly for tests and `registerOllamaBackend(...)`
+ * for the YAML→registry boot bridge in `resources/models/bootstrap.ts`.
+ *
+ * Component shape matches the pattern in `components/mcp/index.ts` (PR #649):
+ * core imports a register helper and calls it during boot; not a
+ * `handleApplication(scope)` self-loader.
+ */
+const backendRegistry_ts_1 = require("../../resources/models/backendRegistry.js");
+const backendHelpers_ts_1 = require("../../resources/models/backendHelpers.js");
+const hdbError_ts_1 = require("../../utility/errors/hdbError.js");
+const DEFAULT_HOST = 'localhost:11434';
+const MAX_NDJSON_LINE_BYTES = 1 << 20; // 1 MiB — Ollama chunks are normally sub-KiB; anything larger is pathological.
+/**
+ * `ModelBackend` implementation talking to Ollama's HTTP API.
+ *
+ * - `embed` → `POST /api/embed` (the legacy `/api/embeddings` is deprecated upstream).
+ * - `generate` → `POST /api/generate` for string prompts, `POST /api/chat` for
+ *   messages-array input.
+ * - `generateStream` → same routing as `generate` with `stream: true`; consumes
+ *   Ollama's NDJSON wire format and yields `GenerateChunk` per JSON line.
+ *
+ * Capabilities advertise `tools: false` and `adapters: false`. Ollama tool-call
+ * support exists on some models but is uneven across the model catalog; we keep
+ * the v1 portability guarantee honest and skip them here.
+ */
+class OllamaBackend {
+    name = 'ollama';
+    #origin;
+    #defaultModel;
+    #requestTimeoutMs;
+    #fetch;
+    constructor(config = {}, fetchImpl = fetch) {
+        this.#origin = (0, backendHelpers_ts_1.normalizeOrigin)(config.host, { host: DEFAULT_HOST, secure: false });
+        this.#defaultModel = config.model;
+        this.#requestTimeoutMs = config.requestTimeoutMs;
+        this.#fetch = fetchImpl;
+    }
+    capabilities() {
+        return { embed: true, generate: true, stream: true, tools: false, adapters: false };
+    }
+    async embed(input, opts) {
+        const model = opts.model ?? this.#defaultModel;
+        (0, backendHelpers_ts_1.requireModel)(model, 'embed', OllamaBackendError);
+        const texts = Array.isArray(input) ? input : [input];
+        const prepared = texts.map((t) => applyEmbedPrefix(model, t, opts.inputType));
+        const res = await this.#post('/api/embed', { model, input: prepared }, opts.signal);
+        const data = await (0, backendHelpers_ts_1.parseJsonResponse)(res, 'Ollama /api/embed', OllamaBackendError);
+        if (!Array.isArray(data.embeddings)) {
+            throw new OllamaBackendError("Ollama /api/embed response missing 'embeddings' array");
+        }
+        if (data.embeddings.length !== prepared.length) {
+            throw new OllamaBackendError(`Ollama /api/embed returned ${data.embeddings.length} vectors for ${prepared.length} inputs`);
+        }
+        const output = data.embeddings.map((v, i) => {
+            if (!Array.isArray(v) || !v.every(Number.isFinite)) {
+                throw new OllamaBackendError(`Ollama /api/embed vector at index ${i} is not an array of finite numbers`);
+            }
+            return Float32Array.from(v);
+        });
+        const usage = {};
+        (0, backendHelpers_ts_1.assignFiniteTokenCount)(usage, 'embeddingTokens', data.prompt_eval_count);
+        return { status: 'completed', output, usage };
+    }
+    async generate(input, opts) {
+        const model = opts.model ?? this.#defaultModel;
+        (0, backendHelpers_ts_1.requireModel)(model, 'generate', OllamaBackendError);
+        const { endpoint, body } = buildGenerateRequest(model, input, opts, false);
+        const res = await this.#post(endpoint, body, opts.signal);
+        const data = await (0, backendHelpers_ts_1.parseJsonResponse)(res, `Ollama ${endpoint}`, OllamaBackendError);
+        const rawContent = endpoint === '/api/chat' ? data.message?.content : data.response;
+        if (rawContent !== undefined && typeof rawContent !== 'string') {
+            throw new OllamaBackendError(`Ollama ${endpoint} response content is not a string`);
+        }
+        const usage = {};
+        (0, backendHelpers_ts_1.assignFiniteTokenCount)(usage, 'promptTokens', data.prompt_eval_count);
+        (0, backendHelpers_ts_1.assignFiniteTokenCount)(usage, 'completionTokens', data.eval_count);
+        return {
+            status: 'completed',
+            output: { content: rawContent ?? '', finishReason: mapFinishReason(data.done_reason) },
+            usage,
+        };
+    }
+    async *generateStream(input, opts) {
+        const model = opts.model ?? this.#defaultModel;
+        (0, backendHelpers_ts_1.requireModel)(model, 'generateStream', OllamaBackendError);
+        const { endpoint, body } = buildGenerateRequest(model, input, opts, true);
+        const res = await this.#post(endpoint, body, opts.signal);
+        if (!res.body)
+            throw new OllamaBackendError(`Ollama ${endpoint} returned no body for streaming`);
+        for await (const obj of readNdjson(res.body)) {
+            yield toGenerateChunk(obj, endpoint);
+        }
+    }
+    async #post(path, body, callerSignal) {
+        const signal = (0, backendHelpers_ts_1.composeSignal)(callerSignal, this.#requestTimeoutMs);
+        const res = await this.#fetch(`${this.#origin}${path}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal,
+        });
+        if (!res.ok) {
+            throw new OllamaBackendError(`Ollama ${path} returned HTTP ${res.status}`);
+        }
+        return res;
+    }
+}
+exports.OllamaBackend = OllamaBackend;
+/**
+ * Boot-bridge helper. Called from `resources/models/bootstrap.ts` for each
+ * `models.embedding.<name>` / `models.generative.<name>` entry whose
+ * `backend: ollama`.
+ */
+function registerOllamaBackend(args) {
+    const backend = new OllamaBackend(args.config);
+    if (args.kind === 'embedding')
+        (0, backendRegistry_ts_1.setEmbedding)(args.logicalName, backend);
+    else
+        (0, backendRegistry_ts_1.setGenerative)(args.logicalName, backend);
+}
+class OllamaBackendError extends hdbError_ts_1.ServerError {
+    constructor(message) {
+        super(message);
+        this.name = 'OllamaBackendError';
+    }
+}
+exports.OllamaBackendError = OllamaBackendError;
+// ---------- internals ----------
+function applyEmbedPrefix(model, text, inputType) {
+    if (!inputType)
+        return text;
+    // nomic-embed-text v1.5+ uses these application-layer prefixes to distinguish
+    // document-corpus encodings from query encodings. Models that don't recognize
+    // them silently return slightly different (still usable) vectors. Other model
+    // families (BGE, e5, etc.) use their own conventions; add cases as we validate.
+    if (/nomic-embed-text/i.test(model)) {
+        return (inputType === 'document' ? 'search_document: ' : 'search_query: ') + text;
+    }
+    return text;
+}
+function buildGenerateRequest(model, input, opts, stream) {
+    const optionsBag = buildOptionsBag(opts);
+    if (typeof input === 'string') {
+        return { endpoint: '/api/generate', body: { model, prompt: input, stream, ...optionsBag } };
+    }
+    const { messages, system } = normalizeMessages(input);
+    // Ollama chat has no top-level system field; prepend it as the first message
+    // when the caller supplied one separately.
+    const chatMessages = system
+        ? [{ role: 'system', content: system }, ...messages.map(toOllamaMessage)]
+        : messages.map(toOllamaMessage);
+    return { endpoint: '/api/chat', body: { model, messages: chatMessages, stream, ...optionsBag } };
+}
+function buildOptionsBag(opts) {
+    const out = {};
+    const options = {};
+    if (typeof opts.temperature === 'number')
+        options.temperature = opts.temperature;
+    if (typeof opts.maxTokens === 'number')
+        options.num_predict = opts.maxTokens;
+    if (Object.keys(options).length > 0)
+        out.options = options;
+    if (opts.responseFormat === 'json') {
+        out.format = 'json';
+    }
+    else if (opts.responseFormat && typeof opts.responseFormat === 'object' && 'schema' in opts.responseFormat) {
+        out.format = opts.responseFormat.schema;
+    }
+    return out;
+}
+function normalizeMessages(input) {
+    if (Array.isArray(input))
+        return { messages: input };
+    return { messages: input.messages, system: input.system };
+}
+function toOllamaMessage(m) {
+    // Tools intentionally not forwarded — see capabilities().tools = false.
+    return { role: m.role, content: m.content };
+}
+function mapFinishReason(reason) {
+    switch (reason) {
+        case 'length':
+            return 'length';
+        case 'stop':
+        default:
+            return 'stop';
+    }
+}
+function toGenerateChunk(data, endpoint) {
+    const chunk = {};
+    const deltaContent = endpoint === '/api/chat' ? data.message?.content : data.response;
+    if (typeof deltaContent === 'string' && deltaContent.length > 0)
+        chunk.deltaContent = deltaContent;
+    if (data.done === true)
+        chunk.finishReason = mapFinishReason(data.done_reason);
+    return chunk;
+}
+async function* readNdjson(body) {
+    const decoder = new TextDecoder('utf-8');
+    let buf = '';
+    for await (const chunk of body) {
+        buf += decoder.decode(chunk, { stream: true });
+        if (buf.length > MAX_NDJSON_LINE_BYTES) {
+            throw new OllamaBackendError(`Ollama NDJSON line exceeds ${MAX_NDJSON_LINE_BYTES} bytes without a newline`);
+        }
+        let nl;
+        while ((nl = buf.indexOf('\n')) >= 0) {
+            const line = buf.slice(0, nl).trim();
+            buf = buf.slice(nl + 1);
+            if (!line)
+                continue;
+            yield parseJsonLine(line);
+        }
+    }
+    buf += decoder.decode();
+    const tail = buf.trim();
+    if (tail)
+        yield parseJsonLine(tail);
+}
+function parseJsonLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        // Deliberately static — the JSON parser's message echoes the offending bytes,
+        // which can include upstream-derived content. Matches the sanitization posture
+        // of `hdb_model_calls.error_code` (analyticsTable.ts:35).
+        throw new OllamaBackendError('Invalid NDJSON line from Ollama');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/components/ollama/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../components/ollama/index.ts"],"names":[],"mappings":";;;AAgKA,sDAQC;AAxKD;;;;;;;;;;GAUG;AACH,kFAAwF;AACxF,gFAMkD;AAClD,kEAA+D;AAe/D,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,+EAA+E;AAatH;;;;;;;;;;;;GAYG;AACH,MAAa,aAAa;IAChB,IAAI,GAAG,QAAQ,CAAC;IAChB,OAAO,CAAS;IAChB,aAAa,CAAU;IACvB,iBAAiB,CAAU;IAC3B,MAAM,CAAe;IAE9B,YAAY,SAA8B,EAAE,EAAE,YAA0B,KAAK;QAC5E,IAAI,CAAC,OAAO,GAAG,IAAA,mCAAe,EAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,YAAY;QACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAwB,EAAE,IAA4B;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC;QAC/C,IAAA,gCAAY,EAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,MAAM,IAAA,qCAAiB,EAAsB,GAAG,EAAE,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;QACxG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,kBAAkB,CAAC,uDAAuD,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,IAAI,kBAAkB,CAC3B,8BAA8B,IAAI,CAAC,UAAU,CAAC,MAAM,gBAAgB,QAAQ,CAAC,MAAM,SAAS,CAC5F,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,kBAAkB,CAAC,qCAAqC,CAAC,oCAAoC,CAAC,CAAC;YAC1G,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,IAAA,0CAAsB,EAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACzE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAoB,EAAE,IAA+B;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC;QAC/C,IAAA,gCAAY,EAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QACpD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAA,qCAAiB,EACnC,GAAG,EACH,UAAU,QAAQ,EAAE,EACpB,kBAAkB,CAClB,CAAC;QACF,MAAM,UAAU,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpF,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,IAAI,kBAAkB,CAAC,UAAU,QAAQ,mCAAmC,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,IAAA,0CAAsB,EAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACtE,IAAA,0CAAsB,EAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,OAAO;YACN,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,IAAI,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;YACtF,KAAK;SACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,cAAc,CAAC,KAAoB,EAAE,IAA+B;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC;QAC/C,IAAA,gCAAY,EAAC,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QAC1D,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,MAAM,IAAI,kBAAkB,CAAC,UAAU,QAAQ,iCAAiC,CAAC,CAAC;QACjG,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAY,EAAE,YAA0B;QACjE,MAAM,MAAM,GAAG,IAAA,iCAAa,EAAC,YAAY,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM;SACN,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,kBAAkB,CAAC,UAAU,IAAI,kBAAkB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;CACD;AA5FD,sCA4FC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,IAIrC;IACA,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,IAAA,iCAAY,EAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;;QAClE,IAAA,kCAAa,EAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAa,kBAAmB,SAAQ,yBAAW;IAClD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AALD,gDAKC;AAED,kCAAkC;AAElC,SAAS,gBAAgB,CAAC,KAAa,EAAE,IAAY,EAAE,SAAgC;IACtF,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,8EAA8E;IAC9E,8EAA8E;IAC9E,8EAA8E;IAC9E,gFAAgF;IAChF,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAOD,SAAS,oBAAoB,CAC5B,KAAa,EACb,KAAoB,EACpB,IAA+B,EAC/B,MAAe;IAEf,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC;IAC7F,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACtD,6EAA6E;IAC7E,2CAA2C;IAC3C,MAAM,YAAY,GAAG,MAAM;QAC1B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAClF,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,eAAe,CAAC,IAA+B;IACvD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACjF,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3D,IAAI,IAAI,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;QACpC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,CAAC;SAAM,IAAI,IAAI,CAAC,cAAc,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,IAAI,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9G,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAqC;IAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe,CAAC,CAAU;IAClC,wEAAwE;IACxE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,MAAe;IACvC,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,QAAQ;YACZ,OAAO,QAAQ,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ;YACC,OAAO,MAAM,CAAC;IAChB,CAAC;AACF,CAAC;AAED,SAAS,eAAe,CAAC,IAAuB,EAAE,QAAuC;IACxF,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,MAAM,YAAY,GAAG,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACtF,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC;IACnG,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,KAAK,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC;AACd,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,UAAU,CAAC,IAAgC;IAC1D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAA4C,EAAE,CAAC;QACxE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,GAAG,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;YACxC,MAAM,IAAI,kBAAkB,CAAC,8BAA8B,qBAAqB,0BAA0B,CAAC,CAAC;QAC7G,CAAC;QACD,IAAI,EAAU,CAAC;QACf,OAAO,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACF,CAAC;IACD,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,IAAI;QAAE,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IAClC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACR,8EAA8E;QAC9E,+EAA+E;QAC/E,0DAA0D;QAC1D,MAAM,IAAI,kBAAkB,CAAC,iCAAiC,CAAC,CAAC;IACjE,CAAC;AACF,CAAC"}

package/dist/components/openai/index.d.ts

@@ -0,0 +1,51 @@
+import { ServerError } from '../../utility/errors/hdbError.ts';
+import type { BackendOpts, EmbedOpts, GenerateChunk, GenerateInput, GenerateOpts, GenerateResult, ModelBackend, ModelCallResult, ModelCapabilities } from '../../resources/models/types.ts';
+export type OpenAIBackendKind = 'embedding' | 'generative';
+export interface OpenAIBackendConfig {
+    /** Bearer token for the upstream API. Required. */
+    apiKey?: string;
+    /** Default model when the caller doesn't pass `opts.model`. */
+    model?: string;
+    /** Base URL of the OpenAI-compatible endpoint (default `https://api.openai.com/v1`). */
+    baseUrl?: string;
+    /** Per-request timeout. When set, combined with `opts.signal` via `AbortSignal.any`. */
+    requestTimeoutMs?: number;
+    /** Forwarded as `OpenAI-Organization` header when set. */
+    organization?: string;
+}
+/**
+ * `ModelBackend` implementation talking to OpenAI's HTTP API (or any
+ * OpenAI-compatible endpoint).
+ *
+ * - `embed` → `POST {baseUrl}/embeddings`
+ * - `generate` → `POST {baseUrl}/chat/completions` (always chat shape)
+ * - `generateStream` → same with `stream: true`; consumes SSE wire format and
+ *   yields `GenerateChunk` per delta.
+ *
+ * Capabilities advertise `tools: true` — first backend with native tool-call
+ * support. `adapters: false` — OpenAI doesn't expose LoRA adapter selection
+ * externally. `toolMode: 'return'` (Phase 1 default) is supported end-to-end;
+ * `toolMode: 'auto'` is reserved for #612.
+ */
+export declare class OpenAIBackend implements ModelBackend {
+    #private;
+    readonly name = "openai";
+    constructor(config?: OpenAIBackendConfig, fetchImpl?: typeof fetch);
+    capabilities(): ModelCapabilities;
+    embed(input: string | string[], opts: BackendOpts<EmbedOpts>): Promise<ModelCallResult<Float32Array[]>>;
+    generate(input: GenerateInput, opts: BackendOpts<GenerateOpts>): Promise<ModelCallResult<GenerateResult>>;
+    generateStream(input: GenerateInput, opts: BackendOpts<GenerateOpts>): AsyncIterable<GenerateChunk>;
+}
+/**
+ * Boot-bridge helper. Called from `resources/models/bootstrap.ts` for each
+ * `models.embedding.<name>` / `models.generative.<name>` entry whose
+ * `backend: openai`.
+ */
+export declare function registerOpenAIBackend(args: {
+    logicalName: string;
+    kind: OpenAIBackendKind;
+    config: OpenAIBackendConfig;
+}): void;
+export declare class OpenAIBackendError extends ServerError {
+    constructor(message: string);
+}