@rudra-js/anthropic 0.1.0 → 0.2.0

package/README.md

@@ -4,10 +4,13 @@ An Anthropic adapter for
 [`@rudra-js/core`](https://github.com/clivedsouza1010/rudra-js/tree/main/packages/core)'s
 `ComponentProvider`.
 
+> Anthropic and Claude are trademarks of Anthropic, PBC. This package is an
+> independent adapter and is not affiliated with or endorsed by Anthropic.
+
 ## Install
 
 ```sh
-npm install @rudra-js/anthropic @rudra-js/core zod
+npm install @rudra-js/anthropic @rudra-js/core zod@^4
 ```
 
 ```ts
@@ -18,8 +21,9 @@ const provider = createAnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY
 const generator = createComponentGenerator({ provider });
 ```
 
-`model` defaults to the current Claude model this package was written against;
-pass it to pin a different one. `maxTokens` and `baseUrl` are also optional.
+`model` defaults to `claude-opus-5`, the Claude model this package was written
+against; pass it to pin a different one. `maxTokens` and `baseUrl` are also
+optional.
 
 ### An identity-linked key needs a workspace
 
@@ -49,6 +53,31 @@ The tool schema sent to the model is derived from the `schema` on the
 copy written out here. A second copy would be a second vocabulary: the
 reconciler would enforce one thing and the model would be told another.
 
+## Data handling
+
+Each generation is one POST to `https://api.anthropic.com/v1/messages`. Set
+`baseUrl` and it goes to that host instead — a proxy, a gateway, or a
+region-specific endpoint you have.
+
+What is in that request is listed under **What the model sees** in the
+[`@rudra-js/core` README](https://github.com/clivedsouza1010/rudra-js/tree/main/packages/core#what-the-model-sees).
+Read it before you send real shopper traffic. In cohort mode, the default, the
+request carries no individual. In per-shopper mode it carries that shopper's
+likes, dislikes, purchases, basket, views and recent searches.
+
+If your shop is in the EU or the UK, you are the one sending personal data to
+Anthropic, and you need a data processing agreement with them plus a transfer
+mechanism for the data leaving your region. Your shop is Anthropic's customer;
+this package is a piece of code in the middle and is not a party to anything.
+
+When the API answers with an error, the thrown `Error` carries the status code
+and the vendor's error category — `anthropic responded 400
+(invalid_request_error)`. The vendor's own message is left out on purpose: it
+quotes the request back, and for this framework the request can hold a shopper's
+search terms, which an adopter's `console.error(error)` would then write to a
+log. A test in `anthropic-provider.test.ts` puts a search term in that message
+and asserts it does not reach the thrown error.
+
 ## Licence
 
 [MIT](./LICENSE)

package/dist/anthropic-provider.d.ts

@@ -18,8 +18,8 @@ export interface AnthropicProviderOptions {
  * Adapts the Anthropic Messages API to `ComponentProvider`.
  *
  * The tool schema is derived from the schema core exports rather than restated
- * here: a second copy is a second vocabulary, and the drift shows up as
- * unexplained `invalid-generation` events.
+ * here: a second copy is a second vocabulary, and the drift would throw below
+ * and reach the generator as `provider-error` events.
  */
 export declare function createAnthropicProvider(options: AnthropicProviderOptions): ComponentProvider;
 //# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/anthropic-provider.js

@@ -33,8 +33,8 @@ function isToolUseBlock(candidate) {
  * Adapts the Anthropic Messages API to `ComponentProvider`.
  *
  * The tool schema is derived from the schema core exports rather than restated
- * here: a second copy is a second vocabulary, and the drift shows up as
- * unexplained `invalid-generation` events.
+ * here: a second copy is a second vocabulary, and the drift would throw below
+ * and reach the generator as `provider-error` events.
  */
 export function createAnthropicProvider(options) {
     const model = options.model ?? 'claude-opus-5';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rudra-js/anthropic",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "An Anthropic adapter for @rudra-js/core, with no vendor SDK and no dependencies",
   "keywords": [
     "anthropic",
@@ -21,7 +21,7 @@
     "directory": "packages/anthropic"
   },
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.12.0"
   },
   "type": "module",
   "main": "./dist/index.js",
@@ -47,8 +47,8 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rudra-js/core": "^0.1.0",
-    "zod": "^4.5.4"
+    "@rudra-js/core": "^0.2.0",
+    "zod": "^4.5.0"
   },
   "devDependencies": {
     "@rudra-js/core": "0.1.0",

package/src/anthropic-provider.ts

@@ -66,8 +66,8 @@ function isToolUseBlock(candidate: unknown): candidate is ToolUseBlock {
  * Adapts the Anthropic Messages API to `ComponentProvider`.
  *
  * The tool schema is derived from the schema core exports rather than restated
- * here: a second copy is a second vocabulary, and the drift shows up as
- * unexplained `invalid-generation` events.
+ * here: a second copy is a second vocabulary, and the drift would throw below
+ * and reach the generator as `provider-error` events.
  */
 export function createAnthropicProvider(options: AnthropicProviderOptions): ComponentProvider {
   const model = options.model ?? 'claude-opus-5';