@warlock.js/ai-anthropic 5.30.0 → 5.32.0

package/esm/model.d.mts

@@ -1,7 +1,7 @@
 import { AnthropicModelConfig } from "./config.type.mjs";
+import { AnthropicNonStreamingRequest, AnthropicRequest, AnthropicRequestOptions, AnthropicStreamingRequest } from "./request.type.mjs";
 import Anthropic from "@anthropic-ai/sdk";
 import { Message, ModelCallOptions, ModelCapabilities, ModelContract, ModelPricing, ModelResponse, ModelStreamChunk } from "@warlock.js/ai";
-
 //#region ../../packages/ai-anthropic/src/model.d.ts
 /**
  * Anthropic-backed implementation of `ModelContract`.
@@ -41,7 +41,7 @@ import { Message, ModelCallOptions, ModelCapabilities, ModelContract, ModelPrici
  *
  * const result = await myAgent.execute("Summarize today's news.");
  */
-declare class AnthropicModel implements ModelContract {
+export declare class AnthropicModel implements ModelContract {
   readonly name: string;
   readonly provider: string;
   readonly capabilities: ModelCapabilities;
@@ -49,6 +49,9 @@ declare class AnthropicModel implements ModelContract {
   private readonly client;
   private readonly config;
   private readonly thinkingMode;
+  /** Documented max output tokens of this model, when known. Sizes the default `max_tokens`. */
+  private readonly maxOutputTokens?;
+  private readonly preservedThinking;
   private readonly logger;
   constructor(client: Anthropic, config: AnthropicModelConfig, provider?: string);
   /**
@@ -58,6 +61,29 @@ declare class AnthropicModel implements ModelContract {
    * instance's `ModelConfig` defaults for this call only.
    */
   complete(messages: Message[], options?: ModelCallOptions): Promise<ModelResponse>;
+  /** Build a detached request snapshot without sending it to Anthropic. */
+  buildRequest(messages: Message[], options: ModelCallOptions & {
+    stream: true;
+  }): AnthropicStreamingRequest;
+  buildRequest(messages: Message[], options?: ModelCallOptions & {
+    stream?: false;
+  }): AnthropicNonStreamingRequest;
+  buildRequest(messages: Message[], options?: ModelCallOptions & {
+    stream?: boolean;
+  }): AnthropicRequest;
+  /**
+   * `buildRequest()` for the adapter's own calls: a build failure (a reserved
+   * body key, a `providerOptions.anthropic.body` value `structuredClone`
+   * cannot copy) is logged like a send failure and rejects as an `AIError`.
+   * Errors that are not already an `AIError` become an `InvalidRequestError`,
+   * since nothing reached Anthropic and retrying cannot help.
+   */
+  private buildLoggedRequest;
+  /** Send a built request without rebuilding its body or applying model defaults. */
+  send(request: AnthropicNonStreamingRequest, options?: AnthropicRequestOptions): Promise<ModelResponse>;
+  send(request: AnthropicStreamingRequest, options?: AnthropicRequestOptions): AsyncIterable<ModelStreamChunk>;
+  send(request: AnthropicRequest, options?: AnthropicRequestOptions): Promise<ModelResponse> | AsyncIterable<ModelStreamChunk>;
+  private completeRequest;
   /**
    * Count the input tokens a request would use, through Anthropic's
    * `messages.countTokens` endpoint (a network call; no tokens are
@@ -76,8 +102,14 @@ declare class AnthropicModel implements ModelContract {
    * arguments have fully accumulated, and a terminal `done` carrying the
    * final finish reason + usage totals. Callers consume it with
    * `for await`.
+   *
+   * With `options.streamChunks` it also yields `reasoning` for every
+   * non-empty `thinking_delta`, `tool-args` for every `input_json_delta`
+   * of a client `tool_use` block, and `usage` after `message_start` and
+   * each `message_delta` (whose counts are cumulative).
    */
   stream(messages: Message[], options?: ModelCallOptions): AsyncIterable<ModelStreamChunk>;
+  private streamRequest;
   /**
    * Fold one stream event into the per-index block accumulator. Unknown
    * block and delta types (beta `compaction`, future additions) are kept
@@ -93,16 +125,26 @@ declare class AnthropicModel implements ModelContract {
    * and the beta-only body fields); otherwise to `client.messages`. The
    * cancellation signal rides in the request options, as before.
    */
-  private send;
+  private dispatch;
   /**
-   * The full request body: the adapter-built params, then
-   * `thinking.display` when thinking is sent on an adaptive model, then
-   * `providerOptions.anthropic.body` merged last (caller fields win). The
-   * body may add fields the adapter does not build (`context_management`,
-   * `fallbacks`, …) but may not replace the conversation or the model —
-   * see {@link RESERVED_BODY_FIELDS}.
+   * The full request body and the beta flags it needs: the adapter-built
+   * params, then `thinking.display` when thinking is sent on an adaptive
+   * model, the typed `thinkingBlockBinding`, `contextManagement` and
+   * `serverCompaction` options, then `providerOptions.anthropic.body`
+   * merged last (caller fields win). The body may add fields the adapter
+   * does not build (`fallbacks`, …) but may not replace the conversation or
+   * the model — see {@link RESERVED_BODY_FIELDS}.
    */
   private buildBody;
+  /**
+   * Set `thinking.block_binding.prefix_mismatch_behavior`. It rides on
+   * adaptive or budget (`enabled`) thinking. A model that runs adaptive
+   * thinking when `thinking` is omitted (every preserved-thinking model) gets
+   * an explicit `{ type: "adaptive" }`, which is the same request. Any other
+   * shape (`between_tools`, `disabled`) takes no extra field, so the option
+   * is skipped with a debug log.
+   */
+  private applyBlockBinding;
   /**
    * Assemble the Anthropic request body shared by `complete()` and
    * `stream()` (each adds its own `stream` literal so the SDK's create
@@ -116,6 +158,20 @@ declare class AnthropicModel implements ModelContract {
    * reject any explicit temperature (see `acceptsTemperature`).
    */
   private buildParams;
+  /**
+   * The `max_tokens` sent when neither the call nor the model config sets
+   * `maxTokens`:
+   *
+   * - streaming: the model's documented max output, or
+   *   `DEFAULT_MAX_TOKENS` (16384) for an unknown id;
+   * - non-streaming: `DEFAULT_MAX_TOKENS`, capped by the model's max output
+   *   (the SDK requires streaming for larger non-streaming requests unless
+   *   the client sets a `timeout`; see `DEFAULT_MAX_TOKENS`).
+   *
+   * With thinking on, the value is raised to at least the thinking budget
+   * plus `MIN_ANSWER_TOKENS`, and never exceeds the model's max output.
+   */
+  private resolveDefaultMaxTokens;
   /**
    * Spread-friendly `system` fragment. Returns an empty object when no
    * system prompt was hoisted out of the messages.
@@ -161,12 +217,18 @@ declare class AnthropicModel implements ModelContract {
    *   `messages.d.ts:1084`), so the budget is floored at that minimum.
    *
    * The neutral `effort: "none"` ("run without reasoning") is mapped per
-   * model:
-   * - Claude Sonnet 5.5 (`acceptsBetweenTools`): `thinking: { type:
-   *   "between_tools" }`, its only thinking-off form. It is sent alone —
-   *   no `output_config.effort` (the model default, `high`, is within the
-   *   `high`-or-below range it requires) and no `display`, both of which
-   *   the API rejects alongside it.
+   * model by `noReasoningForm` (see `thinking-mode.ts` for the sources):
+   * - Claude Sonnet 5.5: `thinking: { type: "between_tools" }`, its only
+   *   thinking-off form. It is sent alone — no `output_config.effort` (the
+   *   model default, `high`, is within the `high`-or-below range it
+   *   requires) and no `display`, both of which the API rejects alongside it.
+   * - Claude Sonnet 5 and Claude Haiku 5.5: `thinking: { type: "disabled" }`
+   *   with no effort and no `display`. Haiku 5.5 accepts `disabled` only at
+   *   effort `high` or below; its default (`medium`) applies.
+   * - Claude Opus 5: adaptive thinking at `output_config.effort: "low"`.
+   *   Opus 5 accepts `disabled`, but with it the model can write a tool call
+   *   as plain text (the call never runs) and leak thinking tags; the lowest
+   *   effort is the documented alternative.
    * - Opus 5.5 and Fable 5/5.1: no `thinking` field. These models have no
    *   thinking-off form (`disabled` and `budget_tokens` are a 400 at every
    *   effort), so thinking still runs at the model's default effort. Pass
@@ -174,6 +236,11 @@ declare class AnthropicModel implements ModelContract {
    * - Every other model: no `thinking` field, as before.
    */
   private buildThinking;
+  /**
+   * The thinking settings for `reasoning: { effort: "none" }`, per
+   * `noReasoningForm(this.name)` (documented on `buildThinking`).
+   */
+  private buildNoReasoning;
   /**
    * Spread-friendly tools fragment. Returns an empty object when no
    * tools were supplied so the caller can unconditionally spread it.
@@ -230,12 +297,16 @@ declare class AnthropicModel implements ModelContract {
   /**
    * Normalize Anthropic's `usage` block into the neutral `Usage` shape.
    * Anthropic reports `input_tokens` / `output_tokens` separately with
-   * no pre-summed total, so `total` is computed. Cache-read tokens are
-   * surfaced as `cachedTokens` and cache-write tokens as
-   * `cacheWriteTokens`, each only when non-zero. Anthropic also reports
+   * no pre-summed total, so `total` is computed. `input_tokens` is the
+   * uncached remainder only — cache reads (`cachedTokens`) and writes
+   * (`cacheWriteTokens`, with the 1-hour share in `cacheWrite1hTokens`)
+   * come on top of it — so the usage is marked
+   * `inputIncludesCache: false`. Anthropic also reports
    * `output_tokens_details.thinking_tokens` as the reasoning subset of
    * its inclusive `output_tokens`; it is surfaced as `reasoningTokens`
-   * when present, without changing the billing total.
+   * when present, without changing the billing total. Server-side
+   * compaction iterations are added in (see {@link compactionIterationUsage}).
+   * `cost` is attached when the model is priced.
    */
   private extractUsage;
   /**
@@ -246,5 +317,4 @@ declare class AnthropicModel implements ModelContract {
   private logAndWrap;
 }
 //#endregion
-export { AnthropicModel };
 //# sourceMappingURL=model.d.mts.map

package/esm/model.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.mts","names":[],"sources":["../../../../../../../packages/ai-anthropic/src/model.ts"],"mappings":";;;;;;;AA8KA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,cAAA,YAA0B,aAAA;EAAA,SACrB,IAAA;EAAA,SACA,QAAA;EAAA,SACA,YAAA,EAAc,iBAAA;EAAA,SACd,OAAA,GAAU,YAAA;EAAA,iBAET,MAAA;EAAA,iBACA,MAAA;EAAA,iBACA,YAAA;EAAA,iBACA,MAAA;cAGf,MAAA,EAAQ,SAAA,EACR,MAAA,EAAQ,oBAAA,EACR,QAAA;EA0FiC;;;;;;EAlDtB,QAAA,CAAS,QAAA,EAAU,OAAA,IAAW,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,aAAA;EA+E9E;;;;;;;;;;;EA7BW,WAAA,CAAY,QAAA,EAAU,OAAA,IAAW,OAAA,GAAU,gBAAA,GAAmB,OAAA;EAqbnE;;;;;;;EAzZM,MAAA,CACZ,QAAA,EAAU,OAAA,IACV,OAAA,GAAU,gBAAA,GACT,aAAA,CAAc,gBAAA;EA4nBT;;;AA4BU;;;EA5BV,QArdA,kBAAA;;UAoDA,oBAAA;;;;;;;UAkBA,IAAA;;;;;;;;;UAqBA,SAAA;;;;;;;;;;;;;UAgDA,WAAA;;;;;;;;;;;;;UA2DA,WAAA;;;;;;UA0BA,0BAAA;;;;;;UAeA,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAyCA,aAAA;;;;;;;;;;;;;;UAkDA,UAAA;;;;;;;;;UA8BA,iBAAA;;;;;;;;;;;;;UA8BA,2BAAA;;;;;;UAmBA,WAAA;;;;;;UAYA,gBAAA;;;;;UAuBA,qBAAA;;;;;;;;;;;UAyBA,YAAA;;;;;;UA4BA,UAAA;AAAA"}
+{"version":3,"file":"model.d.mts","names":[],"sources":["../../../../../../../packages/ai-anthropic/src/model.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAoNa,0BAA0B;WACrB;WACA;WACA,cAAc;WACd,UAAU;mBAET;mBACA;mBACA;;mBAEA;mBACA;mBACA;EAEjB,YACE,QAAQ,WACR,QAAQ,sBACR;;;;;;;EAgDW,SAAS,UAAU,WAAW,UAAU,mBAAmB,QAAQ;;EAOzE,aACL,UAAU,WACV,SAAS;IAAqB;MAC7B;EACI,aACL,UAAU,WACV,UAAU;IAAqB;MAC9B;EACI,aACL,UAAU,WACV,UAAU;IAAqB;MAC9B;;;;;;;;UAmBK;;EA+BD,KACL,SAAS,8BACT,UAAU,0BACT,QAAQ;EACJ,KACL,SAAS,2BACT,UAAU,0BACT,cAAc;EACV,KACL,SAAS,kBACT,UAAU,0BACT,QAAQ,iBAAiB,cAAc;UAqB5B;;;;;;;;;;;;EA0CD,YAAY,UAAU,WAAW,UAAU,mBAAmB;;;;;;;;;;;;;EAyC7D,OACZ,UAAU,WACV,UAAU,mBACT,cAAc;UAOF;;;;;;;UAwMP;;UAoDA;;;;;;;UAkBA;;;;;;;;;;UAgCA;;;;;;;;;UA+EA;;;;;;;;;;;;;UAsCA;;;;;;;;;;;;;;UA2DA;;;;;;;;;;;;;UAsBA;;;;;;UA0BA;;;;;;UAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+CA;;;;;UAwCA;;;;;;;;;;;;;;UA8BA;;;;;;;;;UAyCA;;;;;;;;;;;;;UA8BA;;;;;;UAmBA;;;;;;UAYA;;;;;UAuBA;;;;;;;;;;;;;;;UA6BA;;;;;;UAiCA"}