/** * Authoritative, transport-independent ownership for one Telegram input. * * This module deliberately does not infer intent. It accepts only exact * identities and monotonic owner generations, then preserves the first * committed decision and delivery receipt. Callers can therefore retry an * operation without replacing an already-authoritative result. */ export type TelegramTurnDispositionKind = "no_reply" | "chat_reply" | "action"; export type TelegramInputLifecycleState = "received" | "classified" | "queued" | "dispatched" | "deferred" | "decision_committed" | "delivery_committed" | "consumed" | "superseded" | "failed"; export type TelegramInputTerminalLifecycleState = "consumed" | "superseded" | "failed"; export interface TelegramInputTargetBinding { readonly inputId: string; readonly sessionKey: string; readonly chatId: string; readonly messageId: number; readonly messageThreadId: number; readonly senderActorKey: string; } export interface TelegramInputOwnerClaim { readonly ownerId: string; readonly generation: number; } export interface TelegramInputDecisionCommit { readonly decisionId: string; readonly contractFingerprint: string; readonly contractVersion: 2; readonly disposition: TelegramTurnDispositionKind; readonly committedBy: TelegramInputOwnerClaim; readonly committedAtMs: number; } export type TelegramInputDeliveryKind = "visible_reply" | "action_effect"; export interface TelegramInputDeliveryCommit { readonly deliveryId: string; readonly decisionId: string; readonly kind: TelegramInputDeliveryKind; readonly transportReceiptId: string; readonly committedBy: TelegramInputOwnerClaim; readonly committedAtMs: number; } export interface TelegramInputLifecycleEvent { readonly state: TelegramInputLifecycleState; readonly atMs: number; readonly owner: TelegramInputOwnerClaim; } export interface TelegramInputOwnershipRecord { readonly target: TelegramInputTargetBinding; readonly owner: TelegramInputOwnerClaim; readonly lifecycle: TelegramInputLifecycleState; readonly revision: number; readonly decision?: TelegramInputDecisionCommit; readonly delivery?: TelegramInputDeliveryCommit; readonly terminal?: TelegramInputTerminalLifecycleState; readonly history: readonly TelegramInputLifecycleEvent[]; } export type TelegramInputMutationStatus = "applied" | "duplicate" | "stale" | "contradiction" | "terminal" | "invalid_transition" | "unknown_input"; export interface TelegramInputMutationResult { readonly status: TelegramInputMutationStatus; readonly record?: TelegramInputOwnershipRecord; readonly reason?: string; } export declare function createTelegramInputTargetBinding(target: TelegramInputTargetBinding): TelegramInputTargetBinding; export declare function telegramInputTargetsEqual(left: TelegramInputTargetBinding, right: TelegramInputTargetBinding): boolean; export declare function isTelegramInputTerminalLifecycle(state: TelegramInputLifecycleState): state is TelegramInputTerminalLifecycleState; /** In-memory authority primitive. Persistence remains the caller's concern. */ export declare class TelegramInputOwnershipLedger { private readonly records; get(inputId: string): TelegramInputOwnershipRecord | undefined; register(targetInput: TelegramInputTargetBinding, ownerInput: TelegramInputOwnerClaim, atMs?: number): TelegramInputMutationResult; claim(targetInput: TelegramInputTargetBinding, ownerInput: TelegramInputOwnerClaim): TelegramInputMutationResult; transition(targetInput: TelegramInputTargetBinding, ownerInput: TelegramInputOwnerClaim, nextState: TelegramInputLifecycleState, atMs?: number): TelegramInputMutationResult; commitDecision(targetInput: TelegramInputTargetBinding, ownerInput: TelegramInputOwnerClaim, decisionInput: Omit, atMs?: number): TelegramInputMutationResult; commitDelivery(targetInput: TelegramInputTargetBinding, ownerInput: TelegramInputOwnerClaim, deliveryInput: Omit, atMs?: number): TelegramInputMutationResult; complete(targetInput: TelegramInputTargetBinding, ownerInput: TelegramInputOwnerClaim, terminal: TelegramInputTerminalLifecycleState, atMs?: number): TelegramInputMutationResult; private boundRecord; private authorizedRecord; private storeLifecycle; }