@burdenoff/mcp-libs 2026.1014.4 → 2026.1026.1

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

@@ -1,8 +1,3 @@
-import { c as McpModule } from '../../module-VpgjAf8m.js';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import '../../context-DGO4h-Pd.js';
-import 'graphql-request';
-
+import type { McpModule } from '../../core/index.js';
 declare const subscriberbotModule: McpModule;
-
-export { subscriberbotModule as default };
+export default subscriberbotModule;

package/dist/modules/subscriberbot/index.js

@@ -1,4 +1,4 @@
-import { mcpToolName, errorResult, jsonResult, mcpResourceUri, mcpPromptName } from '../../chunk-G76DKEPI.js';
+import { mcpToolName, errorResult, jsonResult, mcpResourceUri, mcpPromptName } from '../../chunk-FHXCNP2U.js';
 import { z } from 'zod';
 
 // src/modules/subscriberbot/operations.ts

package/dist/modules/subscriberbot/operations.d.ts

@@ -0,0 +1,53 @@
+export declare const PROVIDER_FIELDS = "\n  id name slug description category status industry region language\n  logoFileId websiteUrl tags churnRiskScore vendorHealthScore\n  workspaceId createdAt updatedAt\n";
+export declare const PLAN_FIELDS = "\n  id name description amount currency interval features isActive\n  providerId workspaceId createdAt updatedAt\n";
+export declare const ENTITLEMENT_FIELDS = "\n  id name description type quota used unit isActive\n  relationshipId workspaceId createdAt updatedAt\n";
+export declare const ASSET_FIELDS = "\n  id name type secretRef expiresAt relationshipId workspaceId\n  createdAt updatedAt file { id }\n";
+export declare const RENEWAL_EVENT_FIELDS = "\n  id eventType detail amount currency occursAt notified\n  relationshipId workspaceId createdAt updatedAt\n";
+export declare const RELATIONSHIP_FIELDS = "\n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n";
+export declare const PAYMENT_INSTRUMENT_FIELDS = "\n  id label type status brand last4 expiryMonth expiryYear isDefault\n  ownerId workspaceId createdAt updatedAt\n";
+export declare const INVOICE_FIELDS = "\n  id number status currency subtotal taxAmount total issueDate dueDate\n  paidAt lineItems paymentInstrumentId relationshipId workspaceId\n  createdAt updatedAt file { id }\n";
+export declare const CHANNEL_FIELDS = "\n  id type status address label ingestEnabled verifiedAt\n  ownerId workspaceId createdAt updatedAt\n";
+export declare const INBOX_MESSAGE_FIELDS = "\n  id subject preview category categoryConfidence actionRequired isRead\n  externalId receivedAt channelId relationshipId workspaceId\n  createdAt updatedAt\n";
+export declare const AGENT_FIELDS = "\n  id name description kind status config lastRunAt\n  ownerId workspaceId createdAt updatedAt\n";
+export declare const POLICY_FIELDS = "\n  id name description action condition isEnabled triggerCount\n  lastTriggeredAt agentId workspaceId createdAt updatedAt\n";
+export declare const WORKFLOW_FIELDS = "\n  id name description status triggerEvent steps runCount lastRunAt\n  workspaceId createdAt updatedAt\n";
+export declare const GET_PROVIDER = "\n  query SubscriberbotGetProvider($id: ID!) {\n    subProvider(id: $id) {\n      \n  id name slug description category status industry region language\n  logoFileId websiteUrl tags churnRiskScore vendorHealthScore\n  workspaceId createdAt updatedAt\n\n      plans { \n  id name description amount currency interval features isActive\n  providerId workspaceId createdAt updatedAt\n }\n    }\n  }\n";
+export declare const LIST_PROVIDERS = "\n  query SubscriberbotListProviders(\n    $category: SubProviderCategory\n    $status: SubProviderStatus\n    $search: String\n    $pagination: PaginationInput\n  ) {\n    subListProviders(\n      category: $category\n      status: $status\n      search: $search\n      pagination: $pagination\n    ) {\n      items { \n  id name slug description category status industry region language\n  logoFileId websiteUrl tags churnRiskScore vendorHealthScore\n  workspaceId createdAt updatedAt\n }\n      pageInfo { cursor hasMore }\n    }\n  }\n";
+export declare const CREATE_PROVIDER = "\n  mutation SubscriberbotCreateProvider($input: SubCreateProviderInput!) {\n    subCreateProvider(input: $input) {\n      \n  id name slug description category status industry region language\n  logoFileId websiteUrl tags churnRiskScore vendorHealthScore\n  workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const UPDATE_PROVIDER = "\n  mutation SubscriberbotUpdateProvider($id: ID!, $input: SubUpdateProviderInput!) {\n    subUpdateProvider(id: $id, input: $input) {\n      \n  id name slug description category status industry region language\n  logoFileId websiteUrl tags churnRiskScore vendorHealthScore\n  workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const ARCHIVE_PROVIDER = "\n  mutation SubscriberbotArchiveProvider($id: ID!) {\n    subArchiveProvider(id: $id)\n  }\n";
+export declare const LIST_PLANS = "\n  query SubscriberbotListPlans($providerId: ID) {\n    subListPlans(providerId: $providerId) {\n      \n  id name description amount currency interval features isActive\n  providerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_PLAN = "\n  mutation SubscriberbotCreatePlan($input: SubCreatePlanInput!) {\n    subCreatePlan(input: $input) {\n      \n  id name description amount currency interval features isActive\n  providerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const GET_RELATIONSHIP = "\n  query SubscriberbotGetRelationship($id: ID!) {\n    subRelationship(id: $id) {\n      \n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n\n      provider { id name slug category status }\n      plan { id name amount currency interval }\n      entitlements { \n  id name description type quota used unit isActive\n  relationshipId workspaceId createdAt updatedAt\n }\n      assets { \n  id name type secretRef expiresAt relationshipId workspaceId\n  createdAt updatedAt file { id }\n }\n      renewalEvents { \n  id eventType detail amount currency occursAt notified\n  relationshipId workspaceId createdAt updatedAt\n }\n    }\n  }\n";
+export declare const LIST_RELATIONSHIPS = "\n  query SubscriberbotListRelationships(\n    $kind: SubRelationshipKind\n    $status: SubRelationshipStatus\n    $ownerId: ID\n    $providerId: ID\n    $pagination: PaginationInput\n  ) {\n    subListRelationships(\n      kind: $kind\n      status: $status\n      ownerId: $ownerId\n      providerId: $providerId\n      pagination: $pagination\n    ) {\n      items { \n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n }\n      pageInfo { cursor hasMore }\n    }\n  }\n";
+export declare const CREATE_RELATIONSHIP = "\n  mutation SubscriberbotCreateRelationship($input: SubCreateRelationshipInput!) {\n    subCreateRelationship(input: $input) {\n      \n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const UPDATE_RELATIONSHIP = "\n  mutation SubscriberbotUpdateRelationship($id: ID!, $input: SubUpdateRelationshipInput!) {\n    subUpdateRelationship(id: $id, input: $input) {\n      \n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CANCEL_RELATIONSHIP = "\n  mutation SubscriberbotCancelRelationship($id: ID!) {\n    subCancelRelationship(id: $id) {\n      \n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const TRANSITION_RELATIONSHIP = "\n  mutation SubscriberbotTransitionRelationship($id: ID!, $status: SubRelationshipStatus!) {\n    subTransitionRelationship(id: $id, status: $status) {\n      \n  id label kind status amount currency interval autoRenew discoverySource\n  healthScore notes tags providerId planId ownerId startedAt renewsAt\n  trialEndsAt cancelledAt workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const LIST_ENTITLEMENTS = "\n  query SubscriberbotListEntitlements($relationshipId: ID!) {\n    subListEntitlements(relationshipId: $relationshipId) {\n      \n  id name description type quota used unit isActive\n  relationshipId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_ENTITLEMENT = "\n  mutation SubscriberbotCreateEntitlement($input: SubCreateEntitlementInput!) {\n    subCreateEntitlement(input: $input) {\n      \n  id name description type quota used unit isActive\n  relationshipId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const LIST_ASSETS = "\n  query SubscriberbotListAssets($relationshipId: ID!) {\n    subListAssets(relationshipId: $relationshipId) {\n      \n  id name type secretRef expiresAt relationshipId workspaceId\n  createdAt updatedAt file { id }\n\n    }\n  }\n";
+export declare const CREATE_ASSET = "\n  mutation SubscriberbotCreateAsset($input: SubCreateAssetInput!) {\n    subCreateAsset(input: $input) {\n      \n  id name type secretRef expiresAt relationshipId workspaceId\n  createdAt updatedAt file { id }\n\n    }\n  }\n";
+export declare const LIST_RENEWAL_EVENTS = "\n  query SubscriberbotListRenewalEvents($relationshipId: ID, $upcomingOnly: Boolean) {\n    subListRenewalEvents(relationshipId: $relationshipId, upcomingOnly: $upcomingOnly) {\n      \n  id eventType detail amount currency occursAt notified\n  relationshipId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const LIST_PAYMENT_INSTRUMENTS = "\n  query SubscriberbotListPaymentInstruments($ownerId: ID) {\n    subListPaymentInstruments(ownerId: $ownerId) {\n      \n  id label type status brand last4 expiryMonth expiryYear isDefault\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_PAYMENT_INSTRUMENT = "\n  mutation SubscriberbotCreatePaymentInstrument($input: SubCreatePaymentInstrumentInput!) {\n    subCreatePaymentInstrument(input: $input) {\n      \n  id label type status brand last4 expiryMonth expiryYear isDefault\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const REMOVE_PAYMENT_INSTRUMENT = "\n  mutation SubscriberbotRemovePaymentInstrument($id: ID!) {\n    subRemovePaymentInstrument(id: $id)\n  }\n";
+export declare const LIST_INVOICES = "\n  query SubscriberbotListInvoices(\n    $relationshipId: ID\n    $status: SubInvoiceStatus\n    $pagination: PaginationInput\n  ) {\n    subListInvoices(relationshipId: $relationshipId, status: $status, pagination: $pagination) {\n      items { \n  id number status currency subtotal taxAmount total issueDate dueDate\n  paidAt lineItems paymentInstrumentId relationshipId workspaceId\n  createdAt updatedAt file { id }\n }\n      pageInfo { cursor hasMore }\n    }\n  }\n";
+export declare const CREATE_INVOICE = "\n  mutation SubscriberbotCreateInvoice($input: SubCreateInvoiceInput!) {\n    subCreateInvoice(input: $input) {\n      \n  id number status currency subtotal taxAmount total issueDate dueDate\n  paidAt lineItems paymentInstrumentId relationshipId workspaceId\n  createdAt updatedAt file { id }\n\n    }\n  }\n";
+export declare const MARK_INVOICE_PAID = "\n  mutation SubscriberbotMarkInvoicePaid($id: ID!) {\n    subMarkInvoicePaid(id: $id) {\n      \n  id number status currency subtotal taxAmount total issueDate dueDate\n  paidAt lineItems paymentInstrumentId relationshipId workspaceId\n  createdAt updatedAt file { id }\n\n    }\n  }\n";
+export declare const LIST_CHANNELS = "\n  query SubscriberbotListChannels($ownerId: ID) {\n    subListChannels(ownerId: $ownerId) {\n      \n  id type status address label ingestEnabled verifiedAt\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_CHANNEL = "\n  mutation SubscriberbotCreateChannel($input: SubCreateChannelInput!) {\n    subCreateChannel(input: $input) {\n      \n  id type status address label ingestEnabled verifiedAt\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const VERIFY_CHANNEL = "\n  mutation SubscriberbotVerifyChannel($id: ID!) {\n    subVerifyChannel(id: $id) {\n      \n  id type status address label ingestEnabled verifiedAt\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const LIST_INBOX_MESSAGES = "\n  query SubscriberbotListInboxMessages(\n    $category: SubMessageCategory\n    $channelId: ID\n    $relationshipId: ID\n    $unreadOnly: Boolean\n    $pagination: PaginationInput\n  ) {\n    subListInboxMessages(\n      category: $category\n      channelId: $channelId\n      relationshipId: $relationshipId\n      unreadOnly: $unreadOnly\n      pagination: $pagination\n    ) {\n      items { \n  id subject preview category categoryConfidence actionRequired isRead\n  externalId receivedAt channelId relationshipId workspaceId\n  createdAt updatedAt\n }\n      pageInfo { cursor hasMore }\n    }\n  }\n";
+export declare const INGEST_MESSAGE = "\n  mutation SubscriberbotIngestMessage($input: SubIngestMessageInput!) {\n    subIngestMessage(input: $input) {\n      \n  id subject preview category categoryConfidence actionRequired isRead\n  externalId receivedAt channelId relationshipId workspaceId\n  createdAt updatedAt\n\n    }\n  }\n";
+export declare const MARK_MESSAGE_READ = "\n  mutation SubscriberbotMarkMessageRead($id: ID!) {\n    subMarkMessageRead(id: $id) {\n      \n  id subject preview category categoryConfidence actionRequired isRead\n  externalId receivedAt channelId relationshipId workspaceId\n  createdAt updatedAt\n\n    }\n  }\n";
+export declare const GET_AGENT = "\n  query SubscriberbotGetAgent($id: ID!) {\n    subAgent(id: $id) {\n      \n  id name description kind status config lastRunAt\n  ownerId workspaceId createdAt updatedAt\n\n      policies { \n  id name description action condition isEnabled triggerCount\n  lastTriggeredAt agentId workspaceId createdAt updatedAt\n }\n    }\n  }\n";
+export declare const LIST_AGENTS = "\n  query SubscriberbotListAgents($kind: SubAgentKind, $ownerId: ID, $status: SubAgentStatus) {\n    subListAgents(kind: $kind, ownerId: $ownerId, status: $status) {\n      \n  id name description kind status config lastRunAt\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_AGENT = "\n  mutation SubscriberbotCreateAgent($input: SubCreateAgentInput!) {\n    subCreateAgent(input: $input) {\n      \n  id name description kind status config lastRunAt\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const SET_AGENT_STATUS = "\n  mutation SubscriberbotSetAgentStatus($id: ID!, $status: SubAgentStatus!) {\n    subSetAgentStatus(id: $id, status: $status) {\n      \n  id name description kind status config lastRunAt\n  ownerId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const LIST_POLICIES = "\n  query SubscriberbotListPolicies($agentId: ID) {\n    subListPolicies(agentId: $agentId) {\n      \n  id name description action condition isEnabled triggerCount\n  lastTriggeredAt agentId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_POLICY = "\n  mutation SubscriberbotCreatePolicy($input: SubCreatePolicyInput!) {\n    subCreatePolicy(input: $input) {\n      \n  id name description action condition isEnabled triggerCount\n  lastTriggeredAt agentId workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const LIST_WORKFLOWS = "\n  query SubscriberbotListWorkflows($status: SubWorkflowStatus) {\n    subListWorkflows(status: $status) {\n      \n  id name description status triggerEvent steps runCount lastRunAt\n  workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const CREATE_WORKFLOW = "\n  mutation SubscriberbotCreateWorkflow($input: SubCreateWorkflowInput!) {\n    subCreateWorkflow(input: $input) {\n      \n  id name description status triggerEvent steps runCount lastRunAt\n  workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const ACTIVATE_WORKFLOW = "\n  mutation SubscriberbotActivateWorkflow($id: ID!) {\n    subActivateWorkflow(id: $id) {\n      \n  id name description status triggerEvent steps runCount lastRunAt\n  workspaceId createdAt updatedAt\n\n    }\n  }\n";
+export declare const HEALTH = "\n  query SubscriberbotHealth {\n    subHealth\n  }\n";

package/dist/modules/subscriberbot/prompts.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../core/index.js';
+export declare function registerSubscriberbotPrompts(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/resources.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../core/index.js';
+export declare function registerSubscriberbotResources(server: McpServer, ctx: McpContext, track: (uri: string) => string): void;

package/dist/modules/subscriberbot/tools/agents.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerAgentTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/assets.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerAssetTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/channels.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerChannelTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/entitlements.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerEntitlementTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/health.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerHealthTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/inbox.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerInboxTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/invoices.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerInvoiceTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/payment-instruments.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerPaymentInstrumentTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/plans.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerPlanTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/policies.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerPolicyTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/providers.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerProviderTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/relationships.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerRelationshipTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/renewals.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerRenewalTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

package/dist/modules/subscriberbot/tools/shared.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const SubAgentKindEnum: z.ZodEnum<["COMPLIANCE", "CONCIERGE", "COST", "DISCOVERY", "MIGRATION", "NEGOTIATION", "NEWSLETTER", "RENEWAL", "VENDOR"]>;
+export declare const SubAgentStatusEnum: z.ZodEnum<["AUTONOMOUS", "DISABLED", "SUGGEST_ONLY"]>;
+export declare const SubAssetTypeEnum: z.ZodEnum<["CERTIFICATE", "CONTRACT", "CREDENTIAL", "DOMAIN", "INVOICE", "LICENSE_KEY", "RECEIPT", "WARRANTY"]>;
+export declare const SubBillingIntervalEnum: z.ZodEnum<["DAILY", "FREE", "LIFETIME", "MONTHLY", "QUARTERLY", "USAGE_BASED", "WEEKLY", "YEARLY"]>;
+export declare const SubChannelStatusEnum: z.ZodEnum<["DISABLED", "PENDING", "VERIFIED"]>;
+export declare const SubChannelTypeEnum: z.ZodEnum<["DISCORD", "EMAIL", "PUSH", "SLACK", "SMS", "WEBHOOK", "WHATSAPP"]>;
+export declare const SubDiscoverySourceEnum: z.ZodEnum<["AI_AGENT", "EMAIL_SCAN", "IMPORT", "MANUAL", "PAYMENT_SCAN", "PROVIDER_CONNECT"]>;
+export declare const SubEntitlementTypeEnum: z.ZodEnum<["CONTENT", "DISCOUNT", "FEATURE_ACCESS", "SEAT", "SUPPORT_TIER", "USAGE_QUOTA"]>;
+export declare const SubInvoiceStatusEnum: z.ZodEnum<["CANCELLED", "DRAFT", "FAILED", "ISSUED", "OVERDUE", "PAID", "REFUNDED"]>;
+export declare const SubMessageCategoryEnum: z.ZodEnum<["BILLING", "MARKETING", "OTHER", "PRODUCT_UPDATE", "RENEWAL", "REQUIRED_ACTION", "SECURITY_ALERT"]>;
+export declare const SubPaymentInstrumentStatusEnum: z.ZodEnum<["ACTIVE", "EXPIRED", "EXPIRING", "REMOVED"]>;
+export declare const SubPaymentInstrumentTypeEnum: z.ZodEnum<["BANK_ACCOUNT", "CARD", "OTHER", "PAYPAL", "UPI", "WALLET"]>;
+export declare const SubPolicyActionEnum: z.ZodEnum<["ALERT", "CANCEL", "CREATE_TASK", "DOWNGRADE", "PAUSE", "RENEW", "UPGRADE"]>;
+export declare const SubProviderCategoryEnum: z.ZodEnum<["AI_SERVICE", "ASSOCIATION", "COMMUNITY", "CONTRACT", "EDUCATION", "FINANCIAL", "INSURANCE", "LICENSE", "MEMBERSHIP", "NEWSLETTER", "NEWS_DIGEST", "OTHER", "SAAS", "STREAMING", "TELECOM", "UTILITY"]>;
+export declare const SubProviderStatusEnum: z.ZodEnum<["CLAIMED", "DEPRECATED", "UNVERIFIED", "VERIFIED"]>;
+export declare const SubRelationshipKindEnum: z.ZodEnum<["CONTRACT", "ENROLLMENT", "LICENSE", "MEMBERSHIP", "NEWSLETTER", "RECURRING_PAYMENT", "SUBSCRIPTION", "TRIAL"]>;
+export declare const SubRelationshipStatusEnum: z.ZodEnum<["ACTIVE", "CANCELLED", "EXPIRED", "LAPSED", "PAST_DUE", "PAUSED", "TRIAL"]>;
+export declare const SubWorkflowStatusEnum: z.ZodEnum<["ACTIVE", "ARCHIVED", "DRAFT", "PAUSED"]>;
+export declare const JsonObject: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const JsonValue: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">]>;

package/dist/modules/subscriberbot/tools/workflows.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../../core/index.js';
+export declare function registerWorkflowTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/tool-name.ts","../../../src/core/result.ts","../../../src/modules/support/operations.ts","../../../src/modules/support/tools.ts","../../../src/modules/support/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 * 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\n/**\n * Name-based hint heuristics for MCP `annotations` (readOnlyHint /\n * destructiveHint). Used by tool-governance.ts to auto-fill annotations for\n * the fleet of product modules that call `server.registerTool` directly\n * (bypassing the `registerTool()` core helper) and so never set them\n * explicitly today (BOFF-3903). Deliberately conservative — matched against\n * whole `_`-delimited segments so e.g. `timeentries_delete` and\n * `pomodoro_delete_goal` match, but a hypothetical `undeletable_check`\n * would not.\n *\n * A module can always override the inference by passing an explicit\n * `annotations` object to `registerTool()` / `server.registerTool()`.\n */\nconst DESTRUCTIVE_NAME_SEGMENT = /(?:^|_)delete(?:_|$)/i;\nconst READ_ONLY_NAME_SEGMENT = /(?:^|_)(?:list|get|search|check|read|count|stats|by_date)(?:_|$)/i;\n\n/** True when a tool name looks destructive (irreversibly deletes data) by naming convention. */\nexport function inferDestructiveHint(toolName: string): boolean {\n  return DESTRUCTIVE_NAME_SEGMENT.test(toolName);\n}\n\n/**\n * True when a tool name looks read-only by naming convention. Never true for\n * a name that also looks destructive (a tool can't be both).\n */\nexport function inferReadOnlyHint(toolName: string): boolean {\n  return !inferDestructiveHint(toolName) && READ_ONLY_NAME_SEGMENT.test(toolName);\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';\nimport type { ToolAnnotations } from './tool-governance.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   * Explicit MCP annotations (readOnlyHint / destructiveHint / ...). Optional\n   * — when omitted, `wrapServerWithToolGovernance` (applied centrally in\n   * `createMcpServer`) infers them from the tool name. Set this to override\n   * the inference for a tool whose name doesn't match the naming convention.\n   */\n  annotations?: ToolAnnotations;\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    ...(metadata.annotations ? { annotations: metadata.annotations } : {}),\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 } } | 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","// Live `supportTickets` on alpha takes no args and returns\n// `SupportTicketConnection { nodes { ... } }` (no `edges`, no\n// `items`, no `totalCount`, no `workspaceId` arg — workspace context\n// is taken from `x-workspace-id`). Same as PR #23's workspaces\n// endpoint behavior: the legacy `(filter, limit, offset)` shape\n// is gone.\n//\n// BOFF-8218: `closeSupportTicket(id: ID!)` on alpha requires the\n// ticket to be in `RESOLVED` state first — directly closing an open\n// ticket returns \"Ticket must be resolved before it can be closed\".\n// The MCP tool `support_tickets_close` chains a server-side\n// `resolveSupportTicket` call first, then closes. If a future alpha\n// release changes the requirement, this op chain can be simplified.\nexport const LIST_SUPPORT_TICKETS = `\n  query ListSupportTickets {\n    supportTickets {\n      nodes { id ticketNumber subject status priority category createdAt }\n    }\n  }\n`;\n\nexport const GET_SUPPORT_TICKET = `\n  query GetSupportTicket($id: ID!) {\n    supportTicket(id: $id) {\n      id ticketNumber subject description status priority category createdAt\n      messages { id message createdAt isInternal }\n    }\n  }\n`;\n\nexport const CREATE_SUPPORT_TICKET = `\n  mutation CreateSupportTicket($input: CreateSupportTicketInput!) {\n    createSupportTicket(input: $input) {\n      id ticketNumber status priority\n    }\n  }\n`;\n\nexport const CREATE_SUPPORT_MESSAGE = `\n  mutation CreateSupportMessage($input: CreateSupportMessageInput!) {\n    createSupportMessage(input: $input) {\n      id message createdAt isInternal\n    }\n  }\n`;\n\n// Close a support ticket. BOFF-8218: alpha requires the ticket to be\n// in `RESOLVED` status first; the MCP tool performs the resolve step\n// before the close (see support/tools.ts) so the caller doesn't have\n// to know about the state-machine requirement.\nexport const CLOSE_SUPPORT_TICKET = `\n  mutation CloseSupportTicket($id: ID!) {\n    closeSupportTicket(id: $id) {\n      id status closedAt\n    }\n  }\n`;\n\n// Pre-close state transition: resolve an open ticket. The MCP\n// `support_tickets_close` tool calls this first; exposed here for\n// callers that want to surface a \"resolved\" ticket without closing.\nexport const RESOLVE_SUPPORT_TICKET = `\n  mutation ResolveSupportTicket($id: ID!) {\n    resolveSupportTicket(id: $id) {\n      id status resolvedAt\n    }\n  }\n`;\n\nexport const SEARCH_KNOWLEDGE_BASE = `\n  query SearchKnowledgeBase($query: String!, $limit: Int, $offset: Int) {\n    searchKnowledgeBase(query: $query, limit: $limit, offset: $offset) {\n      id title slug helpfulnessScore\n    }\n  }\n`;\n","/**\n * Support MCP tools — support tickets + knowledge base.\n * Surface mirrors cli-sdk/src/modules/support/commands.ts.\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 * as ops from './operations.js';\n\ninterface TicketRow {\n  id: string;\n  ticketNumber?: string;\n  subject?: string;\n  description?: string;\n  status?: string;\n  priority?: string;\n  category?: string;\n  createdAt?: string;\n  closedAt?: string;\n}\n\ninterface KbArticle {\n  id: string;\n  title: string;\n  slug: string;\n  helpfulnessScore: number;\n}\n\nexport function registerSupportTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_list')),\n    {\n      title: 'List Support Tickets',\n      description:\n        'List support tickets. Live `supportTickets` takes no args (workspace context from `x-workspace-id`); the legacy `(filter, limit, offset)` shape is gone and `status` / `priority` filtering is not yet exposed.',\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const data = await ctx.gql.global.request<{\n          supportTickets: { nodes: TicketRow[] };\n        }>(ops.LIST_SUPPORT_TICKETS);\n        return jsonResult(data.supportTickets);\n      } catch (error) {\n        ctx.logger.error('support_tickets_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list support tickets: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_get')),\n    {\n      title: 'Get Support Ticket',\n      description: 'Get a support ticket by ID, including messages.',\n      inputSchema: { id: z.string().describe('Ticket ID') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.global.request<{ supportTicket: TicketRow | null }>(\n          ops.GET_SUPPORT_TICKET,\n          { id },\n        );\n        if (!data.supportTicket) return errorResult(`Ticket ${id} not found`);\n        return jsonResult(data.supportTicket);\n      } catch (error) {\n        ctx.logger.error('support_tickets_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get support ticket: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_create')),\n    {\n      title: 'Create Support Ticket',\n      description: 'Open a support ticket.',\n      inputSchema: {\n        subject: z.string().describe('Ticket subject'),\n        description: z.string().describe('Ticket description'),\n        priority: z.string().optional().describe('LOW|NORMAL|HIGH|URGENT (default NORMAL)'),\n        category: z\n          .string()\n          .optional()\n          .describe('TECHNICAL_SUPPORT|BILLING|FEATURE_REQUEST|OTHER (default TECHNICAL_SUPPORT)'),\n      },\n    },\n    async ({ subject, description, priority, category }) => {\n      try {\n        const input: Record<string, unknown> = {\n          subject,\n          description,\n          priority: (priority ?? 'NORMAL').toUpperCase(),\n          category: (category ?? 'TECHNICAL_SUPPORT').toUpperCase(),\n        };\n        const data = await ctx.gql.global.request<{ createSupportTicket: TicketRow }>(\n          ops.CREATE_SUPPORT_TICKET,\n          { input },\n        );\n        return jsonResult(data.createSupportTicket);\n      } catch (error) {\n        ctx.logger.error('support_tickets_create failed', { error: String(error) });\n        return errorResult(\n          `Failed to create support ticket: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_comment')),\n    {\n      title: 'Add Support Ticket Comment',\n      description: 'Add a comment to a support ticket.',\n      inputSchema: {\n        ticketId: z.string().describe('Ticket ID'),\n        message: z.string().describe('Comment message'),\n        internal: z.boolean().optional().describe('Internal staff-only comment (default false)'),\n      },\n    },\n    async ({ ticketId, message, internal }) => {\n      try {\n        const input: Record<string, unknown> = {\n          ticketId,\n          message,\n          isInternal: internal === true,\n        };\n        const data = await ctx.gql.global.request<{\n          createSupportMessage: {\n            id: string;\n            message: string;\n            createdAt: string;\n            isInternal: boolean;\n          };\n        }>(ops.CREATE_SUPPORT_MESSAGE, { input });\n        return jsonResult(data.createSupportMessage);\n      } catch (error) {\n        ctx.logger.error('support_tickets_comment failed', { error: String(error) });\n        return errorResult(\n          `Failed to add support ticket comment: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // BOFF-8218: live `closeSupportTicket` requires the ticket to be in\n  // `RESOLVED` state first. To keep the user-facing surface simple\n  // (one call closes a ticket), the tool first calls\n  // `resolveSupportTicket(id)` (which is a no-op for already-resolved\n  // tickets) and then `closeSupportTicket(id)`. If the close still\n  // fails (e.g. the ticket is in a non-OPEN/RESOLVED state), the\n  // tool surfaces the underlying alpha error.\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_close')),\n    {\n      title: 'Close Support Ticket',\n      description:\n        \"Close a support ticket. Live alpha requires the ticket to be RESOLVED first; the tool performs the resolve step before close, so callers don't need to track the state machine.\",\n      inputSchema: { id: z.string().describe('Ticket ID') },\n    },\n    async ({ id }) => {\n      try {\n        // 1. Resolve (idempotent for already-resolved tickets; the\n        //    runtime error \"Ticket not in a resolvable state\" is OK\n        //    here because the close call will surface the real reason\n        //    if the ticket is in an unsupportable state).\n        await ctx.gql.global\n          .request<{ resolveSupportTicket: { id: string; status: string } | null }>(\n            ops.RESOLVE_SUPPORT_TICKET,\n            { id },\n          )\n          .catch(() => null);\n        // 2. Close.\n        const data = await ctx.gql.global.request<{ closeSupportTicket: TicketRow }>(\n          ops.CLOSE_SUPPORT_TICKET,\n          { id },\n        );\n        return jsonResult(data.closeSupportTicket);\n      } catch (error) {\n        ctx.logger.error('support_tickets_close failed', { error: String(error) });\n        return errorResult(\n          `Failed to close support ticket: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_kb_search')),\n    {\n      title: 'Search Knowledge Base',\n      description: 'Search knowledge base articles.',\n      inputSchema: {\n        query: z.string().describe('Search query'),\n        limit: z.number().optional().describe('Page size (default 20)'),\n      },\n    },\n    async ({ query, limit }) => {\n      try {\n        const data = await ctx.gql.global.request<{ searchKnowledgeBase: KbArticle[] }>(\n          ops.SEARCH_KNOWLEDGE_BASE,\n          { query, limit: limit ?? 20, offset: 0 },\n        );\n        return jsonResult(data.searchKnowledgeBase);\n      } catch (error) {\n        ctx.logger.error('support_kb_search failed', { error: String(error) });\n        return errorResult(\n          `Failed to search knowledge base: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Support module — support tickets CRUD + comments + close + KB search.\n * Surface mirrors cli-sdk/src/modules/support/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerSupportTools } from './tools.js';\n\nconst supportModule: McpModule = {\n  id: 'support',\n  version: '0.0.1',\n  displayName: 'Support',\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    registerSupportTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default supportModule;\n"]}
+{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/tool-name.ts","../../../src/core/result.ts","../../../src/modules/support/operations.ts","../../../src/modules/support/tools.ts","../../../src/modules/support/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 * 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\n/**\n * Name-based hint heuristics for MCP `annotations` (readOnlyHint /\n * destructiveHint). Used by tool-governance.ts to auto-fill annotations for\n * the fleet of product modules that call `server.registerTool` directly\n * (bypassing the `registerTool()` core helper) and so never set them\n * explicitly today (BOFF-3903). Deliberately conservative — matched against\n * whole `_`-delimited segments so e.g. `timeentries_delete` and\n * `pomodoro_delete_goal` match, but a hypothetical `undeletable_check`\n * would not.\n *\n * The destructive verb set covers more than `delete`: stopping, killing or\n * terminating a running process, revoking or rotating a credential/share,\n * resetting settings and removing/purging/uninstalling are all actions an\n * MCP client must not auto-run without the user's intent (VC/FG parity G57 —\n * e.g. `vibecontrols_sessions_kill`, `vibecontrols_tunnels_rotate_credentials`\n * were previously reported as non-destructive).\n *\n * A module can always override the inference by passing an explicit\n * `annotations` object to `registerTool()` / `server.registerTool()` — do\n * that for the rare verb match that is harmless (e.g. a typing indicator's\n * `typing_stop`).\n */\nexport const DESTRUCTIVE_NAME_VERBS = [\n  'delete',\n  'destroy',\n  'erase',\n  'kill',\n  'purge',\n  'remove',\n  'reset',\n  'revoke',\n  'rotate',\n  'stop',\n  'terminate',\n  'uninstall',\n  'wipe',\n] as const;\nconst DESTRUCTIVE_NAME_SEGMENT = new RegExp(\n  `(?:^|_)(?:${DESTRUCTIVE_NAME_VERBS.join('|')})(?:_|$)`,\n  'i',\n);\nconst READ_ONLY_NAME_SEGMENT = /(?:^|_)(?:list|get|search|check|read|count|stats|by_date)(?:_|$)/i;\n\n/** True when a tool name looks destructive (irreversibly deletes data) by naming convention. */\nexport function inferDestructiveHint(toolName: string): boolean {\n  return DESTRUCTIVE_NAME_SEGMENT.test(toolName);\n}\n\n/**\n * True when a tool name looks read-only by naming convention. Never true for\n * a name that also looks destructive (a tool can't be both).\n */\nexport function inferReadOnlyHint(toolName: string): boolean {\n  return !inferDestructiveHint(toolName) && READ_ONLY_NAME_SEGMENT.test(toolName);\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';\nimport type { ToolAnnotations } from './tool-governance.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   * Explicit MCP annotations (readOnlyHint / destructiveHint / ...). Optional\n   * — when omitted, `wrapServerWithToolGovernance` (applied centrally in\n   * `createMcpServer`) infers them from the tool name. Set this to override\n   * the inference for a tool whose name doesn't match the naming convention.\n   */\n  annotations?: ToolAnnotations;\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    ...(metadata.annotations ? { annotations: metadata.annotations } : {}),\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 } } | 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","// Live `supportTickets` on alpha takes no args and returns\n// `SupportTicketConnection { nodes { ... } }` (no `edges`, no\n// `items`, no `totalCount`, no `workspaceId` arg — workspace context\n// is taken from `x-workspace-id`). Same as PR #23's workspaces\n// endpoint behavior: the legacy `(filter, limit, offset)` shape\n// is gone.\n//\n// BOFF-8218: `closeSupportTicket(id: ID!)` on alpha requires the\n// ticket to be in `RESOLVED` state first — directly closing an open\n// ticket returns \"Ticket must be resolved before it can be closed\".\n// The MCP tool `support_tickets_close` chains a server-side\n// `resolveSupportTicket` call first, then closes. If a future alpha\n// release changes the requirement, this op chain can be simplified.\nexport const LIST_SUPPORT_TICKETS = `\n  query ListSupportTickets {\n    supportTickets {\n      nodes { id ticketNumber subject status priority category createdAt }\n    }\n  }\n`;\n\nexport const GET_SUPPORT_TICKET = `\n  query GetSupportTicket($id: ID!) {\n    supportTicket(id: $id) {\n      id ticketNumber subject description status priority category createdAt\n      messages { id message createdAt isInternal }\n    }\n  }\n`;\n\nexport const CREATE_SUPPORT_TICKET = `\n  mutation CreateSupportTicket($input: CreateSupportTicketInput!) {\n    createSupportTicket(input: $input) {\n      id ticketNumber status priority\n    }\n  }\n`;\n\nexport const CREATE_SUPPORT_MESSAGE = `\n  mutation CreateSupportMessage($input: CreateSupportMessageInput!) {\n    createSupportMessage(input: $input) {\n      id message createdAt isInternal\n    }\n  }\n`;\n\n// Close a support ticket. BOFF-8218: alpha requires the ticket to be\n// in `RESOLVED` status first; the MCP tool performs the resolve step\n// before the close (see support/tools.ts) so the caller doesn't have\n// to know about the state-machine requirement.\nexport const CLOSE_SUPPORT_TICKET = `\n  mutation CloseSupportTicket($id: ID!) {\n    closeSupportTicket(id: $id) {\n      id status closedAt\n    }\n  }\n`;\n\n// Pre-close state transition: resolve an open ticket. The MCP\n// `support_tickets_close` tool calls this first; exposed here for\n// callers that want to surface a \"resolved\" ticket without closing.\nexport const RESOLVE_SUPPORT_TICKET = `\n  mutation ResolveSupportTicket($id: ID!) {\n    resolveSupportTicket(id: $id) {\n      id status resolvedAt\n    }\n  }\n`;\n\nexport const SEARCH_KNOWLEDGE_BASE = `\n  query SearchKnowledgeBase($query: String!, $limit: Int, $offset: Int) {\n    searchKnowledgeBase(query: $query, limit: $limit, offset: $offset) {\n      id title slug helpfulnessScore\n    }\n  }\n`;\n","/**\n * Support MCP tools — support tickets + knowledge base.\n * Surface mirrors cli-sdk/src/modules/support/commands.ts.\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 * as ops from './operations.js';\n\ninterface TicketRow {\n  id: string;\n  ticketNumber?: string;\n  subject?: string;\n  description?: string;\n  status?: string;\n  priority?: string;\n  category?: string;\n  createdAt?: string;\n  closedAt?: string;\n}\n\ninterface KbArticle {\n  id: string;\n  title: string;\n  slug: string;\n  helpfulnessScore: number;\n}\n\nexport function registerSupportTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_list')),\n    {\n      title: 'List Support Tickets',\n      description:\n        'List support tickets. Live `supportTickets` takes no args (workspace context from `x-workspace-id`); the legacy `(filter, limit, offset)` shape is gone and `status` / `priority` filtering is not yet exposed.',\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const data = await ctx.gql.global.request<{\n          supportTickets: { nodes: TicketRow[] };\n        }>(ops.LIST_SUPPORT_TICKETS);\n        return jsonResult(data.supportTickets);\n      } catch (error) {\n        ctx.logger.error('support_tickets_list failed', { error: String(error) });\n        return errorResult(\n          `Failed to list support tickets: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_get')),\n    {\n      title: 'Get Support Ticket',\n      description: 'Get a support ticket by ID, including messages.',\n      inputSchema: { id: z.string().describe('Ticket ID') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.global.request<{ supportTicket: TicketRow | null }>(\n          ops.GET_SUPPORT_TICKET,\n          { id },\n        );\n        if (!data.supportTicket) return errorResult(`Ticket ${id} not found`);\n        return jsonResult(data.supportTicket);\n      } catch (error) {\n        ctx.logger.error('support_tickets_get failed', { error: String(error) });\n        return errorResult(\n          `Failed to get support ticket: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_create')),\n    {\n      title: 'Create Support Ticket',\n      description: 'Open a support ticket.',\n      inputSchema: {\n        subject: z.string().describe('Ticket subject'),\n        description: z.string().describe('Ticket description'),\n        priority: z.string().optional().describe('LOW|NORMAL|HIGH|URGENT (default NORMAL)'),\n        category: z\n          .string()\n          .optional()\n          .describe('TECHNICAL_SUPPORT|BILLING|FEATURE_REQUEST|OTHER (default TECHNICAL_SUPPORT)'),\n      },\n    },\n    async ({ subject, description, priority, category }) => {\n      try {\n        const input: Record<string, unknown> = {\n          subject,\n          description,\n          priority: (priority ?? 'NORMAL').toUpperCase(),\n          category: (category ?? 'TECHNICAL_SUPPORT').toUpperCase(),\n        };\n        const data = await ctx.gql.global.request<{ createSupportTicket: TicketRow }>(\n          ops.CREATE_SUPPORT_TICKET,\n          { input },\n        );\n        return jsonResult(data.createSupportTicket);\n      } catch (error) {\n        ctx.logger.error('support_tickets_create failed', { error: String(error) });\n        return errorResult(\n          `Failed to create support ticket: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_comment')),\n    {\n      title: 'Add Support Ticket Comment',\n      description: 'Add a comment to a support ticket.',\n      inputSchema: {\n        ticketId: z.string().describe('Ticket ID'),\n        message: z.string().describe('Comment message'),\n        internal: z.boolean().optional().describe('Internal staff-only comment (default false)'),\n      },\n    },\n    async ({ ticketId, message, internal }) => {\n      try {\n        const input: Record<string, unknown> = {\n          ticketId,\n          message,\n          isInternal: internal === true,\n        };\n        const data = await ctx.gql.global.request<{\n          createSupportMessage: {\n            id: string;\n            message: string;\n            createdAt: string;\n            isInternal: boolean;\n          };\n        }>(ops.CREATE_SUPPORT_MESSAGE, { input });\n        return jsonResult(data.createSupportMessage);\n      } catch (error) {\n        ctx.logger.error('support_tickets_comment failed', { error: String(error) });\n        return errorResult(\n          `Failed to add support ticket comment: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // BOFF-8218: live `closeSupportTicket` requires the ticket to be in\n  // `RESOLVED` state first. To keep the user-facing surface simple\n  // (one call closes a ticket), the tool first calls\n  // `resolveSupportTicket(id)` (which is a no-op for already-resolved\n  // tickets) and then `closeSupportTicket(id)`. If the close still\n  // fails (e.g. the ticket is in a non-OPEN/RESOLVED state), the\n  // tool surfaces the underlying alpha error.\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_tickets_close')),\n    {\n      title: 'Close Support Ticket',\n      description:\n        \"Close a support ticket. Live alpha requires the ticket to be RESOLVED first; the tool performs the resolve step before close, so callers don't need to track the state machine.\",\n      inputSchema: { id: z.string().describe('Ticket ID') },\n    },\n    async ({ id }) => {\n      try {\n        // 1. Resolve (idempotent for already-resolved tickets; the\n        //    runtime error \"Ticket not in a resolvable state\" is OK\n        //    here because the close call will surface the real reason\n        //    if the ticket is in an unsupportable state).\n        await ctx.gql.global\n          .request<{ resolveSupportTicket: { id: string; status: string } | null }>(\n            ops.RESOLVE_SUPPORT_TICKET,\n            { id },\n          )\n          .catch(() => null);\n        // 2. Close.\n        const data = await ctx.gql.global.request<{ closeSupportTicket: TicketRow }>(\n          ops.CLOSE_SUPPORT_TICKET,\n          { id },\n        );\n        return jsonResult(data.closeSupportTicket);\n      } catch (error) {\n        ctx.logger.error('support_tickets_close failed', { error: String(error) });\n        return errorResult(\n          `Failed to close support ticket: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'support_kb_search')),\n    {\n      title: 'Search Knowledge Base',\n      description: 'Search knowledge base articles.',\n      inputSchema: {\n        query: z.string().describe('Search query'),\n        limit: z.number().optional().describe('Page size (default 20)'),\n      },\n    },\n    async ({ query, limit }) => {\n      try {\n        const data = await ctx.gql.global.request<{ searchKnowledgeBase: KbArticle[] }>(\n          ops.SEARCH_KNOWLEDGE_BASE,\n          { query, limit: limit ?? 20, offset: 0 },\n        );\n        return jsonResult(data.searchKnowledgeBase);\n      } catch (error) {\n        ctx.logger.error('support_kb_search failed', { error: String(error) });\n        return errorResult(\n          `Failed to search knowledge base: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Support module — support tickets CRUD + comments + close + KB search.\n * Surface mirrors cli-sdk/src/modules/support/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerSupportTools } from './tools.js';\n\nconst supportModule: McpModule = {\n  id: 'support',\n  version: '0.0.1',\n  displayName: 'Support',\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    registerSupportTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default supportModule;\n"]}

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

@@ -1,8 +1,3 @@
-import { c as McpModule } from '../../module-VpgjAf8m.js';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import '../../context-DGO4h-Pd.js';
-import 'graphql-request';
-
+import type { McpModule } from '../../core/index.js';
 declare const supportModule: McpModule;
-
-export { supportModule as default };
+export default supportModule;

package/dist/modules/support/index.js

@@ -1,4 +1,4 @@
-import { mcpToolName, jsonResult, errorResult } from '../../chunk-G76DKEPI.js';
+import { mcpToolName, jsonResult, errorResult } from '../../chunk-FHXCNP2U.js';
 import { z } from 'zod';
 
 // src/modules/support/operations.ts

package/dist/modules/support/operations.d.ts

@@ -0,0 +1,7 @@
+export declare const LIST_SUPPORT_TICKETS = "\n  query ListSupportTickets {\n    supportTickets {\n      nodes { id ticketNumber subject status priority category createdAt }\n    }\n  }\n";
+export declare const GET_SUPPORT_TICKET = "\n  query GetSupportTicket($id: ID!) {\n    supportTicket(id: $id) {\n      id ticketNumber subject description status priority category createdAt\n      messages { id message createdAt isInternal }\n    }\n  }\n";
+export declare const CREATE_SUPPORT_TICKET = "\n  mutation CreateSupportTicket($input: CreateSupportTicketInput!) {\n    createSupportTicket(input: $input) {\n      id ticketNumber status priority\n    }\n  }\n";
+export declare const CREATE_SUPPORT_MESSAGE = "\n  mutation CreateSupportMessage($input: CreateSupportMessageInput!) {\n    createSupportMessage(input: $input) {\n      id message createdAt isInternal\n    }\n  }\n";
+export declare const CLOSE_SUPPORT_TICKET = "\n  mutation CloseSupportTicket($id: ID!) {\n    closeSupportTicket(id: $id) {\n      id status closedAt\n    }\n  }\n";
+export declare const RESOLVE_SUPPORT_TICKET = "\n  mutation ResolveSupportTicket($id: ID!) {\n    resolveSupportTicket(id: $id) {\n      id status resolvedAt\n    }\n  }\n";
+export declare const SEARCH_KNOWLEDGE_BASE = "\n  query SearchKnowledgeBase($query: String!, $limit: Int, $offset: Int) {\n    searchKnowledgeBase(query: $query, limit: $limit, offset: $offset) {\n      id title slug helpfulnessScore\n    }\n  }\n";

package/dist/modules/support/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../core/index.js';
+export declare function registerSupportTools(server: McpServer, ctx: McpContext, track: (n: string) => string): void;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/tool-name.ts","../../../src/core/result.ts","../../../src/modules/tags/tools.ts","../../../src/modules/tags/index.ts"],"names":[],"mappings":";;;;;;;;;;;AA8BO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,EACjB,KAAA;AAAA,EAEzB,WAAA,CAAY,SAAiB,KAAA,EAAiB;AAC5C,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AACZ,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AACF,CAAA;;;AC1BA,IAAM,oBAAA,GAAuB,EAAA;AAE7B,SAAS,cAAA,CAAe,MAAc,IAAA,EAA8C;AAClF,EAAA,IAAuB,IAAA,CAAK,MAAA,GAAS,oBAAA,EAAsB;AACzD,IAAA,MAAM,IAAI,gBAAA;AAAA,MACR,CAAA,WAAA,EAAc,IAAI,CAAA,UAAA,EAAa,oBAAoB,CAAA,8CAAA;AAAA,KACrD;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAMO,SAAS,WAAA,CAAY,gBAAwB,KAAA,EAAyB;AAC3E,EAAA,IAAI,CAAC,WAAA,EAAa;AAChB,IAAA,MAAM,IAAI,iBAAiB,sCAAsC,CAAA;AAAA,EACnE;AACA,EAAA,MAAM,IAAA,GAAO,CAAC,WAAA,EAAa,GAAG,KAAK,EAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAC7D,EAAA,OAAO,cAAA,CAAe,IAAY,CAAA;AACpC;;;AC4BO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,MAAM,IAAA,GAAO,IAAA,GAAO,CAAA,EAAG,OAAO;;AAAA,MAAA,EAAa,IAAI,CAAA,CAAA,GAAK,OAAA;AACpD,EAAA,OAAO,EAAE,OAAA,EAAS,CAAC,EAAE,IAAA,EAAM,QAAQ,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,IAAA,EAAK;AAC5D;;;AC3DA,SAAS,YACP,MAAA,EACA,QAAA,EACA,OACA,WAAA,EACA,WAAA,EACA,aACA,cAAA,EACM;AACN,EAAA,MAAA,CAAO,YAAA;AAAA,IACL,QAAA;AAAA,IACA;AAAA,MACE,KAAA;AAAA,MACA,WAAA,EAAa,GAAG,WAAW,CAAA,OAAA,CAAA;AAAA,MAC3B;AAAA,KACF;AAAA,IACA,YACE,WAAA;AAAA,MACE,aAAa,WAAW,CAAA,KAAA,EAAQ,cAAA,CAAe,IAAA,CAAK,IAAI,CAAC,CAAA,oHAAA;AAAA;AAC3D,GACJ;AACF;AAEO,SAAS,iBAAA,CACd,MAAA,EACA,IAAA,EACA,KAAA,EACM;AAON,EAAA,MAAM,WAAA,GACJ,qKAAA;AACF,EAAA,MAAM,IAAA,GAAO;AAAA,IACX,uDAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,MAAM,KAAA,GAAyC;AAAA,IAC7C,CAAC,WAAA,EAAa,WAAA,EAAa,oCAAoC,CAAA;AAAA,IAC/D,CAAC,UAAA,EAAY,SAAA,EAAW,kBAAkB,CAAA;AAAA,IAC1C,CAAC,aAAA,EAAe,YAAA,EAAc,sDAAsD,CAAA;AAAA,IACpF,CAAC,aAAA,EAAe,YAAA,EAAc,yBAAyB,CAAA;AAAA,IACvD,CAAC,aAAA,EAAe,YAAA,EAAc,qBAAqB,CAAA;AAAA,IACnD,CAAC,gBAAA,EAAkB,eAAA,EAAiB,sDAAsD,CAAA;AAAA,IAC1F;AAAA,MACE,uBAAA;AAAA,MACA,sBAAA;AAAA,MACA;AAAA,KACF;AAAA,IACA,CAAC,wBAAA,EAA0B,sBAAA,EAAwB,yBAAyB,CAAA;AAAA,IAC5E,CAAC,yBAAA,EAA2B,uBAAA,EAAyB,0BAA0B;AAAA,GACjF;AACA,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,KAAA,EAAO,IAAI,KAAK,KAAA,EAAO;AACvC,IAAA,WAAA;AAAA,MACE,MAAA;AAAA,MACA,KAAA,CAAM,WAAA,CAAY,IAAA,CAAK,WAAA,EAAa,IAAI,CAAC,CAAA;AAAA,MACzC,KAAA;AAAA,MACA,IAAA;AAAA,MACA,WAAA;AAAA,MACA,EAAC;AAAA,MACD;AAAA,KACF;AAAA,EACF;AACF;;;AC3DA,IAAM,UAAA,GAAwB;AAAA,EAC5B,EAAA,EAAI,MAAA;AAAA,EACJ,OAAA,EAAS,OAAA;AAAA,EACT,WAAA,EAAa,MAAA;AAAA,EACb,SAAA,EAAW,CAAC,MAAM,CAAA;AAAA,EAClB,YAAA,EAAc,EAAE,KAAA,EAAO,EAAC,EAAE;AAAA,EAC1B,QAAA,CAAS,QAAmB,GAAA,EAAqC;AAC/D,IAAA,MAAM,QAAkB,EAAC;AACzB,IAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,KAAsB;AACnC,MAAA,KAAA,CAAM,KAAK,CAAC,CAAA;AACZ,MAAA,OAAO,CAAA;AAAA,IACT,CAAA;AACA,IAAA,iBAAA,CAAkB,MAAA,EAAQ,KAAK,KAAK,CAAA;AACpC,IAAA,OAAO,EAAE,KAAA,EAAO,SAAA,EAAW,EAAC,EAAG,OAAA,EAAS,EAAC,EAAE;AAAA,EAC7C;AACF,CAAA;AAEA,IAAO,YAAA,GAAQ","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 * 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\n/**\n * Name-based hint heuristics for MCP `annotations` (readOnlyHint /\n * destructiveHint). Used by tool-governance.ts to auto-fill annotations for\n * the fleet of product modules that call `server.registerTool` directly\n * (bypassing the `registerTool()` core helper) and so never set them\n * explicitly today (BOFF-3903). Deliberately conservative — matched against\n * whole `_`-delimited segments so e.g. `timeentries_delete` and\n * `pomodoro_delete_goal` match, but a hypothetical `undeletable_check`\n * would not.\n *\n * A module can always override the inference by passing an explicit\n * `annotations` object to `registerTool()` / `server.registerTool()`.\n */\nconst DESTRUCTIVE_NAME_SEGMENT = /(?:^|_)delete(?:_|$)/i;\nconst READ_ONLY_NAME_SEGMENT = /(?:^|_)(?:list|get|search|check|read|count|stats|by_date)(?:_|$)/i;\n\n/** True when a tool name looks destructive (irreversibly deletes data) by naming convention. */\nexport function inferDestructiveHint(toolName: string): boolean {\n  return DESTRUCTIVE_NAME_SEGMENT.test(toolName);\n}\n\n/**\n * True when a tool name looks read-only by naming convention. Never true for\n * a name that also looks destructive (a tool can't be both).\n */\nexport function inferReadOnlyHint(toolName: string): boolean {\n  return !inferDestructiveHint(toolName) && READ_ONLY_NAME_SEGMENT.test(toolName);\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';\nimport type { ToolAnnotations } from './tool-governance.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   * Explicit MCP annotations (readOnlyHint / destructiveHint / ...). Optional\n   * — when omitted, `wrapServerWithToolGovernance` (applied centrally in\n   * `createMcpServer`) infers them from the tool name. Set this to override\n   * the inference for a tool whose name doesn't match the naming convention.\n   */\n  annotations?: ToolAnnotations;\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    ...(metadata.annotations ? { annotations: metadata.annotations } : {}),\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 } } | 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","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { errorResult, mcpToolName, type McpContext } from '../../core/index.js';\n\ntype StubInputSchema = Record<string, z.ZodTypeAny>;\nfunction stubbedTool(\n  server: McpServer,\n  toolName: string,\n  title: string,\n  description: string,\n  featureNote: string,\n  inputSchema: StubInputSchema,\n  altSuggestions: string[],\n): void {\n  server.registerTool(\n    toolName,\n    {\n      title,\n      description: `${description} [STUB]`,\n      inputSchema,\n    },\n    async () =>\n      errorResult(\n        `[stubbed] ${featureNote} Use ${altSuggestions.join(', ')} instead. The tool remains registered so callers receive a meaningful response instead of a schema-validation error.`,\n      ),\n  );\n}\n\nexport function registerTagsTools(\n  server: McpServer,\n  _ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  // BOFF-8201: `Query.tags` on the live alpha gateway is fundamentally\n  // broken — even a selection of just `{ name }` returns an\n  // INTERNAL_SERVER_ERROR. The whole tags surface is unreachable\n  // until alpha ships a fix. Stub all 9 tools so callers get a clean\n  // \"[stubbed]\" error and the per-call wiring is in place for the day\n  // the tags service recovers.\n  const featureNote =\n    'Live alpha has `Query.tags` returning INTERNAL_SERVER_ERROR on even the simplest selection (`{ name }`). The whole tags surface is down until the service recovers.';\n  const alts = [\n    'the next alpha release that restores the tags surface',\n    'the SDK tags API (which the MCP will mirror once it lands)',\n  ];\n\n  const tools: Array<[string, string, string]> = [\n    ['tags_list', 'List Tags', 'List tags in the active workspace.'],\n    ['tags_get', 'Get Tag', 'Get a tag by ID.'],\n    ['tags_create', 'Create Tag', 'Create a new tag (requires `vocabularyId` on alpha).'],\n    ['tags_update', 'Update Tag', 'Update an existing tag.'],\n    ['tags_delete', 'Delete Tag', 'Delete a tag by ID.'],\n    ['tags_analytics', 'Tag Analytics', 'Get analytics for a tag (assignment / usage counts).'],\n    [\n      'tags_permissions_list',\n      'List Tag Permissions',\n      'List tag-permission grants in the workspace.',\n    ],\n    ['tags_permissions_grant', 'Grant Tag Permission', 'Grant a tag permission.'],\n    ['tags_permissions_revoke', 'Revoke Tag Permission', 'Revoke a tag permission.'],\n  ];\n  for (const [tool, title, desc] of tools) {\n    stubbedTool(\n      server,\n      track(mcpToolName(_ctx.productName, tool)),\n      title,\n      desc,\n      featureNote,\n      {},\n      alts,\n    );\n  }\n}\n","/**\n * Tags module — CANONICAL reference module per CLAUDE.md.\n *\n * Tools: <product>_tags_{list,get,create,update,delete,analytics} +\n * <product>_tags_relations_{list,grant,revoke}.\n *\n * Backend: ~/products/wspace/tags/wspace-tags-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerTagsTools } from './tools.js';\n\nconst tagsModule: McpModule = {\n  id: 'tags',\n  version: '0.0.1',\n  displayName: 'Tags',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\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    registerTagsTools(server, ctx, track);\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default tagsModule;\n"]}
+{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/tool-name.ts","../../../src/core/result.ts","../../../src/modules/tags/tools.ts","../../../src/modules/tags/index.ts"],"names":[],"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 * 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\n/**\n * Name-based hint heuristics for MCP `annotations` (readOnlyHint /\n * destructiveHint). Used by tool-governance.ts to auto-fill annotations for\n * the fleet of product modules that call `server.registerTool` directly\n * (bypassing the `registerTool()` core helper) and so never set them\n * explicitly today (BOFF-3903). Deliberately conservative — matched against\n * whole `_`-delimited segments so e.g. `timeentries_delete` and\n * `pomodoro_delete_goal` match, but a hypothetical `undeletable_check`\n * would not.\n *\n * The destructive verb set covers more than `delete`: stopping, killing or\n * terminating a running process, revoking or rotating a credential/share,\n * resetting settings and removing/purging/uninstalling are all actions an\n * MCP client must not auto-run without the user's intent (VC/FG parity G57 —\n * e.g. `vibecontrols_sessions_kill`, `vibecontrols_tunnels_rotate_credentials`\n * were previously reported as non-destructive).\n *\n * A module can always override the inference by passing an explicit\n * `annotations` object to `registerTool()` / `server.registerTool()` — do\n * that for the rare verb match that is harmless (e.g. a typing indicator's\n * `typing_stop`).\n */\nexport const DESTRUCTIVE_NAME_VERBS = [\n  'delete',\n  'destroy',\n  'erase',\n  'kill',\n  'purge',\n  'remove',\n  'reset',\n  'revoke',\n  'rotate',\n  'stop',\n  'terminate',\n  'uninstall',\n  'wipe',\n] as const;\nconst DESTRUCTIVE_NAME_SEGMENT = new RegExp(\n  `(?:^|_)(?:${DESTRUCTIVE_NAME_VERBS.join('|')})(?:_|$)`,\n  'i',\n);\nconst READ_ONLY_NAME_SEGMENT = /(?:^|_)(?:list|get|search|check|read|count|stats|by_date)(?:_|$)/i;\n\n/** True when a tool name looks destructive (irreversibly deletes data) by naming convention. */\nexport function inferDestructiveHint(toolName: string): boolean {\n  return DESTRUCTIVE_NAME_SEGMENT.test(toolName);\n}\n\n/**\n * True when a tool name looks read-only by naming convention. Never true for\n * a name that also looks destructive (a tool can't be both).\n */\nexport function inferReadOnlyHint(toolName: string): boolean {\n  return !inferDestructiveHint(toolName) && READ_ONLY_NAME_SEGMENT.test(toolName);\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';\nimport type { ToolAnnotations } from './tool-governance.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   * Explicit MCP annotations (readOnlyHint / destructiveHint / ...). Optional\n   * — when omitted, `wrapServerWithToolGovernance` (applied centrally in\n   * `createMcpServer`) infers them from the tool name. Set this to override\n   * the inference for a tool whose name doesn't match the naming convention.\n   */\n  annotations?: ToolAnnotations;\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    ...(metadata.annotations ? { annotations: metadata.annotations } : {}),\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 } } | 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","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { errorResult, mcpToolName, type McpContext } from '../../core/index.js';\n\ntype StubInputSchema = Record<string, z.ZodTypeAny>;\nfunction stubbedTool(\n  server: McpServer,\n  toolName: string,\n  title: string,\n  description: string,\n  featureNote: string,\n  inputSchema: StubInputSchema,\n  altSuggestions: string[],\n): void {\n  server.registerTool(\n    toolName,\n    {\n      title,\n      description: `${description} [STUB]`,\n      inputSchema,\n    },\n    async () =>\n      errorResult(\n        `[stubbed] ${featureNote} Use ${altSuggestions.join(', ')} instead. The tool remains registered so callers receive a meaningful response instead of a schema-validation error.`,\n      ),\n  );\n}\n\nexport function registerTagsTools(\n  server: McpServer,\n  _ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  // BOFF-8201: `Query.tags` on the live alpha gateway is fundamentally\n  // broken — even a selection of just `{ name }` returns an\n  // INTERNAL_SERVER_ERROR. The whole tags surface is unreachable\n  // until alpha ships a fix. Stub all 9 tools so callers get a clean\n  // \"[stubbed]\" error and the per-call wiring is in place for the day\n  // the tags service recovers.\n  const featureNote =\n    'Live alpha has `Query.tags` returning INTERNAL_SERVER_ERROR on even the simplest selection (`{ name }`). The whole tags surface is down until the service recovers.';\n  const alts = [\n    'the next alpha release that restores the tags surface',\n    'the SDK tags API (which the MCP will mirror once it lands)',\n  ];\n\n  const tools: Array<[string, string, string]> = [\n    ['tags_list', 'List Tags', 'List tags in the active workspace.'],\n    ['tags_get', 'Get Tag', 'Get a tag by ID.'],\n    ['tags_create', 'Create Tag', 'Create a new tag (requires `vocabularyId` on alpha).'],\n    ['tags_update', 'Update Tag', 'Update an existing tag.'],\n    ['tags_delete', 'Delete Tag', 'Delete a tag by ID.'],\n    ['tags_analytics', 'Tag Analytics', 'Get analytics for a tag (assignment / usage counts).'],\n    [\n      'tags_permissions_list',\n      'List Tag Permissions',\n      'List tag-permission grants in the workspace.',\n    ],\n    ['tags_permissions_grant', 'Grant Tag Permission', 'Grant a tag permission.'],\n    ['tags_permissions_revoke', 'Revoke Tag Permission', 'Revoke a tag permission.'],\n  ];\n  for (const [tool, title, desc] of tools) {\n    stubbedTool(\n      server,\n      track(mcpToolName(_ctx.productName, tool)),\n      title,\n      desc,\n      featureNote,\n      {},\n      alts,\n    );\n  }\n}\n","/**\n * Tags module — CANONICAL reference module per CLAUDE.md.\n *\n * Tools: <product>_tags_{list,get,create,update,delete,analytics} +\n * <product>_tags_relations_{list,grant,revoke}.\n *\n * Backend: ~/products/wspace/tags/wspace-tags-svc/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerTagsTools } from './tools.js';\n\nconst tagsModule: McpModule = {\n  id: 'tags',\n  version: '0.0.1',\n  displayName: 'Tags',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\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    registerTagsTools(server, ctx, track);\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default tagsModule;\n"]}

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

@@ -1,8 +1,3 @@
-import { c as McpModule } from '../../module-VpgjAf8m.js';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import '../../context-DGO4h-Pd.js';
-import 'graphql-request';
-
+import type { McpModule } from '../../core/index.js';
 declare const tagsModule: McpModule;
-
-export { tagsModule as default };
+export default tagsModule;

package/dist/modules/tags/index.js

@@ -1,4 +1,4 @@
-import { mcpToolName, errorResult } from '../../chunk-G76DKEPI.js';
+import { mcpToolName, errorResult } from '../../chunk-FHXCNP2U.js';
 
 // src/modules/tags/tools.ts
 function stubbedTool(server, toolName, title, description, featureNote, inputSchema, altSuggestions) {

package/dist/modules/tags/operations.d.ts

@@ -0,0 +1,9 @@
+export declare const LIST_TAGS = "\n  query TagsList($filter: TagFilterInput, $pagination: TagsPaginationInput) {\n    getTags(filter: $filter, pagination: $pagination) {\n      items { id key label description scope displayOrder }\n      total hasMore\n    }\n  }\n";
+export declare const GET_TAG = "\n  query GetTag($id: ID!) {\n    getTag(id: $id) {\n      id key label description color icon scope vocabularyId parentId\n      displayOrder assignmentCount usageCount hierarchyLevel hierarchyPath\n    }\n  }\n";
+export declare const CREATE_TAG = "\n  mutation CreateTag($input: CreateTagInput!) {\n    createTag(input: $input) {\n      id key label description scope displayOrder createdAt\n    }\n  }\n";
+export declare const UPDATE_TAG = "\n  mutation UpdateTag($id: ID!, $input: UpdateTagInput!) {\n    updateTag(id: $id, input: $input) {\n      id label description color icon parentId displayOrder updatedAt\n    }\n  }\n";
+export declare const DELETE_TAG = "\n  mutation DeleteTag($id: ID!) {\n    deleteTag(id: $id)\n  }\n";
+export declare const TAG_ANALYTICS = "\n  query TagAnalytics($tagId: ID!, $startDate: DateTime!, $endDate: DateTime!) {\n    getTagAnalytics(tagId: $tagId, startDate: $startDate, endDate: $endDate) {\n      assignmentCount date entityTypeBreakdown uniqueUsers uniqueEntities\n    }\n  }\n";
+export declare const TAG_RELATIONS = "\n  query GetRelatedTags($tagId: ID!) {\n    getRelatedTags(tagId: $tagId) {\n      tag { id label }\n      relationType\n    }\n  }\n";
+export declare const CREATE_TAG_RELATION = "\n  mutation CreateTagRelation($input: CreateTagRelationInput!) {\n    createTagRelation(input: $input) {\n      id fromTagId toTagId relationType bidirectional\n    }\n  }\n";
+export declare const DELETE_TAG_RELATION = "\n  mutation DeleteTagRelation($id: ID!) {\n    deleteTagRelation(id: $id)\n  }\n";

package/dist/modules/tags/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from '../../core/index.js';
+export declare function registerTagsTools(server: McpServer, _ctx: McpContext, track: (n: string) => string): void;