@codemation/host 1.0.0 → 1.0.2

package/dist/{server-BE4PLhcb.js.map → server-CMUVhYIc.js.map}

@@ -1 +1 @@
-{"version":3,"file":"server-BE4PLhcb.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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"}
+{"version":3,"file":"server-CMUVhYIc.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.d.ts

@@ -1,12 +1,12 @@
-import "./index-W4eSjdCM.js";
-import "./CodemationAppContext-DP_-56c6.js";
+import "./index-BxIc_L4D.js";
+import "./CodemationAppContext-YgJRUHWF.js";
 import "./CodemationWhitelabelConfig-D5rYcLlj.js";
 import { n as InternalAuthBootstrap, r as FrontendAppConfig, t as PublicFrontendBootstrap } from "./PublicFrontendBootstrap-ci0Vwxrb.js";
 import { i as CodemationFrontendAuthSnapshotJsonCodec, n as InternalAuthBootstrapJsonCodec, r as FrontendAppConfigJsonCodec, t as PublicFrontendBootstrapJsonCodec } from "./PublicFrontendBootstrapJsonCodec-Ja0GQgpp.js";
-import "./CodemationConfigNormalizer-B8RGUwAe.js";
-import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-C_QVwcI3.js";
-import { r as PrismaDatabaseClient } from "./AppConfigFactory-PFmDg5Sg.js";
-import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-_pqP_0nw.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-Q5uwa6iR.js";
-import { i as CodemationFrontendAuthSnapshotFactory, n as InternalAuthBootstrapFactory, r as FrontendAppConfigFactory, t as PublicFrontendBootstrapFactory } from "./PublicFrontendBootstrapFactory-C_iLgPV-.js";
+import "./CodemationConfigNormalizer-BWBp7mFB.js";
+import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-Bka3v6lh.js";
+import { r as PrismaDatabaseClient } from "./AppConfigFactory-D3k-R3Ch.js";
+import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-BLG7_6B5.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-B0SD6Nvk.js";
+import { i as CodemationFrontendAuthSnapshotFactory, n as InternalAuthBootstrapFactory, r as FrontendAppConfigFactory, t as PublicFrontendBootstrapFactory } from "./PublicFrontendBootstrapFactory-DkQoSYDo.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

@@ -5,9 +5,9 @@ import "./ServerLoggerFactory-CsNW5qhz.js";
 import "./decorateParam-D7WPDFAf.js";
 import "./decorate-Dq0XLibd.js";
 import "./CredentialServices-BNBMFOPt.js";
-import { _ as FrontendAppConfigFactory, b as ApiPaths, g as InternalAuthBootstrapFactory, h as PublicFrontendBootstrapFactory, v as CodemationFrontendAuthSnapshotFactory } from "./AppContainerFactory-Cr3JeVmg.js";
-import "./AppConfigFactory-BPp02HMv.js";
-import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-CA0_q0D7.js";
-import { n as AppConfigLoader, r as CodemationServerGateway, t as CodemationPluginDiscovery } from "./server-BE4PLhcb.js";
+import { _ as FrontendAppConfigFactory, b as ApiPaths, g as InternalAuthBootstrapFactory, h as PublicFrontendBootstrapFactory, v as CodemationFrontendAuthSnapshotFactory } from "./AppContainerFactory-CKRDz8kQ.js";
+import "./AppConfigFactory-C4OXGOs2.js";
+import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-KyHL0u01.js";
+import { n as AppConfigLoader, r as CodemationServerGateway, t as CodemationPluginDiscovery } from "./server-CMUVhYIc.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": "1.0.0",
+  "version": "1.0.2",
   "publishConfig": {
     "access": "public"
   },
@@ -121,9 +121,9 @@
     "tsx": "^4.21.0",
     "ws": "^8.19.0",
     "zxcvbn": "^4.4.2",
-    "@codemation/core": "1.0.0",
-    "@codemation/eventbus-redis": "0.0.32",
-    "@codemation/core-nodes": "1.0.0"
+    "@codemation/core": "1.0.1",
+    "@codemation/eventbus-redis": "0.0.33",
+    "@codemation/core-nodes": "1.0.2"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",
@@ -149,7 +149,7 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
     "zod": "^4.3.6",
-    "@codemation/core-nodes-gmail": "0.1.6"
+    "@codemation/core-nodes-gmail": "0.1.7"
   },
   "scripts": {
     "changeset:verify": "pnpm --workspace-root run changeset:verify",

package/prisma/migrations/20260430120000_telemetry_iteration_identity/migration.sql

@@ -0,0 +1,17 @@
+-- Add per-item iteration identity columns to telemetry tables.
+-- See docs in @codemation/host telemetry attribute names: codemation.iteration.id,
+-- codemation.iteration.index, codemation.parent.invocation_id.
+
+ALTER TABLE "TelemetrySpan"
+  ADD COLUMN "iteration_id" TEXT,
+  ADD COLUMN "item_index" INTEGER,
+  ADD COLUMN "parent_invocation_id" TEXT;
+
+CREATE INDEX "TelemetrySpan_iteration_id_idx" ON "TelemetrySpan"("iteration_id");
+
+ALTER TABLE "TelemetryMetricPoint"
+  ADD COLUMN "iteration_id" TEXT,
+  ADD COLUMN "item_index" INTEGER,
+  ADD COLUMN "parent_invocation_id" TEXT;
+
+CREATE INDEX "TelemetryMetricPoint_iteration_id_idx" ON "TelemetryMetricPoint"("iteration_id");

package/prisma/migrations/20260430130000_execution_instance_iteration_identity/migration.sql

@@ -0,0 +1,11 @@
+-- Add per-item iteration identity columns to ExecutionInstance (Postgres).
+-- These are required so connection invocations restored from disk preserve the
+-- per-item identity that the engine stamps on them at runtime; the bottom
+-- execution tree groups invocations by iterationId to render synthetic
+-- "Item N" parent rows when an agent processed 2+ items.
+ALTER TABLE "ExecutionInstance"
+  ADD COLUMN "iteration_id" TEXT,
+  ADD COLUMN "item_index" INTEGER,
+  ADD COLUMN "parent_invocation_id" TEXT;
+
+CREATE INDEX "ExecutionInstance_iteration_id_idx" ON "ExecutionInstance"("iteration_id");

package/prisma/migrations.sqlite/20260430120000_telemetry_iteration_identity/migration.sql

@@ -0,0 +1,14 @@
+-- Add per-item iteration identity columns to telemetry tables (SQLite).
+-- See @codemation/host telemetry attribute names: codemation.iteration.id,
+-- codemation.iteration.index, codemation.parent.invocation_id.
+ALTER TABLE "TelemetrySpan" ADD COLUMN "iteration_id" TEXT;
+ALTER TABLE "TelemetrySpan" ADD COLUMN "item_index" INTEGER;
+ALTER TABLE "TelemetrySpan" ADD COLUMN "parent_invocation_id" TEXT;
+
+CREATE INDEX "TelemetrySpan_iteration_id_idx" ON "TelemetrySpan"("iteration_id");
+
+ALTER TABLE "TelemetryMetricPoint" ADD COLUMN "iteration_id" TEXT;
+ALTER TABLE "TelemetryMetricPoint" ADD COLUMN "item_index" INTEGER;
+ALTER TABLE "TelemetryMetricPoint" ADD COLUMN "parent_invocation_id" TEXT;
+
+CREATE INDEX "TelemetryMetricPoint_iteration_id_idx" ON "TelemetryMetricPoint"("iteration_id");

package/prisma/migrations.sqlite/20260430130000_execution_instance_iteration_identity/migration.sql

@@ -0,0 +1,10 @@
+-- Add per-item iteration identity columns to ExecutionInstance (SQLite).
+-- These are required so connection invocations restored from disk preserve the
+-- per-item identity that the engine stamps on them at runtime; the bottom
+-- execution tree groups invocations by iterationId to render synthetic
+-- "Item N" parent rows when an agent processed 2+ items.
+ALTER TABLE "ExecutionInstance" ADD COLUMN "iteration_id" TEXT;
+ALTER TABLE "ExecutionInstance" ADD COLUMN "item_index" INTEGER;
+ALTER TABLE "ExecutionInstance" ADD COLUMN "parent_invocation_id" TEXT;
+
+CREATE INDEX "ExecutionInstance_iteration_id_idx" ON "ExecutionInstance"("iteration_id");

package/prisma/schema.postgresql.prisma

@@ -95,12 +95,16 @@ model ExecutionInstance {
   inputTruncated      Boolean? @map("input_truncated")
   outputTruncated     Boolean? @map("output_truncated")
   usedPinnedOutput    Boolean? @map("used_pinned_output")
+  iterationId         String?  @map("iteration_id")
+  itemIndex           Int?     @map("item_index")
+  parentInvocationId  String?  @map("parent_invocation_id")
 
   run Run @relation(fields: [runId], references: [runId], onDelete: Cascade)
 
   @@index([runId, slotNodeId, updatedAt])
   @@index([runId, parentInstanceId, updatedAt])
   @@index([runId, kind, updatedAt])
+  @@index([iterationId])
   @@unique([runId, slotNodeId, runIndex])
 }
 
@@ -173,6 +177,9 @@ model TelemetrySpan {
   attributesJson            String? @map("attributes_json")
   eventsJson                String? @map("events_json")
   retentionExpiresAt        String? @map("retention_expires_at")
+  iterationId               String? @map("iteration_id")
+  itemIndex                 Int?    @map("item_index")
+  parentInvocationId        String? @map("parent_invocation_id")
   updatedAt                 String  @map("updated_at")
 
   @@unique([traceId, spanId])
@@ -182,6 +189,7 @@ model TelemetrySpan {
   @@index([runId, endTime])
   @@index([modelName, endTime])
   @@index([connectionInvocationId])
+  @@index([iterationId])
   @@index([retentionExpiresAt])
 }
 
@@ -229,12 +237,16 @@ model TelemetryMetricPoint {
   modelName          String? @map("model_name")
   dimensionsJson     String? @map("dimensions_json")
   retentionExpiresAt String? @map("retention_expires_at")
+  iterationId        String? @map("iteration_id")
+  itemIndex          Int?    @map("item_index")
+  parentInvocationId String? @map("parent_invocation_id")
 
   @@index([workflowId, observedAt])
   @@index([workflowId, metricName, observedAt])
   @@index([runId, observedAt])
   @@index([traceId, observedAt])
   @@index([modelName, observedAt])
+  @@index([iterationId])
   @@index([retentionExpiresAt])
 }
 

package/prisma/schema.sqlite.prisma

@@ -96,12 +96,16 @@ model ExecutionInstance {
   inputTruncated      Boolean? @map("input_truncated")
   outputTruncated     Boolean? @map("output_truncated")
   usedPinnedOutput    Boolean? @map("used_pinned_output")
+  iterationId         String?  @map("iteration_id")
+  itemIndex           Int?     @map("item_index")
+  parentInvocationId  String?  @map("parent_invocation_id")
 
   run Run @relation(fields: [runId], references: [runId], onDelete: Cascade)
 
   @@index([runId, slotNodeId, updatedAt])
   @@index([runId, parentInstanceId, updatedAt])
   @@index([runId, kind, updatedAt])
+  @@index([iterationId])
   @@unique([runId, slotNodeId, runIndex])
 }
 
@@ -174,6 +178,9 @@ model TelemetrySpan {
   attributesJson           String? @map("attributes_json")
   eventsJson               String? @map("events_json")
   retentionExpiresAt       String? @map("retention_expires_at")
+  iterationId              String? @map("iteration_id")
+  itemIndex                Int?    @map("item_index")
+  parentInvocationId       String? @map("parent_invocation_id")
   updatedAt                String  @map("updated_at")
 
   @@unique([traceId, spanId])
@@ -183,6 +190,7 @@ model TelemetrySpan {
   @@index([runId, endTime])
   @@index([modelName, endTime])
   @@index([connectionInvocationId])
+  @@index([iterationId])
   @@index([retentionExpiresAt])
 }
 
@@ -230,12 +238,16 @@ model TelemetryMetricPoint {
   modelName          String? @map("model_name")
   dimensionsJson     String? @map("dimensions_json")
   retentionExpiresAt String? @map("retention_expires_at")
+  iterationId        String? @map("iteration_id")
+  itemIndex          Int?    @map("item_index")
+  parentInvocationId String? @map("parent_invocation_id")
 
   @@index([workflowId, observedAt])
   @@index([workflowId, metricName, observedAt])
   @@index([runId, observedAt])
   @@index([traceId, observedAt])
   @@index([modelName, observedAt])
+  @@index([iterationId])
   @@index([retentionExpiresAt])
 }
 

package/src/application/contracts/IterationCostContracts.ts

@@ -0,0 +1,11 @@
+/**
+ * Per-iteration cost rollup, derived from `codemation.cost.estimated` metric points
+ * grouped by `iterationId` and currency.
+ */
+export interface IterationCostRollupDto {
+  readonly iterationId: string;
+  /** Sum of cost in minor units (per `cost.currency_scale`) keyed by ISO currency code. */
+  readonly estimatedCostMinorByCurrency: Readonly<Record<string, number>>;
+  /** Currency scale (denominator) per currency, when present on the metric points. */
+  readonly estimatedCostCurrencyScaleByCurrency: Readonly<Record<string, number>>;
+}

package/src/application/queries/GetIterationCostQuery.ts

@@ -0,0 +1,14 @@
+import { Query } from "../bus/Query";
+import type { IterationCostRollupDto } from "../contracts/IterationCostContracts";
+
+/**
+ * Query that returns a per-iteration cost rollup for a single run.
+ *
+ * The rollup is keyed by `iterationId` and contains the sum of
+ * `codemation.cost.estimated` metric points grouped by ISO currency code.
+ */
+export class GetIterationCostQuery extends Query<ReadonlyArray<IterationCostRollupDto>> {
+  constructor(public readonly runId: string) {
+    super();
+  }
+}

package/src/application/queries/GetIterationCostQueryHandler.ts

@@ -0,0 +1,92 @@
+import { CostTrackingTelemetryAttributeNames, CostTrackingTelemetryMetricNames, inject } from "@codemation/core";
+import { ApplicationTokens } from "../../applicationTokens";
+import type { TelemetryMetricPointRecord, TelemetryMetricPointStore } from "../../domain/telemetry/TelemetryContracts";
+import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
+import { QueryHandler } from "../bus/QueryHandler";
+import type { IterationCostRollupDto } from "../contracts/IterationCostContracts";
+import { GetIterationCostQuery } from "./GetIterationCostQuery";
+
+interface MutableCostBucket {
+  readonly iterationId: string;
+  readonly estimatedCostMinorByCurrency: Record<string, number>;
+  readonly estimatedCostCurrencyScaleByCurrency: Record<string, number>;
+}
+
+@HandlesQuery.for(GetIterationCostQuery)
+export class GetIterationCostQueryHandler extends QueryHandler<
+  GetIterationCostQuery,
+  ReadonlyArray<IterationCostRollupDto>
+> {
+  constructor(
+    @inject(ApplicationTokens.TelemetryMetricPointStore)
+    private readonly metricPointStore: TelemetryMetricPointStore,
+  ) {
+    super();
+  }
+
+  async execute(query: GetIterationCostQuery): Promise<ReadonlyArray<IterationCostRollupDto>> {
+    const points = await this.metricPointStore.list({
+      runId: query.runId,
+      metricNames: [CostTrackingTelemetryMetricNames.estimatedCost],
+    });
+    if (points.length === 0) {
+      return [];
+    }
+    const buckets = new Map<string, MutableCostBucket>();
+    for (const point of points) {
+      this.accumulate(point, buckets);
+    }
+    return [...buckets.values()].map((bucket) => ({
+      iterationId: bucket.iterationId,
+      estimatedCostMinorByCurrency: { ...bucket.estimatedCostMinorByCurrency },
+      estimatedCostCurrencyScaleByCurrency: { ...bucket.estimatedCostCurrencyScaleByCurrency },
+    }));
+  }
+
+  private accumulate(point: TelemetryMetricPointRecord, buckets: Map<string, MutableCostBucket>): void {
+    const iterationId = point.iterationId;
+    if (!iterationId || iterationId.length === 0) {
+      return;
+    }
+    const currency = this.readCurrency(point);
+    if (!currency) {
+      return;
+    }
+    const currencyScale = this.readCurrencyScale(point);
+    const bucket = this.bucketFor(iterationId, buckets);
+    bucket.estimatedCostMinorByCurrency[currency] = (bucket.estimatedCostMinorByCurrency[currency] ?? 0) + point.value;
+    if (typeof currencyScale === "number") {
+      bucket.estimatedCostCurrencyScaleByCurrency[currency] = currencyScale;
+    }
+  }
+
+  private bucketFor(iterationId: string, buckets: Map<string, MutableCostBucket>): MutableCostBucket {
+    const existing = buckets.get(iterationId);
+    if (existing) {
+      return existing;
+    }
+    const bucket: MutableCostBucket = {
+      iterationId,
+      estimatedCostMinorByCurrency: {},
+      estimatedCostCurrencyScaleByCurrency: {},
+    };
+    buckets.set(iterationId, bucket);
+    return bucket;
+  }
+
+  private readCurrency(point: TelemetryMetricPointRecord): string | undefined {
+    const fromAttribute = point.dimensions?.[CostTrackingTelemetryAttributeNames.currency];
+    if (typeof fromAttribute === "string" && fromAttribute.length > 0) {
+      return fromAttribute;
+    }
+    if (typeof point.unit === "string" && point.unit.length > 0) {
+      return point.unit;
+    }
+    return undefined;
+  }
+
+  private readCurrencyScale(point: TelemetryMetricPointRecord): number | undefined {
+    const value = point.dimensions?.[CostTrackingTelemetryAttributeNames.currencyScale];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+  }
+}

package/src/application/queries/GetWorkflowRunDetailQueryHandler.ts

@@ -1,10 +1,14 @@
-import type { WorkflowRunDetailDto } from "@codemation/core";
+import type { RunIterationDto, WorkflowRunDetailDto } from "@codemation/core";
 import { inject } from "@codemation/core";
 import { ApplicationTokens } from "../../applicationTokens";
 import type { WorkflowRunRepository } from "../../domain/runs/WorkflowRunRepository";
 import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
 import { QueryHandler } from "../bus/QueryHandler";
+import type { IterationCostRollupDto } from "../contracts/IterationCostContracts";
+import { GetIterationCostQuery } from "./GetIterationCostQuery";
+import { GetIterationCostQueryHandler } from "./GetIterationCostQueryHandler";
 import { GetWorkflowRunDetailQuery } from "./GetWorkflowRunDetailQuery";
+import { RunIterationProjectionFactory } from "./RunIterationProjectionFactory";
 
 @HandlesQuery.for(GetWorkflowRunDetailQuery)
 export class GetWorkflowRunDetailQueryHandler extends QueryHandler<
@@ -14,11 +18,49 @@ export class GetWorkflowRunDetailQueryHandler extends QueryHandler<
   constructor(
     @inject(ApplicationTokens.WorkflowRunRepository)
     private readonly workflowRunRepository: WorkflowRunRepository,
+    @inject(RunIterationProjectionFactory)
+    private readonly runIterationProjectionFactory: RunIterationProjectionFactory,
+    @inject(GetIterationCostQueryHandler)
+    private readonly getIterationCostQueryHandler: GetIterationCostQueryHandler,
   ) {
     super();
   }
 
   async execute(query: GetWorkflowRunDetailQuery): Promise<WorkflowRunDetailDto | undefined> {
-    return await this.workflowRunRepository.loadRunDetail?.(query.runId);
+    const detail = await this.workflowRunRepository.loadRunDetail?.(query.runId);
+    if (!detail) {
+      return undefined;
+    }
+    const baseIterations = this.runIterationProjectionFactory.project(detail.executionInstances);
+    const iterations = await this.joinIterationCosts(query.runId, baseIterations);
+    return { ...detail, iterations };
+  }
+
+  private async joinIterationCosts(
+    runId: string,
+    iterations: ReadonlyArray<RunIterationDto>,
+  ): Promise<ReadonlyArray<RunIterationDto>> {
+    if (iterations.length === 0) {
+      return iterations;
+    }
+    const rollups = await this.getIterationCostQueryHandler.execute(new GetIterationCostQuery(runId));
+    if (rollups.length === 0) {
+      return iterations;
+    }
+    const rollupsByIterationId = new Map<string, IterationCostRollupDto>();
+    for (const rollup of rollups) {
+      rollupsByIterationId.set(rollup.iterationId, rollup);
+    }
+    return iterations.map((iteration) => {
+      const rollup = rollupsByIterationId.get(iteration.iterationId);
+      if (!rollup) {
+        return iteration;
+      }
+      return {
+        ...iteration,
+        estimatedCostMinorByCurrency: rollup.estimatedCostMinorByCurrency,
+        estimatedCostCurrencyScaleByCurrency: rollup.estimatedCostCurrencyScaleByCurrency,
+      };
+    });
   }
 }

package/src/application/queries/RunIterationProjectionFactory.ts

@@ -0,0 +1,123 @@
+import {
+  injectable,
+  type ExecutionInstanceDto,
+  type NodeExecutionStatus,
+  type RunIterationDto,
+} from "@codemation/core";
+
+/**
+ * Builds the per-iteration projection from a run's connection invocations.
+ *
+ * One iteration represents a single item being processed by an agent within an activation. All
+ * invocations (LLM rounds, tool calls) emitted while handling that item share the same iterationId
+ * and project into one {@link RunIterationDto}.
+ *
+ * Old runs (persisted before iteration ids existed) fall back to grouping by the agent
+ * activationId so the UI still sees coherent groups instead of a flat list.
+ */
+@injectable()
+export class RunIterationProjectionFactory {
+  project(executionInstances: ReadonlyArray<ExecutionInstanceDto>): ReadonlyArray<RunIterationDto> {
+    const invocations = executionInstances.filter((row) => row.kind === "connectionInvocation");
+    if (invocations.length === 0) {
+      return [];
+    }
+    const grouped = new Map<string, ExecutionInstanceDto[]>();
+    for (const invocation of invocations) {
+      const key = this.iterationKey(invocation);
+      if (!key) {
+        continue;
+      }
+      const bucket = grouped.get(key);
+      if (bucket) {
+        bucket.push(invocation);
+      } else {
+        grouped.set(key, [invocation]);
+      }
+    }
+    const iterations: RunIterationDto[] = [];
+    for (const [key, group] of grouped.entries()) {
+      iterations.push(this.toIteration(key, group));
+    }
+    iterations.sort((left, right) => this.compareIterations(left, right));
+    return iterations;
+  }
+
+  private iterationKey(invocation: ExecutionInstanceDto): string | undefined {
+    if (invocation.iterationId) {
+      return invocation.iterationId;
+    }
+    if (invocation.activationId) {
+      return `legacy::${invocation.workflowNodeId}::${invocation.activationId}::${invocation.itemIndex ?? 0}`;
+    }
+    return undefined;
+  }
+
+  private toIteration(iterationKey: string, group: ReadonlyArray<ExecutionInstanceDto>): RunIterationDto {
+    const sorted = [...group].sort((a, b) => this.compareInvocations(a, b));
+    const first = sorted[0]!;
+    const status = this.aggregateStatus(sorted);
+    const iterationId = first.iterationId ?? iterationKey;
+    return {
+      iterationId,
+      agentNodeId: first.workflowNodeId,
+      activationId: first.activationId ?? "synthetic",
+      itemIndex: first.itemIndex ?? 0,
+      status,
+      startedAt: this.minIso(sorted.map((row) => row.startedAt)),
+      finishedAt: status === "running" ? undefined : this.maxIso(sorted.map((row) => row.finishedAt)),
+      invocationIds: sorted.map((row) => row.instanceId),
+      parentInvocationId: first.parentInvocationId,
+    };
+  }
+
+  private aggregateStatus(group: ReadonlyArray<ExecutionInstanceDto>): NodeExecutionStatus {
+    if (group.some((row) => row.status === "failed")) {
+      return "failed";
+    }
+    if (group.every((row) => row.status === "completed")) {
+      return "completed";
+    }
+    return "running";
+  }
+
+  private minIso(values: ReadonlyArray<string | undefined>): string | undefined {
+    let min: string | undefined;
+    for (const value of values) {
+      if (!value) continue;
+      if (!min || value < min) {
+        min = value;
+      }
+    }
+    return min;
+  }
+
+  private maxIso(values: ReadonlyArray<string | undefined>): string | undefined {
+    let max: string | undefined;
+    for (const value of values) {
+      if (!value) continue;
+      if (!max || value > max) {
+        max = value;
+      }
+    }
+    return max;
+  }
+
+  private compareInvocations(left: ExecutionInstanceDto, right: ExecutionInstanceDto): number {
+    const leftStart = left.startedAt ?? left.queuedAt ?? "";
+    const rightStart = right.startedAt ?? right.queuedAt ?? "";
+    if (leftStart !== rightStart) {
+      return leftStart.localeCompare(rightStart);
+    }
+    return left.runIndex - right.runIndex;
+  }
+
+  private compareIterations(left: RunIterationDto, right: RunIterationDto): number {
+    if (left.itemIndex !== right.itemIndex) {
+      return left.itemIndex - right.itemIndex;
+    }
+    const leftStart = left.startedAt ?? "";
+    const rightStart = right.startedAt ?? "";
+    return leftStart.localeCompare(rightStart);
+  }
+}

package/src/application/queries/WorkflowQueryHandlers.ts

@@ -5,6 +5,7 @@ export { GetTelemetryDashboardRunsQueryHandler } from "./GetTelemetryDashboardRu
 export { GetTelemetryRunTraceQueryHandler } from "./GetTelemetryRunTraceQueryHandler";
 export { GetTelemetryDashboardSummaryQueryHandler } from "./GetTelemetryDashboardSummaryQueryHandler";
 export { GetTelemetryDashboardTimeseriesQueryHandler } from "./GetTelemetryDashboardTimeseriesQueryHandler";
+export { GetIterationCostQueryHandler } from "./GetIterationCostQueryHandler";
 export { GetWorkflowRunDetailQueryHandler } from "./GetWorkflowRunDetailQueryHandler";
 export { GetWorkflowDebuggerOverlayQueryHandler } from "./GetWorkflowDebuggerOverlayQueryHandler";
 export { GetWorkflowDetailQueryHandler } from "./GetWorkflowDetailQueryHandler";