@ferricstore/ferricstore 0.5.1 → 0.5.2

package/dist/index.d.cts

@@ -1122,10 +1122,10 @@ interface FlowQueryPage {
     readonly cursor?: string;
 }
 interface FlowQueryQuality {
-    readonly exactness: string;
-    readonly freshness: string;
-    readonly coverage: string;
-    readonly pagination: string;
+    readonly exactness: "authoritative" | "projected_exact" | "exact" | "not_applicable";
+    readonly freshness: "current" | "projection_watermark" | "not_applicable";
+    readonly coverage: "complete" | "unavailable";
+    readonly pagination: "none" | "complete" | "authenticated_seek" | "live_seek";
 }
 interface FlowQueryUsage {
     readonly rangeSeeks: number;
@@ -1181,13 +1181,25 @@ declare class FlowQueryError extends FerricStoreError {
         readonly cause?: unknown;
     });
 }
+interface FlowExplainCapabilities {
+    readonly requested: readonly string[];
+    readonly available: readonly string[];
+    readonly missing: readonly string[];
+    readonly raw: Readonly<Record<string, unknown>>;
+}
 interface FlowExplainResult {
     readonly version: "ferric.flow.explain/v1";
     readonly queryFingerprint: string;
     readonly status: "planned" | "rejected" | "executed";
     readonly plan: Readonly<Record<string, unknown>>;
     readonly estimate: Readonly<Record<string, unknown>>;
+    readonly stats?: Readonly<Record<string, unknown>>;
+    readonly quality?: FlowQueryQuality;
     readonly bounds: Readonly<Record<string, unknown>>;
+    readonly pressure?: Readonly<Record<string, unknown>>;
+    readonly decision?: Readonly<Record<string, unknown>>;
+    readonly alternatives: readonly Readonly<Record<string, unknown>>[];
+    readonly capabilities?: FlowExplainCapabilities;
     readonly actual?: FlowQueryUsage;
     readonly diagnostic?: FlowQueryError;
     readonly raw: Readonly<Record<string, unknown>>;
@@ -1196,6 +1208,20 @@ interface FlowQueryIndexRegistry {
     readonly epoch: FlowQueryInteger;
     readonly catalogVersion: FlowQueryInteger;
 }
+type FlowQueryIndexServiceState = "ready" | "unavailable";
+interface FlowQueryIndexServices {
+    readonly registry: FlowQueryIndexServiceState;
+    readonly lifecycleWorker: FlowQueryIndexServiceState;
+    readonly statisticsStore: FlowQueryIndexServiceState;
+    readonly statisticsWorker: FlowQueryIndexServiceState;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexField {
+    readonly name: string;
+    readonly direction: "asc" | "desc";
+    readonly encoding: "hashed" | "ordered";
+    readonly raw: Readonly<Record<string, unknown>>;
+}
 interface FlowQueryIndexFormat {
     readonly queryRow: string;
     readonly key: string;
@@ -1204,22 +1230,81 @@ interface FlowQueryIndexFormat {
     readonly counter?: string;
     readonly raw: Readonly<Record<string, unknown>>;
 }
+interface FlowQueryIndexCoverage {
+    readonly completeShards: FlowQueryInteger;
+    readonly totalShards: FlowQueryInteger;
+    readonly validation: "pending" | "passed" | "failed";
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexProgress {
+    readonly scope: "catalog_build";
+    readonly phaseCounts: Readonly<Record<string, FlowQueryInteger>>;
+    readonly currentPhases: readonly string[];
+    readonly completedShards: FlowQueryInteger;
+    readonly totalShards: FlowQueryInteger;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexBuild extends FlowQueryIndexProgress {
+    readonly scannedRecords: FlowQueryInteger;
+    readonly writtenEntries: FlowQueryInteger;
+    readonly writtenBytes: FlowQueryInteger;
+}
+interface FlowQueryIndexValidation extends FlowQueryIndexProgress {
+    readonly status: "pending" | "passed" | "failed";
+    readonly checkedRecords: FlowQueryInteger;
+    readonly checkedEntries: FlowQueryInteger;
+    readonly mismatches: FlowQueryInteger;
+    readonly failureReason?: string;
+    readonly validatedAtMs?: FlowQueryInteger;
+}
+interface FlowQueryIndexRetirement {
+    readonly status: "not_applicable" | "pending" | "complete";
+    readonly phaseCounts?: Readonly<Record<string, FlowQueryInteger>>;
+    readonly currentPhases?: readonly string[];
+    readonly completedShards?: FlowQueryInteger;
+    readonly totalShards?: FlowQueryInteger;
+    readonly deletedEntries?: FlowQueryInteger;
+    readonly deletedBytes?: FlowQueryInteger;
+    readonly rewrittenReverseRows?: FlowQueryInteger;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexStatistics {
+    readonly status: "fresh" | "stale" | "future" | "mixed" | "missing" | "unavailable";
+    readonly samples: FlowQueryInteger;
+    readonly freshSamples: FlowQueryInteger;
+    readonly staleSamples: FlowQueryInteger;
+    readonly futureSamples: FlowQueryInteger;
+    readonly oldestCollectedAtMs?: FlowQueryInteger;
+    readonly newestCollectedAtMs?: FlowQueryInteger;
+    readonly oldestAgeMs?: FlowQueryInteger;
+    readonly newestAgeMs?: FlowQueryInteger;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
 interface FlowQueryIndex {
     readonly id: string;
     readonly version: FlowQueryInteger;
     readonly buildId: string;
-    readonly state: string;
+    readonly source: "runs";
+    readonly state: "building" | "validating" | "active" | "retiring" | "failed";
     readonly queryable: boolean;
+    readonly fields: readonly FlowQueryIndexField[];
+    readonly workloads: readonly string[];
+    readonly countPrefixes: readonly number[];
     readonly coveringFields: readonly string[];
     readonly format: FlowQueryIndexFormat;
+    readonly coverage: FlowQueryIndexCoverage;
+    readonly build: FlowQueryIndexBuild;
+    readonly validation: FlowQueryIndexValidation;
+    readonly retirement: FlowQueryIndexRetirement;
+    readonly statistics: FlowQueryIndexStatistics;
     readonly raw: Readonly<Record<string, unknown>>;
 }
 interface FlowQueryIndexStatus {
     readonly contractVersion: "ferric.flow.query.indexes/v1";
-    readonly observedAtMs: number;
-    readonly statisticsMaxAgeMs: number;
+    readonly observedAtMs: FlowQueryInteger;
+    readonly statisticsMaxAgeMs: FlowQueryInteger;
     readonly registry: FlowQueryIndexRegistry;
-    readonly services: Readonly<Record<string, unknown>>;
+    readonly services: FlowQueryIndexServices;
     readonly indexes: readonly FlowQueryIndex[];
     readonly raw: Readonly<Record<string, unknown>>;
 }
@@ -2567,7 +2652,7 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.5.1";
+declare const FERRICSTORE_SDK_VERSION = "0.5.2";
 /** Oldest FerricStore server supported by this breaking beta contract. */
 declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.0";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
@@ -2576,4 +2661,4 @@ declare const FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 /** @deprecated Use RequestDisposition; retained for source compatibility. */
 type ConnectionRequestDisposition = RequestDisposition;
 
-export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexFormat, type FlowQueryIndexRegistry, type FlowQueryIndexStatus, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleFireDueOptions, type ScheduleListOptions, type ScheduleOptions, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };
+export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleFireDueOptions, type ScheduleListOptions, type ScheduleOptions, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };

package/dist/index.d.ts

@@ -1122,10 +1122,10 @@ interface FlowQueryPage {
     readonly cursor?: string;
 }
 interface FlowQueryQuality {
-    readonly exactness: string;
-    readonly freshness: string;
-    readonly coverage: string;
-    readonly pagination: string;
+    readonly exactness: "authoritative" | "projected_exact" | "exact" | "not_applicable";
+    readonly freshness: "current" | "projection_watermark" | "not_applicable";
+    readonly coverage: "complete" | "unavailable";
+    readonly pagination: "none" | "complete" | "authenticated_seek" | "live_seek";
 }
 interface FlowQueryUsage {
     readonly rangeSeeks: number;
@@ -1181,13 +1181,25 @@ declare class FlowQueryError extends FerricStoreError {
         readonly cause?: unknown;
     });
 }
+interface FlowExplainCapabilities {
+    readonly requested: readonly string[];
+    readonly available: readonly string[];
+    readonly missing: readonly string[];
+    readonly raw: Readonly<Record<string, unknown>>;
+}
 interface FlowExplainResult {
     readonly version: "ferric.flow.explain/v1";
     readonly queryFingerprint: string;
     readonly status: "planned" | "rejected" | "executed";
     readonly plan: Readonly<Record<string, unknown>>;
     readonly estimate: Readonly<Record<string, unknown>>;
+    readonly stats?: Readonly<Record<string, unknown>>;
+    readonly quality?: FlowQueryQuality;
     readonly bounds: Readonly<Record<string, unknown>>;
+    readonly pressure?: Readonly<Record<string, unknown>>;
+    readonly decision?: Readonly<Record<string, unknown>>;
+    readonly alternatives: readonly Readonly<Record<string, unknown>>[];
+    readonly capabilities?: FlowExplainCapabilities;
     readonly actual?: FlowQueryUsage;
     readonly diagnostic?: FlowQueryError;
     readonly raw: Readonly<Record<string, unknown>>;
@@ -1196,6 +1208,20 @@ interface FlowQueryIndexRegistry {
     readonly epoch: FlowQueryInteger;
     readonly catalogVersion: FlowQueryInteger;
 }
+type FlowQueryIndexServiceState = "ready" | "unavailable";
+interface FlowQueryIndexServices {
+    readonly registry: FlowQueryIndexServiceState;
+    readonly lifecycleWorker: FlowQueryIndexServiceState;
+    readonly statisticsStore: FlowQueryIndexServiceState;
+    readonly statisticsWorker: FlowQueryIndexServiceState;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexField {
+    readonly name: string;
+    readonly direction: "asc" | "desc";
+    readonly encoding: "hashed" | "ordered";
+    readonly raw: Readonly<Record<string, unknown>>;
+}
 interface FlowQueryIndexFormat {
     readonly queryRow: string;
     readonly key: string;
@@ -1204,22 +1230,81 @@ interface FlowQueryIndexFormat {
     readonly counter?: string;
     readonly raw: Readonly<Record<string, unknown>>;
 }
+interface FlowQueryIndexCoverage {
+    readonly completeShards: FlowQueryInteger;
+    readonly totalShards: FlowQueryInteger;
+    readonly validation: "pending" | "passed" | "failed";
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexProgress {
+    readonly scope: "catalog_build";
+    readonly phaseCounts: Readonly<Record<string, FlowQueryInteger>>;
+    readonly currentPhases: readonly string[];
+    readonly completedShards: FlowQueryInteger;
+    readonly totalShards: FlowQueryInteger;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexBuild extends FlowQueryIndexProgress {
+    readonly scannedRecords: FlowQueryInteger;
+    readonly writtenEntries: FlowQueryInteger;
+    readonly writtenBytes: FlowQueryInteger;
+}
+interface FlowQueryIndexValidation extends FlowQueryIndexProgress {
+    readonly status: "pending" | "passed" | "failed";
+    readonly checkedRecords: FlowQueryInteger;
+    readonly checkedEntries: FlowQueryInteger;
+    readonly mismatches: FlowQueryInteger;
+    readonly failureReason?: string;
+    readonly validatedAtMs?: FlowQueryInteger;
+}
+interface FlowQueryIndexRetirement {
+    readonly status: "not_applicable" | "pending" | "complete";
+    readonly phaseCounts?: Readonly<Record<string, FlowQueryInteger>>;
+    readonly currentPhases?: readonly string[];
+    readonly completedShards?: FlowQueryInteger;
+    readonly totalShards?: FlowQueryInteger;
+    readonly deletedEntries?: FlowQueryInteger;
+    readonly deletedBytes?: FlowQueryInteger;
+    readonly rewrittenReverseRows?: FlowQueryInteger;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
+interface FlowQueryIndexStatistics {
+    readonly status: "fresh" | "stale" | "future" | "mixed" | "missing" | "unavailable";
+    readonly samples: FlowQueryInteger;
+    readonly freshSamples: FlowQueryInteger;
+    readonly staleSamples: FlowQueryInteger;
+    readonly futureSamples: FlowQueryInteger;
+    readonly oldestCollectedAtMs?: FlowQueryInteger;
+    readonly newestCollectedAtMs?: FlowQueryInteger;
+    readonly oldestAgeMs?: FlowQueryInteger;
+    readonly newestAgeMs?: FlowQueryInteger;
+    readonly raw: Readonly<Record<string, unknown>>;
+}
 interface FlowQueryIndex {
     readonly id: string;
     readonly version: FlowQueryInteger;
     readonly buildId: string;
-    readonly state: string;
+    readonly source: "runs";
+    readonly state: "building" | "validating" | "active" | "retiring" | "failed";
     readonly queryable: boolean;
+    readonly fields: readonly FlowQueryIndexField[];
+    readonly workloads: readonly string[];
+    readonly countPrefixes: readonly number[];
     readonly coveringFields: readonly string[];
     readonly format: FlowQueryIndexFormat;
+    readonly coverage: FlowQueryIndexCoverage;
+    readonly build: FlowQueryIndexBuild;
+    readonly validation: FlowQueryIndexValidation;
+    readonly retirement: FlowQueryIndexRetirement;
+    readonly statistics: FlowQueryIndexStatistics;
     readonly raw: Readonly<Record<string, unknown>>;
 }
 interface FlowQueryIndexStatus {
     readonly contractVersion: "ferric.flow.query.indexes/v1";
-    readonly observedAtMs: number;
-    readonly statisticsMaxAgeMs: number;
+    readonly observedAtMs: FlowQueryInteger;
+    readonly statisticsMaxAgeMs: FlowQueryInteger;
     readonly registry: FlowQueryIndexRegistry;
-    readonly services: Readonly<Record<string, unknown>>;
+    readonly services: FlowQueryIndexServices;
     readonly indexes: readonly FlowQueryIndex[];
     readonly raw: Readonly<Record<string, unknown>>;
 }
@@ -2567,7 +2652,7 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.5.1";
+declare const FERRICSTORE_SDK_VERSION = "0.5.2";
 /** Oldest FerricStore server supported by this breaking beta contract. */
 declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.0";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
@@ -2576,4 +2661,4 @@ declare const FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 /** @deprecated Use RequestDisposition; retained for source compatibility. */
 type ConnectionRequestDisposition = RequestDisposition;
 
-export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexFormat, type FlowQueryIndexRegistry, type FlowQueryIndexStatus, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleFireDueOptions, type ScheduleListOptions, type ScheduleOptions, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };
+export { type AdminListOptions, type ApprovalListOptions, type ApprovalRequestOptions, type AttributeQueryOptions, type AutoBatchOptions, type BackoffKind, type BackpressurePolicy, BitmapStore, BloomFilterStore, type BudgetCommitOptions, type BudgetReserveOptions, COMMAND_OPCODES, type CancelOptions, type ChildSpec, type CircuitOpenOptions, type ClaimDueOptions, ClaimHydrationError, type ClaimHydrationItem, type ClaimedItem, type Codec, type CollectionScanOptions, type Command, type CommandArgument, type CommandExecutor, type CompleteJobsAndClaimJobsResult, type CompleteManyOptions, type CompleteOptions, type CompleteOutcome, ConnectionClosedError, type ConnectionRequestDisposition, type CountMinMergeOptions, CountMinSketchStore, type CreateItem, type CreateManyOptions, type CreateOptions, CuckooFilterStore, type EffectCompensateOptions, type EffectConfirmOptions, type EffectFailOptions, type EffectReserveOptions, type EffectStatusOptions, type EndpointPolicy, type ExceptionPolicy, type ExecutePipelineOptions, type ExpiryCondition, type ExtendLeaseOptions, FERRICSTORE_MINIMUM_SERVER_VERSION, FERRICSTORE_NATIVE_PROTOCOL_VERSION, FERRICSTORE_SDK_VERSION, type FailOptions, type FailOutcome, type FencedItem, type FencingToken, FerricStoreClient, type FerricStoreClientFromUrlOptions, type FerricStoreClientOptions, FerricStoreError, type FetchOrComputeComputeResult, type FetchOrComputeFencedResult, type FetchOrComputeHitResult, type FetchOrComputeResult, type FlowAdminRecord, FlowAlreadyExistsError, type FlowBatchCompletedItem, FlowBatchError, type FlowEventProjectionField, type FlowExplainCapabilities, type FlowExplainResult, type FlowMaxActiveFailure, FlowNotFoundError, type FlowPolicyBackoffKind, type FlowPolicyBackoffSnapshot, type FlowPolicyOptions, type FlowPolicyRetentionSnapshot, type FlowPolicyRetrySnapshot, type FlowPolicySnapshot, type FlowPolicyStateSnapshot, FlowProjection, type FlowProjectionField, type FlowProjectionShape, type FlowQueryCountResult, FlowQueryError, type FlowQueryErrorPosition, type FlowQueryIndex, type FlowQueryIndexBuild, type FlowQueryIndexCoverage, type FlowQueryIndexField, type FlowQueryIndexFormat, type FlowQueryIndexProgress, type FlowQueryIndexRegistry, type FlowQueryIndexRetirement, type FlowQueryIndexServiceState, type FlowQueryIndexServices, type FlowQueryIndexStatistics, type FlowQueryIndexStatus, type FlowQueryIndexValidation, type FlowQueryInteger, type FlowQueryPage, type FlowQueryParameter, type FlowQueryParameters, type FlowQueryQuality, type FlowQueryRecord, type FlowQueryRecordsResult, type FlowQueryResult, type FlowQueryUsage, type FlowRecord, type FlowRunProjectionField, type FlowStateMode, type FlowStatePolicy, type FlowStatePolicyLike, type FlowStatsOptions, FlowWrongStateError, type GeoAddOptions, type GeoMember, GeoStore, type GetExOptions, type GovernanceLedgerOptions, type HashScanResult, HashStore, type HistoryOptions, HyperLogLogStore, type IntegerReply, InvalidCommandError, type InvocationCreateOptions, JsonCodec, type KeyInfo, KeyValueStore, type LeaseMutationOptions, LeaseRenewalError, type LimitAmountOptions, type LimitLeaseOptions, type LimitListOptions, type LimitReleaseOptions, ListStore, LockHeldError, LockNotOwnedError, MAX_FLOW_POLICY_GENERATION, type ManagementPairs, type MaxActiveMs, type MutateOptions, type NamedValueMutation, NativeAdapter, type NativeAdapterOptions, type NativeClientOptions, type NativeProtocolEvent, type Outcome, OverloadedError, type ProtocolCommand, Queue, type QueueBatchHandler, QueueClient, QueueCompletionError, type QueueHandler, type QueueJob, type QueueOptions, QueueWorker, type QueueWorkerResult, type RangeLimit, type RateLimitResult, RawCodec, type ReadOptions, type ReclaimOptions, type ReconnectOptions, ReconnectingExecutor, type RequestContext, type RequestContextOptions, type RequestDisposition, RequestTimeoutError, RerouteError, type RetryOptions, type RetryOutcome, type RetryPolicy, type RoutingEndpoint, type RoutingRoute, RoutingTopology, type RunStepsItem, type RunStepsManyOptions, type ScanOptions, type ScheduleFireDueOptions, type ScheduleListOptions, type ScheduleOptions, type SearchOptions, type SearchStateMeta, type SetOptions, type SetScanResult, SetStore, type SortedSetScanResult, SortedSetStore, StaleLeaseError, StalePolicyGenerationError, type StartAndClaimOptions, type StateMeta, type StateMetaValue, type StateOptions, type StateRegistration, type StepContinueOptions, type StoreCommandClient, StreamStore, type TDigestCreateOptions, type TDigestMergeOptions, TDigestStore, type TopKReserveOptions, TopKStore, type TopologyNativeAdapterOptions, TopologyNativeAdapterPool, type TransitionOptions, type TransitionOutcome, type ValueConfig, type WorkerConfig, type WorkerProfile, type WorkerRefillStrategy, Workflow, WorkflowClient, WorkflowContext, WorkflowFlowCommands, type WorkflowHandler, type WorkflowOptions, WorkflowWorker, type WorkflowWorkerResult, type XReadStream, type ZAddMember, type ZAddOptions, classifyServerError, complete, fail, isOutcome, isReconnectableClosedConnectionError, mapException, projectFlowQuery, retry, transition };