@kelpi/mcp 0.1.0

package/dist/lib/tool-registry.js

@@ -0,0 +1,112 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Custom error class for tool registry operations
+ */
+export class ToolRegistryError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'ToolRegistryError';
+        this.code = code;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ToolRegistryError);
+        }
+    }
+}
+/**
+ * Registry for managing MCP tools with Zod validation
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /**
+     * Register a tool with its definition and handler
+     */
+    register(definition, handler) {
+        if (this.tools.has(definition.name)) {
+            throw new ToolRegistryError(`Tool already registered: ${definition.name}`, 'DUPLICATE_TOOL');
+        }
+        this.tools.set(definition.name, { definition, handler });
+    }
+    /**
+     * Get a registered tool by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * List all registered tools in MCP-compatible format
+     */
+    list() {
+        return Array.from(this.tools.values()).map(({ definition }) => {
+            // Convert Zod schema to JSON Schema
+            // Use jsonSchema7 target which produces JSON Schema draft-07 format
+            // This is compatible with JSON Schema draft 2020-12 that Claude expects
+            // Note: 'openApi3' produces boolean exclusiveMinimum/exclusiveMaximum which is invalid
+            const jsonSchema = zodToJsonSchema(definition.inputSchema, {
+                $refStrategy: 'none',
+                target: 'jsonSchema7',
+            });
+            // Extract just the schema properties we need
+            const schemaObj = jsonSchema;
+            return {
+                name: definition.name,
+                description: definition.description,
+                inputSchema: {
+                    type: 'object',
+                    properties: schemaObj.properties || {},
+                    ...(schemaObj.required && { required: schemaObj.required }),
+                },
+            };
+        });
+    }
+    /**
+     * Validate input against a tool's schema
+     */
+    validateInput(toolName, input) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new ToolRegistryError(`Tool not found: ${toolName}`, 'TOOL_NOT_FOUND');
+        }
+        const result = tool.definition.inputSchema.safeParse(input);
+        if (result.success) {
+            return { success: true, data: result.data };
+        }
+        return { success: false, error: result.error };
+    }
+    /**
+     * Execute a tool with validated input
+     */
+    async execute(toolName, input) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new ToolRegistryError(`Tool not found: ${toolName}`, 'TOOL_NOT_FOUND');
+        }
+        // Validate input
+        const validation = this.validateInput(toolName, input);
+        if (!validation.success) {
+            throw new ToolRegistryError(`Invalid input for tool ${toolName}: ${validation.error.message}`, 'INVALID_INPUT');
+        }
+        // Execute handler with validated input
+        return tool.handler(validation.data);
+    }
+    /**
+     * Check if a tool is registered
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get the number of registered tools
+     */
+    get size() {
+        return this.tools.size;
+    }
+    /**
+     * Clear all registered tools
+     */
+    clear() {
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/lib/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/lib/tool-registry.ts"],"names":[],"mappings":"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"}

package/dist/lib/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared version constant for the MCP package.
+ *
+ * This constant is used in User-Agent headers across the package.
+ * Update this when releasing a new version to ensure consistent
+ * version reporting in API requests.
+ *
+ * Note: Reading from package.json at runtime is intentionally avoided
+ * to prevent file system dependencies that could cause issues in
+ * bundled environments.
+ */
+export declare const MCP_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/lib/version.js

@@ -0,0 +1,13 @@
+/**
+ * Shared version constant for the MCP package.
+ *
+ * This constant is used in User-Agent headers across the package.
+ * Update this when releasing a new version to ensure consistent
+ * version reporting in API requests.
+ *
+ * Note: Reading from package.json at runtime is intentionally avoided
+ * to prevent file system dependencies that could cause issues in
+ * bundled environments.
+ */
+export const MCP_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/prompts/flow-generator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Flow Generator Prompt
+ *
+ * A system prompt that helps users create automation flows conversationally.
+ * This can be used to guide AI assistants in creating well-structured flows.
+ */
+export declare const FLOW_GENERATOR_SYSTEM_PROMPT = "You are a Kelpi Flow Generator assistant. Your role is to help users create automation flows for customer engagement.\n\n## Understanding Flows\n\nA Kelpi flow is an automated sequence of actions triggered by an event. Flows consist of:\n\n1. **Trigger**: What starts the flow\n   - event: Triggered by a specific event (e.g., \"user.signup\", \"purchase.completed\")\n   - segment: Triggered when a contact enters a segment\n   - manual: Triggered manually via API\n\n2. **Steps**: Actions to perform in sequence\n   - delay: Wait for a specified time before continuing\n   - email: Send an email using a template\n   - condition: Branch based on contact properties\n   - webhook: Call an external API\n\n## Flow Definition Structure\n\n{\n  \"name\": \"Flow Name\",\n  \"trigger_type\": \"event\",\n  \"trigger_event\": \"user.signup\",\n  \"steps\": [\n    {\n      \"step_order\": 0,\n      \"action_type\": \"delay\",\n      \"delay_seconds\": 3600\n    },\n    {\n      \"step_order\": 1,\n      \"action_type\": \"email\",\n      \"template_id\": \"template-uuid\"\n    }\n  ]\n}\n\n## Common Patterns\n\n### Welcome Series\n- Trigger: user.signup\n- Step 1: Immediate welcome email\n- Step 2: 24-hour delay\n- Step 3: Getting started email\n- Step 4: 3-day delay\n- Step 5: Feature highlight email\n\n### Abandoned Cart\n- Trigger: cart.abandoned\n- Step 1: 1-hour delay\n- Step 2: Reminder email\n- Step 3: 24-hour delay\n- Step 4: Discount offer email\n\n### Re-engagement\n- Trigger: segment (inactive users)\n- Step 1: \"We miss you\" email\n- Step 2: 3-day delay\n- Step 3: Special offer email\n\n## Guidelines\n\n1. Ask clarifying questions to understand the user's goals\n2. Suggest best practices for email timing\n3. Create templates first if needed using kelpi_create_template\n4. Validate before creating and confirm with user\n\n## Time Conversion Reference\n\nCommon delays in seconds:\n- 1 hour = 3600 seconds\n- 24 hours = 86400 seconds\n- 3 days = 259200 seconds\n- 7 days = 604800 seconds\n- 30 days = 2592000 seconds\n";
+/**
+ * Template suggestions for common use cases
+ */
+export declare const TEMPLATE_SUGGESTIONS: {
+    readonly welcome: {
+        readonly slug: "welcome-email";
+        readonly name: "Welcome Email";
+        readonly subject: "Welcome to {{company_name}}!";
+        readonly body_html: "<h1>Welcome, {{name}}!</h1>\n<p>We're thrilled to have you join us.</p>\n<p>Here's what you can do next:</p>\n<ul>\n  <li>Complete your profile</li>\n  <li>Explore our features</li>\n  <li>Join our community</li>\n</ul>\n<p>Best regards,<br>The {{company_name}} Team</p>";
+    };
+    readonly gettingStarted: {
+        readonly slug: "getting-started-email";
+        readonly name: "Getting Started Guide";
+        readonly subject: "Getting started with {{company_name}}";
+        readonly body_html: "<h1>Let's get you started, {{name}}</h1>\n<p>Here are some tips to help you get the most out of {{company_name}}:</p>\n<ol>\n  <li><strong>Set up your workspace</strong> - Customize your settings</li>\n  <li><strong>Invite your team</strong> - Collaborate with others</li>\n  <li><strong>Try key features</strong> - Explore what we offer</li>\n</ol>\n<p>Need help? <a href=\"{{support_url}}\">Contact our support team</a></p>";
+    };
+    readonly abandoned: {
+        readonly slug: "cart-reminder-email";
+        readonly name: "Cart Reminder";
+        readonly subject: "You left something behind!";
+        readonly body_html: "<h1>Hi {{name}},</h1>\n<p>Looks like you left some items in your cart.</p>\n<p>Don't worry, we saved them for you!</p>\n<p><a href=\"{{cart_url}}\">Complete your purchase</a></p>\n<p>Questions? Reply to this email and we'll help.</p>";
+    };
+    readonly reengagement: {
+        readonly slug: "we-miss-you-email";
+        readonly name: "Re-engagement Email";
+        readonly subject: "We miss you, {{name}}!";
+        readonly body_html: "<h1>It's been a while!</h1>\n<p>Hi {{name}},</p>\n<p>We noticed you haven't logged in recently. Here's what's new:</p>\n<ul>\n  <li>New features you might love</li>\n  <li>Improvements based on feedback</li>\n  <li>Special offer just for you</li>\n</ul>\n<p><a href=\"{{login_url}}\">Come back and explore</a></p>";
+    };
+};
+/**
+ * Get a template suggestion by use case
+ */
+export declare function getTemplateSuggestion(useCase: keyof typeof TEMPLATE_SUGGESTIONS): (typeof TEMPLATE_SUGGESTIONS)[typeof useCase];
+/**
+ * Convert human-readable duration to seconds
+ */
+export declare function durationToSeconds(duration: string): number;
+//# sourceMappingURL=flow-generator.d.ts.map

package/dist/prompts/flow-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-generator.d.ts","sourceRoot":"","sources":["../../src/prompts/flow-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,4BAA4B,igEA2ExC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAoDvB,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,OAAO,oBAAoB,GACzC,CAAC,OAAO,oBAAoB,CAAC,CAAC,OAAO,OAAO,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B1D"}

package/dist/prompts/flow-generator.js

@@ -0,0 +1,177 @@
+/**
+ * Flow Generator Prompt
+ *
+ * A system prompt that helps users create automation flows conversationally.
+ * This can be used to guide AI assistants in creating well-structured flows.
+ */
+export const FLOW_GENERATOR_SYSTEM_PROMPT = `You are a Kelpi Flow Generator assistant. Your role is to help users create automation flows for customer engagement.
+
+## Understanding Flows
+
+A Kelpi flow is an automated sequence of actions triggered by an event. Flows consist of:
+
+1. **Trigger**: What starts the flow
+   - event: Triggered by a specific event (e.g., "user.signup", "purchase.completed")
+   - segment: Triggered when a contact enters a segment
+   - manual: Triggered manually via API
+
+2. **Steps**: Actions to perform in sequence
+   - delay: Wait for a specified time before continuing
+   - email: Send an email using a template
+   - condition: Branch based on contact properties
+   - webhook: Call an external API
+
+## Flow Definition Structure
+
+{
+  "name": "Flow Name",
+  "trigger_type": "event",
+  "trigger_event": "user.signup",
+  "steps": [
+    {
+      "step_order": 0,
+      "action_type": "delay",
+      "delay_seconds": 3600
+    },
+    {
+      "step_order": 1,
+      "action_type": "email",
+      "template_id": "template-uuid"
+    }
+  ]
+}
+
+## Common Patterns
+
+### Welcome Series
+- Trigger: user.signup
+- Step 1: Immediate welcome email
+- Step 2: 24-hour delay
+- Step 3: Getting started email
+- Step 4: 3-day delay
+- Step 5: Feature highlight email
+
+### Abandoned Cart
+- Trigger: cart.abandoned
+- Step 1: 1-hour delay
+- Step 2: Reminder email
+- Step 3: 24-hour delay
+- Step 4: Discount offer email
+
+### Re-engagement
+- Trigger: segment (inactive users)
+- Step 1: "We miss you" email
+- Step 2: 3-day delay
+- Step 3: Special offer email
+
+## Guidelines
+
+1. Ask clarifying questions to understand the user's goals
+2. Suggest best practices for email timing
+3. Create templates first if needed using kelpi_create_template
+4. Validate before creating and confirm with user
+
+## Time Conversion Reference
+
+Common delays in seconds:
+- 1 hour = 3600 seconds
+- 24 hours = 86400 seconds
+- 3 days = 259200 seconds
+- 7 days = 604800 seconds
+- 30 days = 2592000 seconds
+`;
+/**
+ * Template suggestions for common use cases
+ */
+export const TEMPLATE_SUGGESTIONS = {
+    welcome: {
+        slug: 'welcome-email',
+        name: 'Welcome Email',
+        subject: 'Welcome to {{company_name}}!',
+        body_html: `<h1>Welcome, {{name}}!</h1>
+<p>We're thrilled to have you join us.</p>
+<p>Here's what you can do next:</p>
+<ul>
+  <li>Complete your profile</li>
+  <li>Explore our features</li>
+  <li>Join our community</li>
+</ul>
+<p>Best regards,<br>The {{company_name}} Team</p>`,
+    },
+    gettingStarted: {
+        slug: 'getting-started-email',
+        name: 'Getting Started Guide',
+        subject: 'Getting started with {{company_name}}',
+        body_html: `<h1>Let's get you started, {{name}}</h1>
+<p>Here are some tips to help you get the most out of {{company_name}}:</p>
+<ol>
+  <li><strong>Set up your workspace</strong> - Customize your settings</li>
+  <li><strong>Invite your team</strong> - Collaborate with others</li>
+  <li><strong>Try key features</strong> - Explore what we offer</li>
+</ol>
+<p>Need help? <a href="{{support_url}}">Contact our support team</a></p>`,
+    },
+    abandoned: {
+        slug: 'cart-reminder-email',
+        name: 'Cart Reminder',
+        subject: 'You left something behind!',
+        body_html: `<h1>Hi {{name}},</h1>
+<p>Looks like you left some items in your cart.</p>
+<p>Don't worry, we saved them for you!</p>
+<p><a href="{{cart_url}}">Complete your purchase</a></p>
+<p>Questions? Reply to this email and we'll help.</p>`,
+    },
+    reengagement: {
+        slug: 'we-miss-you-email',
+        name: 'Re-engagement Email',
+        subject: 'We miss you, {{name}}!',
+        body_html: `<h1>It's been a while!</h1>
+<p>Hi {{name}},</p>
+<p>We noticed you haven't logged in recently. Here's what's new:</p>
+<ul>
+  <li>New features you might love</li>
+  <li>Improvements based on feedback</li>
+  <li>Special offer just for you</li>
+</ul>
+<p><a href="{{login_url}}">Come back and explore</a></p>`,
+    },
+};
+/**
+ * Get a template suggestion by use case
+ */
+export function getTemplateSuggestion(useCase) {
+    return TEMPLATE_SUGGESTIONS[useCase];
+}
+/**
+ * Convert human-readable duration to seconds
+ */
+export function durationToSeconds(duration) {
+    const match = duration.match(/^(\d+)\s*(h|hour|hours|d|day|days|m|min|minute|minutes|w|week|weeks)$/i);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}. Use format like "1h", "24 hours", "3 days", "1 week"`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2].toLowerCase();
+    switch (unit) {
+        case 'm':
+        case 'min':
+        case 'minute':
+        case 'minutes':
+            return value * 60;
+        case 'h':
+        case 'hour':
+        case 'hours':
+            return value * 3600;
+        case 'd':
+        case 'day':
+        case 'days':
+            return value * 86400;
+        case 'w':
+        case 'week':
+        case 'weeks':
+            return value * 604800;
+        default:
+            throw new Error(`Unknown time unit: ${unit}`);
+    }
+}
+//# sourceMappingURL=flow-generator.js.map

package/dist/prompts/flow-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-generator.js","sourceRoot":"","sources":["../../src/prompts/flow-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2E3C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE;QACP,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,8BAA8B;QACvC,SAAS,EAAE;;;;;;;;kDAQmC;KAC/C;IACD,cAAc,EAAE;QACd,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,uCAAuC;QAChD,SAAS,EAAE;;;;;;;yEAO0D;KACtE;IACD,SAAS,EAAE;QACT,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,4BAA4B;QACrC,SAAS,EAAE;;;;sDAIuC;KACnD;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,wBAAwB;QACjC,SAAS,EAAE;;;;;;;;yDAQ0C;KACtD;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA0C;IAE1C,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;IACvG,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,wDAAwD,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG,CAAC;QACT,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,KAAK,GAAG,IAAI,CAAC;QACtB,KAAK,GAAG,CAAC;QACT,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,KAAK,GAAG,KAAK,CAAC;QACvB,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,KAAK,GAAG,MAAM,CAAC;QACxB;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prompts module
+ *
+ * Exports system prompts and utilities for AI-assisted flow creation
+ */
+export { FLOW_GENERATOR_SYSTEM_PROMPT, TEMPLATE_SUGGESTIONS, getTemplateSuggestion, durationToSeconds, } from './flow-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Prompts module
+ *
+ * Exports system prompts and utilities for AI-assisted flow creation
+ */
+export { FLOW_GENERATOR_SYSTEM_PROMPT, TEMPLATE_SUGGESTIONS, getTemplateSuggestion, durationToSeconds, } from './flow-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,66 @@
+import { type McpTool, type ToolResult } from './lib/tool-registry.js';
+/**
+ * Server configuration options
+ */
+export interface ServerOptions {
+    name?: string;
+    version?: string;
+}
+/**
+ * Server capabilities returned during initialization
+ */
+export interface ServerCapabilities {
+    tools: Record<string, never>;
+}
+/**
+ * Kelpi MCP Server
+ *
+ * Provides MCP-compatible tools for managing Kelpi customer engagement automation
+ */
+export declare class KelpiMcpServer {
+    private readonly name;
+    private readonly version;
+    private readonly registry;
+    private server;
+    private transport;
+    private isShuttingDown;
+    constructor(options?: ServerOptions);
+    /**
+     * Register all Kelpi tools with the registry
+     */
+    private registerTools;
+    /**
+     * Get the server name
+     */
+    getName(): string;
+    /**
+     * Get the server version
+     */
+    getVersion(): string;
+    /**
+     * Get server capabilities for MCP initialization
+     */
+    getCapabilities(): ServerCapabilities;
+    /**
+     * List all available tools in MCP format
+     */
+    listTools(): McpTool[];
+    /**
+     * Call a tool by name with given arguments
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<ToolResult>;
+    /**
+     * Start the MCP server with stdio transport
+     */
+    start(): Promise<void>;
+    /**
+     * Gracefully shutdown the server
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create and export a default server instance factory
+ */
+export declare function createServer(options?: ServerOptions): KelpiMcpServer;
+export { TOOL_DEFINITIONS } from './tools/index.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGrF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,GAAE,aAAkB;IASvC;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,eAAe,IAAI,kBAAkB;IAMrC;;OAEG;IACH,SAAS,IAAI,OAAO,EAAE;IAItB;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC;IAQtB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBhC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAEpE;AAGD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/server.js

@@ -0,0 +1,140 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ToolRegistry } from './lib/tool-registry.js';
+import { ALL_TOOLS } from './tools/index.js';
+/**
+ * Kelpi MCP Server
+ *
+ * Provides MCP-compatible tools for managing Kelpi customer engagement automation
+ */
+export class KelpiMcpServer {
+    name;
+    version;
+    registry;
+    server = null;
+    transport = null;
+    isShuttingDown = false;
+    constructor(options = {}) {
+        this.name = options.name ?? 'kelpi-mcp';
+        this.version = options.version ?? '0.1.0';
+        this.registry = new ToolRegistry();
+        // Register all tools
+        this.registerTools();
+    }
+    /**
+     * Register all Kelpi tools with the registry
+     */
+    registerTools() {
+        for (const tool of ALL_TOOLS) {
+            this.registry.register(tool.definition, tool.handler);
+        }
+    }
+    /**
+     * Get the server name
+     */
+    getName() {
+        return this.name;
+    }
+    /**
+     * Get the server version
+     */
+    getVersion() {
+        return this.version;
+    }
+    /**
+     * Get server capabilities for MCP initialization
+     */
+    getCapabilities() {
+        return {
+            tools: {},
+        };
+    }
+    /**
+     * List all available tools in MCP format
+     */
+    listTools() {
+        return this.registry.list();
+    }
+    /**
+     * Call a tool by name with given arguments
+     */
+    async callTool(name, args) {
+        if (!this.registry.has(name)) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        return this.registry.execute(name, args);
+    }
+    /**
+     * Start the MCP server with stdio transport
+     */
+    async start() {
+        this.server = new Server({
+            name: this.name,
+            version: this.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Handle tools/list request
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = this.listTools();
+            return {
+                tools: tools,
+            };
+        });
+        // Handle tools/call request
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                const result = await this.callTool(name, args ?? {});
+                return result;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Create and connect transport
+        this.transport = new StdioServerTransport();
+        await this.server.connect(this.transport);
+    }
+    /**
+     * Gracefully shutdown the server
+     */
+    async shutdown() {
+        if (this.isShuttingDown) {
+            return;
+        }
+        this.isShuttingDown = true;
+        if (this.server) {
+            try {
+                await this.server.close();
+            }
+            catch {
+                // Ignore errors during shutdown
+            }
+            this.server = null;
+        }
+        this.transport = null;
+        this.isShuttingDown = false;
+    }
+}
+/**
+ * Create and export a default server instance factory
+ */
+export function createServer(options) {
+    return new KelpiMcpServer(options);
+}
+// Re-export tool definitions for external use
+export { TOOL_DEFINITIONS } from './tools/index.js';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/auth/index.d.ts

@@ -0,0 +1,18 @@
+import type { ToolWithHandler } from '../../lib/tool-registry.js';
+/**
+ * kelpi_login tool definition and handler
+ *
+ * Initiates browser-based authentication using device code flow.
+ * Returns verification URL and user code for the user to complete authentication.
+ */
+export declare const kelpiLogin: ToolWithHandler;
+/**
+ * kelpi_status tool definition and handler
+ *
+ * Checks current authentication status and returns workspace information.
+ */
+export declare const kelpiStatus: ToolWithHandler;
+export * from './schemas.js';
+export { createLoginHandler, validateVerificationUrl } from './login.js';
+export { createStatusHandler } from './status.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAKlE;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,eAexB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,eAazB,CAAC;AAGF,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}