@qontinui/shared-types 1.1.0 → 2.1.0

package/dist/refusal.d.ts

@@ -0,0 +1,158 @@
+import { G as GlossaryTerm } from './GlossaryTerm.d-orY3JZRJ.js';
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * What the reader does next. A closed set: every refusal names exactly one.
+ */
+type NextActionKind =
+  | "retry_later"
+  | "run_command"
+  | "open_page"
+  | "sign_in"
+  | "pair_device"
+  | "set_setting"
+  | "wait_for_gate"
+  | "none_terminal"
+  | "report_defect"
+  | "fix_request"
+  | "resnapshot"
+  | "scroll_into_view"
+  | "wait_for_enabled"
+  | "broaden_selector"
+  | "unrecognised";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * The typed next step of a [`Refusal`]. Decoding is lenient toward newer
+ * producers (module docs, "Forward compatibility").
+ */
+interface NextAction {
+  kind: NextActionKind;
+  /**
+   * For [`NextActionKind::RetryLater`]: the earliest useful retry, in whole
+   * seconds. Absent when no delay is known.
+   */
+  retry_after_s?: number | null;
+  /**
+   * What the action applies to: the command to run, the page to open, the
+   * setting to set, the gate to wait for. Its meaning is fixed by `kind`.
+   */
+  target?: string | null;
+  /**
+   * READER-SIDE: the raw `kind` when this reader did not recognise it
+   * (`kind` is then [`NextActionKind::Unrecognised`]). Producers must not
+   * emit it.
+   */
+  unrecognised_kind?: string | null;
+  [k: string]: unknown;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * What went wrong, as a stable machine-readable code.
+ *
+ * Extend by adding a variant (and its row in [`RefusalCode::headline`] and
+ * [`RefusalCode::from_wire`]); the tables are exhaustive `match`es, so a new
+ * code without a sentence is a compile error.
+ */
+type RefusalCode =
+  | "workspace_root_unresolved"
+  | "sibling_checkout_absent"
+  | "endpoint_unresolved"
+  | "glossary_term_unknown"
+  | "unknown";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * The component that produced a [`Refusal`].
+ */
+type RefusalSource =
+  "runner" | "coord" | "web_backend" | "web_frontend" | "unrecognised";
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+
+
+/**
+ * One operator-facing refusal: what went wrong, and what to do next.
+ *
+ * Construct with [`Refusal::new`] and the `with_*` builders. `next_action` is
+ * deliberately not optional — see the module docs. Decoding is lenient toward
+ * newer producers (module docs, "Forward compatibility").
+ */
+interface Refusal {
+  code: RefusalCode;
+  /**
+   * Raw diagnostic text (the underlying error, the unrecognised reason).
+   * Shown beside the rendered sentence, never inside it.
+   */
+  detail?: string | null;
+  /**
+   * Narrows `code` to the specific case (the setting that was empty, the
+   * service whose address was missing). Rendered after the headline.
+   */
+  discriminator?: string | null;
+  /**
+   * Glossary terms a reader may need to act on this refusal. Typed, so a
+   * producer cannot cite a term the glossary does not define. Always
+   * present on the wire (an empty list, never null).
+   */
+  glossary_terms: GlossaryTerm[];
+  next_action: NextAction;
+  /**
+   * When the refusal was observed (ISO 8601).
+   */
+  observed_at: string;
+  source: RefusalSource;
+  /**
+   * READER-SIDE: the raw `code` when this reader did not recognise it
+   * (`code` is then [`RefusalCode::Unknown`]). Absent when the producer
+   * itself said `unknown`. Producers must not emit it.
+   */
+  unrecognised_code?: string | null;
+  /**
+   * READER-SIDE: glossary ids this reader's glossary does not define,
+   * removed from `glossary_terms`. Producers must not emit it.
+   */
+  unrecognised_glossary_terms?: string[];
+  /**
+   * READER-SIDE: the raw `source` when this reader did not recognise it
+   * (`source` is then [`RefusalSource::Unrecognised`]). Producers must not
+   * emit it.
+   */
+  unrecognised_source?: string | null;
+  [k: string]: unknown;
+}
+
+export { GlossaryTerm, type NextAction, type NextActionKind, type Refusal, type RefusalCode, type RefusalSource };

package/dist/refusal.js

@@ -0,0 +1 @@
+//# sourceMappingURL=refusal.js.map

package/dist/refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runner.d.cts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -34,7 +34,7 @@ interface RunnerCrash {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -51,7 +51,7 @@ type RunnerInstanceRole = "primary" | "secondary";
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -101,7 +101,7 @@ interface RunnerInstance {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -115,7 +115,7 @@ type RunnerStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -144,7 +144,7 @@ interface RunnerUiError {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -232,4 +232,4 @@ interface Runner {
   wsConnected: boolean;
 }
 
-export type { Runner, RunnerCrash, RunnerStatus, RunnerUiError };
+export type { Runner, RunnerCrash, RunnerInstance, RunnerInstanceRole, RunnerStatus, RunnerUiError };

package/dist/runner.d.ts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -34,7 +34,7 @@ interface RunnerCrash {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -51,7 +51,7 @@ type RunnerInstanceRole = "primary" | "secondary";
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -101,7 +101,7 @@ interface RunnerInstance {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -115,7 +115,7 @@ type RunnerStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -144,7 +144,7 @@ interface RunnerUiError {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -232,4 +232,4 @@ interface Runner {
   wsConnected: boolean;
 }
 
-export type { Runner, RunnerCrash, RunnerStatus, RunnerUiError };
+export type { Runner, RunnerCrash, RunnerInstance, RunnerInstanceRole, RunnerStatus, RunnerUiError };

package/dist/scheduler.d.cts

@@ -1,7 +1,7 @@
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -19,7 +19,7 @@ interface ConditionScheduleConfig {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -59,7 +59,7 @@ type ScheduleExpression =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -77,7 +77,52 @@ interface IdleCondition {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Condition that runs an external command and is met iff it exits 0.
+ *
+ * The runner execs `command` directly — argv, never a shell — so `command[0]`
+ * is the program and the rest are its arguments; wrap it in `sh -c` yourself
+ * if you want shell syntax. The condition is **NOT met** on a non-zero exit,
+ * on a timeout (the probe is killed at `timeout_seconds`) and on a spawn
+ * failure (including an empty `command`); each is logged distinctly. An
+ * unobserved or failed probe never reads as met.
+ *
+ * The probe is rate-limited to one run per `poll_seconds` per task: between
+ * polls the runner reuses the last result. `poll_seconds` is floored at 60
+ * because the scheduler re-evaluates conditions once per 60 s tick — a shorter
+ * interval could not be honoured. The runner's create/update API REFUSES a
+ * value below the floor (and an empty `command`, and a `timeout_seconds` of
+ * 0 or above 3600) rather than silently rewriting it; a stored row that
+ * predates that validation is clamped up to 60 at evaluation time.
+ */
+interface ProbeCondition {
+  /**
+   * Program and arguments to exec (no shell). Must be non-empty.
+   */
+  command: string[];
+  /**
+   * Whether this condition is active.
+   */
+  enabled: boolean;
+  /**
+   * Minimum seconds between two probe runs for the same task. Minimum 60.
+   */
+  pollSeconds: number;
+  /**
+   * Seconds a single probe run may take before it is killed and counted as
+   * NOT met. 1..=3600.
+   */
+  timeoutSeconds: number;
+}
+
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -98,7 +143,7 @@ interface RepositoryWatch {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -123,7 +168,7 @@ interface RepositoryInactiveCondition {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -137,6 +182,10 @@ interface ScheduleConditions {
    * Require the runner to be idle.
    */
   requireIdle?: IdleCondition | null;
+  /**
+   * Require an external probe command to exit 0 (see [`ProbeCondition`]).
+   */
+  requireProbe?: ProbeCondition | null;
   /**
    * Require repository file inactivity across one or more paths.
    */
@@ -151,7 +200,7 @@ interface ScheduleConditions {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -164,6 +213,18 @@ interface ConditionStatus {
    * `Some(true)` if idle, `Some(false)` if busy.
    */
   idleMet?: boolean | null;
+  /**
+   * Human-readable outcome of the last probe evaluation — e.g. `exit 0`,
+   * `exit 3`, `timed out after 30s`, `spawn failed: ...`, `probe running;
+   * awaiting its result`, `not run: another condition is not met` — with a
+   * bounded stderr tail appended when the probe wrote one.
+   */
+  probeDetail?: string | null;
+  /**
+   * Current probe-condition result. `None` if no probe is configured or
+   * none has been evaluated yet, `Some(true)` if the last probe exited 0.
+   */
+  probeMet?: boolean | null;
   /**
    * Current repository-inactive status per repository: `(path, is_inactive)`.
    */
@@ -181,7 +242,7 @@ interface ConditionStatus {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -194,7 +255,7 @@ type CatchUpPolicy = "run" | "skip" | "run_once";
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -220,7 +281,7 @@ interface McpConnectionRef {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -240,7 +301,7 @@ type ScheduledTaskStatus =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -367,7 +428,7 @@ type ScheduledTaskType =
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -432,7 +493,7 @@ interface TaskExecutionRecord {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -532,7 +593,7 @@ interface ScheduledTask {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -561,7 +622,7 @@ interface SchedulerSettings {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -586,7 +647,7 @@ interface NextTaskInfo {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -618,7 +679,7 @@ interface SchedulerStatus {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -680,7 +741,7 @@ interface CreateScheduledTaskRequest {
 /* eslint-disable */
 /**
  * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * DO NOT MODIFY IT BY HAND. Regenerate with
  * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
  */
 
@@ -741,4 +802,4 @@ interface UpdateScheduledTaskRequest {
   task?: ScheduledTaskType | null;
 }
 
-export type { CatchUpPolicy, ConditionScheduleConfig, ConditionStatus, CreateScheduledTaskRequest, IdleCondition, McpConnectionRef, NextTaskInfo, RepositoryInactiveCondition, RepositoryWatch, ScheduleConditions, ScheduleExpression, ScheduledTask, ScheduledTaskStatus, ScheduledTaskType, SchedulerSettings, SchedulerStatus, TaskExecutionRecord, UpdateScheduledTaskRequest };
+export type { CatchUpPolicy, ConditionScheduleConfig, ConditionStatus, CreateScheduledTaskRequest, IdleCondition, McpConnectionRef, NextTaskInfo, ProbeCondition, RepositoryInactiveCondition, RepositoryWatch, ScheduleConditions, ScheduleExpression, ScheduledTask, ScheduledTaskStatus, ScheduledTaskType, SchedulerSettings, SchedulerStatus, TaskExecutionRecord, UpdateScheduledTaskRequest };