@o11y-one/api-agentic 0.0.0

package/dist/o11y_one/agentic/v1/agent_run_pb.d.ts

@@ -0,0 +1,826 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { AgenticEvaluationCapabilitiesV1, EvaluationFreshnessV1, MetricAvailabilityV1, PrincipalRefV1 } from "./evaluation_pb.js";
+import type { EvidenceAnchorV1 } from "./artifact_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file o11y_one/agentic/v1/agent_run.proto.
+ */
+export declare const file_o11y_one_agentic_v1_agent_run: GenFile;
+/**
+ * `P7-3`, verbatim in its four required fields: confidence carries its INPUTS,
+ * not just its verdict, so "explain confidence" is a rendering of returned data
+ * and never a frontend heuristic.
+ *
+ * @generated from message o11y_one.agentic.v1.GroupingConfidenceInputV1
+ */
+export type GroupingConfidenceInputV1 = Message<"o11y_one.agentic.v1.GroupingConfidenceInputV1"> & {
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingSignalKindV1 signal_kind = 1;
+     */
+    signalKind: AgentRunGroupingSignalKindV1;
+    /**
+     * How many member traces this signal was observed on.
+     *
+     * @generated from field: uint32 observed_on_member_count = 2;
+     */
+    observedOnMemberCount: number;
+    /**
+     * How many member traces the run has. `observed == total` is what separates
+     * rung 1 from rung 2.
+     *
+     * @generated from field: uint32 total_member_count = 3;
+     */
+    totalMemberCount: number;
+    /**
+     * The rung this signal contributed. Present on every input, including inputs
+     * that did NOT win: a reader can see that a secondary identity agreed with the
+     * official one rather than only that the official one was used.
+     *
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingConfidenceV1 contributed_rung = 4;
+     */
+    contributedRung: AgentRunGroupingConfidenceV1;
+    /**
+     * The fifth field, and not decoration. It is the only place the span-link
+     * posture can be told per run rather than per deployment: `_DEGRADED` with
+     * `span_link_attributes_dropped_at_ingest` says this signal is adjacency and
+     * not a stated relationship.
+     *
+     * @generated from field: o11y_one.agentic.v1.MetricAvailabilityV1 availability = 5;
+     */
+    availability?: MetricAvailabilityV1 | undefined;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.GroupingConfidenceInputV1.
+ * Use `create(GroupingConfidenceInputV1Schema)` to create a new message.
+ */
+export declare const GroupingConfidenceInputV1Schema: GenMessage<GroupingConfidenceInputV1>;
+/**
+ * `P7-6`. Returned by ANY read addressed with a non-`_CURRENT` id, alongside the
+ * canonical run's content. Never instead of it, and never a `NOT_FOUND`.
+ *
+ * @generated from message o11y_one.agentic.v1.GroupingRedirectV1
+ */
+export type GroupingRedirectV1 = Message<"o11y_one.agentic.v1.GroupingRedirectV1"> & {
+    /**
+     * The id the caller asked for.
+     *
+     * @generated from field: string from_id = 1;
+     */
+    fromId: string;
+    /**
+     * Where it went. Exactly one for a merge or a plain redirect; two or more for
+     * a split, which is why this is repeated rather than optional.
+     *
+     * @generated from field: repeated string to_ids = 2;
+     */
+    toIds: string[];
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingRedirectReasonV1 reason = 3;
+     */
+    reason: AgentRunGroupingRedirectReasonV1;
+    /**
+     * The grouping revision at which the move happened.
+     *
+     * @generated from field: uint64 revision = 4;
+     */
+    revision: bigint;
+    /**
+     * @generated from field: google.protobuf.Timestamp occurred_at = 5;
+     */
+    occurredAt?: Timestamp | undefined;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.GroupingRedirectV1.
+ * Use `create(GroupingRedirectV1Schema)` to create a new message.
+ */
+export declare const GroupingRedirectV1Schema: GenMessage<GroupingRedirectV1>;
+/**
+ * The bounds, published as numbers on every run rather than described in prose
+ * on a capability nobody fetched.
+ *
+ * `P7-2` locks the RULE that three bounds exist and that breach means
+ * split-not-merge; the numbers are this lane's, and they are here so a client
+ * rendering "this group was split" can say what it was split by.
+ *
+ * @generated from message o11y_one.agentic.v1.AgentRunGroupingBoundsV1
+ */
+export type AgentRunGroupingBoundsV1 = Message<"o11y_one.agentic.v1.AgentRunGroupingBoundsV1"> & {
+    /**
+     * Rung-4 bound 1: the most member traces a heuristic group may hold.
+     *
+     * @generated from field: uint32 max_member_traces = 1;
+     */
+    maxMemberTraces: number;
+    /**
+     * Rung-4 bound 2: the widest wall clock a heuristic group may span.
+     *
+     * @generated from field: uint64 max_wall_clock_seconds = 2;
+     */
+    maxWallClockSeconds: bigint;
+    /**
+     * Rung-4 bound 3: the longest silence between two members of one heuristic
+     * group. Deliberately EQUAL to the completeness inactivity window, so "this
+     * conversation went quiet" and "these are not the same conversation" cannot
+     * disagree about the same silence.
+     *
+     * @generated from field: uint64 max_inactivity_gap_seconds = 3;
+     */
+    maxInactivityGapSeconds: bigint;
+    /**
+     * The plane's own edge, not this surface's choice:
+     * `trace_partition_pruning_range` clamps every trace query to fourteen days.
+     *
+     * @generated from field: uint32 max_lookback_hours = 4;
+     */
+    maxLookbackHours: number;
+    /**
+     * The trace viewer's whole refusal, per MEMBER trace.
+     *
+     * @generated from field: uint32 max_spans_per_member_trace = 5;
+     */
+    maxSpansPerMemberTrace: number;
+    /**
+     * `max_member_traces` × `max_spans_per_member_trace`, published as a number
+     * because a member ceiling a client has to multiply out is a ceiling it will
+     * get wrong.
+     *
+     * @generated from field: uint64 max_member_span_ceiling = 6;
+     */
+    maxMemberSpanCeiling: bigint;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.AgentRunGroupingBoundsV1.
+ * Use `create(AgentRunGroupingBoundsV1Schema)` to create a new message.
+ */
+export declare const AgentRunGroupingBoundsV1Schema: GenMessage<AgentRunGroupingBoundsV1>;
+/**
+ * The audited promotion, attached to the run it promoted.
+ *
+ * @generated from message o11y_one.agentic.v1.AgentRunGroupingConfirmationV1
+ */
+export type AgentRunGroupingConfirmationV1 = Message<"o11y_one.agentic.v1.AgentRunGroupingConfirmationV1"> & {
+    /**
+     * @generated from field: o11y_one.agentic.v1.PrincipalRefV1 confirmed_by = 1;
+     */
+    confirmedBy?: PrincipalRefV1 | undefined;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingConfirmationReasonV1 reason = 2;
+     */
+    reason: AgentRunGroupingConfirmationReasonV1;
+    /**
+     * @generated from field: optional string reason_note = 3;
+     */
+    reasonNote?: string | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp confirmed_at = 4;
+     */
+    confirmedAt?: Timestamp | undefined;
+    /**
+     * The revision the confirmation minted. A confirmation is a grouping change
+     * like any other, so it advances the revision and appears in the audit chain.
+     *
+     * @generated from field: uint64 revision = 5;
+     */
+    revision: bigint;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.AgentRunGroupingConfirmationV1.
+ * Use `create(AgentRunGroupingConfirmationV1Schema)` to create a new message.
+ */
+export declare const AgentRunGroupingConfirmationV1Schema: GenMessage<AgentRunGroupingConfirmationV1>;
+/**
+ * `P7-7` on the wire: what happened to the evidence anchored to this run.
+ *
+ * "Confirmed links survive a merge or a split" is a promise that is unfalsifiable
+ * unless the move is visible. An operator who linked a dataset draft to a run and
+ * then watched that run merge has exactly one question — *did my link follow?* —
+ * and this is the answer, as data rather than as documentation.
+ *
+ * `anchor` is the SAME `EvidenceAnchorV1` every other plane addresses evidence
+ * with (A1 §4.5, twelve arms, arm 7 `agent_run`), reused rather than twinned.
+ * `original_agent_run_id` is written once and never overwritten: the audit chain
+ * is the point, and a chain whose first link is editable is not a chain.
+ *
+ * @generated from message o11y_one.agentic.v1.AgentRunAnchorRebindV1
+ */
+export type AgentRunAnchorRebindV1 = Message<"o11y_one.agentic.v1.AgentRunAnchorRebindV1"> & {
+    /**
+     * @generated from field: o11y_one.agentic.v1.EvidenceAnchorV1 anchor = 1;
+     */
+    anchor?: EvidenceAnchorV1 | undefined;
+    /**
+     * The run the anchor was FIRST created against. Immutable.
+     *
+     * @generated from field: string original_agent_run_id = 2;
+     */
+    originalAgentRunId: string;
+    /**
+     * The canonical run it points at now.
+     *
+     * @generated from field: string agent_run_id = 3;
+     */
+    agentRunId: string;
+    /**
+     * The grouping revision that moved it.
+     *
+     * @generated from field: uint64 revision = 4;
+     */
+    revision: bigint;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingRedirectReasonV1 reason = 5;
+     */
+    reason: AgentRunGroupingRedirectReasonV1;
+    /**
+     * @generated from field: google.protobuf.Timestamp occurred_at = 6;
+     */
+    occurredAt?: Timestamp | undefined;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.AgentRunAnchorRebindV1.
+ * Use `create(AgentRunAnchorRebindV1Schema)` to create a new message.
+ */
+export declare const AgentRunAnchorRebindV1Schema: GenMessage<AgentRunAnchorRebindV1>;
+/**
+ * The identity block. Lanes B and C embed this rather than re-deriving any part
+ * of it, so there is exactly one answer to "how sure are we about this run?".
+ *
+ * @generated from message o11y_one.agentic.v1.AgentRunGroupingV1
+ */
+export type AgentRunGroupingV1 = Message<"o11y_one.agentic.v1.AgentRunGroupingV1"> & {
+    /**
+     * The CANONICAL id. When `redirect` is set, this is NOT the id the caller
+     * asked for — that one is in `redirect.from_id`.
+     *
+     * @generated from field: string agent_run_id = 1;
+     */
+    agentRunId: string;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingStateV1 state = 2;
+     */
+    state: AgentRunGroupingStateV1;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingConfidenceV1 confidence = 3;
+     */
+    confidence: AgentRunGroupingConfidenceV1;
+    /**
+     * The rung that produced this grouping, 1..5. Zero means unspecified.
+     *
+     * @generated from field: uint32 attached_rung = 4;
+     */
+    attachedRung: number;
+    /**
+     * Monotone. A grouping change advances it, so a cursor bound to it resyncs
+     * rather than reordering invisibly (`P7-9`, NN20).
+     *
+     * @generated from field: uint64 revision = 5;
+     */
+    revision: bigint;
+    /**
+     * @generated from field: repeated o11y_one.agentic.v1.GroupingConfidenceInputV1 confidence_inputs = 6;
+     */
+    confidenceInputs: GroupingConfidenceInputV1[];
+    /**
+     * The official conversation identity, when there is one. Absent for a rung-4
+     * or rung-5 run, and absent is not empty-string.
+     *
+     * @generated from field: optional string conversation_id = 7;
+     */
+    conversationId?: string | undefined;
+    /**
+     * @generated from field: uint32 member_trace_count = 8;
+     */
+    memberTraceCount: number;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingBoundsV1 bounds = 9;
+     */
+    bounds?: AgentRunGroupingBoundsV1 | undefined;
+    /**
+     * Set when the read was addressed with a non-`_CURRENT` id.
+     *
+     * @generated from field: optional o11y_one.agentic.v1.GroupingRedirectV1 redirect = 10;
+     */
+    redirect?: GroupingRedirectV1 | undefined;
+    /**
+     * Set when this run reached `_CONFIRMED` through `ConfirmAgentRunGrouping`.
+     *
+     * @generated from field: optional o11y_one.agentic.v1.AgentRunGroupingConfirmationV1 confirmation = 11;
+     */
+    confirmation?: AgentRunGroupingConfirmationV1 | undefined;
+    /**
+     * Monotone, and it advances on a grouping change AND on late data. Lane C's
+     * timeline cursor binds to this; lane B's index pass joins against it.
+     *
+     * @generated from field: uint64 projection_version = 12;
+     */
+    projectionVersion: bigint;
+    /**
+     * Evidence that moved with this run, newest first, capped at
+     * `anchor_rebind_cap` on the `agent_run_grouping` posture. Empty means no
+     * anchor has ever moved — which for a run that has never merged or split is
+     * the true answer and not a missing field.
+     *
+     * @generated from field: repeated o11y_one.agentic.v1.AgentRunAnchorRebindV1 anchor_rebinds = 13;
+     */
+    anchorRebinds: AgentRunAnchorRebindV1[];
+};
+/**
+ * Describes the message o11y_one.agentic.v1.AgentRunGroupingV1.
+ * Use `create(AgentRunGroupingV1Schema)` to create a new message.
+ */
+export declare const AgentRunGroupingV1Schema: GenMessage<AgentRunGroupingV1>;
+/**
+ * SM-11's state, with the configuration that produced it.
+ *
+ * `P7-13`: the timeline's "this conversation is done" affordance READS this and
+ * computes no idle heuristic of its own. The window and grace ride along so a
+ * client can say "quiet for 15 minutes" without a second fetch.
+ *
+ * @generated from message o11y_one.agentic.v1.ConversationCompletenessV1
+ */
+export type ConversationCompletenessV1 = Message<"o11y_one.agentic.v1.ConversationCompletenessV1"> & {
+    /**
+     * @generated from field: o11y_one.agentic.v1.ConversationCompletenessStateV1 state = 1;
+     */
+    state: ConversationCompletenessStateV1;
+    /**
+     * Increments on every `_REOPENED`. Evidence produced against a previous epoch
+     * stays valid and readable and is marked superseded-eligible; nothing is
+     * deleted (`P7-12`, NN13).
+     *
+     * @generated from field: uint32 epoch = 2;
+     */
+    epoch: number;
+    /**
+     * @generated from field: google.protobuf.Timestamp last_seen_at = 3;
+     */
+    lastSeenAt?: Timestamp | undefined;
+    /**
+     * @generated from field: uint64 inactivity_window_seconds = 4;
+     */
+    inactivityWindowSeconds: bigint;
+    /**
+     * @generated from field: uint64 late_arrival_grace_seconds = 5;
+     */
+    lateArrivalGraceSeconds: bigint;
+    /**
+     * True when this run has been reopened at least once, so evidence from an
+     * earlier epoch is superseded-eligible. False on epoch 1, where there is
+     * nothing to supersede.
+     *
+     * @generated from field: bool superseded_eligible = 6;
+     */
+    supersededEligible: boolean;
+    /**
+     * WHEN the state was decided, by Postgres's clock, inside the statement that
+     * stored it. On the wire so a reader can tell a stale projection from a quiet
+     * conversation.
+     *
+     * @generated from field: google.protobuf.Timestamp evaluated_at = 7;
+     */
+    evaluatedAt?: Timestamp | undefined;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.ConversationCompletenessV1.
+ * Use `create(ConversationCompletenessV1Schema)` to create a new message.
+ */
+export declare const ConversationCompletenessV1Schema: GenMessage<ConversationCompletenessV1>;
+/**
+ * `PLAN:1675` / `PLAN:494`: the audited promotion of a provisional grouping when
+ * explicit telemetry identity is unavailable.
+ *
+ * @generated from message o11y_one.agentic.v1.ConfirmAgentRunGroupingRequest
+ */
+export type ConfirmAgentRunGroupingRequest = Message<"o11y_one.agentic.v1.ConfirmAgentRunGroupingRequest"> & {
+    /**
+     * May be a stale id. It resolves to the canonical run and the response carries
+     * the redirect; it is never a `NOT_FOUND`.
+     *
+     * @generated from field: string agent_run_id = 1;
+     */
+    agentRunId: string;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingConfirmationReasonV1 reason = 2;
+     */
+    reason: AgentRunGroupingConfirmationReasonV1;
+    /**
+     * @generated from field: optional string reason_note = 3;
+     */
+    reasonNote?: string | undefined;
+    /**
+     * Replaying one key returns the SAME run with `idempotent_replay` set and
+     * writes no second revision.
+     *
+     * @generated from field: string idempotency_key = 4;
+     */
+    idempotencyKey: string;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.ConfirmAgentRunGroupingRequest.
+ * Use `create(ConfirmAgentRunGroupingRequestSchema)` to create a new message.
+ */
+export declare const ConfirmAgentRunGroupingRequestSchema: GenMessage<ConfirmAgentRunGroupingRequest>;
+/**
+ * @generated from message o11y_one.agentic.v1.ConfirmAgentRunGroupingResponse
+ */
+export type ConfirmAgentRunGroupingResponse = Message<"o11y_one.agentic.v1.ConfirmAgentRunGroupingResponse"> & {
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgentRunGroupingV1 grouping = 1;
+     */
+    grouping?: AgentRunGroupingV1 | undefined;
+    /**
+     * @generated from field: bool idempotent_replay = 2;
+     */
+    idempotentReplay: boolean;
+    /**
+     * @generated from field: o11y_one.agentic.v1.ConversationCompletenessV1 completeness = 3;
+     */
+    completeness?: ConversationCompletenessV1 | undefined;
+    /**
+     * @generated from field: o11y_one.agentic.v1.EvaluationFreshnessV1 freshness = 4;
+     */
+    freshness?: EvaluationFreshnessV1 | undefined;
+    /**
+     * @generated from field: o11y_one.agentic.v1.AgenticEvaluationCapabilitiesV1 capabilities = 5;
+     */
+    capabilities?: AgenticEvaluationCapabilitiesV1 | undefined;
+};
+/**
+ * Describes the message o11y_one.agentic.v1.ConfirmAgentRunGroupingResponse.
+ * Use `create(ConfirmAgentRunGroupingResponseSchema)` to create a new message.
+ */
+export declare const ConfirmAgentRunGroupingResponseSchema: GenMessage<ConfirmAgentRunGroupingResponse>;
+/**
+ * SM-9 (`0b:P7-1`), verbatim.
+ *
+ * Grouping resolves in strict precedence order and the FIRST rung that produces
+ * a group wins; the rung that produced it is recorded on the run and returned as
+ * `GroupingConfidenceInputV1.contributed_rung`.
+ *
+ * There is NO terminal value. Confidence is recomputed as identity arrives, with
+ * exactly one rule that behaves like a terminal and is a rule rather than a
+ * state: `_CONFIRMED` is never downgraded by the grouping pass. A human said
+ * these traces are one conversation, and a heuristic does not get to disagree
+ * with them silently.
+ *
+ * @generated from enum o11y_one.agentic.v1.AgentRunGroupingConfidenceV1
+ */
+export declare enum AgentRunGroupingConfidenceV1 {
+    /**
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Rung 1: official conversation identity (`gen_ai.conversation.id`) on EVERY
+     * member trace. Authoritative.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_EXPLICIT = 1;
+     */
+    EXPLICIT = 1,
+    /**
+     * Rung 2: official identity on SOME members; the rest attached by span link.
+     * Authoritative, with the partial posture surfaced — and see
+     * `AGENT_RUN_GROUPING_SIGNAL_KIND_V1_SPAN_LINK`, whose availability says what
+     * a link can and cannot tell this build.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_EXPLICIT_PARTIAL = 2;
+     */
+    EXPLICIT_PARTIAL = 2,
+    /**
+     * Rung 3: compatible SECONDARY identity only — the control plane's own
+     * `conversation_id`, recorded against a trace by a score, feedback, outcome or
+     * content manifest whose spans never carried the attribute. Authoritative.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_DERIVED = 3;
+     */
+    DERIVED = 3,
+    /**
+     * Rung 4: bounded heuristic — same service AND deployment AND customer
+     * identity AND within the published bounds. NOT authoritative: see
+     * `AgentRunAuthorityCapabilityV1`.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_PROVISIONAL = 4;
+     */
+    PROVISIONAL = 4,
+    /**
+     * Rung 5: no identity at all. One trace, one run — and VISIBLE in the agent-run
+     * index, unlike `ListSessions`, which excludes identity-less traces (0b docket
+     * B1-4, adopted). Not authoritative for CROSS-TRACE claims; a single-trace
+     * claim about a single-trace run is a claim about that trace.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_UNGROUPED = 5;
+     */
+    UNGROUPED = 5,
+    /**
+     * A `_PROVISIONAL` group an authorized user confirmed through
+     * `ConfirmAgentRunGrouping`. Authoritative, with the audit record attached.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIDENCE_V1_CONFIRMED = 6;
+     */
+    CONFIRMED = 6
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.AgentRunGroupingConfidenceV1.
+ */
+export declare const AgentRunGroupingConfidenceV1Schema: GenEnum<AgentRunGroupingConfidenceV1>;
+/**
+ * SM-10 (`0b:P7-5`), verbatim.
+ *
+ * Three of the five are terminal, and ALL THREE REDIRECT. None of them is a
+ * `NOT_FOUND`: a read by a stale id returns the canonical run plus a
+ * `GroupingRedirectV1`, because an operator who followed a link from an incident
+ * ticket to a merged run has asked a reasonable question and deserves an answer
+ * rather than a 404.
+ *
+ * @generated from enum o11y_one.agentic.v1.AgentRunGroupingStateV1
+ */
+export declare enum AgentRunGroupingStateV1 {
+    /**
+     * @generated from enum value: AGENT_RUN_GROUPING_STATE_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * This id is the canonical grouping at this revision.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_STATE_V1_CURRENT = 1;
+     */
+    CURRENT = 1,
+    /**
+     * Merged into another run; reads redirect to exactly one id.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_STATE_V1_MERGED_AWAY = 2;
+     */
+    MERGED_AWAY = 2,
+    /**
+     * Split into two or more runs; reads redirect to a disambiguation set.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_STATE_V1_SPLIT_AWAY = 3;
+     */
+    SPLIT_AWAY = 3,
+    /**
+     * The canonical id changed for another audited reason.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_STATE_V1_REDIRECTED = 4;
+     */
+    REDIRECTED = 4
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.AgentRunGroupingStateV1.
+ */
+export declare const AgentRunGroupingStateV1Schema: GenEnum<AgentRunGroupingStateV1>;
+/**
+ * SM-11 (`0b:P7-11`..`P7-13`), verbatim.
+ *
+ * NO terminal: `_COMPLETE` is reopenable by construction, because a late span is
+ * a fact about the customer's system and not a violation of ours.
+ *
+ * Every transition is decided by POSTGRES'S clock, inside the statement that
+ * stores it (wave 39 `DEV-3`). There is no Rust twin of this comparison, because
+ * two clocks answering "is this conversation over?" is how a conversation gets
+ * scored twice with two different answers.
+ *
+ * @generated from enum o11y_one.agentic.v1.ConversationCompletenessStateV1
+ */
+export declare enum ConversationCompletenessStateV1 {
+    /**
+     * @generated from enum value: CONVERSATION_COMPLETENESS_STATE_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Within the configured inactivity window; more spans expected.
+     *
+     * @generated from enum value: CONVERSATION_COMPLETENESS_STATE_V1_OPEN = 1;
+     */
+    OPEN = 1,
+    /**
+     * Inactivity window elapsed; provisionally final. THIS is where
+     * conversation-subject scoring and conversation-scoped rules fire (`P7-11`) —
+     * firing at `_COMPLETE` makes the learning loop unusably slow, and firing at
+     * `_OPEN` scores a truncated conversation.
+     *
+     * @generated from enum value: CONVERSATION_COMPLETENESS_STATE_V1_INACTIVE = 2;
+     */
+    INACTIVE = 2,
+    /**
+     * Inactivity window plus late-arrival grace elapsed; finality claimed.
+     *
+     * @generated from enum value: CONVERSATION_COMPLETENESS_STATE_V1_COMPLETE = 3;
+     */
+    COMPLETE = 3,
+    /**
+     * A late span arrived after `_COMPLETE`. `completeness_epoch` increments;
+     * evidence produced against epoch n stays valid and readable, marked
+     * superseded-eligible. Nothing is retroactively deleted (NN13).
+     *
+     * @generated from enum value: CONVERSATION_COMPLETENESS_STATE_V1_REOPENED = 4;
+     */
+    REOPENED = 4
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.ConversationCompletenessStateV1.
+ */
+export declare const ConversationCompletenessStateV1Schema: GenEnum<ConversationCompletenessStateV1>;
+/**
+ * Minted by wave 41 lane A: `P7-3`'s `signal_kind`.
+ *
+ * One value per source of identity this build can actually read. There is no
+ * value for a signal nothing produces — an enum arm for an unreadable signal is
+ * a promise a client would render an empty row for.
+ *
+ * @generated from enum o11y_one.agentic.v1.AgentRunGroupingSignalKindV1
+ */
+export declare enum AgentRunGroupingSignalKindV1 {
+    /**
+     * @generated from enum value: AGENT_RUN_GROUPING_SIGNAL_KIND_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * `gen_ai.conversation.id` on the span. The only declaration is
+     * `transformation/src/trace_registry.rs:587`; it is a typed Arrow column.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_SIGNAL_KIND_V1_OFFICIAL_CONVERSATION_ID = 1;
+     */
+    OFFICIAL_CONVERSATION_ID = 1,
+    /**
+     * An OTel span link from a span in one trace to a span in another.
+     *
+     * ADJACENCY ONLY, and the availability field on the input says so per run:
+     * span links reach this lake with their ATTRIBUTES DROPPED
+     * (`transformation/src/otel_trace.rs:461-499` writes trace id, span id, trace
+     * state, dropped-attributes count and flags — and nothing else). So a link can
+     * say THAT it links and can never say WHY. "Continuation", "batch member" and
+     * "retry of" are indistinguishable here, and this build does not guess between
+     * them.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_SIGNAL_KIND_V1_SPAN_LINK = 2;
+     */
+    SPAN_LINK = 2,
+    /**
+     * The control plane's own `conversation_id`, recorded beside a `trace_id` on a
+     * score, feedback event, outcome event, content manifest or dataset item
+     * (migration `20260416100000`). A genuinely second source: a customer can name
+     * the conversation on the SCORE for a trace whose spans never carried it.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_SIGNAL_KIND_V1_CONTROL_PLANE_CONVERSATION_ID = 3;
+     */
+    CONTROL_PLANE_CONVERSATION_ID = 3,
+    /**
+     * Same service AND deployment AND customer identity AND inside the three
+     * published bounds. Rung 4, and never authoritative.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_SIGNAL_KIND_V1_BOUNDED_HEURISTIC = 4;
+     */
+    BOUNDED_HEURISTIC = 4,
+    /**
+     * No identity of any kind was found for this trace. Recorded as a signal
+     * rather than as an absence, so "we looked and found none" appears in the
+     * confidence inputs instead of an empty list that reads as "we did not look".
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_SIGNAL_KIND_V1_NO_IDENTITY = 5;
+     */
+    NO_IDENTITY = 5
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.AgentRunGroupingSignalKindV1.
+ */
+export declare const AgentRunGroupingSignalKindV1Schema: GenEnum<AgentRunGroupingSignalKindV1>;
+/**
+ * Minted by wave 41 lane A: why a stale id redirects.
+ *
+ * @generated from enum o11y_one.agentic.v1.AgentRunGroupingRedirectReasonV1
+ */
+export declare enum AgentRunGroupingRedirectReasonV1 {
+    /**
+     * @generated from enum value: AGENT_RUN_GROUPING_REDIRECT_REASON_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Late explicit identity arrived and joined two runs into one.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_REDIRECT_REASON_V1_LATE_EXPLICIT_IDENTITY_MERGE = 1;
+     */
+    LATE_EXPLICIT_IDENTITY_MERGE = 1,
+    /**
+     * Late explicit identity arrived and proved one run was two conversations.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_REDIRECT_REASON_V1_LATE_EXPLICIT_IDENTITY_SPLIT = 2;
+     */
+    LATE_EXPLICIT_IDENTITY_SPLIT = 2,
+    /**
+     * A heuristic group grew past one of its three bounds and was split rather
+     * than enlarged (`P7-2`, split-not-merge).
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_REDIRECT_REASON_V1_BOUND_BREACH_SPLIT = 3;
+     */
+    BOUND_BREACH_SPLIT = 3,
+    /**
+     * The bounded heuristic folded runs that previously stood alone, or pulled
+     * them apart again. Distinct from the two `LATE_EXPLICIT_IDENTITY_*` reasons
+     * on purpose: an operator reading "your run moved" is owed the difference
+     * between "your application finally told us the conversation id" and "our
+     * heuristic changed its mind", because only the first of those is a fact
+     * about their system.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_REDIRECT_REASON_V1_HEURISTIC_REGROUPED = 4;
+     */
+    HEURISTIC_REGROUPED = 4
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.AgentRunGroupingRedirectReasonV1.
+ */
+export declare const AgentRunGroupingRedirectReasonV1Schema: GenEnum<AgentRunGroupingRedirectReasonV1>;
+/**
+ * Minted by wave 41 lane A: the audited reason `PLAN:1675` requires on a
+ * promotion. Typed rather than free text, because "why did somebody confirm
+ * this?" is a question the audit chain must answer without a human reading prose.
+ *
+ * @generated from enum o11y_one.agentic.v1.AgentRunGroupingConfirmationReasonV1
+ */
+export declare enum AgentRunGroupingConfirmationReasonV1 {
+    /**
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIRMATION_REASON_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * The operator checked the member traces and they are one conversation.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIRMATION_REASON_V1_OPERATOR_VERIFIED_SAME_CONVERSATION = 1;
+     */
+    OPERATOR_VERIFIED_SAME_CONVERSATION = 1,
+    /**
+     * The application does not emit conversation identity, and the operator
+     * accepts the heuristic in its place until it does.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIRMATION_REASON_V1_INSTRUMENTATION_GAP_ACKNOWLEDGED = 2;
+     */
+    INSTRUMENTATION_GAP_ACKNOWLEDGED = 2,
+    /**
+     * Confirmed inside an incident, to make the run usable as evidence now.
+     *
+     * @generated from enum value: AGENT_RUN_GROUPING_CONFIRMATION_REASON_V1_INCIDENT_INVESTIGATION = 3;
+     */
+    INCIDENT_INVESTIGATION = 3
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.AgentRunGroupingConfirmationReasonV1.
+ */
+export declare const AgentRunGroupingConfirmationReasonV1Schema: GenEnum<AgentRunGroupingConfirmationReasonV1>;
+/**
+ * Minted by wave 41 lane A: `P7-10`'s six rows, addressable.
+ *
+ * The matrix is a table in the contract and prose everywhere else, which is how
+ * "provisional groups cannot drive automation" becomes five different guesses at
+ * five call sites. Here it is one enum and one function
+ * (`assert_grouping_authority`), and every refusal names the row it came from.
+ *
+ * @generated from enum o11y_one.agentic.v1.AgentRunAuthorityCapabilityV1
+ */
+export declare enum AgentRunAuthorityCapabilityV1 {
+    /**
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Allowed at every confidence, labelled.
+     *
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_RENDER = 1;
+     */
+    RENDER = 1,
+    /**
+     * Allowed at every confidence: a human chose it, and the draft records the
+     * confidence at selection. This row is the whole design — human selection
+     * permitted, automation forbidden — and it must survive into the UI.
+     *
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_MANUAL_DRAFT_SELECTION = 2;
+     */
+    MANUAL_DRAFT_SELECTION = 2,
+    /**
+     * Refused for `_PROVISIONAL`; single-trace only for `_UNGROUPED`.
+     *
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_AUTOMATIC_LINEAGE = 3;
+     */
+    AUTOMATIC_LINEAGE = 3,
+    /**
+     * Refused for `_PROVISIONAL`; single-trace only for `_UNGROUPED`.
+     *
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_PRODUCTION_RULE_TRIGGER = 4;
+     */
+    PRODUCTION_RULE_TRIGGER = 4,
+    /**
+     * Refused for `_PROVISIONAL` AND for `_UNGROUPED`: a conversation of unknown
+     * membership has no conversation subject.
+     *
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_CONVERSATION_SUBJECT_SCORING = 5;
+     */
+    CONVERSATION_SUBJECT_SCORING = 5,
+    /**
+     * Refused for `_PROVISIONAL` AND for `_UNGROUPED`.
+     *
+     * @generated from enum value: AGENT_RUN_AUTHORITY_CAPABILITY_V1_RELEASE_EVIDENCE = 6;
+     */
+    RELEASE_EVIDENCE = 6
+}
+/**
+ * Describes the enum o11y_one.agentic.v1.AgentRunAuthorityCapabilityV1.
+ */
+export declare const AgentRunAuthorityCapabilityV1Schema: GenEnum<AgentRunAuthorityCapabilityV1>;