@qontinui/shared-types 2.4.1 → 2.5.0

package/src/generated/MetricDistribution.d.ts

@@ -0,0 +1,54 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One metric over every sample. The order statistics are over the MEASURED
+ * values only (degraded ones included — their value stands) and are `null`
+ * when none was measured; `absent` and `unknownByCode` say what the rest
+ * were. `measured + absent + Σ unknownByCode + withoutTimeline = n`.
+ */
+export interface MetricDistribution {
+  /**
+   * Samples whose producer looked and found the thing did not occur.
+   */
+  absent: number;
+  /**
+   * Of those, how many were degraded (`coverage.unmeasured` non-empty).
+   */
+  degraded: number;
+  /**
+   * Largest measured value.
+   */
+  max?: number | null;
+  /**
+   * Samples with a measured value.
+   */
+  measured: number;
+  /**
+   * Nearest-rank 50th percentile (the lower middle value of an even count).
+   */
+  median?: number | null;
+  /**
+   * Smallest measured value.
+   */
+  min?: number | null;
+  /**
+   * Nearest-rank 90th percentile.
+   */
+  p90?: number | null;
+  /**
+   * Samples the producer could not answer, per `UnknownCode` wire value.
+   */
+  unknownByCode: {
+    [k: string]: number;
+  };
+  /**
+   * Samples with no timeline at all.
+   */
+  withoutTimeline: number;
+  [k: string]: unknown;
+}

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

@@ -80,6 +80,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 +114,50 @@ 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;
+}
+/**
+ * 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/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";

package/src/generated/SpecAcceptanceCriterion.d.ts

@@ -0,0 +1,28 @@
+/* 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";
+
+/**
+ * One acceptance criterion of a requirement or story.
+ */
+export interface SpecAcceptanceCriterion {
+  /**
+   * Stable within its artifact, e.g. `AC-1`.
+   */
+  id: string;
+  /**
+   * The observable condition, ideally an EARS sentence.
+   */
+  text: string;
+  /**
+   * How the criterion is checked. Required: a spec states it rather than
+   * inheriting a default.
+   */
+  verification: CriterionVerification;
+  [k: string]: unknown;
+}

package/src/generated/SpecFrontmatter.d.ts

@@ -0,0 +1,36 @@
+/* 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 { InterfaceMappingFrontmatter } from "./InterfaceMappingFrontmatter";
+import type { MappingRow } from "./MappingRow";
+import type { RequestFrontmatter } from "./RequestFrontmatter";
+import type { RequirementFrontmatter } from "./RequirementFrontmatter";
+import type { SourceCitation } from "./SourceCitation";
+import type { SourceCitationKind } from "./SourceCitationKind";
+import type { SpecAcceptanceCriterion } from "./SpecAcceptanceCriterion";
+import type { StoryFrontmatter } from "./StoryFrontmatter";
+import type { TemplateRef } from "./TemplateRef";
+
+/**
+ * The frontmatter of a spec artifact, tagged by its work-artifact `kind`.
+ */
+export type SpecFrontmatter =
+  | (RequestFrontmatter & {
+      kind: "request";
+    })
+  | (RequirementFrontmatter & {
+      kind: "requirement";
+    })
+  | (InterfaceMappingFrontmatter & {
+      kind: "interface_mapping";
+    })
+  | (StoryFrontmatter & {
+      kind: "story";
+    });

package/src/generated/SpecLanguage.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 natural language a spec artifact is written in.
+ */
+export type SpecLanguage = "en" | "de";

package/src/generated/StoryFrontmatter.d.ts

@@ -0,0 +1,26 @@
+/* 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 { ExternalRef } from "./ExternalRef";
+import type { SpecAcceptanceCriterion } from "./SpecAcceptanceCriterion";
+import type { TemplateRef } from "./TemplateRef";
+
+/**
+ * A user story.
+ */
+export interface StoryFrontmatter {
+  acceptance_criteria?: SpecAcceptanceCriterion[];
+  external_refs?: ExternalRef[];
+  id: string;
+  /**
+   * The `spec_ref`s of the requirements this story refines.
+   */
+  refines?: string[];
+  template?: TemplateRef | null;
+  [k: string]: unknown;
+}

package/src/generated/TemplateRef.d.ts

@@ -0,0 +1,17 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * The `prompt_template` document (and its version) an artifact was authored
+ * from — `spec-story` or a `spec-story-for-<lob>` variant, say — so a later
+ * template edit is traceable to the artifacts it affects.
+ */
+export interface TemplateRef {
+  name: string;
+  version: number;
+  [k: string]: unknown;
+}

package/src/generated/UnknownCode.d.ts

@@ -23,4 +23,11 @@ export type UnknownCode =
   | "below_confidence_floor"
   | "model_reply_unparseable"
   | "needs_multi_frame_input"
-  | "stale_input";
+  | "stale_input"
+  | "frontier_open"
+  | "ledger_schema_absent"
+  | "ledger_write_failing"
+  | "no_observations"
+  | "to_node_unobserved"
+  | "performance_observer_unsupported"
+  | "no_event_before_timeout";

package/src/generated/index.ts

@@ -65,12 +65,11 @@ export type { CacheProvenance } from './CacheProvenance';
 export type { CandidateMiss } from './CandidateMiss';
 export type { CanonicalStep } from './CanonicalStep';
 export type { CanvasPanel } from './CanvasPanel';
-export type { CapabilityState } from './CapabilityState';
 export type { CatchUpPolicy } from './CatchUpPolicy';
 export type { Category } from './Category';
+export type { ChangeTimeline } from './ChangeTimeline';
 export type { CheckIssueDetail } from './CheckIssueDetail';
 export type { CheckType } from './CheckType';
-export type { CliProfile } from './CliProfile';
 export type { CodeExecutionStep } from './CodeExecutionStep';
 export type { CommandMode } from './CommandMode';
 export type { CommandStep } from './CommandStep';
@@ -109,10 +108,12 @@ export type { CreateScheduledTaskRequest } from './CreateScheduledTaskRequest';
 export type { CreateTaskRunRequest } from './CreateTaskRunRequest';
 export type { CriterionOverride } from './CriterionOverride';
 export type { CriterionType } from './CriterionType';
+export type { CriterionVerification } from './CriterionVerification';
 export type { DagApprovalStep } from './DagApprovalStep';
 export type { DagCancelStep } from './DagCancelStep';
 export type { DagLoopStep } from './DagLoopStep';
 export type { DecomposerConfig } from './DecomposerConfig';
+export type { DetectedAnimation } from './DetectedAnimation';
 export type { DevSeedFindingPayload } from './DevSeedFindingPayload';
 export type { DeviceBranchSummary } from './DeviceBranchSummary';
 export type { DiagnosePhaseConfig } from './DiagnosePhaseConfig';
@@ -131,6 +132,8 @@ export type { DisplayNode } from './DisplayNode';
 export type { DomainAssignment } from './DomainAssignment';
 export type { DomainKnowledge } from './DomainKnowledge';
 export type { DomainVerificationResult } from './DomainVerificationResult';
+export type { EarsPattern } from './EarsPattern';
+export type { EdgeTiming } from './EdgeTiming';
 export type { EffectCheckStep } from './EffectCheckStep';
 export type { ElementActionRequest } from './ElementActionRequest';
 export type { ElementBbox } from './ElementBbox';
@@ -175,6 +178,7 @@ export type { ExitCheckResult } from './ExitCheckResult';
 export type { ExitStrategy } from './ExitStrategy';
 export type { ExportResult } from './ExportResult';
 export type { ExtendIterationsRequest } from './ExtendIterationsRequest';
+export type { ExternalRef } from './ExternalRef';
 export type { FieldDiff } from './FieldDiff';
 export type { FileChange } from './FileChange';
 export type { FilterNarrowing } from './FilterNarrowing';
@@ -226,6 +230,7 @@ export type { ImplementFixesConfig } from './ImplementFixesConfig';
 export type { IndividualCheckResult } from './IndividualCheckResult';
 export type { InitialStateRef } from './InitialStateRef';
 export type { InitialStatesSource } from './InitialStatesSource';
+export type { InterfaceMappingFrontmatter } from './InterfaceMappingFrontmatter';
 export type { IrAssertion } from './IrAssertion';
 export type { IrAssertionTarget } from './IrAssertionTarget';
 export type { IrCrossRef } from './IrCrossRef';
@@ -249,10 +254,24 @@ export type { JobItem } from './JobItem';
 export type { JobListResponse } from './JobListResponse';
 export type { JobStatus } from './JobStatus';
 export type { JobSummary } from './JobSummary';
+export type { JourneyArrivalDoubt } from './JourneyArrivalDoubt';
+export type { JourneyCoverage } from './JourneyCoverage';
+export type { JourneyDeadEnds } from './JourneyDeadEnds';
 export type { JourneyEdgeObservation } from './JourneyEdgeObservation';
+export type { JourneyEdgeTimingAnswer } from './JourneyEdgeTimingAnswer';
+export type { JourneyFilter } from './JourneyFilter';
+export type { JourneyFrontier } from './JourneyFrontier';
+export type { JourneyGraph } from './JourneyGraph';
+export type { JourneyGraphEdge } from './JourneyGraphEdge';
 export type { JourneyLedgerHealth } from './JourneyLedgerHealth';
 export type { JourneyNode } from './JourneyNode';
+export type { JourneyPriorKnowledge } from './JourneyPriorKnowledge';
+export type { JourneyReachable } from './JourneyReachable';
+export type { JourneySearchFrontier } from './JourneySearchFrontier';
+export type { JourneySearchFrontierNode } from './JourneySearchFrontierNode';
+export type { JourneySteps } from './JourneySteps';
 export type { JourneyTrigger } from './JourneyTrigger';
+export type { JourneyUnmeasuredDepartures } from './JourneyUnmeasuredDepartures';
 export type { LLMCostSummary } from './LLMCostSummary';
 export type { LLMMetrics } from './LLMMetrics';
 export type { LegacyAssertion } from './LegacyAssertion';
@@ -266,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 { MappingRow } from './MappingRow';
 export type { MatchAdjustment } from './MatchAdjustment';
 export type { MatchLocation } from './MatchLocation';
 export type { MatchMethod } from './MatchMethod';
@@ -288,6 +308,7 @@ export type { MemorySummary } from './MemorySummary';
 export type { MemoryUpsertRequest } from './MemoryUpsertRequest';
 export type { MemoryUpsertResponse } from './MemoryUpsertResponse';
 export type { MemoryWithHistory } from './MemoryWithHistory';
+export type { MetricDistribution } from './MetricDistribution';
 export type { MissReason } from './MissReason';
 export type { ModelCostBreakdown } from './ModelCostBreakdown';
 export type { ModelOverrideConfig } from './ModelOverrideConfig';
@@ -365,6 +386,8 @@ export type { RegisterAppRequest } from './RegisterAppRequest';
 export type { Relationship } from './Relationship';
 export type { RepositoryInactiveCondition } from './RepositoryInactiveCondition';
 export type { RepositoryWatch } from './RepositoryWatch';
+export type { RequestFrontmatter } from './RequestFrontmatter';
+export type { RequirementFrontmatter } from './RequirementFrontmatter';
 export type { ResolvedInitialStates } from './ResolvedInitialStates';
 export type { ResolvedInitialStatesResult } from './ResolvedInitialStatesResult';
 export type { ResourceLimits } from './ResourceLimits';
@@ -412,9 +435,11 @@ export type { SearchStrategy } from './SearchStrategy';
 export type { SectionVerdict } from './SectionVerdict';
 export type { SemanticSearchRequest } from './SemanticSearchRequest';
 export type { SemanticSearchResponse } from './SemanticSearchResponse';
-export type { SessionFailure } from './SessionFailure';
 export type { SessionLite } from './SessionLite';
 export type { SessionSource } from './SessionSource';
+export type { SourceCitation } from './SourceCitation';
+export type { SourceCitationKind } from './SourceCitationKind';
+export type { SpecAcceptanceCriterion } from './SpecAcceptanceCriterion';
 export type { SpecApiEvent } from './SpecApiEvent';
 export type { SpecCheckConfidence } from './SpecCheckConfidence';
 export type { SpecCheckPolicy } from './SpecCheckPolicy';
@@ -422,6 +447,8 @@ export type { SpecCheckResult } from './SpecCheckResult';
 export type { SpecCheckStep } from './SpecCheckStep';
 export type { SpecCheckStepConfig } from './SpecCheckStepConfig';
 export type { SpecCheckSummary } from './SpecCheckSummary';
+export type { SpecFrontmatter } from './SpecFrontmatter';
+export type { SpecLanguage } from './SpecLanguage';
 export type { SpecProvenance } from './SpecProvenance';
 export type { SpecSection } from './SpecSection';
 export type { SpecTarget } from './SpecTarget';
@@ -457,6 +484,7 @@ export type { StateNodeData } from './StateNodeData';
 export type { StatesResponse } from './StatesResponse';
 export type { StdioConfig } from './StdioConfig';
 export type { StepExecutionConfig } from './StepExecutionConfig';
+export type { StoryFrontmatter } from './StoryFrontmatter';
 export type { StructuredFinding } from './StructuredFinding';
 export type { StructuredOverride } from './StructuredOverride';
 export type { StructuredSignal } from './StructuredSignal';
@@ -485,6 +513,7 @@ export type { TaskRunSession } from './TaskRunSession';
 export type { TaskRunStatus } from './TaskRunStatus';
 export type { TaskRunUpdate } from './TaskRunUpdate';
 export type { TaskType } from './TaskType';
+export type { TemplateRef } from './TemplateRef';
 export type { TerminalExitEvent } from './TerminalExitEvent';
 export type { TerminalInfo } from './TerminalInfo';
 export type { TerminalOutputEvent } from './TerminalOutputEvent';

package/src/generated/CapabilityState.d.ts

@@ -1,25 +0,0 @@
-/* eslint-disable */
-/**
- * This file was automatically generated.
- * DO NOT MODIFY IT BY HAND. Regenerate with
- * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
- */
-
-/**
- * Three-valued capability fact.
- *
- * `Unknown` is the default for anything a profile or catalog does not state.
- * It is a distinct value from `Unsupported` on purpose: a boolean cannot
- * represent "we never asked", and coercing that to "no" silently disables
- * working capabilities.
- *
- * Moved here from qontinui-runner `src-tauri/src/model_catalog.rs` so the
- * model/API layer (`ModelFacts`) and the CLI-session layer ([`CliProfile`])
- * speak one tri-state; `model_catalog` re-exports it. Serialized as
- * `"supported"` / `"unsupported"` / `"unknown"`.
- *
- * [`CapabilityState::Unknown`] must never be a reason to strip content or
- * refuse a route. Callers that must act on an unknown fact should attempt the
- * capability and let the backend be the authority.
- */
-export type CapabilityState = "supported" | "unsupported" | "unknown";