zidane-ui 9.1.13 → 9.1.14

package/dist/machines/headless/fixture-host.js

@@ -1,7 +1,7 @@
 import { writable } from "../../chat/headless/store.js";
 import { machinesError } from "./host.js";
-import { createPresenceStore } from "./presence.js";
 import { createMachineLists, createOnlineMachines } from "./stores.js";
+import { createPresenceStore } from "./presence.js";
 import { createHostSyncReads } from "./sync.js";
 //#region src/machines/headless/fixture-host.ts
 /** This computer, as every host lists it first. */
@@ -50,6 +50,15 @@ function createFixtureMachinesHost(options = {}) {
 	let folderTurn = 0;
 	let tokenCount = 0;
 	const hostOf = (id) => hosts.get().hosts.find((host) => host.id === id);
+	const joinListeners = /* @__PURE__ */ new Set();
+	const join = (hostId, machine) => {
+		machines.set(hostId, [...(machines.get(hostId) ?? []).filter((m) => m.id !== machine.id), machine]);
+		for (const listener of [...statusListeners]) listener({
+			hostId,
+			name: machine.name,
+			status: machine.status
+		});
+	};
 	const patchHost = (id, patch) => hosts.set((state) => ({
 		...state,
 		hosts: patch ? state.hosts.map((host) => host.id === id ? {
@@ -248,6 +257,13 @@ function createFixtureMachinesHost(options = {}) {
 				statusListeners.add(onChange);
 				return () => statusListeners.delete(onChange);
 			}),
+			onJoin(hostId, listener) {
+				const own = (from, event) => {
+					if (from === hostId) listener(event);
+				};
+				joinListeners.add(own);
+				return () => void joinListeners.delete(own);
+			},
 			async forget(hostId, machineId) {
 				options.onForget?.(hostId, machineId);
 				machines.set(hostId, (machines.get(hostId) ?? []).filter((machine) => machine.id !== machineId));
@@ -255,8 +271,7 @@ function createFixtureMachinesHost(options = {}) {
 			async invite(hostId, inviteOptions = {}) {
 				if (options.permitted && !permitted.get()?.has("machines.invite")) throw {
 					kind: "invite",
-					detail: "\"tokens.machineInvite\" needs an admin token.",
-					forbidden: true
+					detail: "This server does not make join codes."
 				};
 				const made = options.onInvite?.(hostId, inviteOptions) ?? {
 					code: "K7Q2-9XPM",
@@ -264,6 +279,16 @@ function createFixtureMachinesHost(options = {}) {
 				};
 				const host = hostOf(hostId);
 				const url = host?.url ?? `wss://${host?.name ?? hostId}`;
+				if (options.joinAfterMs !== void 0) {
+					const name = inviteOptions.name ?? "gpu-box";
+					setTimeout(() => join(hostId, {
+						id: `m-${name}-${Date.now()}`,
+						name,
+						roots: [{ path: `/home/${name}/projects` }],
+						status: "online",
+						capabilities: { gpu: ["NVIDIA GeForce RTX 4090"] }
+					}), options.joinAfterMs);
+				}
 				return {
 					...made,
 					join: `${url}#${made.code}`
@@ -312,6 +337,7 @@ function createFixtureMachinesHost(options = {}) {
 			}
 		},
 		pickFolder: async () => folders[folderTurn++ % folders.length] ?? null,
+		newChat: (hostId, machine) => options.onNewChat?.(hostId, machine),
 		updates: {
 			status: async (hostId) => updateOf(hostId),
 			async check(hostId) {
@@ -343,13 +369,13 @@ function createFixtureMachinesHost(options = {}) {
 		},
 		tokens: {
 			list: async (hostId) => tokens.get(hostId) ?? [],
-			async create(hostId, name, scope) {
-				options.onCreateToken?.(hostId, name, scope);
+			async create(hostId, name) {
+				options.onCreateToken?.(hostId, name);
 				tokenCount += 1;
 				const created = {
 					id: `tok_fixture${tokenCount}`,
 					name,
-					scope,
+					scope: "client",
 					createdAt: Date.now()
 				};
 				tokens.set(hostId, [...tokens.get(hostId) ?? [], created]);
@@ -358,6 +384,13 @@ function createFixtureMachinesHost(options = {}) {
 					token: `zds_fixture_secret_${tokenCount}`
 				};
 			},
+			async pair(hostId, pairOptions = {}) {
+				options.onPair?.(hostId, pairOptions);
+				return {
+					code: "P4IR-C0DE",
+					expiresAt: Date.now() + Math.min(pairOptions.ttlMs ?? 6e5, 6e5)
+				};
+			},
 			async revoke(hostId, id) {
 				options.onRevokeToken?.(hostId, id);
 				tokens.set(hostId, (tokens.get(hostId) ?? []).map((token) => token.id === id ? {
@@ -478,6 +511,10 @@ function createFixtureMachinesHost(options = {}) {
 					status
 				});
 			},
+			joinMachine: (hostId, machine) => join(hostId, machine),
+			pushJoin: (hostId, event) => {
+				for (const listener of [...joinListeners]) listener(hostId, event);
+			},
 			setLinks: (next) => links.set(next),
 			setHealth: (next) => health.set(next),
 			setPermitted: (actions) => permitted.set(actions ? new Set(actions) : null),

package/dist/machines/headless/fixtures.js

@@ -63,21 +63,21 @@ const DEMO_TOKENS = [
 	{
 		id: "tok_phone",
 		name: "phone",
-		scope: "chat",
+		scope: "client",
 		createdAt: DEMO_NOW - 10 * DAY,
 		lastUsedAt: DEMO_NOW - 36e5
 	},
 	{
 		id: "tok_laptop",
 		name: "laptop",
-		scope: "admin",
+		scope: "client",
 		createdAt: DEMO_NOW - 40 * DAY,
 		lastUsedAt: DEMO_NOW - 6e4
 	},
 	{
 		id: "tok_old",
 		name: "old tablet",
-		scope: "chat",
+		scope: "client",
 		createdAt: DEMO_NOW - 90 * DAY,
 		revokedAt: DEMO_NOW - 20 * DAY
 	}
@@ -130,9 +130,7 @@ const DEMO_CAPABILITIES = {
 	allows: {
 		remoteInstalls: true,
 		asMachine: true,
-		sync: false,
-		clone: true,
-		createFolders: true
+		sync: false
 	},
 	workspace: {
 		roots: ["/data/workspaces"],

package/dist/machines/headless/host.d.ts

@@ -3,8 +3,8 @@ import { HostView } from "../../chat/headless/hosts.js";
 import { SignInFlow } from "../../onboarding/headless/host.js";
 import { MachinesPresence } from "./presence.js";
 import { HostSyncPatch, HostSyncRead, HostSyncState, SyncStatus } from "./sync.js";
-import { DaemonHealth, HostCapabilities, MachineInfo, MachineLinksStatus, ServerUpdateStatus } from "zidane/chat/pure";
-import { ClientScope, HostProviderAuth } from "zidane/ipc";
+import { DaemonHealth, HostCapabilities, MachineInfo, MachineJoinEvent, MachineLinksStatus, ServerUpdateStatus } from "zidane/chat/pure";
+import { HostProviderAuth } from "zidane/ipc";
 //#region src/machines/headless/host.d.ts
 /** One agent host as the machines components show it: This computer or a server. */
 interface HostSummary extends HostView {
@@ -18,13 +18,6 @@ interface HostSummary extends HostView {
   lastConnectedAt?: number;
   /** The server lends itself as a machine (`allowAsMachine`). */
   machineServe?: boolean;
-  /** The scope this app's token has there. Absent: every method (the user's own computer). */
-  scope?: ClientScope;
-  /** How to get an admin token there: commands to run on its machine (`token` mints one to paste, `pair` a browser code). */
-  adminCommands?: {
-    token: string;
-    pair: string;
-  };
   /** When the server process started, epoch ms. */
   startedAt?: number;
 }
@@ -64,8 +57,6 @@ interface MachinesError {
   kind: 'read' | 'update' | 'forget' | 'remove' | 'tokens' | 'daemon' | 'sync' | 'invite' | 'install';
   /** The backend's message, shown as is by the default labels. */
   detail: string;
-  /** The token's scope does not reach the action (the server answered Forbidden). */
-  forbidden?: boolean;
 }
 /** A one-time machine join code (`tokens.machineInvite`): a new machine runs `zidane machine setup --join <join>`. */
 interface MachineInvite {
@@ -145,12 +136,17 @@ interface MachinesDirectory {
   forget?(hostId: string, machineId: string): Promise<void>;
   /**
    * Creates a one-time join code on `hostId` for a new machine (`name`: the machine's name there). Rejects with a
-   * {@link MachinesError} (`invite`, `forbidden` below an admin token). Absent: no Add a machine.
+   * {@link MachinesError} (`invite`). Absent: no Add a machine.
    */
   invite?(hostId: string, options?: {
     name?: string;
     ttlMs?: number;
   }): Promise<MachineInvite>;
+  /**
+   * What becomes of `hostId`'s join codes, as it happens (`machine:join`): paired, joined, refused and why. Returns
+   * the unsubscribe. Absent: Add a machine sees a machine join from the list alone, and no refusal.
+   */
+  onJoin?(hostId: string, listener: (event: MachineJoinEvent) => void): () => void;
 }
 /** This computer's machine links: shared with servers (it is their machine), and servers used as machines. */
 interface MachineLinks {
@@ -176,15 +172,15 @@ interface ServerUpdates {
   /** Turns the self-update on or off. Absent: no Turn on / off. */
   configure?(hostId: string, enabled: boolean): Promise<ServerUpdateStatus>;
 }
-/** A token's scope on a server: a client scope, or `machine` (it lends a computer). */
-type ServerTokenScope = ClientScope | 'machine';
+/** A token's kind on a server: `client` (an app, a browser, an MCP client), or `machine` (it lends a computer). */
+type ServerTokenScope = 'client' | 'machine';
 /** A server's client token as listed: never its secret. */
 interface ServerToken {
   /** Stable id (`tok_…`). */
   id: string;
   /** The name it was created with, such as the device it is for. */
   name: string;
-  /** What it may do. */
+  /** What it is for. */
   scope: ServerTokenScope;
   /** When it was created, epoch ms. */
   createdAt: number;
@@ -195,14 +191,26 @@ interface ServerToken {
   /** When it stops working, epoch ms. Absent: never. */
   expiresAt?: number;
 }
+/** A one-time code for a browser (`tokens.pair`): typed into the web app's sign-in screen. */
+interface BrowserPairing {
+  /** The code (`K7Q2-9XPM`). */
+  code: string;
+  /** When the code stops working, epoch ms. It works once before then. */
+  expiresAt: number;
+}
 /** A server's client tokens. Every method rejects with a {@link MachinesError}. */
 interface ServerTokens {
   /** `hostId`'s tokens, revoked ones included. */
   list(hostId: string): Promise<readonly ServerToken[]>;
-  /** Creates a token; the answer carries its secret, shown once. Absent: no create form. */
-  create?(hostId: string, name: string, scope: ServerTokenScope): Promise<ServerToken & {
+  /** Creates a client token; the answer carries its secret, shown once. Absent: no create form. */
+  create?(hostId: string, name: string): Promise<ServerToken & {
     token: string;
   }>;
+  /** Makes a one-time code a browser logs in to the web app with (`tokens.pair`). Absent: no Pair a browser. */
+  pair?(hostId: string, options?: {
+    name?: string;
+    ttlMs?: number;
+  }): Promise<BrowserPairing>;
   /** Revokes a token. Absent: no revoke buttons. */
   revoke?(hostId: string, id: string): Promise<void>;
   /** Calls `listener` when `hostId`'s tokens changed elsewhere (another page, a pairing, the CLI). Returns the unsubscribe. Absent: the list is read when shown and after its own changes. */
@@ -230,10 +238,18 @@ interface DaemonStatus {
     startedAt: number;
     retiring?: boolean;
   };
-  /** Why the daemon refused this window. */
+  /**
+   * Why the daemon refused this window. `busy`: an older daemon has been
+   * finishing its work for longer than this window waits; its writes fail
+   * until the daemon is stopped (Restart daemon now). `startsOlder`: the
+   * daemon this window starts is older too (the zidane CLI on PATH is older
+   * than the app), so chats run in the window.
+   */
   refused?: {
     message: string;
     direction: 'daemon-newer' | 'daemon-older' | 'unknown';
+    busy?: boolean;
+    startsOlder?: boolean;
   };
   /** Why it is unreachable. */
   error?: string;
@@ -315,6 +331,11 @@ interface MachinesHost {
   links?: MachineLinks;
   /** Picks a folder to share (the native dialog). Absent: no Add a folder. */
   pickFolder?(): Promise<string | null>;
+  /**
+   * Opens a new chat on `hostId`: on its machine named `machine` when given, else in the server's own folders. The
+   * app moves its draft there and shows it. Absent: no New chat buttons.
+   */
+  newChat?(hostId: string, machine?: string): void;
   /** A server's self-update. Absent: no update section. */
   updates?: ServerUpdates;
   /** A server's client tokens. Absent: no token list. */
@@ -360,4 +381,4 @@ declare function isMachinesError(value: unknown): value is MachinesError;
  */
 declare function isPermitted(permitted: ReadonlySet<MachinesAction> | null | undefined, action: MachinesAction): boolean;
 //#endregion
-export { DaemonControl, type DaemonHealth, DaemonStatus, type HostCapabilities, HostCheckError, HostCheckResult, type HostProviderAuth, HostSignInTarget, HostSummary, HostSync, HostsState, MachineActionResult, type MachineInfo, MachineInvite, MachineLinks, type MachineLinksStatus, MachineList, MachineListState, MachinesAction, MachinesDirectory, MachinesError, MachinesHost, SavedHosts, SavedHostsState, ServerToken, ServerTokenScope, ServerTokens, type ServerUpdateStatus, ServerUpdates, ToolInstallResult, isMachinesError, isPermitted, machinesError };
+export { BrowserPairing, DaemonControl, type DaemonHealth, DaemonStatus, type HostCapabilities, HostCheckError, HostCheckResult, type HostProviderAuth, HostSignInTarget, HostSummary, HostSync, HostsState, MachineActionResult, type MachineInfo, MachineInvite, type MachineJoinEvent, MachineLinks, type MachineLinksStatus, MachineList, MachineListState, MachinesAction, MachinesDirectory, MachinesError, MachinesHost, SavedHosts, SavedHostsState, ServerToken, ServerTokenScope, ServerTokens, type ServerUpdateStatus, ServerUpdates, ToolInstallResult, isMachinesError, isPermitted, machinesError };

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

@@ -1,8 +1,8 @@
 import { MachinesPresence, PresenceFeed, SessionPresence, createPresenceStore } from "./presence.js";
 import { DEFAULT_MACHINES_LABELS, MachinesLabels } from "./labels.js";
 import { HostSyncAccount, HostSyncConfig, HostSyncPatch, HostSyncRead, HostSyncState, SyncBlockedReason, SyncCategory, SyncMode, SyncOutcome, SyncPushResult, SyncStatus, createHostSyncReads, shortList, syncBlockedReason, syncOutcome } from "./sync.js";
-import { DaemonControl, DaemonHealth, DaemonStatus, HostCapabilities, HostCheckError, HostCheckResult, HostProviderAuth, HostSignInTarget, HostSummary, HostSync, HostsState, MachineActionResult, MachineInfo, MachineInvite, MachineLinks, MachineLinksStatus, MachineList, MachineListState, MachinesAction, MachinesDirectory, MachinesError, MachinesHost, SavedHosts, SavedHostsState, ServerToken, ServerTokenScope, ServerTokens, ServerUpdateStatus, ServerUpdates, ToolInstallResult, isMachinesError, isPermitted, machinesError } from "./host.js";
-import { LazyReadableOptions, LazySink, createMachineLists, createOnlineMachines, lazyReadable } from "./stores.js";
+import { BrowserPairing, DaemonControl, DaemonHealth, DaemonStatus, HostCapabilities, HostCheckError, HostCheckResult, HostProviderAuth, HostSignInTarget, HostSummary, HostSync, HostsState, MachineActionResult, MachineInfo, MachineInvite, MachineJoinEvent, MachineLinks, MachineLinksStatus, MachineList, MachineListState, MachinesAction, MachinesDirectory, MachinesError, MachinesHost, SavedHosts, SavedHostsState, ServerToken, ServerTokenScope, ServerTokens, ServerUpdateStatus, ServerUpdates, ToolInstallResult, isMachinesError, isPermitted, machinesError } from "./host.js";
+import { LazyReadableOptions, LazySink, createMachineLists, createOnlineMachines, lazyReadable, machinesByHost } from "./stores.js";
 import { MachinesTone, UPDATE_BUSY_STATES, agoText, daemonStatusText, hostCheckMessage, hostCheckOkLine, hostStatusText, hostStatusTone, linkStateText, updateStateLine, uptimeText } from "./messages.js";
 import { hostOfSettingsFocus, hostSettingsFocus } from "./settings-focus.js";
-export { DEFAULT_MACHINES_LABELS, DaemonControl, type DaemonHealth, DaemonStatus, type HostCapabilities, HostCheckError, HostCheckResult, type HostProviderAuth, HostSignInTarget, HostSummary, HostSync, HostSyncAccount, HostSyncConfig, HostSyncPatch, HostSyncRead, HostSyncState, HostsState, LazyReadableOptions, LazySink, MachineActionResult, type MachineInfo, MachineInvite, MachineLinks, type MachineLinksStatus, MachineList, MachineListState, MachinesAction, MachinesDirectory, MachinesError, MachinesHost, MachinesLabels, MachinesPresence, MachinesTone, PresenceFeed, SavedHosts, SavedHostsState, ServerToken, ServerTokenScope, ServerTokens, type ServerUpdateStatus, ServerUpdates, SessionPresence, SyncBlockedReason, type SyncCategory, type SyncMode, SyncOutcome, type SyncPushResult, type SyncStatus, ToolInstallResult, UPDATE_BUSY_STATES, agoText, createHostSyncReads, createMachineLists, createOnlineMachines, createPresenceStore, daemonStatusText, hostCheckMessage, hostCheckOkLine, hostOfSettingsFocus, hostSettingsFocus, hostStatusText, hostStatusTone, isMachinesError, isPermitted, lazyReadable, linkStateText, machinesError, shortList, syncBlockedReason, syncOutcome, updateStateLine, uptimeText };
+export { BrowserPairing, DEFAULT_MACHINES_LABELS, DaemonControl, type DaemonHealth, DaemonStatus, type HostCapabilities, HostCheckError, HostCheckResult, type HostProviderAuth, HostSignInTarget, HostSummary, HostSync, HostSyncAccount, HostSyncConfig, HostSyncPatch, HostSyncRead, HostSyncState, HostsState, LazyReadableOptions, LazySink, MachineActionResult, type MachineInfo, MachineInvite, type MachineJoinEvent, MachineLinks, type MachineLinksStatus, MachineList, MachineListState, MachinesAction, MachinesDirectory, MachinesError, MachinesHost, MachinesLabels, MachinesPresence, MachinesTone, PresenceFeed, SavedHosts, SavedHostsState, ServerToken, ServerTokenScope, ServerTokens, type ServerUpdateStatus, ServerUpdates, SessionPresence, SyncBlockedReason, type SyncCategory, type SyncMode, SyncOutcome, type SyncPushResult, type SyncStatus, ToolInstallResult, UPDATE_BUSY_STATES, agoText, createHostSyncReads, createMachineLists, createOnlineMachines, createPresenceStore, daemonStatusText, hostCheckMessage, hostCheckOkLine, hostOfSettingsFocus, hostSettingsFocus, hostStatusText, hostStatusTone, isMachinesError, isPermitted, lazyReadable, linkStateText, machinesByHost, machinesError, shortList, syncBlockedReason, syncOutcome, updateStateLine, uptimeText };

package/dist/machines/headless/index.js

@@ -1,8 +1,8 @@
 import { isMachinesError, isPermitted, machinesError } from "./host.js";
+import { createMachineLists, createOnlineMachines, lazyReadable, machinesByHost } from "./stores.js";
+import { DEFAULT_MACHINES_LABELS } from "./labels.js";
 import { createPresenceStore } from "./presence.js";
-import { createMachineLists, createOnlineMachines, lazyReadable } from "./stores.js";
 import { createHostSyncReads, shortList, syncBlockedReason, syncOutcome } from "./sync.js";
-import { DEFAULT_MACHINES_LABELS } from "./labels.js";
 import { UPDATE_BUSY_STATES, agoText, daemonStatusText, hostCheckMessage, hostCheckOkLine, hostStatusText, hostStatusTone, linkStateText, updateStateLine, uptimeText } from "./messages.js";
 import { hostOfSettingsFocus, hostSettingsFocus } from "./settings-focus.js";
-export { DEFAULT_MACHINES_LABELS, UPDATE_BUSY_STATES, agoText, createHostSyncReads, createMachineLists, createOnlineMachines, createPresenceStore, daemonStatusText, hostCheckMessage, hostCheckOkLine, hostOfSettingsFocus, hostSettingsFocus, hostStatusText, hostStatusTone, isMachinesError, isPermitted, lazyReadable, linkStateText, machinesError, shortList, syncBlockedReason, syncOutcome, updateStateLine, uptimeText };
+export { DEFAULT_MACHINES_LABELS, UPDATE_BUSY_STATES, agoText, createHostSyncReads, createMachineLists, createOnlineMachines, createPresenceStore, daemonStatusText, hostCheckMessage, hostCheckOkLine, hostOfSettingsFocus, hostSettingsFocus, hostStatusText, hostStatusTone, isMachinesError, isPermitted, lazyReadable, linkStateText, machinesByHost, machinesError, shortList, syncBlockedReason, syncOutcome, updateStateLine, uptimeText };

package/dist/machines/headless/labels.d.ts

@@ -1,6 +1,6 @@
 import { SyncBlockedReason } from "./sync.js";
 import { HostCheckError, MachinesError, ServerTokenScope } from "./host.js";
-import { SyncCategory, SyncMode } from "zidane/chat/pure";
+import { MachineJoinRefusal, SyncCategory, SyncMode } from "zidane/chat/pure";
 //#region src/machines/headless/labels.d.ts
 /** The default English strings of the machines components. Override any of them through `MachinesProvider` or `LabelsProvider`. */
 declare const DEFAULT_MACHINES_LABELS: {
@@ -22,6 +22,8 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesRetry: string;
   /** A failed read or action. The default shows the backend's message. */
   machinesError: (error: MachinesError) => string;
+  /** A failed read or action, worded by what failed. What the backend said goes under Details. */
+  machinesFailed: (kind: MachinesError["kind"]) => string;
   /** "5m" → "5m ago"; a date stays as is. */
   machinesAgo: (short: string) => string;
   machinesThisServer: string;
@@ -52,20 +54,6 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesFactServerName: (name: string) => string;
   machinesFactVersion: (version: string) => string;
   machinesFactConnected: (ago: string) => string;
-  machinesFactScope: (scope: string) => string;
-  /** What a section, button or panel says to a connection that may not use it (a chat token). */
-  machinesAdminOnly: string;
-  /** The chip on a server's card: what this app's token may do there. */
-  machinesAccess: (scope: string) => "Admin access" | "Chat access";
-  machinesGetAdmin: string;
-  machinesGetAdminRun: string;
-  machinesGetAdminCopy: string;
-  machinesGetAdminToken: string;
-  machinesGetAdminTokenField: string;
-  machinesGetAdminSave: string;
-  machinesGetAdminSaving: string;
-  machinesGetAdminSaved: string;
-  machinesGetAdminPairNext: string;
   machinesFactUptime: (uptime: string) => string;
   machinesOkLine: (name: string, version?: string, latencyMs?: number) => string;
   /** What to do about a refusal, per registry error code; `message` is the backend's own words. */
@@ -115,7 +103,6 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesShareTokenPlaceholder: string;
   machinesShareStart: string;
   machinesSharing: (name: string) => string;
-  machinesShared: (roots: string, name: string) => string;
   machinesStopping: string;
   machinesUseTitle: (name: string) => string;
   machinesUseMachineName: (machine: string) => string;
@@ -125,7 +112,31 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesUse: string;
   machinesConnectingTo: (name: string) => string;
   machinesListTitle: (name: string) => string;
-  machinesListEmpty: string;
+  machinesExplain: string;
+  machinesHowItWorks: string;
+  machinesEmptyTitle: (name: string) => string;
+  machinesPictureApp: string;
+  machinesPictureAppFact: string;
+  machinesPictureServer: string;
+  machinesPictureServerFact: string;
+  machinesPictureMachines: string;
+  machinesPictureMachinesFact: string;
+  machinesServerBadge: string;
+  machinesServerRowHint: string;
+  machinesNewChat: string;
+  machinesAddedTitle: (name: string) => string;
+  machinesAddedNewChats: (name: string) => string;
+  machinesAddedNewChatsHint: string;
+  machinesAddedShare: (name: string) => string;
+  machinesAddedShareHint: string;
+  machinesDraftServerOffline: (name: string) => string;
+  machinesUseThisComputer: string;
+  machinesPlaceUnsaved: (name: string) => string;
+  machinesPlaceAddServer: (name: string) => string;
+  machinesPlaceMachineGone: (machine: string, host: string) => string;
+  machinesPlaceFolderGone: (folder: string) => string;
+  machinesNewChatLabel: (name: string) => string;
+  machinesFoldersMore: (count: number) => string;
   machinesStatus: (status: "online" | "offline") => "offline" | "online";
   machinesForget: string;
   machinesForgetLabel: (machine: string) => string;
@@ -148,13 +159,31 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesInviteTitle: (name: string) => string;
   machinesInviteCommand: string;
   machinesInviteCopy: string;
-  machinesInviteExpires: (time: string) => string;
   machinesInviteHint: string;
   machinesInviteDone: string;
-  machinesInviteNeedsAdmin: string;
+  machinesAddAnother: string;
+  machinesAddThis: string;
+  machinesAddWhich: string;
+  machinesAddTimeLeft: (minutes: number) => string;
+  machinesAddExpired: string;
+  machinesAddNewCode: string;
+  machinesAddWaiting: string;
+  machinesAddPaired: (name?: string) => string;
+  machinesAddRefused: (reason: MachineJoinRefusal, name?: string) => string;
+  machinesAddLocalAddress: string;
+  machinesAddAddress: string;
+  machinesAddInstalled: string;
+  machinesAddKeepOn: string;
+  machinesAddKeepOnHint: string;
+  machinesAddKeepOnOpen: string;
+  machinesAddThisTerminalHint: string;
+  machinesAddInstalledCopy: string;
+  machinesAddJoined: (machine: string, server: string) => string;
+  machinesAddJoinedHint: string;
+  machinesAddStartChat: string;
+  machinesAddThisHint: (name: string) => string;
   machinesTokensName: string;
   machinesTokensNamePlaceholder: string;
-  machinesTokensScope: string;
   machinesTokensScopes: Record<ServerTokenScope, string>;
   machinesTokensCreate: string;
   machinesTokensCreating: string;
@@ -171,6 +200,13 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesTokensCreatedAt: (ago: string) => string;
   machinesTokensEmpty: string;
   machinesTokensList: string;
+  machinesPairOpen: string;
+  machinesPairCreating: string;
+  machinesPairCode: string;
+  machinesPairCopy: string;
+  machinesPairExpires: (time: string) => string;
+  machinesPairHint: (url?: string) => string;
+  machinesPairDone: string;
   machinesDaemonMenu: (health: string) => string;
   machinesDaemon: string;
   machinesDaemonOff: string;
@@ -186,6 +222,10 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesDaemonNewerDetail: (versions: string) => string;
   machinesDaemonOlder: string;
   machinesDaemonOlderDetail: (versions: string) => string;
+  machinesDaemonOlderBusy: string;
+  machinesDaemonOlderBusyDetail: (versions: string) => string;
+  machinesDaemonCliOlder: string;
+  machinesDaemonCliOlderDetail: (versions: string) => string;
   machinesDaemonRefused: string;
   machinesDaemonConnecting: string;
   machinesDaemonUnreachable: string;
@@ -224,6 +264,8 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesDaemonCopy: string;
   machinesDaemonCopying: string;
   machinesDaemonCopied: string;
+  /** A daemon menu action failed. What it said goes under Details. */
+  machinesDaemonActionFailed: string;
   machinesCapsMore: (count: number) => string;
   machinesCapsOs: Record<string, string>;
   machinesCapsFree: (bytes: number) => string;
@@ -262,6 +304,7 @@ declare const DEFAULT_MACHINES_LABELS: {
   machinesAutoUpdateTitle: string;
   machinesSyncTitle: string;
   machinesMachinesTitle: string;
+  machinesTokensTitle: string;
   machinesSyncModes: Record<SyncMode, string>;
   machinesSyncCategories: Record<SyncCategory, {
     label: string;

package/dist/machines/headless/labels.js

@@ -17,6 +17,18 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesRetry: "Retry",
 	/** A failed read or action. The default shows the backend's message. */
 	machinesError: (error) => error.detail,
+	/** A failed read or action, worded by what failed. What the backend said goes under Details. */
+	machinesFailed: (kind) => ({
+		read: "Could not read it from the server.",
+		update: "Could not check or change the server's update.",
+		forget: "Could not forget the machine.",
+		remove: "Could not remove it.",
+		tokens: "Could not change the tokens.",
+		daemon: "The daemon could not do that.",
+		sync: "Could not sync.",
+		invite: "Could not create a join code.",
+		install: "Could not install the tool."
+	})[kind],
 	/** "5m" → "5m ago"; a date stays as is. */
 	machinesAgo: (short) => `${short} ago`,
 	machinesThisServer: "This server",
@@ -47,20 +59,6 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesFactServerName: (name) => `server name ${name}`,
 	machinesFactVersion: (version) => `Zidane ${version}`,
 	machinesFactConnected: (ago) => `connected ${ago}`,
-	machinesFactScope: (scope) => `${scope} token`,
-	/** What a section, button or panel says to a connection that may not use it (a chat token). */
-	machinesAdminOnly: "Admin only",
-	/** The chip on a server's card: what this app's token may do there. */
-	machinesAccess: (scope) => scope === "admin" ? "Admin access" : "Chat access",
-	machinesGetAdmin: "Get admin",
-	machinesGetAdminRun: "Run this on the server:",
-	machinesGetAdminCopy: "Copy the command",
-	machinesGetAdminToken: "Then paste the token it prints:",
-	machinesGetAdminTokenField: "Admin token",
-	machinesGetAdminSave: "Use this token",
-	machinesGetAdminSaving: "Checking the token…",
-	machinesGetAdminSaved: "Connected with the admin token.",
-	machinesGetAdminPairNext: "Then sign out, and log in again with the code it prints.",
 	machinesFactUptime: (uptime) => `up ${uptime}`,
 	machinesOkLine: (name, version, latencyMs) => `${name} answered${version ? ` (zidane ${version})` : ""}${latencyMs !== void 0 ? ` in ${latencyMs} ms` : ""}.`,
 	/** What to do about a refusal, per registry error code; `message` is the backend's own words. */
@@ -121,23 +119,46 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesShareTokenPlaceholder: "A machine token of the server (zds_…)",
 	machinesShareStart: "Start sharing",
 	machinesSharing: (name) => `Sharing this computer with ${name}…`,
-	machinesShared: (roots, name) => `Sharing ${roots} with ${name}.`,
 	machinesStopping: "Stopping…",
 	machinesUseTitle: (name) => `Use ${name} as a machine`,
-	machinesUseMachineName: (machine) => `local@${machine}`,
+	machinesUseMachineName: (machine) => `Listed as ${machine}`,
 	machinesUseHint: (name) => `Run commands on ${name}. Chats stay here.`,
 	machinesUseNotLent: (name) => `${name} does not lend itself (allowAsMachine is off).`,
 	machinesUseStop: "Stop using",
 	machinesUse: "Use",
 	machinesConnectingTo: (name) => `Connecting to ${name}…`,
 	machinesListTitle: (name) => `Machines on ${name}`,
-	machinesListEmpty: "none yet",
+	machinesExplain: "Your server keeps your chats, settings and tools. Machines run the work on your projects and data.",
+	machinesHowItWorks: "How it works",
+	machinesEmptyTitle: (name) => `No machines on ${name} yet`,
+	machinesPictureApp: "This app",
+	machinesPictureAppFact: "Where you chat",
+	machinesPictureServer: "Server",
+	machinesPictureServerFact: "Keeps chats, settings and tools",
+	machinesPictureMachines: "Machines",
+	machinesPictureMachinesFact: "Run the work on your projects and data",
+	machinesServerBadge: "Server",
+	machinesServerRowHint: "Works in the server's own folders.",
+	machinesNewChat: "New chat",
+	machinesAddedTitle: (name) => `${name} is ready`,
+	machinesAddedNewChats: (name) => `Use ${name} for new chats`,
+	machinesAddedNewChatsHint: "New chats start there. You can still pick another place in each chat.",
+	machinesAddedShare: (name) => `Let ${name} run work on this computer`,
+	machinesAddedShareHint: "Pick the folders it can use. Sharing works while this app runs.",
+	machinesDraftServerOffline: (name) => `${name} is offline. Wait for it, or start this chat on this computer.`,
+	machinesUseThisComputer: "Use this computer",
+	machinesPlaceUnsaved: (name) => `New chats start on ${name}, but this computer has not added it. This chat starts here.`,
+	machinesPlaceAddServer: (name) => `Add ${name}`,
+	machinesPlaceMachineGone: (machine, host) => `${machine} is no longer a machine of ${host}. This chat starts on ${host}.`,
+	machinesPlaceFolderGone: (folder) => `${folder} is not there any more. This chat starts in the usual folder.`,
+	machinesNewChatLabel: (name) => `New chat on ${name}`,
+	machinesFoldersMore: (count) => `${count} more`,
 	machinesStatus: (status) => status,
 	machinesForget: "Forget",
 	machinesForgetLabel: (machine) => `Forget ${machine}`,
 	machinesForgetTitle: (machine) => `Forget ${machine}?`,
 	machinesForgetMessage: (name) => `${name} forgets it. Its sessions there stop working. To use it again, add it with a new join code.`,
-	machinesListNotPermitted: "Listing machines needs a chat token.",
+	machinesListNotPermitted: "The machine list is not available.",
 	/** An offline machine's chip: `when` is "14:05" today, else a date. */
 	machinesOfflineSince: (when) => `offline since ${when}`,
 	machinesVersion: (version) => `v${version.replace(/^v/, "")}`,
@@ -154,21 +175,49 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesInviteTitle: (name) => `Add a machine to ${name}`,
 	machinesInviteCommand: "Join command",
 	machinesInviteCopy: "Copy the join command",
-	machinesInviteExpires: (time) => `Works once, until ${time}.`,
-	machinesInviteHint: "Run it on the machine. It installs a service that joins this server.",
+	machinesInviteHint: "Run it on the machine. It installs zidane if needed, then a service that joins this server.",
 	machinesInviteDone: "Done",
-	machinesInviteNeedsAdmin: "Needs an admin token on this server.",
+	machinesAddAnother: "Another computer",
+	machinesAddThis: "This computer",
+	machinesAddWhich: "Which computer",
+	machinesAddTimeLeft: (minutes) => `${Math.max(1, minutes)} min left`,
+	machinesAddExpired: "This code ended. Make a new one to add the machine.",
+	machinesAddNewCode: "New code",
+	machinesAddWaiting: "Waiting for the machine to join…",
+	machinesAddPaired: (name) => name ? `${name} used the code. Waiting for it to connect…` : "The machine used the code. Waiting for it to connect…",
+	machinesAddRefused: (reason, name) => {
+		switch (reason) {
+			case "used": return "This code was already used. Make a new one.";
+			case "expired": return "This code ended. Make a new one.";
+			case "name": return "The server cannot use the name the machine sent. Run the command again with --name and letters, digits, dots, dashes or underscores.";
+			case "limit": return "The server has no room for another machine token. Revoke one you do not use in Tokens, then run the command again.";
+			case "name-taken": return `Another machine on this server is named ${name ?? "that"}. Run the command again with another --name, or forget the other machine.`;
+			case "version": return "The machine runs another zidane version than the server. Update it, then run the command again.";
+			case "id-bound": return "The server knows this machine with another token, or forgot it. Make a new code and run the command again.";
+			default: return "The server turned the machine away.";
+		}
+	},
+	machinesAddLocalAddress: "Other computers often cannot reach this address. Change it to one that the machine can reach.",
+	machinesAddAddress: "Server address",
+	machinesAddInstalled: "If zidane is already there:",
+	machinesAddKeepOn: "Keep it on when this app is closed",
+	machinesAddKeepOnHint: "Run one command in a terminal here. It installs a service that keeps this computer shared.",
+	machinesAddKeepOnOpen: "Get the command",
+	machinesAddThisTerminalHint: "Run it in a terminal on this computer. It installs a service that keeps it shared, even with this app closed.",
+	machinesAddInstalledCopy: "Copy the setup command",
+	machinesAddJoined: (machine, server) => `${machine} joined ${server}`,
+	machinesAddJoinedHint: "You can now start chats that run on it.",
+	machinesAddStartChat: "Start a chat on it",
+	machinesAddThisHint: (name) => `Let ${name} run commands in folders that you pick. Sharing works while this app runs.`,
 	machinesTokensName: "Name",
 	machinesTokensNamePlaceholder: "The device it is for",
-	machinesTokensScope: "Scope",
 	machinesTokensScopes: {
-		chat: "Chat",
-		admin: "Admin",
+		client: "Client",
 		machine: "Machine"
 	},
 	machinesTokensCreate: "Create token",
 	machinesTokensCreating: "Creating…",
-	machinesTokensCreated: (name) => `Copy the token for ${name} now: it is not shown again.`,
+	machinesTokensCreated: (name) => `Copy the token for ${name} now. It is not shown again.`,
 	machinesTokensRevoke: "Revoke",
 	machinesTokensRevokeLabel: (name) => `Revoke ${name}`,
 	machinesTokensRevokeTitle: (name) => `Revoke ${name}?`,
@@ -181,6 +230,13 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesTokensCreatedAt: (ago) => `created ${ago}`,
 	machinesTokensEmpty: "No tokens yet.",
 	machinesTokensList: "Tokens",
+	machinesPairOpen: "Pair a browser",
+	machinesPairCreating: "Making a code…",
+	machinesPairCode: "Pairing code",
+	machinesPairCopy: "Copy the pairing code",
+	machinesPairExpires: (time) => `Works once, until ${time}.`,
+	machinesPairHint: (url) => `Open ${url ?? "the web app"} in the browser and type this code.`,
+	machinesPairDone: "Done",
 	machinesDaemonMenu: (health) => `Daemon menu, ${health}`,
 	machinesDaemon: "Daemon",
 	machinesDaemonOff: "Daemon mode is off",
@@ -196,6 +252,10 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesDaemonNewerDetail: (versions) => `${versions} Relaunch Zidane to attach.`,
 	machinesDaemonOlder: "Daemon runs older code",
 	machinesDaemonOlderDetail: (versions) => `${versions} Restart it to update.`,
+	machinesDaemonOlderBusy: "Older daemon still busy",
+	machinesDaemonOlderBusyDetail: (versions) => `${versions} It is still finishing its work, and this window saves nothing beside it. Restart daemon now stops it.`,
+	machinesDaemonCliOlder: "zidane CLI is older than this app",
+	machinesDaemonCliOlderDetail: (versions) => `${versions} The daemon it starts can't serve this window, so chats run here. Update the zidane CLI on your PATH.`,
 	machinesDaemonRefused: "Daemon refused this window",
 	machinesDaemonConnecting: "Connecting…",
 	machinesDaemonUnreachable: "Can't reach the daemon",
@@ -234,6 +294,8 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesDaemonCopy: "Copy diagnostics",
 	machinesDaemonCopying: "Copying…",
 	machinesDaemonCopied: "Diagnostics copied.",
+	/** A daemon menu action failed. What it said goes under Details. */
+	machinesDaemonActionFailed: "The daemon action failed.",
 	machinesCapsMore: (count) => `+${count}`,
 	machinesCapsOs: {
 		darwin: "macOS",
@@ -276,6 +338,7 @@ const DEFAULT_MACHINES_LABELS = {
 	machinesAutoUpdateTitle: "Auto-update",
 	machinesSyncTitle: "Settings sync",
 	machinesMachinesTitle: "Machines",
+	machinesTokensTitle: "Tokens and browsers",
 	machinesSyncModes: SYNC_MODE_LABEL,
 	machinesSyncCategories: SYNC_CATEGORY_INFO,
 	machinesSyncStartsWithHosts: "Settings sync starts with remote hosts.",