@kelpi/mcp 0.1.0

package/dist/tools/contacts/index.js

@@ -0,0 +1,40 @@
+import { createContactInputSchema } from './schemas.js';
+import { createContactHandler } from './create.js';
+/**
+ * kelpi_create_contact tool definition and handler
+ *
+ * Creates a new contact or updates an existing one.
+ */
+export const kelpiCreateContact = {
+    definition: {
+        name: 'kelpi_create_contact',
+        description: `Create a new contact with properties and traits.
+
+This tool creates a contact in your Kelpi workspace. A contact represents a user or customer that you want to track and engage with.
+
+Requirements:
+- At least one identifier (email or external_id) is required
+- If email is provided, it must be a valid email format
+- Properties can include any custom data about the contact
+
+Example usage:
+{
+  "email": "user@example.com",
+  "external_id": "user_123",
+  "properties": {
+    "firstName": "John",
+    "lastName": "Doe",
+    "plan": "premium"
+  }
+}
+
+Returns the created contact with its ID and timestamps.`,
+        inputSchema: createContactInputSchema,
+    },
+    handler: createContactHandler,
+};
+// Re-export schemas
+export * from './schemas.js';
+// Re-export handler factories for testing
+export { createCreateContactHandler } from './create.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/contacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/contacts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,UAAU,EAAE;QACV,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;wDAoBuC;QACpD,WAAW,EAAE,wBAAwB;KACtC;IACD,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,oBAAoB;AACpB,cAAc,cAAc,CAAC;AAE7B,0CAA0C;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/contacts/schemas.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * Schema for creating a contact
+ * At least one of email or external_id is required (validated in handler)
+ *
+ * Note: We don't use .refine() here because it produces ZodEffects which
+ * doesn't convert to valid JSON Schema for MCP tool definitions.
+ * The "at least one identifier" validation is done in the handler.
+ */
+export declare const createContactInputSchema: z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodString>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    email?: string | undefined;
+    external_id?: string | undefined;
+    properties?: Record<string, unknown> | undefined;
+}, {
+    email?: string | undefined;
+    external_id?: string | undefined;
+    properties?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Contact response from API
+ */
+export interface ContactResponse {
+    id: string;
+    email?: string;
+    external_id?: string;
+    properties?: Record<string, unknown>;
+    created_at: string;
+}
+/**
+ * Type exports
+ */
+export type CreateContactInput = z.infer<typeof createContactInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/contacts/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/contacts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/tools/contacts/schemas.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+/**
+ * Schema for creating a contact
+ * At least one of email or external_id is required (validated in handler)
+ *
+ * Note: We don't use .refine() here because it produces ZodEffects which
+ * doesn't convert to valid JSON Schema for MCP tool definitions.
+ * The "at least one identifier" validation is done in the handler.
+ */
+export const createContactInputSchema = z.object({
+    email: z.string().email('Invalid email format').optional(),
+    external_id: z.string().optional(),
+    properties: z.record(z.unknown()).optional().describe('Custom properties for the contact'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/contacts/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/contacts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC3F,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { ToolWithHandler } from '../../lib/tool-registry.js';
+/**
+ * kelpi_track_event tool definition and handler
+ *
+ * Tracks a custom event for a contact.
+ */
+export declare const kelpiTrackEvent: ToolWithHandler;
+export * from './schemas.js';
+export { createTrackEventHandler } from './track.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,eA6B7B,CAAC;AAGF,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/events/index.js

@@ -0,0 +1,42 @@
+import { trackEventInputSchema } from './schemas.js';
+import { trackEventHandler } from './track.js';
+/**
+ * kelpi_track_event tool definition and handler
+ *
+ * Tracks a custom event for a contact.
+ */
+export const kelpiTrackEvent = {
+    definition: {
+        name: 'kelpi_track_event',
+        description: `Track a custom event for a contact.
+
+This tool records an event associated with a contact in your Kelpi workspace. Events are used to trigger automations, build segments, and analyze user behavior.
+
+Requirements:
+- event_name is required (e.g., "user.signed_up", "purchase.completed")
+- user_id is required (the unique identifier for the contact)
+- email is optional (for contact enrichment)
+- properties can include any custom data about the event
+
+Example usage:
+{
+  "event_name": "purchase.completed",
+  "user_id": "user_123",
+  "email": "user@example.com",
+  "properties": {
+    "order_id": "ord_123",
+    "amount": 99.99,
+    "currency": "USD"
+  }
+}
+
+Returns a success response when the event is tracked.`,
+        inputSchema: trackEventInputSchema,
+    },
+    handler: trackEventHandler,
+};
+// Re-export schemas
+export * from './schemas.js';
+// Re-export handler factories for testing
+export { createTrackEventHandler } from './track.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/events/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,UAAU,EAAE;QACV,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;sDAsBqC;QAClD,WAAW,EAAE,qBAAqB;KACnC;IACD,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AAEF,oBAAoB;AACpB,cAAc,cAAc,CAAC;AAE7B,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/events/schemas.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * Schema for tracking an event
+ *
+ * Matches the API contract in src/lib/schemas/track.ts:
+ * - user_id is REQUIRED (contact identifier)
+ * - email is optional (for contact enrichment)
+ * - event_name is required
+ * - properties is optional
+ */
+export declare const trackEventInputSchema: z.ZodObject<{
+    event_name: z.ZodString;
+    user_id: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+    properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    event_name: string;
+    user_id: string;
+    email?: string | undefined;
+    properties?: Record<string, unknown> | undefined;
+}, {
+    event_name: string;
+    user_id: string;
+    email?: string | undefined;
+    properties?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Track event response from API
+ */
+export interface TrackEventResponse {
+    success: boolean;
+}
+/**
+ * Type exports
+ */
+export type TrackEventInput = z.infer<typeof trackEventInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/events/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/events/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/tools/events/schemas.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+/**
+ * Schema for tracking an event
+ *
+ * Matches the API contract in src/lib/schemas/track.ts:
+ * - user_id is REQUIRED (contact identifier)
+ * - email is optional (for contact enrichment)
+ * - event_name is required
+ * - properties is optional
+ */
+export const trackEventInputSchema = z.object({
+    event_name: z.string().min(1, 'event_name is required'),
+    user_id: z.string().min(1, 'user_id is required'),
+    email: z.string().email().optional(),
+    properties: z.record(z.unknown()).optional().describe('Additional event properties'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/events/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/events/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CACrF,CAAC,CAAC"}

package/dist/tools/events/track.d.ts

@@ -0,0 +1,11 @@
+import type { ToolHandler } from '../../lib/tool-registry.js';
+/**
+ * Creates a track event handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export declare function createTrackEventHandler(): ToolHandler;
+/**
+ * Default track event handler
+ */
+export declare const trackEventHandler: ToolHandler;
+//# sourceMappingURL=track.d.ts.map

package/dist/tools/events/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../../src/tools/events/track.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,4BAA4B,CAAC;AAS1E;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CA+BrD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAA4B,CAAC"}

package/dist/tools/events/track.js

@@ -0,0 +1,41 @@
+import { withAuth, successResponse, validationErrorResponse, handleApiError, } from '../../lib/tool-helpers.js';
+import { trackEventInputSchema } from './schemas.js';
+/**
+ * Creates a track event handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export function createTrackEventHandler() {
+    return async (input) => {
+        // Validate input using Zod schema
+        const validationResult = trackEventInputSchema.safeParse(input);
+        if (!validationResult.success) {
+            return validationErrorResponse(validationResult.error);
+        }
+        return withAuth('tracking events', async ({ client }) => {
+            try {
+                const { email, user_id, event_name, properties } = validationResult.data;
+                // Build request body according to API specification
+                const body = {
+                    contact: {
+                        ...(email && { email }),
+                        ...(user_id && { user_id }),
+                    },
+                    event: {
+                        name: event_name,
+                        ...(properties && { properties }),
+                    },
+                };
+                const response = await client.post('/api/v1/track', body);
+                return successResponse(response.data);
+            }
+            catch (err) {
+                return handleApiError(err, 'track event');
+            }
+        });
+    };
+}
+/**
+ * Default track event handler
+ */
+export const trackEventHandler = createTrackEventHandler();
+//# sourceMappingURL=track.js.map

package/dist/tools/events/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","sourceRoot":"","sources":["../../../src/tools/events/track.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,uBAAuB,EACvB,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAA2B,MAAM,cAAc,CAAC;AAE9E;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,KAAK,EAAE,KAA8B,EAAuB,EAAE;QACnE,kCAAkC;QAClC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO,uBAAuB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,QAAQ,CAAC,iBAAiB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YACtD,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC;gBAEzE,oDAAoD;gBACpD,MAAM,IAAI,GAAG;oBACX,OAAO,EAAE;wBACP,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;wBACvB,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;qBAC5B;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,UAAU;wBAChB,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,CAAC;qBAClC;iBACF,CAAC;gBAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAqB,eAAe,EAAE,IAAI,CAAC,CAAC;gBAC9E,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,EAAE,CAAC"}

package/dist/tools/flows/activate.d.ts

@@ -0,0 +1,11 @@
+import type { ToolHandler } from '../../lib/tool-registry.js';
+/**
+ * Creates an activate flow handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export declare function createActivateFlowHandler(): ToolHandler;
+/**
+ * Default activate flow handler
+ */
+export declare const activateFlowHandler: ToolHandler;
+//# sourceMappingURL=activate.d.ts.map

package/dist/tools/flows/activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.d.ts","sourceRoot":"","sources":["../../../src/tools/flows/activate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,4BAA4B,CAAC;AAW1E;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,CAmCvD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAA8B,CAAC"}

package/dist/tools/flows/activate.js

@@ -0,0 +1,46 @@
+import { ApiError } from '../../lib/api-client.js';
+import { withAuth, successResponse, validationErrorResponse, errorResponse, unknownErrorResponse, } from '../../lib/tool-helpers.js';
+import { activateFlowInputSchema } from './schemas.js';
+/**
+ * Creates an activate flow handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export function createActivateFlowHandler() {
+    return async (input) => {
+        // Validate input using Zod schema
+        const validationResult = activateFlowInputSchema.safeParse(input);
+        if (!validationResult.success) {
+            return validationErrorResponse(validationResult.error, 'flow_id must be a valid UUID');
+        }
+        const { flow_id } = validationResult.data;
+        return withAuth('activating flows', async ({ client }) => {
+            try {
+                const response = await client.put(`/api/v1/flows/${flow_id}/activate`);
+                return successResponse(response.data);
+            }
+            catch (err) {
+                if (err instanceof ApiError) {
+                    let message = err.message;
+                    let hint;
+                    if (err.status === 404) {
+                        message = 'Flow not found';
+                        hint = `No flow exists with ID "${flow_id}"`;
+                    }
+                    else if (err.status === 400) {
+                        hint = 'Ensure the flow has steps and is not archived';
+                    }
+                    return errorResponse('Failed to activate flow', message, {
+                        status: err.status,
+                        ...(hint && { hint }),
+                    });
+                }
+                return unknownErrorResponse(err, 'activate flow');
+            }
+        });
+    };
+}
+/**
+ * Default activate flow handler
+ */
+export const activateFlowHandler = createActivateFlowHandler();
+//# sourceMappingURL=activate.js.map

package/dist/tools/flows/activate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate.js","sourceRoot":"","sources":["../../../src/tools/flows/activate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EACL,QAAQ,EACR,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAqB,MAAM,cAAc,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,KAAK,EAAE,KAA8B,EAAuB,EAAE;QACnE,kCAAkC;QAClC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO,uBAAuB,CAAC,gBAAgB,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC;QAE1C,OAAO,QAAQ,CAAC,kBAAkB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAe,iBAAiB,OAAO,WAAW,CAAC,CAAC;gBACrF,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;oBAC5B,IAAI,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;oBAC1B,IAAI,IAAwB,CAAC;oBAE7B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACvB,OAAO,GAAG,gBAAgB,CAAC;wBAC3B,IAAI,GAAG,2BAA2B,OAAO,GAAG,CAAC;oBAC/C,CAAC;yBAAM,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBAC9B,IAAI,GAAG,+CAA+C,CAAC;oBACzD,CAAC;oBAED,OAAO,aAAa,CAAC,yBAAyB,EAAE,OAAO,EAAE;wBACvD,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,oBAAoB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/tools/flows/create.d.ts

@@ -0,0 +1,11 @@
+import type { ToolHandler } from '../../lib/tool-registry.js';
+/**
+ * Creates a create flow handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export declare function createCreateFlowHandler(): ToolHandler;
+/**
+ * Default create flow handler
+ */
+export declare const createFlowHandler: ToolHandler;
+//# sourceMappingURL=create.d.ts.map

package/dist/tools/flows/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/tools/flows/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,4BAA4B,CAAC;AAW1E;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAmFrD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAA4B,CAAC"}

package/dist/tools/flows/create.js

@@ -0,0 +1,72 @@
+import { withAuth, successResponse, validationErrorResponse, errorResponse, handleApiError, } from '../../lib/tool-helpers.js';
+import { flowDefinitionSchema } from './schemas.js';
+import { transformFlowDefinition } from './transform.js';
+/**
+ * Creates a create flow handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export function createCreateFlowHandler() {
+    return async (input) => {
+        // Validate input definition
+        const definition = input.definition;
+        if (!definition) {
+            return errorResponse('Validation failed', 'definition is required');
+        }
+        // Validate the flow definition using Zod schema
+        const validationResult = flowDefinitionSchema.safeParse(definition);
+        if (!validationResult.success) {
+            return validationErrorResponse(validationResult.error, 'Invalid flow definition');
+        }
+        const data = validationResult.data;
+        // Custom validations (can't use .refine() as it breaks JSON Schema conversion for MCP)
+        // 1. If trigger_type is 'event', trigger_event is required
+        if (data.trigger_type === 'event' && !data.trigger_event) {
+            return errorResponse('Validation failed', 'trigger_event is required when trigger_type is "event"');
+        }
+        // 2. If trigger_type is 'segment', trigger_segment_id is required
+        if (data.trigger_type === 'segment' && !data.trigger_segment_id) {
+            return errorResponse('Validation failed', 'trigger_segment_id is required when trigger_type is "segment"');
+        }
+        // 3. Check for duplicate step_ids
+        const stepIds = data.steps.map((step) => step.step_id);
+        const uniqueIds = new Set(stepIds);
+        if (stepIds.length !== uniqueIds.size) {
+            return errorResponse('Validation failed', 'Duplicate step_id found in steps array');
+        }
+        // 4. Validate webhook URLs are valid HTTPS URLs with hostnames
+        for (const step of data.steps) {
+            if (step.action_type === 'webhook' && step.webhook_url) {
+                try {
+                    const webhookUrl = new URL(step.webhook_url);
+                    if (webhookUrl.protocol !== 'https:') {
+                        return errorResponse('Validation failed', `Webhook URL must use HTTPS: ${step.webhook_url}`);
+                    }
+                    if (!webhookUrl.hostname) {
+                        return errorResponse('Validation failed', `Webhook URL must include a hostname: ${step.webhook_url}`);
+                    }
+                }
+                catch {
+                    return errorResponse('Validation failed', `Invalid webhook URL format: ${step.webhook_url}`);
+                }
+            }
+        }
+        // Transform the definition to normalize operators and filter structures
+        // This handles common shorthand like "eq" -> "equals", "gt" -> "greater_than"
+        // and ensures condition_filter groups have the required type: "group" property
+        const transformedData = transformFlowDefinition(data);
+        return withAuth('creating flows', async ({ client }) => {
+            try {
+                const response = await client.post('/api/v1/flows', transformedData);
+                return successResponse(response.data);
+            }
+            catch (err) {
+                return handleApiError(err, 'create flow');
+            }
+        });
+    };
+}
+/**
+ * Default create flow handler
+ */
+export const createFlowHandler = createCreateFlowHandler();
+//# sourceMappingURL=create.js.map

package/dist/tools/flows/create.js.map

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

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

@@ -0,0 +1,24 @@
+import type { ToolWithHandler } from '../../lib/tool-registry.js';
+/**
+ * kelpi_create_flow tool definition and handler
+ *
+ * Creates a new automation flow from a JSON definition.
+ */
+export declare const kelpiCreateFlow: ToolWithHandler;
+/**
+ * kelpi_list_flows tool definition and handler
+ *
+ * Lists all flows in the workspace with optional filtering.
+ */
+export declare const kelpiListFlows: ToolWithHandler;
+/**
+ * kelpi_activate_flow tool definition and handler
+ *
+ * Activates a draft flow so it starts processing events.
+ */
+export declare const kelpiActivateFlow: ToolWithHandler;
+export * from './schemas.js';
+export { createCreateFlowHandler } from './create.js';
+export { createListFlowsHandler } from './list.js';
+export { createActivateFlowHandler } from './activate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/flows/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAUlE;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,eAiH7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,eAsB5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAmB/B,CAAC;AAGF,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}