@codemation/host 0.1.6 → 0.2.0

package/dist/{server-ChTCEc6R.js.map → server-C-WZcsId.js.map}

@@ -1 +1 @@
-{"version":3,"file":"server-ChTCEc6R.js","names":["config: CodemationConfig","consumerRoot: string","configSource?: string","workflowSources: ReadonlyArray<string>","env?: Readonly<NodeJS.ProcessEnv>","consumerConfigLoader: CodemationConsumerConfigLoader","appConfigFactory: AppConfigFactory","discoveredPackages: CodemationDiscoveredPluginPackage[]","resolvedPackages: CodemationResolvedPluginPackage[]","packageRoots: string[]"],"sources":["../src/presentation/http/CodemationServerGatewayFactory.ts","../src/presentation/server/AppConfigLoader.ts","../src/presentation/server/CodemationPluginDiscovery.ts"],"sourcesContent":["import { accessSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { QueryBus } from \"../../application/bus/QueryBus\";\nimport type { WorkflowDto, WorkflowSummary } from \"../../application/contracts/WorkflowViewContracts\";\nimport { WorkflowDefinitionMapper } from \"../../application/mapping/WorkflowDefinitionMapper\";\nimport { GetWorkflowDetailQuery } from \"../../application/queries/GetWorkflowDetailQuery\";\nimport { GetWorkflowSummariesQuery } from \"../../application/queries/GetWorkflowSummariesQuery\";\nimport { ApplicationTokens } from \"../../applicationTokens\";\nimport { AppContainerFactory } from \"../../bootstrap/AppContainerFactory\";\nimport { AppContainerLifecycle } from \"../../bootstrap/AppContainerLifecycle\";\nimport { FrontendRuntime } from \"../../bootstrap/runtime/FrontendRuntime\";\nimport { AppConfigFactory } from \"../../bootstrap/runtime/AppConfigFactory\";\nimport type { CodemationConfig } from \"../config/CodemationConfig\";\nimport { CodemationConfigNormalizer } from \"../config/CodemationConfigNormalizer\";\nimport { CodemationHonoApiApp } from \"./hono/CodemationHonoApiAppFactory\";\n\ntype ServerGatewayContext = Readonly<{\n  container: import(\"@codemation/core\").Container;\n  httpApi: CodemationHonoApiApp;\n  queryBus: QueryBus;\n  workflowDefinitionMapper: WorkflowDefinitionMapper;\n}>;\n\nexport class CodemationServerGateway {\n  private static readonly contextsByConfig = new WeakMap<object, Promise<ServerGatewayContext>>();\n\n  constructor(\n    private readonly config: CodemationConfig,\n    private readonly consumerRoot: string,\n    private readonly configSource?: string,\n    private readonly workflowSources: ReadonlyArray<string> = [],\n    private readonly env?: Readonly<NodeJS.ProcessEnv>,\n  ) {}\n\n  async dispatch(request: Request): Promise<Response> {\n    return await (await this.getContext()).httpApi.fetch(request);\n  }\n\n  async prepare(): Promise<void> {\n    await this.getContext();\n  }\n\n  async close(): Promise<void> {\n    const cachedContext = CodemationServerGateway.contextsByConfig.get(this.config as object);\n    if (!cachedContext) {\n      return;\n    }\n    CodemationServerGateway.contextsByConfig.delete(this.config as object);\n    await (await cachedContext).container.resolve(AppContainerLifecycle).stop();\n  }\n\n  async loadWorkflowSummaries(): Promise<ReadonlyArray<WorkflowSummary>> {\n    const context = await this.getContext();\n    const workflows = await context.queryBus.execute(new GetWorkflowSummariesQuery());\n    return workflows.map((workflow) => context.workflowDefinitionMapper.toSummary(workflow));\n  }\n\n  async loadWorkflowDetail(workflowId: string): Promise<WorkflowDto> {\n    const context = await this.getContext();\n    const workflow = await context.queryBus.execute(new GetWorkflowDetailQuery(workflowId));\n    if (!workflow) {\n      throw new Error(`Unknown workflowId: ${workflowId}`);\n    }\n    return await context.workflowDefinitionMapper.map(workflow);\n  }\n\n  private getContext(): Promise<ServerGatewayContext> {\n    const cachedContext = CodemationServerGateway.contextsByConfig.get(this.config as object);\n    if (cachedContext) {\n      return cachedContext;\n    }\n    const nextContext = this.createContext();\n    CodemationServerGateway.contextsByConfig.set(this.config as object, nextContext);\n    return nextContext;\n  }\n\n  private async createContext(): Promise<ServerGatewayContext> {\n    const repoRoot = this.detectWorkspaceRoot(this.consumerRoot);\n    // This gateway is the config/env boundary that materializes AppConfig from raw inputs.\n    // eslint-disable-next-line no-restricted-properties\n    const env = this.env ?? process.env;\n    const appConfig = new AppConfigFactory().create({\n      repoRoot,\n      consumerRoot: this.consumerRoot,\n      env,\n      config: new CodemationConfigNormalizer().normalize(this.config),\n      workflowSources: this.resolveWorkflowSources(),\n    });\n    const container = await new AppContainerFactory().create({\n      appConfig,\n      sharedWorkflowWebsocketServer: null,\n    });\n    await container.resolve(FrontendRuntime).start();\n    return {\n      container,\n      httpApi: container.resolve(CodemationHonoApiApp),\n      queryBus: container.resolve(ApplicationTokens.QueryBus),\n      workflowDefinitionMapper: container.resolve(WorkflowDefinitionMapper),\n    };\n  }\n\n  private resolveWorkflowSources(): ReadonlyArray<string> {\n    if (this.workflowSources.length > 0) {\n      return [...this.workflowSources];\n    }\n    if (!this.configSource || !this.config.workflows || this.config.workflows.length === 0) {\n      return [];\n    }\n    return [this.configSource];\n  }\n  private detectWorkspaceRoot(startDirectory: string): string {\n    let currentDirectory = path.resolve(startDirectory);\n    while (true) {\n      try {\n        accessSync(path.resolve(currentDirectory, \"pnpm-workspace.yaml\"));\n        return currentDirectory;\n      } catch {\n        const parentDirectory = path.dirname(currentDirectory);\n        if (parentDirectory === currentDirectory) {\n          return startDirectory;\n        }\n        currentDirectory = parentDirectory;\n      }\n    }\n  }\n}\n","import type { AppConfig } from \"../config/AppConfig\";\nimport { CodemationConsumerConfigLoader } from \"./CodemationConsumerConfigLoader\";\nimport { AppConfigFactory } from \"../../bootstrap/runtime/AppConfigFactory\";\n\nexport type AppConfigLoadResult = Readonly<{\n  appConfig: AppConfig;\n  bootstrapSource: string | null;\n}>;\n\nexport class AppConfigLoader {\n  constructor(\n    private readonly consumerConfigLoader: CodemationConsumerConfigLoader = new CodemationConsumerConfigLoader(),\n    private readonly appConfigFactory: AppConfigFactory = new AppConfigFactory(),\n  ) {}\n\n  async load(\n    args: Readonly<{\n      consumerRoot: string;\n      repoRoot: string;\n      env: NodeJS.ProcessEnv;\n      configPathOverride?: string;\n    }>,\n  ): Promise<AppConfigLoadResult> {\n    const resolution = await this.consumerConfigLoader.load({\n      consumerRoot: args.consumerRoot,\n      configPathOverride: args.configPathOverride,\n    });\n    return {\n      appConfig: this.appConfigFactory.create({\n        repoRoot: args.repoRoot,\n        consumerRoot: args.consumerRoot,\n        env: args.env,\n        config: resolution.config,\n        workflowSources: resolution.workflowSources,\n      }),\n      bootstrapSource: resolution.bootstrapSource,\n    };\n  }\n}\n","import type { CodemationPackageManifest } from \"../config/CodemationPackageManifest\";\nimport { CodemationPluginPackageMetadata, type CodemationPlugin } from \"../config/CodemationPlugin\";\nimport { readFile, readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nexport type CodemationDiscoveredPluginPackage = Readonly<{\n  packageName: string;\n  packageRoot: string;\n  pluginEntry: string;\n  developmentEntry?: string;\n}>;\n\nexport type CodemationResolvedPluginPackage = Readonly<\n  CodemationDiscoveredPluginPackage & {\n    plugin: CodemationPlugin;\n  }\n>;\n\ntype PackageJsonShape = Readonly<{\n  codemation?: CodemationPackageManifest;\n  name?: string;\n  exports?: Readonly<Record<string, unknown>>;\n}>;\n\nexport class CodemationPluginDiscovery {\n  private readonly pluginPackageMetadata = new CodemationPluginPackageMetadata();\n\n  async discover(consumerRoot: string): Promise<ReadonlyArray<CodemationDiscoveredPluginPackage>> {\n    const nodeModulesRoot = path.resolve(consumerRoot, \"node_modules\");\n    const packageRoots = await this.collectPackageRoots(nodeModulesRoot);\n    const discoveredPackages: CodemationDiscoveredPluginPackage[] = [];\n    for (const packageRoot of packageRoots) {\n      const packageJson = await this.readPackageJson(path.resolve(packageRoot, \"package.json\"));\n      const pluginManifest = packageJson.codemation?.plugin;\n      if (!packageJson.name || typeof pluginManifest !== \"string\" || pluginManifest.trim().length === 0) {\n        continue;\n      }\n      discoveredPackages.push({\n        packageName: packageJson.name,\n        packageRoot,\n        pluginEntry: pluginManifest,\n        developmentEntry: await this.resolveDevelopmentPluginEntry(packageRoot),\n      });\n    }\n    return discoveredPackages.sort((left, right) => left.packageName.localeCompare(right.packageName));\n  }\n\n  async resolvePlugins(consumerRoot: string): Promise<ReadonlyArray<CodemationResolvedPluginPackage>> {\n    const discoveredPackages = await this.discover(consumerRoot);\n    return await this.resolveDiscoveredPackages(discoveredPackages);\n  }\n\n  async resolveDiscoveredPackages(\n    discoveredPackages: ReadonlyArray<CodemationDiscoveredPluginPackage>,\n  ): Promise<ReadonlyArray<CodemationResolvedPluginPackage>> {\n    const resolvedPackages: CodemationResolvedPluginPackage[] = [];\n    for (const discoveredPackage of discoveredPackages) {\n      resolvedPackages.push({\n        ...discoveredPackage,\n        plugin: await this.loadPlugin(discoveredPackage),\n      });\n    }\n    return resolvedPackages;\n  }\n\n  private async collectPackageRoots(nodeModulesRoot: string): Promise<ReadonlyArray<string>> {\n    try {\n      const entries = await readdir(nodeModulesRoot, { withFileTypes: true });\n      const packageRoots: string[] = [];\n      for (const entry of entries) {\n        if (!entry.isDirectory() && !entry.isSymbolicLink()) {\n          continue;\n        }\n        if (entry.name.startsWith(\"@\")) {\n          const scopedEntries = await readdir(path.resolve(nodeModulesRoot, entry.name), { withFileTypes: true });\n          for (const scopedEntry of scopedEntries) {\n            if (scopedEntry.isDirectory() || scopedEntry.isSymbolicLink()) {\n              packageRoots.push(path.resolve(nodeModulesRoot, entry.name, scopedEntry.name));\n            }\n          }\n          continue;\n        }\n        packageRoots.push(path.resolve(nodeModulesRoot, entry.name));\n      }\n      return packageRoots;\n    } catch {\n      return [];\n    }\n  }\n\n  private async readPackageJson(packageJsonPath: string): Promise<PackageJsonShape> {\n    try {\n      const rawPackageJson = await readFile(packageJsonPath, \"utf8\");\n      return JSON.parse(rawPackageJson) as PackageJsonShape;\n    } catch {\n      return {};\n    }\n  }\n\n  private async loadPlugin(discoveredPackage: CodemationDiscoveredPluginPackage): Promise<CodemationPlugin> {\n    const pluginModulePath = path.resolve(discoveredPackage.packageRoot, this.resolvePluginEntry(discoveredPackage));\n    const importedModule = (await import(\n      /* webpackIgnore: true */ this.resolvePluginModuleSpecifier(pluginModulePath)\n    )) as Record<string, unknown>;\n    const exportedValue = importedModule.default;\n    const plugin = this.resolvePluginValue(exportedValue);\n    if (!plugin) {\n      throw new Error(`Plugin package \"${discoveredPackage.packageName}\" did not default-export a Codemation plugin.`);\n    }\n    return this.pluginPackageMetadata.attachPackageName(plugin, discoveredPackage.packageName);\n  }\n\n  private resolvePluginValue(value: unknown): CodemationPlugin | null {\n    if (this.isPluginConfig(value)) {\n      return value;\n    }\n    return null;\n  }\n\n  private isPluginConfig(value: unknown): value is CodemationPlugin {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return false;\n    }\n    const pluginValue = value as {\n      credentialTypes?: unknown;\n      register?: unknown;\n      sandbox?: unknown;\n    };\n    if (pluginValue.register !== undefined && typeof pluginValue.register !== \"function\") {\n      return false;\n    }\n    if (pluginValue.credentialTypes !== undefined && !Array.isArray(pluginValue.credentialTypes)) {\n      return false;\n    }\n    return (\n      pluginValue.register !== undefined ||\n      pluginValue.credentialTypes !== undefined ||\n      pluginValue.sandbox !== undefined ||\n      Object.keys(pluginValue).length === 0\n    );\n  }\n\n  private resolvePluginEntry(discoveredPackage: CodemationDiscoveredPluginPackage): string {\n    if (\n      process.env.CODEMATION_PREFER_PLUGIN_SOURCE_ENTRY === \"true\" &&\n      typeof discoveredPackage.developmentEntry === \"string\" &&\n      discoveredPackage.developmentEntry.trim().length > 0\n    ) {\n      return discoveredPackage.developmentEntry;\n    }\n    return discoveredPackage.pluginEntry;\n  }\n\n  private async resolveDevelopmentPluginEntry(packageRoot: string): Promise<string | undefined> {\n    const candidates = [\n      path.resolve(packageRoot, \"codemation.plugin.ts\"),\n      path.resolve(packageRoot, \"codemation.plugin.js\"),\n      path.resolve(packageRoot, \"src\", \"codemation.plugin.ts\"),\n      path.resolve(packageRoot, \"src\", \"codemation.plugin.js\"),\n    ];\n    for (const candidate of candidates) {\n      if (await this.exists(candidate)) {\n        return path.relative(packageRoot, candidate);\n      }\n    }\n    return undefined;\n  }\n\n  private async exists(filePath: string): Promise<boolean> {\n    try {\n      await readFile(filePath, \"utf8\");\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private resolvePluginModuleSpecifier(pluginModulePath: string): string {\n    return pathToFileURL(pluginModulePath).href;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"server-C-WZcsId.js","names":["config: CodemationConfig","consumerRoot: string","configSource?: string","workflowSources: ReadonlyArray<string>","env?: Readonly<NodeJS.ProcessEnv>","consumerConfigLoader: CodemationConsumerConfigLoader","appConfigFactory: AppConfigFactory","discoveredPackages: CodemationDiscoveredPluginPackage[]","resolvedPackages: CodemationResolvedPluginPackage[]","packageRoots: string[]"],"sources":["../src/presentation/http/CodemationServerGatewayFactory.ts","../src/presentation/server/AppConfigLoader.ts","../src/presentation/server/CodemationPluginDiscovery.ts"],"sourcesContent":["import { accessSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { QueryBus } from \"../../application/bus/QueryBus\";\nimport type { WorkflowDto, WorkflowSummary } from \"../../application/contracts/WorkflowViewContracts\";\nimport { WorkflowDefinitionMapper } from \"../../application/mapping/WorkflowDefinitionMapper\";\nimport { GetWorkflowDetailQuery } from \"../../application/queries/GetWorkflowDetailQuery\";\nimport { GetWorkflowSummariesQuery } from \"../../application/queries/GetWorkflowSummariesQuery\";\nimport { ApplicationTokens } from \"../../applicationTokens\";\nimport { AppContainerFactory } from \"../../bootstrap/AppContainerFactory\";\nimport { AppContainerLifecycle } from \"../../bootstrap/AppContainerLifecycle\";\nimport { FrontendRuntime } from \"../../bootstrap/runtime/FrontendRuntime\";\nimport { AppConfigFactory } from \"../../bootstrap/runtime/AppConfigFactory\";\nimport type { CodemationConfig } from \"../config/CodemationConfig\";\nimport { CodemationConfigNormalizer } from \"../config/CodemationConfigNormalizer\";\nimport { CodemationHonoApiApp } from \"./hono/CodemationHonoApiAppFactory\";\n\ntype ServerGatewayContext = Readonly<{\n  container: import(\"@codemation/core\").Container;\n  httpApi: CodemationHonoApiApp;\n  queryBus: QueryBus;\n  workflowDefinitionMapper: WorkflowDefinitionMapper;\n}>;\n\nexport class CodemationServerGateway {\n  private static readonly contextsByConfig = new WeakMap<object, Promise<ServerGatewayContext>>();\n\n  constructor(\n    private readonly config: CodemationConfig,\n    private readonly consumerRoot: string,\n    private readonly configSource?: string,\n    private readonly workflowSources: ReadonlyArray<string> = [],\n    private readonly env?: Readonly<NodeJS.ProcessEnv>,\n  ) {}\n\n  async dispatch(request: Request): Promise<Response> {\n    return await (await this.getContext()).httpApi.fetch(request);\n  }\n\n  async prepare(): Promise<void> {\n    await this.getContext();\n  }\n\n  async close(): Promise<void> {\n    const cachedContext = CodemationServerGateway.contextsByConfig.get(this.config as object);\n    if (!cachedContext) {\n      return;\n    }\n    CodemationServerGateway.contextsByConfig.delete(this.config as object);\n    await (await cachedContext).container.resolve(AppContainerLifecycle).stop();\n  }\n\n  async loadWorkflowSummaries(): Promise<ReadonlyArray<WorkflowSummary>> {\n    const context = await this.getContext();\n    const workflows = await context.queryBus.execute(new GetWorkflowSummariesQuery());\n    return workflows.map((workflow) => context.workflowDefinitionMapper.toSummary(workflow));\n  }\n\n  async loadWorkflowDetail(workflowId: string): Promise<WorkflowDto> {\n    const context = await this.getContext();\n    const workflow = await context.queryBus.execute(new GetWorkflowDetailQuery(workflowId));\n    if (!workflow) {\n      throw new Error(`Unknown workflowId: ${workflowId}`);\n    }\n    return await context.workflowDefinitionMapper.map(workflow);\n  }\n\n  private getContext(): Promise<ServerGatewayContext> {\n    const cachedContext = CodemationServerGateway.contextsByConfig.get(this.config as object);\n    if (cachedContext) {\n      return cachedContext;\n    }\n    const nextContext = this.createContext();\n    CodemationServerGateway.contextsByConfig.set(this.config as object, nextContext);\n    return nextContext;\n  }\n\n  private async createContext(): Promise<ServerGatewayContext> {\n    const repoRoot = this.detectWorkspaceRoot(this.consumerRoot);\n    // This gateway is the config/env boundary that materializes AppConfig from raw inputs.\n    // eslint-disable-next-line no-restricted-properties\n    const env = this.env ?? process.env;\n    const appConfig = new AppConfigFactory().create({\n      repoRoot,\n      consumerRoot: this.consumerRoot,\n      env,\n      config: new CodemationConfigNormalizer().normalize(this.config),\n      workflowSources: this.resolveWorkflowSources(),\n    });\n    const container = await new AppContainerFactory().create({\n      appConfig,\n      sharedWorkflowWebsocketServer: null,\n    });\n    await container.resolve(FrontendRuntime).start();\n    return {\n      container,\n      httpApi: container.resolve(CodemationHonoApiApp),\n      queryBus: container.resolve(ApplicationTokens.QueryBus),\n      workflowDefinitionMapper: container.resolve(WorkflowDefinitionMapper),\n    };\n  }\n\n  private resolveWorkflowSources(): ReadonlyArray<string> {\n    if (this.workflowSources.length > 0) {\n      return [...this.workflowSources];\n    }\n    if (!this.configSource || !this.config.workflows || this.config.workflows.length === 0) {\n      return [];\n    }\n    return [this.configSource];\n  }\n  private detectWorkspaceRoot(startDirectory: string): string {\n    let currentDirectory = path.resolve(startDirectory);\n    while (true) {\n      try {\n        accessSync(path.resolve(currentDirectory, \"pnpm-workspace.yaml\"));\n        return currentDirectory;\n      } catch {\n        const parentDirectory = path.dirname(currentDirectory);\n        if (parentDirectory === currentDirectory) {\n          return startDirectory;\n        }\n        currentDirectory = parentDirectory;\n      }\n    }\n  }\n}\n","import type { AppConfig } from \"../config/AppConfig\";\nimport { CodemationConsumerConfigLoader } from \"./CodemationConsumerConfigLoader\";\nimport { AppConfigFactory } from \"../../bootstrap/runtime/AppConfigFactory\";\n\nexport type AppConfigLoadResult = Readonly<{\n  appConfig: AppConfig;\n  bootstrapSource: string | null;\n}>;\n\nexport class AppConfigLoader {\n  constructor(\n    private readonly consumerConfigLoader: CodemationConsumerConfigLoader = new CodemationConsumerConfigLoader(),\n    private readonly appConfigFactory: AppConfigFactory = new AppConfigFactory(),\n  ) {}\n\n  async load(\n    args: Readonly<{\n      consumerRoot: string;\n      repoRoot: string;\n      env: NodeJS.ProcessEnv;\n      configPathOverride?: string;\n    }>,\n  ): Promise<AppConfigLoadResult> {\n    const resolution = await this.consumerConfigLoader.load({\n      consumerRoot: args.consumerRoot,\n      configPathOverride: args.configPathOverride,\n    });\n    return {\n      appConfig: this.appConfigFactory.create({\n        repoRoot: args.repoRoot,\n        consumerRoot: args.consumerRoot,\n        env: args.env,\n        config: resolution.config,\n        workflowSources: resolution.workflowSources,\n      }),\n      bootstrapSource: resolution.bootstrapSource,\n    };\n  }\n}\n","import type { CodemationPackageManifest } from \"../config/CodemationPackageManifest\";\nimport { CodemationPluginPackageMetadata, type CodemationPlugin } from \"../config/CodemationPlugin\";\nimport { readFile, readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nexport type CodemationDiscoveredPluginPackage = Readonly<{\n  packageName: string;\n  packageRoot: string;\n  pluginEntry: string;\n  developmentEntry?: string;\n}>;\n\nexport type CodemationResolvedPluginPackage = Readonly<\n  CodemationDiscoveredPluginPackage & {\n    plugin: CodemationPlugin;\n  }\n>;\n\ntype PackageJsonShape = Readonly<{\n  codemation?: CodemationPackageManifest;\n  name?: string;\n  exports?: Readonly<Record<string, unknown>>;\n}>;\n\nexport class CodemationPluginDiscovery {\n  private readonly pluginPackageMetadata = new CodemationPluginPackageMetadata();\n\n  async discover(consumerRoot: string): Promise<ReadonlyArray<CodemationDiscoveredPluginPackage>> {\n    const nodeModulesRoot = path.resolve(consumerRoot, \"node_modules\");\n    const packageRoots = await this.collectPackageRoots(nodeModulesRoot);\n    const discoveredPackages: CodemationDiscoveredPluginPackage[] = [];\n    for (const packageRoot of packageRoots) {\n      const packageJson = await this.readPackageJson(path.resolve(packageRoot, \"package.json\"));\n      const pluginManifest = packageJson.codemation?.plugin;\n      if (!packageJson.name || typeof pluginManifest !== \"string\" || pluginManifest.trim().length === 0) {\n        continue;\n      }\n      discoveredPackages.push({\n        packageName: packageJson.name,\n        packageRoot,\n        pluginEntry: pluginManifest,\n        developmentEntry: await this.resolveDevelopmentPluginEntry(packageRoot),\n      });\n    }\n    return discoveredPackages.sort((left, right) => left.packageName.localeCompare(right.packageName));\n  }\n\n  async resolvePlugins(consumerRoot: string): Promise<ReadonlyArray<CodemationResolvedPluginPackage>> {\n    const discoveredPackages = await this.discover(consumerRoot);\n    return await this.resolveDiscoveredPackages(discoveredPackages);\n  }\n\n  async resolveDiscoveredPackages(\n    discoveredPackages: ReadonlyArray<CodemationDiscoveredPluginPackage>,\n  ): Promise<ReadonlyArray<CodemationResolvedPluginPackage>> {\n    const resolvedPackages: CodemationResolvedPluginPackage[] = [];\n    for (const discoveredPackage of discoveredPackages) {\n      resolvedPackages.push({\n        ...discoveredPackage,\n        plugin: await this.loadPlugin(discoveredPackage),\n      });\n    }\n    return resolvedPackages;\n  }\n\n  private async collectPackageRoots(nodeModulesRoot: string): Promise<ReadonlyArray<string>> {\n    try {\n      const entries = await readdir(nodeModulesRoot, { withFileTypes: true });\n      const packageRoots: string[] = [];\n      for (const entry of entries) {\n        if (!entry.isDirectory() && !entry.isSymbolicLink()) {\n          continue;\n        }\n        if (entry.name.startsWith(\"@\")) {\n          const scopedEntries = await readdir(path.resolve(nodeModulesRoot, entry.name), { withFileTypes: true });\n          for (const scopedEntry of scopedEntries) {\n            if (scopedEntry.isDirectory() || scopedEntry.isSymbolicLink()) {\n              packageRoots.push(path.resolve(nodeModulesRoot, entry.name, scopedEntry.name));\n            }\n          }\n          continue;\n        }\n        packageRoots.push(path.resolve(nodeModulesRoot, entry.name));\n      }\n      return packageRoots;\n    } catch {\n      return [];\n    }\n  }\n\n  private async readPackageJson(packageJsonPath: string): Promise<PackageJsonShape> {\n    try {\n      const rawPackageJson = await readFile(packageJsonPath, \"utf8\");\n      return JSON.parse(rawPackageJson) as PackageJsonShape;\n    } catch {\n      return {};\n    }\n  }\n\n  private async loadPlugin(discoveredPackage: CodemationDiscoveredPluginPackage): Promise<CodemationPlugin> {\n    const pluginModulePath = path.resolve(discoveredPackage.packageRoot, this.resolvePluginEntry(discoveredPackage));\n    const importedModule = (await import(\n      /* webpackIgnore: true */ this.resolvePluginModuleSpecifier(pluginModulePath)\n    )) as Record<string, unknown>;\n    const exportedValue = importedModule.default;\n    const plugin = this.resolvePluginValue(exportedValue);\n    if (!plugin) {\n      throw new Error(`Plugin package \"${discoveredPackage.packageName}\" did not default-export a Codemation plugin.`);\n    }\n    return this.pluginPackageMetadata.attachPackageName(plugin, discoveredPackage.packageName);\n  }\n\n  private resolvePluginValue(value: unknown): CodemationPlugin | null {\n    if (this.isPluginConfig(value)) {\n      return value;\n    }\n    return null;\n  }\n\n  private isPluginConfig(value: unknown): value is CodemationPlugin {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return false;\n    }\n    const pluginValue = value as {\n      credentialTypes?: unknown;\n      register?: unknown;\n      sandbox?: unknown;\n    };\n    if (pluginValue.register !== undefined && typeof pluginValue.register !== \"function\") {\n      return false;\n    }\n    if (pluginValue.credentialTypes !== undefined && !Array.isArray(pluginValue.credentialTypes)) {\n      return false;\n    }\n    return (\n      pluginValue.register !== undefined ||\n      pluginValue.credentialTypes !== undefined ||\n      pluginValue.sandbox !== undefined ||\n      Object.keys(pluginValue).length === 0\n    );\n  }\n\n  private resolvePluginEntry(discoveredPackage: CodemationDiscoveredPluginPackage): string {\n    const preferSource =\n      process.env.CODEMATION_PREFER_PLUGIN_SOURCE_ENTRY === \"true\" &&\n      typeof discoveredPackage.developmentEntry === \"string\" &&\n      discoveredPackage.developmentEntry.trim().length > 0;\n    const selectedEntry = preferSource ? discoveredPackage.developmentEntry : discoveredPackage.pluginEntry;\n    return selectedEntry;\n  }\n\n  private async resolveDevelopmentPluginEntry(packageRoot: string): Promise<string | undefined> {\n    const candidates = [\n      path.resolve(packageRoot, \"codemation.plugin.ts\"),\n      path.resolve(packageRoot, \"codemation.plugin.js\"),\n      path.resolve(packageRoot, \"src\", \"codemation.plugin.ts\"),\n      path.resolve(packageRoot, \"src\", \"codemation.plugin.js\"),\n    ];\n    for (const candidate of candidates) {\n      if (await this.exists(candidate)) {\n        return path.relative(packageRoot, candidate);\n      }\n    }\n    return undefined;\n  }\n\n  private async exists(filePath: string): Promise<boolean> {\n    try {\n      await readFile(filePath, \"utf8\");\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private resolvePluginModuleSpecifier(pluginModulePath: string): string {\n    return pathToFileURL(pluginModulePath).href;\n  }\n}\n"],"mappings":"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"}

package/dist/{server-Cpzpy1Ar.d.ts → server-fxqY2WEi.d.ts}

@@ -1,7 +1,7 @@
-import { a as CodemationConfig, g as AppConfig, y as CodemationPlugin } from "./CodemationConfig-DuGk7uN5.js";
-import { t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-D5CSz3TQ.js";
-import { t as AppConfigFactory } from "./AppConfigFactory-BiFHnorf.js";
-import { a as WorkflowDto, o as WorkflowSummary } from "./PublicFrontendBootstrapFactory-CSgWyTra.js";
+import { a as CodemationConfig, g as AppConfig, y as CodemationPlugin } from "./CodemationConfig-DBbMU3HB.js";
+import { t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-Ceh6sB3X.js";
+import { t as AppConfigFactory } from "./AppConfigFactory-DHdAGOmC.js";
+import { a as WorkflowDto, o as WorkflowSummary } from "./PublicFrontendBootstrapFactory-DeMjp3cs.js";
 
 //#region src/presentation/http/ApiPaths.d.ts
 declare class ApiPaths {
@@ -150,4 +150,4 @@ declare class WorkflowDiscoveryPathSegmentsComputer {
 }
 //#endregion
 export { CodemationResolvedPluginPackage as a, CodemationServerGateway as c, CodemationPluginDiscovery as i, ApiPaths as l, WorkflowModulePathFinder as n, AppConfigLoadResult as o, CodemationDiscoveredPluginPackage as r, AppConfigLoader as s, WorkflowDiscoveryPathSegmentsComputer as t };
-//# sourceMappingURL=server-Cpzpy1Ar.d.ts.map
+//# sourceMappingURL=server-fxqY2WEi.d.ts.map

package/dist/server.d.ts

@@ -1,12 +1,12 @@
 import "./CodemationAuthConfig-7hEfICPf.js";
 import { n as InternalAuthBootstrap, r as FrontendAppConfig, t as PublicFrontendBootstrap } from "./PublicFrontendBootstrap-DCniMBGu.js";
 import { i as CodemationFrontendAuthSnapshotJsonCodec, n as InternalAuthBootstrapJsonCodec, r as FrontendAppConfigJsonCodec, t as PublicFrontendBootstrapJsonCodec } from "./PublicFrontendBootstrapJsonCodec-BE0mhe1v.js";
-import "./index-BQaZZmOm.js";
-import "./CodemationConfig-DuGk7uN5.js";
-import "./CodemationConfigNormalizer-BP2-0ZDE.js";
-import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-D5CSz3TQ.js";
-import { r as PrismaDatabaseClient } from "./AppConfigFactory-BiFHnorf.js";
-import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-fdldtXJH.js";
-import { a as CodemationResolvedPluginPackage, c as CodemationServerGateway, i as CodemationPluginDiscovery, l as ApiPaths, n as WorkflowModulePathFinder, o as AppConfigLoadResult, r as CodemationDiscoveredPluginPackage, s as AppConfigLoader, t as WorkflowDiscoveryPathSegmentsComputer } from "./server-Cpzpy1Ar.js";
-import { i as CodemationFrontendAuthSnapshotFactory, n as InternalAuthBootstrapFactory, r as FrontendAppConfigFactory, t as PublicFrontendBootstrapFactory } from "./PublicFrontendBootstrapFactory-CSgWyTra.js";
+import "./index-dK05sTQ4.js";
+import "./CodemationConfig-DBbMU3HB.js";
+import "./CodemationConfigNormalizer-C8wC0skq.js";
+import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-Ceh6sB3X.js";
+import { r as PrismaDatabaseClient } from "./AppConfigFactory-DHdAGOmC.js";
+import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-D9vUTMqc.js";
+import { a as CodemationResolvedPluginPackage, c as CodemationServerGateway, i as CodemationPluginDiscovery, l as ApiPaths, n as WorkflowModulePathFinder, o as AppConfigLoadResult, r as CodemationDiscoveredPluginPackage, s as AppConfigLoader, t as WorkflowDiscoveryPathSegmentsComputer } from "./server-fxqY2WEi.js";
+import { i as CodemationFrontendAuthSnapshotFactory, n as InternalAuthBootstrapFactory, r as FrontendAppConfigFactory, t as PublicFrontendBootstrapFactory } from "./PublicFrontendBootstrapFactory-DeMjp3cs.js";
 export { ApiPaths, AppConfigLoadResult, AppConfigLoader, CodemationConsumerApp, CodemationConsumerAppResolver, CodemationConsumerConfigLoader, CodemationConsumerConfigResolution, CodemationDiscoveredPluginPackage, CodemationFrontendAuthSnapshotFactory, CodemationFrontendAuthSnapshotJsonCodec, CodemationPluginDiscovery, CodemationPostgresPrismaClientFactory, CodemationResolvedPluginPackage, CodemationServerGateway, FrontendAppConfig, FrontendAppConfigFactory, FrontendAppConfigJsonCodec, InternalAuthBootstrap, InternalAuthBootstrapFactory, InternalAuthBootstrapJsonCodec, PrismaDatabaseClient as PrismaClient, PublicFrontendBootstrap, PublicFrontendBootstrapFactory, PublicFrontendBootstrapJsonCodec, WorkflowDiscoveryPathSegmentsComputer, WorkflowModulePathFinder };

package/dist/server.js

@@ -1,13 +1,13 @@
 import "./ConsoleLogger-ClPU7jtc.js";
 import { i as CodemationFrontendAuthSnapshotJsonCodec, n as InternalAuthBootstrapJsonCodec, r as FrontendAppConfigJsonCodec, t as PublicFrontendBootstrapJsonCodec } from "./PublicFrontendBootstrapJsonCodec-BdiVGG5R.js";
-import { i as CodemationConsumerAppResolver, n as WorkflowDiscoveryPathSegmentsComputer, r as WorkflowModulePathFinder, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-C_ISRrpI.js";
+import { i as CodemationConsumerAppResolver, n as WorkflowDiscoveryPathSegmentsComputer, r as WorkflowModulePathFinder, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-D6LFSlp5.js";
 import "./ServerLoggerFactory-BltIIDfQ.js";
 import "./decorateParam-DrsXNPuw.js";
 import "./decorate-B0PP651O.js";
-import "./CredentialServices-xVxVA9Tq.js";
-import { _ as CodemationFrontendAuthSnapshotFactory, g as FrontendAppConfigFactory, h as InternalAuthBootstrapFactory, m as PublicFrontendBootstrapFactory, y as ApiPaths } from "./AppContainerFactory-BRU02PTm.js";
+import "./CredentialServices-D8BBZH1i.js";
+import { _ as CodemationFrontendAuthSnapshotFactory, g as FrontendAppConfigFactory, h as InternalAuthBootstrapFactory, m as PublicFrontendBootstrapFactory, y as ApiPaths } from "./AppContainerFactory-BKaAUIi-.js";
 import "./AppConfigFactory-ByT1D8dM.js";
 import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-DMvIOGW8.js";
-import { n as AppConfigLoader, r as CodemationServerGateway, t as CodemationPluginDiscovery } from "./server-ChTCEc6R.js";
+import { n as AppConfigLoader, r as CodemationServerGateway, t as CodemationPluginDiscovery } from "./server-C-WZcsId.js";
 
 export { ApiPaths, AppConfigLoader, CodemationConsumerAppResolver, CodemationConsumerConfigLoader, CodemationFrontendAuthSnapshotFactory, CodemationFrontendAuthSnapshotJsonCodec, CodemationPluginDiscovery, CodemationPostgresPrismaClientFactory, CodemationServerGateway, FrontendAppConfigFactory, FrontendAppConfigJsonCodec, InternalAuthBootstrapFactory, InternalAuthBootstrapJsonCodec, PublicFrontendBootstrapFactory, PublicFrontendBootstrapJsonCodec, WorkflowDiscoveryPathSegmentsComputer, WorkflowModulePathFinder };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemation/host",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -112,9 +112,9 @@
     "tsx": "^4.21.0",
     "ws": "^8.19.0",
     "zxcvbn": "^4.4.2",
-    "@codemation/core": "0.3.0",
-    "@codemation/core-nodes": "0.0.25",
-    "@codemation/eventbus-redis": "0.0.25"
+    "@codemation/core": "0.5.0",
+    "@codemation/core-nodes": "0.1.1",
+    "@codemation/eventbus-redis": "0.0.27"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",
@@ -139,9 +139,10 @@
     "tsdown": "^0.15.5",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
-    "@codemation/core-nodes-gmail": "0.0.27"
+    "@codemation/core-nodes-gmail": "0.1.0"
   },
   "scripts": {
+    "changeset:verify": "pnpm --workspace-root run changeset:verify",
     "prisma:generate": "node ./scripts/generate-prisma-clients.mjs && node ./scripts/ensure-prisma-runtime-sourcemaps.mjs",
     "build": "tsdown src/index.ts src/client.ts src/credentials.ts src/consumer.ts src/nextServer.ts src/server.ts src/devServerSidecar.ts src/persistenceServer.ts --out-dir dist --sourcemap",
     "dev": "tsdown src/index.ts src/client.ts src/credentials.ts src/consumer.ts src/nextServer.ts src/server.ts src/devServerSidecar.ts src/persistenceServer.ts --out-dir dist --sourcemap --watch",

package/playwright.config.ts

@@ -16,10 +16,14 @@ if (!fs.existsSync(preparedPath)) {
 
 const prepared = JSON.parse(fs.readFileSync(preparedPath, "utf8")) as CodemationPlaywrightPreparedEnvironment;
 
-const webServerEnv: NodeJS.ProcessEnv = {
-  ...process.env,
-  ...prepared.serverEnv,
-};
+const webServerEnv: Record<string, string> = Object.fromEntries(
+  Object.entries({
+    ...process.env,
+    ...prepared.serverEnv,
+  }).filter((entry): entry is [string, string] => typeof entry[1] === "string"),
+);
+
+const baseUrl = String(prepared.serverEnv.AUTH_URL ?? "http://localhost:3001");
 
 export default defineConfig({
   /**
@@ -49,7 +53,7 @@ export default defineConfig({
   ],
   use: {
     /** Align with app URL and AUTH_URL so Auth.js cookies are not split across localhost vs 127.0.0.1. */
-    baseURL: "http://localhost:3001",
+    baseURL: baseUrl,
     trace: "retain-on-failure",
     video: "retain-on-failure",
   },
@@ -64,7 +68,7 @@ export default defineConfig({
     command: "pnpm run e2e:serve-web",
     cwd: repoRoot,
     env: webServerEnv,
-    url: "http://localhost:3001",
+    url: baseUrl,
     // Always start a fresh server so DATABASE_URL/AUTH_SECRET from `.e2e-prepared.json` match the DB that was provisioned for this run (reuse can leave a stale server on port 3001).
     reuseExistingServer: false,
     timeout: 180_000,

package/src/application/contracts/WorkflowViewContracts.ts

@@ -12,6 +12,9 @@ export type WorkflowNodeDto = Readonly<{
   hasNodeErrorHandler?: boolean;
   /** When true, downstream nodes may run even when this node outputs zero items. */
   continueWhenEmptyOutput?: boolean;
+  /** Declared I/O ports from node config (unioned with ports inferred from edges on the canvas). */
+  declaredOutputPorts?: ReadonlyArray<string>;
+  declaredInputPorts?: ReadonlyArray<string>;
 }>;
 
 export type WorkflowEdgeDto = Readonly<{

package/src/application/mapping/WorkflowDefinitionMapper.ts

@@ -1,4 +1,4 @@
-import type { AgentNodeConfig, NodeDefinition, WorkflowActivationPolicy, WorkflowDefinition } from "@codemation/core";
+import type { NodeDefinition, WorkflowActivationPolicy, WorkflowDefinition } from "@codemation/core";
 import {
   AgentConfigInspector,
   AgentConnectionNodeCollector,
@@ -30,13 +30,14 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
   }
 
   mapSync(workflow: WorkflowDefinition): WorkflowDto {
+    const mapped = this.mapNodesAndEdges(workflow);
     return {
       id: workflow.id,
       name: workflow.name,
       active: this.workflowActivationPolicy.isActive(workflow.id),
       hasWorkflowErrorHandler: this.policyUi.workflowHasErrorHandler(workflow),
-      nodes: this.toNodes(workflow),
-      edges: this.toEdges(workflow),
+      nodes: mapped.nodes,
+      edges: mapped.edges,
     };
   }
 
@@ -61,19 +62,54 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
     return map;
   }
 
-  private toNodes(workflow: WorkflowDefinition): ReadonlyArray<WorkflowNodeDto> {
+  private mapNodesAndEdges(
+    workflow: WorkflowDefinition,
+  ): Readonly<{ nodes: ReadonlyArray<WorkflowNodeDto>; edges: WorkflowDto["edges"] }> {
     const connectionChildMeta = this.buildConnectionChildMeta(workflow);
     const materializedConnectionNodeIds = new Set(connectionChildMeta.keys());
+    const nodesById = new Map(workflow.nodes.map((node) => [node.id, node] as const));
+    const agentConnectionDescriptors = this.buildAgentConnectionDescriptorIndex(workflow);
+    return {
+      nodes: this.toNodes({
+        workflow,
+        connectionChildMeta,
+        materializedConnectionNodeIds,
+        nodesById,
+        agentConnectionDescriptors,
+      }),
+      edges: this.toEdges({
+        workflow,
+        materializedConnectionNodeIds,
+        agentConnectionDescriptors,
+      }),
+    };
+  }
+
+  private toNodes(
+    args: Readonly<{
+      workflow: WorkflowDefinition;
+      connectionChildMeta: ReadonlyMap<string, Readonly<{ parentNodeId: string; connectionName: string }>>;
+      materializedConnectionNodeIds: ReadonlySet<string>;
+      nodesById: ReadonlyMap<string, WorkflowDefinition["nodes"][number]>;
+      agentConnectionDescriptors: Readonly<{
+        byAgentNodeId: ReadonlyMap<string, ReadonlyArray<AgentConnectionNodeDescriptor>>;
+        byChildNodeIdByAgentNodeId: ReadonlyMap<string, ReadonlyMap<string, AgentConnectionNodeDescriptor>>;
+      }>;
+    }>,
+  ): ReadonlyArray<WorkflowNodeDto> {
+    const workflow = args.workflow;
+    const connectionChildMeta = args.connectionChildMeta;
+    const materializedConnectionNodeIds = args.materializedConnectionNodeIds;
+    const nodesById = args.nodesById;
+    const agentConnectionDescriptors = args.agentConnectionDescriptors;
     const nodes: WorkflowNodeDto[] = [];
     for (const node of workflow.nodes) {
       const conn = connectionChildMeta.get(node.id);
       if (conn) {
-        const parentNode = workflow.nodes.find((n) => n.id === conn.parentNodeId);
+        const parentNode = nodesById.get(conn.parentNodeId);
         let role: string = conn.connectionName === "llm" ? "languageModel" : "tool";
         if (parentNode && AgentConfigInspector.isAgentNodeConfig(parentNode.config)) {
-          const descriptor = AgentConnectionNodeCollector.collect(conn.parentNodeId, parentNode.config).find(
-            (d) => d.nodeId === node.id,
-          );
+          const descriptor = agentConnectionDescriptors.byChildNodeIdByAgentNodeId.get(conn.parentNodeId)?.get(node.id);
           if (descriptor) {
             role = descriptor.role;
           }
@@ -87,6 +123,7 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
           icon: node.config?.icon,
           retryPolicySummary: this.policyUi.nodeRetrySummary(node.config),
           hasNodeErrorHandler: this.policyUi.nodeHasErrorHandler(node.config),
+          ...this.nodePortFieldsFromConfig(node.config),
           parentNodeId: conn.parentNodeId,
         });
         continue;
@@ -100,17 +137,32 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
         icon: node.config?.icon,
         retryPolicySummary: this.policyUi.nodeRetrySummary(node.config),
         hasNodeErrorHandler: this.policyUi.nodeHasErrorHandler(node.config),
+        ...this.nodePortFieldsFromConfig(node.config),
       });
       if (AgentConfigInspector.isAgentNodeConfig(node.config)) {
-        this.appendVirtualConnectionNodes(node.id, node.config, materializedConnectionNodeIds, nodes);
+        this.appendVirtualConnectionNodes(
+          materializedConnectionNodeIds,
+          nodes,
+          agentConnectionDescriptors.byAgentNodeId.get(node.id) ?? [],
+        );
       }
     }
     return nodes;
   }
 
-  private toEdges(workflow: WorkflowDefinition): WorkflowDto["edges"] {
-    const connectionChildMeta = this.buildConnectionChildMeta(workflow);
-    const materializedConnectionNodeIds = new Set(connectionChildMeta.keys());
+  private toEdges(
+    args: Readonly<{
+      workflow: WorkflowDefinition;
+      materializedConnectionNodeIds: ReadonlySet<string>;
+      agentConnectionDescriptors: Readonly<{
+        byAgentNodeId: ReadonlyMap<string, ReadonlyArray<AgentConnectionNodeDescriptor>>;
+        byChildNodeIdByAgentNodeId: ReadonlyMap<string, ReadonlyMap<string, AgentConnectionNodeDescriptor>>;
+      }>;
+    }>,
+  ): WorkflowDto["edges"] {
+    const workflow = args.workflow;
+    const materializedConnectionNodeIds = args.materializedConnectionNodeIds;
+    const agentConnectionDescriptors = args.agentConnectionDescriptors;
     const edges: WorkflowEdgeDto[] = [...workflow.edges];
     const edgeKeys = new Set(edges.map((edge) => this.edgeKey(edge.from.nodeId, edge.to.nodeId, edge.to.input)));
     this.appendMaterializedConnectionEdges(workflow, edgeKeys, edges);
@@ -118,7 +170,12 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
       if (!AgentConfigInspector.isAgentNodeConfig(node.config)) {
         continue;
       }
-      this.appendVirtualConnectionEdges(node.id, node.config, materializedConnectionNodeIds, edgeKeys, edges);
+      this.appendVirtualConnectionEdges(
+        materializedConnectionNodeIds,
+        edgeKeys,
+        edges,
+        agentConnectionDescriptors.byAgentNodeId.get(node.id) ?? [],
+      );
     }
     return edges;
   }
@@ -143,13 +200,33 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
     }
   }
 
+  private buildAgentConnectionDescriptorIndex(workflow: WorkflowDefinition): Readonly<{
+    byAgentNodeId: ReadonlyMap<string, ReadonlyArray<AgentConnectionNodeDescriptor>>;
+    byChildNodeIdByAgentNodeId: ReadonlyMap<string, ReadonlyMap<string, AgentConnectionNodeDescriptor>>;
+  }> {
+    const byAgentNodeId = new Map<string, ReadonlyArray<AgentConnectionNodeDescriptor>>();
+    const byChildNodeIdByAgentNodeId = new Map<string, ReadonlyMap<string, AgentConnectionNodeDescriptor>>();
+    for (const node of workflow.nodes) {
+      if (!AgentConfigInspector.isAgentNodeConfig(node.config)) {
+        continue;
+      }
+      const descriptors = AgentConnectionNodeCollector.collect(node.id, node.config);
+      byAgentNodeId.set(node.id, descriptors);
+      const byChildId = new Map<string, AgentConnectionNodeDescriptor>();
+      for (const descriptor of descriptors) {
+        byChildId.set(descriptor.nodeId, descriptor);
+      }
+      byChildNodeIdByAgentNodeId.set(node.id, byChildId);
+    }
+    return { byAgentNodeId, byChildNodeIdByAgentNodeId };
+  }
+
   private appendVirtualConnectionNodes(
-    rootAgentNodeId: string,
-    agentConfig: AgentNodeConfig<any, any>,
     materializedConnectionNodeIds: ReadonlySet<string>,
     nodes: WorkflowNodeDto[],
+    descriptors: ReadonlyArray<AgentConnectionNodeDescriptor>,
   ): void {
-    for (const connectionNode of AgentConnectionNodeCollector.collect(rootAgentNodeId, agentConfig)) {
+    for (const connectionNode of descriptors) {
       if (materializedConnectionNodeIds.has(connectionNode.nodeId)) {
         continue;
       }
@@ -158,13 +235,12 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
   }
 
   private appendVirtualConnectionEdges(
-    rootAgentNodeId: string,
-    agentConfig: AgentNodeConfig<any, any>,
     materializedConnectionNodeIds: ReadonlySet<string>,
     edgeKeys: Set<string>,
     edges: WorkflowEdgeDto[],
+    descriptors: ReadonlyArray<AgentConnectionNodeDescriptor>,
   ): void {
-    for (const connectionNode of AgentConnectionNodeCollector.collect(rootAgentNodeId, agentConfig)) {
+    for (const connectionNode of descriptors) {
       if (materializedConnectionNodeIds.has(connectionNode.nodeId)) {
         continue;
       }
@@ -196,6 +272,28 @@ export class WorkflowDefinitionMapper implements DataMapper<WorkflowDefinition,
     };
   }
 
+  /**
+   * Omit optional port fields when undefined so persisted snapshot DTOs (which never serialize
+   * undefined keys) stay aligned with live workflow mapping.
+   */
+  private nodePortFieldsFromConfig(
+    config: NodeDefinition["config"] | undefined,
+  ): Pick<WorkflowNodeDto, "continueWhenEmptyOutput" | "declaredOutputPorts" | "declaredInputPorts"> {
+    if (!config || typeof config !== "object") {
+      return {};
+    }
+    const c = config as {
+      continueWhenEmptyOutput?: boolean;
+      declaredOutputPorts?: readonly string[];
+      declaredInputPorts?: readonly string[];
+    };
+    return {
+      ...(c.continueWhenEmptyOutput !== undefined && { continueWhenEmptyOutput: c.continueWhenEmptyOutput }),
+      ...(c.declaredOutputPorts !== undefined && { declaredOutputPorts: c.declaredOutputPorts }),
+      ...(c.declaredInputPorts !== undefined && { declaredInputPorts: c.declaredInputPorts }),
+    };
+  }
+
   private nodeTypeName(node: NodeDefinition): string {
     const configToken = node.config?.type as Readonly<{ name?: unknown }> | undefined;
     if (typeof configToken?.name === "string" && configToken.name) {

package/src/bootstrap/AppContainerFactory.ts

@@ -63,6 +63,7 @@ import {
   GetRunStateQueryHandler,
   GetWorkflowDebuggerOverlayQueryHandler,
   GetWorkflowDetailQueryHandler,
+  GetWorkflowRunDetailQueryHandler,
   GetWorkflowOverlayBinaryAttachmentQueryHandler,
   GetWorkflowSummariesQueryHandler,
   ListWorkflowRunsQueryHandler,
@@ -194,6 +195,7 @@ export class AppContainerFactory {
     VerifyUserInviteQueryHandler,
     GetRunBinaryAttachmentQueryHandler,
     GetRunStateQueryHandler,
+    GetWorkflowRunDetailQueryHandler,
     GetWorkflowDebuggerOverlayQueryHandler,
     GetWorkflowDetailQueryHandler,
     GetWorkflowOverlayBinaryAttachmentQueryHandler,

package/src/domain/credentials/CredentialInstanceService.ts

@@ -23,6 +23,7 @@ import { ApplicationTokens } from "../../applicationTokens";
 
 import { CredentialFieldEnvOverlayService } from "./CredentialFieldEnvOverlayService";
 import { CredentialMaterialResolver } from "./CredentialMaterialResolver";
+import { CredentialOAuth2ScopeResolver } from "./CredentialOAuth2ScopeResolver";
 import { CredentialSecretCipher } from "./CredentialSecretCipher";
 import type {
   CredentialInstanceRecord,
@@ -49,6 +50,8 @@ export class CredentialInstanceService {
     private readonly credentialFieldEnvOverlayService: CredentialFieldEnvOverlayService,
     @inject(CredentialMaterialResolver)
     private readonly credentialMaterialResolver: CredentialMaterialResolver,
+    @inject(CredentialOAuth2ScopeResolver)
+    private readonly credentialOAuth2ScopeResolver: CredentialOAuth2ScopeResolver,
     @inject(CoreTokens.CredentialSessionService)
     private readonly credentialSessionService: MutableCredentialSessionService,
   ) {}
@@ -373,10 +376,14 @@ export class CredentialInstanceService {
       "providerId" in credentialType.definition.auth ? credentialType.definition.auth.providerId : "custom";
     const material = await this.credentialStore.getOAuth2Material(instance.instanceId);
     if (!material) {
+      const requestedScopes = this.credentialOAuth2ScopeResolver.resolveRequestedScopes(
+        credentialType.definition.auth,
+        instance.publicConfig,
+      );
       return {
         status: "disconnected",
         providerId,
-        scopes: [...credentialType.definition.auth.scopes],
+        scopes: [...requestedScopes],
       };
     }
     return {

package/src/domain/credentials/CredentialOAuth2ScopeResolver.ts

@@ -0,0 +1,61 @@
+import type { CredentialOAuth2AuthDefinition } from "@codemation/core";
+import { injectable } from "@codemation/core";
+import type { JsonRecord } from "./CredentialServices";
+
+@injectable()
+export class CredentialOAuth2ScopeResolver {
+  resolveRequestedScopes(auth: CredentialOAuth2AuthDefinition, publicConfig: JsonRecord): ReadonlyArray<string> {
+    const scopesFromPublicConfig = auth.scopesFromPublicConfig;
+    if (!scopesFromPublicConfig) {
+      return [...auth.scopes];
+    }
+    const preset = this.resolveString(publicConfig[scopesFromPublicConfig.presetFieldKey]);
+    if (!preset) {
+      return [...auth.scopes];
+    }
+    const presetScopes = scopesFromPublicConfig.presetScopes[preset];
+    if (presetScopes) {
+      return [...presetScopes];
+    }
+    const customPresetKey = scopesFromPublicConfig.customPresetKey ?? "custom";
+    if (preset !== customPresetKey) {
+      return [...auth.scopes];
+    }
+    const customScopes = this.resolveScopeList(
+      publicConfig[scopesFromPublicConfig.customScopesFieldKey ?? "customScopes"],
+    );
+    if (customScopes.length > 0) {
+      return customScopes;
+    }
+    return [...auth.scopes];
+  }
+
+  private resolveString(value: unknown): string | undefined {
+    if (typeof value !== "string") {
+      return undefined;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+  }
+
+  private resolveScopeList(value: unknown): ReadonlyArray<string> {
+    if (Array.isArray(value)) {
+      return this.dedupe(
+        value.map((entry) => (typeof entry === "string" ? entry.trim() : "")).filter((entry) => entry.length > 0),
+      );
+    }
+    if (typeof value !== "string") {
+      return [];
+    }
+    return this.dedupe(
+      value
+        .split(/[\s,]+/)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0),
+    );
+  }
+
+  private dedupe(entries: ReadonlyArray<string>): ReadonlyArray<string> {
+    return [...new Set(entries)];
+  }
+}

package/src/domain/credentials/CredentialServices.ts

@@ -138,6 +138,7 @@ export { CredentialTypeRegistryImpl } from "./CredentialTypeRegistryImpl";
 export { CredentialBindingService } from "./CredentialBindingService";
 export { CredentialInstanceService } from "./CredentialInstanceService";
 export { CredentialMaterialResolver } from "./CredentialMaterialResolver";
+export { CredentialOAuth2ScopeResolver } from "./CredentialOAuth2ScopeResolver";
 export { CredentialRuntimeMaterialService } from "./CredentialRuntimeMaterialService";
 export { CredentialFieldEnvOverlayService } from "./CredentialFieldEnvOverlayService";
 export { CredentialSecretCipher } from "./CredentialSecretCipher";

package/src/domain/credentials/OAuth2ConnectServiceFactory.ts

@@ -9,6 +9,7 @@ import {
   CredentialFieldEnvOverlayService,
   CredentialInstanceService,
   CredentialMaterialResolver,
+  CredentialOAuth2ScopeResolver,
   CredentialRuntimeMaterialService,
   CredentialSecretCipher,
   CredentialTypeRegistryImpl,
@@ -47,6 +48,8 @@ export class OAuth2ConnectService {
     private readonly credentialMaterialResolver: CredentialMaterialResolver,
     @inject(CredentialSecretCipher)
     private readonly credentialSecretCipher: CredentialSecretCipher,
+    @inject(CredentialOAuth2ScopeResolver)
+    private readonly credentialOAuth2ScopeResolver: CredentialOAuth2ScopeResolver,
     @inject(OAuth2ProviderRegistry)
     private readonly oauth2ProviderRegistry: OAuth2ProviderRegistry,
     @inject(ApplicationTokens.AppConfig)
@@ -63,6 +66,10 @@ export class OAuth2ConnectService {
       material: emptyMaterial,
     });
     const provider = this.oauth2ProviderRegistry.resolve(credentialType.definition, resolvedPublicConfig);
+    const requestedScopes = this.credentialOAuth2ScopeResolver.resolveRequestedScopes(
+      credentialType.definition.auth!,
+      resolvedPublicConfig,
+    );
     const redirectUri = this.getRedirectUri(requestOrigin);
     const state = this.createOpaqueValue();
     const codeVerifier = this.createOpaqueValue();
@@ -74,7 +81,7 @@ export class OAuth2ConnectService {
       instanceId,
       codeVerifier,
       providerId: provider.providerId,
-      requestedScopes: credentialType.definition.auth!.scopes,
+      requestedScopes,
       createdAt: createdAt.toISOString(),
       expiresAt: expiresAt.toISOString(),
     });
@@ -85,7 +92,7 @@ export class OAuth2ConnectService {
       this.oauth2ProviderRegistry.resolveClientId(credentialType.definition.auth!, resolvedPublicConfig),
     );
     authorizeUrl.searchParams.set("redirect_uri", redirectUri);
-    authorizeUrl.searchParams.set("scope", credentialType.definition.auth!.scopes.join(" "));
+    authorizeUrl.searchParams.set("scope", requestedScopes.join(" "));
     authorizeUrl.searchParams.set("state", state);
     authorizeUrl.searchParams.set("code_challenge", codeChallenge);
     authorizeUrl.searchParams.set("code_challenge_method", "S256");

package/src/presentation/http/routeHandlers/CredentialHttpRouteHandler.ts

@@ -121,7 +121,8 @@ export class CredentialHttpRouteHandler {
 
   async getWorkflowCredentialHealth(_: Request, params: ServerHttpRouteParams): Promise<Response> {
     try {
-      return Response.json(await this.queryBus.execute(new GetWorkflowCredentialHealthQuery(params.workflowId!)));
+      const health = await this.queryBus.execute(new GetWorkflowCredentialHealthQuery(params.workflowId!));
+      return Response.json(health);
     } catch (error) {
       return ServerHttpErrorResponseFactory.fromUnknown(error);
     }