forkoff 1.0.0

package/dist/tools/claude-hooks.js

@@ -0,0 +1,348 @@
+"use strict";
+/**
+ * Claude Code Hooks Integration
+ *
+ * Integrates with Claude Code's hook system to:
+ * - Intercept tool usage (PreToolUse, PostToolUse)
+ * - Receive notifications
+ * - Request approvals before executing dangerous operations
+ *
+ * Claude Code hooks are configured in ~/.claude/settings.json
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeHooksManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const events_1 = require("events");
+class ClaudeHooksManager extends events_1.EventEmitter {
+    constructor() {
+        super();
+        this.isConfigured = false;
+        this.claudeDir = path.join(os.homedir(), '.claude');
+        this.settingsPath = path.join(this.claudeDir, 'settings.json');
+        this.hookScriptPath = this.getHookScriptPath();
+    }
+    getHookScriptPath() {
+        const platform = os.platform();
+        if (platform === 'win32') {
+            return path.join(os.homedir(), '.forkoff', 'forkoff-hook.cmd');
+        }
+        else {
+            return path.join(os.homedir(), '.forkoff', 'forkoff-hook');
+        }
+    }
+    /**
+     * Check if Claude Code is installed and hooks can be configured
+     */
+    canConfigure() {
+        return fs.existsSync(this.claudeDir);
+    }
+    /**
+     * Check if ForkOff hooks are already configured
+     */
+    isHookConfigured() {
+        if (!fs.existsSync(this.settingsPath)) {
+            return false;
+        }
+        try {
+            const settings = this.readSettings();
+            const hookName = 'forkoff-hook';
+            // Check if any hook configuration references forkoff-hook
+            const hookTypes = ['PreToolUse', 'PostToolUse', 'Notification', 'Stop'];
+            for (const hookType of hookTypes) {
+                const hooks = settings.hooks?.[hookType];
+                if (hooks && hooks.some(h => h.hooks.includes(hookName))) {
+                    return true;
+                }
+            }
+        }
+        catch {
+            return false;
+        }
+        return false;
+    }
+    /**
+     * Read Claude settings
+     */
+    readSettings() {
+        if (!fs.existsSync(this.settingsPath)) {
+            return {};
+        }
+        const content = fs.readFileSync(this.settingsPath, 'utf8');
+        return JSON.parse(content);
+    }
+    /**
+     * Write Claude settings
+     */
+    writeSettings(settings) {
+        fs.writeFileSync(this.settingsPath, JSON.stringify(settings, null, 2));
+    }
+    /**
+     * Install ForkOff hooks into Claude Code
+     */
+    async installHooks() {
+        if (!this.canConfigure()) {
+            throw new Error('Claude Code not found. Please install Claude Code first.');
+        }
+        // Create hook script directory
+        const hookDir = path.dirname(this.hookScriptPath);
+        if (!fs.existsSync(hookDir)) {
+            fs.mkdirSync(hookDir, { recursive: true });
+        }
+        // Create the hook script
+        await this.createHookScript();
+        // Update Claude settings
+        const settings = this.readSettings();
+        settings.hooks = settings.hooks || {};
+        const hookConfig = { matcher: '.*', hooks: ['forkoff-hook'] };
+        // Add hooks for all event types
+        settings.hooks.PreToolUse = settings.hooks.PreToolUse || [];
+        if (!settings.hooks.PreToolUse.some(h => h.hooks.includes('forkoff-hook'))) {
+            settings.hooks.PreToolUse.push(hookConfig);
+        }
+        settings.hooks.PostToolUse = settings.hooks.PostToolUse || [];
+        if (!settings.hooks.PostToolUse.some(h => h.hooks.includes('forkoff-hook'))) {
+            settings.hooks.PostToolUse.push(hookConfig);
+        }
+        settings.hooks.Notification = settings.hooks.Notification || [];
+        if (!settings.hooks.Notification.some(h => h.hooks.includes('forkoff-hook'))) {
+            settings.hooks.Notification.push(hookConfig);
+        }
+        this.writeSettings(settings);
+        this.isConfigured = true;
+        this.emit('hooks_installed');
+    }
+    /**
+     * Create the hook script that Claude Code will execute
+     */
+    async createHookScript() {
+        const platform = os.platform();
+        if (platform === 'win32') {
+            // Windows batch script
+            const script = `@echo off
+node "%~dp0forkoff-hook.js" %*
+`;
+            fs.writeFileSync(this.hookScriptPath, script);
+            // Create the Node.js script
+            const jsScript = this.getHookJsScript();
+            fs.writeFileSync(path.join(path.dirname(this.hookScriptPath), 'forkoff-hook.js'), jsScript);
+        }
+        else {
+            // Unix shell script
+            const script = `#!/bin/bash
+node "$(dirname "$0")/forkoff-hook.js" "$@"
+`;
+            fs.writeFileSync(this.hookScriptPath, script, { mode: 0o755 });
+            // Create the Node.js script
+            const jsScript = this.getHookJsScript();
+            fs.writeFileSync(path.join(path.dirname(this.hookScriptPath), 'forkoff-hook.js'), jsScript);
+        }
+    }
+    /**
+     * Get the JavaScript hook script content
+     */
+    getHookJsScript() {
+        return `#!/usr/bin/env node
+/**
+ * ForkOff Hook Script for Claude Code
+ * This script is called by Claude Code for hook events
+ */
+
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+
+// Read input from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
+
+process.stdin.on('end', async () => {
+  try {
+    const hookData = JSON.parse(input);
+
+    // Try to send to ForkOff daemon
+    await sendToForkOff(hookData);
+
+    // By default, allow the operation to continue
+    const output = { continue: true };
+    console.log(JSON.stringify(output));
+    process.exit(0);
+  } catch (error) {
+    // On error, still allow the operation
+    console.log(JSON.stringify({ continue: true }));
+    process.exit(0);
+  }
+});
+
+async function sendToForkOff(hookData) {
+  return new Promise((resolve, reject) => {
+    // Read config to find daemon port
+    const configPath = path.join(require('os').homedir(), '.forkoff', 'config.json');
+
+    let port = 47471; // Default daemon port
+    try {
+      if (fs.existsSync(configPath)) {
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        port = config.daemonPort || port;
+      }
+    } catch {}
+
+    const data = JSON.stringify(hookData);
+
+    const options = {
+      hostname: '127.0.0.1',
+      port: port,
+      path: '/hook',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(data)
+      },
+      timeout: 1000
+    };
+
+    const req = http.request(options, (res) => {
+      let response = '';
+      res.on('data', (chunk) => response += chunk);
+      res.on('end', () => resolve(response));
+    });
+
+    req.on('error', () => resolve(null)); // Daemon not running, that's ok
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(null);
+    });
+
+    req.write(data);
+    req.end();
+  });
+}
+`;
+    }
+    /**
+     * Remove ForkOff hooks from Claude Code
+     */
+    async uninstallHooks() {
+        if (!fs.existsSync(this.settingsPath)) {
+            return;
+        }
+        const settings = this.readSettings();
+        if (settings.hooks) {
+            // Remove forkoff-hook from all hook types
+            for (const hookType of ['PreToolUse', 'PostToolUse', 'Notification', 'Stop']) {
+                if (settings.hooks[hookType]) {
+                    settings.hooks[hookType] = settings.hooks[hookType].filter(h => !h.hooks.includes('forkoff-hook'));
+                    if (settings.hooks[hookType].length === 0) {
+                        delete settings.hooks[hookType];
+                    }
+                }
+            }
+            if (Object.keys(settings.hooks).length === 0) {
+                delete settings.hooks;
+            }
+        }
+        this.writeSettings(settings);
+        // Remove hook scripts
+        const hookDir = path.dirname(this.hookScriptPath);
+        if (fs.existsSync(hookDir)) {
+            try {
+                fs.rmSync(hookDir, { recursive: true });
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        this.isConfigured = false;
+        this.emit('hooks_uninstalled');
+    }
+    /**
+     * Process a hook event (called by the hook script via local HTTP)
+     */
+    processHookEvent(hookData) {
+        this.emit('hook_event', hookData);
+        switch (hookData.hook_type) {
+            case 'PreToolUse':
+                return this.handlePreToolUse(hookData);
+            case 'PostToolUse':
+                return this.handlePostToolUse(hookData);
+            case 'Notification':
+                return this.handleNotification(hookData);
+            case 'Stop':
+                return this.handleStop(hookData);
+            default:
+                return { continue: true };
+        }
+    }
+    handlePreToolUse(hookData) {
+        this.emit('pre_tool_use', {
+            toolName: hookData.tool_name,
+            toolInput: hookData.tool_input,
+            sessionId: hookData.session_id,
+        });
+        // For now, always allow - approval logic can be added later
+        return { continue: true };
+    }
+    handlePostToolUse(hookData) {
+        this.emit('post_tool_use', {
+            toolName: hookData.tool_name,
+            toolInput: hookData.tool_input,
+            toolOutput: hookData.tool_output,
+            sessionId: hookData.session_id,
+        });
+        return { continue: true };
+    }
+    handleNotification(hookData) {
+        this.emit('notification', {
+            message: hookData.message,
+            sessionId: hookData.session_id,
+        });
+        return { continue: true };
+    }
+    handleStop(hookData) {
+        this.emit('stop', {
+            sessionId: hookData.session_id,
+            transcriptPath: hookData.transcript_path,
+        });
+        return { continue: true };
+    }
+}
+exports.claudeHooksManager = new ClaudeHooksManager();
+exports.default = exports.claudeHooksManager;
+//# sourceMappingURL=claude-hooks.js.map

package/dist/tools/claude-hooks.js.map

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

package/dist/tools/claude-process.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Claude Process Manager
+ * Spawns and manages Claude CLI processes for terminal sessions
+ */
+import { EventEmitter } from 'events';
+/**
+ * Represents a pending approval request that is waiting for user response.
+ * Used internally to track active approval requests and manage their timeouts.
+ *
+ * @interface PendingApproval
+ * @property {string} approvalId - Unique identifier for this approval request
+ * @property {string} terminalSessionId - The terminal session that triggered this approval
+ * @property {number} createdAt - Unix timestamp (ms) when the approval was created
+ * @property {NodeJS.Timeout} timeoutId - Reference to the timeout that will auto-deny if no response
+ */
+interface PendingApproval {
+    approvalId: string;
+    terminalSessionId: string;
+    createdAt: number;
+    timeoutId: NodeJS.Timeout;
+}
+interface ProcessOutputEvent {
+    terminalSessionId: string;
+    output: string;
+    type: 'stdout' | 'stderr' | 'exit';
+    exitCode?: number;
+}
+interface SessionEndedEvent {
+    terminalSessionId: string;
+    directory: string;
+    sessionKey?: string;
+    exitCode: number;
+}
+/**
+ * Event payload emitted when Claude CLI requests user approval.
+ * This is sent to the mobile app to display an approval dialog to the user.
+ *
+ * @interface ClaudeApprovalRequest
+ * @property {string} approvalId - Unique identifier for this approval request
+ * @property {string} terminalSessionId - The terminal session that triggered this approval
+ * @property {string} [sessionKey] - Optional Claude session key for session resumption
+ * @property {string[]} context - Recent output lines providing context for the approval
+ * @property {string[]} options - Available response options in "key:label" format
+ *                                (e.g., ['y:yes', 'n:no', 'p:plan'])
+ * @property {string} promptText - The actual approval prompt text from Claude CLI
+ */
+interface ClaudeApprovalRequest {
+    approvalId: string;
+    terminalSessionId: string;
+    sessionKey?: string;
+    context: string[];
+    options: string[];
+    promptText: string;
+}
+/** SDK message structure received from Claude CLI JSONL output */
+interface SdkMessage {
+    type: string;
+    subtype?: string;
+    [key: string]: unknown;
+}
+/** Thinking content event payload */
+interface ThinkingContentEvent {
+    terminalSessionId: string;
+    sessionKey?: string;
+    thinkingId: string;
+    content: string;
+    partial: boolean;
+}
+/** Token usage event payload */
+interface TokenUsageEvent {
+    terminalSessionId: string;
+    sessionKey?: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/** Task structure for task progress tracking */
+interface TaskInfo {
+    id: string;
+    subject: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm?: string;
+}
+/** Task progress event payload */
+interface TaskProgressEvent {
+    terminalSessionId: string;
+    sessionKey?: string;
+    type: 'created' | 'updated' | 'completed' | 'list';
+    task?: TaskInfo;
+    tasks?: TaskInfo[];
+}
+/** Event payload for SDK messages */
+interface SdkMessageEvent {
+    terminalSessionId: string;
+    message: SdkMessage;
+}
+/** Type-safe event signatures for ClaudeProcessManager */
+interface ClaudeProcessManagerEvents {
+    output: [event: ProcessOutputEvent];
+    session_ended: [event: SessionEndedEvent];
+    sdk_message: [event: SdkMessageEvent];
+    claude_approval_request: [request: ClaudeApprovalRequest];
+    thinking_content: [event: ThinkingContentEvent];
+    token_usage: [event: TokenUsageEvent];
+    task_progress: [event: TaskProgressEvent];
+}
+declare class ClaudeProcessManager extends EventEmitter {
+    private processes;
+    private pendingApprovals;
+    private readonly APPROVAL_TIMEOUT_MS;
+    private readonly MAX_OUTPUT_BUFFER_LINES;
+    /** Track closed sessions for auto-restart */
+    private closedSessions;
+    /** Maximum number of auto-restarts per session to prevent chaos */
+    private readonly MAX_AUTO_RESTARTS;
+    /** Type-safe emit for known events */
+    emit<K extends keyof ClaudeProcessManagerEvents>(event: K, ...args: ClaudeProcessManagerEvents[K]): boolean;
+    /** Type-safe on for known events */
+    on<K extends keyof ClaudeProcessManagerEvents>(event: K, listener: (...args: ClaudeProcessManagerEvents[K]) => void): this;
+    /**
+     * Start a new Claude session in the specified directory
+     */
+    startSession(directory: string, terminalSessionId: string): Promise<{
+        cwd: string;
+    }>;
+    /**
+     * Resume an existing Claude session
+     */
+    resumeSession(sessionKey: string, directory: string, terminalSessionId: string): Promise<{
+        cwd: string;
+    }>;
+    /**
+     * Send input to a Claude process in JSONL format
+     * Format: {"type":"user","message":{"role":"user","content":"..."}}
+     *
+     * IMPORTANT: Claude SDK with --resume and streaming JSON only supports ONE turn per process.
+     * So we kill any existing process and spawn a fresh one for each message.
+     * Since we use --resume, the conversation history is preserved.
+     */
+    sendInput(terminalSessionId: string, input: string): Promise<boolean>;
+    /**
+     * Check if a session is a Claude session (active or restartable)
+     */
+    isClaudeSession(terminalSessionId: string): boolean;
+    /**
+     * Register session info without spawning a process.
+     * Used when mobile opens a session view - we store the info so we can spawn later on first message.
+     */
+    registerSession(sessionKey: string, directory: string, terminalSessionId: string): void;
+    /**
+     * Set up event handlers for the spawned process
+     */
+    private setupProcessHandlers;
+    /**
+     * Resolve path (handle ~ for home directory)
+     * SECURITY: Validates path doesn't contain dangerous characters
+     */
+    private resolvePath;
+    /**
+     * Kill a Claude process
+     */
+    killProcess(terminalSessionId: string): void;
+    /**
+     * Get all active process IDs
+     */
+    getActiveProcessIds(): string[];
+    /**
+     * Get all active sessions with their details
+     */
+    getActiveSessions(): Array<{
+        terminalSessionId: string;
+        sessionKey?: string;
+        directory: string;
+    }>;
+    /**
+     * Clean up old closed session entries to prevent memory leaks.
+     * Sessions older than 1 hour are removed.
+     */
+    cleanupOldClosedSessions(): void;
+    /**
+     * Clear restart counter for a session, allowing fresh restarts.
+     * Useful when user explicitly wants to reset.
+     */
+    clearRestartCounter(terminalSessionId: string): void;
+    /**
+     * Checks Claude CLI output for approval patterns and emits approval request events.
+     *
+     * Scans the output against all patterns in APPROVAL_PATTERNS. When a match is found,
+     * creates a unique approval ID, sets up a timeout for auto-denial, and emits a
+     * 'claude_approval_request' event with the approval details.
+     *
+     * Prevents duplicate approvals for the same terminal session.
+     *
+     * @param {string} terminalSessionId - The terminal session ID producing the output
+     * @param {string} output - Raw output text from the Claude CLI process
+     * @param {ClaudeProcessInfo} processInfo - Process information including output buffer
+     * @fires ClaudeProcessManager#claude_approval_request
+     * @private
+     */
+    private checkForApprovalPattern;
+    /**
+     * Checks SDK messages for tool_use content and emits approval notifications.
+     *
+     * In SDK mode, Claude doesn't emit text approval prompts. Instead, we detect
+     * tool_use in the SDK messages and emit approval notifications so the mobile
+     * app can display what Claude is doing. Note: This is a notification, not
+     * a blocking approval - the tool may already be executed by the time the
+     * user sees this.
+     *
+     * @param {string} terminalSessionId - The terminal session ID
+     * @param {any} message - The parsed SDK JSON message
+     * @param {ClaudeProcessInfo} processInfo - Process info for context
+     * @private
+     */
+    private checkForToolUseInSdkMessage;
+    /**
+     * Handles approval request timeout by automatically denying the request.
+     *
+     * Called when the approval timeout (APPROVAL_TIMEOUT_MS) expires without
+     * receiving a user response. Automatically sends 'n' (no/deny) to the
+     * Claude CLI process to prevent indefinite blocking.
+     *
+     * @param {string} approvalId - The unique identifier of the timed-out approval
+     * @private
+     */
+    private handleApprovalTimeout;
+    /**
+     * Handles an approval response received from the mobile app.
+     *
+     * Processes the user's response to an approval request by:
+     * 1. Looking up the pending approval by ID
+     * 2. Clearing the auto-deny timeout
+     * 3. Writing the response character (e.g., 'y', 'n', 'p') to the Claude CLI stdin
+     *
+     * @param {string} approvalId - The unique identifier of the approval being responded to
+     * @param {string} response - The user's response (first character will be sent to stdin)
+     * @public
+     */
+    handleApprovalResponse(approvalId: string, response: string): void;
+    /**
+     * Retrieves a pending approval request for a specific terminal session.
+     *
+     * Searches through all pending approvals to find one matching the given
+     * terminal session ID. Useful for checking if there's an active approval
+     * request for a session before creating a new one.
+     *
+     * @param {string} terminalSessionId - The terminal session ID to search for
+     * @returns {PendingApproval | undefined} The pending approval if found, undefined otherwise
+     * @public
+     */
+    getPendingApproval(terminalSessionId: string): PendingApproval | undefined;
+    /**
+     * Parse thinking content from SDK messages.
+     * Claude SDK emits content_block_delta with type 'thinking' for extended thinking.
+     */
+    private parseThinkingContent;
+    /**
+     * Parse token usage from SDK messages.
+     * Claude SDK emits message_delta with usage field containing token counts.
+     */
+    private parseTokenUsage;
+    /**
+     * Parse task progress from SDK messages.
+     * Detects TaskCreate, TaskUpdate, TaskList tool uses and extracts task data.
+     */
+    private parseTaskProgress;
+}
+export declare const claudeProcessManager: ClaudeProcessManager;
+export default claudeProcessManager;
+//# sourceMappingURL=claude-process.d.ts.map

package/dist/tools/claude-process.d.ts.map

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