@keystrokehq/scheduler 0.0.66

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dallin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# @keystrokehq/scheduler
+
+**Layer:** `platform`
+
+Job queue and cron/poll schedule sync for [keystroke](../../README.md). Enqueues workflow, agent, and trigger work; ticks due schedules into the queue. No HTTP, no attachment execution, no trigger source definitions.
+
+## What it does
+
+- **`createScheduler`** — queue backend from `SchedulerPlugin` (default: pg-boss on Postgres, Drizzle job table on SQLite), then expose `enqueue`, `startWorker`, `syncTriggerSchedules`, `startScheduleTicker`, and `fireDueSchedules`.
+- **`SchedulerPlugin`** — swap backends (`defaultSchedulerPlugin()`, or cloud `@cloud/bull-mq-plugin` BullMQ).
+- **`createMemoryJobQueue`** — in-process queue for tests (optional `sync: true` drain).
+- **Job types** — `JobQueue`, `Scheduler`, `JobHandler`, `EnqueueInput`, `JobTrigger`, `StopFn` for server handlers and enqueue helpers.
+- **Schedule sync** — `syncTriggerSchedules` (on `Scheduler`) upserts rows in `trigger_schedules` via `@keystrokehq/database`, resolving cron strings with **`resolveCronSchedule`** and next run times with **`nextTriggerRunAt`** from `@keystrokehq/trigger`.
+- **Schedule ticker** — background loop claims due schedules and enqueues `kind: "trigger"` jobs.
+
+Queue implementations (`database-queue`, `pg-boss-queue`) and standalone `syncTriggerSchedules` / `resolveTriggerSchedule` stay internal unless a consumer needs them in a follow-up.
+
+## What belongs somewhere else
+
+- Trigger source defs (`defineCronSource`, poll cadence) → `@keystrokehq/trigger`
+- Running attachments, webhooks, poll HTTP → `@keystrokehq/server`
+- `trigger_schedules` / `jobs` schema and queries → `@keystrokehq/database`
+- Workflow/agent run logic → `@keystrokehq/workflow` / `@keystrokehq/agent` (server wires handlers)
+
+## Where it sits
+
+```mermaid
+flowchart TB
+  scheduler["@keystrokehq/scheduler"]
+
+  database["@keystrokehq/database"]
+  trigger["@keystrokehq/trigger"]
+
+  scheduler --> database
+  scheduler --> trigger
+```
+
+**Allowed runtime deps:** `database`, `trigger`, `pg-boss`, `cron-schedule` (via trigger).
+
+**Forbidden:** `server`, `workflow`, `agent`, `action`, `config`, `build`, `cli`, integrations, HTTP frameworks. Scheduler must stay callable from server without circular imports.
+
+**Depends on:** `database`, `trigger`, `pg-boss`, `cron-schedule`.
+
+**Used by:** `server` (embedded worker + schedule ticker), re-exports `createScheduler` / `Scheduler` from `@keystrokehq/server` for apps.
+
+## Exports
+
+Import from the package root (`@keystrokehq/scheduler`), not from `src/…`.
+
+| Export                   | What it's for                                             |
+| ------------------------ | --------------------------------------------------------- |
+| `createScheduler`        | Production queue + schedule APIs                          |
+| `SchedulerPlugin`        | Pluggable queue backend contract                          |
+| `defaultSchedulerPlugin` | pg-boss (Postgres) / DB polling (SQLite)                  |
+| `createSharedScheduler`  | Platform shared queue (honors `configureSharedScheduler`) |
+| `createMemoryJobQueue`   | Test / dev in-process queue                               |
+| `Scheduler`              | Full surface (`JobQueue` + schedule sync/ticker)          |
+| `JobQueue`               | Enqueue + worker only (typing server overrides)           |
+| `JobHandler`             | Process one claimed job payload                           |
+| `EnqueueInput`           | Build enqueue calls from server                           |
+| `JobTrigger`             | `"api"` \| `"cron"` \| `"webhook"` \| `"poll"` \| …       |
+| `StopFn`                 | Stop worker or schedule ticker                            |
+| `MemoryJobQueueOptions`  | `{ sync?: boolean }` for memory queue                     |
+
+## Source layout
+
+| File                        | What's in it                                                      |
+| --------------------------- | ----------------------------------------------------------------- |
+| `types.ts`                  | Job + scheduler types, retry backoff helper                       |
+| `create-scheduler.ts`       | `createScheduler`, `createJobQueue`, `wrapJobQueueAsScheduler`    |
+| `database-queue.ts`         | SQLite / generic Postgres job table worker                        |
+| `pg-boss-queue.ts`          | Postgres pg-boss backend                                          |
+| `memory.ts`                 | In-memory `JobQueue`                                              |
+| `sync-trigger-schedules.ts` | DB upsert for discovered cron/poll attachments                    |
+| `resolve-schedule.ts`       | Override-aware cron string (uses trigger's `resolveCronSchedule`) |
+| `schedule-ticker.ts`        | Claim due schedules → enqueue trigger jobs                        |
+
+## Adding a feature?
+
+1. New queue backend or retry/concurrency behavior? → this package (keep types in `types.ts`).
+2. New trigger schedule expression rules? → `@keystrokehq/trigger` (`nextTriggerRunAt`, `resolveCronSchedule`).
+3. New table or claim query? → `@keystrokehq/database`.
+4. Who runs the job (workflow step, agent prompt, attachment)? → `@keystrokehq/server` job handlers.
+
+## Example
+
+```typescript
+import { createScheduler } from "@keystrokehq/scheduler";
+import { initDatabase } from "@keystrokehq/database";
+
+await initDatabase({ url: process.env.DATABASE_URL });
+
+const scheduler = await createScheduler({ url: process.env.DATABASE_URL });
+
+await scheduler.syncTriggerSchedules({
+  schedules: [{ attachmentKey: "daily-report:run", kind: "cron", schedule: "0 9 * * *" }],
+});
+
+const stopWorker = await scheduler.startWorker(async (job) => {
+  console.log(job.kind, job.targetId, job.trigger);
+});
+
+const stopTicker = await scheduler.startScheduleTicker();
+
+// … later
+await stopTicker();
+await stopWorker();
+```
+
+## Tests
+
+```bash
+pnpm --filter @keystrokehq/scheduler test
+pnpm --filter @keystrokehq/scheduler typecheck
+```
+
+Unit: `*.test.ts`. Integration (`queue.int.test.ts`): Postgres pg-boss via `describePostgres`; SQLite DB queue uses in-memory DB.
+
+## See also
+
+- [README.md](../../README.md) — platform layer map
+- [packages/server/src/server.ts](../server/src/server.ts) — wires scheduler at listen
+- [packages/trigger/](../trigger/) — cron parsing and `nextTriggerRunAt`
+- [packages/database/src/scheduler/](../database/src/scheduler/) — jobs + `trigger_schedules` queries

package/dist/contract-C5JvbyQ-.cjs

@@ -0,0 +1,31 @@
+//#region src/types.ts
+const DEFAULT_RETRY_DELAY_MS = 5e3;
+function retryDelayMs(attempt) {
+	return DEFAULT_RETRY_DELAY_MS * 2 ** Math.max(0, attempt - 1);
+}
+//#endregion
+//#region src/contract.ts
+function defineSchedulerPlugin(plugin) {
+	return plugin;
+}
+//#endregion
+Object.defineProperty(exports, "DEFAULT_RETRY_DELAY_MS", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_RETRY_DELAY_MS;
+	}
+});
+Object.defineProperty(exports, "defineSchedulerPlugin", {
+	enumerable: true,
+	get: function() {
+		return defineSchedulerPlugin;
+	}
+});
+Object.defineProperty(exports, "retryDelayMs", {
+	enumerable: true,
+	get: function() {
+		return retryDelayMs;
+	}
+});
+
+//# sourceMappingURL=contract-C5JvbyQ-.cjs.map

package/dist/contract-C5JvbyQ-.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-C5JvbyQ-.cjs","names":[],"sources":["../src/types.ts","../src/contract.ts"],"sourcesContent":["export type JobKind = \"workflow\" | \"agent\" | \"trigger\";\n\nexport type JobTrigger = \"api\" | \"cron\" | \"webhook\" | \"poll\" | \"retry\" | \"prompt\";\n\nexport type JobPayload = {\n  kind: JobKind;\n  targetId: string;\n  runId: string;\n  trigger: JobTrigger;\n  payload: unknown;\n  attempt: number;\n  maxAttempts: number;\n  scheduledAt: Date;\n  jobId: string;\n};\n\nexport type EnqueueInput = {\n  kind: JobKind;\n  targetId: string;\n  runId: string;\n  trigger: JobTrigger;\n  payload?: unknown;\n  scheduledAt?: Date;\n  attempt?: number;\n  maxAttempts?: number;\n};\n\nexport type JobHandler = (job: JobPayload) => Promise<void>;\n\nexport type StopFn = () => Promise<void> | void;\n\nexport type WorkerOptions = {\n  workerId?: string;\n  pollIntervalMs?: number;\n  leaseSweepIntervalMs?: number;\n};\n\nexport type JobQueue = {\n  enqueue(input: EnqueueInput): Promise<string>;\n  startWorker(handler: JobHandler, options?: WorkerOptions): Promise<StopFn>;\n};\n\nimport type { SchedulerPlugin, SchedulerScope } from \"./contract\";\n\nexport type CreateJobQueueOptions = {\n  url?: string;\n  dialect?: \"postgres\" | \"sqlite\";\n  adapter?: JobQueue;\n  plugin?: SchedulerPlugin;\n  scope?: SchedulerScope;\n  projectId?: string;\n  organizationId?: string;\n};\n\nexport type TriggerScheduleSpec = {\n  attachmentKey: string;\n  kind: \"cron\" | \"poll\";\n  schedule: string;\n};\n\nexport type ScheduleSyncOptions = {\n  schedules: TriggerScheduleSpec[];\n  scheduleOverrides?: {\n    global?: string;\n    byAttachment?: Record<string, string>;\n  };\n};\n\nexport type ScheduleTickerOptions = {\n  pollIntervalMs?: number;\n  batchSize?: number;\n};\n\nexport type Scheduler = JobQueue & {\n  syncTriggerSchedules(options: ScheduleSyncOptions): Promise<void>;\n  startScheduleTicker(options?: ScheduleTickerOptions): Promise<StopFn>;\n  fireDueSchedules(asOf?: Date): Promise<number>;\n};\n\nexport type CreateSchedulerOptions = CreateJobQueueOptions;\n\nexport const DEFAULT_RETRY_DELAY_MS = 5_000;\n\nexport function retryDelayMs(attempt: number): number {\n  return DEFAULT_RETRY_DELAY_MS * 2 ** Math.max(0, attempt - 1);\n}\n","export type {\n  JobKind,\n  JobTrigger,\n  JobPayload,\n  EnqueueInput,\n  JobHandler,\n  StopFn,\n  WorkerOptions,\n  JobQueue,\n} from \"./types\";\nexport { retryDelayMs, DEFAULT_RETRY_DELAY_MS } from \"./types\";\n\nimport type { JobQueue } from \"./types\";\n\n/**\n * Inlined to keep the contract database-free — structurally identical to\n * `@keystrokehq/database`'s `DatabaseDialect`. Importing it from the database\n * package would re-introduce the dependency `./contract` exists to avoid.\n */\nexport type DatabaseDialect = \"postgres\" | \"sqlite\";\n\nexport type SchedulerScope = \"platform\" | \"project\";\n\nexport type SchedulerPluginContext = {\n  scope: SchedulerScope;\n  url?: string;\n  dialect?: DatabaseDialect;\n  projectId?: string;\n  organizationId?: string;\n};\n\nexport type SchedulerPlugin = {\n  name: string;\n  createJobQueue(ctx: SchedulerPluginContext): Promise<JobQueue>;\n};\n\nexport function defineSchedulerPlugin(plugin: SchedulerPlugin): SchedulerPlugin {\n  return plugin;\n}\n"],"mappings":";AAiFA,MAAa,yBAAyB;AAEtC,SAAgB,aAAa,SAAyB;CACpD,OAAO,yBAAyB,KAAK,KAAK,IAAI,GAAG,UAAU,CAAC;AAC9D;;;ACjDA,SAAgB,sBAAsB,QAA0C;CAC9E,OAAO;AACT"}

package/dist/contract-CYKkRmnH.d.cts

@@ -0,0 +1,92 @@
+//#region src/types.d.ts
+type JobKind = "workflow" | "agent" | "trigger";
+type JobTrigger = "api" | "cron" | "webhook" | "poll" | "retry" | "prompt";
+type JobPayload = {
+  kind: JobKind;
+  targetId: string;
+  runId: string;
+  trigger: JobTrigger;
+  payload: unknown;
+  attempt: number;
+  maxAttempts: number;
+  scheduledAt: Date;
+  jobId: string;
+};
+type EnqueueInput = {
+  kind: JobKind;
+  targetId: string;
+  runId: string;
+  trigger: JobTrigger;
+  payload?: unknown;
+  scheduledAt?: Date;
+  attempt?: number;
+  maxAttempts?: number;
+};
+type JobHandler = (job: JobPayload) => Promise<void>;
+type StopFn = () => Promise<void> | void;
+type WorkerOptions = {
+  workerId?: string;
+  pollIntervalMs?: number;
+  leaseSweepIntervalMs?: number;
+};
+type JobQueue = {
+  enqueue(input: EnqueueInput): Promise<string>;
+  startWorker(handler: JobHandler, options?: WorkerOptions): Promise<StopFn>;
+};
+type CreateJobQueueOptions = {
+  url?: string;
+  dialect?: "postgres" | "sqlite";
+  adapter?: JobQueue;
+  plugin?: SchedulerPlugin;
+  scope?: SchedulerScope;
+  projectId?: string;
+  organizationId?: string;
+};
+type TriggerScheduleSpec = {
+  attachmentKey: string;
+  kind: "cron" | "poll";
+  schedule: string;
+};
+type ScheduleSyncOptions = {
+  schedules: TriggerScheduleSpec[];
+  scheduleOverrides?: {
+    global?: string;
+    byAttachment?: Record<string, string>;
+  };
+};
+type ScheduleTickerOptions = {
+  pollIntervalMs?: number;
+  batchSize?: number;
+};
+type Scheduler = JobQueue & {
+  syncTriggerSchedules(options: ScheduleSyncOptions): Promise<void>;
+  startScheduleTicker(options?: ScheduleTickerOptions): Promise<StopFn>;
+  fireDueSchedules(asOf?: Date): Promise<number>;
+};
+type CreateSchedulerOptions = CreateJobQueueOptions;
+declare const DEFAULT_RETRY_DELAY_MS = 5000;
+declare function retryDelayMs(attempt: number): number;
+//#endregion
+//#region src/contract.d.ts
+/**
+ * Inlined to keep the contract database-free — structurally identical to
+ * `@keystrokehq/database`'s `DatabaseDialect`. Importing it from the database
+ * package would re-introduce the dependency `./contract` exists to avoid.
+ */
+type DatabaseDialect = "postgres" | "sqlite";
+type SchedulerScope = "platform" | "project";
+type SchedulerPluginContext = {
+  scope: SchedulerScope;
+  url?: string;
+  dialect?: DatabaseDialect;
+  projectId?: string;
+  organizationId?: string;
+};
+type SchedulerPlugin = {
+  name: string;
+  createJobQueue(ctx: SchedulerPluginContext): Promise<JobQueue>;
+};
+declare function defineSchedulerPlugin(plugin: SchedulerPlugin): SchedulerPlugin;
+//#endregion
+export { Scheduler as _, defineSchedulerPlugin as a, retryDelayMs as b, DEFAULT_RETRY_DELAY_MS as c, JobKind as d, JobPayload as f, ScheduleTickerOptions as g, ScheduleSyncOptions as h, SchedulerScope as i, EnqueueInput as l, JobTrigger as m, SchedulerPlugin as n, CreateJobQueueOptions as o, JobQueue as p, SchedulerPluginContext as r, CreateSchedulerOptions as s, DatabaseDialect as t, JobHandler as u, StopFn as v, WorkerOptions as y };
+//# sourceMappingURL=contract-CYKkRmnH.d.cts.map

package/dist/contract-CYKkRmnH.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-CYKkRmnH.d.cts","names":[],"sources":["../src/types.ts","../src/contract.ts"],"mappings":";KAAY,OAAA;AAAA,KAEA,UAAA;AAAA,KAEA,UAAA;EACV,IAAA,EAAM,OAAA;EACN,QAAA;EACA,KAAA;EACA,OAAA,EAAS,UAAA;EACT,OAAA;EACA,OAAA;EACA,WAAA;EACA,WAAA,EAAa,IAAA;EACb,KAAA;AAAA;AAAA,KAGU,YAAA;EACV,IAAA,EAAM,OAAA;EACN,QAAA;EACA,KAAA;EACA,OAAA,EAAS,UAAA;EACT,OAAA;EACA,WAAA,GAAc,IAAA;EACd,OAAA;EACA,WAAA;AAAA;AAAA,KAGU,UAAA,IAAc,GAAA,EAAK,UAAA,KAAe,OAAO;AAAA,KAEzC,MAAA,SAAe,OAAO;AAAA,KAEtB,aAAA;EACV,QAAA;EACA,cAAA;EACA,oBAAA;AAAA;AAAA,KAGU,QAAA;EACV,OAAA,CAAQ,KAAA,EAAO,YAAA,GAAe,OAAA;EAC9B,WAAA,CAAY,OAAA,EAAS,UAAA,EAAY,OAAA,GAAU,aAAA,GAAgB,OAAA,CAAQ,MAAA;AAAA;AAAA,KAKzD,qBAAA;EACV,GAAA;EACA,OAAA;EACA,OAAA,GAAU,QAAA;EACV,MAAA,GAAS,eAAA;EACT,KAAA,GAAQ,cAAA;EACR,SAAA;EACA,cAAA;AAAA;AAAA,KAGU,mBAAA;EACV,aAAA;EACA,IAAA;EACA,QAAA;AAAA;AAAA,KAGU,mBAAA;EACV,SAAA,EAAW,mBAAA;EACX,iBAAA;IACE,MAAA;IACA,YAAA,GAAe,MAAM;EAAA;AAAA;AAAA,KAIb,qBAAA;EACV,cAAA;EACA,SAAS;AAAA;AAAA,KAGC,SAAA,GAAY,QAAA;EACtB,oBAAA,CAAqB,OAAA,EAAS,mBAAA,GAAsB,OAAA;EACpD,mBAAA,CAAoB,OAAA,GAAU,qBAAA,GAAwB,OAAA,CAAQ,MAAA;EAC9D,gBAAA,CAAiB,IAAA,GAAO,IAAA,GAAO,OAAA;AAAA;AAAA,KAGrB,sBAAA,GAAyB,qBAAqB;AAAA,cAE7C,sBAAA;AAAA,iBAEG,YAAA,CAAa,OAAe;;;;;AAnFzB;AAEnB;;KCiBY,eAAA;AAAA,KAEA,cAAA;AAAA,KAEA,sBAAA;EACV,KAAA,EAAO,cAAA;EACP,GAAA;EACA,OAAA,GAAU,eAAe;EACzB,SAAA;EACA,cAAA;AAAA;AAAA,KAGU,eAAA;EACV,IAAA;EACA,cAAA,CAAe,GAAA,EAAK,sBAAA,GAAyB,OAAA,CAAQ,QAAA;AAAA;AAAA,iBAGvC,qBAAA,CAAsB,MAAA,EAAQ,eAAA,GAAkB,eAAe"}

package/dist/contract-CYKkRmnH.d.mts

@@ -0,0 +1,92 @@
+//#region src/types.d.ts
+type JobKind = "workflow" | "agent" | "trigger";
+type JobTrigger = "api" | "cron" | "webhook" | "poll" | "retry" | "prompt";
+type JobPayload = {
+  kind: JobKind;
+  targetId: string;
+  runId: string;
+  trigger: JobTrigger;
+  payload: unknown;
+  attempt: number;
+  maxAttempts: number;
+  scheduledAt: Date;
+  jobId: string;
+};
+type EnqueueInput = {
+  kind: JobKind;
+  targetId: string;
+  runId: string;
+  trigger: JobTrigger;
+  payload?: unknown;
+  scheduledAt?: Date;
+  attempt?: number;
+  maxAttempts?: number;
+};
+type JobHandler = (job: JobPayload) => Promise<void>;
+type StopFn = () => Promise<void> | void;
+type WorkerOptions = {
+  workerId?: string;
+  pollIntervalMs?: number;
+  leaseSweepIntervalMs?: number;
+};
+type JobQueue = {
+  enqueue(input: EnqueueInput): Promise<string>;
+  startWorker(handler: JobHandler, options?: WorkerOptions): Promise<StopFn>;
+};
+type CreateJobQueueOptions = {
+  url?: string;
+  dialect?: "postgres" | "sqlite";
+  adapter?: JobQueue;
+  plugin?: SchedulerPlugin;
+  scope?: SchedulerScope;
+  projectId?: string;
+  organizationId?: string;
+};
+type TriggerScheduleSpec = {
+  attachmentKey: string;
+  kind: "cron" | "poll";
+  schedule: string;
+};
+type ScheduleSyncOptions = {
+  schedules: TriggerScheduleSpec[];
+  scheduleOverrides?: {
+    global?: string;
+    byAttachment?: Record<string, string>;
+  };
+};
+type ScheduleTickerOptions = {
+  pollIntervalMs?: number;
+  batchSize?: number;
+};
+type Scheduler = JobQueue & {
+  syncTriggerSchedules(options: ScheduleSyncOptions): Promise<void>;
+  startScheduleTicker(options?: ScheduleTickerOptions): Promise<StopFn>;
+  fireDueSchedules(asOf?: Date): Promise<number>;
+};
+type CreateSchedulerOptions = CreateJobQueueOptions;
+declare const DEFAULT_RETRY_DELAY_MS = 5000;
+declare function retryDelayMs(attempt: number): number;
+//#endregion
+//#region src/contract.d.ts
+/**
+ * Inlined to keep the contract database-free — structurally identical to
+ * `@keystrokehq/database`'s `DatabaseDialect`. Importing it from the database
+ * package would re-introduce the dependency `./contract` exists to avoid.
+ */
+type DatabaseDialect = "postgres" | "sqlite";
+type SchedulerScope = "platform" | "project";
+type SchedulerPluginContext = {
+  scope: SchedulerScope;
+  url?: string;
+  dialect?: DatabaseDialect;
+  projectId?: string;
+  organizationId?: string;
+};
+type SchedulerPlugin = {
+  name: string;
+  createJobQueue(ctx: SchedulerPluginContext): Promise<JobQueue>;
+};
+declare function defineSchedulerPlugin(plugin: SchedulerPlugin): SchedulerPlugin;
+//#endregion
+export { Scheduler as _, defineSchedulerPlugin as a, retryDelayMs as b, DEFAULT_RETRY_DELAY_MS as c, JobKind as d, JobPayload as f, ScheduleTickerOptions as g, ScheduleSyncOptions as h, SchedulerScope as i, EnqueueInput as l, JobTrigger as m, SchedulerPlugin as n, CreateJobQueueOptions as o, JobQueue as p, SchedulerPluginContext as r, CreateSchedulerOptions as s, DatabaseDialect as t, JobHandler as u, StopFn as v, WorkerOptions as y };
+//# sourceMappingURL=contract-CYKkRmnH.d.mts.map

package/dist/contract-CYKkRmnH.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-CYKkRmnH.d.mts","names":[],"sources":["../src/types.ts","../src/contract.ts"],"mappings":";KAAY,OAAA;AAAA,KAEA,UAAA;AAAA,KAEA,UAAA;EACV,IAAA,EAAM,OAAA;EACN,QAAA;EACA,KAAA;EACA,OAAA,EAAS,UAAA;EACT,OAAA;EACA,OAAA;EACA,WAAA;EACA,WAAA,EAAa,IAAA;EACb,KAAA;AAAA;AAAA,KAGU,YAAA;EACV,IAAA,EAAM,OAAA;EACN,QAAA;EACA,KAAA;EACA,OAAA,EAAS,UAAA;EACT,OAAA;EACA,WAAA,GAAc,IAAA;EACd,OAAA;EACA,WAAA;AAAA;AAAA,KAGU,UAAA,IAAc,GAAA,EAAK,UAAA,KAAe,OAAO;AAAA,KAEzC,MAAA,SAAe,OAAO;AAAA,KAEtB,aAAA;EACV,QAAA;EACA,cAAA;EACA,oBAAA;AAAA;AAAA,KAGU,QAAA;EACV,OAAA,CAAQ,KAAA,EAAO,YAAA,GAAe,OAAA;EAC9B,WAAA,CAAY,OAAA,EAAS,UAAA,EAAY,OAAA,GAAU,aAAA,GAAgB,OAAA,CAAQ,MAAA;AAAA;AAAA,KAKzD,qBAAA;EACV,GAAA;EACA,OAAA;EACA,OAAA,GAAU,QAAA;EACV,MAAA,GAAS,eAAA;EACT,KAAA,GAAQ,cAAA;EACR,SAAA;EACA,cAAA;AAAA;AAAA,KAGU,mBAAA;EACV,aAAA;EACA,IAAA;EACA,QAAA;AAAA;AAAA,KAGU,mBAAA;EACV,SAAA,EAAW,mBAAA;EACX,iBAAA;IACE,MAAA;IACA,YAAA,GAAe,MAAM;EAAA;AAAA;AAAA,KAIb,qBAAA;EACV,cAAA;EACA,SAAS;AAAA;AAAA,KAGC,SAAA,GAAY,QAAA;EACtB,oBAAA,CAAqB,OAAA,EAAS,mBAAA,GAAsB,OAAA;EACpD,mBAAA,CAAoB,OAAA,GAAU,qBAAA,GAAwB,OAAA,CAAQ,MAAA;EAC9D,gBAAA,CAAiB,IAAA,GAAO,IAAA,GAAO,OAAA;AAAA;AAAA,KAGrB,sBAAA,GAAyB,qBAAqB;AAAA,cAE7C,sBAAA;AAAA,iBAEG,YAAA,CAAa,OAAe;;;;;AAnFzB;AAEnB;;KCiBY,eAAA;AAAA,KAEA,cAAA;AAAA,KAEA,sBAAA;EACV,KAAA,EAAO,cAAA;EACP,GAAA;EACA,OAAA,GAAU,eAAe;EACzB,SAAA;EACA,cAAA;AAAA;AAAA,KAGU,eAAA;EACV,IAAA;EACA,cAAA,CAAe,GAAA,EAAK,sBAAA,GAAyB,OAAA,CAAQ,QAAA;AAAA;AAAA,iBAGvC,qBAAA,CAAsB,MAAA,EAAQ,eAAA,GAAkB,eAAe"}

package/dist/contract-E1QJBH6_.mjs

@@ -0,0 +1,14 @@
+//#region src/types.ts
+const DEFAULT_RETRY_DELAY_MS = 5e3;
+function retryDelayMs(attempt) {
+	return DEFAULT_RETRY_DELAY_MS * 2 ** Math.max(0, attempt - 1);
+}
+//#endregion
+//#region src/contract.ts
+function defineSchedulerPlugin(plugin) {
+	return plugin;
+}
+//#endregion
+export { DEFAULT_RETRY_DELAY_MS as n, retryDelayMs as r, defineSchedulerPlugin as t };
+
+//# sourceMappingURL=contract-E1QJBH6_.mjs.map

package/dist/contract-E1QJBH6_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-E1QJBH6_.mjs","names":[],"sources":["../src/types.ts","../src/contract.ts"],"sourcesContent":["export type JobKind = \"workflow\" | \"agent\" | \"trigger\";\n\nexport type JobTrigger = \"api\" | \"cron\" | \"webhook\" | \"poll\" | \"retry\" | \"prompt\";\n\nexport type JobPayload = {\n  kind: JobKind;\n  targetId: string;\n  runId: string;\n  trigger: JobTrigger;\n  payload: unknown;\n  attempt: number;\n  maxAttempts: number;\n  scheduledAt: Date;\n  jobId: string;\n};\n\nexport type EnqueueInput = {\n  kind: JobKind;\n  targetId: string;\n  runId: string;\n  trigger: JobTrigger;\n  payload?: unknown;\n  scheduledAt?: Date;\n  attempt?: number;\n  maxAttempts?: number;\n};\n\nexport type JobHandler = (job: JobPayload) => Promise<void>;\n\nexport type StopFn = () => Promise<void> | void;\n\nexport type WorkerOptions = {\n  workerId?: string;\n  pollIntervalMs?: number;\n  leaseSweepIntervalMs?: number;\n};\n\nexport type JobQueue = {\n  enqueue(input: EnqueueInput): Promise<string>;\n  startWorker(handler: JobHandler, options?: WorkerOptions): Promise<StopFn>;\n};\n\nimport type { SchedulerPlugin, SchedulerScope } from \"./contract\";\n\nexport type CreateJobQueueOptions = {\n  url?: string;\n  dialect?: \"postgres\" | \"sqlite\";\n  adapter?: JobQueue;\n  plugin?: SchedulerPlugin;\n  scope?: SchedulerScope;\n  projectId?: string;\n  organizationId?: string;\n};\n\nexport type TriggerScheduleSpec = {\n  attachmentKey: string;\n  kind: \"cron\" | \"poll\";\n  schedule: string;\n};\n\nexport type ScheduleSyncOptions = {\n  schedules: TriggerScheduleSpec[];\n  scheduleOverrides?: {\n    global?: string;\n    byAttachment?: Record<string, string>;\n  };\n};\n\nexport type ScheduleTickerOptions = {\n  pollIntervalMs?: number;\n  batchSize?: number;\n};\n\nexport type Scheduler = JobQueue & {\n  syncTriggerSchedules(options: ScheduleSyncOptions): Promise<void>;\n  startScheduleTicker(options?: ScheduleTickerOptions): Promise<StopFn>;\n  fireDueSchedules(asOf?: Date): Promise<number>;\n};\n\nexport type CreateSchedulerOptions = CreateJobQueueOptions;\n\nexport const DEFAULT_RETRY_DELAY_MS = 5_000;\n\nexport function retryDelayMs(attempt: number): number {\n  return DEFAULT_RETRY_DELAY_MS * 2 ** Math.max(0, attempt - 1);\n}\n","export type {\n  JobKind,\n  JobTrigger,\n  JobPayload,\n  EnqueueInput,\n  JobHandler,\n  StopFn,\n  WorkerOptions,\n  JobQueue,\n} from \"./types\";\nexport { retryDelayMs, DEFAULT_RETRY_DELAY_MS } from \"./types\";\n\nimport type { JobQueue } from \"./types\";\n\n/**\n * Inlined to keep the contract database-free — structurally identical to\n * `@keystrokehq/database`'s `DatabaseDialect`. Importing it from the database\n * package would re-introduce the dependency `./contract` exists to avoid.\n */\nexport type DatabaseDialect = \"postgres\" | \"sqlite\";\n\nexport type SchedulerScope = \"platform\" | \"project\";\n\nexport type SchedulerPluginContext = {\n  scope: SchedulerScope;\n  url?: string;\n  dialect?: DatabaseDialect;\n  projectId?: string;\n  organizationId?: string;\n};\n\nexport type SchedulerPlugin = {\n  name: string;\n  createJobQueue(ctx: SchedulerPluginContext): Promise<JobQueue>;\n};\n\nexport function defineSchedulerPlugin(plugin: SchedulerPlugin): SchedulerPlugin {\n  return plugin;\n}\n"],"mappings":";AAiFA,MAAa,yBAAyB;AAEtC,SAAgB,aAAa,SAAyB;CACpD,OAAO,yBAAyB,KAAK,KAAK,IAAI,GAAG,UAAU,CAAC;AAC9D;;;ACjDA,SAAgB,sBAAsB,QAA0C;CAC9E,OAAO;AACT"}

package/dist/contract.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_contract = require("./contract-C5JvbyQ-.cjs");
+exports.DEFAULT_RETRY_DELAY_MS = require_contract.DEFAULT_RETRY_DELAY_MS;
+exports.defineSchedulerPlugin = require_contract.defineSchedulerPlugin;
+exports.retryDelayMs = require_contract.retryDelayMs;

package/dist/contract.d.cts

@@ -0,0 +1,2 @@
+import { a as defineSchedulerPlugin, b as retryDelayMs, c as DEFAULT_RETRY_DELAY_MS, d as JobKind, f as JobPayload, i as SchedulerScope, l as EnqueueInput, m as JobTrigger, n as SchedulerPlugin, p as JobQueue, r as SchedulerPluginContext, t as DatabaseDialect, u as JobHandler, v as StopFn, y as WorkerOptions } from "./contract-CYKkRmnH.cjs";
+export { DEFAULT_RETRY_DELAY_MS, DatabaseDialect, type EnqueueInput, type JobHandler, type JobKind, type JobPayload, type JobQueue, type JobTrigger, SchedulerPlugin, SchedulerPluginContext, SchedulerScope, type StopFn, type WorkerOptions, defineSchedulerPlugin, retryDelayMs };

package/dist/contract.d.mts

@@ -0,0 +1,2 @@
+import { a as defineSchedulerPlugin, b as retryDelayMs, c as DEFAULT_RETRY_DELAY_MS, d as JobKind, f as JobPayload, i as SchedulerScope, l as EnqueueInput, m as JobTrigger, n as SchedulerPlugin, p as JobQueue, r as SchedulerPluginContext, t as DatabaseDialect, u as JobHandler, v as StopFn, y as WorkerOptions } from "./contract-CYKkRmnH.mjs";
+export { DEFAULT_RETRY_DELAY_MS, DatabaseDialect, type EnqueueInput, type JobHandler, type JobKind, type JobPayload, type JobQueue, type JobTrigger, SchedulerPlugin, SchedulerPluginContext, SchedulerScope, type StopFn, type WorkerOptions, defineSchedulerPlugin, retryDelayMs };

package/dist/contract.mjs

@@ -0,0 +1,2 @@
+import { n as DEFAULT_RETRY_DELAY_MS, r as retryDelayMs, t as defineSchedulerPlugin } from "./contract-E1QJBH6_.mjs";
+export { DEFAULT_RETRY_DELAY_MS, defineSchedulerPlugin, retryDelayMs };