@veryfront/ext-llm-openai 0.1.1186 → 0.1.1189

package/esm/openai-reasoning-models.d.ts

@@ -1,10 +1,7 @@
+import type { RuntimeReasoningOption } from "veryfront/provider/types";
 export type OpenAIReasoningEffort = "low" | "medium" | "high";
-export type OpenAIProviderReasoningEffort = OpenAIReasoningEffort | "max";
-export type OpenAIProviderReasoningOption = {
-    enabled?: boolean;
-    effort?: OpenAIProviderReasoningEffort;
-    budgetTokens?: number;
-};
+export type OpenAIProviderReasoningEffort = NonNullable<RuntimeReasoningOption["effort"]>;
+export type OpenAIProviderReasoningOption = RuntimeReasoningOption;
 export type ResolvedOpenAIReasoning = {
     effort: OpenAIReasoningEffort;
     source: "default" | "explicit";

package/esm/openai-reasoning-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-reasoning-models.d.ts","sourceRoot":"","sources":["../src/openai-reasoning-models.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9D,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG,KAAK,CAAC;AAE1E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;CAChC,CAAC;AAIF,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAG5E;AAuBD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,SAAW,GACtB,qBAAqB,GAAG,SAAS,CAwBnC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,6BAA6B,GAAG,SAAS,GAChD,uBAAuB,GAAG,SAAS,CAoBrC;AAED,wBAAgB,mCAAmC,CACjD,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,uBAAuB,GACjC,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAW,GAAG,OAAO,CAExF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE"}
+{"version":3,"file":"openai-reasoning-models.d.ts","sourceRoot":"","sources":["../src/openai-reasoning-models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9D,MAAM,MAAM,6BAA6B,GAAG,WAAW,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE1F,MAAM,MAAM,6BAA6B,GAAG,sBAAsB,CAAC;AAEnE,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;CAChC,CAAC;AAIF,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAG5E;AAuBD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,SAAW,GACtB,qBAAqB,GAAG,SAAS,CAwBnC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,6BAA6B,GAAG,SAAS,GAChD,uBAAuB,GAAG,SAAS,CAoBrC;AAED,wBAAgB,mCAAmC,CACjD,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,uBAAuB,GACjC,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAW,GAAG,OAAO,CAExF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE"}

package/esm/openai-responses-request-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-responses-request-builder.d.ts","sourceRoot":"","sources":["../src/openai-responses-request-builder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,kCAAkC,CAAC;AAO1C,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,OAAO,EAAE;QACZ,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,KAAK,IAAI,KAAK,CAAC;QACb,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ,CAAC;AAkJF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,+BAA+B,EACxC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,gBAAgB,GACzB,sBAAsB,CAsGxB"}
+{"version":3,"file":"openai-responses-request-builder.d.ts","sourceRoot":"","sources":["../src/openai-responses-request-builder.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAoBxF,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,OAAO,EAAE;QACZ,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,KAAK,IAAI,KAAK,CAAC;QACb,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ,CAAC;AAyYF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,+BAA+B,EACxC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,gBAAgB,GACzB,sBAAsB,CA+IxB"}

package/esm/openai-responses-request-builder.js

@@ -1,10 +1,179 @@
-import { readProviderOptions, stringifyJsonValue, unwrapToolInputSchema, } from "veryfront/provider/shared";
+import { jsonValuesEqual, readProviderOptions, stringifyToolArguments, stringifyToolResultValue, unwrapToolInputSchema, } from "veryfront/provider/shared";
 import { rejectsOpenAISamplingParams, resolveOpenAIReasoningConfig, shouldRequestOpenAIReasoningSummary, } from "./openai-reasoning-models.js";
-function toSnakeCaseRecord(record) {
-    return Object.fromEntries(Object.entries(record).map(([key, value]) => [
-        key.replace(/[A-Z]/g, (match) => `_${match.toLowerCase()}`),
-        value,
-    ]));
+import { defineOpenAIProviderOptions } from "./openai-provider-options.js";
+import { isBoundedOpenAIStreamString, MAX_OPENAI_STREAM_TOOL_NAME_BYTES, } from "./openai-stream-metadata.js";
+import { normalizeOpenAIWebSearchCall, OPENAI_REASONING_ENCRYPTED_CONTENT_INCLUDE, OPENAI_WEB_SEARCH_SOURCES_INCLUDE, readOpenAIRawResponseOutputItems, resolveOpenAIWebSearchDescriptor, } from "./openai-web-search.js";
+function invalidOpenAIProviderHistory() {
+    return new TypeError("OpenAI raw response metadata did not match canonical provider tool history");
+}
+function assertUniqueOpenAIToolCallIds(calls) {
+    const seen = new Set();
+    for (const call of calls) {
+        if (seen.has(call.id)) {
+            throw invalidOpenAIProviderHistory();
+        }
+        seen.add(call.id);
+    }
+}
+function assertOrderedOpenAIToolCallsEqual(left, right) {
+    if (left.length !== right.length) {
+        throw invalidOpenAIProviderHistory();
+    }
+    for (let index = 0; index < left.length; index += 1) {
+        const leftCall = left[index];
+        const rightCall = right[index];
+        if (!leftCall ||
+            !rightCall ||
+            leftCall.id !== rightCall.id ||
+            leftCall.name !== rightCall.name ||
+            !jsonValuesEqual(leftCall.input, rightCall.input, true)) {
+            throw invalidOpenAIProviderHistory();
+        }
+    }
+}
+function validateOpenAIProviderReplay(message, rawOutputItems) {
+    const metadataProviderCalls = (message.providerToolCalls ?? []).map((call) => ({
+        id: call.toolCallId,
+        name: call.toolName,
+        input: call.input,
+    }));
+    const contentProviderCalls = [];
+    const clientCalls = [];
+    const providerResults = [];
+    const contentCallKinds = [];
+    for (const part of message.content) {
+        if (part.type === "tool-call") {
+            const providerExecuted = part.providerExecuted === true;
+            const target = providerExecuted ? contentProviderCalls : clientCalls;
+            target.push({
+                id: part.toolCallId,
+                name: part.toolName,
+                input: part.input,
+            });
+            contentCallKinds.push(providerExecuted ? "provider" : "client");
+            continue;
+        }
+        if (part.type === "tool-result" && part.providerExecuted === true) {
+            providerResults.push({
+                id: part.toolCallId,
+                name: part.toolName,
+                result: part.result,
+                isError: part.isError === true,
+            });
+        }
+    }
+    assertUniqueOpenAIToolCallIds(metadataProviderCalls);
+    assertUniqueOpenAIToolCallIds(contentProviderCalls);
+    assertUniqueOpenAIToolCallIds(clientCalls);
+    const seenProviderResultIds = new Set();
+    for (const result of providerResults) {
+        if (seenProviderResultIds.has(result.id)) {
+            throw invalidOpenAIProviderHistory();
+        }
+        seenProviderResultIds.add(result.id);
+    }
+    // providerToolCalls is the legacy projection of provider-executed content.
+    // Coalesce it only after proving both surviving projections are identical
+    // occurrence-for-occurrence; duplicates or a different order are ambiguous.
+    if (metadataProviderCalls.length > 0 &&
+        contentProviderCalls.length > 0) {
+        assertOrderedOpenAIToolCallsEqual(metadataProviderCalls, contentProviderCalls);
+    }
+    const providerCalls = metadataProviderCalls.length > 0
+        ? metadataProviderCalls
+        : contentProviderCalls;
+    const rawProviderCalls = [];
+    const rawClientCalls = [];
+    const rawCallKinds = [];
+    for (const item of rawOutputItems) {
+        if (item.type === "web_search_call") {
+            const call = normalizeOpenAIWebSearchCall(item, () => invalidOpenAIProviderHistory());
+            rawProviderCalls.push({
+                id: call.id,
+                input: call.input,
+                result: call.result,
+                isError: call.isError,
+            });
+            rawCallKinds.push("provider");
+            continue;
+        }
+        if (item.type === "function_call") {
+            if (typeof item.call_id !== "string" ||
+                typeof item.name !== "string" ||
+                typeof item.arguments !== "string") {
+                throw invalidOpenAIProviderHistory();
+            }
+            rawClientCalls.push({
+                id: item.call_id,
+                name: item.name,
+                input: item.arguments,
+            });
+            rawCallKinds.push("client");
+        }
+    }
+    // The provider parser rejects duplicate call ids across both provider- and
+    // client-executed tools. Exact replay must enforce the same invariant even
+    // for legacy metadata that predates that parser check.
+    assertUniqueOpenAIToolCallIds([
+        ...rawProviderCalls,
+        ...rawClientCalls,
+    ]);
+    if (providerCalls.length > 0) {
+        if (providerCalls.length !== rawProviderCalls.length) {
+            throw invalidOpenAIProviderHistory();
+        }
+        for (let index = 0; index < providerCalls.length; index += 1) {
+            const canonical = providerCalls[index];
+            const raw = rawProviderCalls[index];
+            if (!canonical ||
+                !raw ||
+                canonical.id !== raw.id ||
+                !jsonValuesEqual(canonical.input, raw.input, true)) {
+                throw invalidOpenAIProviderHistory();
+            }
+        }
+    }
+    if (providerResults.length > 0) {
+        if (providerResults.length !== rawProviderCalls.length) {
+            throw invalidOpenAIProviderHistory();
+        }
+        for (let index = 0; index < providerResults.length; index += 1) {
+            const canonical = providerResults[index];
+            const raw = rawProviderCalls[index];
+            if (!canonical ||
+                !raw ||
+                canonical.id !== raw.id ||
+                canonical.isError !== raw.isError ||
+                !jsonValuesEqual(canonical.result, raw.result)) {
+                throw invalidOpenAIProviderHistory();
+            }
+        }
+    }
+    const historicalProviderName = providerCalls[0]?.name ?? providerResults[0]?.name;
+    if (historicalProviderName !== undefined &&
+        (!isBoundedOpenAIStreamString(historicalProviderName, MAX_OPENAI_STREAM_TOOL_NAME_BYTES) ||
+            providerCalls.some((call) => call.name !== historicalProviderName) ||
+            providerResults.some((result) => result.name !== historicalProviderName))) {
+        throw invalidOpenAIProviderHistory();
+    }
+    // Ordinary function calls have an exact provider-native representation.
+    // If their canonical projection survived compaction, correlate it in order;
+    // otherwise the already-validated raw items remain the legacy source of
+    // truth.
+    if (clientCalls.length > 0) {
+        assertOrderedOpenAIToolCallsEqual(clientCalls, rawClientCalls);
+    }
+    // providerToolCalls has no position relative to ordinary content calls. When
+    // both kinds survive in assistant content, however, their complete
+    // interleaving is observable and must match the raw item order. If either
+    // content projection was compacted, only its per-kind order can be proven;
+    // the exact raw item sequence remains authoritative for transmission.
+    if (contentProviderCalls.length > 0 && clientCalls.length > 0) {
+        if (contentCallKinds.length !== rawCallKinds.length ||
+            contentCallKinds.some((kind, index) => kind !== rawCallKinds[index])) {
+            throw invalidOpenAIProviderHistory();
+        }
+    }
 }
 function toOpenAIResponsesInput(prompt) {
     const instructionsParts = [];
@@ -23,6 +192,12 @@ function toOpenAIResponsesInput(prompt) {
                 });
                 break;
             case "assistant": {
+                const rawOutputItems = readOpenAIRawResponseOutputItems(message.providerMetadata);
+                if (rawOutputItems) {
+                    validateOpenAIProviderReplay(message, rawOutputItems);
+                    input.push(...rawOutputItems);
+                    break;
+                }
                 const messageContent = [];
                 for (const part of message.content) {
                     if (part.type === "text") {
@@ -45,6 +220,12 @@ function toOpenAIResponsesInput(prompt) {
                         });
                         continue;
                     }
+                    if (part.type === "tool-result") {
+                        throw new TypeError("OpenAI provider-executed assistant tool results require exact raw replay metadata");
+                    }
+                    if (part.providerExecuted === true) {
+                        throw new TypeError("OpenAI provider-executed assistant tool calls require exact raw replay metadata");
+                    }
                     if (messageContent.length > 0) {
                         input.push({ role: "assistant", content: [...messageContent] });
                         messageContent.length = 0;
@@ -53,7 +234,7 @@ function toOpenAIResponsesInput(prompt) {
                         type: "function_call",
                         call_id: part.toolCallId,
                         name: part.toolName,
-                        arguments: stringifyJsonValue(part.input),
+                        arguments: stringifyToolArguments(part.input),
                     });
                 }
                 if (messageContent.length > 0) {
@@ -66,7 +247,7 @@ function toOpenAIResponsesInput(prompt) {
                     input.push({
                         type: "function_call_output",
                         call_id: part.toolCallId,
-                        output: stringifyJsonValue(part.output.value),
+                        output: stringifyToolResultValue(part.output.value),
                     });
                 }
                 break;
@@ -98,10 +279,11 @@ function toOpenAIResponsesUserContent(parts) {
     }
     return content;
 }
-function toOpenAIResponsesTools(tools) {
+function toOpenAIResponsesTools(tools, webSearch) {
     if (!tools)
         return undefined;
     const normalized = [];
+    let addedWebSearch = false;
     for (const tool of tools) {
         if (tool.type === "function") {
             normalized.push({
@@ -119,13 +301,10 @@ function toOpenAIResponsesTools(tools) {
         }
         if (!tool.id.startsWith("openai."))
             continue;
-        const providerType = tool.id.slice("openai.".length);
-        if (providerType.length === 0)
-            continue;
-        normalized.push({
-            type: providerType,
-            ...toSnakeCaseRecord(tool.args),
-        });
+        if (webSearch && !addedWebSearch) {
+            normalized.push(webSearch.requestTool);
+            addedWebSearch = true;
+        }
     }
     return normalized.length > 0 ? normalized : undefined;
 }
@@ -162,12 +341,13 @@ export function buildOpenAIResponsesRequest(modelId, providerName, options, stre
             }
         }
     }
+    const webSearch = resolveOpenAIWebSearchDescriptor(options.tools);
     const { instructions, input } = toOpenAIResponsesInput(options.prompt);
-    const responsesTools = toOpenAIResponsesTools(options.tools);
+    const responsesTools = toOpenAIResponsesTools(options.tools, webSearch);
     const body = {
         model: modelId,
         input,
-        // Stay stateless: encrypted reasoning content is never round-tripped via include.
+        // Stay stateless and preserve the complete provider history explicitly below.
         store: false,
         ...(instructions !== undefined ? { instructions } : {}),
         ...(stream ? { stream: true } : {}),
@@ -217,6 +397,47 @@ export function buildOpenAIResponsesRequest(modelId, providerName, options, stre
     };
     // Env-BYOK users historically registered options under "openai-compatible";
     // keep merging that bucket at the lowest precedence.
-    Object.assign(body, readProviderOptions(options.providerOptions, ...(providerName === "openai" ? ["openai-compatible"] : []), "openai", providerName));
+    defineOpenAIProviderOptions(body, readProviderOptions(options.providerOptions, ...(providerName === "openai" ? ["openai-compatible"] : []), "openai", providerName));
+    // Keep provider-native tuning extensible without allowing raw options to
+    // replace the runtime-owned transport, prompt, model, or privacy contract.
+    body.model = modelId;
+    body.input = input;
+    body.store = false;
+    if (instructions !== undefined) {
+        body.instructions = instructions;
+    }
+    else {
+        delete body.instructions;
+    }
+    if (stream) {
+        body.stream = true;
+    }
+    else {
+        delete body.stream;
+    }
+    const requiredIncludes = [
+        ...(reasoning ? [OPENAI_REASONING_ENCRYPTED_CONTENT_INCLUDE] : []),
+        ...(webSearch ? [OPENAI_WEB_SEARCH_SOURCES_INCLUDE] : []),
+    ];
+    if (requiredIncludes.length > 0) {
+        const providerIncludes = Array.isArray(body.include)
+            ? body.include.filter((value) => typeof value === "string")
+            : [];
+        body.include = [
+            ...new Set([
+                ...providerIncludes,
+                ...requiredIncludes,
+            ]),
+        ];
+    }
+    if (Object.hasOwn(body, "background")) {
+        delete body.background;
+        warnings.push({
+            type: "unsupported-setting",
+            provider: "openai",
+            setting: "background",
+            details: "Background Responses are asynchronous and cannot satisfy the runtime's immediate result contract; the value was dropped.",
+        });
+    }
     return body;
 }

package/esm/openai-responses-stream.d.ts

@@ -1,4 +1,14 @@
 import type { RuntimeUsage } from "veryfront/provider/shared";
+type OpenAIResponsesStreamContext = {
+    providerKind?: "openai" | "mistral" | "moonshotai";
+    providerLabel?: string;
+    webSearchToolName?: string;
+    preserveRawOutputItems?: boolean;
+};
+export declare const MAX_OPENAI_STREAM_MESSAGE_SNAPSHOT_BYTES: number;
+export declare const MAX_OPENAI_RESPONSES_RAW_METADATA_BYTES: number;
+export declare const MAX_OPENAI_RESPONSES_STREAM_OUTPUT_ITEMS = 4096;
+export declare const MAX_OPENAI_RESPONSES_STREAM_CONTENT_PARTS = 4096;
 /**
  * The Responses API uses `input_tokens` / `output_tokens` field names
  * instead of Chat Completions' `prompt_tokens` / `completion_tokens`.
@@ -12,5 +22,6 @@ export declare function normalizeOpenAIResponsesFinishReason(raw: unknown): stri
  * Parse the Responses API streaming event grammar into the same UI part
  * shapes the existing OpenAI / Anthropic / Google streams emit.
  */
-export declare function streamOpenAIResponsesParts(stream: ReadableStream<Uint8Array>): AsyncIterable<unknown>;
+export declare function streamOpenAIResponsesParts(stream: ReadableStream<Uint8Array>, context?: OpenAIResponsesStreamContext): AsyncIterable<unknown>;
+export {};
 //# sourceMappingURL=openai-responses-stream.d.ts.map

package/esm/openai-responses-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-responses-stream.d.ts","sourceRoot":"","sources":["../src/openai-responses-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAc9D;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAqEtF;AAED,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,OAAO,GACX,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAclD;AAED;;;GAGG;AACH,wBAAuB,0BAA0B,CAC/C,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,OAAO,CAAC,CAqJxB"}
+{"version":3,"file":"openai-responses-stream.d.ts","sourceRoot":"","sources":["../src/openai-responses-stream.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA8E9D,KAAK,4BAA4B,GAAG;IAClC,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,wCAAwC,QAAkB,CAAC;AACxE,eAAO,MAAM,uCAAuC,QAAyC,CAAC;AAC9F,eAAO,MAAM,wCAAwC,OAAQ,CAAC;AAC9D,eAAO,MAAM,yCAAyC,OAAQ,CAAC;AA4C/D;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAqEtF;AAED,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,OAAO,GACX,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBlD;AAED;;;GAGG;AACH,wBAAuB,0BAA0B,CAC/C,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE,4BAAiC,GACzC,aAAa,CAAC,OAAO,CAAC,CAugDxB"}