@bubblelab/shared-schemas 0.1.10 → 0.1.12

package/dist/pearl.d.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
+import { type AvailableModel } from './ai-models.js';
 import { CredentialType } from './types.js';
+export declare const PEARL_DEFAULT_MODEL: AvailableModel;
 /**
  * Request schema for Pearl agent
  * Pearl helps users build complete workflows without requiring specific bubbles
@@ -10,50 +12,83 @@ export declare const PearlRequestSchema: z.ZodObject<{
     userName: z.ZodString;
     availableVariables: z.ZodArray<z.ZodAny, "many">;
     conversationHistory: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-        role: z.ZodEnum<["user", "assistant"]>;
+        role: z.ZodEnum<["user", "assistant", "tool"]>;
         content: z.ZodString;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         content: string;
-        role: "user" | "assistant";
+        role: "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
     }, {
         content: string;
-        role: "user" | "assistant";
+        role: "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
     }>, "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"]>>;
+    model: z.ZodDefault<z.ZodEnum<["openai/gpt-5", "openai/gpt-5-mini", "openai/gpt-5.1", "openai/gpt-5.2", "google/gemini-2.5-pro", "google/gemini-2.5-flash", "google/gemini-2.5-flash-lite", "google/gemini-2.5-flash-image-preview", "google/gemini-3-pro-preview", "google/gemini-3-pro-image-preview", "google/gemini-3-flash-preview", "anthropic/claude-sonnet-4-5", "anthropic/claude-opus-4-5", "anthropic/claude-haiku-4-5", "openrouter/x-ai/grok-code-fast-1", "openrouter/z-ai/glm-4.6", "openrouter/anthropic/claude-sonnet-4.5", "openrouter/google/gemini-3-pro-preview", "openrouter/morph/morph-v3-large", "openrouter/x-ai/grok-4.1-fast", "openrouter/openai/gpt-oss-120b", "openrouter/deepseek/deepseek-chat-v3.1"]>>;
     additionalContext: z.ZodOptional<z.ZodString>;
+    uploadedFiles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodString;
+        fileType: z.ZodEnum<["image", "text"]>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        content: string;
+        fileType: "text" | "image";
+    }, {
+        name: string;
+        content: string;
+        fileType: "text" | "image";
+    }>, "many">>>;
 }, "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";
+    model: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/x-ai/grok-4.1-fast" | "openrouter/openai/gpt-oss-120b" | "openrouter/deepseek/deepseek-chat-v3.1";
     userRequest: string;
     userName: string;
     conversationHistory: {
         content: string;
-        role: "user" | "assistant";
+        role: "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
     }[];
     availableVariables: any[];
+    uploadedFiles: {
+        name: string;
+        content: string;
+        fileType: "text" | "image";
+    }[];
     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;
+    model?: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/x-ai/grok-4.1-fast" | "openrouter/openai/gpt-oss-120b" | "openrouter/deepseek/deepseek-chat-v3.1" | undefined;
     currentCode?: string | undefined;
     conversationHistory?: {
         content: string;
-        role: "user" | "assistant";
+        role: "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
     }[] | undefined;
     additionalContext?: string | undefined;
+    uploadedFiles?: {
+        name: string;
+        content: string;
+        fileType: "text" | "image";
+    }[] | undefined;
 }>;
 /**
  * Response schema for Pearl agent
  */
 export declare const PearlResponseSchema: z.ZodObject<{
-    type: z.ZodEnum<["code", "question", "reject"]>;
+    type: z.ZodEnum<["code", "question", "answer", "reject"]>;
     message: z.ZodString;
     snippet: z.ZodOptional<z.ZodString>;
     bubbleParameters: z.ZodOptional<z.ZodRecord<z.ZodNumber, z.ZodObject<{
         variableName: z.ZodString;
-        bubbleName: z.ZodString;
+        bubbleName: z.ZodType<import("./types.js").BubbleName>;
         className: z.ZodString;
         parameters: z.ZodArray<z.ZodObject<{
             location: z.ZodOptional<z.ZodObject<{
@@ -76,9 +111,10 @@ export declare const PearlResponseSchema: z.ZodObject<{
             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>;
+            source: z.ZodOptional<z.ZodEnum<["object-property", "first-arg", "spread"]>>;
         }, "strip", z.ZodTypeAny, {
-            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: import("./bubble-definition-schema.js").BubbleParameterType;
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             name: string;
             location?: {
                 startLine: number;
@@ -87,9 +123,10 @@ export declare const PearlResponseSchema: z.ZodObject<{
                 endCol: number;
             } | undefined;
             variableId?: number | undefined;
+            source?: "object-property" | "first-arg" | "spread" | undefined;
         }, {
-            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: import("./bubble-definition-schema.js").BubbleParameterType;
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             name: string;
             location?: {
                 startLine: number;
@@ -98,6 +135,7 @@ export declare const PearlResponseSchema: z.ZodObject<{
                 endCol: number;
             } | undefined;
             variableId?: number | undefined;
+            source?: "object-property" | "first-arg" | "spread" | undefined;
         }>, "many">;
         hasAwait: z.ZodBoolean;
         hasActionCall: z.ZodBoolean;
@@ -121,6 +159,11 @@ export declare const PearlResponseSchema: z.ZodObject<{
             endLine: number;
             endCol: number;
         }>;
+        description: z.ZodOptional<z.ZodString>;
+        invocationCallSiteKey: z.ZodOptional<z.ZodString>;
+        clonedFromVariableId: z.ZodOptional<z.ZodNumber>;
+        isInsideCustomTool: z.ZodOptional<z.ZodBoolean>;
+        containingCustomToolId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         location: {
             startLine: number;
@@ -130,11 +173,11 @@ export declare const PearlResponseSchema: z.ZodObject<{
         };
         variableId: number;
         variableName: string;
-        bubbleName: string;
+        nodeType: "unknown" | "tool" | "service" | "workflow";
         className: string;
         parameters: {
-            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: import("./bubble-definition-schema.js").BubbleParameterType;
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             name: string;
             location?: {
                 startLine: number;
@@ -143,12 +186,18 @@ export declare const PearlResponseSchema: z.ZodObject<{
                 endCol: number;
             } | undefined;
             variableId?: number | undefined;
+            source?: "object-property" | "first-arg" | "spread" | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
+        bubbleName: import("./types.js").BubbleName;
+        description?: string | undefined;
         dependencies?: import("./types.js").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+        invocationCallSiteKey?: string | undefined;
+        clonedFromVariableId?: number | undefined;
+        isInsideCustomTool?: boolean | undefined;
+        containingCustomToolId?: string | undefined;
     }, {
         location: {
             startLine: number;
@@ -158,11 +207,11 @@ export declare const PearlResponseSchema: z.ZodObject<{
         };
         variableId: number;
         variableName: string;
-        bubbleName: string;
+        nodeType: "unknown" | "tool" | "service" | "workflow";
         className: string;
         parameters: {
-            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: import("./bubble-definition-schema.js").BubbleParameterType;
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             name: string;
             location?: {
                 startLine: number;
@@ -171,20 +220,26 @@ export declare const PearlResponseSchema: z.ZodObject<{
                 endCol: number;
             } | undefined;
             variableId?: number | undefined;
+            source?: "object-property" | "first-arg" | "spread" | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
+        bubbleName: import("./types.js").BubbleName;
+        description?: string | undefined;
         dependencies?: import("./types.js").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+        invocationCallSiteKey?: string | undefined;
+        clonedFromVariableId?: number | undefined;
+        isInsideCustomTool?: boolean | undefined;
+        containingCustomToolId?: string | 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, {
+    type: "code" | "question" | "answer" | "reject";
     message: string;
-    type: "code" | "question" | "reject";
     success: boolean;
     error?: string | undefined;
     inputSchema?: Record<string, unknown> | undefined;
@@ -198,11 +253,11 @@ export declare const PearlResponseSchema: z.ZodObject<{
         };
         variableId: number;
         variableName: string;
-        bubbleName: string;
+        nodeType: "unknown" | "tool" | "service" | "workflow";
         className: string;
         parameters: {
-            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: import("./bubble-definition-schema.js").BubbleParameterType;
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             name: string;
             location?: {
                 startLine: number;
@@ -211,17 +266,23 @@ export declare const PearlResponseSchema: z.ZodObject<{
                 endCol: number;
             } | undefined;
             variableId?: number | undefined;
+            source?: "object-property" | "first-arg" | "spread" | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
+        bubbleName: import("./types.js").BubbleName;
+        description?: string | undefined;
         dependencies?: import("./types.js").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+        invocationCallSiteKey?: string | undefined;
+        clonedFromVariableId?: number | undefined;
+        isInsideCustomTool?: boolean | undefined;
+        containingCustomToolId?: string | undefined;
     }> | undefined;
     snippet?: string | undefined;
 }, {
+    type: "code" | "question" | "answer" | "reject";
     message: string;
-    type: "code" | "question" | "reject";
     success: boolean;
     error?: string | undefined;
     inputSchema?: Record<string, unknown> | undefined;
@@ -235,11 +296,11 @@ export declare const PearlResponseSchema: z.ZodObject<{
         };
         variableId: number;
         variableName: string;
-        bubbleName: string;
+        nodeType: "unknown" | "tool" | "service" | "workflow";
         className: string;
         parameters: {
-            value: string | number | boolean | unknown[] | Record<string, unknown>;
             type: import("./bubble-definition-schema.js").BubbleParameterType;
+            value: string | number | boolean | unknown[] | Record<string, unknown>;
             name: string;
             location?: {
                 startLine: number;
@@ -248,12 +309,18 @@ export declare const PearlResponseSchema: z.ZodObject<{
                 endCol: number;
             } | undefined;
             variableId?: number | undefined;
+            source?: "object-property" | "first-arg" | "spread" | undefined;
         }[];
         hasAwait: boolean;
         hasActionCall: boolean;
-        nodeType: "unknown" | "service" | "tool" | "workflow";
+        bubbleName: import("./types.js").BubbleName;
+        description?: string | undefined;
         dependencies?: import("./types.js").BubbleName[] | undefined;
         dependencyGraph?: import("./bubble-definition-schema.js").DependencyGraphNode | undefined;
+        invocationCallSiteKey?: string | undefined;
+        clonedFromVariableId?: number | undefined;
+        isInsideCustomTool?: boolean | undefined;
+        containingCustomToolId?: string | undefined;
     }> | undefined;
     snippet?: string | undefined;
 }>;
@@ -261,16 +328,16 @@ export declare const PearlResponseSchema: z.ZodObject<{
  * Internal agent response format (JSON mode output from AI)
  */
 export declare const PearlAgentOutputSchema: z.ZodObject<{
-    type: z.ZodEnum<["code", "question", "reject"]>;
+    type: z.ZodEnum<["code", "question", "answer", "reject", "text"]>;
     message: z.ZodString;
     snippet: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    type: "code" | "text" | "question" | "answer" | "reject";
     message: string;
-    type: "code" | "question" | "reject";
     snippet?: string | undefined;
 }, {
+    type: "code" | "text" | "question" | "answer" | "reject";
     message: string;
-    type: "code" | "question" | "reject";
     snippet?: string | undefined;
 }>;
 export type PearlRequest = z.infer<typeof PearlRequestSchema>;

package/dist/pearl.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"pearl.d.ts","sourceRoot":"","sources":["../src/pearl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,eAAO,MAAM,mBAAmB,EAAE,cACQ,CAAC;AAC3C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqD7B,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

@@ -2,11 +2,9 @@ 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(),
-});
+import { ConversationMessageSchema } from './agent-memory.js';
+// Default model for Pearl AI agent
+export const PEARL_DEFAULT_MODEL = 'openrouter/anthropic/claude-sonnet-4.5';
 /**
  * Request schema for Pearl agent
  * Pearl helps users build complete workflows without requiring specific bubbles
@@ -29,19 +27,32 @@ export const PearlRequestSchema = z.object({
         .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'),
+    model: AvailableModels.default(PEARL_DEFAULT_MODEL).describe('AI model to use for Pearl agent'),
     additionalContext: z
         .string()
         .optional()
         .describe('Additional context information like timezone, user preferences, etc.'),
+    uploadedFiles: z
+        .array(z.object({
+        name: z.string().describe('File name'),
+        content: z
+            .string()
+            .describe('File content: base64 for images, plain text for text files'),
+        fileType: z
+            .enum(['image', 'text'])
+            .describe('Type of file: image (base64) or text (plain text)'),
+    }))
+        .optional()
+        .default([])
+        .describe('Files uploaded by the user: images as base64, text files as plain text'),
 });
 /**
  * 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)'),
+        .enum(['code', 'question', 'answer', 'reject'])
+        .describe('Type of response: code (generated workflow), question (needs clarification), answer (provides information/guidance), reject (infeasible request)'),
     message: z
         .string()
         .describe('Human-readable message: explanation for code, question text, or rejection reason'),
@@ -71,7 +82,7 @@ export const PearlResponseSchema = z.object({
  * Internal agent response format (JSON mode output from AI)
  */
 export const PearlAgentOutputSchema = z.object({
-    type: z.enum(['code', 'question', 'reject']),
+    type: z.enum(['code', 'question', 'answer', 'reject', 'text']),
     message: z.string(),
     snippet: z.string().optional(),
 });

package/dist/pearl.js.map

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

package/dist/rice.d.ts

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+import { type AvailableModel } from './ai-models.js';
+export declare const RICE_DEFAULT_MODEL: AvailableModel;
+/**
+ * Issue type categories for Rice evaluation
+ * - setup: Configuration/credential issues (user can fix in settings, not workflow code)
+ * - workflow: Logic/code issues in the workflow itself (fixable with Pearl)
+ * - input: Issues with input data (user needs to provide different input)
+ * - null: No issues (working=true)
+ */
+export declare const RiceIssueTypeSchema: z.ZodNullable<z.ZodEnum<["setup", "workflow", "input"]>>;
+export type RiceIssueType = z.infer<typeof RiceIssueTypeSchema>;
+/**
+ * Evaluation result schema from Rice agent
+ * This represents the AI's assessment of workflow execution quality
+ */
+export declare const RiceEvaluationResultSchema: z.ZodObject<{
+    working: z.ZodBoolean;
+    issueType: z.ZodNullable<z.ZodEnum<["setup", "workflow", "input"]>>;
+    summary: z.ZodString;
+    rating: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    working: boolean;
+    issueType: "setup" | "workflow" | "input" | null;
+    summary: string;
+    rating: number;
+}, {
+    working: boolean;
+    issueType: "setup" | "workflow" | "input" | null;
+    summary: string;
+    rating: number;
+}>;
+/**
+ * Request schema for Rice evaluation agent
+ * Rice evaluates workflow execution quality based on logs and code
+ */
+export declare const RiceRequestSchema: z.ZodObject<{
+    executionLogs: z.ZodArray<z.ZodUnknown, "many">;
+    workflowCode: z.ZodString;
+    executionId: z.ZodNumber;
+    bubbleFlowId: z.ZodNumber;
+    model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["openai/gpt-5", "openai/gpt-5-mini", "openai/gpt-5.1", "openai/gpt-5.2", "google/gemini-2.5-pro", "google/gemini-2.5-flash", "google/gemini-2.5-flash-lite", "google/gemini-2.5-flash-image-preview", "google/gemini-3-pro-preview", "google/gemini-3-pro-image-preview", "google/gemini-3-flash-preview", "anthropic/claude-sonnet-4-5", "anthropic/claude-opus-4-5", "anthropic/claude-haiku-4-5", "openrouter/x-ai/grok-code-fast-1", "openrouter/z-ai/glm-4.6", "openrouter/anthropic/claude-sonnet-4.5", "openrouter/google/gemini-3-pro-preview", "openrouter/morph/morph-v3-large", "openrouter/x-ai/grok-4.1-fast", "openrouter/openai/gpt-oss-120b", "openrouter/deepseek/deepseek-chat-v3.1"]>>>;
+}, "strip", z.ZodTypeAny, {
+    executionLogs: unknown[];
+    workflowCode: string;
+    executionId: number;
+    bubbleFlowId: number;
+    model: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/x-ai/grok-4.1-fast" | "openrouter/openai/gpt-oss-120b" | "openrouter/deepseek/deepseek-chat-v3.1";
+}, {
+    executionLogs: unknown[];
+    workflowCode: string;
+    executionId: number;
+    bubbleFlowId: number;
+    model?: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/x-ai/grok-4.1-fast" | "openrouter/openai/gpt-oss-120b" | "openrouter/deepseek/deepseek-chat-v3.1" | undefined;
+}>;
+/**
+ * Response schema for Rice evaluation agent
+ */
+export declare const RiceResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    evaluation: z.ZodOptional<z.ZodObject<{
+        working: z.ZodBoolean;
+        issueType: z.ZodNullable<z.ZodEnum<["setup", "workflow", "input"]>>;
+        summary: z.ZodString;
+        rating: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        working: boolean;
+        issueType: "setup" | "workflow" | "input" | null;
+        summary: string;
+        rating: number;
+    }, {
+        working: boolean;
+        issueType: "setup" | "workflow" | "input" | null;
+        summary: string;
+        rating: number;
+    }>>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    evaluation?: {
+        working: boolean;
+        issueType: "setup" | "workflow" | "input" | null;
+        summary: string;
+        rating: number;
+    } | undefined;
+    error?: string | undefined;
+}, {
+    success: boolean;
+    evaluation?: {
+        working: boolean;
+        issueType: "setup" | "workflow" | "input" | null;
+        summary: string;
+        rating: number;
+    } | undefined;
+    error?: string | undefined;
+}>;
+export type RiceEvaluationResult = z.infer<typeof RiceEvaluationResultSchema>;
+export type RiceRequest = z.input<typeof RiceRequestSchema>;
+export type RiceResponse = z.infer<typeof RiceResponseSchema>;
+//# sourceMappingURL=rice.d.ts.map

package/dist/rice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rice.d.ts","sourceRoot":"","sources":["../src/rice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAItE,eAAO,MAAM,kBAAkB,EAAE,cAAwC,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,0DAEnB,CAAC;AAEd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAyBrC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAgB5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AAGH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAK9E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/rice.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { AvailableModels } from './ai-models.js';
+import { RECOMMENDED_MODELS } from './bubbleflow-generation-prompts.js';
+// Default model for Rice evaluation agent
+export const RICE_DEFAULT_MODEL = RECOMMENDED_MODELS.FAST;
+/**
+ * Issue type categories for Rice evaluation
+ * - setup: Configuration/credential issues (user can fix in settings, not workflow code)
+ * - workflow: Logic/code issues in the workflow itself (fixable with Pearl)
+ * - input: Issues with input data (user needs to provide different input)
+ * - null: No issues (working=true)
+ */
+export const RiceIssueTypeSchema = z
+    .enum(['setup', 'workflow', 'input'])
+    .nullable();
+/**
+ * Evaluation result schema from Rice agent
+ * This represents the AI's assessment of workflow execution quality
+ */
+export const RiceEvaluationResultSchema = z.object({
+    working: z
+        .boolean()
+        .describe('Whether the workflow is functioning correctly (true if no errors and expected behavior)'),
+    issueType: RiceIssueTypeSchema.describe('Category of issue: "setup" (config/credentials), "workflow" (code logic), "input" (bad input data), or null if working'),
+    summary: z
+        .string()
+        .describe('Brief summary of the execution. If working: what happened and any external changes made. If not working: description of the issue.'),
+    rating: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .describe('Quality rating 1-10: 1-3=severe issues, 4-6=partial functionality, 7-8=working with minor issues, 9-10=excellent'),
+});
+/**
+ * Request schema for Rice evaluation agent
+ * Rice evaluates workflow execution quality based on logs and code
+ */
+export const RiceRequestSchema = z.object({
+    executionLogs: z
+        .array(z.unknown())
+        .describe('StreamingLogEvent[] from execution'),
+    workflowCode: z
+        .string()
+        .describe('The original workflow code that was executed'),
+    executionId: z.number().describe('ID of the execution being evaluated'),
+    bubbleFlowId: z.number().describe('ID of the BubbleFlow being evaluated'),
+    model: AvailableModels.optional()
+        .default(RICE_DEFAULT_MODEL)
+        .describe('AI model to use for Rice evaluation'),
+});
+/**
+ * Response schema for Rice evaluation agent
+ */
+export const RiceResponseSchema = z.object({
+    success: z
+        .boolean()
+        .describe('Whether the evaluation completed successfully'),
+    evaluation: RiceEvaluationResultSchema.optional().describe('Evaluation result (only present if success=true)'),
+    error: z
+        .string()
+        .optional()
+        .describe('Error message if the evaluation failed'),
+});
+//# sourceMappingURL=rice.js.map

package/dist/rice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rice.js","sourceRoot":"","sources":["../src/rice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAuB,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAmB,kBAAkB,CAAC,IAAI,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;KACpC,QAAQ,EAAE,CAAC;AAId;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CACP,yFAAyF,CAC1F;IAEH,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CACrC,wHAAwH,CACzH;IAED,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,oIAAoI,CACrI;IAEH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,kHAAkH,CACnH;CACJ,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClB,QAAQ,CAAC,oCAAoC,CAAC;IAEjD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,8CAA8C,CAAC;IAE3D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAEvE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAEzE,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE;SAC9B,OAAO,CAAC,kBAAkB,CAAC;SAC3B,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CAAC,+CAA+C,CAAC;IAE5D,UAAU,EAAE,0BAA0B,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxD,kDAAkD,CACnD;IAED,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;CACtD,CAAC,CAAC"}

package/dist/storage-utils.d.ts

@@ -0,0 +1,19 @@
+export type StorableValue = {
+    truncated: boolean;
+    preview: string | unknown;
+    sizeBytes: number;
+};
+/**
+ * Prepare an object for storage with a size cap. If the JSON stringified
+ * representation exceeds maxBytes, return a preview marker with metadata.
+ * Also logs a warning when truncation happens.
+ *
+ * Returns a consistent object structure when truncated to ensure compatibility
+ * with database schemas expecting JSON objects (jsonb/text with mode: 'json').
+ */
+export declare function prepareForStorage(value: unknown, options?: {
+    maxBytes?: number;
+    previewBytes?: number;
+}): StorableValue;
+export declare function cleanUpObjectForDisplayAndStorage(obj: unknown, maxBytes?: number): unknown;
+//# sourceMappingURL=storage-utils.d.ts.map

package/dist/storage-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-utils.d.ts","sourceRoot":"","sources":["../src/storage-utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,aAAa,CA2Cf;AAED,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,OAAO,EACZ,QAAQ,GAAE,MAAoB,GAC7B,OAAO,CAMT"}