@datatechsolutions/ui 2.11.62 → 2.11.64

package/dist/astrlabe/contracts.d.mts

@@ -22,10 +22,33 @@ type IfElseNodeConfig = {
     }>;
     logicalOperator: 'and' | 'or';
 };
+type CodeOperation = 'passthrough' | 'return' | 'merge' | 'pick' | 'parse_json' | 'regex_extract' | 'xml_titles';
 type CodeNodeConfig = {
     type: 'code';
     language: 'javascript' | 'python' | 'typescript';
     code: string;
+} | {
+    type: 'code';
+    operation: CodeOperation;
+    /** Dotted ref into the variable pool (`nodeId.path`) for ops that
+     *  read a specific upstream value. Leave empty for `passthrough`
+     *  which reads the sole incoming edge automatically. */
+    from?: string;
+    /** `return` — the literal JSON value to emit. */
+    value?: unknown;
+    /** `pick` — whitelist of keys to project off `incoming`. */
+    fields?: string[];
+    /** `regex_extract` — regex pattern and flags (`i m s x U R`;
+     *  `g` is implicit). `group` defaults to 1 (first capture group). */
+    pattern?: string;
+    flags?: string;
+    group?: number;
+    /** `regex_extract` / `xml_titles` — key name to expose matches
+     *  under in the node's output object (default: `matches` / `titles`). */
+    output?: string;
+    /** `xml_titles` — by default drops the channel/feed title; set
+     *  `true` to keep it in the result array. */
+    keepChannel?: boolean;
 };
 type HttpRequestNodeConfig = {
     type: 'http_request';
@@ -140,23 +163,63 @@ type EntityNodeConfig = {
     outputVariable: string;
     limit: number;
 };
+type DatasourceFilterOp = 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'like' | 'in';
+type DatasourceFilter = {
+    /** Column identifier — must match `[a-zA-Z0-9_]+` (validator enforces). */
+    column: string;
+    /** Comparison operator; defaults to `eq` when omitted. */
+    op?: DatasourceFilterOp;
+    /** Scalar (string / number / bool) or array (required when op = `in`).
+     *  Strings may reference pool variables via `{{ nodeId.path }}` /
+     *  `{{ inputs.field }}` — the engine renders them before binding. */
+    value?: string | number | boolean | Array<string | number | boolean> | null;
+};
 type DatasourceNodeConfig = {
     type: 'datasource';
     datasourceId: string;
     dialect: string;
     table: string;
     selectedColumns: string[];
-    filterVariables: Record<string, string>;
+    /** Preferred shape: full filter array with per-row operator. */
+    filters?: DatasourceFilter[];
+    /** Legacy: variable-name → column-name map (implicit `eq`). Kept so
+     *  older graphs still load; new UI writes `filters` instead. */
+    filterVariables?: Record<string, string>;
     outputVariable: string;
     limit: number;
 };
 type RuleNodeConfig = {
     type: 'rule';
+    /** Slug / id of the rule row in `astrlabe.agent_rules`. Required for
+     *  the rule executor to resolve a definition at run-time. */
+    ruleId?: string;
+    /** Execution priority when several rules feed into the same branch. */
+    priority?: number;
+    /** Master switch. Disabled rules are skipped at run-time. */
+    enabled?: boolean;
     entityId?: string;
     outputVariable?: string;
     priceVariable?: string;
     contextVariables?: Record<string, string>;
 };
+type AgentNodeConfig = {
+    type: 'agent';
+    /** `astrlabe.agents.id` — identifies which agent config to run. */
+    agentId?: string;
+    /** Preferred path: references `astrlabe.model_provider_connections.id`. */
+    connectionId?: string;
+    /** Escape hatch: inline provider + model when no connection row exists. */
+    provider?: ModelProviderType;
+    model?: string;
+    /** Optional override of the agent's stored model id. */
+    modelId?: string;
+    /** System + user prompts rendered through the template engine
+     *  (`{{ nodeId.path }}` / `{{ inputs.x }}`). */
+    systemPrompt?: string;
+    userPrompt?: string;
+    maxTokens?: number;
+    temperature?: number;
+};
 type ModelProviderType = 'aws_bedrock' | 'openai_api' | 'google_vertex' | 'azure_openai' | 'anthropic_api' | 'groq' | 'mistral' | 'huggingface' | 'ollama' | 'custom';
 type ModelProviderNodeConfig = {
     type: 'model_provider';
@@ -184,7 +247,7 @@ type DashboardOutputNodeConfig = {
     /** Reference to an upstream node's value (`"nodeId"` or `"nodeId.path"`) that already conforms to DashboardSpec. */
     dashboardFrom?: string;
 };
-type LogicNodeConfig = StartNodeConfig | EndNodeConfig | IfElseNodeConfig | CodeNodeConfig | HttpRequestNodeConfig | TemplateTransformNodeConfig | IterationNodeConfig | KnowledgeBaseNodeConfig | AnswerNodeConfig | QuestionClassifierNodeConfig | ParameterExtractorNodeConfig | VariableAssignerNodeConfig | VariableAggregatorNodeConfig | DocumentExtractorNodeConfig | ListOperatorNodeConfig | IterationStartNodeConfig | NoteNodeConfig | GroupNodeConfig | EntityNodeConfig | DatasourceNodeConfig | RuleNodeConfig | ModelProviderNodeConfig | DashboardOutputNodeConfig;
+type LogicNodeConfig = StartNodeConfig | EndNodeConfig | IfElseNodeConfig | CodeNodeConfig | HttpRequestNodeConfig | TemplateTransformNodeConfig | IterationNodeConfig | KnowledgeBaseNodeConfig | AnswerNodeConfig | QuestionClassifierNodeConfig | ParameterExtractorNodeConfig | VariableAssignerNodeConfig | VariableAggregatorNodeConfig | DocumentExtractorNodeConfig | ListOperatorNodeConfig | IterationStartNodeConfig | NoteNodeConfig | GroupNodeConfig | EntityNodeConfig | DatasourceNodeConfig | RuleNodeConfig | AgentNodeConfig | ModelProviderNodeConfig | DashboardOutputNodeConfig;
 type WorkflowNodeData = {
     entityId: string;
     label: string;
@@ -323,4 +386,4 @@ type AgentRule = {
     [key: string]: unknown;
 };
 
-export type { AgentConfig, AgentModel, AgentRule, AgentTool, AnswerNodeConfig, CodeNodeConfig, DashboardOutputNodeConfig, DatasourceNodeConfig, DocumentExtractorNodeConfig, EndNodeConfig, EntityNodeConfig, GroupNodeConfig, HttpRequestNodeConfig, IfElseNodeConfig, IterationNodeConfig, IterationStartNodeConfig, KnowledgeBaseNodeConfig, ListOperatorNodeConfig, LogicNodeConfig, ModelProviderNodeConfig, ModelProviderType, NodeExecutionResult, NoteNodeConfig, ParameterExtractorNodeConfig, QuestionClassifierNodeConfig, RuleNodeConfig, StartNodeConfig, TemplateTransformNodeConfig, VariableAggregatorNodeConfig, VariableAssignerNodeConfig, VariableValue, Workflow, WorkflowEdge, WorkflowGraph, WorkflowNode, WorkflowNodeData, WorkflowNodeStatus, WorkflowNodeType, WorkflowRun, WorkflowRunStatus, WorkflowTool, WorkflowViewport };
+export type { AgentConfig, AgentModel, AgentNodeConfig, AgentRule, AgentTool, AnswerNodeConfig, CodeNodeConfig, CodeOperation, DashboardOutputNodeConfig, DatasourceFilter, DatasourceFilterOp, DatasourceNodeConfig, DocumentExtractorNodeConfig, EndNodeConfig, EntityNodeConfig, GroupNodeConfig, HttpRequestNodeConfig, IfElseNodeConfig, IterationNodeConfig, IterationStartNodeConfig, KnowledgeBaseNodeConfig, ListOperatorNodeConfig, LogicNodeConfig, ModelProviderNodeConfig, ModelProviderType, NodeExecutionResult, NoteNodeConfig, ParameterExtractorNodeConfig, QuestionClassifierNodeConfig, RuleNodeConfig, StartNodeConfig, TemplateTransformNodeConfig, VariableAggregatorNodeConfig, VariableAssignerNodeConfig, VariableValue, Workflow, WorkflowEdge, WorkflowGraph, WorkflowNode, WorkflowNodeData, WorkflowNodeStatus, WorkflowNodeType, WorkflowRun, WorkflowRunStatus, WorkflowTool, WorkflowViewport };

package/dist/astrlabe/contracts.d.ts

@@ -22,10 +22,33 @@ type IfElseNodeConfig = {
     }>;
     logicalOperator: 'and' | 'or';
 };
+type CodeOperation = 'passthrough' | 'return' | 'merge' | 'pick' | 'parse_json' | 'regex_extract' | 'xml_titles';
 type CodeNodeConfig = {
     type: 'code';
     language: 'javascript' | 'python' | 'typescript';
     code: string;
+} | {
+    type: 'code';
+    operation: CodeOperation;
+    /** Dotted ref into the variable pool (`nodeId.path`) for ops that
+     *  read a specific upstream value. Leave empty for `passthrough`
+     *  which reads the sole incoming edge automatically. */
+    from?: string;
+    /** `return` — the literal JSON value to emit. */
+    value?: unknown;
+    /** `pick` — whitelist of keys to project off `incoming`. */
+    fields?: string[];
+    /** `regex_extract` — regex pattern and flags (`i m s x U R`;
+     *  `g` is implicit). `group` defaults to 1 (first capture group). */
+    pattern?: string;
+    flags?: string;
+    group?: number;
+    /** `regex_extract` / `xml_titles` — key name to expose matches
+     *  under in the node's output object (default: `matches` / `titles`). */
+    output?: string;
+    /** `xml_titles` — by default drops the channel/feed title; set
+     *  `true` to keep it in the result array. */
+    keepChannel?: boolean;
 };
 type HttpRequestNodeConfig = {
     type: 'http_request';
@@ -140,23 +163,63 @@ type EntityNodeConfig = {
     outputVariable: string;
     limit: number;
 };
+type DatasourceFilterOp = 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'like' | 'in';
+type DatasourceFilter = {
+    /** Column identifier — must match `[a-zA-Z0-9_]+` (validator enforces). */
+    column: string;
+    /** Comparison operator; defaults to `eq` when omitted. */
+    op?: DatasourceFilterOp;
+    /** Scalar (string / number / bool) or array (required when op = `in`).
+     *  Strings may reference pool variables via `{{ nodeId.path }}` /
+     *  `{{ inputs.field }}` — the engine renders them before binding. */
+    value?: string | number | boolean | Array<string | number | boolean> | null;
+};
 type DatasourceNodeConfig = {
     type: 'datasource';
     datasourceId: string;
     dialect: string;
     table: string;
     selectedColumns: string[];
-    filterVariables: Record<string, string>;
+    /** Preferred shape: full filter array with per-row operator. */
+    filters?: DatasourceFilter[];
+    /** Legacy: variable-name → column-name map (implicit `eq`). Kept so
+     *  older graphs still load; new UI writes `filters` instead. */
+    filterVariables?: Record<string, string>;
     outputVariable: string;
     limit: number;
 };
 type RuleNodeConfig = {
     type: 'rule';
+    /** Slug / id of the rule row in `astrlabe.agent_rules`. Required for
+     *  the rule executor to resolve a definition at run-time. */
+    ruleId?: string;
+    /** Execution priority when several rules feed into the same branch. */
+    priority?: number;
+    /** Master switch. Disabled rules are skipped at run-time. */
+    enabled?: boolean;
     entityId?: string;
     outputVariable?: string;
     priceVariable?: string;
     contextVariables?: Record<string, string>;
 };
+type AgentNodeConfig = {
+    type: 'agent';
+    /** `astrlabe.agents.id` — identifies which agent config to run. */
+    agentId?: string;
+    /** Preferred path: references `astrlabe.model_provider_connections.id`. */
+    connectionId?: string;
+    /** Escape hatch: inline provider + model when no connection row exists. */
+    provider?: ModelProviderType;
+    model?: string;
+    /** Optional override of the agent's stored model id. */
+    modelId?: string;
+    /** System + user prompts rendered through the template engine
+     *  (`{{ nodeId.path }}` / `{{ inputs.x }}`). */
+    systemPrompt?: string;
+    userPrompt?: string;
+    maxTokens?: number;
+    temperature?: number;
+};
 type ModelProviderType = 'aws_bedrock' | 'openai_api' | 'google_vertex' | 'azure_openai' | 'anthropic_api' | 'groq' | 'mistral' | 'huggingface' | 'ollama' | 'custom';
 type ModelProviderNodeConfig = {
     type: 'model_provider';
@@ -184,7 +247,7 @@ type DashboardOutputNodeConfig = {
     /** Reference to an upstream node's value (`"nodeId"` or `"nodeId.path"`) that already conforms to DashboardSpec. */
     dashboardFrom?: string;
 };
-type LogicNodeConfig = StartNodeConfig | EndNodeConfig | IfElseNodeConfig | CodeNodeConfig | HttpRequestNodeConfig | TemplateTransformNodeConfig | IterationNodeConfig | KnowledgeBaseNodeConfig | AnswerNodeConfig | QuestionClassifierNodeConfig | ParameterExtractorNodeConfig | VariableAssignerNodeConfig | VariableAggregatorNodeConfig | DocumentExtractorNodeConfig | ListOperatorNodeConfig | IterationStartNodeConfig | NoteNodeConfig | GroupNodeConfig | EntityNodeConfig | DatasourceNodeConfig | RuleNodeConfig | ModelProviderNodeConfig | DashboardOutputNodeConfig;
+type LogicNodeConfig = StartNodeConfig | EndNodeConfig | IfElseNodeConfig | CodeNodeConfig | HttpRequestNodeConfig | TemplateTransformNodeConfig | IterationNodeConfig | KnowledgeBaseNodeConfig | AnswerNodeConfig | QuestionClassifierNodeConfig | ParameterExtractorNodeConfig | VariableAssignerNodeConfig | VariableAggregatorNodeConfig | DocumentExtractorNodeConfig | ListOperatorNodeConfig | IterationStartNodeConfig | NoteNodeConfig | GroupNodeConfig | EntityNodeConfig | DatasourceNodeConfig | RuleNodeConfig | AgentNodeConfig | ModelProviderNodeConfig | DashboardOutputNodeConfig;
 type WorkflowNodeData = {
     entityId: string;
     label: string;
@@ -323,4 +386,4 @@ type AgentRule = {
     [key: string]: unknown;
 };
 
-export type { AgentConfig, AgentModel, AgentRule, AgentTool, AnswerNodeConfig, CodeNodeConfig, DashboardOutputNodeConfig, DatasourceNodeConfig, DocumentExtractorNodeConfig, EndNodeConfig, EntityNodeConfig, GroupNodeConfig, HttpRequestNodeConfig, IfElseNodeConfig, IterationNodeConfig, IterationStartNodeConfig, KnowledgeBaseNodeConfig, ListOperatorNodeConfig, LogicNodeConfig, ModelProviderNodeConfig, ModelProviderType, NodeExecutionResult, NoteNodeConfig, ParameterExtractorNodeConfig, QuestionClassifierNodeConfig, RuleNodeConfig, StartNodeConfig, TemplateTransformNodeConfig, VariableAggregatorNodeConfig, VariableAssignerNodeConfig, VariableValue, Workflow, WorkflowEdge, WorkflowGraph, WorkflowNode, WorkflowNodeData, WorkflowNodeStatus, WorkflowNodeType, WorkflowRun, WorkflowRunStatus, WorkflowTool, WorkflowViewport };
+export type { AgentConfig, AgentModel, AgentNodeConfig, AgentRule, AgentTool, AnswerNodeConfig, CodeNodeConfig, CodeOperation, DashboardOutputNodeConfig, DatasourceFilter, DatasourceFilterOp, DatasourceNodeConfig, DocumentExtractorNodeConfig, EndNodeConfig, EntityNodeConfig, GroupNodeConfig, HttpRequestNodeConfig, IfElseNodeConfig, IterationNodeConfig, IterationStartNodeConfig, KnowledgeBaseNodeConfig, ListOperatorNodeConfig, LogicNodeConfig, ModelProviderNodeConfig, ModelProviderType, NodeExecutionResult, NoteNodeConfig, ParameterExtractorNodeConfig, QuestionClassifierNodeConfig, RuleNodeConfig, StartNodeConfig, TemplateTransformNodeConfig, VariableAggregatorNodeConfig, VariableAssignerNodeConfig, VariableValue, Workflow, WorkflowEdge, WorkflowGraph, WorkflowNode, WorkflowNodeData, WorkflowNodeStatus, WorkflowNodeType, WorkflowRun, WorkflowRunStatus, WorkflowTool, WorkflowViewport };