@qontinui/shared-types 2.4.1 → 3.0.0

package/src/generated/JourneyGraphEdge.d.ts

@@ -0,0 +1,45 @@
+/* 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 { JourneyTrigger } from "./JourneyTrigger";
+
+/**
+ * Every observation of one `(from, to, trigger, outcome)` combination,
+ * aggregated. `to_node_unobserved` rows are not graph edges (they have no
+ * destination); they count on the from-node's `unobservedDepartures`.
+ */
+export interface JourneyGraphEdge {
+  /**
+   * Earliest `observedAt` among them, RFC 3339 UTC.
+   */
+  firstObservedAt: string;
+  /**
+   * `fromNode.key()`.
+   */
+  fromKey: string;
+  /**
+   * Latest `observedAt` among them, RFC 3339 UTC.
+   */
+  lastObservedAt: string;
+  /**
+   * How many ledger rows this edge aggregates (≥ 1).
+   */
+  observations: number;
+  /**
+   * How the edge closed.
+   */
+  outcome:
+    "changed" | "no_change" | "error" | "settle_timeout" | "to_node_unobserved";
+  /**
+   * `toNode.key()`.
+   */
+  toKey: string;
+  /**
+   * The trigger, exactly as recorded — enough to replay the step.
+   */
+  trigger: JourneyTrigger;
+}

package/src/generated/JourneyPriorKnowledge.d.ts

@@ -0,0 +1,112 @@
+/* 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 { FrontierEntry } from "./FrontierEntry";
+import type { JourneyArrivalDoubt } from "./JourneyArrivalDoubt";
+import type { JourneyCoverage } from "./JourneyCoverage";
+import type { JourneyFilter } from "./JourneyFilter";
+import type { JourneyLedgerHealth } from "./JourneyLedgerHealth";
+import type { JourneyNode } from "./JourneyNode";
+import type { JourneySearchFrontier } from "./JourneySearchFrontier";
+import type { JourneySearchFrontierNode } from "./JourneySearchFrontierNode";
+import type { JourneyUnmeasuredDepartures } from "./JourneyUnmeasuredDepartures";
+
+/**
+ * The answer of [`requires_prior_knowledge`].
+ */
+export interface JourneyPriorKnowledge {
+  /**
+   * The graph's coverage.
+   */
+  coverage: JourneyCoverage;
+  /**
+   * The graph's filter.
+   */
+  filterEcho: JourneyFilter;
+  /**
+   * What the whole graph did not look at. A listed node never rests on an
+   * open frontier (any open entry moves every candidate to `unsettled`);
+   * this block is what the NEGATIVE about the rest — "no other node
+   * requires prior knowledge" — is unknown over unless it is settled.
+   */
+  frontier: JourneySearchFrontier;
+  /**
+   * Nodes that require prior knowledge, settled: they qualify, nothing
+   * the graph left out could reach them by a click or a back button, no
+   * affordance anywhere is still unexplored, and the ledger is `writing`.
+   * Sorted by key.
+   */
+  nodes: JourneyPriorKnowledgeNode[];
+  /**
+   * Nodes that qualify on their kept arrivals but cannot be settled, with
+   * the causes that could still reach them. Sorted by key.
+   */
+  unsettled: JourneyPriorKnowledgeUnsettledNode[];
+}
+/**
+ * A node users only ever arrived at without clicking anything.
+ */
+export interface JourneyPriorKnowledgeNode {
+  /**
+   * Observed arrivals per navigation trigger (`initial`, `push`,
+   * `replace`, `hash` only — by definition).
+   */
+  arrivals: {
+    [k: string]: number;
+  };
+  /**
+   * The node.
+   */
+  nodeKey: string;
+}
+/**
+ * A node that qualifies on its KEPT arrivals, but that some row the graph
+ * left out could still reach by a click or a back button — so whether it
+ * requires prior knowledge is unknown.
+ */
+export interface JourneyPriorKnowledgeUnsettledNode {
+  /**
+   * Excluded (filtered / withdrawn) affordance or pop arrivals into it.
+   */
+  arrivalDoubt: JourneyArrivalDoubt;
+  /**
+   * Its kept URL-trigger arrivals, as in [`JourneyPriorKnowledgeNode`].
+   */
+  arrivals: {
+    [k: string]: number;
+  };
+  /**
+   * The ledger is not `writing`: a click into this node may simply have
+   * failed to be recorded.
+   */
+  ledgerNotWriting: boolean;
+  /**
+   * The node.
+   */
+  nodeKey: string;
+  /**
+   * Open frontier entries across the WHOLE graph — listable ones, rejected
+   * ones placed at a node, and unplaced rejected ones, each row once. An
+   * affordance nobody activated anywhere may be the link into this node.
+   */
+  openFrontierEntries: number;
+  /**
+   * No observed arrival at this node closed `changed` or `no_change`
+   * ([`JourneyGraphNode::unconfirmed_destination`]): it may be an
+   * intermediate state, not a page a URL leads to.
+   */
+  unconfirmedDestination: boolean;
+  /**
+   * [`JourneyGraph::unknown_destination_arrivals`] — any of them may
+   * arrive here.
+   */
+  unknownDestinationArrivals: number;
+  /**
+   * [`JourneyGraph::unplaced_rejected_rows`] — any of them may arrive here.
+   */
+  unplacedRejectedRows: number;
+}

package/src/generated/JourneyReachable.d.ts

@@ -0,0 +1,64 @@
+/* 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 { FrontierEntry } from "./FrontierEntry";
+import type { JourneyCoverage } from "./JourneyCoverage";
+import type { JourneyFilter } from "./JourneyFilter";
+import type { JourneyLedgerHealth } from "./JourneyLedgerHealth";
+import type { JourneyNode } from "./JourneyNode";
+import type { JourneySearchFrontier } from "./JourneySearchFrontier";
+import type { JourneySearchFrontierNode } from "./JourneySearchFrontierNode";
+import type { JourneyUnmeasuredDepartures } from "./JourneyUnmeasuredDepartures";
+
+/**
+ * The answer of [`reachable_from`].
+ */
+export interface JourneyReachable {
+  /**
+   * The graph's coverage.
+   */
+  coverage: JourneyCoverage;
+  /**
+   * The graph's filter.
+   */
+  filterEcho: JourneyFilter;
+  /**
+   * The start node's key.
+   */
+  fromKey: string;
+  /**
+   * Whether the start node was observed at all. `false` means the
+   * question was asked about a node the ledger has never seen — the
+   * caller answers `unknown` (`no_observations`), never "reaches nothing".
+   */
+  fromObserved: boolean;
+  /**
+   * What the searched component (exactly the `reachable` nodes) did not
+   * look at. Unsettled ⇒ "X is not reachable" is unknown.
+   */
+  frontier: JourneySearchFrontier;
+  /**
+   * Every node reachable from the start, INCLUDING the start at 0 steps
+   * (empty when `fromObserved` is false), sorted by key.
+   */
+  reachable: JourneyReachedNode[];
+}
+/**
+ * A node reached, and its BFS distance.
+ */
+export interface JourneyReachedNode {
+  /**
+   * The node.
+   */
+  nodeKey: string;
+  /**
+   * Shortest OBSERVED number of navigation edges from the start (0 = the
+   * start) — an upper bound on the true distance while the frontier is
+   * unsettled.
+   */
+  steps: number;
+}

package/src/generated/JourneySearchFrontier.d.ts

@@ -0,0 +1,59 @@
+/* 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 { FrontierEntry } from "./FrontierEntry";
+import type { JourneyNode } from "./JourneyNode";
+import type { JourneySearchFrontierNode } from "./JourneySearchFrontierNode";
+import type { JourneyUnmeasuredDepartures } from "./JourneyUnmeasuredDepartures";
+
+/**
+ * What the searched part of the graph did NOT look at. Empty
+ * ([`Self::is_settled`]) means a negative answer over that part is a real
+ * negative; otherwise it is unknown.
+ */
+export interface JourneySearchFrontier {
+  /**
+   * Open frontier entries per reason — every reason present, zeros
+   * included.
+   */
+  byReason: {
+    [k: string]: number;
+  };
+  /**
+   * Nodes with open frontier entries, unobserved departures or unmeasured
+   * departures, sorted by key.
+   */
+  nodes: JourneySearchFrontierNode[];
+  /**
+   * The off-graph part included in `unmeasuredDepartures` (all zero for a
+   * question about one component).
+   */
+  offGraphDepartures: JourneyUnmeasuredDepartures;
+  /**
+   * Open frontier entries across those nodes.
+   */
+  openEntries: number;
+  /**
+   * Unmeasured departures across those nodes, plus — for a graph-wide
+   * question — `offGraphDepartures`.
+   */
+  unmeasuredDepartures: JourneyUnmeasuredDepartures;
+  /**
+   * Unobserved departures across those nodes.
+   */
+  unobservedDepartures: number;
+  /**
+   * Rejected frontier rows that could not be placed at any node (counted
+   * by every question).
+   */
+  unplacedRejectedFrontier: number;
+  /**
+   * Untrusted edge rows that could not be placed at any node (counted by
+   * every question).
+   */
+  unplacedRejectedRows: number;
+}

package/src/generated/JourneySearchFrontierNode.d.ts

@@ -0,0 +1,37 @@
+/* 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 { FrontierEntry } from "./FrontierEntry";
+import type { JourneyNode } from "./JourneyNode";
+import type { JourneyUnmeasuredDepartures } from "./JourneyUnmeasuredDepartures";
+
+/**
+ * One node, inside a query's searched component, that was not fully looked
+ * at.
+ */
+export interface JourneySearchFrontierNode {
+  /**
+   * The node.
+   */
+  nodeKey: string;
+  /**
+   * Its open frontier entries, grouped by reason (only reasons present),
+   * each list sorted by `affordanceFingerprint` — the affordances that
+   * would have to be explored to settle the question.
+   */
+  openByReason: {
+    [k: string]: FrontierEntry[];
+  };
+  /**
+   * Departures from it the navigation edge set left out.
+   */
+  unmeasuredDepartures: JourneyUnmeasuredDepartures;
+  /**
+   * Departures from it whose destination was never observed.
+   */
+  unobservedDepartures: number;
+}

package/src/generated/JourneySteps.d.ts

@@ -0,0 +1,65 @@
+/* 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 { FrontierEntry } from "./FrontierEntry";
+import type { JourneyCoverage } from "./JourneyCoverage";
+import type { JourneyFilter } from "./JourneyFilter";
+import type { JourneyGraphEdge } from "./JourneyGraphEdge";
+import type { JourneyLedgerHealth } from "./JourneyLedgerHealth";
+import type { JourneyNode } from "./JourneyNode";
+import type { JourneySearchFrontier } from "./JourneySearchFrontier";
+import type { JourneySearchFrontierNode } from "./JourneySearchFrontierNode";
+import type { JourneyTrigger } from "./JourneyTrigger";
+import type { JourneyUnmeasuredDepartures } from "./JourneyUnmeasuredDepartures";
+
+/**
+ * The answer of [`steps_to`].
+ */
+export interface JourneySteps {
+  /**
+   * The graph's coverage.
+   */
+  coverage: JourneyCoverage;
+  /**
+   * The graph's filter.
+   */
+  filterEcho: JourneyFilter;
+  /**
+   * The start node's key.
+   */
+  fromKey: string;
+  /**
+   * Whether the start node was observed.
+   */
+  fromObserved: boolean;
+  /**
+   * What the component reachable from the start did not look at.
+   */
+  frontier: JourneySearchFrontier;
+  /**
+   * The edges of one shortest path, in order (empty when `steps` is null
+   * or 0). Among equally short paths, the one whose next node key is
+   * byte-wise smallest at every step; between parallel edges, the
+   * smallest edge in graph order.
+   */
+  path: JourneyGraphEdge[];
+  /**
+   * Shortest OBSERVED number of navigation edges from start to target — an
+   * upper bound on the true distance while the frontier is unsettled;
+   * `null` = no observed path (which is a negative only when `frontier` is settled and
+   * both endpoints were observed).
+   */
+  steps?: number | null;
+  /**
+   * The target node's key.
+   */
+  toKey: string;
+  /**
+   * Whether the target node was observed.
+   */
+  toObserved: boolean;
+}

package/src/generated/JourneyUnmeasuredDepartures.d.ts

@@ -0,0 +1,84 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Departures from one node that the NAVIGATION edge set (affordance +
+ * `changed`) leaves out, yet that may still lead somewhere — so a negative
+ * answer over a component containing the node stays `unknown`, never
+ * `absent`. The navigation counters count only `affordance`-triggered rows
+ * (a typed URL is not a way the app offers); excluded back-button (`pop`)
+ * rows have their own counter, [`Self::excluded_back_arrivals`]. A filtered
+ * or withdrawn click or back that closed `no_change`, or `error` on its own
+ * node, is never counted: that exclusion is a genuine negative (a URL-trigger
+ * row never is one). (A REJECTED row is not counted here at all: nothing in it is
+ * trusted, so it is placed at no node — see
+ * [`JourneyGraph::unplaced_rejected_rows`].) Each counter is its own
+ * `coverage.unmeasured` dimension — see [`JourneySearchFrontier::unmeasured`]
+ * for the dimension names and codes.
+ */
+export interface JourneyUnmeasuredDepartures {
+  /**
+   * `error` edges to a DIFFERENT node: the action errored yet the
+   * configuration moved. Dimension `errored_departures`.
+   */
+  errored: number;
+  /**
+   * Back-button (`pop`) rows from this node that are not a kept, changed
+   * exit: valid `pop` rows the filter excluded or that were withdrawn
+   * (unless a genuine negative: `no_change`, or `error` on its own node),
+   * kept `pop` edges to ANOTHER node whose outcome is `error` or
+   * `settle_timeout`, and kept `pop` self-loops that closed
+   * `settle_timeout` (the same rules as an affordance edge's). A REJECTED pop row is not here — nothing in a rejected row
+   * is trusted, so it counts in `JourneyGraph::unplaced_rejected_rows`.
+   * Not a navigation
+   * departure, so a question about one component ignores it; the
+   * graph-wide questions it can change — `dead_ends`' `backOnly`,
+   * `requires_prior_knowledge`, the whole frontier — count it. Dimension
+   * `excluded_back_arrivals`.
+   */
+  excludedBackArrivals: number;
+  /**
+   * Valid URL-trigger rows (`initial` / `push` / `replace` / `hash`) from
+   * this node that the filter excluded or that were withdrawn, WHATEVER
+   * their outcome (a URL row is an arrival, never a genuine negative). A typed URL is not a navigation departure, so a question
+   * about one component ignores it; but it is an ARRIVAL that decides
+   * `requires_prior_knowledge`, and it may reveal a node no kept row
+   * shows, so the graph-wide questions (`requires_prior_knowledge`,
+   * `dead_ends`, the whole frontier) count it. Dimension
+   * `excluded_url_arrivals`.
+   */
+  excludedUrlArrivals: number;
+  /**
+   * Live, valid affordance rows the request's filter (`since` /
+   * `appVersion` / `runKind`) excluded, unless they are a genuine negative
+   * (`no_change`, or `error` on their own node). Dimension
+   * `filtered_departures`.
+   */
+  filteredOut: number;
+  /**
+   * Frontier rows at this node that failed `validate()` — treated as OPEN
+   * entries the read cannot list. A row whose `nodeKey` column disagrees
+   * with its `node` is counted at BOTH keys (the column's, and the valid
+   * node's), since either may be the true one. Dimension
+   * `rejected_frontier`.
+   */
+  rejectedFrontier: number;
+  /**
+   * Affordance edges that closed `settle_timeout` — to a DIFFERENT node
+   * (the destination may be an intermediate render), or to the SAME node
+   * (the destination may not have rendered before the snapshot). Not a
+   * navigation step, but not a negative either. Dimension
+   * `settle_timeout_departures`.
+   */
+  settleTimeout: number;
+  /**
+   * Withdrawn affordance rows (`invalidatedAt` set) that pass `validate()`,
+   * unless they are a genuine negative (`no_change`, or `error` on their
+   * own node). Dimension `withdrawn_departures`.
+   */
+  withdrawn: number;
+}

package/src/generated/ManagedBy.d.ts

@@ -0,0 +1,45 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * 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/MappingRow.d.ts

@@ -0,0 +1,23 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * One row of an interface mapping.
+ */
+export interface MappingRow {
+  /**
+   * The business rule or requirement (`spec_ref`) the row implements.
+   */
+  rule_ref?: string | null;
+  source_field: string;
+  target_field: string;
+  /**
+   * The transformation applied, in prose or a short expression.
+   */
+  transform?: string | null;
+  [k: string]: unknown;
+}

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/RecurringAgentDispatchRole.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 device's dispatch role, in coord's vocabulary (`dispatch_role.rs`).
+ */
+export type RecurringAgentDispatchRole = "workhorse" | "bench" | "ci_node";

package/src/generated/RecurringAgentExcludedValue.d.ts

@@ -0,0 +1,20 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * An [`RecurringAgentParamKind::IntegerSet`] value the entry refuses.
+ */
+export interface RecurringAgentExcludedValue {
+  /**
+   * Why it is refused.
+   */
+  reason: string;
+  /**
+   * The refused value.
+   */
+  value: number;
+}

package/src/generated/RecurringAgentOs.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`.
+ */
+
+/**
+ * An operating system a [`RecurringAgentTarget::Os`] target selects.
+ */
+export type RecurringAgentOs = "linux" | "windows" | "macos";

package/src/generated/RecurringAgentOverride.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 { RepositoryInactiveCondition } from "./RepositoryInactiveCondition";
+import type { RepositoryWatch } from "./RepositoryWatch";
+import type { ScheduleConditions } from "./ScheduleConditions";
+import type { ScheduleExpression } from "./ScheduleExpression";
+import type { ScheduledTaskType } from "./ScheduledTaskType";
+
+/**
+ * A local override of a managed task on one machine (plan D6), stored by the
+ * runner and reported to coord so the web shows it. Only the fields set are
+ * overridden; the rest follow the fleet declaration.
+ */
+export interface RecurringAgentOverride {
+  /**
+   * Replacement conditions (e.g. require idle / repo inactive).
+   */
+  conditions?: ScheduleConditions | null;
+  /**
+   * ISO 8601 timestamp when the override was made.
+   */
+  created_at: string;
+  /**
+   * Free-form note from whoever made the override.
+   */
+  note?: string | null;
+  /**
+   * Replacement schedule.
+   */
+  schedule?: ScheduleExpression | null;
+  /**
+   * Replacement task.
+   */
+  task?: ScheduledTaskType | null;
+  /**
+   * Replacement IANA time zone.
+   */
+  timezone?: string | null;
+}