gsd-pi 2.67.0-dev.509bd95 → 2.67.0-dev.5399650

package/packages/mcp-server/dist/session-manager.js

@@ -0,0 +1,284 @@
+/**
+ * SessionManager — manages RpcClient lifecycle for background GSD execution.
+ *
+ * One active session per projectDir. Tracks events in a ring buffer,
+ * detects blockers, tracks terminal state, and accumulates cost using
+ * the cumulative-max pattern (K004).
+ */
+import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
+import { RpcClient } from '@gsd-build/rpc-client';
+import { MAX_EVENTS, INIT_TIMEOUT_MS } from './types.js';
+// ---------------------------------------------------------------------------
+// Inlined detection logic (from headless-events.ts — no internal package imports)
+// ---------------------------------------------------------------------------
+const FIRE_AND_FORGET_METHODS = new Set([
+    'notify', 'setStatus', 'setWidget', 'setTitle', 'set_editor_text',
+]);
+const TERMINAL_PREFIXES = ['auto-mode stopped', 'step-mode stopped'];
+function isTerminalNotification(event) {
+    if (event.type !== 'extension_ui_request' || event.method !== 'notify')
+        return false;
+    const message = String(event.message ?? '').toLowerCase();
+    return TERMINAL_PREFIXES.some((prefix) => message.startsWith(prefix));
+}
+function isBlockedNotification(event) {
+    if (event.type !== 'extension_ui_request' || event.method !== 'notify')
+        return false;
+    const message = String(event.message ?? '').toLowerCase();
+    return message.includes('blocked:');
+}
+function isBlockingUIRequest(event) {
+    if (event.type !== 'extension_ui_request')
+        return false;
+    const method = String(event.method ?? '');
+    return !FIRE_AND_FORGET_METHODS.has(method);
+}
+// ---------------------------------------------------------------------------
+// SessionManager
+// ---------------------------------------------------------------------------
+export class SessionManager {
+    /** Sessions keyed by projectDir for duplicate-start prevention */
+    sessions = new Map();
+    /**
+     * Start a new GSD auto-mode session for the given project directory.
+     *
+     * Rejects if a session already exists for this projectDir.
+     * Creates an RpcClient, starts the process, performs the v2 init handshake,
+     * wires event tracking, and sends '/gsd auto' to begin execution.
+     */
+    async startSession(projectDir, options = {}) {
+        if (!projectDir || projectDir.trim() === '') {
+            throw new Error('projectDir is required and cannot be empty');
+        }
+        const resolvedDir = resolve(projectDir);
+        const existing = this.sessions.get(resolvedDir);
+        if (existing) {
+            throw new Error(`Session already active for ${resolvedDir} (sessionId: ${existing.sessionId}, status: ${existing.status})`);
+        }
+        const cliPath = options.cliPath ?? SessionManager.resolveCLIPath();
+        const args = ['--mode', 'rpc'];
+        if (options.model)
+            args.push('--model', options.model);
+        if (options.bare)
+            args.push('--bare');
+        const client = new RpcClient({
+            cliPath,
+            cwd: resolvedDir,
+            args,
+        });
+        // Build the session shell before async operations so we can track state
+        const session = {
+            sessionId: '', // filled after init
+            projectDir: resolvedDir,
+            status: 'starting',
+            client,
+            events: [],
+            pendingBlocker: null,
+            cost: { totalCost: 0, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } },
+            startTime: Date.now(),
+        };
+        // Insert into map early (keyed by dir) so concurrent starts are rejected
+        this.sessions.set(resolvedDir, session);
+        try {
+            // Start the process with timeout
+            await Promise.race([
+                client.start(),
+                timeout(INIT_TIMEOUT_MS, `RpcClient.start() timed out after ${INIT_TIMEOUT_MS}ms`),
+            ]);
+            // Perform v2 init handshake
+            const initResult = await Promise.race([
+                client.init(),
+                timeout(INIT_TIMEOUT_MS, `RpcClient.init() timed out after ${INIT_TIMEOUT_MS}ms`),
+            ]);
+            session.sessionId = initResult.sessionId;
+            session.status = 'running';
+            // Wire event tracking
+            session.unsubscribe = client.onEvent((event) => {
+                this.handleEvent(session, event);
+            });
+            // Kick off auto-mode
+            const command = options.command ?? '/gsd auto';
+            await client.prompt(command);
+            return session.sessionId;
+        }
+        catch (err) {
+            session.status = 'error';
+            session.error = err instanceof Error ? err.message : String(err);
+            // Attempt cleanup
+            try {
+                await client.stop();
+            }
+            catch { /* swallow cleanup errors */ }
+            // Keep session in map so callers can inspect the error
+            throw new Error(`Failed to start session for ${resolvedDir}: ${session.error}`);
+        }
+    }
+    /**
+     * Look up a session by sessionId.
+     * Linear scan is fine — we expect <10 concurrent sessions.
+     */
+    getSession(sessionId) {
+        for (const session of this.sessions.values()) {
+            if (session.sessionId === sessionId)
+                return session;
+        }
+        return undefined;
+    }
+    /**
+     * Look up a session by project directory (direct map lookup).
+     */
+    getSessionByDir(projectDir) {
+        return this.sessions.get(resolve(projectDir));
+    }
+    /**
+     * Resolve a pending blocker by sending a UI response.
+     */
+    async resolveBlocker(sessionId, response) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        if (!session.pendingBlocker)
+            throw new Error(`No pending blocker for session ${sessionId}`);
+        const blocker = session.pendingBlocker;
+        session.client.sendUIResponse(blocker.id, { value: response });
+        session.pendingBlocker = null;
+        if (session.status === 'blocked') {
+            session.status = 'running';
+        }
+    }
+    /**
+     * Cancel a running session — abort current operation then stop the process.
+     */
+    async cancelSession(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        try {
+            await session.client.abort();
+        }
+        catch { /* may already be stopped */ }
+        try {
+            await session.client.stop();
+        }
+        catch { /* swallow */ }
+        session.status = 'cancelled';
+        session.unsubscribe?.();
+    }
+    /**
+     * Build a HeadlessJsonResult-shaped object from accumulated session state.
+     */
+    getResult(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        const durationMs = Date.now() - session.startTime;
+        return {
+            sessionId: session.sessionId,
+            projectDir: session.projectDir,
+            status: session.status,
+            durationMs,
+            cost: session.cost,
+            recentEvents: session.events.slice(-10),
+            pendingBlocker: session.pendingBlocker
+                ? { id: session.pendingBlocker.id, method: session.pendingBlocker.method, message: session.pendingBlocker.message }
+                : null,
+            error: session.error ?? null,
+        };
+    }
+    /**
+     * Stop all active sessions and clean up resources.
+     */
+    async cleanup() {
+        const stopPromises = [];
+        for (const session of this.sessions.values()) {
+            session.unsubscribe?.();
+            if (session.status === 'running' || session.status === 'starting' || session.status === 'blocked') {
+                stopPromises.push(session.client.stop().catch(() => { }));
+                session.status = 'cancelled';
+            }
+        }
+        await Promise.allSettled(stopPromises);
+    }
+    /**
+     * Resolve the GSD CLI path.
+     *
+     * 1. GSD_CLI_PATH env var (highest priority)
+     * 2. `which gsd` → resolve to the actual dist/cli.js
+     */
+    static resolveCLIPath() {
+        // Check env var first
+        const envPath = process.env['GSD_CLI_PATH'];
+        if (envPath)
+            return resolve(envPath);
+        // Fallback: locate `gsd` via which
+        try {
+            const gsdBin = execSync('which gsd', { encoding: 'utf-8' }).trim();
+            if (gsdBin) {
+                // gsd bin is typically a symlink to dist/loader.js — return the resolved path
+                return resolve(gsdBin);
+            }
+        }
+        catch {
+            // which failed
+        }
+        throw new Error('Cannot find GSD CLI. Set GSD_CLI_PATH environment variable or ensure `gsd` is in PATH.');
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Event Handling
+    // ---------------------------------------------------------------------------
+    handleEvent(session, event) {
+        // Ring buffer: push and trim
+        session.events.push(event);
+        if (session.events.length > MAX_EVENTS) {
+            session.events.splice(0, session.events.length - MAX_EVENTS);
+        }
+        // Cost tracking (K004 — cumulative-max)
+        if (event.type === 'cost_update') {
+            const costEvent = event;
+            session.cost.totalCost = Math.max(session.cost.totalCost, costEvent.cumulativeCost ?? 0);
+            if (costEvent.tokens) {
+                session.cost.tokens.input = Math.max(session.cost.tokens.input, costEvent.tokens.input ?? 0);
+                session.cost.tokens.output = Math.max(session.cost.tokens.output, costEvent.tokens.output ?? 0);
+                session.cost.tokens.cacheRead = Math.max(session.cost.tokens.cacheRead, costEvent.tokens.cacheRead ?? 0);
+                session.cost.tokens.cacheWrite = Math.max(session.cost.tokens.cacheWrite, costEvent.tokens.cacheWrite ?? 0);
+            }
+        }
+        // Terminal detection — auto-mode/step-mode stopped
+        if (isTerminalNotification(event)) {
+            // Check if it's a blocked stop (not truly terminal — it's a blocker)
+            if (isBlockedNotification(event)) {
+                session.status = 'blocked';
+                session.pendingBlocker = extractBlocker(event);
+            }
+            else {
+                session.status = 'completed';
+                session.unsubscribe?.();
+            }
+            return;
+        }
+        // Blocker detection — non-fire-and-forget extension_ui_request
+        if (isBlockingUIRequest(event)) {
+            session.status = 'blocked';
+            session.pendingBlocker = extractBlocker(event);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function timeout(ms, message) {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(message)), ms);
+    });
+}
+function extractBlocker(event) {
+    const uiEvent = event;
+    return {
+        id: String(uiEvent.id ?? ''),
+        method: String(uiEvent.method ?? ''),
+        message: String(uiEvent.title ?? uiEvent.message ?? ''),
+        event: uiEvent,
+    };
+}
+//# sourceMappingURL=session-manager.js.map

package/packages/mcp-server/dist/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SessionManager — manages RpcClient lifecycle for background GSD execution.\n *\n * One active session per projectDir. Tracks events in a ring buffer,\n * detects blockers, tracks terminal state, and accumulates cost using\n * the cumulative-max pattern (K004).\n */\n\nimport { execSync } from 'node:child_process';\nimport { resolve } from 'node:path';\nimport { RpcClient } from '@gsd-build/rpc-client';\nimport type { SdkAgentEvent, RpcInitResult, RpcCostUpdateEvent, RpcExtensionUIRequest } from '@gsd-build/rpc-client';\nimport type {\n  ManagedSession,\n  ExecuteOptions,\n  PendingBlocker,\n  CostAccumulator,\n  SessionStatus,\n} from './types.js';\nimport { MAX_EVENTS, INIT_TIMEOUT_MS } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Inlined detection logic (from headless-events.ts — no internal package imports)\n// ---------------------------------------------------------------------------\n\nconst FIRE_AND_FORGET_METHODS = new Set([\n  'notify', 'setStatus', 'setWidget', 'setTitle', 'set_editor_text',\n]);\n\nconst TERMINAL_PREFIXES = ['auto-mode stopped', 'step-mode stopped'];\n\nfunction isTerminalNotification(event: Record<string, unknown>): boolean {\n  if (event.type !== 'extension_ui_request' || event.method !== 'notify') return false;\n  const message = String(event.message ?? '').toLowerCase();\n  return TERMINAL_PREFIXES.some((prefix) => message.startsWith(prefix));\n}\n\nfunction isBlockedNotification(event: Record<string, unknown>): boolean {\n  if (event.type !== 'extension_ui_request' || event.method !== 'notify') return false;\n  const message = String(event.message ?? '').toLowerCase();\n  return message.includes('blocked:');\n}\n\nfunction isBlockingUIRequest(event: Record<string, unknown>): boolean {\n  if (event.type !== 'extension_ui_request') return false;\n  const method = String(event.method ?? '');\n  return !FIRE_AND_FORGET_METHODS.has(method);\n}\n\n// ---------------------------------------------------------------------------\n// SessionManager\n// ---------------------------------------------------------------------------\n\nexport class SessionManager {\n  /** Sessions keyed by projectDir for duplicate-start prevention */\n  private sessions = new Map<string, ManagedSession>();\n\n  /**\n   * Start a new GSD auto-mode session for the given project directory.\n   *\n   * Rejects if a session already exists for this projectDir.\n   * Creates an RpcClient, starts the process, performs the v2 init handshake,\n   * wires event tracking, and sends '/gsd auto' to begin execution.\n   */\n  async startSession(projectDir: string, options: ExecuteOptions = {}): Promise<string> {\n    if (!projectDir || projectDir.trim() === '') {\n      throw new Error('projectDir is required and cannot be empty');\n    }\n\n    const resolvedDir = resolve(projectDir);\n\n    const existing = this.sessions.get(resolvedDir);\n    if (existing) {\n      throw new Error(\n        `Session already active for ${resolvedDir} (sessionId: ${existing.sessionId}, status: ${existing.status})`\n      );\n    }\n\n    const cliPath = options.cliPath ?? SessionManager.resolveCLIPath();\n\n    const args: string[] = ['--mode', 'rpc'];\n    if (options.model) args.push('--model', options.model);\n    if (options.bare) args.push('--bare');\n\n    const client = new RpcClient({\n      cliPath,\n      cwd: resolvedDir,\n      args,\n    });\n\n    // Build the session shell before async operations so we can track state\n    const session: ManagedSession = {\n      sessionId: '', // filled after init\n      projectDir: resolvedDir,\n      status: 'starting',\n      client,\n      events: [],\n      pendingBlocker: null,\n      cost: { totalCost: 0, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } },\n      startTime: Date.now(),\n    };\n\n    // Insert into map early (keyed by dir) so concurrent starts are rejected\n    this.sessions.set(resolvedDir, session);\n\n    try {\n      // Start the process with timeout\n      await Promise.race([\n        client.start(),\n        timeout(INIT_TIMEOUT_MS, `RpcClient.start() timed out after ${INIT_TIMEOUT_MS}ms`),\n      ]);\n\n      // Perform v2 init handshake\n      const initResult: RpcInitResult = await Promise.race([\n        client.init(),\n        timeout(INIT_TIMEOUT_MS, `RpcClient.init() timed out after ${INIT_TIMEOUT_MS}ms`),\n      ]) as RpcInitResult;\n\n      session.sessionId = initResult.sessionId;\n      session.status = 'running';\n\n      // Wire event tracking\n      session.unsubscribe = client.onEvent((event: SdkAgentEvent) => {\n        this.handleEvent(session, event);\n      });\n\n      // Kick off auto-mode\n      const command = options.command ?? '/gsd auto';\n      await client.prompt(command);\n\n      return session.sessionId;\n    } catch (err) {\n      session.status = 'error';\n      session.error = err instanceof Error ? err.message : String(err);\n\n      // Attempt cleanup\n      try { await client.stop(); } catch { /* swallow cleanup errors */ }\n\n      // Keep session in map so callers can inspect the error\n      throw new Error(`Failed to start session for ${resolvedDir}: ${session.error}`);\n    }\n  }\n\n  /**\n   * Look up a session by sessionId.\n   * Linear scan is fine — we expect <10 concurrent sessions.\n   */\n  getSession(sessionId: string): ManagedSession | undefined {\n    for (const session of this.sessions.values()) {\n      if (session.sessionId === sessionId) return session;\n    }\n    return undefined;\n  }\n\n  /**\n   * Look up a session by project directory (direct map lookup).\n   */\n  getSessionByDir(projectDir: string): ManagedSession | undefined {\n    return this.sessions.get(resolve(projectDir));\n  }\n\n  /**\n   * Resolve a pending blocker by sending a UI response.\n   */\n  async resolveBlocker(sessionId: string, response: string): Promise<void> {\n    const session = this.getSession(sessionId);\n    if (!session) throw new Error(`Session not found: ${sessionId}`);\n    if (!session.pendingBlocker) throw new Error(`No pending blocker for session ${sessionId}`);\n\n    const blocker = session.pendingBlocker;\n    session.client.sendUIResponse(blocker.id, { value: response });\n    session.pendingBlocker = null;\n    if (session.status === 'blocked') {\n      session.status = 'running';\n    }\n  }\n\n  /**\n   * Cancel a running session — abort current operation then stop the process.\n   */\n  async cancelSession(sessionId: string): Promise<void> {\n    const session = this.getSession(sessionId);\n    if (!session) throw new Error(`Session not found: ${sessionId}`);\n\n    try {\n      await session.client.abort();\n    } catch { /* may already be stopped */ }\n\n    try {\n      await session.client.stop();\n    } catch { /* swallow */ }\n\n    session.status = 'cancelled';\n    session.unsubscribe?.();\n  }\n\n  /**\n   * Build a HeadlessJsonResult-shaped object from accumulated session state.\n   */\n  getResult(sessionId: string): Record<string, unknown> {\n    const session = this.getSession(sessionId);\n    if (!session) throw new Error(`Session not found: ${sessionId}`);\n\n    const durationMs = Date.now() - session.startTime;\n\n    return {\n      sessionId: session.sessionId,\n      projectDir: session.projectDir,\n      status: session.status,\n      durationMs,\n      cost: session.cost,\n      recentEvents: session.events.slice(-10),\n      pendingBlocker: session.pendingBlocker\n        ? { id: session.pendingBlocker.id, method: session.pendingBlocker.method, message: session.pendingBlocker.message }\n        : null,\n      error: session.error ?? null,\n    };\n  }\n\n  /**\n   * Stop all active sessions and clean up resources.\n   */\n  async cleanup(): Promise<void> {\n    const stopPromises: Promise<void>[] = [];\n\n    for (const session of this.sessions.values()) {\n      session.unsubscribe?.();\n      if (session.status === 'running' || session.status === 'starting' || session.status === 'blocked') {\n        stopPromises.push(\n          session.client.stop().catch(() => { /* swallow */ })\n        );\n        session.status = 'cancelled';\n      }\n    }\n\n    await Promise.allSettled(stopPromises);\n  }\n\n  /**\n   * Resolve the GSD CLI path.\n   *\n   * 1. GSD_CLI_PATH env var (highest priority)\n   * 2. `which gsd` → resolve to the actual dist/cli.js\n   */\n  static resolveCLIPath(): string {\n    // Check env var first\n    const envPath = process.env['GSD_CLI_PATH'];\n    if (envPath) return resolve(envPath);\n\n    // Fallback: locate `gsd` via which\n    try {\n      const gsdBin = execSync('which gsd', { encoding: 'utf-8' }).trim();\n      if (gsdBin) {\n        // gsd bin is typically a symlink to dist/loader.js — return the resolved path\n        return resolve(gsdBin);\n      }\n    } catch {\n      // which failed\n    }\n\n    throw new Error(\n      'Cannot find GSD CLI. Set GSD_CLI_PATH environment variable or ensure `gsd` is in PATH.'\n    );\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private: Event Handling\n  // ---------------------------------------------------------------------------\n\n  private handleEvent(session: ManagedSession, event: SdkAgentEvent): void {\n    // Ring buffer: push and trim\n    session.events.push(event);\n    if (session.events.length > MAX_EVENTS) {\n      session.events.splice(0, session.events.length - MAX_EVENTS);\n    }\n\n    // Cost tracking (K004 — cumulative-max)\n    if (event.type === 'cost_update') {\n      const costEvent = event as unknown as RpcCostUpdateEvent;\n      session.cost.totalCost = Math.max(session.cost.totalCost, costEvent.cumulativeCost ?? 0);\n      if (costEvent.tokens) {\n        session.cost.tokens.input = Math.max(session.cost.tokens.input, costEvent.tokens.input ?? 0);\n        session.cost.tokens.output = Math.max(session.cost.tokens.output, costEvent.tokens.output ?? 0);\n        session.cost.tokens.cacheRead = Math.max(session.cost.tokens.cacheRead, costEvent.tokens.cacheRead ?? 0);\n        session.cost.tokens.cacheWrite = Math.max(session.cost.tokens.cacheWrite, costEvent.tokens.cacheWrite ?? 0);\n      }\n    }\n\n    // Terminal detection — auto-mode/step-mode stopped\n    if (isTerminalNotification(event as Record<string, unknown>)) {\n      // Check if it's a blocked stop (not truly terminal — it's a blocker)\n      if (isBlockedNotification(event as Record<string, unknown>)) {\n        session.status = 'blocked';\n        session.pendingBlocker = extractBlocker(event);\n      } else {\n        session.status = 'completed';\n        session.unsubscribe?.();\n      }\n      return;\n    }\n\n    // Blocker detection — non-fire-and-forget extension_ui_request\n    if (isBlockingUIRequest(event as Record<string, unknown>)) {\n      session.status = 'blocked';\n      session.pendingBlocker = extractBlocker(event);\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction timeout(ms: number, message: string): Promise<never> {\n  return new Promise((_, reject) => {\n    setTimeout(() => reject(new Error(message)), ms);\n  });\n}\n\nfunction extractBlocker(event: SdkAgentEvent): PendingBlocker {\n  const uiEvent = event as unknown as RpcExtensionUIRequest;\n  return {\n    id: String(uiEvent.id ?? ''),\n    method: String(uiEvent.method ?? ''),\n    message: String((uiEvent as Record<string, unknown>).title ?? (uiEvent as Record<string, unknown>).message ?? ''),\n    event: uiEvent,\n  };\n}\n"]}

package/packages/mcp-server/dist/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MCP Server types — session lifecycle and orchestration.
+ */
+import type { RpcClient, SdkAgentEvent, RpcExtensionUIRequest } from '@gsd-build/rpc-client';
+export type SessionStatus = 'starting' | 'running' | 'blocked' | 'completed' | 'error' | 'cancelled';
+export interface ManagedSession {
+    /** Unique session ID returned from RpcClient.init() */
+    sessionId: string;
+    /** Absolute path to the project directory */
+    projectDir: string;
+    /** Current lifecycle status */
+    status: SessionStatus;
+    /** The RpcClient instance managing the agent process */
+    client: RpcClient;
+    /** Ring buffer of recent events (capped at MAX_EVENTS) */
+    events: SdkAgentEvent[];
+    /** Pending blocker requiring user response, if any */
+    pendingBlocker: PendingBlocker | null;
+    /** Cumulative cost tracking (max pattern per K004) */
+    cost: CostAccumulator;
+    /** Session start timestamp */
+    startTime: number;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Cleanup function to unsubscribe from events */
+    unsubscribe?: () => void;
+}
+export interface PendingBlocker {
+    /** The extension_ui_request id */
+    id: string;
+    /** The request method (e.g. 'select', 'confirm', 'input') */
+    method: string;
+    /** Human-readable message or title */
+    message: string;
+    /** Full event payload for inspection */
+    event: RpcExtensionUIRequest;
+}
+export interface CostAccumulator {
+    totalCost: number;
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+}
+export interface ExecuteOptions {
+    /** Command to send after '/gsd auto' (default: none) */
+    command?: string;
+    /** Model ID override */
+    model?: string;
+    /** Run in bare mode (skip user config) */
+    bare?: boolean;
+    /** Path to CLI binary (overrides GSD_CLI_PATH and which resolution) */
+    cliPath?: string;
+}
+/** Maximum number of events kept in the ring buffer */
+export declare const MAX_EVENTS = 50;
+/** Timeout for RpcClient initialization (ms) */
+export declare const INIT_TIMEOUT_MS = 30000;
+//# sourceMappingURL=types.d.ts.map

package/packages/mcp-server/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAsB,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMjH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAMrG,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;IAEtB,wDAAwD;IACxD,MAAM,EAAE,SAAS,CAAC;IAElB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,sDAAsD;IACtD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAEtC,sDAAsD;IACtD,IAAI,EAAE,eAAe,CAAC;IAEtB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAMD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IAEX,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAMD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAMD,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,uDAAuD;AACvD,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAS,CAAC"}

package/packages/mcp-server/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * MCP Server types — session lifecycle and orchestration.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum number of events kept in the ring buffer */
+export const MAX_EVENTS = 50;
+/** Timeout for RpcClient initialization (ms) */
+export const INIT_TIMEOUT_MS = 30_000;
+//# sourceMappingURL=types.js.map

package/packages/mcp-server/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgGH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC","sourcesContent":["/**\n * MCP Server types — session lifecycle and orchestration.\n */\n\nimport type { RpcClient, SdkAgentEvent, RpcCostUpdateEvent, RpcExtensionUIRequest } from '@gsd-build/rpc-client';\n\n// ---------------------------------------------------------------------------\n// Session Status\n// ---------------------------------------------------------------------------\n\nexport type SessionStatus = 'starting' | 'running' | 'blocked' | 'completed' | 'error' | 'cancelled';\n\n// ---------------------------------------------------------------------------\n// Managed Session\n// ---------------------------------------------------------------------------\n\nexport interface ManagedSession {\n  /** Unique session ID returned from RpcClient.init() */\n  sessionId: string;\n\n  /** Absolute path to the project directory */\n  projectDir: string;\n\n  /** Current lifecycle status */\n  status: SessionStatus;\n\n  /** The RpcClient instance managing the agent process */\n  client: RpcClient;\n\n  /** Ring buffer of recent events (capped at MAX_EVENTS) */\n  events: SdkAgentEvent[];\n\n  /** Pending blocker requiring user response, if any */\n  pendingBlocker: PendingBlocker | null;\n\n  /** Cumulative cost tracking (max pattern per K004) */\n  cost: CostAccumulator;\n\n  /** Session start timestamp */\n  startTime: number;\n\n  /** Error message if status is 'error' */\n  error?: string;\n\n  /** Cleanup function to unsubscribe from events */\n  unsubscribe?: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Pending Blocker\n// ---------------------------------------------------------------------------\n\nexport interface PendingBlocker {\n  /** The extension_ui_request id */\n  id: string;\n\n  /** The request method (e.g. 'select', 'confirm', 'input') */\n  method: string;\n\n  /** Human-readable message or title */\n  message: string;\n\n  /** Full event payload for inspection */\n  event: RpcExtensionUIRequest;\n}\n\n// ---------------------------------------------------------------------------\n// Cost Accumulator (K004 — cumulative-max)\n// ---------------------------------------------------------------------------\n\nexport interface CostAccumulator {\n  totalCost: number;\n  tokens: {\n    input: number;\n    output: number;\n    cacheRead: number;\n    cacheWrite: number;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Execute Options\n// ---------------------------------------------------------------------------\n\nexport interface ExecuteOptions {\n  /** Command to send after '/gsd auto' (default: none) */\n  command?: string;\n\n  /** Model ID override */\n  model?: string;\n\n  /** Run in bare mode (skip user config) */\n  bare?: boolean;\n\n  /** Path to CLI binary (overrides GSD_CLI_PATH and which resolution) */\n  cliPath?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Maximum number of events kept in the ring buffer */\nexport const MAX_EVENTS = 50;\n\n/** Timeout for RpcClient initialization (ms) */\nexport const INIT_TIMEOUT_MS = 30_000;\n"]}

package/packages/mcp-server/dist/workflow-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workflow MCP tools — exposes the core GSD mutation/read handlers over MCP.
+ */
+interface McpToolServer {
+    tool(name: string, description: string, params: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<unknown>): unknown;
+}
+export declare function registerWorkflowTools(server: McpToolServer): void;
+export {};
+//# sourceMappingURL=workflow-tools.d.ts.map

package/packages/mcp-server/dist/workflow-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgZH,UAAU,aAAa;IACrB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3D,OAAO,CAAC;CACZ;AAiYD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA+LjE"}