@chatcode/chatcode-cli 3.0.3 → 3.0.4-rc.2

package/lib/web-instance-DbP7IHPv.js

@@ -0,0 +1,280 @@
+import { dirname, join } from "node:path";
+import { randomBytes, timingSafeEqual } from "node:crypto";
+import { mkdir, readFile, rm } from "node:fs/promises";
+import { provideCmdline } from "@deepseek-ai/dsh-cmdline";
+import { request } from "node:http";
+import { connect } from "node:net";
+import { Context } from "@deepseek-ai/cordis";
+import { brandString } from "@deepseek-ai/dsh-brand";
+import { withFileLock, writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
+import * as WebStartup from "@deepseek-ai/dsh-web-app/startup";
+//#region lib/types/web-instance.js
+/** Private, verified Web instance discovery shared by terminal and standalone launches. */
+const CONTROL_PATH = "/.chatcode-cli/web-instance";
+const START_WAIT_MS = 12e4;
+/** A usage diagnostic already printed by the Web app's own argument parser. */
+var WebUsageError = class extends Error {
+	exitCode;
+	/** @param exitCode - exit status selected by the app argument parser. */
+	constructor(exitCode) {
+		super("Web command-line parsing finished");
+		this.exitCode = exitCode;
+	}
+};
+async function validateArguments(args) {
+	const ctx = new Context();
+	let code;
+	provideCmdline(ctx, {
+		args,
+		exit: (value) => {
+			code = value;
+		},
+		ready: { onReady: () => () => {} }
+	});
+	try {
+		WebStartup.apply(ctx);
+	} finally {
+		await ctx.fiber.dispose();
+	}
+	if (code !== void 0) throw new WebUsageError(code);
+}
+/** Resolve the private instance record under the launcher's canonical home.
+* @param home - absolute ChatCode CLI home.
+* @returns the one default Web registration path.
+*/
+function webInstancePath(home) {
+	return join(home, "web", "instance.json");
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function localUrl(value, token) {
+	if (typeof value !== "string") return void 0;
+	try {
+		const url = new URL(value);
+		if (url.protocol !== "http:" || url.hostname !== "127.0.0.1" || url.port === "" || url.username !== "" || url.password !== "" || url.hash !== "" || url.pathname !== "/") return void 0;
+		if (token ? !url.searchParams.get("token") : url.search !== "") return void 0;
+		return url;
+	} catch {
+		return;
+	}
+}
+async function readInstance(path) {
+	let text;
+	try {
+		text = await readFile(path, "utf8");
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
+	}
+	let value;
+	try {
+		value = JSON.parse(text);
+	} catch (_invalidJson) {
+		throw new Error("Web 实例登记无法解析；未启动或关闭任何进程。");
+	}
+	if (!isRecord(value) || value.version !== 1 || typeof value.id !== "string" || typeof value.pid !== "number" || !Number.isInteger(value.pid) || value.pid < 1 || value.pid > 2147483647 || typeof value.secret !== "string" || !/^[a-f0-9]{64}$/u.test(value.secret) || typeof value.origin !== "string" || localUrl(value.origin, false) === void 0) throw new Error("Web 实例登记无效；未启动或关闭任何进程。");
+	return {
+		version: 1,
+		id: brandString(value.id),
+		pid: value.pid,
+		origin: value.origin,
+		secret: value.secret
+	};
+}
+function processExists(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		if (error.code === "ESRCH") return false;
+		throw error;
+	}
+}
+/** Local HTTP avoids inherited proxies and never follows a redirect carrying the management secret. */
+async function control(record, method) {
+	return new Promise((resolve, reject) => {
+		const req = request(`${record.origin}${CONTROL_PATH}`, {
+			method,
+			headers: {
+				authorization: `Bearer ${record.secret}`,
+				connection: "close"
+			}
+		}, (res) => {
+			const chunks = [];
+			let size = 0;
+			res.on("data", (chunk) => {
+				size += chunk.length;
+				if (size > 16384) req.destroy(/* @__PURE__ */ new Error("Web 实例响应过大。"));
+				else chunks.push(chunk);
+			});
+			res.on("error", reject);
+			res.on("end", () => {
+				try {
+					if (res.statusCode !== 200) throw new Error("Web 实例未通过认证；不会复用或关闭此端口上的其他服务。");
+					const value = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+					if (!isRecord(value) || value.id !== record.id || value.pid !== record.pid || localUrl(value.url, true)?.origin !== record.origin || typeof value.url !== "string") throw new Error("Web 实例身份不匹配；未关闭任何进程。");
+					resolve({
+						id: record.id,
+						pid: record.pid,
+						url: value.url
+					});
+				} catch (error) {
+					reject(error instanceof Error ? error : new Error("Web 实例响应无效。", { cause: error }));
+				}
+			});
+		});
+		req.setTimeout(2e3, () => req.destroy(/* @__PURE__ */ new Error("Web 实例暂未响应；请稍后重试。")));
+		req.on("error", (error) => {
+			if (error.code === "ECONNREFUSED") resolve(void 0);
+			else reject(error);
+		});
+		req.end();
+	});
+}
+/** Install authenticated local control routes and publish only after the profile is ready.
+* @param ctx - root profile context, after the application tree has settled.
+* @param registration - random process identity and private record path.
+* @param stop - whole-profile shutdown, invoked only for authenticated explicit off requests.
+* @returns after the initial registration has been written; returns without registering for help-only launches.
+*/
+async function registerWebInstance(ctx, registration, stop) {
+	if (ctx.get("webServer") === void 0 || ctx.get("connection") === void 0) return;
+	let disposed = false;
+	let published = Promise.resolve();
+	const status = () => {
+		const web = ctx.get("webServer");
+		const connection = ctx.get("connection");
+		if (web === void 0 || connection === void 0) throw new Error("Web 服务正在重载。");
+		return {
+			id: registration.id,
+			pid: process.pid,
+			url: connection.authenticatedUrl(`http://127.0.0.1:${web.port}`)
+		};
+	};
+	ctx.inject(["webServer", "connection"], (owner) => {
+		owner.effect(() => owner.webServer.register({
+			kind: "exact",
+			path: CONTROL_PATH,
+			handler(req, res) {
+				res.setHeader("cache-control", "no-store");
+				const auth = req.headers.authorization ?? "";
+				const expected = `Bearer ${registration.secret}`;
+				if (![
+					"127.0.0.1",
+					"::ffff:127.0.0.1",
+					"::1"
+				].includes(req.socket.remoteAddress ?? "") || Buffer.byteLength(auth) !== Buffer.byteLength(expected) || !timingSafeEqual(Buffer.from(auth), Buffer.from(expected))) {
+					res.writeHead(401).end();
+					return;
+				}
+				if (req.method !== "GET" && req.method !== "POST") {
+					res.writeHead(405).end();
+					return;
+				}
+				if (disposed) {
+					res.writeHead(503).end();
+					return;
+				}
+				res.setHeader("content-type", "application/json");
+				if (req.method === "POST") res.once("finish", stop);
+				res.end(JSON.stringify(status()));
+			}
+		}));
+		const current = status();
+		published = published.then(() => writeFileAtomic(registration.path, JSON.stringify({
+			version: 1,
+			id: current.id,
+			pid: current.pid,
+			origin: new URL(current.url).origin,
+			secret: registration.secret
+		}), {
+			mode: 384,
+			dirMode: 448
+		}));
+		return published;
+	});
+	ctx.effect(() => async () => {
+		disposed = true;
+		await published;
+		if ((await readInstance(registration.path))?.id === registration.id) await rm(registration.path, { force: true });
+	});
+	await ctx.loader.await();
+	await published;
+}
+function listenerOpen(origin) {
+	return new Promise((resolve, reject) => {
+		const socket = connect({
+			host: "127.0.0.1",
+			port: Number(new URL(origin).port)
+		});
+		socket.once("connect", () => {
+			socket.destroy();
+			resolve(true);
+		});
+		socket.setTimeout(1e3, () => {
+			socket.destroy();
+			resolve(true);
+		});
+		socket.once("error", (error) => {
+			socket.destroy();
+			if (error.code === "ECONNREFUSED") resolve(false);
+			else reject(error);
+		});
+	});
+}
+/** Start once or reopen a verified existing instance; off waits for its listener to close.
+* @param options - canonical home, app arguments, and launcher-owned boot/browser operations.
+* @returns after boot, reuse, or an explicit stop has settled.
+*/
+async function runManagedWeb(options) {
+	const action = options.args[0] === "on" || options.args[0] === "off" ? options.args[0] : "on";
+	const args = options.args[0] === action ? options.args.slice(1) : options.args;
+	const portFlag = args.findIndex((arg) => arg === "--port" || arg.startsWith("--port="));
+	const port = portFlag < 0 ? void 0 : args[portFlag]?.split("=")[1] ?? args[portFlag + 1];
+	if (args.includes("--help") || args.includes("-h") || port === "0") {
+		if (action === "off" && port === "0") throw new Error("Web off 不支持随机端口。");
+		await options.start(void 0, args);
+		return;
+	}
+	await validateArguments(args);
+	const path = webInstancePath(options.home);
+	await mkdir(dirname(path), {
+		recursive: true,
+		mode: 448
+	});
+	await withFileLock(path, async () => {
+		const record = await readInstance(path);
+		const existing = record !== void 0 && processExists(record.pid) ? await control(record, "GET") : void 0;
+		if (record !== void 0 && processExists(record.pid) && existing === void 0) throw new Error("登记的 Web 进程仍在运行，但服务尚未就绪；请稍后重试，不会重复启动。");
+		if (existing !== void 0 && record !== void 0) {
+			if (port !== void 0 && Number(port) !== Number(new URL(existing.url).port)) throw new Error("已有 Web 实例使用不同端口；请先执行 cco web off，再指定新端口启动。");
+			if (action === "off") {
+				await control(record, "POST");
+				const deadline = Date.now() + 6e3;
+				while (await listenerOpen(record.origin)) {
+					if (Date.now() >= deadline) throw new Error("Web 正在关闭，但端口尚未释放；请稍后重试。");
+					await new Promise((resolve) => setTimeout(resolve, 50));
+				}
+				if ((await readInstance(path))?.id === record.id) await rm(path, { force: true });
+				options.print("cco web: stopped");
+			} else {
+				options.print(`cco web: ${existing.url}`);
+				if (!args.includes("--no-open")) await options.open(existing.url);
+			}
+			return;
+		}
+		if (record !== void 0) await rm(path, { force: true });
+		if (action === "off") {
+			options.print("cco web: stopped");
+			return;
+		}
+		await options.start({
+			path,
+			id: brandString(randomBytes(16).toString("hex")),
+			secret: randomBytes(32).toString("hex")
+		}, args);
+	}, { waitMs: START_WAIT_MS });
+}
+//#endregion
+export { webInstancePath as i, registerWebInstance as n, runManagedWeb as r, WebUsageError as t };

package/lib/{workspaces-Bb3kCAFb.js → workspaces-1xrm-e3V.js}

@@ -1,8 +1,8 @@
-import { a as compositionRoot, i as bindCallerEffect, n as activationFiber, o as concreteService, s as requirePluginCaller } from "./host-access-DeCjoRQP.js";
+import { a as compositionRoot, i as bindCallerEffect, n as activationFiber, o as concreteService, s as requirePluginCaller } from "./host-access-B0CRAwsX.js";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { basename, isAbsolute, resolve } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
-//#region ../../node_modules/.pnpm/@chatcode+cco-tui@0.10.0-rc.16_08ea48c8555976e562c6368d51cb542b/node_modules/@chatcode/cco-tui/lib/types/dsh-adapter/workspaces.js
+//#region ../../node_modules/.pnpm/@chatcode+cco-tui@0.10.0-rc.19_08ea48c8555976e562c6368d51cb542b/node_modules/@chatcode/cco-tui/lib/types/dsh-adapter/workspaces.js
 /**
 * Workspace-target extension seam for terminal front doors.
 *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chatcode/chatcode-cli",
   "description": "ChatCode CLI: TUI-first coding agent, Web launcher, profiles, and legacy DSH-compatible plugins",
-  "version": "3.0.3",
+  "version": "3.0.4-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -28,14 +28,15 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "1.4.0",
     "@babel/code-frame": "^7.29.0",
-    "@chatcode/cco-better-sidebar": "0.18.0-rc.3",
+    "@chatcode/cco-better-sidebar": "0.18.0-rc.7",
     "@chatcode/cco-builtin-browser": "0.1.21",
-    "@chatcode/cco-chat-import": "0.15.0",
-    "@chatcode/cco-llm-chatcode-config": "0.1.4-rc.4",
-    "@chatcode/cco-market": "1.45.2-rc.3",
-    "@chatcode/cco-tui": "0.10.0-rc.16",
+    "@chatcode/cco-chat-import": "0.16.0",
+    "@chatcode/cco-computer-use": "0.3.2",
+    "@chatcode/cco-llm-chatcode-config": "0.1.4-rc.8",
+    "@chatcode/cco-market": "1.45.2-rc.4",
+    "@chatcode/cco-tui": "0.10.0-rc.19",
     "@deepseek-ai/libreoffice-kit": "^0.1.1",
-    "@deepseek-harness-tui/dsh-tui": "npm:@chatcode/cco-tui@0.10.0-rc.16",
+    "@deepseek-harness-tui/dsh-tui": "npm:@chatcode/cco-tui@0.10.0-rc.19",
     "@earendil-works/pi-ai": "^0.85.1",
     "@eslint-community/regexpp": "^4.12.2",
     "@joplin/turndown-plugin-gfm": "^1.0.67",
@@ -57,11 +58,12 @@
     "commander": "^15.0.0",
     "compression": "^1.8.1",
     "diff": "^9.0.0",
-    "dsh-better-sidebar": "npm:@chatcode/cco-better-sidebar@0.18.0-rc.3",
+    "dsh-better-sidebar": "npm:@chatcode/cco-better-sidebar@0.18.0-rc.7",
     "dsh-builtin-browser": "npm:@chatcode/cco-builtin-browser@0.1.21",
-    "dsh-chat-import": "npm:@chatcode/cco-chat-import@0.15.0",
-    "dsh-llm-chatcode-config": "npm:@chatcode/cco-llm-chatcode-config@0.1.4-rc.4",
-    "dshmarket": "npm:@chatcode/cco-market@1.45.2-rc.3",
+    "dsh-chat-import": "npm:@chatcode/cco-chat-import@0.16.0",
+    "dsh-computer-use": "npm:@chatcode/cco-computer-use@0.3.2",
+    "dsh-llm-chatcode-config": "npm:@chatcode/cco-llm-chatcode-config@0.1.4-rc.8",
+    "dshmarket": "npm:@chatcode/cco-market@1.45.2-rc.4",
     "eventsource-parser": "^3.1.0",
     "execa": "^10.0.0",
     "fflate": "^0.8.2",
@@ -87,6 +89,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "playwright": "^1.49.0",
     "@agentclientprotocol/sdk": "1.4.0",
     "@types/js-yaml": "^4.0.9",
     "@types/ws": "8.18.1",
@@ -95,45 +98,45 @@
     "ws": "8.21.0",
     "@deepseek-ai/dsh-acp": "0.1.7-rc.2",
     "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-credentials-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment-local": "0.1.7-rc.2",
     "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials-local": "0.1.7-rc.2",
     "@deepseek-ai/dsh-experimental-agent-team": "0.1.7-rc.2",
     "@deepseek-ai/dsh-agent-loop-testkit": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-attachment-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-experimental-tool-agent-team": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-fs-sandbox": "0.1.7-rc.2",
     "@deepseek-ai/dsh-experimental-ptc-runtime-python": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-host-frontend-static": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-bash-local": "0.1.7-rc.2",
     "@deepseek-ai/dsh-fs-observation-policy": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-fs-sandbox": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-bash-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm-deepseek": "0.1.7-rc.2",
     "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-experimental-tool-agent-team": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-pi-ai": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-mock-server": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-sdk-client": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-frontend-static": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
     "@deepseek-ai/dsh-llm-deepseek-account": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-deepseek": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.1.7-rc.2",
     "@deepseek-ai/dsh-llm-replay": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.7-rc.2",
     "@deepseek-ai/dsh-plugin-package-inventory-deepseek": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-checkpoint-policy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sandbox-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.2",
     "@deepseek-ai/dsh-loader-smoke": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-shell-env": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-query": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
     "@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-checkpoint-policy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-query": "0.1.7-rc.2",
     "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.7-rc.2",
     "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-log-deepseek": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sdk-client": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-shell-env": "0.1.7-rc.2",
     "@deepseek-ai/dsh-subagent-fork-in-process": "0.1.7-rc.2",
     "@deepseek-ai/dsh-subagent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-sandbox-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-log-deepseek": "0.1.7-rc.2",
     "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm-mock-server": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-subprocess-local": "0.1.7-rc.2",
     "@deepseek-ai/dsh-user-approval": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2"
   },
   "exports": {
     "./headless-compat": {

package/runtime/manifest.json

@@ -104,6 +104,7 @@
     "@deepseek-ai/dsh-compaction-basic",
     "@deepseek-ai/dsh-compaction-image-offload",
     "@deepseek-ai/dsh-compaction-tool-result-pruner",
+    "@deepseek-ai/dsh-computer-use",
     "@deepseek-ai/dsh-config-editor",
     "@deepseek-ai/dsh-cordis-client-runner",
     "@deepseek-ai/dsh-cordis-host-runner",
@@ -230,6 +231,7 @@
     "@deepseek-ai/dsh-system-prompt",
     "@deepseek-ai/dsh-terminal",
     "@deepseek-ai/dsh-terminal-bash",
+    "@deepseek-ai/dsh-tianti",
     "@deepseek-ai/dsh-time-context",
     "@deepseek-ai/dsh-timeout",
     "@deepseek-ai/dsh-tmux-context",
@@ -280,6 +282,6 @@
     "@deepseek-ai/node-addon-system",
     "@deepseek-ai/schemastery"
   ],
-  "fileCount": 3555,
-  "byteCount": 66580718
+  "fileCount": 3608,
+  "byteCount": 68755603
 }

package/runtime/node_modules/@deepseek-ai/dsh-agent-default-model/lib/index.js

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
 import { Service } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
-import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
+import { withFileLock, writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 import { resolveChatCodeCliHome } from "@deepseek-ai/dsh-home-paths";
 import { ReasoningEffortId } from "@deepseek-ai/dsh-llm";
 //#region lib/types/index.js
@@ -17,18 +18,24 @@ function selection(settings) {
 	};
 }
 /** Parse one product-wide model preference without accepting partial records. */
-function sharedSelection(path) {
+function sharedPreference(path, warn) {
 	try {
 		const parsed = JSON.parse(readFileSync(path, "utf8"));
-		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return void 0;
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("expected a model preference object");
 		const record = parsed;
-		if (typeof record.provider !== "string" || record.provider.length === 0 || typeof record.model !== "string" || record.model.length === 0) return void 0;
-		return selection({
+		if (typeof record.provider !== "string" || record.provider.length === 0 || typeof record.model !== "string" || record.model.length === 0) throw new Error("expected non-empty provider and model IDs");
+		const route = selection({
 			provider: record.provider,
 			model: record.model,
 			...typeof record.reasoningEffort === "string" && record.reasoningEffort.length > 0 ? { reasoningEffort: record.reasoningEffort } : {}
 		});
-	} catch (_error) {
+		const displayName = typeof record.displayName === "string" ? record.displayName.trim() : "";
+		return {
+			selection: route,
+			...displayName === "" ? {} : { displayName }
+		};
+	} catch (error) {
+		if (error.code !== "ENOENT") warn(`Cannot read model preference at ${path}: ${String(error)}`);
 		return;
 	}
 }
@@ -43,6 +50,9 @@ var AgentDefaultModelConfig = class extends Service {
 	saves = Promise.resolve();
 	sharedPath;
 	shared;
+	displayName;
+	awaitingDefault = false;
+	allowCatalogDefault = false;
 	static Config = z.object({
 		provider: z.string().required().volatile(),
 		model: z.string().required().volatile(),
@@ -53,16 +63,47 @@ var AgentDefaultModelConfig = class extends Service {
 		this.ownerContext = ownerContext;
 		this.config = config;
 		this.sharedPath = process.env[PRODUCT_VERSION_ENV]?.trim() ? join(resolveChatCodeCliHome(), SHARED_MODEL_FILENAME) : void 0;
-		if (this.sharedPath !== void 0) this.shared = sharedSelection(existsSync(this.sharedPath) ? this.sharedPath : join(resolveChatCodeCliHome(), "tui", SHARED_MODEL_FILENAME));
+		if (this.sharedPath !== void 0) {
+			const stored = sharedPreference(existsSync(this.sharedPath) ? this.sharedPath : join(resolveChatCodeCliHome(), "tui", SHARED_MODEL_FILENAME), (message) => {
+				ownerContext.logger.warn(message);
+			});
+			const reasoningEffort = config.reasoningEffort.get();
+			this.shared = stored?.selection ?? selection({
+				provider: config.provider.get(),
+				model: config.model.get(),
+				...reasoningEffort === void 0 ? {} : { reasoningEffort }
+			});
+			this.awaitingDefault = stored === void 0 && (this.shared.provider === "" || this.shared.model === "");
+			this.allowCatalogDefault = stored === void 0;
+			this.displayName = stored?.displayName;
+		}
 		ownerContext.inject(["settings"], (child) => {
 			child.effect(() => child.settings.configure({ auto: false }, ownerContext.fiber));
 		});
+		ownerContext.effect(() => () => this.saves);
 	}
 	/**
 	* Read the current default model selection.
+	* A first launch without a valid preference adopts the first complete Config
+	* default when it arrives; that process-local choice then stays cached.
 	* @returns a detached provider, model, and optional reasoning selection.
 	*/
 	currentSelection() {
+		if (this.awaitingDefault) {
+			const provider = this.config.provider.get();
+			const model = this.config.model.get();
+			if (provider === "" || model === "") return {
+				provider: "",
+				model: ""
+			};
+			const reasoningEffort = this.config.reasoningEffort.get();
+			this.shared = selection({
+				provider,
+				model,
+				...reasoningEffort === void 0 ? {} : { reasoningEffort }
+			});
+			this.awaitingDefault = false;
+		}
 		if (this.shared !== void 0) return { ...this.shared };
 		const reasoningEffort = this.config.reasoningEffort.get();
 		return selection({
@@ -71,14 +112,84 @@ var AgentDefaultModelConfig = class extends Service {
 			...reasoningEffort === void 0 ? {} : { reasoningEffort }
 		});
 	}
+	/** Whether this product uses a process-local selection initialized from Home at startup.
+	* @returns true for the integrated ChatCode CLI and Web profiles.
+	*/
+	usesSharedPreference() {
+		return this.sharedPath !== void 0;
+	}
+	/** Resolve the cached route against the live catalog without reading or writing preferences.
+	* A first launch without a valid preference may adopt an advertised fallback
+	* until its first available default is resolved. Saved or initialized choices
+	* never switch implicitly. Catalog errors preserve the candidate for retry.
+	* @returns the exact available selection, an unverified candidate, or an empty provider/model pair.
+	*/
+	async resolveSelection() {
+		const route = this.currentSelection();
+		if (!this.usesSharedPreference()) return route;
+		const llm = this.ctx.get("llm");
+		if (llm === void 0) return route;
+		const cached = this.shared;
+		const providers = llm.listProviders();
+		let routeModels = [];
+		if (providers.some((provider) => provider.id === route.provider)) {
+			try {
+				routeModels = await llm.listModels(route.provider);
+			} catch (_error) {
+				if (this.shared !== cached) return this.resolveSelection();
+				return route;
+			}
+			if (this.shared !== cached) return this.resolveSelection();
+			if (routeModels.some((model) => model.id === route.model)) {
+				this.allowCatalogDefault = false;
+				return route;
+			}
+		}
+		if (!this.allowCatalogDefault) return {
+			provider: "",
+			model: ""
+		};
+		for (const provider of providers) {
+			const models = provider.id === route.provider ? routeModels : await llm.listModels(provider.id).catch(() => []);
+			if (this.shared !== cached) return this.resolveSelection();
+			const model = models[0];
+			if (model === void 0) continue;
+			this.shared = {
+				provider: provider.id,
+				model: model.id
+			};
+			this.awaitingDefault = false;
+			this.allowCatalogDefault = false;
+			return { ...this.shared };
+		}
+		return {
+			provider: "",
+			model: ""
+		};
+	}
+	/** Read this process's cached display name without observing another process's saves.
+	* @returns The saved provider/model/name tuple, or undefined for missing or invalid name metadata.
+	*/
+	sharedDisplayName() {
+		if (this.sharedPath === void 0) return void 0;
+		if (this.displayName === void 0) return void 0;
+		const route = this.currentSelection();
+		return {
+			provider: route.provider,
+			model: route.model,
+			name: this.displayName
+		};
+	}
 	/**
 	* Save the complete default model selection to the shared ChatCode Home file,
 	* or the owning profile entry in other deployments. Saves commit in submission
 	* order; a failed save rejects its caller without blocking later saves.
+	* A shared save uses the caller's already resolved catalog name without an additional lookup.
 	* @param next - resolved selection accepted by an entry point.
+	* @param name - optional display name from the entry point's catalog.
 	* @returns fulfillment after the preference or optional profile write settles.
 	*/
-	async saveSelection(next) {
+	async saveSelection(next, name) {
 		const entry = this.ownerContext.fiber.entry;
 		const editor = this.ctx.get("configEditor");
 		const config = {
@@ -89,11 +200,26 @@ var AgentDefaultModelConfig = class extends Service {
 		if ((entry === void 0 || editor === void 0) && this.sharedPath === void 0) return;
 		const saved = this.saves.then(async () => {
 			if (this.sharedPath !== void 0) {
-				await writeFileAtomic(this.sharedPath, `${JSON.stringify(config, null, 2)}\n`, {
+				const previous = this.sharedDisplayName();
+				let displayName = previous?.provider === config.provider && previous.model === config.model ? previous.name : void 0;
+				if (name?.trim()) displayName = name.trim();
+				const preference = {
+					...config,
+					...displayName === void 0 ? {} : { displayName }
+				};
+				const path = this.sharedPath;
+				await mkdir(dirname(path), {
+					recursive: true,
+					mode: 448
+				});
+				await withFileLock(path, () => writeFileAtomic(path, `${JSON.stringify(preference, null, 2)}\n`, {
 					mode: 384,
 					dirMode: 448
-				});
+				}));
 				this.shared = selection(config);
+				this.displayName = displayName;
+				this.awaitingDefault = false;
+				this.allowCatalogDefault = false;
 			} else if (entry !== void 0 && editor !== void 0) await editor.edit(entry, () => config);
 		});
 		this.saves = saved.catch(() => {});