@prbe.ai/electron-sdk 0.1.0

package/dist/serialization.d.ts

@@ -0,0 +1,49 @@
+/**
+ * serialization.ts — IPC-safe serialization of agent state
+ *
+ * Converts live PRBEAgentState (with Map, Date, EventEmitter) into
+ * plain JSON-safe objects suitable for IPC or structured clone.
+ */
+import type { PRBEAgentState } from "./state";
+import type { PRBEStatusEvent, TicketInfoOut } from "./models";
+import type { InteractionPayload } from "./interactions";
+export interface PRBESerializedCR {
+    id: string;
+    query: string;
+    slug?: string;
+    events: PRBEStatusEvent[];
+    isRunning: boolean;
+    isCompleted: boolean;
+    isFailed: boolean;
+    report: string;
+    summary: string;
+    errorMessage?: string;
+    startedAt: string;
+    pendingInteraction?: InteractionPayload;
+}
+export type PRBESerializedTicket = TicketInfoOut;
+export interface PRBESerializedCompletedInvestigation {
+    id: string;
+    query: string;
+    report: string;
+    summary: string;
+    completedAt: string;
+}
+export interface PRBESerializedState {
+    isInvestigating: boolean;
+    events: PRBEStatusEvent[];
+    report: string;
+    summary: string;
+    currentQuery: string;
+    investigationError?: string;
+    pendingInteraction?: InteractionPayload;
+    completedInvestigations: PRBESerializedCompletedInvestigation[];
+    activeCRs: PRBESerializedCR[];
+    completedCRs: PRBESerializedCR[];
+    trackedTicketIDs: string[];
+    ticketInfo: PRBESerializedTicket[];
+    hasActiveWork: boolean;
+}
+export declare const DEFAULT_PRBE_STATE: PRBESerializedState;
+export declare function serializePRBEState(state: PRBEAgentState): PRBESerializedState;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EAEf,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAMD,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAMjD,MAAM,WAAW,oCAAoC;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,uBAAuB,EAAE,oCAAoC,EAAE,CAAC;IAChE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,aAAa,EAAE,OAAO,CAAC;CACxB;AAMD,eAAO,MAAM,kBAAkB,EAAE,mBAYhC,CAAC;AAuBF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,mBAAmB,CAsB7E"}

package/dist/serialization.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * serialization.ts — IPC-safe serialization of agent state
+ *
+ * Converts live PRBEAgentState (with Map, Date, EventEmitter) into
+ * plain JSON-safe objects suitable for IPC or structured clone.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PRBE_STATE = void 0;
+exports.serializePRBEState = serializePRBEState;
+// ---------------------------------------------------------------------------
+// Default state (used before agent initializes)
+// ---------------------------------------------------------------------------
+exports.DEFAULT_PRBE_STATE = {
+    isInvestigating: false,
+    events: [],
+    report: "",
+    summary: "",
+    currentQuery: "",
+    completedInvestigations: [],
+    activeCRs: [],
+    completedCRs: [],
+    trackedTicketIDs: [],
+    ticketInfo: [],
+    hasActiveWork: false,
+};
+// ---------------------------------------------------------------------------
+// Converter: live state → IPC-safe plain object
+// ---------------------------------------------------------------------------
+function serializeCR(cr) {
+    return {
+        id: cr.id,
+        query: cr.query,
+        slug: cr.slug,
+        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,
+    };
+}
+function serializePRBEState(state) {
+    return {
+        isInvestigating: state.isInvestigating,
+        events: state.events,
+        report: state.report,
+        summary: state.summary,
+        currentQuery: state.currentQuery,
+        investigationError: state.investigationError,
+        pendingInteraction: state.pendingInteraction,
+        completedInvestigations: state.completedInvestigations.map((inv) => ({
+            id: inv.id,
+            query: inv.query,
+            report: inv.report,
+            summary: inv.summary,
+            completedAt: inv.completedAt.toISOString(),
+        })),
+        activeCRs: Array.from(state.activeCRs.values()).map(serializeCR),
+        completedCRs: state.completedCRs.map(serializeCR),
+        trackedTicketIDs: state.trackedTicketIDs,
+        ticketInfo: state.ticketInfo,
+        hasActiveWork: state.hasActiveWork,
+    };
+}
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA0GH,gDAsBC;AA7DD,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAEjE,QAAA,kBAAkB,GAAwB;IACrD,eAAe,EAAE,KAAK;IACtB,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,uBAAuB,EAAE,EAAE;IAC3B,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,EAAE;IAChB,gBAAgB,EAAE,EAAE;IACpB,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,WAAW,CAAC,EAAuB;IAC1C,OAAO;QACL,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE;QACrC,kBAAkB,EAAE,EAAE,CAAC,kBAAkB;KAC1C,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAqB;IACtD,OAAO;QACL,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACnE,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE;SAC3C,CAAC,CAAC;QACH,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;QAChE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;QACjD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC;AACJ,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,67 @@
+/**
+ * state.ts — PRBEAgentState: EventEmitter-based observable investigation state
+ *
+ * Mirrors PRBEAgentState.swift but uses Node.js EventEmitter instead of Combine/@Published.
+ * Host apps subscribe to events for UI updates.
+ */
+import { EventEmitter } from "events";
+import type { PRBEStatusEvent, PRBECRInvestigation, PRBECompletedInvestigation, TicketInfoOut } from "./models";
+import type { InteractionPayload } from "./interactions";
+export declare enum PRBEStateEvent {
+    /** Emitted on any state change. Payload: void */
+    STATUS = "status",
+    /** Emitted when a new event is appended. Payload: PRBEStatusEvent */
+    EVENT = "event",
+    /** Emitted when investigation completes. Payload: { report: string; summary: string } */
+    COMPLETE = "complete",
+    /** Emitted on error. Payload: { message: string } */
+    ERROR = "error",
+    /** Emitted when a background CR starts. Payload: PRBECRInvestigation */
+    CR_START = "cr-start",
+    /** Emitted when a background CR completes/fails. Payload: PRBECRInvestigation */
+    CR_COMPLETE = "cr-complete",
+    /** Emitted when tracked ticket IDs change. Payload: string[] */
+    TICKETS_CHANGED = "tickets-changed",
+    /** Emitted when ticket info is updated. Payload: TicketInfoOut[] */
+    TICKET_INFO = "ticket-info",
+    /** Emitted when an interaction is requested. Payload: InteractionPayload */
+    INTERACTION_REQUESTED = "interaction-requested",
+    /** Emitted when an interaction is resolved. Payload: void */
+    INTERACTION_RESOLVED = "interaction-resolved"
+}
+export declare class PRBEAgentState extends EventEmitter {
+    isInvestigating: boolean;
+    events: PRBEStatusEvent[];
+    report: string;
+    summary: string;
+    currentQuery: string;
+    investigationError?: string;
+    pendingInteraction?: InteractionPayload;
+    completedInvestigations: PRBECompletedInvestigation[];
+    activeCRs: Map<string, PRBECRInvestigation>;
+    completedCRs: PRBECRInvestigation[];
+    trackedTicketIDs: string[];
+    ticketInfo: TicketInfoOut[];
+    get hasActiveWork(): boolean;
+    get activeCRCount(): number;
+    get isActive(): boolean;
+    beginInvestigation(query: string): void;
+    resetInvestigation(): void;
+    appendEvent(label: string, detail?: string, completed?: boolean): void;
+    attachObservation(text: string): void;
+    completeInvestigation(report: string, summary: string): void;
+    failInvestigation(message: string): void;
+    setPendingInteraction(payload: InteractionPayload): void;
+    clearPendingInteraction(): void;
+    setCRPendingInteraction(crID: string, payload: InteractionPayload): void;
+    clearCRPendingInteraction(crID: string): void;
+    toggleExpansion(eventId: string): void;
+    beginCR(id: string, query: string, slug?: string): void;
+    appendCREvent(crID: string, label: string, detail?: string, completed?: boolean): void;
+    attachCRObservation(crID: string, text: string): void;
+    completeCR(id: string, report: string, summary: string): void;
+    failCR(id: string, message: string): void;
+    updateTrackedTicketIDs(ids: string[]): void;
+    updateTicketInfo(info: TicketInfoOut[]): void;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMzD,oBAAY,cAAc;IACxB,iDAAiD;IACjD,MAAM,WAAW;IACjB,qEAAqE;IACrE,KAAK,UAAU;IACf,yFAAyF;IACzF,QAAQ,aAAa;IACrB,qDAAqD;IACrD,KAAK,UAAU;IACf,wEAAwE;IACxE,QAAQ,aAAa;IACrB,iFAAiF;IACjF,WAAW,gBAAgB;IAC3B,gEAAgE;IAChE,eAAe,oBAAoB;IACnC,oEAAoE;IACpE,WAAW,gBAAgB;IAC3B,4EAA4E;IAC5E,qBAAqB,0BAA0B;IAC/C,6DAA6D;IAC7D,oBAAoB,yBAAyB;CAC9C;AAMD,qBAAa,cAAe,SAAQ,YAAY;IAEvC,eAAe,UAAS;IACxB,MAAM,EAAE,eAAe,EAAE,CAAM;IAC/B,MAAM,SAAM;IACZ,OAAO,SAAM;IACb,YAAY,SAAM;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAGxC,uBAAuB,EAAE,0BAA0B,EAAE,CAAM;IAG3D,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;IACxD,YAAY,EAAE,mBAAmB,EAAE,CAAM;IAGzC,gBAAgB,EAAE,MAAM,EAAE,CAAM;IAChC,UAAU,EAAE,aAAa,EAAE,CAAM;IAGxC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAID,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAUvC,kBAAkB,IAAI,IAAI;IAW1B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,IAAI;IAoBpE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOrC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAsB5D,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUxC,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMxD,uBAAuB,IAAI,IAAI;IAM/B,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAQxE,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ7C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUtC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBvD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,IAAI;IAoBpF,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOrD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAuB7D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBzC,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAM3C,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI;CAK9C"}

package/dist/state.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * state.ts — PRBEAgentState: EventEmitter-based observable investigation state
+ *
+ * Mirrors PRBEAgentState.swift but uses Node.js EventEmitter instead of Combine/@Published.
+ * Host apps subscribe to events for UI updates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRBEAgentState = exports.PRBEStateEvent = void 0;
+const events_1 = require("events");
+const crypto_1 = require("crypto");
+// ---------------------------------------------------------------------------
+// Event types emitted by PRBEAgentState
+// ---------------------------------------------------------------------------
+var PRBEStateEvent;
+(function (PRBEStateEvent) {
+    /** Emitted on any state change. Payload: void */
+    PRBEStateEvent["STATUS"] = "status";
+    /** Emitted when a new event is appended. Payload: PRBEStatusEvent */
+    PRBEStateEvent["EVENT"] = "event";
+    /** Emitted when investigation completes. Payload: { report: string; summary: string } */
+    PRBEStateEvent["COMPLETE"] = "complete";
+    /** Emitted on error. Payload: { message: string } */
+    PRBEStateEvent["ERROR"] = "error";
+    /** Emitted when a background CR starts. Payload: PRBECRInvestigation */
+    PRBEStateEvent["CR_START"] = "cr-start";
+    /** Emitted when a background CR completes/fails. Payload: PRBECRInvestigation */
+    PRBEStateEvent["CR_COMPLETE"] = "cr-complete";
+    /** Emitted when tracked ticket IDs change. Payload: string[] */
+    PRBEStateEvent["TICKETS_CHANGED"] = "tickets-changed";
+    /** Emitted when ticket info is updated. Payload: TicketInfoOut[] */
+    PRBEStateEvent["TICKET_INFO"] = "ticket-info";
+    /** Emitted when an interaction is requested. Payload: InteractionPayload */
+    PRBEStateEvent["INTERACTION_REQUESTED"] = "interaction-requested";
+    /** Emitted when an interaction is resolved. Payload: void */
+    PRBEStateEvent["INTERACTION_RESOLVED"] = "interaction-resolved";
+})(PRBEStateEvent || (exports.PRBEStateEvent = PRBEStateEvent = {}));
+// ---------------------------------------------------------------------------
+// PRBEAgentState
+// ---------------------------------------------------------------------------
+class PRBEAgentState extends events_1.EventEmitter {
+    // User-initiated investigation
+    isInvestigating = false;
+    events = [];
+    report = "";
+    summary = "";
+    currentQuery = "";
+    investigationError;
+    pendingInteraction;
+    // Completed user investigations (history)
+    completedInvestigations = [];
+    // Background context requests
+    activeCRs = new Map();
+    completedCRs = [];
+    // Tracked tickets
+    trackedTicketIDs = [];
+    ticketInfo = [];
+    // Computed
+    get hasActiveWork() {
+        return this.isInvestigating || this.activeCRs.size > 0;
+    }
+    get activeCRCount() {
+        return this.activeCRs.size;
+    }
+    get isActive() {
+        return this.isInvestigating || this.report.length > 0 || this.investigationError != null;
+    }
+    // ---------- User investigation mutations ----------
+    beginInvestigation(query) {
+        this.isInvestigating = true;
+        this.events = [];
+        this.report = "";
+        this.summary = "";
+        this.currentQuery = query;
+        this.investigationError = undefined;
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    resetInvestigation() {
+        this.isInvestigating = false;
+        this.events = [];
+        this.report = "";
+        this.summary = "";
+        this.currentQuery = "";
+        this.investigationError = undefined;
+        this.pendingInteraction = undefined;
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    appendEvent(label, detail, completed = false) {
+        // Mark previous event as completed before adding new one
+        if (this.events.length > 0) {
+            const last = this.events[this.events.length - 1];
+            if (!last.isCompleted && !completed) {
+                last.isCompleted = true;
+            }
+        }
+        const event = {
+            id: (0, crypto_1.randomUUID)(),
+            label,
+            detail,
+            isCompleted: completed,
+            isExpanded: false,
+        };
+        this.events.push(event);
+        this.emit(PRBEStateEvent.EVENT, event);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    attachObservation(text) {
+        if (this.events.length > 0) {
+            this.events[this.events.length - 1].detail = text;
+            this.emit(PRBEStateEvent.STATUS);
+        }
+    }
+    completeInvestigation(report, summary) {
+        if (this.events.length > 0) {
+            this.events[this.events.length - 1].isCompleted = true;
+        }
+        this.appendEvent("Done", undefined, true);
+        // Save to history
+        this.completedInvestigations.unshift({
+            id: (0, crypto_1.randomUUID)(),
+            query: this.currentQuery,
+            report,
+            summary,
+            completedAt: new Date(),
+        });
+        this.report = report;
+        this.summary = summary;
+        this.isInvestigating = false;
+        this.emit(PRBEStateEvent.COMPLETE, { report, summary });
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    failInvestigation(message) {
+        this.appendEvent(`Error: ${message}`);
+        this.investigationError = message;
+        this.isInvestigating = false;
+        this.emit(PRBEStateEvent.ERROR, { message });
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    // ---------- Interaction state mutations ----------
+    setPendingInteraction(payload) {
+        this.pendingInteraction = payload;
+        this.emit(PRBEStateEvent.INTERACTION_REQUESTED, payload);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    clearPendingInteraction() {
+        this.pendingInteraction = undefined;
+        this.emit(PRBEStateEvent.INTERACTION_RESOLVED);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    setCRPendingInteraction(crID, payload) {
+        const cr = this.activeCRs.get(crID);
+        if (!cr)
+            return;
+        cr.pendingInteraction = payload;
+        this.emit(PRBEStateEvent.INTERACTION_REQUESTED, payload);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    clearCRPendingInteraction(crID) {
+        const cr = this.activeCRs.get(crID);
+        if (!cr)
+            return;
+        cr.pendingInteraction = undefined;
+        this.emit(PRBEStateEvent.INTERACTION_RESOLVED);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    toggleExpansion(eventId) {
+        const event = this.events.find((e) => e.id === eventId);
+        if (event) {
+            event.isExpanded = !event.isExpanded;
+            this.emit(PRBEStateEvent.STATUS);
+        }
+    }
+    // ---------- CR state mutations ----------
+    beginCR(id, query, slug) {
+        const cr = {
+            id,
+            query,
+            slug,
+            events: [],
+            isRunning: true,
+            isCompleted: false,
+            isFailed: false,
+            report: "",
+            summary: "",
+            startedAt: new Date(),
+        };
+        this.activeCRs.set(id, cr);
+        this.emit(PRBEStateEvent.CR_START, cr);
+        this.emit(PRBEStateEvent.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];
+            if (!last.isCompleted && !completed) {
+                last.isCompleted = true;
+            }
+        }
+        cr.events.push({
+            id: (0, crypto_1.randomUUID)(),
+            label,
+            detail,
+            isCompleted: completed,
+            isExpanded: false,
+        });
+        this.emit(PRBEStateEvent.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;
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    completeCR(id, report, summary) {
+        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;
+        }
+        cr.events.push({
+            id: (0, crypto_1.randomUUID)(),
+            label: "Done",
+            isCompleted: true,
+            isExpanded: false,
+        });
+        cr.isRunning = false;
+        cr.isCompleted = true;
+        cr.report = report;
+        cr.summary = summary;
+        this.completedCRs.unshift(cr);
+        this.emit(PRBEStateEvent.CR_COMPLETE, cr);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    failCR(id, message) {
+        const cr = this.activeCRs.get(id);
+        if (!cr)
+            return;
+        this.activeCRs.delete(id);
+        cr.events.push({
+            id: (0, crypto_1.randomUUID)(),
+            label: `Error: ${message}`,
+            isCompleted: false,
+            isExpanded: false,
+        });
+        cr.isRunning = false;
+        cr.isFailed = true;
+        cr.errorMessage = message;
+        this.completedCRs.unshift(cr);
+        this.emit(PRBEStateEvent.CR_COMPLETE, cr);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    // ---------- Tickets ----------
+    updateTrackedTicketIDs(ids) {
+        this.trackedTicketIDs = ids;
+        this.emit(PRBEStateEvent.TICKETS_CHANGED, ids);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+    updateTicketInfo(info) {
+        this.ticketInfo = info;
+        this.emit(PRBEStateEvent.TICKET_INFO, info);
+        this.emit(PRBEStateEvent.STATUS);
+    }
+}
+exports.PRBEAgentState = PRBEAgentState;
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}

package/dist/tools/bash.d.ts

@@ -0,0 +1,30 @@
+/**
+ * tools/bash.ts — BashExecuteTool
+ *
+ * Allows the agent to execute shell commands during investigations.
+ * Uses a whitelist-only safety model: commands on the whitelist run without
+ * permission; everything else requires user approval.
+ *
+ * Platform-aware: uses separate whitelists for Unix and Windows, and
+ * runs commands via PowerShell on Windows for consistent behavior.
+ */
+import type { PRBEToolDeclaration } from "../models";
+import type { PRBEInteractionRequester } from "../interactions";
+import type { PRBETool } from "./index";
+export declare class BashExecuteTool implements PRBETool {
+    private readonly requester;
+    private readonly allowedRoots;
+    private readonly grantedPaths;
+    constructor(requester: PRBEInteractionRequester, allowedRoots: string[], grantedPaths: Set<string>);
+    get declaration(): PRBEToolDeclaration;
+    execute(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Check if a command is on the safe whitelist.
+     */
+    private isCommandSafe;
+    /**
+     * For piped commands, check that every segment uses a safe command.
+     */
+    private areAllPipeSegmentsSafe;
+}
+//# sourceMappingURL=bash.d.ts.map

package/dist/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,KAAK,EAAE,wBAAwB,EAA6B,MAAM,iBAAiB,CAAC;AAC3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAqDxC,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAGzC,SAAS,EAAE,wBAAwB,EACnC,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC;IAO3B,IAAI,WAAW,IAAI,mBAAmB,CA0BrC;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA+E7D;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAoB/B"}