@qontinui/shared-types 2.4.0 → 2.5.0

package/dist/scheduler.d.cts

@@ -390,6 +390,21 @@ 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).
@@ -416,6 +431,12 @@ 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
@@ -432,7 +453,7 @@ type ScheduledTaskType =
       command: string;
       task_type: "Script";
       /**
-       * Wall-clock timeout in seconds. `None` = runner default
+       * Wall-clock timeout in seconds. `None` (or 0) = runner default
        * (600s = 10 min).
        */
       timeout_seconds?: number | null;
@@ -579,6 +600,12 @@ 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.
    */
@@ -607,6 +634,52 @@ 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;
+}
+/**
+ * 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

@@ -390,6 +390,21 @@ 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).
@@ -416,6 +431,12 @@ 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
@@ -432,7 +453,7 @@ type ScheduledTaskType =
       command: string;
       task_type: "Script";
       /**
-       * Wall-clock timeout in seconds. `None` = runner default
+       * Wall-clock timeout in seconds. `None` (or 0) = runner default
        * (600s = 10 min).
        */
       timeout_seconds?: number | null;
@@ -579,6 +600,12 @@ 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.
    */
@@ -607,6 +634,52 @@ 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;
+}
+/**
+ * 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.4.0",
+  "version": "2.5.0",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/ChangeTimeline.d.ts

@@ -0,0 +1,484 @@
+/* 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 { CacheProvenance } from "./CacheProvenance";
+import type { DetectedAnimation } from "./DetectedAnimation";
+import type { Observation } from "./Observation";
+import type { ObservationCoverage } from "./ObservationCoverage";
+import type { Producer } from "./Producer";
+import type { Provenance } from "./Provenance";
+import type { UnknownCode } from "./UnknownCode";
+import type { UnknownInfo } from "./UnknownInfo";
+import type { UnmeasuredDimension } from "./UnmeasuredDimension";
+
+/**
+ * A single event in the interaction timeline, discriminated on `type`.
+ */
+export type TimelineEvent =
+  | {
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "action";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Number of elements affected.
+       */
+      count: number;
+      /**
+       * Element IDs involved.
+       */
+      elementIds: string[];
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "elements-appeared";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Number of elements affected.
+       */
+      count: number;
+      /**
+       * Element IDs involved.
+       */
+      elementIds: string[];
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "elements-disappeared";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Number of elements affected.
+       */
+      count: number;
+      /**
+       * Element IDs involved.
+       */
+      elementIds: string[];
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "elements-modified";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "page-changed";
+      /**
+       * The new URL, or `null` when the diff did not carry one.
+       */
+      url?: string | null;
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "settled";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The browser's `hadRecentInput` flag for this shift.
+       */
+      hadRecentInput: boolean;
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * How many shifted elements `shiftedFingerprints` named. NOT sent by
+       * the SDK: [`ChangeTimeline::for_ledger`] sets it when it empties
+       * `shiftedFingerprints`, so a stored timeline keeps the count and
+       * not the hashes. Absent on the wire from the SDK.
+       */
+      shiftedElementCount?: number | null;
+      /**
+       * `ElementFingerprintData.hash` of each shifted element still in the
+       * document.
+       */
+      shiftedFingerprints: string[];
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "layout-shift";
+      /**
+       * Shift sources whose node was gone (or not an element) when the
+       * entry was read.
+       */
+      unattributedSourceCount: number;
+      /**
+       * The shift score (Layout Instability API `value`).
+       */
+      value: number;
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The animation.
+       */
+      animation: DetectedAnimation;
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "animation-started";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The animation.
+       */
+      animation: DetectedAnimation;
+      /**
+       * Finished or cancelled.
+       */
+      endReason: "finished" | "cancelled";
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "animation-ended";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Task duration (ms).
+       */
+      durationMs: number;
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "long-task";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * The request URL carried a query string (not reported).
+       */
+      hasQuery: boolean;
+      /**
+       * HTTP method.
+       */
+      method: string;
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * The tracker's request id, or `null` when the source supplies none.
+       */
+      requestId?: string | null;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "network-request-started";
+      /**
+       * Origin + pathname — never the query or fragment. Always a string
+       * from the SDK; `null` only in [`ChangeTimeline::for_ledger`]'s
+       * projection, when the URL had no valid `scheme://host` origin.
+       */
+      url?: string | null;
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Request duration as the tracker measured it, or `null` without a
+       * response.
+       */
+      durationMs?: number | null;
+      /**
+       * The request threw (no HTTP response). An HTTP error status is NOT
+       * `errored` — read `statusCode`.
+       */
+      errored: boolean;
+      /**
+       * The request URL carried a query string (not reported).
+       */
+      hasQuery: boolean;
+      /**
+       * HTTP method.
+       */
+      method: string;
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * The tracker's request id, or `null` when the source supplies none.
+       */
+      requestId?: string | null;
+      /**
+       * HTTP status, or `null` when no response arrived.
+       */
+      statusCode?: number | null;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "network-request-finished";
+      /**
+       * Origin + pathname — never the query or fragment. Always a string
+       * from the SDK; `null` only in [`ChangeTimeline::for_ledger`]'s
+       * projection, when the URL had no valid `scheme://host` origin.
+       */
+      url?: string | null;
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * The declared state id.
+       */
+      stateId: string;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "state-entered";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Time offset from action start (ms).
+       */
+      offsetMs: number;
+      /**
+       * The declared state id.
+       */
+      stateId: string;
+      /**
+       * Human-readable summary (SDK prose — see the module's PRIVACY note).
+       */
+      summary: string;
+      type: "state-exited";
+      [k: string]: unknown;
+    };
+/**
+ * A source of timeline events. A source NOT listed in
+ * [`ChangeTimeline::observed_sources`] was not looked at, so the absence of
+ * its events means "unknown", never "none".
+ */
+export type TimelineSource =
+  | "snapshot-poll"
+  | "idle-detector"
+  | "layout-shift"
+  | "long-task"
+  | "animation-events"
+  | "get-animations"
+  | "network"
+  | "states";
+/**
+ * How an expected state fared inside the caller's `withinMs` window. Exactly
+ * one key on the wire.
+ */
+export type ExpectedStateOutcome =
+  | {
+      enteredAtMs: number;
+    }
+  | {
+      notEnteredWithinMs: number;
+    }
+  | {
+      activeThroughoutWithinMs: number;
+    };
+
+/**
+ * The interaction timeline: action → every observed event → settled, each
+ * with its offset from the action, plus a derived [`TimelineSummary`].
+ */
+export interface ChangeTimeline {
+  /**
+   * Timestamped events, ordered by `offsetMs` (ties keep arrival order).
+   */
+  events: TimelineEvent[];
+  /**
+   * The sources this recording could observe.
+   */
+  observedSources: TimelineSource[];
+  /**
+   * How long the timeline was recorded, from action start (ms): the settle
+   * window, extended by any `withinMs` window. Not the settle time.
+   */
+  recordedMs: number;
+  /**
+   * Whether the UI reached a stable state within `settleTimeout`.
+   */
+  settled: boolean;
+  summary: TimelineSummary;
+  [k: string]: unknown;
+}
+/**
+ * Values derived from `events`.
+ */
+export interface TimelineSummary {
+  /**
+   * Animations/transitions running when recording ended. Degraded
+   * (`coverage.unmeasured`) where `document.getAnimations` is missing.
+   */
+  animationsUnsettledAtEnd:
+    | {
+        provenance: Provenance;
+        status: "measured";
+        value: DetectedAnimation[];
+        [k: string]: unknown;
+      }
+    | {
+        provenance: Provenance;
+        status: "absent";
+        [k: string]: unknown;
+      }
+    | {
+        provenance: Provenance;
+        status: "unknown";
+        unknown: UnknownInfo;
+        [k: string]: unknown;
+      };
+  /**
+   * One entry per requested `expectStates` id, in request order; `[]` when
+   * none were requested.
+   */
+  expectedStates: ExpectedStateResult[];
+  /**
+   * Offset of the first RESPONSE event (elements-*, page-changed,
+   * layout-shift, animation-*, state-*). `unknown{no_event_before_timeout}`
+   * when nothing responded in the window.
+   */
+  firstResponseMs: Observation;
+  /**
+   * Offset of the LAST layout shift minus `firstResponseMs`. `absent` when
+   * no shift occurred.
+   */
+  layoutShiftAfterFirstResponseMs: Observation;
+  /**
+   * Number of `layout-shift` events. Same unknown rule.
+   */
+  layoutShiftCount:
+    | {
+        provenance: Provenance;
+        status: "measured";
+        value: number;
+        [k: string]: unknown;
+      }
+    | {
+        provenance: Provenance;
+        status: "absent";
+        [k: string]: unknown;
+      }
+    | {
+        provenance: Provenance;
+        status: "unknown";
+        unknown: UnknownInfo;
+        [k: string]: unknown;
+      };
+  /**
+   * Sum of `layout-shift` values in the window.
+   * `unknown{performance_observer_unsupported}` where the entry type is
+   * missing.
+   */
+  layoutShiftTotal: Observation;
+  /**
+   * Sum of `long-task` durations (ms).
+   * `unknown{performance_observer_unsupported}` where `longtask` is
+   * missing.
+   */
+  longTaskTotalMs: Observation;
+  /**
+   * Offset of the `settled` event. `unknown{no_event_before_timeout}` when
+   * the UI did not settle within `settleTimeout`.
+   */
+  settleMs: Observation;
+  [k: string]: unknown;
+}
+/**
+ * One `expectStates` entry and its answer.
+ */
+export interface ExpectedStateResult {
+  /**
+   * The answer — `unknown{input_missing}` for an undeclared state or no
+   * state registry.
+   */
+  outcome:
+    | {
+        provenance: Provenance;
+        status: "measured";
+        value: ExpectedStateOutcome;
+        [k: string]: unknown;
+      }
+    | {
+        provenance: Provenance;
+        status: "absent";
+        [k: string]: unknown;
+      }
+    | {
+        provenance: Provenance;
+        status: "unknown";
+        unknown: UnknownInfo;
+        [k: string]: unknown;
+      };
+  /**
+   * The declared state id the caller asked about.
+   */
+  stateId: string;
+  [k: string]: unknown;
+}