@pi-in-go/pigpen-ahp 0.1.0

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 (304) hide show
  1. package/CREDITS.md +27 -0
  2. package/LICENSE +23 -0
  3. package/README.md +148 -0
  4. package/extensions/ahp/access_options_test.go +116 -0
  5. package/extensions/ahp/extension.go +54 -0
  6. package/extensions/ahp/go.mod +12 -0
  7. package/extensions/ahp/go.sum +2 -0
  8. package/extensions/ahp/go.work +8 -0
  9. package/extensions/ahp/internal/channels/chat.go +110 -0
  10. package/extensions/ahp/internal/channels/root.go +32 -0
  11. package/extensions/ahp/internal/channels/session.go +128 -0
  12. package/extensions/ahp/internal/channels/session_test.go +108 -0
  13. package/extensions/ahp/internal/compose/compose.go +153 -0
  14. package/extensions/ahp/internal/compose/compose_test.go +120 -0
  15. package/extensions/ahp/internal/gaps/gaps_test.go +88 -0
  16. package/extensions/ahp/internal/host/handshake_test.go +206 -0
  17. package/extensions/ahp/internal/host/host.go +1305 -0
  18. package/extensions/ahp/internal/host/reconnect_test.go +197 -0
  19. package/extensions/ahp/internal/host/replaywindow_test.go +31 -0
  20. package/extensions/ahp/internal/host/schema_test.go +79 -0
  21. package/extensions/ahp/internal/host/store.go +291 -0
  22. package/extensions/ahp/internal/host/store_update_test.go +85 -0
  23. package/extensions/ahp/internal/host/subscriptions_test.go +160 -0
  24. package/extensions/ahp/internal/host/surface_test.go +95 -0
  25. package/extensions/ahp/internal/host/workarounds.go +458 -0
  26. package/extensions/ahp/internal/host/workarounds_test.go +96 -0
  27. package/extensions/ahp/internal/live/live.go +328 -0
  28. package/extensions/ahp/internal/live/live_test.go +91 -0
  29. package/extensions/ahp/internal/live/store.go +113 -0
  30. package/extensions/ahp/internal/mapper/activity.go +199 -0
  31. package/extensions/ahp/internal/mapper/activity_test.go +188 -0
  32. package/extensions/ahp/internal/mapper/bench_test.go +38 -0
  33. package/extensions/ahp/internal/mapper/event_mapper_test.go +380 -0
  34. package/extensions/ahp/internal/mapper/fixtures_test.go +387 -0
  35. package/extensions/ahp/internal/mapper/helpers_test.go +251 -0
  36. package/extensions/ahp/internal/mapper/js.go +131 -0
  37. package/extensions/ahp/internal/mapper/mapper.go +600 -0
  38. package/extensions/ahp/internal/mapper/message_input_test.go +196 -0
  39. package/extensions/ahp/internal/mapper/messageinput.go +272 -0
  40. package/extensions/ahp/internal/mapper/schema_helpers_test.go +5 -0
  41. package/extensions/ahp/internal/mapper/testdata/LICENSE-pi-ahp +21 -0
  42. package/extensions/ahp/internal/mapper/testdata/fixtures/abort.json +711 -0
  43. package/extensions/ahp/internal/mapper/testdata/fixtures/bash-long-output.json +1312 -0
  44. package/extensions/ahp/internal/mapper/testdata/fixtures/compaction.json +6285 -0
  45. package/extensions/ahp/internal/mapper/testdata/fixtures/parallel-tools.json +2622 -0
  46. package/extensions/ahp/internal/mapper/testdata/fixtures/plain-text.json +1856 -0
  47. package/extensions/ahp/internal/mapper/testdata/fixtures/single-tool.json +1128 -0
  48. package/extensions/ahp/internal/mapper/testdata/fixtures/steering.json +3926 -0
  49. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-bash.json +2372 -0
  50. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-edit.json +3983 -0
  51. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-error.json +2850 -0
  52. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-find.json +1162 -0
  53. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-grep.json +2783 -0
  54. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-loop.json +1693 -0
  55. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-ls.json +2427 -0
  56. package/extensions/ahp/internal/mapper/testdata/fixtures/tool-write.json +1271 -0
  57. package/extensions/ahp/internal/mapper/title.go +34 -0
  58. package/extensions/ahp/internal/mapper/usermsg.go +87 -0
  59. package/extensions/ahp/internal/pi/activeturn_test.go +296 -0
  60. package/extensions/ahp/internal/pi/backend.go +64 -0
  61. package/extensions/ahp/internal/pi/catalogue.go +370 -0
  62. package/extensions/ahp/internal/pi/catalogue_test.go +271 -0
  63. package/extensions/ahp/internal/pi/chatdriver.go +533 -0
  64. package/extensions/ahp/internal/pi/chatdriver_test.go +416 -0
  65. package/extensions/ahp/internal/pi/clientactions.go +212 -0
  66. package/extensions/ahp/internal/pi/clientactions_test.go +273 -0
  67. package/extensions/ahp/internal/pi/completions.go +230 -0
  68. package/extensions/ahp/internal/pi/completions_test.go +272 -0
  69. package/extensions/ahp/internal/pi/config_test.go +269 -0
  70. package/extensions/ahp/internal/pi/deletesession.go +69 -0
  71. package/extensions/ahp/internal/pi/deletesession_test.go +153 -0
  72. package/extensions/ahp/internal/pi/disposal_test.go +362 -0
  73. package/extensions/ahp/internal/pi/fixture_test.go +308 -0
  74. package/extensions/ahp/internal/pi/foreign_test.go +122 -0
  75. package/extensions/ahp/internal/pi/harness_test.go +83 -0
  76. package/extensions/ahp/internal/pi/history.go +269 -0
  77. package/extensions/ahp/internal/pi/hydrated_test.go +171 -0
  78. package/extensions/ahp/internal/pi/hydratedlifecycle_test.go +196 -0
  79. package/extensions/ahp/internal/pi/hydration_test.go +209 -0
  80. package/extensions/ahp/internal/pi/hydrator.go +212 -0
  81. package/extensions/ahp/internal/pi/imageinput.go +224 -0
  82. package/extensions/ahp/internal/pi/imageinput_test.go +57 -0
  83. package/extensions/ahp/internal/pi/lifecycle_test.go +381 -0
  84. package/extensions/ahp/internal/pi/models.go +212 -0
  85. package/extensions/ahp/internal/pi/models_test.go +128 -0
  86. package/extensions/ahp/internal/pi/paging.go +95 -0
  87. package/extensions/ahp/internal/pi/pagingtruncate_test.go +323 -0
  88. package/extensions/ahp/internal/pi/projecttrust.go +222 -0
  89. package/extensions/ahp/internal/pi/registry.go +924 -0
  90. package/extensions/ahp/internal/pi/restart_test.go +185 -0
  91. package/extensions/ahp/internal/pi/services.go +70 -0
  92. package/extensions/ahp/internal/pi/sessionconfig.go +64 -0
  93. package/extensions/ahp/internal/pi/sessionfiles_test.go +74 -0
  94. package/extensions/ahp/internal/pi/sessionstore.go +83 -0
  95. package/extensions/ahp/internal/pi/summary_test.go +426 -0
  96. package/extensions/ahp/internal/pi/workarounds_wire_test.go +208 -0
  97. package/extensions/ahp/internal/pisession/fromentries_test.go +32 -0
  98. package/extensions/ahp/internal/pisession/json.go +31 -0
  99. package/extensions/ahp/internal/pisession/pisession.go +580 -0
  100. package/extensions/ahp/internal/settings/access.go +63 -0
  101. package/extensions/ahp/internal/settings/access_test.go +52 -0
  102. package/extensions/ahp/internal/settings/settings.go +117 -0
  103. package/extensions/ahp/internal/settings/settings_test.go +104 -0
  104. package/extensions/ahp/internal/svc/etag_other.go +15 -0
  105. package/extensions/ahp/internal/svc/etag_unix.go +34 -0
  106. package/extensions/ahp/internal/svc/glob.go +197 -0
  107. package/extensions/ahp/internal/svc/mime.go +37 -0
  108. package/extensions/ahp/internal/svc/paths.go +108 -0
  109. package/extensions/ahp/internal/svc/pty.go +64 -0
  110. package/extensions/ahp/internal/svc/pty_darwin.go +42 -0
  111. package/extensions/ahp/internal/svc/pty_linux.go +36 -0
  112. package/extensions/ahp/internal/svc/pty_other.go +9 -0
  113. package/extensions/ahp/internal/svc/pty_test.go +114 -0
  114. package/extensions/ahp/internal/svc/pty_unix.go +147 -0
  115. package/extensions/ahp/internal/svc/resource.go +495 -0
  116. package/extensions/ahp/internal/svc/resource_test.go +501 -0
  117. package/extensions/ahp/internal/svc/stat_bsd.go +9 -0
  118. package/extensions/ahp/internal/svc/stat_linux.go +9 -0
  119. package/extensions/ahp/internal/svc/terminal.go +454 -0
  120. package/extensions/ahp/internal/svc/terminal_test.go +512 -0
  121. package/extensions/ahp/internal/svc/watch.go +590 -0
  122. package/extensions/ahp/internal/svc/watch_test.go +627 -0
  123. package/extensions/ahp/internal/svc/watchevents_test.go +452 -0
  124. package/extensions/ahp/internal/svc/watchpolicy.go +81 -0
  125. package/extensions/ahp/internal/svc/watchpolicy_test.go +151 -0
  126. package/extensions/ahp/internal/svc/watchracy_test.go +61 -0
  127. package/extensions/ahp/internal/testkit/schema/LICENSE-agent-host-protocol +21 -0
  128. package/extensions/ahp/internal/testkit/schema/actions.schema.json +9208 -0
  129. package/extensions/ahp/internal/testkit/schema/commands.schema.json +10862 -0
  130. package/extensions/ahp/internal/testkit/schema/errors.schema.json +10928 -0
  131. package/extensions/ahp/internal/testkit/schema/notifications.schema.json +6667 -0
  132. package/extensions/ahp/internal/testkit/schema/state.schema.json +6392 -0
  133. package/extensions/ahp/internal/testkit/schema.go +360 -0
  134. package/extensions/ahp/internal/testkit/testkit.go +367 -0
  135. package/extensions/ahp/internal/twin/twin.go +27 -0
  136. package/extensions/ahp/internal/wire/dispatchable.go +106 -0
  137. package/extensions/ahp/internal/wire/dispatchable_list.go +15 -0
  138. package/extensions/ahp/internal/wire/helpers_test.go +5 -0
  139. package/extensions/ahp/internal/wire/wire.go +218 -0
  140. package/extensions/ahp/internal/wire/wire_test.go +123 -0
  141. package/extensions/ahp/internal/ws/helpers_test.go +7 -0
  142. package/extensions/ahp/internal/ws/vscode_test.go +198 -0
  143. package/extensions/ahp/internal/ws/ws.go +674 -0
  144. package/extensions/ahp/internal/ws/ws_test.go +324 -0
  145. package/extensions/ahp/realpig_test.go +589 -0
  146. package/extensions/ahp/runtime.go +311 -0
  147. package/extensions/ahp/runtime_test.go +110 -0
  148. package/extensions/ahp/testdata/upstream-tests.json +3833 -0
  149. package/extensions/ahp/third_party/agent-host-protocol-go/LICENSE +21 -0
  150. package/extensions/ahp/third_party/agent-host-protocol-go/NOTICE-PIGPEN.md +18 -0
  151. package/extensions/ahp/third_party/agent-host-protocol-go/ahp/client.go +1011 -0
  152. package/extensions/ahp/third_party/agent-host-protocol-go/ahp/error.go +111 -0
  153. package/extensions/ahp/third_party/agent-host-protocol-go/ahp/multi_host_state_mirror.go +239 -0
  154. package/extensions/ahp/third_party/agent-host-protocol-go/ahp/reducers.go +1939 -0
  155. package/extensions/ahp/third_party/agent-host-protocol-go/ahp/transport.go +176 -0
  156. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/actions.generated.go +2447 -0
  157. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/commands.generated.go +1546 -0
  158. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/common.go +205 -0
  159. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/errors.generated.go +65 -0
  160. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/messages.generated.go +138 -0
  161. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/notifications.generated.go +264 -0
  162. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/state.generated.go +6171 -0
  163. package/extensions/ahp/third_party/agent-host-protocol-go/ahptypes/version.generated.go +31 -0
  164. package/extensions/ahp/third_party/agent-host-protocol-go/go.mod +3 -0
  165. package/extensions/ahp/twins_test.go +91 -0
  166. package/package.json +40 -0
  167. package/proof/PORT.md +121 -0
  168. package/proof/mutations.json +152 -0
  169. package/proof/oracle/LICENSE +21 -0
  170. package/proof/oracle/README.md +120 -0
  171. package/proof/oracle/UPSTREAM.md +7 -0
  172. package/proof/oracle/package.json +68 -0
  173. package/proof/oracle/src/bin/cli.ts +66 -0
  174. package/proof/oracle/src/bin/tunnel.ts +128 -0
  175. package/proof/oracle/src/channels/chat.ts +134 -0
  176. package/proof/oracle/src/channels/root.ts +39 -0
  177. package/proof/oracle/src/channels/session.ts +118 -0
  178. package/proof/oracle/src/channels/terminal.ts +11 -0
  179. package/proof/oracle/src/core/channels.ts +108 -0
  180. package/proof/oracle/src/core/client-workarounds.ts +358 -0
  181. package/proof/oracle/src/core/connection.ts +41 -0
  182. package/proof/oracle/src/core/host.ts +882 -0
  183. package/proof/oracle/src/core/sequencer.ts +75 -0
  184. package/proof/oracle/src/core/state-store.ts +162 -0
  185. package/proof/oracle/src/core/uri.ts +25 -0
  186. package/proof/oracle/src/host/direct-settings.ts +110 -0
  187. package/proof/oracle/src/host/pi-host.ts +220 -0
  188. package/proof/oracle/src/host/serve.ts +71 -0
  189. package/proof/oracle/src/host/terminal-service.ts +346 -0
  190. package/proof/oracle/src/pi/activity.ts +171 -0
  191. package/proof/oracle/src/pi/changeset-service.ts +646 -0
  192. package/proof/oracle/src/pi/changeset-uri.ts +64 -0
  193. package/proof/oracle/src/pi/chat-driver.ts +529 -0
  194. package/proof/oracle/src/pi/completions.ts +160 -0
  195. package/proof/oracle/src/pi/delete-session.ts +53 -0
  196. package/proof/oracle/src/pi/event-mapper.ts +648 -0
  197. package/proof/oracle/src/pi/git-changes.ts +605 -0
  198. package/proof/oracle/src/pi/history.ts +305 -0
  199. package/proof/oracle/src/pi/image-input.ts +56 -0
  200. package/proof/oracle/src/pi/image-mime.ts +8 -0
  201. package/proof/oracle/src/pi/in-process-backend.ts +155 -0
  202. package/proof/oracle/src/pi/message-input.ts +212 -0
  203. package/proof/oracle/src/pi/models.ts +124 -0
  204. package/proof/oracle/src/pi/project-trust.ts +66 -0
  205. package/proof/oracle/src/pi/provider.ts +2 -0
  206. package/proof/oracle/src/pi/resource-paths.ts +80 -0
  207. package/proof/oracle/src/pi/resource-service.ts +356 -0
  208. package/proof/oracle/src/pi/resource-watch-policy.ts +35 -0
  209. package/proof/oracle/src/pi/resource-watch.ts +357 -0
  210. package/proof/oracle/src/pi/session-catalogue.ts +318 -0
  211. package/proof/oracle/src/pi/session-config.ts +84 -0
  212. package/proof/oracle/src/pi/session-history.ts +75 -0
  213. package/proof/oracle/src/pi/session-hydrator.ts +219 -0
  214. package/proof/oracle/src/pi/session-registry.ts +815 -0
  215. package/proof/oracle/src/pi/session-storage.ts +29 -0
  216. package/proof/oracle/src/pi/session-title.ts +18 -0
  217. package/proof/oracle/src/pi/turn-paging.ts +94 -0
  218. package/proof/oracle/src/pi/user-message.ts +66 -0
  219. package/proof/oracle/src/protocol/errors.ts +44 -0
  220. package/proof/oracle/src/protocol/jsonrpc.ts +89 -0
  221. package/proof/oracle/src/protocol/version.ts +39 -0
  222. package/proof/oracle/src/transport/websocket.ts +136 -0
  223. package/proof/oracle/src/tunnel/devtunnel.ts +293 -0
  224. package/proof/oracle/src/tunnel/discovery.ts +37 -0
  225. package/proof/oracle/test/active-turn-reconnect.test.ts +274 -0
  226. package/proof/oracle/test/activity.test.ts +171 -0
  227. package/proof/oracle/test/changeset-lifecycle.test.serial.ts +303 -0
  228. package/proof/oracle/test/changeset-uri.test.ts +37 -0
  229. package/proof/oracle/test/changeset.test.serial.ts +487 -0
  230. package/proof/oracle/test/chat-driver.test.ts +691 -0
  231. package/proof/oracle/test/client-actions.test.ts +409 -0
  232. package/proof/oracle/test/client-workarounds.test.ts +320 -0
  233. package/proof/oracle/test/completions.test.ts +323 -0
  234. package/proof/oracle/test/delete-session.test.ts +142 -0
  235. package/proof/oracle/test/direct-settings.test.ts +81 -0
  236. package/proof/oracle/test/event-mapper.test.ts +619 -0
  237. package/proof/oracle/test/fetch-turns.test.ts +207 -0
  238. package/proof/oracle/test/fixtures/abort.json +711 -0
  239. package/proof/oracle/test/fixtures/bash-long-output.json +1312 -0
  240. package/proof/oracle/test/fixtures/compaction.json +6285 -0
  241. package/proof/oracle/test/fixtures/parallel-tools.json +2622 -0
  242. package/proof/oracle/test/fixtures/plain-text.json +1856 -0
  243. package/proof/oracle/test/fixtures/single-tool.json +1128 -0
  244. package/proof/oracle/test/fixtures/steering.json +3926 -0
  245. package/proof/oracle/test/fixtures/tool-bash.json +2372 -0
  246. package/proof/oracle/test/fixtures/tool-edit.json +3983 -0
  247. package/proof/oracle/test/fixtures/tool-error.json +2850 -0
  248. package/proof/oracle/test/fixtures/tool-find.json +1162 -0
  249. package/proof/oracle/test/fixtures/tool-grep.json +2783 -0
  250. package/proof/oracle/test/fixtures/tool-loop.json +1693 -0
  251. package/proof/oracle/test/fixtures/tool-ls.json +2427 -0
  252. package/proof/oracle/test/fixtures/tool-write.json +1271 -0
  253. package/proof/oracle/test/handshake.test.ts +275 -0
  254. package/proof/oracle/test/harness.ts +153 -0
  255. package/proof/oracle/test/hydrated-session-lifecycle.test.ts +211 -0
  256. package/proof/oracle/test/image-input.test.ts +28 -0
  257. package/proof/oracle/test/image-session.test.ts +69 -0
  258. package/proof/oracle/test/live-turn.test.ts +304 -0
  259. package/proof/oracle/test/mapper-fixtures.test.ts +293 -0
  260. package/proof/oracle/test/message-input.test.ts +181 -0
  261. package/proof/oracle/test/model-discovery.test.ts +170 -0
  262. package/proof/oracle/test/models.test.ts +109 -0
  263. package/proof/oracle/test/pi-host.test.ts +91 -0
  264. package/proof/oracle/test/pi-replay.test.ts +141 -0
  265. package/proof/oracle/test/project-trust.test.ts +125 -0
  266. package/proof/oracle/test/protocol-surface.test.ts +121 -0
  267. package/proof/oracle/test/pty.test.ts +100 -0
  268. package/proof/oracle/test/reconnect.test.ts +389 -0
  269. package/proof/oracle/test/resource-watch-policy.test.ts +78 -0
  270. package/proof/oracle/test/resource-watch.test.serial.ts +536 -0
  271. package/proof/oracle/test/resource.test.ts +499 -0
  272. package/proof/oracle/test/schema.test.ts +88 -0
  273. package/proof/oracle/test/session-catalogue.test.ts +314 -0
  274. package/proof/oracle/test/session-config.test.ts +224 -0
  275. package/proof/oracle/test/session-disposal.test.ts +364 -0
  276. package/proof/oracle/test/session-hydration.test.ts +194 -0
  277. package/proof/oracle/test/session-lifecycle.test.ts +416 -0
  278. package/proof/oracle/test/session-storage.test.serial.ts +32 -0
  279. package/proof/oracle/test/session-summary.test.ts +418 -0
  280. package/proof/oracle/test/subscriptions.test.ts +198 -0
  281. package/proof/oracle/test/support/assertions.ts +32 -0
  282. package/proof/oracle/test/support/async.ts +26 -0
  283. package/proof/oracle/test/support/hydrated-session.ts +205 -0
  284. package/proof/oracle/test/support/images.ts +8 -0
  285. package/proof/oracle/test/support/recorded-fixtures.ts +60 -0
  286. package/proof/oracle/test/support/recorded-scenarios.ts +145 -0
  287. package/proof/oracle/test/support/replay.ts +194 -0
  288. package/proof/oracle/test/support/schema.ts +221 -0
  289. package/proof/oracle/test/support/session-files.ts +12 -0
  290. package/proof/oracle/test/support/session-storage.ts +22 -0
  291. package/proof/oracle/test/support/upstream.ts +25 -0
  292. package/proof/oracle/test/support/watch-events.ts +108 -0
  293. package/proof/oracle/test/terminal-service.test.ts +495 -0
  294. package/proof/oracle/test/truncate.test.ts +230 -0
  295. package/proof/oracle/test/tunnel.test.ts +258 -0
  296. package/proof/oracle/test/upstream-workarounds.test.ts +37 -0
  297. package/proof/oracle/test/uri.test.ts +24 -0
  298. package/proof/oracle/test/watch-events.test.ts +118 -0
  299. package/proof/oracle/tsconfig.json +32 -0
  300. package/proof/proof-piglet/piglet.yaml +18 -0
  301. package/proof/tools/fakellm/go.mod +3 -0
  302. package/proof/tools/fakellm/main.go +109 -0
  303. package/proof/tools/gen-dispatchable.py +30 -0
  304. package/provenance.json +28 -0
@@ -0,0 +1,364 @@
1
+ /** Durable session removal and its concurrency boundary. */
2
+
3
+ import assert from "node:assert/strict";
4
+ import { randomUUID } from "node:crypto";
5
+ import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
6
+ import { tmpdir } from "node:os";
7
+ import { join } from "node:path";
8
+ import { describe, it } from "node:test";
9
+ import type { AgentSessionEvent } from "@earendil-works/pi-coding-agent";
10
+ import {
11
+ ActionType,
12
+ JsonRpcErrorCodes,
13
+ MessageKind,
14
+ PendingMessageKind,
15
+ SessionLifecycle,
16
+ type SessionState,
17
+ SUPPORTED_PROTOCOL_VERSIONS,
18
+ } from "@microsoft/agent-host-protocol";
19
+ import type { AhpClient, Subscription } from "@microsoft/agent-host-protocol/client";
20
+ import { chatUri, ROOT_CHANNEL, sessionUri } from "../src/core/channels.ts";
21
+ import type { PiBackend } from "../src/pi/chat-driver.ts";
22
+ import type { BackendFactory, SessionFileDeletionResult } from "../src/pi/session-registry.ts";
23
+ import { type Harness, nextClientId, startHarness } from "./harness.ts";
24
+ import { expectRpcError } from "./support/assertions.ts";
25
+ import { eventually } from "./support/async.ts";
26
+
27
+ interface DisposalFixture {
28
+ readonly harness: Harness;
29
+ readonly client: AhpClient;
30
+ close(): Promise<void>;
31
+ }
32
+
33
+ async function startDisposalFixture(options: {
34
+ createBackend?: BackendFactory;
35
+ deleteFile?: (path: string) => SessionFileDeletionResult | Promise<SessionFileDeletionResult>;
36
+ }): Promise<DisposalFixture> {
37
+ const root = mkdtempSync(join(tmpdir(), "pi-ahp-disposal-"));
38
+ const workspace = join(root, "workspace");
39
+ const sessionRoot = join(root, "sessions");
40
+ mkdirSync(workspace);
41
+ const harness = await startHarness({
42
+ sessions: true,
43
+ workingDirectory: workspace,
44
+ sessionRoot,
45
+ ...(options.createBackend ? { createBackend: options.createBackend } : {}),
46
+ ...(options.deleteFile ? { deleteFile: options.deleteFile } : {}),
47
+ });
48
+ const client = await harness.connect();
49
+ await client.initialize({ clientId: nextClientId(), protocolVersions: SUPPORTED_PROTOCOL_VERSIONS });
50
+ return {
51
+ harness,
52
+ client,
53
+ async close() {
54
+ await harness.dispose();
55
+ rmSync(root, { recursive: true, force: true });
56
+ },
57
+ };
58
+ }
59
+
60
+ async function nextRejectedAction(subscription: Subscription, clientSeq: number): Promise<string | undefined> {
61
+ const timeout = new Promise<never>((_, reject) => {
62
+ const timer = setTimeout(() => reject(new Error("timed out waiting for a rejected action")), 2_000);
63
+ timer.unref?.();
64
+ });
65
+ const next = (async () => {
66
+ while (true) {
67
+ const event = await subscription.next();
68
+ if (event.done) throw new Error("subscription ended early");
69
+ if (event.value.type !== "action") continue;
70
+ const envelope = event.value.params as { origin?: { clientSeq?: number }; rejectionReason?: string };
71
+ if (envelope.origin?.clientSeq === clientSeq) return envelope.rejectionReason;
72
+ }
73
+ })();
74
+ return Promise.race([next, timeout]);
75
+ }
76
+
77
+ async function createReadySession(fixture: DisposalFixture): Promise<{ uri: string; chat: string }> {
78
+ const id = randomUUID();
79
+ const uri = sessionUri(id);
80
+ await fixture.client.request("createSession", { channel: uri });
81
+ await eventually(
82
+ "the session backend to become ready",
83
+ () => (fixture.harness.host.store.get(uri) as SessionState).lifecycle === SessionLifecycle.Ready,
84
+ );
85
+ return { uri, chat: chatUri(id) };
86
+ }
87
+
88
+ describe("session disposal", () => {
89
+ it("keeps the session usable when durable deletion fails", async () => {
90
+ let deletionAttempts = 0;
91
+ const fixture = await startDisposalFixture({
92
+ deleteFile: () => {
93
+ deletionAttempts += 1;
94
+ return { ok: false, error: "permission denied" };
95
+ },
96
+ });
97
+ try {
98
+ const { uri } = await createReadySession(fixture);
99
+ const activeBefore = (fixture.harness.host.store.get(ROOT_CHANNEL) as { activeSessions?: number }).activeSessions;
100
+ assert.equal(activeBefore, 1);
101
+
102
+ const error = await expectRpcError(
103
+ fixture.client.request("disposeSession", { channel: uri }),
104
+ JsonRpcErrorCodes.InternalError,
105
+ );
106
+
107
+ assert.match(error.message, /permission denied/u);
108
+ assert.equal(deletionAttempts, 1);
109
+ assert.equal(fixture.harness.sessions?.has(uri), true);
110
+ assert.equal(
111
+ (fixture.harness.host.store.get(ROOT_CHANNEL) as { activeSessions?: number }).activeSessions,
112
+ activeBefore,
113
+ );
114
+ const listed = await fixture.client.request("listSessions", { channel: ROOT_CHANNEL });
115
+ assert.deepEqual(
116
+ listed.items.map((item) => item.resource),
117
+ [uri],
118
+ );
119
+
120
+ fixture.client.dispatch(uri, { type: ActionType.SessionTitleChanged, title: "Still here" });
121
+ await fixture.client.ping();
122
+ assert.equal((fixture.harness.host.store.get(uri) as SessionState).title, "Still here");
123
+ } finally {
124
+ await fixture.close();
125
+ }
126
+ });
127
+
128
+ it("coalesces concurrent requests and rejects new work until deletion settles", async () => {
129
+ let deletionAttempts = 0;
130
+ let finishDeletion!: (result: { ok: boolean }) => void;
131
+ const deletion = new Promise<{ ok: boolean }>((resolve) => {
132
+ finishDeletion = resolve;
133
+ });
134
+ const fixture = await startDisposalFixture({
135
+ deleteFile: () => {
136
+ deletionAttempts += 1;
137
+ return deletion;
138
+ },
139
+ });
140
+ try {
141
+ const { uri } = await createReadySession(fixture);
142
+ const { subscription } = await fixture.client.subscribe(uri);
143
+ const titleBefore = (fixture.harness.host.store.get(uri) as SessionState).title;
144
+
145
+ const first = fixture.client.request("disposeSession", { channel: uri });
146
+ await eventually("durable deletion to start", () => deletionAttempts === 1);
147
+ const second = fixture.client.request("disposeSession", { channel: uri });
148
+ const dispatched = fixture.client.dispatch(uri, {
149
+ type: ActionType.SessionTitleChanged,
150
+ title: "Too late",
151
+ });
152
+ assert.ok(await nextRejectedAction(subscription, dispatched.clientSeq));
153
+ assert.equal((fixture.harness.host.store.get(uri) as SessionState).title, titleBefore);
154
+
155
+ finishDeletion({ ok: true });
156
+ await Promise.all([first, second]);
157
+ assert.equal(deletionAttempts, 1);
158
+ assert.equal(fixture.harness.host.store.has(uri), false);
159
+ } finally {
160
+ finishDeletion({ ok: false });
161
+ await fixture.close();
162
+ }
163
+ });
164
+
165
+ it("quiesces an active backend and commits removal despite cleanup failure", async () => {
166
+ let promptStarted = false;
167
+ let promptSettled = false;
168
+ let releasePrompt: (() => void) | undefined;
169
+ let aborted = false;
170
+ let disposed = false;
171
+ let deleteSawQuiescence = false;
172
+ const backend: PiBackend = {
173
+ subscribe: () => () => undefined,
174
+ prompt: async () => {
175
+ await new Promise<void>((resolve) => {
176
+ promptStarted = true;
177
+ releasePrompt = resolve;
178
+ });
179
+ promptSettled = true;
180
+ },
181
+ steer: async () => undefined,
182
+ abort: async () => {
183
+ aborted = true;
184
+ releasePrompt?.();
185
+ },
186
+ dispose: () => {
187
+ disposed = true;
188
+ throw new Error("cleanup failed after deletion");
189
+ },
190
+ };
191
+ const fixture = await startDisposalFixture({
192
+ createBackend: () => backend,
193
+ deleteFile: () => {
194
+ deleteSawQuiescence = aborted && promptSettled;
195
+ return { ok: true };
196
+ },
197
+ });
198
+ try {
199
+ const { uri, chat } = await createReadySession(fixture);
200
+ await fixture.client.subscribe(chat);
201
+ fixture.client.dispatch(chat, {
202
+ type: ActionType.ChatTurnStarted,
203
+ turnId: "turn-to-delete",
204
+ startedAt: new Date().toISOString(),
205
+ message: { text: "keep running", origin: { kind: MessageKind.User } },
206
+ });
207
+ await eventually("the active prompt to start", () => promptStarted);
208
+
209
+ await fixture.client.request("disposeSession", { channel: uri });
210
+
211
+ assert.equal(deleteSawQuiescence, true);
212
+ assert.equal(disposed, true);
213
+ assert.equal(fixture.harness.host.store.has(uri), false);
214
+ } finally {
215
+ releasePrompt?.();
216
+ await fixture.close();
217
+ }
218
+ });
219
+
220
+ it("resumes queued work when backend quiescence fails", async () => {
221
+ const listeners = new Set<(event: AgentSessionEvent) => void>();
222
+ const prompts: string[] = [];
223
+ let deletionAttempts = 0;
224
+ const backend: PiBackend = {
225
+ subscribe: (listener) => {
226
+ listeners.add(listener);
227
+ return () => listeners.delete(listener);
228
+ },
229
+ prompt: async (text) => {
230
+ prompts.push(text);
231
+ },
232
+ steer: async () => undefined,
233
+ abort: async () => {
234
+ for (const listener of listeners) listener({ type: "agent_settled" } as AgentSessionEvent);
235
+ throw new Error("abort failed");
236
+ },
237
+ };
238
+ const fixture = await startDisposalFixture({
239
+ createBackend: () => backend,
240
+ deleteFile: () => {
241
+ deletionAttempts += 1;
242
+ return { ok: true };
243
+ },
244
+ });
245
+ try {
246
+ const { uri, chat } = await createReadySession(fixture);
247
+ await fixture.client.subscribe(chat);
248
+ fixture.client.dispatch(chat, {
249
+ type: ActionType.ChatTurnStarted,
250
+ turnId: "active",
251
+ startedAt: new Date().toISOString(),
252
+ message: { text: "active", origin: { kind: MessageKind.User } },
253
+ });
254
+ await eventually("the active prompt to start", () => prompts.length === 1);
255
+ fixture.client.dispatch(chat, {
256
+ type: ActionType.ChatPendingMessageSet,
257
+ kind: PendingMessageKind.Queued,
258
+ id: "after-failure",
259
+ message: { text: "after failure", origin: { kind: MessageKind.User } },
260
+ });
261
+ await fixture.client.ping();
262
+
263
+ const error = await expectRpcError(
264
+ fixture.client.request("disposeSession", { channel: uri }),
265
+ JsonRpcErrorCodes.InternalError,
266
+ );
267
+
268
+ assert.match(error.message, /abort failed/u);
269
+ await eventually("queued work to resume", () => prompts.includes("after failure"));
270
+ assert.equal(deletionAttempts, 0);
271
+ assert.equal(fixture.harness.sessions?.has(uri), true);
272
+ } finally {
273
+ await fixture.close();
274
+ }
275
+ });
276
+
277
+ it("drains an in-flight model selection before deleting", async () => {
278
+ let selectionStarted = false;
279
+ let selectionSettled = false;
280
+ let finishSelection!: () => void;
281
+ const selection = new Promise<void>((resolve) => {
282
+ finishSelection = resolve;
283
+ });
284
+ let prompts = 0;
285
+ let deletionAttempts = 0;
286
+ const backend: PiBackend = {
287
+ subscribe: () => () => undefined,
288
+ selectModel: async () => {
289
+ selectionStarted = true;
290
+ await selection;
291
+ selectionSettled = true;
292
+ },
293
+ prompt: async () => {
294
+ prompts += 1;
295
+ },
296
+ steer: async () => undefined,
297
+ abort: async () => undefined,
298
+ };
299
+ const fixture = await startDisposalFixture({
300
+ createBackend: () => backend,
301
+ deleteFile: () => {
302
+ deletionAttempts += 1;
303
+ assert.equal(selectionSettled, true, "deletion overtook a session-writing model selection");
304
+ return { ok: true };
305
+ },
306
+ });
307
+ try {
308
+ const { uri, chat } = await createReadySession(fixture);
309
+ await fixture.client.subscribe(chat);
310
+ fixture.client.dispatch(chat, {
311
+ type: ActionType.ChatTurnStarted,
312
+ turnId: "turn-selecting",
313
+ startedAt: new Date().toISOString(),
314
+ message: {
315
+ text: "switch first",
316
+ origin: { kind: MessageKind.User },
317
+ model: { id: "pi/other-model" },
318
+ },
319
+ });
320
+ await eventually("model selection to start", () => selectionStarted);
321
+
322
+ const disposing = fixture.client.request("disposeSession", { channel: uri });
323
+ await fixture.client.ping();
324
+ assert.equal(deletionAttempts, 0);
325
+
326
+ finishSelection();
327
+ await disposing;
328
+ assert.equal(deletionAttempts, 1);
329
+ assert.equal(prompts, 0, "a prompt started after disposal quiesced its turn");
330
+ } finally {
331
+ finishSelection();
332
+ await fixture.close();
333
+ }
334
+ });
335
+
336
+ it("disposes a backend that finishes starting after removal", async () => {
337
+ let finishStart!: (backend: PiBackend) => void;
338
+ const starting = new Promise<PiBackend>((resolve) => {
339
+ finishStart = resolve;
340
+ });
341
+ let backendDisposals = 0;
342
+ const fixture = await startDisposalFixture({ createBackend: () => starting });
343
+ try {
344
+ const uri = sessionUri(randomUUID());
345
+ await fixture.client.request("createSession", { channel: uri });
346
+ await fixture.client.request("disposeSession", { channel: uri });
347
+ finishStart({
348
+ subscribe: () => () => undefined,
349
+ prompt: async () => undefined,
350
+ steer: async () => undefined,
351
+ abort: async () => undefined,
352
+ dispose: () => {
353
+ backendDisposals += 1;
354
+ },
355
+ });
356
+ await eventually("the late backend to be disposed", () => backendDisposals === 1);
357
+
358
+ assert.equal(backendDisposals, 1);
359
+ assert.equal(fixture.harness.host.store.has(uri), false);
360
+ } finally {
361
+ await fixture.close();
362
+ }
363
+ });
364
+ });
@@ -0,0 +1,194 @@
1
+ /**
2
+ * Opening a session that only exists on disk.
3
+ *
4
+ * A client lists sessions and then subscribes to one. Everything this host
5
+ * created is in memory, but the catalogue is backed by pi's session files —
6
+ * most of which no live host has ever touched. Without lazy loading, every
7
+ * session the catalogue advertises answers `NotFound` on subscribe.
8
+ */
9
+
10
+ import assert from "node:assert/strict";
11
+ import { randomUUID } from "node:crypto";
12
+ import { utimesSync } from "node:fs";
13
+ import { after, before, describe, it } from "node:test";
14
+ import {
15
+ type ChatState,
16
+ MessageAttachmentKind,
17
+ ResponsePartKind,
18
+ type RootState,
19
+ SessionLifecycle,
20
+ type SessionState,
21
+ ToolCallStatus,
22
+ TurnState,
23
+ } from "@microsoft/agent-host-protocol";
24
+ import { RpcError } from "@microsoft/agent-host-protocol/client";
25
+ import { chatUri, ROOT_CHANNEL, sessionUri } from "../src/core/channels.ts";
26
+ import { AhpHost } from "../src/core/host.ts";
27
+ import { pathToFileUri } from "../src/core/uri.ts";
28
+ import { PiSessionCatalogue } from "../src/pi/session-catalogue.ts";
29
+ import { SessionHydrator } from "../src/pi/session-hydrator.ts";
30
+ import { must } from "./support/assertions.ts";
31
+ import { type HydratedSessionFixture, startHydratedSessionFixture } from "./support/hydrated-session.ts";
32
+ import { ONE_PIXEL_PNG } from "./support/images.ts";
33
+ import { assertValid } from "./support/schema.ts";
34
+
35
+ class BlockingCatalogue extends PiSessionCatalogue {
36
+ readonly lookupStarted = Promise.withResolvers<void>();
37
+ readonly lookupGate = Promise.withResolvers<void>();
38
+ lookups = 0;
39
+
40
+ override async findSessionFile(sessionId: string): Promise<string | undefined> {
41
+ this.lookups += 1;
42
+ this.lookupStarted.resolve();
43
+ await this.lookupGate.promise;
44
+ return super.findSessionFile(sessionId);
45
+ }
46
+ }
47
+
48
+ describe("opening a session from the catalogue", () => {
49
+ let fixture: HydratedSessionFixture;
50
+
51
+ before(async () => {
52
+ fixture = await startHydratedSessionFixture();
53
+ });
54
+
55
+ after(async () => {
56
+ await fixture.close();
57
+ });
58
+
59
+ it("hydrates a catalogued session and counts it as active", async () => {
60
+ const { result } = await fixture.client.subscribe(sessionUri(fixture.sessionId));
61
+ const state = result.snapshot?.state as SessionState;
62
+
63
+ assert.equal(state.lifecycle, SessionLifecycle.Ready);
64
+ assert.equal(state.chats.length, 1);
65
+ assert.equal(state.defaultChat, chatUri(fixture.sessionId));
66
+ assert.deepEqual(state.workingDirectories, [pathToFileUri(fixture.workspace)]);
67
+ assertValid("state", "SessionState", state);
68
+ assert.equal((fixture.host.store.get(ROOT_CHANNEL) as RootState).activeSessions, 1);
69
+ });
70
+
71
+ it("rebuilds the transcript onto the chat channel", async () => {
72
+ const { result } = await fixture.client.subscribe(chatUri(fixture.sessionId));
73
+ const chat = must(result.snapshot).state as ChatState;
74
+
75
+ assert.equal(chat.turns.length, 2);
76
+ assert.equal(chat.turns[0]?.message.text, "Read note.txt");
77
+ assert.equal(chat.turns[0]?.state, TurnState.Complete);
78
+ assertValid("state", "ChatState", chat);
79
+ });
80
+
81
+ it("pairs each tool call with the result that followed it", async () => {
82
+ const { result } = await fixture.client.subscribe(chatUri(fixture.sessionId));
83
+ const parts = must((must(result.snapshot).state as ChatState).turns[0]).responseParts;
84
+
85
+ assert.deepEqual(
86
+ parts.map((part) => part.kind),
87
+ [ResponsePartKind.Reasoning, ResponsePartKind.ToolCall, ResponsePartKind.Markdown],
88
+ );
89
+ const toolCall = (
90
+ parts[1] as {
91
+ toolCall: { status: string; toolName?: string; content?: { type: string; text?: string }[] };
92
+ }
93
+ ).toolCall;
94
+ assert.equal(toolCall.status, ToolCallStatus.Completed);
95
+ assert.equal(toolCall.toolName, "read");
96
+ assert.deepEqual(toolCall.content, [{ type: "text", text: "ALPHA" }]);
97
+ });
98
+
99
+ it("still answers NotFound for a session that really does not exist", async () => {
100
+ const error = await fixture.client.subscribe(sessionUri(randomUUID())).then(
101
+ () => undefined,
102
+ (reason: unknown) => reason,
103
+ );
104
+
105
+ assert.ok(error instanceof RpcError);
106
+ assert.equal(error.code, -32008);
107
+ });
108
+
109
+ it("restores images stored in pi user messages", async () => {
110
+ const fresh = await startHydratedSessionFixture({ includeImage: true });
111
+ try {
112
+ const { result } = await fresh.client.subscribe(chatUri(fresh.sessionId));
113
+ const chat = must(result.snapshot).state as ChatState;
114
+
115
+ assert.deepEqual(chat.turns[0]?.message.attachments, [
116
+ {
117
+ type: MessageAttachmentKind.EmbeddedResource,
118
+ label: "Image 1",
119
+ displayKind: "image",
120
+ data: ONE_PIXEL_PNG,
121
+ contentType: "image/png",
122
+ },
123
+ ]);
124
+ assertValid("state", "ChatState", chat);
125
+ } finally {
126
+ await fresh.close();
127
+ }
128
+ });
129
+
130
+ it("hydrates from either half of the pair", async () => {
131
+ const fresh = await startHydratedSessionFixture();
132
+ try {
133
+ const { result } = await fresh.client.subscribe(chatUri(fresh.sessionId));
134
+ assert.ok(result.snapshot);
135
+ assert.ok(fresh.host.store.has(sessionUri(fresh.sessionId)), "the session must load alongside its chat");
136
+ } finally {
137
+ await fresh.close();
138
+ }
139
+ });
140
+
141
+ it("coalesces concurrent session and chat hydration", async () => {
142
+ const source = await startHydratedSessionFixture();
143
+ const catalogue = new BlockingCatalogue(source.root);
144
+ try {
145
+ const host = new AhpHost();
146
+ const live = new Set<string>();
147
+ const adopted: string[] = [];
148
+ const hydrator = new SessionHydrator({
149
+ host,
150
+ catalogue,
151
+ isLive: (session) => live.has(session),
152
+ isDisposing: () => false,
153
+ adopt: (session) => {
154
+ live.add(session.uri);
155
+ adopted.push(session.uri);
156
+ },
157
+ });
158
+ const session = sessionUri(source.sessionId);
159
+ const chat = chatUri(source.sessionId);
160
+
161
+ const first = hydrator.hydrate(session);
162
+ await catalogue.lookupStarted.promise;
163
+ const second = hydrator.hydrate(chat);
164
+ catalogue.lookupGate.resolve();
165
+
166
+ assert.deepEqual(await Promise.all([first, second]), [true, true]);
167
+ assert.equal(catalogue.lookups, 1);
168
+ assert.deepEqual(adopted, [session]);
169
+ assert.equal(host.store.has(session), true);
170
+ assert.equal(host.store.has(chat), true);
171
+ } finally {
172
+ catalogue.lookupGate.resolve();
173
+ await source.close();
174
+ }
175
+ });
176
+ });
177
+
178
+ it("preserves catalogue modifiedAt when a disk session becomes a live overlay", async () => {
179
+ const fixture = await startHydratedSessionFixture();
180
+ try {
181
+ const file = must(await new PiSessionCatalogue(fixture.root).findSessionFile(fixture.sessionId));
182
+ const timestamp = new Date("2025-06-01T12:00:00.000Z");
183
+ utimesSync(file, timestamp, timestamp);
184
+ const before = await fixture.client.request("listSessions", { channel: ROOT_CHANNEL });
185
+ assert.equal(before.items[0]?.modifiedAt, timestamp.toISOString());
186
+ const { result } = await fixture.client.subscribe(chatUri(fixture.sessionId));
187
+ assert.equal((must(result.snapshot).state as ChatState).modifiedAt, timestamp.toISOString());
188
+ const after = await fixture.client.request("listSessions", { channel: ROOT_CHANNEL });
189
+ assert.equal(after.items.length, 1);
190
+ assert.equal(after.items[0]?.modifiedAt, timestamp.toISOString());
191
+ } finally {
192
+ await fixture.close();
193
+ }
194
+ });