@codemation/core 0.8.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/CHANGELOG.md +380 -0
  2. package/dist/{EngineRuntimeRegistration.types-BP6tsaNP.d.ts → EngineRuntimeRegistration.types-D1fyApMI.d.ts} +2 -2
  3. package/dist/{EngineWorkflowRunnerService-DzOCa1BW.d.cts → EngineRuntimeRegistration.types-pB3FnzqR.d.cts} +17 -17
  4. package/dist/{InMemoryRunDataFactory-1iz7_SnO.d.cts → InMemoryRunDataFactory-Xw7v4-sj.d.cts} +31 -29
  5. package/dist/InMemoryRunEventBusRegistry-VM3OWnHo.cjs +47 -0
  6. package/dist/InMemoryRunEventBusRegistry-VM3OWnHo.cjs.map +1 -0
  7. package/dist/InMemoryRunEventBusRegistry-sM4z4n_i.js +41 -0
  8. package/dist/InMemoryRunEventBusRegistry-sM4z4n_i.js.map +1 -0
  9. package/dist/{RunIntentService-BqhmdoA1.d.ts → RunIntentService-BE9CAkbf.d.ts} +966 -471
  10. package/dist/{RunIntentService-S-1lW-gS.d.cts → RunIntentService-siBSjaaY.d.cts} +859 -493
  11. package/dist/bootstrap/index.cjs +5 -2
  12. package/dist/bootstrap/index.d.cts +212 -135
  13. package/dist/bootstrap/index.d.ts +4 -4
  14. package/dist/bootstrap/index.js +3 -3
  15. package/dist/{bootstrap-Bx1u4cbS.cjs → bootstrap-Cm5ruQxx.cjs} +253 -2
  16. package/dist/bootstrap-Cm5ruQxx.cjs.map +1 -0
  17. package/dist/{bootstrap-BoknFKnw.js → bootstrap-D3r505ko.js} +236 -3
  18. package/dist/bootstrap-D3r505ko.js.map +1 -0
  19. package/dist/{index-CVs9rVhl.d.ts → index-DeLl1Tne.d.ts} +632 -230
  20. package/dist/index.cjs +323 -176
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.cts +544 -91
  23. package/dist/index.d.ts +3 -3
  24. package/dist/index.js +299 -166
  25. package/dist/index.js.map +1 -1
  26. package/dist/{runtime-DUW6tIJ1.js → runtime-BGNbRnqs.js} +934 -75
  27. package/dist/runtime-BGNbRnqs.js.map +1 -0
  28. package/dist/{runtime-Dvo2ru5A.cjs → runtime-DKXJwTNv.cjs} +1028 -73
  29. package/dist/runtime-DKXJwTNv.cjs.map +1 -0
  30. package/dist/testing.cjs +4 -4
  31. package/dist/testing.cjs.map +1 -1
  32. package/dist/testing.d.cts +2 -2
  33. package/dist/testing.d.ts +2 -2
  34. package/dist/testing.js +3 -3
  35. package/package.json +7 -2
  36. package/src/ai/AiHost.ts +42 -14
  37. package/src/authoring/DefinedCollectionRegistry.ts +17 -0
  38. package/src/authoring/defineCollection.types.ts +181 -0
  39. package/src/authoring/definePollingTrigger.types.ts +396 -0
  40. package/src/authoring/definePollingTriggerInternals.ts +74 -0
  41. package/src/authoring/index.ts +19 -0
  42. package/src/bootstrap/index.ts +9 -0
  43. package/src/bootstrap/runtime/EngineRuntimeRegistrar.ts +8 -0
  44. package/src/browser.ts +1 -0
  45. package/src/contracts/CodemationTelemetryAttributeNames.ts +6 -0
  46. package/src/contracts/NoOpNodeExecutionTelemetry.ts +2 -11
  47. package/src/contracts/NoOpTelemetrySpanScope.ts +46 -10
  48. package/src/contracts/assertionTypes.ts +63 -0
  49. package/src/contracts/baseTypes.ts +12 -0
  50. package/src/contracts/collectionTypes.ts +44 -0
  51. package/src/contracts/credentialTypes.ts +23 -1
  52. package/src/contracts/executionPersistenceContracts.ts +30 -0
  53. package/src/contracts/index.ts +4 -0
  54. package/src/contracts/runTypes.ts +37 -1
  55. package/src/contracts/runtimeTypes.ts +42 -0
  56. package/src/contracts/telemetryTypes.ts +8 -0
  57. package/src/contracts/testTriggerTypes.ts +66 -0
  58. package/src/contracts/workflowTypes.ts +36 -7
  59. package/src/contracts.ts +59 -0
  60. package/src/events/ConnectionInvocationEventPublisher.ts +46 -0
  61. package/src/events/index.ts +1 -0
  62. package/src/events/runEvents.ts +74 -0
  63. package/src/execution/ChildExecutionScopeFactory.ts +55 -0
  64. package/src/execution/DefaultExecutionContextFactory.ts +6 -0
  65. package/src/execution/ExecutionTelemetryCostTrackingDecoratorFactory.ts +18 -0
  66. package/src/execution/NodeExecutor.ts +10 -2
  67. package/src/execution/NodeInstanceFactory.ts +13 -1
  68. package/src/execution/NodeInstantiationError.ts +16 -0
  69. package/src/execution/NodeRunStateWriter.ts +7 -0
  70. package/src/execution/NodeRunStateWriterFactory.ts +7 -0
  71. package/src/execution/WorkflowRunExecutionContextFactory.ts +3 -0
  72. package/src/execution/index.ts +2 -0
  73. package/src/index.ts +8 -0
  74. package/src/orchestration/AbortControllerFactory.ts +9 -0
  75. package/src/orchestration/NodeExecutionRequestHandlerService.ts +1 -0
  76. package/src/orchestration/RunContinuationService.ts +3 -0
  77. package/src/orchestration/RunStartService.ts +122 -3
  78. package/src/orchestration/TestSuiteOrchestrator.ts +350 -0
  79. package/src/orchestration/TestSuiteRunIdFactory.ts +11 -0
  80. package/src/orchestration/TriggerRuntimeService.ts +34 -7
  81. package/src/orchestration/index.ts +9 -0
  82. package/src/runtime/EngineFactory.ts +12 -0
  83. package/src/triggers/polling/PollingTriggerDedupWindow.ts +23 -0
  84. package/src/triggers/polling/PollingTriggerLogger.ts +18 -0
  85. package/src/triggers/polling/PollingTriggerRuntime.ts +122 -0
  86. package/src/triggers/polling/index.ts +5 -0
  87. package/src/types/index.ts +12 -9
  88. package/src/workflow/definition/NodeIterationIdFactory.ts +26 -0
  89. package/src/workflow/dsl/NodeIdSlugifier.ts +18 -0
  90. package/src/workflow/dsl/WorkflowBuilder.ts +71 -3
  91. package/src/workflow/dsl/WorkflowDefinitionError.ts +15 -0
  92. package/src/workflow/index.ts +3 -0
  93. package/dist/InMemoryRunEventBusRegistry-B0_C4OnP.cjs +0 -262
  94. package/dist/InMemoryRunEventBusRegistry-B0_C4OnP.cjs.map +0 -1
  95. package/dist/InMemoryRunEventBusRegistry-C2U83Hmv.js +0 -238
  96. package/dist/InMemoryRunEventBusRegistry-C2U83Hmv.js.map +0 -1
  97. package/dist/bootstrap-BoknFKnw.js.map +0 -1
  98. package/dist/bootstrap-Bx1u4cbS.cjs.map +0 -1
  99. package/dist/runtime-DUW6tIJ1.js.map +0 -1
  100. package/dist/runtime-Dvo2ru5A.cjs.map +0 -1
package/dist/index.d.cts CHANGED
@@ -1,24 +1,63 @@
1
- import { $ as WorkflowGraph, $n as WorkflowExecutionListingRepository, $r as CredentialTypeRegistry, $t as TriggerCleanupHandle, A as NodeOutputs, An as NodeInputsByPort, Ar as AnyCredentialType, At as ExecutionContext, B as RunId, Bn as PinnedNodeOutputsByPort, Br as CredentialInstanceRecord, Bt as NodeBinaryAttachmentService, C as NodeErrorHandler, Ci as RunEvent, Cn as ConnectionInvocationRecord, Cr as CostTrackingComponent, Ct as BinaryStorageStatResult, D as NodeIdRef, Dn as NodeExecutionError, Dr as CostTrackingTelemetryFactory, Dt as EngineHost, E as NodeId, En as ExecutionFrontierPlan, Er as CostTrackingTelemetryAttributeNames, Et as EngineDeps, F as ParentExecutionRef, Fn as PersistedRunSchedulingState, Fr as CredentialFieldSchema, Ft as NodeActivationContinuation, G as TriggerNodeConfig, Gn as RunPruneCandidate, Gr as CredentialRequirement, Gt as NodeExecutionStatePublisher, H as RunnableNodeConfig, Hn as RunCurrentState, Hr as CredentialMaterialSourceKind, Ht as NodeExecutionRequest, I as PersistedRunPolicySnapshot, In as PersistedRunState, Ir as CredentialHealth, It as NodeActivationReceipt, J as UpstreamRefPlaceholder, Jn as RunStateResetRequest, Jr as CredentialSessionService, Jt as PersistedTriggerSetupState, K as TriggerNodeOutputJson, Kn as RunQueueEntry, Kr as CredentialSessionFactory, Kt as NodeExecutor, L as PersistedTokenId, Ln as PersistedWorkflowSnapshot, Lr as CredentialHealthStatus, Lt as NodeActivationRequest, M as NodeSchedulerDecision, Mn as PersistedMutableNodeState, Mr as CredentialAuthDefinition, Mt as ItemNode, N as OutputPortKey, Nn as PersistedMutableRunState, Nr as CredentialBinding, Nt as LiveWorkflowRepository, O as NodeKind, On as NodeExecutionSnapshot, Or as CostTrackingTelemetryMetricNames, Ot as ExecutableTriggerNode, P as PairedItemRef, Pn as PersistedRunControlState, Pr as CredentialBindingKey, Pt as MultiInputNode, Q as WorkflowErrorHandlerSpec, Qn as WebhookRunResult, Qr as CredentialTypeId, Qt as TestableTriggerNode, R as RunDataFactory, Rn as PersistedWorkflowSnapshotNode, Rr as CredentialHealthTester, Rt as NodeActivationRequestBase, S as NodeDefinition, Si as EngineExecutionLimitsPolicyConfig, Sn as ConnectionInvocationId, Sr as NoOpTelemetryArtifactReference, St as BinaryStorageReadResult, T as NodeErrorHandlerSpec, Ti as RunEventSubscription, Tn as EngineRunCounters, Tr as CostTrackingTelemetry, Tt as BinaryStorageWriteResult, U as RunnableNodeInputJson, Un as RunEventPublisherDeps, Ur as CredentialOAuth2AuthDefinition, Ut as NodeExecutionRequestHandler, V as RunIdFactory, Vn as RunCompletionNotifier, Vr as CredentialJsonRecord, Vt as NodeExecutionContext, W as RunnableNodeOutputJson, Wn as RunExecutionOptions, Wr as CredentialOAuth2ScopesFromPublicConfig, Wt as NodeExecutionScheduler, X as WorkflowErrorContext, Xn as RunStopCondition, Xr as CredentialType, Xt as RunnableNode, Y as WorkflowDefinition, Yn as RunStatus, Yr as CredentialSetupStatus, Yt as PreparedNodeActivationDispatch, Z as WorkflowErrorHandler, Zn as RunSummary, Zr as CredentialTypeDefinition, Zt as RunnableNodeExecuteArgs, _ as JsonValue, _i as registry, _n as WebhookTriggerResolution, _r as CodemationTelemetryAttributeNames, _t as NoneRetryPolicySpec, a as BinaryAttachment, ai as InjectionToken, an as TriggerTestItemsContext, ar as TelemetryArtifactAttachment, at as WorkflowStoragePolicyDecisionArgs, b as NodeConfigBase, bn as WorkflowActivationPolicy, br as NoOpNodeExecutionTelemetry, bt as BinaryBody, c as ExecutionMode, ci as TypeToken, cn as WorkflowRunnerResolver, cr as TelemetryAttributes, ct as WorkflowStoragePolicySpec, d as ItemBinary, di as inject, dn as WorkflowSnapshotResolver, dr as TelemetryScope, dt as runnableNodeInputType, ei as CredentialUnboundError, en as TriggerNode, er as WorkflowExecutionPruneRepository, et as WorkflowGraphFactory, f as Items, fi as injectAll, fn as HttpMethod, fr as TelemetrySpanEnd, ft as runnableNodeOutputType, g as JsonPrimitive, gi as predicateAwareClassFactory, gn as WebhookTriggerMatcher, gr as GenAiTelemetryAttributeNames, gt as FixedRetryPolicySpec, h as JsonObject, hi as instancePerContainerCachingFactory, hn as WebhookInvocationMatch, hr as CodemationTelemetryMetricNames, ht as ExponentialRetryPolicySpec, i as ActivationIdFactory, ii as Disposable, in as TriggerSetupStateRepository, ir as NodeExecutionTelemetry, it as WorkflowPrunePolicySpec, j as NodeRef, jn as PendingNodeExecution, jr as CredentialAdvancedSectionPresentation, jt as ExecutionContextFactory, k as NodeOffloadPolicy, kn as NodeExecutionStatus, kr as CostTrackingUsageRecord, kt as ExecutionBinaryService, l as InputPortKey, li as container, ln as WorkflowRunnerService, lr as TelemetryChildSpanStart, lt as branchRef, m as JsonNonArray, mi as instanceCachingFactory, mn as WebhookControlSignal, mr as TelemetrySpanScope, mt as triggerNodeSetupStateType, n as InMemoryLiveWorkflowRepository, ni as Container, nn as TriggerSetupContext, nr as ExecutionTelemetry, nt as WorkflowNodeConnection, o as BinaryPreviewKind, oi as Lifecycle, on as WorkflowNodeInstanceFactory, or as TelemetryArtifactReference, ot as WorkflowStoragePolicyMode, p as JsonArray, pi as injectable, pn as TriggerInstanceId, pr as TelemetrySpanEventRecord, pt as triggerNodeOutputType, q as TriggerNodeSetupState, qn as RunResult, qr as CredentialSessionFactoryArgs, qt as NodeResolver, ri as DependencyContainer, rn as TriggerSetupStateFor, rr as ExecutionTelemetryFactory, rt as WorkflowPolicyRuntimeDefaults, s as Edge, si as RegistrationOptions, sn as WorkflowRepository, sr as TelemetryAttributePrimitive, st as WorkflowStoragePolicyResolver, t as RunIntentService, ti as OAuth2ProviderFromPublicConfig, tn as TriggerRuntimeDiagnostics, tr as WorkflowExecutionRepository, tt as WorkflowId, u as Item, ui as delay, un as WorkflowSnapshotFactory, ur as TelemetryMetricRecord, ut as nodeRef, v as MutableRunData, vi as singleton, vn as WebhookTriggerRoutingDiagnostics, vr as NoOpExecutionTelemetryFactory, vt as RetryPolicySpec, w as NodeErrorHandlerArgs, wi as RunEventBus, wn as CurrentStateExecutionRequest, wr as CostTrackingPriceQuote, wt as BinaryStorageWriteRequest, x as NodeConnectionName, xi as EngineExecutionLimitsPolicy, xn as ConnectionInvocationAppendArgs, xr as NoOpTelemetrySpanScope, xt as BinaryStorage, y as NodeActivationId, yi as CoreTokens, yn as AllWorkflowsActiveWorkflowActivationPolicy, yr as NoOpExecutionTelemetry, yt as BinaryAttachmentCreateRequest, z as RunDataSnapshot, zn as PersistedWorkflowTokenRegistryLike, zr as CredentialInstanceId, zt as NodeActivationScheduler } from "./RunIntentService-S-1lW-gS.cjs";
2
- import { a as RunnableOutputBehavior, c as InProcessRetryRunner, f as CredentialResolverFactory, i as UnavailableBinaryStorage, l as DefaultExecutionContextFactory, m as CostCatalogEntry, n as InMemoryBinaryStorage, o as RunnableOutputBehaviorResolver, p as CostCatalog, r as DefaultExecutionBinaryService, s as ItemExprResolver, t as InMemoryRunDataFactory, u as DefaultAsyncSleeper } from "./InMemoryRunDataFactory-1iz7_SnO.cjs";
1
+ import { $ as WorkflowPrunePolicySpec, $n as CredentialHealth, $r as RunTestContext, $t as TriggerSetupStateFor, A as NodeSchedulerDecision, Ai as TestSuiteRunId, An as CodemationTelemetryMetricNames, Ar as NodeExecutionStatus, At as NodeActivationContinuation, B as RunnableNodeOutputJson, Bn as CostTrackingTelemetry, Br as PersistedWorkflowTokenRegistryLike, Bt as NodeExecutionStatePublisher, C as NodeErrorHandlerSpec, Ci as EngineExecutionLimitsPolicy, Cn as TelemetryAttributes, Cr as ConnectionInvocationId, Ct as ExecutableTriggerNode, D as NodeOffloadPolicy, Di as RunEventSubscription, Dn as TelemetrySpanEnd, Dr as ExecutionFrontierPlan, Dt as ItemNode, E as NodeKind, Ei as RunEventBus, En as TelemetryScope, Er as EngineRunCounters, Et as ExecutionContextFactory, F as RunDataSnapshot, Fi as NodeId, Fn as NoOpNodeExecutionTelemetry, Fr as PersistedRunControlState, Ft as NodeBinaryAttachmentService, G as WorkflowDefinition, Gn as CollectionStore, Gr as RunExecutionOptions, Gt as PreparedNodeActivationDispatch, H as TriggerNodeOutputJson, Hn as CostTrackingTelemetryFactory, Hr as RunCompletionNotifier, Ht as NodeResolver, I as RunId, Ii as OutputPortKey, In as NoOpTelemetrySpanScope, Ir as PersistedRunSchedulingState, It as NodeExecutionContext, J as WorkflowErrorHandlerSpec, Jn as CredentialAdvancedSectionPresentation, Jr as RunResult, Jt as TestableTriggerNode, K as WorkflowErrorContext, Kn as CollectionsContext, Kr as RunPruneCandidate, Kt as RunnableNode, L as RunIdFactory, Li as PersistedTokenId, Ln as NoOpTelemetryArtifactReference, Lr as PersistedRunState, Lt as NodeExecutionRequest, M as ParentExecutionRef, Mi as TestTriggerSetupContext, Mn as CodemationTelemetryAttributeNames, Mr as PendingNodeExecution, Mt as NodeActivationRequest, N as PersistedRunPolicySnapshot, Ni as InputPortKey, Nn as NoOpExecutionTelemetryFactory, Nr as PersistedMutableNodeState, Nt as NodeActivationRequestBase, O as NodeOutputs, Oi as TestCaseRunStatus, On as TelemetrySpanEventRecord, Or as NodeExecutionError, Ot as LiveWorkflowRepository, P as RunDataFactory, Pi as NodeConnectionName, Pn as NoOpExecutionTelemetry, Pr as PersistedMutableRunState, Pt as NodeActivationScheduler, Q as WorkflowPolicyRuntimeDefaults, Qn as CredentialFieldSchema, Qr as RunSummary, Qt as TriggerSetupContext, R as RunnableNodeConfig, Ri as WorkflowId, Rn as CostTrackingComponent, Rr as PersistedWorkflowSnapshot, Rt as NodeExecutionRequestHandler, S as NodeErrorHandlerArgs, Sn as TelemetryAttributePrimitive, Sr as ConnectionInvocationAppendArgs, St as EngineHost, T as NodeIterationId, Ti as RunEvent, Tn as TelemetryMetricRecord, Tr as CurrentStateExecutionRequest, Tt as ExecutionContext, U as TriggerNodeSetupState, Un as CostTrackingTelemetryMetricNames, Ur as RunCurrentState, Ut as PersistedTriggerSetupState, V as TriggerNodeConfig, Vn as CostTrackingTelemetryAttributeNames, Vr as PinnedNodeOutputsByPort, Vt as NodeExecutor, W as UpstreamRefPlaceholder, Wn as CostTrackingUsageRecord, Wr as RunEventPublisherDeps, Wt as PollingTriggerHandle, X as WorkflowGraphFactory, Xn as CredentialBinding, Xr as RunStatus, Xt as TriggerNode, Y as WorkflowGraph, Yn as CredentialAuthDefinition, Yr as RunStateResetRequest, Yt as TriggerCleanupHandle, Z as WorkflowNodeConnection, Zn as CredentialBindingKey, Zr as RunStopCondition, Zt as TriggerRuntimeDiagnostics, _ as MutableRunData, _i as instancePerContainerCachingFactory, _n as ExecutionTelemetry, _r as CredentialUnboundError, _t as BinaryStorageReadResult, a as BinaryAttachment, ai as DependencyContainer, an as WorkflowRunnerService, ar as CredentialMaterialSourceKind, at as nodeRef, b as NodeDefinition, bi as singleton, bn as TelemetryArtifactAttachment, br as PollingTriggerLogger, bt as BinaryStorageWriteResult, c as ExecutionMode, ci as Lifecycle, cn as HttpMethod, cr as CredentialRequirement, ct as triggerNodeOutputType, d as Items, di as container, dn as WebhookInvocationMatch, dr as CredentialSessionService, dt as FixedRetryPolicySpec, ei as WebhookRunResult, en as TriggerSetupStateRepository, er as CredentialHealthStatus, et as WorkflowStoragePolicyDecisionArgs, f as JsonArray, fi as delay, fn as WebhookTriggerMatcher, fr as CredentialSetupStatus, ft as NoneRetryPolicySpec, g as JsonValue, gi as instanceCachingFactory, gn as WorkflowActivationPolicy, gr as CredentialTypeRegistry, gt as BinaryStorage, h as JsonPrimitive, hi as injectable, hn as AllWorkflowsActiveWorkflowActivationPolicy, hr as CredentialTypeId, ht as BinaryBody, i as ActivationIdFactory, ii as Container, in as WorkflowRunnerResolver, ir as CredentialJsonRecord, it as branchRef, j as PairedItemRef, ji as TestTriggerNodeConfig, jn as GenAiTelemetryAttributeNames, jr as NodeInputsByPort, jt as NodeActivationReceipt, k as NodeRef, ki as TestSuiteRunStatus, kn as TelemetrySpanScope, kr as NodeExecutionSnapshot, kt as MultiInputNode, l as Item, li as RegistrationOptions, ln as TriggerInstanceId, lr as CredentialSessionFactory, lt as triggerNodeSetupStateType, m as JsonObject, mi as injectAll, mn as WebhookTriggerRoutingDiagnostics, mr as CredentialTypeDefinition, mt as BinaryAttachmentCreateRequest, n as InMemoryLiveWorkflowRepository, ni as WorkflowExecutionPruneRepository, nn as WorkflowNodeInstanceFactory, nr as CredentialInstanceId, nt as WorkflowStoragePolicyResolver, o as BinaryPreviewKind, oi as Disposable, on as WorkflowSnapshotFactory, or as CredentialOAuth2AuthDefinition, ot as runnableNodeInputType, p as JsonNonArray, pi as inject, pn as WebhookTriggerResolution, pr as CredentialType, pt as RetryPolicySpec, q as WorkflowErrorHandler, qn as AnyCredentialType, qr as RunQueueEntry, qt as RunnableNodeExecuteArgs, ri as WorkflowExecutionRepository, rn as WorkflowRepository, rr as CredentialInstanceRecord, rt as WorkflowStoragePolicySpec, s as Edge, si as InjectionToken, sn as WorkflowSnapshotResolver, sr as CredentialOAuth2ScopesFromPublicConfig, st as runnableNodeOutputType, t as RunIntentService, ti as WorkflowExecutionListingRepository, tn as TriggerTestItemsContext, tr as CredentialHealthTester, tt as WorkflowStoragePolicyMode, u as ItemBinary, ui as TypeToken, un as WebhookControlSignal, ur as CredentialSessionFactoryArgs, ut as ExponentialRetryPolicySpec, v as NodeActivationId, vi as predicateAwareClassFactory, vn as ExecutionTelemetryFactory, vr as OAuth2ProviderFromPublicConfig, vt as BinaryStorageStatResult, w as NodeIdRef, wi as EngineExecutionLimitsPolicyConfig, wn as TelemetryChildSpanStart, wr as ConnectionInvocationRecord, wt as ExecutionBinaryService, x as NodeErrorHandler, xi as CoreTokens, xn as TelemetryArtifactReference, xr as PollingTriggerDedupWindow, xt as EngineDeps, y as NodeConfigBase, yi as registry, yn as NodeExecutionTelemetry, yr as NoOpPollingTriggerLogger, yt as BinaryStorageWriteRequest, z as RunnableNodeInputJson, zn as CostTrackingPriceQuote, zr as PersistedWorkflowSnapshotNode, zt as NodeExecutionScheduler } from "./RunIntentService-siBSjaaY.cjs";
2
+ import { a as ItemExprResolver, c as DefaultAsyncSleeper, d as UnavailableBinaryStorage, f as CredentialResolverFactory, i as RunnableOutputBehaviorResolver, m as CostCatalogEntry, n as InMemoryBinaryStorage, o as InProcessRetryRunner, p as CostCatalog, r as RunnableOutputBehavior, s as DefaultExecutionContextFactory, t as InMemoryRunDataFactory, u as DefaultExecutionBinaryService } from "./InMemoryRunDataFactory-Xw7v4-sj.cjs";
3
3
  import { ZodType, input, output, z } from "zod";
4
4
 
5
- //#region src/contracts/emitPorts.d.ts
6
- declare const EMIT_PORTS_BRAND: unique symbol;
7
- type PortsEmission = Readonly<{
8
- readonly [EMIT_PORTS_BRAND]: true;
9
- readonly ports: Readonly<Partial<Record<OutputPortKey, Items | ReadonlyArray<JsonNonArray>>>>;
10
- }>;
11
- declare function emitPorts(ports: Readonly<Partial<Record<OutputPortKey, Items | ReadonlyArray<JsonNonArray>>>>): PortsEmission;
12
- declare function isPortsEmission(value: unknown): value is PortsEmission;
13
- declare function isUnbrandedPortsEmissionShape(value: unknown): value is Readonly<{
14
- ports: unknown;
15
- }>;
16
- //#endregion
17
- //#region src/contracts/itemMeta.d.ts
5
+ //#region src/contracts/assertionTypes.d.ts
6
+
18
7
  /**
19
- * Reads `meta._cm.originIndex` when present (used for fan-in merge-by-origin and Merge routing).
8
+ * One assertion emitted by an assertion-emitting node (a node whose config sets
9
+ * `emitsAssertions: true`). Each emitted item on `main` carries one of these as `item.json`.
10
+ *
11
+ * Pass/fail is derived from `score >= (passThreshold ?? 0.5)` — see {@link deriveAssertionPassed}.
12
+ * The `errored` marker is for cases where the assertion code itself threw (distinct from
13
+ * "the assertion was evaluated and the score was low") and is treated as a hard fail in rollups
14
+ * regardless of `score`.
20
15
  */
21
- declare function getOriginIndexFromItem(item: Item): number | undefined;
16
+ interface AssertionResult {
17
+ readonly name: string;
18
+ /** 0..1 score. Source of truth for pass/fail (compared against `passThreshold`). */
19
+ readonly score: number;
20
+ /** 0..1 threshold for "passed". When omitted, consumers default to 0.5. */
21
+ readonly passThreshold?: number;
22
+ /** True when evaluating the assertion threw — treated as fail regardless of `score`. */
23
+ readonly errored?: true;
24
+ /** What the assertion expected. Free-form JSON; UIs render with a JSON viewer. */
25
+ readonly expected?: JsonValue;
26
+ /** What the workflow actually produced. */
27
+ readonly actual?: JsonValue;
28
+ /** Short human-readable explanation, especially for fails / errors. */
29
+ readonly message?: string;
30
+ /** Bag of supplemental fields (e.g. judge prompt, judge raw response, comparison method). */
31
+ readonly details?: Readonly<Record<string, JsonValue>>;
32
+ }
33
+ /**
34
+ * Default {@link AssertionResult.passThreshold} when authors omit it. Boolean-style assertions
35
+ * (assertEqual / contains / etc.) emit `score: 1` or `score: 0` so this default works for them;
36
+ * AI-judge assertions are expected to set their own threshold.
37
+ */
38
+ declare const DEFAULT_ASSERTION_PASS_THRESHOLD = 0.5;
39
+ /**
40
+ * Derive whether an assertion result is considered "passing" using the score-based contract:
41
+ * `errored` always fails, otherwise `score >= (passThreshold ?? 0.5)`. This is the canonical
42
+ * derivation — UI and rollup code should call it rather than inlining the comparison so future
43
+ * tweaks (e.g. NaN handling) land in one place.
44
+ */
45
+ declare function deriveAssertionPassed(result: {
46
+ readonly score: number;
47
+ readonly passThreshold?: number;
48
+ readonly errored?: true;
49
+ }): boolean;
50
+ /**
51
+ * Provenance for a persisted {@link AssertionResult}: which node produced it and where in the
52
+ * per-item iteration tree it landed. Filled in by the host-side persister, not the node itself.
53
+ */
54
+ interface AssertionResultProvenance {
55
+ readonly nodeId: NodeId;
56
+ /** Per-item iteration id when the emitting node ran inside a per-item loop. */
57
+ readonly iterationId?: string;
58
+ /** Item index (0-based) within the activation that produced this assertion. */
59
+ readonly itemIndex?: number;
60
+ }
22
61
  //#endregion
23
62
  //#region src/contracts/itemExpr.d.ts
24
63
  declare const ITEM_EXPR_BRAND: unique symbol;
@@ -60,47 +99,6 @@ type Expr<T, TItemJson = unknown> = ItemExpr<T, TItemJson>;
60
99
  type Param<T, TItemJson = unknown> = T | Expr<T, TItemJson>;
61
100
  type ParamDeep<T, TItemJson = unknown> = Expr<T, TItemJson> | (T extends readonly (infer U)[] ? ReadonlyArray<ParamDeep<U, TItemJson>> : never) | (T extends object ? { [K in keyof T]: ParamDeep<T[K], TItemJson> } : T);
62
101
  //#endregion
63
- //#region src/contracts/NoRetryPolicy.d.ts
64
- declare class NoRetryPolicy implements NoneRetryPolicySpec {
65
- readonly kind: "none";
66
- }
67
- //#endregion
68
- //#region src/contracts/RetryPolicy.d.ts
69
- declare class RetryPolicy implements FixedRetryPolicySpec {
70
- readonly maxAttempts: number;
71
- readonly delayMs: number;
72
- readonly kind: "fixed";
73
- constructor(maxAttempts: number, delayMs: number);
74
- /** Default for HTTP-style transient failures: 3 tries, 1s between attempts. */
75
- static readonly defaultForHttp: FixedRetryPolicySpec;
76
- /** Default for LLM / agent calls: 3 tries, 2s fixed backoff. */
77
- static readonly defaultForAiAgent: FixedRetryPolicySpec;
78
- }
79
- //#endregion
80
- //#region src/contracts/ExpRetryPolicy.d.ts
81
- declare class ExpRetryPolicy implements ExponentialRetryPolicySpec {
82
- readonly maxAttempts: number;
83
- readonly initialDelayMs: number;
84
- readonly multiplier: number;
85
- readonly maxDelayMs?: number | undefined;
86
- readonly jitter?: boolean | undefined;
87
- readonly kind: "exponential";
88
- constructor(maxAttempts: number, initialDelayMs: number, multiplier: number, maxDelayMs?: number | undefined, jitter?: boolean | undefined);
89
- }
90
- //#endregion
91
- //#region src/contracts/NoOpCostTrackingTelemetry.d.ts
92
- declare class NoOpCostTrackingTelemetry implements CostTrackingTelemetry {
93
- captureUsage(_: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
94
- forScope(_: TelemetryScope): CostTrackingTelemetry;
95
- }
96
- //#endregion
97
- //#region src/contracts/NoOpCostTrackingTelemetryFactory.d.ts
98
- declare class NoOpCostTrackingTelemetryFactory implements CostTrackingTelemetryFactory {
99
- create(_: Readonly<{
100
- telemetry: ExecutionTelemetry;
101
- }>): CostTrackingTelemetry;
102
- }
103
- //#endregion
104
102
  //#region src/contracts/executionPersistenceContracts.d.ts
105
103
  /** Canonical id for persisted execution rows (activation or connection invocation). */
106
104
  type ExecutionInstanceId = string;
@@ -226,6 +224,29 @@ interface WorkflowRunDetailDto {
226
224
  readonly mutableState?: PersistedMutableRunState;
227
225
  readonly slotStates: ReadonlyArray<SlotExecutionStateDto>;
228
226
  readonly executionInstances: ReadonlyArray<ExecutionInstanceDto>;
227
+ readonly iterations?: ReadonlyArray<RunIterationDto>;
228
+ }
229
+ /**
230
+ * Per-item iteration projected from connection invocations and node activations.
231
+ *
232
+ * One iteration = one item processed by an agent within an activation. Multiple invocations
233
+ * (LLM rounds, tool calls) belonging to the same iteration share the iterationId.
234
+ */
235
+ interface RunIterationDto {
236
+ readonly iterationId: string;
237
+ readonly agentNodeId: NodeId;
238
+ readonly activationId: NodeActivationId;
239
+ readonly itemIndex: number;
240
+ readonly itemSummary?: string;
241
+ readonly status: NodeExecutionStatus;
242
+ readonly startedAt?: string;
243
+ readonly finishedAt?: string;
244
+ readonly invocationIds: ReadonlyArray<string>;
245
+ readonly parentInvocationId?: string;
246
+ /** Estimated cost rolled up from telemetry cost metric points, keyed by ISO currency code (e.g. "USD"). Values are minor units (cents-of-cents per the metric's `cost.currency_scale`). */
247
+ readonly estimatedCostMinorByCurrency?: Readonly<Record<string, number>>;
248
+ /** Currency scale (denominator) per currency, when present on the metric points. Joined with `estimatedCostMinorByCurrency` to format human-readable amounts. */
249
+ readonly estimatedCostCurrencyScaleByCurrency?: Readonly<Record<string, number>>;
229
250
  }
230
251
  interface SlotExecutionStateDto {
231
252
  readonly slotNodeId: NodeId;
@@ -254,12 +275,77 @@ interface ExecutionInstanceDto {
254
275
  readonly inputJson?: JsonValue;
255
276
  readonly outputJson?: JsonValue;
256
277
  readonly error?: Readonly<NodeExecutionError>;
278
+ /** Per-item iteration that produced this instance. Set on connectionInvocation rows produced inside per-item runnable loops. */
279
+ readonly iterationId?: string;
280
+ /** Item index (0-based) of the iteration. */
281
+ readonly itemIndex?: number;
282
+ /** Parent invocation id when this instance was emitted by a sub-agent triggered by an outer LLM/tool call. */
283
+ readonly parentInvocationId?: string;
257
284
  }
258
285
  interface WorkflowDetailSelectionState {
259
286
  readonly selectedSlotNodeId: NodeId | null;
260
287
  readonly selectedInstanceId: ExecutionInstanceId | null;
261
288
  }
262
289
  //#endregion
290
+ //#region src/contracts/emitPorts.d.ts
291
+ declare const EMIT_PORTS_BRAND: unique symbol;
292
+ type PortsEmission = Readonly<{
293
+ readonly [EMIT_PORTS_BRAND]: true;
294
+ readonly ports: Readonly<Partial<Record<OutputPortKey, Items | ReadonlyArray<JsonNonArray>>>>;
295
+ }>;
296
+ declare function emitPorts(ports: Readonly<Partial<Record<OutputPortKey, Items | ReadonlyArray<JsonNonArray>>>>): PortsEmission;
297
+ declare function isPortsEmission(value: unknown): value is PortsEmission;
298
+ declare function isUnbrandedPortsEmissionShape(value: unknown): value is Readonly<{
299
+ ports: unknown;
300
+ }>;
301
+ //#endregion
302
+ //#region src/contracts/itemMeta.d.ts
303
+ /**
304
+ * Reads `meta._cm.originIndex` when present (used for fan-in merge-by-origin and Merge routing).
305
+ */
306
+ declare function getOriginIndexFromItem(item: Item): number | undefined;
307
+ //#endregion
308
+ //#region src/contracts/NoRetryPolicy.d.ts
309
+ declare class NoRetryPolicy implements NoneRetryPolicySpec {
310
+ readonly kind: "none";
311
+ }
312
+ //#endregion
313
+ //#region src/contracts/RetryPolicy.d.ts
314
+ declare class RetryPolicy implements FixedRetryPolicySpec {
315
+ readonly maxAttempts: number;
316
+ readonly delayMs: number;
317
+ readonly kind: "fixed";
318
+ constructor(maxAttempts: number, delayMs: number);
319
+ /** Default for HTTP-style transient failures: 3 tries, 1s between attempts. */
320
+ static readonly defaultForHttp: FixedRetryPolicySpec;
321
+ /** Default for LLM / agent calls: 3 tries, 2s fixed backoff. */
322
+ static readonly defaultForAiAgent: FixedRetryPolicySpec;
323
+ }
324
+ //#endregion
325
+ //#region src/contracts/ExpRetryPolicy.d.ts
326
+ declare class ExpRetryPolicy implements ExponentialRetryPolicySpec {
327
+ readonly maxAttempts: number;
328
+ readonly initialDelayMs: number;
329
+ readonly multiplier: number;
330
+ readonly maxDelayMs?: number | undefined;
331
+ readonly jitter?: boolean | undefined;
332
+ readonly kind: "exponential";
333
+ constructor(maxAttempts: number, initialDelayMs: number, multiplier: number, maxDelayMs?: number | undefined, jitter?: boolean | undefined);
334
+ }
335
+ //#endregion
336
+ //#region src/contracts/NoOpCostTrackingTelemetry.d.ts
337
+ declare class NoOpCostTrackingTelemetry implements CostTrackingTelemetry {
338
+ captureUsage(_: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
339
+ forScope(_: TelemetryScope): CostTrackingTelemetry;
340
+ }
341
+ //#endregion
342
+ //#region src/contracts/NoOpCostTrackingTelemetryFactory.d.ts
343
+ declare class NoOpCostTrackingTelemetryFactory implements CostTrackingTelemetryFactory {
344
+ create(_: Readonly<{
345
+ telemetry: ExecutionTelemetry;
346
+ }>): CostTrackingTelemetry;
347
+ }
348
+ //#endregion
263
349
  //#region src/contracts/runFinishedAtFactory.d.ts
264
350
  type RunFinishedAtSource = Pick<PersistedRunState, "status" | "nodeSnapshotsByNodeId" | "finishedAt">;
265
351
  /** Derives workflow end time from persisted run root or node snapshots for run listings. */
@@ -322,7 +408,6 @@ declare class WorkflowBuilder {
322
408
  private readonly options?;
323
409
  private readonly nodes;
324
410
  private readonly edges;
325
- private seq;
326
411
  constructor(meta: {
327
412
  id: WorkflowId;
328
413
  name: string;
@@ -332,8 +417,37 @@ declare class WorkflowBuilder {
332
417
  trigger<TConfig$1 extends AnyTriggerNodeConfig>(config: TConfig$1): ChainCursor<TriggerNodeOutputJson<TConfig$1>>;
333
418
  start<TConfig$1 extends AnyRunnableNodeConfig>(config: TConfig$1): ChainCursor<RunnableNodeOutputJson<TConfig$1>>;
334
419
  build(): WorkflowDefinition;
420
+ private validateNodeIds;
421
+ }
422
+ //#endregion
423
+ //#region src/workflow/dsl/WorkflowDefinitionError.d.ts
424
+ /**
425
+ * Thrown by {@link WorkflowBuilder.build} when the workflow definition is structurally invalid.
426
+ *
427
+ * Common causes:
428
+ * - A node has an empty effective id (label is blank and no explicit `id` was given).
429
+ * - Two or more nodes share the same effective id (label slugs collide or explicit ids clash).
430
+ *
431
+ * Fix: provide an explicit `id:` on the offending node configs.
432
+ */
433
+ declare class WorkflowDefinitionError extends Error {
434
+ constructor(message: string);
335
435
  }
336
436
  //#endregion
437
+ //#region src/workflow/dsl/NodeIdSlugifier.d.ts
438
+ /**
439
+ * Converts a human-readable node label into a stable, URL-safe identifier segment.
440
+ *
441
+ * Rules:
442
+ * - Lowercase the entire string.
443
+ * - Replace every run of characters outside `[a-z0-9]` with a single `-`.
444
+ * - Strip any leading or trailing `-` characters.
445
+ * - Return `""` for blank/empty input.
446
+ */
447
+ declare const NodeIdSlugifier: {
448
+ slugify(label: string): string;
449
+ };
450
+ //#endregion
337
451
  //#region src/workflow/definition/ConnectionInvocationIdFactory.d.ts
338
452
  /**
339
453
  * Unique ids for persisted connection invocation history rows (LLM/tool calls under an owning node).
@@ -368,6 +482,22 @@ declare class ConnectionNodeIdFactory {
368
482
  static normalizeToolName(toolName: string): string;
369
483
  }
370
484
  //#endregion
485
+ //#region src/workflow/definition/NodeIterationIdFactory.d.ts
486
+ /**
487
+ * Unique ids for one per-item iteration of a runnable node's execute loop.
488
+ *
489
+ * Activations are per-batch (one scheduled execution of a node, possibly with N items).
490
+ * Iterations refine that to one identifier per item-index inside the batch loop, so per-item
491
+ * connection invocations and telemetry can be grouped without time-window heuristics.
492
+ */
493
+ declare class NodeIterationIdFactory {
494
+ static create(): string;
495
+ /** Deterministic id for tests when a stable sequence is needed. */
496
+ static createForTest(seed: string, sequence: number): string;
497
+ /** Deterministic id derived from a connection node id (for sub-agent / tool-call scopes). */
498
+ static createForConnection(connectionNodeId: NodeId, sequence: number): string;
499
+ }
500
+ //#endregion
371
501
  //#region src/workflow/definition/WorkflowExecutableNodeClassifier.d.ts
372
502
  /**
373
503
  * Derives which workflow nodes participate in the main execution graph vs connection-only children.
@@ -405,20 +535,6 @@ declare class NodeEventPublisher {
405
535
  publish(kind: "nodeQueued" | "nodeStarted" | "nodeCompleted" | "nodeFailed", snapshot: NodeExecutionSnapshot): Promise<void>;
406
536
  }
407
537
  //#endregion
408
- //#region src/execution/NodeOutputNormalizer.d.ts
409
- declare class NodeOutputNormalizer {
410
- normalizeExecuteResult(args: Readonly<{
411
- baseItem: Item;
412
- raw: unknown;
413
- behavior: RunnableOutputBehavior;
414
- }>): NodeOutputs;
415
- private arrayFanOutToMain;
416
- private emitPortsToOutputs;
417
- private normalizePortPayload;
418
- private isItemLike;
419
- private applyOutput;
420
- }
421
- //#endregion
422
538
  //#region src/contracts/Clock.d.ts
423
539
  /** Port for time; inject `SystemClock` in production and a fake/test clock in tests. */
424
540
  interface Clock {
@@ -429,7 +545,7 @@ declare class SystemClock implements Clock {
429
545
  }
430
546
  //#endregion
431
547
  //#region src/authoring/defineNode.types.d.ts
432
- type MaybePromise$1<TValue> = TValue | Promise<TValue>;
548
+ type MaybePromise$2<TValue> = TValue | Promise<TValue>;
433
549
  type ResolvableCredentialType = AnyCredentialType | CredentialTypeId;
434
550
  type SessionForCredentialType<TCredential extends ResolvableCredentialType> = TCredential extends AnyCredentialType ? Awaited<ReturnType<TCredential["createSession"]>> : unknown;
435
551
  type DefinedNodeCredentialBinding = ResolvableCredentialType | Readonly<{
@@ -495,7 +611,7 @@ interface DefineNodeOptions<TKey$1 extends string, TConfig$1 extends CredentialJ
495
611
  readonly inputSchema?: ZodType<TInputJson>;
496
612
  /** Preserve inbound `item.binary` when `execute` returns plain JSON or item-shaped results without `binary`. */
497
613
  readonly keepBinaries?: boolean;
498
- execute(args: DefineNodeExecuteArgs<TConfig$1, TInputJson>, context: DefinedNodeRunContext<TConfig$1, TBindings>): MaybePromise$1<TOutputJson>;
614
+ execute(args: DefineNodeExecuteArgs<TConfig$1, TInputJson>, context: DefinedNodeRunContext<TConfig$1, TBindings>): MaybePromise$2<TOutputJson>;
499
615
  }
500
616
  /**
501
617
  * Batch-oriented defined node: `run` receives all item JSON once (last item in activation); emits one output per input row.
@@ -508,7 +624,7 @@ interface DefineBatchNodeOptions<TKey$1 extends string, TConfig$1 extends Creden
508
624
  readonly input?: Readonly<Record<keyof TConfig$1 & string, unknown>>;
509
625
  readonly configSchema?: z.ZodType<TConfig$1>;
510
626
  readonly credentials?: TBindings;
511
- run(items: ReadonlyArray<TInputJson>, context: DefinedNodeRunContext<TConfig$1, TBindings>): MaybePromise$1<ReadonlyArray<TOutputJson>>;
627
+ run(items: ReadonlyArray<TInputJson>, context: DefinedNodeRunContext<TConfig$1, TBindings>): MaybePromise$2<ReadonlyArray<TOutputJson>>;
512
628
  }
513
629
  declare function defineNode<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TInputJson, TOutputJson, TBindings extends DefinedNodeCredentialBindings | undefined = undefined>(options: DefineNodeOptions<TKey$1, TConfig$1, TInputJson, TOutputJson, TBindings>): DefinedNode<TKey$1, TConfig$1, TInputJson, TOutputJson, TBindings>;
514
630
  declare function defineBatchNode<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TInputJson, TOutputJson, TBindings extends DefinedNodeCredentialBindings | undefined = undefined>(options: DefineBatchNodeOptions<TKey$1, TConfig$1, TInputJson, TOutputJson, TBindings>): DefinedNode<TKey$1, TConfig$1, TInputJson, TOutputJson, TBindings>;
@@ -521,7 +637,7 @@ declare class DefinedNodeRegistry {
521
637
  }
522
638
  //#endregion
523
639
  //#region src/authoring/defineCredential.types.d.ts
524
- type MaybePromise<TValue> = TValue | Promise<TValue>;
640
+ type MaybePromise$1<TValue> = TValue | Promise<TValue>;
525
641
  type CredentialFieldInput = CredentialFieldSchema["type"] | Readonly<Omit<CredentialFieldSchema, "key">>;
526
642
  type CredentialFieldMap<TConfig$1 extends CredentialJsonRecord> = Readonly<Record<keyof TConfig$1 & string, CredentialFieldInput>>;
527
643
  type ZodObjectSchema<TConfig$1 extends CredentialJsonRecord = CredentialJsonRecord> = z.ZodType<TConfig$1>;
@@ -534,8 +650,8 @@ interface DefineCredentialOptions<TPublicSource extends CredentialFieldMap<any>
534
650
  readonly secret: TSecretSource;
535
651
  readonly supportedSourceKinds?: CredentialTypeDefinition["supportedSourceKinds"];
536
652
  readonly auth?: CredentialTypeDefinition["auth"];
537
- createSession(args: CredentialSessionFactoryArgs<InferCredentialConfig<TPublicSource>, InferCredentialConfig<TSecretSource>>): MaybePromise<TSession>;
538
- test(args: CredentialSessionFactoryArgs<InferCredentialConfig<TPublicSource>, InferCredentialConfig<TSecretSource>>): MaybePromise<CredentialHealth>;
653
+ createSession(args: CredentialSessionFactoryArgs<InferCredentialConfig<TPublicSource>, InferCredentialConfig<TSecretSource>>): MaybePromise$1<TSession>;
654
+ test(args: CredentialSessionFactoryArgs<InferCredentialConfig<TPublicSource>, InferCredentialConfig<TSecretSource>>): MaybePromise$1<CredentialHealth>;
539
655
  }
540
656
  declare function defineCredential<TPublicSource extends CredentialFieldMap<any> | ZodObjectSchema<any>, TSecretSource extends CredentialFieldMap<any> | ZodObjectSchema<any>, TSession>(options: DefineCredentialOptions<TPublicSource, TSecretSource, TSession>): CredentialType<InferCredentialConfig<TPublicSource>, InferCredentialConfig<TSecretSource>, TSession> & {
541
657
  readonly key: string;
@@ -666,6 +782,15 @@ type ToolExecuteArgs<TConfig$1 extends ToolConfig = ToolConfig, TInput = unknown
666
782
  item: Item;
667
783
  itemIndex: number;
668
784
  items: Items;
785
+ /**
786
+ * Optional sub-agent boundary hooks: when present, the live `agent.tool.call` span and the
787
+ * planned tool-call invocationId are forwarded so node-backed runtimes can re-root their child
788
+ * execution scope. Plain function tools may safely ignore these hooks.
789
+ */
790
+ hooks?: Readonly<{
791
+ parentSpan?: TelemetrySpanScope;
792
+ parentInvocationId?: ConnectionInvocationId;
793
+ }>;
669
794
  }>;
670
795
  interface Tool<TConfig$1 extends ToolConfig = ToolConfig, TInputSchema extends ZodSchemaAny = ZodSchemaAny, TOutputSchema extends ZodSchemaAny = ZodSchemaAny> {
671
796
  readonly defaultDescription: string;
@@ -736,25 +861,47 @@ interface ChatModelConfig {
736
861
  readonly presentation?: AgentCanvasPresentation;
737
862
  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
738
863
  }
739
- interface LangChainChatModelLike {
740
- invoke(input: unknown, options?: unknown): Promise<unknown>;
741
- bindTools?(tools: ReadonlyArray<unknown>): LangChainChatModelLike;
742
- withStructuredOutput?(outputSchema: ZodSchemaAny, config?: ChatModelStructuredOutputOptions): LangChainStructuredOutputModelLike;
864
+ /**
865
+ * Provider-neutral chat language model wrapper returned by a {@link ChatModelFactory}.
866
+ *
867
+ * Thin adapter around an AI SDK `LanguageModelV2` (from `@ai-sdk/provider`) plus the call-site
868
+ * defaults Codemation needs at every generate/stream: the provider label, the model name used for
869
+ * pricing / telemetry, and the default invocation options (max output tokens, temperature,
870
+ * provider-specific overrides).
871
+ *
872
+ * The consumer (AIAgentNode / AgentStructuredOutputRunner) passes `languageModel` directly into
873
+ * `generateText({ model, ... })` from the `ai` package.
874
+ */
875
+ interface ChatLanguageModel {
876
+ /** AI SDK `LanguageModelV2` instance (kept `unknown` to avoid leaking the SDK type into `@codemation/core`). */
877
+ readonly languageModel: unknown;
878
+ /** Stable pricing/telemetry key — e.g. `"gpt-4.1-nano"`. */
879
+ readonly modelName: string;
880
+ /** Provider label — e.g. `"openai"`. Used for cost tracking. */
881
+ readonly provider?: string;
882
+ /** Defaults merged into every call. Consumers may override per-invocation. */
883
+ readonly defaultCallOptions?: ChatLanguageModelCallOptions;
743
884
  }
744
- interface LangChainStructuredOutputModelLike {
745
- invoke(input: unknown, options?: unknown): Promise<unknown>;
885
+ interface ChatLanguageModelCallOptions {
886
+ readonly maxOutputTokens?: number;
887
+ readonly temperature?: number;
888
+ readonly providerOptions?: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
746
889
  }
747
- interface ChatModelStructuredOutputOptions {
748
- readonly method?: "jsonSchema" | "functionCalling" | "jsonMode";
890
+ /**
891
+ * Options for a structured-output generate call. Mirrors
892
+ * `generateText({ output: Output.object(...) })` from the `ai` package.
893
+ */
894
+ interface StructuredOutputOptions {
895
+ /** Optional schema name — used by some providers as the JSON schema name attribute. */
896
+ readonly schemaName?: string;
897
+ /** When `true`, the consumer should pass a strict-mode-compatible JSON Schema record. */
749
898
  readonly strict?: boolean;
750
- readonly includeRaw?: boolean;
751
- readonly tools?: ReadonlyArray<unknown>;
752
899
  }
753
900
  interface ChatModelFactory<TConfig$1 extends ChatModelConfig = ChatModelConfig> {
754
901
  create(args: Readonly<{
755
902
  config: TConfig$1;
756
903
  ctx: NodeExecutionContext<any>;
757
- }>): Promise<LangChainChatModelLike> | LangChainChatModelLike;
904
+ }>): Promise<ChatLanguageModel> | ChatLanguageModel;
758
905
  }
759
906
  type NodeBackedToolInputMapperArgs<TNodeConfig extends RunnableNodeConfig<any, any>, TToolInput = unknown> = Readonly<{
760
907
  input: TToolInput;
@@ -798,6 +945,219 @@ type AgentAttachmentRole = "languageModel" | "tool" | "nestedAgent";
798
945
  */
799
946
  declare function callableTool<TInputSchema extends ZodSchemaAny, TOutputSchema extends ZodSchemaAny>(options: CallableToolConfigOptions<TInputSchema, TOutputSchema>): CallableToolConfig<TInputSchema, TOutputSchema>;
800
947
  //#endregion
948
+ //#region src/authoring/defineCollection.types.d.ts
949
+ type CollectionFieldType = "text" | "int" | "bigint" | "double" | "bool" | "timestamptz" | "jsonb" | "uuid";
950
+ interface CollectionColumnBuilder {
951
+ notNull(): CollectionColumnBuilder;
952
+ default(value: unknown): CollectionColumnBuilder;
953
+ readonly _type: CollectionFieldType;
954
+ readonly _nullable: boolean;
955
+ readonly _default?: unknown;
956
+ }
957
+ declare const c: {
958
+ readonly text: () => CollectionColumnBuilder;
959
+ readonly int: () => CollectionColumnBuilder;
960
+ readonly bigint: () => CollectionColumnBuilder;
961
+ readonly double: () => CollectionColumnBuilder;
962
+ readonly bool: () => CollectionColumnBuilder;
963
+ readonly timestamptz: () => CollectionColumnBuilder;
964
+ readonly jsonb: () => CollectionColumnBuilder;
965
+ readonly uuid: () => CollectionColumnBuilder;
966
+ };
967
+ interface CollectionFieldDefinition {
968
+ readonly type: CollectionFieldType;
969
+ readonly nullable: boolean;
970
+ readonly default?: unknown;
971
+ }
972
+ interface CollectionIndexDefinition {
973
+ readonly on: ReadonlyArray<string>;
974
+ readonly unique?: boolean;
975
+ }
976
+ interface CollectionDefinition {
977
+ readonly name: string;
978
+ readonly fields: Readonly<Record<string, CollectionFieldDefinition>>;
979
+ readonly indexes: ReadonlyArray<CollectionIndexDefinition>;
980
+ }
981
+ interface DefinedCollection<TDefinition extends CollectionDefinition = CollectionDefinition> {
982
+ readonly kind: "defined-collection";
983
+ readonly definition: TDefinition;
984
+ register(context: {
985
+ registerCollection(d: CollectionDefinition): void;
986
+ }): void;
987
+ }
988
+ interface DefineCollectionOptions {
989
+ readonly name: string;
990
+ readonly fields: Record<string, CollectionColumnBuilder>;
991
+ readonly indexes?: ReadonlyArray<CollectionIndexDefinition>;
992
+ }
993
+ declare function defineCollection<TName extends string>(options: DefineCollectionOptions & {
994
+ name: TName;
995
+ }): DefinedCollection<CollectionDefinition & {
996
+ name: TName;
997
+ }>;
998
+ //#endregion
999
+ //#region src/authoring/DefinedCollectionRegistry.d.ts
1000
+ declare class DefinedCollectionRegistry {
1001
+ private static readonly definitions;
1002
+ static register(definition: CollectionDefinition): void;
1003
+ static resolve(name: string): CollectionDefinition | undefined;
1004
+ static list(): ReadonlyArray<CollectionDefinition>;
1005
+ }
1006
+ //#endregion
1007
+ //#region src/authoring/definePollingTrigger.types.d.ts
1008
+ type MaybePromise<TValue> = TValue | Promise<TValue>;
1009
+ /**
1010
+ * Context passed into the `poll` callback on each tick.
1011
+ */
1012
+ interface DefinePollingTriggerPollContext<TConfig$1 extends CredentialJsonRecord, TState extends JsonValue | undefined, TBindings extends DefinedNodeCredentialBindings | undefined> {
1013
+ readonly config: TConfig$1;
1014
+ readonly state: TState;
1015
+ readonly credentials: DefinedNodeCredentialAccessors<TBindings>;
1016
+ }
1017
+ /**
1018
+ * What `poll` must return each tick.
1019
+ */
1020
+ interface DefinePollingTriggerPollResult<TItemJson, TState extends JsonValue | undefined> {
1021
+ /**
1022
+ * New items to emit. Each item may carry an optional `dedupKey`; duplicate keys are
1023
+ * filtered out against a rolling dedup window (managed internally by the runtime).
1024
+ * Items without a `dedupKey` are always emitted.
1025
+ */
1026
+ readonly items: ReadonlyArray<{
1027
+ json: TItemJson;
1028
+ dedupKey?: string;
1029
+ }>;
1030
+ /** Persisted as the trigger's setup state for the next tick. */
1031
+ readonly nextState: TState;
1032
+ }
1033
+ /**
1034
+ * Context passed into the `execute` callback for post-emit enrichment (e.g. fetching
1035
+ * attachment bytes). Mirrors `NodeExecutionContext` so plugin authors use familiar patterns.
1036
+ */
1037
+ type DefinePollingTriggerExecuteContext<TConfig$1 extends TriggerNodeConfig<any, any>> = NodeExecutionContext<TConfig$1>;
1038
+ /**
1039
+ * Context passed into the `testItems` callback.
1040
+ */
1041
+ type DefinePollingTriggerTestItemsContext<TConfig$1 extends TriggerNodeConfig<any, any>> = TriggerTestItemsContext<TConfig$1>;
1042
+ /**
1043
+ * Options accepted by `definePollingTrigger`.
1044
+ */
1045
+ interface DefinePollingTriggerOptions<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TItemJson, TState extends JsonValue | undefined, TBindings extends DefinedNodeCredentialBindings | undefined = undefined> {
1046
+ /**
1047
+ * Unique node-token-id-style key, e.g. `"msgraph-mail.on-new-mail"`.
1048
+ * Used as the persisted runtime type name — must be stable across deployments.
1049
+ */
1050
+ readonly key: TKey$1;
1051
+ readonly title: string;
1052
+ readonly description?: string;
1053
+ /** Canvas icon (same contract as `NodeConfigBase.icon`). */
1054
+ readonly icon?: string;
1055
+ /**
1056
+ * Zod schema for the trigger's user-facing configuration.
1057
+ * When provided, the returned `create()` method is typed against the inferred config type.
1058
+ */
1059
+ readonly configSchema?: ZodType<TConfig$1>;
1060
+ /** Credential bindings keyed by slot (same format as `defineNode`). */
1061
+ readonly credentials?: TBindings;
1062
+ /**
1063
+ * Called once when the trigger arms (or re-arms after a server restart) to provide the
1064
+ * initial value for `state` when no persisted state exists.
1065
+ */
1066
+ initialState?(): TState;
1067
+ /**
1068
+ * Polling interval in milliseconds. The runtime enforces a minimum of 25 ms.
1069
+ * @default 60_000
1070
+ */
1071
+ readonly pollIntervalMs?: number;
1072
+ /**
1073
+ * The per-tick poll logic. Called by the runtime each interval.
1074
+ * Must return new items plus the next persisted state.
1075
+ */
1076
+ poll(pollCtx: DefinePollingTriggerPollContext<TConfig$1, TState, TBindings>): MaybePromise<DefinePollingTriggerPollResult<TItemJson, TState>>;
1077
+ /**
1078
+ * Optional post-emit enrichment step (runs in the normal node-execute phase after the
1079
+ * trigger fires and the workflow run starts). Use for expensive per-item work such as
1080
+ * fetching attachment bytes via `ctx.binary.attach`. When omitted, the trigger passes
1081
+ * items through unchanged.
1082
+ */
1083
+ execute?(items: Items<TItemJson>, ctx: NodeExecutionContext<DefinedPollingTriggerConfig<TConfig$1, TItemJson>>): MaybePromise<NodeOutputs>;
1084
+ /**
1085
+ * Optional implementation for the workflow UI's "Test" button. Should return a small
1086
+ * sample of current items without consulting or mutating polling state.
1087
+ */
1088
+ testItems?(ctx: TriggerTestItemsContext<DefinedPollingTriggerConfig<TConfig$1, TItemJson>>): MaybePromise<Items<TItemJson>>;
1089
+ }
1090
+ /**
1091
+ * The object returned by `definePollingTrigger`. Register it via
1092
+ * `definePlugin({ nodes: [myTrigger] })` or call `.register(ctx)` directly.
1093
+ *
1094
+ * `poll` is also directly callable for unit-testing — no runtime needed.
1095
+ */
1096
+ interface DefinedPollingTrigger<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TItemJson, TState extends JsonValue | undefined, TBindings extends DefinedNodeCredentialBindings | undefined = undefined> {
1097
+ readonly kind: "defined-polling-trigger";
1098
+ readonly key: TKey$1;
1099
+ readonly title: string;
1100
+ readonly description?: string;
1101
+ /**
1102
+ * Create the trigger config for use in workflow definitions.
1103
+ * @param cfg - User-facing trigger configuration.
1104
+ * @param name - Display name (defaults to `title`).
1105
+ * @param id - Optional stable node id.
1106
+ */
1107
+ create(cfg: TConfig$1, name?: string, id?: string): DefinedPollingTriggerConfig<TConfig$1, TItemJson>;
1108
+ /**
1109
+ * Test seam: call `poll` directly without starting the runtime.
1110
+ * Returns `{ items, nextState }` just like the real runtime receives.
1111
+ */
1112
+ poll(pollCtx: Omit<DefinePollingTriggerPollContext<TConfig$1, TState, TBindings>, "credentials"> & {
1113
+ credentials?: DefinedNodeCredentialAccessors<TBindings>;
1114
+ }): MaybePromise<DefinePollingTriggerPollResult<TItemJson, TState>>;
1115
+ /** Registers the synthesised runtime class with the plugin container. */
1116
+ register(context: {
1117
+ registerNode<TValue>(token: TypeToken<TValue>, implementation?: TypeToken<TValue>): void;
1118
+ }): void;
1119
+ }
1120
+ /**
1121
+ * TriggerNodeConfig produced by `DefinedPollingTrigger.create(...)`.
1122
+ * Holds user configuration and credential requirements for the engine.
1123
+ * The setup state type is opaque `JsonValue | undefined` — the runtime
1124
+ * uses an internal wrapped shape that plugin authors never see.
1125
+ */
1126
+ declare class DefinedPollingTriggerConfig<TConfig$1 extends CredentialJsonRecord, TItemJson> implements TriggerNodeConfig<TItemJson, JsonValue | undefined> {
1127
+ readonly name: string;
1128
+ readonly cfg: TConfig$1;
1129
+ private readonly credentialRequirements;
1130
+ readonly id?: string | undefined;
1131
+ readonly kind: "trigger";
1132
+ readonly type: TypeToken<unknown>;
1133
+ readonly icon: string | undefined;
1134
+ constructor(name: string, cfg: TConfig$1, typeToken: TypeToken<unknown>, icon: string | undefined, credentialRequirements: ReadonlyArray<CredentialRequirement>, id?: string | undefined);
1135
+ getCredentialRequirements(): ReadonlyArray<CredentialRequirement>;
1136
+ }
1137
+ /**
1138
+ * Declarative helper for authoring polling triggers.
1139
+ *
1140
+ * ```ts
1141
+ * export const onNewMail = definePollingTrigger({
1142
+ * key: "my-plugin.on-new-mail",
1143
+ * title: "On new mail",
1144
+ * configSchema: z.object({ folder: z.string() }),
1145
+ * credentials: { auth: myOAuthCredentialType },
1146
+ * initialState: () => ({ lastSeenId: undefined }),
1147
+ * pollIntervalMs: 60_000,
1148
+ * async poll({ config, state, credentials }) {
1149
+ * const session = await credentials.auth();
1150
+ * const messages = await fetchMessages(session, config.folder, state.lastSeenId);
1151
+ * return {
1152
+ * items: messages.map(m => ({ json: m, dedupKey: m.id })),
1153
+ * nextState: { lastSeenId: messages[0]?.id ?? state.lastSeenId },
1154
+ * };
1155
+ * },
1156
+ * });
1157
+ * ```
1158
+ */
1159
+ declare function definePollingTrigger<TKey$1 extends string, TConfig$1 extends CredentialJsonRecord, TItemJson, TState extends JsonValue | undefined, TBindings extends DefinedNodeCredentialBindings | undefined = undefined>(options: DefinePollingTriggerOptions<TKey$1, TConfig$1, TItemJson, TState, TBindings>): DefinedPollingTrigger<TKey$1, TConfig$1, TItemJson, TState, TBindings>;
1160
+ //#endregion
801
1161
  //#region src/ai/AgentConnectionNodeCollector.d.ts
802
1162
  type AgentConnectionNodeRole = "languageModel" | "tool" | "nestedAgent";
803
1163
  type AgentConnectionCredentialSource = Readonly<{
@@ -818,6 +1178,22 @@ type AgentConnectionNodeCollectorApi = Readonly<{
818
1178
  }>;
819
1179
  declare const AgentConnectionNodeCollector: AgentConnectionNodeCollectorApi;
820
1180
  //#endregion
1181
+ //#region src/events/ConnectionInvocationEventPublisher.d.ts
1182
+ /**
1183
+ * Publishes per-invocation lifecycle records onto the run {@link RunEventBus}.
1184
+ *
1185
+ * Surgical, per-invocation events let the UI update the right-side inspector
1186
+ * timeline as each LLM round / tool call transitions through `running` → `completed`
1187
+ * (or `failed`) without depending on a coarse `runSaved` poll.
1188
+ */
1189
+ declare class ConnectionInvocationEventPublisher {
1190
+ private readonly eventBus;
1191
+ private readonly parent;
1192
+ constructor(eventBus: RunEventBus | undefined, parent: ParentExecutionRef | undefined);
1193
+ publish(record: ConnectionInvocationRecord): Promise<void>;
1194
+ private kindFor;
1195
+ }
1196
+ //#endregion
821
1197
  //#region src/events/InMemoryRunEventBusRegistry.d.ts
822
1198
  declare class InMemoryRunEventBus implements RunEventBus {
823
1199
  private readonly globalListeners;
@@ -921,5 +1297,82 @@ declare class ItemsInputNormalizer {
921
1297
  private isItem;
922
1298
  }
923
1299
  //#endregion
924
- export { ActivationIdFactory, AgentAttachmentRole, AgentCanvasPresentation, AgentConfigInspector, type AgentConnectionCredentialSource, AgentConnectionNodeCollector, type AgentConnectionNodeDescriptor, type AgentConnectionNodeRole, AgentGuardrailConfig, AgentGuardrailDefaults, AgentMessageBuildArgs, AgentMessageConfig, AgentMessageConfigNormalizer, AgentMessageDto, AgentMessageLine, AgentMessageRole, AgentMessageTemplate, AgentMessageTemplateContent, AgentModelInvocationOptions, AgentNodeConfig, AgentTool, AgentToolCall, AgentToolCallPlanner, AgentToolDefinition, AgentToolExecuteArgs, AgentToolFactory, AgentToolToken, AgentTurnLimitBehavior, AllWorkflowsActiveWorkflowActivationPolicy, AnyCredentialType, AnyRunnableNodeConfig, AnyTriggerNodeConfig, BatchId, BinaryAttachment, BinaryAttachmentCreateRequest, BinaryBody, BinaryPreviewKind, BinaryStorage, BinaryStorageReadResult, BinaryStorageStatResult, BinaryStorageWriteRequest, BinaryStorageWriteResult, BooleanWhenOverloads, BranchMoreArgs, BranchOutputGuard, BranchStepsArg, CallableToolConfig, type CallableToolConfigOptions, type CallableToolExecuteHandler, CallableToolFactory, CallableToolKindToken, ChainCursor, ChatModelConfig, ChatModelFactory, ChatModelStructuredOutputOptions, type Clock, CodemationTelemetryAttributeNames, CodemationTelemetryMetricNames, ConnectionInvocationAppendArgs, ConnectionInvocationId, ConnectionInvocationIdFactory, ConnectionInvocationKind, ConnectionInvocationRecord, ConnectionNodeIdFactory, Container, CoreTokens, CostCatalog, CostCatalogEntry, CostTrackingComponent, CostTrackingPriceQuote, CostTrackingTelemetry, CostTrackingTelemetryAttributeNames, CostTrackingTelemetryFactory, CostTrackingTelemetryMetricNames, CostTrackingUsageRecord, CredentialAdvancedSectionPresentation, CredentialAuthDefinition, CredentialBinding, CredentialBindingKey, CredentialFieldSchema, CredentialHealth, CredentialHealthStatus, CredentialHealthTester, CredentialInstanceId, CredentialInstanceRecord, CredentialJsonRecord, CredentialMaterialSourceKind, CredentialOAuth2AuthDefinition, CredentialOAuth2ScopesFromPublicConfig, CredentialRequirement, CredentialResolverFactory, CredentialSessionFactory, CredentialSessionFactoryArgs, CredentialSessionService, CredentialSetupStatus, CredentialType, CredentialTypeDefinition, CredentialTypeId, CredentialTypeRegistry, CredentialUnboundError, CurrentStateExecutionRequest, DefaultAsyncSleeper, DefaultExecutionBinaryService, DefaultExecutionContextFactory, DefaultWorkflowGraphFactory, DefineBatchNodeOptions, DefineCredentialOptions, DefineNodeExecuteArgs, DefineNodeOptions, DefinedNode, DefinedNodeConfigInput, DefinedNodeCredentialAccessors, DefinedNodeCredentialBinding, DefinedNodeCredentialBindings, DefinedNodeRegistry, DefinedNodeRunContext, DependencyContainer, Disposable, Edge, EngineDeps, EngineExecutionLimitsPolicy, type EngineExecutionLimitsPolicyConfig, EngineHost, EngineRunCounters, EventPublishingWorkflowExecutionRepository, ExecutableTriggerNode, ExecutionBinaryService, ExecutionContext, ExecutionContextFactory, ExecutionFrontierPlan, ExecutionInstanceDto, ExecutionInstanceId, ExecutionMode, ExecutionPayloadPolicyFields, ExecutionTelemetry, ExecutionTelemetryFactory, ExpRetryPolicy, ExponentialRetryPolicySpec, Expr, FixedRetryPolicySpec, GenAiTelemetryAttributeNames, HttpMethod, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryRunEventBus, InProcessRetryRunner, InjectableRuntimeDecoratorComposer, InjectionToken, InputPortKey, Item, ItemBinary, ItemExpr, ItemExprArgs, ItemExprCallback, ItemExprContext, ItemExprResolvedContext, ItemExprResolver, ItemNode, Items, ItemsInputNormalizer, JsonArray, JsonNonArray, JsonObject, JsonPrimitive, JsonValue, LangChainChatModelLike, LangChainStructuredOutputModelLike, Lifecycle, LiveWorkflowRepository, MultiInputNode, MutableRunData, NoOpCostTrackingTelemetry, NoOpCostTrackingTelemetryFactory, NoOpExecutionTelemetry, NoOpExecutionTelemetryFactory, NoOpNodeExecutionTelemetry, NoOpTelemetryArtifactReference, NoOpTelemetrySpanScope, NoRetryPolicy, NodeActivationContinuation, NodeActivationId, NodeActivationReceipt, NodeActivationRequest, NodeActivationRequestBase, NodeActivationScheduler, NodeBackedToolConfig, NodeBackedToolConfigOptions, NodeBackedToolInputMapper, NodeBackedToolInputMapperArgs, NodeBackedToolOutputMapper, NodeBackedToolOutputMapperArgs, NodeBinaryAttachmentService, NodeConfigBase, NodeConnectionName, NodeDefinition, NodeErrorHandler, NodeErrorHandlerArgs, NodeErrorHandlerSpec, NodeEventPublisher, NodeExecutionContext, NodeExecutionError, NodeExecutionRequest, NodeExecutionRequestHandler, NodeExecutionScheduler, NodeExecutionSnapshot, NodeExecutionStatePublisher, NodeExecutionStatus, NodeExecutionTelemetry, NodeExecutor, NodeId, NodeIdRef, NodeInputsByPort, NodeKind, NodeOffloadPolicy, NodeOutputNormalizer, NodeOutputs, NodeRef, NodeResolver, NodeSchedulerDecision, NoneRetryPolicySpec, OAuth2ProviderFromPublicConfig, OutputPortKey, PairedItemRef, Param, ParamDeep, ParentExecutionRef, PayloadStorageKind, PendingNodeExecution, PersistedExecutionInstanceKind, PersistedExecutionInstanceRecord, PersistedMutableNodeState, PersistedMutableRunState, PersistedRunControlState, PersistedRunPolicySnapshot, PersistedRunSchedulingState, PersistedRunSlotProjectionRecord, PersistedRunState, PersistedRunWorkItemKind, PersistedRunWorkItemRecord, type PersistedRuntimeTypeDecoratorOptions, type PersistedRuntimeTypeKind, type PersistedRuntimeTypeMetadata, PersistedRuntimeTypeMetadataStore, PersistedRuntimeTypeNameResolver, PersistedTokenId, PersistedTriggerSetupState, PersistedWorkflowSnapshot, PersistedWorkflowSnapshotNode, PersistedWorkflowTokenRegistryLike, PinnedNodeOutputsByPort, PortsEmission, PreparedNodeActivationDispatch, RegistrationOptions, RetryPolicy, RetryPolicySpec, RunCompletionNotifier, RunCurrentState, RunDataFactory, RunDataSnapshot, RunEvent, RunEventBus, RunEventPublisherDeps, RunEventSubscription, RunExecutionOptions, RunFinishedAtFactory, RunId, RunIdFactory, RunIntentService, RunPruneCandidate, RunQueueEntry, RunResult, RunRevision, RunSlotProjectionState, RunStateResetRequest, RunStatus, RunStopCondition, RunSummary, RunnableNode, RunnableNodeConfig, RunnableNodeExecuteArgs, RunnableNodeInputJson, RunnableNodeOutputJson, RunnableOutputBehaviorResolver, SlotExecutionStateDto, StackTraceCallSitePathResolver, StepSequenceOutput, SystemClock, TelemetryArtifactAttachment, TelemetryArtifactReference, TelemetryAttributePrimitive, TelemetryAttributes, TelemetryChildSpanStart, TelemetryMetricRecord, TelemetryScope, TelemetrySpanEnd, TelemetrySpanEventRecord, TelemetrySpanScope, TestableTriggerNode, Tool, ToolConfig, ToolExecuteArgs, TriggerCleanupHandle, TriggerInstanceId, TriggerNode, TriggerNodeConfig, TriggerNodeOutputJson, TriggerNodeSetupState, TriggerRuntimeDiagnostics, TriggerSetupContext, TriggerSetupStateFor, TriggerSetupStateRepository, TriggerTestItemsContext, TypeToken, UnavailableBinaryStorage, UpstreamRefPlaceholder, ValidStepSequence, WebhookControlSignal, WebhookInvocationMatch, WebhookRunResult, WebhookTriggerMatcher, WebhookTriggerResolution, WebhookTriggerRoutingDiagnostics, WhenBuilder, WorkItemId, WorkItemStatus, WorkflowActivationPolicy, WorkflowBuilder, WorkflowDefinition, WorkflowDetailSelectionState, WorkflowErrorContext, WorkflowErrorHandler, WorkflowErrorHandlerSpec, WorkflowExecutableNodeClassifier, WorkflowExecutableNodeClassifierFactory, WorkflowExecutionListingRepository, WorkflowExecutionPruneRepository, WorkflowExecutionRepository, WorkflowGraph, WorkflowGraphFactory, WorkflowId, WorkflowNodeConnection, WorkflowNodeInstanceFactory, WorkflowPolicyRuntimeDefaults, WorkflowPrunePolicySpec, WorkflowRepository, WorkflowRunDetailDto, WorkflowRunnerResolver, WorkflowRunnerService, WorkflowSnapshotFactory, WorkflowSnapshotResolver, WorkflowStoragePolicyDecisionArgs, WorkflowStoragePolicyMode, WorkflowStoragePolicyResolver, WorkflowStoragePolicySpec, ZodSchemaAny, branchRef, callableTool, chatModel, container, defineBatchNode, defineCredential, defineNode, delay, emitPorts, getOriginIndexFromItem, getPersistedRuntimeTypeMetadata, inject, injectAll, injectable, instanceCachingFactory, instancePerContainerCachingFactory, isItemExpr, isPortsEmission, isUnbrandedPortsEmissionShape, itemExpr, node, nodeRef, predicateAwareClassFactory, registry, resolveItemExprsForExecution, resolveItemExprsInUnknown, runnableNodeInputType, runnableNodeOutputType, singleton, tool, triggerNodeOutputType, triggerNodeSetupStateType };
1300
+ //#region src/execution/ChildExecutionScopeFactory.d.ts
1301
+ /**
1302
+ * Builds a re-rooted child execution context for sub-agent (and other deeply-nested) invocations.
1303
+ *
1304
+ * At the orchestrator's `agent.tool.call` boundary the inner runtime needs a ctx whose:
1305
+ * - `nodeId` is the tool's connection node id (so inner LLM/tool connection ids derive correctly),
1306
+ * - `activationId` is fresh (so its connection-invocation rows are uniquely identifiable),
1307
+ * - `telemetry` parents children under the tool-call span (not the orchestrator's node span),
1308
+ * - `binary` is scoped to the new (nodeId, activationId),
1309
+ * - `parentInvocationId` points back to the tool-call invocation for downstream lineage.
1310
+ *
1311
+ * Registered via factory in {@link EngineRuntimeRegistrar} so constructors stay free of parameter
1312
+ * decorators (Next/SWC and coverage tooling cannot parse them on in-repo sources).
1313
+ */
1314
+ declare class ChildExecutionScopeFactory {
1315
+ private readonly activationIdFactory;
1316
+ constructor(activationIdFactory: ActivationIdFactory);
1317
+ forSubAgent<TConfig$1 extends RunnableNodeConfig<any, any>>(args: Readonly<{
1318
+ parentCtx: NodeExecutionContext<TConfig$1>;
1319
+ childNodeId: NodeId;
1320
+ childConfig: TConfig$1;
1321
+ parentInvocationId: ConnectionInvocationId;
1322
+ parentSpan: TelemetrySpanScope;
1323
+ }>): NodeExecutionContext<TConfig$1>;
1324
+ }
1325
+ //#endregion
1326
+ //#region src/execution/NodeOutputNormalizer.d.ts
1327
+ declare class NodeOutputNormalizer {
1328
+ normalizeExecuteResult(args: Readonly<{
1329
+ baseItem: Item;
1330
+ raw: unknown;
1331
+ behavior: RunnableOutputBehavior;
1332
+ }>): NodeOutputs;
1333
+ private arrayFanOutToMain;
1334
+ private emitPortsToOutputs;
1335
+ private normalizePortPayload;
1336
+ private isItemLike;
1337
+ private applyOutput;
1338
+ }
1339
+ //#endregion
1340
+ //#region src/triggers/polling/PollingTriggerRuntime.d.ts
1341
+ interface PollingRunCycleArgs<TState> {
1342
+ previousState: TState | undefined;
1343
+ signal: AbortSignal;
1344
+ }
1345
+ interface PollingRunCycleResult<TState, TItem> {
1346
+ items: Items<TItem>;
1347
+ nextState: TState;
1348
+ }
1349
+ interface PollingTriggerStartArgs<TState, TItem> {
1350
+ trigger: TriggerInstanceId;
1351
+ intervalMs: number;
1352
+ seedState?: TState;
1353
+ runCycle: (cycleCtx: PollingRunCycleArgs<TState>) => Promise<PollingRunCycleResult<TState, TItem>>;
1354
+ emit: (items: Items) => Promise<void>;
1355
+ }
1356
+ /**
1357
+ * Generic polling-trigger runtime. Owns the set-interval loop, overlap guard, and persistence.
1358
+ * Constructed by {@link import("../../runtime/EngineFactory").EngineFactory} and exposed to plugin
1359
+ * authors via {@link import("../../contracts/runtimeTypes").TriggerSetupContext}.polling.
1360
+ */
1361
+ declare class PollingTriggerRuntime {
1362
+ private readonly triggerSetupStateRepository;
1363
+ private readonly logger;
1364
+ private readonly activeTriggers;
1365
+ private readonly intervalsByTrigger;
1366
+ private readonly busyTriggers;
1367
+ constructor(triggerSetupStateRepository: TriggerSetupStateRepository, logger: PollingTriggerLogger);
1368
+ start<TState, TItem>(args: PollingTriggerStartArgs<TState, TItem>): Promise<TState | undefined>;
1369
+ stop(trigger: TriggerInstanceId): Promise<void>;
1370
+ private ensureLoop;
1371
+ private runCycle;
1372
+ private toKey;
1373
+ private describe;
1374
+ private logError;
1375
+ }
1376
+ //#endregion
1377
+ export { ActivationIdFactory, AgentAttachmentRole, AgentCanvasPresentation, AgentConfigInspector, type AgentConnectionCredentialSource, AgentConnectionNodeCollector, type AgentConnectionNodeDescriptor, type AgentConnectionNodeRole, AgentGuardrailConfig, AgentGuardrailDefaults, AgentMessageBuildArgs, AgentMessageConfig, AgentMessageConfigNormalizer, AgentMessageDto, AgentMessageLine, AgentMessageRole, AgentMessageTemplate, AgentMessageTemplateContent, AgentModelInvocationOptions, AgentNodeConfig, AgentTool, AgentToolCall, AgentToolCallPlanner, AgentToolDefinition, AgentToolExecuteArgs, AgentToolFactory, AgentToolToken, AgentTurnLimitBehavior, AllWorkflowsActiveWorkflowActivationPolicy, AnyCredentialType, AnyRunnableNodeConfig, AnyTriggerNodeConfig, AssertionResult, AssertionResultProvenance, BatchId, BinaryAttachment, BinaryAttachmentCreateRequest, BinaryBody, BinaryPreviewKind, BinaryStorage, BinaryStorageReadResult, BinaryStorageStatResult, BinaryStorageWriteRequest, BinaryStorageWriteResult, BooleanWhenOverloads, BranchMoreArgs, BranchOutputGuard, BranchStepsArg, CallableToolConfig, type CallableToolConfigOptions, type CallableToolExecuteHandler, CallableToolFactory, CallableToolKindToken, ChainCursor, ChatLanguageModel, ChatLanguageModelCallOptions, ChatModelConfig, ChatModelFactory, ChildExecutionScopeFactory, type Clock, CodemationTelemetryAttributeNames, CodemationTelemetryMetricNames, CollectionColumnBuilder, CollectionDefinition, CollectionFieldDefinition, CollectionIndexDefinition, CollectionStore, CollectionsContext, ConnectionInvocationAppendArgs, ConnectionInvocationEventPublisher, ConnectionInvocationId, ConnectionInvocationIdFactory, ConnectionInvocationKind, ConnectionInvocationRecord, ConnectionNodeIdFactory, Container, CoreTokens, CostCatalog, CostCatalogEntry, CostTrackingComponent, CostTrackingPriceQuote, CostTrackingTelemetry, CostTrackingTelemetryAttributeNames, CostTrackingTelemetryFactory, CostTrackingTelemetryMetricNames, CostTrackingUsageRecord, CredentialAdvancedSectionPresentation, CredentialAuthDefinition, CredentialBinding, CredentialBindingKey, CredentialFieldSchema, CredentialHealth, CredentialHealthStatus, CredentialHealthTester, CredentialInstanceId, CredentialInstanceRecord, CredentialJsonRecord, CredentialMaterialSourceKind, CredentialOAuth2AuthDefinition, CredentialOAuth2ScopesFromPublicConfig, CredentialRequirement, CredentialResolverFactory, CredentialSessionFactory, CredentialSessionFactoryArgs, CredentialSessionService, CredentialSetupStatus, CredentialType, CredentialTypeDefinition, CredentialTypeId, CredentialTypeRegistry, CredentialUnboundError, CurrentStateExecutionRequest, DEFAULT_ASSERTION_PASS_THRESHOLD, DefaultAsyncSleeper, DefaultExecutionBinaryService, DefaultExecutionContextFactory, DefaultWorkflowGraphFactory, DefineBatchNodeOptions, DefineCollectionOptions, DefineCredentialOptions, DefineNodeExecuteArgs, DefineNodeOptions, DefinePollingTriggerExecuteContext, DefinePollingTriggerOptions, DefinePollingTriggerPollContext, DefinePollingTriggerPollResult, DefinePollingTriggerTestItemsContext, DefinedCollection, DefinedCollectionRegistry, DefinedNode, DefinedNodeConfigInput, DefinedNodeCredentialAccessors, DefinedNodeCredentialBinding, DefinedNodeCredentialBindings, DefinedNodeRegistry, DefinedNodeRunContext, DefinedPollingTrigger, DefinedPollingTriggerConfig, DependencyContainer, Disposable, Edge, EngineDeps, EngineExecutionLimitsPolicy, type EngineExecutionLimitsPolicyConfig, EngineHost, EngineRunCounters, EventPublishingWorkflowExecutionRepository, ExecutableTriggerNode, ExecutionBinaryService, ExecutionContext, ExecutionContextFactory, ExecutionFrontierPlan, ExecutionInstanceDto, ExecutionInstanceId, ExecutionMode, ExecutionPayloadPolicyFields, ExecutionTelemetry, ExecutionTelemetryFactory, ExpRetryPolicy, ExponentialRetryPolicySpec, Expr, FixedRetryPolicySpec, GenAiTelemetryAttributeNames, HttpMethod, InMemoryBinaryStorage, InMemoryLiveWorkflowRepository, InMemoryRunDataFactory, InMemoryRunEventBus, InProcessRetryRunner, InjectableRuntimeDecoratorComposer, InjectionToken, InputPortKey, Item, ItemBinary, ItemExpr, ItemExprArgs, ItemExprCallback, ItemExprContext, ItemExprResolvedContext, ItemExprResolver, ItemNode, Items, ItemsInputNormalizer, JsonArray, JsonNonArray, JsonObject, JsonPrimitive, JsonValue, Lifecycle, LiveWorkflowRepository, MultiInputNode, MutableRunData, NoOpCostTrackingTelemetry, NoOpCostTrackingTelemetryFactory, NoOpExecutionTelemetry, NoOpExecutionTelemetryFactory, NoOpNodeExecutionTelemetry, NoOpPollingTriggerLogger, NoOpTelemetryArtifactReference, NoOpTelemetrySpanScope, NoRetryPolicy, NodeActivationContinuation, NodeActivationId, NodeActivationReceipt, NodeActivationRequest, NodeActivationRequestBase, NodeActivationScheduler, NodeBackedToolConfig, NodeBackedToolConfigOptions, NodeBackedToolInputMapper, NodeBackedToolInputMapperArgs, NodeBackedToolOutputMapper, NodeBackedToolOutputMapperArgs, NodeBinaryAttachmentService, NodeConfigBase, NodeConnectionName, NodeDefinition, NodeErrorHandler, NodeErrorHandlerArgs, NodeErrorHandlerSpec, NodeEventPublisher, NodeExecutionContext, NodeExecutionError, NodeExecutionRequest, NodeExecutionRequestHandler, NodeExecutionScheduler, NodeExecutionSnapshot, NodeExecutionStatePublisher, NodeExecutionStatus, NodeExecutionTelemetry, NodeExecutor, NodeId, NodeIdRef, NodeIdSlugifier, NodeInputsByPort, NodeIterationId, NodeIterationIdFactory, NodeKind, NodeOffloadPolicy, NodeOutputNormalizer, NodeOutputs, NodeRef, NodeResolver, NodeSchedulerDecision, NoneRetryPolicySpec, OAuth2ProviderFromPublicConfig, OutputPortKey, PairedItemRef, Param, ParamDeep, ParentExecutionRef, PayloadStorageKind, PendingNodeExecution, PersistedExecutionInstanceKind, PersistedExecutionInstanceRecord, PersistedMutableNodeState, PersistedMutableRunState, PersistedRunControlState, PersistedRunPolicySnapshot, PersistedRunSchedulingState, PersistedRunSlotProjectionRecord, PersistedRunState, PersistedRunWorkItemKind, PersistedRunWorkItemRecord, type PersistedRuntimeTypeDecoratorOptions, type PersistedRuntimeTypeKind, type PersistedRuntimeTypeMetadata, PersistedRuntimeTypeMetadataStore, PersistedRuntimeTypeNameResolver, PersistedTokenId, PersistedTriggerSetupState, PersistedWorkflowSnapshot, PersistedWorkflowSnapshotNode, PersistedWorkflowTokenRegistryLike, PinnedNodeOutputsByPort, type PollingRunCycleArgs, type PollingRunCycleResult, PollingTriggerDedupWindow, PollingTriggerHandle, type PollingTriggerLogger, PollingTriggerRuntime, type PollingTriggerStartArgs, PortsEmission, PreparedNodeActivationDispatch, RegistrationOptions, RetryPolicy, RetryPolicySpec, RunCompletionNotifier, RunCurrentState, RunDataFactory, RunDataSnapshot, RunEvent, RunEventBus, RunEventPublisherDeps, RunEventSubscription, RunExecutionOptions, RunFinishedAtFactory, RunId, RunIdFactory, RunIntentService, RunIterationDto, RunPruneCandidate, RunQueueEntry, RunResult, RunRevision, RunSlotProjectionState, RunStateResetRequest, RunStatus, RunStopCondition, RunSummary, RunTestContext, RunnableNode, RunnableNodeConfig, RunnableNodeExecuteArgs, RunnableNodeInputJson, RunnableNodeOutputJson, RunnableOutputBehaviorResolver, SlotExecutionStateDto, StackTraceCallSitePathResolver, StepSequenceOutput, StructuredOutputOptions, SystemClock, TelemetryArtifactAttachment, TelemetryArtifactReference, TelemetryAttributePrimitive, TelemetryAttributes, TelemetryChildSpanStart, TelemetryMetricRecord, TelemetryScope, TelemetrySpanEnd, TelemetrySpanEventRecord, TelemetrySpanScope, TestCaseRunStatus, TestSuiteRunId, TestSuiteRunStatus, TestTriggerNodeConfig, TestTriggerSetupContext, TestableTriggerNode, Tool, ToolConfig, ToolExecuteArgs, TriggerCleanupHandle, TriggerInstanceId, TriggerNode, TriggerNodeConfig, TriggerNodeOutputJson, TriggerNodeSetupState, TriggerRuntimeDiagnostics, TriggerSetupContext, TriggerSetupStateFor, TriggerSetupStateRepository, TriggerTestItemsContext, TypeToken, UnavailableBinaryStorage, UpstreamRefPlaceholder, ValidStepSequence, WebhookControlSignal, WebhookInvocationMatch, WebhookRunResult, WebhookTriggerMatcher, WebhookTriggerResolution, WebhookTriggerRoutingDiagnostics, WhenBuilder, WorkItemId, WorkItemStatus, WorkflowActivationPolicy, WorkflowBuilder, WorkflowDefinition, WorkflowDefinitionError, WorkflowDetailSelectionState, WorkflowErrorContext, WorkflowErrorHandler, WorkflowErrorHandlerSpec, WorkflowExecutableNodeClassifier, WorkflowExecutableNodeClassifierFactory, WorkflowExecutionListingRepository, WorkflowExecutionPruneRepository, WorkflowExecutionRepository, WorkflowGraph, WorkflowGraphFactory, WorkflowId, WorkflowNodeConnection, WorkflowNodeInstanceFactory, WorkflowPolicyRuntimeDefaults, WorkflowPrunePolicySpec, WorkflowRepository, WorkflowRunDetailDto, WorkflowRunnerResolver, WorkflowRunnerService, WorkflowSnapshotFactory, WorkflowSnapshotResolver, WorkflowStoragePolicyDecisionArgs, WorkflowStoragePolicyMode, WorkflowStoragePolicyResolver, WorkflowStoragePolicySpec, ZodSchemaAny, branchRef, c, callableTool, chatModel, container, defineBatchNode, defineCollection, defineCredential, defineNode, definePollingTrigger, delay, deriveAssertionPassed, emitPorts, getOriginIndexFromItem, getPersistedRuntimeTypeMetadata, inject, injectAll, injectable, instanceCachingFactory, instancePerContainerCachingFactory, isItemExpr, isPortsEmission, isUnbrandedPortsEmissionShape, itemExpr, node, nodeRef, predicateAwareClassFactory, registry, resolveItemExprsForExecution, resolveItemExprsInUnknown, runnableNodeInputType, runnableNodeOutputType, singleton, tool, triggerNodeOutputType, triggerNodeSetupStateType };
925
1378
  //# sourceMappingURL=index.d.cts.map