@invect/core 0.0.1

package/dist/nodes/agent-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.js","names":["z"],"sources":["../../src/nodes/agent-executor.ts"],"sourcesContent":["/**\n * AI Agent Node Executor\n *\n * Executes an LLM agent loop with tool use capabilities.\n * The agent can use configured tools to accomplish a task.\n *\n * Features:\n * - Parallel tool execution (executes multiple tool calls concurrently)\n * - Tool execution timeout (configurable, prevents hung tools)\n * - Conversation truncation (manages token budget for long conversations)\n * - Error handling with retry via LLM (tool errors returned to LLM for recovery)\n */\n\nimport { BaseNodeExecutor, NodeExecutionResult } from './base-node';\nimport { NodeExecutionStatus } from 'src/types/base';\nimport { GraphNodeType, NodeExecutionContext } from 'src/types-fresh';\nimport type { NodeInputData } from 'src/types/node-io-types';\nimport { FlowNodeForType } from 'src/services/flow-versions/schemas-fresh';\nimport { NodeDefinition } from '../types/node-definition.types';\nimport { detectProviderFromCredential } from 'src/utils/provider-detection';\nimport { BatchProvider } from 'src/services/ai/base-client';\nimport {\n  NodeConfigUpdateContext,\n  NodeConfigUpdateEvent,\n  NodeConfigUpdateResponse,\n} from 'src/types/node-config-update.types';\nimport {\n  AgentToolDefinition,\n  AgentMessage,\n  AgentToolCall,\n  ToolExecutionRecord,\n  AgentFinishReason,\n  AgentToolExecutionContext,\n  AgentExecutionOutput,\n  AgentStopCondition,\n  AddedToolInstance,\n  ConfiguredToolDefinition,\n  DEFAULT_TOOL_TIMEOUT_MS,\n  DEFAULT_MAX_CONVERSATION_TOKENS,\n  APPROX_TOKENS_PER_CHAR,\n} from 'src/types/agent-tool.types';\nimport { AgentToolRegistry } from 'src/services/agent-tools/agent-tool-registry';\nimport z from 'zod/v4';\nimport { createOutputSchema } from 'src/types/node-output-schemas';\n\n/**\n * Zod schema for an added tool instance\n */\nconst addedToolInstanceSchema = z.object({\n  instanceId: z.string(),\n  toolId: z.string(),\n  name: z.string(),\n  description: z.string(),\n  params: z.record(z.string(), z.unknown()),\n});\n\n/**\n * Zod schema for Agent node parameters\n * This provides runtime validation and type inference\n */\nexport const agentNodeParamsSchema = z.object({\n  // Required fields\n  credentialId: z.string().min(1, 'Credential is required'),\n  model: z.string().min(1, 'Model is required'),\n  taskPrompt: z.string().min(1, 'Task prompt is required'),\n\n  // Optional fields with defaults\n  systemPrompt: z.string().optional().default(''),\n  provider: z.string().optional(),\n  // Support both legacy string array and new AddedToolInstance array\n  enabledTools: z.array(z.string()).optional().default([]),\n  addedTools: z.array(addedToolInstanceSchema).optional().default([]),\n  maxIterations: z.number().int().min(1).max(50).optional().default(10),\n  stopCondition: z\n    .enum(['explicit_stop', 'tool_result', 'max_iterations'])\n    .optional()\n    .default('explicit_stop'),\n  temperature: z.number().min(0).max(2).optional().default(0.7),\n  maxTokens: z.number().positive().optional(),\n  toolTimeoutMs: z.number().positive().optional().default(DEFAULT_TOOL_TIMEOUT_MS),\n  maxConversationTokens: z.number().positive().optional().default(DEFAULT_MAX_CONVERSATION_TOKENS),\n  enableParallelTools: z.boolean().optional().default(true),\n  useBatchProcessing: z.boolean().optional().default(false),\n});\n\n/**\n * Inferred type from the schema - use this instead of manual type casting\n */\nexport type AgentNodeParams = z.infer<typeof agentNodeParamsSchema>;\n\n/**\n * Zod schema for Agent node output\n */\nexport const agentNodeOutputSchema = createOutputSchema(\n  GraphNodeType.AGENT,\n  z.object({\n    output: z.object({\n      value: z.object({\n        finalResponse: z.string(),\n        toolResults: z.array(\n          z.object({\n            toolId: z.string(),\n            toolName: z.string(),\n            input: z.record(z.string(), z.unknown()),\n            output: z.unknown().optional(),\n            error: z.string().optional(),\n            success: z.boolean(),\n            iteration: z.number(),\n            executionTimeMs: z.number(),\n          }),\n        ),\n        iterations: z.number(),\n        finishReason: z.enum(['completed', 'max_iterations', 'tool_result', 'error']),\n      }),\n      type: z.literal('object'),\n    }),\n  }),\n  z\n    .object({\n      model: z.string().optional(),\n      provider: z.nativeEnum(BatchProvider).optional(),\n      toolsUsed: z.array(z.string()).optional(),\n      totalIterations: z.number().optional(),\n      tokenUsage: z\n        .object({\n          conversationTokensEstimate: z.number(),\n          truncationOccurred: z.boolean(),\n        })\n        .optional(),\n    })\n    .optional(),\n);\n\n/**\n * AI Agent Node Executor\n * Runs an agent loop that can use tools to accomplish tasks\n */\nexport class AgentNodeExecutor extends BaseNodeExecutor<\n  GraphNodeType.AGENT,\n  typeof agentNodeParamsSchema\n> {\n  private toolRegistry: AgentToolRegistry;\n\n  /**\n   * Zod schema for validating agent node parameters\n   */\n  override readonly paramsSchema = agentNodeParamsSchema;\n  readonly outputSchema = agentNodeOutputSchema;\n\n  constructor(toolRegistry?: AgentToolRegistry) {\n    super(GraphNodeType.AGENT);\n    // Use provided registry or create empty one\n    this.toolRegistry = toolRegistry || new AgentToolRegistry();\n  }\n\n  /**\n   * Set the tool registry (called after initialization)\n   */\n  setToolRegistry(registry: AgentToolRegistry): void {\n    this.toolRegistry = registry;\n  }\n\n  getDefinition(): NodeDefinition {\n    return {\n      type: GraphNodeType.AGENT,\n      label: 'AI Agent',\n      description: 'LLM agent that can use tools to accomplish tasks',\n      category: 'AI',\n      icon: 'Bot',\n      input: {\n        id: 'input',\n        label: 'Incoming Data',\n        type: 'object',\n        description: 'Context data available to the agent',\n      },\n      outputs: [{ id: 'output', label: 'Agent Output', type: 'object' }],\n      paramFields: [\n        // Credential Selection\n        {\n          name: 'credentialId',\n          label: 'Credential',\n          type: 'credential',\n          required: true,\n          description: 'API credential for the LLM provider',\n          defaultValue: '',\n        },\n        // Model Selection (dynamic options via handleConfigUpdate)\n        {\n          name: 'model',\n          label: 'Model',\n          type: 'select',\n          required: true,\n          defaultValue: '',\n          options: [],\n          placeholder: 'Select a model',\n          description: 'LLM model to use for the agent',\n        },\n        // Task Prompt\n        {\n          name: 'taskPrompt',\n          label: 'Task / Goal',\n          type: 'textarea',\n          required: true,\n          defaultValue: '',\n          placeholder: 'Describe what the agent should accomplish...',\n          description: 'The main task or goal for the agent. Supports Nunjucks templating.',\n        },\n        // System Prompt\n        {\n          name: 'systemPrompt',\n          label: 'System Prompt',\n          type: 'textarea',\n          required: false,\n          defaultValue: '',\n          placeholder: 'Optional: Additional context or behavior instructions...',\n          description: \"System-level instructions for the agent's behavior.\",\n        },\n        // Tool Selection (would be tool-selector type in frontend)\n        {\n          name: 'enabledTools',\n          label: 'Available Tools',\n          type: 'json',\n          required: false,\n          defaultValue: [],\n          description:\n            'Array of tool IDs the agent can use. Example: [\"jq_query\", \"http_request\", \"math_eval\"]',\n        },\n        // Max Iterations\n        {\n          name: 'maxIterations',\n          label: 'Max Iterations',\n          type: 'number',\n          defaultValue: 10,\n          description: 'Maximum number of agent iterations (1-50)',\n          extended: true,\n        },\n        // Stop Condition\n        {\n          name: 'stopCondition',\n          label: 'Stop Condition',\n          type: 'select',\n          defaultValue: 'explicit_stop',\n          options: [\n            { label: 'Agent decides to stop', value: 'explicit_stop' },\n            { label: 'After first tool result', value: 'tool_result' },\n            { label: 'Max iterations only', value: 'max_iterations' },\n          ],\n          description: 'When the agent should stop executing',\n          extended: true,\n        },\n        // Temperature\n        {\n          name: 'temperature',\n          label: 'Temperature',\n          type: 'number',\n          defaultValue: 0.7,\n          description: 'Controls randomness (0.0 to 2.0)',\n          extended: true,\n        },\n        // Max Tokens\n        {\n          name: 'maxTokens',\n          label: 'Max Tokens',\n          type: 'number',\n          description: 'Maximum tokens per LLM call',\n          extended: true,\n        },\n        // Tool Timeout\n        {\n          name: 'toolTimeoutMs',\n          label: 'Tool Timeout (ms)',\n          type: 'number',\n          defaultValue: 30000,\n          description: 'Maximum time in milliseconds for each tool execution (default: 30000)',\n          extended: true,\n        },\n        // Max Conversation Tokens\n        {\n          name: 'maxConversationTokens',\n          label: 'Max Conversation Tokens',\n          type: 'number',\n          defaultValue: 100000,\n          description: 'Token budget for conversation history before truncation (default: 100000)',\n          extended: true,\n        },\n        // Enable Parallel Tools\n        {\n          name: 'enableParallelTools',\n          label: 'Enable Parallel Tools',\n          type: 'boolean',\n          defaultValue: true,\n          description: 'Execute multiple tool calls in parallel when the LLM requests them',\n          extended: true,\n        },\n        {\n          name: 'useBatchProcessing',\n          label: 'Batch Processing',\n          type: 'boolean',\n          defaultValue: false,\n          description:\n            \"When enabled, the initial prompt is submitted via the provider's batch API for asynchronous processing. The flow will pause until the batch completes.\",\n          extended: true,\n          hidden: true,\n        },\n      ],\n      defaultParams: {\n        credentialId: '',\n        model: '',\n        taskPrompt: '',\n        systemPrompt: '',\n        enabledTools: [],\n        maxIterations: 10,\n        stopCondition: 'explicit_stop',\n        temperature: 0.7,\n        toolTimeoutMs: 30000,\n        maxConversationTokens: 100000,\n        enableParallelTools: true,\n        useBatchProcessing: false,\n      },\n    };\n  }\n\n  async handleConfigUpdate(\n    event: NodeConfigUpdateEvent,\n    context: NodeConfigUpdateContext,\n  ): Promise<NodeConfigUpdateResponse> {\n    const params = event.params ?? {};\n    const credentialId = typeof params.credentialId === 'string' ? params.credentialId : '';\n    const isCredentialChange = event.change?.field === 'credentialId';\n    const providerFromParams =\n      !isCredentialChange && typeof params.provider === 'string'\n        ? (params.provider as BatchProvider)\n        : undefined;\n\n    if (!credentialId && !providerFromParams) {\n      return {\n        definition: this.getDefinition(),\n        params,\n      };\n    }\n\n    try {\n      let provider = providerFromParams;\n\n      if (!provider && credentialId) {\n        const credential = await context.services.credentials.get(credentialId);\n        provider = detectProviderFromCredential(credential) ?? undefined;\n      }\n\n      if (!provider) {\n        return {\n          definition: this.getDefinition(),\n          params,\n          warnings: ['Unable to detect provider from credential'],\n        };\n      }\n\n      const { models, defaultModel } =\n        await context.services.baseAIClient.listModelsForProvider(provider);\n\n      const definition = this.hydrateModelOptions(this.getDefinition(), provider, models);\n      const nextParams: Record<string, unknown> = { ...params, provider };\n      const currentModelId = typeof nextParams['model'] === 'string' ? nextParams['model'] : '';\n\n      if (!models.some((model) => model.id === currentModelId)) {\n        const fallback = models.find((model) => model.id === defaultModel) ?? models[0];\n        nextParams['model'] = fallback ? fallback.id : '';\n      }\n\n      return {\n        definition,\n        params: nextParams,\n      };\n    } catch (error) {\n      context.logger.error('Agent node config update failed', {\n        error: error instanceof Error ? error.message : String(error),\n        nodeId: event.nodeId,\n      });\n\n      return {\n        definition: this.getDefinition(),\n        params,\n        errors: [error instanceof Error ? error.message : String(error)],\n      };\n    }\n  }\n\n  private hydrateModelOptions(\n    baseDefinition: NodeDefinition,\n    provider: BatchProvider,\n    models: { id: string; name?: string }[],\n  ): NodeDefinition {\n    const providerLabel = provider === BatchProvider.OPENAI ? 'OpenAI' : 'Anthropic';\n    const supportsBatch = provider === BatchProvider.OPENAI || provider === BatchProvider.ANTHROPIC;\n    return {\n      ...baseDefinition,\n      paramFields: baseDefinition.paramFields.map((field) => {\n        if (field.name === 'useBatchProcessing') {\n          return { ...field, hidden: !supportsBatch };\n        }\n        if (field.name !== 'model') {\n          return field;\n        }\n\n        return {\n          ...field,\n          options: models.map((model) => ({\n            label: model.name ?? model.id,\n            value: model.id,\n          })),\n          placeholder: models.length\n            ? `Select a ${providerLabel} model`\n            : `No ${providerLabel} models available`,\n          disabled: models.length === 0,\n        };\n      }),\n    };\n  }\n\n  /**\n   * Build configured tool definitions from added tool instances.\n   *\n   * For each instance:\n   * - Look up the base tool definition from the registry\n   * - Apply instance customizations (name, description)\n   * - Filter inputSchema to only include AI-chosen params\n   * - Track static params for injection during execution\n   *\n   * @returns Array of configured tool definitions and a map of instanceId -> static params\n   */\n  private buildConfiguredTools(\n    addedTools: AddedToolInstance[],\n    logger?: { debug: (msg: string, meta?: Record<string, unknown>) => void },\n  ): { tools: ConfiguredToolDefinition[]; staticParamsMap: Map<string, Record<string, unknown>> } {\n    const tools: ConfiguredToolDefinition[] = [];\n    const staticParamsMap = new Map<string, Record<string, unknown>>();\n\n    logger?.debug('Building configured tools from addedTools', {\n      addedToolCount: addedTools.length,\n      addedToolIds: addedTools.map((t) => ({\n        instanceId: t.instanceId,\n        toolId: t.toolId,\n        name: t.name,\n      })),\n    });\n\n    for (const instance of addedTools) {\n      const registeredTool = this.toolRegistry.get(instance.toolId);\n      const baseDef = registeredTool?.definition;\n      if (!baseDef) {\n        // Skip unknown tools\n        logger?.debug('Skipping unknown tool', { toolId: instance.toolId });\n        continue;\n      }\n\n      const aiChosenModes = (instance.params._aiChosenModes as Record<string, boolean>) ?? {};\n      const staticParams: Record<string, unknown> = {};\n\n      // SECURITY: credentialId is NEVER AI-chosen - always extract as static param\n      // This ensures credentials are user-configured, not hallucinated by the AI\n      if (instance.params.credentialId !== undefined) {\n        staticParams.credentialId = instance.params.credentialId;\n      }\n\n      logger?.debug('Processing tool instance', {\n        instanceId: instance.instanceId,\n        toolId: instance.toolId,\n        name: instance.name,\n        paramKeys: Object.keys(instance.params),\n        aiChosenModes,\n      });\n\n      // Build filtered input schema - only include params where AI should choose\n      const baseSchema = baseDef.inputSchema as {\n        type?: string;\n        properties?: Record<string, unknown>;\n        required?: string[];\n      };\n\n      let filteredSchema: Record<string, unknown> = { ...baseDef.inputSchema };\n\n      if (baseSchema.properties) {\n        const filteredProperties: Record<string, unknown> = {};\n\n        for (const [paramName, paramSchema] of Object.entries(baseSchema.properties)) {\n          // SECURITY: Credential params are NEVER AI-chosen\n          if (paramName === 'credentialId') {\n            // Already handled above - skip including in AI schema\n            continue;\n          }\n\n          // Default to AI-chosen (true) if not explicitly set\n          const isAiChosen = aiChosenModes[paramName] ?? true;\n\n          if (isAiChosen) {\n            // AI will provide this value - include in schema\n            filteredProperties[paramName] = paramSchema;\n          } else {\n            // User provided static value - exclude from schema, track for injection\n            if (instance.params[paramName] !== undefined) {\n              staticParams[paramName] = instance.params[paramName];\n            }\n          }\n        }\n\n        // Filter required array to only include AI-chosen params (exclude credentialId)\n        const filteredRequired = baseSchema.required?.filter((name) => {\n          if (name === 'credentialId') {\n            return false;\n          } // Never required from AI\n          const isAiChosen = aiChosenModes[name] ?? true;\n          return isAiChosen;\n        });\n\n        filteredSchema = {\n          ...baseSchema,\n          properties: filteredProperties,\n          required: filteredRequired && filteredRequired.length > 0 ? filteredRequired : undefined,\n        };\n      }\n\n      logger?.debug('Tool static params extracted', {\n        instanceId: instance.instanceId,\n        staticParamKeys: Object.keys(staticParams),\n        staticParamValues: staticParams,\n        hasCredentialId: 'credentialId' in staticParams,\n      });\n\n      // Create configured tool definition\n      // Use instanceId as the tool ID so we can map back to it during execution\n      const configuredTool: ConfiguredToolDefinition = {\n        ...baseDef,\n        id: instance.instanceId, // Use instance ID so AI tool calls reference this specific instance\n        name: instance.name,\n        description: instance.description,\n        inputSchema: filteredSchema,\n        instanceId: instance.instanceId,\n        staticParams,\n        baseToolId: instance.toolId,\n      };\n\n      tools.push(configuredTool);\n      staticParamsMap.set(instance.instanceId, staticParams);\n    }\n\n    return { tools, staticParamsMap };\n  }\n\n  /**\n   * Execute the agent loop\n   */\n  async execute(\n    inputs: NodeInputData,\n    node: FlowNodeForType<GraphNodeType.AGENT>,\n    context: NodeExecutionContext,\n  ): Promise<NodeExecutionResult> {\n    this.logExecutionStart(context);\n\n    try {\n      // Parse and validate params using the schema\n      const paramsResult = this.parseParams(node.params);\n      if (!paramsResult.success) {\n        return this.createErrorResult([`Invalid agent node parameters: ${paramsResult.error}`]);\n      }\n\n      const params = paramsResult.data;\n\n      // Check if agent prompt function is available\n      if (!context.functions.submitAgentPrompt) {\n        return this.createErrorResult(['Agent prompt function not available in execution context']);\n      }\n\n      // Detect provider from credential if not already set\n      let provider = params.provider as BatchProvider | undefined;\n      if (!provider) {\n        if (!context.functions.getCredential) {\n          return this.createErrorResult([\n            'Credential lookup function not available in execution context',\n          ]);\n        }\n\n        const credential = await context.functions.getCredential(params.credentialId);\n        if (!credential) {\n          return this.createErrorResult(['Selected credential was not found or is inaccessible']);\n        }\n\n        provider = detectProviderFromCredential(credential) || undefined;\n        if (!provider) {\n          return this.createErrorResult(['Unable to detect provider from credential.']);\n        }\n      }\n\n      // Log what tools are configured on this agent node\n      context.logger.debug(`Agent ${context.nodeId} - Tool configuration`, {\n        addedToolsCount: params.addedTools?.length ?? 0,\n        enabledToolsCount: params.enabledTools?.length ?? 0,\n        addedTools: params.addedTools\n          ? JSON.stringify(params.addedTools).substring(0, 500)\n          : 'undefined',\n      });\n\n      // Build configured tools from added tool instances\n      // This handles schema filtering for static params and tracks instance -> base tool mapping\n      let configuredTools: ConfiguredToolDefinition[] = [];\n      let staticParamsMap = new Map<string, Record<string, unknown>>();\n\n      if (params.addedTools && params.addedTools.length > 0) {\n        // New format: full tool instances with configuration\n        const result = this.buildConfiguredTools(\n          params.addedTools as AddedToolInstance[],\n          context.logger,\n        );\n        configuredTools = result.tools;\n        staticParamsMap = result.staticParamsMap;\n      } else if (params.enabledTools && params.enabledTools.length > 0) {\n        // Legacy format: just tool IDs (no static params, use base definitions as-is)\n        const baseDefs = this.toolRegistry.getDefinitionsForIds(params.enabledTools);\n        configuredTools = baseDefs.map((def) => ({\n          ...def,\n          instanceId: def.id,\n          staticParams: {},\n          baseToolId: def.id,\n        }));\n      }\n\n      context.logger.debug(`Agent ${context.nodeId} - Starting agent loop`, {\n        taskPrompt: params.taskPrompt.substring(0, 100),\n        model: params.model,\n        configuredToolCount: configuredTools.length,\n        maxIterations: params.maxIterations,\n        stopCondition: params.stopCondition,\n      });\n\n      // Run the agent loop\n      const agentResult = await this.runAgentLoop(\n        {\n          taskPrompt: params.taskPrompt,\n          systemPrompt: params.systemPrompt || undefined,\n          model: params.model,\n          maxIterations: params.maxIterations,\n          stopCondition: params.stopCondition,\n          temperature: params.temperature,\n          maxTokens: params.maxTokens,\n          credentialId: params.credentialId,\n          useBatchProcessing: params.useBatchProcessing,\n        },\n        configuredTools,\n        staticParamsMap,\n        provider,\n        context,\n        {\n          toolTimeoutMs: params.toolTimeoutMs,\n          maxConversationTokens: params.maxConversationTokens,\n          enableParallelTools: params.enableParallelTools,\n        },\n      );\n\n      // If the agent loop returned a pending batch result, propagate it directly\n      if ('state' in agentResult && agentResult.state === NodeExecutionStatus.PENDING) {\n        return agentResult as NodeExecutionResult;\n      }\n\n      const agentOutput = agentResult as AgentExecutionOutput;\n\n      // Build success result\n      const executionResult = this.createSuccessResult(\n        {\n          nodeType: GraphNodeType.AGENT,\n          data: {\n            variables: {\n              output: {\n                value: agentOutput,\n                type: 'object' as const,\n              },\n            },\n            metadata: {\n              model: params.model,\n              provider,\n              toolsUsed: agentOutput.toolResults.map((r) => r.toolId),\n              totalIterations: agentOutput.iterations,\n              tokenUsage: agentOutput.tokenUsage,\n            },\n          },\n        },\n        {\n          model: params.model,\n          provider,\n          iterations: agentOutput.iterations,\n          finishReason: agentOutput.finishReason,\n          toolsUsed: agentOutput.toolResults.map((r) => r.toolId),\n          executedAt: new Date().toISOString(),\n          tokenUsage: agentOutput.tokenUsage,\n        },\n      );\n\n      this.logExecutionComplete(context, executionResult);\n      return executionResult;\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      context.logger.error(`Agent ${context.nodeId} - Execution failed:`, {\n        error: errorMessage,\n      });\n\n      return this.createErrorResult([`Agent execution failed: ${errorMessage}`]);\n    }\n  }\n\n  /**\n   * Run the agent loop with support for:\n   * - Parallel tool execution\n   * - Tool execution timeouts\n   * - Conversation truncation for token management\n   * - Static parameter injection for configured tools\n   */\n  private async runAgentLoop(\n    params: {\n      taskPrompt: string;\n      systemPrompt?: string;\n      model: string;\n      maxIterations?: number;\n      stopCondition?: string;\n      temperature?: number;\n      maxTokens?: number;\n      credentialId: string;\n      useBatchProcessing?: boolean;\n    },\n    tools: ConfiguredToolDefinition[],\n    staticParamsMap: Map<string, Record<string, unknown>>,\n    provider: BatchProvider,\n    context: NodeExecutionContext,\n    config: {\n      toolTimeoutMs: number;\n      maxConversationTokens: number;\n      enableParallelTools: boolean;\n    },\n  ): Promise<AgentExecutionOutput | NodeExecutionResult> {\n    const maxIterations = params.maxIterations ?? 10;\n    const stopCondition = (params.stopCondition ?? 'explicit_stop') as AgentStopCondition;\n\n    // Build system prompt with tool descriptions\n    const systemPromptWithTools = this.buildSystemPromptWithTools(params.systemPrompt, tools);\n\n    // Initialize conversation\n    const messages: AgentMessage[] = [{ role: 'user', content: params.taskPrompt }];\n\n    const toolResults: ToolExecutionRecord[] = [];\n    let iteration = 0;\n    let agentFinished = false;\n    let finishReason: AgentFinishReason = 'max_iterations';\n    let finalResponse = '';\n    let truncationOccurred = false;\n\n    while (!agentFinished && iteration < maxIterations) {\n      iteration++;\n\n      // Check and truncate conversation if needed\n      const truncationResult = this.truncateConversationIfNeeded(\n        messages,\n        config.maxConversationTokens,\n        context,\n      );\n      if (truncationResult.truncated) {\n        truncationOccurred = true;\n      }\n\n      context.logger.debug(`Agent ${context.nodeId} - Iteration ${iteration}`, {\n        messageCount: messages.length,\n        toolResultCount: toolResults.length,\n        estimatedTokens: truncationResult.estimatedTokens,\n      });\n\n      // Call LLM with tools (we've already verified submitAgentPrompt exists)\n      // Batch processing is only used on the first iteration — subsequent\n      // iterations (after tool results) always run direct so the agent can\n      // continue its tool-calling loop without pausing.\n      const useBatch = iteration === 1 && params.useBatchProcessing === true;\n\n      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- verified during init\n      const response = await context.functions.submitAgentPrompt!({\n        model: params.model,\n        messages,\n        tools,\n        systemPrompt: systemPromptWithTools,\n        temperature: params.temperature,\n        maxTokens: params.maxTokens,\n        provider,\n        credentialId: params.credentialId,\n        parallelToolCalls: config.enableParallelTools,\n        ...(useBatch\n          ? {\n              useBatchProcessing: true,\n              nodeId: context.nodeId,\n              flowRunId: context.flowRunId,\n            }\n          : {}),\n      });\n\n      // Handle batch submission — the flow will pause and resume later\n      if ('type' in response && response.type === 'batch_submitted') {\n        const batchResult = response as { batchJobId: string; nodeId: string; flowRunId: string };\n        return {\n          state: NodeExecutionStatus.PENDING,\n          type: 'batch_submitted' as const,\n          batchJobId: batchResult.batchJobId,\n          nodeId: batchResult.nodeId,\n          executionId: batchResult.flowRunId,\n        };\n      }\n\n      // Get all tool calls\n      const allToolCalls = response.toolCalls ?? [];\n\n      context.logger.debug(`Agent ${context.nodeId} - LLM response`, {\n        type: response.type,\n        toolCallCount: allToolCalls.length,\n        contentLength: response.content?.length ?? 0,\n      });\n\n      if (response.type === 'tool_use' && allToolCalls.length > 0) {\n        // Execute tools - parallel or sequential based on config\n        const iterationToolResults =\n          config.enableParallelTools && allToolCalls.length > 1\n            ? await this.executeToolsInParallel(\n                allToolCalls,\n                tools,\n                staticParamsMap,\n                context,\n                iteration,\n                maxIterations,\n                config.toolTimeoutMs,\n              )\n            : await this.executeToolsSequentially(\n                allToolCalls,\n                tools,\n                staticParamsMap,\n                context,\n                iteration,\n                maxIterations,\n                config.toolTimeoutMs,\n              );\n\n        toolResults.push(...iterationToolResults);\n\n        // Add assistant message with all tool calls\n        messages.push({\n          role: 'assistant',\n          content: response.content || '',\n          toolCalls: allToolCalls,\n        });\n\n        // Add tool result messages for each tool call\n        for (let i = 0; i < allToolCalls.length; i++) {\n          const toolCall = allToolCalls[i];\n          const toolRecord = iterationToolResults[i];\n\n          messages.push({\n            role: 'tool',\n            toolCallId: toolCall.id,\n            content: toolRecord.success\n              ? JSON.stringify(toolRecord.output)\n              : `Error: ${toolRecord.error}`,\n          });\n        }\n\n        // Check stop condition\n        if (stopCondition === 'tool_result') {\n          agentFinished = true;\n          finishReason = 'tool_result';\n          const lastResult = iterationToolResults[iterationToolResults.length - 1];\n          finalResponse = lastResult.success\n            ? JSON.stringify(lastResult.output)\n            : `Tool execution failed: ${lastResult.error}`;\n        }\n      } else {\n        // Agent provided final answer (text response)\n        agentFinished = true;\n        finishReason = 'completed';\n        finalResponse = response.content || '';\n\n        messages.push({\n          role: 'assistant',\n          content: finalResponse,\n        });\n      }\n    }\n\n    // If we hit max iterations without completing\n    if (!agentFinished) {\n      finishReason = 'max_iterations';\n      finalResponse =\n        messages[messages.length - 1]?.content ||\n        'Agent reached maximum iterations without completing.';\n    }\n\n    // Calculate final token estimate\n    const finalTokenEstimate = this.estimateConversationTokens(messages);\n\n    return {\n      finalResponse,\n      toolResults,\n      iterations: iteration,\n      finishReason,\n      conversationHistory: messages,\n      tokenUsage: {\n        conversationTokensEstimate: finalTokenEstimate,\n        truncationOccurred,\n      },\n    };\n  }\n\n  /**\n   * Execute multiple tools in parallel with timeout\n   */\n  private async executeToolsInParallel(\n    toolCalls: AgentToolCall[],\n    configuredTools: ConfiguredToolDefinition[],\n    staticParamsMap: Map<string, Record<string, unknown>>,\n    context: NodeExecutionContext,\n    iteration: number,\n    maxIterations: number,\n    timeoutMs: number,\n  ): Promise<ToolExecutionRecord[]> {\n    context.logger.debug(\n      `Agent ${context.nodeId} - Executing ${toolCalls.length} tools in parallel`,\n    );\n\n    const promises = toolCalls.map((toolCall) =>\n      this.executeToolWithTimeout(\n        toolCall,\n        configuredTools,\n        staticParamsMap,\n        context,\n        iteration,\n        maxIterations,\n        timeoutMs,\n      ),\n    );\n\n    return Promise.all(promises);\n  }\n\n  /**\n   * Execute multiple tools sequentially with timeout\n   */\n  private async executeToolsSequentially(\n    toolCalls: AgentToolCall[],\n    configuredTools: ConfiguredToolDefinition[],\n    staticParamsMap: Map<string, Record<string, unknown>>,\n    context: NodeExecutionContext,\n    iteration: number,\n    maxIterations: number,\n    timeoutMs: number,\n  ): Promise<ToolExecutionRecord[]> {\n    const results: ToolExecutionRecord[] = [];\n\n    for (const toolCall of toolCalls) {\n      const result = await this.executeToolWithTimeout(\n        toolCall,\n        configuredTools,\n        staticParamsMap,\n        context,\n        iteration,\n        maxIterations,\n        timeoutMs,\n      );\n      results.push(result);\n    }\n\n    return results;\n  }\n\n  /**\n   * Execute a single tool with timeout\n   */\n  private async executeToolWithTimeout(\n    toolCall: AgentToolCall,\n    configuredTools: ConfiguredToolDefinition[],\n    staticParamsMap: Map<string, Record<string, unknown>>,\n    context: NodeExecutionContext,\n    iteration: number,\n    maxIterations: number,\n    timeoutMs: number,\n  ): Promise<ToolExecutionRecord> {\n    const startTime = Date.now();\n\n    // Create a timeout promise\n    const timeoutPromise = new Promise<ToolExecutionRecord>((_, reject) => {\n      setTimeout(() => {\n        reject(new Error(`Tool execution timed out after ${timeoutMs}ms`));\n      }, timeoutMs);\n    });\n\n    // Race between tool execution and timeout\n    try {\n      const result = await Promise.race([\n        this.executeTool(\n          toolCall,\n          configuredTools,\n          staticParamsMap,\n          context,\n          iteration,\n          maxIterations,\n        ),\n        timeoutPromise,\n      ]);\n      return result;\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      const isTimeout = errorMessage.includes('timed out');\n\n      context.logger.warn(`Agent ${context.nodeId} - Tool ${isTimeout ? 'timed out' : 'failed'}`, {\n        toolId: toolCall.toolId,\n        error: errorMessage,\n        timeoutMs,\n      });\n\n      // Find the configured tool to get a nicer name\n      const configuredTool = configuredTools.find((t) => t.id === toolCall.toolId);\n      const registeredTool = configuredTool\n        ? this.toolRegistry.get(configuredTool.baseToolId)\n        : this.toolRegistry.get(toolCall.toolId);\n\n      return {\n        toolId: toolCall.toolId,\n        toolName: configuredTool?.name ?? registeredTool?.definition.name ?? toolCall.toolId,\n        input: toolCall.input,\n        error: errorMessage,\n        success: false,\n        iteration,\n        executionTimeMs: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Estimate the number of tokens in the conversation\n   */\n  private estimateConversationTokens(messages: AgentMessage[]): number {\n    let totalChars = 0;\n\n    for (const message of messages) {\n      totalChars += (message.content ?? '').length;\n      if (message.toolCalls) {\n        totalChars += JSON.stringify(message.toolCalls).length;\n      }\n    }\n\n    return Math.ceil(totalChars * APPROX_TOKENS_PER_CHAR);\n  }\n\n  /**\n   * Truncate conversation history if it exceeds the token budget\n   * Preserves the first message (task prompt) and recent messages\n   */\n  private truncateConversationIfNeeded(\n    messages: AgentMessage[],\n    maxTokens: number,\n    context: NodeExecutionContext,\n  ): { truncated: boolean; estimatedTokens: number } {\n    const estimatedTokens = this.estimateConversationTokens(messages);\n\n    if (estimatedTokens <= maxTokens || messages.length <= 2) {\n      return { truncated: false, estimatedTokens };\n    }\n\n    context.logger.info(`Agent ${context.nodeId} - Truncating conversation`, {\n      currentTokens: estimatedTokens,\n      maxTokens,\n      messageCount: messages.length,\n    });\n\n    // Keep the first message (task prompt) and progressively remove old messages\n    // until we're under the token budget\n    const firstMessage = messages[0];\n    const remainingMessages = messages.slice(1);\n\n    // Remove messages from the beginning (oldest) until under budget\n    while (remainingMessages.length > 1) {\n      const testMessages = [firstMessage, ...remainingMessages];\n      const testTokens = this.estimateConversationTokens(testMessages);\n\n      if (testTokens <= maxTokens * 0.9) {\n        // Leave 10% buffer\n        break;\n      }\n\n      // Remove the oldest message (after the first one)\n      // If it's an assistant message with tool calls, also remove the corresponding tool result\n      const removedMessage = remainingMessages.shift();\n\n      // If we removed an assistant message with tool calls, remove the tool result messages too\n      if (removedMessage?.toolCalls && removedMessage.toolCalls.length > 0) {\n        const toolCallIds = new Set(removedMessage.toolCalls.map((tc) => tc.id));\n        // Remove any tool result messages that correspond to the removed tool calls\n        while (\n          remainingMessages.length > 0 &&\n          remainingMessages[0].role === 'tool' &&\n          remainingMessages[0].toolCallId &&\n          toolCallIds.has(remainingMessages[0].toolCallId)\n        ) {\n          remainingMessages.shift();\n        }\n      }\n    }\n\n    // Add a summary message to indicate truncation\n    const truncationNotice: AgentMessage = {\n      role: 'user',\n      content:\n        '[Note: Earlier conversation history has been truncated to stay within token limits. The conversation continues from here.]',\n    };\n\n    // Reconstruct messages array\n    messages.length = 0;\n    messages.push(firstMessage, truncationNotice, ...remainingMessages);\n\n    const newEstimatedTokens = this.estimateConversationTokens(messages);\n    context.logger.info(`Agent ${context.nodeId} - Conversation truncated`, {\n      newTokens: newEstimatedTokens,\n      newMessageCount: messages.length,\n    });\n\n    return { truncated: true, estimatedTokens: newEstimatedTokens };\n  }\n\n  /**\n   * Build system prompt with tool descriptions\n   */\n  private buildSystemPromptWithTools(\n    baseSystemPrompt: string | undefined,\n    tools: AgentToolDefinition[],\n  ): string {\n    let systemPrompt = baseSystemPrompt || '';\n\n    if (tools.length > 0) {\n      const toolDescriptions = tools\n        .map((tool) => `- ${tool.name} (${tool.id}): ${tool.description}`)\n        .join('\\n');\n\n      const toolInstructions = `\nYou have access to the following tools:\n\n${toolDescriptions}\n\nTo use a tool, respond with a tool call in the appropriate format for your API.\nOnly use tools when necessary to accomplish the task.\nWhen you have completed the task or have a final answer, respond with text only (no tool call).\n`;\n\n      systemPrompt = systemPrompt ? `${systemPrompt}\\n\\n${toolInstructions}` : toolInstructions;\n    }\n\n    return systemPrompt;\n  }\n\n  /**\n   * Execute a tool call\n   *\n   * The toolCall.toolId may be an instanceId (for configured tools) or a base tool ID (legacy).\n   * We look up the configured tool to:\n   * 1. Find the base tool ID for the actual executor\n   * 2. Merge static params with the AI-provided input\n   * 3. Record the tool execution to the database\n   */\n  private async executeTool(\n    toolCall: AgentToolCall,\n    configuredTools: ConfiguredToolDefinition[],\n    staticParamsMap: Map<string, Record<string, unknown>>,\n    context: NodeExecutionContext,\n    iteration: number,\n    maxIterations: number,\n  ): Promise<ToolExecutionRecord> {\n    const startTime = Date.now();\n    const startedAt = new Date().toISOString();\n\n    // Find the configured tool (toolCall.toolId is the instanceId)\n    const configuredTool = configuredTools.find((t) => t.id === toolCall.toolId);\n\n    // Get the base tool ID - either from configured tool or use the toolId directly (legacy)\n    const baseToolId = configuredTool?.baseToolId ?? toolCall.toolId;\n\n    const registeredTool = this.toolRegistry.get(baseToolId);\n    if (!registeredTool) {\n      const result: ToolExecutionRecord = {\n        toolId: toolCall.toolId,\n        toolName: configuredTool?.name ?? toolCall.toolId,\n        input: toolCall.input,\n        error: `Tool '${baseToolId}' not found in registry`,\n        success: false,\n        iteration,\n        executionTimeMs: Date.now() - startTime,\n      };\n\n      // Record failed tool execution to database\n      await this.recordToolExecutionToDb(context, result, startedAt);\n\n      return result;\n    }\n\n    // Merge static params with AI-provided input\n    // Static params take precedence (user-configured values override any AI attempts)\n    const staticParams = staticParamsMap.get(toolCall.toolId) ?? {};\n    const mergedInput = { ...toolCall.input, ...staticParams };\n\n    // Tools are self-contained - they import their own dependencies\n    // The nodeContext provides access to cross-cutting concerns like credentials\n    const toolContext: AgentToolExecutionContext = {\n      logger: context.logger,\n      iteration,\n      maxIterations,\n      nodeContext: context,\n      staticParams, // Pass static params so tools can access configured values like credentialId\n    };\n\n    try {\n      context.logger.debug(`Agent ${context.nodeId} - Executing tool`, {\n        toolId: toolCall.toolId,\n        baseToolId,\n        hasStaticParams: Object.keys(staticParams).length > 0,\n        staticParamKeys: Object.keys(staticParams),\n        credentialIdInStaticParams: staticParams.credentialId ?? 'NOT SET',\n        input: JSON.stringify(mergedInput).substring(0, 200),\n      });\n\n      const executorResult = await registeredTool.executor(mergedInput, toolContext);\n\n      const result: ToolExecutionRecord = {\n        toolId: toolCall.toolId,\n        toolName: configuredTool?.name ?? registeredTool.definition.name,\n        input: mergedInput,\n        output: executorResult.output,\n        error: executorResult.error,\n        success: executorResult.success,\n        iteration,\n        executionTimeMs: Date.now() - startTime,\n      };\n\n      // Record successful tool execution to database\n      await this.recordToolExecutionToDb(context, result, startedAt);\n\n      return result;\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n\n      context.logger.error(`Agent ${context.nodeId} - Tool execution failed`, {\n        toolId: toolCall.toolId,\n        baseToolId,\n        error: errorMessage,\n      });\n\n      const result: ToolExecutionRecord = {\n        toolId: toolCall.toolId,\n        toolName: configuredTool?.name ?? registeredTool.definition.name,\n        input: mergedInput,\n        error: errorMessage,\n        success: false,\n        iteration,\n        executionTimeMs: Date.now() - startTime,\n      };\n\n      // Record failed tool execution to database\n      await this.recordToolExecutionToDb(context, result, startedAt);\n\n      return result;\n    }\n  }\n\n  /**\n   * Record a tool execution to the database via the context function.\n   * This is a best-effort operation - failures are logged but don't affect the agent loop.\n   */\n  private async recordToolExecutionToDb(\n    context: NodeExecutionContext,\n    result: ToolExecutionRecord,\n    startedAt: string,\n  ): Promise<void> {\n    const { recordToolExecution } = context.functions;\n\n    if (!recordToolExecution) {\n      context.logger.debug('recordToolExecution not available, skipping database recording');\n      return;\n    }\n\n    // traceId is the nodeExecutionId\n    const nodeExecutionId = context.traceId;\n    if (!nodeExecutionId) {\n      context.logger.warn('traceId (nodeExecutionId) not available, skipping database recording');\n      return;\n    }\n\n    try {\n      await recordToolExecution({\n        nodeExecutionId,\n        flowRunId: context.flowRunId,\n        toolId: result.toolId,\n        toolName: result.toolName,\n        iteration: result.iteration,\n        input: result.input,\n        output: result.output,\n        error: result.error,\n        success: result.success,\n        startedAt,\n        completedAt: new Date().toISOString(),\n        duration: result.executionTimeMs,\n      });\n\n      context.logger.debug('Tool execution recorded to database', {\n        toolId: result.toolId,\n        iteration: result.iteration,\n        success: result.success,\n      });\n    } catch (error) {\n      // Best-effort - don't fail the agent loop if recording fails\n      context.logger.warn('Failed to record tool execution to database', {\n        toolId: result.toolId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n}\n"],"mappings":"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d,SAAS,EAAE;KACX,aAAa;KACb,aAAa;KACd;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,UAAU;KACV,cAAc;KACd,aAAa;KACb,aAAa;KACd;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,UAAU;KACV,cAAc;KACd,aAAa;KACb,aAAa;KACd;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,UAAU;KACV,cAAc,EAAE;KAChB,aACE;KACH;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,aAAa;KACb,UAAU;KACX;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,SAAS;MACP;OAAE,OAAO;OAAyB,OAAO;OAAiB;MAC1D;OAAE,OAAO;OAA2B,OAAO;OAAe;MAC1D;OAAE,OAAO;OAAuB,OAAO;OAAkB;MAC1D;KACD,aAAa;KACb,UAAU;KACX;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,aAAa;KACb,UAAU;KACX;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,aAAa;KACb,UAAU;KACX;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,aAAa;KACb,UAAU;KACX;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,aAAa;KACb,UAAU;KACX;IAED;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,aAAa;KACb,UAAU;KACX;IACD;KACE,MAAM;KACN,OAAO;KACP,MAAM;KACN,cAAc;KACd,aACE;KACF,UAAU;KACV,QAAQ;KACT;IACF;GACD,eAAe;IACb,cAAc;IACd,OAAO;IACP,YAAY;IACZ,cAAc;IACd,cAAc,EAAE;IAChB,eAAe;IACf,eAAe;IACf,aAAa;IACb,eAAe;IACf,uBAAuB;IACvB,qBAAqB;IACrB,oBAAoB;IACrB;GACF;;CAGH,MAAM,mBACJ,OACA,SACmC;EACnC,MAAM,SAAS,MAAM,UAAU,EAAE;EACjC,MAAM,eAAe,OAAO,OAAO,iBAAiB,WA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"}

package/dist/nodes/base-node.cjs

@@ -0,0 +1,174 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_base = require("../types/base.cjs");
+let zod_v4 = require("zod/v4");
+zod_v4 = require_runtime.__toESM(zod_v4);
+//#region src/nodes/base-node.ts
+/**
+* Default params schema for nodes that don't define their own.
+* Accepts any object - no validation.
+*/
+const defaultParamsSchema = zod_v4.default.record(zod_v4.default.string(), zod_v4.default.unknown());
+/**
+* Abstract base class for all node executors.
+*
+* @typeParam TNodeType - The GraphNodeType this executor handles
+* @typeParam TParamsSchema - Zod schema type for node parameters (defaults to permissive record)
+*/
+var BaseNodeExecutor = class {
+	constructor(nodeType) {
+		this.nodeType = nodeType;
+		this.nodeType = nodeType;
+	}
+	/**
+	* Zod schema for validating node parameters.
+	* Override this in subclasses to provide typed param validation.
+	*
+	* @example
+	* ```typescript
+	* readonly paramsSchema = z.object({
+	*   prompt: z.string().min(1),
+	*   temperature: z.number().optional().default(0.7),
+	* });
+	* ```
+	*/
+	paramsSchema = defaultParamsSchema;
+	/**
+	* Handle node configuration updates (optional per node)
+	*/
+	async handleConfigUpdate(event, _context) {
+		return {
+			definition: this.getDefinition(),
+			params: event.params
+		};
+	}
+	/**
+	* Parse and validate node params using the executor's paramsSchema.
+	* Returns typed params if valid, or an error message if invalid.
+	*
+	* @param params - Raw params from node.params (Record<string, unknown>)
+	* @returns Parsed and typed params, or error
+	*/
+	parseParams(params) {
+		const result = this.paramsSchema.safeParse(params);
+		if (!result.success) return {
+			success: false,
+			error: zod_v4.default.prettifyError(result.error)
+		};
+		return {
+			success: true,
+			data: result.data
+		};
+	}
+	/**
+	* Validate node inputs.
+	* All nodes accept a generic Record<string, unknown> — actual data
+	* extraction happens via {{ expression }} templates in the node params.
+	*/
+	validateInputs(inputs) {
+		if (inputs !== null && inputs !== void 0 && typeof inputs !== "object") return {
+			isValid: false,
+			error: `Expected object inputs, got ${typeof inputs}`
+		};
+		return {
+			isValid: true,
+			data: inputs ?? {}
+		};
+	}
+	/**
+	* Create a successful execution result
+	*/
+	createSuccessResult(output, metadata) {
+		return {
+			state: require_base.NodeExecutionStatus.SUCCESS,
+			metadata,
+			type: "output",
+			output
+		};
+	}
+	/**
+	* Create a pending execution result
+	*/
+	createPendingResult(batchJobId, nodeId, executionId, metadata) {
+		return {
+			state: require_base.NodeExecutionStatus.PENDING,
+			type: "batch_submitted",
+			batchJobId,
+			nodeId,
+			executionId,
+			metadata
+		};
+	}
+	/**
+	* Create a failed execution result
+	*/
+	createErrorResult(errors, metadata) {
+		return {
+			state: require_base.NodeExecutionStatus.FAILED,
+			errors,
+			metadata
+		};
+	}
+	/**
+	* Log execution start
+	*/
+	logExecutionStart(context) {
+		context.logger.debug(`Starting execution of ${this.nodeType} node`, {
+			nodeId: context.nodeId,
+			traceId: context.traceId,
+			flowRunId: context.flowRunId
+		});
+	}
+	/**
+	* Log execution completion
+	*/
+	logExecutionComplete(context, result) {
+		context.logger.debug(`${result.state}: trace: ${context.traceId} - nodeId: ${context.nodeId} - flowRunId: ${context.flowRunId} - nodeType: ${this.nodeType}`);
+	}
+};
+/**
+* Utility functions for node execution
+*/
+var NodeExecutionUtils = class NodeExecutionUtils {
+	/**
+	* Safely extract nested value from object
+	*/
+	static getNestedValue(obj, path, defaultValue) {
+		const keys = path.split(".");
+		let current = obj;
+		for (const key of keys) {
+			if (current === null || current === void 0 || !(key in current)) return defaultValue;
+			current = current[key];
+		}
+		return current;
+	}
+	/**
+	* Set nested value in object
+	*/
+	static setNestedValue(obj, path, value) {
+		const keys = path.split(".");
+		const lastKey = keys.pop();
+		let current = obj;
+		for (const key of keys) {
+			if (!(key in current) || typeof current[key] !== "object") current[key] = {};
+			current = current[key];
+		}
+		if (lastKey === void 0) throw new Error("Invalid path: no last key provided");
+		current[lastKey] = value;
+	}
+	/**
+	* Template string replacement
+	*/
+	static replaceTemplateVariables(template, variables) {
+		return template.replace(/\{\{([^}]+)\}\}/g, (match, varName) => {
+			const trimmedVarName = varName.trim();
+			const value = NodeExecutionUtils.getNestedValue(variables, trimmedVarName);
+			return value !== void 0 ? String(value) : match;
+		});
+	}
+};
+//#endregion
+exports.BaseNodeExecutor = BaseNodeExecutor;
+exports.NodeExecutionUtils = NodeExecutionUtils;
+exports.defaultParamsSchema = defaultParamsSchema;
+
+//# sourceMappingURL=base-node.cjs.map

package/dist/nodes/base-node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-node.cjs","names":["z","NodeExecutionStatus"],"sources":["../../src/nodes/base-node.ts"],"sourcesContent":["import type { NodeOutput, NodeInputData } from 'src/types/node-io-types';\nimport { GraphNodeType, NodeExecutionContext } from 'src/types-fresh';\nimport { NodeExecutionStatus } from 'src/types/base';\nimport { FlowNodeForType } from 'src/services/flow-versions/schemas-fresh';\nimport z, { ZodType } from 'zod/v4';\nimport { NodeDefinition } from '../types/node-definition.types';\nimport {\n  NodeConfigUpdateContext,\n  NodeConfigUpdateEvent,\n  NodeConfigUpdateResponse,\n} from 'src/types/node-config-update.types';\nimport type {\n  NodeExecutionResult,\n  NodeExecutionFailedResult,\n  NodeExecutionPendingResult,\n  NodeExecutionSuccessResult,\n} from 'src/types/node-execution.types';\n\n/**\n * Result of parsing params with a schema\n */\nexport type ParamsParseResult<T> = { success: true; data: T } | { success: false; error: string };\n\n/**\n * Default params schema for nodes that don't define their own.\n * Accepts any object - no validation.\n */\nexport const defaultParamsSchema = z.record(z.string(), z.unknown());\n\n/**\n * Abstract base class for all node executors.\n *\n * @typeParam TNodeType - The GraphNodeType this executor handles\n * @typeParam TParamsSchema - Zod schema type for node parameters (defaults to permissive record)\n */\nexport abstract class BaseNodeExecutor<\n  in out TNodeType extends GraphNodeType,\n  TParamsSchema extends ZodType = typeof defaultParamsSchema,\n> {\n  constructor(readonly nodeType: TNodeType) {\n    this.nodeType = nodeType;\n  }\n\n  /**\n   * Zod schema for validating node parameters.\n   * Override this in subclasses to provide typed param validation.\n   *\n   * @example\n   * ```typescript\n   * readonly paramsSchema = z.object({\n   *   prompt: z.string().min(1),\n   *   temperature: z.number().optional().default(0.7),\n   * });\n   * ```\n   */\n  readonly paramsSchema: TParamsSchema = defaultParamsSchema as unknown as TParamsSchema;\n\n  /**\n   * Get the static definition of this node type\n   */\n  abstract getDefinition(): NodeDefinition;\n\n  /**\n   * run the node\n   */\n  abstract execute(\n    inputs: NodeInputData,\n    node: FlowNodeForType<TNodeType>,\n    context: NodeExecutionContext,\n  ): Promise<NodeExecutionResult> | NodeExecutionResult;\n\n  /**\n   * Handle node configuration updates (optional per node)\n   */\n  async handleConfigUpdate(\n    event: NodeConfigUpdateEvent,\n    _context: NodeConfigUpdateContext,\n  ): Promise<NodeConfigUpdateResponse> {\n    return {\n      definition: this.getDefinition(),\n      params: event.params,\n    };\n  }\n\n  /**\n   * Parse and validate node params using the executor's paramsSchema.\n   * Returns typed params if valid, or an error message if invalid.\n   *\n   * @param params - Raw params from node.params (Record<string, unknown>)\n   * @returns Parsed and typed params, or error\n   */\n  protected parseParams(\n    params: Record<string, unknown>,\n  ): ParamsParseResult<z.infer<TParamsSchema>> {\n    const result = this.paramsSchema.safeParse(params);\n    if (!result.success) {\n      return {\n        success: false,\n        error: z.prettifyError(result.error),\n      };\n    }\n    return { success: true, data: result.data as z.infer<TParamsSchema> };\n  }\n\n  /**\n   * Validate node inputs.\n   * All nodes accept a generic Record<string, unknown> — actual data\n   * extraction happens via {{ expression }} templates in the node params.\n   */\n  validateInputs(\n    inputs: unknown,\n  ): { isValid: true; data: NodeInputData } | { isValid: false; error: string } {\n    if (inputs !== null && inputs !== undefined && typeof inputs !== 'object') {\n      return { isValid: false, error: `Expected object inputs, got ${typeof inputs}` };\n    }\n    return { isValid: true, data: (inputs ?? {}) as NodeInputData };\n  }\n\n  /**\n   * Create a successful execution result\n   */\n  protected createSuccessResult(\n    output: NodeOutput,\n    metadata?: Record<string, unknown>,\n  ): NodeExecutionSuccessResult {\n    return {\n      state: NodeExecutionStatus.SUCCESS,\n      metadata,\n      type: 'output',\n      output,\n    };\n  }\n\n  /**\n   * Create a pending execution result\n   */\n  protected createPendingResult(\n    batchJobId: string,\n    nodeId: string,\n    executionId: string,\n    metadata?: Record<string, unknown>,\n  ): NodeExecutionPendingResult {\n    return {\n      state: NodeExecutionStatus.PENDING,\n      type: 'batch_submitted',\n      batchJobId,\n      nodeId,\n      executionId,\n      metadata,\n    };\n  }\n\n  /**\n   * Create a failed execution result\n   */\n  protected createErrorResult(\n    errors: string[],\n    metadata?: Record<string, unknown>,\n  ): NodeExecutionFailedResult {\n    return {\n      state: NodeExecutionStatus.FAILED,\n      errors,\n      metadata,\n    };\n  }\n\n  /**\n   * Log execution start\n   */\n  protected logExecutionStart(context: NodeExecutionContext): void {\n    context.logger.debug(`Starting execution of ${this.nodeType} node`, {\n      nodeId: context.nodeId,\n      traceId: context.traceId,\n      flowRunId: context.flowRunId,\n    });\n  }\n\n  /**\n   * Log execution completion\n   */\n  protected logExecutionComplete(context: NodeExecutionContext, result: NodeExecutionResult): void {\n    context.logger.debug(\n      `${result.state}: trace: ${context.traceId} - nodeId: ${context.nodeId} - flowRunId: ${context.flowRunId} - nodeType: ${this.nodeType}`,\n    );\n  }\n}\n\n/**\n * Type alias for any node executor (used in registries and collections)\n * This erases the specific schema type to allow storing different executor types together\n */\nexport type AnyNodeExecutor = BaseNodeExecutor<GraphNodeType, ZodType<unknown>>;\n\n/**\n * Utility functions for node execution\n */\nexport class NodeExecutionUtils {\n  /**\n   * Safely extract nested value from object\n   */\n  static getNestedValue(\n    obj: Record<string, unknown>,\n    path: string,\n    defaultValue?: unknown,\n  ): unknown {\n    const keys = path.split('.');\n    let current = obj;\n\n    for (const key of keys) {\n      if (current === null || current === undefined || !(key in current)) {\n        return defaultValue;\n      }\n      current = current[key] as Record<string, unknown>;\n    }\n\n    return current;\n  }\n\n  /**\n   * Set nested value in object\n   */\n  static setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void {\n    const keys = path.split('.');\n    const lastKey = keys.pop();\n    let current = obj;\n\n    for (const key of keys) {\n      if (!(key in current) || typeof current[key] !== 'object') {\n        current[key] = {};\n      }\n      current = current[key] as Record<string, unknown>;\n    }\n\n    if (lastKey === undefined) {\n      throw new Error('Invalid path: no last key provided');\n    }\n    current[lastKey] = value;\n  }\n\n  /**\n   * Template string replacement\n   */\n  static replaceTemplateVariables(template: string, variables: Record<string, unknown>): string {\n    return template.replace(/\\{\\{([^}]+)\\}\\}/g, (match, varName) => {\n      const trimmedVarName = varName.trim();\n      const value = NodeExecutionUtils.getNestedValue(variables, trimmedVarName);\n      return value !== undefined ? String(value) : match;\n    });\n  }\n}\n\n// Re-export types from the dedicated types file\nexport type {\n  NodeExecutionResult,\n  NodeExecutionFailedResult,\n  NodeExecutionPendingResult,\n  NodeExecutionSuccessResult,\n} from 'src/types/node-execution.types';\n"],"mappings":";;;;;;;;;AA2BA,MAAa,sBAAsBA,OAAAA,QAAE,OAAOA,OAAAA,QAAE,QAAQ,EAAEA,OAAAA,QAAE,SAAS,CAAC;;;;;;;AAQpE,IAAsB,mBAAtB,MAGE;CACA,YAAY,UAA8B;AAArB,OAAA,WAAA;AACnB,OAAK,WAAW;;;;;;;;;;;;;;CAelB,eAAuC;;;;CAmBvC,MAAM,mBACJ,OACA,UACmC;AACnC,SAAO;GACL,YAAY,KAAK,eAAe;GAChC,QAAQ,MAAM;GACf;;;;;;;;;CAUH,YACE,QAC2C;EAC3C,MAAM,SAAS,KAAK,aAAa,UAAU,OAAO;AAClD,MAAI,CAAC,OAAO,QACV,QAAO;GACL,SAAS;GACT,OAAOA,OAAAA,QAAE,cAAc,OAAO,MAAM;GACrC;AAEH,SAAO;GAAE,SAAS;GAAM,MAAM,OAAO;GAAgC;;;;;;;CAQvE,eACE,QAC4E;AAC5E,MAAI,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAO,WAAW,SAC/D,QAAO;GAAE,SAAS;GAAO,OAAO,+BAA+B,OAAO;GAAU;AAElF,SAAO;GAAE,SAAS;GAAM,MAAO,UAAU,EAAE;GAAoB;;;;;CAMjE,oBACE,QACA,UAC4B;AAC5B,SAAO;GACL,OAAOC,aAAAA,oBAAoB;GAC3B;GACA,MAAM;GACN;GACD;;;;;CAMH,oBACE,YACA,QACA,aACA,UAC4B;AAC5B,SAAO;GACL,OAAOA,aAAAA,oBAAoB;GAC3B,MAAM;GACN;GACA;GACA;GACA;GACD;;;;;CAMH,kBACE,QACA,UAC2B;AAC3B,SAAO;GACL,OAAOA,aAAAA,oBAAoB;GAC3B;GACA;GACD;;;;;CAMH,kBAA4B,SAAqC;AAC/D,UAAQ,OAAO,MAAM,yBAAyB,KAAK,SAAS,QAAQ;GAClE,QAAQ,QAAQ;GAChB,SAAS,QAAQ;GACjB,WAAW,QAAQ;GACpB,CAAC;;;;;CAMJ,qBAA+B,SAA+B,QAAmC;AAC/F,UAAQ,OAAO,MACb,GAAG,OAAO,MAAM,WAAW,QAAQ,QAAQ,aAAa,QAAQ,OAAO,gBAAgB,QAAQ,UAAU,eAAe,KAAK,WAC9H;;;;;;AAaL,IAAa,qBAAb,MAAa,mBAAmB;;;;CAI9B,OAAO,eACL,KACA,MACA,cACS;EACT,MAAM,OAAO,KAAK,MAAM,IAAI;EAC5B,IAAI,UAAU;AAEd,OAAK,MAAM,OAAO,MAAM;AACtB,OAAI,YAAY,QAAQ,YAAY,KAAA,KAAa,EAAE,OAAO,SACxD,QAAO;AAET,aAAU,QAAQ;;AAGpB,SAAO;;;;;CAMT,OAAO,eAAe,KAA8B,MAAc,OAAsB;EACtF,MAAM,OAAO,KAAK,MAAM,IAAI;EAC5B,MAAM,UAAU,KAAK,KAAK;EAC1B,IAAI,UAAU;AAEd,OAAK,MAAM,OAAO,MAAM;AACtB,OAAI,EAAE,OAAO,YAAY,OAAO,QAAQ,SAAS,SAC/C,SAAQ,OAAO,EAAE;AAEnB,aAAU,QAAQ;;AAGpB,MAAI,YAAY,KAAA,EACd,OAAM,IAAI,MAAM,qCAAqC;AAEvD,UAAQ,WAAW;;;;;CAMrB,OAAO,yBAAyB,UAAkB,WAA4C;AAC5F,SAAO,SAAS,QAAQ,qBAAqB,OAAO,YAAY;GAC9D,MAAM,iBAAiB,QAAQ,MAAM;GACrC,MAAM,QAAQ,mBAAmB,eAAe,WAAW,eAAe;AAC1E,UAAO,UAAU,KAAA,IAAY,OAAO,MAAM,GAAG;IAC7C"}

package/dist/nodes/base-node.d.cts

@@ -0,0 +1,125 @@
+import { NodeInputData, NodeOutput } from "../types/node-io-types.cjs";
+import { NodeExecutionFailedResult, NodeExecutionPendingResult, NodeExecutionResult, NodeExecutionSuccessResult } from "../types/node-execution.types.cjs";
+import { FlowNodeForType } from "../services/flow-versions/schemas-fresh.cjs";
+import { GraphNodeType } from "../types/graph-node-types.cjs";
+import { NodeExecutionContext } from "../types-fresh.cjs";
+import { NodeDefinition } from "../types/node-definition.types.cjs";
+import { NodeConfigUpdateContext, NodeConfigUpdateEvent, NodeConfigUpdateResponse } from "../types/node-config-update.types.cjs";
+import z$1, { ZodType } from "zod/v4";
+
+//#region src/nodes/base-node.d.ts
+/**
+ * Result of parsing params with a schema
+ */
+type ParamsParseResult<T> = {
+  success: true;
+  data: T;
+} | {
+  success: false;
+  error: string;
+};
+/**
+ * Default params schema for nodes that don't define their own.
+ * Accepts any object - no validation.
+ */
+declare const defaultParamsSchema: z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>;
+/**
+ * Abstract base class for all node executors.
+ *
+ * @typeParam TNodeType - The GraphNodeType this executor handles
+ * @typeParam TParamsSchema - Zod schema type for node parameters (defaults to permissive record)
+ */
+declare abstract class BaseNodeExecutor<in out TNodeType extends GraphNodeType, TParamsSchema extends ZodType = typeof defaultParamsSchema> {
+  readonly nodeType: TNodeType;
+  constructor(nodeType: TNodeType);
+  /**
+   * Zod schema for validating node parameters.
+   * Override this in subclasses to provide typed param validation.
+   *
+   * @example
+   * ```typescript
+   * readonly paramsSchema = z.object({
+   *   prompt: z.string().min(1),
+   *   temperature: z.number().optional().default(0.7),
+   * });
+   * ```
+   */
+  readonly paramsSchema: TParamsSchema;
+  /**
+   * Get the static definition of this node type
+   */
+  abstract getDefinition(): NodeDefinition;
+  /**
+   * run the node
+   */
+  abstract execute(inputs: NodeInputData, node: FlowNodeForType<TNodeType>, context: NodeExecutionContext): Promise<NodeExecutionResult> | NodeExecutionResult;
+  /**
+   * Handle node configuration updates (optional per node)
+   */
+  handleConfigUpdate(event: NodeConfigUpdateEvent, _context: NodeConfigUpdateContext): Promise<NodeConfigUpdateResponse>;
+  /**
+   * Parse and validate node params using the executor's paramsSchema.
+   * Returns typed params if valid, or an error message if invalid.
+   *
+   * @param params - Raw params from node.params (Record<string, unknown>)
+   * @returns Parsed and typed params, or error
+   */
+  protected parseParams(params: Record<string, unknown>): ParamsParseResult<z$1.infer<TParamsSchema>>;
+  /**
+   * Validate node inputs.
+   * All nodes accept a generic Record<string, unknown> — actual data
+   * extraction happens via {{ expression }} templates in the node params.
+   */
+  validateInputs(inputs: unknown): {
+    isValid: true;
+    data: NodeInputData;
+  } | {
+    isValid: false;
+    error: string;
+  };
+  /**
+   * Create a successful execution result
+   */
+  protected createSuccessResult(output: NodeOutput, metadata?: Record<string, unknown>): NodeExecutionSuccessResult;
+  /**
+   * Create a pending execution result
+   */
+  protected createPendingResult(batchJobId: string, nodeId: string, executionId: string, metadata?: Record<string, unknown>): NodeExecutionPendingResult;
+  /**
+   * Create a failed execution result
+   */
+  protected createErrorResult(errors: string[], metadata?: Record<string, unknown>): NodeExecutionFailedResult;
+  /**
+   * Log execution start
+   */
+  protected logExecutionStart(context: NodeExecutionContext): void;
+  /**
+   * Log execution completion
+   */
+  protected logExecutionComplete(context: NodeExecutionContext, result: NodeExecutionResult): void;
+}
+/**
+ * Type alias for any node executor (used in registries and collections)
+ * This erases the specific schema type to allow storing different executor types together
+ */
+type AnyNodeExecutor = BaseNodeExecutor<GraphNodeType, ZodType<unknown>>;
+/**
+ * Utility functions for node execution
+ */
+declare class NodeExecutionUtils {
+  /**
+   * Safely extract nested value from object
+   */
+  static getNestedValue(obj: Record<string, unknown>, path: string, defaultValue?: unknown): unknown;
+  /**
+   * Set nested value in object
+   */
+  static setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+  /**
+   * Template string replacement
+   */
+  static replaceTemplateVariables(template: string, variables: Record<string, unknown>): string;
+}
+//#endregion
+export { AnyNodeExecutor, BaseNodeExecutor, NodeExecutionUtils, ParamsParseResult, defaultParamsSchema };
+//# sourceMappingURL=base-node.d.cts.map

package/dist/nodes/base-node.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-node.d.cts","names":[],"sources":["../../src/nodes/base-node.ts"],"mappings":";;;;;;;;;;;;;KAqBY,iBAAA;EAAyB,OAAA;EAAe,IAAA,EAAM,CAAA;AAAA;EAAQ,OAAA;EAAgB,KAAA;AAAA;;;;;cAMrE,mBAAA,EAAmB,GAAA,CAAA,SAAA,CAAA,GAAA,CAAA,SAAA,EAAA,GAAA,CAAA,UAAA;AAAhC;;;;;;AAAA,uBAQsB,gBAAA,0BACK,aAAA,wBACH,OAAA,UAAiB,mBAAA;EAAA,SAElB,QAAA,EAAU,SAAA;cAAV,QAAA,EAAU,SAAA;EAZD;;;;;;;AAQhC;;;;;EARgC,SA4BrB,YAAA,EAAc,aAAA;EAhBQ;;;EAAA,SAqBtB,aAAA,CAAA,GAAiB,cAAA;EAMhB;;;EAAA,SADD,OAAA,CACP,MAAA,EAAQ,aAAA,EACR,IAAA,EAAM,eAAA,CAAgB,SAAA,GACtB,OAAA,EAAS,oBAAA,GACR,OAAA,CAAQ,mBAAA,IAAuB,mBAAA;EAAvB;;;EAKL,kBAAA,CACJ,KAAA,EAAO,qBAAA,EACP,QAAA,EAAU,uBAAA,GACT,OAAA,CAAQ,wBAAA;EADC;;;;;;;EAAA,UAeF,WAAA,CACR,MAAA,EAAQ,MAAA,oBACP,iBAAA,CAAkB,GAAA,CAAE,KAAA,CAAM,aAAA;EA6BnB;;;;;EAbV,cAAA,CACE,MAAA;IACG,OAAA;IAAe,IAAA,EAAM,aAAA;EAAA;IAAoB,OAAA;IAAgB,KAAA;EAAA;EA3EvD;;;EAAA,UAqFG,mBAAA,CACR,MAAA,EAAQ,UAAA,EACR,QAAA,GAAW,MAAA,oBACV,0BAAA;EAvFoC;;;EAAA,UAmG7B,mBAAA,CACR,UAAA,UACA,MAAA,UACA,WAAA,UACA,QAAA,GAAW,MAAA,oBACV,0BAAA;EAtG4B;;;EAAA,UAoHrB,iBAAA,CACR,MAAA,YACA,QAAA,GAAW,MAAA,oBACV,yBAAA;EAlGM;;;EAAA,UA6GC,iBAAA,CAAkB,OAAA,EAAS,oBAAA;EAvGnC;;;EAAA,UAkHQ,oBAAA,CAAqB,OAAA,EAAS,oBAAA,EAAsB,MAAA,EAAQ,mBAAA;AAAA;;;;;KAW5D,eAAA,GAAkB,gBAAA,CAAiB,aAAA,EAAe,OAAA;;;;cAKjD,kBAAA;EAvHR;;;EAAA,OA2HI,cAAA,CACL,GAAA,EAAK,MAAA,mBACL,IAAA,UACA,YAAA;EA/GA;;;EAAA,OAiIK,cAAA,CAAe,GAAA,EAAK,MAAA,mBAAyB,IAAA,UAAc,KAAA;EAhIrC;;;EAAA,OAqJtB,wBAAA,CAAyB,QAAA,UAAkB,SAAA,EAAW,MAAA;AAAA"}

package/dist/nodes/base-node.d.ts

@@ -0,0 +1,125 @@
+import { NodeInputData, NodeOutput } from "../types/node-io-types.js";
+import { NodeExecutionFailedResult, NodeExecutionPendingResult, NodeExecutionResult, NodeExecutionSuccessResult } from "../types/node-execution.types.js";
+import { FlowNodeForType } from "../services/flow-versions/schemas-fresh.js";
+import { GraphNodeType } from "../types/graph-node-types.js";
+import { NodeExecutionContext } from "../types-fresh.js";
+import { NodeDefinition } from "../types/node-definition.types.js";
+import { NodeConfigUpdateContext, NodeConfigUpdateEvent, NodeConfigUpdateResponse } from "../types/node-config-update.types.js";
+import z$1, { ZodType } from "zod/v4";
+
+//#region src/nodes/base-node.d.ts
+/**
+ * Result of parsing params with a schema
+ */
+type ParamsParseResult<T> = {
+  success: true;
+  data: T;
+} | {
+  success: false;
+  error: string;
+};
+/**
+ * Default params schema for nodes that don't define their own.
+ * Accepts any object - no validation.
+ */
+declare const defaultParamsSchema: z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>;
+/**
+ * Abstract base class for all node executors.
+ *
+ * @typeParam TNodeType - The GraphNodeType this executor handles
+ * @typeParam TParamsSchema - Zod schema type for node parameters (defaults to permissive record)
+ */
+declare abstract class BaseNodeExecutor<in out TNodeType extends GraphNodeType, TParamsSchema extends ZodType = typeof defaultParamsSchema> {
+  readonly nodeType: TNodeType;
+  constructor(nodeType: TNodeType);
+  /**
+   * Zod schema for validating node parameters.
+   * Override this in subclasses to provide typed param validation.
+   *
+   * @example
+   * ```typescript
+   * readonly paramsSchema = z.object({
+   *   prompt: z.string().min(1),
+   *   temperature: z.number().optional().default(0.7),
+   * });
+   * ```
+   */
+  readonly paramsSchema: TParamsSchema;
+  /**
+   * Get the static definition of this node type
+   */
+  abstract getDefinition(): NodeDefinition;
+  /**
+   * run the node
+   */
+  abstract execute(inputs: NodeInputData, node: FlowNodeForType<TNodeType>, context: NodeExecutionContext): Promise<NodeExecutionResult> | NodeExecutionResult;
+  /**
+   * Handle node configuration updates (optional per node)
+   */
+  handleConfigUpdate(event: NodeConfigUpdateEvent, _context: NodeConfigUpdateContext): Promise<NodeConfigUpdateResponse>;
+  /**
+   * Parse and validate node params using the executor's paramsSchema.
+   * Returns typed params if valid, or an error message if invalid.
+   *
+   * @param params - Raw params from node.params (Record<string, unknown>)
+   * @returns Parsed and typed params, or error
+   */
+  protected parseParams(params: Record<string, unknown>): ParamsParseResult<z$1.infer<TParamsSchema>>;
+  /**
+   * Validate node inputs.
+   * All nodes accept a generic Record<string, unknown> — actual data
+   * extraction happens via {{ expression }} templates in the node params.
+   */
+  validateInputs(inputs: unknown): {
+    isValid: true;
+    data: NodeInputData;
+  } | {
+    isValid: false;
+    error: string;
+  };
+  /**
+   * Create a successful execution result
+   */
+  protected createSuccessResult(output: NodeOutput, metadata?: Record<string, unknown>): NodeExecutionSuccessResult;
+  /**
+   * Create a pending execution result
+   */
+  protected createPendingResult(batchJobId: string, nodeId: string, executionId: string, metadata?: Record<string, unknown>): NodeExecutionPendingResult;
+  /**
+   * Create a failed execution result
+   */
+  protected createErrorResult(errors: string[], metadata?: Record<string, unknown>): NodeExecutionFailedResult;
+  /**
+   * Log execution start
+   */
+  protected logExecutionStart(context: NodeExecutionContext): void;
+  /**
+   * Log execution completion
+   */
+  protected logExecutionComplete(context: NodeExecutionContext, result: NodeExecutionResult): void;
+}
+/**
+ * Type alias for any node executor (used in registries and collections)
+ * This erases the specific schema type to allow storing different executor types together
+ */
+type AnyNodeExecutor = BaseNodeExecutor<GraphNodeType, ZodType<unknown>>;
+/**
+ * Utility functions for node execution
+ */
+declare class NodeExecutionUtils {
+  /**
+   * Safely extract nested value from object
+   */
+  static getNestedValue(obj: Record<string, unknown>, path: string, defaultValue?: unknown): unknown;
+  /**
+   * Set nested value in object
+   */
+  static setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+  /**
+   * Template string replacement
+   */
+  static replaceTemplateVariables(template: string, variables: Record<string, unknown>): string;
+}
+//#endregion
+export { AnyNodeExecutor, BaseNodeExecutor, NodeExecutionUtils, ParamsParseResult, defaultParamsSchema };
+//# sourceMappingURL=base-node.d.ts.map

package/dist/nodes/base-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-node.d.ts","names":[],"sources":["../../src/nodes/base-node.ts"],"mappings":";;;;;;;;;;;;;KAqBY,iBAAA;EAAyB,OAAA;EAAe,IAAA,EAAM,CAAA;AAAA;EAAQ,OAAA;EAAgB,KAAA;AAAA;;;;;cAMrE,mBAAA,EAAmB,GAAA,CAAA,SAAA,CAAA,GAAA,CAAA,SAAA,EAAA,GAAA,CAAA,UAAA;AAAhC;;;;;;AAAA,uBAQsB,gBAAA,0BACK,aAAA,wBACH,OAAA,UAAiB,mBAAA;EAAA,SAElB,QAAA,EAAU,SAAA;cAAV,QAAA,EAAU,SAAA;EAZD;;;;;;;AAQhC;;;;;EARgC,SA4BrB,YAAA,EAAc,aAAA;EAhBQ;;;EAAA,SAqBtB,aAAA,CAAA,GAAiB,cAAA;EAMhB;;;EAAA,SADD,OAAA,CACP,MAAA,EAAQ,aAAA,EACR,IAAA,EAAM,eAAA,CAAgB,SAAA,GACtB,OAAA,EAAS,oBAAA,GACR,OAAA,CAAQ,mBAAA,IAAuB,mBAAA;EAAvB;;;EAKL,kBAAA,CACJ,KAAA,EAAO,qBAAA,EACP,QAAA,EAAU,uBAAA,GACT,OAAA,CAAQ,wBAAA;EADC;;;;;;;EAAA,UAeF,WAAA,CACR,MAAA,EAAQ,MAAA,oBACP,iBAAA,CAAkB,GAAA,CAAE,KAAA,CAAM,aAAA;EA6BnB;;;;;EAbV,cAAA,CACE,MAAA;IACG,OAAA;IAAe,IAAA,EAAM,aAAA;EAAA;IAAoB,OAAA;IAAgB,KAAA;EAAA;EA3EvD;;;EAAA,UAqFG,mBAAA,CACR,MAAA,EAAQ,UAAA,EACR,QAAA,GAAW,MAAA,oBACV,0BAAA;EAvFoC;;;EAAA,UAmG7B,mBAAA,CACR,UAAA,UACA,MAAA,UACA,WAAA,UACA,QAAA,GAAW,MAAA,oBACV,0BAAA;EAtG4B;;;EAAA,UAoHrB,iBAAA,CACR,MAAA,YACA,QAAA,GAAW,MAAA,oBACV,yBAAA;EAlGM;;;EAAA,UA6GC,iBAAA,CAAkB,OAAA,EAAS,oBAAA;EAvGnC;;;EAAA,UAkHQ,oBAAA,CAAqB,OAAA,EAAS,oBAAA,EAAsB,MAAA,EAAQ,mBAAA;AAAA;;;;;KAW5D,eAAA,GAAkB,gBAAA,CAAiB,aAAA,EAAe,OAAA;;;;cAKjD,kBAAA;EAvHR;;;EAAA,OA2HI,cAAA,CACL,GAAA,EAAK,MAAA,mBACL,IAAA,UACA,YAAA;EA/GA;;;EAAA,OAiIK,cAAA,CAAe,GAAA,EAAK,MAAA,mBAAyB,IAAA,UAAc,KAAA;EAhIrC;;;EAAA,OAqJtB,wBAAA,CAAyB,QAAA,UAAkB,SAAA,EAAW,MAAA;AAAA"}