@pi-chamber/web 0.9.0 → 0.9.3

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 (106) hide show
  1. package/README.md +24 -8
  2. package/bin/cli.js +11 -1
  3. package/bin/cli.test.js +18 -0
  4. package/bin/lib/DOCUMENTATION.md +3 -3
  5. package/bin/lib/cli-args.js +7 -3
  6. package/bin/lib/cli-lifecycle.js +3 -0
  7. package/bin/lib/cli-paths.js +28 -6
  8. package/bin/lib/cli-process.js +1 -0
  9. package/bin/lib/cli-tunnel-profiles.js +15 -10
  10. package/bin/lib/commands-connect-url.js +9 -1
  11. package/bin/lib/commands-logs.js +22 -4
  12. package/bin/lib/commands-serve.js +10 -2
  13. package/bin/lib/commands-tunnel.js +14 -0
  14. package/bin/lib/commands-update.js +18 -14
  15. package/bin/lib/commands-update.test.js +2 -1
  16. package/dist/assets/{DiagramEditor-CcbnMl1H.js → DiagramEditor-DuGmiPZ5.js} +1 -1
  17. package/dist/assets/{DiagramView-DTW5jwK3.js → DiagramView-CV-iReyY.js} +1 -1
  18. package/dist/assets/{DiffView-CZyHHAOB.js → DiffView-DVd1MLPB.js} +6 -6
  19. package/dist/assets/{FilesView-BJYLFR3H.js → FilesView-CPnW4I90.js} +1 -1
  20. package/dist/assets/{GitView-Cg_5UU7E.js → GitView-Dj_7hgX_.js} +3 -3
  21. package/dist/assets/JsonTreeView-Cyy0lEZR.js +1 -0
  22. package/dist/assets/{MarkdownRendererImpl-WqBwxlso.js → MarkdownRendererImpl-BXN78Wu_.js} +1 -1
  23. package/dist/assets/{PatchDiff-BRi23N1l.js → PatchDiff-C7dA3U29.js} +1 -1
  24. package/dist/assets/{SessionSwitcherContent-7VAU5pwZ.js → SessionSwitcherContent-dr3g9DR7.js} +1 -1
  25. package/dist/assets/{SessionSwitcherDropdown-BslRtccE.js → SessionSwitcherDropdown-C3zdd82V.js} +2 -2
  26. package/dist/assets/{SessionUnreadDot-1nV0Z2ZA.js → SessionUnreadDot-qeik5qtT.js} +1 -1
  27. package/dist/assets/SettingsView-C57uV1YS.js +2 -0
  28. package/dist/assets/{SettingsWindow-D4jZHl8X.js → SettingsWindow-Bbay2W76.js} +1 -1
  29. package/dist/assets/ToolOutputDialog-CRTiN1CH.js +8 -0
  30. package/dist/assets/{ToolPartDiffPreview-9FLv2fWD.js → ToolPartDiffPreview-CqnNcLPk.js} +1 -1
  31. package/dist/assets/{VirtualizedFileDiff-ywmPBXAG.js → VirtualizedFileDiff-iqwryMNU.js} +3 -3
  32. package/dist/assets/{collapsible-6mCYf7Ky.js → collapsible-szfZ0Syc.js} +1 -1
  33. package/dist/assets/computeVirtualFileMetrics-Bbugxxtp.js +3 -0
  34. package/dist/assets/{contextFileOpenGuard-CKyf-TZ7.js → contextFileOpenGuard-BC3ie230.js} +1 -1
  35. package/dist/assets/{gitStatusPredicates-UsytDMy_.js → gitStatusPredicates-DbThKVSf.js} +1 -1
  36. package/dist/assets/{index-C8NYcA8-.css → index-DNoEeZ2U.css} +1 -1
  37. package/dist/assets/{index-yWgKW2Fx.js → index-KIdiBFJs.js} +4 -4
  38. package/dist/assets/{index-D1IaU-Q7.js → index-v6K3L94m.js} +1 -1
  39. package/dist/assets/{isDiffPlainText-DPCilEx_.js → isDiffPlainText-Dl0RBjPZ.js} +1 -1
  40. package/dist/assets/{isFilePlainText-XdCAgm8R.js → isFilePlainText-CbrmvrM6.js} +1 -1
  41. package/dist/assets/{main-DcAMXRSi.js → main-4PkIvzf4.js} +7 -7
  42. package/dist/assets/{main-DhvLreEl.js → main-DMyWi0qs.js} +2 -2
  43. package/dist/assets/{markdownCore-BF0Dqwm4.js → markdownCore-BD5WkOKU.js} +1 -1
  44. package/dist/assets/{miniChat-DsCx0dsW.js → miniChat-CLMNhna4.js} +2 -2
  45. package/dist/assets/{mobile-C-IN49xX.js → mobile-rWMDwhtQ.js} +2 -2
  46. package/dist/assets/renderElectronMiniChatApp-BRhGNRJ8.js +2 -0
  47. package/dist/assets/{renderMobileApp-xCdVzvyf.js → renderMobileApp-DLy2YoQg.js} +3 -3
  48. package/dist/assets/{runtimeEndpointReset-CT3WShpj.js → runtimeEndpointReset-Z9YtcHxZ.js} +15 -15
  49. package/dist/assets/{runtimeSurface-C_3mcJ01.js → runtimeSurface-CySRuLbN.js} +1 -1
  50. package/dist/assets/{useAppFontEffects-BgK55NDM.js → useAppFontEffects-DfuJVB15.js} +102 -102
  51. package/dist/assets/{useFilesViewSearch-CWx24PZg.js → useFilesViewSearch-BZBHrZ90.js} +1 -1
  52. package/dist/assets/usePushVisibilityBeacon-BxTkEajM.js +10 -0
  53. package/dist/assets/{useSwitcherItems-CrS-F6DY.js → useSwitcherItems-jITqE8PV.js} +1 -1
  54. package/dist/assets/{vendor-codemirror-language-data-BzeePAPn.js → vendor-codemirror-language-data-CDdfwzlS.js} +2 -2
  55. package/dist/assets/{web-components-DAkBDXRk.js → web-components-C9wXMuCp.js} +2 -2
  56. package/dist/index.html +4 -4
  57. package/dist/mini-chat.html +3 -3
  58. package/dist/mobile.html +3 -3
  59. package/package.json +3 -3
  60. package/server/index.js +26 -7
  61. package/server/lib/client-auth/pairing.js +13 -2
  62. package/server/lib/client-auth/remote-clients.js +13 -2
  63. package/server/lib/fs/DOCUMENTATION.md +3 -1
  64. package/server/lib/fs/routes.test.js +74 -0
  65. package/server/lib/git/DOCUMENTATION.md +1 -1
  66. package/server/lib/git/identity-storage.js +10 -1
  67. package/server/lib/package-manager.js +1 -1
  68. package/server/lib/package-manager.test.js +11 -0
  69. package/server/lib/pi/archive-store.js +3 -2
  70. package/server/lib/pi/model-config-store.js +6 -2
  71. package/server/lib/pi/routes.js +46 -3
  72. package/server/lib/pi/routes.test.js +53 -0
  73. package/server/lib/pi/session-daemon/DOCUMENTATION.md +15 -9
  74. package/server/lib/pi/session-daemon/daemon-process.js +48 -13
  75. package/server/lib/pi/session-daemon/ipc-client.js +20 -9
  76. package/server/lib/pi/session-daemon/ipc-client.test.js +88 -0
  77. package/server/lib/pi/session-daemon/ipc-protocol.js +9 -0
  78. package/server/lib/pi/session-daemon/session-daemon.js +353 -66
  79. package/server/lib/pi/session-daemon/session-daemon.test.js +348 -0
  80. package/server/lib/pi/session-daemon/session-lease.js +151 -0
  81. package/server/lib/pi/session-daemon/session-lease.test.js +108 -0
  82. package/server/lib/pi/session-daemon/supervisor.js +244 -54
  83. package/server/lib/pi/session-daemon/supervisor.test.js +202 -6
  84. package/server/lib/pi/session-folders-store.js +20 -2
  85. package/server/lib/pi/session-folders-store.test.js +17 -0
  86. package/server/lib/pi/settings-store.js +3 -2
  87. package/server/lib/pi/snippets-store.js +4 -1
  88. package/server/lib/pi/ui-settings-store.js +130 -24
  89. package/server/lib/pi/ui-settings-store.test.js +58 -7
  90. package/server/lib/server/cross-process-lock.js +112 -0
  91. package/server/lib/server/cross-process-lock.test.js +70 -0
  92. package/server/lib/server/server-profile.js +110 -0
  93. package/server/lib/server/server-profile.test.js +58 -0
  94. package/server/lib/server/tunnel-service.DOCUMENTATION.md +7 -8
  95. package/server/lib/server/tunnel-service.js +8 -1
  96. package/server/lib/stt/config-store.js +3 -2
  97. package/server/lib/terminal/DOCUMENTATION.md +1 -1
  98. package/server/lib/tunnels/DOCUMENTATION.md +38 -18
  99. package/server/lib/ui-auth/ui-auth.js +9 -2
  100. package/server/lib/ui-auth/ui-passkeys.js +9 -1
  101. package/dist/assets/JsonTreeView-GTdKGEdy.js +0 -1
  102. package/dist/assets/SettingsView-UIaAyjTo.js +0 -2
  103. package/dist/assets/ToolOutputDialog-BoeJONiR.js +0 -8
  104. package/dist/assets/computeVirtualFileMetrics-3H6mg13G.js +0 -3
  105. package/dist/assets/renderElectronMiniChatApp-C13HXGZL.js +0 -2
  106. package/dist/assets/usePushVisibilityBeacon-swMQLm-i.js +0 -10
@@ -6,6 +6,7 @@ import { homedir, tmpdir } from 'node:os';
6
6
  import { join } from 'node:path';
7
7
  import { StringDecoder } from 'node:string_decoder';
8
8
 
9
+ import { requestSessionDaemon } from './ipc-client.js';
9
10
  import { createMessageEntryAliases } from './message-entry-aliases.js';
10
11
  import { createSessionDaemon as createSessionDaemonImpl, isLocalSessionDaemonEndpoint } from './session-daemon.js';
11
12
 
@@ -1241,6 +1242,146 @@ describe('Pi session daemon spike', () => {
1241
1242
  await client.close();
1242
1243
  }, 2_000);
1243
1244
 
1245
+ it('opens a transcript whose complete projection exceeds the IPC frame limit', async () => {
1246
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-daemon-paged-transcript-'));
1247
+ const endpoint = testDaemonEndpoint(root);
1248
+ const persistedSessionFile = join(root, 'persisted.jsonl');
1249
+ await writeFile(persistedSessionFile, `{"type":"session","id":"pi-session-paged","cwd":"${root}"}\n`);
1250
+ const session = new FakeSession('pi-session-paged', persistedSessionFile);
1251
+ const largeOutput = 'A'.repeat(1_100_000);
1252
+ session.entries = [{
1253
+ type: 'message',
1254
+ id: 'user-0',
1255
+ timestamp: '2026-01-01T00:00:00.000Z',
1256
+ message: { role: 'user', content: 'Inspect the large fixture.' },
1257
+ }, ...Array.from({ length: 17 }, (_, index) => [{
1258
+ type: 'message',
1259
+ id: `assistant-${index}`,
1260
+ timestamp: new Date(Date.UTC(2026, 0, 1, 0, 0, index * 2)).toISOString(),
1261
+ message: {
1262
+ role: 'assistant',
1263
+ provider: 'test',
1264
+ model: 'model',
1265
+ content: [{ type: 'toolCall', id: `tool-${index}`, name: 'read', arguments: { index } }],
1266
+ },
1267
+ }, {
1268
+ type: 'message',
1269
+ id: `result-${index}`,
1270
+ timestamp: new Date(Date.UTC(2026, 0, 1, 0, 0, index * 2 + 1)).toISOString(),
1271
+ message: {
1272
+ role: 'toolResult',
1273
+ toolCallId: `tool-${index}`,
1274
+ toolName: 'read',
1275
+ content: [{ type: 'text', text: largeOutput }],
1276
+ isError: false,
1277
+ },
1278
+ }]).flat()];
1279
+ const runtime = new FakeRuntime({ cwd: root, session });
1280
+ daemon = createSessionDaemon({
1281
+ endpoint,
1282
+ credential,
1283
+ cwd: root,
1284
+ createRuntime: async () => runtime,
1285
+ listSessions: async () => [{
1286
+ path: persistedSessionFile,
1287
+ id: 'pi-session-paged',
1288
+ cwd: root,
1289
+ created: new Date('2026-01-01T00:00:00.000Z'),
1290
+ modified: new Date('2026-01-01T00:00:01.000Z'),
1291
+ messageCount: session.entries.length,
1292
+ }],
1293
+ });
1294
+ await daemon.start();
1295
+
1296
+ const opened = await requestSessionDaemon({
1297
+ endpoint,
1298
+ credential,
1299
+ command: 'sessions.open',
1300
+ payload: { sessionId: 'pi-session-paged', directory: root },
1301
+ });
1302
+
1303
+ expect(opened.messages.length).toBeLessThan(17);
1304
+ expect(opened.hasMoreBefore).toBe(true);
1305
+ expect(typeof opened.beforeCursor).toBe('string');
1306
+ expect(Buffer.byteLength(JSON.stringify(opened))).toBeLessThan(16 * 1024 * 1024);
1307
+
1308
+ const pages = [opened.messages];
1309
+ let before = opened.beforeCursor;
1310
+ while (before) {
1311
+ const page = await requestSessionDaemon({
1312
+ endpoint,
1313
+ credential,
1314
+ command: 'sessions.messages',
1315
+ payload: { sessionId: 'pi-session-paged', directory: root, before },
1316
+ });
1317
+ pages.unshift(page.messages);
1318
+ before = page.beforeCursor;
1319
+ }
1320
+ const messages = pages.flat();
1321
+ const uniqueMessages = [...new Map(messages.map((entry) => [entry.message.id, entry])).values()];
1322
+ expect(uniqueMessages.map((entry) => entry.message.id)).toEqual([
1323
+ 'user-0',
1324
+ ...Array.from({ length: 17 }, (_, index) => `assistant-${index}`),
1325
+ ]);
1326
+ expect(uniqueMessages.filter((entry) => entry.message.role === 'assistant')
1327
+ .every((entry) => entry.parts[0].output === largeOutput)).toBe(true);
1328
+ expect(opened.messages.some((entry) => entry.message.id === 'user-0')).toBe(true);
1329
+ }, 30_000);
1330
+
1331
+ it('reports a single unpageable message as too large instead of malformed', async () => {
1332
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-daemon-oversized-'));
1333
+ const endpoint = testDaemonEndpoint(root);
1334
+ const persistedSessionFile = join(root, 'persisted.jsonl');
1335
+ await writeFile(persistedSessionFile, `{"type":"session","id":"pi-session-oversized","cwd":"${root}"}\n`);
1336
+ const session = new FakeSession('pi-session-oversized', persistedSessionFile);
1337
+ const hugeOutput = 'B'.repeat(17 * 1024 * 1024);
1338
+ session.entries = [{
1339
+ type: 'message',
1340
+ id: 'assistant-huge',
1341
+ timestamp: '2026-01-01T00:00:02.000Z',
1342
+ message: {
1343
+ role: 'assistant',
1344
+ provider: 'test',
1345
+ model: 'model',
1346
+ content: [{ type: 'toolCall', id: 'huge-tool', name: 'read', arguments: {} }],
1347
+ },
1348
+ }, {
1349
+ type: 'message',
1350
+ id: 'result-huge',
1351
+ timestamp: '2026-01-01T00:00:03.000Z',
1352
+ message: {
1353
+ role: 'toolResult',
1354
+ toolCallId: 'huge-tool',
1355
+ toolName: 'read',
1356
+ content: [{ type: 'text', text: hugeOutput }],
1357
+ isError: false,
1358
+ },
1359
+ }];
1360
+ const runtime = new FakeRuntime({ cwd: root, session });
1361
+ daemon = createSessionDaemon({
1362
+ endpoint,
1363
+ credential,
1364
+ cwd: root,
1365
+ createRuntime: async () => runtime,
1366
+ listSessions: async () => [{
1367
+ path: persistedSessionFile,
1368
+ id: 'pi-session-oversized',
1369
+ cwd: root,
1370
+ created: new Date('2026-01-01T00:00:00.000Z'),
1371
+ modified: new Date('2026-01-01T00:00:01.000Z'),
1372
+ messageCount: 1,
1373
+ }],
1374
+ });
1375
+ await daemon.start();
1376
+
1377
+ await expect(requestSessionDaemon({
1378
+ endpoint,
1379
+ credential,
1380
+ command: 'sessions.open',
1381
+ payload: { sessionId: 'pi-session-oversized', directory: root },
1382
+ })).rejects.toMatchObject({ code: 'DAEMON_RESPONSE_TOO_LARGE' });
1383
+ }, 30_000);
1384
+
1244
1385
  it('keeps Pi global/project defaults and trust decisions authoritative', async () => {
1245
1386
  const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-settings-'));
1246
1387
  const cwd = join(root, 'project');
@@ -2368,4 +2509,211 @@ describe('Pi session daemon spike', () => {
2368
2509
  expect(detail.result.messages[0].message.thinkingLevel).toBe('high');
2369
2510
  await client.close();
2370
2511
  });
2512
+
2513
+ it('transfers profile ownership through runtime.claim and enforces it on runtime.shutdown', async () => {
2514
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-daemon-ownership-'));
2515
+ const endpoint = testDaemonEndpoint(root);
2516
+ const projectDir = join(root, 'project');
2517
+ const agentDir = join(root, 'agent');
2518
+ await mkdir(projectDir, { recursive: true });
2519
+ await mkdir(agentDir, { recursive: true });
2520
+ let shutdownCalls = 0;
2521
+ daemon = createSessionDaemon({
2522
+ endpoint,
2523
+ credential,
2524
+ cwd: projectDir,
2525
+ agentDir,
2526
+ profileKey: 'web-p3000',
2527
+ serverInstanceId: 'server-a',
2528
+ serverPid: 987_654_321,
2529
+ daemonId: 'daemon-a',
2530
+ onShutdown: () => { shutdownCalls += 1; },
2531
+ });
2532
+ await daemon.start();
2533
+ const client = connectClient(endpoint);
2534
+ await client.authenticate();
2535
+ await expect(client.request('runtime.health')).resolves.toMatchObject({
2536
+ result: { profileKey: 'web-p3000', daemonId: 'daemon-a', serverInstanceId: 'server-a' },
2537
+ });
2538
+ await expect(client.request('runtime.claim', { serverInstanceId: 'server-b', serverPid: process.pid })).resolves.toMatchObject({
2539
+ result: { claimed: true, serverInstanceId: 'server-b', serverPid: process.pid },
2540
+ });
2541
+ const requestRaw = (requestClient, command, payload) => {
2542
+ const requestId = `request-${Math.random()}`;
2543
+ requestClient.socket.write(`${JSON.stringify({ protocolVersion: 1, kind: 'request', requestId, command, payload })}\n`);
2544
+ return requestClient.next((message) => message.kind === 'error');
2545
+ };
2546
+ // The stale previous owner must not shut the daemon down. A rejected
2547
+ // command destroys its connection, so later steps reconnect.
2548
+ await expect(requestRaw(client, 'runtime.shutdown', { serverInstanceId: 'server-a', daemonId: 'daemon-a' }))
2549
+ .resolves.toMatchObject({ error: { code: 'OWNERSHIP_MISMATCH' } });
2550
+ expect(shutdownCalls).toBe(0);
2551
+ // The current owner shuts it down through authenticated IPC.
2552
+ const owner = connectClient(endpoint);
2553
+ await owner.authenticate();
2554
+ owner.socket.write(`${JSON.stringify({ protocolVersion: 1, kind: 'request', requestId: 'shutdown-ok', command: 'runtime.shutdown', payload: { serverInstanceId: 'server-b', daemonId: 'daemon-a' } })}\n`);
2555
+ await expect(owner.next((message) => message.kind === 'response' && message.requestId === 'shutdown-ok'))
2556
+ .resolves.toMatchObject({ result: { shutdown: true } });
2557
+ await new Promise((resolve) => setImmediate(resolve));
2558
+ expect(shutdownCalls).toBe(1);
2559
+ await owner.close();
2560
+ });
2561
+
2562
+ it('keeps the prior owner when an ownership claim cannot be persisted', async () => {
2563
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-daemon-claim-persist-'));
2564
+ const endpoint = testDaemonEndpoint(root);
2565
+ daemon = createSessionDaemon({
2566
+ endpoint,
2567
+ credential,
2568
+ cwd: root,
2569
+ profileKey: 'web-p3000',
2570
+ serverInstanceId: 'server-a',
2571
+ serverPid: 987_654_321,
2572
+ daemonId: 'daemon-a',
2573
+ onOwnershipClaim: async () => {
2574
+ throw Object.assign(new Error('State write failed'), { code: 'STATE_WRITE_FAILED' });
2575
+ },
2576
+ });
2577
+ await daemon.start();
2578
+ const claimant = connectClient(endpoint);
2579
+ await claimant.authenticate();
2580
+ const response = claimant.next((message) => message.kind === 'error');
2581
+ claimant.socket.write(`${JSON.stringify({
2582
+ protocolVersion: 1,
2583
+ kind: 'request',
2584
+ requestId: 'claim-persist-failure',
2585
+ command: 'runtime.claim',
2586
+ payload: { serverInstanceId: 'server-b', serverPid: process.pid },
2587
+ })}\n`);
2588
+ await expect(response).resolves.toMatchObject({ error: { code: 'STATE_WRITE_FAILED' } });
2589
+
2590
+ const observer = connectClient(endpoint);
2591
+ await observer.authenticate();
2592
+ await expect(observer.request('runtime.health')).resolves.toMatchObject({
2593
+ result: { serverInstanceId: 'server-a', serverPid: 987_654_321 },
2594
+ });
2595
+ claimant.socket.destroy();
2596
+ await observer.close();
2597
+ });
2598
+
2599
+ it('refuses to transfer profile ownership while the current server is alive', async () => {
2600
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-daemon-live-owner-'));
2601
+ const endpoint = testDaemonEndpoint(root);
2602
+ const projectDir = join(root, 'project');
2603
+ await mkdir(projectDir, { recursive: true });
2604
+ daemon = createSessionDaemon({
2605
+ endpoint,
2606
+ credential,
2607
+ cwd: projectDir,
2608
+ profileKey: 'web-p3000',
2609
+ serverInstanceId: 'server-a',
2610
+ serverPid: process.pid,
2611
+ daemonId: 'daemon-a',
2612
+ });
2613
+ await daemon.start();
2614
+ const client = connectClient(endpoint);
2615
+ await client.authenticate();
2616
+ const requestId = 'claim-live-owner';
2617
+ const response = client.next((message) => message.kind === 'error');
2618
+ client.socket.write(`${JSON.stringify({
2619
+ protocolVersion: 1,
2620
+ kind: 'request',
2621
+ requestId,
2622
+ command: 'runtime.claim',
2623
+ payload: { serverInstanceId: 'server-b', serverPid: process.pid + 1 },
2624
+ })}\n`);
2625
+ await expect(response).resolves.toMatchObject({ error: { code: 'OWNERSHIP_CONFLICT' } });
2626
+ await client.close();
2627
+ });
2628
+
2629
+ it('refuses a cross-profile open of a leased session instead of hiding it', async () => {
2630
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-pi-daemon-lease-'));
2631
+ const endpointA = join(root, 'a.sock');
2632
+ const endpointB = join(root, 'b.sock');
2633
+ const agentDir = join(root, 'agent');
2634
+ await mkdir(agentDir, { recursive: true });
2635
+ const file1 = join(root, 'session-1.jsonl');
2636
+ const file2 = join(root, 'session-2.jsonl');
2637
+ await writeFile(file1, `{"type":"session","id":"session-1","cwd":"${root}"}\n`);
2638
+ await writeFile(file2, `{"type":"session","id":"session-2","cwd":"${root}"}\n`);
2639
+ const sessions = new Map();
2640
+ sessions.set('session-1', new FakeSession('session-1', file1));
2641
+ sessions.set('session-2', new FakeSession('session-2', file2));
2642
+ const createRuntime = async ({ sessionFile }) => {
2643
+ const id = sessionFile?.includes('session-2') ? 'session-2' : 'session-1';
2644
+ return new FakeRuntime({ cwd: root, session: sessions.get(id) });
2645
+ };
2646
+ // Non-standard filenames: resolve opens through the mocked list path,
2647
+ // mirroring the concurrent-sessions test above.
2648
+ const listSessions = async () => [
2649
+ { path: file1, id: 'session-1', cwd: root, created: new Date(), modified: new Date(), messageCount: 0 },
2650
+ { path: file2, id: 'session-2', cwd: root, created: new Date(), modified: new Date(), messageCount: 0 },
2651
+ ];
2652
+ daemon = createSessionDaemon({
2653
+ endpoint: endpointA,
2654
+ credential,
2655
+ cwd: root,
2656
+ agentDir,
2657
+ profileKey: 'web-p3000',
2658
+ serverInstanceId: 'server-a',
2659
+ daemonId: 'daemon-a',
2660
+ createRuntime,
2661
+ listSessions,
2662
+ });
2663
+ const daemonB = createSessionDaemonImpl({
2664
+ endpoint: endpointB,
2665
+ credential,
2666
+ cwd: root,
2667
+ agentDir,
2668
+ profileKey: 'web-dev-p3902',
2669
+ serverInstanceId: 'server-b',
2670
+ daemonId: 'daemon-b',
2671
+ createRuntime,
2672
+ listSessions,
2673
+ });
2674
+ const safeClose = async (requestClient) => {
2675
+ try {
2676
+ if (requestClient?.socket.destroyed) return;
2677
+ await Promise.race([
2678
+ requestClient.close(),
2679
+ new Promise((resolve) => setTimeout(resolve, 1_000)),
2680
+ ]);
2681
+ } catch {}
2682
+ };
2683
+ let clientA;
2684
+ let clientB;
2685
+ try {
2686
+ await daemon.start();
2687
+ await daemonB.start();
2688
+ clientA = connectClient(endpointA);
2689
+ await clientA.authenticate();
2690
+ clientB = connectClient(endpointB);
2691
+ await clientB.authenticate();
2692
+ await expect(clientA.request('sessions.open', { sessionId: 'session-1' })).resolves.toMatchObject({
2693
+ result: { session: { id: 'session-1' } },
2694
+ });
2695
+ // A different session stays fully concurrent across profiles.
2696
+ await expect(clientB.request('sessions.open', { sessionId: 'session-2' })).resolves.toMatchObject({
2697
+ result: { session: { id: 'session-2' } },
2698
+ });
2699
+ // The same session reports ownership instead of absent or idle state.
2700
+ // A rejected command destroys its connection, so later steps reconnect.
2701
+ clientB.socket.write(`${JSON.stringify({ protocolVersion: 1, kind: 'request', requestId: 'contended', command: 'sessions.open', payload: { sessionId: 'session-1' } })}\n`);
2702
+ await expect(clientB.next((message) => message.kind === 'error'))
2703
+ .resolves.toMatchObject({ error: { code: 'SESSION_IN_USE' } });
2704
+ await safeClose(clientB);
2705
+ // Releasing the lease (here through daemon shutdown) lets the other
2706
+ // profile open the session.
2707
+ await daemon.stop();
2708
+ clientB = connectClient(endpointB);
2709
+ await clientB.authenticate();
2710
+ await expect(clientB.request('sessions.open', { sessionId: 'session-1' })).resolves.toMatchObject({
2711
+ result: { session: { id: 'session-1' } },
2712
+ });
2713
+ } finally {
2714
+ await safeClose(clientA);
2715
+ await safeClose(clientB);
2716
+ await daemonB.stop();
2717
+ }
2718
+ });
2371
2719
  });
@@ -0,0 +1,151 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
3
+ import { dirname, join, resolve } from 'node:path';
4
+
5
+ import { withCrossProcessLock } from '../../server/cross-process-lock.js';
6
+
7
+ export class SessionLeaseError extends Error {
8
+ constructor(code, message = 'The Pi session lease is unavailable.') {
9
+ super(message);
10
+ this.code = code;
11
+ }
12
+ }
13
+
14
+ const isPidAlive = (processLike, pid) => {
15
+ try {
16
+ processLike.kill(pid, 0);
17
+ return true;
18
+ } catch (error) {
19
+ return error?.code === 'EPERM';
20
+ }
21
+ };
22
+
23
+ export const canonicalizeLeaseDir = (value, platform = process.platform) => {
24
+ const resolved = resolve(String(value ?? ''));
25
+ if (platform === 'win32') {
26
+ return resolved.replace(/\\/g, '/').replace(/^([a-z]):/i, (match) => match.toLowerCase());
27
+ }
28
+ return resolved;
29
+ };
30
+
31
+ const leaseHash = ({ agentDir, cwd, sessionId }) => createHash('sha256')
32
+ .update(`${agentDir}\n${cwd}\n${sessionId}`)
33
+ .digest('hex')
34
+ .slice(0, 32);
35
+
36
+ export const resolveSessionLeaseFile = ({ agentDir, cwd, sessionId, platform = process.platform } = {}) => {
37
+ if (typeof sessionId !== 'string' || sessionId.length === 0) {
38
+ throw new SessionLeaseError('INVALID_SESSION_ID');
39
+ }
40
+ const canonicalAgentDir = canonicalizeLeaseDir(agentDir, platform);
41
+ const canonicalCwd = canonicalizeLeaseDir(cwd, platform);
42
+ const name = `${leaseHash({ agentDir: canonicalAgentDir, cwd: canonicalCwd, sessionId })}.json`;
43
+ return {
44
+ file: join(canonicalAgentDir, '.pichamber', 'locks', 'sessions', name),
45
+ canonicalAgentDir,
46
+ canonicalCwd,
47
+ };
48
+ };
49
+
50
+ const isValidLease = (value) => (
51
+ value
52
+ && typeof value === 'object'
53
+ && typeof value.profileKey === 'string' && value.profileKey.length > 0
54
+ && typeof value.serverInstanceId === 'string' && value.serverInstanceId.length > 0
55
+ && typeof value.daemonId === 'string' && value.daemonId.length > 0
56
+ && Number.isInteger(value.daemonPid) && value.daemonPid > 0
57
+ && typeof value.sessionId === 'string' && value.sessionId.length > 0
58
+ );
59
+
60
+ // The daemon owns resident Pi runtimes. A same-profile server restart may
61
+ // claim that daemon and change serverInstanceId without replacing the daemon
62
+ // or its runtimes, so the mutable server owner is diagnostic lease metadata,
63
+ // not part of lease ownership.
64
+ const isOwnLease = (lease, owner) => (
65
+ lease?.profileKey === owner?.profileKey
66
+ && lease?.daemonId === owner?.daemonId
67
+ && lease?.daemonPid === owner?.daemonPid
68
+ );
69
+
70
+ /**
71
+ * Acquire exclusive cross-daemon ownership of one Pi session.
72
+ *
73
+ * Different sessions may run in parallel. The same session may not be
74
+ * resident in two PiChamber daemons. Contention returns
75
+ * `{ acquired: false, owner }` so the daemon can project SESSION_IN_USE
76
+ * instead of pretending the session is absent.
77
+ */
78
+ export const acquireSessionLease = async ({
79
+ agentDir,
80
+ cwd,
81
+ sessionId,
82
+ owner,
83
+ platform = process.platform,
84
+ processLike = process,
85
+ timeoutMs = 5_000,
86
+ } = {}) => {
87
+ if (!owner || typeof owner !== 'object') throw new SessionLeaseError('INVALID_OWNER');
88
+ const { file, canonicalAgentDir, canonicalCwd } = resolveSessionLeaseFile({ agentDir, cwd, sessionId, platform });
89
+ await mkdir(dirname(file), { recursive: true, mode: 0o700 });
90
+ return withCrossProcessLock(`${file}.lock`, async () => {
91
+ let current = null;
92
+ try {
93
+ current = JSON.parse(await readFile(file, 'utf8'));
94
+ } catch (error) {
95
+ if (error?.code !== 'ENOENT') throw new SessionLeaseError('LEASE_UNREADABLE');
96
+ }
97
+ if (isValidLease(current) && !isOwnLease(current, owner)) {
98
+ if (isPidAlive(processLike, current.daemonPid)) {
99
+ return { acquired: false, owner: current };
100
+ }
101
+ }
102
+ const lease = {
103
+ profileKey: owner.profileKey,
104
+ serverInstanceId: owner.serverInstanceId,
105
+ daemonId: owner.daemonId,
106
+ daemonPid: owner.daemonPid,
107
+ sessionId,
108
+ cwd: canonicalCwd,
109
+ agentDir: canonicalAgentDir,
110
+ acquiredAt: new Date().toISOString(),
111
+ };
112
+ const temporary = `${file}.${processLike.pid}.tmp`;
113
+ await writeFile(temporary, JSON.stringify(lease), { mode: 0o600 });
114
+ await rename(temporary, file);
115
+ return { acquired: true, lease };
116
+ }, { timeoutMs, processLike });
117
+ };
118
+
119
+ export const releaseSessionLease = async ({
120
+ agentDir,
121
+ cwd,
122
+ sessionId,
123
+ owner,
124
+ platform = process.platform,
125
+ processLike = process,
126
+ timeoutMs = 5_000,
127
+ } = {}) => {
128
+ const { file } = resolveSessionLeaseFile({ agentDir, cwd, sessionId, platform });
129
+ return withCrossProcessLock(`${file}.lock`, async () => {
130
+ let current = null;
131
+ try {
132
+ current = JSON.parse(await readFile(file, 'utf8'));
133
+ } catch (error) {
134
+ if (error?.code === 'ENOENT') return { released: false };
135
+ throw new SessionLeaseError('LEASE_UNREADABLE');
136
+ }
137
+ if (!isOwnLease(current, owner)) return { released: false };
138
+ await rm(file, { force: true });
139
+ return { released: true };
140
+ }, { timeoutMs, processLike });
141
+ };
142
+
143
+ export const readSessionLeaseOwner = async ({ agentDir, cwd, sessionId, platform = process.platform } = {}) => {
144
+ const { file } = resolveSessionLeaseFile({ agentDir, cwd, sessionId, platform });
145
+ try {
146
+ const current = JSON.parse(await readFile(file, 'utf8'));
147
+ return isValidLease(current) ? current : null;
148
+ } catch {
149
+ return null;
150
+ }
151
+ };
@@ -0,0 +1,108 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { mkdtemp } from 'node:fs/promises';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+
6
+ import {
7
+ acquireSessionLease,
8
+ readSessionLeaseOwner,
9
+ releaseSessionLease,
10
+ } from './session-lease.js';
11
+
12
+ const ownerA = {
13
+ profileKey: 'web-p3000',
14
+ serverInstanceId: 'server-a',
15
+ daemonId: 'daemon-a',
16
+ daemonPid: process.pid,
17
+ };
18
+
19
+ const ownerB = {
20
+ profileKey: 'web-dev-p3902',
21
+ serverInstanceId: 'server-b',
22
+ daemonId: 'daemon-b',
23
+ daemonPid: process.pid,
24
+ };
25
+
26
+ describe('session lease', () => {
27
+ it('grants one owner and reports contention without hiding the session', async () => {
28
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-lease-'));
29
+ const agentDir = join(root, 'agent');
30
+ const cwd = join(root, 'project');
31
+ const sessionId = 'session-1';
32
+
33
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId, owner: ownerA })).resolves.toMatchObject({
34
+ acquired: true,
35
+ });
36
+ const contention = await acquireSessionLease({ agentDir, cwd, sessionId, owner: ownerB });
37
+ expect(contention.acquired).toBe(false);
38
+ expect(contention.owner?.profileKey).toBe('web-p3000');
39
+
40
+ // The session remains visible: the lease owner is readable.
41
+ await expect(readSessionLeaseOwner({ agentDir, cwd, sessionId })).resolves.toMatchObject({
42
+ profileKey: 'web-p3000',
43
+ });
44
+
45
+ // Another profile must not release the lease.
46
+ await expect(releaseSessionLease({ agentDir, cwd, sessionId, owner: ownerB })).resolves.toEqual({
47
+ released: false,
48
+ });
49
+ await expect(releaseSessionLease({ agentDir, cwd, sessionId, owner: ownerA })).resolves.toEqual({
50
+ released: true,
51
+ });
52
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId, owner: ownerB })).resolves.toMatchObject({
53
+ acquired: true,
54
+ });
55
+ });
56
+
57
+ it('keeps a resident lease owned by the daemon after its server owner changes', async () => {
58
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-lease-'));
59
+ const agentDir = join(root, 'agent');
60
+ const cwd = join(root, 'project');
61
+ const sessionId = 'session-claimed';
62
+ const claimedOwner = { ...ownerA, serverInstanceId: 'server-a-restarted' };
63
+
64
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId, owner: ownerA })).resolves.toMatchObject({
65
+ acquired: true,
66
+ });
67
+ await expect(releaseSessionLease({ agentDir, cwd, sessionId, owner: claimedOwner })).resolves.toEqual({
68
+ released: true,
69
+ });
70
+ });
71
+
72
+ it('reclaims a lease from a dead daemon pid', async () => {
73
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-lease-'));
74
+ const agentDir = join(root, 'agent');
75
+ const cwd = join(root, 'project');
76
+ const sessionId = 'session-dead-owner';
77
+ const deadOwner = { ...ownerA, daemonPid: 987_654_321 };
78
+ const processLike = {
79
+ pid: process.pid,
80
+ kill(pid, signal) {
81
+ if (pid === deadOwner.daemonPid && signal === 0) {
82
+ const error = new Error('ESRCH');
83
+ error.code = 'ESRCH';
84
+ throw error;
85
+ }
86
+ return process.kill(pid, signal);
87
+ },
88
+ };
89
+
90
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId, owner: deadOwner })).resolves.toMatchObject({ acquired: true });
91
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId, owner: ownerB, processLike })).resolves.toMatchObject({
92
+ acquired: true,
93
+ lease: { daemonId: ownerB.daemonId },
94
+ });
95
+ });
96
+
97
+ it('allows different sessions to run in parallel', async () => {
98
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-lease-'));
99
+ const agentDir = join(root, 'agent');
100
+ const cwd = join(root, 'project');
101
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId: 'a', owner: ownerA })).resolves.toMatchObject({
102
+ acquired: true,
103
+ });
104
+ await expect(acquireSessionLease({ agentDir, cwd, sessionId: 'b', owner: ownerB })).resolves.toMatchObject({
105
+ acquired: true,
106
+ });
107
+ });
108
+ });