gsd-pi 2.69.0 → 2.70.0-dev.7ebda5e

package/packages/daemon/src/orchestrator.ts

@@ -12,9 +12,6 @@
  */
 
 import { z } from 'zod';
-import { readFileSync, writeFileSync, chmodSync } from 'node:fs';
-import { join } from 'node:path';
-import { homedir } from 'node:os';
 import type Anthropic from '@anthropic-ai/sdk';
 import type {
   MessageParam,
@@ -30,90 +27,18 @@ import type { ProjectInfo, ManagedSession } from './types.js';
 import type { Logger } from './logger.js';
 
 // ---------------------------------------------------------------------------
-// OAuth token resolution — reads GSD's auth.json, refreshes if expired
+// API key resolution — requires ANTHROPIC_API_KEY env var
+// Anthropic OAuth removed per TOS compliance (see docs/user-docs/claude-code-auth-compliance.md)
 // ---------------------------------------------------------------------------
 
-interface OAuthCredentials {
-  type: 'oauth';
-  refresh: string;
-  access: string;
-  expires: number;
-}
-
-const TOKEN_URL = 'https://platform.claude.com/v1/oauth/token';
-const CLIENT_ID = atob('OWQxYzI1MGEtZTYxYi00NGQ5LTg4ZWQtNTk0NGQxOTYyZjVl');
-
-/**
- * Read the Anthropic OAuth access token from GSD's auth.json.
- * If expired, refresh it and write the new credentials back.
- * Falls back to ANTHROPIC_API_KEY env var if no OAuth credential exists.
- */
-async function resolveAnthropicApiKey(logger?: Logger): Promise<string> {
-  // Try env var first (explicit override)
-  if (process.env.ANTHROPIC_API_KEY) {
-    return process.env.ANTHROPIC_API_KEY;
-  }
-
-  const authPath = join(homedir(), '.gsd', 'agent', 'auth.json');
-  let authData: Record<string, unknown>;
-  try {
-    authData = JSON.parse(readFileSync(authPath, 'utf-8'));
-  } catch {
-    throw new Error(
-      'No Anthropic auth found. Run `gsd login` to authenticate, or set ANTHROPIC_API_KEY.',
-    );
-  }
-
-  const cred = authData.anthropic as OAuthCredentials | undefined;
-  if (!cred || cred.type !== 'oauth' || !cred.access) {
+function resolveAnthropicApiKey(): string {
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+  if (!apiKey) {
     throw new Error(
-      'No Anthropic OAuth credential in auth.json. Run `gsd login` to authenticate.',
+      'ANTHROPIC_API_KEY is required. Set it in your environment or run `gsd config`.',
     );
   }
-
-  // If token is still valid, use it
-  if (Date.now() < cred.expires) {
-    return cred.access;
-  }
-
-  // Token expired — refresh it
-  logger?.info('orchestrator: refreshing Anthropic OAuth token');
-  const response = await fetch(TOKEN_URL, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      grant_type: 'refresh_token',
-      client_id: CLIENT_ID,
-      refresh_token: cred.refresh,
-    }),
-    signal: AbortSignal.timeout(30_000),
-  });
-
-  if (!response.ok) {
-    const error = await response.text();
-    throw new Error(`Anthropic token refresh failed: ${error}`);
-  }
-
-  const data = (await response.json()) as {
-    access_token: string;
-    refresh_token: string;
-    expires_in: number;
-  };
-
-  const newCred: OAuthCredentials = {
-    type: 'oauth',
-    refresh: data.refresh_token,
-    access: data.access_token,
-    expires: Date.now() + data.expires_in * 1000 - 5 * 60 * 1000,
-  };
-
-  // Write back to auth.json
-  authData.anthropic = newCred;
-  writeFileSync(authPath, JSON.stringify(authData, null, 2), 'utf-8');
-  chmodSync(authPath, 0o600);
-  logger?.info('orchestrator: Anthropic OAuth token refreshed');
-
-  return newCred.access;
+  return apiKey;
 }
 
 // ---------------------------------------------------------------------------
@@ -254,11 +179,11 @@ export class Orchestrator {
 
   /**
    * Lazily initialise the Anthropic client. Dynamic import handles K007 module resolution.
-   * Resolves auth from GSD's OAuth credentials (auth.json), refreshing if needed.
+   * Requires ANTHROPIC_API_KEY environment variable.
    */
   private async getClient(): Promise<Anthropic> {
     if (this.client) return this.client;
-    const apiKey = await resolveAnthropicApiKey(this.deps.logger);
+    const apiKey = resolveAnthropicApiKey();
     const { default: AnthropicSDK } = await import('@anthropic-ai/sdk');
     this.client = new AnthropicSDK({ apiKey });
     return this.client;

package/packages/mcp-server/README.md

@@ -7,7 +7,8 @@ Start GSD auto-mode sessions, poll progress, resolve blockers, and retrieve resu
 This package now exposes two tool surfaces:
 
 - session/read tools for starting and inspecting GSD sessions
-- workflow mutation tools for planning, completion, validation, reassessment, and gate persistence
+- MCP-native interactive tools for structured user input
+- headless-safe workflow tools for planning, completion, validation, reassessment, metadata persistence, and journal reads
 
 ## Installation
 
@@ -74,18 +75,29 @@ Add to `.cursor/mcp.json`:
 
 ## Tools
 
-### Workflow mutation tools
+### Workflow tools
 
 The workflow MCP surface includes:
 
+- `gsd_decision_save`
+- `gsd_save_decision`
+- `gsd_requirement_update`
+- `gsd_update_requirement`
+- `gsd_requirement_save`
+- `gsd_save_requirement`
+- `gsd_milestone_generate_id`
+- `gsd_generate_milestone_id`
 - `gsd_plan_milestone`
 - `gsd_plan_slice`
+- `gsd_plan_task`
+- `gsd_task_plan`
 - `gsd_replan_slice`
 - `gsd_slice_replan`
 - `gsd_task_complete`
 - `gsd_complete_task`
 - `gsd_slice_complete`
 - `gsd_complete_slice`
+- `gsd_skip_slice`
 - `gsd_validate_milestone`
 - `gsd_milestone_validate`
 - `gsd_complete_milestone`
@@ -95,13 +107,21 @@ The workflow MCP surface includes:
 - `gsd_save_gate_result`
 - `gsd_summary_save`
 - `gsd_milestone_status`
+- `gsd_journal_query`
 
-These mutation tools use the same GSD workflow handlers as the native in-process tool path.
+These tools use the same GSD workflow handlers as the native in-process tool path wherever a shared handler exists.
+
+### Interactive tools
+
+The packaged server now exposes `ask_user_questions` through MCP form elicitation. This keeps the existing GSD answer payload shape while allowing Claude Code CLI and other elicitation-capable clients to surface structured user choices.
+
+`secure_env_collect` is still not exposed by this package. That path needs MCP URL elicitation or an equivalent secure bridge because secrets should not flow through form elicitation.
 
 Current support boundary:
 
 - when running inside the GSD monorepo checkout, the MCP server auto-discovers the shared workflow executor module
 - outside the monorepo, set `GSD_WORKFLOW_EXECUTORS_MODULE` to an importable `workflow-tool-executors` module path if you want the mutation tools enabled
+- `ask_user_questions` requires an MCP client that supports form elicitation
 - session/read tools do not depend on this bridge
 
 If the executor bridge cannot be loaded, workflow mutation calls will fail with a precise configuration error instead of silently degrading.
@@ -214,6 +234,8 @@ Resolve a pending blocker in a session by sending a response to the blocked UI r
 | `GSD_CLI_PATH` | Absolute path to the GSD CLI binary. If not set, the server resolves `gsd` via `which`. |
 | `GSD_WORKFLOW_EXECUTORS_MODULE` | Optional absolute path or `file:` URL for the shared GSD workflow executor module used by workflow mutation tools. |
 
+The server also hydrates supported model-provider and tool credentials from `~/.gsd/agent/auth.json` on startup. Keys saved through `/gsd config` or `/gsd keys` become available to the MCP server process automatically, and any explicitly-set environment variable still wins.
+
 ## Architecture
 
 ```

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

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 /**
  * @gsd-build/mcp-server CLI — stdio transport entry point.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 /**
  * @gsd-build/mcp-server CLI — stdio transport entry point.
  *
@@ -7,10 +6,13 @@
  */
 import { SessionManager } from './session-manager.js';
 import { createMcpServer } from './server.js';
+import { loadStoredCredentialEnvKeys } from './tool-credentials.js';
 const MCP_PKG = '@modelcontextprotocol/sdk';
 async function main() {
+    loadStoredCredentialEnvKeys();
     const sessionManager = new SessionManager();
-    // Create the configured MCP server with all 12 tools (6 session + 6 read-only)
+    // Create the configured MCP server with session, interactive, read-only,
+    // and workflow tools.
     const { server } = await createMcpServer(sessionManager);
     // Dynamic import for StdioServerTransport (same TS subpath workaround)
     const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);

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

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAE5C,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;IAEzD,uEAAuE;IACvE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,kBAAkB,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,qDAAqD;IACrD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,UAAU,OAAO;QACpB,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE3C,6CAA6C;IAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6CAA6C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClG,CAAC;QACF,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\n/**\n * @gsd-build/mcp-server CLI — stdio transport entry point.\n *\n * Connects the MCP server to stdin/stdout for use by Claude Code,\n * Cursor, and other MCP-compatible clients.\n */\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\nasync function main(): Promise<void> {\n  const sessionManager = new SessionManager();\n\n  // Create the configured MCP server with all 12 tools (6 session + 6 read-only)\n  const { server } = await createMcpServer(sessionManager);\n\n  // Dynamic import for StdioServerTransport (same TS subpath workaround)\n  const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);\n  const transport = new StdioServerTransport();\n\n  // Cleanup handler — stop all sessions before exiting\n  let cleaningUp = false;\n  async function cleanup(): Promise<void> {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    process.stderr.write('[gsd-mcp-server] Shutting down...\\n');\n    try {\n      await sessionManager.cleanup();\n    } catch {\n      // swallow cleanup errors\n    }\n    try {\n      await server.close();\n    } catch {\n      // swallow close errors\n    }\n    process.exit(0);\n  }\n\n  process.on('SIGTERM', () => void cleanup());\n  process.on('SIGINT', () => void cleanup());\n\n  // Handle stdin end — MCP client disconnected\n  process.stdin.on('end', () => void cleanup());\n\n  // Connect and start serving\n  try {\n    await server.connect(transport);\n    process.stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n  } catch (err) {\n    process.stderr.write(\n      `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`\n    );\n    await sessionManager.cleanup();\n    process.exit(1);\n  }\n}\n\nmain().catch((err) => {\n  process.stderr.write(\n    `[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\\n`\n  );\n  process.exit(1);\n});\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,2BAA2B,EAAE,CAAC;IAE9B,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAE5C,yEAAyE;IACzE,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;IAEzD,uEAAuE;IACvE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,kBAAkB,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,qDAAqD;IACrD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,UAAU,OAAO;QACpB,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE3C,6CAA6C;IAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6CAA6C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClG,CAAC;QACF,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["/**\n * @gsd-build/mcp-server CLI — stdio transport entry point.\n *\n * Connects the MCP server to stdin/stdout for use by Claude Code,\n * Cursor, and other MCP-compatible clients.\n */\n\nimport { SessionManager } from './session-manager.js';\nimport { createMcpServer } from './server.js';\nimport { loadStoredCredentialEnvKeys } from './tool-credentials.js';\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\n\nasync function main(): Promise<void> {\n  loadStoredCredentialEnvKeys();\n\n  const sessionManager = new SessionManager();\n\n  // Create the configured MCP server with session, interactive, read-only,\n  // and workflow tools.\n  const { server } = await createMcpServer(sessionManager);\n\n  // Dynamic import for StdioServerTransport (same TS subpath workaround)\n  const { StdioServerTransport } = await import(`${MCP_PKG}/server/stdio.js`);\n  const transport = new StdioServerTransport();\n\n  // Cleanup handler — stop all sessions before exiting\n  let cleaningUp = false;\n  async function cleanup(): Promise<void> {\n    if (cleaningUp) return;\n    cleaningUp = true;\n    process.stderr.write('[gsd-mcp-server] Shutting down...\\n');\n    try {\n      await sessionManager.cleanup();\n    } catch {\n      // swallow cleanup errors\n    }\n    try {\n      await server.close();\n    } catch {\n      // swallow close errors\n    }\n    process.exit(0);\n  }\n\n  process.on('SIGTERM', () => void cleanup());\n  process.on('SIGINT', () => void cleanup());\n\n  // Handle stdin end — MCP client disconnected\n  process.stdin.on('end', () => void cleanup());\n\n  // Connect and start serving\n  try {\n    await server.connect(transport);\n    process.stderr.write('[gsd-mcp-server] MCP server started on stdio\\n');\n  } catch (err) {\n    process.stderr.write(\n      `[gsd-mcp-server] Fatal: failed to start — ${err instanceof Error ? err.message : String(err)}\\n`\n    );\n    await sessionManager.cleanup();\n    process.exit(1);\n  }\n}\n\nmain().catch((err) => {\n  process.stderr.write(\n    `[gsd-mcp-server] Fatal: ${err instanceof Error ? err.message : String(err)}\\n`\n  );\n  process.exit(1);\n});\n"]}

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

@@ -2,8 +2,9 @@
  * MCP Server — registers GSD orchestration, project-state, and workflow tools.
  *
  * Session tools (6): gsd_execute, gsd_status, gsd_result, gsd_cancel, gsd_query, gsd_resolve_blocker
+ * Interactive tools (1): ask_user_questions via MCP form elicitation
  * Read-only tools (6): gsd_progress, gsd_roadmap, gsd_history, gsd_doctor, gsd_captures, gsd_knowledge
- * Workflow tools (17): planning, replanning, completion, validation, reassessment, gate result, and milestone status tools
+ * Workflow tools (29): headless-safe planning, metadata persistence, replanning, completion, validation, reassessment, gate result, status, and journal tools
  *
  * Uses dynamic imports for @modelcontextprotocol/sdk because TS Node16
  * cannot resolve the SDK's subpath exports statically (same pattern as
@@ -12,9 +13,39 @@
 import type { SessionManager } from './session-manager.js';
 interface McpServerInstance {
     tool(name: string, description: string, params: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<unknown>): unknown;
+    server: {
+        elicitInput(params: AskUserQuestionsElicitRequest, options?: unknown): Promise<AskUserQuestionsElicitResult>;
+    };
     connect(transport: unknown): Promise<void>;
     close(): Promise<void>;
 }
+interface AskUserQuestionOption {
+    label: string;
+    description: string;
+}
+interface AskUserQuestion {
+    id: string;
+    header: string;
+    question: string;
+    options: AskUserQuestionOption[];
+    allowMultiple?: boolean;
+}
+type AskUserQuestionsContentValue = string | number | boolean | string[];
+interface AskUserQuestionsElicitResult {
+    action: 'accept' | 'decline' | 'cancel';
+    content?: Record<string, AskUserQuestionsContentValue>;
+}
+interface AskUserQuestionsElicitRequest {
+    mode: 'form';
+    message: string;
+    requestedSchema: {
+        type: 'object';
+        properties: Record<string, Record<string, unknown>>;
+        required?: string[];
+    };
+}
+export declare function buildAskUserQuestionsElicitRequest(questions: AskUserQuestion[]): AskUserQuestionsElicitRequest;
+export declare function formatAskUserQuestionsElicitResult(questions: AskUserQuestion[], result: AskUserQuestionsElicitResult): string;
 /**
  * Create and configure an MCP server with session, read-only, and workflow tools.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA6F3D,UAAU,iBAAiB;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChJ,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC;IAC7E,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC,CA8RD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAkG3D,UAAU,iBAAiB;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChJ,MAAM,EAAE;QACN,WAAW,CACT,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,4BAA4B,CAAC,CAAC;KAC1C,CAAC;IACF,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD,KAAK,4BAA4B,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AAEzE,UAAU,4BAA4B;IACpC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;CACxD;AAED,UAAU,6BAA6B;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAiCD,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,6BAA6B,CAiD9G;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,eAAe,EAAE,EAC5B,MAAM,EAAE,4BAA4B,GACnC,MAAM,CAkBR;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC;IAC7E,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC,CAkUD"}

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

@@ -2,8 +2,9 @@
  * MCP Server — registers GSD orchestration, project-state, and workflow tools.
  *
  * Session tools (6): gsd_execute, gsd_status, gsd_result, gsd_cancel, gsd_query, gsd_resolve_blocker
+ * Interactive tools (1): ask_user_questions via MCP form elicitation
  * Read-only tools (6): gsd_progress, gsd_roadmap, gsd_history, gsd_doctor, gsd_captures, gsd_knowledge
- * Workflow tools (17): planning, replanning, completion, validation, reassessment, gate result, and milestone status tools
+ * Workflow tools (29): headless-safe planning, metadata persistence, replanning, completion, validation, reassessment, gate result, status, and journal tools
  *
  * Uses dynamic imports for @modelcontextprotocol/sdk because TS Node16
  * cannot resolve the SDK's subpath exports statically (same pattern as
@@ -36,6 +37,10 @@ function jsonContent(data) {
 function errorContent(message) {
     return { isError: true, content: [{ type: 'text', text: message }] };
 }
+/** Return raw text content without JSON wrapping. */
+function textContent(text) {
+    return { content: [{ type: 'text', text }] };
+}
 // ---------------------------------------------------------------------------
 // gsd_query filesystem reader
 // ---------------------------------------------------------------------------
@@ -92,6 +97,88 @@ async function fileExists(path) {
         return false;
     }
 }
+const OTHER_OPTION_LABEL = 'None of the above';
+function normalizeAskUserQuestionsNote(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function normalizeAskUserQuestionsAnswers(value, allowMultiple) {
+    if (allowMultiple) {
+        return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+    }
+    return typeof value === 'string' && value.length > 0 ? [value] : [];
+}
+function validateAskUserQuestionsPayload(questions) {
+    if (questions.length === 0 || questions.length > 3) {
+        return 'Error: questions must contain 1-3 items';
+    }
+    for (const question of questions) {
+        if (!question.options || question.options.length === 0) {
+            return `Error: ask_user_questions requires non-empty options for every question (question "${question.id}" has none)`;
+        }
+    }
+    return null;
+}
+export function buildAskUserQuestionsElicitRequest(questions) {
+    const properties = {};
+    const required = questions.map((question) => question.id);
+    for (const question of questions) {
+        if (question.allowMultiple) {
+            properties[question.id] = {
+                type: 'array',
+                title: question.header,
+                description: question.question,
+                minItems: 1,
+                maxItems: question.options.length,
+                items: {
+                    anyOf: question.options.map((option) => ({
+                        const: option.label,
+                        title: option.label,
+                    })),
+                },
+            };
+            continue;
+        }
+        properties[question.id] = {
+            type: 'string',
+            title: question.header,
+            description: question.question,
+            oneOf: [...question.options, { label: OTHER_OPTION_LABEL, description: 'Choose this when the listed options do not fit.' }].map((option) => ({
+                const: option.label,
+                title: option.label,
+            })),
+        };
+        properties[`${question.id}__note`] = {
+            type: 'string',
+            title: `${question.header} Note`,
+            description: `Optional note for "${OTHER_OPTION_LABEL}".`,
+            maxLength: 500,
+        };
+    }
+    return {
+        mode: 'form',
+        message: 'Please answer the following question(s). For single-select questions, choose "None of the above" and add a note if the provided options do not fit.',
+        requestedSchema: {
+            type: 'object',
+            properties,
+            required,
+        },
+    };
+}
+export function formatAskUserQuestionsElicitResult(questions, result) {
+    const answers = {};
+    const content = result.content ?? {};
+    for (const question of questions) {
+        const answerList = normalizeAskUserQuestionsAnswers(content[question.id], !!question.allowMultiple);
+        if (!question.allowMultiple && answerList[0] === OTHER_OPTION_LABEL) {
+            const note = normalizeAskUserQuestionsNote(content[`${question.id}__note`]);
+            if (note) {
+                answerList.push(`user_note: ${note}`);
+            }
+        }
+        answers[question.id] = { answers: answerList };
+    }
+    return JSON.stringify({ answers });
+}
 // ---------------------------------------------------------------------------
 // createMcpServer
 // ---------------------------------------------------------------------------
@@ -222,6 +309,36 @@ export async function createMcpServer(sessionManager) {
             return errorContent(err instanceof Error ? err.message : String(err));
         }
     });
+    // -----------------------------------------------------------------------
+    // ask_user_questions — structured user input via MCP form elicitation
+    // -----------------------------------------------------------------------
+    server.tool('ask_user_questions', 'Request user input for one to three short questions and wait for the response. Single-select questions include a free-form "None of the above" path. Multi-select questions allow multiple choices.', {
+        questions: z.array(z.object({
+            id: z.string().describe('Stable identifier for mapping answers (snake_case)'),
+            header: z.string().describe('Short header label shown in the UI (12 or fewer chars)'),
+            question: z.string().describe('Single-sentence prompt shown to the user'),
+            options: z.array(z.object({
+                label: z.string().describe('User-facing label (1-5 words)'),
+                description: z.string().describe('One short sentence explaining impact/tradeoff if selected'),
+            })).describe('Provide 2-3 mutually exclusive choices. Put the recommended option first and suffix its label with "(Recommended)". Do not include an "Other" option for single-select questions.'),
+            allowMultiple: z.boolean().optional().describe('If true, the user can select multiple options. No "None of the above" option is added.'),
+        })).describe('Questions to show the user. Prefer 1 and do not exceed 3.'),
+    }, async (args) => {
+        const { questions } = args;
+        try {
+            const validationError = validateAskUserQuestionsPayload(questions);
+            if (validationError)
+                return errorContent(validationError);
+            const elicitation = await server.server.elicitInput(buildAskUserQuestionsElicitRequest(questions));
+            if (elicitation.action !== 'accept' || !elicitation.content) {
+                return textContent('ask_user_questions was cancelled before receiving a response');
+            }
+            return textContent(formatAskUserQuestionsElicitResult(questions, elicitation));
+        }
+        catch (err) {
+            return errorContent(err instanceof Error ? err.message : String(err));
+        }
+    });
     // =======================================================================
     // READ-ONLY TOOLS — no session required, pure filesystem reads
     // =======================================================================

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

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP Server — registers GSD orchestration, project-state, and workflow tools.\n *\n * Session tools (6): gsd_execute, gsd_status, gsd_result, gsd_cancel, gsd_query, gsd_resolve_blocker\n * Read-only tools (6): gsd_progress, gsd_roadmap, gsd_history, gsd_doctor, gsd_captures, gsd_knowledge\n * Workflow tools (17): planning, replanning, completion, validation, reassessment, gate result, and milestone status tools\n *\n * Uses dynamic imports for @modelcontextprotocol/sdk because TS Node16\n * cannot resolve the SDK's subpath exports statically (same pattern as\n * src/mcp-server.ts in the main package).\n */\n\nimport { readFile, readdir, stat } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { z } from 'zod';\nimport type { SessionManager } from './session-manager.js';\nimport { readProgress } from './readers/state.js';\nimport { readRoadmap } from './readers/roadmap.js';\nimport { readHistory } from './readers/metrics.js';\nimport { readCaptures } from './readers/captures.js';\nimport { readKnowledge } from './readers/knowledge.js';\nimport { runDoctorLite } from './readers/doctor-lite.js';\nimport { registerWorkflowTools } from './workflow-tools.js';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\nconst SERVER_NAME = 'gsd';\nconst SERVER_VERSION = '2.53.0';\n\n// ---------------------------------------------------------------------------\n// Tool result helpers\n// ---------------------------------------------------------------------------\n\n/** Wrap a JSON-serializable value as MCP tool content. */\nfunction jsonContent(data: unknown): { content: Array<{ type: 'text'; text: string }> } {\n  return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }] };\n}\n\n/** Return an MCP error response. */\nfunction errorContent(message: string): { isError: true; content: Array<{ type: 'text'; text: string }> } {\n  return { isError: true, content: [{ type: 'text' as const, text: message }] };\n}\n\n// ---------------------------------------------------------------------------\n// gsd_query filesystem reader\n// ---------------------------------------------------------------------------\n\nasync function readProjectState(projectDir: string, _query: string): Promise<Record<string, unknown>> {\n  const gsdDir = join(resolve(projectDir), '.gsd');\n  const result: Record<string, unknown> = { projectDir: resolve(projectDir) };\n\n  // STATE.md — current execution state\n  try {\n    result.state = await readFile(join(gsdDir, 'STATE.md'), 'utf-8');\n  } catch {\n    result.state = null;\n  }\n\n  // PROJECT.md — project description\n  try {\n    result.project = await readFile(join(gsdDir, 'PROJECT.md'), 'utf-8');\n  } catch {\n    result.project = null;\n  }\n\n  // REQUIREMENTS.md — requirement contract\n  try {\n    result.requirements = await readFile(join(gsdDir, 'REQUIREMENTS.md'), 'utf-8');\n  } catch {\n    result.requirements = null;\n  }\n\n  // List milestones with basic metadata\n  const milestonesDir = join(gsdDir, 'milestones');\n  try {\n    const entries = await readdir(milestonesDir, { withFileTypes: true });\n    const milestones: Array<{ id: string; hasRoadmap: boolean; hasSummary: boolean }> = [];\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      const mDir = join(milestonesDir, entry.name);\n      const hasRoadmap = await fileExists(join(mDir, `${entry.name}-ROADMAP.md`));\n      const hasSummary = await fileExists(join(mDir, `${entry.name}-SUMMARY.md`));\n      milestones.push({ id: entry.name, hasRoadmap, hasSummary });\n    }\n    result.milestones = milestones;\n  } catch {\n    result.milestones = [];\n  }\n\n  return result;\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// MCP Server type — minimal interface for the dynamically-imported McpServer\n// ---------------------------------------------------------------------------\n\ninterface McpServerInstance {\n  tool(name: string, description: string, params: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<unknown>): unknown;\n  connect(transport: unknown): Promise<void>;\n  close(): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// createMcpServer\n// ---------------------------------------------------------------------------\n\n/**\n * Create and configure an MCP server with session, read-only, and workflow tools.\n *\n * Returns the McpServer instance — call `connect(transport)` to start serving.\n * Uses dynamic imports for the MCP SDK to avoid TS subpath resolution issues.\n */\nexport async function createMcpServer(sessionManager: SessionManager): Promise<{\n  server: McpServerInstance;\n}> {\n  // Dynamic import — same workaround as src/mcp-server.ts\n  const mcpMod = await import(`${MCP_PKG}/server/mcp.js`);\n  const McpServer = mcpMod.McpServer;\n\n  const server: McpServerInstance = new McpServer(\n    { name: SERVER_NAME, version: SERVER_VERSION },\n    { capabilities: { tools: {} } },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_execute — start a new GSD auto-mode session\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_execute',\n    'Start a GSD auto-mode session for a project directory. Returns a sessionId for tracking.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      command: z.string().optional().describe('Command to send (default: \"/gsd auto\")'),\n      model: z.string().optional().describe('Model ID override'),\n      bare: z.boolean().optional().describe('Run in bare mode (skip user config)'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, command, model, bare } = args as {\n        projectDir: string; command?: string; model?: string; bare?: boolean;\n      };\n      try {\n        const sessionId = await sessionManager.startSession(projectDir, { command, model, bare });\n        return jsonContent({ sessionId, status: 'started' });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_status — poll session status\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_status',\n    'Get the current status of a GSD session including progress, recent events, and pending blockers.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        const session = sessionManager.getSession(sessionId);\n        if (!session) return errorContent(`Session not found: ${sessionId}`);\n\n        const durationMs = Date.now() - session.startTime;\n        const toolCallCount = session.events.filter(\n          (e) => (e as Record<string, unknown>).type === 'tool_use' ||\n                 (e as Record<string, unknown>).type === 'tool_execution_start'\n        ).length;\n\n        return jsonContent({\n          status: session.status,\n          progress: {\n            eventCount: session.events.length,\n            toolCalls: toolCallCount,\n          },\n          recentEvents: session.events.slice(-10),\n          pendingBlocker: session.pendingBlocker\n            ? {\n                id: session.pendingBlocker.id,\n                method: session.pendingBlocker.method,\n                message: session.pendingBlocker.message,\n              }\n            : null,\n          cost: session.cost,\n          durationMs,\n        });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_result — get accumulated session result\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_result',\n    'Get the result of a GSD session. Returns partial results if the session is still running.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        const result = sessionManager.getResult(sessionId);\n        return jsonContent(result);\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_cancel — cancel a running session\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_cancel',\n    'Cancel a running GSD session. Aborts the current operation and stops the process.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        await sessionManager.cancelSession(sessionId);\n        return jsonContent({ cancelled: true });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_query — read project state from filesystem (no session needed)\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_query',\n    'Query GSD project state from the filesystem. Returns STATE.md, PROJECT.md, requirements, and milestone listing. Does not require an active session.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      query: z.string().describe('What to query (e.g. \"status\", \"milestones\", \"requirements\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, query } = args as { projectDir: string; query: string };\n      try {\n        const state = await readProjectState(projectDir, query);\n        return jsonContent(state);\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_resolve_blocker — resolve a pending blocker\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_resolve_blocker',\n    'Resolve a pending blocker in a GSD session by sending a response to the UI request.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n      response: z.string().describe('Response to send for the pending blocker'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId, response } = args as { sessionId: string; response: string };\n      try {\n        await sessionManager.resolveBlocker(sessionId, response);\n        return jsonContent({ resolved: true });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // =======================================================================\n  // READ-ONLY TOOLS — no session required, pure filesystem reads\n  // =======================================================================\n\n  // -----------------------------------------------------------------------\n  // gsd_progress — structured project progress metrics\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_progress',\n    'Get structured project progress: active milestone/slice/task, phase, completion counts, blockers, and next action. No session required — reads directly from .gsd/ on disk.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir } = args as { projectDir: string };\n      try {\n        return jsonContent(readProgress(projectDir));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_roadmap — milestone/slice/task structure with status\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_roadmap',\n    'Get the full project roadmap structure: milestones with their slices, tasks, status, risk, and dependencies. Optionally filter to a single milestone. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      milestoneId: z.string().optional().describe('Filter to a specific milestone (e.g. \"M001\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, milestoneId } = args as { projectDir: string; milestoneId?: string };\n      try {\n        return jsonContent(readRoadmap(projectDir, milestoneId));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_history — execution history with cost/token metrics\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_history',\n    'Get execution history with cost, token usage, model, and duration per unit. Returns totals across all units. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      limit: z.number().optional().describe('Max entries to return (most recent first). Default: all.'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, limit } = args as { projectDir: string; limit?: number };\n      try {\n        return jsonContent(readHistory(projectDir, limit));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_doctor — lightweight structural health check\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_doctor',\n    'Run a lightweight structural health check on the .gsd/ directory. Checks for missing files, status inconsistencies, and orphaned state. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      scope: z.string().optional().describe('Limit checks to a specific milestone (e.g. \"M001\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, scope } = args as { projectDir: string; scope?: string };\n      try {\n        return jsonContent(runDoctorLite(projectDir, scope));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_captures — pending captures and ideas\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_captures',\n    'Get captured ideas and thoughts from CAPTURES.md with triage status. Filter by pending, actionable, or all. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      filter: z.enum(['all', 'pending', 'actionable']).optional().describe('Filter captures (default: \"all\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, filter } = args as { projectDir: string; filter?: 'all' | 'pending' | 'actionable' };\n      try {\n        return jsonContent(readCaptures(projectDir, filter ?? 'all'));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_knowledge — project knowledge base\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_knowledge',\n    'Get the project knowledge base: rules, patterns, and lessons learned accumulated during development. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir } = args as { projectDir: string };\n      try {\n        return jsonContent(readKnowledge(projectDir));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  registerWorkflowTools(server);\n\n  return { server };\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP Server — registers GSD orchestration, project-state, and workflow tools.\n *\n * Session tools (6): gsd_execute, gsd_status, gsd_result, gsd_cancel, gsd_query, gsd_resolve_blocker\n * Interactive tools (1): ask_user_questions via MCP form elicitation\n * Read-only tools (6): gsd_progress, gsd_roadmap, gsd_history, gsd_doctor, gsd_captures, gsd_knowledge\n * Workflow tools (29): headless-safe planning, metadata persistence, replanning, completion, validation, reassessment, gate result, status, and journal tools\n *\n * Uses dynamic imports for @modelcontextprotocol/sdk because TS Node16\n * cannot resolve the SDK's subpath exports statically (same pattern as\n * src/mcp-server.ts in the main package).\n */\n\nimport { readFile, readdir, stat } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { z } from 'zod';\nimport type { SessionManager } from './session-manager.js';\nimport { readProgress } from './readers/state.js';\nimport { readRoadmap } from './readers/roadmap.js';\nimport { readHistory } from './readers/metrics.js';\nimport { readCaptures } from './readers/captures.js';\nimport { readKnowledge } from './readers/knowledge.js';\nimport { runDoctorLite } from './readers/doctor-lite.js';\nimport { registerWorkflowTools } from './workflow-tools.js';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst MCP_PKG = '@modelcontextprotocol/sdk';\nconst SERVER_NAME = 'gsd';\nconst SERVER_VERSION = '2.53.0';\n\n// ---------------------------------------------------------------------------\n// Tool result helpers\n// ---------------------------------------------------------------------------\n\n/** Wrap a JSON-serializable value as MCP tool content. */\nfunction jsonContent(data: unknown): { content: Array<{ type: 'text'; text: string }> } {\n  return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }] };\n}\n\n/** Return an MCP error response. */\nfunction errorContent(message: string): { isError: true; content: Array<{ type: 'text'; text: string }> } {\n  return { isError: true, content: [{ type: 'text' as const, text: message }] };\n}\n\n/** Return raw text content without JSON wrapping. */\nfunction textContent(text: string): { content: Array<{ type: 'text'; text: string }> } {\n  return { content: [{ type: 'text' as const, text }] };\n}\n\n// ---------------------------------------------------------------------------\n// gsd_query filesystem reader\n// ---------------------------------------------------------------------------\n\nasync function readProjectState(projectDir: string, _query: string): Promise<Record<string, unknown>> {\n  const gsdDir = join(resolve(projectDir), '.gsd');\n  const result: Record<string, unknown> = { projectDir: resolve(projectDir) };\n\n  // STATE.md — current execution state\n  try {\n    result.state = await readFile(join(gsdDir, 'STATE.md'), 'utf-8');\n  } catch {\n    result.state = null;\n  }\n\n  // PROJECT.md — project description\n  try {\n    result.project = await readFile(join(gsdDir, 'PROJECT.md'), 'utf-8');\n  } catch {\n    result.project = null;\n  }\n\n  // REQUIREMENTS.md — requirement contract\n  try {\n    result.requirements = await readFile(join(gsdDir, 'REQUIREMENTS.md'), 'utf-8');\n  } catch {\n    result.requirements = null;\n  }\n\n  // List milestones with basic metadata\n  const milestonesDir = join(gsdDir, 'milestones');\n  try {\n    const entries = await readdir(milestonesDir, { withFileTypes: true });\n    const milestones: Array<{ id: string; hasRoadmap: boolean; hasSummary: boolean }> = [];\n    for (const entry of entries) {\n      if (!entry.isDirectory()) continue;\n      const mDir = join(milestonesDir, entry.name);\n      const hasRoadmap = await fileExists(join(mDir, `${entry.name}-ROADMAP.md`));\n      const hasSummary = await fileExists(join(mDir, `${entry.name}-SUMMARY.md`));\n      milestones.push({ id: entry.name, hasRoadmap, hasSummary });\n    }\n    result.milestones = milestones;\n  } catch {\n    result.milestones = [];\n  }\n\n  return result;\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// MCP Server type — minimal interface for the dynamically-imported McpServer\n// ---------------------------------------------------------------------------\n\ninterface McpServerInstance {\n  tool(name: string, description: string, params: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<unknown>): unknown;\n  server: {\n    elicitInput(\n      params: AskUserQuestionsElicitRequest,\n      options?: unknown,\n    ): Promise<AskUserQuestionsElicitResult>;\n  };\n  connect(transport: unknown): Promise<void>;\n  close(): Promise<void>;\n}\n\ninterface AskUserQuestionOption {\n  label: string;\n  description: string;\n}\n\ninterface AskUserQuestion {\n  id: string;\n  header: string;\n  question: string;\n  options: AskUserQuestionOption[];\n  allowMultiple?: boolean;\n}\n\ninterface AskUserQuestionsParams {\n  questions: AskUserQuestion[];\n}\n\ntype AskUserQuestionsContentValue = string | number | boolean | string[];\n\ninterface AskUserQuestionsElicitResult {\n  action: 'accept' | 'decline' | 'cancel';\n  content?: Record<string, AskUserQuestionsContentValue>;\n}\n\ninterface AskUserQuestionsElicitRequest {\n  mode: 'form';\n  message: string;\n  requestedSchema: {\n    type: 'object';\n    properties: Record<string, Record<string, unknown>>;\n    required?: string[];\n  };\n}\n\nconst OTHER_OPTION_LABEL = 'None of the above';\n\nfunction normalizeAskUserQuestionsNote(value: AskUserQuestionsContentValue | undefined): string {\n  return typeof value === 'string' ? value.trim() : '';\n}\n\nfunction normalizeAskUserQuestionsAnswers(\n  value: AskUserQuestionsContentValue | undefined,\n  allowMultiple: boolean,\n): string[] {\n  if (allowMultiple) {\n    return Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : [];\n  }\n\n  return typeof value === 'string' && value.length > 0 ? [value] : [];\n}\n\nfunction validateAskUserQuestionsPayload(questions: AskUserQuestion[]): string | null {\n  if (questions.length === 0 || questions.length > 3) {\n    return 'Error: questions must contain 1-3 items';\n  }\n\n  for (const question of questions) {\n    if (!question.options || question.options.length === 0) {\n      return `Error: ask_user_questions requires non-empty options for every question (question \"${question.id}\" has none)`;\n    }\n  }\n\n  return null;\n}\n\nexport function buildAskUserQuestionsElicitRequest(questions: AskUserQuestion[]): AskUserQuestionsElicitRequest {\n  const properties: Record<string, Record<string, unknown>> = {};\n  const required = questions.map((question) => question.id);\n\n  for (const question of questions) {\n    if (question.allowMultiple) {\n      properties[question.id] = {\n        type: 'array',\n        title: question.header,\n        description: question.question,\n        minItems: 1,\n        maxItems: question.options.length,\n        items: {\n          anyOf: question.options.map((option) => ({\n            const: option.label,\n            title: option.label,\n          })),\n        },\n      };\n      continue;\n    }\n\n    properties[question.id] = {\n      type: 'string',\n      title: question.header,\n      description: question.question,\n      oneOf: [...question.options, { label: OTHER_OPTION_LABEL, description: 'Choose this when the listed options do not fit.' }].map((option) => ({\n        const: option.label,\n        title: option.label,\n      })),\n    };\n\n    properties[`${question.id}__note`] = {\n      type: 'string',\n      title: `${question.header} Note`,\n      description: `Optional note for \"${OTHER_OPTION_LABEL}\".`,\n      maxLength: 500,\n    };\n  }\n\n  return {\n    mode: 'form',\n    message: 'Please answer the following question(s). For single-select questions, choose \"None of the above\" and add a note if the provided options do not fit.',\n    requestedSchema: {\n      type: 'object',\n      properties,\n      required,\n    },\n  };\n}\n\nexport function formatAskUserQuestionsElicitResult(\n  questions: AskUserQuestion[],\n  result: AskUserQuestionsElicitResult,\n): string {\n  const answers: Record<string, { answers: string[] }> = {};\n  const content = result.content ?? {};\n\n  for (const question of questions) {\n    const answerList = normalizeAskUserQuestionsAnswers(content[question.id], !!question.allowMultiple);\n\n    if (!question.allowMultiple && answerList[0] === OTHER_OPTION_LABEL) {\n      const note = normalizeAskUserQuestionsNote(content[`${question.id}__note`]);\n      if (note) {\n        answerList.push(`user_note: ${note}`);\n      }\n    }\n\n    answers[question.id] = { answers: answerList };\n  }\n\n  return JSON.stringify({ answers });\n}\n\n// ---------------------------------------------------------------------------\n// createMcpServer\n// ---------------------------------------------------------------------------\n\n/**\n * Create and configure an MCP server with session, read-only, and workflow tools.\n *\n * Returns the McpServer instance — call `connect(transport)` to start serving.\n * Uses dynamic imports for the MCP SDK to avoid TS subpath resolution issues.\n */\nexport async function createMcpServer(sessionManager: SessionManager): Promise<{\n  server: McpServerInstance;\n}> {\n  // Dynamic import — same workaround as src/mcp-server.ts\n  const mcpMod = await import(`${MCP_PKG}/server/mcp.js`);\n  const McpServer = mcpMod.McpServer;\n\n  const server: McpServerInstance = new McpServer(\n    { name: SERVER_NAME, version: SERVER_VERSION },\n    { capabilities: { tools: {} } },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_execute — start a new GSD auto-mode session\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_execute',\n    'Start a GSD auto-mode session for a project directory. Returns a sessionId for tracking.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      command: z.string().optional().describe('Command to send (default: \"/gsd auto\")'),\n      model: z.string().optional().describe('Model ID override'),\n      bare: z.boolean().optional().describe('Run in bare mode (skip user config)'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, command, model, bare } = args as {\n        projectDir: string; command?: string; model?: string; bare?: boolean;\n      };\n      try {\n        const sessionId = await sessionManager.startSession(projectDir, { command, model, bare });\n        return jsonContent({ sessionId, status: 'started' });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_status — poll session status\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_status',\n    'Get the current status of a GSD session including progress, recent events, and pending blockers.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        const session = sessionManager.getSession(sessionId);\n        if (!session) return errorContent(`Session not found: ${sessionId}`);\n\n        const durationMs = Date.now() - session.startTime;\n        const toolCallCount = session.events.filter(\n          (e) => (e as Record<string, unknown>).type === 'tool_use' ||\n                 (e as Record<string, unknown>).type === 'tool_execution_start'\n        ).length;\n\n        return jsonContent({\n          status: session.status,\n          progress: {\n            eventCount: session.events.length,\n            toolCalls: toolCallCount,\n          },\n          recentEvents: session.events.slice(-10),\n          pendingBlocker: session.pendingBlocker\n            ? {\n                id: session.pendingBlocker.id,\n                method: session.pendingBlocker.method,\n                message: session.pendingBlocker.message,\n              }\n            : null,\n          cost: session.cost,\n          durationMs,\n        });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_result — get accumulated session result\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_result',\n    'Get the result of a GSD session. Returns partial results if the session is still running.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        const result = sessionManager.getResult(sessionId);\n        return jsonContent(result);\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_cancel — cancel a running session\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_cancel',\n    'Cancel a running GSD session. Aborts the current operation and stops the process.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId } = args as { sessionId: string };\n      try {\n        await sessionManager.cancelSession(sessionId);\n        return jsonContent({ cancelled: true });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_query — read project state from filesystem (no session needed)\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_query',\n    'Query GSD project state from the filesystem. Returns STATE.md, PROJECT.md, requirements, and milestone listing. Does not require an active session.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      query: z.string().describe('What to query (e.g. \"status\", \"milestones\", \"requirements\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, query } = args as { projectDir: string; query: string };\n      try {\n        const state = await readProjectState(projectDir, query);\n        return jsonContent(state);\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_resolve_blocker — resolve a pending blocker\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_resolve_blocker',\n    'Resolve a pending blocker in a GSD session by sending a response to the UI request.',\n    {\n      sessionId: z.string().describe('Session ID returned from gsd_execute'),\n      response: z.string().describe('Response to send for the pending blocker'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { sessionId, response } = args as { sessionId: string; response: string };\n      try {\n        await sessionManager.resolveBlocker(sessionId, response);\n        return jsonContent({ resolved: true });\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // ask_user_questions — structured user input via MCP form elicitation\n  // -----------------------------------------------------------------------\n  server.tool(\n    'ask_user_questions',\n    'Request user input for one to three short questions and wait for the response. Single-select questions include a free-form \"None of the above\" path. Multi-select questions allow multiple choices.',\n    {\n      questions: z.array(z.object({\n        id: z.string().describe('Stable identifier for mapping answers (snake_case)'),\n        header: z.string().describe('Short header label shown in the UI (12 or fewer chars)'),\n        question: z.string().describe('Single-sentence prompt shown to the user'),\n        options: z.array(z.object({\n          label: z.string().describe('User-facing label (1-5 words)'),\n          description: z.string().describe('One short sentence explaining impact/tradeoff if selected'),\n        })).describe('Provide 2-3 mutually exclusive choices. Put the recommended option first and suffix its label with \"(Recommended)\". Do not include an \"Other\" option for single-select questions.'),\n        allowMultiple: z.boolean().optional().describe('If true, the user can select multiple options. No \"None of the above\" option is added.'),\n      })).describe('Questions to show the user. Prefer 1 and do not exceed 3.'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { questions } = args as unknown as AskUserQuestionsParams;\n      try {\n        const validationError = validateAskUserQuestionsPayload(questions);\n        if (validationError) return errorContent(validationError);\n\n        const elicitation = await server.server.elicitInput(buildAskUserQuestionsElicitRequest(questions));\n        if (elicitation.action !== 'accept' || !elicitation.content) {\n          return textContent('ask_user_questions was cancelled before receiving a response');\n        }\n\n        return textContent(formatAskUserQuestionsElicitResult(questions, elicitation));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // =======================================================================\n  // READ-ONLY TOOLS — no session required, pure filesystem reads\n  // =======================================================================\n\n  // -----------------------------------------------------------------------\n  // gsd_progress — structured project progress metrics\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_progress',\n    'Get structured project progress: active milestone/slice/task, phase, completion counts, blockers, and next action. No session required — reads directly from .gsd/ on disk.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir } = args as { projectDir: string };\n      try {\n        return jsonContent(readProgress(projectDir));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_roadmap — milestone/slice/task structure with status\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_roadmap',\n    'Get the full project roadmap structure: milestones with their slices, tasks, status, risk, and dependencies. Optionally filter to a single milestone. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      milestoneId: z.string().optional().describe('Filter to a specific milestone (e.g. \"M001\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, milestoneId } = args as { projectDir: string; milestoneId?: string };\n      try {\n        return jsonContent(readRoadmap(projectDir, milestoneId));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_history — execution history with cost/token metrics\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_history',\n    'Get execution history with cost, token usage, model, and duration per unit. Returns totals across all units. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      limit: z.number().optional().describe('Max entries to return (most recent first). Default: all.'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, limit } = args as { projectDir: string; limit?: number };\n      try {\n        return jsonContent(readHistory(projectDir, limit));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_doctor — lightweight structural health check\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_doctor',\n    'Run a lightweight structural health check on the .gsd/ directory. Checks for missing files, status inconsistencies, and orphaned state. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      scope: z.string().optional().describe('Limit checks to a specific milestone (e.g. \"M001\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, scope } = args as { projectDir: string; scope?: string };\n      try {\n        return jsonContent(runDoctorLite(projectDir, scope));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_captures — pending captures and ideas\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_captures',\n    'Get captured ideas and thoughts from CAPTURES.md with triage status. Filter by pending, actionable, or all. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n      filter: z.enum(['all', 'pending', 'actionable']).optional().describe('Filter captures (default: \"all\")'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir, filter } = args as { projectDir: string; filter?: 'all' | 'pending' | 'actionable' };\n      try {\n        return jsonContent(readCaptures(projectDir, filter ?? 'all'));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  // -----------------------------------------------------------------------\n  // gsd_knowledge — project knowledge base\n  // -----------------------------------------------------------------------\n  server.tool(\n    'gsd_knowledge',\n    'Get the project knowledge base: rules, patterns, and lessons learned accumulated during development. No session required.',\n    {\n      projectDir: z.string().describe('Absolute path to the project directory'),\n    },\n    async (args: Record<string, unknown>) => {\n      const { projectDir } = args as { projectDir: string };\n      try {\n        return jsonContent(readKnowledge(projectDir));\n      } catch (err) {\n        return errorContent(err instanceof Error ? err.message : String(err));\n      }\n    },\n  );\n\n  registerWorkflowTools(server);\n\n  return { server };\n}\n"]}

package/packages/mcp-server/dist/tool-credentials.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveAuthPath(env?: NodeJS.ProcessEnv): string;
+export declare function loadStoredCredentialEnvKeys(options?: {
+    env?: NodeJS.ProcessEnv;
+    authPath?: string;
+}): string[];
+//# sourceMappingURL=tool-credentials.d.ts.map

package/packages/mcp-server/dist/tool-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-credentials.d.ts","sourceRoot":"","sources":["../src/tool-credentials.ts"],"names":[],"mappings":"AA8DA,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI5E;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,EAAE,CAyBhB"}