@wrongstack/webui 0.155.0 → 0.250.0

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
 import { WebSocket } from 'ws';
-import { Agent, EventBus, SessionWriter, ToolRegistry, ModelsRegistry, ConfigStore, SecretVault, ProviderConfig, ProviderApiKey } from '@wrongstack/core';
+import { Agent, EventBus, SessionWriter, ToolRegistry, ModelsRegistry, ConfigStore, SecretVault, MemoryStore, ProviderConfig, ProviderApiKey, Context, Logger } from '@wrongstack/core';
 import * as http from 'node:http';
 
 interface WSServerMessage {
@@ -43,6 +43,12 @@ interface CreateHttpServerOptions {
      * is allowed to open a WebSocket back to the local server.
      */
     wsPort: number;
+    /**
+     * Path to the global WrongStack root (~/.wrongstack). Used by the
+     * /api/sessions and /api/sessions/:id/agents endpoints to read the
+     * cross-process SessionRegistry.
+     */
+    globalRoot?: string | undefined;
 }
 /**
  * Inject the live WS port into the served HTML so the frontend connects to
@@ -192,6 +198,118 @@ declare function errMessage(err: unknown): string;
  */
 declare function generateAuthToken(): string;
 
+/**
+ * Shared file-operation WebSocket handlers for both the standalone WebUI
+ * server and the CLI's `--webui` embedded server. Extracted from the
+ * duplicated switch cases in `index.ts` and `cli/src/webui-server.ts`.
+ *
+ * Each function handles the full request→response cycle for one message
+ * type. Callers drop them into their switch statement:
+ *
+ *   case 'files.tree': return handleFilesTree(ws, msg, projectRoot);
+ */
+
+/**
+ * Build and send a nested directory tree for the File Explorer.
+ *
+ * Walks `projectRoot` to depth 10 max, skipping heavyweight dirs
+ * (node_modules, .git, dist, …) and dot-entries. Responds with
+ * `{ type: 'files.tree', payload: { root, tree } }`.
+ */
+declare function handleFilesTree(ws: WebSocket, msg: unknown, projectRoot: string): Promise<void>;
+/**
+ * Read a file's content for the Monaco editor.
+ *
+ * Guards against path traversal (`../` escapes). Responds with
+ * `{ type: 'files.read', payload: { filePath, content } }`.
+ */
+declare function handleFilesRead(ws: WebSocket, msg: unknown, projectRoot: string): Promise<void>;
+/**
+ * Write file content back to disk (atomic write via tmp + rename).
+ *
+ * Guards against path traversal. Responds with
+ * `{ type: 'files.written', payload: { filePath, success } }`.
+ */
+declare function handleFilesWrite(ws: WebSocket, msg: unknown, projectRoot: string): Promise<void>;
+/**
+ * Lightweight project file picker for the chat `@` mention popup.
+ *
+ * Walks `projectRoot` (max depth 8), skipping hidden and heavyweight
+ * dirs, then fuzzy-ranks results against `query`. Responds with
+ * `{ type: 'files.list', payload: { files } }`.
+ */
+declare function handleFilesList(ws: WebSocket, msg: unknown, projectRoot: string): Promise<void>;
+
+/**
+ * Shared memory-operation WebSocket handlers for both the standalone WebUI
+ * server and the CLI's `--webui` embedded server. Extracted from the
+ * duplicated switch cases in `index.ts` and `cli/src/webui-server.ts`.
+ *
+ * Each function handles the full request→response cycle for one message
+ * type. Callers drop them into their switch statement:
+ *
+ *   case 'memory.list': return handleMemoryList(ws, memoryStore);
+ */
+
+/**
+ * List all memory entries across all scopes.
+ * Responds with `{ type: 'memory.list', payload: { text } }`.
+ */
+declare function handleMemoryList(ws: WebSocket, memoryStore: MemoryStore): Promise<void>;
+/**
+ * Persist a new memory entry.
+ * Responds with `{ type: 'key.operation_result', payload: { success, message } }`.
+ */
+declare function handleMemoryRemember(ws: WebSocket, msg: unknown, memoryStore: MemoryStore): Promise<void>;
+/**
+ * Remove memory entries matching the given text.
+ * Responds with `{ type: 'key.operation_result', payload: { success, message } }`.
+ */
+declare function handleMemoryForget(ws: WebSocket, msg: unknown, memoryStore: MemoryStore): Promise<void>;
+
+/**
+ * Custom context modes — user-defined presets that are loaded from disk,
+ * merged with the built-in modes, and managed via WebSocket CRUD handlers.
+ *
+ * Stored in: ~/.wrongstack/custom-context-modes.json
+ * Format: { "modes": ContextWindowMode[] }
+ */
+interface CustomContextMode {
+    id: string;
+    name: string;
+    description: string;
+    thresholds: {
+        warn: number;
+        soft: number;
+        hard: number;
+    };
+    aggressiveOn: string;
+    preserveK: number;
+    eliseThreshold: number;
+    targetLoad: number;
+    /** Whether this is a user-defined (custom) or built-in mode. */
+    custom: boolean;
+}
+interface CustomModeStore {
+    modes: Map<string, CustomContextMode>;
+    load: () => Promise<void>;
+    save: () => Promise<void>;
+    create: (mode: CustomContextMode) => {
+        ok: boolean;
+        error?: string | undefined;
+    };
+    update: (id: string, patch: Partial<CustomContextMode>) => {
+        ok: boolean;
+        error?: string | undefined;
+    };
+    remove: (id: string) => {
+        ok: boolean;
+        error?: string | undefined;
+    };
+    list: () => CustomContextMode[];
+}
+declare function createCustomModeStore(wrongstackDir: string): CustomModeStore;
+
 /** A hostname that refers to the local machine. */
 declare function isLoopbackHostname(hostname: string): boolean;
 /** True when the server is bound to a loopback interface (vs. LAN/0.0.0.0). */
@@ -312,10 +430,60 @@ declare function createProviderConfigIO(configPath: string): {
     save: (providers: Record<string, ProviderConfig>) => Promise<void>;
 };
 
+interface AutoPhaseWSMessage {
+    type: string;
+    payload?: Record<string, unknown>;
+}
+/**
+ * AutoPhaseWebSocketHandler — WebSocket-based AutoPhase control.
+ *
+ * Message types:
+ *   autophase.start   → { title, phases?, autonomous? }
+ *   autophase.pause   → {}
+ *   autophase.resume  → {}
+ *   autophase.stop    → {}
+ *   autophase.status  → {}
+ *   autophase.selectPhase → { phaseId }
+ *   autophase.taskStatus  → { taskId, status }
+ */
+declare class AutoPhaseWebSocketHandler {
+    private agent;
+    private context;
+    private logger;
+    private events?;
+    private projectRoot?;
+    private orchestrator;
+    private graph;
+    private store;
+    private clients;
+    private broadcastInterval;
+    /** Aborts in-flight task agents when the run is stopped. */
+    private abort;
+    /** Optional per-phase git-worktree isolation (lazily created at start). */
+    private worktrees;
+    constructor(agent: Agent, context: Context, logger: Logger, storeDir: string, events?: EventBus | undefined, projectRoot?: string | undefined);
+    addClient(ws: WebSocket): void;
+    handleMessage(msg: AutoPhaseWSMessage): Promise<void>;
+    private handleStart;
+    /** Generic fallback phases when the LLM planner produces nothing usable. */
+    private defaultPhases;
+    /** Plan phases+todos for the goal via the LLM; fall back to defaults on failure. */
+    private planPhases;
+    private executeTaskWithAgent;
+    private handleTaskStatusChange;
+    private startBroadcast;
+    private stopBroadcast;
+    private broadcastState;
+    private buildState;
+    private sendState;
+    private broadcast;
+    private send;
+}
+
 declare function startWebUI(opts?: {
     wsPort?: number | undefined;
     wsHost?: string | undefined;
     open?: boolean | undefined;
 }): Promise<void>;
 
-export { type BackendServices, type ConnectedClient, type KeyOpResult, type ProvidersRecord, type VerifyClientInput, type WSClientMessage, type WSServerMessage, type WebUIInstanceRecord, type WebUIOptions, addProvider, broadcast, browserOpenCommand, buildCspHeader, createHttpServer, createProviderConfigIO, defaultBaseDir, deleteKey, errMessage, extractToken, findFreePort, formatInstances, generateAuthToken, hostHeaderOk, injectWsPort, isLoopbackBind, isLoopbackHostname, isPortFree, listInstances, loadSavedProviders, maskedKey, normalizeKeys, openBrowser, registerInstance, registryPath, removeProvider, saveProviders, send, sendResult, setActiveKey, startWebUI, tokenMatches, unregisterInstance, upsertKey, verifyClient, writeKeysBack };
+export { AutoPhaseWebSocketHandler, type BackendServices, type ConnectedClient, type CustomContextMode, type CustomModeStore, type KeyOpResult, type ProvidersRecord, type VerifyClientInput, type WSClientMessage, type WSServerMessage, type WebUIInstanceRecord, type WebUIOptions, addProvider, broadcast, browserOpenCommand, buildCspHeader, createCustomModeStore, createHttpServer, createProviderConfigIO, defaultBaseDir, deleteKey, errMessage, extractToken, findFreePort, formatInstances, generateAuthToken, handleFilesList, handleFilesRead, handleFilesTree, handleFilesWrite, handleMemoryForget, handleMemoryList, handleMemoryRemember, hostHeaderOk, injectWsPort, isLoopbackBind, isLoopbackHostname, isPortFree, listInstances, loadSavedProviders, maskedKey, normalizeKeys, openBrowser, registerInstance, registryPath, removeProvider, saveProviders, send, sendResult, setActiveKey, startWebUI, tokenMatches, unregisterInstance, upsertKey, verifyClient, writeKeysBack };