agent-transport-system 0.7.3 → 0.7.5

package/dist/ats.js

@@ -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.7.3";
+var version = "0.7.5";
 var package_default = {
 	$schema: "https://www.schemastore.org/package.json",
 	name: "agent-transport-system",
@@ -2492,6 +2492,14 @@ const SPACE_ADD_MEMBERS_PROGRESS_PHASES = [
 		factSource: "space_membership_api_write",
 		summary: "Adding selected profiles to the Space."
 	},
+	{
+		stage: "add_members",
+		phase: "confirm_membership_projection",
+		owner: "space",
+		waitingFor: "Space membership and Wake availability projection",
+		factSource: "space_membership_projection",
+		summary: "Confirming the Space can see newly added wakeable members before returning."
+	},
 	{
 		stage: "record_join_notices",
 		phase: "write_join_notices",
@@ -28706,11 +28714,11 @@ async function readSystemLayoutWithRetry(path) {
 		}
 		const parsed = raw ? parseSystemLayout(raw) : null;
 		if (parsed) return parsed;
-		if (attempt < SYSTEM_LAYOUT_READ_RETRY_COUNT - 1) await delay(SYSTEM_LAYOUT_READ_RETRY_DELAY_MS);
+		if (attempt < SYSTEM_LAYOUT_READ_RETRY_COUNT - 1) await delay$1(SYSTEM_LAYOUT_READ_RETRY_DELAY_MS);
 	}
 	return null;
 }
-function delay(ms) {
+function delay$1(ms) {
 	return new Promise((resolve) => {
 		setTimeout(resolve, ms);
 	});
@@ -64447,8 +64455,10 @@ async function writeConnectedComputerEnrollmentToServiceContract(input) {
 const PREPARE_TOKEN_HEADER = "x-ats-prepare-token";
 const PREPARE_SESSION_MAX_RECONNECT_ATTEMPTS = 3;
 const PREPARE_SESSION_RECONNECT_DELAY_MS = 1e3;
-const ROUTE_CATALOG_SYNC_MAX_ATTEMPTS$1 = 8;
-const ROUTE_CATALOG_SYNC_RETRY_DELAY_MS$1 = 750;
+const REPORT_RUNTIME_CONNECTION_MAX_ATTEMPTS = 12;
+const REPORT_RUNTIME_CONNECTION_RETRY_DELAY_MS = 1e3;
+const ROUTE_CATALOG_SYNC_MAX_ATTEMPTS$1 = 12;
+const ROUTE_CATALOG_SYNC_RETRY_DELAY_MS$1 = 1e3;
 const TERMINAL_PREPARE_STEP_ORDER = [
 	"prepare_selected_agents",
 	"refresh_service",
@@ -64882,6 +64892,17 @@ async function enforcePrepareSessionTerminalAuth(input) {
 	throw new Error(result.message);
 }
 async function connectSelectedLocalAgentsToAts(input) {
+	let lastTransientError = null;
+	for (let attempt = 1; attempt <= REPORT_RUNTIME_CONNECTION_MAX_ATTEMPTS; attempt++) try {
+		return await connectSelectedLocalAgentsToAtsOnce(input);
+	} catch (error) {
+		if (!isTransientSelectedAgentConnectionError(error) || attempt >= REPORT_RUNTIME_CONNECTION_MAX_ATTEMPTS) throw error;
+		lastTransientError = error;
+		await sleep$2(REPORT_RUNTIME_CONNECTION_RETRY_DELAY_MS);
+	}
+	throw lastTransientError ?? /* @__PURE__ */ new Error("ATS could not connect local agents.");
+}
+async function connectSelectedLocalAgentsToAtsOnce(input) {
 	const runtimeIdentity = await syncLocalSetupCurrentDeviceTargetFromServiceContract({ gatewayUrl: input.gatewayUrl });
 	const readiness = await collectStartLocalReadiness({ auth: {
 		status: "valid",
@@ -64907,6 +64928,10 @@ async function connectSelectedLocalAgentsToAts(input) {
 		localReadinessSnapshot: buildPrepareLocalReadinessSnapshot(readiness)
 	};
 }
+function isTransientSelectedAgentConnectionError(error) {
+	const rawMessage = toErrorMessage$10(error).toLowerCase();
+	return rawMessage.includes("service has not finished starting") || rawMessage.includes("ats service is not running") || rawMessage.includes("service.not_running") || rawMessage.includes("service_contract_unavailable") || rawMessage.includes("runtime.reporting.write_failed");
+}
 async function verifySelectedLocalAgentsConnectedToAts(input) {
 	const runtimeIdentity = await readTerminalRuntimeIdentityFromServiceContract();
 	const readiness = await collectStartLocalReadiness({ auth: {
@@ -65001,7 +65026,6 @@ function formatTerminalStepFailureMessage(input) {
 		const detail = formatTerminalStepFailureDetail(input.rawMessage);
 		return `ATS Service did not report a running local connection during setup. Copy a fresh setup command from ATS Web and run setup again to continue from this step. If it fails again, run \`${formatAtsCliCommand("ats service start --mode foreground")}\` to see live startup logs, then copy a fresh setup command from ATS Web and run setup again.${detail ? ` Detail: ${detail}` : ""}`;
 	}
-	if (input.stepId === "report_runtime" && input.rawMessage.toLowerCase().includes("service")) return `ATS Service stopped before ATS could connect selected agents to ATS. Start ATS Service with \`${formatAtsCliCommand("ats service start")}\`, then copy a fresh setup command from ATS Web and run setup again.`;
 	return input.rawMessage;
 }
 function formatTerminalStepFailureDetail(rawMessage) {
@@ -68206,7 +68230,14 @@ function isAgentProfile(profile) {
 //#region src/commands/setup.ts
 const ROUTE_CATALOG_SYNC_MAX_ATTEMPTS = 8;
 const ROUTE_CATALOG_SYNC_RETRY_DELAY_MS = 750;
+const SETUP_COMMAND_LOCK_PROFILE = "setup";
+const SETUP_COMMAND_LOCK_KEY = "setup-command";
 async function runSetup(input) {
+	return await withSetupCommandLock(input, async () => {
+		await runSetupUnlocked(input);
+	});
+}
+async function runSetupUnlocked(input) {
 	if (shouldUseSetupLocalAgentConnection(input)) {
 		const setupResult = await runSetupLocalAgentConnection(input);
 		if (setupResult.status !== "completed") return;
@@ -68310,6 +68341,33 @@ async function runSetup(input) {
 		view: runtime.resolvedView
 	});
 }
+async function withSetupCommandLock(input, run) {
+	try {
+		return await runWithHeldLock({
+			lock: await acquireLock({
+				atsProfileId: SETUP_COMMAND_LOCK_PROFILE,
+				key: SETUP_COMMAND_LOCK_KEY,
+				meta: {
+					command: "ats setup",
+					path: shouldUseSetupLocalAgentConnection(input) ? "delegated_or_profile_setup" : "local_setup",
+					view: input.view ?? null
+				}
+			}),
+			run,
+			releaseContext: {
+				atsProfileId: SETUP_COMMAND_LOCK_PROFILE,
+				component: "setup_command",
+				lockKey: SETUP_COMMAND_LOCK_KEY
+			}
+		});
+	} catch (error) {
+		if (isAtsLockError(error)) throw new Error(buildSetupCommandLockMessage(error));
+		throw error;
+	}
+}
+function buildSetupCommandLockMessage(error) {
+	return `Another ATS setup is already running on this computer. Wait for it to finish, then run setup again.${error.metaRaw ? ` Existing setup: ${error.metaRaw}` : ""}`;
+}
 function shouldUseSetupLocalAgentConnection(input) {
 	return Boolean(normalizeOptionalString$5(input.startSession) ?? normalizeOptionalString$5(input.humanProfile) ?? normalizeOptionalString$5(input.profile) ?? (input.agent && input.agent.length > 0 ? "agent" : null));
 }
@@ -84915,6 +84973,8 @@ const TRAILING_SLASHES_RE = /\/+$/u;
 const SPACE_CREATE_AUTH_CHECK_TIMEOUT_MS = 8e3;
 const SPACE_CREATE_AUTH_CHECK_LOOPBACK_TIMEOUT_MS = 1500;
 const SPACE_LOADING_SPINNER_MESSAGE = "Loading spaces...";
+const SPACE_ADD_MEMBERS_PROJECTION_WAIT_MAX_ATTEMPTS = 3;
+const SPACE_ADD_MEMBERS_PROJECTION_WAIT_DELAY_MS = 500;
 function requireReadableSpaceConfigList(result, operation) {
 	if (result.kind === "corrupt") throw toSpaceConfigListIntegrityError({
 		operation,
@@ -85117,6 +85177,7 @@ async function runSpaceCreate(input) {
 			guide: typeof parsed.meta?.guide === "string" ? parsed.meta.guide : createInput.value.guide
 		});
 		emitSpaceCreateSuccessOutput({
+			baseUrl,
 			presenter: contextPresenter,
 			parsed,
 			outputMode,
@@ -85135,6 +85196,7 @@ async function runSpaceCreate(input) {
 		const joinNow = isHumanInteractiveSpaceRuntime(contextRuntime) ? Boolean(createInput.value.joinInput) : await resolveJoinAfterCreate(createInput.value.joinInput, contextInteractive);
 		if (contextRuntime.resolvedView === "agent") {
 			emitSpaceCreateAgentFollowUp({
+				baseUrl,
 				presenter: contextPresenter,
 				profileId: atsProfile.atsProfileId,
 				spaceId: parsed.spaceId,
@@ -85170,12 +85232,14 @@ async function runSpaceCreate(input) {
 	}
 }
 function emitSpaceCreateAgentFollowUp(input) {
+	const spaceUrl = buildSpaceWebUrl(input.baseUrl, input.spaceId);
 	const historyCommand = formatAtsCliCommand(`ats space history ${input.spaceId} --profile ${input.profileId} --kind text --brief --limit 20 --view agent`);
 	const sendCommand = formatAtsCliCommand(`ats space send ${input.spaceId} --profile ${input.profileId} "hello" --view agent`);
 	input.presenter.data({
 		code: "space.create.next_commands",
 		payload: {
 			spaceId: input.spaceId,
+			spaceUrl,
 			joinRequested: input.joinRequested,
 			joinedByCreate: true,
 			note: "Agent View create returns after creating the Space. Use explicit follow-up commands instead of opening a long-running join session.",
@@ -85262,6 +85326,9 @@ function renderHumanSpaceCreateCard(input) {
 	const rows = [{
 		label: "🆔 Space ID",
 		value: input.spaceId
+	}, {
+		label: "🔗 Space URL",
+		value: input.spaceUrl
 	}];
 	if (input.passwordProtected) {
 		rows.push({
@@ -85547,6 +85614,14 @@ function toAuthEndpoint(baseUrl, pathname) {
 	url.hash = "";
 	return url.toString();
 }
+function buildSpaceWebUrl(baseUrl, spaceId) {
+	const url = new URL(baseUrl);
+	if (isLoopbackHostname(url.hostname) && url.port === "8080") url.port = "3000";
+	url.pathname = `/app/spaces/${encodeURIComponent(spaceId)}`;
+	url.search = "";
+	url.hash = "";
+	return url.toString();
+}
 function resolveSpaceCreateAuthCheckTimeoutMs(endpoint) {
 	const url = parseUrlOrNull(endpoint);
 	if (url && isLoopbackHostname(url.hostname)) return SPACE_CREATE_AUTH_CHECK_LOOPBACK_TIMEOUT_MS;
@@ -85563,10 +85638,14 @@ function isLoopbackHostname(hostname) {
 	return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1";
 }
 function emitSpaceCreateSuccessOutput(input) {
+	const spaceUrl = buildSpaceWebUrl(input.baseUrl, input.parsed.spaceId);
 	if (input.outputMode === "ndjson") {
 		input.presenter.data({
 			code: "space.create.response",
-			payload: input.parsed
+			payload: {
+				...input.parsed,
+				spaceUrl
+			}
 		});
 		return;
 	}
@@ -85574,6 +85653,7 @@ function emitSpaceCreateSuccessOutput(input) {
 		renderHumanSpaceCreateCard({
 			presenter: input.presenter,
 			spaceId: input.parsed.spaceId,
+			spaceUrl,
 			passwordProtected: input.passwordProtected
 		});
 		return;
@@ -85583,6 +85663,14 @@ function emitSpaceCreateSuccessOutput(input) {
 		text: formatMessage(input.resolvedView, "space.create.created", { spaceId: input.parsed.spaceId }),
 		data: { spaceId: input.parsed.spaceId }
 	});
+	input.presenter.line({
+		code: "space.create.url",
+		text: `Space URL: ${spaceUrl}`,
+		data: {
+			spaceId: input.parsed.spaceId,
+			spaceUrl
+		}
+	});
 	if (!input.passwordProtected) return;
 	input.presenter.line({
 		code: "space.password.warning",
@@ -86324,6 +86412,14 @@ async function runSpaceAddMembersForTarget(input) {
 		baseUrl: targetBaseUrl,
 		password: input.password
 	});
+	await waitForAddedMembersWakeProjection({
+		actorProfile: input.atsProfile,
+		baseUrl: targetBaseUrl,
+		password: input.password,
+		progress,
+		result,
+		space: input.target.space
+	});
 	emitSpaceAddMembersProgressIfRequested(progress, {
 		stage: "record_join_notices",
 		phase: "write_join_notices",
@@ -88526,6 +88622,42 @@ async function applySpaceAddMembers(input) {
 	}
 	return result;
 }
+async function waitForAddedMembersWakeProjection(input) {
+	const expectedWakeableProfileIds = resolveExpectedWakeProjectionProfileIds(input.result);
+	if (expectedWakeableProfileIds.length === 0) return;
+	emitSpaceAddMembersProgressIfRequested(input.progress, {
+		stage: "add_members",
+		phase: "confirm_membership_projection",
+		summary: "Confirming the Space can see newly added wakeable members before returning.",
+		profileIds: expectedWakeableProfileIds
+	});
+	const expected = new Set(expectedWakeableProfileIds);
+	for (let attempt = 0; attempt < SPACE_ADD_MEMBERS_PROJECTION_WAIT_MAX_ATTEMPTS; attempt += 1) {
+		if (attempt > 0) await delay(SPACE_ADD_MEMBERS_PROJECTION_WAIT_DELAY_MS);
+		let membersSnapshot;
+		try {
+			membersSnapshot = await createCliSpaceApi(input.baseUrl).getMembersSnapshot({
+				spaceId: input.space,
+				requestContext: buildAtsRequestContextFromProfile({ atsProfile: input.actorProfile }),
+				...input.password === void 0 ? {} : { spacePassword: input.password }
+			});
+		} catch {
+			return;
+		}
+		if (hasExpectedWakeProjection(membersSnapshot, expected)) return;
+	}
+}
+function resolveExpectedWakeProjectionProfileIds(result) {
+	return result.added.filter((candidate) => candidate.profileKind === "agent" && candidate.localParticipationReadiness === "ready").map((candidate) => candidate.profileId);
+}
+function hasExpectedWakeProjection(membersSnapshot, expectedProfileIds) {
+	const wakeableProfileIds = new Set(membersSnapshot.agents.filter((member) => member.status === "active" && member.publicReplyPresence?.status === "ready").map((member) => member.profileId));
+	for (const profileId of expectedProfileIds) if (!wakeableProfileIds.has(profileId)) return false;
+	return true;
+}
+async function delay(ms) {
+	await new Promise((resolve) => setTimeout(resolve, ms));
+}
 function emitSpaceAddMembersResult(input) {
 	const localParticipationFollowUps = input.result.added.map((candidate) => buildSpaceMemberJoinedFollowUp(candidate)).filter((followUp) => followUp !== null);
 	if (input.resolvedView === "agent") {