@sentry/junior 0.144.0 → 0.145.0

package/dist/chat/{state/turn-session.d.ts → task-execution/turn-cursor.d.ts}

@@ -1,11 +1,11 @@
 /**
- * Turn session records.
+ * Internal turn cursor storage for `checkpoint.ts`.
  *
- * These records track one user request across auth pauses, timeout slices, and
- * completion. Full Pi messages live in the durable conversation event store; this
- * record stores resumability metadata and a committed `seq` cursor into
- * `junior_conversation_events` so resumes can materialize the exact continuable
- * boundary without duplicating the event history.
+ * Callers outside `task-execution/` should use `checkpoint.ts` only.
+ * These records track one turn across auth pauses, timeout slices, and
+ * completion. Full Pi messages live in SQL conversation events; this store
+ * keeps resume metadata and a committed `seq` cursor into
+ * `junior_conversation_events`.
  */
 import type { Destination, Source } from "@sentry/junior-plugin-api";
 import { type PiMessage } from "@/chat/pi/messages";
@@ -15,12 +15,13 @@ import type { PluginTurnContext } from "@/chat/plugins/prompt";
 import type { AgentTurnUsage } from "@/chat/usage";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
 import type { ConversationStore } from "@/chat/conversations/store";
-export type AgentTurnSessionStatus = "running" | "awaiting_resume" | "completed" | "failed" | "abandoned";
+type TurnStatus = "running" | "paused" | "completed" | "failed" | "abandoned";
 export type AgentTurnSurface = "slack" | "api" | "scheduler" | "internal";
-export type AgentTurnResumeReason = "timeout" | "auth" | "yield" | "retry";
+export type TurnPauseReason = "timeout" | "auth" | "yield" | "retry";
 export type AgentDispatchOutcome = "blocked" | "completed" | "failed";
-export interface AgentTurnSessionRecord {
+export interface TurnRecord {
     channelName?: string;
+    schemaVersion: 2;
     version: number;
     conversationId: string;
     cumulativeDurationMs: number;
@@ -44,37 +45,38 @@ export interface AgentTurnSessionRecord {
      * replaces the singular execution actor, which is rebuilt at resume.
      */
     actors: Actor[];
-    resumeReason?: AgentTurnResumeReason;
+    resumeReason?: TurnPauseReason;
     resumedFromSliceId?: number;
-    sessionId: string;
+    turnId: string;
     sliceId: number;
     startedAtMs: number;
-    state: AgentTurnSessionStatus;
+    state: TurnStatus;
     surface?: AgentTurnSurface;
     traceId?: string;
     turnStartMessageIndex?: number;
     updatedAtMs: number;
 }
-export interface AgentTurnSessionSummary {
+export interface TurnSummary {
+    schemaVersion: 2;
     conversationId: string;
     dispatchId?: string;
     dispatchOutcome?: AgentDispatchOutcome;
     /** Provider-owned identifier returned after visible delivery is accepted. */
     resultMessageId?: string;
-    resumeReason?: AgentTurnResumeReason;
-    sessionId: string;
+    resumeReason?: TurnPauseReason;
+    turnId: string;
     sliceId: number;
-    state: AgentTurnSessionStatus;
+    state: TurnStatus;
     surface?: AgentTurnSurface;
     updatedAtMs: number;
     version: number;
 }
 /** Read a turn record pinned to the history version containing its checkpoint. */
-export declare function getAgentTurnSessionRecord(conversationId: string, sessionId: string): Promise<AgentTurnSessionRecord | undefined>;
-/** Read a turn session for resume, following a newer committed replacement while unfinished. */
-export declare function getAgentTurnSessionRecordForResume(conversationId: string, sessionId: string): Promise<AgentTurnSessionRecord | undefined>;
-/** Commit stable Pi session state and advance the turn session record. */
-export declare function upsertAgentTurnSessionRecord(args: {
+export declare function getTurnRecord(conversationId: string, turnId: string): Promise<TurnRecord | undefined>;
+/** Read a turn cursor for resume, following a newer committed replacement while unfinished. */
+export declare function getTurnRecordForResume(conversationId: string, turnId: string): Promise<TurnRecord | undefined>;
+/** Commit stable Pi state and advance the turn cursor. */
+export declare function upsertTurnRecord(args: {
     channelName?: string;
     conversationId: string;
     cumulativeDurationMs?: number;
@@ -90,15 +92,15 @@ export declare function upsertAgentTurnSessionRecord(args: {
     loadedSkillNames?: string[];
     modelId: string;
     conversationStore?: ConversationStore;
-    sessionId: string;
+    turnId: string;
     sliceId: number;
-    state: AgentTurnSessionStatus;
+    state: TurnStatus;
     surface?: AgentTurnSurface;
     piMessages: PiMessage[];
     /** Provenance for trailing newly committed messages, such as steering. */
     trailingMessageProvenance?: ConversationMessageProvenance[];
     actor?: Actor;
-    resumeReason?: AgentTurnResumeReason;
+    resumeReason?: TurnPauseReason;
     reasoningLevel?: string;
     errorMessage?: string;
     resumedFromSliceId?: number;
@@ -106,9 +108,8 @@ export declare function upsertAgentTurnSessionRecord(args: {
     turnContexts?: PluginTurnContext[];
     turnStartMessageIndex?: number;
     ttlMs?: number;
-}): Promise<AgentTurnSessionRecord>;
-/** Record turn-session metadata without storing conversation messages. */
-export declare function recordAgentTurnSessionSummary(args: {
+}): Promise<TurnRecord>;
+type TurnSummaryWrite = {
     channelName?: string;
     conversationId: string;
     cumulativeDurationMs?: number;
@@ -117,7 +118,6 @@ export declare function recordAgentTurnSessionSummary(args: {
     dispatchId?: string;
     dispatchOutcome?: AgentDispatchOutcome;
     resultMessageId?: string;
-    /** Confirmed destination visibility; omit when unavailable. */
     destinationVisibility?: ConversationPrivacy;
     source?: Source;
     lastProgressAtMs?: number;
@@ -125,28 +125,38 @@ export declare function recordAgentTurnSessionSummary(args: {
     modelId?: string;
     conversationStore?: ConversationStore;
     actor?: Actor;
-    resumeReason?: AgentTurnResumeReason;
+    resumeReason?: TurnPauseReason;
     reasoningLevel?: string;
-    sessionId: string;
+    turnId: string;
     sliceId: number;
     startedAtMs?: number;
-    state: AgentTurnSessionStatus;
+    state: TurnStatus;
     surface?: AgentTurnSurface;
     traceId?: string;
     ttlMs?: number;
-}): Promise<void>;
-/** List retained turn-session recovery projections for one conversation. */
-export declare function listAgentTurnSessionSummariesForConversation(conversationId: string): Promise<AgentTurnSessionSummary[]>;
-/** Mark an unfinished turn session record as abandoned when a newer turn wins. */
-export declare function abandonAgentTurnSessionRecord(args: {
+};
+/** Record turn metadata without storing conversation messages. */
+export declare function recordTurnSummary(args: TurnSummaryWrite): Promise<void>;
+/** List retained turn recovery projections for one conversation. */
+export declare function listTurnSummaries(conversationId: string): Promise<TurnSummary[]>;
+/** Mark an unfinished turn cursor as abandoned when a newer turn wins. */
+export declare function abandonTurnRecord(args: {
     conversationId: string;
-    sessionId: string;
+    turnId: string;
     errorMessage?: string;
-}): Promise<AgentTurnSessionRecord | undefined>;
-/** Mark an unfinished turn session record as failed so it cannot resume. */
-export declare function failAgentTurnSessionRecord(args: {
+}): Promise<TurnRecord | undefined>;
+/** Mark an unfinished turn cursor as completed after delivery was accepted. */
+export declare function completeTurnRecord(args: {
+    conversationId: string;
+    expectedVersion: number;
+    resultMessageId?: string;
+    turnId: string;
+}): Promise<TurnRecord | undefined>;
+/** Mark an unfinished turn cursor as failed so it cannot resume. */
+export declare function failTurnRecord(args: {
     conversationId: string;
     expectedVersion: number;
-    sessionId: string;
+    turnId: string;
     errorMessage?: string;
-}): Promise<AgentTurnSessionRecord | undefined>;
+}): Promise<TurnRecord | undefined>;
+export {};

package/dist/chat/task-execution/turn-wake.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Continue a paused turn via the conversation work queue.
+ *
+ * Wake-only: mailbox/lease own liveness; this just nudges the worker.
+ */
+import type { StateAdapter } from "chat";
+import type { Destination } from "@sentry/junior-plugin-api";
+import type { ConversationStore } from "@/chat/conversations/store";
+import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
+export interface PausedTurnRequest {
+    conversationId: string;
+    destination: Destination;
+    expectedVersion: number;
+    turnId: string;
+}
+interface TurnWakeOptions {
+    nowMs?: number;
+    queue?: ConversationWorkQueue;
+    state?: StateAdapter;
+}
+/** Build the worker input for a paused turn. */
+export declare function getPausedTurnRequest(args: {
+    conversationId: string;
+    conversationStore?: ConversationStore;
+    turnId: string;
+}): Promise<PausedTurnRequest | undefined>;
+/** Wake the conversation worker for a paused turn. */
+export declare function wakePausedTurn(request: PausedTurnRequest, options?: TurnWakeOptions): Promise<void>;
+export {};

package/dist/chat/tools/types.d.ts

@@ -2,7 +2,7 @@ import type { FileUpload } from "chat";
 import type { Destination, Identity, LocalDestination, LocalSource, PluginEgress, SlackDestination, SlackSource, Source, User } from "@sentry/junior-plugin-api";
 import type { McpToolManager } from "@/chat/mcp/tool-manager";
 import type { SandboxWorkspace } from "@/chat/sandbox/workspace";
-import type { AgentTurnSurface } from "@/chat/state/turn-session";
+import type { AgentTurnSurface } from "@/chat/task-execution/checkpoint";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { Skill } from "@/chat/skills";
 import type { LoadSkillMetadata } from "@/chat/tools/skill/load-skill";

package/dist/{chunk-HNO2E5WB.js → chunk-27TEJTZO.js}

@@ -1,6 +1,6 @@
 import {
   DEFAULT_SQL_STATEMENT_TIMEOUT_MS
-} from "./chunk-3GU4PWA3.js";
+} from "./chunk-XFKIRN3Q.js";
 import {
   juniorDestinations,
   timestamptz

package/dist/{chunk-RIFJUJSI.js → chunk-2LWPFSB4.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-6GWA276C.js";
 import {
   getDeploymentTelemetryAttributes
-} from "./chunk-WTX2RFJG.js";
+} from "./chunk-DS3J6WGY.js";
 
 // src/chat/logging.ts
 import path from "path";

package/dist/{chunk-SBZP2J5Q.js → chunk-2UH3JI64.js}

@@ -5,12 +5,12 @@ import {
   juniorConversations,
   juniorIdentities,
   juniorUsers
-} from "./chunk-HNO2E5WB.js";
+} from "./chunk-27TEJTZO.js";
 import {
   TURN_REASONING_LEVELS,
   getChatConfig,
   modelProfileSchema
-} from "./chunk-3GU4PWA3.js";
+} from "./chunk-XFKIRN3Q.js";
 import {
   juniorDestinations
 } from "./chunk-VFUK3X5B.js";
@@ -20,7 +20,7 @@ import {
 } from "./chunk-F3B2YJ76.js";
 import {
   normalizeIdentityEmail
-} from "./chunk-RIFJUJSI.js";
+} from "./chunk-2LWPFSB4.js";
 
 // src/chat/conversations/sql/store.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -376,16 +376,17 @@ function destinationUpsertFromDestination(args) {
   };
 }
 function executionStatusFromValue(value) {
-  if (value === "awaiting_resume" || value === "failed" || value === "idle" || value === "pending" || value === "running") {
+  if (value === "awaiting_resume" || value === "paused") return "paused";
+  if (value === "failed" || value === "idle" || value === "pending" || value === "running") {
     return value;
   }
   throw new Error("Conversation record execution status is invalid");
 }
+function executionStatusToSql(status) {
+  return status === "paused" ? "awaiting_resume" : status;
+}
 function actorFromIdentityRow(identity, userDisplayName) {
-  if (!identity) {
-    return void 0;
-  }
-  if (identity.provider !== "slack") {
+  if (!identity || identity.provider !== "slack") {
     return void 0;
   }
   const fullName = userDisplayName?.trim() ? userDisplayName : identity.displayName;
@@ -816,7 +817,7 @@ var SqlStore = class {
       lastActivityAt: dateFromMs2(conversation.lastActivityAtMs),
       updatedAt: dateFromMs2(conversation.updatedAtMs),
       executionUpdatedAt: conversation.execution.updatedAtMs === void 0 ? null : dateFromMs2(conversation.execution.updatedAtMs),
-      executionStatus: conversation.execution.status,
+      executionStatus: executionStatusToSql(conversation.execution.status),
       runId: conversation.execution.runId ?? null,
       lastCheckpointAt: conversation.execution.lastCheckpointAtMs === void 0 ? null : dateFromMs2(conversation.execution.lastCheckpointAtMs),
       lastEnqueuedAt: conversation.execution.lastEnqueuedAtMs === void 0 ? null : dateFromMs2(conversation.execution.lastEnqueuedAtMs),