@sentry/junior 0.197.0 → 0.199.0

package/dist/chat/task-execution/slack-work.d.ts

@@ -1,274 +0,0 @@
-import type { SlackAdapter } from "@chat-adapter/slack";
-import { Message, ThreadImpl, type StateAdapter } from "chat";
-import { z } from "zod";
-import type { SlackTurnOptions } from "@/chat/providers/slack/runtime";
-import type { InboundMessage } from "@/chat/task-execution/store";
-import type { ConversationWorkerContext, ConversationWorkerResult } from "@/chat/task-execution/worker";
-import { type SlackInstallationContext } from "@/chat/slack/adapter-context";
-import { type SlackActorProfile } from "@/chat/actor";
-import { type CrossActorMidRunMode } from "@/chat/config";
-declare const slackConversationRouteSchema: z.ZodEnum<{
-    mention: "mention";
-    subscribed: "subscribed";
-}>;
-export type SlackConversationRoute = z.output<typeof slackConversationRouteSchema>;
-declare const slackConversationMessageMetadataSchema: z.ZodUnion<readonly [z.ZodObject<{
-    installation: z.ZodOptional<z.ZodObject<{
-        enterpriseId: z.ZodOptional<z.ZodString>;
-        isEnterpriseInstall: z.ZodOptional<z.ZodBoolean>;
-        teamId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    message: z.ZodObject<{
-        _type: z.ZodLiteral<"chat:Message">;
-        attachments: z.ZodArray<z.ZodObject<{
-            type: z.ZodEnum<{
-                file: "file";
-                image: "image";
-                audio: "audio";
-                video: "video";
-            }>;
-            url: z.ZodOptional<z.ZodString>;
-            name: z.ZodOptional<z.ZodString>;
-            mimeType: z.ZodOptional<z.ZodString>;
-            size: z.ZodOptional<z.ZodNumber>;
-            width: z.ZodOptional<z.ZodNumber>;
-            height: z.ZodOptional<z.ZodNumber>;
-            fetchMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, z.core.$strict>>;
-        author: z.ZodObject<{
-            userId: z.ZodString;
-            userName: z.ZodString;
-            fullName: z.ZodString;
-            isBot: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"unknown">]>;
-            isMe: z.ZodBoolean;
-        }, z.core.$strict>;
-        formatted: z.ZodCustom<import("chat").Root, import("chat").Root>;
-        id: z.ZodString;
-        isMention: z.ZodOptional<z.ZodBoolean>;
-        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
-            title: z.ZodOptional<z.ZodString>;
-            description: z.ZodOptional<z.ZodString>;
-            imageUrl: z.ZodOptional<z.ZodString>;
-            siteName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>>;
-        metadata: z.ZodObject<{
-            dateSent: z.ZodISODateTime;
-            edited: z.ZodBoolean;
-            editedAt: z.ZodOptional<z.ZodISODateTime>;
-        }, z.core.$strict>;
-        raw: z.ZodUnknown;
-        text: z.ZodString;
-        threadId: z.ZodString;
-    }, z.core.$strict>;
-    platform: z.ZodLiteral<"slack">;
-    route: z.ZodEnum<{
-        mention: "mention";
-        subscribed: "subscribed";
-    }>;
-    thread: z.ZodObject<{
-        _type: z.ZodLiteral<"chat:Thread">;
-        adapterName: z.ZodLiteral<"slack">;
-        channelId: z.ZodString;
-        channelVisibility: z.ZodOptional<z.ZodEnum<{
-            private: "private";
-            unknown: "unknown";
-            external: "external";
-            workspace: "workspace";
-        }>>;
-        currentMessage: z.ZodOptional<z.ZodObject<{
-            _type: z.ZodLiteral<"chat:Message">;
-            attachments: z.ZodArray<z.ZodObject<{
-                type: z.ZodEnum<{
-                    file: "file";
-                    image: "image";
-                    audio: "audio";
-                    video: "video";
-                }>;
-                url: z.ZodOptional<z.ZodString>;
-                name: z.ZodOptional<z.ZodString>;
-                mimeType: z.ZodOptional<z.ZodString>;
-                size: z.ZodOptional<z.ZodNumber>;
-                width: z.ZodOptional<z.ZodNumber>;
-                height: z.ZodOptional<z.ZodNumber>;
-                fetchMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            }, z.core.$strict>>;
-            author: z.ZodObject<{
-                userId: z.ZodString;
-                userName: z.ZodString;
-                fullName: z.ZodString;
-                isBot: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"unknown">]>;
-                isMe: z.ZodBoolean;
-            }, z.core.$strict>;
-            formatted: z.ZodCustom<import("chat").Root, import("chat").Root>;
-            id: z.ZodString;
-            isMention: z.ZodOptional<z.ZodBoolean>;
-            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                url: z.ZodString;
-                title: z.ZodOptional<z.ZodString>;
-                description: z.ZodOptional<z.ZodString>;
-                imageUrl: z.ZodOptional<z.ZodString>;
-                siteName: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-            metadata: z.ZodObject<{
-                dateSent: z.ZodISODateTime;
-                edited: z.ZodBoolean;
-                editedAt: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strict>;
-            raw: z.ZodUnknown;
-            text: z.ZodString;
-            threadId: z.ZodString;
-        }, z.core.$strict>>;
-        id: z.ZodString;
-        isDM: z.ZodBoolean;
-    }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-    installation: z.ZodOptional<z.ZodObject<{
-        enterpriseId: z.ZodOptional<z.ZodString>;
-        isEnterpriseInstall: z.ZodOptional<z.ZodBoolean>;
-        teamId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    message: z.ZodObject<{
-        _type: z.ZodLiteral<"chat:Message">;
-        attachments: z.ZodArray<z.ZodObject<{
-            type: z.ZodEnum<{
-                file: "file";
-                image: "image";
-                audio: "audio";
-                video: "video";
-            }>;
-            url: z.ZodOptional<z.ZodString>;
-            name: z.ZodOptional<z.ZodString>;
-            mimeType: z.ZodOptional<z.ZodString>;
-            size: z.ZodOptional<z.ZodNumber>;
-            width: z.ZodOptional<z.ZodNumber>;
-            height: z.ZodOptional<z.ZodNumber>;
-            fetchMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, z.core.$strict>>;
-        author: z.ZodObject<{
-            userId: z.ZodString;
-            userName: z.ZodString;
-            fullName: z.ZodString;
-            isBot: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"unknown">]>;
-            isMe: z.ZodBoolean;
-        }, z.core.$strict>;
-        formatted: z.ZodCustom<import("chat").Root, import("chat").Root>;
-        id: z.ZodString;
-        isMention: z.ZodOptional<z.ZodBoolean>;
-        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
-            title: z.ZodOptional<z.ZodString>;
-            description: z.ZodOptional<z.ZodString>;
-            imageUrl: z.ZodOptional<z.ZodString>;
-            siteName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>>;
-        metadata: z.ZodObject<{
-            dateSent: z.ZodISODateTime;
-            edited: z.ZodBoolean;
-            editedAt: z.ZodOptional<z.ZodISODateTime>;
-        }, z.core.$strict>;
-        raw: z.ZodUnknown;
-        text: z.ZodString;
-        threadId: z.ZodString;
-    }, z.core.$strict>;
-    platform: z.ZodLiteral<"slack">;
-    route: z.ZodEnum<{
-        mention: "mention";
-        subscribed: "subscribed";
-    }>;
-    thread: z.ZodObject<{
-        _type: z.ZodLiteral<"chat:Thread">;
-        adapterName: z.ZodLiteral<"slack">;
-        channelId: z.ZodString;
-        channelVisibility: z.ZodOptional<z.ZodEnum<{
-            private: "private";
-            unknown: "unknown";
-            external: "external";
-            workspace: "workspace";
-        }>>;
-        currentMessage: z.ZodOptional<z.ZodObject<{
-            _type: z.ZodLiteral<"chat:Message">;
-            attachments: z.ZodArray<z.ZodObject<{
-                type: z.ZodEnum<{
-                    file: "file";
-                    image: "image";
-                    audio: "audio";
-                    video: "video";
-                }>;
-                url: z.ZodOptional<z.ZodString>;
-                name: z.ZodOptional<z.ZodString>;
-                mimeType: z.ZodOptional<z.ZodString>;
-                size: z.ZodOptional<z.ZodNumber>;
-                width: z.ZodOptional<z.ZodNumber>;
-                height: z.ZodOptional<z.ZodNumber>;
-                fetchMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            }, z.core.$strict>>;
-            author: z.ZodObject<{
-                userId: z.ZodString;
-                userName: z.ZodString;
-                fullName: z.ZodString;
-                isBot: z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"unknown">]>;
-                isMe: z.ZodBoolean;
-            }, z.core.$strict>;
-            formatted: z.ZodCustom<import("chat").Root, import("chat").Root>;
-            id: z.ZodString;
-            isMention: z.ZodOptional<z.ZodBoolean>;
-            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                url: z.ZodString;
-                title: z.ZodOptional<z.ZodString>;
-                description: z.ZodOptional<z.ZodString>;
-                imageUrl: z.ZodOptional<z.ZodString>;
-                siteName: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>>>;
-            metadata: z.ZodObject<{
-                dateSent: z.ZodISODateTime;
-                edited: z.ZodBoolean;
-                editedAt: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strict>;
-            raw: z.ZodUnknown;
-            text: z.ZodString;
-            threadId: z.ZodString;
-        }, z.core.$strict>>;
-        id: z.ZodString;
-        isDM: z.ZodBoolean;
-    }, z.core.$strict>;
-    kind: z.ZodLiteral<"resource_event">;
-    resourceEvent: z.ZodObject<{
-        eventKey: z.ZodString;
-        eventType: z.ZodString;
-        namespace: z.ZodString;
-        identifier: z.ZodString;
-        subscriptionId: z.ZodString;
-    }, z.core.$strict>;
-}, z.core.$strict>]>;
-export type SlackConversationMessageMetadata = z.output<typeof slackConversationMessageMetadataSchema>;
-type SlackInboxTurnOptions = SlackTurnOptions & {
-    ack: () => Promise<void>;
-    isFinalAttempt: boolean;
-};
-interface SlackInboxTurnRuntime {
-    handleNewMention(thread: ThreadImpl, message: Message, hooks: SlackInboxTurnOptions): Promise<void>;
-    handleSubscribedMessage(thread: ThreadImpl, message: Message, hooks: SlackInboxTurnOptions): Promise<void>;
-}
-export interface CreateSlackConversationWorkerOptions {
-    crossActorMidRunMode?: CrossActorMidRunMode;
-    getSlackAdapter: () => SlackAdapter;
-    lookupSlackUser?: (teamId: string, userId: string) => Promise<SlackActorProfile | null | undefined>;
-    runNextPausedTurn: (conversationId: string, options: {
-        shouldYield: () => boolean;
-    }) => Promise<boolean>;
-    runtime: SlackInboxTurnRuntime;
-    state?: StateAdapter;
-}
-/** Build the worker run function for queued Slack conversation work. */
-export declare function createSlackConversationWorker(options: CreateSlackConversationWorkerOptions): (context: ConversationWorkerContext) => Promise<ConversationWorkerResult>;
-/** Serialize a Slack message into the generic durable conversation mailbox. */
-export declare function buildSlackInboundMessage(args: {
-    conversationId: string;
-    installation?: SlackInstallationContext;
-    message: Message;
-    receivedAtMs: number;
-    route: SlackConversationRoute;
-    thread: ThreadImpl;
-}): InboundMessage;
-export {};

package/dist/chat/task-execution/state.d.ts

@@ -1,410 +0,0 @@
-import type { StateAdapter } from "chat";
-import { type Destination } from "@sentry/junior-plugin-api";
-import { z } from "zod";
-import { type StoredSlackActor } from "@/chat/actor";
-declare class InvalidConversationRecordError extends Error {
-    constructor(conversationId: string);
-}
-/** Return whether an error means a stored conversation record failed validation. */
-export declare function isInvalidConversationRecordError(error: unknown): error is InvalidConversationRecordError;
-export declare const CONVERSATION_BY_ACTIVITY_INDEX_KEY = "junior:conversation:v2:by-activity";
-export declare const CONVERSATION_ACTIVE_INDEX_KEY = "junior:conversation:v2:active";
-export declare const CONVERSATION_WORK_LEASE_TTL_MS = 90000;
-export declare const CONVERSATION_WORK_CHECK_IN_INTERVAL_MS = 15000;
-export declare const CONVERSATION_WORK_STALE_ENQUEUE_MS = 60000;
-export declare const CONVERSATION_WORK_MAX_DELIVERY_ATTEMPTS = 5;
-export declare const CONVERSATION_WORK_MAX_RETRIES = 5;
-declare const inboundMessageSourceSchema: z.ZodEnum<{
-    slack: "slack";
-    local: "local";
-    web: "web";
-    resource_event: "resource_event";
-    plugin: "plugin";
-    api: "api";
-    scheduler: "scheduler";
-    internal: "internal";
-}>;
-export type Source = z.output<typeof inboundMessageSourceSchema>;
-export type ExecutionStatus = "paused" | "failed" | "idle" | "pending" | "running";
-declare const agentInputSchema: z.ZodObject<{
-    attachments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-    authorId: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    text: z.ZodString;
-}, z.core.$strict>;
-export type AgentInput = z.output<typeof agentInputSchema>;
-/** Durable delivery modes for pending inbound mailbox work. */
-export declare const inboundMessageDeliverySchema: z.ZodEnum<{
-    defer: "defer";
-    interrupt: "interrupt";
-}>;
-export type InboundMessageDelivery = z.output<typeof inboundMessageDeliverySchema>;
-/** Canonical durable mailbox entry owned by task execution. */
-export declare const inboundMessageSchema: z.ZodObject<{
-    attemptCount: z.ZodOptional<z.ZodNumber>;
-    conversationId: z.ZodString;
-    createdAtMs: z.ZodNumber;
-    delivery: z.ZodEnum<{
-        defer: "defer";
-        interrupt: "interrupt";
-    }>;
-    destination: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        channelId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"local">;
-        conversationId: z.ZodString;
-    }, z.core.$strict>], "platform">>;
-    inboundMessageId: z.ZodString;
-    injectedAtMs: z.ZodOptional<z.ZodNumber>;
-    input: z.ZodObject<{
-        attachments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-        authorId: z.ZodOptional<z.ZodString>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        text: z.ZodString;
-    }, z.core.$strict>;
-    receivedAtMs: z.ZodNumber;
-    source: z.ZodEnum<{
-        slack: "slack";
-        local: "local";
-        web: "web";
-        resource_event: "resource_event";
-        plugin: "plugin";
-        api: "api";
-        scheduler: "scheduler";
-        internal: "internal";
-    }>;
-}, z.core.$strict>;
-export type InboundMessage = z.output<typeof inboundMessageSchema>;
-export interface Lease {
-    acquiredAtMs: number;
-    expiresAtMs: number;
-    lastCheckInAtMs: number;
-    token: string;
-}
-/** Durable request to stop the current Conversation run. */
-export interface ConversationStop {
-    inboundMessageIds: string[];
-    runId: string;
-}
-export interface ConversationExecution {
-    inboundMessageIds: string[];
-    lastCheckpointAtMs?: number;
-    lastEnqueuedAtMs?: number;
-    lastProgressAtMs?: number;
-    retryCount?: number;
-    lease?: Lease;
-    pendingCount: number;
-    pendingMessages: InboundMessage[];
-    runId?: string;
-    status: ExecutionStatus;
-    stop?: ConversationStop;
-    updatedAtMs?: number;
-}
-export interface Conversation {
-    channelName?: string;
-    conversationId: string;
-    createdAtMs: number;
-    destination?: Destination;
-    execution: ConversationExecution;
-    lastActivityAtMs: number;
-    actor?: StoredSlackActor;
-    schemaVersion: 2;
-    source?: Source;
-    title?: string;
-    updatedAtMs: number;
-}
-export interface ConversationWorkLease {
-    acquiredAtMs: number;
-    lastCheckInAtMs: number;
-    leaseExpiresAtMs: number;
-    leaseToken: string;
-}
-export interface ConversationWorkState extends Conversation {
-    lastEnqueuedAtMs?: number;
-    lease?: ConversationWorkLease;
-    messages: InboundMessage[];
-    needsRun: boolean;
-}
-export interface StartConversationWorkAcquired {
-    leaseExpiresAtMs: number;
-    leaseToken: string;
-    status: "acquired";
-}
-export interface StartConversationWorkActive {
-    leaseExpiresAtMs: number;
-    status: "active";
-}
-export interface StartConversationWorkNoWork {
-    status: "no_work";
-}
-export type StartConversationWorkResult = StartConversationWorkAcquired | StartConversationWorkActive | StartConversationWorkNoWork;
-export interface AppendInboundMessageResult {
-    status: "appended" | "duplicate";
-}
-export interface AppendAndEnqueueInboundMessageResult extends AppendInboundMessageResult {
-    queueMessageId?: string;
-}
-/** Result of requesting that the current Conversation run stop. */
-export type StopConversationWorkResult = {
-    status: "no_work";
-} | {
-    runId: string;
-    status: "requested";
-};
-/** Result of clearing one stop observed by the matching leased run. */
-export interface CompleteConversationStopResult {
-    status: "cleared" | "lost_lease" | "none";
-    removedInboundMessageIds: string[];
-}
-/** Result of an append that rejects new work while a Conversation is runnable. */
-export type AppendExclusiveInboundMessageResult = AppendInboundMessageResult | {
-    status: "active";
-};
-/** Exclusive append result with an optional queue delivery id. */
-export type AppendAndEnqueueExclusiveInboundMessageResult = AppendAndEnqueueInboundMessageResult | {
-    status: "active";
-};
-export interface RequestConversationWorkResult {
-    status: "created" | "updated";
-}
-/** Whether this is the final attempt before an unacked message is dead-lettered. */
-export declare function isFinalAttempt(message: Pick<InboundMessage, "attemptCount">): boolean;
-/** Return a persisted conversation record, if one exists. */
-export declare function getConversation(args: {
-    conversationId: string;
-    state?: StateAdapter;
-}): Promise<Conversation | undefined>;
-/** Return a persisted conversation work record, if one exists. */
-export declare function getConversationWorkState(args: {
-    conversationId: string;
-    state?: StateAdapter;
-}): Promise<ConversationWorkState | undefined>;
-/** Count mailbox messages that have not yet reached the conversation event log. */
-export declare function countPendingConversationMessages(conversation: Conversation): number;
-/** Return whether a conversation has pending or resumable execution work. */
-export declare function hasRunnableConversationWork(conversation: Conversation): boolean;
-/** Persist one inbound message idempotently in its conversation mailbox. */
-export declare function appendInboundMessage(args: {
-    message: InboundMessage;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<AppendInboundMessageResult>;
-/** Append only when the Conversation has no other runnable work. */
-export declare function appendExclusiveInboundMessage(args: {
-    message: InboundMessage;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<AppendExclusiveInboundMessageResult>;
-/** Mark a conversation runnable when there is no new mailbox message. */
-export declare function requestConversationWork(args: {
-    conversationId: string;
-    destination?: Destination;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<RequestConversationWorkResult>;
-/** Record visible conversation activity without making the conversation runnable. */
-export declare function recordConversationActivity(args: {
-    activityAtMs?: number;
-    channelName?: string;
-    conversationId: string;
-    destination?: Destination;
-    nowMs?: number;
-    actor?: StoredSlackActor;
-    source?: Source;
-    state?: StateAdapter;
-    title?: string;
-}): Promise<void>;
-/** Store task-execution metadata for legacy SQL import. */
-export declare function recordConversationExecution(args: {
-    channelName?: string;
-    conversationId: string;
-    createdAtMs: number;
-    destination?: Destination;
-    execution: {
-        lastCheckpointAtMs?: number;
-        lastEnqueuedAtMs?: number;
-        runId?: string;
-        status: ExecutionStatus;
-        updatedAtMs?: number;
-    };
-    lastActivityAtMs: number;
-    actor?: StoredSlackActor;
-    source?: Source;
-    state?: StateAdapter;
-    title?: string;
-    updatedAtMs: number;
-}): Promise<void>;
-/** Record that a wake-up nudge was accepted for the conversation. */
-export declare function markConversationWorkEnqueued(args: {
-    conversationId: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<void>;
-/** Clear a wake marker after its queue delivery finds no runnable work. */
-export declare function clearConsumedConversationWake(args: {
-    conversationId: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<boolean>;
-/** Try to acquire the durable execution lease for one conversation. */
-export declare function startConversationWork(args: {
-    conversationId: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<StartConversationWorkResult>;
-/** Extend the durable execution lease when the worker checks in. */
-export declare function checkInConversationWork(args: {
-    conversationId: string;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<boolean>;
-/**
- * Resolve pending mailbox entries after the caller accepts responsibility.
- *
- * Returning ids acknowledges only that subset; returning nothing acknowledges
- * every pending entry passed to the handler.
- */
-export declare function drainConversationMailbox(args: {
-    conversationId: string;
-    handle: (messages: InboundMessage[]) => Promise<readonly string[] | void>;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<{
-    changed: boolean;
-    messages: InboundMessage[];
-}>;
-/** Acknowledge leased mailbox entries after the handler accepts responsibility. */
-export declare function ackMessages(args: {
-    conversationId: string;
-    inboundMessageIds: string[];
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<boolean>;
-/** Persist a stop request for the current run without process affinity. */
-export declare function stopConversationWork(args: {
-    conversationId: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<StopConversationWorkResult>;
-/** Clear one observed stop request and discard older human-facing mailbox work. */
-export declare function completeConversationStop(args: {
-    conversationId: string;
-    leaseToken: string;
-    nowMs?: number;
-    runId: string;
-    state?: StateAdapter;
-}): Promise<CompleteConversationStopResult>;
-/** Cancel human-facing pending mailbox rows without requiring a worker lease. */
-export declare function cancelHumanFacingPendingMessages(args: {
-    conversationId: string;
-    inboundMessageIds?: readonly string[];
-    receivedBeforeMs?: number;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<{
-    cancelledInboundMessageIds: string[];
-}>;
-/** Mark the leased conversation as needing another queue-delivered slice. */
-export declare function requestAnotherSlice(args: {
-    conversationId: string;
-    destination?: Destination;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<boolean>;
-/** Begin a requested turn resume under the worker's existing lease. */
-export declare function beginConversationResume(args: {
-    conversationId: string;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<boolean>;
-/** Release the durable execution lease without changing completion state. */
-export declare function releaseConversationWork(args: {
-    conversationId: string;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<boolean>;
-/** Count one failed execution attempt and stop the conversation when retries are exhausted. */
-export declare function recordConversationRetry(args: {
-    conversationId: string;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<"lost_lease" | "recorded" | "stopped">;
-/** Finish a leased conversation and report whether runnable work remains. */
-export declare function completeConversationWork(args: {
-    conversationId: string;
-    leaseToken: string;
-    madeProgress?: boolean;
-    nowMs?: number;
-    /** Keep a raced stop runnable after a stop-aware adapter returns. */
-    resumeIfStopped?: boolean;
-    state?: StateAdapter;
-}): Promise<"completed" | "lost_lease" | "pending">;
-/** Failure outcome: `lost_lease` (another owner took over), `recorded` (retry counted), or `skipped` (durable progress was made). */
-export interface AttemptFailure {
-    pendingCount: number;
-    deadLetteredMessages: InboundMessage[];
-    retryCount: number;
-    status: "lost_lease" | "recorded" | "skipped";
-}
-/**
- * Record one failed execution attempt for pending messages, dead-lettering
- * the conversation when its retry budget or the legacy message delivery limit
- * is exhausted.
- *
- * Retries are counted only when the run made no durable progress: if any
- * attempted message left the mailbox, the remaining pending entries may be
- * deliberate deferrals and are left untouched. Consumed message ids stay in
- * `inboundMessageIds` so source retries remain duplicates.
- */
-export declare function recordAttemptFailure(args: {
-    conversationId: string;
-    inboundMessageIds: string[];
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<AttemptFailure>;
-/** Record a terminal failure completion for a leased conversation. */
-export declare function deadLetterAttempt(args: {
-    conversationId: string;
-    leaseToken: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<"failed" | "lost_lease" | "pending">;
-/** Recover an expired lease, consuming the retry budget under the mutation lock. */
-export declare function clearExpiredConversationLease(args: {
-    conversationId: string;
-    nowMs?: number;
-    state?: StateAdapter;
-}): Promise<"not_expired" | "requeued" | "stopped">;
-/** Delete one conversation mailbox and all of its index entries. */
-export declare function deleteConversationState(args: {
-    conversationId: string;
-    state?: StateAdapter;
-}): Promise<void>;
-/** Remove one conversation from the active index after it is missing or idle. */
-export declare function removeActiveConversation(args: {
-    conversationId: string;
-    state?: StateAdapter;
-}): Promise<void>;
-/** List active conversation ids by oldest execution update first. */
-export declare function listActiveConversationIds(args?: {
-    limit?: number;
-    staleBeforeMs?: number;
-    state?: StateAdapter;
-}): Promise<string[]>;
-/** List retained conversations by newest visible activity first. */
-export declare function listConversationsByActivity(args?: {
-    limit?: number;
-    offset?: number;
-    state?: StateAdapter;
-}): Promise<Conversation[]>;
-export {};