purra-openai 1.0.0 → 1.0.4

package/README.md

@@ -1,5 +1,9 @@
 # purra-openai · TypeScript
 
+In 1.0.0 development, Chat Completions accepts the optional
+[static image contract](../../../docs/static-images.md) with `imageInput: true`.
+Responses image input is not implemented in this slice.
+
 English | [简体中文](README.zh-CN.md)
 
 OpenAI model gateways for PurrA using the official SDK. Supports text, function

package/dist/chat.d.ts

@@ -2,6 +2,7 @@ import OpenAI from "openai";
 import type { ChatCompletionCreateParamsNonStreaming } from "openai/resources/chat/completions";
 import type { ModelCapabilitySnapshot, ModelGateway, ModelRequest, ModelStream, ModelTurn } from "purra";
 export interface OpenAIChatCompletionsOptions {
+    readonly imageInput?: boolean;
     readonly client?: OpenAI;
     readonly model: string;
     readonly capabilities: ModelCapabilitySnapshot;

package/dist/chat.js

@@ -1,6 +1,6 @@
 import { validateOutput } from "./structured.js";
 import OpenAI from "openai";
-import { AgentCanceledError, AgentError } from "purra";
+import { AgentCanceledError, AgentError, parseStaticImageContent } from "purra";
 function text(value) {
     if (value === null)
         return "";
@@ -8,10 +8,18 @@ function text(value) {
         throw new TypeError("OpenAI Chat Completions accepts text content only");
     return value;
 }
-function messages(input) {
+function messages(input, imageInput) {
     return input.map(m => {
         if (m.toolCalls?.length && m.role !== "assistant")
             throw new TypeError("Only assistant messages may carry tool calls");
+        const images = parseStaticImageContent(m.content);
+        if (images !== undefined) {
+            if (!imageInput || m.role !== "user")
+                throw new TypeError("Static images require user role and host-enabled image input");
+            return { role: "user", content: [{ type: "text", text: images.text }, ...images.images.map(image => ({
+                        type: "image_url", image_url: { url: `data:${image.mediaType};base64,${image.dataBase64}` },
+                    }))] };
+        }
         const content = text(m.content);
         if (m.role === "tool") {
             if (!m.toolCallId)
@@ -57,6 +65,8 @@ export class OpenAIChatCompletionsGateway {
     #client;
     #options;
     constructor(options) {
+        if (options.imageInput !== undefined && typeof options.imageInput !== "boolean")
+            throw new TypeError("imageInput must be boolean");
         if (!options.model.trim())
             throw new TypeError("Model name is required");
         if (!Number.isFinite(options.timeoutMs ?? 60000) || (options.timeoutMs ?? 60000) <= 0)
@@ -70,10 +80,14 @@ export class OpenAIChatCompletionsGateway {
     }
     #request(request) {
         this.validateOutputContract(request);
+        if (request.messages.some(message => parseStaticImageContent(message.content) !== undefined)
+            && (this.capabilities.protocol?.imageInput !== "supported" || request.capabilitySnapshot?.protocol.imageInput !== "supported")) {
+            throw new AgentError("model_capability_incompatible", "Model profile does not declare image input support");
+        }
         if (!request.outputBudget)
             throw new TypeError("OpenAI gateway requires a resolved generation budget");
         const o = this.#options;
-        return { model: o.model, messages: messages(request.messages), store: false, max_completion_tokens: request.outputBudget.maxGenerationTokens,
+        return { model: o.model, messages: messages(request.messages, o.imageInput ?? false), store: false, max_completion_tokens: request.outputBudget.maxGenerationTokens,
             ...(request.outputContract?.mode === "native_required" ? { response_format: { type: "json_schema", json_schema: {
                         name: "purra_output", strict: true, schema: JSON.parse(JSON.stringify(request.outputContract.schema)),
                     } } } : {}),
@@ -140,7 +154,7 @@ export class OpenAIChatCompletionsGateway {
                         yield { contentDelta: content, toolCallDeltas: calls };
                     else
                         yield { type: "activity", kind: "transport" };
-                    if (c.finish_reason !== null)
+                    if (c.finish_reason != null)
                         terminal = finish(c.finish_reason);
                 }
                 if (terminal === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "purra-openai",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "type": "module",
   "license": "MIT",
   "description": "Official OpenAI Responses and Chat Completions SDK adapter for PurrA",
@@ -20,7 +20,7 @@
     "openai": "7.9.0"
   },
   "peerDependencies": {
-    "purra": "1.0.0"
+    "purra": "1.0.4"
   },
   "devDependencies": {
     "purra": "file:../../../typescript",