@burdenoff/mcp-libs 2026.522.1 → 2026.523.1

package/dist/modules/tours/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/result.ts","../../../src/core/tool-name.ts","../../../src/modules/tours/operations.ts","../../../src/modules/tours/tools.ts","../../../src/modules/tours/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error classes for MCP SDK.\n *\n * Modules MUST throw these instead of throwing raw Errors. The registerTool\n * wrapper in result.ts catches and maps them to MCP-protocol-compliant\n * `{ isError: true, content: [...] }` responses.\n *\n * Throwing past the wrapper to the protocol surfaces as JSON-RPC -32603 to\n * the client and is a protocol bug.\n */\n\nexport class McpUserError extends Error {\n  public readonly hint: string | undefined;\n\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message);\n    this.name = 'McpUserError';\n    this.hint = opts?.hint;\n  }\n}\n\nexport class McpAuthError extends McpUserError {\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message, {\n      hint: opts?.hint ?? 'Run the auth_login tool to authenticate.',\n    });\n    this.name = 'McpAuthError';\n  }\n}\n\nexport class McpInternalError extends Error {\n  public override readonly cause: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = 'McpInternalError';\n    this.cause = cause;\n  }\n}\n","/**\n * MCP tool result helpers + central handler.\n *\n * Modules NEVER call server.registerTool directly — they use registerTool()\n * from this module so the central try/catch wraps the handler and:\n *   - maps thrown McpUserError / McpAuthError / McpInternalError to\n *     MCP-protocol-compliant `{ isError: true, content: [...] }` shapes\n *   - threads `_meta.progressToken` into ctx.progress for long ops\n *   - emits a structured log line on every error\n *   - never leaks `cause` from McpInternalError to the client\n *\n * This is the analog of cli-sdk's createProgram() central error handler.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { ZodRawShape } from 'zod';\nimport type { McpContext } from './context.js';\nimport { McpAuthError, McpInternalError, McpUserError } from './errors.js';\n\nexport interface ToolTextContent {\n  type: 'text';\n  text: string;\n  [k: string]: unknown;\n}\n\nexport interface ToolResult {\n  content: ToolTextContent[];\n  isError?: boolean;\n  structuredContent?: Record<string, unknown>;\n  [k: string]: unknown;\n}\n\nexport interface ToolMeta {\n  progressToken?: string | number;\n}\n\n/**\n * Build a successful tool result with JSON content (pretty-printed).\n */\nexport function jsonResult(data: unknown, structured?: Record<string, unknown>): ToolResult {\n  const result: ToolResult = {\n    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],\n  };\n  if (structured !== undefined) {\n    result.structuredContent = structured;\n  }\n  return result;\n}\n\n/**\n * Build a successful tool result with plain text content.\n */\nexport function textResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }] };\n}\n\n/**\n * Build an error tool result. Honors MCP's `{ isError: true, content }` shape.\n * Optional hint is appended on a new line so the LLM can react.\n */\nexport function errorResult(message: string, hint?: string): ToolResult {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return { content: [{ type: 'text', text }], isError: true };\n}\n\nexport interface ToolMetadata {\n  title: string;\n  description: string;\n  inputSchema?: ZodRawShape;\n}\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n  ctx: McpContext,\n  meta: ToolMeta,\n) => Promise<unknown>;\n\n/**\n * Register a tool with the central error wrapper.\n *\n * The handler returns a plain value or void. The wrapper:\n *   - wraps non-undefined returns in jsonResult()\n *   - if the value already looks like a ToolResult (has `content`), passes through\n *   - catches McpAuthError / McpUserError / McpInternalError / generic Error\n *   - logs every error via ctx.logger.error\n */\nexport function registerTool<TArgs extends Record<string, unknown>>(\n  server: McpServer,\n  ctx: McpContext,\n  name: string,\n  metadata: ToolMetadata,\n  handler: ToolHandler<TArgs>,\n): void {\n  const sdkConfig = {\n    title: metadata.title,\n    description: metadata.description,\n    ...(metadata.inputSchema ? { inputSchema: metadata.inputSchema } : {}),\n  };\n\n  // The MCP SDK's registerTool signature is `(name, config, handler)`. The\n  // handler arity depends on whether inputSchema is present (1-arg without,\n  // 2-arg with). We accept a unified handler shape and dispatch at runtime.\n  // The SDK's typing is strict and conditional on the inputSchema generic;\n  // bypass with a cast since runtime acceptance is unconditional.\n  const wrapped = async (...callbackArgs: unknown[]): Promise<ToolResult> => {\n    const hasArgs = callbackArgs.length === 2;\n    const args = (hasArgs ? callbackArgs[0] : {}) as TArgs;\n    const extra = (hasArgs ? callbackArgs[1] : callbackArgs[0]) as\n      | { _meta?: { progressToken?: string | number } }\n      | undefined;\n\n    const progressToken = extra?._meta?.progressToken;\n    const meta: ToolMeta = progressToken !== undefined ? { progressToken } : {};\n\n    try {\n      const result = await handler(args, ctx, meta);\n      if (isToolResult(result)) return result;\n      if (result === undefined) return textResult('OK');\n      return jsonResult(result);\n    } catch (error) {\n      return mapErrorToResult(error, ctx, name);\n    }\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (server as any).registerTool(name, sdkConfig, wrapped);\n}\n\nfunction isToolResult(value: unknown): value is ToolResult {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    'content' in value &&\n    Array.isArray((value as ToolResult).content)\n  );\n}\n\nfunction mapErrorToResult(error: unknown, ctx: McpContext, toolName: string): ToolResult {\n  if (error instanceof McpAuthError) {\n    ctx.logger.warn(`${toolName}: auth required`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpUserError) {\n    ctx.logger.info(`${toolName}: user error`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpInternalError) {\n    ctx.logger.error(`${toolName}: internal error`, {\n      message: error.message,\n      cause: stringifyCause(error.cause),\n    });\n    return errorResult(`Internal error in ${toolName}.`);\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  ctx.logger.error(`${toolName}: unhandled error`, { message });\n  return errorResult(`${toolName}: ${message}`);\n}\n\nfunction stringifyCause(cause: unknown): string | undefined {\n  if (cause === undefined || cause === null) return undefined;\n  if (cause instanceof Error) return cause.message;\n  try {\n    return JSON.stringify(cause);\n  } catch {\n    return String(cause);\n  }\n}\n","/**\n * Tool / resource / prompt naming helpers.\n *\n * Mandatory product prefix avoids collisions when Claude Desktop runs\n * multiple MCP servers concurrently (typical setup is ~6).\n *\n * Tool names are capped at 63 characters — Claude Desktop pre-1.x\n * truncated at 64 in some versions.\n */\n\nimport { McpInternalError } from './errors.js';\n\nconst MAX_TOOL_NAME_LENGTH = 63;\n\nfunction assertSafeName(name: string, kind: 'tool' | 'resource' | 'prompt'): string {\n  if (kind === 'tool' && name.length > MAX_TOOL_NAME_LENGTH) {\n    throw new McpInternalError(\n      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`,\n    );\n  }\n  return name;\n}\n\n/**\n * Build a tool name. Format: `<productName>_<...parts>` (snake_case).\n * Example: mcpToolName('vibecontrols', 'vibes', 'list') -> 'vibecontrols_vibes_list'\n */\nexport function mcpToolName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpToolName: productName is required');\n  }\n  const name = [productName, ...parts].filter(Boolean).join('_');\n  return assertSafeName(name, 'tool');\n}\n\n/**\n * Build a resource URI. Format: `<productName>://<...parts>`.\n * Example: mcpResourceUri('vibecontrols', 'schema') -> 'vibecontrols://schema'\n */\nexport function mcpResourceUri(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpResourceUri: productName is required');\n  }\n  return `${productName}://${parts.filter(Boolean).join('/')}`;\n}\n\n/**\n * Build a prompt name. Format: `<productName>-<...parts>` (kebab-case).\n * Example: mcpPromptName('vibecontrols', 'setup') -> 'vibecontrols-setup'\n */\nexport function mcpPromptName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpPromptName: productName is required');\n  }\n  return [productName, ...parts].filter(Boolean).join('-');\n}\n\nexport const TOOL_NAME_LIMIT = MAX_TOOL_NAME_LENGTH;\n","export const LIST_TOURS = `\n  query ListTours($filters: TourFilters, $pagination: TourPagination) {\n    tours(filters: $filters, pagination: $pagination) {\n      tours {\n        id\n        name\n        slug\n        description\n        status\n        isActive\n        productId\n        moduleId\n        priority\n        displayOrder\n        createdAt\n        updatedAt\n      }\n      total\n      hasMore\n    }\n  }\n`;\n\nexport const GET_USER_TOUR_PROGRESS = `\n  query GetUserTourProgress($userId: ID, $pagination: TourPagination) {\n    userTourProgresses(userId: $userId, pagination: $pagination) {\n      id\n      tourId\n      userId\n      status\n      currentStepId\n      currentStepOrder\n      completedSteps\n      skippedSteps\n      startedAt\n      completedAt\n      lastViewedAt\n    }\n  }\n`;\n\nexport const RESET_TOUR_PROGRESS = `\n  mutation ResetTourProgress($tourId: ID!, $userId: ID!) {\n    resetTourProgress(tourId: $tourId, userId: $userId) {\n      id\n      tourId\n      status\n      currentStepId\n      currentStepOrder\n    }\n  }\n`;\n","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport { LIST_TOURS, GET_USER_TOUR_PROGRESS, RESET_TOUR_PROGRESS } from './operations.js';\n\nexport function registerToursTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_list')),\n    {\n      title: 'List Tours',\n      description: 'List available product tours.',\n      inputSchema: {\n        productId: z.string().optional().describe('Filter by productId'),\n        moduleId: z.string().optional().describe('Filter by moduleId'),\n        status: z.string().optional().describe('Filter by status'),\n        isActive: z.boolean().optional().describe('Only active tours'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ productId, moduleId, status, isActive, limit, offset }) => {\n      try {\n        const filters: Record<string, unknown> = {};\n        if (productId !== undefined) filters.productId = productId;\n        if (moduleId !== undefined) filters.moduleId = moduleId;\n        if (status !== undefined) filters.status = status.toUpperCase();\n        if (isActive !== undefined) filters.isActive = isActive;\n        const data = await ctx.gql.global.request<{ tours: unknown }>(LIST_TOURS, {\n          filters: Object.keys(filters).length ? filters : undefined,\n          pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n        });\n        return jsonResult(data.tours);\n      } catch (error) {\n        ctx.logger.error('tours_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list tours: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_get')),\n    {\n      title: 'Get Tour Progress',\n      description: \"Get the current user's tour progress, optionally filtered by user id.\",\n      inputSchema: {\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ userId, limit, offset }) => {\n      try {\n        const data = await ctx.gql.global.request<{ userTourProgresses: unknown }>(\n          GET_USER_TOUR_PROGRESS,\n          {\n            userId,\n            pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n          },\n        );\n        return jsonResult(data.userTourProgresses);\n      } catch (error) {\n        ctx.logger.error('tours_progress_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_reset')),\n    {\n      title: 'Reset Tour Progress',\n      description: 'Reset tour progress for the given user (defaults to the current actor).',\n      inputSchema: {\n        tourId: z.string().describe('Tour ID'),\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n      },\n    },\n    async ({ tourId, userId }) => {\n      try {\n        const auth = ctx.auth.read();\n        const resolvedUserId = userId ?? auth?.workspaceId;\n        if (!resolvedUserId) {\n          return errorResult(\n            'Unable to resolve user; pass userId or authenticate to a workspace first.',\n          );\n        }\n        const data = await ctx.gql.global.request<{ resetTourProgress: unknown }>(\n          RESET_TOUR_PROGRESS,\n          { tourId, userId: resolvedUserId },\n        );\n        return jsonResult(data.resetTourProgress);\n      } catch (error) {\n        ctx.logger.error('tours_progress_reset failed', { error: String(error) });\n        return errorResult(\n          `Failed to reset tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Tours module — product tours + per-user progress.\n *\n * Tools:\n *   <product>_tours_list\n *   <product>_tours_progress_{get,reset}\n *\n * Backend: ~/products/global/tours/global-tours-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerToursTools } from './tools.js';\n\nconst toursModule: McpModule = {\n  id: 'tours',\n  version: '0.0.1',\n  displayName: 'Tours',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n\n    registerToursTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default toursModule;\n"]}
+{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/result.ts","../../../src/core/tool-name.ts","../../../src/modules/tours/operations.ts","../../../src/modules/tours/tools.ts","../../../src/modules/tours/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error classes for MCP SDK.\n *\n * Modules MUST throw these instead of throwing raw Errors. The registerTool\n * wrapper in result.ts catches and maps them to MCP-protocol-compliant\n * `{ isError: true, content: [...] }` responses.\n *\n * Throwing past the wrapper to the protocol surfaces as JSON-RPC -32603 to\n * the client and is a protocol bug.\n */\n\nexport class McpUserError extends Error {\n  public readonly hint: string | undefined;\n\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message);\n    this.name = 'McpUserError';\n    this.hint = opts?.hint;\n  }\n}\n\nexport class McpAuthError extends McpUserError {\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message, {\n      hint: opts?.hint ?? 'Run the auth_login tool to authenticate.',\n    });\n    this.name = 'McpAuthError';\n  }\n}\n\nexport class McpInternalError extends Error {\n  public override readonly cause: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = 'McpInternalError';\n    this.cause = cause;\n  }\n}\n","/**\n * MCP tool result helpers + central handler.\n *\n * Modules NEVER call server.registerTool directly — they use registerTool()\n * from this module so the central try/catch wraps the handler and:\n *   - maps thrown McpUserError / McpAuthError / McpInternalError to\n *     MCP-protocol-compliant `{ isError: true, content: [...] }` shapes\n *   - threads `_meta.progressToken` into ctx.progress for long ops\n *   - emits a structured log line on every error\n *   - never leaks `cause` from McpInternalError to the client\n *\n * This is the analog of cli-sdk's createProgram() central error handler.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { ZodRawShape } from 'zod';\nimport type { McpContext } from './context.js';\nimport { McpAuthError, McpInternalError, McpUserError } from './errors.js';\n\nexport interface ToolTextContent {\n  type: 'text';\n  text: string;\n  [k: string]: unknown;\n}\n\nexport interface ToolResult {\n  content: ToolTextContent[];\n  isError?: boolean;\n  structuredContent?: Record<string, unknown>;\n  [k: string]: unknown;\n}\n\nexport interface ToolMeta {\n  progressToken?: string | number;\n}\n\n/**\n * Build a successful tool result with JSON content (pretty-printed).\n */\nexport function jsonResult(data: unknown, structured?: Record<string, unknown>): ToolResult {\n  const result: ToolResult = {\n    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],\n  };\n  if (structured !== undefined) {\n    result.structuredContent = structured;\n  }\n  return result;\n}\n\n/**\n * Build a successful tool result with plain text content.\n */\nexport function textResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }] };\n}\n\n/**\n * Build an error tool result. Honors MCP's `{ isError: true, content }` shape.\n * Optional hint is appended on a new line so the LLM can react.\n */\nexport function errorResult(message: string, hint?: string): ToolResult {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return { content: [{ type: 'text', text }], isError: true };\n}\n\nexport interface ToolMetadata {\n  title: string;\n  description: string;\n  inputSchema?: ZodRawShape;\n}\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n  ctx: McpContext,\n  meta: ToolMeta,\n) => Promise<unknown>;\n\n/**\n * Register a tool with the central error wrapper.\n *\n * The handler returns a plain value or void. The wrapper:\n *   - wraps non-undefined returns in jsonResult()\n *   - if the value already looks like a ToolResult (has `content`), passes through\n *   - catches McpAuthError / McpUserError / McpInternalError / generic Error\n *   - logs every error via ctx.logger.error\n */\nexport function registerTool<TArgs extends Record<string, unknown>>(\n  server: McpServer,\n  ctx: McpContext,\n  name: string,\n  metadata: ToolMetadata,\n  handler: ToolHandler<TArgs>,\n): void {\n  const sdkConfig = {\n    title: metadata.title,\n    description: metadata.description,\n    ...(metadata.inputSchema ? { inputSchema: metadata.inputSchema } : {}),\n  };\n\n  // The MCP SDK's registerTool signature is `(name, config, handler)`. The\n  // handler arity depends on whether inputSchema is present (1-arg without,\n  // 2-arg with). We accept a unified handler shape and dispatch at runtime.\n  // The SDK's typing is strict and conditional on the inputSchema generic;\n  // bypass with a cast since runtime acceptance is unconditional.\n  const wrapped = async (...callbackArgs: unknown[]): Promise<ToolResult> => {\n    const hasArgs = callbackArgs.length === 2;\n    const args = (hasArgs ? callbackArgs[0] : {}) as TArgs;\n    const extra = (hasArgs ? callbackArgs[1] : callbackArgs[0]) as\n      | { _meta?: { progressToken?: string | number } }\n      | undefined;\n\n    const progressToken = extra?._meta?.progressToken;\n    const meta: ToolMeta = progressToken !== undefined ? { progressToken } : {};\n\n    try {\n      const result = await handler(args, ctx, meta);\n      if (isToolResult(result)) return result;\n      if (result === undefined) return textResult('OK');\n      return jsonResult(result);\n    } catch (error) {\n      return mapErrorToResult(error, ctx, name);\n    }\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (server as any).registerTool(name, sdkConfig, wrapped);\n}\n\nfunction isToolResult(value: unknown): value is ToolResult {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    'content' in value &&\n    Array.isArray((value as ToolResult).content)\n  );\n}\n\nfunction mapErrorToResult(error: unknown, ctx: McpContext, toolName: string): ToolResult {\n  if (error instanceof McpAuthError) {\n    ctx.logger.warn(`${toolName}: auth required`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpUserError) {\n    ctx.logger.info(`${toolName}: user error`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpInternalError) {\n    ctx.logger.error(`${toolName}: internal error`, {\n      message: error.message,\n      cause: stringifyCause(error.cause),\n    });\n    return errorResult(`Internal error in ${toolName}.`);\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  ctx.logger.error(`${toolName}: unhandled error`, { message });\n  return errorResult(`${toolName}: ${message}`);\n}\n\nfunction stringifyCause(cause: unknown): string | undefined {\n  if (cause === undefined || cause === null) return undefined;\n  if (cause instanceof Error) return cause.message;\n  try {\n    return JSON.stringify(cause);\n  } catch {\n    return String(cause);\n  }\n}\n","/**\n * Tool / resource / prompt naming helpers.\n *\n * Mandatory product prefix avoids collisions when Claude Desktop runs\n * multiple MCP servers concurrently (typical setup is ~6).\n *\n * Tool names are capped at 63 characters — Claude Desktop pre-1.x\n * truncated at 64 in some versions.\n */\n\nimport { McpInternalError } from './errors.js';\n\nconst MAX_TOOL_NAME_LENGTH = 63;\n\nfunction assertSafeName(name: string, kind: 'tool' | 'resource' | 'prompt'): string {\n  if (kind === 'tool' && name.length > MAX_TOOL_NAME_LENGTH) {\n    throw new McpInternalError(\n      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`,\n    );\n  }\n  return name;\n}\n\n/**\n * Build a tool name. Format: `<productName>_<...parts>` (snake_case).\n * Example: mcpToolName('vibecontrols', 'vibes', 'list') -> 'vibecontrols_vibes_list'\n */\nexport function mcpToolName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpToolName: productName is required');\n  }\n  const name = [productName, ...parts].filter(Boolean).join('_');\n  return assertSafeName(name, 'tool');\n}\n\n/**\n * Build a resource URI. Format: `<productName>://<...parts>`.\n * Example: mcpResourceUri('vibecontrols', 'schema') -> 'vibecontrols://schema'\n */\nexport function mcpResourceUri(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpResourceUri: productName is required');\n  }\n  return `${productName}://${parts.filter(Boolean).join('/')}`;\n}\n\n/**\n * Build a prompt name. Format: `<productName>-<...parts>` (kebab-case).\n * Example: mcpPromptName('vibecontrols', 'setup') -> 'vibecontrols-setup'\n */\nexport function mcpPromptName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpPromptName: productName is required');\n  }\n  return [productName, ...parts].filter(Boolean).join('-');\n}\n\nexport const TOOL_NAME_LIMIT = MAX_TOOL_NAME_LENGTH;\n","export const LIST_TOURS = `\n  query ListTours($filters: TourFilters, $pagination: TourPagination) {\n    tours(filters: $filters, pagination: $pagination) {\n      tours {\n        id\n        name\n        slug\n        description\n        status\n        isActive\n        productId\n        moduleId\n        priority\n        displayOrder\n        createdAt\n        updatedAt\n      }\n      total\n      hasMore\n    }\n  }\n`;\n\nexport const GET_USER_TOUR_PROGRESS = `\n  query GetUserTourProgress($userId: ID, $pagination: TourPagination) {\n    userTourProgresses(userId: $userId, pagination: $pagination) {\n      id\n      tourId\n      userId\n      status\n      currentStepId\n      currentStepOrder\n      completedSteps\n      skippedSteps\n      startedAt\n      completedAt\n      lastViewedAt\n    }\n  }\n`;\n\nexport const RESET_TOUR_PROGRESS = `\n  mutation ResetTourProgress($tourId: ID!, $userId: ID!) {\n    resetTourProgress(tourId: $tourId, userId: $userId) {\n      id\n      tourId\n      status\n      currentStepId\n      currentStepOrder\n    }\n  }\n`;\n\nexport const COMPLETE_TOUR_STEP = `\n  mutation CompleteTourStep($tourId: ID!, $stepId: ID!, $userId: ID!) {\n    completeStep(tourId: $tourId, stepId: $stepId, userId: $userId) {\n      id\n      tourId\n      userId\n      status\n      currentStepId\n      currentStepOrder\n      completedSteps\n      lastViewedAt\n    }\n  }\n`;\n","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport {\n  LIST_TOURS,\n  GET_USER_TOUR_PROGRESS,\n  RESET_TOUR_PROGRESS,\n  COMPLETE_TOUR_STEP,\n} from './operations.js';\n\nexport function registerToursTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_list')),\n    {\n      title: 'List Tours',\n      description: 'List available product tours.',\n      inputSchema: {\n        productId: z.string().optional().describe('Filter by productId'),\n        moduleId: z.string().optional().describe('Filter by moduleId'),\n        status: z.string().optional().describe('Filter by status'),\n        isActive: z.boolean().optional().describe('Only active tours'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ productId, moduleId, status, isActive, limit, offset }) => {\n      try {\n        const filters: Record<string, unknown> = {};\n        if (productId !== undefined) filters.productId = productId;\n        if (moduleId !== undefined) filters.moduleId = moduleId;\n        if (status !== undefined) filters.status = status.toUpperCase();\n        if (isActive !== undefined) filters.isActive = isActive;\n        const data = await ctx.gql.global.request<{ tours: unknown }>(LIST_TOURS, {\n          filters: Object.keys(filters).length ? filters : undefined,\n          pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n        });\n        return jsonResult(data.tours);\n      } catch (error) {\n        ctx.logger.error('tours_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list tours: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_get')),\n    {\n      title: 'Get Tour Progress',\n      description: \"Get the current user's tour progress, optionally filtered by user id.\",\n      inputSchema: {\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ userId, limit, offset }) => {\n      try {\n        const data = await ctx.gql.global.request<{ userTourProgresses: unknown }>(\n          GET_USER_TOUR_PROGRESS,\n          {\n            userId,\n            pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n          },\n        );\n        return jsonResult(data.userTourProgresses);\n      } catch (error) {\n        ctx.logger.error('tours_progress_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_complete')),\n    {\n      title: 'Complete Tour Step',\n      description:\n        'Mark a tour step as completed for the given user. The user can only complete steps for themselves — the gateway rejects mismatched userId. Returns the updated UserTourProgress.',\n      inputSchema: {\n        tourId: z.string().describe('Tour ID'),\n        stepId: z.string().describe('Tour step ID'),\n        userId: z\n          .string()\n          .describe(\n            'User ID to mark the step completed for (must match the authenticated actor at the gateway)',\n          ),\n      },\n    },\n    async ({ tourId, stepId, userId }) => {\n      try {\n        const data = await ctx.gql.global.request<{ completeStep: unknown }>(COMPLETE_TOUR_STEP, {\n          tourId,\n          stepId,\n          userId,\n        });\n        return jsonResult(data.completeStep);\n      } catch (error) {\n        ctx.logger.error('tours_complete failed', { error: String(error) });\n        return errorResult(\n          `Failed to complete tour step: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_reset')),\n    {\n      title: 'Reset Tour Progress',\n      description: 'Reset tour progress for the given user (defaults to the current actor).',\n      inputSchema: {\n        tourId: z.string().describe('Tour ID'),\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n      },\n    },\n    async ({ tourId, userId }) => {\n      try {\n        const auth = ctx.auth.read();\n        const resolvedUserId = userId ?? auth?.workspaceId;\n        if (!resolvedUserId) {\n          return errorResult(\n            'Unable to resolve user; pass userId or authenticate to a workspace first.',\n          );\n        }\n        const data = await ctx.gql.global.request<{ resetTourProgress: unknown }>(\n          RESET_TOUR_PROGRESS,\n          { tourId, userId: resolvedUserId },\n        );\n        return jsonResult(data.resetTourProgress);\n      } catch (error) {\n        ctx.logger.error('tours_progress_reset failed', { error: String(error) });\n        return errorResult(\n          `Failed to reset tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Tours module — product tours + per-user progress.\n *\n * Tools:\n *   <product>_tours_list\n *   <product>_tours_progress_{get,reset}\n *\n * Backend: ~/products/global/tours/global-tours-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerToursTools } from './tools.js';\n\nconst toursModule: McpModule = {\n  id: 'tours',\n  version: '0.0.1',\n  displayName: 'Tours',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n\n    registerToursTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default toursModule;\n"]}

package/dist/modules/tours/index.js

@@ -52,6 +52,20 @@ var RESET_TOUR_PROGRESS = `
     }
   }
 `;
+var COMPLETE_TOUR_STEP = `
+  mutation CompleteTourStep($tourId: ID!, $stepId: ID!, $userId: ID!) {
+    completeStep(tourId: $tourId, stepId: $stepId, userId: $userId) {
+      id
+      tourId
+      userId
+      status
+      currentStepId
+      currentStepOrder
+      completedSteps
+      lastViewedAt
+    }
+  }
+`;
 
 // src/modules/tours/tools.ts
 function registerToursTools(server, ctx, track) {
@@ -118,6 +132,35 @@ function registerToursTools(server, ctx, track) {
       }
     }
   );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_complete")),
+    {
+      title: "Complete Tour Step",
+      description: "Mark a tour step as completed for the given user. The user can only complete steps for themselves \u2014 the gateway rejects mismatched userId. Returns the updated UserTourProgress.",
+      inputSchema: {
+        tourId: z.string().describe("Tour ID"),
+        stepId: z.string().describe("Tour step ID"),
+        userId: z.string().describe(
+          "User ID to mark the step completed for (must match the authenticated actor at the gateway)"
+        )
+      }
+    },
+    async ({ tourId, stepId, userId }) => {
+      try {
+        const data = await ctx.gql.global.request(COMPLETE_TOUR_STEP, {
+          tourId,
+          stepId,
+          userId
+        });
+        return jsonResult(data.completeStep);
+      } catch (error) {
+        ctx.logger.error("tours_complete failed", { error: String(error) });
+        return errorResult(
+          `Failed to complete tour step: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
   server.registerTool(
     track(mcpToolName(ctx.productName, "tours_progress_reset")),
     {

package/dist/modules/tours/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/modules/tours/operations.ts","../../../src/modules/tours/tools.ts","../../../src/modules/tours/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const LIST_TOURS = `\n  query ListTours($filters: TourFilters, $pagination: TourPagination) {\n    tours(filters: $filters, pagination: $pagination) {\n      tours {\n        id\n        name\n        slug\n        description\n        status\n        isActive\n        productId\n        moduleId\n        priority\n        displayOrder\n        createdAt\n        updatedAt\n      }\n      total\n      hasMore\n    }\n  }\n`;\n\nexport const GET_USER_TOUR_PROGRESS = `\n  query GetUserTourProgress($userId: ID, $pagination: TourPagination) {\n    userTourProgresses(userId: $userId, pagination: $pagination) {\n      id\n      tourId\n      userId\n      status\n      currentStepId\n      currentStepOrder\n      completedSteps\n      skippedSteps\n      startedAt\n      completedAt\n      lastViewedAt\n    }\n  }\n`;\n\nexport const RESET_TOUR_PROGRESS = `\n  mutation ResetTourProgress($tourId: ID!, $userId: ID!) {\n    resetTourProgress(tourId: $tourId, userId: $userId) {\n      id\n      tourId\n      status\n      currentStepId\n      currentStepOrder\n    }\n  }\n`;\n","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport { LIST_TOURS, GET_USER_TOUR_PROGRESS, RESET_TOUR_PROGRESS } from './operations.js';\n\nexport function registerToursTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_list')),\n    {\n      title: 'List Tours',\n      description: 'List available product tours.',\n      inputSchema: {\n        productId: z.string().optional().describe('Filter by productId'),\n        moduleId: z.string().optional().describe('Filter by moduleId'),\n        status: z.string().optional().describe('Filter by status'),\n        isActive: z.boolean().optional().describe('Only active tours'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ productId, moduleId, status, isActive, limit, offset }) => {\n      try {\n        const filters: Record<string, unknown> = {};\n        if (productId !== undefined) filters.productId = productId;\n        if (moduleId !== undefined) filters.moduleId = moduleId;\n        if (status !== undefined) filters.status = status.toUpperCase();\n        if (isActive !== undefined) filters.isActive = isActive;\n        const data = await ctx.gql.global.request<{ tours: unknown }>(LIST_TOURS, {\n          filters: Object.keys(filters).length ? filters : undefined,\n          pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n        });\n        return jsonResult(data.tours);\n      } catch (error) {\n        ctx.logger.error('tours_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list tours: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_get')),\n    {\n      title: 'Get Tour Progress',\n      description: \"Get the current user's tour progress, optionally filtered by user id.\",\n      inputSchema: {\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ userId, limit, offset }) => {\n      try {\n        const data = await ctx.gql.global.request<{ userTourProgresses: unknown }>(\n          GET_USER_TOUR_PROGRESS,\n          {\n            userId,\n            pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n          },\n        );\n        return jsonResult(data.userTourProgresses);\n      } catch (error) {\n        ctx.logger.error('tours_progress_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_reset')),\n    {\n      title: 'Reset Tour Progress',\n      description: 'Reset tour progress for the given user (defaults to the current actor).',\n      inputSchema: {\n        tourId: z.string().describe('Tour ID'),\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n      },\n    },\n    async ({ tourId, userId }) => {\n      try {\n        const auth = ctx.auth.read();\n        const resolvedUserId = userId ?? auth?.workspaceId;\n        if (!resolvedUserId) {\n          return errorResult(\n            'Unable to resolve user; pass userId or authenticate to a workspace first.',\n          );\n        }\n        const data = await ctx.gql.global.request<{ resetTourProgress: unknown }>(\n          RESET_TOUR_PROGRESS,\n          { tourId, userId: resolvedUserId },\n        );\n        return jsonResult(data.resetTourProgress);\n      } catch (error) {\n        ctx.logger.error('tours_progress_reset failed', { error: String(error) });\n        return errorResult(\n          `Failed to reset tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Tours module — product tours + per-user progress.\n *\n * Tools:\n *   <product>_tours_list\n *   <product>_tours_progress_{get,reset}\n *\n * Backend: ~/products/global/tours/global-tours-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerToursTools } from './tools.js';\n\nconst toursModule: McpModule = {\n  id: 'tours',\n  version: '0.0.1',\n  displayName: 'Tours',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n\n    registerToursTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default toursModule;\n"]}
+{"version":3,"sources":["../../../src/modules/tours/operations.ts","../../../src/modules/tours/tools.ts","../../../src/modules/tours/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const LIST_TOURS = `\n  query ListTours($filters: TourFilters, $pagination: TourPagination) {\n    tours(filters: $filters, pagination: $pagination) {\n      tours {\n        id\n        name\n        slug\n        description\n        status\n        isActive\n        productId\n        moduleId\n        priority\n        displayOrder\n        createdAt\n        updatedAt\n      }\n      total\n      hasMore\n    }\n  }\n`;\n\nexport const GET_USER_TOUR_PROGRESS = `\n  query GetUserTourProgress($userId: ID, $pagination: TourPagination) {\n    userTourProgresses(userId: $userId, pagination: $pagination) {\n      id\n      tourId\n      userId\n      status\n      currentStepId\n      currentStepOrder\n      completedSteps\n      skippedSteps\n      startedAt\n      completedAt\n      lastViewedAt\n    }\n  }\n`;\n\nexport const RESET_TOUR_PROGRESS = `\n  mutation ResetTourProgress($tourId: ID!, $userId: ID!) {\n    resetTourProgress(tourId: $tourId, userId: $userId) {\n      id\n      tourId\n      status\n      currentStepId\n      currentStepOrder\n    }\n  }\n`;\n\nexport const COMPLETE_TOUR_STEP = `\n  mutation CompleteTourStep($tourId: ID!, $stepId: ID!, $userId: ID!) {\n    completeStep(tourId: $tourId, stepId: $stepId, userId: $userId) {\n      id\n      tourId\n      userId\n      status\n      currentStepId\n      currentStepOrder\n      completedSteps\n      lastViewedAt\n    }\n  }\n`;\n","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport {\n  LIST_TOURS,\n  GET_USER_TOUR_PROGRESS,\n  RESET_TOUR_PROGRESS,\n  COMPLETE_TOUR_STEP,\n} from './operations.js';\n\nexport function registerToursTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_list')),\n    {\n      title: 'List Tours',\n      description: 'List available product tours.',\n      inputSchema: {\n        productId: z.string().optional().describe('Filter by productId'),\n        moduleId: z.string().optional().describe('Filter by moduleId'),\n        status: z.string().optional().describe('Filter by status'),\n        isActive: z.boolean().optional().describe('Only active tours'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ productId, moduleId, status, isActive, limit, offset }) => {\n      try {\n        const filters: Record<string, unknown> = {};\n        if (productId !== undefined) filters.productId = productId;\n        if (moduleId !== undefined) filters.moduleId = moduleId;\n        if (status !== undefined) filters.status = status.toUpperCase();\n        if (isActive !== undefined) filters.isActive = isActive;\n        const data = await ctx.gql.global.request<{ tours: unknown }>(LIST_TOURS, {\n          filters: Object.keys(filters).length ? filters : undefined,\n          pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n        });\n        return jsonResult(data.tours);\n      } catch (error) {\n        ctx.logger.error('tours_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list tours: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_get')),\n    {\n      title: 'Get Tour Progress',\n      description: \"Get the current user's tour progress, optionally filtered by user id.\",\n      inputSchema: {\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Offset for pagination'),\n      },\n    },\n    async ({ userId, limit, offset }) => {\n      try {\n        const data = await ctx.gql.global.request<{ userTourProgresses: unknown }>(\n          GET_USER_TOUR_PROGRESS,\n          {\n            userId,\n            pagination: { limit: limit ?? 50, offset: offset ?? 0 },\n          },\n        );\n        return jsonResult(data.userTourProgresses);\n      } catch (error) {\n        ctx.logger.error('tours_progress_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_complete')),\n    {\n      title: 'Complete Tour Step',\n      description:\n        'Mark a tour step as completed for the given user. The user can only complete steps for themselves — the gateway rejects mismatched userId. Returns the updated UserTourProgress.',\n      inputSchema: {\n        tourId: z.string().describe('Tour ID'),\n        stepId: z.string().describe('Tour step ID'),\n        userId: z\n          .string()\n          .describe(\n            'User ID to mark the step completed for (must match the authenticated actor at the gateway)',\n          ),\n      },\n    },\n    async ({ tourId, stepId, userId }) => {\n      try {\n        const data = await ctx.gql.global.request<{ completeStep: unknown }>(COMPLETE_TOUR_STEP, {\n          tourId,\n          stepId,\n          userId,\n        });\n        return jsonResult(data.completeStep);\n      } catch (error) {\n        ctx.logger.error('tours_complete failed', { error: String(error) });\n        return errorResult(\n          `Failed to complete tour step: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'tours_progress_reset')),\n    {\n      title: 'Reset Tour Progress',\n      description: 'Reset tour progress for the given user (defaults to the current actor).',\n      inputSchema: {\n        tourId: z.string().describe('Tour ID'),\n        userId: z.string().optional().describe('User ID (defaults to current actor)'),\n      },\n    },\n    async ({ tourId, userId }) => {\n      try {\n        const auth = ctx.auth.read();\n        const resolvedUserId = userId ?? auth?.workspaceId;\n        if (!resolvedUserId) {\n          return errorResult(\n            'Unable to resolve user; pass userId or authenticate to a workspace first.',\n          );\n        }\n        const data = await ctx.gql.global.request<{ resetTourProgress: unknown }>(\n          RESET_TOUR_PROGRESS,\n          { tourId, userId: resolvedUserId },\n        );\n        return jsonResult(data.resetTourProgress);\n      } catch (error) {\n        ctx.logger.error('tours_progress_reset failed', { error: String(error) });\n        return errorResult(\n          `Failed to reset tour progress: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Tours module — product tours + per-user progress.\n *\n * Tools:\n *   <product>_tours_list\n *   <product>_tours_progress_{get,reset}\n *\n * Backend: ~/products/global/tours/global-tours-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerToursTools } from './tools.js';\n\nconst toursModule: McpModule = {\n  id: 'tours',\n  version: '0.0.1',\n  displayName: 'Tours',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n\n    registerToursTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default toursModule;\n"]}

package/dist/modules/vibecontrols/index.cjs

@@ -291,6 +291,11 @@ var RESTORE_VIBE = `
     restoreVibe(id: $id) { ${VIBE_FIELDS} }
   }
 `;
+var MOVE_VIBE = `
+  mutation MoveVibe($id: ID!, $newParentId: ID) {
+    moveVibe(id: $id, newParentId: $newParentId) { ${VIBE_FIELDS} }
+  }
+`;
 var UPDATE_VIBE_STATUS = `
   mutation UpdateVibeStatus($id: ID!, $status: VibeStatus!) {
     updateVibeStatus(id: $id, status: $status) { ${VIBE_FIELDS} }
@@ -306,6 +311,13 @@ var SEARCH_VIBES = `
     searchVibes(query: $query, limit: $limit) { ${VIBE_FIELDS} }
   }
 `;
+var UPDATE_VIBE_GIT = `
+  mutation UpdateVibeGit($id: ID!, $gitBranch: String, $gitRemote: String, $gitStatus: JSON) {
+    updateVibeGit(id: $id, gitBranch: $gitBranch, gitRemote: $gitRemote, gitStatus: $gitStatus) {
+      ${VIBE_FIELDS}
+    }
+  }
+`;
 var LIST_SESSIONS = `
   query Sessions($filter: SessionFilterInput, $pagination: PaginationInput) {
     sessions(filter: $filter, pagination: $pagination) {
@@ -384,6 +396,22 @@ var BULK_TERMINATE_SESSIONS = `
     bulkTerminateSessions(ids: $ids) { succeeded failed }
   }
 `;
+var UPDATE_SESSION = `
+  mutation UpdateSession($id: ID!, $input: UpdateSessionInput!) {
+    updateSession(id: $id, input: $input) { ${SESSION_FIELDS} }
+  }
+`;
+var UPDATE_SESSION_STATUS = `
+  mutation UpdateSessionStatus($id: ID!, $status: VibecontrolsSessionStatus!) {
+    updateSessionStatus(id: $id, status: $status) { ${SESSION_FIELDS} }
+  }
+`;
+var DELETE_SESSION = `
+  mutation DeleteSession($id: ID!) { deleteSession(id: $id) }
+`;
+var KILL_SESSION = `
+  mutation KillSession($id: ID!) { killSession(id: $id) }
+`;
 var SHARE_SESSION = `
   mutation ShareSession($input: ShareSessionInput!) {
     shareSession(input: $input) { ${SESSION_SHARE_FIELDS} }
@@ -2952,6 +2980,7 @@ function registerSessionSharingTools(server, ctx, track) {
     }
   );
 }
+var VibecontrolsSessionStatusEnum = zod.z.enum(["PENDING", "STARTING", "RUNNING", "STOPPED", "ERROR", "TERMINATED"]).describe("Lifecycle status of a vibecontrols session");
 function registerSessionTools(server, ctx, track) {
   server.registerTool(
     track(mcpToolName(ctx.productName, "sessions_list")),
@@ -3330,6 +3359,115 @@ function registerSessionTools(server, ctx, track) {
       }
     }
   );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "sessions_update")),
+    {
+      title: "Update Session",
+      description: "Update a terminal session. At least one mutable field (name / command / workingDirectory / autoStart / ttydUrl / metadata) must be provided. Returns the updated Session.",
+      inputSchema: {
+        id: zod.z.string().describe("Session ID"),
+        name: zod.z.string().optional().describe("Updated session name"),
+        command: zod.z.string().optional().describe("Updated command to run"),
+        workingDirectory: zod.z.string().optional().describe("Updated working directory"),
+        autoStart: zod.z.boolean().optional().describe("Whether the session should auto-start"),
+        ttydUrl: zod.z.string().optional().describe("Updated ttyd URL for browser-based access"),
+        metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Free-form JSON metadata to merge into the session")
+      }
+    },
+    async ({ id, name, command, workingDirectory, autoStart, ttydUrl, metadata }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (command !== void 0) input.command = command;
+        if (workingDirectory !== void 0) input.workingDirectory = workingDirectory;
+        if (autoStart !== void 0) input.autoStart = autoStart;
+        if (ttydUrl !== void 0) input.ttydUrl = ttydUrl;
+        if (metadata !== void 0) input.metadata = metadata;
+        if (Object.keys(input).length === 0) {
+          return errorResult(
+            "No updates specified \u2014 provide at least one of name/command/workingDirectory/autoStart/ttydUrl/metadata"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_SESSION, {
+          id,
+          input
+        });
+        return jsonResult(data.updateSession);
+      } catch (error) {
+        ctx.logger.error("vibecontrols_sessions_update failed", { error });
+        return errorResult(
+          `Failed to update session: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "sessions_update_status")),
+    {
+      title: "Update Session Status",
+      description: "Set the lifecycle status of a session directly (PENDING, STARTING, RUNNING, STOPPED, ERROR, TERMINATED). Returns the updated Session.",
+      inputSchema: {
+        id: zod.z.string().describe("Session ID"),
+        status: VibecontrolsSessionStatusEnum.describe("New status to apply")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          UPDATE_SESSION_STATUS,
+          { id, status }
+        );
+        return jsonResult(data.updateSessionStatus);
+      } catch (error) {
+        ctx.logger.error("vibecontrols_sessions_update_status failed", { error });
+        return errorResult(
+          `Failed to update session status: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "sessions_delete")),
+    {
+      title: "Delete Session",
+      description: "Permanently delete a terminal session. Distinct from terminate \u2014 this also removes the session record. Returns { deleted, sessionId }.",
+      inputSchema: { id: zod.z.string().describe("Session ID to delete") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(DELETE_SESSION, {
+          id
+        });
+        return jsonResult({ deleted: data.deleteSession, sessionId: id });
+      } catch (error) {
+        ctx.logger.error("vibecontrols_sessions_delete failed", { error });
+        return errorResult(
+          `Failed to delete session: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "sessions_kill")),
+    {
+      title: "Kill Session",
+      description: "Forcefully kill a session process (SIGKILL-equivalent). Use when terminate/stop have failed to release the underlying process. Returns { killed, sessionId }.",
+      inputSchema: { id: zod.z.string().describe("Session ID to kill") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(KILL_SESSION, {
+          id
+        });
+        return jsonResult({ killed: data.killSession, sessionId: id });
+      } catch (error) {
+        ctx.logger.error("vibecontrols_sessions_kill failed", { error });
+        return errorResult(
+          `Failed to kill session: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
 }
 function registerTargetTools(server, ctx, track) {
   server.registerTool(
@@ -4452,6 +4590,65 @@ function registerVibeTools(server, ctx, track) {
       }
     }
   );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vibes_move")),
+    {
+      title: "Move Vibe",
+      description: "Move a vibe under a different parent in the hierarchy. Pass `newParentId` = null (omit) to move to top-level. Returns the updated Vibe.",
+      inputSchema: {
+        id: zod.z.string().describe("Vibe ID to move"),
+        newParentId: zod.z.string().optional().describe("New parent vibe ID, or omit to move to the top level")
+      }
+    },
+    async ({ id, newParentId }) => {
+      try {
+        const data = await ctx.gql.workspace.request(MOVE_VIBE, {
+          id,
+          newParentId: newParentId ?? null
+        });
+        return jsonResult(data.moveVibe);
+      } catch (error) {
+        ctx.logger.error("vibecontrols_vibes_move failed", { error });
+        return errorResult(
+          `Failed to move vibe: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "vibes_update_git")),
+    {
+      title: "Update Vibe Git Metadata",
+      description: "Update the git-related metadata on a vibe (branch / remote URL / structured status JSON). At least one field must be provided. Returns the updated Vibe.",
+      inputSchema: {
+        id: zod.z.string().describe("Vibe ID"),
+        gitBranch: zod.z.string().optional().describe("Updated git branch name"),
+        gitRemote: zod.z.string().optional().describe("Updated git remote URL"),
+        gitStatus: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Structured git status JSON (e.g. dirty/ahead/behind counters)")
+      }
+    },
+    async ({ id, gitBranch, gitRemote, gitStatus }) => {
+      try {
+        if (gitBranch === void 0 && gitRemote === void 0 && gitStatus === void 0) {
+          return errorResult(
+            "No git updates specified \u2014 provide at least one of gitBranch/gitRemote/gitStatus"
+          );
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_VIBE_GIT, {
+          id,
+          gitBranch: gitBranch ?? null,
+          gitRemote: gitRemote ?? null,
+          gitStatus: gitStatus ?? null
+        });
+        return jsonResult(data.updateVibeGit);
+      } catch (error) {
+        ctx.logger.error("vibecontrols_vibes_update_git failed", { error });
+        return errorResult(
+          `Failed to update vibe git metadata: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
 }
 function registerWebhookTools(server, ctx, track) {
   server.registerTool(