rhachet-brains-anthropic 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Uladzimir Kasacheuski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/contract/sdk/index.d.ts

@@ -0,0 +1,13 @@
+import type { BrainAtom, BrainRepl } from 'rhachet';
+/**
+ * .what = returns all brain atoms provided by anthropic
+ * .why = enables consumers to register anthropic atoms with genContextBrain
+ */
+export declare const getBrainAtomsByAnthropic: () => BrainAtom[];
+/**
+ * .what = returns all brain repls provided by anthropic
+ * .why = enables consumers to register anthropic repls with genContextBrain
+ */
+export declare const getBrainReplsByAnthropic: () => BrainRepl[];
+export { genBrainAtom } from '../../domain.operations/atoms/genBrainAtom';
+export { genBrainRepl } from '../../domain.operations/repls/genBrainRepl';

package/dist/contract/sdk/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainRepl = exports.genBrainAtom = exports.getBrainReplsByAnthropic = exports.getBrainAtomsByAnthropic = void 0;
+const genBrainAtom_1 = require("../../domain.operations/atoms/genBrainAtom");
+const genBrainRepl_1 = require("../../domain.operations/repls/genBrainRepl");
+/**
+ * .what = returns all brain atoms provided by anthropic
+ * .why = enables consumers to register anthropic atoms with genContextBrain
+ */
+const getBrainAtomsByAnthropic = () => {
+    return [
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'claude/haiku' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'claude/sonnet' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'claude/opus' }),
+    ];
+};
+exports.getBrainAtomsByAnthropic = getBrainAtomsByAnthropic;
+/**
+ * .what = returns all brain repls provided by anthropic
+ * .why = enables consumers to register anthropic repls with genContextBrain
+ */
+const getBrainReplsByAnthropic = () => {
+    return [
+        (0, genBrainRepl_1.genBrainRepl)({ slug: 'claude/code' }),
+        (0, genBrainRepl_1.genBrainRepl)({ slug: 'claude/code/haiku' }),
+        (0, genBrainRepl_1.genBrainRepl)({ slug: 'claude/code/sonnet' }),
+        (0, genBrainRepl_1.genBrainRepl)({ slug: 'claude/code/opus' }),
+    ];
+};
+exports.getBrainReplsByAnthropic = getBrainReplsByAnthropic;
+// re-export factories for direct access
+var genBrainAtom_2 = require("../../domain.operations/atoms/genBrainAtom");
+Object.defineProperty(exports, "genBrainAtom", { enumerable: true, get: function () { return genBrainAtom_2.genBrainAtom; } });
+var genBrainRepl_2 = require("../../domain.operations/repls/genBrainRepl");
+Object.defineProperty(exports, "genBrainRepl", { enumerable: true, get: function () { return genBrainRepl_2.genBrainRepl; } });
+//# sourceMappingURL=index.js.map

package/dist/contract/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";;;AAEA,6EAA0E;AAC1E,6EAA0E;AAE1E;;;GAGG;AACI,MAAM,wBAAwB,GAAG,GAAgB,EAAE;IACxD,OAAO;QACL,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QACtC,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QACvC,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,wBAAwB,4BAMnC;AAEF;;;GAGG;AACI,MAAM,wBAAwB,GAAG,GAAgB,EAAE;IACxD,OAAO;QACL,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACrC,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;QAC3C,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QAC5C,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC,CAAC;AAPW,QAAA,wBAAwB,4BAOnC;AAEF,wCAAwC;AACxC,2EAA0E;AAAjE,4GAAA,YAAY,OAAA;AACrB,2EAA0E;AAAjE,4GAAA,YAAY,OAAA"}

package/dist/domain.operations/atoms/genBrainAtom.d.ts

@@ -0,0 +1,19 @@
+import { BrainAtom } from 'rhachet';
+/**
+ * .what = supported claude atom slugs
+ * .why = enables type-safe slug specification with model variants
+ */
+type ClaudeAtomSlug = 'claude/haiku' | 'claude/haiku/v3.5' | 'claude/haiku/v4.5' | 'claude/sonnet' | 'claude/sonnet/v4' | 'claude/sonnet/v4.5' | 'claude/opus' | 'claude/opus/v4' | 'claude/opus/v4.5';
+/**
+ * .what = factory to generate claude brain atom instances
+ * .why = enables model variant selection via slug (e.g., haiku for speed, opus for quality)
+ *
+ * .example
+ *   genBrainAtom({ slug: 'claude/haiku' }) // fast + cheap
+ *   genBrainAtom({ slug: 'claude/sonnet' }) // balanced
+ *   genBrainAtom({ slug: 'claude/opus/v4.5' }) // highest quality
+ */
+export declare const genBrainAtom: (input: {
+    slug: ClaudeAtomSlug;
+}) => BrainAtom;
+export {};

package/dist/domain.operations/atoms/genBrainAtom.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainAtom = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const zod_1 = require("@anthropic-ai/sdk/helpers/beta/zod");
+const rhachet_1 = require("rhachet");
+/**
+ * .what = model configuration by slug
+ * .why = maps slugs to API model names and descriptions
+ */
+const CONFIG_BY_SLUG = {
+    'claude/haiku': {
+        model: 'claude-haiku-4-5-20251001',
+        description: 'claude haiku 4.5 - fastest and most cost-effective',
+    },
+    'claude/haiku/v3.5': {
+        model: 'claude-3-5-haiku-20241022',
+        description: 'claude haiku 3.5 - fast and cost-effective',
+    },
+    'claude/haiku/v4.5': {
+        model: 'claude-haiku-4-5-20251001',
+        description: 'claude haiku 4.5 - fastest and most cost-effective',
+    },
+    'claude/sonnet': {
+        model: 'claude-sonnet-4-5-20250929',
+        description: 'claude sonnet 4.5 - balanced performance and capability',
+    },
+    'claude/sonnet/v4': {
+        model: 'claude-sonnet-4-20250514',
+        description: 'claude sonnet 4 - balanced performance and capability',
+    },
+    'claude/sonnet/v4.5': {
+        model: 'claude-sonnet-4-5-20250929',
+        description: 'claude sonnet 4.5 - balanced performance and capability',
+    },
+    'claude/opus': {
+        model: 'claude-opus-4-5-20251101',
+        description: 'claude opus 4.5 - most capable for complex reasoning',
+    },
+    'claude/opus/v4': {
+        model: 'claude-opus-4-20250514',
+        description: 'claude opus 4 - highly capable for complex reasoning',
+    },
+    'claude/opus/v4.5': {
+        model: 'claude-opus-4-5-20251101',
+        description: 'claude opus 4.5 - most capable for complex reasoning',
+    },
+};
+/**
+ * .what = factory to generate claude brain atom instances
+ * .why = enables model variant selection via slug (e.g., haiku for speed, opus for quality)
+ *
+ * .example
+ *   genBrainAtom({ slug: 'claude/haiku' }) // fast + cheap
+ *   genBrainAtom({ slug: 'claude/sonnet' }) // balanced
+ *   genBrainAtom({ slug: 'claude/opus/v4.5' }) // highest quality
+ */
+const genBrainAtom = (input) => {
+    const config = CONFIG_BY_SLUG[input.slug];
+    return new rhachet_1.BrainAtom({
+        repo: 'anthropic',
+        slug: input.slug,
+        description: config.description,
+        /**
+         * .what = stateless inference (no tool use)
+         * .why = provides direct model access for reasoning tasks
+         */
+        ask: async (askInput, context) => {
+            // compose system prompt from briefs
+            const systemPrompt = askInput.role.briefs
+                ? await (0, rhachet_1.castBriefsToPrompt)({ briefs: askInput.role.briefs })
+                : undefined;
+            // get anthropic client from context or create new one
+            const anthropic = context?.anthropic ??
+                new sdk_1.default({ apiKey: process.env.ANTHROPIC_API_KEY });
+            // call anthropic api with native structured output (constrained decoding)
+            const response = await anthropic.beta.messages.create({
+                model: config.model,
+                max_tokens: 16384,
+                betas: ['structured-outputs-2025-11-13'],
+                system: systemPrompt,
+                messages: [{ role: 'user', content: askInput.prompt }],
+                output_format: (0, zod_1.betaZodOutputFormat)(askInput.schema.output),
+            });
+            // extract structured output from response text
+            const textBlock = response.content.find((block) => block.type === 'text');
+            const output = textBlock?.text ? JSON.parse(textBlock.text) : {};
+            // validate via schema
+            return askInput.schema.output.parse(output);
+        },
+    });
+};
+exports.genBrainAtom = genBrainAtom;
+//# sourceMappingURL=genBrainAtom.js.map

package/dist/domain.operations/atoms/genBrainAtom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genBrainAtom.js","sourceRoot":"","sources":["../../../src/domain.operations/atoms/genBrainAtom.ts"],"names":[],"mappings":"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"}

package/dist/domain.operations/repls/genBrainRepl.d.ts

@@ -0,0 +1,19 @@
+import { BrainRepl } from 'rhachet';
+/**
+ * .what = supported claude code repl slugs
+ * .why = enables type-safe slug specification with model variants
+ */
+type ClaudeCodeSlug = 'claude/code' | 'claude/code/haiku' | 'claude/code/haiku/v4.5' | 'claude/code/sonnet' | 'claude/code/sonnet/v4' | 'claude/code/sonnet/v4.5' | 'claude/code/opus' | 'claude/code/opus/v4.5';
+/**
+ * .what = factory to generate claude code brain repl instances
+ * .why = enables model variant selection via slug (e.g., haiku for speed, opus for quality)
+ *
+ * .example
+ *   genBrainRepl({ slug: 'claude/code' }) // default model
+ *   genBrainRepl({ slug: 'claude/code/haiku' }) // fast + cheap
+ *   genBrainRepl({ slug: 'claude/code/opus/v4.5' }) // highest quality
+ */
+export declare const genBrainRepl: (input: {
+    slug: ClaudeCodeSlug;
+}) => BrainRepl;
+export {};

package/dist/domain.operations/repls/genBrainRepl.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainRepl = void 0;
+const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
+const rhachet_1 = require("rhachet");
+const asJsonSchema_1 = require("../../infra/schema/asJsonSchema");
+/**
+ * .what = maps slug to anthropic model identifier
+ * .why = translates friendly slugs to API model names
+ */
+const MODEL_BY_SLUG = {
+    'claude/code': undefined, // use SDK default
+    'claude/code/haiku': 'claude-haiku-4-5-20251001',
+    'claude/code/haiku/v4.5': 'claude-haiku-4-5-20251001',
+    'claude/code/sonnet': 'claude-sonnet-4-5-20250929',
+    'claude/code/sonnet/v4': 'claude-sonnet-4-20250514',
+    'claude/code/sonnet/v4.5': 'claude-sonnet-4-5-20250929',
+    'claude/code/opus': 'claude-opus-4-20250514',
+    'claude/code/opus/v4.5': 'claude-opus-4-5-20251101',
+};
+/**
+ * .what = tools disallowed for readonly ask operations
+ * .why = prevents mutations during research/analysis tasks
+ */
+const TOOLS_DISALLOWED_FOR_ASK = [
+    'Edit',
+    'Write',
+    'Bash',
+    'NotebookEdit',
+];
+/**
+ * .what = tools allowed for read+write act operations
+ * .why = enables full agentic capabilities for code changes
+ */
+const TOOLS_ALLOWED_FOR_ACT = [
+    'Read',
+    'Edit',
+    'Write',
+    'Bash',
+    'Glob',
+    'Grep',
+    'Task',
+];
+/**
+ * .what = extracts final result from claude-agent-sdk query async generator
+ * .why = query() returns an async iterator, need to consume to get result
+ *
+ * .note = when outputFormat is used, result may be in structured_output field
+ */
+const extractResultFromQuery = async (queryIterator) => {
+    let result;
+    let structuredOutput;
+    for await (const message of queryIterator) {
+        // check for result message with success subtype
+        if (message.type === 'result' && message.subtype === 'success') {
+            result = message.result;
+            structuredOutput = message.structured_output;
+        }
+        // throw on error subtypes
+        if (message.type === 'result' && message.subtype !== 'success') {
+            throw new Error(`claude-agent-sdk query failed: ${message.subtype}, errors: ${message.errors?.join(', ') ?? 'unknown'}`);
+        }
+    }
+    // prefer structured_output when available (used with outputFormat)
+    if (structuredOutput !== undefined)
+        return structuredOutput;
+    // fall back to parsing result as JSON
+    if (result !== undefined)
+        return JSON.parse(result);
+    throw new Error('no result message received from claude-agent-sdk');
+};
+/**
+ * .what = invokes claude-agent-sdk query with specified mode
+ * .why = dedupes shared logic between ask (readonly) and act (read+write)
+ */
+const invokeQuery = async (input) => {
+    // compose system prompt from briefs
+    const systemPrompt = input.role.briefs
+        ? await (0, rhachet_1.castBriefsToPrompt)({ briefs: input.role.briefs })
+        : undefined;
+    // convert zod schema to json schema for native structured output
+    const jsonSchema = (0, asJsonSchema_1.asJsonSchema)({ schema: input.schema.output });
+    // build tool constraints based on mode
+    const toolConstraints = input.mode === 'ask'
+        ? { disallowedTools: [...TOOLS_DISALLOWED_FOR_ASK] }
+        : { allowedTools: [...TOOLS_ALLOWED_FOR_ACT] };
+    // invoke claude-agent-sdk query
+    const queryIterator = (0, claude_agent_sdk_1.query)({
+        prompt: input.prompt,
+        options: {
+            systemPrompt,
+            model: input.model,
+            ...toolConstraints,
+            outputFormat: {
+                type: 'json_schema',
+                schema: jsonSchema,
+            },
+        },
+    });
+    // extract final result from async iterator
+    const result = await extractResultFromQuery(queryIterator);
+    // parse output via schema for runtime validation
+    return input.schema.output.parse(result);
+};
+/**
+ * .what = factory to generate claude code brain repl instances
+ * .why = enables model variant selection via slug (e.g., haiku for speed, opus for quality)
+ *
+ * .example
+ *   genBrainRepl({ slug: 'claude/code' }) // default model
+ *   genBrainRepl({ slug: 'claude/code/haiku' }) // fast + cheap
+ *   genBrainRepl({ slug: 'claude/code/opus/v4.5' }) // highest quality
+ */
+const genBrainRepl = (input) => {
+    const model = MODEL_BY_SLUG[input.slug];
+    return new rhachet_1.BrainRepl({
+        repo: 'anthropic',
+        slug: input.slug,
+        description: `claude code (${input.slug}) - agentic coding assistant with tool use`,
+        /**
+         * .what = readonly analysis (research, queries, code review)
+         * .why = provides safe, non-mutating agent interactions
+         */
+        ask: async (askInput, _context) => invokeQuery({ mode: 'ask', model, ...askInput }),
+        /**
+         * .what = read+write actions (code changes, file edits)
+         * .why = provides full agentic capabilities with write access
+         */
+        act: async (actInput, _context) => invokeQuery({ mode: 'act', model, ...actInput }),
+    });
+};
+exports.genBrainRepl = genBrainRepl;
+//# sourceMappingURL=genBrainRepl.js.map

package/dist/domain.operations/repls/genBrainRepl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genBrainRepl.js","sourceRoot":"","sources":["../../../src/domain.operations/repls/genBrainRepl.ts"],"names":[],"mappings":"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"}

package/dist/infra/schema/asJsonSchema.d.ts

@@ -0,0 +1,8 @@
+import type { z } from 'zod';
+/**
+ * .what = converts zod schema to JSON schema for claude-agent-sdk
+ * .why = claude-agent-sdk doesn't expect $schema property; strip it for compatibility
+ */
+export declare const asJsonSchema: (input: {
+    schema: z.ZodSchema;
+}) => Record<string, unknown>;

package/dist/infra/schema/asJsonSchema.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asJsonSchema = void 0;
+/**
+ * .what = converts zod schema to JSON schema for claude-agent-sdk
+ * .why = claude-agent-sdk doesn't expect $schema property; strip it for compatibility
+ */
+const asJsonSchema = (input) => {
+    // convert zod schema to json schema
+    const { z } = require('zod');
+    const jsonSchemaRaw = z.toJSONSchema(input.schema);
+    // remove $schema property as claude-agent-sdk doesn't expect it
+    const { $schema: _, ...jsonSchema } = jsonSchemaRaw;
+    return jsonSchema;
+};
+exports.asJsonSchema = asJsonSchema;
+//# sourceMappingURL=asJsonSchema.js.map

package/dist/infra/schema/asJsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asJsonSchema.js","sourceRoot":"","sources":["../../../src/infra/schema/asJsonSchema.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,YAAY,GAAG,CAAC,KAE5B,EAA2B,EAAE;IAC5B,oCAAoC;IACpC,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnD,gEAAgE;IAChE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,aAGrC,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAdW,QAAA,YAAY,gBAcvB"}

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 ehmpathy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "rhachet-brains-anthropic",
+  "author": "ehmpathy",
+  "description": "rhachet brain.atom and brain.repl adapter for openai",
+  "version": "0.0.0",
+  "repository": "ehmpathy/rhachet-brains-anthropic",
+  "homepage": "https://github.com/ehmpathy/rhachet-brains-anthropic",
+  "keywords": [
+    "rhachet",
+    "brain",
+    "anthropic",
+    "claude",
+    "claude-code",
+    "ai"
+  ],
+  "bugs": "https://github.com/ehmpathy/rhachet-brains-anthropic/issues",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=8.0.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.1.76",
+    "@anthropic-ai/sdk": "0.71.2",
+    "domain-objects": "0.31.9",
+    "helpful-errors": "1.5.3",
+    "openai": "5.8.2",
+    "rhachet-artifact": "1.0.1",
+    "rhachet-artifact-git": "1.1.5",
+    "type-fns": "1.21.0",
+    "wrapper-fns": "1.1.7",
+    "zod": "4.3.4"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.8",
+    "@commitlint/cli": "19.5.0",
+    "@commitlint/config-conventional": "19.5.0",
+    "@swc/core": "1.15.3",
+    "@swc/jest": "0.2.39",
+    "@tsconfig/node20": "20.1.5",
+    "@tsconfig/strictest": "2.0.5",
+    "@types/jest": "30.0.0",
+    "@types/node": "22.15.21",
+    "cz-conventional-changelog": "3.3.0",
+    "declapract": "0.13.14",
+    "declapract-typescript-ehmpathy": "0.47.16",
+    "declastruct": "1.7.3",
+    "declastruct-github": "1.3.0",
+    "depcheck": "1.4.3",
+    "esbuild-register": "3.6.0",
+    "husky": "8.0.3",
+    "jest": "30.2.0",
+    "rhachet": "1.21.4",
+    "rhachet-roles-bhrain": "0.5.9",
+    "rhachet-roles-bhuild": "0.6.3",
+    "rhachet-roles-ehmpathy": "1.17.15",
+    "test-fns": "1.5.0",
+    "tsc-alias": "1.8.10",
+    "tsx": "4.20.6",
+    "typescript": "5.4.5",
+    "yalc": "1.0.0-pre.53"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "scripts": {
+    "build:ts": "tsc -p ./tsconfig.build.json",
+    "commit:with-cli": "npx cz",
+    "fix:format:biome": "biome check --write",
+    "fix:format": "npm run fix:format:biome",
+    "fix:lint": "biome check --write",
+    "fix": "npm run fix:format && npm run fix:lint",
+    "build:clean:bun": "rm -f ./bin/*.bc",
+    "build:clean:tsc": "(chmod -R u+w dist 2>/dev/null || true) && rm -rf dist/",
+    "build:clean": "npm run build:clean:tsc && npm run build:clean:bun",
+    "build:compile:tsc": "tsc -p ./tsconfig.build.json && tsc-alias -p ./tsconfig.build.json",
+    "build:compile": "npm run build:compile:tsc && npm run build:compile:bun --if-present",
+    "build": "npm run build:clean && npm run build:compile && npm run build:complete --if-present",
+    "test:commits": "LAST_TAG=$(git describe --tags --abbrev=0 @^ 2> /dev/null || git rev-list --max-parents=0 HEAD) && npx commitlint --from $LAST_TAG --to HEAD --verbose",
+    "test:types": "tsc -p ./tsconfig.json --noEmit",
+    "test:format:biome": "biome format",
+    "test:format": "npm run test:format:biome",
+    "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
+    "test:lint:biome": "biome check --diagnostic-level=error",
+    "test:lint:biome:all": "biome check",
+    "test:lint": "npm run test:lint:biome && npm run test:lint:deps",
+    "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:integration": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:acceptance:locally": "npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test": "npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
+    "test:acceptance": "npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "prepush": "npm run test && npm run build",
+    "prepublish": "npm run build",
+    "preversion": "npm run prepush",
+    "postversion": "git push origin HEAD --tags --no-verify",
+    "prepare:husky": "husky install && chmod ug+x .husky/*",
+    "prepare:rhachet": "rhachet init --mode upsert && rhachet roles link --repo ehmpathy --role mechanic && rhachet roles link --repo bhuild --role behaver && rhachet roles link --repo bhrain --role reviewer && rhachet roles init --role mechanic && rhachet roles init --role behaver"
+  }
+}

package/readme.md

@@ -0,0 +1,88 @@
+# rhachet-brains-anthropic
+
+rhachet brain.atom and brain.repl adapter for anthropic
+
+## install
+
+```sh
+npm install rhachet-brains-anthropic
+```
+
+## usage
+
+```ts
+import { genBrainAtom, genBrainRepl } from 'rhachet-brains-anthropic';
+import { z } from 'zod';
+
+// create a brain atom for direct model inference
+const brainAtom = genBrainAtom({ slug: 'claude/sonnet' });
+
+// simple string output
+const response = await brainAtom.ask({
+  role: { briefs: [] },
+  prompt: 'explain this code',
+  schema: { output: z.string() },
+});
+
+// structured object output
+const result = await brainAtom.ask({
+  role: { briefs: [] },
+  prompt: 'analyze this code',
+  schema: { output: z.object({ summary: z.string(), issues: z.array(z.string()) }) },
+});
+
+// create a brain repl for agentic tasks
+const brainRepl = genBrainRepl({ slug: 'claude/code' });
+
+// use ask() for read-only operations
+const analysis = await brainRepl.ask({
+  role: { briefs: [] },
+  prompt: 'analyze this codebase',
+  schema: { output: z.object({ content: z.string() }) },
+});
+
+// use act() for read+write operations
+const refactor = await brainRepl.act({
+  role: { briefs: [] },
+  prompt: 'refactor this module',
+  schema: { output: z.object({ content: z.string() }) },
+});
+```
+
+## available brains
+
+### atoms (via genBrainAtom)
+
+stateless inference without tool use. uses anthropic api with structured outputs.
+
+| slug                 | model                      | description                         |
+| -------------------- | -------------------------- | ----------------------------------- |
+| `claude/haiku`       | claude-haiku-4-5-20251001  | fastest and most cost-effective     |
+| `claude/haiku/v3.5`  | claude-3-5-haiku-20241022  | fast and cost-effective             |
+| `claude/haiku/v4.5`  | claude-haiku-4-5-20251001  | fastest and most cost-effective     |
+| `claude/sonnet`      | claude-sonnet-4-5-20250929 | balanced performance and capability |
+| `claude/sonnet/v4`   | claude-sonnet-4-20250514   | balanced performance and capability |
+| `claude/sonnet/v4.5` | claude-sonnet-4-5-20250929 | balanced performance and capability |
+| `claude/opus`        | claude-opus-4-5-20251101   | most capable for complex tasks      |
+| `claude/opus/v4`     | claude-opus-4-20250514     | highly capable for complex tasks    |
+| `claude/opus/v4.5`   | claude-opus-4-5-20251101   | most capable for complex tasks      |
+
+### repls (via genBrainRepl)
+
+agentic code assistant with tool use via claude-agent-sdk.
+
+| slug                      | model                      | description                         |
+| ------------------------- | -------------------------- | ----------------------------------- |
+| `claude/code`             | sdk default                | uses claude-agent-sdk default model |
+| `claude/code/haiku`       | claude-haiku-4-5-20251001  | fast and cost-effective agent       |
+| `claude/code/haiku/v4.5`  | claude-haiku-4-5-20251001  | fast and cost-effective agent       |
+| `claude/code/sonnet`      | claude-sonnet-4-5-20250929 | balanced agentic capability         |
+| `claude/code/sonnet/v4`   | claude-sonnet-4-20250514   | balanced agentic capability         |
+| `claude/code/sonnet/v4.5` | claude-sonnet-4-5-20250929 | balanced agentic capability         |
+| `claude/code/opus`        | claude-opus-4-20250514     | high capability agent               |
+| `claude/code/opus/v4.5`   | claude-opus-4-5-20251101   | most capable agent                  |
+
+## sources
+
+- [anthropic api documentation](https://docs.anthropic.com/en/api/)
+- [claude-agent-sdk documentation](https://docs.anthropic.com/en/docs/claude-agent-sdk)