@agentick/scheduler 0.7.0

package/README.md

@@ -0,0 +1,183 @@
+# @agentick/scheduler
+
+Scheduled jobs for Agentick agents. Pluggable backends, file-based persistence,
+crash recovery.
+
+## Install
+
+```sh
+pnpm add @agentick/scheduler
+```
+
+## Quick Start
+
+```typescript
+import { createClient } from "@agentick/client";
+import { CronService, createScheduleTool, bindSchedulerStore } from "@agentick/scheduler";
+
+const cronService = new CronService({
+  dataDir: ".myagent",
+  client,
+  defaultTarget: "tui",
+});
+await cronService.start();
+
+// Give the agent a tool to manage its own schedule
+const ScheduleTool = createScheduleTool(cronService.store);
+```
+
+## Architecture
+
+```
+CronService
+  ├── JobStore                    (persistent job definitions)
+  ├── SchedulerBackend            (pluggable — when to fire)
+  │     └── NodeCronBackend       (default, in-process timers)
+  └── TriggerWatcher (optional)   (external trigger pickup)
+```
+
+**JobStore** persists jobs as individual JSON files in `<dataDir>/jobs/`.
+Survives crashes.
+
+**SchedulerBackend** is the pluggable timer mechanism. When a job fires, it
+calls the `onFire` callback provided by CronService, which dispatches to the
+target session via `client.session(target).send()`.
+
+**TriggerWatcher** watches `<dataDir>/triggers/` for externally-written JSON
+files. System cron, scripts, webhooks — anything that writes a trigger file
+wakes the agent. Enabled by default, opt out with `watchExternalTriggers: false`.
+
+## Backend Interface
+
+```typescript
+interface SchedulerBackend {
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  schedule(job: Job, onFire: () => Promise<void>): void;
+  unschedule(jobId: string): void;
+}
+```
+
+Four methods. `start`/`stop` for lifecycle. `schedule`/`unschedule` for per-job
+timer management. The backend decides everything about HOW and WHEN — timers,
+durability, retries. Dispatch is CronService's job.
+
+### NodeCronBackend (default)
+
+In-process scheduling via `node-cron`. Writes trigger files for crash recovery —
+if the process dies between fire and dispatch, trigger files persist and are
+drained on next `start()`.
+
+```typescript
+import { createNodeCronBackend } from "@agentick/scheduler";
+
+const backend = createNodeCronBackend({ triggersDir: ".myagent/triggers" });
+```
+
+### Custom Backends
+
+Implement `SchedulerBackend` for any timer source. Durability is the
+backend's problem — not the framework's.
+
+```typescript
+// BullMQ example (conceptual)
+const bullBackend: SchedulerBackend = {
+  async start() {
+    /* connect to Redis, start worker */
+  },
+  async stop() {
+    /* close connections */
+  },
+  schedule(job, onFire) {
+    /* create repeatable BullMQ job */
+  },
+  unschedule(jobId) {
+    /* remove BullMQ job scheduler */
+  },
+};
+
+const service = new CronService({
+  dataDir: ".myagent",
+  client,
+  backend: bullBackend,
+  watchExternalTriggers: false,
+});
+```
+
+## Agent Tool
+
+`createScheduleTool` returns a tool the agent uses to manage its schedule.
+Actions: `add`, `list`, `remove`, `enable`, `disable`.
+
+```tsx
+import { createScheduleTool } from "@agentick/scheduler";
+
+const ScheduleTool = createScheduleTool(cronService.store);
+
+// In your component tree:
+<ScheduleTool />;
+```
+
+The tool's `render` function puts active jobs in context so the model knows
+what's already scheduled.
+
+## Heartbeat
+
+A heartbeat is a recurring job that reads a file and prompts the agent to act
+on its contents. If the file is empty or missing, the trigger is skipped.
+
+```typescript
+import { createHeartbeatJob } from "@agentick/scheduler";
+
+cronService.store.create({
+  ...createHeartbeatJob({
+    cron: "*/5 * * * *",
+    target: "tui",
+    heartbeatFile: ".myagent/HEARTBEAT.md",
+  }),
+  id: "heartbeat",
+});
+```
+
+## External Triggers
+
+Anything that writes a JSON file to the triggers directory wakes the agent.
+
+```bash
+echo '{"target":"tui","prompt":"wake up","jobId":"manual","jobName":"manual","firedAt":"2025-01-01T00:00:00Z","oneshot":true}' \
+  > .myagent/triggers/$(date +%s)-manual.json
+```
+
+## CronService Options
+
+```typescript
+interface CronServiceOptions {
+  dataDir: string; // Root dir — jobs/ and triggers/ live here
+  client: AgentickClient; // Client for sending messages to sessions
+  backend?: SchedulerBackend; // Default: NodeCronBackend
+  watchExternalTriggers?: boolean; // Default: true
+  defaultTarget?: string; // Fallback session ID
+  onTriggerProcessed?: (trigger: Trigger) => void;
+  onError?: (error: Error, context: string) => void;
+}
+```
+
+## Exports
+
+```typescript
+export { CronService } from "./cron-service.js";
+export { JobStore } from "./job-store.js";
+export { createNodeCronBackend } from "./node-cron-backend.js";
+export { TriggerWatcher } from "./trigger-watcher.js";
+export { createScheduleTool } from "./schedule-tool.js";
+export { createHeartbeatJob } from "./heartbeat.js";
+export { bindSchedulerStore, getSchedulerStore } from "./bridge.js";
+export type {
+  Job,
+  Trigger,
+  SchedulerBackend,
+  CronServiceOptions,
+  HeartbeatOptions,
+  CreateJobInput,
+} from "./types.js";
+```

package/dist/bridge.d.ts

@@ -0,0 +1,4 @@
+import type { JobStore } from "./job-store.js";
+export declare function bindSchedulerStore(store: JobStore): void;
+export declare function getSchedulerStore(): JobStore | null;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAExD;AAED,wBAAgB,iBAAiB,IAAI,QAAQ,GAAG,IAAI,CAEnD"}

package/dist/bridge.js

@@ -0,0 +1,8 @@
+let _store = null;
+export function bindSchedulerStore(store) {
+    _store = store;
+}
+export function getSchedulerStore() {
+    return _store;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAEA,IAAI,MAAM,GAAoB,IAAI,CAAC;AAEnC,MAAM,UAAU,kBAAkB,CAAC,KAAe;IAChD,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cron-service.d.ts

@@ -0,0 +1,22 @@
+import type { Job, CronServiceOptions, HeartbeatOptions } from "./types.js";
+import { JobStore } from "./job-store.js";
+import { TriggerWatcher } from "./trigger-watcher.js";
+import type { SchedulerBackend } from "./types.js";
+export declare class CronService {
+    readonly store: JobStore;
+    readonly backend: SchedulerBackend;
+    readonly watcher: TriggerWatcher | null;
+    private readonly client;
+    private readonly defaultTarget;
+    private readonly onProcessed;
+    private readonly onError;
+    private scheduledIds;
+    constructor(options: CronServiceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Ensure a heartbeat job exists — idempotent */
+    ensureHeartbeat(options?: HeartbeatOptions): Job;
+    private _onStoreChange;
+    private _dispatch;
+}
+//# sourceMappingURL=cron-service.d.ts.map

package/dist/cron-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-service.d.ts","sourceRoot":"","sources":["../src/cron-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,YAAY,CAAqB;gBAE7B,OAAO,EAAE,kBAAkB;IAuBjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,iDAAiD;IACjD,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,GAAG;IAShD,OAAO,CAAC,cAAc,CAcpB;YAEY,SAAS;CAyDxB"}

package/dist/cron-service.js

@@ -0,0 +1,121 @@
+import { join } from "node:path";
+import { JobStore } from "./job-store.js";
+import { TriggerWatcher } from "./trigger-watcher.js";
+import { createNodeCronBackend } from "./node-cron-backend.js";
+import { createHeartbeatJob } from "./heartbeat.js";
+export class CronService {
+    store;
+    backend;
+    watcher;
+    client;
+    defaultTarget;
+    onProcessed;
+    onError;
+    scheduledIds = new Set();
+    constructor(options) {
+        const jobsDir = join(options.dataDir, "jobs");
+        const triggersDir = join(options.dataDir, "triggers");
+        this.client = options.client;
+        this.defaultTarget = options.defaultTarget;
+        this.onProcessed = options.onTriggerProcessed;
+        this.onError = options.onError;
+        this.store = new JobStore(jobsDir);
+        this.backend = options.backend ?? createNodeCronBackend({ triggersDir });
+        // External trigger watcher — enabled by default, opt out with watchExternalTriggers: false
+        const watchExternal = options.watchExternalTriggers ?? true;
+        this.watcher = watchExternal
+            ? new TriggerWatcher(triggersDir, options.client, this.store, {
+                defaultTarget: options.defaultTarget,
+                onTriggerProcessed: options.onTriggerProcessed,
+                onError: options.onError,
+            })
+            : null;
+    }
+    async start() {
+        // Register all enabled jobs with the backend
+        for (const job of this.store.listEnabled()) {
+            this.backend.schedule(job, () => this._dispatch(job));
+            this.scheduledIds.add(job.id);
+        }
+        // React to store changes
+        this.store.on("change", this._onStoreChange);
+        await this.backend.start();
+        await this.watcher?.start();
+    }
+    async stop() {
+        this.store.off("change", this._onStoreChange);
+        await this.backend.stop();
+        this.watcher?.stop();
+    }
+    /** Ensure a heartbeat job exists — idempotent */
+    ensureHeartbeat(options) {
+        const existing = this.store.get("heartbeat");
+        if (existing)
+            return existing;
+        return this.store.create({
+            ...createHeartbeatJob(options),
+            id: "heartbeat",
+        });
+    }
+    _onStoreChange = () => {
+        const enabled = new Map(this.store.listEnabled().map((j) => [j.id, j]));
+        // Unschedule everything currently tracked
+        for (const id of this.scheduledIds) {
+            this.backend.unschedule(id);
+        }
+        this.scheduledIds.clear();
+        // Re-schedule enabled jobs
+        for (const [, job] of enabled) {
+            this.backend.schedule(job, () => this._dispatch(job));
+            this.scheduledIds.add(job.id);
+        }
+    };
+    async _dispatch(job) {
+        // Read fresh state — job may have been updated since scheduling
+        const current = this.store.get(job.id);
+        if (!current || !current.enabled)
+            return;
+        const target = current.target || this.defaultTarget;
+        if (!target) {
+            this.onError?.(new Error(`Job "${current.id}" has no target and no default configured`), "dispatch");
+            return;
+        }
+        try {
+            const session = this.client.session(target);
+            const handle = session.send({
+                messages: [
+                    {
+                        role: "event",
+                        content: [{ type: "text", text: current.prompt }],
+                        metadata: {
+                            source: { type: "cron" },
+                            event_type: "cron_trigger",
+                            job_id: current.id,
+                            job_name: current.name,
+                            fired_at: new Date().toISOString(),
+                        },
+                    },
+                ],
+            });
+            await handle.result;
+            // Update lastFiredAt
+            this.store.update(current.id, { lastFiredAt: new Date().toISOString() });
+            // Oneshot: delete after successful fire
+            if (current.oneshot) {
+                this.store.delete(current.id);
+            }
+            this.onProcessed?.({
+                jobId: current.id,
+                jobName: current.name,
+                target,
+                prompt: current.prompt,
+                firedAt: new Date().toISOString(),
+                oneshot: current.oneshot,
+            });
+        }
+        catch (error) {
+            this.onError?.(error instanceof Error ? error : new Error(String(error)), `dispatch:${current.id}`);
+        }
+    }
+}
+//# sourceMappingURL=cron-service.js.map

package/dist/cron-service.js.map

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

package/dist/heartbeat.d.ts

@@ -0,0 +1,3 @@
+import type { HeartbeatOptions, CreateJobInput } from "./types.js";
+export declare function createHeartbeatJob(opts?: HeartbeatOptions): CreateJobInput;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAa1E"}

package/dist/heartbeat.js

@@ -0,0 +1,14 @@
+export function createHeartbeatJob(opts) {
+    return {
+        name: "heartbeat",
+        cron: opts?.cron ?? "*/5 * * * *",
+        target: opts?.target ?? "tui",
+        prompt: "[heartbeat] Review your heartbeat file and act on any due, prioritized, or in-progress work.",
+        oneshot: false,
+        enabled: true,
+        metadata: {
+            heartbeatFile: opts?.heartbeatFile ?? ".tentickle/HEARTBEAT.md",
+        },
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,aAAa;QACjC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;QAC7B,MAAM,EACJ,8FAA8F;QAChG,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACR,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,yBAAyB;SAChE;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { CronService } from "./cron-service.js";
+export { JobStore } from "./job-store.js";
+export { createNodeCronBackend } from "./node-cron-backend.js";
+export { TriggerWatcher } from "./trigger-watcher.js";
+export { createScheduleTool } from "./schedule-tool.js";
+export { createHeartbeatJob } from "./heartbeat.js";
+export { bindSchedulerStore, getSchedulerStore } from "./bridge.js";
+export type { Job, Trigger, SchedulerBackend, CronServiceOptions, HeartbeatOptions, CreateJobInput, } from "./types.js";
+export type { NodeCronBackendOptions } from "./node-cron-backend.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EACV,GAAG,EACH,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { CronService } from "./cron-service.js";
+export { JobStore } from "./job-store.js";
+export { createNodeCronBackend } from "./node-cron-backend.js";
+export { TriggerWatcher } from "./trigger-watcher.js";
+export { createScheduleTool } from "./schedule-tool.js";
+export { createHeartbeatJob } from "./heartbeat.js";
+export { bindSchedulerStore, getSchedulerStore } from "./bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/job-store.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from "node:events";
+import type { Job, CreateJobInput } from "./types.js";
+export declare class JobStore extends EventEmitter {
+    private jobs;
+    private readonly jobsDir;
+    constructor(jobsDir: string);
+    list(): Job[];
+    listEnabled(): Job[];
+    get(id: string): Job | null;
+    create(input: CreateJobInput): Job;
+    update(id: string, updates: Partial<Pick<Job, "name" | "cron" | "target" | "prompt" | "oneshot" | "enabled" | "lastFiredAt" | "metadata">>): Job | null;
+    delete(id: string): boolean;
+    private _generateId;
+    private _nanoid;
+    private _load;
+    private _save;
+    private _remove;
+}
+//# sourceMappingURL=job-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.d.ts","sourceRoot":"","sources":["../src/job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUtD,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IAO3B,IAAI,IAAI,GAAG,EAAE;IAIb,WAAW,IAAI,GAAG,EAAE;IAIpB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAI3B,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,GAAG;IAiBlC,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CACF,GAAG,EACH,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAC3F,CACF,GACA,GAAG,GAAG,IAAI;IASb,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS3B,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;CAQhB"}

package/dist/job-store.js

@@ -0,0 +1,113 @@
+import { EventEmitter } from "node:events";
+import { mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync, existsSync, } from "node:fs";
+import { join } from "node:path";
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 48);
+}
+export class JobStore extends EventEmitter {
+    jobs = new Map();
+    jobsDir;
+    constructor(jobsDir) {
+        super();
+        this.jobsDir = jobsDir;
+        mkdirSync(jobsDir, { recursive: true });
+        this._load();
+    }
+    list() {
+        return [...this.jobs.values()];
+    }
+    listEnabled() {
+        return this.list().filter((j) => j.enabled);
+    }
+    get(id) {
+        return this.jobs.get(id) ?? null;
+    }
+    create(input) {
+        const id = input.id ?? this._generateId(input.name);
+        if (this.jobs.has(id)) {
+            throw new Error(`Job "${id}" already exists`);
+        }
+        const job = {
+            ...input,
+            id,
+            createdAt: new Date().toISOString(),
+        };
+        this.jobs.set(id, job);
+        this._save(job);
+        this.emit("change");
+        return job;
+    }
+    update(id, updates) {
+        const job = this.jobs.get(id);
+        if (!job)
+            return null;
+        Object.assign(job, updates);
+        this._save(job);
+        this.emit("change");
+        return job;
+    }
+    delete(id) {
+        const existed = this.jobs.delete(id);
+        if (existed) {
+            this._remove(id);
+            this.emit("change");
+        }
+        return existed;
+    }
+    _generateId(name) {
+        const base = slugify(name);
+        if (!base)
+            return this._nanoid();
+        if (!this.jobs.has(base))
+            return base;
+        for (let i = 2; i < 1000; i++) {
+            const candidate = `${base}-${i}`;
+            if (!this.jobs.has(candidate))
+                return candidate;
+        }
+        return `${base}-${this._nanoid()}`;
+    }
+    _nanoid() {
+        const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+        let id = "";
+        const bytes = new Uint8Array(8);
+        crypto.getRandomValues(bytes);
+        for (const b of bytes)
+            id += chars[b % chars.length];
+        return id;
+    }
+    _load() {
+        if (!existsSync(this.jobsDir))
+            return;
+        for (const file of readdirSync(this.jobsDir)) {
+            if (!file.endsWith(".json"))
+                continue;
+            try {
+                const raw = readFileSync(join(this.jobsDir, file), "utf-8");
+                const job = JSON.parse(raw);
+                if (job.id)
+                    this.jobs.set(job.id, job);
+            }
+            catch {
+                // Skip malformed files
+            }
+        }
+    }
+    _save(job) {
+        writeFileSync(join(this.jobsDir, `${job.id}.json`), JSON.stringify(job, null, 2) + "\n");
+    }
+    _remove(id) {
+        const path = join(this.jobsDir, `${id}.json`);
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            // Already gone
+        }
+    }
+}
+//# sourceMappingURL=job-store.js.map

package/dist/job-store.js.map

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

package/dist/node-cron-backend.d.ts

@@ -0,0 +1,12 @@
+import type { SchedulerBackend } from "./types.js";
+export interface NodeCronBackendOptions {
+    /** Directory for trigger files (crash recovery). If omitted, no trigger files — fires directly. */
+    triggersDir?: string;
+}
+/**
+ * In-process scheduling via node-cron. Optionally writes trigger files for
+ * crash recovery — if the process dies between fire and dispatch, trigger
+ * files persist and are drained on next `start()`.
+ */
+export declare function createNodeCronBackend(options?: NodeCronBackendOptions): SchedulerBackend;
+//# sourceMappingURL=node-cron-backend.d.ts.map

package/dist/node-cron-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-cron-backend.d.ts","sourceRoot":"","sources":["../src/node-cron-backend.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,CAgDxF"}

package/dist/node-cron-backend.js

@@ -0,0 +1,124 @@
+import cron, {} from "node-cron";
+import { writeFileSync, readFileSync, readdirSync, unlinkSync, existsSync, mkdirSync, } from "node:fs";
+import { join } from "node:path";
+/**
+ * In-process scheduling via node-cron. Optionally writes trigger files for
+ * crash recovery — if the process dies between fire and dispatch, trigger
+ * files persist and are drained on next `start()`.
+ */
+export function createNodeCronBackend(options) {
+    const timers = new Map();
+    const triggersDir = options?.triggersDir;
+    const pendingCallbacks = new Map();
+    if (triggersDir) {
+        mkdirSync(triggersDir, { recursive: true });
+    }
+    return {
+        async start() {
+            if (triggersDir) {
+                await drainPendingTriggers(triggersDir, pendingCallbacks);
+            }
+        },
+        async stop() {
+            for (const [id, entry] of timers) {
+                entry.task.stop();
+                timers.delete(id);
+            }
+        },
+        schedule(job, onFire) {
+            if (!cron.validate(job.cron))
+                return;
+            // Store callback for crash recovery drain
+            pendingCallbacks.set(job.id, onFire);
+            const wrappedFire = triggersDir
+                ? () => fireWithTriggerFile(triggersDir, job, onFire)
+                : () => {
+                    onFire();
+                };
+            const task = cron.schedule(job.cron, wrappedFire);
+            timers.set(job.id, { task, cronExpr: job.cron, onFire });
+        },
+        unschedule(jobId) {
+            const entry = timers.get(jobId);
+            if (entry) {
+                entry.task.stop();
+                timers.delete(jobId);
+            }
+            pendingCallbacks.delete(jobId);
+        },
+    };
+}
+/** Write trigger file, call onFire, delete file on success. */
+function fireWithTriggerFile(triggersDir, job, onFire) {
+    // Heartbeat pre-filter: read heartbeat file, skip if empty/missing
+    let prompt = job.prompt;
+    const heartbeatFile = job.metadata?.heartbeatFile;
+    if (heartbeatFile) {
+        try {
+            if (!existsSync(heartbeatFile))
+                return;
+            const contents = readFileSync(heartbeatFile, "utf-8").trim();
+            if (!contents)
+                return;
+            prompt = `${prompt}\n\n---\n\n${contents}`;
+        }
+        catch {
+            return;
+        }
+    }
+    const now = new Date();
+    const trigger = {
+        jobId: job.id,
+        jobName: job.name,
+        target: job.target,
+        prompt,
+        firedAt: now.toISOString(),
+        oneshot: job.oneshot,
+    };
+    const filename = `${now.getTime()}-${job.id}.json`;
+    const filepath = join(triggersDir, filename);
+    writeFileSync(filepath, JSON.stringify(trigger, null, 2) + "\n");
+    // Fire callback, clean up trigger file on success
+    onFire()
+        .then(() => {
+        try {
+            unlinkSync(filepath);
+        }
+        catch { }
+    })
+        .catch(() => {
+        // Trigger file persists for retry on next start
+    });
+}
+/** Drain trigger files that survived a crash. */
+async function drainPendingTriggers(triggersDir, callbacks) {
+    let files;
+    try {
+        files = readdirSync(triggersDir)
+            .filter((f) => f.endsWith(".json"))
+            .sort();
+    }
+    catch {
+        return;
+    }
+    for (const file of files) {
+        const filepath = join(triggersDir, file);
+        try {
+            const raw = readFileSync(filepath, "utf-8");
+            const trigger = JSON.parse(raw);
+            const callback = callbacks.get(trigger.jobId);
+            if (callback) {
+                await callback();
+            }
+            unlinkSync(filepath);
+        }
+        catch {
+            // Skip malformed trigger files
+            try {
+                unlinkSync(filepath);
+            }
+            catch { }
+        }
+    }
+}
+//# sourceMappingURL=node-cron-backend.js.map

package/dist/node-cron-backend.js.map

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

package/dist/schedule-tool.d.ts

@@ -0,0 +1,11 @@
+import type { JobStore } from "./job-store.js";
+export declare function createScheduleTool(store: JobStore): import("@agentick/core/tool").RunnableToolClass<{
+    action: "add" | "list" | "remove" | "enable" | "disable";
+    name?: string | undefined;
+    cron?: string | undefined;
+    target?: string | undefined;
+    prompt?: string | undefined;
+    oneshot?: boolean | undefined;
+    id?: string | undefined;
+}>;
+//# sourceMappingURL=schedule-tool.d.ts.map

package/dist/schedule-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-tool.d.ts","sourceRoot":"","sources":["../src/schedule-tool.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAe/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ;;;;;;;;GAwFjD"}

package/dist/schedule-tool.jsx

@@ -0,0 +1,101 @@
+import React from "react";
+import cron from "node-cron";
+import { createTool, Section } from "@agentick/core";
+import { z } from "zod";
+function formatJob(j) {
+    const flags = [j.oneshot ? "oneshot" : null, !j.enabled ? "disabled" : null].filter(Boolean);
+    const suffix = flags.length > 0 ? ` [${flags.join(", ")}]` : "";
+    return `${j.id}: "${j.name}" (${j.cron}) → ${j.target}${suffix}`;
+}
+export function createScheduleTool(store) {
+    return createTool({
+        name: "schedule",
+        description: "Manage scheduled jobs. 'add' to create a recurring/oneshot job, " +
+            "'list' to see all jobs, 'remove' to delete, 'enable'/'disable' to toggle.",
+        displaySummary: (input) => {
+            if (input.action === "add")
+                return `add: ${input.name ?? "unnamed"}`;
+            if (input.action === "list")
+                return "list";
+            return `${input.action}: ${input.id}`;
+        },
+        input: z.object({
+            action: z.enum(["add", "list", "remove", "enable", "disable"]),
+            name: z.string().optional().describe("Job name (add)"),
+            cron: z.string().optional().describe("Cron expression, e.g. '*/5 * * * *' (add)"),
+            target: z.string().optional().describe("Target session ID, e.g. 'tui', 'telegram' (add)"),
+            prompt: z.string().optional().describe("Prompt sent when job fires (add)"),
+            oneshot: z.boolean().optional().describe("Delete after first fire (add, default false)"),
+            id: z.string().optional().describe("Job ID (remove/enable/disable)"),
+        }),
+        handler: (input) => {
+            switch (input.action) {
+                case "add": {
+                    if (!input.name || !input.cron || !input.prompt) {
+                        return [
+                            { type: "text", text: "Error: 'add' requires name, cron, and prompt." },
+                        ];
+                    }
+                    if (!cron.validate(input.cron)) {
+                        return [
+                            { type: "text", text: `Error: invalid cron expression "${input.cron}".` },
+                        ];
+                    }
+                    const job = store.create({
+                        name: input.name,
+                        cron: input.cron,
+                        target: input.target ?? "tui",
+                        prompt: input.prompt,
+                        oneshot: input.oneshot ?? false,
+                        enabled: true,
+                    });
+                    return [{ type: "text", text: `Created job: ${formatJob(job)}` }];
+                }
+                case "list": {
+                    const jobs = store.list();
+                    if (jobs.length === 0) {
+                        return [{ type: "text", text: "No scheduled jobs." }];
+                    }
+                    return [{ type: "text", text: jobs.map(formatJob).join("\n") }];
+                }
+                case "remove": {
+                    if (!input.id) {
+                        return [{ type: "text", text: "Error: 'remove' requires an id." }];
+                    }
+                    const deleted = store.delete(input.id);
+                    if (!deleted) {
+                        return [{ type: "text", text: `Error: job "${input.id}" not found.` }];
+                    }
+                    return [{ type: "text", text: `Removed job "${input.id}".` }];
+                }
+                case "enable": {
+                    if (!input.id) {
+                        return [{ type: "text", text: "Error: 'enable' requires an id." }];
+                    }
+                    const job = store.update(input.id, { enabled: true });
+                    if (!job) {
+                        return [{ type: "text", text: `Error: job "${input.id}" not found.` }];
+                    }
+                    return [{ type: "text", text: `Enabled job "${input.id}".` }];
+                }
+                case "disable": {
+                    if (!input.id) {
+                        return [{ type: "text", text: "Error: 'disable' requires an id." }];
+                    }
+                    const job = store.update(input.id, { enabled: false });
+                    if (!job) {
+                        return [{ type: "text", text: `Error: job "${input.id}" not found.` }];
+                    }
+                    return [{ type: "text", text: `Disabled job "${input.id}".` }];
+                }
+            }
+        },
+        render: () => {
+            const jobs = store.listEnabled();
+            if (jobs.length === 0)
+                return null;
+            return <Section id="scheduled-jobs">{jobs.map(formatJob).join("\n")}</Section>;
+        },
+    });
+}
+//# sourceMappingURL=schedule-tool.jsx.map

package/dist/schedule-tool.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-tool.jsx","sourceRoot":"","sources":["../src/schedule-tool.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,SAAS,SAAS,CAAC,CAOlB;IACC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAe;IAChD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,kEAAkE;YAClE,2EAA2E;QAC7E,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;YACxB,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;gBAAE,OAAO,QAAQ,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;YACrE,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC3C,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACjF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;YACzF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC1E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACxF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;SACrE,CAAC;QACF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrB,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;wBAChD,OAAO;4BACL,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,+CAA+C,EAAE;yBACjF,CAAC;oBACJ,CAAC;oBACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/B,OAAO;4BACL,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,mCAAmC,KAAK,CAAC,IAAI,IAAI,EAAE;yBACnF,CAAC;oBACJ,CAAC;oBACD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;wBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;wBAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK;wBAC/B,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;oBACH,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7E,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACtB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC;oBACjE,CAAC;oBACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC3E,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;wBACd,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;oBAC9E,CAAC;oBACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACvC,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;oBAClF,CAAC;oBACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;wBACd,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;oBAC9E,CAAC;oBACD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBACtD,IAAI,CAAC,GAAG,EAAE,CAAC;wBACT,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;oBAClF,CAAC;oBACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;wBACd,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kCAAkC,EAAE,CAAC,CAAC;oBAC/E,CAAC;oBACD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;oBACvD,IAAI,CAAC,GAAG,EAAE,CAAC;wBACT,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;oBAClF,CAAC;oBACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACjF,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/trigger-watcher.d.ts

@@ -0,0 +1,20 @@
+import type { AgentickClient } from "@agentick/client";
+import type { CronServiceOptions } from "./types.js";
+import type { JobStore } from "./job-store.js";
+export declare class TriggerWatcher {
+    private watcher;
+    private readonly triggersDir;
+    private readonly client;
+    private readonly store;
+    private readonly defaultTarget;
+    private readonly onProcessed;
+    private readonly onError;
+    private processing;
+    private stopped;
+    constructor(triggersDir: string, client: AgentickClient, store: JobStore, options?: Pick<CronServiceOptions, "defaultTarget" | "onTriggerProcessed" | "onError">);
+    start(): Promise<void>;
+    stop(): void;
+    private _drainPending;
+    private _processFile;
+}
+//# sourceMappingURL=trigger-watcher.d.ts.map

package/dist/trigger-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-watcher.d.ts","sourceRoot":"","sources":["../src/trigger-watcher.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAW,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,OAAO,CAAS;gBAGtB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAWlF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,IAAI,IAAI,IAAI;YAQE,aAAa;YAgBb,YAAY;CAiE3B"}

package/dist/trigger-watcher.js

@@ -0,0 +1,114 @@
+import { watch, readdirSync, readFileSync, unlinkSync, existsSync, mkdirSync, } from "node:fs";
+import { join } from "node:path";
+export class TriggerWatcher {
+    watcher = null;
+    triggersDir;
+    client;
+    store;
+    defaultTarget;
+    onProcessed;
+    onError;
+    processing = new Set();
+    stopped = false;
+    constructor(triggersDir, client, store, options) {
+        this.triggersDir = triggersDir;
+        this.client = client;
+        this.store = store;
+        this.defaultTarget = options?.defaultTarget;
+        this.onProcessed = options?.onTriggerProcessed;
+        this.onError = options?.onError;
+        mkdirSync(triggersDir, { recursive: true });
+    }
+    async start() {
+        this.stopped = false;
+        // Drain any pending triggers from before process started
+        await this._drainPending();
+        // Watch for new triggers
+        this.watcher = watch(this.triggersDir, (eventType, filename) => {
+            if (this.stopped)
+                return;
+            if (eventType === "rename" && filename?.endsWith(".json")) {
+                this._processFile(filename);
+            }
+        });
+    }
+    stop() {
+        this.stopped = true;
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    async _drainPending() {
+        let files;
+        try {
+            files = readdirSync(this.triggersDir)
+                .filter((f) => f.endsWith(".json"))
+                .sort();
+        }
+        catch {
+            return;
+        }
+        for (const file of files) {
+            if (this.stopped)
+                break;
+            await this._processFile(file);
+        }
+    }
+    async _processFile(filename) {
+        // Deduplicate: fs.watch fires multiple events for the same file
+        if (this.processing.has(filename))
+            return;
+        this.processing.add(filename);
+        const filepath = join(this.triggersDir, filename);
+        try {
+            if (!existsSync(filepath))
+                return;
+            const raw = readFileSync(filepath, "utf-8");
+            const trigger = JSON.parse(raw);
+            if (!trigger.target && !this.defaultTarget) {
+                this.onError?.(new Error(`Trigger ${filename} has no target and no default configured`), "processFile");
+                return;
+            }
+            const target = trigger.target || this.defaultTarget;
+            // Send as an event-role message — this is a system event, not a user turn
+            const session = this.client.session(target);
+            const handle = session.send({
+                messages: [
+                    {
+                        role: "event",
+                        content: [{ type: "text", text: trigger.prompt }],
+                        metadata: {
+                            source: { type: "cron" },
+                            event_type: "cron_trigger",
+                            job_id: trigger.jobId,
+                            job_name: trigger.jobName,
+                            fired_at: trigger.firedAt,
+                        },
+                    },
+                ],
+            });
+            // Wait for the model to process — don't delete trigger until delivery confirmed
+            await handle.result;
+            // Delete trigger file after successful delivery
+            try {
+                unlinkSync(filepath);
+            }
+            catch {
+                // Already cleaned up
+            }
+            // If oneshot, delete the job
+            if (trigger.oneshot) {
+                this.store.delete(trigger.jobId);
+            }
+            this.onProcessed?.(trigger);
+        }
+        catch (error) {
+            this.onError?.(error instanceof Error ? error : new Error(String(error)), `processFile:${filename}`);
+        }
+        finally {
+            this.processing.delete(filename);
+        }
+    }
+}
+//# sourceMappingURL=trigger-watcher.js.map

package/dist/trigger-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-watcher.js","sourceRoot":"","sources":["../src/trigger-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAEL,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,MAAM,OAAO,cAAc;IACjB,OAAO,GAAqB,IAAI,CAAC;IACxB,WAAW,CAAS;IACpB,MAAM,CAAiB;IACvB,KAAK,CAAW;IAChB,aAAa,CAAqB;IAClC,WAAW,CAA2C;IACtD,OAAO,CAAwD;IACxE,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,GAAG,KAAK,CAAC;IAExB,YACE,WAAmB,EACnB,MAAsB,EACtB,KAAe,EACf,OAAsF;QAEtF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,kBAAkB,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,yDAAyD;QACzD,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,yBAAyB;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC7D,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO;YACzB,IAAI,SAAS,KAAK,QAAQ,IAAI,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;iBAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;iBAClC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM;YACxB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,QAAgB;QACzC,gEAAgE;QAChE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAElC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YAE3C,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC3C,IAAI,CAAC,OAAO,EAAE,CACZ,IAAI,KAAK,CAAC,WAAW,QAAQ,0CAA0C,CAAC,EACxE,aAAa,CACd,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,aAAc,CAAC;YAErD,0EAA0E;YAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAC1B,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;wBACjD,QAAQ,EAAE;4BACR,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;4BACxB,UAAU,EAAE,cAAc;4BAC1B,MAAM,EAAE,OAAO,CAAC,KAAK;4BACrB,QAAQ,EAAE,OAAO,CAAC,OAAO;4BACzB,QAAQ,EAAE,OAAO,CAAC,OAAO;yBAC1B;qBACF;iBACF;aACF,CAAC,CAAC;YAEH,gFAAgF;YAChF,MAAM,MAAM,CAAC,MAAM,CAAC;YAEpB,gDAAgD;YAChD,IAAI,CAAC;gBACH,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;YAED,6BAA6B;YAC7B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CACZ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD,eAAe,QAAQ,EAAE,CAC1B,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+import type { AgentickClient } from "@agentick/client";
+declare module "@agentick/shared" {
+    interface MessageSourceTypes {
+        cron: {
+            type: "cron";
+        };
+    }
+}
+export interface Job {
+    id: string;
+    name: string;
+    cron: string;
+    target: string;
+    prompt: string;
+    oneshot: boolean;
+    enabled: boolean;
+    createdAt: string;
+    lastFiredAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Trigger {
+    jobId: string;
+    jobName: string;
+    target: string;
+    prompt: string;
+    firedAt: string;
+    oneshot: boolean;
+}
+export interface SchedulerBackend {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    schedule(job: Job, onFire: () => Promise<void>): void;
+    unschedule(jobId: string): void;
+}
+export interface CronServiceOptions {
+    dataDir: string;
+    client: AgentickClient;
+    backend?: SchedulerBackend;
+    watchExternalTriggers?: boolean;
+    defaultTarget?: string;
+    onTriggerProcessed?: (trigger: Trigger) => void;
+    onError?: (error: Error, context: string) => void;
+}
+export interface HeartbeatOptions {
+    cron?: string;
+    target?: string;
+    heartbeatFile?: string;
+}
+export type CreateJobInput = Omit<Job, "id" | "createdAt" | "lastFiredAt"> & {
+    id?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAU,kBAAkB;QAC1B,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KACxB;CACF;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,WAAW,GAAG,aAAa,CAAC,GAAG;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@agentick/scheduler",
+  "version": "0.7.0",
+  "description": "Scheduled jobs, heartbeat, and cron triggers for Agentick agents",
+  "keywords": [
+    "agent",
+    "ai",
+    "cron",
+    "heartbeat",
+    "scheduler"
+  ],
+  "license": "MIT",
+  "author": "Ryan Lindgren",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agenticklabs/agentick.git",
+    "directory": "packages/scheduler"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Tests run from workspace root\"",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/",
+    "clean": "rm -rf dist tsconfig.build.tsbuildinfo",
+    "prepublishOnly": "pnpm build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@agentick/client": "workspace:*",
+    "@agentick/core": "workspace:*",
+    "@agentick/shared": "workspace:*",
+    "node-cron": "^3.0.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node-cron": "^3.0.11",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+export { CronService } from "./cron-service.js";
+export { JobStore } from "./job-store.js";
+export { createNodeCronBackend } from "./node-cron-backend.js";
+export { TriggerWatcher } from "./trigger-watcher.js";
+export { createScheduleTool } from "./schedule-tool.js";
+export { createHeartbeatJob } from "./heartbeat.js";
+export { bindSchedulerStore, getSchedulerStore } from "./bridge.js";
+export type {
+  Job,
+  Trigger,
+  SchedulerBackend,
+  CronServiceOptions,
+  HeartbeatOptions,
+  CreateJobInput,
+} from "./types.js";
+export type { NodeCronBackendOptions } from "./node-cron-backend.js";