@qontinui/shared-types 0.12.0 → 0.13.0

package/src/generated/AgentTextUnit.d.ts

@@ -0,0 +1,152 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One unit of the agent text corpus: a `(kind, name)` addressed bundle of
+ * text files, owned either by an organization or by the fleet-default layer.
+ *
+ * The content is **untrusted remote content** from the runner's point of
+ * view — it is markdown and shell text rather than compiled code, but it is
+ * instructions to an agent and it becomes files on a fleet device. Consumers
+ * fail soft (a malformed unit falls back to the next rung of the resolution
+ * chain and warns) and never fetch cross-org.
+ *
+ * This mirrors qontinui-web's `AgentTextUnitResponse` field for field, plus
+ * the two forward provenance fields Phase 5 fills in.
+ */
+export interface AgentTextUnit {
+  /**
+   * Canonical digest over the whole [`files`](Self::files) map, from
+   * [`agent_text_unit_files_checksum`]. `None` on a row written before a
+   * checksum was computed.
+   *
+   * This is **not** [`crate::agent_commands::agent_command_checksum`]: that
+   * one digests a single body and is what the legacy `/agent-commands` wire
+   * still carries. The two deliberately disagree even for a one-entry map.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp.
+   */
+  created_at: string;
+  /**
+   * User who last authored this unit. **Attribution only** — it does not
+   * scope visibility; [`organization_id`](Self::organization_id) does.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * Head of the version chain — the `version_number` of the
+   * [`AgentTextUnitVersion`] whose content this unit currently serves.
+   * Starts at 1 and only ever increases (a revert bumps it).
+   */
+  current_version: number;
+  /**
+   * The key of [`files`](Self::files) holding this unit's primary text,
+   * derived server-side from `(kind, name)` — see
+   * [`agent_text_unit_entrypoint`]. Read-only: it is recomputed on every
+   * response and ignored on write.
+   */
+  entrypoint: string;
+  /**
+   * The unit's current content: **relative path → text**. A command carries
+   * one entry; a skill carries `SKILL.md` plus siblings.
+   *
+   * Carried inline on the unit, matching the landed
+   * `AgentTextUnitResponse`. Note the cost that buys the convenience: a
+   * whole-corpus list is ~88 units / ~1.8 MB, and the runner fetches it on
+   * the spawn critical path under a 4 s budget, so a caller that only needs
+   * to know whether its cache is current should compare
+   * [`checksum`](Self::checksum) rather than re-reading these bytes.
+   */
+  files: {
+    [k: string]: string;
+  };
+  /**
+   * Unit id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Whether the harness may offer this unit as an invocable slash command.
+   *
+   * `false` means "carried by the corpus, never invocable": the
+   * underscore-prefixed units (`_gate-registration`, `_loop-control`) are
+   * copy-source specs that other units paste from, and `.claude/commands/`
+   * has no include mechanism, so they must be *present on disk* without
+   * appearing as `/_gate-registration`. Absent means `true`.
+   *
+   * Storage enforces the pairing with a CHECK (`left(name,1) <> '_' OR
+   * is_invocable = false`); [`validate_agent_text_unit_invocability`] is the
+   * same rule at this boundary.
+   * Always written on the wire, matching the landed `AgentTextUnitResponse`
+   * (which emits it unconditionally). `#[serde(default)]` covers reading an
+   * older payload that predates the field; the `#[schemars(default)]` twin
+   * is what puts `true` — rather than `null` — into the generated Python and
+   * TypeScript bindings, so a consumer that sees the field absent defaults
+   * it the same way Rust does.
+   */
+  is_invocable: boolean;
+  /**
+   * Whether this unit is visible to the whole organization rather than only
+   * its author. Absent means `false`.
+   */
+  is_shared: boolean;
+  /**
+   * What sort of unit this is. Open discriminator — see
+   * [`AgentTextUnitKind`].
+   */
+  kind: string;
+  /**
+   * The unit slug, e.g. `vet-plan` or `coord-revive`. It is the filename
+   * stem (single-file kinds) or the directory name (directory kinds) under
+   * `.claude/<subdir>/`, so it is a write-boundary value — validate it with
+   * [`validate_agent_text_unit_name`] before persisting.
+   */
+  name: string;
+  /**
+   * Owning organization (`auth.organizations.id`).
+   *
+   * **`None` is meaningful**: it is the *fleet-default* layer, resolved
+   * after an account override and before the runner's embedded default. It
+   * is also what an organization deletion leaves behind (`ondelete SET
+   * NULL`), which is why storage keys the NULL bucket with its own partial
+   * unique index — see the module docs.
+   */
+  organization_id?: string | null;
+  /**
+   * Which resolution layer this row was served from —
+   * [`AGENT_TEXT_UNIT_SOURCE_USER`] or [`AGENT_TEXT_UNIT_SOURCE_FLEET`].
+   * Server-derived, defaults to `user`.
+   *
+   * ⚠️ **Unrelated to [`source_path`](Self::source_path) /
+   * [`source_commit`](Self::source_commit) despite the shared prefix.** This
+   * field names the *layer the row came from*; those two name the *config
+   * repo the text was imported from*. Adjacent names, different concepts.
+   */
+  source: string;
+  /**
+   * Import provenance: the commit of the source repo (full 40-char SHA).
+   * `None` for a console-authored unit, or for an import from a dirty tree
+   * where no commit honestly describes the bytes.
+   */
+  source_commit?: string | null;
+  /**
+   * Import provenance: the repo-relative path this unit's text came from,
+   * e.g. `.claude/skills/coord-revive/`. `None` for a unit authored directly
+   * in the console.
+   *
+   * Recorded per unit at import so the console can show an operator whether
+   * a unit still matches its source. The path is **repo-relative on
+   * purpose** — an absolute one would pin a build machine's layout into
+   * account data.
+   */
+  source_path?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) last-modification timestamp.
+   */
+  updated_at: string;
+  [k: string]: unknown;
+}

package/src/generated/AgentTextUnitError.d.ts

@@ -0,0 +1,82 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Failure modes for agent text units. Mirrors the tagged-enum shape of
+ * [`crate::apps::AppError`] and [`crate::agent_commands::AgentCommandError`],
+ * so the qontinui-web layer surfaces a rejected unit the same way it surfaces
+ * a rejected app registration.
+ *
+ * One variant per raise site in qontinui-web's `AgentTextUnitValidationError`,
+ * so a Rust caller can render exactly the refusal the store would give.
+ */
+export type AgentTextUnitError =
+  | {
+      name: string;
+      reason: "invalid-name";
+      [k: string]: unknown;
+    }
+  | {
+      name: string;
+      reason: "reserved-name";
+      [k: string]: unknown;
+    }
+  | {
+      kind: string;
+      reason: "invalid-kind";
+      [k: string]: unknown;
+    }
+  | {
+      path: string;
+      reason: "invalid-file-path";
+      [k: string]: unknown;
+    }
+  | {
+      path: string;
+      reason: "reserved-file-path";
+      [k: string]: unknown;
+    }
+  | {
+      reason: "empty-file-set";
+      [k: string]: unknown;
+    }
+  | {
+      count: number;
+      max: number;
+      reason: "too-many-files";
+      [k: string]: unknown;
+    }
+  | {
+      path: string;
+      reason: "blank-file";
+      [k: string]: unknown;
+    }
+  | {
+      bytes: number;
+      max: number;
+      path: string;
+      reason: "file-too-large";
+      [k: string]: unknown;
+    }
+  | {
+      bytes: number;
+      max: number;
+      reason: "unit-too-large";
+      [k: string]: unknown;
+    }
+  | {
+      entrypoint: string;
+      kind: string;
+      name: string;
+      reason: "missing-entrypoint";
+      [k: string]: unknown;
+    }
+  | {
+      name: string;
+      reason: "underscore-not-invocable";
+      [k: string]: unknown;
+    };

package/src/generated/AgentTextUnitFile.d.ts

@@ -0,0 +1,33 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One `relative path → text` entry of a `files` map, as a standalone record.
+ *
+ * The map is the storage and wire form (it is one JSONB column, and it makes
+ * "no duplicate paths" structural rather than validated). This type is the
+ * **entry** form: what a per-file API operation addresses, what a per-file
+ * validation failure names, and what a provisioner iterates. Convert with
+ * [`from_map`](Self::from_map) / [`into_map`](Self::into_map).
+ */
+export interface AgentTextUnitFile {
+  /**
+   * Path relative to the unit's own directory, `/`-separated, e.g.
+   * `SKILL.md` or `coord-revive.sh`. Validated by
+   * [`validate_agent_text_unit_file_path`].
+   */
+  path: string;
+  /**
+   * The file's full text. Written verbatim (modulo the provisioner's own
+   * line-ending handling); never given an executable bit, because scripts
+   * in this corpus are invoked as `bash <path>` and Windows has no exec bit
+   * anyway. "Account-supplied text written to disk" must not become
+   * "account-supplied program registered with the OS".
+   */
+  text: string;
+  [k: string]: unknown;
+}

package/src/generated/AgentTextUnitVersion.d.ts

@@ -0,0 +1,72 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One immutable entry in an [`AgentTextUnit`]'s append-only version chain.
+ *
+ * Rows are **only ever inserted**. An edit appends the next `version_number`;
+ * a revert appends a new version whose `files` are copied from an older one
+ * and whose [`restored_from`](Self::restored_from) names that older version.
+ * Nothing in the chain is updated or deleted, so the chain is the complete
+ * edit history and "revert" is itself a recorded edit.
+ */
+export interface AgentTextUnitVersion {
+  /**
+   * The [`AgentTextUnit`] this version belongs to. Deleting the unit
+   * cascades to its versions.
+   */
+  agent_text_unit_id: string;
+  /**
+   * Free-text note describing what changed, supplied by the editor. A
+   * revert writes a generated one (e.g. `"Restored from version 2"`).
+   */
+  change_description?: string | null;
+  /**
+   * Content hash of [`files`](Self::files), from
+   * [`agent_text_unit_files_checksum`]. Equal checksums on two versions mean
+   * the content is identical, which is what makes the Phase 5 re-import
+   * idempotent — it is the field "did the text actually change?" is read
+   * off. `None` on a row written before a checksum was computed.
+   */
+  checksum?: string | null;
+  /**
+   * ISO 8601 (RFC 3339) creation timestamp. Versions are immutable, so
+   * there is deliberately no `updated_at`.
+   */
+  created_at: string;
+  /**
+   * User who authored this version. Attribution only.
+   */
+  created_by_user_id?: string | null;
+  /**
+   * The unit's whole content as of this version: **relative path → text**.
+   *
+   * Every key must satisfy [`validate_agent_text_unit_file_path`]; the map
+   * must be non-empty and must contain the unit's
+   * [`agent_text_unit_entrypoint`].
+   */
+  files: {
+    [k: string]: string;
+  };
+  /**
+   * Version-row id (UUID v4 string).
+   */
+  id: string;
+  /**
+   * Provenance for a revert: the `version_number` this version's content
+   * was copied from. `None` for an ordinary edit.
+   */
+  restored_from?: number | null;
+  /**
+   * Monotonic version number within this unit, starting at 1. Unique per
+   * `(agent_text_unit_id, version_number)`; the DB constraint — not
+   * application code — is what rejects a duplicate under concurrent
+   * appends.
+   */
+  version_number: number;
+  [k: string]: unknown;
+}

package/src/generated/AgenticPhaseOutput.d.ts

@@ -34,6 +34,9 @@ export interface AgenticPhaseOutput {
    * Reflection fixes (when reflection_mode is enabled).
    */
   reflectionFixes: ReflectionFixOutput[];
+  /**
+   * Overall status of the agentic phase.
+   */
   status: AgenticStatus;
   /**
    * Human-readable summary of what was done.

package/src/generated/ApiAssertion.d.ts

@@ -31,5 +31,8 @@ export interface ApiAssertion {
    * Comparison operator; defaults to `equals` on the consumer side.
    */
   operator?: ApiAssertionOperator | null;
+  /**
+   * Kind of assertion.
+   */
   type: ApiAssertionType;
 }

package/src/generated/AssertionMiss.d.ts

@@ -18,5 +18,8 @@ export interface AssertionMiss {
    * descending.
    */
   candidates?: CandidateMiss[];
+  /**
+   * Coarse-grained classification of why the match failed.
+   */
   reason: MissReason;
 }

package/src/generated/AssertionOutcome.d.ts

@@ -19,11 +19,17 @@ import type { MissReason } from "./MissReason";
  */
 export type AssertionOutcome =
   | {
+      /**
+       * The element that satisfied the assertion.
+       */
       matched: MatchedElement;
       status: "pass";
       [k: string]: unknown;
     }
   | {
+      /**
+       * Diagnostic detail.
+       */
       miss: AssertionMiss;
       status: "fail";
       [k: string]: unknown;

package/src/generated/AssertionResult.d.ts

@@ -28,6 +28,9 @@ export interface AssertionResult {
    * Snapshot of `IrAssertion.description`.
    */
   description: string;
+  /**
+   * Pass / fail discriminator + payload.
+   */
   outcome: AssertionOutcome;
   /**
    * Free-form severity string — `"critical"` / `"error"` / `"warning"`

package/src/generated/BackendProfile.d.ts

@@ -11,6 +11,9 @@ import type { ApiStyle } from "./ApiStyle";
  * Target backend stack.
  */
 export interface BackendProfile {
+  /**
+   * REST vs GraphQL.
+   */
   apiStyle: ApiStyle;
   /**
    * Backend auth strategy (e.g. `"jwt"`, `"session"`). Free-form; `None` lets

package/src/generated/CommandStep.d.ts

@@ -104,6 +104,9 @@ export interface CommandStep {
    * Display name for the step.
    */
   name: string;
+  /**
+   * Phase in which the step appears.
+   */
   phase: CommandStepPhase;
   /**
    * Repository selector for repository-targeted steps.

package/src/generated/CompletenessVerdict.d.ts

@@ -61,6 +61,9 @@ export interface CompletenessVerdict {
    * re-dispatches generation for.
    */
   gaps?: CoverageGap[];
+  /**
+   * Overall node counts by provenance.
+   */
   provenanceMix: ProvenanceMix;
   /**
    * Per-section breakdown.

package/src/generated/ConjunctEvaluation.d.ts

@@ -20,5 +20,8 @@ export interface ConjunctEvaluation {
    * Snapshot of `PolicyConjunct.name`.
    */
   name: string;
+  /**
+   * Pass / fail / indeterminate.
+   */
   status: PolicyStatus;
 }

package/src/generated/ConjunctRule.d.ts

@@ -50,6 +50,9 @@ export type ConjunctRule =
     }
   | {
       kind: "match_outcome_at_least";
+      /**
+       * Minimum acceptable outcome.
+       */
       outcome: MatchOutcome;
       [k: string]: unknown;
     };

package/src/generated/Constraint.d.ts

@@ -12,6 +12,9 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  * A constraint definition.
  */
 export interface Constraint {
+  /**
+   * What to check.
+   */
   check: ConstraintCheck;
   /**
    * Why this constraint exists (shown to the AI on violation).
@@ -29,5 +32,8 @@ export interface Constraint {
    * Human-readable name.
    */
   name: string;
+  /**
+   * How severe a violation is.
+   */
   severity: ConstraintSeverity;
 }

package/src/generated/ConstraintProposal.d.ts

@@ -17,6 +17,9 @@ import type { ConstraintSeverity } from "./ConstraintSeverity";
  */
 export type ConstraintProposal =
   | {
+      /**
+       * The proposed constraint definition.
+       */
       constraint: Constraint;
       type: "new_constraint";
     }

package/src/generated/ConstraintResult.d.ts

@@ -24,6 +24,9 @@ export interface ConstraintResult {
    * Whether the constraint passed.
    */
   passed: boolean;
+  /**
+   * Severity of the constraint (for quick filtering).
+   */
   severity: ConstraintSeverity;
   /**
    * Details about the violation (empty if passed).

package/src/generated/CoverageGap.d.ts

@@ -18,13 +18,22 @@ export interface CoverageGap {
    * Free-form diagnostic detail (e.g. the verifier's near-miss explanation).
    */
   detail?: string | null;
+  /**
+   * Provenance of the gapped node — always `Observed` or `Inferred`.
+   */
   nodeProvenance: SpecProvenance;
+  /**
+   * Why it is uncovered.
+   */
   reason: GapReason;
   /**
    * Dotted ref into the spec, e.g. `"entities.Invoice.fields.amount"` or
    * `"operations.createInvoice"`.
    */
   ref: string;
+  /**
+   * Which section the gapped node belongs to.
+   */
   section: SpecSection;
   [k: string]: unknown;
 }

package/src/generated/CreateMcpServerInput.d.ts

@@ -44,5 +44,8 @@ export interface CreateMcpServerInput {
    * Override for the default `timeout_seconds = 30`.
    */
   timeoutSeconds?: number | null;
+  /**
+   * Transport selector.
+   */
   transport: McpTransport;
 }

package/src/generated/CreateScheduledTaskRequest.d.ts

@@ -50,6 +50,9 @@ export interface CreateScheduledTaskRequest {
    * Display name.
    */
   name: string;
+  /**
+   * Schedule configuration.
+   */
   schedule: ScheduleExpression;
   /**
    * Skip future runs once the task has succeeded.
@@ -59,5 +62,8 @@ export interface CreateScheduledTaskRequest {
    * Free-form success criteria description.
    */
   successCriteria?: string | null;
+  /**
+   * Task type and its per-type configuration.
+   */
   task: ScheduledTaskType;
 }

package/src/generated/DiscoveredElement.d.ts

@@ -36,6 +36,9 @@ export interface DiscoveredElement {
    * ARIA role attribute.
    */
   role?: string | null;
+  /**
+   * Current observable state.
+   */
   state: ElementState;
   /**
    * HTML tag name (e.g. `"BUTTON"`, `"INPUT"`).

package/src/generated/DiscoveredStateImage.d.ts

@@ -14,6 +14,9 @@ import type { DiscoveryBoundingBox } from "./DiscoveryBoundingBox";
  * optional pixel-level identification.
  */
 export interface DiscoveredStateImage {
+  /**
+   * Bounding box within the screenshot.
+   */
   bbox: DiscoveryBoundingBox;
   /**
    * Confidence score for this image (0.0–1.0). Defaults to `1.0`.

package/src/generated/ElementState.d.ts

@@ -53,6 +53,9 @@ export interface ElementState {
    * Whether the element currently has keyboard focus.
    */
   focused: boolean;
+  /**
+   * Bounding rectangle of the element.
+   */
   rect: ElementRect;
   /**
    * Currently selected options for `<select>` elements.

package/src/generated/EmbeddedElement.d.ts

@@ -16,6 +16,9 @@ import type { GUIElementChunk } from "./GUIElementChunk";
  * Mirrors `rag.models.EmbeddedElement`.
  */
 export interface EmbeddedElement {
+  /**
+   * The GUI element that was embedded.
+   */
   element: GUIElementChunk;
   /**
    * Model used for embedding.

package/src/generated/Entity.d.ts

@@ -13,6 +13,9 @@ import type { SpecProvenance } from "./SpecProvenance";
  * A domain entity inferred from rendered data shapes.
  */
 export interface Entity {
+  /**
+   * How this entity's existence was established.
+   */
   confidence: SpecProvenance;
   /**
    * Optional deduction strength ∈ [0,1]. Present only on `Inferred` nodes;

package/src/generated/ExecutionIssueCreate.d.ts

@@ -45,6 +45,9 @@ export interface ExecutionIssueCreate {
    * IDs of screenshots illustrating the issue.
    */
   screenshotIds?: string[] | null;
+  /**
+   * Severity.
+   */
   severity: IssueSeverity;
   /**
    * State ID active when the issue was observed.

package/src/generated/ExecutionIssueDetail.d.ts

@@ -44,6 +44,9 @@ export interface ExecutionIssueDetail {
    * Issue ID.
    */
   id: string;
+  /**
+   * Category label for the issue.
+   */
   issueType: IssueType;
   /**
    * Opaque additional metadata.
@@ -71,12 +74,21 @@ export interface ExecutionIssueDetail {
    * Full screenshot records associated with the issue.
    */
   screenshots?: ExecutionScreenshotResponse[];
+  /**
+   * Severity.
+   */
   severity: IssueSeverity;
+  /**
+   * Source that detected the issue.
+   */
   source: IssueSource;
   /**
    * State ID where the issue was observed, if any.
    */
   stateName?: string | null;
+  /**
+   * Current lifecycle status.
+   */
   status: IssueStatus;
   /**
    * Short title.

package/src/generated/ExecutionIssueListResponse.d.ts

@@ -16,6 +16,9 @@ export interface ExecutionIssueListResponse {
    * Page of matching issues.
    */
   issues: ExecutionIssueResponse[];
+  /**
+   * Pagination envelope.
+   */
   pagination: Pagination;
   /**
    * Summary keyed by severity or status. Shape is intentionally opaque.

package/src/generated/ExecutionRunComplete.d.ts

@@ -25,7 +25,13 @@ export interface ExecutionRunComplete {
    * Error message if the run failed.
    */
   errorMessage?: string | null;
+  /**
+   * Aggregate execution statistics.
+   */
   stats: ExecutionStats;
+  /**
+   * Final lifecycle status.
+   */
   status: RunStatus;
   /**
    * Free-form run summary.