@kybernesis/brain-llm-claude 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @kybernesis/brain-llm-claude
+ *
+ * Subprocess-based LLM provider wrapping the `claude` CLI.
+ *
+ * Port of cortex-appydave cortex-provider-llm-claude-code, adapted to
+ * the brain-core LLMProvider interface (ADR-0009).
+ *
+ * Usage:
+ *   import { createSubprocessProvider } from '@kybernesis/brain-llm-claude';
+ *   import { setLLMProvider } from '@kybernesis/brain-core';
+ *   setLLMProvider(createSubprocessProvider());
+ */
+export interface ClaudeCallOpts {
+    model?: string;
+    maxTokens?: number;
+    system?: string;
+    [key: string]: unknown;
+}
+export interface LLMProvider {
+    call(prompt: string, opts?: ClaudeCallOpts): Promise<string | null>;
+}
+export interface SubprocessProviderOptions {
+    /** Claude CLI binary name or path. Defaults to 'claude'. */
+    binary?: string;
+    /** Working directory for the spawned subprocess. */
+    cwd?: string;
+}
+/**
+ * Create a subprocess-backed LLMProvider.
+ *
+ * Spawns `claude --print - --dangerously-skip-permissions --model <id>`
+ * and pipes the prompt via stdin. Returns trimmed stdout on exit 0,
+ * null on any failure (spawn error, non-zero exit, empty output).
+ */
+export declare function createSubprocessProvider(opts?: SubprocessProviderOptions): LLMProvider;
+/** Returns true when the claude binary is reachable on PATH. */
+export declare function isClaudeAvailable(binary?: string): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAmBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,yBAA8B,GAAG,WAAW,CAsC1F;AAED,gEAAgE;AAChE,wBAAsB,iBAAiB,CAAC,MAAM,SAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3E"}

package/dist/index.js

@@ -0,0 +1,83 @@
+/**
+ * @kybernesis/brain-llm-claude
+ *
+ * Subprocess-based LLM provider wrapping the `claude` CLI.
+ *
+ * Port of cortex-appydave cortex-provider-llm-claude-code, adapted to
+ * the brain-core LLMProvider interface (ADR-0009).
+ *
+ * Usage:
+ *   import { createSubprocessProvider } from '@kybernesis/brain-llm-claude';
+ *   import { setLLMProvider } from '@kybernesis/brain-core';
+ *   setLLMProvider(createSubprocessProvider());
+ */
+import { spawn } from 'node:child_process';
+const MODEL_ALIASES = {
+    haiku: 'claude-haiku-4-5-20251001',
+    haiku4: 'claude-haiku-4-5-20251001',
+    'haiku-4': 'claude-haiku-4-5-20251001',
+    sonnet: 'claude-sonnet-4-6',
+    sonnet4: 'claude-sonnet-4-6',
+    'sonnet-4-6': 'claude-sonnet-4-6',
+    opus: 'claude-opus-4-7',
+    opus4: 'claude-opus-4-7',
+    'opus-4-7': 'claude-opus-4-7',
+};
+function resolveModel(raw) {
+    if (!raw)
+        return 'claude-haiku-4-5-20251001';
+    return MODEL_ALIASES[raw.toLowerCase()] ?? raw;
+}
+/**
+ * Create a subprocess-backed LLMProvider.
+ *
+ * Spawns `claude --print - --dangerously-skip-permissions --model <id>`
+ * and pipes the prompt via stdin. Returns trimmed stdout on exit 0,
+ * null on any failure (spawn error, non-zero exit, empty output).
+ */
+export function createSubprocessProvider(opts = {}) {
+    const binary = opts.binary ?? 'claude';
+    const cwd = opts.cwd;
+    return {
+        call(prompt, callOpts = {}) {
+            return new Promise((resolve) => {
+                const model = resolveModel(callOpts.model);
+                const args = ['--print', '-', '--dangerously-skip-permissions', '--model', model];
+                if (callOpts.system) {
+                    args.push('--system-prompt', String(callOpts.system));
+                }
+                const proc = spawn(binary, args, {
+                    env: { ...process.env, CLAUDECODE: '', CLAUDE_CODE_ENTRYPOINT: '' },
+                    cwd,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                const out = [];
+                const err = [];
+                if (proc.stdin) {
+                    proc.stdin.write(prompt);
+                    proc.stdin.end();
+                }
+                if (proc.stdout)
+                    proc.stdout.on('data', (c) => out.push(c));
+                if (proc.stderr)
+                    proc.stderr.on('data', (c) => err.push(c));
+                proc.on('error', () => { out.length = 0; err.length = 0; resolve(null); });
+                proc.on('close', (code) => {
+                    const text = Buffer.concat(out).toString().trim();
+                    out.length = 0;
+                    err.length = 0;
+                    resolve(code === 0 && text ? text : null);
+                });
+            });
+        },
+    };
+}
+/** Returns true when the claude binary is reachable on PATH. */
+export async function isClaudeAvailable(binary = 'claude') {
+    return new Promise((resolve) => {
+        const proc = spawn(binary, ['--version'], { stdio: 'ignore' });
+        proc.on('error', () => resolve(false));
+        proc.on('close', (code) => resolve(code === 0));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kybernesis/brain-llm-claude",
+  "version": "0.1.0",
+  "description": "Claude subprocess LLM provider for brain-core",
+  "license": "MIT",
+  "author": "David Cruwys (AppyDave)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KybernesisAI/cortex.git",
+    "directory": "packages/brain-llm-claude"
+  },
+  "homepage": "https://github.com/KybernesisAI/cortex/tree/main/packages/brain-llm-claude#readme",
+  "bugs": {
+    "url": "https://github.com/KybernesisAI/cortex/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@kybernesis/brain-contracts": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "typecheck": "tsc -b"
+  }
+}