agent-relay 1.6.0 → 2.0.4

package/dist/wrapper/pty-wrapper.d.ts

@@ -1,343 +0,0 @@
-/**
- * PtyWrapper - Node-PTY based wrapper for spawned workers
- *
- * Unlike TmuxWrapper which provides interactive terminal access,
- * PtyWrapper runs agents headlessly with output capture for logs.
- * Used for spawned workers that don't need direct user interaction.
- *
- * Extends BaseWrapper for shared message handling, spawn/release,
- * and continuity integration.
- */
-import { BaseWrapper, type BaseWrapperConfig } from './base-wrapper.js';
-import type { ParsedCommand, ParsedSummary, SessionEndMarker } from './parser.js';
-import type { SendPayload, SendMeta } from '../protocol/types.js';
-import { type LifecycleHooks } from '../hooks/index.js';
-/**
- * PtyWrapper-specific configuration.
- * Extends BaseWrapperConfig with PTY-specific options.
- */
-export interface PtyWrapperConfig extends BaseWrapperConfig {
-    /** Directory to write log files (optional) */
-    logsDir?: string;
-    /** Allow this agent to spawn other agents (default: true for Lead, false for spawned workers) */
-    allowSpawn?: boolean;
-    /** Callback when agent exits */
-    onExit?: (code: number) => void;
-    /** Custom lifecycle hooks */
-    hooks?: LifecycleHooks;
-    /** Enable trajectory tracking hooks (default: true if task provided) */
-    trajectoryTracking?: boolean;
-    /** Interactive mode - disables auto-accept of permission prompts (for auth setup flows) */
-    interactive?: boolean;
-    /**
-     * Summary reminder configuration. Set to false to disable.
-     * Default: { intervalMinutes: 15, minOutputs: 50 }
-     */
-    summaryReminder?: {
-        /** Minutes of activity before reminding (default: 15) */
-        intervalMinutes?: number;
-        /** Minimum significant outputs before reminding (default: 50) */
-        minOutputs?: number;
-    } | false;
-}
-export interface InjectionFailedEvent {
-    messageId: string;
-    from: string;
-    attempts: number;
-}
-export interface SummaryEvent {
-    agentName: string;
-    summary: ParsedSummary;
-}
-export interface SessionEndEvent {
-    agentName: string;
-    marker: SessionEndMarker;
-}
-export interface AuthRevokedEvent {
-    agentName: string;
-    provider: string;
-    message?: string;
-    confidence: 'high' | 'medium' | 'low';
-}
-export interface PtyWrapperEvents {
-    output: (data: string) => void;
-    exit: (code: number) => void;
-    error: (error: Error) => void;
-    'injection-failed': (event: InjectionFailedEvent) => void;
-    /** Emitted when agent outputs a [[SUMMARY]] block. Cloud services can persist this. */
-    'summary': (event: SummaryEvent) => void;
-    /** Emitted when agent outputs a [[SESSION_END]] block. Cloud services can handle session closure. */
-    'session-end': (event: SessionEndEvent) => void;
-    /** Emitted when auth revocation is detected. Cloud services can handle re-auth flow. */
-    'auth_revoked': (event: AuthRevokedEvent) => void;
-}
-export declare class PtyWrapper extends BaseWrapper {
-    protected config: PtyWrapperConfig;
-    private ptyProcess?;
-    private outputBuffer;
-    private rawBuffer;
-    private readyForMessages;
-    private lastOutputTime;
-    private logFilePath?;
-    private logStream?;
-    private acceptedPrompts;
-    private hookRegistry;
-    private sessionStartTime;
-    private inThinkingBlock;
-    private lastSummaryTime;
-    private outputsSinceSummary;
-    private detectedTask?;
-    private instructionsInjected;
-    private continuityInjected;
-    private recentLogChunks;
-    private static readonly LOG_DEDUP_WINDOW_MS;
-    private static readonly LOG_DEDUP_MAX_SIZE;
-    private lastParsedLength;
-    private lastContinuityParsedLength;
-    private authRevoked;
-    private lastAuthCheck;
-    private readonly AUTH_CHECK_INTERVAL;
-    constructor(config: PtyWrapperConfig);
-    /**
-     * Inject content into the PTY process.
-     * Used by BaseWrapper for message injection.
-     */
-    protected performInjection(content: string): Promise<void>;
-    /**
-     * Get cleaned output buffer for command parsing.
-     * Strips ANSI codes and returns raw buffer content.
-     */
-    protected getCleanOutput(): string;
-    /**
-     * Start the agent process
-     */
-    start(): Promise<void>;
-    /**
-     * Wait for the agent to be ready for input.
-     * Uses idle detection instead of a fixed delay.
-     */
-    private waitForAgentReady;
-    /**
-     * Inject continuity context from previous session.
-     * Called after agent ID initialization to restore state from ledger.
-     */
-    private injectContinuityContext;
-    /**
-     * Parse ->continuity: commands from output and handle them.
-     *
-     * Supported commands:
-     *   ->continuity:save <<<...>>>  - Save session state to ledger
-     *   ->continuity:load            - Request context injection
-     *   ->continuity:search "query"  - Search past handoffs
-     *   ->continuity:uncertain "..."  - Mark item as uncertain
-     *   ->continuity:handoff <<<...>>> - Create explicit handoff
-     */
-    /**
-     * Parse continuity commands from output.
-     * Overrides BaseWrapper to use client.sendMessage instead of queuing.
-     */
-    protected parseContinuityCommands(content: string): Promise<void>;
-    /**
-     * Handle output from the process
-     */
-    private handleOutput;
-    /**
-     * Filter Claude's extended thinking blocks from output.
-     * Thinking blocks are wrapped in <thinking>...</thinking> tags and should
-     * not be streamed to the dashboard or stored in output buffers.
-     *
-     * This method tracks state across calls to handle multi-line thinking blocks.
-     */
-    private filterThinkingBlocks;
-    /**
-     * Check if a log chunk is a duplicate (recently streamed).
-     * Prevents terminal redraws from causing duplicate log entries in the dashboard.
-     *
-     * Uses content normalization and time-based deduplication:
-     * - Strips whitespace and normalizes content for comparison
-     * - Considers chunks with same normalized content within LOG_DEDUP_WINDOW_MS as duplicates
-     * - Cleans up old entries to prevent memory growth
-     */
-    private isDuplicateLogChunk;
-    /**
-     * Auto-accept Claude's first-run prompts
-     * Handles multiple prompts in sequence:
-     * 1. --dangerously-skip-permissions acceptance ("Yes, I accept")
-     * 2. Trust directory prompt ("Yes, I trust this folder")
-     * 3. "Ready to code here?" permission prompt ("Yes, continue")
-     *
-     * Uses a Set to track which prompts have been accepted, allowing
-     * multiple different prompts to be handled in sequence.
-     */
-    private handleAutoAcceptPrompts;
-    /**
-     * Handle terminal escape sequences that require responses.
-     *
-     * Some CLI tools (like Codex) query terminal capabilities and expect responses.
-     * Without proper responses, they timeout and crash.
-     *
-     * Supported sequences:
-     * - CSI 6 n (DSR - Device Status Report for cursor position)
-     *   Response: CSI row ; col R (we report position 1;1)
-     */
-    private handleTerminalEscapeSequences;
-    /**
-     * Parse relay commands from output.
-     * Handles both single-line and multi-line (fenced) formats.
-     * Deduplication via sentMessageHashes.
-     *
-     * Optimization: Only parses new content since last parse to avoid O(n²) behavior.
-     * Uses lookback buffer for incomplete fenced messages that span output chunks.
-     */
-    private parseRelayCommands;
-    /**
-     * Parse fenced multi-line messages: ->relay:Target [thread:xxx] <<<\n...\n>>>
-     */
-    private parseFencedMessages;
-    /**
-     * Parse single-line messages (no fenced format)
-     * Format: ->relay:Target [thread:xxx] message body
-     */
-    private parseSingleLineMessages;
-    /**
-     * Send relay command to daemon.
-     * Extends BaseWrapper to add PTY-specific logging and hook dispatch.
-     */
-    protected sendRelayCommand(cmd: ParsedCommand): void;
-    /** Valid CLI types for spawn commands */
-    private static readonly VALID_CLI_TYPES;
-    /** Validate agent name format (PascalCase, alphanumeric, 2-30 chars) */
-    private isValidAgentName;
-    /** Validate CLI type */
-    private isValidCliType;
-    /**
-     * Parse spawn/release commands from output
-     * Uses string-based parsing for robustness with PTY output.
-     * Supports two formats:
-     *   Single-line: ->relay:spawn WorkerName cli "task description"
-     *   Multi-line (fenced): ->relay:spawn WorkerName cli <<<
-     *                        task description here
-     *                        can span multiple lines>>>
-     * Delegates to dashboard API if dashboardPort is set (for nested spawns).
-     *
-     * STRICT VALIDATION:
-     * - Command must be at start of line (after whitespace)
-     * - Agent name must be PascalCase (e.g., Backend, Frontend, Worker1)
-     * - CLI must be a known type (claude, codex, gemini, etc.)
-     *
-     * Overrides BaseWrapper to add PTY-specific validation and logging.
-     */
-    protected parseSpawnReleaseCommands(content: string): void;
-    /**
-     * Execute spawn via API or callback.
-     * After spawning, waits for the agent to come online and sends the task via relay.
-     */
-    protected executeSpawn(name: string, cli: string, task: string): Promise<void>;
-    /**
-     * Wait for a spawned agent to come online, then send the task via relay.
-     * Uses the wrapper's own relay client so the message comes "from" this agent,
-     * not from the dashboard's relay client.
-     */
-    private waitAndSendTask;
-    /**
-     * Execute release via API or callback.
-     * Overrides BaseWrapper to add PTY-specific logging and API path.
-     */
-    protected executeRelease(name: string): Promise<void>;
-    /**
-     * Handle incoming message from relay.
-     * Extends BaseWrapper to add PTY-specific behavior.
-     */
-    protected handleIncomingMessage(from: string, payload: SendPayload, messageId: string, meta?: SendMeta, originalTo?: string): void;
-    /**
-     * Handle incoming channel message from relay.
-     * Extends BaseWrapper to add PTY-specific queue processing.
-     */
-    protected handleIncomingChannelMessage(from: string, channel: string, body: string, envelope: import('../protocol/types.js').Envelope<import('../protocol/channels.js').ChannelMessagePayload>): void;
-    /**
-     * Wait for output to stabilize before injection.
-     * Uses UniversalIdleDetector (from BaseWrapper) for robust cross-CLI idle detection.
-     * Returns true if agent is idle and ready for input.
-     */
-    private waitForOutputStable;
-    /**
-     * Check if the agent process is still alive and responsive.
-     */
-    private isAgentAlive;
-    /**
-     * Process queued messages with reliability improvements:
-     * 1. Wait for output stability before injection
-     * 2. Verify injection appeared in output
-     * 3. Retry with backoff on failure
-     * 4. Fall back to logging on complete failure
-     *
-     * Uses shared injection logic with PTY-specific callbacks.
-     */
-    private processMessageQueue;
-    /**
-     * Queue minimal agent identity notification as the first message.
-     *
-     * Full protocol instructions are in ~/.claude/CLAUDE.md (set up by entrypoint.sh).
-     * We only inject a brief identity message here to let the agent know its name
-     * and that it's connected to the relay.
-     */
-    private injectInstructions;
-    /**
-     * Write directly to the PTY
-     */
-    write(data: string): void;
-    /**
-     * Get captured output lines
-     */
-    getOutput(limit?: number): string[];
-    /**
-     * Get raw output buffer
-     */
-    getRawOutput(): string;
-    /**
-     * Stop the agent process
-     */
-    stop(): Promise<void>;
-    /**
-     * Kill the process immediately
-     */
-    kill(): Promise<void>;
-    /**
-     * Close the log file stream
-     */
-    private closeLogStream;
-    get pid(): number | undefined;
-    get logPath(): string | undefined;
-    /**
-     * Track significant outputs and inject summary reminder if needed.
-     * Works with any CLI (Claude, Gemini, Codex, etc.)
-     */
-    private trackOutputAndRemind;
-    /**
-     * Check for [[SUMMARY]] blocks and emit 'summary' event.
-     * Allows cloud services to persist summaries without hardcoding storage.
-     * Also updates the local continuity ledger for session recovery.
-     */
-    private checkForSummaryAndEmit;
-    /**
-     * Check for [[SESSION_END]] blocks and emit 'session-end' event.
-     * Allows cloud services to handle session closure without hardcoding storage.
-     * Also stores the data for use in autoSave to populate handoff.
-     */
-    private checkForSessionEndAndEmit;
-    /**
-     * Check for auth revocation patterns in output.
-     * Detects when the CLI's OAuth session has been revoked (e.g., user logged in elsewhere).
-     * Emits 'auth_revoked' event and sends notification to relay daemon.
-     */
-    private checkAuthRevocation;
-    /**
-     * Reset auth state (e.g., after re-authentication)
-     */
-    resetAuthState(): void;
-    /**
-     * Check if auth has been revoked
-     */
-    isAuthRevoked(): boolean;
-}
-//# sourceMappingURL=pty-wrapper.d.ts.map