@miragon/pulse-engine-core 0.0.0-bootstrap.0 → 0.25.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miragon GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/activities.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The activity instance trees of the instances of a tree as one index: which activity instance an
+ * execution belongs to, which transition instance (async continuation) waits on it, and the leaf
+ * activity instances. Pure.
+ */
+import { type Rec } from "./records.js";
+export interface ActivityNode {
+    readonly id: string;
+    readonly activityId: string;
+    readonly activityName?: string;
+    readonly activityType?: string;
+    readonly processInstanceId: string;
+    readonly depth: number;
+    /** The process instance itself (root of its activity instance tree). */
+    readonly root: boolean;
+    /** No child activity or transition instances. */
+    readonly leaf: boolean;
+    readonly transition: boolean;
+    readonly executionIds: readonly string[];
+}
+export interface ActivityIndex {
+    readonly nodes: readonly ActivityNode[];
+    byId(id: string | undefined): ActivityNode | undefined;
+    /** The activity instance of an execution: one of `activityId` if possible, else the deepest. */
+    forExecution(executionId: string | undefined, activityId?: string): ActivityNode | undefined;
+    /** The transition instance (async continuation) of an execution. */
+    transition(executionId: string | undefined, activityId?: string): ActivityNode | undefined;
+}
+/** Indexes the activity instance trees (ActivityInstanceDto) of the instances of a tree. */
+export declare function indexActivities(trees: readonly Rec[]): ActivityIndex;
+//# sourceMappingURL=activities.d.ts.map

package/dist/activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../src/activities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsB,KAAK,GAAG,EAAgB,MAAM,cAAc,CAAA;AAEzE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;IACtD,gGAAgG;IAChG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC5F,oEAAoE;IACpE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;CAC3F;AAyDD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,GAAG,aAAa,CAmBpE"}

package/dist/activities.js

@@ -0,0 +1,62 @@
+/**
+ * The activity instance trees of the instances of a tree as one index: which activity instance an
+ * execution belongs to, which transition instance (async continuation) waits on it, and the leaf
+ * activity instances. Pure.
+ */
+import { compareText, field, records, str } from "./records.js";
+function strings(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string")
+        : [];
+}
+function node(instance, position, flags, executionIds) {
+    const name = str(instance, "activityName") ?? str(instance, "name");
+    const type = str(instance, "activityType");
+    return {
+        id: field(instance, "id"),
+        activityId: field(instance, "activityId"),
+        ...(name === undefined ? {} : { activityName: name }),
+        ...(type === undefined ? {} : { activityType: type }),
+        ...position,
+        ...flags,
+        executionIds,
+    };
+}
+function walk(instance, position, nodes) {
+    const children = records(instance.childActivityInstances);
+    const transitions = records(instance.childTransitionInstances);
+    const leaf = children.length === 0 && transitions.length === 0;
+    const flags = { root: position.depth === 0, leaf, transition: false };
+    nodes.push(node(instance, position, flags, strings(instance.executionIds)));
+    const below = { ...position, depth: position.depth + 1 };
+    for (const child of children)
+        walk(child, below, nodes);
+    for (const transition of transitions) {
+        const executionId = str(transition, "executionId");
+        const transitionFlags = { root: false, leaf: false, transition: true };
+        nodes.push(node(transition, below, transitionFlags, executionId === undefined ? [] : [executionId]));
+    }
+}
+/** Deepest first, then by id: a deterministic choice among candidates. */
+function best(candidates, activityId) {
+    const matching = candidates.filter((candidate) => candidate.activityId === activityId);
+    return (matching.length > 0 ? matching : candidates).toSorted((left, right) => right.depth - left.depth || compareText(left.id, right.id))[0];
+}
+/** Indexes the activity instance trees (ActivityInstanceDto) of the instances of a tree. */
+export function indexActivities(trees) {
+    const nodes = [];
+    for (const tree of trees) {
+        const processInstanceId = str(tree, "processInstanceId") ?? field(tree, "id");
+        walk(tree, { processInstanceId, depth: 0 }, nodes);
+    }
+    const containing = (executionId, transition) => executionId === undefined
+        ? []
+        : nodes.filter((candidate) => candidate.transition === transition && candidate.executionIds.includes(executionId));
+    return {
+        nodes,
+        byId: (id) => (id === undefined ? undefined : nodes.find((candidate) => candidate.id === id)),
+        forExecution: (executionId, activityId) => best(containing(executionId, false), activityId),
+        transition: (executionId, activityId) => best(containing(executionId, true), activityId),
+    };
+}
+//# sourceMappingURL=activities.js.map

package/dist/activities.js.map

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

package/dist/advance-plan.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Planning of advance: which wait state to move, which options apply to it, and the requests that
+ * move it. Pure.
+ */
+import type { PlannedWrite } from "./port.js";
+import type { AdvanceInput, InstanceView, WaitState } from "./types.js";
+/** Option combinations, checked before any request. */
+export declare function checkAdvanceInput(input: AdvanceInput): void;
+type ViewInput = Pick<InstanceView<unknown>, "id" | "state" | "waitingAt" | "children" | "truncated">;
+/** The wait state to move: the only advanceable one (of `activityId`). */
+export declare function chooseWait(view: ViewInput, activityId?: string): WaitState;
+/** Options that do not apply to the chosen wait state are refused. */
+export declare function checkOptions(wait: WaitState, input: AdvanceInput): void;
+/** A suspended job is not executed behind the operator's back. */
+export declare function checkSuspended(wait: WaitState): void;
+/** A lock of another worker that has not expired is refused; `worker` is the caller's default. */
+export declare function checkLock(wait: WaitState, input: AdvanceInput, now: number, worker: string): void;
+/** The writes that move the wait state, in order; `worker` locks an external task by default. */
+export declare function advanceSteps(wait: WaitState, input: AdvanceInput, worker: string): PlannedWrite[];
+export {};
+//# sourceMappingURL=advance-plan.d.ts.map

package/dist/advance-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advance-plan.d.ts","sourceRoot":"","sources":["../src/advance-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAiB,YAAY,EAAY,SAAS,EAAE,MAAM,YAAY,CAAA;AAmBhG,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAU3D;AAED,KAAK,SAAS,GAAG,IAAI,CACnB,YAAY,CAAC,OAAO,CAAC,EACrB,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CACxD,CAAA;AAgBD,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAgB1E;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAYvE;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAOpD;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAWjG;AAqGD,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAYjG"}

package/dist/advance-plan.js

@@ -0,0 +1,192 @@
+/**
+ * Planning of advance: which wait state to move, which options apply to it, and the requests that
+ * move it. Pure.
+ */
+import { WorkflowError } from "./errors.js";
+import { isAdvanceable, isSuspendedJob } from "./next.js";
+import { engineTime } from "./dates.js";
+import { compact } from "./util.js";
+import { waitId } from "./waits.js";
+const LOCK_DURATION_MS = 60_000;
+const TASKS = ["userTask", "externalTask"];
+/** The kinds each option applies to, in the order the options are checked. */
+const OPTION_KINDS = {
+    variables: ["userTask", "externalTask", "message", "signal", "other"],
+    localVariables: ["externalTask"],
+    bpmnError: TASKS,
+    errorMessage: TASKS,
+    fail: ["externalTask"],
+    retries: ["externalTask"],
+    workerId: ["externalTask"],
+};
+/** Option combinations, checked before any request. */
+export function checkAdvanceInput(input) {
+    if (input.bpmnError !== undefined && input.fail !== undefined) {
+        throw new WorkflowError({ kind: "advance-input", rule: "bpmn-error-excludes-fail" });
+    }
+    if (input.errorMessage !== undefined && input.bpmnError === undefined) {
+        throw new WorkflowError({ kind: "advance-input", rule: "error-message-needs-bpmn-error" });
+    }
+    if (input.retries !== undefined && input.fail === undefined) {
+        throw new WorkflowError({ kind: "advance-input", rule: "retries-need-fail" });
+    }
+}
+function nothing(view, activityId) {
+    const firstChildId = view.truncated === true ? view.children[0]?.id : undefined;
+    return new WorkflowError({
+        kind: "advance-nothing",
+        id: view.id,
+        ...compact({ activityId }),
+        waiting: view.waitingAt
+            .filter(isAdvanceable)
+            .map((wait) => ({ activityId: wait.activityId, kind: wait.kind })),
+        conditional: view.waitingAt.some((wait) => wait.kind === "conditional"),
+        ...compact({ firstChildId }),
+    });
+}
+/** The wait state to move: the only advanceable one (of `activityId`). */
+export function chooseWait(view, activityId) {
+    if (view.state !== "ACTIVE" && view.state !== "SUSPENDED") {
+        throw new WorkflowError({ kind: "advance-ended", id: view.id, state: view.state });
+    }
+    if (view.state === "SUSPENDED")
+        throw new WorkflowError({ kind: "advance-suspended", id: view.id });
+    const matching = view.waitingAt.filter((wait) => isAdvanceable(wait) && (activityId === undefined || wait.activityId === activityId));
+    // a suspended job does not count as a place while something else can move (like the next steps)
+    const movable = matching.filter((wait) => !isSuspendedJob(wait));
+    const waits = movable.length > 0 ? movable : matching;
+    const [only, ...others] = waits;
+    if (only === undefined)
+        throw nothing(view, activityId);
+    if (others.length > 0)
+        throw new WorkflowError({ kind: "advance-ambiguous", id: view.id, waits });
+    return only;
+}
+/** Options that do not apply to the chosen wait state are refused. */
+export function checkOptions(wait, input) {
+    for (const [option, kinds] of Object.entries(OPTION_KINDS)) {
+        if (input[option] !== undefined && !kinds.includes(wait.kind)) {
+            throw new WorkflowError({
+                kind: "advance-option-kind",
+                option,
+                appliesTo: kinds,
+                activityId: wait.activityId,
+                waitKind: wait.kind,
+            });
+        }
+    }
+}
+/** A suspended job is not executed behind the operator's back. */
+export function checkSuspended(wait) {
+    if (!isSuspendedJob(wait) || !("jobId" in wait))
+        return;
+    throw new WorkflowError({
+        kind: "advance-job-suspended",
+        jobId: wait.jobId,
+        activityId: wait.activityId,
+    });
+}
+/** A lock of another worker that has not expired is refused; `worker` is the caller's default. */
+export function checkLock(wait, input, now, worker) {
+    if (wait.kind !== "externalTask" || wait.workerId === undefined)
+        return;
+    const own = input.workerId ?? worker;
+    const until = engineTime(wait.lockExpirationTime);
+    if (wait.workerId === own || until === undefined || until <= now)
+        return;
+    throw new WorkflowError({
+        kind: "advance-locked",
+        externalTaskId: wait.externalTaskId,
+        workerId: wait.workerId,
+        ...compact({ lockExpirationTime: wait.lockExpirationTime }),
+    });
+}
+function write(label, operationId, pathArgs, body) {
+    return {
+        label,
+        operationId,
+        input: { pathArgs, query: {}, ...(body === undefined ? {} : { body }) },
+    };
+}
+function variablesOf(input) {
+    return compact({ variables: input.variables, localVariables: input.localVariables });
+}
+function userTaskSteps(taskId, input) {
+    if (input.bpmnError === undefined) {
+        return [
+            write(`complete user task ${taskId}`, "complete", [taskId], compact({ variables: input.variables })),
+        ];
+    }
+    const body = {
+        errorCode: input.bpmnError,
+        ...compact({ errorMessage: input.errorMessage, variables: input.variables }),
+    };
+    return [
+        write(`throw BPMN error ${input.bpmnError} on user task ${taskId}`, "handleBpmnError", [taskId], body),
+    ];
+}
+function externalTaskSteps(id, input, workerId) {
+    const lock = write(`lock external task ${id} as ${workerId}`, "lock", [id], {
+        workerId,
+        lockDuration: LOCK_DURATION_MS,
+    });
+    if (input.bpmnError !== undefined) {
+        const body = {
+            workerId,
+            errorCode: input.bpmnError,
+            ...compact({ errorMessage: input.errorMessage, variables: input.variables }),
+        };
+        return [
+            lock,
+            write(`throw BPMN error ${input.bpmnError} on external task ${id}`, "handleExternalTaskBpmnError", [id], body),
+        ];
+    }
+    if (input.fail !== undefined) {
+        const body = {
+            workerId,
+            errorMessage: input.fail,
+            retries: input.retries ?? 0,
+            retryTimeout: 0,
+            ...variablesOf(input),
+        };
+        return [lock, write(`report a failure of external task ${id}`, "handleFailure", [id], body)];
+    }
+    return [
+        lock,
+        write(`complete external task ${id}`, "completeExternalTaskResource", [id], {
+            workerId,
+            ...variablesOf(input),
+        }),
+    ];
+}
+/** The write of a message, a signal or a receive task (`other`). */
+function eventStep(wait, input) {
+    const variables = compact({ variables: input.variables });
+    if (wait.kind === "message") {
+        const name = wait.eventName ?? "";
+        const label = `trigger message ${name} of execution ${wait.executionId}`;
+        return write(label, "triggerEvent", [wait.executionId, name], variables);
+    }
+    if (wait.kind === "signal") {
+        const name = wait.eventName ?? "";
+        const body = { name, executionId: wait.executionId, ...variables };
+        return write(`send signal ${name} to execution ${wait.executionId}`, "throwSignal", [], body);
+    }
+    const executionId = waitId(wait);
+    return write(`signal execution ${executionId}`, "signalExecution", [executionId], variables);
+}
+/** The writes that move the wait state, in order; `worker` locks an external task by default. */
+export function advanceSteps(wait, input, worker) {
+    switch (wait.kind) {
+        case "userTask":
+            return userTaskSteps(wait.taskId, input);
+        case "externalTask":
+            return externalTaskSteps(wait.externalTaskId, input, input.workerId ?? worker);
+        case "timer":
+        case "asyncContinuation":
+            return [write(`execute job ${wait.jobId}`, "executeJob", [wait.jobId])];
+        default:
+            return [eventStep(wait, input)];
+    }
+}
+//# sourceMappingURL=advance-plan.js.map

package/dist/advance-plan.js.map

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

package/dist/conditions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Wait conditions: parsing, the requests each condition needs per poll, and the order in which a
+ * poll decides.
+ */
+import type { EnginePort } from "./port.js";
+export type Condition = {
+    readonly kind: "idle" | "ended" | "incident";
+} | {
+    readonly kind: "task";
+    readonly key?: string;
+} | {
+    readonly kind: "activity";
+    readonly id: string;
+};
+export declare function parseCondition(raw: string): Condition;
+export declare function conditionLabel(condition: Condition): string;
+/** The instance as one poll saw it. */
+export interface Probe {
+    readonly id: string;
+    readonly ended: boolean;
+    /** The active tree (empty once the instance ended). */
+    readonly tree: readonly string[];
+    /** The tree was cut: instances beyond the cut are not counted. */
+    readonly truncated?: boolean;
+}
+export interface Measurement {
+    /** Instances of the tree with an incident. */
+    readonly incidents: number;
+    /** Labels of the conditions that hold, other than `incident`, in the given order. */
+    readonly held: readonly string[];
+}
+/**
+ * The jobs the job executor will run: retries left, due, and active. The engine's `executable`
+ * filter checks the suspension of the instance only, not of the job (a suspended job definition
+ * suspends its jobs), hence `active` (verified on all three engines).
+ */
+export declare const EXECUTABLE: {
+    readonly executable: "true";
+    readonly active: "true";
+};
+/**
+ * The counts of one poll: only what the conditions need, then the incident check. The incident
+ * count is read after the condition counts, never in parallel with them: a job that fails for good
+ * loses its last retry and gets its incident in one transaction, so a job count that no longer sees
+ * the job is followed by an incident count that sees the incident. Read in parallel, the incident
+ * count could come from before that transaction and the job count from after it, and the poll
+ * would see neither (a stuck instance reported as idle).
+ */
+export declare function measure(port: EnginePort, probe: Probe, conditions: readonly Condition[], checkIncidents: boolean): Promise<Measurement>;
+export type Verdict = {
+    readonly kind: "held";
+    readonly until: string;
+} | {
+    readonly kind: "incident";
+} | {
+    readonly kind: "ended";
+} | {
+    readonly kind: "pending";
+};
+/**
+ * The decision of a poll: the condition `incident` with an incident, then an incident with fail fast
+ * (a job that failed for good is not executable, so `idle` would otherwise report success for a
+ * stuck instance), then any other condition, then an ended instance.
+ */
+export declare function decide(conditions: readonly Condition[], failOnIncident: boolean, probe: Probe, measurement: Measurement): Verdict;
+//# sourceMappingURL=conditions.d.ts.map

package/dist/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../src/conditions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAG3C,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAgBtD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAQrD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAS3D;AAED,uCAAuC;AACvC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAsBD;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;CAAkD,CAAA;AA6BzE;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,cAAc,EAAE,OAAO,GACtB,OAAO,CAAC,WAAW,CAAC,CAOtB;AAED,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEhC;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,GACvB,OAAO,CAOT"}

package/dist/conditions.js

@@ -0,0 +1,119 @@
+/**
+ * Wait conditions: parsing, the requests each condition needs per poll, and the order in which a
+ * poll decides.
+ */
+import { WorkflowError } from "./errors.js";
+import { countByIds } from "./requests.js";
+/** The accepted forms, for messages and help texts. */
+const CONDITION_FORMS = [
+    "idle",
+    "ended",
+    "incident",
+    "task",
+    "task:<taskDefinitionKey>",
+    "activity:<activityId>",
+];
+function invalid(raw) {
+    return new WorkflowError({ kind: "condition-invalid", raw, forms: CONDITION_FORMS });
+}
+export function parseCondition(raw) {
+    if (raw === "idle" || raw === "ended" || raw === "incident" || raw === "task") {
+        return { kind: raw };
+    }
+    const [prefix, ...rest] = raw.split(":");
+    const id = rest.join(":");
+    if (id === "" || (prefix !== "task" && prefix !== "activity"))
+        throw invalid(raw);
+    return prefix === "task" ? { kind: "task", key: id } : { kind: "activity", id };
+}
+export function conditionLabel(condition) {
+    switch (condition.kind) {
+        case "activity":
+            return `activity:${condition.id}`;
+        case "task":
+            return condition.key === undefined ? "task" : `task:${condition.key}`;
+        default:
+            return condition.kind;
+    }
+}
+/** Counts over the instances of the tree (`processInstanceIds` of process instances). */
+function countInTree(port, tree, query) {
+    return countByIds(port, {
+        operationId: "getProcessInstancesCount",
+        key: "processInstanceIds",
+        ids: tree,
+        query,
+    });
+}
+async function activityReached(port, probe, activityId) {
+    const ids = [...new Set([probe.id, ...probe.tree])];
+    const history = { operationId: "getHistoricActivityInstancesCount", key: "processInstanceId" };
+    const [active, ...finished] = await Promise.all([
+        countInTree(port, probe.tree, { activityIdIn: activityId }),
+        ...ids.map((pid) => countByIds(port, { ...history, ids: [pid], query: { activityId } })),
+    ]);
+    return active > 0 || finished.some((count) => count > 0);
+}
+/**
+ * The jobs the job executor will run: retries left, due, and active. The engine's `executable`
+ * filter checks the suspension of the instance only, not of the job (a suspended job definition
+ * suspends its jobs), hence `active` (verified on all three engines).
+ */
+export const EXECUTABLE = { executable: "true", active: "true" };
+/** No executable job in the tree; an ended instance has no tree and is idle. */
+async function idle(port, probe) {
+    const request = { operationId: "getJobsCount", key: "processInstanceIds", ids: probe.tree };
+    return (await countByIds(port, { ...request, query: EXECUTABLE })) === 0;
+}
+async function taskOpen(port, probe, key) {
+    const query = key === undefined ? {} : { taskDefinitionKey: key };
+    const request = { operationId: "getTasksCount", key: "processInstanceIdIn", ids: probe.tree };
+    return (await countByIds(port, { ...request, query })) > 0;
+}
+async function holds(port, probe, condition) {
+    switch (condition.kind) {
+        case "ended":
+            return probe.ended;
+        case "incident":
+            return false;
+        case "idle":
+            return idle(port, probe);
+        case "task":
+            return taskOpen(port, probe, condition.key);
+        case "activity":
+            return activityReached(port, probe, condition.id);
+    }
+}
+/**
+ * The counts of one poll: only what the conditions need, then the incident check. The incident
+ * count is read after the condition counts, never in parallel with them: a job that fails for good
+ * loses its last retry and gets its incident in one transaction, so a job count that no longer sees
+ * the job is followed by an incident count that sees the incident. Read in parallel, the incident
+ * count could come from before that transaction and the job count from after it, and the poll
+ * would see neither (a stuck instance reported as idle).
+ */
+export async function measure(port, probe, conditions, checkIncidents) {
+    const results = await Promise.all(conditions.map((condition) => holds(port, probe, condition)));
+    const incidents = checkIncidents
+        ? await countInTree(port, probe.tree, { withIncident: "true" })
+        : 0;
+    const held = conditions.filter((_, index) => results[index] === true).map(conditionLabel);
+    return { incidents, held };
+}
+/**
+ * The decision of a poll: the condition `incident` with an incident, then an incident with fail fast
+ * (a job that failed for good is not executable, so `idle` would otherwise report success for a
+ * stuck instance), then any other condition, then an ended instance.
+ */
+export function decide(conditions, failOnIncident, probe, measurement) {
+    const wantsIncident = conditions.some((condition) => condition.kind === "incident");
+    if (wantsIncident && measurement.incidents > 0)
+        return { kind: "held", until: "incident" };
+    if (failOnIncident && measurement.incidents > 0)
+        return { kind: "incident" };
+    const [until] = measurement.held;
+    if (until !== undefined)
+        return { kind: "held", until };
+    return probe.ended ? { kind: "ended" } : { kind: "pending" };
+}
+//# sourceMappingURL=conditions.js.map

package/dist/conditions.js.map

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

package/dist/dates.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Engine dates. CIB seven / Camunda 7 / Operaton parse EVERY date (query
+ * filters, request bodies, `Date` variables) with one Java pattern,
+ * `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, where `Z` is a `±HHMM` offset. A literal "Z",
+ * an offset with a colon, missing milliseconds or a bare date are all 400s.
+ * Callers therefore accept ordinary ISO 8601 at their boundary and convert it
+ * here, once: one parser, read in one of two {@link DateInputReading}s.
+ *
+ * The read direction has two readers as well: {@link engineDateMillis} (this
+ * parser, an offset required) and {@link engineTime} (`Date.parse`, which also
+ * reads an offset-less time, in the local zone). Both are kept as they are
+ * until the two readings are aligned (a behaviour change, not a move).
+ */
+/** The relaxed spellings; a time needs its offset. The default of every function here. */
+export declare const OFFSET_REQUIRED = "offset-required";
+/** The strict spellings; a time without an offset is UTC. */
+export declare const UTC_WITHOUT_OFFSET = "utc-without-offset";
+/**
+ * How an ISO 8601 date input is read: a closed set, one reading per interface today (the MCP
+ * tools {@link OFFSET_REQUIRED}, the CLI {@link UTC_WITHOUT_OFFSET}). Each keeps its reading until
+ * one is chosen for all of them (a behaviour change); its two rules stay internal.
+ */
+export type DateInputReading = typeof OFFSET_REQUIRED | typeof UTC_WITHOUT_OFFSET;
+/** Example of the accepted input forms of {@link OFFSET_REQUIRED}, for error messages and descriptions. */
+export declare const ENGINE_DATE_INPUT_FORMS = "ISO 8601: a date (2026-10-01, midnight UTC) or a date-time with offset (2026-10-01T08:30:00Z, 2026-10-01T08:30:00.000+02:00)";
+/** Whether `input` is an ISO 8601 date the reading can convert. */
+export declare function isEngineDateInput(input: string, reading?: DateInputReading): boolean;
+/** The engine format of an ISO 8601 date input; undefined when the reading refuses it. */
+export declare function engineDateInput(input: string, reading?: DateInputReading): string | undefined;
+/**
+ * ISO 8601 (or a `Date`) → the engine's `yyyy-MM-dd'T'HH:mm:ss.SSS±HHMM`.
+ * A string keeps its own offset (`Z` becomes `+0000`), so the instant is
+ * unchanged; a bare date means midnight UTC; a `Date` is written in UTC.
+ * Throws a `RangeError` naming the accepted forms for anything else
+ * (read as {@link OFFSET_REQUIRED}).
+ */
+export declare function toEngineDate(input: string | Date): string;
+/** {@link toEngineDate} for optional filters: `undefined` stays `undefined`. */
+export declare function toOptionalEngineDate(input: string | undefined): string | undefined;
+/**
+ * The read direction: a timestamp the engine EMITS (`…SSS±HHMM`, its local
+ * offset) → epoch millis; null when absent or unparseable. Engine timestamps
+ * order by instant, never as text: across a DST change the engine stamps
+ * `…+0200` and `…+0100`, and the string order is then off by up to an hour.
+ */
+export declare function engineDateMillis(value: string | null | undefined): number | null;
+/** The newest of the given engine timestamps by instant (as given); null when none parses. */
+export declare function latestEngineDate(values: Iterable<string | null | undefined>): string | null;
+/** The oldest of the given engine timestamps by instant (as given); null when none parses. */
+export declare function earliestEngineDate(values: Iterable<string | null | undefined>): string | null;
+/**
+ * Milliseconds of an engine timestamp (`2024-05-01T10:00:00.000+0200`), or undefined. Read by
+ * `Date.parse`: unlike {@link engineDateMillis} it also reads a time without an offset (in the
+ * local zone).
+ */
+export declare function engineTime(value: string | undefined): number | undefined;
+/** An instant in the engine format, in UTC: `2024-05-01T08:00:00.000+0000`. */
+export declare function engineFormat(ms: number): string;
+//# sourceMappingURL=dates.d.ts.map

package/dist/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,0FAA0F;AAC1F,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAEhD,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,GAAG,OAAO,kBAAkB,CAAA;AAwBjF,2GAA2G;AAC3G,eAAO,MAAM,uBAAuB,iIAC4F,CAAA;AAuGhI,mEAAmE;AACnE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAkC,GAC1C,OAAO,CAET;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAkC,GAC1C,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAUzD;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAgBhF;AAiBD,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,CAE3F;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,CAE7F;AAKD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIxE;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C"}