@codemation/core 0.0.7 → 0.0.11

package/dist/index-AZ72Ej-K.d.ts

@@ -1,920 +0,0 @@
-import "reflect-metadata";
-import { DependencyContainer, DependencyContainer as Container, Disposable, InjectionToken, InjectionToken as TypeToken, Lifecycle, RegistrationOptions, container, delay, inject, injectAll, injectable, instanceCachingFactory, instancePerContainerCachingFactory, predicateAwareClassFactory, registry, singleton } from "tsyringe";
-import { ReadableStream } from "node:stream/web";
-
-//#region src/contracts/retryPolicySpec.types.d.ts
-
-/**
- * In-process retry policy for runnable nodes. Serialized configs use the same
- * `kind` discriminator (`JSON.stringify` / persisted workflows).
- *
- * `maxAttempts` is the total number of tries including the first (e.g. 3 means up to 2 delays after failures).
- */
-type RetryPolicySpec = NoneRetryPolicySpec | FixedRetryPolicySpec | ExponentialRetryPolicySpec;
-interface NoneRetryPolicySpec {
-  readonly kind: "none";
-}
-interface FixedRetryPolicySpec {
-  readonly kind: "fixed";
-  /** Total attempts including the first execution. Must be >= 1. */
-  readonly maxAttempts: number;
-  readonly delayMs: number;
-}
-interface ExponentialRetryPolicySpec {
-  readonly kind: "exponential";
-  /** Total attempts including the first execution. Must be >= 1. */
-  readonly maxAttempts: number;
-  readonly initialDelayMs: number;
-  readonly multiplier: number;
-  readonly maxDelayMs?: number;
-  /** When true, each delay is multiplied by a random factor in [1, 1.2). */
-  readonly jitter?: boolean;
-}
-//#endregion
-//#region src/contracts/workflowTypes.d.ts
-type WorkflowId = string;
-type NodeId = string;
-type OutputPortKey = string;
-type InputPortKey = string;
-type PersistedTokenId = string;
-type NodeKind = "trigger" | "node";
-type JsonPrimitive = string | number | boolean | null;
-interface JsonObject {
-  readonly [key: string]: JsonValue;
-}
-type JsonValue = JsonPrimitive | JsonObject | JsonArray;
-type JsonArray = ReadonlyArray<JsonValue>;
-interface Edge {
-  from: {
-    nodeId: NodeId;
-    output: OutputPortKey;
-  };
-  to: {
-    nodeId: NodeId;
-    input: InputPortKey;
-  };
-}
-interface WorkflowDefinition {
-  id: WorkflowId;
-  name: string;
-  nodes: NodeDefinition[];
-  edges: Edge[];
-  /** Directory + file-stem path under a workflow discovery root (for UI grouping only). */
-  discoveryPathSegments?: readonly string[];
-}
-interface WorkflowGraph {
-  next(nodeId: NodeId, output: OutputPortKey): ReadonlyArray<Readonly<{
-    nodeId: NodeId;
-    input: InputPortKey;
-  }>>;
-}
-interface WorkflowGraphFactory {
-  create(def: WorkflowDefinition): WorkflowGraph;
-}
-interface NodeConfigBase {
-  readonly kind: NodeKind;
-  readonly type: TypeToken<unknown>;
-  readonly name?: string;
-  readonly id?: NodeId;
-  readonly icon?: string;
-  readonly execution?: Readonly<{
-    hint?: "local" | "worker";
-    queue?: string;
-  }>;
-  /** In-process execute retries (runnable nodes). Triggers typically omit this. */
-  readonly retryPolicy?: RetryPolicySpec;
-  getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
-}
-declare const runnableNodeInputType: unique symbol;
-declare const runnableNodeOutputType: unique symbol;
-declare const triggerNodeOutputType: unique symbol;
-interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> extends NodeConfigBase {
-  readonly kind: "node";
-  readonly [runnableNodeInputType]?: TInputJson$1;
-  readonly [runnableNodeOutputType]?: TOutputJson$1;
-}
-declare const triggerNodeSetupStateType: unique symbol;
-interface TriggerNodeConfig<TOutputJson$1 = unknown, TSetupState$1 extends JsonValue | undefined = undefined> extends NodeConfigBase {
-  readonly kind: "trigger";
-  readonly [triggerNodeOutputType]?: TOutputJson$1;
-  readonly [triggerNodeSetupStateType]?: TSetupState$1;
-}
-type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;
-type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;
-type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;
-type TriggerNodeSetupState<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<any, infer TSetupState> ? TSetupState : never;
-interface NodeDefinition {
-  id: NodeId;
-  kind: NodeKind;
-  type: TypeToken<unknown>;
-  name?: string;
-  config: NodeConfigBase;
-}
-interface NodeRef {
-  id: NodeId;
-  kind: NodeKind;
-  name?: string;
-}
-type PairedItemRef = Readonly<{
-  nodeId: NodeId;
-  output: OutputPortKey;
-  itemIndex: number;
-}>;
-type BinaryPreviewKind = "image" | "audio" | "video" | "download";
-type BinaryAttachment = Readonly<{
-  id: string;
-  storageKey: string;
-  mimeType: string;
-  size: number;
-  storageDriver: string;
-  previewKind: BinaryPreviewKind;
-  createdAt: string;
-  runId: RunId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  activationId: NodeActivationId;
-  filename?: string;
-  sha256?: string;
-}>;
-type ItemBinary = Readonly<Record<string, BinaryAttachment>>;
-type Item<TJson = unknown> = Readonly<{
-  json: TJson;
-  binary?: ItemBinary;
-  meta?: Readonly<Record<string, unknown>>;
-  paired?: ReadonlyArray<PairedItemRef>;
-}>;
-type Items<TJson = unknown> = ReadonlyArray<Item<TJson>>;
-type NodeOutputs = Partial<Record<OutputPortKey, Items>>;
-type RunId = string;
-type NodeActivationId = string;
-interface ParentExecutionRef {
-  runId: RunId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-}
-interface RunDataSnapshot {
-  getOutputs(nodeId: NodeId): NodeOutputs | undefined;
-  getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
-  getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
-}
-interface MutableRunData extends RunDataSnapshot {
-  setOutputs(nodeId: NodeId, outputs: NodeOutputs): void;
-  dump(): Record<NodeId, NodeOutputs>;
-}
-interface RunDataFactory {
-  create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;
-}
-interface RunIdFactory {
-  makeRunId(): RunId;
-}
-interface ActivationIdFactory {
-  makeActivationId(): NodeActivationId;
-}
-type UpstreamRefPlaceholder = `$${number}`;
-declare const branchRef: (index: number) => UpstreamRefPlaceholder;
-type ExecutionMode = "local" | "worker";
-interface NodeSchedulerDecision {
-  mode: ExecutionMode;
-  queue?: string;
-}
-interface NodeOffloadPolicy {
-  decide(args: {
-    workflowId: WorkflowId;
-    nodeId: NodeId;
-    config: NodeConfigBase;
-  }): NodeSchedulerDecision;
-}
-//#endregion
-//#region src/contracts/credentialTypes.d.ts
-type CredentialTypeId = string;
-type CredentialInstanceId = string;
-type CredentialMaterialSourceKind = "db" | "env" | "code";
-type CredentialSetupStatus = "draft" | "ready";
-type CredentialHealthStatus = "unknown" | "healthy" | "failing";
-type CredentialFieldSchema = Readonly<{
-  key: string;
-  label: string;
-  type: "string" | "password" | "textarea" | "json" | "boolean";
-  required?: true;
-  order?: number;
-  placeholder?: string;
-  helpText?: string;
-  /** When set, host resolves this field from process.env at runtime; env wins over stored values. */
-  envVarName?: string;
-}>;
-type CredentialRequirement = Readonly<{
-  slotKey: string;
-  label: string;
-  acceptedTypes: ReadonlyArray<CredentialTypeId>;
-  optional?: true;
-  helpText?: string;
-  helpUrl?: string;
-}>;
-type CredentialBindingKey = Readonly<{
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  slotKey: string;
-}>;
-type CredentialBinding = Readonly<{
-  key: CredentialBindingKey;
-  instanceId: CredentialInstanceId;
-  updatedAt: string;
-}>;
-type CredentialHealth = Readonly<{
-  status: CredentialHealthStatus;
-  message?: string;
-  testedAt?: string;
-  expiresAt?: string;
-  details?: Readonly<Record<string, unknown>>;
-}>;
-type OAuth2ProviderFromPublicConfig = Readonly<{
-  authorizeUrlFieldKey: string;
-  tokenUrlFieldKey: string;
-  userInfoUrlFieldKey?: string;
-}>;
-type CredentialOAuth2AuthDefinition = Readonly<{
-  kind: "oauth2";
-  providerId: string;
-  scopes: ReadonlyArray<string>;
-  clientIdFieldKey?: string;
-  clientSecretFieldKey?: string;
-} | {
-  kind: "oauth2";
-  providerFromPublicConfig: OAuth2ProviderFromPublicConfig;
-  scopes: ReadonlyArray<string>;
-  clientIdFieldKey?: string;
-  clientSecretFieldKey?: string;
-}>;
-type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;
-type CredentialTypeDefinition = Readonly<{
-  typeId: CredentialTypeId;
-  displayName: string;
-  description?: string;
-  publicFields?: ReadonlyArray<CredentialFieldSchema>;
-  secretFields?: ReadonlyArray<CredentialFieldSchema>;
-  supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;
-  auth?: CredentialAuthDefinition;
-}>;
-interface CredentialSessionService {
-  getSession<TSession = unknown>(args: Readonly<{
-    workflowId: WorkflowId;
-    nodeId: NodeId;
-    slotKey: string;
-  }>): Promise<TSession>;
-}
-interface CredentialTypeRegistry {
-  listTypes(): ReadonlyArray<CredentialTypeDefinition>;
-  getType(typeId: CredentialTypeId): CredentialTypeDefinition | undefined;
-}
-declare class CredentialUnboundError extends Error {
-  readonly bindingKey: CredentialBindingKey;
-  readonly acceptedTypes: ReadonlyArray<CredentialTypeId>;
-  constructor(bindingKey: CredentialBindingKey, acceptedTypes?: ReadonlyArray<CredentialTypeId>);
-  private static createMessage;
-}
-//#endregion
-//#region src/contracts/NoRetryPolicy.d.ts
-declare class NoRetryPolicy implements NoneRetryPolicySpec {
-  readonly kind: "none";
-}
-//#endregion
-//#region src/contracts/RetryPolicy.d.ts
-declare class RetryPolicy implements FixedRetryPolicySpec {
-  readonly maxAttempts: number;
-  readonly delayMs: number;
-  readonly kind: "fixed";
-  constructor(maxAttempts: number, delayMs: number);
-  /** Default for HTTP-style transient failures: 3 tries, 1s between attempts. */
-  static readonly defaultForHttp: FixedRetryPolicySpec;
-  /** Default for LLM / agent calls: 3 tries, 2s fixed backoff. */
-  static readonly defaultForAiAgent: FixedRetryPolicySpec;
-}
-//#endregion
-//#region src/contracts/ExpRetryPolicy.d.ts
-declare class ExpRetryPolicy implements ExponentialRetryPolicySpec {
-  readonly maxAttempts: number;
-  readonly initialDelayMs: number;
-  readonly multiplier: number;
-  readonly maxDelayMs?: number | undefined;
-  readonly jitter?: boolean | undefined;
-  readonly kind: "exponential";
-  constructor(maxAttempts: number, initialDelayMs: number, multiplier: number, maxDelayMs?: number | undefined, jitter?: boolean | undefined);
-}
-//#endregion
-//#region src/events/runEvents.d.ts
-type RunEvent = Readonly<{
-  kind: "runCreated";
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  at: string;
-}> | Readonly<{
-  kind: "runSaved";
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  at: string;
-  state: PersistedRunState;
-}> | Readonly<{
-  kind: "nodeQueued";
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  at: string;
-  snapshot: NodeExecutionSnapshot;
-}> | Readonly<{
-  kind: "nodeStarted";
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  at: string;
-  snapshot: NodeExecutionSnapshot;
-}> | Readonly<{
-  kind: "nodeCompleted";
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  at: string;
-  snapshot: NodeExecutionSnapshot;
-}> | Readonly<{
-  kind: "nodeFailed";
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  at: string;
-  snapshot: NodeExecutionSnapshot;
-}>;
-interface RunEventSubscription {
-  close(): Promise<void>;
-}
-interface RunEventBus {
-  publish(event: RunEvent): Promise<void>;
-  subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription>;
-  subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription>;
-}
-//#endregion
-//#region src/contracts/runTypes.d.ts
-interface RunExecutionOptions {
-  localOnly?: boolean;
-  webhook?: boolean;
-  mode?: "manual" | "debug";
-  sourceWorkflowId?: WorkflowId;
-  sourceRunId?: RunId;
-  derivedFromRunId?: RunId;
-  isMutable?: boolean;
-}
-type RunStopCondition = Readonly<{
-  kind: "workflowCompleted";
-}> | Readonly<{
-  kind: "nodeCompleted";
-  nodeId: NodeId;
-}>;
-interface RunStateResetRequest {
-  clearFromNodeId: NodeId;
-}
-interface PersistedRunControlState {
-  stopCondition?: RunStopCondition;
-}
-interface PersistedWorkflowSnapshotNode {
-  id: NodeId;
-  kind: NodeKind;
-  name?: string;
-  nodeTokenId: PersistedTokenId;
-  configTokenId: PersistedTokenId;
-  tokenName?: string;
-  configTokenName?: string;
-  config: unknown;
-}
-interface PersistedWorkflowSnapshot {
-  id: WorkflowId;
-  name: string;
-  nodes: ReadonlyArray<PersistedWorkflowSnapshotNode>;
-  edges: ReadonlyArray<Edge>;
-}
-type PinnedNodeOutputsByPort = Readonly<Record<OutputPortKey, Items>>;
-interface PersistedMutableNodeState {
-  pinnedOutputsByPort?: PinnedNodeOutputsByPort;
-  lastDebugInput?: Items;
-}
-interface PersistedMutableRunState {
-  nodesById: Readonly<Record<NodeId, PersistedMutableNodeState>>;
-}
-type NodeInputsByPort = Readonly<Record<InputPortKey, Items>>;
-interface RunQueueEntry {
-  nodeId: NodeId;
-  input: Items;
-  toInput?: InputPortKey;
-  batchId?: string;
-  from?: Readonly<{
-    nodeId: NodeId;
-    output: OutputPortKey;
-  }>;
-  collect?: Readonly<{
-    expectedInputs: ReadonlyArray<InputPortKey>;
-    received: Readonly<Record<InputPortKey, Items>>;
-  }>;
-}
-type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
-interface NodeExecutionError {
-  message: string;
-  name?: string;
-  stack?: string;
-}
-interface NodeExecutionSnapshot {
-  runId: RunId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  activationId?: NodeActivationId;
-  parent?: ParentExecutionRef;
-  status: NodeExecutionStatus;
-  usedPinnedOutput?: boolean;
-  queuedAt?: string;
-  startedAt?: string;
-  finishedAt?: string;
-  updatedAt: string;
-  inputsByPort?: NodeInputsByPort;
-  outputs?: NodeOutputs;
-  error?: NodeExecutionError;
-}
-interface RunCurrentState {
-  outputsByNode: Record<NodeId, NodeOutputs>;
-  nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
-  mutableState?: PersistedMutableRunState;
-}
-interface CurrentStateExecutionRequest {
-  workflow: WorkflowDefinition;
-  items?: Items;
-  parent?: ParentExecutionRef;
-  executionOptions?: RunExecutionOptions;
-  workflowSnapshot?: PersistedWorkflowSnapshot;
-  mutableState?: PersistedMutableRunState;
-  currentState?: RunCurrentState;
-  stopCondition?: RunStopCondition;
-  reset?: RunStateResetRequest;
-}
-interface ExecutionFrontierPlan {
-  rootNodeId?: NodeId;
-  rootNodeInput?: Items;
-  queue: RunQueueEntry[];
-  currentState: RunCurrentState;
-  stopCondition: RunStopCondition;
-  satisfiedNodeIds: ReadonlyArray<NodeId>;
-  skippedNodeIds: ReadonlyArray<NodeId>;
-  clearedNodeIds: ReadonlyArray<NodeId>;
-  preservedPinnedNodeIds: ReadonlyArray<NodeId>;
-}
-type RunStatus = "running" | "pending" | "completed" | "failed";
-interface RunSummary {
-  runId: RunId;
-  workflowId: WorkflowId;
-  startedAt: string;
-  status: RunStatus;
-  /** ISO timestamp when the run finished (derived from node snapshots or store `updatedAt`); omit while running/pending. */
-  finishedAt?: string;
-  parent?: ParentExecutionRef;
-  executionOptions?: RunExecutionOptions;
-}
-interface PendingNodeExecution {
-  runId: RunId;
-  activationId: NodeActivationId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  itemsIn: number;
-  inputsByPort: NodeInputsByPort;
-  receiptId: string;
-  queue?: string;
-  batchId?: string;
-  enqueuedAt: string;
-}
-interface PersistedRunState {
-  runId: RunId;
-  workflowId: WorkflowId;
-  startedAt: string;
-  parent?: ParentExecutionRef;
-  executionOptions?: RunExecutionOptions;
-  control?: PersistedRunControlState;
-  workflowSnapshot?: PersistedWorkflowSnapshot;
-  mutableState?: PersistedMutableRunState;
-  status: RunStatus;
-  pending?: PendingNodeExecution;
-  queue: RunQueueEntry[];
-  outputsByNode: Record<NodeId, NodeOutputs>;
-  nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
-}
-interface RunStateStore {
-  createRun(args: {
-    runId: RunId;
-    workflowId: WorkflowId;
-    startedAt: string;
-    parent?: ParentExecutionRef;
-    executionOptions?: RunExecutionOptions;
-    control?: PersistedRunControlState;
-    workflowSnapshot?: PersistedWorkflowSnapshot;
-    mutableState?: PersistedMutableRunState;
-  }): Promise<void>;
-  load(runId: RunId): Promise<PersistedRunState | undefined>;
-  save(state: PersistedRunState): Promise<void>;
-}
-interface RunListingStore {
-  listRuns(args?: Readonly<{
-    workflowId?: WorkflowId;
-    limit?: number;
-  }>): Promise<ReadonlyArray<RunSummary>>;
-}
-type RunResult = {
-  runId: RunId;
-  workflowId: WorkflowId;
-  startedAt: string;
-  status: "completed";
-  outputs: Items;
-} | {
-  runId: RunId;
-  workflowId: WorkflowId;
-  startedAt: string;
-  status: "pending";
-  pending: PendingNodeExecution;
-} | {
-  runId: RunId;
-  workflowId: WorkflowId;
-  startedAt: string;
-  status: "failed";
-  error: {
-    message: string;
-  };
-};
-type WebhookRunResult = Readonly<{
-  runId: RunId;
-  workflowId: WorkflowId;
-  startedAt: string;
-  runStatus: "pending" | "completed";
-  response: Items;
-}>;
-interface PersistedWorkflowTokenRegistryLike {
-  register(type: TypeToken<unknown>, packageId: string, persistedNameOverride?: string): string;
-  getTokenId(type: TypeToken<unknown>): string | undefined;
-  resolve(tokenId: string): TypeToken<unknown> | undefined;
-  registerFromWorkflows?(workflows: ReadonlyArray<WorkflowDefinition>): void;
-}
-interface RunCompletionNotifier {
-  resolveRunCompletion(result: RunResult): void;
-  resolveWebhookResponse(result: WebhookRunResult): void;
-}
-interface RunEventPublisherDeps {
-  eventBus?: RunEventBus;
-}
-//#endregion
-//#region src/contracts/webhookTypes.d.ts
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-interface WebhookControlSignal {
-  readonly __webhookControl: true;
-  readonly kind: "respondNow" | "respondNowAndContinue";
-  readonly responseItems: Items;
-  readonly continueItems?: Items;
-}
-interface WebhookSpec {
-  endpointKey: string;
-  methods: ReadonlyArray<HttpMethod>;
-  parseJsonBody?: (body: unknown) => unknown;
-}
-interface WebhookRegistration {
-  endpointId: string;
-  methods: ReadonlyArray<HttpMethod>;
-  path: string;
-}
-interface TriggerInstanceId {
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-}
-interface WebhookInvocationMatch {
-  endpointId: string;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  methods: ReadonlyArray<HttpMethod>;
-  parseJsonBody?: (body: unknown) => unknown;
-}
-interface WebhookTriggerMatcher {
-  register(args: {
-    workflowId: WorkflowId;
-    nodeId: NodeId;
-    endpointId: string;
-    methods: ReadonlyArray<HttpMethod>;
-    parseJsonBody?: (body: unknown) => unknown;
-  }): void;
-  clear?(): void;
-  lookup(endpointId: string): WebhookInvocationMatch | undefined;
-  match(args: {
-    endpointId: string;
-    method: HttpMethod;
-  }): WebhookInvocationMatch | undefined;
-}
-//#endregion
-//#region src/contracts/runtimeTypes.d.ts
-interface WorkflowRunnerService {
-  runById(args: {
-    workflowId: WorkflowId;
-    startAt?: NodeId;
-    items: Items;
-    parent?: ParentExecutionRef;
-  }): Promise<RunResult>;
-}
-interface WorkflowRunnerResolver {
-  resolve(): WorkflowRunnerService | undefined;
-}
-interface WorkflowRepository {
-  list(): ReadonlyArray<WorkflowDefinition>;
-  get(workflowId: WorkflowId): WorkflowDefinition | undefined;
-}
-interface WorkflowCatalog extends WorkflowRepository {
-  setWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
-}
-type WorkflowRegistry = WorkflowCatalog;
-interface NodeResolver {
-  resolve<T>(token: TypeToken<T>): T;
-  getContainer(): Container | undefined;
-}
-interface WebhookRegistrar {
-  registerWebhook(spec: {
-    workflowId: WorkflowId;
-    nodeId: NodeId;
-    endpointKey: string;
-    methods: ReadonlyArray<HttpMethod>;
-    parseJsonBody?: (body: unknown) => unknown;
-    basePath: string;
-  }): WebhookRegistration;
-  clear?(): Promise<void> | void;
-}
-interface NodeActivationObserver {
-  onNodeActivation(stats: NodeActivationStats): void;
-}
-interface NodeExecutionStatePublisher {
-  markQueued(args: {
-    nodeId: NodeId;
-    activationId?: NodeActivationId;
-    inputsByPort?: NodeInputsByPort;
-  }): Promise<void>;
-  markRunning(args: {
-    nodeId: NodeId;
-    activationId?: NodeActivationId;
-    inputsByPort?: NodeInputsByPort;
-  }): Promise<void>;
-  markCompleted(args: {
-    nodeId: NodeId;
-    activationId?: NodeActivationId;
-    inputsByPort?: NodeInputsByPort;
-    outputs?: NodeOutputs;
-  }): Promise<void>;
-  markFailed(args: {
-    nodeId: NodeId;
-    activationId?: NodeActivationId;
-    inputsByPort?: NodeInputsByPort;
-    error: Error;
-  }): Promise<void>;
-}
-type BinaryBody = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array> | Uint8Array | ArrayBuffer;
-interface BinaryStorageWriteRequest {
-  storageKey: string;
-  body: BinaryBody;
-}
-interface BinaryStorageWriteResult {
-  storageKey: string;
-  size: number;
-  sha256?: string;
-}
-interface BinaryStorageReadResult {
-  body: ReadableStream<Uint8Array>;
-  size?: number;
-}
-interface BinaryStorageStatResult {
-  exists: boolean;
-  size?: number;
-}
-interface BinaryStorage {
-  readonly driverName: string;
-  write(args: BinaryStorageWriteRequest): Promise<BinaryStorageWriteResult>;
-  openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
-  stat(storageKey: string): Promise<BinaryStorageStatResult>;
-  delete(storageKey: string): Promise<void>;
-}
-interface BinaryAttachmentCreateRequest {
-  name: string;
-  body: BinaryBody;
-  mimeType: string;
-  filename?: string;
-  previewKind?: BinaryAttachment["previewKind"];
-}
-interface NodeBinaryAttachmentService extends ExecutionBinaryService {
-  attach(args: BinaryAttachmentCreateRequest): Promise<BinaryAttachment>;
-  withAttachment<TJson>(item: Item<TJson>, name: string, attachment: BinaryAttachment): Item<TJson>;
-}
-interface ExecutionBinaryService {
-  forNode(args: {
-    nodeId: NodeId;
-    activationId: NodeActivationId;
-  }): NodeBinaryAttachmentService;
-  openReadStream(attachment: BinaryAttachment): Promise<BinaryStorageReadResult | undefined>;
-}
-interface ExecutionContext {
-  runId: RunId;
-  workflowId: WorkflowId;
-  parent?: ParentExecutionRef;
-  now: () => Date;
-  data: RunDataSnapshot;
-  nodeState?: NodeExecutionStatePublisher;
-  binary: ExecutionBinaryService;
-  getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
-}
-interface ExecutionContextFactory {
-  create(args: {
-    runId: RunId;
-    workflowId: WorkflowId;
-    parent?: ParentExecutionRef;
-    data: RunDataSnapshot;
-    nodeState?: NodeExecutionStatePublisher;
-    getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
-  }): ExecutionContext;
-}
-interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase> extends ExecutionContext {
-  nodeId: NodeId;
-  activationId: NodeActivationId;
-  config: TConfig;
-  binary: NodeBinaryAttachmentService;
-}
-interface TriggerSetupContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
-  trigger: TriggerInstanceId;
-  config: TConfig;
-  previousState: TSetupState$1;
-  registerWebhook(spec: WebhookSpec): WebhookRegistration;
-  registerCleanup(cleanup: TriggerCleanupHandle): void;
-  emit(items: Items): Promise<void>;
-}
-interface TriggerTestItemsContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
-  trigger: TriggerInstanceId;
-  nodeId: NodeId;
-  config: TConfig;
-  previousState: TSetupState$1;
-}
-/**
- * Trigger setup state is intentionally engine-owned so future ownership and
- * leader-election metadata can be coordinated centrally rather than pushed into
- * package-level setup code.
- */
-interface PersistedTriggerSetupState<TState extends JsonValue | undefined = JsonValue | undefined> {
-  trigger: TriggerInstanceId;
-  updatedAt: string;
-  state: TState;
-}
-interface TriggerSetupStateStore {
-  load(trigger: TriggerInstanceId): Promise<PersistedTriggerSetupState | undefined>;
-  save(state: PersistedTriggerSetupState): Promise<void>;
-  delete(trigger: TriggerInstanceId): Promise<void>;
-}
-interface TriggerCleanupHandle {
-  stop(): Promise<void> | void;
-}
-interface NodeActivationStats {
-  activationId: NodeActivationId;
-  nodeId: NodeId;
-  itemsIn: number;
-  itemsOutByPort: Readonly<Record<OutputPortKey, number>>;
-}
-interface EngineHost {
-  credentialSessions: CredentialSessionService;
-  workflows?: WorkflowRunnerService;
-  registerWebhook(spec: {
-    workflowId: WorkflowId;
-    nodeId: NodeId;
-    endpointKey: string;
-    methods: ReadonlyArray<HttpMethod>;
-    parseJsonBody?: (body: unknown) => unknown;
-    basePath: string;
-  }): WebhookRegistration;
-  onNodeActivation(stats: NodeActivationStats): void;
-}
-interface Node<TConfig extends NodeConfigBase = NodeConfigBase> {
-  kind: "node";
-  outputPorts: ReadonlyArray<OutputPortKey>;
-  execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
-}
-interface MultiInputNode<TConfig extends NodeConfigBase = NodeConfigBase> {
-  kind: "node";
-  outputPorts: ReadonlyArray<OutputPortKey>;
-  executeMulti(inputsByPort: NodeInputsByPort, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
-}
-type TriggerSetupStateFor<TConfig extends TriggerNodeConfig<any, any>> = TriggerNodeSetupState<TConfig>;
-interface TriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> {
-  kind: "trigger";
-  outputPorts: readonly ["main"];
-  setup(ctx: TriggerSetupContext<TConfig>): Promise<TriggerSetupStateFor<TConfig>>;
-  execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
-}
-interface TestableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> extends TriggerNode<TConfig> {
-  getTestItems(ctx: TriggerTestItemsContext<TConfig>): Promise<Items>;
-}
-type ExecutableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> = TriggerNode<TConfig>;
-interface NodeExecutionRequest {
-  runId: RunId;
-  activationId: NodeActivationId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  input: Items;
-  parent?: ParentExecutionRef;
-  queue?: string;
-  executionOptions?: RunExecutionOptions;
-}
-interface NodeExecutionScheduler {
-  enqueue(request: NodeExecutionRequest): Promise<{
-    receiptId: string;
-  }>;
-  cancel?(receiptId: string): Promise<void>;
-}
-type NodeActivationRequestBase = Readonly<{
-  runId: RunId;
-  activationId: NodeActivationId;
-  workflowId: WorkflowId;
-  nodeId: NodeId;
-  parent?: ParentExecutionRef;
-  executionOptions?: RunExecutionOptions;
-  batchId?: string;
-  ctx: NodeExecutionContext;
-}>;
-type NodeActivationRequest = (NodeActivationRequestBase & Readonly<{
-  kind: "single";
-  input: Items;
-}>) | (NodeActivationRequestBase & Readonly<{
-  kind: "multi";
-  inputsByPort: NodeInputsByPort;
-}>);
-interface NodeActivationReceipt {
-  receiptId: string;
-  mode?: "local" | "worker";
-  queue?: string;
-}
-interface NodeActivationContinuation {
-  markNodeRunning(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    inputsByPort: NodeInputsByPort;
-  }): Promise<void>;
-  resumeFromNodeResult(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    outputs: NodeOutputs;
-  }): Promise<RunResult>;
-  resumeFromNodeError(args: {
-    runId: RunId;
-    activationId: NodeActivationId;
-    nodeId: NodeId;
-    error: Error;
-  }): Promise<RunResult>;
-}
-interface NodeActivationScheduler {
-  setContinuation?(continuation: NodeActivationContinuation): void;
-  enqueue(request: NodeActivationRequest): Promise<NodeActivationReceipt>;
-  notifyPendingStatePersisted?(runId: RunId): void;
-  cancel?(receiptId: string): Promise<void>;
-}
-interface WorkflowNodeInstanceFactory {
-  createNodes(workflow: WorkflowDefinition): ReadonlyMap<NodeId, unknown>;
-}
-interface WorkflowSnapshotFactory {
-  create(workflow: WorkflowDefinition): PersistedWorkflowSnapshot;
-}
-interface WorkflowSnapshotResolver {
-  resolve(args: {
-    workflowId: WorkflowId;
-    workflowSnapshot?: PersistedWorkflowSnapshot;
-  }): WorkflowDefinition | undefined;
-}
-interface EngineDeps {
-  credentialSessions: CredentialSessionService;
-  workflowRunnerResolver: WorkflowRunnerResolver;
-  workflowCatalog: WorkflowCatalog;
-  workflowRepository: WorkflowRepository;
-  nodeResolver: NodeResolver;
-  webhookRegistrar: WebhookRegistrar;
-  triggerSetupStateStore: TriggerSetupStateStore;
-  webhookTriggerMatcher: WebhookTriggerMatcher;
-  nodeActivationObserver: NodeActivationObserver;
-  runIdFactory: RunIdFactory;
-  activationIdFactory: ActivationIdFactory;
-  webhookBasePath?: string;
-  runStore: RunStateStore;
-  activationScheduler: NodeActivationScheduler;
-  runDataFactory: RunDataFactory;
-  executionContextFactory: ExecutionContextFactory;
-  eventBus?: RunEventBus;
-  tokenRegistry: PersistedWorkflowTokenRegistryLike;
-  workflowNodeInstanceFactory: WorkflowNodeInstanceFactory;
-}
-//#endregion
-//#region src/contracts/runFinishedAtFactory.d.ts
-type RunFinishedAtSource = Pick<PersistedRunState, "status" | "nodeSnapshotsByNodeId">;
-/** Derives workflow end time from node snapshots for run listings. */
-declare class RunFinishedAtFactory {
-  static resolveIso(state: RunFinishedAtSource): string | undefined;
-}
-//#endregion
-export { WebhookTriggerMatcher as $, RegistrationOptions as $n, BinaryPreviewKind as $t, PersistedTriggerSetupState as A, RunnableNodeOutputJson as An, RunEventSubscription as At, WorkflowNodeInstanceFactory as B, runnableNodeInputType as Bn, CredentialInstanceId as Bt, NodeActivationStats as C, PersistedTokenId as Cn, RunStateStore as Ct, NodeExecutionScheduler as D, RunIdFactory as Dn, WebhookRunResult as Dt, NodeExecutionRequest as E, RunId as En, RunSummary as Et, TriggerSetupStateFor as F, WorkflowDefinition as Fn, CredentialBinding as Ft, WorkflowSnapshotFactory as G, FixedRetryPolicySpec as Gn, CredentialSetupStatus as Gt, WorkflowRepository as H, triggerNodeOutputType as Hn, CredentialOAuth2AuthDefinition as Ht, TriggerSetupStateStore as I, WorkflowGraph as In, CredentialBindingKey as It, TriggerInstanceId as J, Container as Jn, CredentialTypeRegistry as Jt, WorkflowSnapshotResolver as K, NoneRetryPolicySpec as Kn, CredentialTypeDefinition as Kt, TriggerTestItemsContext as L, WorkflowGraphFactory as Ln, CredentialFieldSchema as Lt, TriggerCleanupHandle as M, TriggerNodeOutputJson as Mn, RetryPolicy as Mt, TriggerNode as N, TriggerNodeSetupState as Nn, NoRetryPolicy as Nt, NodeExecutionStatePublisher as O, RunnableNodeConfig as On, RunEvent as Ot, TriggerSetupContext as P, UpstreamRefPlaceholder as Pn, CredentialAuthDefinition as Pt, WebhookSpec as Q, Lifecycle as Qn, BinaryAttachment as Qt, WebhookRegistrar as R, WorkflowId as Rn, CredentialHealth as Rt, NodeActivationScheduler as S, ParentExecutionRef as Sn, RunStateResetRequest as St, NodeExecutionContext as T, RunDataSnapshot as Tn, RunStopCondition as Tt, WorkflowRunnerResolver as U, triggerNodeSetupStateType as Un, CredentialRequirement as Ut, WorkflowRegistry as V, runnableNodeOutputType as Vn, CredentialMaterialSourceKind as Vt, WorkflowRunnerService as W, ExponentialRetryPolicySpec as Wn, CredentialSessionService as Wt, WebhookInvocationMatch as X, Disposable as Xn, OAuth2ProviderFromPublicConfig as Xt, WebhookControlSignal as Y, DependencyContainer as Yn, CredentialUnboundError as Yt, WebhookRegistration as Z, InjectionToken as Zn, ActivationIdFactory as Zt, NodeActivationContinuation as _, NodeOutputs as _n, RunEventPublisherDeps as _t, BinaryStorageReadResult as a, Items as an, injectable as ar, NodeInputsByPort as at, NodeActivationRequest as b, OutputPortKey as bn, RunQueueEntry as bt, BinaryStorageWriteResult as c, JsonPrimitive as cn, predicateAwareClassFactory as cr, PersistedMutableRunState as ct, ExecutableTriggerNode as d, NodeActivationId as dn, PersistedWorkflowSnapshot as dt, Edge as en, TypeToken as er, CurrentStateExecutionRequest as et, ExecutionBinaryService as f, NodeConfigBase as fn, PersistedWorkflowSnapshotNode as ft, Node as g, NodeOffloadPolicy as gn, RunCurrentState as gt, MultiInputNode as h, NodeKind as hn, RunCompletionNotifier as ht, BinaryStorage as i, ItemBinary as in, injectAll as ir, NodeExecutionStatus as it, TestableTriggerNode as j, TriggerNodeConfig as jn, ExpRetryPolicy as jt, NodeResolver as k, RunnableNodeInputJson as kn, RunEventBus as kt, EngineDeps as l, JsonValue as ln, registry as lr, PersistedRunControlState as lt, ExecutionContextFactory as m, NodeId as mn, PinnedNodeOutputsByPort as mt, BinaryAttachmentCreateRequest as n, InputPortKey as nn, delay as nr, NodeExecutionError as nt, BinaryStorageStatResult as o, JsonArray as on, instanceCachingFactory as or, PendingNodeExecution as ot, ExecutionContext as p, NodeDefinition as pn, PersistedWorkflowTokenRegistryLike as pt, HttpMethod as q, RetryPolicySpec as qn, CredentialTypeId as qt, BinaryBody as r, Item as rn, inject as rr, NodeExecutionSnapshot as rt, BinaryStorageWriteRequest as s, JsonObject as sn, instancePerContainerCachingFactory as sr, PersistedMutableNodeState as st, RunFinishedAtFactory as t, ExecutionMode as tn, container as tr, ExecutionFrontierPlan as tt, EngineHost as u, MutableRunData as un, singleton as ur, PersistedRunState as ut, NodeActivationObserver as v, NodeRef as vn, RunExecutionOptions as vt, NodeBinaryAttachmentService as w, RunDataFactory as wn, RunStatus as wt, NodeActivationRequestBase as x, PairedItemRef as xn, RunResult as xt, NodeActivationReceipt as y, NodeSchedulerDecision as yn, RunListingStore as yt, WorkflowCatalog as z, branchRef as zn, CredentialHealthStatus as zt };
-//# sourceMappingURL=index-AZ72Ej-K.d.ts.map