@rallycry/conveyor-agent 8.12.0 → 9.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _project_shared from '@project/shared';
-import { AgentSessionServiceMethods, AgentMode, AgentQuestion, AgentRunnerStatus, TagAuditRunnerRequest, TaskAuditRunnerRequest, DebugTelemetryEvent, DebugSessionSummary } from '@project/shared';
+import { AgentSessionServiceMethods, AgentMode, AgentQuestion, AgentRunnerStatus } from '@project/shared';
 export * from '@project/shared';
 import { ChildProcess } from 'node:child_process';
 
@@ -71,7 +71,13 @@ declare class AgentConnection {
     constructor(config: AgentConnectionConfig);
     get sessionId(): string;
     get connected(): boolean;
+    private static readonly CALL_CONNECT_WAIT_MS;
+    private static readonly CALL_ACK_TIMEOUT_MS;
     call<M extends keyof AgentSessionServiceMethods>(method: M, payload: AgentSessionServiceMethods[M]["payload"]): Promise<AgentSessionServiceMethods[M]["response"]>;
+    /** Resolve once `socket` reports connected, or reject after `timeoutMs`. */
+    private waitForConnected;
+    /** Emit an RPC and resolve on ack, rejecting if no ack arrives in time. */
+    private emitWithAck;
     connect(): Promise<void>;
     disconnect(): void;
     private static readonly RECONNECT_BASE_DELAY_MS;
@@ -249,8 +255,6 @@ interface LifecycleCallbacks {
     onTokenRefresh: () => void;
     onGitFlush: () => void;
 }
-/** 30 min idle, 60 min dormant, 30s heartbeat, 45 min token refresh, 2 min git flush */
-declare const DEFAULT_LIFECYCLE_CONFIG: LifecycleConfig;
 declare class Lifecycle {
     readonly config: LifecycleConfig;
     private readonly callbacks;
@@ -468,136 +472,6 @@ interface AgentRunnerCallbacks {
     onStatusChange: (status: string) => void | Promise<void>;
 }
 
-interface ProjectConnectionConfig {
-    apiUrl: string;
-    projectToken: string;
-    projectId: string;
-}
-interface TaskAssignment {
-    taskId: string;
-    taskToken: string;
-    sessionId?: string;
-    apiUrl: string;
-    mode: string;
-    branch: string;
-    devBranch: string;
-    useWorktree?: boolean;
-    isAuto?: boolean;
-    useSandbox?: boolean;
-    agentMode?: string;
-    pty?: boolean;
-    /**
-     * Decrypted Claude Code subscription token (`CLAUDE_CODE_OAUTH_TOKEN`) for the
-     * assigning user, resolved server-side. Forwarded into the forked child's env
-     * so the `claude` CLI is authenticated without a login prompt. Absent when the
-     * user has no key configured — the child then falls back to the runner
-     * machine's own `~/.claude` login.
-     */
-    claudeCodeOauthToken?: string;
-}
-interface IncomingChatMessage {
-    content: string;
-    userId: string;
-    chatId?: string;
-    projectId: string;
-    /** When set, only the runner whose session matches should react. Other
-     *  runners on the same project room must ignore the message. */
-    targetSessionId?: string | null;
-    timestamp: string;
-}
-interface SwitchBranchRequest {
-    branch: string;
-    syncAfter?: boolean;
-}
-declare class ProjectConnection {
-    private socket;
-    private readonly config;
-    private eventBuffer;
-    private flushTimer;
-    private reconnectCallbacks;
-    constructor(config: ProjectConnectionConfig);
-    get projectId(): string;
-    get connected(): boolean;
-    call<M extends keyof AgentSessionServiceMethods>(method: M, payload: AgentSessionServiceMethods[M]["payload"], opts?: {
-        timeoutMs?: number;
-    }): Promise<AgentSessionServiceMethods[M]["response"]>;
-    connect(): Promise<void>;
-    disconnect(): void;
-    onReconnect(callback: () => void): void;
-    onTaskAssignment(callback: (assignment: TaskAssignment) => void): void;
-    onStopTask(callback: (data: {
-        taskId: string;
-    }) => void): void;
-    onShutdown(callback: () => void): void;
-    onDisconnect(callback: () => void): void;
-    onChatMessage(callback: (msg: IncomingChatMessage) => void): void;
-    onSwitchBranch(callback: (data: SwitchBranchRequest, cb: (res: {
-        ok: boolean;
-        error?: string;
-    }) => void) => void): void;
-    onSyncEnvironment(callback: (cb: (res: {
-        ok: boolean;
-        error?: string;
-    }) => void) => void): void;
-    onRestartStartCommand(callback: (cb: (res: {
-        ok: boolean;
-        error?: string;
-    }) => void) => void): void;
-    onAuditTags(callback: (request: TagAuditRunnerRequest) => void): void;
-    onAuditTasks(callback: (request: TaskAuditRunnerRequest) => void): void;
-    sendHeartbeat(): void;
-    sendEvent(event: Record<string, unknown>): void;
-    emitStatus(status: "busy" | "idle"): void;
-    emitTaskStarted(taskId: string): void;
-    emitTaskStopped(taskId: string, reason: string): void;
-    private flushEvents;
-    private requireSocket;
-}
-
-interface ProjectRunnerConfig {
-    conveyorApiUrl: string;
-    projectToken: string;
-    projectId: string;
-    projectDir: string;
-}
-declare class ProjectRunner {
-    private connection;
-    private projectDir;
-    private activeAgents;
-    private heartbeatTimer;
-    private stopping;
-    private resolveLifecycle;
-    private chatSessionIds;
-    /** ProjectCodespaceSession id assigned at register time. Used to filter
-     *  targeted incoming chat messages so we only react to ones addressed
-     *  to this specific runner. */
-    private projectSessionId;
-    private startCmd;
-    private setupComplete;
-    private branchSwitchCommand;
-    private commitWatcher;
-    constructor(config: ProjectRunnerConfig);
-    start(): Promise<void>;
-    /** Best-effort WIP commit + push of every tracked working tree on shutdown.
-     *  Iterates the main project dir plus any active agent worktrees so nothing
-     *  pending is lost when the pod is killed. Never throws.
-     *
-     *  Callers that kill child agents first must snapshot the worktree dirs
-     *  BEFORE the kill — the child exit handler removes entries from
-     *  `activeAgents`, so reading it after the kill misses the worktrees. */
-    flushGitOnShutdown(dirs?: Set<string>): Promise<void>;
-    stop(): Promise<void>;
-    /** Idempotent final step: tear down the socket and resolve the lifecycle
-     *  promise so start() returns. Called from stop()'s finally and from the
-     *  shutdown watchdog. */
-    private finishShutdown;
-    private wireEventHandlers;
-    private handleReconnect;
-    private handleAuditTags;
-    private handleAuditTasks;
-    private getCurrentBranch;
-}
-
 declare class PlanSync {
     private planFileSnapshot;
     private lockedPlanFile;
@@ -611,62 +485,6 @@ declare class PlanSync {
     syncPlanFile(): Promise<void>;
 }
 
-interface CacheEntry {
-    content: Buffer;
-    mimeType: string;
-    fileName: string;
-    createdAt: number;
-    size: number;
-}
-declare class FileCache {
-    private cache;
-    private currentSize;
-    private readonly maxSizeBytes;
-    private readonly ttlMs;
-    constructor(maxSizeBytes?: number, ttlMs?: number);
-    get(fileId: string): CacheEntry | null;
-    set(fileId: string, content: Buffer, mimeType: string, fileName: string): void;
-    private delete;
-    clear(): void;
-    get stats(): {
-        entries: number;
-        sizeBytes: number;
-        maxSizeBytes: number;
-    };
-}
-
-interface CommitWatcherConfig {
-    projectDir: string;
-    pollIntervalMs: number;
-    debounceMs: number;
-}
-interface NewCommitsData {
-    branch: string;
-    previousSha: string;
-    newCommitSha: string;
-    commitCount: number;
-    latestMessage: string;
-    latestAuthor: string;
-}
-interface CommitWatcherCallbacks {
-    onNewCommits: (data: NewCommitsData) => Promise<void>;
-}
-declare class CommitWatcher {
-    private config;
-    private callbacks;
-    private interval;
-    private lastKnownRemoteSha;
-    private branch;
-    private debounceTimer;
-    private isSyncing;
-    constructor(config: CommitWatcherConfig, callbacks: CommitWatcherCallbacks);
-    start(branch: string): void;
-    stop(): void;
-    private getLocalHeadSha;
-    private poll;
-    private handleNewCommits;
-}
-
 /** Returns true if the working tree has uncommitted changes (staged or unstaged). */
 declare function hasUncommittedChanges(cwd: string): boolean;
 /** Returns the current branch name, or null if on detached HEAD. */
@@ -706,316 +524,6 @@ declare function detachWorktreeBranch(projectDir: string, branch: string): void;
  */
 declare function removeWorktree(projectDir: string, taskId: string): void;
 
-interface BreakpointInfo {
-    breakpointId: string;
-    file: string;
-    line: number;
-    condition?: string;
-}
-interface ProbeInfo {
-    probeId: string;
-    breakpointId: string;
-    file: string;
-    line: number;
-    expressions: string[];
-    label: string;
-}
-interface ProbeHit {
-    label: string;
-    data: Record<string, unknown>;
-    timestamp: number;
-}
-interface CallFrameInfo {
-    index: number;
-    functionName: string;
-    file: string;
-    line: number;
-    column: number;
-    callFrameId: string;
-}
-interface ScopeVariable {
-    name: string;
-    type: string;
-    value: string;
-}
-interface PausedState {
-    callFrames: CallFrameInfo[];
-    reason: string;
-    hitBreakpoints?: string[];
-}
-type InspectorProtocol = "cdp" | "webkit";
-declare class CdpDebugClient {
-    private ws;
-    private requestId;
-    private pendingRequests;
-    private breakpoints;
-    private probes;
-    private probeCounter;
-    private probeBufferInjected;
-    private pausedState;
-    private autoResumeTimer;
-    private protocol;
-    private onPausedCallback;
-    private onResumedCallback;
-    private onAutoResumedCallback;
-    connect(wsUrl: string, protocol?: InspectorProtocol): Promise<void>;
-    disconnect(): void;
-    isConnected(): boolean;
-    getProtocol(): InspectorProtocol;
-    setBreakpoint(file: string, line: number, condition?: string): Promise<string>;
-    removeBreakpoint(breakpointId: string): Promise<void>;
-    removeAllBreakpoints(): Promise<void>;
-    listBreakpoints(): BreakpointInfo[];
-    setLogpoint(file: string, line: number, expressions: string[], label?: string): Promise<string>;
-    removeProbe(probeId: string): Promise<void>;
-    listProbes(): ProbeInfo[];
-    getProbeResults(label?: string, limit?: number): Promise<ProbeHit[]>;
-    clearProbeResults(label?: string): Promise<void>;
-    isPaused(): boolean;
-    getPausedState(): PausedState | null;
-    getCallStack(): CallFrameInfo[];
-    getScopeVariables(callFrameId: string): Promise<ScopeVariable[]>;
-    resume(): Promise<void>;
-    stepOver(): Promise<void>;
-    stepInto(): Promise<void>;
-    evaluate(expression: string, callFrameId?: string): Promise<{
-        type: string;
-        value: string;
-    }>;
-    onPaused(callback: (state: PausedState) => void): void;
-    onResumed(callback: () => void): void;
-    onAutoResumed(callback: () => void): void;
-    private send;
-    private handleMessage;
-    private handlePaused;
-    private ensureProbeBuffer;
-    private extractEvalError;
-    private fileToUrlRegex;
-    private formatRemoteObject;
-    private truncateValue;
-    private clearAutoResumeTimer;
-    private cleanup;
-}
-
-interface ConsoleMessage {
-    level: string;
-    text: string;
-    timestamp: number;
-    url?: string;
-    line?: number;
-}
-interface NetworkRequest {
-    url: string;
-    method: string;
-    status?: number;
-    resourceType?: string;
-    timestamp: number;
-    duration?: number;
-}
-interface ClientPageError {
-    message: string;
-    stack?: string;
-    timestamp: number;
-}
-
-declare class PlaywrightDebugClient {
-    private browser;
-    private page;
-    private cdpSession;
-    private breakpoints;
-    private probes;
-    private probeCounter;
-    private probeBufferInjected;
-    private pausedState;
-    private autoResumeTimer;
-    private inactivityTimer;
-    private onPausedCallback;
-    private onResumedCallback;
-    private onAutoResumedCallback;
-    private consoleMessages;
-    private networkRequests;
-    private pageErrors;
-    private sourceMapDetected;
-    launch(previewUrl: string): Promise<void>;
-    close(): Promise<void>;
-    isConnected(): boolean;
-    hasSourceMaps(): boolean | null;
-    setBreakpoint(file: string, line: number, condition?: string): Promise<string>;
-    removeBreakpoint(breakpointId: string): Promise<void>;
-    removeAllBreakpoints(): Promise<void>;
-    listBreakpoints(): BreakpointInfo[];
-    setLogpoint(file: string, line: number, expressions: string[], label?: string): Promise<string>;
-    removeProbe(probeId: string): Promise<void>;
-    listProbes(): ProbeInfo[];
-    getProbeResults(label?: string, limit?: number): Promise<ProbeHit[]>;
-    clearProbeResults(label?: string): Promise<void>;
-    isPaused(): boolean;
-    getPausedState(): PausedState | null;
-    getCallStack(): CallFrameInfo[];
-    getScopeVariables(callFrameId: string): Promise<ScopeVariable[]>;
-    resume(): Promise<void>;
-    stepOver(): Promise<void>;
-    stepInto(): Promise<void>;
-    evaluate(expression: string, callFrameId?: string): Promise<{
-        type: string;
-        value: string;
-    }>;
-    navigate(url: string): Promise<void>;
-    click(selector: string): Promise<void>;
-    screenshot(): Promise<string>;
-    getCurrentUrl(): string;
-    getConsoleMessages(level?: string, limit?: number): ConsoleMessage[];
-    getNetworkRequests(filter?: string, limit?: number): NetworkRequest[];
-    getPageErrors(limit?: number): ClientPageError[];
-    onPaused(callback: (state: PausedState) => void): void;
-    onResumed(callback: () => void): void;
-    onAutoResumed(callback: () => void): void;
-    private setupCdpEvents;
-    private handlePaused;
-    private setupPassiveCapture;
-    private checkSourceMaps;
-    private ensureProbeBuffer;
-    private requireSession;
-    private requirePage;
-    private fileToUrlRegex;
-    private clearAutoResumeTimer;
-    private resetInactivityTimer;
-    private clearInactivityTimer;
-}
-
-type InspectorRuntime = "node" | "bun" | "unknown";
-interface DebugEventHandler {
-    onDebugModeEntered: () => void;
-    onDebugModeExited: () => void;
-    onBreakpointHit: (state: PausedState) => void;
-    onClientBreakpointHit: (state: PausedState) => void;
-    onAutoResumed: () => void;
-    onDebugError: (message: string) => void;
-    onOutput: (stream: "stdout" | "stderr", data: string) => void;
-}
-interface DebugModeOptions {
-    serverSide?: boolean;
-    clientSide?: boolean;
-    previewUrl?: string;
-}
-declare class DebugManager {
-    private cdpClient;
-    private playwrightClient;
-    private debugProcess;
-    private _isDebugMode;
-    private _isClientDebugMode;
-    private startCommand;
-    private workingDir;
-    private eventHandler;
-    private breakpointHitQueue;
-    private clientBreakpointHitQueue;
-    constructor(startCommand: string, workingDir: string, eventHandler: DebugEventHandler);
-    isDebugMode(): boolean;
-    isClientDebugMode(): boolean;
-    getClient(): CdpDebugClient | null;
-    getPlaywrightClient(): PlaywrightDebugClient | null;
-    drainBreakpointHitQueue(): PausedState[];
-    drainClientBreakpointHitQueue(): PausedState[];
-    enterDebugMode(killCurrentProcess?: () => void, options?: DebugModeOptions): Promise<void>;
-    exitDebugMode(restartNormalServer?: () => void): Promise<void>;
-    private activateServerDebug;
-    private activateClientDebug;
-    private ensurePlaywrightInstalled;
-    private startWithInspector;
-}
-declare function detectRuntime(startCommand: string): InspectorRuntime;
-declare function injectBunInspectFlag(command: string): string;
-
-/**
- * Orchestrates the debug session lifecycle, tracks state for the web UI,
- * and generates session summaries. Wraps DebugManager events and forwards
- * state changes to the API via AgentConnection.
- */
-declare class DebugLifecycleManager {
-    private connection;
-    private debugManager;
-    private hypothesis?;
-    private sessionStartedAt?;
-    private breakpointsHitCount;
-    private telemetryEvents;
-    private reproduceRequested;
-    private keyFindings;
-    private _isActive;
-    constructor(connection: AgentConnection);
-    get isActive(): boolean;
-    setDebugManager(manager: DebugManager): void;
-    /**
-     * Creates a DebugEventHandler that bridges DebugManager events
-     * to the lifecycle manager and broadcasts state to the web UI.
-     */
-    createEventHandler(baseOnOutput: (stream: "stdout" | "stderr", data: string) => void): DebugEventHandler;
-    /** Mark the hypothesis for the current debug session */
-    setHypothesis(hypothesis: string): void;
-    /** Signal that the user has been asked to reproduce the bug */
-    requestReproduce(hypothesis?: string): void;
-    /** Add a telemetry event to the debug session */
-    addTelemetryEvent(event: DebugTelemetryEvent): void;
-    /** Generate and broadcast a debug session summary, then reset state */
-    completeSession(): DebugSessionSummary | null;
-    /** Auto-exit cleanup — called when agent session ends */
-    autoCleanup(): void;
-    private getBreakpoints;
-    private getProbes;
-    private buildState;
-    private broadcastState;
-}
-
-interface Observation {
-    description: string;
-    confirmsHypothesis: boolean;
-    iteration: number;
-    timestamp: number;
-}
-interface HypothesisState {
-    hypothesis: string | null;
-    iteration: number;
-    observations: Observation[];
-    active: boolean;
-    conclusion: string | null;
-}
-declare class HypothesisTracker {
-    private hypothesis;
-    private iteration;
-    private observations;
-    private _active;
-    private conclusion;
-    /**
-     * Start or update the current debugging hypothesis.
-     * Increments the iteration count if a hypothesis was already set.
-     */
-    setHypothesis(text: string): {
-        accepted: boolean;
-        message: string;
-    };
-    /**
-     * Record an observation from debug data (breakpoint hit, telemetry, etc.).
-     */
-    recordObservation(description: string, confirmsHypothesis: boolean): void;
-    /**
-     * End the debug session with a conclusion.
-     */
-    concludeSession(conclusion: string): string;
-    /**
-     * Get formatted debug context for injection into the agent's system prompt.
-     * Returns empty string if no active session.
-     */
-    getDebugContext(): string;
-    /**
-     * Get the full state (for serialization/testing).
-     */
-    getState(): HypothesisState;
-    isActive(): boolean;
-    getIteration(): number;
-    getMaxIterations(): number;
-    private getSessionSummary;
-    private reset;
-}
-
 interface ConveyorConfig {
     setupCommand?: string;
     startCommand?: string;
@@ -1039,4 +547,4 @@ declare function runStartCommand(cmd: string, cwd: string, onOutput: (stream: "s
 /** Fetch full git history if the repo was cloned with --depth=1. */
 declare function unshallowRepo(workspaceDir: string): void;
 
-export { AgentConnection, type AgentConnectionConfig, type AgentRunnerCallbacks, type AgentRunnerConfig, type ApiKeyUpdateData, CommitWatcher, type ConveyorConfig, DEFAULT_LIFECYCLE_CONFIG, type DebugEventHandler, DebugLifecycleManager, DebugManager, type DebugModeOptions, FileCache, HypothesisTracker, type IncomingMessage, type InspectorRuntime, Lifecycle, type LifecycleCallbacks, type LifecycleConfig, type ModeAction, ModeController, type ModeTaskContext, PlanSync, ProjectConnection, ProjectRunner, SessionRunner, type SessionRunnerCallbacks, type SessionRunnerConfig, type SetModeData, detachWorktreeBranch, detectRuntime, ensureWorktree, flushPendingChanges, getCurrentBranch, hasUncommittedChanges, hasUnpushedCommits, injectBunInspectFlag, loadConveyorConfig, loadForwardPorts, pushToOrigin, removeWorktree, runAuthTokenCommand, runSetupCommand, runStartCommand, stageAndCommit, unshallowRepo, updateRemoteToken };
+export { AgentConnection, type AgentConnectionConfig, type AgentRunnerCallbacks, type AgentRunnerConfig, type ApiKeyUpdateData, type ConveyorConfig, type IncomingMessage, type LifecycleCallbacks, type LifecycleConfig, type ModeAction, type ModeTaskContext, PlanSync, SessionRunner, type SessionRunnerCallbacks, type SessionRunnerConfig, type SetModeData, detachWorktreeBranch, ensureWorktree, flushPendingChanges, getCurrentBranch, hasUncommittedChanges, hasUnpushedCommits, loadConveyorConfig, loadForwardPorts, pushToOrigin, removeWorktree, runAuthTokenCommand, runSetupCommand, runStartCommand, stageAndCommit, unshallowRepo, updateRemoteToken };