@kirkchinese/dsh-citeciter 0.4.3 → 0.5.0

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

@@ -1,4 +1,4 @@
-import { l as citeCiterRequestSchema, u as citeCiterResponseSchema } from "./topic-BVNCaVbJ.js";
+import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-u9-6c_qp.js";
 //#region lib/types/typert-common.js
 /** Strict root-scoped Topic command shared by Host and browser manifests. */
 const citeCiterRequestDescriptor = {
@@ -25,9 +25,29 @@ const citeCiterRequestDescriptor = {
 	},
 	sourceLocation: {
 		file: "src/index.ts",
-		line: 66,
+		line: 127,
+		column: 3
+	}
+};
+/** Strict root-scoped read-only update check shared by Host and browser manifests. */
+const updateCheckDescriptor = {
+	id: "@kirkchinese/dsh-citeciter#citeciter/checkUpdate",
+	service: "citeciter",
+	namespace: "citeciter",
+	method: "checkUpdate",
+	invocation: { kind: "direct" },
+	parameters: [],
+	cancellation: { parameter: "signal" },
+	result: {
+		mode: "strict",
+		typeSymbol: "@kirkchinese/dsh-citeciter#UpdateCheckResponse",
+		schema: updateCheckResponseSchema
+	},
+	sourceLocation: {
+		file: "src/index.ts",
+		line: 134,
 		column: 3
 	}
 };
 //#endregion
-export { citeCiterRequestDescriptor as t };
+export { updateCheckDescriptor as n, citeCiterRequestDescriptor as t };

package/lib/typert.host.js

@@ -1,5 +1,5 @@
-import { h as topicSummarySchema, l as citeCiterRequestSchema, m as topicSnapshotSchema, o as citationDraftSchema, s as citationRecordSchema, u as citeCiterResponseSchema } from "./topic-BVNCaVbJ.js";
-import { t as citeCiterRequestDescriptor } from "./typert-common-4_cbghYz.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-u9-6c_qp.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DKqYKnRO.js";
 //#region lib/types/typert.host.js
 /** Handwritten strict Host contribution matching the single Remote decorator. */
 const TYPERT = {
@@ -29,6 +29,10 @@ const TYPERT = {
 		{
 			name: "CiteCiterResponse",
 			schema: citeCiterResponseSchema
+		},
+		{
+			name: "UpdateCheckResponse",
+			schema: updateCheckResponseSchema
 		}
 	],
 	model: {
@@ -36,7 +40,7 @@ const TYPERT = {
 		events: [],
 		objects: []
 	},
-	invocations: [citeCiterRequestDescriptor]
+	invocations: [citeCiterRequestDescriptor, updateCheckDescriptor]
 };
 //#endregion
 export { TYPERT, TYPERT as default };

package/lib/typert.remote-client.js

@@ -1,9 +1,9 @@
-import { t as citeCiterRequestDescriptor } from "./typert-common-4_cbghYz.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DKqYKnRO.js";
 //#region lib/types/typert.remote-client.js
 /** Browser contribution mounted by the CiteCiter Client fiber. */
 const TYPERT_REMOTE = {
 	package: "@kirkchinese/dsh-citeciter",
-	descriptors: [citeCiterRequestDescriptor]
+	descriptors: [citeCiterRequestDescriptor, updateCheckDescriptor]
 };
 //#endregion
 export { TYPERT_REMOTE, TYPERT_REMOTE as default };

package/lib/types/board.d.ts

@@ -0,0 +1,237 @@
+/** Shared blackboard protocol v4 and deterministic state folding. */
+import { z } from 'zod';
+/** Wire/version identity carried by every board snapshot. */
+export declare const BOARD_PROTOCOL_VERSION: 4;
+/** Maximum operations accepted in one atomic board commit. */
+export declare const BOARD_MAX_BATCH_OPS = 50;
+/** Maximum elements retained on one board. */
+export declare const BOARD_MAX_ELEMENTS = 50;
+/** Maximum combined UTF-8 element-content bytes retained on one board. */
+export declare const BOARD_MAX_CONTENT_BYTES = 500000;
+/** Element kinds the blackboard renders safely on the chalk canvas. */
+export declare const boardElementKindSchema: z.ZodEnum<{
+    text: "text";
+    markdown: "markdown";
+    math: "math";
+    svg: "svg";
+    html: "html";
+    image: "image";
+    table: "table";
+}>;
+export type BoardElementKind = z.infer<typeof boardElementKindSchema>;
+/** Style keys the board renderer applies directly as inline CSS properties. */
+export declare const boardStyleSchema: z.ZodObject<{
+    color: z.ZodOptional<z.ZodString>;
+    fontSize: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BoardStyle = z.infer<typeof boardStyleSchema>;
+/** One deterministic blackboard command in canvas-percent coordinates. */
+export declare const boardOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"clear">;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set">;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        text: "text";
+        markdown: "markdown";
+        math: "math";
+        svg: "svg";
+        html: "html";
+        image: "image";
+        table: "table";
+    }>;
+    content: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"update">;
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    w: z.ZodOptional<z.ZodNumber>;
+    h: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"clear_region">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"animate">;
+    id: z.ZodString;
+    animation: z.ZodEnum<{
+        "fade-in": "fade-in";
+        "slide-in": "slide-in";
+        pulse: "pulse";
+        highlight: "highlight";
+    }>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"focus">;
+    id: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>], "op">;
+export type BoardOp = z.infer<typeof boardOpSchema>;
+/** One validated, non-empty atomic blackboard commit. */
+export declare const boardBatchSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"clear">;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set">;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        text: "text";
+        markdown: "markdown";
+        math: "math";
+        svg: "svg";
+        html: "html";
+        image: "image";
+        table: "table";
+    }>;
+    content: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"update">;
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    w: z.ZodOptional<z.ZodNumber>;
+    h: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"clear_region">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"animate">;
+    id: z.ZodString;
+    animation: z.ZodEnum<{
+        "fade-in": "fade-in";
+        "slide-in": "slide-in";
+        pulse: "pulse";
+        highlight: "highlight";
+    }>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"focus">;
+    id: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>], "op">>;
+/** One rendered blackboard element after op folding. */
+export interface BoardElementState {
+    readonly id: string;
+    readonly kind: BoardElementKind;
+    readonly content: string;
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+    readonly style: BoardStyle;
+    readonly focused: boolean;
+    readonly animation?: {
+        readonly name: 'fade-in' | 'slide-in' | 'pulse' | 'highlight';
+        readonly durationMs: number;
+        readonly iterations: number;
+        readonly run: number;
+    } | undefined;
+}
+/** Immutable blackboard state keyed by element id. */
+export type BoardState = ReadonlyMap<string, BoardElementState>;
+/** Empty immutable input for the first board commit. */
+export declare const EMPTY_BOARD_STATE: BoardState;
+/**
+ * Apply one validated op batch atomically to the current board state.
+ * @param state - current element map.
+ * @param ops - validated, non-empty ops in application order.
+ * @returns the new state and the number of applied ops.
+ */
+export declare function applyBoardOps(state: BoardState, ops: readonly BoardOp[]): {
+    readonly state: BoardState;
+    readonly revision: number;
+};
+/** Snapshot field containing only the final projected board state. */
+export declare const boardSnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<4>;
+    revision: z.ZodNumber;
+    elements: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            text: "text";
+            markdown: "markdown";
+            math: "math";
+            svg: "svg";
+            html: "html";
+            image: "image";
+            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>;
+export type BoardSnapshot = z.infer<typeof boardSnapshotSchema>;
+/** Empty snapshot used before any board commit. */
+export declare const EMPTY_BOARD_SNAPSHOT: BoardSnapshot;
+/**
+ * Read renderable elements from one final-state snapshot.
+ * @param snapshot - projected final board state.
+ * @returns ordered elements plus the committed revision.
+ */
+export declare function foldBoardSnapshot(snapshot: BoardSnapshot): {
+    readonly elements: readonly BoardElementState[];
+    readonly revision: number;
+};
+/**
+ * Fold a raw op list from first-set order; used by protocol tests.
+ * @param ops - one validated op batch.
+ * @returns final elements in insertion order.
+ */
+export declare function foldBoardElements(ops: readonly BoardOp[]): readonly BoardElementState[];

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

@@ -1,7 +1,7 @@
 import { type ISessions, type SessionId, type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
-import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings, type ProviderOption, type QuestionAnswer, type TopicSnapshot, type TopicSummary } from '../topic.ts';
-import { type CreateMode } from './request-guard.ts';
+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 { CiteSelection } from './types.ts';
 export type CompanionPhase = 'idle' | 'creating' | 'ready' | 'running' | 'stopping' | 'stopped' | 'error';
 export type { CreateMode } from './request-guard.ts';
@@ -24,6 +24,8 @@ export interface CompanionSnapshot {
     reasoningEffortSaving: boolean;
     renaming: boolean;
     archiving: boolean;
+    deleting: boolean;
+    notice: string | null;
     includeArchived: boolean;
     error: string | null;
 }
@@ -32,8 +34,10 @@ export interface CompanionFace {
     getSnapshot(): CompanionSnapshot;
     subscribe(listener: () => void): () => void;
     setSource(sessionId: SessionId | null): void;
-    setVisible(visible: boolean): void;
-    create(selection: CiteSelection, question: string, mode?: CreateMode): Promise<void>;
+    retainVisible(): () => void;
+    create(selection: CiteSelection, question: string, mode?: CreateMode, scenario?: TopicScenario): Promise<void>;
+    createFree(question: string, scenario: Extract<TopicScenario, 'qa' | 'present'>): Promise<boolean>;
+    createFromDocument(claim: DocumentClaimIntent, question: string): Promise<void>;
     openTopic(sessionId: string): Promise<void>;
     ask(question: string): Promise<boolean>;
     answerQuestion(key: string, answer: QuestionAnswer): Promise<void>;
@@ -41,6 +45,8 @@ export interface CompanionFace {
     stop(): Promise<void>;
     rename(title: string): Promise<boolean>;
     archive(archived: boolean): Promise<boolean>;
+    deleteTopic(confirmSessionId: string): Promise<'complete' | 'pending' | false>;
+    dismissError(): void;
     setIncludeArchived(include: boolean): void;
     setModelRoute(provider: string, model: string): Promise<void>;
     setReasoningEffort(reasoningEffort: string | null): Promise<void>;

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

@@ -0,0 +1,16 @@
+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 openPanel: () => void;
+}
+export type BlackboardWorkspaceProps = ConvViewProps & BlackboardWorkspaceInjected;
+/**
+ * Render the session-scoped blackboard registered through conversation.view.
+ * @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;

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

@@ -0,0 +1,12 @@
+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.
+ * @returns the safe blackboard canvas.
+ */
+export declare function BoardView({ snapshot, animations, onQuoteElement, }: {
+    readonly snapshot: BoardSnapshot | undefined;
+    readonly animations: boolean;
+    readonly onQuoteElement?: (element: BoardElementState) => void;
+}): import("react").JSX.Element;

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

@@ -1,9 +1,11 @@
 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;
 }
 /** Native DSH settings page for CiteCiter-owned preferences. */
-export declare function CiteCiterSettings({ companion, settingsDocument }: CiteCiterSettingsProps): import("react").JSX.Element;
+export declare function CiteCiterSettings({ companion, settingsDocument, updateController }: CiteCiterSettingsProps): import("react").JSX.Element;

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

@@ -6,5 +6,9 @@ export interface CitePanelProps {
     readonly closePanel: () => void;
     readonly reportParseError: (messageId: string) => void;
 }
-/** Independent learning workspace with a reversible Host-column compatibility adapter. */
+/**
+ * Render the independent Topic workspace on the right edge of the shell.
+ * @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;

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

@@ -0,0 +1,5 @@
+import type { ReaderFace } from '../reader-controller.ts';
+/** Reader shell-overlay entry: compact trigger plus the document library panel. */
+export declare function DocumentReader({ reader }: {
+    readonly reader: ReaderFace;
+}): import("react").JSX.Element;

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

@@ -5,5 +5,9 @@ export interface SelectionMenuProps {
     readonly companion: CompanionFace;
     readonly openPanel: () => void;
 }
-/** Ask the first question beside the selected source text. */
+/**
+ * Ask the first question beside the selected source text.
+ * @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;

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

@@ -0,0 +1,11 @@
+import { type UpdateController } from '../update-controller.ts';
+/** Injected owner of the root-scoped update state. */
+export interface UpdateNoticeProps {
+    readonly updateController: UpdateController;
+}
+/**
+ * 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;

package/lib/types/client/conversation-dom.d.ts

@@ -41,13 +41,21 @@ export declare function dshAssistantAnchorForTarget(target: EventTarget | null):
  */
 export declare function dshIntersectedAssistantAnchors(range: Range): DshAssistantAnchor[];
 /**
- * Detect generated controls, reasoning summaries, and collapsed code chrome.
+ * Detect generated controls and collapsed code chrome.
  *
  * @param range - current rendered selection range.
  * @param flow - assistant flow containing the range.
  * @returns whether the range touches content that CiteCiter must ignore.
  */
 export declare function dshRangeTouchesExcludedContent(range: Range, flow: HTMLElement): boolean;
+/**
+ * Detect a selection endpoint inside a generated reasoning disclosure row.
+ *
+ * @param range - current rendered selection range.
+ * @param flow - assistant flow containing the range.
+ * @returns whether a collapsed or expanded reasoning header anchors the selection.
+ */
+export declare function dshRangeHasReasoningHeaderEndpoint(range: Range, flow: HTMLElement): boolean;
 /**
  * Find the current DSH assistant element for a persisted anchor key.
  *

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

@@ -0,0 +1,60 @@
+/**
+ * Client entry-point registry: every "start a Citer from here" surface
+ * contributes one entry that probes the pointer event and claims a selection.
+ * 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 { CiteSelection } from './types.ts';
+/** Live browser facts an entry needs to resolve one selection. */
+export interface CiteCiterEntryContext {
+    readonly sessions: ISessions;
+    readonly sourceSessionId: SessionId;
+}
+/** One Citer entry point: probe, capture, and claim a selection from the DOM. */
+export interface CiteCiterEntry {
+    /** Stable entry identity recorded on the claimed selection. */
+    readonly id: string;
+    /**
+     * Claim the current pointer event for this entry.
+     * @param event - context-menu event whose position anchors the claim.
+     * @param context - current source session and its bindings.
+     * @returns a validated selection, or null when this entry does not own the event.
+     */
+    claim(event: MouseEvent, context: CiteCiterEntryContext): CiteSelection | null;
+}
+/** Mutable ordered entry registry with effect-style registration. */
+export interface CiteCiterEntryRegistry {
+    /**
+     * Append one entry.
+     * @param entry - immutable entry contribution.
+     * @returns disposer removing the exact entry.
+     */
+    register(entry: CiteCiterEntry): () => void;
+    /** Registered entries in claim order. */
+    list(): readonly CiteCiterEntry[];
+    /**
+     * Ask entries in order for a claimed selection.
+     * @returns the first entry claim, or null when no entry owns the event.
+     */
+    claim(event: MouseEvent, context: CiteCiterEntryContext): {
+        readonly entry: CiteCiterEntry;
+        readonly selection: CiteSelection;
+    } | null;
+}
+/** Create an ordered client entry registry. */
+export declare function createCiteCiterEntryRegistry(): CiteCiterEntryRegistry;
+/**
+ * Built-in assistant answer entry: resolves a selection inside a committed
+ * `assistant-step` flow, including collapsed reasoning disclosure rows.
+ * @returns the entry contribution; register it on the shared registry.
+ */
+export declare function createAssistantEntry(): CiteCiterEntry;
+/**
+ * Built-in tool evidence entry: claims a whole-card tool result from its
+ * `call:<callId>` row and the enclosing `tool-call` chat flow. Terminal and
+ * diff cards select their dedicated projections; everything else is
+ * `result-text`.
+ * @returns the entry contribution; register it after the assistant entry.
+ */
+export declare function createToolEvidenceEntry(): CiteCiterEntry;

package/lib/types/client/entry-ids.d.ts

@@ -0,0 +1,3 @@
+/** Stable identities for CiteCiter client entry points. */
+export declare const ASSISTANT_ENTRY_ID: "citeciter.entry.assistant";
+export declare const TOOL_ENTRY_ID: "citeciter.entry.tool";

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

@@ -0,0 +1,19 @@
+/** CiteCiter-owned accelerator parsing and listener installation. */
+export interface Accelerator {
+    readonly modifiers: ReadonlySet<'Control' | 'Alt' | 'Shift' | 'Meta'>;
+    readonly key: string;
+}
+/**
+ * Parse a `Modifier+Modifier+Key` accelerator string.
+ * @param accelerator - user-configured accelerator, e.g. `Control+Shift+C`.
+ * @returns normalized modifiers and the final key, or null when malformed.
+ */
+export declare function parseAccelerator(accelerator: string): Accelerator | null;
+/**
+ * Install a window-level keydown listener that reads the accelerator fresh on
+ * every keypress, so settings changes apply without re-registering.
+ * @param accelerator - current accelerator getter; an empty value disables the binding.
+ * @param handler - invoked once for each matching, non-editable, non-IME keypress.
+ * @returns disposer removing the listener.
+ */
+export declare function installDynamicAccelerator(accelerator: () => string | undefined, handler: () => void): () => void;

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

@@ -0,0 +1,33 @@
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { CiteCiterRequest, CiteCiterResponse, DocumentContent, DocumentSummary } from '../topic.ts';
+import type { CompanionFace } from './companion-controller.ts';
+import type { ReaderSelection } from './reader-selection.ts';
+export type ReaderDocumentsStatus = 'idle' | 'loading' | 'ready' | 'error';
+export interface ReaderSnapshot {
+    open: boolean;
+    documents: readonly DocumentSummary[];
+    documentsStatus: ReaderDocumentsStatus;
+    active: DocumentContent | null;
+    selection: ReaderSelection | null;
+    question: string;
+    creating: boolean;
+    error: string | null;
+}
+export interface ReaderFace {
+    getSnapshot(): ReaderSnapshot;
+    subscribe(listener: () => void): () => void;
+    setOpen(open: boolean): void;
+    refresh(): Promise<void>;
+    importFile(name: string, content: string): Promise<DocumentSummary | null>;
+    openDocument(documentId: string): Promise<void>;
+    setSelection(selection: ReaderSelection | null): void;
+    setQuestion(question: string): void;
+    createTopic(): Promise<void>;
+    dispose(): Promise<void>;
+}
+type RemoteRequest = (request: CiteCiterRequest, signal: AbortSignal) => Promise<RemoteResult<CiteCiterResponse>>;
+/** 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 {};

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

@@ -0,0 +1,12 @@
+/** Reader textarea selection facts resolved from the user-owned textarea value. */
+export interface ReaderSelection {
+    readonly displayText: string;
+    readonly prefixText: string;
+    readonly suffixText: string;
+}
+/**
+ * Resolve the current textarea selection into a verifiable document claim.
+ * @param textarea - read-only document textarea holding the complete loaded page.
+ * @returns trimmed quote with surrounding context, or null for a collapsed/empty selection.
+ */
+export declare function readTextareaSelection(textarea: HTMLTextAreaElement): ReaderSelection | null;

package/lib/types/client/request-guard.d.ts

@@ -1,3 +1,4 @@
+import type { TopicScenario } from '../topic.ts';
 import type { CiteSelection } from './types.ts';
 export type CreateMode = 'observer' | 'exact-fork' | 'exact-when-available';
 export interface RequestIntent {
@@ -11,7 +12,29 @@ export interface RequestIntent {
  * @param mode - resolved Topic creation mode.
  * @returns the pending intent key and request ID.
  */
-export declare function claimCreateTopicIntent(selection: CiteSelection, question: string, mode: CreateMode): Promise<RequestIntent>;
+export declare function claimCreateTopicIntent(selection: CiteSelection, question: string, mode: CreateMode, scenario?: TopicScenario): Promise<RequestIntent>;
+/**
+ * Claim the retry-stable request ID for one uncited Topic creation.
+ * @param sourceSessionId - owning DSH Session.
+ * @param question - normalized first question.
+ * @param scenario - requested Topic presentation.
+ * @returns the pending intent key and request ID.
+ */
+export declare function claimCreateFreeTopicIntent(sourceSessionId: string, question: string, scenario: Extract<TopicScenario, 'qa' | 'present'>): Promise<RequestIntent>;
+/** Document-range claim identity shared by the Reader entry point. */
+export interface DocumentClaimIntent {
+    readonly documentId: string;
+    readonly displayText: string;
+    readonly prefixText: string;
+    readonly suffixText: string;
+}
+/**
+ * Claim the retry-stable request ID for one pending document Topic creation.
+ * @param claim - document identity and verified-looking quote context.
+ * @param question - normalized first question.
+ * @returns the pending intent key and request ID.
+ */
+export declare function claimCreateDocumentIntent(claim: DocumentClaimIntent, question: string): Promise<RequestIntent>;
 /**
  * Claim the retry-stable request ID for one pending Topic follow-up.
  * @param topicSessionId - target private Topic Session.

package/lib/types/client/rich-content.d.ts

@@ -18,6 +18,12 @@ export type RichSegment = {
     readonly kind: 'html';
     readonly document: string;
 };
+/**
+ * Break CommonMark image openers without changing visible text or ordinary links.
+ * @param text - untrusted board Markdown or table source.
+ * @returns Markdown that cannot produce image nodes.
+ */
+export declare function neutralizeMarkdownImages(text: string): string;
 /**
  * Split complete safe rich fences from Markdown while preserving all prose.
  * @param text - current assistant response text.