@haikit/openai 0.0.0-stage → 0.21.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hai contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @haikit/openai
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Model adapter for OpenAI models, over the Responses API.
+
+```ts
+import { openai } from "@haikit/openai";
+createHai({ model: openai({ model: "gpt-6-luna", effort: "medium" }), … });
+```
+
+With no `model`, it uses `gpt-6-luna`; pass any other model ID to change it.
+`effort` defaults to `medium`; pass `effort: null` for a model that doesn't
+reason, such as `gpt-4.1`, and no reasoning settings are sent. The key comes
+from `OPENAI_API_KEY` unless you pass `apiKey`.
+
+Note it imports only `@haikit/core`, never `@haikit/server`. Adapters implement an
+interface the contract layer declares — that is what keeps the runtime
+swappable, and what lets an app ship its own adapter without forking anything
+(see `examples/*/src/server/scripted.ts`).
+
+HaiKIT keeps the history in the Anthropic Messages shape, so this adapter
+translates it into Responses API input on every call, and the reply back. It
+sends the whole history each time with `store: false` rather than chaining
+`previous_response_id`: the conversation lives in your store, not OpenAI's.
+Reasoning items come back encrypted and are kept in the history, so the next
+call can send them back.
+
+A tool keeps strict mode only when OpenAI's strict mode accepts its schema:
+every object lists all its properties in `required` and sets
+`additionalProperties: false`. Any other tool is sent with `strict: false`.
+
+A conversation begun with this adapter can't be continued with
+`@haikit/anthropic`, or the other way round: each provider's reasoning blocks
+mean nothing to the other.

package/dist/adapter.d.ts

@@ -0,0 +1,31 @@
+import type { ModelAdapter } from "@haikit/core";
+/**
+ * OpenAI model adapter, over the Responses API.
+ *
+ * Note it imports only hai-core, never hai-server. Adapters implement an
+ * interface the contract layer declares; that is what keeps the runtime
+ * swappable, and what lets an app ship its own adapter without forking the
+ * framework.
+ *
+ * It sends the whole history on every call with `store: false`, rather than
+ * chaining `previous_response_id`: the conversation lives in the app's store,
+ * which HaiKIT itself writes into between calls, and one conversation's calls
+ * can come from different servers.
+ */
+export interface OpenAIOptions {
+    /** Any OpenAI model ID. Defaults to `gpt-6-luna`. */
+    model?: string;
+    maxTokens?: number;
+    /**
+     * Defaults to `medium`. `null` sends no reasoning settings at all, for a
+     * model that doesn't reason and so refuses them.
+     */
+    effort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null;
+    apiKey?: string;
+    baseURL?: string;
+    /** Sent as `prompt_cache_key`, to route calls that share a prefix together. */
+    promptCacheKey?: string;
+}
+/** The adapter, given a way to make the client: tests pass a fake one. */
+export declare function createAdapter(options: OpenAIOptions, makeClient: () => Promise<any>): ModelAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,cAAc,CAAC;AAG9E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAmClG"}

package/dist/adapter.js

@@ -0,0 +1,35 @@
+import { fromOutput, toInput, toTools } from "./mapping.js";
+/** The adapter, given a way to make the client: tests pass a fake one. */
+export function createAdapter(options, makeClient) {
+    const model = options.model ?? "gpt-6-luna";
+    const effort = options.effort === undefined ? "medium" : options.effort;
+    let client = null;
+    return {
+        id: model,
+        async generate(request) {
+            if (!client)
+                client = await makeClient();
+            const stream = client.responses.stream({
+                model,
+                // Stable prefix: OpenAI caches it on its own, so nothing volatile may
+                // go in here.
+                instructions: request.system,
+                tools: toTools(request.tools),
+                input: toInput(request.messages),
+                max_output_tokens: options.maxTokens ?? 16000,
+                store: false,
+                // Encrypted reasoning comes back only when asked for, and a model that
+                // doesn't reason refuses both.
+                ...(effort === null ? {} : { reasoning: { effort }, include: ["reasoning.encrypted_content"] }),
+                ...(options.promptCacheKey ? { prompt_cache_key: options.promptCacheKey } : {}),
+            });
+            for await (const event of stream) {
+                if (event.type === "response.output_text.delta" || event.type === "response.refusal.delta") {
+                    request.onTextDelta(event.delta);
+                }
+            }
+            return fromOutput(await stream.finalResponse());
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA8B5D,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,OAAsB,EAAE,UAA8B;IAClF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxE,IAAI,MAAM,GAAQ,IAAI,CAAC;IAEvB,OAAO;QACL,EAAE,EAAE,KAAK;QAET,KAAK,CAAC,QAAQ,CAAC,OAAqB;YAClC,IAAI,CAAC,MAAM;gBAAE,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;YAEzC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;gBACrC,KAAK;gBACL,sEAAsE;gBACtE,cAAc;gBACd,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC7B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAChC,iBAAiB,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;gBAC7C,KAAK,EAAE,KAAK;gBACZ,uEAAuE;gBACvE,+BAA+B;gBAC/B,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,6BAA6B,CAAC,EAAE,CAAC;gBAC/F,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChF,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACjC,IAAI,KAAK,CAAC,IAAI,KAAK,4BAA4B,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;oBAC3F,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YAED,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { ModelAdapter } from "@haikit/core";
+import { type OpenAIOptions } from "./adapter.js";
+export type { OpenAIOptions };
+export declare function openai(options?: OpenAIOptions): ModelAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAQhE"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { createAdapter } from "./adapter.js";
+export function openai(options = {}) {
+    return createAdapter(options, async () => {
+        const { default: OpenAI } = await import("openai");
+        return new OpenAI({
+            ...(options.apiKey ? { apiKey: options.apiKey } : {}),
+            ...(options.baseURL ? { baseURL: options.baseURL } : {}),
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAsB,MAAM,cAAc,CAAC;AAIjE,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IAChD,OAAO,aAAa,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,IAAI,MAAM,CAAC;YAChB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,20 @@
+import type { Message, ModelRequest, ModelResponse } from "@haikit/core";
+/**
+ * The history is kept in the Anthropic Messages shape, so this adapter's work
+ * is translation: the history into Responses API input items on the way out,
+ * and the response's output items back into content blocks on the way in.
+ * Everything here is pure, so it can be tested without the network.
+ */
+/** A reasoning item kept in the history so the next call can send it back. */
+export declare const REASONING_BLOCK = "openai_reasoning";
+export declare function toInput(messages: readonly Message[]): any[];
+/**
+ * Whether OpenAI's strict mode accepts this schema: every object lists all of
+ * its properties in `required` and sets `additionalProperties: false`, all the
+ * way down. Sending `strict: true` on a schema that doesn't would fail the
+ * whole turn, so such a tool goes without strict mode instead.
+ */
+export declare function isStrictCompatible(schema: unknown): boolean;
+export declare function toTools(tools: ModelRequest["tools"]): any[];
+export declare function fromOutput(response: any): ModelResponse;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEzE;;;;;GAKG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAkBlD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,GAAG,EAAE,CA2C3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAoB3D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,CAS3D;AAYD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,GAAG,GAAG,aAAa,CAiCvD"}

package/dist/mapping.js

@@ -0,0 +1,169 @@
+/**
+ * The history is kept in the Anthropic Messages shape, so this adapter's work
+ * is translation: the history into Responses API input items on the way out,
+ * and the response's output items back into content blocks on the way in.
+ * Everything here is pure, so it can be tested without the network.
+ */
+/** A reasoning item kept in the history so the next call can send it back. */
+export const REASONING_BLOCK = "openai_reasoning";
+function refuse(what) {
+    throw new Error(`[haikit] openai: cannot send ${what} to OpenAI`);
+}
+/** A `tool_result`'s content, as the single string `function_call_output` takes. */
+function resultText(content) {
+    if (content === undefined || content === null)
+        return "";
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((b) => (b?.type === "text" && typeof b.text === "string" ? b.text : refuse(`a "${b?.type}" block in a tool_result`)))
+            .join("\n");
+    }
+    return refuse("a tool_result whose content is not a string or an array");
+}
+export function toInput(messages) {
+    const input = [];
+    for (const message of messages) {
+        const { role, content } = message;
+        if (typeof content === "string") {
+            input.push({ role, content });
+            continue;
+        }
+        if (!Array.isArray(content))
+            refuse(`a ${role} message whose content is not a string or an array`);
+        if (role === "user") {
+            // A function call's output must follow the call, so the results go
+            // first: the runtime puts notices' text after them in the same message.
+            const texts = [];
+            for (const block of content) {
+                if (block?.type === "tool_result") {
+                    input.push({ type: "function_call_output", call_id: block.tool_use_id, output: resultText(block.content) });
+                }
+                else if (block?.type === "text") {
+                    texts.push({ type: "input_text", text: block.text });
+                }
+                else {
+                    refuse(`a "${block?.type}" block in a user message`);
+                }
+            }
+            if (texts.length > 0)
+                input.push({ role: "user", content: texts });
+            continue;
+        }
+        for (const block of content) {
+            if (block?.type === "text") {
+                if (block.text)
+                    input.push({ role: "assistant", content: block.text });
+            }
+            else if (block?.type === "tool_use") {
+                input.push({ type: "function_call", call_id: block.id, name: block.name, arguments: JSON.stringify(block.input ?? {}) });
+            }
+            else if (block?.type === REASONING_BLOCK) {
+                input.push({ type: "reasoning", id: block.id, summary: block.summary ?? [], encrypted_content: block.encrypted_content });
+            }
+            else {
+                refuse(`a "${block?.type}" block in an assistant message`);
+            }
+        }
+    }
+    return input;
+}
+/**
+ * Whether OpenAI's strict mode accepts this schema: every object lists all of
+ * its properties in `required` and sets `additionalProperties: false`, all the
+ * way down. Sending `strict: true` on a schema that doesn't would fail the
+ * whole turn, so such a tool goes without strict mode instead.
+ */
+export function isStrictCompatible(schema) {
+    if (schema === null || typeof schema !== "object")
+        return true;
+    if (Array.isArray(schema))
+        return schema.every(isStrictCompatible);
+    const s = schema;
+    const isObject = s.type === "object" || (Array.isArray(s.type) && s.type.includes("object")) || "properties" in s;
+    if (isObject) {
+        if (s.additionalProperties !== false)
+            return false;
+        const keys = Object.keys(s.properties ?? {});
+        const required = Array.isArray(s.required) ? s.required : [];
+        if (!keys.every((k) => required.includes(k)))
+            return false;
+    }
+    for (const key of ["properties", "$defs", "definitions"]) {
+        if (s[key] && typeof s[key] === "object" && !Object.values(s[key]).every(isStrictCompatible))
+            return false;
+    }
+    for (const key of ["items", "anyOf", "oneOf", "allOf"]) {
+        if (s[key] !== undefined && !isStrictCompatible(s[key]))
+            return false;
+    }
+    return true;
+}
+export function toTools(tools) {
+    return tools.map((t) => ({
+        type: "function",
+        name: t.name,
+        description: t.description,
+        parameters: t.input_schema,
+        // Sent either way, so the API's own default never decides.
+        strict: Boolean(t.strict) && isStrictCompatible(t.input_schema),
+    }));
+}
+/** A call's arguments as an object, or `null` when they aren't a JSON object. */
+function parseArguments(text) {
+    try {
+        const value = JSON.parse(String(text));
+        return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function fromOutput(response) {
+    // The SDK's stream resolves a failed response rather than throwing, and
+    // returning it would end the turn as if the model had nothing to say.
+    if (response?.status === "failed" || response?.status === "cancelled") {
+        const why = response.error?.message ? `: ${response.error.message}` : "";
+        throw new Error(`[haikit] openai: the response ${response.status}${why}`);
+    }
+    // The runtime never runs the calls of an incomplete reply, so a call cut
+    // off part way can stand with `{}`. In a complete one it would be run.
+    const incomplete = response?.status === "incomplete";
+    const content = [];
+    for (const item of response?.output ?? []) {
+        if (item?.type === "message") {
+            for (const part of item.content ?? []) {
+                if (part?.type === "output_text")
+                    content.push({ type: "text", text: part.text });
+                else if (part?.type === "refusal")
+                    content.push({ type: "text", text: part.refusal });
+            }
+        }
+        else if (item?.type === "function_call") {
+            const input = parseArguments(item.arguments);
+            if (input === null && !incomplete) {
+                throw new Error(`[haikit] openai: the model called ${item.name} with arguments that aren't a JSON object`);
+            }
+            content.push({ type: "tool_use", id: item.call_id, name: item.name, input: input ?? {} });
+        }
+        else if (item?.type === "reasoning" && item.encrypted_content) {
+            // With `store: false`, OpenAI keeps nothing, so a reasoning item can only
+            // be sent back with its encrypted content. One without it is dropped.
+            content.push({ type: REASONING_BLOCK, id: item.id, summary: item.summary ?? [], encrypted_content: item.encrypted_content });
+        }
+    }
+    return { content, stop_reason: stopReason(response, content) };
+}
+function stopReason(response, content) {
+    if (response?.status === "incomplete") {
+        const reason = response.incomplete_details?.reason;
+        if (reason === "max_output_tokens")
+            return "max_tokens";
+        if (reason === "content_filter")
+            return "refusal";
+        return reason ?? "incomplete";
+    }
+    return content.some((b) => b.type === "tool_use") ? "tool_use" : "end_turn";
+}
+//# sourceMappingURL=mapping.js.map

package/dist/mapping.js.map

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

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@haikit/openai",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.21.0",
+  "description": "OpenAI model adapter for haikit. Imports only @haikit/core, never the server runtime.",
+  "keywords": [
+    "haikit",
+    "openai",
+    "gpt",
+    "llm",
+    "agent",
+    "agentic-ui",
+    "tool-use",
+    "ai"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "prepack": "npm --prefix ../.. run build"
+  },
+  "dependencies": {
+    "@haikit/core": "0.21.0",
+    "openai": "^7.28.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/wfoxd/haikit/tree/main/packages/openai#readme",
+  "bugs": {
+    "url": "https://github.com/wfoxd/haikit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wfoxd/haikit.git",
+    "directory": "packages/openai"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,68 @@
+import type { ModelAdapter, ModelRequest, ModelResponse } from "@haikit/core";
+import { fromOutput, toInput, toTools } from "./mapping.js";
+
+/**
+ * OpenAI model adapter, over the Responses API.
+ *
+ * Note it imports only hai-core, never hai-server. Adapters implement an
+ * interface the contract layer declares; that is what keeps the runtime
+ * swappable, and what lets an app ship its own adapter without forking the
+ * framework.
+ *
+ * It sends the whole history on every call with `store: false`, rather than
+ * chaining `previous_response_id`: the conversation lives in the app's store,
+ * which HaiKIT itself writes into between calls, and one conversation's calls
+ * can come from different servers.
+ */
+export interface OpenAIOptions {
+  /** Any OpenAI model ID. Defaults to `gpt-6-luna`. */
+  model?: string;
+  maxTokens?: number;
+  /**
+   * Defaults to `medium`. `null` sends no reasoning settings at all, for a
+   * model that doesn't reason and so refuses them.
+   */
+  effort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | null;
+  apiKey?: string;
+  baseURL?: string;
+  /** Sent as `prompt_cache_key`, to route calls that share a prefix together. */
+  promptCacheKey?: string;
+}
+
+/** The adapter, given a way to make the client: tests pass a fake one. */
+export function createAdapter(options: OpenAIOptions, makeClient: () => Promise<any>): ModelAdapter {
+  const model = options.model ?? "gpt-6-luna";
+  const effort = options.effort === undefined ? "medium" : options.effort;
+  let client: any = null;
+
+  return {
+    id: model,
+
+    async generate(request: ModelRequest): Promise<ModelResponse> {
+      if (!client) client = await makeClient();
+
+      const stream = client.responses.stream({
+        model,
+        // Stable prefix: OpenAI caches it on its own, so nothing volatile may
+        // go in here.
+        instructions: request.system,
+        tools: toTools(request.tools),
+        input: toInput(request.messages),
+        max_output_tokens: options.maxTokens ?? 16000,
+        store: false,
+        // Encrypted reasoning comes back only when asked for, and a model that
+        // doesn't reason refuses both.
+        ...(effort === null ? {} : { reasoning: { effort }, include: ["reasoning.encrypted_content"] }),
+        ...(options.promptCacheKey ? { prompt_cache_key: options.promptCacheKey } : {}),
+      });
+
+      for await (const event of stream) {
+        if (event.type === "response.output_text.delta" || event.type === "response.refusal.delta") {
+          request.onTextDelta(event.delta);
+        }
+      }
+
+      return fromOutput(await stream.finalResponse());
+    },
+  };
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+import type { ModelAdapter } from "@haikit/core";
+import { createAdapter, type OpenAIOptions } from "./adapter.js";
+
+export type { OpenAIOptions };
+
+export function openai(options: OpenAIOptions = {}): ModelAdapter {
+  return createAdapter(options, async () => {
+    const { default: OpenAI } = await import("openai");
+    return new OpenAI({
+      ...(options.apiKey ? { apiKey: options.apiKey } : {}),
+      ...(options.baseURL ? { baseURL: options.baseURL } : {}),
+    });
+  });
+}

package/src/mapping.ts

@@ -0,0 +1,166 @@
+import type { Message, ModelRequest, ModelResponse } from "@haikit/core";
+
+/**
+ * The history is kept in the Anthropic Messages shape, so this adapter's work
+ * is translation: the history into Responses API input items on the way out,
+ * and the response's output items back into content blocks on the way in.
+ * Everything here is pure, so it can be tested without the network.
+ */
+
+/** A reasoning item kept in the history so the next call can send it back. */
+export const REASONING_BLOCK = "openai_reasoning";
+
+function refuse(what: string): never {
+  throw new Error(`[haikit] openai: cannot send ${what} to OpenAI`);
+}
+
+/** A `tool_result`'s content, as the single string `function_call_output` takes. */
+function resultText(content: unknown): string {
+  if (content === undefined || content === null) return "";
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content
+      .map((b: any) => (b?.type === "text" && typeof b.text === "string" ? b.text : refuse(`a "${b?.type}" block in a tool_result`)))
+      .join("\n");
+  }
+  return refuse("a tool_result whose content is not a string or an array");
+}
+
+export function toInput(messages: readonly Message[]): any[] {
+  const input: any[] = [];
+
+  for (const message of messages) {
+    const { role, content } = message;
+
+    if (typeof content === "string") {
+      input.push({ role, content });
+      continue;
+    }
+    if (!Array.isArray(content)) refuse(`a ${role} message whose content is not a string or an array`);
+
+    if (role === "user") {
+      // A function call's output must follow the call, so the results go
+      // first: the runtime puts notices' text after them in the same message.
+      const texts: any[] = [];
+      for (const block of content) {
+        if (block?.type === "tool_result") {
+          input.push({ type: "function_call_output", call_id: block.tool_use_id, output: resultText(block.content) });
+        } else if (block?.type === "text") {
+          texts.push({ type: "input_text", text: block.text });
+        } else {
+          refuse(`a "${block?.type}" block in a user message`);
+        }
+      }
+      if (texts.length > 0) input.push({ role: "user", content: texts });
+      continue;
+    }
+
+    for (const block of content) {
+      if (block?.type === "text") {
+        if (block.text) input.push({ role: "assistant", content: block.text });
+      } else if (block?.type === "tool_use") {
+        input.push({ type: "function_call", call_id: block.id, name: block.name, arguments: JSON.stringify(block.input ?? {}) });
+      } else if (block?.type === REASONING_BLOCK) {
+        input.push({ type: "reasoning", id: block.id, summary: block.summary ?? [], encrypted_content: block.encrypted_content });
+      } else {
+        refuse(`a "${block?.type}" block in an assistant message`);
+      }
+    }
+  }
+
+  return input;
+}
+
+/**
+ * Whether OpenAI's strict mode accepts this schema: every object lists all of
+ * its properties in `required` and sets `additionalProperties: false`, all the
+ * way down. Sending `strict: true` on a schema that doesn't would fail the
+ * whole turn, so such a tool goes without strict mode instead.
+ */
+export function isStrictCompatible(schema: unknown): boolean {
+  if (schema === null || typeof schema !== "object") return true;
+  if (Array.isArray(schema)) return schema.every(isStrictCompatible);
+  const s = schema as Record<string, any>;
+
+  const isObject = s.type === "object" || (Array.isArray(s.type) && s.type.includes("object")) || "properties" in s;
+  if (isObject) {
+    if (s.additionalProperties !== false) return false;
+    const keys = Object.keys(s.properties ?? {});
+    const required: unknown[] = Array.isArray(s.required) ? s.required : [];
+    if (!keys.every((k) => required.includes(k))) return false;
+  }
+
+  for (const key of ["properties", "$defs", "definitions"]) {
+    if (s[key] && typeof s[key] === "object" && !Object.values(s[key]).every(isStrictCompatible)) return false;
+  }
+  for (const key of ["items", "anyOf", "oneOf", "allOf"]) {
+    if (s[key] !== undefined && !isStrictCompatible(s[key])) return false;
+  }
+  return true;
+}
+
+export function toTools(tools: ModelRequest["tools"]): any[] {
+  return tools.map((t) => ({
+    type: "function",
+    name: t.name,
+    description: t.description,
+    parameters: t.input_schema,
+    // Sent either way, so the API's own default never decides.
+    strict: Boolean(t.strict) && isStrictCompatible(t.input_schema),
+  }));
+}
+
+/** A call's arguments as an object, or `null` when they aren't a JSON object. */
+function parseArguments(text: unknown): Record<string, unknown> | null {
+  try {
+    const value = JSON.parse(String(text));
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+export function fromOutput(response: any): ModelResponse {
+  // The SDK's stream resolves a failed response rather than throwing, and
+  // returning it would end the turn as if the model had nothing to say.
+  if (response?.status === "failed" || response?.status === "cancelled") {
+    const why = response.error?.message ? `: ${response.error.message}` : "";
+    throw new Error(`[haikit] openai: the response ${response.status}${why}`);
+  }
+
+  // The runtime never runs the calls of an incomplete reply, so a call cut
+  // off part way can stand with `{}`. In a complete one it would be run.
+  const incomplete = response?.status === "incomplete";
+  const content: any[] = [];
+
+  for (const item of response?.output ?? []) {
+    if (item?.type === "message") {
+      for (const part of item.content ?? []) {
+        if (part?.type === "output_text") content.push({ type: "text", text: part.text });
+        else if (part?.type === "refusal") content.push({ type: "text", text: part.refusal });
+      }
+    } else if (item?.type === "function_call") {
+      const input = parseArguments(item.arguments);
+      if (input === null && !incomplete) {
+        throw new Error(`[haikit] openai: the model called ${item.name} with arguments that aren't a JSON object`);
+      }
+      content.push({ type: "tool_use", id: item.call_id, name: item.name, input: input ?? {} });
+    } else if (item?.type === "reasoning" && item.encrypted_content) {
+      // With `store: false`, OpenAI keeps nothing, so a reasoning item can only
+      // be sent back with its encrypted content. One without it is dropped.
+      content.push({ type: REASONING_BLOCK, id: item.id, summary: item.summary ?? [], encrypted_content: item.encrypted_content });
+    }
+  }
+
+  return { content, stop_reason: stopReason(response, content) };
+}
+
+function stopReason(response: any, content: any[]): string {
+  if (response?.status === "incomplete") {
+    const reason = response.incomplete_details?.reason;
+    if (reason === "max_output_tokens") return "max_tokens";
+    if (reason === "content_filter") return "refusal";
+    return reason ?? "incomplete";
+  }
+  return content.some((b) => b.type === "tool_use") ? "tool_use" : "end_turn";
+}