@veryfront/ext-llm-anthropic 0.1.1186 → 0.1.1189

package/README.md

@@ -43,7 +43,8 @@ Automatic `max_tokens` defaults based on model family:
 
 | Model                        | Default max_tokens |
 | ---------------------------- | ------------------ |
-| Claude Opus/Sonnet 4.6       | 128,000            |
+| Claude Opus 4.8/4.7/4.6      | 128,000            |
+| Claude Sonnet 4.6            | 64,000             |
 | Claude Opus/Sonnet/Haiku 4.5 | 64,000             |
 | Claude Opus 4.1              | 32,000             |
 | Claude 3 Haiku               | 4,096              |
@@ -70,6 +71,20 @@ Effort-to-budget mapping: `low` = 1024, `medium` = 4096, `high` = 16384, `max` =
 
 When thinking is enabled, `temperature` and `topP` are automatically dropped (Anthropic rejects the combo).
 
+### Exact Replay
+
+Thinking, redacted thinking, ordinary `tool_use`, server-tool calls, and
+server-tool results are retained in assistant provider metadata for later
+turns. Manual callers must carry that metadata forward with the canonical
+assistant message.
+
+Raw replay is limited to six assistant messages, 4,096 total content blocks,
+and 8 MiB. When canonical calls or provider-executed results survive, their
+IDs, names, semantic inputs or results, multiplicity, and interleaving must
+match the raw blocks before transport. Structurally valid raw-only history is
+accepted only when the corresponding canonical projection is absent, for
+example after compaction.
+
 ### Prompt Caching
 
 Control cache breakpoints via `cacheControl`:
@@ -103,7 +118,13 @@ Already-versioned IDs (e.g. `anthropic.code_execution_20250522`) pass through ve
 
 ### MCP Servers
 
-Pass Anthropic-native MCP servers via `mcpServers`. Keys are automatically converted from camelCase to snake_case:
+Pass Anthropic-native MCP server connection details via `mcpServers`. The runtime validates
+that every server has a unique name and an absolute HTTPS URL, emits the current
+`mcp_servers` wire shape, and adds the required
+`mcp-client-2025-11-20` beta without dropping unrelated caller betas.
+
+Every server is paired with exactly one `mcp_toolset`. When no toolset is supplied, the
+runtime generates one that enables all tools:
 
 ```ts
 runtime.doGenerate({
@@ -112,15 +133,80 @@ runtime.doGenerate({
     type: "url",
     url: "https://example.com/mcp",
     name: "my-server",
-    authorizationToken: "Bearer ...",
-    toolConfiguration: {
-      enabled: true,
-      allowedTools: ["search"],
+    authorizationToken: "opaque-access-token",
+  }],
+});
+```
+
+For current per-tool configuration, add a provider tool whose `name` exactly matches the
+MCP server name. Camel-case arguments are converted recursively to Anthropic's wire names:
+
+```ts
+runtime.doGenerate({
+  prompt: [...],
+  mcpServers: [{
+    type: "url",
+    url: "https://example.com/mcp",
+    name: "my-server",
+    authorizationToken: "opaque-access-token",
+  }],
+  tools: [{
+    type: "provider",
+    id: "anthropic.mcp_toolset",
+    name: "my-server",
+    args: {
+      defaultConfig: {
+        enabled: false,
+        deferLoading: true,
+      },
+      configs: {
+        search: {
+          enabled: true,
+          deferLoading: false,
+        },
+      },
     },
   }],
 });
 ```
 
+The previously documented convenience form remains supported and is translated to the
+current MCPToolset allowlist contract:
+
+```ts
+mcpServers: [{
+  type: "url",
+  url: "https://example.com/mcp",
+  name: "my-server",
+  toolConfiguration: {
+    enabled: true,
+    allowedTools: ["search"],
+  },
+}];
+```
+
+Do not configure the same server or toolset through both `mcpServers` and raw
+`providerOptions`. Ambiguous definitions, duplicate names/toolsets, dangling toolsets,
+unknown MCP fields, non-HTTPS URLs, and malformed tool configuration fail before a network
+request is made. If raw `mcp_servers` and `tools` are supplied through `providerOptions`,
+they must already use Anthropic's current wire contract:
+
+```ts
+providerOptions: {
+  anthropic: {
+    mcp_servers: [{
+      type: "url",
+      url: "https://example.com/mcp",
+      name: "my-server",
+    }],
+    tools: [{
+      type: "mcp_toolset",
+      mcp_server_name: "my-server",
+    }],
+  },
+}
+```
+
 ### Container
 
 Pass `anthropicContainer` to attach a container context to the request (for computer-use sessions).

package/esm/_dnt.polyfills.d.ts

@@ -1,3 +1,14 @@
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
 declare global {
     interface Array<T> {
         /**

package/esm/_dnt.polyfills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK,CAAC,CAAC;QACf;;;;;;;;WAQG;QACH,QAAQ,CAAC,CAAC,SAAS,CAAC,EAClB,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,EACxE,OAAO,CAAC,EAAE,GAAG,GACZ,CAAC,GAAG,SAAS,CAAC;QACjB,QAAQ,CACN,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,OAAO,EACzD,OAAO,CAAC,EAAE,GAAG,GACZ,CAAC,GAAG,SAAS,CAAC;QAEjB;;;;;;;;WAQG;QACH,aAAa,CACX,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,OAAO,EACzD,OAAO,CAAC,EAAE,GAAG,GACZ,MAAM,CAAC;KACX;IACD,UAAU,UAAU;QAClB;;;;;;;;WAQG;QACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvB,SAAS,EAAE,CACP,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,KAChB,KAAK,IAAI,CAAC,EACf,OAAO,CAAC,EAAE,GAAG,GACZ,CAAC,GAAG,SAAS,CAAC;QACjB,QAAQ,CACJ,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,EACvE,OAAO,CAAC,EAAE,GAAG,GACd,MAAM,GAAG,SAAS,CAAC;QAEtB;;;;;;;;WAQG;QACH,aAAa,CACT,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,EACvE,OAAO,CAAC,EAAE,GAAG,GACd,MAAM,CAAC;KACX;CACF;AA4CD,OAAO,EAAE,CAAC"}
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAeA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC;AAEV,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK,CAAC,CAAC;QACf;;;;;;;;WAQG;QACH,QAAQ,CAAC,CAAC,SAAS,CAAC,EAClB,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,EACxE,OAAO,CAAC,EAAE,GAAG,GACZ,CAAC,GAAG,SAAS,CAAC;QACjB,QAAQ,CACN,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,OAAO,EACzD,OAAO,CAAC,EAAE,GAAG,GACZ,CAAC,GAAG,SAAS,CAAC;QAEjB;;;;;;;;WAQG;QACH,aAAa,CACX,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,OAAO,EACzD,OAAO,CAAC,EAAE,GAAG,GACZ,MAAM,CAAC;KACX;IACD,UAAU,UAAU;QAClB;;;;;;;;WAQG;QACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvB,SAAS,EAAE,CACP,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,KAChB,KAAK,IAAI,CAAC,EACf,OAAO,CAAC,EAAE,GAAG,GACZ,CAAC,GAAG,SAAS,CAAC;QACjB,QAAQ,CACJ,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,EACvE,OAAO,CAAC,EAAE,GAAG,GACd,MAAM,GAAG,SAAS,CAAC;QAEtB;;;;;;;;WAQG;QACH,aAAa,CACT,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,EACvE,OAAO,CAAC,EAAE,GAAG,GACd,MAAM,CAAC;KACX;CACF;AA4CD,OAAO,EAAE,CAAC"}

package/esm/_dnt.polyfills.js

@@ -1,3 +1,17 @@
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
+}
 function findLastIndex(self, callbackfn, that) {
     const boundFunc = that === undefined ? callbackfn : callbackfn.bind(that);
     let index = self.length - 1;

package/esm/anthropic-citations.d.ts

@@ -0,0 +1,27 @@
+export type AnthropicCitation = {
+    type: "char_location" | "page_location" | "content_block_location" | "web_search_result_location" | "search_result_location";
+    citedText: string;
+    url?: string;
+    title?: string;
+    encryptedIndex?: string;
+    source?: string;
+    fileId?: string;
+    startCharIndex?: number;
+    endCharIndex?: number;
+    startBlockIndex?: number;
+    endBlockIndex?: number;
+    startPageNumber?: number;
+    endPageNumber?: number;
+    documentIndex?: number;
+    documentTitle?: string;
+    searchResultIndex?: number;
+};
+/**
+ * Validates and normalizes the current Messages API citation union.
+ *
+ * Citation records are provider-controlled protocol data. Returning
+ * `undefined` for any malformed or unknown variant lets callers fail the
+ * successful response closed instead of silently discarding attribution.
+ */
+export declare function normalizeAnthropicCitation(raw: unknown): AnthropicCitation | undefined;
+//# sourceMappingURL=anthropic-citations.d.ts.map

package/esm/anthropic-citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-citations.d.ts","sourceRoot":"","sources":["../src/anthropic-citations.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EACA,eAAe,GACf,eAAe,GACf,wBAAwB,GACxB,4BAA4B,GAC5B,wBAAwB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AA8CF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,GACX,iBAAiB,GAAG,SAAS,CAsH/B"}

package/esm/anthropic-citations.js

@@ -0,0 +1,138 @@
+import { readRecord } from "veryfront/provider/shared";
+function readRequiredString(record, field) {
+    const value = record[field];
+    return typeof value === "string" ? value : undefined;
+}
+function readOptionalNullableString(record, field) {
+    const value = record[field];
+    return value === undefined || value === null || typeof value === "string" ? value : undefined;
+}
+function readNonNegativeInteger(record, field) {
+    const value = record[field];
+    return typeof value === "number" &&
+        Number.isSafeInteger(value) &&
+        value >= 0
+        ? value
+        : undefined;
+}
+function hasValidOptionalNullableString(record, field) {
+    return record[field] === undefined ||
+        record[field] === null ||
+        typeof record[field] === "string";
+}
+function withOptionalString(key, value) {
+    return typeof value === "string" ? { [key]: value } : {};
+}
+/**
+ * Validates and normalizes the current Messages API citation union.
+ *
+ * Citation records are provider-controlled protocol data. Returning
+ * `undefined` for any malformed or unknown variant lets callers fail the
+ * successful response closed instead of silently discarding attribution.
+ */
+export function normalizeAnthropicCitation(raw) {
+    const record = readRecord(raw);
+    if (!record || typeof record.type !== "string")
+        return undefined;
+    const citedText = readRequiredString(record, "cited_text");
+    if (citedText === undefined)
+        return undefined;
+    if (record.type === "web_search_result_location") {
+        const url = readRequiredString(record, "url");
+        const encryptedIndex = readRequiredString(record, "encrypted_index");
+        const title = readOptionalNullableString(record, "title");
+        if (url === undefined ||
+            encryptedIndex === undefined ||
+            !hasValidOptionalNullableString(record, "title")) {
+            return undefined;
+        }
+        return {
+            type: record.type,
+            citedText,
+            url,
+            encryptedIndex,
+            ...withOptionalString("title", title),
+        };
+    }
+    if (record.type === "search_result_location") {
+        const source = readRequiredString(record, "source");
+        const title = readOptionalNullableString(record, "title");
+        const searchResultIndex = readNonNegativeInteger(record, "search_result_index");
+        const startBlockIndex = readNonNegativeInteger(record, "start_block_index");
+        const endBlockIndex = readNonNegativeInteger(record, "end_block_index");
+        if (source === undefined ||
+            searchResultIndex === undefined ||
+            startBlockIndex === undefined ||
+            endBlockIndex === undefined ||
+            endBlockIndex <= startBlockIndex ||
+            !hasValidOptionalNullableString(record, "title")) {
+            return undefined;
+        }
+        return {
+            type: record.type,
+            citedText,
+            source,
+            searchResultIndex,
+            startBlockIndex,
+            endBlockIndex,
+            ...withOptionalString("title", title),
+        };
+    }
+    const documentIndex = readNonNegativeInteger(record, "document_index");
+    const documentTitle = readOptionalNullableString(record, "document_title");
+    const fileId = readOptionalNullableString(record, "file_id");
+    if (documentIndex === undefined ||
+        !hasValidOptionalNullableString(record, "document_title") ||
+        !hasValidOptionalNullableString(record, "file_id")) {
+        return undefined;
+    }
+    const common = {
+        citedText,
+        documentIndex,
+        ...withOptionalString("documentTitle", documentTitle),
+        ...withOptionalString("fileId", fileId),
+    };
+    if (record.type === "char_location") {
+        const startCharIndex = readNonNegativeInteger(record, "start_char_index");
+        const endCharIndex = readNonNegativeInteger(record, "end_char_index");
+        return startCharIndex !== undefined &&
+            endCharIndex !== undefined &&
+            endCharIndex >= startCharIndex
+            ? {
+                type: record.type,
+                ...common,
+                startCharIndex,
+                endCharIndex,
+            }
+            : undefined;
+    }
+    if (record.type === "page_location") {
+        const startPageNumber = readNonNegativeInteger(record, "start_page_number");
+        const endPageNumber = readNonNegativeInteger(record, "end_page_number");
+        return startPageNumber !== undefined &&
+            endPageNumber !== undefined &&
+            endPageNumber >= startPageNumber
+            ? {
+                type: record.type,
+                ...common,
+                startPageNumber,
+                endPageNumber,
+            }
+            : undefined;
+    }
+    if (record.type === "content_block_location") {
+        const startBlockIndex = readNonNegativeInteger(record, "start_block_index");
+        const endBlockIndex = readNonNegativeInteger(record, "end_block_index");
+        return startBlockIndex !== undefined &&
+            endBlockIndex !== undefined &&
+            endBlockIndex > startBlockIndex
+            ? {
+                type: record.type,
+                ...common,
+                startBlockIndex,
+                endBlockIndex,
+            }
+            : undefined;
+    }
+    return undefined;
+}

package/esm/anthropic-mcp-request.d.ts

@@ -0,0 +1,36 @@
+type AnthropicMcpToolConfig = {
+    enabled?: boolean;
+    defer_loading?: boolean;
+};
+type AnthropicMcpToolset = {
+    type: "mcp_toolset";
+    mcp_server_name: string;
+    default_config?: AnthropicMcpToolConfig;
+    configs?: Record<string, AnthropicMcpToolConfig>;
+    cache_control?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h";
+    };
+};
+export type AnthropicMcpRequestConfiguration = {
+    servers: Array<Record<string, unknown>>;
+    defaultToolsets: AnthropicMcpToolset[];
+    legacyConfiguredServerNames: ReadonlySet<string>;
+};
+/**
+ * Validate and translate the existing camelCase MCP convenience option into
+ * Anthropic's current MCP server and MCPToolset wire objects.
+ */
+export declare function normalizeAnthropicMcpServers(rawServers: unknown): AnthropicMcpRequestConfiguration | undefined;
+/**
+ * Convert generic provider-tool arguments without rewriting the dynamic tool
+ * names used as keys in `configs`.
+ */
+export declare function normalizeAnthropicMcpToolsetArgs(rawArgs: Record<string, unknown>): Omit<AnthropicMcpToolset, "type" | "mcp_server_name">;
+/**
+ * Validate the final request after raw provider options have been merged.
+ * Returns whether the current MCP connector beta is required.
+ */
+export declare function assertAnthropicMcpRequestContract(body: Record<string, unknown>): boolean;
+export {};
+//# sourceMappingURL=anthropic-mcp-request.d.ts.map

package/esm/anthropic-mcp-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-mcp-request.d.ts","sourceRoot":"","sources":["../src/anthropic-mcp-request.ts"],"names":[],"mappings":"AAAA,KAAK,sBAAsB,GAAG;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,WAAW,CAAC;QAClB,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClD,CAAC;AAoJF;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,OAAO,GAClB,gCAAgC,GAAG,SAAS,CAoF9C;AA6BD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAqDvD;AAiGD;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAmET"}