dsh-reference-anything 0.4.3 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "Reference files, sessions, commands, skills, and historical external AI chats from the DSH @ menu.",
   "icon": "./images/logo-icon.png",
   "license": "MIT",
@@ -15,6 +15,10 @@
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "exports": {
+    "./chat-import-runtime": {
+      "types": "./lib/chat-import-runtime.d.ts",
+      "default": "./lib/chat-import-runtime.js"
+    },
     ".": {
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
@@ -70,11 +74,21 @@
     "opencli-plugin/package.json",
     "cordis.patch.yml",
     "locale/*.json",
+    "images/agents",
+    "release-notes",
     "images/logo.png",
     "images/logo-icon.png",
     "images/logo-mono.png",
     "NOTICE.md",
-    "README.md"
+    "vendor/chat-import-reader/parsers.mjs",
+    "vendor/chat-import-reader/availability-worker.mjs",
+    "vendor/chat-import-reader/parsers.d.mts",
+    "vendor/chat-import-reader/LICENSE*",
+    "vendor/chat-import-reader/README.md",
+    "README.md",
+    "vendor/chat-import-reader/scanners.mjs",
+    "vendor/chat-import-reader/scan-worker.mjs",
+    "vendor/chat-import-reader/upstream-sha256.json"
   ],
   "dsh": {
     "bundle": {
@@ -96,12 +110,19 @@
     }
   },
   "scripts": {
+    "agent:context": "node scripts/agent/workflow.mjs context",
+    "agent:sync": "node scripts/agent/workflow.mjs sync",
+    "agent:verify": "node scripts/agent/workflow.mjs verify",
+    "agent:release:prepare": "node scripts/agent/workflow.mjs release-prepare",
+    "agent:release:gate": "node scripts/agent/workflow.mjs release-gate",
+    "agent:retro": "node scripts/agent/workflow.mjs retro",
     "build": "node build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "check": "npm run typecheck && npm run test && npm run build",
     "prepublishOnly": "npm run check",
-    "prepare": "node build.mjs"
+    "prepare": "node build.mjs",
+    "vendor:sync": "node scripts/vendor-chat-import-reader.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
@@ -126,6 +147,7 @@
     "@deepseek-ai/dsh-session-reference": ">=0.2.0-rc.2",
     "@deepseek-ai/dsh-settings": ">=0.2.0-rc.2",
     "@deepseek-ai/dsh-storage-domain": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-system-prompt": ">=0.2.0-rc.2",
     "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
     "@deepseek-ai/dsh-typert-protocol": ">=0.2.0-rc.2",
     "@deepseek-ai/dsh-typert-registry": ">=0.2.0-rc.2",
@@ -180,13 +202,17 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
+    "@jackwener/opencli": "2.0.0",
     "@lobehub/icons": "^5.16.0",
+    "fflate": "0.8.2",
     "react-markdown": "^10.1.0",
     "sortablejs": "^1.15.7",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis-plugin-include": "1.0.9",
+    "@deepseek-ai/cordis-plugin-loader": "1.0.5",
     "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
     "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.2",
     "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
@@ -204,6 +230,7 @@
     "@deepseek-ai/dsh-file-reference": "0.2.0-rc.2",
     "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
     "@deepseek-ai/dsh-output-retention": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-plugin-manager": "0.2.0-rc.2",
     "@deepseek-ai/dsh-session": "0.2.0-rc.2",
     "@deepseek-ai/dsh-session-reference": "0.2.0-rc.2",
     "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
@@ -215,7 +242,6 @@
     "@deepseek-ai/dsh-typert-registry": "0.2.0-rc.2",
     "@deepseek-ai/dsh-util-code-language": "0.2.0-rc.2",
     "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.2",
-    "@jackwener/opencli": "1.8.6",
     "@shikijs/langs": "4.3.1",
     "@types/node": "^22.20.1",
     "@types/react": "^18.2.0",

package/release-notes/0.4.4/features.json

@@ -0,0 +1,36 @@
+[
+  {
+    "title": "引用，或导入后继续",
+    "description": "找到本地 Agent 历史会话后，按 Enter 引用到当前对话；想继续之前的工作，按 Tab 打开操作菜单，确认导入完整历史后在 DSH 中继续。",
+    "media": "demos/agent-import.gif",
+    "alt": "引用，或导入后继续操作演示"
+  },
+  {
+    "title": "升级 Chat Import，启用导入与交接",
+    "description": "如果 Chat Import 版本缺少导入或摘要接口，菜单和设置会提示升级。点击升级按钮，安装完成后按提示重启 DSH。演示中的版本号与执行结果为示例。",
+    "media": "demos/chat-import-upgrade.gif",
+    "alt": "升级 Chat Import，启用导入与交接操作演示"
+  },
+  {
+    "title": "本地插件，也能直接引用",
+    "description": "输入 @plugin: 查看本地插件及其状态，继续输入名称筛选。按 Enter 将插件目录插入为引用，让 Agent 基于目录检查配置和实现。",
+    "media": "demos/local-plugins.gif",
+    "alt": "本地插件，也能直接引用操作演示"
+  },
+  {
+    "title": "用自己的快捷词找到需要的来源",
+    "description": "在设置中自定义快捷词，多个词用逗号分隔。多个来源使用同一个词时，可以一起搜索；用 codex 等具体来源快捷词，则能精确限定范围。",
+    "media": "demos/shortcuts.gif",
+    "alt": "用自己的快捷词找到需要的来源操作演示"
+  },
+  {
+    "title": "Tab 浏览目录，Enter 引用目录",
+    "description": "在 @ 文件菜单中，按 Tab 进入目录继续浏览，按 Enter 引用选中的目录。引用保留文件夹图标与目录路径，方便辨认交给 Agent 的内容。",
+    "media": "demos/folders.gif",
+    "alt": "Tab 浏览目录，Enter 引用目录操作演示"
+  },
+  {
+    "title": "未来更新预告",
+    "description": "未来计划带来：\n\n1. 不依赖 OpenCLI 的静默网页端对话同步\n2. 更强大的会话搜索\n3. 更实用的 @云盘权限\n4. @电脑窗口功能\n\n这个插件靠用爱发电持续维护。如果它对你有帮助，欢迎到 GitHub 点一颗 Star 支持！也欢迎有时间、有能力的朋友提交 Issue，反馈问题和建议，或通过 PR 一起完善插件。感谢每一份支持。\n\n[前往 GitHub · Star / Issue / PR](https://github.com/Chael-Chael/dsh-reference-anything)"
+  }
+]

package/release-notes/0.5.0/features.json

@@ -0,0 +1,65 @@
+[
+  {
+    "title": "把历史对话直接“搬”进 DSH，无缝接着聊",
+    "description": "以前想接着别的本地会话继续聊，要么得来回复制粘贴聊天记录，要么只能把旧对话当成静态背景资料。\n\n现在，在 **@** 菜单里找到本地历史会话，你有两种方式处理它：\n- **只当参考资料（按 **Enter**）**：直接引用该会话；\n- **接着往下聊（按 **Tab**）**：在弹出的菜单中选择**导入**并确认，就能把整段历史记录直接搬进 DSH，顺着之前的上下文继续对话！（如果觉得每次确认太麻烦，也可以在设置中关闭二次确认，一步到位）\n\n> 💡 **提示**：使用导入功能需安装并启用 **dsh-chat-import**（0.26.1 或更高兼容版本）。",
+    "media": "demos/agent-import.gif",
+    "alt": "Enter 引用会话，Tab 打开操作菜单，确认后展示模拟导入的历史；使用虚构数据。",
+    "en": {
+      "title": "Import Past Conversations into DSH and Pick Up Where You Left Off",
+      "description": "Want to continue an existing local session without copying and pasting chat logs or treating old threads purely as static context?\n\nNow, when you find a local session in the **@** menu, you have two ways to use it:\n- **Reference as context (**Enter**)**: Insert the session directly as a reference;\n- **Import and continue chatting (**Tab**)**: Open the action menu, select **Import**, and confirm to bring the entire conversation history into DSH and keep chatting seamlessly! (Prefer a faster workflow? You can disable the confirmation prompt in Settings.)\n\n> 💡 **Note**: Importing requires **dsh-chat-import** v0.26.1 or a compatible newer version to be installed and enabled.",
+      "alt": "Press Enter to reference a session, or Tab to open the action menu and import history; uses mock data."
+    }
+  },
+  {
+    "title": "菜单内一键升级配套插件，不用手动折腾",
+    "description": "如果提示 **dsh-chat-import** 版本太旧、用不了“对话导入”或“交接摘要”，不用自己再去后台找安装包手动更新了。\n\n直接在菜单里点击**升级提示**，即可一键完成更新（需升级至 0.26.1 或更高兼容版本）。升级后如果弹出重启提示，重启一下 DSH 即可生效。",
+    "media": "demos/chat-import-upgrade.gif",
+    "alt": "在菜单中升级 dsh-chat-import，并在设置中查看模拟的重启提示。",
+    "en": {
+      "title": "One-Click Upgrade for dsh-chat-import Right from the Menu",
+      "description": "If an outdated version of **dsh-chat-import** prevents you from using chat import or handoff summaries, you no longer need to update it manually.\n\nSimply click the **upgrade prompt** right inside the menu to update to v0.26.1 or later. If prompted after the upgrade, restart DSH to apply the changes.",
+      "alt": "Upgrade dsh-chat-import from the menu and view the simulated restart prompt in settings."
+    }
+  },
+  {
+    "title": "输入 @plugin:，直接让 Agent 帮你检查本地插件",
+    "description": "插件报错想让 Agent 帮忙排查，或者想研究某个插件的源码？以前还得自己去电脑深层目录里翻找插件的安装路径，非常劝退。\n\n现在只需输入 **@plugin:**，搜索插件名称并按 **Enter**，就能直接把该插件的本地目录喂给 Agent（支持当前 DSH 环境中已安装的所有插件）。",
+    "media": "demos/local-plugins.gif",
+    "alt": "在 @plugin: 菜单筛选本地插件，按 Enter 插入插件目录引用。",
+    "en": {
+      "title": "Type @plugin: to Reference Installed Plugins Directly",
+      "description": "Want your Agent to troubleshoot a plugin issue or inspect its source code? Digging through deep system folders just to find the installation path is a hassle.\n\nNow you can simply type **@plugin:**, search for the plugin name, and press **Enter** to pass its installation directory straight to the Agent (supports all plugins currently installed in your DSH environment).",
+      "alt": "Filter local plugins in the @plugin: menu and press Enter to insert the plugin directory reference."
+    }
+  },
+  {
+    "title": "自定义快捷词，直接缩小搜索范围，不用手动翻找",
+    "description": "**@** 菜单里东西太多，想找历史对话时还得在一堆文件、目录和不同来源里手动翻找？\n\n现在你可以给各个对话来源设置**专属快捷词**（支持设置多个，用英文逗号分隔），输入时直接按类别过滤，快速锁定搜索范围：\n- **按分类合并搜**：比如忘了具体在哪聊过，可以给“本地 Agent”和“网页对话”都加上同一个快捷词（如 **chat**），输入 **@chat:** 就能把搜索范围直接缩小到这两类对话中；\n- **按来源精准搜**：明确只想找某一个来源时，直接输入它的专属快捷词（比如 **@codex:**），即可一步到位只搜 Codex。",
+    "media": "demos/shortcuts.gif",
+    "alt": "在设置中配置共享快捷词，再用共享词和具体来源词搜索会话。",
+    "en": {
+      "title": "Custom Shortcuts to Narrow Down Your Search Scope Instantly",
+      "description": "Tired of scrolling through a cluttered **@** menu full of files, folders, and different sources just to find a past conversation?\n\nYou can now assign **custom shortcuts** to different chat sources in Settings (multiple shortcuts can be separated by commas), allowing you to filter by category and narrow down your search scope right as you type:\n- **Search across a combined group**: Not sure where a conversation happened? Assign the same shortcut (e.g., **chat**) to both Local Agents and Web Chats, then type **@chat:** to narrow your search exclusively to those sources;\n- **Target a specific source**: When you know exactly where to look, use a dedicated shortcut like **@codex:** to filter exclusively for Codex sessions.",
+      "alt": "Configure shared shortcuts in settings, then search sessions using both shared and source-specific shortcuts."
+    }
+  },
+  {
+    "title": "不用死记路径，像逛文件夹一样找到目录并引用",
+    "description": "想引用某个深层文件夹，但记不住完整路径、也不想手打？\n\n现在 **@** 文件菜单支持直接层层浏览了：\n- **进入子目录**：选中文件夹后按 **Tab** 键；\n- **返回上一级**：点击菜单顶部的导航栏；\n- **确认引用**：找到目标文件夹后按 **Enter**，一键插入到当前对话中。",
+    "media": "demos/folders.gif",
+    "alt": "在文件菜单按 Tab 进入子目录，再返回并按 Enter 引用目录。",
+    "en": {
+      "title": "Browse Folders Directly in the @ Menu — No Need to Type Full Paths",
+      "description": "Want to reference a deeply nested folder without memorizing or typing out its full path?\n\nYou can now navigate folder hierarchies directly inside the **@** file menu:\n- **Open subfolder**: Select a folder and press **Tab** to step inside;\n- **Go back**: Use the breadcrumb navigation bar at the top of the menu;\n- **Insert reference**: Press **Enter** on your target folder to insert it directly into your chat.",
+      "alt": "Press Tab in the file menu to enter subdirectories, navigate back, and press Enter to reference a folder."
+    }
+  },
+  {
+    "title": "未来更新预告",
+    "description": "接下来我们还计划带来这些实用功能，敬请期待：\n\n1. **更省心的网页端对话同步**：后台静默同步网页聊天记录，不再需要额外安装和折腾 OpenCLI\n2. **更强大的会话搜索**：找历史记录更准、更快\n3. **更实用的 **@云盘** 权限支持**：打通更多云端文件引用场景\n4. **全新的 **@电脑窗口** 功能**：不用截图，直接让 AI 读取你当前打开的软件窗口\n\n---\n\n❤️ **写在最后**\n\n这个插件一直靠“用爱发电”持续维护。如果它对你有帮助，欢迎到 [GitHub](https://github.com/Chael-Chael/dsh-reference-anything) 点一颗 **Star ⭐** 支持！平时遇到任何问题或有新点子，随时欢迎提交 Issue 反馈；也特别欢迎有时间、有能力的朋友通过 PR 一起完善插件。感谢每一份支持！",
+    "en": {
+      "title": "What's Next",
+      "description": "Here is what we are planning for upcoming releases:\n\n1. **Zero-Config Web Chat Sync**: Silent background syncing for web conversations — no OpenCLI setup required\n2. **More Powerful Session Search**: Faster and more accurate history lookup\n3. **Enhanced **@CloudDrive** Permissions**: Broader and more practical cloud file referencing\n4. ****@Window** Context**: Reference active desktop application windows directly without taking screenshots\n\n---\n\n❤️ **Support the Project**\n\nThis plugin is a labor of love maintained in our spare time. If it saves you time and makes your workflow smoother, please consider giving us a **Star ⭐ on [GitHub](https://github.com/Chael-Chael/dsh-reference-anything)**! Feel free to open an Issue if you run into bugs or have feature ideas, and PRs are always welcome if you'd like to help build and improve the plugin together. Thank you for all your support!"
+    }
+  }
+]

package/release-notes/README.md

@@ -0,0 +1,36 @@
+# 新功能介绍卡片
+
+每个版本使用一个与 `package.json` 版本号完全一致的目录（不带 `v`）：
+
+```text
+release-notes/
+  0.4.4/
+    features.json
+    files.png
+    commands.png
+```
+
+`features.json` 是按展示顺序排列的卡片数组。每张卡片包含：
+
+```json
+[
+  {
+    "title": "新功能标题",
+    "description": "介绍这个功能，以及用户如何使用它。",
+    "media": "demo.gif",
+    "alt": "动画中展示的操作"
+  }
+]
+```
+
+图片支持 PNG、JPEG、WebP 和 GIF；路径相对于该版本目录，不可指向目录外。介绍支持 Markdown 段落、列表和链接；链接在新窗口打开。标题和介绍必填；纯文字预告可以省略 media 和 alt，提供图片时必须填写 alt。将预告放在数组最后，即作为最后一页展示。
+
+执行 `npm run build` 后，配置和素材会内嵌到插件客户端，离线也可查看；修改内容后需要重新构建并重载 DSH。请压缩大 GIF，避免增加客户端加载时间。新增版本只需新增目录和内容，不需要修改卡片组件。
+
+卡片可增加 `en: { title, description, alt }` 保存英文原文，媒体共用。默认字段为中文；卡片跟随 DSH 语言设置即时切换，其他语言使用英文，旧版未配置英文的卡片保留原文。GIF 画面内的文字不会自动翻译。
+
+点击菜单项打开介绍后，用右下角“上一个／下一个”切换；关闭弹窗不会隐藏菜单项，只有点击菜单行的叉号才会屏蔽该版本。没有本地卡片配置的版本回退到原来的更新日志。未安装的新版本若尚未包含在本地插件中，也使用远端日志。
+
+每个已安装版本首次进入“引用万物（dsh-reference-anything）”插件的具体设置页面时，会自动展示一次本次更新介绍；仅打开设置窗口或其他设置页不会触发。展示记录单独保存在本地存储中，与菜单入口的叉号互不影响；检测到远端新版本不会触发，安装后版本变化才会再次展示。首次启用此机制时，当前版本也会展示一次。本地存储不可用时，只能保证本次运行内不重复展示。
+
+0.4.4 的初始卡片复用了仓库已有的文件、命令菜单示意图，可直接替换为实际新功能截图或 GIF。

package/vendor/chat-import-reader/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Nwflower
+Copyright (c) 2026 Scarlett
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/chat-import-reader/LICENSE.fzstd

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Arjun Barrett
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/chat-import-reader/README.md

@@ -0,0 +1,48 @@
+# Bundled conversation scanners and readers
+
+Derived from [dsh-chat-import](https://github.com/Nwflower/dsh-chat-import), npm
+0.26.1 (MIT). `upstream-sha256.json` records the exact version and source hashes.
+Both generated bundles include fzstd (MIT); `LICENSE` and `LICENSE.fzstd` ship
+with the package. Upstream paths in comments are not runtime dependencies.
+
+`parsers.mjs` exposes preview-based text/image reading and default roots.
+`scanners.mjs` reuses all upstream source descriptors and SQLite summary readers.
+The scan entry provides filesystem-only access and runs in `scan-worker.mjs`,
+without plugin registration or session mutations. The host caches metadata for
+30 seconds; missing paths are empty, while permission/database errors are warnings.
+Import status is not inferred locally: Reference Anything asks the optional
+Chat Import API separately. Import and summaries also remain API operations.
+
+Local patches expose preview content, preserve Trae message parts, export the
+upstream database-summary table, and replace a dynamic Trae scanner import with
+a static named import so mutation code can be removed by tree shaking.
+The generator rejects leaked mutation code and changed patch anchors.
+Antigravity IDE typed tool results (directory/file reads, code actions,
+subagents, commands and searches) are matched by tool name rather than discarded
+as missing background output; GENERIC results keep their existing handling.
+Async sidecar reports only supplement GENERIC results, never replace typed output.
+Hermes SQLite and JSONL reads preserve tool-only assistant messages, OpenAI-style
+function calls, and role=tool results. Results are associated by call ID, including
+parallel calls; string arguments and result text remain unchanged.
+
+## Update from upstream
+
+1. Download/build the desired upstream version in a separate directory (or use
+   an installed npm package directory). Do not overwrite the running Desktop plugin.
+2. Run `npm run vendor:sync -- <built-dsh-chat-import-directory>` from this repository.
+   This regenerates both bundles and their shared version/hash manifest. Normal
+   builds never download upstream or inspect another installed plugin.
+3. Review source/version/license changes, then run `npm run agent:verify` and
+   test the Web profile with Chat Import disabled and enabled. The catalog test
+   detects new upstream formats that need settings/icon/type support here.
+4. Ship the verified snapshot in a new Reference Anything release. Users receive
+   upstream changes when updating Reference Anything, not automatically at runtime.
+
+Parsing a reference may read its whole source before returning a page. Images
+require recoverable bytes or a valid attachment; unavailable images are reported.
+
+The structured read projection numbers body messages independently of tools,
+links tool records and images to those numbers, and hashes normalized source
+content before applying presentation budgets. The host adds original-file
+fingerprints/version checks. This projection is used for automatic send-time
+previews and numeric read/search/image calls; it retains no parsed-body cache.

package/vendor/chat-import-reader/availability-worker.mjs

@@ -0,0 +1,114 @@
+import { parentPort } from 'node:worker_threads'
+import { readFile, readdir, stat } from 'node:fs/promises'
+import { join, resolve } from 'node:path'
+import { homedir } from 'node:os'
+import { readConversation } from './parsers.mjs'
+const channel = parentPort || { on: (...args) => process.on(...args), postMessage: value => process.send(value) }
+if (!parentPort) process.on('disconnect', () => process.exit(0))
+
+// Parsing stays off the picker thread. Only states and file fingerprints cross back.
+channel.on('message', async ({ id, target }) => {
+  const dependencies = new Map()
+  const inspect = async path => {
+    try {
+      const s = await stat(path)
+      dependencies.set(path, `${s.size}:${s.mtimeMs}:${s.ctimeMs}`)
+      return { type: s.isDirectory() ? 'directory' : 'file', size: s.size, mtimeMs: s.mtimeMs }
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error
+      dependencies.set(path, 'missing')
+      return undefined
+    }
+  }
+  const fs = {
+    resolve: async path => ({ displayPath: resolve(path) }),
+    processPath: value => value.displayPath,
+    stat: async value => inspect(value.displayPath),
+    readText: async value => {
+      const info = await inspect(value.displayPath)
+      // shortcut: large sources stay unknown; use streaming probes before raising this background budget.
+      if (info?.size > 8 * 1024 * 1024) throw new Error('Background validation budget exceeded')
+      const raw = await readFile(value.displayPath, 'utf8')
+      // A tolerant converter may skip broken lines; that must never prove emptiness.
+      if (/\.jsonl$/i.test(value.displayPath)) for (const line of raw.split(/\r?\n/)) if (line.trim()) JSON.parse(line)
+      return raw
+    },
+    listDir: async value => {
+      await inspect(value.displayPath)
+      return (await readdir(value.displayPath, { withFileTypes: true })).map(e => ({
+        name: e.name, type: e.isDirectory() ? 'directory' : 'file', target: { displayPath: join(value.displayPath, e.name) },
+      }))
+    },
+  }
+  let state = 'unknown'
+  try {
+    const info = await inspect(target.path)
+    if (!info || (info.type === 'file' && info.size === 0)) state = 'empty'
+    else if (target.format === 'claude' && /\.json$/i.test(target.path)) {
+      const meta = JSON.parse(await fs.readText({ displayPath: target.path }))
+      if (meta.cliSessionId && !meta.messages) {
+        // Match the exact CLI identity; never substitute another chat in the project.
+        const root = join(homedir(), '.claude', 'projects')
+        let found = false
+        const walk = async dir => {
+          await inspect(dir)
+          for (const e of await readdir(dir, { withFileTypes: true })) {
+            if (e.isDirectory()) await walk(join(dir, e.name))
+            else if (e.name === `${meta.cliSessionId}.jsonl`) found = true
+          }
+        }
+        if (await inspect(root)) await walk(root)
+        state = found ? 'unknown' : 'empty'
+      }
+    } else {
+      if (info.type === 'directory' && ['grokbuild', 'vibe', 'kimi'].includes(target.format)) {
+        const names = target.format === 'grokbuild' ? ['chat_history.jsonl']
+          : target.format === 'vibe' ? ['messages.jsonl'] : ['wire.jsonl', 'agents/main/wire.jsonl']
+        const bodies = await Promise.all(names.map(name => inspect(join(target.path, name))))
+        if (bodies.every(body => !body || body.size === 0)) {
+          channel.postMessage({ id, state: 'empty', dependencies: [...dependencies] })
+          return
+        }
+      }
+      if (/\.(?:db|vscdb)$/i.test(target.path)) {
+        await inspect(target.path + '-wal')
+        await inspect(target.path + '-shm')
+        const schemas = {
+          opencode: ['session', 'message'], mimocode: ['session', 'message'], kilocode: ['session', 'message'],
+          teleagent: ['session', 'message'], zcode: ['session', 'message'],
+          hermes: ['sessions', 'messages'], goose: ['sessions', 'messages'], crush: ['sessions', 'messages'],
+        }
+        let schema = schemas[target.format]
+        if (schema) {
+          const { DatabaseSync } = await import('node:sqlite')
+          const db = new DatabaseSync(target.path, { readOnly: true })
+          try {
+            const tables = new Set(db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all().map(r => r.name))
+            if (schema[0] === 'session' && tables.has('session_v2')) schema = ['session_v2', 'session_message']
+            if (tables.has(schema[0]) && tables.has(schema[1])
+              && db.prepare(`SELECT 1 FROM ${schema[0]} WHERE id = ? LIMIT 1`).get(target.sessionId)
+              && !db.prepare(`SELECT 1 FROM ${schema[1]} WHERE session_id = ? LIMIT 1`).get(target.sessionId)) {
+              channel.postMessage({ id, state: 'empty', dependencies: [...dependencies] })
+              return
+            }
+          } finally { db.close() }
+        }
+      }
+      if (target.format === 'chatgpt') {
+        const exported = JSON.parse(await fs.readText({ displayPath: target.path }))
+        const chat = Array.isArray(exported) ? exported.find(c => c.id === target.sessionId) : null
+        if (chat?.mapping && Object.values(chat.mapping).every(node => node && !node.message)) {
+          channel.postMessage({ id, state: 'empty', dependencies: [...dependencies] })
+          return
+        }
+      }
+      state = await readConversation(fs, { ...target, limit: 1, detail: 'full', probe: true })
+      if (state === 'unknown' && ['pi', 'codex', 'openclaw', 'hermes', 'dsh', 'dsh4'].includes(target.format) && info.type === 'file' && !/\.(db|vscdb|zstd)$/i.test(target.path)) {
+        const records = (await fs.readText({ displayPath: target.path })).split(/\r?\n/).filter(line => line.trim()).map(line => JSON.parse(line))
+        const allowed = target.format === 'codex' ? ['session_meta'] : ['session', 'session_info', 'session/title']
+        if (records.length && records.every(r => allowed.includes(r.type))) state = 'empty'
+      }
+    }
+  } catch { state = 'unknown' }
+  channel.postMessage({ id, state, dependencies: [...dependencies] })
+})

package/vendor/chat-import-reader/parsers.d.mts

@@ -0,0 +1,6 @@
+export function defaultRoots(): Record<string, string | string[] | null>
+export function readConversation(fs: unknown, input: {
+  format: string; path: string; sessionId: string; limit: number;
+  before?: number; revision?: string; detail: 'summary' | 'full';
+  probe?: boolean; structured?: boolean;
+}, signal?: AbortSignal): Promise<unknown>