@sentry/junior 0.96.0 → 0.97.0

package/dist/chat/services/context-compaction.d.ts

@@ -1,6 +1,7 @@
 import type { completeText } from "@/chat/pi/client";
 import type { PiMessage } from "@/chat/pi/messages";
 import type { ThreadConversationState } from "@/chat/state/conversation";
+import { type ModelProfile } from "@/chat/model-profile";
 export interface ContextCompactorDeps {
     completeText: typeof completeText;
     autoCompactionTriggerTokens?: number;
@@ -26,7 +27,21 @@ export interface CompactContextResult {
     piMessages?: PiMessage[];
     reason?: "below_threshold" | "missing_context" | "summary_failed";
 }
+interface HandoffContextArgs {
+    conversationContext?: string;
+    conversationId: string;
+    metadata?: CompactContextArgs["metadata"];
+    piMessages: PiMessage[];
+    signal?: AbortSignal;
+    target: {
+        modelId: string;
+        modelProfile: ModelProfile;
+    };
+}
 /** Build retained user messages for a compacted Pi replacement history. */
 export declare function selectRetainedUserMessages(messages: PiMessage[], maxTokens?: number): PiMessage[];
 /** Build the service that owns local context compaction. */
 export declare function createContextCompactor(deps: ContextCompactorDeps): ContextCompactor;
+/** Compact the active conversation and durably bind its selected handoff profile. */
+export declare function compactContextForHandoff(args: HandoffContextArgs, deps: Pick<ContextCompactorDeps, "completeText">): Promise<PiMessage[]>;
+export {};

package/dist/chat/services/turn-result.d.ts

@@ -50,6 +50,7 @@ export interface TurnResultInput {
         runId?: string;
     };
     assistantUserName?: string;
+    modelId: string;
 }
 /** Process raw agent messages into a structured AgentRunResult. */
 export declare function buildTurnResult(input: TurnResultInput): AgentRunResult;

package/dist/chat/services/turn-session-record.d.ts

@@ -21,7 +21,6 @@ interface SessionRecordLogContext {
     channelId?: string;
     runId?: string;
     assistantUserName?: string;
-    modelId: string;
 }
 /** Load turn session record state for a conversation/session pair. */
 export declare function loadTurnSessionRecord(ctx: TurnSessionContext): Promise<TurnSessionState>;
@@ -38,7 +37,7 @@ export declare function persistRunningSessionRecord(args: {
     trailingMessageProvenance?: PiMessageProvenance[];
     loadedSkillNames?: string[];
     logContext: SessionRecordLogContext;
-    modelId?: string;
+    modelId: string;
     actor?: Actor;
     reasoningLevel?: string;
     surface?: AgentTurnSurface;
@@ -68,7 +67,7 @@ export declare function persistCompletedSessionRecord(args: {
     allMessages: PiMessage[];
     loadedSkillNames?: string[];
     logContext: SessionRecordLogContext;
-    modelId?: string;
+    modelId: string;
     actor?: Actor;
     reasoningLevel?: string;
     surface?: AgentTurnSurface;
@@ -84,6 +83,7 @@ export declare function completeDeliveredTurn(args: {
     loadedSkillNames?: string[];
     logContext: SessionRecordLogContext;
     messages: PiMessage[];
+    modelId: string;
     actor?: Actor;
     reasoningLevel?: string;
     sessionId: string;
@@ -108,7 +108,7 @@ export declare function persistAuthPauseSessionRecord(args: {
     source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
-    modelId?: string;
+    modelId: string;
     errorMessage: string;
     logContext: SessionRecordLogContext;
     actor?: Actor;
@@ -130,7 +130,7 @@ export declare function persistTimeoutSessionRecord(args: {
     source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
-    modelId?: string;
+    modelId: string;
     errorMessage: string;
     logContext: SessionRecordLogContext;
     actor?: Actor;
@@ -151,7 +151,7 @@ export declare function persistYieldSessionRecord(args: {
     source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
-    modelId?: string;
+    modelId: string;
     errorMessage: string;
     logContext: SessionRecordLogContext;
     actor?: Actor;

package/dist/chat/state/turn-session.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Turn session records.
+ *
+ * These records track one user request across auth pauses, timeout slices, and
+ * completion. Full Pi messages live in the durable agent step store; this
+ * record stores resumability metadata and a committed `seq` cursor into
+ * `junior_agent_steps` so resumes can materialize the exact continuable
+ * boundary without duplicating the step history.
+ */
+import { type StateAdapter } from "chat";
 import { type Destination, type Source } from "@sentry/junior-plugin-api";
 import type { PiMessage } from "@/chat/pi/messages";
 import { type Actor } from "@/chat/actor";
@@ -26,9 +36,9 @@ export interface AgentTurnSessionRecord {
     piMessageProvenance: PiMessageProvenance[];
     /**
      * All distinct actors annotated on this run's committed instruction-authority
-     * messages, in first-seen order. Derived from `piMessageProvenance` at
-     * materialization — never persisted separately, so it cannot drift from
-     * provenance. Attribution only; never an authority source.
+     * messages, in first-seen order. Persisted as an attribution handle so a
+     * summary-only handoff cannot erase them. It never grants authority or
+     * replaces the singular execution actor.
      */
     actors: Actor[];
     /** The single actor this run executes as (credential binding, auth flows). */
@@ -59,7 +69,7 @@ export declare function upsertAgentTurnSessionRecord(args: {
     source?: Source;
     lastProgressAtMs?: number;
     loadedSkillNames?: string[];
-    modelId?: string;
+    modelId: string;
     conversationStore?: ConversationStore;
     sessionId: string;
     sliceId: number;
@@ -69,6 +79,7 @@ export declare function upsertAgentTurnSessionRecord(args: {
     /** Provenance for trailing newly committed messages, such as steering. */
     trailingMessageProvenance?: PiMessageProvenance[];
     actor?: Actor;
+    actors?: Actor[];
     resumeReason?: AgentTurnResumeReason;
     reasoningLevel?: string;
     errorMessage?: string;
@@ -111,7 +122,7 @@ export declare function listAgentTurnSessionSummaries(limit?: number): Promise<A
 /** List turn-session summaries for one conversation without the global feed cap. */
 export declare function listAgentTurnSessionSummariesForConversation(conversationId: string): Promise<AgentTurnSessionSummary[]>;
 /** Read complete per-conversation summary indexes with bounded backend load. */
-export declare function listAgentTurnSessionSummariesForConversations(conversationIds: string[]): Promise<Map<string, AgentTurnSessionSummary[]>>;
+export declare function listAgentTurnSessionSummariesForConversations(stateAdapter: StateAdapter, conversationIds: string[]): Promise<Map<string, AgentTurnSessionSummary[]>>;
 /** Mark an unfinished turn session record as abandoned when a newer turn wins. */
 export declare function abandonAgentTurnSessionRecord(args: {
     conversationId: string;

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

@@ -128,7 +128,7 @@ export declare function completeConversationWork(args: {
     conversationStore?: ConversationStore;
     nowMs?: number;
     state?: StateAdapter;
-}): Promise<"pending" | "completed" | "lost_lease">;
+}): Promise<"completed" | "pending" | "lost_lease">;
 /** Record one failed delivery attempt and dead-letter messages at their limit. */
 export declare function recordAttemptFailure(args: {
     conversationId: string;
@@ -145,7 +145,7 @@ export declare function deadLetterAttempt(args: {
     conversationStore?: ConversationStore;
     nowMs?: number;
     state?: StateAdapter;
-}): Promise<"pending" | "failed" | "lost_lease">;
+}): Promise<"failed" | "pending" | "lost_lease">;
 /** Clear an expired durable lease so a later worker can resume safely. */
 export declare function clearExpiredConversationLease(args: {
     conversationId: string;

package/dist/chat/tools/handoff/tool.d.ts

@@ -0,0 +1,45 @@
+import type { ToolRuntimeContext } from "@/chat/tools/types";
+export declare const HANDOFF_TOOL_NAME = "handoff";
+/** Create the terminal standard-agent control for an in-place model upgrade. */
+export declare function createHandoffTool(handoff: NonNullable<ToolRuntimeContext["handoff"]>): Omit<import("../definition").AnyToolDefinition, "inputSchema" | "outputSchema" | "prepareArguments" | "execute"> & {
+    inputSchema: import("../definition").JsonSchemaObject;
+    outputSchema: import("../definition").JsonSchemaObject;
+    prepareArguments(args: unknown): {
+        profile?: string | null | undefined;
+    };
+    execute?: ((input: unknown, options: import("../definition").ToolExecuteOptions) => {
+        [x: string]: unknown;
+        ok: boolean;
+        status: "error" | "success";
+        model_profile: string;
+        target?: string | undefined;
+        data?: unknown;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+        error?: string | {
+            kind: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+    } | Promise<{
+        [x: string]: unknown;
+        ok: boolean;
+        status: "error" | "success";
+        model_profile: string;
+        target?: string | undefined;
+        data?: unknown;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+        error?: string | {
+            kind: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+    }>) | undefined;
+};

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

@@ -6,9 +6,14 @@ import type { AgentTurnSurface } from "@/chat/state/turn-session";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { Skill } from "@/chat/skills";
 import type { LoadSkillMetadata } from "@/chat/tools/skill/load-skill";
-import type { AdvisorToolRuntimeContext } from "@/chat/tools/advisor/tool";
 import type { JuniorToolResult } from "@/chat/tool-support/structured-result";
 import type { LocalActor, Actor, SlackActor } from "@/chat/actor";
+import type { ModelProfile } from "@/chat/model-profile";
+interface HandoffControl {
+    /** Non-empty catalog with the default target first. */
+    profiles: readonly [ModelProfile, ...ModelProfile[]];
+    execute: (profile: ModelProfile, signal?: AbortSignal) => Promise<void>;
+}
 export interface ImageGenerateToolDeps {
     fetch?: typeof fetch;
 }
@@ -46,7 +51,7 @@ export interface ToolHooks {
     };
 }
 interface BaseToolRuntimeContext {
-    advisor?: AdvisorToolRuntimeContext;
+    handoff?: HandoffControl;
     /**
      * Opaque Junior conversation/session identity for this turn.
      * Interactive Slack turns use `slack:{channelId}:{threadTs}`.

package/dist/chat/usage.d.ts

@@ -1,28 +1,28 @@
-import { z } from "zod";
-export declare const agentTurnCostSchema: z.ZodObject<{
-    input: z.ZodOptional<z.ZodNumber>;
-    output: z.ZodOptional<z.ZodNumber>;
-    cacheRead: z.ZodOptional<z.ZodNumber>;
-    cacheWrite: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strict>;
+import type { Usage, UsageCost } from "@/usage-schema";
+export declare const agentTurnCostSchema: import("zod").ZodObject<{
+    input: import("zod").ZodOptional<import("zod").ZodNumber>;
+    output: import("zod").ZodOptional<import("zod").ZodNumber>;
+    cacheRead: import("zod").ZodOptional<import("zod").ZodNumber>;
+    cacheWrite: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strict>;
 /** Estimated USD cost reported by pi-ai for one or more model calls. */
-export type AgentTurnCost = z.output<typeof agentTurnCostSchema>;
-export declare const agentTurnUsageSchema: z.ZodObject<{
-    inputTokens: z.ZodOptional<z.ZodNumber>;
-    outputTokens: z.ZodOptional<z.ZodNumber>;
-    cachedInputTokens: z.ZodOptional<z.ZodNumber>;
-    cacheCreationTokens: z.ZodOptional<z.ZodNumber>;
-    reasoningTokens: z.ZodOptional<z.ZodNumber>;
-    totalTokens: z.ZodOptional<z.ZodNumber>;
-    cost: z.ZodOptional<z.ZodObject<{
-        input: z.ZodOptional<z.ZodNumber>;
-        output: z.ZodOptional<z.ZodNumber>;
-        cacheRead: z.ZodOptional<z.ZodNumber>;
-        cacheWrite: z.ZodOptional<z.ZodNumber>;
-        total: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
+export type AgentTurnCost = UsageCost;
+export declare const agentTurnUsageSchema: import("zod").ZodObject<{
+    inputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+    outputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+    cachedInputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+    cacheCreationTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+    reasoningTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+    totalTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+    cost: import("zod").ZodOptional<import("zod").ZodObject<{
+        input: import("zod").ZodOptional<import("zod").ZodNumber>;
+        output: import("zod").ZodOptional<import("zod").ZodNumber>;
+        cacheRead: import("zod").ZodOptional<import("zod").ZodNumber>;
+        cacheWrite: import("zod").ZodOptional<import("zod").ZodNumber>;
+        total: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strict>>;
+}, import("zod/v4/core").$strict>;
 /**
  * Structured token and cost usage captured for a single agent turn.
  *
@@ -31,7 +31,7 @@ export declare const agentTurnUsageSchema: z.ZodObject<{
  * provider normalizes into the pi-ai shape as its own item. Renderers decide
  * whether to display a breakdown or a single aggregate.
  */
-export type AgentTurnUsage = z.output<typeof agentTurnUsageSchema>;
+export type AgentTurnUsage = Usage;
 /** Return whether any token counter is present on a usage record. */
 export declare function hasAgentTurnUsage(usage: AgentTurnUsage | undefined): usage is AgentTurnUsage;
 /** Aggregate token usage across slices without double-counting provider totals. */