@limo-labs/deity 0.3.0-alpha.0 → 0.3.0-alpha.1

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { ZodSchema, z } from 'zod';
-import { V as Validator, T as ToolSpec, A as AgentNode, P as PromptNode, E as ExecutionContext$1, S as SystemNode, U as UserNode, L as LLMLoopResult, O as ObserveNode, R as ResultNode, a as ValidationRules, b as ValidateNode, c as RetryNode, d as ToolDefNode, e as ToolsNode, f as ToolRefNode, W as WorkflowChildNode, g as WorkflowSequenceNode, h as WorkflowParallelNode, i as WorkflowConditionalNode, j as WorkflowLoopNode, k as WorkflowForEachNode, l as WorkflowNode, m as AgentComponent, n as WorkflowConfig, o as ExecutionNode, p as ASTNode, M as Message, q as ValidationResult$1, r as LLMAdapter$1, G as GenerationConfig$1, s as StateStore$1, t as TraceLogger, u as TraceEntry, v as ExecutionStats, C as ConversationManager, w as LimoMemoryManager, x as UIUpdateBridge, y as SessionStore, z as ConversationConfig, B as MemoryConfig, D as SessionConfig } from './jsx-dev-runtime-BQMsrQII.cjs';
-export { J as JSXComponent, F as JSXElementType, H as JSXProps, I as LLMLoopState, K as LLMResponse, N as MessageRole, Q as TemplatePart, X as ToolCall, Y as ToolResult, Z as ValidationRule, _ as isAgentNode, $ as isObserveNode, a0 as isPromptNode, a1 as isResultNode, a2 as isRetryNode, a3 as isSystemNode, a4 as isToolDefNode, a5 as isToolRefNode, a6 as isToolsNode, a7 as isUserNode, a8 as isValidateNode, a9 as isWorkflowConditionalNode, aa as isWorkflowForEachNode, ab as isWorkflowLoopNode, ac as isWorkflowNode, ad as isWorkflowParallelNode, ae as isWorkflowSequenceNode } from './jsx-dev-runtime-BQMsrQII.cjs';
+import { V as Validator, T as ToolSpec, A as AgentNode, P as PromptNode, E as ExecutionContext$1, S as SystemNode, U as UserNode, L as LLMLoopResult, O as ObserveNode, R as ResultNode, a as ValidationRules, b as ValidateNode, c as RetryNode, d as ToolDefNode, e as ToolsNode, f as ToolRefNode, W as WorkflowChildNode, g as WorkflowSequenceNode, h as WorkflowParallelNode, i as WorkflowConditionalNode, j as WorkflowLoopNode, k as WorkflowForEachNode, l as WorkflowNode, m as AgentComponent, n as WorkflowConfig, o as ExecutionNode, p as ASTNode, M as Message, q as ValidationResult$1, r as LLMAdapter$1, G as GenerationConfig$1, s as StateStore$1, t as TraceLogger, u as TraceEntry, v as ExecutionStats, C as ConversationManager, w as LimoMemoryManager, x as UIUpdateBridge, y as SessionStore, z as ConversationConfig, B as MemoryConfig, D as SessionConfig } from './jsx-dev-runtime-CCicXopP.cjs';
+export { J as JSXComponent, F as JSXElementType, H as JSXProps, I as LLMLoopState, K as LLMResponse, N as MessageRole, Q as TemplatePart, X as ToolCall, Y as ToolResult, Z as ValidationRule, _ as isAgentNode, $ as isObserveNode, a0 as isPromptNode, a1 as isResultNode, a2 as isRetryNode, a3 as isSystemNode, a4 as isToolDefNode, a5 as isToolRefNode, a6 as isToolsNode, a7 as isUserNode, a8 as isValidateNode, a9 as isWorkflowConditionalNode, aa as isWorkflowForEachNode, ab as isWorkflowLoopNode, ac as isWorkflowNode, ad as isWorkflowParallelNode, ae as isWorkflowSequenceNode } from './jsx-dev-runtime-CCicXopP.cjs';
 
 /**
  * Deity TSX - Agent Component
@@ -27,6 +27,8 @@ interface AgentProps<I = unknown, O = unknown> {
     input: ZodSchema<I>;
     /** Output schema (Zod) */
     output: ZodSchema<O>;
+    /** Agent execution mode: 'llm' (default) calls LLM, 'pure' runs code only */
+    mode?: 'llm' | 'pure';
     /** Optional description */
     description?: string;
     /** Optional tags for categorization */
@@ -37,8 +39,6 @@ interface AgentProps<I = unknown, O = unknown> {
     loopConfig?: LLMLoopConfig$1;
     /** Optional tool definitions (backward compatible - can also use <Tools> child) */
     tools?: ToolSpec[];
-    /** Execution mode: 'llm' (default) requires LLM adapter, 'pure' skips LLM */
-    mode?: 'llm' | 'pure';
     /** Child components (Tools, Prompt, Observe, Result, Validate, Retry) */
     children?: any[];
 }
@@ -2229,6 +2229,14 @@ declare function setResourceLoader(loader: PromptResourceLoader): void;
  * - Observe Testing: Test observation logic with mock data
  */
 
+/**
+ * Empty LLM result for testing pure-mode agents.
+ *
+ * Pure-mode agents don't call LLM, but their extractOutput function
+ * still receives an LLMLoopResult. This constant provides a minimal
+ * empty result for use in tests.
+ */
+declare const EMPTY_LLM_RESULT: LLMLoopResult;
 /**
  * Full Agent Test Options
  */
@@ -2390,10 +2398,6 @@ interface RetryExecutionResult<O> {
  * Orchestrates AgentComponent execution
  */
 
-/**
- * Empty LLM loop result for pure-function agents that skip LLM execution
- */
-declare const EMPTY_LLM_RESULT: LLMLoopResult;
 /**
  * Result from component execution
  */

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ZodSchema, z } from 'zod';
-import { V as Validator, T as ToolSpec, A as AgentNode, P as PromptNode, E as ExecutionContext$1, S as SystemNode, U as UserNode, L as LLMLoopResult, O as ObserveNode, R as ResultNode, a as ValidationRules, b as ValidateNode, c as RetryNode, d as ToolDefNode, e as ToolsNode, f as ToolRefNode, W as WorkflowChildNode, g as WorkflowSequenceNode, h as WorkflowParallelNode, i as WorkflowConditionalNode, j as WorkflowLoopNode, k as WorkflowForEachNode, l as WorkflowNode, m as AgentComponent, n as WorkflowConfig, o as ExecutionNode, p as ASTNode, M as Message, q as ValidationResult$1, r as LLMAdapter$1, G as GenerationConfig$1, s as StateStore$1, t as TraceLogger, u as TraceEntry, v as ExecutionStats, C as ConversationManager, w as LimoMemoryManager, x as UIUpdateBridge, y as SessionStore, z as ConversationConfig, B as MemoryConfig, D as SessionConfig } from './jsx-dev-runtime-BQMsrQII.js';
-export { J as JSXComponent, F as JSXElementType, H as JSXProps, I as LLMLoopState, K as LLMResponse, N as MessageRole, Q as TemplatePart, X as ToolCall, Y as ToolResult, Z as ValidationRule, _ as isAgentNode, $ as isObserveNode, a0 as isPromptNode, a1 as isResultNode, a2 as isRetryNode, a3 as isSystemNode, a4 as isToolDefNode, a5 as isToolRefNode, a6 as isToolsNode, a7 as isUserNode, a8 as isValidateNode, a9 as isWorkflowConditionalNode, aa as isWorkflowForEachNode, ab as isWorkflowLoopNode, ac as isWorkflowNode, ad as isWorkflowParallelNode, ae as isWorkflowSequenceNode } from './jsx-dev-runtime-BQMsrQII.js';
+import { V as Validator, T as ToolSpec, A as AgentNode, P as PromptNode, E as ExecutionContext$1, S as SystemNode, U as UserNode, L as LLMLoopResult, O as ObserveNode, R as ResultNode, a as ValidationRules, b as ValidateNode, c as RetryNode, d as ToolDefNode, e as ToolsNode, f as ToolRefNode, W as WorkflowChildNode, g as WorkflowSequenceNode, h as WorkflowParallelNode, i as WorkflowConditionalNode, j as WorkflowLoopNode, k as WorkflowForEachNode, l as WorkflowNode, m as AgentComponent, n as WorkflowConfig, o as ExecutionNode, p as ASTNode, M as Message, q as ValidationResult$1, r as LLMAdapter$1, G as GenerationConfig$1, s as StateStore$1, t as TraceLogger, u as TraceEntry, v as ExecutionStats, C as ConversationManager, w as LimoMemoryManager, x as UIUpdateBridge, y as SessionStore, z as ConversationConfig, B as MemoryConfig, D as SessionConfig } from './jsx-dev-runtime-CCicXopP.js';
+export { J as JSXComponent, F as JSXElementType, H as JSXProps, I as LLMLoopState, K as LLMResponse, N as MessageRole, Q as TemplatePart, X as ToolCall, Y as ToolResult, Z as ValidationRule, _ as isAgentNode, $ as isObserveNode, a0 as isPromptNode, a1 as isResultNode, a2 as isRetryNode, a3 as isSystemNode, a4 as isToolDefNode, a5 as isToolRefNode, a6 as isToolsNode, a7 as isUserNode, a8 as isValidateNode, a9 as isWorkflowConditionalNode, aa as isWorkflowForEachNode, ab as isWorkflowLoopNode, ac as isWorkflowNode, ad as isWorkflowParallelNode, ae as isWorkflowSequenceNode } from './jsx-dev-runtime-CCicXopP.js';
 
 /**
  * Deity TSX - Agent Component
@@ -27,6 +27,8 @@ interface AgentProps<I = unknown, O = unknown> {
     input: ZodSchema<I>;
     /** Output schema (Zod) */
     output: ZodSchema<O>;
+    /** Agent execution mode: 'llm' (default) calls LLM, 'pure' runs code only */
+    mode?: 'llm' | 'pure';
     /** Optional description */
     description?: string;
     /** Optional tags for categorization */
@@ -37,8 +39,6 @@ interface AgentProps<I = unknown, O = unknown> {
     loopConfig?: LLMLoopConfig$1;
     /** Optional tool definitions (backward compatible - can also use <Tools> child) */
     tools?: ToolSpec[];
-    /** Execution mode: 'llm' (default) requires LLM adapter, 'pure' skips LLM */
-    mode?: 'llm' | 'pure';
     /** Child components (Tools, Prompt, Observe, Result, Validate, Retry) */
     children?: any[];
 }
@@ -2229,6 +2229,14 @@ declare function setResourceLoader(loader: PromptResourceLoader): void;
  * - Observe Testing: Test observation logic with mock data
  */
 
+/**
+ * Empty LLM result for testing pure-mode agents.
+ *
+ * Pure-mode agents don't call LLM, but their extractOutput function
+ * still receives an LLMLoopResult. This constant provides a minimal
+ * empty result for use in tests.
+ */
+declare const EMPTY_LLM_RESULT: LLMLoopResult;
 /**
  * Full Agent Test Options
  */
@@ -2390,10 +2398,6 @@ interface RetryExecutionResult<O> {
  * Orchestrates AgentComponent execution
  */
 
-/**
- * Empty LLM loop result for pure-function agents that skip LLM execution
- */
-declare const EMPTY_LLM_RESULT: LLMLoopResult;
 /**
  * Result from component execution
  */

package/dist/index.js

@@ -42,8 +42,8 @@ var init_compile_observe = __esm({
 
 // src/components/Agent.tsx
 function Agent(props) {
-  const { id, input, output, description, tags, loopValidator, loopConfig, tools: propsTools, mode, children } = props;
-  const resolvedMode = mode ?? "llm";
+  const { id, input, output, mode, description, tags, loopValidator, loopConfig, tools: propsTools, children } = props;
+  const isPure = mode === "pure";
   if (!id) {
     throw new Error("Agent: id is required");
   }
@@ -54,8 +54,8 @@ function Agent(props) {
     throw new Error("Agent: output schema is required");
   }
   if (!children || children.length === 0) {
-    if (resolvedMode === "pure") {
-      throw new Error("Agent: pure mode must have at least a Result child");
+    if (isPure) {
+      throw new Error("Agent: pure mode agent must have at least a Result child");
     }
     throw new Error("Agent: must have at least Prompt and Result children");
   }
@@ -63,10 +63,10 @@ function Agent(props) {
   const nonToolsChildren = children.filter((child) => child?.type !== "Tools");
   let prompt;
   let rest;
-  if (resolvedMode === "pure") {
-    const firstNonTools = nonToolsChildren[0];
-    if (firstNonTools?.type === "Prompt") {
-      prompt = firstNonTools;
+  if (isPure) {
+    const firstChild = nonToolsChildren[0];
+    if (firstChild?.type === "Prompt") {
+      prompt = firstChild;
       rest = nonToolsChildren.slice(1);
     } else {
       prompt = void 0;
@@ -101,12 +101,12 @@ function Agent(props) {
       id,
       input,
       output,
+      mode,
       description,
       tags,
       loopValidator,
       loopConfig,
-      tools: mergedTools,
-      mode: resolvedMode
+      tools: mergedTools
     },
     children: orderedChildren
   };
@@ -1071,13 +1071,13 @@ function compileAgent(ast) {
   if (!children || children.length === 0) {
     throw new Error("Agent must have children");
   }
+  const isPure = ast.props.mode === "pure";
   const promptNode = children.find((n) => n?.type === "Prompt");
   const observeNode = children.find((n) => n?.type === "Observe");
   const resultNode = children.find((n) => n?.type === "Result");
   const validateNode = children.find((n) => n?.type === "Validate");
   const retryNode = children.find((n) => n?.type === "Retry");
-  const mode = ast.props.mode ?? "llm";
-  if (mode !== "pure" && !promptNode) {
+  if (!isPure && !promptNode) {
     throw new Error("Agent must have a Prompt node");
   }
   if (!resultNode) {
@@ -1090,14 +1090,12 @@ function compileAgent(ast) {
   const retry = retryNode ? compileRetry(retryNode) : void 0;
   const component = {
     id: ast.props.id,
+    mode: ast.props.mode,
     inputSchema: ast.props.input,
     outputSchema: ast.props.output,
     buildPrompt,
     extractOutput
   };
-  if (mode === "pure") {
-    component.mode = "pure";
-  }
   if (validateOutput) {
     component.validateOutput = validateOutput;
   }
@@ -1223,6 +1221,9 @@ function createLazyAgentComponent(astNode) {
     get id() {
       return astNode.props.id;
     },
+    get mode() {
+      return astNode.props.mode;
+    },
     get inputSchema() {
       return astNode.props.input;
     },
@@ -1238,9 +1239,6 @@ function createLazyAgentComponent(astNode) {
     get loopConfig() {
       return astNode.props.loopConfig;
     },
-    get mode() {
-      return astNode.props.mode;
-    },
     // Lazy methods - compile on first call
     buildPrompt(ctx) {
       return ensureCompiled().buildPrompt(ctx);
@@ -2600,6 +2598,18 @@ var PreflightChecker = class {
    * Check agent structure
    */
   checkAgentStructure(agent, errors) {
+    const isPure = agent.props.mode === "pure";
+    if (isPure) {
+      const resultNode2 = agent.children.find((n) => n?.type === "Result");
+      if (!resultNode2) {
+        errors.push({
+          type: "invalid_structure",
+          message: "Pure mode Agent must have a Result node",
+          nodeType: "Agent"
+        });
+      }
+      return;
+    }
     const [promptNode, ...rest] = agent.children;
     if (!promptNode || promptNode.type !== "Prompt") {
       errors.push({
@@ -2699,6 +2709,13 @@ async function preflight(agent, options) {
 }
 
 // src/testing/test-utils.ts
+var EMPTY_LLM_RESULT = {
+  response: { content: "", toolCalls: void 0 },
+  messages: [],
+  rounds: 0,
+  toolCallsExecuted: 0,
+  errors: []
+};
 async function runObserve(agent, options) {
   const observeNode = agent.children.find((n) => n?.type === "Observe");
   if (!observeNode) {
@@ -3360,13 +3377,6 @@ function parseComponentOutput(content, schema) {
 }
 
 // src/engine/executor.ts
-var EMPTY_LLM_RESULT = {
-  response: { content: "" },
-  messages: [],
-  rounds: 0,
-  toolCallsExecuted: 0,
-  errors: []
-};
 async function executeComponent(component, ctx, adapter, config) {
   const startTime = Date.now();
   const llmResults = [];
@@ -3376,6 +3386,73 @@ async function executeComponent(component, ctx, adapter, config) {
     stageId: component.id,
     timestamp: /* @__PURE__ */ new Date()
   });
+  if (component.mode === "pure") {
+    try {
+      ctx.ui?.stepProgress(component.id, 50, "Executing pure agent...");
+      const syntheticLLMResult = {
+        response: { content: "", toolCalls: void 0 },
+        messages: [],
+        rounds: 0,
+        toolCallsExecuted: 0,
+        errors: []
+      };
+      let output;
+      if (component.extractOutput) {
+        const extracted = await Promise.resolve(component.extractOutput(ctx, syntheticLLMResult));
+        const validation = component.outputSchema.safeParse(extracted);
+        if (!validation.success) {
+          const errors = validation.error.issues.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+          throw new Error(`Output validation failed: ${errors}`);
+        }
+        output = validation.data;
+      } else {
+        throw new Error("Pure mode agent must have an extractOutput (Result) function");
+      }
+      if (component.validateOutput) {
+        const validationResult = await Promise.resolve(component.validateOutput(output, ctx));
+        if (!validationResult.valid) {
+          const errorMessages = validationResult.errors?.join("; ") ?? validationResult.feedback ?? "Validation failed";
+          throw new Error(errorMessages);
+        }
+      }
+      const duration2 = Date.now() - startTime;
+      await ctx.trace.log({
+        type: "stage_complete",
+        output,
+        timestamp: /* @__PURE__ */ new Date()
+      });
+      ctx.ui?.completeStep(
+        component.id,
+        `Completed (pure) in ${Math.round(duration2 / 1e3)}s`
+      );
+      return {
+        output,
+        success: true,
+        attempts: 1,
+        llmResults: [syntheticLLMResult],
+        retryResult: {
+          success: true,
+          output,
+          attempts: 1,
+          errors: [],
+          validationHistory: [],
+          outputHistory: [output]
+        },
+        duration: duration2
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      await ctx.trace.log({
+        type: "stage_failed",
+        error: errorMessage,
+        timestamp: /* @__PURE__ */ new Date()
+      });
+      ctx.ui?.failStep(component.id, errorMessage);
+      throw new Error(
+        `Component ${component.id} (pure mode) failed: ${errorMessage}`
+      );
+    }
+  }
   const retryResult = await executeWithRetry(
     component,
     ctx,
@@ -5067,13 +5144,14 @@ async function executeStepNode(node, ctx, adapter, config) {
   if (!node.component) {
     throw new Error("Step node missing component");
   }
-  if (node.component.mode === "pure") {
-    return executePureComponent(node.component, ctx);
-  }
   if (!adapter) {
     if (node.component.model?.adapter) {
       adapter = node.component.model.adapter;
       config = node.component.model.config;
+    } else if (node.component.mode === "pure") {
+      adapter = {
+        generate: async () => ({ content: "", toolCalls: void 0 })
+      };
     } else {
       throw new Error("No LLM adapter provided");
     }
@@ -5257,56 +5335,6 @@ function createIterationContext(baseCtx, currentItem, index, totalItems, itemMod
     isLastIteration: index === totalItems - 1
   };
 }
-async function executePureComponent(component, ctx) {
-  ctx.ui?.startStep(component.id, component.id);
-  await ctx.trace.log({
-    type: "stage_start",
-    stageId: component.id,
-    timestamp: /* @__PURE__ */ new Date()
-  });
-  try {
-    if (!component.extractOutput) {
-      throw new Error(`Pure component '${component.id}' must have extractOutput defined`);
-    }
-    const output = await Promise.resolve(
-      component.extractOutput(ctx, EMPTY_LLM_RESULT)
-    );
-    const schemaResult = component.outputSchema.safeParse(output);
-    if (!schemaResult.success) {
-      const errors = schemaResult.error.issues.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
-      throw new Error(`Pure component '${component.id}' output validation failed: ${errors}`);
-    }
-    const validatedOutput = schemaResult.data;
-    if (component.validateOutput) {
-      const validationResult = await Promise.resolve(
-        component.validateOutput(validatedOutput, ctx)
-      );
-      if (!validationResult.valid) {
-        const feedback = validationResult.feedback || validationResult.errors?.join("; ") || "Validation failed";
-        throw new Error(`Pure component '${component.id}' validateOutput failed: ${feedback}`);
-      }
-    }
-    if (ctx instanceof ExecutionContext) {
-      ctx.previousOutputs[component.id] = validatedOutput;
-    }
-    await ctx.trace.log({
-      type: "stage_complete",
-      output: validatedOutput,
-      timestamp: /* @__PURE__ */ new Date()
-    });
-    ctx.ui?.completeStep(component.id, "Pure execution complete");
-    return validatedOutput;
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    await ctx.trace.log({
-      type: "stage_failed",
-      error: errorMessage,
-      timestamp: /* @__PURE__ */ new Date()
-    });
-    ctx.ui?.failStep(component.id, errorMessage);
-    throw error;
-  }
-}
 function createStepNode(component) {
   return {
     type: "step",