pi-wechat-session-hub 0.1.0 → 0.1.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.
@@ -44,7 +44,7 @@ Pi TUI: /wx start|status|stop|restart|autostart
44
44
  - `/wx start` 启动独立 daemon; `/wx status|stop|restart` 控制服务. `/wx stop` 需要 TUI 二次确认.
45
45
  - Windows 当前用户登录自动启动配置默认关闭. 用户登录任务尚未在本机实际启用或创建.
46
46
  - `/new` 默认创建后台会话; 显式 `/new --mode ui` 会启动可见 Windows Terminal UI. 默认不打开新 tab.
47
- - `/sessions` 默认列出 Hub 管理的活跃前台/后台会话, 每页 5 条, 每个会话单独展示标题、项目、模式和状态; 当前微信 route 在列表摘要和对应会话项中标记. 标题优先使用会话名; 没有名称时仅读取 Pi `/resume` 同样采用的首条用户文本. 标题最长 32 个 Unicode code point, 超出以 `...` 省略; 暂无用户消息时显示“尚无用户消息”.
47
+ - `/sessions` 默认列出 Hub 管理的活跃前台/后台会话, 一次回复展示全部匹配会话, 每项显示标题、项目、模式和状态; 当前微信 route 在列表摘要和对应会话项中标记. 标题优先使用会话名; 没有名称时仅读取 Pi `/resume` 同样采用的首条用户文本. 标题最长 32 个 Unicode code point, 超出以 `...` 省略; 暂无用户消息时显示“尚无用户消息”.
48
48
  - 微信 `/resume <索引|名称>` 将该微信 sender 的 route 切换到目标 session. 空闲会话恢复后附带最多 800 个 Unicode 字符的最近回复预览; 内容过长时提示完整回复仍保留在会话记录中. 本机 TUI `/resume` 会进行 UI/background owner 交接.
49
49
 
50
50
  ## 最近讨论: 活跃 turn 中切换 route
@@ -87,13 +87,13 @@ Gateway 是常驻 daemon, 已运行进程不会自动加载磁盘上的新代码
87
87
 
88
88
  ## 近期已完成的相关改动
89
89
 
90
- - `/sessions` 改为每页 5 条的窄屏文本卡片, 每项独立显示索引/标题和项目/模式/状态; 当前 route 显示“当前微信路由”和“【当前】”标记. 标题优先取会话名, 否则读取 Pi `/resume` 使用的首条用户文本; 清理控制字符并在 32 个 Unicode code point 后追加 `...`.
90
+ - `/sessions` 使用 markdown 表格一次列出全部匹配会话, 每项显示索引/标题和模式/状态; 当前 route 显示“当前微信路由”和“(当前)”标记. 标题优先取会话名, 否则读取 Pi `/resume` 使用的首条用户文本; 清理控制字符并在 32 个 Unicode code point 后追加 `...`.
91
91
  - 微信 `/help` 按会话、项目、Hub 状态分组并缩短长语法行.
92
92
  - 微信 `/status` 使用中文状态摘要, 不暴露 PID 或内部技术字段.
93
93
  - 空闲会话 `/resume` 回复最多 800 个 Unicode 字符的最近回复预览, 超长时显示开头并说明完整内容仍在 transcript.
94
94
  - `/wx start`、`/wx stop`、`/wx restart` 先显示进度, 完成后再通知最终状态. `/wx stop` 的控制请求等待 runtime 安全收尾; `/wx restart` 通过 operationId 和 lifecycle receipt 等待新 daemon ready, Pi 端用本地文件事件唤醒, 不循环轮询网络.
95
95
  - `tests/gateway-service-controller.test.ts` 覆盖异步 lifecycle receipt 和 final status; `tests/wechat-session-hub-command.test.ts` 覆盖 restart 进度与完成通知.
96
- - `tests/gateway-command-router.test.ts` 增加会话卡片、稳定索引、当前 route 标记、分页、状态摘要、帮助分组和恢复预览截断回归测试.
96
+ - `tests/gateway-command-router.test.ts` 覆盖会话全量列表、稳定索引、当前 route 标记、状态摘要、帮助分组和恢复预览截断回归测试.
97
97
 
98
98
  **文档不一致提醒:** README 配置说明中仍有旧句子称微信 `/new` 固定创建后台会话; 实现现在支持显式 `--mode ui`. 后续可顺手修正文案.
99
99
 
@@ -113,7 +113,7 @@ Pi `0.85.1`、`1.0.0`、`1.3.0` 完整兼容矩阵在较早的实现阶段已跑
113
113
  1. 用户希望 `/resume`/`/new` 在旧 turn 未完成时立即切换, 还是继续保持 FIFO 等待.
114
114
  2. 当前 Pi TUI session 的实际 cwd 是否已精确登记, `allowedProjectRoots` 是否过宽.
115
115
  3. 对未登记 cwd 是否应从静默跳过改为给本机 TUI 明确提示, 同时继续 fail-closed.
116
- 4. 在 `/wx restart` 后实测微信 `/help` 分组、`/status` 中文摘要、`/sessions` 卡片/分页和 `/resume` 长回复预览, 以及 `/new --mode ui` 是否打开可见 tab.
116
+ 4. 在 `/wx restart` 后实测微信 `/help` 分组、`/status` 中文摘要、`/sessions` 全量表格和 `/resume` 长回复预览, 以及 `/new --mode ui` 是否打开可见 tab.
117
117
  5. 是否需要修 README 中旧 `/new` 描述, 并在合并更多改动后重跑 Pi `1.0.0` / `1.3.0` 矩阵.
118
118
 
119
119
  ## 常用验证命令
@@ -1,147 +1,150 @@
1
- # Pi 微信会话枢纽实现方案
2
-
3
- - 状态: 后台 daemon、会话 owner 切换、稳定会话索引和可选 Windows 登录自动启动已实现并通过本轮自动化验证.
4
- - 目标: 用户通过微信管理 Hub 注册的 Pi sessions; 本机 Pi TUI 可随时接管/释放同一 session.
5
- - 持久事实源: Pi session JSONL. Hub registry 只保存 session 索引元数据、唯一 owner、route 和运行状态.
6
-
7
- ## 1. 目标行为
8
-
9
- 1. 插件安装后, 用户在任意 Pi TUI 执行 `/wx start`; 授权根为空时, Hub 使用当前 session cwd 初始化授权根并建立默认项目. Gateway 随后由独立 daemon 持有, 不绑定当前 Pi 进程或 session.
10
- 2. 所有 Pi TUI 退出后, Hub daemon 和后台 RPC workers 继续提供微信收发.
11
- 3. 任意 Pi TUI 中 `/wx status|stop|restart` 控制同一后台服务. `/wx stop` 必须由可见 UI 二次确认.
12
- 4. Windows 用户登录自动启动是可选项, 配置默认关闭. 开启后使用之前的 Hub 微信授权, 不在登录任务中打开 QR UI.
13
- 5. session 的前台/后台模式表示当前 owner, 不是固定 session 属性:
14
- - 有可见 Pi TUI owner 时, 微信消息进入该 TUI transcript, assistant 最终回复同时回到微信.
15
- - TUI 关闭后, 已路由 session 安全交给后台 Pi RPC worker.
16
- - 本机 Pi `/resume` 已由后台处理的 Hub session 时, background writer 先退出, 再由 TUI 接管同一 session.
17
- - 未登记 session 可由 Pi 原生 `/resume` 恢复; 仅当 cwd 位于授权根内时才自动接入 Hub.
18
- 6. `allowedProjectRoots` 是授权边界, 根内 TUI session 自动登记, 项目展示名使用当前 cwd 文件夹名称. 微信端 `/sessions` 列出 Hub 管理的活跃 sessions.
19
-
20
- ## 2. 总体架构
21
-
22
- ```text
23
- 任意 Pi TUI
24
- /wx start|status|stop|restart|autostart
25
- │ 本机 Gateway control IPC
26
- ▼
27
- ┌────────────────────────────────────────────────────────┐
28
- │ 独立 Hub daemon (detached Node process) │
29
- │ │
30
- │ Gateway lease / control server / iLink poller / router │
31
- │ durable queue / route registry / stable session index │
32
- │ │
33
- │ 每个 session 同时只有一个 Pi writer │
34
- │ ├─ 有活跃 TUI: UI owner + sendUserMessage() │
35
- │ └─ 无活跃 TUI: headless Pi RPC worker │
36
- └─────────────────────────┬──────────────────────────────┘
37
- │
38
- ▼
39
- Pi 原生 session JSONL
40
- ```
41
-
42
- Hub daemon 本身是独立后台 Node 进程, 负责 Gateway、poller 和 session owner 调度. 处理每个对话的后台会话由 Pi `--mode rpc` worker 执行. daemon 和 worker 都不需要 TUI 窗口.
43
-
44
- ## 3. 后台 daemon 生命周期
45
-
46
- ### 3.1 启动
47
-
48
- `GatewayServiceController.start()` 先尝试通过 manager 目录对应的本机控制 endpoint 读取状态. 服务离线时, 使用不经 shell 的 `spawn()` 启动 detached daemon, 隐藏窗口、忽略标准输入输出, 并通过一次性 Node IPC 启动握手等待控制 endpoint ready.
49
-
50
- Daemon 在 Gateway runtime 初始化时取得 `GatewayLease`, 启动 UI owner IPC server 后开放 control IPC, 然后恢复 route 和启动 iLink poller. `/wx start` 不等待所有模型 turn; daemon ready 后返回启动状态. 重复 `start` 幂等, 不会建立第二个 poller.
51
-
52
- 首次在 Pi TUI 执行 `/wx start` 时, 若 `allowedProjectRoots` 为空, Hub 将当前 session cwd 设为初始授权根并按文件夹名称建立默认项目. 若路径为磁盘根或用户主目录等过宽范围, 会在本机要求确认. 后续可通过 `/wx roots add-current` 或 `/wx roots add <绝对路径>` 增加授权根; 微信端不开放这些配置操作.
53
-
54
- ### 3.2 状态与控制
55
-
56
- control endpoint 为 Windows named pipe 或 POSIX Unix socket. 客户端使用 `manager.lock` 中的 lease token 完成 HMAC challenge-response. 只接受 `status`、`stop`、`restart` 固定动作; `restart` 可携带经过 UUID 校验并由附加 HMAC 保护的操作 ID, 不接受路径、命令或任意数据.
57
-
58
- `status` 通过活跃 IPC 和 Gateway runtime 快照读取在线状态、PID、前台/后台 owner 数和 route 数. 仅有 `gateway.json` 的旧状态不视为在线.
59
-
60
- `stop` 收到确认后显示“正在停止”, 并等待 daemon 停止新 poll、收尾当前已入队工作、关闭 background workers、断开 UI IPC 并释放 lease 后返回 `offline` 终态. 队列仍是 durable; Gateway 停止期间不会接收新消息. 若 worker 无法安全停止, lease 保留, 状态保持可诊断, 避免启动第二个 owner.
61
-
62
- `restart` 会先通过 control IPC 确认生命周期操作并返回操作 ID; 当前 daemon 安全停止 Gateway runtime, 释放 lease 并关闭旧 control endpoint, 再 detached 启动新 daemon. 新 daemon 就绪后写入操作结果, Pi TUI 通过本地文件系统事件等待最终状态, 不循环轮询网络或服务状态. 服务已经离线时, `restart` 等同于 `start`.
63
-
64
- ## 4. 前台/后台 owner 交接
65
-
66
- - 每个可见 Pi TUI 在 `session_start` 后尝试连接 Gateway UI IPC. `allowedProjectRoots` 负责安全授权; cwd 位于授权根时, extension 按 cwd 文件夹名自动建立或复用项目记录, 不要求预先逐个添加 alias. cwd 超出授权范围时, session 仍可本机使用, TUI 会提示 `/wx roots add-current` 等本机授权入口. UI worker 连接成功后, Pi footer 扩展状态行显示 `🟢 微信: 已接入`; 连接重建期间显示 `🟡 微信: 连接中`.
67
-
68
- ```text
69
- 后台 RPC owner -- Pi /resume / UI attach --> 前台 TUI owner
70
- 前台 TUI owner -- session shutdown -------> 后台 RPC owner
71
- ```
72
-
73
- - UI 接管时, IPC server 验证 Pi session file、授权根范围和 lease; 项目记录按 cwd 文件夹名自动创建或复用. 如果现有 owner 是 Hub 的 background worker, 先优雅停止该 worker, 再注册 UI owner, 并更新 route generation.
74
- - UI owner 收到微信消息时, extension 用 Pi 原生 `sendUserMessage()` 注入消息. `agent_settled` 后将完整最终 assistant 文本交给 Gateway, 再由 iLink 发回微信.
75
- - UI TUI 正常关闭时, 移除前台 owner; 有 route 的 session 交给后台 RPC worker, route 和 session ID 不变.
76
- - `/wx stop` 会断开 Gateway IPC, 但仍运行的 TUI 保持本地会话. 下次 `start` 时, UI extension 会重连并恢复 owner.
77
- - Hub 启动时, 曾标记为 UI 但已没有活跃 UI owner 的 saved route 改由后台 RPC 恢复, 不自动打开 Windows Terminal tab.
78
- - 未登记目标的 Pi 原生 `/resume` 不因缺少 Hub registry 记录而被取消. 如果目标 transcript 没有活跃或状态不明的 Hub owner, 允许 Pi 恢复; 恢复后 cwd 在授权根内则自动登记并接入, 否则只保留本机使用.
79
- - 已登记 session 若由其他活跃 UI owner 持有, 或旧 owner 状态不明且进程仍存活, 拒绝第二 writer. 后台 owner 则尝试安全停止并交接; 停止或交接失败时拒绝恢复.
80
- - Gateway 重启时, 已标记为 `stale` 或 `stopping` 的 UI owner 不会阻塞 Gateway 启动, 也不会被自动改为 background writer; 其 route 保留并等待原 TUI 重新接入. 只有进程已确认退出后, 下一次恢复才会清理 owner 并按安全规则交接.
81
- - 未登记 transcript 不会触发本机 session 文件扫描; 仅通过用户当前 Pi 的 `/resume` 选择单个目标.
82
-
83
- ## 5. 微信端会话和索引
84
-
85
- ```text
86
- /new [--mode background|ui] [--project <alias>] [--name <名称>]
87
- /sessions [--project <alias>] [--state active|saved|pending|all] [--page <n>]
88
- /resume <会话索引|名称>
89
- /stop [会话索引|名称]
90
- /retry <message-id> --confirm
91
- ```
92
-
93
- `/new` 默认在后台创建 session, 不接受任意工作目录或 shell 参数; 用户可显式指定 `--mode ui` 请求在新 Windows Terminal tab 中打开可见 session. 若 route 后续通过本机 Pi TUI `/resume` 打开该 session, owner 会自动切换为 UI. 微信端 `/resume` 切换到已停止或 idle 的 session 时, 回复会附上 transcript 中最近一条 assistant 文本; 若目标 agent 正在运行, 则只确认 route 切换.
94
-
95
- `/sessions` 默认状态为 `active`, active 集合由当前 UI 和 background owner 共同构成. 需要查看已保存/待启动 session 时可使用 `--state all` 或相应过滤项. 列表每页 5 条, 每个会话以独立信息块显示稳定索引、标题、项目、模式和状态; 当前微信 route 在会话项和列表摘要中标记. 标题优先使用 session name, 未命名时读取 Pi `/resume` 同样采用的首条 user 文本, 并在 32 个 Unicode 字符后以 `...` 省略. 微信命令帮助按会话、项目和 Hub 状态分组; `/status` 使用中文状态和会话摘要, 不显示 PID. 空闲会话的 `/resume` 回复附带最近 assistant 文本预览, 最多 800 个 Unicode 字符, 超长时明确提示剩余内容仍保留在 transcript.
96
-
97
- `SessionIndexRecord.publicIndex` 在首次写入时分配, 旧 registry 首次读取时按最近活动时间排序迁移. 索引持久保存, 不随列表排序变化; app 不主动删除旧 session 索引, 新会话递增分配. `session-index.json` 的 UUID 仍仅供内部关联使用.
98
-
99
- ## 6. Pi 本机控制命令
100
-
101
- - Pi 扩展只注册 `/wx` 和兼容别名 `/wechat-manager`; 不占用 Pi 全局 `/help`、`/projects` 或 `/status` 命令.
102
- - `/wx` 回车打开 `ctx.ui.select()` 操作菜单; `/wx help` 展示本机 Hub 帮助.
103
- - `/wx projects` 管理项目别名; 新打开的授权范围内 session 会自动创建以 cwd 文件夹名为 displayName 的项目记录.
104
- - `/wx roots` 查看授权根; `/wx roots add-current` 或 `/wx roots add <绝对路径>` 仅可在本机可见 TUI 修改授权根.
105
- - `/wx ` 使用 Pi `getArgumentCompletions` 提供本机子命令补全.
106
- - `stop` 在可见 UI 中调用 `ctx.ui.confirm()`. 无 UI 的调用 fail-closed, 不停止服务.
107
- - `/wx status` 读取共享 daemon 状态及配置项目计数, 不查看本 Pi extension 实例里的局部内存字段.
108
-
109
- ## 7. Windows 用户登录自动启动
110
-
111
- 配置项 `autoStartOnWindowsLogon` 默认 `false`. `/wx autostart on` 使用 `schtasks.exe` 以 `execFile` argv 创建当前用户 `ONLOGON` 任务, 然后更新配置; 若配置或任务更新失败会尽量回滚. `/wx autostart off` 删除任务并更新配置. 不需要为该登录任务安装系统级 Windows service 或请求管理员权限.
112
-
113
- 任务使用已保存的 `credentials.json` 启动 daemon. QR login 必须先由用户在 TUI 完成. 若凭证失效, daemon 不弹出交互窗口; 用户可从任意 Pi TUI 查看状态并重新授权.
114
-
115
- 此方案在 Windows 用户登录后启动, 不在 Windows 登录界面前运行. 用户注销/系统关机后, 用户级进程终止, 下次登录时任务重新启动 daemon.
116
-
117
- ## 8. 路由、队列与 iLink
118
-
119
- - 唯一 Gateway owner 持有 iLink `getupdates` 长轮询, 个人微信 sender allowlist 在持久化 queue 前检查.
120
- - 每个微信 route 使用 durable FIFO queue 和 `messageId` 去重. `context_token` 只随 pending queue 项持久化, 完成后删除.
121
- - Queue processing 使用 iLink `getconfig` / `sendtyping` best-effort 显示“正在输入”; typing 失败不影响 Pi turn.
122
- - Pi turn settled 后发送一条完整最终回复. Hub 不提供 token 级微信流式回传.
123
- - Gateway stop 先停止 poller, 再等待活动 route drain. 如果进程非正常退出, `processing` queue item 会阻断后续消息, 需用户显式 `/retry ... --confirm`.
124
-
125
- ## 9. 安全与数据约束
126
-
127
- - `allowedProjectRoots` 是本机 Hub 的会话接入边界. 根内打开的 Pi session 会按需登记; 根外 session 仍可在 Pi 本机恢复和使用, 但不能进入 Hub registry 或微信管理.
128
- - 微信不可传任意 shell 命令、Pi 内置 slash command、项目路径或 transcript 文件路径. 本机 `/wx roots` 命令不暴露给微信端.
129
- - 项目 alias 和真实路径每次启动/恢复时重新校验; 项目移出授权根后拒绝路由.
130
- - IPC challenge 使用 Gateway lease token HMAC; 普通 Pi TUI attach 使用 manager 目录 ACL 保护的稳定随机 `ui-attachment.key`. manager 目录及凭证使用当前用户专属 ACL/mode.
131
- - iLink QR 登录只写 Hub 自己的凭证, create-only; 不读取、复制、覆盖或删除其他客户端凭证.
132
- - 审计日志不含 prompt、模型输出、消息正文或 credential.
133
- - Gateway registry 不修改 Pi transcript; 任何写入都由对应的唯一 Pi runtime 完成.
134
-
135
- ## 10. 验证
136
-
137
- 自动化命令:
138
-
139
- ```bash
140
- npm run typecheck
141
- npm test
142
- npm run test:pi-runtime
143
- ```
144
-
145
- 测试覆盖: config 默认关闭和非法值拒绝, IPC HMAC、detached daemon ready/failure, Task Scheduler argv 构造, route/session index 迁移, background/UI handoff, saved UI route 不再开 tab, durable queue、fake iLink、typing indicator、凭证 create-only 和 Pi RPC command smoke. `npm test` 不启动真实 Windows Terminal、不访问真实微信或模型.
146
-
147
- Pi 0.85.1、1.0.0、1.3.0 本轮均通过 typecheck、完整测试和 RPC smoke. 本轮完整单测 80 项, 79 pass、1 项 Windows ACL 条件测试 skip. Windows Task Scheduler 与真实用户 logon、微信 QR 和真实模型仍需在用户设备上验收; 本轮未创建用户计划任务或启动真实微信连接.
1
+ # Pi 微信会话枢纽实现方案
2
+
3
+ - 状态: 后台 daemon、会话 owner 切换、稳定会话索引和可选 Windows 登录自动启动已实现并通过本轮自动化验证.
4
+ - 目标: 用户通过微信管理 Hub 注册的 Pi sessions; 本机 Pi TUI 可随时接管/释放同一 session.
5
+ - 持久事实源: Pi session JSONL. Hub registry 只保存 session 索引元数据、唯一 owner、route 和运行状态.
6
+
7
+ ## 1. 目标行为
8
+
9
+ 1. 插件安装后, 用户在任意 Pi TUI 执行 `/wx start`; 授权根为空时, Hub 使用当前 session cwd 初始化授权根并建立默认项目. Gateway 随后由独立 daemon 持有, 不绑定当前 Pi 进程或 session.
10
+ 2. 所有 Pi TUI 退出后, Hub daemon 和后台 RPC workers 继续提供微信收发.
11
+ 3. 任意 Pi TUI 中 `/wx status|stop|restart` 控制同一后台服务. `/wx stop` 必须由可见 UI 二次确认.
12
+ 4. Windows 用户登录自动启动是可选项, 配置默认关闭. 开启后使用之前的 Hub 微信授权, 不在登录任务中打开 QR UI.
13
+ 5. session 的前台/后台模式表示当前 owner, 不是固定 session 属性:
14
+ - 有可见 Pi TUI owner 时, 微信消息进入该 TUI transcript, assistant 最终回复同时回到微信.
15
+ - TUI 关闭后, 已路由 session 安全交给后台 Pi RPC worker.
16
+ - 本机 Pi `/resume` 已由后台处理的 Hub session 时, background writer 先退出, 再由 TUI 接管同一 session.
17
+ - 未登记 session 可由 Pi 原生 `/resume` 恢复; 仅当 cwd 位于授权根内时才自动接入 Hub.
18
+ 6. `allowedProjectRoots` 是授权边界, 根内 TUI session 自动登记, 项目展示名使用当前 cwd 文件夹名称. 微信端 `/sessions` 列出 Hub 管理的活跃 sessions.
19
+
20
+ ## 2. 总体架构
21
+
22
+ ```text
23
+ 任意 Pi TUI
24
+ /wx start|status|stop|restart|autostart
25
+ │ 本机 Gateway control IPC
26
+ ▼
27
+ ┌────────────────────────────────────────────────────────┐
28
+ │ 独立 Hub daemon (detached Node process) │
29
+ │ │
30
+ │ Gateway lease / control server / iLink poller / router │
31
+ │ durable queue / route registry / stable session index │
32
+ │ │
33
+ │ 每个 session 同时只有一个 Pi writer │
34
+ │ ├─ 有活跃 TUI: UI owner + sendUserMessage() │
35
+ │ └─ 无活跃 TUI: headless Pi RPC worker │
36
+ └─────────────────────────┬──────────────────────────────┘
37
+ │
38
+ ▼
39
+ Pi 原生 session JSONL
40
+ ```
41
+
42
+ Hub daemon 本身是独立后台 Node 进程, 负责 Gateway、poller 和 session owner 调度. 处理每个对话的后台会话由 Pi `--mode rpc` worker 执行. daemon 和 worker 都不需要 TUI 窗口.
43
+
44
+ ## 3. 后台 daemon 生命周期
45
+
46
+ ### 3.1 启动
47
+
48
+ `GatewayServiceController.start()` 先尝试通过 manager 目录对应的本机控制 endpoint 读取状态. 服务离线时, 使用不经 shell 的 `spawn()` 启动 detached daemon, 隐藏窗口、忽略标准输入输出, 并通过一次性 Node IPC 启动握手等待控制 endpoint ready.
49
+
50
+ Daemon 在 Gateway runtime 初始化时取得 `GatewayLease`, 启动 UI owner IPC server 后开放 control IPC, 然后恢复 route 和启动 iLink poller. `/wx start` 不等待所有模型 turn; daemon ready 后返回启动状态. 重复 `start` 幂等, 不会建立第二个 poller.
51
+
52
+ 首次在 Pi TUI 执行 `/wx start` 时, 若 `allowedProjectRoots` 为空, Hub 将当前 session cwd 设为初始授权根并按文件夹名称建立默认项目. 若路径为磁盘根或用户主目录等过宽范围, 会在本机要求确认. 后续可通过 `/wx roots add-current` 或 `/wx roots add <绝对路径>` 增加授权根; 微信端不开放这些配置操作.
53
+
54
+ ### 3.2 状态与控制
55
+
56
+ control endpoint 为 Windows named pipe 或 POSIX Unix socket. 客户端使用 `manager.lock` 中的 lease token 完成 HMAC challenge-response. 只接受 `status`、`stop`、`restart` 固定动作; `restart` 可携带经过 UUID 校验并由附加 HMAC 保护的操作 ID, 不接受路径、命令或任意数据.
57
+
58
+ `status` 通过活跃 IPC 和 Gateway runtime 快照读取在线状态、PID、前台/后台 owner 数和 route 数. 仅有 `gateway.json` 的旧状态不视为在线.
59
+
60
+ `stop` 收到确认后显示“正在停止”, 并等待 daemon 停止新 poll、收尾当前已入队工作、关闭 background workers、断开 UI IPC 并释放 lease 后返回 `offline` 终态. 队列仍是 durable; Gateway 停止期间不会接收新消息. 若 worker 无法安全停止, lease 保留, 状态保持可诊断, 避免启动第二个 owner.
61
+
62
+ `restart` 会先通过 control IPC 确认生命周期操作并返回操作 ID; 当前 daemon 安全停止 Gateway runtime, 释放 lease 并关闭旧 control endpoint, 再 detached 启动新 daemon. 新 daemon 就绪后写入操作结果, Pi TUI 通过本地文件系统事件等待最终状态, 不循环轮询网络或服务状态. 服务已经离线时, `restart` 等同于 `start`.
63
+
64
+ ## 4. 前台/后台 owner 交接
65
+
66
+ - 每个可见 Pi TUI 在 `session_start` 后尝试连接 Gateway UI IPC. `allowedProjectRoots` 负责安全授权; cwd 位于授权根时, extension 按 cwd 文件夹名自动建立或复用项目记录, 不要求预先逐个添加 alias. cwd 超出授权范围时, session 仍可本机使用, TUI 会提示 `/wx roots add-current` 等本机授权入口. UI worker 连接成功后, Pi footer 扩展状态行显示 `🟢 微信: 已接入`; 连接重建期间显示 `🟡 微信: 连接中`.
67
+
68
+ ```text
69
+ 后台 RPC owner -- Pi /resume / UI attach --> 前台 TUI owner
70
+ 前台 TUI owner -- session shutdown -------> 后台 RPC owner
71
+ ```
72
+
73
+ - UI 接管时, IPC server 验证 Pi session file、授权根范围和 lease; 项目记录按 cwd 文件夹名自动创建或复用. 如果现有 owner 是 Hub 的 background worker, 先优雅停止该 worker, 再注册 UI owner, 并更新 route generation.
74
+ - UI owner 收到微信消息时, extension 用 Pi 原生 `sendUserMessage()` 注入消息. `agent_settled` 后将完整最终 assistant 文本交给 Gateway, 再由 iLink 发回微信.
75
+ - UI TUI 正常关闭时, 移除前台 owner; 有 route 的 session 交给后台 RPC worker, route 和 session ID 不变.
76
+ - `/wx stop` 会断开 Gateway IPC, 但仍运行的 TUI 保持本地会话. 下次 `start` 时, UI extension 会重连并恢复 owner.
77
+ - Hub 启动时, 曾标记为 UI 但已没有活跃 UI owner 的 saved route 改由后台 RPC 恢复, 不自动打开 Windows Terminal tab.
78
+ - 未登记目标的 Pi 原生 `/resume` 不因缺少 Hub registry 记录而被取消. 如果目标 transcript 没有活跃或状态不明的 Hub owner, 允许 Pi 恢复; 恢复后 cwd 在授权根内则自动登记并接入, 否则只保留本机使用.
79
+ - 已登记 session 若由其他活跃 UI owner 持有, 或旧 owner 状态不明且进程仍存活, 拒绝第二 writer. 后台 owner 则尝试安全停止并交接; 停止或交接失败时拒绝恢复.
80
+ - Gateway 重启时, 已标记为 `stale` 或 `stopping` 的 UI owner 不会阻塞 Gateway 启动, 也不会被自动改为 background writer; 其 route 保留并等待原 TUI 重新接入. 只有进程已确认退出后, 下一次恢复才会清理 owner 并按安全规则交接.
81
+ - 未登记 transcript 不会触发本机 session 文件扫描; 仅通过用户当前 Pi 的 `/resume` 选择单个目标.
82
+
83
+ ## 5. 微信端会话和索引
84
+
85
+ ```text
86
+ /new [--mode background|ui] [--project <alias>] [--name <名称>]
87
+ /sessions [--project <alias>] [--state active|saved|pending|all]
88
+ /watch [--all]
89
+ /resume <会话索引|名称>
90
+ /stop [会话索引|名称]
91
+ /retry <message-id> --confirm
92
+ ```
93
+
94
+ `/new` 默认在后台创建 session, 不接受任意工作目录或 shell 参数; 用户可显式指定 `--mode ui` 请求在新 Windows Terminal tab 中打开可见 session. 若 route 后续通过本机 Pi TUI `/resume` 打开该 session, owner 会自动切换为 UI. 微信端 `/resume` 切换到已停止或 idle 的 session 时, 回复会附上 transcript 中最近一条 assistant 文本; 若目标 agent 正在运行, 则只确认 route 切换.
95
+
96
+ `/sessions` 默认状态为 `active`, active 集合由当前 UI 和 background owner 共同构成. 需要查看已保存/待启动 session 时可使用 `--state all` 或相应过滤项. 一次回复列出全部匹配会话, 每个会话展示稳定索引、标题、项目、模式和状态; 当前微信 route 在会话项和列表摘要中标记. 标题优先使用 session name, 未命名时读取 Pi `/resume` 同样采用的首条 user 文本, 并在 32 个 Unicode 字符后以 `...` 省略. 微信命令帮助按会话、项目和 Hub 状态分组; `/status` 使用中文状态和会话摘要, 不显示 PID. 空闲会话的 `/resume` 回复附带最近 assistant 文本预览, 最多 800 个 Unicode 字符, 超长时明确提示剩余内容仍保留在 transcript.
97
+
98
+ `/watch` 默认只显示运行中、启动中、错误和断连的会话; `--all` 加入空闲会话. 健康状态读取 worker registry, 错误分类读取每个 Pi transcript 最后一条 assistant message 的 `stopReason` 和 `errorMessage`, 不调用模型也不更改 session. 当前 worker 心跳不是定时刷新, 因此不据此推断 turn 卡住. `/last` 遇到最近一轮 assistant 错误时显示错误摘要 (例如额度耗尽及上游提供的重置时间), 不再显示“尚未产生回复”。
99
+
100
+ `SessionIndexRecord.publicIndex` 在首次写入时分配, 旧 registry 首次读取时按最近活动时间排序迁移. 索引持久保存, 不随列表排序变化; app 不主动删除旧 session 索引, 新会话递增分配. `session-index.json` 的 UUID 仍仅供内部关联使用.
101
+
102
+ ## 6. Pi 本机控制命令
103
+
104
+ - Pi 扩展只注册 `/wx` 和兼容别名 `/wechat-manager`; 不占用 Pi 全局 `/help`、`/projects` 或 `/status` 命令.
105
+ - `/wx` 回车打开 `ctx.ui.select()` 操作菜单; `/wx help` 展示本机 Hub 帮助.
106
+ - `/wx projects` 管理项目别名; 新打开的授权范围内 session 会自动创建以 cwd 文件夹名为 displayName 的项目记录.
107
+ - `/wx roots` 查看授权根; `/wx roots add-current` 或 `/wx roots add <绝对路径>` 仅可在本机可见 TUI 修改授权根.
108
+ - `/wx ` 使用 Pi `getArgumentCompletions` 提供本机子命令补全.
109
+ - `stop` 在可见 UI 中调用 `ctx.ui.confirm()`. 无 UI 的调用 fail-closed, 不停止服务.
110
+ - `/wx status` 读取共享 daemon 状态及配置项目计数, 不查看本 Pi extension 实例里的局部内存字段.
111
+
112
+ ## 7. Windows 用户登录自动启动
113
+
114
+ 配置项 `autoStartOnWindowsLogon` 默认 `false`. `/wx autostart on` 在当前用户 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` 写入启动项, 指向 manager 私有目录中的隐藏 PowerShell launcher; launcher 再用当前 Pi Node 与固定 daemon 参数启动 Gateway. 该方式不受 `schtasks /TR` 261 字符限制, 且不需要管理员权限. `/wx autostart off` 删除当前用户启动项和 launcher, 然后更新配置; 若配置更新失败会尽量回滚.
115
+
116
+ 任务使用已保存的 `credentials.json` 启动 daemon. QR login 必须先由用户在 TUI 完成. 若凭证失效, daemon 不弹出交互窗口; 用户可从任意 Pi TUI 查看状态并重新授权.
117
+
118
+ 此方案在 Windows 用户登录后启动, 不在 Windows 登录界面前运行. 用户注销/系统关机后, 用户级进程终止, 下次登录时 Run 启动项重新启动 daemon.
119
+
120
+ ## 8. 路由、队列与 iLink
121
+
122
+ - 唯一 Gateway owner 持有 iLink `getupdates` 长轮询, 个人微信 sender allowlist 在持久化 queue 前检查.
123
+ - 每个微信 route 使用 durable FIFO queue 和 `messageId` 去重. `context_token` 只随 pending queue 项持久化, 完成后删除.
124
+ - Queue processing 使用 iLink `getconfig` / `sendtyping` best-effort 显示“正在输入”; typing 失败不影响 Pi turn.
125
+ - Pi turn settled 后发送一条完整最终回复. Hub 不提供 token 级微信流式回传.
126
+ - Gateway stop 先停止 poller, 再等待活动 route drain. 如果进程非正常退出, 遗留 `processing` 项会在下次处理时被标为 `skipped` 并自动放行后续消息, 同时向微信发一条包含 messageId 的跳过提示; 需要重新执行时用 `/retry ... --confirm`.
127
+
128
+ ## 9. 安全与数据约束
129
+
130
+ - `allowedProjectRoots` 是本机 Hub 的会话接入边界. 根内打开的 Pi session 会按需登记; 根外 session 仍可在 Pi 本机恢复和使用, 但不能进入 Hub registry 或微信管理.
131
+ - 微信不可传任意 shell 命令、Pi 内置 slash command、项目路径或 transcript 文件路径. 本机 `/wx roots` 命令不暴露给微信端.
132
+ - 项目 alias 和真实路径每次启动/恢复时重新校验; 项目移出授权根后拒绝路由.
133
+ - IPC challenge 使用 Gateway lease token HMAC; 普通 Pi TUI attach 使用 manager 目录 ACL 保护的稳定随机 `ui-attachment.key`. manager 目录及凭证使用当前用户专属 ACL/mode.
134
+ - iLink QR 登录只写 Hub 自己的凭证, create-only; 不读取、复制、覆盖或删除其他客户端凭证.
135
+ - 审计日志不含 prompt、模型输出、消息正文或 credential.
136
+ - Gateway registry 不修改 Pi transcript; 任何写入都由对应的唯一 Pi runtime 完成.
137
+
138
+ ## 10. 验证
139
+
140
+ 自动化命令:
141
+
142
+ ```bash
143
+ npm run typecheck
144
+ npm test
145
+ npm run test:pi-runtime
146
+ ```
147
+
148
+ 测试覆盖: config 默认关闭和非法值拒绝, IPC HMAC、detached daemon ready/failure, Windows 当前用户 Run 自动启动命令与 launcher 生成、route/session index 迁移, background/UI handoff, saved UI route 不再开 tab, durable queue、fake iLink、typing indicator、凭证 create-only 和 Pi RPC command smoke. `npm test` 不启动真实 Windows Terminal、不访问真实微信或模型.
149
+
150
+ Pi 版本兼容矩阵通过 typecheck、完整测试和 RPC smoke. Windows 当前用户登录启动项、真实微信 QR 和真实模型仍需在用户设备上验收; 自动启动项通过 HKCU Run 写入, 不要求系统级 Windows service 或管理员权限.
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Gateway daemon 的启动垫片。
3
+ *
4
+ * 此前 daemon 是直接用
5
+ * node --experimental-transform-types src/runtime/gateway-daemon.ts
6
+ * 启动的,这在两类环境下必然失败:
7
+ *
8
+ * 1. Node >= 26 已移除 --experimental-transform-types,Node 直接以
9
+ * "bad option" + exit code 9 退出(上游把它归类成"daemon 在 ready 前退出")。
10
+ * 2. npm 安装后入口位于 node_modules 内,而 Node 原生 TypeScript 支持
11
+ * 明确拒绝 node_modules 下的 .ts:
12
+ * ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING。
13
+ * 即使换回仍带该 flag 的 Node 22/24 也绕不过这一条。
14
+ *
15
+ * 本垫片改用 jiti 加载同一份 .ts 源码 —— pi 进程内的扩展本来就是这样加载的,
16
+ * 这里只是让独立的 daemon 子进程复用同一机制。好处:
17
+ *
18
+ * - 不再依赖任何 Node TypeScript flag,Node 22 / 24 / 26 一致可用
19
+ * - 不受 node_modules 的 TS 排除限制
20
+ * - daemon 与扩展加载的是同一份源码,无需维护编译产物、也不会出现两份逻辑漂移
21
+ *
22
+ * 注意:本文件是 .mjs(不是 .ts),因此不会被 `pi.extensions` 的 `./extensions/*.ts`
23
+ * glob 当成扩展入口加载;它只作为 daemon 的子进程入口被 spawn。
24
+ */
25
+ import { fileURLToPath } from "node:url";
26
+ import { createJiti } from "jiti";
27
+
28
+ const entry = fileURLToPath(new URL("../src/runtime/gateway-daemon.ts", import.meta.url));
29
+ const jiti = createJiti(import.meta.url);
30
+
31
+ await jiti.import(entry);
@@ -18,7 +18,7 @@ import { getManagerDataDirectory } from "../src/config/paths.ts";
18
18
  import { GatewayControlError } from "../src/gateway/gateway-control-ipc.ts";
19
19
  import { probeWindowsTerminalCapability } from "../src/gateway/windows-terminal-launcher.ts";
20
20
  import { GatewayServiceController, type GatewayDaemonLaunchSpec, type GatewayServiceStatus } from "../src/runtime/gateway-service-controller.ts";
21
- import { WindowsLogonTaskManager, WindowsLogonTaskManagerError } from "../src/runtime/windows-logon-task-manager.ts";
21
+ import { WindowsLogonAutoStartManager, WindowsLogonAutoStartError } from "../src/runtime/windows-logon-autostart-manager.ts";
22
22
  import { registerUiWorkerBridgeHooks, attachCurrentUiWorkerSession, getCurrentUiWorkerBridgeDiagnostics } from "../src/gateway/ui-worker-extension-bridge.ts";
23
23
  import { UiWorkerIpcError } from "../src/gateway/ui-worker-ipc.ts";
24
24
  import { IlinkApiError } from "../src/gateway/wechat-ilink/api-client.ts";
@@ -63,18 +63,18 @@ function createGatewayServiceControllerSpec(): GatewayDaemonLaunchSpec {
63
63
  return {
64
64
  managerDirectory,
65
65
  extensionPath: fileURLToPath(import.meta.url),
66
- daemonEntry: fileURLToPath(new URL("../src/runtime/gateway-daemon.ts", import.meta.url)),
66
+ daemonEntry: fileURLToPath(new URL("./daemon-entry.mjs", import.meta.url)),
67
67
  piInvocation: resolveCurrentPiCli(),
68
68
  };
69
69
  }
70
70
 
71
71
  /**
72
- * 更新 Windows 登录自动启动任务与用户配置, 失败时尽量回滚外部任务。
72
+ * 更新 Windows 用户登录自动启动项与 Hub 配置, 失败时尽量回滚外部启动项。
73
73
  *
74
74
  * @param store Hub 全局配置存储。
75
75
  * @param launchSpec 独立 daemon 启动参数。
76
76
  * @param enabled 是否在当前 Windows 用户登录后自动连接。
77
- * @returns 配置和 Task Scheduler 状态一致时正常结束。
77
+ * @returns 配置和当前用户 Run 项状态一致时正常结束。
78
78
  */
79
79
  async function updateWindowsLogonAutoStart(
80
80
  store: ConfigurationStore,
@@ -82,24 +82,24 @@ async function updateWindowsLogonAutoStart(
82
82
  enabled: boolean,
83
83
  ): Promise<void> {
84
84
  const current = (await store.load()).config.autoStartOnWindowsLogon;
85
- const taskManager = new WindowsLogonTaskManager(launchSpec);
85
+ const autoStartManager = new WindowsLogonAutoStartManager(launchSpec);
86
86
  try {
87
87
  if (enabled) {
88
- await taskManager.enable();
88
+ await autoStartManager.enable();
89
89
  } else {
90
- await taskManager.disable();
90
+ await autoStartManager.disable();
91
91
  }
92
92
  await store.update((config) => ({ ...config, autoStartOnWindowsLogon: enabled }));
93
93
  } catch (error) {
94
94
  try {
95
95
  if (current) {
96
- await taskManager.enable();
96
+ await autoStartManager.enable();
97
97
  } else {
98
- await taskManager.disable();
98
+ await autoStartManager.disable();
99
99
  }
100
100
  } catch {
101
- throw new WindowsLogonTaskManagerError(
102
- "自动启动配置更新失败, 且无法恢复之前的 Windows 登录任务状态。",
101
+ throw new WindowsLogonAutoStartError(
102
+ "自动启动配置更新失败, 且无法恢复之前的 Windows 登录自动启动项状态。",
103
103
  );
104
104
  }
105
105
  throw error;
@@ -574,7 +574,7 @@ function toUserMessage(error: unknown): string {
574
574
  error instanceof ConfigurationValidationError ||
575
575
  error instanceof WechatManagerCommandParseError ||
576
576
  error instanceof GatewayControlError ||
577
- error instanceof WindowsLogonTaskManagerError ||
577
+ error instanceof WindowsLogonAutoStartError ||
578
578
  error instanceof IlinkApiError ||
579
579
  error instanceof IlinkCredentialStoreError ||
580
580
  error instanceof IlinkQrLoginError ||
package/package.json CHANGED
@@ -1,67 +1,72 @@
1
- {
2
- "name": "pi-wechat-session-hub",
3
- "version": "0.1.0",
4
- "description": "通过微信管理本机多个 Pi 会话的 Pi 扩展。",
5
- "keywords": [
6
- "pi-package",
7
- "pi",
8
- "wechat",
9
- "weixin",
10
- "ilink",
11
- "session-manager",
12
- "remote-control"
13
- ],
14
- "license": "AGPL-3.0-or-later",
15
- "author": "yangfeng20",
16
- "repository": {
17
- "type": "git",
18
- "url": "git+https://github.com/yangfeng20/pi-wechat-session-hub.git"
19
- },
20
- "bugs": {
21
- "url": "https://github.com/yangfeng20/pi-wechat-session-hub/issues"
22
- },
23
- "homepage": "https://github.com/yangfeng20/pi-wechat-session-hub#readme",
24
- "type": "module",
25
- "engines": {
26
- "node": ">=22.19.0"
27
- },
28
- "files": [
29
- "extensions/",
30
- "src/",
31
- "scripts/",
32
- "docs/",
33
- "README.md",
34
- "LICENSE",
35
- "tsconfig.json"
36
- ],
37
- "scripts": {
38
- "typecheck": "tsc --noEmit",
39
- "test": "node --experimental-transform-types --test tests/config-store.test.ts tests/project-service.test.ts tests/project-command-parser.test.ts tests/registry.test.ts tests/pi-rpc-client.test.ts tests/background-worker.test.ts tests/background-worker-resume.test.ts tests/pi-cli.test.ts tests/durable-message-queue.test.ts tests/gateway-command-parser.test.ts tests/gateway-command-router.test.ts tests/durable-message-queue-context.test.ts tests/wechat-ilink.test.ts tests/credential-store.test.ts tests/ilink-qr-login.test.ts tests/gateway-runtime.test.ts tests/wechat-manager-command-parser.test.ts tests/ui-worker-manager.test.ts tests/windows-terminal-launcher.test.ts tests/gateway-service-controller.test.ts tests/windows-logon-task-manager.test.ts tests/ui-session-owner-handoff.test.ts tests/ui-resume-owner-liveness.test.ts tests/wechat-session-hub-command.test.ts",
40
- "test:pi-runtime": "node scripts/pi-rpc-smoke.mjs"
41
- },
42
- "peerDependencies": {
43
- "@earendil-works/pi-coding-agent": "*"
44
- },
45
- "devDependencies": {
46
- "@earendil-works/pi-coding-agent": "0.85.1",
47
- "@types/node": "^22.0.0",
48
- "@types/qrcode-terminal": "0.12.2",
49
- "typescript": "^5.9.3"
50
- },
51
- "pi": {
52
- "extensions": [
53
- "./extensions/*.ts"
54
- ]
55
- },
56
- "piCompatibility": {
57
- "testedVersions": [
58
- "0.85.1",
59
- "1.0.0",
60
- "1.3.0"
61
- ],
62
- "supportedRange": ">=0.85.1 <2.0.0"
63
- },
64
- "dependencies": {
65
- "qrcode-terminal": "0.12.0"
66
- }
67
- }
1
+ {
2
+ "name": "pi-wechat-session-hub",
3
+ "version": "0.1.2",
4
+ "description": "通过微信管理本机多个 Pi 会话的 Pi 扩展。",
5
+ "keywords": [
6
+ "pi-package",
7
+ "pi",
8
+ "wechat",
9
+ "weixin",
10
+ "ilink",
11
+ "session-manager",
12
+ "remote-control"
13
+ ],
14
+ "license": "AGPL-3.0-or-later",
15
+ "author": "yangfeng20",
16
+ "repository": {
17
+ "type": "git",
18
+ "url": "git+https://github.com/yangfeng20/pi-wechat-session-hub.git"
19
+ },
20
+ "bugs": {
21
+ "url": "https://github.com/yangfeng20/pi-wechat-session-hub/issues"
22
+ },
23
+ "homepage": "https://github.com/yangfeng20/pi-wechat-session-hub#readme",
24
+ "type": "module",
25
+ "engines": {
26
+ "node": ">=22.19.0"
27
+ },
28
+ "files": [
29
+ "extensions/",
30
+ "src/",
31
+ "scripts/",
32
+ "docs/",
33
+ "README.md",
34
+ "CHANGELOG.md",
35
+ "LICENSE",
36
+ "tsconfig.json"
37
+ ],
38
+ "scripts": {
39
+ "typecheck": "tsc --noEmit",
40
+ "test": "node --experimental-transform-types --test --test-timeout=30000 --test-force-exit tests/config-store.test.ts tests/project-service.test.ts tests/project-command-parser.test.ts tests/registry.test.ts tests/pi-rpc-client.test.ts tests/background-worker.test.ts tests/background-worker-resume.test.ts tests/pi-cli.test.ts tests/durable-message-queue.test.ts tests/gateway-command-parser.test.ts tests/gateway-command-router.test.ts tests/durable-message-queue-context.test.ts tests/turn-health.test.ts tests/wechat-ilink.test.ts tests/credential-store.test.ts tests/ilink-qr-login.test.ts tests/gateway-runtime.test.ts tests/wechat-manager-command-parser.test.ts tests/ui-worker-manager.test.ts tests/windows-terminal-launcher.test.ts tests/gateway-service-controller.test.ts tests/windows-logon-autostart-manager.test.ts tests/ui-session-owner-handoff.test.ts tests/ui-resume-owner-liveness.test.ts tests/wechat-session-hub-command.test.ts",
41
+ "test:pi-runtime": "node scripts/pi-rpc-smoke.mjs",
42
+ "test:wt-capability": "node --experimental-transform-types scripts/probe-wt-capability.mjs",
43
+ "release:check": "node scripts/release-preflight.mjs",
44
+ "release:verify": "node scripts/release-preflight.mjs --verify"
45
+ },
46
+ "peerDependencies": {
47
+ "@earendil-works/pi-coding-agent": "*"
48
+ },
49
+ "devDependencies": {
50
+ "@earendil-works/pi-coding-agent": "0.85.1",
51
+ "@types/node": "^22.0.0",
52
+ "@types/qrcode-terminal": "0.12.2",
53
+ "typescript": "^5.9.3"
54
+ },
55
+ "pi": {
56
+ "extensions": [
57
+ "./extensions/*.ts"
58
+ ]
59
+ },
60
+ "piCompatibility": {
61
+ "testedVersions": [
62
+ "0.85.1",
63
+ "1.0.0",
64
+ "1.3.0"
65
+ ],
66
+ "supportedRange": ">=0.85.1 <2.0.0"
67
+ },
68
+ "dependencies": {
69
+ "jiti": "^2.7.0",
70
+ "qrcode-terminal": "0.12.0"
71
+ }
72
+ }