@warlock.js/ai-anthropic 5.31.0 → 5.32.0

package/esm/utils/to-anthropic-messages.d.mts

@@ -1,6 +1,5 @@
 import Anthropic from "@anthropic-ai/sdk";
 import { Message } from "@warlock.js/ai";
-
 //#region ../../packages/ai-anthropic/src/utils/to-anthropic-messages.d.ts
 /**
  * Result of splitting a vendor-neutral `Message[]` for the Anthropic
@@ -8,12 +7,12 @@ import { Message } from "@warlock.js/ai";
  * string (Anthropic has no `"system"` role inside `messages`), and the
  * remaining turns are mapped to `MessageParam[]`.
  */
-type AnthropicMessages = {
+export type AnthropicMessages = {
   system: string | undefined;
   messages: Anthropic.MessageParam[];
 };
 /** Options for {@link toAnthropicMessages}. */
-type ToAnthropicMessagesOptions = {
+export type ToAnthropicMessagesOptions = {
   /**
    * Leave out the `thinking` / `redacted_thinking` blocks of assistant turns
    * marked `compaction: "retained"` — turns kept verbatim after a
@@ -65,7 +64,6 @@ type ToAnthropicMessagesOptions = {
  * // system === "Be concise."
  * // messages === [{ role: "user", content: "Hi" }]
  */
-declare function toAnthropicMessages(messages: Message[], options?: ToAnthropicMessagesOptions): AnthropicMessages;
+export declare function toAnthropicMessages(messages: Message[], options?: ToAnthropicMessagesOptions): AnthropicMessages;
 //#endregion
-export { AnthropicMessages, ToAnthropicMessagesOptions, toAnthropicMessages };
 //# sourceMappingURL=to-anthropic-messages.d.mts.map

package/esm/utils/to-anthropic-messages.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"to-anthropic-messages.d.mts","names":[],"sources":["../../../../../../../../packages/ai-anthropic/src/utils/to-anthropic-messages.ts"],"mappings":";;;;;;AAUA;;;;KAAY,iBAAA;EACV,MAAA;EACA,QAAA,EAAU,SAAA,CAAU,YAAY;AAAA;;KAItB,0BAAA;EAAA;;;;AAUU;AA+CtB;;;;EA/CE,oBAAoB;AAAA;;;;;;;;;AAkDF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAHJ,mBAAA,CACd,QAAA,EAAU,OAAA,IACV,OAAA,GAAS,0BAAA,GACR,iBAAA"}
+{"version":3,"file":"to-anthropic-messages.d.mts","names":[],"sources":["../../../../../../../../packages/ai-anthropic/src/utils/to-anthropic-messages.ts"],"mappings":";;;;;;;;;YAUY;EACV;EACA,UAAU,UAAU;;;YAIV;;;;;;;;;;EAUV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+Cc,oBACd,UAAU,WACV,UAAS,6BACR"}

package/esm/utils/to-anthropic-tools.d.mts

@@ -1,6 +1,5 @@
 import Anthropic from "@anthropic-ai/sdk";
 import { ToolConfig } from "@warlock.js/ai";
-
 //#region ../../packages/ai-anthropic/src/utils/to-anthropic-tools.d.ts
 /**
  * Convert vendor-neutral `ToolConfig[]` into Anthropic's `tools` array.
@@ -13,7 +12,6 @@ import { ToolConfig } from "@warlock.js/ai";
  * const tools = toAnthropicTools([weatherTool, calculatorTool]);
  * await client.messages.create({ model, max_tokens, messages, tools });
  */
-declare function toAnthropicTools(tools: ToolConfig<unknown, unknown>[] | undefined): Anthropic.Tool[] | undefined;
+export declare function toAnthropicTools(tools: ToolConfig<unknown, unknown>[] | undefined): Anthropic.Tool[] | undefined;
 //#endregion
-export { toAnthropicTools };
 //# sourceMappingURL=to-anthropic-tools.d.mts.map

package/esm/utils/to-anthropic-tools.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"to-anthropic-tools.d.mts","names":[],"sources":["../../../../../../../../packages/ai-anthropic/src/utils/to-anthropic-tools.ts"],"mappings":";;;;;;AAcA;;;;;;;;;iBAAgB,gBAAA,CACd,KAAA,EAAO,UAAA,mCACN,SAAA,CAAU,IAAI"}
+{"version":3,"file":"to-anthropic-tools.d.mts","names":[],"sources":["../../../../../../../../packages/ai-anthropic/src/utils/to-anthropic-tools.ts"],"mappings":";;;;;;;;;;;;;;wBAcgB,iBACd,OAAO,6CACN,UAAU"}

package/llms-full.txt

@@ -457,6 +457,13 @@ const model = anthropic.model({ name: "claude-opus-5-5" }); // an AnthropicModel
 await model.countTokens(messages, { tools }); // exact, via messages.countTokens (network)
 ```
 
+For budget preflight, `countInputTokens(model, messages, { tools })` from
+`@warlock.js/ai` returns `{ tokens, source }`. It estimates only when native
+counting is absent or explicitly throws `InvalidRequestError` with
+`reason: "count-unsupported"`; this adapter preserves that signal. System and
+tools are supported natively. Ordinary validation, auth, network and rate-limit
+errors propagate. See the cost/budget guide for reserve mode.
+
 `countTokens` sends the same system prompt, tools, thinking and `providerOptions.anthropic.betas` a real call would, keeping only the fields the endpoint accepts.
 
 ## No embeddings
@@ -474,4 +481,31 @@ Anthropic ships no first-party embeddings API, so `AnthropicSDK` intentionally d
 - The `pick-ai-provider` topic of the `warlock-js-ai` skill
 - The `handle-ai-errors` topic of the `warlock-js-ai` skill
 
+## Hosted-search usage and fees
+
+`complete()` and streaming `done` map the provider's
+`usage.server_tool_use.web_search_requests` / `web_fetch_requests` to
+`usage.serverToolUse.webSearchRequests` / `webFetchRequests`. Streaming
+`message_delta` counts are cumulative snapshots, never added twice. Raw
+`server_tool_use` and search-result blocks remain in `response.blocks` and are
+replayed in history; they never invoke local function handlers.
+
+To add request fees to token costs, explicitly compose the verified
+`ANTHROPIC_SERVER_TOOL_PRICING` export into model `pricing.serverTools`:
+
+```ts
+import { ANTHROPIC_SERVER_TOOL_PRICING } from "@warlock.js/ai-anthropic";
+const model = anthropic.model({
+  name: "claude-sonnet-4-6",
+  pricing: { input: 3, output: 15, serverTools: ANTHROPIC_SERVER_TOOL_PRICING },
+});
+```
+
+The [search fee](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool#usage-and-pricing)
+is $0.01 per search; [fetch](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool#usage-and-pricing)
+has no additional request fee (verified 2026-10-18). Tokens remain additional.
+No code-execution request count is inferred from blocks. See
+[hosted-tool costs](https://warlock.js.org/v/latest/ai/recipes/cost-tracking/#hosted-tool-request-fees)
+and [fee reservations](https://warlock.js.org/v/latest/ai/recipes/cost-budgets-and-slo/#reserve-hosted-search-fees).
+
 

package/package.json

@@ -15,13 +15,13 @@
     "directory": "packages/ai-anthropic"
   },
   "peerDependencies": {
-    "@warlock.js/ai": "5.31.0"
+    "@warlock.js/ai": "5.32.0"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.129.0",
-    "@warlock.js/logger": "5.31.0"
+    "@warlock.js/logger": "5.32.0"
   },
-  "version": "5.31.0",
+  "version": "5.32.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",

package/skills/setup-anthropic/SKILL.md

@@ -449,6 +449,13 @@ const model = anthropic.model({ name: "claude-opus-5-5" }); // an AnthropicModel
 await model.countTokens(messages, { tools }); // exact, via messages.countTokens (network)
 ```
 
+For budget preflight, `countInputTokens(model, messages, { tools })` from
+`@warlock.js/ai` returns `{ tokens, source }`. It estimates only when native
+counting is absent or explicitly throws `InvalidRequestError` with
+`reason: "count-unsupported"`; this adapter preserves that signal. System and
+tools are supported natively. Ordinary validation, auth, network and rate-limit
+errors propagate. See the cost/budget guide for reserve mode.
+
 `countTokens` sends the same system prompt, tools, thinking and `providerOptions.anthropic.betas` a real call would, keeping only the fields the endpoint accepts.
 
 ## No embeddings
@@ -465,3 +472,30 @@ Anthropic ships no first-party embeddings API, so `AnthropicSDK` intentionally d
 - The `run-ai-agent` topic of the `warlock-js-ai` skill
 - The `pick-ai-provider` topic of the `warlock-js-ai` skill
 - The `handle-ai-errors` topic of the `warlock-js-ai` skill
+
+## Hosted-search usage and fees
+
+`complete()` and streaming `done` map the provider's
+`usage.server_tool_use.web_search_requests` / `web_fetch_requests` to
+`usage.serverToolUse.webSearchRequests` / `webFetchRequests`. Streaming
+`message_delta` counts are cumulative snapshots, never added twice. Raw
+`server_tool_use` and search-result blocks remain in `response.blocks` and are
+replayed in history; they never invoke local function handlers.
+
+To add request fees to token costs, explicitly compose the verified
+`ANTHROPIC_SERVER_TOOL_PRICING` export into model `pricing.serverTools`:
+
+```ts
+import { ANTHROPIC_SERVER_TOOL_PRICING } from "@warlock.js/ai-anthropic";
+const model = anthropic.model({
+  name: "claude-sonnet-4-6",
+  pricing: { input: 3, output: 15, serverTools: ANTHROPIC_SERVER_TOOL_PRICING },
+});
+```
+
+The [search fee](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool#usage-and-pricing)
+is $0.01 per search; [fetch](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-fetch-tool#usage-and-pricing)
+has no additional request fee (verified 2026-10-18). Tokens remain additional.
+No code-execution request count is inferred from blocks. See
+[hosted-tool costs](https://warlock.js.org/v/latest/ai/recipes/cost-tracking/#hosted-tool-request-fees)
+and [fee reservations](https://warlock.js.org/v/latest/ai/recipes/cost-budgets-and-slo/#reserve-hosted-search-fees).