@invect/core 0.0.1

package/dist/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","names":[],"sources":["../../src/types/validation.ts"],"sourcesContent":["// Flow validation types shared between frontend and backend\nimport type {\n  FlowNodeDefinitions,\n  InvectDefinition,\n  FlowEdge,\n} from '../services/flow-versions/schemas-fresh';\n\ninterface ValidationOutput {\n  message: string;\n\n  // Optional fields for frontend highlighting\n  nodeId?: string;\n  edgeId?: string;\n  sourceNodeId?: string;\n  targetNodeId?: string;\n  sourceNodeType?: string;\n  targetNodeType?: string;\n  additionalContext?: Record<string, unknown>;\n}\n\n// Internal validation types for the validation engine\nexport interface ValidationIssue extends ValidationOutput {\n  severity: 'error' | 'warning';\n  type: string;\n}\n\nexport interface GraphAnalysis {\n  nodeMap: Map<string, FlowNodeDefinitions>;\n  edgeMap: Map<string, FlowEdge>;\n  incomingEdges: Map<string, FlowEdge[]>;\n  outgoingEdges: Map<string, FlowEdge[]>;\n}\n\nexport interface FlowValidationError extends ValidationOutput {\n  severity: 'error';\n  type: keyof (typeof FLOW_VALIDATION_ERROR_TYPES)['ERROR'];\n}\n\nexport interface FlowValidationWarning extends ValidationOutput {\n  severity: 'warning';\n  type: keyof (typeof FLOW_VALIDATION_ERROR_TYPES)['WARNING'];\n}\n\nexport type FlowValidationResult =\n  | {\n      isValid: false;\n      errors: FlowValidationError[];\n      warnings: FlowValidationWarning[];\n    }\n  | {\n      isValid: true;\n      warnings?: FlowValidationWarning[];\n    };\n\nexport interface FlowValidationErrorResponse {\n  message: string;\n  validation: FlowValidationResult;\n}\n\n// ─── Error / Warning type constants ──────────────────────────────────────────\n//\n// Errors  = will cause execution to crash or throw (the flow cannot run).\n// Warnings = probably unintended but the flow will still execute.\n\nexport const FLOW_VALIDATION_ERROR_TYPES = {\n  ERROR: {\n    INVALID_EDGE_REFERENCE: 'INVALID_EDGE_REFERENCE',\n    SELF_REFERENCING_EDGE: 'SELF_REFERENCING_EDGE',\n    CIRCULAR_DEPENDENCY: 'CIRCULAR_DEPENDENCY',\n    MULTIPLE_MANUAL_TRIGGERS: 'MULTIPLE_MANUAL_TRIGGERS',\n    VALIDATION_SYSTEM_ERROR: 'VALIDATION_SYSTEM_ERROR',\n  },\n  WARNING: {\n    EMPTY_FLOW: 'EMPTY_FLOW',\n    ENTRY_NODE_HAS_INCOMING_EDGES: 'ENTRY_NODE_HAS_INCOMING_EDGES',\n    DISCONNECTED_NODE: 'DISCONNECTED_NODE',\n    DUPLICATE_EDGE: 'DUPLICATE_EDGE',\n  },\n} as const;\n\n// ─── Validation context ──────────────────────────────────────────────────────\n\nexport class ValidationContext {\n  public readonly definition: InvectDefinition;\n  public readonly analysis: GraphAnalysis;\n  public readonly issues: ValidationIssue[] = [];\n\n  constructor(definition: InvectDefinition, analysis: GraphAnalysis) {\n    this.definition = definition;\n    this.analysis = analysis;\n  }\n\n  addError(type: string, message: string, context?: Partial<ValidationIssue>): void {\n    this.issues.push({ severity: 'error', type, message, ...context });\n  }\n\n  addWarning(type: string, message: string, context?: Partial<ValidationIssue>): void {\n    this.issues.push({ severity: 'warning', type, message, ...context });\n  }\n\n  hasErrors(): boolean {\n    return this.issues.some((issue) => issue.severity === 'error');\n  }\n}\n"],"mappings":";AAgEA,MAAa,8BAA8B;CACzC,OAAO;EACL,wBAAwB;EACxB,uBAAuB;EACvB,qBAAqB;EACrB,0BAA0B;EAC1B,yBAAyB;EAC1B;CACD,SAAS;EACP,YAAY;EACZ,+BAA+B;EAC/B,mBAAmB;EACnB,gBAAgB;EACjB;CACF;AAID,IAAa,oBAAb,MAA+B;CAC7B;CACA;CACA,SAA4C,EAAE;CAE9C,YAAY,YAA8B,UAAyB;AACjE,OAAK,aAAa;AAClB,OAAK,WAAW;;CAGlB,SAAS,MAAc,SAAiB,SAA0C;AAChF,OAAK,OAAO,KAAK;GAAE,UAAU;GAAS;GAAM;GAAS,GAAG;GAAS,CAAC;;CAGpE,WAAW,MAAc,SAAiB,SAA0C;AAClF,OAAK,OAAO,KAAK;GAAE,UAAU;GAAW;GAAM;GAAS,GAAG;GAAS,CAAC;;CAGtE,YAAqB;AACnB,SAAO,KAAK,OAAO,MAAM,UAAU,MAAM,aAAa,QAAQ"}

package/dist/types-export.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_base = require("./types/base.cjs");
+const require_ai_types = require("./services/ai/ai-types.cjs");
+const require_graph_node_types = require("./types/graph-node-types.cjs");
+const require_validation = require("./types/validation.cjs");
+exports.BatchProvider = require_ai_types.BatchProvider;
+exports.FLOW_VALIDATION_ERROR_TYPES = require_validation.FLOW_VALIDATION_ERROR_TYPES;
+exports.FlowRunStatus = require_base.FlowRunStatus;
+exports.GRAPH_NODE_TYPE_NAMES = require_graph_node_types.GRAPH_NODE_TYPE_NAMES;
+exports.GraphNodeType = require_graph_node_types.GraphNodeType;
+exports.NodeExecutionStatus = require_base.NodeExecutionStatus;

package/dist/types-export.d.cts

@@ -0,0 +1,25 @@
+import { FlowRunStatus, NodeExecutionStatus } from "./types/base.cjs";
+import { PaginatedResponse, QueryOptions } from "./types/schemas/pagination-sort-filter.cjs";
+import { ExecutionConfig, InvectConfig, InvectDatabaseConfig, Logger, LoggingConfig, queryDatabasesConfigSchema } from "./types/schemas-fresh/invect-config.cjs";
+import { InputMappingConfig, NodeIncomingDataObject, NodeInputData, NodeOutput, NodeOutputs, OutputVariable, OutputVariables, StructuredOutput } from "./types/node-io-types.cjs";
+import { NodeExecutionResult } from "./types/node-execution.types.cjs";
+import { CreateFlowVersionRequest, FlowEdge, FlowNodeDefinitions, InvectDefinition, MapperConfig } from "./services/flow-versions/schemas-fresh.cjs";
+import { AddedToolInstance, AgentExecutionOutput, AgentFinishReason, AgentMessage, AgentStopCondition, AgentToolCall, AgentToolCategory, AgentToolDefinition, AgentToolResult, ConfiguredToolDefinition, ToolExecutionRecord } from "./types/agent-tool.types.cjs";
+import { DatabaseConnectionConfig, SQLQueryResult, SubmitPromptRequest, SubmitSQLQueryRequest } from "./services/node-data.service.cjs";
+import { GRAPH_NODE_TYPE_NAMES, GraphNodeType } from "./types/graph-node-types.cjs";
+import { FlowRunContext } from "./types-fresh.cjs";
+import { FlowRunHookContext, InvectPlugin, InvectPluginContext, InvectPluginEndpoint, InvectPluginHooks, InvectPluginInitResult, InvectPluginSchema, NodeExecutionHookContext, NodeExecutionHookResult, PluginDatabaseApi, PluginEndpointContext, PluginEndpointResponse, PluginFieldAttribute, PluginFieldType, PluginHookRunner, PluginTableDefinition } from "./types/plugin.types.cjs";
+import { CreateFlowRunInput, FlowRun, UpdateFlowRunInput } from "./services/flow-runs/flow-runs.model.cjs";
+import { CreateFlowInput, Flow, UpdateFlowInput } from "./services/flows/flows.model.cjs";
+import { CreateNodeExecutionInput, NodeExecution, UpdateNodeExecutionInput } from "./services/node-executions/node-executions.model.cjs";
+import { CreateTriggerInput, FlowTriggerRegistration, TriggerExecutionOptions, TriggerType, UpdateTriggerInput } from "./services/triggers/trigger.types.cjs";
+import { BatchProvider, Model } from "./services/ai/ai-types.cjs";
+import { FlowVersion } from "./database/schema-sqlite.cjs";
+import { EndEvent, ExecutionSnapshotEvent, ExecutionStreamEvent, FlowRunUpdatedEvent, HeartbeatEvent, NodeExecutionCreatedEvent, NodeExecutionUpdatedEvent } from "./services/execution-event-bus.cjs";
+import { ExecuteFlowOptions, FlowInputs, FlowRunResult } from "./services/flow-runs/flow-runs.service.cjs";
+import { NodeConfigUpdateContext, NodeConfigUpdateEvent, NodeConfigUpdateResponse } from "./types/node-config-update.types.cjs";
+import { NodeExecutionStatusInfo, NodeVisualStatus, Position, ReactFlowData, ReactFlowEdge, ReactFlowNode, ReactFlowNodeData, TypedReactFlowData } from "./services/react-flow-renderer.service.cjs";
+import { FLOW_VALIDATION_ERROR_TYPES, FlowValidationError, FlowValidationResult, FlowValidationWarning, ValidationIssue } from "./types/validation.cjs";
+import { LogLevel, LogScopeName, ScopedLoggingConfig } from "./utils/logger.cjs";
+import { DashboardStats } from "./invect-core.cjs";
+export { type AddedToolInstance, type AgentExecutionOutput, type AgentFinishReason, type AgentMessage, type AgentStopCondition, type AgentToolCall, type AgentToolCategory, type AgentToolDefinition, type AgentToolResult, BatchProvider, type ConfiguredToolDefinition, type CreateFlowInput as CreateFlowDto, type CreateFlowInput as CreateFlowRequest, type CreateFlowRunInput, type CreateFlowVersionRequest as CreateFlowVersionDto, type CreateFlowVersionRequest, type CreateNodeExecutionInput, type CreateTriggerInput, type DashboardStats, type queryDatabasesConfigSchema as DatabaseConfig, type DatabaseConnectionConfig, type EndEvent, type ExecuteFlowOptions, type ExecutionConfig, type NodeExecutionResult as ExecutionResult, type ExecutionSnapshotEvent, type ExecutionStreamEvent, FLOW_VALIDATION_ERROR_TYPES, type Flow, type FlowEdge, type FlowInputs, type FlowNodeDefinitions as FlowNode, type FlowRun, type FlowRunContext, type FlowRunHookContext, type FlowRunResult, FlowRunStatus, type FlowRunUpdatedEvent, type FlowTriggerRegistration, type FlowValidationError, type FlowValidationResult, type FlowValidationWarning, type FlowVersion, GRAPH_NODE_TYPE_NAMES, GraphNodeType, type HeartbeatEvent, type InputMappingConfig, type InvectConfig, type InvectDatabaseConfig, type InvectDefinition, type InvectPlugin, type InvectPluginContext, type InvectPluginEndpoint, type InvectPluginHooks, type InvectPluginInitResult, type InvectPluginSchema, type LogLevel, type LogScopeName, type Logger, type LoggingConfig, type MapperConfig, type Model, type NodeConfigUpdateContext, type NodeConfigUpdateEvent, type NodeConfigUpdateResponse, type NodeExecution, type NodeExecutionCreatedEvent, type NodeExecutionHookContext, type NodeExecutionHookResult, NodeExecutionStatus, type NodeExecutionStatusInfo, type NodeExecutionUpdatedEvent, type NodeIncomingDataObject, type NodeInputData, type NodeOutput, type NodeOutputs, type NodeVisualStatus, type OutputVariable, type OutputVariables, type PaginatedResponse, type PluginDatabaseApi, type PluginEndpointContext, type PluginEndpointResponse, type PluginFieldAttribute, type PluginFieldType, type PluginHookRunner, type PluginTableDefinition, type Position, type QueryOptions, type ReactFlowData, type ReactFlowEdge, type ReactFlowNode, type ReactFlowNodeData, type SQLQueryResult, type ScopedLoggingConfig, type StructuredOutput, type SubmitPromptRequest, type SubmitSQLQueryRequest, type ToolExecutionRecord, type TriggerExecutionOptions, type TriggerType, type TypedReactFlowData, type UpdateFlowInput, type UpdateFlowRunInput, type UpdateNodeExecutionInput, type UpdateTriggerInput, type ValidationIssue };

package/dist/types-export.d.ts

@@ -0,0 +1,25 @@
+import { FlowRunStatus, NodeExecutionStatus } from "./types/base.js";
+import { PaginatedResponse, QueryOptions } from "./types/schemas/pagination-sort-filter.js";
+import { ExecutionConfig, InvectConfig, InvectDatabaseConfig, Logger, LoggingConfig, queryDatabasesConfigSchema } from "./types/schemas-fresh/invect-config.js";
+import { InputMappingConfig, NodeIncomingDataObject, NodeInputData, NodeOutput, NodeOutputs, OutputVariable, OutputVariables, StructuredOutput } from "./types/node-io-types.js";
+import { NodeExecutionResult } from "./types/node-execution.types.js";
+import { CreateFlowVersionRequest, FlowEdge, FlowNodeDefinitions, InvectDefinition, MapperConfig } from "./services/flow-versions/schemas-fresh.js";
+import { AddedToolInstance, AgentExecutionOutput, AgentFinishReason, AgentMessage, AgentStopCondition, AgentToolCall, AgentToolCategory, AgentToolDefinition, AgentToolResult, ConfiguredToolDefinition, ToolExecutionRecord } from "./types/agent-tool.types.js";
+import { DatabaseConnectionConfig, SQLQueryResult, SubmitPromptRequest, SubmitSQLQueryRequest } from "./services/node-data.service.js";
+import { GRAPH_NODE_TYPE_NAMES, GraphNodeType } from "./types/graph-node-types.js";
+import { FlowRunContext } from "./types-fresh.js";
+import { FlowRunHookContext, InvectPlugin, InvectPluginContext, InvectPluginEndpoint, InvectPluginHooks, InvectPluginInitResult, InvectPluginSchema, NodeExecutionHookContext, NodeExecutionHookResult, PluginDatabaseApi, PluginEndpointContext, PluginEndpointResponse, PluginFieldAttribute, PluginFieldType, PluginHookRunner, PluginTableDefinition } from "./types/plugin.types.js";
+import { CreateFlowRunInput, FlowRun, UpdateFlowRunInput } from "./services/flow-runs/flow-runs.model.js";
+import { CreateFlowInput, Flow, UpdateFlowInput } from "./services/flows/flows.model.js";
+import { CreateNodeExecutionInput, NodeExecution, UpdateNodeExecutionInput } from "./services/node-executions/node-executions.model.js";
+import { CreateTriggerInput, FlowTriggerRegistration, TriggerExecutionOptions, TriggerType, UpdateTriggerInput } from "./services/triggers/trigger.types.js";
+import { BatchProvider, Model } from "./services/ai/ai-types.js";
+import { FlowVersion } from "./database/schema-sqlite.js";
+import { EndEvent, ExecutionSnapshotEvent, ExecutionStreamEvent, FlowRunUpdatedEvent, HeartbeatEvent, NodeExecutionCreatedEvent, NodeExecutionUpdatedEvent } from "./services/execution-event-bus.js";
+import { ExecuteFlowOptions, FlowInputs, FlowRunResult } from "./services/flow-runs/flow-runs.service.js";
+import { NodeConfigUpdateContext, NodeConfigUpdateEvent, NodeConfigUpdateResponse } from "./types/node-config-update.types.js";
+import { NodeExecutionStatusInfo, NodeVisualStatus, Position, ReactFlowData, ReactFlowEdge, ReactFlowNode, ReactFlowNodeData, TypedReactFlowData } from "./services/react-flow-renderer.service.js";
+import { FLOW_VALIDATION_ERROR_TYPES, FlowValidationError, FlowValidationResult, FlowValidationWarning, ValidationIssue } from "./types/validation.js";
+import { LogLevel, LogScopeName, ScopedLoggingConfig } from "./utils/logger.js";
+import { DashboardStats } from "./invect-core.js";
+export { type AddedToolInstance, type AgentExecutionOutput, type AgentFinishReason, type AgentMessage, type AgentStopCondition, type AgentToolCall, type AgentToolCategory, type AgentToolDefinition, type AgentToolResult, BatchProvider, type ConfiguredToolDefinition, type CreateFlowInput as CreateFlowDto, type CreateFlowInput as CreateFlowRequest, type CreateFlowRunInput, type CreateFlowVersionRequest as CreateFlowVersionDto, type CreateFlowVersionRequest, type CreateNodeExecutionInput, type CreateTriggerInput, type DashboardStats, type queryDatabasesConfigSchema as DatabaseConfig, type DatabaseConnectionConfig, type EndEvent, type ExecuteFlowOptions, type ExecutionConfig, type NodeExecutionResult as ExecutionResult, type ExecutionSnapshotEvent, type ExecutionStreamEvent, FLOW_VALIDATION_ERROR_TYPES, type Flow, type FlowEdge, type FlowInputs, type FlowNodeDefinitions as FlowNode, type FlowRun, type FlowRunContext, type FlowRunHookContext, type FlowRunResult, FlowRunStatus, type FlowRunUpdatedEvent, type FlowTriggerRegistration, type FlowValidationError, type FlowValidationResult, type FlowValidationWarning, type FlowVersion, GRAPH_NODE_TYPE_NAMES, GraphNodeType, type HeartbeatEvent, type InputMappingConfig, type InvectConfig, type InvectDatabaseConfig, type InvectDefinition, type InvectPlugin, type InvectPluginContext, type InvectPluginEndpoint, type InvectPluginHooks, type InvectPluginInitResult, type InvectPluginSchema, type LogLevel, type LogScopeName, type Logger, type LoggingConfig, type MapperConfig, type Model, type NodeConfigUpdateContext, type NodeConfigUpdateEvent, type NodeConfigUpdateResponse, type NodeExecution, type NodeExecutionCreatedEvent, type NodeExecutionHookContext, type NodeExecutionHookResult, NodeExecutionStatus, type NodeExecutionStatusInfo, type NodeExecutionUpdatedEvent, type NodeIncomingDataObject, type NodeInputData, type NodeOutput, type NodeOutputs, type NodeVisualStatus, type OutputVariable, type OutputVariables, type PaginatedResponse, type PluginDatabaseApi, type PluginEndpointContext, type PluginEndpointResponse, type PluginFieldAttribute, type PluginFieldType, type PluginHookRunner, type PluginTableDefinition, type Position, type QueryOptions, type ReactFlowData, type ReactFlowEdge, type ReactFlowNode, type ReactFlowNodeData, type SQLQueryResult, type ScopedLoggingConfig, type StructuredOutput, type SubmitPromptRequest, type SubmitSQLQueryRequest, type ToolExecutionRecord, type TriggerExecutionOptions, type TriggerType, type TypedReactFlowData, type UpdateFlowInput, type UpdateFlowRunInput, type UpdateNodeExecutionInput, type UpdateTriggerInput, type ValidationIssue };

package/dist/types-export.js

@@ -0,0 +1,5 @@
+import { FlowRunStatus, NodeExecutionStatus } from "./types/base.js";
+import { BatchProvider } from "./services/ai/ai-types.js";
+import { GRAPH_NODE_TYPE_NAMES, GraphNodeType } from "./types/graph-node-types.js";
+import { FLOW_VALIDATION_ERROR_TYPES } from "./types/validation.js";
+export { BatchProvider, FLOW_VALIDATION_ERROR_TYPES, FlowRunStatus, GRAPH_NODE_TYPE_NAMES, GraphNodeType, NodeExecutionStatus };

package/dist/types-fresh.cjs

@@ -0,0 +1,9 @@
+require("./_virtual/_rolldown/runtime.cjs");
+require("./types/graph-node-types.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/types-fresh.ts
+const metadataSchema = zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()).optional();
+//#endregion
+exports.metadataSchema = metadataSchema;
+
+//# sourceMappingURL=types-fresh.cjs.map

package/dist/types-fresh.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-fresh.cjs","names":["z"],"sources":["../src/types-fresh.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport type { NodeExecutionResult } from './types/node-execution.types';\nimport type { NodeOutput } from './types/node-io-types';\nimport type { Logger } from './types/schemas-fresh/invect-config';\nimport type { FlowEdge, FlowNodeDefinitions } from './services/flow-versions/schemas-fresh';\nimport type { BatchProvider, PromptResult } from './services/ai/base-client';\nimport type {\n  AgentToolDefinition,\n  AgentMessage,\n  AgentPromptResult,\n} from './types/agent-tool.types';\nimport type { SubmitPromptRequest } from './services/node-data.service';\nexport type { SubmitPromptRequest };\n\n/**\n * Request to run an agent prompt with tools\n */\nexport interface SubmitAgentPromptRequest {\n  model: string;\n  messages: AgentMessage[];\n  tools: AgentToolDefinition[];\n  systemPrompt?: string;\n  temperature?: number;\n  maxTokens?: number;\n  provider: BatchProvider;\n  credentialId: string;\n  toolChoice?: 'auto' | 'none' | { type: 'tool'; name: string };\n  /** Whether to allow parallel tool calls (defaults to true) */\n  parallelToolCalls?: boolean;\n  /** When true, the first LLM call is submitted via the Batch API. */\n  useBatchProcessing?: boolean;\n  /** Node ID (required when useBatchProcessing is true). */\n  nodeId?: string;\n  /** Flow run ID (required when useBatchProcessing is true). */\n  flowRunId?: string;\n}\n\n/**\n * Result of a submitPrompt call — either a synchronous prompt result\n * or a batch submission acknowledgement.\n */\nexport type SubmitPromptResult =\n  | PromptResult\n  | {\n      type: 'batch_submitted';\n      batchJobId: string;\n      nodeId: string;\n      flowRunId: string;\n    };\n\n/**\n * Input shape for recording a tool execution (agent nodes).\n */\nexport interface RecordToolExecutionInput {\n  nodeExecutionId: string;\n  flowRunId: string;\n  toolId: string;\n  toolName: string;\n  iteration: number;\n  input: Record<string, unknown>;\n  output?: unknown;\n  error?: string;\n  success: boolean;\n  startedAt: string;\n  completedAt?: string;\n  duration?: number;\n}\n\n/**\n * Context of an individual run of a flow\n */\nexport interface FlowRunContext {\n  flowId: string;\n  flowVersion: number;\n  flowRunId: string;\n\n  globalConfig: Record<string, string | number | boolean | null>;\n  // Optional overrides from the default global Invect config for this specific flow\n  flowParams: Record<string, unknown>; // TODO: useBatchProcessing: boolean; should existi\n\n  // inputs values provided to this flow (includes trigger data when triggered by webhook/cron)\n  flowInputs: Record<string, unknown>;\n\n  /**\n   * Incoming data from upstream nodes, keyed by reference ID.\n   * Used by nodes that do their own template processing (e.g., Template String).\n   * Structure: { ref_id: { output: value, ... }, ... }\n   */\n  incomingData?: Record<string, unknown>;\n\n  /** All edges in the flow graph */\n  edges: readonly FlowEdge[];\n  /** All nodes in the flow graph */\n  nodes: readonly FlowNodeDefinitions[];\n\n  nodeExecutionResults: Map<string, NodeExecutionResult>;\n\n  /** All collected outputs by nodeId */\n  allNodeOutputs: Map<string, NodeOutput>;\n\n  /** All collected inputs by nodeId */\n  allNodeInputs: Map<string, unknown>;\n\n  /** Skipped node tracking */\n  skippedNodeIds: Set<string>;\n\n  logger: Logger;\n\n  error?: string;\n  startedAt: Date | string;\n  completedAt?: Date | string;\n  durationMs?: number;\n  initiatedBy?: string;\n\n  functions: {\n    // Template rendering ({{ expression }} syntax)\n    runTemplateReplacement: (\n      template: string,\n      variables: {\n        [key: string]: unknown;\n      },\n    ) => Promise<string>;\n\n    // Flow control - mark downstream nodes as skipped\n    markDownstreamNodesAsSkipped?: (\n      nodeId: string,\n      edges: readonly FlowEdge[],\n      skippedNodes: Set<string>,\n      isFromIfElse?: boolean,\n    ) => void;\n\n    // Credential retrieval for node authentication\n    getCredential?: (credentialId: string) => Promise<{\n      id: string;\n      name: string;\n      type: string;\n      authType: string;\n      config: Record<string, unknown>;\n    } | null>;\n\n    // Model prompt submission - has flow implications (batch processing)\n    submitPrompt?: (request: SubmitPromptRequest) => Promise<SubmitPromptResult>;\n\n    // Agent prompt submission - supports batch processing on first iteration\n    submitAgentPrompt?: (\n      request: SubmitAgentPromptRequest,\n    ) => Promise<\n      | AgentPromptResult\n      | { type: 'batch_submitted'; batchJobId: string; nodeId: string; flowRunId: string }\n    >;\n\n    // Record tool execution for agent nodes\n    recordToolExecution?: (input: RecordToolExecutionInput) => Promise<{ id: string } | null>;\n  };\n}\n\n// Node and execution types (expanded stubs)\nexport interface NodeExecutionContext extends FlowRunContext {\n  nodeId: string;\n  traceId?: string;\n}\n\nexport const metadataSchema = z.record(z.string(), z.unknown()).optional();\n\nexport type MetaData = z.infer<typeof metadataSchema>;\n\n// Re-export GraphNodeType and GRAPH_NODE_TYPE_NAMES from the pure types file\n// This separation is critical - they must not be in a file with Zod schemas\n// because the frontend imports them at runtime\nexport { GraphNodeType, GRAPH_NODE_TYPE_NAMES } from './types/graph-node-types';\n"],"mappings":";;;;AAkKA,MAAa,iBAAiBA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,SAAS,CAAC,CAAC,UAAU"}

package/dist/types-fresh.d.cts

@@ -0,0 +1,129 @@
+import { Logger } from "./types/schemas-fresh/invect-config.cjs";
+import { NodeOutput } from "./types/node-io-types.cjs";
+import { NodeExecutionResult } from "./types/node-execution.types.cjs";
+import { FlowEdge, FlowNodeDefinitions } from "./services/flow-versions/schemas-fresh.cjs";
+import { AgentMessage, AgentPromptResult, AgentToolDefinition } from "./types/agent-tool.types.cjs";
+import { SubmitPromptRequest } from "./services/node-data.service.cjs";
+import { GRAPH_NODE_TYPE_NAMES, GraphNodeType } from "./types/graph-node-types.cjs";
+import { BatchProvider, PromptResult } from "./services/ai/ai-types.cjs";
+import { z } from "zod/v4";
+
+//#region src/types-fresh.d.ts
+/**
+ * Request to run an agent prompt with tools
+ */
+interface SubmitAgentPromptRequest {
+  model: string;
+  messages: AgentMessage[];
+  tools: AgentToolDefinition[];
+  systemPrompt?: string;
+  temperature?: number;
+  maxTokens?: number;
+  provider: BatchProvider;
+  credentialId: string;
+  toolChoice?: 'auto' | 'none' | {
+    type: 'tool';
+    name: string;
+  };
+  /** Whether to allow parallel tool calls (defaults to true) */
+  parallelToolCalls?: boolean;
+  /** When true, the first LLM call is submitted via the Batch API. */
+  useBatchProcessing?: boolean;
+  /** Node ID (required when useBatchProcessing is true). */
+  nodeId?: string;
+  /** Flow run ID (required when useBatchProcessing is true). */
+  flowRunId?: string;
+}
+/**
+ * Result of a submitPrompt call — either a synchronous prompt result
+ * or a batch submission acknowledgement.
+ */
+type SubmitPromptResult = PromptResult | {
+  type: 'batch_submitted';
+  batchJobId: string;
+  nodeId: string;
+  flowRunId: string;
+};
+/**
+ * Input shape for recording a tool execution (agent nodes).
+ */
+interface RecordToolExecutionInput {
+  nodeExecutionId: string;
+  flowRunId: string;
+  toolId: string;
+  toolName: string;
+  iteration: number;
+  input: Record<string, unknown>;
+  output?: unknown;
+  error?: string;
+  success: boolean;
+  startedAt: string;
+  completedAt?: string;
+  duration?: number;
+}
+/**
+ * Context of an individual run of a flow
+ */
+interface FlowRunContext {
+  flowId: string;
+  flowVersion: number;
+  flowRunId: string;
+  globalConfig: Record<string, string | number | boolean | null>;
+  flowParams: Record<string, unknown>;
+  flowInputs: Record<string, unknown>;
+  /**
+   * Incoming data from upstream nodes, keyed by reference ID.
+   * Used by nodes that do their own template processing (e.g., Template String).
+   * Structure: { ref_id: { output: value, ... }, ... }
+   */
+  incomingData?: Record<string, unknown>;
+  /** All edges in the flow graph */
+  edges: readonly FlowEdge[];
+  /** All nodes in the flow graph */
+  nodes: readonly FlowNodeDefinitions[];
+  nodeExecutionResults: Map<string, NodeExecutionResult>;
+  /** All collected outputs by nodeId */
+  allNodeOutputs: Map<string, NodeOutput>;
+  /** All collected inputs by nodeId */
+  allNodeInputs: Map<string, unknown>;
+  /** Skipped node tracking */
+  skippedNodeIds: Set<string>;
+  logger: Logger;
+  error?: string;
+  startedAt: Date | string;
+  completedAt?: Date | string;
+  durationMs?: number;
+  initiatedBy?: string;
+  functions: {
+    runTemplateReplacement: (template: string, variables: {
+      [key: string]: unknown;
+    }) => Promise<string>;
+    markDownstreamNodesAsSkipped?: (nodeId: string, edges: readonly FlowEdge[], skippedNodes: Set<string>, isFromIfElse?: boolean) => void;
+    getCredential?: (credentialId: string) => Promise<{
+      id: string;
+      name: string;
+      type: string;
+      authType: string;
+      config: Record<string, unknown>;
+    } | null>;
+    submitPrompt?: (request: SubmitPromptRequest) => Promise<SubmitPromptResult>;
+    submitAgentPrompt?: (request: SubmitAgentPromptRequest) => Promise<AgentPromptResult | {
+      type: 'batch_submitted';
+      batchJobId: string;
+      nodeId: string;
+      flowRunId: string;
+    }>;
+    recordToolExecution?: (input: RecordToolExecutionInput) => Promise<{
+      id: string;
+    } | null>;
+  };
+}
+interface NodeExecutionContext extends FlowRunContext {
+  nodeId: string;
+  traceId?: string;
+}
+declare const metadataSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+type MetaData = z.infer<typeof metadataSchema>;
+//#endregion
+export { FlowRunContext, MetaData, NodeExecutionContext, RecordToolExecutionInput, SubmitAgentPromptRequest, SubmitPromptResult, metadataSchema };
+//# sourceMappingURL=types-fresh.d.cts.map

package/dist/types-fresh.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-fresh.d.cts","names":[],"sources":["../src/types-fresh.ts"],"mappings":";;;;;;;;;;;;;;UAiBiB,wBAAA;EACf,KAAA;EACA,QAAA,EAAU,YAAA;EACV,KAAA,EAAO,mBAAA;EACP,YAAA;EACA,WAAA;EACA,SAAA;EACA,QAAA,EAAU,aAAA;EACV,YAAA;EACA,UAAA;IAAiC,IAAA;IAAc,IAAA;EAAA;EAL/C;EAOA,iBAAA;EALA;EAOA,kBAAA;EANU;EAQV,MAAA;EANA;EAQA,SAAA;AAAA;;;;;KAOU,kBAAA,GACR,YAAA;EAEE,IAAA;EACA,UAAA;EACA,MAAA;EACA,SAAA;AAAA;;;;UAMW,wBAAA;EACf,eAAA;EACA,SAAA;EACA,MAAA;EACA,QAAA;EACA,SAAA;EACA,KAAA,EAAO,MAAA;EACP,MAAA;EACA,KAAA;EACA,OAAA;EACA,SAAA;EACA,WAAA;EACA,QAAA;AAAA;;;;UAMe,cAAA;EACf,MAAA;EACA,WAAA;EACA,SAAA;EAEA,YAAA,EAAc,MAAA;EAEd,UAAA,EAAY,MAAA;EAGZ,UAAA,EAAY,MAAA;EAViB;;;;;EAiB7B,YAAA,GAAe,MAAA;EAGC;EAAhB,KAAA,WAAgB,QAAA;EAIkB;EAFlC,KAAA,WAAgB,mBAAA;EAEhB,oBAAA,EAAsB,GAAA,SAAY,mBAAA;EAGlB;EAAhB,cAAA,EAAgB,GAAA,SAAY,UAAA;EAMZ;EAHhB,aAAA,EAAe,GAAA;EAQJ;EALX,cAAA,EAAgB,GAAA;EAEhB,MAAA,EAAQ,MAAA;EAER,KAAA;EACA,SAAA,EAAW,IAAA;EACX,WAAA,GAAc,IAAA;EACd,UAAA;EACA,WAAA;EAEA,SAAA;IAEE,sBAAA,GACE,QAAA,UACA,SAAA;MAAA,CACG,GAAA;IAAA,MAEA,OAAA;IAGL,4BAAA,IACE,MAAA,UACA,KAAA,WAAgB,QAAA,IAChB,YAAA,EAAc,GAAA,UACd,YAAA;IAIF,aAAA,IAAiB,YAAA,aAAyB,OAAA;MACxC,EAAA;MACA,IAAA;MACA,IAAA;MACA,QAAA;MACA,MAAA,EAAQ,MAAA;IAAA;IAIV,YAAA,IAAgB,OAAA,EAAS,mBAAA,KAAwB,OAAA,CAAQ,kBAAA;IAGzD,iBAAA,IACE,OAAA,EAAS,wBAAA,KACN,OAAA,CACD,iBAAA;MACE,IAAA;MAAyB,UAAA;MAAoB,MAAA;MAAgB,SAAA;IAAA;IAInE,mBAAA,IAAuB,KAAA,EAAO,wBAAA,KAA6B,OAAA;MAAU,EAAA;IAAA;EAAA;AAAA;AAAA,UAKxD,oBAAA,SAA6B,cAAA;EAC5C,MAAA;EACA,OAAA;AAAA;AAAA,cAGW,cAAA,EAAc,CAAA,CAAA,WAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,UAAA;AAAA,KAEf,QAAA,GAAW,CAAA,CAAE,KAAA,QAAa,cAAA"}

package/dist/types-fresh.d.ts

@@ -0,0 +1,129 @@
+import { Logger } from "./types/schemas-fresh/invect-config.js";
+import { NodeOutput } from "./types/node-io-types.js";
+import { NodeExecutionResult } from "./types/node-execution.types.js";
+import { FlowEdge, FlowNodeDefinitions } from "./services/flow-versions/schemas-fresh.js";
+import { AgentMessage, AgentPromptResult, AgentToolDefinition } from "./types/agent-tool.types.js";
+import { SubmitPromptRequest } from "./services/node-data.service.js";
+import { GRAPH_NODE_TYPE_NAMES, GraphNodeType } from "./types/graph-node-types.js";
+import { BatchProvider, PromptResult } from "./services/ai/ai-types.js";
+import { z } from "zod/v4";
+
+//#region src/types-fresh.d.ts
+/**
+ * Request to run an agent prompt with tools
+ */
+interface SubmitAgentPromptRequest {
+  model: string;
+  messages: AgentMessage[];
+  tools: AgentToolDefinition[];
+  systemPrompt?: string;
+  temperature?: number;
+  maxTokens?: number;
+  provider: BatchProvider;
+  credentialId: string;
+  toolChoice?: 'auto' | 'none' | {
+    type: 'tool';
+    name: string;
+  };
+  /** Whether to allow parallel tool calls (defaults to true) */
+  parallelToolCalls?: boolean;
+  /** When true, the first LLM call is submitted via the Batch API. */
+  useBatchProcessing?: boolean;
+  /** Node ID (required when useBatchProcessing is true). */
+  nodeId?: string;
+  /** Flow run ID (required when useBatchProcessing is true). */
+  flowRunId?: string;
+}
+/**
+ * Result of a submitPrompt call — either a synchronous prompt result
+ * or a batch submission acknowledgement.
+ */
+type SubmitPromptResult = PromptResult | {
+  type: 'batch_submitted';
+  batchJobId: string;
+  nodeId: string;
+  flowRunId: string;
+};
+/**
+ * Input shape for recording a tool execution (agent nodes).
+ */
+interface RecordToolExecutionInput {
+  nodeExecutionId: string;
+  flowRunId: string;
+  toolId: string;
+  toolName: string;
+  iteration: number;
+  input: Record<string, unknown>;
+  output?: unknown;
+  error?: string;
+  success: boolean;
+  startedAt: string;
+  completedAt?: string;
+  duration?: number;
+}
+/**
+ * Context of an individual run of a flow
+ */
+interface FlowRunContext {
+  flowId: string;
+  flowVersion: number;
+  flowRunId: string;
+  globalConfig: Record<string, string | number | boolean | null>;
+  flowParams: Record<string, unknown>;
+  flowInputs: Record<string, unknown>;
+  /**
+   * Incoming data from upstream nodes, keyed by reference ID.
+   * Used by nodes that do their own template processing (e.g., Template String).
+   * Structure: { ref_id: { output: value, ... }, ... }
+   */
+  incomingData?: Record<string, unknown>;
+  /** All edges in the flow graph */
+  edges: readonly FlowEdge[];
+  /** All nodes in the flow graph */
+  nodes: readonly FlowNodeDefinitions[];
+  nodeExecutionResults: Map<string, NodeExecutionResult>;
+  /** All collected outputs by nodeId */
+  allNodeOutputs: Map<string, NodeOutput>;
+  /** All collected inputs by nodeId */
+  allNodeInputs: Map<string, unknown>;
+  /** Skipped node tracking */
+  skippedNodeIds: Set<string>;
+  logger: Logger;
+  error?: string;
+  startedAt: Date | string;
+  completedAt?: Date | string;
+  durationMs?: number;
+  initiatedBy?: string;
+  functions: {
+    runTemplateReplacement: (template: string, variables: {
+      [key: string]: unknown;
+    }) => Promise<string>;
+    markDownstreamNodesAsSkipped?: (nodeId: string, edges: readonly FlowEdge[], skippedNodes: Set<string>, isFromIfElse?: boolean) => void;
+    getCredential?: (credentialId: string) => Promise<{
+      id: string;
+      name: string;
+      type: string;
+      authType: string;
+      config: Record<string, unknown>;
+    } | null>;
+    submitPrompt?: (request: SubmitPromptRequest) => Promise<SubmitPromptResult>;
+    submitAgentPrompt?: (request: SubmitAgentPromptRequest) => Promise<AgentPromptResult | {
+      type: 'batch_submitted';
+      batchJobId: string;
+      nodeId: string;
+      flowRunId: string;
+    }>;
+    recordToolExecution?: (input: RecordToolExecutionInput) => Promise<{
+      id: string;
+    } | null>;
+  };
+}
+interface NodeExecutionContext extends FlowRunContext {
+  nodeId: string;
+  traceId?: string;
+}
+declare const metadataSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+type MetaData = z.infer<typeof metadataSchema>;
+//#endregion
+export { FlowRunContext, MetaData, NodeExecutionContext, RecordToolExecutionInput, SubmitAgentPromptRequest, SubmitPromptResult, metadataSchema };
+//# sourceMappingURL=types-fresh.d.ts.map

package/dist/types-fresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-fresh.d.ts","names":[],"sources":["../src/types-fresh.ts"],"mappings":";;;;;;;;;;;;;;UAiBiB,wBAAA;EACf,KAAA;EACA,QAAA,EAAU,YAAA;EACV,KAAA,EAAO,mBAAA;EACP,YAAA;EACA,WAAA;EACA,SAAA;EACA,QAAA,EAAU,aAAA;EACV,YAAA;EACA,UAAA;IAAiC,IAAA;IAAc,IAAA;EAAA;EAL/C;EAOA,iBAAA;EALA;EAOA,kBAAA;EANU;EAQV,MAAA;EANA;EAQA,SAAA;AAAA;;;;;KAOU,kBAAA,GACR,YAAA;EAEE,IAAA;EACA,UAAA;EACA,MAAA;EACA,SAAA;AAAA;;;;UAMW,wBAAA;EACf,eAAA;EACA,SAAA;EACA,MAAA;EACA,QAAA;EACA,SAAA;EACA,KAAA,EAAO,MAAA;EACP,MAAA;EACA,KAAA;EACA,OAAA;EACA,SAAA;EACA,WAAA;EACA,QAAA;AAAA;;;;UAMe,cAAA;EACf,MAAA;EACA,WAAA;EACA,SAAA;EAEA,YAAA,EAAc,MAAA;EAEd,UAAA,EAAY,MAAA;EAGZ,UAAA,EAAY,MAAA;EAViB;;;;;EAiB7B,YAAA,GAAe,MAAA;EAGC;EAAhB,KAAA,WAAgB,QAAA;EAIkB;EAFlC,KAAA,WAAgB,mBAAA;EAEhB,oBAAA,EAAsB,GAAA,SAAY,mBAAA;EAGlB;EAAhB,cAAA,EAAgB,GAAA,SAAY,UAAA;EAMZ;EAHhB,aAAA,EAAe,GAAA;EAQJ;EALX,cAAA,EAAgB,GAAA;EAEhB,MAAA,EAAQ,MAAA;EAER,KAAA;EACA,SAAA,EAAW,IAAA;EACX,WAAA,GAAc,IAAA;EACd,UAAA;EACA,WAAA;EAEA,SAAA;IAEE,sBAAA,GACE,QAAA,UACA,SAAA;MAAA,CACG,GAAA;IAAA,MAEA,OAAA;IAGL,4BAAA,IACE,MAAA,UACA,KAAA,WAAgB,QAAA,IAChB,YAAA,EAAc,GAAA,UACd,YAAA;IAIF,aAAA,IAAiB,YAAA,aAAyB,OAAA;MACxC,EAAA;MACA,IAAA;MACA,IAAA;MACA,QAAA;MACA,MAAA,EAAQ,MAAA;IAAA;IAIV,YAAA,IAAgB,OAAA,EAAS,mBAAA,KAAwB,OAAA,CAAQ,kBAAA;IAGzD,iBAAA,IACE,OAAA,EAAS,wBAAA,KACN,OAAA,CACD,iBAAA;MACE,IAAA;MAAyB,UAAA;MAAoB,MAAA;MAAgB,SAAA;IAAA;IAInE,mBAAA,IAAuB,KAAA,EAAO,wBAAA,KAA6B,OAAA;MAAU,EAAA;IAAA;EAAA;AAAA;AAAA,UAKxD,oBAAA,SAA6B,cAAA;EAC5C,MAAA;EACA,OAAA;AAAA;AAAA,cAGW,cAAA,EAAc,CAAA,CAAA,WAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,UAAA;AAAA,KAEf,QAAA,GAAW,CAAA,CAAE,KAAA,QAAa,cAAA"}

package/dist/types-fresh.js

@@ -0,0 +1,8 @@
+import "./types/graph-node-types.js";
+import { z } from "zod/v4";
+//#region src/types-fresh.ts
+const metadataSchema = z.record(z.string(), z.unknown()).optional();
+//#endregion
+export { metadataSchema };
+
+//# sourceMappingURL=types-fresh.js.map

package/dist/types-fresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-fresh.js","names":[],"sources":["../src/types-fresh.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport type { NodeExecutionResult } from './types/node-execution.types';\nimport type { NodeOutput } from './types/node-io-types';\nimport type { Logger } from './types/schemas-fresh/invect-config';\nimport type { FlowEdge, FlowNodeDefinitions } from './services/flow-versions/schemas-fresh';\nimport type { BatchProvider, PromptResult } from './services/ai/base-client';\nimport type {\n  AgentToolDefinition,\n  AgentMessage,\n  AgentPromptResult,\n} from './types/agent-tool.types';\nimport type { SubmitPromptRequest } from './services/node-data.service';\nexport type { SubmitPromptRequest };\n\n/**\n * Request to run an agent prompt with tools\n */\nexport interface SubmitAgentPromptRequest {\n  model: string;\n  messages: AgentMessage[];\n  tools: AgentToolDefinition[];\n  systemPrompt?: string;\n  temperature?: number;\n  maxTokens?: number;\n  provider: BatchProvider;\n  credentialId: string;\n  toolChoice?: 'auto' | 'none' | { type: 'tool'; name: string };\n  /** Whether to allow parallel tool calls (defaults to true) */\n  parallelToolCalls?: boolean;\n  /** When true, the first LLM call is submitted via the Batch API. */\n  useBatchProcessing?: boolean;\n  /** Node ID (required when useBatchProcessing is true). */\n  nodeId?: string;\n  /** Flow run ID (required when useBatchProcessing is true). */\n  flowRunId?: string;\n}\n\n/**\n * Result of a submitPrompt call — either a synchronous prompt result\n * or a batch submission acknowledgement.\n */\nexport type SubmitPromptResult =\n  | PromptResult\n  | {\n      type: 'batch_submitted';\n      batchJobId: string;\n      nodeId: string;\n      flowRunId: string;\n    };\n\n/**\n * Input shape for recording a tool execution (agent nodes).\n */\nexport interface RecordToolExecutionInput {\n  nodeExecutionId: string;\n  flowRunId: string;\n  toolId: string;\n  toolName: string;\n  iteration: number;\n  input: Record<string, unknown>;\n  output?: unknown;\n  error?: string;\n  success: boolean;\n  startedAt: string;\n  completedAt?: string;\n  duration?: number;\n}\n\n/**\n * Context of an individual run of a flow\n */\nexport interface FlowRunContext {\n  flowId: string;\n  flowVersion: number;\n  flowRunId: string;\n\n  globalConfig: Record<string, string | number | boolean | null>;\n  // Optional overrides from the default global Invect config for this specific flow\n  flowParams: Record<string, unknown>; // TODO: useBatchProcessing: boolean; should existi\n\n  // inputs values provided to this flow (includes trigger data when triggered by webhook/cron)\n  flowInputs: Record<string, unknown>;\n\n  /**\n   * Incoming data from upstream nodes, keyed by reference ID.\n   * Used by nodes that do their own template processing (e.g., Template String).\n   * Structure: { ref_id: { output: value, ... }, ... }\n   */\n  incomingData?: Record<string, unknown>;\n\n  /** All edges in the flow graph */\n  edges: readonly FlowEdge[];\n  /** All nodes in the flow graph */\n  nodes: readonly FlowNodeDefinitions[];\n\n  nodeExecutionResults: Map<string, NodeExecutionResult>;\n\n  /** All collected outputs by nodeId */\n  allNodeOutputs: Map<string, NodeOutput>;\n\n  /** All collected inputs by nodeId */\n  allNodeInputs: Map<string, unknown>;\n\n  /** Skipped node tracking */\n  skippedNodeIds: Set<string>;\n\n  logger: Logger;\n\n  error?: string;\n  startedAt: Date | string;\n  completedAt?: Date | string;\n  durationMs?: number;\n  initiatedBy?: string;\n\n  functions: {\n    // Template rendering ({{ expression }} syntax)\n    runTemplateReplacement: (\n      template: string,\n      variables: {\n        [key: string]: unknown;\n      },\n    ) => Promise<string>;\n\n    // Flow control - mark downstream nodes as skipped\n    markDownstreamNodesAsSkipped?: (\n      nodeId: string,\n      edges: readonly FlowEdge[],\n      skippedNodes: Set<string>,\n      isFromIfElse?: boolean,\n    ) => void;\n\n    // Credential retrieval for node authentication\n    getCredential?: (credentialId: string) => Promise<{\n      id: string;\n      name: string;\n      type: string;\n      authType: string;\n      config: Record<string, unknown>;\n    } | null>;\n\n    // Model prompt submission - has flow implications (batch processing)\n    submitPrompt?: (request: SubmitPromptRequest) => Promise<SubmitPromptResult>;\n\n    // Agent prompt submission - supports batch processing on first iteration\n    submitAgentPrompt?: (\n      request: SubmitAgentPromptRequest,\n    ) => Promise<\n      | AgentPromptResult\n      | { type: 'batch_submitted'; batchJobId: string; nodeId: string; flowRunId: string }\n    >;\n\n    // Record tool execution for agent nodes\n    recordToolExecution?: (input: RecordToolExecutionInput) => Promise<{ id: string } | null>;\n  };\n}\n\n// Node and execution types (expanded stubs)\nexport interface NodeExecutionContext extends FlowRunContext {\n  nodeId: string;\n  traceId?: string;\n}\n\nexport const metadataSchema = z.record(z.string(), z.unknown()).optional();\n\nexport type MetaData = z.infer<typeof metadataSchema>;\n\n// Re-export GraphNodeType and GRAPH_NODE_TYPE_NAMES from the pure types file\n// This separation is critical - they must not be in a file with Zod schemas\n// because the frontend imports them at runtime\nexport { GraphNodeType, GRAPH_NODE_TYPE_NAMES } from './types/graph-node-types';\n"],"mappings":";;;AAkKA,MAAa,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU"}

package/dist/utils/id-generator.cjs

@@ -0,0 +1,34 @@
+const require_url_safe_id = require("./url-safe-id.cjs");
+//#region src/utils/id-generator.ts
+/**
+* ID generation utilities
+*/
+var IdGenerator = class IdGenerator {
+	static RANDOM_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+	static nanoid4 = require_url_safe_id.createUrlSafeIdGenerator({
+		alphabet: IdGenerator.RANDOM_ALPHABET,
+		size: 4
+	});
+	/**
+	* Generate a flow ID from flow name
+	* Format: first 0-20 characters of flow name (lowercased and hyphenated) + 4 random chars
+	* Example: "Onboarding Process For Payments" -> "onboarding-process-fo-k2Rn"
+	*/
+	static generateFlowId(flowName) {
+		if (!flowName || typeof flowName !== "string") throw new Error("Flow name is required and must be a string");
+		const cleanName = flowName.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
+		if (!cleanName) throw new Error("Flow name must contain at least one alphanumeric character");
+		return `${cleanName.substring(0, 20)}-${IdGenerator.nanoid4()}`;
+	}
+	/**
+	* Validate flow ID format
+	*/
+	static isValidFlowId(flowId) {
+		if (!flowId || typeof flowId !== "string") return false;
+		return /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?-[a-zA-Z0-9]{4}$/.test(flowId) && flowId.length >= 6 && flowId.length <= 25;
+	}
+};
+//#endregion
+exports.IdGenerator = IdGenerator;
+
+//# sourceMappingURL=id-generator.cjs.map

package/dist/utils/id-generator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.cjs","names":["createUrlSafeIdGenerator"],"sources":["../../src/utils/id-generator.ts"],"sourcesContent":["// Framework-agnostic ID generation utilities for Invect core\nimport { createUrlSafeIdGenerator } from './url-safe-id';\n\n/**\n * ID generation utilities\n */\nexport class IdGenerator {\n  // Alphabet for random suffixes (alphanumeric, case-sensitive, URL-safe)\n  private static readonly RANDOM_ALPHABET =\n    '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';\n\n  // Create nanoid function for random suffixes\n  private static readonly nanoid4 = createUrlSafeIdGenerator({\n    alphabet: IdGenerator.RANDOM_ALPHABET,\n    size: 4,\n  });\n\n  /**\n   * Generate a flow ID from flow name\n   * Format: first 0-20 characters of flow name (lowercased and hyphenated) + 4 random chars\n   * Example: \"Onboarding Process For Payments\" -> \"onboarding-process-fo-k2Rn\"\n   */\n  static generateFlowId(flowName: string): string {\n    if (!flowName || typeof flowName !== 'string') {\n      throw new Error('Flow name is required and must be a string');\n    }\n\n    // Clean and process the name\n    const cleanName = flowName\n      .trim()\n      .toLowerCase()\n      // Replace spaces and non-alphanumeric characters with hyphens\n      .replace(/[^a-z0-9]+/g, '-')\n      // Remove leading/trailing hyphens\n      .replace(/^-+|-+$/g, '')\n      // Collapse multiple hyphens\n      .replace(/-+/g, '-');\n\n    if (!cleanName) {\n      throw new Error('Flow name must contain at least one alphanumeric character');\n    }\n\n    // Take first 20 characters (or less if shorter)\n    const prefix = cleanName.substring(0, 20);\n\n    // Generate 4 random characters\n    const suffix = IdGenerator.nanoid4();\n\n    return `${prefix}-${suffix}`;\n  }\n\n  /**\n   * Validate flow ID format\n   */\n  static isValidFlowId(flowId: string): boolean {\n    if (!flowId || typeof flowId !== 'string') {\n      return false;\n    }\n\n    // Flow ID should be: 1-20 lowercase chars/hyphens + dash + 4 random chars\n    const flowIdPattern = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?-[a-zA-Z0-9]{4}$/;\n    return flowIdPattern.test(flowId) && flowId.length >= 6 && flowId.length <= 25;\n  }\n}\n"],"mappings":";;;;;AAMA,IAAa,cAAb,MAAa,YAAY;CAEvB,OAAwB,kBACtB;CAGF,OAAwB,UAAUA,oBAAAA,yBAAyB;EACzD,UAAU,YAAY;EACtB,MAAM;EACP,CAAC;;;;;;CAOF,OAAO,eAAe,UAA0B;AAC9C,MAAI,CAAC,YAAY,OAAO,aAAa,SACnC,OAAM,IAAI,MAAM,6CAA6C;EAI/D,MAAM,YAAY,SACf,MAAM,CACN,aAAa,CAEb,QAAQ,eAAe,IAAI,CAE3B,QAAQ,YAAY,GAAG,CAEvB,QAAQ,OAAO,IAAI;AAEtB,MAAI,CAAC,UACH,OAAM,IAAI,MAAM,6DAA6D;AAS/E,SAAO,GALQ,UAAU,UAAU,GAAG,GAAG,CAKxB,GAFF,YAAY,SAAS;;;;;CAQtC,OAAO,cAAc,QAAyB;AAC5C,MAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;AAKT,SADsB,mDACD,KAAK,OAAO,IAAI,OAAO,UAAU,KAAK,OAAO,UAAU"}

package/dist/utils/id-generator.js

@@ -0,0 +1,34 @@
+import { createUrlSafeIdGenerator } from "./url-safe-id.js";
+//#region src/utils/id-generator.ts
+/**
+* ID generation utilities
+*/
+var IdGenerator = class IdGenerator {
+	static RANDOM_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+	static nanoid4 = createUrlSafeIdGenerator({
+		alphabet: IdGenerator.RANDOM_ALPHABET,
+		size: 4
+	});
+	/**
+	* Generate a flow ID from flow name
+	* Format: first 0-20 characters of flow name (lowercased and hyphenated) + 4 random chars
+	* Example: "Onboarding Process For Payments" -> "onboarding-process-fo-k2Rn"
+	*/
+	static generateFlowId(flowName) {
+		if (!flowName || typeof flowName !== "string") throw new Error("Flow name is required and must be a string");
+		const cleanName = flowName.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
+		if (!cleanName) throw new Error("Flow name must contain at least one alphanumeric character");
+		return `${cleanName.substring(0, 20)}-${IdGenerator.nanoid4()}`;
+	}
+	/**
+	* Validate flow ID format
+	*/
+	static isValidFlowId(flowId) {
+		if (!flowId || typeof flowId !== "string") return false;
+		return /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?-[a-zA-Z0-9]{4}$/.test(flowId) && flowId.length >= 6 && flowId.length <= 25;
+	}
+};
+//#endregion
+export { IdGenerator };
+
+//# sourceMappingURL=id-generator.js.map

package/dist/utils/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","names":[],"sources":["../../src/utils/id-generator.ts"],"sourcesContent":["// Framework-agnostic ID generation utilities for Invect core\nimport { createUrlSafeIdGenerator } from './url-safe-id';\n\n/**\n * ID generation utilities\n */\nexport class IdGenerator {\n  // Alphabet for random suffixes (alphanumeric, case-sensitive, URL-safe)\n  private static readonly RANDOM_ALPHABET =\n    '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';\n\n  // Create nanoid function for random suffixes\n  private static readonly nanoid4 = createUrlSafeIdGenerator({\n    alphabet: IdGenerator.RANDOM_ALPHABET,\n    size: 4,\n  });\n\n  /**\n   * Generate a flow ID from flow name\n   * Format: first 0-20 characters of flow name (lowercased and hyphenated) + 4 random chars\n   * Example: \"Onboarding Process For Payments\" -> \"onboarding-process-fo-k2Rn\"\n   */\n  static generateFlowId(flowName: string): string {\n    if (!flowName || typeof flowName !== 'string') {\n      throw new Error('Flow name is required and must be a string');\n    }\n\n    // Clean and process the name\n    const cleanName = flowName\n      .trim()\n      .toLowerCase()\n      // Replace spaces and non-alphanumeric characters with hyphens\n      .replace(/[^a-z0-9]+/g, '-')\n      // Remove leading/trailing hyphens\n      .replace(/^-+|-+$/g, '')\n      // Collapse multiple hyphens\n      .replace(/-+/g, '-');\n\n    if (!cleanName) {\n      throw new Error('Flow name must contain at least one alphanumeric character');\n    }\n\n    // Take first 20 characters (or less if shorter)\n    const prefix = cleanName.substring(0, 20);\n\n    // Generate 4 random characters\n    const suffix = IdGenerator.nanoid4();\n\n    return `${prefix}-${suffix}`;\n  }\n\n  /**\n   * Validate flow ID format\n   */\n  static isValidFlowId(flowId: string): boolean {\n    if (!flowId || typeof flowId !== 'string') {\n      return false;\n    }\n\n    // Flow ID should be: 1-20 lowercase chars/hyphens + dash + 4 random chars\n    const flowIdPattern = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?-[a-zA-Z0-9]{4}$/;\n    return flowIdPattern.test(flowId) && flowId.length >= 6 && flowId.length <= 25;\n  }\n}\n"],"mappings":";;;;;AAMA,IAAa,cAAb,MAAa,YAAY;CAEvB,OAAwB,kBACtB;CAGF,OAAwB,UAAU,yBAAyB;EACzD,UAAU,YAAY;EACtB,MAAM;EACP,CAAC;;;;;;CAOF,OAAO,eAAe,UAA0B;AAC9C,MAAI,CAAC,YAAY,OAAO,aAAa,SACnC,OAAM,IAAI,MAAM,6CAA6C;EAI/D,MAAM,YAAY,SACf,MAAM,CACN,aAAa,CAEb,QAAQ,eAAe,IAAI,CAE3B,QAAQ,YAAY,GAAG,CAEvB,QAAQ,OAAO,IAAI;AAEtB,MAAI,CAAC,UACH,OAAM,IAAI,MAAM,6DAA6D;AAS/E,SAAO,GALQ,UAAU,UAAU,GAAG,GAAG,CAKxB,GAFF,YAAY,SAAS;;;;;CAQtC,OAAO,cAAc,QAAyB;AAC5C,MAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;AAKT,SADsB,mDACD,KAAK,OAAO,IAAI,OAAO,UAAU,KAAK,OAAO,UAAU"}