@prbe.ai/electron-sdk 0.1.17 → 0.1.19

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { P as PRBEToolDeclaration, a as PRBEToolParameter, b as PRBEInteractionRequester, F as FlaggedFileIn, c as PRBEAgentState, d as PRBEAgentConfig, I as InvestigationSource, e as InteractionPayload, f as InteractionResponse, U as UserIdentifierType, g as PollResponse, T as TicketInfoOut } from './types-BmH_CmsO.mjs';
-export { A as API_URL, h as AskQuestionPayload, i as AskQuestionResponse, C as ContextRequestOut, j as ConversationEntry, k as ConversationRole, D as DEFAULT_PRBE_STATE, l as InteractionType, m as InvestigationResult, M as MIDDLEWARE_URL, n as PRBEAgentConfigKey, o as PRBEAgentError, p as PRBEAgentErrorType, q as PRBEAgentStatus, r as PRBEAgentStatusType, s as PRBECRInvestigation, t as PRBECompletedInvestigation, u as PRBEInteractionHandler, v as PRBESerializedCR, w as PRBESerializedCompletedInvestigation, x as PRBESerializedState, y as PRBESerializedTicket, z as PRBEStateEvent, B as PRBEStatusEvent, E as PollRequest, R as RequestPathAccessPayload, G as RequestPathAccessResponse, H as RequestPermissionPayload, J as RequestPermissionResponse, K as ResolveSessionsRequest, L as ResolveSessionsResponse, N as ResolvedInteraction, O as ResolvedTicketOut, Q as TicketInfoRequest, S as TicketInfoResponse, V as TicketStatusOut, W as ToolName, X as ToolParamType, Y as WSMessage, Z as WSMessageType, _ as redactPII, $ as serializePRBEState } from './types-BmH_CmsO.mjs';
+import { P as PRBEToolDeclaration, a as PRBEToolParameter, b as PRBEInteractionRequester, F as FlaggedFileIn, c as PRBEAgentState, d as PRBEAgentConfig, I as InvestigationSource, C as ConversationRole, e as InteractionPayload, f as InteractionResponse, U as UserIdentifierType, g as PollResponse, A as AgentHistoryResponse, S as SanitizedFileResult } from './types-9iQH0zmA.mjs';
+export { h as API_URL, i as AgentHistoryRequest, j as AgentSessionOut, k as AgentTicketOut, l as AskQuestionPayload, m as AskQuestionResponse, n as ContextRequestOut, o as ConversationEntry, D as DEFAULT_PRBE_STATE, E as ExternalRequestOut, p as InteractionType, q as InvestigationResult, M as MIDDLEWARE_URL, r as PRBEAgentConfigKey, s as PRBEAgentError, t as PRBEAgentErrorType, u as PRBEAgentStatus, v as PRBEAgentStatusType, w as PRBEBackgroundInvestigation, x as PRBECompletedInvestigation, y as PRBEInteractionHandler, z as PRBESerializedBackgroundInvestigation, B as PRBESerializedCompletedInvestigation, G as PRBESerializedState, H as PRBESerializedTicket, J as PRBEStateEvent, K as PRBEStatusEvent, L as PollRequest, R as RequestPathAccessPayload, N as RequestPathAccessResponse, O as RequestPermissionPayload, Q as RequestPermissionResponse, T as ResolvedInteraction, V as ReviewSanitizedOutputPayload, W as ReviewSanitizedOutputResponse, X as SanitizationIssue, Y as SanitizedFileRef, Z as TicketInfoOut, _ as ToolName, $ as ToolParamType, a0 as WSMessage, a1 as WSMessageType, a2 as redactPII, a3 as serializePRBEState } from './types-9iQH0zmA.mjs';
 import 'events';
 
-var version = "0.1.17";
+var version = "0.1.19";
 
 /**
  * tools/index.ts — Tool interface, registry, and closure tool
@@ -148,23 +148,18 @@ declare class PRBEAgent implements PRBEInteractionRequester {
     private persistedData;
     private fetchAbortController;
     private currentInvestigationSource;
-    private currentCRId;
-    private readonly historyStore;
+    private currentBackgroundId;
     /** Files flagged during the current tool call — uploaded immediately after the tool returns. */
     private pendingFlaggedFiles;
     private userEmail?;
     private userId?;
     private get agentID();
-    private get trackedSessionIDs();
-    private set trackedSessionIDs(value);
-    private syncPolling;
-    private addTrackedSession;
     constructor(config: PRBEAgentConfig);
     private hookElectronLog;
     private hookRendererLogs;
     private static mapElectronLogLevel;
     get investigationSource(): InvestigationSource;
-    sendConversationMessage(content: string): void;
+    sendConversationMessage(content: string, role?: ConversationRole, label?: string): void;
     requestUserInteraction(payload: InteractionPayload): Promise<InteractionResponse>;
     /**
      * Add an additional root directory to the runtime allowed roots.
@@ -193,12 +188,13 @@ declare class PRBEAgent implements PRBEInteractionRequester {
     registerTool(name: string, description: string, parameters: PRBEToolParameter[], handler: (args: Record<string, unknown>) => Promise<string>, options?: {
         interactive?: boolean;
     }): void;
+    private runInvestigation;
     /**
      * User-initiated investigation. Updates `state` events/report directly.
      */
     investigate(query: string, contextRequestID?: string): Promise<void>;
     /**
-     * Cancel user-initiated investigation only (does not cancel background CRs).
+     * Cancel user-initiated investigation only (does not cancel background investigations).
      */
     cancelInvestigation(): void;
     /**
@@ -206,15 +202,19 @@ declare class PRBEAgent implements PRBEInteractionRequester {
      */
     cancel(): void;
     /**
-     * Poll the backend for context requests on tracked tickets.
-     * Resolves session IDs → ticket IDs first, then polls with ticket IDs.
+     * Poll the backend for context requests and external requests.
      */
     poll(): Promise<PollResponse | null>;
     /**
-     * Fetch ticket display info for all tracked sessions.
-     * Resolves session IDs → ticket IDs first, then fetches ticket info.
+     * Fetch agent history (tickets + sessions) from the backend.
      */
-    fetchTicketInfo(): Promise<TicketInfoOut[]>;
+    fetchHistory(): Promise<AgentHistoryResponse | null>;
+    fetchSanitizedFile(url: string): Promise<SanitizedFileResult>;
+    /**
+     * Detect whether a buffer contains text by checking for null bytes
+     * and verifying the content is valid UTF-8.
+     */
+    private static isTextContent;
     stopPolling(): void;
     resumePolling(): void;
     /**
@@ -231,13 +231,13 @@ declare class PRBEAgent implements PRBEInteractionRequester {
      */
     static clearPersistedData(): void;
     private investigateForCR;
+    private investigateForER;
     private connectToProxy;
     private handleMessage;
     private extractArgs;
     private extractUploadPrefix;
     private static backgroundUpload;
     private startPolling;
-    private resolveSessions;
     /**
      * Abort all in-flight fetch requests to prevent orphaned DNS lookups
      * that can crash the c-ares resolver during process shutdown.
@@ -360,4 +360,4 @@ declare class BashExecuteTool implements PRBETool {
  */
 declare const PROBE_MARK_SVG = "<svg width=\"256\" height=\"256\" viewBox=\"0 0 256 256\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n  <path d=\"M50 112 L114 148 L50 184 Z\" fill=\"#111111\" opacity=\"0.07\"/>\n  <path d=\"M70 86 L148 134 L70 182 Z\" fill=\"#111111\" opacity=\"0.18\"/>\n  <path d=\"M92 56 L192 118 L92 180 Z\" fill=\"#111111\"/>\n</svg>";
 
-export { AskUserTool, BashExecuteTool, ClearAppLogsTool, FindFilesTool, FlagAppLogsTool, FlagFileTool, FlaggedFileIn, InteractionPayload, InteractionResponse, InvestigationSource, ListDirectoryTool, type LogEntry, PRBEAgent, PRBEAgentConfig, PRBEAgentState, PRBEClosureTool, PRBEInteractionRequester, PRBELogCapture, type PRBETool, PRBEToolDeclaration, PRBEToolParameter, PRBEToolRegistry, PROBE_MARK_SVG, PollResponse, ReadAppLogsTool, ReadFileTool, version as SDK_VERSION, SearchAppLogsTool, SearchContentTool, TicketInfoOut, UserIdentifierType, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };
+export { AgentHistoryResponse, AskUserTool, BashExecuteTool, ClearAppLogsTool, ConversationRole, FindFilesTool, FlagAppLogsTool, FlagFileTool, FlaggedFileIn, InteractionPayload, InteractionResponse, InvestigationSource, ListDirectoryTool, type LogEntry, PRBEAgent, PRBEAgentConfig, PRBEAgentState, PRBEClosureTool, PRBEInteractionRequester, PRBELogCapture, type PRBETool, PRBEToolDeclaration, PRBEToolParameter, PRBEToolRegistry, PROBE_MARK_SVG, PollResponse, ReadAppLogsTool, ReadFileTool, version as SDK_VERSION, SanitizedFileResult, SearchAppLogsTool, SearchContentTool, UserIdentifierType, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { P as PRBEToolDeclaration, a as PRBEToolParameter, b as PRBEInteractionRequester, F as FlaggedFileIn, c as PRBEAgentState, d as PRBEAgentConfig, I as InvestigationSource, e as InteractionPayload, f as InteractionResponse, U as UserIdentifierType, g as PollResponse, T as TicketInfoOut } from './types-BmH_CmsO.js';
-export { A as API_URL, h as AskQuestionPayload, i as AskQuestionResponse, C as ContextRequestOut, j as ConversationEntry, k as ConversationRole, D as DEFAULT_PRBE_STATE, l as InteractionType, m as InvestigationResult, M as MIDDLEWARE_URL, n as PRBEAgentConfigKey, o as PRBEAgentError, p as PRBEAgentErrorType, q as PRBEAgentStatus, r as PRBEAgentStatusType, s as PRBECRInvestigation, t as PRBECompletedInvestigation, u as PRBEInteractionHandler, v as PRBESerializedCR, w as PRBESerializedCompletedInvestigation, x as PRBESerializedState, y as PRBESerializedTicket, z as PRBEStateEvent, B as PRBEStatusEvent, E as PollRequest, R as RequestPathAccessPayload, G as RequestPathAccessResponse, H as RequestPermissionPayload, J as RequestPermissionResponse, K as ResolveSessionsRequest, L as ResolveSessionsResponse, N as ResolvedInteraction, O as ResolvedTicketOut, Q as TicketInfoRequest, S as TicketInfoResponse, V as TicketStatusOut, W as ToolName, X as ToolParamType, Y as WSMessage, Z as WSMessageType, _ as redactPII, $ as serializePRBEState } from './types-BmH_CmsO.js';
+import { P as PRBEToolDeclaration, a as PRBEToolParameter, b as PRBEInteractionRequester, F as FlaggedFileIn, c as PRBEAgentState, d as PRBEAgentConfig, I as InvestigationSource, C as ConversationRole, e as InteractionPayload, f as InteractionResponse, U as UserIdentifierType, g as PollResponse, A as AgentHistoryResponse, S as SanitizedFileResult } from './types-9iQH0zmA.js';
+export { h as API_URL, i as AgentHistoryRequest, j as AgentSessionOut, k as AgentTicketOut, l as AskQuestionPayload, m as AskQuestionResponse, n as ContextRequestOut, o as ConversationEntry, D as DEFAULT_PRBE_STATE, E as ExternalRequestOut, p as InteractionType, q as InvestigationResult, M as MIDDLEWARE_URL, r as PRBEAgentConfigKey, s as PRBEAgentError, t as PRBEAgentErrorType, u as PRBEAgentStatus, v as PRBEAgentStatusType, w as PRBEBackgroundInvestigation, x as PRBECompletedInvestigation, y as PRBEInteractionHandler, z as PRBESerializedBackgroundInvestigation, B as PRBESerializedCompletedInvestigation, G as PRBESerializedState, H as PRBESerializedTicket, J as PRBEStateEvent, K as PRBEStatusEvent, L as PollRequest, R as RequestPathAccessPayload, N as RequestPathAccessResponse, O as RequestPermissionPayload, Q as RequestPermissionResponse, T as ResolvedInteraction, V as ReviewSanitizedOutputPayload, W as ReviewSanitizedOutputResponse, X as SanitizationIssue, Y as SanitizedFileRef, Z as TicketInfoOut, _ as ToolName, $ as ToolParamType, a0 as WSMessage, a1 as WSMessageType, a2 as redactPII, a3 as serializePRBEState } from './types-9iQH0zmA.js';
 import 'events';
 
-var version = "0.1.17";
+var version = "0.1.19";
 
 /**
  * tools/index.ts — Tool interface, registry, and closure tool
@@ -148,23 +148,18 @@ declare class PRBEAgent implements PRBEInteractionRequester {
     private persistedData;
     private fetchAbortController;
     private currentInvestigationSource;
-    private currentCRId;
-    private readonly historyStore;
+    private currentBackgroundId;
     /** Files flagged during the current tool call — uploaded immediately after the tool returns. */
     private pendingFlaggedFiles;
     private userEmail?;
     private userId?;
     private get agentID();
-    private get trackedSessionIDs();
-    private set trackedSessionIDs(value);
-    private syncPolling;
-    private addTrackedSession;
     constructor(config: PRBEAgentConfig);
     private hookElectronLog;
     private hookRendererLogs;
     private static mapElectronLogLevel;
     get investigationSource(): InvestigationSource;
-    sendConversationMessage(content: string): void;
+    sendConversationMessage(content: string, role?: ConversationRole, label?: string): void;
     requestUserInteraction(payload: InteractionPayload): Promise<InteractionResponse>;
     /**
      * Add an additional root directory to the runtime allowed roots.
@@ -193,12 +188,13 @@ declare class PRBEAgent implements PRBEInteractionRequester {
     registerTool(name: string, description: string, parameters: PRBEToolParameter[], handler: (args: Record<string, unknown>) => Promise<string>, options?: {
         interactive?: boolean;
     }): void;
+    private runInvestigation;
     /**
      * User-initiated investigation. Updates `state` events/report directly.
      */
     investigate(query: string, contextRequestID?: string): Promise<void>;
     /**
-     * Cancel user-initiated investigation only (does not cancel background CRs).
+     * Cancel user-initiated investigation only (does not cancel background investigations).
      */
     cancelInvestigation(): void;
     /**
@@ -206,15 +202,19 @@ declare class PRBEAgent implements PRBEInteractionRequester {
      */
     cancel(): void;
     /**
-     * Poll the backend for context requests on tracked tickets.
-     * Resolves session IDs → ticket IDs first, then polls with ticket IDs.
+     * Poll the backend for context requests and external requests.
      */
     poll(): Promise<PollResponse | null>;
     /**
-     * Fetch ticket display info for all tracked sessions.
-     * Resolves session IDs → ticket IDs first, then fetches ticket info.
+     * Fetch agent history (tickets + sessions) from the backend.
      */
-    fetchTicketInfo(): Promise<TicketInfoOut[]>;
+    fetchHistory(): Promise<AgentHistoryResponse | null>;
+    fetchSanitizedFile(url: string): Promise<SanitizedFileResult>;
+    /**
+     * Detect whether a buffer contains text by checking for null bytes
+     * and verifying the content is valid UTF-8.
+     */
+    private static isTextContent;
     stopPolling(): void;
     resumePolling(): void;
     /**
@@ -231,13 +231,13 @@ declare class PRBEAgent implements PRBEInteractionRequester {
      */
     static clearPersistedData(): void;
     private investigateForCR;
+    private investigateForER;
     private connectToProxy;
     private handleMessage;
     private extractArgs;
     private extractUploadPrefix;
     private static backgroundUpload;
     private startPolling;
-    private resolveSessions;
     /**
      * Abort all in-flight fetch requests to prevent orphaned DNS lookups
      * that can crash the c-ares resolver during process shutdown.
@@ -360,4 +360,4 @@ declare class BashExecuteTool implements PRBETool {
  */
 declare const PROBE_MARK_SVG = "<svg width=\"256\" height=\"256\" viewBox=\"0 0 256 256\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n  <path d=\"M50 112 L114 148 L50 184 Z\" fill=\"#111111\" opacity=\"0.07\"/>\n  <path d=\"M70 86 L148 134 L70 182 Z\" fill=\"#111111\" opacity=\"0.18\"/>\n  <path d=\"M92 56 L192 118 L92 180 Z\" fill=\"#111111\"/>\n</svg>";
 
-export { AskUserTool, BashExecuteTool, ClearAppLogsTool, FindFilesTool, FlagAppLogsTool, FlagFileTool, FlaggedFileIn, InteractionPayload, InteractionResponse, InvestigationSource, ListDirectoryTool, type LogEntry, PRBEAgent, PRBEAgentConfig, PRBEAgentState, PRBEClosureTool, PRBEInteractionRequester, PRBELogCapture, type PRBETool, PRBEToolDeclaration, PRBEToolParameter, PRBEToolRegistry, PROBE_MARK_SVG, PollResponse, ReadAppLogsTool, ReadFileTool, version as SDK_VERSION, SearchAppLogsTool, SearchContentTool, TicketInfoOut, UserIdentifierType, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };
+export { AgentHistoryResponse, AskUserTool, BashExecuteTool, ClearAppLogsTool, ConversationRole, FindFilesTool, FlagAppLogsTool, FlagFileTool, FlaggedFileIn, InteractionPayload, InteractionResponse, InvestigationSource, ListDirectoryTool, type LogEntry, PRBEAgent, PRBEAgentConfig, PRBEAgentState, PRBEClosureTool, PRBEInteractionRequester, PRBELogCapture, type PRBETool, PRBEToolDeclaration, PRBEToolParameter, PRBEToolRegistry, PROBE_MARK_SVG, PollResponse, ReadAppLogsTool, ReadFileTool, version as SDK_VERSION, SanitizedFileResult, SearchAppLogsTool, SearchContentTool, UserIdentifierType, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };