@agimon-ai/po-web-dashboard 0.0.0-alpha.0

package/dist/web/lib/hubApi.d.mts

@@ -0,0 +1,109 @@
+import { DirectoryListing, PiSessionHistoryItem, SessionSummary, WorkspaceSummary } from "../../types/hub.mjs";
+import { TranscriptPage, TranscriptPageRequest } from "@agimon-ai/po-core/sessionProtocol";
+//#region src/web/lib/hubApi.d.ts
+export type CreateSessionResult = {
+  sessionId: string;
+  session?: SessionSummary;
+} | {
+  error: string;
+};
+export type WorkspaceResult = {
+  workspace: WorkspaceSummary;
+} | {
+  error: string;
+};
+export type WorkspacesResult = {
+  workspaces: WorkspaceSummary[];
+} | {
+  error: string;
+};
+/** Lists one server folder's visible child directories for the workspace folder browser. */
+export declare function listDirectory(folder?: string): Promise<DirectoryListing | {
+  error: string;
+}>;
+export declare function listWorkspaces(): Promise<WorkspacesResult>;
+/**
+ * Admits a server-side repository root without starting a session. A name alone
+ * asks the server to create the workspace in its default folder.
+ */
+export declare function admitWorkspace(input: {
+  root?: string;
+  name?: string;
+}): Promise<WorkspaceResult>;
+export type RemoveWorkspaceResult = {
+  ok: true;
+} | {
+  error: string;
+};
+/** Unregisters a workspace from Po without touching its files on disk. */
+export declare function removeWorkspace(workspaceId: string): Promise<RemoveWorkspaceResult>;
+/** Starts a session in an already admitted workspace. */
+export declare function createWorkspaceSession(workspaceId: string, input?: {
+  name?: string;
+}): Promise<CreateSessionResult>;
+/** Compatibility flow for callers that have not admitted a workspace yet. */
+export declare function createSession(input: {
+  cwd: string;
+  name?: string;
+}): Promise<CreateSessionResult>;
+export type StopSessionResult = {
+  ok: true;
+} | {
+  error: string;
+};
+/** Asks the hub to stop a session's server; the rail card leaves once the server withdraws its record. */
+export declare function stopSession(sessionId: string): Promise<StopSessionResult>;
+export type RestartSessionResult = {
+  ok: true;
+} | {
+  error: string;
+};
+/**
+ * Asks the hub to replace a session's server, keeping its id.
+ *
+ * A running server reads the composition once. Restart syncs workspace changes
+ * before reopening the session, so changed extensions and APIs take effect.
+ */
+export declare function restartSession(sessionId: string): Promise<RestartSessionResult>;
+export type ReviveSessionResult = {
+  ok: true;
+} | {
+  error: string;
+};
+/**
+ * Asks the hub to reopen a recorded session it has not started yet.
+ *
+ * Step-up gated like creating one, because it is the same act: an agent begins
+ * running in a directory. The card turns live when the resulting upsert lands.
+ */
+export declare function reviveSession(sessionId: string): Promise<ReviveSessionResult>;
+export declare function readDormantTranscriptPage(sessionId: string, request: TranscriptPageRequest, signal?: AbortSignal): Promise<TranscriptPage>;
+export type SessionHistoryResult = {
+  sessions: PiSessionHistoryItem[];
+} | {
+  error: string;
+};
+/** Lists the Pi threads saved for a live session's workspace. */
+export declare function listSessionHistory(sessionId: string): Promise<SessionHistoryResult>;
+export type ResumeSessionResult = {
+  sessionId: string;
+  session?: SessionSummary;
+} | {
+  error: string;
+};
+/** Lists saved history without requiring a live session in the workspace. */
+export declare function listWorkspaceHistory(workspaceId: string): Promise<SessionHistoryResult>;
+/** Starts one saved thread without replacing another live session. */
+export declare function resumeWorkspaceSession(workspaceId: string, targetSessionId: string): Promise<ResumeSessionResult>;
+/** Replaces one live card with a selected Pi thread from the same workspace. */
+export declare function resumeSession(sessionId: string, targetSessionId: string): Promise<ResumeSessionResult>;
+/** File paths under a session's cwd matching the query, for @ completion. */
+export declare function searchSessionFiles(sessionId: string, query: string): Promise<string[]>;
+/**
+ * Directories the typed path could complete to, for the new-session picker.
+ * The hub lists the parent directory's children and filters them by the
+ * trailing segment as a regular expression.
+ */
+export declare function searchDirectories(query: string): Promise<string[]>;
+//#endregion
+//# sourceMappingURL=hubApi.d.mts.map

package/dist/web/lib/hubApi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubApi.d.mts","names":[],"sources":["../../../src/web/lib/hubApi.ts"],"mappings":";;;YAeY;EAAwB;EAAmB,UAAU;;EAAqB;;YAC1E;EAAoB,WAAW;;EAAuB;;YACtD;EAAqB,YAAY;;EAAyB;;;wBAOhD,cAAc,kBAAkB,QAAQ;EAAqB;;wBA+B7D,kBAAkB,QAAQ;;;;;wBAqB1B,eAAe;EAAS;EAAe;IAAkB,QAAQ;YAkB3E;EAA0B;;EAAe;;;wBAG/B,gBAAgB,sBAAsB,QAAQ;;wBAgB9C,uBACpB,qBACA;EAAS;IACR,QAAQ;;wBAiCW,cAAc;EAAS;EAAa;IAAkB,QAAQ;YAMxE;EAAsB;;EAAe;;;wBAG3B,YAAY,oBAAoB,QAAQ;YAoBlD;EAAyB;;EAAe;;;;;;;;wBAQ9B,eAAe,oBAAoB,QAAQ;YAoBrD;EAAwB;;EAAe;;;;;;;;wBAQ7B,cAAc,oBAAoB,QAAQ;wBAkB1C,0BACpB,mBACA,SAAS,uBACT,SAAS,cACR,QAAQ;YAmBC;EAAyB,UAAU;;EAA6B;;;wBAG5D,mBAAmB,oBAAoB,QAAQ;YAInD;EAAwB;EAAmB,UAAU;;EAAqB;;;wBA6BtE,qBAAqB,sBAAsB,QAAQ;;wBAK7C,uBACpB,qBACA,0BACC,QAAQ;;wBAgCW,cAAc,mBAAmB,0BAA0B,QAAQ;;wBAiBnE,mBAAmB,mBAAmB,gBAAgB;;;;;;wBAkBtD,kBAAkB,gBAAgB"}

package/dist/web/lib/hubApi.mjs

@@ -0,0 +1,268 @@
+import { sealedHttpSession } from "./sealedSession.mjs";
+import { fetchWithStepUp } from "./stepUp.mjs";
+import { DIRECTORIES_API_ROUTE, DIRECTORY_CHILDREN_API_ROUTE, WORKSPACES_API_ROUTE } from "../../types/hub.mjs";
+import { sessionApiPath } from "@agimon-ai/po-core/web";
+//#region src/web/lib/hubApi.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Lists one server folder's visible child directories for the workspace folder browser. */
+async function listDirectory(folder) {
+	try {
+		const query = folder === void 0 ? "" : `?path=${encodeURIComponent(folder)}`;
+		const response = await sealedHttpSession.fetch(`${DIRECTORY_CHILDREN_API_ROUTE}${query}`);
+		const body = await response.json().catch(() => void 0);
+		if (response.ok && isRecord(body) && typeof body.path === "string" && Array.isArray(body.directories)) return {
+			path: body.path,
+			...typeof body.parent === "string" ? { parent: body.parent } : {},
+			directories: body.directories.filter((entry) => typeof entry === "string")
+		};
+		return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+function asWorkspace(value) {
+	if (!isRecord(value) || typeof value.id !== "string" || typeof value.root !== "string") return void 0;
+	return {
+		id: value.id,
+		root: value.root,
+		...typeof value.name === "string" && value.name !== "" ? { name: value.name } : {},
+		...typeof value.available === "boolean" ? { available: value.available } : {},
+		...typeof value.error === "string" ? { error: value.error } : {}
+	};
+}
+async function listWorkspaces() {
+	try {
+		const response = await sealedHttpSession.fetch(WORKSPACES_API_ROUTE);
+		const body = await response.json().catch(() => void 0);
+		if (response.ok && isRecord(body) && Array.isArray(body.workspaces)) return { workspaces: body.workspaces.map(asWorkspace).filter((entry) => entry !== void 0) };
+		return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+/**
+* Admits a server-side repository root without starting a session. A name alone
+* asks the server to create the workspace in its default folder.
+*/
+async function admitWorkspace(input) {
+	try {
+		const response = await fetchWithStepUp(WORKSPACES_API_ROUTE, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+		const body = await response.json().catch(() => void 0);
+		const workspace = isRecord(body) ? asWorkspace(body.workspace) : void 0;
+		if (response.ok && workspace !== void 0) return { workspace };
+		return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+/** Unregisters a workspace from Po without touching its files on disk. */
+async function removeWorkspace(workspaceId) {
+	try {
+		const response = await sealedHttpSession.fetch(`${WORKSPACES_API_ROUTE}/${encodeURIComponent(workspaceId)}`, { method: "DELETE" });
+		if (response.ok) return { ok: true };
+		const body = await response.json().catch(() => void 0);
+		return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+/** Starts a session in an already admitted workspace. */
+async function createWorkspaceSession(workspaceId, input = {}) {
+	let response;
+	try {
+		response = await fetchWithStepUp(`/api/workspaces/${encodeURIComponent(workspaceId)}/sessions`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ name: input.name })
+		});
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+	const body = await response.json().catch(() => void 0);
+	if (!response.ok || !isRecord(body) || typeof body.sessionId !== "string") return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	const sessionId = body.sessionId;
+	try {
+		const detail = await sealedHttpSession.fetch(`/api/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}`);
+		const session = await detail.json().catch(() => void 0);
+		if (detail.ok && isRecord(session) && session.id === sessionId) return {
+			sessionId,
+			session
+		};
+	} catch {}
+	return { sessionId };
+}
+/** Compatibility flow for callers that have not admitted a workspace yet. */
+async function createSession(input) {
+	const admission = await admitWorkspace({ root: input.cwd });
+	if ("error" in admission) return admission;
+	return createWorkspaceSession(admission.workspace.id, { name: input.name });
+}
+/** Asks the hub to stop a session's server; the rail card leaves once the server withdraws its record. */
+async function stopSession(sessionId) {
+	let response;
+	try {
+		response = await sealedHttpSession.fetch(`${sessionApiPath(sessionId)}`, { method: "DELETE" });
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+	if (response.ok) return { ok: true };
+	let body;
+	try {
+		body = await response.json();
+	} catch {
+		body = void 0;
+	}
+	return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+}
+/**
+* Asks the hub to replace a session's server, keeping its id.
+*
+* A running server reads the composition once. Restart syncs workspace changes
+* before reopening the session, so changed extensions and APIs take effect.
+*/
+async function restartSession(sessionId) {
+	let response;
+	try {
+		response = await sealedHttpSession.fetch(`${sessionApiPath(sessionId)}/restart`, { method: "POST" });
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+	if (response.ok) return { ok: true };
+	let body;
+	try {
+		body = await response.json();
+	} catch {
+		body = void 0;
+	}
+	return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+}
+/**
+* Asks the hub to reopen a recorded session it has not started yet.
+*
+* Step-up gated like creating one, because it is the same act: an agent begins
+* running in a directory. The card turns live when the resulting upsert lands.
+*/
+async function reviveSession(sessionId) {
+	let response;
+	try {
+		response = await fetchWithStepUp(`${sessionApiPath(sessionId)}/revive`, { method: "POST" });
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+	if (response.ok) return { ok: true };
+	let body;
+	try {
+		body = await response.json();
+	} catch {
+		body = void 0;
+	}
+	return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+}
+async function readDormantTranscriptPage(sessionId, request, signal) {
+	const params = new URLSearchParams();
+	if (request.cursor !== void 0) params.set("cursor", request.cursor);
+	if (request.direction !== void 0) params.set("direction", request.direction);
+	if (request.limit !== void 0) params.set("limit", String(request.limit));
+	const query = params.toString();
+	const response = await sealedHttpSession.fetch(`${sessionApiPath(sessionId)}/transcript${query === "" ? "" : `?${query}`}`, signal === void 0 ? {} : { signal });
+	const body = await response.json().catch(() => void 0);
+	if (!response.ok) {
+		const message = isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.`;
+		throw new Error(message);
+	}
+	if (!isRecord(body) || !Array.isArray(body.entries)) throw new Error("The saved transcript response was invalid.");
+	return body;
+}
+/** Lists the Pi threads saved for a live session's workspace. */
+function listSessionHistory(sessionId) {
+	return listHistoryAt(`${sessionApiPath(sessionId)}/history`);
+}
+async function listHistoryAt(path) {
+	try {
+		const response = await sealedHttpSession.fetch(path);
+		const body = await response.json();
+		if (response.ok && isRecord(body) && Array.isArray(body.sessions)) return { sessions: body.sessions.filter((session) => isRecord(session) && typeof session.id === "string" && (session.name === void 0 || typeof session.name === "string") && typeof session.firstMessage === "string" && typeof session.createdAt === "string" && typeof session.updatedAt === "string" && typeof session.messageCount === "number") };
+		return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+/** Lists saved history without requiring a live session in the workspace. */
+function listWorkspaceHistory(workspaceId) {
+	return listHistoryAt(`/api/workspaces/${encodeURIComponent(workspaceId)}/history`);
+}
+/** Starts one saved thread without replacing another live session. */
+async function resumeWorkspaceSession(workspaceId, targetSessionId) {
+	try {
+		const response = await fetchWithStepUp(`/api/workspaces/${encodeURIComponent(workspaceId)}/resume`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ targetSessionId })
+		});
+		const body = await response.json();
+		if (!response.ok || !isRecord(body) || typeof body.sessionId !== "string") return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+		const sessionId = body.sessionId;
+		try {
+			const detail = await sealedHttpSession.fetch(`/api/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}`);
+			const session = await detail.json().catch(() => void 0);
+			if (detail.ok && isRecord(session) && session.id === sessionId) return {
+				sessionId,
+				session
+			};
+		} catch {}
+		return { sessionId };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+/** Replaces one live card with a selected Pi thread from the same workspace. */
+async function resumeSession(sessionId, targetSessionId) {
+	try {
+		const response = await fetchWithStepUp(`${sessionApiPath(sessionId)}/resume`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ targetSessionId })
+		});
+		const body = await response.json();
+		if (response.ok && isRecord(body) && typeof body.sessionId === "string") return { sessionId: body.sessionId };
+		return { error: isRecord(body) && typeof body.error === "string" ? body.error : `The hub answered ${response.status}.` };
+	} catch {
+		return { error: "The cockpit hub is unreachable." };
+	}
+}
+/** File paths under a session's cwd matching the query, for @ completion. */
+async function searchSessionFiles(sessionId, query) {
+	try {
+		const response = await sealedHttpSession.fetch(`${sessionApiPath(sessionId)}/plugins/files/?q=${encodeURIComponent(query)}`);
+		if (!response.ok) return [];
+		const body = await response.json();
+		return Array.isArray(body.files) ? body.files.filter((file) => typeof file === "string") : [];
+	} catch {
+		return [];
+	}
+}
+/**
+* Directories the typed path could complete to, for the new-session picker.
+* The hub lists the parent directory's children and filters them by the
+* trailing segment as a regular expression.
+*/
+async function searchDirectories(query) {
+	try {
+		const response = await sealedHttpSession.fetch(`${DIRECTORIES_API_ROUTE}?q=${encodeURIComponent(query)}`);
+		if (!response.ok) return [];
+		const body = await response.json();
+		return Array.isArray(body.directories) ? body.directories.filter((directory) => typeof directory === "string") : [];
+	} catch {
+		return [];
+	}
+}
+//#endregion
+export { admitWorkspace, createSession, createWorkspaceSession, listDirectory, listSessionHistory, listWorkspaceHistory, listWorkspaces, readDormantTranscriptPage, removeWorkspace, restartSession, resumeSession, resumeWorkspaceSession, reviveSession, searchDirectories, searchSessionFiles, stopSession };
+
+//# sourceMappingURL=hubApi.mjs.map

package/dist/web/lib/hubApi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubApi.mjs","names":[],"sources":["../../../src/web/lib/hubApi.ts"],"sourcesContent":["import type { TranscriptPage, TranscriptPageRequest } from '@agimon-ai/po-core/sessionProtocol';\nimport { sessionApiPath } from '@agimon-ai/po-core/web';\n\nimport {\n  DIRECTORIES_API_ROUTE,\n  DIRECTORY_CHILDREN_API_ROUTE,\n  WORKSPACES_API_ROUTE,\n  type DirectoryListing,\n  type PiSessionHistoryItem,\n  type SessionSummary,\n  type WorkspaceSummary,\n} from '../../types/hub';\nimport { sealedHttpSession } from './sealedSession';\nimport { fetchWithStepUp } from './stepUp';\n\nexport type CreateSessionResult = { sessionId: string; session?: SessionSummary } | { error: string };\nexport type WorkspaceResult = { workspace: WorkspaceSummary } | { error: string };\nexport type WorkspacesResult = { workspaces: WorkspaceSummary[] } | { error: string };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Lists one server folder's visible child directories for the workspace folder browser. */\nexport async function listDirectory(folder?: string): Promise<DirectoryListing | { error: string }> {\n  try {\n    const query = folder === undefined ? '' : `?path=${encodeURIComponent(folder)}`;\n    const response = await sealedHttpSession.fetch(`${DIRECTORY_CHILDREN_API_ROUTE}${query}`);\n    const body: unknown = await response.json().catch(() => undefined);\n    if (response.ok && isRecord(body) && typeof body.path === 'string' && Array.isArray(body.directories)) {\n      return {\n        path: body.path,\n        ...(typeof body.parent === 'string' ? { parent: body.parent } : {}),\n        directories: body.directories.filter((entry): entry is string => typeof entry === 'string'),\n      };\n    }\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n\nfunction asWorkspace(value: unknown): WorkspaceSummary | undefined {\n  if (!isRecord(value) || typeof value.id !== 'string' || typeof value.root !== 'string') return undefined;\n  return {\n    id: value.id,\n    root: value.root,\n    ...(typeof value.name === 'string' && value.name !== '' ? { name: value.name } : {}),\n    ...(typeof value.available === 'boolean' ? { available: value.available } : {}),\n    ...(typeof value.error === 'string' ? { error: value.error } : {}),\n  };\n}\n\nexport async function listWorkspaces(): Promise<WorkspacesResult> {\n  try {\n    const response = await sealedHttpSession.fetch(WORKSPACES_API_ROUTE);\n    const body: unknown = await response.json().catch(() => undefined);\n    if (response.ok && isRecord(body) && Array.isArray(body.workspaces)) {\n      return {\n        workspaces: body.workspaces.map(asWorkspace).filter((entry): entry is WorkspaceSummary => entry !== undefined),\n      };\n    }\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n\n/**\n * Admits a server-side repository root without starting a session. A name alone\n * asks the server to create the workspace in its default folder.\n */\nexport async function admitWorkspace(input: { root?: string; name?: string }): Promise<WorkspaceResult> {\n  try {\n    const response = await fetchWithStepUp(WORKSPACES_API_ROUTE, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(input),\n    });\n    const body: unknown = await response.json().catch(() => undefined);\n    const workspace = isRecord(body) ? asWorkspace(body.workspace) : undefined;\n    if (response.ok && workspace !== undefined) return { workspace };\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n\nexport type RemoveWorkspaceResult = { ok: true } | { error: string };\n\n/** Unregisters a workspace from Po without touching its files on disk. */\nexport async function removeWorkspace(workspaceId: string): Promise<RemoveWorkspaceResult> {\n  try {\n    const response = await sealedHttpSession.fetch(`${WORKSPACES_API_ROUTE}/${encodeURIComponent(workspaceId)}`, {\n      method: 'DELETE',\n    });\n    if (response.ok) return { ok: true };\n    const body: unknown = await response.json().catch(() => undefined);\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n\n/** Starts a session in an already admitted workspace. */\nexport async function createWorkspaceSession(\n  workspaceId: string,\n  input: { name?: string } = {},\n): Promise<CreateSessionResult> {\n  let response: Response;\n  try {\n    response = await fetchWithStepUp(`/api/workspaces/${encodeURIComponent(workspaceId)}/sessions`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ name: input.name }),\n    });\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n  const body: unknown = await response.json().catch(() => undefined);\n  if (!response.ok || !isRecord(body) || typeof body.sessionId !== 'string') {\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  }\n  const sessionId = body.sessionId;\n  try {\n    const detail = await sealedHttpSession.fetch(\n      `/api/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}`,\n    );\n    const session: unknown = await detail.json().catch(() => undefined);\n    if (detail.ok && isRecord(session) && session.id === sessionId) {\n      return { sessionId, session: session as unknown as SessionSummary };\n    }\n  } catch {\n    // The socket can still deliver the summary; this read only closes a missed-event race.\n  }\n  return { sessionId };\n}\n\n/** Compatibility flow for callers that have not admitted a workspace yet. */\nexport async function createSession(input: { cwd: string; name?: string }): Promise<CreateSessionResult> {\n  const admission = await admitWorkspace({ root: input.cwd });\n  if ('error' in admission) return admission;\n  return createWorkspaceSession(admission.workspace.id, { name: input.name });\n}\n\nexport type StopSessionResult = { ok: true } | { error: string };\n\n/** Asks the hub to stop a session's server; the rail card leaves once the server withdraws its record. */\nexport async function stopSession(sessionId: string): Promise<StopSessionResult> {\n  let response: Response;\n  try {\n    response = await sealedHttpSession.fetch(`${sessionApiPath(sessionId)}`, {\n      method: 'DELETE',\n    });\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n  if (response.ok) return { ok: true };\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    body = undefined;\n  }\n  const error = isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`;\n  return { error };\n}\n\nexport type RestartSessionResult = { ok: true } | { error: string };\n\n/**\n * Asks the hub to replace a session's server, keeping its id.\n *\n * A running server reads the composition once. Restart syncs workspace changes\n * before reopening the session, so changed extensions and APIs take effect.\n */\nexport async function restartSession(sessionId: string): Promise<RestartSessionResult> {\n  let response: Response;\n  try {\n    response = await sealedHttpSession.fetch(`${sessionApiPath(sessionId)}/restart`, {\n      method: 'POST',\n    });\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n  if (response.ok) return { ok: true };\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    body = undefined;\n  }\n  const error = isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`;\n  return { error };\n}\n\nexport type ReviveSessionResult = { ok: true } | { error: string };\n\n/**\n * Asks the hub to reopen a recorded session it has not started yet.\n *\n * Step-up gated like creating one, because it is the same act: an agent begins\n * running in a directory. The card turns live when the resulting upsert lands.\n */\nexport async function reviveSession(sessionId: string): Promise<ReviveSessionResult> {\n  let response: Response;\n  try {\n    response = await fetchWithStepUp(`${sessionApiPath(sessionId)}/revive`, { method: 'POST' });\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n  if (response.ok) return { ok: true };\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    body = undefined;\n  }\n  const error = isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`;\n  return { error };\n}\n\nexport async function readDormantTranscriptPage(\n  sessionId: string,\n  request: TranscriptPageRequest,\n  signal?: AbortSignal,\n): Promise<TranscriptPage> {\n  const params = new URLSearchParams();\n  if (request.cursor !== undefined) params.set('cursor', request.cursor);\n  if (request.direction !== undefined) params.set('direction', request.direction);\n  if (request.limit !== undefined) params.set('limit', String(request.limit));\n  const query = params.toString();\n  const response = await sealedHttpSession.fetch(\n    `${sessionApiPath(sessionId)}/transcript${query === '' ? '' : `?${query}`}`,\n    signal === undefined ? {} : { signal },\n  );\n  const body: unknown = await response.json().catch(() => undefined);\n  if (!response.ok) {\n    const message =\n      isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`;\n    throw new Error(message);\n  }\n  if (!isRecord(body) || !Array.isArray(body.entries)) throw new Error('The saved transcript response was invalid.');\n  return body as unknown as TranscriptPage;\n}\nexport type SessionHistoryResult = { sessions: PiSessionHistoryItem[] } | { error: string };\n\n/** Lists the Pi threads saved for a live session's workspace. */\nexport function listSessionHistory(sessionId: string): Promise<SessionHistoryResult> {\n  return listHistoryAt(`${sessionApiPath(sessionId)}/history`);\n}\n\nexport type ResumeSessionResult = { sessionId: string; session?: SessionSummary } | { error: string };\n\nasync function listHistoryAt(path: string): Promise<SessionHistoryResult> {\n  try {\n    const response = await sealedHttpSession.fetch(path);\n    const body = (await response.json()) as unknown;\n    if (response.ok && isRecord(body) && Array.isArray(body.sessions)) {\n      return {\n        sessions: body.sessions.filter(\n          (session): session is PiSessionHistoryItem =>\n            isRecord(session) &&\n            typeof session.id === 'string' &&\n            (session.name === undefined || typeof session.name === 'string') &&\n            typeof session.firstMessage === 'string' &&\n            typeof session.createdAt === 'string' &&\n            typeof session.updatedAt === 'string' &&\n            typeof session.messageCount === 'number',\n        ),\n      };\n    }\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n\n/** Lists saved history without requiring a live session in the workspace. */\nexport function listWorkspaceHistory(workspaceId: string): Promise<SessionHistoryResult> {\n  return listHistoryAt(`/api/workspaces/${encodeURIComponent(workspaceId)}/history`);\n}\n\n/** Starts one saved thread without replacing another live session. */\nexport async function resumeWorkspaceSession(\n  workspaceId: string,\n  targetSessionId: string,\n): Promise<ResumeSessionResult> {\n  try {\n    const response = await fetchWithStepUp(`/api/workspaces/${encodeURIComponent(workspaceId)}/resume`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ targetSessionId }),\n    });\n    const body = (await response.json()) as unknown;\n    if (!response.ok || !isRecord(body) || typeof body.sessionId !== 'string') {\n      return {\n        error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n      };\n    }\n    const sessionId = body.sessionId;\n    try {\n      const detail = await sealedHttpSession.fetch(\n        `/api/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}`,\n      );\n      const session: unknown = await detail.json().catch(() => undefined);\n      if (detail.ok && isRecord(session) && session.id === sessionId) {\n        return { sessionId, session: session as unknown as SessionSummary };\n      }\n    } catch {\n      // The socket can still deliver the summary; this read only closes a missed-event race.\n    }\n    return { sessionId };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n\n/** Replaces one live card with a selected Pi thread from the same workspace. */\nexport async function resumeSession(sessionId: string, targetSessionId: string): Promise<ResumeSessionResult> {\n  try {\n    const response = await fetchWithStepUp(`${sessionApiPath(sessionId)}/resume`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ targetSessionId }),\n    });\n    const body = (await response.json()) as unknown;\n    if (response.ok && isRecord(body) && typeof body.sessionId === 'string') return { sessionId: body.sessionId };\n    return {\n      error: isRecord(body) && typeof body.error === 'string' ? body.error : `The hub answered ${response.status}.`,\n    };\n  } catch {\n    return { error: 'The cockpit hub is unreachable.' };\n  }\n}\n/** File paths under a session's cwd matching the query, for @ completion. */\nexport async function searchSessionFiles(sessionId: string, query: string): Promise<string[]> {\n  try {\n    const response = await sealedHttpSession.fetch(\n      `${sessionApiPath(sessionId)}/plugins/files/?q=${encodeURIComponent(query)}`,\n    );\n    if (!response.ok) return [];\n    const body = (await response.json()) as { files?: unknown };\n    return Array.isArray(body.files) ? body.files.filter((file): file is string => typeof file === 'string') : [];\n  } catch {\n    return []; // Completion is a convenience; a failed lookup just shows nothing.\n  }\n}\n\n/**\n * Directories the typed path could complete to, for the new-session picker.\n * The hub lists the parent directory's children and filters them by the\n * trailing segment as a regular expression.\n */\nexport async function searchDirectories(query: string): Promise<string[]> {\n  try {\n    const response = await sealedHttpSession.fetch(`${DIRECTORIES_API_ROUTE}?q=${encodeURIComponent(query)}`);\n    if (!response.ok) return [];\n    const body = (await response.json()) as { directories?: unknown };\n    return Array.isArray(body.directories)\n      ? body.directories.filter((directory): directory is string => typeof directory === 'string')\n      : [];\n  } catch {\n    return []; // Suggestions are a convenience; a failed lookup just shows nothing.\n  }\n}\n"],"mappings":";;;;;AAmBA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,eAAsB,cAAc,QAAgE;CAClG,IAAI;EACF,MAAM,QAAQ,WAAW,KAAA,IAAY,KAAK,SAAS,mBAAmB,MAAM;EAC5E,MAAM,WAAW,MAAM,kBAAkB,MAAM,GAAG,+BAA+B,OAAO;EACxF,MAAM,OAAgB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;EACjE,IAAI,SAAS,MAAM,SAAS,IAAI,KAAK,OAAO,KAAK,SAAS,YAAY,MAAM,QAAQ,KAAK,WAAW,GAClG,OAAO;GACL,MAAM,KAAK;GACX,GAAI,OAAO,KAAK,WAAW,WAAW,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;GACjE,aAAa,KAAK,YAAY,QAAQ,UAA2B,OAAO,UAAU,QAAQ;EAC5F;EAEF,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CACF,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;AAEA,SAAS,YAAY,OAA8C;CACjE,IAAI,CAAC,SAAS,KAAK,KAAK,OAAO,MAAM,OAAO,YAAY,OAAO,MAAM,SAAS,UAAU,OAAO,KAAA;CAC/F,OAAO;EACL,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,GAAI,OAAO,MAAM,SAAS,YAAY,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;EAClF,GAAI,OAAO,MAAM,cAAc,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;EAC7E,GAAI,OAAO,MAAM,UAAU,WAAW,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;CAClE;AACF;AAEA,eAAsB,iBAA4C;CAChE,IAAI;EACF,MAAM,WAAW,MAAM,kBAAkB,MAAM,oBAAoB;EACnE,MAAM,OAAgB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;EACjE,IAAI,SAAS,MAAM,SAAS,IAAI,KAAK,MAAM,QAAQ,KAAK,UAAU,GAChE,OAAO,EACL,YAAY,KAAK,WAAW,IAAI,WAAW,CAAC,CAAC,QAAQ,UAAqC,UAAU,KAAA,CAAS,EAC/G;EAEF,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CACF,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;;;;;AAMA,eAAsB,eAAe,OAAmE;CACtG,IAAI;EACF,MAAM,WAAW,MAAM,gBAAgB,sBAAsB;GAC3D,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,KAAK;EAC5B,CAAC;EACD,MAAM,OAAgB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;EACjE,MAAM,YAAY,SAAS,IAAI,IAAI,YAAY,KAAK,SAAS,IAAI,KAAA;EACjE,IAAI,SAAS,MAAM,cAAc,KAAA,GAAW,OAAO,EAAE,UAAU;EAC/D,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CACF,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;;AAKA,eAAsB,gBAAgB,aAAqD;CACzF,IAAI;EACF,MAAM,WAAW,MAAM,kBAAkB,MAAM,GAAG,qBAAqB,GAAG,mBAAmB,WAAW,KAAK,EAC3G,QAAQ,SACV,CAAC;EACD,IAAI,SAAS,IAAI,OAAO,EAAE,IAAI,KAAK;EACnC,MAAM,OAAgB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;EACjE,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CACF,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;;AAGA,eAAsB,uBACpB,aACA,QAA2B,CAAC,GACE;CAC9B,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,gBAAgB,mBAAmB,mBAAmB,WAAW,EAAE,YAAY;GAC9F,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,EAAE,MAAM,MAAM,KAAK,CAAC;EAC3C,CAAC;CACH,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;CACA,MAAM,OAAgB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;CACjE,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,IAAI,KAAK,OAAO,KAAK,cAAc,UAC/D,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CAEF,MAAM,YAAY,KAAK;CACvB,IAAI;EACF,MAAM,SAAS,MAAM,kBAAkB,MACrC,mBAAmB,mBAAmB,WAAW,EAAE,YAAY,mBAAmB,SAAS,GAC7F;EACA,MAAM,UAAmB,MAAM,OAAO,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;EAClE,IAAI,OAAO,MAAM,SAAS,OAAO,KAAK,QAAQ,OAAO,WACnD,OAAO;GAAE;GAAoB;EAAqC;CAEtE,QAAQ,CAER;CACA,OAAO,EAAE,UAAU;AACrB;;AAGA,eAAsB,cAAc,OAAqE;CACvG,MAAM,YAAY,MAAM,eAAe,EAAE,MAAM,MAAM,IAAI,CAAC;CAC1D,IAAI,WAAW,WAAW,OAAO;CACjC,OAAO,uBAAuB,UAAU,UAAU,IAAI,EAAE,MAAM,MAAM,KAAK,CAAC;AAC5E;;AAKA,eAAsB,YAAY,WAA+C;CAC/E,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,kBAAkB,MAAM,GAAG,eAAe,SAAS,KAAK,EACvE,QAAQ,SACV,CAAC;CACH,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;CACA,IAAI,SAAS,IAAI,OAAO,EAAE,IAAI,KAAK;CACnC,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,SAAS,KAAK;CAC7B,QAAQ;EACN,OAAO,KAAA;CACT;CAEA,OAAO,EAAE,OADK,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GACnG;AACjB;;;;;;;AAUA,eAAsB,eAAe,WAAkD;CACrF,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,kBAAkB,MAAM,GAAG,eAAe,SAAS,EAAE,WAAW,EAC/E,QAAQ,OACV,CAAC;CACH,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;CACA,IAAI,SAAS,IAAI,OAAO,EAAE,IAAI,KAAK;CACnC,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,SAAS,KAAK;CAC7B,QAAQ;EACN,OAAO,KAAA;CACT;CAEA,OAAO,EAAE,OADK,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GACnG;AACjB;;;;;;;AAUA,eAAsB,cAAc,WAAiD;CACnF,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,gBAAgB,GAAG,eAAe,SAAS,EAAE,UAAU,EAAE,QAAQ,OAAO,CAAC;CAC5F,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;CACA,IAAI,SAAS,IAAI,OAAO,EAAE,IAAI,KAAK;CACnC,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,SAAS,KAAK;CAC7B,QAAQ;EACN,OAAO,KAAA;CACT;CAEA,OAAO,EAAE,OADK,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GACnG;AACjB;AAEA,eAAsB,0BACpB,WACA,SACA,QACyB;CACzB,MAAM,SAAS,IAAI,gBAAgB;CACnC,IAAI,QAAQ,WAAW,KAAA,GAAW,OAAO,IAAI,UAAU,QAAQ,MAAM;CACrE,IAAI,QAAQ,cAAc,KAAA,GAAW,OAAO,IAAI,aAAa,QAAQ,SAAS;CAC9E,IAAI,QAAQ,UAAU,KAAA,GAAW,OAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;CAC1E,MAAM,QAAQ,OAAO,SAAS;CAC9B,MAAM,WAAW,MAAM,kBAAkB,MACvC,GAAG,eAAe,SAAS,EAAE,aAAa,UAAU,KAAK,KAAK,IAAI,WAClE,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,CACvC;CACA,MAAM,OAAgB,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;CACjE,IAAI,CAAC,SAAS,IAAI;EAChB,MAAM,UACJ,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO;EACtG,MAAM,IAAI,MAAM,OAAO;CACzB;CACA,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,QAAQ,KAAK,OAAO,GAAG,MAAM,IAAI,MAAM,4CAA4C;CACjH,OAAO;AACT;;AAIA,SAAgB,mBAAmB,WAAkD;CACnF,OAAO,cAAc,GAAG,eAAe,SAAS,EAAE,SAAS;AAC7D;AAIA,eAAe,cAAc,MAA6C;CACxE,IAAI;EACF,MAAM,WAAW,MAAM,kBAAkB,MAAM,IAAI;EACnD,MAAM,OAAQ,MAAM,SAAS,KAAK;EAClC,IAAI,SAAS,MAAM,SAAS,IAAI,KAAK,MAAM,QAAQ,KAAK,QAAQ,GAC9D,OAAO,EACL,UAAU,KAAK,SAAS,QACrB,YACC,SAAS,OAAO,KAChB,OAAO,QAAQ,OAAO,aACrB,QAAQ,SAAS,KAAA,KAAa,OAAO,QAAQ,SAAS,aACvD,OAAO,QAAQ,iBAAiB,YAChC,OAAO,QAAQ,cAAc,YAC7B,OAAO,QAAQ,cAAc,YAC7B,OAAO,QAAQ,iBAAiB,QACpC,EACF;EAEF,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CACF,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;;AAGA,SAAgB,qBAAqB,aAAoD;CACvF,OAAO,cAAc,mBAAmB,mBAAmB,WAAW,EAAE,SAAS;AACnF;;AAGA,eAAsB,uBACpB,aACA,iBAC8B;CAC9B,IAAI;EACF,MAAM,WAAW,MAAM,gBAAgB,mBAAmB,mBAAmB,WAAW,EAAE,UAAU;GAClG,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,EAAE,gBAAgB,CAAC;EAC1C,CAAC;EACD,MAAM,OAAQ,MAAM,SAAS,KAAK;EAClC,IAAI,CAAC,SAAS,MAAM,CAAC,SAAS,IAAI,KAAK,OAAO,KAAK,cAAc,UAC/D,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;EAEF,MAAM,YAAY,KAAK;EACvB,IAAI;GACF,MAAM,SAAS,MAAM,kBAAkB,MACrC,mBAAmB,mBAAmB,WAAW,EAAE,YAAY,mBAAmB,SAAS,GAC7F;GACA,MAAM,UAAmB,MAAM,OAAO,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS;GAClE,IAAI,OAAO,MAAM,SAAS,OAAO,KAAK,QAAQ,OAAO,WACnD,OAAO;IAAE;IAAoB;GAAqC;EAEtE,QAAQ,CAER;EACA,OAAO,EAAE,UAAU;CACrB,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;;AAGA,eAAsB,cAAc,WAAmB,iBAAuD;CAC5G,IAAI;EACF,MAAM,WAAW,MAAM,gBAAgB,GAAG,eAAe,SAAS,EAAE,UAAU;GAC5E,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,EAAE,gBAAgB,CAAC;EAC1C,CAAC;EACD,MAAM,OAAQ,MAAM,SAAS,KAAK;EAClC,IAAI,SAAS,MAAM,SAAS,IAAI,KAAK,OAAO,KAAK,cAAc,UAAU,OAAO,EAAE,WAAW,KAAK,UAAU;EAC5G,OAAO,EACL,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,oBAAoB,SAAS,OAAO,GAC7G;CACF,QAAQ;EACN,OAAO,EAAE,OAAO,kCAAkC;CACpD;AACF;;AAEA,eAAsB,mBAAmB,WAAmB,OAAkC;CAC5F,IAAI;EACF,MAAM,WAAW,MAAM,kBAAkB,MACvC,GAAG,eAAe,SAAS,EAAE,oBAAoB,mBAAmB,KAAK,GAC3E;EACA,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;EAC1B,MAAM,OAAQ,MAAM,SAAS,KAAK;EAClC,OAAO,MAAM,QAAQ,KAAK,KAAK,IAAI,KAAK,MAAM,QAAQ,SAAyB,OAAO,SAAS,QAAQ,IAAI,CAAC;CAC9G,QAAQ;EACN,OAAO,CAAC;CACV;AACF;;;;;;AAOA,eAAsB,kBAAkB,OAAkC;CACxE,IAAI;EACF,MAAM,WAAW,MAAM,kBAAkB,MAAM,GAAG,sBAAsB,KAAK,mBAAmB,KAAK,GAAG;EACxG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;EAC1B,MAAM,OAAQ,MAAM,SAAS,KAAK;EAClC,OAAO,MAAM,QAAQ,KAAK,WAAW,IACjC,KAAK,YAAY,QAAQ,cAAmC,OAAO,cAAc,QAAQ,IACzF,CAAC;CACP,QAAQ;EACN,OAAO,CAAC;CACV;AACF"}

package/dist/web/lib/leaderTree.cjs

@@ -0,0 +1,150 @@
+//#region src/web/lib/leaderTree.ts
+const ROOT_LABEL = "leader";
+/**
+* Inserts one binding the way the TUI registry does: a group segment keeps
+* the label of whoever registered it first (adopting a detail if it had
+* none), and a leaf that is already bound is taken over by the newcomer,
+* along with any group that stood where the leaf now goes.
+*/
+function insert(root, binding) {
+	let current = root;
+	for (const [index, segment] of binding.path.entries()) {
+		const isLeaf = index === binding.path.length - 1;
+		let node = current.children.get(segment.key);
+		if (!node) {
+			node = {
+				key: segment.key,
+				label: segment.label,
+				detail: segment.detail ?? "",
+				children: /* @__PURE__ */ new Map()
+			};
+			current.children.set(segment.key, node);
+		} else if (!node.detail && segment.detail) node.detail = segment.detail;
+		if (isLeaf) {
+			node.children.clear();
+			node.binding = binding;
+			node.label = segment.label;
+			node.detail = segment.detail ?? "";
+		} else if (node.binding) delete node.binding;
+		current = node;
+	}
+}
+function leavesUnder(node) {
+	const leaves = [];
+	if (node.binding) leaves.push(node.binding);
+	for (const child of node.children.values()) leaves.push(...leavesUnder(child));
+	return leaves;
+}
+/**
+* Every place `insert` would silently prefer one binding over another, in
+* the same order insert walks them: a leaf landing on a bound leaf or over a
+* group displaces those bindings, a group segment crossing a bound leaf
+* displaces it, and a group segment worded differently from the first namer
+* keeps the first wording.
+*/
+function leaderConflicts(bindings) {
+	const conflicts = [];
+	const root = {
+		key: "",
+		label: ROOT_LABEL,
+		detail: "",
+		children: /* @__PURE__ */ new Map()
+	};
+	const namers = /* @__PURE__ */ new Map();
+	for (const binding of bindings) {
+		let current = root;
+		const keys = [];
+		for (const [index, segment] of binding.path.entries()) {
+			keys.push(segment.key);
+			const path = keys.join(" ");
+			const isLeaf = index === binding.path.length - 1;
+			let node = current.children.get(segment.key);
+			if (node) {
+				if (isLeaf) {
+					for (const loser of leavesUnder(node)) if (loser !== binding) conflicts.push({
+						kind: "leaf-override",
+						path,
+						winner: binding,
+						loser
+					});
+				} else {
+					if (node.binding && node.binding !== binding) conflicts.push({
+						kind: "leaf-override",
+						path,
+						winner: binding,
+						loser: node.binding
+					});
+					const namer = namers.get(node);
+					if (namer !== void 0 && namer !== binding && node.label !== segment.label) conflicts.push({
+						kind: "group-label",
+						path,
+						winner: namer,
+						loser: binding
+					});
+				}
+			} else {
+				node = {
+					key: segment.key,
+					label: segment.label,
+					detail: "",
+					children: /* @__PURE__ */ new Map()
+				};
+				current.children.set(segment.key, node);
+				namers.set(node, binding);
+			}
+			if (isLeaf) {
+				node.children.clear();
+				node.binding = binding;
+				node.label = segment.label;
+				namers.set(node, binding);
+			} else if (node.binding) delete node.binding;
+			current = node;
+		}
+	}
+	return conflicts;
+}
+function toOption(node) {
+	const children = [...node.children.values()].sort((left, right) => left.key.localeCompare(right.key)).map((child) => ({
+		key: child.key,
+		label: child.label,
+		detail: child.detail,
+		children: []
+	}));
+	return {
+		key: node.key,
+		label: node.label,
+		detail: node.detail,
+		...node.binding ? { binding: node.binding } : {},
+		children
+	};
+}
+/**
+* The options one level of Leader Space offers, keyed by what the reader
+* would press, sorted by key. Undefined when the path runs off the tree or
+* lands on a leaf, which is how the palette knows a path is no longer a group.
+*/
+function leaderGroup(bindings, path) {
+	const root = {
+		key: "",
+		label: ROOT_LABEL,
+		detail: "",
+		children: /* @__PURE__ */ new Map()
+	};
+	for (const binding of bindings) insert(root, binding);
+	let current = root;
+	for (const key of path) {
+		const next = current.children.get(key);
+		if (!next || next.binding) return void 0;
+		current = next;
+	}
+	const options = [...current.children.values()].sort((left, right) => left.key.localeCompare(right.key)).map(toOption);
+	return {
+		label: current.label,
+		options
+	};
+}
+//#endregion
+exports.leaderConflicts = leaderConflicts;
+exports.leaderGroup = leaderGroup;
+
+//# sourceMappingURL=leaderTree.cjs.map

package/dist/web/lib/leaderTree.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderTree.cjs","names":[],"sources":["../../../src/web/lib/leaderTree.ts"],"sourcesContent":["import type { LeaderBindingContribution } from '@agimon-ai/po-core/web';\n\nexport interface LeaderOption {\n  key: string;\n  label: string;\n  detail: string;\n  /** A group opens the next level; a leaf carries the binding that fires. */\n  binding?: LeaderBindingContribution;\n  /** The keys one level down, for a group's preview; empty for a leaf. */\n  children: LeaderOption[];\n}\n\nexport interface LeaderGroup {\n  /** The label of the segment that opened this level; 'leader' at the root. */\n  label: string;\n  options: LeaderOption[];\n}\n\ninterface LeaderNode {\n  key: string;\n  label: string;\n  detail: string;\n  binding?: LeaderBindingContribution;\n  children: Map<string, LeaderNode>;\n}\n\nconst ROOT_LABEL = 'leader';\n\n/**\n * Inserts one binding the way the TUI registry does: a group segment keeps\n * the label of whoever registered it first (adopting a detail if it had\n * none), and a leaf that is already bound is taken over by the newcomer,\n * along with any group that stood where the leaf now goes.\n */\nfunction insert(root: LeaderNode, binding: LeaderBindingContribution): void {\n  let current = root;\n  for (const [index, segment] of binding.path.entries()) {\n    const isLeaf = index === binding.path.length - 1;\n    let node = current.children.get(segment.key);\n    if (!node) {\n      node = { key: segment.key, label: segment.label, detail: segment.detail ?? '', children: new Map() };\n      current.children.set(segment.key, node);\n    } else if (!node.detail && segment.detail) {\n      node.detail = segment.detail;\n    }\n    if (isLeaf) {\n      node.children.clear();\n      node.binding = binding;\n      node.label = segment.label;\n      node.detail = segment.detail ?? '';\n    } else if (node.binding) {\n      delete node.binding;\n    }\n    current = node;\n  }\n}\n\nexport interface LeaderConflict {\n  /** A later binding took a bound leaf (or a whole group) over, or a group segment was worded differently. */\n  kind: 'leaf-override' | 'group-label';\n  /** The keys of the contested segment, space separated. */\n  path: string;\n  /** The binding the tree keeps: the later one for a leaf, the first namer for a group label. */\n  winner: LeaderBindingContribution;\n  loser: LeaderBindingContribution;\n}\n\nfunction leavesUnder(node: LeaderNode): LeaderBindingContribution[] {\n  const leaves: LeaderBindingContribution[] = [];\n  if (node.binding) leaves.push(node.binding);\n  for (const child of node.children.values()) leaves.push(...leavesUnder(child));\n  return leaves;\n}\n\n/**\n * Every place `insert` would silently prefer one binding over another, in\n * the same order insert walks them: a leaf landing on a bound leaf or over a\n * group displaces those bindings, a group segment crossing a bound leaf\n * displaces it, and a group segment worded differently from the first namer\n * keeps the first wording.\n */\nexport function leaderConflicts(bindings: readonly LeaderBindingContribution[]): LeaderConflict[] {\n  const conflicts: LeaderConflict[] = [];\n  const root: LeaderNode = { key: '', label: ROOT_LABEL, detail: '', children: new Map() };\n  const namers = new Map<LeaderNode, LeaderBindingContribution>();\n  for (const binding of bindings) {\n    let current = root;\n    const keys: string[] = [];\n    for (const [index, segment] of binding.path.entries()) {\n      keys.push(segment.key);\n      const path = keys.join(' ');\n      const isLeaf = index === binding.path.length - 1;\n      let node = current.children.get(segment.key);\n      if (node) {\n        if (isLeaf) {\n          for (const loser of leavesUnder(node)) {\n            if (loser !== binding) conflicts.push({ kind: 'leaf-override', path, winner: binding, loser });\n          }\n        } else {\n          if (node.binding && node.binding !== binding) {\n            conflicts.push({ kind: 'leaf-override', path, winner: binding, loser: node.binding });\n          }\n          const namer = namers.get(node);\n          if (namer !== undefined && namer !== binding && node.label !== segment.label) {\n            conflicts.push({ kind: 'group-label', path, winner: namer, loser: binding });\n          }\n        }\n      } else {\n        node = { key: segment.key, label: segment.label, detail: '', children: new Map() };\n        current.children.set(segment.key, node);\n        namers.set(node, binding);\n      }\n      if (isLeaf) {\n        node.children.clear();\n        node.binding = binding;\n        node.label = segment.label;\n        namers.set(node, binding);\n      } else if (node.binding) {\n        delete node.binding;\n      }\n      current = node;\n    }\n  }\n  return conflicts;\n}\n\nfunction toOption(node: LeaderNode): LeaderOption {\n  const children = [...node.children.values()]\n    .sort((left, right) => left.key.localeCompare(right.key))\n    .map((child) => ({ key: child.key, label: child.label, detail: child.detail, children: [] }));\n  return {\n    key: node.key,\n    label: node.label,\n    detail: node.detail,\n    ...(node.binding ? { binding: node.binding } : {}),\n    children,\n  };\n}\n\n/**\n * The options one level of Leader Space offers, keyed by what the reader\n * would press, sorted by key. Undefined when the path runs off the tree or\n * lands on a leaf, which is how the palette knows a path is no longer a group.\n */\nexport function leaderGroup(\n  bindings: readonly LeaderBindingContribution[],\n  path: readonly string[],\n): LeaderGroup | undefined {\n  const root: LeaderNode = { key: '', label: ROOT_LABEL, detail: '', children: new Map() };\n  for (const binding of bindings) insert(root, binding);\n  let current = root;\n  for (const key of path) {\n    const next = current.children.get(key);\n    if (!next || next.binding) return undefined;\n    current = next;\n  }\n  const options = [...current.children.values()].sort((left, right) => left.key.localeCompare(right.key)).map(toOption);\n  return { label: current.label, options };\n}\n"],"mappings":"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"}

package/dist/web/lib/leaderTree.d.mts

@@ -0,0 +1,41 @@
+import { LeaderBindingContribution } from "@agimon-ai/po-core/web";
+//#region src/web/lib/leaderTree.d.ts
+export interface LeaderOption {
+  key: string;
+  label: string;
+  detail: string;
+  /** A group opens the next level; a leaf carries the binding that fires. */
+  binding?: LeaderBindingContribution;
+  /** The keys one level down, for a group's preview; empty for a leaf. */
+  children: LeaderOption[];
+}
+export interface LeaderGroup {
+  /** The label of the segment that opened this level; 'leader' at the root. */
+  label: string;
+  options: LeaderOption[];
+}
+export interface LeaderConflict {
+  /** A later binding took a bound leaf (or a whole group) over, or a group segment was worded differently. */
+  kind: 'leaf-override' | 'group-label';
+  /** The keys of the contested segment, space separated. */
+  path: string;
+  /** The binding the tree keeps: the later one for a leaf, the first namer for a group label. */
+  winner: LeaderBindingContribution;
+  loser: LeaderBindingContribution;
+}
+/**
+ * Every place `insert` would silently prefer one binding over another, in
+ * the same order insert walks them: a leaf landing on a bound leaf or over a
+ * group displaces those bindings, a group segment crossing a bound leaf
+ * displaces it, and a group segment worded differently from the first namer
+ * keeps the first wording.
+ */
+export declare function leaderConflicts(bindings: readonly LeaderBindingContribution[]): LeaderConflict[];
+/**
+ * The options one level of Leader Space offers, keyed by what the reader
+ * would press, sorted by key. Undefined when the path runs off the tree or
+ * lands on a leaf, which is how the palette knows a path is no longer a group.
+ */
+export declare function leaderGroup(bindings: readonly LeaderBindingContribution[], path: readonly string[]): LeaderGroup | undefined;
+//#endregion
+//# sourceMappingURL=leaderTree.d.mts.map

package/dist/web/lib/leaderTree.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderTree.d.mts","names":[],"sources":["../../../src/web/lib/leaderTree.ts"],"mappings":";;iBAEiB;EACf;EACA;EACA;;EAEA,UAAU;;EAEV,UAAU;;iBAGK;;EAEf;EACA,SAAS;;iBA0CM;;EAEf;;EAEA;;EAEA,QAAQ;EACR,OAAO;;;;;;;;;wBAiBO,gBAAgB,mBAAmB,8BAA8B;;;;;;wBA+DjE,YACd,mBAAmB,6BACnB,0BACC"}