@sixb/core 0.1.0 → 0.1.2

package/dist/chunk-0k4avqr2.js

@@ -0,0 +1,317 @@
+// @bun
+import {
+  isScheduleDefinition
+} from "./chunk-5sz8ta9r.js";
+import {
+  WorkflowDefinitionError,
+  assertNonEmpty,
+  isAgentDefinition,
+  isAgentStepDefinition,
+  isInterventionDefinition,
+  isStepDefinition
+} from "./chunk-0mbx247x.js";
+import {
+  isActionDefinition
+} from "./chunk-c6qd89g5.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-0k4avqr2.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": "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",
+  "debugId": "5C2B621CC3B063C864756E2164756E21",
+  "names": []
+}