@fronx/use-claude-code 0.1.0

package/dist/react/hook.js

@@ -0,0 +1,132 @@
+/**
+ * React hook for Claude Code conversation management.
+ *
+ * Thin wrapper over ClaudeConnection that converts events to React state updates.
+ */
+import { useState, useEffect, useRef, useCallback, useMemo } from 'react';
+import { ClaudeConnection } from '../client/connection.js';
+/**
+ * Hook for managing a Claude conversation in React.
+ *
+ * @example
+ * function Chat({ projectId }) {
+ *   const {
+ *     messages,
+ *     status,
+ *     isStreaming,
+ *     streamingSegments,
+ *     hasPersistedSession,
+ *     start,
+ *     send,
+ *     stop,
+ *     clear,
+ *     resume,
+ *   } = useClaudeConversation({
+ *     baseUrl: '/api/claude',
+ *     conversationId: projectId,
+ *     onResult: () => console.log('Response complete'),
+ *   });
+ *
+ *   // Render messages, input, etc.
+ * }
+ */
+export function useClaudeConversation(options) {
+    const { baseUrl, conversationId, autoConnect = true, reconnect, onResult } = options;
+    // State
+    const [messages, setMessages] = useState([]);
+    const [status, setStatus] = useState('checking');
+    const [isStreaming, setIsStreaming] = useState(false);
+    const [streamingSegments, setStreamingSegments] = useState([]);
+    const [hasPersistedSession, setHasPersistedSession] = useState(false);
+    const [lastError, setLastError] = useState(null);
+    // Store callback in ref to avoid triggering effect re-runs when parent re-renders
+    const onResultRef = useRef(onResult);
+    onResultRef.current = onResult;
+    // Connection instance - recreate when conversationId changes
+    const connectionRef = useRef(null);
+    // Create connection config - memoize to avoid unnecessary recreation
+    const connectionConfig = useMemo(() => ({
+        baseUrl,
+        conversationId,
+        reconnect,
+    }), [baseUrl, conversationId, reconnect]);
+    // Effect to manage connection lifecycle
+    useEffect(() => {
+        // Create new connection
+        const connection = new ClaudeConnection(connectionConfig);
+        connectionRef.current = connection;
+        // Subscribe to state changes
+        const handleStateChange = () => {
+            setMessages(connection.messages);
+            setStatus(connection.status);
+            setIsStreaming(connection.isStreaming);
+            setStreamingSegments(connection.streamingSegments);
+            setHasPersistedSession(connection.hasPersistedSession);
+            setLastError(connection.lastError);
+        };
+        const handleResult = () => {
+            onResultRef.current?.();
+        };
+        connection.on('stateChange', handleStateChange);
+        connection.on('result', handleResult);
+        // Connect if autoConnect is true
+        if (autoConnect) {
+            connection.connect();
+        }
+        // Cleanup on unmount or when conversationId changes
+        return () => {
+            connection.off('stateChange', handleStateChange);
+            connection.off('result', handleResult);
+            connection.disconnect();
+            connectionRef.current = null;
+        };
+    }, [connectionConfig, autoConnect]);
+    // Action methods - wrapped in useCallback to maintain stable references
+    const start = useCallback(async (initialMessage) => {
+        if (connectionRef.current) {
+            await connectionRef.current.start(initialMessage);
+        }
+    }, []);
+    const send = useCallback(async (message) => {
+        if (connectionRef.current) {
+            await connectionRef.current.send(message);
+        }
+    }, []);
+    const stop = useCallback(async () => {
+        if (connectionRef.current) {
+            await connectionRef.current.stop();
+        }
+    }, []);
+    const clear = useCallback(async () => {
+        if (connectionRef.current) {
+            await connectionRef.current.clear();
+        }
+    }, []);
+    const resume = useCallback(async () => {
+        if (connectionRef.current) {
+            await connectionRef.current.resume();
+        }
+    }, []);
+    const prewarm = useCallback(async () => {
+        if (connectionRef.current) {
+            await connectionRef.current.prewarm();
+        }
+    }, []);
+    return {
+        // State
+        messages,
+        status,
+        isStreaming,
+        streamingSegments,
+        hasPersistedSession,
+        lastError,
+        // Actions
+        start,
+        send,
+        stop,
+        clear,
+        resume,
+        prewarm,
+    };
+}
+//# sourceMappingURL=hook.js.map

package/dist/react/hook.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * React hooks for Claude Code integration
+ *
+ * @example
+ * import { useClaudeConversation } from '@anthropic/claude-code-lib/react';
+ *
+ * function Chat({ projectId }) {
+ *   const {
+ *     messages,
+ *     status,
+ *     isStreaming,
+ *     streamingSegments,
+ *     hasPersistedSession,
+ *     start,
+ *     send,
+ *     stop,
+ *     clear,
+ *     resume,
+ *   } = useClaudeConversation({
+ *     baseUrl: '/api/claude',
+ *     conversationId: projectId,
+ *     onResult: () => console.log('Response complete'),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => (
+ *         <div key={msg.id}>{msg.content}</div>
+ *       ))}
+ *
+ *       {streamingSegments.map((seg, i) =>
+ *         seg.type === 'text'
+ *           ? <div key={i}>{seg.content}</div>
+ *           : <div key={i}>Running: {seg.name}</div>
+ *       )}
+ *
+ *       {status === 'disconnected' && hasPersistedSession && (
+ *         <button onClick={resume}>Resume</button>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ */
+export * from '../shared/index.js';
+export type { ConnectionStatus, ChatState } from '../client/state-machine.js';
+export type { ClaudeConnectionConfig, ClaudeConnectionEvents } from '../client/connection.js';
+export { useClaudeConversation } from './hook.js';
+export type { UseClaudeConversationOptions, UseClaudeConversationReturn } from './hook.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,cAAc,oBAAoB,CAAC;AAGnC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAG9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,48 @@
+/**
+ * React hooks for Claude Code integration
+ *
+ * @example
+ * import { useClaudeConversation } from '@anthropic/claude-code-lib/react';
+ *
+ * function Chat({ projectId }) {
+ *   const {
+ *     messages,
+ *     status,
+ *     isStreaming,
+ *     streamingSegments,
+ *     hasPersistedSession,
+ *     start,
+ *     send,
+ *     stop,
+ *     clear,
+ *     resume,
+ *   } = useClaudeConversation({
+ *     baseUrl: '/api/claude',
+ *     conversationId: projectId,
+ *     onResult: () => console.log('Response complete'),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => (
+ *         <div key={msg.id}>{msg.content}</div>
+ *       ))}
+ *
+ *       {streamingSegments.map((seg, i) =>
+ *         seg.type === 'text'
+ *           ? <div key={i}>{seg.content}</div>
+ *           : <div key={i}>Running: {seg.name}</div>
+ *       )}
+ *
+ *       {status === 'disconnected' && hasPersistedSession && (
+ *         <button onClick={resume}>Resume</button>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ */
+// Re-export shared types and utilities
+export * from '../shared/index.js';
+// React-specific exports
+export { useClaudeConversation } from './hook.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,uCAAuC;AACvC,cAAc,oBAAoB,CAAC;AAMnC,yBAAyB;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/server/claude-spawn.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Claude CLI subprocess spawning utilities.
+ *
+ * Handles spawning Claude CLI in both one-shot (-p) mode and conversational mode
+ * with stream-json input/output for multi-turn interactions.
+ */
+import { ChildProcess } from 'child_process';
+export interface ClaudeSpawnOptions {
+    prompt: string;
+    cwd: string;
+    claudePath?: string;
+    allowedTools?: string[];
+    onStdoutLine: (line: string, parsed: unknown | null) => void;
+    onStderr: (content: string) => void;
+    onError: (err: Error) => void;
+    onClose: (code: number | null, signal: string | null) => void;
+}
+export interface ClaudeProcess {
+    process: ChildProcess;
+    kill: () => void;
+}
+/**
+ * Spawn Claude CLI with a single prompt (one-shot mode).
+ * Returns a handle to kill the process if needed.
+ */
+export declare function spawnClaude(options: ClaudeSpawnOptions): ClaudeProcess;
+export interface ClaudeConversationOptions {
+    cwd: string;
+    systemPrompt: string;
+    claudePath?: string;
+    allowedTools?: string[];
+    resumeSessionId?: string;
+    onMessage: (data: unknown) => void;
+    onError: (err: Error) => void;
+    onClose: (code: number | null) => void;
+}
+export interface ClaudeConversation {
+    process: ChildProcess;
+    sendMessage: (text: string) => void;
+    interrupt: () => void;
+    kill: () => void;
+}
+/**
+ * Spawn Claude CLI in conversational mode for multi-turn interactions.
+ *
+ * Uses --input-format stream-json and --output-format stream-json to allow
+ * sending multiple messages via stdin and receiving responses via stdout.
+ *
+ * Key difference from spawnClaude: stdin stays open for sending messages.
+ */
+export declare function spawnClaudeConversation(options: ClaudeConversationOptions): ClaudeConversation;
+//# sourceMappingURL=claude-spawn.d.ts.map

package/dist/server/claude-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-spawn.d.ts","sourceRoot":"","sources":["../../src/server/claude-spawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7D,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAgEtE;AAMD,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAkGpB"}

package/dist/server/claude-spawn.js

@@ -0,0 +1,147 @@
+/**
+ * Claude CLI subprocess spawning utilities.
+ *
+ * Handles spawning Claude CLI in both one-shot (-p) mode and conversational mode
+ * with stream-json input/output for multi-turn interactions.
+ */
+import { spawn } from 'child_process';
+/**
+ * Spawn Claude CLI with a single prompt (one-shot mode).
+ * Returns a handle to kill the process if needed.
+ */
+export function spawnClaude(options) {
+    const { prompt, cwd, claudePath = 'claude', allowedTools = ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'], onStdoutLine, onStderr, onError, onClose, } = options;
+    const args = [
+        '-p',
+        prompt,
+        '--allowedTools',
+        allowedTools.join(','),
+        '--output-format',
+        'stream-json',
+        '--verbose',
+        '--dangerously-skip-permissions',
+    ];
+    const proc = spawn(claudePath, args, {
+        cwd,
+        env: { ...process.env },
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    // Close stdin immediately - Claude doesn't need input for -p mode
+    proc.stdin.end();
+    proc.on('error', onError);
+    let buffer = '';
+    proc.stdout.on('data', (data) => {
+        buffer += data.toString();
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || ''; // Keep incomplete line in buffer
+        for (const line of lines) {
+            if (line.trim()) {
+                let parsed = null;
+                try {
+                    parsed = JSON.parse(line);
+                }
+                catch {
+                    // Not JSON
+                }
+                onStdoutLine(line, parsed);
+            }
+        }
+    });
+    proc.stderr.on('data', (data) => {
+        onStderr(data.toString());
+    });
+    proc.on('close', onClose);
+    return {
+        process: proc,
+        kill: () => proc.kill(),
+    };
+}
+/**
+ * Spawn Claude CLI in conversational mode for multi-turn interactions.
+ *
+ * Uses --input-format stream-json and --output-format stream-json to allow
+ * sending multiple messages via stdin and receiving responses via stdout.
+ *
+ * Key difference from spawnClaude: stdin stays open for sending messages.
+ */
+export function spawnClaudeConversation(options) {
+    const { cwd, systemPrompt, claudePath = 'claude', allowedTools = ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'], resumeSessionId, onMessage, onError, onClose, } = options;
+    const args = [
+        '-p',
+        '--input-format',
+        'stream-json',
+        '--output-format',
+        'stream-json',
+        '--system-prompt',
+        systemPrompt,
+        '--allowedTools',
+        allowedTools.join(','),
+        '--dangerously-skip-permissions',
+        '--verbose',
+    ];
+    // Add --resume flag if resuming a previous session
+    if (resumeSessionId) {
+        args.push('--resume', resumeSessionId);
+    }
+    const proc = spawn(claudePath, args, {
+        cwd,
+        env: { ...process.env },
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    // Don't close stdin - we'll send messages through it
+    proc.on('error', onError);
+    let buffer = '';
+    proc.stdout.on('data', (data) => {
+        buffer += data.toString();
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || ''; // Keep incomplete line in buffer
+        for (const line of lines) {
+            if (line.trim()) {
+                try {
+                    const parsed = JSON.parse(line);
+                    onMessage(parsed);
+                }
+                catch {
+                    // Non-JSON line, ignore
+                }
+            }
+        }
+    });
+    proc.stderr.on('data', (data) => {
+        // Log stderr for debugging but don't treat as error
+        console.error('[claude-spawn stderr]:', data.toString());
+    });
+    proc.on('close', (code) => {
+        onClose(code);
+    });
+    /**
+     * Send a user message to the Claude process.
+     *
+     * The stream-json input format expects newline-delimited JSON objects.
+     * Format: { type: 'user', message: { role: 'user', content: [...] } }
+     */
+    function sendMessage(text) {
+        const message = JSON.stringify({
+            type: 'user',
+            message: {
+                role: 'user',
+                content: [{ type: 'text', text }],
+            },
+        });
+        proc.stdin.write(message + '\n');
+    }
+    return {
+        process: proc,
+        sendMessage,
+        interrupt: () => {
+            // Send SIGINT (Ctrl+C) to pause generation without killing the process
+            // This matches Claude Code's Esc behavior
+            proc.kill('SIGINT');
+        },
+        kill: () => {
+            proc.stdin.end();
+            proc.kill();
+        },
+    };
+}
+//# sourceMappingURL=claude-spawn.js.map

package/dist/server/claude-spawn.js.map

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

package/dist/server/conversation.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Claude conversation lifecycle management.
+ *
+ * The ClaudeManager class handles:
+ * - Spawning and tracking Claude CLI conversations
+ * - Session persistence to the filesystem
+ * - Resuming conversations with --resume flag
+ * - Prewarming (spawning without an initial message)
+ * - SSE client subscription management
+ */
+import { ServerResponse } from 'http';
+import { Message } from '../shared/types.js';
+export interface ClaudeManagerConfig {
+    sessionDir: string;
+    claudePath?: string;
+    defaultAllowedTools?: string[];
+    autoPrewarm?: boolean;
+}
+export interface StartOptions {
+    systemPrompt: string | {
+        file: string;
+    };
+    cwd: string;
+    allowedTools?: string[];
+    initialMessage?: string;
+}
+export type ConversationStatus = 'starting' | 'ready' | 'streaming' | 'stopped';
+export interface Conversation {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly claudeSessionId: string | null;
+    readonly status: ConversationStatus;
+    readonly messages: Message[];
+    readonly isPrewarmed: boolean;
+    send(message: string): void;
+    stop(): void;
+    subscribe(res: ServerResponse): void;
+    unsubscribe(res: ServerResponse): void;
+}
+export declare class ClaudeManager {
+    private config;
+    private conversations;
+    constructor(config: ClaudeManagerConfig);
+    /**
+     * Start a new conversation.
+     *
+     * If a prewarmed conversation exists for this ID, it will be reused.
+     * Otherwise, a new Claude process is spawned.
+     */
+    start(id: string, options: StartOptions): Conversation;
+    /**
+     * Get an active conversation by ID.
+     */
+    get(id: string): Conversation | undefined;
+    /**
+     * Resume a conversation from a persisted session.
+     *
+     * Loads the session from disk and spawns Claude with --resume flag.
+     */
+    resume(id: string, options: StartOptions): Conversation;
+    /**
+     * Stop a conversation's current response.
+     *
+     * Sends SIGINT to pause generation without killing the process.
+     */
+    stop(id: string): void;
+    /**
+     * Clear a conversation completely.
+     *
+     * Kills the process, deletes the persisted session, and optionally
+     * prewarms a new conversation.
+     */
+    clear(id: string): void;
+    /**
+     * Prewarm a conversation by spawning Claude without sending a message.
+     *
+     * This makes the first response faster since Claude is already running.
+     */
+    prewarm(id: string, options: StartOptions): void;
+    /**
+     * Check if a persisted session exists for an ID.
+     */
+    hasPersistedSession(id: string): boolean;
+    /**
+     * Get status information for a conversation.
+     */
+    getStatus(id: string): {
+        active: boolean;
+        messageCount: number;
+        isStreaming: boolean;
+        sessionId: string | null;
+        claudeSessionId: string | null;
+        hasPersistedSession: boolean;
+    };
+    /**
+     * Clear all conversations (for testing or shutdown).
+     */
+    clearAll(): void;
+    private spawnClaude;
+    private spawnClaudePrewarmed;
+    private activatePrewarmed;
+    private handleClaudeMessage;
+    private handleClaudeError;
+    private handleClaudeClose;
+    private createUserMessage;
+    private broadcastToConversation;
+    private createConversationHandle;
+    private getSessionPath;
+    private saveSession;
+    private loadSession;
+    private deleteSession;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/server/conversation.d.ts.map

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