@sentry/junior 0.137.0 → 0.138.0

package/dist/chat/conversations/sql/store.d.ts

@@ -5,11 +5,19 @@ import type { JuniorSqlDatabase } from "@/db/db";
 import type { Conversation, ConversationExecution, ConversationSource, ConversationStore } from "../store";
 import type { AgentTurnUsage } from "@/chat/usage";
 import { type ProviderConversationBinding, type ProviderConversationReference } from "./bindings";
+/** Serialize one conversation's durable mutations inside a SQL transaction. */
+export declare function withConversationMutationLock<T>(executor: JuniorSqlDatabase, conversationId: string, callback: () => Promise<T>): Promise<T>;
 export declare class SqlStore implements ConversationStore {
     private readonly executor;
     constructor(executor: JuniorSqlDatabase);
     getConversationIdByProviderConversation(args: ProviderConversationReference): Promise<string | undefined>;
     bindProviderConversation(args: ProviderConversationBinding): Promise<void>;
+    createChild(args: {
+        childConversationId: string;
+        parentConversationId: string;
+        nowMs?: number;
+        source?: ConversationSource;
+    }): Promise<void>;
     get(args: {
         conversationId: string;
     }): Promise<Conversation | undefined>;

package/dist/chat/conversations/store.d.ts

@@ -49,6 +49,13 @@ export interface Conversation {
 }
 /** Persist and read durable conversation metadata for reporting surfaces. */
 export interface ConversationStore {
+    /** Create one destinationless child with immutable parent lineage. */
+    createChild(args: {
+        childConversationId: string;
+        parentConversationId: string;
+        nowMs?: number;
+        source?: ConversationSource;
+    }): Promise<void>;
     get(args: {
         conversationId: string;
     }): Promise<Conversation | undefined>;

package/dist/chat/experimental.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Known unstable product features that must be opted into explicitly.
+ * Add new keys here as features graduate from private experiments; remove them
+ * once they become stable defaults.
+ */
+export declare const EXPERIMENTAL_FEATURES: readonly ["subagents"];
+/** One known experimental feature name. */
+export type ExperimentalFeature = (typeof EXPERIMENTAL_FEATURES)[number];
+/** App-level opt-ins for unstable product features. */
+export type ExperimentalFeaturesConfig = Readonly<Partial<Record<ExperimentalFeature, boolean>>>;
+/** Replace app-level experimental opt-ins and return the previous setting. */
+export declare function setExperimentalFeatures(config?: ExperimentalFeaturesConfig): ExperimentalFeaturesConfig;
+/** Return a copy of the app-level experimental opt-ins configured by createApp(). */
+export declare function getExperimentalFeatures(): ExperimentalFeaturesConfig;
+/** Return whether one experimental feature is enabled via createApp({ experimental }). */
+export declare function isExperimentalFeatureEnabled(feature: ExperimentalFeature): boolean;

package/dist/chat/runtime/agent-runner.d.ts

@@ -1,4 +1,4 @@
-import type { AgentRunRequest } from "@/chat/agent/request";
+import { type AgentRunRequest, type SpawnAgent } from "@/chat/agent/request";
 import type { AgentRunOutcome } from "@/chat/runtime/agent-run-outcome";
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress/tracing";
 /** Run one agent-run slice behind runtime-owned orchestration boundaries. */
@@ -7,5 +7,6 @@ export interface AgentRunner {
 }
 /** Adapt the Pi-facing agent-run executor behind the runtime-owned runner seam. */
 export declare function createAgentRunner(run: AgentRunner["run"], options?: {
+    bindSpawnAgent?: (request: AgentRunRequest) => SpawnAgent | undefined;
     tracePropagation?: SandboxEgressTracePropagationConfig;
 }): AgentRunner;

package/dist/chat/services/auth-pause.d.ts

@@ -1,6 +1,5 @@
 export type AuthorizationPauseKind = "mcp" | "plugin";
 export type AuthorizationPauseDisposition = "link_already_sent" | "link_sent";
-export type AuthorizationFlowMode = "interactive" | "disabled";
 /**
  * Runtime-owned signal that the current turn must park until the user
  * completes an external authorization step.

package/dist/chat/services/mcp-auth-orchestration.d.ts

@@ -9,7 +9,7 @@
 import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
 import type { Destination, Source } from "@sentry/junior-plugin-api";
 import { type OAuthAuthorization } from "@/chat/oauth-authorization";
-import { AuthorizationPauseError, type AuthorizationFlowMode } from "@/chat/services/auth-pause";
+import { AuthorizationPauseError } from "@/chat/services/auth-pause";
 import type { ThreadArtifactsState } from "@/chat/state/artifacts";
 import type { ConversationPendingAuthState } from "@/chat/state/conversation";
 import type { PluginDefinition } from "@/chat/plugins/types";
@@ -32,7 +32,8 @@ export interface McpAuthOrchestrationInput {
     getArtifactState: () => ThreadArtifactsState | undefined;
     getMergedArtifactState: () => ThreadArtifactsState;
     recordPendingAuth?: (pendingAuth: ConversationPendingAuthState | undefined) => void | Promise<void>;
-    authorizationFlowMode?: AuthorizationFlowMode;
+    /** When false, required auth hard-fails instead of pausing for an OAuth link. */
+    interactiveAuthEnabled?: boolean;
     authorization?: OAuthAuthorization;
 }
 export interface McpAuthOrchestration {

package/dist/chat/services/plugin-auth-orchestration.d.ts

@@ -12,7 +12,7 @@
  */
 import type { Destination, Source } from "@sentry/junior-plugin-api";
 import type { UserTokenStore } from "@/chat/credentials/user-token-store";
-import { AuthorizationPauseError, type AuthorizationFlowMode } from "@/chat/services/auth-pause";
+import { AuthorizationPauseError } from "@/chat/services/auth-pause";
 import type { ConversationPendingAuthState } from "@/chat/state/conversation";
 import { type OAuthAuthorization } from "@/chat/oauth-authorization";
 export declare class PluginAuthorizationPauseError extends AuthorizationPauseError {
@@ -34,7 +34,8 @@ export interface PluginAuthOrchestrationInput {
     userMessage?: string;
     pendingAuth?: ConversationPendingAuthState;
     recordPendingAuth?: (pendingAuth: ConversationPendingAuthState) => void | Promise<void>;
-    authorizationFlowMode?: AuthorizationFlowMode;
+    /** When false, required auth hard-fails instead of pausing for an OAuth link. */
+    interactiveAuthEnabled?: boolean;
     userTokenStore?: UserTokenStore;
     authorization?: OAuthAuthorization;
 }

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

@@ -26,12 +26,10 @@ export interface AgentTurnSessionRecord {
     conversationId: string;
     cumulativeDurationMs: number;
     cumulativeUsage?: AgentTurnUsage;
-    destination?: Destination;
     dispatchId?: string;
     dispatchOutcome?: AgentDispatchOutcome;
     /** Provider-owned identifier returned after visible delivery is accepted. */
     resultMessageId?: string;
-    source?: Source;
     errorMessage?: string;
     lastProgressAtMs: number;
     loadedSkillNames?: string[];

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

@@ -13,6 +13,7 @@ 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";
     plugin: "plugin";
@@ -46,14 +47,14 @@ export declare const inboundMessageSchema: z.ZodObject<{
         defer: "defer";
         interrupt: "interrupt";
     }>;
-    destination: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    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">;
+    }, z.core.$strict>], "platform">>;
     inboundMessageId: z.ZodString;
     injectedAtMs: z.ZodOptional<z.ZodNumber>;
     input: z.ZodObject<{
@@ -84,6 +85,8 @@ export interface ConversationExecution {
     inboundMessageIds: string[];
     lastCheckpointAtMs?: number;
     lastEnqueuedAtMs?: number;
+    lastProgressAtMs?: number;
+    retryCount?: number;
     lease?: Lease;
     pendingCount: number;
     pendingMessages: InboundMessage[];
@@ -163,7 +166,7 @@ export declare function appendInboundMessage(args: {
 /** Mark a conversation runnable when there is no new mailbox message. */
 export declare function requestConversationWork(args: {
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<RequestConversationWorkResult>;
@@ -251,7 +254,7 @@ export declare function ackMessages(args: {
 /** Mark the leased conversation as needing another queue-delivered slice. */
 export declare function requestConversationContinuation(args: {
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     leaseToken: string;
     nowMs?: number;
     state?: StateAdapter;
@@ -270,25 +273,34 @@ export declare function releaseConversationWork(args: {
     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;
     state?: StateAdapter;
 }): Promise<"completed" | "lost_lease" | "pending">;
-/** Failure outcome: `lost_lease` (another owner took over), `recorded` (attempt counted), or `skipped` (durable progress was made). */
+/** 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 delivery attempt for the pending messages a run attempted,
- * dead-lettering messages that reach the retry limit so a deterministic
- * failure cannot requeue forever.
+ * Record one failed execution attempt for pending messages, dead-lettering
+ * the conversation when its retry budget or the legacy message delivery limit
+ * is exhausted.
  *
- * Attempts are counted only when the run made no durable progress: if any
+ * 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.
@@ -307,12 +319,12 @@ export declare function deadLetterAttempt(args: {
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<"failed" | "lost_lease" | "pending">;
-/** Clear an expired durable lease so a later worker can resume safely. */
+/** Recover an expired lease, consuming the retry budget under the mutation lock. */
 export declare function clearExpiredConversationLease(args: {
     conversationId: string;
     nowMs?: number;
     state?: StateAdapter;
-}): Promise<boolean>;
+}): Promise<"not_expired" | "requeued" | "stopped">;
 /** Delete one conversation mailbox and all of its index entries. */
 export declare function deleteConversationState(args: {
     conversationId: string;

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

@@ -2,7 +2,7 @@ import type { StateAdapter } from "chat";
 import type { ConversationStore } from "@/chat/conversations/store";
 import type { ConversationWorkQueue } from "./queue";
 import * as workState from "./state";
-export { CONVERSATION_ACTIVE_INDEX_KEY, CONVERSATION_BY_ACTIVITY_INDEX_KEY, CONVERSATION_WORK_CHECK_IN_INTERVAL_MS, CONVERSATION_WORK_LEASE_TTL_MS, CONVERSATION_WORK_MAX_DELIVERY_ATTEMPTS, CONVERSATION_WORK_STALE_ENQUEUE_MS, isFinalAttempt, isInvalidConversationRecordError, type AgentInput, type AttemptFailure, type AppendAndEnqueueInboundMessageResult, type AppendInboundMessageResult, type Conversation, type ConversationExecution, type ConversationWorkLease, type ConversationWorkState, type ExecutionStatus, type InboundMessage, type InboundMessageDelivery, type Lease, type RequestConversationWorkResult, type Source, type StartConversationWorkAcquired, type StartConversationWorkActive, type StartConversationWorkNoWork, type StartConversationWorkResult, } from "@/chat/task-execution/state";
+export { CONVERSATION_ACTIVE_INDEX_KEY, CONVERSATION_BY_ACTIVITY_INDEX_KEY, CONVERSATION_WORK_CHECK_IN_INTERVAL_MS, CONVERSATION_WORK_LEASE_TTL_MS, CONVERSATION_WORK_MAX_DELIVERY_ATTEMPTS, CONVERSATION_WORK_MAX_RETRIES, CONVERSATION_WORK_STALE_ENQUEUE_MS, isFinalAttempt, isInvalidConversationRecordError, type AgentInput, type AttemptFailure, type AppendAndEnqueueInboundMessageResult, type AppendInboundMessageResult, type Conversation, type ConversationExecution, type ConversationWorkLease, type ConversationWorkState, type ExecutionStatus, type InboundMessage, type InboundMessageDelivery, type Lease, type RequestConversationWorkResult, type Source, type StartConversationWorkAcquired, type StartConversationWorkActive, type StartConversationWorkNoWork, type StartConversationWorkResult, } from "@/chat/task-execution/state";
 import type { AppendAndEnqueueInboundMessageResult, Conversation, InboundMessage } from "@/chat/task-execution/state";
 export type EnsureConversationWakeResult = {
     queueMessageId?: string;
@@ -20,6 +20,14 @@ export declare function getConversationWorkState(args: {
     conversationId: string;
     state?: StateAdapter;
 }): Promise<workState.ConversationWorkState | undefined>;
+/** Count one failed conversation execution and persist its terminal retry state. */
+export declare function recordConversationRetry(args: {
+    conversationId: string;
+    conversationStore?: ConversationStore;
+    leaseToken: string;
+    nowMs?: number;
+    state?: StateAdapter;
+}): Promise<"stopped" | "lost_lease" | "recorded">;
 /** 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. */
@@ -98,14 +106,6 @@ export declare function drainConversationMailbox(args: Parameters<typeof workSta
     conversationId: string;
     createdAtMs: number;
     delivery: "defer" | "interrupt";
-    destination: {
-        platform: "slack";
-        teamId: string;
-        channelId: string;
-    } | {
-        platform: "local";
-        conversationId: string;
-    };
     inboundMessageId: string;
     input: {
         text: string;
@@ -116,6 +116,14 @@ export declare function drainConversationMailbox(args: Parameters<typeof workSta
     receivedAtMs: number;
     source: "slack" | "plugin" | "local" | "api" | "internal" | "resource_event" | "scheduler";
     attemptCount?: number | undefined;
+    destination?: {
+        platform: "slack";
+        teamId: string;
+        channelId: string;
+    } | {
+        platform: "local";
+        conversationId: string;
+    } | undefined;
     injectedAtMs?: number | undefined;
 }[]>;
 /** Acknowledge leased mailbox entries after the handler accepts responsibility. */
@@ -156,6 +164,7 @@ export declare function releaseConversationWork(args: {
 export declare function completeConversationWork(args: {
     conversationId: string;
     leaseToken: string;
+    madeProgress?: boolean;
     conversationStore?: ConversationStore;
     nowMs?: number;
     state?: StateAdapter;
@@ -177,13 +186,13 @@ export declare function deadLetterAttempt(args: {
     nowMs?: number;
     state?: StateAdapter;
 }): Promise<"pending" | "failed" | "lost_lease">;
-/** Clear an expired durable lease so a later worker can resume safely. */
+/** Recover an expired lease and persist the resulting retry state. */
 export declare function clearExpiredConversationLease(args: {
     conversationId: string;
     conversationStore?: ConversationStore;
     nowMs?: number;
     state?: StateAdapter;
-}): Promise<boolean>;
+}): Promise<"stopped" | "not_expired" | "requeued">;
 /** Remove one conversation from the active index after it is missing or idle. */
 export declare function removeActiveConversation(args: {
     conversationId: string;

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

@@ -8,13 +8,13 @@ export interface ConversationWorkerContext {
     attempt: InboxAttempt;
     checkIn(): Promise<boolean>;
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     shouldYield(): boolean;
 }
 export interface InboxAttempt {
     ack(): Promise<void>;
     conversationId: string;
-    destination: Destination;
+    destination?: Destination;
     drain(handle: (messages: InboundMessage[]) => Promise<readonly string[] | void>): Promise<InboundMessage[]>;
     isFinalAttempt: boolean;
     messages: InboundMessage[];

package/dist/chat/tools/runtime/spawn-agent.d.ts

@@ -0,0 +1,31 @@
+import type { ToolRuntimeContext } from "@/chat/tools/types";
+export declare const SPAWN_AGENT_TOOL_NAME = "spawnAgent";
+/** Create the asynchronous child-agent tool for one parent run. */
+export declare function createSpawnAgentTool(spawnAgent: NonNullable<ToolRuntimeContext["spawnAgent"]>): Omit<import("../definition").AnyToolDefinition, "inputSchema" | "outputSchema" | "prepareArguments" | "execute"> & {
+    inputSchema: import("../definition").JsonSchemaObject;
+    outputSchema: import("../definition").JsonSchemaObject;
+    prepareArguments(args: unknown): {
+        task: string;
+        name?: string | null | undefined;
+        reasoning_level?: "low" | "medium" | "high" | "xhigh" | "none" | null | undefined;
+    };
+    execute?: ((input: unknown, options: import("../definition").ToolExecuteOptions) => {
+        [x: string]: unknown;
+        invocation_id: string;
+        target?: string | undefined;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+    } | Promise<{
+        [x: string]: unknown;
+        invocation_id: string;
+        target?: string | undefined;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+    }>) | undefined;
+};

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

@@ -11,6 +11,7 @@ import type { LocalActor, Actor, SlackActor } from "@/chat/actor";
 import type { SlackActionToken } from "@/chat/slack/action-token";
 import type { ModelProfile } from "@/chat/model-profile";
 import type { GeneratedArtifactFileRef } from "@/chat/tools/sandbox/file-uploads";
+import type { SpawnAgent } from "@/chat/agent/request";
 interface HandoffControl {
     /** Non-empty catalog of configured targets. */
     profiles: readonly [ModelProfile, ...ModelProfile[]];
@@ -55,6 +56,7 @@ export interface ToolHooks {
 }
 interface BaseToolRuntimeContext {
     handoff?: HandoffControl;
+    spawnAgent?: SpawnAgent;
     /**
      * Opaque Junior conversation/session identity for this turn.
      * Interactive Slack turns use `slack:{channelId}:{threadTs}`.

package/dist/chunk-3Y47VMHV.js

@@ -0,0 +1,6 @@
+// src/chat/state/ttl.ts
+var JUNIOR_THREAD_STATE_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+
+export {
+  JUNIOR_THREAD_STATE_TTL_MS
+};

package/dist/chunk-5IDFPCON.js

@@ -0,0 +1,46 @@
+// src/chat/experimental.ts
+var EXPERIMENTAL_FEATURES = ["subagents"];
+var EXPERIMENTAL_FEATURE_SET = new Set(EXPERIMENTAL_FEATURES);
+var configuredExperimental = {};
+function isExperimentalFeature(value) {
+  return EXPERIMENTAL_FEATURE_SET.has(value);
+}
+function setExperimentalFeatures(config) {
+  const previous = { ...configuredExperimental };
+  if (config === void 0) {
+    configuredExperimental = {};
+    return previous;
+  }
+  const next = {};
+  for (const [rawName, enabled] of Object.entries(config)) {
+    if (enabled === void 0) {
+      continue;
+    }
+    if (typeof enabled !== "boolean") {
+      throw new Error(
+        `experimental.${rawName} must be a boolean when provided`
+      );
+    }
+    if (!isExperimentalFeature(rawName)) {
+      throw new Error(
+        `experimental.${rawName} is not a known experimental feature. Known features: ${EXPERIMENTAL_FEATURES.join(", ")}`
+      );
+    }
+    next[rawName] = enabled;
+  }
+  configuredExperimental = next;
+  return previous;
+}
+function getExperimentalFeatures() {
+  return { ...configuredExperimental };
+}
+function isExperimentalFeatureEnabled(feature) {
+  return configuredExperimental[feature] === true;
+}
+
+export {
+  EXPERIMENTAL_FEATURES,
+  setExperimentalFeatures,
+  getExperimentalFeatures,
+  isExperimentalFeatureEnabled
+};