@adhdev/daemon-core 0.9.82-rc.32 → 0.9.82-rc.320

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 (306) hide show
  1. package/dist/boot/daemon-lifecycle.d.ts +8 -0
  2. package/dist/boot/process-hardening.d.ts +50 -0
  3. package/dist/build-info.d.ts +37 -0
  4. package/dist/chat/source-machine.d.ts +166 -0
  5. package/dist/chat/source-resolver.d.ts +104 -0
  6. package/dist/chat/subscription-updates.d.ts +1 -0
  7. package/dist/cli-adapter-types.d.ts +46 -2
  8. package/dist/cli-adapters/cli-script-runner.d.ts +117 -0
  9. package/dist/cli-adapters/cli-state-engine.d.ts +198 -0
  10. package/dist/cli-adapters/provider-cli-adapter.d.ts +115 -64
  11. package/dist/cli-adapters/provider-cli-parse.d.ts +4 -0
  12. package/dist/cli-adapters/provider-cli-runtime.d.ts +34 -0
  13. package/dist/cli-adapters/provider-cli-shared.d.ts +38 -0
  14. package/dist/cli-adapters/raw-terminal-io.d.ts +37 -0
  15. package/dist/cli-adapters/resolve-executable.d.ts +14 -0
  16. package/dist/cli-adapters/terminal-backends/ghostty-vt-backend.d.ts +6 -3
  17. package/dist/cli-adapters/terminal-backends/types.d.ts +10 -2
  18. package/dist/cli-adapters/terminal-screen.d.ts +4 -11
  19. package/dist/commands/cli-manager.d.ts +2 -1
  20. package/dist/commands/handler.d.ts +110 -0
  21. package/dist/commands/mesh-coordinator.d.ts +85 -1
  22. package/dist/commands/router.d.ts +229 -1
  23. package/dist/commands/upgrade-helper.d.ts +12 -0
  24. package/dist/config/chat-history.d.ts +9 -0
  25. package/dist/config/config.d.ts +5 -0
  26. package/dist/config/mesh-config.d.ts +72 -1
  27. package/dist/detection/ide-detector.d.ts +13 -0
  28. package/dist/detection/win32-ide-version.d.ts +37 -0
  29. package/dist/git/git-commands.d.ts +9 -1
  30. package/dist/git/git-diff.d.ts +6 -0
  31. package/dist/git/git-executor.d.ts +11 -0
  32. package/dist/git/git-status.d.ts +9 -0
  33. package/dist/git/git-types.d.ts +2 -50
  34. package/dist/index.d.ts +51 -12
  35. package/dist/index.js +36031 -12365
  36. package/dist/index.js.map +1 -1
  37. package/dist/index.mjs +40382 -16833
  38. package/dist/index.mjs.map +1 -1
  39. package/dist/installer.d.ts +1 -4
  40. package/dist/ipc/local-ipc-server.d.ts +91 -0
  41. package/dist/launch.d.ts +1 -1
  42. package/dist/logging/async-batch-writer.d.ts +10 -0
  43. package/dist/logging/log-redactor.d.ts +24 -0
  44. package/dist/logging/log-tail-reader.d.ts +46 -0
  45. package/dist/mesh/contracts.d.ts +164 -0
  46. package/dist/mesh/coordinator-prompt.d.ts +36 -0
  47. package/dist/mesh/coordinator-registry.d.ts +59 -0
  48. package/dist/mesh/mesh-active-work.d.ts +108 -0
  49. package/dist/mesh/mesh-delivery-policy.d.ts +131 -0
  50. package/dist/mesh/mesh-events-coordinator.d.ts +169 -0
  51. package/dist/mesh/mesh-events-pending.d.ts +45 -0
  52. package/dist/mesh/mesh-events-stale.d.ts +40 -0
  53. package/dist/mesh/mesh-events-utils.d.ts +47 -0
  54. package/dist/mesh/mesh-events.d.ts +6 -49
  55. package/dist/mesh/mesh-fast-forward.d.ts +81 -0
  56. package/dist/mesh/mesh-host-ownership.d.ts +9 -0
  57. package/dist/mesh/mesh-init.d.ts +86 -0
  58. package/dist/mesh/mesh-ledger-reconciliation.d.ts +23 -3
  59. package/dist/mesh/mesh-ledger.d.ts +77 -1
  60. package/dist/mesh/mesh-missions.d.ts +116 -0
  61. package/dist/mesh/mesh-reconcile-loop.d.ts +7 -0
  62. package/dist/mesh/mesh-refine-batch.d.ts +68 -0
  63. package/dist/mesh/mesh-refine-status.d.ts +62 -0
  64. package/dist/mesh/mesh-review-inbox.d.ts +90 -0
  65. package/dist/mesh/mesh-routing.d.ts +70 -0
  66. package/dist/mesh/mesh-runtime-store.d.ts +401 -0
  67. package/dist/mesh/mesh-task-stats.d.ts +49 -0
  68. package/dist/mesh/mesh-unresolved-forward-outbox.d.ts +30 -0
  69. package/dist/mesh/mesh-work-queue.d.ts +226 -5
  70. package/dist/mesh/preview-freshness.d.ts +18 -0
  71. package/dist/mesh/refine-config.d.ts +215 -0
  72. package/dist/mesh/worktree-bootstrap-config.d.ts +135 -0
  73. package/dist/providers/acp-provider-instance.d.ts +2 -0
  74. package/dist/providers/approval-utils.d.ts +13 -0
  75. package/dist/providers/cli-provider-instance.d.ts +61 -3
  76. package/dist/providers/contracts.d.ts +130 -6
  77. package/dist/providers/external-sources.d.ts +71 -0
  78. package/dist/providers/native-history/antigravity-cli-transcript.d.ts +100 -0
  79. package/dist/providers/native-history/claude-cli-transcript.d.ts +70 -0
  80. package/dist/providers/native-history/codex-cli-transcript.d.ts +73 -0
  81. package/dist/providers/native-history/dispatcher.d.ts +27 -0
  82. package/dist/providers/native-history/hermes-cli-transcript.d.ts +30 -0
  83. package/dist/providers/native-history/index.d.ts +13 -0
  84. package/dist/providers/provider-instance-manager.d.ts +13 -0
  85. package/dist/providers/provider-instance.d.ts +13 -1
  86. package/dist/providers/provider-loader.d.ts +26 -4
  87. package/dist/providers/provider-trust.d.ts +31 -0
  88. package/dist/providers/read-chat-contract.d.ts +29 -0
  89. package/dist/providers/sdk/v1/builders/acp/detect-status.d.ts +68 -0
  90. package/dist/providers/sdk/v1/builders/cli/detect-status.d.ts +85 -0
  91. package/dist/providers/sdk/v1/builders/cli/parse-approval-squash.d.ts +59 -0
  92. package/dist/providers/sdk/v1/builders/cli/parse-approval.d.ts +65 -0
  93. package/dist/providers/sdk/v1/builders/cli/parse-session.d.ts +91 -0
  94. package/dist/providers/sdk/v1/builders/cli/visible-region.d.ts +42 -0
  95. package/dist/providers/sdk/v1/fixture-tooling/format.d.ts +126 -0
  96. package/dist/providers/sdk/v1/fixture-tooling/index.d.ts +8 -0
  97. package/dist/providers/sdk/v1/fixture-tooling/replay.d.ts +38 -0
  98. package/dist/providers/sdk/v1/index.d.ts +30 -0
  99. package/dist/providers/sdk/v1/sandbox/README-design.d.ts +193 -0
  100. package/dist/providers/sdk/v1/sandbox/require-whitelist.d.ts +74 -0
  101. package/dist/providers/sdk/v1/sandbox/script-runner.d.ts +98 -0
  102. package/dist/providers/sdk/v1/types/cli/index.d.ts +277 -0
  103. package/dist/providers/sdk/v1/types/common/index.d.ts +203 -0
  104. package/dist/providers/sdk/v1/validators/index.d.ts +5 -0
  105. package/dist/providers/sdk/v1/validators/manifest.d.ts +40 -0
  106. package/dist/providers/sdk/v1/validators/taint.d.ts +52 -0
  107. package/dist/providers/spec/adapter.d.ts +69 -0
  108. package/dist/providers/spec/cli-adapter.d.ts +217 -0
  109. package/dist/providers/spec/evaluator.d.ts +23 -0
  110. package/dist/providers/spec/fsm-driver.d.ts +278 -0
  111. package/dist/providers/spec/fsm-evaluator.d.ts +72 -0
  112. package/dist/providers/spec/fsm-loader.d.ts +14 -0
  113. package/dist/providers/spec/fsm-types.d.ts +128 -0
  114. package/dist/providers/spec/native-history-executor.d.ts +41 -0
  115. package/dist/providers/spec/pre-launch-trust.d.ts +16 -0
  116. package/dist/providers/spec/route.d.ts +4 -0
  117. package/dist/providers/spec/types.d.ts +180 -0
  118. package/dist/providers/transcript-v2.d.ts +176 -0
  119. package/dist/providers/types/interactive-prompt.d.ts +84 -0
  120. package/dist/providers/working-dir.d.ts +17 -0
  121. package/dist/repo-mesh-types.d.ts +365 -13
  122. package/dist/sessions/registry.d.ts +6 -0
  123. package/dist/shared-types-extra.d.ts +2 -4
  124. package/dist/shared-types.d.ts +42 -1
  125. package/dist/status/normalize.d.ts +1 -1
  126. package/dist/status/normalize.js +1 -0
  127. package/dist/status/normalize.js.map +1 -1
  128. package/dist/status/normalize.mjs +1 -0
  129. package/dist/status/normalize.mjs.map +1 -1
  130. package/dist/status/reporter.d.ts +2 -0
  131. package/dist/status/snapshot.d.ts +1 -0
  132. package/dist/types.d.ts +5 -0
  133. package/package.json +7 -3
  134. package/src/agent-stream/poller.ts +2 -3
  135. package/src/boot/daemon-lifecycle.ts +55 -12
  136. package/src/boot/process-hardening.ts +89 -0
  137. package/src/build-info.ts +73 -0
  138. package/src/chat/source-machine.ts +534 -0
  139. package/src/chat/source-resolver.ts +0 -0
  140. package/src/chat/subscription-updates.ts +20 -1
  141. package/src/cli-adapter-types.d.ts +1 -0
  142. package/src/cli-adapter-types.ts +47 -2
  143. package/src/cli-adapters/cli-script-runner.ts +421 -0
  144. package/src/cli-adapters/cli-state-engine.ts +1215 -0
  145. package/src/cli-adapters/provider-cli-adapter.d.ts +1 -1
  146. package/src/cli-adapters/provider-cli-adapter.ts +710 -1140
  147. package/src/cli-adapters/provider-cli-parse.d.ts +1 -0
  148. package/src/cli-adapters/provider-cli-parse.ts +13 -0
  149. package/src/cli-adapters/provider-cli-runtime.ts +56 -7
  150. package/src/cli-adapters/provider-cli-shared.d.ts +2 -0
  151. package/src/cli-adapters/provider-cli-shared.ts +85 -11
  152. package/src/cli-adapters/pty-transport.ts +2 -1
  153. package/src/cli-adapters/raw-terminal-io.ts +252 -0
  154. package/src/cli-adapters/resolve-executable.ts +90 -0
  155. package/src/cli-adapters/session-host-transport.ts +2 -1
  156. package/src/cli-adapters/terminal-backends/ghostty-vt-backend.ts +53 -29
  157. package/src/cli-adapters/terminal-backends/types.ts +10 -3
  158. package/src/cli-adapters/terminal-screen.ts +16 -81
  159. package/src/commands/chat-commands.ts +1822 -61
  160. package/src/commands/cli-manager.ts +286 -14
  161. package/src/commands/handler.ts +809 -2
  162. package/src/commands/mesh-coordinator.ts +332 -122
  163. package/src/commands/router.ts +6370 -704
  164. package/src/commands/stream-commands.ts +8 -0
  165. package/src/commands/upgrade-helper.ts +81 -30
  166. package/src/config/chat-history.ts +483 -24
  167. package/src/config/config.ts +12 -0
  168. package/src/config/mesh-config.ts +391 -4
  169. package/src/config/recent-activity.ts +8 -2
  170. package/src/daemon/dev-auto-implement.ts +3 -2
  171. package/src/daemon/dev-cli-debug.ts +10 -1
  172. package/src/detection/cli-detector.ts +28 -9
  173. package/src/detection/ide-detector.ts +55 -16
  174. package/src/detection/win32-ide-version.ts +106 -0
  175. package/src/git/git-commands.ts +42 -12
  176. package/src/git/git-diff.ts +53 -0
  177. package/src/git/git-executor.ts +12 -0
  178. package/src/git/git-status.ts +408 -43
  179. package/src/git/git-types.ts +14 -62
  180. package/src/git/git-worktree.ts +8 -1
  181. package/src/index.ts +151 -11
  182. package/src/installer.d.ts +1 -1
  183. package/src/installer.ts +8 -6
  184. package/src/ipc/local-ipc-server.ts +278 -0
  185. package/src/launch.d.ts +1 -1
  186. package/src/launch.ts +37 -28
  187. package/src/logging/async-batch-writer.ts +55 -0
  188. package/src/logging/log-redactor.ts +100 -0
  189. package/src/logging/log-tail-reader.ts +220 -0
  190. package/src/logging/logger.ts +2 -1
  191. package/src/mesh/contracts.ts +329 -0
  192. package/src/mesh/coordinator-prompt.ts +235 -31
  193. package/src/mesh/coordinator-registry.ts +121 -0
  194. package/src/mesh/mesh-active-work.ts +469 -0
  195. package/src/mesh/mesh-delivery-policy.ts +315 -0
  196. package/src/mesh/mesh-events-coordinator.ts +2102 -0
  197. package/src/mesh/mesh-events-pending.ts +508 -0
  198. package/src/mesh/mesh-events-stale.ts +290 -0
  199. package/src/mesh/mesh-events-utils.ts +254 -0
  200. package/src/mesh/mesh-events.ts +30 -1035
  201. package/src/mesh/mesh-fast-forward.ts +839 -0
  202. package/src/mesh/mesh-host-ownership.ts +73 -0
  203. package/src/mesh/mesh-init.ts +260 -0
  204. package/src/mesh/mesh-ledger-reconciliation.ts +12 -5
  205. package/src/mesh/mesh-ledger.ts +589 -102
  206. package/src/mesh/mesh-missions.ts +248 -0
  207. package/src/mesh/mesh-reconcile-loop.ts +496 -0
  208. package/src/mesh/mesh-refine-batch.ts +197 -0
  209. package/src/mesh/mesh-refine-status.ts +231 -0
  210. package/src/mesh/mesh-review-inbox.ts +307 -0
  211. package/src/mesh/mesh-routing.ts +291 -0
  212. package/src/mesh/mesh-runtime-store.ts +1578 -0
  213. package/src/mesh/mesh-task-stats.ts +154 -0
  214. package/src/mesh/mesh-unresolved-forward-outbox.ts +185 -0
  215. package/src/mesh/mesh-work-queue.ts +780 -139
  216. package/src/mesh/preview-freshness.ts +118 -0
  217. package/src/mesh/refine-config.ts +403 -0
  218. package/src/mesh/worktree-bootstrap-config.ts +326 -0
  219. package/src/providers/acp-provider-instance.ts +19 -4
  220. package/src/providers/approval-utils.d.ts +4 -0
  221. package/src/providers/approval-utils.ts +47 -5
  222. package/src/providers/chat-message-normalization.ts +4 -11
  223. package/src/providers/cli-provider-instance.ts +958 -91
  224. package/src/providers/contracts.d.ts +55 -0
  225. package/src/providers/contracts.ts +141 -6
  226. package/src/providers/extension-provider-instance.ts +5 -1
  227. package/src/providers/external-sources.ts +218 -0
  228. package/src/providers/ide-provider-instance.ts +25 -6
  229. package/src/providers/native-history/antigravity-cli-transcript.ts +643 -0
  230. package/src/providers/native-history/claude-cli-transcript.ts +396 -0
  231. package/src/providers/native-history/codex-cli-transcript.ts +479 -0
  232. package/src/providers/native-history/dispatcher.ts +340 -0
  233. package/src/providers/native-history/hermes-cli-transcript.ts +230 -0
  234. package/src/providers/native-history/index.ts +30 -0
  235. package/src/providers/provider-instance-manager.ts +30 -0
  236. package/src/providers/provider-instance.ts +10 -1
  237. package/src/providers/provider-loader.ts +662 -50
  238. package/src/providers/provider-schema.ts +87 -14
  239. package/src/providers/provider-trust.ts +114 -0
  240. package/src/providers/read-chat-contract.ts +76 -16
  241. package/src/providers/sdk/README.md +49 -0
  242. package/src/providers/sdk/v1/builders/acp/detect-status.ts +144 -0
  243. package/src/providers/sdk/v1/builders/cli/detect-status.ts +262 -0
  244. package/src/providers/sdk/v1/builders/cli/parse-approval-squash.ts +158 -0
  245. package/src/providers/sdk/v1/builders/cli/parse-approval.ts +250 -0
  246. package/src/providers/sdk/v1/builders/cli/parse-session.ts +276 -0
  247. package/src/providers/sdk/v1/builders/cli/visible-region.ts +143 -0
  248. package/src/providers/sdk/v1/fixture-tooling/format.ts +130 -0
  249. package/src/providers/sdk/v1/fixture-tooling/index.ts +22 -0
  250. package/src/providers/sdk/v1/fixture-tooling/replay.ts +352 -0
  251. package/src/providers/sdk/v1/index.ts +152 -0
  252. package/src/providers/sdk/v1/sandbox/README-design.ts +195 -0
  253. package/src/providers/sdk/v1/sandbox/require-whitelist.ts +472 -0
  254. package/src/providers/sdk/v1/sandbox/script-runner.ts +150 -0
  255. package/src/providers/sdk/v1/schemas/cli/provider.schema.json +504 -0
  256. package/src/providers/sdk/v1/schemas/primitives/acp-session-protocol-v1.json +131 -0
  257. package/src/providers/sdk/v1/schemas/primitives/native-history-codex-rollout-v1.json +66 -0
  258. package/src/providers/sdk/v1/schemas/primitives/tui-approval-squash-v1.json +91 -0
  259. package/src/providers/sdk/v1/schemas/primitives/tui-assistant-block-v1.json +91 -0
  260. package/src/providers/sdk/v1/schemas/primitives/tui-cue-ordering-v1.json +47 -0
  261. package/src/providers/sdk/v1/schemas/primitives/tui-dispatch-order-v1.json +32 -0
  262. package/src/providers/sdk/v1/schemas/primitives/tui-footer-chrome-v1.json +42 -0
  263. package/src/providers/sdk/v1/schemas/primitives/tui-index-finder-v1.json +27 -0
  264. package/src/providers/sdk/v1/schemas/primitives/tui-modal-v1.json +125 -0
  265. package/src/providers/sdk/v1/schemas/primitives/tui-prompt-marker-v1.json +45 -0
  266. package/src/providers/sdk/v1/schemas/primitives/tui-session-id-extraction-v1.json +46 -0
  267. package/src/providers/sdk/v1/schemas/primitives/tui-settled-prompt-v1.json +71 -0
  268. package/src/providers/sdk/v1/schemas/primitives/tui-spinner-v1.json +83 -0
  269. package/src/providers/sdk/v1/schemas/primitives/tui-transcript-pty-v1.json +83 -0
  270. package/src/providers/sdk/v1/schemas/primitives/tui-visible-region-v1.json +57 -0
  271. package/src/providers/sdk/v1/schemas/primitives/tui-welcome-screen-v1.json +35 -0
  272. package/src/providers/sdk/v1/types/cli/index.ts +365 -0
  273. package/src/providers/sdk/v1/types/common/index.ts +229 -0
  274. package/src/providers/sdk/v1/validators/index.ts +19 -0
  275. package/src/providers/sdk/v1/validators/manifest.ts +110 -0
  276. package/src/providers/sdk/v1/validators/taint.ts +309 -0
  277. package/src/providers/spec/adapter.ts +168 -0
  278. package/src/providers/spec/cli-adapter.ts +986 -0
  279. package/src/providers/spec/evaluator.ts +345 -0
  280. package/src/providers/spec/fsm-driver.ts +909 -0
  281. package/src/providers/spec/fsm-evaluator.ts +255 -0
  282. package/src/providers/spec/fsm-loader.ts +112 -0
  283. package/src/providers/spec/fsm-types.ts +222 -0
  284. package/src/providers/spec/native-history-executor.ts +1136 -0
  285. package/src/providers/spec/pre-launch-trust.ts +104 -0
  286. package/src/providers/spec/route.ts +51 -0
  287. package/src/providers/spec/types.ts +226 -0
  288. package/src/providers/transcript-v2.ts +567 -0
  289. package/src/providers/types/interactive-prompt.ts +536 -0
  290. package/src/providers/version-archive.ts +64 -24
  291. package/src/providers/working-dir.ts +23 -0
  292. package/src/repo-mesh-types.ts +494 -13
  293. package/src/sessions/registry.ts +6 -0
  294. package/src/shared-types-extra.ts +2 -4
  295. package/src/shared-types.ts +45 -1
  296. package/src/status/builders.ts +26 -6
  297. package/src/status/normalize.ts +2 -0
  298. package/src/status/reporter.ts +15 -0
  299. package/src/status/snapshot.ts +84 -25
  300. package/src/system/host-memory.ts +29 -12
  301. package/src/types.ts +5 -0
  302. package/dist/cli-adapters/terminal-backends/xterm-backend.d.ts +0 -17
  303. package/dist/mesh/mesh-sync.d.ts +0 -53
  304. package/src/cli-adapters/terminal-backends/ghostty-vt-backend.d.ts +0 -16
  305. package/src/cli-adapters/terminal-backends/xterm-backend.ts +0 -97
  306. package/src/mesh/mesh-sync.ts +0 -111
@@ -6,6 +6,7 @@ import {
6
6
  type SessionHostRecord,
7
7
  } from '@adhdev/session-host-core';
8
8
  import { LOG } from '../logging/logger.js';
9
+ import { resolveWin32Executable } from './resolve-executable.js';
9
10
  import type { PtyRuntimeMetadata, PtyRuntimeTransport, PtySpawnOptions, PtyTransportFactory } from './pty-transport.js';
10
11
 
11
12
  interface SessionHostPtyTransportFactoryOptions {
@@ -435,7 +436,7 @@ export class SessionHostPtyTransportFactory implements PtyTransportFactory {
435
436
  spawn(command: string, args: string[], spawnOptions: PtySpawnOptions): PtyRuntimeTransport {
436
437
  return new SessionHostRuntimeTransport({
437
438
  ...this.options,
438
- command,
439
+ command: resolveWin32Executable(command),
439
440
  args,
440
441
  spawnOptions,
441
442
  });
@@ -1,7 +1,6 @@
1
1
  import type {
2
2
  TerminalViewportBackend,
3
3
  TerminalViewportBackendOptions,
4
- TerminalViewportBackendPreference,
5
4
  } from './types.js';
6
5
 
7
6
  type GhosttyVtTerminal = {
@@ -49,12 +48,10 @@ function getBindingCandidates(): string[] {
49
48
  return explicit ? [explicit] : DEFAULT_BINDING_CANDIDATES;
50
49
  }
51
50
 
52
- function loadGhosttyVtBinding(required: boolean): GhosttyVtBinding | null {
51
+ function loadGhosttyVtBinding(): GhosttyVtBinding {
53
52
  if (cachedBinding !== undefined) {
54
- if (!cachedBinding && required && cachedBindingError) {
55
- throw cachedBindingError;
56
- }
57
- return cachedBinding;
53
+ if (!cachedBinding && cachedBindingError) throw cachedBindingError;
54
+ return cachedBinding!;
58
55
  }
59
56
 
60
57
  const errors: string[] = [];
@@ -65,7 +62,7 @@ function loadGhosttyVtBinding(required: boolean): GhosttyVtBinding | null {
65
62
  const mod = require(ref);
66
63
  cachedBinding = normalizeBinding(mod, ref);
67
64
  cachedBindingError = null;
68
- return cachedBinding;
65
+ return cachedBinding!;
69
66
  } catch (error) {
70
67
  if (isModuleNotFoundError(error, ref)) {
71
68
  errors.push(`${ref}: module not found`);
@@ -78,57 +75,84 @@ function loadGhosttyVtBinding(required: boolean): GhosttyVtBinding | null {
78
75
 
79
76
  cachedBinding = null;
80
77
  cachedBindingError = new Error(
81
- `ghostty-vt backend requested but no binding is available (${errors.join('; ') || 'no candidates tried'})`,
78
+ `ghostty-vt binding unavailable (${errors.join('; ') || 'no candidates tried'})`,
82
79
  );
83
-
84
- if (required) throw cachedBindingError;
85
- return null;
86
- }
87
-
88
- export function resolveTerminalBackendPreference(): TerminalViewportBackendPreference {
89
- const raw = process.env.ADHDEV_TERMINAL_BACKEND?.trim().toLowerCase();
90
- if (raw === 'ghostty-vt' || raw === 'xterm' || raw === 'auto') return raw;
91
- return 'auto';
92
- }
93
-
94
- export function isGhosttyVtBackendAvailable(): boolean {
95
- return !!loadGhosttyVtBinding(false);
80
+ throw cachedBindingError;
96
81
  }
97
82
 
98
83
  export class GhosttyVtTerminalBackend implements TerminalViewportBackend {
99
84
  readonly kind = 'ghostty-vt' as const;
100
85
  private terminal: GhosttyVtTerminal;
86
+ private rows: number;
87
+ private disposed = false;
101
88
 
102
89
  constructor(options: TerminalViewportBackendOptions) {
103
- const binding = loadGhosttyVtBinding(true);
104
- if (!binding) {
105
- throw new Error('ghostty-vt backend requested but no binding is available');
106
- }
90
+ const binding = loadGhosttyVtBinding();
91
+ this.rows = Math.max(1, options.rows | 0);
107
92
  this.terminal = binding.createTerminal({
108
93
  cols: Math.max(1, options.cols | 0),
109
- rows: Math.max(1, options.rows | 0),
94
+ rows: this.rows,
110
95
  scrollback: Math.max(0, options.scrollback | 0),
111
96
  });
112
97
  }
113
98
 
114
99
  resize(rows: number, cols: number): void {
115
- this.terminal.resize(Math.max(1, cols | 0), Math.max(1, rows | 0));
100
+ this.rows = Math.max(1, rows | 0);
101
+ this.terminal.resize(Math.max(1, cols | 0), this.rows);
116
102
  }
117
103
 
118
104
  write(data: string): void {
119
- if (!data) return;
105
+ if (!data || this.disposed) return;
120
106
  this.terminal.write(data);
121
107
  }
122
108
 
109
+ private formatLines(): string[] {
110
+ // ghostty's `trim:true` collapses CUF-advanced cells — many TUIs including
111
+ // Claude Code render spaces via cursor-forward rather than literal spaces,
112
+ // which would break downstream regex matching. Keep per-row padding and
113
+ // trim trailing whitespace ourselves.
114
+ //
115
+ // formatPlainText uses a .screen pin which includes scrollback history.
116
+ const raw = this.terminal.formatPlainText({ trim: false }) || '';
117
+ if (!raw) return [];
118
+ return raw.split('\n').map((row) => row.replace(/\s+$/, ''));
119
+ }
120
+
121
+ private static trimBlankEnds(lines: string[]): string {
122
+ let first = 0;
123
+ let last = lines.length;
124
+ while (first < last && !lines[first]) first += 1;
125
+ while (last > first && !lines[last - 1]) last -= 1;
126
+ return lines.slice(first, last).join('\n');
127
+ }
128
+
123
129
  getText(): string {
124
- return this.terminal.formatPlainText({ trim: true }) || '';
130
+ if (this.disposed) return '';
131
+ const lines = this.formatLines();
132
+ if (lines.length === 0) return '';
133
+ // Take only the viewport (last `rows` lines) to exclude scrollback history.
134
+ const viewport = lines.length > this.rows ? lines.slice(-this.rows) : lines;
135
+ return GhosttyVtTerminalBackend.trimBlankEnds(viewport);
136
+ }
137
+
138
+ getTextWithScrollback(): string {
139
+ if (this.disposed) return '';
140
+ const lines = this.formatLines();
141
+ if (lines.length === 0) return '';
142
+ // Full buffer including scrollback — does NOT slice to the viewport, so a
143
+ // tall prompt whose top has scrolled above the visible rows is still
144
+ // matchable by content patterns.
145
+ return GhosttyVtTerminalBackend.trimBlankEnds(lines);
125
146
  }
126
147
 
127
148
  getCursorPosition(): { col: number; row: number } {
149
+ if (this.disposed) return { col: 0, row: 0 };
128
150
  return this.terminal.getCursorPosition();
129
151
  }
130
152
 
131
153
  dispose(): void {
154
+ if (this.disposed) return;
155
+ this.disposed = true;
132
156
  this.terminal.dispose();
133
157
  }
134
158
  }
@@ -1,6 +1,4 @@
1
- export type TerminalViewportBackendKind = 'xterm' | 'ghostty-vt';
2
-
3
- export type TerminalViewportBackendPreference = TerminalViewportBackendKind | 'auto';
1
+ export type TerminalViewportBackendKind = 'ghostty-vt';
4
2
 
5
3
  export type TerminalViewportBackendOptions = {
6
4
  rows: number;
@@ -13,6 +11,15 @@ export interface TerminalViewportBackend {
13
11
  resize(rows: number, cols: number): void;
14
12
  write(data: string): void;
15
13
  getText(): string;
14
+ /**
15
+ * Like getText() but includes scrollback history (the lines that have
16
+ * scrolled above the visible viewport). Used by content-pattern matching
17
+ * (e.g. approval/modal button extraction) that must stay correct when a
18
+ * tall prompt — a big diff or long explanation — pushes part of the
19
+ * prompt box above the viewport. NOT for cursor-relative / stable_ms
20
+ * conditions, whose row indices are viewport-relative.
21
+ */
22
+ getTextWithScrollback(): string;
16
23
  getCursorPosition(): { col: number; row: number };
17
24
  dispose(): void;
18
25
  }
@@ -1,99 +1,29 @@
1
1
  /**
2
- * PTY screen snapshot abstraction.
3
- *
4
- * Terminal viewport backend selection.
5
- *
6
- * Runtime preference is backend-agnostic:
7
- * - prefer ghostty-vt when available (or when explicitly requested)
8
- * - fall back to xterm when ghostty-vt is unavailable
2
+ * PTY screen snapshot abstraction — ghostty-vt backend.
9
3
  */
10
4
 
11
- import { LOG } from '../logging/logger.js';
12
- import { GhosttyVtTerminalBackend, isGhosttyVtBackendAvailable, resolveTerminalBackendPreference } from './terminal-backends/ghostty-vt-backend.js';
13
- import type {
14
- TerminalViewportBackend,
15
- TerminalViewportBackendKind,
16
- TerminalViewportBackendOptions,
17
- TerminalViewportBackendPreference,
18
- } from './terminal-backends/types.js';
19
- import { XtermTerminalBackend } from './terminal-backends/xterm-backend.js';
5
+ import { GhosttyVtTerminalBackend } from './terminal-backends/ghostty-vt-backend.js';
6
+ import type { TerminalViewportBackendKind } from './terminal-backends/types.js';
7
+ import { DEFAULT_SESSION_HOST_COLS, DEFAULT_SESSION_HOST_ROWS } from '@adhdev/session-host-core';
20
8
 
21
9
  const DEFAULT_SCROLLBACK = 2000;
22
- const loggedTerminalBackends = new Set<string>();
23
10
 
24
11
  export function getTerminalBackendRuntimeStatus(): {
25
12
  backend: TerminalViewportBackendKind;
26
- preference: TerminalViewportBackendPreference;
27
- ghosttyAvailable: boolean;
28
13
  } {
29
- const preference = resolveTerminalBackendPreference();
30
- const ghosttyAvailable = isGhosttyVtBackendAvailable();
31
- const backend: TerminalViewportBackendKind = (
32
- preference === 'ghostty-vt' || (preference === 'auto' && ghosttyAvailable)
33
- ? 'ghostty-vt'
34
- : 'xterm'
35
- );
36
- return { backend, preference, ghosttyAvailable };
37
- }
38
-
39
- function createTerminalBackend(
40
- options: TerminalViewportBackendOptions,
41
- preference: TerminalViewportBackendPreference,
42
- ): TerminalViewportBackend {
43
- const ghosttyAvailable = isGhosttyVtBackendAvailable();
44
- if (preference === 'ghostty-vt') {
45
- const backend = new GhosttyVtTerminalBackend(options);
46
- logTerminalBackendSelection(preference, ghosttyAvailable, backend.kind);
47
- return backend;
48
- }
49
-
50
- if (preference === 'auto' && ghosttyAvailable) {
51
- const backend = new GhosttyVtTerminalBackend(options);
52
- logTerminalBackendSelection(preference, ghosttyAvailable, backend.kind);
53
- return backend;
54
- }
55
-
56
- const backend = new XtermTerminalBackend(options);
57
- logTerminalBackendSelection(preference, ghosttyAvailable, backend.kind);
58
- return backend;
59
- }
60
-
61
- function logTerminalBackendSelection(
62
- preference: TerminalViewportBackendPreference,
63
- ghosttyAvailable: boolean,
64
- backendKind: TerminalViewportBackendKind,
65
- ): void {
66
- const key = `${preference}:${ghosttyAvailable}:${backendKind}`;
67
- if (loggedTerminalBackends.has(key)) return;
68
- loggedTerminalBackends.add(key);
69
- if (backendKind === 'xterm' && preference !== 'xterm' && !ghosttyAvailable) {
70
- const message = `[terminal-screen] ghostty-vt unavailable; using xterm fallback (preference=${preference})`;
71
- if (preference === 'auto') {
72
- LOG.info('Terminal', message);
73
- } else {
74
- LOG.warn('Terminal', message);
75
- }
76
- return;
77
- }
78
- LOG.info(
79
- 'Terminal',
80
- `[terminal-screen] backend=${backendKind} preference=${preference} ghosttyAvailable=${ghosttyAvailable}`,
81
- );
14
+ return { backend: 'ghostty-vt' };
82
15
  }
83
16
 
84
17
  export class TerminalScreen {
85
- readonly backendKind: TerminalViewportBackendKind;
18
+ readonly backendKind: TerminalViewportBackendKind = 'ghostty-vt';
86
19
  private rows: number;
87
20
  private cols: number;
88
- private readonly preference: TerminalViewportBackendPreference;
89
- private terminal: TerminalViewportBackend;
21
+ private terminal: GhosttyVtTerminalBackend;
90
22
 
91
- constructor(rows = 40, cols = 120) {
23
+ constructor(rows = DEFAULT_SESSION_HOST_ROWS, cols = DEFAULT_SESSION_HOST_COLS) {
92
24
  this.rows = Math.max(1, rows | 0);
93
25
  this.cols = Math.max(1, cols | 0);
94
- this.preference = resolveTerminalBackendPreference();
95
26
  this.terminal = this.createBackend();
96
- this.backendKind = this.terminal.kind;
97
27
  }
98
28
 
99
29
  reset(rows = this.rows, cols = this.cols): void {
@@ -117,6 +47,11 @@ export class TerminalScreen {
117
47
  return this.terminal.getText();
118
48
  }
119
49
 
50
+ /** Full buffer including scrollback history (see backend doc). */
51
+ getTextWithScrollback(): string {
52
+ return this.terminal.getTextWithScrollback();
53
+ }
54
+
120
55
  getCursorPosition(): { col: number; row: number } {
121
56
  return this.terminal.getCursorPosition();
122
57
  }
@@ -125,11 +60,11 @@ export class TerminalScreen {
125
60
  this.terminal.dispose();
126
61
  }
127
62
 
128
- private createBackend(): TerminalViewportBackend {
129
- return createTerminalBackend({
63
+ private createBackend(): GhosttyVtTerminalBackend {
64
+ return new GhosttyVtTerminalBackend({
130
65
  cols: this.cols,
131
66
  rows: this.rows,
132
67
  scrollback: DEFAULT_SCROLLBACK,
133
- }, this.preference);
68
+ });
134
69
  }
135
70
  }