@fronx/use-claude-code 0.1.0

package/dist/client/state-machine.js

@@ -0,0 +1,292 @@
+/**
+ * Chat state machine - handles message accumulation and streaming state correctly.
+ *
+ * Key insight: when Claude runs tools, the `result` event only contains
+ * the FINAL portion of the response. But `assistant` events stream the
+ * FULL content. We must use the accumulated streaming content, not the
+ * result payload.
+ *
+ * This module is pure - no React, no DOM, no side effects.
+ */
+let messageCounter = 0;
+function generateMessageId(prefix) {
+    return `${prefix}-${Date.now()}-${++messageCounter}`;
+}
+/**
+ * Create the initial state for a new connection.
+ */
+export function createInitialState() {
+    return {
+        messages: [],
+        status: 'checking',
+        isStreaming: false,
+        streamingSegments: [],
+        hasPersistedSession: false,
+        lastError: null,
+        currentSessionId: null,
+    };
+}
+/**
+ * Create state for when starting a new conversation.
+ * Optionally includes a user message if provided.
+ */
+export function createStartingState(state, userMessage) {
+    const messages = [];
+    if (userMessage) {
+        messages.push({
+            id: 'user-start',
+            role: 'user',
+            content: userMessage,
+            timestamp: new Date(),
+        });
+    }
+    messages.push({
+        id: 'system-starting',
+        role: 'system',
+        content: 'Starting session...',
+        timestamp: new Date(),
+    });
+    return {
+        ...state,
+        messages,
+        status: 'connecting',
+        isStreaming: true,
+        streamingSegments: [],
+        lastError: null,
+    };
+}
+/**
+ * Process an SSE event and return the new state.
+ * Pure function - no side effects.
+ *
+ * @param state - Current state
+ * @param event - SSE event to process
+ * @param needNewTextSegment - Whether next text should start a new segment (after tool use)
+ * @returns Tuple of [newState, needNewTextSegment]
+ */
+export function processEvent(state, event, needNewTextSegment) {
+    // Filter stale events by session ID
+    if ('sessionId' in event && event.sessionId && state.currentSessionId) {
+        if (event.sessionId !== state.currentSessionId) {
+            return [state, needNewTextSegment];
+        }
+    }
+    switch (event.type) {
+        case 'init': {
+            return [
+                {
+                    ...state,
+                    currentSessionId: event.sessionId,
+                    status: 'connected',
+                },
+                needNewTextSegment,
+            ];
+        }
+        case 'history': {
+            // Only apply history if we don't have messages (reconnection case)
+            if (state.messages.length > 0) {
+                return [
+                    {
+                        ...state,
+                        currentSessionId: event.sessionId,
+                    },
+                    needNewTextSegment,
+                ];
+            }
+            return [
+                {
+                    ...state,
+                    currentSessionId: event.sessionId,
+                    messages: event.messages.map(m => ({
+                        ...m,
+                        timestamp: m.timestamp ? new Date(m.timestamp) : undefined,
+                    })),
+                },
+                needNewTextSegment,
+            ];
+        }
+        case 'assistant': {
+            const segments = [...state.streamingSegments];
+            if (needNewTextSegment ||
+                segments.length === 0 ||
+                segments[segments.length - 1].type !== 'text') {
+                // Start new text segment
+                segments.push({ type: 'text', content: event.text });
+            }
+            else {
+                // Append to existing text segment
+                const lastSegment = segments[segments.length - 1];
+                if (lastSegment.type === 'text') {
+                    segments[segments.length - 1] = {
+                        type: 'text',
+                        content: lastSegment.content + event.text,
+                    };
+                }
+            }
+            return [
+                {
+                    ...state,
+                    isStreaming: true,
+                    streamingSegments: segments,
+                },
+                false, // needNewTextSegment = false after text
+            ];
+        }
+        case 'tool': {
+            const segments = [...state.streamingSegments];
+            segments.push({
+                type: 'tool',
+                name: event.name,
+                param: event.param,
+            });
+            return [
+                {
+                    ...state,
+                    isStreaming: true,
+                    streamingSegments: segments,
+                },
+                true, // needNewTextSegment = true after tool
+            ];
+        }
+        case 'result': {
+            // CRITICAL: Use accumulated streaming content, NOT event.result!
+            // When Claude runs tools, event.result only has the final portion,
+            // but streamingSegments has the full response.
+            const textContent = state.streamingSegments
+                .filter((s) => s.type === 'text')
+                .map(s => s.content)
+                .join('\n\n');
+            const content = textContent || event.result;
+            // Remove the "Starting session..." system message and add assistant response
+            const messages = [
+                ...state.messages.filter(m => m.id !== 'system-starting'),
+                {
+                    id: generateMessageId('assistant'),
+                    role: 'assistant',
+                    content,
+                    timestamp: new Date(),
+                },
+            ];
+            return [
+                {
+                    ...state,
+                    messages,
+                    isStreaming: false,
+                    streamingSegments: [],
+                },
+                true, // needNewTextSegment = true after result
+            ];
+        }
+        case 'user': {
+            // Usually we add user messages optimistically, so skip echoes.
+            // But if this is from history replay, it would be handled in 'history' event.
+            return [state, needNewTextSegment];
+        }
+        case 'error': {
+            return [
+                {
+                    ...state,
+                    lastError: event.error,
+                    isStreaming: false,
+                },
+                needNewTextSegment,
+            ];
+        }
+        case 'closed': {
+            return [
+                {
+                    ...state,
+                    status: 'disconnected',
+                    isStreaming: false,
+                },
+                needNewTextSegment,
+            ];
+        }
+        case 'cleared': {
+            return [
+                {
+                    ...createInitialState(),
+                    status: 'disconnected',
+                },
+                true,
+            ];
+        }
+        case 'stopped': {
+            // Convert any accumulated segments to a message (partial response)
+            let messages = state.messages;
+            if (state.streamingSegments.length > 0) {
+                const textContent = state.streamingSegments
+                    .filter((s) => s.type === 'text')
+                    .map(s => s.content)
+                    .join('\n\n');
+                if (textContent) {
+                    messages = [
+                        ...messages,
+                        {
+                            id: generateMessageId('assistant'),
+                            role: 'assistant',
+                            content: textContent + '\n\n*(stopped)*',
+                            timestamp: new Date(),
+                        },
+                    ];
+                }
+            }
+            return [
+                {
+                    ...state,
+                    messages,
+                    isStreaming: false,
+                    streamingSegments: [],
+                },
+                true, // needNewTextSegment = true after stopped
+            ];
+        }
+        default:
+            return [state, needNewTextSegment];
+    }
+}
+/**
+ * Add a user message to the state (for optimistic updates).
+ */
+export function addUserMessage(state, content) {
+    return {
+        ...state,
+        messages: [
+            ...state.messages,
+            {
+                id: generateMessageId('user'),
+                role: 'user',
+                content,
+                timestamp: new Date(),
+            },
+        ],
+    };
+}
+/**
+ * Update status.
+ */
+export function setStatus(state, status) {
+    return { ...state, status };
+}
+/**
+ * Set persisted session flag.
+ */
+export function setHasPersistedSession(state, hasPersistedSession) {
+    return { ...state, hasPersistedSession };
+}
+/**
+ * Clear session ID (used before clear() to reject stale events).
+ */
+export function clearSessionId(state) {
+    return { ...state, currentSessionId: null };
+}
+/**
+ * Full state reset for clear operations.
+ */
+export function resetState() {
+    return {
+        ...createInitialState(),
+        status: 'disconnected',
+    };
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/client/state-machine.js.map

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

package/dist/client/stream-processor.d.ts

@@ -0,0 +1,46 @@
+/**
+ * StreamProcessor - Unified SSE parsing for both POST response body and EventSource.
+ *
+ * This abstraction eliminates duplicated event handling between:
+ * - start()/resume() POST requests with SSE response body
+ * - EventSource connection for ongoing updates
+ */
+import type { SSEEvent } from '../shared/types.js';
+export type StreamEventHandler = (event: SSEEvent) => void;
+/**
+ * Parses SSE-formatted data and emits typed events.
+ */
+export declare class StreamProcessor {
+    private onEvent;
+    private buffer;
+    private currentEventType;
+    constructor(onEvent: StreamEventHandler);
+    /**
+     * Process a chunk of SSE data from a fetch response body.
+     * Handles buffering for partial lines.
+     */
+    processChunk(chunk: string): void;
+    /**
+     * Process an EventSource message event.
+     * The event type comes from the event property, data from the data property.
+     */
+    processMessageEvent(event: MessageEvent, eventType?: string): void;
+    /**
+     * Flush any remaining data in the buffer.
+     * Call this when the stream ends.
+     */
+    flush(): void;
+    /**
+     * Reset the processor state.
+     */
+    reset(): void;
+    private processLine;
+    /**
+     * Infer event type from data structure when not explicitly provided.
+     * Used for POST response streams that may not include event: lines.
+     */
+    private inferEventType;
+    private emitEvent;
+    private createEvent;
+}
+//# sourceMappingURL=stream-processor.d.ts.map

package/dist/client/stream-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-processor.d.ts","sourceRoot":"","sources":["../../src/client/stream-processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAE3D;;GAEG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,gBAAgB,CAAuB;gBAE3B,OAAO,EAAE,kBAAkB;IAE/C;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWjC;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAclE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,WAAW;IAoBnB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,WAAW;CAoEpB"}

package/dist/client/stream-processor.js

@@ -0,0 +1,173 @@
+/**
+ * StreamProcessor - Unified SSE parsing for both POST response body and EventSource.
+ *
+ * This abstraction eliminates duplicated event handling between:
+ * - start()/resume() POST requests with SSE response body
+ * - EventSource connection for ongoing updates
+ */
+/**
+ * Parses SSE-formatted data and emits typed events.
+ */
+export class StreamProcessor {
+    onEvent;
+    buffer = '';
+    currentEventType = null;
+    constructor(onEvent) {
+        this.onEvent = onEvent;
+    }
+    /**
+     * Process a chunk of SSE data from a fetch response body.
+     * Handles buffering for partial lines.
+     */
+    processChunk(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        // Keep the last incomplete line in the buffer
+        this.buffer = lines.pop() || '';
+        for (const line of lines) {
+            this.processLine(line);
+        }
+    }
+    /**
+     * Process an EventSource message event.
+     * The event type comes from the event property, data from the data property.
+     */
+    processMessageEvent(event, eventType) {
+        const type = eventType || 'message';
+        const data = event.data;
+        if (!data)
+            return;
+        try {
+            const parsed = JSON.parse(data);
+            this.emitEvent(type, parsed);
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    /**
+     * Flush any remaining data in the buffer.
+     * Call this when the stream ends.
+     */
+    flush() {
+        if (this.buffer.trim()) {
+            this.processLine(this.buffer);
+            this.buffer = '';
+        }
+    }
+    /**
+     * Reset the processor state.
+     */
+    reset() {
+        this.buffer = '';
+        this.currentEventType = null;
+    }
+    processLine(line) {
+        // SSE format: "event: type\ndata: json\n\n"
+        if (line.startsWith('event: ')) {
+            this.currentEventType = line.slice(7).trim();
+        }
+        else if (line.startsWith('data: ')) {
+            const data = line.slice(6);
+            try {
+                const parsed = JSON.parse(data);
+                const type = this.currentEventType || this.inferEventType(parsed);
+                this.emitEvent(type, parsed);
+                this.currentEventType = null;
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+        else if (line === '') {
+            // Empty line signals end of event - reset event type
+            this.currentEventType = null;
+        }
+    }
+    /**
+     * Infer event type from data structure when not explicitly provided.
+     * Used for POST response streams that may not include event: lines.
+     */
+    inferEventType(data) {
+        if ('messages' in data && 'sessionId' in data)
+            return 'history';
+        if ('text' in data)
+            return 'assistant';
+        if ('name' in data && !('result' in data))
+            return 'tool';
+        if ('result' in data)
+            return 'result';
+        if ('content' in data && !('role' in data))
+            return 'user';
+        if ('error' in data)
+            return 'error';
+        if ('sessionId' in data && Object.keys(data).length <= 3)
+            return 'init';
+        return 'unknown';
+    }
+    emitEvent(type, data) {
+        const event = this.createEvent(type, data);
+        if (event) {
+            this.onEvent(event);
+        }
+    }
+    createEvent(type, data) {
+        switch (type) {
+            case 'init':
+                return {
+                    type: 'init',
+                    sessionId: data.sessionId,
+                    resumed: data.resumed,
+                    prewarmed: data.prewarmed,
+                };
+            case 'history':
+                return {
+                    type: 'history',
+                    messages: data.messages,
+                    sessionId: data.sessionId,
+                };
+            case 'assistant':
+                return {
+                    type: 'assistant',
+                    text: data.text,
+                    sessionId: data.sessionId,
+                };
+            case 'tool':
+                return {
+                    type: 'tool',
+                    name: data.name,
+                    param: data.param,
+                    sessionId: data.sessionId,
+                };
+            case 'result':
+                return {
+                    type: 'result',
+                    result: data.result,
+                    sessionId: data.sessionId,
+                };
+            case 'user':
+                return {
+                    type: 'user',
+                    content: data.content,
+                    sessionId: data.sessionId,
+                };
+            case 'error':
+                return {
+                    type: 'error',
+                    error: data.error,
+                };
+            case 'closed':
+                return {
+                    type: 'closed',
+                    code: data.code,
+                };
+            case 'cleared':
+                return { type: 'cleared' };
+            case 'stopped':
+                return { type: 'stopped' };
+            default:
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=stream-processor.js.map

package/dist/client/stream-processor.js.map

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

package/dist/react/hook.d.ts

@@ -0,0 +1,55 @@
+/**
+ * React hook for Claude Code conversation management.
+ *
+ * Thin wrapper over ClaudeConnection that converts events to React state updates.
+ */
+import type { Message, StreamSegment, ClaudeError, ReconnectConfig } from '../shared/types.js';
+import type { ConnectionStatus } from '../client/state-machine.js';
+export interface UseClaudeConversationOptions {
+    baseUrl: string;
+    conversationId: string;
+    autoConnect?: boolean;
+    reconnect?: ReconnectConfig;
+    onResult?: () => void;
+}
+export interface UseClaudeConversationReturn {
+    messages: Message[];
+    status: ConnectionStatus;
+    isStreaming: boolean;
+    streamingSegments: StreamSegment[];
+    hasPersistedSession: boolean;
+    lastError: ClaudeError | null;
+    start: (initialMessage?: string) => Promise<void>;
+    send: (message: string) => Promise<void>;
+    stop: () => Promise<void>;
+    clear: () => Promise<void>;
+    resume: () => Promise<void>;
+    prewarm: () => Promise<void>;
+}
+/**
+ * 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 declare function useClaudeConversation(options: UseClaudeConversationOptions): UseClaudeConversationReturn;
+//# sourceMappingURL=hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/react/hook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAE1C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAG9B,KAAK,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAuH7B"}