@wrongstack/webui 0.265.1 → 0.268.0

package/dist/server/index.d.ts

@@ -1,6 +1,7 @@
 import { WebSocket } from 'ws';
-import { Agent, EventBus, SessionStore, ToolRegistry, ModelsRegistry, ConfigStore, SecretVault, JournalEntry, Logger, MemoryStore, Config, MCPRegistryHandle, ProviderConfig, ProviderApiKey, Context, SkillLoader } from '@wrongstack/core';
+import { Agent, EventBus, SessionStore, ToolRegistry, ModelsRegistry, ConfigStore, SecretVault, JournalEntry, Logger, MemoryStore, ProviderConfig, ProviderApiKey, Context, SkillLoader } from '@wrongstack/core';
 import * as http from 'node:http';
+import { MCPRegistry } from '@wrongstack/mcp';
 import { SkillInstaller } from '@wrongstack/core/skills';
 
 interface WSServerMessage {
@@ -402,6 +403,27 @@ declare function handleFilesList(ws: WebSocket, msg: unknown, projectRoot: strin
  * directory yields an empty-but-valid payload.
  */
 declare function handleGitInfo(ws: WebSocket, projectRoot: string): Promise<void>;
+/**
+ * Read the working-tree change set (everything that differs from HEAD:
+ * staged, unstaged, and untracked) and broadcast a `git.changes` message.
+ *
+ * The file list comes from `git status --porcelain -z` (NUL-delimited so
+ * paths with spaces/unicode survive intact, and renames are unambiguous).
+ * Per-file line counts come from `--numstat` of both the unstaged and the
+ * staged diff, summed. Untracked files intentionally report 0/0 here so the
+ * list view does not read every untracked file; `git.diff` loads a selected
+ * file lazily on demand.
+ * Never throws — a non-repo yields an empty list.
+ */
+declare function handleGitChanges(ws: WebSocket, projectRoot: string): Promise<void>;
+/**
+ * Resolve the before/after text for a single file and broadcast a `git.diff`
+ * message. `oldText` is the file at HEAD (`git show HEAD:<path>`), `newText`
+ * is the current working-tree content. New/untracked files have empty
+ * `oldText`; deleted files have empty `newText`. Binary or oversized files
+ * are reported with a flag instead of content so the client can show a notice.
+ */
+declare function handleGitDiff(ws: WebSocket, projectRoot: string, path: string): Promise<void>;
 
 /**
  * Shared memory-operation WebSocket handlers for both the standalone WebUI
@@ -431,30 +453,36 @@ declare function handleMemoryRemember(ws: WebSocket, msg: unknown, memoryStore:
 declare function handleMemoryForget(ws: WebSocket, msg: unknown, memoryStore: MemoryStore): Promise<void>;
 
 /**
- * MCP management handlers for the WebUI server.
- * Handles MCP-related WS messages from the browser client.
+ * MCP management handlers for the WebUI server (both the standalone
+ * `wrongstack webui` server and the CLI's embedded `--webui` server).
+ *
+ * These are thin WebSocket translators over the shared, surface-agnostic
+ * management core in `@wrongstack/mcp` (`manage.ts`) — the SAME core the REPL
+ * `/mcp` command writes against (same config.json, same MCPRegistry). All the
+ * config IO, url/header persistence, and live registry start/stop logic lives
+ * there; here we only map structured results to WS events the browser expects.
  */
 
-/** Handle mcp.list — return all configured MCP servers */
-declare function handleMcpList(ws: WebSocket, _msg: WSClientMessage, config: Config, _globalConfigPath: string, mcpRegistry?: MCPRegistryHandle): Promise<void>;
-/** Handle mcp.add — add a new MCP server configuration */
-declare function handleMcpAdd(ws: WebSocket, msg: WSClientMessage, config: Config, globalConfigPath: string, mcpRegistry?: MCPRegistryHandle): Promise<void>;
-/** Handle mcp.remove — remove an MCP server configuration */
-declare function handleMcpRemove(ws: WebSocket, msg: WSClientMessage, _config: Config, globalConfigPath: string, mcpRegistry?: MCPRegistryHandle): Promise<void>;
-/** Handle mcp.update — update an existing MCP server configuration */
-declare function handleMcpUpdate(ws: WebSocket, msg: WSClientMessage, _config: Config, globalConfigPath: string): Promise<void>;
-/** Handle mcp.wake — wake a sleeping MCP server (restart it) */
-declare function handleMcpWake(ws: WebSocket, msg: WSClientMessage, _config: Config, _globalConfigPath: string, mcpRegistry?: MCPRegistryHandle): Promise<void>;
-/** Handle mcp.sleep — put an MCP server to sleep (stop it) */
-declare function handleMcpSleep(ws: WebSocket, msg: WSClientMessage, _config: Config, _globalConfigPath: string, mcpRegistry?: MCPRegistryHandle): Promise<void>;
-/** Handle mcp.discover — perform one-time tool discovery on an MCP server */
-declare function handleMcpDiscover(ws: WebSocket, msg: WSClientMessage, _config: Config, _globalConfigPath: string, _mcpRegistry?: MCPRegistryHandle): Promise<void>;
-/** Handle mcp.enable — enable an MCP server */
-declare function handleMcpEnable(ws: WebSocket, msg: WSClientMessage, _config: Config, _globalConfigPath: string): Promise<void>;
-/** Handle mcp.disable — disable an MCP server */
-declare function handleMcpDisable(ws: WebSocket, msg: WSClientMessage, _config: Config, _globalConfigPath: string): Promise<void>;
-/** Handle mcp.restart — restart an MCP server */
-declare function handleMcpRestart(ws: WebSocket, msg: WSClientMessage, _config: Config, _globalConfigPath: string): Promise<void>;
+/** mcp.list — configured servers merged with live registry status + tools. */
+declare function handleMcpList(ws: WebSocket, _msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.add — persist a new server (incl. url/headers) and start it if enabled. */
+declare function handleMcpAdd(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.update — re-persist config (incl. url/headers) and re-apply to registry. */
+declare function handleMcpUpdate(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.remove — stop the server and delete it from config. */
+declare function handleMcpRemove(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.enable — flip enabled:true in config and start the server. */
+declare function handleMcpEnable(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.disable — stop the server and flip enabled:false in config. */
+declare function handleMcpDisable(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.sleep — stop a running server (config stays enabled). */
+declare function handleMcpSleep(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.wake — restart a sleeping/stopped server from config. */
+declare function handleMcpWake(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.restart — stop + start a server. */
+declare function handleMcpRestart(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
+/** mcp.discover — ensure the server is running and report its live tools. */
+declare function handleMcpDiscover(ws: WebSocket, msg: WSClientMessage, globalConfigPath: string, mcpRegistry?: MCPRegistry): Promise<void>;
 
 /**
  * Custom context modes — user-defined presets that are loaded from disk,
@@ -754,4 +782,4 @@ declare function startWebUI(opts?: WebUIOptions & {
     open?: boolean | undefined;
 }): Promise<void>;
 
-export { AutoPhaseWebSocketHandler, type BackendServices, type ConnectedClient, type ContextBreakdown, type CreateHttpServerOptions, type CustomContextMode, type CustomModeStore, type EternalBroadcast, type EternalSubscribe, type EternalSubscription, type KeyOpResult, type MessageTokenEntry, type ProvidersRecord, type ShellOpenRequest, type ShellOpenResult, type ShellOpenTarget, type SkillsContext, type ToolTokenEntry, type VerifyClientInput, type WSClientMessage, type WSServerMessage, type WebUIInstanceRecord, type WebUIOptions, addProvider, broadcast, browserOpenCommand, buildCspHeader, createCustomModeStore, createEternalSubscription, createHttpServer, createProviderConfigIO, defaultBaseDir, deleteKey, errMessage, estimateTokens, extractToken, findFreePort, formatInstances, generateAuthToken, handleFilesList, handleFilesRead, handleFilesTree, handleFilesWrite, handleGitInfo, handleMcpAdd, handleMcpDisable, handleMcpDiscover, handleMcpEnable, handleMcpList, handleMcpRemove, handleMcpRestart, handleMcpSleep, handleMcpUpdate, handleMcpWake, handleMemoryForget, handleMemoryList, handleMemoryRemember, handleShellOpen, handleSkillsContent, handleSkillsCreate, handleSkillsEdit, handleSkillsExport, handleSkillsInstall, handleSkillsUninstall, handleSkillsUpdate, hostHeaderOk, injectWsPort, isLoopbackBind, isLoopbackHostname, isPortFree, listInstances, loadSavedProviders, maskedKey, messagePreview, messageTokens, normalizeKeys, openBrowser, registerInstance, registryPath, removeProvider, saveProviders, send, sendResult, setActiveKey, startWebUI, stringifyContent, tokenMatches, unregisterInstance, upsertKey, verifyClient, writeKeysBack };
+export { AutoPhaseWebSocketHandler, type BackendServices, type ConnectedClient, type ContextBreakdown, type CreateHttpServerOptions, type CustomContextMode, type CustomModeStore, type EternalBroadcast, type EternalSubscribe, type EternalSubscription, type KeyOpResult, type MessageTokenEntry, type ProvidersRecord, type ShellOpenRequest, type ShellOpenResult, type ShellOpenTarget, type SkillsContext, type ToolTokenEntry, type VerifyClientInput, type WSClientMessage, type WSServerMessage, type WebUIInstanceRecord, type WebUIOptions, addProvider, broadcast, browserOpenCommand, buildCspHeader, createCustomModeStore, createEternalSubscription, createHttpServer, createProviderConfigIO, defaultBaseDir, deleteKey, errMessage, estimateTokens, extractToken, findFreePort, formatInstances, generateAuthToken, handleFilesList, handleFilesRead, handleFilesTree, handleFilesWrite, handleGitChanges, handleGitDiff, handleGitInfo, handleMcpAdd, handleMcpDisable, handleMcpDiscover, handleMcpEnable, handleMcpList, handleMcpRemove, handleMcpRestart, handleMcpSleep, handleMcpUpdate, handleMcpWake, handleMemoryForget, handleMemoryList, handleMemoryRemember, handleShellOpen, handleSkillsContent, handleSkillsCreate, handleSkillsEdit, handleSkillsExport, handleSkillsInstall, handleSkillsUninstall, handleSkillsUpdate, hostHeaderOk, injectWsPort, isLoopbackBind, isLoopbackHostname, isPortFree, listInstances, loadSavedProviders, maskedKey, messagePreview, messageTokens, normalizeKeys, openBrowser, registerInstance, registryPath, removeProvider, saveProviders, send, sendResult, setActiveKey, startWebUI, stringifyContent, tokenMatches, unregisterInstance, upsertKey, verifyClient, writeKeysBack };