@burdenoff/mcp-libs 2026.511.1

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

@@ -0,0 +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"]}

package/dist/modules/tours/index.d.cts

@@ -0,0 +1,8 @@
+import { c as McpModule } from '../../module-DFQBZNK6.cjs';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+import '../../context-1jV4NsLv.cjs';
+import 'graphql-request';
+
+declare const toursModule: McpModule;
+
+export { toursModule as default };

package/dist/modules/tours/index.d.ts

@@ -0,0 +1,8 @@
+import { c as McpModule } from '../../module-DBcfA-i3.js';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+import '../../context-1jV4NsLv.js';
+import 'graphql-request';
+
+declare const toursModule: McpModule;
+
+export { toursModule as default };

package/dist/modules/tours/index.js

@@ -0,0 +1,176 @@
+import { mcpToolName, jsonResult, errorResult } from '../../chunk-H2OYWLOA.js';
+import { z } from 'zod';
+
+// src/modules/tours/operations.ts
+var LIST_TOURS = `
+  query ListTours($filters: TourFilters, $pagination: TourPagination) {
+    tours(filters: $filters, pagination: $pagination) {
+      tours {
+        id
+        name
+        slug
+        description
+        status
+        isActive
+        productId
+        moduleId
+        priority
+        displayOrder
+        createdAt
+        updatedAt
+      }
+      total
+      hasMore
+    }
+  }
+`;
+var GET_USER_TOUR_PROGRESS = `
+  query GetUserTourProgress($userId: ID, $pagination: TourPagination) {
+    userTourProgresses(userId: $userId, pagination: $pagination) {
+      id
+      tourId
+      userId
+      status
+      currentStepId
+      currentStepOrder
+      completedSteps
+      skippedSteps
+      startedAt
+      completedAt
+      lastViewedAt
+    }
+  }
+`;
+var RESET_TOUR_PROGRESS = `
+  mutation ResetTourProgress($tourId: ID!, $userId: ID!) {
+    resetTourProgress(tourId: $tourId, userId: $userId) {
+      id
+      tourId
+      status
+      currentStepId
+      currentStepOrder
+    }
+  }
+`;
+
+// src/modules/tours/tools.ts
+function registerToursTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_list")),
+    {
+      title: "List Tours",
+      description: "List available product tours.",
+      inputSchema: {
+        productId: z.string().optional().describe("Filter by productId"),
+        moduleId: z.string().optional().describe("Filter by moduleId"),
+        status: z.string().optional().describe("Filter by status"),
+        isActive: z.boolean().optional().describe("Only active tours"),
+        limit: z.number().optional().describe("Page size"),
+        offset: z.number().optional().describe("Offset for pagination")
+      }
+    },
+    async ({ productId, moduleId, status, isActive, limit, offset }) => {
+      try {
+        const filters = {};
+        if (productId !== void 0) filters.productId = productId;
+        if (moduleId !== void 0) filters.moduleId = moduleId;
+        if (status !== void 0) filters.status = status.toUpperCase();
+        if (isActive !== void 0) filters.isActive = isActive;
+        const data = await ctx.gql.global.request(LIST_TOURS, {
+          filters: Object.keys(filters).length ? filters : void 0,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.tours);
+      } catch (error) {
+        ctx.logger.error("tours_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list tours: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_progress_get")),
+    {
+      title: "Get Tour Progress",
+      description: "Get the current user's tour progress, optionally filtered by user id.",
+      inputSchema: {
+        userId: z.string().optional().describe("User ID (defaults to current actor)"),
+        limit: z.number().optional().describe("Page size"),
+        offset: z.number().optional().describe("Offset for pagination")
+      }
+    },
+    async ({ userId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.global.request(
+          GET_USER_TOUR_PROGRESS,
+          {
+            userId,
+            pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+          }
+        );
+        return jsonResult(data.userTourProgresses);
+      } catch (error) {
+        ctx.logger.error("tours_progress_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get tour progress: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "tours_progress_reset")),
+    {
+      title: "Reset Tour Progress",
+      description: "Reset tour progress for the given user (defaults to the current actor).",
+      inputSchema: {
+        tourId: z.string().describe("Tour ID"),
+        userId: z.string().optional().describe("User ID (defaults to current actor)")
+      }
+    },
+    async ({ tourId, userId }) => {
+      try {
+        const auth = ctx.auth.read();
+        const resolvedUserId = userId ?? auth?.workspaceId;
+        if (!resolvedUserId) {
+          return errorResult(
+            "Unable to resolve user; pass userId or authenticate to a workspace first."
+          );
+        }
+        const data = await ctx.gql.global.request(
+          RESET_TOUR_PROGRESS,
+          { tourId, userId: resolvedUserId }
+        );
+        return jsonResult(data.resetTourProgress);
+      } catch (error) {
+        ctx.logger.error("tours_progress_reset failed", { error: String(error) });
+        return errorResult(
+          `Failed to reset tour progress: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/tours/index.ts
+var toursModule = {
+  id: "tours",
+  version: "0.0.1",
+  displayName: "Tours",
+  dependsOn: ["auth"],
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const tools = [];
+    const track = (n) => {
+      tools.push(n);
+      return n;
+    };
+    registerToursTools(server, ctx, track);
+    return { tools, resources: [], prompts: [] };
+  }
+};
+var tours_default = toursModule;
+
+export { tours_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"]}