@polpo-ai/core 0.15.45 → 0.15.47

package/dist/scheduling/dispatcher.js

@@ -0,0 +1,201 @@
+import { normalizeScheduleInvocation, normalizeScheduleMetadata, } from "./validation.js";
+export class ScheduleDispatchError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable, options) {
+        super(message, options);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "ScheduleDispatchError";
+    }
+}
+/**
+ * Validates and routes schedule invocations to host-provided surface handlers.
+ *
+ * This class deliberately does not implement agent, task, channel, webhook, or
+ * mission behavior. Hosts inject their existing direct-invocation paths.
+ */
+export class InjectedScheduleDispatcher {
+    handlers;
+    constructor(handlers) {
+        this.handlers = handlers;
+        if (!handlers || typeof handlers !== "object" || Array.isArray(handlers)) {
+            throw new ScheduleDispatchError("INVALID_CONTEXT", "Schedule dispatcher requires a handler map", false);
+        }
+    }
+    async dispatch(run, schedule, options = {}) {
+        validateContext(run, schedule);
+        const signal = options.signal ?? new AbortController().signal;
+        assertNotAborted(signal);
+        let invocation;
+        try {
+            invocation = normalizeScheduleInvocation(schedule.invocation);
+        }
+        catch (cause) {
+            throw new ScheduleDispatchError("INVALID_INVOCATION", `Schedule "${schedule.id}" has an invalid invocation: ${errorMessage(cause)}`, false, { cause });
+        }
+        const context = { schedule, run, invocation, signal };
+        let rawResult;
+        switch (invocation.surface) {
+            case "agent":
+                rawResult = await requireHandler(this.handlers.agent, invocation.surface)({ ...context, invocation });
+                break;
+            case "task":
+                rawResult = await requireHandler(this.handlers.task, invocation.surface)({ ...context, invocation });
+                break;
+            case "channel":
+                rawResult = await requireHandler(this.handlers.channel, invocation.surface)({ ...context, invocation });
+                break;
+            case "webhook":
+                rawResult = await requireHandler(this.handlers.webhook, invocation.surface)({ ...context, invocation });
+                break;
+            case "legacy_mission":
+                rawResult = await requireHandler(this.handlers.legacyMission, invocation.surface)({ ...context, invocation });
+                break;
+        }
+        assertNotAborted(signal);
+        try {
+            return normalizeDispatchResult(rawResult, invocation.surface);
+        }
+        catch (cause) {
+            if (cause instanceof ScheduleDispatchError)
+                throw cause;
+            throw new ScheduleDispatchError("INVALID_RESULT", `Schedule "${schedule.id}" handler returned an invalid result: ${errorMessage(cause)}`, false, { cause });
+        }
+    }
+}
+function validateContext(run, schedule) {
+    if (!run || !schedule || run.scheduleId !== schedule.id) {
+        throw new ScheduleDispatchError("INVALID_CONTEXT", "Schedule run and schedule do not refer to the same schedule", false);
+    }
+    if (run.status !== "running") {
+        throw new ScheduleDispatchError("INVALID_CONTEXT", `Schedule run "${run.id}" must be running before dispatch`, false);
+    }
+    if (schedule.status !== "active") {
+        throw new ScheduleDispatchError("INVALID_CONTEXT", `Schedule "${schedule.id}" must be active before dispatch`, false);
+    }
+}
+function requireHandler(handler, surface) {
+    if (typeof handler !== "function") {
+        throw new ScheduleDispatchError("HANDLER_UNAVAILABLE", `No schedule handler is configured for surface "${surface}"`, false);
+    }
+    return handler;
+}
+function assertNotAborted(signal) {
+    if (!signal.aborted)
+        return;
+    throw new ScheduleDispatchError("ABORTED", "Schedule dispatch was aborted", true, signal.reason === undefined ? undefined : { cause: signal.reason });
+}
+function normalizeDispatchResult(value, surface) {
+    const result = record(value, "Schedule dispatch result");
+    assertKnownKeys(result, ["status", "references", "result", "error"], "Schedule dispatch result");
+    if (result.status !== "succeeded"
+        && result.status !== "failed"
+        && result.status !== "skipped"
+        && result.status !== "cancelled") {
+        throw new Error("Schedule dispatch result status must be succeeded, failed, skipped, or cancelled");
+    }
+    const references = normalizeReferences(result.references);
+    if (result.status === "succeeded") {
+        assertSuccessfulReferences(surface, references);
+        if (result.error !== undefined) {
+            throw new Error("A successful schedule dispatch result cannot include an error");
+        }
+    }
+    if (result.status === "failed" && result.error === undefined) {
+        throw new Error("A failed schedule dispatch result requires an error");
+    }
+    return {
+        status: result.status,
+        references,
+        ...(result.result === undefined
+            ? {}
+            : {
+                result: normalizeScheduleMetadata(result.result, "Schedule dispatch result metadata"),
+            }),
+        ...(result.error === undefined
+            ? {}
+            : { error: normalizeDispatchError(result.error) }),
+    };
+}
+function normalizeReferences(value) {
+    const references = record(value, "Schedule dispatch references");
+    const keys = [
+        "runtimeId",
+        "taskId",
+        "loopRunId",
+        "sessionId",
+        "channelEventId",
+        "providerDeliveryId",
+    ];
+    assertKnownKeys(references, keys, "Schedule dispatch references");
+    const normalized = {};
+    for (const key of keys) {
+        if (references[key] !== undefined) {
+            normalized[key] = nonEmptyString(references[key], `Schedule dispatch reference ${key}`);
+        }
+    }
+    return normalized;
+}
+function assertSuccessfulReferences(surface, references) {
+    const valid = (() => {
+        switch (surface) {
+            case "agent":
+                return Boolean(references.runtimeId || references.loopRunId);
+            case "task":
+                return Boolean(references.taskId);
+            case "channel":
+                return Boolean(references.channelEventId || references.providerDeliveryId);
+            case "webhook":
+                return Boolean(references.providerDeliveryId);
+            case "legacy_mission":
+                return true;
+        }
+    })();
+    if (!valid) {
+        throw new Error(`A successful "${surface}" dispatch result is missing its durable reference`);
+    }
+}
+function normalizeDispatchError(value) {
+    const error = record(value, "Schedule dispatch error");
+    assertKnownKeys(error, ["code", "message", "retryable", "metadata"], "Schedule dispatch error");
+    if (typeof error.retryable !== "boolean") {
+        throw new Error("Schedule dispatch error retryable must be a boolean");
+    }
+    return {
+        code: nonEmptyString(error.code, "Schedule dispatch error code"),
+        message: nonEmptyString(error.message, "Schedule dispatch error message"),
+        retryable: error.retryable,
+        ...(error.metadata === undefined
+            ? {}
+            : {
+                metadata: normalizeScheduleMetadata(error.metadata, "Schedule dispatch error metadata"),
+            }),
+    };
+}
+function record(value, label) {
+    if (!value
+        || typeof value !== "object"
+        || Array.isArray(value)
+        || Object.getPrototypeOf(value) !== Object.prototype) {
+        throw new Error(`${label} must be a plain object`);
+    }
+    return value;
+}
+function assertKnownKeys(value, allowed, label) {
+    const known = new Set(allowed);
+    const unknown = Object.keys(value).filter((key) => !known.has(key));
+    if (unknown.length > 0) {
+        throw new Error(`${label} contains unknown field "${unknown[0]}"`);
+    }
+}
+function nonEmptyString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/scheduling/dispatcher.js.map

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

package/dist/scheduling/dispatcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dispatcher.test.d.ts.map

package/dist/scheduling/dispatcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.test.d.ts","sourceRoot":"","sources":["../../src/scheduling/dispatcher.test.ts"],"names":[],"mappings":""}

package/dist/scheduling/dispatcher.test.js

@@ -0,0 +1,378 @@
+import { describe, expect, it, vi } from "vitest";
+import { InjectedScheduleDispatcher, ScheduleDispatchError, } from "./index.js";
+function schedule(invocation = {
+    surface: "agent",
+    agentName: "assistant",
+    input: { prompt: "Prepare the report" },
+    session: {
+        mode: "reuse",
+        sessionId: "session-1",
+        userId: "user-1",
+    },
+    execution: {
+        loop: "research",
+        model: "openai/gpt-5",
+        sandbox: { isolation: "fresh" },
+        guardrails: { mode: "strict" },
+        metadata: { source: "schedule" },
+    },
+}) {
+    return {
+        id: "schedule-1",
+        timing: {
+            kind: "cron",
+            expression: "0 9 * * *",
+            timezone: "Europe/Rome",
+        },
+        invocation,
+        status: "active",
+        policy: {
+            catchUp: "skip",
+            misfireGraceSeconds: 300,
+            maxConcurrency: 1,
+        },
+        metadata: {},
+        createdAt: "2026-07-28T08:00:00.000Z",
+        updatedAt: "2026-07-28T08:00:00.000Z",
+        revision: 1,
+    };
+}
+function run(overrides = {}) {
+    return {
+        id: "schedule-run-1",
+        scheduleId: "schedule-1",
+        occurrenceAt: "2026-07-28T09:00:00.000Z",
+        triggerId: "trigger-1",
+        idempotencyKey: "schedule:schedule-1:2026-07-28T09:00:00.000Z",
+        status: "running",
+        attempts: 1,
+        references: {},
+        createdAt: "2026-07-28T09:00:00.000Z",
+        updatedAt: "2026-07-28T09:00:01.000Z",
+        startedAt: "2026-07-28T09:00:01.000Z",
+        ...overrides,
+    };
+}
+describe("InjectedScheduleDispatcher", () => {
+    it("dispatches an agent invocation with normalized execution context", async () => {
+        const agent = vi.fn(async () => ({
+            status: "succeeded",
+            references: {
+                runtimeId: "runtime-1",
+                sessionId: "session-1",
+                loopRunId: "loop-run-1",
+            },
+            result: { answer: "ready" },
+        }));
+        const dispatcher = new InjectedScheduleDispatcher({ agent });
+        const controller = new AbortController();
+        await expect(dispatcher.dispatch(run(), schedule(), {
+            signal: controller.signal,
+        })).resolves.toEqual({
+            status: "succeeded",
+            references: {
+                runtimeId: "runtime-1",
+                sessionId: "session-1",
+                loopRunId: "loop-run-1",
+            },
+            result: { answer: "ready" },
+        });
+        expect(agent).toHaveBeenCalledTimes(1);
+        expect(agent).toHaveBeenCalledWith(expect.objectContaining({
+            schedule: expect.objectContaining({ id: "schedule-1" }),
+            run: expect.objectContaining({
+                id: "schedule-run-1",
+                idempotencyKey: "schedule:schedule-1:2026-07-28T09:00:00.000Z",
+            }),
+            invocation: expect.objectContaining({
+                surface: "agent",
+                agentName: "assistant",
+                input: { prompt: "Prepare the report" },
+                execution: expect.objectContaining({
+                    loop: "research",
+                    model: "openai/gpt-5",
+                    sandbox: { isolation: "fresh" },
+                }),
+            }),
+            signal: controller.signal,
+        }));
+    });
+    it.each([
+        {
+            surface: "task",
+            invocation: {
+                surface: "task",
+                agentName: "worker",
+                title: "Nightly import",
+                prompt: "Import records",
+                userId: "external-user-1",
+                execution: { loop: "import" },
+            },
+            result: {
+                status: "succeeded",
+                references: { taskId: "task-1" },
+            },
+        },
+        {
+            surface: "channel",
+            invocation: {
+                surface: "channel",
+                channelId: "channel-1",
+                routeId: "route-1",
+                externalThreadId: "thread-1",
+                mode: "send",
+                text: "Daily report ready",
+            },
+            result: {
+                status: "succeeded",
+                references: { providerDeliveryId: "delivery-1" },
+            },
+        },
+        {
+            surface: "webhook",
+            invocation: {
+                surface: "webhook",
+                webhookId: "webhook-1",
+                payload: { reportId: "report-1" },
+            },
+            result: {
+                status: "succeeded",
+                references: { providerDeliveryId: "delivery-1" },
+            },
+        },
+        {
+            surface: "legacy_mission",
+            invocation: {
+                surface: "legacy_mission",
+                missionId: "mission-1",
+            },
+            result: {
+                status: "succeeded",
+                references: {},
+                result: { missionId: "mission-1" },
+            },
+        },
+    ])("dispatches $surface through only its injected handler", async ({ surface, invocation, result }) => {
+        const selected = vi.fn(async () => result);
+        const unexpected = vi.fn();
+        const handlers = {
+            agent: unexpected,
+            task: unexpected,
+            channel: unexpected,
+            webhook: unexpected,
+            legacyMission: unexpected,
+            [surface === "legacy_mission" ? "legacyMission" : surface]: selected,
+        };
+        const dispatcher = new InjectedScheduleDispatcher(handlers);
+        await expect(dispatcher.dispatch(run(), schedule(invocation))).resolves.toEqual(result);
+        expect(selected).toHaveBeenCalledTimes(1);
+        expect(selected).toHaveBeenCalledWith(expect.objectContaining({
+            invocation: expect.objectContaining({ surface }),
+        }));
+        expect(unexpected).not.toHaveBeenCalled();
+    });
+    it("fails closed when the required surface handler is unavailable", async () => {
+        const dispatcher = new InjectedScheduleDispatcher({});
+        await expect(dispatcher.dispatch(run(), schedule())).rejects.toMatchObject({
+            name: "ScheduleDispatchError",
+            code: "HANDLER_UNAVAILABLE",
+            retryable: false,
+        });
+    });
+    it.each([
+        {
+            label: "schedule mismatch",
+            currentRun: run({ scheduleId: "another-schedule" }),
+            currentSchedule: schedule(),
+            code: "INVALID_CONTEXT",
+        },
+        {
+            label: "non-running run",
+            currentRun: run({ status: "claimed" }),
+            currentSchedule: schedule(),
+            code: "INVALID_CONTEXT",
+        },
+        {
+            label: "paused schedule",
+            currentRun: run(),
+            currentSchedule: { ...schedule(), status: "paused" },
+            code: "INVALID_CONTEXT",
+        },
+    ])("rejects $label before invoking a handler", async ({ currentRun, currentSchedule, code, }) => {
+        const agent = vi.fn();
+        const dispatcher = new InjectedScheduleDispatcher({ agent });
+        await expect(dispatcher.dispatch(currentRun, currentSchedule)).rejects.toMatchObject({ code });
+        expect(agent).not.toHaveBeenCalled();
+    });
+    it("revalidates persisted invocation data before invoking a handler", async () => {
+        const agent = vi.fn();
+        const dispatcher = new InjectedScheduleDispatcher({ agent });
+        const malformed = schedule();
+        malformed.invocation = {
+            surface: "agent",
+            agentName: "",
+            input: { prompt: "" },
+        };
+        await expect(dispatcher.dispatch(run(), malformed)).rejects.toMatchObject({
+            code: "INVALID_INVOCATION",
+            retryable: false,
+        });
+        expect(agent).not.toHaveBeenCalled();
+    });
+    it("requires durable references for successful surface outcomes", async () => {
+        const cases = [
+            {
+                invocation: schedule().invocation,
+                handlers: {
+                    agent: async () => ({ status: "succeeded", references: {} }),
+                },
+            },
+            {
+                invocation: {
+                    surface: "task",
+                    agentName: "worker",
+                    title: "Task",
+                    prompt: "Run task",
+                },
+                handlers: {
+                    task: async () => ({ status: "succeeded", references: {} }),
+                },
+            },
+            {
+                invocation: {
+                    surface: "channel",
+                    channelId: "channel-1",
+                    mode: "send",
+                    text: "Hello",
+                },
+                handlers: {
+                    channel: async () => ({ status: "succeeded", references: {} }),
+                },
+            },
+            {
+                invocation: {
+                    surface: "webhook",
+                    webhookId: "webhook-1",
+                },
+                handlers: {
+                    webhook: async () => ({ status: "succeeded", references: {} }),
+                },
+            },
+        ];
+        for (const testCase of cases) {
+            const dispatcher = new InjectedScheduleDispatcher(testCase.handlers);
+            await expect(dispatcher.dispatch(run(), schedule(testCase.invocation))).rejects.toMatchObject({
+                code: "INVALID_RESULT",
+                retryable: false,
+            });
+        }
+    });
+    it.each([
+        {
+            label: "unknown result field",
+            result: {
+                status: "succeeded",
+                references: { runtimeId: "runtime-1" },
+                unexpected: true,
+            },
+        },
+        {
+            label: "unknown reference",
+            result: {
+                status: "succeeded",
+                references: { runtimeId: "runtime-1", otherId: "other-1" },
+            },
+        },
+        {
+            label: "failed result without error",
+            result: {
+                status: "failed",
+                references: {},
+            },
+        },
+        {
+            label: "successful result with error",
+            result: {
+                status: "succeeded",
+                references: { runtimeId: "runtime-1" },
+                error: {
+                    code: "UNEXPECTED",
+                    message: "Should not exist",
+                    retryable: false,
+                },
+            },
+        },
+        {
+            label: "non-JSON result metadata",
+            result: {
+                status: "succeeded",
+                references: { runtimeId: "runtime-1" },
+                result: { invalid: undefined },
+            },
+        },
+    ])("rejects malformed handler result: $label", async ({ result }) => {
+        const dispatcher = new InjectedScheduleDispatcher({
+            agent: async () => result,
+        });
+        await expect(dispatcher.dispatch(run(), schedule())).rejects.toMatchObject({
+            code: "INVALID_RESULT",
+            retryable: false,
+        });
+    });
+    it("normalizes a failed terminal result with bounded error metadata", async () => {
+        const dispatcher = new InjectedScheduleDispatcher({
+            agent: async () => ({
+                status: "failed",
+                references: {},
+                error: {
+                    code: " MODEL_REJECTED ",
+                    message: " Request rejected ",
+                    retryable: false,
+                    metadata: { policy: "strict" },
+                },
+            }),
+        });
+        await expect(dispatcher.dispatch(run(), schedule())).resolves.toEqual({
+            status: "failed",
+            references: {},
+            error: {
+                code: "MODEL_REJECTED",
+                message: "Request rejected",
+                retryable: false,
+                metadata: { policy: "strict" },
+            },
+        });
+    });
+    it("does not swallow errors thrown by a surface adapter", async () => {
+        const providerError = new Error("Provider unavailable");
+        const dispatcher = new InjectedScheduleDispatcher({
+            webhook: async () => {
+                throw providerError;
+            },
+        });
+        await expect(dispatcher.dispatch(run(), schedule({ surface: "webhook", webhookId: "webhook-1" }))).rejects.toBe(providerError);
+    });
+    it("does not invoke a handler when dispatch is already aborted", async () => {
+        const agent = vi.fn();
+        const dispatcher = new InjectedScheduleDispatcher({ agent });
+        const controller = new AbortController();
+        controller.abort("lease lost");
+        await expect(dispatcher.dispatch(run(), schedule(), {
+            signal: controller.signal,
+        })).rejects.toMatchObject({
+            code: "ABORTED",
+            retryable: true,
+        });
+        expect(agent).not.toHaveBeenCalled();
+    });
+    it("exposes stable error fields", () => {
+        const error = new ScheduleDispatchError("INVALID_RESULT", "Invalid result", false);
+        expect(error).toMatchObject({
+            name: "ScheduleDispatchError",
+            code: "INVALID_RESULT",
+            message: "Invalid result",
+            retryable: false,
+        });
+    });
+});
+//# sourceMappingURL=dispatcher.test.js.map

package/dist/scheduling/dispatcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.test.js","sourceRoot":"","sources":["../../src/scheduling/dispatcher.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GAItB,MAAM,YAAY,CAAC;AAEpB,SAAS,QAAQ,CACf,aAAqC;IACnC,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE;IACvC,OAAO,EAAE;QACP,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,WAAW;QACtB,MAAM,EAAE,QAAQ;KACjB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;QAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;KACjC;CACF;IAED,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,MAAM,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,WAAW;YACvB,QAAQ,EAAE,aAAa;SACxB;QACD,UAAU;QACV,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE;YACN,OAAO,EAAE,MAAM;YACf,mBAAmB,EAAE,GAAG;YACxB,cAAc,EAAE,CAAC;SAClB;QACD,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,YAAkC,EAAE;IAC/C,OAAO;QACL,EAAE,EAAE,gBAAgB;QACpB,UAAU,EAAE,YAAY;QACxB,YAAY,EAAE,0BAA0B;QACxC,SAAS,EAAE,WAAW;QACtB,cAAc,EAAE,8CAA8C;QAC9D,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/B,MAAM,EAAE,WAAoB;YAC5B,UAAU,EAAE;gBACV,SAAS,EAAE,WAAW;gBACtB,SAAS,EAAE,WAAW;gBACtB,SAAS,EAAE,YAAY;aACxB;YACD,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SAC5B,CAAC,CAAC,CAAC;QACJ,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE;YAClD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACnB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE;gBACV,SAAS,EAAE,WAAW;gBACtB,SAAS,EAAE,WAAW;gBACtB,SAAS,EAAE,YAAY;aACxB;YACD,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SAC5B,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACzD,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;YACvD,GAAG,EAAE,MAAM,CAAC,gBAAgB,CAAC;gBAC3B,EAAE,EAAE,gBAAgB;gBACpB,cAAc,EAAE,8CAA8C;aAC/D,CAAC;YACF,UAAU,EAAE,MAAM,CAAC,gBAAgB,CAAC;gBAClC,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE;gBACvC,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC;oBACjC,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;iBAChC,CAAC;aACH,CAAC;YACF,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN;YACE,OAAO,EAAE,MAAM;YACf,UAAU,EAAE;gBACV,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,QAAQ;gBACnB,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EAAE,gBAAgB;gBACxB,MAAM,EAAE,iBAAiB;gBACzB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC9B;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;aACjC;SACF;QACD;YACE,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE;gBACV,OAAO,EAAE,SAAS;gBAClB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,SAAS;gBAClB,gBAAgB,EAAE,UAAU;gBAC5B,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,oBAAoB;aAC3B;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE;aACjD;SACF;QACD;YACE,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE;gBACV,OAAO,EAAE,SAAS;gBAClB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE;aAClC;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE;aACjD;SACF;QACD;YACE,OAAO,EAAE,gBAAgB;YACzB,UAAU,EAAE;gBACV,OAAO,EAAE,gBAAgB;gBACzB,SAAS,EAAE,WAAW;aACvB;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE;gBACd,MAAM,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE;aACnC;SACF;KACO,CAAC,CACT,uDAAuD,EACvD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG;YACf,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,UAAU;YACnB,aAAa,EAAE,UAAU;YACzB,CAAC,OAAO,KAAK,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ;SAC/B,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QAE5D,MAAM,MAAM,CACV,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CACjD,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC5D,UAAU,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;SACjD,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC,CACF,CAAC;IAEF,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;YACzE,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,qBAAqB;YAC3B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN;YACE,KAAK,EAAE,mBAAmB;YAC1B,UAAU,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;YACnD,eAAe,EAAE,QAAQ,EAAE;YAC3B,IAAI,EAAE,iBAAiB;SACxB;QACD;YACE,KAAK,EAAE,iBAAiB;YACxB,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACtC,eAAe,EAAE,QAAQ,EAAE;YAC3B,IAAI,EAAE,iBAAiB;SACxB;QACD;YACE,KAAK,EAAE,iBAAiB;YACxB,UAAU,EAAE,GAAG,EAAE;YACjB,eAAe,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAiB,EAAE;YAC7D,IAAI,EAAE,iBAAiB;SACxB;KACF,CAAC,CAAC,0CAA0C,EAAE,KAAK,EAAE,EACpD,UAAU,EACV,eAAe,EACf,IAAI,GACL,EAAE,EAAE;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAE7D,MAAM,MAAM,CACV,UAAU,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CACjD,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,GAAG;YACrB,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;SACtB,CAAC;QAEF,MAAM,MAAM,CACV,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CACtC,CAAC,OAAO,CAAC,aAAa,CAAC;YACtB,IAAI,EAAE,oBAAoB;YAC1B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAGN;YACH;gBACE,UAAU,EAAE,QAAQ,EAAE,CAAC,UAAU;gBACjC,QAAQ,EAAE;oBACR,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;iBAC7D;aACF;YACD;gBACE,UAAU,EAAE;oBACV,OAAO,EAAE,MAAM;oBACf,SAAS,EAAE,QAAQ;oBACnB,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,UAAU;iBACnB;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;iBAC5D;aACF;YACD;gBACE,UAAU,EAAE;oBACV,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,WAAW;oBACtB,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO;iBACd;gBACD,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;iBAC/D;aACF;YACD;gBACE,UAAU,EAAE;oBACV,OAAO,EAAE,SAAS;oBAClB,SAAS,EAAE,WAAW;iBACvB;gBACD,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;iBAC/D;aACF;SACF,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrE,MAAM,MAAM,CACV,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAC1D,CAAC,OAAO,CAAC,aAAa,CAAC;gBACtB,IAAI,EAAE,gBAAgB;gBACtB,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACN;YACE,KAAK,EAAE,sBAAsB;YAC7B,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE;gBACtC,UAAU,EAAE,IAAI;aACjB;SACF;QACD;YACE,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE;aAC3D;SACF;QACD;YACE,KAAK,EAAE,6BAA6B;YACpC,MAAM,EAAE;gBACN,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,EAAE;aACf;SACF;QACD;YACE,KAAK,EAAE,8BAA8B;YACrC,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE;gBACtC,KAAK,EAAE;oBACL,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,kBAAkB;oBAC3B,SAAS,EAAE,KAAK;iBACjB;aACF;SACF;QACD;YACE,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE;gBACN,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE;gBACtC,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;aAC/B;SACF;KACF,CAAC,CAAC,0CAA0C,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAClE,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC;YAChD,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,MAAe;SACnC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;YACzE,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC;YAChD,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAClB,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,EAAE;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,oBAAoB;oBAC7B,SAAS,EAAE,KAAK;oBAChB,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;iBAC/B;aACF,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACpE,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,EAAE;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,kBAAkB;gBAC3B,SAAS,EAAE,KAAK;gBAChB,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;aAC/B;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC;YAChD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,aAAa,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAC9B,GAAG,EAAE,EACL,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CACzD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAE/B,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE;YAClD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;YACxB,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,KAAK,GAAG,IAAI,qBAAqB,CACrC,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,CACN,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC;YAC1B,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/scheduling/driver.d.ts

@@ -0,0 +1,20 @@
+import type { Schedule, ScheduleDriverRegistration } from "./types.js";
+export type ScheduleDriverLifecycleResult = ScheduleDriverRegistration | void;
+/**
+ * Delivery-provider lifecycle for a persisted schedule.
+ *
+ * Implementations register delivery only. A provider callback still has to
+ * create and claim a durable ScheduleRun before any invocation is dispatched.
+ *
+ * Lifecycle methods may return an updated registration when the provider
+ * resource changes as part of the operation. Drivers that keep the same
+ * provider resource can continue returning void.
+ */
+export interface ScheduleDriver {
+    register(schedule: Schedule): Promise<ScheduleDriverRegistration>;
+    update(schedule: Schedule): Promise<ScheduleDriverRegistration>;
+    pause(schedule: Schedule): Promise<ScheduleDriverLifecycleResult>;
+    resume(schedule: Schedule): Promise<ScheduleDriverLifecycleResult>;
+    delete(schedule: Schedule): Promise<ScheduleDriverLifecycleResult>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/scheduling/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/scheduling/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,6BAA6B,GACrC,0BAA0B,GAC1B,IAAI,CAAC;AAET;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAClE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAChE,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAClE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACnE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;CACpE"}

package/dist/scheduling/driver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/scheduling/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/scheduling/driver.ts"],"names":[],"mappings":""}

package/dist/scheduling/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./store.js";
+export * from "./state-machine.js";
+export * from "./driver.js";
+export * from "./dispatcher.js";
+export * from "./occurrence.js";
+export { SCHEDULE_LIMITS, normalizeCreateScheduleInput, normalizeCronExpression, normalizeScheduleInvocation, normalizeScheduleMetadata, normalizeScheduleTiming, normalizeUpdateScheduleInput, translateLegacyMissionSchedule, } from "./validation.js";
+export type { NormalizeScheduleOptions, TranslateLegacyScheduleOptions, } from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scheduling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC"}