@rudderhq/server 0.4.6-canary.8 → 0.5.0

package/dist/services/chats.d.ts

@@ -1,7 +1,16 @@
 import type { Db } from "@rudderhq/db";
-import { approvals, chatConversations, chatGenerations } from "@rudderhq/db";
-import { type ChatQueuedMessagePayload, type ChatStreamTranscriptEntry } from "@rudderhq/shared";
+import { approvals, chatControlActions, chatConversations, chatGenerationEvents, chatGenerations, chatQueuedMessages } from "@rudderhq/db";
+import { type ChatControlDisposition, type ChatProviderControlDisposition, type ChatQueuedMessage, type ChatQueuedMessagePayload, type ChatQueuedMessageStatus, type ChatQueueRequestActor, type ChatStreamTranscriptEntry } from "@rudderhq/shared";
+type ChatQueuedMessageRow = typeof chatQueuedMessages.$inferSelect;
 type ChatGenerationRow = typeof chatGenerations.$inferSelect;
+type ChatControlActionRow = typeof chatControlActions.$inferSelect;
+export type ChatServerQueueClaim = {
+    item: ChatQueuedMessage;
+    generationId: string;
+    userMessageId: string;
+    leaseToken: string;
+    leaseEpoch: number;
+};
 type ConversationSummaryCursor = {
     activityAt: Date;
     title: string;
@@ -16,10 +25,916 @@ type ConversationSourceMetadata = {
 };
 type ApprovalRow = typeof approvals.$inferSelect;
 export declare function chatService(db: Db): {
+    generationProtocol: {
+        getLatestVisibleCheckpoint: (input: {
+            orgId: string;
+            conversationId: string;
+            generationId: string;
+        }) => Promise<{
+            generation: {
+                id: string;
+                orgId: string;
+                conversationId: string;
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                terminalReason: string | null;
+                attemptEpoch: number;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            generationSeq: number;
+            bodyHash: string;
+        }>;
+        appendGenerationEvent: (input: {
+            orgId: string;
+            generationId: string;
+            attemptEpoch: number;
+            eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+            payload?: Record<string, unknown>;
+            bodyOffset?: number | null;
+            bodyLength?: number | null;
+            assistantMessageId?: string | null;
+            runId?: string | null;
+            controlActionId?: string | null;
+            queueItemId?: string | null;
+            emittedAt?: Date | null;
+        } & {
+            conversationId?: string;
+            expectedOwnerToken?: string | null;
+            admission: "visible" | "control" | "diagnostic";
+            bodyHash?: string;
+            lateBytes?: number;
+        }) => Promise<{
+            event: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            };
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+        }>;
+        appendVisibleEventAndProject: (input: Omit<{
+            orgId: string;
+            generationId: string;
+            attemptEpoch: number;
+            eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+            payload?: Record<string, unknown>;
+            bodyOffset?: number | null;
+            bodyLength?: number | null;
+            assistantMessageId?: string | null;
+            runId?: string | null;
+            controlActionId?: string | null;
+            queueItemId?: string | null;
+            emittedAt?: Date | null;
+        }, "attemptEpoch" | "assistantMessageId"> & {
+            orgId: string;
+            conversationId: string;
+            generationId: string;
+            expectedAttemptEpoch: number;
+            expectedOwnerToken?: string | null;
+            bodyHash: string;
+            messageId?: string | null;
+            body: string;
+            transcript: ChatStreamTranscriptEntry[];
+            replyingAgentId?: string | null;
+            chatTurnId: string;
+            turnVariant: number;
+        }) => Promise<{
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            message: {
+                status: string;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                kind: string;
+                createdAt: Date;
+                updatedAt: Date;
+                runId: string | null;
+                body: string;
+                role: string;
+                approvalId: string | null;
+                structuredPayload: Record<string, unknown> | null;
+                replyingAgentId: string | null;
+                chatTurnId: string | null;
+                turnVariant: number;
+                supersededAt: Date | null;
+            };
+            event: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            };
+        }>;
+        getFrozenVisibleProjection: (input: {
+            orgId: string;
+            conversationId: string;
+            generationId: string;
+        }) => Promise<{
+            generation: {
+                id: string;
+                orgId: string;
+                conversationId: string;
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                terminalReason: string | null;
+                attemptEpoch: number;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            checkpoint: {
+                generationSeq: number;
+                bodyHash: string;
+            };
+            projection: {
+                body: string;
+                transcript: ChatStreamTranscriptEntry[];
+                assistantMessageId: string | null;
+                runId: string | null;
+            };
+        }>;
+        recordClientCheckpoint: (input: {
+            orgId: string;
+            conversationId: string;
+            generationId: string;
+            expectedAttemptEpoch: number;
+            expectedOwnerToken?: string | null;
+            generationSeq: number;
+            renderedBodyHash: string;
+            now?: Date;
+        }) => Promise<{
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            event: null;
+            advanced: boolean;
+        } | {
+            generation: {
+                id: string;
+                orgId: string;
+                conversationId: string;
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                terminalReason: string | null;
+                attemptEpoch: number;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            event: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            };
+            advanced: boolean;
+        }>;
+        beginStopAction: (input: {
+            orgId: string;
+            conversationId: string;
+            controlActionId: string;
+            expectedGenerationId: string;
+            expectedAttemptEpoch: number;
+            expectedControlVersion: number;
+            requestedRenderSeq: number;
+            requestedBodyHash: string;
+            now?: Date;
+        }) => Promise<{
+            action: {
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                resolvedAt: Date | null;
+                expectedGenerationId: string | null;
+                expectedAttemptEpoch: number | null;
+                expectedControlVersion: number | null;
+                lastError: string | null;
+                requestedAt: Date;
+                controlOwnerToken: string | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                frozenBodyHash: string | null;
+                appliedControlVersion: number | null;
+                actionKind: import("@rudderhq/shared").ChatControlActionKind;
+                localDisposition: ChatControlDisposition;
+                providerDisposition: ChatProviderControlDisposition | null;
+                providerClientMessageId: string | null;
+                providerEvidence: Record<string, unknown> | null;
+                requestedRenderSeq: number | null;
+                requestedBodyHash: string | null;
+                providerSentAt: Date | null;
+                providerAcknowledgedAt: Date | null;
+            };
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            stopRequestedEvent: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            } | null;
+            outputCutoffEvent: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            } | null;
+            outcome: "stop_applied" | "completion_committed";
+            idempotent: boolean;
+        }>;
+        beginSteerFallbackCutoff: (input: {
+            orgId: string;
+            conversationId: string;
+            generationId: string;
+            expectedAttemptEpoch: number;
+            controlActionId: string;
+            queueItemId: string;
+            requestedRenderSeq?: number;
+            requestedBodyHash?: string;
+            now?: Date;
+        }) => Promise<{
+            action: {
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                resolvedAt: Date | null;
+                expectedGenerationId: string | null;
+                expectedAttemptEpoch: number | null;
+                expectedControlVersion: number | null;
+                lastError: string | null;
+                requestedAt: Date;
+                controlOwnerToken: string | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                frozenBodyHash: string | null;
+                appliedControlVersion: number | null;
+                actionKind: import("@rudderhq/shared").ChatControlActionKind;
+                localDisposition: ChatControlDisposition;
+                providerDisposition: ChatProviderControlDisposition | null;
+                providerClientMessageId: string | null;
+                providerEvidence: Record<string, unknown> | null;
+                requestedRenderSeq: number | null;
+                requestedBodyHash: string | null;
+                providerSentAt: Date | null;
+                providerAcknowledgedAt: Date | null;
+            };
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            item: typeof chatQueuedMessages.$inferSelect;
+            outputCutoffEvent: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            } | null;
+            continuationEvent: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            } | null;
+            outcome: "cutoff_applied" | "completion_committed";
+            idempotent: boolean;
+        }>;
+        recordRuntimeTerminal: (input: {
+            orgId: string;
+            conversationId: string;
+            generationId: string;
+            expectedAttemptEpoch: number;
+            expectedOwnerToken?: string | null;
+            finalStatus: Extract<import("@rudderhq/shared").ChatGenerationStatus, "completed" | "failed" | "stopped" | "aborted" | "interrupted_unverified">;
+            terminalReason: string;
+            controlActionId?: string | null;
+            payload?: Record<string, unknown>;
+            now?: Date;
+        }) => Promise<{
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            event: null;
+            outbox: {
+                id: string;
+                orgId: string;
+                generationId: string;
+                sourceEventId: string;
+                projectionVersion: number;
+                projectorVersion: number;
+                expectedControlVersion: number;
+                status: import("@rudderhq/shared").ChatTerminalOutboxStatus;
+                payload: Record<string, unknown>;
+                claimToken: string | null;
+                claimEpoch: number;
+                claimOwner: string | null;
+                leaseExpiresAt: Date | null;
+                attemptCount: number;
+                replayCount: number;
+                availableAt: Date;
+                lastAttemptAt: Date | null;
+                lastError: string | null;
+                projectedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            idempotent: boolean;
+        } | {
+            generation: {
+                id: string;
+                orgId: string;
+                conversationId: string;
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                terminalReason: string | null;
+                attemptEpoch: number;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            event: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            };
+            outbox: {
+                status: import("@rudderhq/shared").ChatTerminalOutboxStatus;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                payload: Record<string, unknown>;
+                expectedControlVersion: number;
+                generationId: string;
+                lastError: string | null;
+                lastAttemptAt: Date | null;
+                sourceEventId: string;
+                projectionVersion: number;
+                projectorVersion: number;
+                claimToken: string | null;
+                claimEpoch: number;
+                claimOwner: string | null;
+                leaseExpiresAt: Date | null;
+                attemptCount: number;
+                replayCount: number;
+                availableAt: Date;
+                projectedAt: Date | null;
+            };
+            idempotent: boolean;
+        }>;
+        claimTerminalProjection: (input: {
+            workerId: string;
+            leaseMs: number;
+            orgId?: string;
+            now?: Date;
+        }) => Promise<import("./chat-generation-protocol.js").ChatTerminalProjectionClaim | null>;
+        getNextTerminalProjectionWakeAt: (input?: {
+            orgId?: string;
+        }) => Promise<Date | null>;
+        completeTerminalProjection: (input: {
+            outboxId: string;
+            claimToken: string;
+            claimEpoch: number;
+            finalStatus?: Extract<import("@rudderhq/shared").ChatGenerationStatus, "completed" | "failed" | "stopped" | "aborted" | "interrupted_unverified" | "control_lost">;
+            terminalReason?: string;
+            controlDisposition?: ChatControlDisposition;
+            now?: Date;
+            project?: (tx: import("./chat-generation-protocol.js").ChatGenerationProtocolTransaction, claim: import("./chat-generation-protocol.js").ChatTerminalProjectionClaim) => Promise<void>;
+        }) => Promise<{
+            outbox: {
+                id: string;
+                orgId: string;
+                generationId: string;
+                sourceEventId: string;
+                projectionVersion: number;
+                projectorVersion: number;
+                expectedControlVersion: number;
+                status: import("@rudderhq/shared").ChatTerminalOutboxStatus;
+                payload: Record<string, unknown>;
+                claimToken: string | null;
+                claimEpoch: number;
+                claimOwner: string | null;
+                leaseExpiresAt: Date | null;
+                attemptCount: number;
+                replayCount: number;
+                availableAt: Date;
+                lastAttemptAt: Date | null;
+                lastError: string | null;
+                projectedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            event: null;
+            superseded: true;
+        } | {
+            outbox: {
+                id: string;
+                orgId: string;
+                generationId: string;
+                sourceEventId: string;
+                projectionVersion: number;
+                projectorVersion: number;
+                expectedControlVersion: number;
+                status: import("@rudderhq/shared").ChatTerminalOutboxStatus;
+                payload: Record<string, unknown>;
+                claimToken: string | null;
+                claimEpoch: number;
+                claimOwner: string | null;
+                leaseExpiresAt: Date | null;
+                attemptCount: number;
+                replayCount: number;
+                availableAt: Date;
+                lastAttemptAt: Date | null;
+                lastError: string | null;
+                projectedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            generation: {
+                id: string;
+                orgId: string;
+                conversationId: string;
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                terminalReason: string | null;
+                attemptEpoch: number;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                createdAt: Date;
+                updatedAt: Date;
+            };
+            event: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            };
+            superseded?: undefined;
+        } | null>;
+        retryTerminalProjection: (input: {
+            outboxId: string;
+            claimToken: string;
+            claimEpoch: number;
+            error: string;
+            retryAt: Date;
+            maxAttempts: number;
+            now?: Date;
+        }) => Promise<{
+            id: string;
+            orgId: string;
+            generationId: string;
+            sourceEventId: string;
+            projectionVersion: number;
+            projectorVersion: number;
+            expectedControlVersion: number;
+            status: import("@rudderhq/shared").ChatTerminalOutboxStatus;
+            payload: Record<string, unknown>;
+            claimToken: string | null;
+            claimEpoch: number;
+            claimOwner: string | null;
+            leaseExpiresAt: Date | null;
+            attemptCount: number;
+            replayCount: number;
+            availableAt: Date;
+            lastAttemptAt: Date | null;
+            lastError: string | null;
+            projectedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        recoverStaleControlOwners: (input: {
+            now?: Date;
+            limit?: number;
+            assumeAllOwnersStale?: boolean;
+        }) => Promise<{
+            generation: {
+                status: import("@rudderhq/shared").ChatGenerationStatus;
+                conversationId: string;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                attemptEpoch: number;
+                startedAt: Date;
+                completedAt: Date | null;
+                terminalReason: string | null;
+                controlVersion: number;
+                controlState: import("@rudderhq/shared").ChatGenerationControlState;
+                controlRuntimeType: string | null;
+                controlOwnerToken: string | null;
+                controlLeaseExpiresAt: Date | null;
+                providerThreadId: string | null;
+                providerTurnId: string | null;
+                acceptedThroughSeq: number | null;
+                lastClientCheckpointSeq: number | null;
+                lastClientCheckpointHash: string | null;
+                frozenBodyHash: string | null;
+                stopRequestedAt: Date | null;
+                runtimeTerminalAt: Date | null;
+                lateEventsDropped: number;
+                lateBytes: number;
+            };
+            event: {
+                assistantMessageId: string | null;
+                id: string;
+                orgId: string;
+                runId: string | null;
+                payload: Record<string, unknown>;
+                controlActionId: string | null;
+                generationId: string;
+                attemptEpoch: number;
+                generationSeq: number;
+                eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+                bodyOffset: number | null;
+                bodyLength: number | null;
+                queueItemId: string | null;
+                recordedAt: Date;
+                emittedAt: Date | null;
+            };
+            outbox: {
+                status: import("@rudderhq/shared").ChatTerminalOutboxStatus;
+                id: string;
+                orgId: string;
+                createdAt: Date;
+                updatedAt: Date;
+                payload: Record<string, unknown>;
+                expectedControlVersion: number;
+                generationId: string;
+                lastError: string | null;
+                lastAttemptAt: Date | null;
+                sourceEventId: string;
+                projectionVersion: number;
+                projectorVersion: number;
+                claimToken: string | null;
+                claimEpoch: number;
+                claimOwner: string | null;
+                leaseExpiresAt: Date | null;
+                attemptCount: number;
+                replayCount: number;
+                availableAt: Date;
+                projectedAt: Date | null;
+            };
+        }[]>;
+    };
     list: (orgId: string, options?: {
         status?: "active" | "resolved" | "archived" | "all";
         q?: string;
         limit?: number;
+        projectId?: string;
     }, userId?: string | null) => Promise<{
         primaryIssue: {
             id: string;
@@ -59,13 +974,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -73,6 +987,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -94,13 +1016,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -108,6 +1029,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -124,13 +1053,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -138,6 +1066,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -154,13 +1090,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -168,6 +1103,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -212,13 +1155,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -226,6 +1168,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -282,13 +1232,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -296,6 +1245,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -340,13 +1297,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -354,6 +1310,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -398,13 +1362,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -412,6 +1375,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -456,13 +1427,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -470,6 +1440,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -481,14 +1459,14 @@ export declare function chatService(db: Db): {
         assetId: string;
         objectKey: string;
     }[]>;
+    assetHasAttachments: (assetId: string) => Promise<boolean>;
     remove: (id: string) => Promise<{
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -496,6 +1474,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -547,13 +1533,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -561,6 +1546,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -605,13 +1598,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -619,6 +1611,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -655,12 +1655,159 @@ export declare function chatService(db: Db): {
         pinnedAt: Date | null;
     }>;
     createGeneration: (orgId: string, conversationId: string) => Promise<ChatGenerationRow>;
+    beginGenerationControlAttempt: (input: {
+        orgId: string;
+        conversationId: string;
+        generationId: string;
+        attemptEpoch: number;
+        ownerToken: string;
+        runtimeType: string;
+    }) => Promise<{
+        id: string;
+        orgId: string;
+        conversationId: string;
+        status: import("@rudderhq/shared").ChatGenerationStatus;
+        terminalReason: string | null;
+        attemptEpoch: number;
+        controlVersion: number;
+        controlState: import("@rudderhq/shared").ChatGenerationControlState;
+        controlRuntimeType: string | null;
+        controlOwnerToken: string | null;
+        controlLeaseExpiresAt: Date | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        acceptedThroughSeq: number | null;
+        lastClientCheckpointSeq: number | null;
+        lastClientCheckpointHash: string | null;
+        frozenBodyHash: string | null;
+        stopRequestedAt: Date | null;
+        runtimeTerminalAt: Date | null;
+        lateEventsDropped: number;
+        lateBytes: number;
+        startedAt: Date;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    markGenerationControlReady: (input: {
+        generationId: string;
+        attemptEpoch: number;
+        ownerToken: string;
+        runtimeType: string;
+        providerThreadId?: string | null;
+        providerTurnId?: string | null;
+    }) => Promise<{
+        id: string;
+        orgId: string;
+        conversationId: string;
+        status: import("@rudderhq/shared").ChatGenerationStatus;
+        terminalReason: string | null;
+        attemptEpoch: number;
+        controlVersion: number;
+        controlState: import("@rudderhq/shared").ChatGenerationControlState;
+        controlRuntimeType: string | null;
+        controlOwnerToken: string | null;
+        controlLeaseExpiresAt: Date | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        acceptedThroughSeq: number | null;
+        lastClientCheckpointSeq: number | null;
+        lastClientCheckpointHash: string | null;
+        frozenBodyHash: string | null;
+        stopRequestedAt: Date | null;
+        runtimeTerminalAt: Date | null;
+        lateEventsDropped: number;
+        lateBytes: number;
+        startedAt: Date;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    renewGenerationControlLease: (input: {
+        generationId: string;
+        attemptEpoch: number;
+        ownerToken: string;
+        now?: Date;
+    }) => Promise<boolean>;
+    markGenerationControlAttemptCompleted: (input: {
+        generationId: string;
+        attemptEpoch: number;
+        ownerToken: string;
+    }) => Promise<{
+        id: string;
+        orgId: string;
+        conversationId: string;
+        status: import("@rudderhq/shared").ChatGenerationStatus;
+        terminalReason: string | null;
+        attemptEpoch: number;
+        controlVersion: number;
+        controlState: import("@rudderhq/shared").ChatGenerationControlState;
+        controlRuntimeType: string | null;
+        controlOwnerToken: string | null;
+        controlLeaseExpiresAt: Date | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        acceptedThroughSeq: number | null;
+        lastClientCheckpointSeq: number | null;
+        lastClientCheckpointHash: string | null;
+        frozenBodyHash: string | null;
+        stopRequestedAt: Date | null;
+        runtimeTerminalAt: Date | null;
+        lateEventsDropped: number;
+        lateBytes: number;
+        startedAt: Date;
+        completedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    appendGenerationEvent: (input: {
+        orgId: string;
+        generationId: string;
+        attemptEpoch: number;
+        eventKind: typeof chatGenerationEvents.$inferInsert.eventKind;
+        payload?: Record<string, unknown>;
+        controlActionId?: string | null;
+        queueItemId?: string | null;
+        emittedAt?: Date | null;
+    }) => Promise<{
+        assistantMessageId: string | null;
+        id: string;
+        orgId: string;
+        runId: string | null;
+        payload: Record<string, unknown>;
+        controlActionId: string | null;
+        generationId: string;
+        attemptEpoch: number;
+        generationSeq: number;
+        eventKind: import("@rudderhq/shared").ChatGenerationEventKind;
+        bodyOffset: number | null;
+        bodyLength: number | null;
+        queueItemId: string | null;
+        recordedAt: Date;
+        emittedAt: Date | null;
+    }>;
     markGenerationTerminal: (generationId: string | null | undefined, status: "completed" | "failed" | "stopped" | "aborted") => Promise<{
         id: string;
         orgId: string;
         conversationId: string;
-        status: string;
+        status: import("@rudderhq/shared").ChatGenerationStatus;
         terminalReason: string | null;
+        attemptEpoch: number;
+        controlVersion: number;
+        controlState: import("@rudderhq/shared").ChatGenerationControlState;
+        controlRuntimeType: string | null;
+        controlOwnerToken: string | null;
+        controlLeaseExpiresAt: Date | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        acceptedThroughSeq: number | null;
+        lastClientCheckpointSeq: number | null;
+        lastClientCheckpointHash: string | null;
+        frozenBodyHash: string | null;
+        stopRequestedAt: Date | null;
+        runtimeTerminalAt: Date | null;
+        lateEventsDropped: number;
+        lateBytes: number;
         startedAt: Date;
         completedAt: Date | null;
         createdAt: Date;
@@ -670,8 +1817,24 @@ export declare function chatService(db: Db): {
         id: string;
         orgId: string;
         conversationId: string;
-        status: string;
+        status: import("@rudderhq/shared").ChatGenerationStatus;
         terminalReason: string | null;
+        attemptEpoch: number;
+        controlVersion: number;
+        controlState: import("@rudderhq/shared").ChatGenerationControlState;
+        controlRuntimeType: string | null;
+        controlOwnerToken: string | null;
+        controlLeaseExpiresAt: Date | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        acceptedThroughSeq: number | null;
+        lastClientCheckpointSeq: number | null;
+        lastClientCheckpointHash: string | null;
+        frozenBodyHash: string | null;
+        stopRequestedAt: Date | null;
+        runtimeTerminalAt: Date | null;
+        lateEventsDropped: number;
+        lateBytes: number;
         startedAt: Date;
         completedAt: Date | null;
         createdAt: Date;
@@ -681,8 +1844,24 @@ export declare function chatService(db: Db): {
         id: string;
         orgId: string;
         conversationId: string;
-        status: string;
+        status: import("@rudderhq/shared").ChatGenerationStatus;
         terminalReason: string | null;
+        attemptEpoch: number;
+        controlVersion: number;
+        controlState: import("@rudderhq/shared").ChatGenerationControlState;
+        controlRuntimeType: string | null;
+        controlOwnerToken: string | null;
+        controlLeaseExpiresAt: Date | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        acceptedThroughSeq: number | null;
+        lastClientCheckpointSeq: number | null;
+        lastClientCheckpointHash: string | null;
+        frozenBodyHash: string | null;
+        stopRequestedAt: Date | null;
+        runtimeTerminalAt: Date | null;
+        lateEventsDropped: number;
+        lateBytes: number;
         startedAt: Date;
         completedAt: Date | null;
         createdAt: Date;
@@ -690,285 +1869,278 @@ export declare function chatService(db: Db): {
     }>;
     getQueueSnapshot: (conversationId: string, activeGenerationId?: string | null) => Promise<{
         activeGenerationId: string | null;
-        items: {
-            payload: ChatQueuedMessagePayload;
-            status: string;
-            conversationId: string;
-            id: string;
-            orgId: string;
-            createdAt: Date;
-            updatedAt: Date;
-            cancelledAt: Date | null;
-            sourceMessageId: string | null;
-            clientMutationId: string;
-            expectedGenerationId: string | null;
-            version: number;
-            position: number;
-            activeGenerationId: string | null;
-            deliveryAttempts: number;
-            lastAttemptAt: Date | null;
-            lastDeliveryReason: string | null;
-            deliveredMessageId: string | null;
-            steeredAt: Date | null;
-            dequeuedAt: Date | null;
-        }[];
+        activeAttemptEpoch: number | null;
+        activeControlVersion: number | null;
+        activeGenerationStatus: import("@rudderhq/shared").ChatGenerationStatus | null;
+        items: ChatQueuedMessage[];
     }>;
-    listQueuedMessages: (conversationId: string) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    }[]>;
+    listQueuedMessages: (conversationId: string) => Promise<ChatQueuedMessage[]>;
     createQueuedMessage: (input: {
         orgId: string;
         conversationId: string;
         clientMutationId: string;
         payload: ChatQueuedMessagePayload;
         expectedGenerationId?: string | null;
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    }>;
+        requestActor?: ChatQueueRequestActor | null;
+    }) => Promise<ChatQueuedMessage>;
     updateQueuedMessage: (input: {
         conversationId: string;
         itemId: string;
         version: number;
         payload: ChatQueuedMessagePayload;
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    }>;
+    }) => Promise<ChatQueuedMessage>;
     cancelQueuedMessage: (input: {
         conversationId: string;
         itemId: string;
         version?: number | null;
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
+    }) => Promise<ChatQueuedMessage>;
+    scheduleSteerContinuation: (input: {
         orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
+        conversationId: string;
+        itemId: string;
+        controlActionId: string;
+        requestActor?: ChatQueueRequestActor | null;
+    }) => Promise<{
+        action: {
+            id: string;
+            orgId: string;
+            expectedGenerationId: string | null;
+            expectedAttemptEpoch: number | null;
+            expectedControlVersion: number | null;
+            appliedControlVersion: number | null;
+            actionKind: import("@rudderhq/shared").ChatControlActionKind;
+            localDisposition: ChatControlDisposition;
+            providerDisposition: ChatProviderControlDisposition | null;
+            controlOwnerToken: string | null;
+            providerClientMessageId: string | null;
+            providerThreadId: string | null;
+            providerTurnId: string | null;
+            providerEvidence: Record<string, unknown> | null;
+            requestedRenderSeq: number | null;
+            requestedBodyHash: string | null;
+            acceptedThroughSeq: number | null;
+            frozenBodyHash: string | null;
+            lastError: string | null;
+            requestedAt: Date;
+            providerSentAt: Date | null;
+            providerAcknowledgedAt: Date | null;
+            resolvedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        item: ChatQueuedMessage;
+        idempotent: boolean;
     }>;
     markQueuedMessageSteerFallback: (input: {
         conversationId: string;
         itemId: string;
         reason: "unsupported" | "stale_generation" | "closing";
         activeGenerationId?: string | null;
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
+    }) => Promise<ChatQueuedMessage>;
+    beginSteerControlAction: (input: {
+        orgId: string;
         conversationId: string;
+        itemId: string;
+        controlActionId: string;
+        expectedGenerationId: string;
+        expectedAttemptEpoch: number;
+        expectedControlVersion: number;
+        requestActor?: ChatQueueRequestActor | null;
+    }) => Promise<{
+        action: ChatControlActionRow;
+        item: ReturnType<(row: ChatQueuedMessageRow) => ChatQueuedMessage>;
+        generation: ChatGenerationRow | null;
+        idempotent: boolean;
+    }>;
+    claimSteerProviderSend: (input: {
+        orgId: string;
+        controlActionId: string;
+    }) => Promise<{
         id: string;
         orgId: string;
+        expectedGenerationId: string | null;
+        expectedAttemptEpoch: number | null;
+        expectedControlVersion: number | null;
+        appliedControlVersion: number | null;
+        actionKind: import("@rudderhq/shared").ChatControlActionKind;
+        localDisposition: ChatControlDisposition;
+        providerDisposition: ChatProviderControlDisposition | null;
+        controlOwnerToken: string | null;
+        providerClientMessageId: string | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        providerEvidence: Record<string, unknown> | null;
+        requestedRenderSeq: number | null;
+        requestedBodyHash: string | null;
+        acceptedThroughSeq: number | null;
+        frozenBodyHash: string | null;
+        lastError: string | null;
+        requestedAt: Date;
+        providerSentAt: Date | null;
+        providerAcknowledgedAt: Date | null;
+        resolvedAt: Date | null;
         createdAt: Date;
         updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    }>;
-    claimNextQueuedMessage: (conversationId: string) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
+    } | {
+        sendDenied: true;
+        reason: string;
+        action: {
+            id: string;
+            orgId: string;
+            expectedGenerationId: string | null;
+            expectedAttemptEpoch: number | null;
+            expectedControlVersion: number | null;
+            appliedControlVersion: number | null;
+            actionKind: import("@rudderhq/shared").ChatControlActionKind;
+            localDisposition: ChatControlDisposition;
+            providerDisposition: ChatProviderControlDisposition | null;
+            controlOwnerToken: string | null;
+            providerClientMessageId: string | null;
+            providerThreadId: string | null;
+            providerTurnId: string | null;
+            providerEvidence: Record<string, unknown> | null;
+            requestedRenderSeq: number | null;
+            requestedBodyHash: string | null;
+            acceptedThroughSeq: number | null;
+            frozenBodyHash: string | null;
+            lastError: string | null;
+            requestedAt: Date;
+            providerSentAt: Date | null;
+            providerAcknowledgedAt: Date | null;
+            resolvedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        item: ChatQueuedMessage;
+    } | null>;
+    releaseSteerProviderSendClaim: (input: {
+        orgId: string;
+        controlActionId: string;
+        reason: string;
+    }) => Promise<{
         id: string;
         orgId: string;
+        expectedGenerationId: string | null;
+        expectedAttemptEpoch: number | null;
+        expectedControlVersion: number | null;
+        appliedControlVersion: number | null;
+        actionKind: import("@rudderhq/shared").ChatControlActionKind;
+        localDisposition: ChatControlDisposition;
+        providerDisposition: ChatProviderControlDisposition | null;
+        controlOwnerToken: string | null;
+        providerClientMessageId: string | null;
+        providerThreadId: string | null;
+        providerTurnId: string | null;
+        providerEvidence: Record<string, unknown> | null;
+        requestedRenderSeq: number | null;
+        requestedBodyHash: string | null;
+        acceptedThroughSeq: number | null;
+        frozenBodyHash: string | null;
+        lastError: string | null;
+        requestedAt: Date;
+        providerSentAt: Date | null;
+        providerAcknowledgedAt: Date | null;
+        resolvedAt: Date | null;
         createdAt: Date;
         updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
     } | null>;
-    releaseQueuedMessageClaim: (input: {
+    resolveSteerControlAction: (input: {
+        orgId: string;
         conversationId: string;
         itemId: string;
-        reason: "delivery_failed" | "delivery_aborted" | "claim_expired";
+        controlActionId: string;
+        status: Extract<ChatQueuedMessageStatus, "steer_pending" | "accepted_current" | "acceptance_unknown" | "continuation_pending" | "failed_actionable">;
+        disposition: Extract<ChatControlDisposition, "pending" | "accepted_current" | "acceptance_unknown" | "continuation_pending" | "failed_actionable">;
+        providerDisposition: ChatProviderControlDisposition;
+        providerThreadId?: string | null;
+        providerTurnId?: string | null;
+        providerEvidence?: Record<string, unknown> | null;
+        reason?: string | null;
     }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
+        action: {
+            id: string;
+            orgId: string;
+            expectedGenerationId: string | null;
+            expectedAttemptEpoch: number | null;
+            expectedControlVersion: number | null;
+            appliedControlVersion: number | null;
+            actionKind: import("@rudderhq/shared").ChatControlActionKind;
+            localDisposition: ChatControlDisposition;
+            providerDisposition: ChatProviderControlDisposition | null;
+            controlOwnerToken: string | null;
+            providerClientMessageId: string | null;
+            providerThreadId: string | null;
+            providerTurnId: string | null;
+            providerEvidence: Record<string, unknown> | null;
+            requestedRenderSeq: number | null;
+            requestedBodyHash: string | null;
+            acceptedThroughSeq: number | null;
+            frozenBodyHash: string | null;
+            lastError: string | null;
+            requestedAt: Date;
+            providerSentAt: Date | null;
+            providerAcknowledgedAt: Date | null;
+            resolvedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        item: ChatQueuedMessage;
+        applied: boolean;
+    }>;
+    claimNextServerQueuedMessage: (input: {
+        workerId: string;
+        leaseMs: number;
+        now?: Date;
+    }) => Promise<ChatServerQueueClaim | null>;
+    renewServerQueuedMessageClaim: (input: {
+        itemId: string;
+        generationId: string;
+        leaseToken: string;
+        leaseEpoch: number;
+        leaseMs: number;
+        now?: Date;
+    }) => Promise<boolean>;
+    completeServerQueuedMessageDelivery: (input: {
+        itemId: string;
+        generationId: string;
+        leaseToken: string;
+        leaseEpoch: number;
+        status: "completed" | "failed" | "stopped" | "aborted";
+        reason?: string | null;
+    }) => Promise<ChatQueuedMessage | null>;
+    releaseServerQueuedMessageClaim: (input: {
+        itemId: string;
+        generationId: string;
+        leaseToken: string;
+        leaseEpoch: number;
+        reason: string;
+    }) => Promise<ChatQueuedMessage | null>;
+    recoverExpiredServerQueueClaims: (now?: Date) => Promise<{
+        inspected: number;
+        requeued: number;
+        ambiguous: number;
+    }>;
+    claimNextQueuedMessage: (conversationId: string) => Promise<ChatQueuedMessage | null>;
+    releaseQueuedMessageClaim: (input: {
         conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    } | null>;
+        itemId: string;
+        reason: "delivery_failed" | "delivery_aborted" | "claim_expired";
+    }) => Promise<ChatQueuedMessage | null>;
     assertQueuedMessageClaimedForDelivery: (input: {
         conversationId: string;
         itemId: string;
         body: string;
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    }>;
+    }) => Promise<ChatQueuedMessage>;
     markQueuedMessageRunning: (input: {
         conversationId: string;
         itemId: string;
         sourceMessageId: string;
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    }>;
+    }) => Promise<ChatQueuedMessage>;
     markQueuedMessageDeliveryTerminal: (input: {
         conversationId: string;
         itemId: string;
         status: "completed" | "failed" | "stopped" | "aborted";
-    }) => Promise<{
-        payload: ChatQueuedMessagePayload;
-        status: string;
-        conversationId: string;
-        id: string;
-        orgId: string;
-        createdAt: Date;
-        updatedAt: Date;
-        cancelledAt: Date | null;
-        sourceMessageId: string | null;
-        clientMutationId: string;
-        expectedGenerationId: string | null;
-        version: number;
-        position: number;
-        activeGenerationId: string | null;
-        deliveryAttempts: number;
-        lastAttemptAt: Date | null;
-        lastDeliveryReason: string | null;
-        deliveredMessageId: string | null;
-        steeredAt: Date | null;
-        dequeuedAt: Date | null;
-    } | null>;
+    }) => Promise<ChatQueuedMessage | null>;
     listMessages: (conversationId: string, options?: {
         includeTranscript?: boolean;
     }) => Promise<{
@@ -982,8 +2154,8 @@ export declare function chatService(db: Db): {
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            decisionNote: string | null;
             payload: Record<string, unknown>;
+            decisionNote: string | null;
             requestedByAgentId: string | null;
             decidedByUserId: string | null;
             requestedByUserId: string | null;
@@ -1034,8 +2206,8 @@ export declare function chatService(db: Db): {
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            decisionNote: string | null;
             payload: Record<string, unknown>;
+            decisionNote: string | null;
             requestedByAgentId: string | null;
             decidedByUserId: string | null;
             requestedByUserId: string | null;
@@ -1078,8 +2250,8 @@ export declare function chatService(db: Db): {
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            decisionNote: string | null;
             payload: Record<string, unknown>;
+            decisionNote: string | null;
             requestedByAgentId: string | null;
             decidedByUserId: string | null;
             requestedByUserId: string | null;
@@ -1113,8 +2285,8 @@ export declare function chatService(db: Db): {
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            decisionNote: string | null;
             payload: Record<string, unknown>;
+            decisionNote: string | null;
             requestedByAgentId: string | null;
             decidedByUserId: string | null;
             requestedByUserId: string | null;
@@ -1150,8 +2322,8 @@ export declare function chatService(db: Db): {
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            decisionNote: string | null;
             payload: Record<string, unknown>;
+            decisionNote: string | null;
             requestedByAgentId: string | null;
             decidedByUserId: string | null;
             requestedByUserId: string | null;
@@ -1238,13 +2410,12 @@ export declare function chatService(db: Db): {
         unreadCount: number;
         isUnread: boolean;
         needsAttention: boolean;
-        title: string;
         status: string;
+        title: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
-        createdByUserId: string | null;
         summary: string | null;
         preferredAgentId: string | null;
         issueCreationMode: string;
@@ -1252,6 +2423,14 @@ export declare function chatService(db: Db): {
         routedAgentId: string | null;
         primaryIssueId: string | null;
         resolvedAt: Date | null;
+        createdByUserId: string | null;
+        conversationKind: string;
+        messengerVisible: boolean;
+        sideChatState: string | null;
+        sideChatExpiresAt: Date | null;
+        sideChatCompletedAt: Date | null;
+        sideChatKeptAt: Date | null;
+        sideChatClientMutationId: string | null;
         forkedFromConversationId: string | null;
         forkedFromMessageId: string | null;
         forkRootConversationId: string | null;
@@ -1304,8 +2483,8 @@ export declare function chatService(db: Db): {
             createdAt: Date;
             updatedAt: Date;
             type: string;
-            decisionNote: string | null;
             payload: Record<string, unknown>;
+            decisionNote: string | null;
             requestedByAgentId: string | null;
             decidedByUserId: string | null;
             requestedByUserId: string | null;
@@ -1330,16 +2509,16 @@ export declare function chatService(db: Db): {
     } | null>;
     applyApprovedApproval: (approval: ApprovalRow, actorUserId: string | null) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
+        status: string;
         icon: string | null;
         title: string | null;
-        status: string;
         id: string;
         orgId: string;
         createdAt: Date;
         updatedAt: Date;
         name: string;
-        agentRuntimeType: string;
         metadata: Record<string, unknown> | null;
+        agentRuntimeType: string;
         agentRuntimeConfig: Record<string, unknown>;
         budgetMonthlyCents: number;
         spentMonthlyCents: number;
@@ -1391,8 +2570,8 @@ export declare function chatService(db: Db): {
         createdAt: Date;
         updatedAt: Date;
         type: string;
-        decisionNote: string | null;
         payload: Record<string, unknown>;
+        decisionNote: string | null;
         requestedByAgentId: string | null;
         decidedByUserId: string | null;
         requestedByUserId: string | null;
@@ -1414,8 +2593,8 @@ export declare function chatService(db: Db): {
                 createdAt: Date;
                 updatedAt: Date;
                 type: string;
-                decisionNote: string | null;
                 payload: Record<string, unknown>;
+                decisionNote: string | null;
                 requestedByAgentId: string | null;
                 decidedByUserId: string | null;
                 requestedByUserId: string | null;
@@ -1449,8 +2628,8 @@ export declare function chatService(db: Db): {
                 createdAt: Date;
                 updatedAt: Date;
                 type: string;
-                decisionNote: string | null;
                 payload: Record<string, unknown>;
+                decisionNote: string | null;
                 requestedByAgentId: string | null;
                 decidedByUserId: string | null;
                 requestedByUserId: string | null;