@msm-core/jobs 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# @msm-core/jobs
+
+Durable job / mission orchestration engine — a crash-safe state machine for long-running,
+resumable, human-gated agent work.
+
+**Pure decision logic over injected ports.** The engine carries NO `mongoose` / `bullmq` /
+`ioredis` dependency (only `jsonwebtoken`, for resume tokens). Storage, queue, lock, clock and
+the step executor are supplied by the consumer via the interfaces in `@msm-core/jobs/port` —
+exactly the way `@msm-core/memory` keeps persistence out of its core. A platform writes thin
+adapters (e.g. Mongo + BullMQ + Redis) and gets durable jobs.
+
+## What it does
+
+- **CAS + idempotency state machine** — version-guarded compare-and-swap on every transition;
+  an append-only step timeline keyed by a unique idempotency key. Crash-safe and exactly-once.
+- **Wait + resume** — `waiting_time` (delayed resume) and `waiting_event` (signed resume token,
+  one-time-use nonce). A wait-reconciler re-enqueues due jobs as a durability backstop.
+- **Pluggable workflows** — declarative `WorkflowDefinition`s (data, not code) resolve each step.
+- **Pluggable step executor** — `run_interaction_task` runs whatever the consumer wires (e.g. an
+  LLM agent turn); pure transitions (`wait_time` / `complete` / …) are no-ops.
+- **HITL approval hook** — a step can transition to `awaiting_approval` and resume on a decision.
+
+## Usage
+
+```ts
+import { createJobEngine, createWorkflowRegistry, DEFAULT_JOB_ENGINE_CONFIG } from "@msm-core/jobs";
+import type { JobStore, QueuePort /* … */ } from "@msm-core/jobs/port";
+
+const engine = createJobEngine({
+  jobStore, queue, lock, nonce, ops, clock,         // your adapters (implement ./port)
+  registry: createWorkflowRegistry(definitions),    // manifest-fed workflow definitions
+  stepExecutor,                                     // run_interaction_task → your agent turn
+  config: { ...DEFAULT_JOB_ENGINE_CONFIG, resumeToken: { secret, ttlSeconds: 86400 } },
+});
+
+await engine.orchestrateJobStep({ jobId, tenantId, reason: "create" });
+await engine.reconcileWaitingTimeJobs(); // periodic durability backstop
+```
+
+The ports (`JobStore.claim` / `finalizeStep` / `insertStep`, `QueuePort`, `LockPort`,
+`NoncePort`, `ClockPort`, `JobOpsPort`, `StepExecutorPort`, `WorkflowRegistry`) are documented
+in `port.ts`. `JobStore.insertStep` must throw `DuplicateStepError` on a repeated idempotency key
+(the adapter maps its store's duplicate-key error onto it).

package/dist/approval/policy.d.ts

@@ -0,0 +1,8 @@
+export declare const JOB_APPROVAL_POLICIES: readonly ["customer_facing", "internal_operational", "content_social"];
+export type JobApprovalPolicy = (typeof JOB_APPROVAL_POLICIES)[number];
+export type JobApprovalTimeoutOutcome = "escalate_to_human" | "notify_owner_paused" | "save_draft_remind_owner_next_day";
+export declare const DEFAULT_JOB_APPROVAL_POLICY: JobApprovalPolicy;
+export declare function isJobApprovalPolicy(value: unknown): value is JobApprovalPolicy;
+export declare function parseJobApprovalPolicy(value: unknown, fallback?: JobApprovalPolicy): JobApprovalPolicy;
+export declare function resolveJobApprovalTimeoutOutcome(policy: JobApprovalPolicy): JobApprovalTimeoutOutcome;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/approval/policy.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,wEAIxB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,MAAM,MAAM,yBAAyB,GACjC,mBAAmB,GACnB,qBAAqB,GACrB,kCAAkC,CAAC;AAEvC,eAAO,MAAM,2BAA2B,EAAE,iBAA0C,CAAC;AAErF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,iBAA+C,GACxD,iBAAiB,CAEnB;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,iBAAiB,GACxB,yBAAyB,CAI3B"}

package/dist/approval/policy.js

@@ -0,0 +1,22 @@
+// Pure approval policy resolution — no I/O. Ported verbatim from kader's
+// job-approval-policy.ts so the timeout-outcome semantics stay identical.
+export const JOB_APPROVAL_POLICIES = [
+    "customer_facing",
+    "internal_operational",
+    "content_social",
+];
+export const DEFAULT_JOB_APPROVAL_POLICY = "internal_operational";
+export function isJobApprovalPolicy(value) {
+    return typeof value === "string" && JOB_APPROVAL_POLICIES.includes(value);
+}
+export function parseJobApprovalPolicy(value, fallback = DEFAULT_JOB_APPROVAL_POLICY) {
+    return isJobApprovalPolicy(value) ? value : fallback;
+}
+export function resolveJobApprovalTimeoutOutcome(policy) {
+    if (policy === "customer_facing")
+        return "escalate_to_human";
+    if (policy === "content_social")
+        return "save_draft_remind_owner_next_day";
+    return "notify_owner_paused";
+}
+//# sourceMappingURL=policy.js.map

package/dist/approval/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/approval/policy.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAE1E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB;IACjB,sBAAsB;IACtB,gBAAgB;CACR,CAAC;AASX,MAAM,CAAC,MAAM,2BAA2B,GAAsB,sBAAsB,CAAC;AAErF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,qBAA2C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,WAA8B,2BAA2B;IAEzD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAyB;IAEzB,IAAI,MAAM,KAAK,iBAAiB;QAAE,OAAO,mBAAmB,CAAC;IAC7D,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,kCAAkC,CAAC;IAC3E,OAAO,qBAAqB,CAAC;AAC/B,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+export type ResumeMode = "delayed" | "scan_only";
+export interface JobEngineConfig {
+    /** Steps executed per orchestrator tick (clamped to 1..3, matching kader). */
+    maxStepsPerTick: number;
+    /** A waiting_time shorter than this is resumed inline within the same tick. */
+    inlineResumeMaxDelayMs: number;
+    /**
+     * How waiting_time resumes:
+     *  - "delayed":   orchestrator self-enqueues a delayed BullMQ tick (durable via Redis),
+     *                 wait-reconciler is OFF.
+     *  - "scan_only": orchestrator does NOT self-enqueue; the wait-reconciler scan re-enqueues
+     *                 due jobs (durable via the periodic scan).
+     */
+    resumeMode: ResumeMode;
+    /** Default wait_time delay when a workflow step omits one. */
+    defaultWaitMs: number;
+    /** Reconciler batch size per scan. */
+    waitReconcileBatchSize: number;
+    /** Resume-token (waiting_event) signing. */
+    resumeToken: {
+        secret: string;
+        ttlSeconds: number;
+    };
+}
+export declare const DEFAULT_JOB_ENGINE_CONFIG: JobEngineConfig;
+export interface OrchestratorRunConfig {
+    maxStepsPerTick: number;
+    inlineResumeMaxDelayMs: number;
+}
+export declare function resolveRunConfig(config: JobEngineConfig): OrchestratorRunConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +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"}

package/dist/config.js

@@ -0,0 +1,16 @@
+// Engine configuration. The consumer (platform-ai) builds this from env/manifest.
+export const DEFAULT_JOB_ENGINE_CONFIG = {
+    maxStepsPerTick: 3,
+    inlineResumeMaxDelayMs: 2_000,
+    resumeMode: "delayed",
+    defaultWaitMs: 60_000,
+    waitReconcileBatchSize: 50,
+    resumeToken: { secret: "", ttlSeconds: 86_400 },
+};
+export function resolveRunConfig(config) {
+    return {
+        maxStepsPerTick: Math.min(3, Math.max(1, config.maxStepsPerTick)),
+        inlineResumeMaxDelayMs: Math.max(0, config.inlineResumeMaxDelayMs),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +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"}

package/dist/enums.d.ts

@@ -0,0 +1,16 @@
+export declare const JOB_STATUSES: readonly ["queued", "running", "waiting_time", "waiting_event", "awaiting_approval", "paused", "completed", "failed", "cancelled"];
+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 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];
+export declare const JOB_STEP_TRIGGERED_BY: readonly ["time", "event", "manual", "mission", "task"];
+export type JobStepTriggeredBy = (typeof JOB_STEP_TRIGGERED_BY)[number];
+export declare const MISSION_RUN_STATUSES: readonly ["started", "completed", "skipped", "failed"];
+export type MissionRunStatus = (typeof MISSION_RUN_STATUSES)[number];
+export declare function isTerminalJobStatus(status: string): status is TerminalJobStatus;
+export declare function isRunnableJobStatus(status: string): boolean;
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +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"}

package/dist/enums.js

@@ -0,0 +1,35 @@
+// @msm-core/jobs — string enums for the durable job/mission engine.
+// Exported as `as const` arrays + derived union types: the pure engine uses the
+// union types; the storage adapter uses the value arrays to build its schema enums.
+export const JOB_STATUSES = [
+    "queued",
+    "running",
+    "waiting_time",
+    "waiting_event",
+    "awaiting_approval",
+    "paused",
+    "completed",
+    "failed",
+    "cancelled",
+];
+export const TERMINAL_JOB_STATUSES = ["completed", "failed", "cancelled"];
+export const RUNNABLE_JOB_STATUSES = ["queued", "running"];
+export const JOB_STEP_TYPES = [
+    "run_interaction_task",
+    "wait_time",
+    "wait_event",
+    "notify_owner",
+    "notify_customer",
+    "complete",
+    "fail",
+];
+export const JOB_STEP_STATUSES = ["running", "completed", "failed", "skipped"];
+export const JOB_STEP_TRIGGERED_BY = ["time", "event", "manual", "mission", "task"];
+export const MISSION_RUN_STATUSES = ["started", "completed", "skipped", "failed"];
+export function isTerminalJobStatus(status) {
+    return TERMINAL_JOB_STATUSES.includes(status);
+}
+export function isRunnableJobStatus(status) {
+    return RUNNABLE_JOB_STATUSES.includes(status);
+}
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { type Orchestrator, type OrchestrateJobStepInput } from "./orchestrator.js";
+import { type Reconciler } from "./reconciler.js";
+import { type ResumeTokenService } from "./resume-token.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";
+export interface CreateJobEngineDeps {
+    jobStore: JobStore;
+    queue: QueuePort;
+    lock: LockPort;
+    nonce: NoncePort;
+    ops: JobOpsPort;
+    clock: ClockPort;
+    registry: WorkflowRegistry;
+    stepExecutor: StepExecutorPort;
+    config: JobEngineConfig;
+    approvalCreator?: ApprovalCreatorPort;
+    /** Override the step-id generator (default: crypto.randomUUID). */
+    genStepId?: () => string;
+    /** Reconciler lock TTL (default: derived from the scan interval). */
+    reconcileLockTtlMs?: number;
+}
+export interface JobEngine {
+    orchestrateJobStep: Orchestrator["orchestrateJobStep"];
+    reconcileWaitingTimeJobs: Reconciler["reconcileWaitingTimeJobs"];
+    resumeToken: ResumeTokenService;
+}
+/** Assemble the durable job engine from ports + config. */
+export declare function createJobEngine(deps: CreateJobEngineDeps): JobEngine;
+export { DEFAULT_JOB_ENGINE_CONFIG };
+export type { JobEngineConfig, OrchestrateJobStepInput };
+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 { 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";
+export * from "./port.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,53 @@
+// @msm-core/jobs — durable job/mission orchestration engine. Pure decision logic over
+// injected ports (./port.js); no mongoose/bullmq/ioredis dependency. The consumer
+// (e.g. platform-ai's @platform/jobs) supplies the Mongo/BullMQ/Redis adapters.
+import { randomUUID } from "node:crypto";
+import { createOrchestrator } from "./orchestrator.js";
+import { createReconciler } from "./reconciler.js";
+import { createResumeTokenService } from "./resume-token.js";
+import { DEFAULT_JOB_ENGINE_CONFIG } from "./config.js";
+/** Assemble the durable job engine from ports + config. */
+export function createJobEngine(deps) {
+    const genStepId = deps.genStepId ?? (() => randomUUID());
+    const resumeToken = createResumeTokenService({
+        secret: deps.config.resumeToken.secret,
+        ttlSeconds: deps.config.resumeToken.ttlSeconds,
+        nonce: deps.nonce,
+    });
+    const orchestrator = createOrchestrator({
+        jobStore: deps.jobStore,
+        queue: deps.queue,
+        ops: deps.ops,
+        clock: deps.clock,
+        registry: deps.registry,
+        stepExecutor: deps.stepExecutor,
+        resumeToken,
+        config: deps.config,
+        genStepId,
+        ...(deps.approvalCreator ? { approvalCreator: deps.approvalCreator } : {}),
+    });
+    const reconciler = createReconciler({
+        jobStore: deps.jobStore,
+        queue: deps.queue,
+        lock: deps.lock,
+        ops: deps.ops,
+        clock: deps.clock,
+        config: deps.config,
+        lockTtlMs: deps.reconcileLockTtlMs ?? 30_000,
+    });
+    return {
+        orchestrateJobStep: orchestrator.orchestrateJobStep,
+        reconcileWaitingTimeJobs: reconciler.reconcileWaitingTimeJobs,
+        resumeToken,
+    };
+}
+// ── Public surface ──
+export { DEFAULT_JOB_ENGINE_CONFIG };
+export { createResumeTokenService, ResumeTokenError, } from "./resume-token.js";
+export { createWorkflowRegistry, BUILTIN_JOB_BASIC } from "./workflow/registry.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";
+// Ports + the typed atomic-failure error
+export * from "./port.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,26 @@
+import type { ApprovalCreatorPort, ClockPort, JobOpsPort, JobStore, QueuePort, StepExecutorPort, WorkflowRegistry } from "./port.js";
+import { type JobEngineConfig } from "./config.js";
+import type { ResumeTokenService } from "./resume-token.js";
+export interface OrchestrateJobStepInput {
+    jobId: string;
+    tenantId: string;
+    idempotencyKey?: string;
+    reason?: string;
+}
+export interface OrchestratorDeps {
+    jobStore: JobStore;
+    queue: QueuePort;
+    ops: JobOpsPort;
+    clock: ClockPort;
+    registry: WorkflowRegistry;
+    stepExecutor: StepExecutorPort;
+    resumeToken: ResumeTokenService;
+    config: JobEngineConfig;
+    genStepId: () => string;
+    approvalCreator?: ApprovalCreatorPort;
+}
+export interface Orchestrator {
+    orchestrateJobStep(input: OrchestrateJobStepInput): Promise<void>;
+}
+export declare function createOrchestrator(deps: OrchestratorDeps): Orchestrator;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,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,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CA6bvE"}