@kirkchinese/dsh-citeciter 0.8.1 → 0.8.2

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

@@ -1,4 +1,4 @@
-import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-0LcFDvI5.js";
+import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-BtuUBRbP.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-0LcFDvI5.js";
-import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-DxE1_Bn_.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-BtuUBRbP.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-BMA9IB7p.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-DxE1_Bn_.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-BMA9IB7p.js";
 //#region lib/types/typert.remote-client.js
 /** Browser contribution mounted by the CiteCiter Client fiber. */
 const TYPERT_REMOTE = {

package/lib/types/observer.d.ts

@@ -35,11 +35,19 @@ export type SourceEvidenceEvent = JsonValue;
 /** Complete bounded source-read payload recorded as the Topic tool result. */
 export interface SourceReadResult {
     readonly sourceSessionId: string;
+    /** Highest sequence in the entire readable snapshot, independent of request bounds. */
+    readonly sourceMaxSeq: number | null;
     readonly requestedFromSeq: number;
     readonly requestedThroughSeq: number | null;
+    /** Last scanned sequence; filtered records can advance this without adding evidence. */
     readonly capturedThroughSeq: number | null;
+    /** Legacy upper-bound marker; may precede fromSeq and is not the source horizon. */
     readonly availableThroughSeq: number | null;
+    /** A byte-budget stop within the requested range, not a source exhaustion flag. */
     readonly truncated: boolean;
+    readonly hasMore: boolean;
+    /** First unscanned sequence at or after fromSeq, including beyond a requested range cap. */
+    readonly nextFromSeq: number | null;
     readonly bytesUsed: number;
     readonly events: readonly SourceEvidenceEvent[];
 }
@@ -68,5 +76,5 @@ export declare function resolveToolEvidence(source: ObserverSourceSnapshot, rawC
  * @returns verified evidence with document offsets in its entry.
  */
 export declare function resolveDocumentEvidence(content: string, rawClaim: DocumentEvidenceClaim): ValidatedDocumentEvidence;
-/** Format one seq range without exposing chunks or exceeding the event-array byte budget. */
+/** Format a range plus the readable snapshot horizon and cursor, without exposing chunks or exceeding the event-array byte budget. */
 export declare function formatSourceSessionRead(source: ObserverSourceSnapshot, options: SourceReadOptions): SourceReadResult;

package/lib/types/source-read-tool.d.ts

@@ -0,0 +1,14 @@
+import { type ObserverSourceSnapshot } from './observer.ts';
+export declare const SOURCE_READ_SECTION_NAME = "@kirkchinese/dsh-citeciter:source-read";
+/** Describe the actual readable snapshot without injecting citation metadata or unsent attachments. */
+export declare function sourceReadPrompt(frozen: boolean): string;
+/**
+ * Build the source-read contract independently of Session ownership and UI.
+ * @param options - an authorized snapshot reader, reasoning preference and immutable-prefix flag.
+ * @returns a native tool with explicit snapshot, range and continuation semantics.
+ */
+export declare function createSourceReadTool(options: {
+    readonly read: (signal: AbortSignal) => Promise<ObserverSourceSnapshot>;
+    readonly includeReasoning: () => boolean;
+    readonly frozen: boolean;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;

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

@@ -0,0 +1,4 @@
+/** Shared final-answer control protocol, parsed into editable question shortcuts by the client. */
+export declare const FIRST_ANSWER_FOLLOWUPS = "After completing the first user question in this Topic, append three concise, distinct questions the user may naturally ask next, in the user's language. Put them only at the end of that first final answer, not in intermediate tool steps or later replies. Each question must deepen understanding of the answer, be at most 160 characters, and avoid unsolicited source changes or workflow actions. The UI turns them into editable drafts; never answer or send them automatically. Emit a JSON array inside this exact block, without a code fence or prose after it:\n<citeciter-next-questions>\n[\"\u95EE\u9898\u4E00\uFF1F\",\"\u95EE\u9898\u4E8C\uFF1F\",\"\u95EE\u9898\u4E09\uFF1F\"]\n</citeciter-next-questions>";
+/** Compose native Topic instructions without importing legacy read-only policy or hidden citation content. */
+export declare function composeHostedTopicPrompt(custom: string | undefined, followups: boolean): string;

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

@@ -363,7 +363,8 @@ export declare class TopicRuntime {
     private blackboardApplyTool;
     private readDocumentTool;
     private searchDocumentTool;
-    private sourceTool;
+    /** Share source-read instructions and contract across native and legacy Topic runtimes. */
+    private registerSourceTool;
     private ensureHandle;
     private disposeLateHandle;
     /** Resolve only after the accepted question is present in the durable model-input log. */

package/lib/{update-0LcFDvI5.js → update-BtuUBRbP.js}

@@ -670,7 +670,8 @@ const topicMetadataFields = {
 	updatedAt: z.number().int().nonnegative(),
 	archivedAt: z.number().int().nonnegative().nullable(),
 	sourceAvailable: z.boolean(),
-	observedThroughSeq: z.number().int().nonnegative().nullable().optional()
+	/** Cursor from this Topic's last source read, never the source horizon or a permission boundary. */
+	observedThroughSeq: z.number().int().nonnegative().nullable().optional().describe("Last source-read scan cursor; not the source horizon or an access limit.")
 };
 /** Canonical Topic metadata committed by the current runtime. */
 const topicMetadataSchema = z.object({
@@ -735,7 +736,8 @@ const topicSummarySchema = z.object({
 	archived: z.boolean(),
 	running: z.boolean(),
 	sourceAvailable: z.boolean(),
-	observedThroughSeq: z.number().int().nonnegative().nullable(),
+	/** Cursor from this Topic's last source read, never the source horizon or a permission boundary. */
+	observedThroughSeq: z.number().int().nonnegative().nullable().describe("Last source-read scan cursor; not the source horizon or an access limit."),
 	modelConfig: modelConfigSchema
 }).strict();
 const messageAttachmentSchema = z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirkchinese/dsh-citeciter",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Source-aware native DSH Topics with manual drafts, permissions, visual boards and learning cards",
   "keywords": [
     "deepseek-harness",
@@ -83,17 +83,6 @@
     "cordis.patch.yml",
     "README.zh.md"
   ],
-  "scripts": {
-    "build": "npm run build:lib && npm run build:bundle",
-    "prebuild:lib": "node scripts/clean-types.mjs",
-    "build:lib": "tsc -p tsconfig.host.json && tsc -p tsconfig.client.json",
-    "prebuild:bundle": "node scripts/clean-bundle.mjs",
-    "build:bundle": "tsdown --env.DSH_BUILD_FACE client",
-    "postbuild:bundle": "node scripts/normalize-bundle.mjs",
-    "prepack": "npm run build",
-    "dev": "npm run build && node dev/watch.mjs",
-    "typecheck": "tsc -p tsconfig.host.json --noEmit && tsc -p tsconfig.client.json --noEmit"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
@@ -189,5 +178,15 @@
     "@deepseek-ai/dsh-util-values": "0.1.5-rc.1",
     "html-to-image": "1.11.13",
     "katex": "^0.18.4"
+  },
+  "scripts": {
+    "build": "npm run build:lib && npm run build:bundle",
+    "prebuild:lib": "node scripts/clean-types.mjs",
+    "build:lib": "tsc -p tsconfig.host.json && tsc -p tsconfig.client.json",
+    "prebuild:bundle": "node scripts/clean-bundle.mjs",
+    "build:bundle": "tsdown --env.DSH_BUILD_FACE client",
+    "postbuild:bundle": "node scripts/normalize-bundle.mjs",
+    "dev": "npm run build && node dev/watch.mjs",
+    "typecheck": "tsc -p tsconfig.host.json --noEmit && tsc -p tsconfig.client.json --noEmit"
   }
-}
+}