@msm-core/jobs 0.1.0

package/dist/reconciler.js

@@ -0,0 +1,75 @@
+// Wait reconciler — periodically re-enqueues waiting_time jobs whose resumeAt has
+// passed. The durability backstop. Ported from kader's job-wait-reconciler.service.ts;
+// the Mongo scan is a JobStore port call, the distributed lock is a LockPort call, and
+// the setInterval loop stays in the platform-side adapter (this is the pure decision).
+const RECONCILE_LOCK_KEY = "jobs:wait_reconcile:lock:v1";
+const QUEUE_NAME = "jobs";
+export function createReconciler(deps) {
+    const { jobStore, queue, lock, ops, clock, config } = deps;
+    async function reconcileWaitingTimeJobs(asOf = clock.now()) {
+        // In "delayed" mode the orchestrator self-enqueues delayed BullMQ ticks; the scan is off.
+        if (config.resumeMode === "delayed") {
+            return { locked: false, scanned: 0, enqueued: 0, failed: 0, skippedByMode: true, asOf: asOf.toISOString() };
+        }
+        const locked = await lock.acquire(RECONCILE_LOCK_KEY, Math.max(15_000, deps.lockTtlMs));
+        if (!locked) {
+            return { locked: false, scanned: 0, enqueued: 0, failed: 0, skippedByMode: false, asOf: asOf.toISOString() };
+        }
+        const batch = Math.max(1, config.waitReconcileBatchSize);
+        const dueJobs = await jobStore.findDueWaitingTime(asOf, batch);
+        let enqueued = 0;
+        let failed = 0;
+        for (const job of dueJobs) {
+            try {
+                const dedupeKey = job.resumeAt ? `${job.resumeAt.getTime()}` : `reconcile:${asOf.getTime()}`;
+                await queue.enqueue({
+                    jobId: job.jobId,
+                    tenantId: job.tenantId,
+                    reason: "waiting_time_reconcile",
+                    dedupeKey,
+                });
+                enqueued += 1;
+                ops.record({
+                    jobId: job.jobId,
+                    tenantId: job.tenantId,
+                    missionId: job.missionId,
+                    source: "job_wait_reconciler",
+                    eventType: "job.resumed.time",
+                    status: "queued",
+                    queueName: QUEUE_NAME,
+                    employeeId: job.employeeId,
+                    correlationId: job.correlationId,
+                    metadata: {
+                        reason: "waiting_time_reconcile",
+                        resumeAt: job.resumeAt ? new Date(job.resumeAt).toISOString() : null,
+                    },
+                });
+            }
+            catch (error) {
+                failed += 1;
+                ops.record({
+                    jobId: job.jobId,
+                    tenantId: job.tenantId,
+                    missionId: job.missionId,
+                    source: "job_wait_reconciler",
+                    eventType: "job.resume.reconcile_failed",
+                    status: "failed",
+                    queueName: QUEUE_NAME,
+                    employeeId: job.employeeId,
+                    correlationId: job.correlationId,
+                    metadata: { reason: "waiting_time_reconcile", error: error.message },
+                });
+            }
+        }
+        return {
+            locked: true,
+            scanned: dueJobs.length,
+            enqueued,
+            failed,
+            skippedByMode: false,
+            asOf: asOf.toISOString(),
+        };
+    }
+    return { reconcileWaitingTimeJobs };
+}
+//# sourceMappingURL=reconciler.js.map

package/dist/reconciler.js.map

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

package/dist/resume-token.d.ts

@@ -0,0 +1,40 @@
+import type { NoncePort } from "./port.js";
+export declare class ResumeTokenError extends Error {
+    code: string;
+    httpStatus: number;
+    constructor(code: string, message: string, httpStatus?: number);
+}
+export interface IssueResumeTokenInput {
+    tenantId: string;
+    jobId: string;
+    eventName: string;
+}
+export interface IssuedResumeToken {
+    token: string;
+    nonce: string;
+    expiresAt: string;
+    ttlSeconds: number;
+}
+export interface ValidateResumeTokenInput {
+    token: string;
+    tenantId: string;
+    jobId: string;
+    eventName: string;
+    payload?: unknown;
+}
+export interface ConsumedResumeToken {
+    nonce: string;
+    expiresAtEpochSeconds: number;
+}
+export interface ResumeTokenDeps {
+    secret: string;
+    ttlSeconds: number;
+    nonce: NoncePort;
+}
+export interface ResumeTokenService {
+    issue(input: IssueResumeTokenInput): IssuedResumeToken;
+    validateAndConsume(input: ValidateResumeTokenInput): Promise<ConsumedResumeToken>;
+    ttlSeconds: number;
+}
+export declare function createResumeTokenService(deps: ResumeTokenDeps): ResumeTokenService;
+//# sourceMappingURL=resume-token.d.ts.map

package/dist/resume-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-token.d.ts","sourceRoot":"","sources":["../src/resume-token.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAI3C,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;gBACP,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAM;CAM5D;AAUD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAMD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,iBAAiB,CAAC;IACvD,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CA2HlF"}

package/dist/resume-token.js

@@ -0,0 +1,116 @@
+// waiting_event resume tokens — pure crypto (jsonwebtoken + node:crypto) with
+// one-time-use replay protection via the injected NoncePort. Ported from kader's
+// job-resume-token.service.ts. `jsonwebtoken` is the engine's only runtime dep
+// (pure crypto, not infrastructure).
+import { randomUUID } from "node:crypto";
+import jwt from "jsonwebtoken";
+const RESUME_NONCE_KEY_PREFIX = "jobs:resume:nonce:v1";
+export class ResumeTokenError extends Error {
+    code;
+    httpStatus;
+    constructor(code, message, httpStatus = 401) {
+        super(message);
+        this.name = "ResumeTokenError";
+        this.code = code;
+        this.httpStatus = httpStatus;
+    }
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+export function createResumeTokenService(deps) {
+    const ttlSeconds = Math.max(60, deps.ttlSeconds);
+    function getSecret() {
+        if (!isNonEmptyString(deps.secret)) {
+            throw new ResumeTokenError("JOB_EVENT_TOKEN_SECRET_INVALID", "Resume token signing secret is not configured", 500);
+        }
+        return deps.secret;
+    }
+    function buildNonceKey(claims) {
+        return `${RESUME_NONCE_KEY_PREFIX}:${claims.tenantId}:${claims.jobId}:${claims.eventName}:${claims.nonce}`;
+    }
+    function parseClaims(token) {
+        const secret = getSecret();
+        let decoded;
+        try {
+            decoded = jwt.verify(token, secret, { algorithms: ["HS256"] });
+        }
+        catch (error) {
+            throw new ResumeTokenError("JOB_EVENT_TOKEN_INVALID", "Event token is invalid or expired", 401);
+        }
+        if (typeof decoded === "string") {
+            throw new ResumeTokenError("JOB_EVENT_TOKEN_INVALID", "Event token payload is malformed", 401);
+        }
+        const candidate = decoded;
+        if (candidate.typ !== "job_resume" ||
+            !isNonEmptyString(candidate.tenantId) ||
+            !isNonEmptyString(candidate.jobId) ||
+            !isNonEmptyString(candidate.eventName) ||
+            !isNonEmptyString(candidate.nonce)) {
+            throw new ResumeTokenError("JOB_EVENT_TOKEN_INVALID", "Event token claims are malformed", 401);
+        }
+        return candidate;
+    }
+    function assertTokenBinding(claims, expected) {
+        if (claims.tenantId !== expected.tenantId ||
+            claims.jobId !== expected.jobId ||
+            claims.eventName !== expected.eventName) {
+            throw new ResumeTokenError("JOB_EVENT_TOKEN_INVALID", "Event token does not match requested binding", 401);
+        }
+    }
+    function assertPayloadBinding(payload, claims) {
+        if (!payload || typeof payload !== "object" || Array.isArray(payload))
+            return;
+        const rec = payload;
+        const mismatches = [];
+        if ("tenantId" in rec && rec.tenantId !== claims.tenantId)
+            mismatches.push("tenantId");
+        if ("jobId" in rec && rec.jobId !== claims.jobId)
+            mismatches.push("jobId");
+        if ("eventName" in rec && rec.eventName !== claims.eventName)
+            mismatches.push("eventName");
+        if ("nonce" in rec && rec.nonce !== claims.nonce)
+            mismatches.push("nonce");
+        if (mismatches.length > 0) {
+            throw new ResumeTokenError("JOB_EVENT_PAYLOAD_INVALID", "Event payload binding mismatch", 400);
+        }
+    }
+    async function consumeNonce(claims) {
+        const nowEpochSeconds = Math.floor(Date.now() / 1000);
+        const tokenExpirySeconds = typeof claims.exp === "number" ? claims.exp : nowEpochSeconds + ttlSeconds;
+        const nonceTtl = Math.max(ttlSeconds, tokenExpirySeconds - nowEpochSeconds, 1);
+        const key = buildNonceKey(claims);
+        let claimed;
+        try {
+            claimed = await deps.nonce.claimOnce(key, nonceTtl);
+        }
+        catch (error) {
+            throw new ResumeTokenError("JOB_EVENT_REPLAY_UNAVAILABLE", "Could not validate event replay protection", 503);
+        }
+        if (!claimed) {
+            throw new ResumeTokenError("JOB_EVENT_TOKEN_REPLAY", "Event token has already been consumed", 409);
+        }
+    }
+    function issue(input) {
+        const secret = getSecret();
+        const nonce = randomUUID();
+        const token = jwt.sign({ typ: "job_resume", tenantId: input.tenantId, jobId: input.jobId, eventName: input.eventName, nonce }, secret, { algorithm: "HS256", expiresIn: ttlSeconds });
+        return {
+            token,
+            nonce,
+            ttlSeconds,
+            expiresAt: new Date(Date.now() + ttlSeconds * 1000).toISOString(),
+        };
+    }
+    async function validateAndConsume(input) {
+        const claims = parseClaims(input.token);
+        assertTokenBinding(claims, input);
+        assertPayloadBinding(input.payload, claims);
+        await consumeNonce(claims);
+        const nowEpochSeconds = Math.floor(Date.now() / 1000);
+        const expiresAtEpochSeconds = typeof claims.exp === "number" ? claims.exp : nowEpochSeconds + ttlSeconds;
+        return { nonce: claims.nonce, expiresAtEpochSeconds };
+    }
+    return { issue, validateAndConsume, ttlSeconds };
+}
+//# sourceMappingURL=resume-token.js.map

package/dist/resume-token.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,134 @@
+import type { JobStatus, JobStepStatus, JobStepType, JobStepTriggeredBy } from "./enums.js";
+import type { JobApprovalPolicy, JobApprovalTimeoutOutcome } from "./approval/policy.js";
+export interface JobBudget {
+    perStep: {
+        maxIterations: number;
+        maxCostUsd: number;
+        timeoutMs: number;
+    };
+    totalJob: {
+        maxSteps: number;
+        maxTotalCostUsd: number;
+        maxDurationMs: number;
+    };
+}
+export interface JobWaitEvent {
+    eventName: string | null;
+    token: string | null;
+}
+/** A read snapshot of a Job — what the engine reasons over. Ids are opaque strings. */
+export interface JobSnapshot {
+    jobId: string;
+    tenantId: string;
+    employeeId: string;
+    missionId: string | null;
+    status: JobStatus;
+    workflowType: string;
+    workflowVersion: string;
+    currentStep: number;
+    state: Record<string, unknown>;
+    attempt: number;
+    resumeAt: Date | null;
+    waitEvent: JobWaitEvent | null;
+    correlationId: string;
+    budget: JobBudget;
+    version: number;
+    totalStepsExecuted: number;
+    totalCostUsd: number;
+    startedAt: Date | null;
+    completedAt: Date | null;
+}
+export interface JobStepToolCall {
+    toolName: string;
+    success: boolean;
+    durationMs?: number;
+    costUsd?: number;
+    errorCode?: string;
+}
+/** An append-only step record (one workflow transition). */
+export interface JobStepRecord {
+    stepId: string;
+    jobId: string;
+    tenantId: string;
+    stepNumber: number;
+    stepType: JobStepType;
+    status: JobStepStatus;
+    triggeredBy: JobStepTriggeredBy;
+    startedAt: Date;
+    endedAt: Date | null;
+    durationMs: number;
+    toolCalls: JobStepToolCall[];
+    output: Record<string, unknown> | null;
+    error: {
+        code?: string;
+        message?: string;
+    } | null;
+    nextStep: string | null;
+    transitionReason: string | null;
+    idempotencyKey: string;
+}
+/** Inputs to create a new durable job. */
+export interface CreateJobInput {
+    tenantId: string;
+    employeeId: string;
+    workflowType: string;
+    workflowVersion: string;
+    missionId?: string | null;
+    correlationId?: string;
+    state?: Record<string, unknown>;
+    budget?: Partial<JobBudget>;
+}
+/** Operational ledger event the engine emits through JobOpsPort (fire-and-forget). */
+export interface JobOpsEventInput {
+    jobId: string;
+    tenantId: string;
+    missionId?: string | null;
+    source: string;
+    eventType: string;
+    status?: string | null;
+    queueName?: string | null;
+    employeeId?: string | null;
+    correlationId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface WorkflowResolution {
+    stepType: JobStepType;
+    triggeredBy: JobStepTriggeredBy;
+    transitionReason: string;
+    nextStatus: JobStatus;
+    resumeDelayMs?: number;
+    waitEventName?: string;
+    approvalPolicy?: JobApprovalPolicy;
+    approvalTimeoutMs?: number;
+    approvalTimeoutOutcome?: JobApprovalTimeoutOutcome | string;
+    statePatch?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+}
+export interface WorkflowContext {
+    workflowType: string;
+    workflowVersion: string;
+    budget: JobBudget;
+    state: Record<string, unknown>;
+    stepNumber: number;
+    reason: string;
+    now: Date;
+}
+/** One step in a declarative workflow definition (fed from the manifest in platform-ai). */
+export interface WorkflowSequenceStep {
+    stepType: JobStepType;
+    triggeredBy?: JobStepTriggeredBy;
+    waitTimeMs?: number;
+    waitEventName?: string;
+    requiresApproval?: boolean;
+    approvalPolicy?: JobApprovalPolicy;
+    approvalTimeoutMs?: number;
+    terminalStatus?: Extract<JobStatus, "completed" | "failed" | "cancelled">;
+    transitionReason?: string;
+    output?: Record<string, unknown>;
+}
+export interface WorkflowDefinition {
+    workflowType: string;
+    workflowVersion: string;
+    sequence: WorkflowSequenceStep[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+// @msm-core/jobs — the pure data shapes. These are storage-agnostic: the Mongo
+// adapter maps its documents onto these, the engine only ever sees these.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E"}

package/dist/workflow/registry.d.ts

@@ -0,0 +1,10 @@
+import type { WorkflowRegistry } from "../port.js";
+import type { WorkflowDefinition } from "../types.js";
+/** A minimal built-in workflow so a fresh deploy can run a job before any are declared. */
+export declare const BUILTIN_JOB_BASIC: WorkflowDefinition;
+export interface CreateWorkflowRegistryOptions {
+    /** Wait used when a step resolves to waiting_time without an explicit waitTimeMs. */
+    defaultWaitMs?: number;
+}
+export declare function createWorkflowRegistry(definitions: WorkflowDefinition[], options?: CreateWorkflowRegistryOptions): WorkflowRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

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

package/dist/workflow/registry.js

@@ -0,0 +1,114 @@
+// Default, data-driven workflow registry. Ported from kader's workflow-registry.ts,
+// but the workflow definitions are INJECTED (in platform-ai they come from the client
+// manifest's `missions[].sequence`) instead of being hardcoded. The resolution logic
+// is identical to kader's so the state-machine semantics are preserved exactly.
+import { DEFAULT_JOB_APPROVAL_POLICY, resolveJobApprovalTimeoutOutcome, } from "../approval/policy.js";
+const DEFAULT_WAIT_MS = 60_000;
+/** A minimal built-in workflow so a fresh deploy can run a job before any are declared. */
+export const BUILTIN_JOB_BASIC = {
+    workflowType: "job.basic",
+    workflowVersion: "1.0.0",
+    sequence: [
+        {
+            stepType: "run_interaction_task",
+            triggeredBy: "task",
+            waitTimeMs: DEFAULT_WAIT_MS,
+            transitionReason: "initial_iteration",
+        },
+        {
+            stepType: "run_interaction_task",
+            triggeredBy: "time",
+            terminalStatus: "completed",
+            transitionReason: "second_iteration_completed",
+        },
+    ],
+};
+function normalizeWorkflowType(workflowType) {
+    return workflowType.trim().toLowerCase();
+}
+export function createWorkflowRegistry(definitions, options = {}) {
+    const defaultWaitMs = options.defaultWaitMs ?? DEFAULT_WAIT_MS;
+    // Always provide a fallback so resolution never throws on an unknown type.
+    const defs = definitions.some((d) => normalizeWorkflowType(d.workflowType) === "job.basic")
+        ? definitions
+        : [...definitions, BUILTIN_JOB_BASIC];
+    function getDefinition(workflowType, workflowVersion) {
+        const normalizedType = normalizeWorkflowType(workflowType);
+        const exact = defs.find((d) => normalizeWorkflowType(d.workflowType) === normalizedType &&
+            d.workflowVersion === workflowVersion);
+        if (exact)
+            return exact;
+        const latestForType = defs.find((d) => normalizeWorkflowType(d.workflowType) === normalizedType);
+        if (latestForType)
+            return latestForType;
+        return defs.find((d) => normalizeWorkflowType(d.workflowType) === "job.basic");
+    }
+    function resolveStep(context) {
+        const definition = getDefinition(context.workflowType, context.workflowVersion);
+        const sequenceIndex = Math.max(0, context.stepNumber - 1);
+        const stepDefinition = definition.sequence[Math.min(sequenceIndex, definition.sequence.length - 1)];
+        const reachedBudgetMaxSteps = context.stepNumber >= context.budget.totalJob.maxSteps;
+        let nextStatus;
+        if (reachedBudgetMaxSteps) {
+            nextStatus = "completed";
+        }
+        else if (stepDefinition.terminalStatus) {
+            nextStatus = stepDefinition.terminalStatus;
+        }
+        else if (stepDefinition.requiresApproval) {
+            nextStatus = "awaiting_approval";
+        }
+        else if (stepDefinition.waitEventName) {
+            nextStatus = "waiting_event";
+        }
+        else {
+            nextStatus = "waiting_time";
+        }
+        const approvalPolicy = stepDefinition.approvalPolicy || DEFAULT_JOB_APPROVAL_POLICY;
+        const approvalTimeoutOutcome = resolveJobApprovalTimeoutOutcome(approvalPolicy);
+        const transitionReason = reachedBudgetMaxSteps
+            ? "budget_max_steps_reached"
+            : stepDefinition.transitionReason || "workflow_transition";
+        const resolution = {
+            stepType: stepDefinition.stepType,
+            triggeredBy: stepDefinition.triggeredBy || "task",
+            transitionReason,
+            nextStatus,
+            statePatch: {
+                workflow: {
+                    type: context.workflowType,
+                    version: context.workflowVersion,
+                    sequenceIndex,
+                    lastTransitionReason: transitionReason,
+                },
+                pendingApproval: nextStatus === "awaiting_approval"
+                    ? { policy: approvalPolicy, timeoutOutcome: approvalTimeoutOutcome }
+                    : null,
+                lastOrchestrationReason: context.reason,
+                lastOrchestratedAt: context.now.toISOString(),
+            },
+            output: {
+                workflowType: context.workflowType,
+                workflowVersion: context.workflowVersion,
+                transitionReason,
+                ...(stepDefinition.output || {}),
+            },
+        };
+        if (nextStatus === "waiting_time") {
+            resolution.resumeDelayMs = stepDefinition.waitTimeMs ?? defaultWaitMs;
+        }
+        if (nextStatus === "waiting_event" && stepDefinition.waitEventName !== undefined) {
+            resolution.waitEventName = stepDefinition.waitEventName;
+        }
+        if (nextStatus === "awaiting_approval") {
+            resolution.approvalPolicy = approvalPolicy;
+            resolution.approvalTimeoutOutcome = approvalTimeoutOutcome;
+            if (stepDefinition.approvalTimeoutMs !== undefined) {
+                resolution.approvalTimeoutMs = stepDefinition.approvalTimeoutMs;
+            }
+        }
+        return resolution;
+    }
+    return { resolveStep };
+}
+//# sourceMappingURL=registry.js.map

package/dist/workflow/registry.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@msm-core/jobs",
+  "version": "0.1.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",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./port": {
+      "types": "./dist/port.d.ts",
+      "import": "./dist/port.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/msm-core/sdk.git",
+    "directory": "jobs"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "jsonwebtoken": "^9.0.2"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9.0.6",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "license": "UNLICENSED",
+  "author": "Emad Jumaah"
+}