zidane-ui 9.1.13 → 9.1.16

package/dist/git/ImportRepoDialog.js

@@ -1,5 +1,7 @@
 import { buttonClass } from "../components/button.js";
+import { Notice } from "../components/Notice.js";
 import { MetaChip } from "../components/Form.js";
+import { errorMessage } from "../components/report-error.js";
 import { compactPath } from "../path.js";
 import { useDisplayPath } from "../hooks/useDisplayPath.js";
 import { gitErrorText } from "./headless/labels.js";
@@ -71,9 +73,12 @@ function ImportRepoDialog({ clone, initialParent, pickFolder, hostId, onDone, on
 		try {
 			const result = await clone.clone(input, parent);
 			if (result.ok) onDone(result.path);
-			else if (!("cancelled" in result)) setError(gitErrorText(result.error, labels));
+			else if (!("cancelled" in result)) setError({ message: gitErrorText(result.error, labels) });
 		} catch (err) {
-			setError(err instanceof Error ? err.message : String(err));
+			setError({
+				message: labels.gitImportFailed,
+				detail: errorMessage(err)
+			});
 		} finally {
 			setCloning(false);
 		}
@@ -133,10 +138,14 @@ function ImportRepoDialog({ clone, initialParent, pickFolder, hostId, onDone, on
 							"aria-invalid": invalid || void 0,
 							className: "zg-well w-full h-8 px-2.5 font-mono text-zg-label placeholder:text-[var(--zg-text-subtle)] disabled:opacity-zg-disabled"
 						}),
-						/* @__PURE__ */ jsx("span", {
-							className: `zg-meta min-h-4 truncate ${invalid ? "!text-zg-danger" : ""}`,
+						invalid ? /* @__PURE__ */ jsx(Notice, {
+							tone: "error",
+							compact: true,
+							children: labels.gitImportInvalid
+						}) : /* @__PURE__ */ jsx("span", {
+							className: "zg-meta min-h-4 truncate",
 							"aria-live": "polite",
-							children: invalid ? labels.gitImportInvalid : spec ? labels.gitImportPreview(spec.label, spec.branch, compactPath(display.path(joinPath(parent, spec.name), hostId), 44)) : ""
+							children: spec ? labels.gitImportPreview(spec.label, spec.branch, compactPath(display.path(joinPath(parent, spec.name), hostId), 44)) : ""
 						})
 					]
 				}),
@@ -182,10 +191,10 @@ function ImportRepoDialog({ clone, initialParent, pickFolder, hostId, onDone, on
 						children: progress ? labels.gitImportProgress(progress.phase, progress.percent) : labels.gitImportConnecting
 					})]
 				}),
-				error && /* @__PURE__ */ jsx("div", {
-					role: "alert",
-					className: "text-zg-label leading-relaxed text-zg-danger zg-pretty",
-					children: error
+				error && /* @__PURE__ */ jsx(Notice, {
+					tone: "error",
+					...error.detail ? { detail: error.detail } : {},
+					children: error.message
 				}),
 				/* @__PURE__ */ jsx("button", {
 					type: "submit",

package/dist/git/MoveSessionDialog.js

@@ -1,5 +1,7 @@
 import { buttonClass } from "../components/button.js";
+import { Notice } from "../components/Notice.js";
 import { Checkbox, MetaChip } from "../components/Form.js";
+import { errorMessage } from "../components/report-error.js";
 import { MenuNote, MenuRow } from "../components/Menu.js";
 import { compactPath } from "../path.js";
 import { useDisplayPath } from "../hooks/useDisplayPath.js";
@@ -77,7 +79,10 @@ function MoveSessionDialog({ subject, onDone, onCancel, className, style }) {
 		}).catch((err) => {
 			if (!live) return;
 			setChoices([]);
-			setError(err instanceof Error ? err.message : String(err));
+			setError({
+				message: labels.gitMoveListFailed,
+				detail: errorMessage(err)
+			});
 		});
 		return () => {
 			live = false;
@@ -120,11 +125,14 @@ function MoveSessionDialog({ subject, onDone, onCancel, className, style }) {
 				...folder !== null ? { cwd: folder } : {},
 				...offersRemoval && removeWorktree ? { removeOldWorktree: true } : {}
 			});
-			if (!result.ok) setError(gitErrorText(result.error, labels));
+			if (!result.ok) setError({ message: gitErrorText(result.error, labels) });
 			else if (result.oldWorktree?.removed === false) setKept(result.oldWorktree.reason !== void 0 ? { reason: result.oldWorktree.reason } : {});
 			else onDone();
 		} catch (err) {
-			setError(err instanceof Error ? err.message : String(err));
+			setError({
+				message: labels.gitMoveFailed,
+				detail: errorMessage(err)
+			});
 		} finally {
 			setMoving(false);
 		}
@@ -245,10 +253,10 @@ function MoveSessionDialog({ subject, onDone, onCancel, className, style }) {
 					"data-testid": "move-worktree-kept",
 					children: labels.gitMoveWorktreeKept(kept.reason)
 				}),
-				error && /* @__PURE__ */ jsx("div", {
-					role: "alert",
-					className: "text-zg-label leading-relaxed text-zg-danger zg-pretty",
-					children: error
+				error && /* @__PURE__ */ jsx(Notice, {
+					tone: "error",
+					...error.detail ? { detail: error.detail } : {},
+					children: error.message
 				})
 			]
 		}), /* @__PURE__ */ jsx("footer", {

package/dist/git/RemoteFolderPicker.js

@@ -1,4 +1,6 @@
 import { IconButton } from "../components/IconButton.js";
+import { Notice } from "../components/Notice.js";
+import { errorMessage } from "../components/report-error.js";
 import { Menu, MenuNote, MenuRow, MenuSection, MenuSeparator, focusMenuRow } from "../components/Menu.js";
 import { Popover } from "../components/floating/Popover.js";
 import { folderName } from "./headless/environment.js";
@@ -132,9 +134,12 @@ function RemoteFolderBrowser({ hostId, machineId, start, onUse, className, style
 		}).then((result) => {
 			if (cancelled) return;
 			if (result.ok) setListing(result.listing);
-			else setError(gitErrorText(result.error, labels));
+			else setError({ message: gitErrorText(result.error, labels) });
 		}).catch((err) => {
-			if (!cancelled) setError(err instanceof Error ? err.message : String(err));
+			if (!cancelled) setError({
+				message: labels.gitFolderListFailed,
+				detail: errorMessage(err)
+			});
 		});
 		return () => {
 			cancelled = true;
@@ -148,9 +153,12 @@ function RemoteFolderBrowser({ hostId, machineId, start, onUse, className, style
 	if (!list) return null;
 	if (error) return /* @__PURE__ */ jsxs(Menu, {
 		...menuProps,
-		children: [/* @__PURE__ */ jsx(MenuNote, {
-			icon: "i-ph-warning",
-			children: error
+		children: [/* @__PURE__ */ jsx(Notice, {
+			tone: "error",
+			compact: true,
+			className: "m-1",
+			...error.detail ? { detail: error.detail } : {},
+			children: error.message
 		}), path !== null && /* @__PURE__ */ jsx(MenuRow, {
 			role: "menuitem",
 			icon: /* @__PURE__ */ jsx("span", {
@@ -192,13 +200,16 @@ function RemoteFolderBrowser({ hostId, machineId, start, onUse, className, style
 			} : {
 				query,
 				state: "failed",
-				error: gitErrorText(result.error, labels)
+				error: { message: gitErrorText(result.error, labels) }
 			});
 		}).catch((err) => {
 			setSearch((current) => current?.query !== query ? current : {
 				query,
 				state: "failed",
-				error: err instanceof Error ? err.message : String(err)
+				error: {
+					message: labels.gitFolderSearchFailed,
+					detail: errorMessage(err)
+				}
 			});
 		});
 	};
@@ -226,8 +237,11 @@ function RemoteFolderBrowser({ hostId, machineId, start, onUse, className, style
 			name
 		}).then((result) => {
 			if (result.ok) open(result.folder.path);
-			else setCreateError(gitErrorText(result.error, labels));
-		}).catch((err) => setCreateError(err instanceof Error ? err.message : String(err))).finally(() => setCreating(false));
+			else setCreateError({ message: gitErrorText(result.error, labels) });
+		}).catch((err) => setCreateError({
+			message: labels.gitFolderCreateFailed,
+			detail: errorMessage(err)
+		})).finally(() => setCreating(false));
 	};
 	const crumbs = crumbsOf(listing);
 	return /* @__PURE__ */ jsxs(Menu, {
@@ -332,9 +346,12 @@ function RemoteFolderBrowser({ hostId, machineId, start, onUse, className, style
 						label: labels.gitFolderSearchResults,
 						children: [
 							search.state === "running" && /* @__PURE__ */ jsx(MenuNote, { children: labels.gitFolderSearching }),
-							search.state === "failed" && /* @__PURE__ */ jsx(MenuNote, {
-								icon: "i-ph-warning",
-								children: search.error
+							search.state === "failed" && /* @__PURE__ */ jsx(Notice, {
+								tone: "error",
+								compact: true,
+								className: "m-1",
+								...search.error.detail ? { detail: search.error.detail } : {},
+								children: search.error.message
 							}),
 							search.state === "done" && /* @__PURE__ */ jsxs(Fragment, { children: [
 								search.results.map((dir) => /* @__PURE__ */ jsx(MenuRow, {
@@ -405,10 +422,11 @@ function RemoteFolderBrowser({ hostId, machineId, start, onUse, className, style
 							}
 						})
 					]
-				}), createError && /* @__PURE__ */ jsx("span", {
-					role: "alert",
-					className: "text-xs text-[var(--zg-danger)] px-1",
-					children: createError
+				}), createError && /* @__PURE__ */ jsx(Notice, {
+					tone: "error",
+					compact: true,
+					...createError.detail ? { detail: createError.detail } : {},
+					children: createError.message
 				})]
 			})),
 			/* @__PURE__ */ jsx(MenuSeparator, {}),

package/dist/git/SyncChip.js

@@ -1,5 +1,7 @@
 import { BTN_SECONDARY, buttonClass } from "../components/button.js";
+import { Notice } from "../components/Notice.js";
 import { Tooltip } from "../components/Tooltip.js";
+import { errorMessage } from "../components/report-error.js";
 import { FloatingSurface } from "../components/floating/FloatingSurface.js";
 import { RollingText } from "../motion/roll.js";
 import { gitErrorText } from "./headless/labels.js";
@@ -76,14 +78,15 @@ function SyncChip({ status, cwd, sessionId, running, onSynced, confirm = true, o
 		if (dontAsk) onConfirmChange?.(false);
 		setBusy(true);
 		try {
-			const result = await host.sync(cwd, sessionId).catch((err) => ({
-				ok: false,
-				error: {
-					code: "failed",
-					message: err instanceof Error ? err.message : String(err)
-				}
-			}));
-			if (!result.ok) setPopover({
+			const result = await host.sync(cwd, sessionId).catch((err) => {
+				setPopover({
+					kind: "error",
+					message: labels.gitSyncFailed,
+					detail: errorMessage(err)
+				});
+				return null;
+			});
+			if (result && !result.ok) setPopover({
 				kind: "error",
 				message: gitErrorText(result.error, labels)
 			});
@@ -218,17 +221,14 @@ function SyncChip({ status, cwd, sessionId, running, onSynced, confirm = true, o
 						})
 					]
 				})]
-			}), popover?.kind === "error" && /* @__PURE__ */ jsxs("div", {
-				role: "alert",
+			}), popover?.kind === "error" && /* @__PURE__ */ jsx("div", {
 				"data-testid": "git-sync-error",
-				className: "flex items-start gap-2 p-3 text-zg-label leading-[1.45] text-[var(--zg-text)]",
-				children: [/* @__PURE__ */ jsx("span", {
-					"aria-hidden": true,
-					className: "i-ph-warning text-zg-ui shrink-0 mt-[2px] text-zg-danger"
-				}), /* @__PURE__ */ jsx("span", {
-					className: "min-w-0 zg-pretty",
+				className: "p-1.5",
+				children: /* @__PURE__ */ jsx(Notice, {
+					tone: "error",
+					...popover.detail ? { detail: popover.detail } : {},
 					children: popover.message
-				})]
+				})
 			})]
 		})]
 	});

package/dist/git/WherePicker.d.ts

@@ -1,5 +1,5 @@
 import { HostView } from "../chat/headless/hosts.js";
-import { DraftEnvironment } from "./headless/environment.js";
+import { DraftEnvironment, EnvironmentMachine } from "./headless/environment.js";
 import { CSSProperties } from "react";
 import { EnvironmentDescriptor } from "zidane/chat";
 //#region src/git/WherePicker.d.ts
@@ -19,6 +19,21 @@ interface WhereMenuProps {
   onChange: (next: DraftEnvironment) => void;
   /** Machine names not to list (servers this computer also uses as machines, shown as servers). */
   hiddenMachines?: ReadonlySet<string>;
+  /** The machines of the other hosts, by host id. Absent: only the draft host's machines show. */
+  serverMachines?: ReadonlyMap<string, readonly EnvironmentMachine[]>;
+  /** Called with a machine of another host (from {@link WhereMenuProps.serverMachines}): the draft moves there. */
+  onPickServerMachine?: (hostId: string, machine: EnvironmentMachine) => void;
+  /** Opens Add a machine for a server. Absent: no Add a machine row. */
+  onAddMachine?: (hostId: string) => void;
+  /**
+   * "Use for new chats": whether the draft's place is where new chats start now, the space whose default it sets
+   * (absent: the global one), and what a pick does (set it, or clear it when it is the default). Absent: no row.
+   */
+  newChatsDefault?: {
+    isDefault: boolean;
+    space?: string;
+    onToggle: () => void;
+  };
   /** Opens the environment settings. Absent: no settings row. */
   onOpenSettings?: () => void;
   /** Called after a pick that ends the choice (the popover closes). */

package/dist/git/WherePicker.js

@@ -7,7 +7,7 @@ import { useGitLabels } from "./GitProvider.js";
 import { hostReachable, hostStatusLabel } from "../chat/headless/hosts.js";
 import { HostBadge } from "../chat/HostBadge.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useRef } from "react";
+import { Fragment as Fragment$1, useRef } from "react";
 import { isolationLabel, parseMachineKind } from "zidane/chat/pure";
 //#region src/git/WherePicker.tsx
 /**
@@ -15,10 +15,13 @@ import { isolationLabel, parseMachineKind } from "zidane/chat/pure";
 * in one place:
 *
 * - **Runs on**: this computer, a saved server (the session lives there and
-*   keeps running with the app closed), or a machine shared with the draft's
-*   host (the session stays on the host, the files and commands are on the
-*   machine). A server this computer also uses as a machine shows once, as
-*   the server (`hiddenMachines`).
+*   keeps running with the app closed), or a machine of one of them (the
+*   session stays on that host, the files and commands are on the machine).
+*   Each host's machines sit under it: the draft host's from its kinds, the
+*   other servers' from `serverMachines`, so one pick moves the draft to a
+*   machine of any server. An offline machine stays pickable (the chat waits
+*   for it). A server this computer also uses as a machine shows once, as the
+*   server (`hiddenMachines`).
 * - **Isolation** on that place: in the folder, a new worktree (with its
 *   branch), or a sandbox kind the host offers (Docker, E2B, Daytona…).
 *
@@ -100,7 +103,7 @@ function RunsOnHelp({ labels }) {
 * @param props - Component props.
 */
 function WhereMenu(props) {
-	const { hosts, hostId, onHostChange, descriptors, onChange, onOpenSettings, onClose, className, style } = props;
+	const { hosts, hostId, onHostChange, descriptors, onChange, onOpenSettings, onClose, serverMachines, onPickServerMachine, onAddMachine, newChatsDefault, className, style } = props;
 	const labels = useGitLabels();
 	const branchRef = useRef(null);
 	const { host, machines, selected, machine, isolations, typedBranch } = resolveWhere(props);
@@ -114,7 +117,12 @@ function WhereMenu(props) {
 		});
 		close();
 	};
-	const pickMachine = (next) => {
+	const pickMachine = (owner, next) => {
+		if (owner.id !== host.id) {
+			onPickServerMachine?.(owner.id, next);
+			close();
+			return;
+		}
 		const own = descriptors.filter((d) => d.machine?.id === next.id && d.enabled && d.available);
 		const kind = (own.find((d) => parseMachineKind(d.kind)?.base === "local") ?? own[0])?.kind;
 		if (kind) onChange({
@@ -123,6 +131,7 @@ function WhereMenu(props) {
 		});
 		close();
 	};
+	const machinesUnder = (h) => h.id === host.id ? machines : onPickServerMachine && hostReachable(h) ? serverMachines?.get(h.id) ?? [] : [];
 	return /* @__PURE__ */ jsxs("div", {
 		role: "group",
 		"aria-label": labels.gitWhereLabel,
@@ -146,38 +155,54 @@ function WhereMenu(props) {
 						className: "i-ph-question text-zg-label text-[var(--zg-text-subtle)] hover:text-[var(--zg-text-muted)] cursor-help outline-none focus-visible:text-[var(--zg-text)]"
 					})
 				}),
-				children: /* @__PURE__ */ jsxs("div", {
+				children: /* @__PURE__ */ jsx("div", {
 					role: "menu",
 					"aria-label": labels.gitRunsOn,
-					children: [hosts.map((h) => /* @__PURE__ */ jsx(MenuRow, {
-						size: "lg",
-						role: "menuitemradio",
-						checked: !machine && h.id === host.id,
-						disabled: !hostReachable(h),
-						icon: /* @__PURE__ */ jsx("span", {
-							"aria-hidden": true,
-							className: placeIcon(h.kind)
-						}),
-						title: /* @__PURE__ */ jsx(HostBadge, { host: h }),
-						description: h.kind === "local" ? labels.gitHostLocalDescription : hostReachable(h) ? labels.gitHostServerDescription : hostStatusLabel(h),
-						onClick: () => pickHost(h)
-					}, h.id)), machines.map((m) => /* @__PURE__ */ jsx(MenuRow, {
-						size: "lg",
-						role: "menuitemradio",
-						checked: machine?.id === m.id,
-						disabled: m.status !== "online",
-						icon: /* @__PURE__ */ jsx("span", {
-							"aria-hidden": true,
-							className: placeIcon("machine")
+					children: hosts.map((h) => /* @__PURE__ */ jsxs(Fragment$1, { children: [
+						/* @__PURE__ */ jsx(MenuRow, {
+							size: "lg",
+							role: "menuitemradio",
+							checked: !machine && h.id === host.id,
+							disabled: !hostReachable(h),
+							icon: /* @__PURE__ */ jsx("span", {
+								"aria-hidden": true,
+								className: placeIcon(h.kind)
+							}),
+							title: /* @__PURE__ */ jsx(HostBadge, { host: h }),
+							description: h.kind === "local" ? labels.gitHostLocalDescription : hostReachable(h) ? labels.gitHostServerDescription : hostStatusLabel(h),
+							onClick: () => pickHost(h)
 						}),
-						title: /* @__PURE__ */ jsxs(Fragment, { children: [m.name, /* @__PURE__ */ jsx(MetaChip, {
-							tone: m.status === "online" ? "success" : "muted",
-							className: "font-normal ml-1.5",
-							children: labels.gitMachineStatus(m.status)
-						})] }),
-						description: m.status === "online" ? labels.gitMachineDescription(m.name) : labels.gitMachineOffline(m.name),
-						onClick: () => pickMachine(m)
-					}, m.id))]
+						machinesUnder(h).map((m) => /* @__PURE__ */ jsx(MenuRow, {
+							size: "lg",
+							role: "menuitemradio",
+							className: "zg-menu-row-nested",
+							checked: h.id === host.id && machine?.id === m.id,
+							icon: /* @__PURE__ */ jsx("span", {
+								"aria-hidden": true,
+								className: placeIcon("machine")
+							}),
+							title: /* @__PURE__ */ jsxs(Fragment, { children: [m.name, m.status !== "online" && /* @__PURE__ */ jsx(MetaChip, {
+								tone: "muted",
+								className: "font-normal ml-1.5",
+								children: labels.gitMachineStatus(m.status)
+							})] }),
+							description: m.status !== "online" ? labels.gitMachineOfflineWaits(m.name) : h.kind === "local" ? labels.gitMachineDescription(m.name) : labels.gitMachineDescription(m.name, h.name),
+							onClick: () => pickMachine(h, m)
+						}, m.id)),
+						onAddMachine && h.kind === "server" && hostReachable(h) && /* @__PURE__ */ jsx(MenuRow, {
+							role: "menuitem",
+							className: "zg-menu-row-nested",
+							icon: /* @__PURE__ */ jsx("span", {
+								"aria-hidden": true,
+								className: "i-ph-plus"
+							}),
+							title: labels.gitAddMachine,
+							onClick: () => {
+								close();
+								onAddMachine(h.id);
+							}
+						})
+					] }, h.id))
 				})
 			}),
 			isolations.length > 1 && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(MenuSeparator, {}), /* @__PURE__ */ jsx(MenuSection, {
@@ -244,6 +269,25 @@ function WhereMenu(props) {
 				icon: "i-ph-info",
 				children: selected.note
 			}),
+			machine && machine.status !== "online" && /* @__PURE__ */ jsx(MenuNote, {
+				icon: "i-ph-clock",
+				children: labels.gitMachineOfflineNote(machine.name)
+			}),
+			newChatsDefault && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(MenuSeparator, {}), /* @__PURE__ */ jsx("div", {
+				role: "menu",
+				"aria-label": labels.gitNewChatsDefault,
+				children: /* @__PURE__ */ jsx(MenuRow, {
+					role: "menuitemcheckbox",
+					toggle: newChatsDefault.isDefault,
+					icon: /* @__PURE__ */ jsx("span", {
+						"aria-hidden": true,
+						className: "i-ph-push-pin"
+					}),
+					title: newChatsDefault.space ? labels.gitUseForNewChatsIn(newChatsDefault.space) : labels.gitUseForNewChats,
+					...newChatsDefault.isDefault ? { description: labels.gitNewChatsStartHere } : {},
+					onClick: newChatsDefault.onToggle
+				})
+			})] }),
 			onOpenSettings && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(MenuSeparator, {}), /* @__PURE__ */ jsx("div", {
 				role: "menu",
 				"aria-label": labels.gitEnvironmentSettings,

package/dist/git/headless/environment.d.ts

@@ -1,3 +1,4 @@
+import { NewChatPlace } from "zidane/chat/pure";
 import { EnvironmentCheckout, EnvironmentDescriptor, EnvironmentRequest } from "zidane/chat";
 //#region src/git/headless/environment.d.ts
 /** What the user picked in a draft; `null` where it is used = the configured default. */
@@ -20,13 +21,23 @@ type EnvironmentMachine = NonNullable<EnvironmentDescriptor['machine']>;
  * @param kind - The environment kind.
  */
 declare function environmentKindIcon(kind: string): string;
+/** Options of {@link withMachines}. */
+interface WithMachinesOptions {
+  /**
+   * An offline machine's kinds stay usable: a new chat there starts and waits until the machine is back (the
+   * host provisions it in the background). Default false: unavailable, with the reason (moving a session needs
+   * the machine now).
+   */
+  offlineWaits?: boolean;
+}
 /**
  * A machine's kinds after this host's, grouped by machine; an offline machine's stay listed,
- * unavailable with the reason.
+ * unavailable with the reason unless {@link WithMachinesOptions.offlineWaits}.
  *
  * @param descriptors - The kinds the host lists.
+ * @param options - Whether an offline machine's kinds stay usable.
  */
-declare function withMachines(descriptors: readonly EnvironmentDescriptor[]): EnvironmentDescriptor[];
+declare function withMachines(descriptors: readonly EnvironmentDescriptor[], options?: WithMachinesOptions): EnvironmentDescriptor[];
 /**
  * The descriptor a draft resolves to: the pick when still usable, else the default, else Local.
  * `undefined` when nothing is loaded yet.
@@ -61,5 +72,24 @@ declare function environmentBaseKind(kind: string): string;
  * @param path - A `/` or `\` separated path.
  */
 declare function folderName(path: string): string;
+/**
+ * A machine's environment kind (`local@gpu`, `worktree@gpu`).
+ *
+ * @param machine - The machine's name.
+ * @param base - Its folder (`local`) or a new worktree there.
+ */
+declare function machineEnvironmentKind(machine: string, base?: 'local' | 'worktree'): string;
+/**
+ * The machine an environment kind runs on (`worktree@gpu` → `gpu`); `undefined` for the host's own kinds.
+ *
+ * @param kind - The environment kind.
+ */
+declare function environmentMachineName(kind: string): string | undefined;
+/**
+ * The environment kind a default place asks for (`worktree@gpu`, `docker`); `undefined` for the host's default.
+ *
+ * @param place - Where new chats start.
+ */
+declare function newChatPlaceKind(place: Pick<NewChatPlace, 'machine' | 'isolation'>): string | undefined;
 //#endregion
-export { DraftEnvironment, EnvironmentMachine, environmentBaseKind, environmentKindIcon, folderName, machinesOf, resolveDraftDescriptor, resolveDraftEnvironment, withMachines };
+export { DraftEnvironment, EnvironmentMachine, WithMachinesOptions, environmentBaseKind, environmentKindIcon, environmentMachineName, folderName, machineEnvironmentKind, machinesOf, newChatPlaceKind, resolveDraftDescriptor, resolveDraftEnvironment, withMachines };

package/dist/git/headless/environment.js

@@ -1,4 +1,4 @@
-import { machineBlockedReason, orderByMachine, parseMachineKind } from "zidane/chat/pure";
+import { machineBlockedReason, machineKind, orderByMachine, parseMachineKind, placeEnvironmentKind } from "zidane/chat/pure";
 //#region src/git/headless/environment.ts
 const KIND_ICONS = {
 	local: "i-ph-laptop",
@@ -17,12 +17,15 @@ function environmentKindIcon(kind) {
 }
 /**
 * A machine's kinds after this host's, grouped by machine; an offline machine's stay listed,
-* unavailable with the reason.
+* unavailable with the reason unless {@link WithMachinesOptions.offlineWaits}.
 *
 * @param descriptors - The kinds the host lists.
+* @param options - Whether an offline machine's kinds stay usable.
 */
-function withMachines(descriptors) {
-	return orderByMachine(descriptors).map((descriptor) => {
+function withMachines(descriptors, options = {}) {
+	const ordered = orderByMachine(descriptors);
+	if (options.offlineWaits) return ordered;
+	return ordered.map((descriptor) => {
 		const blocked = machineBlockedReason(descriptor);
 		return blocked && descriptor.available ? {
 			...descriptor,
@@ -94,5 +97,30 @@ function folderName(path) {
 	const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
 	return idx === -1 ? trimmed : trimmed.slice(idx + 1);
 }
+/**
+* A machine's environment kind (`local@gpu`, `worktree@gpu`).
+*
+* @param machine - The machine's name.
+* @param base - Its folder (`local`) or a new worktree there.
+*/
+function machineEnvironmentKind(machine, base = "local") {
+	return machineKind(base, machine);
+}
+/**
+* The machine an environment kind runs on (`worktree@gpu` → `gpu`); `undefined` for the host's own kinds.
+*
+* @param kind - The environment kind.
+*/
+function environmentMachineName(kind) {
+	return parseMachineKind(kind)?.name;
+}
+/**
+* The environment kind a default place asks for (`worktree@gpu`, `docker`); `undefined` for the host's default.
+*
+* @param place - Where new chats start.
+*/
+function newChatPlaceKind(place) {
+	return placeEnvironmentKind(place);
+}
 //#endregion
-export { environmentBaseKind, environmentKindIcon, folderName, machinesOf, resolveDraftDescriptor, resolveDraftEnvironment, withMachines };
+export { environmentBaseKind, environmentKindIcon, environmentMachineName, folderName, machineEnvironmentKind, machinesOf, newChatPlaceKind, resolveDraftDescriptor, resolveDraftEnvironment, withMachines };

package/dist/git/headless/index.d.ts

@@ -1,8 +1,8 @@
 import { GitActionResult, GitBranch, GitBranchPullRequest, GitCheckoutResult, GitCheckoutTarget, GitClone, GitCloneProgress, GitCloneResult, GitCreateFolderQuery, GitCreateFolderResult, GitEnvironmentQuery, GitFolderAllows, GitFolderEntry, GitFolderListing, GitFolderQuery, GitFolderResult, GitFolderSearchQuery, GitFolderSearchResult, GitHost, GitHostError, GitMoveResult, GitMoveTarget, GitPullRequest, GitPullRequestList, GitPullRequestQuery, GitRepoInfo, GitRepoSpec, GitStatus, GitSyncResult } from "./host.js";
-import { DraftEnvironment, EnvironmentMachine, environmentBaseKind, environmentKindIcon, folderName, machinesOf, resolveDraftDescriptor, resolveDraftEnvironment, withMachines } from "./environment.js";
+import { DraftEnvironment, EnvironmentMachine, WithMachinesOptions, environmentBaseKind, environmentKindIcon, environmentMachineName, folderName, machineEnvironmentKind, machinesOf, newChatPlaceKind, resolveDraftDescriptor, resolveDraftEnvironment, withMachines } from "./environment.js";
 import { DraftRemoteClone, resolveRemoteClone } from "./remote-clone.js";
 import { DEFAULT_GIT_LABELS, GitLabels, gitErrorText } from "./labels.js";
 import { MoveChoice, MoveSessionSubject, leavesWorktree, moveChoices, moveListingCwd, moveSubject } from "./move.js";
 import { SWITCHER_SECTIONS, SwitcherCache, SwitcherEntry, SwitcherSection, SwitcherSectionId, ageIsDuration, clockTime, compactCount, createSwitcherCache, prMatches, readPullRequests, switcherCacheOf, switcherCreates, switcherKey, switcherSections } from "./switcher.js";
 import { GitSyncAction, syncAction, syncSummary, syncTooltip } from "./sync.js";
-export { DEFAULT_GIT_LABELS, DraftEnvironment, DraftRemoteClone, EnvironmentMachine, GitActionResult, GitBranch, GitBranchPullRequest, GitCheckoutResult, GitCheckoutTarget, GitClone, GitCloneProgress, GitCloneResult, GitCreateFolderQuery, GitCreateFolderResult, GitEnvironmentQuery, GitFolderAllows, GitFolderEntry, GitFolderListing, GitFolderQuery, GitFolderResult, GitFolderSearchQuery, GitFolderSearchResult, GitHost, GitHostError, GitLabels, GitMoveResult, GitMoveTarget, GitPullRequest, GitPullRequestList, GitPullRequestQuery, GitRepoInfo, GitRepoSpec, GitStatus, GitSyncAction, GitSyncResult, MoveChoice, MoveSessionSubject, SWITCHER_SECTIONS, SwitcherCache, SwitcherEntry, SwitcherSection, SwitcherSectionId, ageIsDuration, clockTime, compactCount, createSwitcherCache, environmentBaseKind, environmentKindIcon, folderName, gitErrorText, leavesWorktree, machinesOf, moveChoices, moveListingCwd, moveSubject, prMatches, readPullRequests, resolveDraftDescriptor, resolveDraftEnvironment, resolveRemoteClone, switcherCacheOf, switcherCreates, switcherKey, switcherSections, syncAction, syncSummary, syncTooltip, withMachines };
+export { DEFAULT_GIT_LABELS, DraftEnvironment, DraftRemoteClone, EnvironmentMachine, GitActionResult, GitBranch, GitBranchPullRequest, GitCheckoutResult, GitCheckoutTarget, GitClone, GitCloneProgress, GitCloneResult, GitCreateFolderQuery, GitCreateFolderResult, GitEnvironmentQuery, GitFolderAllows, GitFolderEntry, GitFolderListing, GitFolderQuery, GitFolderResult, GitFolderSearchQuery, GitFolderSearchResult, GitHost, GitHostError, GitLabels, GitMoveResult, GitMoveTarget, GitPullRequest, GitPullRequestList, GitPullRequestQuery, GitRepoInfo, GitRepoSpec, GitStatus, GitSyncAction, GitSyncResult, MoveChoice, MoveSessionSubject, SWITCHER_SECTIONS, SwitcherCache, SwitcherEntry, SwitcherSection, SwitcherSectionId, WithMachinesOptions, ageIsDuration, clockTime, compactCount, createSwitcherCache, environmentBaseKind, environmentKindIcon, environmentMachineName, folderName, gitErrorText, leavesWorktree, machineEnvironmentKind, machinesOf, moveChoices, moveListingCwd, moveSubject, newChatPlaceKind, prMatches, readPullRequests, resolveDraftDescriptor, resolveDraftEnvironment, resolveRemoteClone, switcherCacheOf, switcherCreates, switcherKey, switcherSections, syncAction, syncSummary, syncTooltip, withMachines };

package/dist/git/headless/index.js

@@ -1,7 +1,7 @@
-import { environmentBaseKind, environmentKindIcon, folderName, machinesOf, resolveDraftDescriptor, resolveDraftEnvironment, withMachines } from "./environment.js";
+import { environmentBaseKind, environmentKindIcon, environmentMachineName, folderName, machineEnvironmentKind, machinesOf, newChatPlaceKind, resolveDraftDescriptor, resolveDraftEnvironment, withMachines } from "./environment.js";
 import { DEFAULT_GIT_LABELS, gitErrorText } from "./labels.js";
 import { resolveRemoteClone } from "./remote-clone.js";
 import { SWITCHER_SECTIONS, ageIsDuration, clockTime, compactCount, createSwitcherCache, prMatches, readPullRequests, switcherCacheOf, switcherCreates, switcherKey, switcherSections } from "./switcher.js";
 import { syncAction, syncSummary, syncTooltip } from "./sync.js";
 import { leavesWorktree, moveChoices, moveListingCwd, moveSubject } from "./move.js";
-export { DEFAULT_GIT_LABELS, SWITCHER_SECTIONS, ageIsDuration, clockTime, compactCount, createSwitcherCache, environmentBaseKind, environmentKindIcon, folderName, gitErrorText, leavesWorktree, machinesOf, moveChoices, moveListingCwd, moveSubject, prMatches, readPullRequests, resolveDraftDescriptor, resolveDraftEnvironment, resolveRemoteClone, switcherCacheOf, switcherCreates, switcherKey, switcherSections, syncAction, syncSummary, syncTooltip, withMachines };
+export { DEFAULT_GIT_LABELS, SWITCHER_SECTIONS, ageIsDuration, clockTime, compactCount, createSwitcherCache, environmentBaseKind, environmentKindIcon, environmentMachineName, folderName, gitErrorText, leavesWorktree, machineEnvironmentKind, machinesOf, moveChoices, moveListingCwd, moveSubject, newChatPlaceKind, prMatches, readPullRequests, resolveDraftDescriptor, resolveDraftEnvironment, resolveRemoteClone, switcherCacheOf, switcherCreates, switcherKey, switcherSections, syncAction, syncSummary, syncTooltip, withMachines };