@pi-chamber/web 0.8.2 → 0.9.1

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 (117) hide show
  1. package/README.md +22 -6
  2. package/bin/cli.js +16 -3
  3. package/bin/cli.test.js +62 -0
  4. package/bin/lib/DOCUMENTATION.md +6 -6
  5. package/bin/lib/cli-args.js +26 -7
  6. package/bin/lib/cli-lifecycle.js +3 -0
  7. package/bin/lib/cli-paths.js +6 -0
  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-lifecycle.js +14 -0
  12. package/bin/lib/commands-logs.js +24 -5
  13. package/bin/lib/commands-serve.js +176 -4
  14. package/bin/lib/commands-tunnel.js +35 -0
  15. package/bin/lib/commands-update.js +107 -39
  16. package/bin/lib/commands-update.test.js +97 -1
  17. package/dist/assets/{DiagramEditor-DerMrS6m.js → DiagramEditor-DoEOH0hY.js} +1 -1
  18. package/dist/assets/{DiagramView-DdipXAq8.js → DiagramView-y9Ystuhv.js} +1 -1
  19. package/dist/assets/DiffView-ScM4XoqZ.js +18 -0
  20. package/dist/assets/{FilesView-BXp0yc0j.js → FilesView-CjkhMFqJ.js} +3 -3
  21. package/dist/assets/GitView-Bqi6H8I-.js +8 -0
  22. package/dist/assets/JsonTreeView-DWhlH6NK.js +1 -0
  23. package/dist/assets/{MarkdownRendererImpl-DNZQgQua.js → MarkdownRendererImpl-CEOKZ1qH.js} +1 -1
  24. package/dist/assets/{PatchDiff-B_NFEIX7.js → PatchDiff-ClnfJJ2J.js} +1 -1
  25. package/dist/assets/{SessionSwitcherContent-Q4P2TGBr.js → SessionSwitcherContent-e6JzUXD_.js} +1 -1
  26. package/dist/assets/{SessionSwitcherDropdown-Cgw2mQIO.js → SessionSwitcherDropdown-C4etG8dv.js} +2 -2
  27. package/dist/assets/{SessionUnreadDot-BxtTkvHB.js → SessionUnreadDot-BVTSwRiG.js} +1 -1
  28. package/dist/assets/SettingsView-C0S0Sx-S.js +2 -0
  29. package/dist/assets/{SettingsWindow-BEjHL1ET.js → SettingsWindow-Cy9tmnMg.js} +1 -1
  30. package/dist/assets/ToolOutputDialog-Csrc0Uk2.js +8 -0
  31. package/dist/assets/{ToolPartDiffPreview-ClV785zX.js → ToolPartDiffPreview-6oH6KD44.js} +1 -1
  32. package/dist/assets/{VirtualizedFileDiff-DrxkW2WQ.js → VirtualizedFileDiff-DJNcTQNp.js} +4 -4
  33. package/dist/assets/{collapsible-CR3-hRMy.js → collapsible-DxgVLhi9.js} +1 -1
  34. package/dist/assets/computeVirtualFileMetrics-B-WoeBMW.js +3 -0
  35. package/dist/assets/{contextFileOpenGuard-BRc5Z0g-.js → contextFileOpenGuard-DQ4U9xRH.js} +1 -1
  36. package/dist/assets/gitStatusPredicates-CIFSGjJs.js +134 -0
  37. package/dist/assets/index-D2C3q2xD.js +8 -0
  38. package/dist/assets/index-DNoEeZ2U.css +1 -0
  39. package/dist/assets/{index-CMfiVUIr.js → index-DmNPBaSo.js} +1 -1
  40. package/dist/assets/{isDiffPlainText-MmBA1REG.js → isDiffPlainText-CrvpUauF.js} +1 -1
  41. package/dist/assets/{isFilePlainText-bQAPxqO9.js → isFilePlainText-CKvhS32g.js} +1 -1
  42. package/dist/assets/{main-zZrKd3hZ.js → main-BFv8slLp.js} +2 -2
  43. package/dist/assets/main-CjM7g4Gq.js +135 -0
  44. package/dist/assets/{markdownCore-B9jXCPry.js → markdownCore-DKrraAqT.js} +1 -1
  45. package/dist/assets/{miniChat-Di2oVS5o.js → miniChat-hQnLS5mt.js} +2 -2
  46. package/dist/assets/{mobile-VU_G_SgX.js → mobile-DuXOBGs_.js} +2 -2
  47. package/dist/assets/renderElectronMiniChatApp-ClJBZVGy.js +2 -0
  48. package/dist/assets/renderMobileApp-DofX2wjB.js +11 -0
  49. package/dist/assets/runtimeEndpointReset-BZeYg6eN.js +54 -0
  50. package/dist/assets/{runtimeSurface-CBaS2Ank.js → runtimeSurface-C7CBxDbh.js} +1 -1
  51. package/dist/assets/{useAppFontEffects-8ZU-TTIW.js → useAppFontEffects-Cs0f1dKn.js} +102 -102
  52. package/dist/assets/{useFilesViewSearch-COow9O9x.js → useFilesViewSearch-D1hcbBEc.js} +1 -1
  53. package/dist/assets/usePushVisibilityBeacon-DqHkuVS5.js +10 -0
  54. package/dist/assets/{useSwitcherItems-DOQqhi-e.js → useSwitcherItems-BEoW7LlC.js} +1 -1
  55. package/dist/assets/{vendor-codemirror-language-data-B_0wrsbo.js → vendor-codemirror-language-data-B8Ac62S_.js} +2 -2
  56. package/dist/assets/{vendor-dnd-kit-core-CP8ck10N.js → vendor-dnd-kit-core-C9qcAm_1.js} +1 -1
  57. package/dist/assets/{vendor-dnd-kit-sortable-B-Icjoj4.js → vendor-dnd-kit-sortable-D8ozj8M-.js} +1 -1
  58. package/dist/assets/vendor-xterm-addon-fit-DX4qG4td.js +1 -0
  59. package/dist/assets/vendor-xterm-xterm-CrXqRur4.js +16 -0
  60. package/dist/assets/vendor-xterm-xterm-DDGTF8rc.css +1 -0
  61. package/dist/assets/{web-components-C9ENH49P.js → web-components-Dy-Tz_LJ.js} +3 -3
  62. package/dist/index.html +4 -4
  63. package/dist/mini-chat.html +3 -3
  64. package/dist/mobile.html +3 -3
  65. package/package.json +3 -4
  66. package/server/index.js +26 -7
  67. package/server/lib/client-auth/pairing.js +13 -2
  68. package/server/lib/client-auth/remote-clients.js +13 -2
  69. package/server/lib/fs/DOCUMENTATION.md +3 -1
  70. package/server/lib/fs/routes.test.js +74 -0
  71. package/server/lib/git/DOCUMENTATION.md +1 -1
  72. package/server/lib/git/identity-storage.js +10 -1
  73. package/server/lib/package-manager.js +1 -1
  74. package/server/lib/package-manager.test.js +11 -0
  75. package/server/lib/pi/archive-store.js +3 -2
  76. package/server/lib/pi/model-config-store.js +6 -2
  77. package/server/lib/pi/routes.js +11 -2
  78. package/server/lib/pi/session-daemon/DOCUMENTATION.md +12 -6
  79. package/server/lib/pi/session-daemon/daemon-process.js +48 -13
  80. package/server/lib/pi/session-daemon/session-daemon.js +226 -40
  81. package/server/lib/pi/session-daemon/session-daemon.test.js +207 -0
  82. package/server/lib/pi/session-daemon/session-lease.js +151 -0
  83. package/server/lib/pi/session-daemon/session-lease.test.js +108 -0
  84. package/server/lib/pi/session-daemon/supervisor.js +244 -54
  85. package/server/lib/pi/session-daemon/supervisor.test.js +202 -6
  86. package/server/lib/pi/session-folders-store.js +20 -2
  87. package/server/lib/pi/session-folders-store.test.js +17 -0
  88. package/server/lib/pi/settings-store.js +3 -2
  89. package/server/lib/pi/snippets-store.js +4 -1
  90. package/server/lib/pi/ui-settings-store.js +3 -2
  91. package/server/lib/server/cross-process-lock.js +112 -0
  92. package/server/lib/server/cross-process-lock.test.js +70 -0
  93. package/server/lib/server/server-profile.js +110 -0
  94. package/server/lib/server/server-profile.test.js +58 -0
  95. package/server/lib/server/tunnel-service.DOCUMENTATION.md +7 -8
  96. package/server/lib/server/tunnel-service.js +8 -1
  97. package/server/lib/stt/DOCUMENTATION.md +1 -1
  98. package/server/lib/stt/config-store.js +3 -2
  99. package/server/lib/terminal/DOCUMENTATION.md +3 -3
  100. package/server/lib/tunnels/DOCUMENTATION.md +38 -18
  101. package/server/lib/ui-auth/ui-auth.js +9 -2
  102. package/server/lib/ui-auth/ui-passkeys.js +9 -1
  103. package/dist/assets/DiffView-Gh9wjthp.js +0 -18
  104. package/dist/assets/GitView-BmNCkkoC.js +0 -8
  105. package/dist/assets/JsonTreeView-CxXRXXzk.js +0 -1
  106. package/dist/assets/SettingsView-CFzxRzUq.js +0 -2
  107. package/dist/assets/ToolOutputDialog-C_7vJLEq.js +0 -8
  108. package/dist/assets/computeVirtualFileMetrics-D0mQcleY.js +0 -3
  109. package/dist/assets/gitStatusPredicates-DBGDfr1K.js +0 -134
  110. package/dist/assets/index-CzO3ooje.css +0 -1
  111. package/dist/assets/index-ivrh3jfy.js +0 -8
  112. package/dist/assets/main-BoVfUG73.js +0 -135
  113. package/dist/assets/renderElectronMiniChatApp-Bi1927c8.js +0 -2
  114. package/dist/assets/renderMobileApp-D9mxhuaM.js +0 -11
  115. package/dist/assets/runtimeEndpointReset-DImT35Ug.js +0 -54
  116. package/dist/assets/usePushVisibilityBeacon-zYd3ppNh.js +0 -10
  117. package/dist/assets/vendor-ghostty-web-CrxinGGH.js +0 -13
@@ -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
+ });