@rulvar/anthropic 1.132.0 → 1.133.0

package/dist/index.d.ts

@@ -172,6 +172,13 @@ interface TurnMapping {
   * request of a pause_turn absorption (RV905).
   */
   responseId?: string;
+  /**
+  * The SEGMENT's own normalized usage (RV1003): a paused segment
+  * yields no finish, so this is how its counts reach the adapter's
+  * whole-turn accumulation. The terminal finish EVENT carries the turn
+  * total (usagePrior folded in); this field stays segment-only.
+  */
+  usage: Usage;
 }
 /**
 * Maps one Messages API stream into ChatEvents, yielding each canonical
@@ -203,6 +210,17 @@ declare function mapAnthropicStream(stream: AsyncIterable<AnthropicStreamEvent>,
   wirePrior?: {
     responseIds: Array<string | undefined>;
   };
+  /**
+  * Accumulated usage of the PRIOR pause_turn segments of this turn
+  * (RV1003): the terminal finish must speak for the WHOLE logical
+  * turn, because core sums the per-segment mid-stream reports and
+  * verifies them against the finish total; a finish carrying only
+  * the last segment's counts turns a legitimate absorption into a
+  * usage-invariant kill and loses the paid segments from the money.
+  * Absent on the first segment, so an unsegmented finish stays
+  * byte-identical.
+  */
+  usagePrior?: Usage;
 }): AsyncGenerator<ChatEvent, TurnMapping>;
 /**
 * Projects an SDK/API error into the retryable WireError vocabulary:

package/dist/index.js

@@ -1,5 +1,5 @@
 import Anthropic from "@anthropic-ai/sdk";
-import { ConfigError, createCanonicalIdMinter, isStrictCompatibleSchema } from "@rulvar/core";
+import { ConfigError, createCanonicalIdMinter, isStrictCompatibleSchema, sumUsage } from "@rulvar/core";
 //#region src/caps.ts
 const ALL_EFFORTS = [
 	"low",
@@ -490,7 +490,13 @@ async function* mapAnthropicStream(stream, ids, options) {
 	const mapping = {
 		assistantContent: [],
 		pauseTurn: false,
-		finished: false
+		finished: false,
+		usage: {
+			inputTokens: 0,
+			outputTokens: 0,
+			cacheReadTokens: 0,
+			cacheWriteTokens: 0
+		}
 	};
 	let usage = {
 		inputTokens: 0,
@@ -620,6 +626,7 @@ async function* mapAnthropicStream(stream, ids, options) {
 			const mapped = mapStopReason(stopReason, stopDetails);
 			if (mapped.pauseTurn) {
 				mapping.pauseTurn = true;
+				mapping.usage = usage;
 				if (responseId !== void 0) mapping.responseId = responseId;
 				return mapping;
 			}
@@ -636,15 +643,17 @@ async function* mapAnthropicStream(stream, ids, options) {
 			yield {
 				type: "finish",
 				finish: mapped.finish ?? { reason: "stop" },
-				usage,
+				usage: options?.usagePrior === void 0 ? usage : sumUsage(options.usagePrior, usage),
 				providerMetadata
 			};
 			mapping.finished = true;
+			mapping.usage = usage;
 			if (responseId !== void 0) mapping.responseId = responseId;
 			return mapping;
 		}
 		default: break;
 	}
+	mapping.usage = usage;
 	return mapping;
 }
 /**
@@ -835,7 +844,9 @@ function anthropic(options = {}) {
 		},
 		async *stream(req, signal) {
 			const info = infoFor(req.model);
-			const pauseCap = typeof req.providerOptions?.anthropic?.pauseTurnMaxContinuations === "number" ? req.providerOptions.anthropic.pauseTurnMaxContinuations : 5;
+			const rawPauseCap = req.providerOptions?.anthropic?.pauseTurnMaxContinuations;
+			if (rawPauseCap !== void 0 && (typeof rawPauseCap !== "number" || !Number.isSafeInteger(rawPauseCap) || rawPauseCap < 0)) throw new ConfigError(`pauseTurnMaxContinuations must be a nonnegative safe integer, got ${typeof rawPauseCap === "number" ? String(rawPauseCap) : typeof rawPauseCap === "string" ? `'${rawPauseCap}'` : JSON.stringify(rawPauseCap) ?? "a non-numeric value"}; an invalid cap never disarms the continuation bound, because every absorbed continuation is a paid wire request`);
+			const pauseCap = rawPauseCap ?? 5;
 			let params = buildAnthropicParams(req, {
 				ids,
 				maxOutputTokens: info.caps.maxOutputTokens,
@@ -844,6 +855,7 @@ function anthropic(options = {}) {
 			let continuations = 0;
 			const carryRetained = [];
 			const priorSegmentIds = [];
+			let absorbedUsage;
 			while (true) {
 				let stream;
 				try {
@@ -861,7 +873,8 @@ function anthropic(options = {}) {
 				}
 				const mapper = mapAnthropicStream(stream, ids, {
 					carryRetained,
-					...priorSegmentIds.length === 0 ? {} : { wirePrior: { responseIds: priorSegmentIds } }
+					...priorSegmentIds.length === 0 ? {} : { wirePrior: { responseIds: priorSegmentIds } },
+					...absorbedUsage === void 0 ? {} : { usagePrior: absorbedUsage }
 				});
 				let mapping;
 				try {
@@ -897,6 +910,7 @@ function anthropic(options = {}) {
 				}
 				carryRetained.push(...mapping.assistantContent.filter((block) => block.type === "thinking" || block.type === "redacted_thinking"));
 				priorSegmentIds.push(mapping.responseId);
+				absorbedUsage = absorbedUsage === void 0 ? mapping.usage : sumUsage(absorbedUsage, mapping.usage);
 				continuations += 1;
 				if (continuations > pauseCap) {
 					yield {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/anthropic",
-  "version": "1.132.0",
+  "version": "1.133.0",
   "description": "Rulvar first-class provider adapter over @anthropic-ai/sdk.",
   "type": "module",
   "license": "Apache-2.0",
@@ -23,13 +23,13 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.115.0",
-    "@rulvar/core": "1.132.0"
+    "@rulvar/core": "1.133.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "tsdown": "^0.22.14",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.132.0"
+    "@rulvar/testing": "1.133.0"
   },
   "repository": {
     "type": "git",