@harperfast/harper 5.2.0 → 5.2.2

package/dist/resources/models/v1/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `/v1/*` OpenAI-compatible gateway (#631).
+ *
+ * Registers three REST resources on the REST port:
+ *   POST /v1/embeddings          → V1Embeddings
+ *   POST /v1/chat/completions    → V1ChatCompletions
+ *   GET  /v1/models              → V1Models
+ *
+ * Off by default, and `defaultConfig.yaml` deliberately ships no `modelsGateway`
+ * block: with the key absent the root loader skips the component before resolving
+ * it, so none of this module graph is imported on an instance that does not use
+ * the gateway. Opt in by adding the block to `harperdb-config.yaml` with
+ * `enabled: true`, or via `set_configuration` (`modelsGateway_enabled`).
+ * `enabled: false` is honored too, for an instance that wants the block present
+ * but inert — that costs the import, which is why it is not the shipped default.
+ *
+ * Example (opt in). `rest` is required: these are REST-served resources and the
+ * gateway deliberately does not force REST to start (see `handleApplication`).
+ * Without it the resources register but every `/v1/*` path 404s.
+ *
+ * ```yaml
+ * rest: true
+ * modelsGateway:
+ *   enabled: true
+ * models:
+ *   generative:
+ *     default:
+ *       backend: ollama
+ *       model: llama3.2
+ * ```
+ *
+ * All three endpoints require `super_user` permission. Anonymous or
+ * insufficient-privilege requests receive a well-formed OpenAI error envelope.
+ */
+import type { Scope } from '../../../components/Scope.ts';
+export declare function handleApplication(scope: Scope): void;

package/dist/resources/models/v1/index.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * `/v1/*` OpenAI-compatible gateway (#631).
+ *
+ * Registers three REST resources on the REST port:
+ *   POST /v1/embeddings          → V1Embeddings
+ *   POST /v1/chat/completions    → V1ChatCompletions
+ *   GET  /v1/models              → V1Models
+ *
+ * Off by default, and `defaultConfig.yaml` deliberately ships no `modelsGateway`
+ * block: with the key absent the root loader skips the component before resolving
+ * it, so none of this module graph is imported on an instance that does not use
+ * the gateway. Opt in by adding the block to `harperdb-config.yaml` with
+ * `enabled: true`, or via `set_configuration` (`modelsGateway_enabled`).
+ * `enabled: false` is honored too, for an instance that wants the block present
+ * but inert — that costs the import, which is why it is not the shipped default.
+ *
+ * Example (opt in). `rest` is required: these are REST-served resources and the
+ * gateway deliberately does not force REST to start (see `handleApplication`).
+ * Without it the resources register but every `/v1/*` path 404s.
+ *
+ * ```yaml
+ * rest: true
+ * modelsGateway:
+ *   enabled: true
+ * models:
+ *   generative:
+ *     default:
+ *       backend: ollama
+ *       model: llama3.2
+ * ```
+ *
+ * All three endpoints require `super_user` permission. Anonymous or
+ * insufficient-privilege requests receive a well-formed OpenAI error envelope.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleApplication = handleApplication;
+const harper_logger_ts_1 = __importDefault(require("../../../utility/logging/harper_logger.js"));
+const configUtils_ts_1 = require("../../../config/configUtils.js");
+const embeddings_ts_1 = require("./embeddings.js");
+const chatCompletions_ts_1 = require("./chatCompletions.js");
+const models_ts_1 = require("./models.js");
+function handleApplication(scope) {
+    if (!scope.options.get(['enabled']))
+        return;
+    // These resources are served by REST's middleware chain, so the instance must also
+    // have a `rest`/`REST` config section — the gateway deliberately does NOT force REST
+    // to start. Doing so requires reaching into REST's module state before application
+    // configs have loaded, which silently discards an app's own `rest` options (webSocket,
+    // urlPath/host, middleware ordering). Core has no supported way yet for a component to
+    // declare "I serve REST resources"; that gap is tracked separately.
+    //
+    // Warn rather than fail: an app loaded later may still declare `rest`, so absence here
+    // is not conclusive. But defaultConfig ships no `rest` section, so enabling the gateway
+    // alone yields three registered resources and a 404 on every /v1 path — worth a line in
+    // the log instead of silence.
+    const rootConfig = (0, configUtils_ts_1.getConfigObj)();
+    if (rootConfig && !rootConfig.rest && !rootConfig.REST) {
+        harper_logger_ts_1.default.warn('modelsGateway is enabled but no `rest` section is configured; /v1/* endpoints are only served when REST is active');
+    }
+    // Explicit protocol visibility: these are REST-only wire-protocol endpoints. Without a
+    // policy, the shared registry matches them for every protocol lookup — WS dispatch could
+    // reach V1ChatCompletions.connect() and then fail iterating its non-iterable badRequest
+    // envelope, and they would surface through MQTT/GraphQL/MCP enumeration too. `sse` stays
+    // enabled for chat only: an explicit `Accept: text/event-stream` POST is dispatched via
+    // the sse lookup (REST.ts) and is a supported streaming client shape (see connect()).
+    const restOnly = { rest: true, sse: false, ws: false, mqtt: false, graphql: false, mcp: false };
+    scope.resources.set('v1/models', models_ts_1.V1Models, restOnly);
+    scope.resources.set('v1/embeddings', embeddings_ts_1.V1Embeddings, restOnly);
+    scope.resources.set('v1/chat/completions', chatCompletions_ts_1.V1ChatCompletions, { ...restOnly, sse: true });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/models/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../resources/models/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;;;AASH,8CA6BC;AAnCD,iGAAqE;AACrE,mEAA8D;AAC9D,mDAA+C;AAC/C,6DAAyD;AACzD,2CAAuC;AAEvC,SAAgB,iBAAiB,CAAC,KAAY;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO;IAC5C,mFAAmF;IACnF,qFAAqF;IACrF,mFAAmF;IACnF,uFAAuF;IACvF,uFAAuF;IACvF,oEAAoE;IACpE,EAAE;IACF,uFAAuF;IACvF,wFAAwF;IACxF,wFAAwF;IACxF,8BAA8B;IAC9B,MAAM,UAAU,GAAG,IAAA,6BAAY,GAAyC,CAAC;IACzE,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACxD,0BAAY,CAAC,IAAI,CAChB,mHAAmH,CACnH,CAAC;IACH,CAAC;IACD,uFAAuF;IACvF,yFAAyF;IACzF,wFAAwF;IACxF,yFAAyF;IACzF,wFAAwF;IACxF,sFAAsF;IACtF,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAChG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,oBAAQ,EAAE,QAAQ,CAAC,CAAC;IACrD,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,EAAE,4BAAY,EAAE,QAAQ,CAAC,CAAC;IAC7D,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,qBAAqB,EAAE,sCAAiB,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/resources/models/v1/models.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `GET /v1/models` — OpenAI-compatible model list endpoint (#631).
+ *
+ * Enumerates all registered embedding and generative backends from the
+ * process-wide `backendRegistry`. The response mirrors the OpenAI shape:
+ * `{ object: 'list', data: [{ id, object: 'model', created, owned_by }] }`.
+ *
+ * `logicalName` (not `backend.name`) is the `id` — it's what callers pass as
+ * `model` in subsequent requests.
+ */
+import { Resource } from '../../Resource.ts';
+import { type OpenAIErrorResponse } from './errors.ts';
+export interface OAIModelEntry {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+export interface OAIModelList {
+    object: 'list';
+    data: OAIModelEntry[];
+}
+export declare class V1Models extends Resource {
+    static reservedPath: boolean;
+    static get(_target: unknown, request: unknown): OAIModelList | OpenAIErrorResponse;
+}

package/dist/resources/models/v1/models.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * `GET /v1/models` — OpenAI-compatible model list endpoint (#631).
+ *
+ * Enumerates all registered embedding and generative backends from the
+ * process-wide `backendRegistry`. The response mirrors the OpenAI shape:
+ * `{ object: 'list', data: [{ id, object: 'model', created, owned_by }] }`.
+ *
+ * `logicalName` (not `backend.name`) is the `id` — it's what callers pass as
+ * `model` in subsequent requests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1Models = void 0;
+const Resource_ts_1 = require("../../Resource.js");
+const backendRegistry_ts_1 = require("../backendRegistry.js");
+const errors_ts_1 = require("./errors.js");
+// @ts-ignore — Resource base class is not typed for static dispatch; pattern mirrors login.ts
+class V1Models extends Resource_ts_1.Resource {
+    // Reserve this fixed route: a later app registration at the same path becomes a
+    // loud conflict (ErrorResource) instead of silently replacing the gateway and its
+    // super_user gate. See Resources.set.
+    static reservedPath = true;
+    static get(_target, request) {
+        const authError = (0, errors_ts_1.authorizeV1Request)(request);
+        if (authError)
+            return authError;
+        const created = Math.floor(Date.now() / 1000);
+        // OpenAI model ids are unique; a logical name registered for both generative and
+        // embedding (e.g. `default` in each section) is one model id to callers.
+        const ids = new Set();
+        const data = [];
+        for (const kind of ['generative', 'embedding']) {
+            for (const { logicalName } of (0, backendRegistry_ts_1.listBackends)(kind)) {
+                if (ids.has(logicalName))
+                    continue;
+                ids.add(logicalName);
+                data.push({ id: logicalName, object: 'model', created, owned_by: 'harper' });
+            }
+        }
+        return { object: 'list', data };
+    }
+}
+exports.V1Models = V1Models;
+//# sourceMappingURL=models.js.map

package/dist/resources/models/v1/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../resources/models/v1/models.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mDAA6C;AAC7C,8DAAqD;AACrD,2CAA2E;AAc3E,8FAA8F;AAC9F,MAAa,QAAS,SAAQ,sBAAQ;IACrC,gFAAgF;IAChF,kFAAkF;IAClF,sCAAsC;IACtC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IAE3B,MAAM,CAAC,GAAG,CAAC,OAAgB,EAAE,OAAgB;QAC5C,MAAM,SAAS,GAAG,IAAA,8BAAkB,EAAC,OAAc,CAAC,CAAC;QACrD,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,iFAAiF;QACjF,yEAAyE;QACzE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,WAAW,CAAU,EAAE,CAAC;YACzD,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,IAAA,iCAAY,EAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC;oBAAE,SAAS;gBACnC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC9E,CAAC;QACF,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;;AAvBF,4BAwBC"}

package/dist/resources/models/v1/translation.d.ts

@@ -0,0 +1,133 @@
+/**
+ * OpenAI ↔ Harper internal shape mappers for the `/v1/*` gateway (#631).
+ *
+ * All functions are pure (no I/O, no side-effects) so they can be unit-tested
+ * in isolation without a running Harper instance.
+ */
+import type { EmbedOpts, GenerateInput, GenerateOpts, GenerateResult, Message, ToolDef, TokenUsage } from '../types.ts';
+export interface OAIMessageIn {
+    role: string;
+    /** May be null for assistant messages that only contain tool_calls. */
+    content: string | null;
+    tool_calls?: Array<{
+        id: string;
+        type: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    /** Present on role === 'tool' messages. */
+    tool_call_id?: string;
+}
+export interface OAIToolIn {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters?: object;
+    };
+}
+export interface OAIChatRequest {
+    model?: string;
+    messages: OAIMessageIn[];
+    tools?: OAIToolIn[];
+    /** Subset recognised: 'none' | 'auto' | 'required' | {type:'function', function:{name}}. */
+    tool_choice?: unknown;
+    temperature?: number;
+    /** OpenAI v1 field; superseded by max_completion_tokens in v1+. */
+    max_tokens?: number;
+    /** Preferred alias; takes precedence over max_tokens when both present. */
+    max_completion_tokens?: number;
+    response_format?: {
+        type: string;
+        json_schema?: unknown;
+    };
+    stream?: boolean;
+}
+/**
+ * Map an OpenAI `messages` array to Harper `Message[]`.
+ * Normalises `tool_calls[].function.arguments` from JSON strings to parsed
+ * objects (Harper's internal contract); maps `tool_call_id` to `toolCallId`.
+ */
+export declare function translateMessages(oaiMessages: OAIMessageIn[]): Message[];
+/** Map OpenAI `tools[]` to Harper `ToolDef[]`. */
+export declare function translateTools(oaiTools: OAIToolIn[]): ToolDef[];
+/**
+ * Build Harper `GenerateInput` from translated messages and tool definitions.
+ * Uses the object form `{ messages, tools }` when tools are present, so that
+ * tool definitions travel alongside messages per Harper's type contract.
+ */
+export declare function toGenerateInput(messages: Message[], tools: ToolDef[] | undefined): GenerateInput;
+/**
+ * Validate the OpenAI wire shapes this gateway maps, returning a client-facing
+ * message for a 400 or `null` when the request is well-formed.
+ *
+ * Kept separate from the mappers so malformed nested input (`messages: [null]`,
+ * `tool_calls: [{}]`, `tools: [{}]`) becomes an OpenAI-shaped 400 instead of a
+ * TypeError escaping the handler as an RFC 9457 500.
+ */
+export declare function validateChatRequest(body: OAIChatRequest): string | null;
+/**
+ * Map an OpenAI chat-completion request body to `GenerateOpts`.
+ *
+ * `tool_choice` is honored by the caller, not here: `'none'` omits tools from the
+ * generate input entirely, and unrepresentable choices are rejected up front by
+ * `validateChatRequest`. Full in-process tool-call orchestration is #612 (out of
+ * scope for #631), so tool calls are always returned to the caller to invoke.
+ *
+ * Assumes `validateChatRequest` has already passed.
+ */
+export declare function toGenerateOpts(body: OAIChatRequest): GenerateOpts;
+/** Map an OpenAI embeddings request body to `EmbedOpts`. */
+export declare function toEmbedOpts(body: {
+    model?: string;
+}): EmbedOpts;
+interface OAIToolCallOut {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+interface OAIAssistantMessage {
+    role: 'assistant';
+    /** null when the message contains only tool_calls. */
+    content: string | null;
+    tool_calls?: OAIToolCallOut[];
+}
+export interface OAIChatCompletion {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: OAIAssistantMessage;
+        finish_reason: string;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/** Map a Harper `GenerateResult` to an OpenAI `chat.completion` response object. */
+export declare function toChatCompletion(result: GenerateResult, model: string, id?: string): OAIChatCompletion;
+export interface OAIEmbedResponse {
+    object: 'list';
+    data: Array<{
+        embedding: number[];
+        index: number;
+        object: 'embedding';
+    }>;
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+/** Map `Float32Array[]` from `models.embed()` to an OpenAI embeddings response. */
+export declare function toEmbedResponse(vecs: Float32Array[], model: string, usage?: TokenUsage): OAIEmbedResponse;
+export {};

package/dist/resources/models/v1/translation.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * OpenAI ↔ Harper internal shape mappers for the `/v1/*` gateway (#631).
+ *
+ * All functions are pure (no I/O, no side-effects) so they can be unit-tested
+ * in isolation without a running Harper instance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translateMessages = translateMessages;
+exports.translateTools = translateTools;
+exports.toGenerateInput = toGenerateInput;
+exports.validateChatRequest = validateChatRequest;
+exports.toGenerateOpts = toGenerateOpts;
+exports.toEmbedOpts = toEmbedOpts;
+exports.toChatCompletion = toChatCompletion;
+exports.toEmbedResponse = toEmbedResponse;
+const node_crypto_1 = require("node:crypto");
+// ---------------------------------------------------------------------------
+// OpenAI request → Harper internal
+// ---------------------------------------------------------------------------
+/**
+ * Map an OpenAI `messages` array to Harper `Message[]`.
+ * Normalises `tool_calls[].function.arguments` from JSON strings to parsed
+ * objects (Harper's internal contract); maps `tool_call_id` to `toolCallId`.
+ */
+function translateMessages(oaiMessages) {
+    return oaiMessages.map((m) => {
+        // Content parts are flattened to the text Harper's Message.content expects; shapes
+        // that cannot be flattened are rejected up front by validateChatRequest.
+        const content = Array.isArray(m.content)
+            ? m.content.map((part) => part.text).join('')
+            : (m.content ?? '');
+        const base = {
+            // `developer` is OpenAI's successor to `system` (the API itself treats the two
+            // identically, converting `system` to `developer` on models that use the newer
+            // hierarchy). Harper's internal Message union carries the channel as `system`,
+            // which every provider adapter maps to its system-instruction slot — so the
+            // instruction's priority is preserved rather than degraded to `user`. Roles
+            // outside the union are rejected up front by validateChatRequest, so the cast
+            // below is over a vetted set.
+            role: m.role === 'developer' ? 'system' : m.role,
+            content,
+        };
+        if (m.tool_calls?.length) {
+            base.toolCalls = m.tool_calls.map((tc) => {
+                let args;
+                try {
+                    args = JSON.parse(tc.function.arguments);
+                }
+                catch {
+                    // Preserve unparseable argument strings under a sentinel key rather
+                    // than dropping them — backend can decide what to do.
+                    args = { _raw: tc.function.arguments };
+                }
+                return { id: tc.id, name: tc.function.name, arguments: args };
+            });
+        }
+        if (m.tool_call_id)
+            base.toolCallId = m.tool_call_id;
+        return base;
+    });
+}
+/** Map OpenAI `tools[]` to Harper `ToolDef[]`. */
+function translateTools(oaiTools) {
+    return oaiTools.map((t) => ({
+        name: t.function.name,
+        description: t.function.description ?? '',
+        parameters: t.function.parameters ?? {},
+    }));
+}
+/**
+ * Build Harper `GenerateInput` from translated messages and tool definitions.
+ * Uses the object form `{ messages, tools }` when tools are present, so that
+ * tool definitions travel alongside messages per Harper's type contract.
+ */
+function toGenerateInput(messages, tools) {
+    if (tools?.length)
+        return { messages, tools };
+    return messages;
+}
+/** `tool_choice` values the internal contract can faithfully represent. */
+function isRepresentableToolChoice(choice) {
+    return choice === undefined || choice === null || choice === 'auto' || choice === 'none';
+}
+/**
+ * Validate the OpenAI wire shapes this gateway maps, returning a client-facing
+ * message for a 400 or `null` when the request is well-formed.
+ *
+ * Kept separate from the mappers so malformed nested input (`messages: [null]`,
+ * `tool_calls: [{}]`, `tools: [{}]`) becomes an OpenAI-shaped 400 instead of a
+ * TypeError escaping the handler as an RFC 9457 500.
+ */
+function validateChatRequest(body) {
+    const req = body;
+    // Top-level fields that control routing and framing first: a non-string `model`
+    // would silently invoke the configured default model (potentially expensive), and a
+    // truthy non-boolean `stream` ("false") would return SSE the client didn't ask for.
+    if (req.model !== undefined && typeof req.model !== 'string')
+        return "'model' must be a string";
+    if (req.stream !== undefined && typeof req.stream !== 'boolean')
+        return "'stream' must be a boolean";
+    if (req.temperature !== undefined) {
+        if (typeof req.temperature !== 'number' || !Number.isFinite(req.temperature)) {
+            return "'temperature' must be a finite number";
+        }
+        if (req.temperature < 0 || req.temperature > 2)
+            return "'temperature' must be between 0 and 2";
+    }
+    for (const field of ['max_tokens', 'max_completion_tokens']) {
+        const value = req[field];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+            return `'${field}' must be a positive integer`;
+        }
+    }
+    if (!Array.isArray(req.messages) || req.messages.length === 0)
+        return "'messages' must be a non-empty array";
+    for (let i = 0; i < req.messages.length; i++) {
+        const m = req.messages[i];
+        if (!m || typeof m !== 'object' || Array.isArray(m))
+            return `'messages[${i}]' must be an object`;
+        if (typeof m.role !== 'string')
+            return `'messages[${i}].role' must be a string`;
+        // Closed set: translateMessages casts into Harper's Message union, so an
+        // unknown role must be a loud 400 here — previously it was cast through and
+        // provider adapters degraded it to 'user', silently changing its priority.
+        // 'developer' is accepted and carried as 'system' (see translateMessages);
+        // the deprecated 'function' role is deliberately not supported.
+        if (!['system', 'developer', 'user', 'assistant', 'tool'].includes(m.role)) {
+            return `'messages[${i}].role' must be one of 'system', 'developer', 'user', 'assistant', 'tool'`;
+        }
+        // OpenAI allows content parts: [{ type: 'text', text: '...' }, ...]. Harper's
+        // Message.content is a string, so those are flattened in translateMessages; reject
+        // shapes we cannot flatten rather than passing a non-string downstream.
+        if (m.content !== undefined && m.content !== null && typeof m.content !== 'string') {
+            if (!Array.isArray(m.content))
+                return `'messages[${i}].content' must be a string, array of parts, or null`;
+            for (let p = 0; p < m.content.length; p++) {
+                const part = m.content[p];
+                if (!part || typeof part !== 'object')
+                    return `'messages[${i}].content[${p}]' must be an object`;
+                if (part.type !== 'text' || typeof part.text !== 'string') {
+                    return `'messages[${i}].content[${p}]' must be a text part ({ type: 'text', text: string }); other part types are not supported yet`;
+                }
+            }
+        }
+        if (m.tool_calls !== undefined) {
+            if (!Array.isArray(m.tool_calls))
+                return `'messages[${i}].tool_calls' must be an array`;
+            for (let j = 0; j < m.tool_calls.length; j++) {
+                const tc = m.tool_calls[j];
+                const at = `'messages[${i}].tool_calls[${j}]`;
+                if (!tc || typeof tc !== 'object')
+                    return `${at}' must be an object`;
+                if (!tc.function || typeof tc.function !== 'object')
+                    return `${at}.function' is required`;
+                if (typeof tc.function.name !== 'string')
+                    return `${at}.function.name' must be a string`;
+                if (typeof tc.function.arguments !== 'string')
+                    return `${at}.function.arguments' must be a JSON string`;
+            }
+        }
+    }
+    if (req.tools !== undefined) {
+        if (!Array.isArray(req.tools))
+            return "'tools' must be an array";
+        for (let i = 0; i < req.tools.length; i++) {
+            const t = req.tools[i];
+            if (!t || typeof t !== 'object')
+                return `'tools[${i}]' must be an object`;
+            if (!t.function || typeof t.function !== 'object')
+                return `'tools[${i}].function' is required`;
+            if (typeof t.function.name !== 'string')
+                return `'tools[${i}].function.name' must be a string`;
+        }
+    }
+    if (!isRepresentableToolChoice(req.tool_choice)) {
+        // Better a clear 400 than silently downgrading 'required'/named selection to 'auto'.
+        return "'tool_choice' supports 'auto' and 'none'; 'required' and named function selection are not supported yet";
+    }
+    if (req.response_format !== undefined) {
+        const rf = req.response_format;
+        if (!rf || typeof rf !== 'object' || Array.isArray(rf))
+            return "'response_format' must be an object";
+        if (rf.type === 'json_schema') {
+            const wrapper = rf.json_schema;
+            if (!wrapper || typeof wrapper !== 'object') {
+                return "'response_format.json_schema' is required when type is 'json_schema'";
+            }
+            if (!wrapper.schema || typeof wrapper.schema !== 'object') {
+                return "'response_format.json_schema.schema' must be a JSON Schema object";
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Map an OpenAI chat-completion request body to `GenerateOpts`.
+ *
+ * `tool_choice` is honored by the caller, not here: `'none'` omits tools from the
+ * generate input entirely, and unrepresentable choices are rejected up front by
+ * `validateChatRequest`. Full in-process tool-call orchestration is #612 (out of
+ * scope for #631), so tool calls are always returned to the caller to invoke.
+ *
+ * Assumes `validateChatRequest` has already passed.
+ */
+function toGenerateOpts(body) {
+    const opts = { toolMode: 'return' };
+    if (typeof body.model === 'string')
+        opts.model = body.model;
+    if (typeof body.temperature === 'number')
+        opts.temperature = body.temperature;
+    const maxTokens = body.max_completion_tokens ?? body.max_tokens;
+    if (typeof maxTokens === 'number')
+        opts.maxTokens = maxTokens;
+    if (body.response_format) {
+        const rf = body.response_format;
+        if (rf.type === 'json_object') {
+            opts.responseFormat = 'json';
+        }
+        else if (rf.type === 'json_schema') {
+            // The wire value is a wrapper ({ name, strict, schema }); Harper's contract wants
+            // the JSON Schema itself. Passing the wrapper makes the backend wrap it again and
+            // send metadata where the provider expects the schema.
+            opts.responseFormat = { schema: rf.json_schema.schema };
+        }
+        else {
+            opts.responseFormat = 'text';
+        }
+    }
+    return opts;
+}
+/** Map an OpenAI embeddings request body to `EmbedOpts`. */
+function toEmbedOpts(body) {
+    const opts = {};
+    if (typeof body.model === 'string')
+        opts.model = body.model;
+    return opts;
+}
+function toOAIToolCalls(toolCalls) {
+    return toolCalls.map((tc) => ({
+        id: tc.id,
+        type: 'function',
+        // Guard against backends that return arguments as a pre-serialised JSON string;
+        // passing a string through JSON.stringify would double-encode it.
+        function: {
+            name: tc.name,
+            arguments: typeof tc.arguments === 'string' ? tc.arguments : JSON.stringify(tc.arguments),
+        },
+    }));
+}
+/** Map a Harper `GenerateResult` to an OpenAI `chat.completion` response object. */
+function toChatCompletion(result, model, id) {
+    const completionId = id ?? `chatcmpl-${(0, node_crypto_1.randomUUID)().replaceAll('-', '')}`;
+    const hasTools = !!result.toolCalls?.length;
+    const message = {
+        role: 'assistant',
+        // OpenAI sets content to null when there are tool calls and no text content.
+        content: result.content || (hasTools ? null : ''),
+    };
+    if (hasTools)
+        message.tool_calls = toOAIToolCalls(result.toolCalls);
+    const usage = result.usage ?? {};
+    return {
+        id: completionId,
+        object: 'chat.completion',
+        created: Math.floor(Date.now() / 1000),
+        model,
+        choices: [{ index: 0, message, finish_reason: result.finishReason }],
+        usage: {
+            prompt_tokens: usage.promptTokens ?? 0,
+            completion_tokens: usage.completionTokens ?? 0,
+            total_tokens: (usage.promptTokens ?? 0) + (usage.completionTokens ?? 0),
+        },
+    };
+}
+/** Map `Float32Array[]` from `models.embed()` to an OpenAI embeddings response. */
+function toEmbedResponse(vecs, model, usage) {
+    return {
+        object: 'list',
+        data: vecs.map((vec, index) => ({
+            embedding: Array.from(vec),
+            index,
+            object: 'embedding',
+        })),
+        model,
+        // Embeddings have no completion side, so OpenAI reports the same count in both
+        // fields. Harper backends spell it `embeddingTokens` (with `promptTokens` as a
+        // fallback for backends that report it that way); mapping must be symmetric —
+        // a backend supplying only embeddingTokens must not leave prompt_tokens at 0.
+        usage: {
+            prompt_tokens: usage?.embeddingTokens ?? usage?.promptTokens ?? 0,
+            total_tokens: usage?.embeddingTokens ?? usage?.promptTokens ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=translation.js.map

package/dist/resources/models/v1/translation.js.map

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

package/dist/resources/roles.d.ts

@@ -2,4 +2,4 @@
  * This is the component for handling role declarations in the Harper system. This will read roles.yaml for role
  * definitions and ensure that they are created in the system database.
  */
-export declare function handleApplication(scope: import('../components/Scope.ts').Scope): void;
+export declare function handleApplication(scope: import('../components/Scope.ts').Scope, ensureRoleFn?: (role: any) => Promise<unknown>): void;