@prbe.ai/electron-sdk 0.1.16 → 0.1.18

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, g as PollResponse, T as TicketInfoOut } from './types-Cyfgy1uD.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, U as TicketStatusOut, V as ToolName, W as ToolParamType, X as WSMessage, Y as WSMessageType, Z as redactPII, _ as serializePRBEState } from './types-Cyfgy1uD.mjs';
+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, A as AgentHistoryResponse } from './types-BeZ2nQ9x.mjs';
+export { h as API_URL, i as AgentHistoryRequest, j as AgentSessionOut, k as AgentTicketOut, l as AskQuestionPayload, m as AskQuestionResponse, C as ContextRequestOut, n as ConversationEntry, o as ConversationRole, 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, S as ResolvedInteraction, T as TicketInfoOut, V as ToolName, W as ToolParamType, X as WSMessage, Y as WSMessageType, Z as redactPII, _ as serializePRBEState } from './types-BeZ2nQ9x.mjs';
 import 'events';
 
-var version = "0.1.16";
+var version = "0.1.18";
 
 /**
  * tools/index.ts — Tool interface, registry, and closure tool
@@ -148,15 +148,12 @@ 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;
@@ -173,18 +170,31 @@ declare class PRBEAgent implements PRBEInteractionRequester {
      * Call this to add user profile data, app version, etc. after async initialization.
      */
     updateSessionMetadata(metadata: Record<string, unknown>): void;
+    /**
+     * Set a user identifier for this agent. Persists to the backend agents table.
+     * Can be called multiple times with different types to set both email and ID.
+     * Also auto-injects user_email and/or user_id into session metadata for investigations.
+     */
+    setUserIdentifier(type: UserIdentifierType, value: string): void;
+    /**
+     * Clear user identifier(s) for this agent.
+     * Pass a specific type to clear only that identifier, or omit to clear both email and ID.
+     */
+    clearUserIdentifier(type?: UserIdentifierType): void;
+    private syncUserIdentifierToBackend;
     /**
      * Register a custom tool that the middleware can invoke during investigations.
      */
     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;
     /**
@@ -192,15 +202,13 @@ 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>;
     stopPolling(): void;
     resumePolling(): void;
     /**
@@ -217,13 +225,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.
@@ -346,4 +354,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, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };
+export { AgentHistoryResponse, 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, 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, g as PollResponse, T as TicketInfoOut } from './types-Cyfgy1uD.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, U as TicketStatusOut, V as ToolName, W as ToolParamType, X as WSMessage, Y as WSMessageType, Z as redactPII, _ as serializePRBEState } from './types-Cyfgy1uD.js';
+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, A as AgentHistoryResponse } from './types-BeZ2nQ9x.js';
+export { h as API_URL, i as AgentHistoryRequest, j as AgentSessionOut, k as AgentTicketOut, l as AskQuestionPayload, m as AskQuestionResponse, C as ContextRequestOut, n as ConversationEntry, o as ConversationRole, 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, S as ResolvedInteraction, T as TicketInfoOut, V as ToolName, W as ToolParamType, X as WSMessage, Y as WSMessageType, Z as redactPII, _ as serializePRBEState } from './types-BeZ2nQ9x.js';
 import 'events';
 
-var version = "0.1.16";
+var version = "0.1.18";
 
 /**
  * tools/index.ts — Tool interface, registry, and closure tool
@@ -148,15 +148,12 @@ 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;
@@ -173,18 +170,31 @@ declare class PRBEAgent implements PRBEInteractionRequester {
      * Call this to add user profile data, app version, etc. after async initialization.
      */
     updateSessionMetadata(metadata: Record<string, unknown>): void;
+    /**
+     * Set a user identifier for this agent. Persists to the backend agents table.
+     * Can be called multiple times with different types to set both email and ID.
+     * Also auto-injects user_email and/or user_id into session metadata for investigations.
+     */
+    setUserIdentifier(type: UserIdentifierType, value: string): void;
+    /**
+     * Clear user identifier(s) for this agent.
+     * Pass a specific type to clear only that identifier, or omit to clear both email and ID.
+     */
+    clearUserIdentifier(type?: UserIdentifierType): void;
+    private syncUserIdentifierToBackend;
     /**
      * Register a custom tool that the middleware can invoke during investigations.
      */
     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;
     /**
@@ -192,15 +202,13 @@ 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>;
     stopPolling(): void;
     resumePolling(): void;
     /**
@@ -217,13 +225,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.
@@ -346,4 +354,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, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };
+export { AgentHistoryResponse, 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, UserIdentifierType, humanReadableSize, resolveAndValidate, resolveWithAccessRequest };