@burdenoff/mcp-libs 2026.511.1

package/dist/modules/store/index.cjs

@@ -0,0 +1,450 @@
+'use strict';
+
+var zod = require('zod');
+require('graphql-request');
+require('cross-fetch');
+require('@modelcontextprotocol/sdk/server/mcp.js');
+require('@modelcontextprotocol/sdk/types.js');
+
+// src/modules/store/tools.ts
+
+// src/core/errors.ts
+var McpInternalError = class extends Error {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "McpInternalError";
+    this.cause = cause;
+  }
+};
+
+// src/core/result.ts
+function jsonResult(data, structured) {
+  const result = {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+  return result;
+}
+function errorResult(message, hint) {
+  const text = hint ? `${message}
+
+Hint: ${hint}` : message;
+  return { content: [{ type: "text", text }], isError: true };
+}
+
+// src/core/tool-name.ts
+var MAX_TOOL_NAME_LENGTH = 63;
+function assertSafeName(name, kind) {
+  if (name.length > MAX_TOOL_NAME_LENGTH) {
+    throw new McpInternalError(
+      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`
+    );
+  }
+  return name;
+}
+function mcpToolName(productName, ...parts) {
+  if (!productName) {
+    throw new McpInternalError("mcpToolName: productName is required");
+  }
+  const name = [productName, ...parts].filter(Boolean).join("_");
+  return assertSafeName(name);
+}
+
+// src/modules/store/operations.ts
+var BROWSE_STORE = `
+  query BrowseStore($input: BrowseStoreInput!) {
+    browseStore(input: $input) {
+      products { id name description price currency type status }
+      facets { categories types }
+      totalCount hasMore
+    }
+  }
+`;
+var SEARCH_STORE = `
+  query SearchStore($query: String!, $filters: StoreFiltersInput) {
+    searchStore(query: $query, filters: $filters) {
+      id name price currency type activeInstallCount
+    }
+  }
+`;
+var GET_STORE_PRODUCT = `
+  query GetStoreProduct($id: ID!) {
+    getProduct(id: $id) {
+      id name description price currency type status
+      publisher { name }
+    }
+  }
+`;
+var MY_CART = `
+  query MyCart {
+    myCart {
+      id currency subtotal total itemCount isEmpty
+      items { id productId quantity }
+    }
+  }
+`;
+var ADD_TO_CART = `
+  mutation AddToCart($input: AddToCartInput!) {
+    addToCart(input: $input) {
+      id itemCount subtotal items { productId quantity }
+    }
+  }
+`;
+var REMOVE_FROM_CART = `
+  mutation RemoveFromCart($cartId: ID!, $itemId: ID!) {
+    removeFromCart(cartId: $cartId, itemId: $itemId) {
+      id itemCount subtotal
+    }
+  }
+`;
+var CHECKOUT_CART = `
+  mutation CheckoutCart($cartId: ID!) {
+    checkoutCart(cartId: $cartId) {
+      success order { id total status }
+    }
+  }
+`;
+var GET_ORDERS = `
+  query GetOrders($limit: Int, $offset: Int) {
+    getOrders(limit: $limit, offset: $offset) {
+      id status total currency createdAt
+    }
+  }
+`;
+var GET_ORDER = `
+  query GetOrder($id: ID!) {
+    getOrder(id: $id) {
+      id status total currency paidAt billingAccountId
+      lineItems { productId quantity unitPrice }
+    }
+  }
+`;
+var GET_INSTALLED_PRODUCTS = `
+  query GetInstalledProducts($workspaceId: ID!) {
+    getInstalledProducts(workspaceId: $workspaceId) {
+      id application { id name } status installedAt lastUsedAt
+    }
+  }
+`;
+var UNINSTALL_PRODUCT = `
+  mutation UninstallProduct($installationId: ID!) {
+    uninstallProduct(installationId: $installationId) { success }
+  }
+`;
+var GET_LICENSES = `
+  query GetLicenses($entitlementId: ID!) {
+    getLicenses(entitlementId: $entitlementId) {
+      id status validFrom expiresAt
+    }
+  }
+`;
+
+// src/modules/store/tools.ts
+function resolveWorkspaceId(ctx, override) {
+  if (override !== void 0 && override !== "") return override;
+  const auth = ctx.auth.read();
+  if (!auth?.workspaceId) return null;
+  return auth.workspaceId;
+}
+function registerStoreTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_search")),
+    {
+      title: "Search Store",
+      description: "Search the marketplace for products by query and optional filters.",
+      inputSchema: {
+        query: zod.z.string().describe("Search query"),
+        type: zod.z.string().optional().describe("Product type filter"),
+        category: zod.z.string().optional().describe("Category filter")
+      }
+    },
+    async ({ query, type, category }) => {
+      try {
+        const filters = {};
+        if (type !== void 0) filters.productType = type.toUpperCase();
+        if (category !== void 0) filters.category = category;
+        const data = await ctx.gql.global.request(SEARCH_STORE, {
+          query,
+          filters: Object.keys(filters).length ? filters : void 0
+        });
+        return jsonResult(data.searchStore);
+      } catch (error) {
+        ctx.logger.error("store_search failed", { error: String(error) });
+        return errorResult(
+          `Failed to search store: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_browse")),
+    {
+      title: "Browse Store",
+      description: "Browse the marketplace with structured input (categories, facets, paging).",
+      inputSchema: {
+        category: zod.z.string().optional().describe("Category filter"),
+        type: zod.z.string().optional().describe("Product type filter"),
+        limit: zod.z.number().optional().describe("Page size"),
+        offset: zod.z.number().optional().describe("Skip results")
+      }
+    },
+    async ({ category, type, limit, offset }) => {
+      try {
+        const input = {};
+        if (category !== void 0) input.category = category;
+        if (type !== void 0) input.productType = type.toUpperCase();
+        if (limit !== void 0) input.limit = limit;
+        if (offset !== void 0) input.offset = offset;
+        const data = await ctx.gql.global.request(BROWSE_STORE, { input });
+        return jsonResult(data.browseStore);
+      } catch (error) {
+        ctx.logger.error("store_browse failed", { error: String(error) });
+        return errorResult(
+          `Failed to browse store: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_get_product")),
+    {
+      title: "Get Store Product",
+      description: "Get a marketplace product by ID.",
+      inputSchema: { id: zod.z.string().describe("Product ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.global.request(
+          GET_STORE_PRODUCT,
+          { id }
+        );
+        if (!data.getProduct) return errorResult(`Product ${id} not found`);
+        return jsonResult(data.getProduct);
+      } catch (error) {
+        ctx.logger.error("store_get_product failed", { error: String(error) });
+        return errorResult(
+          `Failed to get product: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_cart_list")),
+    {
+      title: "Show Cart",
+      description: "Show the current user's cart.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.global.request(MY_CART);
+        return jsonResult(data.myCart);
+      } catch (error) {
+        ctx.logger.error("store_cart_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to fetch cart: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_cart_add")),
+    {
+      title: "Add to Cart",
+      description: "Add a product (and optional variant) to the cart.",
+      inputSchema: {
+        product: zod.z.string().describe("Product ID"),
+        quantity: zod.z.number().optional().describe("Quantity (default 1)"),
+        variant: zod.z.string().optional().describe("Variant ID")
+      }
+    },
+    async ({ product, quantity, variant }) => {
+      try {
+        const input = { productId: product };
+        if (quantity !== void 0) input.quantity = quantity;
+        if (variant !== void 0) input.variantId = variant;
+        const data = await ctx.gql.global.request(ADD_TO_CART, { input });
+        return jsonResult(data.addToCart);
+      } catch (error) {
+        ctx.logger.error("store_cart_add failed", { error: String(error) });
+        return errorResult(
+          `Failed to add to cart: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_cart_remove")),
+    {
+      title: "Remove from Cart",
+      description: "Remove an item from the cart.",
+      inputSchema: {
+        cart: zod.z.string().describe("Cart ID"),
+        item: zod.z.string().describe("Cart item ID")
+      }
+    },
+    async ({ cart, item }) => {
+      try {
+        await ctx.gql.global.request(REMOVE_FROM_CART, { cartId: cart, itemId: item });
+        return jsonResult({ status: "success", message: "Item removed from cart", cart, item });
+      } catch (error) {
+        ctx.logger.error("store_cart_remove failed", { error: String(error) });
+        return errorResult(
+          `Failed to remove cart item: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_cart_checkout")),
+    {
+      title: "Checkout Cart",
+      description: "Check out the cart server-side (uses default payment method on the billing account).",
+      inputSchema: { cartId: zod.z.string().describe("Cart ID") }
+    },
+    async ({ cartId }) => {
+      try {
+        const data = await ctx.gql.global.request(CHECKOUT_CART, { cartId });
+        return jsonResult(data.checkoutCart);
+      } catch (error) {
+        ctx.logger.error("store_cart_checkout failed", { error: String(error) });
+        return errorResult(
+          `Failed to checkout cart: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_orders_list")),
+    {
+      title: "List Orders",
+      description: "List orders for the current user.",
+      inputSchema: {
+        limit: zod.z.number().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().optional().describe("Skip results (default 0)")
+      }
+    },
+    async ({ limit, offset }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_ORDERS, {
+          limit,
+          offset: offset ?? 0
+        });
+        return jsonResult(data.getOrders);
+      } catch (error) {
+        ctx.logger.error("store_orders_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list orders: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_orders_get")),
+    {
+      title: "Get Order",
+      description: "Get an order by ID.",
+      inputSchema: { id: zod.z.string().describe("Order ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_ORDER, { id });
+        if (!data.getOrder) return errorResult(`Order ${id} not found`);
+        return jsonResult(data.getOrder);
+      } catch (error) {
+        ctx.logger.error("store_orders_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get order: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_installed_list")),
+    {
+      title: "List Installed Products",
+      description: "List installed products in the current (or specified) workspace.",
+      inputSchema: {
+        workspace: zod.z.string().optional().describe("Workspace ID (defaults to current)")
+      }
+    },
+    async ({ workspace }) => {
+      try {
+        const wid = resolveWorkspaceId(ctx, workspace);
+        if (!wid) {
+          return errorResult(
+            "No active workspace. Bind a workspace via the auth login flow first."
+          );
+        }
+        const data = await ctx.gql.global.request(GET_INSTALLED_PRODUCTS, { workspaceId: wid });
+        return jsonResult(data.getInstalledProducts);
+      } catch (error) {
+        ctx.logger.error("store_installed_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list installed products: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_installed_uninstall")),
+    {
+      title: "Uninstall Product",
+      description: "Uninstall a product by installation ID.",
+      inputSchema: { installationId: zod.z.string().describe("Installation ID") }
+    },
+    async ({ installationId }) => {
+      try {
+        await ctx.gql.global.request(UNINSTALL_PRODUCT, { installationId });
+        return jsonResult({ status: "success", message: "Product uninstalled", installationId });
+      } catch (error) {
+        ctx.logger.error("store_installed_uninstall failed", { error: String(error) });
+        return errorResult(
+          `Failed to uninstall product: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "store_licenses_list")),
+    {
+      title: "List Licenses",
+      description: "List licenses for an entitlement.",
+      inputSchema: { entitlement: zod.z.string().describe("Entitlement ID") }
+    },
+    async ({ entitlement }) => {
+      try {
+        const data = await ctx.gql.global.request(GET_LICENSES, { entitlementId: entitlement });
+        return jsonResult(data.getLicenses);
+      } catch (error) {
+        ctx.logger.error("store_licenses_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list licenses: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/store/index.ts
+var storeModule = {
+  id: "store",
+  version: "0.0.1",
+  displayName: "Store",
+  dependsOn: ["auth"],
+  capabilities: { tools: {} },
+  register(server, ctx) {
+    const tools = [];
+    const track = (n) => {
+      tools.push(n);
+      return n;
+    };
+    registerStoreTools(server, ctx, track);
+    return { tools, resources: [], prompts: [] };
+  }
+};
+var store_default = storeModule;
+
+module.exports = store_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/result.ts","../../../src/core/tool-name.ts","../../../src/modules/store/operations.ts","../../../src/modules/store/tools.ts","../../../src/modules/store/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 BROWSE_STORE = `\n  query BrowseStore($input: BrowseStoreInput!) {\n    browseStore(input: $input) {\n      products { id name description price currency type status }\n      facets { categories types }\n      totalCount hasMore\n    }\n  }\n`;\n\nexport const SEARCH_STORE = `\n  query SearchStore($query: String!, $filters: StoreFiltersInput) {\n    searchStore(query: $query, filters: $filters) {\n      id name price currency type activeInstallCount\n    }\n  }\n`;\n\nexport const GET_STORE_PRODUCT = `\n  query GetStoreProduct($id: ID!) {\n    getProduct(id: $id) {\n      id name description price currency type status\n      publisher { name }\n    }\n  }\n`;\n\nexport const MY_CART = `\n  query MyCart {\n    myCart {\n      id currency subtotal total itemCount isEmpty\n      items { id productId quantity }\n    }\n  }\n`;\n\nexport const ADD_TO_CART = `\n  mutation AddToCart($input: AddToCartInput!) {\n    addToCart(input: $input) {\n      id itemCount subtotal items { productId quantity }\n    }\n  }\n`;\n\nexport const REMOVE_FROM_CART = `\n  mutation RemoveFromCart($cartId: ID!, $itemId: ID!) {\n    removeFromCart(cartId: $cartId, itemId: $itemId) {\n      id itemCount subtotal\n    }\n  }\n`;\n\nexport const CHECKOUT_CART = `\n  mutation CheckoutCart($cartId: ID!) {\n    checkoutCart(cartId: $cartId) {\n      success order { id total status }\n    }\n  }\n`;\n\nexport const GET_ORDERS = `\n  query GetOrders($limit: Int, $offset: Int) {\n    getOrders(limit: $limit, offset: $offset) {\n      id status total currency createdAt\n    }\n  }\n`;\n\nexport const GET_ORDER = `\n  query GetOrder($id: ID!) {\n    getOrder(id: $id) {\n      id status total currency paidAt billingAccountId\n      lineItems { productId quantity unitPrice }\n    }\n  }\n`;\n\nexport const GET_INSTALLED_PRODUCTS = `\n  query GetInstalledProducts($workspaceId: ID!) {\n    getInstalledProducts(workspaceId: $workspaceId) {\n      id application { id name } status installedAt lastUsedAt\n    }\n  }\n`;\n\nexport const UNINSTALL_PRODUCT = `\n  mutation UninstallProduct($installationId: ID!) {\n    uninstallProduct(installationId: $installationId) { success }\n  }\n`;\n\nexport const GET_LICENSES = `\n  query GetLicenses($entitlementId: ID!) {\n    getLicenses(entitlementId: $entitlementId) {\n      id status validFrom expiresAt\n    }\n  }\n`;\n","/**\n * Store module tools — marketplace search, cart, orders, installed apps,\n * licenses. Backend: ~/products/global/store/global-store-svc/.\n * Ported from cli-sdk/src/modules/store/.\n *\n * Note: store_cart_checkout completes the cart server-side (no browser\n * redirect). Provider-bound payment capture (Stripe checkout pages) is not\n * exposed in cli-sdk and is omitted here.\n */\n\nimport { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport {\n  BROWSE_STORE,\n  SEARCH_STORE,\n  GET_STORE_PRODUCT,\n  MY_CART,\n  ADD_TO_CART,\n  REMOVE_FROM_CART,\n  CHECKOUT_CART,\n  GET_ORDERS,\n  GET_ORDER,\n  GET_INSTALLED_PRODUCTS,\n  UNINSTALL_PRODUCT,\n  GET_LICENSES,\n} from './operations.js';\n\ninterface StoreProduct {\n  id: string;\n  name: string;\n  price?: number;\n  currency?: string;\n  type?: string;\n  status?: string;\n}\n\ninterface CartRow {\n  id: string;\n  itemCount?: number;\n  subtotal?: number;\n  total?: number;\n  currency?: string;\n  isEmpty?: boolean;\n  items?: Array<{ id: string; productId: string; quantity: number }>;\n}\n\ninterface OrderRow {\n  id: string;\n  status?: string;\n  total?: number;\n  currency?: string;\n  createdAt?: string;\n}\n\nfunction resolveWorkspaceId(ctx: McpContext, override: string | undefined): string | null {\n  if (override !== undefined && override !== '') return override;\n  const auth = ctx.auth.read();\n  if (!auth?.workspaceId) return null;\n  return auth.workspaceId;\n}\n\nexport function registerStoreTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  // ── Search / browse / get ──────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_search')),\n    {\n      title: 'Search Store',\n      description: 'Search the marketplace for products by query and optional filters.',\n      inputSchema: {\n        query: z.string().describe('Search query'),\n        type: z.string().optional().describe('Product type filter'),\n        category: z.string().optional().describe('Category filter'),\n      },\n    },\n    async ({ query, type, category }) => {\n      try {\n        const filters: Record<string, unknown> = {};\n        if (type !== undefined) filters.productType = type.toUpperCase();\n        if (category !== undefined) filters.category = category;\n        const data = await ctx.gql.global.request<{ searchStore: StoreProduct[] }>(SEARCH_STORE, {\n          query,\n          filters: Object.keys(filters).length ? filters : undefined,\n        });\n        return jsonResult(data.searchStore);\n      } catch (error) {\n        ctx.logger.error('store_search failed', { error: String(error) });\n        return errorResult(\n          `Failed to search store: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_browse')),\n    {\n      title: 'Browse Store',\n      description: 'Browse the marketplace with structured input (categories, facets, paging).',\n      inputSchema: {\n        category: z.string().optional().describe('Category filter'),\n        type: z.string().optional().describe('Product type filter'),\n        limit: z.number().optional().describe('Page size'),\n        offset: z.number().optional().describe('Skip results'),\n      },\n    },\n    async ({ category, type, limit, offset }) => {\n      try {\n        const input: Record<string, unknown> = {};\n        if (category !== undefined) input.category = category;\n        if (type !== undefined) input.productType = type.toUpperCase();\n        if (limit !== undefined) input.limit = limit;\n        if (offset !== undefined) input.offset = offset;\n        const data = await ctx.gql.global.request<{\n          browseStore: {\n            products: StoreProduct[];\n            facets: { categories: string[]; types: string[] };\n            totalCount: number;\n            hasMore: boolean;\n          };\n        }>(BROWSE_STORE, { input });\n        return jsonResult(data.browseStore);\n      } catch (error) {\n        ctx.logger.error('store_browse failed', { error: String(error) });\n        return errorResult(\n          `Failed to browse store: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_get_product')),\n    {\n      title: 'Get Store Product',\n      description: 'Get a marketplace product by ID.',\n      inputSchema: { id: z.string().describe('Product ID') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.global.request<{ getProduct: StoreProduct | null }>(\n          GET_STORE_PRODUCT,\n          { id },\n        );\n        if (!data.getProduct) return errorResult(`Product ${id} not found`);\n        return jsonResult(data.getProduct);\n      } catch (error) {\n        ctx.logger.error('store_get_product failed', { error: String(error) });\n        return errorResult(\n          `Failed to get product: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── Cart ───────────────────────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_cart_list')),\n    {\n      title: 'Show Cart',\n      description: \"Show the current user's cart.\",\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const data = await ctx.gql.global.request<{ myCart: CartRow }>(MY_CART);\n        return jsonResult(data.myCart);\n      } catch (error) {\n        ctx.logger.error('store_cart_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to fetch cart: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_cart_add')),\n    {\n      title: 'Add to Cart',\n      description: 'Add a product (and optional variant) to the cart.',\n      inputSchema: {\n        product: z.string().describe('Product ID'),\n        quantity: z.number().optional().describe('Quantity (default 1)'),\n        variant: z.string().optional().describe('Variant ID'),\n      },\n    },\n    async ({ product, quantity, variant }) => {\n      try {\n        const input: Record<string, unknown> = { productId: product };\n        if (quantity !== undefined) input.quantity = quantity;\n        if (variant !== undefined) input.variantId = variant;\n        const data = await ctx.gql.global.request<{ addToCart: CartRow }>(ADD_TO_CART, { input });\n        return jsonResult(data.addToCart);\n      } catch (error) {\n        ctx.logger.error('store_cart_add failed', { error: String(error) });\n        return errorResult(\n          `Failed to add to cart: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_cart_remove')),\n    {\n      title: 'Remove from Cart',\n      description: 'Remove an item from the cart.',\n      inputSchema: {\n        cart: z.string().describe('Cart ID'),\n        item: z.string().describe('Cart item ID'),\n      },\n    },\n    async ({ cart, item }) => {\n      try {\n        await ctx.gql.global.request(REMOVE_FROM_CART, { cartId: cart, itemId: item });\n        return jsonResult({ status: 'success', message: 'Item removed from cart', cart, item });\n      } catch (error) {\n        ctx.logger.error('store_cart_remove failed', { error: String(error) });\n        return errorResult(\n          `Failed to remove cart item: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_cart_checkout')),\n    {\n      title: 'Checkout Cart',\n      description:\n        'Check out the cart server-side (uses default payment method on the billing account).',\n      inputSchema: { cartId: z.string().describe('Cart ID') },\n    },\n    async ({ cartId }) => {\n      try {\n        const data = await ctx.gql.global.request<{\n          checkoutCart: { success: boolean; order?: OrderRow };\n        }>(CHECKOUT_CART, { cartId });\n        return jsonResult(data.checkoutCart);\n      } catch (error) {\n        ctx.logger.error('store_cart_checkout failed', { error: String(error) });\n        return errorResult(\n          `Failed to checkout cart: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── Orders ─────────────────────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_orders_list')),\n    {\n      title: 'List Orders',\n      description: 'List orders for the current user.',\n      inputSchema: {\n        limit: z.number().optional().describe('Page size (default 50)'),\n        offset: z.number().optional().describe('Skip results (default 0)'),\n      },\n    },\n    async ({ limit, offset }) => {\n      try {\n        const data = await ctx.gql.global.request<{ getOrders: OrderRow[] }>(GET_ORDERS, {\n          limit,\n          offset: offset ?? 0,\n        });\n        return jsonResult(data.getOrders);\n      } catch (error) {\n        ctx.logger.error('store_orders_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list orders: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_orders_get')),\n    {\n      title: 'Get Order',\n      description: 'Get an order by ID.',\n      inputSchema: { id: z.string().describe('Order ID') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.global.request<{ getOrder: OrderRow | null }>(GET_ORDER, { id });\n        if (!data.getOrder) return errorResult(`Order ${id} not found`);\n        return jsonResult(data.getOrder);\n      } catch (error) {\n        ctx.logger.error('store_orders_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get order: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── Installed ──────────────────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_installed_list')),\n    {\n      title: 'List Installed Products',\n      description: 'List installed products in the current (or specified) workspace.',\n      inputSchema: {\n        workspace: z.string().optional().describe('Workspace ID (defaults to current)'),\n      },\n    },\n    async ({ workspace }) => {\n      try {\n        const wid = resolveWorkspaceId(ctx, workspace);\n        if (!wid) {\n          return errorResult(\n            'No active workspace. Bind a workspace via the auth login flow first.',\n          );\n        }\n        const data = await ctx.gql.global.request<{\n          getInstalledProducts: Array<{\n            id: string;\n            application: { id: string; name: string };\n            status: string;\n            installedAt: string;\n          }>;\n        }>(GET_INSTALLED_PRODUCTS, { workspaceId: wid });\n        return jsonResult(data.getInstalledProducts);\n      } catch (error) {\n        ctx.logger.error('store_installed_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list installed products: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_installed_uninstall')),\n    {\n      title: 'Uninstall Product',\n      description: 'Uninstall a product by installation ID.',\n      inputSchema: { installationId: z.string().describe('Installation ID') },\n    },\n    async ({ installationId }) => {\n      try {\n        await ctx.gql.global.request(UNINSTALL_PRODUCT, { installationId });\n        return jsonResult({ status: 'success', message: 'Product uninstalled', installationId });\n      } catch (error) {\n        ctx.logger.error('store_installed_uninstall failed', { error: String(error) });\n        return errorResult(\n          `Failed to uninstall product: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── Licenses ───────────────────────────────────────────────────────────\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'store_licenses_list')),\n    {\n      title: 'List Licenses',\n      description: 'List licenses for an entitlement.',\n      inputSchema: { entitlement: z.string().describe('Entitlement ID') },\n    },\n    async ({ entitlement }) => {\n      try {\n        const data = await ctx.gql.global.request<{\n          getLicenses: Array<{ id: string; status: string; validFrom: string; expiresAt: string }>;\n        }>(GET_LICENSES, { entitlementId: entitlement });\n        return jsonResult(data.getLicenses);\n      } catch (error) {\n        ctx.logger.error('store_licenses_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list licenses: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Store module — marketplace search/browse, cart, orders, installed apps,\n * licenses. Backend: ~/products/global/store/global-store-svc/.\n * Ported from cli-sdk/src/modules/store/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerStoreTools } from './tools.js';\n\nconst storeModule: McpModule = {\n  id: 'store',\n  version: '0.0.1',\n  displayName: 'Store',\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    registerStoreTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default storeModule;\n"]}

package/dist/modules/store/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 storeModule: McpModule;
+
+export { storeModule as default };

package/dist/modules/store/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 storeModule: McpModule;
+
+export { storeModule as default };