yepanywhere 0.1.0

package/dist/supervisor/Process.d.ts

@@ -0,0 +1,230 @@
+import type { ProviderName, UrlProjectId } from "@yep-anywhere/shared";
+import type { MessageQueue } from "../sdk/messageQueue.js";
+import type { PermissionMode, SDKMessage, ToolApprovalResult, UserMessage } from "../sdk/types.js";
+import type { InputRequest, ProcessEvent, ProcessInfo, ProcessOptions, ProcessState } from "./types.js";
+type Listener = (event: ProcessEvent) => void;
+/**
+ * IMPORTANT: Never filter out messages by type before emitting to SSE!
+ *
+ * Tool results are user-type messages containing tool_result content blocks.
+ * If you filter out user messages, tool calls will appear stuck in "pending"
+ * state until the page is refreshed (when JSONL is fetched from disk).
+ *
+ * The client-side mergeMessages handles deduplication by UUID, so duplicate
+ * emissions are safe and expected (queueMessage emits user messages, and
+ * the iterator also yields them).
+ *
+ * @returns true - always emit the message
+ */
+export declare function shouldEmitMessage(_message: SDKMessage): boolean;
+export interface ProcessConstructorOptions extends ProcessOptions {
+    /** MessageQueue for real SDK, undefined for mock SDK */
+    queue?: MessageQueue;
+    /** Abort function from real SDK */
+    abortFn?: () => void;
+}
+export declare class Process {
+    private sdkIterator;
+    readonly id: string;
+    private _sessionId;
+    readonly projectPath: string;
+    readonly projectId: UrlProjectId;
+    readonly startedAt: Date;
+    readonly provider: ProviderName;
+    readonly model: string | undefined;
+    private legacyQueue;
+    private messageQueue;
+    private abortFn;
+    private _state;
+    private listeners;
+    private idleTimer;
+    private idleTimeoutMs;
+    private iteratorDone;
+    /** Set synchronously when transport/spawn fails to prevent race with queueMessage */
+    private transportFailed;
+    /** In-memory message history for mock SDK (real SDK persists to disk) */
+    private messageHistory;
+    /** Accumulated streaming text for catch-up when clients connect mid-stream */
+    private _streamingText;
+    /** Message ID for current streaming response */
+    private _streamingMessageId;
+    /** Pending tool approval requests (from canUseTool callback) - supports concurrent approvals */
+    private pendingToolApprovals;
+    /** Order of pending approval request IDs for FIFO processing */
+    private pendingToolApprovalQueue;
+    /** Current permission mode for tool approvals */
+    private _permissionMode;
+    /** Version counter for permission mode changes (for multi-tab sync) */
+    private _modeVersion;
+    /** Max thinking tokens this process was created with (undefined = thinking disabled) */
+    private _maxThinkingTokens;
+    /** Resolvers waiting for the real session ID */
+    private sessionIdResolvers;
+    private sessionIdResolved;
+    /** Whether the process is held (soft pause) */
+    private _isHeld;
+    /** When hold mode was activated */
+    private _holdSince;
+    /** Resolver to wake up the iterator loop when resumed */
+    private _holdResolve;
+    constructor(sdkIterator: AsyncIterator<SDKMessage>, options: ProcessConstructorOptions);
+    get sessionId(): string;
+    get state(): ProcessState;
+    get queueDepth(): number;
+    get permissionMode(): PermissionMode;
+    get modeVersion(): number;
+    /**
+     * Max thinking tokens this process was created with.
+     * undefined means thinking is disabled.
+     */
+    get maxThinkingTokens(): number | undefined;
+    /**
+     * Whether the process has been terminated (either manually or due to error).
+     * A terminated process cannot accept new messages.
+     */
+    get isTerminated(): boolean;
+    /**
+     * Get the termination reason if the process was terminated.
+     */
+    get terminationReason(): string | null;
+    /**
+     * Whether the process is currently held (soft pause).
+     */
+    get isHeld(): boolean;
+    /**
+     * When the hold started, if currently held.
+     */
+    get holdSince(): Date | null;
+    /**
+     * Set hold mode (soft pause) for this process.
+     * When held, the iterator loop will pause before calling next().
+     * When resumed, it continues from where it left off.
+     */
+    setHold(enabled: boolean): void;
+    /**
+     * Wait until hold mode is disabled.
+     * Called by processMessages() when held.
+     */
+    private waitUntilResumed;
+    /**
+     * Update the permission mode for this process.
+     * Increments modeVersion and emits a mode-change event for multi-tab sync.
+     */
+    setPermissionMode(mode: PermissionMode): void;
+    /**
+     * Mark the process as terminated due to an error or external termination.
+     * Emits a terminated event and cleans up resources.
+     */
+    private markTerminated;
+    /**
+     * Wait for the real session ID from the SDK's init message.
+     * Returns immediately if already received, or waits with a timeout.
+     */
+    waitForSessionId(timeoutMs?: number): Promise<string>;
+    getInfo(): ProcessInfo;
+    /**
+     * Get the in-memory message history.
+     * Used by mock SDK sessions where messages aren't persisted to disk.
+     */
+    getMessageHistory(): SDKMessage[];
+    /**
+     * Get accumulated streaming text for catch-up when clients connect mid-stream.
+     * Returns the message ID and accumulated text, or null if not streaming.
+     */
+    getStreamingContent(): {
+        messageId: string;
+        text: string;
+    } | null;
+    /**
+     * Accumulate streaming text from a delta.
+     * Called by stream routes when processing stream_event messages.
+     */
+    accumulateStreamingText(messageId: string, text: string): void;
+    /**
+     * Clear streaming text accumulator (called when stream ends).
+     */
+    clearStreamingText(): void;
+    /**
+     * Add initial user message to history without queuing to SDK.
+     * Used for real SDK sessions where the initial message is passed directly
+     * to the SDK but needs to be in history for SSE replay to late-joining clients.
+     *
+     * @param text - The message text
+     * @param uuid - The UUID to use (should match what was passed to SDK)
+     * @param tempId - Optional client temp ID for optimistic UI tracking
+     */
+    addInitialUserMessage(text: string, uuid: string, tempId?: string): void;
+    /**
+     * Format file size for display.
+     */
+    private formatSize;
+    /**
+     * Build user message content that matches what MessageQueue sends to the SDK.
+     * This ensures SSE/history messages can be deduplicated against JSONL.
+     */
+    private buildUserMessageContent;
+    /**
+     * Queue a message to be sent to the SDK.
+     * For real SDK, pushes to MessageQueue.
+     * For mock SDK, uses legacy queue behavior.
+     *
+     * @returns Object with success status and queue position or error
+     */
+    queueMessage(message: UserMessage): {
+        success: boolean;
+        position?: number;
+        error?: string;
+    };
+    /**
+     * Handle tool approval request from SDK's canUseTool callback.
+     * This is called by the Supervisor when creating the session.
+     * Behavior depends on current permission mode:
+     * - default: Ask user for approval
+     * - acceptEdits: Auto-approve Edit/Write tools, ask for others
+     * - plan: Auto-approve read-only tools (Read, Glob, Grep, etc.), prompt for others
+     * - bypassPermissions: Auto-approve all tools
+     */
+    handleToolApproval(toolName: string, input: unknown, options: {
+        signal: AbortSignal;
+    }): Promise<ToolApprovalResult>;
+    /**
+     * Emit the next pending approval to the client, or transition to running if none left.
+     */
+    private emitNextPendingApproval;
+    /**
+     * Respond to a pending input request (tool approval).
+     * Called from the API when user approves/denies a tool.
+     * For AskUserQuestion, answers can be passed to update the tool input.
+     * For deny with feedback, the feedback message is passed to the SDK.
+     * Works for both real SDK (canUseTool callback) and mock SDK (input_request message).
+     */
+    respondToInput(requestId: string, response: "approve" | "deny", answers?: Record<string, string>, feedback?: string): boolean;
+    /**
+     * Get the current pending input request (first in queue), if any.
+     * Works for both real SDK (canUseTool callback) and mock SDK (input_request message).
+     */
+    getPendingInputRequest(): InputRequest | null;
+    subscribe(listener: Listener): () => void;
+    abort(): Promise<void>;
+    private processMessages;
+    /**
+     * Check if an error indicates the underlying Claude process was terminated.
+     */
+    private isProcessTerminationError;
+    /**
+     * Handle input_request message from mock SDK.
+     * Real SDK uses canUseTool callback instead.
+     */
+    private handleInputRequest;
+    private transitionToIdle;
+    /**
+     * Process next message in legacy queue (for mock SDK).
+     */
+    private processNextInQueue;
+    private startIdleTimer;
+    private clearIdleTimer;
+    private setState;
+    private emit;
+}
+export {};
+//# sourceMappingURL=Process.d.ts.map

package/dist/supervisor/Process.d.ts.map

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