@luckydraw/cumulus 0.5.1

package/dist/tui/hooks/useAppState.js

@@ -0,0 +1,110 @@
+/**
+ * Application state management with context and reducer.
+ */
+import { createContext, useContext, useReducer } from 'react';
+export function createInitialState(threadName, debugMode = false) {
+    return {
+        messages: [],
+        streamBuffer: '',
+        isProcessing: false,
+        stats: { count: 0, totalTokens: 0 },
+        error: null,
+        threadName,
+        sessionId: null,
+        pendingAutoFollowUp: false,
+        debugMode,
+        debugContext: null,
+        debugContextExpanded: true,
+        overlay: null,
+        pendingMessage: null,
+    };
+}
+export function appReducer(state, action) {
+    switch (action.type) {
+        case 'SET_MESSAGES':
+            return { ...state, messages: action.messages };
+        case 'ADD_MESSAGE':
+            // Prevent duplicate messages (same ID)
+            if (state.messages.some(m => m.id === action.message.id)) {
+                return state;
+            }
+            return { ...state, messages: [...state.messages, action.message] };
+        case 'UPDATE_STREAM':
+            return { ...state, streamBuffer: action.text };
+        case 'APPEND_STREAM':
+            return { ...state, streamBuffer: state.streamBuffer + action.text };
+        case 'CLEAR_STREAM':
+            return { ...state, streamBuffer: '' };
+        case 'COMPLETE_RESPONSE':
+            // Phase 1: Clear stream + stop processing. Hold message in pendingMessage.
+            // The message is NOT added to messages[] yet — that happens in FLUSH_PENDING_MESSAGE
+            // on the next render cycle. This two-phase approach lets Ink erase the dynamic
+            // StreamingResponse area BEFORE Static writes the permanent message, preventing
+            // the duplication bug where both truncated streaming and full Static content
+            // appear simultaneously.
+            if (state.messages.some(m => m.id === action.message.id)) {
+                return { ...state, streamBuffer: '', isProcessing: false };
+            }
+            return {
+                ...state,
+                streamBuffer: '',
+                isProcessing: false,
+                pendingMessage: action.message,
+            };
+        case 'FLUSH_PENDING_MESSAGE':
+            // Phase 2: Move pending message into messages[] for Static rendering.
+            // By now, Ink has already erased the dynamic area from the previous render.
+            if (!state.pendingMessage)
+                return state;
+            if (state.messages.some(m => m.id === state.pendingMessage.id)) {
+                return { ...state, pendingMessage: null };
+            }
+            return {
+                ...state,
+                messages: [...state.messages, state.pendingMessage],
+                pendingMessage: null,
+            };
+        case 'SET_PROCESSING':
+            return { ...state, isProcessing: action.isProcessing };
+        case 'SET_STATS':
+            return { ...state, stats: action.stats };
+        case 'SET_ERROR':
+            return { ...state, error: action.error };
+        case 'SET_SESSION_ID':
+            return { ...state, sessionId: action.sessionId };
+        case 'MARK_INTERRUPTED':
+            // Save partial response as a message with interrupted metadata
+            return state;
+        case 'SET_PENDING_AUTO_FOLLOW_UP':
+            return { ...state, pendingAutoFollowUp: action.pending };
+        case 'SET_DEBUG_MODE':
+            return { ...state, debugMode: action.debugMode };
+        case 'SET_DEBUG_CONTEXT':
+            // When setting new context, auto-expand it
+            return {
+                ...state,
+                debugContext: action.context,
+                debugContextExpanded: action.context !== null,
+            };
+        case 'SET_DEBUG_EXPANDED':
+            return { ...state, debugContextExpanded: action.expanded };
+        case 'TOGGLE_DEBUG_EXPANDED':
+            return { ...state, debugContextExpanded: !state.debugContextExpanded };
+        case 'SET_OVERLAY':
+            return { ...state, overlay: action.overlay };
+        default:
+            return state;
+    }
+}
+export const AppContext = createContext(null);
+export function useAppContext() {
+    const context = useContext(AppContext);
+    if (!context) {
+        throw new Error('useAppContext must be used within AppContext.Provider');
+    }
+    return context;
+}
+export function useAppReducer(threadName, debugMode = false) {
+    return useReducer(appReducer, { threadName, debugMode }, ({ threadName, debugMode }) => createInitialState(threadName, debugMode));
+}
+//# sourceMappingURL=useAppState.js.map

package/dist/tui/hooks/useAppState.js.map

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

package/dist/tui/hooks/useClaudeProcess.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hook for managing Claude subprocess and streaming.
+ */
+import { ContentStore } from '../../lib/content-store.js';
+import type { DetectedImage } from '../../lib/image-utils.js';
+export interface ClaudeProcessOptions {
+    mcpConfigPath: string;
+    contentStore: ContentStore;
+    onText: (text: string) => void;
+    onComplete: (fullResponse: string) => void;
+    onError: (error: string) => void;
+    onExternalize?: (contentId: string, sizeKB: number) => void;
+}
+export interface ClaudeProcessHandle {
+    invoke: (userMessage: string, systemPrompt: string, images?: DetectedImage[]) => void;
+    kill: () => string;
+}
+export declare function useClaudeProcess(options: ClaudeProcessOptions): ClaudeProcessHandle;
+//# sourceMappingURL=useClaudeProcess.d.ts.map

package/dist/tui/hooks/useClaudeProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClaudeProcess.d.ts","sourceRoot":"","sources":["../../../src/tui/hooks/useClaudeProcess.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,UAAU,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IACtF,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA2MnF"}

package/dist/tui/hooks/useClaudeProcess.js

@@ -0,0 +1,185 @@
+/**
+ * Hook for managing Claude subprocess and streaming.
+ */
+import { spawn } from 'child_process';
+import { useCallback, useRef } from 'react';
+import { ContextBudget } from '../../lib/context-budget.js';
+import { StreamProcessor } from '../../lib/stream-processor.js';
+import { extractTextFromStreamLine } from '../utils/streamParser.js';
+export function useClaudeProcess(options) {
+    const { mcpConfigPath, contentStore, onText, onComplete, onError, onExternalize } = options;
+    const processRef = useRef(null);
+    const responseRef = useRef('');
+    const bufferRef = useRef('');
+    const completedRef = useRef(false);
+    const kill = useCallback(() => {
+        const partial = responseRef.current;
+        if (processRef.current) {
+            processRef.current.kill('SIGTERM');
+            processRef.current = null;
+        }
+        return partial;
+    }, []);
+    const invoke = useCallback((userMessage, systemPrompt, images) => {
+        // Reset state
+        responseRef.current = '';
+        bufferRef.current = '';
+        completedRef.current = false;
+        // Create fresh context budget and stream processor for this turn
+        const budget = new ContextBudget();
+        const streamProcessor = new StreamProcessor({
+            budget,
+            contentStore,
+            onExternalize: onExternalize
+                ? (contentId, originalSize) => {
+                    const sizeKB = Math.round(originalSize / 1024);
+                    onExternalize(contentId, sizeKB);
+                }
+                : undefined,
+        });
+        const hasImages = images && images.length > 0;
+        // Prepend system-style instruction for cumulus read_file preference
+        const readFileReminder = `<system-reminder>
+FILE READING: The built-in Read tool is DISABLED. Use read_file for ALL file reads (text, code, PDFs).
+- read_file reads the file, extracts text (including from PDFs), chunks it, embeds it, and stores it for future retrieval
+- You receive a summary, content ID, and chunk table-of-contents
+- Use the TOC to navigate: read_content_chunk("contentId", chunkIndex) for specific sections
+- Use search_content("query") to find content across all stored files
+</system-reminder>\n`;
+        const prefixedMessage = readFileReminder + userMessage;
+        const args = [
+            '--print',
+            '--verbose',
+            '--output-format',
+            'stream-json',
+            '--permission-mode',
+            'bypassPermissions',
+            '--mcp-config',
+            mcpConfigPath,
+            '--append-system-prompt',
+            systemPrompt,
+        ];
+        if (hasImages) {
+            // Use stdin-based stream-json input for multimodal messages
+            args.push('--input-format', 'stream-json');
+        }
+        else {
+            // Text-only: pass as positional argument (with system-reminder prefix)
+            args.push(prefixedMessage);
+        }
+        // Filter out Claude Code env vars so child process is isolated
+        const cleanEnv = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('CLAUDE') && key !== 'CLAUDECODE'));
+        const claude = spawn('claude', args, {
+            stdio: [hasImages ? 'pipe' : 'ignore', 'pipe', 'pipe'],
+            env: cleanEnv,
+        });
+        processRef.current = claude;
+        // Write multimodal content to stdin when images are present
+        if (hasImages && claude.stdin) {
+            const contentBlocks = [];
+            for (const img of images) {
+                contentBlocks.push({
+                    type: 'image',
+                    source: {
+                        type: 'base64',
+                        media_type: img.mediaType,
+                        data: img.base64Data,
+                    },
+                });
+            }
+            contentBlocks.push({
+                type: 'text',
+                text: prefixedMessage,
+            });
+            const stdinPayload = JSON.stringify({
+                type: 'user',
+                message: {
+                    role: 'user',
+                    content: contentBlocks,
+                },
+            });
+            claude.stdin.write(stdinPayload + '\n');
+            claude.stdin.end();
+        }
+        const processLine = async (line) => {
+            if (!line.trim())
+                return;
+            // Process through StreamProcessor for potential content externalization
+            let processed;
+            try {
+                processed = await streamProcessor.processLine(line);
+            }
+            catch (err) {
+                console.error('[useClaudeProcess] StreamProcessor error:', err);
+                processed = { line, modified: false, eventType: 'unknown' };
+            }
+            const lineToUse = processed.line;
+            const text = extractTextFromStreamLine(lineToUse);
+            if (text) {
+                // Add separator between distinct assistant message events (e.g., text
+                // segments separated by tool use). Without this, consecutive assistant
+                // texts get concatenated with no whitespace between them.
+                if (responseRef.current && !responseRef.current.endsWith('\n')) {
+                    responseRef.current += '\n\n';
+                    onText('\n\n');
+                }
+                responseRef.current += text;
+                onText(text);
+            }
+        };
+        claude.stdout.on('data', (data) => {
+            bufferRef.current += data.toString();
+            const lines = bufferRef.current.split('\n');
+            bufferRef.current = lines.pop() || '';
+            for (const line of lines) {
+                processLine(line).catch(() => {
+                    // Ignore processing errors
+                });
+            }
+        });
+        claude.stderr.on('data', (data) => {
+            const text = data.toString();
+            if (text.includes('Error') || text.includes('error')) {
+                onError(text);
+            }
+        });
+        claude.on('close', code => {
+            processRef.current = null;
+            // Guard against double completion
+            if (completedRef.current)
+                return;
+            const handleCompletion = () => {
+                if (completedRef.current)
+                    return;
+                completedRef.current = true;
+                if (code === 0) {
+                    onComplete(responseRef.current);
+                }
+                else if (code !== null) {
+                    onError(`Claude exited with code ${code}`);
+                }
+                // code === null means process was killed (interjection)
+            };
+            // Process any remaining buffer
+            if (bufferRef.current.trim()) {
+                processLine(bufferRef.current)
+                    .catch(() => { })
+                    .finally(handleCompletion);
+            }
+            else {
+                handleCompletion();
+            }
+        });
+        claude.on('error', err => {
+            processRef.current = null;
+            if (err.message.includes('ENOENT')) {
+                onError('Claude CLI not found. Please install it first.');
+            }
+            else {
+                onError(err.message);
+            }
+        });
+    }, [mcpConfigPath, contentStore, onText, onComplete, onError, onExternalize]);
+    return { invoke, kill };
+}
+//# sourceMappingURL=useClaudeProcess.js.map

package/dist/tui/hooks/useClaudeProcess.js.map

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

package/dist/tui/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * TUI entry point - renders the ink-based App component.
+ */
+export interface TuiOptions {
+    threadName: string;
+    debugMode?: boolean;
+}
+export declare function startTui(options: TuiOptions): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":";AACA;;GAEG;AAMH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAElD"}

package/dist/tui/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * TUI entry point - renders the ink-based App component.
+ */
+import { render } from 'ink';
+import { App } from './components/App.js';
+export function startTui(options) {
+    render(_jsx(App, { threadName: options.threadName, debugMode: options.debugMode ?? false }));
+}
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.tsx"],"names":[],"mappings":";;AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAO1C,MAAM,UAAU,QAAQ,CAAC,OAAmB;IAC1C,MAAM,CAAC,KAAC,GAAG,IAAC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,GAAI,CAAC,CAAC;AACzF,CAAC"}

package/dist/tui/utils/streamParser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Utilities for parsing stream-json output from Claude CLI.
+ */
+export interface StreamJsonMessage {
+    type?: string;
+    subtype?: string;
+    message?: {
+        content?: Array<{
+            type: string;
+            text?: string;
+        }>;
+    };
+    result?: string;
+}
+/**
+ * Extract text content from a stream-json line.
+ * Returns null if the line doesn't contain assistant text.
+ */
+export declare function extractTextFromStreamLine(line: string): string | null;
+/**
+ * Check if a stream line indicates completion.
+ */
+export declare function isStreamComplete(line: string): boolean;
+/**
+ * Check if a stream line indicates an error.
+ */
+export declare function isStreamError(line: string): {
+    isError: boolean;
+    message?: string;
+};
+//# sourceMappingURL=streamParser.d.ts.map

package/dist/tui/utils/streamParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamParser.d.ts","sourceRoot":"","sources":["../../../src/tui/utils/streamParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClD,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAelF"}

package/dist/tui/utils/streamParser.js

@@ -0,0 +1,63 @@
+/**
+ * Utilities for parsing stream-json output from Claude CLI.
+ */
+/**
+ * Extract text content from a stream-json line.
+ * Returns null if the line doesn't contain assistant text.
+ */
+export function extractTextFromStreamLine(line) {
+    if (!line.trim())
+        return null;
+    try {
+        const parsed = JSON.parse(line);
+        // Handle assistant message with content
+        if (parsed.type === 'assistant' && parsed.message?.content) {
+            const texts = [];
+            for (const block of parsed.message.content) {
+                if (block.type === 'text' && block.text) {
+                    texts.push(block.text);
+                }
+            }
+            return texts.length > 0 ? texts.join('\n\n') : null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a stream line indicates completion.
+ */
+export function isStreamComplete(line) {
+    if (!line.trim())
+        return false;
+    try {
+        const parsed = JSON.parse(line);
+        return parsed.type === 'result' || parsed.subtype === 'success';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a stream line indicates an error.
+ */
+export function isStreamError(line) {
+    if (!line.trim())
+        return { isError: false };
+    try {
+        const parsed = JSON.parse(line);
+        if (parsed.type === 'error') {
+            return {
+                isError: true,
+                message: parsed.error || parsed.message || 'Unknown error',
+            };
+        }
+        return { isError: false };
+    }
+    catch {
+        return { isError: false };
+    }
+}
+//# sourceMappingURL=streamParser.js.map

package/dist/tui/utils/streamParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamParser.js","sourceRoot":"","sources":["../../../src/tui/utils/streamParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAsB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnD,wCAAwC;QACxC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAsB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwD,CAAC;QACvF,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,eAAe;aAC3D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@luckydraw/cumulus",
+  "version": "0.5.1",
+  "description": "RLM-based CLI chat wrapper for Claude with external history context management",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js"
+    },
+    "./mcp/proxy": {
+      "import": "./dist/mcp/proxy.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "bin": {
+    "cumulus": "./dist/cli/cumulus.js",
+    "cumulus-mcp": "./dist/mcp/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
+    "type-check": "tsc --noEmit",
+    "test": "vitest",
+    "prepublishOnly": "npm run build && npm run type-check",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "claude",
+    "cli",
+    "chat",
+    "rlm",
+    "context",
+    "mcp"
+  ],
+  "author": "",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{js,json,md}": [
+      "prettier --write"
+    ]
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.0.10",
+    "@types/react": "^18.3.27",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.39.2",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^17.2.0",
+    "husky": "^9.1.7",
+    "ink-testing-library": "^4.0.0",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.8.1",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "commander": "^14.0.2",
+    "ink": "^5.2.1",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "nanoid": "^5.1.6",
+    "pdfjs-dist": "^5.4.624",
+    "react": "^18.3.1"
+  }
+}