@kirkchinese/dsh-citeciter 0.5.0 → 0.8.0

package/lib/types/topic-runtime.d.ts

@@ -1,10 +1,9 @@
 import { Context } from '@deepseek-ai/cordis';
-import { type SessionEvent, type SessionHeader } from '@deepseek-ai/dsh-session';
+import { SessionLogOffset, type SessionEvent, type SessionHeader } from '@deepseek-ai/dsh-session';
 import { type SessionTitleProviderRequest } from '@deepseek-ai/dsh-session-title';
-import { z } from 'zod';
 import { type BoardSnapshot } from './board.ts';
 import { type ObserverSourceSnapshot } from './observer.ts';
-import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings, type CitationRecord, type TopicMessage, type TopicMetadata, type TopicMode, type TopicScenario, type TopicSummary } from './topic.ts';
+import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings, type CitationRecord, type TopicMessage, type TopicMode, type TopicScenario, type TopicSummary } from './topic.ts';
 type CreateRequest = Extract<CiteCiterRequest, {
     action: 'create';
 }>;
@@ -246,54 +245,9 @@ export declare function selectTopicTitleMessage(request: SessionTitleProviderReq
 export interface RuntimeTopicLog {
     readonly header: SessionHeader;
     readonly events: readonly SessionEvent[];
-}
-/**
- * Remove one artifact from a caller-owned JSONL root without following links.
- * @param root - fixed private JSONL root owned by the caller.
- * @param artifact - location returned by that exact JSONL backend.
- * @returns when the file/link and its empty per-session directory are absent.
- */
-export declare function removeOwnedJsonlArtifact(root: string, artifact: {
-    readonly kind: string;
-    readonly path: string;
-} | undefined): Promise<void>;
-declare const topicDeletionMarkerSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    sessionId: z.ZodString;
-    sourceSessionId: z.ZodString;
-    topicId: z.ZodNumber;
-    sessionHeader: z.ZodObject<{
-        version: z.ZodNumber;
-        id: z.ZodString;
-        createdAt: z.ZodNumber;
-        cwd: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-type TopicDeletionMarker = Omit<z.infer<typeof topicDeletionMarkerSchema>, 'sessionHeader'> & {
-    readonly sessionHeader: SessionHeader;
-};
-/** Minimal on-disk navigation index; Session history stays in standard DSH JSONL. */
-export declare class TopicIndex {
-    private readonly root;
-    /** @param root - private Topic index root. */
-    constructor(root?: string);
-    reserve(sourceSessionId: string): Promise<{
-        topicId: number;
-        directory: string;
-    }>;
-    save(metadata: TopicMetadata): Promise<void>;
-    loadBySessionId(sessionId: string): Promise<TopicMetadata>;
-    list(sourceSessionId: string): Promise<TopicMetadata[]>;
-    /** Commit a minimal deletion marker before making Topic metadata unreachable. */
-    markDeleting(metadata: TopicMetadata, sessionHeader: SessionHeader): Promise<TopicDeletionMarker>;
-    /** Discover committed deletion markers without following linked directories. */
-    listDeleting(): Promise<TopicDeletionMarker[]>;
-    /** Remove the marker and its now-empty Topic directory after artifact cleanup. */
-    finishDeleting(marker: TopicDeletionMarker): Promise<void>;
-    private directory;
-    private read;
-    private readIfPresent;
-    private deletionMarkerIfPresent;
+    readonly inheritedEventCount: SessionLogOffset;
+    readonly liveMessage?: TopicMessage | undefined;
+    readonly renderKeys?: ReadonlyMap<number, string> | undefined;
 }
 /**
  * Project transcript rows and the latest turn's active failure banner.
@@ -323,8 +277,12 @@ export declare function firstPostSeedUserQuestion(log: RuntimeTopicLog): string
  * @returns the matching question, or `null` when the request is not committed.
  */
 export declare function postSeedUserQuestionById(log: RuntimeTopicLog, messageId: string): string | null;
-/** Fold only titles created inside the private Topic, excluding inherited fork titles. */
-export declare function foldTopicTitle(metadata: TopicMetadata, events: readonly SessionEvent[]): import("@deepseek-ai/dsh-session-title").SessionTitleSnapshot | undefined;
+/**
+ * Fold child-owned titles using the restored logical prefix, including after migration.
+ * @param log - restored Topic events and the host-owned inherited event count.
+ * @returns the latest Topic title projection, or undefined before any title is recorded.
+ */
+export declare function foldTopicTitle(log: RuntimeTopicLog): import("@deepseek-ai/dsh-session-title").SessionTitleSnapshot | undefined;
 /** Resolve the actual Topic mode without forking through an open DSH turn. */
 export declare function resolveTopicModeAndSeed(requested: CreateRequest, source: ObserverSourceSnapshot, anchorSeq: number): {
     mode: TopicMode;
@@ -336,7 +294,9 @@ export declare class TopicRuntime {
     private readonly host;
     private readonly settings;
     private readonly runtime;
+    private readonly native;
     private readonly index;
+    private readonly sourceStorage;
     private readonly documents;
     private readonly lifecycleAbort;
     private readonly fibers;
@@ -357,13 +317,12 @@ export declare class TopicRuntime {
     private readonly sourceAvailabilityChecks;
     private readonly ready;
     private readonly topicListeners;
+    private readonly streams;
     private disposal;
     private releasing;
     private releaseLlm;
     private releaseFs;
     private releaseSubprocess;
-    private releaseSandboxPolicy;
-    private releaseQuestionProvider;
     private hasSourceFiles;
     private closed;
     /** @param host - owning DSH context. @param settings - current user preferences. */
@@ -378,6 +337,7 @@ export declare class TopicRuntime {
      * @returns disposer removing the exact listener.
      */
     onTopicChange(listener: TopicChangeListener): () => void;
+    private readonly boardCapture;
     private executeRequest;
     /** Stop every owned Agent and plugin fiber before releasing bridged services. */
     dispose(): Promise<void>;
@@ -385,6 +345,8 @@ export declare class TopicRuntime {
     private beginClosing;
     private assertOpen;
     private start;
+    /** Adopt existing Citer histories into each source directory without deleting or rewriting their original logs. */
+    private migrateStorage;
     private releaseRuntime;
     private releaseOwnedRuntime;
     private settleOwnedOperations;
@@ -394,8 +356,10 @@ export declare class TopicRuntime {
     private createIdempotent;
     private resumeOrCreate;
     private createHandle;
+    private setupHostedAgent;
     private setupAgent;
     private globTool;
+    private learningCardsTool;
     private blackboardApplyTool;
     private readDocumentTool;
     private searchDocumentTool;
@@ -416,9 +380,9 @@ export declare class TopicRuntime {
     private archive;
     private delete;
     private deleteAdmitted;
-    /** Await rc.2 JSONL retirement without populating its prepared-session cache. */
+    /** Observe the retired Session after its Agent has released write ownership. */
     private readRetiredSessionHeader;
-    /** Remove one artifact only from CiteCiter's fixed private JSONL backend. */
+    /** Remove every retired generation only from CiteCiter's fixed private JSONL backend. */
     private removeSessionArtifact;
     private finishDeletion;
     private recoverDeletions;

package/lib/types/topic-stream.d.ts

@@ -0,0 +1,14 @@
+/** Process-local Topic output; durable settlements remain owned by DSH Session. */
+import type { AssistantStreamFrame } from '@deepseek-ai/dsh-agent';
+import type { TopicMessage } from './topic.ts';
+/** One Agent's ordered live stream. Dispose the instance with that Agent. */
+export declare class TopicStreamProjection {
+    private active;
+    private readonly settled;
+    /** Exact end-frame receipts keep an existing UI row mounted after durable settlement; aliases expire with this Agent. */
+    get renderKeys(): ReadonlyMap<number, string>;
+    /** @param frame - scoped Agent publication. @param nextSeq - current Session event count. */
+    accept(frame: AssistantStreamFrame, nextSeq: number): void;
+    /** @returns a detached display row, absent before visible output or after settlement. */
+    snapshot(): TopicMessage | undefined;
+}

package/lib/types/topic.d.ts

@@ -54,7 +54,38 @@ export declare const citeCiterSettingsSchema: z.ZodObject<{
     }, z.core.$strict>>>;
     shortcutOpenPanel: z.ZodOptional<z.ZodString>;
     boardAnimations: z.ZodOptional<z.ZodBoolean>;
+    activeRecall: z.ZodOptional<z.ZodBoolean>;
     updateNotifications: z.ZodOptional<z.ZodBoolean>;
+    wheelSlots: z.ZodOptional<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>>>>;
+    wheelTrigger: z.ZodOptional<z.ZodEnum<{
+        "right-button": "right-button";
+        Alt: "Alt";
+        Control: "Control";
+        Shift: "Shift";
+        Meta: "Meta";
+    }>>;
+    defaultCiterModel: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>>;
+    defaultPermission: z.ZodOptional<z.ZodEnum<{
+        "read-only": "read-only";
+        "workspace-write": "workspace-write";
+        "danger-full-access": "danger-full-access";
+    }>>;
+    learningRoute: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type CiteCiterSettings = z.infer<typeof citeCiterSettingsSchema>;
 /** Settings used before an optional DSH settings provider becomes available. */
@@ -261,6 +292,8 @@ export declare const topicMetadataSchema: z.ZodObject<{
         investigate: "investigate";
     }>;
     documentId: z.ZodNullable<z.ZodString>;
+    hosted: z.ZodOptional<z.ZodBoolean>;
+    storage: z.ZodOptional<z.ZodLiteral<"source">>;
     topicId: z.ZodNumber;
     createRequestId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodString;
@@ -303,7 +336,19 @@ export type TopicMetadata = z.infer<typeof topicMetadataSchema>;
  * @returns canonical TopicMetadata.
  */
 export declare function parseTopicMetadataFile(raw: unknown): TopicMetadata;
+export declare const permissionSchema: z.ZodEnum<{
+    "read-only": "read-only";
+    "workspace-write": "workspace-write";
+    "danger-full-access": "danger-full-access";
+}>;
 export declare const topicSummarySchema: z.ZodObject<{
+    permission: z.ZodOptional<z.ZodEnum<{
+        "read-only": "read-only";
+        "workspace-write": "workspace-write";
+        "danger-full-access": "danger-full-access";
+    }>>;
+    hosted: z.ZodOptional<z.ZodBoolean>;
+    storage: z.ZodOptional<z.ZodLiteral<"source">>;
     topicId: z.ZodNumber;
     sessionId: z.ZodString;
     sourceSessionId: z.ZodString;
@@ -375,11 +420,20 @@ export declare const topicSummarySchema: z.ZodObject<{
 export type TopicSummary = z.infer<typeof topicSummarySchema>;
 export declare const topicMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     role: z.ZodLiteral<"user">;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            image: "image";
+            file: "file";
+        }>;
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>>;
     text: z.ZodString;
     id: z.ZodString;
     seq: z.ZodNumber;
 }, z.core.$strict>, z.ZodObject<{
     role: z.ZodLiteral<"assistant">;
+    renderKey: z.ZodOptional<z.ZodString>;
     text: z.ZodString;
     reasoning: z.ZodNullable<z.ZodString>;
     streaming: z.ZodBoolean;
@@ -393,6 +447,14 @@ export declare const topicMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     seq: z.ZodNumber;
 }, z.core.$strict>, z.ZodObject<{
     role: z.ZodLiteral<"tool">;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            image: "image";
+            file: "file";
+        }>;
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>>;
     name: z.ZodString;
     arguments: z.ZodString;
     result: z.ZodNullable<z.ZodString>;
@@ -450,7 +512,16 @@ export declare const pendingQuestionSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type PendingQuestion = z.infer<typeof pendingQuestionSchema>;
 export declare const topicSnapshotSchema: z.ZodObject<{
+    captureId: z.ZodOptional<z.ZodString>;
+    documentTitle: z.ZodOptional<z.ZodString>;
     topic: z.ZodObject<{
+        permission: z.ZodOptional<z.ZodEnum<{
+            "read-only": "read-only";
+            "workspace-write": "workspace-write";
+            "danger-full-access": "danger-full-access";
+        }>>;
+        hosted: z.ZodOptional<z.ZodBoolean>;
+        storage: z.ZodOptional<z.ZodLiteral<"source">>;
         topicId: z.ZodNumber;
         sessionId: z.ZodString;
         sourceSessionId: z.ZodString;
@@ -521,11 +592,20 @@ export declare const topicSnapshotSchema: z.ZodObject<{
     }, z.core.$strict>;
     messages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         role: z.ZodLiteral<"user">;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                image: "image";
+                file: "file";
+            }>;
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>>;
         text: z.ZodString;
         id: z.ZodString;
         seq: z.ZodNumber;
     }, z.core.$strict>, z.ZodObject<{
         role: z.ZodLiteral<"assistant">;
+        renderKey: z.ZodOptional<z.ZodString>;
         text: z.ZodString;
         reasoning: z.ZodNullable<z.ZodString>;
         streaming: z.ZodBoolean;
@@ -539,6 +619,14 @@ export declare const topicSnapshotSchema: z.ZodObject<{
         seq: z.ZodNumber;
     }, z.core.$strict>, z.ZodObject<{
         role: z.ZodLiteral<"tool">;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                image: "image";
+                file: "file";
+            }>;
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>>;
         name: z.ZodString;
         arguments: z.ZodString;
         result: z.ZodNullable<z.ZodString>;
@@ -578,12 +666,12 @@ export declare const topicSnapshotSchema: 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;
@@ -686,11 +774,17 @@ export declare const documentContentSchema: z.ZodObject<{
     }>;
     content: z.ZodString;
     truncated: z.ZodBoolean;
+    page: z.ZodDefault<z.ZodNumber>;
+    pageCount: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type DocumentContent = z.infer<typeof documentContentSchema>;
 /** One strict direct-RPC command for the private CiteCiter runtime. */
 export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
     action: z.ZodLiteral<"create">;
+    modelRoute: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
     requestId: z.ZodString;
     sourceSessionId: z.ZodString;
     question: z.ZodString;
@@ -701,6 +795,10 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
     }>>;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"create">;
+    modelRoute: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
     requestId: z.ZodString;
     citation: z.ZodObject<{
         sourceSessionId: z.ZodString;
@@ -727,6 +825,10 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
     }>>;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"create">;
+    modelRoute: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
     requestId: z.ZodString;
     selectionClaim: z.ZodObject<{
         sourceSessionId: z.ZodString;
@@ -750,6 +852,10 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
     }>>;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"create">;
+    modelRoute: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
     requestId: z.ZodString;
     toolClaim: z.ZodObject<{
         sourceSessionId: z.ZodString;
@@ -775,6 +881,10 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
     }>>;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"create">;
+    modelRoute: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
     requestId: z.ZodString;
     documentClaim: z.ZodObject<{
         sourceSessionId: z.ZodString;
@@ -799,9 +909,23 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
     action: z.ZodLiteral<"list">;
     sourceSessionId: z.ZodString;
     includeArchived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"board-capture">;
+    topicSessionId: z.ZodString;
+    id: z.ZodString;
+    png: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"get">;
     topicSessionId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"native-state">;
+    topicSessionId: z.ZodString;
+    requestIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"native-attachment">;
+    topicSessionId: z.ZodString;
+    attachmentId: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"ask">;
     requestId: z.ZodOptional<z.ZodString>;
@@ -839,6 +963,14 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
     confirmSessionId: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"models">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"set-permission">;
+    topicSessionId: z.ZodString;
+    mode: z.ZodEnum<{
+        "read-only": "read-only";
+        "workspace-write": "workspace-write";
+        "danger-full-access": "danger-full-access";
+    }>;
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"set-model-route">;
     topicSessionId: z.ZodString;
@@ -868,13 +1000,154 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
 }, z.core.$strict>, z.ZodObject<{
     action: z.ZodLiteral<"document-get">;
     documentId: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>], "action">]>;
 export type CiteCiterRequest = z.infer<typeof citeCiterRequestSchema>;
 /** Strict response union returned by the single Remote command endpoint. */
 export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"native-state">;
+    state: z.ZodObject<{
+        running: z.ZodBoolean;
+        blank: z.ZodBoolean;
+        error: z.ZodNullable<z.ZodString>;
+        queue: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            placement: z.ZodEnum<{
+                queued: "queued";
+                steering: "steering";
+                context: "context";
+            }>;
+            rpcId: z.ZodOptional<z.ZodString>;
+            text: z.ZodString;
+            attachments: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                attachment: z.ZodPipe<z.ZodObject<{
+                    attachmentId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@deepseek-ai/dsh-attachment").AttachmentId, string>>;
+                    mediaType: z.ZodEnum<{
+                        "image/png": "image/png";
+                        "image/jpeg": "image/jpeg";
+                        "image/webp": "image/webp";
+                        "image/gif": "image/gif";
+                    }>;
+                    bytes: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                    name: z.ZodOptional<z.ZodString>;
+                    originalDimensions: z.ZodOptional<z.ZodObject<{
+                        width: z.ZodNumber;
+                        height: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>, z.ZodTransform<import("@deepseek-ai/dsh-attachment").ImageAttachmentRef, {
+                    attachmentId: import("@deepseek-ai/dsh-attachment").AttachmentId;
+                    mediaType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+                    bytes: number;
+                    width: number;
+                    height: number;
+                    name?: string | undefined;
+                    originalDimensions?: {
+                        width: number;
+                        height: number;
+                    } | undefined;
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                attachment: z.ZodObject<{
+                    attachmentId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@deepseek-ai/dsh-attachment").AttachmentId, string>>;
+                    name: z.ZodString;
+                    bytes: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>;
+        receipts: z.ZodArray<z.ZodObject<{
+            requestId: z.ZodString;
+            attachments: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                attachment: z.ZodPipe<z.ZodObject<{
+                    attachmentId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@deepseek-ai/dsh-attachment").AttachmentId, string>>;
+                    mediaType: z.ZodEnum<{
+                        "image/png": "image/png";
+                        "image/jpeg": "image/jpeg";
+                        "image/webp": "image/webp";
+                        "image/gif": "image/gif";
+                    }>;
+                    bytes: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                    name: z.ZodOptional<z.ZodString>;
+                    originalDimensions: z.ZodOptional<z.ZodObject<{
+                        width: z.ZodNumber;
+                        height: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>, z.ZodTransform<import("@deepseek-ai/dsh-attachment").ImageAttachmentRef, {
+                    attachmentId: import("@deepseek-ai/dsh-attachment").AttachmentId;
+                    mediaType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+                    bytes: number;
+                    width: number;
+                    height: number;
+                    name?: string | undefined;
+                    originalDimensions?: {
+                        width: number;
+                        height: number;
+                    } | undefined;
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                attachment: z.ZodObject<{
+                    attachmentId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@deepseek-ai/dsh-attachment").AttachmentId, string>>;
+                    name: z.ZodString;
+                    bytes: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"native-attachment">;
+    attachment: z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+        attachmentId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@deepseek-ai/dsh-attachment").AttachmentId, string>>;
+        mediaType: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+            "image/gif": "image/gif";
+        }>;
+        bytes: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        name: z.ZodOptional<z.ZodString>;
+        originalDimensions: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodTransform<import("@deepseek-ai/dsh-attachment").ImageAttachmentRef, {
+        attachmentId: import("@deepseek-ai/dsh-attachment").AttachmentId;
+        mediaType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+        bytes: number;
+        width: number;
+        height: number;
+        name?: string | undefined;
+        originalDimensions?: {
+            width: number;
+            height: number;
+        } | undefined;
+    }>>, z.ZodObject<{
+        attachmentId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@deepseek-ai/dsh-attachment").AttachmentId, string>>;
+        name: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strict>]>;
+    data: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"topic">;
     topic: z.ZodObject<{
+        captureId: z.ZodOptional<z.ZodString>;
+        documentTitle: z.ZodOptional<z.ZodString>;
         topic: z.ZodObject<{
+            permission: z.ZodOptional<z.ZodEnum<{
+                "read-only": "read-only";
+                "workspace-write": "workspace-write";
+                "danger-full-access": "danger-full-access";
+            }>>;
+            hosted: z.ZodOptional<z.ZodBoolean>;
+            storage: z.ZodOptional<z.ZodLiteral<"source">>;
             topicId: z.ZodNumber;
             sessionId: z.ZodString;
             sourceSessionId: z.ZodString;
@@ -945,11 +1218,20 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }, z.core.$strict>;
         messages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             role: z.ZodLiteral<"user">;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    image: "image";
+                    file: "file";
+                }>;
+                id: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>>;
             text: z.ZodString;
             id: z.ZodString;
             seq: z.ZodNumber;
         }, z.core.$strict>, z.ZodObject<{
             role: z.ZodLiteral<"assistant">;
+            renderKey: z.ZodOptional<z.ZodString>;
             text: z.ZodString;
             reasoning: z.ZodNullable<z.ZodString>;
             streaming: z.ZodBoolean;
@@ -963,6 +1245,14 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             seq: z.ZodNumber;
         }, z.core.$strict>, z.ZodObject<{
             role: z.ZodLiteral<"tool">;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    image: "image";
+                    file: "file";
+                }>;
+                id: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>>>;
             name: z.ZodString;
             arguments: z.ZodString;
             result: z.ZodNullable<z.ZodString>;
@@ -1002,12 +1292,12 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             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;
@@ -1038,6 +1328,13 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"topics">;
     topics: z.ZodArray<z.ZodObject<{
+        permission: z.ZodOptional<z.ZodEnum<{
+            "read-only": "read-only";
+            "workspace-write": "workspace-write";
+            "danger-full-access": "danger-full-access";
+        }>>;
+        hosted: z.ZodOptional<z.ZodBoolean>;
+        storage: z.ZodOptional<z.ZodLiteral<"source">>;
         topicId: z.ZodNumber;
         sessionId: z.ZodString;
         sourceSessionId: z.ZodString;
@@ -1165,6 +1462,8 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }>;
         content: z.ZodString;
         truncated: z.ZodBoolean;
+        page: z.ZodDefault<z.ZodNumber>;
+        pageCount: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>;
 }, z.core.$strict>], "kind">;
 export type CiteCiterResponse = z.infer<typeof citeCiterResponseSchema>;