niceeval 0.12.2-canary.31 → 0.13.0

package/dist/o11y/record/model.d.ts

@@ -1,265 +1,239 @@
 import type { Brand } from "effect";
 /** A readonly non-empty sequence used by durable complete/partial states. */
 export type NonEmptyReadonlyArray<Item> = readonly [Item, ...Item[]];
-export declare const NON_NEGATIVE_SAFE_INTEGER_V1_BRAND: "@niceeval/o11y/NonNegativeSafeIntegerV1";
-export declare const POSITIVE_SAFE_INTEGER_V1_BRAND: "@niceeval/o11y/PositiveSafeIntegerV1";
-export declare const SAFE_IDENTIFIER_V1_BRAND: "@niceeval/o11y/SafeIdentifierV1";
-export declare const SOURCE_NATIVE_TOOL_NAME_V1_BRAND: "@niceeval/o11y/SourceNativeToolNameV1";
-export declare const STABLE_LABEL_V1_BRAND: "@niceeval/o11y/StableLabelV1";
-export declare const SAFE_TEXT_V1_BRAND: "@niceeval/o11y/SafeTextV1";
-export declare const CANONICAL_DECIMAL_V1_BRAND: "@niceeval/o11y/CanonicalDecimalV1";
-export declare const CURRENCY_CODE_V1_BRAND: "@niceeval/o11y/CurrencyCodeV1";
-export type NonNegativeSafeInteger = number & Brand.Brand<typeof NON_NEGATIVE_SAFE_INTEGER_V1_BRAND>;
-export type PositiveSafeInteger = number & Brand.Brand<typeof POSITIVE_SAFE_INTEGER_V1_BRAND>;
-export type SafeIdentifier = string & Brand.Brand<typeof SAFE_IDENTIFIER_V1_BRAND>;
-export type SourceNativeToolName = string & Brand.Brand<typeof SOURCE_NATIVE_TOOL_NAME_V1_BRAND>;
-export type StableLabel = string & Brand.Brand<typeof STABLE_LABEL_V1_BRAND>;
-export type SafeText = string & Brand.Brand<typeof SAFE_TEXT_V1_BRAND>;
-export type CanonicalDecimal = string & Brand.Brand<typeof CANONICAL_DECIMAL_V1_BRAND>;
-export type CurrencyCode = string & Brand.Brand<typeof CURRENCY_CODE_V1_BRAND>;
-/** v1 aliases keep field types visibly tied to this durable format. */
-export type NonNegativeSafeIntegerV1 = NonNegativeSafeInteger;
-export type PositiveSafeIntegerV1 = PositiveSafeInteger;
-export type SafeIdentifierV1 = SafeIdentifier;
-export type SourceNativeToolNameV1 = SourceNativeToolName;
-export type StableLabelV1 = StableLabel;
-export type SafeTextV1 = SafeText;
-export type CanonicalDecimalV1 = CanonicalDecimal;
-export type CurrencyCodeV1 = CurrencyCode;
-export declare function utf8ByteLengthV1(value: string): number;
+export declare const NON_NEGATIVE_SAFE_INTEGER__BRAND: "@niceeval/o11y/NonNegativeSafeInteger";
+export declare const POSITIVE_SAFE_INTEGER__BRAND: "@niceeval/o11y/PositiveSafeInteger";
+export declare const SAFE_IDENTIFIER__BRAND: "@niceeval/o11y/SafeIdentifier";
+export declare const SOURCE_NATIVE_TOOL_NAME__BRAND: "@niceeval/o11y/SourceNativeToolName";
+export declare const STABLE_LABEL__BRAND: "@niceeval/o11y/StableLabel";
+export declare const SAFE_TEXT__BRAND: "@niceeval/o11y/SafeText";
+export declare const CANONICAL_DECIMAL__BRAND: "@niceeval/o11y/CanonicalDecimal";
+export declare const CURRENCY_CODE__BRAND: "@niceeval/o11y/CurrencyCode";
+export type NonNegativeSafeInteger = number & Brand.Brand<typeof NON_NEGATIVE_SAFE_INTEGER__BRAND>;
+export type PositiveSafeInteger = number & Brand.Brand<typeof POSITIVE_SAFE_INTEGER__BRAND>;
+export type SafeIdentifier = string & Brand.Brand<typeof SAFE_IDENTIFIER__BRAND>;
+export type SourceNativeToolName = string & Brand.Brand<typeof SOURCE_NATIVE_TOOL_NAME__BRAND>;
+export type StableLabel = string & Brand.Brand<typeof STABLE_LABEL__BRAND>;
+export type SafeText = string & Brand.Brand<typeof SAFE_TEXT__BRAND>;
+export type CanonicalDecimal = string & Brand.Brand<typeof CANONICAL_DECIMAL__BRAND>;
+export type CurrencyCode = string & Brand.Brand<typeof CURRENCY_CODE__BRAND>;
+export declare function utf8ByteLength(value: string): number;
 /** JavaScript strings with an unmatched surrogate do not represent UTF-8 text. */
-export declare function isStrictUnicodeTextV1(value: string): boolean;
-export declare function isNonNegativeSafeIntegerV1(value: number): value is NonNegativeSafeInteger;
-export declare function isPositiveSafeIntegerV1(value: number): value is PositiveSafeInteger;
-export declare function makeNonNegativeSafeIntegerV1(value: number): NonNegativeSafeInteger | undefined;
-export declare function makePositiveSafeIntegerV1(value: number): PositiveSafeInteger | undefined;
-export declare function isSafeIdentifierV1(value: string): value is SafeIdentifier;
-export declare function isStableLabelV1(value: string): value is StableLabel;
+export declare function isStrictUnicodeText(value: string): boolean;
+export declare function isNonNegativeSafeInteger(value: number): value is NonNegativeSafeInteger;
+export declare function isPositiveSafeInteger(value: number): value is PositiveSafeInteger;
+export declare function makeNonNegativeSafeInteger(value: number): NonNegativeSafeInteger | undefined;
+export declare function makePositiveSafeInteger(value: number): PositiveSafeInteger | undefined;
+export declare function isSafeIdentifier(value: string): value is SafeIdentifier;
+export declare function isStableLabel(value: string): value is StableLabel;
 /**
  * A provider's exact tool name. Unlike SafeIdentifier, this durable value is
  * intentionally case-sensitive and admits source-native punctuation and
  * Unicode. Line breaks remain excluded so a name cannot reshape a Report
  * heading while still passing through unchanged.
  */
-export declare function isSourceNativeToolNameV1(value: string): value is SourceNativeToolName;
-export declare function isSafeTextV1(value: string): value is SafeText;
-export declare function isBoundedSafeTextV1(value: string, maximumBytes: number): value is SafeText;
-export declare function isCanonicalDecimalV1(value: string): value is CanonicalDecimal;
-export declare function isCurrencyCodeV1(value: string): value is CurrencyCode;
-export declare function makeSafeIdentifierV1(value: string): SafeIdentifier | undefined;
-export declare function makeSourceNativeToolNameV1(value: string): SourceNativeToolName | undefined;
-export declare function makeStableLabelV1(value: string): StableLabel | undefined;
-export declare function makeSafeTextV1(value: string): SafeText | undefined;
-export declare function makeBoundedSafeTextV1(value: string, maximumBytes: number): SafeText | undefined;
-export declare function makeCanonicalDecimalV1(value: string): CanonicalDecimal | undefined;
-export declare function makeCurrencyCodeV1(value: string): CurrencyCode | undefined;
+export declare function isSourceNativeToolName(value: string): value is SourceNativeToolName;
+export declare function isSafeText(value: string): value is SafeText;
+export declare function isBoundedSafeText(value: string, maximumBytes: number): value is SafeText;
+export declare function isCanonicalDecimal(value: string): value is CanonicalDecimal;
+export declare function isCurrencyCode(value: string): value is CurrencyCode;
+export declare function makeSafeIdentifier(value: string): SafeIdentifier | undefined;
+export declare function makeSourceNativeToolName(value: string): SourceNativeToolName | undefined;
+export declare function makeStableLabel(value: string): StableLabel | undefined;
+export declare function makeSafeText(value: string): SafeText | undefined;
+export declare function makeBoundedSafeText(value: string, maximumBytes: number): SafeText | undefined;
+export declare function makeCanonicalDecimal(value: string): CanonicalDecimal | undefined;
+export declare function makeCurrencyCode(value: string): CurrencyCode | undefined;
 /** Returns the byte length of a serializable durable payload without accepting a JSON bag API. */
-export declare function jsonUtf8ByteLengthV1(value: object): number | undefined;
-export declare const TURN_ID_V1_BRAND: "@niceeval/o11y/TurnIdV1";
-export declare const ITEM_ID_V1_BRAND: "@niceeval/o11y/ItemIdV1";
-export declare const CALL_ID_V1_BRAND: "@niceeval/o11y/CallIdV1";
-export declare const COMMAND_ID_V1_BRAND: "@niceeval/o11y/CommandIdV1";
-export declare const USAGE_OBSERVATION_ID_V1_BRAND: "@niceeval/o11y/UsageObservationIdV1";
-export declare const INTERVAL_ID_V1_BRAND: "@niceeval/o11y/IntervalIdV1";
-export declare const DIAGNOSTIC_ID_V1_BRAND: "@niceeval/o11y/DiagnosticIdV1";
-export type TurnIdV1 = string & Brand.Brand<typeof TURN_ID_V1_BRAND>;
-export type ItemIdV1 = string & Brand.Brand<typeof ITEM_ID_V1_BRAND>;
-export type CallIdV1 = string & Brand.Brand<typeof CALL_ID_V1_BRAND>;
-export type CommandIdV1 = string & Brand.Brand<typeof COMMAND_ID_V1_BRAND>;
-export type UsageObservationIdV1 = string & Brand.Brand<typeof USAGE_OBSERVATION_ID_V1_BRAND>;
-export type IntervalIdV1 = string & Brand.Brand<typeof INTERVAL_ID_V1_BRAND>;
-export type DiagnosticIdV1 = string & Brand.Brand<typeof DIAGNOSTIC_ID_V1_BRAND>;
-export declare const OBSERVABILITY_ENTITY_KINDS_V1: readonly ["turn", "item", "call", "command", "usage-observation", "interval", "diagnostic"];
-export type ObservabilityEntityKindV1 = (typeof OBSERVABILITY_ENTITY_KINDS_V1)[number];
-export interface ObservabilityEntityIdByKindV1 {
-    readonly turn: TurnIdV1;
-    readonly item: ItemIdV1;
-    readonly call: CallIdV1;
-    readonly command: CommandIdV1;
-    readonly "usage-observation": UsageObservationIdV1;
-    readonly interval: IntervalIdV1;
-    readonly diagnostic: DiagnosticIdV1;
+export declare function jsonUtf8ByteLength(value: object): number | undefined;
+export declare const TURN_ID__BRAND: "@niceeval/o11y/TurnId";
+export declare const ITEM_ID__BRAND: "@niceeval/o11y/ItemId";
+export declare const CALL_ID__BRAND: "@niceeval/o11y/CallId";
+export declare const COMMAND_ID__BRAND: "@niceeval/o11y/CommandId";
+export declare const USAGE_OBSERVATION_ID__BRAND: "@niceeval/o11y/UsageObservationId";
+export declare const INTERVAL_ID__BRAND: "@niceeval/o11y/IntervalId";
+export declare const DIAGNOSTIC_ID__BRAND: "@niceeval/o11y/DiagnosticId";
+export type TurnId = string & Brand.Brand<typeof TURN_ID__BRAND>;
+export type ItemId = string & Brand.Brand<typeof ITEM_ID__BRAND>;
+export type CallId = string & Brand.Brand<typeof CALL_ID__BRAND>;
+export type CommandId = string & Brand.Brand<typeof COMMAND_ID__BRAND>;
+export type UsageObservationId = string & Brand.Brand<typeof USAGE_OBSERVATION_ID__BRAND>;
+export type IntervalId = string & Brand.Brand<typeof INTERVAL_ID__BRAND>;
+export type DiagnosticId = string & Brand.Brand<typeof DIAGNOSTIC_ID__BRAND>;
+export declare const OBSERVABILITY_ENTITY_KINDS: readonly ["turn", "item", "call", "command", "usage-observation", "interval", "diagnostic"];
+export type ObservabilityEntityKind = (typeof OBSERVABILITY_ENTITY_KINDS)[number];
+export interface ObservabilityEntityIdByKind {
+    readonly turn: TurnId;
+    readonly item: ItemId;
+    readonly call: CallId;
+    readonly command: CommandId;
+    readonly "usage-observation": UsageObservationId;
+    readonly interval: IntervalId;
+    readonly diagnostic: DiagnosticId;
 }
-export type ObservabilityEntityIdForKindV1<Kind extends ObservabilityEntityKindV1> = ObservabilityEntityIdByKindV1[Kind];
-export type ObservabilityEntityIdV1 = ObservabilityEntityIdByKindV1[ObservabilityEntityKindV1];
-export declare function isTurnIdV1(value: string): value is TurnIdV1;
-export declare function isItemIdV1(value: string): value is ItemIdV1;
-export declare function isCallIdV1(value: string): value is CallIdV1;
-export declare function isCommandIdV1(value: string): value is CommandIdV1;
-export declare function isUsageObservationIdV1(value: string): value is UsageObservationIdV1;
-export declare function isIntervalIdV1(value: string): value is IntervalIdV1;
-export declare function isDiagnosticIdV1(value: string): value is DiagnosticIdV1;
-export declare function isObservabilityEntityIdV1(value: string): value is ObservabilityEntityIdV1;
-export declare function makeTurnIdV1(value: string): TurnIdV1 | undefined;
-export declare function makeItemIdV1(value: string): ItemIdV1 | undefined;
-export declare function makeCallIdV1(value: string): CallIdV1 | undefined;
-export declare function makeCommandIdV1(value: string): CommandIdV1 | undefined;
-export declare function makeUsageObservationIdV1(value: string): UsageObservationIdV1 | undefined;
-export declare function makeIntervalIdV1(value: string): IntervalIdV1 | undefined;
-export declare function makeDiagnosticIdV1(value: string): DiagnosticIdV1 | undefined;
-export declare function isObservabilityEntityIdForKindV1<Kind extends ObservabilityEntityKindV1>(value: string, kind: Kind): value is ObservabilityEntityIdForKindV1<Kind>;
-export declare function makeObservabilityEntityIdV1<Kind extends ObservabilityEntityKindV1>(value: string, kind: Kind): ObservabilityEntityIdForKindV1<Kind> | undefined;
+export type ObservabilityEntityIdForKind<Kind extends ObservabilityEntityKind> = ObservabilityEntityIdByKind[Kind];
+export type ObservabilityEntityId = ObservabilityEntityIdByKind[ObservabilityEntityKind];
+export declare function isTurnId(value: string): value is TurnId;
+export declare function isItemId(value: string): value is ItemId;
+export declare function isCallId(value: string): value is CallId;
+export declare function isCommandId(value: string): value is CommandId;
+export declare function isUsageObservationId(value: string): value is UsageObservationId;
+export declare function isIntervalId(value: string): value is IntervalId;
+export declare function isDiagnosticId(value: string): value is DiagnosticId;
+export declare function isObservabilityEntityId(value: string): value is ObservabilityEntityId;
+export declare function makeTurnId(value: string): TurnId | undefined;
+export declare function makeItemId(value: string): ItemId | undefined;
+export declare function makeCallId(value: string): CallId | undefined;
+export declare function makeCommandId(value: string): CommandId | undefined;
+export declare function makeUsageObservationId(value: string): UsageObservationId | undefined;
+export declare function makeIntervalId(value: string): IntervalId | undefined;
+export declare function makeDiagnosticId(value: string): DiagnosticId | undefined;
+export declare function isObservabilityEntityIdForKind<Kind extends ObservabilityEntityKind>(value: string, kind: Kind): value is ObservabilityEntityIdForKind<Kind>;
+export declare function makeObservabilityEntityId<Kind extends ObservabilityEntityKind>(value: string, kind: Kind): ObservabilityEntityIdForKind<Kind> | undefined;
 /** Encodes exactly 128 bits as the durable lower-case Crockford base-32 suffix. */
-export declare function encodeObservabilityEntityEntropyV1(entropy: Uint8Array): string | undefined;
-export declare function entityIdFromEntropyV1<Kind extends ObservabilityEntityKindV1>(kind: Kind, entropy: Uint8Array): ObservabilityEntityIdForKindV1<Kind> | undefined;
-export declare const ATTEMPT_OBSERVABILITY_FAMILY_SCHEMA_IDS_V1: readonly ["niceeval.conversation/v1", "niceeval.commands/v1", "niceeval.usage/v1", "niceeval.timing/v1", "niceeval.diagnostics/v1"];
-export declare const RUN_OBSERVABILITY_FAMILY_SCHEMA_IDS_V1: readonly ["niceeval.timing/v1", "niceeval.diagnostics/v1"];
-export type AttemptObservabilityFamilySchemaIdV1 = (typeof ATTEMPT_OBSERVABILITY_FAMILY_SCHEMA_IDS_V1)[number];
-export type RunObservabilityFamilySchemaIdV1 = (typeof RUN_OBSERVABILITY_FAMILY_SCHEMA_IDS_V1)[number];
-export type ObservabilityFamilySchemaIdV1 = AttemptObservabilityFamilySchemaIdV1 | RunObservabilityFamilySchemaIdV1;
-export type ObservabilityOwnerV1 = "attempt" | "run";
-export declare function isAttemptObservabilityFamilySchemaIdV1(value: string): value is AttemptObservabilityFamilySchemaIdV1;
-export declare function isRunObservabilityFamilySchemaIdV1(value: string): value is RunObservabilityFamilySchemaIdV1;
-export type ConversationTurnReferenceTargetV1 = {
-    readonly family: "niceeval.conversation/v1";
+export declare function encodeObservabilityEntityEntropy(entropy: Uint8Array): string | undefined;
+export declare function entityIdFromEntropy<Kind extends ObservabilityEntityKind>(kind: Kind, entropy: Uint8Array): ObservabilityEntityIdForKind<Kind> | undefined;
+export declare const ATTEMPT_OBSERVABILITY_FAMILY_SCHEMA_IDS: readonly ["niceeval.observability"];
+export declare const RUN_OBSERVABILITY_FAMILY_SCHEMA_IDS: readonly ["niceeval.observability"];
+export type AttemptObservabilityFamilySchemaId = (typeof ATTEMPT_OBSERVABILITY_FAMILY_SCHEMA_IDS)[number];
+export type RunObservabilityFamilySchemaId = (typeof RUN_OBSERVABILITY_FAMILY_SCHEMA_IDS)[number];
+export type ObservabilityFamilySchemaId = AttemptObservabilityFamilySchemaId | RunObservabilityFamilySchemaId;
+export type ObservabilityOwner = "attempt" | "run";
+export declare function isAttemptObservabilityFamilySchemaId(value: string): value is AttemptObservabilityFamilySchemaId;
+export declare function isRunObservabilityFamilySchemaId(value: string): value is RunObservabilityFamilySchemaId;
+export type ConversationTurnReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "turn";
-    readonly id: TurnIdV1;
+    readonly id: TurnId;
 };
-export type ConversationItemReferenceTargetV1 = {
-    readonly family: "niceeval.conversation/v1";
+export type ConversationItemReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "item";
-    readonly id: ItemIdV1;
+    readonly id: ItemId;
 };
-export type ConversationCallReferenceTargetV1 = {
-    readonly family: "niceeval.conversation/v1";
+export type ConversationCallReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "call";
-    readonly id: CallIdV1;
+    readonly id: CallId;
 };
-export type CommandReferenceTargetV1 = {
-    readonly family: "niceeval.commands/v1";
+export type CommandReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "command";
-    readonly id: CommandIdV1;
+    readonly id: CommandId;
 };
-export type UsageObservationReferenceTargetV1 = {
-    readonly family: "niceeval.usage/v1";
+export type UsageObservationReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "usage-observation";
-    readonly id: UsageObservationIdV1;
+    readonly id: UsageObservationId;
 };
-export type IntervalReferenceTargetV1 = {
-    readonly family: "niceeval.timing/v1";
+export type IntervalReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "interval";
-    readonly id: IntervalIdV1;
+    readonly id: IntervalId;
 };
-export type DiagnosticReferenceTargetV1 = {
-    readonly family: "niceeval.diagnostics/v1";
+export type DiagnosticReferenceTarget = {
+    readonly family: "niceeval.observability";
     readonly kind: "diagnostic";
-    readonly id: DiagnosticIdV1;
+    readonly id: DiagnosticId;
 };
-export type AttemptReferenceTargetV1 = ConversationTurnReferenceTargetV1 | ConversationItemReferenceTargetV1 | ConversationCallReferenceTargetV1 | CommandReferenceTargetV1 | UsageObservationReferenceTargetV1 | IntervalReferenceTargetV1 | DiagnosticReferenceTargetV1;
-export type RunReferenceTargetV1 = IntervalReferenceTargetV1 | DiagnosticReferenceTargetV1;
-export type ObservabilityReferenceTargetV1 = AttemptReferenceTargetV1 | RunReferenceTargetV1;
-export type ConversationReferencesV1 = Exclude<AttemptReferenceTargetV1, {
-    readonly family: "niceeval.conversation/v1";
-}>;
-export type CommandsReferencesV1 = Exclude<AttemptReferenceTargetV1, {
-    readonly family: "niceeval.commands/v1";
-}>;
-export type UsageReferencesV1 = Exclude<AttemptReferenceTargetV1, {
-    readonly family: "niceeval.usage/v1";
-}>;
-export type AttemptTimingReferencesV1 = Exclude<AttemptReferenceTargetV1, {
-    readonly family: "niceeval.timing/v1";
-}>;
-export type AttemptDiagnosticsReferencesV1 = Exclude<AttemptReferenceTargetV1, {
-    readonly family: "niceeval.diagnostics/v1";
-}>;
-export type RunTimingReferencesV1 = Exclude<RunReferenceTargetV1, {
-    readonly family: "niceeval.timing/v1";
-}>;
-export type RunDiagnosticsReferencesV1 = Exclude<RunReferenceTargetV1, {
-    readonly family: "niceeval.diagnostics/v1";
-}>;
-export type AttemptReferencesForFamilyV1<Family extends AttemptObservabilityFamilySchemaIdV1> = Exclude<AttemptReferenceTargetV1, {
-    readonly family: Family;
-}>;
-export type RunReferencesForFamilyV1<Family extends RunObservabilityFamilySchemaIdV1> = Exclude<RunReferenceTargetV1, {
-    readonly family: Family;
-}>;
-export declare function isAttemptReferenceTargetV1(value: unknown): value is AttemptReferenceTargetV1;
-export declare function isRunReferenceTargetV1(value: unknown): value is RunReferenceTargetV1;
-export declare function compareObservabilityTextV1(left: string, right: string): number;
-export declare function referenceTargetKeyV1(target: ObservabilityReferenceTargetV1): string;
-export declare function compareObservabilityReferenceTargetV1(left: ObservabilityReferenceTargetV1, right: ObservabilityReferenceTargetV1): number;
-export declare function isCanonicalAttemptReferencesV1(refs: readonly AttemptReferenceTargetV1[], sourceFamily?: AttemptObservabilityFamilySchemaIdV1): boolean;
-export declare function isCanonicalRunReferencesV1(refs: readonly RunReferenceTargetV1[], sourceFamily?: RunObservabilityFamilySchemaIdV1): boolean;
-export declare const COLLECTION_TARGETS_V1: readonly ["conversation-item", "conversation-text", "command-manifest", "command-stdout", "command-stderr", "usage-observation", "timing-interval", "diagnostic"];
-export type CollectionTargetV1 = (typeof COLLECTION_TARGETS_V1)[number];
-export declare const COLLECTION_STAGES_V1: readonly ["adapter", "command-capture", "usage-capture", "timing-capture", "diagnostic-capture", "attempt-finalizer", "run-teardown"];
-export type CollectionStageV1 = (typeof COLLECTION_STAGES_V1)[number];
-export declare function isCollectionTargetV1(value: string): value is CollectionTargetV1;
-export declare function isCollectionStageV1(value: string): value is CollectionStageV1;
-export type ObservabilityLimitationV1 = {
+export type AttemptReferenceTarget = ConversationTurnReferenceTarget | ConversationItemReferenceTarget | ConversationCallReferenceTarget | CommandReferenceTarget | UsageObservationReferenceTarget | IntervalReferenceTarget | DiagnosticReferenceTarget;
+export type RunReferenceTarget = IntervalReferenceTarget | DiagnosticReferenceTarget;
+export type ObservabilityReferenceTarget = AttemptReferenceTarget | RunReferenceTarget;
+/** Intermediate capture joins remain local to one Observability payload. */
+export type ConversationReferences = AttemptReferenceTarget;
+export type CommandsReferences = AttemptReferenceTarget;
+export type UsageReferences = AttemptReferenceTarget;
+export type AttemptTimingReferences = AttemptReferenceTarget;
+export type AttemptDiagnosticsReferences = AttemptReferenceTarget;
+export type RunTimingReferences = RunReferenceTarget;
+export type RunDiagnosticsReferences = RunReferenceTarget;
+export type AttemptReferencesForFamily<Family extends AttemptObservabilityFamilySchemaId> = AttemptReferenceTarget;
+export type RunReferencesForFamily<Family extends RunObservabilityFamilySchemaId> = RunReferenceTarget;
+export declare function isAttemptReferenceTarget(value: unknown): value is AttemptReferenceTarget;
+export declare function isRunReferenceTarget(value: unknown): value is RunReferenceTarget;
+export declare function compareObservabilityText(left: string, right: string): number;
+export declare function referenceTargetKey(target: ObservabilityReferenceTarget): string;
+export declare function compareObservabilityReferenceTarget(left: ObservabilityReferenceTarget, right: ObservabilityReferenceTarget): number;
+export declare function isCanonicalAttemptReferences(refs: readonly AttemptReferenceTarget[], _sourceFamily?: AttemptObservabilityFamilySchemaId): boolean;
+export declare function isCanonicalRunReferences(refs: readonly RunReferenceTarget[], _sourceFamily?: RunObservabilityFamilySchemaId): boolean;
+export declare const COLLECTION_TARGETS: readonly ["conversation-item", "conversation-text", "command-manifest", "command-stdout", "command-stderr", "usage-observation", "timing-interval", "diagnostic"];
+export type CollectionTarget = (typeof COLLECTION_TARGETS)[number];
+export declare const COLLECTION_STAGES: readonly ["adapter", "command-capture", "usage-capture", "timing-capture", "diagnostic-capture", "attempt-finalizer", "run-teardown"];
+export type CollectionStage = (typeof COLLECTION_STAGES)[number];
+export declare function isCollectionTarget(value: string): value is CollectionTarget;
+export declare function isCollectionStage(value: string): value is CollectionStage;
+export type ObservabilityLimitation = {
     readonly code: "capture-failed";
-    readonly stage: CollectionStageV1;
-    readonly target: CollectionTargetV1;
+    readonly stage: CollectionStage;
+    readonly target: CollectionTarget;
 } | {
     readonly code: "capture-interrupted";
-    readonly stage: CollectionStageV1;
-    readonly target: CollectionTargetV1;
+    readonly stage: CollectionStage;
+    readonly target: CollectionTarget;
 } | {
     readonly code: "collection-cap-reached";
-    readonly target: CollectionTargetV1;
+    readonly target: CollectionTarget;
     readonly retained: NonNegativeSafeInteger;
     readonly omittedAtLeast: PositiveSafeInteger;
 } | {
     readonly code: "unsupported-input";
-    readonly target: CollectionTargetV1;
+    readonly target: CollectionTarget;
     readonly omittedAtLeast: PositiveSafeInteger;
 } | {
     readonly code: "text-truncated";
     readonly target: "conversation-text";
-    readonly itemId: ItemIdV1;
+    readonly itemId: ItemId;
     readonly retainedBytes: NonNegativeSafeInteger;
     readonly omittedBytes: PositiveSafeInteger;
 } | {
     readonly code: "text-truncated";
     readonly target: "command-manifest";
-    readonly commandId: CommandIdV1;
+    readonly commandId: CommandId;
     readonly retainedBytes: NonNegativeSafeInteger;
     readonly omittedBytes: PositiveSafeInteger;
 } | {
     readonly code: "text-truncated";
     readonly target: "diagnostic";
-    readonly diagnosticId: DiagnosticIdV1;
+    readonly diagnosticId: DiagnosticId;
     readonly retainedBytes: NonNegativeSafeInteger;
     readonly omittedBytes: PositiveSafeInteger;
 } | {
     readonly code: "stream-truncated";
-    readonly commandId: CommandIdV1;
+    readonly commandId: CommandId;
     readonly stream: "stdout" | "stderr";
     readonly retainedBytes: NonNegativeSafeInteger;
     readonly omittedBytes: PositiveSafeInteger;
 } | {
     readonly code: "invalid-utf8-replaced";
-    readonly commandId: CommandIdV1;
+    readonly commandId: CommandId;
     readonly stream: "stdout" | "stderr";
     readonly replacementCount: PositiveSafeInteger;
 } | {
     readonly code: "unsafe-control-stripped";
-    readonly commandId: CommandIdV1;
+    readonly commandId: CommandId;
     readonly stream: "stdout" | "stderr";
     readonly strippedCount: PositiveSafeInteger;
 } | {
     readonly code: "redacted";
-    readonly target: CollectionTargetV1;
+    readonly target: CollectionTarget;
     readonly replacementCount: PositiveSafeInteger;
 };
-export type CollectionV1<Limitation extends ObservabilityLimitationV1 = ObservabilityLimitationV1> = {
+export type Collection<Limitation extends ObservabilityLimitation = ObservabilityLimitation> = {
     readonly state: "complete";
     readonly limitations: readonly [];
 } | {
     readonly state: "partial";
     readonly limitations: NonEmptyReadonlyArray<Limitation>;
 };
-export type ObservabilityCollectionV1<Limitation extends ObservabilityLimitationV1 = ObservabilityLimitationV1> = CollectionV1<Limitation>;
-export declare function limitationTargetV1(limitation: ObservabilityLimitationV1): CollectionTargetV1;
-export declare function limitationEntityIdV1(limitation: ObservabilityLimitationV1): string;
+export type ObservabilityCollection<Limitation extends ObservabilityLimitation = ObservabilityLimitation> = Collection<Limitation>;
+export declare function limitationTarget(limitation: ObservabilityLimitation): CollectionTarget;
+export declare function limitationEntityId(limitation: ObservabilityLimitation): string;
 /** A duplicate aggregation key means collector counts were not coalesced. */
-export declare function observabilityLimitationAggregationKeyV1(limitation: ObservabilityLimitationV1): string;
-export declare function compareObservabilityLimitationV1(left: ObservabilityLimitationV1, right: ObservabilityLimitationV1): number;
+export declare function observabilityLimitationAggregationKey(limitation: ObservabilityLimitation): string;
+export declare function compareObservabilityLimitation(left: ObservabilityLimitation, right: ObservabilityLimitation): number;
 /** Structural durable validation remains Schema's job; this verifies field semantics. */
-export declare function isObservabilityLimitationV1(limitation: ObservabilityLimitationV1): boolean;
-export type ObservabilityCollectionValidationIssueV1 = {
+export declare function isObservabilityLimitation(limitation: ObservabilityLimitation): boolean;
+export type ObservabilityCollectionValidationIssue = {
     readonly code: "observability-collection-state-invalid";
 } | {
     readonly code: "observability-limitation-invalid";
@@ -272,4 +246,4 @@ export type ObservabilityCollectionValidationIssueV1 = {
     readonly index: PositiveSafeInteger;
 };
 /** Validates complete/partial cardinality plus canonical, coalesced limitations. */
-export declare function validateObservabilityCollectionV1(collection: CollectionV1): readonly ObservabilityCollectionValidationIssueV1[];
+export declare function validateObservabilityCollection(collection: Collection): readonly ObservabilityCollectionValidationIssue[];