@rulvar/anthropic 1.28.0 → 1.29.0

package/dist/index.d.ts

@@ -165,8 +165,14 @@ interface TurnMapping {
 * detached work). The generator's RETURN value carries the accumulated
 * turn state the adapter needs for pause_turn continuation. Yields an
 * early usage event from message_start (the input side is known
-* immediately) and exactly one terminal finish unless the turn paused
-* (pause_turn) or errored. `carryRetained` holds thinking blocks from
+* immediately) and exactly one terminal finish when the stream reaches
+* message_stop. A stream that pauses (pause_turn) or ends before
+* message_stop yields NO terminal event of its own: the return value's
+* pauseTurn and finished flags report which case happened, and the
+* `anthropic()` adapter turns a truncated read (finished false without
+* a pause) into the retryable transport error the contract requires,
+* so a direct mapper consumer must check the flags rather than wait
+* for an error event. `carryRetained` holds thinking blocks from
 * earlier pause_turn continuations of the same turn so the terminal
 * finish ships the whole turn's retention payload (M4-T02).
 */

package/dist/index.js

@@ -442,8 +442,14 @@ function normalizeAnthropicUsage(raw) {
 * detached work). The generator's RETURN value carries the accumulated
 * turn state the adapter needs for pause_turn continuation. Yields an
 * early usage event from message_start (the input side is known
-* immediately) and exactly one terminal finish unless the turn paused
-* (pause_turn) or errored. `carryRetained` holds thinking blocks from
+* immediately) and exactly one terminal finish when the stream reaches
+* message_stop. A stream that pauses (pause_turn) or ends before
+* message_stop yields NO terminal event of its own: the return value's
+* pauseTurn and finished flags report which case happened, and the
+* `anthropic()` adapter turns a truncated read (finished false without
+* a pause) into the retryable transport error the contract requires,
+* so a direct mapper consumer must check the flags rather than wait
+* for an error event. `carryRetained` holds thinking blocks from
 * earlier pause_turn continuations of the same turn so the terminal
 * finish ships the whole turn's retention payload (M4-T02).
 */
@@ -603,6 +609,24 @@ async function* mapAnthropicStream(stream, ids, options) {
 	return mapping;
 }
 /**
+* Largest delay a Node timer represents exactly; a bigger value would
+* overflow into an almost immediate (storm inducing) retry.
+*/
+const MAX_RETRY_AFTER_MS = 2147483647;
+/**
+* Parses a Retry-After header into milliseconds. Only the delta
+* seconds form is honored: the HTTP date form and any other
+* unparsable value return undefined so the engine falls back to its
+* computed policy backoff instead of receiving NaN, and a huge but
+* finite value is clamped to the Node timer maximum (v1.28.0 review
+* P2).
+*/
+function retryAfterMsFrom(header) {
+	const seconds = Number(header);
+	if (!Number.isFinite(seconds) || seconds < 0) return;
+	return Math.min(Math.round(seconds * 1e3), MAX_RETRY_AFTER_MS);
+}
+/**
 * Projects an SDK/API error into the retryable WireError vocabulary:
 * 429 rate limits surface retryAfterMs and the x-ratelimit-* buckets; 529
 * overloaded and 5xx are retryable transport; everything else is terminal
@@ -619,7 +643,8 @@ function anthropicErrorToWire(error) {
 		return headers[name];
 	};
 	if (status === 429) {
-		const retryAfter = headerGet("retry-after");
+		const retryAfterHeader = headerGet("retry-after");
+		const retryAfterMs = retryAfterHeader === void 0 ? void 0 : retryAfterMsFrom(retryAfterHeader);
 		const buckets = {};
 		for (const name of [
 			"x-ratelimit-limit-requests",
@@ -638,7 +663,7 @@ function anthropicErrorToWire(error) {
 			retryable: true,
 			data: {
 				kind: "rate-limit",
-				...retryAfter === void 0 ? {} : { retryAfterMs: Number(retryAfter) * 1e3 },
+				...retryAfterMs === void 0 ? {} : { retryAfterMs },
 				...Object.keys(buckets).length > 0 ? { buckets } : {},
 				status: 429
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/anthropic",
-  "version": "1.28.0",
+  "version": "1.29.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.110.0",
-    "@rulvar/core": "1.28.0"
+    "@rulvar/core": "1.29.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "tsdown": "^0.22.3",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.28.0"
+    "@rulvar/testing": "1.29.0"
   },
   "repository": {
     "type": "git",