@sentry/junior 0.194.0 → 0.196.0

package/dist/app.d.ts

@@ -1,4 +1,5 @@
 import { Hono } from "hono";
+import type { ModelProfileInput } from "@/chat/model-profile";
 import { type ExperimentalFeaturesConfig } from "@/chat/experimental";
 import { type SandboxResourceConfig } from "@/chat/sandbox/resources";
 import { type JuniorPluginSet } from "./plugins";
@@ -8,6 +9,7 @@ import { JUNIOR_VERSION } from "./version";
 export { defineJuniorPlugins } from "./plugins";
 export { JUNIOR_VERSION };
 export type { JuniorPluginInput, JuniorPluginSet, JuniorPluginSetOptions, } from "./plugins";
+export type { ModelProfileInput } from "@/chat/model-profile";
 export interface JuniorAppOptions {
     /** Authenticated dashboard mounted by core when configured. */
     dashboard?: JuniorDashboardOptions;
@@ -19,8 +21,12 @@ export interface JuniorAppOptions {
     experimental?: ExperimentalFeaturesConfig;
     /** Profile used for new conversations. Configure with `profiles`. */
     defaultProfile?: string;
-    /** Named profiles available to the router and handoff tool. Configure with `defaultProfile`. */
-    profiles?: Readonly<Record<string, string>>;
+    /**
+     * Named profiles available to the router and `handoff` tool. Configure with
+     * `defaultProfile`. Each value may be a model id string or an object with
+     * `modelId` and optional `description` and `reasoningLevel` settings.
+     */
+    profiles?: Readonly<Record<string, ModelProfileInput>>;
     /** Slack-specific overrides applied after env parsing. */
     slack?: {
         /** Slack emoji shown while Junior is processing. Defaults to `eyes`. */

package/dist/app.js

@@ -1,15 +1,15 @@
 import {
   processConversationWork
-} from "./chunk-73JEAQRT.js";
+} from "./chunk-LCAM2P7H.js";
 import {
   bindSpawnAgent
-} from "./chunk-XRDSML3K.js";
+} from "./chunk-P3LE2CSJ.js";
 import {
   createAgentInvocationWorker,
   enqueueAgentInvocation,
   listPendingAgentInvocationMailboxAppends,
   resolveAgentInvocationId
-} from "./chunk-F2KSURTJ.js";
+} from "./chunk-VKLQ2M7V.js";
 import {
   GET as GET2,
   GET2 as GET3,
@@ -37,12 +37,12 @@ import {
   startProcessingReaction,
   stripLeadingBotMention,
   wakePausedTurn
-} from "./chunk-INTBMGNX.js";
+} from "./chunk-EEUFKVCD.js";
 import "./chunk-FA6POGLH.js";
 import {
   AgentRunError,
   executeTurn
-} from "./chunk-53IEEFFP.js";
+} from "./chunk-KJGH3KWA.js";
 import {
   buildDeliveredTurnStatePatch,
   completeAuthPauseTurn,
@@ -53,7 +53,7 @@ import {
   getTurnUserSlackMessageTs,
   persistAuthPauseTurnState,
   requireTurnFailureEventId
-} from "./chunk-2NL3Y47F.js";
+} from "./chunk-J357NJQ5.js";
 import {
   claimDispatchMailboxAppend,
   confirmDispatchMailboxAppend,
@@ -73,11 +73,11 @@ import {
   processPluginTask,
   resolveTurnSessionRouting,
   scheduleSessionCompletedPluginTasks
-} from "./chunk-NPO24LAN.js";
+} from "./chunk-VVU7GHIZ.js";
 import {
   ConversationTurnLifecycleService,
   getTurnLifecycle
-} from "./chunk-6H2MKVV5.js";
+} from "./chunk-VSOO3Y6M.js";
 import {
   coerceThreadConversationState,
   getLocationConfigurationService,
@@ -86,7 +86,7 @@ import {
   persistThreadRuntimeState,
   persistThreadState,
   persistThreadStateById
-} from "./chunk-GY5SEFVL.js";
+} from "./chunk-QAINJHI4.js";
 import {
   GET,
   appendAndEnqueueWebMessage,
@@ -101,24 +101,24 @@ import {
   resolveSlackChannelTypeFromMessage,
   resolveSlackConversationContext,
   webActorFromEmail
-} from "./chunk-H4DCWLTR.js";
+} from "./chunk-EFNUCRB5.js";
 import {
   createWebAuthorization,
   deleteWebAuthorization
-} from "./chunk-XND3J6AT.js";
+} from "./chunk-RAWYH7TW.js";
 import {
   recordTaskExecution
-} from "./chunk-VOB2DKO6.js";
+} from "./chunk-LGXI6PWX.js";
 import "./chunk-RC745GGZ.js";
 import {
   createVercelPluginTaskCallback,
   queueCallback,
   registerVercelPluginTaskDevConsumer
-} from "./chunk-CFGBKPWQ.js";
+} from "./chunk-7TUDDW3Y.js";
 import {
   validatePluginEgressCredentialHooks,
   validatePluginRegistrations
-} from "./chunk-KNIAWMBU.js";
+} from "./chunk-PI6VXVBK.js";
 import {
   defineJuniorPlugins,
   pluginCatalogConfigFromEnv,
@@ -129,6 +129,7 @@ import {
   RESOURCE_EVENT_MESSAGE_AUTHOR,
   RESOURCE_EVENT_SYSTEM_ACTOR,
   SANDBOX_EGRESS_PROXY_PATH,
+  admitAutomatedTurn,
   buildSteeringPiMessage,
   clearSandboxEgressSignals,
   consumeSandboxEgressAuthRequiredSignal,
@@ -144,11 +145,14 @@ import {
   latestReportedProgress,
   listThreadReplies,
   logScheduledTaskRunSkipped,
+  maybePostAutomatedTurnLimitNotice,
   normalizeSandboxEgressTracePropagationDomains,
   parseSandboxEgressCredentialToken,
+  postAutomatedTurnLimitNoticeForDestination,
   processWorkspaceSnapshotJob,
   publicArtifactHeaders,
   readPublicArtifact,
+  recordFinishedTurnForAutomatedLimit,
   renderAttachmentText,
   renderBlockText,
   renderTaskInput,
@@ -158,11 +162,11 @@ import {
   shouldEmitDevAgentTrace,
   shouldPropagateSandboxEgressTrace,
   unpublishedArtifactHeaders
-} from "./chunk-G4RARFNT.js";
+} from "./chunk-OVWAO5KY.js";
 import {
   AuthorizationFlowDisabledError,
   PluginCredentialFailureError
-} from "./chunk-QMEF4Z7R.js";
+} from "./chunk-CNI74T7U.js";
 import "./chunk-6Y5B5PEX.js";
 import "./chunk-DIB4GX3G.js";
 import {
@@ -170,14 +174,14 @@ import {
   deleteMcpAuthSessionsForUserProvider,
   deleteMcpServerSessionId,
   deleteMcpStoredOAuthCredentials
-} from "./chunk-AWZS5SVX.js";
+} from "./chunk-N2MSPOGG.js";
 import {
   RetryableDeliveryError,
   createAgentRunner,
   formatProviderLabel,
   postSlackMessage,
   startOAuthFlow
-} from "./chunk-ENWIHU54.js";
+} from "./chunk-RFNMWONZ.js";
 import {
   ConversationTurnBoundaryError,
   CooperativeTurnYieldError,
@@ -193,7 +197,7 @@ import {
   markTurnCompleted,
   markTurnFailed,
   startActiveTurn
-} from "./chunk-G35QGPO2.js";
+} from "./chunk-DFWJJOW3.js";
 import {
   abandonTurnRecord,
   appendThreadContextMessages,
@@ -230,7 +234,7 @@ import {
   trimTrailingAssistantMessages,
   turnHasReply,
   upsertConversationMessage
-} from "./chunk-OEQOAONV.js";
+} from "./chunk-6LQNW2CJ.js";
 import {
   getExperimentalFeatures,
   isExperimentalFeatureEnabled,
@@ -250,10 +254,10 @@ import {
   scheduledRunId,
   scheduledRunSchema,
   withScheduledTaskLock
-} from "./chunk-WMJS5DDV.js";
+} from "./chunk-GZ336GZ5.js";
 import {
   parseSlackThreadId
-} from "./chunk-IOGDKPVU.js";
+} from "./chunk-VXAQTJSR.js";
 import {
   CONVERSATION_WORK_STALE_ENQUEUE_MS,
   appendAndEnqueueInboundMessage,
@@ -268,16 +272,16 @@ import {
   removeActiveConversation,
   requestConversationWork,
   stopConversationWork
-} from "./chunk-E53C73ML.js";
+} from "./chunk-S74KAE77.js";
 import {
   buildDeterministicAssistantMessageId,
   buildDeterministicTurnId
 } from "./chunk-DA2KGZZI.js";
-import "./chunk-RFE7DCZK.js";
+import "./chunk-B5WJBVHY.js";
 import {
   getSandboxResourceConfig,
   setSandboxResourceConfig
-} from "./chunk-ELCYG6UU.js";
+} from "./chunk-KZX7LORG.js";
 import "./chunk-PDO5BLNM.js";
 import "./chunk-UIE3R5XU.js";
 import {
@@ -286,7 +290,7 @@ import {
 } from "./chunk-X6GDDWQH.js";
 import {
   getTurnRequestDeadline
-} from "./chunk-NWWDFHXP.js";
+} from "./chunk-VRHZXY5X.js";
 import {
   getVercelConversationWorkQueue,
   resolveConversationWorkQueueTopic,
@@ -322,7 +326,7 @@ import {
   verifyEventTaskCredentialSubject,
   verifyScheduledTaskCredentialSubject,
   verifySlackDirectCredentialSubject
-} from "./chunk-CCTYK5RH.js";
+} from "./chunk-NE2UQMC7.js";
 import "./chunk-3Y47VMHV.js";
 import {
   createSlackDestination,
@@ -334,7 +338,7 @@ import {
   requireSlackDestination,
   withConversationEventLock,
   withConversationMutationLock
-} from "./chunk-ADEACKAH.js";
+} from "./chunk-XNXKRWWI.js";
 import {
   juniorAgentBindings,
   juniorAgentInvocations,
@@ -342,16 +346,16 @@ import {
   juniorConversations,
   juniorSchedulerRuns,
   juniorSchedulerTasks
-} from "./chunk-XLWZRHX5.js";
-import "./chunk-7ANA7PBB.js";
+} from "./chunk-PIZJBSGZ.js";
+import "./chunk-SR5FS2JP.js";
 import {
   acquireActiveLock,
   getStateAdapter,
   withActiveLock
-} from "./chunk-V4HXV5MY.js";
+} from "./chunk-EQBHN4JK.js";
 import {
   instructionProvenanceFor
-} from "./chunk-GFBR4S3Q.js";
+} from "./chunk-7NL7T6VU.js";
 import {
   juniorDestinations
 } from "./chunk-VFUK3X5B.js";
@@ -370,17 +374,17 @@ import {
   isProviderRetryError,
   setProfiles,
   setSlackReactionConfig
-} from "./chunk-U76RWMFR.js";
+} from "./chunk-5XSEOJPC.js";
 import {
   defaultModelId,
   modelIdForProfile
-} from "./chunk-D4YV5TDV.js";
-import "./chunk-JOI3DHML.js";
-import "./chunk-P2P6MUQ4.js";
+} from "./chunk-NHJU2ZAL.js";
+import "./chunk-ES7KCEND.js";
+import "./chunk-LSPUMNZK.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-WWXJUURQ.js";
-import "./chunk-S7GX44BU.js";
+} from "./chunk-G6YRPYDC.js";
+import "./chunk-BXIVMNLR.js";
 import {
   credentialContextForActor
 } from "./chunk-CEMMLV5L.js";
@@ -416,13 +420,13 @@ import {
   withContext,
   withLogContext,
   withSpan
-} from "./chunk-X76JVHQ4.js";
+} from "./chunk-CTS72G4B.js";
 import {
   continueTrace
 } from "./chunk-PEQXYSSE.js";
 import {
   JUNIOR_VERSION
-} from "./chunk-IME5OW4Y.js";
+} from "./chunk-I7GEGEHZ.js";
 
 // src/app.ts
 import { createRequire } from "module";
@@ -4444,7 +4448,7 @@ Assess conversation floor ownership and whether the latest message continues wor
 - should_reply=false when the latest message is plainly human-to-human, even if it discusses the same project.
 
 # Unsubscribe Policy
-- should_unsubscribe=true only when the latest message clearly tells ${assistantName} to stop watching, replying, participating, or to leave the thread.
+- should_unsubscribe=true when the latest message clearly tells ${assistantName} to stop or leave the thread.
 - If should_unsubscribe=true, should_reply must be false.
 - Ordinary disagreement, correction, or "not yet" is not an unsubscribe.
 
@@ -4472,14 +4476,9 @@ var RECENT_ASSISTANT_ENTRY_LIMIT = 40;
 var LEADING_SLACK_MENTION_RE = /^\s*<@([A-Z0-9]+)(?:\|([^>]+))?>[\s,:-]*/i;
 var LEADING_NAMED_MENTION_RE = /^\s*@([a-z0-9._-]+)\b[\s,:-]*/i;
 var TRANSCRIPT_MESSAGE_LINE_RE = /^\[(assistant|user)\]\s+([^:]+):\s+([\s\S]+)$/i;
-var FORCED_THREAD_OPTOUT_RE = /^!stop(?:\s|$)/i;
-var THREAD_OPTOUT_PATTERNS = [
-  /\bstop (?:watching|replying|participating)\b/i,
-  /\bstay out\b/i,
-  /\bdon['’]t (?:reply|participate|watch)\b/i,
-  /\bunsubscribe\b/i,
-  /\bleave (?:this )?thread\b/i
-];
+var BANG_STOP_RE = /(?:^|\s)!stop(?=\s|$|[.!?,;:])/i;
+var LEADING_ADDRESS_RE = /^(?:(?:<@[^>]+>|@[\w.-]+)\s*[,:\-–—]?\s*)+/i;
+var BARE_STOP_RE = /^stop(?:\s*[.!…]+)?$/i;
 var ACKNOWLEDGMENT_ONLY_RE = /^(?:thanks(?: you)?|thank you|thx|ty|got it|sounds good|sgtm|lgtm|ok(?:ay)?|cool|nice|perfect|awesome|great|makes sense|understood|roger|yep|yup|kk|on it|will do)(?:[.!]+)?$/i;
 var DIRECTED_FOLLOW_UP_CUE_RE = /\b(?:you said|you just said|your last response|your last answer|what did you just say|what do you mean|what did you mean|explain(?: that| this| it| more)?|clarify(?: that| this| it)?|expand(?: on)?(?: that| this| it)?|elaborate(?: on)?(?: that| this| it)?|say more)\b/i;
 var TERSE_CLARIFICATION_RE = /^(?:which one|which ones|why|how so|what do you mean|what did you mean|say more|explain that|clarify that|expand on that|elaborate on that)\??$/i;
@@ -4514,13 +4513,35 @@ function detectLeadingOtherPartyAddress(rawText, text, botUserName) {
   }
   return `named_mention:${directedName}`;
 }
-function isForcedThreadOptOutCommand(rawText, text) {
-  return FORCED_THREAD_OPTOUT_RE.test(rawText.trim()) || FORCED_THREAD_OPTOUT_RE.test(text.trim());
+function hasBangStop(rawText, text) {
+  return BANG_STOP_RE.test(rawText.trim()) || BANG_STOP_RE.test(text.trim());
 }
-function isThreadOptOutInstruction(rawText, text) {
-  return THREAD_OPTOUT_PATTERNS.some(
-    (pattern) => pattern.test(rawText) || pattern.test(text)
-  );
+function isBareStop(rawText, text) {
+  return [rawText, text].some((value) => {
+    const candidate = value.trim().replace(LEADING_ADDRESS_RE, "").trim();
+    return candidate.length > 0 && BARE_STOP_RE.test(candidate);
+  });
+}
+function getThreadStopDecision(args) {
+  const text = args.text.trim();
+  const rawText = args.rawText.trim();
+  if (hasBangStop(rawText, text)) {
+    return {
+      shouldReply: false,
+      shouldUnsubscribe: true,
+      reason: "thread_opt_out" /* ThreadOptOut */,
+      reasonDetail: "!stop"
+    };
+  }
+  if (isBareStop(rawText, text)) {
+    return {
+      shouldReply: false,
+      shouldUnsubscribe: true,
+      reason: "thread_opt_out" /* ThreadOptOut */,
+      reasonDetail: "stop"
+    };
+  }
+  return void 0;
 }
 function isAcknowledgmentOnly(text) {
   return ACKNOWLEDGMENT_ONLY_RE.test(text.trim());
@@ -4696,13 +4717,9 @@ function getSubscribedReplyPreflightDecision(args) {
 async function decideSubscribedThreadReply(args) {
   const text = args.input.text.trim();
   const rawText = args.input.rawText.trim();
-  if (isForcedThreadOptOutCommand(rawText, text)) {
-    return {
-      shouldReply: false,
-      shouldUnsubscribe: true,
-      reason: "thread_opt_out" /* ThreadOptOut */,
-      reasonDetail: "forced !stop command"
-    };
+  const stopDecision = getThreadStopDecision({ rawText, text });
+  if (stopDecision) {
+    return stopDecision;
   }
   const preflightDecision = getSubscribedReplyPreflightDecision({
     botUserName: args.botUserName,
@@ -4717,14 +4734,6 @@ async function decideSubscribedThreadReply(args) {
     return { shouldReply: false, reason: "empty_message" /* EmptyMessage */ };
   }
   if (args.input.isExplicitMention) {
-    if (isThreadOptOutInstruction(rawText, text)) {
-      return {
-        shouldReply: false,
-        shouldUnsubscribe: true,
-        reason: "thread_opt_out" /* ThreadOptOut */,
-        reasonDetail: "explicit stop instruction"
-      };
-    }
     return {
       shouldReply: true,
       reason: "explicit_mention" /* ExplicitMention */
@@ -5402,6 +5411,33 @@ function createSlackTurnRuntime(deps) {
           });
           const combinedText = combineTurnText(queuedMessages, currentText);
           const turnIsExplicitMention = Boolean(message.isMention) || queuedMessages.some((queued) => queued.explicitMention);
+          const stopDecision = [...queuedMessages, currentText].map(
+            (entry) => getThreadStopDecision({
+              rawText: entry.rawText,
+              text: entry.userText
+            })
+          ).find((decision2) => decision2?.shouldUnsubscribe);
+          if (stopDecision) {
+            const decision2 = {
+              shouldReply: false,
+              shouldUnsubscribe: true,
+              reason: stopDecision.reasonDetail ? `${stopDecision.reason}:${stopDecision.reasonDetail}` : stopDecision.reason
+            };
+            await maybeHandleThreadOptOutDecision({
+              thread,
+              decision: decision2,
+              beforeFirstResponsePost: hooks.beforeFirstResponsePost
+            });
+            await skipSubscribedMessage({
+              thread,
+              message,
+              decision: decision2,
+              context: threadContext,
+              ack: hooks.ack,
+              text: combinedText
+            });
+            return;
+          }
           const preflightDecision = getSubscribedReplyPreflightDecision({
             botUserName: deps.assistantUserName,
             rawText: combinedText.rawText,
@@ -7251,6 +7287,21 @@ function createSlackTurn(deps) {
                 })
               );
               await persistThreadRuntimeStateWithRetry(thread, completedState);
+              const automatedTurnLimit = await recordFinishedTurnForAutomatedLimit(
+                {
+                  conversationId,
+                  destination,
+                  maxTurns: botConfig.maxConsecutiveAutomatedTurns,
+                  source
+                }
+              );
+              await maybePostAutomatedTurnLimitNotice({
+                conversationId,
+                destination,
+                maxTurns: botConfig.maxConsecutiveAutomatedTurns,
+                threadTs,
+                update: automatedTurnLimit
+              });
             } catch (saveError) {
               saveFailed = true;
               saveFailureEventId = logException(
@@ -9141,6 +9192,19 @@ function createConversationTurnWorker(agentRunner, deliverMessage) {
                   surface
                 });
               }
+              const automatedTurnLimit = await recordFinishedTurnForAutomatedLimit({
+                conversationId: context.conversationId,
+                destination,
+                maxTurns: botConfig.maxConsecutiveAutomatedTurns,
+                source
+              });
+              await maybePostAutomatedTurnLimitNotice({
+                conversationId: context.conversationId,
+                destination,
+                maxTurns: botConfig.maxConsecutiveAutomatedTurns,
+                threadTs: conversationLocation?.provider === "slack" ? conversationLocation.threadTs : void 0,
+                update: automatedTurnLimit
+              });
               completedSuccessfully = reply.diagnostics.outcome === "success";
               return completedSuccessfully ? {
                 outcome: assistantMessageDelivered ? "success" : "no_reply"
@@ -9523,8 +9587,40 @@ async function ingestEventTasks(input, options) {
   const tasks = await findMatchingEventTasks(db, event, options.teamId);
   let dispatched = 0;
   const errors = [];
+  const maxTurns = botConfig.maxConsecutiveAutomatedTurns;
+  const noticedDestinations = /* @__PURE__ */ new Set();
   for (const task of tasks) {
     try {
+      const decision = await admitAutomatedTurn({
+        maxTurns,
+        nowMs,
+        scope: { kind: "destination", destination: task.destination }
+      });
+      if (decision.status === "paused") {
+        const destinationId = `${task.destination.teamId}:${task.destination.channelId}`;
+        logInfo("event_tasks.automated_turn_limit.paused", {
+          "app.automated_turn_limit.consecutive": decision.consecutiveAutomatedTurns,
+          "app.automated_turn_limit.max": maxTurns,
+          "app.event_task.id": task.id,
+          "app.resource_event.event_type": event.eventType,
+          "app.resource_event.namespace": event.namespace,
+          "app.slack.channel_id": task.destination.channelId,
+          "app.slack.team_id": task.destination.teamId
+        });
+        if (decision.shouldPostNotice && !noticedDestinations.has(destinationId)) {
+          const posted = await postAutomatedTurnLimitNoticeForDestination({
+            destination: task.destination,
+            maxTurns,
+            nowMs,
+            resumeIn: "channel",
+            scope: { kind: "destination", destination: task.destination }
+          });
+          if (posted) {
+            noticedDestinations.add(destinationId);
+          }
+        }
+        continue;
+      }
       const idempotencyKey = eventTaskDispatchKey(
         task.id,
         event.namespace,

package/dist/{catalog-runtime-MICXEBLK.js → catalog-runtime-EM7V2F4I.js}

@@ -1,14 +1,14 @@
 import {
   pluginCatalogRuntime
-} from "./chunk-WWXJUURQ.js";
-import "./chunk-S7GX44BU.js";
+} from "./chunk-G6YRPYDC.js";
+import "./chunk-BXIVMNLR.js";
 import "./chunk-CEMMLV5L.js";
 import "./chunk-N7TMSOZH.js";
 import "./chunk-DWPN6SCH.js";
 import "./chunk-TXKUKMVO.js";
-import "./chunk-X76JVHQ4.js";
+import "./chunk-CTS72G4B.js";
 import "./chunk-PEQXYSSE.js";
-import "./chunk-IME5OW4Y.js";
+import "./chunk-I7GEGEHZ.js";
 export {
   pluginCatalogRuntime
 };

package/dist/chat/agent/handoff.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Model-profile handoff helpers for one agent run slice.
+ *
+ * Owns the durable handoff commit, Pi apply shape, tool control, and the few
+ * loop checks that only care about handoff tool calls.
+ */
+import { type Agent, type AgentLoopTurnUpdate, type AgentTool } from "@earendil-works/pi-agent-core";
+import type { ResumeState } from "@/chat/agent/resume";
+import { type ModelProfile } from "@/chat/model-profile";
+import { resolveGatewayModel } from "@/chat/pi/client";
+import type { PiMessage } from "@/chat/pi/messages";
+import { type CompactContextArgs } from "@/chat/services/context-compaction";
+import { type TurnRoute } from "@/chat/services/turn-router";
+import type { ToolRuntimeContext } from "@/chat/tools/types";
+import { type AgentTurnUsage } from "@/chat/usage";
+/** Staged handoff waiting for the next Pi turn boundary. */
+export type PendingHandoff = {
+    messages: PiMessage[];
+    model: ReturnType<typeof resolveGatewayModel>;
+    modelId: string;
+    modelProfile: ModelProfile;
+    phaseUsage?: AgentTurnUsage;
+    thinkingLevel: NonNullable<AgentLoopTurnUpdate["thinkingLevel"]>;
+    turnRoute: TurnRoute;
+};
+/** Return the exclusive tool name when one is present among the calls. */
+export declare function exclusiveToolName(toolCalls: ReadonlyArray<{
+    name: string;
+}>): string | undefined;
+/** Build the tool control for every configured profile except the active one. */
+export declare function handoffControl(args: {
+    activeProfile: ModelProfile;
+    enabled: boolean;
+    execute: NonNullable<ToolRuntimeContext["handoff"]>["execute"];
+}): ToolRuntimeContext["handoff"];
+/**
+ * Rebind the handoff tool description and schema for the active profile.
+ * Other tools stay as wired.
+ */
+export declare function toolsForHandoffProfile(args: {
+    activeProfile: ModelProfile;
+    agentTools: AgentTool[];
+    enabled: boolean;
+    execute: NonNullable<ToolRuntimeContext["handoff"]>["execute"];
+}): AgentTool[];
+/**
+ * Commit the durable handoff epoch and return the staged Pi swap.
+ * No-op when the requested profile is already active.
+ */
+export declare function commitHandoff(args: {
+    activeModelProfile: ModelProfile;
+    beforeMessageCount: number;
+    conversationContext?: string;
+    conversationId: string;
+    metadata?: CompactContextArgs["metadata"];
+    onStatus?: (status: {
+        text: string;
+    }) => void | Promise<void>;
+    profile: ModelProfile;
+    runtimeContextSourceMessages?: PiMessage[];
+    signal?: AbortSignal;
+    sourceMessages: PiMessage[];
+    triggeringToolCallId?: string;
+    turnRoute: TurnRoute;
+}): Promise<PendingHandoff | undefined>;
+/** Apply a committed handoff to Pi and reset its durable resume baseline. */
+export declare function applyHandoff(args: {
+    agent: Agent;
+    baseInstructions: string;
+    pending: PendingHandoff;
+    resume: ResumeState;
+    tools: AgentTool[];
+}): AgentLoopTurnUpdate;

package/dist/chat/config.d.ts

@@ -1,5 +1,5 @@
 import { type TurnReasoningLevel } from "@/chat/reasoning-level";
-import { type ModelProfileConfig, type ModelProfile } from "@/chat/model-profile";
+import { type ModelProfileConfig, type ModelProfile, type ModelProfileInput } from "@/chat/model-profile";
 export declare const DEFAULT_SQL_STATEMENT_TIMEOUT_MS = 30000;
 /**
  * Buffer between the Vercel function timeout and the agent turn timeout so
@@ -22,6 +22,7 @@ export interface BotConfig {
     visionModelId?: string;
     maxSlicesPerTurn: number;
     maxToolCallsPerTurn: number;
+    maxConsecutiveAutomatedTurns: number;
     turnTimeoutMs: number;
     userName: string;
     webSearchModelId: string;
@@ -76,7 +77,7 @@ export interface SlackReactionConfig {
     processingReactionEmoji: string;
 }
 /** Apply profiles from createApp(). */
-export declare function setProfiles(profiles: Readonly<Record<string, string>> | undefined, defaultProfile: string | undefined): void;
+export declare function setProfiles(profiles: Readonly<Record<string, ModelProfileInput>> | undefined, defaultProfile: string | undefined): void;
 /** Return the current Slack reaction emoji config. */
 export declare function getSlackReactionConfig(): SlackReactionConfig;
 /** Apply Slack reaction emoji overrides from createApp() options, validating names. */