@bubblelab/shared-schemas 0.1.6 → 0.1.9

package/dist/cron-utils.js

@@ -0,0 +1,228 @@
+/**
+ * Utility functions for parsing and working with cron expressions
+ * Supports standard 5-field cron format: minute hour day month day-of-week
+ */
+/**
+ * Parse a cron expression string into its components
+ * @param cronString - Cron expression (e.g., "0 0 * * *")
+ * @returns Parsed cron expression object
+ */
+export function parseCronExpression(cronString) {
+    const parts = cronString.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new Error(`Invalid cron expression: expected 5 fields, got ${parts.length}`);
+    }
+    const [minute, hour, dayOfMonth, month, dayOfWeek] = parts;
+    return {
+        minute,
+        hour,
+        dayOfMonth,
+        month,
+        dayOfWeek,
+        original: cronString,
+    };
+}
+/**
+ * Validate a cron expression
+ * @param cronString - Cron expression to validate
+ * @returns Object with validation result
+ */
+export function validateCronExpression(cronString) {
+    try {
+        const expr = parseCronExpression(cronString);
+        // Validate each field
+        const validations = [
+            validateCronField(expr.minute, 0, 59, 'minute'),
+            validateCronField(expr.hour, 0, 23, 'hour'),
+            validateCronField(expr.dayOfMonth, 1, 31, 'day of month'),
+            validateCronField(expr.month, 1, 12, 'month'),
+            validateCronField(expr.dayOfWeek, 0, 6, 'day of week'),
+        ];
+        for (const validation of validations) {
+            if (!validation.valid) {
+                return validation;
+            }
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : 'Invalid cron expression',
+        };
+    }
+}
+/**
+ * Validate a single cron field
+ */
+function validateCronField(field, min, max, fieldName) {
+    // Wildcard
+    if (field === '*')
+        return { valid: true };
+    // Step values (*/n)
+    if (field.startsWith('*/')) {
+        const step = parseInt(field.substring(2), 10);
+        if (isNaN(step) || step <= 0) {
+            return {
+                valid: false,
+                error: `Invalid step value in ${fieldName}: ${field}`,
+            };
+        }
+        return { valid: true };
+    }
+    // Ranges (n-m)
+    if (field.includes('-')) {
+        const [start, end] = field.split('-').map((v) => parseInt(v, 10));
+        if (isNaN(start) || isNaN(end) || start < min || end > max || start > end) {
+            return {
+                valid: false,
+                error: `Invalid range in ${fieldName}: ${field} (must be ${min}-${max})`,
+            };
+        }
+        return { valid: true };
+    }
+    // Lists (n,m,o)
+    if (field.includes(',')) {
+        const values = field.split(',').map((v) => parseInt(v.trim(), 10));
+        for (const val of values) {
+            if (isNaN(val) || val < min || val > max) {
+                return {
+                    valid: false,
+                    error: `Invalid value in ${fieldName} list: ${val} (must be ${min}-${max})`,
+                };
+            }
+        }
+        return { valid: true };
+    }
+    // Single value
+    const value = parseInt(field, 10);
+    if (isNaN(value) || value < min || value > max) {
+        return {
+            valid: false,
+            error: `Invalid ${fieldName}: ${field} (must be ${min}-${max})`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Generate a human-readable description of a cron expression
+ * @param cronString - Cron expression to describe
+ * @returns Human-readable description
+ */
+export function describeCronExpression(cronString) {
+    try {
+        const expr = parseCronExpression(cronString);
+        // Common patterns
+        if (cronString === '* * * * *')
+            return 'Every minute';
+        if (cronString === '0 * * * *')
+            return 'Every hour';
+        if (cronString === '0 0 * * *')
+            return 'Daily at midnight';
+        if (cronString === '0 0 * * 0')
+            return 'Weekly on Sunday at midnight';
+        if (cronString === '0 0 1 * *')
+            return 'Monthly on the 1st at midnight';
+        if (cronString === '0 0 1 1 *')
+            return 'Yearly on January 1st at midnight';
+        // Step patterns
+        if (expr.minute.startsWith('*/')) {
+            const step = expr.minute.substring(2);
+            return `Every ${step} minute${step === '1' ? '' : 's'}`;
+        }
+        if (expr.hour.startsWith('*/') && expr.minute === '0') {
+            const step = expr.hour.substring(2);
+            return `Every ${step} hour${step === '1' ? '' : 's'}`;
+        }
+        // Weekday patterns
+        if (expr.dayOfWeek === '1-5' && expr.hour === '9' && expr.minute === '0') {
+            return 'Every weekday at 9:00 AM';
+        }
+        // Build description from parts
+        let description = 'At ';
+        // Time
+        if (expr.minute !== '*' && expr.hour !== '*') {
+            const hour = parseInt(expr.hour, 10);
+            const minute = parseInt(expr.minute, 10);
+            const ampm = hour >= 12 ? 'PM' : 'AM';
+            const hour12 = hour % 12 || 12;
+            description += `${hour12}:${minute.toString().padStart(2, '0')} ${ampm}`;
+        }
+        else if (expr.minute !== '*') {
+            description += `minute ${expr.minute}`;
+        }
+        else if (expr.hour !== '*') {
+            description += `hour ${expr.hour}`;
+        }
+        // Day
+        if (expr.dayOfMonth !== '*') {
+            description += ` on day ${expr.dayOfMonth}`;
+        }
+        if (expr.dayOfWeek !== '*') {
+            const days = [
+                'Sunday',
+                'Monday',
+                'Tuesday',
+                'Wednesday',
+                'Thursday',
+                'Friday',
+                'Saturday',
+            ];
+            if (expr.dayOfWeek.includes('-')) {
+                const [start, end] = expr.dayOfWeek
+                    .split('-')
+                    .map((v) => parseInt(v, 10));
+                description += ` on ${days[start]} through ${days[end]}`;
+            }
+            else {
+                const day = parseInt(expr.dayOfWeek, 10);
+                description += ` on ${days[day]}`;
+            }
+        }
+        // Month
+        if (expr.month !== '*') {
+            const months = [
+                'January',
+                'February',
+                'March',
+                'April',
+                'May',
+                'June',
+                'July',
+                'August',
+                'September',
+                'October',
+                'November',
+                'December',
+            ];
+            const month = parseInt(expr.month, 10);
+            description += ` in ${months[month - 1]}`;
+        }
+        return description;
+    }
+    catch (error) {
+        return 'Invalid cron expression';
+    }
+}
+/**
+ * Get schedule information for a cron expression
+ * @param cronString - Cron expression
+ * @returns Schedule information including description and validation status
+ */
+export function getCronScheduleInfo(cronString) {
+    const validation = validateCronExpression(cronString);
+    if (!validation.valid) {
+        return {
+            expression: parseCronExpression(cronString.split(/\s+/).length === 5 ? cronString : '0 0 * * *'),
+            description: 'Invalid cron expression',
+            isValid: false,
+            error: validation.error,
+        };
+    }
+    return {
+        expression: parseCronExpression(cronString),
+        description: describeCronExpression(cronString),
+        isValid: true,
+    };
+}
+//# sourceMappingURL=cron-utils.js.map

package/dist/cron-utils.js.map

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

package/dist/general-chat.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+/**
+ * Request schema for General Chat agent
+ * General Chat helps users build complete workflows without requiring specific bubbles
+ */
+export declare const GeneralChatRequestSchema: z.ZodObject<{
+    userRequest: z.ZodString;
+    currentCode: z.ZodOptional<z.ZodString>;
+    userName: z.ZodString;
+    conversationHistory: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: "user" | "assistant";
+        content: string;
+    }, {
+        role: "user" | "assistant";
+        content: string;
+    }>, "many">>>;
+    model: z.ZodDefault<z.ZodEnum<["openai/gpt-5", "openai/gpt-5-mini", "openai/gpt-o4-mini", "openai/gpt-4o", "google/gemini-2.5-pro", "google/gemini-2.5-flash", "google/gemini-2.5-flash-lite", "google/gemini-2.5-flash-image-preview", "anthropic/claude-sonnet-4-5-20250929", "openrouter/x-ai/grok-code-fast-1", "openrouter/z-ai/glm-4.5-air"]>>;
+}, "strip", z.ZodTypeAny, {
+    userRequest: string;
+    userName: string;
+    conversationHistory: {
+        role: "user" | "assistant";
+        content: string;
+    }[];
+    model: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-o4-mini" | "openai/gpt-4o" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "anthropic/claude-sonnet-4-5-20250929" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.5-air";
+    currentCode?: string | undefined;
+}, {
+    userRequest: string;
+    userName: string;
+    currentCode?: string | undefined;
+    conversationHistory?: {
+        role: "user" | "assistant";
+        content: string;
+    }[] | undefined;
+    model?: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-o4-mini" | "openai/gpt-4o" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "anthropic/claude-sonnet-4-5-20250929" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.5-air" | undefined;
+}>;
+/**
+ * Response schema for General Chat agent
+ */
+export declare const GeneralChatResponseSchema: z.ZodObject<{
+    type: z.ZodEnum<["code", "question", "reject"]>;
+    message: z.ZodString;
+    snippet: z.ZodOptional<z.ZodString>;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    type: "code" | "question" | "reject";
+    success: boolean;
+    snippet?: string | undefined;
+    error?: string | undefined;
+}, {
+    message: string;
+    type: "code" | "question" | "reject";
+    success: boolean;
+    snippet?: string | undefined;
+    error?: string | undefined;
+}>;
+/**
+ * Internal agent response format (JSON mode output from AI)
+ */
+export declare const GeneralChatAgentOutputSchema: z.ZodObject<{
+    type: z.ZodEnum<["code", "question", "reject"]>;
+    message: z.ZodString;
+    snippet: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    type: "code" | "question" | "reject";
+    snippet?: string | undefined;
+}, {
+    message: string;
+    type: "code" | "question" | "reject";
+    snippet?: string | undefined;
+}>;
+export type GeneralChatRequest = z.infer<typeof GeneralChatRequestSchema>;
+export type GeneralChatResponse = z.infer<typeof GeneralChatResponseSchema>;
+export type GeneralChatAgentOutput = z.infer<typeof GeneralChatAgentOutputSchema>;
+//# sourceMappingURL=general-chat.d.ts.map

package/dist/general-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general-chat.d.ts","sourceRoot":"","sources":["../src/general-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EA0BpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAIvC,CAAC;AAGH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC"}

package/dist/general-chat.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { AvailableModels } from './ai-models.js';
+// Reuse the ConversationMessageSchema from milk-tea to avoid duplication
+const ConversationMessageSchema = z.object({
+    role: z.enum(['user', 'assistant']),
+    content: z.string(),
+});
+/**
+ * Request schema for General Chat agent
+ * General Chat helps users build complete workflows without requiring specific bubbles
+ */
+export const GeneralChatRequestSchema = z.object({
+    userRequest: z
+        .string()
+        .min(1, 'User request is required')
+        .describe('The user request or question about building a workflow'),
+    currentCode: z
+        .string()
+        .optional()
+        .describe('The current workflow code for context and modification'),
+    userName: z.string().describe('Name of the user making the request'),
+    conversationHistory: z
+        .array(ConversationMessageSchema)
+        .optional()
+        .default([])
+        .describe('Previous conversation messages for multi-turn interactions (frontend manages state)'),
+    model: AvailableModels.default('google/gemini-2.5-pro').describe('AI model to use for General Chat agent'),
+});
+/**
+ * Response schema for General Chat agent
+ */
+export const GeneralChatResponseSchema = z.object({
+    type: z
+        .enum(['code', 'question', 'reject'])
+        .describe('Type of response: code (generated workflow), question (needs clarification), reject (infeasible request)'),
+    message: z
+        .string()
+        .describe('Human-readable message: explanation for code, question text, or rejection reason'),
+    snippet: z
+        .string()
+        .optional()
+        .describe('Generated TypeScript code for complete workflow (only present when type is "code")'),
+    success: z.boolean().describe('Whether the operation completed successfully'),
+    error: z
+        .string()
+        .optional()
+        .describe('Error message if the operation failed'),
+});
+/**
+ * Internal agent response format (JSON mode output from AI)
+ */
+export const GeneralChatAgentOutputSchema = z.object({
+    type: z.enum(['code', 'question', 'reject']),
+    message: z.string(),
+    snippet: z.string().optional(),
+});
+// Note: ConversationMessage type is exported from milk-tea.ts to avoid duplication
+//# sourceMappingURL=general-chat.js.map

package/dist/general-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"general-chat.js","sourceRoot":"","sources":["../src/general-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,yEAAyE;AACzE,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;SAClC,QAAQ,CAAC,wDAAwD,CAAC;IAErE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IAErE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAEpE,mBAAmB,EAAE,CAAC;SACnB,KAAK,CAAC,yBAAyB,CAAC;SAChC,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,qFAAqF,CACtF;IAEH,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAC9D,wCAAwC,CACzC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SACpC,QAAQ,CACP,0GAA0G,CAC3G;IAEH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,kFAAkF,CACnF;IAEH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,oFAAoF,CACrF;IAEH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAE7E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAQH,mFAAmF"}

package/dist/generate-bubbleflow-schema.d.ts

@@ -18,19 +18,47 @@ export declare const generateBubbleFlowCodeResponseSchema: z.ZodObject<{
         bubbleName: z.ZodString;
         className: z.ZodString;
         parameters: z.ZodArray<z.ZodObject<{
+            location: z.ZodOptional<z.ZodObject<{
+                startLine: z.ZodNumber;
+                startCol: z.ZodNumber;
+                endLine: z.ZodNumber;
+                endCol: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            }, {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            }>>;
             variableId: z.ZodOptional<z.ZodNumber>;
             name: z.ZodString;
-            value: z.ZodUnknown;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">]>;
             type: z.ZodNativeEnum<typeof BubbleParameterType>;
         }, "strip", z.ZodTypeAny, {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: BubbleParameterType;
             name: string;
-            value?: unknown;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
             variableId?: number | undefined;
         }, {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: BubbleParameterType;
             name: string;
-            value?: unknown;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
             variableId?: number | undefined;
         }>, "many">;
         hasAwait: z.ZodBoolean;
@@ -56,47 +84,59 @@ export declare const generateBubbleFlowCodeResponseSchema: z.ZodObject<{
             endCol: number;
         }>;
     }, "strip", z.ZodTypeAny, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
         variableId: number;
         variableName: string;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
         bubbleName: string;
         className: string;
         parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: BubbleParameterType;
             name: string;
-            value?: unknown;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
             variableId?: number | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
+        nodeType: "unknown" | "service" | "tool" | "workflow";
+        dependencies?: import("./types").BubbleName[] | undefined;
+        dependencyGraph?: import("./bubble-definition-schema").DependencyGraphNode | undefined;
+    }, {
         location: {
             startLine: number;
             startCol: number;
             endLine: number;
             endCol: number;
         };
-        dependencies?: import("./types").BubbleName[] | undefined;
-        dependencyGraph?: import("./bubble-definition-schema").DependencyGraphNode | undefined;
-    }, {
         variableId: number;
         variableName: string;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
         bubbleName: string;
         className: string;
         parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: BubbleParameterType;
             name: string;
-            value?: unknown;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
             variableId?: number | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        location: {
-            startLine: number;
-            startCol: number;
-            endLine: number;
-            endCol: number;
-        };
+        nodeType: "unknown" | "service" | "tool" | "workflow";
         dependencies?: import("./types").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema").DependencyGraphNode | undefined;
     }>>;
@@ -106,25 +146,31 @@ export declare const generateBubbleFlowCodeResponseSchema: z.ZodObject<{
     success: boolean;
     requiredCredentials: Record<string, string[]>;
     bubbleParameters: Record<string, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
         variableId: number;
         variableName: string;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
         bubbleName: string;
         className: string;
         parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: BubbleParameterType;
             name: string;
-            value?: unknown;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
             variableId?: number | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        location: {
-            startLine: number;
-            startCol: number;
-            endLine: number;
-            endCol: number;
-        };
+        nodeType: "unknown" | "service" | "tool" | "workflow";
         dependencies?: import("./types").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema").DependencyGraphNode | undefined;
     }>;
@@ -135,25 +181,31 @@ export declare const generateBubbleFlowCodeResponseSchema: z.ZodObject<{
     success: boolean;
     requiredCredentials: Record<string, string[]>;
     bubbleParameters: Record<string, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
         variableId: number;
         variableName: string;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
         bubbleName: string;
         className: string;
         parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: BubbleParameterType;
             name: string;
-            value?: unknown;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
             variableId?: number | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        location: {
-            startLine: number;
-            startCol: number;
-            endLine: number;
-            endCol: number;
-        };
+        nodeType: "unknown" | "service" | "tool" | "workflow";
         dependencies?: import("./types").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema").DependencyGraphNode | undefined;
     }>;
@@ -388,19 +440,21 @@ export declare const bubbleFlowTemplateResponseSchema: z.ZodObject<{
         active: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        id: number;
         url: string;
+        id: number;
         active: boolean;
     }, {
         path: string;
-        id: number;
         url: string;
+        id: number;
         active: boolean;
     }>>;
 }, "strip", z.ZodTypeAny, {
     description: string;
     name: string;
     id: number;
+    createdAt: string;
+    updatedAt: string;
     eventType: string;
     bubbleParameters: Record<string, {
         variableName: string;
@@ -426,19 +480,19 @@ export declare const bubbleFlowTemplateResponseSchema: z.ZodObject<{
         hasAwait: boolean;
         hasActionCall: boolean;
     }>;
-    createdAt: string;
-    updatedAt: string;
     requiredCredentials?: Record<string, CredentialType[]> | undefined;
     webhook?: {
         path: string;
-        id: number;
         url: string;
+        id: number;
         active: boolean;
     } | undefined;
 }, {
     description: string;
     name: string;
     id: number;
+    createdAt: string;
+    updatedAt: string;
     eventType: string;
     bubbleParameters: Record<string, {
         variableName: string;
@@ -464,13 +518,11 @@ export declare const bubbleFlowTemplateResponseSchema: z.ZodObject<{
         hasAwait: boolean;
         hasActionCall: boolean;
     }>;
-    createdAt: string;
-    updatedAt: string;
     requiredCredentials?: Record<string, CredentialType[]> | undefined;
     webhook?: {
         path: string;
-        id: number;
         url: string;
+        id: number;
         active: boolean;
     } | undefined;
 }>;

package/dist/generate-bubbleflow-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-bubbleflow-schema.d.ts","sourceRoot":"","sources":["../src/generate-bubbleflow-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC,eAAO,MAAM,4BAA4B;;;;;;EAMvC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe/C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CE,CAAC;AAGhD,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4FE,CAAC;AAGxD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiGL,CAAC;AACzC,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,wCAAwC,CAChD,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC"}
+{"version":3,"file":"generate-bubbleflow-schema.d.ts","sourceRoot":"","sources":["../src/generate-bubbleflow-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC,eAAO,MAAM,4BAA4B;;;;;;EAMvC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe/C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CE,CAAC;AAGhD,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4FE,CAAC;AAGxD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiGL,CAAC;AACzC,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,wCAAwC,CAChD,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC"}

package/dist/index.d.ts

@@ -13,4 +13,7 @@ export * from './generate-bubbleflow-schema.js';
 export * from './webhook-schema.js';
 export * from './subscription-status-schema.js';
 export * from './api-schema.js';
+export * from './milk-tea.js';
+export * from './pearl.js';
+export * from './ai-models.js';
 //# sourceMappingURL=index.d.ts.map