pi-app-server 0.1.0

package/dist/server-command-handlers.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Server Command Handlers - extensible server command dispatch via handler map.
+ *
+ * Mirrors the command-router.ts pattern for consistency.
+ * Each handler is a self-contained function that executes against
+ * the session manager context and returns a response.
+ *
+ * This extraction from session-manager.ts enables:
+ * - O(1) dispatch (handler map vs switch)
+ * - Isolated testing of server commands
+ * - Easy addition of new server commands
+ * - Smaller session-manager.ts (orchestration only)
+ */
+import type { AgentSession } from "@mariozechner/pi-coding-agent";
+import type { RpcResponse, SessionInfo, StoredSessionInfo } from "./types.js";
+/**
+ * Context provided to server command handlers.
+ * Contains everything handlers need without direct SessionManager coupling.
+ */
+export interface ServerCommandContext {
+    /** Resolve sessions by ID */
+    getSession: (sessionId: string) => AgentSession | undefined;
+    /** Get session info (includes metadata) */
+    getSessionInfo: (sessionId: string) => SessionInfo | undefined;
+    /** List all active sessions */
+    listSessions: () => SessionInfo[];
+    /** Create a new session */
+    createSession: (sessionId: string, cwd?: string) => Promise<SessionInfo>;
+    /** Delete a session */
+    deleteSession: (sessionId: string) => Promise<void>;
+    /** Load a session from a stored file */
+    loadSession: (sessionId: string, sessionPath: string) => Promise<SessionInfo>;
+    /** List stored sessions that can be loaded */
+    listStoredSessions: () => Promise<StoredSessionInfo[]>;
+    /** Get metrics from governor and stores */
+    getMetrics: () => RpcResponse;
+    /** Get memory sink metrics (optional, for ADR-0016 metrics system) */
+    getMemoryMetrics?: () => Record<string, unknown> | undefined;
+    /** Health check */
+    getHealth: () => RpcResponse;
+    /** Handle extension UI response */
+    handleUIResponse: (command: {
+        id?: string;
+        sessionId: string;
+        type: "extension_ui_response";
+        requestId: string;
+        response: any;
+    }) => {
+        success: boolean;
+        error?: string;
+    };
+    /** Route session command to appropriate handler */
+    routeSessionCommand: (session: AgentSession, command: any, getSessionInfo: (sessionId: string) => SessionInfo | undefined) => Promise<RpcResponse> | RpcResponse | undefined;
+    /** Generate a unique session ID */
+    generateSessionId: () => string;
+    /** Record heartbeat for session activity */
+    recordHeartbeat: (sessionId: string) => void;
+    /** Get circuit breaker manager */
+    getCircuitBreakers: () => {
+        hasOpenCircuit: () => boolean;
+        getBreaker: (provider: string) => {
+            canExecute: () => {
+                allowed: boolean;
+                reason?: string;
+            };
+            recordSuccess: (elapsedMs: number) => void;
+            recordFailure: (type: "timeout" | "error") => void;
+        };
+    };
+    /** Get bash circuit breaker */
+    getBashCircuitBreaker: () => {
+        canExecute: (sessionId: string) => {
+            allowed: boolean;
+            reason?: string;
+        };
+        recordSuccess: (sessionId: string) => void;
+        recordTimeout: (sessionId: string) => void;
+        recordSpawnError: (sessionId: string) => void;
+        hasOpenCircuit: () => boolean;
+        getMetrics: () => {
+            enabled: boolean;
+            globalState: string;
+            sessionCount: number;
+            openSessionCount: number;
+            totalCalls: number;
+            totalTimeouts: number;
+            totalRejected: number;
+        };
+    };
+    /** Get default command timeout in ms */
+    getDefaultCommandTimeoutMs: () => number;
+}
+export type ServerCommandHandler = (command: any, context: ServerCommandContext) => Promise<RpcResponse> | RpcResponse;
+/**
+ * Execute an LLM command with circuit breaker protection.
+ * Returns undefined if not an LLM command (caller should route normally).
+ */
+export declare function executeLLMCommand(command: any, session: AgentSession, context: ServerCommandContext): Promise<RpcResponse | undefined>;
+/**
+ * Execute a bash command with circuit breaker protection.
+ * Returns undefined if not a bash command (caller should route normally).
+ *
+ * Design: docs/design-bash-circuit-breaker.md
+ *
+ * Key difference from LLM circuit breaker:
+ * - Only TIMEOUT counts as failure (non-zero exit codes are often legitimate)
+ * - Hybrid protection: per-session + global circuit breakers
+ */
+export declare function executeBashCommand(command: any, session: AgentSession, context: ServerCommandContext): Promise<RpcResponse | undefined>;
+export declare const serverCommandHandlers: Record<string, ServerCommandHandler>;
+/**
+ * Route a server command to the appropriate handler.
+ * Returns a response or undefined if no handler exists (unknown command).
+ */
+export declare function routeServerCommand(command: any, context: ServerCommandContext): Promise<RpcResponse> | RpcResponse | undefined;
+/**
+ * Get list of supported server command types.
+ */
+export declare function getSupportedServerCommands(): string[];
+//# sourceMappingURL=server-command-handlers.d.ts.map

package/dist/server-command-handlers.d.ts.map

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

package/dist/server-command-handlers.js

@@ -0,0 +1,234 @@
+const handleListSessions = async (_command, context) => {
+  return {
+    type: "response",
+    command: "list_sessions",
+    success: true,
+    data: { sessions: context.listSessions() }
+  };
+};
+const handleCreateSession = async (command, context) => {
+  const sessionId = command.sessionId ?? context.generateSessionId();
+  const sessionInfo = await context.createSession(sessionId, command.cwd);
+  return {
+    type: "response",
+    command: "create_session",
+    success: true,
+    data: { sessionId, sessionInfo }
+  };
+};
+const handleDeleteSession = async (command, context) => {
+  await context.deleteSession(command.sessionId);
+  return {
+    type: "response",
+    command: "delete_session",
+    success: true,
+    data: { deleted: true }
+  };
+};
+const handleSwitchSession = (command, context) => {
+  const sessionInfo = context.getSessionInfo(command.sessionId);
+  if (!sessionInfo) {
+    return {
+      type: "response",
+      command: "switch_session",
+      success: false,
+      error: `Session ${command.sessionId} not found`
+    };
+  }
+  return {
+    type: "response",
+    command: "switch_session",
+    success: true,
+    data: { sessionInfo }
+  };
+};
+const handleListStoredSessions = async (_command, context) => {
+  const storedSessions = await context.listStoredSessions();
+  return {
+    type: "response",
+    command: "list_stored_sessions",
+    success: true,
+    data: { sessions: storedSessions }
+  };
+};
+const handleLoadSession = async (command, context) => {
+  const sessionId = command.sessionId ?? context.generateSessionId();
+  try {
+    const sessionInfo = await context.loadSession(sessionId, command.sessionPath);
+    return {
+      type: "response",
+      command: "load_session",
+      success: true,
+      data: { sessionId, sessionInfo }
+    };
+  } catch (error) {
+    return {
+      type: "response",
+      command: "load_session",
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+};
+const handleGetMetrics = (_command, context) => {
+  const response = context.getMetrics();
+  if (context.getMemoryMetrics && response.success) {
+    const memoryMetrics = context.getMemoryMetrics();
+    if (memoryMetrics && "data" in response && response.data) {
+      response.data.metrics = memoryMetrics;
+    }
+  }
+  return response;
+};
+const handleHealthCheck = (_command, context) => {
+  return context.getHealth();
+};
+const handleExtensionUIResponse = (command, context) => {
+  const result = context.handleUIResponse({
+    id: command.id,
+    sessionId: command.sessionId,
+    type: "extension_ui_response",
+    requestId: command.requestId,
+    response: command.response
+  });
+  if (result.success) {
+    return {
+      id: command.id,
+      type: "response",
+      command: "extension_ui_response",
+      success: true
+    };
+  }
+  return {
+    id: command.id,
+    type: "response",
+    command: "extension_ui_response",
+    success: false,
+    error: result.error ?? "Unknown error"
+  };
+};
+const LLM_COMMANDS = /* @__PURE__ */ new Set(["prompt", "steer", "follow_up", "compact"]);
+async function executeLLMCommand(command, session, context) {
+  const commandType = command.type;
+  const provider = session.model?.provider;
+  if (!LLM_COMMANDS.has(commandType) || !provider) {
+    return void 0;
+  }
+  const breaker = context.getCircuitBreakers().getBreaker(provider);
+  const breakerCheck = breaker.canExecute();
+  if (!breakerCheck.allowed) {
+    return {
+      id: command.id,
+      type: "response",
+      command: commandType,
+      success: false,
+      error: breakerCheck.reason ?? "Circuit breaker open"
+    };
+  }
+  const startTime = Date.now();
+  try {
+    const routed = context.routeSessionCommand(session, command, context.getSessionInfo);
+    if (routed === void 0) {
+      return void 0;
+    }
+    const response = await Promise.resolve(routed);
+    const elapsedMs = Date.now() - startTime;
+    if (response.success) {
+      breaker.recordSuccess(elapsedMs);
+    } else {
+      const errorMsg = response.error?.toLowerCase() ?? "";
+      if (errorMsg.includes("timeout") || errorMsg.includes("timed out")) {
+        breaker.recordFailure("timeout");
+      } else {
+        breaker.recordFailure("error");
+      }
+    }
+    return response;
+  } catch (error) {
+    const elapsedMs = Date.now() - startTime;
+    const errorMsg = error instanceof Error ? error.message.toLowerCase() : "";
+    if (errorMsg.includes("timeout") || elapsedMs >= context.getDefaultCommandTimeoutMs()) {
+      breaker.recordFailure("timeout");
+    } else {
+      breaker.recordFailure("error");
+    }
+    throw error;
+  }
+}
+async function executeBashCommand(command, session, context) {
+  const commandType = command.type;
+  const sessionId = command.sessionId;
+  if (commandType !== "bash") {
+    return void 0;
+  }
+  const bashBreaker = context.getBashCircuitBreaker();
+  const breakerCheck = bashBreaker.canExecute(sessionId);
+  if (!breakerCheck.allowed) {
+    return {
+      id: command.id,
+      type: "response",
+      command: commandType,
+      success: false,
+      error: breakerCheck.reason ?? "Bash circuit breaker open"
+    };
+  }
+  try {
+    const routed = context.routeSessionCommand(session, command, context.getSessionInfo);
+    if (routed === void 0) {
+      return void 0;
+    }
+    const response = await Promise.resolve(routed);
+    if (response.success) {
+      bashBreaker.recordSuccess(sessionId);
+    } else {
+      const errorMsg = (response.error ?? "").toLowerCase();
+      if (errorMsg.includes("timeout") || errorMsg.includes("timed out")) {
+        bashBreaker.recordTimeout(sessionId);
+      } else {
+        bashBreaker.recordSuccess(sessionId);
+      }
+    }
+    return response;
+  } catch (error) {
+    const errorMsg = error instanceof Error ? error.message.toLowerCase() : "";
+    if (errorMsg.includes("timeout") || errorMsg.includes("timed out")) {
+      bashBreaker.recordTimeout(sessionId);
+    } else {
+      bashBreaker.recordSpawnError(sessionId);
+    }
+    throw error;
+  }
+}
+const serverCommandHandlers = {
+  // Session lifecycle
+  list_sessions: handleListSessions,
+  create_session: handleCreateSession,
+  delete_session: handleDeleteSession,
+  switch_session: handleSwitchSession,
+  // Persistence (ADR-0007)
+  list_stored_sessions: handleListStoredSessions,
+  load_session: handleLoadSession,
+  // Metrics & health
+  get_metrics: handleGetMetrics,
+  health_check: handleHealthCheck,
+  // Extension UI
+  extension_ui_response: handleExtensionUIResponse
+};
+function routeServerCommand(command, context) {
+  const handler = serverCommandHandlers[command.type];
+  if (!handler) {
+    return void 0;
+  }
+  return handler(command, context);
+}
+function getSupportedServerCommands() {
+  return Object.keys(serverCommandHandlers);
+}
+export {
+  executeBashCommand,
+  executeLLMCommand,
+  getSupportedServerCommands,
+  routeServerCommand,
+  serverCommandHandlers
+};
+//# sourceMappingURL=server-command-handlers.js.map

package/dist/server-command-handlers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/server-command-handlers.ts"],
+  "sourcesContent": ["/**\n * Server Command Handlers - extensible server command dispatch via handler map.\n *\n * Mirrors the command-router.ts pattern for consistency.\n * Each handler is a self-contained function that executes against\n * the session manager context and returns a response.\n *\n * This extraction from session-manager.ts enables:\n * - O(1) dispatch (handler map vs switch)\n * - Isolated testing of server commands\n * - Easy addition of new server commands\n * - Smaller session-manager.ts (orchestration only)\n */\n\nimport type { AgentSession } from \"@mariozechner/pi-coding-agent\";\nimport type { RpcResponse, SessionInfo, StoredSessionInfo } from \"./types.js\";\n\n// =============================================================================\n// HANDLER TYPE\n// =============================================================================\n\n/**\n * Context provided to server command handlers.\n * Contains everything handlers need without direct SessionManager coupling.\n */\nexport interface ServerCommandContext {\n  /** Resolve sessions by ID */\n  getSession: (sessionId: string) => AgentSession | undefined;\n  /** Get session info (includes metadata) */\n  getSessionInfo: (sessionId: string) => SessionInfo | undefined;\n  /** List all active sessions */\n  listSessions: () => SessionInfo[];\n  /** Create a new session */\n  createSession: (sessionId: string, cwd?: string) => Promise<SessionInfo>;\n  /** Delete a session */\n  deleteSession: (sessionId: string) => Promise<void>;\n  /** Load a session from a stored file */\n  loadSession: (sessionId: string, sessionPath: string) => Promise<SessionInfo>;\n  /** List stored sessions that can be loaded */\n  listStoredSessions: () => Promise<StoredSessionInfo[]>;\n  /** Get metrics from governor and stores */\n  getMetrics: () => RpcResponse;\n  /** Get memory sink metrics (optional, for ADR-0016 metrics system) */\n  getMemoryMetrics?: () => Record<string, unknown> | undefined;\n  /** Health check */\n  getHealth: () => RpcResponse;\n  /** Handle extension UI response */\n  handleUIResponse: (command: {\n    id?: string;\n    sessionId: string;\n    type: \"extension_ui_response\";\n    requestId: string;\n    response: any;\n  }) => { success: boolean; error?: string };\n  /** Route session command to appropriate handler */\n  routeSessionCommand: (\n    session: AgentSession,\n    command: any,\n    getSessionInfo: (sessionId: string) => SessionInfo | undefined\n  ) => Promise<RpcResponse> | RpcResponse | undefined;\n  /** Generate a unique session ID */\n  generateSessionId: () => string;\n  /** Record heartbeat for session activity */\n  recordHeartbeat: (sessionId: string) => void;\n  /** Get circuit breaker manager */\n  getCircuitBreakers: () => {\n    hasOpenCircuit: () => boolean;\n    getBreaker: (provider: string) => {\n      canExecute: () => { allowed: boolean; reason?: string };\n      recordSuccess: (elapsedMs: number) => void;\n      recordFailure: (type: \"timeout\" | \"error\") => void;\n    };\n  };\n  /** Get bash circuit breaker */\n  getBashCircuitBreaker: () => {\n    canExecute: (sessionId: string) => { allowed: boolean; reason?: string };\n    recordSuccess: (sessionId: string) => void;\n    recordTimeout: (sessionId: string) => void;\n    recordSpawnError: (sessionId: string) => void;\n    hasOpenCircuit: () => boolean;\n    getMetrics: () => {\n      enabled: boolean;\n      globalState: string;\n      sessionCount: number;\n      openSessionCount: number;\n      totalCalls: number;\n      totalTimeouts: number;\n      totalRejected: number;\n    };\n  };\n  /** Get default command timeout in ms */\n  getDefaultCommandTimeoutMs: () => number;\n}\n\nexport type ServerCommandHandler = (\n  command: any,\n  context: ServerCommandContext\n) => Promise<RpcResponse> | RpcResponse;\n\n// =============================================================================\n// SESSION LIFECYCLE HANDLERS\n// =============================================================================\n\nconst handleListSessions: ServerCommandHandler = async (_command, context) => {\n  return {\n    type: \"response\" as const,\n    command: \"list_sessions\" as const,\n    success: true,\n    data: { sessions: context.listSessions() },\n  };\n};\n\nconst handleCreateSession: ServerCommandHandler = async (command, context) => {\n  const sessionId = command.sessionId ?? context.generateSessionId();\n  const sessionInfo = await context.createSession(sessionId, command.cwd);\n  return {\n    type: \"response\" as const,\n    command: \"create_session\" as const,\n    success: true,\n    data: { sessionId, sessionInfo },\n  };\n};\n\nconst handleDeleteSession: ServerCommandHandler = async (command, context) => {\n  await context.deleteSession(command.sessionId);\n  return {\n    type: \"response\" as const,\n    command: \"delete_session\" as const,\n    success: true,\n    data: { deleted: true },\n  };\n};\n\nconst handleSwitchSession: ServerCommandHandler = (command, context) => {\n  const sessionInfo = context.getSessionInfo(command.sessionId);\n  if (!sessionInfo) {\n    return {\n      type: \"response\" as const,\n      command: \"switch_session\" as const,\n      success: false,\n      error: `Session ${command.sessionId} not found`,\n    };\n  }\n  return {\n    type: \"response\" as const,\n    command: \"switch_session\" as const,\n    success: true,\n    data: { sessionInfo },\n  };\n};\n\n// =============================================================================\n// PERSISTENCE HANDLERS (ADR-0007)\n// =============================================================================\n\nconst handleListStoredSessions: ServerCommandHandler = async (_command, context) => {\n  const storedSessions = await context.listStoredSessions();\n  return {\n    type: \"response\" as const,\n    command: \"list_stored_sessions\" as const,\n    success: true,\n    data: { sessions: storedSessions },\n  };\n};\n\nconst handleLoadSession: ServerCommandHandler = async (command, context) => {\n  const sessionId = command.sessionId ?? context.generateSessionId();\n  try {\n    const sessionInfo = await context.loadSession(sessionId, command.sessionPath);\n    return {\n      type: \"response\" as const,\n      command: \"load_session\" as const,\n      success: true,\n      data: { sessionId, sessionInfo },\n    };\n  } catch (error) {\n    return {\n      type: \"response\" as const,\n      command: \"load_session\" as const,\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n};\n\n// =============================================================================\n// METRICS & HEALTH HANDLERS\n// =============================================================================\n\nconst handleGetMetrics: ServerCommandHandler = (_command, context) => {\n  const response = context.getMetrics();\n  // Add memory sink metrics if available (ADR-0016)\n  if (context.getMemoryMetrics && response.success) {\n    const memoryMetrics = context.getMemoryMetrics();\n    if (memoryMetrics && \"data\" in response && response.data) {\n      (response.data as Record<string, unknown>).metrics = memoryMetrics;\n    }\n  }\n  return response;\n};\n\nconst handleHealthCheck: ServerCommandHandler = (_command, context) => {\n  return context.getHealth();\n};\n\n// =============================================================================\n// EXTENSION UI HANDLER\n// =============================================================================\n\nconst handleExtensionUIResponse: ServerCommandHandler = (command, context) => {\n  const result = context.handleUIResponse({\n    id: command.id,\n    sessionId: command.sessionId,\n    type: \"extension_ui_response\",\n    requestId: command.requestId,\n    response: command.response,\n  });\n\n  if (result.success) {\n    return {\n      id: command.id,\n      type: \"response\" as const,\n      command: \"extension_ui_response\" as const,\n      success: true,\n    };\n  }\n  return {\n    id: command.id,\n    type: \"response\" as const,\n    command: \"extension_ui_response\" as const,\n    success: false,\n    error: result.error ?? \"Unknown error\",\n  };\n};\n\n// =============================================================================\n// LLM COMMAND EXECUTION HELPER\n// =============================================================================\n\n/** LLM commands that should be protected by circuit breaker */\nconst LLM_COMMANDS = new Set([\"prompt\", \"steer\", \"follow_up\", \"compact\"]);\n\n/**\n * Execute an LLM command with circuit breaker protection.\n * Returns undefined if not an LLM command (caller should route normally).\n */\nexport async function executeLLMCommand(\n  command: any,\n  session: AgentSession,\n  context: ServerCommandContext\n): Promise<RpcResponse | undefined> {\n  const commandType = command.type;\n  const provider = session.model?.provider;\n\n  // Not an LLM command - let normal routing handle it\n  if (!LLM_COMMANDS.has(commandType) || !provider) {\n    return undefined;\n  }\n\n  const breaker = context.getCircuitBreakers().getBreaker(provider);\n  const breakerCheck = breaker.canExecute();\n\n  if (!breakerCheck.allowed) {\n    return {\n      id: command.id,\n      type: \"response\" as const,\n      command: commandType,\n      success: false,\n      error: breakerCheck.reason ?? \"Circuit breaker open\",\n    };\n  }\n\n  const startTime = Date.now();\n  try {\n    const routed = context.routeSessionCommand(session, command, context.getSessionInfo);\n    if (routed === undefined) {\n      return undefined;\n    }\n\n    const response = await Promise.resolve(routed);\n    const elapsedMs = Date.now() - startTime;\n\n    if (response.success) {\n      breaker.recordSuccess(elapsedMs);\n    } else {\n      const errorMsg = response.error?.toLowerCase() ?? \"\";\n      if (errorMsg.includes(\"timeout\") || errorMsg.includes(\"timed out\")) {\n        breaker.recordFailure(\"timeout\");\n      } else {\n        breaker.recordFailure(\"error\");\n      }\n    }\n\n    return response;\n  } catch (error) {\n    const elapsedMs = Date.now() - startTime;\n    const errorMsg = error instanceof Error ? error.message.toLowerCase() : \"\";\n    if (errorMsg.includes(\"timeout\") || elapsedMs >= context.getDefaultCommandTimeoutMs()) {\n      breaker.recordFailure(\"timeout\");\n    } else {\n      breaker.recordFailure(\"error\");\n    }\n    throw error;\n  }\n}\n\n// =============================================================================\n// BASH COMMAND EXECUTION HELPER\n// =============================================================================\n\n/**\n * Execute a bash command with circuit breaker protection.\n * Returns undefined if not a bash command (caller should route normally).\n *\n * Design: docs/design-bash-circuit-breaker.md\n *\n * Key difference from LLM circuit breaker:\n * - Only TIMEOUT counts as failure (non-zero exit codes are often legitimate)\n * - Hybrid protection: per-session + global circuit breakers\n */\nexport async function executeBashCommand(\n  command: any,\n  session: AgentSession,\n  context: ServerCommandContext\n): Promise<RpcResponse | undefined> {\n  const commandType = command.type;\n  const sessionId = command.sessionId;\n\n  // Not a bash command - let normal routing handle it\n  if (commandType !== \"bash\") {\n    return undefined;\n  }\n\n  const bashBreaker = context.getBashCircuitBreaker();\n  const breakerCheck = bashBreaker.canExecute(sessionId);\n\n  if (!breakerCheck.allowed) {\n    return {\n      id: command.id,\n      type: \"response\" as const,\n      command: commandType,\n      success: false,\n      error: breakerCheck.reason ?? \"Bash circuit breaker open\",\n    };\n  }\n\n  try {\n    const routed = context.routeSessionCommand(session, command, context.getSessionInfo);\n    if (routed === undefined) {\n      return undefined;\n    }\n\n    const response = await Promise.resolve(routed);\n\n    // Determine if this was a timeout\n    // Only TIMEOUT counts as failure - non-zero exit codes are legitimate\n    if (response.success) {\n      bashBreaker.recordSuccess(sessionId);\n    } else {\n      const errorMsg = (response.error ?? \"\").toLowerCase();\n      if (errorMsg.includes(\"timeout\") || errorMsg.includes(\"timed out\")) {\n        bashBreaker.recordTimeout(sessionId);\n      } else {\n        // Non-timeout error (e.g., exit code != 0) - record success\n        // The command executed, just didn't succeed\n        bashBreaker.recordSuccess(sessionId);\n      }\n    }\n\n    return response;\n  } catch (error) {\n    // Exception during execution - check if timeout\n    const errorMsg = error instanceof Error ? error.message.toLowerCase() : \"\";\n    if (errorMsg.includes(\"timeout\") || errorMsg.includes(\"timed out\")) {\n      bashBreaker.recordTimeout(sessionId);\n    } else {\n      // Spawn error or other - treat as error (not timeout)\n      bashBreaker.recordSpawnError(sessionId);\n    }\n    throw error;\n  }\n}\n\n// =============================================================================\n// HANDLER MAP\n// =============================================================================\n\nexport const serverCommandHandlers: Record<string, ServerCommandHandler> = {\n  // Session lifecycle\n  list_sessions: handleListSessions,\n  create_session: handleCreateSession,\n  delete_session: handleDeleteSession,\n  switch_session: handleSwitchSession,\n  // Persistence (ADR-0007)\n  list_stored_sessions: handleListStoredSessions,\n  load_session: handleLoadSession,\n  // Metrics & health\n  get_metrics: handleGetMetrics,\n  health_check: handleHealthCheck,\n  // Extension UI\n  extension_ui_response: handleExtensionUIResponse,\n};\n\n// =============================================================================\n// ROUTING FUNCTION\n// =============================================================================\n\n/**\n * Route a server command to the appropriate handler.\n * Returns a response or undefined if no handler exists (unknown command).\n */\nexport function routeServerCommand(\n  command: any,\n  context: ServerCommandContext\n): Promise<RpcResponse> | RpcResponse | undefined {\n  const handler = serverCommandHandlers[command.type];\n  if (!handler) {\n    return undefined;\n  }\n  return handler(command, context);\n}\n\n/**\n * Get list of supported server command types.\n */\nexport function getSupportedServerCommands(): string[] {\n  return Object.keys(serverCommandHandlers);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/server-ui-context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Server UI Context - implements ExtensionUIContext for remote clients.
+ *
+ * Extension UI requests (select, confirm, input, etc.) are:
+ * 1. Broadcast to all subscribed clients via extension_ui_request event
+ * 2. Tracked as pending requests in ExtensionUIManager
+ * 3. Resolved when a client sends extension_ui_response command
+ *
+ * This enables skills, prompt templates, and custom tools that need user input
+ * to work over the WebSocket/stdio transport.
+ */
+import type { ExtensionUIContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionUIManager } from "./extension-ui.js";
+/**
+ * Create an ExtensionUIContext that routes UI requests to remote clients.
+ *
+ * @param sessionId The session ID for request routing
+ * @param extensionUI The manager that tracks pending requests
+ * @param broadcast Function to broadcast events to subscribers
+ */
+export declare function createServerUIContext(sessionId: string, extensionUI: ExtensionUIManager, broadcast: (sessionId: string, event: any) => void): ExtensionUIContext;
+//# sourceMappingURL=server-ui-context.d.ts.map

package/dist/server-ui-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-ui-context.d.ts","sourceRoot":"","sources":["../src/server-ui-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQ5D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GACjD,kBAAkB,CAqQpB"}

package/dist/server-ui-context.js

@@ -0,0 +1,221 @@
+import {
+  isSelectResponse,
+  isConfirmResponse,
+  isInputResponse,
+  isEditorResponse
+} from "./extension-ui.js";
+function createServerUIContext(sessionId, extensionUI, broadcast) {
+  return {
+    async select(title, options, opts) {
+      const request = extensionUI.createPendingRequest(sessionId, "select", {
+        title,
+        options,
+        timeout: opts?.timeout
+      });
+      if (!request) return void 0;
+      extensionUI.broadcastUIRequest(sessionId, request.requestId, "select", {
+        title,
+        options,
+        timeout: opts?.timeout
+      });
+      try {
+        const response = await raceWithAbortAndSignal(
+          request.promise,
+          opts?.signal,
+          () => extensionUI.cancelRequest(request.requestId)
+        );
+        if (response.method === "cancelled") return void 0;
+        if (isSelectResponse(response)) return response.value;
+        return void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    async confirm(title, message, opts) {
+      const request = extensionUI.createPendingRequest(sessionId, "confirm", {
+        title,
+        message,
+        timeout: opts?.timeout
+      });
+      if (!request) return false;
+      extensionUI.broadcastUIRequest(sessionId, request.requestId, "confirm", {
+        title,
+        message,
+        timeout: opts?.timeout
+      });
+      try {
+        const response = await raceWithAbortAndSignal(
+          request.promise,
+          opts?.signal,
+          () => extensionUI.cancelRequest(request.requestId)
+        );
+        if (response.method === "cancelled") return false;
+        if (isConfirmResponse(response)) return response.confirmed;
+        return false;
+      } catch {
+        return false;
+      }
+    },
+    async input(title, placeholder, opts) {
+      const request = extensionUI.createPendingRequest(sessionId, "input", {
+        title,
+        placeholder,
+        timeout: opts?.timeout
+      });
+      if (!request) return void 0;
+      extensionUI.broadcastUIRequest(sessionId, request.requestId, "input", {
+        title,
+        placeholder,
+        timeout: opts?.timeout
+      });
+      try {
+        const response = await raceWithAbortAndSignal(
+          request.promise,
+          opts?.signal,
+          () => extensionUI.cancelRequest(request.requestId)
+        );
+        if (response.method === "cancelled") return void 0;
+        if (isInputResponse(response)) return response.value;
+        return void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    async editor(title, prefill) {
+      const request = extensionUI.createPendingRequest(sessionId, "editor", {
+        title,
+        prefill
+      });
+      if (!request) return void 0;
+      extensionUI.broadcastUIRequest(sessionId, request.requestId, "editor", {
+        title,
+        prefill
+      });
+      try {
+        const response = await raceWithAbortAndSignal(
+          request.promise,
+          void 0,
+          // editor doesn't typically use abort signal
+          () => extensionUI.cancelRequest(request.requestId)
+        );
+        if (response.method === "cancelled") return void 0;
+        if (isEditorResponse(response)) return response.value;
+        return void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    notify(message, type) {
+      broadcast(sessionId, {
+        type: "extension_ui_request",
+        requestId: `notify-${Date.now()}`,
+        // Ephemeral, no response expected
+        method: "notify",
+        message,
+        notifyType: type ?? "info"
+      });
+    },
+    onTerminalInput(_handler) {
+      return () => {
+      };
+    },
+    setStatus(key, text) {
+      broadcast(sessionId, {
+        type: "extension_ui_request",
+        requestId: `status-${key}-${Date.now()}`,
+        method: "setStatus",
+        key,
+        text
+      });
+    },
+    setWorkingMessage(message) {
+      broadcast(sessionId, {
+        type: "extension_ui_request",
+        requestId: `working-${Date.now()}`,
+        method: "setWorkingMessage",
+        message
+      });
+    },
+    setWidget(key, content, options) {
+      if (Array.isArray(content) || content === void 0) {
+        broadcast(sessionId, {
+          type: "extension_ui_request",
+          requestId: `widget-${key}-${Date.now()}`,
+          method: "setWidget",
+          key,
+          content,
+          placement: options?.placement
+        });
+      }
+    },
+    setFooter(_factory) {
+    },
+    setHeader(_factory) {
+    },
+    setTitle(title) {
+      broadcast(sessionId, {
+        type: "extension_ui_request",
+        requestId: `title-${Date.now()}`,
+        method: "setTitle",
+        title
+      });
+    },
+    async custom(_factory, _options) {
+      throw new Error("Custom components are not supported in server mode");
+    },
+    pasteToEditor(_text) {
+    },
+    setEditorText(_text) {
+    },
+    getEditorText() {
+      return "";
+    },
+    setEditorComponent(_factory) {
+    },
+    // Theme methods - return stubs since themes are TUI-specific
+    get theme() {
+      return {
+        // Minimal theme stub for extensions that check theme properties
+        colors: {},
+        styles: {}
+      };
+    },
+    getAllThemes() {
+      return [];
+    },
+    getTheme(_name) {
+      return void 0;
+    },
+    setTheme(_theme) {
+      return { success: false, error: "Themes not supported in server mode" };
+    },
+    getToolsExpanded() {
+      return false;
+    },
+    setToolsExpanded(_expanded) {
+    }
+  };
+}
+async function raceWithAbortAndSignal(promise, signal, onCancel) {
+  if (!signal) {
+    return promise;
+  }
+  return new Promise((resolve, reject) => {
+    const abortHandler = () => {
+      onCancel();
+      reject(new Error("Aborted"));
+    };
+    signal.addEventListener("abort", abortHandler);
+    promise.then((result) => {
+      signal.removeEventListener("abort", abortHandler);
+      resolve(result);
+    }).catch((error) => {
+      signal.removeEventListener("abort", abortHandler);
+      reject(error);
+    });
+  });
+}
+export {
+  createServerUIContext
+};
+//# sourceMappingURL=server-ui-context.js.map