@deepseek-ai/dsh-client-test-runtime 0.0.1-rc.1 → 0.0.1-rc.5

package/README.i18n.yaml

@@ -1,6 +1,6 @@
 # Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
-#   pnpm run verify-translation-pairing --write packages/client/test-runtime/README.md
-README.md: d5c0797c37168578f08a08f3d5d57670d7973db0
-README.zh.md: 57854213c3a9ea28850665eb26d07bc824c017e8
+#   pnpm run verify-translation-pairing --write packages/test-support/client-runtime/README.md
+README.md: 15646d05daae0a39a36639f335a71d6d208da13b
+README.zh.md: 9624bc8ffc997ba786f3cb1bba670344d44ac60d

package/README.md

@@ -2,9 +2,9 @@
 
 English | [中文](README.zh.md)
 
-jsdom slot test runtime for client feature specs: a real Cordis `Context`, the production `SlotsService` and web-react renderer, assembled around typed session/workspace doubles. Feature suites exercise declaration, registration, scope, store, inject, rendering, updates, and disposal without hand-building the machinery per suite — and without a second implementation of any production logic.
+jsdom slot test runtime for client feature specs: a real Cordis `Context`, the production `SlotRegistry` and web-react renderer, assembled around typed session/workspace doubles. Feature suites exercise declaration, registration, scope, store, inject, rendering, updates, and disposal without hand-building the machinery per suite — and without a second implementation of any production logic.
 
-The doubles implement the same outward faces features receive through ctx (`TestSessions implements ISessions`, `TestWorkspaces implements IWorkspaces`; each fixture session is a `FixtureSession implements SessionFace`; `stubSettingsScope` is a `SettingsScope` with test-driven publications and a write spy), so a production face change breaks the bench at compile time instead of silently drifting. Provide-bundle materialization runs the production `SessionProvideChannel` — the one implementation shared with `SessionsService`. Fixtures feed plain data: list rows, conversation snapshots (immer-patched via `updateSnapshot`), projection values, and `ISession`-typed behavior stubs that fail loud when a spec calls an unstubbed verb. The typed `provide()` constrains fakes for declared service names to `Partial` of that service's outward face.
+The doubles implement the same outward faces features receive through ctx (`TestSessions implements ISessions`, `TestWorkspaces implements IWorkspaces`; each fixture session is a `FixtureSession implements SessionFace`; `stubSettingsScope` is a `SettingsScope` with test-driven publications and a write spy), so a production face change breaks the bench at compile time instead of silently drifting. Provide-bundle materialization runs the production `SessionProvideChannel` — the one implementation shared with `SessionRuntime`. Fixtures feed plain data: list rows, conversation snapshots (immer-patched via `updateSnapshot`), projection values, and `ISession`-typed behavior stubs that fail loud when a spec calls an unstubbed verb. The typed `provide()` constrains fakes for declared service names to `Partial` of that service's outward face.
 
 Local DOM snapshots: `declare(children)` registers an auto frame whose per-key `<div data-slot>` wrappers are snapshot roots; `renderSlot(key, owner)` returns the slot-local view (container, scoped Testing Library queries, in-place `update(owner)`); a registered snapshot serializer folds CSS-module class hashes (`_frame_a1b2c3` → `frame`) to keep `.snap` files structural and collapses `<svg>` internals to a `data-content` fingerprint. Suites needing a custom page frame use `root.declare(children, Frame)` instead; `mount(plugin)` runs a real fiber with fail-loud service prechecks, and `dispose()` tears down views, feature fibers, minted scopes, and persisted store state on one axis.
 

package/README.zh.md

@@ -2,9 +2,9 @@
 
 [English](README.md) | 中文
 
-面向客户端功能测试的 jsdom slot 测试运行时：真实 Cordis `Context`、生产 `SlotsService` 与 web-react 渲染器，围绕带类型的 session/workspace 测试替身组装。功能套件无需逐套件手搭机器即可测遍声明、注册、scope、store、inject、渲染、更新与销毁——且不存在任何生产逻辑的第二份实现。
+面向客户端功能测试的 jsdom slot 测试运行时：真实 Cordis `Context`、生产 `SlotRegistry` 与 web-react 渲染器，围绕带类型的 session/workspace 测试替身组装。功能套件无需逐套件手搭机器即可测遍声明、注册、scope、store、inject、渲染、更新与销毁——且不存在任何生产逻辑的第二份实现。
 
-替身实现的正是功能通过 ctx 获得的对外接口（`TestSessions implements ISessions`、`TestWorkspaces implements IWorkspaces`；每个 fixture session 是 `FixtureSession implements SessionFace`；`stubSettingsScope` 是发布由测试驱动、带写入 spy 的 `SettingsScope`），生产面一旦改形，测试台在编译期即断，而非静默漂移。provide bundle 材料化直接运行生产 `SessionProvideChannel`——与 `SessionsService` 共用同一份实现。fixture 灌入的是普通数据：列表行、会话快照（经 `updateSnapshot` 以 immer 补丁改写）、projection 值，以及按 `ISession` 取型的行为桩——spec 调用未打桩的动词时报错自明。带类型的 `provide()` 将已声明服务名的 fake 约束为该服务对外面的 `Partial` 子集。
+替身实现的正是功能通过 ctx 获得的对外接口（`TestSessions implements ISessions`、`TestWorkspaces implements IWorkspaces`；每个 fixture session 是 `FixtureSession implements SessionFace`；`stubSettingsScope` 是发布由测试驱动、带写入 spy 的 `SettingsScope`），生产面一旦改形，测试台在编译期即断，而非静默漂移。provide bundle 材料化直接运行生产 `SessionProvideChannel`——与 `SessionRuntime` 共用同一份实现。fixture 灌入的是普通数据：列表行、会话快照（经 `updateSnapshot` 以 immer 补丁改写）、projection 值，以及按 `ISession` 取型的行为桩——spec 调用未打桩的动词时报错自明。带类型的 `provide()` 将已声明服务名的 fake 约束为该服务对外面的 `Partial` 子集。
 
 局部 DOM 快照：`declare(children)` 注册自动 frame，逐 key 的 `<div data-slot>` 包裹层即快照根；`renderSlot(key, owner)` 返回该 slot 的局部视图（container、限定范围的 Testing Library 查询、原位 `update(owner)`）；注册的快照序列化器把 CSS-module 哈希类名折回语义名（`_frame_a1b2c3` → `frame`）保持 `.snap` 只含结构，并把 `<svg>` 内部折叠为 `data-content` 指纹。需要自定义页面 frame 的套件改用 `root.declare(children, Frame)`；`mount(plugin)` 在真实 fiber 上运行并对缺失服务先行报错；`dispose()` 沿单一轴拆除视图、feature fiber、已铸 scope 与持久化 store 状态。
 

package/lib/index.js

@@ -1,7 +1,7 @@
 import { Context, Inject } from "@deepseek-ai/cordis";
 import { Fragment, createElement, useSyncExternalStore } from "react";
 import { act, render, within } from "@testing-library/react";
-import { ConversationEventRegistry, ConversationViewRegistry, EMPTY_CHAT_SNAPSHOT, SessionProvideChannel, SlotsService, createScope, createSnapshotStore, scopeOf } from "@deepseek-ai/dsh-client-runtime/client";
+import { ConversationEventRegistry, ConversationViewRegistry, EMPTY_CHAT_SNAPSHOT, EMPTY_CONVERSATION_VIEWS, SessionProvideChannel, SlotRegistry, createScope, createSnapshotStore, scopeOf } from "@deepseek-ai/dsh-client-runtime/client";
 import { createSlotRenderer } from "@deepseek-ai/dsh-client-web-react";
 import { afterEach, beforeEach, expect, vi } from "vitest";
 import { SESSION_SEARCH_RESULT_LIMIT } from "@deepseek-ai/dsh-host-apiproxy/api";
@@ -90,6 +90,7 @@ function registerDomSnapshotSerializer() {
 function conversationSnapshot(sessionId) {
 	return {
 		sessionId,
+		views: EMPTY_CONVERSATION_VIEWS,
 		chat: EMPTY_CHAT_SNAPSHOT,
 		nodes: [],
 		turnTimings: /* @__PURE__ */ new Map(),
@@ -112,7 +113,7 @@ function conversationSnapshot(sessionId) {
 	};
 }
 /**
-* A ready workspace list with no workspaces (the shape WorkspacesService
+* A ready workspace list with no workspaces (the shape WorkspaceRuntime
 * projects after both baselines land).
 * @returns the initial state of the test workspaces store.
 */
@@ -261,9 +262,9 @@ var TestSessions = class {
 	/** The useSessions standard feed (list rows + current selection). */
 	list;
 	/**
-	* Atomic current-session provide projection (production SessionsService
+	* Atomic current-session provide projection (production SessionRuntime
 	* mirror): selection changes and provider-roster changes publish through
-	* this one source — the member the SlotsService host face hands the
+	* this one source — the member the SlotRegistry host face hands the
 	* renderer's SessionProvider.
 	*/
 	currentProvideInfo;
@@ -289,6 +290,7 @@ var TestSessions = class {
 			current: void 0,
 			phase: "ready",
 			subagentsByParent: {},
+			jobsBySession: {},
 			currentAddress: void 0
 		});
 		this.channel = new SessionProvideChannel({
@@ -385,7 +387,7 @@ var TestSessions = class {
 	/**
 	* Remove a session: list row, scope fiber, and per-session store instances
 	* (with persisted state) die together — the same single lifecycle axis the
-	* production SessionsService drives on session death, minus staging.
+	* production SessionRuntime drives on session death, minus staging.
 	* @param id - session id.
 	*/
 	async remove(id) {
@@ -820,6 +822,18 @@ var TestWorkspaces = class {
 		await this.stubs.get("delete")?.(workspaceId);
 	}
 	/**
+	* Move a Workspace in display order (recorded; default no-op).
+	* @param workspaceId - Workspace to move.
+	* @param beforeWorkspaceId - Anchor; omitted appends.
+	*/
+	async insertBefore(workspaceId, beforeWorkspaceId) {
+		this.calls.push({
+			method: "insertBefore",
+			args: [workspaceId, beforeWorkspaceId]
+		});
+		await this.stubs.get("insertBefore")?.(workspaceId, beforeWorkspaceId);
+	}
+	/**
 	* Move an accounted session (recorded). The default echoes a minimal view.
 	* @param workspaceId - target workspace.
 	* @param sessionId - session to move.
@@ -876,12 +890,15 @@ function stubSettingsScope() {
 	let snapshot = {
 		status: "loading",
 		value: void 0,
+		base: void 0,
+		user: void 0,
 		revision: void 0,
 		writable: false,
 		mode: "host"
 	};
 	const listeners = /* @__PURE__ */ new Set();
 	const set = vi.fn(() => Promise.resolve());
+	const unset = vi.fn(() => Promise.resolve());
 	return {
 		scope: {
 			getSnapshot: () => snapshot,
@@ -891,9 +908,11 @@ function stubSettingsScope() {
 					listeners.delete(listener);
 				};
 			},
-			set
+			set,
+			unset
 		},
 		set,
+		unset,
 		listenerCount: () => listeners.size,
 		publish: (next) => {
 			snapshot = {
@@ -905,10 +924,73 @@ function stubSettingsScope() {
 	};
 }
 //#endregion
+//#region lib/types/remote.js
+/**
+* Remote service test double for the forwarded-event path. Feature specs need
+* `ctx.remote.$on` to exist (their plugins inject `remote`) and need forwarded
+* host events to reach those subscribers, but not the generated namespaces or
+* the wire — so this double implements subscription and dispatch only.
+*
+* Dispatch is driven the same way production drives it: `client/runtime` owns the
+* host frame sink and hands each decoded `host/remote-event` frame to
+* `$dispatch`. A spec therefore exercises its refresh chains by calling
+* `$dispatch(name, args)` on this double.
+*
+* `$mount` rejects: a spec that reaches a generated namespace through this
+* double has outgrown it and needs the real Client Remote service.
+*
+* One deliberate asymmetry with production: a throwing listener propagates out
+* of the emit instead of being contained and logged, so a spec cannot lean on
+* this double for the containment guarantee `$on` documents — assert that
+* against the real service.
+*/
+var TestRemote = class {
+	subscriptions = /* @__PURE__ */ new Map();
+	/**
+	* Register the double as `ctx.remote`.
+	* @param ctx - the spec's root Context.
+	*/
+	constructor(ctx) {
+		ctx.provide("remote", this);
+	}
+	/**
+	* Deliver one forwarded host event to its subscribers, standing in for the
+	* carrier that owns the frame sink.
+	* @param event - forwarded host event name.
+	* @param args - the Host argument list, verbatim.
+	*/
+	$dispatch(event, args) {
+		const listeners = this.subscriptions.get(event);
+		if (listeners === void 0) return;
+		for (const listener of [...listeners]) listener(...args);
+	}
+	/**
+	* Subscribe to one forwarded host event.
+	* @param event - forwarded host event name.
+	* @param listener - receives the Host argument list verbatim.
+	* @returns disposer removing this subscription.
+	*/
+	$on(event, listener) {
+		const listeners = this.subscriptions.get(event) ?? /* @__PURE__ */ new Set();
+		this.subscriptions.set(event, listeners);
+		listeners.add(listener);
+		return () => {
+			listeners.delete(listener);
+		};
+	}
+	/**
+	* Generated-namespace mount, unsupported by this double.
+	* @returns never; always rejects.
+	*/
+	$mount() {
+		return Promise.reject(/* @__PURE__ */ new Error("TestRemote: $mount needs the real Client Remote service"));
+	}
+};
+//#endregion
 //#region lib/types/translate.js
 /**
 * Test double of the locale lookup chain: a translate stub over plain
-* dictionaries, mirroring LocaleService's resolution order (first dictionary
+* dictionaries, mirroring LocaleRuntime's resolution order (first dictionary
 * that owns the key wins, then the key itself stays visible) and its
 * `{name}` template interpolation. Specs stub the framework-injected `t`
 * seat with `makeTranslate(zh, commonZh)` instead of re-implementing the
@@ -938,7 +1020,7 @@ function makeTranslate(...dicts) {
 //#region lib/types/locale-env.js
 /**
 * Browser-language pin for specs that assert localized copy. A fresh
-* LocaleService with no stored preference opens in the language `navigator`
+* LocaleRuntime with no stored preference opens in the language `navigator`
 * asks for, and jsdom reports the runner's own (`en-US`) — so a spec asserting
 * the product's Chinese copy states the browser it assumes instead of
 * inheriting the machine's.
@@ -971,7 +1053,7 @@ function usePinnedBrowserLanguages(primary, ...rest) {
 //#region lib/types/index.js
 /**
 * jsdom slot test runtime: a real small runtime — Cordis `Context`, the
-* runtime `SlotsService`, and the web-react renderer — assembled around
+* runtime `SlotRegistry`, and the web-react renderer — assembled around
 * test-owned session/workspace doubles, so feature specs exercise
 * declaration, registration, scope, store, inject, rendering, updates, and
 * disposal without hand-building the machinery per suite.
@@ -1029,7 +1111,7 @@ var TestRoot = class {
 	stabilize;
 	disposeEntry;
 	/**
-	* @param slots - the runtime SlotsService.
+	* @param slots - the runtime SlotRegistry.
 	* @param stabilize - the owning runtime's act wrapper.
 	*/
 	constructor(slots, stabilize) {
@@ -1067,7 +1149,7 @@ var TestRoot = class {
 var SlotTestRuntime = class SlotTestRuntime {
 	/** The runtime's Cordis root (escape hatch: extra services via `ctx.provide`, raw `ctx.plugin` mounts). */
 	ctx;
-	/** The production SlotsService mounted on {@link SlotTestRuntime.ctx}. */
+	/** The production SlotRegistry mounted on {@link SlotTestRuntime.ctx}. */
 	slots;
 	/** The test-owned 'root' occupant. */
 	root;
@@ -1103,14 +1185,14 @@ var SlotTestRuntime = class SlotTestRuntime {
 		} });
 	}
 	/**
-	* Assemble a runtime: real Context, mounted SlotsService, installed
+	* Assemble a runtime: real Context, mounted SlotRegistry, installed
 	* renderer, and the session/workspace doubles provided as services.
 	* @returns the ready runtime.
 	*/
 	static async create() {
 		registerDomSnapshotSerializer();
 		const ctx = new Context();
-		await ctx.plugin(SlotsService).await();
+		await ctx.plugin(SlotRegistry).await();
 		await ctx.plugin(ConversationEventRegistry).await();
 		await ctx.plugin(ConversationViewRegistry).await();
 		return new SlotTestRuntime(ctx, ctx.get("slots"));
@@ -1167,10 +1249,10 @@ var SlotTestRuntime = class SlotTestRuntime {
 	/**
 	* Declare child slots under an auto-generated root frame — the single-slot
 	* mounting path for local DOM snapshots. Each key later supplied through
-	* {@link SlotTestRuntime.renderSlot} renders inside its own
-	* `<div data-slot="<key>">` wrapper (the snapshot root). Mutually exclusive
-	* with {@link TestRoot.declare} ('root' is a single slot); one call per
-	* runtime.
+	* {@link SlotTestRuntime.renderSlot} renders inside the renderer's own
+	* `<div data-slot="<key>">` outlet anchor (the snapshot root — the frame
+	* adds no wrapper of its own). Mutually exclusive with
+	* {@link TestRoot.declare} ('root' is a single slot); one call per runtime.
 	* @param children - child-slot declaration table (same contract as TestRoot.declare).
 	* @returns completion of the act-wrapped registration.
 	*/
@@ -1179,10 +1261,7 @@ var SlotTestRuntime = class SlotTestRuntime {
 		const cell = this.ownerCell;
 		const AutoFrame = (props) => {
 			useSyncExternalStore(cell.subscribe, cell.getVersion);
-			return createElement(Fragment, null, cell.entries().map(([key, owner]) => createElement("div", {
-				"data-slot": key,
-				key
-			}, props.renderSlot(key, owner))));
+			return createElement(Fragment, null, cell.entries().map(([key, owner]) => createElement(Fragment, { key }, props.renderSlot(key, owner))));
 		};
 		await this.root.declare(children, AutoFrame);
 	}
@@ -1256,4 +1335,4 @@ var SlotTestRuntime = class SlotTestRuntime {
 	}
 };
 //#endregion
-export { FixtureSession, SlotTestRuntime, TestRoot, TestSessions, TestWorkspaces, conversationSnapshot, domSnapshotSerializer, makeTranslate, registerDomSnapshotSerializer, stubSettingsScope, usePinnedBrowserLanguages, workspaceListState };
+export { FixtureSession, SlotTestRuntime, TestRemote, TestRoot, TestSessions, TestWorkspaces, conversationSnapshot, domSnapshotSerializer, makeTranslate, registerDomSnapshotSerializer, stubSettingsScope, usePinnedBrowserLanguages, workspaceListState };

package/lib/invariant.js

@@ -10,7 +10,7 @@ const name = "client-test-runtime-invariant";
 const inject = ["invariants"];
 /**
 * No runtime invariant: this test-support package owns no production event
-* stream or mutable data — it assembles the runtime SlotsService and renderer
+* stream or mutable data — it assembles the runtime SlotRegistry and renderer
 * (whose packages own their invariants) around test doubles; its own behavior
 * is exercised by its package tests.
 */

package/lib/types/fixtures.d.ts

@@ -38,7 +38,7 @@ export interface SessionFixture {
  */
 export declare function conversationSnapshot(sessionId: SessionId): ConversationSnapshot;
 /**
- * A ready workspace list with no workspaces (the shape WorkspacesService
+ * A ready workspace list with no workspaces (the shape WorkspaceRuntime
  * projects after both baselines land).
  * @returns the initial state of the test workspaces store.
  */

package/lib/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * jsdom slot test runtime: a real small runtime — Cordis `Context`, the
- * runtime `SlotsService`, and the web-react renderer — assembled around
+ * runtime `SlotRegistry`, and the web-react renderer — assembled around
  * test-owned session/workspace doubles, so feature specs exercise
  * declaration, registration, scope, store, inject, rendering, updates, and
  * disposal without hand-building the machinery per suite.
@@ -15,7 +15,7 @@ import type { Fiber, Plugin } from '@deepseek-ai/cordis';
 import type { RenderResult } from '@testing-library/react';
 import type { queries } from '@testing-library/dom';
 import type { BoundFunctions } from '@testing-library/dom';
-import { SlotsService } from '@deepseek-ai/dsh-client-runtime/client';
+import { SlotRegistry } from '@deepseek-ai/dsh-client-runtime/client';
 import type { ChildrenDecl, ComposedProps, OwnerOf, SlotComponent, SlotMap, StoreInstanceLike } from '@deepseek-ai/dsh-client-ui-slots';
 import { TestSessions } from './sessions.ts';
 import { TestWorkspaces } from './workspaces.ts';
@@ -25,18 +25,20 @@ export { FixtureSession, TestSessions } from './sessions.ts';
 export { stubSettingsScope } from './settings-scope.ts';
 export type { StubSettingsScope } from './settings-scope.ts';
 export { TestWorkspaces } from './workspaces.ts';
+export { TestRemote } from './remote.ts';
 export { conversationSnapshot, workspaceListState } from './fixtures.ts';
 export type { SessionBehaviorOverrides, SessionFixture, Stabilizer } from './fixtures.ts';
 export { makeTranslate } from './translate.ts';
 export { usePinnedBrowserLanguages } from './locale-env.ts';
 /**
  * One rendered slot's local view, from {@link SlotTestRuntime.renderSlot}:
- * the `data-slot` wrapper is the snapshot root (`expect(view.container)
- * .toMatchSnapshot()` captures exactly this slot's output), Testing Library
- * queries are bound inside it, and `update` re-renders with new owner props.
+ * the renderer's own `[data-slot]` outlet anchor is the snapshot root
+ * (`expect(view.container).toMatchSnapshot()` captures exactly this slot's
+ * output), Testing Library queries are bound inside it, and `update`
+ * re-renders with new owner props.
  */
 export interface SlotView<K extends keyof SlotMap & string> {
-    /** The `<div data-slot="<key>">` wrapper around the slot's rendered output. */
+    /** The renderer's `<div data-slot="<key>">` anchor around the slot's rendered output. */
     readonly container: HTMLElement;
     /** Testing Library queries scoped to {@link SlotView.container}. */
     readonly view: BoundFunctions<typeof queries>;
@@ -71,10 +73,10 @@ export declare class TestRoot {
     private readonly stabilize;
     private disposeEntry;
     /**
-     * @param slots - the runtime SlotsService.
+     * @param slots - the runtime SlotRegistry.
      * @param stabilize - the owning runtime's act wrapper.
      */
-    constructor(slots: SlotsService, stabilize: Stabilizer);
+    constructor(slots: SlotRegistry, stabilize: Stabilizer);
     /**
      * Register the root frame, declaring (and thereby claiming) the child
      * slots. One declaration per runtime — a second call fails loud in the
@@ -96,8 +98,8 @@ export declare class TestRoot {
 export declare class SlotTestRuntime {
     /** The runtime's Cordis root (escape hatch: extra services via `ctx.provide`, raw `ctx.plugin` mounts). */
     readonly ctx: Context;
-    /** The production SlotsService mounted on {@link SlotTestRuntime.ctx}. */
-    readonly slots: SlotsService;
+    /** The production SlotRegistry mounted on {@link SlotTestRuntime.ctx}. */
+    readonly slots: SlotRegistry;
     /** The test-owned 'root' occupant. */
     readonly root: TestRoot;
     /** Sessions double (list/current observable, cells, scopes, behavior faces). */
@@ -115,7 +117,7 @@ export declare class SlotTestRuntime {
     private autoRootView;
     private constructor();
     /**
-     * Assemble a runtime: real Context, mounted SlotsService, installed
+     * Assemble a runtime: real Context, mounted SlotRegistry, installed
      * renderer, and the session/workspace doubles provided as services.
      * @returns the ready runtime.
      */
@@ -148,10 +150,10 @@ export declare class SlotTestRuntime {
     /**
      * Declare child slots under an auto-generated root frame — the single-slot
      * mounting path for local DOM snapshots. Each key later supplied through
-     * {@link SlotTestRuntime.renderSlot} renders inside its own
-     * `<div data-slot="<key>">` wrapper (the snapshot root). Mutually exclusive
-     * with {@link TestRoot.declare} ('root' is a single slot); one call per
-     * runtime.
+     * {@link SlotTestRuntime.renderSlot} renders inside the renderer's own
+     * `<div data-slot="<key>">` outlet anchor (the snapshot root — the frame
+     * adds no wrapper of its own). Mutually exclusive with
+     * {@link TestRoot.declare} ('root' is a single slot); one call per runtime.
      * @param children - child-slot declaration table (same contract as TestRoot.declare).
      * @returns completion of the act-wrapped registration.
      */

package/lib/types/remote.d.ts

@@ -0,0 +1,49 @@
+/** Test-owned Remote face: `$on` subscriptions driven by the internal forwarded-event plumbing. */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Remote service test double for the forwarded-event path. Feature specs need
+ * `ctx.remote.$on` to exist (their plugins inject `remote`) and need forwarded
+ * host events to reach those subscribers, but not the generated namespaces or
+ * the wire — so this double implements subscription and dispatch only.
+ *
+ * Dispatch is driven the same way production drives it: `client/runtime` owns the
+ * host frame sink and hands each decoded `host/remote-event` frame to
+ * `$dispatch`. A spec therefore exercises its refresh chains by calling
+ * `$dispatch(name, args)` on this double.
+ *
+ * `$mount` rejects: a spec that reaches a generated namespace through this
+ * double has outgrown it and needs the real Client Remote service.
+ *
+ * One deliberate asymmetry with production: a throwing listener propagates out
+ * of the emit instead of being contained and logged, so a spec cannot lean on
+ * this double for the containment guarantee `$on` documents — assert that
+ * against the real service.
+ */
+export declare class TestRemote {
+    private readonly subscriptions;
+    /**
+     * Register the double as `ctx.remote`.
+     * @param ctx - the spec's root Context.
+     */
+    constructor(ctx: Context);
+    /**
+     * Deliver one forwarded host event to its subscribers, standing in for the
+     * carrier that owns the frame sink.
+     * @param event - forwarded host event name.
+     * @param args - the Host argument list, verbatim.
+     */
+    $dispatch(event: string, args: readonly unknown[]): void;
+    /**
+     * Subscribe to one forwarded host event.
+     * @param event - forwarded host event name.
+     * @param listener - receives the Host argument list verbatim.
+     * @returns disposer removing this subscription.
+     */
+    $on(event: string, listener: (...args: never[]) => void): () => void;
+    /**
+     * Generated-namespace mount, unsupported by this double.
+     * @returns never; always rejects.
+     */
+    $mount(): Promise<() => Promise<void>>;
+}
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/sessions.d.ts

@@ -1,4 +1,4 @@
-/** Test-owned sessions face: the SlotsService host contract over declarative fixtures. */
+/** Test-owned sessions face: the SlotRegistry host contract over declarative fixtures. */
 import type { Context } from '@deepseek-ai/cordis';
 import type { AttachmentIdType } from '@deepseek-ai/dsh-attachment';
 import type { AgentContext, ConversationSnapshot, ISessions, ProjectionsFace, SessionFace, SessionId, SessionListState, SessionProvideDescriptor, SessionSearchResultItem, SessionSummary, SnapshotStore, SubagentAddress } from '@deepseek-ai/dsh-client-runtime/client';
@@ -95,9 +95,9 @@ export declare class TestSessions implements ISessions {
     /** The useSessions standard feed (list rows + current selection). */
     readonly list: SnapshotStore<SessionListState>;
     /**
-     * Atomic current-session provide projection (production SessionsService
+     * Atomic current-session provide projection (production SessionRuntime
      * mirror): selection changes and provider-roster changes publish through
-     * this one source — the member the SlotsService host face hands the
+     * this one source — the member the SlotRegistry host face hands the
      * renderer's SessionProvider.
      */
     readonly currentProvideInfo: HostObservable<SessionMaybeProvideInfo>;
@@ -149,7 +149,7 @@ export declare class TestSessions implements ISessions {
     /**
      * Remove a session: list row, scope fiber, and per-session store instances
      * (with persisted state) die together — the same single lifecycle axis the
-     * production SessionsService drives on session death, minus staging.
+     * production SessionRuntime drives on session death, minus staging.
      * @param id - session id.
      */
     remove(id: string): Promise<void>;

package/lib/types/settings-scope.d.ts

@@ -7,6 +7,8 @@ export interface StubSettingsScope<T> {
     scope: SettingsScope<T>;
     /** Spy behind `scope.set`; resolves immediately. */
     set: ReturnType<typeof vi.fn>;
+    /** Spy behind `scope.unset`; resolves immediately. */
+    unset: ReturnType<typeof vi.fn>;
     /** @returns how many listeners are currently subscribed (disposal assertions). */
     listenerCount(): number;
     /**

package/lib/types/translate.d.ts

@@ -1,6 +1,6 @@
 /**
  * Test double of the locale lookup chain: a translate stub over plain
- * dictionaries, mirroring LocaleService's resolution order (first dictionary
+ * dictionaries, mirroring LocaleRuntime's resolution order (first dictionary
  * that owns the key wins, then the key itself stays visible) and its
  * `{name}` template interpolation. Specs stub the framework-injected `t`
  * seat with `makeTranslate(zh, commonZh)` instead of re-implementing the

package/lib/types/workspaces.d.ts

@@ -91,6 +91,12 @@ export declare class TestWorkspaces implements IWorkspaces {
      * @param workspaceId - target workspace.
      */
     delete(workspaceId: WorkspaceId): Promise<void>;
+    /**
+     * Move a Workspace in display order (recorded; default no-op).
+     * @param workspaceId - Workspace to move.
+     * @param beforeWorkspaceId - Anchor; omitted appends.
+     */
+    insertBefore(workspaceId: WorkspaceId, beforeWorkspaceId?: WorkspaceId): Promise<void>;
     /**
      * Move an accounted session (recorded). The default echoes a minimal view.
      * @param workspaceId - target workspace.

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@deepseek-ai/dsh-client-test-runtime",
-  "description": "jsdom slot test runtime: real Cordis Context + SlotsService + web-react renderer with test-owned session/workspace doubles for feature specs",
-  "version": "0.0.1-rc.1",
+  "description": "jsdom slot test runtime: real Cordis Context + SlotRegistry + web-react renderer with test-owned session/workspace doubles for feature specs",
+  "version": "0.0.1-rc.5",
   "publishConfig": {
     "access": "restricted"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
-    "directory": "packages/client/test-runtime"
+    "directory": "packages/test-support/client-runtime"
   },
   "type": "module",
   "main": "lib/index.js",
@@ -34,24 +34,24 @@
   "peerDependencies": {
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.5",
+    "@deepseek-ai/cordis": "^4.0.1-rc.4",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.5"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.5",
+    "@deepseek-ai/cordis": "^4.0.1-rc.4"
   },
   "files": [
     "lib/index.js",