@vincemakes/kiso-provider-openai 0.45.0 → 0.45.1

package/README.md

@@ -5,6 +5,12 @@ DeepSeek, OpenRouter via base_url): reasoning dialects digested into
 thinking, real streaming usage, exhaustive finish-reason mapping,
 connection/timeout/5xx classification.
 
+One request yields exactly one `usage` event, before its `stop`. A
+channel may report usage several times in one stream (twice after the
+finish, or cumulatively on every chunk); the adapter keeps the last
+report and emits it once, so a host that adds usage events up bills each
+request once.
+
 Requires Node >= 22. See the repository README for the framework
 overview.
 

package/dist/index.js

@@ -93,6 +93,13 @@ export function createOpenAICompatAdapter(client, adapterOpts = {}) {
             const pending = new Map();
             let finishReason = null;
             let usageSent = false;
+            // One request, one usage event. A compat channel may report usage
+            // more than once in one stream (two identical chunks after the
+            // finish, or the cumulative figure on every chunk); usage here is
+            // cumulative, so the LAST report is the request's. It is held and
+            // yielded once, after the stream ends and before the stop — a host
+            // adding usage events up bills the request exactly once.
+            let lastUsage = null;
             let stopReason = "end_turn";
             // P1-10: the FIRST finish reason is FINAL — later content and
             // finish reasons are ignored (a provider that emits text after a
@@ -121,7 +128,7 @@ export function createOpenAICompatAdapter(client, adapterOpts = {}) {
                             const u = chunk.usage;
                             const details = u.prompt_tokens_details;
                             const reasoning = u.completion_tokens_details?.reasoning_tokens;
-                            yield {
+                            lastUsage = {
                                 seq: 0,
                                 type: "usage",
                                 inputTokens: chunk.usage.prompt_tokens ?? null,
@@ -238,7 +245,7 @@ export function createOpenAICompatAdapter(client, adapterOpts = {}) {
                         // comment saying no provider reports a split — true when
                         // written, false since this vendor shipped one.
                         const reasoning = u.completion_tokens_details?.reasoning_tokens;
-                        yield {
+                        lastUsage = {
                             seq: 0,
                             type: "usage",
                             inputTokens: chunk.usage.prompt_tokens ?? null,
@@ -287,6 +294,12 @@ export function createOpenAICompatAdapter(client, adapterOpts = {}) {
             // provider answered, we just do not know the word, and it still
             // stops.
             if (finishReason === null && !options.signal?.aborted) {
+                // The pending CALLS are withheld (above); a usage the stream
+                // already reported is not a call — a gateway that puts the
+                // cumulative usage on every chunk has billed this attempt, and
+                // that bill is known. It goes out once, before the failure.
+                if (lastUsage !== null)
+                    yield lastUsage;
                 throw streamFailure(`[${vendorOf(options.model)}] request failed: the stream ended with no finish reason`);
             }
             // Close out any streamed tool calls.
@@ -309,6 +322,8 @@ export function createOpenAICompatAdapter(client, adapterOpts = {}) {
                     input,
                 };
             }
+            if (lastUsage !== null)
+                yield lastUsage;
             if (!usageSent) {
                 // Area 6: no usage reported is expressed as UNKNOWN — nulls
                 // and known:false — never faked as a zero-cost turn.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-provider-openai",
-	"version": "0.45.0",
+	"version": "0.45.1",
 	"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.45.0",
+		"@vincemakes/kiso-core": "0.45.1",
 		"openai": "^7.3.0"
 	},
 	"devDependencies": {