@oatelauser/crosschat 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+本项目的全部显著变更记录于此。格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本遵循 [SemVer](https://semver.org/lang/zh-CN/)。
+
+## [1.0.0] - 2026-10-02
+
+首个公开版本。Windows 一期：本机 Claude Code ↔ Codex CLI 跨会话消息，无守护进程，原生投递。
+
+### 新增
+- 四命令 CLI：`send`（同步投递/自包含引用/轮次计数）、`status`（双侧总览含目录时间）、`install-skills`、`claude`（接收许可包装启动）
+- Claude 侧通道：sessions 注册表发现、named pipe + peerToken 鉴权、peer 协议 v1 帧注入
+- Codex 侧通道：app-server proxy 桥接（ws-over-stdio）、resume→turn/start 投递、busy/locked 等待循环
+- 溯源信封（回复命令自带教学 + 保留字中性化）与 agent 侧 skill（低入侵：题词只写角色）
+- 防乒乓限流（30 条/60s/对端点）、16KiB 单条上限、身份冲突自纠指引
+- 机会式发件箱：忙/锁超时 parked 落盘，任意 send/status 调用入口自动排涝补投
+- daemon 0.160 开窗投递支持（同 daemon 多连接绕过进程级写者锁，实证）
+- 双 bin 过渡别名（crosschat 主 / multichat 曾用名）
+
+### 过程档案
+- 设计决策地图（wayfinder）、实测研究报告 ×4、联调实证 ×2 随仓库公开（已脱敏）
+
+[1.0.0]: https://github.com/Oatelauser/crosschat/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Oatelauser
+
+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.
+
+This project borrows module-level implementations (envelope framing, codex
+app-server transport patterns) from embassy (https://github.com/YuanpingSong/embassy),
+also MIT licensed.
+
+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/README.md

@@ -0,0 +1,244 @@
+<div align="center">
+
+<img src="docs/assets/logo.svg" width="128" alt="crosschat logo"/>
+
+# crosschat
+
+**让本机的 Claude Code 与 Codex CLI 互相对话** —— 无守护进程、原生投递、双向实测。
+
+*曾用名 multichat（`multichat` 命令作为过渡别名保留）*
+
+![CI](https://github.com/Oatelauser/crosschat/actions/workflows/ci.yml/badge.svg) ![version](https://img.shields.io/badge/version-1.0.0-blue) ![license](https://img.shields.io/badge/license-MIT-green) ![node](https://img.shields.io/badge/node-%3E%3D22-339933) ![platform](https://img.shields.io/badge/platform-Windows-blue) ![agents](https://img.shields.io/badge/agents-Claude%20Code%20%C2%B7%20Codex-blueviolet)
+
+</div>
+
+---
+
+## ✨ 为什么用 crosschat
+
+- **🔌 原生投递，零轮询**：消息经 Claude 的 named pipe / Codex 的 App Server daemon 直接注入运行中的会话——接收方像收到一条用户消息一样开始工作，不需要任何轮询或常驻服务
+- **🪶 无守护进程**：整个工具就是一条无状态 CLI。没有后台进程要看护、没有崩溃丢状态、没有端口要占——`send` 就是发消息，`status` 就是看在线
+- **🤖 教学内建，低入侵**：agent 侧装一次 skill，且**每条消息的信封自带回复命令**——照抄即可回话。题词只写角色，不写协议；长对话也不会忘
+- **📮 忙时不丢**：对方正在跑长任务？消息自动进本地发件箱（outbox），对方空闲后任意一次调用自动补投——不需要你重发
+- **🔐 同用户信任边界**：全部通道按 Windows 用户隔离，接收许可只授予 `crosschat claude` 启动的会话——你手敲开的会话不会被外部投递
+- **🧪 每个结论都有实证**：通道可行性、写者锁、daemon 版本行为，全部真机联调验证（见 [📚 更多文档](#-更多文档)）
+
+> 灵感与部分模块实现来自 [embassy](https://github.com/YuanpingSong/embassy)（macOS-only，MIT）——crosschat 是它的 Windows 原生、无守护进程重实现。
+
+## 🧰 环境搭建
+
+| 依赖 | 版本要求 | 说明 |
+|---|---|---|
+| Node.js | ≥ 22 | |
+| Claude Code | 任意近期版 | 接收需 `crosschat claude` 启动（工具自动注入许可） |
+| Codex CLI | ≥ 0.160 推荐 | 0.160 daemon 支持开窗投递；接收需 app-server daemon |
+| OS | Windows（一期） | mac/linux 在路线图 |
+
+```powershell
+git clone https://github.com/Oatelauser/crosschat.git
+cd crosschat
+npm install && npm run build && npm link   # crosschat 上 PATH
+crosschat install-skills                   # 协议教学装到两侧 agent
+```
+
+**Codex daemon**（接收方向必需；从**干净终端**启动——勿在 Claude 会话内启动，否则派生 shell 身份污染）：
+
+```powershell
+codex app-server daemon start    # 重启电脑后需重新执行
+```
+
+## 🚀 快速入门
+
+### 30 秒版：两终端互发一句问候
+
+```powershell
+# 终端 A（claude，能收）
+crosschat claude          # 进入后 /rename alice
+
+# 终端 B（任意终端，人手发）
+crosschat status          # 看到 alice
+crosschat send --to alice --body "你好 alice！"
+# → 终端 A 里几秒后出现这条消息
+```
+
+### 完整剧本：codex 当领导派活给 claude（多任务循环的经典形态）
+
+**任务目标**：codex（领导）命令 claude（工人）在 `D:\workspace\demo` 创建 `notes.txt` 写三行待办，并验收。
+
+**第 1 步 · 左窗启动 claude（接收方先开机；先启动 ≠ 先说话）**
+```
+D:\workspace\demo> crosschat claude
+```
+进入后输入 `/rename worker`，待命。
+
+**第 2 步 · 右窗启动 codex（领导）并贴题词**
+```
+D:\workspace\demo> codex
+```
+```
+你是领导。用 crosschat（先 status 确认名字）给 claude 会话「worker」下发任务：
+在当前目录创建 notes.txt，内容三行：买牛奶、交电费、给妈妈打电话。
+收到完成报告后，亲自打开文件验证内容；通过则回复"验收通过，任务结束"并停止；
+不通过则下发返工任务。
+```
+
+**第 3 步 · 右窗屏幕——任务由 codex 发出**
+```
+● exec: crosschat status
+● exec: crosschat send --to worker --body "任务1：在当前目录创建 notes.txt…"
+● delivered to worker (turn 1)          ← 任务飞进左窗，发起方是 codex
+```
+
+**第 4 步 ·（0.160+ 可跳过）关掉右窗**：旧版 daemon（≤0.157）下收报告需关窗；**0.160+ 开窗也能收**（headless 执行）。
+
+**第 5 步 · 左窗屏幕——claude 收令干活**
+```
+📨 来自另一会话的消息:
+<cross-session-message from-name="codex/01a…" turn="1">
+任务1：在当前目录创建 notes.txt，内容三行…
+回复请运行: crosschat send --conversation mc1_xxx --body "<你的回复>"
+</cross-session-message>
+
+⏺ Write: notes.txt（三行待办）
+⏺ Bash: crosschat send --conversation mc1_xxx --body "已完成：notes.txt 已创建…"
+⏺ delivered (turn 2)                     ← 报告发回给 codex
+```
+
+**第 6 步 · 自动发生**：报告落进 codex 线程 → codex 验证 → 下发下一个/验收结论 → 又出现在左窗。
+
+**第 7 步 · 左窗收到"验收通过，任务结束"——收工**。全程在左窗直播；想看领导的验收细节：开右窗 `codex resume` 翻历史。
+
+## 📋 命令列表
+
+```
+crosschat send --to <名字> --body "<正文>"          # 新消息（名字含空格加引号）
+crosschat send --conversation <ref> --body "<正文>" # 回复（ref 照抄收到的信封）
+echo … | crosschat send --to <名字>                 # 正文走 stdin
+crosschat status [--json]                           # 双侧总览（名字/目录/时间/状态）
+crosschat doctor                                    # 一键环境体检（有 ❌ 时退出码 1）
+crosschat install-skills [--dir <根>]               # 安装/更新 agent skill（幂等）
+crosschat claude [任意 claude 参数…]                 # 带接收许可启动 claude（透传）
+crosschat -v | --version | help                     # 版本 / 帮助
+```
+
+发送输出三种状态：`delivered`（已投递）/ `parked`（对方忙，已入发件箱待补投）/ 错误码（见排障）。
+
+## 📖 对话生命周期（规则总纲）
+
+### 三种发起方式
+
+| 发起者 | 怎么发 | 特性 |
+|---|---|---|
+| **claude** | 会话内 agent 跑 `crosschat send --to <codex 线程名> --body "…"` | 最顺，推荐默认 |
+| **codex** | 会话内 agent 跑 `crosschat send --to <claude 会话名> --body "…"` | 发送随意；回信开窗关窗都能收（daemon 0.160+） |
+| **人** | 任意终端直接 `crosschat send --to <名字> --body "…"` | 身份是 human：**能发、不能被回复**（单向指令） |
+
+第一条消息永远用 `--to`（此刻生成对话引用 reply-ref）；对方名字用 `status` 查。
+
+### 往复规则
+
+1. 收到方看到**信封消息**（`from-name` + `turn="N"` + 回复提示）
+2. 回复 = **逐字照抄回复提示里的命令**，换掉 `<你的回复>`——引用自动轮转，无需记任何历史
+3. 防失控：每对端点 30 条/60 秒限流
+
+### 轮次与终止
+
+信封显示 `turn="N"`；题词给预算（如"10 轮内完成"）；接近预算时 agent 按 skill 准则总结收尾；协议层不强制终止。
+
+## 📡 投递语义矩阵
+
+| 接收方 | 状态 | 行为 |
+|---|---|---|
+| claude（`crosschat claude` 启动） | 窗口开 | ✅ 秒达，会话内出现信封消息 |
+| claude（裸 `claude` 启动） | 任何 | ❌ 无接收许可（换 `crosschat claude` 重启） |
+| codex（daemon ≥0.160） | 窗口开/关 | ✅ 送达（headless 执行；TUI 不实时刷新，翻历史可见） |
+| codex（旧 daemon ≤0.157 / `--no-daemon`） | 窗口开 | ⏳ 等待 120s，关窗瞬间送达；超时 `parked` 入发件箱 |
+| codex | turn 进行中（忙） | 📮 `parked` 入发件箱，对方空闲后任意一次 crosschat 调用自动补投 |
+
+**不对称速记**：claude 收发都随意；codex 收信在 0.160+ 开窗关窗均可，关窗永远是最稳路径。
+
+## 🤝 Agent 兼容性
+
+| Agent | 发送 | 接收 | 实测版本 |
+|---|---|---|---|
+| Claude Code | ✅ | ✅（需 `crosschat claude` 启动） | 2.1.287 |
+| Codex CLI | ✅ | ✅（需 daemon；0.160+ 开窗可收） | 0.159.3 / 0.160.0 |
+| 任意有 shell 的 agent | ✅（装 skill 后） | 🔜 按适配器扩展（GLM 等） | 路线图 |
+
+## 🗺️ 路线图
+
+**已完成（v1.0.0）**
+- [x] Claude ↔ Codex / Claude ↔ Claude / Codex ↔ Codex 双向消息（真机联调验证）
+- [x] 无状态 CLI 四命令 + 自包含会话引用 + 轮次计数
+- [x] 双侧自动发现（含目录/时间标注）、信封自带教学 skill
+- [x] 16KiB 上限、30 条/60s 防乒乓限流、身份冲突自纠指引
+- [x] 忙/锁超时 → 本地发件箱自动补投（outbox）
+- [x] daemon 0.160 开窗投递（实证：同 daemon 多连接绕过写者锁）
+
+**计划中**
+- [ ] 🌐 跨机联邦（SSH，异构 win ↔ linux 互聊）
+- [ ] 🐧 mac / linux 平台适配（平台接缝已预留：PipeTransport / ProcessInspector / PathLayout）
+- [ ] 📦 常驻 broker（忙时持久队列、异步回执、投递状态机——embassy 完整集对齐）
+- [ ] 🖼️ TUI 看板与服务安装（开机自启）
+- [ ] 🤖 新 agent 适配器（GLM 等；有原生唤醒通道则原生，否则论证降级）
+- [ ] 👀 status 标注 TUI 占用线程；专用信箱线程机制化
+
+## 🧯 错误码排障
+
+**使用类**：`NAME_NOT_FOUND`（错误信息列出全部可用名）· `NAME_COLLISION`（重名，`status --json` 看 id）· `MESSAGE_TOO_LARGE`（>16KiB → 落盘发路径）· `RATE_LIMITED`（等待或收尾）· `TARGET_*`/`BODY_*`/`USAGE`（参数错误）
+
+**身份类**：`CALLER_IDENTITY_CONFLICT`（环境双身份残留。临时：命令前缀 `env -u CLAUDE_CODE_MESSAGING_SOCKET -u CLAUDE_CODE_MESSAGING_TOKEN -u CLAUDE_CODE_SESSION_ID`；根治：干净终端重启 daemon）· `CALLER_NOT_IN_CONVERSATION` · `CANNOT_REPLY_TO_HUMAN`（对话由人发起）
+
+**通道类**：`CODEX_PROXY_SPAWN_FAILED`（看 stderr 摘录；通常 daemon 未跑）· `CODEX_THREAD_LOCKED`/`CODEX_THREAD_BUSY_TIMEOUT`（已自动转 `parked` 入发件箱，无需重发）· `OUTBOX_FULL`（每线程 20 条积压上限，等待排涝或人工介入）· `CODEX_APPROVAL_REQUIRED`（**工具永不代答审批**）· `CLAUDE_PIPE_*`/`CODEX_*UNCERTAIN`（写入中途失败状态不明——**勿盲目重发**，先 `status` 核实）
+
+## ⚠️ 边界与限制
+
+单条 ≤16KiB；每对端点 30 条/60s；发件箱每线程 20 条；信任边界=同一 Windows 用户；接收许可仅 `crosschat claude` 启动的会话；重启电脑后需重新 `codex app-server daemon start`。
+
+## ❓ FAQ
+
+**Q：codex 窗口开着收不到？** daemon ≥0.160 开窗也能收（headless，界面不实时刷新）；旧 daemon/`--no-daemon` 下等待或已入发件箱，关窗后自动送达。
+
+**Q：为什么必须 `crosschat claude`？** 它注入跨会话接收许可；裸 `claude` 的会话收不到。
+
+**Q：`codex queue` 能用吗？** 仅当 TUI 附着 daemon（0.160+）时会被消费；旧形态下是黑洞，故 crosschat 不依赖它。
+
+**Q：人能发消息吗？** 能（`--to`），身份 human，单向不能被回复。
+
+**Q：消息历史在哪看？** claude 侧=会话 transcript；codex 侧=开窗 resume 线程。
+
+## 🔧 故障恢复
+
+| 症状 | 动作 |
+|---|---|
+| 任何异常 | 先跑 `crosschat doctor` 一键体检（逐项 ✅/⚠️/❌ 定位） |
+| status 的 codex 段 unavailable | 干净终端 `codex app-server daemon start` |
+| codex 回信撞身份冲突 | 同上（重启 daemon 即根治） |
+| skill 误删/过期 | `crosschat install-skills` |
+| 升级 crosschat 代码后 | `npm run build`（skill 有变再 install-skills） |
+| 消息发出对方没反应 | 先 `status` 确认在线；`parked` 的等对方空闲自动补投；UNCERTAIN 类勿重发先核实 |
+
+## 📚 更多文档
+
+| 文档 | 内容 |
+|---|---|
+| [docs/architecture.md](docs/architecture.md) | **底层原理**：注册表/命名管道/daemon 通道、写者锁本质、信封与自包含引用、完整投递流程图 |
+| [CHANGELOG.md](CHANGELOG.md) | 版本变更记录 |
+| [docs/wayfinder/map.md](docs/wayfinder/map.md) | 设计决策地图（全部拍板过程与依据） |
+| [docs/research/](docs/research/) | 实测研究报告（embassy 源码分析、两侧通道验证、0.160 inject_items 实验） |
+| [docs/drill-reports/](docs/drill-reports/) | 联调实证记录 |
+
+## 🛠️ 开发说明
+
+```powershell
+npm run check                              # lint + build + test
+$env:CROSSCHAT_LIVE='1'; npx vitest run --dir test   # 真机 live 测试
+```
+
+- 目录：`src/claude`（注册表/管道/鉴权）· `src/codex`（proxy/RPC/投递）· `src/commands`（CLI）· `src/platform`（平台接缝）· `src/outbox.ts`（发件箱）· `skills/`（agent 教学）
+- 铭谢：[embassy](https://github.com/YuanpingSong/embassy)（MIT）的信封格式与 codex 传输模式
+- License：[MIT](LICENSE)
+
+---
+
+<div align="center">Made with 🤝 between agents — crosschat 让它们自己对话</div>

package/dist/claude/deliver.js

@@ -0,0 +1,33 @@
+import { getPipeTransport } from '../platform/pipe-transport.js';
+import { MultichatError } from '../errors.js';
+import { encodeAuthLine, encodeUserFrame } from './frame.js';
+import { readPeerToken } from './key-file.js';
+import { defaultClaudeSessionsDir } from './registry.js';
+/**
+ * Deliver one user message to a running Claude session over its messaging
+ * pipe: auth line + user frame, written once, never retried. Transport
+ * failures surface as CLAUDE_PIPE_CONNECT_FAILED (never connected) or
+ * CLAUDE_PIPE_WRITE_UNCERTAIN (failed after the write started).
+ */
+export async function deliverToClaudeSession(session, content, options = {}) {
+    const sessionsDir = options.sessionsDir ?? defaultClaudeSessionsDir();
+    const token = readPeerToken(sessionsDir, session.pid, session.messagingSocketPath);
+    const lines = [encodeAuthLine(token), encodeUserFrame(content)];
+    const transport = options.transport ?? getPipeTransport();
+    try {
+        await transport.sendLines(session.messagingSocketPath, lines);
+    }
+    catch (err) {
+        if (err instanceof MultichatError) {
+            if (err.code === 'PIPE_CONNECT_FAILED') {
+                throw new MultichatError('CLAUDE_PIPE_CONNECT_FAILED', `Cannot connect to the messaging pipe of Claude pid ${session.pid}.`, { cause: err });
+            }
+            if (err.code === 'PIPE_WRITE_UNCERTAIN') {
+                throw new MultichatError('CLAUDE_PIPE_WRITE_UNCERTAIN', `Write to the messaging pipe of Claude pid ${session.pid} failed mid-flight; delivery state unknown.`, { cause: err });
+            }
+        }
+        throw err;
+    }
+    return { status: 'delivered' };
+}
+//# sourceMappingURL=deliver.js.map

package/dist/claude/deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.js","sourceRoot":"","sources":["../../src/claude/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAczD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA6B,EAC7B,OAAe,EACf,UAAiC,EAAE;IAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,wBAAwB,EAAE,CAAC;IACtE,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,EAAE,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACvC,MAAM,IAAI,cAAc,CACtB,4BAA4B,EAC5B,sDAAsD,OAAO,CAAC,GAAG,GAAG,EACpE,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBACxC,MAAM,IAAI,cAAc,CACtB,6BAA6B,EAC7B,6CAA6C,OAAO,CAAC,GAAG,6CAA6C,EACrG,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC"}

package/dist/claude/frame.js

@@ -0,0 +1,16 @@
+import { randomUUID } from 'node:crypto';
+export function encodeUserFrame(content, messageId = randomUUID()) {
+    const frame = {
+        msgV: 1,
+        msg_id: messageId,
+        type: 'user',
+        message: { role: 'user', content },
+        priority: 'next',
+    };
+    return JSON.stringify(frame);
+}
+/** Mandatory first line on Windows pipes (docs/research/claude-windows-pipe.md §3). */
+export function encodeAuthLine(token) {
+    return JSON.stringify({ type: 'auth', token });
+}
+//# sourceMappingURL=frame.js.map

package/dist/claude/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/claude/frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAoB,UAAU,EAAE;IAC/E,MAAM,KAAK,GAAoB;QAC7B,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAClC,QAAQ,EAAE,MAAM;KACjB,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/claude/key-file.js

@@ -0,0 +1,45 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { MultichatError } from '../errors.js';
+import { PIPE_PREFIX } from '../platform/pipe-transport.js';
+/**
+ * Claude Code normalizes the pipe path before hashing: keep the
+ * `\\.\pipe\` prefix, lowercase everything after it
+ * (docs/research/claude-windows-pipe.md §3, verified against live samples).
+ */
+export function normalizePipePath(messagingSocketPath) {
+    if (!messagingSocketPath.startsWith(PIPE_PREFIX)) {
+        throw new MultichatError('CLAUDE_PIPE_PATH_INVALID', `Not a Windows named pipe path: ${JSON.stringify(messagingSocketPath)}`);
+    }
+    return PIPE_PREFIX + messagingSocketPath.slice(PIPE_PREFIX.length).toLowerCase();
+}
+/** Key file name: `<pid>.<sha256(normalized pipe path)>.key`. */
+export function keyFileName(pid, messagingSocketPath) {
+    const digest = createHash('sha256')
+        .update(normalizePipePath(messagingSocketPath), 'utf8')
+        .digest('hex');
+    return `${pid}.${digest}.key`;
+}
+/** Read the peerToken bound to a session's messaging pipe. */
+export function readPeerToken(sessionsDir, pid, messagingSocketPath) {
+    const filePath = join(sessionsDir, keyFileName(pid, messagingSocketPath));
+    let text;
+    try {
+        text = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        throw new MultichatError('CLAUDE_KEY_FILE_MISSING', `Cannot read key file for pid ${pid}: ${filePath}`, { cause: err });
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed.peerToken !== 'string' || parsed.peerToken === '') {
+            throw new Error('peerToken missing or empty');
+        }
+        return parsed.peerToken;
+    }
+    catch (err) {
+        throw new MultichatError('CLAUDE_KEY_FILE_INVALID', `Key file for pid ${pid} has no usable peerToken: ${filePath}`, { cause: err });
+    }
+}
+//# sourceMappingURL=key-file.js.map

package/dist/claude/key-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-file.js","sourceRoot":"","sources":["../../src/claude/key-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,mBAA2B;IAC3D,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,cAAc,CACtB,0BAA0B,EAC1B,kCAAkC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;AACnF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,mBAA2B;IAClE,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC;SAChC,MAAM,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;SACtD,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,GAAG,GAAG,IAAI,MAAM,MAAM,CAAC;AAChC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,GAAW,EACX,mBAA2B;IAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC1E,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CACtB,yBAAyB,EACzB,gCAAgC,GAAG,KAAK,QAAQ,EAAE,EAClD,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QAC3D,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,cAAc,CACtB,yBAAyB,EACzB,oBAAoB,GAAG,6BAA6B,QAAQ,EAAE,EAC9D,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/claude/registry.js

@@ -0,0 +1,79 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { MultichatError } from '../errors.js';
+import { isProcessAlive } from '../platform/process-inspector.js';
+/** Registry kinds crosschat can route to. daemon/daemon-worker are not user sessions. */
+const ROUTABLE_KINDS = new Set(['interactive', 'bg']);
+export function defaultClaudeSessionsDir() {
+    return join(homedir(), '.claude', 'sessions');
+}
+function parseEntry(text) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof value.pid !== 'number' || !Number.isInteger(value.pid))
+        return undefined;
+    if (typeof value.messagingSocketPath !== 'string' || value.messagingSocketPath === '') {
+        return undefined;
+    }
+    return {
+        pid: value.pid,
+        sessionId: typeof value.sessionId === 'string' ? value.sessionId : '',
+        kind: typeof value.kind === 'string' ? value.kind : '',
+        name: typeof value.name === 'string' && value.name !== '' ? value.name : undefined,
+        status: typeof value.status === 'string' ? value.status : 'unknown',
+        cwd: typeof value.cwd === 'string' ? value.cwd : undefined,
+        messagingSocketPath: value.messagingSocketPath,
+    };
+}
+/**
+ * Enumerate routable Claude sessions from the registry: kind interactive/bg
+ * with a live process. Malformed entries are skipped and counted, never thrown.
+ */
+export function listClaudeSessions(dir = defaultClaudeSessionsDir()) {
+    let files;
+    try {
+        files = readdirSync(dir);
+    }
+    catch {
+        return { sessions: [], malformed: 0 };
+    }
+    const sessions = [];
+    let malformed = 0;
+    for (const file of files) {
+        if (!file.endsWith('.json'))
+            continue;
+        let entry;
+        try {
+            entry = parseEntry(readFileSync(join(dir, file), 'utf8'));
+        }
+        catch {
+            entry = undefined;
+        }
+        if (entry === undefined) {
+            malformed += 1;
+            continue;
+        }
+        if (!ROUTABLE_KINDS.has(entry.kind))
+            continue;
+        if (!isProcessAlive(entry.pid))
+            continue;
+        sessions.push(entry);
+    }
+    return { sessions, malformed };
+}
+/** Exact-name lookup over a scan's sessions; throws NAME_COLLISION on duplicates. */
+export function findByExactName(name, sessions) {
+    const matches = sessions.filter((session) => session.name === name);
+    if (matches.length > 1) {
+        const candidates = matches.map((m) => `pid ${m.pid} (${m.sessionId})`).join(', ');
+        throw new MultichatError('NAME_COLLISION', `Multiple Claude sessions are named ${JSON.stringify(name)}: ${candidates}. Address one by pid instead.`);
+    }
+    return matches[0];
+}
+//# sourceMappingURL=registry.js.map

package/dist/claude/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/claude/registry.ts"],"names":[],"mappings":"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"}

package/dist/claude/resolve-exe.js

@@ -0,0 +1,31 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import process from 'node:process';
+import { MultichatError } from '../errors.js';
+export function defaultResolveExeDeps() {
+    return {
+        env: process.env,
+        where: (name) => spawnSync('where.exe', [name], { encoding: 'utf8' }),
+        exists: existsSync,
+    };
+}
+export function resolveClaudeExe(deps = defaultResolveExeDeps()) {
+    const candidates = [];
+    if (deps.env.APPDATA) {
+        candidates.push(join(deps.env.APPDATA, 'npm', 'node_modules', '@anthropic-ai', 'claude-code', 'node_modules', '@anthropic-ai', 'claude-code-win32-x64', 'claude.exe'));
+    }
+    const where = deps.where('claude');
+    if (where.status === 0) {
+        for (const line of where.stdout.split(/\r?\n/)) {
+            if (line.trim().toLowerCase().endsWith('.exe'))
+                candidates.push(line.trim());
+        }
+    }
+    const found = candidates.find((candidate) => deps.exists(candidate));
+    if (found === undefined) {
+        throw new MultichatError('CLAUDE_EXE_NOT_FOUND', `claude executable not found; tried: ${candidates.join(', ')}`);
+    }
+    return found;
+}
+//# sourceMappingURL=resolve-exe.js.map

package/dist/claude/resolve-exe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-exe.js","sourceRoot":"","sources":["../../src/claude/resolve-exe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAe9C,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACrE,MAAM,EAAE,UAAU;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAuB,qBAAqB,EAAE;IAC7E,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,CACb,IAAI,CACF,IAAI,CAAC,GAAG,CAAC,OAAO,EAChB,KAAK,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,YAAY,CACb,CACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,cAAc,CACtB,sBAAsB,EACtB,uCAAuC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}