@jini-ai/daemon 0.2.1 → 0.3.0

package/dist/image-prompt-delivery.js

@@ -0,0 +1,104 @@
+/**
+ * @module image-prompt-delivery
+ *
+ * The `'prompt-path'` half of `RuntimeAgentDef.imageDelivery`
+ * (`@jini-ai/agent-runtime`'s `types.ts` — see that field's own doc for the
+ * full three-mode contract and why `'native'` defs must never also go
+ * through here). A def declares `imageDelivery: 'prompt-path'` when its CLI
+ * has no dedicated image-attachment mechanism but CAN read a local file once
+ * its path is named in the prompt text — confirmed for Claude Code by a live
+ * probe (see `defs/claude.ts`'s module doc): piping a prompt naming
+ * `/tmp/probe-image.png` into a real `claude -p` produced an accurate
+ * description of the image, but only once that path's directory was on the
+ * CLI's allowed-directory list.
+ *
+ * `applyImagePromptDelivery` is the ONE function `agent-executor.ts#run`
+ * calls, once, before `buildArgs`/`preparePromptFileForAgent`/
+ * `writePromptToStdin` ever see the prompt or `extraAllowedDirs` — see that
+ * module's own call site for why every downstream consumer of "the prompt"
+ * and "the allowed dirs" was switched to this function's output rather than
+ * the raw `input.prompt`/`input.extraAllowedDirs`. Adopting this mechanism
+ * for another def is exactly one line: add `imageDelivery: 'prompt-path'` to
+ * that def's literal. No other file needs to change.
+ *
+ * **Zero images is a strict no-op.** Every function below returns its inputs
+ * completely unchanged (not merely "equivalent" — literally the same
+ * `prompt` string and the same `extraAllowedDirs` reference/value) when
+ * `imagePaths` is empty, so a run with no attachments is byte-identical to
+ * this module never having been added. See
+ * `__tests__/image-prompt-delivery.test.ts`'s "byte-identical" case for the
+ * exact-equality regression proof.
+ */
+import path from 'node:path';
+/**
+ * Appends an attachments section to `prompt`, naming each image as a real
+ * file the user provided rather than dumping bare paths — legible to a
+ * model, which needs to understand these are attachments to read and act on,
+ * not incidental text. `imagePaths` must already be non-empty; callers (just
+ * `applyImagePromptDelivery` below) are expected to have filtered/checked
+ * that themselves so this function's own contract stays a straightforward
+ * "always augment" rather than duplicating the empty-check in two places.
+ *
+ * @param prompt - The user's original prompt text, unmodified up to this point.
+ * @param imagePaths - One or more absolute image file paths, already filtered non-empty.
+ * @returns `prompt` with an attachments section appended.
+ * @complexity O(n) in the number of images — one line rendered per path, no I/O.
+ * @overallScore 100
+ */
+export function augmentPromptWithImageAttachments(prompt, imagePaths) {
+    const list = imagePaths.map((imagePath, index) => `${index + 1}. ${imagePath}`).join('\n');
+    const plural = imagePaths.length === 1;
+    return (`${prompt}\n\n---\n` +
+        `The user attached the following image ${plural ? 'file' : 'files'} to this message. ` +
+        `${plural ? 'It is a' : 'These are'} real file${plural ? '' : 's'} on disk — read ${plural ? 'it' : 'each one'} directly ` +
+        `(e.g. with your file-reading tool) before responding:\n${list}`);
+}
+/**
+ * Directories a 'prompt-path' def's CLI must be allowed to read from so it
+ * can actually open the files the augmented prompt just told it about — the
+ * second half of the live-probe finding in `defs/claude.ts`'s module doc
+ * (the CLI refused the same path until its directory was allow-listed).
+ * Deduplicated, and order-stable (`Set` preserves insertion order) so a
+ * snapshot/equality test against the merged list is deterministic.
+ *
+ * @param imagePaths - One or more absolute image file paths, already filtered non-empty.
+ * @returns Each path's containing directory (`node:path#dirname`), deduplicated.
+ * @complexity O(n) in the number of images.
+ * @overallScore 100
+ */
+export function deriveImageAllowedDirs(imagePaths) {
+    return [...new Set(imagePaths.map((imagePath) => path.dirname(imagePath)))];
+}
+/**
+ * Applies `'prompt-path'` image delivery when — and only when — `def`
+ * declares it and `imagePaths` is non-empty. Every other combination
+ * (`'native'`, `'unsupported'`, `undefined` delivery, or zero images on any
+ * def) returns `{ prompt, extraAllowedDirs }` completely unchanged, which is
+ * what keeps 'native' defs (ACP, pi-rpc, qoder) provably unaffected — this
+ * function is the single place that decides whether augmentation happens at
+ * all, so a 'native' def's `imageDelivery` value alone is what protects it
+ * from double delivery, not a second check duplicated at each call site.
+ *
+ * @param imageDelivery - `def.imageDelivery` — the def's own declared mode; pass this field directly rather than the whole def so this module has no dependency on `RuntimeAgentDef` beyond the one field's type.
+ * @param prompt - The user's original prompt text.
+ * @param imagePaths - The run's raw image paths, exactly as the caller received them (may be undefined/empty/contain blanks — this function does the filtering).
+ * @param extraAllowedDirs - The run's caller-supplied allowed directories, exactly as received.
+ * @returns The prompt and allowed-dirs to actually use for this run's `buildArgs`/prompt-delivery calls.
+ * @complexity O(n) in the number of images; O(1) when delivery is not `'prompt-path'` or there are no images.
+ * @overallScore 100
+ */
+export function applyImagePromptDelivery(imageDelivery, prompt, imagePaths, extraAllowedDirs) {
+    if (imageDelivery !== 'prompt-path')
+        return { prompt, extraAllowedDirs };
+    const paths = (imagePaths ?? []).filter((p) => typeof p === 'string' && p.length > 0);
+    if (paths.length === 0)
+        return { prompt, extraAllowedDirs };
+    const mergedDirs = new Set(extraAllowedDirs ?? []);
+    for (const dir of deriveImageAllowedDirs(paths))
+        mergedDirs.add(dir);
+    return {
+        prompt: augmentPromptWithImageAttachments(prompt, paths),
+        extraAllowedDirs: [...mergedDirs],
+    };
+}
+//# sourceMappingURL=image-prompt-delivery.js.map

package/dist/image-prompt-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-prompt-delivery.js","sourceRoot":"","sources":["../src/image-prompt-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAc,EAAE,UAA6B;IAC7F,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;IACvC,OAAO,CACL,GAAG,MAAM,WAAW;QACpB,yCAAyC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,oBAAoB;QACtF,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,aAAa,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mBAAmB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,YAAY;QAC1H,0DAA0D,IAAI,EAAE,CACjE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA6B;IAClE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAA+C,EAC/C,MAAc,EACd,UAAyC,EACzC,gBAA+C;IAE/C,IAAI,aAAa,KAAK,aAAa;QAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAEzE,MAAM,KAAK,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE5D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,sBAAsB,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAErE,OAAO;QACL,MAAM,EAAE,iCAAiC,CAAC,MAAM,EAAE,KAAK,CAAC;QACxD,gBAAgB,EAAE,CAAC,GAAG,UAAU,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -17,7 +17,7 @@
  *
  * `terminal-session.ts` (2026-07-21) adds the interactive-terminal session manager: a
  * `node-pty`-backed `PtySpawn` wired into `@jini-ai/platform`'s generic `TerminalService`, plus
- * session-ownership gating and the kill/write/resize lock `@jini-ai/http`'s `terminals.ts` route
+ * session-ownership gating and the kill/write/resize lock `@jini-ai/http-kit`'s `terminals.ts` route
  * pack calls into. This is this workspace's first native-compiled-addon dependency — see this
  * package's `package.json` and `source-map.md`'s dated section.
  */
@@ -26,6 +26,7 @@ export * from './close-status.js';
 export * from './run-lifecycle.js';
 export * from './tool-executor.js';
 export * from './delegated-tool-bridge.js';
+export * from './remote-tool-bridge.js';
 export * from './frontend-session-registry.js';
 export * from './frontend-capability-tools.js';
 export * from './agent-executor.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -17,7 +17,7 @@
  *
  * `terminal-session.ts` (2026-07-21) adds the interactive-terminal session manager: a
  * `node-pty`-backed `PtySpawn` wired into `@jini-ai/platform`'s generic `TerminalService`, plus
- * session-ownership gating and the kill/write/resize lock `@jini-ai/http`'s `terminals.ts` route
+ * session-ownership gating and the kill/write/resize lock `@jini-ai/http-kit`'s `terminals.ts` route
  * pack calls into. This is this workspace's first native-compiled-addon dependency — see this
  * package's `package.json` and `source-map.md`'s dated section.
  */
@@ -26,6 +26,7 @@ export * from './close-status.js';
 export * from './run-lifecycle.js';
 export * from './tool-executor.js';
 export * from './delegated-tool-bridge.js';
+export * from './remote-tool-bridge.js';
 export * from './frontend-session-registry.js';
 export * from './frontend-capability-tools.js';
 export * from './agent-executor.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/remote-tool-bridge.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `RemoteToolEventRecorder` — lets a tool call that executed in a DIFFERENT process from the one
+ * holding this run's `RunLifecycle` still record its `tool_use`/`tool_result` events into that
+ * run's own event log, so the run's SSE subscribers (a chat UI, a reattaching client) see it the
+ * same way they see a locally-executed delegated tool call.
+ *
+ * This exists because `DelegatedToolBridge.execute()` (this package's `delegated-tool-bridge.ts`)
+ * calls `lifecycle.emit()` directly, in-process — there was previously no way for a caller that
+ * executed a tool somewhere else to report the outcome back into this run's log. That absence is
+ * what forced `ToolExecutor`/`ToolRegistry`/`RunLifecycle` to all live in one process per run (see
+ * this repo's own `tovu-learnings.md` §1a). This module is the missing half: the same two event
+ * shapes `DelegatedToolBridge.execute()` already emits (`tool_use` then `tool_result`), exposed as
+ * a small, explicit recording API a *transport* (this package does not itself expose one — see
+ * `@jini-ai/http-kit`'s `remote-run-events.ts`) can wrap with authentication and call remotely.
+ *
+ * This does not change how tool execution is authorized. A caller of `recordToolUse`/
+ * `recordToolResult` has, by definition, already run the tool through its OWN `ToolExecutor` (with
+ * its own `ToolPolicy` gate) before calling this — this module only records that the run's chat UI
+ * should reflect. It is not a second execution path and does not itself run anything.
+ */
+import type { RunProtocolEvent } from '@jini-ai/protocol';
+import type { RunLifecycle } from './run-lifecycle.js';
+export interface RemoteToolUseRecord {
+    /** Stable agent-side correlation id, matched by the following `recordToolResult` call. */
+    readonly toolUseId: string;
+    /** Jini registry id — never an agent-vendor-specific tool name. */
+    readonly toolId: string;
+    readonly input: unknown;
+}
+export interface RemoteToolResultRecord {
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError?: boolean;
+}
+export interface RemoteToolEventRecorder {
+    /** Records that a tool call started. Throws (matching `RunLifecycle.emit`) if `runId` is unknown or already terminal. */
+    recordToolUse(runId: string, record: RemoteToolUseRecord): Promise<RunProtocolEvent>;
+    /** Records that a tool call finished (or failed) — mirrors `DelegatedToolBridge.execute()`'s own `tool_result` shape exactly. */
+    recordToolResult(runId: string, record: RemoteToolResultRecord): Promise<RunProtocolEvent>;
+}
+export interface CreateRemoteToolEventRecorderOptions {
+    readonly lifecycle: RunLifecycle;
+}
+export declare function createRemoteToolEventRecorder(options: CreateRemoteToolEventRecorderOptions): RemoteToolEventRecorder;
+//# sourceMappingURL=remote-tool-bridge.d.ts.map

package/dist/remote-tool-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-tool-bridge.d.ts","sourceRoot":"","sources":["../src/remote-tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,yHAAyH;IACzH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrF,iIAAiI;IACjI,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;CAClC;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,oCAAoC,GAAG,uBAAuB,CAsBpH"}

package/dist/remote-tool-bridge.js

@@ -0,0 +1,23 @@
+export function createRemoteToolEventRecorder(options) {
+    const { lifecycle } = options;
+    return {
+        recordToolUse(runId, record) {
+            return lifecycle.emit(runId, {
+                event: 'agent',
+                data: { type: 'tool_use', id: record.toolUseId, name: record.toolId, input: record.input },
+            });
+        },
+        recordToolResult(runId, record) {
+            return lifecycle.emit(runId, {
+                event: 'agent',
+                data: {
+                    type: 'tool_result',
+                    toolUseId: record.toolUseId,
+                    content: record.content,
+                    ...(record.isError ? { isError: true } : {}),
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=remote-tool-bridge.js.map

package/dist/remote-tool-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-tool-bridge.js","sourceRoot":"","sources":["../src/remote-tool-bridge.ts"],"names":[],"mappings":"AAgDA,MAAM,UAAU,6BAA6B,CAAC,OAA6C;IACzF,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,OAAO;QACL,aAAa,CAAC,KAAK,EAAE,MAAM;YACzB,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC3B,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;aAC3F,CAAC,CAAC;QACL,CAAC;QACD,gBAAgB,CAAC,KAAK,EAAE,MAAM;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC3B,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE;oBACJ,IAAI,EAAE,aAAa;oBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7C;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/routines/routine-store.js

@@ -1,5 +1,5 @@
 /**
- * `RoutineStore` — the CRUD + run-history persistence port for `@jini-ai/http`'s routine routes.
+ * `RoutineStore` — the CRUD + run-history persistence port for `@jini-ai/http-kit`'s routine routes.
  * Designed the same way `../event-log.js`'s `EventLog` is designed (that module's own doc
  * comment is the explicit template named by the porting proposal,
  * `ADS-memory/reports/proposals/PROP-http-route-packs-automation-routines-2026-07-21.md`): a

package/dist/routines/schedule.d.ts

@@ -55,14 +55,6 @@ export declare function tzWallToUtcCandidates(timezone: string, year: number, mo
  */
 export declare function tzWallToUtcGapFallback(timezone: string, year: number, month: number, day: number, hour: number, minute: number): Date | null;
 export declare function nextHourlyRunAt(minute: number, now?: Date): Date;
-/**
- * Returns the next instant at which the wall-clock in `timezone` reads "HH:MM" on a day where
- * `predicate(weekday)` holds. Walks forward at most 14 calendar days as a safety bound (covers
- * any weekday-based pattern). Exported (unlike this module's other internal helpers) so its
- * 14-day-exhaustion fallback is directly unit-testable: every `predicate` `nextRunAtForSchedule`
- * actually passes (daily/weekdays/weekly) structurally guarantees a match within 7 days, making
- * that branch otherwise unreachable through the public schedule-kind API alone.
- */
 export declare function nextWallTimeMatching(timezone: string, time: string, predicate: (weekday: Weekday) => boolean, now: Date): Date | null;
 export declare function nextRunAtForSchedule(schedule: RoutineSchedule, now?: Date): Date | null;
 export declare function isValidWallTime(time: string): boolean;

package/dist/routines/schedule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/routines/schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIjF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,GACV;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAoCA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAoBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,IAAI,CAWb;AAwBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,IAAI,CAQtE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,EACxC,GAAG,EAAE,IAAI,GACR,IAAI,GAAG,IAAI,CAuCb;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAa,GAAG,IAAI,GAAG,IAAI,CAe7F;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA2BhE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAYjE"}
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/routines/schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIjF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,GACV;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAoCA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAoBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,IAAI,CAWb;AAwBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,IAAI,CAQtE;AA6DD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,EACxC,GAAG,EAAE,IAAI,GACR,IAAI,GAAG,IAAI,CAuBb;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAa,GAAG,IAAI,GAAG,IAAI,CAe7F;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAQnD;AA6BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAahE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAYjE"}

package/dist/routines/schedule.js

@@ -136,7 +136,8 @@ export function nextHourlyRunAt(minute, now = new Date()) {
  * actually passes (daily/weekdays/weekly) structurally guarantees a match within 7 days, making
  * that branch otherwise unreachable through the public schedule-kind API alone.
  */
-export function nextWallTimeMatching(timezone, time, predicate, now) {
+/** Parses a strict "HH:MM" 24-hour wall time, returning `null` for any malformed or out-of-range value. */
+function parseWallTime(time) {
     const m = /^(\d{2}):(\d{2})$/.exec(time);
     if (!m)
         return null;
@@ -146,39 +147,58 @@ export function nextWallTimeMatching(timezone, time, predicate, now) {
         return null;
     if (!Number.isFinite(minute) || minute < 0 || minute > 59)
         return null;
+    return { hour, minute };
+}
+/**
+ * Resolves the requested wall time on one specific calendar day in `timezone` to the instant a
+ * routine should fire, given that everything at or before `now` has already passed.
+ *
+ * `abandon` covers the case where the requested wall time cannot be represented as a `Date` at all
+ * — see {@link nextWallTimeMatching} for when that actually happens.
+ */
+function resolveDayFireInstant(timezone, date, hour, minute, now) {
+    const candidates = tzWallToUtcCandidates(timezone, date.year, date.month, date.day, hour, minute);
+    if (candidates.length === 0) {
+        // Spring-forward gap: no valid wall instant exists today; pick the synthesized post-gap
+        // fallback so the routine still fires today.
+        const fallback = tzWallToUtcGapFallback(timezone, date.year, date.month, date.day, hour, minute);
+        if (!fallback)
+            return { kind: 'abandon' };
+        return fallback.getTime() > now.getTime() ? { kind: 'fire', at: fallback } : { kind: 'next-day' };
+    }
+    // Iterate candidates in ascending order so that on a fall-back overlap day, when `now`
+    // already passed the first occurrence (EDT), we still pick the second one (EST) before
+    // walking to the next day.
+    for (const candidate of candidates) {
+        if (candidate.getTime() > now.getTime())
+            return { kind: 'fire', at: candidate };
+    }
+    return { kind: 'next-day' };
+}
+export function nextWallTimeMatching(timezone, time, predicate, now) {
+    const wall = parseWallTime(time);
+    if (!wall)
+        return null;
     // Walk day by day in the target timezone.
     for (let offset = 0; offset < 14; offset += 1) {
         const probe = new Date(now.getTime() + offset * 24 * 60 * 60_000);
         const parts = partsInTimezone(timezone, probe);
         if (!predicate(parts.weekday))
             continue;
-        const candidates = tzWallToUtcCandidates(timezone, parts.year, parts.month, parts.day, hour, minute);
-        if (candidates.length === 0) {
-            // Spring-forward gap: no valid wall instant exists today; pick the synthesized post-gap
-            // fallback so the routine still fires today.
-            const fallback = tzWallToUtcGapFallback(timezone, parts.year, parts.month, parts.day, hour, minute);
-            // Null-safety guard against tzWallToUtcGapFallback's `Date | null` return type (it returns
-            // null only for an invalid timezone). Structurally unreachable from THIS call site: the
-            // unguarded `partsInTimezone(timezone, probe)` two lines above already succeeded for this
-            // exact `timezone` earlier in this same loop iteration, which proves it valid before
-            // `tzWallToUtcGapFallback` (guarding the identical Intl call) is ever reached — so this
-            // branch cannot be exercised without bypassing that invariant. Kept rather than removed:
-            // the guard is still correct defensive programming against the function's real signature,
-            // and `tzWallToUtcGapFallback`'s own null path is independently covered by a direct test
-            // (see schedule.test.ts) against an invalid timezone.
-            if (!fallback)
-                return null;
-            if (fallback.getTime() > now.getTime())
-                return fallback;
-            continue;
-        }
-        // Iterate candidates in ascending order so that on a fall-back overlap day, when `now`
-        // already passed the first occurrence (EDT), we still pick the second one (EST) before
-        // walking to the next day.
-        for (const candidate of candidates) {
-            if (candidate.getTime() > now.getTime())
-                return candidate;
-        }
+        const resolution = resolveDayFireInstant(timezone, parts, wall.hour, wall.minute, now);
+        if (resolution.kind === 'fire')
+            return resolution.at;
+        // `abandon` means `tzWallToUtcGapFallback` returned null. Its own `catch` fires whenever the
+        // Intl call inside it throws — which an invalid timezone causes, but so does an
+        // unrepresentable instant. The latter is reachable from right here despite `timezone` being
+        // proven valid by the `partsInTimezone` call above: when `now` sits within a day of the
+        // maximum representable `Date` (+275760-09-13), `Date.UTC(...)` for a later wall time that
+        // same day overflows to `NaN`, `new Date(NaN)` makes `formatToParts` throw `RangeError`, and
+        // both `tzWallToUtcCandidates` (hence the empty candidate list) and `tzWallToUtcGapFallback`
+        // swallow it. No later day can succeed either, so give up rather than spin the remaining
+        // iterations. Covered by a direct test in schedule.test.ts.
+        if (resolution.kind === 'abandon')
+            return null;
     }
     return null;
 }
@@ -218,30 +238,37 @@ export function isValidTimezone(tz) {
         return false;
     }
 }
+function validateHourlyMinute(minute) {
+    if (!Number.isInteger(minute) || minute < 0 || minute > 59) {
+        throw new Error('hourly.minute must be an integer 0-59');
+    }
+}
+function validateWeekday(weekday) {
+    if (!Number.isInteger(weekday) || weekday < 0 || weekday > 6) {
+        throw new Error('weekly.weekday must be 0-6');
+    }
+}
+function validateWallClockSchedule(schedule) {
+    if (!isValidWallTime(schedule.time)) {
+        throw new Error(`Invalid time: ${schedule.time}`);
+    }
+    if (!isValidTimezone(schedule.timezone)) {
+        throw new Error(`Invalid timezone: ${schedule.timezone}`);
+    }
+    if (schedule.kind === 'weekly') {
+        validateWeekday(schedule.weekday);
+    }
+}
 export function validateSchedule(schedule) {
     if (!schedule || typeof schedule !== 'object') {
         throw new Error('schedule is required');
     }
     if (schedule.kind === 'hourly') {
-        const m = schedule.minute;
-        if (!Number.isInteger(m) || m < 0 || m > 59) {
-            throw new Error('hourly.minute must be an integer 0-59');
-        }
+        validateHourlyMinute(schedule.minute);
         return;
     }
     if (schedule.kind === 'daily' || schedule.kind === 'weekdays' || schedule.kind === 'weekly') {
-        if (!isValidWallTime(schedule.time)) {
-            throw new Error(`Invalid time: ${schedule.time}`);
-        }
-        if (!isValidTimezone(schedule.timezone)) {
-            throw new Error(`Invalid timezone: ${schedule.timezone}`);
-        }
-        if (schedule.kind === 'weekly') {
-            const w = schedule.weekday;
-            if (!Number.isInteger(w) || w < 0 || w > 6) {
-                throw new Error('weekly.weekday must be 0-6');
-            }
-        }
+        validateWallClockSchedule(schedule);
         return;
     }
     throw new Error(`Unsupported schedule kind: ${schedule.kind}`);

package/dist/routines/schedule.js.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/routines/schedule.ts"],"names":[],"mappings":"AAWA,sCAAsC;AAEtC;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,KAAW;IAUX,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC3C,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;IAC/E,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,UAAU,GAA4B;QAC1C,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;KACP,CAAC;IACF,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5B,qEAAqE;IACrE,IAAI,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,IAAY,EACZ,KAAa,EACb,GAAW,EACX,IAAY,EACZ,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,GAAG,GAAW,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC1B,IAAI,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,IAAY,EACZ,KAAa,EACb,GAAW,EACX,IAAY,EACZ,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAgB,EAChB,EAAQ,EACR,IAAY,EACZ,KAAa,EACb,GAAW,EACX,IAAY,EACZ,MAAc;IAEd,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;AACzG,CAAC;AAED,0FAA0F;AAC1F,SAAS,eAAe,CAAC,QAAgB,EAAE,EAAQ;IACjD,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,8CAA8C;AAE9C,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;IAC9D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,IAAY,EACZ,SAAwC,EACxC,GAAS;IAET,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAEvE,0CAA0C;IAC1C,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,SAAS;QACxC,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrG,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,wFAAwF;YACxF,6CAA6C;YAC7C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACpG,2FAA2F;YAC3F,wFAAwF;YACxF,0FAA0F;YAC1F,qFAAqF;YACrF,wFAAwF;YACxF,yFAAyF;YACzF,0FAA0F;YAC1F,yFAAyF;YACzF,sDAAsD;YACtD,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC3B,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;gBAAE,OAAO,QAAQ,CAAC;YACxD,SAAS;QACX,CAAC;QACD,uFAAuF;QACvF,uFAAuF;QACvF,2BAA2B;QAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;gBAAE,OAAO,SAAS,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAyB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;IAC9E,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,iBAAiB;QACjB,OAAO,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mCAAmC;AAEnC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5F,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8BAA+B,QAA6B,CAAC,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO;IAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oCAAqC,MAA2B,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3F,CAAC"}
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/routines/schedule.ts"],"names":[],"mappings":"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"}

package/dist/routines/scheduler.d.ts

@@ -29,6 +29,49 @@ export declare class RoutineService {
     private scheduleRoutineAt;
     nextRunAt(routineId: string): Date | null;
     runNow(routineId: string): Promise<RoutineRunHandlerStart>;
+    /**
+     * Wraps a persistence failure as a {@link ScheduledRunPersistenceError} when this attempt was a
+     * scheduled fire, so the caller retries the same slot instead of advancing the cadence. Manual
+     * fires have no slot to retry and surface the original error unchanged.
+     */
+    private asPersistenceFailure;
+    /**
+     * Tear-down for when the durable routine_run row was never inserted (insertRun threw, or another
+     * daemon already won the slot). Prefers the explicit `discardUnstarted` callback when the handler
+     * distinguishes the two cases — that one drops the in-memory chat run entirely instead of
+     * finalizing it as `canceled`, so duplicate scheduled losers do not surface phantom runs on a run
+     * listing. Handlers that do not implement the split still see `discard`.
+     */
+    private discardUnstartedRun;
+    /**
+     * Claims the durable routine_run row for this attempt. Returns `false` when a sibling daemon
+     * already won the slot (the in-memory run has been discarded and the caller should just hand the
+     * handler's start handle back); throws when the write itself failed.
+     */
+    private claimRunRow;
+    /**
+     * Copies the real project/conversation/run IDs `prepare()` resolved back onto the start handle and
+     * persists them. Scheduled fires always write (the row was inserted with routine placeholders);
+     * manual fires write only when `prepare()` actually changed something.
+     */
+    private persistPreparedIds;
+    /**
+     * Finalizes a run whose `prepare()` step failed. Terminates the in-memory chat run created by
+     * `handler(...)` so its `completion` promise resolves instead of waiting forever on a run that
+     * will never start, surfacing (but not rethrowing) any cleanup failure, then persists the
+     * terminal row.
+     *
+     * The placeholder IDs are cleared first: they are only replaced with real resources by
+     * `prepare()`, so a failure before that enrichment would otherwise leave the terminal row
+     * pointing at fabricated project/conversation IDs. For scheduled runs the slot claim was already
+     * accepted at `insertRun()`, so retrying the same slot is not appropriate — the caller lets the
+     * error propagate so the scheduler advances to the next cadence.
+     */
+    private finalizeUnpreparedRun;
+    /** Persists the terminal row once the host's run completes (or its completion promise rejects). */
+    private wireRunCompletion;
+    /** Hands control to the host's `start()`, finalizing the row as failed if it throws synchronously. */
+    private startPreparedRun;
     private start_;
 }
 //# sourceMappingURL=scheduler.d.ts.map

package/dist/routines/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/routines/scheduler.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAEV,kBAAkB,EAElB,iBAAiB,EACjB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAYpB;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IAEnD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO;gBAFtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO;CAKlC;AAMD,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,WAAW;IALxC,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,QAAQ,CAAsD;IACtE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAAS;gBAEK,WAAW,EAAE,kBAAkB;IAE5D,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAMZ,aAAa,IAAI,IAAI;IASrB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAmCzB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAInC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAIlD,MAAM;CA4KrB"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/routines/scheduler.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAEV,kBAAkB,EAElB,iBAAiB,EACjB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAYpB;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IAEnD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO;gBAFtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO;CAKlC;AAwBD,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,WAAW;IALxC,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,QAAQ,CAAsD;IACtE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAAS;gBAEK,WAAW,EAAE,kBAAkB;IAE5D,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAMZ,aAAa,IAAI,IAAI;IASrB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAmCzB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAInC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIhE;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAanB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IA6B7B,mGAAmG;IACnG,OAAO,CAAC,iBAAiB;IAsBzB,sGAAsG;IACtG,OAAO,CAAC,gBAAgB;YAeV,MAAM;CAkErB"}