@sixb/core 0.1.1 → 0.1.3

package/dist/chunk-c6cfqydk.js

@@ -0,0 +1,128 @@
+// @bun
+import {
+  isScheduleDefinition,
+  isScheduleReference
+} from "./chunk-5sz8ta9r.js";
+import {
+  isDatasetDefinition
+} from "./chunk-a31h57d5.js";
+import {
+  ConnectorError,
+  SyncValidationError,
+  createConnectorCodedError,
+  getConnectorExecutionSourceResolver
+} from "./chunk-km4rkj4t.js";
+import {
+  isConnectorDefinition,
+  isOAuthConnectorAdapter
+} from "./chunk-8m5ejdpn.js";
+
+// src/syncs/builders.ts
+function assertNonEmpty(value, field) {
+  if (!value.trim()) {
+    throw new SyncValidationError(`Sync ${field} must not be empty.`);
+  }
+}
+function assertDataset(dataset, mode) {
+  assertNonEmpty(dataset.id, "dataset id");
+  if (mode === "merge" && dataset.primaryKey === undefined) {
+    throw new SyncValidationError(`Merge sync dataset '${dataset.id}' must define a primaryKey.`);
+  }
+}
+function normalizeBatchSyncConfig(options) {
+  const mode = options?.mode ?? "snapshot";
+  if (mode !== "snapshot" && mode !== "append" && mode !== "merge") {
+    throw new SyncValidationError(`Invalid sync mode '${String(mode)}'. Expected 'snapshot', 'append', or 'merge'.`);
+  }
+  return {
+    kind: "batch",
+    mode
+  };
+}
+function defineSync(id, options) {
+  assertNonEmpty(id, "id");
+  const config = normalizeBatchSyncConfig(options);
+  const triggers = [];
+  function createBuilder() {
+    const builder = {
+      when(schedule) {
+        if (!isScheduleDefinition(schedule)) {
+          throw new SyncValidationError("Sync .when(...) only accepts schedules.");
+        }
+        triggers.push({ type: "schedule", scheduleId: schedule.id });
+        return builder;
+      },
+      checkpoint() {
+        return createBuilder();
+      },
+      from(connector) {
+        return {
+          read(handler) {
+            return {
+              intoDataset(dataset) {
+                assertDataset(dataset, config.mode);
+                return {
+                  kind: "sync",
+                  id,
+                  config,
+                  triggers,
+                  connector,
+                  read: handler,
+                  target: {
+                    kind: "dataset",
+                    dataset
+                  }
+                };
+              }
+            };
+          }
+        };
+      }
+    };
+    return builder;
+  }
+  return createBuilder();
+}
+// src/syncs/sources.ts
+function resolveSyncConnectorSources(connector, definition) {
+  return getConnectorExecutionSourceResolver(connector).list(definition);
+}
+// src/connectors/builders.ts
+function assertNonEmpty2(value, field) {
+  if (!value.trim()) {
+    throw new ConnectorError(`Connector ${field} must not be empty.`);
+  }
+}
+function defineConnector(id, adapter) {
+  assertNonEmpty2(id, "id");
+  assertNonEmpty2(adapter.type, "type");
+  if (typeof adapter.connect !== "function") {
+    throw new ConnectorError("Connector adapter connect must be a function.");
+  }
+  if (adapter.authentication !== undefined) {
+    if (!isOAuthConnectorAdapter(adapter) || typeof adapter.authentication.authorizationUrl !== "function" || typeof adapter.authentication.exchangeCode !== "function" || typeof adapter.authentication.refresh !== "function" || typeof adapter.discoverAccounts !== "function") {
+      throw createConnectorCodedError("connector.configuration_invalid", "OAuth connector adapters must define oauth2 authentication and implement authorizationUrl, exchangeCode, refresh, and discoverAccounts.");
+    }
+    if (adapter.webhooks !== undefined) {
+      throw createConnectorCodedError("connector.configuration_invalid", "OAuth connector adapters cannot register webhooks until connection routing is defined.");
+    }
+  }
+  return {
+    kind: "connector",
+    id,
+    adapter
+  };
+}
+// src/syncs/types.ts
+function isSyncDefinition(value) {
+  if (!isRecord(value)) {
+    return false;
+  }
+  return value.kind === "sync" && typeof value.id === "string" && isRecord(value.config) && value.config.kind === "batch" && (value.config.mode === "snapshot" || value.config.mode === "append" || value.config.mode === "merge") && Array.isArray(value.triggers) && value.triggers.every((reference) => isScheduleReference(reference)) && isConnectorDefinition(value.connector) && typeof value.read === "function" && isRecord(value.target) && value.target.kind === "dataset" && isDatasetDefinition(value.target.dataset);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export { defineConnector, defineSync, resolveSyncConnectorSources, isSyncDefinition };
+
+//# debugId=027CA8B23EAA01DB64756E2164756E21

package/dist/chunk-c6cfqydk.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/syncs/builders.ts", "../src/syncs/sources.ts", "../src/connectors/builders.ts", "../src/syncs/types.ts"],
+  "sourcesContent": [
+    "import type { AnyConnectorAdapter, ConnectorDefinition } from \"../connectors\"\nimport type { DatasetDefinition } from \"../datasets\"\nimport type { ScheduleDefinition, ScheduleReference } from \"../schedules\"\nimport { isScheduleDefinition } from \"../schedules\"\nimport { SyncValidationError } from \"./errors\"\nimport type {\n  BatchSyncConfig,\n  BatchSyncDefinitionConfig,\n  SyncBuilder,\n  SyncDefinition,\n  SyncMode,\n  SyncReadBuilder,\n  SyncTargetBuilder,\n} from \"./types\"\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (!value.trim()) {\n    throw new SyncValidationError(`Sync ${field} must not be empty.`)\n  }\n}\n\nfunction assertDataset(dataset: DatasetDefinition, mode: SyncMode): void {\n  assertNonEmpty(dataset.id, \"dataset id\")\n  if (mode === \"merge\" && dataset.primaryKey === undefined) {\n    throw new SyncValidationError(`Merge sync dataset '${dataset.id}' must define a primaryKey.`)\n  }\n}\n\nfunction normalizeBatchSyncConfig(options: BatchSyncConfig | undefined): BatchSyncDefinitionConfig {\n  const mode = options?.mode ?? \"snapshot\"\n\n  if (mode !== \"snapshot\" && mode !== \"append\" && mode !== \"merge\") {\n    throw new SyncValidationError(\n      `Invalid sync mode '${String(mode)}'. Expected 'snapshot', 'append', or 'merge'.`\n    )\n  }\n\n  return {\n    kind: \"batch\",\n    mode,\n  }\n}\n\ntype DefaultBatchSyncConfig = Omit<BatchSyncConfig, \"mode\"> & { readonly mode?: undefined }\n\n/**\n * Define a batch sync that reads from one connector and writes into one dataset.\n *\n * The returned definition is inert and safe to export from `syncs/` modules.\n * Supports `snapshot`, `append`, and keyed `merge` modes with optional triggers and checkpoints.\n */\nexport function defineSync<TId extends string>(\n  id: TId,\n  options?: DefaultBatchSyncConfig\n): SyncBuilder<TId, never, \"snapshot\">\nexport function defineSync<TId extends string, const TMode extends SyncMode>(\n  id: TId,\n  options: BatchSyncConfig<TMode> & { readonly mode: TMode }\n): SyncBuilder<TId, never, TMode>\nexport function defineSync<TId extends string>(\n  id: TId,\n  options: BatchSyncConfig\n): SyncBuilder<TId, never, SyncMode>\nexport function defineSync<TId extends string>(\n  id: TId,\n  options?: BatchSyncConfig\n): SyncBuilder<TId, never, SyncMode> {\n  assertNonEmpty(id, \"id\")\n\n  const config = normalizeBatchSyncConfig(options)\n  const triggers: ScheduleReference[] = []\n\n  function createBuilder<TCheckpoint>(): SyncBuilder<TId, TCheckpoint, SyncMode> {\n    const builder: SyncBuilder<TId, TCheckpoint, SyncMode> = {\n      when(schedule: ScheduleDefinition): SyncBuilder<TId, TCheckpoint, SyncMode> {\n        if (!isScheduleDefinition(schedule)) {\n          throw new SyncValidationError(\"Sync .when(...) only accepts schedules.\")\n        }\n        triggers.push({ type: \"schedule\", scheduleId: schedule.id })\n        return builder\n      },\n      checkpoint<TNextCheckpoint>(): SyncBuilder<TId, TNextCheckpoint, SyncMode> {\n        return createBuilder<TNextCheckpoint>()\n      },\n      from<TConnector extends ConnectorDefinition<string, AnyConnectorAdapter>>(\n        connector: TConnector\n      ): SyncReadBuilder<TId, TConnector, TCheckpoint, SyncMode> {\n        return {\n          read(handler): SyncTargetBuilder<TId, TConnector, TCheckpoint, SyncMode> {\n            return {\n              intoDataset(\n                dataset: DatasetDefinition\n              ): SyncDefinition<TId, TConnector, TCheckpoint, SyncMode> {\n                assertDataset(dataset, config.mode)\n\n                return {\n                  kind: \"sync\",\n                  id,\n                  config,\n                  triggers,\n                  connector,\n                  read: handler,\n                  target: {\n                    kind: \"dataset\",\n                    dataset,\n                  },\n                }\n              },\n            }\n          },\n        }\n      },\n    }\n\n    return builder\n  }\n\n  return createBuilder<never>()\n}\n",
+    "import type { AnyConnectorAdapter, ConnectorDefinition, ConnectorRuntime } from \"../connectors\"\nimport {\n  type ConnectorExecutionSource,\n  type ConnectorExecutionSourceResolver,\n  getConnectorExecutionSourceResolver,\n} from \"../connectors/execution\"\n\n/** One connector client invocation contributing values to a Sync run. */\nexport type SyncConnectorSource<TAdapter extends AnyConnectorAdapter = AnyConnectorAdapter> =\n  ConnectorExecutionSource<TAdapter>\n\nexport type SyncConnectorSourceResolver = ConnectorExecutionSourceResolver\n\n/** Resolve the source invocations owned by one connector definition for a Sync execution. */\nexport function resolveSyncConnectorSources<TAdapter extends AnyConnectorAdapter>(\n  connector: ConnectorRuntime,\n  definition: ConnectorDefinition<string, TAdapter>\n): Promise<readonly SyncConnectorSource<TAdapter>[]> {\n  return getConnectorExecutionSourceResolver(connector).list(definition)\n}\n",
+    "import { ConnectorError, createConnectorCodedError } from \"./errors\"\nimport type {\n  AnyConnectorAdapter,\n  ConnectorAdapter,\n  ConnectorDefinition,\n  OAuthConnectorAdapter,\n} from \"./types\"\nimport { isOAuthConnectorAdapter } from \"./types\"\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (!value.trim()) {\n    throw new ConnectorError(`Connector ${field} must not be empty.`)\n  }\n}\n\n/**\n * Define a connector instance for an external system.\n *\n * The returned definition is inert and can be exported from a project-level\n * `connectors/` module. Use `await sixb.connector(definition)` at runtime to\n * resolve it to a connected client.\n */\nexport function defineConnector<TId extends string, TAdapter extends OAuthConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter>\nexport function defineConnector<TId extends string, TAdapter extends ConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter>\nexport function defineConnector<TId extends string, TAdapter extends AnyConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter> {\n  assertNonEmpty(id, \"id\")\n  assertNonEmpty(adapter.type, \"type\")\n\n  if (typeof adapter.connect !== \"function\") {\n    throw new ConnectorError(\"Connector adapter connect must be a function.\")\n  }\n\n  if (adapter.authentication !== undefined) {\n    if (\n      !isOAuthConnectorAdapter(adapter) ||\n      typeof adapter.authentication.authorizationUrl !== \"function\" ||\n      typeof adapter.authentication.exchangeCode !== \"function\" ||\n      typeof adapter.authentication.refresh !== \"function\" ||\n      typeof adapter.discoverAccounts !== \"function\"\n    ) {\n      throw createConnectorCodedError(\n        \"connector.configuration_invalid\",\n        \"OAuth connector adapters must define oauth2 authentication and implement authorizationUrl, exchangeCode, refresh, and discoverAccounts.\"\n      )\n    }\n    if (adapter.webhooks !== undefined) {\n      throw createConnectorCodedError(\n        \"connector.configuration_invalid\",\n        \"OAuth connector adapters cannot register webhooks until connection routing is defined.\"\n      )\n    }\n  }\n\n  return {\n    kind: \"connector\",\n    id,\n    adapter,\n  }\n}\n",
+    "import type { BlobStorage } from \"../blob-storage\"\nimport {\n  type AnyConnectorAdapter,\n  type ConnectorAdapter,\n  type ConnectorClient,\n  type ConnectorConnectionMetadata,\n  type ConnectorDefinition,\n  isConnectorDefinition,\n  type OAuthConnectorAdapter,\n} from \"../connectors\"\nimport type { DatasetDefinition, DatasetPrimaryKey, MergeChange } from \"../datasets\"\nimport { isDatasetDefinition } from \"../datasets\"\nimport type { Logger } from \"../logging\"\nimport type { ScheduleDefinition, ScheduleReference } from \"../schedules\"\nimport { isScheduleReference } from \"../schedules\"\n\n/** Blob operations available to sync read handlers. */\nexport type SyncBlobContext = Pick<BlobStorage, \"put\" | \"open\" | \"stat\">\n\n/** Non-secret connector connection metadata available to OAuth-backed Sync handlers. */\nexport type SyncConnectorConnection = ConnectorConnectionMetadata\n\ntype SyncConnectionContext<TAdapter extends AnyConnectorAdapter> =\n  TAdapter extends OAuthConnectorAdapter\n    ? { readonly connection: SyncConnectorConnection }\n    : { readonly connection?: undefined }\n\n/** Context passed to a sync read handler. */\nexport type SyncReadContext<\n  TCheckpoint = never,\n  TAdapter extends AnyConnectorAdapter = ConnectorAdapter,\n> = {\n  readonly projectId: string\n  readonly syncId: string\n  readonly signal: AbortSignal\n  readonly blobs: SyncBlobContext\n  readonly logger: Logger\n} & ([TCheckpoint] extends [never]\n  ? { readonly checkpoint?: undefined }\n  : {\n      readonly checkpoint?: TCheckpoint\n      setCheckpoint(next: TCheckpoint): void\n    }) &\n  SyncConnectionContext<TAdapter>\n\nexport type SyncMode = \"snapshot\" | \"append\" | \"merge\"\n\ntype MergeSyncChange = MergeChange<\n  Readonly<Record<string, unknown>>,\n  Readonly<Record<string, unknown>>\n>\n\n/** A sync read handler may return one item, a sync iterable, or an async iterable. */\nexport type SyncReadResult<TMode extends SyncMode = SyncMode> = TMode extends \"merge\"\n  ? MergeSyncChange | Iterable<MergeSyncChange> | AsyncIterable<MergeSyncChange>\n  : unknown | Iterable<unknown> | AsyncIterable<unknown>\n\n/** User-facing batch sync options accepted by `defineSync(...)`. */\nexport interface BatchSyncConfig<TMode extends SyncMode = SyncMode> {\n  readonly mode?: TMode\n}\n\n/** Normalized batch sync config stored on the final sync definition. */\nexport interface BatchSyncDefinitionConfig<TMode extends SyncMode = SyncMode> {\n  readonly kind: \"batch\"\n  readonly mode: TMode\n}\n\n/** V1 syncs always target a named raw dataset. */\nexport interface DatasetSyncTarget {\n  readonly kind: \"dataset\"\n  readonly dataset: DatasetDefinition\n}\n\n/**\n * Connector-scoped read handler used by batch sync definitions.\n *\n * This intentionally uses TypeScript's method-parameter bivariance behavior so syncs with\n * different checkpoint types can still be stored as general `SyncDefinition[]` values. The\n * builder still gives users precise `context.checkpoint` and `setCheckpoint(...)` types when\n * they author a sync.\n */\nexport type SyncReadHandler<\n  TAdapter extends AnyConnectorAdapter,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> = {\n  bivarianceHack(\n    client: ConnectorClient<TAdapter>,\n    context: SyncReadContext<TCheckpoint, TAdapter>\n  ): SyncReadResult<TMode> | Promise<SyncReadResult<TMode>>\n}[\"bivarianceHack\"]\n\n/**\n * Inert sync definition registered with Sixb.\n *\n * V1 supports batch syncs only. Definitions are declarative metadata and do not\n * start any background work on their own.\n */\nexport interface SyncDefinition<\n  TId extends string = string,\n  TConnector extends ConnectorDefinition<string, AnyConnectorAdapter> = ConnectorDefinition<\n    string,\n    AnyConnectorAdapter\n  >,\n  TCheckpoint = unknown,\n  TMode extends SyncMode = SyncMode,\n> {\n  readonly kind: \"sync\"\n  readonly id: TId\n  readonly config: BatchSyncDefinitionConfig<TMode>\n  readonly triggers: readonly ScheduleReference[]\n  readonly connector: TConnector\n  readonly read: SyncReadHandler<TConnector[\"adapter\"], TCheckpoint, TMode>\n  readonly target: DatasetSyncTarget\n}\n\nexport interface SyncTargetBuilder<\n  TId extends string = string,\n  TConnector extends ConnectorDefinition<string, AnyConnectorAdapter> = ConnectorDefinition<\n    string,\n    AnyConnectorAdapter\n  >,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> {\n  intoDataset<TDataset extends DatasetDefinition>(\n    dataset: TMode extends \"merge\"\n      ? TDataset & { readonly primaryKey: DatasetPrimaryKey }\n      : TDataset\n  ): SyncDefinition<TId, TConnector, TCheckpoint, TMode>\n}\n\nexport interface SyncReadBuilder<\n  TId extends string = string,\n  TConnector extends ConnectorDefinition<string, AnyConnectorAdapter> = ConnectorDefinition<\n    string,\n    AnyConnectorAdapter\n  >,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> {\n  read(\n    handler: SyncReadHandler<TConnector[\"adapter\"], TCheckpoint, TMode>\n  ): SyncTargetBuilder<TId, TConnector, TCheckpoint, TMode>\n}\n\nexport interface SyncBuilder<\n  TId extends string = string,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> {\n  when(schedule: ScheduleDefinition): SyncBuilder<TId, TCheckpoint, TMode>\n  checkpoint<TNextCheckpoint>(): SyncBuilder<TId, TNextCheckpoint, TMode>\n  from<TConnector extends ConnectorDefinition<string, AnyConnectorAdapter>>(\n    connector: TConnector\n  ): SyncReadBuilder<TId, TConnector, TCheckpoint, TMode>\n}\n\n/** Runtime type guard for values discovered from `syncs/` modules. */\nexport function isSyncDefinition(value: unknown): value is SyncDefinition {\n  if (!isRecord(value)) {\n    return false\n  }\n\n  return (\n    value.kind === \"sync\" &&\n    typeof value.id === \"string\" &&\n    isRecord(value.config) &&\n    value.config.kind === \"batch\" &&\n    (value.config.mode === \"snapshot\" ||\n      value.config.mode === \"append\" ||\n      value.config.mode === \"merge\") &&\n    Array.isArray(value.triggers) &&\n    (value.triggers as unknown[]).every((reference) => isScheduleReference(reference)) &&\n    isConnectorDefinition(value.connector) &&\n    typeof value.read === \"function\" &&\n    isRecord(value.target) &&\n    value.target.kind === \"dataset\" &&\n    isDatasetDefinition(value.target.dataset)\n  )\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "027CA8B23EAA01DB64756E2164756E21",
+  "names": []
+}

package/dist/chunk-c8bw2b6c.js

@@ -0,0 +1,317 @@
+// @bun
+import {
+  isScheduleDefinition
+} from "./chunk-5sz8ta9r.js";
+import {
+  WorkflowDefinitionError,
+  assertNonEmpty,
+  isAgentDefinition,
+  isAgentStepDefinition,
+  isInterventionDefinition,
+  isStepDefinition
+} from "./chunk-177ed2mp.js";
+import {
+  isActionDefinition
+} from "./chunk-d6y2wsfg.js";
+import {
+  createSixbError,
+  isSixbError,
+  summarizeErrorMessage
+} from "./chunk-0172wgm9.js";
+
+// src/workflows/builders.ts
+function interventionField(schema, options) {
+  return {
+    schema,
+    required: options?.required ?? true,
+    ...options?.description !== undefined ? { description: options.description } : {}
+  };
+}
+function defineWorkflowStep(id) {
+  assertNonEmpty(id, "Step", "id");
+  return {
+    input(input) {
+      return {
+        output(output) {
+          return {
+            run(handler) {
+              return {
+                kind: "step",
+                id,
+                input,
+                output,
+                handler
+              };
+            }
+          };
+        }
+      };
+    }
+  };
+}
+function defineAgentStep(id, agent) {
+  assertNonEmpty(id, "Agent step", "id");
+  if (!isAgentDefinition(agent)) {
+    throw new WorkflowDefinitionError(`Agent step "${id}" references an invalid agent.`);
+  }
+  return {
+    input(input) {
+      return {
+        output(output) {
+          return {
+            prompt(prompt) {
+              if (typeof prompt !== "function") {
+                throw new WorkflowDefinitionError(`Agent step "${id}" prompt must be a function.`);
+              }
+              return { kind: "agentStep", id, agent, input, output, prompt };
+            }
+          };
+        }
+      };
+    }
+  };
+}
+function defineIntervention(id, options) {
+  assertNonEmpty(id, "Intervention", "id");
+  return {
+    input(input) {
+      return {
+        response(response) {
+          return createInterventionDefinition({
+            id,
+            input,
+            response,
+            description: options?.description
+          });
+        }
+      };
+    }
+  };
+}
+function defineWorkflow(id) {
+  assertNonEmpty(id, "Workflow", "id");
+  return {
+    input(input) {
+      return createWorkflowDraftBuilder(id, input);
+    }
+  };
+}
+function createWorkflowDraftBuilder(id, input) {
+  const triggers = [];
+  const nodes = [];
+  let definition = null;
+  const appendNode = (nodeDefinition, mapper, ...extraArgs) => {
+    if (extraArgs.length > 0) {
+      throw new WorkflowDefinitionError(`Invalid workflow "${id}" .then(...) call.`);
+    }
+    if (isStepDefinition(nodeDefinition)) {
+      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {
+        throw new WorkflowDefinitionError(`Invalid workflow "${id}" .then(...) call.`);
+      }
+      nodes.push(createStepNode(id, nodes, nodeDefinition, mapper));
+      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode);
+      return definition;
+    }
+    if (isAgentStepDefinition(nodeDefinition)) {
+      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {
+        throw new WorkflowDefinitionError(`Invalid workflow "${id}" .then(...) call.`);
+      }
+      nodes.push(createAgentNode(id, nodes, nodeDefinition, mapper));
+      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode);
+      return definition;
+    }
+    if (isInterventionDefinition(nodeDefinition)) {
+      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {
+        throw new WorkflowDefinitionError(`Invalid workflow "${id}" .then(...) call.`);
+      }
+      nodes.push(createInterventionNode(id, nodes, nodeDefinition, mapper));
+      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode);
+      return definition;
+    }
+    if (isActionDefinition(nodeDefinition)) {
+      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {
+        throw new WorkflowDefinitionError(`Invalid workflow "${id}" .then(...) call.`);
+      }
+      nodes.push(createActionNode(id, nodes, nodeDefinition, mapper));
+      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode);
+      return definition;
+    }
+    throw new WorkflowDefinitionError(`Invalid workflow "${id}" .then(...) call.`);
+  };
+  let draft;
+  function when(schedule, mapper, ...extraArgs) {
+    if (extraArgs.length > 0) {
+      throw new WorkflowDefinitionError(`Invalid workflow "${id}" .when(...) call.`);
+    }
+    if (isScheduleDefinition(schedule)) {
+      if (mapper !== undefined && schedule.trigger.type !== "event") {
+        throw new WorkflowDefinitionError(`Workflow "${id}" cron schedules do not accept a mapper.`);
+      }
+      if (mapper !== undefined && !isRuntimeWorkflowScheduleMapper(mapper)) {
+        throw new WorkflowDefinitionError(`Invalid workflow "${id}" .when(...) schedule mapper.`);
+      }
+      triggers.push({
+        type: "schedule",
+        scheduleId: schedule.id,
+        ...mapper !== undefined ? { mapper } : {}
+      });
+      return draft;
+    }
+    throw new WorkflowDefinitionError(`Workflow "${id}" .when(...) only accepts schedules.`);
+  }
+  draft = {
+    when,
+    then: appendNode
+  };
+  return draft;
+}
+function createWorkflowDefinition(id, input, triggers, nodes, then) {
+  return {
+    kind: "workflow",
+    id,
+    input,
+    triggers,
+    nodes,
+    then
+  };
+}
+function createStepNode(workflowId, nodes, step, mapper) {
+  const key = deriveWorkflowNodeKey(step.id);
+  assertNodeKey(workflowId, step.id, key);
+  assertUniqueNode(workflowId, nodes, step.id, key);
+  return {
+    type: "step",
+    id: step.id,
+    key,
+    step,
+    ...mapper !== undefined ? { mapper } : {}
+  };
+}
+function createAgentNode(workflowId, nodes, agentStep, mapper) {
+  const key = deriveWorkflowNodeKey(agentStep.id);
+  assertNodeKey(workflowId, agentStep.id, key);
+  assertUniqueNode(workflowId, nodes, agentStep.id, key);
+  return {
+    type: "agent",
+    id: agentStep.id,
+    key,
+    agentStep,
+    ...mapper !== undefined ? { mapper } : {}
+  };
+}
+function createInterventionDefinition(input) {
+  const base = {
+    kind: "intervention",
+    id: input.id,
+    input: input.input,
+    response: input.response,
+    ...input.description !== undefined ? { description: input.description } : {}
+  };
+  const defaults = (handlerOrContext) => {
+    if (typeof handlerOrContext === "function") {
+      return {
+        ...base,
+        defaults: handlerOrContext
+      };
+    }
+    return {};
+  };
+  Object.defineProperty(base, "defaults", {
+    value: defaults,
+    enumerable: false
+  });
+  return base;
+}
+function createActionNode(workflowId, nodes, action, mapper) {
+  const key = deriveWorkflowNodeKey(action.id);
+  assertNodeKey(workflowId, action.id, key);
+  assertUniqueNode(workflowId, nodes, action.id, key);
+  return {
+    type: "action",
+    id: action.id,
+    key,
+    action,
+    ...mapper !== undefined ? { mapper } : {}
+  };
+}
+function createInterventionNode(workflowId, nodes, intervention, mapper) {
+  const key = deriveWorkflowNodeKey(intervention.id);
+  assertNodeKey(workflowId, intervention.id, key);
+  assertUniqueNode(workflowId, nodes, intervention.id, key);
+  return {
+    type: "intervention",
+    id: intervention.id,
+    key,
+    intervention,
+    ...mapper !== undefined ? { mapper } : {}
+  };
+}
+function assertNodeKey(workflowId, nodeId, key) {
+  if (key.length === 0) {
+    throw new WorkflowDefinitionError(`Workflow "${workflowId}" node id "${nodeId}" must contain at least one letter or number.`);
+  }
+}
+function assertUniqueNode(workflowId, nodes, nodeId, key) {
+  const duplicateId = nodes.find((node) => node.id === nodeId);
+  if (duplicateId) {
+    throw new WorkflowDefinitionError(`Duplicate workflow node id "${nodeId}" in workflow "${workflowId}".`);
+  }
+  const duplicateKey = nodes.find((node) => node.key === key);
+  if (duplicateKey) {
+    throw new WorkflowDefinitionError(`Duplicate workflow node key "${key}" in workflow "${workflowId}". Node ids "${duplicateKey.id}" and "${nodeId}" derive the same key.`);
+  }
+}
+function deriveWorkflowNodeKey(id) {
+  const segments = id.trim().split(/[^A-Za-z0-9]+/).filter((segment) => segment.length > 0);
+  return segments.map((segment, index) => {
+    const normalized = uncapitalize(segment);
+    return index === 0 ? normalized : capitalize(normalized);
+  }).join("");
+}
+function uncapitalize(value) {
+  return value.length === 0 ? value : `${value[0].toLowerCase()}${value.slice(1)}`;
+}
+function capitalize(value) {
+  return value.length === 0 ? value : `${value[0].toUpperCase()}${value.slice(1)}`;
+}
+function isRuntimeWorkflowMapper(value) {
+  return typeof value === "function";
+}
+function isRuntimeWorkflowScheduleMapper(value) {
+  return typeof value === "function";
+}
+// src/workflows/failure.ts
+function createWorkflowNodeFailure(error, identity) {
+  return createSixbError("workflow.node_failed", summarizeErrorMessage(error, "Workflow node execution failed."), {
+    cause: error,
+    details: workflowNodeFailureDetails(identity)
+  });
+}
+function unwrapWorkflowNodeFailure(error) {
+  return isSixbError(error) && error.code === "workflow.node_failed" && error.cause !== undefined ? error.cause : error;
+}
+function workflowNodeFailureDetails(identity) {
+  const base = {
+    workflowId: identity.workflowId,
+    workflowRunId: identity.workflowRunId,
+    nodeId: identity.nodeId,
+    ...identity.nodeRunId ? { nodeRunId: identity.nodeRunId } : {}
+  };
+  switch (identity.child.type) {
+    case "step":
+      return { ...base, stepId: identity.child.stepId };
+    case "action":
+      return {
+        ...base,
+        actionId: identity.child.actionId,
+        ...identity.child.actionRunId ? { actionRunId: identity.child.actionRunId } : {}
+      };
+    case "agent":
+      return { ...base, agentId: identity.child.agentId };
+    case "intervention":
+      return { ...base, interventionId: identity.child.interventionId };
+  }
+}
+export { interventionField, defineWorkflowStep, defineAgentStep, defineIntervention, defineWorkflow, createWorkflowNodeFailure, unwrapWorkflowNodeFailure };
+
+//# debugId=5C2B621CC3B063C864756E2164756E21

package/dist/chunk-c8bw2b6c.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/workflows/builders.ts", "../src/workflows/failure.ts"],
+  "sourcesContent": [
+    "import type { ActionDefinition } from \"../actions\"\nimport { isActionDefinition } from \"../actions\"\nimport type { AgentDefinition } from \"../agents\"\nimport { isAgentDefinition } from \"../agents\"\nimport type { SchemaOrRef } from \"../ontology\"\nimport type { ScheduleDefinition, ScheduleDefinitionForEvent } from \"../schedules\"\nimport { isScheduleDefinition } from \"../schedules\"\nimport { WorkflowDefinitionError } from \"./errors\"\nimport type {\n  AgentStepBuilder,\n  AgentStepDefinition,\n  InterventionBuilder,\n  InterventionDefaultsRuntimeHandler,\n  InterventionDefinition,\n  InterventionFieldConfig,\n  StepBuilder,\n  StepDefinition,\n  StepHandler,\n  WorkflowBuilder,\n  WorkflowChainDefinition,\n  WorkflowNodeDefinition,\n  WorkflowScheduleMapper,\n  WorkflowTriggerDefinition,\n} from \"./types\"\nimport {\n  assertNonEmpty,\n  isAgentStepDefinition,\n  isInterventionDefinition,\n  isStepDefinition,\n} from \"./validation\"\n\ntype InterventionOptions = {\n  description?: string\n}\n\ntype RuntimeWorkflowInput = Record<string, SchemaOrRef>\ntype RuntimeWorkflowValueInput = Record<string, unknown>\ntype RuntimeWorkflowMapper = (...args: never[]) => unknown\ntype RuntimeWorkflowScheduleMapper = WorkflowScheduleMapper<unknown, RuntimeWorkflowValueInput>\ntype RuntimeWorkflowThenDefinition =\n  | StepDefinition\n  | InterventionDefinition\n  | ActionDefinition\n  | AgentStepDefinition\ntype RuntimeWorkflowThen = (\n  nodeDefinition: RuntimeWorkflowThenDefinition,\n  mapper?: RuntimeWorkflowMapper\n) => WorkflowChainDefinition\ntype RuntimeWorkflowDraftBuilder = {\n  when(schedule: ScheduleDefinition): RuntimeWorkflowDraftBuilder\n  when(\n    schedule: ScheduleDefinitionForEvent,\n    mapper: RuntimeWorkflowScheduleMapper\n  ): RuntimeWorkflowDraftBuilder\n  readonly then: RuntimeWorkflowThen\n}\n\n/**\n * See the action-param helper for why widened booleans are rejected. Optional\n * response fields must be an explicit literal decision so inference stays honest.\n */\ntype StrictBoolean<T extends boolean> = boolean extends T ? never : T\n\ntype InterventionFieldResult<TSchema extends SchemaOrRef, TRequired extends boolean> = {\n  readonly schema: TSchema\n  readonly required: TRequired\n  readonly description?: string\n}\n\nexport function interventionField<const TSchema extends SchemaOrRef>(\n  schema: TSchema\n): InterventionFieldResult<TSchema, true>\nexport function interventionField<\n  const TSchema extends SchemaOrRef,\n  const TRequired extends boolean = true,\n>(\n  schema: TSchema,\n  options: {\n    required?: StrictBoolean<TRequired>\n    description?: string\n  }\n): InterventionFieldResult<TSchema, TRequired>\nexport function interventionField(\n  schema: SchemaOrRef,\n  options?: { required?: boolean; description?: string }\n): InterventionFieldConfig {\n  return {\n    schema,\n    required: options?.required ?? true,\n    ...(options?.description !== undefined ? { description: options.description } : {}),\n  }\n}\n\nexport function defineWorkflowStep<const TId extends string>(id: TId): StepBuilder<TId> {\n  assertNonEmpty(id, \"Step\", \"id\")\n\n  return {\n    input(input: RuntimeWorkflowInput): unknown {\n      return {\n        output(output: RuntimeWorkflowInput): unknown {\n          return {\n            run(handler: StepHandler<Record<string, unknown>, Record<string, unknown>>): unknown {\n              return {\n                kind: \"step\",\n                id,\n                input,\n                output,\n                handler,\n              }\n            },\n          }\n        },\n      }\n    },\n  } as unknown as StepBuilder<TId>\n}\n\nexport function defineAgentStep<const TId extends string, const TAgent extends AgentDefinition>(\n  id: TId,\n  agent: TAgent\n): AgentStepBuilder<TId, TAgent> {\n  assertNonEmpty(id, \"Agent step\", \"id\")\n  if (!isAgentDefinition(agent)) {\n    throw new WorkflowDefinitionError(`Agent step \"${id}\" references an invalid agent.`)\n  }\n\n  return {\n    input(input: RuntimeWorkflowInput): unknown {\n      return {\n        output(output: RuntimeWorkflowInput): unknown {\n          return {\n            prompt(prompt: unknown): unknown {\n              if (typeof prompt !== \"function\") {\n                throw new WorkflowDefinitionError(`Agent step \"${id}\" prompt must be a function.`)\n              }\n              return { kind: \"agentStep\", id, agent, input, output, prompt }\n            },\n          }\n        },\n      }\n    },\n  } as unknown as AgentStepBuilder<TId, TAgent>\n}\n\nexport function defineIntervention<const TId extends string>(\n  id: TId,\n  options?: InterventionOptions\n): InterventionBuilder<TId> {\n  assertNonEmpty(id, \"Intervention\", \"id\")\n\n  return {\n    input(input: RuntimeWorkflowInput): unknown {\n      return {\n        response(response: Record<string, unknown>): unknown {\n          return createInterventionDefinition({\n            id,\n            input,\n            response,\n            description: options?.description,\n          })\n        },\n      }\n    },\n  } as unknown as InterventionBuilder<TId>\n}\n\nexport function defineWorkflow<const TId extends string>(id: TId): WorkflowBuilder<TId> {\n  assertNonEmpty(id, \"Workflow\", \"id\")\n\n  return {\n    input(input: RuntimeWorkflowInput): unknown {\n      return createWorkflowDraftBuilder(id, input)\n    },\n  } as unknown as WorkflowBuilder<TId>\n}\n\nfunction createWorkflowDraftBuilder(\n  id: string,\n  input: RuntimeWorkflowInput\n): RuntimeWorkflowDraftBuilder {\n  const triggers: WorkflowTriggerDefinition[] = []\n  const nodes: WorkflowNodeDefinition[] = []\n  let definition: WorkflowChainDefinition | null = null\n\n  const appendNode = (\n    nodeDefinition: unknown,\n    mapper?: unknown,\n    ...extraArgs: unknown[]\n  ): WorkflowChainDefinition => {\n    if (extraArgs.length > 0) {\n      throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .then(...) call.`)\n    }\n\n    if (isStepDefinition(nodeDefinition)) {\n      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {\n        throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .then(...) call.`)\n      }\n\n      nodes.push(createStepNode(id, nodes, nodeDefinition, mapper))\n      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode)\n      return definition\n    }\n\n    if (isAgentStepDefinition(nodeDefinition)) {\n      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {\n        throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .then(...) call.`)\n      }\n\n      nodes.push(createAgentNode(id, nodes, nodeDefinition, mapper))\n      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode)\n      return definition\n    }\n\n    if (isInterventionDefinition(nodeDefinition)) {\n      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {\n        throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .then(...) call.`)\n      }\n\n      nodes.push(createInterventionNode(id, nodes, nodeDefinition, mapper))\n      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode)\n      return definition\n    }\n\n    if (isActionDefinition(nodeDefinition)) {\n      if (mapper !== undefined && !isRuntimeWorkflowMapper(mapper)) {\n        throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .then(...) call.`)\n      }\n\n      nodes.push(createActionNode(id, nodes, nodeDefinition, mapper))\n      definition ??= createWorkflowDefinition(id, input, triggers, nodes, appendNode)\n      return definition\n    }\n\n    throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .then(...) call.`)\n  }\n\n  let draft: RuntimeWorkflowDraftBuilder\n\n  function when(schedule: ScheduleDefinition): RuntimeWorkflowDraftBuilder\n  function when(\n    schedule: ScheduleDefinitionForEvent,\n    mapper: RuntimeWorkflowScheduleMapper\n  ): RuntimeWorkflowDraftBuilder\n  function when(\n    schedule: unknown,\n    mapper?: unknown,\n    ...extraArgs: unknown[]\n  ): RuntimeWorkflowDraftBuilder {\n    if (extraArgs.length > 0) {\n      throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .when(...) call.`)\n    }\n\n    if (isScheduleDefinition(schedule)) {\n      if (mapper !== undefined && schedule.trigger.type !== \"event\") {\n        throw new WorkflowDefinitionError(`Workflow \"${id}\" cron schedules do not accept a mapper.`)\n      }\n      if (mapper !== undefined && !isRuntimeWorkflowScheduleMapper(mapper)) {\n        throw new WorkflowDefinitionError(`Invalid workflow \"${id}\" .when(...) schedule mapper.`)\n      }\n\n      triggers.push({\n        type: \"schedule\",\n        scheduleId: schedule.id,\n        ...(mapper !== undefined ? { mapper } : {}),\n      })\n      return draft\n    }\n\n    throw new WorkflowDefinitionError(`Workflow \"${id}\" .when(...) only accepts schedules.`)\n  }\n\n  draft = {\n    when,\n    // biome-ignore lint/suspicious/noThenProperty: Workflows intentionally expose a chainable .then(...) DSL.\n    then: appendNode,\n  }\n\n  return draft\n}\n\nfunction createWorkflowDefinition(\n  id: string,\n  input: RuntimeWorkflowInput,\n  triggers: readonly WorkflowTriggerDefinition[],\n  nodes: readonly WorkflowNodeDefinition[],\n  then: (\n    nodeDefinition: unknown,\n    mapper?: unknown,\n    ...extraArgs: unknown[]\n  ) => WorkflowChainDefinition\n): WorkflowChainDefinition {\n  return {\n    kind: \"workflow\",\n    id,\n    input,\n    triggers,\n    nodes,\n    then,\n  } as unknown as WorkflowChainDefinition\n}\n\nfunction createStepNode(\n  workflowId: string,\n  nodes: readonly WorkflowNodeDefinition[],\n  step: StepDefinition,\n  mapper: RuntimeWorkflowMapper | undefined\n): WorkflowNodeDefinition {\n  const key = deriveWorkflowNodeKey(step.id)\n  assertNodeKey(workflowId, step.id, key)\n  assertUniqueNode(workflowId, nodes, step.id, key)\n\n  return {\n    type: \"step\",\n    id: step.id,\n    key,\n    step,\n    ...(mapper !== undefined ? { mapper } : {}),\n  }\n}\n\nfunction createAgentNode(\n  workflowId: string,\n  nodes: readonly WorkflowNodeDefinition[],\n  agentStep: AgentStepDefinition,\n  mapper: RuntimeWorkflowMapper | undefined\n): WorkflowNodeDefinition {\n  const key = deriveWorkflowNodeKey(agentStep.id)\n  assertNodeKey(workflowId, agentStep.id, key)\n  assertUniqueNode(workflowId, nodes, agentStep.id, key)\n\n  return {\n    type: \"agent\",\n    id: agentStep.id,\n    key,\n    agentStep,\n    ...(mapper !== undefined ? { mapper } : {}),\n  }\n}\n\nfunction createInterventionDefinition(input: {\n  readonly id: string\n  readonly input: RuntimeWorkflowInput\n  readonly response: Record<string, unknown>\n  readonly description?: string\n}): unknown {\n  const base = {\n    kind: \"intervention\" as const,\n    id: input.id,\n    input: input.input,\n    response: input.response,\n    ...(input.description !== undefined ? { description: input.description } : {}),\n  }\n\n  const defaults = (handlerOrContext: unknown) => {\n    if (typeof handlerOrContext === \"function\") {\n      return {\n        ...base,\n        defaults: handlerOrContext as InterventionDefaultsRuntimeHandler,\n      }\n    }\n\n    // A no-defaults intervention is still usable as a definition immediately after\n    // `.response(...)`. Treating the builder method as an empty default handler keeps\n    // future executor code simple if it calls `definition.defaults?.(ctx) ?? {}`.\n    return {}\n  }\n\n  Object.defineProperty(base, \"defaults\", {\n    value: defaults,\n    enumerable: false,\n  })\n\n  return base\n}\n\nfunction createActionNode(\n  workflowId: string,\n  nodes: readonly WorkflowNodeDefinition[],\n  action: ActionDefinition,\n  mapper: RuntimeWorkflowMapper | undefined\n): WorkflowNodeDefinition {\n  const key = deriveWorkflowNodeKey(action.id)\n  assertNodeKey(workflowId, action.id, key)\n  assertUniqueNode(workflowId, nodes, action.id, key)\n\n  return {\n    type: \"action\",\n    id: action.id,\n    key,\n    action,\n    ...(mapper !== undefined ? { mapper } : {}),\n  }\n}\n\nfunction createInterventionNode(\n  workflowId: string,\n  nodes: readonly WorkflowNodeDefinition[],\n  intervention: InterventionDefinition,\n  mapper: RuntimeWorkflowMapper | undefined\n): WorkflowNodeDefinition {\n  const key = deriveWorkflowNodeKey(intervention.id)\n  assertNodeKey(workflowId, intervention.id, key)\n  assertUniqueNode(workflowId, nodes, intervention.id, key)\n\n  return {\n    type: \"intervention\",\n    id: intervention.id,\n    key,\n    intervention,\n    ...(mapper !== undefined ? { mapper } : {}),\n  } as WorkflowNodeDefinition\n}\n\nfunction assertNodeKey(workflowId: string, nodeId: string, key: string): void {\n  if (key.length === 0) {\n    throw new WorkflowDefinitionError(\n      `Workflow \"${workflowId}\" node id \"${nodeId}\" must contain at least one letter or number.`\n    )\n  }\n}\n\nfunction assertUniqueNode(\n  workflowId: string,\n  nodes: readonly WorkflowNodeDefinition[],\n  nodeId: string,\n  key: string\n): void {\n  const duplicateId = nodes.find((node) => node.id === nodeId)\n  if (duplicateId) {\n    throw new WorkflowDefinitionError(\n      `Duplicate workflow node id \"${nodeId}\" in workflow \"${workflowId}\".`\n    )\n  }\n\n  const duplicateKey = nodes.find((node) => node.key === key)\n  if (duplicateKey) {\n    throw new WorkflowDefinitionError(\n      `Duplicate workflow node key \"${key}\" in workflow \"${workflowId}\". Node ids \"${duplicateKey.id}\" and \"${nodeId}\" derive the same key.`\n    )\n  }\n}\n\nfunction deriveWorkflowNodeKey(id: string): string {\n  const segments = id\n    .trim()\n    .split(/[^A-Za-z0-9]+/)\n    .filter((segment) => segment.length > 0)\n\n  return segments\n    .map((segment, index) => {\n      const normalized = uncapitalize(segment)\n      return index === 0 ? normalized : capitalize(normalized)\n    })\n    .join(\"\")\n}\n\nfunction uncapitalize(value: string): string {\n  return value.length === 0 ? value : `${value[0].toLowerCase()}${value.slice(1)}`\n}\n\nfunction capitalize(value: string): string {\n  return value.length === 0 ? value : `${value[0].toUpperCase()}${value.slice(1)}`\n}\n\nfunction isRuntimeWorkflowMapper(value: unknown): value is RuntimeWorkflowMapper {\n  return typeof value === \"function\"\n}\n\nfunction isRuntimeWorkflowScheduleMapper(value: unknown): value is RuntimeWorkflowScheduleMapper {\n  return typeof value === \"function\"\n}\n",
+    "import { createSixbError, isSixbError, summarizeErrorMessage } from \"../errors/internal\"\n\ninterface WorkflowNodeFailureIdentityBase {\n  readonly workflowId: string\n  readonly workflowRunId: string\n  readonly nodeId: string\n  readonly nodeRunId?: string\n}\n\nexport interface WorkflowNodeFailureIdentity extends WorkflowNodeFailureIdentityBase {\n  readonly child:\n    | { readonly type: \"step\"; readonly stepId: string }\n    | {\n        readonly type: \"action\"\n        readonly actionId: string\n        readonly actionRunId?: string\n      }\n    | { readonly type: \"agent\"; readonly agentId: string }\n    | { readonly type: \"intervention\"; readonly interventionId: string }\n}\n\n/** Translate a node-local failure into the workflow primitive's durable vocabulary. */\nexport function createWorkflowNodeFailure(error: unknown, identity: WorkflowNodeFailureIdentity) {\n  return createSixbError(\n    \"workflow.node_failed\",\n    summarizeErrorMessage(error, \"Workflow node execution failed.\"),\n    {\n      cause: error,\n      details: workflowNodeFailureDetails(identity),\n    }\n  )\n}\n\n/** Recover the native child error for direct callers and error-monitoring integrations. */\nexport function unwrapWorkflowNodeFailure(error: unknown): unknown {\n  return isSixbError(error) && error.code === \"workflow.node_failed\" && error.cause !== undefined\n    ? error.cause\n    : error\n}\n\nfunction workflowNodeFailureDetails(identity: WorkflowNodeFailureIdentity) {\n  const base = {\n    workflowId: identity.workflowId,\n    workflowRunId: identity.workflowRunId,\n    nodeId: identity.nodeId,\n    ...(identity.nodeRunId ? { nodeRunId: identity.nodeRunId } : {}),\n  }\n\n  switch (identity.child.type) {\n    case \"step\":\n      return { ...base, stepId: identity.child.stepId }\n    case \"action\":\n      return {\n        ...base,\n        actionId: identity.child.actionId,\n        ...(identity.child.actionRunId ? { actionRunId: identity.child.actionRunId } : {}),\n      }\n    case \"agent\":\n      return { ...base, agentId: identity.child.agentId }\n    case \"intervention\":\n      return { ...base, interventionId: identity.child.interventionId }\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAkFO,SAAS,iBAAiB,CAC/B,QACA,SACyB;AAAA,EACzB,OAAO;AAAA,IACL;AAAA,IACA,UAAU,SAAS,YAAY;AAAA,OAC3B,SAAS,gBAAgB,YAAY,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,EACnF;AAAA;AAGK,SAAS,kBAA4C,CAAC,IAA2B;AAAA,EACtF,eAAe,IAAI,QAAQ,IAAI;AAAA,EAE/B,OAAO;AAAA,IACL,KAAK,CAAC,OAAsC;AAAA,MAC1C,OAAO;AAAA,QACL,MAAM,CAAC,QAAuC;AAAA,UAC5C,OAAO;AAAA,YACL,GAAG,CAAC,SAAiF;AAAA,cACnF,OAAO;AAAA,gBACL,MAAM;AAAA,gBACN;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,cACF;AAAA;AAAA,UAEJ;AAAA;AAAA,MAEJ;AAAA;AAAA,EAEJ;AAAA;AAGK,SAAS,eAA+E,CAC7F,IACA,OAC+B;AAAA,EAC/B,eAAe,IAAI,cAAc,IAAI;AAAA,EACrC,IAAI,CAAC,kBAAkB,KAAK,GAAG;AAAA,IAC7B,MAAM,IAAI,wBAAwB,eAAe,kCAAkC;AAAA,EACrF;AAAA,EAEA,OAAO;AAAA,IACL,KAAK,CAAC,OAAsC;AAAA,MAC1C,OAAO;AAAA,QACL,MAAM,CAAC,QAAuC;AAAA,UAC5C,OAAO;AAAA,YACL,MAAM,CAAC,QAA0B;AAAA,cAC/B,IAAI,OAAO,WAAW,YAAY;AAAA,gBAChC,MAAM,IAAI,wBAAwB,eAAe,gCAAgC;AAAA,cACnF;AAAA,cACA,OAAO,EAAE,MAAM,aAAa,IAAI,OAAO,OAAO,QAAQ,OAAO;AAAA;AAAA,UAEjE;AAAA;AAAA,MAEJ;AAAA;AAAA,EAEJ;AAAA;AAGK,SAAS,kBAA4C,CAC1D,IACA,SAC0B;AAAA,EAC1B,eAAe,IAAI,gBAAgB,IAAI;AAAA,EAEvC,OAAO;AAAA,IACL,KAAK,CAAC,OAAsC;AAAA,MAC1C,OAAO;AAAA,QACL,QAAQ,CAAC,UAA4C;AAAA,UACnD,OAAO,6BAA6B;AAAA,YAClC;AAAA,YACA;AAAA,YACA;AAAA,YACA,aAAa,SAAS;AAAA,UACxB,CAAC;AAAA;AAAA,MAEL;AAAA;AAAA,EAEJ;AAAA;AAGK,SAAS,cAAwC,CAAC,IAA+B;AAAA,EACtF,eAAe,IAAI,YAAY,IAAI;AAAA,EAEnC,OAAO;AAAA,IACL,KAAK,CAAC,OAAsC;AAAA,MAC1C,OAAO,2BAA2B,IAAI,KAAK;AAAA;AAAA,EAE/C;AAAA;AAGF,SAAS,0BAA0B,CACjC,IACA,OAC6B;AAAA,EAC7B,MAAM,WAAwC,CAAC;AAAA,EAC/C,MAAM,QAAkC,CAAC;AAAA,EACzC,IAAI,aAA6C;AAAA,EAEjD,MAAM,aAAa,CACjB,gBACA,WACG,cACyB;AAAA,IAC5B,IAAI,UAAU,SAAS,GAAG;AAAA,MACxB,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA,IAC/E;AAAA,IAEA,IAAI,iBAAiB,cAAc,GAAG;AAAA,MACpC,IAAI,WAAW,aAAa,CAAC,wBAAwB,MAAM,GAAG;AAAA,QAC5D,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA,MAC/E;AAAA,MAEA,MAAM,KAAK,eAAe,IAAI,OAAO,gBAAgB,MAAM,CAAC;AAAA,MAC5D,eAAe,yBAAyB,IAAI,OAAO,UAAU,OAAO,UAAU;AAAA,MAC9E,OAAO;AAAA,IACT;AAAA,IAEA,IAAI,sBAAsB,cAAc,GAAG;AAAA,MACzC,IAAI,WAAW,aAAa,CAAC,wBAAwB,MAAM,GAAG;AAAA,QAC5D,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA,MAC/E;AAAA,MAEA,MAAM,KAAK,gBAAgB,IAAI,OAAO,gBAAgB,MAAM,CAAC;AAAA,MAC7D,eAAe,yBAAyB,IAAI,OAAO,UAAU,OAAO,UAAU;AAAA,MAC9E,OAAO;AAAA,IACT;AAAA,IAEA,IAAI,yBAAyB,cAAc,GAAG;AAAA,MAC5C,IAAI,WAAW,aAAa,CAAC,wBAAwB,MAAM,GAAG;AAAA,QAC5D,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA,MAC/E;AAAA,MAEA,MAAM,KAAK,uBAAuB,IAAI,OAAO,gBAAgB,MAAM,CAAC;AAAA,MACpE,eAAe,yBAAyB,IAAI,OAAO,UAAU,OAAO,UAAU;AAAA,MAC9E,OAAO;AAAA,IACT;AAAA,IAEA,IAAI,mBAAmB,cAAc,GAAG;AAAA,MACtC,IAAI,WAAW,aAAa,CAAC,wBAAwB,MAAM,GAAG;AAAA,QAC5D,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA,MAC/E;AAAA,MAEA,MAAM,KAAK,iBAAiB,IAAI,OAAO,gBAAgB,MAAM,CAAC;AAAA,MAC9D,eAAe,yBAAyB,IAAI,OAAO,UAAU,OAAO,UAAU;AAAA,MAC9E,OAAO;AAAA,IACT;AAAA,IAEA,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA;AAAA,EAG/E,IAAI;AAAA,EAOJ,SAAS,IAAI,CACX,UACA,WACG,WAC0B;AAAA,IAC7B,IAAI,UAAU,SAAS,GAAG;AAAA,MACxB,MAAM,IAAI,wBAAwB,qBAAqB,sBAAsB;AAAA,IAC/E;AAAA,IAEA,IAAI,qBAAqB,QAAQ,GAAG;AAAA,MAClC,IAAI,WAAW,aAAa,SAAS,QAAQ,SAAS,SAAS;AAAA,QAC7D,MAAM,IAAI,wBAAwB,aAAa,4CAA4C;AAAA,MAC7F;AAAA,MACA,IAAI,WAAW,aAAa,CAAC,gCAAgC,MAAM,GAAG;AAAA,QACpE,MAAM,IAAI,wBAAwB,qBAAqB,iCAAiC;AAAA,MAC1F;AAAA,MAEA,SAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,YAAY,SAAS;AAAA,WACjB,WAAW,YAAY,EAAE,OAAO,IAAI,CAAC;AAAA,MAC3C,CAAC;AAAA,MACD,OAAO;AAAA,IACT;AAAA,IAEA,MAAM,IAAI,wBAAwB,aAAa,wCAAwC;AAAA;AAAA,EAGzF,QAAQ;AAAA,IACN;AAAA,IAEA,MAAM;AAAA,EACR;AAAA,EAEA,OAAO;AAAA;AAGT,SAAS,wBAAwB,CAC/B,IACA,OACA,UACA,OACA,MAKyB;AAAA,EACzB,OAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA;AAGF,SAAS,cAAc,CACrB,YACA,OACA,MACA,QACwB;AAAA,EACxB,MAAM,MAAM,sBAAsB,KAAK,EAAE;AAAA,EACzC,cAAc,YAAY,KAAK,IAAI,GAAG;AAAA,EACtC,iBAAiB,YAAY,OAAO,KAAK,IAAI,GAAG;AAAA,EAEhD,OAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,KAAK;AAAA,IACT;AAAA,IACA;AAAA,OACI,WAAW,YAAY,EAAE,OAAO,IAAI,CAAC;AAAA,EAC3C;AAAA;AAGF,SAAS,eAAe,CACtB,YACA,OACA,WACA,QACwB;AAAA,EACxB,MAAM,MAAM,sBAAsB,UAAU,EAAE;AAAA,EAC9C,cAAc,YAAY,UAAU,IAAI,GAAG;AAAA,EAC3C,iBAAiB,YAAY,OAAO,UAAU,IAAI,GAAG;AAAA,EAErD,OAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,UAAU;AAAA,IACd;AAAA,IACA;AAAA,OACI,WAAW,YAAY,EAAE,OAAO,IAAI,CAAC;AAAA,EAC3C;AAAA;AAGF,SAAS,4BAA4B,CAAC,OAK1B;AAAA,EACV,MAAM,OAAO;AAAA,IACX,MAAM;AAAA,IACN,IAAI,MAAM;AAAA,IACV,OAAO,MAAM;AAAA,IACb,UAAU,MAAM;AAAA,OACZ,MAAM,gBAAgB,YAAY,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,EAC9E;AAAA,EAEA,MAAM,WAAW,CAAC,qBAA8B;AAAA,IAC9C,IAAI,OAAO,qBAAqB,YAAY;AAAA,MAC1C,OAAO;AAAA,WACF;AAAA,QACH,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,IAKA,OAAO,CAAC;AAAA;AAAA,EAGV,OAAO,eAAe,MAAM,YAAY;AAAA,IACtC,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AAAA,EAED,OAAO;AAAA;AAGT,SAAS,gBAAgB,CACvB,YACA,OACA,QACA,QACwB;AAAA,EACxB,MAAM,MAAM,sBAAsB,OAAO,EAAE;AAAA,EAC3C,cAAc,YAAY,OAAO,IAAI,GAAG;AAAA,EACxC,iBAAiB,YAAY,OAAO,OAAO,IAAI,GAAG;AAAA,EAElD,OAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,OAAO;AAAA,IACX;AAAA,IACA;AAAA,OACI,WAAW,YAAY,EAAE,OAAO,IAAI,CAAC;AAAA,EAC3C;AAAA;AAGF,SAAS,sBAAsB,CAC7B,YACA,OACA,cACA,QACwB;AAAA,EACxB,MAAM,MAAM,sBAAsB,aAAa,EAAE;AAAA,EACjD,cAAc,YAAY,aAAa,IAAI,GAAG;AAAA,EAC9C,iBAAiB,YAAY,OAAO,aAAa,IAAI,GAAG;AAAA,EAExD,OAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,aAAa;AAAA,IACjB;AAAA,IACA;AAAA,OACI,WAAW,YAAY,EAAE,OAAO,IAAI,CAAC;AAAA,EAC3C;AAAA;AAGF,SAAS,aAAa,CAAC,YAAoB,QAAgB,KAAmB;AAAA,EAC5E,IAAI,IAAI,WAAW,GAAG;AAAA,IACpB,MAAM,IAAI,wBACR,aAAa,wBAAwB,qDACvC;AAAA,EACF;AAAA;AAGF,SAAS,gBAAgB,CACvB,YACA,OACA,QACA,KACM;AAAA,EACN,MAAM,cAAc,MAAM,KAAK,CAAC,SAAS,KAAK,OAAO,MAAM;AAAA,EAC3D,IAAI,aAAa;AAAA,IACf,MAAM,IAAI,wBACR,+BAA+B,wBAAwB,cACzD;AAAA,EACF;AAAA,EAEA,MAAM,eAAe,MAAM,KAAK,CAAC,SAAS,KAAK,QAAQ,GAAG;AAAA,EAC1D,IAAI,cAAc;AAAA,IAChB,MAAM,IAAI,wBACR,gCAAgC,qBAAqB,0BAA0B,aAAa,YAAY,8BAC1G;AAAA,EACF;AAAA;AAGF,SAAS,qBAAqB,CAAC,IAAoB;AAAA,EACjD,MAAM,WAAW,GACd,KAAK,EACL,MAAM,eAAe,EACrB,OAAO,CAAC,YAAY,QAAQ,SAAS,CAAC;AAAA,EAEzC,OAAO,SACJ,IAAI,CAAC,SAAS,UAAU;AAAA,IACvB,MAAM,aAAa,aAAa,OAAO;AAAA,IACvC,OAAO,UAAU,IAAI,aAAa,WAAW,UAAU;AAAA,GACxD,EACA,KAAK,EAAE;AAAA;AAGZ,SAAS,YAAY,CAAC,OAAuB;AAAA,EAC3C,OAAO,MAAM,WAAW,IAAI,QAAQ,GAAG,MAAM,GAAG,YAAY,IAAI,MAAM,MAAM,CAAC;AAAA;AAG/E,SAAS,UAAU,CAAC,OAAuB;AAAA,EACzC,OAAO,MAAM,WAAW,IAAI,QAAQ,GAAG,MAAM,GAAG,YAAY,IAAI,MAAM,MAAM,CAAC;AAAA;AAG/E,SAAS,uBAAuB,CAAC,OAAgD;AAAA,EAC/E,OAAO,OAAO,UAAU;AAAA;AAG1B,SAAS,+BAA+B,CAAC,OAAwD;AAAA,EAC/F,OAAO,OAAO,UAAU;AAAA;;AC/bnB,SAAS,yBAAyB,CAAC,OAAgB,UAAuC;AAAA,EAC/F,OAAO,gBACL,wBACA,sBAAsB,OAAO,iCAAiC,GAC9D;AAAA,IACE,OAAO;AAAA,IACP,SAAS,2BAA2B,QAAQ;AAAA,EAC9C,CACF;AAAA;AAIK,SAAS,yBAAyB,CAAC,OAAyB;AAAA,EACjE,OAAO,YAAY,KAAK,KAAK,MAAM,SAAS,0BAA0B,MAAM,UAAU,YAClF,MAAM,QACN;AAAA;AAGN,SAAS,0BAA0B,CAAC,UAAuC;AAAA,EACzE,MAAM,OAAO;AAAA,IACX,YAAY,SAAS;AAAA,IACrB,eAAe,SAAS;AAAA,IACxB,QAAQ,SAAS;AAAA,OACb,SAAS,YAAY,EAAE,WAAW,SAAS,UAAU,IAAI,CAAC;AAAA,EAChE;AAAA,EAEA,QAAQ,SAAS,MAAM;AAAA,SAChB;AAAA,MACH,OAAO,KAAK,MAAM,QAAQ,SAAS,MAAM,OAAO;AAAA,SAC7C;AAAA,MACH,OAAO;AAAA,WACF;AAAA,QACH,UAAU,SAAS,MAAM;AAAA,WACrB,SAAS,MAAM,cAAc,EAAE,aAAa,SAAS,MAAM,YAAY,IAAI,CAAC;AAAA,MAClF;AAAA,SACG;AAAA,MACH,OAAO,KAAK,MAAM,SAAS,SAAS,MAAM,QAAQ;AAAA,SAC/C;AAAA,MACH,OAAO,KAAK,MAAM,gBAAgB,SAAS,MAAM,eAAe;AAAA;AAAA;",
+  "debugId": "5C2B621CC3B063C864756E2164756E21",
+  "names": []
+}

package/dist/{chunk-qzyemcj7.js → chunk-ckxfnx7f.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   getDatasetRowValidationError
-} from "./chunk-r82k4z7z.js";
+} from "./chunk-a31h57d5.js";
 import {
   isPlainRecord
-} from "./chunk-be9vm29v.js";
+} from "./chunk-t8t39h7v.js";
 
 // src/lake-storage/errors.ts
 class LakeStorageError extends Error {

package/dist/chunk-cy0n5dms.js

@@ -0,0 +1,27 @@
+// @bun
+import {
+  findPrimitiveRunExecution
+} from "./chunk-t9xghkva.js";
+
+// src/storage/pipeline-runs/errors.ts
+class PipelineRunError extends Error {
+  name = "PipelineRunError";
+}
+
+// src/storage/pipeline-runs/provider.ts
+async function assertPipelineRunExecution(input) {
+  const execution = await findPrimitiveRunExecution({
+    executions: input.executions,
+    projectId: input.projectId,
+    executionId: input.executionId,
+    primitive: { kind: "pipeline", id: input.pipelineId, runId: input.runId },
+    sourceTypes: ["execution", "schedule", "event"]
+  });
+  if (!execution) {
+    throw new PipelineRunError(`[Sixb] Execution '${input.executionId}' does not authorize Pipeline run '${input.runId}'.`);
+  }
+}
+
+export { PipelineRunError, assertPipelineRunExecution };
+
+//# debugId=229A2187E5A0949E64756E2164756E21

package/dist/chunk-cy0n5dms.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/storage/pipeline-runs/errors.ts", "../src/storage/pipeline-runs/provider.ts"],
+  "sourcesContent": [
+    "/**\n * Base error for pipeline-run storage operations.\n */\nexport class PipelineRunError extends Error {\n  readonly name = \"PipelineRunError\"\n}\n",
+    "import type { ExecutionStorage } from \"../executions\"\nimport { findPrimitiveRunExecution } from \"../executions/run-link\"\nimport { PipelineRunError } from \"./errors\"\n\n/** Validate the semantic link between a durable Pipeline run and its immutable execution. */\nexport async function assertPipelineRunExecution(input: {\n  readonly executions: ExecutionStorage\n  readonly projectId: string\n  readonly executionId: string\n  readonly runId: string\n  readonly pipelineId: string\n}): Promise<void> {\n  const execution = await findPrimitiveRunExecution({\n    executions: input.executions,\n    projectId: input.projectId,\n    executionId: input.executionId,\n    primitive: { kind: \"pipeline\", id: input.pipelineId, runId: input.runId },\n    sourceTypes: [\"execution\", \"schedule\", \"event\"],\n  })\n  if (!execution) {\n    throw new PipelineRunError(\n      `[Sixb] Execution '${input.executionId}' does not authorize Pipeline run '${input.runId}'.`\n    )\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;AAGO,MAAM,yBAAyB,MAAM;AAAA,EACjC,OAAO;AAClB;;;ACAA,eAAsB,0BAA0B,CAAC,OAM/B;AAAA,EAChB,MAAM,YAAY,MAAM,0BAA0B;AAAA,IAChD,YAAY,MAAM;AAAA,IAClB,WAAW,MAAM;AAAA,IACjB,aAAa,MAAM;AAAA,IACnB,WAAW,EAAE,MAAM,YAAY,IAAI,MAAM,YAAY,OAAO,MAAM,MAAM;AAAA,IACxE,aAAa,CAAC,aAAa,YAAY,OAAO;AAAA,EAChD,CAAC;AAAA,EACD,IAAI,CAAC,WAAW;AAAA,IACd,MAAM,IAAI,iBACR,qBAAqB,MAAM,iDAAiD,MAAM,SACpF;AAAA,EACF;AAAA;",
+  "debugId": "229A2187E5A0949E64756E2164756E21",
+  "names": []
+}