@invect/core 0.0.1

package/dist/services/chat/chat-toolkit.cjs

@@ -0,0 +1,125 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("./tools/index.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/services/chat/chat-toolkit.ts
+/**
+* Chat Toolkit
+*
+* Registry of all chat tools available to the AI assistant.
+* Handles tool registration, parameter validation (Zod), and execution dispatch.
+*
+* Phase 1: Ships with zero tools — the LLM can only have text conversations.
+* Phase 2+: Tools are added in groups (flow, node, run, action, credential, trigger).
+*/
+/**
+* ChatToolkit manages the set of tools available to the chat assistant.
+*
+* Tools are plain objects with Zod schemas and execute functions.
+* The toolkit converts them to AgentToolDefinition format for the LLM adapters.
+*/
+var ChatToolkit = class {
+	tools = /* @__PURE__ */ new Map();
+	constructor(logger) {
+		this.logger = logger;
+		this.registerBuiltinTools();
+	}
+	/**
+	* Register a single chat tool.
+	*/
+	register(tool) {
+		if (this.tools.has(tool.id)) this.logger.warn(`Chat tool "${tool.id}" already registered, overwriting`);
+		this.tools.set(tool.id, tool);
+	}
+	/**
+	* Register multiple chat tools.
+	*/
+	registerMany(tools) {
+		for (const tool of tools) this.register(tool);
+	}
+	/**
+	* Get a tool by ID.
+	*/
+	get(id) {
+		return this.tools.get(id);
+	}
+	/**
+	* Get all registered tool definitions.
+	*/
+	getAll() {
+		return Array.from(this.tools.values());
+	}
+	/**
+	* Get tool count.
+	*/
+	get size() {
+		return this.tools.size;
+	}
+	/**
+	* Convert all registered tools to AgentToolDefinition format.
+	* This is what the existing OpenAI/Anthropic adapters expect.
+	*/
+	getToolDefinitions() {
+		return Array.from(this.tools.values()).map((tool) => ({
+			id: tool.id,
+			name: tool.name,
+			description: tool.description,
+			inputSchema: this.zodToJsonSchema(tool.parameters),
+			category: "utility"
+		}));
+	}
+	/**
+	* Execute a tool by name with the given input.
+	* Handles Zod validation and error wrapping.
+	*/
+	async executeTool(toolName, rawInput, ctx) {
+		const tool = this.tools.get(toolName);
+		if (!tool) return {
+			success: false,
+			error: `Unknown tool: "${toolName}". Available tools: ${Array.from(this.tools.keys()).join(", ")}`,
+			errorType: "UnknownToolError"
+		};
+		const parsed = tool.parameters.safeParse(rawInput);
+		if (!parsed.success) return {
+			success: false,
+			error: `Invalid parameters for "${toolName}": ${parsed.error?.message ?? "Validation failed"}`,
+			errorType: "ValidationError"
+		};
+		try {
+			return await tool.execute(parsed.data, ctx);
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			const errorType = error instanceof Error ? error.constructor.name : "UnknownError";
+			this.logger.error(`Chat tool "${toolName}" execution failed:`, { error: errorMessage });
+			return {
+				success: false,
+				error: errorMessage,
+				errorType
+			};
+		}
+	}
+	/**
+	* Register built-in tools.
+	*/
+	registerBuiltinTools() {
+		this.registerMany(require_index.allChatTools);
+		this.logger.debug(`ChatToolkit initialized with ${this.tools.size} tools`);
+	}
+	/**
+	* Convert a Zod schema to JSON Schema for the LLM tool definitions.
+	* Uses Zod v4's built-in JSON Schema support.
+	*/
+	zodToJsonSchema(schema) {
+		try {
+			return zod_v4.z.toJSONSchema(schema);
+		} catch {
+			return {
+				type: "object",
+				properties: {}
+			};
+		}
+	}
+};
+//#endregion
+exports.ChatToolkit = ChatToolkit;
+
+//# sourceMappingURL=chat-toolkit.cjs.map

package/dist/services/chat/chat-toolkit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-toolkit.cjs","names":["allChatTools","z"],"sources":["../../../src/services/chat/chat-toolkit.ts"],"sourcesContent":["/**\n * Chat Toolkit\n *\n * Registry of all chat tools available to the AI assistant.\n * Handles tool registration, parameter validation (Zod), and execution dispatch.\n *\n * Phase 1: Ships with zero tools — the LLM can only have text conversations.\n * Phase 2+: Tools are added in groups (flow, node, run, action, credential, trigger).\n */\n\nimport { z } from 'zod/v4';\nimport type { AgentToolDefinition } from 'src/types/agent-tool.types';\nimport type { Logger } from 'src/types/schemas';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from './chat-types';\nimport { allChatTools } from './tools';\n\n/**\n * ChatToolkit manages the set of tools available to the chat assistant.\n *\n * Tools are plain objects with Zod schemas and execute functions.\n * The toolkit converts them to AgentToolDefinition format for the LLM adapters.\n */\nexport class ChatToolkit {\n  private tools = new Map<string, ChatToolDefinition>();\n\n  constructor(private readonly logger: Logger) {\n    this.registerBuiltinTools();\n  }\n\n  // =====================================\n  // REGISTRATION\n  // =====================================\n\n  /**\n   * Register a single chat tool.\n   */\n  register(tool: ChatToolDefinition): void {\n    if (this.tools.has(tool.id)) {\n      this.logger.warn(`Chat tool \"${tool.id}\" already registered, overwriting`);\n    }\n    this.tools.set(tool.id, tool);\n  }\n\n  /**\n   * Register multiple chat tools.\n   */\n  registerMany(tools: ChatToolDefinition[]): void {\n    for (const tool of tools) {\n      this.register(tool);\n    }\n  }\n\n  // =====================================\n  // TOOL LOOKUP\n  // =====================================\n\n  /**\n   * Get a tool by ID.\n   */\n  get(id: string): ChatToolDefinition | undefined {\n    return this.tools.get(id);\n  }\n\n  /**\n   * Get all registered tool definitions.\n   */\n  getAll(): ChatToolDefinition[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get tool count.\n   */\n  get size(): number {\n    return this.tools.size;\n  }\n\n  // =====================================\n  // LLM TOOL FORMAT CONVERSION\n  // =====================================\n\n  /**\n   * Convert all registered tools to AgentToolDefinition format.\n   * This is what the existing OpenAI/Anthropic adapters expect.\n   */\n  getToolDefinitions(): AgentToolDefinition[] {\n    return Array.from(this.tools.values()).map((tool) => ({\n      id: tool.id,\n      name: tool.name,\n      description: tool.description,\n      inputSchema: this.zodToJsonSchema(tool.parameters),\n      category: 'utility' as const,\n    }));\n  }\n\n  // =====================================\n  // EXECUTION\n  // =====================================\n\n  /**\n   * Execute a tool by name with the given input.\n   * Handles Zod validation and error wrapping.\n   */\n  async executeTool(\n    toolName: string,\n    rawInput: unknown,\n    ctx: ChatToolContext,\n  ): Promise<ChatToolResult> {\n    const tool = this.tools.get(toolName);\n    if (!tool) {\n      return {\n        success: false,\n        error: `Unknown tool: \"${toolName}\". Available tools: ${Array.from(this.tools.keys()).join(', ')}`,\n        errorType: 'UnknownToolError',\n      };\n    }\n\n    // Validate parameters with Zod\n    const parsed = tool.parameters.safeParse(rawInput);\n    if (!parsed.success) {\n      return {\n        success: false,\n        error: `Invalid parameters for \"${toolName}\": ${parsed.error?.message ?? 'Validation failed'}`,\n        errorType: 'ValidationError',\n      };\n    }\n\n    // Execute with error wrapping\n    try {\n      return await tool.execute(parsed.data, ctx);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      const errorType = error instanceof Error ? error.constructor.name : 'UnknownError';\n\n      this.logger.error(`Chat tool \"${toolName}\" execution failed:`, { error: errorMessage });\n\n      return {\n        success: false,\n        error: errorMessage,\n        errorType,\n      };\n    }\n  }\n\n  // =====================================\n  // PRIVATE\n  // =====================================\n\n  /**\n   * Register built-in tools.\n   */\n  private registerBuiltinTools(): void {\n    this.registerMany(allChatTools);\n    this.logger.debug(`ChatToolkit initialized with ${this.tools.size} tools`);\n  }\n\n  /**\n   * Convert a Zod schema to JSON Schema for the LLM tool definitions.\n   * Uses Zod v4's built-in JSON Schema support.\n   */\n  private zodToJsonSchema(schema: z.ZodType): Record<string, unknown> {\n    try {\n      return z.toJSONSchema(schema) as Record<string, unknown>;\n    } catch {\n      // Fallback for schemas that can't be converted\n      return { type: 'object', properties: {} };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,IAAa,cAAb,MAAyB;CACvB,wBAAgB,IAAI,KAAiC;CAErD,YAAY,QAAiC;AAAhB,OAAA,SAAA;AAC3B,OAAK,sBAAsB;;;;;CAU7B,SAAS,MAAgC;AACvC,MAAI,KAAK,MAAM,IAAI,KAAK,GAAG,CACzB,MAAK,OAAO,KAAK,cAAc,KAAK,GAAG,mCAAmC;AAE5E,OAAK,MAAM,IAAI,KAAK,IAAI,KAAK;;;;;CAM/B,aAAa,OAAmC;AAC9C,OAAK,MAAM,QAAQ,MACjB,MAAK,SAAS,KAAK;;;;;CAWvB,IAAI,IAA4C;AAC9C,SAAO,KAAK,MAAM,IAAI,GAAG;;;;;CAM3B,SAA+B;AAC7B,SAAO,MAAM,KAAK,KAAK,MAAM,QAAQ,CAAC;;;;;CAMxC,IAAI,OAAe;AACjB,SAAO,KAAK,MAAM;;;;;;CAWpB,qBAA4C;AAC1C,SAAO,MAAM,KAAK,KAAK,MAAM,QAAQ,CAAC,CAAC,KAAK,UAAU;GACpD,IAAI,KAAK;GACT,MAAM,KAAK;GACX,aAAa,KAAK;GAClB,aAAa,KAAK,gBAAgB,KAAK,WAAW;GAClD,UAAU;GACX,EAAE;;;;;;CAWL,MAAM,YACJ,UACA,UACA,KACyB;EACzB,MAAM,OAAO,KAAK,MAAM,IAAI,SAAS;AACrC,MAAI,CAAC,KACH,QAAO;GACL,SAAS;GACT,OAAO,kBAAkB,SAAS,sBAAsB,MAAM,KAAK,KAAK,MAAM,MAAM,CAAC,CAAC,KAAK,KAAK;GAChG,WAAW;GACZ;EAIH,MAAM,SAAS,KAAK,WAAW,UAAU,SAAS;AAClD,MAAI,CAAC,OAAO,QACV,QAAO;GACL,SAAS;GACT,OAAO,2BAA2B,SAAS,KAAK,OAAO,OAAO,WAAW;GACzE,WAAW;GACZ;AAIH,MAAI;AACF,UAAO,MAAM,KAAK,QAAQ,OAAO,MAAM,IAAI;WACpC,OAAgB;GACvB,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC3E,MAAM,YAAY,iBAAiB,QAAQ,MAAM,YAAY,OAAO;AAEpE,QAAK,OAAO,MAAM,cAAc,SAAS,sBAAsB,EAAE,OAAO,cAAc,CAAC;AAEvF,UAAO;IACL,SAAS;IACT,OAAO;IACP;IACD;;;;;;CAWL,uBAAqC;AACnC,OAAK,aAAaA,cAAAA,aAAa;AAC/B,OAAK,OAAO,MAAM,gCAAgC,KAAK,MAAM,KAAK,QAAQ;;;;;;CAO5E,gBAAwB,QAA4C;AAClE,MAAI;AACF,UAAOC,OAAAA,EAAE,aAAa,OAAO;UACvB;AAEN,UAAO;IAAE,MAAM;IAAU,YAAY,EAAE;IAAE"}

package/dist/services/chat/chat-toolkit.d.cts

@@ -0,0 +1,58 @@
+import { Logger } from "../../types/schemas-fresh/invect-config.cjs";
+import { AgentToolDefinition } from "../../types/agent-tool.types.cjs";
+import { ChatToolContext, ChatToolDefinition, ChatToolResult } from "./chat-types.cjs";
+
+//#region src/services/chat/chat-toolkit.d.ts
+/**
+ * ChatToolkit manages the set of tools available to the chat assistant.
+ *
+ * Tools are plain objects with Zod schemas and execute functions.
+ * The toolkit converts them to AgentToolDefinition format for the LLM adapters.
+ */
+declare class ChatToolkit {
+  private readonly logger;
+  private tools;
+  constructor(logger: Logger);
+  /**
+   * Register a single chat tool.
+   */
+  register(tool: ChatToolDefinition): void;
+  /**
+   * Register multiple chat tools.
+   */
+  registerMany(tools: ChatToolDefinition[]): void;
+  /**
+   * Get a tool by ID.
+   */
+  get(id: string): ChatToolDefinition | undefined;
+  /**
+   * Get all registered tool definitions.
+   */
+  getAll(): ChatToolDefinition[];
+  /**
+   * Get tool count.
+   */
+  get size(): number;
+  /**
+   * Convert all registered tools to AgentToolDefinition format.
+   * This is what the existing OpenAI/Anthropic adapters expect.
+   */
+  getToolDefinitions(): AgentToolDefinition[];
+  /**
+   * Execute a tool by name with the given input.
+   * Handles Zod validation and error wrapping.
+   */
+  executeTool(toolName: string, rawInput: unknown, ctx: ChatToolContext): Promise<ChatToolResult>;
+  /**
+   * Register built-in tools.
+   */
+  private registerBuiltinTools;
+  /**
+   * Convert a Zod schema to JSON Schema for the LLM tool definitions.
+   * Uses Zod v4's built-in JSON Schema support.
+   */
+  private zodToJsonSchema;
+}
+//#endregion
+export { ChatToolkit };
+//# sourceMappingURL=chat-toolkit.d.cts.map

package/dist/services/chat/chat-toolkit.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-toolkit.d.cts","names":[],"sources":["../../../src/services/chat/chat-toolkit.ts"],"mappings":";;;;;;;;;;;cAsBa,WAAA;EAAA,iBAGkB,MAAA;EAAA,QAFrB,KAAA;cAEqB,MAAA,EAAQ,MAAA;EAAA;;;EAWrC,QAAA,CAAS,IAAA,EAAM,kBAAA;EAAN;;;EAUT,YAAA,CAAa,KAAA,EAAO,kBAAA;EAapB;;;EAAA,GAAA,CAAI,EAAA,WAAa,kBAAA;EAOP;;;EAAV,MAAA,CAAA,GAAU,kBAAA;EAqCJ;;;EAAA,IA9BF,IAAA,CAAA;EAiCF;;;;EArBF,kBAAA,CAAA,GAAsB,mBAAA;EA2EC;;;;EAzDjB,WAAA,CACJ,QAAA,UACA,QAAA,WACA,GAAA,EAAK,eAAA,GACJ,OAAA,CAAQ,cAAA;;;;UA4CH,oBAAA;;;;;UASA,eAAA;AAAA"}

package/dist/services/chat/chat-toolkit.d.ts

@@ -0,0 +1,58 @@
+import { Logger } from "../../types/schemas-fresh/invect-config.js";
+import { AgentToolDefinition } from "../../types/agent-tool.types.js";
+import { ChatToolContext, ChatToolDefinition, ChatToolResult } from "./chat-types.js";
+
+//#region src/services/chat/chat-toolkit.d.ts
+/**
+ * ChatToolkit manages the set of tools available to the chat assistant.
+ *
+ * Tools are plain objects with Zod schemas and execute functions.
+ * The toolkit converts them to AgentToolDefinition format for the LLM adapters.
+ */
+declare class ChatToolkit {
+  private readonly logger;
+  private tools;
+  constructor(logger: Logger);
+  /**
+   * Register a single chat tool.
+   */
+  register(tool: ChatToolDefinition): void;
+  /**
+   * Register multiple chat tools.
+   */
+  registerMany(tools: ChatToolDefinition[]): void;
+  /**
+   * Get a tool by ID.
+   */
+  get(id: string): ChatToolDefinition | undefined;
+  /**
+   * Get all registered tool definitions.
+   */
+  getAll(): ChatToolDefinition[];
+  /**
+   * Get tool count.
+   */
+  get size(): number;
+  /**
+   * Convert all registered tools to AgentToolDefinition format.
+   * This is what the existing OpenAI/Anthropic adapters expect.
+   */
+  getToolDefinitions(): AgentToolDefinition[];
+  /**
+   * Execute a tool by name with the given input.
+   * Handles Zod validation and error wrapping.
+   */
+  executeTool(toolName: string, rawInput: unknown, ctx: ChatToolContext): Promise<ChatToolResult>;
+  /**
+   * Register built-in tools.
+   */
+  private registerBuiltinTools;
+  /**
+   * Convert a Zod schema to JSON Schema for the LLM tool definitions.
+   * Uses Zod v4's built-in JSON Schema support.
+   */
+  private zodToJsonSchema;
+}
+//#endregion
+export { ChatToolkit };
+//# sourceMappingURL=chat-toolkit.d.ts.map

package/dist/services/chat/chat-toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-toolkit.d.ts","names":[],"sources":["../../../src/services/chat/chat-toolkit.ts"],"mappings":";;;;;;;;;;;cAsBa,WAAA;EAAA,iBAGkB,MAAA;EAAA,QAFrB,KAAA;cAEqB,MAAA,EAAQ,MAAA;;;;EAWrC,QAAA,CAAS,IAAA,EAAM,kBAAA;EAAA;;;EAUf,YAAA,CAAa,KAAA,EAAO,kBAAA;EAAP;;;EAab,GAAA,CAAI,EAAA,WAAa,kBAAA;EAOjB;;;EAAA,MAAA,CAAA,GAAU,kBAAA;EAmBY;;;EAAA,IAZlB,IAAA,CAAA;EAiCG;;;;EArBP,kBAAA,CAAA,GAAsB,mBAAA;EA2Ed;;;;EAzDF,WAAA,CACJ,QAAA,UACA,QAAA,WACA,GAAA,EAAK,eAAA,GACJ,OAAA,CAAQ,cAAA;;;;UA4CH,oBAAA;;;;;UASA,eAAA;AAAA"}

package/dist/services/chat/chat-toolkit.js

@@ -0,0 +1,124 @@
+import { allChatTools } from "./tools/index.js";
+import { z } from "zod/v4";
+//#region src/services/chat/chat-toolkit.ts
+/**
+* Chat Toolkit
+*
+* Registry of all chat tools available to the AI assistant.
+* Handles tool registration, parameter validation (Zod), and execution dispatch.
+*
+* Phase 1: Ships with zero tools — the LLM can only have text conversations.
+* Phase 2+: Tools are added in groups (flow, node, run, action, credential, trigger).
+*/
+/**
+* ChatToolkit manages the set of tools available to the chat assistant.
+*
+* Tools are plain objects with Zod schemas and execute functions.
+* The toolkit converts them to AgentToolDefinition format for the LLM adapters.
+*/
+var ChatToolkit = class {
+	tools = /* @__PURE__ */ new Map();
+	constructor(logger) {
+		this.logger = logger;
+		this.registerBuiltinTools();
+	}
+	/**
+	* Register a single chat tool.
+	*/
+	register(tool) {
+		if (this.tools.has(tool.id)) this.logger.warn(`Chat tool "${tool.id}" already registered, overwriting`);
+		this.tools.set(tool.id, tool);
+	}
+	/**
+	* Register multiple chat tools.
+	*/
+	registerMany(tools) {
+		for (const tool of tools) this.register(tool);
+	}
+	/**
+	* Get a tool by ID.
+	*/
+	get(id) {
+		return this.tools.get(id);
+	}
+	/**
+	* Get all registered tool definitions.
+	*/
+	getAll() {
+		return Array.from(this.tools.values());
+	}
+	/**
+	* Get tool count.
+	*/
+	get size() {
+		return this.tools.size;
+	}
+	/**
+	* Convert all registered tools to AgentToolDefinition format.
+	* This is what the existing OpenAI/Anthropic adapters expect.
+	*/
+	getToolDefinitions() {
+		return Array.from(this.tools.values()).map((tool) => ({
+			id: tool.id,
+			name: tool.name,
+			description: tool.description,
+			inputSchema: this.zodToJsonSchema(tool.parameters),
+			category: "utility"
+		}));
+	}
+	/**
+	* Execute a tool by name with the given input.
+	* Handles Zod validation and error wrapping.
+	*/
+	async executeTool(toolName, rawInput, ctx) {
+		const tool = this.tools.get(toolName);
+		if (!tool) return {
+			success: false,
+			error: `Unknown tool: "${toolName}". Available tools: ${Array.from(this.tools.keys()).join(", ")}`,
+			errorType: "UnknownToolError"
+		};
+		const parsed = tool.parameters.safeParse(rawInput);
+		if (!parsed.success) return {
+			success: false,
+			error: `Invalid parameters for "${toolName}": ${parsed.error?.message ?? "Validation failed"}`,
+			errorType: "ValidationError"
+		};
+		try {
+			return await tool.execute(parsed.data, ctx);
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			const errorType = error instanceof Error ? error.constructor.name : "UnknownError";
+			this.logger.error(`Chat tool "${toolName}" execution failed:`, { error: errorMessage });
+			return {
+				success: false,
+				error: errorMessage,
+				errorType
+			};
+		}
+	}
+	/**
+	* Register built-in tools.
+	*/
+	registerBuiltinTools() {
+		this.registerMany(allChatTools);
+		this.logger.debug(`ChatToolkit initialized with ${this.tools.size} tools`);
+	}
+	/**
+	* Convert a Zod schema to JSON Schema for the LLM tool definitions.
+	* Uses Zod v4's built-in JSON Schema support.
+	*/
+	zodToJsonSchema(schema) {
+		try {
+			return z.toJSONSchema(schema);
+		} catch {
+			return {
+				type: "object",
+				properties: {}
+			};
+		}
+	}
+};
+//#endregion
+export { ChatToolkit };
+
+//# sourceMappingURL=chat-toolkit.js.map

package/dist/services/chat/chat-toolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-toolkit.js","names":[],"sources":["../../../src/services/chat/chat-toolkit.ts"],"sourcesContent":["/**\n * Chat Toolkit\n *\n * Registry of all chat tools available to the AI assistant.\n * Handles tool registration, parameter validation (Zod), and execution dispatch.\n *\n * Phase 1: Ships with zero tools — the LLM can only have text conversations.\n * Phase 2+: Tools are added in groups (flow, node, run, action, credential, trigger).\n */\n\nimport { z } from 'zod/v4';\nimport type { AgentToolDefinition } from 'src/types/agent-tool.types';\nimport type { Logger } from 'src/types/schemas';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from './chat-types';\nimport { allChatTools } from './tools';\n\n/**\n * ChatToolkit manages the set of tools available to the chat assistant.\n *\n * Tools are plain objects with Zod schemas and execute functions.\n * The toolkit converts them to AgentToolDefinition format for the LLM adapters.\n */\nexport class ChatToolkit {\n  private tools = new Map<string, ChatToolDefinition>();\n\n  constructor(private readonly logger: Logger) {\n    this.registerBuiltinTools();\n  }\n\n  // =====================================\n  // REGISTRATION\n  // =====================================\n\n  /**\n   * Register a single chat tool.\n   */\n  register(tool: ChatToolDefinition): void {\n    if (this.tools.has(tool.id)) {\n      this.logger.warn(`Chat tool \"${tool.id}\" already registered, overwriting`);\n    }\n    this.tools.set(tool.id, tool);\n  }\n\n  /**\n   * Register multiple chat tools.\n   */\n  registerMany(tools: ChatToolDefinition[]): void {\n    for (const tool of tools) {\n      this.register(tool);\n    }\n  }\n\n  // =====================================\n  // TOOL LOOKUP\n  // =====================================\n\n  /**\n   * Get a tool by ID.\n   */\n  get(id: string): ChatToolDefinition | undefined {\n    return this.tools.get(id);\n  }\n\n  /**\n   * Get all registered tool definitions.\n   */\n  getAll(): ChatToolDefinition[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Get tool count.\n   */\n  get size(): number {\n    return this.tools.size;\n  }\n\n  // =====================================\n  // LLM TOOL FORMAT CONVERSION\n  // =====================================\n\n  /**\n   * Convert all registered tools to AgentToolDefinition format.\n   * This is what the existing OpenAI/Anthropic adapters expect.\n   */\n  getToolDefinitions(): AgentToolDefinition[] {\n    return Array.from(this.tools.values()).map((tool) => ({\n      id: tool.id,\n      name: tool.name,\n      description: tool.description,\n      inputSchema: this.zodToJsonSchema(tool.parameters),\n      category: 'utility' as const,\n    }));\n  }\n\n  // =====================================\n  // EXECUTION\n  // =====================================\n\n  /**\n   * Execute a tool by name with the given input.\n   * Handles Zod validation and error wrapping.\n   */\n  async executeTool(\n    toolName: string,\n    rawInput: unknown,\n    ctx: ChatToolContext,\n  ): Promise<ChatToolResult> {\n    const tool = this.tools.get(toolName);\n    if (!tool) {\n      return {\n        success: false,\n        error: `Unknown tool: \"${toolName}\". Available tools: ${Array.from(this.tools.keys()).join(', ')}`,\n        errorType: 'UnknownToolError',\n      };\n    }\n\n    // Validate parameters with Zod\n    const parsed = tool.parameters.safeParse(rawInput);\n    if (!parsed.success) {\n      return {\n        success: false,\n        error: `Invalid parameters for \"${toolName}\": ${parsed.error?.message ?? 'Validation failed'}`,\n        errorType: 'ValidationError',\n      };\n    }\n\n    // Execute with error wrapping\n    try {\n      return await tool.execute(parsed.data, ctx);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      const errorType = error instanceof Error ? error.constructor.name : 'UnknownError';\n\n      this.logger.error(`Chat tool \"${toolName}\" execution failed:`, { error: errorMessage });\n\n      return {\n        success: false,\n        error: errorMessage,\n        errorType,\n      };\n    }\n  }\n\n  // =====================================\n  // PRIVATE\n  // =====================================\n\n  /**\n   * Register built-in tools.\n   */\n  private registerBuiltinTools(): void {\n    this.registerMany(allChatTools);\n    this.logger.debug(`ChatToolkit initialized with ${this.tools.size} tools`);\n  }\n\n  /**\n   * Convert a Zod schema to JSON Schema for the LLM tool definitions.\n   * Uses Zod v4's built-in JSON Schema support.\n   */\n  private zodToJsonSchema(schema: z.ZodType): Record<string, unknown> {\n    try {\n      return z.toJSONSchema(schema) as Record<string, unknown>;\n    } catch {\n      // Fallback for schemas that can't be converted\n      return { type: 'object', properties: {} };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsBA,IAAa,cAAb,MAAyB;CACvB,wBAAgB,IAAI,KAAiC;CAErD,YAAY,QAAiC;AAAhB,OAAA,SAAA;AAC3B,OAAK,sBAAsB;;;;;CAU7B,SAAS,MAAgC;AACvC,MAAI,KAAK,MAAM,IAAI,KAAK,GAAG,CACzB,MAAK,OAAO,KAAK,cAAc,KAAK,GAAG,mCAAmC;AAE5E,OAAK,MAAM,IAAI,KAAK,IAAI,KAAK;;;;;CAM/B,aAAa,OAAmC;AAC9C,OAAK,MAAM,QAAQ,MACjB,MAAK,SAAS,KAAK;;;;;CAWvB,IAAI,IAA4C;AAC9C,SAAO,KAAK,MAAM,IAAI,GAAG;;;;;CAM3B,SAA+B;AAC7B,SAAO,MAAM,KAAK,KAAK,MAAM,QAAQ,CAAC;;;;;CAMxC,IAAI,OAAe;AACjB,SAAO,KAAK,MAAM;;;;;;CAWpB,qBAA4C;AAC1C,SAAO,MAAM,KAAK,KAAK,MAAM,QAAQ,CAAC,CAAC,KAAK,UAAU;GACpD,IAAI,KAAK;GACT,MAAM,KAAK;GACX,aAAa,KAAK;GAClB,aAAa,KAAK,gBAAgB,KAAK,WAAW;GAClD,UAAU;GACX,EAAE;;;;;;CAWL,MAAM,YACJ,UACA,UACA,KACyB;EACzB,MAAM,OAAO,KAAK,MAAM,IAAI,SAAS;AACrC,MAAI,CAAC,KACH,QAAO;GACL,SAAS;GACT,OAAO,kBAAkB,SAAS,sBAAsB,MAAM,KAAK,KAAK,MAAM,MAAM,CAAC,CAAC,KAAK,KAAK;GAChG,WAAW;GACZ;EAIH,MAAM,SAAS,KAAK,WAAW,UAAU,SAAS;AAClD,MAAI,CAAC,OAAO,QACV,QAAO;GACL,SAAS;GACT,OAAO,2BAA2B,SAAS,KAAK,OAAO,OAAO,WAAW;GACzE,WAAW;GACZ;AAIH,MAAI;AACF,UAAO,MAAM,KAAK,QAAQ,OAAO,MAAM,IAAI;WACpC,OAAgB;GACvB,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC3E,MAAM,YAAY,iBAAiB,QAAQ,MAAM,YAAY,OAAO;AAEpE,QAAK,OAAO,MAAM,cAAc,SAAS,sBAAsB,EAAE,OAAO,cAAc,CAAC;AAEvF,UAAO;IACL,SAAS;IACT,OAAO;IACP;IACD;;;;;;CAWL,uBAAqC;AACnC,OAAK,aAAa,aAAa;AAC/B,OAAK,OAAO,MAAM,gCAAgC,KAAK,MAAM,KAAK,QAAQ;;;;;;CAO5E,gBAAwB,QAA4C;AAClE,MAAI;AACF,UAAO,EAAE,aAAa,OAAO;UACvB;AAEN,UAAO;IAAE,MAAM;IAAU,YAAY,EAAE;IAAE"}

package/dist/services/chat/chat-types.cjs

@@ -0,0 +1,24 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/services/chat/chat-types.ts
+/**
+* Chat Assistant Types
+*
+* Type definitions for the AI chat assistant feature.
+* These types define the streaming protocol, tool interface,
+* and context objects used across the chat system.
+*/
+/**
+* Zod schema for chat configuration in InvectConfig.
+*/
+const ChatConfigSchema = zod_v4.z.object({
+	credentialId: zod_v4.z.string().optional(),
+	defaultModel: zod_v4.z.string().optional(),
+	maxSteps: zod_v4.z.number().min(1).max(50).default(15),
+	maxHistoryMessages: zod_v4.z.number().min(1).max(100).default(20),
+	enabled: zod_v4.z.boolean().default(true)
+});
+//#endregion
+exports.ChatConfigSchema = ChatConfigSchema;
+
+//# sourceMappingURL=chat-types.cjs.map

package/dist/services/chat/chat-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-types.cjs","names":["z"],"sources":["../../../src/services/chat/chat-types.ts"],"sourcesContent":["/**\n * Chat Assistant Types\n *\n * Type definitions for the AI chat assistant feature.\n * These types define the streaming protocol, tool interface,\n * and context objects used across the chat system.\n */\n\nimport { z } from 'zod/v4';\nimport type { InvectIdentity } from 'src/types/auth.types';\n\n// =====================================\n// CHAT MESSAGES\n// =====================================\n\n/**\n * A message in the chat conversation.\n * Compatible with both Anthropic and OpenAI message formats\n * after conversion via the existing adapter layer.\n */\nexport interface ChatMessage {\n  role: 'user' | 'assistant' | 'system' | 'tool';\n  content: string;\n  /** Tool calls made by the assistant */\n  toolCalls?: ChatToolCall[];\n  /** For tool result messages — references which tool call this is a result for */\n  toolCallId?: string;\n}\n\n/**\n * A tool call from the LLM response\n */\nexport interface ChatToolCall {\n  id: string;\n  name: string;\n  input: Record<string, unknown>;\n}\n\n// =====================================\n// CHAT CONTEXT (sent by frontend)\n// =====================================\n\n/**\n * Context sent with each chat request.\n * The backend loads full flow data from the database — only IDs are needed.\n */\nexport interface ChatContext {\n  /** Currently open flow ID (null/undefined if on home page) */\n  flowId?: string;\n  /** Currently selected node ID */\n  selectedNodeId?: string;\n  /** Current editor view mode */\n  viewMode?: 'edit' | 'runs';\n  /** Credential ID to use for the chat model (user override) */\n  credentialId?: string;\n  /** Per-request override for max tool-calling steps (1–50) */\n  maxSteps?: number;\n}\n\n// =====================================\n// CHAT TOOL INTERFACE\n// =====================================\n\n/**\n * Result returned by a chat tool execution\n */\nexport interface ChatToolResult {\n  success: boolean;\n  data?: unknown;\n  error?: string;\n  errorType?: string;\n  suggestion?: string;\n  /** Optional UI action to trigger on the frontend */\n  uiAction?: { action: string; data: Record<string, unknown> };\n}\n\n/**\n * Context provided to chat tool execute functions\n */\nexport interface ChatToolContext {\n  /** The Invect core instance for accessing all services */\n  invect: unknown; // Typed as unknown to avoid circular import; cast in tools\n  /** The requesting user's identity (for RBAC) */\n  identity?: InvectIdentity;\n  /** Chat context from the frontend */\n  chatContext: ChatContext;\n}\n\n/**\n * A single chat tool definition.\n * Tools have Zod schemas for parameter validation and an execute function.\n */\nexport interface ChatToolDefinition {\n  /** Unique tool ID (snake_case) */\n  id: string;\n  /** Human-readable name */\n  name: string;\n  /** Description for the LLM to understand when/how to use this tool */\n  description: string;\n  /** Zod schema for parameter validation */\n  parameters: z.ZodType;\n  /** Execute the tool */\n  execute: (params: unknown, ctx: ChatToolContext) => Promise<ChatToolResult>;\n}\n\n// =====================================\n// CHAT STREAM EVENTS (yielded by core, serialized to SSE by framework adapters)\n// =====================================\n\n/**\n * Events yielded by the ChatStreamSession async generator.\n * Framework adapters (Express, NestJS, Next.js) serialize these to SSE.\n */\nexport type ChatStreamEvent =\n  | { type: 'text_delta'; text: string }\n  | { type: 'tool_call_start'; toolName: string; toolCallId: string; args: Record<string, unknown> }\n  | { type: 'tool_call_result'; toolName: string; toolCallId: string; result: ChatToolResult }\n  | { type: 'ui_action'; action: string; data: Record<string, unknown> }\n  | { type: 'error'; message: string; recoverable: boolean }\n  | { type: 'done'; usage?: ChatUsage };\n\n/**\n * Token usage information\n */\nexport interface ChatUsage {\n  promptTokens?: number;\n  completionTokens?: number;\n  totalTokens?: number;\n}\n\n// =====================================\n// CHAT CONFIG\n// =====================================\n\n/**\n * Zod schema for chat configuration in InvectConfig.\n */\nexport const ChatConfigSchema = z.object({\n  /** Credential ID for the default chat model (from credentials table) */\n  credentialId: z.string().optional(),\n  /** Default model identifier (e.g. \"claude-3-5-haiku-20241022\", \"gpt-4o-mini\") */\n  defaultModel: z.string().optional(),\n  /** Max tool-calling steps per message (default: 15) */\n  maxSteps: z.number().min(1).max(50).default(15),\n  /** Max message history to send to LLM (default: 20) */\n  maxHistoryMessages: z.number().min(1).max(100).default(20),\n  /** Whether chat is enabled (default: true) */\n  enabled: z.boolean().default(true),\n});\n\nexport type ChatConfig = z.infer<typeof ChatConfigSchema>;\n\n/**\n * Resolved chat config with all defaults applied, plus runtime-resolved fields.\n */\nexport interface ResolvedChatConfig {\n  credentialId?: string;\n  model: string;\n  maxSteps: number;\n  maxHistoryMessages: number;\n  enabled: boolean;\n  /** Resolved provider type (determined from credential) */\n  provider: 'OPENAI' | 'ANTHROPIC' | 'OPENROUTER';\n  /** Decrypted API key (resolved from credential) */\n  apiKey: string;\n}\n"],"mappings":";;;;;;;;;;;;;AAyIA,MAAa,mBAAmBA,OAAAA,EAAE,OAAO;CAEvC,cAAcA,OAAAA,EAAE,QAAQ,CAAC,UAAU;CAEnC,cAAcA,OAAAA,EAAE,QAAQ,CAAC,UAAU;CAEnC,UAAUA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,GAAG;CAE/C,oBAAoBA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG;CAE1D,SAASA,OAAAA,EAAE,SAAS,CAAC,QAAQ,KAAK;CACnC,CAAC"}

package/dist/services/chat/chat-types.d.cts

@@ -0,0 +1,134 @@
+import { InvectIdentity } from "../../types/auth.types.cjs";
+import { z } from "zod/v4";
+
+//#region src/services/chat/chat-types.d.ts
+/**
+ * A message in the chat conversation.
+ * Compatible with both Anthropic and OpenAI message formats
+ * after conversion via the existing adapter layer.
+ */
+interface ChatMessage {
+  role: 'user' | 'assistant' | 'system' | 'tool';
+  content: string;
+  /** Tool calls made by the assistant */
+  toolCalls?: ChatToolCall[];
+  /** For tool result messages — references which tool call this is a result for */
+  toolCallId?: string;
+}
+/**
+ * A tool call from the LLM response
+ */
+interface ChatToolCall {
+  id: string;
+  name: string;
+  input: Record<string, unknown>;
+}
+/**
+ * Context sent with each chat request.
+ * The backend loads full flow data from the database — only IDs are needed.
+ */
+interface ChatContext {
+  /** Currently open flow ID (null/undefined if on home page) */
+  flowId?: string;
+  /** Currently selected node ID */
+  selectedNodeId?: string;
+  /** Current editor view mode */
+  viewMode?: 'edit' | 'runs';
+  /** Credential ID to use for the chat model (user override) */
+  credentialId?: string;
+  /** Per-request override for max tool-calling steps (1–50) */
+  maxSteps?: number;
+}
+/**
+ * Result returned by a chat tool execution
+ */
+interface ChatToolResult {
+  success: boolean;
+  data?: unknown;
+  error?: string;
+  errorType?: string;
+  suggestion?: string;
+  /** Optional UI action to trigger on the frontend */
+  uiAction?: {
+    action: string;
+    data: Record<string, unknown>;
+  };
+}
+/**
+ * Context provided to chat tool execute functions
+ */
+interface ChatToolContext {
+  /** The Invect core instance for accessing all services */
+  invect: unknown;
+  /** The requesting user's identity (for RBAC) */
+  identity?: InvectIdentity;
+  /** Chat context from the frontend */
+  chatContext: ChatContext;
+}
+/**
+ * A single chat tool definition.
+ * Tools have Zod schemas for parameter validation and an execute function.
+ */
+interface ChatToolDefinition {
+  /** Unique tool ID (snake_case) */
+  id: string;
+  /** Human-readable name */
+  name: string;
+  /** Description for the LLM to understand when/how to use this tool */
+  description: string;
+  /** Zod schema for parameter validation */
+  parameters: z.ZodType;
+  /** Execute the tool */
+  execute: (params: unknown, ctx: ChatToolContext) => Promise<ChatToolResult>;
+}
+/**
+ * Events yielded by the ChatStreamSession async generator.
+ * Framework adapters (Express, NestJS, Next.js) serialize these to SSE.
+ */
+type ChatStreamEvent = {
+  type: 'text_delta';
+  text: string;
+} | {
+  type: 'tool_call_start';
+  toolName: string;
+  toolCallId: string;
+  args: Record<string, unknown>;
+} | {
+  type: 'tool_call_result';
+  toolName: string;
+  toolCallId: string;
+  result: ChatToolResult;
+} | {
+  type: 'ui_action';
+  action: string;
+  data: Record<string, unknown>;
+} | {
+  type: 'error';
+  message: string;
+  recoverable: boolean;
+} | {
+  type: 'done';
+  usage?: ChatUsage;
+};
+/**
+ * Token usage information
+ */
+interface ChatUsage {
+  promptTokens?: number;
+  completionTokens?: number;
+  totalTokens?: number;
+}
+/**
+ * Zod schema for chat configuration in InvectConfig.
+ */
+declare const ChatConfigSchema: z.ZodObject<{
+  credentialId: z.ZodOptional<z.ZodString>;
+  defaultModel: z.ZodOptional<z.ZodString>;
+  maxSteps: z.ZodDefault<z.ZodNumber>;
+  maxHistoryMessages: z.ZodDefault<z.ZodNumber>;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type ChatConfig = z.infer<typeof ChatConfigSchema>;
+//#endregion
+export { ChatConfig, ChatConfigSchema, ChatContext, ChatMessage, ChatStreamEvent, ChatToolCall, ChatToolContext, ChatToolDefinition, ChatToolResult, ChatUsage };
+//# sourceMappingURL=chat-types.d.cts.map

package/dist/services/chat/chat-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-types.d.cts","names":[],"sources":["../../../src/services/chat/chat-types.ts"],"mappings":";;;;;;;;;UAoBiB,WAAA;EACf,IAAA;EACA,OAAA;;EAEA,SAAA,GAAY,YAAA;EASZ;EAPA,UAAA;AAAA;;;;UAMe,YAAA;EACf,EAAA;EACA,IAAA;EACA,KAAA,EAAO,MAAA;AAAA;;;;;UAWQ,WAAA;EAUP;EARR,MAAA;EAkB6B;EAhB7B,cAAA;EAuByC;EArBzC,QAAA;EAgBA;EAdA,YAAA;EAgBA;EAdA,QAAA;AAAA;;;;UAUe,cAAA;EACf,OAAA;EACA,IAAA;EACA,KAAA;EACA,SAAA;EACA,UAAA;EAUA;EARA,QAAA;IAAa,MAAA;IAAgB,IAAA,EAAM,MAAA;EAAA;AAAA;;AAmBrC;;UAbiB,eAAA;EAqBD;EAnBd,MAAA;EAqB4D;EAnB5D,QAAA,GAAW,cAAA;EAmBgD;EAjB3D,WAAA,EAAa,WAAA;AAAA;;;;;UAOE,kBAAA;EAUf;EARA,EAAA;EAQgC;EANhC,IAAA;EAMoD;EAJpD,WAAA;EAI0E;EAF1E,UAAA,EAAY,CAAA,CAAE,OAAA;EAaJ;EAXV,OAAA,GAAU,MAAA,WAAiB,GAAA,EAAK,eAAA,KAAoB,OAAA,CAAQ,cAAA;AAAA;;;;;KAWlD,eAAA;EACN,IAAA;EAAoB,IAAA;AAAA;EACpB,IAAA;EAAyB,QAAA;EAAkB,UAAA;EAAoB,IAAA,EAAM,MAAA;AAAA;EACrE,IAAA;EAA0B,QAAA;EAAkB,UAAA;EAAoB,MAAA,EAAQ,cAAA;AAAA;EACxE,IAAA;EAAmB,MAAA;EAAgB,IAAA,EAAM,MAAA;AAAA;EACzC,IAAA;EAAe,OAAA;EAAiB,WAAA;AAAA;EAChC,IAAA;EAAc,KAAA,GAAQ,SAAA;AAAA;;AAK5B;;UAAiB,SAAA;EACf,YAAA;EACA,gBAAA;EACA,WAAA;AAAA;;;AAUF;cAAa,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;;;;KAajB,UAAA,GAAa,CAAA,CAAE,KAAA,QAAa,gBAAA"}