@oni.bot/core 0.6.3 → 1.0.0

package/dist/oni-code/cron/persistence.js

@@ -0,0 +1,58 @@
+import { writeFileSync, mkdirSync, renameSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const ONI_DIR = ".oni";
+const TASKS_FILE = "scheduled_tasks.json";
+const CURRENT_VERSION = 1;
+const DEFAULT_AUTO_EXPIRY_MS = 3 * 24 * 60 * 60 * 1000; // 3 days
+/**
+ * Load persisted jobs from `<rootDir>/.oni/scheduled_tasks.json`.
+ * Filters out expired jobs and jobs with missing required fields.
+ * Returns empty array if file is missing or corrupt.
+ */
+export function loadPersistedJobs(rootDir, opts) {
+    try {
+        const filePath = join(rootDir, ONI_DIR, TASKS_FILE);
+        const raw = readFileSync(filePath, "utf-8");
+        const data = JSON.parse(raw);
+        if (!data || !Array.isArray(data.jobs))
+            return [];
+        const now = Date.now();
+        const expiryMs = opts?.autoExpiryMs ?? DEFAULT_AUTO_EXPIRY_MS;
+        return data.jobs.filter((j) => {
+            // Validate required fields
+            if (!j.id || !j.cron || !j.prompt || typeof j.createdAt !== "number" || typeof j.recurring !== "boolean") {
+                return false;
+            }
+            // Filter expired
+            return (now - j.createdAt) <= expiryMs;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+export function persistJobs(rootDir, jobs) {
+    try {
+        const dir = join(rootDir, ONI_DIR);
+        mkdirSync(dir, { recursive: true });
+        const data = {
+            version: CURRENT_VERSION,
+            jobs: jobs.map((j) => ({
+                id: j.id,
+                cron: j.cron,
+                prompt: j.prompt,
+                recurring: j.recurring,
+                createdAt: j.createdAt,
+                humanSchedule: j.humanSchedule,
+            })),
+        };
+        const filePath = join(dir, TASKS_FILE);
+        const tmpPath = filePath + ".tmp";
+        writeFileSync(tmpPath, JSON.stringify(data, null, 2), "utf-8");
+        renameSync(tmpPath, filePath);
+    }
+    catch {
+        // Fire-and-forget — write errors must not crash the scheduler
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/dist/oni-code/cron/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../src/oni-code/cron/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,OAAO,GAAG,MAAM,CAAC;AACvB,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAC1C,MAAM,eAAe,GAAG,CAAC,CAAC;AAiB1B,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAOjE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAkB;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAkB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAElD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,EAAE,YAAY,IAAI,sBAAsB,CAAC;QAE9D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,2BAA2B;YAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACzG,OAAO,KAAK,CAAC;YACf,CAAC;YACD,iBAAiB;YACjB,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAe;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpC,MAAM,IAAI,GAAkB;YAC1B,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,aAAa,EAAE,CAAC,CAAC,aAAa;aAC/B,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}

package/dist/oni-code/cron/scheduler.d.ts

@@ -0,0 +1,64 @@
+import type { CronJob, CronJobInput } from "./store.js";
+export interface CronSchedulerConfig {
+    /** Callback: fires a prompt into the agent loop. */
+    onFire: (prompt: string, jobId: string) => void;
+    /** Callback: returns true if the agent is currently busy. */
+    isBusy: () => boolean;
+    /** Override tick interval for testing (default 1000ms). */
+    tickIntervalMs?: number;
+    /** Override auto-expiry duration for testing (default 3 days). */
+    autoExpiryMs?: number;
+    /** Optional callback fired after create() and cancel().
+     *  Receives the current job list. Errors are swallowed.
+     *  NOT fired on dispose() — persisted state should survive session exit. */
+    onMutate?: (jobs: CronJob[]) => void;
+}
+export declare class CronScheduler {
+    private store;
+    private timer;
+    private config;
+    private tickIntervalMs;
+    private autoExpiryMs;
+    /** Track the last minute we fired for each job to avoid double-firing within the same minute. */
+    private lastFiredMinute;
+    constructor(config: CronSchedulerConfig);
+    /** Create and schedule a new job. Returns the job. */
+    create(input: CronJobInput): CronJob;
+    /** Cancel a job by ID. Returns true if found. */
+    cancel(id: string): boolean;
+    /** List all active jobs. */
+    list(): CronJob[];
+    /** Get a job by ID. */
+    get(id: string): CronJob | undefined;
+    /** Number of active jobs. */
+    get size(): number;
+    /** Start the tick loop. Idempotent. */
+    start(): void;
+    /** Stop the tick loop. Idempotent. */
+    stop(): void;
+    /** Stop and clear all jobs. */
+    dispose(): void;
+    /** Bulk-restore persisted jobs. Preserves original createdAt.
+     *  Does NOT fire onMutate — avoids N redundant disk writes at startup.
+     *  Silently skips jobs that fail (e.g., at capacity). */
+    restore(jobs: Array<{
+        id: string;
+        cron: string;
+        prompt: string;
+        recurring: boolean;
+        createdAt: number;
+        humanSchedule?: string;
+    }>): void;
+    /** Whether the tick loop is running. */
+    get running(): boolean;
+    private notifyMutate;
+    /** Single tick: check all jobs, fire ready ones (if idle). */
+    private tick;
+    /** Fire a job's prompt. */
+    private fire;
+    /** Compute and store the next fire time for a job (approximate — used for display). */
+    private computeNextFireTime;
+    /** Exposed for testing: manually invoke one tick cycle. */
+    _tick(): void;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/oni-code/cron/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/oni-code/cron/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAWxD,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,6DAA6D;IAC7D,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;gFAE4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtC;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,iGAAiG;IACjG,OAAO,CAAC,eAAe,CAA6B;gBAExC,MAAM,EAAE,mBAAmB;IAMvC,sDAAsD;IACtD,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAkBpC,iDAAiD;IACjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAa3B,4BAA4B;IAC5B,IAAI,IAAI,OAAO,EAAE;IAIjB,uBAAuB;IACvB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,6BAA6B;IAC7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uCAAuC;IACvC,KAAK,IAAI,IAAI;IASb,sCAAsC;IACtC,IAAI,IAAI,IAAI;IAOZ,+BAA+B;IAC/B,OAAO,IAAI,IAAI;IAMf;;6DAEyD;IACzD,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAqBvI,wCAAwC;IACxC,IAAI,OAAO,IAAI,OAAO,CAErB;IAID,OAAO,CAAC,YAAY;IAWpB,8DAA8D;IAC9D,OAAO,CAAC,IAAI;IA0CZ,2BAA2B;IAC3B,OAAO,CAAC,IAAI;IAQZ,uFAAuF;IACvF,OAAO,CAAC,mBAAmB;IAe3B,2DAA2D;IAC3D,KAAK,IAAI,IAAI;CAGd"}

package/dist/oni-code/cron/scheduler.js

@@ -0,0 +1,188 @@
+import { CronStore } from "./store.js";
+import { cronMatches } from "./matcher.js";
+import { humanizeCron } from "./humanize.js";
+// ── Constants ────────────────────────────────────────────────
+const TICK_INTERVAL_MS = 1_000;
+const AUTO_EXPIRY_MS = 259_200_000; // 3 days (72 hours)
+// ── Scheduler ────────────────────────────────────────────────
+export class CronScheduler {
+    store = new CronStore();
+    timer = null;
+    config;
+    tickIntervalMs;
+    autoExpiryMs;
+    /** Track the last minute we fired for each job to avoid double-firing within the same minute. */
+    lastFiredMinute = new Map();
+    constructor(config) {
+        this.config = config;
+        this.tickIntervalMs = config.tickIntervalMs ?? TICK_INTERVAL_MS;
+        this.autoExpiryMs = config.autoExpiryMs ?? AUTO_EXPIRY_MS;
+    }
+    /** Create and schedule a new job. Returns the job. */
+    create(input) {
+        const job = this.store.add({
+            ...input,
+            humanSchedule: input.humanSchedule ?? humanizeCron(input.cron),
+        });
+        // Compute initial nextFireTime
+        this.computeNextFireTime(job);
+        // Auto-start ticking if not already running
+        if (!this.timer) {
+            this.start();
+        }
+        this.notifyMutate();
+        return job;
+    }
+    /** Cancel a job by ID. Returns true if found. */
+    cancel(id) {
+        this.lastFiredMinute.delete(id);
+        const removed = this.store.remove(id);
+        // Stop ticking if no more jobs
+        if (this.store.size === 0) {
+            this.stop();
+        }
+        this.notifyMutate();
+        return removed;
+    }
+    /** List all active jobs. */
+    list() {
+        return this.store.list();
+    }
+    /** Get a job by ID. */
+    get(id) {
+        return this.store.get(id);
+    }
+    /** Number of active jobs. */
+    get size() {
+        return this.store.size;
+    }
+    /** Start the tick loop. Idempotent. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.tick(), this.tickIntervalMs);
+        // Don't prevent process exit
+        if (this.timer && typeof this.timer === "object" && "unref" in this.timer) {
+            this.timer.unref();
+        }
+    }
+    /** Stop the tick loop. Idempotent. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Stop and clear all jobs. */
+    dispose() {
+        this.stop();
+        this.store.clear();
+        this.lastFiredMinute.clear();
+    }
+    /** Bulk-restore persisted jobs. Preserves original createdAt.
+     *  Does NOT fire onMutate — avoids N redundant disk writes at startup.
+     *  Silently skips jobs that fail (e.g., at capacity). */
+    restore(jobs) {
+        for (const pj of jobs) {
+            try {
+                const job = this.store.add({
+                    cron: pj.cron,
+                    prompt: pj.prompt,
+                    recurring: pj.recurring,
+                    createdAt: pj.createdAt,
+                    humanSchedule: pj.humanSchedule ?? humanizeCron(pj.cron),
+                });
+                this.computeNextFireTime(job);
+            }
+            catch {
+                // Skip jobs that fail to restore (e.g., at capacity)
+            }
+        }
+        if (this.store.size > 0 && !this.timer) {
+            this.start();
+        }
+    }
+    /** Whether the tick loop is running. */
+    get running() {
+        return this.timer !== null;
+    }
+    // ── Private helpers ─────────────────────────────────────────
+    notifyMutate() {
+        if (!this.config.onMutate)
+            return;
+        try {
+            this.config.onMutate(this.store.list());
+        }
+        catch {
+            // Mutation callback errors must not crash the scheduler
+        }
+    }
+    // ── Internal ───────────────────────────────────────────────
+    /** Single tick: check all jobs, fire ready ones (if idle). */
+    tick() {
+        if (this.config.isBusy())
+            return;
+        const now = Date.now();
+        const currentDate = new Date(now);
+        const currentMinute = Math.floor(now / 60_000);
+        for (const job of this.store.list()) {
+            // Check cron match
+            if (!cronMatches(job.cron, currentDate))
+                continue;
+            // Avoid double-firing within the same minute
+            if (this.lastFiredMinute.get(job.id) === currentMinute)
+                continue;
+            // Check auto-expiry (3 days)
+            const age = now - job.createdAt;
+            if (age > this.autoExpiryMs) {
+                // Fire one final time, then delete
+                this.lastFiredMinute.set(job.id, currentMinute);
+                this.fire(job);
+                this.store.remove(job.id);
+                this.lastFiredMinute.delete(job.id);
+                continue;
+            }
+            // Fire!
+            this.lastFiredMinute.set(job.id, currentMinute);
+            this.fire(job);
+            // One-shot: delete after firing
+            if (!job.recurring) {
+                this.store.remove(job.id);
+                this.lastFiredMinute.delete(job.id);
+            }
+        }
+        // Auto-stop if all jobs gone
+        if (this.store.size === 0) {
+            this.stop();
+        }
+    }
+    /** Fire a job's prompt. */
+    fire(job) {
+        try {
+            this.config.onFire(job.prompt, job.id);
+        }
+        catch {
+            // Fire callback errors must not crash the scheduler
+        }
+    }
+    /** Compute and store the next fire time for a job (approximate — used for display). */
+    computeNextFireTime(job) {
+        const now = new Date();
+        // Scan forward up to 24 hours to find the next matching minute
+        for (let i = 1; i <= 1440; i++) {
+            const candidate = new Date(now.getTime() + i * 60_000);
+            candidate.setSeconds(0, 0);
+            if (cronMatches(job.cron, candidate)) {
+                this.store.updateFireTime(job.id, candidate.getTime());
+                return;
+            }
+        }
+        // Fallback: 1 minute from now
+        this.store.updateFireTime(job.id, now.getTime() + 60_000);
+    }
+    /** Exposed for testing: manually invoke one tick cycle. */
+    _tick() {
+        this.tick();
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/oni-code/cron/scheduler.js.map

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

package/dist/oni-code/cron/store.d.ts

@@ -0,0 +1,46 @@
+export interface CronJob {
+    /** 8-character hex ID */
+    id: string;
+    /** 5-field cron expression */
+    cron: string;
+    /** Prompt to fire into the agent loop */
+    prompt: string;
+    /** If true, reschedule after firing. If false, delete after firing. */
+    recurring: boolean;
+    /** Creation timestamp (ms) */
+    createdAt: number;
+    /** Next computed fire time (ms). Updated after each fire. */
+    nextFireTime: number;
+    /** Human-readable schedule description */
+    humanSchedule?: string;
+}
+export interface CronJobInput {
+    cron: string;
+    prompt: string;
+    recurring?: boolean;
+    humanSchedule?: string;
+    /** Optional creation timestamp (ms). Preserved when restoring persisted jobs. */
+    createdAt?: number;
+}
+export declare class CronStore {
+    private jobs;
+    /** Generate an 8-char hex ID */
+    private generateId;
+    /** Add a new job. Returns the created job. Throws if at capacity. */
+    add(input: CronJobInput): CronJob;
+    /** Remove a job by ID. Returns true if found and removed. */
+    remove(id: string): boolean;
+    /** Get a job by ID. */
+    get(id: string): CronJob | undefined;
+    /** List all jobs. */
+    list(): CronJob[];
+    /** Get all jobs whose nextFireTime <= now. */
+    getReady(now: number): CronJob[];
+    /** Update a job's nextFireTime. */
+    updateFireTime(id: string, nextFireTime: number): void;
+    /** Number of active jobs. */
+    get size(): number;
+    /** Clear all jobs. */
+    clear(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/oni-code/cron/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/oni-code/cron/store.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAA8B;IAE1C,gCAAgC;IAChC,OAAO,CAAC,UAAU;IAIlB,qEAAqE;IACrE,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAqBjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,uBAAuB;IACvB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,qBAAqB;IACrB,IAAI,IAAI,OAAO,EAAE;IAIjB,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE;IAUhC,mCAAmC;IACnC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAOtD,6BAA6B;IAC7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAGd"}

package/dist/oni-code/cron/store.js

@@ -0,0 +1,68 @@
+import { randomBytes } from "node:crypto";
+// ── Constants ────────────────────────────────────────────────
+const MAX_JOBS = 50;
+// ── Store ────────────────────────────────────────────────────
+export class CronStore {
+    jobs = new Map();
+    /** Generate an 8-char hex ID */
+    generateId() {
+        return randomBytes(4).toString("hex");
+    }
+    /** Add a new job. Returns the created job. Throws if at capacity. */
+    add(input) {
+        if (this.jobs.size >= MAX_JOBS) {
+            throw new Error(`Maximum of ${MAX_JOBS} concurrent scheduled jobs reached`);
+        }
+        const id = this.generateId();
+        const now = Date.now();
+        const job = {
+            id,
+            cron: input.cron,
+            prompt: input.prompt,
+            recurring: input.recurring ?? true,
+            createdAt: input.createdAt ?? now,
+            nextFireTime: 0, // Will be computed by scheduler
+            humanSchedule: input.humanSchedule,
+        };
+        this.jobs.set(id, job);
+        return job;
+    }
+    /** Remove a job by ID. Returns true if found and removed. */
+    remove(id) {
+        return this.jobs.delete(id);
+    }
+    /** Get a job by ID. */
+    get(id) {
+        return this.jobs.get(id);
+    }
+    /** List all jobs. */
+    list() {
+        return [...this.jobs.values()];
+    }
+    /** Get all jobs whose nextFireTime <= now. */
+    getReady(now) {
+        const ready = [];
+        for (const job of this.jobs.values()) {
+            if (job.nextFireTime > 0 && job.nextFireTime <= now) {
+                ready.push(job);
+            }
+        }
+        return ready;
+    }
+    /** Update a job's nextFireTime. */
+    updateFireTime(id, nextFireTime) {
+        const job = this.jobs.get(id);
+        if (job) {
+            job.nextFireTime = nextFireTime;
+        }
+    }
+    /** Number of active jobs. */
+    get size() {
+        return this.jobs.size;
+    }
+    /** Clear all jobs. */
+    clear() {
+        this.jobs.clear();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/oni-code/cron/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/oni-code/cron/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8B1C,gEAAgE;AAEhE,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,gEAAgE;AAEhE,MAAM,OAAO,SAAS;IACZ,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE1C,gCAAgC;IACxB,UAAU;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,qEAAqE;IACrE,GAAG,CAAC,KAAmB;QACrB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,oCAAoC,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAY;YACnB,EAAE;YACF,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;YACjC,YAAY,EAAE,CAAC,EAAE,gCAAgC;YACjD,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,uBAAuB;IACvB,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,qBAAqB;IACrB,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,GAAW;QAClB,MAAM,KAAK,GAAc,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mCAAmC;IACnC,cAAc,CAAC,EAAU,EAAE,YAAoB;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;QAClC,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,sBAAsB;IACtB,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/oni-code/env.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Load environment variables from the target project, current working directory,
+ * and the user's global ONI env directory.
+ *
+ * Precedence:
+ * 1. Existing shell environment
+ * 2. Explicit project directory (`--dir`)
+ * 3. Current working directory
+ * 4. Global ONI directory (`~/.oni`)
+ * 5. Home directory (`~`)
+ * 6. `.env.local` before `.env` inside each directory
+ */
+export declare function loadProjectEnv(projectDir?: string, options?: {
+    cwd?: string;
+    homeDir?: string;
+}): string[];
+//# sourceMappingURL=env.d.ts.map

package/dist/oni-code/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/oni-code/env.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,EAAE,CAoBV"}

package/dist/oni-code/env.js

@@ -0,0 +1,51 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { config as dotenvConfig } from "dotenv";
+const ENV_FILES = [".env.local", ".env"];
+function uniqueDirs(dirs) {
+    const seen = new Set();
+    const ordered = [];
+    for (const dir of dirs) {
+        if (!dir)
+            continue;
+        const resolved = resolve(dir);
+        if (seen.has(resolved))
+            continue;
+        seen.add(resolved);
+        ordered.push(resolved);
+    }
+    return ordered;
+}
+/**
+ * Load environment variables from the target project, current working directory,
+ * and the user's global ONI env directory.
+ *
+ * Precedence:
+ * 1. Existing shell environment
+ * 2. Explicit project directory (`--dir`)
+ * 3. Current working directory
+ * 4. Global ONI directory (`~/.oni`)
+ * 5. Home directory (`~`)
+ * 6. `.env.local` before `.env` inside each directory
+ */
+export function loadProjectEnv(projectDir, options) {
+    const loaded = [];
+    const cwd = options?.cwd ?? process.cwd();
+    const homeDir = options?.homeDir ?? homedir();
+    const dirs = uniqueDirs([projectDir, cwd, join(homeDir, ".oni"), homeDir]);
+    for (const dir of dirs) {
+        for (const file of ENV_FILES) {
+            const path = join(dir, file);
+            if (!existsSync(path))
+                continue;
+            const result = dotenvConfig({ path, quiet: true });
+            if (result.error) {
+                throw new Error(`Failed to load environment file: ${path}`);
+            }
+            loaded.push(path);
+        }
+    }
+    return loaded;
+}
+//# sourceMappingURL=env.js.map

package/dist/oni-code/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/oni-code/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,SAAS,GAAG,CAAC,YAAY,EAAE,MAAM,CAAU,CAAC;AAElD,SAAS,UAAU,CAAC,IAA+B;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAmB,EACnB,OAA4C;IAE5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEhC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/oni-code/file-reader.d.ts

@@ -0,0 +1,28 @@
+export interface ExtractedContent {
+    /** Extracted text content */
+    content: string;
+    /** Detected format (e.g. "docx", "pdf", "xlsx", "image") */
+    format: string;
+    /** Additional metadata (page count, sheet names, image dimensions, etc.) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parse ZIP local file headers and extract deflated entries as UTF-8 strings.
+ * Returns a Map<filename, decompressedContent>.
+ *
+ * This is a minimal parser — it reads local headers sequentially
+ * and decompresses deflate (method 8) or stores (method 0) entries.
+ * Sufficient for Office Open XML formats.
+ */
+export declare function parseZipEntries(buf: Buffer): Map<string, string>;
+/**
+ * Extract text content from a file based on its extension.
+ * Returns structured content for binary formats, or reads as UTF-8 for text files.
+ */
+export declare function extractFileContent(absPath: string): ExtractedContent;
+/**
+ * Returns true if the file extension indicates a binary format
+ * that extractFileContent can handle (not a plain text file).
+ */
+export declare function isBinaryFormat(absPath: string): boolean;
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/oni-code/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../src/oni-code/file-reader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AA0CD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA0ChE;AAkQD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAuCpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD"}