@bubblelab/shared-schemas 0.1.8 → 0.1.10

package/dist/generation-result-schema.js

@@ -0,0 +1,55 @@
+import { z } from '@hono/zod-openapi';
+import { CredentialType } from './types.js';
+import { TokenUsageSchema } from './bubbleflow-execution-schema.js';
+/**
+ * Generation result schema that matches the BubbleFlow generator workflow result
+ * but includes additional fields for the frontend generation store
+ */
+export const GenerationResultSchema = z.object({
+    // Core generation fields (matching BubbleFlowGeneratorResultSchema)
+    generatedCode: z.string().openapi({
+        description: 'The generated BubbleFlow TypeScript code',
+    }),
+    isValid: z.boolean().openapi({
+        description: 'Whether the generated code is valid',
+    }),
+    success: z.boolean().openapi({
+        description: 'Whether the generation was successful',
+    }),
+    error: z.string().openapi({
+        description: 'Error message if generation failed',
+    }),
+    toolCalls: z.array(z.any()).openapi({
+        description: 'The tool calls made by the AI agent',
+    }),
+    summary: z.string().openapi({
+        description: 'High-level instructions for using the validated flow',
+    }),
+    inputsSchema: z.string().openapi({
+        description: 'JSON Schema (string) representing the inputs of the flow',
+    }),
+    // Additional fields for frontend generation store
+    tokenUsage: TokenUsageSchema.openapi({
+        description: 'Token usage information for the generation',
+    }),
+    codeLength: z.number().openapi({
+        description: 'Length of the generated code in characters',
+        example: 2500,
+    }),
+    bubbleCount: z.number().openapi({
+        description: 'Number of bubbles used in the generated flow',
+        example: 3,
+    }),
+    flowId: z.number().openapi({
+        description: 'ID of the created flow in the database',
+        example: 123,
+    }),
+    requiredCredentials: z.record(z.string(), z.array(z.nativeEnum(CredentialType))).openapi({
+        description: 'Required credentials for the bubbles in the generated code',
+        example: {
+            'database-connection': [CredentialType.DATABASE_CRED],
+            'slack-notification': [CredentialType.SLACK_CRED],
+        },
+    }),
+});
+//# sourceMappingURL=generation-result-schema.js.map

package/dist/generation-result-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-result-schema.js","sourceRoot":"","sources":["../src/generation-result-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,oEAAoE;IACpE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAChC,WAAW,EAAE,0CAA0C;KACxD,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QAC3B,WAAW,EAAE,qCAAqC;KACnD,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QAC3B,WAAW,EAAE,uCAAuC;KACrD,CAAC;IACF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QACxB,WAAW,EAAE,oCAAoC;KAClD,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC;QAClC,WAAW,EAAE,qCAAqC;KACnD,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAC1B,WAAW,EAAE,sDAAsD;KACpE,CAAC;IACF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAC/B,WAAW,EAAE,0DAA0D;KACxE,CAAC;IAEF,kDAAkD;IAClD,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACnC,WAAW,EAAE,4CAA4C;KAC1D,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAC7B,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,IAAI;KACd,CAAC;IACF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAC9B,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,CAAC;KACX,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QACzB,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,GAAG;KACb,CAAC;IACF,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACvF,WAAW,EAAE,4DAA4D;QACzE,OAAO,EAAE;YACP,qBAAqB,EAAE,CAAC,cAAc,CAAC,aAAa,CAAC;YACrD,oBAAoB,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC;SAClD;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -13,4 +13,10 @@ 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';
+export * from './cron-utils.js';
+export * from './trigger.js';
+export * from './bubbleflow-generation-prompts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC"}

package/dist/index.js

@@ -15,4 +15,10 @@ 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';
+export * from './cron-utils.js';
+export * from './trigger.js';
+export * from './bubbleflow-generation-prompts.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,6CAA6C;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,6CAA6C;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC"}

package/dist/milk-tea.d.ts

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+/**
+ * Conversation message schema for milk tea multi-turn conversations
+ */
+declare const ConversationMessageSchema: z.ZodObject<{
+    role: z.ZodEnum<["user", "assistant"]>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    role: "user" | "assistant";
+}, {
+    content: string;
+    role: "user" | "assistant";
+}>;
+/**
+ * Request schema for Milk Tea agent
+ * Milk Tea helps users configure bubble parameters through conversation
+ */
+export declare const MilkTeaRequestSchema: z.ZodObject<{
+    userRequest: z.ZodString;
+    bubbleName: z.ZodString;
+    bubbleSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    currentCode: z.ZodOptional<z.ZodString>;
+    availableCredentials: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    userName: z.ZodString;
+    insertLocation: z.ZodOptional<z.ZodString>;
+    conversationHistory: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        role: "user" | "assistant";
+    }, {
+        content: string;
+        role: "user" | "assistant";
+    }>, "many">>>;
+    model: z.ZodDefault<z.ZodEnum<["openai/gpt-5", "openai/gpt-5-mini", "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", "anthropic/claude-haiku-4-5", "openrouter/x-ai/grok-code-fast-1", "openrouter/z-ai/glm-4.6"]>>;
+}, "strip", z.ZodTypeAny, {
+    bubbleName: string;
+    model: "openai/gpt-5" | "openai/gpt-5-mini" | "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" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6";
+    userRequest: string;
+    bubbleSchema: Record<string, unknown>;
+    availableCredentials: string[];
+    userName: string;
+    conversationHistory: {
+        content: string;
+        role: "user" | "assistant";
+    }[];
+    currentCode?: string | undefined;
+    insertLocation?: string | undefined;
+}, {
+    bubbleName: string;
+    userRequest: string;
+    bubbleSchema: Record<string, unknown>;
+    userName: string;
+    model?: "openai/gpt-5" | "openai/gpt-5-mini" | "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" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | undefined;
+    currentCode?: string | undefined;
+    availableCredentials?: string[] | undefined;
+    insertLocation?: string | undefined;
+    conversationHistory?: {
+        content: string;
+        role: "user" | "assistant";
+    }[] | undefined;
+}>;
+/**
+ * Response schema for Milk Tea agent
+ */
+export declare const MilkTeaResponseSchema: 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;
+    error?: string | undefined;
+    snippet?: string | undefined;
+}, {
+    message: string;
+    type: "code" | "question" | "reject";
+    success: boolean;
+    error?: string | undefined;
+    snippet?: string | undefined;
+}>;
+/**
+ * Internal agent response format (JSON mode output from AI)
+ */
+export declare const MilkTeaAgentOutputSchema: 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 MilkTeaRequest = z.infer<typeof MilkTeaRequestSchema>;
+export type MilkTeaResponse = z.infer<typeof MilkTeaResponseSchema>;
+export type MilkTeaAgentOutput = z.infer<typeof MilkTeaAgentOutputSchema>;
+export type ConversationMessage = z.infer<typeof ConversationMessageSchema>;
+export {};
+//# sourceMappingURL=milk-tea.d.ts.map

package/dist/milk-tea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milk-tea.d.ts","sourceRoot":"","sources":["../src/milk-tea.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,QAAA,MAAM,yBAAyB;;;;;;;;;EAG7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6C/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EA0BhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAGH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,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"}

package/dist/milk-tea.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { AvailableModels } from './ai-models.js';
+/**
+ * Conversation message schema for milk tea multi-turn conversations
+ */
+const ConversationMessageSchema = z.object({
+    role: z.enum(['user', 'assistant']),
+    content: z.string(),
+});
+/**
+ * Request schema for Milk Tea agent
+ * Milk Tea helps users configure bubble parameters through conversation
+ */
+export const MilkTeaRequestSchema = z.object({
+    userRequest: z
+        .string()
+        .min(1, 'User request is required')
+        .describe('The user request or question about configuring the bubble'),
+    bubbleName: z
+        .string()
+        .min(1, 'Bubble name is required')
+        .describe('The name of the bubble to configure (e.g., "email-tool")'),
+    bubbleSchema: z
+        .record(z.unknown())
+        .describe('The full schema/interface definition of the bubble including parameters and types'),
+    currentCode: z
+        .string()
+        .optional()
+        .describe('The current workflow code context for validation'),
+    availableCredentials: z
+        .array(z.string())
+        .default([])
+        .describe('List of credential types available to the user'),
+    userName: z.string().describe('Name of the user making the request'),
+    insertLocation: z
+        .string()
+        .optional()
+        .describe('Location in code where the snippet should be inserted'),
+    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 Milk Tea agent'),
+});
+/**
+ * Response schema for Milk Tea agent
+ */
+export const MilkTeaResponseSchema = z.object({
+    type: z
+        .enum(['code', 'question', 'reject'])
+        .describe('Type of response: code (generated snippet), 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 snippet (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 MilkTeaAgentOutputSchema = z.object({
+    type: z.enum(['code', 'question', 'reject']),
+    message: z.string(),
+    snippet: z.string().optional(),
+});
+//# sourceMappingURL=milk-tea.js.map

package/dist/milk-tea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milk-tea.js","sourceRoot":"","sources":["../src/milk-tea.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,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,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;SAClC,QAAQ,CAAC,2DAA2D,CAAC;IAExE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,QAAQ,CAAC,0DAA0D,CAAC;IAEvE,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,CACP,mFAAmF,CACpF;IAEH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAE/D,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,gDAAgD,CAAC;IAE7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAEpE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,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,oCAAoC,CACrC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SACpC,QAAQ,CACP,yGAAyG,CAC1G;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,sEAAsE,CACvE;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,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,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"}

package/dist/pearl.d.ts

@@ -0,0 +1,279 @@
+import { z } from 'zod';
+import { CredentialType } from './types.js';
+/**
+ * Request schema for Pearl agent
+ * Pearl helps users build complete workflows without requiring specific bubbles
+ */
+export declare const PearlRequestSchema: z.ZodObject<{
+    userRequest: z.ZodString;
+    currentCode: z.ZodOptional<z.ZodString>;
+    userName: z.ZodString;
+    availableVariables: z.ZodArray<z.ZodAny, "many">;
+    conversationHistory: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        role: "user" | "assistant";
+    }, {
+        content: string;
+        role: "user" | "assistant";
+    }>, "many">>>;
+    model: z.ZodDefault<z.ZodEnum<["openai/gpt-5", "openai/gpt-5-mini", "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", "anthropic/claude-haiku-4-5", "openrouter/x-ai/grok-code-fast-1", "openrouter/z-ai/glm-4.6"]>>;
+    additionalContext: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    model: "openai/gpt-5" | "openai/gpt-5-mini" | "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" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6";
+    userRequest: string;
+    userName: string;
+    conversationHistory: {
+        content: string;
+        role: "user" | "assistant";
+    }[];
+    availableVariables: any[];
+    currentCode?: string | undefined;
+    additionalContext?: string | undefined;
+}, {
+    userRequest: string;
+    userName: string;
+    availableVariables: any[];
+    model?: "openai/gpt-5" | "openai/gpt-5-mini" | "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" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | undefined;
+    currentCode?: string | undefined;
+    conversationHistory?: {
+        content: string;
+        role: "user" | "assistant";
+    }[] | undefined;
+    additionalContext?: string | undefined;
+}>;
+/**
+ * Response schema for Pearl agent
+ */
+export declare const PearlResponseSchema: z.ZodObject<{
+    type: z.ZodEnum<["code", "question", "reject"]>;
+    message: z.ZodString;
+    snippet: z.ZodOptional<z.ZodString>;
+    bubbleParameters: z.ZodOptional<z.ZodRecord<z.ZodNumber, z.ZodObject<{
+        variableName: z.ZodString;
+        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.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown, "many">]>;
+            type: z.ZodNativeEnum<typeof import("./bubble-definition-schema.js").BubbleParameterType>;
+        }, "strip", z.ZodTypeAny, {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
+            type: import("./bubble-definition-schema.js").BubbleParameterType;
+            name: string;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
+            variableId?: number | undefined;
+        }, {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
+            type: import("./bubble-definition-schema.js").BubbleParameterType;
+            name: string;
+            location?: {
+                startLine: number;
+                startCol: number;
+                endLine: number;
+                endCol: number;
+            } | undefined;
+            variableId?: number | undefined;
+        }>, "many">;
+        hasAwait: z.ZodBoolean;
+        hasActionCall: z.ZodBoolean;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodType<import("./types.js").BubbleName, z.ZodTypeDef, import("./types.js").BubbleName>, "many">>;
+        dependencyGraph: z.ZodOptional<z.ZodType<import("./bubble-definition-schema.js").DependencyGraphNode, z.ZodTypeDef, import("./bubble-definition-schema.js").DependencyGraphNode>>;
+        variableId: z.ZodNumber;
+        nodeType: z.ZodEnum<["service", "tool", "workflow", "unknown"]>;
+        location: 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;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
+        variableId: number;
+        variableName: string;
+        bubbleName: string;
+        className: string;
+        parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
+            type: import("./bubble-definition-schema.js").BubbleParameterType;
+            name: string;
+            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.js").BubbleName[] | undefined;
+        dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+    }, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
+        variableId: number;
+        variableName: string;
+        bubbleName: string;
+        className: string;
+        parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
+            type: import("./bubble-definition-schema.js").BubbleParameterType;
+            name: string;
+            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.js").BubbleName[] | undefined;
+        dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+    }>>>;
+    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    requiredCredentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNativeEnum<typeof CredentialType>, "many">>>;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    type: "code" | "question" | "reject";
+    success: boolean;
+    error?: string | undefined;
+    inputSchema?: Record<string, unknown> | undefined;
+    requiredCredentials?: Record<string, CredentialType[]> | undefined;
+    bubbleParameters?: Record<number, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
+        variableId: number;
+        variableName: string;
+        bubbleName: string;
+        className: string;
+        parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
+            type: import("./bubble-definition-schema.js").BubbleParameterType;
+            name: string;
+            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.js").BubbleName[] | undefined;
+        dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+    }> | undefined;
+    snippet?: string | undefined;
+}, {
+    message: string;
+    type: "code" | "question" | "reject";
+    success: boolean;
+    error?: string | undefined;
+    inputSchema?: Record<string, unknown> | undefined;
+    requiredCredentials?: Record<string, CredentialType[]> | undefined;
+    bubbleParameters?: Record<number, {
+        location: {
+            startLine: number;
+            startCol: number;
+            endLine: number;
+            endCol: number;
+        };
+        variableId: number;
+        variableName: string;
+        bubbleName: string;
+        className: string;
+        parameters: {
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
+            type: import("./bubble-definition-schema.js").BubbleParameterType;
+            name: string;
+            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.js").BubbleName[] | undefined;
+        dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+    }> | undefined;
+    snippet?: string | undefined;
+}>;
+/**
+ * Internal agent response format (JSON mode output from AI)
+ */
+export declare const PearlAgentOutputSchema: 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 PearlRequest = z.infer<typeof PearlRequestSchema>;
+export type PearlResponse = z.infer<typeof PearlResponseSchema>;
+export type PearlAgentOutput = z.infer<typeof PearlAgentOutputSchema>;
+//# sourceMappingURL=pearl.d.ts.map

package/dist/pearl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pearl.d.ts","sourceRoot":"","sources":["../src/pearl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQ5C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+C9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAGH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/pearl.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { AvailableModels } from './ai-models.js';
+import { ParsedBubbleWithInfoSchema } from './bubble-definition-schema.js';
+import { CredentialType } from './types.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 Pearl agent
+ * Pearl helps users build complete workflows without requiring specific bubbles
+ */
+export const PearlRequestSchema = 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'),
+    availableVariables: z
+        .array(z.any())
+        .describe('List of available variables in the current code'),
+    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 Pearl agent'),
+    additionalContext: z
+        .string()
+        .optional()
+        .describe('Additional context information like timezone, user preferences, etc.'),
+});
+/**
+ * Response schema for Pearl agent
+ */
+export const PearlResponseSchema = 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")'),
+    bubbleParameters: z
+        .record(z.number(), ParsedBubbleWithInfoSchema)
+        .optional()
+        .describe('Parsed bubble parameters from the generated workflow (only present when type is "code")'),
+    inputSchema: z
+        .record(z.unknown())
+        .optional()
+        .describe('Input schema for the generated workflow (only present when type is "code")'),
+    requiredCredentials: z
+        .record(z.string(), z.array(z.nativeEnum(CredentialType)))
+        .optional()
+        .describe('Required credentials for the bubbles in the 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 PearlAgentOutputSchema = 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=pearl.js.map

package/dist/pearl.js.map

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