@polpo-ai/core 0.1.0

package/dist/quality-controller.js

@@ -0,0 +1,373 @@
+/**
+ * QualityController — manages quality gates within missions and aggregates
+ * quality metrics across tasks, agents, and missions.
+ */
+export class QualityController {
+    ctx;
+    metrics = new Map();
+    evaluatedGates = new Set();
+    registeredGateRules = new Set();
+    notificationRouter;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    setNotificationRouter(router) {
+        this.notificationRouter = router;
+    }
+    init() {
+        this.ctx.hooks.register({
+            hook: "assessment:complete",
+            phase: "after",
+            priority: 200,
+            name: "quality-controller:collect-metrics",
+            handler: (hookCtx) => {
+                const { taskId, task, assessment, passed } = hookCtx.data;
+                this.recordAssessment(taskId, "task", assessment, passed);
+                if (task.assignTo) {
+                    this.recordAssessment(task.assignTo, "agent", assessment, passed);
+                }
+            },
+        });
+        this.ctx.hooks.register({
+            hook: "task:complete",
+            phase: "after",
+            priority: 210,
+            name: "quality-controller:sla-outcome",
+            handler: (hookCtx) => {
+                const { taskId, task } = hookCtx.data;
+                if (task?.deadline) {
+                    const deadline = new Date(task.deadline).getTime();
+                    const now = Date.now();
+                    const key = this.metricsKey("task", taskId);
+                    const m = this.getOrCreate(key, taskId, "task");
+                    if (now <= deadline) {
+                        m.deadlinesMet++;
+                    }
+                    else {
+                        m.deadlinesMissed++;
+                    }
+                    m.updatedAt = new Date().toISOString();
+                }
+            },
+        });
+        this.ctx.hooks.register({
+            hook: "task:retry",
+            phase: "after",
+            priority: 200,
+            name: "quality-controller:record-retry",
+            handler: (hookCtx) => {
+                const { taskId, task } = hookCtx.data;
+                const key = this.metricsKey("task", taskId);
+                const m = this.getOrCreate(key, taskId, "task");
+                m.totalRetries++;
+                m.updatedAt = new Date().toISOString();
+                if (task.assignTo) {
+                    const agentKey = this.metricsKey("agent", task.assignTo);
+                    const am = this.getOrCreate(agentKey, task.assignTo, "agent");
+                    am.totalRetries++;
+                    am.updatedAt = new Date().toISOString();
+                }
+            },
+        });
+    }
+    evaluateGate(missionId, gate, tasks) {
+        const gateKey = `${missionId}:${gate.name}`;
+        this.ensureGateNotificationRules(gateKey, gate);
+        if (this.evaluatedGates.has(gateKey)) {
+            return { passed: true };
+        }
+        const afterTasks = tasks.filter(t => gate.afterTasks.includes(t.title) || gate.afterTasks.includes(t.id));
+        if (afterTasks.length < gate.afterTasks.length) {
+            const foundIds = new Set([...afterTasks.map(t => t.title), ...afterTasks.map(t => t.id)]);
+            const missing = gate.afterTasks.filter(ref => !foundIds.has(ref));
+            return {
+                passed: false,
+                reason: `Waiting for tasks to complete: ${missing.join(", ")}`,
+            };
+        }
+        const nonTerminal = afterTasks.filter(t => t.status !== "done" && t.status !== "failed");
+        if (nonTerminal.length > 0) {
+            return {
+                passed: false,
+                reason: `Waiting for tasks to complete: ${nonTerminal.map(t => t.title).join(", ")}`,
+            };
+        }
+        if (gate.requireAllPassed) {
+            const failedTasks = afterTasks.filter(t => t.status === "failed");
+            if (failedTasks.length > 0) {
+                const reason = `Required tasks failed: ${failedTasks.map(t => t.title).join(", ")}`;
+                this.ctx.emitter.emit("quality:gate:failed", {
+                    missionId,
+                    gateName: gate.name,
+                    reason,
+                });
+                this.ctx.hooks.runAfter("quality:gate", {
+                    missionId,
+                    gateName: gate.name,
+                    allPassed: false,
+                    tasks: afterTasks.map(t => ({
+                        taskId: t.id,
+                        title: t.title,
+                        status: t.status,
+                        score: t.result?.assessment?.globalScore,
+                    })),
+                }).catch(() => { });
+                return { passed: false, reason };
+            }
+        }
+        if (gate.minScore !== undefined) {
+            const scores = afterTasks
+                .map(t => t.result?.assessment?.globalScore)
+                .filter((s) => s !== undefined);
+            const avgScore = scores.length > 0
+                ? scores.reduce((a, b) => a + b, 0) / scores.length
+                : undefined;
+            if (avgScore === undefined || avgScore < gate.minScore) {
+                const reason = `Average score ${avgScore?.toFixed(2) ?? "N/A"} below threshold ${gate.minScore}`;
+                this.ctx.emitter.emit("quality:gate:failed", {
+                    missionId,
+                    gateName: gate.name,
+                    avgScore,
+                    reason,
+                });
+                this.ctx.hooks.runAfter("quality:gate", {
+                    missionId,
+                    gateName: gate.name,
+                    avgScore,
+                    allPassed: false,
+                    tasks: afterTasks.map(t => ({
+                        taskId: t.id,
+                        title: t.title,
+                        status: t.status,
+                        score: t.result?.assessment?.globalScore,
+                    })),
+                }).catch(() => { });
+                return { passed: false, reason, avgScore };
+            }
+            this.evaluatedGates.add(gateKey);
+            this.ctx.emitter.emit("quality:gate:passed", {
+                missionId,
+                gateName: gate.name,
+                avgScore,
+            });
+            this.ctx.hooks.runAfter("quality:gate", {
+                missionId,
+                gateName: gate.name,
+                avgScore,
+                allPassed: true,
+                tasks: afterTasks.map(t => ({
+                    taskId: t.id,
+                    title: t.title,
+                    status: t.status,
+                    score: t.result?.assessment?.globalScore,
+                })),
+            }).catch(() => { });
+            return { passed: true, avgScore };
+        }
+        this.evaluatedGates.add(gateKey);
+        this.ctx.emitter.emit("quality:gate:passed", {
+            missionId,
+            gateName: gate.name,
+        });
+        this.ctx.hooks.runAfter("quality:gate", {
+            missionId,
+            gateName: gate.name,
+            allPassed: true,
+            tasks: afterTasks.map(t => ({
+                taskId: t.id,
+                title: t.title,
+                status: t.status,
+                score: t.result?.assessment?.globalScore,
+            })),
+        }).catch(() => { });
+        return { passed: true };
+    }
+    getBlockingGate(missionId, taskTitle, taskId, gates, tasks) {
+        for (const gate of gates) {
+            if (!gate.blocksTasks.includes(taskTitle) && !gate.blocksTasks.includes(taskId)) {
+                continue;
+            }
+            const result = this.evaluateGate(missionId, gate, tasks);
+            if (!result.passed) {
+                return { gate, result };
+            }
+        }
+        return undefined;
+    }
+    checkMissionThreshold(mission, tasks, defaultThreshold) {
+        const threshold = mission.qualityThreshold ?? defaultThreshold;
+        if (threshold === undefined)
+            return { passed: true };
+        const scores = tasks
+            .filter(t => t.status === "done")
+            .map(t => {
+            const score = t.result?.assessment?.globalScore;
+            const weight = t.priority ?? 1.0;
+            return score !== undefined ? { score, weight } : undefined;
+        })
+            .filter((s) => s !== undefined);
+        if (scores.length === 0) {
+            return { passed: true, threshold };
+        }
+        const totalWeight = scores.reduce((sum, s) => sum + s.weight, 0);
+        const avgScore = totalWeight > 0
+            ? scores.reduce((sum, s) => sum + s.score * s.weight, 0) / totalWeight
+            : scores.reduce((sum, s) => sum + s.score, 0) / scores.length;
+        const passed = avgScore >= threshold;
+        if (!passed) {
+            this.ctx.emitter.emit("quality:threshold:failed", {
+                missionId: mission.id,
+                avgScore,
+                threshold,
+            });
+        }
+        return { avgScore, threshold, passed };
+    }
+    recordAssessment(entityId, entityType, assessment, passed) {
+        const key = this.metricsKey(entityType, entityId);
+        const m = this.getOrCreate(key, entityId, entityType);
+        m.totalAssessments++;
+        if (passed)
+            m.passedAssessments++;
+        if (assessment.globalScore !== undefined) {
+            const scores = this.getScoresArray(m);
+            scores.push(assessment.globalScore);
+            m.avgScore = scores.reduce((a, b) => a + b, 0) / scores.length;
+            m.minScore = Math.min(...scores);
+            m.maxScore = Math.max(...scores);
+        }
+        if (assessment.scores) {
+            for (const ds of assessment.scores) {
+                if (!m.dimensionScores[ds.dimension]) {
+                    m.dimensionScores[ds.dimension] = ds.score;
+                }
+                else {
+                    m.dimensionScores[ds.dimension] =
+                        (m.dimensionScores[ds.dimension] * (m.totalAssessments - 1) + ds.score) / m.totalAssessments;
+                }
+            }
+        }
+        if (entityType === "task" && assessment.trigger === "fix") {
+            m.totalFixes++;
+        }
+        m.updatedAt = new Date().toISOString();
+    }
+    getMetrics(entityType, entityId) {
+        return this.metrics.get(this.metricsKey(entityType, entityId));
+    }
+    getAllMetrics(entityType) {
+        const all = [...this.metrics.values()];
+        if (entityType)
+            return all.filter(m => m.entityType === entityType);
+        return all;
+    }
+    aggregateMissionMetrics(missionId, tasks) {
+        const key = this.metricsKey("mission", missionId);
+        const m = this.getOrCreate(key, missionId, "mission");
+        const scores = [];
+        let totalAssessments = 0;
+        let passedAssessments = 0;
+        let totalRetries = 0;
+        let totalFixes = 0;
+        let deadlinesMet = 0;
+        let deadlinesMissed = 0;
+        for (const task of tasks) {
+            const taskMetrics = this.getMetrics("task", task.id);
+            if (taskMetrics) {
+                totalAssessments += taskMetrics.totalAssessments;
+                passedAssessments += taskMetrics.passedAssessments;
+                totalRetries += taskMetrics.totalRetries;
+                totalFixes += taskMetrics.totalFixes;
+                deadlinesMet += taskMetrics.deadlinesMet;
+                deadlinesMissed += taskMetrics.deadlinesMissed;
+                if (taskMetrics.avgScore !== undefined) {
+                    scores.push(taskMetrics.avgScore);
+                }
+            }
+        }
+        m.totalAssessments = totalAssessments;
+        m.passedAssessments = passedAssessments;
+        m.totalRetries = totalRetries;
+        m.totalFixes = totalFixes;
+        m.deadlinesMet = deadlinesMet;
+        m.deadlinesMissed = deadlinesMissed;
+        if (scores.length > 0) {
+            m.avgScore = scores.reduce((a, b) => a + b, 0) / scores.length;
+            m.minScore = Math.min(...scores);
+            m.maxScore = Math.max(...scores);
+        }
+        m.updatedAt = new Date().toISOString();
+        return m;
+    }
+    metricsKey(entityType, entityId) {
+        return `${entityType}:${entityId}`;
+    }
+    getOrCreate(key, entityId, entityType) {
+        let m = this.metrics.get(key);
+        if (!m) {
+            m = {
+                entityId,
+                entityType,
+                totalAssessments: 0,
+                passedAssessments: 0,
+                dimensionScores: {},
+                totalRetries: 0,
+                totalFixes: 0,
+                deadlinesMet: 0,
+                deadlinesMissed: 0,
+                updatedAt: new Date().toISOString(),
+            };
+            this.metrics.set(key, m);
+        }
+        return m;
+    }
+    getScoresArray(m) {
+        if (m.avgScore !== undefined && m.totalAssessments > 0) {
+            return Array(m.totalAssessments - 1).fill(m.avgScore);
+        }
+        return [];
+    }
+    ensureGateNotificationRules(gateKey, gate) {
+        if (!this.notificationRouter)
+            return;
+        if (!gate.notifyChannels || gate.notifyChannels.length === 0)
+            return;
+        if (this.registeredGateRules.has(gateKey))
+            return;
+        this.registeredGateRules.add(gateKey);
+        this.notificationRouter.addRule({
+            id: `qgate-pass-${gateKey}`,
+            name: `Quality Gate "${gate.name}" Passed (auto-registered)`,
+            events: ["quality:gate:passed"],
+            condition: { field: "gateName", op: "==", value: gate.name },
+            channels: gate.notifyChannels,
+            severity: "info",
+        });
+        this.notificationRouter.addRule({
+            id: `qgate-fail-${gateKey}`,
+            name: `Quality Gate "${gate.name}" Failed (auto-registered)`,
+            events: ["quality:gate:failed"],
+            condition: { field: "gateName", op: "==", value: gate.name },
+            channels: gate.notifyChannels,
+            severity: "critical",
+        });
+    }
+    clearGateCache(missionId) {
+        if (missionId) {
+            for (const key of this.evaluatedGates) {
+                if (key.startsWith(`${missionId}:`)) {
+                    this.evaluatedGates.delete(key);
+                }
+            }
+        }
+        else {
+            this.evaluatedGates.clear();
+        }
+    }
+    dispose() {
+        this.metrics.clear();
+        this.evaluatedGates.clear();
+        this.registeredGateRules.clear();
+    }
+}
+//# sourceMappingURL=quality-controller.js.map

package/dist/quality-controller.js.map

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

package/dist/run-store.d.ts

@@ -0,0 +1,31 @@
+import type { AgentActivity, TaskResult, TaskOutcome } from "./types.js";
+export type RunStatus = "running" | "completed" | "failed" | "killed";
+export interface RunRecord {
+    id: string;
+    taskId: string;
+    pid: number;
+    agentName: string;
+    sessionId?: string;
+    status: RunStatus;
+    startedAt: string;
+    updatedAt: string;
+    activity: AgentActivity;
+    result?: TaskResult;
+    /** Outcomes auto-collected during execution (files, media, text artifacts). */
+    outcomes?: TaskOutcome[];
+    configPath: string;
+}
+export interface RunStore {
+    upsertRun(run: RunRecord): Promise<void>;
+    updateActivity(runId: string, activity: AgentActivity): Promise<void>;
+    /** Store auto-collected outcomes on the run record (called before completeRun). */
+    updateOutcomes(runId: string, outcomes: TaskOutcome[]): Promise<void>;
+    completeRun(runId: string, status: RunStatus, result: TaskResult): Promise<void>;
+    getRun(runId: string): Promise<RunRecord | undefined>;
+    getRunByTaskId(taskId: string): Promise<RunRecord | undefined>;
+    getActiveRuns(): Promise<RunRecord[]>;
+    getTerminalRuns(): Promise<RunRecord[]>;
+    deleteRun(runId: string): Promise<void>;
+    close(): Promise<void> | void;
+}
+//# sourceMappingURL=run-store.d.ts.map

package/dist/run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../src/run-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,mFAAmF;IACnF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACtD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC/D,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACtC,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B"}

package/dist/run-store.js

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

package/dist/run-store.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,35 @@
+import type { OrchestratorContext } from "./orchestrator-context.js";
+import type { ScheduleEntry, Mission } from "./types.js";
+/**
+ * Scheduler — tick-driven scheduling engine for missions.
+ *
+ * Missions use dedicated statuses for scheduling:
+ *  - `scheduled`: one-shot — waiting for the trigger time, then transitions to
+ *     active. After completion the mission stays completed (schedule disabled).
+ *     On failure it returns to `scheduled` for automatic retry.
+ *  - `recurring`: recurring — fires on every cron tick, transitions to active,
+ *     then returns to `recurring` after completion or failure.
+ */
+export declare class Scheduler {
+    private ctx;
+    private schedules;
+    private lastCheckMs;
+    private checkIntervalMs;
+    private executeMissionFn?;
+    private missionCompletedHandler?;
+    constructor(ctx: OrchestratorContext, opts?: {
+        checkIntervalMs?: number;
+    });
+    init(): Promise<void>;
+    setExecutor(fn: (missionId: string) => void): void;
+    registerMission(mission: Mission): ScheduleEntry | null;
+    unregisterMission(missionId: string): boolean;
+    check(): Promise<void>;
+    private triggerSchedule;
+    getSchedule(scheduleId: string): ScheduleEntry | undefined;
+    getScheduleByMissionId(missionId: string): ScheduleEntry | undefined;
+    getAllSchedules(): ScheduleEntry[];
+    getActiveSchedules(): ScheduleEntry[];
+    dispose(): void;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGzD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAQlB,OAAO,CAAC,GAAG;IAPb,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAC,CAA8B;IACvD,OAAO,CAAC,uBAAuB,CAAC,CAAuC;gBAG7D,GAAG,EAAE,mBAAmB,EAChC,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE;IAK/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,WAAW,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIlD,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI;IAyCvD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBd,eAAe;IA+E7B,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1D,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIpE,eAAe,IAAI,aAAa,EAAE;IAIlC,kBAAkB,IAAI,aAAa,EAAE;IAIrC,OAAO,IAAI,IAAI;CAQhB"}

package/dist/scheduler.js

@@ -0,0 +1,195 @@
+import { isCronExpression, nextCronOccurrence } from "./cron.js";
+/**
+ * Scheduler — tick-driven scheduling engine for missions.
+ *
+ * Missions use dedicated statuses for scheduling:
+ *  - `scheduled`: one-shot — waiting for the trigger time, then transitions to
+ *     active. After completion the mission stays completed (schedule disabled).
+ *     On failure it returns to `scheduled` for automatic retry.
+ *  - `recurring`: recurring — fires on every cron tick, transitions to active,
+ *     then returns to `recurring` after completion or failure.
+ */
+export class Scheduler {
+    ctx;
+    schedules = new Map();
+    lastCheckMs = 0;
+    checkIntervalMs;
+    executeMissionFn;
+    missionCompletedHandler;
+    constructor(ctx, opts) {
+        this.ctx = ctx;
+        this.checkIntervalMs = opts?.checkIntervalMs ?? 30_000;
+    }
+    async init() {
+        const missions = await this.ctx.registry.getAllMissions?.() ?? [];
+        const terminalStates = new Set(["completed", "cancelled", "draft"]);
+        for (const mission of missions) {
+            if (!mission.schedule)
+                continue;
+            if (terminalStates.has(mission.status))
+                continue;
+            this.registerMission(mission);
+        }
+        this.missionCompletedHandler = async ({ missionId }) => {
+            const mission = await this.ctx.registry.getMission?.(missionId);
+            if (!mission?.schedule)
+                return;
+            if (mission.status === "recurring" || mission.status === "scheduled") {
+                this.registerMission(mission);
+            }
+        };
+        this.ctx.emitter.on("mission:completed", this.missionCompletedHandler);
+    }
+    setExecutor(fn) {
+        this.executeMissionFn = fn;
+    }
+    registerMission(mission) {
+        if (!mission.schedule)
+            return null;
+        const isRecurring = mission.status === "recurring";
+        const isCron = isCronExpression(mission.schedule);
+        const now = new Date();
+        let nextRunAt;
+        if (isCron) {
+            const next = nextCronOccurrence(mission.schedule, now);
+            nextRunAt = next?.toISOString();
+        }
+        else {
+            const scheduled = new Date(mission.schedule);
+            if (scheduled.getTime() > now.getTime()) {
+                nextRunAt = scheduled.toISOString();
+            }
+            else if (!isRecurring) {
+                return null;
+            }
+        }
+        const entry = {
+            id: `sched-${mission.id}`,
+            missionId: mission.id,
+            expression: mission.schedule,
+            recurring: isRecurring,
+            enabled: true,
+            nextRunAt,
+            createdAt: new Date().toISOString(),
+        };
+        this.schedules.set(entry.id, entry);
+        this.ctx.emitter.emit("schedule:created", {
+            scheduleId: entry.id,
+            missionId: mission.id,
+            nextRunAt,
+        });
+        return entry;
+    }
+    unregisterMission(missionId) {
+        const schedId = `sched-${missionId}`;
+        return this.schedules.delete(schedId);
+    }
+    async check() {
+        const now = Date.now();
+        if (now - this.lastCheckMs < this.checkIntervalMs)
+            return;
+        this.lastCheckMs = now;
+        for (const [schedId, entry] of this.schedules) {
+            if (!entry.enabled)
+                continue;
+            if (!entry.nextRunAt)
+                continue;
+            const nextRun = new Date(entry.nextRunAt).getTime();
+            if (now < nextRun)
+                continue;
+            await this.triggerSchedule(schedId, entry);
+        }
+    }
+    async triggerSchedule(schedId, entry) {
+        const mission = await this.ctx.registry.getMission?.(entry.missionId);
+        if (!mission) {
+            entry.enabled = false;
+            return;
+        }
+        if (mission.status !== "scheduled" && mission.status !== "recurring") {
+            return;
+        }
+        if (mission.endDate) {
+            const endTime = new Date(mission.endDate).getTime();
+            if (Date.now() >= endTime) {
+                entry.enabled = false;
+                entry.nextRunAt = undefined;
+                await this.ctx.registry.updateMission?.(entry.missionId, { status: "completed" });
+                this.ctx.emitter.emit("schedule:expired", {
+                    scheduleId: schedId,
+                    missionId: entry.missionId,
+                    endDate: mission.endDate,
+                });
+                this.ctx.emitter.emit("log", {
+                    level: "info",
+                    message: `[Scheduler] Mission ${entry.missionId} schedule expired (endDate: ${mission.endDate}). Transitioned to completed.`,
+                });
+                return;
+            }
+        }
+        const hookResult = this.ctx.hooks.runBeforeSync("schedule:trigger", {
+            scheduleId: schedId,
+            missionId: entry.missionId,
+            expression: entry.expression,
+        });
+        if (hookResult.cancelled) {
+            return;
+        }
+        this.ctx.emitter.emit("schedule:triggered", {
+            scheduleId: schedId,
+            missionId: entry.missionId,
+            expression: entry.expression,
+        });
+        let executionFailed = false;
+        try {
+            if (this.executeMissionFn) {
+                this.executeMissionFn(entry.missionId);
+            }
+        }
+        catch (err) {
+            executionFailed = true;
+            const msg = err instanceof Error ? err.message : String(err);
+            this.ctx.emitter.emit("log", {
+                level: "error",
+                message: `[Scheduler] Failed to execute mission ${entry.missionId}: ${msg}`,
+            });
+        }
+        if (executionFailed && !entry.recurring) {
+            return;
+        }
+        entry.lastRunAt = new Date().toISOString();
+        if (entry.recurring && isCronExpression(entry.expression)) {
+            const next = nextCronOccurrence(entry.expression, new Date());
+            entry.nextRunAt = next?.toISOString();
+        }
+        else {
+            entry.enabled = false;
+            entry.nextRunAt = undefined;
+        }
+        this.ctx.emitter.emit("schedule:completed", {
+            scheduleId: schedId,
+            missionId: entry.missionId,
+        });
+    }
+    getSchedule(scheduleId) {
+        return this.schedules.get(scheduleId);
+    }
+    getScheduleByMissionId(missionId) {
+        return this.schedules.get(`sched-${missionId}`);
+    }
+    getAllSchedules() {
+        return [...this.schedules.values()];
+    }
+    getActiveSchedules() {
+        return [...this.schedules.values()].filter(s => s.enabled);
+    }
+    dispose() {
+        if (this.missionCompletedHandler) {
+            this.ctx.emitter.off("mission:completed", this.missionCompletedHandler);
+            this.missionCompletedHandler = undefined;
+        }
+        this.schedules.clear();
+        this.executeMissionFn = undefined;
+    }
+}
+//# sourceMappingURL=scheduler.js.map