@invect/core 0.0.1

package/dist/services/chat/chat-stream.service.cjs

@@ -0,0 +1,205 @@
+const require_ai_types = require("../ai/ai-types.cjs");
+const require_openai_adapter = require("../ai/openai-adapter.cjs");
+const require_anthropic_adapter = require("../ai/anthropic-adapter.cjs");
+const require_openrouter_adapter = require("../ai/openrouter-adapter.cjs");
+const require_provider_detection = require("../../utils/provider-detection.cjs");
+const require_chat_types = require("./chat-types.cjs");
+const require_chat_toolkit = require("./chat-toolkit.cjs");
+const require_chat_stream_session = require("./chat-stream-session.cjs");
+//#region src/services/chat/chat-stream.service.ts
+/**
+* Chat Stream Service — manages chat sessions and dependencies.
+*/
+var ChatStreamService = class {
+	toolkit;
+	chatConfig;
+	constructor(logger, config, credentialsService, flowsService, flowVersionsService, actionRegistry, invect) {
+		this.logger = logger;
+		this.config = config;
+		this.credentialsService = credentialsService;
+		this.flowsService = flowsService;
+		this.flowVersionsService = flowVersionsService;
+		this.actionRegistry = actionRegistry;
+		this.invect = invect;
+		this.chatConfig = require_chat_types.ChatConfigSchema.parse(this.config.chat ?? {});
+		this.toolkit = new require_chat_toolkit.ChatToolkit(logger);
+		logger.info(`ChatStreamService initialized (enabled: ${this.chatConfig.enabled}, tools: ${this.toolkit.size})`);
+	}
+	/**
+	* Create a streaming chat session.
+	*
+	* Returns an AsyncGenerator that yields ChatStreamEvents.
+	* Framework adapters (Express, NestJS, Next.js) consume this
+	* and serialize events to SSE.
+	*/
+	async createStream(options) {
+		if (!this.chatConfig.enabled) return this.errorStream("Chat assistant is disabled in configuration");
+		const { messages, context, identity } = options;
+		let resolvedConfig;
+		try {
+			resolvedConfig = await this.resolveConfig(context.credentialId);
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			return this.errorStream(`Failed to resolve chat credentials: ${msg}`);
+		}
+		const adapter = this.createAdapter(resolvedConfig);
+		let flowContext = null;
+		if (context.flowId) try {
+			flowContext = await this.loadFlowContext(context.flowId, context.selectedNodeId, context.viewMode);
+		} catch (error) {
+			this.logger.warn("Failed to load flow context for chat:", { error });
+		}
+		if (context.maxSteps && context.maxSteps >= 1 && context.maxSteps <= 50) resolvedConfig = {
+			...resolvedConfig,
+			maxSteps: context.maxSteps
+		};
+		return new require_chat_stream_session.ChatStreamSession({
+			logger: this.logger,
+			toolkit: this.toolkit,
+			config: resolvedConfig,
+			adapter,
+			identity,
+			invect: this.invect,
+			actionRegistry: this.actionRegistry
+		}).stream(messages, context, flowContext);
+	}
+	/**
+	* Check if the chat feature is enabled and properly configured.
+	*/
+	isEnabled() {
+		return this.chatConfig.enabled;
+	}
+	/**
+	* Get the toolkit for external registration of tools.
+	*/
+	getToolkit() {
+		return this.toolkit;
+	}
+	/**
+	* Resolve chat model configuration.
+	*
+	* Resolution order:
+	* 1. Per-request credentialId (from frontend)
+	* 2. chatConfig.credentialId (from InvectConfig)
+	*/
+	async resolveConfig(perRequestCredentialId) {
+		const base = {
+			maxSteps: this.chatConfig.maxSteps,
+			maxHistoryMessages: this.chatConfig.maxHistoryMessages,
+			enabled: this.chatConfig.enabled
+		};
+		if (perRequestCredentialId) return this.resolveFromCredential(perRequestCredentialId, base);
+		if (this.chatConfig.credentialId) return this.resolveFromCredential(this.chatConfig.credentialId, base);
+		throw new Error("No chat credential configured. Select a credential in the chat settings, or set chat.credentialId in the server config.");
+	}
+	/**
+	* Resolve config from a credential in the credentials table.
+	*/
+	async resolveFromCredential(credentialId, base) {
+		const credential = await this.credentialsService.getDecryptedWithRefresh(credentialId);
+		const provider = require_provider_detection.detectProviderFromCredential(credential);
+		if (!provider) throw new Error(`Cannot determine AI provider from credential "${credentialId}". Set "provider" in credential metadata (OPENAI, ANTHROPIC, or OPENROUTER).`);
+		const apiKey = credential.config?.apiKey;
+		if (!apiKey) throw new Error(`Credential "${credentialId}" has no apiKey in config.`);
+		const model = this.chatConfig.defaultModel ?? this.getDefaultModel(provider);
+		const providerMap = {
+			[require_ai_types.BatchProvider.OPENAI]: "OPENAI",
+			[require_ai_types.BatchProvider.ANTHROPIC]: "ANTHROPIC",
+			[require_ai_types.BatchProvider.OPENROUTER]: "OPENROUTER"
+		};
+		return {
+			...base,
+			credentialId,
+			model,
+			provider: providerMap[provider] ?? "OPENAI",
+			apiKey,
+			maxSteps: base.maxSteps ?? 15,
+			maxHistoryMessages: base.maxHistoryMessages ?? 20,
+			enabled: base.enabled ?? true
+		};
+	}
+	/**
+	* Get the default model for a provider (cheap models for chat).
+	*/
+	getDefaultModel(provider) {
+		switch (provider) {
+			case require_ai_types.BatchProvider.ANTHROPIC: return "claude-sonnet-4-20250514";
+			case require_ai_types.BatchProvider.OPENAI: return "gpt-4o-mini";
+			case require_ai_types.BatchProvider.OPENROUTER: return "anthropic/claude-sonnet-4-20250514";
+			default: return "gpt-4o-mini";
+		}
+	}
+	/**
+	* Create an ephemeral ProviderAdapter for a chat request.
+	* Uses the resolved config to instantiate the correct adapter.
+	*/
+	createAdapter(config) {
+		switch (config.provider) {
+			case "OPENAI": return new require_openai_adapter.OpenAIAdapter(this.logger, config.apiKey);
+			case "ANTHROPIC": return new require_anthropic_adapter.AnthropicAdapter(this.logger, config.apiKey);
+			case "OPENROUTER": return new require_openrouter_adapter.OpenRouterAdapter(this.logger, config.apiKey);
+			default: throw new Error(`Unsupported chat provider: ${config.provider}`);
+		}
+	}
+	/**
+	* Load flow context from the database for the system prompt.
+	*/
+	async loadFlowContext(flowId, selectedNodeId, viewMode) {
+		try {
+			const flow = await this.flowsService.getFlowById(flowId);
+			if (!flow) return null;
+			const latestVersion = await this.flowVersionsService.getFlowVersion(flowId, "latest");
+			if (!latestVersion) return {
+				flowId: flow.id,
+				flowName: flow.name,
+				flowDescription: flow.description ?? void 0,
+				nodes: [],
+				edges: [],
+				selectedNodeId,
+				viewMode
+			};
+			const definition = typeof latestVersion.invectDefinition === "string" ? JSON.parse(latestVersion.invectDefinition) : latestVersion.invectDefinition;
+			const nodes = (definition?.nodes ?? []).map((n) => ({
+				id: n.id,
+				type: n.type,
+				label: n.label || n.data?.label || "Unnamed",
+				referenceId: n.referenceId || n.data?.referenceId,
+				paramKeys: n.params ? Object.keys(n.params) : n.data?.params ? Object.keys(n.data.params) : void 0
+			}));
+			const edges = (definition?.edges ?? []).map((e) => ({
+				sourceId: e.source ?? e.sourceId ?? "",
+				targetId: e.target ?? e.targetId ?? ""
+			}));
+			return {
+				flowId: flow.id,
+				flowName: flow.name,
+				flowDescription: flow.description ?? void 0,
+				nodes,
+				edges,
+				selectedNodeId,
+				viewMode
+			};
+		} catch (error) {
+			this.logger.warn("Error loading flow context:", {
+				error,
+				flowId
+			});
+			return null;
+		}
+	}
+	/**
+	* Create a one-shot error stream.
+	*/
+	async *errorStream(message) {
+		yield {
+			type: "error",
+			message,
+			recoverable: false
+		};
+		yield { type: "done" };
+	}
+};
+//#endregion
+exports.ChatStreamService = ChatStreamService;
+
+//# sourceMappingURL=chat-stream.service.cjs.map

package/dist/services/chat/chat-stream.service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-stream.service.cjs","names":["ChatConfigSchema","ChatToolkit","ChatStreamSession","detectProviderFromCredential","BatchProvider","OpenAIAdapter","AnthropicAdapter","OpenRouterAdapter"],"sources":["../../../src/services/chat/chat-stream.service.ts"],"sourcesContent":["/**\n * Chat Stream Service\n *\n * The main entry point for the chat assistant feature.\n * Responsibilities:\n * - Resolve credential → determine provider (Anthropic/OpenAI) and API key\n * - Create ephemeral ProviderAdapter instances for chat requests\n * - Load flow context from the database\n * - Create ChatStreamSession instances\n *\n * Lifecycle: Singleton created during ServiceFactory.initialize().\n */\n\nimport type { Logger } from 'src/types/schemas';\nimport type { InvectConfig } from 'src/types/schemas';\nimport type { InvectIdentity } from 'src/types/auth.types';\nimport type { ActionRegistry } from 'src/actions';\nimport type { ProviderAdapter } from '../ai/provider-adapter';\nimport type {\n  ChatMessage,\n  ChatContext,\n  ChatConfig,\n  ChatStreamEvent,\n  ResolvedChatConfig,\n} from './chat-types';\nimport type { FlowContextData } from './system-prompt';\nimport { ChatConfigSchema } from './chat-types';\nimport { ChatToolkit } from './chat-toolkit';\nimport { ChatStreamSession } from './chat-stream-session';\nimport { OpenAIAdapter } from '../ai/openai-adapter';\nimport { AnthropicAdapter } from '../ai/anthropic-adapter';\nimport { OpenRouterAdapter } from '../ai/openrouter-adapter';\nimport { BatchProvider } from '../ai/ai-types';\nimport { detectProviderFromCredential } from 'src/utils/provider-detection';\nimport type { CredentialsService } from '../credentials/credentials.service';\nimport type { FlowsService } from '../flows/flows.service';\nimport type { FlowVersionsService } from '../flow-versions/flow-versions.service';\n\n/**\n * Options for creating a chat stream.\n */\nexport interface CreateChatStreamOptions {\n  messages: ChatMessage[];\n  context: ChatContext;\n  identity?: InvectIdentity;\n}\n\n/**\n * Chat Stream Service — manages chat sessions and dependencies.\n */\nexport class ChatStreamService {\n  private toolkit: ChatToolkit;\n  private chatConfig: ChatConfig;\n\n  constructor(\n    private readonly logger: Logger,\n    private readonly config: InvectConfig,\n    private readonly credentialsService: CredentialsService,\n    private readonly flowsService: FlowsService,\n    private readonly flowVersionsService: FlowVersionsService,\n    private readonly actionRegistry: ActionRegistry | null,\n    /** Invect core instance — passed to tools as an opaque handle */\n    private readonly invect: unknown,\n  ) {\n    // Parse and apply defaults to chat config\n    this.chatConfig = ChatConfigSchema.parse(this.config.chat ?? {});\n    this.toolkit = new ChatToolkit(logger);\n\n    logger.info(\n      `ChatStreamService initialized (enabled: ${this.chatConfig.enabled}, tools: ${this.toolkit.size})`,\n    );\n  }\n\n  /**\n   * Create a streaming chat session.\n   *\n   * Returns an AsyncGenerator that yields ChatStreamEvents.\n   * Framework adapters (Express, NestJS, Next.js) consume this\n   * and serialize events to SSE.\n   */\n  async createStream(options: CreateChatStreamOptions): Promise<AsyncGenerator<ChatStreamEvent>> {\n    if (!this.chatConfig.enabled) {\n      return this.errorStream('Chat assistant is disabled in configuration');\n    }\n\n    const { messages, context, identity } = options;\n\n    // 1. Resolve config (credential → provider + apiKey + model)\n    let resolvedConfig: ResolvedChatConfig;\n    try {\n      resolvedConfig = await this.resolveConfig(context.credentialId);\n    } catch (error: unknown) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return this.errorStream(`Failed to resolve chat credentials: ${msg}`);\n    }\n\n    // 2. Create ephemeral adapter for this request\n    const adapter = this.createAdapter(resolvedConfig);\n\n    // 3. Load flow context from database (if flowId provided)\n    let flowContext: FlowContextData | null = null;\n    if (context.flowId) {\n      try {\n        flowContext = await this.loadFlowContext(\n          context.flowId,\n          context.selectedNodeId,\n          context.viewMode,\n        );\n      } catch (error: unknown) {\n        this.logger.warn('Failed to load flow context for chat:', { error });\n        // Continue without flow context — better than failing\n      }\n    }\n\n    // 4. Apply per-request overrides from context\n    if (context.maxSteps && context.maxSteps >= 1 && context.maxSteps <= 50) {\n      resolvedConfig = { ...resolvedConfig, maxSteps: context.maxSteps };\n    }\n\n    // 5. Create and return session stream\n    const session = new ChatStreamSession({\n      logger: this.logger,\n      toolkit: this.toolkit,\n      config: resolvedConfig,\n      adapter,\n      identity,\n      invect: this.invect,\n      actionRegistry: this.actionRegistry,\n    });\n\n    return session.stream(messages, context, flowContext);\n  }\n\n  /**\n   * Check if the chat feature is enabled and properly configured.\n   */\n  isEnabled(): boolean {\n    return this.chatConfig.enabled;\n  }\n\n  /**\n   * Get the toolkit for external registration of tools.\n   */\n  getToolkit(): ChatToolkit {\n    return this.toolkit;\n  }\n\n  // =====================================\n  // CREDENTIAL & CONFIG RESOLUTION\n  // =====================================\n\n  /**\n   * Resolve chat model configuration.\n   *\n   * Resolution order:\n   * 1. Per-request credentialId (from frontend)\n   * 2. chatConfig.credentialId (from InvectConfig)\n   */\n  private async resolveConfig(perRequestCredentialId?: string): Promise<ResolvedChatConfig> {\n    const base: Partial<ResolvedChatConfig> = {\n      maxSteps: this.chatConfig.maxSteps,\n      maxHistoryMessages: this.chatConfig.maxHistoryMessages,\n      enabled: this.chatConfig.enabled,\n    };\n\n    // Try per-request credential\n    if (perRequestCredentialId) {\n      return this.resolveFromCredential(perRequestCredentialId, base);\n    }\n\n    // Try chatConfig credential\n    if (this.chatConfig.credentialId) {\n      return this.resolveFromCredential(this.chatConfig.credentialId, base);\n    }\n\n    throw new Error(\n      'No chat credential configured. Select a credential in the chat settings, ' +\n        'or set chat.credentialId in the server config.',\n    );\n  }\n\n  /**\n   * Resolve config from a credential in the credentials table.\n   */\n  private async resolveFromCredential(\n    credentialId: string,\n    base: Partial<ResolvedChatConfig>,\n  ): Promise<ResolvedChatConfig> {\n    const credential = await this.credentialsService.getDecryptedWithRefresh(credentialId);\n\n    const provider = detectProviderFromCredential(credential);\n    if (!provider) {\n      throw new Error(\n        `Cannot determine AI provider from credential \"${credentialId}\". ` +\n          `Set \"provider\" in credential metadata (OPENAI, ANTHROPIC, or OPENROUTER).`,\n      );\n    }\n\n    const apiKey = (credential.config as Record<string, unknown>)?.apiKey as string;\n    if (!apiKey) {\n      throw new Error(`Credential \"${credentialId}\" has no apiKey in config.`);\n    }\n\n    const model = this.chatConfig.defaultModel ?? this.getDefaultModel(provider);\n\n    const providerMap: Record<string, 'OPENAI' | 'ANTHROPIC' | 'OPENROUTER'> = {\n      [BatchProvider.OPENAI]: 'OPENAI',\n      [BatchProvider.ANTHROPIC]: 'ANTHROPIC',\n      [BatchProvider.OPENROUTER]: 'OPENROUTER',\n    };\n\n    return {\n      ...base,\n      credentialId,\n      model,\n      provider: providerMap[provider] ?? 'OPENAI',\n      apiKey,\n      maxSteps: base.maxSteps ?? 15,\n      maxHistoryMessages: base.maxHistoryMessages ?? 20,\n      enabled: base.enabled ?? true,\n    };\n  }\n\n  /**\n   * Get the default model for a provider (cheap models for chat).\n   */\n  private getDefaultModel(provider: BatchProvider): string {\n    switch (provider) {\n      case BatchProvider.ANTHROPIC:\n        return 'claude-sonnet-4-20250514';\n      case BatchProvider.OPENAI:\n        return 'gpt-4o-mini';\n      case BatchProvider.OPENROUTER:\n        return 'anthropic/claude-sonnet-4-20250514';\n      default:\n        return 'gpt-4o-mini';\n    }\n  }\n\n  // =====================================\n  // ADAPTER CREATION\n  // =====================================\n\n  /**\n   * Create an ephemeral ProviderAdapter for a chat request.\n   * Uses the resolved config to instantiate the correct adapter.\n   */\n  private createAdapter(config: ResolvedChatConfig): ProviderAdapter {\n    switch (config.provider) {\n      case 'OPENAI':\n        return new OpenAIAdapter(this.logger, config.apiKey);\n      case 'ANTHROPIC':\n        return new AnthropicAdapter(this.logger, config.apiKey);\n      case 'OPENROUTER':\n        return new OpenRouterAdapter(this.logger, config.apiKey);\n      default:\n        throw new Error(`Unsupported chat provider: ${config.provider}`);\n    }\n  }\n\n  // =====================================\n  // FLOW CONTEXT LOADING\n  // =====================================\n\n  /**\n   * Load flow context from the database for the system prompt.\n   */\n  private async loadFlowContext(\n    flowId: string,\n    selectedNodeId?: string,\n    viewMode?: string,\n  ): Promise<FlowContextData | null> {\n    try {\n      const flow = await this.flowsService.getFlowById(flowId);\n      if (!flow) {\n        return null;\n      }\n\n      // Get the latest version to read node definitions\n      const latestVersion = await this.flowVersionsService.getFlowVersion(flowId, 'latest');\n      if (!latestVersion) {\n        return {\n          flowId: flow.id,\n          flowName: flow.name,\n          flowDescription: flow.description ?? undefined,\n          nodes: [],\n          edges: [],\n          selectedNodeId,\n          viewMode: viewMode as 'edit' | 'runs' | undefined,\n        };\n      }\n\n      // Parse definition\n      const definition =\n        typeof latestVersion.invectDefinition === 'string'\n          ? JSON.parse(latestVersion.invectDefinition)\n          : latestVersion.invectDefinition;\n\n      interface FlowNode {\n        id: string;\n        type: string;\n        label?: string;\n        referenceId?: string;\n        params?: Record<string, unknown>;\n        data?: { label?: string; referenceId?: string; params?: Record<string, unknown> };\n      }\n      interface FlowEdge {\n        source?: string;\n        sourceId?: string;\n        target?: string;\n        targetId?: string;\n      }\n\n      const nodes = ((definition?.nodes ?? []) as FlowNode[]).map((n) => ({\n        id: n.id,\n        type: n.type,\n        label: n.label || n.data?.label || 'Unnamed',\n        referenceId: n.referenceId || n.data?.referenceId,\n        paramKeys: n.params\n          ? Object.keys(n.params)\n          : n.data?.params\n            ? Object.keys(n.data.params)\n            : undefined,\n      }));\n\n      const edges = ((definition?.edges ?? []) as FlowEdge[]).map((e) => ({\n        sourceId: e.source ?? e.sourceId ?? '',\n        targetId: e.target ?? e.targetId ?? '',\n      }));\n\n      return {\n        flowId: flow.id,\n        flowName: flow.name,\n        flowDescription: flow.description ?? undefined,\n        nodes,\n        edges,\n        selectedNodeId,\n        viewMode: viewMode as 'edit' | 'runs' | undefined,\n      };\n    } catch (error) {\n      this.logger.warn('Error loading flow context:', { error, flowId });\n      return null;\n    }\n  }\n\n  // =====================================\n  // HELPERS\n  // =====================================\n\n  /**\n   * Create a one-shot error stream.\n   */\n  private async *errorStream(message: string): AsyncGenerator<ChatStreamEvent> {\n    yield { type: 'error', message, recoverable: false };\n    yield { type: 'done' };\n  }\n}\n"],"mappings":"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"}

package/dist/services/chat/chat-stream.service.d.cts

@@ -0,0 +1,84 @@
+import { InvectConfig, Logger } from "../../types/schemas-fresh/invect-config.cjs";
+import { CredentialsService } from "../credentials/credentials.service.cjs";
+import { InvectIdentity } from "../../types/auth.types.cjs";
+import { ChatContext, ChatMessage, ChatStreamEvent } from "./chat-types.cjs";
+import { ActionRegistry } from "../../actions/action-registry.cjs";
+import { ChatToolkit } from "./chat-toolkit.cjs";
+import { FlowsService } from "../flows/flows.service.cjs";
+import { FlowVersionsService } from "../flow-versions/flow-versions.service.cjs";
+
+//#region src/services/chat/chat-stream.service.d.ts
+/**
+ * Options for creating a chat stream.
+ */
+interface CreateChatStreamOptions {
+  messages: ChatMessage[];
+  context: ChatContext;
+  identity?: InvectIdentity;
+}
+/**
+ * Chat Stream Service — manages chat sessions and dependencies.
+ */
+declare class ChatStreamService {
+  private readonly logger;
+  private readonly config;
+  private readonly credentialsService;
+  private readonly flowsService;
+  private readonly flowVersionsService;
+  private readonly actionRegistry;
+  /** Invect core instance — passed to tools as an opaque handle */
+  private readonly invect;
+  private toolkit;
+  private chatConfig;
+  constructor(logger: Logger, config: InvectConfig, credentialsService: CredentialsService, flowsService: FlowsService, flowVersionsService: FlowVersionsService, actionRegistry: ActionRegistry | null, /** Invect core instance — passed to tools as an opaque handle */
+
+  invect: unknown);
+  /**
+   * Create a streaming chat session.
+   *
+   * Returns an AsyncGenerator that yields ChatStreamEvents.
+   * Framework adapters (Express, NestJS, Next.js) consume this
+   * and serialize events to SSE.
+   */
+  createStream(options: CreateChatStreamOptions): Promise<AsyncGenerator<ChatStreamEvent>>;
+  /**
+   * Check if the chat feature is enabled and properly configured.
+   */
+  isEnabled(): boolean;
+  /**
+   * Get the toolkit for external registration of tools.
+   */
+  getToolkit(): ChatToolkit;
+  /**
+   * Resolve chat model configuration.
+   *
+   * Resolution order:
+   * 1. Per-request credentialId (from frontend)
+   * 2. chatConfig.credentialId (from InvectConfig)
+   */
+  private resolveConfig;
+  /**
+   * Resolve config from a credential in the credentials table.
+   */
+  private resolveFromCredential;
+  /**
+   * Get the default model for a provider (cheap models for chat).
+   */
+  private getDefaultModel;
+  /**
+   * Create an ephemeral ProviderAdapter for a chat request.
+   * Uses the resolved config to instantiate the correct adapter.
+   */
+  private createAdapter;
+  /**
+   * Load flow context from the database for the system prompt.
+   */
+  private loadFlowContext;
+  /**
+   * Create a one-shot error stream.
+   */
+  private errorStream;
+}
+//#endregion
+export { ChatStreamService, CreateChatStreamOptions };
+//# sourceMappingURL=chat-stream.service.d.cts.map

package/dist/services/chat/chat-stream.service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-stream.service.d.cts","names":[],"sources":["../../../src/services/chat/chat-stream.service.ts"],"mappings":";;;;;;;;;;;;;UAyCiB,uBAAA;EACf,QAAA,EAAU,WAAA;EACV,OAAA,EAAS,WAAA;EACT,QAAA,GAAW,cAAA;AAAA;;;;cAMA,iBAAA;EAAA,iBAKQ,MAAA;EAAA,iBACA,MAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,cAAA;EAoBmC;EAAA,iBAlBnC,MAAA;EAAA,QAXX,OAAA;EAAA,QACA,UAAA;cAGW,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,YAAA,EACR,kBAAA,EAAoB,kBAAA,EACpB,YAAA,EAAc,YAAA,EACd,mBAAA,EAAqB,mBAAA,EACrB,cAAA,EAAgB,cAAA,SAJhB;;EAMA,MAAA;EAJA;;;;;;;EAsBb,YAAA,CAAa,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,cAAA,CAAe,eAAA;EAzB1D;;;EAiFnB,SAAA,CAAA;EA/EmB;;;EAsFnB,UAAA,CAAA,GAAc,WAAA;EApFK;;;;;;;EAAA,QAmGL,aAAA;EA9EgD;;;EAAA,QAwGhD,qBAAA;EAzCA;;;EAAA,QAmFN,eAAA;EAqBA;;;;EAAA,QAAA,aAAA;;;;UAoBM,eAAA;;;;UAqFC,WAAA;AAAA"}

package/dist/services/chat/chat-stream.service.d.ts

@@ -0,0 +1,84 @@
+import { InvectConfig, Logger } from "../../types/schemas-fresh/invect-config.js";
+import { CredentialsService } from "../credentials/credentials.service.js";
+import { InvectIdentity } from "../../types/auth.types.js";
+import { ChatContext, ChatMessage, ChatStreamEvent } from "./chat-types.js";
+import { ActionRegistry } from "../../actions/action-registry.js";
+import { ChatToolkit } from "./chat-toolkit.js";
+import { FlowsService } from "../flows/flows.service.js";
+import { FlowVersionsService } from "../flow-versions/flow-versions.service.js";
+
+//#region src/services/chat/chat-stream.service.d.ts
+/**
+ * Options for creating a chat stream.
+ */
+interface CreateChatStreamOptions {
+  messages: ChatMessage[];
+  context: ChatContext;
+  identity?: InvectIdentity;
+}
+/**
+ * Chat Stream Service — manages chat sessions and dependencies.
+ */
+declare class ChatStreamService {
+  private readonly logger;
+  private readonly config;
+  private readonly credentialsService;
+  private readonly flowsService;
+  private readonly flowVersionsService;
+  private readonly actionRegistry;
+  /** Invect core instance — passed to tools as an opaque handle */
+  private readonly invect;
+  private toolkit;
+  private chatConfig;
+  constructor(logger: Logger, config: InvectConfig, credentialsService: CredentialsService, flowsService: FlowsService, flowVersionsService: FlowVersionsService, actionRegistry: ActionRegistry | null, /** Invect core instance — passed to tools as an opaque handle */
+
+  invect: unknown);
+  /**
+   * Create a streaming chat session.
+   *
+   * Returns an AsyncGenerator that yields ChatStreamEvents.
+   * Framework adapters (Express, NestJS, Next.js) consume this
+   * and serialize events to SSE.
+   */
+  createStream(options: CreateChatStreamOptions): Promise<AsyncGenerator<ChatStreamEvent>>;
+  /**
+   * Check if the chat feature is enabled and properly configured.
+   */
+  isEnabled(): boolean;
+  /**
+   * Get the toolkit for external registration of tools.
+   */
+  getToolkit(): ChatToolkit;
+  /**
+   * Resolve chat model configuration.
+   *
+   * Resolution order:
+   * 1. Per-request credentialId (from frontend)
+   * 2. chatConfig.credentialId (from InvectConfig)
+   */
+  private resolveConfig;
+  /**
+   * Resolve config from a credential in the credentials table.
+   */
+  private resolveFromCredential;
+  /**
+   * Get the default model for a provider (cheap models for chat).
+   */
+  private getDefaultModel;
+  /**
+   * Create an ephemeral ProviderAdapter for a chat request.
+   * Uses the resolved config to instantiate the correct adapter.
+   */
+  private createAdapter;
+  /**
+   * Load flow context from the database for the system prompt.
+   */
+  private loadFlowContext;
+  /**
+   * Create a one-shot error stream.
+   */
+  private errorStream;
+}
+//#endregion
+export { ChatStreamService, CreateChatStreamOptions };
+//# sourceMappingURL=chat-stream.service.d.ts.map

package/dist/services/chat/chat-stream.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-stream.service.d.ts","names":[],"sources":["../../../src/services/chat/chat-stream.service.ts"],"mappings":";;;;;;;;;;;;;UAyCiB,uBAAA;EACf,QAAA,EAAU,WAAA;EACV,OAAA,EAAS,WAAA;EACT,QAAA,GAAW,cAAA;AAAA;;;;cAMA,iBAAA;EAAA,iBAKQ,MAAA;EAAA,iBACA,MAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,cAAA;EAoB2C;EAAA,iBAlB3C,MAAA;EAAA,QAXX,OAAA;EAAA,QACA,UAAA;cAGW,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,YAAA,EACR,kBAAA,EAAoB,kBAAA,EACpB,YAAA,EAAc,YAAA,EACd,mBAAA,EAAqB,mBAAA,EACrB,cAAA,EAAgB,cAAA,SALhB;;EAOA,MAAA;EALA;;;;;;;EAuBb,YAAA,CAAa,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,cAAA,CAAe,eAAA;EAzBlD;;;EAiF3B,SAAA,CAAA;EA/EuC;;;EAsFvC,UAAA,CAAA,GAAc,WAAA;EApF0B;;;;;;;EAAA,QAmG1B,aAAA;EA9EwC;;;EAAA,QAwGxC,qBAAA;EAzCd;;;EAAA,QAmFQ,eAAA;EAAA;;;;EAAA,QAqBA,aAAA;EAyGkB;;;EAAA,QArFZ,eAAA;;;;UAqFC,WAAA;AAAA"}

package/dist/services/chat/chat-stream.service.js

@@ -0,0 +1,205 @@
+import { BatchProvider } from "../ai/ai-types.js";
+import { OpenAIAdapter } from "../ai/openai-adapter.js";
+import { AnthropicAdapter } from "../ai/anthropic-adapter.js";
+import { OpenRouterAdapter } from "../ai/openrouter-adapter.js";
+import { detectProviderFromCredential } from "../../utils/provider-detection.js";
+import { ChatConfigSchema } from "./chat-types.js";
+import { ChatToolkit } from "./chat-toolkit.js";
+import { ChatStreamSession } from "./chat-stream-session.js";
+//#region src/services/chat/chat-stream.service.ts
+/**
+* Chat Stream Service — manages chat sessions and dependencies.
+*/
+var ChatStreamService = class {
+	toolkit;
+	chatConfig;
+	constructor(logger, config, credentialsService, flowsService, flowVersionsService, actionRegistry, invect) {
+		this.logger = logger;
+		this.config = config;
+		this.credentialsService = credentialsService;
+		this.flowsService = flowsService;
+		this.flowVersionsService = flowVersionsService;
+		this.actionRegistry = actionRegistry;
+		this.invect = invect;
+		this.chatConfig = ChatConfigSchema.parse(this.config.chat ?? {});
+		this.toolkit = new ChatToolkit(logger);
+		logger.info(`ChatStreamService initialized (enabled: ${this.chatConfig.enabled}, tools: ${this.toolkit.size})`);
+	}
+	/**
+	* Create a streaming chat session.
+	*
+	* Returns an AsyncGenerator that yields ChatStreamEvents.
+	* Framework adapters (Express, NestJS, Next.js) consume this
+	* and serialize events to SSE.
+	*/
+	async createStream(options) {
+		if (!this.chatConfig.enabled) return this.errorStream("Chat assistant is disabled in configuration");
+		const { messages, context, identity } = options;
+		let resolvedConfig;
+		try {
+			resolvedConfig = await this.resolveConfig(context.credentialId);
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			return this.errorStream(`Failed to resolve chat credentials: ${msg}`);
+		}
+		const adapter = this.createAdapter(resolvedConfig);
+		let flowContext = null;
+		if (context.flowId) try {
+			flowContext = await this.loadFlowContext(context.flowId, context.selectedNodeId, context.viewMode);
+		} catch (error) {
+			this.logger.warn("Failed to load flow context for chat:", { error });
+		}
+		if (context.maxSteps && context.maxSteps >= 1 && context.maxSteps <= 50) resolvedConfig = {
+			...resolvedConfig,
+			maxSteps: context.maxSteps
+		};
+		return new ChatStreamSession({
+			logger: this.logger,
+			toolkit: this.toolkit,
+			config: resolvedConfig,
+			adapter,
+			identity,
+			invect: this.invect,
+			actionRegistry: this.actionRegistry
+		}).stream(messages, context, flowContext);
+	}
+	/**
+	* Check if the chat feature is enabled and properly configured.
+	*/
+	isEnabled() {
+		return this.chatConfig.enabled;
+	}
+	/**
+	* Get the toolkit for external registration of tools.
+	*/
+	getToolkit() {
+		return this.toolkit;
+	}
+	/**
+	* Resolve chat model configuration.
+	*
+	* Resolution order:
+	* 1. Per-request credentialId (from frontend)
+	* 2. chatConfig.credentialId (from InvectConfig)
+	*/
+	async resolveConfig(perRequestCredentialId) {
+		const base = {
+			maxSteps: this.chatConfig.maxSteps,
+			maxHistoryMessages: this.chatConfig.maxHistoryMessages,
+			enabled: this.chatConfig.enabled
+		};
+		if (perRequestCredentialId) return this.resolveFromCredential(perRequestCredentialId, base);
+		if (this.chatConfig.credentialId) return this.resolveFromCredential(this.chatConfig.credentialId, base);
+		throw new Error("No chat credential configured. Select a credential in the chat settings, or set chat.credentialId in the server config.");
+	}
+	/**
+	* Resolve config from a credential in the credentials table.
+	*/
+	async resolveFromCredential(credentialId, base) {
+		const credential = await this.credentialsService.getDecryptedWithRefresh(credentialId);
+		const provider = detectProviderFromCredential(credential);
+		if (!provider) throw new Error(`Cannot determine AI provider from credential "${credentialId}". Set "provider" in credential metadata (OPENAI, ANTHROPIC, or OPENROUTER).`);
+		const apiKey = credential.config?.apiKey;
+		if (!apiKey) throw new Error(`Credential "${credentialId}" has no apiKey in config.`);
+		const model = this.chatConfig.defaultModel ?? this.getDefaultModel(provider);
+		const providerMap = {
+			[BatchProvider.OPENAI]: "OPENAI",
+			[BatchProvider.ANTHROPIC]: "ANTHROPIC",
+			[BatchProvider.OPENROUTER]: "OPENROUTER"
+		};
+		return {
+			...base,
+			credentialId,
+			model,
+			provider: providerMap[provider] ?? "OPENAI",
+			apiKey,
+			maxSteps: base.maxSteps ?? 15,
+			maxHistoryMessages: base.maxHistoryMessages ?? 20,
+			enabled: base.enabled ?? true
+		};
+	}
+	/**
+	* Get the default model for a provider (cheap models for chat).
+	*/
+	getDefaultModel(provider) {
+		switch (provider) {
+			case BatchProvider.ANTHROPIC: return "claude-sonnet-4-20250514";
+			case BatchProvider.OPENAI: return "gpt-4o-mini";
+			case BatchProvider.OPENROUTER: return "anthropic/claude-sonnet-4-20250514";
+			default: return "gpt-4o-mini";
+		}
+	}
+	/**
+	* Create an ephemeral ProviderAdapter for a chat request.
+	* Uses the resolved config to instantiate the correct adapter.
+	*/
+	createAdapter(config) {
+		switch (config.provider) {
+			case "OPENAI": return new OpenAIAdapter(this.logger, config.apiKey);
+			case "ANTHROPIC": return new AnthropicAdapter(this.logger, config.apiKey);
+			case "OPENROUTER": return new OpenRouterAdapter(this.logger, config.apiKey);
+			default: throw new Error(`Unsupported chat provider: ${config.provider}`);
+		}
+	}
+	/**
+	* Load flow context from the database for the system prompt.
+	*/
+	async loadFlowContext(flowId, selectedNodeId, viewMode) {
+		try {
+			const flow = await this.flowsService.getFlowById(flowId);
+			if (!flow) return null;
+			const latestVersion = await this.flowVersionsService.getFlowVersion(flowId, "latest");
+			if (!latestVersion) return {
+				flowId: flow.id,
+				flowName: flow.name,
+				flowDescription: flow.description ?? void 0,
+				nodes: [],
+				edges: [],
+				selectedNodeId,
+				viewMode
+			};
+			const definition = typeof latestVersion.invectDefinition === "string" ? JSON.parse(latestVersion.invectDefinition) : latestVersion.invectDefinition;
+			const nodes = (definition?.nodes ?? []).map((n) => ({
+				id: n.id,
+				type: n.type,
+				label: n.label || n.data?.label || "Unnamed",
+				referenceId: n.referenceId || n.data?.referenceId,
+				paramKeys: n.params ? Object.keys(n.params) : n.data?.params ? Object.keys(n.data.params) : void 0
+			}));
+			const edges = (definition?.edges ?? []).map((e) => ({
+				sourceId: e.source ?? e.sourceId ?? "",
+				targetId: e.target ?? e.targetId ?? ""
+			}));
+			return {
+				flowId: flow.id,
+				flowName: flow.name,
+				flowDescription: flow.description ?? void 0,
+				nodes,
+				edges,
+				selectedNodeId,
+				viewMode
+			};
+		} catch (error) {
+			this.logger.warn("Error loading flow context:", {
+				error,
+				flowId
+			});
+			return null;
+		}
+	}
+	/**
+	* Create a one-shot error stream.
+	*/
+	async *errorStream(message) {
+		yield {
+			type: "error",
+			message,
+			recoverable: false
+		};
+		yield { type: "done" };
+	}
+};
+//#endregion
+export { ChatStreamService };
+
+//# sourceMappingURL=chat-stream.service.js.map

package/dist/services/chat/chat-stream.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-stream.service.js","names":[],"sources":["../../../src/services/chat/chat-stream.service.ts"],"sourcesContent":["/**\n * Chat Stream Service\n *\n * The main entry point for the chat assistant feature.\n * Responsibilities:\n * - Resolve credential → determine provider (Anthropic/OpenAI) and API key\n * - Create ephemeral ProviderAdapter instances for chat requests\n * - Load flow context from the database\n * - Create ChatStreamSession instances\n *\n * Lifecycle: Singleton created during ServiceFactory.initialize().\n */\n\nimport type { Logger } from 'src/types/schemas';\nimport type { InvectConfig } from 'src/types/schemas';\nimport type { InvectIdentity } from 'src/types/auth.types';\nimport type { ActionRegistry } from 'src/actions';\nimport type { ProviderAdapter } from '../ai/provider-adapter';\nimport type {\n  ChatMessage,\n  ChatContext,\n  ChatConfig,\n  ChatStreamEvent,\n  ResolvedChatConfig,\n} from './chat-types';\nimport type { FlowContextData } from './system-prompt';\nimport { ChatConfigSchema } from './chat-types';\nimport { ChatToolkit } from './chat-toolkit';\nimport { ChatStreamSession } from './chat-stream-session';\nimport { OpenAIAdapter } from '../ai/openai-adapter';\nimport { AnthropicAdapter } from '../ai/anthropic-adapter';\nimport { OpenRouterAdapter } from '../ai/openrouter-adapter';\nimport { BatchProvider } from '../ai/ai-types';\nimport { detectProviderFromCredential } from 'src/utils/provider-detection';\nimport type { CredentialsService } from '../credentials/credentials.service';\nimport type { FlowsService } from '../flows/flows.service';\nimport type { FlowVersionsService } from '../flow-versions/flow-versions.service';\n\n/**\n * Options for creating a chat stream.\n */\nexport interface CreateChatStreamOptions {\n  messages: ChatMessage[];\n  context: ChatContext;\n  identity?: InvectIdentity;\n}\n\n/**\n * Chat Stream Service — manages chat sessions and dependencies.\n */\nexport class ChatStreamService {\n  private toolkit: ChatToolkit;\n  private chatConfig: ChatConfig;\n\n  constructor(\n    private readonly logger: Logger,\n    private readonly config: InvectConfig,\n    private readonly credentialsService: CredentialsService,\n    private readonly flowsService: FlowsService,\n    private readonly flowVersionsService: FlowVersionsService,\n    private readonly actionRegistry: ActionRegistry | null,\n    /** Invect core instance — passed to tools as an opaque handle */\n    private readonly invect: unknown,\n  ) {\n    // Parse and apply defaults to chat config\n    this.chatConfig = ChatConfigSchema.parse(this.config.chat ?? {});\n    this.toolkit = new ChatToolkit(logger);\n\n    logger.info(\n      `ChatStreamService initialized (enabled: ${this.chatConfig.enabled}, tools: ${this.toolkit.size})`,\n    );\n  }\n\n  /**\n   * Create a streaming chat session.\n   *\n   * Returns an AsyncGenerator that yields ChatStreamEvents.\n   * Framework adapters (Express, NestJS, Next.js) consume this\n   * and serialize events to SSE.\n   */\n  async createStream(options: CreateChatStreamOptions): Promise<AsyncGenerator<ChatStreamEvent>> {\n    if (!this.chatConfig.enabled) {\n      return this.errorStream('Chat assistant is disabled in configuration');\n    }\n\n    const { messages, context, identity } = options;\n\n    // 1. Resolve config (credential → provider + apiKey + model)\n    let resolvedConfig: ResolvedChatConfig;\n    try {\n      resolvedConfig = await this.resolveConfig(context.credentialId);\n    } catch (error: unknown) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return this.errorStream(`Failed to resolve chat credentials: ${msg}`);\n    }\n\n    // 2. Create ephemeral adapter for this request\n    const adapter = this.createAdapter(resolvedConfig);\n\n    // 3. Load flow context from database (if flowId provided)\n    let flowContext: FlowContextData | null = null;\n    if (context.flowId) {\n      try {\n        flowContext = await this.loadFlowContext(\n          context.flowId,\n          context.selectedNodeId,\n          context.viewMode,\n        );\n      } catch (error: unknown) {\n        this.logger.warn('Failed to load flow context for chat:', { error });\n        // Continue without flow context — better than failing\n      }\n    }\n\n    // 4. Apply per-request overrides from context\n    if (context.maxSteps && context.maxSteps >= 1 && context.maxSteps <= 50) {\n      resolvedConfig = { ...resolvedConfig, maxSteps: context.maxSteps };\n    }\n\n    // 5. Create and return session stream\n    const session = new ChatStreamSession({\n      logger: this.logger,\n      toolkit: this.toolkit,\n      config: resolvedConfig,\n      adapter,\n      identity,\n      invect: this.invect,\n      actionRegistry: this.actionRegistry,\n    });\n\n    return session.stream(messages, context, flowContext);\n  }\n\n  /**\n   * Check if the chat feature is enabled and properly configured.\n   */\n  isEnabled(): boolean {\n    return this.chatConfig.enabled;\n  }\n\n  /**\n   * Get the toolkit for external registration of tools.\n   */\n  getToolkit(): ChatToolkit {\n    return this.toolkit;\n  }\n\n  // =====================================\n  // CREDENTIAL & CONFIG RESOLUTION\n  // =====================================\n\n  /**\n   * Resolve chat model configuration.\n   *\n   * Resolution order:\n   * 1. Per-request credentialId (from frontend)\n   * 2. chatConfig.credentialId (from InvectConfig)\n   */\n  private async resolveConfig(perRequestCredentialId?: string): Promise<ResolvedChatConfig> {\n    const base: Partial<ResolvedChatConfig> = {\n      maxSteps: this.chatConfig.maxSteps,\n      maxHistoryMessages: this.chatConfig.maxHistoryMessages,\n      enabled: this.chatConfig.enabled,\n    };\n\n    // Try per-request credential\n    if (perRequestCredentialId) {\n      return this.resolveFromCredential(perRequestCredentialId, base);\n    }\n\n    // Try chatConfig credential\n    if (this.chatConfig.credentialId) {\n      return this.resolveFromCredential(this.chatConfig.credentialId, base);\n    }\n\n    throw new Error(\n      'No chat credential configured. Select a credential in the chat settings, ' +\n        'or set chat.credentialId in the server config.',\n    );\n  }\n\n  /**\n   * Resolve config from a credential in the credentials table.\n   */\n  private async resolveFromCredential(\n    credentialId: string,\n    base: Partial<ResolvedChatConfig>,\n  ): Promise<ResolvedChatConfig> {\n    const credential = await this.credentialsService.getDecryptedWithRefresh(credentialId);\n\n    const provider = detectProviderFromCredential(credential);\n    if (!provider) {\n      throw new Error(\n        `Cannot determine AI provider from credential \"${credentialId}\". ` +\n          `Set \"provider\" in credential metadata (OPENAI, ANTHROPIC, or OPENROUTER).`,\n      );\n    }\n\n    const apiKey = (credential.config as Record<string, unknown>)?.apiKey as string;\n    if (!apiKey) {\n      throw new Error(`Credential \"${credentialId}\" has no apiKey in config.`);\n    }\n\n    const model = this.chatConfig.defaultModel ?? this.getDefaultModel(provider);\n\n    const providerMap: Record<string, 'OPENAI' | 'ANTHROPIC' | 'OPENROUTER'> = {\n      [BatchProvider.OPENAI]: 'OPENAI',\n      [BatchProvider.ANTHROPIC]: 'ANTHROPIC',\n      [BatchProvider.OPENROUTER]: 'OPENROUTER',\n    };\n\n    return {\n      ...base,\n      credentialId,\n      model,\n      provider: providerMap[provider] ?? 'OPENAI',\n      apiKey,\n      maxSteps: base.maxSteps ?? 15,\n      maxHistoryMessages: base.maxHistoryMessages ?? 20,\n      enabled: base.enabled ?? true,\n    };\n  }\n\n  /**\n   * Get the default model for a provider (cheap models for chat).\n   */\n  private getDefaultModel(provider: BatchProvider): string {\n    switch (provider) {\n      case BatchProvider.ANTHROPIC:\n        return 'claude-sonnet-4-20250514';\n      case BatchProvider.OPENAI:\n        return 'gpt-4o-mini';\n      case BatchProvider.OPENROUTER:\n        return 'anthropic/claude-sonnet-4-20250514';\n      default:\n        return 'gpt-4o-mini';\n    }\n  }\n\n  // =====================================\n  // ADAPTER CREATION\n  // =====================================\n\n  /**\n   * Create an ephemeral ProviderAdapter for a chat request.\n   * Uses the resolved config to instantiate the correct adapter.\n   */\n  private createAdapter(config: ResolvedChatConfig): ProviderAdapter {\n    switch (config.provider) {\n      case 'OPENAI':\n        return new OpenAIAdapter(this.logger, config.apiKey);\n      case 'ANTHROPIC':\n        return new AnthropicAdapter(this.logger, config.apiKey);\n      case 'OPENROUTER':\n        return new OpenRouterAdapter(this.logger, config.apiKey);\n      default:\n        throw new Error(`Unsupported chat provider: ${config.provider}`);\n    }\n  }\n\n  // =====================================\n  // FLOW CONTEXT LOADING\n  // =====================================\n\n  /**\n   * Load flow context from the database for the system prompt.\n   */\n  private async loadFlowContext(\n    flowId: string,\n    selectedNodeId?: string,\n    viewMode?: string,\n  ): Promise<FlowContextData | null> {\n    try {\n      const flow = await this.flowsService.getFlowById(flowId);\n      if (!flow) {\n        return null;\n      }\n\n      // Get the latest version to read node definitions\n      const latestVersion = await this.flowVersionsService.getFlowVersion(flowId, 'latest');\n      if (!latestVersion) {\n        return {\n          flowId: flow.id,\n          flowName: flow.name,\n          flowDescription: flow.description ?? undefined,\n          nodes: [],\n          edges: [],\n          selectedNodeId,\n          viewMode: viewMode as 'edit' | 'runs' | undefined,\n        };\n      }\n\n      // Parse definition\n      const definition =\n        typeof latestVersion.invectDefinition === 'string'\n          ? JSON.parse(latestVersion.invectDefinition)\n          : latestVersion.invectDefinition;\n\n      interface FlowNode {\n        id: string;\n        type: string;\n        label?: string;\n        referenceId?: string;\n        params?: Record<string, unknown>;\n        data?: { label?: string; referenceId?: string; params?: Record<string, unknown> };\n      }\n      interface FlowEdge {\n        source?: string;\n        sourceId?: string;\n        target?: string;\n        targetId?: string;\n      }\n\n      const nodes = ((definition?.nodes ?? []) as FlowNode[]).map((n) => ({\n        id: n.id,\n        type: n.type,\n        label: n.label || n.data?.label || 'Unnamed',\n        referenceId: n.referenceId || n.data?.referenceId,\n        paramKeys: n.params\n          ? Object.keys(n.params)\n          : n.data?.params\n            ? Object.keys(n.data.params)\n            : undefined,\n      }));\n\n      const edges = ((definition?.edges ?? []) as FlowEdge[]).map((e) => ({\n        sourceId: e.source ?? e.sourceId ?? '',\n        targetId: e.target ?? e.targetId ?? '',\n      }));\n\n      return {\n        flowId: flow.id,\n        flowName: flow.name,\n        flowDescription: flow.description ?? undefined,\n        nodes,\n        edges,\n        selectedNodeId,\n        viewMode: viewMode as 'edit' | 'runs' | undefined,\n      };\n    } catch (error) {\n      this.logger.warn('Error loading flow context:', { error, flowId });\n      return null;\n    }\n  }\n\n  // =====================================\n  // HELPERS\n  // =====================================\n\n  /**\n   * Create a one-shot error stream.\n   */\n  private async *errorStream(message: string): AsyncGenerator<ChatStreamEvent> {\n    yield { type: 'error', message, recoverable: false };\n    yield { type: 'done' };\n  }\n}\n"],"mappings":"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"}