talon-agent 3.0.5 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talon-agent",
-  "version": "3.0.5",
+  "version": "3.1.0",
   "description": "Multi-frontend AI agent with full tool access, streaming, cron jobs, and plugin system",
   "author": "Dylan Neve",
   "license": "MIT",
@@ -42,6 +42,7 @@
     "src/native/",
     "src/plugins/",
     "src/storage/",
+    "src/types/",
     "src/util/",
     "src/app.ts",
     "src/bootstrap.ts",
@@ -77,6 +78,8 @@
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "lint": "oxlint src/",
+    "depcruise": "depcruise src",
+    "ratchets": "node scripts/check-ratchets.mjs",
     "knip": "knip",
     "format": "prettier --write src/ prompts/",
     "format:check": "prettier --check src/ prompts/",
@@ -130,9 +133,11 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@swc/core": "^1.15.46",
     "@types/node": "^26.0.0",
     "@types/write-file-atomic": "^4.0.3",
     "@vitest/coverage-v8": "^4.1.3",
+    "dependency-cruiser": "^18.1.0",
     "fast-check": "^4.6.0",
     "knip": "^6.3.1",
     "oxlint": "^1.59.0",

package/src/backend/kilo/models/index.ts

@@ -13,7 +13,7 @@
  * Kilo ids routinely contain "/" and ":" (e.g. "inclusionai/ling-2.6-1t:free").
  */
 
-import { ensureServer } from "../server.js";
+import { ensureServer, onServerStop } from "../server.js";
 import { createRemoteModelCatalogModule } from "../../remote-server/model-catalog/index.js";
 
 export type {
@@ -41,6 +41,9 @@ const kiloModels = createRemoteModelCatalogModule({
   quickPickLimit: 24,
 });
 
+// A stopped server invalidates the catalog it served.
+onServerStop(kiloModels.clearCache);
+
 export const getOpenCodeModelCatalog = kiloModels.getCatalog;
 export const clearModelCatalogCache = kiloModels.clearCache;
 export const getOpenCodeModelInfo = kiloModels.getModelInfo;

package/src/backend/kilo/server.ts

@@ -25,13 +25,12 @@ import type { TalonConfig } from "../../util/config.js";
 import type { FrontendName } from "../../core/agent-runtime/backend-registry.js";
 import { logWarn } from "../../util/log.js";
 import { buildDeliveryContract } from "../shared/delivery-contract.js";
-import { clearModelCatalogCache } from "./models/index.js";
 import {
   guessProviderID,
   getBucketPriority,
   normalizeModelLookup,
-  parseOpenCodeModelQuery,
-} from "./models/index.js";
+  parseRemoteModelQuery as parseOpenCodeModelQuery,
+} from "../remote-server/model-catalog/index.js";
 import {
   createRemoteServerState,
   ensureRemoteServer as ensureRemoteServerShared,
@@ -153,6 +152,18 @@ async function prewarmPluginMcpServers(): Promise<void> {
   await ensurePluginMcpServers(client, "prewarm");
 }
 
+/**
+ * Callbacks run when the server stops — cache invalidation lives with the
+ * caches. The models module registers its clear here at load time, so the
+ * server never has to import it (which would be a cycle).
+ */
+const stopHooks = new Set<() => void>();
+
+/** Register a callback to run whenever the Kilo server is stopped. */
+export function onServerStop(hook: () => void): void {
+  stopHooks.add(hook);
+}
+
 /**
  * Stop the local Kilo server (if we own it) and clear caches.
  *
@@ -160,7 +171,9 @@ async function prewarmPluginMcpServers(): Promise<void> {
  * server, this leaves it running — we don't own it.
  */
 export function stopKiloServer(): void {
-  stopRemoteServer(state, clearModelCatalogCache);
+  stopRemoteServer(state, () => {
+    for (const hook of stopHooks) hook();
+  });
 }
 
 // ── Server lifecycle ────────────────────────────────────────────────────────

package/src/backend/openai-agents/session.ts

@@ -251,7 +251,7 @@ export class TalonSession extends MemorySession {
     return current;
   }
 
-  async addItems(items: AgentInputItem[]): Promise<void> {
+  override async addItems(items: AgentInputItem[]): Promise<void> {
     await super.addItems(items);
     await this.enforceCap();
   }

package/src/backend/opencode/models/index.ts

@@ -12,7 +12,7 @@
  * stay at 4 and only short separator-free ids are embedded raw.
  */
 
-import { ensureServer } from "../server.js";
+import { ensureServer, onServerStop } from "../server.js";
 import { createRemoteModelCatalogModule } from "../../remote-server/model-catalog/index.js";
 
 export type {
@@ -40,6 +40,9 @@ const opencodeModels = createRemoteModelCatalogModule({
   quickPickLimit: 4,
 });
 
+// A stopped server invalidates the catalog it served.
+onServerStop(opencodeModels.clearCache);
+
 export const getOpenCodeModelCatalog = opencodeModels.getCatalog;
 export const clearModelCatalogCache = opencodeModels.clearCache;
 export const getOpenCodeModelInfo = opencodeModels.getModelInfo;

package/src/backend/opencode/server.ts

@@ -25,13 +25,12 @@ import type { TalonConfig } from "../../util/config.js";
 import type { FrontendName } from "../../core/agent-runtime/backend-registry.js";
 import { logWarn } from "../../util/log.js";
 import { buildDeliveryContract } from "../shared/delivery-contract.js";
-import { clearModelCatalogCache } from "./models/index.js";
 import {
   guessProviderID,
   getBucketPriority,
   normalizeModelLookup,
-  parseOpenCodeModelQuery,
-} from "./models/index.js";
+  parseRemoteModelQuery as parseOpenCodeModelQuery,
+} from "../remote-server/model-catalog/index.js";
 import {
   createRemoteServerState,
   ensureRemoteServer as ensureRemoteServerShared,
@@ -108,8 +107,22 @@ async function prewarmPluginMcpServers(): Promise<void> {
   await ensurePluginMcpServers(client, "prewarm");
 }
 
+/**
+ * Callbacks run when the server stops — cache invalidation lives with the
+ * caches. The models module registers its clear here at load time, so the
+ * server never has to import it (which would be a cycle).
+ */
+const stopHooks = new Set<() => void>();
+
+/** Register a callback to run whenever the OpenCode server is stopped. */
+export function onServerStop(hook: () => void): void {
+  stopHooks.add(hook);
+}
+
 export function stopOpenCodeServer(): void {
-  stopRemoteServer(state, clearModelCatalogCache);
+  stopRemoteServer(state, () => {
+    for (const hook of stopHooks) hook();
+  });
 }
 
 // ── Server lifecycle ────────────────────────────────────────────────────────

package/src/backend/shared/system-prompt.ts

@@ -41,6 +41,7 @@ import {
   type TalonConfig,
 } from "../../util/config.js";
 import { getPluginPromptAdditions } from "../../core/plugin/index.js";
+import { onPromptInputsChanged } from "../../core/prompt/invalidation.js";
 import { frontendForChatId, nonTerminalFrontends } from "./frontends.js";
 
 // ── Types ───────────────────────────────────────────────────────────────────
@@ -112,6 +113,10 @@ export function clearSystemPromptSnapshots(): void {
   snapshots.clear();
 }
 
+// Core and frontends invalidate through the core-side seam — they never
+// import this module (layer rule: nothing above backend/ reaches into it).
+onPromptInputsChanged(clearSystemPromptSnapshots);
+
 // ── Public API ──────────────────────────────────────────────────────────────
 
 /**

package/src/cli/events.ts

@@ -52,7 +52,7 @@ async function showHistory(limit: number): Promise<void> {
   const { readJournal } = await import("../storage/journal.js");
   let entries;
   try {
-    entries = readJournal({ limit });
+    entries = readJournal<TalonEvent & { at: number }>({ limit });
   } catch (err) {
     console.log(
       `  ${pc.red("✖")} Could not read the journal: ${err instanceof Error ? err.message : err}\n`,

package/src/cli/tasks.ts

@@ -16,6 +16,7 @@ import type {
   TaskRecord,
   TaskState,
 } from "../core/tasks/index.js";
+import type { PublishedEvent } from "../core/bus/index.js";
 
 function formatDuration(ms: number): string {
   const seconds = Math.floor(ms / 1000);
@@ -120,7 +121,10 @@ async function journalTasks(
   const { readJournal } = await import("../storage/journal.js");
   const seen = new Set(liveTasks.map((t) => `${t.id}:${t.queuedAt}`));
   const historical: TaskRecord[] = [];
-  for (const entry of readJournal({ type: "task.settled", limit })) {
+  for (const entry of readJournal<PublishedEvent>({
+    type: "task.settled",
+    limit,
+  })) {
     if (entry.event.type !== "task.settled") continue;
     const task = entry.event.task;
     // (id, queuedAt) identifies a run across surfaces — per-process ids

package/src/core/background/triggers/pid.ts

@@ -0,0 +1,28 @@
+/**
+ * PID-starttime probe — the /proc read shared by spawn (capture at fork)
+ * and resume (compare after restart). Lives alone so neither module has
+ * to import the other for it.
+ */
+
+import { readFileSync } from "node:fs";
+
+/**
+ * Read field 22 (start time in jiffies since boot) from /proc/<pid>/stat.
+ * Returns undefined if /proc isn't available (non-Linux) or the read fails.
+ *
+ * Parsing note: the `comm` field (2nd) is wrapped in parens and may itself
+ * contain ')' — the safe parse finds the LAST ')' and splits the rest on
+ * space. After that split, index 19 corresponds to field 22.
+ */
+export function readPidStarttimeSync(pid: number): number | undefined {
+  try {
+    const stat = readFileSync(`/proc/${pid}/stat`, "utf-8");
+    const lastParen = stat.lastIndexOf(")");
+    if (lastParen < 0) return undefined;
+    const tail = stat.slice(lastParen + 2).split(" ");
+    const starttime = Number(tail[19]);
+    return Number.isFinite(starttime) ? starttime : undefined;
+  } catch {
+    return undefined;
+  }
+}

package/src/core/background/triggers/resume.ts

@@ -1,10 +1,10 @@
 /**
  * Post-restart resume — respawn persistent triggers, fire late wakes for
- * recently-terminated ones, plus the /proc-based PID-starttime probe and the
- * orphan-kill used to avoid duplicate spawns after an unclean crash.
+ * recently-terminated ones, plus the orphan-kill used to avoid duplicate
+ * spawns after an unclean crash. The /proc PID-starttime probe both this
+ * and spawn use lives in ./pid.ts.
  */
 
-import { readFileSync } from "node:fs";
 import {
   getAllTriggers,
   updateTrigger,
@@ -15,6 +15,7 @@ import { log, logError } from "../../../util/log.js";
 import { depsHolder } from "./state.js";
 import { fireWake } from "./output.js";
 import { spawnTrigger } from "./spawn.js";
+import { readPidStarttimeSync } from "./pid.js";
 
 /**
  * After the dispatcher is wired, walk the store and clean up leftover state
@@ -68,27 +69,6 @@ export async function resumeAfterRestart(): Promise<void> {
   }
 }
 
-/**
- * Read field 22 (start time in jiffies since boot) from /proc/<pid>/stat.
- * Returns undefined if /proc isn't available (non-Linux) or the read fails.
- *
- * Parsing note: the `comm` field (2nd) is wrapped in parens and may itself
- * contain ')' — the safe parse finds the LAST ')' and splits the rest on
- * space. After that split, index 19 corresponds to field 22.
- */
-export function readPidStarttimeSync(pid: number): number | undefined {
-  try {
-    const stat = readFileSync(`/proc/${pid}/stat`, "utf-8");
-    const lastParen = stat.lastIndexOf(")");
-    if (lastParen < 0) return undefined;
-    const tail = stat.slice(lastParen + 2).split(" ");
-    const starttime = Number(tail[19]);
-    return Number.isFinite(starttime) ? starttime : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
 /**
  * Probe a stored PID from a previous Talon run and SIGKILL it if it's still
  * alive AND really is our former child (not a recycled PID). Used by

package/src/core/background/triggers/spawn.ts

@@ -25,7 +25,7 @@ import {
 import { commandForLanguage } from "./command.js";
 import { handleStdoutLine, handleStderrLine } from "./output.js";
 import { handleTimeout, finalizeExit, failTrigger } from "./exit.js";
-import { readPidStarttimeSync } from "./resume.js";
+import { readPidStarttimeSync } from "./pid.js";
 
 /**
  * Spawn a trigger's script as a supervised child process.

package/src/core/engine/gateway-actions/plugins.ts

@@ -22,8 +22,8 @@ export async function performPluginReload(
   const { reloadPlugins, getPluginPromptAdditions } =
     await import("../../plugin/index.js");
   const { rebuildSystemPrompt } = await import("../../../util/config.js");
-  const { clearSystemPromptSnapshots } =
-    await import("../../../backend/shared/system-prompt.js");
+  const { notifyPromptInputsChanged } =
+    await import("../../prompt/invalidation.js");
 
   // reloadPlugins reads + validates config internally — no double read.
   // Frontends are derived from config if not explicitly provided.
@@ -37,7 +37,7 @@ export async function performPluginReload(
   // Plugin prompt additions changed — drop per-session prompt
   // snapshots so every chat's next turn picks up the new prompt
   // (deliberate one-time cache re-write per live session).
-  clearSystemPromptSnapshots();
+  notifyPromptInputsChanged();
 
   return { names };
 }

package/src/core/prompt/invalidation.ts

@@ -0,0 +1,23 @@
+/**
+ * Prompt-input invalidation — the core-side seam callers use when prompt
+ * inputs change out from under live sessions on purpose (plugin reload,
+ * skill toggle).
+ *
+ * Whoever caches assembled prompts registers a hook here (today: the
+ * per-session snapshot store in backend/shared/system-prompt.ts, at its
+ * module load). Core and frontends call `notifyPromptInputsChanged()`
+ * and never import the cache — the dependency points backend → core,
+ * as the layer rule requires.
+ */
+
+const hooks = new Set<() => void>();
+
+/** Register a callback run whenever prompt inputs are invalidated. */
+export function onPromptInputsChanged(hook: () => void): void {
+  hooks.add(hook);
+}
+
+/** Invalidate: every registered prompt cache drops its state. */
+export function notifyPromptInputsChanged(): void {
+  for (const hook of hooks) hook();
+}

package/src/core/types.ts

@@ -29,8 +29,8 @@ export type UnifiedModelInfo = {
   unavailableReason?: string;
 };
 
-export type ReasoningEffortLevel =
-  "off" | "minimal" | "low" | "medium" | "high" | "max" | "xhigh";
+export type { ReasoningEffortLevel } from "../types/effort.js";
+import type { ReasoningEffortLevel } from "../types/effort.js";
 
 /** Result of resolving a user's model query. */
 export type UnifiedModelResolution =

package/src/frontend/discord/callbacks/components.ts

@@ -34,9 +34,9 @@ import {
   setChatModelForBackend,
   setChatBackend,
   setChatEffort,
-  resolveModelName,
   type EffortLevel,
 } from "../../../storage/chat-settings.js";
+import { resolveModelId as resolveModelName } from "../../../core/models/catalog.js";
 import {
   registerChat,
   disablePulse,

package/src/frontend/discord/commands/settings.ts

@@ -18,9 +18,9 @@ import {
   setChatBackend,
   setChatEffort,
   setChatPulseInterval,
-  resolveModelName,
   type EffortLevel,
 } from "../../../storage/chat-settings.js";
+import { resolveModelId as resolveModelName } from "../../../core/models/catalog.js";
 import {
   registerChat,
   disablePulse,

package/src/frontend/native/extensions.ts

@@ -21,7 +21,7 @@ import type { Backend } from "../../core/agent-runtime/capabilities.js";
 import { performPluginReload } from "../../core/engine/gateway-actions/plugins.js";
 import { getPluginPromptAdditions } from "../../core/plugin/index.js";
 import { listPluginItems, setPluginEnabled } from "../../core/plugin/manage.js";
-import { clearSystemPromptSnapshots } from "../../backend/shared/system-prompt.js";
+import { notifyPromptInputsChanged } from "../../core/prompt/invalidation.js";
 import { listSkills, setSkillEnabled } from "../../storage/skill-store.js";
 import { rebuildSystemPrompt, type TalonConfig } from "../../util/config.js";
 import { log } from "../../util/log.js";
@@ -88,6 +88,6 @@ export function toggleSkill(
   log("native", `Skill ${name} ${enabled ? "enabled" : "disabled"} via bridge`);
   rebuildSystemPrompt(config, getPluginPromptAdditions());
   backend?.control?.updateSystemPrompt?.(config.systemPrompt);
-  clearSystemPromptSnapshots();
+  notifyPromptInputsChanged();
   return { ok: true };
 }

package/src/frontend/telegram/callbacks/model.ts

@@ -11,8 +11,8 @@ import type { Context } from "grammy";
 import {
   setChatModelForBackend,
   setChatBackend,
-  resolveModelName,
 } from "../../../storage/chat-settings.js";
+import { resolveModelId as resolveModelName } from "../../../core/models/catalog.js";
 import { resetSession } from "../../../storage/sessions.js";
 import { clearHistory } from "../../../storage/history.js";
 import {

package/src/frontend/telegram/commands/settings.ts

@@ -9,9 +9,9 @@ import {
   setChatBackend,
   setChatEffort,
   setChatPulseInterval,
-  resolveModelName,
   type EffortLevel,
 } from "../../../storage/chat-settings.js";
+import { resolveModelId as resolveModelName } from "../../../core/models/catalog.js";
 import {
   registerChat,
   disablePulse,

package/src/frontend/terminal/commands.ts

@@ -20,8 +20,8 @@ import {
   getChatSettings,
   setChatModel,
   setChatEffort,
-  resolveModelName,
 } from "../../storage/chat-settings.js";
+import { resolveModelId as resolveModelName } from "../../core/models/catalog.js";
 import {
   getAllSessions,
   getSession,

package/src/plugins/github/index.ts

@@ -12,7 +12,7 @@
  */
 
 import { execFileSync } from "node:child_process";
-import type { TalonPlugin } from "../../core/plugin/index.js";
+import type { TalonPlugin } from "../../core/plugin/types.js";
 import { log, logWarn } from "../../util/log.js";
 
 /**

package/src/plugins/mem0/index.ts

@@ -21,7 +21,7 @@
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import type { TalonPlugin } from "../../core/plugin/index.js";
+import type { TalonPlugin } from "../../core/plugin/types.js";
 import { log, logWarn } from "../../util/log.js";
 import { dirs } from "../../util/paths.js";
 

package/src/plugins/mempalace/index.ts

@@ -18,7 +18,7 @@ import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { execFile as execFileCb, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
-import type { TalonPlugin } from "../../core/plugin/index.js";
+import type { TalonPlugin } from "../../core/plugin/types.js";
 import { log, logWarn } from "../../util/log.js";
 import { dirs } from "../../util/paths.js";
 

package/src/plugins/playwright/index.ts

@@ -21,7 +21,7 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
-import type { TalonPlugin } from "../../core/plugin/index.js";
+import type { TalonPlugin } from "../../core/plugin/types.js";
 import { log } from "../../util/log.js";
 
 export function createPlaywrightPlugin(config: {

package/src/storage/chat-settings.ts

@@ -22,63 +22,12 @@ import { recordError } from "../util/watchdog.js";
 import { files } from "../util/paths.js";
 import { importLegacyJson } from "./legacy-import.js";
 import * as repo from "./repositories/chat-settings-repo.js";
-import type { ReasoningEffortLevel } from "../core/types.js";
+import type { ReasoningEffortLevel } from "../types/effort.js";
 
 export type EffortLevel = ReasoningEffortLevel;
 
-export type ChatSettings = {
-  /**
-   * Per-backend model overrides for this chat. Keyed by backend id
-   * (`"claude"`, `"codex"`, `"openai-agents"`, etc). Each entry is the
-   * model id the user picked on that backend.
-   *
-   * Switching backends preserves each side's last pick — your Codex
-   * chat remembers `gpt-5.5`, your OpenRouter chat remembers
-   * `meta-llama/...`. Replaces the single legacy `model` field which
-   * couldn't differentiate per-backend choices and produced the
-   * orphan-bug class (model from backend X persisting when switching
-   * to backend Y).
-   *
-   * Resolution order (see `core/models/active-model.ts`):
-   *   1. `modelByBackend[activeBackend]` if it validates on the catalog
-   *   2. `backend.getDefaultModel()` (canonical for backends that have one)
-   *   3. `config.backendDefaults[activeBackend]` (operator override)
-   *   4. `config.model` (only when activeBackend === config.backend)
-   *   5. null → "No model selected" UI + send guard refuses.
-   */
-  modelByBackend?: Record<string, string>;
-  /**
-   * @deprecated Single-slot model field. Retained for back-compat with
-   * old stores; migrated into `modelByBackend` on load. New writes go
-   * through `setChatModelForBackend` instead.
-   */
-  model?: string;
-  /**
-   * Backend override for this chat. When set, queries from this chat
-   * route to the override backend instead of the global `config.backend`.
-   * The backend controller refcounts pool instances, so two chats on
-   * two different backends keep both alive concurrently.
-   *
-   * Stored as the registry id (e.g. `"claude"`, `"openai-agents"`).
-   * Cleared via `setChatBackend(cid, undefined)` — chat reverts to
-   * the global default.
-   */
-  backend?: string;
-  /** Effort level override (maps to SDK thinking + effort options). */
-  effort?: EffortLevel;
-  /** Whether pulse is enabled for this chat. */
-  pulse?: boolean;
-  /** Per-chat pulse check interval in milliseconds. */
-  pulseIntervalMs?: number;
-  /** Last message ID checked by pulse (persisted to avoid reprocessing on restart). */
-  pulseLastCheckMsgId?: number;
-  /**
-   * When true, the model picker filters to free-tier models by default.
-   * Only meaningful for backends that report free-tier metadata (currently
-   * `openai-agents` against OpenRouter); other backends ignore the flag.
-   */
-  freeOnly?: boolean;
-};
+export type { ChatSettings } from "./repositories/chat-settings-repo.js";
+import type { ChatSettings } from "./repositories/chat-settings-repo.js";
 
 // In-memory cache over the chat_settings table. Reads serve live
 // references from here; writes go through persist() so each mutation
@@ -488,9 +437,3 @@ export const EFFORT_LEVELS: EffortLevel[] = [
   "max",
   "xhigh",
 ];
-
-/**
- * Resolve a user-provided model name (alias or full ID) to the canonical model ID.
- * Delegates to the model registry; falls through unknown names unchanged.
- */
-export { resolveModelId as resolveModelName } from "../core/models/catalog.js";

package/src/storage/cron-store.ts

@@ -20,87 +20,13 @@ import { inTransaction } from "./db.js";
 import * as repo from "./repositories/cron-repo.js";
 import { nextDueMs, type CatchupPolicy } from "../native/scheduler-core.js";
 
-export type CronJobType = "message" | "query";
+export type {
+  CronJob,
+  CronJobType,
+  CronRunStatus,
+} from "./repositories/cron-repo.js";
 export type { CatchupPolicy };
-
-/** Outcome of the most recent execution — surfaced in list_cron_jobs. */
-export type CronRunStatus = "ok" | "error";
-
-export type CronJob = {
-  id: string;
-  chatId: string;
-  /**
-   * Cron expression (5-field: minute hour day month weekday). Optional — a job
-   * carries EITHER `schedule` (cron mode) OR `everyMs` (interval mode), never
-   * both. The store validator (`isCronJob`) enforces exactly one.
-   */
-  schedule?: string;
-  /**
-   * Fixed interval in milliseconds (interval mode). Mutually exclusive with
-   * `schedule`. The job fires roughly every `everyMs` after its anchor
-   * (`lastRunAt`, else `startAt`, else `createdAt`). Wires the native
-   * scheduler-core interval math (next-due + missed-run catch-up) directly.
-   */
-  everyMs?: number;
-  /** "message" sends content as text; "query" runs content as a Claude prompt with tools */
-  type: CronJobType;
-  /** The message text or query prompt */
-  content: string;
-  /** Human-readable name for the job */
-  name: string;
-  enabled: boolean;
-  createdAt: number;
-  lastRunAt?: number;
-  runCount: number;
-  /** IANA timezone (e.g. "America/New_York"). Defaults to system timezone. */
-  timezone?: string;
-  /**
-   * Optional model override for `query` jobs. Unset = the chat's model. `query`
-   * cron jobs run as an isolated one-shot (no chat session), so unlike triggers
-   * the model may be on a different provider — see `provider`.
-   */
-  model?: string;
-  /**
-   * Optional provider/backend id for the override (e.g. a cheaper provider than
-   * the chat). Requires `model`. Unset = the chat's backend. Since cron runs
-   * isolated, a different provider is fine here.
-   */
-  provider?: string;
-  /**
-   * Optional short brief that becomes the isolated agent's system prompt — what
-   * the job is and how to do it. Useful to orient a cheaper override model.
-   */
-  instructions?: string;
-  /**
-   * Don't fire before this epoch-ms instant (a delayed start / "not before").
-   * Unset = eligible immediately.
-   */
-  startAt?: number;
-  /**
-   * Don't fire after this epoch-ms instant; the job auto-disables once now
-   * passes it (a natural expiry / "until"). Unset = no end.
-   */
-  endAt?: number;
-  /**
-   * Auto-disable after this many total runs (`runCount >= maxRuns`). A value of
-   * 1 makes the job one-shot. Unset = unbounded.
-   */
-  maxRuns?: number;
-  /**
-   * Missed-run policy for runs that were due while Talon was down:
-   *   "skip" (default) — drop them, resume on the next due tick
-   *   "once"           — collapse any number of missed runs into a single catch-up
-   *   "all"            — replay every missed run, capped by CATCHUP_MAX
-   * Decided by the native scheduler-core `catchupRunCount`.
-   */
-  catchup?: CatchupPolicy;
-  /** Status of the most recent execution. */
-  lastStatus?: CronRunStatus;
-  /** Error message from the most recent failed execution (cleared on success). */
-  lastError?: string;
-  /** Wall-clock duration of the most recent execution, in ms. */
-  lastDurationMs?: number;
-};
+import type { CronJob, CronRunStatus } from "./repositories/cron-repo.js";
 
 /** Telemetry recorded after each execution attempt. */
 export type CronRunOutcome = {