@ferricstore/ferricstore 0.5.2 → 0.11.4

package/dist/index.d.cts

@@ -681,6 +681,63 @@ interface FlowRecord<TPayload = unknown> {
 }
 
 type FlowAdminRecord = Record<string, unknown>;
+/** Bounded interval recovery; missed occurrences are coalesced into one fire. */
+type ScheduleCatchupPolicy = "fire_once";
+type ScheduleKind = "one_shot" | "delay" | "interval" | "cron";
+type ScheduleState = "active" | "paused" | "running" | "completed" | "failed" | "cancelled";
+type ScheduleOverlapPolicy = "allow" | "skip" | "queue_after_previous" | "fail_schedule";
+/** Canonical durable schedule returned by create, get, pause, resume, and list. */
+type ScheduleRecord = FlowAdminRecord & {
+    id: string;
+    kind: ScheduleKind;
+    state: ScheduleState;
+    target: Record<string, unknown>;
+    created_at_ms: number;
+    /** Interval period, or `null` for non-interval schedules. */
+    every_ms: number | null;
+    /** Cron expression, or `null` for non-cron schedules. */
+    cron: string | null;
+    /** IANA timezone, or `null` for non-cron schedules. */
+    timezone: string | null;
+    /** `fire_once` for interval schedules and `null` for other kinds. */
+    catchup_policy: ScheduleCatchupPolicy | null;
+    /** Cumulative elapsed interval occurrences intentionally not replayed. */
+    coalesced_count: number;
+    /** Wall-clock recovery time of the latest bounded catch-up. */
+    last_catchup_at_ms?: number | null;
+    /** Occurrences coalesced by the latest recovery fire. */
+    last_coalesced_count: number;
+    /** Actionable recurrence error when `end_reason` is `planning_failed`. */
+    last_planning_error?: string | null;
+    overlap_policy: ScheduleOverlapPolicy;
+    /** Optional retry override for `queue_after_previous`. */
+    overlap_retry_ms: number | null;
+    next_run_at_ms?: number | null;
+    /** Targets actually created; coalesced occurrences are excluded. */
+    fire_count: number;
+    attempts: number;
+    skipped_count: number;
+};
+/** Aggregate outcome from one bounded due-schedule claim batch. */
+type ScheduleFireDueResult = FlowAdminRecord & {
+    claimed: number;
+    fired: number;
+    skipped: number;
+    coalesced: number;
+    errors: [string, string][];
+    /** Batch-level failure encountered while requesting a later claim wave. */
+    claim_error?: string | null;
+    last_target_id?: string;
+    last_skip_reason?: string;
+};
+/** Outcome from one explicit schedule fire and its canonical schedule state. */
+type ScheduleFireResult = FlowAdminRecord & {
+    fired: 0 | 1;
+    skipped: 0 | 1;
+    target_id?: string;
+    reason?: string;
+    schedule: ScheduleRecord;
+};
 interface FlowStatsOptions {
     state?: string;
     partitionKey?: string;
@@ -696,14 +753,16 @@ interface AttributeQueryOptions {
 }
 interface ScheduleOptions {
     target: Record<string, unknown>;
-    kind?: string;
+    kind?: ScheduleKind;
     atMs?: number;
     delayMs?: number;
     startAtMs?: number;
     everyMs?: number;
     cron?: string;
     timezone?: string;
-    overlapPolicy?: string;
+    /** Interval-only recovery policy. Defaults to `fire_once`. */
+    catchupPolicy?: ScheduleCatchupPolicy;
+    overlapPolicy?: ScheduleOverlapPolicy;
     overlapRetryMs?: number;
     maxFires?: number;
     endAtMs?: number;
@@ -712,8 +771,8 @@ interface ScheduleOptions {
     extraOptions?: Record<string, CommandArgument>;
 }
 interface ScheduleListOptions {
-    kind?: string;
-    state?: string;
+    kind?: ScheduleKind;
+    state?: ScheduleState | "all";
     timezone?: string;
     targetType?: string;
     fromMs?: number;
@@ -724,9 +783,14 @@ interface ScheduleListOptions {
 interface ScheduleFireDueOptions {
     nowMs?: number;
     worker?: string;
+    leaseMs?: number;
     blockMs?: number;
     limit?: number;
 }
+interface ScheduleFireOptions {
+    fireAtMs?: number;
+    nowMs?: number;
+}
 interface EffectReserveOptions {
     partitionKey?: string;
     leaseToken?: Buffer;
@@ -1954,31 +2018,31 @@ declare class FerricStoreClientCore extends FerricStoreAdministrationClient {
     }): Promise<boolean>;
 }
 
-/** @internal Administrative and governance commands kept off the primary Flow client surface. */
-declare class FerricStoreManagementClient extends FerricStoreClientCore {
-    stats(type: string, options?: FlowStatsOptions): Promise<FlowAdminRecord>;
-    countByState(type: string, state: string, options?: Omit<FlowStatsOptions, "state" | "count">): Promise<number>;
-    attributes(type: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
-    attributeValues(type: string, attribute: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
-    scheduleCreate(id: string, options: ScheduleOptions): Promise<FlowAdminRecord>;
-    scheduleGet(id: string, options?: {
-        nowMs?: number;
-    }): Promise<FlowAdminRecord | null>;
-    scheduleFire(id: string, options?: {
-        nowMs?: number;
-    }): Promise<FlowAdminRecord>;
+/** @internal Schedule management surface shared by the complete Flow client. */
+declare class FerricStoreScheduleClient extends FerricStoreClientCore {
+    scheduleCreate(id: string, options: ScheduleOptions): Promise<ScheduleRecord>;
+    scheduleGet(id: string): Promise<ScheduleRecord | null>;
+    scheduleFire(id: string, options?: ScheduleFireOptions): Promise<ScheduleFireResult>;
     schedulePause(id: string, options?: {
         nowMs?: number;
-    }): Promise<FlowAdminRecord>;
+    }): Promise<ScheduleRecord>;
     scheduleResume(id: string, options?: {
         nowMs?: number;
-    }): Promise<FlowAdminRecord>;
+    }): Promise<ScheduleRecord>;
     scheduleDelete(id: string, options?: {
         nowMs?: number;
-    }): Promise<FlowAdminRecord>;
-    scheduleFireDue(options?: ScheduleFireDueOptions): Promise<FlowAdminRecord>;
-    scheduleList(options?: ScheduleListOptions): Promise<FlowAdminRecord[]>;
-    private scheduleStatus;
+    }): Promise<void>;
+    scheduleFireDue(options?: ScheduleFireDueOptions): Promise<ScheduleFireDueResult>;
+    scheduleList(options?: ScheduleListOptions): Promise<ScheduleRecord[]>;
+    private scheduleStatusResponse;
+}
+
+/** @internal Administrative and governance commands kept off the primary Flow client surface. */
+declare class FerricStoreManagementClient extends FerricStoreScheduleClient {
+    stats(type: string, options?: FlowStatsOptions): Promise<FlowAdminRecord>;
+    countByState(type: string, state: string, options?: Omit<FlowStatsOptions, "state" | "count">): Promise<number>;
+    attributes(type: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
+    attributeValues(type: string, attribute: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
     effectReserve(id: string, effectKey: string, effectType: string, options: EffectReserveOptions): Promise<FlowAdminRecord>;
     effectConfirm(id: string, effectKey: string, options?: EffectConfirmOptions): Promise<FlowAdminRecord>;
     effectFail(id: string, effectKey: string, options?: EffectFailOptions): Promise<FlowAdminRecord>;
@@ -2652,13 +2716,13 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.5.2";
+declare const FERRICSTORE_SDK_VERSION = "0.11.4";
 /** Oldest FerricStore server supported by this breaking beta contract. */
-declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.0";
+declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
 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 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 };
+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 ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, 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

@@ -681,6 +681,63 @@ interface FlowRecord<TPayload = unknown> {
 }
 
 type FlowAdminRecord = Record<string, unknown>;
+/** Bounded interval recovery; missed occurrences are coalesced into one fire. */
+type ScheduleCatchupPolicy = "fire_once";
+type ScheduleKind = "one_shot" | "delay" | "interval" | "cron";
+type ScheduleState = "active" | "paused" | "running" | "completed" | "failed" | "cancelled";
+type ScheduleOverlapPolicy = "allow" | "skip" | "queue_after_previous" | "fail_schedule";
+/** Canonical durable schedule returned by create, get, pause, resume, and list. */
+type ScheduleRecord = FlowAdminRecord & {
+    id: string;
+    kind: ScheduleKind;
+    state: ScheduleState;
+    target: Record<string, unknown>;
+    created_at_ms: number;
+    /** Interval period, or `null` for non-interval schedules. */
+    every_ms: number | null;
+    /** Cron expression, or `null` for non-cron schedules. */
+    cron: string | null;
+    /** IANA timezone, or `null` for non-cron schedules. */
+    timezone: string | null;
+    /** `fire_once` for interval schedules and `null` for other kinds. */
+    catchup_policy: ScheduleCatchupPolicy | null;
+    /** Cumulative elapsed interval occurrences intentionally not replayed. */
+    coalesced_count: number;
+    /** Wall-clock recovery time of the latest bounded catch-up. */
+    last_catchup_at_ms?: number | null;
+    /** Occurrences coalesced by the latest recovery fire. */
+    last_coalesced_count: number;
+    /** Actionable recurrence error when `end_reason` is `planning_failed`. */
+    last_planning_error?: string | null;
+    overlap_policy: ScheduleOverlapPolicy;
+    /** Optional retry override for `queue_after_previous`. */
+    overlap_retry_ms: number | null;
+    next_run_at_ms?: number | null;
+    /** Targets actually created; coalesced occurrences are excluded. */
+    fire_count: number;
+    attempts: number;
+    skipped_count: number;
+};
+/** Aggregate outcome from one bounded due-schedule claim batch. */
+type ScheduleFireDueResult = FlowAdminRecord & {
+    claimed: number;
+    fired: number;
+    skipped: number;
+    coalesced: number;
+    errors: [string, string][];
+    /** Batch-level failure encountered while requesting a later claim wave. */
+    claim_error?: string | null;
+    last_target_id?: string;
+    last_skip_reason?: string;
+};
+/** Outcome from one explicit schedule fire and its canonical schedule state. */
+type ScheduleFireResult = FlowAdminRecord & {
+    fired: 0 | 1;
+    skipped: 0 | 1;
+    target_id?: string;
+    reason?: string;
+    schedule: ScheduleRecord;
+};
 interface FlowStatsOptions {
     state?: string;
     partitionKey?: string;
@@ -696,14 +753,16 @@ interface AttributeQueryOptions {
 }
 interface ScheduleOptions {
     target: Record<string, unknown>;
-    kind?: string;
+    kind?: ScheduleKind;
     atMs?: number;
     delayMs?: number;
     startAtMs?: number;
     everyMs?: number;
     cron?: string;
     timezone?: string;
-    overlapPolicy?: string;
+    /** Interval-only recovery policy. Defaults to `fire_once`. */
+    catchupPolicy?: ScheduleCatchupPolicy;
+    overlapPolicy?: ScheduleOverlapPolicy;
     overlapRetryMs?: number;
     maxFires?: number;
     endAtMs?: number;
@@ -712,8 +771,8 @@ interface ScheduleOptions {
     extraOptions?: Record<string, CommandArgument>;
 }
 interface ScheduleListOptions {
-    kind?: string;
-    state?: string;
+    kind?: ScheduleKind;
+    state?: ScheduleState | "all";
     timezone?: string;
     targetType?: string;
     fromMs?: number;
@@ -724,9 +783,14 @@ interface ScheduleListOptions {
 interface ScheduleFireDueOptions {
     nowMs?: number;
     worker?: string;
+    leaseMs?: number;
     blockMs?: number;
     limit?: number;
 }
+interface ScheduleFireOptions {
+    fireAtMs?: number;
+    nowMs?: number;
+}
 interface EffectReserveOptions {
     partitionKey?: string;
     leaseToken?: Buffer;
@@ -1954,31 +2018,31 @@ declare class FerricStoreClientCore extends FerricStoreAdministrationClient {
     }): Promise<boolean>;
 }
 
-/** @internal Administrative and governance commands kept off the primary Flow client surface. */
-declare class FerricStoreManagementClient extends FerricStoreClientCore {
-    stats(type: string, options?: FlowStatsOptions): Promise<FlowAdminRecord>;
-    countByState(type: string, state: string, options?: Omit<FlowStatsOptions, "state" | "count">): Promise<number>;
-    attributes(type: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
-    attributeValues(type: string, attribute: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
-    scheduleCreate(id: string, options: ScheduleOptions): Promise<FlowAdminRecord>;
-    scheduleGet(id: string, options?: {
-        nowMs?: number;
-    }): Promise<FlowAdminRecord | null>;
-    scheduleFire(id: string, options?: {
-        nowMs?: number;
-    }): Promise<FlowAdminRecord>;
+/** @internal Schedule management surface shared by the complete Flow client. */
+declare class FerricStoreScheduleClient extends FerricStoreClientCore {
+    scheduleCreate(id: string, options: ScheduleOptions): Promise<ScheduleRecord>;
+    scheduleGet(id: string): Promise<ScheduleRecord | null>;
+    scheduleFire(id: string, options?: ScheduleFireOptions): Promise<ScheduleFireResult>;
     schedulePause(id: string, options?: {
         nowMs?: number;
-    }): Promise<FlowAdminRecord>;
+    }): Promise<ScheduleRecord>;
     scheduleResume(id: string, options?: {
         nowMs?: number;
-    }): Promise<FlowAdminRecord>;
+    }): Promise<ScheduleRecord>;
     scheduleDelete(id: string, options?: {
         nowMs?: number;
-    }): Promise<FlowAdminRecord>;
-    scheduleFireDue(options?: ScheduleFireDueOptions): Promise<FlowAdminRecord>;
-    scheduleList(options?: ScheduleListOptions): Promise<FlowAdminRecord[]>;
-    private scheduleStatus;
+    }): Promise<void>;
+    scheduleFireDue(options?: ScheduleFireDueOptions): Promise<ScheduleFireDueResult>;
+    scheduleList(options?: ScheduleListOptions): Promise<ScheduleRecord[]>;
+    private scheduleStatusResponse;
+}
+
+/** @internal Administrative and governance commands kept off the primary Flow client surface. */
+declare class FerricStoreManagementClient extends FerricStoreScheduleClient {
+    stats(type: string, options?: FlowStatsOptions): Promise<FlowAdminRecord>;
+    countByState(type: string, state: string, options?: Omit<FlowStatsOptions, "state" | "count">): Promise<number>;
+    attributes(type: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
+    attributeValues(type: string, attribute: string, options?: AttributeQueryOptions): Promise<FlowAdminRecord[]>;
     effectReserve(id: string, effectKey: string, effectType: string, options: EffectReserveOptions): Promise<FlowAdminRecord>;
     effectConfirm(id: string, effectKey: string, options?: EffectConfirmOptions): Promise<FlowAdminRecord>;
     effectFail(id: string, effectKey: string, options?: EffectFailOptions): Promise<FlowAdminRecord>;
@@ -2652,13 +2716,13 @@ declare class WorkflowWorker {
 }
 
 /** TypeScript SDK package version. */
-declare const FERRICSTORE_SDK_VERSION = "0.5.2";
+declare const FERRICSTORE_SDK_VERSION = "0.11.4";
 /** Oldest FerricStore server supported by this breaking beta contract. */
-declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.0";
+declare const FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 /** Native framing and opcode ABI version; unchanged by FerricStore 0.11. */
 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 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 };
+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 ScheduleCatchupPolicy, type ScheduleFireDueOptions, type ScheduleFireDueResult, type ScheduleFireOptions, type ScheduleFireResult, type ScheduleKind, type ScheduleListOptions, type ScheduleOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleState, 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 };