@msm-core/jobs 0.1.0 → 0.3.0

package/dist/approval/engine.d.ts

@@ -0,0 +1,30 @@
+import type { ApprovalCreatorPort, ApprovalStore, ClockPort, JobOpsPort, JobStore, QueuePort } from "../port.js";
+import type { JobEngineConfig } from "../config.js";
+import type { ApprovalRecord } from "../types.js";
+export interface ApprovalEngineDeps {
+    approvalStore: ApprovalStore;
+    jobStore: JobStore;
+    queue: QueuePort;
+    ops: JobOpsPort;
+    clock: ClockPort;
+    config: JobEngineConfig;
+    genApprovalId: () => string;
+}
+export type ApprovalDecision = "approve" | "reject";
+export interface ResolveApprovalResult {
+    approval: ApprovalRecord;
+    jobResumed: boolean;
+    alreadyResolved: boolean;
+}
+export interface ApprovalEngine extends ApprovalCreatorPort {
+    resolve(args: {
+        approvalId: string;
+        tenantId: string;
+        decision: ApprovalDecision;
+        decidedBy: string;
+        updatedParams?: Record<string, unknown> | null;
+    }): Promise<ResolveApprovalResult>;
+    expireStale(asOf?: Date): Promise<number>;
+}
+export declare function createApprovalEngine(deps: ApprovalEngineDeps): ApprovalEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/approval/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/approval/engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,OAAO,CAAC,IAAI,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAChD,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAoJ7E"}

package/dist/approval/engine.js

@@ -0,0 +1,146 @@
+// HITL approval engine (S2). `create` is the ApprovalCreatorPort the orchestrator calls when a
+// step transitions to awaiting_approval; `resolve` performs the one-shot CAS on the approval and
+// (on approve) flips the job awaiting_approval→queued + re-enqueues, or (on reject) cancels it —
+// the version guard makes both exactly-once. `expireStale` applies the timeout (→ paused).
+// Ported from kader's approval.service.ts (createJobApproval + approve job-resume path).
+const QUEUE_NAME = "jobs";
+export function createApprovalEngine(deps) {
+    const { approvalStore, jobStore, queue, ops, clock, config } = deps;
+    async function create(input) {
+        const existing = await approvalStore.findPendingForStep(input.tenantId, input.jobId, input.stepNumber);
+        if (existing)
+            return { approvalId: existing.approvalId, expiresAt: existing.expiresAt };
+        const approvalId = deps.genApprovalId();
+        const expiresAt = new Date(clock.now().getTime() + (input.approvalTimeoutMs ?? config.defaultApprovalExpiryMs));
+        const rec = await approvalStore.create({
+            approvalId,
+            tenantId: input.tenantId,
+            employeeId: input.employeeId,
+            jobId: input.jobId,
+            jobStepNumber: input.stepNumber,
+            jobVersion: input.jobVersion,
+            action: {
+                toolName: "job_step_approval",
+                workflowType: input.workflowType,
+                stepType: input.stepType,
+                transitionReason: input.transitionReason,
+                approvalPolicy: input.approvalPolicy,
+                ...(input.metadata || {}),
+            },
+            reasoning: input.reasoning,
+            expiresAt,
+        });
+        ops.record({
+            jobId: input.jobId,
+            tenantId: input.tenantId,
+            source: "approval_service",
+            eventType: "job.approval.created",
+            status: "awaiting_approval",
+            employeeId: input.employeeId,
+            metadata: { approvalId: rec.approvalId, stepNumber: input.stepNumber, approvalPolicy: input.approvalPolicy },
+        });
+        return { approvalId: rec.approvalId, expiresAt: rec.expiresAt };
+    }
+    async function resolve(args) {
+        const toStatus = args.decision === "approve" ? "approved" : "rejected";
+        const rec = await approvalStore.resolve({
+            approvalId: args.approvalId,
+            tenantId: args.tenantId,
+            toStatus,
+            decidedBy: args.decidedBy,
+            decidedAt: clock.now(),
+            updatedParams: args.updatedParams ?? null,
+        });
+        if (!rec) {
+            const existing = await approvalStore.getById(args.approvalId, args.tenantId);
+            if (!existing)
+                throw new Error(`approval not found: ${args.approvalId}`);
+            return { approval: existing, jobResumed: false, alreadyResolved: true };
+        }
+        let jobResumed = false;
+        if (rec.jobId && rec.jobVersion !== null) {
+            const snap = await jobStore.getJob(rec.jobId, args.tenantId);
+            if (snap && snap.status === "awaiting_approval" && snap.version === rec.jobVersion) {
+                const stamp = {
+                    approvalId: rec.approvalId,
+                    decision: toStatus,
+                    decidedBy: args.decidedBy,
+                    decidedAt: clock.now().toISOString(),
+                };
+                const set = toStatus === "approved"
+                    ? { status: "queued", resumeAt: null, waitEvent: null, state: { ...(snap.state || {}), approval: stamp } }
+                    : { status: "cancelled", completedAt: clock.now(), state: { ...(snap.state || {}), approval: stamp } };
+                const job = await jobStore.claim({
+                    jobId: rec.jobId,
+                    tenantId: args.tenantId,
+                    expectedVersion: snap.version,
+                    statusIn: ["awaiting_approval"],
+                    set,
+                });
+                if (job) {
+                    if (toStatus === "approved") {
+                        await queue.enqueue({ jobId: rec.jobId, tenantId: args.tenantId, reason: "approval_resolved", dedupeKey: rec.approvalId });
+                        jobResumed = true;
+                    }
+                    ops.record({
+                        jobId: rec.jobId,
+                        tenantId: args.tenantId,
+                        missionId: job.missionId,
+                        source: "approval_service",
+                        eventType: "job.approval.resolved",
+                        status: job.status,
+                        queueName: QUEUE_NAME,
+                        employeeId: job.employeeId,
+                        correlationId: job.correlationId,
+                        metadata: { approvalId: rec.approvalId, stepNumber: rec.jobStepNumber, decision: toStatus },
+                    });
+                }
+            }
+        }
+        return { approval: rec, jobResumed, alreadyResolved: false };
+    }
+    async function expireStale(asOf = clock.now()) {
+        const expired = await approvalStore.findExpired(asOf, Math.max(1, config.waitReconcileBatchSize));
+        let count = 0;
+        for (const a of expired) {
+            const rec = await approvalStore.resolve({
+                approvalId: a.approvalId,
+                tenantId: a.tenantId,
+                toStatus: "expired",
+                decidedBy: "system",
+                decidedAt: clock.now(),
+            });
+            if (!rec)
+                continue;
+            count += 1;
+            if (rec.jobId && rec.jobVersion !== null) {
+                const snap = await jobStore.getJob(rec.jobId, rec.tenantId);
+                if (snap && snap.status === "awaiting_approval" && snap.version === rec.jobVersion) {
+                    // Timeout outcome: park the job as paused (a human is needed). The richer
+                    // escalate / auto-approve variants resolve from the policy in a later pass.
+                    await jobStore.claim({
+                        jobId: rec.jobId,
+                        tenantId: rec.tenantId,
+                        expectedVersion: snap.version,
+                        statusIn: ["awaiting_approval"],
+                        set: { status: "paused", state: { ...(snap.state || {}), approval: { approvalId: a.approvalId, decision: "expired" } } },
+                    });
+                    ops.record({
+                        jobId: rec.jobId,
+                        tenantId: rec.tenantId,
+                        missionId: snap.missionId,
+                        source: "approval_service",
+                        eventType: "job.approval.expired",
+                        status: "paused",
+                        employeeId: snap.employeeId,
+                        correlationId: snap.correlationId,
+                        metadata: { approvalId: a.approvalId },
+                    });
+                }
+            }
+        }
+        return count;
+    }
+    return { create, resolve, expireStale };
+}
+//# sourceMappingURL=engine.js.map

package/dist/approval/engine.js.map

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

package/dist/config.d.ts

@@ -21,6 +21,8 @@ export interface JobEngineConfig {
         secret: string;
         ttlSeconds: number;
     };
+    /** Default HITL approval expiry when a workflow step omits approvalTimeoutMs (S2). */
+    defaultApprovalExpiryMs: number;
 }
 export declare const DEFAULT_JOB_ENGINE_CONFIG: JobEngineConfig;
 export interface OrchestratorRunConfig {

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,eAAO,MAAM,yBAAyB,EAAE,eAOvC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAK/E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,sFAAsF;IACtF,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,yBAAyB,EAAE,eAQvC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAK/E"}

package/dist/config.js

@@ -6,6 +6,7 @@ export const DEFAULT_JOB_ENGINE_CONFIG = {
     defaultWaitMs: 60_000,
     waitReconcileBatchSize: 50,
     resumeToken: { secret: "", ttlSeconds: 86_400 },
+    defaultApprovalExpiryMs: 24 * 60 * 60 * 1000,
 };
 export function resolveRunConfig(config) {
     return {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAyBlF,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,eAAe,EAAE,CAAC;IAClB,sBAAsB,EAAE,KAAK;IAC7B,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,MAAM;IACrB,sBAAsB,EAAE,EAAE;IAC1B,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;CAChD,CAAC;AAOF,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO;QACL,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;QACjE,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,sBAAsB,CAAC;KACnE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,kFAAkF;AA2BlF,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,eAAe,EAAE,CAAC;IAClB,sBAAsB,EAAE,KAAK;IAC7B,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,MAAM;IACrB,sBAAsB,EAAE,EAAE;IAC1B,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IAC/C,uBAAuB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC7C,CAAC;AAOF,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO;QACL,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;QACjE,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,sBAAsB,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/enums.d.ts

@@ -3,7 +3,7 @@ export type JobStatus = (typeof JOB_STATUSES)[number];
 export declare const TERMINAL_JOB_STATUSES: readonly ["completed", "failed", "cancelled"];
 export type TerminalJobStatus = (typeof TERMINAL_JOB_STATUSES)[number];
 export declare const RUNNABLE_JOB_STATUSES: readonly ["queued", "running"];
-export declare const JOB_STEP_TYPES: readonly ["run_interaction_task", "wait_time", "wait_event", "notify_owner", "notify_customer", "complete", "fail"];
+export declare const JOB_STEP_TYPES: readonly ["run_interaction_task", "wait_time", "wait_event", "task_handoff", "notify_owner", "notify_customer", "complete", "fail"];
 export type JobStepType = (typeof JOB_STEP_TYPES)[number];
 export declare const JOB_STEP_STATUSES: readonly ["running", "completed", "failed", "skipped"];
 export type JobStepStatus = (typeof JOB_STEP_STATUSES)[number];

package/dist/enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,oIAUf,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,qBAAqB,+CAAgD,CAAC;AACnF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,qBAAqB,gCAAiC,CAAC;AAEpE,eAAO,MAAM,cAAc,qHAQjB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,wDAAyD,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,qBAAqB,yDAA0D,CAAC;AAC7F,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB,wDAAyD,CAAC;AAC3F,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,iBAAiB,CAE/E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,oIAUf,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,qBAAqB,+CAAgD,CAAC;AACnF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,qBAAqB,gCAAiC,CAAC;AAEpE,eAAO,MAAM,cAAc,qIASjB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,wDAAyD,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,qBAAqB,yDAA0D,CAAC;AAC7F,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB,wDAAyD,CAAC;AAC3F,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,iBAAiB,CAE/E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/enums.js

@@ -18,6 +18,7 @@ export const JOB_STEP_TYPES = [
     "run_interaction_task",
     "wait_time",
     "wait_event",
+    "task_handoff",
     "notify_owner",
     "notify_customer",
     "complete",

package/dist/enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,gFAAgF;AAChF,oFAAoF;AAEpF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,SAAS;IACT,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAGnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,sBAAsB;IACtB,WAAW;IACX,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,UAAU;IACV,MAAM;CACE,CAAC;AAGX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAGxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAG3F,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAQ,qBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAQ,qBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,gFAAgF;AAChF,oFAAoF;AAEpF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,SAAS;IACT,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAGnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,sBAAsB;IACtB,WAAW;IACX,YAAY;IACZ,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,UAAU;IACV,MAAM;CACE,CAAC;AAGX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAGxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAG3F,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAQ,qBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAQ,qBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import { type Orchestrator, type OrchestrateJobStepInput } from "./orchestrator.js";
 import { type Reconciler } from "./reconciler.js";
 import { type ResumeTokenService } from "./resume-token.js";
+import { type MissionScheduler } from "./mission/scheduler.js";
+import { type ApprovalEngine } from "./approval/engine.js";
 import { DEFAULT_JOB_ENGINE_CONFIG, type JobEngineConfig } from "./config.js";
-import type { ApprovalCreatorPort, ClockPort, JobOpsPort, JobStore, LockPort, NoncePort, QueuePort, StepExecutorPort, WorkflowRegistry } from "./port.js";
+import type { ApprovalCreatorPort, ApprovalStore, ClockPort, JobOpsPort, JobStore, LockPort, MissionStore, NoncePort, QueuePort, StepExecutorPort, WorkflowRegistry } from "./port.js";
 export interface CreateJobEngineDeps {
     jobStore: JobStore;
     queue: QueuePort;
@@ -13,9 +15,17 @@ export interface CreateJobEngineDeps {
     registry: WorkflowRegistry;
     stepExecutor: StepExecutorPort;
     config: JobEngineConfig;
+    /** S2: HITL approval persistence. When provided, the engine builds the approval engine and
+     *  uses it as the approvalCreator automatically (awaiting_approval steps create a record). */
+    approvalStore?: ApprovalStore;
+    /** S2: mission persistence. When provided, the engine exposes a cron mission scheduler. */
+    missionStore?: MissionStore;
+    /** Explicit approvalCreator override (else the built approval engine, if approvalStore given). */
     approvalCreator?: ApprovalCreatorPort;
-    /** Override the step-id generator (default: crypto.randomUUID). */
+    /** Override id generators (default: crypto.randomUUID). */
     genStepId?: () => string;
+    genApprovalId?: () => string;
+    genMissionRunId?: () => string;
     /** Reconciler lock TTL (default: derived from the scan interval). */
     reconcileLockTtlMs?: number;
 }
@@ -23,6 +33,10 @@ export interface JobEngine {
     orchestrateJobStep: Orchestrator["orchestrateJobStep"];
     reconcileWaitingTimeJobs: Reconciler["reconcileWaitingTimeJobs"];
     resumeToken: ResumeTokenService;
+    /** Present when approvalStore was provided (S2). */
+    approval?: ApprovalEngine;
+    /** Present when missionStore was provided (S2). */
+    missions?: MissionScheduler;
 }
 /** Assemble the durable job engine from ports + config. */
 export declare function createJobEngine(deps: CreateJobEngineDeps): JobEngine;
@@ -32,6 +46,10 @@ export type { ResumeTokenService };
 export { createResumeTokenService, ResumeTokenError, type IssuedResumeToken, type ConsumedResumeToken, } from "./resume-token.js";
 export { createWorkflowRegistry, BUILTIN_JOB_BASIC } from "./workflow/registry.js";
 export type { WaitingTimeReconcileResult } from "./reconciler.js";
+export { createMissionScheduler, type MissionScheduler } from "./mission/scheduler.js";
+export { isMissionCronDueAt, isWithinQuietHours, matchesCronField, parseDurationToMs, } from "./mission/cron.js";
+export { createApprovalEngine, type ApprovalEngine, type ApprovalDecision, type ResolveApprovalResult, } from "./approval/engine.js";
+export type { MissionTrigger, MissionQuietHours, MissionSafety, MissionRecord, MissionRunRecord, MissionSchedulerTickResult, ApprovalRecord, ApprovalStatus, } from "./types.js";
 export { JOB_STATUSES, TERMINAL_JOB_STATUSES, RUNNABLE_JOB_STATUSES, JOB_STEP_TYPES, JOB_STEP_STATUSES, JOB_STEP_TRIGGERED_BY, MISSION_RUN_STATUSES, isTerminalJobStatus, isRunnableJobStatus, type JobStatus, type TerminalJobStatus, type JobStepType, type JobStepStatus, type JobStepTriggeredBy, type MissionRunStatus, } from "./enums.js";
 export type { JobBudget, JobWaitEvent, JobSnapshot, JobStepRecord, JobStepToolCall, CreateJobInput, JobOpsEventInput, WorkflowResolution, WorkflowContext, WorkflowSequenceStep, WorkflowDefinition, } from "./types.js";
 export { JOB_APPROVAL_POLICIES, DEFAULT_JOB_APPROVAL_POLICY, isJobApprovalPolicy, parseJobApprovalPolicy, resolveJobApprovalTimeoutOutcome, type JobApprovalPolicy, type JobApprovalTimeoutOutcome, } from "./approval/policy.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACxG,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAAC;IACvD,wBAAwB,EAAE,UAAU,CAAC,0BAA0B,CAAC,CAAC;IACjE,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAqCpE;AAGD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,gCAAgC,EAChC,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAG9B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -5,6 +5,8 @@ import { randomUUID } from "node:crypto";
 import { createOrchestrator } from "./orchestrator.js";
 import { createReconciler } from "./reconciler.js";
 import { createResumeTokenService } from "./resume-token.js";
+import { createMissionScheduler } from "./mission/scheduler.js";
+import { createApprovalEngine } from "./approval/engine.js";
 import { DEFAULT_JOB_ENGINE_CONFIG } from "./config.js";
 /** Assemble the durable job engine from ports + config. */
 export function createJobEngine(deps) {
@@ -14,6 +16,19 @@ export function createJobEngine(deps) {
         ttlSeconds: deps.config.resumeToken.ttlSeconds,
         nonce: deps.nonce,
     });
+    // S2: build the approval engine when its store is provided; it doubles as the approvalCreator.
+    const approval = deps.approvalStore
+        ? createApprovalEngine({
+            approvalStore: deps.approvalStore,
+            jobStore: deps.jobStore,
+            queue: deps.queue,
+            ops: deps.ops,
+            clock: deps.clock,
+            config: deps.config,
+            genApprovalId: deps.genApprovalId ?? (() => `appr_${randomUUID()}`),
+        })
+        : undefined;
+    const approvalCreator = deps.approvalCreator ?? approval;
     const orchestrator = createOrchestrator({
         jobStore: deps.jobStore,
         queue: deps.queue,
@@ -24,7 +39,7 @@ export function createJobEngine(deps) {
         resumeToken,
         config: deps.config,
         genStepId,
-        ...(deps.approvalCreator ? { approvalCreator: deps.approvalCreator } : {}),
+        ...(approvalCreator ? { approvalCreator } : {}),
     });
     const reconciler = createReconciler({
         jobStore: deps.jobStore,
@@ -35,16 +50,32 @@ export function createJobEngine(deps) {
         config: deps.config,
         lockTtlMs: deps.reconcileLockTtlMs ?? 30_000,
     });
+    // S2: cron mission scheduler when its store is provided.
+    const missions = deps.missionStore
+        ? createMissionScheduler({
+            missionStore: deps.missionStore,
+            jobStore: deps.jobStore,
+            ops: deps.ops,
+            clock: deps.clock,
+            genMissionRunId: deps.genMissionRunId ?? (() => `mrun_${randomUUID()}`),
+        })
+        : undefined;
     return {
         orchestrateJobStep: orchestrator.orchestrateJobStep,
         reconcileWaitingTimeJobs: reconciler.reconcileWaitingTimeJobs,
         resumeToken,
+        ...(approval ? { approval } : {}),
+        ...(missions ? { missions } : {}),
     };
 }
 // ── Public surface ──
 export { DEFAULT_JOB_ENGINE_CONFIG };
 export { createResumeTokenService, ResumeTokenError, } from "./resume-token.js";
 export { createWorkflowRegistry, BUILTIN_JOB_BASIC } from "./workflow/registry.js";
+// S2 — missions + approval
+export { createMissionScheduler } from "./mission/scheduler.js";
+export { isMissionCronDueAt, isWithinQuietHours, matchesCronField, parseDurationToMs, } from "./mission/cron.js";
+export { createApprovalEngine, } from "./approval/engine.js";
 // Enums + types
 export { JOB_STATUSES, TERMINAL_JOB_STATUSES, RUNNABLE_JOB_STATUSES, JOB_STEP_TYPES, JOB_STEP_STATUSES, JOB_STEP_TRIGGERED_BY, MISSION_RUN_STATUSES, isTerminalJobStatus, isRunnableJobStatus, } from "./enums.js";
 export { JOB_APPROVAL_POLICIES, DEFAULT_JOB_APPROVAL_POLICY, isJobApprovalPolicy, parseJobApprovalPolicy, resolveJobApprovalTimeoutOutcome, } from "./approval/policy.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,kFAAkF;AAClF,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAmD,MAAM,mBAAmB,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAA2B,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAwB,MAAM,aAAa,CAAC;AAoC9E,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IAEzD,MAAM,WAAW,GAAG,wBAAwB,CAAC;QAC3C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM;QACtC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU;QAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW;QACX,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS;QACT,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,gBAAgB,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,kBAAkB,IAAI,MAAM;KAC7C,CAAC,CAAC;IAEH,OAAO;QACL,kBAAkB,EAAE,YAAY,CAAC,kBAAkB;QACnD,wBAAwB,EAAE,UAAU,CAAC,wBAAwB;QAC7D,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,uBAAuB;AACvB,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAGrC,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GAGjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGnF,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GAOpB,MAAM,YAAY,CAAC;AAcpB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,EACtB,gCAAgC,GAGjC,MAAM,sBAAsB,CAAC;AAE9B,yCAAyC;AACzC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mission/cron.d.ts

@@ -0,0 +1,23 @@
+export interface ZonedDateParts {
+    year: number;
+    month: number;
+    dayOfMonth: number;
+    dayOfWeek: number;
+    hour: number;
+    minute: number;
+}
+export declare function matchesCronField(field: string, value: number, min: number, max: number): boolean;
+export declare function getZonedDateParts(date: Date, timezone: string): ZonedDateParts;
+export declare function parseDurationToMs(value: string): number;
+export declare function isWithinQuietHours(quietHours: {
+    start: string;
+    end: string;
+    timezone: string;
+}, now: Date): boolean;
+export declare function isMissionCronDueAt(params: {
+    cronExpression: string;
+    timezone: string;
+    now: Date;
+    lastTriggeredAt?: Date | null;
+}): boolean;
+//# sourceMappingURL=cron.d.ts.map

package/dist/mission/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/mission/cron.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAgDD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAKhG;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAkB9E;AAgBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC5D,GAAG,EAAE,IAAI,GACR,OAAO,CAcT;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,IAAI,CAAC;IACV,eAAe,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC/B,GAAG,OAAO,CAmCV"}

package/dist/mission/cron.js

@@ -0,0 +1,175 @@
+// Pure cron evaluation for missions — zero I/O (only Intl for timezone). Ported verbatim
+// from kader's mission-scheduler.service.ts so the due/quiet-hours semantics are identical:
+// 5-field cron, ranges, lists, `*/n` steps, timezone via Intl, and the standard day-of-month
+// OR day-of-week rule. Exported for direct unit testing.
+const WEEKDAY_TO_NUMBER = {
+    Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6,
+};
+function parseNumber(value) {
+    const parsed = parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function normalizeDayOfWeek(value) {
+    return value === 7 ? 0 : value;
+}
+function isValueInRange(value, min, max) {
+    return value >= min && value <= max;
+}
+function parseRangeToken(token, min, max) {
+    if (token === "*")
+        return { start: min, end: max };
+    if (token.includes("-")) {
+        const [rawStart, rawEnd] = token.split("-", 2);
+        if (!rawStart || !rawEnd)
+            return null;
+        const startParsed = parseNumber(rawStart);
+        const endParsed = parseNumber(rawEnd);
+        if (startParsed === null || endParsed === null)
+            return null;
+        const start = min === 0 && max === 6 ? normalizeDayOfWeek(startParsed) : startParsed;
+        const end = min === 0 && max === 6 ? normalizeDayOfWeek(endParsed) : endParsed;
+        if (!isValueInRange(start, min, max) || !isValueInRange(end, min, max))
+            return null;
+        if (end < start)
+            return null;
+        return { start, end };
+    }
+    const parsed = parseNumber(token);
+    if (parsed === null)
+        return null;
+    const normalized = min === 0 && max === 6 ? normalizeDayOfWeek(parsed) : parsed;
+    if (!isValueInRange(normalized, min, max))
+        return null;
+    return { start: normalized, end: normalized };
+}
+function matchesCronSegment(segment, value, min, max) {
+    const [baseToken, stepToken] = segment.split("/", 2);
+    if (!baseToken)
+        return false;
+    const range = parseRangeToken(baseToken, min, max);
+    if (!range)
+        return false;
+    if (!(value >= range.start && value <= range.end))
+        return false;
+    if (!stepToken)
+        return true;
+    const step = parseNumber(stepToken);
+    if (step === null || step <= 0)
+        return false;
+    return (value - range.start) % step === 0;
+}
+export function matchesCronField(field, value, min, max) {
+    const normalizedValue = min === 0 && max === 6 ? normalizeDayOfWeek(value) : value;
+    const segments = field.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    if (segments.length === 0)
+        return false;
+    return segments.some((segment) => matchesCronSegment(segment, normalizedValue, min, max));
+}
+export function getZonedDateParts(date, timezone) {
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: timezone, year: "numeric", month: "2-digit", day: "2-digit",
+        weekday: "short", hour: "2-digit", minute: "2-digit", hourCycle: "h23",
+    });
+    const values = new Map();
+    for (const part of formatter.formatToParts(date)) {
+        if (part.type !== "literal")
+            values.set(part.type, part.value);
+    }
+    const weekday = values.get("weekday") || "Sun";
+    return {
+        year: parseInt(values.get("year") || "1970", 10),
+        month: parseInt(values.get("month") || "1", 10),
+        dayOfMonth: parseInt(values.get("day") || "1", 10),
+        dayOfWeek: WEEKDAY_TO_NUMBER[weekday] ?? 0,
+        hour: parseInt(values.get("hour") || "0", 10),
+        minute: parseInt(values.get("minute") || "0", 10),
+    };
+}
+function toMinuteKey(parts) {
+    return `${parts.year}-${parts.month}-${parts.dayOfMonth}-${parts.hour}-${parts.minute}`;
+}
+function parseClockTimeToMinutes(value) {
+    const match = /^(\d{1,2}):(\d{2})$/.exec(value.trim());
+    if (!match)
+        return null;
+    const hours = parseInt(match[1], 10);
+    const minutes = parseInt(match[2], 10);
+    if (!Number.isFinite(hours) || !Number.isFinite(minutes))
+        return null;
+    if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59)
+        return null;
+    return hours * 60 + minutes;
+}
+export function parseDurationToMs(value) {
+    const match = /^(\d+)\s*(ms|s|m|h|d)$/.exec(value.trim().toLowerCase());
+    if (!match)
+        return 0;
+    const amount = parseInt(match[1], 10);
+    const unit = match[2];
+    if (unit === "ms")
+        return amount;
+    if (unit === "s")
+        return amount * 1000;
+    if (unit === "m")
+        return amount * 60 * 1000;
+    if (unit === "h")
+        return amount * 60 * 60 * 1000;
+    return amount * 24 * 60 * 60 * 1000;
+}
+export function isWithinQuietHours(quietHours, now) {
+    const startMinutes = parseClockTimeToMinutes(quietHours.start);
+    const endMinutes = parseClockTimeToMinutes(quietHours.end);
+    if (startMinutes === null || endMinutes === null)
+        return false;
+    if (startMinutes === endMinutes)
+        return false;
+    let zonedNow;
+    try {
+        zonedNow = getZonedDateParts(now, quietHours.timezone);
+    }
+    catch {
+        zonedNow = getZonedDateParts(now, "UTC");
+    }
+    const nowMinutes = zonedNow.hour * 60 + zonedNow.minute;
+    if (startMinutes < endMinutes)
+        return nowMinutes >= startMinutes && nowMinutes < endMinutes;
+    return nowMinutes >= startMinutes || nowMinutes < endMinutes;
+}
+export function isMissionCronDueAt(params) {
+    const fields = params.cronExpression.trim().split(/\s+/).map((v) => v.trim());
+    if (fields.length !== 5)
+        return false;
+    const [minuteField, hourField, dayOfMonthField, monthField, dayOfWeekField] = fields;
+    let nowParts;
+    try {
+        nowParts = getZonedDateParts(params.now, params.timezone);
+    }
+    catch {
+        nowParts = getZonedDateParts(params.now, "UTC");
+    }
+    if (params.lastTriggeredAt) {
+        let lastParts;
+        try {
+            lastParts = getZonedDateParts(params.lastTriggeredAt, params.timezone);
+        }
+        catch {
+            lastParts = getZonedDateParts(params.lastTriggeredAt, "UTC");
+        }
+        if (toMinuteKey(lastParts) === toMinuteKey(nowParts))
+            return false;
+    }
+    if (!matchesCronField(minuteField, nowParts.minute, 0, 59))
+        return false;
+    if (!matchesCronField(hourField, nowParts.hour, 0, 23))
+        return false;
+    if (!matchesCronField(monthField, nowParts.month, 1, 12))
+        return false;
+    const dayOfMonthMatches = matchesCronField(dayOfMonthField, nowParts.dayOfMonth, 1, 31);
+    const dayOfWeekMatches = matchesCronField(dayOfWeekField, nowParts.dayOfWeek, 0, 6);
+    const dayOfMonthIsWildcard = dayOfMonthField === "*";
+    const dayOfWeekIsWildcard = dayOfWeekField === "*";
+    if (!dayOfMonthIsWildcard && !dayOfWeekIsWildcard)
+        return dayOfMonthMatches || dayOfWeekMatches;
+    return dayOfMonthMatches && dayOfWeekMatches;
+}
+//# sourceMappingURL=cron.js.map

package/dist/mission/cron.js.map

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

package/dist/mission/scheduler.d.ts

@@ -0,0 +1,14 @@
+import type { ClockPort, JobOpsPort, JobStore, MissionStore } from "../port.js";
+import type { MissionSchedulerTickResult } from "../types.js";
+export interface MissionSchedulerDeps {
+    missionStore: MissionStore;
+    jobStore: JobStore;
+    ops: JobOpsPort;
+    clock: ClockPort;
+    genMissionRunId: () => string;
+}
+export interface MissionScheduler {
+    processSchedulerTick(now?: Date): Promise<MissionSchedulerTickResult>;
+}
+export declare function createMissionScheduler(deps: MissionSchedulerDeps): MissionScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/mission/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/mission/scheduler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhF,OAAO,KAAK,EAAiB,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAW7E,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACvE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CA0LnF"}

package/dist/mission/scheduler.js

@@ -0,0 +1,185 @@
+// Mission scheduler — evaluates cron missions and spawns jobs when due. Ported from kader's
+// processMissionSchedulerTick: the cron/quiet-hours/cooldown math is pure (./cron.js); every
+// Mongo call becomes a MissionStore / JobStore port call. Quiet-hours, cooldown, and the
+// overlap policy (skip | merge) are preserved exactly.
+import { isMissionCronDueAt, isWithinQuietHours, parseDurationToMs } from "./cron.js";
+const ACTIVE_JOB_STATUSES = [
+    "queued",
+    "running",
+    "waiting_time",
+    "waiting_event",
+    "awaiting_approval",
+    "paused",
+];
+export function createMissionScheduler(deps) {
+    const { missionStore, jobStore, ops, clock } = deps;
+    async function createSkippedRun(mission, now, skipReason, metadata) {
+        await missionStore.createMissionRun({
+            missionRunId: deps.genMissionRunId(),
+            missionId: mission.missionId,
+            tenantId: mission.tenantId,
+            triggerSource: "time",
+            status: "skipped",
+            spawnedJobId: null,
+            skipReason,
+            metadata: {
+                source: "mission_scheduler",
+                cronExpression: mission.trigger.cronExpression,
+                timezone: mission.trigger.timezone,
+                ...(metadata || {}),
+            },
+            startedAt: now,
+            completedAt: now,
+        });
+        ops.record({
+            jobId: `mission:${mission.missionId}`,
+            tenantId: mission.tenantId,
+            missionId: mission.missionId,
+            source: "mission_scheduler",
+            eventType: "mission.scheduler.run.skipped",
+            status: "skipped",
+            employeeId: mission.employeeId,
+            metadata: { reason: skipReason, ...(metadata || {}) },
+        });
+    }
+    async function processSchedulerTick(now = clock.now()) {
+        const missions = await missionStore.findSchedulableMissions();
+        const result = {
+            totalEnabled: missions.length,
+            cronEvaluated: 0,
+            triggered: 0,
+            skipped: 0,
+            merged: 0,
+            failed: 0,
+        };
+        for (const mission of missions) {
+            const cronExpression = mission.trigger?.cronExpression;
+            if (!cronExpression || typeof cronExpression !== "string")
+                continue;
+            result.cronEvaluated += 1;
+            const timezone = mission.trigger?.timezone || "UTC";
+            if (!isMissionCronDueAt({ cronExpression, timezone, now, lastTriggeredAt: mission.lastTriggeredAt })) {
+                continue;
+            }
+            const quiet = mission.safety?.quietHours;
+            if (quiet && isWithinQuietHours({ start: quiet.start, end: quiet.end, timezone: quiet.timezone || timezone }, now)) {
+                await createSkippedRun(mission, now, "quiet_hours");
+                result.skipped += 1;
+                continue;
+            }
+            const cooldownMs = parseDurationToMs(mission.safety?.cooldownAfterComplete || "0m");
+            if (cooldownMs > 0 && mission.lastTriggeredAt &&
+                now.getTime() - new Date(mission.lastTriggeredAt).getTime() < cooldownMs) {
+                await createSkippedRun(mission, now, "cooldown_active");
+                result.skipped += 1;
+                continue;
+            }
+            const activeJobs = await jobStore.countActiveByMission(mission.tenantId, mission.missionId, ACTIVE_JOB_STATUSES);
+            const maxConcurrentJobs = Math.max(1, mission.safety?.maxConcurrentJobs || 1);
+            if (activeJobs >= maxConcurrentJobs) {
+                const overlapPolicy = mission.safety?.overlapPolicy === "merge" ? "merge" : "skip";
+                if (overlapPolicy === "merge") {
+                    const anchor = await jobStore.findActiveMissionAnchor(mission.tenantId, mission.missionId, ACTIVE_JOB_STATUSES);
+                    if (anchor) {
+                        const existing = await missionStore.findMergedRun(mission.missionId, mission.tenantId, anchor.jobId);
+                        if (!existing) {
+                            await missionStore.createMissionRun({
+                                missionRunId: deps.genMissionRunId(),
+                                missionId: mission.missionId,
+                                tenantId: mission.tenantId,
+                                triggerSource: "time",
+                                status: "skipped",
+                                spawnedJobId: anchor.jobId,
+                                skipReason: "merged_into_active_job",
+                                metadata: { source: "mission_scheduler", mergedJobId: anchor.jobId, mergedJobStatus: anchor.status },
+                                startedAt: now,
+                                completedAt: now,
+                            });
+                            ops.record({
+                                jobId: anchor.jobId,
+                                tenantId: mission.tenantId,
+                                missionId: mission.missionId,
+                                source: "mission_scheduler",
+                                eventType: "mission.scheduler.run.merged",
+                                status: anchor.status,
+                                queueName: "jobs",
+                                employeeId: mission.employeeId,
+                                correlationId: anchor.correlationId,
+                                metadata: { mergedJobId: anchor.jobId, mergedReason: "max_concurrent_jobs_reached" },
+                            });
+                            result.merged += 1;
+                        }
+                        continue;
+                    }
+                }
+                await createSkippedRun(mission, now, "max_concurrent_jobs_reached", { overlapPolicy });
+                result.skipped += 1;
+                continue;
+            }
+            const missionRunId = deps.genMissionRunId();
+            await missionStore.createMissionRun({
+                missionRunId,
+                missionId: mission.missionId,
+                tenantId: mission.tenantId,
+                triggerSource: "time",
+                status: "started",
+                spawnedJobId: null,
+                skipReason: null,
+                metadata: { source: "mission_scheduler", cronExpression, timezone },
+                startedAt: now,
+                completedAt: null,
+            });
+            try {
+                const job = await jobStore.createJob({
+                    tenantId: mission.tenantId,
+                    employeeId: mission.employeeId,
+                    missionId: mission.missionId,
+                    workflowType: mission.workflowType,
+                    workflowVersion: mission.workflowVersion,
+                    state: mission.defaultState,
+                    ...(mission.budget ? { budget: mission.budget } : {}),
+                });
+                await missionStore.updateMissionRun(missionRunId, {
+                    status: "completed",
+                    spawnedJobId: job.jobId,
+                    completedAt: clock.now(),
+                });
+                await missionStore.markTriggered(mission.missionId, mission.tenantId, now);
+                ops.record({
+                    jobId: job.jobId,
+                    tenantId: mission.tenantId,
+                    missionId: mission.missionId,
+                    source: "mission_scheduler",
+                    eventType: "mission.scheduler.run.completed",
+                    status: "completed",
+                    queueName: "jobs",
+                    employeeId: mission.employeeId,
+                    correlationId: job.correlationId,
+                    metadata: { missionRunId, triggerSource: "time", cronExpression, timezone },
+                });
+                result.triggered += 1;
+            }
+            catch (error) {
+                await missionStore.updateMissionRun(missionRunId, {
+                    status: "failed",
+                    skipReason: error.message,
+                    completedAt: clock.now(),
+                });
+                ops.record({
+                    jobId: `mission:${mission.missionId}`,
+                    tenantId: mission.tenantId,
+                    missionId: mission.missionId,
+                    source: "mission_scheduler",
+                    eventType: "mission.scheduler.run.failed",
+                    status: "failed",
+                    employeeId: mission.employeeId,
+                    metadata: { error: error.message },
+                });
+                result.failed += 1;
+            }
+        }
+        return result;
+    }
+    return { processSchedulerTick };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/mission/scheduler.js.map

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

package/dist/port.d.ts

@@ -1,4 +1,4 @@
-import type { CreateJobInput, JobOpsEventInput, JobSnapshot, JobStepRecord, WorkflowContext, WorkflowResolution } from "./types.js";
+import type { ApprovalRecord, ApprovalStatus, CreateJobInput, JobOpsEventInput, JobSnapshot, JobStepRecord, MissionRecord, MissionRunRecord, WorkflowContext, WorkflowResolution } from "./types.js";
 import type { JobStatus, JobStepTriggeredBy, JobStepType } from "./enums.js";
 /** Thrown by `insertStep` when the unique idempotency key already exists. The adapter
  *  maps Mongo duplicate-key (code 11000) onto this; the engine never sees `11000`. */
@@ -46,6 +46,54 @@ export interface JobStore {
     findStepByIdempotencyKey(jobId: string, tenantId: string, idempotencyKey: string): Promise<JobStepRecord | null>;
     /** Reconciler scan: waiting_time jobs with a non-null resumeAt <= asOf, oldest first. */
     findDueWaitingTime(asOf: Date, limit: number): Promise<JobSnapshot[]>;
+    /** Count this mission's jobs in the given (active) statuses — overlap policy (S2). */
+    countActiveByMission(tenantId: string, missionId: string, statuses: JobStatus[]): Promise<number>;
+    /** The oldest active job for a mission (the merge anchor) — overlap policy "merge" (S2). */
+    findActiveMissionAnchor(tenantId: string, missionId: string, statuses: JobStatus[]): Promise<JobSnapshot | null>;
+}
+/** Mission persistence (S2). The cron tick is pure; these are its store calls. */
+export interface MissionStore {
+    /** Enabled, cron/hybrid-triggered missions. */
+    findSchedulableMissions(): Promise<MissionRecord[]>;
+    /** Stamp lastTriggeredAt after a successful spawn. */
+    markTriggered(missionId: string, tenantId: string, at: Date): Promise<void>;
+    createMissionRun(run: MissionRunRecord): Promise<void>;
+    updateMissionRun(missionRunId: string, patch: Partial<MissionRunRecord>): Promise<void>;
+    /** A prior "merged_into_active_job" run for this anchor (merge idempotency). */
+    findMergedRun(missionId: string, tenantId: string, mergedJobId: string): Promise<{
+        missionRunId: string;
+    } | null>;
+}
+/** HITL approval persistence (S2). */
+export interface ApprovalStore {
+    create(input: {
+        approvalId: string;
+        tenantId: string;
+        employeeId: string;
+        jobId: string;
+        jobStepNumber: number;
+        jobVersion: number;
+        action: Record<string, unknown>;
+        reasoning: string;
+        expiresAt: Date;
+    }): Promise<ApprovalRecord>;
+    /** An existing pending approval for this job step (idempotent create). */
+    findPendingForStep(tenantId: string, jobId: string, stepNumber: number): Promise<ApprovalRecord | null>;
+    /** One-shot CAS resolve: filter on status:'pending', $set decision, $inc version. */
+    resolve(args: {
+        approvalId: string;
+        tenantId: string;
+        toStatus: ApprovalStatus;
+        decidedBy: string;
+        decidedAt: Date;
+        updatedParams?: Record<string, unknown> | null;
+    }): Promise<ApprovalRecord | null>;
+    getById(approvalId: string, tenantId: string): Promise<ApprovalRecord | null>;
+    listPending(tenantId: string, opts?: {
+        jobId?: string;
+        limit?: number;
+    }): Promise<ApprovalRecord[]>;
+    findExpired(asOf: Date, limit: number): Promise<ApprovalRecord[]>;
 }
 /** Enqueues an orchestrator tick (BullMQ behind this; jobId-based dedup via dedupeKey). */
 export interface QueuePort {

package/dist/port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7E;sFACsF;AACtF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,SAAsD;CAI1E;AAED,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAErE,gEAAgE;IAChE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvD;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;QACtB,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEhC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEhC,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,yFAAyF;IACzF,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,wBAAwB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEjC,yFAAyF;IACzF,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACvE;AAED,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,IAAI,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,8FAA8F;AAC9F,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACxB,GAAG,IAAI,IAAI,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACvC;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,CAAC;CACvD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,EAAE;QACZ,QAAQ,EAAE,WAAW,CAAC;QACtB,WAAW,EAAE,kBAAkB,CAAC;QAChC,GAAG,EAAE,WAAW,CAAC;QACjB,UAAU,EAAE,kBAAkB,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CACzF;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,WAAW,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,SAAS,IAAI,MAAM,CAAC;CACrB"}
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"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"}

package/dist/port.js.map

@@ -1 +1 @@
-{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,mFAAmF;AACnF,yDAAyD;AACzD,EAAE;AACF,oFAAoF;AACpF,gFAAgF;AAChF,mFAAmF;AACnF,uEAAuE;AAYvE;sFACsF;AACtF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,GAAG,mDAAmD;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,mFAAmF;AACnF,yDAAyD;AACzD,EAAE;AACF,oFAAoF;AACpF,gFAAgF;AAChF,mFAAmF;AACnF,uEAAuE;AAgBvE;sFACsF;AACtF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,GAAG,mDAAmD;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { JobStatus, JobStepStatus, JobStepType, JobStepTriggeredBy } from "./enums.js";
+import type { JobStatus, JobStepStatus, JobStepType, JobStepTriggeredBy, MissionRunStatus } from "./enums.js";
 import type { JobApprovalPolicy, JobApprovalTimeoutOutcome } from "./approval/policy.js";
 export interface JobBudget {
     perStep: {
@@ -98,6 +98,8 @@ export interface WorkflowResolution {
     nextStatus: JobStatus;
     resumeDelayMs?: number;
     waitEventName?: string;
+    /** Target agent id for a `task_handoff` step (the StepExecutorPort hands off to it). */
+    handoffTo?: string;
     approvalPolicy?: JobApprovalPolicy;
     approvalTimeoutMs?: number;
     approvalTimeoutOutcome?: JobApprovalTimeoutOutcome | string;
@@ -119,6 +121,8 @@ export interface WorkflowSequenceStep {
     triggeredBy?: JobStepTriggeredBy;
     waitTimeMs?: number;
     waitEventName?: string;
+    /** For a `task_handoff` step: the target agent id to hand off to. */
+    handoffTo?: string;
     requiresApproval?: boolean;
     approvalPolicy?: JobApprovalPolicy;
     approvalTimeoutMs?: number;
@@ -131,4 +135,68 @@ export interface WorkflowDefinition {
     workflowVersion: string;
     sequence: WorkflowSequenceStep[];
 }
+export interface MissionTrigger {
+    cronExpression: string | null;
+    timezone: string;
+    eventNames?: string[];
+}
+export interface MissionQuietHours {
+    start: string;
+    end: string;
+    timezone: string;
+}
+export interface MissionSafety {
+    overlapPolicy: "skip" | "merge";
+    maxConcurrentJobs: number;
+    cooldownAfterComplete: string;
+    quietHours: MissionQuietHours;
+}
+/** A schedulable mission (what MissionStore.findSchedulableMissions returns). */
+export interface MissionRecord {
+    missionId: string;
+    tenantId: string;
+    employeeId: string;
+    workflowType: string;
+    workflowVersion: string;
+    defaultState: Record<string, unknown>;
+    trigger: MissionTrigger;
+    safety: MissionSafety;
+    budget?: Partial<JobBudget>;
+    lastTriggeredAt: Date | null;
+}
+export interface MissionRunRecord {
+    missionRunId: string;
+    missionId: string;
+    tenantId: string;
+    status: MissionRunStatus;
+    triggerSource: "time" | "event" | "manual";
+    spawnedJobId: string | null;
+    skipReason: string | null;
+    metadata?: Record<string, unknown>;
+    startedAt: Date;
+    completedAt: Date | null;
+}
+export interface MissionSchedulerTickResult {
+    totalEnabled: number;
+    cronEvaluated: number;
+    triggered: number;
+    skipped: number;
+    merged: number;
+    failed: number;
+}
+export type ApprovalStatus = "pending" | "approved" | "rejected" | "expired" | "cancelled";
+export interface ApprovalRecord {
+    approvalId: string;
+    tenantId: string;
+    employeeId: string;
+    jobId: string | null;
+    jobStepNumber: number | null;
+    jobVersion: number | null;
+    status: ApprovalStatus;
+    version: number;
+    decidedBy: string | null;
+    decidedAt: Date | null;
+    expiresAt: Date | null;
+    action?: Record<string, unknown>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/workflow/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/workflow/registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAEV,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAIrB,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,EAAE,kBAiB/B,CAAC;AAMF,MAAM,WAAW,6BAA6B;IAC5C,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,kBAAkB,EAAE,EACjC,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB,CA6FlB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/workflow/registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAEV,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAIrB,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,EAAE,kBAiB/B,CAAC;AAMF,MAAM,WAAW,6BAA6B;IAC5C,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,kBAAkB,EAAE,EACjC,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB,CAmGlB"}

package/dist/workflow/registry.js

@@ -100,6 +100,12 @@ export function createWorkflowRegistry(definitions, options = {}) {
         if (nextStatus === "waiting_event" && stepDefinition.waitEventName !== undefined) {
             resolution.waitEventName = stepDefinition.waitEventName;
         }
+        // task_handoff carries its target agent through to the StepExecutorPort (regardless of the
+        // transition the step then takes — fire-and-continue by default, or wait if the step declares
+        // waitEventName / terminalStatus).
+        if (stepDefinition.stepType === "task_handoff" && stepDefinition.handoffTo !== undefined) {
+            resolution.handoffTo = stepDefinition.handoffTo;
+        }
         if (nextStatus === "awaiting_approval") {
             resolution.approvalPolicy = approvalPolicy;
             resolution.approvalTimeoutOutcome = approvalTimeoutOutcome;

package/dist/workflow/registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msm-core/jobs",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Durable job/mission orchestration engine (CAS + idempotency state machine, cron missions, HITL approval). Pure decision logic; storage, queue, lock, clock injected via ports (no mongoose/bullmq/ioredis dependency).",
   "type": "module",
   "main": "./dist/index.js",