@rulvar/anthropic 1.231.0 → 1.232.0

package/dist/index.d.ts

@@ -87,6 +87,19 @@ interface AnthropicAdapterOptions {
   * structural `AnthropicClientLike` mock (tests).
   */
   client?: Anthropic | AnthropicClientLike;
+  /**
+  * The `refreshCaps()` pagination bound (RV2904), the MCP `maxPages`
+  * doctrine applied to the provider's own metadata surface: past this
+  * many pages with more still reported, the refresh fails typed
+  * instead of truncating, because a silently partial caps table would
+  * clamp output bounds against limits that are not the model's.
+  * Cursor cycles (a page answering the cursor it was queried with, or
+  * one this sweep already used) are refused UNCONDITIONALLY, bound or
+  * none: a cycle is never a legitimate pagination step. Unset keeps
+  * pagination unbounded exactly like MCP without a declared cap, with
+  * only the cycle guards armed.
+  */
+  capsMaxPages?: number;
 }
 /**
 * Creates the first-class Anthropic adapter (id 'anthropic'). SDK

package/dist/index.js

@@ -807,6 +807,8 @@ function resolveAnthropicClient(options) {
 */
 function anthropic(options = {}) {
 	const client = resolveAnthropicClient(options);
+	const capsMaxPages = options.capsMaxPages;
+	if (capsMaxPages !== void 0 && (!Number.isInteger(capsMaxPages) || capsMaxPages < 1)) throw new ConfigError(`anthropic(): capsMaxPages must be a positive integer; got ${JSON.stringify(capsMaxPages)}`);
 	const ids = new IdMap(createCanonicalIdMinter());
 	const refreshed = /* @__PURE__ */ new Map();
 	function infoFor(model) {
@@ -830,8 +832,11 @@ function anthropic(options = {}) {
 		},
 		async refreshCaps() {
 			let afterId;
+			const visited = /* @__PURE__ */ new Set();
+			let pages = 0;
 			do {
 				const page = await client.models.list(afterId === void 0 ? {} : { after_id: afterId });
+				pages += 1;
 				for (const model of page.data) {
 					const id = model.id;
 					if (typeof id !== "string") continue;
@@ -840,7 +845,12 @@ function anthropic(options = {}) {
 					if (typeof model.max_tokens === "number") patch.maxOutputTokens = model.max_tokens;
 					if (Object.keys(patch).length > 0) refreshed.set(id, patch);
 				}
-				afterId = page.has_more === true && typeof page.last_id === "string" ? page.last_id : void 0;
+				if (afterId !== void 0) visited.add(afterId);
+				const next = page.has_more === true && typeof page.last_id === "string" ? page.last_id : void 0;
+				if (next !== void 0 && next === afterId) throw new ConfigError(`anthropic: models.list returned the cursor it was queried with ('${next}') on page ${String(pages)}: the pagination makes no progress`);
+				if (next !== void 0 && visited.has(next)) throw new ConfigError(`anthropic: models.list returned a cursor this sweep already visited ('${next}') on page ${String(pages)}: the pagination cycles`);
+				if (capsMaxPages !== void 0 && pages >= capsMaxPages && next !== void 0) throw new ConfigError(`anthropic: models.list still reports another page after ${String(pages)} page(s), over the declared capsMaxPages ${String(capsMaxPages)}; raise the cap or trim the account`);
+				afterId = next;
 			} while (afterId !== void 0);
 		},
 		async *stream(req, signal, hooks) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/anthropic",
-  "version": "1.231.0",
+  "version": "1.232.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.115.0",
-    "@rulvar/core": "1.231.0"
+    "@rulvar/core": "1.232.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "tsdown": "^0.22.14",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.231.0"
+    "@rulvar/testing": "1.232.0"
   },
   "repository": {
     "type": "git",