dsh-new-session 0.1.0 → 0.2.0

package/README.md

@@ -1,17 +1,24 @@
 # `dsh-new-session`
 
-在输入框里敲 `/new`，直接在当前工作区开一个新会话——等价于点侧边栏的 **New Session**
-按钮，但不用把手从键盘上拿开。
+在输入框里敲 `/clear`（别名 `/new`），**开一段全新的对话，但留在当前工作目录**——和 Claude
+Code 的 `/clear` 对齐：旧对话完整留在侧边栏历史里，上下文从零开始。
 
 ## 它做什么
 
-- 在 `/` 菜单里注册一个 **New session / 新建会话** 命令（`/new`，客户端 action）。
-- 执行时调用 Web GUI 的工作区导航服务，行为和 New Session 按钮完全一致：
-  - 当前工作区里已有空白会话时**复用**它——所以回到那个空白会话未发送的草稿；
-  - 没有空白会话时新建一个；
-  - 旧会话原样留在历史列表里，不会被删除或修改。
-- 命令只在当前 Peer 有 `session/create` 权限时出现；只读的远程访问者看不到这一行。
-- 不提交任何提示词：`action` 类型会消费掉 `/new` 这个 token，不会把它当消息发给模型。
+- 在 `/` 菜单里注册两个客户端 action：**Clear conversation / 清除对话**（`/clear`）和
+  **New session / 新建会话**（`/new`，Claude Code 语义下的别名）。
+- 执行时：
+  1. 找到当前会话所在的 Workspace，向宿主要一个空白会话（有可复用的空白就复用，和
+     New Session 按钮一致，未发送的草稿也还在）；
+  2. 通过本插件的宿主路由，把新会话的**工作目录**设成当前会话的工作目录；
+  3. 导航到新会话。
+- **工作目录（包括 worktree 副本）会继承**：新会话的创建目录仍是 Workspace 路径，但工作
+  目录与当前会话一致。因此在 worktree 会话里 `/clear` 会留在**同一个 worktree**，而不是像
+  普通新会话那样让 `dsh-worktree-switch` 再建一份副本——`dsh-worktree-switch` 看到新会话已
+  在副本里，只显示 ready，不再 prepare。
+- 旧会话原样保留（侧边栏历史、`/resume` 语义上的可回）。
+- 只在当前 Peer 有 `session/create` 权限时注册；只读的远程访问者看不到这两行。
+- 不提交任何提示词：`action` 类型会消费掉 `/clear` / `/new` 这个 token。
 
 ## 安装
 
@@ -21,39 +28,36 @@ dsh plugin --profile web add /home/ubuntu/code/deepseek-plugins/packages/dsh-new
 dsh --profile web --dump-config    # 应能看到 "# == dsh-new-session"
 ```
 
-装完需要重启正在运行的 Web profile：浏览器半由宿主发布，页面刷新不够，Host 的
-client-module 扫描要重新 boot。
-
-构建产物由 `prepare` 脚本（tsdown）产出；改完源码后重新
-`pnpm --filter dsh-new-session build` 即可。外部安装的插件不在 `pnpm run dev:web` 的监视
-范围内，client-hmr 每 500ms 轮询 `lib/client.js`，重新构建后页面会自动换上新的浏览器半。
+装完需要重启正在运行的 Web profile：宿主半新增了一条 Connection 路由，浏览器半由宿主发布，
+页面刷新不够。构建产物由 `prepare` 脚本（tsdown）产出；改完源码后重新
+`pnpm --filter dsh-new-session build` 即可（外部安装的插件由 client-hmr 轮询 `lib/client.js`）。
 
 ## 在 GUI 里走一遍
 
-1. 重启 Web profile，打开任意一个会话。
-2. 在输入框里输入 `/new`：`/` 菜单里出现 **新建会话** 一行（也可以直接按回车执行）。
-3. 执行后当前视图切到一个空白会话；输入框里是空的（如果那个空白会话本来就有草稿，草稿还在）。
-4. 侧边栏里原来的会话还在，点回去内容完全没变。
+1. 重启 Web profile，打开任意会话（在 worktree 里的会话也可以）。
+2. 输入 `/clear`（或 `/new`）回车：视图切到一个空白会话，工作目录还是刚才那个目录。
+3. 如果原来在 worktree 副本里，新会话仍在同一个副本里——不会多出一份副本；旧会话在侧边栏
+   里还在。
 
 ## 实现
 
-两半都只做一件事：
-
-- **宿主半**（`src/index.ts`）是空插件。它存在的意义是让 Loader 挂载这个包——只有挂载了，
-  client-module 扫描才会把 `lib/client.js` 发布给页面。
-- **浏览器半**（`src/client/index.tsx`）用 `ctx.commandUi.register()` 注册一个
-  `kind: 'action'` 的贡献；`run` 调用 `ctx.uiWorkspace.startSession()`。注册包在
-  `ctx.remoteAccess.whenAccess('session/create', …)` 里，权限变化时自动装上/卸下。
-
-`/new` 这个名字没有对应宿主命令，所以不会和现有 command 撞名；
-`cordis.patch.yml` 只插一行，没有配置项。
+- **宿主半**（`src/index.ts` + `src/host/adopt.ts`）在 Connection 上注册一条精确路由
+  `POST /api/dsh-new-session/adopt`。它只做浏览器做不到的事：把目标会话的工作目录设成源会话
+  的当前目录（`ctx.workingDirectory.set`）。守卫：
+  - 目标会话必须还没有开始任何 turn；
+  - 源会话的工作目录必须位于它自己的创建目录（`header.cwd`）之内——`cd` 到项目外的情况
+    报告为 no-op，避免把会话挪进不属于它的项目。
+- **浏览器半**（`src/client/index.tsx`）用 `ctx.commandUi.register()` 注册 `/clear` 与 `/new`
+  两个 `action`；`run` 里 `uiWorkspace.connectWorkspace()` 拿空白会话 → 调宿主路由 →
+  `uiWorkspace.openSession()`。注册包在 `ctx.remoteAccess.whenAccess('session/create', …)` 里。
+- 没有 Workspace 的会话回退到普通的新会话导航（`startSession()`）。
 
 ## 已知边界
 
 - **只对 Web GUI 生效**。SDK / 桌面纯文本入口的斜杠命令识别只认内置白名单
   （dsh 的 `query-input.ts`），第三方插件命令不会从那条路进入；要覆盖那些入口需要改 dsh 本体。
-- 它是「新会话」而不是「原地清空上下文」：旧对话仍然在历史里，会话 id 也不变的是**新会话**
-  的 id。想在同一个会话里清空上下文是另一件事（surface replace），这个插件不做。
-- 复用空白会话意味着连续两次 `/new` 可能停在同一个空白会话上——和按钮行为一致。
-- 菜单行的文案来自浏览器半的字典（en / zh）；`locale/*.json` 只给市场页的
-  `meta.title` / `meta.description` 用。
+- **没有 `/clear <name>` 参数**（Claude Code 用它给旧对话命名）。dsh 的客户端 action 只处理
+  不带参数的调用；要支持参数得把命令做成宿主 command + 客户端装饰，留作后续。
+- `/reset` 别名没有注册：dsh 的客户端命令没有别名机制，每个别名都要占用菜单里的一行，所以
+  只保留 `/clear` 和 `/new` 两行。
+- 旧会话不会被删除或改名，只是留在历史里。

package/lib/client.js

@@ -6,48 +6,105 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 // src/client/locales.ts
 /** English copy. */
 const en = {
-	label: "New session",
-	description: "Start a fresh conversation in this workspace"
+	"clear.label": "Clear conversation",
+	"clear.description": "Start a fresh conversation here; the previous one stays in your history",
+	"new.label": "New session",
+	"new.description": "Same as /clear: start a fresh conversation here"
 };
 /** Simplified Chinese copy. */
 const zh = {
-	label: "新建会话",
-	description: "在当前工作区开一个全新的对话"
+	"clear.label": "清除对话",
+	"clear.description": "在这里开始全新对话，旧对话保留在历史里",
+	"new.label": "新建会话",
+	"new.description": "与 /clear 相同：在这里开始全新对话"
 };
 // src/client/index.tsx
 /** Browser module id: package name, bundle row id, plugin id. */
 const name = "dsh-new-session";
 /** Locale namespace this plugin owns. */
 const NS = "newSession";
-/** Client services the command cannot work without. */
+/** Host route namespace; the package name and the wire method prefix are the same. */
+const PLUGIN_ID = "dsh-new-session";
+/** Client services the commands cannot work without. */
 const inject = [
 	"commandUi",
+	"connection",
 	"locale",
 	"remoteAccess",
-	"uiWorkspace"
+	"uiWorkspace",
+	"workspaces"
 ];
 /**
-* Build the `/new` contribution.
+* Build the `/clear` contribution and its `/new` alias.
 *
-* Exported for the contract spec: the contribution is the unit under test, and
-* `apply` only decides when to install it.
+* The client command registry has no alias mechanism (reserved for first-party
+* host commands), so an alias is a second contribution with the same action;
+* its copy says so.
 *
-* @param deps - translator and navigation callback.
-* @returns the silent action contribution.
+* @param deps - translator and conversation starter.
+* @returns both contributions, primary first.
 */
-function createNewSessionCommand(deps) {
-	return {
-		name: "new",
-		label: () => deps.t("label"),
-		description: () => deps.t("description"),
+function createCommands(deps) {
+	const command = (name, prefix) => ({
+		name,
+		label: () => deps.t(`${prefix}.label`),
+		description: () => deps.t(`${prefix}.description`),
 		available: () => true,
 		ui: {
 			kind: "action",
-			run: () => {
-				deps.start();
+			run: (session) => {
+				deps.start(session.sessionId);
 			}
 		}
-	};
+	});
+	return [command("clear", "clear"), command("new", "new")];
+}
+/**
+* Call the Host adoption verb.
+* @param ctx - browser Cordis context providing `connection`.
+* @param sourceSessionId - Session being left.
+* @param targetSessionId - blank Session that should start where the source is.
+* @throws {Error} when the Host refused or the reply is malformed.
+*/
+async function adopt(ctx, sourceSessionId, targetSessionId) {
+	const connection = ctx.get("connection");
+	if (connection === void 0) throw new Error("the connection service is not mounted");
+	const result = await connection.rpc.call("/api", `${PLUGIN_ID}/adopt`, {
+		sourceSessionId,
+		targetSessionId
+	});
+	if (result === null || typeof result !== "object" || !("ok" in result)) throw new Error("malformed reply from the adopt verb");
+	if (!result.ok) throw new Error(result.error.message);
+}
+/**
+* Start a fresh conversation in the source Session's working directory.
+*
+* Sessions that do not belong to a Workspace fall back to plain navigation:
+* there is no Workspace whose blank Session could reuse the directory, and the
+* previous behavior is still the honest answer for that shape.
+*
+* @param ctx - browser Cordis context.
+* @param sessionId - Session the user is leaving.
+*/
+async function start(ctx, sessionId) {
+	const workspace = ctx.workspaces.list.getSnapshot().items.find((item) => item.sessionIds.includes(sessionId));
+	if (workspace === void 0) {
+		ctx.uiWorkspace.startSession();
+		return;
+	}
+	let target;
+	try {
+		target = await ctx.uiWorkspace.connectWorkspace(workspace.workspaceId);
+	} catch (error) {
+		console.warn("dsh-new-session: could not create the next Session:", error);
+		return;
+	}
+	try {
+		await adopt(ctx, sessionId, target);
+	} catch (error) {
+		console.warn("dsh-new-session: could not inherit the working directory:", error);
+	}
+	ctx.uiWorkspace.openSession(target);
 }
 /**
 * Mount the browser half.
@@ -59,15 +116,20 @@ function apply(ctx) {
 		zh
 	}), "dsh-new-session: dictionaries");
 	const t = ctx.locale.bind(NS);
-	ctx.effect(() => ctx.remoteAccess.whenAccess("session/create", () => ctx.commandUi.register(createNewSessionCommand({
-		t,
-		start: () => {
-			ctx.uiWorkspace.startSession();
-		}
-	}))), "dsh-new-session: /new command");
+	ctx.effect(() => ctx.remoteAccess.whenAccess("session/create", () => {
+		const disposers = createCommands({
+			t,
+			start: (sessionId) => {
+				start(ctx, sessionId);
+			}
+		}).map((command) => ctx.commandUi.register(command));
+		return () => {
+			for (const dispose of disposers) dispose();
+		};
+	}), "dsh-new-session: /clear commands");
 }
 exports.apply = apply;
-exports.createNewSessionCommand = createNewSessionCommand;
+exports.createCommands = createCommands;
 exports.inject = inject;
 exports.name = name;
 

package/lib/index.d.ts

@@ -1,9 +1,11 @@
 import { Context } from "@deepseek-ai/cordis";
 /** Plugin id: package name, bundle row id, and browser module id. */
 export declare const name = "dsh-new-session";
+/** Services this plugin cannot work without. */
+export declare const inject: string[];
 /**
- * Mount the inert Host half.
- * @param ctx - the Cordis context.
+ * Mount the Host half.
+ * @param ctx - Host context.
  */
 export declare function apply(ctx: Context): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -1,11 +1,204 @@
+import { isAbsolute, relative } from "node:path";
+// src/host/adopt.ts
+/**
+* Host half of the conversation reset: adopt a freshly created Session into the
+* source Session's working directory.
+*
+* This is the dsh equivalent of Claude Code recording a new conversation under
+* the same working directory as the previous one. A dsh Session owns two
+* directories: the immutable creation directory (`header.cwd`, which is what
+* keeps it inside its Workspace) and the committed working directory (the
+* `working-directory` projection). `/clear` must move the *working* directory
+* only, so the new Session stays a member of the same Workspace while any
+* worktree/isolation state the source had is carried over.
+*
+* @module dsh-new-session/host/adopt
+*/
+/** Absolute prefix every route below lives under. */
+const API_PREFIX = "/api/dsh-new-session";
+/** Plugin id; the wire method prefix and the package name are the same string. */
+const PLUGIN_ID = "dsh-new-session";
+/** This plugin serves exactly one verb. */
+const ENDPOINT = "adopt";
+/**
+* Whether `directory` is `root` or one of its descendants.
+* @param directory - candidate absolute directory.
+* @param root - absolute ancestor directory.
+* @returns whether `directory` is contained in `root`.
+*/
+function isInside(directory, root) {
+	const path = relative(root, directory);
+	return path === "" || !path.startsWith("..") && !isAbsolute(path);
+}
+/**
+* Resolve one live Agent, resuming it through the Session Controller when
+* available and falling back to the registry otherwise.
+* @param ctx - Host context.
+* @param sessionId - wire session identity.
+* @param signal - caller cancellation.
+* @returns the live Agent.
+* @throws when the Session cannot be resolved.
+*/
+async function agentOf(ctx, sessionId, signal) {
+	signal.throwIfAborted();
+	if (sessionId === "") throw new Error("a session id is required");
+	const live = ctx.agents.get(sessionId);
+	if (live !== void 0) return live;
+	const controller = ctx.get("sessionController");
+	if (controller !== void 0) {
+		const resolved = await controller.resolveAgent(sessionId);
+		if (!("error" in resolved)) return resolved.agent;
+		throw new Error(resolved.error.message);
+	}
+	throw new Error(`no live agent for session ${sessionId}`);
+}
+/**
+* Build the adoption verb.
+*
+* Discovery is deliberately conservative: the target must be a Session that
+* has not started a turn yet, and the source's working directory must live
+* inside the source's own creation directory. Copying a directory from outside
+* that tree (a Session that `cd`-ed into another repository) would contradict
+* the target's project membership and make an isolating plugin misread it, so
+* that case is a reported no-op instead.
+*
+* @param ctx - Host context carrying `agents` and `workingDirectory`.
+* @returns the verb.
+*/
+function createAdoption(ctx) {
+	return async (input, signal) => {
+		const source = await agentOf(ctx, input.sourceSessionId, signal);
+		const target = await agentOf(ctx, input.targetSessionId, signal);
+		signal.throwIfAborted();
+		if (source.session.id === target.session.id) throw new Error("the source and target sessions must differ");
+		const boundary = ctx.agents.turnBoundaryOf(target.session);
+		if (boundary.lastTurn !== 0 || boundary.openTurnStartSeq !== null) throw new Error(`target session "${target.session.id}" has already started`);
+		const workingDirectory = ctx.workingDirectory.get(source.session);
+		const home = source.session.header.cwd;
+		if (home === void 0 || !isInside(workingDirectory, home)) return {
+			adopted: false,
+			workingDirectory
+		};
+		await ctx.workingDirectory.set(target, workingDirectory, signal);
+		return {
+			adopted: true,
+			workingDirectory
+		};
+	};
+}
+/**
+* Decode the browser's `client-request` envelope.
+* @param body - parsed JSON body.
+* @returns the request, or null when the envelope is malformed.
+*/
+function readClientRequest(body) {
+	if (body === null || typeof body !== "object" || Array.isArray(body)) return null;
+	const record = body;
+	if (record["type"] !== "client-request") return null;
+	const { rpcId, method } = record;
+	if (typeof rpcId !== "string" || rpcId === "") return null;
+	if (typeof method !== "string" || method === "") return null;
+	const payload = record["payload"];
+	return {
+		rpcId,
+		method,
+		payload: payload !== null && typeof payload === "object" && !Array.isArray(payload) ? payload : {}
+	};
+}
+/**
+* Read one required non-empty string field.
+* @param payload - decoded payload.
+* @param field - field name.
+* @returns the value.
+* @throws when the field is missing or empty.
+*/
+function requiredString(payload, field) {
+	const value = payload[field];
+	if (typeof value !== "string" || value.trim() === "") throw new Error(`payload.${field} must be a non-empty string`);
+	return value;
+}
+/** A successful wire result. */
+function ok(value) {
+	return {
+		ok: true,
+		value
+	};
+}
+/** A failed wire result carrying the stable code. */
+function fail(code, message) {
+	return {
+		ok: false,
+		error: {
+			code,
+			message,
+			details: {}
+		}
+	};
+}
+/**
+* Register the adoption route on the shared `/api` channel.
+*
+* Exact routes are the only shape an out-of-tree plugin can claim: `/api` is
+* the one logical channel the API Gateway owns, so `rpc.handle` refuses it and
+* a second `rpc.intercept` throws. The route answers owner peers only, which is
+* what the local Web GUI is.
+*
+* @param ctx - Host context carrying `connection`.
+* @param adopt - the verb this route serves.
+*/
+function registerAdoptionRoute(ctx, adopt) {
+	ctx.effect(() => ctx.connection.fetch.register({
+		path: `${API_PREFIX}/${ENDPOINT}`,
+		methods: ["POST"],
+		requestBody: "buffered",
+		async fetch(request) {
+			if (request.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase() !== "application/json") return new Response("content type must be application/json", { status: 415 });
+			let body;
+			try {
+				body = await request.json();
+			} catch {
+				return new Response("body is not JSON", { status: 400 });
+			}
+			const message = readClientRequest(body);
+			if (message === null) return new Response("invalid client-request message", { status: 400 });
+			if (message.method !== `dsh-new-session/adopt`) return Response.json({
+				type: "server-response",
+				rpcId: message.rpcId,
+				result: fail("bad-request", "RPC method does not match endpoint")
+			});
+			let result;
+			try {
+				result = ok(await adopt({
+					sourceSessionId: requiredString(message.payload, "sourceSessionId"),
+					targetSessionId: requiredString(message.payload, "targetSessionId")
+				}, request.signal));
+			} catch (error) {
+				result = fail("adopt-failed", error instanceof Error ? error.message : String(error));
+			}
+			return Response.json({
+				type: "server-response",
+				rpcId: message.rpcId,
+				result
+			});
+		}
+	}), `${PLUGIN_ID} ${ENDPOINT} route`);
+}
 // src/index.ts
 /** Plugin id: package name, bundle row id, and browser module id. */
 const name = "dsh-new-session";
+/** Services this plugin cannot work without. */
+const inject = [
+	"agents",
+	"connection",
+	"workingDirectory"
+];
 /**
-* Mount the inert Host half.
-* @param ctx - the Cordis context.
+* Mount the Host half.
+* @param ctx - Host context.
 */
-function apply(ctx) {}
-export { apply, name };
+function apply(ctx) {
+	registerAdoptionRoute(ctx, createAdoption(ctx));
+}
+export { apply, inject, name };
 
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Host half of the `/new` command plugin.\n *\n * The command itself is a browser contribution: the slash menu and the\n * new-Session navigation both live in the Web GUI, so this Host row only mounts\n * the package — which is enough for the client-module scanner to publish\n * `lib/client.js`, and for the plugin's lifecycle to follow the bundle.\n *\n * @module dsh-new-session\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\n\n/** Plugin id: package name, bundle row id, and browser module id. */\nexport const name = 'dsh-new-session'\n\n/**\n * Mount the inert Host half.\n * @param ctx - the Cordis context.\n */\nexport function apply(ctx: Context): void {\n  // No host-side capability on purpose: a Host handler could not move the\n  // browser's current Session, so `/new` is a client-owned action instead.\n  void ctx\n}\n"],"mappings":";;AAcA,MAAa,OAAO;;;;;AAMpB,SAAgB,MAAM,KAAoB,CAI1C"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/host/adopt.ts","../src/index.ts"],"sourcesContent":["/**\n * Host half of the conversation reset: adopt a freshly created Session into the\n * source Session's working directory.\n *\n * This is the dsh equivalent of Claude Code recording a new conversation under\n * the same working directory as the previous one. A dsh Session owns two\n * directories: the immutable creation directory (`header.cwd`, which is what\n * keeps it inside its Workspace) and the committed working directory (the\n * `working-directory` projection). `/clear` must move the *working* directory\n * only, so the new Session stays a member of the same Workspace while any\n * worktree/isolation state the source had is carried over.\n *\n * @module dsh-new-session/host/adopt\n */\n\nimport { isAbsolute, relative } from 'node:path'\nimport type { Context } from '@deepseek-ai/cordis'\nimport type { Agent } from '@deepseek-ai/dsh-agent'\nimport type { SessionId } from '@deepseek-ai/dsh-session'\nimport type { ConnectionRpcResult } from '@deepseek-ai/dsh-client-connection'\n\n/** Absolute prefix every route below lives under. */\nexport const API_PREFIX = '/api/dsh-new-session'\n\n/** Plugin id; the wire method prefix and the package name are the same string. */\nexport const PLUGIN_ID = 'dsh-new-session'\n\n/** This plugin serves exactly one verb. */\nexport const ENDPOINT = 'adopt' as const\n\n/** One decoded adoption request. */\nexport interface AdoptionInput {\n  /** Session the user is leaving; its working directory is the target. */\n  readonly sourceSessionId: string\n  /** Freshly created Session that should start where the source is. */\n  readonly targetSessionId: string\n}\n\n/** What the Host did with one adoption request. */\nexport interface AdoptionValue {\n  /** Whether the target's working directory was moved. */\n  readonly adopted: boolean\n  /** The source's current working directory. */\n  readonly workingDirectory: string | null\n}\n\n/** The verb implementation the route dispatches to. */\nexport type Adopt = (input: AdoptionInput, signal: AbortSignal) => Promise<AdoptionValue>\n\n/**\n * Whether `directory` is `root` or one of its descendants.\n * @param directory - candidate absolute directory.\n * @param root - absolute ancestor directory.\n * @returns whether `directory` is contained in `root`.\n */\nexport function isInside(directory: string, root: string): boolean {\n  const path = relative(root, directory)\n  return path === '' || (!path.startsWith('..') && !isAbsolute(path))\n}\n\n/**\n * Resolve one live Agent, resuming it through the Session Controller when\n * available and falling back to the registry otherwise.\n * @param ctx - Host context.\n * @param sessionId - wire session identity.\n * @param signal - caller cancellation.\n * @returns the live Agent.\n * @throws when the Session cannot be resolved.\n */\nasync function agentOf(ctx: Context, sessionId: string, signal: AbortSignal): Promise<Agent> {\n  signal.throwIfAborted()\n  if (sessionId === '') throw new Error('a session id is required')\n  // The common case (the Session the user is in, and the blank Session just\n  // created for them) is already live; the controller handles a cold Session.\n  const live = ctx.agents.get(sessionId as SessionId)\n  if (live !== undefined) return live\n  const controller = ctx.get('sessionController')\n  if (controller !== undefined) {\n    const resolved = await controller.resolveAgent(sessionId as SessionId)\n    if (!('error' in resolved)) return resolved.agent\n    throw new Error(resolved.error.message)\n  }\n  throw new Error(`no live agent for session ${sessionId}`)\n}\n\n/**\n * Build the adoption verb.\n *\n * Discovery is deliberately conservative: the target must be a Session that\n * has not started a turn yet, and the source's working directory must live\n * inside the source's own creation directory. Copying a directory from outside\n * that tree (a Session that `cd`-ed into another repository) would contradict\n * the target's project membership and make an isolating plugin misread it, so\n * that case is a reported no-op instead.\n *\n * @param ctx - Host context carrying `agents` and `workingDirectory`.\n * @returns the verb.\n */\nexport function createAdoption(ctx: Context): Adopt {\n  return async (input, signal) => {\n    const source = await agentOf(ctx, input.sourceSessionId, signal)\n    const target = await agentOf(ctx, input.targetSessionId, signal)\n    signal.throwIfAborted()\n    if (source.session.id === target.session.id) {\n      throw new Error('the source and target sessions must differ')\n    }\n    const boundary = ctx.agents.turnBoundaryOf(target.session)\n    if (boundary.lastTurn !== 0 || boundary.openTurnStartSeq !== null) {\n      throw new Error(`target session \"${target.session.id}\" has already started`)\n    }\n    const workingDirectory = ctx.workingDirectory.get(source.session)\n    const home = source.session.header.cwd\n    if (home === undefined || !isInside(workingDirectory, home)) {\n      return { adopted: false, workingDirectory }\n    }\n    await ctx.workingDirectory.set(target, workingDirectory, signal)\n    return { adopted: true, workingDirectory }\n  }\n}\n\n/** One decoded client request. */\ninterface ClientRequest {\n  readonly rpcId: string\n  readonly method: string\n  readonly payload: Record<string, unknown>\n}\n\n/**\n * Decode the browser's `client-request` envelope.\n * @param body - parsed JSON body.\n * @returns the request, or null when the envelope is malformed.\n */\nfunction readClientRequest(body: unknown): ClientRequest | null {\n  if (body === null || typeof body !== 'object' || Array.isArray(body)) return null\n  const record = body as Record<string, unknown>\n  if (record['type'] !== 'client-request') return null\n  const { rpcId, method } = record\n  if (typeof rpcId !== 'string' || rpcId === '') return null\n  if (typeof method !== 'string' || method === '') return null\n  const payload = record['payload']\n  return {\n    rpcId,\n    method,\n    payload: payload !== null && typeof payload === 'object' && !Array.isArray(payload)\n      ? payload as Record<string, unknown>\n      : {},\n  }\n}\n\n/**\n * Read one required non-empty string field.\n * @param payload - decoded payload.\n * @param field - field name.\n * @returns the value.\n * @throws when the field is missing or empty.\n */\nfunction requiredString(payload: Record<string, unknown>, field: string): string {\n  const value = payload[field]\n  if (typeof value !== 'string' || value.trim() === '') {\n    throw new Error(`payload.${field} must be a non-empty string`)\n  }\n  return value\n}\n\n/** A successful wire result. */\nfunction ok<T>(value: T): ConnectionRpcResult<T> {\n  return { ok: true, value }\n}\n\n/** A failed wire result carrying the stable code. */\nfunction fail(code: string, message: string): ConnectionRpcResult<never> {\n  return { ok: false, error: { code, message, details: {} } }\n}\n\n/**\n * Register the adoption route on the shared `/api` channel.\n *\n * Exact routes are the only shape an out-of-tree plugin can claim: `/api` is\n * the one logical channel the API Gateway owns, so `rpc.handle` refuses it and\n * a second `rpc.intercept` throws. The route answers owner peers only, which is\n * what the local Web GUI is.\n *\n * @param ctx - Host context carrying `connection`.\n * @param adopt - the verb this route serves.\n */\nexport function registerAdoptionRoute(ctx: Context, adopt: Adopt): void {\n  ctx.effect(() => ctx.connection.fetch.register({\n    path: `${API_PREFIX}/${ENDPOINT}`,\n    methods: ['POST'],\n    requestBody: 'buffered',\n    async fetch(request) {\n      const contentType = request.headers.get('content-type')?.split(';', 1)[0]?.trim().toLowerCase()\n      if (contentType !== 'application/json') {\n        return new Response('content type must be application/json', { status: 415 })\n      }\n      let body: unknown\n      try {\n        body = await request.json()\n      } catch {\n        return new Response('body is not JSON', { status: 400 })\n      }\n      const message = readClientRequest(body)\n      if (message === null) return new Response('invalid client-request message', { status: 400 })\n      if (message.method !== `${PLUGIN_ID}/${ENDPOINT}`) {\n        return Response.json({\n          type: 'server-response',\n          rpcId: message.rpcId,\n          result: fail('bad-request', 'RPC method does not match endpoint'),\n        })\n      }\n      let result: ConnectionRpcResult<AdoptionValue>\n      try {\n        result = ok(await adopt({\n          sourceSessionId: requiredString(message.payload, 'sourceSessionId'),\n          targetSessionId: requiredString(message.payload, 'targetSessionId'),\n        }, request.signal))\n      } catch (error) {\n        result = fail('adopt-failed', error instanceof Error ? error.message : String(error))\n      }\n      return Response.json({ type: 'server-response', rpcId: message.rpcId, result })\n    },\n  }), `${PLUGIN_ID} ${ENDPOINT} route`)\n}\n","/**\n * Host half of the conversation reset.\n *\n * The browser half owns the `/clear` (alias `/new`) command: it decides when\n * the user wants a fresh conversation and drives Workspace navigation. This\n * half owns the one thing only the Host can do — start the new Session in the\n * source Session's working directory — and exposes it as one exact route on the\n * Connection fetch bridge.\n *\n * @module dsh-new-session\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\nimport type {} from '@deepseek-ai/dsh-agent'\nimport type {} from '@deepseek-ai/dsh-api-session-controller'\nimport type {} from '@deepseek-ai/dsh-client-connection'\nimport type {} from '@deepseek-ai/dsh-working-directory'\nimport { createAdoption, registerAdoptionRoute } from './host/adopt.ts'\n\n/** Plugin id: package name, bundle row id, and browser module id. */\nexport const name = 'dsh-new-session'\n\n/** Services this plugin cannot work without. */\nexport const inject = ['agents', 'connection', 'workingDirectory']\n\n/**\n * Mount the Host half.\n * @param ctx - Host context.\n */\nexport function apply(ctx: Context): void {\n  registerAdoptionRoute(ctx, createAdoption(ctx))\n}\n"],"mappings":"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"}

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "New Session command",
-    "description": "Type /new in the composer to start a fresh conversation in the current workspace."
+    "title": "Clear conversation command",
+    "description": "Type /clear (or /new) in the composer to start a fresh conversation in the current working directory; the previous one stays in your history."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "新建会话命令",
-    "description": "在输入框里输入 /new，直接在当前工作区开一个全新的对话。"
+    "title": "清除对话命令",
+    "description": "输入 /clear（或 /new），在当前工作目录开一段全新的对话，旧对话保留在历史里。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-new-session",
-  "version": "0.1.0",
-  "description": "A `/new` slash command in the Web GUI composer: start a fresh Session in the current Workspace without leaving the keyboard.",
+  "version": "0.2.0",
+  "description": "`/clear` (alias `/new`) in the Web GUI composer: start a fresh conversation in the current working directory and keep the previous one in your history.",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -45,6 +45,8 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-api-remote-access",
+        "@deepseek-ai/dsh-api-workspace-controller",
+        "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-commands",
         "@deepseek-ai/dsh-client-ui-workspace"
@@ -53,21 +55,31 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.1.0",
+    "@deepseek-ai/dsh-agent": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-api-remote-access": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-api-session-controller": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-api-workspace-controller": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-client-locale": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-client-ui-commands": ">=0.2.2-rc.1 <0.2.3-0",
     "@deepseek-ai/dsh-client-ui-slots": ">=0.2.2-rc.1 <0.2.3-0",
-    "@deepseek-ai/dsh-client-ui-workspace": ">=0.2.2-rc.1 <0.2.3-0"
+    "@deepseek-ai/dsh-client-ui-workspace": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-session": ">=0.2.2-rc.1 <0.2.3-0",
+    "@deepseek-ai/dsh-working-directory": ">=0.2.2-rc.1 <0.2.3-0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.1.0",
+    "@deepseek-ai/dsh-agent": "0.2.2-rc.1",
     "@deepseek-ai/dsh-api-remote-access": "0.2.2-rc.1",
     "@deepseek-ai/dsh-api-session-controller": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.2-rc.1",
     "@deepseek-ai/dsh-client-locale": "0.2.2-rc.1",
     "@deepseek-ai/dsh-client-ui-commands": "0.2.2-rc.1",
     "@deepseek-ai/dsh-client-ui-slots": "0.2.2-rc.1",
     "@deepseek-ai/dsh-client-ui-workspace": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.2-rc.1",
     "@types/node": "^26.6.6",
     "tsdown": "^0.23.4",
     "typescript": "^7.0.2",