@phren/cli 0.2.15 → 0.2.16

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 (386) hide show
  1. package/README.md +2 -2
  2. package/dist/agent-instructions.d.ts +12 -0
  3. package/dist/agent-instructions.js +52 -0
  4. package/dist/bridge/agent-hook-stores.d.ts +32 -0
  5. package/dist/bridge/agent-hook-stores.js +67 -0
  6. package/dist/bridge/agent-hooks.d.ts +193 -2
  7. package/dist/bridge/agent-hooks.js +1045 -38
  8. package/dist/bridge/canary.d.ts +27 -0
  9. package/dist/bridge/canary.js +189 -0
  10. package/dist/bridge/changes.d.ts +57 -0
  11. package/dist/bridge/changes.js +403 -0
  12. package/dist/bridge/client.d.ts +3 -0
  13. package/dist/bridge/client.js +36 -0
  14. package/dist/bridge/code-note.d.ts +22 -0
  15. package/dist/bridge/code-note.js +42 -0
  16. package/dist/bridge/code-routes.d.ts +133 -0
  17. package/dist/bridge/code-routes.js +319 -0
  18. package/dist/bridge/codex-threads.d.ts +27 -0
  19. package/dist/bridge/codex-threads.js +442 -0
  20. package/dist/bridge/command.d.ts +7 -0
  21. package/dist/bridge/command.js +50 -5
  22. package/dist/bridge/computer-names.d.ts +4 -0
  23. package/dist/bridge/computer-names.js +16 -0
  24. package/dist/bridge/computers.d.ts +9 -0
  25. package/dist/bridge/computers.js +111 -0
  26. package/dist/bridge/context.d.ts +14 -0
  27. package/dist/bridge/context.js +149 -0
  28. package/dist/bridge/dispatch-command.d.ts +3 -0
  29. package/dist/bridge/dispatch-command.js +93 -0
  30. package/dist/bridge/dispatch-hosts.d.ts +23 -0
  31. package/dist/bridge/dispatch-hosts.js +25 -0
  32. package/dist/bridge/dispatch-returns.d.ts +123 -0
  33. package/dist/bridge/dispatch-returns.js +279 -0
  34. package/dist/bridge/dispatch-tree.d.ts +54 -0
  35. package/dist/bridge/dispatch-tree.js +198 -0
  36. package/dist/bridge/dispatch.d.ts +207 -0
  37. package/dist/bridge/dispatch.js +261 -0
  38. package/dist/bridge/enroll.d.ts +31 -0
  39. package/dist/bridge/enroll.js +236 -0
  40. package/dist/bridge/fanout-messages.d.ts +74 -0
  41. package/dist/bridge/fanout-messages.js +230 -0
  42. package/dist/bridge/fanouts.d.ts +160 -0
  43. package/dist/bridge/fanouts.js +702 -0
  44. package/dist/bridge/file-range.d.ts +16 -0
  45. package/dist/bridge/file-range.js +90 -0
  46. package/dist/bridge/files.d.ts +20 -0
  47. package/dist/bridge/files.js +54 -0
  48. package/dist/bridge/git-publish.d.ts +23 -0
  49. package/dist/bridge/git-publish.js +145 -0
  50. package/dist/bridge/git-worktrees.d.ts +21 -0
  51. package/dist/bridge/git-worktrees.js +150 -0
  52. package/dist/bridge/git.d.ts +54 -0
  53. package/dist/bridge/git.js +552 -0
  54. package/dist/bridge/grants.d.ts +31 -0
  55. package/dist/bridge/grants.js +181 -0
  56. package/dist/bridge/hand-off.d.ts +79 -0
  57. package/dist/bridge/hand-off.js +151 -0
  58. package/dist/bridge/health.d.ts +128 -0
  59. package/dist/bridge/health.js +260 -0
  60. package/dist/bridge/herdr.d.ts +79 -6
  61. package/dist/bridge/herdr.js +292 -27
  62. package/dist/bridge/hook-main.js +2 -0
  63. package/dist/bridge/install.d.ts +32 -1
  64. package/dist/bridge/install.js +225 -38
  65. package/dist/bridge/launch-worktree.d.ts +21 -0
  66. package/dist/bridge/launch-worktree.js +70 -0
  67. package/dist/bridge/limits.d.ts +20 -0
  68. package/dist/bridge/limits.js +65 -0
  69. package/dist/bridge/locate.d.ts +16 -0
  70. package/dist/bridge/locate.js +75 -0
  71. package/dist/bridge/metrics.d.ts +29 -0
  72. package/dist/bridge/metrics.js +71 -0
  73. package/dist/bridge/model-switch.d.ts +35 -0
  74. package/dist/bridge/model-switch.js +250 -0
  75. package/dist/bridge/models.d.ts +46 -0
  76. package/dist/bridge/models.js +257 -0
  77. package/dist/bridge/opencode-approvals.d.ts +6 -0
  78. package/dist/bridge/opencode-approvals.js +60 -0
  79. package/dist/bridge/pane-text.d.ts +15 -0
  80. package/dist/bridge/pane-text.js +23 -0
  81. package/dist/bridge/peers.d.ts +27 -0
  82. package/dist/bridge/peers.js +130 -0
  83. package/dist/bridge/projects.d.ts +12 -1
  84. package/dist/bridge/projects.js +268 -20
  85. package/dist/bridge/protocol.d.ts +35 -2
  86. package/dist/bridge/protocol.js +42 -7
  87. package/dist/bridge/push.d.ts +83 -0
  88. package/dist/bridge/push.js +199 -0
  89. package/dist/bridge/questions.d.ts +38 -0
  90. package/dist/bridge/questions.js +205 -0
  91. package/dist/bridge/schedule-format.d.ts +103 -0
  92. package/dist/bridge/schedule-format.js +266 -0
  93. package/dist/bridge/schedule-launch.d.ts +11 -0
  94. package/dist/bridge/schedule-launch.js +169 -0
  95. package/dist/bridge/schedule-watch.d.ts +52 -0
  96. package/dist/bridge/schedule-watch.js +242 -0
  97. package/dist/bridge/schedules.d.ts +48 -0
  98. package/dist/bridge/schedules.js +205 -0
  99. package/dist/bridge/server-launch.d.ts +14 -0
  100. package/dist/bridge/server-launch.js +218 -0
  101. package/dist/bridge/server-overview.d.ts +45 -0
  102. package/dist/bridge/server-overview.js +102 -0
  103. package/dist/bridge/server-pane-routes.d.ts +29 -0
  104. package/dist/bridge/server-pane-routes.js +400 -0
  105. package/dist/bridge/server-routes.d.ts +106 -0
  106. package/dist/bridge/server-routes.js +538 -0
  107. package/dist/bridge/server-stream.d.ts +46 -0
  108. package/dist/bridge/server-stream.js +253 -0
  109. package/dist/bridge/server.d.ts +3 -15
  110. package/dist/bridge/server.js +162 -264
  111. package/dist/bridge/session-servers.d.ts +24 -0
  112. package/dist/bridge/session-servers.js +136 -0
  113. package/dist/bridge/side-questions.d.ts +74 -0
  114. package/dist/bridge/side-questions.js +252 -0
  115. package/dist/bridge/simulators.d.ts +28 -0
  116. package/dist/bridge/simulators.js +198 -0
  117. package/dist/bridge/speech-transcribe.d.ts +24 -0
  118. package/dist/bridge/speech-transcribe.js +124 -0
  119. package/dist/bridge/speech.d.ts +35 -0
  120. package/dist/bridge/speech.js +98 -0
  121. package/dist/bridge/steps.d.ts +13 -0
  122. package/dist/bridge/steps.js +222 -0
  123. package/dist/bridge/tab-activity.d.ts +18 -0
  124. package/dist/bridge/tab-activity.js +99 -0
  125. package/dist/bridge/terminal-choice.d.ts +64 -0
  126. package/dist/bridge/terminal-choice.js +281 -0
  127. package/dist/bridge/transcript-claude.d.ts +22 -0
  128. package/dist/bridge/transcript-claude.js +353 -0
  129. package/dist/bridge/transcript-codex.d.ts +30 -0
  130. package/dist/bridge/transcript-codex.js +282 -0
  131. package/dist/bridge/transcript-copilot.d.ts +4 -0
  132. package/dist/bridge/transcript-copilot.js +14 -0
  133. package/dist/bridge/transcript-opencode.d.ts +5 -0
  134. package/dist/bridge/transcript-opencode.js +26 -0
  135. package/dist/bridge/transcript-preview.d.ts +94 -0
  136. package/dist/bridge/transcript-preview.js +476 -0
  137. package/dist/bridge/transcripts.d.ts +81 -4
  138. package/dist/bridge/transcripts.js +332 -67
  139. package/dist/bridge/transport.d.ts +3 -0
  140. package/dist/bridge/transport.js +96 -15
  141. package/dist/bridge/uploads.d.ts +15 -0
  142. package/dist/bridge/uploads.js +44 -2
  143. package/dist/bridge/usage.d.ts +124 -0
  144. package/dist/bridge/usage.js +859 -0
  145. package/dist/bridge-hook.mjs +41246 -21385
  146. package/dist/cli/actions.js +14 -1
  147. package/dist/cli/config-proactivity.d.ts +3 -1
  148. package/dist/cli/config-proactivity.js +35 -3
  149. package/dist/cli/config.js +4 -1
  150. package/dist/cli/extract.js +3 -6
  151. package/dist/cli/govern.js +5 -2
  152. package/dist/cli/hooks-globs.js +1 -1
  153. package/dist/cli/hooks.d.ts +1 -1
  154. package/dist/cli/hooks.js +9 -7
  155. package/dist/cli/namespaces-projects.js +12 -6
  156. package/dist/cli/namespaces-store.js +37 -6
  157. package/dist/cli/namespaces-tasks.js +1 -1
  158. package/dist/cli/schedules.d.ts +1 -0
  159. package/dist/cli/schedules.js +164 -0
  160. package/dist/cli/session-background.js +1 -1
  161. package/dist/cli/session-git.d.ts +8 -5
  162. package/dist/cli/session-git.js +45 -120
  163. package/dist/cli/session-start.js +3 -1
  164. package/dist/cli/session-stop.js +19 -8
  165. package/dist/cli/team.js +13 -10
  166. package/dist/cli-handlers.d.ts +1 -1
  167. package/dist/cli-handlers.js +8 -4
  168. package/dist/cli-help.d.ts +5 -4
  169. package/dist/cli-help.js +15 -15
  170. package/dist/cli-registry.d.ts +4 -1
  171. package/dist/cli-registry.js +119 -6
  172. package/dist/content/archive.js +2 -2
  173. package/dist/content/citation.d.ts +11 -0
  174. package/dist/content/citation.js +18 -0
  175. package/dist/content/learning.js +2 -0
  176. package/dist/content/summarize.d.ts +14 -15
  177. package/dist/content/summarize.js +60 -5
  178. package/dist/content/validate.d.ts +3 -1
  179. package/dist/content/validate.js +26 -8
  180. package/dist/core/project-registry.d.ts +26 -0
  181. package/dist/core/project-registry.js +573 -0
  182. package/dist/core/project.js +2 -3
  183. package/dist/data/access.d.ts +7 -1
  184. package/dist/data/access.js +13 -3
  185. package/dist/data/tasks.d.ts +18 -3
  186. package/dist/data/tasks.js +8 -7
  187. package/dist/entrypoint.js +44 -10
  188. package/dist/fanout/adapters/claude.d.ts +2 -0
  189. package/dist/fanout/adapters/claude.js +7 -0
  190. package/dist/fanout/adapters/codex.d.ts +2 -0
  191. package/dist/fanout/adapters/codex.js +9 -0
  192. package/dist/fanout/adapters/opencode.d.ts +4 -0
  193. package/dist/fanout/adapters/opencode.js +9 -0
  194. package/dist/fanout/adapters/types.d.ts +21 -0
  195. package/dist/fanout/adapters/types.js +3 -0
  196. package/dist/fanout/command.d.ts +2 -0
  197. package/dist/fanout/command.js +78 -0
  198. package/dist/fanout/launcher.d.ts +27 -0
  199. package/dist/fanout/launcher.js +156 -0
  200. package/dist/fanout/opencode-serve.d.ts +24 -0
  201. package/dist/fanout/opencode-serve.js +191 -0
  202. package/dist/fanout/picker.d.ts +91 -0
  203. package/dist/fanout/picker.js +51 -0
  204. package/dist/fanout/usage.d.ts +5 -0
  205. package/dist/fanout/usage.js +51 -0
  206. package/dist/fanout/watchdog.d.ts +10 -0
  207. package/dist/fanout/watchdog.js +27 -0
  208. package/dist/filenames.d.ts +9 -0
  209. package/dist/filenames.js +11 -0
  210. package/dist/finding/context.js +4 -22
  211. package/dist/generated/memory-ui-graph.browser.js +279 -283
  212. package/dist/governance/policy-constants.d.ts +11 -0
  213. package/dist/governance/policy-constants.js +9 -0
  214. package/dist/governance/policy.d.ts +5 -8
  215. package/dist/governance/policy.js +7 -5
  216. package/dist/graph-core/camera.d.ts +24 -0
  217. package/dist/graph-core/camera.js +18 -0
  218. package/dist/graph-core/index.d.ts +2 -0
  219. package/dist/graph-core/index.js +2 -0
  220. package/dist/graph-core/labels.d.ts +77 -0
  221. package/dist/graph-core/labels.js +124 -0
  222. package/dist/graph-core/model.d.ts +13 -0
  223. package/dist/graph-core/model.js +33 -0
  224. package/dist/graph-core/types.d.ts +2 -0
  225. package/dist/home-paths.d.ts +7 -0
  226. package/dist/home-paths.js +21 -0
  227. package/dist/hooks.d.ts +3 -0
  228. package/dist/hooks.js +13 -0
  229. package/dist/index.js +24 -2
  230. package/dist/init/guard-globals.d.ts +1 -1
  231. package/dist/init/guard-globals.js +4 -4
  232. package/dist/init/init-configure.js +3 -3
  233. package/dist/init/init-uninstall.js +2 -2
  234. package/dist/init/init-walkthrough.js +1 -1
  235. package/dist/init/init.js +26 -6
  236. package/dist/init/management-preset.d.ts +1 -1
  237. package/dist/init/management-preset.js +2 -2
  238. package/dist/init/preferences.js +1 -1
  239. package/dist/init/self-wiring.js +1 -1
  240. package/dist/init/setup.d.ts +3 -26
  241. package/dist/init/setup.js +49 -588
  242. package/dist/init/shared.js +2 -0
  243. package/dist/init/store-gitignore.d.ts +1 -1
  244. package/dist/init/store-gitignore.js +2 -0
  245. package/dist/init/teardown.d.ts +1 -1
  246. package/dist/init/teardown.js +2 -2
  247. package/dist/link/context.js +1 -1
  248. package/dist/link/doctor.d.ts +22 -1
  249. package/dist/link/doctor.js +100 -54
  250. package/dist/link/link.js +29 -61
  251. package/dist/link/refresh.js +2 -2
  252. package/dist/link/skills.js +26 -5
  253. package/dist/machine-identity.d.ts +3 -0
  254. package/dist/machine-identity.js +6 -0
  255. package/dist/mcp/profile.d.ts +2 -15
  256. package/dist/mcp/profile.js +64 -9
  257. package/dist/memory-ui-graph.runtime.js +279 -283
  258. package/dist/modules/code-package.d.ts +16 -0
  259. package/dist/modules/code-package.js +152 -0
  260. package/dist/modules/command.d.ts +2 -0
  261. package/dist/modules/command.js +67 -0
  262. package/dist/modules/config.d.ts +4 -0
  263. package/dist/modules/config.js +70 -0
  264. package/dist/modules/manifest.d.ts +41 -0
  265. package/dist/modules/manifest.js +1 -0
  266. package/dist/modules/provision.d.ts +3 -0
  267. package/dist/modules/provision.js +84 -0
  268. package/dist/modules/registry.d.ts +16 -0
  269. package/dist/modules/registry.js +250 -0
  270. package/dist/modules/runtime.d.ts +15 -0
  271. package/dist/modules/runtime.js +59 -0
  272. package/dist/package-metadata.js +10 -2
  273. package/dist/phren-dotenv.js +4 -2
  274. package/dist/phren-paths.d.ts +3 -2
  275. package/dist/phren-paths.js +4 -5
  276. package/dist/profile-store.js +4 -5
  277. package/dist/project-config.d.ts +19 -1
  278. package/dist/project-config.js +29 -3
  279. package/dist/project-topics.js +4 -4
  280. package/dist/provider-adapters.js +1 -4
  281. package/dist/query-correlation.js +6 -6
  282. package/dist/session/artifacts.js +5 -5
  283. package/dist/session/checkpoints.js +5 -0
  284. package/dist/session/utils.d.ts +2 -2
  285. package/dist/session/utils.js +6 -6
  286. package/dist/shared/content.d.ts +1 -1
  287. package/dist/shared/content.js +1 -1
  288. package/dist/shared/data-utils.js +1 -1
  289. package/dist/shared/fragment-graph.d.ts +1 -1
  290. package/dist/shared/fragment-graph.js +5 -5
  291. package/dist/shared/index.js +48 -7
  292. package/dist/shared/retrieval.d.ts +18 -1
  293. package/dist/shared/retrieval.js +100 -11
  294. package/dist/shared/search-fallback.js +4 -6
  295. package/dist/shared/sqljs.d.ts +2 -0
  296. package/dist/shared/sqljs.js +4 -2
  297. package/dist/shared.d.ts +0 -1
  298. package/dist/shared.js +0 -1
  299. package/dist/shell/input.d.ts +1 -5
  300. package/dist/shell/input.js +16 -10
  301. package/dist/shell/palette.d.ts +2 -2
  302. package/dist/shell/palette.js +3 -7
  303. package/dist/shell/render.d.ts +3 -1
  304. package/dist/shell/render.js +4 -4
  305. package/dist/shell/shell.js +4 -1
  306. package/dist/shell/types.d.ts +1 -0
  307. package/dist/shell/types.js +4 -0
  308. package/dist/shell/view.d.ts +0 -4
  309. package/dist/shell/view.js +19 -27
  310. package/dist/skill/registry.js +25 -17
  311. package/dist/skill/state.d.ts +3 -0
  312. package/dist/skill/state.js +13 -7
  313. package/dist/status.js +38 -17
  314. package/dist/store-registry.d.ts +44 -18
  315. package/dist/store-registry.js +169 -60
  316. package/dist/store-weight.d.ts +1 -6
  317. package/dist/store-weight.js +4 -2
  318. package/dist/sync/auth-doctor.d.ts +8 -0
  319. package/dist/sync/auth-doctor.js +27 -0
  320. package/dist/sync/auth.d.ts +27 -0
  321. package/dist/sync/auth.js +114 -0
  322. package/dist/sync/conflict-resolve.d.ts +9 -0
  323. package/dist/sync/conflict-resolve.js +146 -0
  324. package/dist/sync/git-state.d.ts +4 -0
  325. package/dist/sync/git-state.js +49 -0
  326. package/dist/sync/outcome.d.ts +34 -0
  327. package/dist/sync/outcome.js +57 -0
  328. package/dist/sync/pull.d.ts +15 -7
  329. package/dist/sync/pull.js +84 -35
  330. package/dist/sync/store-merge.d.ts +29 -0
  331. package/dist/sync/store-merge.js +137 -0
  332. package/dist/sync/task-merge.d.ts +22 -0
  333. package/dist/sync/task-merge.js +158 -0
  334. package/dist/task/github.js +1 -1
  335. package/dist/task/lifecycle.d.ts +5 -0
  336. package/dist/task/lifecycle.js +67 -23
  337. package/dist/terminal-text.d.ts +5 -0
  338. package/dist/terminal-text.js +11 -0
  339. package/dist/test-global-setup.js +7 -0
  340. package/dist/tool-registry.d.ts +1 -1
  341. package/dist/tool-registry.js +3 -1
  342. package/dist/tools/code.d.ts +3 -0
  343. package/dist/tools/code.js +178 -0
  344. package/dist/tools/config.js +5 -0
  345. package/dist/tools/data.js +14 -7
  346. package/dist/tools/dispatch.d.ts +2 -0
  347. package/dist/tools/dispatch.js +66 -0
  348. package/dist/tools/finding.js +43 -41
  349. package/dist/tools/ops.js +5 -2
  350. package/dist/tools/search.js +21 -8
  351. package/dist/tools/session.js +21 -22
  352. package/dist/tools/tasks.js +8 -2
  353. package/dist/tools/types.d.ts +2 -2
  354. package/dist/tools/types.js +2 -2
  355. package/dist/ui/assets.js +1 -1
  356. package/dist/ui/data.js +14 -15
  357. package/dist/ui/deep-void.d.ts +1 -1
  358. package/dist/ui/deep-void.js +0 -1
  359. package/dist/ui/graph-chrome.d.ts +1 -1
  360. package/dist/ui/graph-chrome.js +51 -0
  361. package/dist/ui/page.js +5 -5
  362. package/dist/ui/scripts.js +67 -30
  363. package/dist/ui/server.js +34 -6
  364. package/dist/update.js +1 -1
  365. package/dist/utils-fts.js +1 -0
  366. package/dist/utils-helpers.d.ts +7 -0
  367. package/dist/utils-helpers.js +17 -0
  368. package/dist/utils.d.ts +1 -1
  369. package/dist/utils.js +1 -1
  370. package/package.json +45 -3
  371. package/plugins/opencode/phren-transcript.js +340 -0
  372. package/starter/README.md +4 -4
  373. package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
  374. package/starter/global/skills/conductor/SKILL.md +106 -0
  375. package/starter/global/skills/fanout/SKILL.md +20 -0
  376. package/starter/global/skills/phren-discover/SKILL.md +6 -6
  377. package/starter/global/skills/phren-init/SKILL.md +4 -4
  378. package/starter/global/skills/phren-sync/SKILL.md +3 -3
  379. package/starter/templates/frontend/reference/README.md +1 -1
  380. package/starter/templates/library/reference/README.md +1 -1
  381. package/starter/templates/monorepo/reference/README.md +1 -1
  382. package/starter/templates/python-project/reference/README.md +1 -1
  383. /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
  384. /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
  385. /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
  386. /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
@@ -0,0 +1,253 @@
1
+ import { WebSocket } from "ws";
2
+ import { z } from "zod";
3
+ import { logger } from "../logger.js";
4
+ import { queuedQuestion, threadHealth } from "./codex-threads.js";
5
+ import { SNAPSHOT_SHARE_MS, trustedDirectory, validateTarget } from "./herdr.js";
6
+ import { repositoryBranch } from "./projects.js";
7
+ import { BridgeError, MAX_FRAME, object, targetFromURL } from "./protocol.js";
8
+ import { TranscriptPreviewStream } from "./transcript-preview.js";
9
+ import { childAgent, childAgentTree, refreshTranscript, TranscriptReader, transcriptPath } from "./transcripts.js";
10
+ import { countTick } from "./metrics.js";
11
+ function send(socket, frame) {
12
+ if (socket.readyState !== WebSocket.OPEN)
13
+ return;
14
+ const data = JSON.stringify(frame);
15
+ if (Buffer.byteLength(data) > MAX_FRAME || socket.bufferedAmount > MAX_FRAME) {
16
+ socket.close(1009, "Reconnect to resume the conversation");
17
+ return;
18
+ }
19
+ socket.send(data);
20
+ }
21
+ /**
22
+ * Why a transcript or status stream closed. Only a real target change (the
23
+ * 409 validation) says the conversation changed; I/O, parse and git failures
24
+ * keep their own words, with absolute paths cut to their last component and
25
+ * the reason bounded to WebSocket's 123-byte close limit.
26
+ */
27
+ export function streamCloseReason(error) {
28
+ if (error instanceof BridgeError && error.status === 409)
29
+ return "The conversation changed; refresh";
30
+ const code = error?.code;
31
+ const first = (error instanceof Error ? error.message : String(error)).split("\n")[0]
32
+ .replace(/[\x00-\x1f\x7f]/g, " ").replace(/(?:~|\/)[^\s'",:]*\/([^\s'",:/]+)/g, "$1").trim();
33
+ let reason = error instanceof BridgeError ? first
34
+ : `Stream failed: ${typeof code === "string" && !first.startsWith(code) ? `${code} ` : ""}${first || "unknown error"}`;
35
+ while (Buffer.byteLength(reason) > 123)
36
+ reason = reason.slice(0, -1);
37
+ return reason;
38
+ }
39
+ export function transcriptStreams(ctx) {
40
+ const { modules, agentHooks, codexQuestions, sideQuestions, info, activeCapabilities } = ctx;
41
+ /** A conversation the agent has identified but not written yet (Claude
42
+ * Code creates its file on the first turn) is an empty transcript, not a
43
+ * missing one: `reader` stays undefined until the file appears. */
44
+ async function conversationReader(target) {
45
+ try {
46
+ const reader = new TranscriptReader(await transcriptPath(target.source, target.session), target.source, undefined, modules.has("git") ? agentHooks.changes.view(`${target.source}:${target.session}`) : undefined);
47
+ return { reader, source: target.source, session: target.session };
48
+ }
49
+ catch (error) {
50
+ if (error instanceof BridgeError && error.status === 404)
51
+ return { source: target.source, session: target.session };
52
+ throw error;
53
+ }
54
+ }
55
+ const emptyPage = { entries: [], totalLines: 0, startLine: 0, hasMore: false, reset: true };
56
+ /** The transcript of an agent the conversation spawned. The child is a
57
+ * parent-scoped id from `/v1/subagents`; the file is only ever reached
58
+ * through the relation, never by a path or session the phone names. */
59
+ async function childConversationReader(target, child) {
60
+ const relation = childAgent(await childAgentTree(target.source, target.session), child);
61
+ if (!relation)
62
+ throw new BridgeError(404, "This child agent does not belong to the selected conversation.");
63
+ const reader = new TranscriptReader(relation.transcript, relation.provider, undefined, undefined, relation.provider === "claude", relation.cwd);
64
+ return { reader, source: relation.provider, session: relation.id };
65
+ }
66
+ async function stream(client, url) {
67
+ const abort = new AbortController();
68
+ let reader, timer;
69
+ let unwatch;
70
+ let busy = false, ready = false, first = true;
71
+ let awaitingTranscript = false, lastTranscriptLookup = 0;
72
+ let initialPane;
73
+ const pending = [];
74
+ const stop = () => { abort.abort(); clearInterval(timer); unwatch?.(); pending.length = 0; };
75
+ client.once("close", stop);
76
+ client.once("error", stop);
77
+ // Even rejected upgrades may already contain invalid WebSocket frames.
78
+ // Handle their errors before parsing any untrusted destination fields.
79
+ const target = targetFromURL(url);
80
+ const previews = new TranscriptPreviewStream(target);
81
+ // A child agent's transcript streams through the same socket, bound to
82
+ // the parent conversation: the parent target is what gets revalidated
83
+ // each tick, and the frames name the child by its parent-scoped id.
84
+ const child = url.pathname === "/v1/transcripts" ? url.searchParams.get("child") : null;
85
+ const cursor = url.pathname === "/v1/transcripts" ? url.searchParams.get("afterLine") : null;
86
+ // Side answers (Claude's `/btw`) ride the parent conversation's stream
87
+ // for a phone that asked for them; an older phone rejects unknown frames.
88
+ const sideAnswers = url.pathname === "/v1/transcripts" && child === null && url.searchParams.get("sideAnswers") === "1";
89
+ const sentSide = new Map();
90
+ // The first frame stays a backlog for protocol compatibility, but a
91
+ // reconnect only reads rows beyond the phone's retained raw-line cursor.
92
+ let resumeAfterLine = cursor === null ? undefined : z.coerce.number().int().nonnegative().max(4_294_967_295).parse(cursor);
93
+ let conversation = { source: target.source, session: target.session };
94
+ // The transcript file of a fresh conversation appears with its first
95
+ // turn; until then the socket carries an empty backlog and keeps looking.
96
+ const findTranscript = async () => {
97
+ if (Date.now() - lastTranscriptLookup < 2_000)
98
+ return;
99
+ lastTranscriptLookup = Date.now();
100
+ const opened = await conversationReader(target);
101
+ if (opened.reader) {
102
+ reader = opened.reader;
103
+ conversation = { source: opened.source, session: opened.session };
104
+ awaitingTranscript = false;
105
+ }
106
+ };
107
+ const tick = async () => {
108
+ if (busy || !ready || abort.signal.aborted)
109
+ return;
110
+ busy = true;
111
+ try {
112
+ if (first || pending.length === 0) {
113
+ const pane = first ? initialPane : await validateTarget(target, false, false, SNAPSHOT_SHARE_MS);
114
+ if (awaitingTranscript)
115
+ await findTranscript();
116
+ if (awaitingTranscript) {
117
+ if (first)
118
+ send(client, { ...emptyPage, type: "backlog", ...conversation });
119
+ }
120
+ else if (reader) {
121
+ await refreshTranscript(reader.file, conversation.source, conversation.session);
122
+ if (first && child === null && target.source === "claude" && resumeAfterLine !== undefined) {
123
+ // A reconnect cursor can omit the current user row entirely.
124
+ // Seed only ephemeral turn state from the bounded recent tail.
125
+ previews.observe((await new TranscriptReader(reader.file, conversation.source).read(undefined, abort.signal)).entries);
126
+ }
127
+ const page = resumeAfterLine === undefined
128
+ ? await reader.read(undefined, abort.signal)
129
+ : await reader.readAfter(resumeAfterLine, abort.signal);
130
+ resumeAfterLine = undefined;
131
+ if (child === null)
132
+ previews.observe(page.entries, page.reset);
133
+ const preview = child === null ? await previews.update(pane.agent_status, reader.file) : undefined;
134
+ // `activityVerb` stays for phones that predate `activity`.
135
+ const activity = previews.activity ? { activityVerb: previews.activity.verb, activity: { ...previews.activity } }
136
+ : previews.verb ? { activityVerb: previews.verb } : {};
137
+ if (first || page.entries.length || page.reset)
138
+ send(client, { ...page, ...preview, ...activity, type: first || page.reset ? "backlog" : "append", ...conversation });
139
+ else if (preview)
140
+ send(client, { type: "preview", ...conversation, ...preview, ...activity });
141
+ }
142
+ else {
143
+ let pendingApproval = agentHooks.approval(target);
144
+ const pendingQuestions = target.source === "codex" ? await codexQuestions.pending(target).catch(() => undefined) : undefined;
145
+ const cwd = await trustedDirectory(pane).catch(() => undefined);
146
+ const branch = modules.has("git") && cwd ? await repositoryBranch(cwd) : undefined;
147
+ const waiting = !pendingApproval && ["blocked", "waiting"].includes(String(pane.agent_status));
148
+ // Claude Code's auto-mode fallback, opencode and Codex draw a
149
+ // numbered dialog in the pane with no PermissionRequest hook
150
+ // behind it: read the pane (at most once per three seconds) and
151
+ // publish the dialog as the same terminal choice shape the phone
152
+ // answers. Codex also resolves the real terminal choices for a held
153
+ // approval; a structured question keeps its own answer channel.
154
+ if (["claude", "opencode", "codex"].includes(target.source)) {
155
+ await agentHooks.syncTerminalDialog(target, waiting && !pendingQuestions?.length);
156
+ pendingApproval = agentHooks.approval(target);
157
+ }
158
+ const hookPrompt = waiting ? agentHooks.terminalPrompt(target) : undefined;
159
+ // Codex 0.155's queued follow-up question never becomes a held
160
+ // PermissionRequest: it lives as a thread item the terminal shows
161
+ // under "Queued follow-up inputs". With nothing else to ask, read
162
+ // its text and options and publish them as the same choice shape
163
+ // the phone already answers with keys (alt+up, then the option).
164
+ const terminalPrompt = hookPrompt
165
+ ?? (waiting && target.source === "codex" && !pendingQuestions?.length
166
+ ? await queuedQuestion(target.session).then(queued => queued ? {
167
+ toolName: "Question", message: queued.title, queued: true,
168
+ choice: { title: queued.title, options: queued.options },
169
+ } : undefined).catch(() => undefined)
170
+ : undefined);
171
+ const historyHealth = target.source === "codex" ? await threadHealth(target.session, pane.agent_status) : { stalled: false };
172
+ send(client, { agentStatus: { source: target.source, session: target.session,
173
+ status: pendingApproval ? "waiting" : pane.agent_status, pendingApproval, pendingQuestions, terminalPrompt,
174
+ ...(waiting && agentHooks.passwordPrompt(target) ? { passwordPrompt: true } : {}),
175
+ compacting: agentHooks.compacting(target),
176
+ ...(historyHealth.stalled ? { historyStalled: true, historyStalledSince: historyHealth.since } : {}),
177
+ modules: info.modules, store: info.store, profile: info.profile, generation: info.generation,
178
+ capabilities: { ...activeCapabilities, asyncQuestions: target.source === "codex" && codexQuestions.available }, branch } });
179
+ }
180
+ if (sideAnswers && sideQuestions) {
181
+ for (const { revision, ...side } of sideQuestions.list(target)) {
182
+ if (sentSide.get(side.id) === revision)
183
+ continue;
184
+ sentSide.set(side.id, revision);
185
+ send(client, { type: "side-answer", ...conversation, ...side });
186
+ }
187
+ }
188
+ first = false;
189
+ }
190
+ while (pending.length && reader && !abort.signal.aborted) {
191
+ const before = pending.shift();
192
+ await validateTarget(target, false, false, SNAPSHOT_SHARE_MS);
193
+ const page = await reader.read(before, abort.signal);
194
+ send(client, { ...page, type: "older", ...conversation });
195
+ }
196
+ }
197
+ catch (error) {
198
+ const reason = streamCloseReason(error);
199
+ if (!(error instanceof BridgeError && error.status === 409))
200
+ logger.warn("stream", `${url.pathname} closed: ${reason}`);
201
+ stop();
202
+ client.close(1011, reason);
203
+ }
204
+ finally {
205
+ busy = false;
206
+ if (pending.length)
207
+ void tick();
208
+ }
209
+ };
210
+ client.on("message", bytes => {
211
+ try {
212
+ const message = object(JSON.parse(bytes.toString()));
213
+ if (message.type !== "older" || url.pathname !== "/v1/transcripts" || abort.signal.aborted)
214
+ return;
215
+ const before = z.number().int().positive().parse(message.beforeLine);
216
+ if (pending.length >= 8)
217
+ throw new Error("History queue is full");
218
+ if (!pending.includes(before))
219
+ pending.push(before);
220
+ void tick();
221
+ }
222
+ catch {
223
+ stop();
224
+ client.close(1008, "Invalid history request");
225
+ }
226
+ });
227
+ try {
228
+ initialPane = await validateTarget(target);
229
+ if (abort.signal.aborted)
230
+ return;
231
+ unwatch = agentHooks.watch(target);
232
+ if (url.pathname === "/v1/transcripts") {
233
+ const opened = child === null ? await conversationReader(target) : await childConversationReader(target, child);
234
+ reader = opened.reader;
235
+ conversation = { source: opened.source, session: opened.session };
236
+ awaitingTranscript = child === null && !reader;
237
+ lastTranscriptLookup = Date.now();
238
+ }
239
+ if (abort.signal.aborted) {
240
+ stop();
241
+ return;
242
+ }
243
+ ready = true;
244
+ timer = setInterval(() => { countTick(url.pathname === "/v1/transcripts" ? "stream-transcripts" : "stream-status"); void tick(); }, reader || awaitingTranscript ? 500 : 1500);
245
+ await tick();
246
+ }
247
+ catch (error) {
248
+ stop();
249
+ throw error;
250
+ }
251
+ }
252
+ return { conversationReader, childConversationReader, emptyPage, stream };
253
+ }
@@ -1,16 +1,4 @@
1
- export declare const capabilities: {
2
- transcript: boolean;
3
- progress: boolean;
4
- images: boolean;
5
- prompt: boolean;
6
- stop: boolean;
7
- terminal: string;
8
- herdr: boolean;
9
- diff: boolean;
10
- webServers: boolean;
11
- activity: boolean;
12
- approvals: boolean;
13
- questions: boolean;
14
- providers: string[];
15
- };
1
+ export { capabilities, capabilitiesForModules, requireRoute } from "./server-routes.js";
2
+ export { streamCloseReason } from "./server-stream.js";
3
+ export { herdrAgentName, launchSession } from "./server-launch.js";
16
4
  export declare function serve(version: string): Promise<void>;