@rulvar/anthropic 1.28.0 → 1.30.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,25 @@ 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 RFC delta
+* seconds grammar is honored: after trimming optional whitespace the
+* value must be a nonempty run of decimal digits, so the HTTP date
+* form, signs, decimals, hex, exponents, and empty values all return
+* undefined and the engine falls back to its computed policy backoff
+* (v1.29.0 review P3; `Number()` alone accepted every one of those).
+* A huge digit run is clamped to the Node timer maximum.
+*/
+function retryAfterMsFrom(header) {
+	const trimmed = header.trim();
+	if (!/^[0-9]+$/.test(trimmed)) return;
+	return Math.min(Number(trimmed) * 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 +644,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 +664,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.30.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.30.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "tsdown": "^0.22.3",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.28.0"
+    "@rulvar/testing": "1.30.0"
   },
   "repository": {
     "type": "git",