@rallycry/conveyor-agent 6.0.3 → 6.0.5

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   ProjectRunner,
   createServiceLogger,
   errorMeta
-} from "./chunk-SL5MRNSI.js";
+} from "./chunk-PLSKXQTB.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SDKUserMessage } from '@anthropic-ai/claude-agent-sdk';
 import * as _project_shared from '@project/shared';
-import { AgentRunnerStatus, MultimodalBlock, ProjectEnvironmentStatus, ChatMessageResponse, TaskFileResponse, TaskContext, AgentEvent, AgentQuestion, IncomingMessagePayload, SetModePayload, AgentMode, SubtaskCreatePayload, SubtaskUpdateFields, SubtaskResponse, StartChildCloudBuildResponse, TaskLookupResponse, UpdateTaskPropertiesPayload, IconListItem, GenerateIconResponse, TaskPropertiesResponse, TriggerIdentificationResponse, ModeTransitionPayload, IncidentDTO, TaskIncidentDTO, TagAuditRunnerRequest, TagAuditRunnerResponse, TagAuditProgressActivity } from '@project/shared';
-export { AgentEvent, ChatMessage, TaskContext, TaskFileContext } from '@project/shared';
+import { AgentRunnerStatus, MultimodalBlock, ProjectEnvironmentStatus, ChatMessageResponse, TaskFileResponse, TaskContext, AgentEvent, AgentQuestion, IncomingMessagePayload, SetModePayload, AgentMode, SubtaskCreatePayload, SubtaskUpdateFields, SubtaskResponse, StartChildCloudBuildResponse, TaskLookupResponse, UpdateTaskPropertiesPayload, IconListItem, GenerateIconResponse, TaskPropertiesResponse, TriggerIdentificationResponse, ModeTransitionPayload, DebugSessionState, DebugSessionSummary, IncidentDTO, TaskIncidentDTO, TagAuditRunnerRequest, TagAuditRunnerResponse, TagAuditProgressActivity, DebugTelemetryEvent } from '@project/shared';
+export { AgentEvent, ChatMessage, DebugBreakpointHit, DebugModeEvent, TaskContext, TaskFileContext } from '@project/shared';
 import { ChildProcess } from 'node:child_process';
 
 interface AgentRunnerConfig {
@@ -213,6 +213,9 @@ declare class ConveyorConnection {
     triggerIdentification(): Promise<TriggerIdentificationResponse>;
     refreshAuthToken(): Promise<boolean>;
     emitModeTransition(payload: ModeTransitionPayload): void;
+    emitDebugStateChanged(state: DebugSessionState): void;
+    emitDebugSessionComplete(summary: DebugSessionSummary): void;
+    emitDebugReproduceRequested(hypothesis?: string): void;
     searchIncidents(status?: string, source?: string): Promise<IncidentDTO[]>;
     getTaskIncidents(taskId?: string): Promise<TaskIncidentDTO[]>;
     disconnect(): void;
@@ -422,4 +425,260 @@ declare function loadConveyorConfig(_workspaceDir?: string): ConveyorConfig | nu
 declare function runSetupCommand(cmd: string, cwd: string, onOutput: (stream: "stdout" | "stderr", data: string) => void): Promise<void>;
 declare function runStartCommand(cmd: string, cwd: string, onOutput: (stream: "stdout" | "stderr", data: string) => void): ChildProcess;
 
-export { type AgentContext, AgentRunner, type AgentRunnerCallbacks, type AgentRunnerConfig, type ChatHistoryMessage, type ConveyorConfig, ConveyorConnection, FileCache, type IncomingChatMessage, ProjectConnection, type ProjectConnectionConfig, ProjectRunner, type ProjectRunnerConfig, type TaskAssignment, ensureWorktree, loadConveyorConfig, removeWorktree, runSetupCommand, runStartCommand };
+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;
+}
+
+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;
+}
+
+/**
+ * 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 ConveyorConnection.
+ */
+declare class DebugLifecycleManager {
+    private connection;
+    private debugManager;
+    private hypothesis?;
+    private sessionStartedAt?;
+    private breakpointsHitCount;
+    private telemetryEvents;
+    private reproduceRequested;
+    private keyFindings;
+    private _isActive;
+    constructor(connection: ConveyorConnection);
+    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;
+}
+
+export { type AgentContext, AgentRunner, type AgentRunnerCallbacks, type AgentRunnerConfig, type BreakpointInfo, type CallFrameInfo, CdpDebugClient, type ChatHistoryMessage, type ConveyorConfig, ConveyorConnection, type DebugEventHandler, DebugLifecycleManager, DebugManager, FileCache, type IncomingChatMessage, type PausedState, ProjectConnection, type ProjectConnectionConfig, ProjectRunner, type ProjectRunnerConfig, type ScopeVariable, type TaskAssignment, ensureWorktree, loadConveyorConfig, removeWorktree, runSetupCommand, runStartCommand };