@prbe.ai/electron-sdk 0.1.0

package/dist/agent.d.ts

@@ -0,0 +1,105 @@
+/**
+ * agent.ts — PRBEAgent class
+ *
+ * Main entry point for the PRBE debug agent SDK.
+ * Handles WebSocket connection to middleware, investigation lifecycle,
+ * background polling for context requests, file uploads, and persistence.
+ *
+ * Mirrors PRBEAgent.swift behavior.
+ */
+import type { PRBEAgentConfig, PRBEToolParameter, PollResponse, TicketInfoOut } from "./models";
+import { PRBEAgentState } from "./state";
+import { PRBELogCapture } from "./tools/logs";
+import { InvestigationSource } from "./interactions";
+import type { PRBEInteractionRequester, InteractionPayload, InteractionResponse } from "./interactions";
+export declare class PRBEAgent implements PRBEInteractionRequester {
+    readonly state: PRBEAgentState;
+    readonly logCapture: PRBELogCapture;
+    private readonly config;
+    private readonly interactionHandler?;
+    private readonly registry;
+    private readonly grantedPaths;
+    private userCancelled;
+    private activeWS;
+    private pollingTimer;
+    private persistedData;
+    private fetchAbortController;
+    private currentInvestigationSource;
+    private currentCRId;
+    /** Files flagged during the current tool call — uploaded immediately after the tool returns. */
+    private pendingFlaggedFiles;
+    private get agentID();
+    private get trackedTicketIDs();
+    private set trackedTicketIDs(value);
+    private get respondedCRIDs();
+    private set respondedCRIDs(value);
+    private syncPolling;
+    private addTrackedTicket;
+    constructor(config: PRBEAgentConfig);
+    private hookElectronLog;
+    private hookRendererLogs;
+    private static mapElectronLogLevel;
+    get investigationSource(): InvestigationSource;
+    requestUserInteraction(payload: InteractionPayload): Promise<InteractionResponse>;
+    /**
+     * Add an additional root directory to the runtime allowed roots.
+     */
+    addAllowedRoot(rootPath: string): void;
+    /**
+     * 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>): void;
+    /**
+     * 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).
+     */
+    cancelInvestigation(): void;
+    /**
+     * Cancel everything — user investigation and polling.
+     */
+    cancel(): void;
+    /**
+     * Poll the backend for context requests on tracked tickets.
+     */
+    poll(): Promise<PollResponse | null>;
+    /**
+     * Fetch ticket display info for all tracked tickets.
+     */
+    fetchTicketInfo(): Promise<TicketInfoOut[]>;
+    stopPolling(): void;
+    resumePolling(): void;
+    /**
+     * Destroy the agent — stops polling, stops console capture, closes WS.
+     */
+    destroy(): void;
+    /**
+     * Reset all persisted data (agent ID, tracked tickets, responded CRs).
+     * Also clears in-memory state.
+     */
+    resetPersistedData(): void;
+    /**
+     * Delete the persisted data file. Can be called without an agent instance.
+     */
+    static clearPersistedData(): void;
+    private investigateForCR;
+    private connectToProxy;
+    private sendCancel;
+    private extractArgs;
+    private extractUploadPrefix;
+    private static backgroundUpload;
+    private startPolling;
+    /**
+     * Abort all in-flight fetch requests to prevent orphaned DNS lookups
+     * that can crash the c-ares resolver during process shutdown.
+     */
+    private abortInFlightRequests;
+    /**
+     * Get an AbortSignal for fetch requests. Creates a new controller if needed.
+     */
+    private getFetchSignal;
+    private post;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

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