@tessar/openai 0.0.0-stage → 0.1.0-alpha.0

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# @tessar/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.
+OpenAI Responses provider and automatic model metadata integration for Tessar.
+Requires Node 24.14 or newer and uses the official OpenAI SDK.
+
+```sh
+npm install @tessar/core@next @tessar/openai@next
+```
+
+```ts
+import { Agent, Controller, HumanMessage } from "@tessar/core";
+import { OpenAIPlugin } from "@tessar/openai";
+
+const agent = new Agent({
+  id: "assistant",
+  model: { providerId: "openai", modelId: process.env.OPENAI_MODEL! },
+});
+const controller = new Controller({
+  id: "application",
+  agent,
+  plugins: [new OpenAIPlugin({ apiKey: process.env.OPENAI_API_KEY! })],
+});
+
+try {
+  await controller.initialize();
+  const result = await agent.generate({ input: new HumanMessage("Hello") });
+  console.log(result.output);
+} finally {
+  await controller.dispose();
+}
+```
+
+Provider SDK exceptions retain their original identity. The adapter disables
+implicit SDK retries. Model metadata may be incomplete and carries provenance.
+
+This is an alpha release. See the
+[repository](https://github.com/hphucdev-04/tessar) for complete contracts.

package/dist/adapter.d.ts

@@ -0,0 +1,19 @@
+import OpenAI from "openai";
+import { type ModelAdapter, type ModelChunk, type ModelRef, type ModelRequest } from "@tessar/core";
+export interface OpenAIOptions {
+    apiKey: string;
+    baseURL?: string;
+    providerId?: string;
+    fetch?: typeof fetch;
+    metadataPartition?: string;
+}
+export declare function createClient(options: OpenAIOptions): OpenAI;
+export declare class OpenAIAdapter implements ModelAdapter {
+    readonly ref: ModelRef;
+    private readonly client;
+    constructor(options: OpenAIOptions, ref: ModelRef, client?: OpenAI);
+    validate(request: ModelRequest): void;
+    stream(request: ModelRequest, context: {
+        signal: AbortSignal;
+    }): AsyncIterable<ModelChunk>;
+}

package/dist/adapter.js

@@ -0,0 +1,127 @@
+import OpenAI, { OpenAIError } from "openai";
+import { errorInfo, MessageCodec, fail, normalizeUsage, } from "@tessar/core";
+import { decodeOutput, encodeInput } from "./codec.js";
+export function createClient(options) {
+    return new OpenAI({
+        apiKey: options.apiKey,
+        baseURL: options.baseURL,
+        fetch: options.fetch,
+        maxRetries: 0,
+    });
+}
+function usage(value) {
+    return normalizeUsage({
+        inputTokens: value?.input_tokens,
+        outputTokens: value?.output_tokens,
+        totalTokens: value?.total_tokens,
+        cacheReadInputTokens: value?.input_tokens_details?.cached_tokens,
+        cacheWriteInputTokens: value?.input_tokens_details?.cache_write_tokens,
+        reasoningOutputTokens: value?.output_tokens_details?.reasoning_tokens,
+        uncachedInputTokens: value?.input_tokens !== undefined &&
+            value?.input_tokens_details?.cached_tokens !== undefined
+            ? Math.max(0, value.input_tokens - value.input_tokens_details.cached_tokens)
+            : null,
+    }, value ? JSON.parse(JSON.stringify(value)) : null);
+}
+export class OpenAIAdapter {
+    ref;
+    client;
+    constructor(options, ref, client) {
+        this.ref = ref;
+        this.client = client ?? createClient(options);
+    }
+    validate(request) {
+        try {
+            if (request.model.providerId !== this.ref.providerId ||
+                request.model.modelId !== this.ref.modelId)
+                fail("UnsupportedContext", "Model identity mismatch");
+            encodeInput(request);
+        }
+        catch (error) {
+            errorInfo(error, { source: "tessar", ...this.ref });
+            throw error;
+        }
+    }
+    async *stream(request, context) {
+        this.validate(request);
+        context.signal.throwIfAborted();
+        const failure = (message, code) => {
+            const error = Object.assign(new Error(message), { code });
+            errorInfo(error, { source: "provider", ...this.ref });
+            return error;
+        };
+        try {
+            const stream = await this.client.responses.create({
+                model: this.ref.modelId,
+                instructions: request.instructions.sections
+                    .map((s) => s.content)
+                    .join("\n\n"),
+                input: encodeInput(request),
+                tools: request.tools.map((t) => ({
+                    type: "function",
+                    name: t.name,
+                    description: t.description,
+                    parameters: t.inputSchema,
+                    strict: false,
+                })),
+                include: ["reasoning.encrypted_content"],
+                store: false,
+                stream: true,
+            }, { signal: context.signal });
+            let terminal = false;
+            for await (const event of stream) {
+                context.signal.throwIfAborted();
+                switch (event.type) {
+                    case "response.output_text.delta":
+                        yield {
+                            type: "message-delta",
+                            messageId: event.item_id,
+                            partId: event.item_id + ":" + event.content_index,
+                            partKind: "text",
+                            delta: event.delta,
+                        };
+                        break;
+                    case "response.reasoning_summary_text.delta":
+                        yield {
+                            type: "message-delta",
+                            messageId: event.item_id,
+                            partId: event.item_id + ":summary:" + event.summary_index,
+                            partKind: "reasoning",
+                            delta: event.delta,
+                        };
+                        break;
+                    case "response.completed": {
+                        terminal = true;
+                        const normalized = usage(event.response.usage);
+                        yield { type: "usage", usage: normalized };
+                        yield {
+                            type: "response",
+                            response: {
+                                message: MessageCodec.encode(decodeOutput(event.response.output, this.ref, event.response.id)),
+                                usage: normalized,
+                                finishReason: "completed",
+                                providerRequestId: event.response.id,
+                            },
+                        };
+                        break;
+                    }
+                    case "response.incomplete":
+                    case "response.failed":
+                        yield { type: "usage", usage: usage(event.response.usage) };
+                        throw failure(event.response.error?.message ?? "OpenAI response did not complete", event.response.error?.code ?? "ProviderIncomplete");
+                    case "error":
+                        throw failure(event.message, event.code ?? "ProviderError");
+                }
+            }
+            if (!terminal)
+                throw failure("OpenAI stream ended before completion", "ProviderIncomplete");
+        }
+        catch (error) {
+            if (context.signal.aborted)
+                throw context.signal.reason;
+            errorInfo(error, { source: error instanceof OpenAIError ? "provider" : "tessar", ...this.ref });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/codec.d.ts

@@ -0,0 +1,4 @@
+import { AssistantMessage, type ModelRef, type ModelRequest } from "@tessar/core";
+import type { ResponseInput } from "openai/resources/responses/responses";
+export declare function encodeInput(request: ModelRequest): ResponseInput;
+export declare function decodeOutput(items: readonly unknown[], ref: ModelRef, responseId: string): AssistantMessage;

package/dist/codec.js

@@ -0,0 +1,145 @@
+import { AssistantMessage, TessarError, fail, assertJson, } from "@tessar/core";
+function continuity(value) {
+    if (!value ||
+        typeof value !== "object" ||
+        !("codec" in value) ||
+        value.codec !== "openai.responses")
+        return null;
+    const data = value;
+    if (data.version !== 1 || !Array.isArray(data.items))
+        fail("UnsupportedContext", "Unknown OpenAI continuity version");
+    return data;
+}
+export function encodeInput(request) {
+    const input = [];
+    for (const message of request.messages) {
+        const state = continuity(message.providerState);
+        if (state) {
+            if (state.providerId !== request.model.providerId ||
+                state.modelId !== request.model.modelId)
+                fail("UnsupportedContext", "Opaque OpenAI context requires its original model");
+            input.push(...state.items);
+            continue;
+        }
+        if (message.providerState !== undefined ||
+            message.content.some((p) => p.type === "reasoning"))
+            fail("UnsupportedContext", "Unsupported provider continuity");
+        if (message.role === "tool") {
+            if (message.content.some((p) => p.type !== "text"))
+                fail("UnsupportedContext", "OpenAI tool output currently requires text parts");
+            input.push({
+                type: "function_call_output",
+                call_id: message.toolCallId,
+                output: message.content
+                    .map((p) => (p.type === "text" ? p.text : ""))
+                    .join(""),
+            });
+            continue;
+        }
+        const role = message.role;
+        let content = [];
+        const flush = () => {
+            if (content.length) {
+                input.push({ role, content });
+                content = [];
+            }
+        };
+        for (const part of message.content) {
+            switch (part.type) {
+                case "text":
+                    content.push(message.role === "assistant"
+                        ? { type: "output_text", text: part.text, annotations: [] }
+                        : { type: "input_text", text: part.text });
+                    break;
+                case "tool-call":
+                    if (message.role !== "assistant")
+                        fail("UnsupportedContext", "Tool calls require assistant role");
+                    flush();
+                    input.push({
+                        type: "function_call",
+                        call_id: part.toolCallId,
+                        name: part.name,
+                        arguments: JSON.stringify(part.arguments),
+                    });
+                    break;
+                case "image":
+                    if (message.role !== "user")
+                        fail("UnsupportedContext", "Image input requires user role");
+                    content.push({
+                        type: "input_image",
+                        image_url: part.data.startsWith("https:") || part.data.startsWith("data:")
+                            ? part.data
+                            : `data:${part.mediaType};base64,${part.data}`,
+                        detail: "auto",
+                    });
+                    break;
+                case "file":
+                    if (message.role !== "user")
+                        fail("UnsupportedContext", "File input requires user role");
+                    content.push({
+                        type: "input_file",
+                        file_data: part.data,
+                        filename: message.id,
+                    });
+                    break;
+                default:
+                    fail("UnsupportedContext", "Unsupported OpenAI message part");
+            }
+        }
+        flush();
+    }
+    return input;
+}
+export function decodeOutput(items, ref, responseId) {
+    assertJson(items);
+    const parts = [];
+    for (const raw of items) {
+        const item = raw;
+        switch (item.type) {
+            case "message":
+                for (const content of item.content) {
+                    if (content.type === "output_text")
+                        parts.push({ type: "text", text: content.text });
+                    else if (content.type === "refusal")
+                        parts.push({ type: "text", text: content.refusal });
+                    else
+                        fail("UnsupportedResponse", "Unsupported OpenAI output content");
+                }
+                break;
+            case "reasoning":
+                for (const summary of item.summary ?? [])
+                    parts.push({ type: "reasoning", text: summary.text });
+                break;
+            case "function_call": {
+                let args;
+                try {
+                    args = JSON.parse(item.arguments);
+                }
+                catch {
+                    throw new TessarError("ProviderResponse", "Invalid OpenAI function arguments");
+                }
+                if (!args || typeof args !== "object" || Array.isArray(args))
+                    fail("ProviderResponse", "Function arguments must be an object");
+                parts.push({
+                    type: "tool-call",
+                    toolCallId: item.call_id,
+                    name: item.name,
+                    arguments: args,
+                });
+                break;
+            }
+            default:
+                fail("UnsupportedResponse", "Unsupported OpenAI output item");
+        }
+    }
+    return new AssistantMessage(parts, {
+        id: responseId,
+        providerState: {
+            codec: "openai.responses",
+            version: 1,
+            ...ref,
+            items: items,
+        },
+    });
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { OpenAIAdapter, type OpenAIOptions } from "./adapter.js";
+export { OpenAIPlugin } from "./plugin.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { OpenAIAdapter } from "./adapter.js";
+export { OpenAIPlugin } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAoB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,3 @@
+import type OpenAI from "openai";
+import type { MetadataResolver } from "@tessar/core";
+export declare function metadataResolver(client: OpenAI): MetadataResolver;

package/dist/metadata.js

@@ -0,0 +1,9 @@
+export function metadataResolver(client) {
+    return {
+        async resolve(ref, options) {
+            await client.models.retrieve(ref.modelId, { signal: options.signal });
+            return {};
+        },
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO;YACxB,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin, PluginContext } from "@tessar/core";
+import { type OpenAIOptions } from "./adapter.js";
+export declare class OpenAIPlugin implements Plugin {
+    readonly id: string;
+    private readonly providerId;
+    private readonly options;
+    constructor(options: OpenAIOptions);
+    setup(tessar: PluginContext): void;
+}

package/dist/plugin.js

@@ -0,0 +1,29 @@
+import { OpenAIAdapter, createClient } from "./adapter.js";
+import { metadataResolver } from "./metadata.js";
+export class OpenAIPlugin {
+    id;
+    providerId;
+    options;
+    constructor(options) {
+        this.options = options;
+        this.providerId = options.providerId ?? "openai";
+        this.id = "provider." + this.providerId;
+    }
+    setup(tessar) {
+        const options = this.options, id = this.providerId;
+        const client = createClient(options);
+        tessar.models.registerProvider({
+            id,
+            endpoint: options.baseURL ?? "https://api.openai.com/v1",
+            metadataPartition: options.metadataPartition,
+            metadata: metadataResolver(client),
+            catalogModelRef: (ref) => !options.baseURL ||
+                options.baseURL.replace(/\/$/, "") === "https://api.openai.com/v1"
+                ? { providerId: "openai", modelId: ref.modelId }
+                : null,
+            catalogMappingVersion: 1,
+            create: (modelId) => new OpenAIAdapter(options, { providerId: id, modelId }, client),
+        });
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,MAAM,OAAO,YAAY;IACd,EAAE,CAAS;IACH,UAAU,CAAS;IACnB,OAAO,CAAgB;IAExC,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC;QACjD,IAAI,CAAC,EAAE,GAAG,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAqB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QACnD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC7B,EAAE;YACF,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,2BAA2B;YACxD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC;YAClC,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,CACvB,CAAC,OAAO,CAAC,OAAO;gBAChB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,2BAA2B;gBAChE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;gBAChD,CAAC,CAAC,IAAI;YACV,qBAAqB,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAClB,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@tessar/openai",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "description": "OpenAI Responses provider and model metadata integration for Tessar.",
+  "type": "module",
+  "engines": {
+    "node": ">=24.14.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hphucdev-04/tessar.git",
+    "directory": "packages/openai"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "openai": "7.34.0",
+    "@tessar/core": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }