@sentry/junior 0.244.0 → 0.246.0

package/dist/api.js

@@ -1,24 +1,24 @@
-import { L as editEventAutomation, Mt as getConversation, O as parseSlackThreadId, P as editScheduledAutomation, R as AutomationEditError, St as cancelHumanFacingPendingMessages, T as readLiveAttachment, V as resolveTaskOutcomes, _t as pluginEventCatalog, g as readStats, ht as getEventCatalog, tt as listChildAgents, z as eventAutomationTriggerAvailable } from "./agent-runner-DtEtbaOb.js";
-import { d as logException, p as logWarn } from "./logging-z7_w-KN_.js";
+import { Et as automationEventCatalog, G as listChildAgents, Ht as getConversation, L as editEventAutomation, Mt as cancelHumanFacingPendingMessages, O as parseSlackThreadId, P as editScheduledAutomation, R as AutomationEditError, St as getEventCatalog, T as readLiveAttachment, V as resolveTaskOutcomes, g as readStats, it as getChildAgentLabel, z as eventAutomationTriggerAvailable } from "./agent-runner-DSKpHjHW.js";
+import { d as logException, p as logWarn } from "./logging-DVtMYOdD.js";
 import { d as parseSlackTeamId, g as parseSlackMessageTs, l as parseSlackChannelId } from "./actor-BTtLaeWy.js";
-import { E as resolveRootConversationId, T as hasAgentTurnUsage, _ as locationFromRow, b as parseSessionSource, c as getConversationEventStore, d as getDb, f as getSqlExecutor, i as resolveViewerUser, m as withConversationEventLock, o as updateViewerDisplayName, t as findUserByEmail, u as getConversationStore, w as agentTurnUsageSchema } from "./viewer-BBnCMR1g.js";
+import { E as resolveRootConversationId, T as hasAgentTurnUsage, _ as locationFromRow, b as parseSessionSource, c as getConversationEventStore, d as getDb, f as getSqlExecutor, i as resolveViewerUser, m as withConversationEventLock, o as updateViewerDisplayName, t as findUserByEmail, u as getConversationStore, w as agentTurnUsageSchema } from "./viewer-D5hbx6TE.js";
 import { c as juniorIdentities, d as juniorDestinations, l as juniorUsers, o as conversationReadColumns, s as juniorConversations } from "./agent-invocations-BO6ddZax.js";
-import { _ as juniorConversationEvents, b as juniorCodeChanges, f as juniorConversationParticipants, g as juniorConversationMetrics, m as juniorConversationBriefs, v as juniorApiTokens, x as juniorCodeRepositories } from "./executor-DA7eHhmC.js";
+import { _ as juniorConversationEvents, b as juniorCodeChanges, f as juniorConversationParticipants, g as juniorConversationMetrics, m as juniorConversationBriefs, v as juniorApiTokens, x as juniorCodeRepositories } from "./executor-bmmuRY-w.js";
 import { u as contextProvenance } from "./history-Nte1oVed.js";
-import { D as automationRevision, E as AutomationConflictError, Et as loadTurnProjection, O as requireAutomationRevision, S as automationDefinition, T as sameDefinitionValue, a as readScheduledAutomation, b as saveEventAutomation, g as getEventAutomation, ln as piMessageFromHistoryItem, m as eventAutomationBelongsToUser, o as saveScheduledAutomation, w as readAutomationVersion, x as setEventAutomationStatus } from "./tasks-DBZAgTx7.js";
-import { At as listConversationAnnotations, C as WorkspaceValidationError, M as workspaceRepoCheckoutPath, O as SANDBOX_RUNTIME, Pt as lookupSlackUser, S as updateWorkspace, St as buildSentryConversationUrl, Wt as withSlackRetries, _ as deleteWorkspace, _t as conversationNotArchivedForUser, b as listWorkspaces, bt as readLatestConversationBrief, dt as conversationArchiveTimes, ft as conversationArchivedForEmail, g as createWorkspace, gt as conversationNotArchivedForEmail, ht as conversationHasParticipantUser, jt as listConversationAnnotationsById, lt as createPluginLogger, mt as conversationHasParticipantEmail, pt as conversationArchivedForUser, u as getPlugins, ut as readConversationAccessFromSql, v as getWorkspace, vt as viewerConversationMembership, x as listWorkspacesByRepository, xt as readConversationEventPage, zt as getSlackClient } from "./agent-hooks-Cj_rSeWd.js";
-import { A as forkConversationResponseSchema, D as createConversationBodySchema, N as readMessageAttachments, O as createConversationMessageBodySchema, P as INPUT_IMAGE_TYPES, T as conversationStatsReportSchema, _ as conversationParamsSchema, a as cancelConversationPendingMessagesBodySchema, c as conversationAttachmentParamsSchema, d as conversationDetailReportSchema, g as conversationFeedSchema, h as conversationFeedQuerySchema, i as archiveConversationResponseSchema, k as forkConversationBodySchema, m as conversationEventsQuerySchema, o as cancelConversationPendingMessagesResponseSchema, p as conversationEventPageSchema, r as archiveConversationBodySchema, t as acceptedConversationMessageSchema, u as conversationDetailQuerySchema, x as conversationPendingMessagesReportSchema } from "./conversation-BxvgH64Q.js";
-import { n as hash, t as create } from "./profile-yeKVNECl.js";
+import { A as requireAutomationRevision, D as sameDefinitionValue, E as readAutomationVersion, O as AutomationConflictError, Ot as loadTurnProjection, a as readScheduledAutomation, b as saveEventAutomation, dn as piMessageFromHistoryItem, g as getEventAutomation, k as automationRevision, m as eventAutomationBelongsToUser, o as saveScheduledAutomation, w as automationDefinition, x as setEventAutomationStatus } from "./tasks-B9OIjl2K.js";
+import { At as listConversationAnnotations, C as WorkspaceValidationError, M as workspaceRepoCheckoutPath, O as SANDBOX_RUNTIME, Pt as lookupSlackUser, S as updateWorkspace, St as buildSentryConversationUrl, Wt as withSlackRetries, _ as deleteWorkspace, _t as conversationNotArchivedForUser, b as listWorkspaces, bt as readLatestConversationBrief, dt as conversationArchiveTimes, ft as conversationArchivedForEmail, g as createWorkspace, gt as conversationNotArchivedForEmail, ht as conversationHasParticipantUser, jt as listConversationAnnotationsById, lt as createPluginLogger, mt as conversationHasParticipantEmail, pt as conversationArchivedForUser, u as getPlugins, ut as readConversationAccessFromSql, v as getWorkspace, vt as viewerConversationMembership, x as listWorkspacesByRepository, xt as readConversationEventPage, zt as getSlackClient } from "./agent-hooks-DpklSWZg.js";
+import { A as forkConversationBodySchema, F as INPUT_IMAGE_TYPES, O as createConversationBodySchema, P as readMessageAttachments, T as conversationStatsReportSchema, _ as conversationParamsSchema, a as cancelConversationPendingMessagesBodySchema, c as conversationAttachmentParamsSchema, d as conversationDetailReportSchema, g as conversationFeedSchema, h as conversationFeedQuerySchema, i as archiveConversationResponseSchema, j as forkConversationResponseSchema, k as createConversationMessageBodySchema, m as conversationEventsQuerySchema, o as cancelConversationPendingMessagesResponseSchema, p as conversationEventPageSchema, r as archiveConversationBodySchema, t as acceptedConversationMessageSchema, u as conversationDetailQuerySchema, x as conversationPendingMessagesReportSchema } from "./conversation-CvBG57Io.js";
+import { n as hash, t as create } from "./profile-BevMNSlr.js";
 import { t as getFirstRunAtMs } from "./cadence-D00SCzT1.js";
-import { t as getCachedSnapshot } from "./resolve-4u5gEU04.js";
-import { a as getVercelConversationWorkQueue } from "./job-queue-mVyF9jgv.js";
+import { t as getCachedSnapshot } from "./resolve-qPhrznTf.js";
+import { a as getVercelConversationWorkQueue } from "./job-queue-Cz3M7gg4.js";
 import { M as compileScheduleIntent, P as weekdaySchema, _ as automationSummarySchema, b as automationVersionListSchema, c as automationLifecycleSchema, d as automationParamsSchema, f as automationRunListSchema, g as automationSchedulePreviewSchema, h as automationScheduleIntentSchema, i as automationExecutionListSchema, j as ScheduleIntentError, l as automationListQuerySchema, n as automationEditSchema, r as automationEventCatalogSchema, t as automationEditErrorSchema, u as automationListSchema, v as automationUpdateSchema, x as automationVersionParamsSchema, y as automationVersionActivateSchema } from "./automation-gznOMaQ2.js";
 import { C as skillReportsSchema, a as fillUtcHours, b as pluginsSchema, c as sumUtcHoursIntoSixHours, d as trailingUtcSixHourWindow, f as utcDayKey, h as pluginOperationalReportFeedSchema, i as fillUtcDays, l as trailingUtcDayWindow, m as healthReportSchema, n as DAY_MS$1, o as fillUtcSixHours, p as utcHourKey, r as HOUR_MS$1, s as startOfUtcHour, u as trailingUtcHourWindow, x as runtimeInfoReportSchema } from "./web-message-id-xPI_EFSC.js";
-import { H as readHealthReport, L as createVercelAttachmentStorage, M as legacyWebMailboxMetadataSchema, _ as readViewerAutomationRuns, a as recordWebConversationActivity, b as readViewerAutomations, d as resolveSlackConversationContextFromThreadId, g as readViewerAutomationExecutions, h as readConversationSourceTask, i as createConversationId, l as getProductionSlackAdapter, m as deleteViewerTask, o as webActorFromEmail, p as ViewerTaskNotFoundError, r as createAndEnqueueConversation, t as appendAndEnqueueWebMessage, u as formatSlackConversationRedactedLabel, v as readViewerAutomationSummary, w as clearSlackPendingReactions, x as resolveViewerTaskCandidate, y as readViewerAutomationVersions } from "./web-input-CIsRGF07.js";
-import { A as conversationActiveDaysColumn, M as conversationRangeColumns, j as conversationAggregateColumns } from "./task-runner-D4jvUpFV.js";
-import { r as getWebAuthorization } from "./web-authorization-CTltRLsB.js";
-import { t as decodeInputImages } from "./images-CvMreau5.js";
-import { C as locationParamsSchema, E as activitySixHours$1, L as conversationChildAgentsReportSchema, M as codePersonReportSchema, N as codeRepositoryParamsSchema, P as codeRepositoryReportSchema, R as apiErrorSchema, S as locationDirectoryReportSchema, T as activityHours$1, _ as actorProfileReportSchema, a as workspaceBodySchema, d as createdPersonalTokenSchema, f as personalTokenListSchema, g as actorDirectoryReportSchema, h as revokePersonalTokenResponseSchema, i as deleteWorkspaceResponseSchema, j as codeOverviewReportSchema, l as workspaceSchema, m as personalTokenParamsSchema, n as statsReportSchema, o as workspaceListSchema, s as workspaceParamsSchema, u as createPersonalTokenBodySchema, v as personParamsSchema, w as activityDays$1, x as locationDetailReportSchema, y as personalSpendReportSchema } from "./schema-Dyyi9oRc.js";
+import { H as readHealthReport, N as legacyWebMailboxMetadataSchema, R as createVercelAttachmentStorage, _ as readViewerAutomationRuns, a as recordWebConversationActivity, b as readViewerAutomations, d as resolveSlackConversationContextFromThreadId, g as readViewerAutomationExecutions, h as readConversationSourceTask, i as createConversationId, j as stopConversationTurn, l as getProductionSlackAdapter, m as deleteViewerTask, o as webActorFromEmail, p as ViewerTaskNotFoundError, r as createAndEnqueueConversation, t as appendAndEnqueueWebMessage, u as formatSlackConversationRedactedLabel, v as readViewerAutomationSummary, w as clearSlackPendingReactions, x as resolveViewerTaskCandidate, y as readViewerAutomationVersions } from "./web-input-0sorYVLh.js";
+import { A as conversationActiveDaysColumn, M as conversationRangeColumns, j as conversationAggregateColumns } from "./task-runner-T51kll0U.js";
+import { r as getWebAuthorization } from "./web-authorization-DCxixz5S.js";
+import { t as decodeInputImages } from "./images-DZliDtSH.js";
+import { C as locationParamsSchema, E as activitySixHours$1, L as conversationChildAgentsReportSchema, M as codePersonReportSchema, N as codeRepositoryParamsSchema, P as codeRepositoryReportSchema, R as stopConversationTurnResponseSchema, S as locationDirectoryReportSchema, T as activityHours$1, _ as actorProfileReportSchema, a as workspaceBodySchema, d as createdPersonalTokenSchema, f as personalTokenListSchema, g as actorDirectoryReportSchema, h as revokePersonalTokenResponseSchema, i as deleteWorkspaceResponseSchema, j as codeOverviewReportSchema, l as workspaceSchema, m as personalTokenParamsSchema, n as statsReportSchema, o as workspaceListSchema, s as workspaceParamsSchema, u as createPersonalTokenBodySchema, v as personParamsSchema, w as activityDays$1, x as locationDetailReportSchema, y as personalSpendReportSchema, z as apiErrorSchema } from "./schema-BWMRg8JS.js";
 import { Hono } from "hono";
 import path from "node:path";
 import { z } from "zod";
@@ -131,26 +131,256 @@ async function archiveConversation(viewer, conversationId, body) {
 	throwApiError(409, "Conversation received new activity.");
 }
 //#endregion
+//#region src/chat/conversations/fork.ts
+/** Event key of the agent note that follows the copied events in a fork. */
+const FORK_NOTE_KEY = "fork:note";
+const forkNote = alias(juniorConversationEvents, "fork_note");
+/**
+* SQL filter for event rows that a fork did not copy from its source. Usage
+* and cost reports use it, so copied model calls count only in the source.
+*/
+function notCopiedByFork() {
+	return sql`not exists (
+    select 1 from ${juniorConversationEvents} as ${sql.identifier("fork_note")}
+    where ${forkNote.conversationId} = ${juniorConversationEvents.conversationId}
+      and ${forkNote.idempotencyKey} = ${FORK_NOTE_KEY}
+      and ${forkNote.seq} > ${juniorConversationEvents.seq}
+  )`;
+}
+/**
+* Events that hold credentials, approvals, provider connections, or plugin
+* state of the source actor. A fork does not copy them.
+*/
+const UNCOPIED_EVENT_TYPES = /* @__PURE__ */ new Set([
+	"authorization_completed",
+	"authorization_requested",
+	"guardian_action_reviewed",
+	"mcp_provider_connected",
+	"mcp_provider_connected_unowned",
+	"structured_event",
+	"unknown"
+]);
+const FORK_NOTE = "This Conversation is a fork. The earlier messages are copied from another Conversation. Sandbox files, active work, approvals, credentials, Watches, Automations, and the delivery location were not copied. Earlier file paths and runtime context belong to the source Conversation. Verify files in the current Sandbox before you use them.";
+/** An expected fork request failure, such as a reply without saved history. */
+var ConversationForkError = class extends Error {};
+/**
+* Create a new web root Conversation from the agent history of a source
+* Conversation, through one completed assistant reply.
+*
+* Retries with the same requester and key return the same Conversation.
+*/
+async function forkConversation(input) {
+	const conversationId = createConversationId({
+		actorEmail: input.actorEmail,
+		idempotencyKey: JSON.stringify([
+			"fork",
+			input.sourceConversationId,
+			input.idempotencyKey
+		])
+	});
+	const executor = getSqlExecutor();
+	const events = getConversationEventStore();
+	const store = getConversationStore();
+	return withConversationEventLock(executor, input.sourceConversationId, () => withConversationEventLock(executor, conversationId, async () => {
+		if (await store.get({ conversationId })) return { conversationId };
+		const source = await store.get({ conversationId: input.sourceConversationId });
+		if (!source || source.transcriptPurgedAtMs !== void 0) throw new ConversationForkError("The source history is no longer available.");
+		if (source.parentConversationId) throw new ConversationForkError("You cannot fork a child conversation.");
+		const boundary = await events.loadByIdempotencyKey(input.sourceConversationId, `message:${input.messageId}:agent`);
+		const reply = boundary?.data.type === "assistant_message" ? piMessageFromHistoryItem(boundary.data) : void 0;
+		if (!boundary || reply?.role !== "assistant" || reply.stopReason !== "stop" || reply.content.some((part) => part.type === "toolCall")) throw new ConversationForkError("Choose a completed assistant reply with saved agent history.");
+		const projection = await loadTurnProjection({
+			conversationId: input.sourceConversationId,
+			committedSeq: boundary.seq,
+			includeTail: false
+		});
+		if (!projection?.messages.length) throw new ConversationForkError("The selected history is no longer available.");
+		if (hasUnfinishedToolCalls(projection.messages)) throw new ConversationForkError("This history has unfinished tool calls. Choose another reply.");
+		const nowMs = Date.now();
+		await recordWebConversationActivity({
+			actor: webActorFromEmail(input.actorEmail, { ...input.actorName ? { fullName: input.actorName } : void 0 }),
+			conversationId,
+			nowMs,
+			rootVisibility: source.visibility === "public" ? "public" : "private"
+		});
+		await executor.db().update(juniorConversations).set({
+			forkedFromConversationId: source.conversationId,
+			title: source.title ? `Fork: ${source.title}` : "Forked conversation"
+		}).where(eq(juniorConversations.conversationId, conversationId));
+		await copyForkEvents({
+			sourceConversationId: source.conversationId,
+			conversationId,
+			events: await events.loadHistory(source.conversationId),
+			boundarySeq: boundary.seq,
+			messageId: input.messageId
+		});
+		await events.append(conversationId, [{
+			idempotencyKey: FORK_NOTE_KEY,
+			createdAtMs: nowMs,
+			data: {
+				type: "user_message",
+				provenance: contextProvenance,
+				content: [{
+					type: "text",
+					text: FORK_NOTE
+				}],
+				timestamp: nowMs
+			}
+		}]);
+		return { conversationId };
+	}));
+}
+/**
+* Copy the source event rows through the selected reply. Copies keep their
+* sequence, author, timestamp, key, and payload, so the fork shows the same
+* transcript and event log, and seq references in compactions stay valid.
+* Later updates of copied Messages and the end of copied Turns are also
+* copied, so that no copied item stays open in the fork.
+*/
+async function copyForkEvents(args) {
+	const reply = args.events.find((event) => event.data.type === "message" && event.data.role === "assistant" && event.data.messageId === args.messageId);
+	const cutoffSeq = Math.max(args.boundarySeq, reply?.seq ?? -1);
+	const messageIds = /* @__PURE__ */ new Set();
+	const turnIds = /* @__PURE__ */ new Set();
+	const seqs = [];
+	let historyVersion = 0;
+	for (const event of args.events) {
+		const data = event.data;
+		if (UNCOPIED_EVENT_TYPES.has(data.type)) continue;
+		if (event.idempotencyKey === FORK_NOTE_KEY) continue;
+		if (event.seq <= cutoffSeq) {
+			if (data.type === "message") messageIds.add(data.messageId);
+			if (data.type === "turn_started") turnIds.add(data.turnId);
+			historyVersion = Math.max(historyVersion, event.historyVersion);
+			seqs.push(event.seq);
+		} else if ((data.type === "message_updated" || data.type === "message_handled") && messageIds.has(data.messageId) || (data.type === "turn_completed" || data.type === "turn_failed") && turnIds.has(data.turnId)) seqs.push(event.seq);
+	}
+	if (!seqs.length) return;
+	const e = juniorConversationEvents;
+	await getSqlExecutor().db().execute(sql`insert into ${e} (${sql.join([
+		e.conversationId,
+		e.seq,
+		e.historyVersion,
+		e.schemaVersion,
+		e.idempotencyKey,
+		e.type,
+		e.payload,
+		e.actorIdentityId,
+		e.createdAt
+	].map((column) => sql.identifier(column.name)), sql`, `)})
+      select ${args.conversationId}, ${e.seq}, least(${e.historyVersion}, ${historyVersion}), ${e.schemaVersion}, ${e.idempotencyKey}, ${e.type}, ${e.payload}, ${e.actorIdentityId}, ${e.createdAt}
+      from ${e}
+      where ${e.conversationId} = ${args.sourceConversationId}
+        and ${inArray(e.seq, seqs)}`);
+}
+function hasUnfinishedToolCalls(messages) {
+	const pending = /* @__PURE__ */ new Set();
+	for (const message of messages) if (message.role === "assistant") {
+		for (const part of message.content) if (part.type === "toolCall") pending.add(part.id);
+	} else if (message.role === "toolResult") pending.delete(message.toolCallId);
+	return pending.size > 0;
+}
+//#endregion
+//#region src/api/conversations/auxiliary-costs.ts
+const auxiliaryRootConversation = alias(juniorConversations, "auxiliary_root_conversation");
+function eventCost() {
+	return sql`CASE
+    WHEN ${juniorConversationEvents.type} = 'structured_event'
+      AND jsonb_typeof(${juniorConversationEvents.payload}->'content'->'costUsd') = 'number'
+      THEN (${juniorConversationEvents.payload}->'content'->>'costUsd')::numeric
+    WHEN ${juniorConversationEvents.type} IN ('guardian_action_reviewed', 'turn_routed')
+      AND jsonb_typeof(${juniorConversationEvents.payload}->'costUsd') = 'number'
+      THEN (${juniorConversationEvents.payload}->>'costUsd')::numeric
+    ELSE NULL
+  END`;
+}
+/** Aggregate additive event costs by namespaced operation for conversations. */
+async function readConversationAuxiliaryCostsFromSql(db, conversationIds, options) {
+	if (conversationIds.length === 0) return /* @__PURE__ */ new Map();
+	const selectedIds = [...conversationIds];
+	const conversationId = options.includeDescendants ? sql`coalesce(
+        ${auxiliaryRootConversation.conversationId},
+        ${juniorConversations.conversationId}
+      )` : sql`${juniorConversations.conversationId}`;
+	const namespace = sql`CASE
+    WHEN ${juniorConversationEvents.type} = 'structured_event'
+      THEN ${juniorConversationEvents.payload}->>'namespace'
+    ELSE 'junior'
+  END`;
+	const name = sql`CASE
+    WHEN ${juniorConversationEvents.type} = 'structured_event'
+      THEN ${juniorConversationEvents.payload}->>'name'
+    ELSE ${juniorConversationEvents.type}
+  END`;
+	const cost = eventCost();
+	const selectedConversation = options.includeDescendants ? or(and(inArray(juniorConversations.rootConversationId, selectedIds), isNotNull(auxiliaryRootConversation.conversationId)), inArray(juniorConversations.conversationId, selectedIds)) : inArray(juniorConversations.conversationId, selectedIds);
+	const rows = await db.select({
+		conversationId,
+		costUsd: sql`round(sum(${cost}), 12)::double precision`.mapWith(Number),
+		events: sql`count(*)::integer`.mapWith(Number),
+		name,
+		namespace
+	}).from(juniorConversationEvents).innerJoin(juniorConversations, eq(juniorConversations.conversationId, juniorConversationEvents.conversationId)).leftJoin(auxiliaryRootConversation, and(eq(auxiliaryRootConversation.conversationId, juniorConversations.rootConversationId), isNull(auxiliaryRootConversation.parentConversationId), eq(auxiliaryRootConversation.rootConversationId, auxiliaryRootConversation.conversationId))).where(and(selectedConversation, or(eq(juniorConversationEvents.type, "structured_event"), inArray(juniorConversationEvents.type, ["guardian_action_reviewed", "turn_routed"])), sql`${cost} >= 0`, notCopiedByFork())).groupBy(conversationId, namespace, name).orderBy(conversationId, namespace, name);
+	const result = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const current = result.get(row.conversationId) ?? {
+			costUsd: 0,
+			operations: []
+		};
+		current.costUsd = Math.round((current.costUsd + row.costUsd) * 0xe8d4a51000) / 0xe8d4a51000;
+		current.operations.push({
+			costUsd: row.costUsd,
+			events: row.events,
+			name: row.name,
+			namespace: row.namespace
+		});
+		result.set(row.conversationId, current);
+	}
+	return result;
+}
+//#endregion
 //#region src/api/conversations/child-agents.ts
+/** Read the runtime and usage saved on each child Conversation row. */
+async function readChildConversationMetrics(db, conversationIds) {
+	const rows = conversationIds.length === 0 ? [] : await db.select({
+		conversationId: juniorConversations.conversationId,
+		durationMs: juniorConversations.durationMs,
+		usage: juniorConversations.usage
+	}).from(juniorConversations).where(inArray(juniorConversations.conversationId, [...conversationIds]));
+	return new Map(rows.map((row) => [row.conversationId, {
+		cumulativeDurationMs: row.durationMs,
+		...row.usage ? { cumulativeUsage: row.usage } : void 0
+	}]));
+}
 /**
 * Load the direct child agents of one Conversation, or throw a standard API
-* not-found error. Viewers who cannot see private content get only the status
-* and time of each child agent.
+* not-found error. Viewers who cannot see private content get only the status,
+* time, and usage of each child agent.
 */
 async function requireConversationChildAgents(conversationId, options = {}) {
 	if (!await getConversationStore().get({ conversationId })) throwApiError(404, "Conversation not found.");
-	const canExposePayload = (await readConversationAccessFromSql(getDb(), [conversationId], options.viewer)).get(conversationId)?.canViewPrivateContent ?? false;
-	const agents = (await listChildAgents(conversationId)).map((agent) => ({
-		conversationId: agent.childConversationId,
-		status: agent.status,
-		updatedAt: new Date(agent.updatedAtMs).toISOString(),
-		...canExposePayload ? {
-			...agent.agentName ? { name: agent.agentName } : void 0,
-			task: agent.task,
-			...agent.title ? { title: agent.title } : void 0,
-			...agent.errorMessage ? { error: agent.errorMessage } : void 0
-		} : { redacted: true }
-	}));
+	const db = getDb();
+	const [accessByConversation, children] = await Promise.all([readConversationAccessFromSql(db, [conversationId], options.viewer), listChildAgents(conversationId)]);
+	const canExposePayload = accessByConversation.get(conversationId)?.canViewPrivateContent ?? false;
+	const childIds = children.map((agent) => agent.childConversationId);
+	const [metricsByChild, auxiliaryCostsByChild] = await Promise.all([readChildConversationMetrics(db, childIds), readConversationAuxiliaryCostsFromSql(db, childIds, { includeDescendants: false })]);
+	const agents = children.map((agent) => {
+		const auxiliaryCosts = auxiliaryCostsByChild.get(agent.childConversationId);
+		return {
+			conversationId: agent.childConversationId,
+			cumulativeDurationMs: 0,
+			...metricsByChild.get(agent.childConversationId),
+			...auxiliaryCosts ? { auxiliaryCosts } : void 0,
+			status: agent.status,
+			updatedAt: new Date(agent.updatedAtMs).toISOString(),
+			...canExposePayload ? {
+				...agent.agentName ? { name: agent.agentName } : void 0,
+				task: agent.task,
+				...agent.title ? { title: agent.title } : void 0,
+				...agent.errorMessage ? { error: agent.errorMessage } : void 0
+			} : { redacted: true }
+		};
+	});
 	return conversationChildAgentsReportSchema.parse({
 		agents,
 		conversationId
@@ -409,156 +639,6 @@ async function resolveSlackTeamDomains(teamIds) {
 	return new Map(resolved.filter((entry) => entry !== void 0));
 }
 //#endregion
-//#region src/chat/conversations/fork.ts
-/** Event key of the agent note that follows the copied events in a fork. */
-const FORK_NOTE_KEY = "fork:note";
-const forkNote = alias(juniorConversationEvents, "fork_note");
-/**
-* SQL filter for event rows that a fork did not copy from its source. Usage
-* and cost reports use it, so copied model calls count only in the source.
-*/
-function notCopiedByFork() {
-	return sql`not exists (
-    select 1 from ${juniorConversationEvents} as ${sql.identifier("fork_note")}
-    where ${forkNote.conversationId} = ${juniorConversationEvents.conversationId}
-      and ${forkNote.idempotencyKey} = ${FORK_NOTE_KEY}
-      and ${forkNote.seq} > ${juniorConversationEvents.seq}
-  )`;
-}
-/**
-* Events that hold credentials, approvals, provider connections, or plugin
-* state of the source actor. A fork does not copy them.
-*/
-const UNCOPIED_EVENT_TYPES = /* @__PURE__ */ new Set([
-	"authorization_completed",
-	"authorization_requested",
-	"guardian_action_reviewed",
-	"mcp_provider_connected",
-	"mcp_provider_connected_unowned",
-	"structured_event",
-	"unknown"
-]);
-const FORK_NOTE = "This Conversation is a fork. The earlier messages are copied from another Conversation. Sandbox files, active work, approvals, credentials, Watches, Automations, and the delivery location were not copied. Earlier file paths and runtime context belong to the source Conversation. Verify files in the current Sandbox before you use them.";
-/** An expected fork request failure, such as a reply without saved history. */
-var ConversationForkError = class extends Error {};
-/**
-* Create a new web root Conversation from the agent history of a source
-* Conversation, through one completed assistant reply.
-*
-* Retries with the same requester and key return the same Conversation.
-*/
-async function forkConversation(input) {
-	const conversationId = createConversationId({
-		actorEmail: input.actorEmail,
-		idempotencyKey: JSON.stringify([
-			"fork",
-			input.sourceConversationId,
-			input.idempotencyKey
-		])
-	});
-	const executor = getSqlExecutor();
-	const events = getConversationEventStore();
-	const store = getConversationStore();
-	return withConversationEventLock(executor, input.sourceConversationId, () => withConversationEventLock(executor, conversationId, async () => {
-		if (await store.get({ conversationId })) return { conversationId };
-		const source = await store.get({ conversationId: input.sourceConversationId });
-		if (!source || source.transcriptPurgedAtMs !== void 0) throw new ConversationForkError("The source history is no longer available.");
-		if (source.parentConversationId) throw new ConversationForkError("You cannot fork a child conversation.");
-		const boundary = await events.loadByIdempotencyKey(input.sourceConversationId, `message:${input.messageId}:agent`);
-		const reply = boundary?.data.type === "assistant_message" ? piMessageFromHistoryItem(boundary.data) : void 0;
-		if (!boundary || reply?.role !== "assistant" || reply.stopReason !== "stop" || reply.content.some((part) => part.type === "toolCall")) throw new ConversationForkError("Choose a completed assistant reply with saved agent history.");
-		const projection = await loadTurnProjection({
-			conversationId: input.sourceConversationId,
-			committedSeq: boundary.seq,
-			includeTail: false
-		});
-		if (!projection?.messages.length) throw new ConversationForkError("The selected history is no longer available.");
-		if (hasUnfinishedToolCalls(projection.messages)) throw new ConversationForkError("This history has unfinished tool calls. Choose another reply.");
-		const nowMs = Date.now();
-		await recordWebConversationActivity({
-			actor: webActorFromEmail(input.actorEmail, { ...input.actorName ? { fullName: input.actorName } : void 0 }),
-			conversationId,
-			nowMs,
-			rootVisibility: source.visibility === "public" ? "public" : "private"
-		});
-		await executor.db().update(juniorConversations).set({
-			forkedFromConversationId: source.conversationId,
-			title: source.title ? `Fork: ${source.title}` : "Forked conversation"
-		}).where(eq(juniorConversations.conversationId, conversationId));
-		await copyForkEvents({
-			sourceConversationId: source.conversationId,
-			conversationId,
-			events: await events.loadHistory(source.conversationId),
-			boundarySeq: boundary.seq,
-			messageId: input.messageId
-		});
-		await events.append(conversationId, [{
-			idempotencyKey: FORK_NOTE_KEY,
-			createdAtMs: nowMs,
-			data: {
-				type: "user_message",
-				provenance: contextProvenance,
-				content: [{
-					type: "text",
-					text: FORK_NOTE
-				}],
-				timestamp: nowMs
-			}
-		}]);
-		return { conversationId };
-	}));
-}
-/**
-* Copy the source event rows through the selected reply. Copies keep their
-* sequence, author, timestamp, key, and payload, so the fork shows the same
-* transcript and event log, and seq references in compactions stay valid.
-* Later updates of copied Messages and the end of copied Turns are also
-* copied, so that no copied item stays open in the fork.
-*/
-async function copyForkEvents(args) {
-	const reply = args.events.find((event) => event.data.type === "message" && event.data.role === "assistant" && event.data.messageId === args.messageId);
-	const cutoffSeq = Math.max(args.boundarySeq, reply?.seq ?? -1);
-	const messageIds = /* @__PURE__ */ new Set();
-	const turnIds = /* @__PURE__ */ new Set();
-	const seqs = [];
-	let historyVersion = 0;
-	for (const event of args.events) {
-		const data = event.data;
-		if (UNCOPIED_EVENT_TYPES.has(data.type)) continue;
-		if (event.idempotencyKey === FORK_NOTE_KEY) continue;
-		if (event.seq <= cutoffSeq) {
-			if (data.type === "message") messageIds.add(data.messageId);
-			if (data.type === "turn_started") turnIds.add(data.turnId);
-			historyVersion = Math.max(historyVersion, event.historyVersion);
-			seqs.push(event.seq);
-		} else if ((data.type === "message_updated" || data.type === "message_handled") && messageIds.has(data.messageId) || (data.type === "turn_completed" || data.type === "turn_failed") && turnIds.has(data.turnId)) seqs.push(event.seq);
-	}
-	if (!seqs.length) return;
-	const e = juniorConversationEvents;
-	await getSqlExecutor().db().execute(sql`insert into ${e} (${sql.join([
-		e.conversationId,
-		e.seq,
-		e.historyVersion,
-		e.schemaVersion,
-		e.idempotencyKey,
-		e.type,
-		e.payload,
-		e.actorIdentityId,
-		e.createdAt
-	].map((column) => sql.identifier(column.name)), sql`, `)})
-      select ${args.conversationId}, ${e.seq}, least(${e.historyVersion}, ${historyVersion}), ${e.schemaVersion}, ${e.idempotencyKey}, ${e.type}, ${e.payload}, ${e.actorIdentityId}, ${e.createdAt}
-      from ${e}
-      where ${e.conversationId} = ${args.sourceConversationId}
-        and ${inArray(e.seq, seqs)}`);
-}
-function hasUnfinishedToolCalls(messages) {
-	const pending = /* @__PURE__ */ new Set();
-	for (const message of messages) if (message.role === "assistant") {
-		for (const part of message.content) if (part.type === "toolCall") pending.add(part.id);
-	} else if (message.role === "toolResult") pending.delete(message.toolCallId);
-	return pending.size > 0;
-}
-//#endregion
 //#region src/chat/pi/sql-model-usage.ts
 /** SQL reporting adapter for usage stored on assistant history events. */
 const message = sql`${juniorConversationEvents.payload}`;
@@ -935,64 +1015,6 @@ async function readRootConversationMetricsFromSql(db, rootConversationIds) {
 	}));
 }
 //#endregion
-//#region src/api/conversations/auxiliary-costs.ts
-const auxiliaryRootConversation = alias(juniorConversations, "auxiliary_root_conversation");
-function eventCost() {
-	return sql`CASE
-    WHEN ${juniorConversationEvents.type} = 'structured_event'
-      AND jsonb_typeof(${juniorConversationEvents.payload}->'content'->'costUsd') = 'number'
-      THEN (${juniorConversationEvents.payload}->'content'->>'costUsd')::numeric
-    WHEN ${juniorConversationEvents.type} IN ('guardian_action_reviewed', 'turn_routed')
-      AND jsonb_typeof(${juniorConversationEvents.payload}->'costUsd') = 'number'
-      THEN (${juniorConversationEvents.payload}->>'costUsd')::numeric
-    ELSE NULL
-  END`;
-}
-/** Aggregate additive event costs by namespaced operation for conversations. */
-async function readConversationAuxiliaryCostsFromSql(db, conversationIds, options) {
-	if (conversationIds.length === 0) return /* @__PURE__ */ new Map();
-	const selectedIds = [...conversationIds];
-	const conversationId = options.includeDescendants ? sql`coalesce(
-        ${auxiliaryRootConversation.conversationId},
-        ${juniorConversations.conversationId}
-      )` : sql`${juniorConversations.conversationId}`;
-	const namespace = sql`CASE
-    WHEN ${juniorConversationEvents.type} = 'structured_event'
-      THEN ${juniorConversationEvents.payload}->>'namespace'
-    ELSE 'junior'
-  END`;
-	const name = sql`CASE
-    WHEN ${juniorConversationEvents.type} = 'structured_event'
-      THEN ${juniorConversationEvents.payload}->>'name'
-    ELSE ${juniorConversationEvents.type}
-  END`;
-	const cost = eventCost();
-	const selectedConversation = options.includeDescendants ? or(and(inArray(juniorConversations.rootConversationId, selectedIds), isNotNull(auxiliaryRootConversation.conversationId)), inArray(juniorConversations.conversationId, selectedIds)) : inArray(juniorConversations.conversationId, selectedIds);
-	const rows = await db.select({
-		conversationId,
-		costUsd: sql`round(sum(${cost}), 12)::double precision`.mapWith(Number),
-		events: sql`count(*)::integer`.mapWith(Number),
-		name,
-		namespace
-	}).from(juniorConversationEvents).innerJoin(juniorConversations, eq(juniorConversations.conversationId, juniorConversationEvents.conversationId)).leftJoin(auxiliaryRootConversation, and(eq(auxiliaryRootConversation.conversationId, juniorConversations.rootConversationId), isNull(auxiliaryRootConversation.parentConversationId), eq(auxiliaryRootConversation.rootConversationId, auxiliaryRootConversation.conversationId))).where(and(selectedConversation, or(eq(juniorConversationEvents.type, "structured_event"), inArray(juniorConversationEvents.type, ["guardian_action_reviewed", "turn_routed"])), sql`${cost} >= 0`, notCopiedByFork())).groupBy(conversationId, namespace, name).orderBy(conversationId, namespace, name);
-	const result = /* @__PURE__ */ new Map();
-	for (const row of rows) {
-		const current = result.get(row.conversationId) ?? {
-			costUsd: 0,
-			operations: []
-		};
-		current.costUsd = Math.round((current.costUsd + row.costUsd) * 0xe8d4a51000) / 0xe8d4a51000;
-		current.operations.push({
-			costUsd: row.costUsd,
-			events: row.events,
-			name: row.name,
-			namespace: row.namespace
-		});
-		result.set(row.conversationId, current);
-	}
-	return result;
-}
-//#endregion
 //#region src/chat/plugins/unfinished-work.ts
 /**
 * Return assigned and unfinished plugin work for the candidate conversations.
@@ -1425,6 +1447,52 @@ async function readConversationForks(conversationId, viewer) {
 	return result;
 }
 //#endregion
+//#region src/api/conversations/agent-tree.ts
+/** Bound the parent chain that one agent tree reads. */
+const MAX_AGENT_TREE_DEPTH = 16;
+const CHILD_LABEL = "Subagent";
+async function readParentConversationId(conversationId) {
+	const [row] = await getDb().select({ parentId: juniorConversations.parentConversationId }).from(juniorConversations).where(eq(juniorConversations.conversationId, conversationId));
+	return row?.parentId ?? void 0;
+}
+/**
+* Read the agent tree of a child Conversation: its parent chain, root first,
+* with the child last. Returns undefined for a root Conversation. Each
+* Conversation has its own access check, so a viewer sees a label only where
+* they can see private content.
+*/
+async function readConversationAgentTree(conversationId, viewer) {
+	const ids = [conversationId];
+	let parentId = await readParentConversationId(conversationId);
+	while (parentId && !ids.includes(parentId) && ids.length < MAX_AGENT_TREE_DEPTH) {
+		ids.unshift(parentId);
+		parentId = await readParentConversationId(parentId);
+	}
+	if (ids.length < 2) return;
+	const root = parentId ? void 0 : await getConversationStore().get({ conversationId: ids[0] });
+	const access = await readConversationAccessFromSql(getDb(), ids, viewer);
+	return await Promise.all(ids.map(async (id) => {
+		const itemAccess = access.get(id);
+		if (root?.conversationId === id) return {
+			conversationId: id,
+			label: conversationSummaryFromStoredConversation({
+				access: itemAccess,
+				conversation: root,
+				durationMs: 0
+			}).displayTitle
+		};
+		if (!itemAccess?.canViewPrivateContent) return {
+			conversationId: id,
+			label: CHILD_LABEL
+		};
+		const agent = await getChildAgentLabel(id);
+		return {
+			conversationId: id,
+			label: agent?.title ?? agent?.agentName ?? CHILD_LABEL
+		};
+	}));
+}
+//#endregion
 //#region src/api/conversations/detail.ts
 /** Project stored metadata and a bounded event page into a signed history cursor. */
 function projectConversationDetail(args) {
@@ -1524,10 +1592,11 @@ async function readConversationDetail(conversationId, options = {}) {
 		limit: options.limit ?? 500
 	});
 	if (!report) return void 0;
-	const forks = await readConversationForks(conversationId, options.viewer);
+	const [forks, agentTree] = await Promise.all([readConversationForks(conversationId, options.viewer), readConversationAgentTree(conversationId, options.viewer)]);
 	return conversationDetailReportSchema.parse({
 		...report,
-		...forks
+		...forks,
+		...agentTree ? { agentTree } : void 0
 	});
 }
 //#endregion
@@ -2073,6 +2142,59 @@ async function readConversationStats() {
 	return conversationStatsReportSchema.parse(await readConversationStatsFromSql());
 }
 //#endregion
+//#region src/api/conversations/stop.ts
+/**
+* Stop the active Turn for one conversation participant.
+*
+* The stop also removes the human messages queued before it. The viewer's own
+* web text comes back in the response so the dashboard can restore it to the
+* composer instead of losing it.
+*/
+async function stopConversationTurnForViewer(viewer, conversationId, services) {
+	const conversationStore = getConversationStore();
+	if (!await conversationStore.get({ conversationId })) throwApiError(404, "Conversation not found.");
+	if (!(await readConversationAccessFromSql(getDb(), [conversationId], viewer)).get(conversationId)?.isParticipant) throwApiError(403, "Only conversation participants can stop this turn.");
+	try {
+		const result = await stopConversationTurn({
+			conversationId,
+			conversationStore,
+			queue: services.queue
+		});
+		if (result.status === "no_work") return {
+			conversationId,
+			status: "no_work",
+			stoppedInboundMessageIds: [],
+			stoppedMessages: []
+		};
+		await clearSlackPendingReactions({
+			getSlackAdapter: getProductionSlackAdapter,
+			messages: result.pendingMessages
+		});
+		return {
+			conversationId,
+			status: "requested",
+			stoppedInboundMessageIds: result.pendingMessages.map((message) => message.inboundMessageId),
+			stoppedMessages: viewerWebMessages(result.pendingMessages, viewer)
+		};
+	} catch (error) {
+		throwApiError(500, "Unable to stop the active turn.", error);
+	}
+}
+function viewerWebMessages(messages, viewer) {
+	const viewerUserId = webActorFromEmail(viewer.email).userId;
+	return messages.flatMap((message) => {
+		if (message.source !== "web") return [];
+		const metadata = legacyWebMailboxMetadataSchema.safeParse(message.input.metadata);
+		if (!metadata.success) return [];
+		if (metadata.data.authorUserId !== viewerUserId) return [];
+		const text = message.input.text.trim();
+		return text ? [{
+			inboundMessageId: message.inboundMessageId,
+			text
+		}] : [];
+	});
+}
+//#endregion
 //#region src/api/conversations/routes.ts
 /** Create the HTTP routes owned by the conversations API. */
 function createConversationRoutes(options) {
@@ -2106,6 +2228,11 @@ function createConversationRoutes(options) {
 		const body = context.req.valid("json");
 		return jsonResponse(acceptedConversationMessageSchema, await appendConversationMessageForViewer(viewer, conversationId, body, options));
 	});
+	app.post("/:conversationId/stop", requireViewer, validateRequest("param", conversationParamsSchema, "Invalid route parameters."), async (context) => {
+		const viewer = context.get("viewer");
+		const { conversationId } = context.req.valid("param");
+		return jsonResponse(stopConversationTurnResponseSchema, await stopConversationTurnForViewer(viewer, conversationId, options));
+	});
 	app.post("/:conversationId/forks", requireViewer, bodyLimit({ maxSize: 4096 }), validateRequest("param", conversationParamsSchema, "Invalid route parameters."), validateRequest("json", forkConversationBodySchema, "Invalid request body."), async (context) => jsonResponse(forkConversationResponseSchema, await forkConversationForViewer(context.get("viewer"), context.req.valid("param").conversationId, context.req.valid("json"))));
 	app.patch("/:conversationId/archive", requireViewer, validateRequest("param", conversationParamsSchema, "Invalid route parameters."), validateRequest("json", archiveConversationBodySchema, "Invalid request body."), async (context) => {
 		const viewer = context.get("viewer");
@@ -3388,7 +3515,7 @@ async function readPeoplePluginReports(args) {
 		reports: [],
 		source: "plugins"
 	});
-	const { getPluginProfileReports } = await import("./agent-hooks-Cj_rSeWd.js").then((n) => n.t);
+	const { getPluginProfileReports } = await import("./agent-hooks-DpklSWZg.js").then((n) => n.t);
 	return pluginOperationalReportFeedSchema.parse({
 		generatedAt: new Date(nowMs).toISOString(),
 		reports: await getPluginProfileReports({
@@ -4083,7 +4210,7 @@ async function changeViewerAutomationLifecycle(user, kind, id, input) {
 /** Read-only editor support. Core owns schedules; plugins own Event choices. */
 /** Return only Event types that can start a durable Automation. */
 function readAutomationEventCatalog() {
-	return Object.entries(pluginEventCatalog(getEventCatalog())).flatMap(([namespace, registration]) => registration.resourceTypes.map((resource) => ({
+	return Object.entries(automationEventCatalog(getEventCatalog())).flatMap(([namespace, registration]) => registration.resourceTypes.map((resource) => ({
 		namespace,
 		...resource
 	})));
@@ -4356,7 +4483,7 @@ function readDescriptionText(home) {
 }
 /** Read discovered skill names for authenticated runtime diagnostics. */
 async function readSkillReports() {
-	const { discoverSkills } = await import("./skills-DFduSvuO.js").then((n) => n.o);
+	const { discoverSkills } = await import("./skills-C6zJbudq.js").then((n) => n.o);
 	const skills = await discoverSkills();
 	return skillReportsSchema.parse(skills.map((skill) => ({
 		name: skill.name,
@@ -4365,7 +4492,7 @@ async function readSkillReports() {
 }
 /** Read safe configured plugin metadata for authenticated runtime diagnostics. */
 async function readPlugins() {
-	const { pluginCatalogRuntime } = await import("./catalog-runtime-CpxhLwZG.js").then((n) => n.t);
+	const { pluginCatalogRuntime } = await import("./catalog-runtime-CTaQXYqS.js").then((n) => n.t);
 	return pluginsSchema.parse(pluginCatalogRuntime.getProviders().map((plugin) => ({
 		configKeys: plugin.manifest.configKeys ?? [],
 		description: plugin.manifest.description,
@@ -4377,7 +4504,7 @@ async function readPlugins() {
 async function readRuntimeInfoReport() {
 	const [{ homeDir }, { pluginCatalogRuntime }, plugins, skills] = await Promise.all([
 		import("./package-discovery-BVvSnQBB.js").then((n) => n.r),
-		import("./catalog-runtime-CpxhLwZG.js").then((n) => n.t),
+		import("./catalog-runtime-CTaQXYqS.js").then((n) => n.t),
 		readPlugins(),
 		readSkillReports()
 	]);
@@ -4394,7 +4521,7 @@ async function readRuntimeInfoReport() {
 /** Read sanitized operational summaries contributed by plugins. */
 async function readPluginOperationalReportFeed() {
 	const nowMs = Date.now();
-	const { getPluginOperationalReports } = await import("./agent-hooks-Cj_rSeWd.js").then((n) => n.t);
+	const { getPluginOperationalReports } = await import("./agent-hooks-DpklSWZg.js").then((n) => n.t);
 	return pluginOperationalReportFeedSchema.parse({
 		source: "plugins",
 		generatedAt: new Date(nowMs).toISOString(),