@prbe.ai/electron-sdk 0.1.16 → 0.1.18

package/dist/index.js

@@ -61,6 +61,7 @@ __export(src_exports, {
   SearchContentTool: () => SearchContentTool,
   ToolName: () => ToolName,
   ToolParamType: () => ToolParamType,
+  UserIdentifierType: () => UserIdentifierType,
   WSMessageType: () => WSMessageType,
   humanReadableSize: () => humanReadableSize,
   redactPII: () => redactPII,
@@ -71,12 +72,12 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // package.json
-var version = "0.1.16";
+var version = "0.1.18";
 
 // src/agent.ts
-var fs3 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
-var os2 = __toESM(require("os"));
+var fs2 = __toESM(require("fs"));
+var path4 = __toESM(require("path"));
+var os = __toESM(require("os"));
 var import_crypto5 = require("crypto");
 
 // src/models.ts
@@ -125,6 +126,11 @@ var ToolName = /* @__PURE__ */ ((ToolName2) => {
   ToolName2["CLIENT_MESSAGE_USER"] = "client_message_user";
   return ToolName2;
 })(ToolName || {});
+var UserIdentifierType = /* @__PURE__ */ ((UserIdentifierType2) => {
+  UserIdentifierType2["EMAIL"] = "email";
+  UserIdentifierType2["ID"] = "id";
+  return UserIdentifierType2;
+})(UserIdentifierType || {});
 var PRBEAgentConfigKey = /* @__PURE__ */ ((PRBEAgentConfigKey3) => {
   PRBEAgentConfigKey3["API_KEY"] = "apiKey";
   PRBEAgentConfigKey3["AUTO_APPROVED_DIRS"] = "autoApprovedDirs";
@@ -259,8 +265,8 @@ var PRBEStateEvent = /* @__PURE__ */ ((PRBEStateEvent2) => {
   PRBEStateEvent2["EVENT"] = "event";
   PRBEStateEvent2["COMPLETE"] = "complete";
   PRBEStateEvent2["ERROR"] = "error";
-  PRBEStateEvent2["CR_START"] = "cr-start";
-  PRBEStateEvent2["CR_COMPLETE"] = "cr-complete";
+  PRBEStateEvent2["BACKGROUND_START"] = "background-start";
+  PRBEStateEvent2["BACKGROUND_COMPLETE"] = "background-complete";
   PRBEStateEvent2["TICKETS_CHANGED"] = "tickets-changed";
   PRBEStateEvent2["TICKET_INFO"] = "ticket-info";
   PRBEStateEvent2["INTERACTION_REQUESTED"] = "interaction-requested";
@@ -282,18 +288,20 @@ var PRBEAgentState = class extends import_events.EventEmitter {
   conversationHistory = [];
   // Completed user investigations (history)
   completedInvestigations = [];
-  // Background context requests
-  activeCRs = /* @__PURE__ */ new Map();
-  completedCRs = [];
+  // Background investigations (context requests, external requests, etc.)
+  activeBackgroundInvestigations = /* @__PURE__ */ new Map();
+  completedBackgroundInvestigations = [];
   // Tracked tickets
   trackedSessionIDs = [];
   ticketInfo = [];
+  // Agent history
+  agentHistory = [];
   // Computed
   get hasActiveWork() {
-    return this.isInvestigating || this.activeCRs.size > 0;
+    return this.isInvestigating || this.activeBackgroundInvestigations.size > 0;
   }
-  get activeCRCount() {
-    return this.activeCRs.size;
+  get activeBackgroundCount() {
+    return this.activeBackgroundInvestigations.size;
   }
   get isActive() {
     return this.isInvestigating || this.report.length > 0 || this.investigationError != null;
@@ -315,6 +323,12 @@ var PRBEAgentState = class extends import_events.EventEmitter {
     this.conversationHistory.push(entry);
     this.emit("status" /* STATUS */);
   }
+  appendBackgroundConversation(backgroundId, entry) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg) return;
+    bg.conversationHistory.push(entry);
+    this.emit("status" /* STATUS */);
+  }
   resetInvestigation() {
     this.isInvestigating = false;
     this.events = [];
@@ -390,17 +404,17 @@ var PRBEAgentState = class extends import_events.EventEmitter {
     this.emit("interaction-resolved" /* INTERACTION_RESOLVED */);
     this.emit("status" /* STATUS */);
   }
-  setCRPendingInteraction(crID, payload) {
-    const cr = this.activeCRs.get(crID);
-    if (!cr) return;
-    cr.pendingInteraction = payload;
+  setBackgroundPendingInteraction(backgroundId, payload) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg) return;
+    bg.pendingInteraction = payload;
     this.emit("interaction-requested" /* INTERACTION_REQUESTED */, payload);
     this.emit("status" /* STATUS */);
   }
-  clearCRPendingInteraction(crID) {
-    const cr = this.activeCRs.get(crID);
-    if (!cr) return;
-    cr.pendingInteraction = void 0;
+  clearBackgroundPendingInteraction(backgroundId) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg) return;
+    bg.pendingInteraction = void 0;
     this.emit("interaction-resolved" /* INTERACTION_RESOLVED */);
     this.emit("status" /* STATUS */);
   }
@@ -416,18 +430,18 @@ var PRBEAgentState = class extends import_events.EventEmitter {
     this.emit("interaction-resolved" /* INTERACTION_RESOLVED */);
     this.emit("status" /* STATUS */);
   }
-  resolveCRInteraction(crID, response) {
-    const cr = this.activeCRs.get(crID);
-    if (!cr || !cr.pendingInteraction) return;
-    const resolved = cr.resolvedInteractions ?? [];
+  resolveBackgroundInteraction(backgroundId, response) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg || !bg.pendingInteraction) return;
+    const resolved = bg.resolvedInteractions ?? [];
     resolved.push({
-      interactionId: cr.pendingInteraction.interactionId,
-      payload: cr.pendingInteraction,
+      interactionId: bg.pendingInteraction.interactionId,
+      payload: bg.pendingInteraction,
       response,
-      eventIndex: cr.events.length
+      eventIndex: bg.events.length
     });
-    cr.resolvedInteractions = resolved;
-    cr.pendingInteraction = void 0;
+    bg.resolvedInteractions = resolved;
+    bg.pendingInteraction = void 0;
     this.emit("interaction-resolved" /* INTERACTION_RESOLVED */);
     this.emit("status" /* STATUS */);
   }
@@ -436,10 +450,10 @@ var PRBEAgentState = class extends import_events.EventEmitter {
     this.emit("agent-message" /* AGENT_MESSAGE */, { message });
     this.emit("status" /* STATUS */);
   }
-  setCRAgentMessage(crID, message) {
-    const cr = this.activeCRs.get(crID);
-    if (!cr) return;
-    cr.agentMessage = message;
+  setBackgroundAgentMessage(backgroundId, message) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg) return;
+    bg.agentMessage = message;
     this.emit("agent-message" /* AGENT_MESSAGE */, { message });
     this.emit("status" /* STATUS */);
   }
@@ -450,14 +464,17 @@ var PRBEAgentState = class extends import_events.EventEmitter {
       this.emit("status" /* STATUS */);
     }
   }
-  // ---------- CR state mutations ----------
-  beginCR(id, query, slug, ticketId) {
-    const cr = {
+  // ---------- Background investigation state mutations ----------
+  beginBackgroundInvestigation(id, query, slug, ticketId, source, sourceDetail) {
+    const bg = {
       id,
       query,
       slug,
       ticketId,
+      source,
+      sourceDetail,
       events: [],
+      conversationHistory: [],
       resolvedInteractions: [],
       isRunning: true,
       isCompleted: false,
@@ -466,20 +483,20 @@ var PRBEAgentState = class extends import_events.EventEmitter {
       summary: "",
       startedAt: /* @__PURE__ */ new Date()
     };
-    this.activeCRs.set(id, cr);
-    this.emit("cr-start" /* CR_START */, cr);
+    this.activeBackgroundInvestigations.set(id, bg);
+    this.emit("background-start" /* BACKGROUND_START */, bg);
     this.emit("status" /* STATUS */);
   }
-  appendCREvent(crID, label, detail, completed = false) {
-    const cr = this.activeCRs.get(crID);
-    if (!cr) return;
-    if (cr.events.length > 0) {
-      const last = cr.events[cr.events.length - 1];
+  appendBackgroundEvent(backgroundId, label, detail, completed = false) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg) return;
+    if (bg.events.length > 0) {
+      const last = bg.events[bg.events.length - 1];
       if (!last.isCompleted && !completed) {
         last.isCompleted = true;
       }
     }
-    cr.events.push({
+    bg.events.push({
       id: (0, import_crypto.randomUUID)(),
       label,
       detail,
@@ -488,47 +505,47 @@ var PRBEAgentState = class extends import_events.EventEmitter {
     });
     this.emit("status" /* STATUS */);
   }
-  attachCRObservation(crID, text) {
-    const cr = this.activeCRs.get(crID);
-    if (!cr || cr.events.length === 0) return;
-    cr.events[cr.events.length - 1].detail = text;
+  attachBackgroundObservation(backgroundId, text) {
+    const bg = this.activeBackgroundInvestigations.get(backgroundId);
+    if (!bg || bg.events.length === 0) return;
+    bg.events[bg.events.length - 1].detail = text;
     this.emit("status" /* STATUS */);
   }
-  completeCR(id, report) {
-    const cr = this.activeCRs.get(id);
-    if (!cr) return;
-    this.activeCRs.delete(id);
-    if (cr.events.length > 0) {
-      cr.events[cr.events.length - 1].isCompleted = true;
+  completeBackgroundInvestigation(id, report) {
+    const bg = this.activeBackgroundInvestigations.get(id);
+    if (!bg) return;
+    this.activeBackgroundInvestigations.delete(id);
+    if (bg.events.length > 0) {
+      bg.events[bg.events.length - 1].isCompleted = true;
     }
-    cr.events.push({
+    bg.events.push({
       id: (0, import_crypto.randomUUID)(),
       label: "Done",
       isCompleted: true,
       isExpanded: false
     });
-    cr.isRunning = false;
-    cr.isCompleted = true;
-    cr.report = report;
-    this.completedCRs.unshift(cr);
-    this.emit("cr-complete" /* CR_COMPLETE */, cr);
+    bg.isRunning = false;
+    bg.isCompleted = true;
+    bg.report = report;
+    this.completedBackgroundInvestigations.unshift(bg);
+    this.emit("background-complete" /* BACKGROUND_COMPLETE */, bg);
     this.emit("status" /* STATUS */);
   }
-  failCR(id, message) {
-    const cr = this.activeCRs.get(id);
-    if (!cr) return;
-    this.activeCRs.delete(id);
-    cr.events.push({
+  failBackgroundInvestigation(id, message) {
+    const bg = this.activeBackgroundInvestigations.get(id);
+    if (!bg) return;
+    this.activeBackgroundInvestigations.delete(id);
+    bg.events.push({
       id: (0, import_crypto.randomUUID)(),
       label: `Error: ${message}`,
       isCompleted: false,
       isExpanded: false
     });
-    cr.isRunning = false;
-    cr.isFailed = true;
-    cr.errorMessage = message;
-    this.completedCRs.unshift(cr);
-    this.emit("cr-complete" /* CR_COMPLETE */, cr);
+    bg.isRunning = false;
+    bg.isFailed = true;
+    bg.errorMessage = message;
+    this.completedBackgroundInvestigations.unshift(bg);
+    this.emit("background-complete" /* BACKGROUND_COMPLETE */, bg);
     this.emit("status" /* STATUS */);
   }
   // ---------- Tickets ----------
@@ -542,6 +559,10 @@ var PRBEAgentState = class extends import_events.EventEmitter {
     this.emit("ticket-info" /* TICKET_INFO */, info);
     this.emit("status" /* STATUS */);
   }
+  updateAgentHistory(tickets) {
+    this.agentHistory = tickets;
+    this.emit("status" /* STATUS */);
+  }
 };
 
 // src/tools/index.ts
@@ -557,6 +578,7 @@ var InteractionType = /* @__PURE__ */ ((InteractionType2) => {
 var InvestigationSource = /* @__PURE__ */ ((InvestigationSource2) => {
   InvestigationSource2["USER"] = "user";
   InvestigationSource2["CONTEXT_REQUEST"] = "context_request";
+  InvestigationSource2["EXTERNAL_REQUEST"] = "external_request";
   return InvestigationSource2;
 })(InvestigationSource || {});
 
@@ -1764,197 +1786,20 @@ var BashExecuteTool = class {
   }
 };
 
-// src/history.ts
-var fs2 = __toESM(require("fs"));
-var path4 = __toESM(require("path"));
-var os = __toESM(require("os"));
-var crypto = __toESM(require("crypto"));
-var HKDF_SALT = Buffer.from("prbe-history-encryption-salt", "utf-8");
-var HKDF_INFO = Buffer.from("prbe-history-v1", "utf-8");
-function getAppDataDir() {
+// src/agent.ts
+function getPersistencePath() {
   const appData = process.env["APPDATA"] || (process.platform === "darwin" ? path4.join(os.homedir(), "Library", "Application Support") : path4.join(os.homedir(), ".local", "share"));
-  return path4.join(appData, "prbe-agent");
-}
-function getHistoryDir() {
-  const dir = path4.join(getAppDataDir(), "history" /* HISTORY_DIR */);
+  const dir = path4.join(appData, "prbe-agent");
   if (!fs2.existsSync(dir)) {
     fs2.mkdirSync(dir, { recursive: true });
   }
-  return dir;
-}
-function deriveKey(apiKey) {
-  return Buffer.from(
-    crypto.hkdfSync(
-      "sha256",
-      Buffer.from(apiKey, "utf-8"),
-      HKDF_SALT,
-      HKDF_INFO,
-      32 /* KEY_LENGTH */
-    )
-  );
-}
-function encrypt(plaintext, key) {
-  const iv = crypto.randomBytes(12 /* IV_LENGTH */);
-  const cipher = crypto.createCipheriv(
-    "aes-256-gcm" /* ALGORITHM */,
-    key,
-    iv,
-    { authTagLength: 16 /* AUTH_TAG_LENGTH */ }
-  );
-  const encrypted = Buffer.concat([cipher.update(plaintext, "utf-8"), cipher.final()]);
-  const authTag = cipher.getAuthTag();
-  return Buffer.concat([iv, authTag, encrypted]);
-}
-function decrypt(data, key) {
-  const iv = data.subarray(0, 12 /* IV_LENGTH */);
-  const authTag = data.subarray(
-    12 /* IV_LENGTH */,
-    12 /* IV_LENGTH */ + 16 /* AUTH_TAG_LENGTH */
-  );
-  const ciphertext = data.subarray(
-    12 /* IV_LENGTH */ + 16 /* AUTH_TAG_LENGTH */
-  );
-  const decipher = crypto.createDecipheriv(
-    "aes-256-gcm" /* ALGORITHM */,
-    key,
-    iv,
-    { authTagLength: 16 /* AUTH_TAG_LENGTH */ }
-  );
-  decipher.setAuthTag(authTag);
-  return decipher.update(ciphertext) + decipher.final("utf-8");
-}
-var HistoryStore = class {
-  key;
-  constructor(apiKey) {
-    this.key = deriveKey(apiKey);
-  }
-  load() {
-    const investigations = [];
-    const crs = [];
-    try {
-      const dir = getHistoryDir();
-      let files;
-      try {
-        files = fs2.readdirSync(dir);
-      } catch {
-        return { investigations, crs };
-      }
-      for (const filename of files) {
-        try {
-          const filePath = path4.join(dir, filename);
-          const raw = fs2.readFileSync(filePath);
-          const json = decrypt(raw, this.key);
-          if (filename.startsWith("inv-") && filename.endsWith(".json")) {
-            const item = JSON.parse(json);
-            investigations.push({
-              ...item,
-              completedAt: new Date(item.completedAt)
-            });
-          } else if (filename.startsWith("cr-") && filename.endsWith(".json")) {
-            const item = JSON.parse(json);
-            crs.push({
-              ...item,
-              startedAt: new Date(item.startedAt),
-              resolvedInteractions: item.resolvedInteractions ?? []
-            });
-          }
-        } catch {
-          console.warn(`[PRBEAgent] Skipping unreadable history file: ${filename}`);
-        }
-      }
-    } catch {
-    }
-    investigations.sort(
-      (a, b) => b.completedAt.getTime() - a.completedAt.getTime()
-    );
-    crs.sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime());
-    return { investigations, crs };
-  }
-  save(investigations, crs) {
-    try {
-      const dir = getHistoryDir();
-      const desiredFiles = /* @__PURE__ */ new Set();
-      for (const inv of investigations) {
-        const filename = `inv-${inv.id}.json`;
-        desiredFiles.add(filename);
-        const data = {
-          id: inv.id,
-          query: inv.query,
-          report: inv.report,
-          summary: inv.summary,
-          ticketId: inv.ticketId,
-          events: inv.events,
-          resolvedInteractions: inv.resolvedInteractions,
-          conversationHistory: inv.conversationHistory,
-          completedAt: inv.completedAt.toISOString()
-        };
-        fs2.writeFileSync(
-          path4.join(dir, filename),
-          encrypt(JSON.stringify(data), this.key)
-        );
-      }
-      for (const cr of crs) {
-        const filename = `cr-${cr.id}.json`;
-        desiredFiles.add(filename);
-        const data = {
-          id: cr.id,
-          query: cr.query,
-          slug: cr.slug,
-          ticketId: cr.ticketId,
-          events: cr.events,
-          isRunning: cr.isRunning,
-          isCompleted: cr.isCompleted,
-          isFailed: cr.isFailed,
-          report: cr.report,
-          summary: cr.summary,
-          errorMessage: cr.errorMessage,
-          startedAt: cr.startedAt.toISOString(),
-          pendingInteraction: cr.pendingInteraction,
-          resolvedInteractions: cr.resolvedInteractions ?? []
-        };
-        fs2.writeFileSync(
-          path4.join(dir, filename),
-          encrypt(JSON.stringify(data), this.key)
-        );
-      }
-      try {
-        const existing = fs2.readdirSync(dir);
-        for (const filename of existing) {
-          if (!desiredFiles.has(filename)) {
-            fs2.unlinkSync(path4.join(dir, filename));
-          }
-        }
-      } catch {
-      }
-    } catch {
-      console.error("[PRBEAgent] Failed to save investigation history");
-    }
-  }
-  static clear() {
-    try {
-      const dir = path4.join(getAppDataDir(), "history" /* HISTORY_DIR */);
-      if (fs2.existsSync(dir)) {
-        fs2.rmSync(dir, { recursive: true, force: true });
-      }
-    } catch {
-    }
-  }
-};
-
-// src/agent.ts
-function getPersistencePath() {
-  const appData = process.env["APPDATA"] || (process.platform === "darwin" ? path5.join(os2.homedir(), "Library", "Application Support") : path5.join(os2.homedir(), ".local", "share"));
-  const dir = path5.join(appData, "prbe-agent");
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true });
-  }
-  return path5.join(dir, "agent-state.json");
+  return path4.join(dir, "agent-state.json");
 }
 function loadPersistedData() {
   try {
     const filePath = getPersistencePath();
-    if (fs3.existsSync(filePath)) {
-      const raw = fs3.readFileSync(filePath, "utf-8");
+    if (fs2.existsSync(filePath)) {
+      const raw = fs2.readFileSync(filePath, "utf-8");
       return JSON.parse(raw);
     }
   } catch {
@@ -1964,7 +1809,7 @@ function loadPersistedData() {
 function savePersistedData(data) {
   try {
     const filePath = getPersistencePath();
-    fs3.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+    fs2.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
   } catch {
     console.error("[PRBEAgent] Failed to save persisted data");
   }
@@ -1984,10 +1829,12 @@ var PRBEAgent = class _PRBEAgent {
   persistedData;
   fetchAbortController = null;
   currentInvestigationSource = "user" /* USER */;
-  currentCRId = null;
-  historyStore;
+  currentBackgroundId = null;
   /** Files flagged during the current tool call — uploaded immediately after the tool returns. */
   pendingFlaggedFiles = [];
+  // ---------- User Identifier ----------
+  userEmail;
+  userId;
   // ---------- Persistence ----------
   get agentID() {
     if (this.persistedData.agentId) {
@@ -1998,30 +1845,6 @@ var PRBEAgent = class _PRBEAgent {
     savePersistedData(this.persistedData);
     return newID;
   }
-  get trackedSessionIDs() {
-    return this.persistedData.sessionIds ?? [];
-  }
-  set trackedSessionIDs(ids) {
-    this.persistedData.sessionIds = ids;
-    savePersistedData(this.persistedData);
-    this.state.updateTrackedSessionIDs(ids);
-    this.syncPolling(ids.length > 0);
-  }
-  syncPolling(hasSessions) {
-    if (this.config.backgroundPolling && hasSessions) {
-      if (this.pollingTimer === null) {
-        this.startPolling();
-      }
-    } else if (!hasSessions) {
-      this.stopPolling();
-    }
-  }
-  addTrackedSession(id) {
-    const ids = this.trackedSessionIDs;
-    if (!ids.includes(id)) {
-      this.trackedSessionIDs = [...ids, id];
-    }
-  }
   // ---------- Constructor ----------
   constructor(config) {
     this.config = {
@@ -2041,10 +1864,7 @@ var PRBEAgent = class _PRBEAgent {
     this.state = new PRBEAgentState();
     this.logCapture = new PRBELogCapture(this.config.maxLogEntries);
     this.persistedData = loadPersistedData();
-    this.historyStore = new HistoryStore(this.config.apiKey);
-    const history = this.historyStore.load();
-    this.state.completedInvestigations = history.investigations;
-    this.state.completedCRs = history.crs;
+    void this.agentID;
     const roots = this.config.autoApprovedDirs;
     const requester = this.interactionHandler ? this : void 0;
     const grantedPaths = this.grantedPaths;
@@ -2076,8 +1896,8 @@ var PRBEAgent = class _PRBEAgent {
         [{ name: "message", type: "STRING" /* STRING */, description: "Message for the user", required: true }],
         async (args) => {
           const message = args["message"] ?? "";
-          if (this.currentInvestigationSource === "context_request" /* CONTEXT_REQUEST */ && this.currentCRId) {
-            this.state.setCRAgentMessage(this.currentCRId, message);
+          if (this.currentInvestigationSource !== "user" /* USER */ && this.currentBackgroundId) {
+            this.state.setBackgroundAgentMessage(this.currentBackgroundId, message);
           } else {
             this.state.setAgentMessage(message);
           }
@@ -2094,9 +1914,8 @@ var PRBEAgent = class _PRBEAgent {
     if (config.ipcMain) {
       this.hookRendererLogs(config.ipcMain, config.rendererLogChannel ?? "prbe-renderer-log");
     }
-    const existingSessions = this.trackedSessionIDs;
-    if (existingSessions.length > 0) {
-      this.trackedSessionIDs = existingSessions;
+    if (this.config.backgroundPolling) {
+      this.startPolling();
     }
   }
   // ---------- Log integration ----------
@@ -2150,15 +1969,15 @@ var PRBEAgent = class _PRBEAgent {
         "No interaction handler configured"
       );
     }
-    if (this.currentInvestigationSource === "context_request" /* CONTEXT_REQUEST */ && this.currentCRId) {
-      this.state.setCRPendingInteraction(this.currentCRId, payload);
+    if (this.currentInvestigationSource !== "user" /* USER */ && this.currentBackgroundId) {
+      this.state.setBackgroundPendingInteraction(this.currentBackgroundId, payload);
     } else {
       this.state.setPendingInteraction(payload);
     }
     try {
       const response = await this.interactionHandler.handleInteraction(payload);
-      if (this.currentInvestigationSource === "context_request" /* CONTEXT_REQUEST */ && this.currentCRId) {
-        this.state.resolveCRInteraction(this.currentCRId, response);
+      if (this.currentInvestigationSource !== "user" /* USER */ && this.currentBackgroundId) {
+        this.state.resolveBackgroundInteraction(this.currentBackgroundId, response);
       } else {
         this.state.resolveInteraction(response);
       }
@@ -2171,8 +1990,8 @@ var PRBEAgent = class _PRBEAgent {
       }
       return response;
     } catch (err) {
-      if (this.currentInvestigationSource === "context_request" /* CONTEXT_REQUEST */ && this.currentCRId) {
-        this.state.clearCRPendingInteraction(this.currentCRId);
+      if (this.currentInvestigationSource !== "user" /* USER */ && this.currentBackgroundId) {
+        this.state.clearBackgroundPendingInteraction(this.currentBackgroundId);
       } else {
         this.state.clearPendingInteraction();
       }
@@ -2195,6 +2014,47 @@ var PRBEAgent = class _PRBEAgent {
   updateSessionMetadata(metadata) {
     this.sessionMetadata = { ...this.sessionMetadata, ...metadata };
   }
+  /**
+   * 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, value) {
+    if (type === "email" /* EMAIL */) {
+      this.userEmail = value;
+    } else {
+      this.userId = value;
+    }
+    this.syncUserIdentifierToBackend(type, value);
+  }
+  /**
+   * 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) {
+    if (type) {
+      if (type === "email" /* EMAIL */) {
+        this.userEmail = void 0;
+      } else {
+        this.userId = void 0;
+      }
+      this.syncUserIdentifierToBackend(type, null);
+    } else {
+      this.userEmail = void 0;
+      this.userId = void 0;
+      this.syncUserIdentifierToBackend("email" /* EMAIL */, null);
+      this.syncUserIdentifierToBackend("id" /* ID */, null);
+    }
+  }
+  syncUserIdentifierToBackend(type, value) {
+    void this.post("/api/agent/update-user", {
+      agent_id: this.agentID,
+      identifier_type: type,
+      identifier_value: value
+    }).catch((err) => {
+      console.error(`[PRBEAgent] Failed to sync user identifier: ${err}`);
+    });
+  }
   /**
    * Register a custom tool that the middleware can invoke during investigations.
    */
@@ -2203,58 +2063,92 @@ var PRBEAgent = class _PRBEAgent {
       new PRBEClosureTool(name, description, parameters, handler, options)
     );
   }
-  /**
-   * User-initiated investigation. Updates `state` events/report directly.
-   */
-  async investigate(query, contextRequestID) {
-    this.userCancelled = false;
-    this.currentInvestigationSource = "user" /* USER */;
-    this.currentCRId = null;
-    this.state.beginInvestigation(query);
+  // ---------- Unified Investigation ----------
+  async runInvestigation(opts) {
+    this.currentInvestigationSource = opts.source;
+    this.currentBackgroundId = opts.sourceId ?? null;
+    const isBackground = opts.source !== "user" /* USER */;
     const emitter = (status) => {
       switch (status.type) {
         case "started" /* STARTED */:
-          this.state.appendEvent("Starting investigation...");
+          if (isBackground && opts.sourceId) {
+            this.state.appendBackgroundEvent(opts.sourceId, "Starting investigation...");
+          } else {
+            this.state.appendEvent("Starting investigation...");
+          }
           break;
         case "thinking" /* THINKING */:
           break;
         case "tool_call" /* TOOL_CALL */:
-          this.state.appendEvent(status.label);
+          if (isBackground && opts.sourceId) {
+            this.state.appendBackgroundEvent(opts.sourceId, status.label);
+          } else {
+            this.state.appendEvent(status.label);
+          }
           break;
         case "observation" /* OBSERVATION */:
-          this.state.attachObservation(status.text);
+          if (isBackground && opts.sourceId) {
+            this.state.attachBackgroundObservation(opts.sourceId, status.text);
+          } else {
+            this.state.attachObservation(status.text);
+          }
           break;
         case "thought" /* THOUGHT */:
-          this.state.appendEvent("Thinking", status.text);
+          if (isBackground && opts.sourceId) {
+            this.state.appendBackgroundEvent(opts.sourceId, "Thinking", status.text);
+          } else {
+            this.state.appendEvent("Thinking", status.text);
+          }
           break;
         case "completed" /* COMPLETED */:
-          this.state.completeInvestigation(status.report, status.ticketId);
-          this.historyStore.save(this.state.completedInvestigations, this.state.completedCRs);
+          if (isBackground && opts.sourceId) {
+            this.state.completeBackgroundInvestigation(opts.sourceId, status.report);
+          } else {
+            this.state.completeInvestigation(status.report, status.ticketId);
+          }
           break;
         case "error" /* ERROR */:
-          this.state.failInvestigation(status.message);
+          if (isBackground && opts.sourceId) {
+            this.state.failBackgroundInvestigation(opts.sourceId, status.message);
+          } else {
+            this.state.failInvestigation(status.message);
+          }
           break;
       }
     };
     const result = await this.connectToProxy(
-      query,
-      contextRequestID,
+      opts.query,
+      opts.contextRequestId,
+      opts.externalRequestId,
+      opts.externalRequestSource,
+      opts.externalRequestSourceDetail,
       emitter,
-      () => this.userCancelled
+      opts.cancellable ? () => this.userCancelled : () => false,
+      opts.ticketId
     );
     this.currentInvestigationSource = "user" /* USER */;
-    this.currentCRId = null;
-    if (result?.sessionId) {
-      this.addTrackedSession(result.sessionId);
-    } else if (!result) {
-      if (this.state.isInvestigating) {
-        const message = this.userCancelled ? "Investigation cancelled" : "Investigation ended unexpectedly";
-        this.state.failInvestigation(message);
-      }
+    this.currentBackgroundId = null;
+    return result;
+  }
+  /**
+   * User-initiated investigation. Updates `state` events/report directly.
+   */
+  async investigate(query, contextRequestID) {
+    this.userCancelled = false;
+    this.state.beginInvestigation(query);
+    const result = await this.runInvestigation({
+      query,
+      source: "user" /* USER */,
+      contextRequestId: contextRequestID,
+      cancellable: true
+    });
+    if (!result && this.state.isInvestigating) {
+      const message = this.userCancelled ? "Investigation cancelled" : "Investigation ended unexpectedly";
+      this.state.failInvestigation(message);
     }
   }
   /**
-   * Cancel user-initiated investigation only (does not cancel background CRs).
+   * Cancel user-initiated investigation only (does not cancel background investigations).
    */
   cancelInvestigation() {
     this.userCancelled = true;
@@ -2276,41 +2170,21 @@ var PRBEAgent = class _PRBEAgent {
     this.stopPolling();
   }
   /**
-   * 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.
    */
   async poll() {
-    const sessionIDs = this.trackedSessionIDs;
-    if (sessionIDs.length === 0) return null;
     try {
-      const resolved = await this.resolveSessions(sessionIDs);
-      const returnedSessionIDs = new Set(
-        resolved.tickets.flatMap((t) => t.session_ids)
-      );
-      const resolvedSessionIDs = new Set(
-        resolved.tickets.filter((t) => t.status === "resolved").flatMap((t) => t.session_ids)
-      );
-      const survivingSessions = sessionIDs.filter(
-        (id) => returnedSessionIDs.has(id) && !resolvedSessionIDs.has(id)
-      );
-      if (survivingSessions.length !== sessionIDs.length) {
-        this.trackedSessionIDs = survivingSessions;
+      const request = { agent_id: this.agentID };
+      const response = await this.post("/api/agent/poll", request);
+      for (const cr of response.context_requests) {
+        if (!cr.is_active) continue;
+        if (this.state.activeBackgroundInvestigations.has(cr.id)) continue;
+        await this.investigateForCR(cr, cr.ticket_id);
       }
-      const ticketIDs = resolved.tickets.filter((t) => t.status !== "resolved").map((t) => t.ticket_id);
-      if (ticketIDs.length === 0) return { tickets: [] };
-      const request = {
-        agent_id: this.agentID,
-        ticket_ids: ticketIDs
-      };
-      const response = await this.post(
-        "/api/agent/poll",
-        request
-      );
-      for (const ticket of response.tickets) {
-        for (const cr of ticket.context_requests) {
-          if (!cr.is_active) continue;
-          await this.investigateForCR(cr, ticket.ticket_id);
-        }
+      for (const er of response.external_requests) {
+        if (!er.is_active) continue;
+        if (this.state.activeBackgroundInvestigations.has(er.id)) continue;
+        await this.investigateForER(er);
       }
       return response;
     } catch {
@@ -2318,25 +2192,18 @@ var PRBEAgent = class _PRBEAgent {
     }
   }
   /**
-   * 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.
    */
-  async fetchTicketInfo() {
-    const sessionIDs = this.trackedSessionIDs;
-    if (sessionIDs.length === 0) return [];
+  async fetchHistory() {
     try {
-      const resolved = await this.resolveSessions(sessionIDs);
-      const ticketIDs = resolved.tickets.map((t) => t.ticket_id);
-      if (ticketIDs.length === 0) return [];
-      const request = { ticket_ids: ticketIDs };
       const response = await this.post(
-        "/api/agent/tickets",
-        request
+        "/api/agent/history",
+        { agent_id: this.agentID }
       );
-      this.state.updateTicketInfo(response.tickets);
-      return response.tickets;
+      this.state.updateAgentHistory(response.tickets);
+      return response;
     } catch {
-      return [];
+      return null;
     }
   }
   stopPolling() {
@@ -2346,7 +2213,7 @@ var PRBEAgent = class _PRBEAgent {
     }
   }
   resumePolling() {
-    if (this.trackedSessionIDs.length === 0) return;
+    if (!this.config.backgroundPolling) return;
     this.startPolling();
   }
   /**
@@ -2364,13 +2231,11 @@ var PRBEAgent = class _PRBEAgent {
     this.stopPolling();
     this.persistedData = {};
     savePersistedData(this.persistedData);
-    HistoryStore.clear();
     this.state.resetInvestigation();
     this.state.completedInvestigations = [];
-    this.state.activeCRs.clear();
-    this.state.completedCRs = [];
-    this.state.trackedSessionIDs = [];
-    this.state.ticketInfo = [];
+    this.state.activeBackgroundInvestigations.clear();
+    this.state.completedBackgroundInvestigations = [];
+    this.state.agentHistory = [];
     this.state.emit("status" /* STATUS */);
   }
   /**
@@ -2379,61 +2244,38 @@ var PRBEAgent = class _PRBEAgent {
   static clearPersistedData() {
     try {
       const filePath = getPersistencePath();
-      if (fs3.existsSync(filePath)) {
-        fs3.unlinkSync(filePath);
+      if (fs2.existsSync(filePath)) {
+        fs2.unlinkSync(filePath);
       }
-      HistoryStore.clear();
     } catch {
     }
   }
-  // ---------- CR Investigation ----------
+  // ---------- Background Investigation ----------
   async investigateForCR(cr, ticketId) {
-    const crID = cr.id;
-    this.currentInvestigationSource = "context_request" /* CONTEXT_REQUEST */;
-    this.currentCRId = crID;
-    this.state.beginCR(crID, cr.query, cr.slug ?? void 0, ticketId);
-    const emitter = (status) => {
-      switch (status.type) {
-        case "started" /* STARTED */:
-          this.state.appendCREvent(crID, "Starting investigation...");
-          break;
-        case "thinking" /* THINKING */:
-          break;
-        case "tool_call" /* TOOL_CALL */:
-          this.state.appendCREvent(crID, status.label);
-          break;
-        case "observation" /* OBSERVATION */:
-          this.state.attachCRObservation(crID, status.text);
-          break;
-        case "thought" /* THOUGHT */:
-          this.state.appendCREvent(crID, "Thinking", status.text);
-          break;
-        case "completed" /* COMPLETED */:
-          this.state.completeCR(crID, status.report);
-          this.historyStore.save(this.state.completedInvestigations, this.state.completedCRs);
-          break;
-        case "error" /* ERROR */:
-          this.state.failCR(crID, status.message);
-          this.historyStore.save(this.state.completedInvestigations, this.state.completedCRs);
-          break;
-      }
-    };
-    const result = await this.connectToProxy(
-      cr.query,
-      crID,
-      emitter,
-      () => false,
-      // CRs are not user-cancellable
-      ticketId
-    );
-    this.currentInvestigationSource = "user" /* USER */;
-    this.currentCRId = null;
-    if (result?.sessionId) {
-      this.addTrackedSession(result.sessionId);
-    }
+    this.state.beginBackgroundInvestigation(cr.id, cr.query, cr.slug ?? void 0, ticketId);
+    await this.runInvestigation({
+      query: cr.query,
+      source: "context_request" /* CONTEXT_REQUEST */,
+      sourceId: cr.id,
+      contextRequestId: cr.id,
+      ticketId,
+      cancellable: false
+    });
+  }
+  async investigateForER(er) {
+    this.state.beginBackgroundInvestigation(er.id, er.query, void 0, void 0, er.source, er.source_detail);
+    await this.runInvestigation({
+      query: er.query,
+      source: "external_request" /* EXTERNAL_REQUEST */,
+      sourceId: er.id,
+      externalRequestId: er.id,
+      externalRequestSource: er.source,
+      externalRequestSourceDetail: er.source_detail,
+      cancellable: false
+    });
   }
   // ---------- WebSocket Investigation ----------
-  connectToProxy(query, contextRequestID, emit, isCancelled, ticketId) {
+  connectToProxy(query, contextRequestID, externalRequestId, externalRequestSource, externalRequestSourceDetail, emit, isCancelled, ticketId) {
     return new Promise((resolve2) => {
       const wsUrl = `${MIDDLEWARE_URL}/api/agent/client/ws`;
       let uploadBaseUrl;
@@ -2488,15 +2330,25 @@ var PRBEAgent = class _PRBEAgent {
         const startMetadata = {
           agent_id: this.agentID,
           custom_tools: toolDeclarations,
-          platform: os2.platform(),
-          os_version: os2.release(),
-          arch: os2.arch()
+          platform: os.platform(),
+          os_version: os.release(),
+          arch: os.arch()
         };
         if (contextRequestID) startMetadata["context_request_id"] = contextRequestID;
+        if (externalRequestId) startMetadata["external_request_id"] = externalRequestId;
+        if (externalRequestSource) startMetadata["external_request_source"] = externalRequestSource;
+        if (externalRequestSourceDetail) startMetadata["external_request_source_detail"] = externalRequestSourceDetail;
         if (ticketId) startMetadata["ticket_id"] = ticketId;
         if (this.appDataPath) startMetadata["app_data_path"] = this.appDataPath;
-        if (Object.keys(this.sessionMetadata).length > 0) {
-          startMetadata["session_metadata"] = this.sessionMetadata;
+        const enrichedMetadata = { ...this.sessionMetadata };
+        if (this.userEmail) {
+          enrichedMetadata["user_email"] = this.userEmail;
+        }
+        if (this.userId) {
+          enrichedMetadata["user_id"] = this.userId;
+        }
+        if (Object.keys(enrichedMetadata).length > 0) {
+          startMetadata["session_metadata"] = enrichedMetadata;
         }
         if (!conn.send({ type: "start" /* START */, content: query, metadata: startMetadata })) {
           emit({ type: "error" /* ERROR */, message: "Failed to send start message" });
@@ -2533,7 +2385,7 @@ var PRBEAgent = class _PRBEAgent {
           const uploadPrefix = this.extractUploadPrefix(uploadBaseUrl);
           const uploadedRefs = [];
           for (const file of this.pendingFlaggedFiles) {
-            const filename = path5.basename(file.originalPath);
+            const filename = path4.basename(file.originalPath);
             const safeName = encodeURIComponent(filename);
             const storagePath = `${uploadPrefix}/${safeName}`;
             uploadedRefs.push({
@@ -2578,7 +2430,11 @@ var PRBEAgent = class _PRBEAgent {
       case "conversation_update" /* CONVERSATION_UPDATE */: {
         try {
           const entry = JSON.parse(msg.content ?? "{}");
-          this.state.appendConversation(entry);
+          if (this.currentInvestigationSource !== "user" /* USER */ && this.currentBackgroundId) {
+            this.state.appendBackgroundConversation(this.currentBackgroundId, entry);
+          } else {
+            this.state.appendConversation(entry);
+          }
         } catch {
         }
         break;
@@ -2636,24 +2492,9 @@ var PRBEAgent = class _PRBEAgent {
   startPolling() {
     this.stopPolling();
     this.pollingTimer = setInterval(() => {
-      void this.poll().then(() => {
-        if (this.trackedSessionIDs.length === 0) {
-          this.stopPolling();
-        }
-      });
+      void this.poll();
     }, this.config.pollingInterval);
   }
-  // ---------- Session Resolution ----------
-  async resolveSessions(sessionIDs) {
-    const request = {
-      agent_id: this.agentID,
-      session_ids: sessionIDs
-    };
-    return this.post(
-      "/api/agent/resolve-sessions",
-      request
-    );
-  }
   // ---------- Networking ----------
   /**
    * Abort all in-flight fetch requests to prevent orphaned DNS lookups
@@ -2707,29 +2548,32 @@ var DEFAULT_PRBE_STATE = {
   resolvedInteractions: [],
   conversationHistory: [],
   completedInvestigations: [],
-  activeCRs: [],
-  completedCRs: [],
-  trackedSessionIDs: [],
+  activeBackgroundInvestigations: [],
+  completedBackgroundInvestigations: [],
   ticketInfo: [],
+  agentHistory: [],
   hasActiveWork: false
 };
-function serializeCR(cr) {
+function serializeBackgroundInvestigation(bg) {
   return {
-    id: cr.id,
-    query: cr.query,
-    slug: cr.slug,
-    ticketId: cr.ticketId,
-    events: cr.events,
-    isRunning: cr.isRunning,
-    isCompleted: cr.isCompleted,
-    isFailed: cr.isFailed,
-    report: cr.report,
-    summary: cr.summary,
-    errorMessage: cr.errorMessage,
-    agentMessage: cr.agentMessage,
-    startedAt: cr.startedAt.toISOString(),
-    pendingInteraction: cr.pendingInteraction,
-    resolvedInteractions: cr.resolvedInteractions ?? []
+    id: bg.id,
+    query: bg.query,
+    slug: bg.slug,
+    ticketId: bg.ticketId,
+    source: bg.source,
+    sourceDetail: bg.sourceDetail,
+    events: bg.events,
+    isRunning: bg.isRunning,
+    isCompleted: bg.isCompleted,
+    isFailed: bg.isFailed,
+    report: bg.report,
+    summary: bg.summary,
+    errorMessage: bg.errorMessage,
+    agentMessage: bg.agentMessage,
+    startedAt: bg.startedAt.toISOString(),
+    pendingInteraction: bg.pendingInteraction,
+    resolvedInteractions: bg.resolvedInteractions ?? [],
+    conversationHistory: bg.conversationHistory ?? []
   };
 }
 function serializePRBEState(state) {
@@ -2755,10 +2599,10 @@ function serializePRBEState(state) {
       conversationHistory: inv.conversationHistory,
       completedAt: inv.completedAt.toISOString()
     })),
-    activeCRs: Array.from(state.activeCRs.values()).map(serializeCR),
-    completedCRs: state.completedCRs.map(serializeCR),
-    trackedSessionIDs: state.trackedSessionIDs,
+    activeBackgroundInvestigations: Array.from(state.activeBackgroundInvestigations.values()).map(serializeBackgroundInvestigation),
+    completedBackgroundInvestigations: state.completedBackgroundInvestigations.map(serializeBackgroundInvestigation),
     ticketInfo: state.ticketInfo,
+    agentHistory: state.agentHistory,
     hasActiveWork: state.hasActiveWork
   };
 }
@@ -2802,6 +2646,7 @@ var PROBE_MARK_SVG = `<svg width="256" height="256" viewBox="0 0 256 256" fill="
   SearchContentTool,
   ToolName,
   ToolParamType,
+  UserIdentifierType,
   WSMessageType,
   humanReadableSize,
   redactPII,