@rulvar/anthropic 1.5.2 → 1.7.0

package/README.md

@@ -6,7 +6,7 @@ compilation, `pause_turn` continuation, typed refusal outcomes, and
 usage normalization. Exports the `anthropic` adapter factory; models are
 addressed as `'anthropic:<model>'` in routing.
 
-Part of [rulvar](https://rulvar.com), an embeddable TypeScript engine
+Part of [Rulvar](https://rulvar.com), an embeddable TypeScript engine
 for durable, budget-bounded multi-agent LLM workflows, where a completed
 LLM call is never paid for twice. Full documentation:
 [docs.rulvar.com](https://docs.rulvar.com).

package/dist/index.d.ts

@@ -17,7 +17,12 @@ declare const ANTHROPIC_MODELS: Record<string, AnthropicModelInfo>;
 /**
 * Unknown Anthropic models are assumed current-generation: adaptive
 * thinking, native structured outputs, no sampling parameters. refreshCaps
-* corrects window/output figures from the live model list.
+* corrects window/output figures from the live model list. Pricing stays
+* ABSENT for an unknown model: a fabricated row silently misprices every
+* model newer than this table. Hosts price it via a versioned
+* createEngine({ pricing }) row; until then its usage surfaces in
+* CostReport.unpriced and a run ceiling warns that it cannot bound the
+* model.
 */
 declare function anthropicModelInfo(model: string): AnthropicModelInfo;
 //#endregion
@@ -102,23 +107,26 @@ declare function mapStopReason(stopReason: string | null | undefined, stopDetail
 */
 declare function normalizeAnthropicUsage(raw: Record<string, unknown> | undefined): Usage;
 interface TurnMapping {
-  events: ChatEvent[];
   /** Assistant content blocks collected verbatim (pause_turn continuation). */
   assistantContent: Block[];
   pauseTurn: boolean;
   finished: boolean;
 }
 /**
-* Maps one Messages API stream into ChatEvents. Emits 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 earlier pause_turn
-* continuations of the same turn so the terminal finish ships the whole
-* turn's retention payload (M4-T02).
+* Maps one Messages API stream into ChatEvents, yielding each canonical
+* event AS the corresponding provider event is consumed: the consumer's
+* pull drives the provider read (natural backpressure, no buffering, no
+* 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
+* earlier pause_turn continuations of the same turn so the terminal
+* finish ships the whole turn's retention payload (M4-T02).
 */
-declare function mapAnthropicStream(stream: AsyncIterable<AnthropicStreamEvent>, ids: IdMap, emit: (event: ChatEvent) => void, options?: {
+declare function mapAnthropicStream(stream: AsyncIterable<AnthropicStreamEvent>, ids: IdMap, options?: {
   carryRetained?: Block[];
-}): Promise<TurnMapping>;
+}): AsyncGenerator<ChatEvent, TurnMapping>;
 /**
 * Projects an SDK/API error into the retryable WireError vocabulary:
 * 429 rate limits surface retryAfterMs and the x-ratelimit-* buckets; 529

package/dist/index.js

@@ -17,12 +17,12 @@ function current(contextWindow, maxOutputTokens, pricing, cacheMinTokens) {
 			reasoningEfforts: ALL_EFFORTS,
 			contextWindow,
 			maxOutputTokens,
-			pricing: {
+			...pricing === void 0 ? {} : { pricing: {
 				inputUsdPerMTok: pricing.in,
 				outputUsdPerMTok: pricing.out,
 				cacheReadUsdPerMTok: pricing.cacheRead,
 				cacheWriteUsdPerMTok: pricing.cacheWrite
-			}
+			} }
 		},
 		thinkingForm: "adaptive",
 		cacheMinTokens
@@ -92,18 +92,23 @@ const ANTHROPIC_MODELS = {
 /**
 * Unknown Anthropic models are assumed current-generation: adaptive
 * thinking, native structured outputs, no sampling parameters. refreshCaps
-* corrects window/output figures from the live model list.
+* corrects window/output figures from the live model list. Pricing stays
+* ABSENT for an unknown model: a fabricated row silently misprices every
+* model newer than this table. Hosts price it via a versioned
+* createEngine({ pricing }) row; until then its usage surfaces in
+* CostReport.unpriced and a run ceiling warns that it cannot bound the
+* model.
 */
 function anthropicModelInfo(model) {
 	const exact = ANTHROPIC_MODELS[model];
 	if (exact !== void 0) return exact;
-	for (const [name, info] of Object.entries(ANTHROPIC_MODELS)) if (model.startsWith(`${name}-`)) return info;
-	return current(4e5, 64e3, {
-		in: 10,
-		out: 50,
-		cacheRead: 1,
-		cacheWrite: 12.5
-	}, 4096);
+	let best;
+	for (const [name, info] of Object.entries(ANTHROPIC_MODELS)) if (model.startsWith(`${name}-`) && (best === void 0 || name.length > best.name.length)) best = {
+		name,
+		info
+	};
+	if (best !== void 0) return best.info;
+	return current(4e5, 64e3, void 0, 4096);
 }
 //#endregion
 //#region src/wire.ts
@@ -412,24 +417,23 @@ function normalizeAnthropicUsage(raw) {
 	};
 }
 /**
-* Maps one Messages API stream into ChatEvents. Emits 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 earlier pause_turn
-* continuations of the same turn so the terminal finish ships the whole
-* turn's retention payload (M4-T02).
+* Maps one Messages API stream into ChatEvents, yielding each canonical
+* event AS the corresponding provider event is consumed: the consumer's
+* pull drives the provider read (natural backpressure, no buffering, no
+* 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
+* earlier pause_turn continuations of the same turn so the terminal
+* finish ships the whole turn's retention payload (M4-T02).
 */
-async function mapAnthropicStream(stream, ids, emit, options) {
+async function* mapAnthropicStream(stream, ids, options) {
 	const mapping = {
-		events: [],
 		assistantContent: [],
 		pauseTurn: false,
 		finished: false
 	};
-	const push = (event) => {
-		mapping.events.push(event);
-		emit(event);
-	};
 	let usage = {
 		inputTokens: 0,
 		outputTokens: 0,
@@ -446,10 +450,10 @@ async function mapAnthropicStream(stream, ids, emit, options) {
 			const message = event.message;
 			responseId = typeof message?.id === "string" ? message.id : void 0;
 			usage = normalizeAnthropicUsage(message?.usage);
-			push({
+			yield {
 				type: "usage",
 				usage: { ...usage }
-			});
+			};
 			break;
 		}
 		case "content_block_start": {
@@ -465,11 +469,11 @@ async function mapAnthropicStream(stream, ids, emit, options) {
 					json: "",
 					block: { ...block }
 				});
-				push({
+				yield {
 					type: "tool-call-start",
 					id: canonicalId,
 					name: block.name
-				});
+				};
 			} else if (type === "thinking" || type === "redacted_thinking") openBlocks.set(index, {
 				kind: "thinking",
 				json: "",
@@ -498,25 +502,25 @@ async function mapAnthropicStream(stream, ids, emit, options) {
 			if (delta.type === "text_delta") {
 				const text = delta.text;
 				open.block.text = `${open.block.text ?? ""}${text}`;
-				push({
+				yield {
 					type: "text-delta",
 					text
-				});
+				};
 			} else if (delta.type === "thinking_delta") {
 				const text = delta.thinking;
 				open.block.thinking = `${open.block.thinking ?? ""}${text}`;
-				push({
+				yield {
 					type: "reasoning-delta",
 					text
-				});
+				};
 			} else if (delta.type === "input_json_delta") {
 				const partial = delta.partial_json;
 				open.json += partial;
-				if (open.canonicalId !== void 0) push({
+				if (open.canonicalId !== void 0) yield {
 					type: "tool-call-delta",
 					id: open.canonicalId,
 					argsTextDelta: partial
-				});
+				};
 			} else if (delta.type === "signature_delta") open.block.signature = `${open.block.signature ?? ""}${delta.signature}`;
 			break;
 		}
@@ -533,11 +537,11 @@ async function mapAnthropicStream(stream, ids, emit, options) {
 					args = { __unparsed: open.json };
 				}
 				open.block.input = args;
-				push({
+				yield {
 					type: "tool-call-end",
 					id: open.canonicalId,
 					args
-				});
+				};
 			}
 			mapping.assistantContent.push(open.block);
 			break;
@@ -566,12 +570,12 @@ async function mapAnthropicStream(stream, ids, emit, options) {
 			if (stopSequence !== void 0) meta.stopSequence = stopSequence;
 			const retained = [...options?.carryRetained ?? [], ...mapping.assistantContent.filter((block) => block.type === "thinking" || block.type === "redacted_thinking")];
 			if (retained.length > 0) meta.retainedParts = retained;
-			push({
+			yield {
 				type: "finish",
 				finish: mapped.finish ?? { reason: "stop" },
 				usage,
 				providerMetadata
-			});
+			};
 			mapping.finished = true;
 			return mapping;
 		}
@@ -696,7 +700,6 @@ function anthropic(options = {}) {
 				maxOutputTokens: info.caps.maxOutputTokens,
 				thinkingForm: info.thinkingForm
 			});
-			const pending = [];
 			let continuations = 0;
 			const carryRetained = [];
 			while (true) {
@@ -713,9 +716,17 @@ function anthropic(options = {}) {
 					};
 					return;
 				}
+				const mapper = mapAnthropicStream(stream, ids, { carryRetained });
 				let mapping;
 				try {
-					mapping = await mapAnthropicStream(stream, ids, (event) => pending.push(event), { carryRetained });
+					while (true) {
+						const next = await mapper.next();
+						if (next.done === true) {
+							mapping = next.value;
+							break;
+						}
+						yield next.value;
+					}
 				} catch (thrown) {
 					if (signal?.aborted === true) return;
 					yield {
@@ -724,8 +735,6 @@ function anthropic(options = {}) {
 					};
 					return;
 				}
-				for (const event of pending) yield event;
-				pending.length = 0;
 				if (!mapping.pauseTurn) return;
 				carryRetained.push(...mapping.assistantContent.filter((block) => block.type === "thinking" || block.type === "redacted_thinking"));
 				continuations += 1;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rulvar/anthropic",
-  "version": "1.5.2",
-  "description": "rulvar first-class provider adapter over @anthropic-ai/sdk.",
+  "version": "1.7.0",
+  "description": "Rulvar first-class provider adapter over @anthropic-ai/sdk.",
   "type": "module",
   "license": "Apache-2.0",
   "engines": {
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.110.0",
-    "@rulvar/core": "1.5.2"
+    "@rulvar/core": "1.7.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",