@xfey/tutti 0.1.33 → 0.1.35

package/README.md

@@ -7,7 +7,7 @@
 它负责：
 
 - `tutti launch` 后的项目绑定、恢复和接管入口
-- 裸 `tutti` 启动 / 复用的 loopback Local Console 与既有项目 Host 编排
+- 裸 `tutti` 经 lifecycle lock 启动 / 复用的版本感知 loopback Local Console、独立 invocation context，以及既有项目 Host 编排
 - Fastify API、SSE、packaged static Web 产物服务和 server 生命周期
 - SQLite store、migrations、repository 与协作真相读写
 - `control-plane`、scheduler、`procedure-engine`、`run-engine`、`workspace-ops` 与 OpenAI provider 接入
@@ -25,10 +25,10 @@
 
 ## 当前状态
 
-- 已具备 Fastify host shell、后台 host manager CLI 套件、机器级 Local Console、Dev Runner、Host Project API、SSE、SQLite store、collaboration-state、workspace read-state、project timeline observability helper、Control Plane、Procedure / Run、workspace-ops、checks、Relay staged upload finalize、user skills 文件服务、artifacts 可视化产物查看层和 OpenAI / Codex provider 接入。
+- 已具备 Fastify host shell、后台 host manager CLI 套件、带 `service status / stop / restart`、卸载前 `shutdown`、并发启动锁、版本替换、独立 browser context、idle / package update cleanup 与私有日志的机器级 Local Console、Dev Runner、Host Project API、SSE、SQLite store、collaboration-state、workspace read-state、project timeline observability helper、Control Plane、Procedure / Run、workspace-ops、checks、Relay staged upload finalize、user skills 文件服务、artifacts 可视化产物查看层和 OpenAI / Codex provider 接入。
 - Host server 与 Local Console 支持在显式 `webStatic.root` 或 packaged `web/` 存在时服务 Web 静态产物；`/api/*`、SSE、health、host-local control 和 `/local-console/*` API 不被 SPA fallback 吞掉。
 - Root `pack:dry-run` 会先清理 build output、重新构建，再复制 `apps/web/dist` 到 package-local `web/`，生成临时 staging `@xfey/tutti` artifact，并校验 npm pack 文件列表包含 CLI、migrations、prompts、Web index、bundled `@tutti/shared` / `@tutti/relay-client` 以及它们的外部 runtime dependencies，同时排除源码、source map、日志、SQLite、`.env`、`.tutti-dev` 与测试产物。
-- Root `smoke:packed-cli` 同样从干净 build output 生成 staging `@xfey/tutti` tarball、在临时目录安装，并验证 SQLite native binding、`tutti --help` / `tutti launch --help` / `tutti archive --help` / `tutti --version`、migrations、prompts、Web static index、bundled internal dependencies、bundled external runtime dependencies、CLI QR dependency、仓库锁定的 `@openai/codex` binary 可执行性和临时全局安装路径；该 smoke 不需要 Tutti source repo 存在。
+- Root `smoke:packed-cli` 同样从干净 build output 生成 staging `@xfey/tutti` tarball、在临时目录安装，并验证 SQLite native binding、`tutti --help` / `tutti service --help` / `tutti service status` / `tutti shutdown --help` / `tutti launch --help` / `tutti archive --help` / `tutti --version`、migrations、prompts、Web static index、bundled internal dependencies、bundled external runtime dependencies、CLI QR dependency、仓库锁定的 `@openai/codex` binary 可执行性和临时全局安装路径；该 smoke 不需要 Tutti source repo 存在。
 - `prompts/` 是所有模型-facing prompt、指令模板和 Codex 执行模板的统一落点；长 prompt 不内联在 TypeScript 中。
 - Host Project API 只信任 Relay tunnel metadata 注入的 `relay_session_context`；direct loopback 缺少可信 context 时不作为浏览器工作区入口。
 - 详细模块落点见 `src/README.md`；logger redaction、command idempotency、schema、provider 与 Codex 边界以 `docs/system/` 对应 canonical 文档为准。

package/dist/server-shell/cli/args.d.ts

@@ -5,6 +5,12 @@ export type CliCommand = {
     topic?: string;
 } | {
     kind: "version";
+} | {
+    kind: "service";
+    action: "status" | "stop" | "restart";
+} | {
+    kind: "shutdown";
+    yes: boolean;
 } | {
     kind: "launch";
     target?: string;

package/dist/server-shell/cli/args.js

@@ -58,6 +58,36 @@ export function parseCliArgs(argv, cwd = process.cwd()) {
     if (command === "--version" || command === "-v" || command === "version") {
         return { kind: "version" };
     }
+    if (command === "service") {
+        const action = args.shift();
+        if (action === undefined || isHelpArg(action)) {
+            return { kind: "help", topic: "service" };
+        }
+        if (args.length > 0) {
+            if (hasHelpArg(args)) {
+                return { kind: "help", topic: "service" };
+            }
+            throw new LaunchError("git_bootstrap_failed", `Unsupported service option: ${args[0] ?? ""}`, "Run `tutti service --help` to see supported service commands.");
+        }
+        if (action !== "status" && action !== "stop" && action !== "restart") {
+            throw new LaunchError("git_bootstrap_failed", `Unsupported service command: ${action}`, "Run `tutti service --help` to see supported service commands.");
+        }
+        return { kind: "service", action };
+    }
+    if (command === "shutdown") {
+        let yes = false;
+        for (const arg of args) {
+            if (arg === "--yes") {
+                yes = true;
+                continue;
+            }
+            if (isHelpArg(arg)) {
+                return { kind: "help", topic: "shutdown" };
+            }
+            throw new LaunchError("git_bootstrap_failed", `Unsupported shutdown option: ${arg}`, "Run `tutti shutdown [--yes]`.");
+        }
+        return { kind: "shutdown", yes };
+    }
     if (command === "launch") {
         let target;
         let yes = false;

package/dist/server-shell/cli/cli.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
-import { formatCliError } from "./errors.js";
+import { formatCliError, formatCliErrorReason, LaunchError } from "./errors.js";
 import { parseCliArgs } from "./args.js";
 import { confirmTextFromTty, runBackgroundLaunchCommand, runForegroundLaunchCommand, runInternalHostRunCommand, } from "./launch-command.js";
 import { resolveExistingProjectContext } from "./project-resolver.js";
 import { runProviderSetupTui } from "./provider-tui.js";
-import { runArchiveCommand, runDoctorCommand, runForgetCommand, runInviteCommand, runLogsCommand, runProviderStatusCommand, runPsManageCommand, runPsCommand, runStopCommand, } from "./runtime-commands.js";
+import { runArchiveCommand, runDoctorCommand, runForgetCommand, runInviteCommand, runLogsCommand, runProviderStatusCommand, runPsManageCommand, runPsCommand, runStopCommand, listRuntimeProjects, } from "./runtime-commands.js";
 import { readCliVersion } from "./version.js";
-import { ensureLocalConsole, openLocalConsoleBrowser, runLocalConsoleProcess, } from "../local-console/index.js";
+import { ensureLocalConsole, openLocalConsoleBrowser, readLocalConsoleServiceStatus, restartLocalConsoleService, runLocalConsoleProcess, stopLocalConsoleService, } from "../local-console/index.js";
 const HELP_TEXT = `Usage:
   tutti
   tutti launch [target] [--yes] [--foreground]
+  tutti service <status|stop|restart>
   tutti ps [--manage] [--all]
   tutti invite [target]
   tutti stop [target]
@@ -19,6 +20,7 @@ const HELP_TEXT = `Usage:
 Advanced and diagnostic commands:
   tutti logs [target] [--tail 120]
   tutti doctor [target]
+  tutti shutdown [--yes]
   tutti archive <target> [--yes]
   tutti forget <target> [--yes]
 
@@ -27,7 +29,8 @@ Options:
   -v, --version   Show version.
 
 Notes:
-  tutti opens the machine-local project console in your browser.
+  tutti opens Tutti in your browser.
+  service manages only the local browser service, not project hosts.
   launch starts the host in the background by default.
   provider setup stores credentials in the machine-local Tutti provider store.
 `;
@@ -48,6 +51,25 @@ Commands:
   setup    Configure or replace the OpenAI-compatible provider credential.
   status   Show the redacted provider status for a project.
 `;
+const SERVICE_HELP_TEXT = `Usage:
+  tutti service status
+  tutti service stop
+  tutti service restart
+
+Commands:
+  status    Show the local browser service version, process, and log path.
+  stop      Stop only the local browser service; project hosts keep running.
+  restart   Replace the local browser service with the current CLI version.
+`;
+const SHUTDOWN_HELP_TEXT = `Usage:
+  tutti shutdown [--yes]
+
+Stops all project hosts on this machine and then stops the local browser service.
+Use this before uninstalling Tutti.
+
+Options:
+  --yes   Confirm machine-wide shutdown in a non-interactive terminal.
+`;
 const PS_HELP_TEXT = `Usage:
   tutti ps [--manage] [--all]
 
@@ -100,6 +122,12 @@ function helpForTopic(topic) {
     if (topic === "provider") {
         return PROVIDER_HELP_TEXT;
     }
+    if (topic === "service") {
+        return SERVICE_HELP_TEXT;
+    }
+    if (topic === "shutdown") {
+        return SHUTDOWN_HELP_TEXT;
+    }
     if (topic === "ps") {
         return PS_HELP_TEXT;
     }
@@ -159,10 +187,88 @@ async function runProviderSetupCommand(target) {
 async function runLocalConsoleCommand() {
     const console = await ensureLocalConsole();
     if (openLocalConsoleBrowser(console.url)) {
-        process.stdout.write(`Tutti Local Console is ready at ${console.endpoint.base_url}/console\n`);
+        process.stdout.write(`Tutti is ready at ${console.endpoint.base_url}/console\n`);
         return;
     }
-    process.stdout.write(["Open Tutti Local Console in a browser:", console.url, ""].join("\n"));
+    process.stdout.write(["Open Tutti in a browser:", console.url, ""].join("\n"));
+}
+async function runServiceCommand(action) {
+    if (action === "status") {
+        const status = await readLocalConsoleServiceStatus();
+        if (status.status === "stopped") {
+            return [`Tutti service: stopped`, `Log: ${status.log_path}`].join("\n");
+        }
+        if (status.status === "stale") {
+            return [
+                "Tutti service: stale",
+                `PID: ${status.pid}`,
+                `Endpoint: ${status.base_url}`,
+                `Started: ${status.started_at}`,
+                `Log: ${status.log_path}`,
+                "Run `tutti service restart` to recover it.",
+            ].join("\n");
+        }
+        return [
+            "Tutti service: running",
+            `Version: ${status.version}${status.update_required ? ` (current CLI: ${status.current_version})` : ""}`,
+            `PID: ${status.pid}`,
+            `Endpoint: ${status.base_url}`,
+            `Started: ${status.started_at}`,
+            `Log: ${status.log_path}`,
+        ].join("\n");
+    }
+    if (action === "stop") {
+        const result = await stopLocalConsoleService();
+        return [
+            result === "already_stopped" ? "Tutti service is already stopped." : "Tutti service stopped.",
+            "Project hosts were not affected. Run `tutti ps` to inspect them.",
+        ].join("\n");
+    }
+    const endpoint = await restartLocalConsoleService();
+    return [
+        "Tutti service restarted.",
+        `Version: ${endpoint.version}`,
+        `Endpoint: ${endpoint.base_url}`,
+    ].join("\n");
+}
+async function runShutdownCommand(yes) {
+    if (!yes) {
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            throw new LaunchError("shutdown_confirmation_required", "Machine-wide shutdown requires explicit confirmation", "Run `tutti shutdown --yes` after confirming that active project hosts may stop.");
+        }
+        const accepted = await confirmTextFromTty([
+            "Stop every Tutti project host on this machine and the local browser service?",
+            "Active collaborators and in-progress work may be interrupted.",
+        ].join("\n"));
+        if (!accepted) {
+            throw new LaunchError("shutdown_rejected", "Machine-wide shutdown was not confirmed", "No Tutti process was intentionally stopped.");
+        }
+    }
+    const projects = await listRuntimeProjects({ all: true });
+    const failures = [];
+    let stoppedHosts = 0;
+    for (const project of projects) {
+        try {
+            const message = await runStopCommand(project.project_id);
+            if (!message.includes("not running")) {
+                stoppedHosts += 1;
+            }
+        }
+        catch (error) {
+            failures.push(`${project.project_id}: ${formatCliErrorReason(error)}`);
+        }
+    }
+    const service = await stopLocalConsoleService();
+    if (failures.length > 0) {
+        throw new LaunchError("existing_server_unhealthy", `Tutti stopped ${stoppedHosts} project host(s), but ${failures.length} host(s) could not be stopped safely`, "Run `tutti ps --all` and inspect the remaining host processes before uninstalling.", { failures });
+    }
+    return [
+        `Stopped ${stoppedHosts} project host(s).`,
+        service === "already_stopped"
+            ? "The Tutti browser service was already stopped."
+            : "Stopped the Tutti browser service.",
+        "Tutti is ready to uninstall.",
+    ].join("\n");
 }
 try {
     const command = parseCliArgs(process.argv.slice(2));
@@ -176,6 +282,12 @@ try {
         case "version":
             process.stdout.write(`${readCliVersion()}\n`);
             break;
+        case "service":
+            process.stdout.write(`${await runServiceCommand(command.action)}\n`);
+            break;
+        case "shutdown":
+            process.stdout.write(`${await runShutdownCommand(command.yes)}\n`);
+            break;
         case "launch":
             if (command.foreground) {
                 await runForegroundLaunchCommand(command);

package/dist/server-shell/cli/errors.d.ts

@@ -1,4 +1,4 @@
-export type LaunchErrorCode = "unsafe_project_root" | "unsupported_tutti_schema" | "project_identity_conflict" | "git_bootstrap_failed" | "sensitive_file_detected" | "relay_unavailable" | "relay_registration_failed" | "host_not_running" | "archive_confirmation_required" | "archive_rejected" | "forget_confirmation_required" | "forget_rejected" | "project_target_ambiguous" | "project_target_not_found" | "provider_configuration_required" | "provider_setup_cancelled" | "provider_validation_failed" | "store_migration_failed" | "existing_server_unhealthy" | "takeover_rejected" | "takeover_failed" | "port_unavailable";
+export type LaunchErrorCode = "unsafe_project_root" | "unsupported_tutti_schema" | "project_identity_conflict" | "git_bootstrap_failed" | "sensitive_file_detected" | "relay_unavailable" | "relay_registration_failed" | "host_not_running" | "shutdown_confirmation_required" | "shutdown_rejected" | "archive_confirmation_required" | "archive_rejected" | "forget_confirmation_required" | "forget_rejected" | "project_target_ambiguous" | "project_target_not_found" | "provider_configuration_required" | "provider_setup_cancelled" | "provider_validation_failed" | "store_migration_failed" | "existing_server_unhealthy" | "takeover_rejected" | "takeover_failed" | "port_unavailable";
 export declare class LaunchError extends Error {
     readonly code: LaunchErrorCode;
     readonly next: string;

package/dist/server-shell/cli/host-runtime-endpoint.d.ts

@@ -3,6 +3,7 @@ import type { MachineRuntimeEndpointRecord } from "./machine-local.js";
 export type FetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
 export type HostRuntimeEndpointProbeResult = {
     kind: "alive";
+    version?: string;
     readiness?: {
         relay?: "not_connected" | "connected";
     };

package/dist/server-shell/cli/host-runtime-endpoint.js

@@ -13,15 +13,19 @@ function parseHostHealthPayload(value) {
     if (record.service !== "tutti-host" || record.status !== "ok") {
         return null;
     }
+    const version = typeof record.version === "string" ? record.version : undefined;
     if (typeof record.readiness !== "object" ||
         record.readiness === null ||
         Array.isArray(record.readiness)) {
-        return {};
+        return version === undefined ? {} : { version };
     }
     const readiness = record.readiness;
-    return readiness.relay === "connected" || readiness.relay === "not_connected"
-        ? { relay: readiness.relay }
-        : {};
+    return {
+        ...(version === undefined ? {} : { version }),
+        ...(readiness.relay === "connected" || readiness.relay === "not_connected"
+            ? { relay: readiness.relay }
+            : {}),
+    };
 }
 async function fetchWithTimeout(fetchImpl, url, init = {}, timeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
     const controller = new AbortController();
@@ -55,7 +59,8 @@ export function createRuntimeEndpointProbe(fetchImpl = fetch) {
             }
             return {
                 kind: "alive",
-                ...(readiness.relay === undefined ? {} : { readiness }),
+                ...(readiness.version === undefined ? {} : { version: readiness.version }),
+                ...(readiness.relay === undefined ? {} : { readiness: { relay: readiness.relay } }),
             };
         }
         catch (error) {

package/dist/server-shell/cli/launch.js

@@ -68,6 +68,7 @@ export async function prepareLaunchProject(options) {
         tuttiHome,
         projectId,
         workspaceRoot,
+        relayUrl,
         displayNameSnapshot: readProjectDisplayName(workspaceRoot) ?? (basename(workspaceRoot) || projectId),
     };
     if (options.allowWorkspaceRootTakeover !== undefined) {

package/dist/server-shell/cli/machine-local.d.ts

@@ -5,7 +5,9 @@ export type MachineProjectBindingRecord = {
     local_store_root: string;
     display_name_snapshot?: string;
     relay_project_ref?: RelayProjectRef;
+    relay_url?: string;
     host_registration_secret_ref?: string;
+    created_at?: string;
     updated_at: string;
 };
 export type HostRegistrationSecretFile = {
@@ -28,6 +30,7 @@ export type EnsureMachineProjectBindingOptions = {
     projectId: ProjectId;
     workspaceRoot: string;
     displayNameSnapshot?: string;
+    relayUrl?: string;
     allowWorkspaceRootTakeover?: boolean;
     now?: () => Date;
 };

package/dist/server-shell/cli/machine-local.js

@@ -78,7 +78,10 @@ export function readMachineProjectBinding(tuttiHome, projectId) {
             (typeof raw.relay_project_ref !== "string" ||
                 !isPrefixedId(raw.relay_project_ref, ID_PREFIXES.relayProject))) ||
         (raw.host_registration_secret_ref !== undefined &&
-            typeof raw.host_registration_secret_ref !== "string")) {
+            typeof raw.host_registration_secret_ref !== "string") ||
+        (raw.relay_url !== undefined &&
+            (typeof raw.relay_url !== "string" || raw.relay_url.trim() === "")) ||
+        (raw.created_at !== undefined && typeof raw.created_at !== "string")) {
         throw new LaunchError("project_identity_conflict", "Machine-local project binding is invalid or conflicts with the Git config project identity", "Inspect or remove the project binding under TUTTI_HOME after confirming it is not needed.");
     }
     const binding = {
@@ -93,9 +96,15 @@ export function readMachineProjectBinding(tuttiHome, projectId) {
     if (raw.relay_project_ref !== undefined) {
         binding.relay_project_ref = raw.relay_project_ref;
     }
+    if (raw.relay_url !== undefined) {
+        binding.relay_url = raw.relay_url;
+    }
     if (raw.host_registration_secret_ref !== undefined) {
         binding.host_registration_secret_ref = raw.host_registration_secret_ref;
     }
+    if (raw.created_at !== undefined) {
+        binding.created_at = raw.created_at;
+    }
     return binding;
 }
 export function readMachineRuntimeEndpoint(tuttiHome, projectId) {
@@ -226,7 +235,11 @@ function ensureHostRegistrationSecret(tuttiHome, projectId, now) {
     const secretPath = getHostRegistrationSecretPath(tuttiHome, projectId);
     const ref = createHostRegistrationSecretRef(projectId);
     if (existsSync(secretPath)) {
-        return { ref, created: false };
+        return {
+            ref,
+            created: false,
+            createdAt: readHostRegistrationSecret(tuttiHome, projectId).created_at,
+        };
     }
     const timestamp = now().toISOString();
     const secretFile = {
@@ -237,7 +250,7 @@ function ensureHostRegistrationSecret(tuttiHome, projectId, now) {
         updated_at: timestamp,
     };
     writePrivateJsonFile(secretPath, secretFile);
-    return { ref, created: true };
+    return { ref, created: true, createdAt: timestamp };
 }
 export function ensureMachineProjectBinding(options) {
     const now = options.now ?? (() => new Date());
@@ -256,6 +269,7 @@ export function ensureMachineProjectBinding(options) {
         workspace_root: workspaceRoot,
         local_store_root: localStoreRoot,
         host_registration_secret_ref: existing?.host_registration_secret_ref ?? secret.ref,
+        created_at: existing?.created_at ?? secret.createdAt,
         updated_at: now().toISOString(),
     };
     const displayNameSnapshot = options.displayNameSnapshot?.trim();
@@ -268,6 +282,13 @@ export function ensureMachineProjectBinding(options) {
     if (existing?.relay_project_ref !== undefined) {
         binding.relay_project_ref = existing.relay_project_ref;
     }
+    const relayUrl = options.relayUrl?.trim();
+    if (relayUrl !== undefined && relayUrl !== "") {
+        binding.relay_url = relayUrl;
+    }
+    else if (existing?.relay_url !== undefined) {
+        binding.relay_url = existing.relay_url;
+    }
     writePrivateJsonFile(bindingPath, binding);
     return {
         binding,

package/dist/server-shell/cli/machine-project-inspector.d.ts

@@ -41,6 +41,7 @@ export type MachineProjectHostInspection = {
 } | {
     kind: "running";
     identity_verified: boolean;
+    version?: string;
     relay_readiness?: "connected" | "not_connected";
     relay_connection_status?: "connecting" | "connected" | "reconnecting" | "unavailable" | "stopped";
 } | {

package/dist/server-shell/cli/machine-project-inspector.js

@@ -145,6 +145,7 @@ async function inspectHost(options) {
         return {
             kind: "running",
             identity_verified: status.project_id === options.projectId,
+            ...(probe.version === undefined ? {} : { version: probe.version }),
             ...(probe.readiness?.relay === undefined ? {} : { relay_readiness: probe.readiness.relay }),
             ...(status.relay_connection?.status === undefined
                 ? {}

package/dist/server-shell/cli/managed-host.d.ts

@@ -10,6 +10,7 @@ export type ManagedHostReadyResult = {
 export declare function spawnDetachedHost(options: {
     workspaceRoot: string;
     env?: NodeJS.ProcessEnv;
+    inheritProcessEnv?: boolean;
 }): void;
 export declare function waitForManagedHostReady(options: {
     tuttiHome: string;

package/dist/server-shell/cli/managed-host.js

@@ -30,10 +30,12 @@ export function spawnDetachedHost(options) {
     ], {
         cwd: options.workspaceRoot,
         detached: true,
-        env: {
-            ...process.env,
-            ...(options.env ?? {}),
-        },
+        env: options.inheritProcessEnv === false
+            ? options.env
+            : {
+                ...process.env,
+                ...(options.env ?? {}),
+            },
         stdio: "ignore",
     });
     child.unref();

package/dist/server-shell/cli/runtime-commands.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectId } from "@tutti/shared/ids";
+import type { ProjectId, RelayProjectRef } from "@tutti/shared/ids";
 import { type FetchLike } from "./host-runtime-endpoint.js";
 import { type MachineRuntimeEndpointRecord } from "./machine-local.js";
 import type { LocalControlFetch } from "./local-control-client.js";
@@ -9,12 +9,13 @@ export type RuntimeProjectRow = {
     workspace_root: string;
     endpoint?: string;
     provider_status?: string;
-    relay_project_ref?: string;
+    relay_project_ref?: RelayProjectRef;
     join_url?: string;
     relay_connection_status?: string;
     last_connected_at?: string;
     next_retry_at?: string;
     relay_reason_code?: string;
+    host_version?: string;
 };
 export declare function formatProjectIdForDisplay(projectId: ProjectId, projectIds: readonly ProjectId[]): string;
 export declare function listRuntimeProjects(options?: {

package/dist/server-shell/cli/runtime-commands.js

@@ -66,7 +66,8 @@ export function formatProjectIdForDisplay(projectId, projectIds) {
 }
 export async function listRuntimeProjects(options = {}) {
     const cwd = options.cwd ?? process.cwd();
-    const tuttiHome = resolveTuttiHome(options.env?.TUTTI_HOME, cwd);
+    const env = options.env ?? process.env;
+    const tuttiHome = resolveTuttiHome(env.TUTTI_HOME, cwd);
     const rows = [];
     const inspections = await inspectMachineProjects({
         tuttiHome,
@@ -90,6 +91,9 @@ export async function listRuntimeProjects(options = {}) {
             display_name: inspection.display_name,
             workspace_root: inspection.workspace_root ?? "-",
             ...(endpoint === undefined ? {} : { endpoint: endpoint.base_url }),
+            ...(inspection.host.kind !== "running" || inspection.host.version === undefined
+                ? {}
+                : { host_version: inspection.host.version }),
         };
         if (provider !== undefined) {
             row.provider_status = provider.status;
@@ -97,6 +101,10 @@ export async function listRuntimeProjects(options = {}) {
         if (launchStatus?.relay?.relay_project_ref !== undefined) {
             row.relay_project_ref = launchStatus.relay.relay_project_ref;
         }
+        else if (inspection.binding.kind === "valid" &&
+            inspection.binding.record.relay_project_ref !== undefined) {
+            row.relay_project_ref = inspection.binding.record.relay_project_ref;
+        }
         if (launchStatus?.relay?.join_url !== undefined) {
             row.join_url = launchStatus.relay.join_url;
         }

package/dist/server-shell/local-console/folder-picker.d.ts

@@ -17,5 +17,4 @@ export declare function pickLocalFolder(options?: {
     platform?: NodeJS.Platform;
     env?: NodeJS.ProcessEnv;
 }): Promise<LocalFolderPickResult>;
-export declare function createLocalProjectFolder(parentPath: string, childName: string): string;
 //# sourceMappingURL=folder-picker.d.ts.map

package/dist/server-shell/local-console/folder-picker.js

@@ -1,6 +1,6 @@
 import { execFile } from "node:child_process";
-import { constants, accessSync, existsSync, mkdirSync, statSync } from "node:fs";
-import { basename, delimiter, dirname, join, resolve } from "node:path";
+import { constants, accessSync, existsSync, statSync } from "node:fs";
+import { delimiter, join, resolve } from "node:path";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 function executableInPath(command, env) {
@@ -75,35 +75,4 @@ export async function pickLocalFolder(options = {}) {
         return { kind: "cancelled" };
     }
 }
-function validateChildName(value) {
-    const name = value.trim();
-    const hasControlCharacter = [...name].some((character) => {
-        const codePoint = character.codePointAt(0) ?? 0;
-        return codePoint <= 0x1f || codePoint === 0x7f;
-    });
-    if (name === "" ||
-        name === "." ||
-        name === ".." ||
-        name !== basename(name) ||
-        hasControlCharacter) {
-        throw new Error("Project folder name must be a single valid directory name.");
-    }
-    return name;
-}
-export function createLocalProjectFolder(parentPath, childName) {
-    const parent = resolve(parentPath.trim());
-    if (!existsSync(parent) || !statSync(parent).isDirectory()) {
-        throw new Error("Parent folder does not exist or is not a directory.");
-    }
-    accessSync(parent, constants.W_OK);
-    const child = resolve(parent, validateChildName(childName));
-    if (dirname(child) !== parent) {
-        throw new Error("Project folder must be created directly inside the selected parent.");
-    }
-    if (existsSync(child)) {
-        throw new Error("A file or folder with that name already exists.");
-    }
-    mkdirSync(child, { mode: 0o755 });
-    return child;
-}
 //# sourceMappingURL=folder-picker.js.map

package/dist/server-shell/local-console/invocation-context.d.ts

@@ -0,0 +1,21 @@
+export declare const LOCAL_CONSOLE_INVOCATION_ENV_KEYS: readonly ["DBUS_SESSION_BUS_ADDRESS", "DISPLAY", "LANG", "LC_ALL", "LC_CTYPE", "PATH", "TUTTI_HOST_ENDPOINT_HOST", "TUTTI_HOST_ENDPOINT_PORT", "TUTTI_RELAY_URL", "WAYLAND_DISPLAY", "XDG_CURRENT_DESKTOP"];
+export type LocalConsoleInvocationEnvironment = Partial<Record<(typeof LOCAL_CONSOLE_INVOCATION_ENV_KEYS)[number], string>>;
+export type LocalConsoleInvocationContext = {
+    currentDirectory: string;
+    environment: LocalConsoleInvocationEnvironment;
+};
+export declare function collectLocalConsoleInvocationEnvironment(env: NodeJS.ProcessEnv): LocalConsoleInvocationEnvironment;
+export declare function createLocalConsoleInvocationContext(options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}): LocalConsoleInvocationContext;
+export declare function createLocalConsoleServiceEnvironment(options: {
+    env: NodeJS.ProcessEnv;
+    tuttiHome: string;
+}): NodeJS.ProcessEnv;
+export declare function createLocalConsoleOperationEnvironment(options: {
+    serviceEnvironment: NodeJS.ProcessEnv;
+    invocationEnvironment: LocalConsoleInvocationEnvironment;
+    tuttiHome: string;
+}): NodeJS.ProcessEnv;
+//# sourceMappingURL=invocation-context.d.ts.map

package/dist/server-shell/local-console/invocation-context.js

@@ -0,0 +1,56 @@
+import { resolve } from "node:path";
+export const LOCAL_CONSOLE_INVOCATION_ENV_KEYS = [
+    "DBUS_SESSION_BUS_ADDRESS",
+    "DISPLAY",
+    "LANG",
+    "LC_ALL",
+    "LC_CTYPE",
+    "PATH",
+    "TUTTI_HOST_ENDPOINT_HOST",
+    "TUTTI_HOST_ENDPOINT_PORT",
+    "TUTTI_RELAY_URL",
+    "WAYLAND_DISPLAY",
+    "XDG_CURRENT_DESKTOP",
+];
+export function collectLocalConsoleInvocationEnvironment(env) {
+    const environment = {};
+    for (const key of LOCAL_CONSOLE_INVOCATION_ENV_KEYS) {
+        const value = env[key];
+        if (value !== undefined && value !== "") {
+            environment[key] = value;
+        }
+    }
+    return environment;
+}
+export function createLocalConsoleInvocationContext(options) {
+    return {
+        currentDirectory: resolve(options.cwd),
+        environment: collectLocalConsoleInvocationEnvironment(options.env),
+    };
+}
+export function createLocalConsoleServiceEnvironment(options) {
+    const environment = { TUTTI_HOME: options.tuttiHome };
+    for (const key of [
+        "HOME",
+        "LANG",
+        "LC_ALL",
+        "LC_CTYPE",
+        "LOGNAME",
+        "TMPDIR",
+        "USER",
+    ]) {
+        const value = options.env[key];
+        if (value !== undefined && value !== "") {
+            environment[key] = value;
+        }
+    }
+    return environment;
+}
+export function createLocalConsoleOperationEnvironment(options) {
+    return {
+        ...options.serviceEnvironment,
+        ...options.invocationEnvironment,
+        TUTTI_HOME: options.tuttiHome,
+    };
+}
+//# sourceMappingURL=invocation-context.js.map

package/dist/server-shell/local-console/lifecycle-lock.d.ts

@@ -0,0 +1,13 @@
+type LifecycleLockTiming = {
+    staleMs: number;
+    waitMs: number;
+    pollMs: number;
+};
+export declare function withLocalConsoleLifecycleLock<T>(options: {
+    tuttiHome: string;
+    run: () => Promise<T>;
+    now?: () => number;
+    timing?: Partial<LifecycleLockTiming>;
+}): Promise<T>;
+export {};
+//# sourceMappingURL=lifecycle-lock.d.ts.map