@rulvar/anthropic 1.0.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;
@@ -67,10 +67,15 @@ declare class IdMap {
 }
 type Block = Record<string, unknown>;
 /**
+* Returns a deep copy of the schema with the unsupported keywords
+* removed at SCHEMA positions only: a property literally named
+* "minimum" (a key inside `properties`) survives. The input is never
+* mutated; unrecognized keywords are copied through untouched.
+*/
+/**
 * 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;
@@ -86,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 {
@@ -109,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[];
@@ -118,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,
@@ -54,6 +54,22 @@ const ANTHROPIC_MODELS = {
 		cacheRead: .3,
 		cacheWrite: 3.75
 	}, 2048),
+	"claude-haiku-4-5": (() => {
+		const base = current(2e5, 64e3, {
+			in: 1,
+			out: 5,
+			cacheRead: .1,
+			cacheWrite: 1.25
+		}, 2048);
+		return {
+			...base,
+			caps: {
+				...base.caps,
+				reasoningEfforts: []
+			},
+			thinkingForm: "enabled-budget"
+		};
+	})(),
 	"claude-opus-4-6": {
 		...current(2e5, 32e3, {
 			in: 15,
@@ -98,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();
@@ -126,6 +142,75 @@ var IdMap = class {
 		return wireId;
 	}
 };
+/**
+* Keywords the constrained-decoding schema validator rejects with a
+* live 400 ("For 'integer' type, property 'minimum' is not
+* supported"): every numeric bound plus, asymmetrically, maxItems
+* (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.
+* 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.
+*/
+const CONSTRAINED_DECODING_UNSUPPORTED = /* @__PURE__ */ new Set([
+	"minimum",
+	"maximum",
+	"exclusiveMinimum",
+	"exclusiveMaximum",
+	"multipleOf",
+	"maxItems"
+]);
+/** Keywords whose value is a map of property NAMES to schemas. */
+const SCHEMA_MAP_KEYWORDS = /* @__PURE__ */ new Set([
+	"properties",
+	"patternProperties",
+	"$defs",
+	"definitions"
+]);
+/** Keywords whose value is a schema or an array of schemas. */
+const SCHEMA_VALUE_KEYWORDS = /* @__PURE__ */ new Set([
+	"items",
+	"prefixItems",
+	"additionalProperties",
+	"additionalItems",
+	"propertyNames",
+	"contains",
+	"anyOf",
+	"oneOf",
+	"allOf",
+	"not",
+	"if",
+	"then",
+	"else"
+]);
+/**
+* Returns a deep copy of the schema with the unsupported keywords
+* removed at SCHEMA positions only: a property literally named
+* "minimum" (a key inside `properties`) survives. The input is never
+* mutated; unrecognized keywords are copied through untouched.
+*/
+function scrubForConstrainedDecoding(schema) {
+	if (Array.isArray(schema)) return schema.map((entry) => scrubForConstrainedDecoding(entry));
+	if (schema === null || typeof schema !== "object") return schema;
+	const out = {};
+	for (const [key, value] of Object.entries(schema)) {
+		if (CONSTRAINED_DECODING_UNSUPPORTED.has(key)) continue;
+		if (SCHEMA_MAP_KEYWORDS.has(key) && value !== null && typeof value === "object") {
+			const map = {};
+			for (const [name, sub] of Object.entries(value)) map[name] = scrubForConstrainedDecoding(sub);
+			out[key] = map;
+			continue;
+		}
+		if (SCHEMA_VALUE_KEYWORDS.has(key)) {
+			out[key] = scrubForConstrainedDecoding(value);
+			continue;
+		}
+		out[key] = value;
+	}
+	return out;
+}
 function cacheControl(ttl) {
 	return ttl === "1h" ? {
 		type: "ephemeral",
@@ -135,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 = [];
@@ -203,12 +287,15 @@ function buildAnthropicParams(req, options) {
 	if (systemBlocks.length > 0) params.system = systemBlocks;
 	if (req.stopSequences !== void 0) params.stop_sequences = req.stopSequences;
 	if (req.tools !== void 0) {
-		params.tools = req.tools.map((tool) => ({
-			name: tool.name,
-			description: tool.description,
-			input_schema: tool.parameters,
-			...isStrictCompatibleSchema(tool.parameters) ? { strict: true } : {}
-		}));
+		params.tools = req.tools.map((tool) => {
+			const strict = isStrictCompatibleSchema(tool.parameters);
+			return {
+				name: tool.name,
+				description: tool.description,
+				input_schema: strict ? scrubForConstrainedDecoding(tool.parameters) : tool.parameters,
+				...strict ? { strict: true } : {}
+			};
+		});
 		if (req.toolChoice === "required") params.tool_choice = { type: "any" };
 		else if (typeof req.toolChoice === "object") params.tool_choice = {
 			type: "tool",
@@ -222,7 +309,7 @@ function buildAnthropicParams(req, options) {
 	if (req.effort !== void 0) outputConfig.effort = req.effort;
 	if (req.schema !== void 0) outputConfig.format = {
 		type: "json_schema",
-		schema: req.schema
+		schema: scrubForConstrainedDecoding(req.schema)
 	};
 	if (anthropicOptions.task_budget !== void 0) outputConfig.task_budget = anthropicOptions.task_budget;
 	if (Object.keys(outputConfig).length > 0) params.output_config = outputConfig;
@@ -264,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) {
@@ -310,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;
@@ -330,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 = {
@@ -496,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;
@@ -551,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.0.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.0.0"
+    "@rulvar/core": "1.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",