@kirkchinese/dsh-citeciter 0.6.0 → 0.8.1

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

@@ -1,4 +1,4 @@
-import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-C0K5ekMg.js";
+import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-0LcFDvI5.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-C0K5ekMg.js";
-import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-C6yTitXx.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-0LcFDvI5.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DxE1_Bn_.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-C6yTitXx.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DxE1_Bn_.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

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/** One persisted wheel slot; its prompt is sent as a durable user message. */
+export declare const citeActionSchema: z.ZodObject<{
+    label: z.ZodString;
+    prompt: z.ZodString;
+    ask: z.ZodBoolean;
+    scenario: z.ZodEnum<{
+        qa: "qa";
+        present: "present";
+    }>;
+    presentation: z.ZodEnum<{
+        side: "side";
+        floating: "floating";
+    }>;
+}, z.core.$strict>;
+export type CiteAction = z.infer<typeof citeActionSchema>;
+export declare const wheelSlotsSchema: z.ZodArray<z.ZodNullable<z.ZodObject<{
+    label: z.ZodString;
+    prompt: z.ZodString;
+    ask: z.ZodBoolean;
+    scenario: z.ZodEnum<{
+        qa: "qa";
+        present: "present";
+    }>;
+    presentation: z.ZodEnum<{
+        side: "side";
+        floating: "floating";
+    }>;
+}, z.core.$strict>>>;
+export declare const wheelTriggerSchema: z.ZodEnum<{
+    "right-button": "right-button";
+    Alt: "Alt";
+    Control: "Control";
+    Shift: "Shift";
+    Meta: "Meta";
+}>;
+export type WheelTrigger = z.infer<typeof wheelTriggerSchema>;
+export type PanelPresentation = CiteAction['presentation'];
+export declare const actionModelSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+}, z.core.$strict>;
+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)[];
+/** Combine a mode and optional user question without hidden system state. */
+export declare function actionQuestion(action: CiteAction, question: string): string;

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

@@ -0,0 +1,11 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** 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;
+    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;
+}

package/lib/types/board.d.ts

@@ -10,12 +10,12 @@ 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";
     markdown: "markdown";
     math: "math";
     svg: "svg";
     html: "html";
-    image: "image";
     table: "table";
 }>;
 export type BoardElementKind = z.infer<typeof boardElementKindSchema>;
@@ -32,12 +32,12 @@ export declare const boardOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     op: z.ZodLiteral<"set">;
     id: z.ZodString;
     kind: z.ZodEnum<{
+        image: "image";
         text: "text";
         markdown: "markdown";
         math: "math";
         svg: "svg";
         html: "html";
-        image: "image";
         table: "table";
     }>;
     content: z.ZodString;
@@ -93,12 +93,12 @@ export declare const boardBatchSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.Zod
     op: z.ZodLiteral<"set">;
     id: z.ZodString;
     kind: z.ZodEnum<{
+        image: "image";
         text: "text";
         markdown: "markdown";
         math: "math";
         svg: "svg";
         html: "html";
-        image: "image";
         table: "table";
     }>;
     content: z.ZodString;
@@ -185,12 +185,12 @@ export declare const boardSnapshotSchema: z.ZodObject<{
     elements: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
+            image: "image";
             text: "text";
             markdown: "markdown";
             math: "math";
             svg: "svg";
             html: "html";
-            image: "image";
             table: "table";
         }>;
         content: z.ZodString;

package/lib/types/citation-mapping.d.ts

@@ -13,5 +13,13 @@ export interface ResolvedCitationRange {
     readonly prefixText: string;
     readonly suffixText: string;
 }
+/**
+ * Locate a literal textarea selection in authoritative document source text.
+ * @param selection - raw selected text and page-local surrounding context.
+ * @param content - complete normalized document; offsets use UTF-16 code units.
+ * @returns the unique best exact match, retaining Markdown and code punctuation.
+ * @throws when the quote is absent or repeated context cannot disambiguate it.
+ */
+export declare function resolveDocumentRange(selection: CitationTextSelection, content: string): ResolvedCitationRange;
 /** Resolve rendered selection context against authoritative Markdown source. */
 export declare function resolveCitationRange(selection: CitationTextSelection, answer: string): ResolvedCitationRange;

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

@@ -0,0 +1,21 @@
+import type { Context } from '@deepseek-ai/cordis';
+import AgentRegistry, { type Agent } from '@deepseek-ai/dsh-agent';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+/** Own a separate factory while publishing live identities through DSH's public registry for its conversation, upload and queue APIs. */
+export declare class CiterAgentRegistry extends AgentRegistry {
+    private readonly options;
+    constructor(ctx: Context, options: {
+        readonly registry: AgentRegistry;
+    });
+    enter(agent: Agent, owner: Agent | undefined): () => void;
+    announce(agent: Agent): void;
+    register(agent: Agent): () => void;
+    get(id: SessionId): Agent | undefined;
+    list(): Agent[];
+    roots(): Agent[];
+    isOwnedBy(id: SessionId, owner: Agent): boolean;
+    currentInitiator(): Agent | undefined;
+    requireInitiator(): Agent;
+    withInitiator<T>(agent: Agent, operation: () => T): T;
+    withoutInitiator<T>(operation: () => T): T;
+}

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

@@ -0,0 +1,11 @@
+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. */
+export declare class CiterSessionAccess {
+    private readonly owners;
+    /** Install one reversible adapter for this plugin's lifetime. No Host files or Agent Loop methods change. */
+    constructor(ctx: Context, drain: () => Promise<void>);
+    /** Register after native enter; unregister after native detach, including failed publication. */
+    enter(session: Session, store: SessionStore): () => void;
+}

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

@@ -0,0 +1,7 @@
+import { Context } from '@deepseek-ai/cordis';
+import type SessionStore from '@deepseek-ai/dsh-session';
+import type { CiterSessionAccess } from './citer-session-access.ts';
+/** Own live Topic membership without advertising it as a root Host conversation. */
+export declare function createCiterSessionStore(Base: typeof SessionStore, access: CiterSessionAccess): new (ctx: Context, fallback: {
+    readonly store: SessionStore;
+}) => SessionStore;

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

@@ -0,0 +1,21 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { AgentHandle } from '@deepseek-ai/dsh-agent';
+import type { CiterSessionAccess } from './citer-session-access.ts';
+/** A Topic-owned DSH factory and JSONL backend; live conversation APIs stay shared, disk ownership does not. */
+export declare class CiterSessionWorld {
+    private fiber;
+    private readonly started;
+    private disposal;
+    private readonly handles;
+    private release;
+    private closing;
+    /** @param host - owning plugin context. @param root - verified Topic-owned JSONL directory. */
+    constructor(host: Context, root: string, access: CiterSessionAccess);
+    /** Wait for the isolated factory before creating or restoring a Topic. */
+    context(): Promise<Context>;
+    /** Retain the native handle so Agents settle while their persistence listeners are still mounted. */
+    own(handle: AgentHandle): Promise<AgentHandle>;
+    private start;
+    /** Stop and drain all factory-owned Agents before the caller can delete this Topic's files. */
+    dispose(): Promise<void>;
+}

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

@@ -0,0 +1,61 @@
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { type ActionModel, type CiteAction } from '../actions.ts';
+import type { CiteSelection } from './types.ts';
+/** Immutable capture from a conversation, imported document or native file preview. */
+export type ActionSource = {
+    readonly kind: 'conversation';
+    readonly selection: CiteSelection;
+} | {
+    readonly kind: 'document';
+    readonly sourceSessionId: SessionId;
+    readonly displayText: string;
+    readonly prefixText: string;
+    readonly suffixText: string;
+    readonly title: string;
+    readonly documentId?: string;
+    readonly content?: string;
+};
+export declare const actionSourceSession: (source: ActionSource) => SessionId;
+export declare const actionSourceQuote: (source: ActionSource) => string;
+export interface WheelSnapshot {
+    readonly source: ActionSource;
+    readonly x: number;
+    readonly y: number;
+    readonly active: number | null;
+    readonly slots: readonly (CiteAction | null)[];
+    readonly held: boolean;
+    readonly scale: number;
+}
+export interface ActionSnapshot {
+    wheel: WheelSnapshot | null;
+    pending: {
+        readonly source: ActionSource;
+        readonly action: CiteAction;
+        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. */
+export declare function createActionController(execute: (source: ActionSource, action: CiteAction, question: string, model?: ActionModel) => Promise<void>, defaultModel?: () => ActionModel | undefined): {
+    getSnapshot: () => ActionSnapshot;
+    subscribe: (fn: () => void) => () => void;
+    open(source: ActionSource, x: number, y: number, slots: readonly (CiteAction | null)[], held: boolean): void;
+    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. */
+    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

@@ -0,0 +1,6 @@
+import type { CiteAction, ActionModel, 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';
+/** Bind explicit Topic and document services. No UI, global listeners or Cordis discovery. */
+export declare function createActionExecutor(companion: CompanionFace, reader: ReaderFace, open: (presentation: PanelPresentation) => void): (source: ActionSource, action: CiteAction, question: string, modelRoute?: ActionModel) => Promise<void>;

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

@@ -0,0 +1,8 @@
+/**
+ * Find the rendered board for one exact capture address.
+ * @param sessionId - owning Citer Session identity.
+ * @param revision - requested board revision.
+ * @param fallback - offscreen capture root, excluded from visible candidates.
+ * @returns a painted, viewport-intersecting board, or undefined to use the fallback renderer.
+ */
+export declare function findVisibleCaptureBoard(sessionId: string, revision: number, fallback: HTMLElement): HTMLElement | undefined;

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

@@ -0,0 +1,59 @@
+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 { SessionRequestId } from '@deepseek-ai/dsh-api-session-controller/types';
+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 {
+    private readonly ctx;
+    readonly sessionId: SessionId;
+    private readonly store;
+    private readonly pending;
+    private readonly lifetime;
+    private readonly emptyProjection;
+    readonly projections: {
+        faceOf: (_key: string) => import("@deepseek-ai/dsh-client-store").SnapshotStore<unknown>;
+    };
+    private observers;
+    private timer;
+    private refreshing;
+    constructor(ctx: Context, sessionId: SessionId);
+    getSnapshot: () => SessionSnapshot;
+    subscribe: (listener: () => void) => (() => void);
+    /** Establish ownership and obtain a real baseline before accepting composer work. */
+    ready(): Promise<void>;
+    private patch;
+    private retire;
+    beginSubmission(input: Submission): {
+        requestId: SessionRequestId;
+        abandon: () => void;
+    };
+    prompt: SessionFace['prompt'];
+    /** Generic Citer attachment read; the installed SessionFace verb only supports images. */
+    readCiterAttachment: (attachmentId: string) => Promise<{
+        readonly ok: false;
+        readonly error: import("@deepseek-ai/dsh-typert-protocol").RemoteFailure;
+    } | {
+        ok: true;
+        value: {
+            attachment: import("@deepseek-ai/dsh-attachment").ImageAttachmentRef | {
+                attachmentId: import("@deepseek-ai/dsh-attachment").AttachmentId;
+                name: string;
+                bytes: number;
+            };
+            data: Uint8Array<ArrayBuffer>;
+        };
+    }>;
+    readAttachment: SessionFace['readAttachment'];
+    updateQueue: SessionFace['updateQueue'];
+    cancel: SessionFace['cancel'];
+    rename: SessionFace['rename'];
+    command: SessionFace['command'];
+    loadOlder: () => Promise<void>;
+    loadThrough: () => Promise<void>;
+    private schedule;
+    private refresh;
+    /** Stop polling and settle each owned submission exactly once when its plugin closes. */
+    dispose(): void;
+}
+export {};

package/lib/types/client/compact-navigation.d.ts

@@ -0,0 +1,3 @@
+import { type RefObject } from 'react';
+/** Suspend only covered host panes while Citer occupies the compact content page; restore their focusability on return. */
+export declare function useCompactNavigation(panel: RefObject<HTMLElement | null>, active: boolean): void;

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

@@ -1,3 +1,5 @@
+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 { SnapshotStore } from '@deepseek-ai/dsh-client-store';
@@ -5,12 +7,18 @@ 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';
+import type { ActionModel } from '../actions.ts';
 import type { CiteSelection } from './types.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 CompanionSnapshot {
+    composeSeed: {
+        readonly sessionId: string;
+        readonly question: string;
+        readonly id: string;
+    } | null;
     sourceSessionId: SessionId | null;
     phase: CompanionPhase;
     draftQuote: string | null;
@@ -38,13 +46,16 @@ export interface CompanionFace {
     subscribe(listener: () => void): () => void;
     setSource(sessionId: SessionId | null): void;
     retainVisible(): () => void;
-    create(selection: CiteSelection, question: string, mode?: CreateMode, scenario?: TopicScenario): Promise<void>;
+    create(selection: CiteSelection, question: string, mode?: CreateMode, scenario?: TopicScenario, modelRoute?: ActionModel): Promise<void>;
     createFree(question: string, scenario: Extract<TopicScenario, 'qa' | 'present'>): Promise<boolean>;
-    createFromDocument(claim: DocumentClaimIntent, question: string): Promise<void>;
+    /** 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): Promise<boolean>;
+    ask(question: string, attachments?: readonly DraftAttachmentId[], mode?: DeliveryMode): 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>;
@@ -59,4 +70,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>): CompanionFace;
+export declare function createCompanionController(readChat: (sessionId: SessionId) => ChatSnapshot | undefined, settingsScope: SettingsScope<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>, nativeComposer: NativeComposer): CompanionFace;

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

@@ -0,0 +1,12 @@
+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 }: {
+    useActions: SnapshotSelectorHook<ActionSnapshot>;
+    useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    actions: ActionCallbacks;
+    companion: CompanionActions;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { BoardSnapshot } from '../../board.ts';
+/** Reuses the exact board renderer when its visible tab is closed; no synthetic drawing or extra conversation is created. */
+export declare function BoardCaptureSurface({ id, sessionId, board, reply }: {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly board: BoardSnapshot | undefined;
+    readonly reply: (sessionId: string, id: string, png?: string, error?: string) => Promise<void>;
+}): import("react").JSX.Element;

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

@@ -1,12 +1,14 @@
 import 'katex/dist/katex.min.css';
 import { type BoardElementState, type BoardSnapshot } from '../../board.ts';
 /**
- * Render one final-state blackboard projection in the main conversation workspace.
- * @param props - board snapshot, motion preference, and optional citation action.
+ * Render one final-state blackboard projection in either learning surface.
+ * @param props - snapshot, motion preference, optional compact reading mode and citation action.
  * @returns the safe blackboard canvas.
  */
-export declare function BoardView({ snapshot, animations, onQuoteElement, }: {
+export declare function BoardView({ snapshot, animations, onQuoteElement, compact, sessionId, }: {
     readonly snapshot: BoardSnapshot | undefined;
     readonly animations: boolean;
     readonly onQuoteElement?: (element: BoardElementState) => void;
+    readonly compact?: boolean;
+    readonly sessionId?: string;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import { type ReactNode, type RefObject } from 'react';
+/** Anchored menu surface. Owns positioning, focus and dismissal, not selection state. */
+export declare function ChoicePopover({ anchor, label, onClose, children }: {
+    readonly anchor: RefObject<HTMLElement>;
+    readonly label: string;
+    readonly onClose: () => void;
+    readonly children: ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CiteOverlaySnapshot } from '../types.ts';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+/** Independent entry back to the current learning workspace; owns no selection state. */
+export declare function CiteLauncher({ useCompanion, useOverlay, openPanel }: {
+    useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    openPanel: () => void;
+}): import("react").JSX.Element | null;

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

@@ -1,13 +1,19 @@
+import type { NativeComposer, DeliveryMode } from '../native-composer.ts';
+import type { UseSessionPendingInteraction } from '@deepseek-ai/dsh-client-ui-session/client';
 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 nativeComposer: NativeComposer;
     readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
     readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    readonly useInteractions: UseSessionPendingInteraction;
+    readonly useSubmission: SnapshotSelectorHook<DeliveryMode>;
     readonly bus: OverlayActions;
     readonly companion: CompanionActions;
     readonly closePanel: () => void;
+    readonly openReader: () => void;
     readonly reportParseError: (messageId: string) => void;
 }
 /**
@@ -15,4 +21,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({ useCompanion, useOverlay, bus, companion, closePanel, reportParseError }: CitePanelProps): import("react").JSX.Element | null;
+export declare function CitePanel({ nativeComposer, useCompanion, useOverlay, useInteractions, useSubmission, bus, companion, closePanel, openReader, reportParseError }: CitePanelProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,4 @@
+/** Return from the compact Citer page without discarding its Topic or draft. */
+export declare function CompactBackButton({ onBack }: {
+    readonly onBack: () => void;
+}): import("react").JSX.Element;

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

@@ -1,8 +1,14 @@
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
 import type { ReaderSnapshot } from '../reader-controller.ts';
+import type { CiteOverlaySnapshot } from '../types.ts';
 import type { ReaderActions } from '../view-actions.ts';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SelectionSurfaces } from '../wheel-gesture.ts';
 /** Reader shell-overlay entry: compact trigger plus the document library panel. */
-export declare function DocumentReader({ reader, useReader }: {
+export declare function DocumentReader({ reader, useReader, useOverlay, registerSurface, sourceSessionId }: {
     readonly reader: ReaderActions;
     readonly useReader: SnapshotSelectorHook<ReaderSnapshot>;
+    readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    readonly registerSurface: SelectionSurfaces['register'];
+    readonly sourceSessionId: () => SessionId | null;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import type { ComposerAttachment, DraftAttachmentId } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { NativeComposer } from '../native-composer.ts';
+/** Native Conversation-owned file drafts. The owning controller handles upload and lifetime. */
+export declare function FileAttachments({ files, remove, native, sessionId }: {
+    readonly files: readonly ComposerAttachment[];
+    readonly remove: (id: DraftAttachmentId) => void;
+    readonly native: NativeComposer;
+    readonly sessionId: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+/** Display the receiving Topic without intercepting the drag's pointer target. */
+export declare function FileDropHint({ enabled, title }: {
+    readonly enabled: boolean;
+    readonly title: string | undefined;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import { type LearningCardsProjection } from '../../learning.ts';
+/** Read the latest durable Topic card set. Recall affects display only and never schedules work. */
+export declare function LearningCards({ projection, recall, setRecall, disabled, topicTitle, topicId, source, onRevise }: {
+    readonly projection: LearningCardsProjection;
+    readonly recall: boolean;
+    readonly setRecall: (value: boolean) => void;
+    readonly disabled: boolean;
+    readonly topicTitle: string;
+    readonly topicId: string;
+    readonly source: string;
+    readonly onRevise: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { TopicMessage } from '../../topic.ts';
+/** Optional native todo projection. The user toggles planning; the model owns plan contents. */
+export declare function LearningRoute({ enabled, messages, onChange }: {
+    readonly enabled: boolean;
+    readonly messages: readonly TopicMessage[];
+    readonly onChange: (enabled: boolean) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import type { NativeComposer } from '../native-composer.ts';
+export interface MessageAttachment {
+    readonly kind: 'image' | 'file';
+    readonly id: string;
+    readonly name: string;
+}
+/** Render durable native attachments with a session-authorized loader and owned object URLs. */
+export declare function MessageAttachments({ sessionId, attachments, load }: {
+    readonly sessionId: string;
+    readonly attachments: readonly MessageAttachment[];
+    readonly load: NativeComposer['attachment'];
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { NativeComposer } from '../native-composer.ts';
+import type { MessageAttachment } from './MessageAttachments.tsx';
+/** Accessible file chip. The download hook owns requests and object URLs. */
+export declare function MessageFile({ sessionId, attachment, load }: {
+    readonly sessionId: string;
+    readonly attachment: MessageAttachment;
+    readonly load: NativeComposer['attachment'];
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { ActionModel } from '../../actions.ts';
+import type { ProviderOption } from '../../topic.ts';
+/** Model identities are encoded together, so provider-local model IDs never collide. */
+export declare function ModelChoice({ providers, value, onChange, disabled, label }: {
+    providers: readonly ProviderOption[];
+    value: ActionModel | undefined;
+    onChange: (value: ActionModel | undefined) => void;
+    disabled?: boolean;
+    label?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { SessionPendingInteraction } from '@deepseek-ai/dsh-client-ui-session/client';
+import type { TopicMessage } from '../../topic.ts';
+/** Present the Host's one-shot pending request. Decisions go to its existing waterfall; no second permission authority is created. Remount on pending.key. */
+export declare function NativeInteraction({ pending, messages }: {
+    readonly pending: SessionPendingInteraction;
+    readonly messages: readonly TopicMessage[];
+}): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import type { DocumentPreviewProps } from '@deepseek-ai/dsh-client-ui-sidebar-documentpreview/client';
+import type { ActionSource } from '../action-controller.ts';
+import type { SelectionSurfaces } from '../wheel-gesture.ts';
+export interface LearningDocumentActions {
+    readonly registerSurface: SelectionSurfaces['register'];
+    readonly openActions: (source: ActionSource, x: number, y: number) => void;
+}
+/** Alternate native document renderer. DSH owns loading, reload and file navigation. */
+export declare function NativeLearningDocument({ content, resourceAddress, wrap, scrollportRef, registerSurface, openActions }: DocumentPreviewProps & LearningDocumentActions): import("react").JSX.Element;