@codemation/core 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @codemation/core
 
+## 0.8.0
+
+### Minor Changes
+
+- [`782e934`](https://github.com/MadeRelevant/codemation/commit/782e93469ea6eee701d976b8f1dc18649d045c79) Thanks [@cblokland90](https://github.com/cblokland90)! - Add catalog-backed cost tracking contracts and wire AI/OCR usage into telemetry so hosts can aggregate provider-native execution costs.
+
+  Improve the telemetry dashboard and workflow detail experience with cost breakdowns, richer inspector data, workflow run cost totals, and credential rebinding fixes.
+
+### Patch Changes
+
+- [#85](https://github.com/MadeRelevant/codemation/pull/85) [`a250ab8`](https://github.com/MadeRelevant/codemation/commit/a250ab8b973429cdfe708526a205e2565b004868) Thanks [@cblokland90](https://github.com/cblokland90)! - Decouple telemetry retention from run deletion and move node-specific measurements onto metric points.
+  - allow telemetry spans, artifacts, and metrics to outlive raw run state through explicit retention timestamps
+  - narrow telemetry spans to canonical span fields and persist extensible node-specific measurements as metric points
+  - update telemetry queries, docs, and regression coverage around real workflow execution plus agent/tool observability
+
+- [#88](https://github.com/MadeRelevant/codemation/pull/88) [`052aba1`](https://github.com/MadeRelevant/codemation/commit/052aba17c9a4faf557bdfaa1a9644a1987ecc25e) Thanks [@cblokland90](https://github.com/cblokland90)! - Add a telemetry-backed node inspector slice for workflow detail and expose run-trace telemetry needed to power it.
+
+- [`1a356af`](https://github.com/MadeRelevant/codemation/commit/1a356afae50bd3f982e92c3e9f931e3adbcd131f) - Repair malformed AI tool calls inside the agent loop instead of replaying the whole agent node, and surface clearer debugging details when recovery succeeds or is exhausted.
+  - classify repairable validation failures separately from non-repairable tool errors and preserve stable invocation correlation for failed calls
+  - persist structured validation details and expose them in next-host inspector fallbacks, timelines, and error views
+  - add regression coverage for repaired tool calls, exhaustion behavior, and mixed parallel tool rounds
+
+## 0.7.0
+
+### Minor Changes
+
+- [#81](https://github.com/MadeRelevant/codemation/pull/81) [`88844f7`](https://github.com/MadeRelevant/codemation/commit/88844f75a48fe051e4cb895c710408855de14da4) Thanks [@cblokland90](https://github.com/cblokland90)! - Add typed workflow authoring helpers for reusable node params and run-data reads.
+  - export `Expr`, `Param`, and `ParamDeep` so helper-defined node params can accept literals or `itemExpr(...)`
+  - export `nodeRef<TJson>()` plus generic `RunDataSnapshot` item accessors for typed `ctx.data` reads
+  - keep helper-node runtime config resolved while expanding the public authoring surface for expression-style params
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/{EngineRuntimeRegistration.types-Dm129RJ6.d.ts → EngineRuntimeRegistration.types-BP6tsaNP.d.ts}

@@ -1,4 +1,4 @@
-import { Mi as DependencyContainer, Zi as EngineExecutionLimitsPolicyConfig, ir as TriggerRuntimeDiagnostics, xr as WebhookTriggerRoutingDiagnostics, yr as WebhookTriggerMatcher } from "./RunIntentService-BDiodxhf.js";
+import { Ar as WebhookTriggerRoutingDiagnostics, Or as WebhookTriggerMatcher, Pa as EngineExecutionLimitsPolicyConfig, ha as DependencyContainer, hn as WorkflowPolicyRuntimeDefaults, pr as TriggerRuntimeDiagnostics } from "./RunIntentService-BqhmdoA1.js";
 
 //#region src/bootstrap/runtime/EngineRuntimeRegistration.types.d.ts
 
@@ -36,7 +36,9 @@ interface EngineRuntimeRegistrationOptions {
   webhookTriggerMatcherProvider?: WebhookTriggerMatcherProvider;
   /** Overrides default trigger diagnostics (undefined when omitted). */
   triggerRuntimeDiagnosticsProvider?: TriggerRuntimeDiagnosticsProvider;
+  /** Runtime retention/storage defaults used when workflows omit prune/storage policy fields. */
+  workflowPolicyRuntimeDefaults?: WorkflowPolicyRuntimeDefaults;
 }
 //#endregion
 export { TriggerRuntimeDiagnosticsProvider as n, WebhookTriggerMatcherProvider as r, EngineRuntimeRegistrationOptions as t };
-//# sourceMappingURL=EngineRuntimeRegistration.types-Dm129RJ6.d.ts.map
+//# sourceMappingURL=EngineRuntimeRegistration.types-BP6tsaNP.d.ts.map

package/dist/{EngineWorkflowRunnerService-Bf88QtwB.d.cts → EngineWorkflowRunnerService-DzOCa1BW.d.cts}

@@ -1,4 +1,4 @@
-import { $t as TriggerRuntimeDiagnostics, Dr as DependencyContainer, E as NodeId, Fn as PersistedWorkflowSnapshot, Gn as RunResult, In as PersistedWorkflowSnapshotNode, J as WorkflowDefinition, Kr as EngineExecutionLimitsPolicyConfig, Ln as PersistedWorkflowTokenRegistryLike, P as ParentExecutionRef, an as WorkflowRepository, b as NodeConfigBase, et as WorkflowId, f as Items, gn as WebhookTriggerRoutingDiagnostics, mn as WebhookTriggerMatcher, r as Engine } from "./RunIntentService-B1Y3v1H6.cjs";
+import { E as NodeId, F as ParentExecutionRef, Ln as PersistedWorkflowSnapshot, Rn as PersistedWorkflowSnapshotNode, Si as EngineExecutionLimitsPolicyConfig, Y as WorkflowDefinition, b as NodeConfigBase, f as Items, gn as WebhookTriggerMatcher, qn as RunResult, r as Engine, ri as DependencyContainer, rt as WorkflowPolicyRuntimeDefaults, sn as WorkflowRepository, tn as TriggerRuntimeDiagnostics, tt as WorkflowId, vn as WebhookTriggerRoutingDiagnostics, zn as PersistedWorkflowTokenRegistryLike } from "./RunIntentService-S-1lW-gS.cjs";
 
 //#region src/workflowSnapshots/WorkflowSnapshotCodec.d.ts
 declare class WorkflowSnapshotCodec {
@@ -53,6 +53,8 @@ interface EngineRuntimeRegistrationOptions {
   webhookTriggerMatcherProvider?: WebhookTriggerMatcherProvider;
   /** Overrides default trigger diagnostics (undefined when omitted). */
   triggerRuntimeDiagnosticsProvider?: TriggerRuntimeDiagnosticsProvider;
+  /** Runtime retention/storage defaults used when workflows omit prune/storage policy fields. */
+  workflowPolicyRuntimeDefaults?: WorkflowPolicyRuntimeDefaults;
 }
 //#endregion
 //#region src/runtime/EngineWorkflowRunnerService.d.ts
@@ -70,4 +72,4 @@ declare class EngineWorkflowRunnerService {
 }
 //#endregion
 export { WorkflowSnapshotCodec as a, WebhookTriggerMatcherProvider as i, EngineRuntimeRegistrationOptions as n, TriggerRuntimeDiagnosticsProvider as r, EngineWorkflowRunnerService as t };
-//# sourceMappingURL=EngineWorkflowRunnerService-Bf88QtwB.d.cts.map
+//# sourceMappingURL=EngineWorkflowRunnerService-DzOCa1BW.d.cts.map

package/dist/{InMemoryRunDataFactory-Dyl4p2s8.d.cts → InMemoryRunDataFactory-1iz7_SnO.d.cts}

@@ -1,5 +1,20 @@
-import { Ct as BinaryStorageWriteResult, Dt as ExecutionBinaryService, E as NodeId, L as RunDataFactory, Ot as ExecutionContext, P as ParentExecutionRef, R as RunDataSnapshot, Rt as NodeBinaryAttachmentService, Ut as NodeExecutionStatePublisher, V as RunnableNodeConfig, a as BinaryAttachment, bt as BinaryStorageReadResult, et as WorkflowId, gt as RetryPolicySpec, k as NodeOutputs, kt as ExecutionContextFactory, u as Item, v as MutableRunData, vr as CredentialSessionService, vt as BinaryBody, xt as BinaryStorageStatResult, y as NodeActivationId, yt as BinaryStorage, z as RunId, zt as NodeExecutionContext } from "./RunIntentService-B1Y3v1H6.cjs";
+import { A as NodeOutputs, At as ExecutionContext, B as RunId, Bt as NodeBinaryAttachmentService, Ct as BinaryStorageStatResult, Dr as CostTrackingTelemetryFactory, E as NodeId, F as ParentExecutionRef, Gt as NodeExecutionStatePublisher, H as RunnableNodeConfig, I as PersistedRunPolicySnapshot, Jr as CredentialSessionService, R as RunDataFactory, St as BinaryStorageReadResult, Tt as BinaryStorageWriteResult, Vt as NodeExecutionContext, a as BinaryAttachment, bt as BinaryBody, jt as ExecutionContextFactory, kr as CostTrackingUsageRecord, kt as ExecutionBinaryService, rr as ExecutionTelemetryFactory, tt as WorkflowId, u as Item, v as MutableRunData, vt as RetryPolicySpec, xt as BinaryStorage, y as NodeActivationId, z as RunDataSnapshot } from "./RunIntentService-S-1lW-gS.cjs";
 
+//#region src/contracts/CostCatalogContract.d.ts
+interface CostCatalogEntry {
+  readonly component: CostTrackingUsageRecord["component"];
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly pricePerUnitMinor: number;
+}
+interface CostCatalog {
+  findEntry(args: CostTrackingUsageRecord): CostCatalogEntry | undefined;
+}
+//#endregion
 //#region src/execution/CredentialResolverFactory.d.ts
 declare class CredentialResolverFactory {
   private readonly credentialSessions;
@@ -20,17 +35,22 @@ declare class DefaultAsyncSleeper implements AsyncSleeper {
 //#region src/execution/DefaultExecutionContextFactory.d.ts
 declare class DefaultExecutionContextFactory implements ExecutionContextFactory {
   private readonly binaryStorage;
+  private readonly telemetryFactory;
+  private readonly costTrackingFactory;
   private readonly currentDate;
-  constructor(binaryStorage?: BinaryStorage, currentDate?: () => Date);
+  private readonly telemetryDecoratorFactory;
+  constructor(binaryStorage?: BinaryStorage, telemetryFactory?: ExecutionTelemetryFactory, costTrackingFactory?: CostTrackingTelemetryFactory, currentDate?: () => Date);
   create(args: {
     runId: RunId;
     workflowId: WorkflowId;
     parent?: ParentExecutionRef;
+    policySnapshot?: PersistedRunPolicySnapshot;
     subworkflowDepth: number;
     engineMaxNodeActivations: number;
     engineMaxSubworkflowDepth: number;
     data: RunDataSnapshot;
     nodeState?: NodeExecutionStatePublisher;
+    telemetry?: ExecutionContext["telemetry"];
     getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
   }): ExecutionContext;
 }
@@ -47,11 +67,11 @@ declare class InProcessRetryRunner {
   private static assertMultiplier;
 }
 //#endregion
-//#region src/execution/ItemValueResolver.d.ts
+//#region src/execution/ItemExprResolver.d.ts
 /**
- * Resolves {@link import("../contracts/itemValue").ItemValue} leaves on runnable config before {@link RunnableNode.execute}.
+ * Resolves {@link import("../contracts/itemExpr").ItemExpr} leaves on runnable config before {@link RunnableNode.execute}.
  */
-declare class ItemValueResolver {
+declare class ItemExprResolver {
   resolveConfigForItem<TConfig extends RunnableNodeConfig<any, any>>(ctx: NodeExecutionContext<TConfig>, item: Item, itemIndex: number, items: ReadonlyArray<Item>): Promise<NodeExecutionContext<TConfig>>;
 }
 //#endregion
@@ -107,5 +127,5 @@ declare class InMemoryRunDataFactory implements RunDataFactory {
   create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;
 }
 //#endregion
-export { RunnableOutputBehavior as a, InProcessRetryRunner as c, AsyncSleeper as d, CredentialResolverFactory as f, UnavailableBinaryStorage as i, DefaultExecutionContextFactory as l, InMemoryBinaryStorage as n, RunnableOutputBehaviorResolver as o, DefaultExecutionBinaryService as r, ItemValueResolver as s, InMemoryRunDataFactory as t, DefaultAsyncSleeper as u };
-//# sourceMappingURL=InMemoryRunDataFactory-Dyl4p2s8.d.cts.map
+export { RunnableOutputBehavior as a, InProcessRetryRunner as c, AsyncSleeper as d, CredentialResolverFactory as f, UnavailableBinaryStorage as i, DefaultExecutionContextFactory as l, CostCatalogEntry as m, InMemoryBinaryStorage as n, RunnableOutputBehaviorResolver as o, CostCatalog as p, DefaultExecutionBinaryService as r, ItemExprResolver as s, InMemoryRunDataFactory as t, DefaultAsyncSleeper as u };
+//# sourceMappingURL=InMemoryRunDataFactory-1iz7_SnO.d.cts.map

package/dist/{workflowActivationPolicy-6V3OJD3N.cjs → InMemoryRunEventBusRegistry-B0_C4OnP.cjs}

@@ -235,21 +235,6 @@ var InMemoryRunEventBus = class {
 };
 
 //#endregion
-//#region src/contracts/workflowActivationPolicy.ts
-/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */
-var AllWorkflowsActiveWorkflowActivationPolicy = class {
-	isActive(_workflowId) {
-		return true;
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'AllWorkflowsActiveWorkflowActivationPolicy', {
-  enumerable: true,
-  get: function () {
-    return AllWorkflowsActiveWorkflowActivationPolicy;
-  }
-});
 Object.defineProperty(exports, 'ChainCursor', {
   enumerable: true,
   get: function () {
@@ -274,4 +259,4 @@ Object.defineProperty(exports, 'WorkflowBuilder', {
     return WorkflowBuilder;
   }
 });
-//# sourceMappingURL=workflowActivationPolicy-6V3OJD3N.cjs.map
+//# sourceMappingURL=InMemoryRunEventBusRegistry-B0_C4OnP.cjs.map

package/dist/InMemoryRunEventBusRegistry-B0_C4OnP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryRunEventBusRegistry-B0_C4OnP.cjs","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","endpoints: ReadonlyArray<ChainCursorEndpoint>","port: OutputPortKey","prev: NodeRef | null","nextEndpoints: ChainCursorEndpoint[]","meta: { id: WorkflowId; name: string }","options?: Readonly<Record<string, never>>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorEndpoint = Readonly<{ node: NodeRef; output: OutputPortKey; inputPortHint?: InputPortKey }>;\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly endpoints: ReadonlyArray<ChainCursorEndpoint>,\n  ) {}\n\n  then<TOutputJson, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    const inputPortHint = this.resolveSharedInputPortHint();\n    for (const e of this.endpoints) {\n      (this.wf as any).connect(e.node, next, e.output);\n    }\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, [\n      { node: next, output: \"main\", ...(inputPortHint ? { inputPortHint } : {}) },\n    ]);\n  }\n\n  thenIntoInputHints<TOutputJson, TConfig extends RunnableNodeConfig<any, TOutputJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    for (const e of this.endpoints) {\n      (this.wf as any).connect(e.node, next, e.output, e.inputPortHint ?? \"in\");\n    }\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, [{ node: next, output: \"main\" }]);\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (this.endpoints.length !== 1) {\n      throw new Error(\"ChainCursor.when(...) is only supported from a single cursor endpoint\");\n    }\n    const cursor = this.endpoints[0]!.node;\n\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey; inputPortHint: InputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: cursor, endOutput: port, inputPortHint: port };\n      return { end: prev, endOutput: \"main\", inputPortHint: port };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n    return new ChainCursor<TCurrentJson>(this.wf, [\n      { node: t.end, output: t.endOutput, inputPortHint: t.inputPortHint },\n      { node: f.end, output: f.endOutput, inputPortHint: f.inputPortHint },\n    ]);\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  route<TNextJson>(\n    branches: Readonly<\n      Record<OutputPortKey, (branch: ChainCursor<TCurrentJson>) => ChainCursor<TNextJson> | undefined>\n    >,\n  ): ChainCursor<TNextJson> {\n    if (this.endpoints.length !== 1) {\n      throw new Error(\"ChainCursor.route(...) is only supported from a single cursor endpoint\");\n    }\n    const cursor = this.endpoints[0]!;\n    const nextEndpoints: ChainCursorEndpoint[] = [];\n    for (const [port, branchFactory] of Object.entries(branches)) {\n      if (!branchFactory) {\n        continue;\n      }\n      const branch = new ChainCursor<TCurrentJson>(this.wf, [{ node: cursor.node, output: port, inputPortHint: port }]);\n      const builtBranch = branchFactory(branch);\n      if (!builtBranch) {\n        continue;\n      }\n      nextEndpoints.push(...builtBranch.endpoints);\n    }\n    return new ChainCursor<TNextJson>(this.wf, nextEndpoints);\n  }\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n\n  private resolveSharedInputPortHint(): InputPortKey | undefined {\n    const first = this.endpoints[0]?.inputPortHint;\n    if (!first) {\n      return undefined;\n    }\n    return this.endpoints.every((endpoint) => endpoint.inputPortHint === first) ? first : undefined;\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<Record<string, never>>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, [{ node: ref, output: \"main\" }]);\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, [{ node: ref, output: \"main\" }]);\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n"],"mappings":"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"}

package/dist/{workflowActivationPolicy-Td9HTOuD.js → InMemoryRunEventBusRegistry-C2U83Hmv.js}

@@ -234,14 +234,5 @@ var InMemoryRunEventBus = class {
 };
 
 //#endregion
-//#region src/contracts/workflowActivationPolicy.ts
-/** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */
-var AllWorkflowsActiveWorkflowActivationPolicy = class {
-	isActive(_workflowId) {
-		return true;
-	}
-};
-
-//#endregion
-export { WhenBuilder as a, ChainCursor as i, InMemoryRunEventBus as n, WorkflowBuilder as r, AllWorkflowsActiveWorkflowActivationPolicy as t };
-//# sourceMappingURL=workflowActivationPolicy-Td9HTOuD.js.map
+export { WhenBuilder as i, WorkflowBuilder as n, ChainCursor as r, InMemoryRunEventBus as t };
+//# sourceMappingURL=InMemoryRunEventBusRegistry-C2U83Hmv.js.map

package/dist/InMemoryRunEventBusRegistry-C2U83Hmv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryRunEventBusRegistry-C2U83Hmv.js","names":["wf: WorkflowBuilder","from: NodeRef","branchPort: OutputPortKey","created: NodeRef[]","prev: NodeRef | null","port: OutputPortKey","wf: WorkflowBuilder","endpoints: ReadonlyArray<ChainCursorEndpoint>","port: OutputPortKey","prev: NodeRef | null","nextEndpoints: ChainCursorEndpoint[]","meta: { id: WorkflowId; name: string }","options?: Readonly<Record<string, never>>","onClose: () => void"],"sources":["../src/workflow/dsl/WhenBuilder.ts","../src/workflow/dsl/ChainCursorResolver.ts","../src/workflow/dsl/WorkflowBuilder.ts","../src/events/InMemoryRunEventSubscription.ts","../src/events/InMemoryRunEventBusRegistry.ts"],"sourcesContent":["import type { NodeId, NodeRef, OutputPortKey, UpstreamRefPlaceholder, WorkflowDefinition } from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport type { AnyRunnableNodeConfig, BooleanWhenOverloads, ValidStepSequence } from \"./workflowBuilderTypes\";\n\nexport class WhenBuilder<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly from: NodeRef,\n    private readonly branchPort: OutputPortKey,\n  ) {}\n\n  addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(\n    steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>,\n  ): this {\n    const created: NodeRef[] = [];\n\n    let prev: NodeRef | null = null;\n    for (const cfg of steps) {\n      const ref = (this.wf as any).add(cfg) as NodeRef;\n      created.push(ref);\n      if (!prev) (this.wf as any).connect(this.from, ref, this.branchPort, \"in\");\n      else (this.wf as any).connect(prev, ref, \"main\", \"in\");\n      prev = ref;\n    }\n\n    for (const cfg of steps) {\n      const maybe = cfg as unknown as { upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder> };\n      if (!Array.isArray(maybe.upstreamRefs) || maybe.upstreamRefs.length === 0) continue;\n\n      maybe.upstreamRefs = maybe.upstreamRefs.map((r) => {\n        if (typeof r !== \"string\") return r;\n        const idx = parseInt(r.slice(1), 10);\n        const nodeId = created[idx]?.id;\n        return nodeId ? { nodeId } : { nodeId: r };\n      });\n    }\n\n    return this;\n  }\n\n  readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> = (\n    branch: boolean,\n    steps: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> => {\n    const list = Array.isArray(steps) ? steps : [steps, ...more];\n    const port: OutputPortKey = branch ? \"true\" : \"false\";\n    const b = new WhenBuilder<TCurrentJson>(this.wf, this.from, port);\n    b.addBranch(list);\n    return b;\n  };\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n}\n","import type {\n  InputPortKey,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeConfig,\n  RunnableNodeOutputJson,\n  WorkflowDefinition,\n} from \"../../types\";\n\nimport { WorkflowBuilder } from \"./WorkflowBuilder\";\nimport { WhenBuilder } from \"./WhenBuilder\";\nimport type {\n  AnyRunnableNodeConfig,\n  BooleanWhenOverloads,\n  BranchOutputGuard,\n  BranchStepsArg,\n  StepSequenceOutput,\n} from \"./workflowBuilderTypes\";\n\ntype ChainCursorEndpoint = Readonly<{ node: NodeRef; output: OutputPortKey; inputPortHint?: InputPortKey }>;\n\ntype ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {\n  <\n    TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n  >(\n    branches: Readonly<{\n      true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;\n      false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig>\n        ? BranchStepsArg<TCurrentJson, TFalseSteps>\n        : never;\n    }> &\n      BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>,\n  ): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;\n};\n\nexport class ChainCursor<TCurrentJson> {\n  constructor(\n    private readonly wf: WorkflowBuilder,\n    private readonly endpoints: ReadonlyArray<ChainCursorEndpoint>,\n  ) {}\n\n  then<TOutputJson, TConfig extends RunnableNodeConfig<TCurrentJson, TOutputJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    const inputPortHint = this.resolveSharedInputPortHint();\n    for (const e of this.endpoints) {\n      (this.wf as any).connect(e.node, next, e.output);\n    }\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, [\n      { node: next, output: \"main\", ...(inputPortHint ? { inputPortHint } : {}) },\n    ]);\n  }\n\n  thenIntoInputHints<TOutputJson, TConfig extends RunnableNodeConfig<any, TOutputJson>>(\n    config: TConfig,\n  ): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const next = (this.wf as any).add(config) as NodeRef;\n    for (const e of this.endpoints) {\n      (this.wf as any).connect(e.node, next, e.output, e.inputPortHint ?? \"in\");\n    }\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this.wf, [{ node: next, output: \"main\" }]);\n  }\n\n  readonly when: ChainCursorWhenOverloads<TCurrentJson> = ((\n    arg1:\n      | boolean\n      | Readonly<{ true?: ReadonlyArray<AnyRunnableNodeConfig>; false?: ReadonlyArray<AnyRunnableNodeConfig> }>,\n    steps?: ReadonlyArray<AnyRunnableNodeConfig> | AnyRunnableNodeConfig,\n    ...more: AnyRunnableNodeConfig[]\n  ): WhenBuilder<TCurrentJson> | ChainCursor<TCurrentJson> => {\n    if (this.endpoints.length !== 1) {\n      throw new Error(\"ChainCursor.when(...) is only supported from a single cursor endpoint\");\n    }\n    const cursor = this.endpoints[0]!.node;\n\n    if (typeof arg1 === \"boolean\") {\n      const list = Array.isArray(steps) ? steps : steps ? [steps, ...more] : more;\n      const port: OutputPortKey = arg1 ? \"true\" : \"false\";\n      const b = new WhenBuilder<TCurrentJson>(this.wf, cursor, port);\n      b.addBranch(list);\n      return b;\n    }\n\n    const branches = arg1;\n    const wfAny = this.wf as any;\n\n    const buildBranch = (\n      port: OutputPortKey,\n      branchSteps: ReadonlyArray<AnyRunnableNodeConfig> | undefined,\n    ): Readonly<{ end: NodeRef; endOutput: OutputPortKey; inputPortHint: InputPortKey }> => {\n      const list = branchSteps ?? [];\n      let prev: NodeRef | null = null;\n      for (const cfg of list) {\n        const ref = wfAny.add(cfg) as NodeRef;\n        if (!prev) wfAny.connect(cursor, ref, port, \"in\");\n        else wfAny.connect(prev, ref, \"main\", \"in\");\n        prev = ref;\n      }\n      if (!prev) return { end: cursor, endOutput: port, inputPortHint: port };\n      return { end: prev, endOutput: \"main\", inputPortHint: port };\n    };\n\n    const t = buildBranch(\"true\", branches.true);\n    const f = buildBranch(\"false\", branches.false);\n    return new ChainCursor<TCurrentJson>(this.wf, [\n      { node: t.end, output: t.endOutput, inputPortHint: t.inputPortHint },\n      { node: f.end, output: f.endOutput, inputPortHint: f.inputPortHint },\n    ]);\n  }) as ChainCursorWhenOverloads<TCurrentJson>;\n\n  route<TNextJson>(\n    branches: Readonly<\n      Record<OutputPortKey, (branch: ChainCursor<TCurrentJson>) => ChainCursor<TNextJson> | undefined>\n    >,\n  ): ChainCursor<TNextJson> {\n    if (this.endpoints.length !== 1) {\n      throw new Error(\"ChainCursor.route(...) is only supported from a single cursor endpoint\");\n    }\n    const cursor = this.endpoints[0]!;\n    const nextEndpoints: ChainCursorEndpoint[] = [];\n    for (const [port, branchFactory] of Object.entries(branches)) {\n      if (!branchFactory) {\n        continue;\n      }\n      const branch = new ChainCursor<TCurrentJson>(this.wf, [{ node: cursor.node, output: port, inputPortHint: port }]);\n      const builtBranch = branchFactory(branch);\n      if (!builtBranch) {\n        continue;\n      }\n      nextEndpoints.push(...builtBranch.endpoints);\n    }\n    return new ChainCursor<TNextJson>(this.wf, nextEndpoints);\n  }\n\n  build(): WorkflowDefinition {\n    return this.wf.build();\n  }\n\n  private resolveSharedInputPortHint(): InputPortKey | undefined {\n    const first = this.endpoints[0]?.inputPortHint;\n    if (!first) {\n      return undefined;\n    }\n    return this.endpoints.every((endpoint) => endpoint.inputPortHint === first) ? first : undefined;\n  }\n}\n","import type {\n  InputPortKey,\n  NodeConfigBase,\n  NodeDefinition,\n  NodeRef,\n  OutputPortKey,\n  RunnableNodeOutputJson,\n  TriggerNodeOutputJson,\n  WorkflowDefinition,\n  WorkflowId,\n} from \"../../types\";\n\nimport { ChainCursor } from \"./ChainCursorResolver\";\nimport type { AnyRunnableNodeConfig, AnyTriggerNodeConfig } from \"./workflowBuilderTypes\";\n\nexport class WorkflowBuilder {\n  private readonly nodes: NodeDefinition[] = [];\n  private readonly edges: WorkflowDefinition[\"edges\"] = [];\n  private seq = 0;\n\n  constructor(\n    private readonly meta: { id: WorkflowId; name: string },\n    private readonly options?: Readonly<Record<string, never>>,\n  ) {}\n\n  private add(config: NodeConfigBase): NodeRef {\n    const tokenName = typeof config.type === \"function\" ? config.type.name : String(config.type);\n    const id = config.id ?? `${tokenName}:${++this.seq}`;\n    this.nodes.push({ id, kind: config.kind, type: config.type, name: config.name, config });\n    return { id, kind: config.kind, name: config.name };\n  }\n\n  private connect(from: NodeRef, to: NodeRef, fromOutput: OutputPortKey = \"main\", toInput: InputPortKey = \"in\"): void {\n    this.edges.push({ from: { nodeId: from.id, output: fromOutput }, to: { nodeId: to.id, input: toInput } });\n  }\n\n  trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<TriggerNodeOutputJson<TConfig>>(this, [{ node: ref, output: \"main\" }]);\n  }\n\n  start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>> {\n    const ref = this.add(config);\n    return new ChainCursor<RunnableNodeOutputJson<TConfig>>(this, [{ node: ref, output: \"main\" }]);\n  }\n\n  build(): WorkflowDefinition {\n    return { ...this.meta, nodes: this.nodes, edges: this.edges };\n  }\n}\n\nexport { ChainCursor } from \"./ChainCursorResolver\";\nexport { WhenBuilder } from \"./WhenBuilder\";\n","import type { RunEventSubscription } from \"./runEvents\";\n\nexport class InMemoryRunEventSubscription implements RunEventSubscription {\n  constructor(private readonly onClose: () => void) {}\n\n  async close(): Promise<void> {\n    this.onClose();\n  }\n}\n","import type { WorkflowId } from \"../types\";\n\nimport type { RunEvent, RunEventBus, RunEventSubscription } from \"./runEvents\";\n\nimport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n\nexport class InMemoryRunEventBus implements RunEventBus {\n  private readonly globalListeners = new Set<(event: RunEvent) => void>();\n  private readonly listenersByWorkflowId = new Map<WorkflowId, Set<(event: RunEvent) => void>>();\n\n  async publish(event: RunEvent): Promise<void> {\n    for (const listener of this.globalListeners) listener(event);\n    for (const listener of this.listenersByWorkflowId.get(event.workflowId) ?? []) listener(event);\n  }\n\n  async subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    this.globalListeners.add(onEvent);\n    return new InMemoryRunEventSubscription(() => {\n      this.globalListeners.delete(onEvent);\n    });\n  }\n\n  async subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription> {\n    const existing = this.listenersByWorkflowId.get(workflowId) ?? new Set<(event: RunEvent) => void>();\n    existing.add(onEvent);\n    this.listenersByWorkflowId.set(workflowId, existing);\n\n    return new InMemoryRunEventSubscription(() => {\n      const listeners = this.listenersByWorkflowId.get(workflowId);\n      if (!listeners) return;\n      listeners.delete(onEvent);\n      if (listeners.size === 0) this.listenersByWorkflowId.delete(workflowId);\n    });\n  }\n}\n\nexport { InMemoryRunEventSubscription } from \"./InMemoryRunEventSubscription\";\n"],"mappings":";AAKA,IAAa,cAAb,MAAa,YAA0B;CACrC,YACE,AAAiBA,IACjB,AAAiBC,MACjB,AAAiBC,YACjB;EAHiB;EACA;EACA;;CAGnB,UACE,OACM;EACN,MAAMC,UAAqB,EAAE;EAE7B,IAAIC,OAAuB;AAC3B,OAAK,MAAM,OAAO,OAAO;GACvB,MAAM,MAAO,KAAK,GAAW,IAAI,IAAI;AACrC,WAAQ,KAAK,IAAI;AACjB,OAAI,CAAC,KAAM,CAAC,KAAK,GAAW,QAAQ,KAAK,MAAM,KAAK,KAAK,YAAY,KAAK;OACrE,CAAC,KAAK,GAAW,QAAQ,MAAM,KAAK,QAAQ,KAAK;AACtD,UAAO;;AAGT,OAAK,MAAM,OAAO,OAAO;GACvB,MAAM,QAAQ;AACd,OAAI,CAAC,MAAM,QAAQ,MAAM,aAAa,IAAI,MAAM,aAAa,WAAW,EAAG;AAE3E,SAAM,eAAe,MAAM,aAAa,KAAK,MAAM;AACjD,QAAI,OAAO,MAAM,SAAU,QAAO;IAElC,MAAM,SAAS,QADH,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,GACP;AAC7B,WAAO,SAAS,EAAE,QAAQ,GAAG,EAAE,QAAQ,GAAG;KAC1C;;AAGJ,SAAO;;CAGT,AAAS,QACP,QACA,OACA,GAAG,SAC2B;EAC9B,MAAM,OAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,OAAO,GAAG,KAAK;EAC5D,MAAMC,OAAsB,SAAS,SAAS;EAC9C,MAAM,IAAI,IAAI,YAA0B,KAAK,IAAI,KAAK,MAAM,KAAK;AACjE,IAAE,UAAU,KAAK;AACjB,SAAO;;CAGT,QAA4B;AAC1B,SAAO,KAAK,GAAG,OAAO;;;;;;AClB1B,IAAa,cAAb,MAAa,YAA0B;CACrC,YACE,AAAiBC,IACjB,AAAiBC,WACjB;EAFiB;EACA;;CAGnB,KACE,QAC8C;EAC9C,MAAM,OAAQ,KAAK,GAAW,IAAI,OAAO;EACzC,MAAM,gBAAgB,KAAK,4BAA4B;AACvD,OAAK,MAAM,KAAK,KAAK,UACnB,CAAC,KAAK,GAAW,QAAQ,EAAE,MAAM,MAAM,EAAE,OAAO;AAElD,SAAO,IAAI,YAA6C,KAAK,IAAI,CAC/D;GAAE,MAAM;GAAM,QAAQ;GAAQ,GAAI,gBAAgB,EAAE,eAAe,GAAG,EAAE;GAAG,CAC5E,CAAC;;CAGJ,mBACE,QAC8C;EAC9C,MAAM,OAAQ,KAAK,GAAW,IAAI,OAAO;AACzC,OAAK,MAAM,KAAK,KAAK,UACnB,CAAC,KAAK,GAAW,QAAQ,EAAE,MAAM,MAAM,EAAE,QAAQ,EAAE,iBAAiB,KAAK;AAE3E,SAAO,IAAI,YAA6C,KAAK,IAAI,CAAC;GAAE,MAAM;GAAM,QAAQ;GAAQ,CAAC,CAAC;;CAGpG,AAAS,SACP,MAGA,OACA,GAAG,SACuD;AAC1D,MAAI,KAAK,UAAU,WAAW,EAC5B,OAAM,IAAI,MAAM,wEAAwE;EAE1F,MAAM,SAAS,KAAK,UAAU,GAAI;AAElC,MAAI,OAAO,SAAS,WAAW;GAC7B,MAAM,OAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,QAAQ,CAAC,OAAO,GAAG,KAAK,GAAG;GACvE,MAAMC,OAAsB,OAAO,SAAS;GAC5C,MAAM,IAAI,IAAI,YAA0B,KAAK,IAAI,QAAQ,KAAK;AAC9D,KAAE,UAAU,KAAK;AACjB,UAAO;;EAGT,MAAM,WAAW;EACjB,MAAM,QAAQ,KAAK;EAEnB,MAAM,eACJ,MACA,gBACsF;GACtF,MAAM,OAAO,eAAe,EAAE;GAC9B,IAAIC,OAAuB;AAC3B,QAAK,MAAM,OAAO,MAAM;IACtB,MAAM,MAAM,MAAM,IAAI,IAAI;AAC1B,QAAI,CAAC,KAAM,OAAM,QAAQ,QAAQ,KAAK,MAAM,KAAK;QAC5C,OAAM,QAAQ,MAAM,KAAK,QAAQ,KAAK;AAC3C,WAAO;;AAET,OAAI,CAAC,KAAM,QAAO;IAAE,KAAK;IAAQ,WAAW;IAAM,eAAe;IAAM;AACvE,UAAO;IAAE,KAAK;IAAM,WAAW;IAAQ,eAAe;IAAM;;EAG9D,MAAM,IAAI,YAAY,QAAQ,SAAS,KAAK;EAC5C,MAAM,IAAI,YAAY,SAAS,SAAS,MAAM;AAC9C,SAAO,IAAI,YAA0B,KAAK,IAAI,CAC5C;GAAE,MAAM,EAAE;GAAK,QAAQ,EAAE;GAAW,eAAe,EAAE;GAAe,EACpE;GAAE,MAAM,EAAE;GAAK,QAAQ,EAAE;GAAW,eAAe,EAAE;GAAe,CACrE,CAAC;;CAGJ,MACE,UAGwB;AACxB,MAAI,KAAK,UAAU,WAAW,EAC5B,OAAM,IAAI,MAAM,yEAAyE;EAE3F,MAAM,SAAS,KAAK,UAAU;EAC9B,MAAMC,gBAAuC,EAAE;AAC/C,OAAK,MAAM,CAAC,MAAM,kBAAkB,OAAO,QAAQ,SAAS,EAAE;AAC5D,OAAI,CAAC,cACH;GAGF,MAAM,cAAc,cADL,IAAI,YAA0B,KAAK,IAAI,CAAC;IAAE,MAAM,OAAO;IAAM,QAAQ;IAAM,eAAe;IAAM,CAAC,CAAC,CACxE;AACzC,OAAI,CAAC,YACH;AAEF,iBAAc,KAAK,GAAG,YAAY,UAAU;;AAE9C,SAAO,IAAI,YAAuB,KAAK,IAAI,cAAc;;CAG3D,QAA4B;AAC1B,SAAO,KAAK,GAAG,OAAO;;CAGxB,AAAQ,6BAAuD;EAC7D,MAAM,QAAQ,KAAK,UAAU,IAAI;AACjC,MAAI,CAAC,MACH;AAEF,SAAO,KAAK,UAAU,OAAO,aAAa,SAAS,kBAAkB,MAAM,GAAG,QAAQ;;;;;;AClI1F,IAAa,kBAAb,MAA6B;CAC3B,AAAiB,QAA0B,EAAE;CAC7C,AAAiB,QAAqC,EAAE;CACxD,AAAQ,MAAM;CAEd,YACE,AAAiBC,MACjB,AAAiBC,SACjB;EAFiB;EACA;;CAGnB,AAAQ,IAAI,QAAiC;EAC3C,MAAM,YAAY,OAAO,OAAO,SAAS,aAAa,OAAO,KAAK,OAAO,OAAO,OAAO,KAAK;EAC5F,MAAM,KAAK,OAAO,MAAM,GAAG,UAAU,GAAG,EAAE,KAAK;AAC/C,OAAK,MAAM,KAAK;GAAE;GAAI,MAAM,OAAO;GAAM,MAAM,OAAO;GAAM,MAAM,OAAO;GAAM;GAAQ,CAAC;AACxF,SAAO;GAAE;GAAI,MAAM,OAAO;GAAM,MAAM,OAAO;GAAM;;CAGrD,AAAQ,QAAQ,MAAe,IAAa,aAA4B,QAAQ,UAAwB,MAAY;AAClH,OAAK,MAAM,KAAK;GAAE,MAAM;IAAE,QAAQ,KAAK;IAAI,QAAQ;IAAY;GAAE,IAAI;IAAE,QAAQ,GAAG;IAAI,OAAO;IAAS;GAAE,CAAC;;CAG3G,QAA8C,QAA8D;EAC1G,MAAM,MAAM,KAAK,IAAI,OAAO;AAC5B,SAAO,IAAI,YAA4C,MAAM,CAAC;GAAE,MAAM;GAAK,QAAQ;GAAQ,CAAC,CAAC;;CAG/F,MAA6C,QAA+D;EAC1G,MAAM,MAAM,KAAK,IAAI,OAAO;AAC5B,SAAO,IAAI,YAA6C,MAAM,CAAC;GAAE,MAAM;GAAK,QAAQ;GAAQ,CAAC,CAAC;;CAGhG,QAA4B;AAC1B,SAAO;GAAE,GAAG,KAAK;GAAM,OAAO,KAAK;GAAO,OAAO,KAAK;GAAO;;;;;;AC7CjE,IAAa,+BAAb,MAA0E;CACxE,YAAY,AAAiBC,SAAqB;EAArB;;CAE7B,MAAM,QAAuB;AAC3B,OAAK,SAAS;;;;;;ACAlB,IAAa,sBAAb,MAAwD;CACtD,AAAiB,kCAAkB,IAAI,KAAgC;CACvE,AAAiB,wCAAwB,IAAI,KAAiD;CAE9F,MAAM,QAAQ,OAAgC;AAC5C,OAAK,MAAM,YAAY,KAAK,gBAAiB,UAAS,MAAM;AAC5D,OAAK,MAAM,YAAY,KAAK,sBAAsB,IAAI,MAAM,WAAW,IAAI,EAAE,CAAE,UAAS,MAAM;;CAGhG,MAAM,UAAU,SAAmE;AACjF,OAAK,gBAAgB,IAAI,QAAQ;AACjC,SAAO,IAAI,mCAAmC;AAC5C,QAAK,gBAAgB,OAAO,QAAQ;IACpC;;CAGJ,MAAM,oBAAoB,YAAwB,SAAmE;EACnH,MAAM,WAAW,KAAK,sBAAsB,IAAI,WAAW,oBAAI,IAAI,KAAgC;AACnG,WAAS,IAAI,QAAQ;AACrB,OAAK,sBAAsB,IAAI,YAAY,SAAS;AAEpD,SAAO,IAAI,mCAAmC;GAC5C,MAAM,YAAY,KAAK,sBAAsB,IAAI,WAAW;AAC5D,OAAI,CAAC,UAAW;AAChB,aAAU,OAAO,QAAQ;AACzB,OAAI,UAAU,SAAS,EAAG,MAAK,sBAAsB,OAAO,WAAW;IACvE"}