@qontinui/shared-types 2.5.0 → 3.0.0

package/dist/scheduler.d.cts

@@ -252,6 +252,52 @@ interface ConditionStatus {
  */
 type CatchUpPolicy = "run" | "skip" | "run_once";
 
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Provenance of a [`ScheduledTask`] that the runner reconciles from a
+ * fleet-wide declaration (plan
+ * `2026-10-29-recurring-agents-declared-in-coord-reconciled-by-runner`, D5).
+ *
+ * `(source, tenant_id, agent)` is the managed key: the runner holds at most
+ * one task per key. What the reconciler compares to decide whether a task is
+ * current is `digest`, never `version` — a catalog fix in coord's code moves
+ * no row version, and a deleted-and-recreated agent restarts its version at 1.
+ */
+interface ManagedBy {
+  /**
+   * The recurring agent's name — its join key across coord's status, run
+   * requests and this managed task (coord forbids renames).
+   */
+  agent: string;
+  /**
+   * sha256 (64 lowercase hex) of the resolved spec coord served when this
+   * task was applied. `None` = applied from a declaration that carried no
+   * digest.
+   */
+  digest?: string | null;
+  /**
+   * Which declaration store the task came from — [`MANAGED_SOURCE_COORD`].
+   * A plain string rather than an enum, so a stored task from a newer
+   * source still loads; the consumer decides what it recognises.
+   */
+  source: string;
+  /**
+   * The coord tenant (UUID) whose declaration this task applies. A device
+   * bound to several tenants holds one managed task per tenant and agent.
+   */
+  tenantId: string;
+  /**
+   * The declaration's row version when applied. History and display only.
+   */
+  version: number;
+}
+
 /* eslint-disable */
 /**
  * This file was automatically generated.
@@ -643,44 +689,6 @@ interface ScheduledTask {
    */
   timezone?: string | null;
 }
-/**
- * Provenance of a [`ScheduledTask`] that the runner reconciles from a
- * fleet-wide declaration (plan
- * `2026-10-29-recurring-agents-declared-in-coord-reconciled-by-runner`, D5).
- *
- * `(source, tenant_id, agent)` is the managed key: the runner holds at most
- * one task per key. What the reconciler compares to decide whether a task is
- * current is `digest`, never `version` — a catalog fix in coord's code moves
- * no row version, and a deleted-and-recreated agent restarts its version at 1.
- */
-interface ManagedBy {
-  /**
-   * The recurring agent's name — its join key across coord's status, run
-   * requests and this managed task (coord forbids renames).
-   */
-  agent: string;
-  /**
-   * sha256 (64 lowercase hex) of the resolved spec coord served when this
-   * task was applied. `None` = applied from a declaration that carried no
-   * digest.
-   */
-  digest?: string | null;
-  /**
-   * Which declaration store the task came from — [`MANAGED_SOURCE_COORD`].
-   * A plain string rather than an enum, so a stored task from a newer
-   * source still loads; the consumer decides what it recognises.
-   */
-  source: string;
-  /**
-   * The coord tenant (UUID) whose declaration this task applies. A device
-   * bound to several tenants holds one managed task per tenant and agent.
-   */
-  tenantId: string;
-  /**
-   * The declaration's row version when applied. History and display only.
-   */
-  version: number;
-}
 
 /* eslint-disable */
 /**

package/dist/scheduler.d.ts

@@ -252,6 +252,52 @@ interface ConditionStatus {
  */
 type CatchUpPolicy = "run" | "skip" | "run_once";
 
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Provenance of a [`ScheduledTask`] that the runner reconciles from a
+ * fleet-wide declaration (plan
+ * `2026-10-29-recurring-agents-declared-in-coord-reconciled-by-runner`, D5).
+ *
+ * `(source, tenant_id, agent)` is the managed key: the runner holds at most
+ * one task per key. What the reconciler compares to decide whether a task is
+ * current is `digest`, never `version` — a catalog fix in coord's code moves
+ * no row version, and a deleted-and-recreated agent restarts its version at 1.
+ */
+interface ManagedBy {
+  /**
+   * The recurring agent's name — its join key across coord's status, run
+   * requests and this managed task (coord forbids renames).
+   */
+  agent: string;
+  /**
+   * sha256 (64 lowercase hex) of the resolved spec coord served when this
+   * task was applied. `None` = applied from a declaration that carried no
+   * digest.
+   */
+  digest?: string | null;
+  /**
+   * Which declaration store the task came from — [`MANAGED_SOURCE_COORD`].
+   * A plain string rather than an enum, so a stored task from a newer
+   * source still loads; the consumer decides what it recognises.
+   */
+  source: string;
+  /**
+   * The coord tenant (UUID) whose declaration this task applies. A device
+   * bound to several tenants holds one managed task per tenant and agent.
+   */
+  tenantId: string;
+  /**
+   * The declaration's row version when applied. History and display only.
+   */
+  version: number;
+}
+
 /* eslint-disable */
 /**
  * This file was automatically generated.
@@ -643,44 +689,6 @@ interface ScheduledTask {
    */
   timezone?: string | null;
 }
-/**
- * Provenance of a [`ScheduledTask`] that the runner reconciles from a
- * fleet-wide declaration (plan
- * `2026-10-29-recurring-agents-declared-in-coord-reconciled-by-runner`, D5).
- *
- * `(source, tenant_id, agent)` is the managed key: the runner holds at most
- * one task per key. What the reconciler compares to decide whether a task is
- * current is `digest`, never `version` — a catalog fix in coord's code moves
- * no row version, and a deleted-and-recreated agent restarts its version at 1.
- */
-interface ManagedBy {
-  /**
-   * The recurring agent's name — its join key across coord's status, run
-   * requests and this managed task (coord forbids renames).
-   */
-  agent: string;
-  /**
-   * sha256 (64 lowercase hex) of the resolved spec coord served when this
-   * task was applied. `None` = applied from a declaration that carried no
-   * digest.
-   */
-  digest?: string | null;
-  /**
-   * Which declaration store the task came from — [`MANAGED_SOURCE_COORD`].
-   * A plain string rather than an enum, so a stored task from a newer
-   * source still loads; the consumer decides what it recognises.
-   */
-  source: string;
-  /**
-   * The coord tenant (UUID) whose declaration this task applies. A device
-   * bound to several tenants holds one managed task per tenant and agent.
-   */
-  tenantId: string;
-  /**
-   * The declaration's row version when applied. History and display only.
-   */
-  version: number;
-}
 
 /* eslint-disable */
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "2.5.0",
+  "version": "3.0.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/ExecutePlaybookStep.d.ts

@@ -11,6 +11,11 @@ import type { VerificationCategoryKind } from "./VerificationCategoryKind";
 /**
  * Drive a state machine through recorded transitions from a playbook.
  *
+ * The playbook travels inline in `content`, the only body the runner's
+ * executor reads. There is no path form: a `playbookPath` key on a stored
+ * step is ignored when it is decoded and dropped when the step is written
+ * back.
+ *
  * Wire tag: `"execute_playbook"`.
  */
 export interface ExecutePlaybookStep {
@@ -50,10 +55,6 @@ export interface ExecutePlaybookStep {
    * Display name for the step. Absent or `null` reads as `""`.
    */
   name: string;
-  /**
-   * Path to a playbook file.
-   */
-  playbookPath?: string | null;
   /**
    * Whether this step is required (default: `true` on consumer side).
    */

package/src/generated/ManagedBy.d.ts

@@ -0,0 +1,45 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Provenance of a [`ScheduledTask`] that the runner reconciles from a
+ * fleet-wide declaration (plan
+ * `2026-10-29-recurring-agents-declared-in-coord-reconciled-by-runner`, D5).
+ *
+ * `(source, tenant_id, agent)` is the managed key: the runner holds at most
+ * one task per key. What the reconciler compares to decide whether a task is
+ * current is `digest`, never `version` — a catalog fix in coord's code moves
+ * no row version, and a deleted-and-recreated agent restarts its version at 1.
+ */
+export interface ManagedBy {
+  /**
+   * The recurring agent's name — its join key across coord's status, run
+   * requests and this managed task (coord forbids renames).
+   */
+  agent: string;
+  /**
+   * sha256 (64 lowercase hex) of the resolved spec coord served when this
+   * task was applied. `None` = applied from a declaration that carried no
+   * digest.
+   */
+  digest?: string | null;
+  /**
+   * Which declaration store the task came from — [`MANAGED_SOURCE_COORD`].
+   * A plain string rather than an enum, so a stored task from a newer
+   * source still loads; the consumer decides what it recognises.
+   */
+  source: string;
+  /**
+   * The coord tenant (UUID) whose declaration this task applies. A device
+   * bound to several tenants holds one managed task per tenant and agent.
+   */
+  tenantId: string;
+  /**
+   * The declaration's row version when applied. History and display only.
+   */
+  version: number;
+}

package/src/generated/RecurringAgentDispatchRole.d.ts

@@ -0,0 +1,11 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A device's dispatch role, in coord's vocabulary (`dispatch_role.rs`).
+ */
+export type RecurringAgentDispatchRole = "workhorse" | "bench" | "ci_node";

package/src/generated/RecurringAgentExcludedValue.d.ts

@@ -0,0 +1,20 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * An [`RecurringAgentParamKind::IntegerSet`] value the entry refuses.
+ */
+export interface RecurringAgentExcludedValue {
+  /**
+   * Why it is refused.
+   */
+  reason: string;
+  /**
+   * The refused value.
+   */
+  value: number;
+}

package/src/generated/RecurringAgentOs.d.ts

@@ -0,0 +1,11 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * An operating system a [`RecurringAgentTarget::Os`] target selects.
+ */
+export type RecurringAgentOs = "linux" | "windows" | "macos";

package/src/generated/RecurringAgentOverride.d.ts

@@ -0,0 +1,48 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { ConditionScheduleConfig } from "./ConditionScheduleConfig";
+import type { IdleCondition } from "./IdleCondition";
+import type { McpConnectionRef } from "./McpConnectionRef";
+import type { ProbeCondition } from "./ProbeCondition";
+import type { RepositoryInactiveCondition } from "./RepositoryInactiveCondition";
+import type { RepositoryWatch } from "./RepositoryWatch";
+import type { ScheduleConditions } from "./ScheduleConditions";
+import type { ScheduleExpression } from "./ScheduleExpression";
+import type { ScheduledTaskType } from "./ScheduledTaskType";
+
+/**
+ * A local override of a managed task on one machine (plan D6), stored by the
+ * runner and reported to coord so the web shows it. Only the fields set are
+ * overridden; the rest follow the fleet declaration.
+ */
+export interface RecurringAgentOverride {
+  /**
+   * Replacement conditions (e.g. require idle / repo inactive).
+   */
+  conditions?: ScheduleConditions | null;
+  /**
+   * ISO 8601 timestamp when the override was made.
+   */
+  created_at: string;
+  /**
+   * Free-form note from whoever made the override.
+   */
+  note?: string | null;
+  /**
+   * Replacement schedule.
+   */
+  schedule?: ScheduleExpression | null;
+  /**
+   * Replacement task.
+   */
+  task?: ScheduledTaskType | null;
+  /**
+   * Replacement IANA time zone.
+   */
+  timezone?: string | null;
+}

package/src/generated/RecurringAgentParamDef.d.ts

@@ -0,0 +1,100 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { RecurringAgentExcludedValue } from "./RecurringAgentExcludedValue";
+
+/**
+ * One parameter a catalog entry's prompt is rendered from (plan D2), e.g.
+ * cleanup-steward's `mode` enum or return-to-main's `daily_cap` integer.
+ */
+export type RecurringAgentParamDef = {
+  /**
+   * Human-readable explanation, shown beside the form control.
+   */
+  description: string;
+  /**
+   * The key a value is supplied under in [`RecurringAgentSpec::params`].
+   */
+  name: string;
+  /**
+   * A required parameter with no default must be supplied by the tenant
+   * row before the entry renders at all (strategic-pulse's tenant slug).
+   */
+  required: boolean;
+  [k: string]: unknown;
+} & (
+  | {
+      /**
+       * The value used when the tenant sets none.
+       */
+      default: boolean;
+      type: "boolean";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none. Within the bounds.
+       */
+      default: number;
+      /**
+       * Largest allowed value.
+       */
+      maximum: number;
+      /**
+       * Smallest allowed value.
+       */
+      minimum: number;
+      type: "integer";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none. One of `values`.
+       */
+      default: string;
+      type: "enum";
+      /**
+       * The allowed values, in display order. Non-empty, no duplicates.
+       */
+      values: string[];
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The values a tenant may pick from. Non-empty, no duplicates.
+       */
+      allowed: number[];
+      /**
+       * The set used when the tenant sets none. Non-empty, drawn from
+       * `allowed`, none of it excluded.
+       */
+      default: number[];
+      /**
+       * Values that exist but this entry refuses, each with why — shown
+       * greyed out in the form rather than hidden.
+       */
+      excluded: RecurringAgentExcludedValue[];
+      type: "integer_set";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none.
+       */
+      default: string | null;
+      type: "uuid";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none. `None` = no default.
+       */
+      default: string | null;
+      type: "slug";
+      [k: string]: unknown;
+    }
+);

package/src/generated/RecurringAgentParamKind.d.ts

@@ -0,0 +1,89 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { RecurringAgentExcludedValue } from "./RecurringAgentExcludedValue";
+
+/**
+ * The type, default and bounds of one catalog parameter — exactly the shape
+ * coord serves in each catalog entry's `params` array
+ * (`recurring_agents::param_schema_json` in qontinui-coord).
+ *
+ * Tagged by `type` and FLATTENED into its [`RecurringAgentParamDef`], so one
+ * served parameter reads
+ * `{"name":"mode","description":"…","required":false,"type":"enum","values":["reap","report"],"default":"reap"}`.
+ */
+export type RecurringAgentParamKind =
+  | {
+      /**
+       * The value used when the tenant sets none.
+       */
+      default: boolean;
+      type: "boolean";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none. Within the bounds.
+       */
+      default: number;
+      /**
+       * Largest allowed value.
+       */
+      maximum: number;
+      /**
+       * Smallest allowed value.
+       */
+      minimum: number;
+      type: "integer";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none. One of `values`.
+       */
+      default: string;
+      type: "enum";
+      /**
+       * The allowed values, in display order. Non-empty, no duplicates.
+       */
+      values: string[];
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The values a tenant may pick from. Non-empty, no duplicates.
+       */
+      allowed: number[];
+      /**
+       * The set used when the tenant sets none. Non-empty, drawn from
+       * `allowed`, none of it excluded.
+       */
+      default: number[];
+      /**
+       * Values that exist but this entry refuses, each with why — shown
+       * greyed out in the form rather than hidden.
+       */
+      excluded: RecurringAgentExcludedValue[];
+      type: "integer_set";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none.
+       */
+      default: string | null;
+      type: "uuid";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The value used when the tenant sets none. `None` = no default.
+       */
+      default: string | null;
+      type: "slug";
+      [k: string]: unknown;
+    };

package/src/generated/RecurringAgentParamSchema.d.ts

@@ -0,0 +1,16 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { RecurringAgentExcludedValue } from "./RecurringAgentExcludedValue";
+import type { RecurringAgentParamDef } from "./RecurringAgentParamDef";
+
+/**
+ * The parameter form of one catalog entry: the typed parameters a tenant may
+ * set instead of editing prompt text (plan D2, D10). Serialized as the bare
+ * array coord serves under a catalog entry's `params` key.
+ */
+export type RecurringAgentParamSchema = RecurringAgentParamDef[];

package/src/generated/RecurringAgentSpec.d.ts

@@ -0,0 +1,91 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { CatchUpPolicy } from "./CatchUpPolicy";
+import type { ConditionScheduleConfig } from "./ConditionScheduleConfig";
+import type { IdleCondition } from "./IdleCondition";
+import type { McpConnectionRef } from "./McpConnectionRef";
+import type { ProbeCondition } from "./ProbeCondition";
+import type { RecurringAgentDispatchRole } from "./RecurringAgentDispatchRole";
+import type { RecurringAgentOs } from "./RecurringAgentOs";
+import type { RecurringAgentTarget } from "./RecurringAgentTarget";
+import type { RepositoryInactiveCondition } from "./RepositoryInactiveCondition";
+import type { RepositoryWatch } from "./RepositoryWatch";
+import type { ScheduleConditions } from "./ScheduleConditions";
+import type { ScheduleExpression } from "./ScheduleExpression";
+import type { ScheduledTaskType } from "./ScheduledTaskType";
+
+/**
+ * One recurring agent as coord serves it: a catalog entry merged with the
+ * tenant's overrides, or a custom agent's full spec (plan D2).
+ *
+ * On coord's device read route `task_spec` carries the resolved task (for a
+ * catalog agent, the template rendered from `params`; a working directory may
+ * still be the `{workspace_root}` token, which the runner resolves). A
+ * custom agent (no `catalog_ref`) must carry a `RemoteAgent` task and no
+ * `requireProbe` condition (D9): `Script` and probe commands come only from
+ * the catalog, and the runner applies them only when they equal its own
+ * bundled pin.
+ */
+export interface RecurringAgentSpec {
+  /**
+   * The catalog entry this agent is, or overrides. `None` = a custom agent.
+   */
+  catalog_ref?: string | null;
+  /**
+   * What to do about slots missed while a runner was down.
+   */
+  catch_up_policy?: CatchUpPolicy & string;
+  /**
+   * Conditions the task waits for before running.
+   */
+  conditions?: ScheduleConditions | null;
+  /**
+   * sha256 (64 lowercase hex) of the device-independent resolved spec,
+   * computed by coord. What a runner stores as `managed.digest` and echoes
+   * back as `applied_digest`.
+   */
+  digest?: string | null;
+  /**
+   * Whether the agent is enabled for the tenant.
+   */
+  enabled: boolean;
+  /**
+   * The agent's name — unique per tenant, and the join key for device
+   * status, run requests and managed tasks (coord forbids renames).
+   */
+  name: string;
+  /**
+   * Values for the catalog entry's [`RecurringAgentParamSchema`]. Always a
+   * JSON object; empty = every parameter at its default.
+   */
+  params: {
+    [k: string]: unknown;
+  };
+  /**
+   * When the agent runs.
+   */
+  schedule: ScheduleExpression;
+  /**
+   * Which devices the agent applies to.
+   */
+  target: RecurringAgentTarget;
+  /**
+   * The task to run. Required for a custom agent; for a catalog agent, the
+   * resolved template when coord serves it to a device.
+   */
+  task_spec?: ScheduledTaskType | null;
+  /**
+   * IANA time zone for `schedule`. `None` = each device's scheduler zone.
+   */
+  timezone?: string | null;
+  /**
+   * The declaration's row version (starts at 1). History and display only —
+   * compare `digest`, never `version`, to decide whether a device is current.
+   */
+  version: number;
+}

package/src/generated/RecurringAgentState.d.ts

@@ -0,0 +1,13 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * What a device did with one recurring agent — the
+ * `coord.recurring_agent_device_status.state` vocabulary.
+ */
+export type RecurringAgentState =
+  "applied" | "paused" | "overridden" | "unapplied" | "refused";

package/src/generated/RecurringAgentStatus.d.ts

@@ -0,0 +1,79 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { ConditionScheduleConfig } from "./ConditionScheduleConfig";
+import type { IdleCondition } from "./IdleCondition";
+import type { McpConnectionRef } from "./McpConnectionRef";
+import type { ProbeCondition } from "./ProbeCondition";
+import type { RecurringAgentOverride } from "./RecurringAgentOverride";
+import type { RecurringAgentState } from "./RecurringAgentState";
+import type { RepositoryInactiveCondition } from "./RepositoryInactiveCondition";
+import type { RepositoryWatch } from "./RepositoryWatch";
+import type { ScheduleConditions } from "./ScheduleConditions";
+import type { ScheduleExpression } from "./ScheduleExpression";
+import type { ScheduledTaskStatus } from "./ScheduledTaskStatus";
+import type { ScheduledTaskType } from "./ScheduledTaskType";
+import type { TaskExecutionRecord } from "./TaskExecutionRecord";
+
+/**
+ * One device's status for one recurring agent — a
+ * `coord.recurring_agent_device_status` row (plan D7).
+ */
+export interface RecurringAgentStatus {
+  /**
+   * The `request_id` of the newest "Run now" request the device ran,
+   * echoed so coord can stop serving it as pending (plan D10).
+   */
+  acknowledged_request_id?: string | null;
+  /**
+   * The digest of the spec applied. `None` = none applied.
+   */
+  applied_digest?: string | null;
+  /**
+   * The declaration version applied. Display only.
+   */
+  applied_version?: number | null;
+  /**
+   * ISO 8601 end of the newest completed run. `None` = none known.
+   */
+  last_completed_at?: string | null;
+  /**
+   * The newest run.
+   */
+  last_run?: TaskExecutionRecord | null;
+  /**
+   * ISO 8601 end of the newest successful run. `None` = none known.
+   */
+  last_success_at?: string | null;
+  /**
+   * The agent's name.
+   */
+  name: string;
+  /**
+   * ISO 8601 next scheduled run.
+   */
+  next_run?: string | null;
+  /**
+   * The local override record. Required when `state` is `overridden`; a
+   * `paused` task may also carry one.
+   */
+  override?: RecurringAgentOverride | null;
+  /**
+   * The last N runs, newest first.
+   */
+  recent_runs?: TaskExecutionRecord[];
+  /**
+   * What the device did with the agent.
+   */
+  state: RecurringAgentState;
+  /**
+   * Why the agent is `unapplied` or `refused` (e.g.
+   * [`UNAPPLIED_WORKSPACE_ROOT_UNSET`], [`REFUSED_COMMAND`]). Present
+   * exactly for those two states.
+   */
+  unapplied_reason?: string | null;
+}

package/src/generated/RecurringAgentStatusReport.d.ts

@@ -0,0 +1,48 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { ConditionScheduleConfig } from "./ConditionScheduleConfig";
+import type { IdleCondition } from "./IdleCondition";
+import type { McpConnectionRef } from "./McpConnectionRef";
+import type { ProbeCondition } from "./ProbeCondition";
+import type { RecurringAgentOverride } from "./RecurringAgentOverride";
+import type { RecurringAgentState } from "./RecurringAgentState";
+import type { RecurringAgentStatus } from "./RecurringAgentStatus";
+import type { RepositoryInactiveCondition } from "./RepositoryInactiveCondition";
+import type { RepositoryWatch } from "./RepositoryWatch";
+import type { ScheduleConditions } from "./ScheduleConditions";
+import type { ScheduleExpression } from "./ScheduleExpression";
+import type { ScheduledTaskStatus } from "./ScheduledTaskStatus";
+import type { ScheduledTaskType } from "./ScheduledTaskType";
+import type { TaskExecutionRecord } from "./TaskExecutionRecord";
+
+/**
+ * What a runner posts to coord after every reconcile and every run
+ * (`POST /coord/recurring-agents/status/:device_id`, plan D7): one entry per
+ * recurring agent the tenant's declaration targets at this device.
+ */
+export interface RecurringAgentStatusReport {
+  /**
+   * The device's "accept managed tasks" setting (D9; default on). When
+   * off, the runner applies nothing and reports each agent `unapplied`
+   * with [`UNAPPLIED_MANAGED_TASKS_REFUSED`].
+   */
+  accepts_managed: boolean;
+  /**
+   * One entry per agent, names unique.
+   */
+  agents: RecurringAgentStatus[];
+  /**
+   * RFC 3339 timestamp when the device built this report.
+   */
+  reported_at: string;
+  /**
+   * The tenant (UUID) the reported agents were declared by. A device bound
+   * to several tenants posts one report per proven tenant.
+   */
+  tenant_id: string;
+}

package/src/generated/RecurringAgentTarget.d.ts

@@ -0,0 +1,78 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { RecurringAgentDispatchRole } from "./RecurringAgentDispatchRole";
+import type { RecurringAgentOs } from "./RecurringAgentOs";
+
+/**
+ * Which devices a recurring agent applies to (plan D4).
+ *
+ * Always serialized as a JSON object tagged by `kind` — `{"kind":"all"}`,
+ * never the bare string `"all"` — because coord's
+ * `ck_recurring_agents_target_object` refuses a non-object. coord resolves the
+ * target per device on its read route, so a runner never evaluates it.
+ *
+ * Unknown fields are refused on deserialization (not only in the schema): a
+ * misspelt `exclude_devices` silently ignored would widen the target to
+ * devices the author meant to exclude. A runner that cannot parse a target
+ * keeps its last-applied set (the reconciler's fail-safe), which is the safe
+ * side of that failure.
+ */
+export type RecurringAgentTarget =
+  | {
+      /**
+       * Device ids (UUIDs) removed from the target.
+       */
+      exclude_devices?: string[];
+      kind: "all";
+    }
+  | {
+      /**
+       * Device ids (UUIDs). May be empty: coord's catalog defaults for a
+       * one-box agent are `{"kind":"devices","devices":[]}` — the agent
+       * targets no device until an operator picks one.
+       */
+      devices: string[];
+      /**
+       * Device ids (UUIDs) removed from the target.
+       */
+      exclude_devices?: string[];
+      kind: "devices";
+    }
+  | {
+      /**
+       * Device ids (UUIDs) removed from the target.
+       */
+      exclude_devices?: string[];
+      kind: "dispatch_role";
+      /**
+       * The role a device must hold.
+       */
+      role: RecurringAgentDispatchRole;
+    }
+  | {
+      /**
+       * Required capabilities (containment). Must be non-empty.
+       */
+      capabilities: string[];
+      /**
+       * Device ids (UUIDs) removed from the target.
+       */
+      exclude_devices?: string[];
+      kind: "capabilities";
+    }
+  | {
+      /**
+       * Device ids (UUIDs) removed from the target.
+       */
+      exclude_devices?: string[];
+      kind: "os";
+      /**
+       * Selected operating systems. Must be non-empty.
+       */
+      os: RecurringAgentOs[];
+    };

package/src/generated/ScheduledTask.d.ts

@@ -9,6 +9,7 @@ import type { CatchUpPolicy } from "./CatchUpPolicy";
 import type { ConditionScheduleConfig } from "./ConditionScheduleConfig";
 import type { ConditionStatus } from "./ConditionStatus";
 import type { IdleCondition } from "./IdleCondition";
+import type { ManagedBy } from "./ManagedBy";
 import type { McpConnectionRef } from "./McpConnectionRef";
 import type { ProbeCondition } from "./ProbeCondition";
 import type { RepositoryInactiveCondition } from "./RepositoryInactiveCondition";
@@ -123,41 +124,3 @@ export interface ScheduledTask {
    */
   timezone?: string | null;
 }
-/**
- * Provenance of a [`ScheduledTask`] that the runner reconciles from a
- * fleet-wide declaration (plan
- * `2026-10-29-recurring-agents-declared-in-coord-reconciled-by-runner`, D5).
- *
- * `(source, tenant_id, agent)` is the managed key: the runner holds at most
- * one task per key. What the reconciler compares to decide whether a task is
- * current is `digest`, never `version` — a catalog fix in coord's code moves
- * no row version, and a deleted-and-recreated agent restarts its version at 1.
- */
-export interface ManagedBy {
-  /**
-   * The recurring agent's name — its join key across coord's status, run
-   * requests and this managed task (coord forbids renames).
-   */
-  agent: string;
-  /**
-   * sha256 (64 lowercase hex) of the resolved spec coord served when this
-   * task was applied. `None` = applied from a declaration that carried no
-   * digest.
-   */
-  digest?: string | null;
-  /**
-   * Which declaration store the task came from — [`MANAGED_SOURCE_COORD`].
-   * A plain string rather than an enum, so a stored task from a newer
-   * source still loads; the consumer decides what it recognises.
-   */
-  source: string;
-  /**
-   * The coord tenant (UUID) whose declaration this task applies. A device
-   * bound to several tenants holds one managed task per tenant and agent.
-   */
-  tenantId: string;
-  /**
-   * The declaration's row version when applied. History and display only.
-   */
-  version: number;
-}

package/src/generated/index.ts

@@ -285,6 +285,7 @@ export type { LegacyTransition } from './LegacyTransition';
 export type { LogSourceSelection } from './LogSourceSelection';
 export type { LoopInstanceStatus } from './LoopInstanceStatus';
 export type { LoopPhase } from './LoopPhase';
+export type { ManagedBy } from './ManagedBy';
 export type { MappingRow } from './MappingRow';
 export type { MatchAdjustment } from './MatchAdjustment';
 export type { MatchLocation } from './MatchLocation';
@@ -377,6 +378,18 @@ export type { RagProgressEvent } from './RagProgressEvent';
 export type { ReadConfigResponse } from './ReadConfigResponse';
 export type { RecommendedState } from './RecommendedState';
 export type { RecordGitOpRequest } from './RecordGitOpRequest';
+export type { RecurringAgentDispatchRole } from './RecurringAgentDispatchRole';
+export type { RecurringAgentExcludedValue } from './RecurringAgentExcludedValue';
+export type { RecurringAgentOs } from './RecurringAgentOs';
+export type { RecurringAgentOverride } from './RecurringAgentOverride';
+export type { RecurringAgentParamDef } from './RecurringAgentParamDef';
+export type { RecurringAgentParamKind } from './RecurringAgentParamKind';
+export type { RecurringAgentParamSchema } from './RecurringAgentParamSchema';
+export type { RecurringAgentSpec } from './RecurringAgentSpec';
+export type { RecurringAgentState } from './RecurringAgentState';
+export type { RecurringAgentStatus } from './RecurringAgentStatus';
+export type { RecurringAgentStatusReport } from './RecurringAgentStatusReport';
+export type { RecurringAgentTarget } from './RecurringAgentTarget';
 export type { ReflectionFixOutput } from './ReflectionFixOutput';
 export type { Refusal } from './Refusal';
 export type { RefusalCode } from './RefusalCode';