@vincemakes/kiso-provider-openai 0.15.11 → 0.16.0

package/dist/index.d.ts

@@ -20,6 +20,18 @@ import type { Adapter } from "@vincemakes/kiso-core";
 export interface OpenAICompatProviderConfig {
     readonly apiKey?: string;
     readonly baseUrl?: string;
+    /** MG-1 (A5): the adapter's replay identity — providerId as the runtime
+     *  resolved it (deepseek / zai / openai / custom). Absent = "custom"
+     *  with the baseUrl origin as the endpoint term. */
+    readonly scope?: OpenAICompatScope;
+}
+/** MG-1 (A5): the compat adapter's own half of the continuation scope.
+ *  apiId is constant ("openai-chat") and modelId is per-request; only the
+ *  provider identity and (for custom) the endpoint origin need injecting —
+ *  the generic compat wire cannot know WHICH provider it is. */
+export interface OpenAICompatScope {
+    readonly providerId: string;
+    readonly endpoint?: string;
 }
 /**
  * High-level factory (round 7): builds the adapter FROM CONFIG, owning the SDK
@@ -29,5 +41,8 @@ export interface OpenAICompatProviderConfig {
  * through a hoisted root.
  */
 export declare function createOpenAICompatProvider(config?: OpenAICompatProviderConfig): Adapter;
-export declare function createOpenAICompatAdapter(client: OpenAI): Adapter;
+export interface OpenAICompatAdapterOptions {
+    readonly scope?: OpenAICompatScope;
+}
+export declare function createOpenAICompatAdapter(client: OpenAI, adapterOpts?: OpenAICompatAdapterOptions): Adapter;
 export type { ChatCompletionChunk };

package/dist/index.js

@@ -29,9 +29,21 @@ export function createOpenAICompatProvider(config = {}) {
         ...(config.apiKey !== undefined ? { apiKey: config.apiKey } : {}),
         ...(config.baseUrl !== undefined ? { baseURL: config.baseUrl } : {}),
     });
-    return createOpenAICompatAdapter(client);
+    const origin = (() => {
+        if (config.baseUrl === undefined)
+            return undefined;
+        try {
+            return new URL(config.baseUrl).origin;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    const scope = config.scope ?? (origin !== undefined ? { providerId: "custom", endpoint: origin } : undefined);
+    return createOpenAICompatAdapter(client, { ...(scope !== undefined ? { scope } : {}) });
 }
-export function createOpenAICompatAdapter(client) {
+export function createOpenAICompatAdapter(client, adapterOpts = {}) {
+    const ownScope = adapterOpts.scope;
     return {
         async *stream(options) {
             // The explicit streaming params type keeps the `stream: true`
@@ -39,7 +51,17 @@ export function createOpenAICompatAdapter(client) {
             // create() call as the NON-streaming variant (TS2504).
             const body = {
                 model: options.model,
-                messages: toOpenAIMessages(options.messages, options.systemPrompt),
+                messages: toOpenAIMessages(options.messages, options.systemPrompt, options.model, ownScope),
+                // XP-1: the resolved setting, DeepSeek V4 shape (the
+                // thinking-mode guide, read 2026-08-26): top-level
+                // thinking:{type} + reasoning_effort. Absent adds NO key.
+                // The `thinking` extension is absent from the SDK's param
+                // type; the spread rides a cast — the reasoning_content
+                // precedent, one object over.
+                ...({
+                    ...(options.reasoning?.thinking !== undefined ? { thinking: { type: options.reasoning.thinking } } : {}),
+                    ...(options.reasoning?.effort !== undefined ? { reasoning_effort: options.reasoning.effort } : {}),
+                }),
                 stream: true,
                 // D5: request real streaming usage — without this the
                 // provider never sends a usage chunk and we would
@@ -317,7 +339,24 @@ function toOpenAIToolResultContent(content) {
         : `[image omitted — OpenAI tool results accept text only: ${b.sourceType === "base64" ? `${b.mediaType ?? "image"} (${b.data?.length ?? 0} base64 chars)` : `url ${b.url ?? ""}`}]`)
         .join("");
 }
-function toOpenAIMessages(messages, systemPrompt) {
+/** A5: the reasoning text replays ONLY when the turn's envelope matches
+ *  THIS binding — provider AND api AND model AND (for custom) the endpoint
+ *  origin. Foreign content is withheld as "" so the monotone PRESENCE
+ *  discipline (below) holds byte-stably. A turn with NO envelope is the
+ *  grandfather: pre-A5 logs replay under the pre-existing rule verbatim. */
+function reasoningFor(msg, model, ownScope) {
+    const c = msg.continuation;
+    if (c === undefined)
+        return msg.reasoning ?? "";
+    const s = c.scope;
+    const providerId = ownScope?.providerId ?? "custom";
+    const matches = s.apiId === "openai-chat" &&
+        s.providerId === providerId &&
+        s.modelId === model &&
+        (s.providerId !== "custom" || s.endpoint === ownScope?.endpoint);
+    return matches ? (msg.reasoning ?? "") : "";
+}
+function toOpenAIMessages(messages, systemPrompt, model = "", ownScope) {
     const out = [];
     // The OpenAI API takes the system prompt as a system-role message; compat
     // providers (GLM/Kimi/DeepSeek/OpenRouter) follow the same shape. It was
@@ -366,7 +405,7 @@ function toOpenAIMessages(messages, systemPrompt) {
                 // added via spread so the literal stays assignable (the union
                 // type carries the extra key). Presence follows hasReasoning
                 // (the monotone rule above — the field never flips mid-history).
-                ...(hasReasoning ? { reasoning_content: msg.reasoning ?? "" } : {}),
+                ...(hasReasoning ? { reasoning_content: reasoningFor(msg, model, ownScope) } : {}),
             });
         }
         else {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-provider-openai",
-	"version": "0.15.11",
+	"version": "0.16.0",
 	"description": "kiso OpenAI-compatible adapter \u2014 OpenAI + the compat family (GLM, Kimi, DeepSeek, OpenRouter) via base_url swap, reasoning dialects digested.",
 	"type": "module",
 	"license": "MIT",
@@ -21,7 +21,7 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-core": "0.15.11",
+		"@vincemakes/kiso-core": "0.16.0",
 		"openai": "^7.3.0"
 	},
 	"devDependencies": {