@kirkchinese/dsh-citeciter 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/README.md +5 -3
  2. package/README.zh.md +5 -3
  3. package/lib/client.js +991 -14838
  4. package/lib/index.js +14960 -90
  5. package/lib/{topic-BfAp9KoS.js → topic-DByv84H6.js} +52 -15
  6. package/lib/{typert-common-DXguoziV.js → typert-common-Bvx1k2cq.js} +1 -1
  7. package/lib/typert.host.js +2 -2
  8. package/lib/typert.remote-client.js +1 -1
  9. package/lib/types/citation-mapping.d.ts +17 -0
  10. package/lib/types/client/companion-controller.d.ts +18 -6
  11. package/lib/types/client/components/CitePanel.d.ts +2 -1
  12. package/lib/types/client/prompt.d.ts +7 -0
  13. package/lib/types/client/response-guard.d.ts +1 -1
  14. package/lib/types/client/selection.d.ts +3 -3
  15. package/lib/types/client/types.d.ts +1 -0
  16. package/lib/types/index.d.ts +1 -1
  17. package/lib/types/observer.d.ts +3 -1
  18. package/lib/types/topic-runtime.d.ts +56 -2
  19. package/lib/types/topic.d.ts +61 -3
  20. package/lib/types/typert-common.d.ts +35 -2
  21. package/lib/types/typert.host.d.ts +76 -4
  22. package/package.json +3 -3
package/README.md CHANGED
@@ -9,7 +9,7 @@ A private learning companion for live DeepSeek Harness conversations. Select tex
9
9
  CiteCiter requires Node.js `^22.19.0 || >=24.0.0`, DSH Web `>=0.1.0-rc.7 <0.1.0-rc.8`, and a configured model provider.
10
10
 
11
11
  ```sh
12
- dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.1
12
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.2
13
13
  ```
14
14
 
15
15
  Restart the corresponding DSH Web process and refresh the page after installation or upgrade.
@@ -27,10 +27,12 @@ Restart the corresponding DSH Web process and refresh the page after installatio
27
27
  - **Model-call citations.** Start as soon as an `assistant/message` is committed; there is no need to wait for the full Agent turn.
28
28
  - **Private Topics.** Each submission creates an independent DSH Session under `$DSH_HOME/citeciter/`, outside the ordinary Session list.
29
29
  - **Precise selections.** Visible Markdown selections map back to Host-verifiable source ranges.
30
+ - **Cross-flow selections.** A range spanning reasoning, tools, and body text binds to its final committed assistant call while retaining the complete visible quote in the learning workspace.
30
31
  - **Bound evidence.** `read_source_session` reads committed events from one fixed source Session without exposing its physical log path.
31
32
  - **Open-ended investigation.** The standard read-only `glob` and `grep` tools discover project files and search their contents before `read` opens a known path.
32
33
  - **Read-only operation.** CiteCiter cannot write to the source Session or source workspace.
33
34
  - **Inspectable workflow.** Live reasoning, prompt injections, tool calls, results, and user questions use compact expandable rows inside the learning dock.
35
+ - **Natural follow-ups.** After the first answer, the model may emit three strictly formatted next questions; malformed output creates no shortcuts and is logged silently.
34
36
  - **Native workflow.** The selection popover, resizable learning dock, active/archive Topic navigation, and settings remain inside the DSH programming interface.
35
37
 
36
38
  ## Context modes
@@ -42,7 +44,7 @@ Exact Fork is an advanced mode for a source turn that has already ended. `exact-
42
44
  ## Upgrade from v0.2
43
45
 
44
46
  ```sh
45
- dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.1
47
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.2
46
48
  dsh plugin --profile web list --depth 0
47
49
  ```
48
50
 
@@ -50,7 +52,7 @@ The upgrade does not rewrite source Sessions or import v0.2 Citation Threads. Ex
50
52
 
51
53
  ## Limitations
52
54
 
53
- - A selection must stay inside one committed assistant flow. Streaming fragments and cross-message selections are not supported.
55
+ - A selection must include at least one committed assistant model call. User-only ranges, tool-only ranges, and still-streaming fragments cannot anchor a Citation.
54
56
  - Renderer-generated KaTeX layout and footnote numbers cannot be cited directly because they lack stable source coordinates.
55
57
  - Exact Fork cannot start from an open source turn.
56
58
  - Source-file access depends on the running DSH filesystem service and remains read-only.
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@
9
9
  CiteCiter 需要 Node.js `^22.19.0 || >=24.0.0`、DSH Web `>=0.1.0-rc.7 <0.1.0-rc.8`，以及已经配置的模型提供方。
10
10
 
11
11
  ```sh
12
- dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.1
12
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.2
13
13
  ```
14
14
 
15
15
  安装或升级后，请重启对应的 DSH Web 进程并刷新页面。
@@ -27,10 +27,12 @@ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.1
27
27
  - **模型调用级引用。** `assistant/message` 一经提交即可开始，无需等待整个 Agent 轮次结束。
28
28
  - **私有 Topic。** 每次提交都会在 `$DSH_HOME/citeciter/` 下创建独立 DSH Session，不进入普通 Session 列表。
29
29
  - **精确选区。** 可见 Markdown 选区会映射回 Host 可复验的原文范围。
30
+ - **跨流程选区。** 同时选中思考、工具与正文时，以选区中最后一个已提交模型回答作为可复验锚点，完整可见选区仍保留在学习栏中。
30
31
  - **绑定来源的证据。** `read_source_session` 只读取一个固定来源 Session 的已提交事件，不暴露物理日志路径。
31
32
  - **开放式项目调查。** 标准只读 `glob` 与 `grep` 先发现项目文件并搜索内容，再由 `read` 打开已知路径。
32
33
  - **只读运行。** CiteCiter 不能写入来源 Session 或来源工作区。
33
34
  - **可检查的对话流程。** 实时思考、提示词注入、工具调用、结果和用户提问都在学习栏中以紧凑可展开行显示。
35
+ - **自然续问。** 第一轮回答完成后，模型可按严格格式给出三个后续问题；格式无效时前端不创建快捷入口，只记录日志。
34
36
  - **原生工作流。** 选区浮层、可调宽学习栏、活动/归档 Topic 导航和设置都保留在 DSH 编程界面内。
35
37
 
36
38
  ## 上下文模式
@@ -42,7 +44,7 @@ Exact Fork 是面向已结束来源轮次的高级模式。`exact-when-available
42
44
  ## 从 v0.2 升级
43
45
 
44
46
  ```sh
45
- dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.1
47
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.3.2
46
48
  dsh plugin --profile web list --depth 0
47
49
  ```
48
50
 
@@ -50,7 +52,7 @@ dsh plugin --profile web list --depth 0
50
52
 
51
53
  ## 已知限制
52
54
 
53
- - 选区必须完整位于一个已经提交的助手 flow；暂不支持流式片段和跨消息选区。
55
+ - 选区中必须至少包含一个已经提交的助手模型回答；纯用户消息、纯工具行和仍在流式输出的片段不能作为引用锚点。
54
56
  - 渲染器生成的 KaTeX 排版和脚注编号没有稳定原文坐标，不能直接引用。
55
57
  - Exact Fork 不能从仍在运行的来源轮次开始。
56
58
  - 来源文件访问依赖当前 DSH 文件系统服务，并始终保持只读。