@prbe.ai/electron-sdk 0.1.18 → 0.1.21

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/interactions.ts","../src/models.ts","../src/serialization.ts","../src/state.ts"],"sourcesContent":["/**\n * interactions.ts — Types for user interaction during investigations\n *\n * Defines the contract between tools (which request interactions) and\n * host apps (which present UI and collect responses).\n */\n\n// ---------------------------------------------------------------------------\n// Interaction Types\n// ---------------------------------------------------------------------------\n\nexport enum InteractionType {\n  ASK_QUESTION = \"ask_question\",\n  REQUEST_PERMISSION = \"request_permission\",\n  REQUEST_PATH_ACCESS = \"request_path_access\",\n}\n\n// ---------------------------------------------------------------------------\n// Payloads (tool → host)\n// ---------------------------------------------------------------------------\n\nexport interface AskQuestionPayload {\n  type: InteractionType.ASK_QUESTION;\n  interactionId: string;\n  question: string;\n  context?: string;\n}\n\nexport interface RequestPermissionPayload {\n  type: InteractionType.REQUEST_PERMISSION;\n  interactionId: string;\n  action: string;\n  command: string;\n  reason?: string;\n}\n\nexport interface RequestPathAccessPayload {\n  type: InteractionType.REQUEST_PATH_ACCESS;\n  interactionId: string;\n  path: string;\n  reason: string;\n}\n\nexport type InteractionPayload =\n  | AskQuestionPayload\n  | RequestPermissionPayload\n  | RequestPathAccessPayload;\n\n// ---------------------------------------------------------------------------\n// Responses (host → tool)\n// ---------------------------------------------------------------------------\n\nexport interface AskQuestionResponse {\n  type: InteractionType.ASK_QUESTION;\n  answer: string;\n}\n\nexport interface RequestPermissionResponse {\n  type: InteractionType.REQUEST_PERMISSION;\n  approved: boolean;\n}\n\nexport interface RequestPathAccessResponse {\n  type: InteractionType.REQUEST_PATH_ACCESS;\n  granted: boolean;\n}\n\nexport type InteractionResponse =\n  | AskQuestionResponse\n  | RequestPermissionResponse\n  | RequestPathAccessResponse;\n\n// ---------------------------------------------------------------------------\n// Investigation source\n// ---------------------------------------------------------------------------\n\nexport enum InvestigationSource {\n  USER = \"user\",\n  CONTEXT_REQUEST = \"context_request\",\n  EXTERNAL_REQUEST = \"external_request\",\n}\n\n// ---------------------------------------------------------------------------\n// Minimal requester interface (tools depend on this, not on PRBEAgent)\n// ---------------------------------------------------------------------------\n\nexport interface PRBEInteractionRequester {\n  requestUserInteraction(payload: InteractionPayload): Promise<InteractionResponse>;\n  sendConversationMessage(content: string): void;\n  readonly investigationSource: InvestigationSource;\n}\n\n// ---------------------------------------------------------------------------\n// Handler interface (host app implements this)\n// ---------------------------------------------------------------------------\n\nexport interface PRBEInteractionHandler {\n  handleInteraction(payload: InteractionPayload): Promise<InteractionResponse>;\n}\n\n// ---------------------------------------------------------------------------\n// Resolved interaction (question + response, for persistence)\n// ---------------------------------------------------------------------------\n\nexport interface ResolvedInteraction {\n  interactionId: string;\n  payload: InteractionPayload;\n  response: InteractionResponse;\n  /** Number of events at time of resolution — used to split thinking bubbles */\n  eventIndex: number;\n}\n","/**\n * models.ts — WSMessage, WSMessageType, tool types, config, errors\n *\n * All types must match the Swift SDK + middleware protocol exactly.\n */\n\n// ---------------------------------------------------------------------------\n// WebSocket Message Types\n// ---------------------------------------------------------------------------\n\nexport enum WSMessageType {\n  // SDK -> Middleware\n  START = \"start\",\n  TOOL_RESULT = \"tool_result\",\n  UPLOAD_REQUEST = \"upload_request\",\n  CONVERSATION_MESSAGE = \"conversation_message\",\n  CANCEL = \"cancel\",\n  PONG = \"pong\",\n  // Middleware -> SDK\n  THOUGHT = \"thought\",\n  TOOL_CALL = \"tool_call\",\n  SERVER_TOOL_CALL = \"server_tool_call\",\n  SERVER_OBSERVATION = \"server_observation\",\n  UPLOAD_URL = \"upload_url\",\n  SESSION_CONFIG = \"session_config\",\n  CONVERSATION_UPDATE = \"conversation_update\",\n  COMPLETE = \"complete\",\n  ERROR = \"error\",\n  PING = \"ping\",\n}\n\n// ---------------------------------------------------------------------------\n// Conversation\n// ---------------------------------------------------------------------------\n\nexport enum ConversationRole {\n  User = \"user\",\n  Agent = \"agent\",\n}\n\nexport interface ConversationEntry {\n  role: ConversationRole;\n  content: string;\n  label?: string;\n  ts: string;\n}\n\n// ---------------------------------------------------------------------------\n// WebSocket Message\n// ---------------------------------------------------------------------------\n\nexport interface WSMessage {\n  type: WSMessageType;\n  id?: string;\n  name?: string;\n  content?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Tool System\n// ---------------------------------------------------------------------------\n\nexport enum ToolParamType {\n  STRING = \"STRING\",\n  BOOLEAN = \"BOOLEAN\",\n  INTEGER = \"INTEGER\",\n}\n\nexport interface PRBEToolParameter {\n  name: string;\n  type: ToolParamType;\n  description: string;\n  required: boolean;\n}\n\nexport interface PRBEToolDeclaration {\n  name: string;\n  description: string;\n  parameters: PRBEToolParameter[];\n  /** When true, the middleware uses a longer timeout for this tool (user interaction required). */\n  interactive?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Tool Names (must match middleware exactly)\n// ---------------------------------------------------------------------------\n\nexport enum ToolName {\n  CLIENT_LIST_DIRECTORY = \"client_list_directory\",\n  CLIENT_READ_FILE = \"client_read_file\",\n  CLIENT_SEARCH_CONTENT = \"client_search_content\",\n  CLIENT_FIND_FILES = \"client_find_files\",\n  CLIENT_FLAG_FILE = \"client_flag_file\",\n  CLIENT_READ_APP_LOGS = \"client_read_app_logs\",\n  CLIENT_SEARCH_APP_LOGS = \"client_search_app_logs\",\n  CLIENT_CLEAR_APP_LOGS = \"client_clear_app_logs\",\n  CLIENT_FLAG_APP_LOGS = \"client_flag_app_logs\",\n  CLIENT_ASK_USER = \"client_ask_user\",\n  CLIENT_BASH_EXECUTE = \"client_bash_execute\",\n  CLIENT_MESSAGE_USER = \"client_message_user\",\n}\n\n// ---------------------------------------------------------------------------\n// User Identifier\n// ---------------------------------------------------------------------------\n\nexport enum UserIdentifierType {\n  EMAIL = \"email\",\n  ID = \"id\",\n}\n\n// ---------------------------------------------------------------------------\n// Agent Configuration\n// ---------------------------------------------------------------------------\n\nexport enum PRBEAgentConfigKey {\n  API_KEY = \"apiKey\",\n  AUTO_APPROVED_DIRS = \"autoApprovedDirs\",\n  POLLING_INTERVAL = \"pollingInterval\",\n  MAX_LOG_ENTRIES = \"maxLogEntries\",\n  CAPTURE_CONSOLE = \"captureConsole\",\n  BACKGROUND_POLLING = \"backgroundPolling\",\n  INTERACTION_HANDLER = \"interactionHandler\",\n  ELECTRON_LOG = \"electronLog\",\n  IPC_MAIN = \"ipcMain\",\n  RENDERER_LOG_CHANNEL = \"rendererLogChannel\",\n  APP_DATA_PATH = \"appDataPath\",\n  SESSION_METADATA = \"sessionMetadata\",\n}\n\nexport interface PRBEAgentConfig {\n  [PRBEAgentConfigKey.API_KEY]: string;\n  [PRBEAgentConfigKey.AUTO_APPROVED_DIRS]: string[];\n  [PRBEAgentConfigKey.POLLING_INTERVAL]?: number;       // ms, default 600_000 (10 min)\n  [PRBEAgentConfigKey.MAX_LOG_ENTRIES]?: number;         // default 10_000\n  [PRBEAgentConfigKey.CAPTURE_CONSOLE]?: boolean;        // default true\n  [PRBEAgentConfigKey.BACKGROUND_POLLING]?: boolean;     // default true\n  [PRBEAgentConfigKey.INTERACTION_HANDLER]?: import(\"./interactions\").PRBEInteractionHandler;\n  /** electron-log instance (v5) — SDK hooks into its transports to capture main-process logs */\n  [PRBEAgentConfigKey.ELECTRON_LOG]?: { hooks: { push: (hook: (...args: any[]) => any) => void } };\n  /** Electron ipcMain instance — SDK listens for renderer log forwarding */\n  [PRBEAgentConfigKey.IPC_MAIN]?: { on: (channel: string, listener: (event: any, ...args: any[]) => void) => void };\n  /** IPC channel name for renderer log forwarding (default: \"prbe-renderer-log\") */\n  [PRBEAgentConfigKey.RENDERER_LOG_CHANNEL]?: string;\n  /** Path to the application's data directory (e.g. Electron userData). Sent to the agent so it explores this directory first. */\n  [PRBEAgentConfigKey.APP_DATA_PATH]?: string;\n  /** Custom metadata included in every session submission (e.g. user profile, app version). */\n  [PRBEAgentConfigKey.SESSION_METADATA]?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Agent Status\n// ---------------------------------------------------------------------------\n\nexport enum PRBEAgentStatusType {\n  STARTED = \"started\",\n  THINKING = \"thinking\",\n  TOOL_CALL = \"tool_call\",\n  THOUGHT = \"thought\",\n  OBSERVATION = \"observation\",\n  COMPLETED = \"completed\",\n  ERROR = \"error\",\n  AWAITING_INTERACTION = \"awaiting_interaction\",\n}\n\nexport type PRBEAgentStatus =\n  | { type: PRBEAgentStatusType.STARTED }\n  | { type: PRBEAgentStatusType.THINKING }\n  | { type: PRBEAgentStatusType.TOOL_CALL; name: string; label: string }\n  | { type: PRBEAgentStatusType.THOUGHT; text: string }\n  | { type: PRBEAgentStatusType.OBSERVATION; text: string }\n  | { type: PRBEAgentStatusType.COMPLETED; report: string; ticketId?: string }\n  | { type: PRBEAgentStatusType.ERROR; message: string }\n  | { type: PRBEAgentStatusType.AWAITING_INTERACTION; interactionPayload: import(\"./interactions\").InteractionPayload };\n\n// ---------------------------------------------------------------------------\n// Investigation Result (internal)\n// ---------------------------------------------------------------------------\n\nexport interface InvestigationResult {\n  report: string;\n  ticketId?: string;\n  sessionId?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Flagged File (internal)\n// ---------------------------------------------------------------------------\n\nexport interface FlaggedFileIn {\n  originalPath: string;\n  reason?: string;\n  data: Buffer;\n  isText: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Poll Endpoint\n// ---------------------------------------------------------------------------\n\nexport interface PollRequest {\n  agent_id: string;\n}\n\nexport interface ContextRequestOut {\n  id: string;\n  query: string;\n  slug?: string;\n  ticket_id: string;\n  is_active: boolean;\n  created_at: string;\n}\n\nexport interface ExternalRequestOut {\n  id: string;\n  query: string;\n  source: string;\n  source_detail?: string;\n  is_active: boolean;\n  created_at: string;\n}\n\nexport interface PollResponse {\n  context_requests: ContextRequestOut[];\n  external_requests: ExternalRequestOut[];\n}\n\n// ---------------------------------------------------------------------------\n// Ticket Info (used by state for UI display)\n// ---------------------------------------------------------------------------\n\nexport interface TicketInfoOut {\n  ticket_id: string;\n  title: string;\n  status: string;\n  priority?: string;\n  description?: string;\n  session_count: number;\n}\n\n// ---------------------------------------------------------------------------\n// Agent History\n// ---------------------------------------------------------------------------\n\nexport interface AgentHistoryRequest {\n  agent_id: string;\n}\n\nexport interface AgentSessionOut {\n  session_id: string;\n  title: string;\n  status: string;\n  context_summary?: string;\n  created_at: string;\n}\n\nexport interface AgentTicketOut {\n  ticket_id: string;\n  title: string;\n  status: string;\n  priority?: string;\n  sessions: AgentSessionOut[];\n}\n\nexport interface AgentHistoryResponse {\n  tickets: AgentTicketOut[];\n}\n\n// ---------------------------------------------------------------------------\n// Status Events (for state tracking)\n// ---------------------------------------------------------------------------\n\nexport interface PRBEStatusEvent {\n  id: string;\n  label: string;\n  detail?: string;\n  isCompleted: boolean;\n  isExpanded: boolean;\n}\n\nexport interface PRBEBackgroundInvestigation {\n  id: string;\n  query: string;\n  slug?: string;\n  ticketId?: string;\n  source?: string;\n  sourceDetail?: string;\n  events: PRBEStatusEvent[];\n  isRunning: boolean;\n  isCompleted: boolean;\n  isFailed: boolean;\n  report: string;\n  summary?: string;\n  errorMessage?: string;\n  agentMessage?: string;\n  startedAt: Date;\n  pendingInteraction?: import(\"./interactions\").InteractionPayload;\n  resolvedInteractions?: import(\"./interactions\").ResolvedInteraction[];\n  conversationHistory: ConversationEntry[];\n}\n\n// ---------------------------------------------------------------------------\n// Completed Investigation (persisted in state for history)\n// ---------------------------------------------------------------------------\n\nexport interface PRBECompletedInvestigation {\n  id: string;\n  query: string;\n  report: string;\n  summary?: string;\n  ticketId?: string;\n  events: PRBEStatusEvent[];\n  resolvedInteractions: import(\"./interactions\").ResolvedInteraction[];\n  conversationHistory?: ConversationEntry[];\n  completedAt: Date;\n}\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\nexport enum PRBEAgentErrorType {\n  SERVER_ERROR = \"server_error\",\n  NETWORK_ERROR = \"network_error\",\n  CANCELLED = \"cancelled\",\n  MAX_ITERATIONS = \"max_iterations\",\n}\n\nexport class PRBEAgentError extends Error {\n  public readonly errorType: PRBEAgentErrorType;\n  public readonly statusCode?: number;\n\n  constructor(errorType: PRBEAgentErrorType, message: string, statusCode?: number) {\n    super(message);\n    this.name = \"PRBEAgentError\";\n    this.errorType = errorType;\n    this.statusCode = statusCode;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// PII Redactor (pass-through stub, matches Swift SDK)\n// ---------------------------------------------------------------------------\n\nexport function redactPII(text: string): string {\n  return text;\n}\n\n// ---------------------------------------------------------------------------\n// Static URLs\n// ---------------------------------------------------------------------------\n\nexport const API_URL = \"https://api.prbe.ai\";\nexport const MIDDLEWARE_URL = \"wss://middleware.prbe.ai\";\n","/**\n * serialization.ts — IPC-safe serialization of agent state\n *\n * Converts live PRBEAgentState (with Map, Date, EventEmitter) into\n * plain JSON-safe objects suitable for IPC or structured clone.\n */\n\nimport type { PRBEAgentState } from \"./state\";\nimport type {\n  PRBEStatusEvent,\n  PRBEBackgroundInvestigation,\n  TicketInfoOut,\n  AgentTicketOut,\n  ConversationEntry,\n} from \"./models\";\nimport type { InteractionPayload, ResolvedInteraction } from \"./interactions\";\n\n// ---------------------------------------------------------------------------\n// Serialized Background Investigation (Date → ISO string, safe for IPC)\n// ---------------------------------------------------------------------------\n\nexport interface PRBESerializedBackgroundInvestigation {\n  id: string;\n  query: string;\n  slug?: string;\n  ticketId?: string;\n  source?: string;\n  sourceDetail?: string;\n  events: PRBEStatusEvent[];\n  isRunning: boolean;\n  isCompleted: boolean;\n  isFailed: boolean;\n  report: string;\n  summary?: string;\n  errorMessage?: string;\n  agentMessage?: string;\n  startedAt: string; // ISO string\n  pendingInteraction?: InteractionPayload;\n  resolvedInteractions?: ResolvedInteraction[];\n  conversationHistory: ConversationEntry[];\n}\n\n// ---------------------------------------------------------------------------\n// Serialized Ticket (pass-through — already plain)\n// ---------------------------------------------------------------------------\n\nexport type PRBESerializedTicket = TicketInfoOut;\n\n// ---------------------------------------------------------------------------\n// Serialized Completed Investigation (Date → ISO string)\n// ---------------------------------------------------------------------------\n\nexport interface PRBESerializedCompletedInvestigation {\n  id: string;\n  query: string;\n  report: string;\n  summary?: string;\n  ticketId?: string;\n  events: PRBEStatusEvent[];\n  resolvedInteractions: ResolvedInteraction[];\n  conversationHistory?: ConversationEntry[];\n  completedAt: string; // ISO string\n}\n\n// ---------------------------------------------------------------------------\n// Full serialized state (no Map, Date, or EventEmitter)\n// ---------------------------------------------------------------------------\n\nexport interface PRBESerializedState {\n  isInvestigating: boolean;\n  events: PRBEStatusEvent[];\n  report: string;\n  summary?: string;\n  currentQuery: string;\n  investigationError?: string;\n  pendingInteraction?: InteractionPayload;\n  resolvedInteractions: ResolvedInteraction[];\n  agentMessage?: string;\n  conversationHistory: ConversationEntry[];\n  completedInvestigations: PRBESerializedCompletedInvestigation[];\n  activeBackgroundInvestigations: PRBESerializedBackgroundInvestigation[];\n  completedBackgroundInvestigations: PRBESerializedBackgroundInvestigation[];\n  ticketInfo: PRBESerializedTicket[];\n  agentHistory: AgentTicketOut[];\n  hasActiveWork: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Default state (used before agent initializes)\n// ---------------------------------------------------------------------------\n\nexport const DEFAULT_PRBE_STATE: PRBESerializedState = {\n  isInvestigating: false,\n  events: [],\n  report: \"\",\n  summary: \"\",\n  currentQuery: \"\",\n  resolvedInteractions: [],\n  conversationHistory: [],\n  completedInvestigations: [],\n  activeBackgroundInvestigations: [],\n  completedBackgroundInvestigations: [],\n  ticketInfo: [],\n  agentHistory: [],\n  hasActiveWork: false,\n};\n\n// ---------------------------------------------------------------------------\n// Converter: live state → IPC-safe plain object\n// ---------------------------------------------------------------------------\n\nfunction serializeBackgroundInvestigation(bg: PRBEBackgroundInvestigation): PRBESerializedBackgroundInvestigation {\n  return {\n    id: bg.id,\n    query: bg.query,\n    slug: bg.slug,\n    ticketId: bg.ticketId,\n    source: bg.source,\n    sourceDetail: bg.sourceDetail,\n    events: bg.events,\n    isRunning: bg.isRunning,\n    isCompleted: bg.isCompleted,\n    isFailed: bg.isFailed,\n    report: bg.report,\n    summary: bg.summary,\n    errorMessage: bg.errorMessage,\n    agentMessage: bg.agentMessage,\n    startedAt: bg.startedAt.toISOString(),\n    pendingInteraction: bg.pendingInteraction,\n    resolvedInteractions: bg.resolvedInteractions ?? [],\n    conversationHistory: bg.conversationHistory ?? [],\n  };\n}\n\nexport function serializePRBEState(state: PRBEAgentState): PRBESerializedState {\n  return {\n    isInvestigating: state.isInvestigating,\n    events: state.events,\n    report: state.report,\n    summary: state.summary,\n    currentQuery: state.currentQuery,\n    investigationError: state.investigationError,\n    pendingInteraction: state.pendingInteraction,\n    resolvedInteractions: state.resolvedInteractions,\n    agentMessage: state.agentMessage,\n    conversationHistory: state.conversationHistory,\n    completedInvestigations: state.completedInvestigations.map((inv) => ({\n      id: inv.id,\n      query: inv.query,\n      report: inv.report,\n      summary: inv.summary,\n      ticketId: inv.ticketId,\n      events: inv.events,\n      resolvedInteractions: inv.resolvedInteractions,\n      conversationHistory: inv.conversationHistory,\n      completedAt: inv.completedAt.toISOString(),\n    })),\n    activeBackgroundInvestigations: Array.from(state.activeBackgroundInvestigations.values()).map(serializeBackgroundInvestigation),\n    completedBackgroundInvestigations: state.completedBackgroundInvestigations.map(serializeBackgroundInvestigation),\n    ticketInfo: state.ticketInfo,\n    agentHistory: state.agentHistory,\n    hasActiveWork: state.hasActiveWork,\n  };\n}\n","/**\n * state.ts — PRBEAgentState: EventEmitter-based observable investigation state\n *\n * Mirrors PRBEAgentState.swift but uses Node.js EventEmitter instead of Combine/@Published.\n * Host apps subscribe to events for UI updates.\n */\n\nimport { EventEmitter } from \"events\";\nimport { randomUUID } from \"crypto\";\nimport type {\n  PRBEStatusEvent,\n  PRBEBackgroundInvestigation,\n  PRBECompletedInvestigation,\n  TicketInfoOut,\n  AgentTicketOut,\n  ConversationEntry,\n} from \"./models\";\nimport type { InteractionPayload, InteractionResponse, ResolvedInteraction } from \"./interactions\";\n\n// ---------------------------------------------------------------------------\n// Event types emitted by PRBEAgentState\n// ---------------------------------------------------------------------------\n\nexport enum PRBEStateEvent {\n  /** Emitted on any state change. Payload: void */\n  STATUS = \"status\",\n  /** Emitted when a new event is appended. Payload: PRBEStatusEvent */\n  EVENT = \"event\",\n  /** Emitted when investigation completes. Payload: { report: string } */\n  COMPLETE = \"complete\",\n  /** Emitted on error. Payload: { message: string } */\n  ERROR = \"error\",\n  /** Emitted when a background investigation starts. Payload: PRBEBackgroundInvestigation */\n  BACKGROUND_START = \"background-start\",\n  /** Emitted when a background investigation completes/fails. Payload: PRBEBackgroundInvestigation */\n  BACKGROUND_COMPLETE = \"background-complete\",\n  /** Emitted when tracked ticket IDs change. Payload: string[] */\n  TICKETS_CHANGED = \"tickets-changed\",\n  /** Emitted when ticket info is updated. Payload: TicketInfoOut[] */\n  TICKET_INFO = \"ticket-info\",\n  /** Emitted when an interaction is requested. Payload: InteractionPayload */\n  INTERACTION_REQUESTED = \"interaction-requested\",\n  /** Emitted when an interaction is resolved. Payload: void */\n  INTERACTION_RESOLVED = \"interaction-resolved\",\n  /** Emitted when the agent sends a message to the user. Payload: { message: string } */\n  AGENT_MESSAGE = \"agent-message\",\n}\n\n// ---------------------------------------------------------------------------\n// PRBEAgentState\n// ---------------------------------------------------------------------------\n\nexport class PRBEAgentState extends EventEmitter {\n  // User-initiated investigation\n  public isInvestigating = false;\n  public events: PRBEStatusEvent[] = [];\n  public report = \"\";\n  public summary = \"\";\n  public currentQuery = \"\";\n  public investigationError?: string;\n  public pendingInteraction?: InteractionPayload;\n  public resolvedInteractions: ResolvedInteraction[] = [];\n  public agentMessage?: string;\n  public conversationHistory: ConversationEntry[] = [];\n\n  // Completed user investigations (history)\n  public completedInvestigations: PRBECompletedInvestigation[] = [];\n\n  // Background investigations (context requests, external requests, etc.)\n  public activeBackgroundInvestigations: Map<string, PRBEBackgroundInvestigation> = new Map();\n  public completedBackgroundInvestigations: PRBEBackgroundInvestigation[] = [];\n\n  // Tracked tickets\n  public trackedSessionIDs: string[] = [];\n  public ticketInfo: TicketInfoOut[] = [];\n\n  // Agent history\n  public agentHistory: AgentTicketOut[] = [];\n\n  // Computed\n  get hasActiveWork(): boolean {\n    return this.isInvestigating || this.activeBackgroundInvestigations.size > 0;\n  }\n\n  get activeBackgroundCount(): number {\n    return this.activeBackgroundInvestigations.size;\n  }\n\n  get isActive(): boolean {\n    return this.isInvestigating || this.report.length > 0 || this.investigationError != null;\n  }\n\n  // ---------- User investigation mutations ----------\n\n  beginInvestigation(query: string): void {\n    this.isInvestigating = true;\n    this.events = [];\n    this.resolvedInteractions = [];\n    this.conversationHistory = [];\n    this.report = \"\";\n    this.summary = \"\";\n    this.currentQuery = query;\n    this.investigationError = undefined;\n    this.agentMessage = undefined;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendConversation(entry: ConversationEntry): void {\n    this.conversationHistory.push(entry);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendBackgroundConversation(backgroundId: string, entry: ConversationEntry): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.conversationHistory.push(entry);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  resetInvestigation(): void {\n    this.isInvestigating = false;\n    this.events = [];\n    this.resolvedInteractions = [];\n    this.conversationHistory = [];\n    this.report = \"\";\n    this.summary = \"\";\n    this.currentQuery = \"\";\n    this.investigationError = undefined;\n    this.pendingInteraction = undefined;\n    this.agentMessage = undefined;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendEvent(label: string, detail?: string, completed = false): void {\n    // Mark previous event as completed before adding new one\n    if (this.events.length > 0) {\n      const last = this.events[this.events.length - 1];\n      if (!last.isCompleted && !completed) {\n        last.isCompleted = true;\n      }\n    }\n    const event: PRBEStatusEvent = {\n      id: randomUUID(),\n      label,\n      detail,\n      isCompleted: completed,\n      isExpanded: false,\n    };\n    this.events.push(event);\n    this.emit(PRBEStateEvent.EVENT, event);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  attachObservation(text: string): void {\n    if (this.events.length > 0) {\n      this.events[this.events.length - 1].detail = text;\n      this.emit(PRBEStateEvent.STATUS);\n    }\n  }\n\n  completeInvestigation(report: string, ticketId?: string): void {\n    if (this.events.length > 0) {\n      this.events[this.events.length - 1].isCompleted = true;\n    }\n    this.appendEvent(\"Done\", undefined, true);\n\n    // Save to history (snapshot events + interactions before reset)\n    this.completedInvestigations.unshift({\n      id: randomUUID(),\n      query: this.currentQuery,\n      report,\n      ticketId,\n      events: [...this.events],\n      resolvedInteractions: [...this.resolvedInteractions],\n      conversationHistory: [...this.conversationHistory],\n      completedAt: new Date(),\n    });\n\n    this.report = report;\n    this.isInvestigating = false;\n    this.emit(PRBEStateEvent.COMPLETE, { report });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  failInvestigation(message: string): void {\n    this.appendEvent(`Error: ${message}`);\n    this.investigationError = message;\n    this.isInvestigating = false;\n    this.emit(PRBEStateEvent.ERROR, { message });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  // ---------- Interaction state mutations ----------\n\n  setPendingInteraction(payload: InteractionPayload): void {\n    this.pendingInteraction = payload;\n    this.emit(PRBEStateEvent.INTERACTION_REQUESTED, payload);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  clearPendingInteraction(): void {\n    this.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setBackgroundPendingInteraction(backgroundId: string, payload: InteractionPayload): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.pendingInteraction = payload;\n    this.emit(PRBEStateEvent.INTERACTION_REQUESTED, payload);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  clearBackgroundPendingInteraction(backgroundId: string): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  resolveInteraction(response: InteractionResponse): void {\n    if (!this.pendingInteraction) return;\n    this.resolvedInteractions.push({\n      interactionId: this.pendingInteraction.interactionId,\n      payload: this.pendingInteraction,\n      response,\n      eventIndex: this.events.length,\n    });\n    this.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  resolveBackgroundInteraction(backgroundId: string, response: InteractionResponse): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg || !bg.pendingInteraction) return;\n    const resolved = bg.resolvedInteractions ?? [];\n    resolved.push({\n      interactionId: bg.pendingInteraction.interactionId,\n      payload: bg.pendingInteraction,\n      response,\n      eventIndex: bg.events.length,\n    });\n    bg.resolvedInteractions = resolved;\n    bg.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setAgentMessage(message: string): void {\n    this.agentMessage = message;\n    this.emit(PRBEStateEvent.AGENT_MESSAGE, { message });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setBackgroundAgentMessage(backgroundId: string, message: string): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.agentMessage = message;\n    this.emit(PRBEStateEvent.AGENT_MESSAGE, { message });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  toggleExpansion(eventId: string): void {\n    const event = this.events.find((e) => e.id === eventId);\n    if (event) {\n      event.isExpanded = !event.isExpanded;\n      this.emit(PRBEStateEvent.STATUS);\n    }\n  }\n\n  // ---------- Background investigation state mutations ----------\n\n  beginBackgroundInvestigation(id: string, query: string, slug?: string, ticketId?: string, source?: string, sourceDetail?: string): void {\n    const bg: PRBEBackgroundInvestigation = {\n      id,\n      query,\n      slug,\n      ticketId,\n      source,\n      sourceDetail,\n      events: [],\n      conversationHistory: [],\n      resolvedInteractions: [],\n      isRunning: true,\n      isCompleted: false,\n      isFailed: false,\n      report: \"\",\n      summary: \"\",\n      startedAt: new Date(),\n    };\n    this.activeBackgroundInvestigations.set(id, bg);\n    this.emit(PRBEStateEvent.BACKGROUND_START, bg);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendBackgroundEvent(backgroundId: string, label: string, detail?: string, completed = false): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n\n    if (bg.events.length > 0) {\n      const last = bg.events[bg.events.length - 1];\n      if (!last.isCompleted && !completed) {\n        last.isCompleted = true;\n      }\n    }\n    bg.events.push({\n      id: randomUUID(),\n      label,\n      detail,\n      isCompleted: completed,\n      isExpanded: false,\n    });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  attachBackgroundObservation(backgroundId: string, text: string): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg || bg.events.length === 0) return;\n    bg.events[bg.events.length - 1].detail = text;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  completeBackgroundInvestigation(id: string, report: string): void {\n    const bg = this.activeBackgroundInvestigations.get(id);\n    if (!bg) return;\n\n    this.activeBackgroundInvestigations.delete(id);\n    if (bg.events.length > 0) {\n      bg.events[bg.events.length - 1].isCompleted = true;\n    }\n    bg.events.push({\n      id: randomUUID(),\n      label: \"Done\",\n      isCompleted: true,\n      isExpanded: false,\n    });\n    bg.isRunning = false;\n    bg.isCompleted = true;\n    bg.report = report;\n    this.completedBackgroundInvestigations.unshift(bg);\n    this.emit(PRBEStateEvent.BACKGROUND_COMPLETE, bg);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  failBackgroundInvestigation(id: string, message: string): void {\n    const bg = this.activeBackgroundInvestigations.get(id);\n    if (!bg) return;\n\n    this.activeBackgroundInvestigations.delete(id);\n    bg.events.push({\n      id: randomUUID(),\n      label: `Error: ${message}`,\n      isCompleted: false,\n      isExpanded: false,\n    });\n    bg.isRunning = false;\n    bg.isFailed = true;\n    bg.errorMessage = message;\n    this.completedBackgroundInvestigations.unshift(bg);\n    this.emit(PRBEStateEvent.BACKGROUND_COMPLETE, bg);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  // ---------- Tickets ----------\n\n  updateTrackedSessionIDs(ids: string[]): void {\n    this.trackedSessionIDs = ids;\n    this.emit(PRBEStateEvent.TICKETS_CHANGED, ids);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  updateTicketInfo(info: TicketInfoOut[]): void {\n    this.ticketInfo = info;\n    this.emit(PRBEStateEvent.TICKET_INFO, info);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  updateAgentHistory(tickets: AgentTicketOut[]): void {\n    this.agentHistory = tickets;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n}\n"],"mappings":"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","names":["InteractionType","WSMessageType","ToolParamType","ToolName","PRBEAgentConfigKey","PRBEAgentStatusType","PRBEAgentErrorType","PRBEStateEvent"]}
+{"version":3,"sources":["../src/interactions.ts","../src/models.ts","../src/serialization.ts","../src/state.ts"],"sourcesContent":["/**\n * interactions.ts — Types for user interaction during investigations\n *\n * Defines the contract between tools (which request interactions) and\n * host apps (which present UI and collect responses).\n */\n\n// ---------------------------------------------------------------------------\n// Interaction Types\n// ---------------------------------------------------------------------------\n\nexport enum InteractionType {\n  ASK_QUESTION = \"ask_question\",\n  REQUEST_PERMISSION = \"request_permission\",\n  REQUEST_PATH_ACCESS = \"request_path_access\",\n  REVIEW_SANITIZED_OUTPUT = \"review_sanitized_output\",\n}\n\n// ---------------------------------------------------------------------------\n// Payloads (tool → host)\n// ---------------------------------------------------------------------------\n\nexport interface AskQuestionPayload {\n  type: InteractionType.ASK_QUESTION;\n  interactionId: string;\n  question: string;\n  context?: string;\n}\n\nexport interface RequestPermissionPayload {\n  type: InteractionType.REQUEST_PERMISSION;\n  interactionId: string;\n  action: string;\n  command: string;\n  reason?: string;\n}\n\nexport interface RequestPathAccessPayload {\n  type: InteractionType.REQUEST_PATH_ACCESS;\n  interactionId: string;\n  path: string;\n  reason: string;\n}\n\nexport interface SanitizedFileRef {\n  key: string;\n  url: string;\n}\n\nexport interface ReviewSanitizedOutputPayload {\n  type: InteractionType.REVIEW_SANITIZED_OUTPUT;\n  interactionId: string;\n  sanitizedAnalysis: string;\n  files: SanitizedFileRef[];\n  summary: string;\n  issues: import(\"./models\").SanitizationIssue[];\n}\n\nexport type InteractionPayload =\n  | AskQuestionPayload\n  | RequestPermissionPayload\n  | RequestPathAccessPayload\n  | ReviewSanitizedOutputPayload;\n\n// ---------------------------------------------------------------------------\n// Responses (host → tool)\n// ---------------------------------------------------------------------------\n\nexport interface AskQuestionResponse {\n  type: InteractionType.ASK_QUESTION;\n  answer: string;\n}\n\nexport interface RequestPermissionResponse {\n  type: InteractionType.REQUEST_PERMISSION;\n  approved: boolean;\n}\n\nexport interface RequestPathAccessResponse {\n  type: InteractionType.REQUEST_PATH_ACCESS;\n  granted: boolean;\n}\n\nexport interface ReviewSanitizedOutputResponse {\n  type: InteractionType.REVIEW_SANITIZED_OUTPUT;\n  approved: boolean;\n  editedText?: string;\n}\n\nexport type InteractionResponse =\n  | AskQuestionResponse\n  | RequestPermissionResponse\n  | RequestPathAccessResponse\n  | ReviewSanitizedOutputResponse;\n\n// ---------------------------------------------------------------------------\n// Investigation source\n// ---------------------------------------------------------------------------\n\nexport enum InvestigationSource {\n  USER = \"user\",\n  CONTEXT_REQUEST = \"context_request\",\n  EXTERNAL_REQUEST = \"external_request\",\n}\n\n// ---------------------------------------------------------------------------\n// Minimal requester interface (tools depend on this, not on PRBEAgent)\n// ---------------------------------------------------------------------------\n\nexport interface PRBEInteractionRequester {\n  requestUserInteraction(payload: InteractionPayload): Promise<InteractionResponse>;\n  sendConversationMessage(content: string, role?: import(\"./models\").ConversationRole, label?: string): void;\n  readonly investigationSource: InvestigationSource;\n}\n\n// ---------------------------------------------------------------------------\n// Handler interface (host app implements this)\n// ---------------------------------------------------------------------------\n\nexport interface PRBEInteractionHandler {\n  handleInteraction(payload: InteractionPayload): Promise<InteractionResponse>;\n}\n\n// ---------------------------------------------------------------------------\n// Resolved interaction (question + response, for persistence)\n// ---------------------------------------------------------------------------\n\nexport interface ResolvedInteraction {\n  interactionId: string;\n  payload: InteractionPayload;\n  response: InteractionResponse;\n  /** Number of events at time of resolution — used to split thinking bubbles */\n  eventIndex: number;\n}\n","/**\n * models.ts — WSMessage, WSMessageType, tool types, config, errors\n *\n * All types must match the Swift SDK + middleware protocol exactly.\n */\n\n// ---------------------------------------------------------------------------\n// WebSocket Message Types\n// ---------------------------------------------------------------------------\n\nexport enum WSMessageType {\n  // SDK -> Middleware\n  START = \"start\",\n  TOOL_RESULT = \"tool_result\",\n  UPLOAD_REQUEST = \"upload_request\",\n  CONVERSATION_MESSAGE = \"conversation_message\",\n  CANCEL = \"cancel\",\n  PONG = \"pong\",\n  // Middleware -> SDK\n  THOUGHT = \"thought\",\n  TOOL_CALL = \"tool_call\",\n  SERVER_TOOL_CALL = \"server_tool_call\",\n  SERVER_OBSERVATION = \"server_observation\",\n  UPLOAD_URL = \"upload_url\",\n  SESSION_CONFIG = \"session_config\",\n  CONVERSATION_UPDATE = \"conversation_update\",\n  COMPLETE = \"complete\",\n  ERROR = \"error\",\n  PING = \"ping\",\n  // Privacy mode\n  PRIVACY_SANITIZING = \"privacy_sanitizing\",\n  PRIVACY_REVIEW = \"privacy_review\",\n  PRIVACY_REVIEW_RESPONSE = \"privacy_review_response\",\n}\n\n// ---------------------------------------------------------------------------\n// Conversation\n// ---------------------------------------------------------------------------\n\nexport enum ConversationRole {\n  User = \"user\",\n  Agent = \"agent\",\n}\n\nexport interface ConversationEntry {\n  role: ConversationRole;\n  content: string;\n  label?: string;\n  ts: string;\n}\n\n// ---------------------------------------------------------------------------\n// WebSocket Message\n// ---------------------------------------------------------------------------\n\nexport interface WSMessage {\n  type: WSMessageType;\n  id?: string;\n  name?: string;\n  content?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Tool System\n// ---------------------------------------------------------------------------\n\nexport enum ToolParamType {\n  STRING = \"STRING\",\n  BOOLEAN = \"BOOLEAN\",\n  INTEGER = \"INTEGER\",\n}\n\nexport interface PRBEToolParameter {\n  name: string;\n  type: ToolParamType;\n  description: string;\n  required: boolean;\n}\n\nexport interface PRBEToolDeclaration {\n  name: string;\n  description: string;\n  parameters: PRBEToolParameter[];\n  /** When true, the middleware uses a longer timeout for this tool (user interaction required). */\n  interactive?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Tool Names (must match middleware exactly)\n// ---------------------------------------------------------------------------\n\nexport enum ToolName {\n  CLIENT_LIST_DIRECTORY = \"client_list_directory\",\n  CLIENT_READ_FILE = \"client_read_file\",\n  CLIENT_SEARCH_CONTENT = \"client_search_content\",\n  CLIENT_FIND_FILES = \"client_find_files\",\n  CLIENT_FLAG_FILE = \"client_flag_file\",\n  CLIENT_READ_APP_LOGS = \"client_read_app_logs\",\n  CLIENT_SEARCH_APP_LOGS = \"client_search_app_logs\",\n  CLIENT_CLEAR_APP_LOGS = \"client_clear_app_logs\",\n  CLIENT_FLAG_APP_LOGS = \"client_flag_app_logs\",\n  CLIENT_ASK_USER = \"client_ask_user\",\n  CLIENT_BASH_EXECUTE = \"client_bash_execute\",\n  CLIENT_MESSAGE_USER = \"client_message_user\",\n  // SDK-side chat tools (proxied by middleware when supports_chat is true)\n  SDK_MESSAGE_USER = \"sdk_message_user\",\n  SDK_ASK_USER = \"sdk_ask_user\",\n}\n\n// ---------------------------------------------------------------------------\n// User Identifier\n// ---------------------------------------------------------------------------\n\nexport enum UserIdentifierType {\n  EMAIL = \"email\",\n  ID = \"id\",\n}\n\n// ---------------------------------------------------------------------------\n// Agent Configuration\n// ---------------------------------------------------------------------------\n\nexport enum PRBEAgentConfigKey {\n  API_KEY = \"apiKey\",\n  AUTO_APPROVED_DIRS = \"autoApprovedDirs\",\n  POLLING_INTERVAL = \"pollingInterval\",\n  MAX_LOG_ENTRIES = \"maxLogEntries\",\n  CAPTURE_CONSOLE = \"captureConsole\",\n  BACKGROUND_POLLING = \"backgroundPolling\",\n  INTERACTION_HANDLER = \"interactionHandler\",\n  ELECTRON_LOG = \"electronLog\",\n  IPC_MAIN = \"ipcMain\",\n  RENDERER_LOG_CHANNEL = \"rendererLogChannel\",\n  APP_DATA_PATH = \"appDataPath\",\n  SESSION_METADATA = \"sessionMetadata\",\n}\n\nexport interface PRBEAgentConfig {\n  [PRBEAgentConfigKey.API_KEY]: string;\n  [PRBEAgentConfigKey.AUTO_APPROVED_DIRS]: string[];\n  [PRBEAgentConfigKey.POLLING_INTERVAL]?: number;       // ms, default 600_000 (10 min)\n  [PRBEAgentConfigKey.MAX_LOG_ENTRIES]?: number;         // default 10_000\n  [PRBEAgentConfigKey.CAPTURE_CONSOLE]?: boolean;        // default true\n  [PRBEAgentConfigKey.BACKGROUND_POLLING]?: boolean;     // default true\n  [PRBEAgentConfigKey.INTERACTION_HANDLER]?: import(\"./interactions\").PRBEInteractionHandler;\n  /** electron-log instance (v5) — SDK hooks into its transports to capture main-process logs */\n  [PRBEAgentConfigKey.ELECTRON_LOG]?: { hooks: { push: (hook: (...args: any[]) => any) => void } };\n  /** Electron ipcMain instance — SDK listens for renderer log forwarding */\n  [PRBEAgentConfigKey.IPC_MAIN]?: { on: (channel: string, listener: (event: any, ...args: any[]) => void) => void };\n  /** IPC channel name for renderer log forwarding (default: \"prbe-renderer-log\") */\n  [PRBEAgentConfigKey.RENDERER_LOG_CHANNEL]?: string;\n  /** Path to the application's data directory (e.g. Electron userData). Sent to the agent so it explores this directory first. */\n  [PRBEAgentConfigKey.APP_DATA_PATH]?: string;\n  /** Custom metadata included in every session submission (e.g. user profile, app version). */\n  [PRBEAgentConfigKey.SESSION_METADATA]?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Sanitization Issue (received from middleware during privacy review)\n// ---------------------------------------------------------------------------\n\nexport interface SanitizationIssue {\n  type: \"pii\" | \"ngram_overlap\" | \"incomplete\";\n  detail: string;\n  severity: \"high\" | \"medium\" | \"low\";\n}\n\nexport type SanitizedFileResult =\n  | { isText: true; content: string; url: string }\n  | { isText: false; url: string };\n\n// ---------------------------------------------------------------------------\n// Agent Status\n// ---------------------------------------------------------------------------\n\nexport enum PRBEAgentStatusType {\n  STARTED = \"started\",\n  THINKING = \"thinking\",\n  TOOL_CALL = \"tool_call\",\n  THOUGHT = \"thought\",\n  OBSERVATION = \"observation\",\n  COMPLETED = \"completed\",\n  ERROR = \"error\",\n  AWAITING_INTERACTION = \"awaiting_interaction\",\n  PRIVACY_SANITIZING = \"privacy_sanitizing\",\n}\n\nexport type PRBEAgentStatus =\n  | { type: PRBEAgentStatusType.STARTED }\n  | { type: PRBEAgentStatusType.THINKING }\n  | { type: PRBEAgentStatusType.TOOL_CALL; name: string; label: string }\n  | { type: PRBEAgentStatusType.THOUGHT; text: string }\n  | { type: PRBEAgentStatusType.OBSERVATION; text: string }\n  | { type: PRBEAgentStatusType.COMPLETED; report: string; ticketId?: string }\n  | { type: PRBEAgentStatusType.ERROR; message: string }\n  | { type: PRBEAgentStatusType.AWAITING_INTERACTION; interactionPayload: import(\"./interactions\").InteractionPayload }\n  | { type: PRBEAgentStatusType.PRIVACY_SANITIZING };\n\n// ---------------------------------------------------------------------------\n// Investigation Result (internal)\n// ---------------------------------------------------------------------------\n\nexport interface InvestigationResult {\n  report: string;\n  ticketId?: string;\n  sessionId?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Flagged File (internal)\n// ---------------------------------------------------------------------------\n\nexport interface FlaggedFileIn {\n  originalPath: string;\n  reason?: string;\n  data: Buffer;\n  isText: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Poll Endpoint\n// ---------------------------------------------------------------------------\n\nexport interface PollRequest {\n  agent_id: string;\n}\n\nexport interface ContextRequestOut {\n  id: string;\n  query: string;\n  slug?: string;\n  ticket_id: string;\n  is_active: boolean;\n  created_at: string;\n}\n\nexport interface ExternalRequestOut {\n  id: string;\n  query: string;\n  source: string;\n  source_detail?: string;\n  is_active: boolean;\n  created_at: string;\n}\n\nexport interface PollResponse {\n  context_requests: ContextRequestOut[];\n  external_requests: ExternalRequestOut[];\n}\n\n// ---------------------------------------------------------------------------\n// Ticket Info (used by state for UI display)\n// ---------------------------------------------------------------------------\n\nexport interface TicketInfoOut {\n  ticket_id: string;\n  title: string;\n  status: string;\n  priority?: string;\n  description?: string;\n  session_count: number;\n}\n\n// ---------------------------------------------------------------------------\n// Agent History\n// ---------------------------------------------------------------------------\n\nexport interface AgentHistoryRequest {\n  agent_id: string;\n}\n\nexport interface AgentSessionOut {\n  session_id: string;\n  title: string;\n  status: string;\n  context_summary?: string;\n  created_at: string;\n}\n\nexport interface AgentTicketOut {\n  ticket_id: string;\n  title: string;\n  status: string;\n  priority?: string;\n  sessions: AgentSessionOut[];\n}\n\nexport interface AgentHistoryResponse {\n  tickets: AgentTicketOut[];\n}\n\n// ---------------------------------------------------------------------------\n// Status Events (for state tracking)\n// ---------------------------------------------------------------------------\n\nexport interface PRBEStatusEvent {\n  id: string;\n  label: string;\n  detail?: string;\n  isCompleted: boolean;\n  isExpanded: boolean;\n}\n\nexport interface PRBEBackgroundInvestigation {\n  id: string;\n  query: string;\n  slug?: string;\n  ticketId?: string;\n  source?: string;\n  sourceDetail?: string;\n  events: PRBEStatusEvent[];\n  isRunning: boolean;\n  isCompleted: boolean;\n  isFailed: boolean;\n  report: string;\n  summary?: string;\n  errorMessage?: string;\n  agentMessage?: string;\n  startedAt: Date;\n  pendingInteraction?: import(\"./interactions\").InteractionPayload;\n  resolvedInteractions?: import(\"./interactions\").ResolvedInteraction[];\n  conversationHistory: ConversationEntry[];\n}\n\n// ---------------------------------------------------------------------------\n// Completed Investigation (persisted in state for history)\n// ---------------------------------------------------------------------------\n\nexport interface PRBECompletedInvestigation {\n  id: string;\n  query: string;\n  report: string;\n  summary?: string;\n  ticketId?: string;\n  events: PRBEStatusEvent[];\n  resolvedInteractions: import(\"./interactions\").ResolvedInteraction[];\n  conversationHistory?: ConversationEntry[];\n  completedAt: Date;\n}\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\nexport enum PRBEAgentErrorType {\n  SERVER_ERROR = \"server_error\",\n  NETWORK_ERROR = \"network_error\",\n  CANCELLED = \"cancelled\",\n  MAX_ITERATIONS = \"max_iterations\",\n}\n\nexport class PRBEAgentError extends Error {\n  public readonly errorType: PRBEAgentErrorType;\n  public readonly statusCode?: number;\n\n  constructor(errorType: PRBEAgentErrorType, message: string, statusCode?: number) {\n    super(message);\n    this.name = \"PRBEAgentError\";\n    this.errorType = errorType;\n    this.statusCode = statusCode;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// PII Redactor (pass-through stub, matches Swift SDK)\n// ---------------------------------------------------------------------------\n\nexport function redactPII(text: string): string {\n  return text;\n}\n\n// ---------------------------------------------------------------------------\n// Static URLs\n// ---------------------------------------------------------------------------\n\nexport const API_URL = \"https://api.prbe.ai\";\nexport const MIDDLEWARE_URL = \"wss://middleware.prbe.ai\";\n","/**\n * serialization.ts — IPC-safe serialization of agent state\n *\n * Converts live PRBEAgentState (with Map, Date, EventEmitter) into\n * plain JSON-safe objects suitable for IPC or structured clone.\n */\n\nimport type { PRBEAgentState } from \"./state\";\nimport type {\n  PRBEStatusEvent,\n  PRBEBackgroundInvestigation,\n  TicketInfoOut,\n  AgentTicketOut,\n  ConversationEntry,\n} from \"./models\";\nimport type { InteractionPayload, ResolvedInteraction } from \"./interactions\";\n\n// ---------------------------------------------------------------------------\n// Serialized Background Investigation (Date → ISO string, safe for IPC)\n// ---------------------------------------------------------------------------\n\nexport interface PRBESerializedBackgroundInvestigation {\n  id: string;\n  query: string;\n  slug?: string;\n  ticketId?: string;\n  source?: string;\n  sourceDetail?: string;\n  events: PRBEStatusEvent[];\n  isRunning: boolean;\n  isCompleted: boolean;\n  isFailed: boolean;\n  report: string;\n  summary?: string;\n  errorMessage?: string;\n  agentMessage?: string;\n  startedAt: string; // ISO string\n  pendingInteraction?: InteractionPayload;\n  resolvedInteractions?: ResolvedInteraction[];\n  conversationHistory: ConversationEntry[];\n}\n\n// ---------------------------------------------------------------------------\n// Serialized Ticket (pass-through — already plain)\n// ---------------------------------------------------------------------------\n\nexport type PRBESerializedTicket = TicketInfoOut;\n\n// ---------------------------------------------------------------------------\n// Serialized Completed Investigation (Date → ISO string)\n// ---------------------------------------------------------------------------\n\nexport interface PRBESerializedCompletedInvestigation {\n  id: string;\n  query: string;\n  report: string;\n  summary?: string;\n  ticketId?: string;\n  events: PRBEStatusEvent[];\n  resolvedInteractions: ResolvedInteraction[];\n  conversationHistory?: ConversationEntry[];\n  completedAt: string; // ISO string\n}\n\n// ---------------------------------------------------------------------------\n// Full serialized state (no Map, Date, or EventEmitter)\n// ---------------------------------------------------------------------------\n\nexport interface PRBESerializedState {\n  isInvestigating: boolean;\n  isPrivacySanitizing: boolean;\n  events: PRBEStatusEvent[];\n  report: string;\n  summary?: string;\n  currentQuery: string;\n  investigationError?: string;\n  pendingInteraction?: InteractionPayload;\n  resolvedInteractions: ResolvedInteraction[];\n  agentMessage?: string;\n  conversationHistory: ConversationEntry[];\n  completedInvestigations: PRBESerializedCompletedInvestigation[];\n  activeBackgroundInvestigations: PRBESerializedBackgroundInvestigation[];\n  completedBackgroundInvestigations: PRBESerializedBackgroundInvestigation[];\n  ticketInfo: PRBESerializedTicket[];\n  agentHistory: AgentTicketOut[];\n  hasActiveWork: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Default state (used before agent initializes)\n// ---------------------------------------------------------------------------\n\nexport const DEFAULT_PRBE_STATE: PRBESerializedState = {\n  isInvestigating: false,\n  isPrivacySanitizing: false,\n  events: [],\n  report: \"\",\n  summary: \"\",\n  currentQuery: \"\",\n  resolvedInteractions: [],\n  conversationHistory: [],\n  completedInvestigations: [],\n  activeBackgroundInvestigations: [],\n  completedBackgroundInvestigations: [],\n  ticketInfo: [],\n  agentHistory: [],\n  hasActiveWork: false,\n};\n\n// ---------------------------------------------------------------------------\n// Converter: live state → IPC-safe plain object\n// ---------------------------------------------------------------------------\n\nfunction serializeBackgroundInvestigation(bg: PRBEBackgroundInvestigation): PRBESerializedBackgroundInvestigation {\n  return {\n    id: bg.id,\n    query: bg.query,\n    slug: bg.slug,\n    ticketId: bg.ticketId,\n    source: bg.source,\n    sourceDetail: bg.sourceDetail,\n    events: bg.events,\n    isRunning: bg.isRunning,\n    isCompleted: bg.isCompleted,\n    isFailed: bg.isFailed,\n    report: bg.report,\n    summary: bg.summary,\n    errorMessage: bg.errorMessage,\n    agentMessage: bg.agentMessage,\n    startedAt: bg.startedAt.toISOString(),\n    pendingInteraction: bg.pendingInteraction,\n    resolvedInteractions: bg.resolvedInteractions ?? [],\n    conversationHistory: bg.conversationHistory ?? [],\n  };\n}\n\nexport function serializePRBEState(state: PRBEAgentState): PRBESerializedState {\n  return {\n    isInvestigating: state.isInvestigating,\n    isPrivacySanitizing: state.isPrivacySanitizing,\n    events: state.events,\n    report: state.report,\n    summary: state.summary,\n    currentQuery: state.currentQuery,\n    investigationError: state.investigationError,\n    pendingInteraction: state.pendingInteraction,\n    resolvedInteractions: state.resolvedInteractions,\n    agentMessage: state.agentMessage,\n    conversationHistory: state.conversationHistory,\n    completedInvestigations: state.completedInvestigations.map((inv) => ({\n      id: inv.id,\n      query: inv.query,\n      report: inv.report,\n      summary: inv.summary,\n      ticketId: inv.ticketId,\n      events: inv.events,\n      resolvedInteractions: inv.resolvedInteractions,\n      conversationHistory: inv.conversationHistory,\n      completedAt: inv.completedAt.toISOString(),\n    })),\n    activeBackgroundInvestigations: Array.from(state.activeBackgroundInvestigations.values()).map(serializeBackgroundInvestigation),\n    completedBackgroundInvestigations: state.completedBackgroundInvestigations.map(serializeBackgroundInvestigation),\n    ticketInfo: state.ticketInfo,\n    agentHistory: state.agentHistory,\n    hasActiveWork: state.hasActiveWork,\n  };\n}\n","/**\n * state.ts — PRBEAgentState: EventEmitter-based observable investigation state\n *\n * Mirrors PRBEAgentState.swift but uses Node.js EventEmitter instead of Combine/@Published.\n * Host apps subscribe to events for UI updates.\n */\n\nimport { EventEmitter } from \"events\";\nimport { randomUUID } from \"crypto\";\nimport type {\n  PRBEStatusEvent,\n  PRBEBackgroundInvestigation,\n  PRBECompletedInvestigation,\n  TicketInfoOut,\n  AgentTicketOut,\n  ConversationEntry,\n} from \"./models\";\nimport type { InteractionPayload, InteractionResponse, ResolvedInteraction } from \"./interactions\";\n\n// ---------------------------------------------------------------------------\n// Event types emitted by PRBEAgentState\n// ---------------------------------------------------------------------------\n\nexport enum PRBEStateEvent {\n  /** Emitted on any state change. Payload: void */\n  STATUS = \"status\",\n  /** Emitted when a new event is appended. Payload: PRBEStatusEvent */\n  EVENT = \"event\",\n  /** Emitted when investigation completes. Payload: { report: string } */\n  COMPLETE = \"complete\",\n  /** Emitted on error. Payload: { message: string } */\n  ERROR = \"error\",\n  /** Emitted when a background investigation starts. Payload: PRBEBackgroundInvestigation */\n  BACKGROUND_START = \"background-start\",\n  /** Emitted when a background investigation completes/fails. Payload: PRBEBackgroundInvestigation */\n  BACKGROUND_COMPLETE = \"background-complete\",\n  /** Emitted when tracked ticket IDs change. Payload: string[] */\n  TICKETS_CHANGED = \"tickets-changed\",\n  /** Emitted when ticket info is updated. Payload: TicketInfoOut[] */\n  TICKET_INFO = \"ticket-info\",\n  /** Emitted when an interaction is requested. Payload: InteractionPayload */\n  INTERACTION_REQUESTED = \"interaction-requested\",\n  /** Emitted when an interaction is resolved. Payload: void */\n  INTERACTION_RESOLVED = \"interaction-resolved\",\n  /** Emitted when the agent sends a message to the user. Payload: { message: string } */\n  AGENT_MESSAGE = \"agent-message\",\n}\n\n// ---------------------------------------------------------------------------\n// PRBEAgentState\n// ---------------------------------------------------------------------------\n\nexport class PRBEAgentState extends EventEmitter {\n  // User-initiated investigation\n  public isInvestigating = false;\n  public events: PRBEStatusEvent[] = [];\n  public report = \"\";\n  public summary = \"\";\n  public currentQuery = \"\";\n  public investigationError?: string;\n  public pendingInteraction?: InteractionPayload;\n  public resolvedInteractions: ResolvedInteraction[] = [];\n  public agentMessage?: string;\n  public conversationHistory: ConversationEntry[] = [];\n  public isPrivacySanitizing = false;\n\n  // Completed user investigations (history)\n  public completedInvestigations: PRBECompletedInvestigation[] = [];\n\n  // Background investigations (context requests, external requests, etc.)\n  public activeBackgroundInvestigations: Map<string, PRBEBackgroundInvestigation> = new Map();\n  public completedBackgroundInvestigations: PRBEBackgroundInvestigation[] = [];\n\n  // Tracked tickets\n  public trackedSessionIDs: string[] = [];\n  public ticketInfo: TicketInfoOut[] = [];\n\n  // Agent history\n  public agentHistory: AgentTicketOut[] = [];\n\n  // Computed\n  get hasActiveWork(): boolean {\n    return this.isInvestigating || this.activeBackgroundInvestigations.size > 0;\n  }\n\n  get activeBackgroundCount(): number {\n    return this.activeBackgroundInvestigations.size;\n  }\n\n  get isActive(): boolean {\n    return this.isInvestigating || this.report.length > 0 || this.investigationError != null;\n  }\n\n  // ---------- User investigation mutations ----------\n\n  beginInvestigation(query: string): void {\n    this.isInvestigating = true;\n    this.events = [];\n    this.resolvedInteractions = [];\n    this.conversationHistory = [];\n    this.report = \"\";\n    this.summary = \"\";\n    this.currentQuery = query;\n    this.investigationError = undefined;\n    this.agentMessage = undefined;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendConversation(entry: ConversationEntry): void {\n    this.conversationHistory.push(entry);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendBackgroundConversation(backgroundId: string, entry: ConversationEntry): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.conversationHistory.push(entry);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  resetInvestigation(): void {\n    this.isInvestigating = false;\n    this.events = [];\n    this.resolvedInteractions = [];\n    this.conversationHistory = [];\n    this.report = \"\";\n    this.summary = \"\";\n    this.currentQuery = \"\";\n    this.investigationError = undefined;\n    this.pendingInteraction = undefined;\n    this.agentMessage = undefined;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendEvent(label: string, detail?: string, completed = false): void {\n    // Mark previous event as completed before adding new one\n    if (this.events.length > 0) {\n      const last = this.events[this.events.length - 1];\n      if (!last.isCompleted && !completed) {\n        last.isCompleted = true;\n      }\n    }\n    const event: PRBEStatusEvent = {\n      id: randomUUID(),\n      label,\n      detail,\n      isCompleted: completed,\n      isExpanded: false,\n    };\n    this.events.push(event);\n    this.emit(PRBEStateEvent.EVENT, event);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  attachObservation(text: string): void {\n    if (this.events.length > 0) {\n      this.events[this.events.length - 1].detail = text;\n      this.emit(PRBEStateEvent.STATUS);\n    }\n  }\n\n  completeInvestigation(report: string, ticketId?: string): void {\n    if (this.events.length > 0) {\n      this.events[this.events.length - 1].isCompleted = true;\n    }\n    this.appendEvent(\"Done\", undefined, true);\n\n    // Save to history (snapshot events + interactions before reset)\n    this.completedInvestigations.unshift({\n      id: randomUUID(),\n      query: this.currentQuery,\n      report,\n      ticketId,\n      events: [...this.events],\n      resolvedInteractions: [...this.resolvedInteractions],\n      conversationHistory: [...this.conversationHistory],\n      completedAt: new Date(),\n    });\n\n    this.report = report;\n    this.isInvestigating = false;\n    this.isPrivacySanitizing = false;\n    this.emit(PRBEStateEvent.COMPLETE, { report });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  failInvestigation(message: string): void {\n    this.appendEvent(`Error: ${message}`);\n    this.investigationError = message;\n    this.isInvestigating = false;\n    this.isPrivacySanitizing = false;\n    this.emit(PRBEStateEvent.ERROR, { message });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setPrivacySanitizing(value: boolean): void {\n    this.isPrivacySanitizing = value;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  // ---------- Interaction state mutations ----------\n\n  setPendingInteraction(payload: InteractionPayload): void {\n    this.pendingInteraction = payload;\n    this.emit(PRBEStateEvent.INTERACTION_REQUESTED, payload);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  clearPendingInteraction(): void {\n    this.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setBackgroundPendingInteraction(backgroundId: string, payload: InteractionPayload): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.pendingInteraction = payload;\n    this.emit(PRBEStateEvent.INTERACTION_REQUESTED, payload);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  clearBackgroundPendingInteraction(backgroundId: string): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  resolveInteraction(response: InteractionResponse): void {\n    if (!this.pendingInteraction) return;\n    this.resolvedInteractions.push({\n      interactionId: this.pendingInteraction.interactionId,\n      payload: this.pendingInteraction,\n      response,\n      eventIndex: this.events.length,\n    });\n    this.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  resolveBackgroundInteraction(backgroundId: string, response: InteractionResponse): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg || !bg.pendingInteraction) return;\n    const resolved = bg.resolvedInteractions ?? [];\n    resolved.push({\n      interactionId: bg.pendingInteraction.interactionId,\n      payload: bg.pendingInteraction,\n      response,\n      eventIndex: bg.events.length,\n    });\n    bg.resolvedInteractions = resolved;\n    bg.pendingInteraction = undefined;\n    this.emit(PRBEStateEvent.INTERACTION_RESOLVED);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setAgentMessage(message: string): void {\n    this.agentMessage = message;\n    this.emit(PRBEStateEvent.AGENT_MESSAGE, { message });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  setBackgroundAgentMessage(backgroundId: string, message: string): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n    bg.agentMessage = message;\n    this.emit(PRBEStateEvent.AGENT_MESSAGE, { message });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  toggleExpansion(eventId: string): void {\n    const event = this.events.find((e) => e.id === eventId);\n    if (event) {\n      event.isExpanded = !event.isExpanded;\n      this.emit(PRBEStateEvent.STATUS);\n    }\n  }\n\n  // ---------- Background investigation state mutations ----------\n\n  beginBackgroundInvestigation(id: string, query: string, slug?: string, ticketId?: string, source?: string, sourceDetail?: string): void {\n    const bg: PRBEBackgroundInvestigation = {\n      id,\n      query,\n      slug,\n      ticketId,\n      source,\n      sourceDetail,\n      events: [],\n      conversationHistory: [],\n      resolvedInteractions: [],\n      isRunning: true,\n      isCompleted: false,\n      isFailed: false,\n      report: \"\",\n      summary: \"\",\n      startedAt: new Date(),\n    };\n    this.activeBackgroundInvestigations.set(id, bg);\n    this.emit(PRBEStateEvent.BACKGROUND_START, bg);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  appendBackgroundEvent(backgroundId: string, label: string, detail?: string, completed = false): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg) return;\n\n    if (bg.events.length > 0) {\n      const last = bg.events[bg.events.length - 1];\n      if (!last.isCompleted && !completed) {\n        last.isCompleted = true;\n      }\n    }\n    bg.events.push({\n      id: randomUUID(),\n      label,\n      detail,\n      isCompleted: completed,\n      isExpanded: false,\n    });\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  attachBackgroundObservation(backgroundId: string, text: string): void {\n    const bg = this.activeBackgroundInvestigations.get(backgroundId);\n    if (!bg || bg.events.length === 0) return;\n    bg.events[bg.events.length - 1].detail = text;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  completeBackgroundInvestigation(id: string, report: string): void {\n    const bg = this.activeBackgroundInvestigations.get(id);\n    if (!bg) return;\n\n    this.activeBackgroundInvestigations.delete(id);\n    if (bg.events.length > 0) {\n      bg.events[bg.events.length - 1].isCompleted = true;\n    }\n    bg.events.push({\n      id: randomUUID(),\n      label: \"Done\",\n      isCompleted: true,\n      isExpanded: false,\n    });\n    bg.isRunning = false;\n    bg.isCompleted = true;\n    bg.report = report;\n    this.completedBackgroundInvestigations.unshift(bg);\n    this.emit(PRBEStateEvent.BACKGROUND_COMPLETE, bg);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  failBackgroundInvestigation(id: string, message: string): void {\n    const bg = this.activeBackgroundInvestigations.get(id);\n    if (!bg) return;\n\n    this.activeBackgroundInvestigations.delete(id);\n    bg.events.push({\n      id: randomUUID(),\n      label: `Error: ${message}`,\n      isCompleted: false,\n      isExpanded: false,\n    });\n    bg.isRunning = false;\n    bg.isFailed = true;\n    bg.errorMessage = message;\n    this.completedBackgroundInvestigations.unshift(bg);\n    this.emit(PRBEStateEvent.BACKGROUND_COMPLETE, bg);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  // ---------- Tickets ----------\n\n  updateTrackedSessionIDs(ids: string[]): void {\n    this.trackedSessionIDs = ids;\n    this.emit(PRBEStateEvent.TICKETS_CHANGED, ids);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  updateTicketInfo(info: TicketInfoOut[]): void {\n    this.ticketInfo = info;\n    this.emit(PRBEStateEvent.TICKET_INFO, info);\n    this.emit(PRBEStateEvent.STATUS);\n  }\n\n  updateAgentHistory(tickets: AgentTicketOut[]): void {\n    this.agentHistory = tickets;\n    this.emit(PRBEStateEvent.STATUS);\n  }\n}\n"],"mappings":"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","names":["InteractionType","WSMessageType","ToolParamType","ToolName","PRBEAgentConfigKey","PRBEAgentStatusType","PRBEAgentErrorType","PRBEStateEvent"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prbe.ai/electron-sdk",
-  "version": "0.1.18",
+  "version": "0.1.21",
   "description": "PRBE debug agent SDK for Electron apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,6 +31,7 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   },
   "files": [
@@ -44,6 +45,7 @@
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsup": "^8.5.1",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.1"
   }
 }