@xfey/tutti 0.1.32 → 0.1.34

package/README.md

@@ -2,11 +2,12 @@
 
 ## 作用
 
-`apps/server` 是 Tutti 的项目 host service。
+`apps/server` 是 Tutti 的项目 host service，也是机器级 Local Console 的进程入口。
 
 它负责：
 
 - `tutti launch` 后的项目绑定、恢复和接管入口
+- 裸 `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 接入
@@ -24,10 +25,10 @@
 
 ## 当前状态
 
-- 已具备 Fastify host shell、后台 host manager CLI 套件、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 支持在显式 `webStatic.root` 或 packaged `web/` 存在时服务 Web 静态产物；`/api/*`、SSE、health 和 host-local control 不被 SPA fallback 吞掉。
+- 已具备 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

@@ -1,8 +1,16 @@
 export type CliCommand = {
+    kind: "console";
+} | {
     kind: "help";
     topic?: string;
 } | {
     kind: "version";
+} | {
+    kind: "service";
+    action: "status" | "stop" | "restart";
+} | {
+    kind: "shutdown";
+    yes: boolean;
 } | {
     kind: "launch";
     target?: string;
@@ -12,6 +20,8 @@ export type CliCommand = {
     kind: "internal-host-run";
     workspacePath: string;
     yes: boolean;
+} | {
+    kind: "internal-console-run";
 } | {
     kind: "ps";
     manage: boolean;

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

@@ -49,12 +49,45 @@ function readOptionalTarget(args) {
 export function parseCliArgs(argv, cwd = process.cwd()) {
     const args = [...argv];
     const command = args.shift();
-    if (command === undefined || command === "--help" || command === "-h" || command === "help") {
+    if (command === undefined) {
+        return { kind: "console" };
+    }
+    if (command === "--help" || command === "-h" || command === "help") {
         return { kind: "help", ...(args[0] === undefined ? {} : { topic: args[0] }) };
     }
     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;
@@ -83,6 +116,12 @@ export function parseCliArgs(argv, cwd = process.cwd()) {
     }
     if (command === "internal") {
         const internalCommand = args.shift();
+        if (internalCommand === "console-run") {
+            if (args.length > 0) {
+                throw new LaunchError("git_bootstrap_failed", "Internal console-run does not accept options", "Internal commands are managed by Tutti.");
+            }
+            return { kind: "internal-console-run" };
+        }
         if (internalCommand !== "host-run") {
             throw new LaunchError("git_bootstrap_failed", "Unsupported internal command", "Internal commands are managed by Tutti.");
         }

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

@@ -1,28 +1,36 @@
 #!/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, 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]
-  tutti archive <target> [--yes]
-  tutti forget <target> [--yes]
-  tutti logs [target] [--tail 120]
   tutti provider setup [target]
   tutti provider status [target]
+
+Advanced and diagnostic commands:
+  tutti logs [target] [--tail 120]
   tutti doctor [target]
+  tutti shutdown [--yes]
+  tutti archive <target> [--yes]
+  tutti forget <target> [--yes]
 
 Options:
   -h, --help      Show help.
   -v, --version   Show version.
 
 Notes:
+  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.
 `;
@@ -43,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]
 
@@ -95,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;
     }
@@ -151,15 +184,110 @@ async function runProviderSetupCommand(target) {
     ].join("\n"));
     process.stdout.write("\n");
 }
+async function runLocalConsoleCommand() {
+    const console = await ensureLocalConsole();
+    if (openLocalConsoleBrowser(console.url)) {
+        process.stdout.write(`Tutti is ready at ${console.endpoint.base_url}/console\n`);
+        return;
+    }
+    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));
     switch (command.kind) {
+        case "console":
+            await runLocalConsoleCommand();
+            break;
         case "help":
             process.stdout.write(helpForTopic(command.topic));
             break;
         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);
@@ -172,6 +300,9 @@ try {
         case "internal-host-run":
             await runInternalHostRunCommand(command);
             break;
+        case "internal-console-run":
+            await runLocalConsoleProcess();
+            break;
         case "ps":
             if (command.manage) {
                 await runPsManageCommand({ all: command.all });

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/host-server-runtime.js

@@ -1,6 +1,4 @@
-import { existsSync } from "node:fs";
-import { basename, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { basename, join } from "node:path";
 import { serializeRuntimeLogLine } from "@tutti/shared/utils";
 import { completeRelayUpload, resolveRelayUpload } from "@tutti/relay-client";
 import { ApprovalRequestManager } from "../../approvals/index.js";
@@ -14,6 +12,7 @@ import { readProviderUsageProjection, recordProviderUsageEvent, } from "../../pr
 import { resolveProjectOpenAiRunPipelineRunner } from "../../run-pipeline/openai.js";
 import { openHostProjectStore } from "../../store/index.js";
 import { cleanupStaleRunWorkspaces } from "../../workspace-ops/index.js";
+import { resolvePackagedWebStaticRoot } from "../http/static-web.js";
 import { AGENT_CONTEXT_BASE_PATH, AgentContextTokenRegistry, } from "../http/routes/agent-context.js";
 import { readHostRepoProjection } from "../http/routes/project-api.js";
 import { WorkspaceEventBus } from "../http/workspace-events.js";
@@ -38,13 +37,6 @@ function createHostRuntimeLogger(options) {
         },
     };
 }
-function resolvePackagedWebStaticRoot(env = process.env) {
-    if (env.TUTTI_WEB_STATIC_ROOT !== undefined && env.TUTTI_WEB_STATIC_ROOT.trim() !== "") {
-        return resolve(env.TUTTI_WEB_STATIC_ROOT);
-    }
-    const packagedRoot = fileURLToPath(new URL("../../../web", import.meta.url));
-    return existsSync(join(packagedRoot, "index.html")) ? packagedRoot : undefined;
-}
 function createAgentContextRuntime(options) {
     return {
         baseUrl: new URL(AGENT_CONTEXT_BASE_PATH, options.baseUrl).toString(),

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

@@ -15,6 +15,7 @@ export type RuntimeProjectRow = {
     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;

package/dist/server-shell/http/routes/project-api/project-timeline-projection.js

@@ -12,10 +12,10 @@ const RUN_USAGE_SOURCES = [
 const TASK_ACCEPTED_USAGE_SOURCES = ["task_compile"];
 const TRACE_CONSENSUS_LIMIT = 3;
 const TRACE_TASK_CHANGE_LIMIT = 2;
-const TRACE_CONTRACT_SCOPE_LIMIT = 5;
-const TRACE_CHANGED_PATH_LIMIT = 6;
-const TRACE_CHECKPOINT_ITEM_LIMIT = 5;
-const TRACE_GENERATED_FILE_LIMIT = 5;
+const TRACE_CONTRACT_SCOPE_LIMIT = 40;
+const TRACE_CHANGED_PATH_LIMIT = 100;
+const TRACE_CHECKPOINT_ITEM_LIMIT = 50;
+const TRACE_GENERATED_FILE_LIMIT = 50;
 const TRACE_SOURCE_SNIPPET_LIMIT = 3;
 const TRACE_SOURCE_SNIPPET_BODY_LIMIT = 280;
 const TRACE_CHANGE_LINK_LIMIT = 3;

package/dist/server-shell/http/static-web.d.ts

@@ -3,4 +3,5 @@ export type HostWebStaticOptions = {
     root: string;
 };
 export declare function registerHostWebStaticRoutes(app: FastifyInstance, options: HostWebStaticOptions): void;
+export declare function resolvePackagedWebStaticRoot(env?: NodeJS.ProcessEnv): string | undefined;
 //# sourceMappingURL=static-web.d.ts.map

package/dist/server-shell/http/static-web.js

@@ -1,10 +1,12 @@
 import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import fastifyStatic from "@fastify/static";
 const BLOCKED_SPA_FALLBACK_PREFIXES = [
     "/api/",
     "/health",
     "/host-local/",
+    "/local-console/",
     "/assets/",
 ];
 function requestPath(request) {
@@ -49,4 +51,15 @@ export function registerHostWebStaticRoutes(app, options) {
         sendIndex(reply, indexHtml);
     });
 }
+export function resolvePackagedWebStaticRoot(env = process.env) {
+    if (env.TUTTI_WEB_STATIC_ROOT !== undefined && env.TUTTI_WEB_STATIC_ROOT.trim() !== "") {
+        return resolve(env.TUTTI_WEB_STATIC_ROOT);
+    }
+    const packagedRoot = fileURLToPath(new URL("../../../web", import.meta.url));
+    if (existsSync(join(packagedRoot, "index.html"))) {
+        return packagedRoot;
+    }
+    const workspaceWebDist = fileURLToPath(new URL("../../../../web/dist", import.meta.url));
+    return existsSync(join(workspaceWebDist, "index.html")) ? workspaceWebDist : undefined;
+}
 //# sourceMappingURL=static-web.js.map

package/dist/server-shell/local-console/browser-open.d.ts

@@ -0,0 +1,5 @@
+export declare function openLocalConsoleBrowser(url: string, options?: {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+}): boolean;
+//# sourceMappingURL=browser-open.d.ts.map

package/dist/server-shell/local-console/browser-open.js

@@ -0,0 +1,40 @@
+import { spawn } from "node:child_process";
+import { constants, accessSync } from "node:fs";
+import { delimiter, join } from "node:path";
+function executableInPath(command, env) {
+    for (const directory of (env.PATH ?? "").split(delimiter)) {
+        if (directory.trim() === "") {
+            continue;
+        }
+        const candidate = join(directory, command);
+        try {
+            accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch {
+            // Keep searching PATH.
+        }
+    }
+    return null;
+}
+export function openLocalConsoleBrowser(url, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const env = options.env ?? process.env;
+    const command = platform === "darwin"
+        ? "/usr/bin/open"
+        : platform === "linux" && (env.DISPLAY !== undefined || env.WAYLAND_DISPLAY !== undefined)
+            ? executableInPath("xdg-open", env)
+            : null;
+    if (command === null) {
+        return false;
+    }
+    const child = spawn(command, [url], {
+        detached: true,
+        env,
+        stdio: "ignore",
+    });
+    child.on("error", () => undefined);
+    child.unref();
+    return true;
+}
+//# sourceMappingURL=browser-open.js.map

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

@@ -0,0 +1,20 @@
+export type LocalFolderPickerKind = "macos" | "zenity" | "kdialog" | "unavailable";
+export type LocalFolderPickResult = {
+    kind: "selected";
+    path: string;
+} | {
+    kind: "cancelled";
+} | {
+    kind: "unavailable";
+    message: string;
+};
+export declare function detectLocalFolderPicker(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): {
+    kind: LocalFolderPickerKind;
+    executable?: string;
+};
+export declare function pickLocalFolder(options?: {
+    prompt?: string;
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+}): Promise<LocalFolderPickResult>;
+//# sourceMappingURL=folder-picker.d.ts.map