@warlock.js/ai-anthropic 5.34.0 → 5.34.2

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@warlock.js/ai-anthropic` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.34.2 - 2026-10-19
+
+### Fixed
+
+- Replace the loose skill catalog with a package index that points to the provider setup topic, and include orientation in generated LLM projections.
+
 ## 5.32.0 - 2026-10-18
 
 ### Changed

package/llms-full.txt

@@ -4,6 +4,19 @@
 
 > Generated artifact. Concatenates every SKILL.md and reference file under `@warlock.js/ai-anthropic/skills/`. Re-run `node scripts/generate-llms.mjs` after any change.
 
+## Package orientation
+
+---
+description: "Provider adapter for Anthropic Messages API for Claude in Warlock AI applications. Exports `AnthropicSDK` with model and provider configuration for the shared AI contracts. Use when connecting this provider, configuring extended thinking, prompt caching, token counting and usage costs, or diagnosing provider requests and usage. Read `setup-anthropic` for construction and examples using ANTHROPIC_API_KEY. Not this package: agent loops, tools and workflows → @warlock.js/ai; HTTP and MCP tools → @warlock.js/ai-tools."
+---
+
+# @warlock.js/ai-anthropic
+
+This adapter supplies provider-backed models for `@warlock.js/ai`. Read `setup-anthropic.md` to construct `AnthropicSDK`, configure extended thinking, prompt caching, token counting and usage costs, and understand provider-specific behavior.
+
+For agent composition, read the `run-ai-agent` topic of the `@warlock.js/ai` package. Keep provider configuration here and application orchestration in that package.
+
+
 ## setup-anthropic  `@warlock.js/ai-anthropic/setup-anthropic/SKILL.md`
 
 ---

package/llms.txt

@@ -6,4 +6,5 @@
 
 ## Skills
 
+- [Package orientation](@warlock.js/ai-anthropic/skills/index.md): Provider adapter for Anthropic Messages API for Claude in Warlock AI applications. Exports `AnthropicSDK` with model and provider configuration for the shared AI contracts. Use when connecting this provider, configuring extended thinking, prompt caching, token counting and usage costs, or diagnosing provider requests and usage. Read `setup-anthropic` for construction and examples using ANTHROPIC_API_KEY. Not this package: agent loops, tools and workflows → @warlock.js/ai; HTTP and MCP tools → @warlock.js/ai-tools.
 - [setup-anthropic](@warlock.js/ai-anthropic/setup-anthropic/SKILL.md): Wire @warlock.js/ai-anthropic — new AnthropicSDK({apiKey, baseURL?, provider?}) for Claude, .model({name, vision?, structuredOutput?, reasoning?, thinkingMode?, promptCaching?, maxTokens?, maxOutputTokens?}). System-prompt hoisting, max_tokens required (default: model max output when streaming, 16384 non-streaming; maxOutputTokens for gateway ids), extended thinking via options.reasoning → adaptive thinking + output_config.effort (current/unknown models) or budget_tokens (Haiku 4.5, 4.6 and older; override with thinkingMode), prompt caching via promptCaching + options.cacheControl (per-call ttl), provider blocks (thinking/compaction) replayed verbatim via ModelResponse.blocks / Message.blocks, providerOptions.anthropic (betas, body fields such as context_management / fallbacks, thinkingDisplay), model.countTokens(), distinct finish reasons (pause_turn, refusal, context_exceeded), built-in Claude list prices (ANTHROPIC_MODEL_PRICING, anthropicPricingFor, withAnthropicCacheWriteRates), cost-truth usage (inputIncludesCache: false, cachedTokens/cacheWriteTokens/cacheWrite1hTokens, usage.cost on complete()), ProviderOverloadedError for 529, no first-party embeddings. Triggers: `AnthropicSDK`, `anthropic.model`, `anthropic.count`, `maxTokens`, `maxOutputTokens`, `max_tokens`, `reasoning`, `thinking`, `budget_tokens`, `thinkingMode`, `adaptive`, `cacheControl`, `providerOptions`, `blocks`, `countTokens`, `pause_turn`, `refusal`, `context_management`, `contextManagement`, `serverCompaction`, `clear_tool_uses`, `clear_thinking`, `thinkingBlockBinding`, `block_binding`, `preservedThinking`, `ai.providerTool`, `web_search_20250305`, `bash_20250124`, `text_editor_20250728`, `streamChunks`, `thinking_delta`, `compaction`, `promptCaching`, `cachedTokens`, `cacheWriteTokens`, `cacheWrite1hTokens`, `inputIncludesCache`, `ANTHROPIC_MODEL_PRICING`, `ProviderOverloadedError`, `claude-sonnet-4-6`, `claude-haiku-4-5`, `claude-opus-4-7`; "wire claude into warlock agent", "configure anthropic provider", "use claude sonnet", "anthropic gateway baseURL", "claude extended thinking", "anthropic prompt caching cost"; typical import `import { AnthropicSDK } from "@warlock.js/ai-anthropic"`. Skip: embeddings — the `setup-openai` topic of the `warlock-js-ai-openai` skill; sibling adapters `@warlock.js/ai-openai`, `@warlock.js/ai-bedrock`, `@warlock.js/ai-google`, `@warlock.js/ai-ollama`; raw `@anthropic-ai/sdk`; Vercel `@ai-sdk/anthropic`.

package/package.json

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

package/skills/index.md

@@ -0,0 +1,9 @@
+---
+description: "Provider adapter for Anthropic Messages API for Claude in Warlock AI applications. Exports `AnthropicSDK` with model and provider configuration for the shared AI contracts. Use when connecting this provider, configuring extended thinking, prompt caching, token counting and usage costs, or diagnosing provider requests and usage. Read `setup-anthropic` for construction and examples using ANTHROPIC_API_KEY. Not this package: agent loops, tools and workflows → @warlock.js/ai; HTTP and MCP tools → @warlock.js/ai-tools."
+---
+
+# @warlock.js/ai-anthropic
+
+This adapter supplies provider-backed models for `@warlock.js/ai`. Read `setup-anthropic.md` to construct `AnthropicSDK`, configure extended thinking, prompt caching, token counting and usage costs, and understand provider-specific behavior.
+
+For agent composition, read the `run-ai-agent` topic of the `@warlock.js/ai` package. Keep provider configuration here and application orchestration in that package.

package/skills/README.md

@@ -1,9 +0,0 @@
-# `@warlock.js/ai-anthropic` — skills index
-
-Per-task skills. Cross-references name the topic ("the `<topic>` topic"), and for another package add its skill ("the `<topic>` topic of the `warlock-js-<pkg>` skill").
-
-## Skills
-
-### `setup-anthropic`
-
-Wire @warlock.js/ai-anthropic — new AnthropicSDK({apiKey, baseURL?, provider?}) for Claude, .model({name, vision?, structuredOutput?, reasoning?, thinkingMode?, promptCaching?, maxTokens?, maxOutputTokens?}). System-prompt hoisting, max_tokens required (default: model max output when streaming, 16384 non-streaming), extended thinking via options.reasoning → adaptive thinking + output_config.effort (current/unknown models) or budget_tokens (Haiku 4.5, 4.6 and older; override with thinkingMode), prompt caching via promptCaching + options.cacheControl with cost-truth usage (cachedTokens/cacheWriteTokens), no first-party embeddings. Load when wiring a Claude-backed model into a @warlock.js agent.