@invect/core 0.0.1

package/dist/services/chat/tools/node-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-tools.js","names":[],"sources":["../../../../src/services/chat/tools/node-tools.ts"],"sourcesContent":["/**\n * Chat Tools — Node Editing\n *\n * Granular tools for adding, removing, connecting, and configuring individual nodes.\n * These operate on the latest flow version — they read, mutate, and save a new version.\n *\n * For bulk changes (new flows from scratch), use update_flow_definition instead.\n * These are for surgical edits: \"add a Slack node after the HTTP request\",\n * \"change the JQ query\", \"remove the debug node\".\n */\n\nimport { z } from 'zod/v4';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from '../chat-types';\nimport type { Invect } from 'src/invect-core';\nimport type { FlowNodeDefinitions, FlowEdge } from 'src/services/flow-versions/schemas-fresh';\n\n/**\n * Helper: Load the latest flow version's nodes and edges.\n */\nasync function loadLatestDefinition(invect: Invect, flowId: string) {\n  const version = await invect.getFlowVersion(flowId, 'latest');\n  if (!version) {\n    throw new Error('No flow version found — publish a version first');\n  }\n\n  const definition = version.invectDefinition;\n  const nodes = structuredClone(definition.nodes) as FlowNodeDefinitions[];\n  const edges = structuredClone(definition.edges) as FlowEdge[];\n\n  return { nodes, edges, version };\n}\n\n/**\n * Helper: Save a mutated definition as a new flow version.\n */\nasync function saveNewVersion(\n  invect: Invect,\n  flowId: string,\n  nodes: FlowNodeDefinitions[],\n  edges: FlowEdge[],\n) {\n  return invect.createFlowVersion(flowId, {\n    invectDefinition: { nodes, edges },\n  });\n}\n\n/**\n * Helper: Convert a label to a snake_case reference ID.\n */\nfunction labelToReferenceId(label: string): string {\n  return label\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '_')\n    .replace(/^_|_$/g, '');\n}\n\n/**\n * Helper: Generate a short unique ID for nodes/edges.\n */\nfunction genId(): string {\n  return Math.random().toString(36).slice(2, 10);\n}\n\n// =====================================\n// add_node\n// =====================================\n\nexport const addNodeTool: ChatToolDefinition = {\n  id: 'add_node',\n  name: 'Add Node',\n  description:\n    'Add a new node to the current flow. Optionally connect it after an existing node. ' +\n    'The node is positioned automatically. Use search_actions or get_action_details to find valid action IDs. ' +\n    'For bulk flow creation, prefer update_flow_definition instead.',\n  parameters: z.object({\n    actionId: z\n      .string()\n      .describe(\n        'Action type ID (e.g. \"core.model\", \"core.javascript\", \"gmail.send_message\", \"http.request\")',\n      ),\n    label: z.string().describe('Human-readable node label (e.g. \"Fetch User Emails\")'),\n    params: z\n      .record(z.string(), z.unknown())\n      .optional()\n      .default({})\n      .describe('Node configuration parameters (key-value pairs)'),\n    connectAfter: z\n      .string()\n      .optional()\n      .describe('Node ID to connect after — creates an edge from that node to this new one'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const {\n      actionId,\n      label,\n      params: nodeParams,\n      connectAfter,\n    } = params as {\n      actionId: string;\n      label: string;\n      params: Record<string, unknown>;\n      connectAfter?: string;\n    };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      // Validate action ID exists in the registry\n      const availableNodes = invect.getAvailableNodes();\n      const validAction = availableNodes.find((n) => n.type === actionId);\n      if (!validAction) {\n        const searchLower = actionId.toLowerCase();\n        const similar = availableNodes\n          .filter((n) => n.type.toLowerCase().includes(searchLower.split('.').pop() ?? ''))\n          .slice(0, 5)\n          .map((n) => n.type);\n        return {\n          success: false,\n          error: `Action \"${actionId}\" not found in the action registry`,\n          suggestion:\n            similar.length > 0\n              ? `Did you mean one of: ${similar.join(', ')}? Use search_actions to find valid action IDs.`\n              : 'Use search_actions to find valid action IDs.',\n        };\n      }\n\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      const nodeId = `node_${genId()}`;\n      const referenceId = labelToReferenceId(label);\n\n      // Compute position: below connectAfter node, or after the last node\n      let position = { x: 250, y: 100 };\n      if (connectAfter) {\n        const upstream = nodes.find((n) => n.id === connectAfter);\n        if (upstream?.position) {\n          position = { x: upstream.position.x, y: upstream.position.y + 150 };\n        }\n      } else if (nodes.length > 0) {\n        const lastNode = nodes[nodes.length - 1];\n        if (lastNode?.position) {\n          position = { x: lastNode.position.x, y: lastNode.position.y + 150 };\n        }\n      }\n\n      // Add the new node\n      nodes.push({\n        id: nodeId,\n        type: actionId,\n        label,\n        referenceId,\n        params: nodeParams ?? {},\n        position,\n      });\n\n      // Auto-connect if requested\n      if (connectAfter) {\n        const upstream = nodes.find((n) => n.id === connectAfter);\n        if (!upstream) {\n          return {\n            success: false,\n            error: `Cannot connect after node \"${connectAfter}\" — node not found`,\n            suggestion: 'Use get_current_flow_context to see available node IDs.',\n          };\n        }\n        edges.push({\n          id: `edge_${genId()}`,\n          source: connectAfter,\n          target: nodeId,\n        });\n      }\n\n      const version = await saveNewVersion(invect, flowId, nodes, edges);\n\n      return {\n        success: true,\n        data: {\n          nodeId,\n          label,\n          actionId,\n          referenceId,\n          versionNumber: version.version,\n          connected: connectAfter ? { from: connectAfter, to: nodeId } : undefined,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId, selectNodeId: nodeId },\n        },\n      };\n    } catch (error: unknown) {\n      return {\n        success: false,\n        error: `Failed to add node: ${(error as Error).message}`,\n        suggestion: 'Use search_actions to verify the action ID is valid.',\n      };\n    }\n  },\n};\n\n// =====================================\n// remove_node\n// =====================================\n\nexport const removeNodeTool: ChatToolDefinition = {\n  id: 'remove_node',\n  name: 'Remove Node',\n  description:\n    'Remove a node from the current flow. Also removes all edges connected to it. ' +\n    'Use get_current_flow_context to find node IDs.',\n  parameters: z.object({\n    nodeId: z.string().describe('ID of the node to remove'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { nodeId } = params as { nodeId: string };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      const nodeIndex = nodes.findIndex((n) => n.id === nodeId);\n      if (nodeIndex === -1) {\n        return {\n          success: false,\n          error: `Node \"${nodeId}\" not found in flow`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n\n      const removedNode = nodes[nodeIndex];\n      const removedLabel = removedNode.label || removedNode.id;\n\n      // Remove the node\n      nodes.splice(nodeIndex, 1);\n\n      // Remove all edges connected to this node\n      const removedEdgeCount = edges.length;\n      const filteredEdges = edges.filter((e) => e.source !== nodeId && e.target !== nodeId);\n      const edgesRemoved = removedEdgeCount - filteredEdges.length;\n\n      const version = await saveNewVersion(invect, flowId, nodes, filteredEdges);\n\n      return {\n        success: true,\n        data: {\n          removedNodeId: nodeId,\n          removedLabel,\n          edgesRemoved,\n          versionNumber: version.version,\n          remainingNodeCount: nodes.length,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId },\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to remove node: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// update_node_config\n// =====================================\n\nexport const updateNodeConfigTool: ChatToolDefinition = {\n  id: 'update_node_config',\n  name: 'Update Node Config',\n  description:\n    'Update the configuration parameters of an existing node. ' +\n    'Merges the provided params into the existing config (does not replace unmentioned params). ' +\n    'Use this for targeted changes like \"change the JQ query\" or \"update the prompt\".',\n  parameters: z.object({\n    nodeId: z.string().describe('ID of the node to update'),\n    params: z\n      .record(z.string(), z.unknown())\n      .describe('Parameters to set or update (merged with existing)'),\n    label: z.string().optional().describe('Optionally update the node label too'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const {\n      nodeId,\n      params: newParams,\n      label,\n    } = params as {\n      nodeId: string;\n      params: Record<string, unknown>;\n      label?: string;\n    };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      const node = nodes.find((n) => n.id === nodeId);\n      if (!node) {\n        return {\n          success: false,\n          error: `Node \"${nodeId}\" not found in flow`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n\n      // Merge params\n      const existingParams = node.params ?? {};\n      node.params = { ...existingParams, ...newParams };\n\n      // Update label if provided\n      if (label) {\n        node.label = label;\n        node.referenceId = labelToReferenceId(label);\n      }\n\n      const version = await saveNewVersion(invect, flowId, nodes, edges);\n\n      return {\n        success: true,\n        data: {\n          nodeId,\n          label: node.label,\n          updatedParams: Object.keys(newParams),\n          versionNumber: version.version,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId, selectNodeId: nodeId },\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to update node: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// connect_nodes\n// =====================================\n\nexport const connectNodesTool: ChatToolDefinition = {\n  id: 'connect_nodes',\n  name: 'Connect Nodes',\n  description:\n    'Create an edge between two nodes. Data flows from source to target. ' +\n    'Use sourceHandle/targetHandle for multi-output nodes like if-else (e.g. \"true_output\", \"false_output\").',\n  parameters: z.object({\n    sourceNodeId: z.string().describe('ID of the source node (data flows FROM here)'),\n    targetNodeId: z.string().describe('ID of the target node (data flows TO here)'),\n    sourceHandle: z\n      .string()\n      .optional()\n      .describe('Source handle for multi-output nodes (e.g. \"true_output\", \"false_output\")'),\n    targetHandle: z.string().optional().describe('Target handle (rarely needed)'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { sourceNodeId, targetNodeId, sourceHandle, targetHandle } = params as {\n      sourceNodeId: string;\n      targetNodeId: string;\n      sourceHandle?: string;\n      targetHandle?: string;\n    };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      // Validate both nodes exist\n      const source = nodes.find((n) => n.id === sourceNodeId);\n      const target = nodes.find((n) => n.id === targetNodeId);\n\n      if (!source) {\n        return {\n          success: false,\n          error: `Source node \"${sourceNodeId}\" not found`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n      if (!target) {\n        return {\n          success: false,\n          error: `Target node \"${targetNodeId}\" not found`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n\n      // Check for duplicate edge\n      const exists = edges.some(\n        (e) =>\n          e.source === sourceNodeId &&\n          e.target === targetNodeId &&\n          (e.sourceHandle ?? '') === (sourceHandle ?? '') &&\n          (e.targetHandle ?? '') === (targetHandle ?? ''),\n      );\n      if (exists) {\n        return {\n          success: true,\n          data: { message: 'Edge already exists — no change needed' },\n        };\n      }\n\n      edges.push({\n        id: `edge_${genId()}`,\n        source: sourceNodeId,\n        target: targetNodeId,\n        ...(sourceHandle && { sourceHandle }),\n        ...(targetHandle && { targetHandle }),\n      });\n\n      const version = await saveNewVersion(invect, flowId, nodes, edges);\n\n      return {\n        success: true,\n        data: {\n          edgeId: edges[edges.length - 1].id,\n          from: `${source.label ?? sourceNodeId}`,\n          to: `${target.label ?? targetNodeId}`,\n          versionNumber: version.version,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId },\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to connect nodes: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// Export all node tools\n// =====================================\n\nexport const nodeTools: ChatToolDefinition[] = [\n  addNodeTool,\n  removeNodeTool,\n  updateNodeConfigTool,\n  connectNodesTool,\n];\n"],"mappings":"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"}

package/dist/services/chat/tools/plan-tools.cjs

@@ -0,0 +1,94 @@
+require("../../../_virtual/_rolldown/runtime.cjs");
+let zod_v4 = require("zod/v4");
+const planTools = [{
+	id: "set_plan",
+	name: "Set Plan",
+	description: "Create a step-by-step plan for building or modifying a flow. Use this BEFORE starting any complex work (3+ steps). Present the plan to the user and wait for their confirmation before executing. Each step should be a concise, actionable description.",
+	parameters: zod_v4.z.object({
+		steps: zod_v4.z.array(zod_v4.z.object({
+			title: zod_v4.z.string().describe("Short description of the step (e.g. \"Add HTTP request to AiPrise API\")"),
+			status: zod_v4.z.enum([
+				"pending",
+				"in_progress",
+				"done",
+				"skipped"
+			]).default("pending").describe("Step status — should be \"pending\" when first creating the plan")
+		})).min(1).max(20).describe("Ordered list of steps to complete"),
+		summary: zod_v4.z.string().optional().describe("Brief one-line summary of the overall goal (e.g. \"Build a KYC verification flow\")")
+	}),
+	async execute(params, _ctx) {
+		const { steps, summary } = params;
+		return {
+			success: true,
+			data: {
+				summary: summary ?? "Plan created",
+				totalSteps: steps.length,
+				steps: steps.map((s, i) => ({
+					index: i + 1,
+					title: s.title,
+					status: s.status ?? "pending"
+				}))
+			},
+			uiAction: {
+				action: "show_plan",
+				data: {
+					summary: summary ?? "Plan created",
+					steps: steps.map((s, i) => ({
+						index: i + 1,
+						title: s.title,
+						status: s.status ?? "pending"
+					}))
+				}
+			}
+		};
+	}
+}, {
+	id: "update_plan",
+	name: "Update Plan",
+	description: "Update the status of steps in the current plan. Use this after completing each step to keep the user informed of progress. You can also add new steps or mark steps as skipped if the plan needs to change.",
+	parameters: zod_v4.z.object({
+		steps: zod_v4.z.array(zod_v4.z.object({
+			title: zod_v4.z.string().describe("Step description (can be updated)"),
+			status: zod_v4.z.enum([
+				"pending",
+				"in_progress",
+				"done",
+				"skipped"
+			]).describe("Updated step status")
+		})).min(1).max(20).describe("Complete updated step list (include ALL steps, not just changed ones)"),
+		note: zod_v4.z.string().optional().describe("Optional note about what changed or why (e.g. \"AiPrise not available, using HTTP instead\")")
+	}),
+	async execute(params, _ctx) {
+		const { steps, note } = params;
+		const doneCount = steps.filter((s) => s.status === "done").length;
+		const totalSteps = steps.filter((s) => s.status !== "skipped").length;
+		return {
+			success: true,
+			data: {
+				progress: `${doneCount}/${totalSteps} steps completed`,
+				steps: steps.map((s, i) => ({
+					index: i + 1,
+					title: s.title,
+					status: s.status
+				})),
+				...note && { note }
+			},
+			uiAction: {
+				action: "update_plan",
+				data: {
+					steps: steps.map((s, i) => ({
+						index: i + 1,
+						title: s.title,
+						status: s.status
+					})),
+					progress: `${doneCount}/${totalSteps}`,
+					...note && { note }
+				}
+			}
+		};
+	}
+}];
+//#endregion
+exports.planTools = planTools;
+
+//# sourceMappingURL=plan-tools.cjs.map

package/dist/services/chat/tools/plan-tools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tools.cjs","names":["z"],"sources":["../../../../src/services/chat/tools/plan-tools.ts"],"sourcesContent":["/**\n * Chat Tools — Plan Tracking\n *\n * Tools that let the AI assistant create and track a step-by-step plan.\n * Plans are visible to the user through tool call events in the chat stream.\n *\n * The LLM uses set_plan to present a plan before building, and update_plan\n * to mark steps as completed (or adjust the plan) as it works.\n *\n * Plans are ephemeral (per-conversation) — they live in the LLM's context\n * window via tool call/result history. No persistence needed.\n */\n\nimport { z } from 'zod/v4';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from '../chat-types';\n\n// =====================================\n// set_plan\n// =====================================\n\nexport const setPlanTool: ChatToolDefinition = {\n  id: 'set_plan',\n  name: 'Set Plan',\n  description:\n    'Create a step-by-step plan for building or modifying a flow. ' +\n    'Use this BEFORE starting any complex work (3+ steps). ' +\n    'Present the plan to the user and wait for their confirmation before executing. ' +\n    'Each step should be a concise, actionable description.',\n  parameters: z.object({\n    steps: z\n      .array(\n        z.object({\n          title: z\n            .string()\n            .describe('Short description of the step (e.g. \"Add HTTP request to AiPrise API\")'),\n          status: z\n            .enum(['pending', 'in_progress', 'done', 'skipped'])\n            .default('pending')\n            .describe('Step status — should be \"pending\" when first creating the plan'),\n        }),\n      )\n      .min(1)\n      .max(20)\n      .describe('Ordered list of steps to complete'),\n    summary: z\n      .string()\n      .optional()\n      .describe(\n        'Brief one-line summary of the overall goal (e.g. \"Build a KYC verification flow\")',\n      ),\n  }),\n  async execute(params: unknown, _ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { steps, summary } = params as {\n      steps: Array<{ title: string; status: string }>;\n      summary?: string;\n    };\n\n    return {\n      success: true,\n      data: {\n        summary: summary ?? 'Plan created',\n        totalSteps: steps.length,\n        steps: steps.map((s, i) => ({\n          index: i + 1,\n          title: s.title,\n          status: s.status ?? 'pending',\n        })),\n      },\n      uiAction: {\n        action: 'show_plan',\n        data: {\n          summary: summary ?? 'Plan created',\n          steps: steps.map((s, i) => ({\n            index: i + 1,\n            title: s.title,\n            status: s.status ?? 'pending',\n          })),\n        },\n      },\n    };\n  },\n};\n\n// =====================================\n// update_plan\n// =====================================\n\nexport const updatePlanTool: ChatToolDefinition = {\n  id: 'update_plan',\n  name: 'Update Plan',\n  description:\n    'Update the status of steps in the current plan. Use this after completing each step ' +\n    'to keep the user informed of progress. You can also add new steps or mark steps as skipped ' +\n    'if the plan needs to change.',\n  parameters: z.object({\n    steps: z\n      .array(\n        z.object({\n          title: z.string().describe('Step description (can be updated)'),\n          status: z\n            .enum(['pending', 'in_progress', 'done', 'skipped'])\n            .describe('Updated step status'),\n        }),\n      )\n      .min(1)\n      .max(20)\n      .describe('Complete updated step list (include ALL steps, not just changed ones)'),\n    note: z\n      .string()\n      .optional()\n      .describe(\n        'Optional note about what changed or why (e.g. \"AiPrise not available, using HTTP instead\")',\n      ),\n  }),\n  async execute(params: unknown, _ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { steps, note } = params as {\n      steps: Array<{ title: string; status: string }>;\n      note?: string;\n    };\n\n    const doneCount = steps.filter((s) => s.status === 'done').length;\n    const totalSteps = steps.filter((s) => s.status !== 'skipped').length;\n\n    return {\n      success: true,\n      data: {\n        progress: `${doneCount}/${totalSteps} steps completed`,\n        steps: steps.map((s, i) => ({\n          index: i + 1,\n          title: s.title,\n          status: s.status,\n        })),\n        ...(note && { note }),\n      },\n      uiAction: {\n        action: 'update_plan',\n        data: {\n          steps: steps.map((s, i) => ({\n            index: i + 1,\n            title: s.title,\n            status: s.status,\n          })),\n          progress: `${doneCount}/${totalSteps}`,\n          ...(note && { note }),\n        },\n      },\n    };\n  },\n};\n\n// =====================================\n// Export all plan tools\n// =====================================\n\nexport const planTools: ChatToolDefinition[] = [setPlanTool, updatePlanTool];\n"],"mappings":";;AA0JA,MAAa,YAAkC,CAtIA;CAC7C,IAAI;CACJ,MAAM;CACN,aACE;CAIF,YAAYA,OAAAA,EAAE,OAAO;EACnB,OAAOA,OAAAA,EACJ,MACCA,OAAAA,EAAE,OAAO;GACP,OAAOA,OAAAA,EACJ,QAAQ,CACR,SAAS,2EAAyE;GACrF,QAAQA,OAAAA,EACL,KAAK;IAAC;IAAW;IAAe;IAAQ;IAAU,CAAC,CACnD,QAAQ,UAAU,CAClB,SAAS,mEAAiE;GAC9E,CAAC,CACH,CACA,IAAI,EAAE,CACN,IAAI,GAAG,CACP,SAAS,oCAAoC;EAChD,SAASA,OAAAA,EACN,QAAQ,CACR,UAAU,CACV,SACC,sFACD;EACJ,CAAC;CACF,MAAM,QAAQ,QAAiB,MAAgD;EAC7E,MAAM,EAAE,OAAO,YAAY;AAK3B,SAAO;GACL,SAAS;GACT,MAAM;IACJ,SAAS,WAAW;IACpB,YAAY,MAAM;IAClB,OAAO,MAAM,KAAK,GAAG,OAAO;KAC1B,OAAO,IAAI;KACX,OAAO,EAAE;KACT,QAAQ,EAAE,UAAU;KACrB,EAAE;IACJ;GACD,UAAU;IACR,QAAQ;IACR,MAAM;KACJ,SAAS,WAAW;KACpB,OAAO,MAAM,KAAK,GAAG,OAAO;MAC1B,OAAO,IAAI;MACX,OAAO,EAAE;MACT,QAAQ,EAAE,UAAU;MACrB,EAAE;KACJ;IACF;GACF;;CAEJ,EAMiD;CAChD,IAAI;CACJ,MAAM;CACN,aACE;CAGF,YAAYA,OAAAA,EAAE,OAAO;EACnB,OAAOA,OAAAA,EACJ,MACCA,OAAAA,EAAE,OAAO;GACP,OAAOA,OAAAA,EAAE,QAAQ,CAAC,SAAS,oCAAoC;GAC/D,QAAQA,OAAAA,EACL,KAAK;IAAC;IAAW;IAAe;IAAQ;IAAU,CAAC,CACnD,SAAS,sBAAsB;GACnC,CAAC,CACH,CACA,IAAI,EAAE,CACN,IAAI,GAAG,CACP,SAAS,wEAAwE;EACpF,MAAMA,OAAAA,EACH,QAAQ,CACR,UAAU,CACV,SACC,+FACD;EACJ,CAAC;CACF,MAAM,QAAQ,QAAiB,MAAgD;EAC7E,MAAM,EAAE,OAAO,SAAS;EAKxB,MAAM,YAAY,MAAM,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;EAC3D,MAAM,aAAa,MAAM,QAAQ,MAAM,EAAE,WAAW,UAAU,CAAC;AAE/D,SAAO;GACL,SAAS;GACT,MAAM;IACJ,UAAU,GAAG,UAAU,GAAG,WAAW;IACrC,OAAO,MAAM,KAAK,GAAG,OAAO;KAC1B,OAAO,IAAI;KACX,OAAO,EAAE;KACT,QAAQ,EAAE;KACX,EAAE;IACH,GAAI,QAAQ,EAAE,MAAM;IACrB;GACD,UAAU;IACR,QAAQ;IACR,MAAM;KACJ,OAAO,MAAM,KAAK,GAAG,OAAO;MAC1B,OAAO,IAAI;MACX,OAAO,EAAE;MACT,QAAQ,EAAE;MACX,EAAE;KACH,UAAU,GAAG,UAAU,GAAG;KAC1B,GAAI,QAAQ,EAAE,MAAM;KACrB;IACF;GACF;;CAEJ,CAM2E"}

package/dist/services/chat/tools/plan-tools.js

@@ -0,0 +1,93 @@
+import { z } from "zod/v4";
+const planTools = [{
+	id: "set_plan",
+	name: "Set Plan",
+	description: "Create a step-by-step plan for building or modifying a flow. Use this BEFORE starting any complex work (3+ steps). Present the plan to the user and wait for their confirmation before executing. Each step should be a concise, actionable description.",
+	parameters: z.object({
+		steps: z.array(z.object({
+			title: z.string().describe("Short description of the step (e.g. \"Add HTTP request to AiPrise API\")"),
+			status: z.enum([
+				"pending",
+				"in_progress",
+				"done",
+				"skipped"
+			]).default("pending").describe("Step status — should be \"pending\" when first creating the plan")
+		})).min(1).max(20).describe("Ordered list of steps to complete"),
+		summary: z.string().optional().describe("Brief one-line summary of the overall goal (e.g. \"Build a KYC verification flow\")")
+	}),
+	async execute(params, _ctx) {
+		const { steps, summary } = params;
+		return {
+			success: true,
+			data: {
+				summary: summary ?? "Plan created",
+				totalSteps: steps.length,
+				steps: steps.map((s, i) => ({
+					index: i + 1,
+					title: s.title,
+					status: s.status ?? "pending"
+				}))
+			},
+			uiAction: {
+				action: "show_plan",
+				data: {
+					summary: summary ?? "Plan created",
+					steps: steps.map((s, i) => ({
+						index: i + 1,
+						title: s.title,
+						status: s.status ?? "pending"
+					}))
+				}
+			}
+		};
+	}
+}, {
+	id: "update_plan",
+	name: "Update Plan",
+	description: "Update the status of steps in the current plan. Use this after completing each step to keep the user informed of progress. You can also add new steps or mark steps as skipped if the plan needs to change.",
+	parameters: z.object({
+		steps: z.array(z.object({
+			title: z.string().describe("Step description (can be updated)"),
+			status: z.enum([
+				"pending",
+				"in_progress",
+				"done",
+				"skipped"
+			]).describe("Updated step status")
+		})).min(1).max(20).describe("Complete updated step list (include ALL steps, not just changed ones)"),
+		note: z.string().optional().describe("Optional note about what changed or why (e.g. \"AiPrise not available, using HTTP instead\")")
+	}),
+	async execute(params, _ctx) {
+		const { steps, note } = params;
+		const doneCount = steps.filter((s) => s.status === "done").length;
+		const totalSteps = steps.filter((s) => s.status !== "skipped").length;
+		return {
+			success: true,
+			data: {
+				progress: `${doneCount}/${totalSteps} steps completed`,
+				steps: steps.map((s, i) => ({
+					index: i + 1,
+					title: s.title,
+					status: s.status
+				})),
+				...note && { note }
+			},
+			uiAction: {
+				action: "update_plan",
+				data: {
+					steps: steps.map((s, i) => ({
+						index: i + 1,
+						title: s.title,
+						status: s.status
+					})),
+					progress: `${doneCount}/${totalSteps}`,
+					...note && { note }
+				}
+			}
+		};
+	}
+}];
+//#endregion
+export { planTools };
+
+//# sourceMappingURL=plan-tools.js.map

package/dist/services/chat/tools/plan-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tools.js","names":[],"sources":["../../../../src/services/chat/tools/plan-tools.ts"],"sourcesContent":["/**\n * Chat Tools — Plan Tracking\n *\n * Tools that let the AI assistant create and track a step-by-step plan.\n * Plans are visible to the user through tool call events in the chat stream.\n *\n * The LLM uses set_plan to present a plan before building, and update_plan\n * to mark steps as completed (or adjust the plan) as it works.\n *\n * Plans are ephemeral (per-conversation) — they live in the LLM's context\n * window via tool call/result history. No persistence needed.\n */\n\nimport { z } from 'zod/v4';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from '../chat-types';\n\n// =====================================\n// set_plan\n// =====================================\n\nexport const setPlanTool: ChatToolDefinition = {\n  id: 'set_plan',\n  name: 'Set Plan',\n  description:\n    'Create a step-by-step plan for building or modifying a flow. ' +\n    'Use this BEFORE starting any complex work (3+ steps). ' +\n    'Present the plan to the user and wait for their confirmation before executing. ' +\n    'Each step should be a concise, actionable description.',\n  parameters: z.object({\n    steps: z\n      .array(\n        z.object({\n          title: z\n            .string()\n            .describe('Short description of the step (e.g. \"Add HTTP request to AiPrise API\")'),\n          status: z\n            .enum(['pending', 'in_progress', 'done', 'skipped'])\n            .default('pending')\n            .describe('Step status — should be \"pending\" when first creating the plan'),\n        }),\n      )\n      .min(1)\n      .max(20)\n      .describe('Ordered list of steps to complete'),\n    summary: z\n      .string()\n      .optional()\n      .describe(\n        'Brief one-line summary of the overall goal (e.g. \"Build a KYC verification flow\")',\n      ),\n  }),\n  async execute(params: unknown, _ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { steps, summary } = params as {\n      steps: Array<{ title: string; status: string }>;\n      summary?: string;\n    };\n\n    return {\n      success: true,\n      data: {\n        summary: summary ?? 'Plan created',\n        totalSteps: steps.length,\n        steps: steps.map((s, i) => ({\n          index: i + 1,\n          title: s.title,\n          status: s.status ?? 'pending',\n        })),\n      },\n      uiAction: {\n        action: 'show_plan',\n        data: {\n          summary: summary ?? 'Plan created',\n          steps: steps.map((s, i) => ({\n            index: i + 1,\n            title: s.title,\n            status: s.status ?? 'pending',\n          })),\n        },\n      },\n    };\n  },\n};\n\n// =====================================\n// update_plan\n// =====================================\n\nexport const updatePlanTool: ChatToolDefinition = {\n  id: 'update_plan',\n  name: 'Update Plan',\n  description:\n    'Update the status of steps in the current plan. Use this after completing each step ' +\n    'to keep the user informed of progress. You can also add new steps or mark steps as skipped ' +\n    'if the plan needs to change.',\n  parameters: z.object({\n    steps: z\n      .array(\n        z.object({\n          title: z.string().describe('Step description (can be updated)'),\n          status: z\n            .enum(['pending', 'in_progress', 'done', 'skipped'])\n            .describe('Updated step status'),\n        }),\n      )\n      .min(1)\n      .max(20)\n      .describe('Complete updated step list (include ALL steps, not just changed ones)'),\n    note: z\n      .string()\n      .optional()\n      .describe(\n        'Optional note about what changed or why (e.g. \"AiPrise not available, using HTTP instead\")',\n      ),\n  }),\n  async execute(params: unknown, _ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { steps, note } = params as {\n      steps: Array<{ title: string; status: string }>;\n      note?: string;\n    };\n\n    const doneCount = steps.filter((s) => s.status === 'done').length;\n    const totalSteps = steps.filter((s) => s.status !== 'skipped').length;\n\n    return {\n      success: true,\n      data: {\n        progress: `${doneCount}/${totalSteps} steps completed`,\n        steps: steps.map((s, i) => ({\n          index: i + 1,\n          title: s.title,\n          status: s.status,\n        })),\n        ...(note && { note }),\n      },\n      uiAction: {\n        action: 'update_plan',\n        data: {\n          steps: steps.map((s, i) => ({\n            index: i + 1,\n            title: s.title,\n            status: s.status,\n          })),\n          progress: `${doneCount}/${totalSteps}`,\n          ...(note && { note }),\n        },\n      },\n    };\n  },\n};\n\n// =====================================\n// Export all plan tools\n// =====================================\n\nexport const planTools: ChatToolDefinition[] = [setPlanTool, updatePlanTool];\n"],"mappings":";AA0JA,MAAa,YAAkC,CAtIA;CAC7C,IAAI;CACJ,MAAM;CACN,aACE;CAIF,YAAY,EAAE,OAAO;EACnB,OAAO,EACJ,MACC,EAAE,OAAO;GACP,OAAO,EACJ,QAAQ,CACR,SAAS,2EAAyE;GACrF,QAAQ,EACL,KAAK;IAAC;IAAW;IAAe;IAAQ;IAAU,CAAC,CACnD,QAAQ,UAAU,CAClB,SAAS,mEAAiE;GAC9E,CAAC,CACH,CACA,IAAI,EAAE,CACN,IAAI,GAAG,CACP,SAAS,oCAAoC;EAChD,SAAS,EACN,QAAQ,CACR,UAAU,CACV,SACC,sFACD;EACJ,CAAC;CACF,MAAM,QAAQ,QAAiB,MAAgD;EAC7E,MAAM,EAAE,OAAO,YAAY;AAK3B,SAAO;GACL,SAAS;GACT,MAAM;IACJ,SAAS,WAAW;IACpB,YAAY,MAAM;IAClB,OAAO,MAAM,KAAK,GAAG,OAAO;KAC1B,OAAO,IAAI;KACX,OAAO,EAAE;KACT,QAAQ,EAAE,UAAU;KACrB,EAAE;IACJ;GACD,UAAU;IACR,QAAQ;IACR,MAAM;KACJ,SAAS,WAAW;KACpB,OAAO,MAAM,KAAK,GAAG,OAAO;MAC1B,OAAO,IAAI;MACX,OAAO,EAAE;MACT,QAAQ,EAAE,UAAU;MACrB,EAAE;KACJ;IACF;GACF;;CAEJ,EAMiD;CAChD,IAAI;CACJ,MAAM;CACN,aACE;CAGF,YAAY,EAAE,OAAO;EACnB,OAAO,EACJ,MACC,EAAE,OAAO;GACP,OAAO,EAAE,QAAQ,CAAC,SAAS,oCAAoC;GAC/D,QAAQ,EACL,KAAK;IAAC;IAAW;IAAe;IAAQ;IAAU,CAAC,CACnD,SAAS,sBAAsB;GACnC,CAAC,CACH,CACA,IAAI,EAAE,CACN,IAAI,GAAG,CACP,SAAS,wEAAwE;EACpF,MAAM,EACH,QAAQ,CACR,UAAU,CACV,SACC,+FACD;EACJ,CAAC;CACF,MAAM,QAAQ,QAAiB,MAAgD;EAC7E,MAAM,EAAE,OAAO,SAAS;EAKxB,MAAM,YAAY,MAAM,QAAQ,MAAM,EAAE,WAAW,OAAO,CAAC;EAC3D,MAAM,aAAa,MAAM,QAAQ,MAAM,EAAE,WAAW,UAAU,CAAC;AAE/D,SAAO;GACL,SAAS;GACT,MAAM;IACJ,UAAU,GAAG,UAAU,GAAG,WAAW;IACrC,OAAO,MAAM,KAAK,GAAG,OAAO;KAC1B,OAAO,IAAI;KACX,OAAO,EAAE;KACT,QAAQ,EAAE;KACX,EAAE;IACH,GAAI,QAAQ,EAAE,MAAM;IACrB;GACD,UAAU;IACR,QAAQ;IACR,MAAM;KACJ,OAAO,MAAM,KAAK,GAAG,OAAO;MAC1B,OAAO,IAAI;MACX,OAAO,EAAE;MACT,QAAQ,EAAE;MACX,EAAE;KACH,UAAU,GAAG,UAAU,GAAG;KAC1B,GAAI,QAAQ,EAAE,MAAM;KACrB;IACF;GACF;;CAEJ,CAM2E"}

package/dist/services/chat/tools/run-tools.cjs

@@ -0,0 +1,121 @@
+require("../../../_virtual/_rolldown/runtime.cjs");
+let zod_v4 = require("zod/v4");
+const runTools = [
+	{
+		id: "get_flow_run",
+		name: "Get Flow Run",
+		description: "Get the details of a specific flow run by its ID. Returns status, duration, inputs, outputs, and error information. Use this after run_flow to inspect results, or to investigate a past run.",
+		parameters: zod_v4.z.object({ flowRunId: zod_v4.z.string().describe("The flow run ID to inspect") }),
+		async execute(params, ctx) {
+			const { flowRunId } = params;
+			const invect = ctx.invect;
+			try {
+				const run = await invect.getFlowRunById(flowRunId);
+				if (!run) return {
+					success: false,
+					error: `Flow run "${flowRunId}" not found`
+				};
+				return {
+					success: true,
+					data: {
+						id: run.id,
+						flowId: run.flowId,
+						status: run.status,
+						flowVersion: run.flowVersion,
+						duration: run.duration,
+						inputs: run.inputs,
+						outputs: run.outputs,
+						error: run.error,
+						startedAt: run.startedAt,
+						completedAt: run.completedAt,
+						triggerType: run.triggerType
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to get flow run: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "get_node_execution_results",
+		name: "Get Node Execution Results",
+		description: "Get the execution trace for every node in a flow run. Shows per-node status, inputs, outputs, duration, and errors. Essential for debugging — tells you exactly which node failed and why.",
+		parameters: zod_v4.z.object({ flowRunId: zod_v4.z.string().describe("The flow run ID to get node executions for") }),
+		async execute(params, ctx) {
+			const { flowRunId } = params;
+			const invect = ctx.invect;
+			try {
+				const traces = (await invect.getNodeExecutionsByRunId(flowRunId)).map((ex) => ({
+					nodeId: ex.nodeId,
+					nodeType: ex.nodeType,
+					status: ex.status,
+					duration: ex.duration,
+					error: ex.error,
+					output: ex.outputs ? JSON.stringify(ex.outputs).length > 2e3 ? JSON.stringify(ex.outputs).slice(0, 2e3) + "…(truncated)" : ex.outputs : void 0,
+					input: ex.inputs ? JSON.stringify(ex.inputs).length > 1e3 ? JSON.stringify(ex.inputs).slice(0, 1e3) + "…(truncated)" : ex.inputs : void 0
+				}));
+				const failedNodes = traces.filter((t) => t.status === "FAILED" || t.error);
+				return {
+					success: true,
+					data: {
+						totalNodes: traces.length,
+						failedCount: failedNodes.length,
+						traces,
+						...failedNodes.length > 0 && { failureSummary: failedNodes.map((n) => `${n.nodeId} (${n.nodeType}): ${n.error}`) }
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to get node executions: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "list_flow_runs",
+		name: "List Flow Runs",
+		description: "List recent flow runs for the currently open flow. Shows run status, duration, and when each ran. Use this to answer questions like \"has this flow been working?\" or \"show recent runs\".",
+		parameters: zod_v4.z.object({ limit: zod_v4.z.number().optional().default(10).describe("Max runs to return (default 10)") }),
+		async execute(params, ctx) {
+			const { limit } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const runs = (await invect.listFlowRunsByFlowId(flowId)).data;
+				const limited = runs.slice(0, limit ?? 10);
+				return {
+					success: true,
+					data: {
+						total: runs.length,
+						runs: limited.map((r) => ({
+							id: r.id,
+							status: r.status,
+							duration: r.duration,
+							startedAt: r.startedAt,
+							completedAt: r.completedAt,
+							error: r.error ? String(r.error).slice(0, 200) : void 0,
+							triggerType: r.triggerType
+						}))
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to list flow runs: ${error.message}`
+				};
+			}
+		}
+	}
+];
+//#endregion
+exports.runTools = runTools;
+
+//# sourceMappingURL=run-tools.cjs.map

package/dist/services/chat/tools/run-tools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tools.cjs","names":["z"],"sources":["../../../../src/services/chat/tools/run-tools.ts"],"sourcesContent":["/**\n * Chat Tools — Run & Debug\n *\n * Tools for inspecting flow runs, node executions, and testing nodes.\n * These are essential for the assistant to reason about \"why did this fail?\"\n */\n\nimport { z } from 'zod/v4';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from '../chat-types';\nimport type { Invect } from 'src/invect-core';\n\n// =====================================\n// get_flow_run\n// =====================================\n\nexport const getFlowRunTool: ChatToolDefinition = {\n  id: 'get_flow_run',\n  name: 'Get Flow Run',\n  description:\n    'Get the details of a specific flow run by its ID. ' +\n    'Returns status, duration, inputs, outputs, and error information. ' +\n    'Use this after run_flow to inspect results, or to investigate a past run.',\n  parameters: z.object({\n    flowRunId: z.string().describe('The flow run ID to inspect'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { flowRunId } = params as { flowRunId: string };\n    const invect = ctx.invect as Invect;\n\n    try {\n      const run = await invect.getFlowRunById(flowRunId);\n      if (!run) {\n        return { success: false, error: `Flow run \"${flowRunId}\" not found` };\n      }\n\n      return {\n        success: true,\n        data: {\n          id: run.id,\n          flowId: run.flowId,\n          status: run.status,\n          flowVersion: run.flowVersion,\n          duration: run.duration,\n          inputs: run.inputs,\n          outputs: run.outputs,\n          error: run.error,\n          startedAt: run.startedAt,\n          completedAt: run.completedAt,\n          triggerType: run.triggerType,\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to get flow run: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// get_node_execution_results\n// =====================================\n\nexport const getNodeExecutionResultsTool: ChatToolDefinition = {\n  id: 'get_node_execution_results',\n  name: 'Get Node Execution Results',\n  description:\n    'Get the execution trace for every node in a flow run. ' +\n    'Shows per-node status, inputs, outputs, duration, and errors. ' +\n    'Essential for debugging — tells you exactly which node failed and why.',\n  parameters: z.object({\n    flowRunId: z.string().describe('The flow run ID to get node executions for'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { flowRunId } = params as { flowRunId: string };\n    const invect = ctx.invect as Invect;\n\n    try {\n      const executions = await invect.getNodeExecutionsByRunId(flowRunId);\n\n      // Return a compact view — full outputs can be huge\n      const traces = executions.map((ex) => ({\n        nodeId: ex.nodeId,\n        nodeType: ex.nodeType,\n        status: ex.status,\n        duration: ex.duration,\n        error: ex.error,\n        // Truncate large outputs to keep context manageable\n        output: ex.outputs\n          ? JSON.stringify(ex.outputs).length > 2000\n            ? JSON.stringify(ex.outputs).slice(0, 2000) + '…(truncated)'\n            : ex.outputs\n          : undefined,\n        input: ex.inputs\n          ? JSON.stringify(ex.inputs).length > 1000\n            ? JSON.stringify(ex.inputs).slice(0, 1000) + '…(truncated)'\n            : ex.inputs\n          : undefined,\n      }));\n\n      const failedNodes = traces.filter((t) => t.status === 'FAILED' || t.error);\n\n      return {\n        success: true,\n        data: {\n          totalNodes: traces.length,\n          failedCount: failedNodes.length,\n          traces,\n          ...(failedNodes.length > 0 && {\n            failureSummary: failedNodes.map((n) => `${n.nodeId} (${n.nodeType}): ${n.error}`),\n          }),\n        },\n      };\n    } catch (error: unknown) {\n      return {\n        success: false,\n        error: `Failed to get node executions: ${(error as Error).message}`,\n      };\n    }\n  },\n};\n\n// =====================================\n// list_flow_runs\n// =====================================\n\nexport const listFlowRunsTool: ChatToolDefinition = {\n  id: 'list_flow_runs',\n  name: 'List Flow Runs',\n  description:\n    'List recent flow runs for the currently open flow. ' +\n    'Shows run status, duration, and when each ran. ' +\n    'Use this to answer questions like \"has this flow been working?\" or \"show recent runs\".',\n  parameters: z.object({\n    limit: z.number().optional().default(10).describe('Max runs to return (default 10)'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { limit } = params as { limit?: number };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const result = await invect.listFlowRunsByFlowId(flowId);\n      const runs = result.data;\n      const limited = runs.slice(0, limit ?? 10);\n\n      return {\n        success: true,\n        data: {\n          total: runs.length,\n          runs: limited.map((r) => ({\n            id: r.id,\n            status: r.status,\n            duration: r.duration,\n            startedAt: r.startedAt,\n            completedAt: r.completedAt,\n            error: r.error ? String(r.error).slice(0, 200) : undefined,\n            triggerType: r.triggerType,\n          })),\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to list flow runs: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// Export all run tools\n// =====================================\n\nexport const runTools: ChatToolDefinition[] = [\n  getFlowRunTool,\n  getNodeExecutionResultsTool,\n  listFlowRunsTool,\n];\n"],"mappings":";;AA6KA,MAAa,WAAiC;CA9JI;EAChD,IAAI;EACJ,MAAM;EACN,aACE;EAGF,YAAYA,OAAAA,EAAE,OAAO,EACnB,WAAWA,OAAAA,EAAE,QAAQ,CAAC,SAAS,6BAA6B,EAC7D,CAAC;EACF,MAAM,QAAQ,QAAiB,KAA+C;GAC5E,MAAM,EAAE,cAAc;GACtB,MAAM,SAAS,IAAI;AAEnB,OAAI;IACF,MAAM,MAAM,MAAM,OAAO,eAAe,UAAU;AAClD,QAAI,CAAC,IACH,QAAO;KAAE,SAAS;KAAO,OAAO,aAAa,UAAU;KAAc;AAGvE,WAAO;KACL,SAAS;KACT,MAAM;MACJ,IAAI,IAAI;MACR,QAAQ,IAAI;MACZ,QAAQ,IAAI;MACZ,aAAa,IAAI;MACjB,UAAU,IAAI;MACd,QAAQ,IAAI;MACZ,SAAS,IAAI;MACb,OAAO,IAAI;MACX,WAAW,IAAI;MACf,aAAa,IAAI;MACjB,aAAa,IAAI;MAClB;KACF;YACM,OAAgB;AACvB,WAAO;KAAE,SAAS;KAAO,OAAO,2BAA4B,MAAgB;KAAW;;;EAG5F;CAM8D;EAC7D,IAAI;EACJ,MAAM;EACN,aACE;EAGF,YAAYA,OAAAA,EAAE,OAAO,EACnB,WAAWA,OAAAA,EAAE,QAAQ,CAAC,SAAS,6CAA6C,EAC7E,CAAC;EACF,MAAM,QAAQ,QAAiB,KAA+C;GAC5E,MAAM,EAAE,cAAc;GACtB,MAAM,SAAS,IAAI;AAEnB,OAAI;IAIF,MAAM,UAHa,MAAM,OAAO,yBAAyB,UAAU,EAGzC,KAAK,QAAQ;KACrC,QAAQ,GAAG;KACX,UAAU,GAAG;KACb,QAAQ,GAAG;KACX,UAAU,GAAG;KACb,OAAO,GAAG;KAEV,QAAQ,GAAG,UACP,KAAK,UAAU,GAAG,QAAQ,CAAC,SAAS,MAClC,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,IAAK,GAAG,iBAC5C,GAAG,UACL,KAAA;KACJ,OAAO,GAAG,SACN,KAAK,UAAU,GAAG,OAAO,CAAC,SAAS,MACjC,KAAK,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAK,GAAG,iBAC3C,GAAG,SACL,KAAA;KACL,EAAE;IAEH,MAAM,cAAc,OAAO,QAAQ,MAAM,EAAE,WAAW,YAAY,EAAE,MAAM;AAE1E,WAAO;KACL,SAAS;KACT,MAAM;MACJ,YAAY,OAAO;MACnB,aAAa,YAAY;MACzB;MACA,GAAI,YAAY,SAAS,KAAK,EAC5B,gBAAgB,YAAY,KAAK,MAAM,GAAG,EAAE,OAAO,IAAI,EAAE,SAAS,KAAK,EAAE,QAAQ,EAClF;MACF;KACF;YACM,OAAgB;AACvB,WAAO;KACL,SAAS;KACT,OAAO,kCAAmC,MAAgB;KAC3D;;;EAGN;CAMmD;EAClD,IAAI;EACJ,MAAM;EACN,aACE;EAGF,YAAYA,OAAAA,EAAE,OAAO,EACnB,OAAOA,OAAAA,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,SAAS,kCAAkC,EACrF,CAAC;EACF,MAAM,QAAQ,QAAiB,KAA+C;GAC5E,MAAM,EAAE,UAAU;GAClB,MAAM,SAAS,IAAI;GACnB,MAAM,SAAS,IAAI,YAAY;AAE/B,OAAI,CAAC,OACH,QAAO;IAAE,SAAS;IAAO,OAAO;IAA6B;AAG/D,OAAI;IAEF,MAAM,QADS,MAAM,OAAO,qBAAqB,OAAO,EACpC;IACpB,MAAM,UAAU,KAAK,MAAM,GAAG,SAAS,GAAG;AAE1C,WAAO;KACL,SAAS;KACT,MAAM;MACJ,OAAO,KAAK;MACZ,MAAM,QAAQ,KAAK,OAAO;OACxB,IAAI,EAAE;OACN,QAAQ,EAAE;OACV,UAAU,EAAE;OACZ,WAAW,EAAE;OACb,aAAa,EAAE;OACf,OAAO,EAAE,QAAQ,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,KAAA;OACjD,aAAa,EAAE;OAChB,EAAE;MACJ;KACF;YACM,OAAgB;AACvB,WAAO;KAAE,SAAS;KAAO,OAAO,6BAA8B,MAAgB;KAAW;;;EAG9F;CAUA"}

package/dist/services/chat/tools/run-tools.js

@@ -0,0 +1,120 @@
+import { z } from "zod/v4";
+const runTools = [
+	{
+		id: "get_flow_run",
+		name: "Get Flow Run",
+		description: "Get the details of a specific flow run by its ID. Returns status, duration, inputs, outputs, and error information. Use this after run_flow to inspect results, or to investigate a past run.",
+		parameters: z.object({ flowRunId: z.string().describe("The flow run ID to inspect") }),
+		async execute(params, ctx) {
+			const { flowRunId } = params;
+			const invect = ctx.invect;
+			try {
+				const run = await invect.getFlowRunById(flowRunId);
+				if (!run) return {
+					success: false,
+					error: `Flow run "${flowRunId}" not found`
+				};
+				return {
+					success: true,
+					data: {
+						id: run.id,
+						flowId: run.flowId,
+						status: run.status,
+						flowVersion: run.flowVersion,
+						duration: run.duration,
+						inputs: run.inputs,
+						outputs: run.outputs,
+						error: run.error,
+						startedAt: run.startedAt,
+						completedAt: run.completedAt,
+						triggerType: run.triggerType
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to get flow run: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "get_node_execution_results",
+		name: "Get Node Execution Results",
+		description: "Get the execution trace for every node in a flow run. Shows per-node status, inputs, outputs, duration, and errors. Essential for debugging — tells you exactly which node failed and why.",
+		parameters: z.object({ flowRunId: z.string().describe("The flow run ID to get node executions for") }),
+		async execute(params, ctx) {
+			const { flowRunId } = params;
+			const invect = ctx.invect;
+			try {
+				const traces = (await invect.getNodeExecutionsByRunId(flowRunId)).map((ex) => ({
+					nodeId: ex.nodeId,
+					nodeType: ex.nodeType,
+					status: ex.status,
+					duration: ex.duration,
+					error: ex.error,
+					output: ex.outputs ? JSON.stringify(ex.outputs).length > 2e3 ? JSON.stringify(ex.outputs).slice(0, 2e3) + "…(truncated)" : ex.outputs : void 0,
+					input: ex.inputs ? JSON.stringify(ex.inputs).length > 1e3 ? JSON.stringify(ex.inputs).slice(0, 1e3) + "…(truncated)" : ex.inputs : void 0
+				}));
+				const failedNodes = traces.filter((t) => t.status === "FAILED" || t.error);
+				return {
+					success: true,
+					data: {
+						totalNodes: traces.length,
+						failedCount: failedNodes.length,
+						traces,
+						...failedNodes.length > 0 && { failureSummary: failedNodes.map((n) => `${n.nodeId} (${n.nodeType}): ${n.error}`) }
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to get node executions: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "list_flow_runs",
+		name: "List Flow Runs",
+		description: "List recent flow runs for the currently open flow. Shows run status, duration, and when each ran. Use this to answer questions like \"has this flow been working?\" or \"show recent runs\".",
+		parameters: z.object({ limit: z.number().optional().default(10).describe("Max runs to return (default 10)") }),
+		async execute(params, ctx) {
+			const { limit } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const runs = (await invect.listFlowRunsByFlowId(flowId)).data;
+				const limited = runs.slice(0, limit ?? 10);
+				return {
+					success: true,
+					data: {
+						total: runs.length,
+						runs: limited.map((r) => ({
+							id: r.id,
+							status: r.status,
+							duration: r.duration,
+							startedAt: r.startedAt,
+							completedAt: r.completedAt,
+							error: r.error ? String(r.error).slice(0, 200) : void 0,
+							triggerType: r.triggerType
+						}))
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to list flow runs: ${error.message}`
+				};
+			}
+		}
+	}
+];
+//#endregion
+export { runTools };
+
+//# sourceMappingURL=run-tools.js.map

package/dist/services/chat/tools/run-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tools.js","names":[],"sources":["../../../../src/services/chat/tools/run-tools.ts"],"sourcesContent":["/**\n * Chat Tools — Run & Debug\n *\n * Tools for inspecting flow runs, node executions, and testing nodes.\n * These are essential for the assistant to reason about \"why did this fail?\"\n */\n\nimport { z } from 'zod/v4';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from '../chat-types';\nimport type { Invect } from 'src/invect-core';\n\n// =====================================\n// get_flow_run\n// =====================================\n\nexport const getFlowRunTool: ChatToolDefinition = {\n  id: 'get_flow_run',\n  name: 'Get Flow Run',\n  description:\n    'Get the details of a specific flow run by its ID. ' +\n    'Returns status, duration, inputs, outputs, and error information. ' +\n    'Use this after run_flow to inspect results, or to investigate a past run.',\n  parameters: z.object({\n    flowRunId: z.string().describe('The flow run ID to inspect'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { flowRunId } = params as { flowRunId: string };\n    const invect = ctx.invect as Invect;\n\n    try {\n      const run = await invect.getFlowRunById(flowRunId);\n      if (!run) {\n        return { success: false, error: `Flow run \"${flowRunId}\" not found` };\n      }\n\n      return {\n        success: true,\n        data: {\n          id: run.id,\n          flowId: run.flowId,\n          status: run.status,\n          flowVersion: run.flowVersion,\n          duration: run.duration,\n          inputs: run.inputs,\n          outputs: run.outputs,\n          error: run.error,\n          startedAt: run.startedAt,\n          completedAt: run.completedAt,\n          triggerType: run.triggerType,\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to get flow run: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// get_node_execution_results\n// =====================================\n\nexport const getNodeExecutionResultsTool: ChatToolDefinition = {\n  id: 'get_node_execution_results',\n  name: 'Get Node Execution Results',\n  description:\n    'Get the execution trace for every node in a flow run. ' +\n    'Shows per-node status, inputs, outputs, duration, and errors. ' +\n    'Essential for debugging — tells you exactly which node failed and why.',\n  parameters: z.object({\n    flowRunId: z.string().describe('The flow run ID to get node executions for'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { flowRunId } = params as { flowRunId: string };\n    const invect = ctx.invect as Invect;\n\n    try {\n      const executions = await invect.getNodeExecutionsByRunId(flowRunId);\n\n      // Return a compact view — full outputs can be huge\n      const traces = executions.map((ex) => ({\n        nodeId: ex.nodeId,\n        nodeType: ex.nodeType,\n        status: ex.status,\n        duration: ex.duration,\n        error: ex.error,\n        // Truncate large outputs to keep context manageable\n        output: ex.outputs\n          ? JSON.stringify(ex.outputs).length > 2000\n            ? JSON.stringify(ex.outputs).slice(0, 2000) + '…(truncated)'\n            : ex.outputs\n          : undefined,\n        input: ex.inputs\n          ? JSON.stringify(ex.inputs).length > 1000\n            ? JSON.stringify(ex.inputs).slice(0, 1000) + '…(truncated)'\n            : ex.inputs\n          : undefined,\n      }));\n\n      const failedNodes = traces.filter((t) => t.status === 'FAILED' || t.error);\n\n      return {\n        success: true,\n        data: {\n          totalNodes: traces.length,\n          failedCount: failedNodes.length,\n          traces,\n          ...(failedNodes.length > 0 && {\n            failureSummary: failedNodes.map((n) => `${n.nodeId} (${n.nodeType}): ${n.error}`),\n          }),\n        },\n      };\n    } catch (error: unknown) {\n      return {\n        success: false,\n        error: `Failed to get node executions: ${(error as Error).message}`,\n      };\n    }\n  },\n};\n\n// =====================================\n// list_flow_runs\n// =====================================\n\nexport const listFlowRunsTool: ChatToolDefinition = {\n  id: 'list_flow_runs',\n  name: 'List Flow Runs',\n  description:\n    'List recent flow runs for the currently open flow. ' +\n    'Shows run status, duration, and when each ran. ' +\n    'Use this to answer questions like \"has this flow been working?\" or \"show recent runs\".',\n  parameters: z.object({\n    limit: z.number().optional().default(10).describe('Max runs to return (default 10)'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { limit } = params as { limit?: number };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const result = await invect.listFlowRunsByFlowId(flowId);\n      const runs = result.data;\n      const limited = runs.slice(0, limit ?? 10);\n\n      return {\n        success: true,\n        data: {\n          total: runs.length,\n          runs: limited.map((r) => ({\n            id: r.id,\n            status: r.status,\n            duration: r.duration,\n            startedAt: r.startedAt,\n            completedAt: r.completedAt,\n            error: r.error ? String(r.error).slice(0, 200) : undefined,\n            triggerType: r.triggerType,\n          })),\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to list flow runs: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// Export all run tools\n// =====================================\n\nexport const runTools: ChatToolDefinition[] = [\n  getFlowRunTool,\n  getNodeExecutionResultsTool,\n  listFlowRunsTool,\n];\n"],"mappings":"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"}