agent-transport-system 0.3.47 → 0.3.49

package/dist/ats-dev.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import "./lock-Bb7PYhPq.js";
-import { v as DEV_LOCAL_GATEWAY_BASE_URL } from "./runtime-config-DrykJV63.js";
+import "./lock-BDqdJx3V.js";
+import { v as DEV_LOCAL_GATEWAY_BASE_URL } from "./runtime-config-BB48ivdi.js";
 
 //#region src/ats-dev.ts
 const LOCAL_GATEWAY_URL = DEV_LOCAL_GATEWAY_BASE_URL;

package/dist/ats.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
-import { $ as currentDeviceTargetResponseSchema, $t as resolveSpaceMentionLabels, A as SPACE_MEMBER_REMOVE_NOTICE_PURPOSE, An as writeCurrentDeviceBootstrapObservationResponseSchema, At as normalizeBuiltinControllerAgentId, B as atsdTaskResultOpenClawGatewayVisibilityStatusSchema, Bt as patchStartSessionBodySchema, C as DISPATCH_ACTIVITY_DISPATCHING_PURPOSE, Cn as startSessionSpaceChoiceResponseSchema, Ct as getSpaceDispatchResultResponseSchema, D as MAX_PROFILE_WORKING_DIRECTORY_LENGTH, Dn as upsertProfileSpaceHistoryResponseSchema, Dt as isExplicitBuiltinControllerRef, E as LEGACY_RUNTIME_DISPATCH_POLICY, En as structuredGuidePayloadFromInputSchema, Et as incomingServerMessageSchema, F as atsRuntimeProfileIdSchema, Fn as writeStartObservedDeviceMetadataBodySchema, Ft as ownedDevicesResponseSchema, G as canonicalizeControllerRefForKind, Gt as profileWorkspaceModeSchema, H as buildControllerRoutingKeyForKind, Ht as postNormalMessageResponseSchema, I as atsSpaceEgressActionSchema, In as writeStartObservedDeviceMetadataResponseSchema, It as parseOptionalClientMessageId, J as continuitySchema, Jt as removeSpaceMembersResponseSchema, K as catchupResponseSchema, Kt as providerDispatchRuntimeContextSchema, L as atsdControlPlaneRequestSchema, Ln as writeStartSessionProgressBodySchema, Lt as patchProfileSpaceHistoryStatusResponseSchema, M as SPACE_PASSWORD_MIN_LENGTH, Mn as writeCurrentDeviceObservedMetadataResponseSchema, Mt as normalizeListSignalsReadQuerySemantics, N as SPACE_UPDATES_MAX_LIMIT, Nn as writeStartObservationBodySchema, Nt as normalizeMessageEnvelope, O as SPACE_DISPATCH_TRACE_PROMPT_PREVIEW_MAX_CHARS, On as upsertSpaceDeletionTombstoneResponseSchema, Ot as leaveSpaceResponseSchema, P as atsProfileIdSchema, Pn as writeStartObservationResponseSchema, Pt as normalizeOptionalWorkingDirectory, Q as createStartSessionBodySchema, Qt as resolveSingleSpaceMentionLabels, R as atsdControlPlaneResponseSchema, Rn as writeStartSessionProgressResponseSchema, Rt as patchSpaceContractBodySchema, S as DAEMON_HUB_SCHEMA_VERSION, Sn as startSessionSpaceChoiceBodySchema, St as getSpaceDispatchLookupResponseSchema, T as DISPATCH_ACTIVITY_RETRYING_PURPOSE, Tn as startStateResponseSchema, Tt as getSpaceUpdatesResponseSchema, U as buildUpstreamConversationRef, Ut as postSpaceMembersBodySchema, V as atsdTaskResultPayloadSchema, Vt as postNormalMessageBodySchema, W as canonicalizeBuiltinControllerRef, Wt as postSpaceMembersResponseSchema, X as createSpaceBodySchema, Xt as resolveBuiltinUpstreamConversationRefKind, Y as conversationExecutionStateSchema, Yt as resolveBuiltinProviderConversationCapability, Z as createSpaceResponseSchema, Zt as resolveMessageEnvelopeTargetField, _ as AGENT_REPLY_PREVIEW_END_PURPOSE, _n as spaceMetaSchema, _t as gatewayErrorCodeSchema, a as runWithHeldLock, an as serverErrorFrameSchema, at as daemonHubHeartbeatResponseSchema, b as ATSD_TASK_RESULT_SCHEMA_VERSION, bn as startSessionProgressSchema, bt as getSpaceConversationRemoteStatusResponseSchema, c as LEGACY_ATS_RUNTIME_SESSION_ENV_KEY, cn as signalEnvelopeSchema, ct as daemonHubSubmitTaskResultRequestSchema, d as resolveRuntimeSession, dn as spaceConversationBindingImportResponseSchema, dt as daemonServiceContractSchema, en as resolveStartHandoffBodySchema, et as daemonHubDeliverDispatchRequestSchema, f as resolveRuntimeSessionId, fn as spaceConversationBindingResponseSchema, ft as daemonStreamFrameSchema, g as AGENT_REPLYING_PURPOSE, gn as spaceMembersSnapshotSchema, gt as formatCanonicalMentionLiteral, h as AGENT_REPLYING_END_PURPOSE, hn as spaceDispatchTraceResponseSchema, ht as forgetCurrentComputerResponseSchema, i as releaseLock, in as sanitizeSignalTextPreview, it as daemonHubHeartbeatRequestSchema, j as SPACE_MENTION_REJECT_NOTICE_PURPOSE, jn as writeCurrentDeviceObservedMetadataBodySchema, jt as normalizeBuiltinControllerProviderId, k as SPACE_MEMBER_JOIN_NOTICE_PURPOSE, kn as writeCurrentDeviceBootstrapObservationBodySchema, kt as listProfileSpaceHistoryResponseSchema, l as listRuntimeSessionStates, ln as spaceConversationBindingConflictResponseSchema, lt as daemonRouteObservationResponseSchema, m as resolveBuiltinAgentControllerBrand, mn as spaceCreatorSchema, mt as entryBriefSchema, n as isAtsLockError, nt as daemonHubDispatchPreviewEndRequestSchema, o as tryCleanupStaleLock, on as setCurrentDeviceTargetBodySchema, ot as daemonHubRegisterSessionRequestSchema, p as writeRuntimeSessionState, pn as spaceConversationBindingUpsertResponseSchema, pt as dispatchBriefSchema, q as collectCanonicalMentionTextFragments, qt as querySpaceDeletionTombstonesResponseSchema, r as readLockMeta, rt as daemonHubDispatchPreviewRequestSchema, s as ATS_RUNTIME_SESSION_ENV_KEY, sn as setOwnedDeviceDisplayNameBodySchema, st as daemonHubRegisterSessionResponseSchema, t as acquireLock, tn as resolveStartHandoffResponseSchema, tt as daemonHubDispatchLifecycleRequestSchema, u as readRuntimeSessionState, un as spaceConversationBindingDeleteResponseSchema, ut as daemonRuntimeLeaseSchema, v as AGENT_REPLY_PREVIEW_PURPOSE, vn as startDeviceProjectionSchema, vt as gatewayErrorEnvelopeSchema, w as DISPATCH_ACTIVITY_FAILED_PURPOSE, wn as startSessionWithTokenResponseSchema, wt as getSpaceStatusResponseSchema, x as CONVERSATION_CONTINUITY_WARNING_PURPOSE, xn as startSessionResponseSchema, xt as getSpaceConversationStatusResponseSchema, y as ATSD_CONTROL_PLANE_SCHEMA_VERSION, yn as startProfileReadinessSummarySchema, yt as getSpaceContractResponseSchema, z as atsdTaskResultEnvelopeWriteSchema, zn as createDaemonRouteObservationSummary, zt as patchSpaceContractResponseSchema } from "./lock-Bb7PYhPq.js";
+import { $ as currentDeviceTargetResponseSchema, $t as resolveSpaceMentionLabels, A as SPACE_MEMBER_REMOVE_NOTICE_PURPOSE, An as writeCurrentDeviceBootstrapObservationResponseSchema, At as normalizeBuiltinControllerAgentId, B as atsdTaskResultOpenClawGatewayVisibilityStatusSchema, Bt as patchStartSessionBodySchema, C as DISPATCH_ACTIVITY_DISPATCHING_PURPOSE, Cn as startSessionSpaceChoiceResponseSchema, Ct as getSpaceDispatchResultResponseSchema, D as MAX_PROFILE_WORKING_DIRECTORY_LENGTH, Dn as upsertProfileSpaceHistoryResponseSchema, Dt as isExplicitBuiltinControllerRef, E as LEGACY_RUNTIME_DISPATCH_POLICY, En as structuredGuidePayloadFromInputSchema, Et as incomingServerMessageSchema, F as atsRuntimeProfileIdSchema, Fn as writeStartObservedDeviceMetadataBodySchema, Ft as ownedDevicesResponseSchema, G as canonicalizeControllerRefForKind, Gt as profileWorkspaceModeSchema, H as buildControllerRoutingKeyForKind, Ht as postNormalMessageResponseSchema, I as atsSpaceEgressActionSchema, In as writeStartObservedDeviceMetadataResponseSchema, It as parseOptionalClientMessageId, J as continuitySchema, Jt as removeSpaceMembersResponseSchema, K as catchupResponseSchema, Kt as providerDispatchRuntimeContextSchema, L as atsdControlPlaneRequestSchema, Ln as writeStartSessionProgressBodySchema, Lt as patchProfileSpaceHistoryStatusResponseSchema, M as SPACE_PASSWORD_MIN_LENGTH, Mn as writeCurrentDeviceObservedMetadataResponseSchema, Mt as normalizeListSignalsReadQuerySemantics, N as SPACE_UPDATES_MAX_LIMIT, Nn as writeStartObservationBodySchema, Nt as normalizeMessageEnvelope, O as SPACE_DISPATCH_TRACE_PROMPT_PREVIEW_MAX_CHARS, On as upsertSpaceDeletionTombstoneResponseSchema, Ot as leaveSpaceResponseSchema, P as atsProfileIdSchema, Pn as writeStartObservationResponseSchema, Pt as normalizeOptionalWorkingDirectory, Q as createStartSessionBodySchema, Qt as resolveSingleSpaceMentionLabels, R as atsdControlPlaneResponseSchema, Rn as writeStartSessionProgressResponseSchema, Rt as patchSpaceContractBodySchema, S as DAEMON_HUB_SCHEMA_VERSION, Sn as startSessionSpaceChoiceBodySchema, St as getSpaceDispatchLookupResponseSchema, T as DISPATCH_ACTIVITY_RETRYING_PURPOSE, Tn as startStateResponseSchema, Tt as getSpaceUpdatesResponseSchema, U as buildUpstreamConversationRef, Ut as postSpaceMembersBodySchema, V as atsdTaskResultPayloadSchema, Vt as postNormalMessageBodySchema, W as canonicalizeBuiltinControllerRef, Wt as postSpaceMembersResponseSchema, X as createSpaceBodySchema, Xt as resolveBuiltinUpstreamConversationRefKind, Y as conversationExecutionStateSchema, Yt as resolveBuiltinProviderConversationCapability, Z as createSpaceResponseSchema, Zt as resolveMessageEnvelopeTargetField, _ as AGENT_REPLY_PREVIEW_END_PURPOSE, _n as spaceMetaSchema, _t as gatewayErrorCodeSchema, a as runWithHeldLock, an as serverErrorFrameSchema, at as daemonHubHeartbeatResponseSchema, b as ATSD_TASK_RESULT_SCHEMA_VERSION, bn as startSessionProgressSchema, bt as getSpaceConversationRemoteStatusResponseSchema, c as LEGACY_ATS_RUNTIME_SESSION_ENV_KEY, cn as signalEnvelopeSchema, ct as daemonHubSubmitTaskResultRequestSchema, d as resolveRuntimeSession, dn as spaceConversationBindingImportResponseSchema, dt as daemonServiceContractSchema, en as resolveStartHandoffBodySchema, et as daemonHubDeliverDispatchRequestSchema, f as resolveRuntimeSessionId, fn as spaceConversationBindingResponseSchema, ft as daemonStreamFrameSchema, g as AGENT_REPLYING_PURPOSE, gn as spaceMembersSnapshotSchema, gt as formatCanonicalMentionLiteral, h as AGENT_REPLYING_END_PURPOSE, hn as spaceDispatchTraceResponseSchema, ht as forgetCurrentComputerResponseSchema, i as releaseLock, in as sanitizeSignalTextPreview, it as daemonHubHeartbeatRequestSchema, j as SPACE_MENTION_REJECT_NOTICE_PURPOSE, jn as writeCurrentDeviceObservedMetadataBodySchema, jt as normalizeBuiltinControllerProviderId, k as SPACE_MEMBER_JOIN_NOTICE_PURPOSE, kn as writeCurrentDeviceBootstrapObservationBodySchema, kt as listProfileSpaceHistoryResponseSchema, l as listRuntimeSessionStates, ln as spaceConversationBindingConflictResponseSchema, lt as daemonRouteObservationResponseSchema, m as resolveBuiltinAgentControllerBrand, mn as spaceCreatorSchema, mt as entryBriefSchema, n as isAtsLockError, nt as daemonHubDispatchPreviewEndRequestSchema, o as tryCleanupStaleLock, on as setCurrentDeviceTargetBodySchema, ot as daemonHubRegisterSessionRequestSchema, p as writeRuntimeSessionState, pn as spaceConversationBindingUpsertResponseSchema, pt as dispatchBriefSchema, q as collectCanonicalMentionTextFragments, qt as querySpaceDeletionTombstonesResponseSchema, r as readLockMeta, rt as daemonHubDispatchPreviewRequestSchema, s as ATS_RUNTIME_SESSION_ENV_KEY, sn as setOwnedDeviceDisplayNameBodySchema, st as daemonHubRegisterSessionResponseSchema, t as acquireLock, tn as resolveStartHandoffResponseSchema, tt as daemonHubDispatchLifecycleRequestSchema, u as readRuntimeSessionState, un as spaceConversationBindingDeleteResponseSchema, ut as daemonRuntimeLeaseSchema, v as AGENT_REPLY_PREVIEW_PURPOSE, vn as startDeviceProjectionSchema, vt as gatewayErrorEnvelopeSchema, w as DISPATCH_ACTIVITY_FAILED_PURPOSE, wn as startSessionWithTokenResponseSchema, wt as getSpaceStatusResponseSchema, x as CONVERSATION_CONTINUITY_WARNING_PURPOSE, xn as startSessionResponseSchema, xt as getSpaceConversationStatusResponseSchema, y as ATSD_CONTROL_PLANE_SCHEMA_VERSION, yn as startProfileReadinessSummarySchema, yt as getSpaceContractResponseSchema, z as atsdTaskResultEnvelopeWriteSchema, zn as createDaemonRouteObservationSummary, zt as patchSpaceContractResponseSchema } from "./lock-BDqdJx3V.js";
 import { A as runtimeLogsDir, C as normalizeAtsProfileId, D as resolveAtsRootDir, E as resolveAtsEnvPreset, M as skillsDir, N as spacesDir, O as resolveKnownAtsEnvPresetFromArgv, P as systemDir, S as normalizeAccountKey, T as profileViewPath, a as accountProfileWorkspacePath, c as atsRootDir, d as deviceOpenClawProfileBootstrapPath, f as deviceOpenClawProfileDir, i as accountProfileViewPath, k as runtimeDir, n as accountProfileLocalMetaPath, o as accountsDir, p as deviceOpenClawProfileWorkspaceDir, r as accountProfileSpaceCacheDir, s as atsBackupsDir, t as ATS_HOME_ENV_KEY, w as profileDir, y as legacyAccountProfileSpacesDir } from "./paths-DTn3aLSP.js";
-import { A as toSpaceDispatchTraceUrl, C as normalizeBaseUrl, D as toSpaceCursorUrl, E as toSpaceCreateUrl, F as toSpaceRemoveMembersUrl, I as toSpaceResultUrl, L as toSpaceSignalsUrl, M as toSpaceMembersUrl, N as toSpaceMetaUrl, O as toSpaceDeleteUrl, P as toSpacePasswordUrl, R as toSpaceUpdatesUrl, S as resolveExplicitGatewayUrlOrThrow, T as toSpaceContractUrl, _ as updateConfiguredStartV1OnboardingState, a as getConfiguredDeviceRuntimeState, b as resolveBaseUrl, c as getConfiguredStartV1OnboardingState, d as resolveRuntimeSkillsCustomTargetId, f as setConfiguredBaseUrl, g as updateConfiguredSkillsConfig, h as updateConfiguredOnboardingConfig, i as getConfiguredDaemonDispatchLimits, j as toSpaceLeaveUrl, k as toSpaceDispatchLookupUrl, l as getConfiguredViewCustomization, m as updateConfiguredDeviceRuntimeState, n as alignRuntimeConfigStorage, o as getConfiguredOnboardingDisclaimerAcceptedAt, p as setConfiguredSkillsConfig, r as createDefaultRuntimeAgentControllerSettings, s as getConfiguredSkillsConfig, t as DEFAULT_RUNTIME_AGENT_TRANSPORT_MODE, u as getRuntimeConfigReadHealth, w as toDaemonRouteObservationUrl, x as resolveBaseUrlOrNull, y as normalizeGatewayBaseUrlOrNull, z as toSpaceWsUrl } from "./runtime-config-DrykJV63.js";
+import { A as toSpaceDispatchTraceUrl, C as normalizeBaseUrl, D as toSpaceCursorUrl, E as toSpaceCreateUrl, F as toSpaceRemoveMembersUrl, I as toSpaceResultUrl, L as toSpaceSignalsUrl, M as toSpaceMembersUrl, N as toSpaceMetaUrl, O as toSpaceDeleteUrl, P as toSpacePasswordUrl, R as toSpaceUpdatesUrl, S as resolveExplicitGatewayUrlOrThrow, T as toSpaceContractUrl, _ as updateConfiguredStartV1OnboardingState, a as getConfiguredDeviceRuntimeState, b as resolveBaseUrl, c as getConfiguredStartV1OnboardingState, d as resolveRuntimeSkillsCustomTargetId, f as setConfiguredBaseUrl, g as updateConfiguredSkillsConfig, h as updateConfiguredOnboardingConfig, i as getConfiguredDaemonDispatchLimits, j as toSpaceLeaveUrl, k as toSpaceDispatchLookupUrl, l as getConfiguredViewCustomization, m as updateConfiguredDeviceRuntimeState, n as alignRuntimeConfigStorage, o as getConfiguredOnboardingDisclaimerAcceptedAt, p as setConfiguredSkillsConfig, r as createDefaultRuntimeAgentControllerSettings, s as getConfiguredSkillsConfig, t as DEFAULT_RUNTIME_AGENT_TRANSPORT_MODE, u as getRuntimeConfigReadHealth, w as toDaemonRouteObservationUrl, x as resolveBaseUrlOrNull, y as normalizeGatewayBaseUrlOrNull, z as toSpaceWsUrl } from "./runtime-config-BB48ivdi.js";
 import { createRequire } from "node:module";
 import { Command, Option } from "commander";
 import { accessSync, appendFileSync, chmodSync, constants, existsSync, mkdirSync, readFileSync, realpathSync, statSync, writeFileSync } from "node:fs";
@@ -27,7 +27,7 @@ import wrapAnsi from "wrap-ansi";
 import { Box, Container, Editor, Key, ProcessTerminal, TUI, Text, getEditorKeybindings, matchesKey } from "@mariozechner/pi-tui";
 
 //#region package.json
-var version = "0.3.47";
+var version = "0.3.49";
 var package_default = {
 	name: "agent-transport-system",
 	version,
@@ -4007,7 +4007,7 @@ async function setDaemonServiceRuntimeState(state, pathInput = {}) {
 	await writeDaemonServiceRuntimeState(state, pathInput);
 }
 async function clearDaemonServiceRuntimeState(pathInput = {}) {
-	const { clearDaemonRuntimeLease } = await import("./daemon-runtime-lease-CvsrTiRk.js");
+	const { clearDaemonRuntimeLease } = await import("./daemon-runtime-lease-G7W5cMzg.js");
 	await Promise.all([rm(daemonServiceRuntimeStatePath(pathInput), { force: true }), clearDaemonRuntimeLease(pathInput)]);
 }
 async function withDaemonServiceRunLock(callback, meta = {
@@ -52802,8 +52802,11 @@ function failCliStartHandoffProgress(input) {
 //#endregion
 //#region src/ui/delayed-spinner.ts
 const DEFAULT_SPINNER_DELAY_MS = 250;
+const SPINNER_DECORATION_VISIBLE_WIDTH = 6;
+const TRUNCATED_SPINNER_MESSAGE_MARKER = "…";
 function createDelayedSpinner(input) {
-	if (!(input.enabled === true && (input.isTTY ?? process.stdout.isTTY) === true && typeof clackPrompts.spinner === "function")) return {
+	const terminalColumns = resolveSpinnerTerminalColumns(input.columns ?? process.stdout.columns);
+	if (!(input.enabled === true && (input.isTTY ?? process.stdout.isTTY) === true && terminalColumns !== null && terminalColumns >= SPINNER_DECORATION_VISIBLE_WIDTH && typeof clackPrompts.spinner === "function")) return {
 		start: () => void 0,
 		complete: () => void 0,
 		fail: () => void 0
@@ -52812,7 +52815,10 @@ function createDelayedSpinner(input) {
 	const delayMs = input.delayMs ?? DEFAULT_SPINNER_DELAY_MS;
 	let pendingTimer = null;
 	let spinnerVisible = false;
-	const latestMessage = input.message;
+	const latestMessage = toSingleLineSpinnerMessage({
+		message: input.message,
+		terminalColumns
+	});
 	const clearPendingTimer = () => {
 		if (!pendingTimer) return;
 		clearTimeout(pendingTimer);
@@ -52848,6 +52854,30 @@ function createDelayedSpinner(input) {
 		}
 	};
 }
+function resolveSpinnerTerminalColumns(columns) {
+	if (typeof columns !== "number" || !Number.isInteger(columns) || columns < 1) return null;
+	return columns;
+}
+function toSingleLineSpinnerMessage(input) {
+	const maxMessageWidth = input.terminalColumns - SPINNER_DECORATION_VISIBLE_WIDTH;
+	if (maxMessageWidth < 1) return "";
+	return truncateVisibleText(sanitizeTerminalDisplayText(input.message, "single-line").trim(), maxMessageWidth);
+}
+function truncateVisibleText(value, maxWidth) {
+	if (stringWidth(value) <= maxWidth) return value;
+	const markerWidth = stringWidth(TRUNCATED_SPINNER_MESSAGE_MARKER);
+	if (maxWidth <= markerWidth) return TRUNCATED_SPINNER_MESSAGE_MARKER;
+	const targetWidth = maxWidth - markerWidth;
+	let result = "";
+	let resultWidth = 0;
+	for (const char of value) {
+		const charWidth = stringWidth(char);
+		if (resultWidth + charWidth > targetWidth) break;
+		result += char;
+		resultWidth += charWidth;
+	}
+	return `${result.trimEnd()}${TRUNCATED_SPINNER_MESSAGE_MARKER}`;
+}
 
 //#endregion
 //#region src/lib/profile-kind.ts
@@ -53914,10 +53944,11 @@ async function runStartHandoff(input) {
 	const sessionDeviceId = requireStartHandoffSessionDeviceId(sessionSlot.value);
 	const localSetupMode = resolveLocalSetupMode({ session: sessionSlot.value });
 	const profile = await resolveCliStartHandoffProfile(handoff.profile);
-	const { targetProfileIds, targetProfiles } = await resolveCliStartHandoffTargetProfiles({
+	const { targetProfileIds, targetProfiles: resolvedTargetProfiles } = await resolveCliStartHandoffTargetProfiles({
 		primaryProfile: profile,
 		session: sessionSlot.value
 	});
+	let targetProfiles = resolvedTargetProfiles;
 	let readiness = await collectHandoffReadiness(gatewayUrl);
 	let observation = await buildValidatedHandoffObservation({
 		baseUrl: gatewayUrl,
@@ -53952,7 +53983,7 @@ async function runStartHandoff(input) {
 		});
 		if (input.runtime.resolvedView === "human" && input.interactive) {
 			await runWithDelayedSpinner({
-				message: "Waiting for your agent choices in ATS Web. Keep this Terminal open; setup will continue automatically.",
+				message: "Waiting for your agent choices in ATS Web",
 				completeMessage: "ATS received your agent choices from ATS Web.",
 				run: async () => await waitForWebAgentSelection({
 					opaqueToken: input.startSession,
@@ -53982,6 +54013,23 @@ async function runStartHandoff(input) {
 				});
 			}
 		});
+		const preparation = await runHandoffLocalStepWithFailedProgressSync({
+			run: async () => await prepareLocalAgentReadiness({
+				profiles: targetProfiles,
+				interactive: input.runtime.resolvedView === "human" && input.interactive,
+				view: input.view
+			}),
+			syncFailedProgress: async () => {
+				progress = failCliStartHandoffProgress({ progress });
+				await writeHandoffProgress({
+					startApi,
+					opaqueToken: input.startSession,
+					progress
+				});
+			}
+		});
+		if (preparation.status === "cancelled") return;
+		targetProfiles = preparation.profiles;
 		readiness = await collectHandoffReadiness(gatewayUrl);
 		observation = await buildValidatedHandoffObservation({
 			baseUrl: gatewayUrl,
@@ -58065,7 +58113,8 @@ function readLooseGatewayErrorEnvelope(value) {
 //#region src/config/space-dispatch-lookup-api.ts
 async function fetchSpaceDispatchLookup(input) {
 	const endpoint = new URL(toSpaceDispatchLookupUrl(input.baseUrl, input.space));
-	endpoint.searchParams.set("sourceSignalId", input.sourceSignalId);
+	if (typeof input.sourceSignalId === "string") endpoint.searchParams.set("sourceSignalId", input.sourceSignalId);
+	if (typeof input.clientMessageId === "string") endpoint.searchParams.set("clientMessageId", input.clientMessageId);
 	if (typeof input.targetProfileId === "string") endpoint.searchParams.set("targetProfileId", input.targetProfileId);
 	return await readGatewayJsonResponse({
 		response: await fetchSpaceRequestWithTimeout({
@@ -58141,6 +58190,7 @@ async function runServiceTrace(input, deps = {}) {
 		baseUrl,
 		deps,
 		dispatchId: input.dispatchId,
+		clientMessageId: input.clientMessageId,
 		password: input.password,
 		presenter,
 		runtimeView: runtime.resolvedView,
@@ -58162,6 +58212,7 @@ async function runServiceTrace(input, deps = {}) {
 	});
 	const payload = {
 		query: traceResponse.query,
+		lookup: selection.lookup,
 		actorProfile: {
 			profileId: actingProfile.atsProfileId,
 			profileName: actingProfile.profileName,
@@ -58206,6 +58257,7 @@ async function runServiceTrace(input, deps = {}) {
 			actorProfile: actingProfile,
 			spaceId: traceResponse.query.spaceId,
 			dispatchId: traceResponse.query.dispatchId,
+			lookup: selection.lookup,
 			trace: traceResponse.trace,
 			targetProfile: targetContext.targetProfile,
 			currentAgentReplyReadiness: targetContext.currentAgentReplyReadiness,
@@ -58219,15 +58271,20 @@ async function runServiceTrace(input, deps = {}) {
 async function resolveDispatchTraceSelection(input) {
 	const dispatchSelector = normalizeOptionalString$5(input.dispatchId);
 	const sourceSignalSelector = normalizeOptionalString$5(input.sourceSignalId);
+	const clientMessageSelector = normalizeOptionalString$5(input.clientMessageId);
 	const targetProfileSelector = normalizeOptionalString$5(input.targetProfileId);
-	if (Number(dispatchSelector !== null) + Number(sourceSignalSelector !== null) !== 1) throw new Error("exactly one of dispatchId or sourceSignalId is required");
-	if (dispatchSelector) return { dispatchId: dispatchSelector };
-	if (!sourceSignalSelector) throw new Error("sourceSignalId could not be resolved");
+	if (Number(dispatchSelector !== null) + Number(sourceSignalSelector !== null) + Number(clientMessageSelector !== null) !== 1) throw new Error("exactly one of dispatchId, sourceSignalId, or clientMessageId is required");
+	if (dispatchSelector) return {
+		dispatchId: dispatchSelector,
+		lookup: null
+	};
+	if (!(sourceSignalSelector || clientMessageSelector)) throw new Error("lookup selector could not be resolved");
 	const lookup = await (input.deps.fetchLookup ?? fetchSpaceDispatchLookup)({
 		requestContext: input.requestContext,
 		baseUrl: input.baseUrl,
 		space: input.spaceId,
-		sourceSignalId: sourceSignalSelector,
+		...sourceSignalSelector ? { sourceSignalId: sourceSignalSelector } : {},
+		...clientMessageSelector ? { clientMessageId: clientMessageSelector } : {},
 		...targetProfileSelector ? { targetProfileId: targetProfileSelector } : {},
 		password: input.password
 	});
@@ -58237,6 +58294,7 @@ async function resolveDispatchTraceSelection(input) {
 			runtimeView: input.runtimeView,
 			spaceId: lookup.query.spaceId,
 			sourceSignalId: lookup.query.sourceSignalId,
+			clientMessageId: lookup.query.clientMessageId,
 			targetProfileId: lookup.query.targetProfileId
 		});
 		return null;
@@ -58251,7 +58309,10 @@ async function resolveDispatchTraceSelection(input) {
 	}
 	const dispatchId = lookup.matches[0]?.dispatchId ?? null;
 	if (!dispatchId) throw new Error("dispatchId could not be resolved");
-	return { dispatchId };
+	return {
+		dispatchId,
+		lookup
+	};
 }
 async function resolveTraceTargetContext(input) {
 	const targetProfileId = input.trace?.dispatch.targetProfileId ?? null;
@@ -58300,10 +58361,12 @@ function renderLookupNotFound(input) {
 		query: {
 			spaceId: input.spaceId,
 			sourceSignalId: input.sourceSignalId,
+			clientMessageId: input.clientMessageId,
 			targetProfileId: input.targetProfileId
 		},
 		matches: []
 	};
+	const selectorLabel = formatLookupSelectorLabel(input);
 	if (input.runtimeView === "agent") {
 		input.presenter.data({
 			code: "service.trace.lookup",
@@ -58311,7 +58374,7 @@ function renderLookupNotFound(input) {
 		});
 		input.presenter.line({
 			code: "service.trace.lookup.summary",
-			text: `source signal ${input.sourceSignalId}: no matching dispatches`,
+			text: `${selectorLabel}: no matching dispatches`,
 			data: payload
 		});
 		return;
@@ -58326,10 +58389,14 @@ function renderLookupNotFound(input) {
 				label: "Space ID",
 				value: input.spaceId
 			},
-			{
+			...input.sourceSignalId ? [{
 				label: "Source Signal",
 				value: input.sourceSignalId
-			},
+			}] : [],
+			...input.clientMessageId ? [{
+				label: "Client Message",
+				value: input.clientMessageId
+			}] : [],
 			...input.targetProfileId ? [{
 				label: "Target Profile",
 				value: input.targetProfileId
@@ -58340,7 +58407,7 @@ function renderLookupNotFound(input) {
 			},
 			{
 				label: "Why",
-				value: "No dispatch ledger record was found for this source signal."
+				value: input.sourceSignalId ? "No dispatch ledger record was found for this source signal." : "No source signal was found for this client message."
 			}
 		]
 	});
@@ -58353,7 +58420,7 @@ function renderLookupAmbiguous(input) {
 		});
 		input.presenter.line({
 			code: "service.trace.lookup.summary",
-			text: `source signal ${input.lookup.query.sourceSignalId}: ${input.lookup.matches.length} matching dispatches; specify --target-profile or --dispatch`,
+			text: `${formatLookupSelectorLabel(input.lookup.query)}: ${input.lookup.matches.length} matching dispatches; specify --target-profile or --dispatch`,
 			data: input.lookup
 		});
 		return;
@@ -58363,10 +58430,14 @@ function renderLookupAmbiguous(input) {
 			label: "Space ID",
 			value: input.lookup.query.spaceId
 		},
-		{
+		...input.lookup.query.sourceSignalId ? [{
 			label: "Source Signal",
 			value: input.lookup.query.sourceSignalId
-		},
+		}] : [],
+		...input.lookup.query.clientMessageId ? [{
+			label: "Client Message",
+			value: input.lookup.query.clientMessageId
+		}] : [],
 		{
 			label: "Status",
 			value: `${input.lookup.matches.length} matching dispatches`
@@ -58388,6 +58459,11 @@ function renderLookupAmbiguous(input) {
 		rows
 	});
 }
+function formatLookupSelectorLabel(input) {
+	if (input.sourceSignalId) return `source signal ${input.sourceSignalId}`;
+	if (input.clientMessageId) return `client message ${input.clientMessageId}`;
+	return "lookup selector";
+}
 function buildHumanTraceRows(input) {
 	if (!input.trace) return [
 		{
@@ -58428,6 +58504,14 @@ function buildHumanTraceRows(input) {
 			label: "Dispatch ID",
 			value: input.trace.dispatch.dispatchId
 		},
+		...input.lookup?.query.sourceSignalId ? [{
+			label: "Source Signal",
+			value: input.lookup.query.sourceSignalId
+		}] : [],
+		...input.lookup?.query.clientMessageId ? [{
+			label: "Client Message",
+			value: input.lookup.query.clientMessageId
+		}] : [],
 		{
 			label: "Target",
 			value: input.targetProfile?.profileName ?? input.trace.dispatch.targetProfileId
@@ -58435,6 +58519,10 @@ function buildHumanTraceRows(input) {
 		{
 			label: "Dispatch",
 			value: `${input.trace.dispatch.status} · attempts ${input.trace.dispatch.attemptCount}`
+		},
+		{
+			label: "Root Cause",
+			value: resolveTraceRootCause(input.trace)
 		}
 	];
 	if (input.currentAgentReplyReadiness) {
@@ -58662,7 +58750,15 @@ function buildAgentTraceSummary(input) {
 	const previewEmitted = input.trace.streaming?.previewEmitted === true;
 	const runtimeSummary = input.trace.runtime ? ` runtime=${formatRuntimeTraceSummary(input.trace.runtime)}` : "";
 	const dispatchExecutionSummary = input.trace.dispatchExecution ? ` upstream_conversation_resume=${input.trace.dispatchExecution.upstreamConversationResume.status} local_runtime_context=${input.trace.dispatchExecution.localRuntimeContext.status} bootstrap=${input.trace.dispatchExecution.bootstrap.status}` : "";
-	return `dispatch ${input.trace.dispatch.dispatchId}: status=${input.trace.dispatch.status} latestAttempt=${attemptStatus} streaming=${streamingMode} preview=${previewEmitted ? "emitted" : "none"}${runtimeSummary}${dispatchExecutionSummary}`;
+	return `dispatch ${input.trace.dispatch.dispatchId}: status=${input.trace.dispatch.status} rootCause=${resolveTraceRootCause(input.trace)} latestAttempt=${attemptStatus} streaming=${streamingMode} preview=${previewEmitted ? "emitted" : "none"}${runtimeSummary}${dispatchExecutionSummary}`;
+}
+function resolveTraceRootCause(trace) {
+	if (trace.latestAttempt?.errorCode) return trace.latestAttempt.errorCode;
+	if (trace.dispatch.status === "succeeded") return trace.replySignal ? "reply.delivered" : "reply.not_found";
+	if (trace.execution?.leaseState === "stalled") return "daemon.execution_stalled";
+	if (trace.runtime?.timeoutTriggeredAt) return "runtime.timeout";
+	if (trace.latestAttempt?.status) return `attempt.${trace.latestAttempt.status}`;
+	return `dispatch.${trace.dispatch.status}`;
 }
 function formatAttemptError(errorCode, errorMessage) {
 	return errorMessage ? `${errorCode} (${errorMessage})` : errorCode;
@@ -87242,7 +87338,7 @@ registerDaemonControlTargetOptions({ command: serviceCmd.command("cancel").descr
 		}
 	});
 });
-serviceCmd.command("trace").description("Read a Space delivery trace for debugging.").requiredOption("--space <id>", "Space ID (64-character hex)").option("--dispatch <id>", "Dispatch ID").option("--source-signal <id>", "Source signal ID").option("--target-profile <id>", "Target ATS profile ID for source-signal lookup").option("--password <value>", "Space password for protected access").option("--profile <id>", "ATS profile ID used for auth context").option("--gateway-url <url>", "ATS gateway URL (command line, ATS_GATEWAY_URL, or saved ATS settings)").action(async (opts) => {
+serviceCmd.command("trace").description("Read a Space delivery trace for debugging.").requiredOption("--space <id>", "Space ID (64-character hex)").option("--dispatch <id>", "Dispatch ID").option("--source-signal <id>", "Source signal ID").option("--client-message <id>", "Client message ID from the sender").option("--target-profile <id>", "Target ATS profile ID for source-signal lookup").option("--password <value>", "Space password for protected access").option("--profile <id>", "ATS profile ID used for auth context").option("--gateway-url <url>", "ATS gateway URL (command line, ATS_GATEWAY_URL, or saved ATS settings)").action(async (opts) => {
 	const view = getGlobalViewOption();
 	await runCommandWithEntryChecks({
 		routeTokens: ["service", "trace"],
@@ -87252,14 +87348,16 @@ serviceCmd.command("trace").description("Read a Space delivery trace for debuggi
 		run: async () => {
 			const dispatchId = normalizeOptionalString(opts.dispatch);
 			const sourceSignalId = normalizeOptionalString(opts.sourceSignal);
+			const clientMessageId = normalizeOptionalString(opts.clientMessage);
 			const targetProfileId = normalizeOptionalString(opts.targetProfile);
-			if (Number(dispatchId !== null) + Number(sourceSignalId !== null) !== 1) throw new Error("exactly one of --dispatch or --source-signal is required");
+			if (Number(dispatchId !== null) + Number(sourceSignalId !== null) + Number(clientMessageId !== null) !== 1) throw new Error("exactly one of --dispatch, --source-signal, or --client-message is required");
 			await runServiceTrace({
 				profile: opts.profile,
 				baseUrl: opts.gatewayUrl,
 				space: String(opts.space ?? ""),
 				...dispatchId ? { dispatchId } : {},
 				...sourceSignalId ? { sourceSignalId } : {},
+				...clientMessageId ? { clientMessageId } : {},
 				...targetProfileId ? { targetProfileId } : {},
 				password: opts.password,
 				view