@codemation/host 0.2.0 → 0.2.2

package/dist/{ServerLoggerFactory-BltIIDfQ.js.map → ServerLoggerFactory-CsNW5qhz.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ServerLoggerFactory-BltIIDfQ.js","names":["levelRank: Record<Exclude<LogLevel, \"silent\">, number>","compiled: { matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }[]","inner: Logger","scope: string","filter: LogFilter","ServerLoggerFactory","logLevelPolicyFactory: LogLevelPolicyFactory","ServerLogger"],"sources":["../src/infrastructure/logging/LogLevelPolicy.ts","../src/infrastructure/logging/LogLevelPolicyFactory.ts","../src/infrastructure/logging/FilteringLogger.ts","../src/infrastructure/logging/PerformanceLogPolicy.ts","../src/infrastructure/logging/PerformanceLogPolicyFactory.ts","../src/infrastructure/logging/ServerLoggerFactory.ts"],"sourcesContent":["import type { CodemationLogConfig, CodemationLogRule } from \"../../presentation/config/CodemationLogConfig\";\n\nexport type LogLevel = \"silent\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst levelRank: Record<Exclude<LogLevel, \"silent\">, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nconst globRegexMetaChars = new Set(\"\\\\^$+?()[]{}|.\");\n\n/**\n * Minimum log level for @codemation/host loggers.\n * - `CODEMATION_LOG_LEVEL` overrides when set to a known level (for namespaces not matched by `codemation.config` log rules).\n * - Under Vitest, defaults to **warn** so routine `info`/`debug` noise stays off the terminal; `warn`/`error` still print.\n * - Otherwise defaults to **info**.\n *\n * When {@link applyCodemationLogConfig} is set, the first matching rule wins per namespace; unmatched namespaces use env defaults.\n *\n * Resolve a shared instance via {@link LogLevelPolicyFactory} (DI or `logLevelPolicyFactory`).\n */\nexport class LogLevelPolicy {\n  private cachedMin: LogLevel | undefined;\n\n  private codemationRules: ReadonlyArray<{ matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }> | null = null;\n\n  resolveMin(): LogLevel {\n    const raw = process.env.CODEMATION_LOG_LEVEL?.toLowerCase();\n    if (raw === \"silent\" || raw === \"debug\" || raw === \"info\" || raw === \"warn\" || raw === \"error\") {\n      return raw;\n    }\n    if (process.env.VITEST === \"true\") {\n      return \"warn\";\n    }\n    return \"info\";\n  }\n\n  private minLevelCached(): LogLevel {\n    if (this.cachedMin === undefined) {\n      this.cachedMin = this.resolveMin();\n    }\n    return this.cachedMin;\n  }\n\n  resetForTests(): void {\n    this.cachedMin = undefined;\n    this.codemationRules = null;\n  }\n\n  /**\n   * Applies `codemation.config` log rules. Pass `undefined` to clear rules and use env-only behavior.\n   */\n  applyCodemationLogConfig(config: CodemationLogConfig | undefined): void {\n    this.codemationRules = null;\n    if (!config) {\n      return;\n    }\n    const rawRules = this.normalizeCodemationRules(config);\n    if (rawRules.length === 0) {\n      return;\n    }\n    const compiled: { matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }[] = [];\n    for (const rule of rawRules) {\n      const minLevel = this.parseRuleLevel(rule.level);\n      const patterns = this.normalizeFilterPatterns(rule.filter);\n      if (patterns.length === 0) {\n        throw new Error(\"codemation.config log rule filter must include at least one pattern\");\n      }\n      const matchers = patterns.map((pattern) => this.compileGlobPattern(pattern));\n      compiled.push({\n        matchers,\n        minLevel,\n      });\n    }\n    this.codemationRules = compiled;\n  }\n\n  shouldEmit(level: Exclude<LogLevel, \"silent\">, namespace: string): boolean {\n    if (this.codemationRules && this.codemationRules.length > 0) {\n      for (const rule of this.codemationRules) {\n        if (rule.matchers.some((regex) => regex.test(namespace))) {\n          return this.levelPassesAgainstMin(level, rule.minLevel);\n        }\n      }\n    }\n    return this.levelPassesAgainstMin(level, this.minLevelCached());\n  }\n\n  private normalizeCodemationRules(config: CodemationLogConfig): ReadonlyArray<CodemationLogRule> {\n    if (\"rules\" in config && Array.isArray(config.rules)) {\n      return [...config.rules];\n    }\n    return [config as CodemationLogRule];\n  }\n\n  private normalizeFilterPatterns(filter: string | ReadonlyArray<string>): ReadonlyArray<string> {\n    if (typeof filter === \"string\") {\n      return [filter];\n    }\n    return [...filter];\n  }\n\n  /**\n   * Glob: only `*` is special (matches any substring). A lone `*` matches all namespaces.\n   */\n  private compileGlobPattern(pattern: string): RegExp {\n    const trimmed = pattern.trim();\n    if (trimmed === \"*\") {\n      return /^.*$/;\n    }\n    let body = \"\";\n    for (const ch of trimmed) {\n      if (ch === \"*\") {\n        body += \".*\";\n        continue;\n      }\n      if (globRegexMetaChars.has(ch)) {\n        body += \"\\\\\" + ch;\n        continue;\n      }\n      body += ch;\n    }\n    return new RegExp(\"^\" + body + \"$\");\n  }\n\n  private parseRuleLevel(level: string): LogLevel {\n    const normalized = level.toLowerCase();\n    if (\n      normalized === \"silent\" ||\n      normalized === \"debug\" ||\n      normalized === \"info\" ||\n      normalized === \"warn\" ||\n      normalized === \"error\"\n    ) {\n      return normalized;\n    }\n    throw new Error(`Invalid codemation.config log level: ${level}`);\n  }\n\n  private levelPassesAgainstMin(level: Exclude<LogLevel, \"silent\">, min: LogLevel): boolean {\n    if (min === \"silent\") {\n      return false;\n    }\n    return levelRank[level] >= levelRank[min];\n  }\n}\n","import { LogLevelPolicy } from \"./LogLevelPolicy\";\n\n/**\n * Process-wide {@link LogLevelPolicy} singleton for server and browser loggers.\n * Plain class (no `@injectable` from `@codemation/core`): client components import this file; decorating would pull core into the browser bundle.\n */\nexport class LogLevelPolicyFactory {\n  private readonly policy = new LogLevelPolicy();\n\n  create(): LogLevelPolicy {\n    return this.policy;\n  }\n}\n\n/** Shared factory for call sites outside the DI container (e.g. next-host bootstrap). */\nexport const logLevelPolicyFactory = new LogLevelPolicyFactory();\n","import type { LogFilter } from \"../../application/logging/LogFilter\";\nimport type { Logger } from \"../../application/logging/Logger\";\n\nexport class FilteringLogger implements Logger {\n  constructor(\n    private readonly inner: Logger,\n    private readonly scope: string,\n    private readonly filter: LogFilter,\n  ) {}\n\n  info(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"info\", message })) {\n      return;\n    }\n    this.inner.info(message, exception);\n  }\n\n  warn(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"warn\", message })) {\n      return;\n    }\n    this.inner.warn(message, exception);\n  }\n\n  error(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"error\", message })) {\n      return;\n    }\n    this.inner.error(message, exception);\n  }\n\n  debug(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"debug\", message })) {\n      return;\n    }\n    this.inner.debug(message, exception);\n  }\n}\n","/**\n * Opt-in detailed timing / diagnostics lines (used with `ServerLoggerFactory#createPerformanceDiagnostics`).\n *\n * Set `CODEMATION_PERFORMANCE_LOGGING=true` to enable. Otherwise those loggers are silent regardless of level.\n */\nexport class PerformanceLogPolicy {\n  shouldEmitDetailedTiming(): boolean {\n    return process.env.CODEMATION_PERFORMANCE_LOGGING === \"true\";\n  }\n}\n","import { PerformanceLogPolicy } from \"./PerformanceLogPolicy\";\n\n/**\n * Process-wide {@link PerformanceLogPolicy} singleton (same pattern as {@link LogLevelPolicyFactory}).\n */\nexport class PerformanceLogPolicyFactory {\n  private readonly policy = new PerformanceLogPolicy();\n\n  create(): PerformanceLogPolicy {\n    return this.policy;\n  }\n}\n\nexport const performanceLogPolicyFactory = new PerformanceLogPolicyFactory();\n","import { inject, injectable } from \"@codemation/core\";\n\nimport type { LogFilter } from \"../../application/logging/LogFilter\";\nimport type { Logger, LoggerFactory } from \"../../application/logging/Logger\";\n\nimport { FilteringLogger } from \"./FilteringLogger\";\nimport { LogLevelPolicyFactory } from \"./LogLevelPolicyFactory\";\nimport { performanceLogPolicyFactory } from \"./PerformanceLogPolicyFactory\";\nimport { ServerLogger } from \"./ServerLogger\";\n\n@injectable()\nexport class ServerLoggerFactory implements LoggerFactory {\n  constructor(@inject(LogLevelPolicyFactory) private readonly logLevelPolicyFactory: LogLevelPolicyFactory) {}\n\n  create(scope: string): Logger {\n    return new ServerLogger(scope, this.logLevelPolicyFactory.create());\n  }\n\n  createFiltered(scope: string, filter: LogFilter): Logger {\n    return new FilteringLogger(this.create(scope), scope, filter);\n  }\n\n  createPerformanceDiagnostics(scope: string): Logger {\n    return this.createFiltered(scope, (_entry) => performanceLogPolicyFactory.create().shouldEmitDetailedTiming());\n  }\n}\n\nexport { ServerLogger } from \"./ServerLogger\";\n"],"mappings":"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"}
+{"version":3,"file":"ServerLoggerFactory-CsNW5qhz.js","names":["levelRank: Record<Exclude<LogLevel, \"silent\">, number>","compiled: { matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }[]","inner: Logger","scope: string","filter: LogFilter","ServerLoggerFactory","logLevelPolicyFactory: LogLevelPolicyFactory","ServerLogger"],"sources":["../src/infrastructure/logging/LogLevelPolicy.ts","../src/infrastructure/logging/LogLevelPolicyFactory.ts","../src/infrastructure/logging/FilteringLogger.ts","../src/infrastructure/logging/PerformanceLogPolicy.ts","../src/infrastructure/logging/PerformanceLogPolicyFactory.ts","../src/infrastructure/logging/ServerLoggerFactory.ts"],"sourcesContent":["import type { CodemationLogConfig, CodemationLogRule } from \"../../presentation/config/CodemationLogConfig\";\n\nexport type LogLevel = \"silent\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst levelRank: Record<Exclude<LogLevel, \"silent\">, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nconst globRegexMetaChars = new Set(\"\\\\^$+?()[]{}|.\");\n\n/**\n * Minimum log level for @codemation/host loggers.\n * - `CODEMATION_LOG_LEVEL` overrides when set to a known level (for namespaces not matched by `codemation.config` log rules).\n * - Under Vitest, defaults to **warn** so routine `info`/`debug` noise stays off the terminal; `warn`/`error` still print.\n * - Otherwise defaults to **info**.\n *\n * When {@link applyCodemationLogConfig} is set, the first matching rule wins per namespace; unmatched namespaces use env defaults.\n *\n * Resolve a shared instance via {@link LogLevelPolicyFactory} (DI or `logLevelPolicyFactory`).\n */\nexport class LogLevelPolicy {\n  private cachedMin: LogLevel | undefined;\n\n  private codemationRules: ReadonlyArray<{ matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }> | null = null;\n\n  resolveMin(): LogLevel {\n    const raw = process.env.CODEMATION_LOG_LEVEL?.toLowerCase();\n    if (raw === \"silent\" || raw === \"debug\" || raw === \"info\" || raw === \"warn\" || raw === \"error\") {\n      return raw;\n    }\n    if (process.env.VITEST === \"true\") {\n      return \"warn\";\n    }\n    return \"info\";\n  }\n\n  private minLevelCached(): LogLevel {\n    if (this.cachedMin === undefined) {\n      this.cachedMin = this.resolveMin();\n    }\n    return this.cachedMin;\n  }\n\n  resetForTests(): void {\n    this.cachedMin = undefined;\n    this.codemationRules = null;\n  }\n\n  /**\n   * Applies `codemation.config` log rules. Pass `undefined` to clear rules and use env-only behavior.\n   */\n  applyCodemationLogConfig(config: CodemationLogConfig | undefined): void {\n    this.codemationRules = null;\n    if (!config) {\n      return;\n    }\n    const rawRules = this.normalizeCodemationRules(config);\n    if (rawRules.length === 0) {\n      return;\n    }\n    const compiled: { matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }[] = [];\n    for (const rule of rawRules) {\n      const minLevel = this.parseRuleLevel(rule.level);\n      const patterns = this.normalizeFilterPatterns(rule.filter);\n      if (patterns.length === 0) {\n        throw new Error(\"codemation.config log rule filter must include at least one pattern\");\n      }\n      const matchers = patterns.map((pattern) => this.compileGlobPattern(pattern));\n      compiled.push({\n        matchers,\n        minLevel,\n      });\n    }\n    this.codemationRules = compiled;\n  }\n\n  shouldEmit(level: Exclude<LogLevel, \"silent\">, namespace: string): boolean {\n    if (this.codemationRules && this.codemationRules.length > 0) {\n      for (const rule of this.codemationRules) {\n        if (rule.matchers.some((regex) => regex.test(namespace))) {\n          return this.levelPassesAgainstMin(level, rule.minLevel);\n        }\n      }\n    }\n    return this.levelPassesAgainstMin(level, this.minLevelCached());\n  }\n\n  private normalizeCodemationRules(config: CodemationLogConfig): ReadonlyArray<CodemationLogRule> {\n    if (\"rules\" in config && Array.isArray(config.rules)) {\n      return [...config.rules];\n    }\n    return [config as CodemationLogRule];\n  }\n\n  private normalizeFilterPatterns(filter: string | ReadonlyArray<string>): ReadonlyArray<string> {\n    if (typeof filter === \"string\") {\n      return [filter];\n    }\n    return [...filter];\n  }\n\n  /**\n   * Glob: only `*` is special (matches any substring). A lone `*` matches all namespaces.\n   */\n  private compileGlobPattern(pattern: string): RegExp {\n    const trimmed = pattern.trim();\n    if (trimmed === \"*\") {\n      return /^.*$/;\n    }\n    let body = \"\";\n    for (const ch of trimmed) {\n      if (ch === \"*\") {\n        body += \".*\";\n        continue;\n      }\n      if (globRegexMetaChars.has(ch)) {\n        body += \"\\\\\" + ch;\n        continue;\n      }\n      body += ch;\n    }\n    return new RegExp(\"^\" + body + \"$\");\n  }\n\n  private parseRuleLevel(level: string): LogLevel {\n    const normalized = level.toLowerCase();\n    if (\n      normalized === \"silent\" ||\n      normalized === \"debug\" ||\n      normalized === \"info\" ||\n      normalized === \"warn\" ||\n      normalized === \"error\"\n    ) {\n      return normalized;\n    }\n    throw new Error(`Invalid codemation.config log level: ${level}`);\n  }\n\n  private levelPassesAgainstMin(level: Exclude<LogLevel, \"silent\">, min: LogLevel): boolean {\n    if (min === \"silent\") {\n      return false;\n    }\n    return levelRank[level] >= levelRank[min];\n  }\n}\n","import { LogLevelPolicy } from \"./LogLevelPolicy\";\n\n/**\n * Process-wide {@link LogLevelPolicy} singleton for server and browser loggers.\n * Plain class (no `@injectable` from `@codemation/core`): client components import this file; decorating would pull core into the browser bundle.\n */\nexport class LogLevelPolicyFactory {\n  private readonly policy = new LogLevelPolicy();\n\n  create(): LogLevelPolicy {\n    return this.policy;\n  }\n}\n\n/** Shared factory for call sites outside the DI container (e.g. next-host bootstrap). */\nexport const logLevelPolicyFactory = new LogLevelPolicyFactory();\n","import type { LogFilter } from \"../../application/logging/LogFilter\";\nimport type { Logger } from \"../../application/logging/Logger\";\n\nexport class FilteringLogger implements Logger {\n  constructor(\n    private readonly inner: Logger,\n    private readonly scope: string,\n    private readonly filter: LogFilter,\n  ) {}\n\n  info(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"info\", message })) {\n      return;\n    }\n    this.inner.info(message, exception);\n  }\n\n  warn(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"warn\", message })) {\n      return;\n    }\n    this.inner.warn(message, exception);\n  }\n\n  error(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"error\", message })) {\n      return;\n    }\n    this.inner.error(message, exception);\n  }\n\n  debug(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"debug\", message })) {\n      return;\n    }\n    this.inner.debug(message, exception);\n  }\n}\n","/**\n * Opt-in detailed timing / diagnostics lines (used with `ServerLoggerFactory#createPerformanceDiagnostics`).\n *\n * Set `CODEMATION_PERFORMANCE_LOGGING=true` to enable. Otherwise those loggers are silent regardless of level.\n */\nexport class PerformanceLogPolicy {\n  shouldEmitDetailedTiming(): boolean {\n    return process.env.CODEMATION_PERFORMANCE_LOGGING === \"true\";\n  }\n}\n","import { PerformanceLogPolicy } from \"./PerformanceLogPolicy\";\n\n/**\n * Process-wide {@link PerformanceLogPolicy} singleton (same pattern as {@link LogLevelPolicyFactory}).\n */\nexport class PerformanceLogPolicyFactory {\n  private readonly policy = new PerformanceLogPolicy();\n\n  create(): PerformanceLogPolicy {\n    return this.policy;\n  }\n}\n\nexport const performanceLogPolicyFactory = new PerformanceLogPolicyFactory();\n","import { inject, injectable } from \"@codemation/core\";\n\nimport type { LogFilter } from \"../../application/logging/LogFilter\";\nimport type { Logger, LoggerFactory } from \"../../application/logging/Logger\";\n\nimport { FilteringLogger } from \"./FilteringLogger\";\nimport { LogLevelPolicyFactory } from \"./LogLevelPolicyFactory\";\nimport { performanceLogPolicyFactory } from \"./PerformanceLogPolicyFactory\";\nimport { ServerLogger } from \"./ServerLogger\";\n\n@injectable()\nexport class ServerLoggerFactory implements LoggerFactory {\n  constructor(@inject(LogLevelPolicyFactory) private readonly logLevelPolicyFactory: LogLevelPolicyFactory) {}\n\n  create(scope: string): Logger {\n    return new ServerLogger(scope, this.logLevelPolicyFactory.create());\n  }\n\n  createFiltered(scope: string, filter: LogFilter): Logger {\n    return new FilteringLogger(this.create(scope), scope, filter);\n  }\n\n  createPerformanceDiagnostics(scope: string): Logger {\n    return this.createFiltered(scope, (_entry) => performanceLogPolicyFactory.create().shouldEmitDetailedTiming());\n  }\n}\n\nexport { ServerLogger } from \"./ServerLogger\";\n"],"mappings":"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"}

package/dist/authoring.d.ts

@@ -0,0 +1,5 @@
+import "./index-DMedRrli.js";
+import { a as defineCodemationApp, i as FriendlyCodemationExecutionConfig, n as DefinePluginOptions, o as definePlugin, r as FriendlyCodemationDatabaseConfig, s as workflow, t as DefineCodemationAppOptions } from "./CodemationAuthoring.types-CT6Kp1vK.js";
+import { _ as CodemationEngineExecutionLimitsConfig, b as CodemationSchedulerConfig, c as CodemationPluginContext, d as CodemationAppSchedulerConfig, f as CodemationAppSchedulerKind, g as CodemationDatabaseKind, h as CodemationDatabaseConfig, m as CodemationConfig, n as CodemationRegistrationContextBase, o as CodemationPlugin, p as CodemationApplicationRuntimeConfig, s as CodemationPluginConfig, t as CodemationAppContext, u as CodemationAppDefinition, v as CodemationEventBusConfig, x as CodemationSchedulerKind, y as CodemationEventBusKind } from "./CodemationAppContext-DZt_ZwXH.js";
+import "./CodemationWhitelabelConfig-D5rYcLlj.js";
+export { type CodemationAppContext, type CodemationAppDefinition, type CodemationAppSchedulerConfig, type CodemationAppSchedulerKind, type CodemationApplicationRuntimeConfig, type CodemationConfig, type CodemationDatabaseConfig, type CodemationDatabaseKind, type CodemationEngineExecutionLimitsConfig, type CodemationEventBusConfig, type CodemationEventBusKind, type CodemationPlugin, type CodemationPluginConfig, type CodemationPluginContext, type CodemationRegistrationContextBase, type CodemationSchedulerConfig, type CodemationSchedulerKind, type DefineCodemationAppOptions, type DefinePluginOptions, type FriendlyCodemationDatabaseConfig, type FriendlyCodemationExecutionConfig, defineCodemationApp, definePlugin, workflow };

package/dist/authoring.js

@@ -0,0 +1,4 @@
+import { n as definePlugin, t as defineCodemationApp } from "./CodemationAuthoring.types-SxVJ1qu5.js";
+import { workflow } from "@codemation/core-nodes";
+
+export { defineCodemationApp, definePlugin, workflow };

package/dist/client.d.ts

@@ -1,7 +1,7 @@
-import { a as CodemationWhitelabelConfig, l as Logger, u as LoggerFactory } from "./CodemationAuthConfig-7hEfICPf.js";
-import { t as LogLevelPolicy } from "./LogLevelPolicy-9IcPGZFk.js";
-import { a as CodemationFrontendAuthSnapshot, i as CodemationFrontendAuthProviderSnapshot, 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 { l as Logger, t as CodemationWhitelabelConfig, u as LoggerFactory } from "./CodemationWhitelabelConfig-D5rYcLlj.js";
+import { t as LogLevelPolicy } from "./LogLevelPolicy-CkiJAH75.js";
+import { a as CodemationFrontendAuthSnapshot, i as CodemationFrontendAuthProviderSnapshot, 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";
 
 //#region src/infrastructure/logging/BrowserLoggerFactory.d.ts
 declare class BrowserLoggerFactory implements LoggerFactory {

package/dist/client.js

@@ -1,5 +1,5 @@
-import { t as ConsoleLogger } from "./ConsoleLogger-ClPU7jtc.js";
-import { i as CodemationFrontendAuthSnapshotJsonCodec, n as InternalAuthBootstrapJsonCodec, r as FrontendAppConfigJsonCodec, t as PublicFrontendBootstrapJsonCodec } from "./PublicFrontendBootstrapJsonCodec-BdiVGG5R.js";
+import { t as ConsoleLogger } from "./ConsoleLogger-DuStfHe0.js";
+import { i as CodemationFrontendAuthSnapshotJsonCodec, n as InternalAuthBootstrapJsonCodec, r as FrontendAppConfigJsonCodec, t as PublicFrontendBootstrapJsonCodec } from "./PublicFrontendBootstrapJsonCodec-BZgQ_FnW.js";
 
 //#region src/infrastructure/logging/BrowserLoggerFactory.ts
 var BrowserLoggerFactory = class {

package/dist/consumer.d.ts

@@ -1,6 +1,6 @@
-import "./CodemationAuthConfig-7hEfICPf.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 "./index-DMedRrli.js";
+import "./CodemationAppContext-DZt_ZwXH.js";
+import "./CodemationWhitelabelConfig-D5rYcLlj.js";
+import "./CodemationConfigNormalizer-C2CJnmKY.js";
+import { i as CodemationConsumerAppResolver, n as CodemationConsumerConfigResolution, r as CodemationConsumerApp, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-kijLkRtF.js";
 export { type CodemationConsumerApp, CodemationConsumerAppResolver, CodemationConsumerConfigLoader, type CodemationConsumerConfigResolution };

package/dist/consumer.js

@@ -1,7 +1,7 @@
-import "./ConsoleLogger-ClPU7jtc.js";
-import { i as CodemationConsumerAppResolver, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-D6LFSlp5.js";
-import "./ServerLoggerFactory-BltIIDfQ.js";
-import "./decorateParam-DrsXNPuw.js";
-import "./decorate-B0PP651O.js";
+import "./ConsoleLogger-DuStfHe0.js";
+import { i as CodemationConsumerAppResolver, t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-DovlxZNb.js";
+import "./ServerLoggerFactory-CsNW5qhz.js";
+import "./decorateParam-D7WPDFAf.js";
+import "./decorate-Dq0XLibd.js";
 
 export { CodemationConsumerAppResolver, CodemationConsumerConfigLoader };

package/dist/credentials.d.ts

@@ -1,7 +1,7 @@
-import "./CodemationAuthConfig-7hEfICPf.js";
-import { d as CredentialHealth, s as AnyCredentialType, v as CredentialSessionFactoryArgs } from "./index-dK05sTQ4.js";
-import "./CodemationConfig-DBbMU3HB.js";
-import { a as CredentialInstanceService, i as CredentialBindingService, n as CredentialType } from "./CredentialServices-CYETzKyb.js";
+import { c as AnyCredentialType, f as CredentialHealth, y as CredentialSessionFactoryArgs } from "./index-DMedRrli.js";
+import "./CodemationAppContext-DZt_ZwXH.js";
+import "./CodemationWhitelabelConfig-D5rYcLlj.js";
+import { a as CredentialInstanceService, i as CredentialBindingService, n as CredentialType } from "./CredentialServices-CGS_E7O-.js";
 
 //#region src/infrastructure/credentials/OpenAiApiKeyCredentialShapes.types.d.ts
 /**

package/dist/credentials.js

@@ -1,6 +1,6 @@
-import "./decorateParam-DrsXNPuw.js";
-import "./decorate-B0PP651O.js";
-import { a as CredentialInstanceService, h as OpenAiApiKeyCredentialHealthTester, i as CredentialBindingService, m as OpenAiApiKeyCredentialTypeFactory } from "./CredentialServices-D8BBZH1i.js";
+import "./decorateParam-D7WPDFAf.js";
+import "./decorate-Dq0XLibd.js";
+import { a as CredentialInstanceService, h as OpenAiApiKeyCredentialHealthTester, i as CredentialBindingService, m as OpenAiApiKeyCredentialTypeFactory } from "./CredentialServices-BPKUF8Xs.js";
 
 //#region src/credentials.ts
 const defaultOpenAiApiKeyCredentialTypeFactory = new OpenAiApiKeyCredentialTypeFactory(new OpenAiApiKeyCredentialHealthTester(globalThis.fetch));

package/dist/devServerSidecar.d.ts

@@ -1,4 +1,4 @@
-import { B as Container, N as WorkflowDefinition } from "./index-dK05sTQ4.js";
+import { P as WorkflowDefinition, V as Container } from "./index-DMedRrli.js";
 
 //#region src/presentation/server/CodemationTsyringeParamInfoReader.d.ts
 declare class CodemationTsyringeParamInfoReader {

package/dist/{index-dK05sTQ4.d.ts → index-DMedRrli.d.ts}

@@ -9,6 +9,31 @@ interface Clock {
   now(): Date;
 }
 //#endregion
+//#region ../core/src/contracts/itemValue.d.ts
+declare const ITEM_VALUE_BRAND: unique symbol;
+type ItemValueResolvedContext = Readonly<{
+  runId: RunId;
+  workflowId: WorkflowId;
+  nodeId: NodeId;
+  activationId: NodeActivationId;
+  data: RunDataSnapshot;
+}>;
+/**
+ * Context aligned with former {@link ItemInputMapperContext} — use **`data`** to read any completed upstream node.
+ */
+type ItemValueContext = ItemValueResolvedContext;
+type ItemValueArgs<TItemJson = unknown> = Readonly<{
+  item: Item<TItemJson>;
+  itemIndex: number;
+  items: Items<TItemJson>;
+  ctx: ItemValueContext;
+}>;
+type ItemValueCallback<T, TItemJson = unknown> = (args: ItemValueArgs<TItemJson>) => T | Promise<T>;
+type ItemValue<T, TItemJson = unknown> = Readonly<{
+  readonly [ITEM_VALUE_BRAND]: true;
+  readonly fn: ItemValueCallback<T, TItemJson>;
+}>;
+//#endregion
 //#region ../core/src/contracts/retryPolicySpec.types.d.ts
 /**
  * In-process retry policy for runnable nodes. Serialized configs use the same
@@ -749,7 +774,6 @@ interface NodeConfigBase {
 declare const runnableNodeInputType: unique symbol;
 declare const runnableNodeOutputType: unique symbol;
 declare const triggerNodeOutputType: unique symbol;
-type LineageCarryPolicy = "emitOnly" | "carryThrough";
 /**
  * Runnable node: **`TInputJson`** is what **`inputSchema`** validates on **`item.json`** (the wire payload).
  * **`TOutputJson`** is emitted `item.json` on outputs.
@@ -763,11 +787,6 @@ interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> ex
    * Resolution order: node instance `inputSchema`, then config `inputSchema`, then `z.unknown()`.
    */
   readonly inputSchema?: ZodType<TInputJson$1>;
-  /**
-   * Overrides default lineage propagation for `execute` outputs (binary/meta/paired).
-   * Routers with multiple {@link RunnableNode#outputPorts} default to **`carryThrough`**; others default to **`emitOnly`**.
-   */
-  readonly lineageCarry?: LineageCarryPolicy;
   /**
    * When an activation receives **zero** input items, the engine normally runs `execute` zero times.
    * Set to **`runOnce`** to run `execute` once with an empty `items` batch (and a synthetic wire item for schema parsing).
@@ -909,6 +928,12 @@ type CredentialFieldSchema = Readonly<{
   type: "string" | "password" | "textarea" | "json" | "boolean";
   required?: true;
   order?: number;
+  /**
+   * Where this field appears in the credential dialog. Use `"advanced"` for optional or
+   * power-user fields; they render inside a collapsible section (see `CredentialTypeDefinition.advancedSection`).
+   * Defaults to `"default"` when omitted.
+   */
+  visibility?: "default" | "advanced";
   placeholder?: string;
   helpText?: string;
   /** When set, host resolves this field from process.env at runtime; env wins over stored values. */
@@ -973,12 +998,25 @@ type CredentialOAuth2AuthDefinition = Readonly<{
   clientSecretFieldKey?: string;
 }>;
 type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;
+type CredentialAdvancedSectionPresentation = Readonly<{
+  /** Collapsible section title (default: "Advanced"). */
+  title?: string;
+  /** Optional short helper text shown inside the section (above the fields). */
+  description?: string;
+  /** When true, the advanced section starts expanded. Default: false (collapsed). */
+  defaultOpen?: boolean;
+}>;
 type CredentialTypeDefinition = Readonly<{
   typeId: CredentialTypeId;
   displayName: string;
   description?: string;
   publicFields?: ReadonlyArray<CredentialFieldSchema>;
   secretFields?: ReadonlyArray<CredentialFieldSchema>;
+  /**
+   * Optional labels for the collapsible block that contains every field with `visibility: "advanced"`.
+   * If omitted, the UI still shows that block with defaults (title "Advanced", collapsed).
+   */
+  advancedSection?: CredentialAdvancedSectionPresentation;
   supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;
   auth?: CredentialAuthDefinition;
 }>;
@@ -1068,6 +1106,7 @@ interface AgentCanvasPresentation<TIcon extends string = string> {
   readonly label?: string;
   readonly icon?: TIcon;
 }
+type ZodSchemaAny = ZodType<any, any, any>;
 interface ToolConfig {
   readonly type: TypeToken<unknown>;
   readonly name: string;
@@ -1075,6 +1114,32 @@ interface ToolConfig {
   readonly presentation?: AgentCanvasPresentation;
   getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
 }
+type AgentMessageRole = "system" | "user" | "assistant";
+type AgentMessageBuildArgs<TInputJson$1 = unknown> = Readonly<{
+  item: Item<TInputJson$1>;
+  itemIndex: number;
+  items: Items<TInputJson$1>;
+  ctx: NodeExecutionContext<any>;
+}>;
+interface AgentMessageDto {
+  readonly role: AgentMessageRole;
+  readonly content: string;
+}
+type AgentMessageTemplateContent<TInputJson$1 = unknown> = string | ((args: AgentMessageBuildArgs<TInputJson$1>) => string);
+interface AgentMessageTemplate<TInputJson$1 = unknown> {
+  readonly role: AgentMessageRole;
+  readonly content: AgentMessageTemplateContent<TInputJson$1>;
+}
+/** A single prompt line: fixed DTO or template with optional function `content`. */
+type AgentMessageLine<TInputJson$1 = unknown> = AgentMessageDto | AgentMessageTemplate<TInputJson$1>;
+/**
+ * Message list for an agent. Prefer a **plain array** of `{ role, content }` (optionally with function `content` for templates).
+ * Use the object form only when you need `buildMessages` to append messages after optional `prompt` lines.
+ */
+type AgentMessageConfig<TInputJson$1 = unknown> = ItemValue<ReadonlyArray<AgentMessageLine<TInputJson$1>>, TInputJson$1> | ReadonlyArray<AgentMessageLine<TInputJson$1>> | {
+  readonly prompt?: ReadonlyArray<AgentMessageLine<TInputJson$1>>;
+  readonly buildMessages?: (args: AgentMessageBuildArgs<TInputJson$1>) => ReadonlyArray<AgentMessageDto>;
+};
 type AgentTurnLimitBehavior = "error" | "respondWithLastMessage";
 interface AgentModelInvocationOptions {
   readonly maxTokens?: number;
@@ -1094,6 +1159,16 @@ interface ChatModelConfig {
 interface LangChainChatModelLike {
   invoke(input: unknown, options?: unknown): Promise<unknown>;
   bindTools?(tools: ReadonlyArray<unknown>): LangChainChatModelLike;
+  withStructuredOutput?(outputSchema: ZodSchemaAny, config?: ChatModelStructuredOutputOptions): LangChainStructuredOutputModelLike;
+}
+interface LangChainStructuredOutputModelLike {
+  invoke(input: unknown, options?: unknown): Promise<unknown>;
+}
+interface ChatModelStructuredOutputOptions {
+  readonly method?: "jsonSchema" | "functionCalling" | "jsonMode";
+  readonly strict?: boolean;
+  readonly includeRaw?: boolean;
+  readonly tools?: ReadonlyArray<unknown>;
 }
 interface ChatModelFactory<TConfig$1 extends ChatModelConfig = ChatModelConfig> {
   create(args: Readonly<{
@@ -1296,5 +1371,5 @@ declare class RunIntentService {
   private createWebhookExecutionOptions;
 }
 //#endregion
-export { RunSummary as $, RunIdFactory as A, Container as B, CredentialTypeId as C, Item as D, BinaryAttachment as E, BinaryStorage as F, ChainCursor as G, EngineExecutionLimitsPolicyConfig as H, NodeExecutionContext as I, WebhookInvocationMatch as J, AnyRunnableNodeConfig as K, NodeExecutionRequestHandler as L, RunnableNodeOutputJson as M, WorkflowDefinition as N, Items as O, WorkflowId as P, RunPruneCandidate as Q, NodeExecutionScheduler as R, CredentialTypeDefinition as S, ActivationIdFactory as T, RunEvent as U, TypeToken as V, RunEventBus as W, PersistedRunState as X, WorkflowRunDetailDto as Y, RunCurrentState as Z, CredentialRequirement as _, ToolConfig as a, CredentialSetupStatus as b, CredentialBinding as c, CredentialHealth as d, Clock as et, CredentialInstanceId as f, CredentialOAuth2AuthDefinition as g, CredentialMaterialSourceKind as h, ChatModelConfig as i, RunnableNodeConfig as j, RunId as k, CredentialBindingKey as l, CredentialJsonRecord as m, Engine as n, DefinedNode as o, CredentialInstanceRecord as p, WorkflowActivationPolicy as q, AgentGuardrailConfig as r, AnyCredentialType as s, RunIntentService as t, CredentialFieldSchema as u, CredentialSessionFactoryArgs as v, CredentialTypeRegistry as w, CredentialType as x, CredentialSessionService as y, WorkflowRepository as z };
-//# sourceMappingURL=index-dK05sTQ4.d.ts.map
+export { RunPruneCandidate as $, RunId as A, WorkflowRepository as B, CredentialTypeDefinition as C, BinaryAttachment as D, ActivationIdFactory as E, WorkflowId as F, RunEventBus as G, TypeToken as H, BinaryStorage as I, WorkflowActivationPolicy as J, ChainCursor as K, NodeExecutionContext as L, RunnableNodeConfig as M, RunnableNodeOutputJson as N, Item as O, WorkflowDefinition as P, RunCurrentState as Q, NodeExecutionRequestHandler as R, CredentialType as S, CredentialTypeRegistry as T, EngineExecutionLimitsPolicyConfig as U, Container as V, RunEvent as W, WorkflowRunDetailDto as X, WebhookInvocationMatch as Y, PersistedRunState as Z, CredentialOAuth2AuthDefinition as _, ChatModelConfig as a, CredentialSessionService as b, AnyCredentialType as c, CredentialFieldSchema as d, RunSummary as et, CredentialHealth as f, CredentialMaterialSourceKind as g, CredentialJsonRecord as h, AgentMessageConfig as i, RunIdFactory as j, Items as k, CredentialBinding as l, CredentialInstanceRecord as m, Engine as n, ToolConfig as o, CredentialInstanceId as p, AnyRunnableNodeConfig as q, AgentGuardrailConfig as r, DefinedNode as s, RunIntentService as t, Clock as tt, CredentialBindingKey as u, CredentialRequirement as v, CredentialTypeId as w, CredentialSetupStatus as x, CredentialSessionFactoryArgs as y, NodeExecutionScheduler as z };
+//# sourceMappingURL=index-DMedRrli.d.ts.map

package/dist/index.d.ts

@@ -1,17 +1,17 @@
-import { a as CodemationWhitelabelConfig, c as CodemationLogRule, i as CodemationAuthOidcProviderConfig, n as CodemationAuthKind, o as CodemationLogConfig, r as CodemationAuthOAuthProviderConfig, s as CodemationLogLevelName, t as CodemationAuthConfig } from "./CodemationAuthConfig-7hEfICPf.js";
-import { a as CodemationFrontendAuthSnapshot, i as CodemationFrontendAuthProviderSnapshot, 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 { D as Item, G as ChainCursor, I as NodeExecutionContext, K as AnyRunnableNodeConfig, M as RunnableNodeOutputJson, N as WorkflowDefinition, O as Items, V as TypeToken, a as ToolConfig, i as ChatModelConfig, j as RunnableNodeConfig, o as DefinedNode, r as AgentGuardrailConfig, s as AnyCredentialType } from "./index-dK05sTQ4.js";
-import { S as CodemationPluginPackageMetadata, a as CodemationConfig, b as CodemationPluginConfig, c as CodemationEngineExecutionLimitsConfig, d as CodemationSchedulerConfig, f as CodemationSchedulerKind, g as AppConfig, h as CodemationRegistrationContextBase, i as CodemationApplicationRuntimeConfig, l as CodemationEventBusConfig, m as CodemationAppContext, n as CodemationAppSchedulerConfig, o as CodemationDatabaseConfig, p as CodemationWorkflowDiscovery, r as CodemationAppSchedulerKind, s as CodemationDatabaseKind, t as CodemationAppDefinition, u as CodemationEventBusKind, v as AppPluginLoadSummary, w as CodemationClassToken, x as CodemationPluginContext, y as CodemationPlugin } from "./CodemationConfig-DBbMU3HB.js";
-import "./CodemationConfigNormalizer-C8wC0skq.js";
-import { t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-Ceh6sB3X.js";
-import "./CredentialServices-CYETzKyb.js";
-import { _ as Command, c as WorkerRuntime, d as AppContainerLifecycle, f as AppContainerFactory, g as CommandBus, h as Query, l as FrontendRuntime, m as QueryBus, n as CodemationBootstrapRequest, r as ApplicationTokens, t as CodemationPluginListMerger, u as DatabaseMigrations } from "./CodemationPluginListMerger-Cx9DnyR-.js";
-import { r as PrismaDatabaseClient, t as AppConfigFactory } from "./AppConfigFactory-DHdAGOmC.js";
-import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-D9vUTMqc.js";
-import { c as CodemationServerGateway, l as ApiPaths } from "./server-fxqY2WEi.js";
-import { i as CodemationFrontendAuthSnapshotFactory, n as InternalAuthBootstrapFactory, r as FrontendAppConfigFactory, t as PublicFrontendBootstrapFactory } from "./PublicFrontendBootstrapFactory-DeMjp3cs.js";
-import { ZodType, z } from "zod";
+import "./index-DMedRrli.js";
+import { a as defineCodemationApp, i as FriendlyCodemationExecutionConfig, n as DefinePluginOptions, o as definePlugin, r as FriendlyCodemationDatabaseConfig, s as workflow, t as DefineCodemationAppOptions } from "./CodemationAuthoring.types-CT6Kp1vK.js";
+import { S as CodemationWorkflowDiscovery, _ as CodemationEngineExecutionLimitsConfig, a as AppPluginLoadSummary, b as CodemationSchedulerConfig, c as CodemationPluginContext, d as CodemationAppSchedulerConfig, f as CodemationAppSchedulerKind, g as CodemationDatabaseKind, h as CodemationDatabaseConfig, l as CodemationPluginPackageMetadata, m as CodemationConfig, n as CodemationRegistrationContextBase, o as CodemationPlugin, p as CodemationApplicationRuntimeConfig, r as AppConfig, s as CodemationPluginConfig, t as CodemationAppContext, u as CodemationAppDefinition, v as CodemationEventBusConfig, w as CodemationClassToken, x as CodemationSchedulerKind, y as CodemationEventBusKind } from "./CodemationAppContext-DZt_ZwXH.js";
+import { a as CodemationAuthConfig, c as CodemationAuthOidcProviderConfig, i as CodemationLogRule, n as CodemationLogConfig, o as CodemationAuthKind, r as CodemationLogLevelName, s as CodemationAuthOAuthProviderConfig, t as CodemationWhitelabelConfig } from "./CodemationWhitelabelConfig-D5rYcLlj.js";
+import { a as CodemationFrontendAuthSnapshot, i as CodemationFrontendAuthProviderSnapshot, 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-C2CJnmKY.js";
+import { t as CodemationConsumerConfigLoader } from "./CodemationConsumerConfigLoader-kijLkRtF.js";
+import "./CredentialServices-CGS_E7O-.js";
+import { _ as Command, c as WorkerRuntime, d as AppContainerLifecycle, f as AppContainerFactory, g as CommandBus, h as Query, l as FrontendRuntime, m as QueryBus, n as CodemationBootstrapRequest, r as ApplicationTokens, t as CodemationPluginListMerger, u as DatabaseMigrations } from "./CodemationPluginListMerger-Z-qsxAS9.js";
+import { r as PrismaDatabaseClient, t as AppConfigFactory } from "./AppConfigFactory-DeULdLzi.js";
+import { t as CodemationPostgresPrismaClientFactory } from "./persistenceServer-DdIyEFHH.js";
+import { c as CodemationServerGateway, l as ApiPaths } from "./server-Bd7_dgBB.js";
+import { i as CodemationFrontendAuthSnapshotFactory, n as InternalAuthBootstrapFactory, r as FrontendAppConfigFactory, t as PublicFrontendBootstrapFactory } from "./PublicFrontendBootstrapFactory-CYBuZerA.js";
 
 //#region src/application/contracts/userDirectoryContracts.types.d.ts
 type UserAccountStatus = "invited" | "active" | "inactive";
@@ -38,195 +38,6 @@ declare class UpsertLocalBootstrapUserCommand extends Command<UpsertLocalBootstr
   constructor(email: string, password: string);
 }
 //#endregion
-//#region ../core-nodes/src/nodes/aggregate.d.ts
-declare class Aggregate<TIn = unknown, TOut = unknown> implements RunnableNodeConfig<TIn, TOut> {
-  readonly name: string;
-  readonly aggregate: (items: Items<TIn>, ctx: NodeExecutionContext<Aggregate<TIn, TOut>>) => TOut | Promise<TOut>;
-  readonly id?: string | undefined;
-  readonly kind: "node";
-  readonly type: TypeToken<unknown>;
-  readonly execution: {
-    readonly hint: "local";
-  };
-  readonly icon: "lucide:layers";
-  constructor(name: string, aggregate: (items: Items<TIn>, ctx: NodeExecutionContext<Aggregate<TIn, TOut>>) => TOut | Promise<TOut>, id?: string | undefined);
-}
-//#endregion
-//#region ../core-nodes/src/nodes/filter.d.ts
-declare class Filter<TIn = unknown> implements RunnableNodeConfig<TIn, TIn> {
-  readonly name: string;
-  readonly predicate: (item: Item<TIn>, index: number, items: Items<TIn>, ctx: NodeExecutionContext<Filter<TIn>>) => boolean;
-  readonly id?: string | undefined;
-  readonly kind: "node";
-  readonly type: TypeToken<unknown>;
-  readonly execution: {
-    readonly hint: "local";
-  };
-  readonly icon: "lucide:filter";
-  constructor(name: string, predicate: (item: Item<TIn>, index: number, items: Items<TIn>, ctx: NodeExecutionContext<Filter<TIn>>) => boolean, id?: string | undefined);
-}
-//#endregion
-//#region ../core-nodes/src/nodes/split.d.ts
-declare class Split<TIn = unknown, TElem = unknown> implements RunnableNodeConfig<TIn, TElem> {
-  readonly name: string;
-  readonly getElements: (item: Item<TIn>, ctx: NodeExecutionContext<Split<TIn, TElem>>) => readonly TElem[];
-  readonly id?: string | undefined;
-  readonly kind: "node";
-  readonly type: TypeToken<unknown>;
-  readonly execution: {
-    readonly hint: "local";
-  };
-  /**
-   * When splitting yields zero items for a batch, downstream single-input nodes still run once with an empty batch.
-   * Mirrors {@link MapData}'s empty-output behavior.
-   */
-  readonly continueWhenEmptyOutput: true;
-  readonly icon: "lucide:ungroup";
-  constructor(name: string, getElements: (item: Item<TIn>, ctx: NodeExecutionContext<Split<TIn, TElem>>) => readonly TElem[], id?: string | undefined);
-}
-//#endregion
-//#region ../core-nodes/src/nodes/merge.d.ts
-type MergeMode = "passThrough" | "append" | "mergeByPosition";
-//#endregion
-//#region ../core-nodes/src/workflowAuthoring/WorkflowAuthoringOptions.types.d.ts
-type WorkflowAgentPrompt<TCurrentJson> = string | ((item: TCurrentJson) => string);
-interface WorkflowAgentOptions<TCurrentJson, TOutputSchema extends z.ZodTypeAny | undefined = undefined> {
-  readonly prompt: WorkflowAgentPrompt<TCurrentJson>;
-  readonly model: string | ChatModelConfig;
-  readonly tools?: ReadonlyArray<ToolConfig>;
-  readonly outputSchema?: TOutputSchema;
-  readonly retryPolicy?: RunnableNodeConfig["retryPolicy"];
-  readonly guardrails?: AgentGuardrailConfig;
-  readonly id?: string;
-}
-//#endregion
-//#region ../core-nodes/src/workflowAuthoring/WorkflowBranchBuilder.types.d.ts
-declare class WorkflowBranchBuilder<TCurrentJson> {
-  private readonly steps;
-  constructor(steps?: ReadonlyArray<AnyRunnableNodeConfig>);
-  then<TOutputJson, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson>>(config: TConfig): WorkflowBranchBuilder<RunnableNodeOutputJson<TConfig>>;
-  map<TNextJson>(mapper: (item: TCurrentJson) => TNextJson): WorkflowBranchBuilder<TNextJson>;
-  map<TNextJson>(name: string, mapper: (item: TCurrentJson) => TNextJson, id?: string): WorkflowBranchBuilder<TNextJson>;
-  wait(duration: number | string): WorkflowBranchBuilder<TCurrentJson>;
-  wait(name: string, duration: number | string, id?: string): WorkflowBranchBuilder<TCurrentJson>;
-  split<TElem>(getElements: (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Split<TCurrentJson, TElem>>) => readonly TElem[]): WorkflowBranchBuilder<TElem>;
-  split<TElem>(name: string, getElements: (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Split<TCurrentJson, TElem>>) => readonly TElem[], id?: string): WorkflowBranchBuilder<TElem>;
-  filter(predicate: (item: Item<TCurrentJson>, index: number, items: Items<TCurrentJson>, ctx: NodeExecutionContext<Filter<TCurrentJson>>) => boolean): WorkflowBranchBuilder<TCurrentJson>;
-  filter(name: string, predicate: (item: Item<TCurrentJson>, index: number, items: Items<TCurrentJson>, ctx: NodeExecutionContext<Filter<TCurrentJson>>) => boolean, id?: string): WorkflowBranchBuilder<TCurrentJson>;
-  aggregate<TOut>(aggregateFn: (items: Items<TCurrentJson>, ctx: NodeExecutionContext<Aggregate<TCurrentJson, TOut>>) => TOut | Promise<TOut>): WorkflowBranchBuilder<TOut>;
-  aggregate<TOut>(name: string, aggregateFn: (items: Items<TCurrentJson>, ctx: NodeExecutionContext<Aggregate<TCurrentJson, TOut>>) => TOut | Promise<TOut>, id?: string): WorkflowBranchBuilder<TOut>;
-  agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowBranchBuilder<z.output<TOutputSchema>>;
-  agent(options: WorkflowAgentOptions<TCurrentJson, undefined>): WorkflowBranchBuilder<Record<string, unknown>>;
-  agent<TOutputSchema extends z.ZodTypeAny>(name: string, options: WorkflowAgentOptions<TCurrentJson, TOutputSchema | undefined>): WorkflowBranchBuilder<TOutputSchema extends z.ZodTypeAny ? z.output<TOutputSchema> : Record<string, unknown>>;
-  node<TConfig extends Record<string, unknown>, TOutputJson>(definitionOrKey: DefinedNode<string, TConfig, TCurrentJson, TOutputJson> | string, config: TConfig, name?: string, id?: string): WorkflowBranchBuilder<TOutputJson>;
-  getSteps(): ReadonlyArray<AnyRunnableNodeConfig>;
-}
-//#endregion
-//#region ../core-nodes/src/workflowAuthoring/WorkflowChain.types.d.ts
-type BranchCallback<TCurrentJson, TNextJson> = (branch: WorkflowBranchBuilder<TCurrentJson>) => WorkflowBranchBuilder<TNextJson>;
-type RouteBranchCallback<TCurrentJson, TNextJson> = (branch: WorkflowChain<TCurrentJson>) => WorkflowChain<TNextJson>;
-declare class WorkflowChain<TCurrentJson> {
-  private readonly chain;
-  constructor(chain: ChainCursor<TCurrentJson>);
-  then<TOutputJson, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson>>(config: TConfig): WorkflowChain<RunnableNodeOutputJson<TConfig>>;
-  map<TNextJson>(mapper: (item: TCurrentJson) => TNextJson): WorkflowChain<TNextJson>;
-  map<TNextJson>(name: string, mapper: (item: TCurrentJson) => TNextJson, id?: string): WorkflowChain<TNextJson>;
-  wait(duration: number | string): WorkflowChain<TCurrentJson>;
-  wait(name: string, duration: number | string, id?: string): WorkflowChain<TCurrentJson>;
-  split<TElem>(getElements: (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Split<TCurrentJson, TElem>>) => readonly TElem[]): WorkflowChain<TElem>;
-  split<TElem>(name: string, getElements: (item: Item<TCurrentJson>, ctx: NodeExecutionContext<Split<TCurrentJson, TElem>>) => readonly TElem[], id?: string): WorkflowChain<TElem>;
-  filter(predicate: (item: Item<TCurrentJson>, index: number, items: Items<TCurrentJson>, ctx: NodeExecutionContext<Filter<TCurrentJson>>) => boolean): WorkflowChain<TCurrentJson>;
-  filter(name: string, predicate: (item: Item<TCurrentJson>, index: number, items: Items<TCurrentJson>, ctx: NodeExecutionContext<Filter<TCurrentJson>>) => boolean, id?: string): WorkflowChain<TCurrentJson>;
-  aggregate<TOut>(aggregateFn: (items: Items<TCurrentJson>, ctx: NodeExecutionContext<Aggregate<TCurrentJson, TOut>>) => TOut | Promise<TOut>): WorkflowChain<TOut>;
-  aggregate<TOut>(name: string, aggregateFn: (items: Items<TCurrentJson>, ctx: NodeExecutionContext<Aggregate<TCurrentJson, TOut>>) => TOut | Promise<TOut>, id?: string): WorkflowChain<TOut>;
-  merge(): WorkflowChain<TCurrentJson>;
-  merge(cfg: Readonly<{
-    mode: MergeMode;
-    prefer?: ReadonlyArray<string>;
-  }>, id?: string): WorkflowChain<TCurrentJson>;
-  merge(name: string, cfg?: Readonly<{
-    mode: MergeMode;
-    prefer?: ReadonlyArray<string>;
-  }>, id?: string): WorkflowChain<TCurrentJson>;
-  if<TBranchJson>(predicate: (item: TCurrentJson) => boolean, branches: Readonly<{
-    true?: BranchCallback<TCurrentJson, TBranchJson>;
-    false?: BranchCallback<TCurrentJson, TBranchJson>;
-  }>): WorkflowChain<TBranchJson>;
-  if<TBranchJson>(name: string, predicate: (item: TCurrentJson) => boolean, branches: Readonly<{
-    true?: BranchCallback<TCurrentJson, TBranchJson>;
-    false?: BranchCallback<TCurrentJson, TBranchJson>;
-  }>): WorkflowChain<TBranchJson>;
-  route<TBranchJson>(branches: Readonly<Record<string, RouteBranchCallback<TCurrentJson, TBranchJson> | undefined>>): WorkflowChain<TBranchJson>;
-  switch<TBranchJson>(cfg: Readonly<{
-    cases: readonly string[];
-    defaultCase: string;
-    resolveCaseKey: (item: TCurrentJson) => string | Promise<string>;
-    branches: Readonly<Record<string, RouteBranchCallback<TCurrentJson, TBranchJson> | undefined>>;
-  }>): WorkflowChain<TBranchJson>;
-  switch<TBranchJson>(name: string, cfg: Readonly<{
-    cases: readonly string[];
-    defaultCase: string;
-    resolveCaseKey: (item: TCurrentJson) => string | Promise<string>;
-    branches: Readonly<Record<string, RouteBranchCallback<TCurrentJson, TBranchJson> | undefined>>;
-  }>, id?: string): WorkflowChain<TBranchJson>;
-  agent<TOutputSchema extends z.ZodTypeAny>(options: WorkflowAgentOptions<TCurrentJson, TOutputSchema>): WorkflowChain<z.output<TOutputSchema>>;
-  agent(options: WorkflowAgentOptions<TCurrentJson, undefined>): WorkflowChain<Record<string, unknown>>;
-  agent<TOutputSchema extends z.ZodTypeAny>(name: string, options: WorkflowAgentOptions<TCurrentJson, TOutputSchema | undefined>): WorkflowChain<TOutputSchema extends z.ZodTypeAny ? z.output<TOutputSchema> : Record<string, unknown>>;
-  node<TConfig extends Record<string, unknown>, TOutputJson>(definitionOrKey: DefinedNode<string, TConfig, TCurrentJson, TOutputJson> | string, config: TConfig, name?: string, id?: string): WorkflowChain<TOutputJson>;
-  build(): WorkflowDefinition;
-}
-//#endregion
-//#region ../core-nodes/src/workflowAuthoring/WorkflowAuthoringBuilder.types.d.ts
-declare class WorkflowAuthoringBuilder {
-  private readonly id;
-  private readonly workflowName;
-  constructor(id: string, workflowName?: string);
-  name(name: string): WorkflowAuthoringBuilder;
-  manualTrigger<TOutputJson>(defaultItems: TOutputJson | ReadonlyArray<TOutputJson>): WorkflowChain<TOutputJson>;
-  manualTrigger<TOutputJson>(name: string, defaultItems?: TOutputJson | ReadonlyArray<TOutputJson>, id?: string): WorkflowChain<TOutputJson>;
-}
-//#endregion
-//#region ../core-nodes/src/workflowAuthoring.types.d.ts
-declare function workflow(id: string): WorkflowAuthoringBuilder;
-//#endregion
-//#region src/presentation/config/CodemationAuthoring.types.d.ts
-interface FriendlyCodemationDatabaseConfig {
-  readonly kind: "postgresql" | "sqlite";
-  readonly url?: string;
-  readonly filePath?: string;
-}
-interface FriendlyCodemationExecutionConfig {
-  readonly mode?: "inline" | "queue";
-  readonly queuePrefix?: string;
-  readonly workerQueues?: ReadonlyArray<string>;
-  readonly redisUrl?: string;
-}
-interface DefineCodemationAppOptions extends Omit<CodemationConfig, "app" | "credentialTypes" | "register" | "whitelabel" | "auth"> {
-  readonly name?: string;
-  readonly auth?: CodemationConfig["auth"];
-  readonly database?: FriendlyCodemationDatabaseConfig;
-  readonly execution?: FriendlyCodemationExecutionConfig;
-  readonly nodes?: ReadonlyArray<DefinedNode<string, Record<string, unknown>, unknown, unknown>>;
-  readonly credentialTypes?: ReadonlyArray<AnyCredentialType>;
-  readonly credentials?: ReadonlyArray<AnyCredentialType>;
-  readonly register?: (context: CodemationAppContext) => void;
-  readonly whitelabel?: CodemationWhitelabelConfig;
-}
-interface DefinePluginOptions {
-  readonly name?: string;
-  readonly pluginPackageId?: string;
-  readonly nodes?: ReadonlyArray<DefinedNode<string, Record<string, unknown>, unknown, unknown>>;
-  readonly credentials?: ReadonlyArray<AnyCredentialType>;
-  readonly register?: (context: CodemationPluginContext) => void | Promise<void>;
-  readonly sandbox?: DefineCodemationAppOptions & Readonly<{
-    workflows?: ReadonlyArray<WorkflowDefinition>;
-  }>;
-}
-declare function defineCodemationApp(options: DefineCodemationAppOptions): CodemationConfig;
-declare function definePlugin(options: DefinePluginOptions): CodemationPlugin & Readonly<{
-  sandbox?: DefinePluginOptions["sandbox"];
-}>;
-//#endregion
 //#region src/presentation/config/CodemationPackageManifest.d.ts
 interface CodemationPackageManifest {
   readonly plugin?: string;