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

package/dist/index.d.ts

@@ -1,16 +1,261 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { ExtensionConfigSchema, ExtensionResult } from '@rcrsr/rill';
+import * as pty from 'node-pty';
+
+/**
+ * Type definitions for Claude Code extension.
+ * Defines message types, token tracking, and result structures.
+ */
+/**
+ * Token count breakdown from Claude Code CLI.
+ * Tracks prompt tokens, cache operations, and output tokens.
+ */
+export interface TokenCounts {
+	/** Non-cached prompt tokens */
+	readonly prompt: number;
+	/** Tokens written to 5-minute cache */
+	readonly cacheWrite5m: number;
+	/** Tokens written to 1-hour cache */
+	readonly cacheWrite1h: number;
+	/** Tokens read from cache */
+	readonly cacheRead: number;
+	/** Output tokens generated */
+	readonly output: number;
+}
+/**
+ * Token usage data from Claude API response.
+ * Maps to TokenCounts fields via extraction logic.
+ */
+export interface TokenUsage {
+	/** Non-cached input tokens */
+	readonly input_tokens?: number | undefined;
+	/** Generated output tokens */
+	readonly output_tokens?: number | undefined;
+	/** Cache read tokens */
+	readonly cache_read_input_tokens?: number | undefined;
+	/** Structured cache creation tracking */
+	readonly cache_creation?: {
+		/** 5-minute cache write tokens */
+		readonly ephemeral_5m_input_tokens?: number | undefined;
+		/** 1-hour cache write tokens */
+		readonly ephemeral_1h_input_tokens?: number | undefined;
+	} | undefined;
+}
+/**
+ * Text content block.
+ */
+export interface TextBlock {
+	readonly type: "text";
+	readonly text: string;
+}
+/**
+ * Tool use request block.
+ */
+export interface ToolUseBlock {
+	readonly type: "tool_use";
+	readonly id: string;
+	readonly name: string;
+	readonly input: Record<string, unknown>;
+}
+/**
+ * Tool result response block.
+ */
+export interface ToolResultBlock {
+	readonly type: "tool_result";
+	readonly tool_use_id: string;
+	readonly content: string | unknown;
+	readonly is_error?: boolean | undefined;
+}
+/**
+ * Content block variants for message content arrays.
+ */
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock;
+/**
+ * System initialization message.
+ * First message in stream, establishes session config.
+ */
+export interface SystemMessage {
+	readonly type: "system";
+	readonly subtype: "init";
+	readonly model: string;
+	readonly tools?: readonly unknown[] | undefined;
+	readonly mcp_servers?: readonly unknown[] | undefined;
+}
+/**
+ * Assistant response message.
+ * Contains text and tool use blocks.
+ */
+export interface AssistantMessage {
+	readonly type: "assistant";
+	readonly message: {
+		readonly content: readonly ContentBlock[];
+		readonly usage?: TokenUsage | undefined;
+	};
+}
+/**
+ * User message with tool results.
+ * Contains tool result blocks.
+ */
+export interface UserMessage {
+	readonly type: "user";
+	readonly message: {
+		readonly content: readonly ContentBlock[];
+	};
+}
+/**
+ * Result message with cost and duration.
+ * Final message in stream with aggregated metrics.
+ */
+export interface ResultMessage {
+	readonly type: "result";
+	readonly cost_usd: number;
+	readonly duration_ms: number;
+	readonly is_error: boolean;
+	readonly usage: TokenUsage;
+}
+/**
+ * Discriminated union of all Claude Code message types.
+ * Discriminant field: `type`
+ */
+export type ClaudeMessage = SystemMessage | AssistantMessage | UserMessage | ResultMessage;
+/**
+ * Configuration options for Claude Code integration.
+ */
+export interface ClaudeCodeConfig {
+	/** Path to Claude Code CLI binary (default: 'claude') */
+	readonly binaryPath?: string | undefined;
+	/** Default timeout in milliseconds (default: 1800000) */
+	readonly defaultTimeout?: number | undefined;
+	/** Skip permission checks (default: true) */
+	readonly dangerouslySkipPermissions?: boolean | undefined;
+	/** Setting sources to load: 'user', 'project', 'local' (default: '') */
+	readonly settingSources?: string | undefined;
+}
+/**
+ * Options for prompt execution.
+ */
+export interface PromptOptions {
+	/** Execution timeout in milliseconds (overrides defaultTimeout) */
+	readonly timeout?: number | undefined;
+}
+/**
+ * Complete result from Claude Code prompt execution.
+ * Aggregates all stream messages into single structure.
+ */
+export interface ClaudeCodeResult {
+	/** Combined text result from all assistant messages */
+	readonly result: string;
+	/** Token count breakdown */
+	readonly tokens: TokenCounts;
+	/** Total cost in USD */
+	readonly cost: number;
+	/** Exit code from CLI process (0 = success) */
+	readonly exitCode: number;
+	/** Total execution duration in milliseconds */
+	readonly duration: number;
+}
+/**
+ * Stream parser for line-delimited JSON.
+ * Buffers incomplete lines across chunks.
+ */
+export interface StreamParser {
+	/**
+	 * Process a chunk of raw PTY output.
+	 * Emits parsed messages via callback.
+	 * Throws RuntimeError RILL-R004 for invalid JSON on complete lines.
+	 *
+	 * @param chunk - Raw data from PTY (Buffer or string)
+	 * @param onMessage - Callback for each parsed message
+	 * @throws RuntimeError with code RILL-R004 for invalid JSON
+	 */
+	processChunk(chunk: Buffer | string, onMessage: (message: ClaudeMessage) => void): void;
+	/**
+	 * Flush remaining buffered data.
+	 * Call when stream ends to process incomplete lines.
+	 *
+	 * @param onMessage - Callback for final parsed messages
+	 * @throws RuntimeError with code RILL-R004 for invalid JSON
+	 */
+	flush(onMessage: (message: ClaudeMessage) => void): void;
+}
+/**
+ * Create a new stream parser instance.
+ *
+ * @returns Stream parser with buffering state
+ */
+export declare function createStreamParser(): StreamParser;
+/**
+ * Extracts complete ClaudeCodeResult from parsed message stream.
+ * Accumulates token counts across assistant messages and extracts cost/duration from final result message.
+ *
+ * @param messages - Parsed stream messages (ClaudeMessage[])
+ * @returns Complete result dict with text, tokens, cost, and exitCode
+ */
+export declare function extractResult(messages: readonly ClaudeMessage[]): ClaudeCodeResult;
+/**
+ * Process spawn result.
+ * Includes PTY instance and cleanup function.
+ */
+export interface SpawnResult {
+	/** PTY process instance */
+	readonly ptyProcess: pty.IPty;
+	/** Exit code promise (resolves when process exits) */
+	readonly exitCode: Promise<number>;
+	/** Cleanup function (kills process if running) */
+	readonly dispose: () => void;
+}
+/**
+ * Options for spawning Claude CLI process.
+ */
+export interface SpawnOptions {
+	/** Path to Claude CLI binary (default: 'claude') */
+	readonly binaryPath?: string | undefined;
+	/** Timeout in milliseconds (kills process after duration) */
+	readonly timeoutMs?: number | undefined;
+	/** Working directory for process (default: inherit) */
+	readonly cwd?: string | undefined;
+	/** Environment variables (default: inherit) */
+	readonly env?: Record<string, string | undefined> | undefined;
+	/** Skip permission checks (default: true) */
+	readonly dangerouslySkipPermissions?: boolean | undefined;
+	/** Setting sources to load: 'user', 'project', 'local' (default: '') */
+	readonly settingSources?: string | undefined;
+}
+/**
+ * Spawn Claude CLI process with timeout enforcement.
+ *
+ * @param prompt - User prompt to send to Claude
+ * @param options - Spawn options
+ * @returns Process handle with exit code and cleanup
+ * @throws RuntimeError RILL-R004 for spawn failures
+ */
+export declare function spawnClaudeCli(prompt: string, options?: SpawnOptions): SpawnResult;
+/**
+ * Create Claude Code extension instance.
+ * Validates configuration and returns host functions with cleanup.
+ *
+ * @param config - Extension configuration
+ * @returns ExtensionResult with prompt, skill, command functions and dispose
+ * @throws Error for invalid configuration (EC-1, EC-2)
+ *
+ * @example
+ * ```typescript
+ * const ext = createClaudeCodeExtension({
+ *   binaryPath: '/usr/local/bin/claude',
+ *   defaultTimeout: 60000
+ * });
+ * // Use with rill runtime...
+ * await ext.dispose();
+ * ```
+ */
+export declare function createClaudeCodeExtension(config?: ClaudeCodeConfig): ExtensionResult;
 /**
  * @rcrsr/rill-ext-claude-code
  *
  * Extension for executing Claude Code toolkit operations from rill scripts.
  */
 export declare const VERSION = "0.1.0";
-export type { TokenCounts, TokenUsage, TextBlock, ToolUseBlock, ToolResultBlock, ContentBlock, SystemMessage, AssistantMessage, UserMessage, ResultMessage, ClaudeMessage, ClaudeCodeConfig, PromptOptions, ClaudeCodeResult, } from './types.js';
-export type { StreamParser } from './stream-parser.js';
-export { createStreamParser } from './stream-parser.js';
-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
+
+export {};