@rcrsr/rill-ext-claude-code 0.8.5 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 # @rcrsr/rill-ext-claude-code
 
-[rill](https://rill.run) extension for executing [Claude Code](https://docs.anthropic.com/en/docs/claude-code) operations from rill scripts. Provides `prompt`, `skill`, and `command` host functions with streaming output parsing, token tracking, and process lifecycle management.
+[rill](https://rill.run) extension for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI integration. Provides `prompt`, `skill`, and `command` host functions with streaming output parsing, token tracking, and process lifecycle management.
 
 > **Experimental.** Breaking changes will occur before stabilization.
 
@@ -33,113 +33,15 @@ const result = await execute(parse(script), ctx);
 dispose?.();
 ```
 
-## Host Functions
-
-All functions return a dict with `result`, `tokens`, `cost`, `exitCode`, and `duration`.
-
-### claude_code::prompt(text, options?)
-
-Execute a Claude Code prompt.
-
-```rill
-claude_code::prompt("Analyze this code for security issues") => $response
-$response.result -> log
-$response.tokens.output -> log
-```
-
-### claude_code::skill(name, args?)
-
-Execute a Claude Code skill (slash command).
-
-```rill
-claude_code::skill("commit", [message: "fix: resolve login bug"])
-```
-
-### claude_code::command(name, args?)
-
-Execute a Claude Code command.
-
-```rill
-claude_code::command("review-pr", [pr: "123"]) => $review
-$review.result -> log
-```
-
-## Configuration
-
-```typescript
-const ext = createClaudeCodeExtension({
-  binaryPath: '/usr/local/bin/claude',     // default: 'claude'
-  defaultTimeout: 60000,                   // default: 1800000 (30 min)
-  dangerouslySkipPermissions: true,        // default: true
-  settingSources: '',                      // default: '' (no plugins)
-});
-```
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `binaryPath` | string | `'claude'` | Path to Claude Code CLI binary |
-| `defaultTimeout` | number | `1800000` | Default timeout in ms (max: 3600000) |
-| `dangerouslySkipPermissions` | boolean | `true` | Bypass permission checks |
-| `settingSources` | string | `''` | Setting sources to load (see below) |
-
-### settingSources
-
-Controls which Claude Code settings load at startup. Maps to `--setting-sources`.
-
-| Value | Effect |
-|-------|--------|
-| `''` (default) | No settings loaded. Disables plugins, MCP servers, slash commands. |
-| `'user'` | Load user settings (~/.claude/settings.json) including plugins. |
-| `'project'` | Load project settings (.claude/settings.json). |
-| `'user,project'` | Load both user and project settings. |
-
-The factory validates the binary path and timeout eagerly. It throws if the binary is not found in `$PATH` or the timeout is out of range.
-
-## Result Shape
-
-```typescript
-interface ClaudeCodeResult {
-  result: string;      // combined text from assistant messages
-  tokens: TokenCounts; // prompt, cacheWrite5m, cacheWrite1h, cacheRead, output
-  cost: number;        // total cost in USD
-  exitCode: number;    // CLI process exit code (0 = success)
-  duration: number;    // execution duration in ms
-}
-```
-
-## Lifecycle
-
-Call `dispose()` on the extension to clean up active processes:
-
-```typescript
-const ext = createClaudeCodeExtension();
-// ... use extension ...
-await ext.dispose?.();
-```
-
-## Test Host
-
-A runnable example at `examples/test-host.ts` wires up the extension with the rill runtime:
-
-```bash
-# Built-in demo
-pnpm exec tsx examples/test-host.ts
-
-# Inline expression
-pnpm exec tsx examples/test-host.ts -e 'claude_code::prompt("Tell me a joke") -> log'
-
-# Script file
-pnpm exec tsx examples/test-host.ts script.rill
-```
+## Documentation
 
-Requires `node-pty` native module built for your platform and `claude` in `$PATH`.
+See [full documentation](docs/extension-claude-code.md) for configuration, functions, error handling, events, and examples.
 
-## Documentation
+## Related
 
-| Document | Description |
-|----------|-------------|
-| [Extensions Guide](https://github.com/rcrsr/rill/blob/main/docs/integration-extensions.md) | Extension contract and patterns |
-| [Host API Reference](https://github.com/rcrsr/rill/blob/main/docs/ref-host-api.md) | Runtime context and host functions |
+- [rill](https://github.com/rcrsr/rill) — Core language runtime
+- [Extensions Guide](https://github.com/rcrsr/rill/blob/main/docs/integration-extensions.md) — Extension contract and patterns
+- [Host API Reference](https://github.com/rcrsr/rill/blob/main/docs/ref-host-api.md) — Runtime context and host functions
 
 ## License
 

package/dist/index.d.ts

@@ -11,4 +11,6 @@ export { extractResult } from './result.js';
 export type { SpawnResult, SpawnOptions } from './process.js';
 export { spawnClaudeCli } from './process.js';
 export { createClaudeCodeExtension } from './factory.js';
+import type { ExtensionConfigSchema } from '@rcrsr/rill';
+export declare const configSchema: ExtensionConfigSchema;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B,YAAY,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B,YAAY,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAMzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,YAAY,EAAE,qBAK1B,CAAC"}

package/dist/index.js

@@ -17,4 +17,10 @@ export { spawnClaudeCli } from './process.js';
 // EXTENSION FACTORY
 // ============================================================
 export { createClaudeCodeExtension } from './factory.js';
+export const configSchema = {
+    binaryPath: { type: 'string' },
+    defaultTimeout: { type: 'number' },
+    dangerouslySkipPermissions: { type: 'boolean' },
+    settingSources: { type: 'string' },
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AA4B/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AA4B/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAQzD,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClC,0BAA0B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/C,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;CACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcrsr/rill-ext-claude-code",
-  "version": "0.8.5",
+  "version": "0.9.0",
   "description": "rill extension for Claude Code CLI integration",
   "license": "MIT",
   "author": "Andre Bremer",
@@ -17,30 +17,30 @@
     "scripting"
   ],
   "peerDependencies": {
-    "node-pty": "^1.0.0",
-    "@rcrsr/rill": "^0.8.5"
+    "@rcrsr/rill": "^0.9.0",
+    "node-pty": "^1.0.0"
   },
   "devDependencies": {
-    "@types/which": "^3.0.4",
-    "@rcrsr/rill": "^0.8.5"
+    "@rcrsr/rill": "^0.9.0",
+    "@types/which": "^3.0.4"
   },
   "files": [
     "dist"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rcrsr/rill.git",
+    "url": "git+https://github.com/rcrsr/rill-ext.git",
     "directory": "packages/ext/claude-code"
   },
-  "homepage": "https://rill.run/docs/extensions/claude-code/",
+  "homepage": "https://github.com/rcrsr/rill-ext/tree/main/packages/ext/claude-code#readme",
   "bugs": {
-    "url": "https://github.com/rcrsr/rill/issues"
+    "url": "https://github.com/rcrsr/rill-ext/issues"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "which": "^6.0.0"
+    "which": "^6.0.1"
   },
   "scripts": {
     "build": "tsc --build",