@wildo-ai/saas-backend-lib 1.1.2 → 1.1.4

package/dist/esm/flows-actors/services/flows-actors-registry.service.js

@@ -16,9 +16,9 @@ import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
 import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
 import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
 import { describeCaughtError } from '../../errors/utils/error-log-level-classification.backend.utils.js';
-import { FlowActorSystem_Kind, isLLMAgentConfiguration, } from '@wildo-ai/saas-models';
+import { FlowActorSystem_Kind, isLLMAgentConfiguration, mcpServerDestinationHost, mcpServerTransportIsPlaintext, } from '@wildo-ai/saas-models';
 import { ErrorType, ErrorCustomMessageReference } from '@wildo-ai/saas-models';
-import { validateReasoningEffortForModel } from '@wildo-ai/external-connectors-models';
+import { resolveModelForApplicability, validateReasoningEffortForModel } from '@wildo-ai/external-connectors-models';
 import { flowsActors_Backend_Default_Definition } from '../../flows-actors/models/flows-actors.backend.definitions.js';
 /**
  * FlowsActors Registry Service
@@ -45,6 +45,7 @@ let FlowsActorsRegistryService = class FlowsActorsRegistryService {
             agents: {},
             flows: {},
             actors: {},
+            mcpServers: {},
             agentRegistryIndex: {
                 agents: {},
                 agentsByProvider: {},
@@ -63,7 +64,7 @@ let FlowsActorsRegistryService = class FlowsActorsRegistryService {
      * Initialize the registry with flow-actor systems and agents
      * Follows the same pattern as ResourcesRegistryBackendService.initialize()
      */
-    async initialize(customBackend_FlowActorSystemsFactoryMap, customBackend_Agents, customBackend_FunctionTools) {
+    async initialize(customBackend_FlowActorSystemsFactoryMap, customBackend_Agents, customBackend_FunctionTools, customBackend_McpServers) {
         if (this.isInitialized) {
             this.logDebug('Registry already initialized, skipping...');
             return;
@@ -105,6 +106,16 @@ let FlowsActorsRegistryService = class FlowsActorsRegistryService {
         for (const functionTool of mergedFunctionTools) {
             this.registerFunctionTool(functionTool);
         }
+        for (const mcpServer of customBackend_McpServers ?? []) {
+            this.registerMcpServer(mcpServer);
+        }
+        /**
+         * Every agent's `mcpRefs` must name a DECLARED server, checked here rather than in
+         * `registerAgent` because registration order is not guaranteed — an agent may register before
+         * the servers it names, and a per-registration check would refuse a coherent application for
+         * the order its addons happened to load in.
+         */
+        this.assertDeclaredMcpRefs();
         this.isInitialized = true;
         this.logDebug('FlowsActors registry initialization completed', {
             totalSystems: Object.keys(this.registry.flows).length + Object.keys(this.registry.actors).length,
@@ -252,9 +263,10 @@ let FlowsActorsRegistryService = class FlowsActorsRegistryService {
      * minutes and real money before reaching its first call).
      *
      * The canonical trap this catches: `reasoningEffort: NONE` turns reasoning off
-     * on GPT-5.6 but hard-errors on Claude 5, whose thinking cannot be disabled —
-     * so the pair's validity depends on the model, and swapping a model without
-     * re-auditing its reasoning params is exactly how it breaks.
+     * on GPT-5.6 and on most of Claude 5, but hard-errors on `claude-fable-5`,
+     * whose thinking cannot be disabled — so the pair's validity depends on the
+     * MODEL, not even on its family, and swapping a model without re-auditing its
+     * reasoning params is exactly how it breaks.
      *
      * Validation fails OPEN for unknown/unverified model ids (custom + fine-tuned
      * deployments are legitimate) — see `validateReasoningEffortForModel`.
@@ -263,35 +275,87 @@ let FlowsActorsRegistryService = class FlowsActorsRegistryService {
         if (this.registry.agents[agent.ref]) {
             this.logDebug('Agent already registered, updating...', { ref: agent.ref });
         }
+        /*
+         * What gets REGISTERED may differ from what was AUTHORED (a resolved model id, below), and the
+         * difference lives on a copy. The authored object is never written. Until 2026-09-09 this
+         * method wrote `model` onto the caller's own config object; the dev companion's (since deleted)
+         * startup-composition identity fence caught that as a mutated startup graph and crash-looped
+         * every companion into `CRASH_RESPAWN_EXHAUSTED`. The fence was a survivor of the digest
+         * demolition and went with it, but the registry was the side in the wrong regardless: a
+         * resolver has no business changing its input, and the copy stays.
+         */
+        let registered = agent;
         // Only the LLM arm of the config union reasons. Narrowed POSITIVELY: this
         // was `!isImageAgentConfiguration(...)`, which meant "the LLM arm" only
         // while the union had two members — the coding arm then fell straight into
         // it and the failure surfaced as a missing `reasoningEffort` property.
         if (isLLMAgentConfiguration(agent.config)) {
-            const reasoningViolation = validateReasoningEffortForModel(agent.config.model, agent.config.reasoningEffort);
+            /*
+             * Resolve the APPLICABILITY axis into a concrete model id, here and only here (#439).
+             *
+             * An agent declares the KIND of work it does (`modelApplicability`) rather than naming a
+             * model — the standing policy, which embeddings and document extraction already followed and
+             * the agent path did not: `resolveModelForApplicability` had NO production caller anywhere,
+             * and the field its own JSDoc named was declared by no configuration type.
+             *
+             * Registration is the chokepoint because it is where the config stops being authored and
+             * starts being used: everything downstream reads `config.model` off the REGISTRY, so
+             * resolving once here leaves all ~17 consumers untouched and keeps the invariant simple —
+             * **a registered agent always carries a concrete model.** Resolving lazily at call time would
+             * put a failure that belongs at startup inside a paid request.
+             *
+             * FAILS CLOSED, with the resolver's own named failure and the candidates it considered. An
+             * applicability no model of this provider serves is a misconfiguration, and substituting some
+             * other model would be the exact defect the axis exists to remove: the author asked for a
+             * KIND, and quietly handing them a different kind is worse than refusing.
+             */
+            let llmConfig = agent.config;
+            if (llmConfig.modelApplicability !== undefined) {
+                const resolution = resolveModelForApplicability({
+                    applicability: llmConfig.modelApplicability,
+                    providerRef: llmConfig.providerRef,
+                });
+                if (resolution.resolved === false) {
+                    throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, { customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+                        context: {
+                            message: 'Agent declares a model applicability no model of its provider can serve',
+                            agentRef: agent.ref,
+                            providerRef: llmConfig.providerRef,
+                            modelApplicability: llmConfig.modelApplicability,
+                            failure: resolution.failure,
+                            consideredModels: resolution.consideredModels,
+                        } });
+                }
+                // A COPY carrying the resolved id. The spread keeps the `isLLMAgentConfiguration` narrowing
+                // for the reasoning validation immediately below — which must run on the RESOLVED model,
+                // being model-dependent — so nothing here needs to write onto the authored object.
+                llmConfig = { ...llmConfig, model: resolution.model };
+                registered = { ...agent, config: llmConfig };
+            }
+            const reasoningViolation = validateReasoningEffortForModel(llmConfig.model, llmConfig.reasoningEffort);
             if (reasoningViolation) {
                 throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, { customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,
-                    context: { agentRef: agent.ref, model: agent.config.model, reasoningEffort: agent.config.reasoningEffort, error: reasoningViolation } });
+                    context: { agentRef: agent.ref, model: llmConfig.model, reasoningEffort: llmConfig.reasoningEffort, error: reasoningViolation } });
             }
         }
-        this.registry.agents[agent.ref] = agent;
+        this.registry.agents[registered.ref] = registered;
         // Create index entries for quick lookup
-        this.registry.agentRegistryIndex.agents[agent.ref] = agent;
+        this.registry.agentRegistryIndex.agents[registered.ref] = registered;
         // Index by provider
-        if (!this.registry.agentRegistryIndex.agentsByProvider[agent.config.providerRef]) {
-            this.registry.agentRegistryIndex.agentsByProvider[agent.config.providerRef] = [];
+        if (!this.registry.agentRegistryIndex.agentsByProvider[registered.config.providerRef]) {
+            this.registry.agentRegistryIndex.agentsByProvider[registered.config.providerRef] = [];
         }
-        this.registry.agentRegistryIndex.agentsByProvider[agent.config.providerRef].push(agent);
+        this.registry.agentRegistryIndex.agentsByProvider[registered.config.providerRef].push(registered);
         // Index by operation
-        if (!this.registry.agentRegistryIndex.agentsByOperation[agent.config.operationKey]) {
-            this.registry.agentRegistryIndex.agentsByOperation[agent.config.operationKey] = [];
+        if (!this.registry.agentRegistryIndex.agentsByOperation[registered.config.operationKey]) {
+            this.registry.agentRegistryIndex.agentsByOperation[registered.config.operationKey] = [];
         }
-        this.registry.agentRegistryIndex.agentsByOperation[agent.config.operationKey].push(agent);
+        this.registry.agentRegistryIndex.agentsByOperation[registered.config.operationKey].push(registered);
         this.logDebug('Agent registered', {
-            ref: agent.ref,
-            displayName: agent.displayName,
-            operationKey: agent.config.operationKey,
-            providerRef: agent.config.providerRef
+            ref: registered.ref,
+            displayName: registered.displayName,
+            operationKey: registered.config.operationKey,
+            providerRef: registered.config.providerRef
         });
     }
     /**
@@ -357,6 +421,76 @@ let FlowsActorsRegistryService = class FlowsActorsRegistryService {
         return !!this.registry.functionTools[ref];
     }
     // ================================
+    // MCP Server Registration & Retrieval
+    // ================================
+    /**
+     * Register an MCP server the application permits its agents to reach, indexed by the ref an
+     * agent's `capabilities.tools.mcpRefs` names (#491).
+     *
+     * REFUSES a plaintext endpoint. An MCP call carries a delegated credential to a third party, so
+     * `http://` would put a bearer token on the wire in clear — and unlike the webhook lane, where a
+     * plaintext endpoint is the operator's own declared destination and is reported rather than
+     * blocked, nothing here is the application's to expose on someone else's behalf.
+     */
+    registerMcpServer(mcpServer) {
+        if (mcpServerTransportIsPlaintext(mcpServer.url)) {
+            throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
+                customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,
+                context: {
+                    mcpServerRef: mcpServer.ref,
+                    destinationHost: mcpServerDestinationHost(mcpServer.url),
+                    reason: 'mcp_server_endpoint_is_plaintext',
+                },
+            });
+        }
+        this.registry.mcpServers[mcpServer.ref] = mcpServer;
+        this.logDebug('Registered MCP server', {
+            ref: mcpServer.ref,
+            transport: mcpServer.transport,
+            destinationHost: mcpServerDestinationHost(mcpServer.url),
+        });
+    }
+    /** Get a declared MCP server by ref. */
+    getMcpServer(ref) {
+        return this.registry.mcpServers[ref];
+    }
+    /** Check if an MCP server is declared. */
+    hasMcpServer(ref) {
+        return !!this.registry.mcpServers[ref];
+    }
+    /**
+     * Refuse an agent whose `mcpRefs` name a server the application never declared.
+     *
+     * FAIL-CLOSED, and deliberately stricter than `functionRefs`, which skip an unknown ref with a
+     * debug line. The asymmetry has a measured reason: an unknown `functionRef` costs an agent one
+     * tool, while `mcpRefs` were RENDERED to a person as a capability, and every ref that ever
+     * existed — `filesystem-mcp`, `git-mcp`, `browser-mcp`, `mongodb-mcp` — named no server anywhere,
+     * because the field could be authored against nothing (#491). A refusal is what makes that state
+     * unreachable rather than merely fixed once.
+     *
+     * The engine's own law, measured at `start-application.backend.service.ts`: a declaration gets
+     * made if and only if the framework refuses to start without it.
+     */
+    assertDeclaredMcpRefs() {
+        const undeclared = [];
+        for (const agent of Object.values(this.registry.agents)) {
+            for (const mcpRef of agent.capabilities?.tools?.mcpRefs ?? []) {
+                if (!this.hasMcpServer(mcpRef))
+                    undeclared.push({ agentRef: agent.ref, mcpRef });
+            }
+        }
+        if (undeclared.length === 0)
+            return;
+        throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
+            customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,
+            context: {
+                reason: 'agent_mcp_ref_names_no_declared_server',
+                undeclared,
+                declaredMcpServerRefs: Object.keys(this.registry.mcpServers),
+            },
+        });
+    }
+    // ================================
     // Registry Access
     // ================================
     /**

package/dist/esm/flows-actors/services/flows-actors-registry.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows-actors-registry.service.js","sourceRoot":"","sources":["../../../../../src/flows-actors/services/flows-actors-registry.service.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport { describeCaughtError } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport {\n  FlowActorSystem,\n  FlowActorSystem_Kind,\n  FlowsActors_Agent,\n  ActorSystem,\n  FlowSystem,\n  isLLMAgentConfiguration,\n} from '@wildo-ai/saas-models';\nimport {\n  ErrorType,\n  ErrorCustomMessageReference\n} from '@wildo-ai/saas-models';\nimport {\n  FlowsActorsRegistry,\n  FlowActorSystem_InitializationFactoryMap,\n  AgentRegistryIndex\n} from '~wildo-backend-lib/flows-actors/models/flows-actors.backend.schemas';\nimport { validateReasoningEffortForModel } from '@wildo-ai/external-connectors-models';\nimport type { FunctionTool } from '~wildo-backend-lib/flows-actors/models/function-tools.backend.definitions';\nimport { flowsActors_Backend_Default_Definition } from '~wildo-backend-lib/flows-actors/models/flows-actors.backend.definitions';\n\n/**\n * FlowsActors Registry Service\n *\n * Central registry for managing flow-actor systems, agents, and their configurations.\n * Similar to ResourcesRegistryBackendService but for flow-actor domain.\n *\n * Features:\n * - Register and retrieve flow systems and actors\n * - Manage agent definitions and capabilities\n * - System validation and lookup\n * - Kind-based filtering and organization\n */\n@injectable()\nexport class FlowsActorsRegistryService {\n\n  private registry: FlowsActorsRegistry;\n  private isInitialized = false;\n  protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService) private readonly errorBuilder: ErrorBuilderBackendService,\n  ) {\n    this.registry = {\n      agents: {},\n      flows: {},\n      actors: {},\n      agentRegistryIndex: {\n        agents: {},\n        agentsByProvider: {},\n        agentsByOperation: {},\n      },\n      functionTools: {},\n    };\n\n\n    this.logDebug = this.logger.debugByType('FlowsActorsRegistry');\n    this.logger.setDebugTypeLogging('FlowsActorsRegistry', false);\n\n    this.logDebug('FlowsActors registry service created');\n  }\n\n  // ================================\n  // Initialization\n  // ================================\n\n  /**\n   * Initialize the registry with flow-actor systems and agents\n   * Follows the same pattern as ResourcesRegistryBackendService.initialize()\n   */\n  public async initialize(\n    customBackend_FlowActorSystemsFactoryMap?: FlowActorSystem_InitializationFactoryMap,\n    customBackend_Agents?: FlowsActors_Agent[],\n    customBackend_FunctionTools?: FunctionTool[]\n  ): Promise<void> {\n    if (this.isInitialized) {\n      this.logDebug('Registry already initialized, skipping...');\n      return;\n    }\n\n    const defaultSystemsFactoryMap = flowsActors_Backend_Default_Definition.flowActorSystemsFactoryMap;\n    const defaultAgents = flowsActors_Backend_Default_Definition.agents;\n    const defaultFunctionTools = flowsActors_Backend_Default_Definition.functionTools;\n\n    // Merge default with custom backend (custom takes precedence)\n    const mergedSystemsFactoryMap: FlowActorSystem_InitializationFactoryMap = {\n      ...defaultSystemsFactoryMap,\n      ...customBackend_FlowActorSystemsFactoryMap,\n    };\n\n    const mergedAgents: FlowsActors_Agent[] = [\n      ...defaultAgents,\n      ...(customBackend_Agents || []),\n    ];\n\n    const mergedFunctionTools: FunctionTool[] = [\n      ...defaultFunctionTools,\n      ...(customBackend_FunctionTools || []),\n    ];\n\n    this.logDebug('Initializing flows-actors registry', {\n      defaultSystemsCount: Object.keys(defaultSystemsFactoryMap).length,\n      customBackendSystemsCount: customBackend_FlowActorSystemsFactoryMap ? Object.keys(customBackend_FlowActorSystemsFactoryMap).length : 0,\n      defaultAgentsCount: defaultAgents.length,\n      customBackendAgentsCount: customBackend_Agents?.length || 0,\n    });\n\n\n    for (const [ref, factory] of Object.entries(mergedSystemsFactoryMap)) {\n      try {\n        const system = factory();\n        this.registerSystem(system);\n      } catch (error) {\n        throw this.errorBuilder.buildError( ErrorType.INTERNAL, undefined,\n          { customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE, context: { systemRef: ref, error: describeCaughtError(error) }});\n      }\n    }\n\n\n    for (const agent of mergedAgents) {\n      this.registerAgent(agent);\n    }\n\n    for (const functionTool of mergedFunctionTools) {\n      this.registerFunctionTool(functionTool);\n    }\n\n    this.isInitialized = true;\n\n    this.logDebug('FlowsActors registry initialization completed', {\n      totalSystems: Object.keys(this.registry.flows).length + Object.keys(this.registry.actors).length,\n      flows: Object.keys(this.registry.flows).length,\n      actors: Object.keys(this.registry.actors).length,\n      agents: Object.keys(this.registry.agents).length,\n    });\n  }\n\n  // ================================\n  // System Registration & Retrieval\n  // ================================\n\n  /**\n   * Register a flow-actor system\n   */\n  public registerSystem(system: FlowActorSystem): void {\n\n    // Captured before the branching so the exhaustiveness arm below can report\n    // WHICH system failed: inside that arm `system` is `never`, and reaching\n    // through a `never` would need exactly the kind of assertion this change\n    // exists to remove.\n    const { ref: systemRef, kind: systemKind } = system;\n\n    if (system.kind === FlowActorSystem_Kind.FLOW) {\n      if (this.registry.flows[system.ref])\n        this.logDebug('Flow already registered, updating...', { ref: system.ref });\n\n      // `FlowActorSystem` is a discriminated union on `kind`, so this assignment\n      // is checked rather than asserted: the branch has already narrowed the\n      // value to `FlowSystem`, which is what the registry bucket stores.\n      this.registry.flows[system.ref] = system;\n\n    } else if (system.kind === FlowActorSystem_Kind.ACTOR) {\n\n      if (this.registry.actors[system.ref])\n        this.logDebug('Actor already registered, updating...', { ref: system.ref });\n\n      this.registry.actors[system.ref] = system;\n\n    } else {\n      /*\n       * Exhaustiveness guard, newly possible because `FlowActorSystem` is a\n       * discriminated union. Before it, an added system kind fell through here\n       * and was dropped SILENTLY — the method returns void and logs \"System\n       * registered\" either way, so the system was simply never resolvable. A\n       * new union member now fails the `never` assignment at COMPILE time.\n       *\n       * The throw covers the runtime residue: this method is public API, so an\n       * untyped or asserted caller can still hand over a system whose kind is\n       * outside the union. Registration failing loudly at startup beats a\n       * registry that reports success and resolves nothing.\n       */\n      const unhandledSystem: never = system;\n      throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {\n        customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,\n        // `unhandledSystem` is carried into the diagnostic on purpose: an\n        // exhaustiveness binding nothing reads looks like dead code, and the\n        // next cleanup deletes the only compile-time guard in this method.\n        // Here it is load-bearing in both directions — the `never` annotation\n        // is the compile-time check, the value is the runtime diagnostic.\n        context: { systemRef, kind: systemKind, unhandledSystem },\n      });\n    }\n\n\n    this.logDebug('System registered', {\n      ref: system.ref,\n      kind: system.kind,\n      displayName: system.displayName\n    });\n  }\n\n  /**\n   * Get a flow-actor system by reference\n   */\n  public getSystem(ref: string, kind: FlowActorSystem_Kind): FlowActorSystem | undefined {\n    if (kind === FlowActorSystem_Kind.FLOW) {\n      return this.registry.flows[ref];\n    } else if (kind === FlowActorSystem_Kind.ACTOR) {\n      return this.registry.actors[ref];\n    }\n    return undefined;\n  }\n\n  /**\n   * Get a flow-actor system or throw error\n   */\n  public getSystemOrThrow(ref: string, kind: FlowActorSystem_Kind): FlowActorSystem {\n    const system = this.getSystem(ref, kind);\n    if (!system) {\n      throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined,\n        { customMessageReference: ErrorCustomMessageReference.NOT_FOUND, context: { systemRef: ref, kind } });\n    }\n    return system;\n  }\n\n  /**\n   * Get all systems of a specific kind\n   */\n  public getSystemsByKind(kind: FlowActorSystem_Kind): FlowActorSystem[] {\n    if(kind === FlowActorSystem_Kind.FLOW) {\n      return this.getFlows();\n    } else if (kind === FlowActorSystem_Kind.ACTOR) {\n      return this.getActors();\n    }\n    return [];\n  }\n\n  /**\n   * Get all flows.\n   *\n   * Returns `FlowSystem[]`, not the union: the kind is fixed by the accessor,\n   * so widening would make every caller re-narrow to reach `steps`/`edges`\n   * even though nothing here can be an actor system — and that re-narrowing\n   * pressure is precisely what produced the assertions this change removed.\n   *\n   * These two accessors, not `getSystemsByKind`, are the typed primitives.\n   * `getSystemsByKind` takes a kind as a RUNTIME VALUE, which no signature can\n   * track without a generic, so it can only ever promise the union; it now\n   * delegates here rather than re-reading the buckets, so the kind→bucket\n   * mapping is stated once.\n   */\n  public getFlows(): FlowSystem[] {\n    return Object.values(this.registry.flows);\n  }\n\n  /**\n   * Get all actors — `ActorSystem[]`, so `.actors` is reachable on each entry\n   * without a cast. See `getFlows`.\n   */\n  public getActors(): ActorSystem[] {\n    return Object.values(this.registry.actors);\n  }\n\n  /**\n   * Check if a system exists\n   */\n  public hasSystem(ref: string, kind: FlowActorSystem_Kind): boolean {\n    if (kind === FlowActorSystem_Kind.FLOW) {\n      return !!this.registry.flows[ref];\n    } else if (kind === FlowActorSystem_Kind.ACTOR) {\n      return !!this.registry.actors[ref];\n    }\n    return false;\n  }\n\n  // ================================\n  // Agent Registration & Retrieval\n  // ================================\n\n  /**\n   * Register an agent.\n   *\n   * Fails CLOSED on a `model × reasoningEffort` pair the target model cannot\n   * honour. Registration is the authoring-time seam: every agent — engine\n   * defaults and app-registered customs alike — funnels through here at\n   * startup, so a bad pair surfaces as a named boot error instead of a provider\n   * 400 thrown deep inside a long agent pipeline (a deliberation can burn\n   * minutes and real money before reaching its first call).\n   *\n   * The canonical trap this catches: `reasoningEffort: NONE` turns reasoning off\n   * on GPT-5.6 but hard-errors on Claude 5, whose thinking cannot be disabled —\n   * so the pair's validity depends on the model, and swapping a model without\n   * re-auditing its reasoning params is exactly how it breaks.\n   *\n   * Validation fails OPEN for unknown/unverified model ids (custom + fine-tuned\n   * deployments are legitimate) — see `validateReasoningEffortForModel`.\n   */\n  public registerAgent(agent: FlowsActors_Agent): void {\n    if (this.registry.agents[agent.ref]) {\n      this.logDebug('Agent already registered, updating...', { ref: agent.ref });\n    }\n\n    // Only the LLM arm of the config union reasons. Narrowed POSITIVELY: this\n    // was `!isImageAgentConfiguration(...)`, which meant \"the LLM arm\" only\n    // while the union had two members — the coding arm then fell straight into\n    // it and the failure surfaced as a missing `reasoningEffort` property.\n    if (isLLMAgentConfiguration(agent.config)) {\n      const reasoningViolation = validateReasoningEffortForModel(agent.config.model, agent.config.reasoningEffort);\n      if (reasoningViolation) {\n        throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined,\n          { customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,\n            context: { agentRef: agent.ref, model: agent.config.model, reasoningEffort: agent.config.reasoningEffort, error: reasoningViolation } });\n      }\n    }\n\n    this.registry.agents[agent.ref] = agent;\n\n    // Create index entries for quick lookup\n    this.registry.agentRegistryIndex.agents[agent.ref] = agent;\n\n    // Index by provider\n    if (!this.registry.agentRegistryIndex.agentsByProvider[agent.config.providerRef]) {\n      this.registry.agentRegistryIndex.agentsByProvider[agent.config.providerRef] = [];\n    }\n    this.registry.agentRegistryIndex.agentsByProvider[agent.config.providerRef].push(agent);\n\n    // Index by operation\n    if (!this.registry.agentRegistryIndex.agentsByOperation[agent.config.operationKey]) {\n      this.registry.agentRegistryIndex.agentsByOperation[agent.config.operationKey] = [];\n    }\n    this.registry.agentRegistryIndex.agentsByOperation[agent.config.operationKey].push(agent);\n\n    this.logDebug('Agent registered', {\n      ref: agent.ref,\n      displayName: agent.displayName,\n      operationKey: agent.config.operationKey,\n      providerRef: agent.config.providerRef\n    });\n  }\n\n  /**\n   * Get an agent by reference\n   */\n  public getAgent(ref: string): FlowsActors_Agent | undefined {\n    return this.registry.agents[ref];\n  }\n\n  /**\n   * Get an agent or throw error\n   */\n  public getAgentOrThrow(ref: string): FlowsActors_Agent {\n    const agent = this.getAgent(ref);\n\n    if (!agent) {\n      throw this.errorBuilder.buildError( ErrorType.NOT_FOUND, undefined,\n        {customMessageReference: ErrorCustomMessageReference.NOT_FOUND,context: { agentRef: ref } });\n    }\n    return agent;\n  }\n\n  /**\n   * Get agents by provider\n   */\n  public getAgentsByProvider(providerRef: string): FlowsActors_Agent[] {\n    return this.registry.agentRegistryIndex.agentsByProvider[providerRef] || [];\n  }\n\n  /**\n   * Get agents by operation key\n   */\n  public getAgentsByOperation(operationKey: string): FlowsActors_Agent[] {\n    return this.registry.agentRegistryIndex.agentsByOperation[operationKey] || [];\n  }\n\n  /**\n   * Check if an agent exists\n   */\n  public hasAgent(ref: string): boolean {\n    return !!this.registry.agents[ref];\n  }\n\n  // ================================\n  // Function Tools\n  // ================================\n\n  /**\n   * Register an executable function tool, indexed by its `functionRef`. Agents\n   * reference it via `capabilities.tools.functionRefs`; `AgentsBackendService`\n   * resolves it into an AI-SDK tool at invocation time.\n   */\n  public registerFunctionTool(functionTool: FunctionTool): void {\n    this.registry.functionTools[functionTool.functionRef] = functionTool;\n    this.logDebug('Registered function tool', { functionRef: functionTool.functionRef });\n  }\n\n  /** Get a function tool by ref. */\n  public getFunctionTool(ref: string): FunctionTool | undefined {\n    return this.registry.functionTools[ref];\n  }\n\n  /** Get a function tool or throw NOT_FOUND. */\n  public getFunctionToolOrThrow(ref: string): FunctionTool {\n    const functionTool = this.getFunctionTool(ref);\n    if (!functionTool) {\n      throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined,\n        { customMessageReference: ErrorCustomMessageReference.NOT_FOUND, context: { functionRef: ref } });\n    }\n    return functionTool;\n  }\n\n  /** Check if a function tool exists. */\n  public hasFunctionTool(ref: string): boolean {\n    return !!this.registry.functionTools[ref];\n  }\n\n  // ================================\n  // Registry Access\n  // ================================\n\n  /**\n   * Get the complete registry\n   */\n  public getRegistry(): FlowsActorsRegistry {\n    return this.registry;\n  }\n\n  /**\n   * Get the agent registry index\n   */\n  public getAgentRegistryIndex(): AgentRegistryIndex {\n    return this.registry.agentRegistryIndex;\n  }\n\n  // ================================\n  // Debug Methods\n  // ================================\n\n  public getDebugInfo(): {\n    isInitialized: boolean;\n    totalSystems: number;\n    flowsCount: number;\n    actorsCount: number;\n    agentsCount: number;\n    systemRefs: string[];\n    agentRefs: string[];\n  } {\n    return {\n      isInitialized: this.isInitialized,\n      totalSystems: Object.keys(this.registry.flows).length + Object.keys(this.registry.actors).length,\n      flowsCount: Object.keys(this.registry.flows).length,\n      actorsCount: Object.keys(this.registry.actors).length,\n      agentsCount: Object.keys(this.registry.agents).length,\n      systemRefs: Object.keys(this.registry.flows).concat(Object.keys(this.registry.actors)),\n      agentRefs: Object.keys(this.registry.agents),\n    };\n  }\n\n  public displayRegistryInfo(): void {\n    this.logDebug('\\n=== 🤖 FLOWS-ACTORS REGISTRY SUMMARY ===\\n');\n\n    const info = this.getDebugInfo();\n\n    this.logDebug(`📊 STATISTICS:`);\n    this.logDebug(`   Total Systems: ${info.totalSystems}`);\n    this.logDebug(`   Flows: ${info.flowsCount}`);\n    this.logDebug(`   Actors: ${info.actorsCount}`);\n    this.logDebug(`   Agents: ${info.agentsCount}`);\n    this.logDebug(`   Initialized: ${info.isInitialized}`);\n\n    if (info.systemRefs.length > 0) {\n      this.logDebug('\\n🔄 REGISTERED SYSTEMS:');\n      info.systemRefs.forEach(ref => {\n        const system = this.registry.flows[ref];\n        this.logDebug(`   - ${ref} (${system.kind}): ${system.displayName}`);\n      });\n    }\n\n    if (info.agentRefs.length > 0) {\n      this.logDebug('\\n🤖 REGISTERED AGENTS:');\n      info.agentRefs.forEach(ref => {\n        const agent = this.registry.agentRegistryIndex.agents[ref];\n        this.logDebug(`   - ${ref}: ${agent.displayName} [${agent.config.providerRef}/${agent.config.operationKey}]`);\n      });\n    }\n\n    this.logDebug('=================================\\n');\n  }\n}\n\n"]}
+{"version":3,"file":"flows-actors-registry.service.js","sourceRoot":"","sources":["../../../../src/flows-actors/services/flows-actors-registry.service.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport { describeCaughtError } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport {\n  FlowActorSystem,\n  FlowActorSystem_Kind,\n  FlowsActors_Agent,\n  ActorSystem,\n  FlowSystem,\n  isLLMAgentConfiguration,\n  FlowsActors_McpServer,\n  mcpServerDestinationHost,\n  mcpServerTransportIsPlaintext,\n} from '@wildo-ai/saas-models';\nimport {\n  ErrorType,\n  ErrorCustomMessageReference\n} from '@wildo-ai/saas-models';\nimport {\n  FlowsActorsRegistry,\n  FlowActorSystem_InitializationFactoryMap,\n  AgentRegistryIndex\n} from '~wildo-backend-lib/flows-actors/models/flows-actors.backend.schemas';\nimport { resolveModelForApplicability, validateReasoningEffortForModel } from '@wildo-ai/external-connectors-models';\nimport type { FunctionTool } from '~wildo-backend-lib/flows-actors/models/function-tools.backend.definitions';\nimport { flowsActors_Backend_Default_Definition } from '~wildo-backend-lib/flows-actors/models/flows-actors.backend.definitions';\n\n/**\n * FlowsActors Registry Service\n *\n * Central registry for managing flow-actor systems, agents, and their configurations.\n * Similar to ResourcesRegistryBackendService but for flow-actor domain.\n *\n * Features:\n * - Register and retrieve flow systems and actors\n * - Manage agent definitions and capabilities\n * - System validation and lookup\n * - Kind-based filtering and organization\n */\n@injectable()\nexport class FlowsActorsRegistryService {\n\n  private registry: FlowsActorsRegistry;\n  private isInitialized = false;\n  protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService) private readonly errorBuilder: ErrorBuilderBackendService,\n  ) {\n    this.registry = {\n      agents: {},\n      flows: {},\n      actors: {},\n      mcpServers: {},\n      agentRegistryIndex: {\n        agents: {},\n        agentsByProvider: {},\n        agentsByOperation: {},\n      },\n      functionTools: {},\n    };\n\n\n    this.logDebug = this.logger.debugByType('FlowsActorsRegistry');\n    this.logger.setDebugTypeLogging('FlowsActorsRegistry', false);\n\n    this.logDebug('FlowsActors registry service created');\n  }\n\n  // ================================\n  // Initialization\n  // ================================\n\n  /**\n   * Initialize the registry with flow-actor systems and agents\n   * Follows the same pattern as ResourcesRegistryBackendService.initialize()\n   */\n  public async initialize(\n    customBackend_FlowActorSystemsFactoryMap?: FlowActorSystem_InitializationFactoryMap,\n    customBackend_Agents?: FlowsActors_Agent[],\n    customBackend_FunctionTools?: FunctionTool[],\n    customBackend_McpServers?: FlowsActors_McpServer[],\n  ): Promise<void> {\n    if (this.isInitialized) {\n      this.logDebug('Registry already initialized, skipping...');\n      return;\n    }\n\n    const defaultSystemsFactoryMap = flowsActors_Backend_Default_Definition.flowActorSystemsFactoryMap;\n    const defaultAgents = flowsActors_Backend_Default_Definition.agents;\n    const defaultFunctionTools = flowsActors_Backend_Default_Definition.functionTools;\n\n    // Merge default with custom backend (custom takes precedence)\n    const mergedSystemsFactoryMap: FlowActorSystem_InitializationFactoryMap = {\n      ...defaultSystemsFactoryMap,\n      ...customBackend_FlowActorSystemsFactoryMap,\n    };\n\n    const mergedAgents: FlowsActors_Agent[] = [\n      ...defaultAgents,\n      ...(customBackend_Agents || []),\n    ];\n\n    const mergedFunctionTools: FunctionTool[] = [\n      ...defaultFunctionTools,\n      ...(customBackend_FunctionTools || []),\n    ];\n\n    this.logDebug('Initializing flows-actors registry', {\n      defaultSystemsCount: Object.keys(defaultSystemsFactoryMap).length,\n      customBackendSystemsCount: customBackend_FlowActorSystemsFactoryMap ? Object.keys(customBackend_FlowActorSystemsFactoryMap).length : 0,\n      defaultAgentsCount: defaultAgents.length,\n      customBackendAgentsCount: customBackend_Agents?.length || 0,\n    });\n\n\n    for (const [ref, factory] of Object.entries(mergedSystemsFactoryMap)) {\n      try {\n        const system = factory();\n        this.registerSystem(system);\n      } catch (error) {\n        throw this.errorBuilder.buildError( ErrorType.INTERNAL, undefined,\n          { customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE, context: { systemRef: ref, error: describeCaughtError(error) }});\n      }\n    }\n\n\n    for (const agent of mergedAgents) {\n      this.registerAgent(agent);\n    }\n\n    for (const functionTool of mergedFunctionTools) {\n      this.registerFunctionTool(functionTool);\n    }\n\n    for (const mcpServer of customBackend_McpServers ?? []) {\n      this.registerMcpServer(mcpServer);\n    }\n\n    /**\n     * Every agent's `mcpRefs` must name a DECLARED server, checked here rather than in\n     * `registerAgent` because registration order is not guaranteed — an agent may register before\n     * the servers it names, and a per-registration check would refuse a coherent application for\n     * the order its addons happened to load in.\n     */\n    this.assertDeclaredMcpRefs();\n\n    this.isInitialized = true;\n\n    this.logDebug('FlowsActors registry initialization completed', {\n      totalSystems: Object.keys(this.registry.flows).length + Object.keys(this.registry.actors).length,\n      flows: Object.keys(this.registry.flows).length,\n      actors: Object.keys(this.registry.actors).length,\n      agents: Object.keys(this.registry.agents).length,\n    });\n  }\n\n  // ================================\n  // System Registration & Retrieval\n  // ================================\n\n  /**\n   * Register a flow-actor system\n   */\n  public registerSystem(system: FlowActorSystem): void {\n\n    // Captured before the branching so the exhaustiveness arm below can report\n    // WHICH system failed: inside that arm `system` is `never`, and reaching\n    // through a `never` would need exactly the kind of assertion this change\n    // exists to remove.\n    const { ref: systemRef, kind: systemKind } = system;\n\n    if (system.kind === FlowActorSystem_Kind.FLOW) {\n      if (this.registry.flows[system.ref])\n        this.logDebug('Flow already registered, updating...', { ref: system.ref });\n\n      // `FlowActorSystem` is a discriminated union on `kind`, so this assignment\n      // is checked rather than asserted: the branch has already narrowed the\n      // value to `FlowSystem`, which is what the registry bucket stores.\n      this.registry.flows[system.ref] = system;\n\n    } else if (system.kind === FlowActorSystem_Kind.ACTOR) {\n\n      if (this.registry.actors[system.ref])\n        this.logDebug('Actor already registered, updating...', { ref: system.ref });\n\n      this.registry.actors[system.ref] = system;\n\n    } else {\n      /*\n       * Exhaustiveness guard, newly possible because `FlowActorSystem` is a\n       * discriminated union. Before it, an added system kind fell through here\n       * and was dropped SILENTLY — the method returns void and logs \"System\n       * registered\" either way, so the system was simply never resolvable. A\n       * new union member now fails the `never` assignment at COMPILE time.\n       *\n       * The throw covers the runtime residue: this method is public API, so an\n       * untyped or asserted caller can still hand over a system whose kind is\n       * outside the union. Registration failing loudly at startup beats a\n       * registry that reports success and resolves nothing.\n       */\n      const unhandledSystem: never = system;\n      throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {\n        customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,\n        // `unhandledSystem` is carried into the diagnostic on purpose: an\n        // exhaustiveness binding nothing reads looks like dead code, and the\n        // next cleanup deletes the only compile-time guard in this method.\n        // Here it is load-bearing in both directions — the `never` annotation\n        // is the compile-time check, the value is the runtime diagnostic.\n        context: { systemRef, kind: systemKind, unhandledSystem },\n      });\n    }\n\n\n    this.logDebug('System registered', {\n      ref: system.ref,\n      kind: system.kind,\n      displayName: system.displayName\n    });\n  }\n\n  /**\n   * Get a flow-actor system by reference\n   */\n  public getSystem(ref: string, kind: FlowActorSystem_Kind): FlowActorSystem | undefined {\n    if (kind === FlowActorSystem_Kind.FLOW) {\n      return this.registry.flows[ref];\n    } else if (kind === FlowActorSystem_Kind.ACTOR) {\n      return this.registry.actors[ref];\n    }\n    return undefined;\n  }\n\n  /**\n   * Get a flow-actor system or throw error\n   */\n  public getSystemOrThrow(ref: string, kind: FlowActorSystem_Kind): FlowActorSystem {\n    const system = this.getSystem(ref, kind);\n    if (!system) {\n      throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined,\n        { customMessageReference: ErrorCustomMessageReference.NOT_FOUND, context: { systemRef: ref, kind } });\n    }\n    return system;\n  }\n\n  /**\n   * Get all systems of a specific kind\n   */\n  public getSystemsByKind(kind: FlowActorSystem_Kind): FlowActorSystem[] {\n    if(kind === FlowActorSystem_Kind.FLOW) {\n      return this.getFlows();\n    } else if (kind === FlowActorSystem_Kind.ACTOR) {\n      return this.getActors();\n    }\n    return [];\n  }\n\n  /**\n   * Get all flows.\n   *\n   * Returns `FlowSystem[]`, not the union: the kind is fixed by the accessor,\n   * so widening would make every caller re-narrow to reach `steps`/`edges`\n   * even though nothing here can be an actor system — and that re-narrowing\n   * pressure is precisely what produced the assertions this change removed.\n   *\n   * These two accessors, not `getSystemsByKind`, are the typed primitives.\n   * `getSystemsByKind` takes a kind as a RUNTIME VALUE, which no signature can\n   * track without a generic, so it can only ever promise the union; it now\n   * delegates here rather than re-reading the buckets, so the kind→bucket\n   * mapping is stated once.\n   */\n  public getFlows(): FlowSystem[] {\n    return Object.values(this.registry.flows);\n  }\n\n  /**\n   * Get all actors — `ActorSystem[]`, so `.actors` is reachable on each entry\n   * without a cast. See `getFlows`.\n   */\n  public getActors(): ActorSystem[] {\n    return Object.values(this.registry.actors);\n  }\n\n  /**\n   * Check if a system exists\n   */\n  public hasSystem(ref: string, kind: FlowActorSystem_Kind): boolean {\n    if (kind === FlowActorSystem_Kind.FLOW) {\n      return !!this.registry.flows[ref];\n    } else if (kind === FlowActorSystem_Kind.ACTOR) {\n      return !!this.registry.actors[ref];\n    }\n    return false;\n  }\n\n  // ================================\n  // Agent Registration & Retrieval\n  // ================================\n\n  /**\n   * Register an agent.\n   *\n   * Fails CLOSED on a `model × reasoningEffort` pair the target model cannot\n   * honour. Registration is the authoring-time seam: every agent — engine\n   * defaults and app-registered customs alike — funnels through here at\n   * startup, so a bad pair surfaces as a named boot error instead of a provider\n   * 400 thrown deep inside a long agent pipeline (a deliberation can burn\n   * minutes and real money before reaching its first call).\n   *\n   * The canonical trap this catches: `reasoningEffort: NONE` turns reasoning off\n   * on GPT-5.6 and on most of Claude 5, but hard-errors on `claude-fable-5`,\n   * whose thinking cannot be disabled — so the pair's validity depends on the\n   * MODEL, not even on its family, and swapping a model without re-auditing its\n   * reasoning params is exactly how it breaks.\n   *\n   * Validation fails OPEN for unknown/unverified model ids (custom + fine-tuned\n   * deployments are legitimate) — see `validateReasoningEffortForModel`.\n   */\n  public registerAgent(agent: FlowsActors_Agent): void {\n    if (this.registry.agents[agent.ref]) {\n      this.logDebug('Agent already registered, updating...', { ref: agent.ref });\n    }\n\n    /*\n     * What gets REGISTERED may differ from what was AUTHORED (a resolved model id, below), and the\n     * difference lives on a copy. The authored object is never written. Until 2026-09-09 this\n     * method wrote `model` onto the caller's own config object; the dev companion's (since deleted)\n     * startup-composition identity fence caught that as a mutated startup graph and crash-looped\n     * every companion into `CRASH_RESPAWN_EXHAUSTED`. The fence was a survivor of the digest\n     * demolition and went with it, but the registry was the side in the wrong regardless: a\n     * resolver has no business changing its input, and the copy stays.\n     */\n    let registered: FlowsActors_Agent = agent;\n\n    // Only the LLM arm of the config union reasons. Narrowed POSITIVELY: this\n    // was `!isImageAgentConfiguration(...)`, which meant \"the LLM arm\" only\n    // while the union had two members — the coding arm then fell straight into\n    // it and the failure surfaced as a missing `reasoningEffort` property.\n    if (isLLMAgentConfiguration(agent.config)) {\n      /*\n       * Resolve the APPLICABILITY axis into a concrete model id, here and only here (#439).\n       *\n       * An agent declares the KIND of work it does (`modelApplicability`) rather than naming a\n       * model — the standing policy, which embeddings and document extraction already followed and\n       * the agent path did not: `resolveModelForApplicability` had NO production caller anywhere,\n       * and the field its own JSDoc named was declared by no configuration type.\n       *\n       * Registration is the chokepoint because it is where the config stops being authored and\n       * starts being used: everything downstream reads `config.model` off the REGISTRY, so\n       * resolving once here leaves all ~17 consumers untouched and keeps the invariant simple —\n       * **a registered agent always carries a concrete model.** Resolving lazily at call time would\n       * put a failure that belongs at startup inside a paid request.\n       *\n       * FAILS CLOSED, with the resolver's own named failure and the candidates it considered. An\n       * applicability no model of this provider serves is a misconfiguration, and substituting some\n       * other model would be the exact defect the axis exists to remove: the author asked for a\n       * KIND, and quietly handing them a different kind is worse than refusing.\n       */\n      let llmConfig = agent.config;\n      if (llmConfig.modelApplicability !== undefined) {\n        const resolution = resolveModelForApplicability({\n          applicability: llmConfig.modelApplicability,\n          providerRef: llmConfig.providerRef,\n        });\n        if (resolution.resolved === false) {\n          throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined,\n            { customMessageReference: ErrorCustomMessageReference.CONFIGURATION,\n              context: {\n                message: 'Agent declares a model applicability no model of its provider can serve',\n                agentRef: agent.ref,\n                providerRef: llmConfig.providerRef,\n                modelApplicability: llmConfig.modelApplicability,\n                failure: resolution.failure,\n                consideredModels: resolution.consideredModels,\n              } });\n        }\n        // A COPY carrying the resolved id. The spread keeps the `isLLMAgentConfiguration` narrowing\n        // for the reasoning validation immediately below — which must run on the RESOLVED model,\n        // being model-dependent — so nothing here needs to write onto the authored object.\n        llmConfig = { ...llmConfig, model: resolution.model };\n        registered = { ...agent, config: llmConfig };\n      }\n\n      const reasoningViolation = validateReasoningEffortForModel(llmConfig.model, llmConfig.reasoningEffort);\n      if (reasoningViolation) {\n        throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined,\n          { customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,\n            context: { agentRef: agent.ref, model: llmConfig.model, reasoningEffort: llmConfig.reasoningEffort, error: reasoningViolation } });\n      }\n    }\n\n    this.registry.agents[registered.ref] = registered;\n\n    // Create index entries for quick lookup\n    this.registry.agentRegistryIndex.agents[registered.ref] = registered;\n\n    // Index by provider\n    if (!this.registry.agentRegistryIndex.agentsByProvider[registered.config.providerRef]) {\n      this.registry.agentRegistryIndex.agentsByProvider[registered.config.providerRef] = [];\n    }\n    this.registry.agentRegistryIndex.agentsByProvider[registered.config.providerRef].push(registered);\n\n    // Index by operation\n    if (!this.registry.agentRegistryIndex.agentsByOperation[registered.config.operationKey]) {\n      this.registry.agentRegistryIndex.agentsByOperation[registered.config.operationKey] = [];\n    }\n    this.registry.agentRegistryIndex.agentsByOperation[registered.config.operationKey].push(registered);\n\n    this.logDebug('Agent registered', {\n      ref: registered.ref,\n      displayName: registered.displayName,\n      operationKey: registered.config.operationKey,\n      providerRef: registered.config.providerRef\n    });\n  }\n\n  /**\n   * Get an agent by reference\n   */\n  public getAgent(ref: string): FlowsActors_Agent | undefined {\n    return this.registry.agents[ref];\n  }\n\n  /**\n   * Get an agent or throw error\n   */\n  public getAgentOrThrow(ref: string): FlowsActors_Agent {\n    const agent = this.getAgent(ref);\n\n    if (!agent) {\n      throw this.errorBuilder.buildError( ErrorType.NOT_FOUND, undefined,\n        {customMessageReference: ErrorCustomMessageReference.NOT_FOUND,context: { agentRef: ref } });\n    }\n    return agent;\n  }\n\n  /**\n   * Get agents by provider\n   */\n  public getAgentsByProvider(providerRef: string): FlowsActors_Agent[] {\n    return this.registry.agentRegistryIndex.agentsByProvider[providerRef] || [];\n  }\n\n  /**\n   * Get agents by operation key\n   */\n  public getAgentsByOperation(operationKey: string): FlowsActors_Agent[] {\n    return this.registry.agentRegistryIndex.agentsByOperation[operationKey] || [];\n  }\n\n  /**\n   * Check if an agent exists\n   */\n  public hasAgent(ref: string): boolean {\n    return !!this.registry.agents[ref];\n  }\n\n  // ================================\n  // Function Tools\n  // ================================\n\n  /**\n   * Register an executable function tool, indexed by its `functionRef`. Agents\n   * reference it via `capabilities.tools.functionRefs`; `AgentsBackendService`\n   * resolves it into an AI-SDK tool at invocation time.\n   */\n  public registerFunctionTool(functionTool: FunctionTool): void {\n    this.registry.functionTools[functionTool.functionRef] = functionTool;\n    this.logDebug('Registered function tool', { functionRef: functionTool.functionRef });\n  }\n\n  /** Get a function tool by ref. */\n  public getFunctionTool(ref: string): FunctionTool | undefined {\n    return this.registry.functionTools[ref];\n  }\n\n  /** Get a function tool or throw NOT_FOUND. */\n  public getFunctionToolOrThrow(ref: string): FunctionTool {\n    const functionTool = this.getFunctionTool(ref);\n    if (!functionTool) {\n      throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined,\n        { customMessageReference: ErrorCustomMessageReference.NOT_FOUND, context: { functionRef: ref } });\n    }\n    return functionTool;\n  }\n\n  /** Check if a function tool exists. */\n  public hasFunctionTool(ref: string): boolean {\n    return !!this.registry.functionTools[ref];\n  }\n\n  // ================================\n  // MCP Server Registration & Retrieval\n  // ================================\n\n  /**\n   * Register an MCP server the application permits its agents to reach, indexed by the ref an\n   * agent's `capabilities.tools.mcpRefs` names (#491).\n   *\n   * REFUSES a plaintext endpoint. An MCP call carries a delegated credential to a third party, so\n   * `http://` would put a bearer token on the wire in clear — and unlike the webhook lane, where a\n   * plaintext endpoint is the operator's own declared destination and is reported rather than\n   * blocked, nothing here is the application's to expose on someone else's behalf.\n   */\n  public registerMcpServer(mcpServer: FlowsActors_McpServer): void {\n    if (mcpServerTransportIsPlaintext(mcpServer.url)) {\n      throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {\n        customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,\n        context: {\n          mcpServerRef: mcpServer.ref,\n          destinationHost: mcpServerDestinationHost(mcpServer.url),\n          reason: 'mcp_server_endpoint_is_plaintext',\n        },\n      });\n    }\n    this.registry.mcpServers[mcpServer.ref] = mcpServer;\n    this.logDebug('Registered MCP server', {\n      ref: mcpServer.ref,\n      transport: mcpServer.transport,\n      destinationHost: mcpServerDestinationHost(mcpServer.url),\n    });\n  }\n\n  /** Get a declared MCP server by ref. */\n  public getMcpServer(ref: string): FlowsActors_McpServer | undefined {\n    return this.registry.mcpServers[ref];\n  }\n\n  /** Check if an MCP server is declared. */\n  public hasMcpServer(ref: string): boolean {\n    return !!this.registry.mcpServers[ref];\n  }\n\n  /**\n   * Refuse an agent whose `mcpRefs` name a server the application never declared.\n   *\n   * FAIL-CLOSED, and deliberately stricter than `functionRefs`, which skip an unknown ref with a\n   * debug line. The asymmetry has a measured reason: an unknown `functionRef` costs an agent one\n   * tool, while `mcpRefs` were RENDERED to a person as a capability, and every ref that ever\n   * existed — `filesystem-mcp`, `git-mcp`, `browser-mcp`, `mongodb-mcp` — named no server anywhere,\n   * because the field could be authored against nothing (#491). A refusal is what makes that state\n   * unreachable rather than merely fixed once.\n   *\n   * The engine's own law, measured at `start-application.backend.service.ts`: a declaration gets\n   * made if and only if the framework refuses to start without it.\n   */\n  private assertDeclaredMcpRefs(): void {\n    const undeclared: { agentRef: string; mcpRef: string }[] = [];\n    for (const agent of Object.values(this.registry.agents)) {\n      for (const mcpRef of agent.capabilities?.tools?.mcpRefs ?? []) {\n        if (!this.hasMcpServer(mcpRef)) undeclared.push({ agentRef: agent.ref, mcpRef });\n      }\n    }\n    if (undeclared.length === 0) return;\n    throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {\n      customMessageReference: ErrorCustomMessageReference.INFRASTRUCTURE,\n      context: {\n        reason: 'agent_mcp_ref_names_no_declared_server',\n        undeclared,\n        declaredMcpServerRefs: Object.keys(this.registry.mcpServers),\n      },\n    });\n  }\n\n  // ================================\n  // Registry Access\n  // ================================\n\n  /**\n   * Get the complete registry\n   */\n  public getRegistry(): FlowsActorsRegistry {\n    return this.registry;\n  }\n\n  /**\n   * Get the agent registry index\n   */\n  public getAgentRegistryIndex(): AgentRegistryIndex {\n    return this.registry.agentRegistryIndex;\n  }\n\n  // ================================\n  // Debug Methods\n  // ================================\n\n  public getDebugInfo(): {\n    isInitialized: boolean;\n    totalSystems: number;\n    flowsCount: number;\n    actorsCount: number;\n    agentsCount: number;\n    systemRefs: string[];\n    agentRefs: string[];\n  } {\n    return {\n      isInitialized: this.isInitialized,\n      totalSystems: Object.keys(this.registry.flows).length + Object.keys(this.registry.actors).length,\n      flowsCount: Object.keys(this.registry.flows).length,\n      actorsCount: Object.keys(this.registry.actors).length,\n      agentsCount: Object.keys(this.registry.agents).length,\n      systemRefs: Object.keys(this.registry.flows).concat(Object.keys(this.registry.actors)),\n      agentRefs: Object.keys(this.registry.agents),\n    };\n  }\n\n  public displayRegistryInfo(): void {\n    this.logDebug('\\n=== 🤖 FLOWS-ACTORS REGISTRY SUMMARY ===\\n');\n\n    const info = this.getDebugInfo();\n\n    this.logDebug(`📊 STATISTICS:`);\n    this.logDebug(`   Total Systems: ${info.totalSystems}`);\n    this.logDebug(`   Flows: ${info.flowsCount}`);\n    this.logDebug(`   Actors: ${info.actorsCount}`);\n    this.logDebug(`   Agents: ${info.agentsCount}`);\n    this.logDebug(`   Initialized: ${info.isInitialized}`);\n\n    if (info.systemRefs.length > 0) {\n      this.logDebug('\\n🔄 REGISTERED SYSTEMS:');\n      info.systemRefs.forEach(ref => {\n        const system = this.registry.flows[ref];\n        this.logDebug(`   - ${ref} (${system.kind}): ${system.displayName}`);\n      });\n    }\n\n    if (info.agentRefs.length > 0) {\n      this.logDebug('\\n🤖 REGISTERED AGENTS:');\n      info.agentRefs.forEach(ref => {\n        const agent = this.registry.agentRegistryIndex.agents[ref];\n        this.logDebug(`   - ${ref}: ${agent.displayName} [${agent.config.providerRef}/${agent.config.operationKey}]`);\n      });\n    }\n\n    this.logDebug('=================================\\n');\n  }\n}\n\n"]}

package/dist/esm/flows-actors/services/flows.backend.services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows.backend.services.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/services/flows.backend.services.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAYhE,OAAO,EACL,UAAU,EACV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,qBACa,mBAAmB;IAKO,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa;IANjF,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;gBAG3B,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,0BAA0B,EACjC,mBAAmB,EAAE,0BAA0B,EACrD,aAAa,EAAE,oBAAoB;IAYvG;;;OAGG;IACU,WAAW,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4BxF;;OAEG;YACW,gBAAgB;IAsC9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACI,iBAAiB,IAAI,UAAU,EAAE;IAMxC;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQvD;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAmB3C,YAAY,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;CAUF"}
+{"version":3,"file":"flows.backend.services.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/services/flows.backend.services.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAWhE,OAAO,EACL,UAAU,EACV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,qBACa,mBAAmB;IAKO,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa;IANjF,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;gBAG3B,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,0BAA0B,EACjC,mBAAmB,EAAE,0BAA0B,EACrD,aAAa,EAAE,oBAAoB;IAYvG;;;OAGG;IACU,WAAW,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4BxF;;OAEG;YACW,gBAAgB;IA6C9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACI,iBAAiB,IAAI,UAAU,EAAE;IAMxC;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQvD;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAmB3C,YAAY,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;CAUF"}

package/dist/esm/flows-actors/services/flows.backend.services.js

@@ -17,7 +17,7 @@ import { LoggerService } from '../../monitoring/logger/services/logger.service.j
 import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
 import { FlowsActorsRegistryService } from './flows-actors-registry.service.js';
 import { AgentsBackendService } from './agents.backend.service.js';
-import { FlowActorSystem_Kind, FlowActorSystem_Status, FlowsActors_Status, } from '@wildo-ai/saas-models';
+import { FlowActorSystem_Kind, FlowActorSystem_Status, } from '@wildo-ai/saas-models';
 import { ErrorType, ErrorCustomMessageReference } from '@wildo-ai/saas-models';
 /**
  * Flows Backend Service
@@ -84,28 +84,32 @@ let FlowsBackendService = class FlowsBackendService {
             flowRef: flow.ref,
             executionId: execution._id
         });
-        // TODO: Implement actual flow step execution
-        // This will involve:
-        // 1. Parsing flow configuration
-        // 2. Executing steps in order
-        // 3. Handling agent calls
-        // 4. Managing data flow between steps
-        // 5. Error handling and checkpoints
-        // 6. Updating nodeStates as steps complete
-        // For now, update execution status
-        return {
-            ...execution,
-            status: FlowsActors_Status.COMPLETED,
-            finishedAt: new Date().toISOString(),
-            updatedAt: new Date().toISOString(),
-            statusChanges: [
-                ...execution.statusChanges,
-                {
-                    status: FlowsActors_Status.COMPLETED,
-                    timestamp: new Date().toISOString(),
-                },
-            ],
-        };
+        /*
+         * Step execution is not built. It refuses rather than reporting success.
+         *
+         * This returned the execution stamped COMPLETED with a finish timestamp, having run nothing:
+         * no step parsed, no agent called, no data moved between steps, no node state touched. A
+         * caller could not tell that apart from a flow that genuinely ran, and neither could a stored
+         * record afterwards, so the absence would have been discovered as a flow that "worked" and
+         * produced nothing.
+         *
+         * Refusing is safe here and would not have been once callers exist: nothing in the engine, the
+         * platform or either dogfood application calls `executeFlow` today. The actor lane is the one
+         * that runs; the flow lane is declared and unbuilt.
+         *
+         * What is still owed, kept from the original note: parse the flow configuration, execute steps
+         * in order, handle agent calls, move data between steps, checkpoint and handle errors, and
+         * update `nodeStates` as steps complete.
+         */
+        throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+            customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+            context: {
+                // diagnostic (log-only)
+                message: 'Flow step execution is not implemented; no step was run and no status was advanced.',
+                flowRef: flow.ref,
+                executionId: execution._id,
+            },
+        });
     }
     // ================================
     // Flow Validation

package/dist/esm/flows-actors/services/flows.backend.services.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows.backend.services.js","sourceRoot":"","sources":["../../../../../src/flows-actors/services/flows.backend.services.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport { FlowsActorsRegistryService } from './flows-actors-registry.service';\nimport { AgentsBackendService } from './agents.backend.service';\nimport {\n  FlowActorSystem,\n  FlowActorSystem_Kind,\n  FlowActorSystem_Status,\n  FlowsActors_Status,\n  Flow_Node_RelationshipSchema,\n} from '@wildo-ai/saas-models';\nimport {\n  ErrorType,\n  ErrorCustomMessageReference\n} from '@wildo-ai/saas-models';\nimport {\n  FlowSystem,\n  FlowSystem_Execution,\n} from '@wildo-ai/saas-models';\n\n/**\n * Flows Backend Service\n *\n * Manages flow execution and orchestration.\n * Coordinates step execution, agent invocations, and data flow.\n *\n * Features:\n * - Flow execution management\n * - Step orchestration\n * - Agent coordination\n * - Data flow and transformation\n * - Error handling and recovery\n * - Checkpoint management\n */\n@injectable()\nexport class FlowsBackendService {\n\n  protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService) private readonly errorBuilder: ErrorBuilderBackendService,\n    @inject(SAAS_SERVICE_TYPES.FlowsActorsRegistryService) private readonly flowsActorsRegistry: FlowsActorsRegistryService,\n    @inject(SAAS_SERVICE_TYPES.AgentsBackendService) private readonly agentsService: AgentsBackendService,\n  ) {\n    this.logDebug = this.logger.debugByType('FlowsBackend');\n    this.logger.setDebugTypeLogging('FlowsBackend', true);\n\n    this.logDebug('Flows backend service created');\n  }\n\n  // ================================\n  // Flow Execution\n  // ================================\n\n  /**\n   * Execute a flow\n   * Accepts FlowSystem_Execution and executes it\n   */\n  public async executeFlow(execution: FlowSystem_Execution): Promise<FlowSystem_Execution> {\n    this.logDebug('Executing flow', {\n      flowRef: execution.systemRef,\n      executionId: execution._id,\n      hasInitiator: !!execution.initiator\n    });\n\n    // Get flow from registry\n    const flow = this.flowsActorsRegistry.getSystemOrThrow(execution.systemRef, FlowActorSystem_Kind.FLOW);\n\n    // Validate it's a flow\n    this.validateIsFlow(flow);\n\n    // Validate flow status\n    this.validateFlowStatus(flow);\n\n    // Execute flow steps\n    const updatedExecution = await this.executeFlowSteps(flow, execution);\n\n    this.logDebug('Flow execution completed', {\n      flowRef: execution.systemRef,\n      executionId: updatedExecution._id || 'unknown',\n      status: updatedExecution.status\n    });\n\n    return updatedExecution;\n  }\n\n  /**\n   * Execute flow steps\n   */\n  private async executeFlowSteps(\n    flow: FlowActorSystem,\n    execution: FlowSystem_Execution\n  ): Promise<FlowSystem_Execution> {\n    this.logDebug('Executing flow steps', {\n      flowRef: flow.ref,\n      executionId: execution._id\n    });\n\n    // TODO: Implement actual flow step execution\n    // This will involve:\n    // 1. Parsing flow configuration\n    // 2. Executing steps in order\n    // 3. Handling agent calls\n    // 4. Managing data flow between steps\n    // 5. Error handling and checkpoints\n    // 6. Updating nodeStates as steps complete\n\n    // For now, update execution status\n    return {\n      ...execution,\n      status: FlowsActors_Status.COMPLETED,\n      finishedAt: new Date().toISOString(),\n      updatedAt: new Date().toISOString(),\n      statusChanges: [\n        ...execution.statusChanges,\n        {\n          status: FlowsActors_Status.COMPLETED,\n          timestamp: new Date().toISOString(),\n        },\n      ],\n    };\n  }\n\n  // ================================\n  // Flow Validation\n  // ================================\n\n  /**\n   * Validate system is a flow\n   */\n  private validateIsFlow(system: FlowActorSystem): void {\n    if (system.kind !== FlowActorSystem_Kind.FLOW) {\n      throw this.errorBuilder.buildError(\n        ErrorType.VALIDATION,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.FLOW_INVALID_KIND,\n          context: {\n            // diagnostic (log-only)\n            systemRef: system.ref,\n            kind: system.kind,\n          }\n        }\n      );\n    }\n  }\n\n  /**\n   * Validate flow status before execution\n   */\n  private validateFlowStatus(flow: FlowActorSystem): void {\n    if (flow.status !== FlowActorSystem_Status.ACTIVE) {\n      throw this.errorBuilder.buildError(\n        ErrorType.VALIDATION,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.FLOW_NOT_ACTIVE,\n          context: {\n            // diagnostic (log-only)\n            flowRef: flow.ref,\n            status: flow.status,\n          }\n        }\n      );\n    }\n  }\n\n  // ================================\n  // Execution Context Management\n  // ================================\n\n\n  // ================================\n  // Flow Discovery\n  // ================================\n\n  /**\n   * Get all available flows\n   */\n  public getAvailableFlows(): FlowSystem[] {\n    return this.flowsActorsRegistry.getFlows().filter(\n      flow => flow.status === FlowActorSystem_Status.ACTIVE\n    );\n  }\n\n  /**\n   * Get flow by reference\n   */\n  public getFlow(flowRef: string): FlowSystem | undefined {\n    const system = this.flowsActorsRegistry.getSystem(flowRef, FlowActorSystem_Kind.FLOW);\n    if (system && system.kind === FlowActorSystem_Kind.FLOW) {\n      return system;\n    }\n    return undefined;\n  }\n\n  /**\n   * Get flow or throw\n   */\n  public getFlowOrThrow(flowRef: string): FlowSystem {\n    const flow = this.getFlow(flowRef);\n    if (!flow) {\n      throw this.errorBuilder.buildError(\n        ErrorType.NOT_FOUND,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.NOT_FOUND,\n          context: { flowRef }\n        }\n      );\n    }\n    return flow;\n  }\n\n  // ================================\n  // Debug Methods\n  // ================================\n\n  public getDebugInfo(): {\n    totalFlows: number;\n    activeFlows: number;\n    flowRefs: string[];\n  } {\n    const allFlows = this.flowsActorsRegistry.getFlows();\n    const activeFlows = allFlows.filter(f => f.status === FlowActorSystem_Status.ACTIVE);\n\n    return {\n      totalFlows: allFlows.length,\n      activeFlows: activeFlows.length,\n      flowRefs: allFlows.map(f => f.ref),\n    };\n  }\n}\n\n"]}
+{"version":3,"file":"flows.backend.services.js","sourceRoot":"","sources":["../../../../src/flows-actors/services/flows.backend.services.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport { FlowsActorsRegistryService } from './flows-actors-registry.service';\nimport { AgentsBackendService } from './agents.backend.service';\nimport {\n  FlowActorSystem,\n  FlowActorSystem_Kind,\n  FlowActorSystem_Status,\n  Flow_Node_RelationshipSchema,\n} from '@wildo-ai/saas-models';\nimport {\n  ErrorType,\n  ErrorCustomMessageReference\n} from '@wildo-ai/saas-models';\nimport {\n  FlowSystem,\n  FlowSystem_Execution,\n} from '@wildo-ai/saas-models';\n\n/**\n * Flows Backend Service\n *\n * Manages flow execution and orchestration.\n * Coordinates step execution, agent invocations, and data flow.\n *\n * Features:\n * - Flow execution management\n * - Step orchestration\n * - Agent coordination\n * - Data flow and transformation\n * - Error handling and recovery\n * - Checkpoint management\n */\n@injectable()\nexport class FlowsBackendService {\n\n  protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService) private readonly errorBuilder: ErrorBuilderBackendService,\n    @inject(SAAS_SERVICE_TYPES.FlowsActorsRegistryService) private readonly flowsActorsRegistry: FlowsActorsRegistryService,\n    @inject(SAAS_SERVICE_TYPES.AgentsBackendService) private readonly agentsService: AgentsBackendService,\n  ) {\n    this.logDebug = this.logger.debugByType('FlowsBackend');\n    this.logger.setDebugTypeLogging('FlowsBackend', true);\n\n    this.logDebug('Flows backend service created');\n  }\n\n  // ================================\n  // Flow Execution\n  // ================================\n\n  /**\n   * Execute a flow\n   * Accepts FlowSystem_Execution and executes it\n   */\n  public async executeFlow(execution: FlowSystem_Execution): Promise<FlowSystem_Execution> {\n    this.logDebug('Executing flow', {\n      flowRef: execution.systemRef,\n      executionId: execution._id,\n      hasInitiator: !!execution.initiator\n    });\n\n    // Get flow from registry\n    const flow = this.flowsActorsRegistry.getSystemOrThrow(execution.systemRef, FlowActorSystem_Kind.FLOW);\n\n    // Validate it's a flow\n    this.validateIsFlow(flow);\n\n    // Validate flow status\n    this.validateFlowStatus(flow);\n\n    // Execute flow steps\n    const updatedExecution = await this.executeFlowSteps(flow, execution);\n\n    this.logDebug('Flow execution completed', {\n      flowRef: execution.systemRef,\n      executionId: updatedExecution._id || 'unknown',\n      status: updatedExecution.status\n    });\n\n    return updatedExecution;\n  }\n\n  /**\n   * Execute flow steps\n   */\n  private async executeFlowSteps(\n    flow: FlowActorSystem,\n    execution: FlowSystem_Execution\n  ): Promise<FlowSystem_Execution> {\n    this.logDebug('Executing flow steps', {\n      flowRef: flow.ref,\n      executionId: execution._id\n    });\n\n    /*\n     * Step execution is not built. It refuses rather than reporting success.\n     *\n     * This returned the execution stamped COMPLETED with a finish timestamp, having run nothing:\n     * no step parsed, no agent called, no data moved between steps, no node state touched. A\n     * caller could not tell that apart from a flow that genuinely ran, and neither could a stored\n     * record afterwards, so the absence would have been discovered as a flow that \"worked\" and\n     * produced nothing.\n     *\n     * Refusing is safe here and would not have been once callers exist: nothing in the engine, the\n     * platform or either dogfood application calls `executeFlow` today. The actor lane is the one\n     * that runs; the flow lane is declared and unbuilt.\n     *\n     * What is still owed, kept from the original note: parse the flow configuration, execute steps\n     * in order, handle agent calls, move data between steps, checkpoint and handle errors, and\n     * update `nodeStates` as steps complete.\n     */\n    throw this.errorBuilder.buildError(\n      ErrorType.CONFIGURATION,\n      undefined,\n      {\n        customMessageReference: ErrorCustomMessageReference.CONFIGURATION,\n        context: {\n          // diagnostic (log-only)\n          message: 'Flow step execution is not implemented; no step was run and no status was advanced.',\n          flowRef: flow.ref,\n          executionId: execution._id,\n        },\n      },\n    );\n  }\n\n  // ================================\n  // Flow Validation\n  // ================================\n\n  /**\n   * Validate system is a flow\n   */\n  private validateIsFlow(system: FlowActorSystem): void {\n    if (system.kind !== FlowActorSystem_Kind.FLOW) {\n      throw this.errorBuilder.buildError(\n        ErrorType.VALIDATION,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.FLOW_INVALID_KIND,\n          context: {\n            // diagnostic (log-only)\n            systemRef: system.ref,\n            kind: system.kind,\n          }\n        }\n      );\n    }\n  }\n\n  /**\n   * Validate flow status before execution\n   */\n  private validateFlowStatus(flow: FlowActorSystem): void {\n    if (flow.status !== FlowActorSystem_Status.ACTIVE) {\n      throw this.errorBuilder.buildError(\n        ErrorType.VALIDATION,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.FLOW_NOT_ACTIVE,\n          context: {\n            // diagnostic (log-only)\n            flowRef: flow.ref,\n            status: flow.status,\n          }\n        }\n      );\n    }\n  }\n\n  // ================================\n  // Execution Context Management\n  // ================================\n\n\n  // ================================\n  // Flow Discovery\n  // ================================\n\n  /**\n   * Get all available flows\n   */\n  public getAvailableFlows(): FlowSystem[] {\n    return this.flowsActorsRegistry.getFlows().filter(\n      flow => flow.status === FlowActorSystem_Status.ACTIVE\n    );\n  }\n\n  /**\n   * Get flow by reference\n   */\n  public getFlow(flowRef: string): FlowSystem | undefined {\n    const system = this.flowsActorsRegistry.getSystem(flowRef, FlowActorSystem_Kind.FLOW);\n    if (system && system.kind === FlowActorSystem_Kind.FLOW) {\n      return system;\n    }\n    return undefined;\n  }\n\n  /**\n   * Get flow or throw\n   */\n  public getFlowOrThrow(flowRef: string): FlowSystem {\n    const flow = this.getFlow(flowRef);\n    if (!flow) {\n      throw this.errorBuilder.buildError(\n        ErrorType.NOT_FOUND,\n        undefined,\n        {\n          customMessageReference: ErrorCustomMessageReference.NOT_FOUND,\n          context: { flowRef }\n        }\n      );\n    }\n    return flow;\n  }\n\n  // ================================\n  // Debug Methods\n  // ================================\n\n  public getDebugInfo(): {\n    totalFlows: number;\n    activeFlows: number;\n    flowRefs: string[];\n  } {\n    const allFlows = this.flowsActorsRegistry.getFlows();\n    const activeFlows = allFlows.filter(f => f.status === FlowActorSystem_Status.ACTIVE);\n\n    return {\n      totalFlows: allFlows.length,\n      activeFlows: activeFlows.length,\n      flowRefs: allFlows.map(f => f.ref),\n    };\n  }\n}\n\n"]}

package/dist/esm/flows-actors/services/llm-observability-agent-call-trace-sink.backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-observability-agent-call-trace-sink.backend.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/services/llm-observability-agent-call-trace-sink.backend.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGxF,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,4FAA4F,CAAC;AAC1J,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,0FAA0F,CAAC;AAEtJ;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,kCAAmC,YAAW,kBAAkB;IAMzE,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAE1C,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IAP1C,yGAAyG;IACzG,OAAO,CAAC,YAAY,CAAoD;gBAIrD,yBAAyB,EAAE,uCAAuC,EAElE,uBAAuB,EAAE,qCAAqC;IAGjF;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAkCtB;;;;OAIG;IACI,QAAQ,IAAI,OAAO;IAInB,eAAe,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,QAAQ,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxC"}
+{"version":3,"file":"llm-observability-agent-call-trace-sink.backend.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/services/llm-observability-agent-call-trace-sink.backend.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AASxF,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,4FAA4F,CAAC;AAC1J,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,0FAA0F,CAAC;AAEtJ;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,kCAAmC,YAAW,kBAAkB;IAMzE,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAE1C,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IAP1C,yGAAyG;IACzG,OAAO,CAAC,YAAY,CAAoD;gBAIrD,yBAAyB,EAAE,uCAAuC,EAElE,uBAAuB,EAAE,qCAAqC;IAGjF;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAkCtB;;;;OAIG;IACI,QAAQ,IAAI,OAAO;IAInB,eAAe,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,QAAQ,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxC"}

package/dist/esm/flows-actors/services/llm-observability-agent-call-trace-sink.backend.js

@@ -12,7 +12,13 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'inversify';
 import { EngineCapability } from '@wildo-ai/saas-models';
-import { buildLlmObservabilitySinkFromModule } from '@wildo-ai/external-connectors-private/backend';
+/*
+ * `/backend-runtime`, not `/backend` (#330). The two barrels expose the same builder; `/backend` also
+ * re-exports the engine's EAGERLY composed provider catalogue, and ES module semantics mean that one
+ * value import evaluates all twenty-two provider modules — six of them pulling an `@ai-sdk/*` client
+ * — into whatever process imports this file. This file is in every backend's boot graph.
+ */
+import { buildLlmObservabilitySinkFromModule } from '@wildo-ai/external-connectors-private/backend-runtime';
 import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
 /**
  * Engine-side `AgentCallTraceSink` that resolves its concrete provider sink (e.g.

package/dist/esm/flows-actors/services/llm-observability-agent-call-trace-sink.backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-observability-agent-call-trace-sink.backend.js","sourceRoot":"","sources":["../../../../../src/flows-actors/services/llm-observability-agent-call-trace-sink.backend.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mCAAmC,EAAE,MAAM,+CAA+C,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAIpF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,kCAAkC,GAAxC,MAAM,kCAAkC;IAM1B;IAEA;IAPnB,yGAAyG;IACjG,YAAY,GAA0C,SAAS,CAAC;IAExE,YAEmB,yBAAkE,EAElE,uBAA8D;QAF9D,8BAAyB,GAAzB,yBAAyB,CAAyC;QAElE,4BAAuB,GAAvB,uBAAuB,CAAuC;IAC9E,CAAC;IAEJ;;;;;;OAMG;IACK,cAAc;QACpB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,yBAAyB,CAAC,qCAAqC,CACtF,gBAAgB,CAAC,iBAAiB,CACnC,CAAC;YACF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,YAAY,GAAG,mCAAmC,CACrD,MAAM,EACN;gBACE,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,MAAM;gBACpE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;oBAC/C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;oBAC/C,CAAC,CAAC,SAAS;aACd,EACD,OAAO,CACR,IAAI,IAAI,CAAC;YACV,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,CAAC;IACxC,CAAC;IAEM,eAAe,CAAC,QAAgC;QACrD,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAEM,QAAQ;QACb,kFAAkF;QAClF,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,CAAC;CACF,CAAA;AArEY,kCAAkC;IAD9C,UAAU,EAAE;IAMR,WAAA,MAAM,CAAC,kBAAkB,CAAC,gCAAgC,CAAC,CAAA;IAE3D,WAAA,MAAM,CAAC,kBAAkB,CAAC,8BAA8B,CAAC,CAAA;;GAPjD,kCAAkC,CAqE9C","sourcesContent":["import { injectable, inject } from 'inversify';\nimport { EngineCapability } from '@wildo-ai/saas-models';\nimport type { AgentCallTraceSink, AgentCallTraceEmission } from '@wildo-ai/saas-models';\nimport { buildLlmObservabilitySinkFromModule } from '@wildo-ai/external-connectors-private/backend';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { ExternalProvidersRegistryBackendService } from '~wildo-backend-lib/external-providers/services/external-providers-registry.backend.service';\nimport type { BackendProviderRegistryBackendService } from '~wildo-backend-lib/external-providers/services/backend-provider-registry.backend.service';\n\n/**\n * Engine-side `AgentCallTraceSink` that resolves its concrete provider sink (e.g.\n * PostHog) LAZILY, honouring the app's `defineSaaSProviders` selection for\n * `EngineCapability.LLM_OBSERVABILITY`.\n *\n * **Why lazy, not eager.** The selection-aware registry\n * ({@link ExternalProvidersRegistryBackendService}) only knows the chosen provider\n * AFTER it is `initialize()`-d, which happens during the startup sequence — well\n * after the DI container is built. Two consumers also cache their sink reference at\n * construction: `AgentsBackendService` (`@optional()`-injects it once) and the dev\n * companion (composes it into a `CompositeAgentCallTraceSink` at companion-container\n * build, BEFORE the registry is initialized). A post-init `rebind` would therefore\n * be invisible to both. So this object is bound EAGERLY (a stable reference both can\n * hold) but defers the actual provider resolution to the first `recordAgentCall` /\n * `isActive()` — by which point (an actual agent call) the registry is initialized.\n * This mirrors `EmailBackendService`, which injects the same registry and resolves\n * its provider per-send.\n *\n * **Resolution.** `getPrimaryProviderForEngineCapability(LLM_OBSERVABILITY)` returns\n * the app's selected provider ref (respecting the active backend/companion scope,\n * the `selection[...].primary`, and capability-enabled gating); the provider MODULE\n * (with its `agentCallTraceSinkFactory`) is then fetched from the\n * {@link BackendProviderRegistryBackendService} and constructed by\n * {@link buildLlmObservabilitySinkFromModule} (which owns secret resolution). No\n * provider selected, or its secret absent → this stays a no-op (no I/O), so output\n * is byte-identical when LLM-obs is off.\n */\n@injectable()\nexport class LlmObservabilityAgentCallTraceSink implements AgentCallTraceSink {\n  /** `undefined` = not yet resolved; `null` = resolved to \"no active provider\"; else the provider sink. */\n  private resolvedSink: AgentCallTraceSink | null | undefined = undefined;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.ExternalProvidersRegistryService)\n    private readonly externalProvidersRegistry: ExternalProvidersRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.BackendProviderRegistryService)\n    private readonly backendProviderRegistry: BackendProviderRegistryBackendService,\n  ) {}\n\n  /**\n   * Resolve (once) the concrete provider sink from the app's LLM-obs selection.\n   * Caches the result — including the `null` \"no provider\" verdict. If the registry\n   * is not yet initialized (a resolution attempted before startup completes), the\n   * attempt is NOT cached so a later call retries; in practice the first call is an\n   * actual agent invocation, long after init.\n   */\n  private ensureResolved(): AgentCallTraceSink | null {\n    if (this.resolvedSink !== undefined) {\n      return this.resolvedSink;\n    }\n    try {\n      const providerRef = this.externalProvidersRegistry.getPrimaryProviderForEngineCapability(\n        EngineCapability.LLM_OBSERVABILITY,\n      );\n      if (!providerRef) {\n        this.resolvedSink = null;\n        return null;\n      }\n      const module = this.backendProviderRegistry.getProvider(providerRef);\n      if (!module) {\n        this.resolvedSink = null;\n        return null;\n      }\n      this.resolvedSink = buildLlmObservabilitySinkFromModule(\n        module,\n        {\n          captureContent: process.env.WILDO_LLM_OBS_CAPTURE_CONTENT === 'true',\n          sampleRate: process.env.WILDO_LLM_OBS_SAMPLE_RATE\n            ? Number(process.env.WILDO_LLM_OBS_SAMPLE_RATE)\n            : undefined,\n        },\n        console,\n      ) ?? null;\n      return this.resolvedSink;\n    } catch {\n      // Registry not yet initialized — stay unresolved, retry on the next call.\n      return null;\n    }\n  }\n\n  /**\n   * Whether an LLM-observability provider is selected + configured. Drives the\n   * engine `AgentTraceabilityPolicy` level (active → DEBUG, inactive → NONE) so a\n   * backend with no LLM-obs provider keeps the byte-identical NONE-skip.\n   */\n  public isActive(): boolean {\n    return this.ensureResolved() !== null;\n  }\n\n  public recordAgentCall(emission: AgentCallTraceEmission): void | Promise<void> {\n    return this.ensureResolved()?.recordAgentCall(emission);\n  }\n\n  public shutdown(): void | Promise<void> {\n    // Flush only an already-resolved real sink; never trigger resolution on shutdown.\n    return this.resolvedSink ? this.resolvedSink.shutdown?.() : undefined;\n  }\n}\n"]}
+{"version":3,"file":"llm-observability-agent-call-trace-sink.backend.js","sourceRoot":"","sources":["../../../../src/flows-actors/services/llm-observability-agent-call-trace-sink.backend.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;GAKG;AACH,OAAO,EAAE,mCAAmC,EAAE,MAAM,uDAAuD,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAIpF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,kCAAkC,GAAxC,MAAM,kCAAkC;IAM1B;IAEA;IAPnB,yGAAyG;IACjG,YAAY,GAA0C,SAAS,CAAC;IAExE,YAEmB,yBAAkE,EAElE,uBAA8D;QAF9D,8BAAyB,GAAzB,yBAAyB,CAAyC;QAElE,4BAAuB,GAAvB,uBAAuB,CAAuC;IAC9E,CAAC;IAEJ;;;;;;OAMG;IACK,cAAc;QACpB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,yBAAyB,CAAC,qCAAqC,CACtF,gBAAgB,CAAC,iBAAiB,CACnC,CAAC;YACF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,YAAY,GAAG,mCAAmC,CACrD,MAAM,EACN;gBACE,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,MAAM;gBACpE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;oBAC/C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;oBAC/C,CAAC,CAAC,SAAS;aACd,EACD,OAAO,CACR,IAAI,IAAI,CAAC;YACV,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,CAAC;IACxC,CAAC;IAEM,eAAe,CAAC,QAAgC;QACrD,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAEM,QAAQ;QACb,kFAAkF;QAClF,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,CAAC;CACF,CAAA;AArEY,kCAAkC;IAD9C,UAAU,EAAE;IAMR,WAAA,MAAM,CAAC,kBAAkB,CAAC,gCAAgC,CAAC,CAAA;IAE3D,WAAA,MAAM,CAAC,kBAAkB,CAAC,8BAA8B,CAAC,CAAA;;GAPjD,kCAAkC,CAqE9C","sourcesContent":["import { injectable, inject } from 'inversify';\nimport { EngineCapability } from '@wildo-ai/saas-models';\nimport type { AgentCallTraceSink, AgentCallTraceEmission } from '@wildo-ai/saas-models';\n/*\n * `/backend-runtime`, not `/backend` (#330). The two barrels expose the same builder; `/backend` also\n * re-exports the engine's EAGERLY composed provider catalogue, and ES module semantics mean that one\n * value import evaluates all twenty-two provider modules — six of them pulling an `@ai-sdk/*` client\n * — into whatever process imports this file. This file is in every backend's boot graph.\n */\nimport { buildLlmObservabilitySinkFromModule } from '@wildo-ai/external-connectors-private/backend-runtime';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { ExternalProvidersRegistryBackendService } from '~wildo-backend-lib/external-providers/services/external-providers-registry.backend.service';\nimport type { BackendProviderRegistryBackendService } from '~wildo-backend-lib/external-providers/services/backend-provider-registry.backend.service';\n\n/**\n * Engine-side `AgentCallTraceSink` that resolves its concrete provider sink (e.g.\n * PostHog) LAZILY, honouring the app's `defineSaaSProviders` selection for\n * `EngineCapability.LLM_OBSERVABILITY`.\n *\n * **Why lazy, not eager.** The selection-aware registry\n * ({@link ExternalProvidersRegistryBackendService}) only knows the chosen provider\n * AFTER it is `initialize()`-d, which happens during the startup sequence — well\n * after the DI container is built. Two consumers also cache their sink reference at\n * construction: `AgentsBackendService` (`@optional()`-injects it once) and the dev\n * companion (composes it into a `CompositeAgentCallTraceSink` at companion-container\n * build, BEFORE the registry is initialized). A post-init `rebind` would therefore\n * be invisible to both. So this object is bound EAGERLY (a stable reference both can\n * hold) but defers the actual provider resolution to the first `recordAgentCall` /\n * `isActive()` — by which point (an actual agent call) the registry is initialized.\n * This mirrors `EmailBackendService`, which injects the same registry and resolves\n * its provider per-send.\n *\n * **Resolution.** `getPrimaryProviderForEngineCapability(LLM_OBSERVABILITY)` returns\n * the app's selected provider ref (respecting the active backend/companion scope,\n * the `selection[...].primary`, and capability-enabled gating); the provider MODULE\n * (with its `agentCallTraceSinkFactory`) is then fetched from the\n * {@link BackendProviderRegistryBackendService} and constructed by\n * {@link buildLlmObservabilitySinkFromModule} (which owns secret resolution). No\n * provider selected, or its secret absent → this stays a no-op (no I/O), so output\n * is byte-identical when LLM-obs is off.\n */\n@injectable()\nexport class LlmObservabilityAgentCallTraceSink implements AgentCallTraceSink {\n  /** `undefined` = not yet resolved; `null` = resolved to \"no active provider\"; else the provider sink. */\n  private resolvedSink: AgentCallTraceSink | null | undefined = undefined;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.ExternalProvidersRegistryService)\n    private readonly externalProvidersRegistry: ExternalProvidersRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.BackendProviderRegistryService)\n    private readonly backendProviderRegistry: BackendProviderRegistryBackendService,\n  ) {}\n\n  /**\n   * Resolve (once) the concrete provider sink from the app's LLM-obs selection.\n   * Caches the result — including the `null` \"no provider\" verdict. If the registry\n   * is not yet initialized (a resolution attempted before startup completes), the\n   * attempt is NOT cached so a later call retries; in practice the first call is an\n   * actual agent invocation, long after init.\n   */\n  private ensureResolved(): AgentCallTraceSink | null {\n    if (this.resolvedSink !== undefined) {\n      return this.resolvedSink;\n    }\n    try {\n      const providerRef = this.externalProvidersRegistry.getPrimaryProviderForEngineCapability(\n        EngineCapability.LLM_OBSERVABILITY,\n      );\n      if (!providerRef) {\n        this.resolvedSink = null;\n        return null;\n      }\n      const module = this.backendProviderRegistry.getProvider(providerRef);\n      if (!module) {\n        this.resolvedSink = null;\n        return null;\n      }\n      this.resolvedSink = buildLlmObservabilitySinkFromModule(\n        module,\n        {\n          captureContent: process.env.WILDO_LLM_OBS_CAPTURE_CONTENT === 'true',\n          sampleRate: process.env.WILDO_LLM_OBS_SAMPLE_RATE\n            ? Number(process.env.WILDO_LLM_OBS_SAMPLE_RATE)\n            : undefined,\n        },\n        console,\n      ) ?? null;\n      return this.resolvedSink;\n    } catch {\n      // Registry not yet initialized — stay unresolved, retry on the next call.\n      return null;\n    }\n  }\n\n  /**\n   * Whether an LLM-observability provider is selected + configured. Drives the\n   * engine `AgentTraceabilityPolicy` level (active → DEBUG, inactive → NONE) so a\n   * backend with no LLM-obs provider keeps the byte-identical NONE-skip.\n   */\n  public isActive(): boolean {\n    return this.ensureResolved() !== null;\n  }\n\n  public recordAgentCall(emission: AgentCallTraceEmission): void | Promise<void> {\n    return this.ensureResolved()?.recordAgentCall(emission);\n  }\n\n  public shutdown(): void | Promise<void> {\n    // Flush only an already-resolved real sink; never trigger resolution on shutdown.\n    return this.resolvedSink ? this.resolvedSink.shutdown?.() : undefined;\n  }\n}\n"]}