@rulvar/anthropic 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -6,13 +6,13 @@ interface AnthropicModelInfo {
   /**
   * Wire thinking form: current models accept only adaptive; the
   * enabled/budget form remains functional only on Opus 4.6 and Sonnet
-  * 4.6 (docs/04, section "Thinking and sampling parameters").
+  * 4.6.
   */
   thinkingForm: "adaptive" | "enabled-budget";
-  /** Minimum cacheable prefix in tokens (docs/04, section "Prompt caching"). */
+  /** Minimum cacheable prefix in tokens. */
   cacheMinTokens: number;
 }
-/** Static seed table; docs/04 section 4 names the current model set. */
+/** Static seed table naming the current model set. */
 declare const ANTHROPIC_MODELS: Record<string, AnthropicModelInfo>;
 /**
 * Unknown Anthropic models are assumed current-generation: adaptive
@@ -22,7 +22,7 @@ declare const ANTHROPIC_MODELS: Record<string, AnthropicModelInfo>;
 declare function anthropicModelInfo(model: string): AnthropicModelInfo;
 //#endregion
 //#region src/adapter.d.ts
-/** pause_turn continuation cap (docs/06 Appendix A; docs/04, section 4.6). */
+/** pause_turn continuation cap. */
 declare const DEFAULT_PAUSE_TURN_MAX_CONTINUATIONS = 5;
 /** The client sub-surface the adapter consumes; injectable for tests. */
 interface AnthropicClientLike {
@@ -51,12 +51,12 @@ interface AnthropicAdapterOptions {
 /**
 * Creates the first-class Anthropic adapter (id 'anthropic'). SDK
 * autoretries are disabled (max_retries 0): the core owns retries and
-* wall-clock (docs/04, section "Retries belong to the core").
+* wall-clock.
 */
 declare function anthropic(options?: AnthropicAdapterOptions): ProviderAdapter;
 //#endregion
 //#region src/wire.d.ts
-/** Bijective canonical-to-wire tool-call id map (docs/04, section 1.2). */
+/** Bijective canonical-to-wire tool-call id map. */
 declare class IdMap {
   private readonly toWire;
   private readonly toCanonical;
@@ -75,8 +75,7 @@ type Block = Record<string, unknown>;
 /**
 * Builds Messages API params from a ChatRequest. cacheHint compiles into
 * cache_control breakpoints; beyond the provider cap of 4 the DEEPEST
-* breakpoints are kept and the shallowest dropped, deterministically
-* (docs/04, sections 1.7 and 4.4).
+* breakpoints are kept and the shallowest dropped, deterministically.
 */
 declare function buildAnthropicParams(req: ChatRequest, options: {
   ids: IdMap;
@@ -92,14 +91,14 @@ interface MappedStop {
   pauseTurn: boolean;
 }
 /**
-* The docs/04 section 4.7 stop-reason table. pause_turn never surfaces as
+* The stop-reason table. pause_turn never surfaces as
 * a canonical finish: the adapter continues internally.
 */
 declare function mapStopReason(stopReason: string | null | undefined, stopDetails: Record<string, unknown> | null | undefined): MappedStop;
 /**
 * Normalizes Messages API usage under the Usage invariant: Anthropic
 * reports input_tokens EXCLUDING cache reads and writes, so the canonical
-* inputTokens is the sum of all three (docs/04, sections 1.6 and 4.4).
+* inputTokens is the sum of all three.
 */
 declare function normalizeAnthropicUsage(raw: Record<string, unknown> | undefined): Usage;
 interface TurnMapping {
@@ -115,7 +114,7 @@ interface TurnMapping {
 * 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 (docs/04, section 2.3, M4-T02).
+* turn's retention payload (M4-T02).
 */
 declare function mapAnthropicStream(stream: AsyncIterable<AnthropicStreamEvent>, ids: IdMap, emit: (event: ChatEvent) => void, options?: {
   carryRetained?: Block[];
@@ -124,7 +123,7 @@ declare function mapAnthropicStream(stream: AsyncIterable<AnthropicStreamEvent>,
 * 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
-* transport (docs/04, section 4.9). Adapters never sleep internally.
+* transport. Adapters never sleep internally.
 */
 declare function anthropicErrorToWire(error: unknown): WireError;
 //#endregion

package/dist/index.js

@@ -28,7 +28,7 @@ function current(contextWindow, maxOutputTokens, pricing, cacheMinTokens) {
 		cacheMinTokens
 	};
 }
-/** Static seed table; docs/04 section 4 names the current model set. */
+/** Static seed table naming the current model set. */
 const ANTHROPIC_MODELS = {
 	"claude-fable-5": current(1e6, 128e3, {
 		in: 20,
@@ -114,10 +114,10 @@ function anthropicModelInfo(model) {
 * the SSE-to-ChatEvent stream mapper with pause_turn absorption, the full
 * stop-reason table, and usage normalization under the Usage invariant.
 *
-* Owning spec: docs/04-model-layer-spec.md, section "@rulvar/anthropic".
+* Adapter contract: https://docs.rulvar.com/guide/adapter-authors.
 * Pure functions; the adapter glue in adapter.ts owns the SDK client.
 */
-/** Bijective canonical-to-wire tool-call id map (docs/04, section 1.2). */
+/** Bijective canonical-to-wire tool-call id map. */
 var IdMap = class {
 	toWire = /* @__PURE__ */ new Map();
 	toCanonical = /* @__PURE__ */ new Map();
@@ -149,8 +149,8 @@ var IdMap = class {
 * (minItems, the string bounds, pattern, format, enum and const all
 * pass). The validator guards exactly two wire positions: tools sent
 * with strict: true and output_config.format json_schema; plain tools
-* accept full JSON Schema. Probed live on claude-sonnet-5, 2026-07-11
-* (docs/04, section 4.3). The engine still validates tool args and
+* accept full JSON Schema. Probed live on claude-sonnet-5, 2026-07-11.
+* The engine still validates tool args and
 * structured output against the UNSCRUBBED schema, so the dropped
 * keywords stay enforced; only the model-side hint is lost.
 */
@@ -220,8 +220,7 @@ function cacheControl(ttl) {
 /**
 * Builds Messages API params from a ChatRequest. cacheHint compiles into
 * cache_control breakpoints; beyond the provider cap of 4 the DEEPEST
-* breakpoints are kept and the shallowest dropped, deterministically
-* (docs/04, sections 1.7 and 4.4).
+* breakpoints are kept and the shallowest dropped, deterministically.
 */
 function buildAnthropicParams(req, options) {
 	const systemBlocks = [];
@@ -352,7 +351,7 @@ function applyCacheHint(params, hint) {
 	}
 }
 /**
-* The docs/04 section 4.7 stop-reason table. pause_turn never surfaces as
+* The stop-reason table. pause_turn never surfaces as
 * a canonical finish: the adapter continues internally.
 */
 function mapStopReason(stopReason, stopDetails) {
@@ -398,7 +397,7 @@ function mapStopReason(stopReason, stopDetails) {
 /**
 * Normalizes Messages API usage under the Usage invariant: Anthropic
 * reports input_tokens EXCLUDING cache reads and writes, so the canonical
-* inputTokens is the sum of all three (docs/04, sections 1.6 and 4.4).
+* inputTokens is the sum of all three.
 */
 function normalizeAnthropicUsage(raw) {
 	const input = typeof raw?.input_tokens === "number" ? raw.input_tokens : 0;
@@ -418,7 +417,7 @@ function normalizeAnthropicUsage(raw) {
 * 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 (docs/04, section 2.3, M4-T02).
+* turn's retention payload (M4-T02).
 */
 async function mapAnthropicStream(stream, ids, emit, options) {
 	const mapping = {
@@ -584,7 +583,7 @@ async function mapAnthropicStream(stream, ids, emit, options) {
 * 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
-* transport (docs/04, section 4.9). Adapters never sleep internally.
+* transport. Adapters never sleep internally.
 */
 function anthropicErrorToWire(error) {
 	const record = error;
@@ -639,14 +638,14 @@ function anthropicErrorToWire(error) {
 * wire mapping, with pause_turn absorption, SDK autoretries disabled, and
 * refreshCaps from the capabilities-bearing model list.
 *
-* Owning spec: docs/04-model-layer-spec.md, section "@rulvar/anthropic".
+* Full contract: https://docs.rulvar.com/guide/providers.
 */
-/** pause_turn continuation cap (docs/06 Appendix A; docs/04, section 4.6). */
+/** pause_turn continuation cap. */
 const DEFAULT_PAUSE_TURN_MAX_CONTINUATIONS = 5;
 /**
 * Creates the first-class Anthropic adapter (id 'anthropic'). SDK
 * autoretries are disabled (max_retries 0): the core owns retries and
-* wall-clock (docs/04, section "Retries belong to the core").
+* wall-clock.
 */
 function anthropic(options = {}) {
 	const client = options.client ?? new Anthropic({

package/package.json

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