@polpo-ai/core 0.1.0

package/dist/approval-manager.js

@@ -0,0 +1,325 @@
+import { nanoid } from "nanoid";
+/**
+ * Manages approval gates — both automatic (condition-based) and human (blocking).
+ *
+ * Automatic gates evaluate a condition against the hook payload and either
+ * allow or block the operation immediately.
+ *
+ * Human gates pause the operation (task enters "awaiting_approval"),
+ * emit a notification event, and wait for external resolution (API call,
+ * TUI action, or timeout).
+ */
+export class ApprovalManager {
+    ctx;
+    store;
+    timers = new Map();
+    notificationRouter;
+    registeredGateRules = new Set();
+    constructor(ctx, store) {
+        this.ctx = ctx;
+        this.store = store;
+    }
+    /** Wire the notification router so per-gate notifyChannels work. */
+    setNotificationRouter(router) {
+        this.notificationRouter = router;
+        const gates = this.ctx.config.settings.approvalGates;
+        if (gates) {
+            for (const gate of gates) {
+                this.ensureGateNotificationRules(gate);
+            }
+        }
+    }
+    /** Initialize: register hooks for all configured approval gates. */
+    async init() {
+        const gates = this.ctx.config.settings.approvalGates;
+        if (!gates || gates.length === 0)
+            return;
+        for (const gate of gates) {
+            this.registerGate(gate);
+        }
+        // Resume any pending approval timeouts from previous session
+        const pending = await this.store.list("pending");
+        for (const req of pending) {
+            const gate = gates.find(g => g.id === req.gateId);
+            if (gate?.timeoutMs && gate.timeoutMs > 0) {
+                const elapsed = Date.now() - new Date(req.requestedAt).getTime();
+                const remaining = gate.timeoutMs - elapsed;
+                if (remaining <= 0) {
+                    await this.resolveTimeout(req, gate);
+                }
+                else {
+                    this.startTimer(req.id, remaining, gate);
+                }
+            }
+        }
+    }
+    ensureGateNotificationRules(gate) {
+        if (!this.notificationRouter)
+            return;
+        if (!gate.notifyChannels || gate.notifyChannels.length === 0)
+            return;
+        if (this.registeredGateRules.has(gate.id))
+            return;
+        this.registeredGateRules.add(gate.id);
+        this.notificationRouter.addRule({
+            id: `approval-req-${gate.id}`,
+            name: `Approval "${gate.name}" Requested (auto)`,
+            events: ["approval:requested"],
+            condition: { field: "gateId", op: "==", value: gate.id },
+            channels: gate.notifyChannels,
+            severity: "warning",
+            includeOutcomes: gate.includeOutcomes,
+            outcomeFilter: ["media", "file"],
+            maxAttachmentSize: 10 * 1024 * 1024,
+        });
+        this.notificationRouter.addRule({
+            id: `approval-res-${gate.id}`,
+            name: `Approval "${gate.name}" Resolved (auto)`,
+            events: ["approval:resolved"],
+            channels: gate.notifyChannels,
+            severity: "info",
+        });
+        this.notificationRouter.addRule({
+            id: `approval-timeout-${gate.id}`,
+            name: `Approval "${gate.name}" Timed Out (auto)`,
+            events: ["approval:timeout"],
+            channels: gate.notifyChannels,
+            severity: "critical",
+        });
+    }
+    registerGate(gate) {
+        const hook = gate.hook;
+        this.ensureGateNotificationRules(gate);
+        this.ctx.hooks.register({
+            hook,
+            phase: "before",
+            priority: gate.priority ?? 50,
+            name: `approval-gate:${gate.name}`,
+            handler: (ctx) => {
+                if (gate.condition?.expression) {
+                    const matches = this.evaluateCondition(gate.condition.expression, ctx.data);
+                    if (!matches)
+                        return;
+                }
+                if (gate.handler === "auto") {
+                    if (gate.condition?.expression) {
+                        ctx.cancel(`Auto gate "${gate.name}" condition matched — blocking`);
+                    }
+                    return;
+                }
+                const request = this.createRequest(gate, ctx.data);
+                ctx.cancel(`Awaiting human approval: ${gate.name} (request: ${request.id})`);
+                const taskId = this.extractTaskId(ctx.data);
+                if (taskId) {
+                    // Fire-and-forget async transition
+                    this.ctx.registry.transition(taskId, "awaiting_approval").catch(() => {
+                        /* Task may already be in a state that doesn't allow this transition */
+                    });
+                }
+                this.ctx.emitter.emit("approval:requested", {
+                    requestId: request.id,
+                    gateId: gate.id,
+                    gateName: gate.name,
+                    taskId: request.taskId,
+                    missionId: request.missionId,
+                });
+                if (gate.timeoutMs && gate.timeoutMs > 0) {
+                    this.startTimer(request.id, gate.timeoutMs, gate);
+                }
+            },
+        });
+    }
+    createRequest(gate, payload) {
+        const request = {
+            id: nanoid(),
+            gateId: gate.id,
+            gateName: gate.name,
+            taskId: this.extractTaskId(payload),
+            missionId: this.extractMissionId(payload),
+            status: "pending",
+            payload,
+            requestedAt: new Date().toISOString(),
+        };
+        // Fire-and-forget async store write
+        this.store.upsert(request).catch(() => { });
+        return request;
+    }
+    async approve(requestId, resolvedBy, note) {
+        return this.resolve(requestId, "approved", resolvedBy, note);
+    }
+    async reject(requestId, feedback, resolvedBy) {
+        const request = await this.store.get(requestId);
+        if (!request || request.status !== "pending")
+            return null;
+        if (!request.taskId)
+            return null;
+        const gate = this.ctx.config.settings.approvalGates?.find(g => g.id === request.gateId);
+        const maxRevisions = gate?.maxRevisions ?? 3;
+        const task = await this.ctx.registry.getTask(request.taskId);
+        if (!task)
+            return null;
+        const currentCount = task.revisionCount ?? 0;
+        if (currentCount >= maxRevisions)
+            return null;
+        request.status = "rejected";
+        request.resolvedAt = new Date().toISOString();
+        request.resolvedBy = resolvedBy ?? "user";
+        request.note = feedback;
+        await this.store.upsert(request);
+        this.clearTimer(requestId);
+        const newCount = currentCount + 1;
+        await this.ctx.registry.updateTask(request.taskId, { revisionCount: newCount });
+        const separator = "\n\n---\n";
+        const feedbackBlock = `**Rejection #${newCount} feedback:** ${feedback}`;
+        const updatedDescription = task.description + separator + feedbackBlock;
+        await this.ctx.registry.updateTask(request.taskId, { description: updatedDescription });
+        this.ctx.emitter.emit("approval:rejected", {
+            requestId,
+            taskId: request.taskId,
+            feedback,
+            rejectionCount: newCount,
+            resolvedBy: request.resolvedBy,
+        });
+        await this.ctx.registry.updateTask(request.taskId, { outcomes: [] });
+        try {
+            await this.ctx.registry.transition(request.taskId, "pending");
+        }
+        catch { /* Task may have been modified externally */ }
+        return request;
+    }
+    async canReject(requestId) {
+        const request = await this.store.get(requestId);
+        if (!request || request.status !== "pending" || !request.taskId) {
+            return { allowed: false, rejectionCount: 0, maxRejections: 0 };
+        }
+        const gate = this.ctx.config.settings.approvalGates?.find(g => g.id === request.gateId);
+        const maxRejections = gate?.maxRevisions ?? 3;
+        const task = await this.ctx.registry.getTask(request.taskId);
+        const currentCount = task?.revisionCount ?? 0;
+        return { allowed: currentCount < maxRejections, rejectionCount: currentCount, maxRejections };
+    }
+    async resolve(requestId, status, resolvedBy, note) {
+        const request = await this.store.get(requestId);
+        if (!request || request.status !== "pending")
+            return null;
+        request.status = status;
+        request.resolvedAt = new Date().toISOString();
+        request.resolvedBy = resolvedBy ?? "user";
+        request.note = note;
+        await this.store.upsert(request);
+        this.clearTimer(requestId);
+        this.ctx.emitter.emit("approval:resolved", {
+            requestId,
+            status,
+            resolvedBy: request.resolvedBy,
+        });
+        if (request.taskId) {
+            try {
+                if (status === "approved") {
+                    const gate = this.ctx.config.settings.approvalGates?.find(g => g.id === request.gateId);
+                    const targetStatus = gate?.hook === "task:complete" ? "done" : "assigned";
+                    await this.ctx.registry.transition(request.taskId, targetStatus);
+                }
+                else {
+                    await this.ctx.registry.transition(request.taskId, "failed");
+                }
+            }
+            catch { /* Task may have been modified externally */ }
+        }
+        return request;
+    }
+    async resolveTimeout(request, gate) {
+        if (request.status !== "pending")
+            return;
+        const action = gate.timeoutAction ?? "reject";
+        request.status = "timeout";
+        request.resolvedAt = new Date().toISOString();
+        request.resolvedBy = "timeout";
+        await this.store.upsert(request);
+        this.ctx.emitter.emit("approval:timeout", {
+            requestId: request.id,
+            action,
+        });
+        if (request.taskId) {
+            try {
+                if (action === "approve") {
+                    await this.ctx.registry.transition(request.taskId, "assigned");
+                }
+                else {
+                    await this.ctx.registry.transition(request.taskId, "failed");
+                }
+            }
+            catch { /* Task may have been modified externally */ }
+        }
+    }
+    async getPending() {
+        return this.store.list("pending");
+    }
+    async getAll(status) {
+        return this.store.list(status);
+    }
+    async getRequest(id) {
+        return this.store.get(id);
+    }
+    // ─── Helpers ───────────────────────────────────────
+    startTimer(requestId, ms, gate) {
+        const timer = setTimeout(async () => {
+            const request = await this.store.get(requestId);
+            if (request)
+                await this.resolveTimeout(request, gate);
+            this.timers.delete(requestId);
+        }, ms);
+        this.timers.set(requestId, timer);
+    }
+    clearTimer(requestId) {
+        const timer = this.timers.get(requestId);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(requestId);
+        }
+    }
+    evaluateCondition(expression, data) {
+        try {
+            const fn = new Function("data", "task", "mission", `try { return !!(${expression}); } catch { return false; }`);
+            const taskData = this.isRecord(data) ? data.task : undefined;
+            const missionData = this.isRecord(data) ? data.mission : undefined;
+            return fn(data, taskData, missionData) === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    isRecord(v) {
+        return typeof v === "object" && v !== null;
+    }
+    extractTaskId(data) {
+        if (!this.isRecord(data))
+            return undefined;
+        const d = data;
+        if (typeof d.taskId === "string")
+            return d.taskId;
+        if (this.isRecord(d.task) && typeof d.task.id === "string") {
+            return d.task.id;
+        }
+        return undefined;
+    }
+    extractMissionId(data) {
+        if (!this.isRecord(data))
+            return undefined;
+        const d = data;
+        if (typeof d.missionId === "string")
+            return d.missionId;
+        if (this.isRecord(d.mission) && typeof d.mission.id === "string") {
+            return d.mission.id;
+        }
+        return undefined;
+    }
+    dispose() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        this.store.close?.();
+    }
+}
+//# sourceMappingURL=approval-manager.js.map

package/dist/approval-manager.js.map

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

package/dist/approval-store.d.ts

@@ -0,0 +1,19 @@
+import type { ApprovalRequest, ApprovalStatus } from "./types.js";
+/**
+ * Persistent store for approval requests.
+ */
+export interface ApprovalStore {
+    /** Save or update an approval request. */
+    upsert(request: ApprovalRequest): Promise<void>;
+    /** Get a request by ID. */
+    get(id: string): Promise<ApprovalRequest | undefined>;
+    /** List all requests, optionally filtered by status. */
+    list(status?: ApprovalStatus): Promise<ApprovalRequest[]>;
+    /** List pending requests for a specific task. */
+    listByTask(taskId: string): Promise<ApprovalRequest[]>;
+    /** Delete a request by ID. */
+    delete(id: string): Promise<boolean>;
+    /** Close the store (cleanup). */
+    close?(): Promise<void> | void;
+}
+//# sourceMappingURL=approval-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval-store.d.ts","sourceRoot":"","sources":["../src/approval-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,2BAA2B;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IACtD,wDAAwD;IACxD,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,iDAAiD;IACjD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACvD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,iCAAiC;IACjC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC"}

package/dist/approval-store.js

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

package/dist/approval-store.js.map

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

package/dist/checkpoint-store.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CheckpointStore — pure interface for mission checkpoint persistence.
+ *
+ * FileCheckpointStore (node:fs) implements this in the shell.
+ */
+import type { MissionCheckpoint } from "./types.js";
+export interface CheckpointState {
+    definitions: Record<string, MissionCheckpoint[]>;
+    active: Record<string, {
+        checkpoint: MissionCheckpoint;
+        reachedAt: string;
+    }>;
+    resumed: string[];
+}
+export interface CheckpointStore {
+    load(): Promise<CheckpointState>;
+    save(state: CheckpointState): Promise<void>;
+    removeGroup(state: CheckpointState, group: string): Promise<CheckpointState>;
+}
+//# sourceMappingURL=checkpoint-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-store.d.ts","sourceRoot":"","sources":["../src/checkpoint-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9E"}

package/dist/checkpoint-store.js

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

package/dist/checkpoint-store.js.map

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

package/dist/config-store.d.ts

@@ -0,0 +1,13 @@
+import type { PolpoConfig } from "./types.js";
+/**
+ * Persistent store for project-level configuration (.polpo/polpo.json).
+ */
+export interface ConfigStore {
+    /** Check if a config has been saved. */
+    exists(): Promise<boolean>;
+    /** Load the saved config, or undefined if none. */
+    get(): Promise<PolpoConfig | undefined>;
+    /** Persist the config. Creates the directory if needed. */
+    save(config: PolpoConfig): Promise<void>;
+}
+//# sourceMappingURL=config-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,mDAAmD;IACnD,GAAG,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACxC,2DAA2D;IAC3D,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/config-store.js

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

package/dist/config-store.js.map

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

package/dist/cron.d.ts

@@ -0,0 +1,29 @@
+interface CronField {
+    values: Set<number>;
+}
+interface ParsedCron {
+    minute: CronField;
+    hour: CronField;
+    dayOfMonth: CronField;
+    month: CronField;
+    dayOfWeek: CronField;
+}
+/**
+ * Parse a 5-field cron expression into a structured object.
+ */
+export declare function parseCron(expression: string): ParsedCron;
+/**
+ * Check if a given Date matches a parsed cron expression.
+ */
+export declare function matchesCron(cron: ParsedCron, date: Date): boolean;
+/**
+ * Calculate the next occurrence of a cron expression after the given date.
+ * Searches up to ~2 years ahead to avoid infinite loops.
+ */
+export declare function nextCronOccurrence(expression: string, after: Date): Date | null;
+/**
+ * Check if a string looks like a cron expression (5 space-separated fields).
+ */
+export declare function isCronExpression(str: string): boolean;
+export {};
+//# sourceMappingURL=cron.d.ts.map

package/dist/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAQA,UAAU,SAAS;IACjB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;CACtB;AAuCD;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAqBxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAQjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAkB/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/cron.js

@@ -0,0 +1,105 @@
+// Minimal cron expression parser — zero external dependencies.
+//
+// Supports standard 5-field cron: minute hour day-of-month month day-of-week
+//   - Numbers, ranges (1-5), steps (star/10), lists (1,3,5), wildcards (star)
+//   - Day-of-week: 0-7 (0 and 7 = Sunday)
+//
+// Does NOT support: @yearly/@monthly shortcuts, seconds field, L/W/# modifiers.
+const FIELD_RANGES = [
+    [0, 59], // minute
+    [0, 23], // hour
+    [1, 31], // day of month
+    [1, 12], // month
+    [0, 7], // day of week (0 and 7 = Sunday)
+];
+/** Parse a single cron field (e.g. "1,3,5", "1-5"). */
+function parseField(field, min, max) {
+    const values = new Set();
+    for (const part of field.split(",")) {
+        const stepMatch = part.match(/^(.+)\/(\d+)$/);
+        const step = stepMatch ? parseInt(stepMatch[2], 10) : 1;
+        const range = stepMatch ? stepMatch[1] : part;
+        if (range === "*") {
+            for (let i = min; i <= max; i += step)
+                values.add(i);
+        }
+        else if (range.includes("-")) {
+            const [startStr, endStr] = range.split("-");
+            const start = parseInt(startStr, 10);
+            const end = parseInt(endStr, 10);
+            if (isNaN(start) || isNaN(end))
+                throw new Error(`Invalid cron range: ${range}`);
+            for (let i = start; i <= end; i += step) {
+                if (i >= min && i <= max)
+                    values.add(i);
+            }
+        }
+        else {
+            const val = parseInt(range, 10);
+            if (isNaN(val))
+                throw new Error(`Invalid cron value: ${range}`);
+            if (val >= min && val <= max)
+                values.add(val);
+        }
+    }
+    return { values };
+}
+/**
+ * Parse a 5-field cron expression into a structured object.
+ */
+export function parseCron(expression) {
+    const fields = expression.trim().split(/\s+/);
+    if (fields.length !== 5) {
+        throw new Error(`Invalid cron expression "${expression}": expected 5 fields, got ${fields.length}`);
+    }
+    const parsed = {
+        minute: parseField(fields[0], ...FIELD_RANGES[0]),
+        hour: parseField(fields[1], ...FIELD_RANGES[1]),
+        dayOfMonth: parseField(fields[2], ...FIELD_RANGES[2]),
+        month: parseField(fields[3], ...FIELD_RANGES[3]),
+        dayOfWeek: parseField(fields[4], ...FIELD_RANGES[4]),
+    };
+    // Normalize day-of-week: 7 → 0 (both mean Sunday)
+    if (parsed.dayOfWeek.values.has(7)) {
+        parsed.dayOfWeek.values.add(0);
+        parsed.dayOfWeek.values.delete(7);
+    }
+    return parsed;
+}
+/**
+ * Check if a given Date matches a parsed cron expression.
+ */
+export function matchesCron(cron, date) {
+    return (cron.minute.values.has(date.getMinutes()) &&
+        cron.hour.values.has(date.getHours()) &&
+        cron.dayOfMonth.values.has(date.getDate()) &&
+        cron.month.values.has(date.getMonth() + 1) && // JS months are 0-based
+        cron.dayOfWeek.values.has(date.getDay()));
+}
+/**
+ * Calculate the next occurrence of a cron expression after the given date.
+ * Searches up to ~2 years ahead to avoid infinite loops.
+ */
+export function nextCronOccurrence(expression, after) {
+    const cron = parseCron(expression);
+    // Start from the next minute boundary
+    const candidate = new Date(after);
+    candidate.setSeconds(0, 0);
+    candidate.setMinutes(candidate.getMinutes() + 1);
+    // Search up to ~2 years ahead (prevent infinite loop)
+    const maxIterations = 525_960; // ~365 * 24 * 60 minutes
+    for (let i = 0; i < maxIterations; i++) {
+        if (matchesCron(cron, candidate)) {
+            return candidate;
+        }
+        candidate.setMinutes(candidate.getMinutes() + 1);
+    }
+    return null; // No match found within search window
+}
+/**
+ * Check if a string looks like a cron expression (5 space-separated fields).
+ */
+export function isCronExpression(str) {
+    return /^\s*(\S+\s+){4}\S+\s*$/.test(str);
+}
+//# sourceMappingURL=cron.js.map

package/dist/cron.js.map

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

package/dist/delay-store.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DelayStore — pure interface for mission delay persistence.
+ *
+ * FileDelayStore (node:fs) implements this in the shell.
+ */
+import type { MissionDelay } from "./types.js";
+export interface DelayState {
+    definitions: Record<string, MissionDelay[]>;
+    active: Record<string, {
+        delay: MissionDelay;
+        startedAt: string;
+        expiresAt: string;
+    }>;
+    expired: string[];
+}
+export interface DelayStore {
+    load(): Promise<DelayState>;
+    save(state: DelayState): Promise<void>;
+    removeGroup(state: DelayState, group: string): Promise<DelayState>;
+}
+//# sourceMappingURL=delay-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delay-store.d.ts","sourceRoot":"","sources":["../src/delay-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpE"}

package/dist/delay-store.js

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

package/dist/delay-store.js.map

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

package/dist/escalation-manager.d.ts

@@ -0,0 +1,31 @@
+import type { OrchestratorContext } from "./orchestrator-context.js";
+import type { ApprovalManager } from "./approval-manager.js";
+/**
+ * Manages the escalation chain when tasks fail repeatedly.
+ *
+ * 4-level hybrid escalation:
+ *   Level 0: Retry with same agent (handled by AssessmentOrchestrator — not managed here)
+ *   Level 1: Escalate to fallback agent (handled by RetryPolicy — not managed here)
+ *   Level 2: Orchestrator LLM analysis — reformulate the task and retry
+ *   Level 3: Human-in-the-loop — notify humans and create approval request
+ */
+export declare class EscalationManager {
+    private ctx;
+    private approvalMgr?;
+    private taskLevels;
+    private timers;
+    constructor(ctx: OrchestratorContext, approvalMgr?: ApprovalManager | undefined);
+    init(): void;
+    private getStartLevel;
+    private escalate;
+    private escalateToAgent;
+    private escalateToOrchestrator;
+    private escalateToHuman;
+    private advanceLevel;
+    private finalFail;
+    private buildFailureContext;
+    private startTimer;
+    private clearTimer;
+    dispose(): void;
+}
+//# sourceMappingURL=escalation-manager.d.ts.map