@kirkchinese/dsh-citeciter 0.8.2 → 0.9.0-alpha.1

package/lib/{typert-common-BMA9IB7p.js → typert-common-Q3dqDoUa.js}

@@ -1,4 +1,23 @@
-import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-BtuUBRbP.js";
+import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-BRpjPM2f.js";
+//#region lib/types/typert-codec.js
+/** Public Typert schema forms: 0.1.5 reads schema; 0.1.7 creates it lazily. Both refer to one schema. */
+function strictCodec(typeSymbol, schema) {
+	return {
+		mode: "strict",
+		typeSymbol,
+		schema,
+		create: () => schema
+	};
+}
+/** Publish the same named schema through both supported registry contracts. */
+function namedSchema(name, schema) {
+	return {
+		name,
+		schema,
+		create: () => schema
+	};
+}
+//#endregion
 //#region lib/types/typert-common.js
 /** Strict root-scoped Topic command shared by Host and browser manifests. */
 const citeCiterRequestDescriptor = {
@@ -11,18 +30,10 @@ const citeCiterRequestDescriptor = {
 		name: "rawRequest",
 		wire: "rawRequest",
 		source: "json",
-		codec: {
-			mode: "strict",
-			typeSymbol: "@kirkchinese/dsh-citeciter#CiteCiterRequest",
-			schema: citeCiterRequestSchema
-		}
+		codec: strictCodec("@kirkchinese/dsh-citeciter#CiteCiterRequest", citeCiterRequestSchema)
 	}],
 	cancellation: { parameter: "signal" },
-	result: {
-		mode: "strict",
-		typeSymbol: "@kirkchinese/dsh-citeciter#CiteCiterResponse",
-		schema: citeCiterResponseSchema
-	},
+	result: strictCodec("@kirkchinese/dsh-citeciter#CiteCiterResponse", citeCiterResponseSchema),
 	sourceLocation: {
 		file: "src/index.ts",
 		line: 127,
@@ -38,11 +49,7 @@ const updateCheckDescriptor = {
 	invocation: { kind: "direct" },
 	parameters: [],
 	cancellation: { parameter: "signal" },
-	result: {
-		mode: "strict",
-		typeSymbol: "@kirkchinese/dsh-citeciter#UpdateCheckResponse",
-		schema: updateCheckResponseSchema
-	},
+	result: strictCodec("@kirkchinese/dsh-citeciter#UpdateCheckResponse", updateCheckResponseSchema),
 	sourceLocation: {
 		file: "src/index.ts",
 		line: 134,
@@ -50,4 +57,4 @@ const updateCheckDescriptor = {
 	}
 };
 //#endregion
-export { updateCheckDescriptor as n, citeCiterRequestDescriptor as t };
+export { updateCheckDescriptor as n, namedSchema as r, citeCiterRequestDescriptor as t };

package/lib/typert.host.js

@@ -1,39 +1,18 @@
-import { C as topicSummarySchema, S as topicSnapshotSchema, f as citeCiterRequestSchema, l as citationDraftSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema, u as citationRecordSchema } from "./update-BtuUBRbP.js";
-import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-BMA9IB7p.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-BRpjPM2f.js";
+import { n as updateCheckDescriptor, r as namedSchema, t as citeCiterRequestDescriptor } from "./typert-common-Q3dqDoUa.js";
 //#region lib/types/typert.host.js
 /** Handwritten strict Host contribution matching the single Remote decorator. */
 const TYPERT = {
 	package: "@kirkchinese/dsh-citeciter",
 	face: "host",
 	schemas: [
-		{
-			name: "CitationDraft",
-			schema: citationDraftSchema
-		},
-		{
-			name: "CitationRecord",
-			schema: citationRecordSchema
-		},
-		{
-			name: "TopicSummary",
-			schema: topicSummarySchema
-		},
-		{
-			name: "TopicSnapshot",
-			schema: topicSnapshotSchema
-		},
-		{
-			name: "CiteCiterRequest",
-			schema: citeCiterRequestSchema
-		},
-		{
-			name: "CiteCiterResponse",
-			schema: citeCiterResponseSchema
-		},
-		{
-			name: "UpdateCheckResponse",
-			schema: updateCheckResponseSchema
-		}
+		namedSchema("CitationDraft", citationDraftSchema),
+		namedSchema("CitationRecord", citationRecordSchema),
+		namedSchema("TopicSummary", topicSummarySchema),
+		namedSchema("TopicSnapshot", topicSnapshotSchema),
+		namedSchema("CiteCiterRequest", citeCiterRequestSchema),
+		namedSchema("CiteCiterResponse", citeCiterResponseSchema),
+		namedSchema("UpdateCheckResponse", updateCheckResponseSchema)
 	],
 	model: {
 		services: [],

package/lib/typert.remote-client.js

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

package/lib/types/actions.d.ts

@@ -12,6 +12,10 @@ export declare const citeActionSchema: z.ZodObject<{
         side: "side";
         floating: "floating";
     }>;
+    target: z.ZodOptional<z.ZodEnum<{
+        current: "current";
+        new: "new";
+    }>>;
 }, z.core.$strict>;
 export type CiteAction = z.infer<typeof citeActionSchema>;
 export declare const wheelSlotsSchema: z.ZodArray<z.ZodNullable<z.ZodObject<{
@@ -26,6 +30,10 @@ export declare const wheelSlotsSchema: z.ZodArray<z.ZodNullable<z.ZodObject<{
         side: "side";
         floating: "floating";
     }>;
+    target: z.ZodOptional<z.ZodEnum<{
+        current: "current";
+        new: "new";
+    }>>;
 }, z.core.$strict>>>;
 export declare const wheelTriggerSchema: z.ZodEnum<{
     "right-button": "right-button";
@@ -43,5 +51,7 @@ export declare const actionModelSchema: z.ZodObject<{
 export type ActionModel = z.infer<typeof actionModelSchema>;
 /** Clockwise from twelve o'clock. Empty slots retain their positions. */
 export declare const DEFAULT_WHEEL_SLOTS: readonly (CiteAction | null)[];
+/** Preserve customized legacy slots; only the unchanged built-in free question gains append behavior. */
+export declare function actionTarget(action: CiteAction): 'current' | 'new';
 /** Combine a mode and optional user question without hidden system state. */
 export declare function actionQuestion(action: CiteAction, question: string): string;

package/lib/types/atomic-replace.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Atomically replace an owned file, tolerating brief Windows sharing conflicts.
+ * @param temporary - complete temporary file in the destination directory.
+ * @param destination - ownership-validated target; callers serialize its writes.
+ * @throws The last filesystem error after at most 620ms of retry delays. Other
+ * errors and non-Windows failures propagate immediately. Neither file is deleted
+ * here; callers retain responsibility for temporary-file cleanup.
+ */
+export declare function atomicReplace(temporary: string, destination: string): Promise<void>;

package/lib/types/board-capture-protocol.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+/** Immutable board revision requested by one real model tool call, independent of UI selection. */
+export declare const boardCaptureJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    board: z.ZodObject<{
+        version: z.ZodLiteral<4>;
+        revision: z.ZodNumber;
+        elements: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                text: "text";
+                image: "image";
+                markdown: "markdown";
+                math: "math";
+                svg: "svg";
+                html: "html";
+                table: "table";
+            }>;
+            content: z.ZodString;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+            style: z.ZodObject<{
+                color: z.ZodOptional<z.ZodString>;
+                fontSize: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            focused: z.ZodBoolean;
+            animation: z.ZodOptional<z.ZodObject<{
+                name: z.ZodEnum<{
+                    "fade-in": "fade-in";
+                    "slide-in": "slide-in";
+                    pulse: "pulse";
+                    highlight: "highlight";
+                }>;
+                durationMs: z.ZodNumber;
+                iterations: z.ZodNumber;
+                run: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        invalid: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type BoardCaptureJob = z.infer<typeof boardCaptureJobSchema>;

package/lib/types/board-capture.d.ts

@@ -1,11 +1,16 @@
 import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { BoardSnapshot } from './board.ts';
+import type { BoardCaptureJob } from './board-capture-protocol.ts';
 /** Correlates one model-requested render with one client reply; bytes become a durable DSH attachment. */
 export declare class BoardCaptureBroker {
     private readonly pending;
     id(sessionId: string): string | undefined;
+    /** Only live capture requests are advertised; polling does not load or resume other Topics. */
+    jobs(): BoardCaptureJob[];
     reply(sessionId: string, id: string, png?: string, error?: string): void;
     dispose(): void;
     private capture;
     /** Tool returns the browser-rendered board image inside the current turn; it never starts another prompt. */
-    tool(ctx: Context): import("@deepseek-ai/dsh-tools").ToolDefinition;
+    tool(ctx: Context, readBoard: (agent: Agent) => BoardSnapshot): import("@deepseek-ai/dsh-tools").ToolDefinition;
 }

package/lib/types/board.d.ts

@@ -10,8 +10,8 @@ export declare const BOARD_MAX_ELEMENTS = 50;
 export declare const BOARD_MAX_CONTENT_BYTES = 500000;
 /** Element kinds the blackboard renders safely on the chalk canvas. */
 export declare const boardElementKindSchema: z.ZodEnum<{
-    image: "image";
     text: "text";
+    image: "image";
     markdown: "markdown";
     math: "math";
     svg: "svg";
@@ -32,8 +32,8 @@ export declare const boardOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     op: z.ZodLiteral<"set">;
     id: z.ZodString;
     kind: z.ZodEnum<{
-        image: "image";
         text: "text";
+        image: "image";
         markdown: "markdown";
         math: "math";
         svg: "svg";
@@ -93,8 +93,8 @@ export declare const boardBatchSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.Zod
     op: z.ZodLiteral<"set">;
     id: z.ZodString;
     kind: z.ZodEnum<{
-        image: "image";
         text: "text";
+        image: "image";
         markdown: "markdown";
         math: "math";
         svg: "svg";
@@ -185,8 +185,8 @@ export declare const boardSnapshotSchema: z.ZodObject<{
     elements: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
-            image: "image";
             text: "text";
+            image: "image";
             markdown: "markdown";
             math: "math";
             svg: "svg";

package/lib/types/citer-agent-registry.d.ts

@@ -8,8 +8,8 @@ export declare class CiterAgentRegistry extends AgentRegistry {
         readonly registry: AgentRegistry;
     });
     enter(agent: Agent, owner: Agent | undefined): () => void;
-    announce(agent: Agent): void;
-    register(agent: Agent): () => void;
+    announce(...args: Parameters<AgentRegistry['announce']>): ReturnType<AgentRegistry['announce']>;
+    register(agent: Agent): ReturnType<AgentRegistry['register']>;
     get(id: SessionId): Agent | undefined;
     list(): Agent[];
     roots(): Agent[];

package/lib/types/citer-session-access.d.ts

@@ -1,7 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type SessionStore from '@deepseek-ai/dsh-session';
 import type { Session } from '@deepseek-ai/dsh-session';
-/** Bridge native checkpoints and identity lookups to owned stores without adding their members to Host enumeration. */
+/** Route durability checkpoints to owned stores without publishing Topic identities in the Host store. */
 export declare class CiterSessionAccess {
     private readonly owners;
     /** Install one reversible adapter for this plugin's lifetime. No Host files or Agent Loop methods change. */

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

@@ -34,14 +34,13 @@ export interface ActionSnapshot {
         readonly x: number;
         readonly y: number;
     } | null;
-    question: string;
     submitting: boolean;
     error: string | null;
     model: ActionModel | undefined;
 }
 /** Direction around the actual displayed centre; no action inside the dead zone or outside the wheel. */
 export declare function wheelSector(dx: number, dy: number): number | null;
-/** Controller owns duplicate submission, retry drafts and source-change cancellation. Dispose with the Client. */
+/** Prepare a draft through the action's destination policy; the Topic composer owns input and submission. */
 export declare function createActionController(execute: (source: ActionSource, action: CiteAction, question: string, model?: ActionModel) => Promise<void>, defaultModel?: () => ActionModel | undefined): {
     getSnapshot: () => ActionSnapshot;
     subscribe: (fn: () => void) => () => void;
@@ -49,13 +48,11 @@ export declare function createActionController(execute: (source: ActionSource, a
     move(x: number, y: number): void;
     focus(index: number): void;
     release(quick: boolean): void;
-    /** Cancel only the transient gesture; a question draft belongs to its explicit close/source lifecycle. */
+    /** Focus loss cancels only the transient gesture; the Topic composer retains its draft. */
     dismissWheel(): void;
     choose: (index: number | null) => void;
     cancel: () => void;
     submit: () => Promise<void>;
-    setModel(model: ActionModel | undefined): void;
-    setQuestion(question: string): void;
     dispose(): Promise<void>;
 };
 export type ActionController = ReturnType<typeof createActionController>;

package/lib/types/client/action-executor.d.ts

@@ -1,4 +1,4 @@
-import type { CiteAction, ActionModel, PanelPresentation } from '../actions.ts';
+import { type CiteAction, type ActionModel, type PanelPresentation } from '../actions.ts';
 import { type ActionSource } from './action-controller.ts';
 import type { CompanionFace } from './companion-controller.ts';
 import type { ReaderFace } from './reader-controller.ts';

package/lib/types/client/board-capture-controller.d.ts

@@ -0,0 +1,17 @@
+import type { BoardCaptureJob } from '../board-capture-protocol.ts';
+import type { CiteCiterRequest, CiteCiterResponse } from '../topic.ts';
+export interface BoardCaptureSnapshot {
+    jobs: readonly BoardCaptureJob[];
+}
+/**
+ * Poll only model-requested board renders, independently of navigation or visible Topics.
+ * @param request - authenticated root-scoped Citer transport; no Session activation is needed.
+ * @param report - report transport failures once until connectivity recovers.
+ * @returns render store and stable reply callback; dispose aborts RPCs and removes the poll timer.
+ */
+export declare function createBoardCaptureController(request: (request: CiteCiterRequest, signal: AbortSignal) => Promise<CiteCiterResponse>, report: (error: unknown) => void): {
+    getSnapshot: () => BoardCaptureSnapshot;
+    subscribe: (fn: () => void) => () => void;
+    reply: (sessionId: string, id: string, png?: string, error?: string) => Promise<void>;
+    dispose: () => void;
+};

package/lib/types/client/citer-session-face.d.ts

@@ -1,7 +1,20 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionFace, SessionSnapshot } from '@deepseek-ai/dsh-api-session-controller/client';
 import { type SessionId } from '@deepseek-ai/dsh-session/types';
+import type { MessageId } from '@deepseek-ai/dsh-llm';
 import type { SessionRequestId } from '@deepseek-ai/dsh-api-session-controller/types';
+import type { NativeState } from '../native-session-contract.ts';
+/** Native control state plus Citer's read-only view of the authoritative inbox. */
+export interface CiterSessionSnapshot extends SessionSnapshot {
+    readonly modelSelectionRequired?: boolean;
+    readonly queue: readonly (NativeState['queue'][number] & {
+        id: MessageId;
+        messageId: MessageId;
+        rpcId?: SessionRequestId;
+        content: import('@deepseek-ai/dsh-llm').ContentBlock[];
+        preview: string;
+    })[];
+}
 type Submission = Parameters<SessionFace['beginSubmission']>[0];
 /** Own the published SessionFace contract for Citer navigation. Sending, uploads and inbox mutations remain native DSH operations. */
 export declare class CiterSessionFace implements SessionFace {
@@ -17,8 +30,11 @@ export declare class CiterSessionFace implements SessionFace {
     private observers;
     private timer;
     private refreshing;
+    private nextRequestId;
+    /** Use the draft's durable identity for this explicit send, including retries after restart. */
+    prepareSubmission(requestId: string): void;
     constructor(ctx: Context, sessionId: SessionId);
-    getSnapshot: () => SessionSnapshot;
+    getSnapshot: () => CiterSessionSnapshot;
     subscribe: (listener: () => void) => (() => void);
     /** Establish ownership and obtain a real baseline before accepting composer work. */
     ready(): Promise<void>;

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

@@ -1,7 +1,7 @@
 import type { NativeComposer, DeliveryMode } from './native-composer.ts';
 import type { DraftAttachmentId } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SettingsForm } from './host-ui-adapter.ts';
 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';
@@ -9,16 +9,19 @@ import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings,
 import { type CreateMode, type DocumentClaimIntent } from './request-guard.ts';
 import type { ActionModel } from '../actions.ts';
 import type { CiteSelection } from './types.ts';
+import { type DraftReference } from './draft-references.ts';
 export type CompanionPhase = 'idle' | 'creating' | 'ready' | 'running' | 'stopping' | 'stopped' | 'error';
 export type { CreateMode } from './request-guard.ts';
 export type TopicsStatus = 'idle' | 'loading' | 'ready' | 'error';
 export type SettingsSaveStatus = 'idle' | 'saving' | 'saved' | 'error';
+export interface ComposeSeed {
+    readonly sessionId: string;
+    readonly question: string;
+    readonly id: string;
+    readonly references: readonly DraftReference[];
+}
 export interface CompanionSnapshot {
-    composeSeed: {
-        readonly sessionId: string;
-        readonly question: string;
-        readonly id: string;
-    } | null;
+    composeSeeds: readonly ComposeSeed[];
     sourceSessionId: SessionId | null;
     phase: CompanionPhase;
     draftQuote: string | null;
@@ -51,11 +54,16 @@ export interface CompanionFace {
     /** Create a Reading Topic; rejects on failure so the Reader retains the unsent question. */
     createFromDocument(claim: DocumentClaimIntent, question: string, sourceSessionId?: SessionId, modelRoute?: ActionModel): Promise<void>;
     openTopic(sessionId: string): Promise<void>;
-    ask(question: string, attachments?: readonly DraftAttachmentId[], mode?: DeliveryMode): Promise<boolean>;
+    /** Resolve only the explicitly selected, unarchived Topic; null means create a new one. */
+    resolveDraftTopic(sourceSessionId: SessionId): Promise<string | null>;
+    /** Append to the exact still-selected Topic; never change its route, permissions or running turn. */
+    appendSelection(sourceSessionId: SessionId, topicSessionId: string, question: string, references: readonly DraftReference[]): void;
+    /** Acknowledge a draft event only after its UI consumer accepted it. */
+    consumeComposeSeed(id: string): void;
+    ask(question: string, attachments?: readonly DraftAttachmentId[], mode?: DeliveryMode, requestId?: string, expectedSessionId?: string): Promise<boolean>;
     setPermission(mode: NonNullable<CiteCiterSettings['defaultPermission']>): Promise<void>;
     answerQuestion(key: string, answer: QuestionAnswer): Promise<void>;
     cancelQuestion(key: string): Promise<void>;
-    boardCaptureReply(sessionId: string, id: string, png?: string, error?: string): Promise<void>;
     stop(): Promise<void>;
     rename(title: string): Promise<boolean>;
     archive(archived: boolean): Promise<boolean>;
@@ -70,4 +78,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(readChat: (sessionId: SessionId) => ChatSnapshot | undefined, settingsScope: SettingsScope<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>, nativeComposer: NativeComposer): CompanionFace;
+export declare function createCompanionController(readChat: (sessionId: SessionId) => ChatSnapshot | undefined, configForms: SettingsForm<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>, nativeComposer: NativeComposer): CompanionFace;

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

@@ -1,12 +1,10 @@
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
 import { type ActionController, type ActionSnapshot } from '../action-controller.ts';
 import type { CompanionActions } from '../view-actions.ts';
-import type { CompanionSnapshot } from '../companion-controller.ts';
 export type ActionCallbacks = Omit<ActionController, 'getSnapshot' | 'subscribe' | 'dispose'>;
-/** Public shell overlay: wheel, input prompt and visible retry. Business work stays in its controller. */
-export declare function ActionWheel({ useActions, useCompanion, actions, companion }: {
+/** Public wheel and creation-error retry. Questions and models are edited only in the Topic composer. */
+export declare function ActionWheel({ useActions, actions, companion }: {
     useActions: SnapshotSelectorHook<ActionSnapshot>;
-    useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
     actions: ActionCallbacks;
     companion: CompanionActions;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { BoardCaptureSnapshot, createBoardCaptureController } from '../board-capture-controller.ts';
+/** Root-owned render workers survive panel close, Topic changes and source navigation. */
+export declare function BoardCaptureWorker({ useCapture, reply }: {
+    readonly useCapture: SnapshotSelectorHook<BoardCaptureSnapshot>;
+    readonly reply: ReturnType<typeof createBoardCaptureController>['reply'];
+}): import("react").JSX.Element;

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

@@ -1,14 +1,17 @@
 import type { NativeComposer, DeliveryMode } from '../native-composer.ts';
-import type { UseSessionPendingInteraction } from '@deepseek-ai/dsh-client-ui-session/client';
+import { type DraftController, type DraftSnapshot } from '../draft-controller.ts';
+import type { InteractionSnapshot } from '../host-ui-adapter.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 drafts: Omit<DraftController, 'getSnapshot' | 'subscribe' | 'dispose'>;
+    readonly useDrafts: SnapshotSelectorHook<DraftSnapshot>;
     readonly nativeComposer: NativeComposer;
     readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
     readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
-    readonly useInteractions: UseSessionPendingInteraction;
+    readonly useInteractions: SnapshotSelectorHook<InteractionSnapshot>;
     readonly useSubmission: SnapshotSelectorHook<DeliveryMode>;
     readonly bus: OverlayActions;
     readonly companion: CompanionActions;
@@ -21,4 +24,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({ nativeComposer, useCompanion, useOverlay, useInteractions, useSubmission, bus, companion, closePanel, openReader, reportParseError }: CitePanelProps): import("react").JSX.Element | null;
+export declare function CitePanel({ nativeComposer, drafts, useDrafts, useCompanion, useOverlay, useInteractions, useSubmission, bus, companion, closePanel, openReader, reportParseError }: CitePanelProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,5 @@
+import type { LearningExample as Example } from '../../learning-example.ts';
+/** Render the explicit example kind; even HTML/SVG source stays literal code. */
+export declare function LearningExample({ example }: {
+    readonly example: Example;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { NativeComposer } from '../native-composer.ts';
+import type { MessageAttachment } from './MessageAttachments.tsx';
+/** Own an authorized image URL and its preview for exactly one mounted attachment. */
+export declare function MessageImage({ sessionId, attachment, load }: {
+    readonly sessionId: string;
+    readonly attachment: MessageAttachment;
+    readonly load: NativeComposer['attachment'];
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { TopicMessage } from '../../topic.ts';
+import type { NativeComposer } from '../native-composer.ts';
+/** Show returned files immediately while keeping diagnostic arguments and results collapsible. */
+export declare function ToolRow({ message, sessionId, load }: {
+    readonly message: Extract<TopicMessage, {
+        role: 'tool';
+    }>;
+    readonly sessionId: string;
+    readonly load: NativeComposer['attachment'];
+}): import("react").JSX.Element;

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

@@ -3,15 +3,12 @@ import type { ProviderOption, TopicModelConfig } from '../../topic.ts';
 import type { CompanionPhase } from '../companion-controller.ts';
 import { type PermissionMode } from './PermissionControl.tsx';
 import type { DeliveryMode } from '../native-composer.ts';
-import type { DraftReference } from '../draft-references.ts';
 /**
  * Render the Topic draft and its submission controls without accessing services.
  * @param props - controlled draft, model route, request state and user-action callbacks.
  * @returns one form; model changes and sending remain owned by the Topic controller.
  */
-export declare function TopicComposer({ question, placeholder, route, providers, phase, canSend, routeSaving, folded, inputRef, onExpand, onQuestion, onSubmit, onStop, onModel, onReasoning, attachments, permission, onPermission, onFiles, delivery, onDelivery, sources, onReference }: {
-    readonly sources: readonly DraftReference[];
-    readonly onReference: (reference: DraftReference) => void;
+export declare function TopicComposer({ question, placeholder, route, providers, phase, canSend, routeSaving, folded, inputRef, onExpand, onQuestion, onSubmit, onStop, onModel, onReasoning, attachments, permission, onPermission, onFiles, delivery, onDelivery }: {
     readonly permission: PermissionMode;
     readonly onPermission: (mode: PermissionMode) => void;
     readonly onFiles: (files: readonly File[]) => void;

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

@@ -6,10 +6,12 @@ export interface DockViewport {
     readonly details: number;
     readonly caption: number;
     readonly percent: number;
+    /** Explicit Citer navigation may temporarily take the compact page from details. */
+    readonly preferDetails?: boolean;
 }
-/** Wide windows reserve a column; compact windows navigate to a Citer page. */
+/** Wide windows reserve a column; compact details take priority unless Citer was explicitly selected. */
 export interface DockGeometry {
-    readonly mode: 'columns' | 'page';
+    readonly mode: 'columns' | 'page' | 'suspended';
     readonly width: number;
     readonly height: number;
     readonly top: number;

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

@@ -0,0 +1,45 @@
+import type { ComposerAttachment } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { CiteCiterRequest, CiteCiterResponse } from '../topic.ts';
+import { type DraftContent, type DraftFile } from '../draft-contract.ts';
+import { type DraftReference } from './draft-references.ts';
+import type { NativeComposer } from './native-composer.ts';
+export interface DraftView {
+    readonly content: DraftContent;
+    readonly files: readonly ComposerAttachment[];
+    readonly missing: readonly DraftFile[];
+    readonly ready: boolean;
+    readonly saving: boolean;
+    readonly sending: boolean;
+    readonly conflict: boolean;
+    readonly pending: boolean;
+    readonly error: string | null;
+}
+export type DraftSnapshot = Readonly<Record<string, DraftView>>;
+export declare const EMPTY_DRAFT_VIEW: DraftView;
+type Request = (request: CiteCiterRequest) => Promise<CiteCiterResponse>;
+/** Own draft persistence and attachment lifetimes independently of panel mounting and Topic navigation. */
+export declare function createDraftController(request: Request, native: NativeComposer): {
+    getSnapshot: () => Readonly<Record<string, DraftView>>;
+    subscribe: (listener: () => void) => () => void;
+    /** Pending receipts are already durable; only unflushed local edits need a navigation warning. */
+    hasUnsavedChanges: () => boolean;
+    flushAll: () => Promise<PromiseSettledResult<void>[]>;
+    ensure: (id: string) => Promise<void>;
+    flush: (id: string) => Promise<void>;
+    setText: (id: string, text: string) => Promise<void>;
+    append: (id: string, text: string, references: readonly DraftReference[]) => Promise<void>;
+    removeReference: (id: string, referenceId: string) => Promise<void>;
+    addFiles: (id: string, files: readonly File[]) => Promise<void>;
+    removeFile: (id: string, fileId: string) => Promise<void>;
+    /** Persist the exact outgoing snapshot and identity before native submission begins. */
+    submit: (id: string, send: (content: DraftContent, files: readonly ComposerAttachment[], requestId: string) => Promise<boolean>, retry?: boolean) => Promise<boolean>;
+    reload: (id: string) => Promise<void>;
+    /** Check a lost send response without replacing edits made while the check is in flight. */
+    reconcile: (id: string) => Promise<void>;
+    /** Explicit conflict resolution: restore locally retained bytes removed by a peer, then CAS the latest revision. */
+    keepLocal: (id: string) => Promise<void>;
+    forget: (id: string) => void;
+    dispose: () => Promise<void>;
+};
+export type DraftController = ReturnType<typeof createDraftController>;
+export {};

package/lib/types/client/draft-references.d.ts

@@ -1,12 +1,9 @@
 import type { TopicSummary } from '../topic.ts';
+import type { DraftContent } from '../draft-contract.ts';
 /** One unsent model-visible reference. Removing this value removes its serialized content. */
-export interface DraftReference {
-    readonly id: string;
-    readonly kind: 'source' | 'excerpt' | 'board';
-    readonly label: string;
-    readonly content: string;
-    readonly address?: string;
-}
+export type DraftReference = DraftContent['references'][number];
+/** Append real references once per unsent draft. A later explicit selection can restore a removed item. */
+export declare function mergeDraftReferences(current: readonly DraftReference[], incoming: readonly DraftReference[]): readonly DraftReference[];
 /** Build initial references without submitting them. Stable Topic-scoped IDs preserve menu focus during live snapshot refreshes. */
 export declare function topicDraftReferences(topic: TopicSummary, documentTitle?: string): readonly DraftReference[];
 /** Display a document filename while retaining the full title/path in its serialized content. Legacy ID-only references keep their generic label. */