@qontinui/shared-types 2.4.1 → 3.0.0

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/RequestFrontmatter.d.ts

@@ -0,0 +1,30 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * An incoming request — the raw ask a requirement is derived from.
+ */
+export interface RequestFrontmatter {
+  id: string;
+  /**
+   * ISO 8601.
+   */
+  received_at?: string | null;
+  /**
+   * The role of the person asking — a role, never a name.
+   */
+  requester_role?: string | null;
+  /**
+   * Its reference there (a message id, a ticket key).
+   */
+  source_ref?: string | null;
+  /**
+   * Where the request came from, e.g. `email`, `jira`, `workshop`.
+   */
+  source_system: string;
+  [k: string]: unknown;
+}

package/src/generated/RequirementFrontmatter.d.ts

@@ -0,0 +1,31 @@
+/* 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 { CriterionVerification } from "./CriterionVerification";
+import type { EarsPattern } from "./EarsPattern";
+import type { ExternalRef } from "./ExternalRef";
+import type { SourceCitation } from "./SourceCitation";
+import type { SourceCitationKind } from "./SourceCitationKind";
+import type { SpecAcceptanceCriterion } from "./SpecAcceptanceCriterion";
+import type { TemplateRef } from "./TemplateRef";
+
+/**
+ * A requirement.
+ */
+export interface RequirementFrontmatter {
+  /**
+   * May be empty: completeness is the spec quality gate's verdict, not a
+   * parse error.
+   */
+  acceptance_criteria?: SpecAcceptanceCriterion[];
+  ears?: EarsPattern & string;
+  external_refs?: ExternalRef[];
+  id: string;
+  sources?: SourceCitation[];
+  template?: TemplateRef | null;
+  [k: string]: unknown;
+}

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";
@@ -80,6 +81,12 @@ export interface ScheduledTask {
    * Default 60s.
    */
   launchFailureBackoffSeconds: number;
+  /**
+   * Set when the task was created by the runner's reconciler from a
+   * fleet-wide recurring-agent declaration rather than by a user. `None` =
+   * an unmanaged, user-created task, which the reconciler never touches.
+   */
+  managed?: ManagedBy | null;
   /**
    * ISO 8601 timestamp of last modification.
    */
@@ -108,4 +115,12 @@ export interface ScheduledTask {
    * Task type and its per-type configuration.
    */
   task: ScheduledTaskType;
+  /**
+   * IANA time zone this task's schedule is interpreted in (e.g.
+   * `Europe/Berlin`). Takes precedence over the global
+   * [`SchedulerSettings::timezone`]; `None` = the scheduler's zone. Lets one
+   * fleet-wide declaration mean either "local night on every device" or a
+   * fixed instant.
+   */
+  timezone?: string | null;
 }

package/src/generated/ScheduledTaskType.d.ts

@@ -90,6 +90,21 @@ export type ScheduledTaskType =
        * Empty = use the runner's default tool allow-list.
        */
       allowed_tools?: string[];
+      /**
+       * Optional reasoning-effort level for the spawned session: one of
+       * `low`, `medium`, `high`, `xhigh` or `max`. `None` leaves the level
+       * to the runner. A plain string rather than an enum, so a stored
+       * task carrying a level this crate does not list still loads; the
+       * consumer validates it.
+       */
+      effort?: string | null;
+      /**
+       * Optional kebab-case name of a spawn-effort profile (e.g.
+       * `research`, `implementation`) that the runner resolves to an
+       * effort level and an ultracode setting. `None` leaves the choice
+       * to the runner.
+       */
+      effort_profile?: string | null;
       /**
        * Hard cap on Claude turns per run (safety bound). `None` =
        * runner's default cap (typically 50).
@@ -116,6 +131,12 @@ export type ScheduledTaskType =
        * (typically 600s = 10 min).
        */
       timeout_seconds?: number | null;
+      /**
+       * Optional ultracode switch (standing dynamic-workflow orchestration)
+       * for the spawned session. `Some(true)` turns it on, `Some(false)`
+       * keeps it off, and `None` leaves the choice to the runner.
+       */
+      ultracode?: boolean | null;
       /**
        * Working directory for the spawned session. `None` means the
        * runner's project root. Stored as a string (not `PathBuf`) to keep

package/src/generated/SourceCitation.d.ts

@@ -0,0 +1,25 @@
+/* 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 { SourceCitationKind } from "./SourceCitationKind";
+
+/**
+ * Evidence a requirement was derived from.
+ */
+export interface SourceCitation {
+  kind: SourceCitationKind;
+  /**
+   * Where it is: a path and symbol, a document and heading, a ticket key,
+   * an artifact's `spec_ref`.
+   */
+  locator: string;
+  /**
+   * The version cited (a commit, a document revision), when one applies.
+   */
+  version?: string | null;
+  [k: string]: unknown;
+}

package/src/generated/SourceCitationKind.d.ts

@@ -0,0 +1,12 @@
+/* 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 source citation points at.
+ */
+export type SourceCitationKind =
+  "code" | "doc_section" | "ticket" | "incident" | "artifact";