@owlmeans/queue 0.1.18-rc.4 → 0.1.18-rc.41

package/agent-meta/skills/scheduled-jobs/SKILL.md

@@ -0,0 +1,151 @@
+---
+name: scheduled-jobs
+description: Recurring background work on OwlMeans queues — declareSchedule in @owlmeans/queue, reconciled into BullMQ job schedulers by @owlmeans/redis-queue when a listening worker starts. Covers interval vs cron schedules, the processor a sweep runs, overlap and restart semantics, renaming and removing a schedule, multi-replica and rolling-deploy behaviour, and testing. Use when adding a nightly or periodic job, replacing a platform CronJob or a setInterval with a schedule, or diagnosing a schedule that does not run.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Scheduled jobs
+
+**Layer:** Infra · **Packages:** `@owlmeans/queue` (lead — the declaration), `@owlmeans/redis-queue`
+(the reconciliation)
+
+A schedule is a declaration that makes the broker produce an ordinary job on an interval or a cron
+pattern. A worker that consumes the queue runs it with a processor. There is no second scheduler
+process, no cron table and no timer in application code.
+
+## When a schedule is the answer
+
+| Situation | Answer |
+|---|---|
+| Periodic sweep, reconciliation, digest, retention delete, rollup | A schedule on a queue a worker consumes |
+| "Remind this user in 20 minutes" | `JobOptions.delay` on one job — a schedule is not per record |
+| A far-future or cancellable per-record deadline | A row with a due date, swept by one schedule |
+| A deployment that runs no worker | A platform `CronJob` calling a guarded entrypoint |
+| A `setInterval` inside a request handler or a long-lived service | A schedule — the interval dies with the process and runs once per replica |
+
+Whether the work belongs on a queue at all is `resource-choice`.
+
+## Declaring
+
+In the SHARED package every process loads, after the queue:
+
+```typescript
+declareQueue(cfg, APP_MAINTENANCE, ['app:maintenance:reconcile', 'app:maintenance:purge'], {
+  worker: { concurrency: 1, lockDuration: 60_000 }
+})
+declareSchedule(cfg, {
+  id: 'app-nightly-reconcile', queue: APP_MAINTENANCE, name: 'app:maintenance:reconcile',
+  pattern: '17 3 * * *', tz: 'UTC', data: {},
+})
+declareSchedule(cfg, {
+  id: 'app-purge-expired', queue: APP_MAINTENANCE, name: 'app:maintenance:purge', every: 15 * 60_000,
+})
+```
+
+And only in the process that runs them: `listenQueues(cfg, APP_MAINTENANCE)` plus a processor per
+job name, registered while the context is wired.
+
+- **`pattern` for the calendar, `every` for a frequency.** A nightly job is a pattern with an
+  explicit `tz`; "every quarter hour, whenever" is `every`. Pick an odd minute (`17 3 * * *`) so
+  many applications' sweeps do not stampede one Redis at the top of the hour.
+- **`every` runs at once** when the scheduler is created (unless `startDate` says otherwise); a
+  pattern waits for its next match unless `immediately: true`, which fires only when the scheduler
+  is created or its declaration changes — never on an unchanged restart.
+- **The id is permanent.** It is the scheduler's identity in the broker: any other field changes in
+  place, a renamed id is a removed schedule plus a new one. Prefix it with the application
+  (`app-…`) — ids share one namespace per queue.
+- **Declaration errors surface at boot.** `declareSchedule` throws `UnknownQueue`,
+  `UnknownJobName` or `ScheduleMisdeclared` (`<id>:<reason>`) rather than letting the broker fail
+  on every tick.
+- **`opts` sets retries and retention for every run; `id` and `delay` are refused** — the broker
+  names each run and places it on the schedule.
+
+## Writing the processor
+
+```typescript
+const log = logger('maintenance') // from '@owlmeans/log'
+
+worker.process<Record<string, never>, SweepReport>(APP_MAINTENANCE, 'app:maintenance:reconcile',
+  async job => {
+    const report = { scanned: 0, repaired: 0, failed: 0 }
+    for await (const page of organizations({ size: 200 })) {
+      await job.touch()
+      for (const organization of page) {
+        try {
+          report.repaired += await reconcile(organization.entityId) ? 1 : 0
+        } catch (error) {
+          report.failed++
+          log.error('Reconcile failed', { entityId: organization.entityId, error })
+        }
+        report.scanned++
+      }
+    }
+    log.info('Maintenance run finished', { scheduled: job.scheduled, ...report }, { event: 'job.stop' })
+    return report
+  })
+```
+
+- **A scheduled run has no caller.** No credentials, no entity, no request: it is a processor job,
+  never a guarded entrypoint. A step that must go through another service's guard calls that
+  service with service credentials.
+- **Idempotent per item, not per run.** A worker rolled out mid-sweep, a stalled lock or a manual
+  re-run repeats the whole sweep; each item's repair must be a no-op the second time.
+- **One item's failure is logged and counted, never thrown.** A thrown sweep is retried from the
+  start, or dropped after its attempts — either way the other items pay for one bad record.
+- **`touch()` per page.** A sweep over every organization outlives `lockDuration` easily; silence
+  hands the job to another worker while this one is still going.
+- **Return a small report.** It lands on the completed job, where an operator reads it.
+
+## Overlap, replicas and deploys
+
+- **One job per tick, whatever the replica count.** The broker produces one job; one worker takes
+  it. Several replicas listening to the queue do not multiply runs.
+- **Runs can overlap on a concurrent queue.** The next run is produced when the previous one
+  starts, so a run that outlasts the interval meets its successor. Put sweeps on their own queue
+  with `concurrency: 1`, apart from interactive lanes.
+- **A schedule needs a consumer.** Only a listening worker creates the scheduler, and the next run
+  is produced only when the previous one starts processing. A queue nothing consumes stops.
+- **Every listener reconciles at start, from its own configuration.** It creates or updates what it
+  declares and removes the schedules it owns (`owlmeans:` scheduler ids) that it does not. Every
+  process listening to one queue must load the same schedule list; during a rolling deploy the
+  newest process to start wins, and the old pods leave the broker alone after their own start.
+- **Removing a schedule is deleting its declaration.** The next worker start removes the scheduler.
+  So is a declaration whose job name the queue no longer accepts, or whose `endDate` has passed.
+- **Scheduling never costs consumption.** A refused declaration or a broker failure while
+  reconciling is logged and skipped; the worker keeps consuming. Look for
+  `redis-queue-schedules:<queue>` in the worker's log when a schedule does not appear.
+
+## Diagnosing "it never ran"
+
+1. Is some process listening to the queue (`listenQueues`) and is its worker up?
+2. Did that process's start log a `redis-queue-schedules:<queue>` refusal?
+3. Does `new Queue(queue, { connection, prefix }).getJobSchedulers()` list `owlmeans:<id>` with the
+   expected `pattern`/`every`, `tz` and `next`?
+4. Is a processor registered for the job name? A run without one fails once as `UnknownJobName`
+   and shows in the failed state.
+5. Is a previous run still active on a `concurrency: 1` queue?
+
+## Testing
+
+- **The declaration** is category A in the application's own shared package: build the config,
+  `queueConfigOf(cfg).assertSchedules()`, and pin ids and job names against the queue declaration.
+- **The processor** is tested as a function over a fake `JobContext` or a real context — it is
+  ordinary code with a `touch`.
+- **Against a broker** (Redis-gated): the worker's Ready-stage start is not awaited by
+  `context.init()`, so poll the broker (`getJobSchedulers`) or wait for the first run instead of
+  asserting straight after boot. A queue's schedulers go with `obliterate()`.
+
+## External docs
+
+- https://docs.bullmq.io/guide/job-schedulers — `upsertJobScheduler(id, { every | pattern, tz,
+  startDate, endDate, limit, immediately }, { name, data, opts })` creates or updates one scheduler
+  per id and replaces its pending run; `getJobSchedulers()` / `removeJobScheduler(id)`. The next job
+  is added when the previous one starts processing, so a worker must be consuming. Produced jobs
+  carry `repeatJobKey` = the scheduler id.
+
+## Related
+
+- `queue` — `declareSchedule`, `JobContext.scheduled`, processor rules
+- `redis-queue` — `syncSchedules`, the `owlmeans:` ownership prefix, the reconciliation rules
+- `resource-choice` — whether recurring work belongs on a queue at all

package/build/bridge/types.d.ts

@@ -0,0 +1,25 @@
+import type { BasicContext } from '@owlmeans/context';
+import type { AbstractRequest } from '@owlmeans/entrypoint';
+import type { JobEnvelope, QueueJobMeta } from '../types.js';
+/** The envelope ↔ request bridge a queued entrypoint call crosses. */
+export interface QueueBridgeHelper {
+    /**
+     * Rebuild the request the producer described. A queued call is still a call: the same guards, the
+     * same filter, the same handler run against it — only the wire is different.
+     */
+    requestOf: (envelope: JobEnvelope, path: string, context?: BasicContext<any>, job?: QueueJobMeta) => AbstractRequest;
+    /** Read broker identity only where an entrypoint truly needs to bind work to an admission claim. */
+    queueJobOf: (request: unknown) => QueueJobMeta | null;
+    /**
+     * Freshness is judged from when the job was ENQUEUED, not from now.
+     *
+     * A signed envelope proves who produced it, and a replay window keeps a captured one from being
+     * useful forever. But a job can legitimately sit behind a long backlog, and judging it on pickup
+     * would reject exactly the work that a busy queue delayed — so the producer's timestamp is what
+     * the window applies to.
+     *
+     * @throws {EnvelopeExpired}
+     */
+    assertFresh: (envelope: JobEnvelope, ttl?: number) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5D,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,KAAK,eAAe,CAAA;IACpH,oGAAoG;IACpG,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,GAAG,IAAI,CAAA;IACrD;;;;;;;;;OASG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3D"}

package/build/bridge/types.js

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

package/build/bridge/types.js.map

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

package/build/bridge.d.ts

@@ -0,0 +1,7 @@
+import type { QueueJobMeta } from './types.js';
+import type { QueueBridgeHelper } from './bridge/types.js';
+export declare const createQueueBridgeHelper: () => QueueBridgeHelper;
+export declare const queueBridgeHelper: QueueBridgeHelper;
+/** @deprecated compat:factory-refactor — use `queueBridgeHelper.queueJobOf(…)` */
+export declare const queueJobOf: (request: unknown) => QueueJobMeta | null;
+//# sourceMappingURL=bridge.d.ts.map

package/build/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAG1D,eAAO,MAAM,uBAAuB,QAAO,iBAkC1C,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAA4B,CAAA;AAE1D,kFAAkF;AAClF,eAAO,MAAM,UAAU,YAAa,OAAO,KAAG,YAAY,GAAG,IAA6C,CAAA"}

package/build/bridge.js

@@ -0,0 +1,37 @@
+import { EnvelopeExpired } from './errors.js';
+export const createQueueBridgeHelper = () => {
+    const requestOf = (envelope, path, context, job) => ({
+        alias: envelope.alias,
+        params: (envelope.params ?? {}),
+        body: envelope.body,
+        headers: (envelope.headers ?? {}),
+        query: (envelope.query ?? {}),
+        path,
+        // Handlers reach their context through `original._ctx`, which the HTTP boundary sets on the raw
+        // Fastify request. There is no raw request here, so the shape is supplied deliberately — a
+        // handler must not have to know which transport delivered it.
+        original: context != null || job != null ? { _ctx: context, _job: job } : undefined,
+    });
+    const queueJobOf = (request) => {
+        if (request == null || typeof request !== 'object' || !('original' in request))
+            return null;
+        const original = request.original;
+        if (original == null || typeof original !== 'object' || !('_job' in original))
+            return null;
+        return original._job ?? null;
+    };
+    const assertFresh = (envelope, ttl) => {
+        if (ttl == null || envelope.enqueuedAt == null) {
+            return;
+        }
+        const age = (Date.now() - new Date(envelope.enqueuedAt).getTime()) / 1000;
+        if (age > ttl) {
+            throw new EnvelopeExpired(`${envelope.alias}: ${Math.round(age)}s > ${ttl}s`);
+        }
+    };
+    return { requestOf, queueJobOf, assertFresh };
+};
+export const queueBridgeHelper = createQueueBridgeHelper();
+/** @deprecated compat:factory-refactor — use `queueBridgeHelper.queueJobOf(…)` */
+export const queueJobOf = (request) => queueBridgeHelper.queueJobOf(request);
+//# sourceMappingURL=bridge.js.map

package/build/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAsB,EAAE;IAC7D,MAAM,SAAS,GAAG,CAChB,QAAqB,EAAE,IAAY,EAAE,OAA2B,EAAE,GAAkB,EACnE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAA8B;QAC5D,IAAI,EAAE,QAAQ,CAAC,IAA+B;QAC9C,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAA+B;QAC/D,KAAK,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAA6B;QACzD,IAAI;QACJ,gGAAgG;QAChG,2FAA2F;QAC3F,8DAA8D;QAC9D,QAAQ,EAAE,OAAO,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;KACpF,CAAC,CAAA;IAEF,MAAM,UAAU,GAAG,CAAC,OAAgB,EAAuB,EAAE;QAC3D,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC;YAAE,OAAO,IAAI,CAAA;QAC3F,MAAM,QAAQ,GAAI,OAAkC,CAAC,QAAQ,CAAA;QAC7D,IAAI,QAAQ,IAAI,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAA;QAC1F,OAAQ,QAAoC,CAAC,IAAI,IAAI,IAAI,CAAA;IAC3D,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAAC,QAAqB,EAAE,GAAY,EAAQ,EAAE;QAChE,IAAI,GAAG,IAAI,IAAI,IAAI,QAAQ,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YAC/C,OAAM;QACR,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;QACzE,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC,CAAA;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,CAAA;AAC/C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,EAAE,CAAA;AAE1D,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAgB,EAAuB,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA"}

package/build/config.d.ts

@@ -0,0 +1,34 @@
+import type { Config, JobOptions, QueueDeclaration, QueueWorkerOptions, ScheduleDeclaration } from './types.js';
+/**
+ * Add a queue to the shared configuration. Every process in the monorepo loads the same
+ * declarations — a producer needs them to know a queue exists and what it accepts, a worker needs
+ * them to bind. Declaring twice replaces, so a helper that runs per app is safe to call.
+ */
+export declare const declareQueue: <C extends Config>(cfg: C, name: string, jobs: string[], opts?: {
+    worker?: QueueWorkerOptions;
+    defaults?: JobOptions;
+}) => C;
+/**
+ * Name the queues this process consumes. It is what turns an otherwise identical binary into a
+ * worker, which is why it lives in the process's own config and never in a declaration.
+ */
+export declare const listenQueues: <C extends Config>(cfg: C, ...names: string[]) => C;
+/**
+ * Add a recurring job to the shared configuration. Declare the queue first — a schedule is checked
+ * against it here. Declaring an id twice replaces, like `declareQueue`.
+ *
+ * Declaring is all this does: the driver creates, updates and removes the broker's schedulers when
+ * a worker that listens to the queue starts.
+ *
+ * @throws {ScheduleMisdeclared} / {UnknownQueue} / {UnknownJobName} — see `assertSchedule`.
+ */
+export declare const declareSchedule: <C extends Config>(cfg: C, schedule: ScheduleDeclaration) => C;
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).queueOfJob(…)` */
+export declare const queueOfJob: <C extends Config>(cfg: C, job: string) => QueueDeclaration | undefined;
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).isListening(…)` */
+export declare const isListening: <C extends Config>(cfg: C, name: string) => boolean;
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).schedulesOf(…)` */
+export declare const schedulesOf: <C extends Config>(cfg: C, queue?: string) => ScheduleDeclaration[];
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).assertSchedules()` */
+export declare const assertSchedules: <C extends Config>(cfg: C) => void;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAC9E,MAAM,YAAY,CAAA;AAGnB;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,OACtC,CAAC,QAAQ,MAAM,QAAQ,MAAM,EAAE,SAAS;IAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,KAClG,CAcF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,OAAO,CAAC,YAAY,MAAM,EAAE,KAAG,CAM3E,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,OAAO,CAAC,YAAY,mBAAmB,KAAG,CAezF,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,OAAO,CAAC,OAAO,MAAM,KAAG,gBAAgB,GAAG,SAClD,CAAA;AAEpC,oFAAoF;AACpF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,OAAO,CAAC,QAAQ,MAAM,KAAG,OAC/B,CAAA;AAEtC,oFAAoF;AACpF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,OAAO,CAAC,UAAU,MAAM,KAAG,mBAAmB,EACnD,CAAA;AAEvC,uFAAuF;AACvF,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,OAAO,CAAC,KAAG,IAA4C,CAAA"}

package/build/config.js

@@ -0,0 +1,59 @@
+import { queueConfigOf } from './queue-config.js';
+/**
+ * Add a queue to the shared configuration. Every process in the monorepo loads the same
+ * declarations — a producer needs them to know a queue exists and what it accepts, a worker needs
+ * them to bind. Declaring twice replaces, so a helper that runs per app is safe to call.
+ */
+export const declareQueue = (cfg, name, jobs, opts) => {
+    const queue = { name, jobs, ...opts };
+    const queues = cfg.queue?.queues ?? [];
+    const existing = queues.findIndex(declared => declared.name === name);
+    if (existing < 0) {
+        queues.push(queue);
+    }
+    else {
+        queues[existing] = queue;
+    }
+    cfg.queue = { ...cfg.queue, queues };
+    return cfg;
+};
+/**
+ * Name the queues this process consumes. It is what turns an otherwise identical binary into a
+ * worker, which is why it lives in the process's own config and never in a declaration.
+ */
+export const listenQueues = (cfg, ...names) => {
+    const listen = new Set([...(cfg.queue?.listen ?? []), ...names]);
+    cfg.queue = { ...cfg.queue, listen: [...listen] };
+    return cfg;
+};
+/**
+ * Add a recurring job to the shared configuration. Declare the queue first — a schedule is checked
+ * against it here. Declaring an id twice replaces, like `declareQueue`.
+ *
+ * Declaring is all this does: the driver creates, updates and removes the broker's schedulers when
+ * a worker that listens to the queue starts.
+ *
+ * @throws {ScheduleMisdeclared} / {UnknownQueue} / {UnknownJobName} — see `assertSchedule`.
+ */
+export const declareSchedule = (cfg, schedule) => {
+    queueConfigOf(cfg).assertSchedule(schedule);
+    const schedules = cfg.queue?.schedules ?? [];
+    const existing = schedules.findIndex(declared => declared.id === schedule.id);
+    if (existing < 0) {
+        schedules.push(schedule);
+    }
+    else {
+        schedules[existing] = schedule;
+    }
+    cfg.queue = { ...cfg.queue, schedules };
+    return cfg;
+};
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).queueOfJob(…)` */
+export const queueOfJob = (cfg, job) => queueConfigOf(cfg).queueOfJob(job);
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).isListening(…)` */
+export const isListening = (cfg, name) => queueConfigOf(cfg).isListening(name);
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).schedulesOf(…)` */
+export const schedulesOf = (cfg, queue) => queueConfigOf(cfg).schedulesOf(queue);
+/** @deprecated compat:factory-refactor — use `queueConfigOf(cfg).assertSchedules()` */
+export const assertSchedules = (cfg) => queueConfigOf(cfg).assertSchedules();
+//# sourceMappingURL=config.js.map

package/build/config.js.map

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

package/build/consts.d.ts

@@ -0,0 +1,33 @@
+export declare const DEFAULT_ALIAS = "queue";
+/**
+ * The state a job is in, as the broker reports it. `Waiting` covers both a job queued normally
+ * and one held by an unfinished parent — the difference matters to the broker, never to a caller
+ * asking whether an answer has arrived.
+ */
+export declare enum JobState {
+    Waiting = "waiting",
+    Delayed = "delayed",
+    Active = "active",
+    Completed = "completed",
+    Failed = "failed",
+    Unknown = "unknown"
+}
+export declare enum JobEventType {
+    Completed = "completed",
+    Failed = "failed",
+    Progress = "progress"
+}
+/**
+ * How long a caller waits for a reply when neither the route nor the request says. Long enough
+ * for work that talks to a model, short enough that a lost job surfaces as an error rather than a
+ * hung request.
+ */
+export declare const DEFAULT_JOB_TIMEOUT = 60000;
+/**
+ * Retries default to one attempt: the jobs here are mostly LLM work, and a blind retry re-spends
+ * the tokens that just failed. A queue whose jobs are cheap and idempotent raises it per queue.
+ */
+export declare const DEFAULT_ATTEMPTS = 1;
+/** The transport identifier owned by the queue package. */
+export declare const QUEUE_PROTOCOL: 'queue';
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,UAAU,CAAA;AAEpC;;;;GAIG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,oBAAY,YAAY;IACtB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAS,CAAA;AAEzC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,2DAA2D;AAC3D,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAA"}

package/build/consts.js

@@ -0,0 +1,35 @@
+export const DEFAULT_ALIAS = 'queue';
+/**
+ * The state a job is in, as the broker reports it. `Waiting` covers both a job queued normally
+ * and one held by an unfinished parent — the difference matters to the broker, never to a caller
+ * asking whether an answer has arrived.
+ */
+export var JobState;
+(function (JobState) {
+    JobState["Waiting"] = "waiting";
+    JobState["Delayed"] = "delayed";
+    JobState["Active"] = "active";
+    JobState["Completed"] = "completed";
+    JobState["Failed"] = "failed";
+    JobState["Unknown"] = "unknown";
+})(JobState || (JobState = {}));
+export var JobEventType;
+(function (JobEventType) {
+    JobEventType["Completed"] = "completed";
+    JobEventType["Failed"] = "failed";
+    JobEventType["Progress"] = "progress";
+})(JobEventType || (JobEventType = {}));
+/**
+ * How long a caller waits for a reply when neither the route nor the request says. Long enough
+ * for work that talks to a model, short enough that a lost job surfaces as an error rather than a
+ * hung request.
+ */
+export const DEFAULT_JOB_TIMEOUT = 60_000;
+/**
+ * Retries default to one attempt: the jobs here are mostly LLM work, and a blind retry re-spends
+ * the tokens that just failed. A queue whose jobs are cheap and idempotent raises it per queue.
+ */
+export const DEFAULT_ATTEMPTS = 1;
+/** The transport identifier owned by the queue package. */
+export const QUEUE_PROTOCOL = 'queue';
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAA;AAEpC;;;;GAIG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,6BAAiB,CAAA;IACjB,+BAAmB,CAAA;AACrB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;IACjB,qCAAqB,CAAA;AACvB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAEjC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,OAAgB,CAAA"}

package/build/entrypoint-jobs/types.d.ts

@@ -0,0 +1,29 @@
+import type { CommonEntrypoint } from '@owlmeans/entrypoint';
+import type { JobContext, JobEnvelope, JobProcessor, JobReply } from '../types.js';
+/** The queued entrypoints one context serves as a worker, and how a job of theirs is run. */
+export interface EntrypointJobsHelper {
+    /**
+     * Every queued entrypoint this process both SERVES and LISTENS to, grouped by queue.
+     *
+     * Both halves are required and they answer different questions. Serving is about code — the alias
+     * was bound here, so a handler exists. Listening is about deployment — this process was
+     * configured to consume that queue. A worker that bound queues by what it can serve would make
+     * every deployment of the same binary a worker for everything it happens to import.
+     */
+    served: () => Map<string, CommonEntrypoint[]>;
+    /**
+     * A processor that runs a queued entrypoint call. The driver dispatches by job name, and an
+     * entrypoint job's name IS its alias — which is what lets one worker carry both entrypoint jobs
+     * and the internal steps an application registers with `process()`.
+     */
+    processor: () => JobProcessor<JobEnvelope, unknown>;
+    /**
+     * Run one queued entrypoint call and describe the outcome.
+     *
+     * It never throws for a DOMAIN failure — the error is marshalled into the returned reply so the
+     * producer can rebuild it as its own class, and so the broker does not count a legitimate refusal
+     * as a job to retry. Infrastructure failures are left to propagate: those are what retries are for.
+     */
+    handle: (job: JobContext<JobEnvelope>) => Promise<JobReply>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/entrypoint-jobs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/entrypoint-jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAElF,6FAA6F;AAC7F,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAA;IAC7C;;;;OAIG;IACH,SAAS,EAAE,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACnD;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC5D"}

package/build/entrypoint-jobs/types.js

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

package/build/entrypoint-jobs/types.js.map

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

package/build/entrypoint-jobs.d.ts

@@ -0,0 +1,5 @@
+import type { Config, Context } from './types.js';
+import type { EntrypointJobsHelper } from './entrypoint-jobs/types.js';
+export declare const makeEntrypointJobsHelper: (context: Context<Config>) => EntrypointJobsHelper;
+export declare const entrypointJobsOf: (target: Context<Config>) => EntrypointJobsHelper;
+//# sourceMappingURL=entrypoint-jobs.d.ts.map

package/build/entrypoint-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint-jobs.d.ts","sourceRoot":"","sources":["../src/entrypoint-jobs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAmD,MAAM,YAAY,CAAA;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAMtE,eAAO,MAAM,wBAAwB,YAAa,OAAO,CAAC,MAAM,CAAC,KAAG,oBAyFnE,CAAA;AAED,eAAO,MAAM,gBAAgB,mDAA+C,CAAA"}

package/build/entrypoint-jobs.js

@@ -0,0 +1,84 @@
+import { AppType, memoHelper } from '@owlmeans/context';
+import { EntrypointOutcome, provideResponse } from '@owlmeans/entrypoint';
+import { AuthorizationError } from '@owlmeans/auth';
+import { ResilientError } from '@owlmeans/error';
+import { JobNotServed } from './errors.js';
+import { queueBridgeHelper } from './bridge.js';
+import { queueRouteHelper } from './queue-route.js';
+import { makeEntityScope } from '@owlmeans/auth-common';
+export const makeEntrypointJobsHelper = (context) => {
+    const served = () => {
+        const listen = context.cfg.queue?.listen ?? [];
+        const served = new Map();
+        context.entrypoints().forEach(entrypoint => {
+            const route = entrypoint.route.route;
+            if (route.type !== AppType.Backend || !queueRouteHelper.isQueueRoute(route)) {
+                return;
+            }
+            if (route.service != null && route.service !== context.cfg.service) {
+                return;
+            }
+            const { queue } = queueRouteHelper.queueRouteOptions(route);
+            if (entrypoint.handle == null || !listen.includes(queue)) {
+                return;
+            }
+            served.set(queue, [...(served.get(queue) ?? []), entrypoint]);
+        });
+        return served;
+    };
+    const handle = async (job) => {
+        const envelope = job.data;
+        try {
+            queueBridgeHelper.assertFresh(envelope, context.cfg.queue?.envelopeTtl);
+            const entrypoint = context.entrypoint(envelope.alias);
+            if (entrypoint.handle == null) {
+                throw new JobNotServed(envelope.alias);
+            }
+            const request = queueBridgeHelper.requestOf(envelope, entrypoint.path(), context, {
+                id: job.id, name: job.name, queue: job.queue, attempt: job.attempt, touch: job.touch,
+            });
+            const response = provideResponse();
+            const guards = entrypoint.getGuards();
+            if (guards.length > 0) {
+                let matched;
+                for (const alias of guards) {
+                    const guard = context.service(alias);
+                    if (await guard.match(request, response)) {
+                        matched = guard;
+                        break;
+                    }
+                }
+                if (matched == null) {
+                    throw new AuthorizationError(`queue:${envelope.alias}`);
+                }
+                const auth = provideResponse();
+                if (!await matched.handle(request, auth)) {
+                    throw new AuthorizationError(`queue:${envelope.alias}:${matched.alias}`);
+                }
+                request.auth = auth.value;
+                const entity = await makeEntityScope(request).attachEntity(context);
+                if (entity != null) {
+                    request.entity = entity;
+                }
+            }
+            await entrypoint.handle(request, response);
+            if (response.error != null) {
+                return { error: ResilientError.marshal(response.error).message };
+            }
+            return { value: response.value, outcome: response.outcome ?? EntrypointOutcome.Ok };
+        }
+        catch (e) {
+            // A refusal the caller must see as its own class — `ContentRefused`, `AgentLocked` — travels
+            // in the reply. Only a broker- or connection-level fault should ever reach the retry logic:
+            // retrying a refusal just spends the work again to be refused identically.
+            if (e instanceof ResilientError) {
+                return { error: ResilientError.marshal(e).message };
+            }
+            throw e;
+        }
+    };
+    const processor = () => async (job) => await handle(job);
+    return { served, processor, handle };
+};
+export const entrypointJobsOf = memoHelper.oncePer(makeEntrypointJobsHelper);
+//# sourceMappingURL=entrypoint-jobs.js.map

package/build/entrypoint-jobs.js.map

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