@pasko70/pibo 3.2.7 → 3.4.0

package/packages/workflows/dist/runtime/edge-transfer.js

@@ -0,0 +1,356 @@
+import { resolveWorkflowAdapter } from "../registry/index.js";
+import { validateNodeOutput, validateWorkflowEdgeAdapterOutput, validateWorkflowPortValue, } from "../validation/index.js";
+import { createWorkflowRunWithoutLocalState } from "./state.js";
+import { createWorkflowRuntimeId as createId } from "./ids.js";
+import { emitWorkflowRuntimeEvent, persistWorkflowEdgeTransfer, persistWorkflowRun, } from "./persistence.js";
+import { createTimestampFactory } from "./time.js";
+export function transferWorkflowEdgeData(definition, run, edgeId, sourceNodeAttempt, options = {}) {
+    const timestamp = createTimestampFactory(options.now);
+    const edge = definition.edges[edgeId];
+    if (!edge) {
+        return edgeTransferFailure([
+            {
+                code: "WorkflowRuntimeError.unknownEdge",
+                message: `Workflow edge '${edgeId}' does not exist, so no payload can be transferred.`,
+                severity: "error",
+                edgeId,
+                path: `$.edges.${edgeId}`,
+                hint: "Evaluate and transfer only edges declared in the workflow definition.",
+            },
+        ], {
+            code: "WorkflowRuntimeError.unknownEdge",
+            message: "Workflow edge data transfer failed because the edge is not declared.",
+        });
+    }
+    const diagnostics = [];
+    const sourceNode = definition.nodes[edge.from.nodeId];
+    const targetNode = definition.nodes[edge.to.nodeId];
+    if (!sourceNode) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownSourceNode",
+            message: `Workflow edge '${edgeId}' references missing source node '${edge.from.nodeId}'.`,
+            severity: "error",
+            edgeId,
+            nodeId: edge.from.nodeId,
+            path: `$.edges.${edgeId}.from.nodeId`,
+        });
+    }
+    if (!targetNode) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownTargetNode",
+            message: `Workflow edge '${edgeId}' references missing target node '${edge.to.nodeId}'.`,
+            severity: "error",
+            edgeId,
+            nodeId: edge.to.nodeId,
+            path: `$.edges.${edgeId}.to.nodeId`,
+        });
+    }
+    if ((edge.kind ?? "data") !== "data") {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.nonDataEdgeTransferUnsupported",
+            message: `Workflow edge '${edgeId}' is not a data edge and cannot transfer a direct payload.`,
+            severity: "error",
+            edgeId,
+            path: `$.edges.${edgeId}.kind`,
+            hint: "Use data edges for payload transfer; control, error, and resume routing are handled by later runtime paths.",
+        });
+    }
+    if (edge.adapter) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.edgeAdapterTransferUnsupported",
+            message: `Workflow edge '${edgeId}' uses an edge adapter, which is not available in direct edge data transfer yet.`,
+            severity: "error",
+            edgeId,
+            path: `$.edges.${edgeId}.adapter`,
+            hint: "Use direct compatible ports until registered adapter resolution is implemented.",
+        });
+    }
+    if (sourceNodeAttempt.workflowRunId !== run.id) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceAttemptRunMismatch",
+            message: `Source node attempt '${sourceNodeAttempt.id}' belongs to a different workflow run.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.workflowRunId",
+            hint: "Transfer edge payloads only from attempts created for the same workflow run.",
+        });
+    }
+    if (sourceNodeAttempt.nodeId !== edge.from.nodeId) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceAttemptNodeMismatch",
+            message: `Source node attempt '${sourceNodeAttempt.id}' does not match edge source node '${edge.from.nodeId}'.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.nodeId",
+            hint: "Use the completed attempt for the edge source node when transferring data.",
+        });
+    }
+    if (sourceNodeAttempt.status !== "completed") {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceAttemptIncomplete",
+            message: `Source node attempt '${sourceNodeAttempt.id}' must be completed before edge data can transfer.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.status",
+            hint: "Transfer edge payloads only after a source node attempt completes successfully.",
+        });
+    }
+    if (!Object.hasOwn(sourceNodeAttempt, "output")) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceOutputMissing",
+            message: `Source node attempt '${sourceNodeAttempt.id}' has no output to transfer.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.output",
+            hint: "Persist or pass the source node output before evaluating outgoing data edges.",
+        });
+    }
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return edgeTransferFailure(diagnostics, {
+            code: "WorkflowRuntimeError.edgeTransferFailed",
+            message: "Workflow edge data transfer failed before payload validation.",
+        });
+    }
+    const payload = sourceNodeAttempt.output;
+    const sourceOutputResult = validateNodeOutput(definition, edge.from.nodeId, payload, {
+        path: `$.edges.${edgeId}.payload`,
+    });
+    diagnostics.push(...sourceOutputResult.diagnostics.map((diagnostic) => ({
+        ...diagnostic,
+        edgeId,
+    })));
+    if (targetNode?.input) {
+        diagnostics.push(...validateWorkflowPortValue(targetNode.input, payload, {
+            path: `$.edges.${edgeId}.targetInput`,
+        }).diagnostics.map((diagnostic) => ({
+            ...diagnostic,
+            edgeId,
+            nodeId: edge.to.nodeId,
+        })));
+    }
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return edgeTransferFailure(diagnostics, {
+            code: "WorkflowRuntimeError.invalidEdgePayload",
+            message: "Workflow edge payload failed source output or target input validation.",
+        });
+    }
+    const transfer = {
+        id: options.createEdgeTransferId?.() ?? createId("wet"),
+        workflowRunId: run.id,
+        edgeId,
+        sourceNodeAttemptId: sourceNodeAttempt.id,
+        targetNodeId: edge.to.nodeId,
+        status: "transferred",
+        payload,
+        createdAt: timestamp(),
+    };
+    return { ok: true, transfer, targetInput: payload, diagnostics };
+}
+export async function transferWorkflowEdgeAdapterData(definition, run, edgeId, sourceNodeAttempt, options) {
+    const timestamp = createTimestampFactory(options.now);
+    const edge = definition.edges[edgeId];
+    if (!edge) {
+        return edgeTransferFailure([
+            {
+                code: "WorkflowRuntimeError.unknownEdge",
+                message: `Workflow edge '${edgeId}' does not exist, so no adapted payload can be transferred.`,
+                severity: "error",
+                edgeId,
+                path: `$.edges.${edgeId}`,
+                hint: "Evaluate and transfer only edges declared in the workflow definition.",
+            },
+        ], {
+            code: "WorkflowRuntimeError.unknownEdge",
+            message: "Workflow edge adapter transfer failed because the edge is not declared.",
+        });
+    }
+    const diagnostics = [];
+    const sourceNode = definition.nodes[edge.from.nodeId];
+    const targetNode = definition.nodes[edge.to.nodeId];
+    if (!sourceNode) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownSourceNode",
+            message: `Workflow edge '${edgeId}' references missing source node '${edge.from.nodeId}'.`,
+            severity: "error",
+            edgeId,
+            nodeId: edge.from.nodeId,
+            path: `$.edges.${edgeId}.from.nodeId`,
+        });
+    }
+    if (!targetNode) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownTargetNode",
+            message: `Workflow edge '${edgeId}' references missing target node '${edge.to.nodeId}'.`,
+            severity: "error",
+            edgeId,
+            nodeId: edge.to.nodeId,
+            path: `$.edges.${edgeId}.to.nodeId`,
+        });
+    }
+    if ((edge.kind ?? "data") !== "data") {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.nonDataEdgeTransferUnsupported",
+            message: `Workflow edge '${edgeId}' is not a data edge and cannot transfer an adapted payload.`,
+            severity: "error",
+            edgeId,
+            path: `$.edges.${edgeId}.kind`,
+            hint: "Use data edges for adapter payload transfer; control, error, and resume routing are handled by later runtime paths.",
+        });
+    }
+    if (!edge.adapter) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.edgeAdapterRequired",
+            message: `Workflow edge '${edgeId}' does not declare an edge adapter for adapted transfer.`,
+            severity: "error",
+            edgeId,
+            path: `$.edges.${edgeId}.adapter`,
+            hint: "Use transferWorkflowEdgeData for direct compatible edges, or declare edgeAdapter(adapterRef(...), outputPort).",
+        });
+    }
+    if (sourceNodeAttempt.workflowRunId !== run.id) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceAttemptRunMismatch",
+            message: `Source node attempt '${sourceNodeAttempt.id}' belongs to a different workflow run.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.workflowRunId",
+            hint: "Transfer edge payloads only from attempts created for the same workflow run.",
+        });
+    }
+    if (sourceNodeAttempt.nodeId !== edge.from.nodeId) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceAttemptNodeMismatch",
+            message: `Source node attempt '${sourceNodeAttempt.id}' does not match edge source node '${edge.from.nodeId}'.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.nodeId",
+            hint: "Use the completed attempt for the edge source node when transferring data.",
+        });
+    }
+    if (sourceNodeAttempt.status !== "completed") {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceAttemptIncomplete",
+            message: `Source node attempt '${sourceNodeAttempt.id}' must be completed before edge adapter data can transfer.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.status",
+            hint: "Transfer edge payloads only after a source node attempt completes successfully.",
+        });
+    }
+    if (!Object.hasOwn(sourceNodeAttempt, "output")) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.sourceOutputMissing",
+            message: `Source node attempt '${sourceNodeAttempt.id}' has no output to adapt.`,
+            severity: "error",
+            edgeId,
+            nodeId: sourceNodeAttempt.nodeId,
+            path: "$.sourceNodeAttempt.output",
+            hint: "Persist or pass the source node output before evaluating outgoing adapter edges.",
+        });
+    }
+    const adapter = edge.adapter
+        ? resolveWorkflowAdapter(options.registry, edge.adapter.transform)
+        : undefined;
+    if (edge.adapter && !adapter) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownAdapterRef",
+            message: `Workflow edge '${edgeId}' references adapter '${edge.adapter.transform.id}', but it is not registered in the Workflow Registry.`,
+            severity: "error",
+            edgeId,
+            path: `$.edges.${edgeId}.adapter.transform.id`,
+            hint: "Register the adapter before executing adapted edge transfers.",
+        });
+    }
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return edgeTransferFailure(diagnostics, {
+            code: "WorkflowRuntimeError.edgeAdapterTransferFailed",
+            message: "Workflow edge adapter transfer failed before adapter execution.",
+        });
+    }
+    const payload = sourceNodeAttempt.output;
+    const sourceOutputResult = validateNodeOutput(definition, edge.from.nodeId, payload, {
+        path: `$.edges.${edgeId}.payload`,
+    });
+    diagnostics.push(...sourceOutputResult.diagnostics.map((diagnostic) => ({
+        ...diagnostic,
+        edgeId,
+    })));
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return edgeTransferFailure(diagnostics, {
+            code: "WorkflowRuntimeError.invalidEdgePayload",
+            message: "Workflow edge adapter input failed source output validation.",
+        });
+    }
+    let adaptedOutput;
+    try {
+        const adapterResult = await adapter.value({
+            input: payload,
+            edge,
+            run: createWorkflowRunWithoutLocalState(run),
+        });
+        adaptedOutput = adapterResult.output;
+    }
+    catch (caught) {
+        return edgeTransferFailure(diagnostics, adapterErrorSummaryFromCaught(caught));
+    }
+    const adapterOutputResult = validateWorkflowEdgeAdapterOutput(definition, edgeId, adaptedOutput);
+    diagnostics.push(...adapterOutputResult.diagnostics);
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return edgeTransferFailure(diagnostics, {
+            code: "WorkflowRuntimeError.invalidAdapterOutput",
+            message: "Workflow edge adapter output failed validation before target node execution.",
+        });
+    }
+    const transfer = {
+        id: options.createEdgeTransferId?.() ?? createId("wet"),
+        workflowRunId: run.id,
+        edgeId,
+        sourceNodeAttemptId: sourceNodeAttempt.id,
+        targetNodeId: edge.to.nodeId,
+        status: "transferred",
+        payload: adaptedOutput,
+        createdAt: timestamp(),
+    };
+    return { ok: true, transfer, targetInput: adaptedOutput, diagnostics };
+}
+export async function recordWorkflowEdgeTransfer(definition, run, edgeId, sourceNodeAttempt, options = {}) {
+    const events = options.events ?? [];
+    const result = transferWorkflowEdgeData(definition, run, edgeId, sourceNodeAttempt, options);
+    if (!result.ok) {
+        return { ...result, run, events };
+    }
+    run.current = { edgeId, status: run.status };
+    run.updatedAt = result.transfer.createdAt;
+    await persistWorkflowEdgeTransfer(options.store, result.transfer);
+    await emitWorkflowRuntimeEvent(events, options.store, options.emitEvent, {
+        type: "edge.transferred",
+        runId: run.id,
+        edgeTransferId: result.transfer.id,
+        edgeId,
+    });
+    await persistWorkflowRun(options.store, run);
+    return { ...result, run, events };
+}
+function edgeTransferFailure(diagnostics, error) {
+    return { ok: false, diagnostics, error };
+}
+function adapterErrorSummaryFromCaught(caught) {
+    if (caught instanceof Error) {
+        return {
+            code: "WorkflowRuntimeError.adapterFailed",
+            message: caught.message,
+        };
+    }
+    return {
+        code: "WorkflowRuntimeError.adapterFailed",
+        message: "Workflow adapter failed with a non-Error value.",
+    };
+}
+//# sourceMappingURL=edge-transfer.js.map

package/packages/workflows/dist/runtime/edge-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-transfer.js","sourceRoot":"","sources":["../../src/runtime/edge-transfer.ts"],"names":[],"mappings":"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"}

package/packages/workflows/dist/runtime/human-action.d.ts

@@ -0,0 +1,43 @@
+import type { JsonObject, NodeAttempt, RegistryRefId, WorkflowDefinition, WorkflowDiagnostic, WorkflowErrorSummary, WorkflowEventEmitter, WorkflowHumanActionId, WorkflowHumanActionKind, WorkflowHumanActionRecord, WorkflowRegistry, WorkflowRun, WorkflowRuntimeEvent, WorkflowValue, WorkflowWaitToken, WorkflowWaitTokenId, WorkflowWakeup, WorkflowWakeupId } from "../types/index.js";
+import type { WorkflowHumanActionStore, WorkflowRunStore, WorkflowWaitTokenStore } from "../store/index.js";
+export type WorkflowHumanActionDecisionKind = "approved" | "rejected" | "submitted" | "cancelled";
+export type WorkflowHumanActionApplyRequest = {
+    waitTokenId: WorkflowWaitTokenId;
+    actionId?: RegistryRefId;
+    kind?: WorkflowHumanActionKind;
+    actor?: JsonObject;
+    payload?: WorkflowValue;
+};
+export type WorkflowHumanActionApplyOptions = {
+    registry: Pick<WorkflowRegistry, "humanActions">;
+    store: WorkflowRunStore & WorkflowWaitTokenStore & WorkflowHumanActionStore;
+    now?: () => Date | string;
+    createHumanActionId?: () => WorkflowHumanActionId;
+    createWakeupId?: () => WorkflowWakeupId;
+    emitEvent?: WorkflowEventEmitter;
+};
+export type WorkflowHumanActionApplySuccess = {
+    ok: true;
+    run: WorkflowRun;
+    waitToken: WorkflowWaitToken;
+    humanAction: WorkflowHumanActionRecord;
+    events: WorkflowRuntimeEvent[];
+    decision: {
+        kind: WorkflowHumanActionDecisionKind;
+        actionId: RegistryRefId;
+        actionKind: WorkflowHumanActionKind;
+    };
+    wakeup?: WorkflowWakeup;
+    nodeAttempt?: NodeAttempt;
+};
+export type WorkflowHumanActionApplyFailure = {
+    ok: false;
+    run: WorkflowRun;
+    waitToken?: WorkflowWaitToken;
+    events: WorkflowRuntimeEvent[];
+    diagnostics: WorkflowDiagnostic[];
+    error: WorkflowErrorSummary;
+};
+export type WorkflowHumanActionApplyResult = WorkflowHumanActionApplySuccess | WorkflowHumanActionApplyFailure;
+export declare function applyWorkflowHumanAction(definition: WorkflowDefinition, run: WorkflowRun, request: WorkflowHumanActionApplyRequest, options: WorkflowHumanActionApplyOptions): Promise<WorkflowHumanActionApplyResult>;
+//# sourceMappingURL=human-action.d.ts.map

package/packages/workflows/dist/runtime/human-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-action.d.ts","sourceRoot":"","sources":["../../src/runtime/human-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAiB3B,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAElG,MAAM,MAAM,+BAA+B,GAAG;IAC5C,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACjD,KAAK,EAAE,gBAAgB,GAAG,sBAAsB,GAAG,wBAAwB,CAAC;IAC5E,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,qBAAqB,CAAC;IAClD,cAAc,CAAC,EAAE,MAAM,gBAAgB,CAAC;IACxC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,yBAAyB,CAAC;IACvC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,QAAQ,EAAE;QACR,IAAI,EAAE,+BAA+B,CAAC;QACtC,QAAQ,EAAE,aAAa,CAAC;QACxB,UAAU,EAAE,uBAAuB,CAAC;KACrC,CAAC;IACF,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,KAAK,CAAC;IACV,GAAG,EAAE,WAAW,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,KAAK,EAAE,oBAAoB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,+BAA+B,GAAG,+BAA+B,CAAC;AAE/G,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,+BAA+B,EACxC,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CAmOzC"}

package/packages/workflows/dist/runtime/human-action.js

@@ -0,0 +1,231 @@
+import { resolveWorkflowHumanAction } from "../registry/index.js";
+import { validateJsonValueAgainstSchema, validateNodeOutput, validateWorkflowPortValue, } from "../validation/index.js";
+import { createWorkflowRuntimeId as createId } from "./ids.js";
+import { emitWorkflowRuntimeEvent, hasWorkflowNodeAttemptReadStore, hasWorkflowWakeupStore, persistWorkflowNodeAttempt, persistWorkflowRun, } from "./persistence.js";
+import { createTimestampFactory, timestampToMillis } from "./time.js";
+export async function applyWorkflowHumanAction(definition, run, request, options) {
+    const events = [];
+    const timestamp = createTimestampFactory(options.now);
+    const actedAt = timestamp();
+    const diagnostics = [];
+    const waitToken = await options.store.getWaitToken(request.waitTokenId);
+    if (!waitToken) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.unknownWaitToken",
+            message: `Workflow wait token '${request.waitTokenId}' does not exist, so no human action can be applied.`,
+            severity: "error",
+            path: "$.waitTokenId",
+            hint: "Submit human actions only for pending wait tokens returned by workflow inspection.",
+        });
+        return humanActionApplyFailure(run, events, diagnostics, {
+            code: "WorkflowRuntimeError.unknownWaitToken",
+            message: "Human action failed because the wait token was not found.",
+        });
+    }
+    if (waitToken.workflowRunId !== run.id) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.waitTokenRunMismatch",
+            message: `Workflow wait token '${waitToken.id}' belongs to run '${waitToken.workflowRunId}', not run '${run.id}'.`,
+            severity: "error",
+            path: "$.waitTokenId",
+            hint: "Load and update the workflow run that owns the wait token.",
+        });
+    }
+    if (waitToken.status !== "pending") {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.waitTokenNotPending",
+            message: `Workflow wait token '${waitToken.id}' is '${waitToken.status}' and cannot accept another human action.`,
+            severity: "error",
+            path: "$.waitToken.status",
+            hint: "Human wait tokens can only be resolved once while they are pending.",
+        });
+    }
+    if (waitToken.expiresAt && timestampToMillis(waitToken.expiresAt) <= timestampToMillis(actedAt)) {
+        waitToken.status = "expired";
+        waitToken.resumedAt = actedAt;
+        await options.store.saveWaitToken(waitToken);
+        diagnostics.push({
+            code: "WorkflowRuntimeError.waitTokenExpired",
+            message: `Workflow wait token '${waitToken.id}' expired at ${waitToken.expiresAt}.`,
+            severity: "error",
+            path: "$.waitToken.expiresAt",
+            hint: "Create a new human wait or route timeout handling before submitting an action.",
+        });
+    }
+    const actionRef = resolveRequestedHumanActionRef(waitToken, request);
+    if (!actionRef) {
+        diagnostics.push({
+            code: "WorkflowRuntimeError.humanActionUnavailable",
+            message: request.actionId
+                ? `Workflow wait token '${waitToken.id}' does not offer human action '${request.actionId}'.`
+                : `Workflow wait token '${waitToken.id}' does not offer a human action of kind '${request.kind ?? "<missing>"}'.`,
+            severity: "error",
+            path: request.actionId ? "$.actionId" : "$.kind",
+            hint: "Use one of the wait token's available action refs.",
+        });
+    }
+    const actionDefinition = actionRef ? resolveWorkflowHumanAction(options.registry, actionRef.id) : undefined;
+    if (actionRef && !actionDefinition) {
+        diagnostics.push({
+            code: "WorkflowGraphError.unknownHumanActionRef",
+            message: `Workflow wait token '${waitToken.id}' references human action '${actionRef.id}', but it is not registered in the Workflow Registry.`,
+            severity: "error",
+            path: "$.waitToken.actions",
+            hint: "Register the action with registerWorkflowHumanAction/createWorkflowRegistry before accepting it.",
+        });
+    }
+    if (actionRef?.kind && actionDefinition && actionRef.kind !== actionDefinition.kind) {
+        diagnostics.push({
+            code: "WorkflowGraphError.humanActionKindMismatch",
+            message: `Workflow wait token '${waitToken.id}' action '${actionRef.id}' declares kind '${actionRef.kind}', but the registry defines kind '${actionDefinition.kind}'.`,
+            severity: "error",
+            path: "$.waitToken.actions",
+            hint: "Keep human action refs aligned with their registered action definitions.",
+        });
+    }
+    if (actionDefinition && request.payload !== undefined) {
+        const actionPort = actionDefinition.input ?? actionDefinition.output;
+        if (actionPort) {
+            diagnostics.push(...validateWorkflowPortValue(actionPort, request.payload, { path: "$.payload" }).diagnostics);
+        }
+    }
+    if (actionDefinition?.kind === "resume" && waitToken.schema) {
+        diagnostics.push(...validateJsonValueAgainstSchema(waitToken.schema, request.payload, { path: "$.payload" }));
+    }
+    if (waitToken.humanNodeId && request.payload !== undefined) {
+        const nodeOutputResult = validateNodeOutput(definition, waitToken.humanNodeId, request.payload, {
+            path: "$.payload",
+        });
+        diagnostics.push(...nodeOutputResult.diagnostics.map((diagnostic) => ({ ...diagnostic, nodeId: waitToken.humanNodeId })));
+    }
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return humanActionApplyFailure(run, events, diagnostics, {
+            code: "WorkflowRuntimeError.humanActionRejected",
+            message: "Human action failed validation before resolving the wait token.",
+        }, waitToken);
+    }
+    const actionKind = actionDefinition.kind;
+    const humanAction = {
+        id: options.createHumanActionId?.() ?? createId("wha"),
+        workflowRunId: run.id,
+        waitTokenId: waitToken.id,
+        kind: actionKind,
+        ...(request.actor ? { actor: request.actor } : {}),
+        ...(request.payload !== undefined ? { payload: request.payload } : {}),
+        createdAt: actedAt,
+    };
+    await options.store.saveHumanAction(humanAction);
+    const nodeAttempt = waitToken.nodeAttemptId && hasWorkflowNodeAttemptReadStore(options.store)
+        ? await options.store.getNodeAttempt(waitToken.nodeAttemptId)
+        : undefined;
+    if (actionKind === "cancel") {
+        waitToken.status = "cancelled";
+        waitToken.resumedAt = actedAt;
+        run.status = "cancelled";
+        run.current = { ...(run.current.nodeId ? { nodeId: run.current.nodeId } : {}), status: "cancelled" };
+        run.cancelledAt = actedAt;
+        run.updatedAt = actedAt;
+        if (nodeAttempt) {
+            nodeAttempt.status = "cancelled";
+            nodeAttempt.completedAt = actedAt;
+        }
+        await options.store.saveWaitToken(waitToken);
+        if (nodeAttempt) {
+            await persistWorkflowNodeAttempt(options.store, nodeAttempt);
+        }
+        await emitWorkflowRuntimeEvent(events, options.store, options.emitEvent, {
+            type: "workflow.cancelled",
+            runId: run.id,
+            reason: "human action cancelled workflow",
+        });
+        await persistWorkflowRun(options.store, run);
+        return {
+            ok: true,
+            run,
+            waitToken,
+            humanAction,
+            events,
+            decision: { kind: "cancelled", actionId: actionDefinition.id, actionKind },
+            ...(nodeAttempt ? { nodeAttempt } : {}),
+        };
+    }
+    waitToken.status = "resumed";
+    if (request.payload !== undefined) {
+        waitToken.resumePayload = request.payload;
+    }
+    waitToken.resumedAt = actedAt;
+    run.status = "running";
+    run.current = { ...(waitToken.humanNodeId ? { nodeId: waitToken.humanNodeId } : {}), status: "running" };
+    run.updatedAt = actedAt;
+    if (nodeAttempt) {
+        nodeAttempt.status = "completed";
+        if (request.payload !== undefined) {
+            nodeAttempt.output = request.payload;
+        }
+        nodeAttempt.completedAt = actedAt;
+    }
+    const wakeup = hasWorkflowWakeupStore(options.store)
+        ? {
+            id: options.createWakeupId?.() ?? createId("wwu"),
+            workflowRunId: run.id,
+            ...(waitToken.nodeAttemptId ? { nodeAttemptId: waitToken.nodeAttemptId } : {}),
+            kind: "human",
+            availableAt: actedAt,
+            correlationId: humanAction.id,
+            ...(request.payload !== undefined ? { payload: request.payload } : {}),
+            createdAt: actedAt,
+        }
+        : undefined;
+    await options.store.saveWaitToken(waitToken);
+    if (wakeup && hasWorkflowWakeupStore(options.store)) {
+        await options.store.saveWakeup(wakeup);
+    }
+    await emitWorkflowRuntimeEvent(events, options.store, options.emitEvent, {
+        type: "wait.resumed",
+        runId: run.id,
+        waitTokenId: waitToken.id,
+        ...(request.payload !== undefined ? { payload: request.payload } : {}),
+    });
+    if (nodeAttempt) {
+        await emitWorkflowRuntimeEvent(events, options.store, options.emitEvent, {
+            type: "node.completed",
+            runId: run.id,
+            nodeAttemptId: nodeAttempt.id,
+            ...(request.payload !== undefined ? { output: request.payload } : {}),
+        });
+        await persistWorkflowNodeAttempt(options.store, nodeAttempt);
+    }
+    await persistWorkflowRun(options.store, run);
+    return {
+        ok: true,
+        run,
+        waitToken,
+        humanAction,
+        events,
+        decision: { kind: decisionKindForHumanAction(actionKind), actionId: actionDefinition.id, actionKind },
+        ...(wakeup ? { wakeup } : {}),
+        ...(nodeAttempt ? { nodeAttempt } : {}),
+    };
+}
+function humanActionApplyFailure(run, events, diagnostics, error, waitToken) {
+    return { ok: false, run, events, diagnostics, error, ...(waitToken ? { waitToken } : {}) };
+}
+function resolveRequestedHumanActionRef(waitToken, request) {
+    if (request.actionId) {
+        return waitToken.actions.find((action) => action.id === request.actionId);
+    }
+    if (request.kind) {
+        return waitToken.actions.find((action) => action.kind === request.kind);
+    }
+    return undefined;
+}
+function decisionKindForHumanAction(kind) {
+    if (kind === "approve")
+        return "approved";
+    if (kind === "reject")
+        return "rejected";
+    if (kind === "cancel")
+        return "cancelled";
+    return "submitted";
+}
+//# sourceMappingURL=human-action.js.map