@kirkchinese/dsh-citeciter 0.5.0 → 0.6.0

package/lib/index.js

@@ -1,6 +1,5 @@
-import { E as boardBatchSchema, T as applyBoardOps, _ as documentSummarySchema, a as CITECITER_SETTINGS_NAMESPACE, b as toolEvidenceClaimSchema, c as canonicalCitationIdentity, d as citationSelectionClaimSchema, f as citeCiterRequestSchema, g as documentEvidenceClaimSchema, h as documentContentSchema, i as CITATION_CONTEXT_NAME, l as citationDraftSchema, m as citeCiterSettingsSchema, n as updateCheckErrorCodeSchema, o as DEFAULT_CITECITER_SETTINGS, r as updateCheckResponseSchema, s as TUTOR_SECTION_NAME, t as UpdateChecker, v as parseTopicMetadataFile, w as EMPTY_BOARD_STATE, x as topicMetadataSchema, y as renderCitationContext } from "./update-u9-6c_qp.js";
+import { E as boardBatchSchema, T as applyBoardOps, _ as documentSummarySchema, a as CITECITER_SETTINGS_NAMESPACE, b as toolEvidenceClaimSchema, c as canonicalCitationIdentity, d as citationSelectionClaimSchema, f as citeCiterRequestSchema, g as documentEvidenceClaimSchema, h as documentContentSchema, i as CITATION_CONTEXT_NAME, l as citationDraftSchema, m as citeCiterSettingsSchema, n as updateCheckErrorCodeSchema, o as DEFAULT_CITECITER_SETTINGS, r as updateCheckResponseSchema, s as TUTOR_SECTION_NAME, t as UpdateChecker, v as parseTopicMetadataFile, w as EMPTY_BOARD_STATE, x as topicMetadataSchema, y as renderCitationContext } from "./update-C0K5ekMg.js";
 import { Context, Service } from "@deepseek-ai/cordis";
-import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import z from "@deepseek-ai/schemastery";
 import { createHash, randomUUID } from "node:crypto";
@@ -10,9 +9,10 @@ import AgentRegistry, { installModelSelection } from "@deepseek-ai/dsh-agent";
 import AgentLoop from "@deepseek-ai/dsh-agent-loop";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
 import { BlockAssembler, MessageId, ReasoningEffortId, createUserMessage, freezeMessage } from "@deepseek-ai/dsh-llm";
-import { effectiveSandboxMode, setSandboxMode } from "@deepseek-ai/dsh-sandbox-policy";
-import SessionStore, { SESSION_FORMAT_VERSION, SessionId, foldRequestHeader, snapshotJsonValue } from "@deepseek-ai/dsh-session";
+import SandboxPolicyService, { setSandboxMode } from "@deepseek-ai/dsh-sandbox-policy";
+import SessionStore, { SESSION_FORMAT_VERSION, SessionId, SessionLogOffset, foldRequestHeader } from "@deepseek-ai/dsh-session";
 import JsonlSessionPersistence from "@deepseek-ai/dsh-session-persistence-jsonl";
+import SessionProjectionRegistry from "@deepseek-ai/dsh-session-projection";
 import SessionTitleService, { SessionTitleProviderId, foldSessionTitle } from "@deepseek-ai/dsh-session-title";
 import { generateSessionTitleWithLlm, resolveSessionTitleLlmConfig } from "@deepseek-ai/dsh-session-title-llm";
 import SystemPrompt from "@deepseek-ai/dsh-system-prompt";
@@ -22,6 +22,7 @@ import * as ToolFsSearch from "@deepseek-ai/dsh-tool-fs-search";
 import ToolRuntime, { defineTool } from "@deepseek-ai/dsh-tools";
 import UserQuestionService, { UserQuestionError } from "@deepseek-ai/dsh-user-questions";
 import { z as z$1 } from "zod";
+import { snapshotJsonValue } from "@deepseek-ai/dsh-util-values";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -15343,9 +15344,7 @@ const BLACKBOARD_APPLY_PARAMETERS = { ops: {
 } };
 /** Select the first human question added after a Topic's inherited seed. */
 function selectTopicTitleMessage(request) {
-	const seedLength = request.session.header.seedLength ?? 0;
-	const seedBoundary = request.session.events[seedLength - 1]?.seq ?? -1;
-	const first = request.messages.find((message) => message.seq > seedBoundary);
+	const first = request.messages.find((message) => message.seq >= request.session.inheritedEventCount);
 	if (first === void 0) throw new Error("CiteCiter title generation requires one post-seed user question");
 	return first;
 }
@@ -15447,6 +15446,7 @@ const topicDeletionMarkerSchema = z$1.object({
 		version: z$1.number().int().nonnegative(),
 		id: z$1.string().min(1),
 		createdAt: z$1.number().int().nonnegative(),
+		isSeeded: z$1.boolean().default(false),
 		cwd: z$1.string().optional()
 	}).strict()
 }).strict();
@@ -15554,6 +15554,7 @@ var TopicIndex = class {
 				version: sessionHeader.version,
 				id: sessionHeader.id,
 				createdAt: sessionHeader.createdAt,
+				isSeeded: sessionHeader.isSeeded,
 				...sessionHeader.cwd === void 0 ? {} : { cwd: sessionHeader.cwd }
 			}
 		};
@@ -15673,7 +15674,7 @@ function latestObservedSeq(events) {
 function topicMessages(log) {
 	const messages = [];
 	const toolIndexes = /* @__PURE__ */ new Map();
-	const start = log.header.seedLength ?? 0;
+	const start = log.inheritedEventCount;
 	let partial = null;
 	let error = null;
 	const attemptByTurn = /* @__PURE__ */ new Map();
@@ -15813,7 +15814,7 @@ function projectBoardFromLog(log) {
 	let state = EMPTY_BOARD_STATE;
 	let revision = 0;
 	let invalid = 0;
-	const start = log.header.seedLength ?? 0;
+	const start = log.inheritedEventCount;
 	for (const event of log.events.slice(start)) {
 		if (event.type === "tool/call" && event.data.name === "blackboard_apply") {
 			calls.set(String(event.data.callId), event.data.arguments);
@@ -15850,7 +15851,7 @@ function projectBoardFromLog(log) {
 * @returns the first post-seed question, or `null` when it has not been committed.
 */
 function firstPostSeedUserQuestion(log) {
-	for (const event of log.events.slice(log.header.seedLength ?? 0)) {
+	for (const event of log.events.slice(log.inheritedEventCount)) {
 		if (event.type !== "user/message" || event.data.source.kind !== "user") continue;
 		const text = textBlocks(event.data.content, "text");
 		if (text !== "") return text;
@@ -15867,7 +15868,7 @@ function pendingPostSeedUserMessages(log) {
 		"next-turn": [],
 		"next-step": []
 	};
-	for (const event of log.events.slice(log.header.seedLength ?? 0)) {
+	for (const event of log.events.slice(log.inheritedEventCount)) {
 		if (event.type !== "agent/inbox/spliced") continue;
 		pending[event.data.target].splice(event.data.start, event.data.removedCount ?? 0, ...event.data.inserted);
 	}
@@ -15886,7 +15887,7 @@ function postSeedUserQuestionById(log, messageId) {
 	return pending === void 0 ? null : textBlocks(pending.content, "text");
 }
 function committedPostSeedUserQuestionById(log, messageId) {
-	for (const event of log.events.slice(log.header.seedLength ?? 0)) {
+	for (const event of log.events.slice(log.inheritedEventCount)) {
 		if (event.type !== "user/message" || event.data.source.kind !== "user" || String(event.data.id) !== messageId) continue;
 		return textBlocks(event.data.content, "text");
 	}
@@ -16016,8 +16017,6 @@ var TopicRuntime = class {
 	releaseLlm;
 	releaseFs;
 	releaseSubprocess;
-	releaseSandboxPolicy;
-	releaseQuestionProvider;
 	hasSourceFiles = false;
 	closed = false;
 	/** @param host - owning DSH context. @param settings - current user preferences. */
@@ -16156,14 +16155,14 @@ var TopicRuntime = class {
 			this.releaseLlm = this.runtime.provide("llm", this.host.llm);
 			const sourceFs = this.host.get("fs");
 			const sourceSubprocess = this.host.get("subprocess");
-			const sandboxPolicy = this.host.get("sandboxPolicy");
-			if (sourceFs !== void 0 && sourceSubprocess !== void 0 && sandboxPolicy !== void 0) {
+			if (sourceFs !== void 0 && sourceSubprocess !== void 0) {
 				this.releaseFs = this.runtime.provide("fs", sourceFs);
 				this.releaseSubprocess = this.runtime.provide("subprocess", sourceSubprocess);
-				this.releaseSandboxPolicy = this.runtime.provide("sandboxPolicy", sandboxPolicy);
 				this.hasSourceFiles = true;
 			}
 			this.fibers.push(await this.runtime.plugin(SessionStore));
+			this.fibers.push(await this.runtime.plugin(SessionProjectionRegistry));
+			this.fibers.push(await this.runtime.plugin(SandboxPolicyService, { mode: "read-only" }));
 			this.fibers.push(await this.runtime.plugin(AgentRegistry));
 			this.fibers.push(await this.runtime.plugin(SystemPrompt, {
 				includeHarnessIdentity: true,
@@ -16171,7 +16170,6 @@ var TopicRuntime = class {
 			}));
 			this.fibers.push(await this.runtime.plugin(ToolRuntime, { mode: "native" }));
 			this.fibers.push(await this.runtime.plugin(UserQuestionService));
-			this.releaseQuestionProvider = this.runtime.userQuestions.registerProvider({ ask: (request) => this.askUser(request) });
 			this.fibers.push(await this.runtime.plugin(ToolAskUser));
 			if (this.hasSourceFiles) {
 				this.fibers.push(await this.runtime.plugin(ToolFs, {}));
@@ -16218,12 +16216,6 @@ var TopicRuntime = class {
 	}
 	async releaseOwnedRuntime() {
 		const failures = [];
-		try {
-			this.releaseQuestionProvider?.();
-		} catch (error) {
-			failures.push(error);
-		}
-		this.releaseQuestionProvider = void 0;
 		for (const pending of this.pendingQuestions.values()) {
 			pending.signal?.removeEventListener("abort", pending.onAbort);
 			pending.reject(new UserQuestionError(CITECITER_SHUTTING_DOWN, "ASK_ABORTED"));
@@ -16256,7 +16248,6 @@ var TopicRuntime = class {
 		this.titleRefreshes.clear();
 		this.opening.clear();
 		for (const release of [
-			this.releaseSandboxPolicy,
 			this.releaseSubprocess,
 			this.releaseFs,
 			this.releaseLlm
@@ -16265,7 +16256,6 @@ var TopicRuntime = class {
 		} catch (error) {
 			failures.push(error);
 		}
-		this.releaseSandboxPolicy = void 0;
 		this.releaseFs = void 0;
 		this.releaseSubprocess = void 0;
 		this.releaseLlm = void 0;
@@ -16454,10 +16444,11 @@ var TopicRuntime = class {
 			sessionId: SessionId(metadata.sessionId),
 			...metadata.mode === "exact-fork" ? {
 				seed,
+				inheritedEventCount: SessionLogOffset(seed.length),
 				meta: {
 					...metadata.sourceCwd === "" ? {} : { cwd: metadata.sourceCwd },
 					parentSession: SessionId(metadata.sourceSessionId),
-					seedLength: seed.length
+					isSeeded: true
 				}
 			} : metadata.sourceCwd === "" ? {} : { meta: { cwd: metadata.sourceCwd } },
 			agentOptions: {
@@ -16475,7 +16466,7 @@ var TopicRuntime = class {
 		this.handles.set(metadata.sessionId, handle);
 		return handle;
 	}
-	setupAgent(agentCtx, metadata) {
+	async setupAgent(agentCtx, metadata) {
 		const agent = agentCtx.agent;
 		if (agent === void 0) throw new Error("CiteCiter Topic setup has no scoped Agent");
 		const selection = metadataModelSelection(metadata);
@@ -16518,14 +16509,21 @@ var TopicRuntime = class {
 		});
 		agentCtx.on("agent/request", async (_request, next) => {
 			const current = await next();
-			if (foldRequestHeader(agent.session.events) !== void 0) return current;
+			if (agent.session.requestHeader() !== void 0) return current;
 			return {
 				...current,
 				...metadata.modelConfig.temperature === void 0 ? {} : { temperature: metadata.modelConfig.temperature },
 				...metadata.modelConfig.stop === void 0 ? {} : { stop: [...metadata.modelConfig.stop] }
 			};
 		});
-		if (effectiveSandboxMode(agent.session.events) !== "read-only") setSandboxMode(agent.session, "read-only");
+		await agentCtx.plugin({
+			name: "citeciter-topic-policy",
+			inject: ["sandboxPolicy"],
+			apply(policyCtx) {
+				if (policyCtx.sandboxPolicy.overrideOf(agent.session) !== "read-only") setSandboxMode(agent.session, "read-only");
+			}
+		});
+		agentCtx.on("user-questions/request", (request) => this.askUser(request));
 	}
 	globTool() {
 		return defineTool({
@@ -16659,7 +16657,8 @@ var TopicRuntime = class {
 				if (session === void 0) throw new Error("blackboard_apply requires a Topic Session");
 				const current = projectBoardFromLog({
 					header: session.header,
-					events: session.events
+					events: session.snapshotEvents(),
+					inheritedEventCount: session.inheritedEventCount
 				});
 				applyBoardOps(new Map(current.elements.map((element) => [element.id, element])), ops);
 				return { applied: ops.length };
@@ -16923,13 +16922,13 @@ var TopicRuntime = class {
 					exec.signal.throwIfAborted();
 					sourceAvailable = false;
 					const agent = agentCtx.agent;
-					if (metadata.mode !== "exact-fork" || agent === void 0 || agent.session.header.seedLength === void 0) {
+					if (metadata.mode !== "exact-fork" || agent === void 0 || !agent.session.header.isSeeded) {
 						await this.rememberSourceAvailability(metadata, false);
 						throw error;
 					}
 					source = {
 						session: { id: SessionId(metadata.sourceSessionId) },
-						events: agent.session.events.slice(0, agent.session.header.seedLength)
+						events: agent.session.snapshotEvents(SessionLogOffset(0), agent.session.inheritedEventCount)
 					};
 				}
 				exec.signal.throwIfAborted();
@@ -17238,16 +17237,17 @@ var TopicRuntime = class {
 			cleanup
 		};
 	}
-	/** Await rc.2 JSONL retirement without populating its prepared-session cache. */
+	/** Await JSONL retirement without populating its prepared-session cache. */
 	async readRetiredSessionHeader(metadata, signal) {
 		try {
-			return (await this.runtime.sessionPersistence.readFrom(SessionId(metadata.sessionId), 0, signal)).meta;
+			return (await this.runtime.sessionPersistence.readFrom(SessionId(metadata.sessionId), SessionLogOffset(0), signal)).meta;
 		} catch (error) {
 			if (!(error instanceof Error) || error.message !== `session "${metadata.sessionId}" not found`) throw error;
 			return {
 				version: SESSION_FORMAT_VERSION,
 				id: SessionId(metadata.sessionId),
 				createdAt: metadata.createdAt,
+				isSeeded: metadata.mode === "exact-fork",
 				...metadata.sourceCwd === "" ? {} : { cwd: metadata.sourceCwd }
 			};
 		}
@@ -17469,13 +17469,15 @@ var TopicRuntime = class {
 		const live = this.handles.get(metadata.sessionId)?.agent.session;
 		if (live !== void 0) return {
 			header: live.header,
-			events: live.events
+			events: live.snapshotEvents(),
+			inheritedEventCount: live.inheritedEventCount
 		};
 		const inspection = await this.runtime.sessionPersistence.inspect(SessionId(metadata.sessionId), signal);
 		if (signal !== void 0) this.assertOpen(signal);
 		return {
 			header: inspection.meta,
-			events: inspection.events
+			events: inspection.events,
+			inheritedEventCount: inspection.inheritedEventCount
 		};
 	}
 	scheduleSourceAvailabilityCheck(metadata) {
@@ -17556,7 +17558,7 @@ var TopicRuntime = class {
 	}
 	scheduleExactTitleRefresh(metadata, log) {
 		if (this.closed || metadata.mode !== "exact-fork" || this.titleRefreshAttempted.has(metadata.sessionId) || this.handles.get(metadata.sessionId)?.agent.status === "running") return;
-		const postSeed = log.events.slice(log.header.seedLength ?? 0);
+		const postSeed = log.events.slice(log.inheritedEventCount);
 		if (!postSeed.some((event) => event.type === "request/header") || !postSeed.some((event) => event.type === "assistant/message")) return;
 		this.titleRefreshAttempted.add(metadata.sessionId);
 		const refresh = this.queueTopicAdmission(metadata.sessionId, async () => {
@@ -17632,7 +17634,7 @@ const inject = [
 	"subprocess"
 ];
 /** Host settings identity shared with the browser settings scope. */
-const CITECITER_SETTINGS_NS = settingsNamespace(CITECITER_SETTINGS_NAMESPACE);
+const CITECITER_SETTINGS_NS = CITECITER_SETTINGS_NAMESPACE;
 /** Native settings schema for new Topics and the companion panel. */
 const CITECITER_SETTINGS_SCHEMA = z.object({
 	defaultMode: z.union(["observer", "exact-when-available"]).default(DEFAULT_CITECITER_SETTINGS.defaultMode),
@@ -17761,7 +17763,12 @@ let CiteCiterHost = (() => {
 		}
 		/** Check npm for an installable stable version without changing this installation. */
 		async checkUpdate(signal) {
-			return this.updates.check(signal);
+			const result = await this.updates.check(signal);
+			const desktop = this.ctx.get("desktopProfiles");
+			return result.kind === "success" && desktop !== void 0 ? {
+				...result,
+				profile: desktop.current.name
+			} : result;
 		}
 	};
 })();

package/lib/{typert-common-DKqYKnRO.js → typert-common-C6yTitXx.js}

@@ -1,4 +1,4 @@
-import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-u9-6c_qp.js";
+import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-C0K5ekMg.js";
 //#region lib/types/typert-common.js
 /** Strict root-scoped Topic command shared by Host and browser manifests. */
 const citeCiterRequestDescriptor = {

package/lib/typert.host.js

@@ -1,5 +1,5 @@
-import { C as topicSummarySchema, S as topicSnapshotSchema, f as citeCiterRequestSchema, l as citationDraftSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema, u as citationRecordSchema } from "./update-u9-6c_qp.js";
-import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DKqYKnRO.js";
+import { C as topicSummarySchema, S as topicSnapshotSchema, f as citeCiterRequestSchema, l as citationDraftSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema, u as citationRecordSchema } from "./update-C0K5ekMg.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-C6yTitXx.js";
 //#region lib/types/typert.host.js
 /** Handwritten strict Host contribution matching the single Remote decorator. */
 const TYPERT = {

package/lib/typert.remote-client.js

@@ -1,4 +1,4 @@
-import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DKqYKnRO.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-C6yTitXx.js";
 //#region lib/types/typert.remote-client.js
 /** Browser contribution mounted by the CiteCiter Client fiber. */
 const TYPERT_REMOTE = {

package/lib/types/client/companion-controller.d.ts

@@ -1,4 +1,7 @@
-import { type ISessions, type SessionId, type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings, type ProviderOption, type QuestionAnswer, type TopicScenario, type TopicSnapshot, type TopicSummary } from '../topic.ts';
 import { type CreateMode, type DocumentClaimIntent } from './request-guard.ts';
@@ -56,4 +59,4 @@ export interface CompanionFace {
 /** Initial browser snapshot for the root-scoped CiteCiter controller. */
 export declare const INITIAL_COMPANION_SNAPSHOT: CompanionSnapshot;
 /** Bind private Topic Remote calls to one browser snapshot and polling lifecycle. */
-export declare function createCompanionController(sessions: ISessions, settingsScope: SettingsScope<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>): CompanionFace;
+export declare function createCompanionController(readChat: (sessionId: SessionId) => ChatSnapshot | undefined, settingsScope: SettingsScope<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>): CompanionFace;

package/lib/types/client/components/BlackboardWorkspace.d.ts

@@ -1,10 +1,12 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, OverlayActions } from '../view-actions.ts';
 import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
-import type { CompanionFace } from '../companion-controller.ts';
-import type { CiteBus } from '../types.ts';
 /** Additional faces owned by CiteCiter's conversation-view registration. */
 export interface BlackboardWorkspaceInjected {
-    readonly companion: CompanionFace;
-    readonly bus: CiteBus;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly companion: CompanionActions;
+    readonly bus: OverlayActions;
     readonly openPanel: () => void;
 }
 export type BlackboardWorkspaceProps = ConvViewProps & BlackboardWorkspaceInjected;
@@ -13,4 +15,4 @@ export type BlackboardWorkspaceProps = ConvViewProps & BlackboardWorkspaceInject
  * @param props - active DSH conversation identity and CiteCiter browser faces.
  * @returns the matching Topic board or a source-specific empty state.
  */
-export declare function BlackboardWorkspace({ sessionId, companion, bus, openPanel }: BlackboardWorkspaceProps): import("react").JSX.Element;
+export declare function BlackboardWorkspace({ useCompanion, sessionId, companion, bus, openPanel }: BlackboardWorkspaceProps): import("react").JSX.Element;

package/lib/types/client/components/CiteCiterSettings.d.ts

@@ -1,11 +1,16 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { UpdateNoticeSnapshot } from '../update-controller.ts';
+import type { SettingsDocumentSnapshot } from '../settings-document.ts';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, UpdateActions, SettingsDocumentActions } from '../view-actions.ts';
 import type { SettingsSectionOwnerProps } from '@deepseek-ai/dsh-client-ui-settings/client';
-import type { CompanionFace } from '../companion-controller.ts';
-import type { SettingsDocumentController } from '../settings-document.ts';
-import type { UpdateController } from '../update-controller.ts';
 export interface CiteCiterSettingsProps extends SettingsSectionOwnerProps {
-    readonly companion: CompanionFace;
-    readonly settingsDocument: SettingsDocumentController;
-    readonly updateController: UpdateController;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly useDocument: SnapshotSelectorHook<SettingsDocumentSnapshot>;
+    readonly useUpdate: SnapshotSelectorHook<UpdateNoticeSnapshot>;
+    readonly companion: CompanionActions;
+    readonly settingsDocument: SettingsDocumentActions;
+    readonly updateController: UpdateActions;
 }
 /** Native DSH settings page for CiteCiter-owned preferences. */
-export declare function CiteCiterSettings({ companion, settingsDocument, updateController }: CiteCiterSettingsProps): import("react").JSX.Element;
+export declare function CiteCiterSettings({ useCompanion, useDocument, useUpdate, companion, settingsDocument, updateController }: CiteCiterSettingsProps): import("react").JSX.Element;

package/lib/types/client/components/CitePanel.d.ts

@@ -1,8 +1,12 @@
-import type { CompanionFace } from '../companion-controller.ts';
-import type { CiteBus } from '../types.ts';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CiteOverlaySnapshot } from '../types.ts';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, OverlayActions } from '../view-actions.ts';
 export interface CitePanelProps {
-    readonly bus: CiteBus;
-    readonly companion: CompanionFace;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    readonly bus: OverlayActions;
+    readonly companion: CompanionActions;
     readonly closePanel: () => void;
     readonly reportParseError: (messageId: string) => void;
 }
@@ -11,4 +15,4 @@ export interface CitePanelProps {
  * @param props - shared panel bus, Topic controller, and host callbacks.
  * @returns the responsive Topic dock and its dialogs, or null while closed.
  */
-export declare function CitePanel({ bus, companion, closePanel, reportParseError }: CitePanelProps): import("react").JSX.Element | null;
+export declare function CitePanel({ useCompanion, useOverlay, bus, companion, closePanel, reportParseError }: CitePanelProps): import("react").JSX.Element | null;

package/lib/types/client/components/DocumentReader.d.ts

@@ -1,5 +1,8 @@
-import type { ReaderFace } from '../reader-controller.ts';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { ReaderSnapshot } from '../reader-controller.ts';
+import type { ReaderActions } from '../view-actions.ts';
 /** Reader shell-overlay entry: compact trigger plus the document library panel. */
-export declare function DocumentReader({ reader }: {
-    readonly reader: ReaderFace;
+export declare function DocumentReader({ reader, useReader }: {
+    readonly reader: ReaderActions;
+    readonly useReader: SnapshotSelectorHook<ReaderSnapshot>;
 }): import("react").JSX.Element;

package/lib/types/client/components/QuestionCard.d.ts

@@ -1,7 +1,7 @@
-import type { CompanionFace } from '../companion-controller.ts';
+import type { CompanionActions } from '../view-actions.ts';
 import type { PendingQuestion } from '../../topic.ts';
 export interface QuestionCardProps {
-    readonly companion: CompanionFace;
+    readonly companion: CompanionActions;
     readonly pending: PendingQuestion;
 }
 /** Collect one standard DSH ask_user_question answer batch inside the private Topic. */

package/lib/types/client/components/SelectionMenu.d.ts

@@ -1,8 +1,12 @@
-import type { CompanionFace } from '../companion-controller.ts';
-import type { CiteBus } from '../types.ts';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CiteOverlaySnapshot } from '../types.ts';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, OverlayActions } from '../view-actions.ts';
 export interface SelectionMenuProps {
-    readonly bus: CiteBus;
-    readonly companion: CompanionFace;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    readonly bus: OverlayActions;
+    readonly companion: CompanionActions;
     readonly openPanel: () => void;
 }
 /**
@@ -10,4 +14,4 @@ export interface SelectionMenuProps {
  * @param props - shared selection state and Topic actions.
  * @returns the contextual creation popover and companion launcher.
  */
-export declare function SelectionMenu({ bus, companion, openPanel }: SelectionMenuProps): import("react").JSX.Element;
+export declare function SelectionMenu({ useCompanion, useOverlay, bus, companion, openPanel }: SelectionMenuProps): import("react").JSX.Element;

package/lib/types/client/components/UpdateNotice.d.ts

@@ -1,11 +1,14 @@
-import { type UpdateController } from '../update-controller.ts';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { UpdateNoticeSnapshot } from '../update-controller.ts';
+import type { UpdateActions } from '../view-actions.ts';
 /** Injected owner of the root-scoped update state. */
 export interface UpdateNoticeProps {
-    readonly updateController: UpdateController;
+    readonly useUpdate: SnapshotSelectorHook<UpdateNoticeSnapshot>;
+    readonly updateController: UpdateActions;
 }
 /**
  * Render the non-modal Web update notice in the frame-wide overlay.
  * @param props - root-scoped update actions and observable state.
  * @returns the available-version card, or no surface while current or suppressed.
  */
-export declare function UpdateNotice({ updateController }: UpdateNoticeProps): import("react").JSX.Element | null;
+export declare function UpdateNotice({ useUpdate, updateController }: UpdateNoticeProps): import("react").JSX.Element | null;

package/lib/types/client/copy.d.ts

@@ -0,0 +1,6 @@
+/** Chinese presentation copy owned by CiteCiter, including shared primitive chrome. */
+import type { JsonTreeLabels, MarkdownLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+/** Localized labels supplied to the Cordis-free Markdown renderer. */
+export declare const markdownLabels: MarkdownLabels;
+/** Localized labels supplied to the Cordis-free JSON inspector. */
+export declare const jsonTreeLabels: JsonTreeLabels;

package/lib/types/client/dock-geometry.d.ts

@@ -0,0 +1,23 @@
+/** Space allocation for the learning panel inside the host content viewport. */
+export interface DockViewport {
+    readonly width: number;
+    readonly height: number;
+    readonly sidebar: number;
+    readonly details: number;
+    readonly caption: number;
+    readonly percent: number;
+}
+/** The host keeps its conversation and details visible in both arrangements. */
+export interface DockGeometry {
+    readonly mode: 'columns' | 'rows';
+    readonly width: number;
+    readonly height: number;
+    readonly top: number;
+}
+/**
+ * Reserve a separate column, or a bottom row when two readable columns cannot fit.
+ * CSS pixels already account for browser zoom and Windows display scaling.
+ * @param viewport - measured host dimensions and the saved width preference.
+ * @returns panel dimensions within the host, excluding its native caption.
+ */
+export declare function resolveDockGeometry(viewport: DockViewport): DockGeometry;

package/lib/types/client/entries.d.ts

@@ -4,11 +4,12 @@
  * Entries run in registration order; the first claim wins and is allowed to
  * prevent the native context menu.
  */
-import type { ISessions, SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { CiteSelection } from './types.ts';
 /** Live browser facts an entry needs to resolve one selection. */
 export interface CiteCiterEntryContext {
-    readonly sessions: ISessions;
+    readonly readChat: (sessionId: SessionId) => ChatSnapshot | undefined;
     readonly sourceSessionId: SessionId;
 }
 /** One Citer entry point: probe, capture, and claim a selection from the DOM. */

package/lib/types/client/host-dock.d.ts

@@ -0,0 +1,18 @@
+/** Isolated, disposable layout adapter for DSH rc.1 and Desktop 2.0.5 frames. */
+import { type RefObject } from 'react';
+import { type DockGeometry } from './dock-geometry.ts';
+/**
+ * Locate the frame owning the public shell.overlay contribution.
+ * @param panel - mounted learning panel.
+ * @returns its immediate frame, or null before mounting.
+ */
+export declare function findContainingFrame(panel: HTMLElement | null): HTMLElement | null;
+/**
+ * Reserve host space without rewriting the host's saved columns or hiding details.
+ * Unknown frame structures receive no DOM changes. All owned styles disappear on close.
+ * @param panel - mounted panel reference.
+ * @param open - whether space should be reserved.
+ * @param percent - user's preferred fraction of the content viewport.
+ * @returns measured panel placement; null when the host frame is unsupported.
+ */
+export declare function useHostDock(panel: RefObject<HTMLElement | null>, open: boolean, percent: number): DockGeometry | null;

package/lib/types/client/reader-controller.d.ts

@@ -29,5 +29,5 @@ type RemoteRequest = (request: CiteCiterRequest, signal: AbortSignal) => Promise
 /** Initial Reader snapshot. */
 export declare function createInitialReaderSnapshot(): ReaderSnapshot;
 /** Bind the Reader store to the CiteCiter Remote and the companion Topic creator. */
-export declare function createReaderController(request: RemoteRequest, companion: CompanionFace, store?: import("@deepseek-ai/dsh-client-runtime/client").SnapshotStore<ReaderSnapshot>): ReaderFace;
+export declare function createReaderController(request: RemoteRequest, companion: CompanionFace, store?: import("@deepseek-ai/dsh-client-store").SnapshotStore<ReaderSnapshot>): ReaderFace;
 export {};

package/lib/types/client/selection.d.ts

@@ -1,4 +1,4 @@
-import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { CiteSelection } from './types.ts';
 /**
  * Resolve the current DOM selection into a CiteSelection.

package/lib/types/client/types.d.ts

@@ -1,4 +1,4 @@
-import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ToolEvidenceProjection } from '../evidence-text.ts';
 /** One right-click selection inside a rendered assistant model call. */
 export interface AssistantCiteSelection {

package/lib/types/client/update-controller.d.ts

@@ -1,10 +1,12 @@
-import { type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { CiteCiterSettings } from '../topic.ts';
 type UpdateStorage = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
 /** One newer package version returned by the validated Host check. */
 export interface AvailableUpdate {
     readonly currentVersion: string;
     readonly latestVersion: string;
+    readonly profile?: string;
 }
 /** Observable state shared by the update card and settings page. */
 export interface UpdateNoticeSnapshot {
@@ -52,6 +54,6 @@ export declare function createUpdateBrowserEnvironment(): UpdateBrowserEnvironme
  * @returns the root-scoped update controller.
  */
 export declare function createUpdateController(settings: SettingsScope<CiteCiterSettings>, checkUpdate: CheckUpdate, store: SnapshotStore<UpdateNoticeSnapshot>, environment?: UpdateBrowserEnvironment, reportCheckError?: (error: unknown) => void): UpdateController;
-/** @param version - validated latest package version. @returns the command shown and copied by the Web notice. */
-export declare function citeCiterUpdateCommand(version: string): string;
+/** @param version - validated latest package version. @param profile - active Desktop profile, or Web default. @returns the command shown and copied by the notice. */
+export declare function citeCiterUpdateCommand(version: string, profile?: string): string;
 export {};

package/lib/types/client/view-actions.d.ts

@@ -0,0 +1,26 @@
+/** Plain UI callbacks; subscriptions and disposal remain with the Client plugin. */
+import type { CompanionFace } from './companion-controller.ts';
+import type { ReaderFace } from './reader-controller.ts';
+import type { SettingsDocumentController } from './settings-document.ts';
+import type { CiteBus } from './types.ts';
+import type { UpdateController } from './update-controller.ts';
+/** Callbacks the Topic view may invoke. */
+export type CompanionActions = Omit<CompanionFace, 'getSnapshot' | 'subscribe' | 'dispose'>;
+/** Callbacks the document view may invoke. */
+export type ReaderActions = Omit<ReaderFace, 'getSnapshot' | 'subscribe' | 'dispose'>;
+/** Callbacks the settings view may invoke. */
+export type SettingsDocumentActions = Omit<SettingsDocumentController, 'getSnapshot' | 'subscribe' | 'dispose'>;
+/** Callbacks the update view may invoke. */
+export type UpdateActions = Omit<UpdateController, 'getSnapshot' | 'subscribe' | 'dispose'>;
+/** Overlay events used by rendered components. */
+export type OverlayActions = Pick<CiteBus, 'setMenuSelection' | 'setPanelOpen' | 'requestBoardCitation' | 'clearBoardCitation'>;
+/**
+ * Remove lifecycle and subscription methods from a plain controller's view props.
+ * @param controller - Client-owned controller with arrow-function callbacks.
+ * @returns callbacks separate from the observable supplied to inject.hooks.
+ */
+export declare function viewActions<T extends {
+    getSnapshot(): unknown;
+    subscribe(listener: () => void): () => void;
+    dispose(): Promise<void>;
+}>(controller: T): Omit<T, 'getSnapshot' | 'subscribe' | 'dispose'>;

package/lib/types/index.d.ts

@@ -9,7 +9,7 @@ export declare const name = "@kirkchinese/dsh-citeciter";
 /** Services required by the private Topic runtime. */
 export declare const inject: readonly ["llm", "sessionQuery", "subprocess"];
 /** Host settings identity shared with the browser settings scope. */
-export declare const CITECITER_SETTINGS_NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+export declare const CITECITER_SETTINGS_NS: "citeciter";
 /** Native settings schema for new Topics and the companion panel. */
 export declare const CITECITER_SETTINGS_SCHEMA: z<object>;
 /** Root-scoped Remote service owning one isolated DSH runtime. */