@firstpick/pi-package-webui 0.8.4 → 0.8.6

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 (50) hide show
  1. package/README.md +24 -2
  2. package/bin/pi-webui.mjs +383 -31
  3. package/index.ts +8 -1
  4. package/lib/git-workflow-preferences.mjs +3 -0
  5. package/lib/session-summary-core.mjs +4 -3
  6. package/lib/trust-boundaries.mjs +13 -0
  7. package/lib/workspace-session-summaries.mjs +400 -0
  8. package/package.json +2 -2
  9. package/public/app.js +1242 -267
  10. package/public/index.html +77 -4
  11. package/public/service-worker.js +3 -1
  12. package/public/stream-output-controller.mjs +327 -0
  13. package/public/styles.css +249 -70
  14. package/public/theme-contract.mjs +244 -0
  15. package/session-summary.ts +164 -4
  16. package/tests/aur-review-widget-static.test.mjs +2 -1
  17. package/tests/boot-failure-diagnostics.test.mjs +2 -2
  18. package/tests/browser/interaction-continuity.spec.mjs +2 -2
  19. package/tests/browser/session-summary.spec.mjs +131 -3
  20. package/tests/browser/stream-output-isolation.spec.mjs +510 -0
  21. package/tests/codex-fast-mode-static.test.mjs +2 -2
  22. package/tests/composer-action-grid-reorder-static.test.mjs +2 -2
  23. package/tests/fast-mode-client-static.test.mjs +3 -2
  24. package/tests/feature-decision-output-popup-static.test.mjs +1 -1
  25. package/tests/fixtures/fake-pi.mjs +203 -2
  26. package/tests/git-workflow-preferences.test.mjs +7 -1
  27. package/tests/guided-git-aur-review.test.mjs +4 -3
  28. package/tests/http-endpoints-harness.test.mjs +224 -13
  29. package/tests/mobile-continuity-tablet-static.test.mjs +2 -2
  30. package/tests/mobile-foundation-static.test.mjs +3 -4
  31. package/tests/mobile-phone-experience-static.test.mjs +1 -1
  32. package/tests/mobile-static.test.mjs +63 -29
  33. package/tests/native-parity.test.mjs +1 -1
  34. package/tests/open-issue-wizard-static.test.mjs +2 -3
  35. package/tests/optional-feature-migration-frontend.test.mjs +3 -0
  36. package/tests/persistent-ui-layout-static.test.mjs +2 -2
  37. package/tests/questionnaire-dialog.test.mjs +2 -2
  38. package/tests/remote-auth-settings-harness.test.mjs +9 -0
  39. package/tests/session-summary-core.test.mjs +183 -1
  40. package/tests/side-panel-section-reorder-static.test.mjs +2 -2
  41. package/tests/stream-lifecycle-core.test.mjs +134 -0
  42. package/tests/stream-output-controller.test.mjs +252 -0
  43. package/tests/stream-output-isolation-static.test.mjs +89 -0
  44. package/tests/streaming-ui-coupling.test.mjs +50 -0
  45. package/tests/subagent-gate-visibility.test.mjs +1 -1
  46. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  47. package/tests/theme-contract.test.mjs +104 -0
  48. package/tests/theme-customizer-static.test.mjs +82 -0
  49. package/tests/theme-scheme-mode.test.mjs +15 -0
  50. package/tests/workspace-session-summaries.test.mjs +288 -0
@@ -0,0 +1,288 @@
1
+ import assert from "node:assert/strict";
2
+ import { mkdtemp, mkdir, rm, symlink, utimes, writeFile } from "node:fs/promises";
3
+ import os from "node:os";
4
+ import path from "node:path";
5
+ import {
6
+ WORKSPACE_SUMMARY_COMMAND_MAX_CHARS,
7
+ WORKSPACE_SUMMARY_MAX_LIVE_BYTES,
8
+ WORKSPACE_SUMMARY_PROTOCOL_VERSION,
9
+ WORKSPACE_SUMMARY_TOOL_MAX_CHARS,
10
+ canonicalizeWorkspaceCwd,
11
+ createLiveSummaryPayload,
12
+ discoverPersistedWorkspaceSummaries,
13
+ formatWorkspaceSummariesForCommand,
14
+ formatWorkspaceSummariesForTool,
15
+ mergeWorkspaceSessionSummaries,
16
+ normalizeLiveSummaryPayload,
17
+ workspaceCwdsEqual,
18
+ } from "../lib/workspace-session-summaries.mjs";
19
+ import { SESSION_SUMMARY_STATE_TYPE } from "../lib/session-summary-core.mjs";
20
+
21
+ function summaryState(sessionId, summaryMarkdown, {
22
+ title = "Workspace task",
23
+ generatedAt = "2026-08-05T12:00:00.000Z",
24
+ version = 1,
25
+ } = {}) {
26
+ return {
27
+ version,
28
+ source: {
29
+ sessionId,
30
+ leafId: "leaf",
31
+ fingerprint: "f".repeat(64),
32
+ entryCount: 4,
33
+ },
34
+ result: { title, summaryMarkdown },
35
+ generation: {
36
+ provider: "test-provider",
37
+ modelId: "test-model",
38
+ thinkingLevel: "low",
39
+ promptRevision: "session-summary-v1",
40
+ },
41
+ generatedAt,
42
+ settledTurnOrdinal: 2,
43
+ };
44
+ }
45
+
46
+ function sessionJsonl({ id, cwd, summary, name, headerVersion = 3, extraLines = [] }) {
47
+ const entries = [
48
+ { type: "session", version: headerVersion, id, timestamp: "2026-08-05T11:00:00.000Z", cwd },
49
+ { type: "message", id: "raw00001", parentId: null, timestamp: "2026-08-05T11:01:00.000Z", message: { role: "user", content: "RAW_TRANSCRIPT_SECRET ghp_rawtranscript1234567890 /home/private/.pi/agent/sessions/private.jsonl" } },
50
+ ...(name ? [{ type: "session_info", id: "name0001", parentId: "raw00001", timestamp: "2026-08-05T11:02:00.000Z", name }] : []),
51
+ ...extraLines,
52
+ { type: "custom", id: "sum00001", parentId: name ? "name0001" : "raw00001", timestamp: "2026-08-05T12:00:00.000Z", customType: SESSION_SUMMARY_STATE_TYPE, data: summary },
53
+ ];
54
+ return `${entries.map((entry) => typeof entry === "string" ? entry : JSON.stringify(entry)).join("\n")}\n`;
55
+ }
56
+
57
+ function livePayload(cwd, sessionId, summaryMarkdown, generatedAt = "2026-08-05T13:00:00.000Z") {
58
+ return {
59
+ version: WORKSPACE_SUMMARY_PROTOCOL_VERSION,
60
+ sessionId,
61
+ cwd: canonicalizeWorkspaceCwd(cwd),
62
+ title: `Title ${sessionId}`,
63
+ summaryMarkdown,
64
+ generatedAt,
65
+ sessionName: `Session ${sessionId}`,
66
+ };
67
+ }
68
+
69
+ const root = await mkdtemp(path.join(os.tmpdir(), "workspace-session-summaries-"));
70
+ try {
71
+ const workspace = path.join(root, "workspace");
72
+ const otherWorkspace = path.join(root, "other");
73
+ const sessionDir = path.join(root, "sessions");
74
+ await Promise.all([mkdir(workspace), mkdir(otherWorkspace), mkdir(sessionDir)]);
75
+
76
+ assert.equal(canonicalizeWorkspaceCwd(path.join(workspace, ".")), workspace);
77
+ assert.equal(workspaceCwdsEqual(workspace, path.join(workspace, "nested", "..")), true);
78
+ assert.equal(canonicalizeWorkspaceCwd("\0unsafe"), undefined);
79
+ if (process.platform !== "win32") {
80
+ const alias = path.join(root, "workspace-alias");
81
+ await symlink(workspace, alias, "dir");
82
+ assert.equal(workspaceCwdsEqual(workspace, alias), true, "symlink and real CWD should canonicalize equally");
83
+ }
84
+
85
+ const currentId = "current-session";
86
+ const sameId = "same-session";
87
+ const otherId = "other-session";
88
+ const invalidId = "invalid-session";
89
+ await writeFile(path.join(sessionDir, "current.jsonl"), sessionJsonl({
90
+ id: currentId,
91
+ cwd: workspace,
92
+ summary: summaryState(currentId, "Current persisted copy"),
93
+ }));
94
+ await writeFile(path.join(sessionDir, "same.jsonl"), sessionJsonl({
95
+ id: sameId,
96
+ cwd: workspace,
97
+ name: "Same workspace",
98
+ summary: summaryState(sameId, "Implement durable discovery."),
99
+ extraLines: ["{malformed-json", "x".repeat(30 * 1024)],
100
+ }));
101
+ await writeFile(path.join(sessionDir, "other.jsonl"), sessionJsonl({
102
+ id: otherId,
103
+ cwd: otherWorkspace,
104
+ summary: summaryState(otherId, "Must not cross CWD boundaries."),
105
+ }));
106
+ await writeFile(path.join(sessionDir, "invalid-version.jsonl"), sessionJsonl({
107
+ id: invalidId,
108
+ cwd: workspace,
109
+ headerVersion: 2,
110
+ summary: summaryState(invalidId, "Must not migrate or consume old formats."),
111
+ }));
112
+ await writeFile(path.join(sessionDir, "wrong-state-session.jsonl"), sessionJsonl({
113
+ id: "header-session",
114
+ cwd: workspace,
115
+ summary: summaryState("forged-session", "Mismatched state identity."),
116
+ }));
117
+
118
+ const now = new Date("2026-08-05T14:00:00.000Z");
119
+ await utimes(path.join(sessionDir, "same.jsonl"), now, now);
120
+ const discovered = await discoverPersistedWorkspaceSummaries({ cwd: workspace, sessionDir, currentSessionId: currentId });
121
+ assert.deepEqual(discovered.map((entry) => entry.sessionId), [sameId]);
122
+ assert.equal(discovered[0].source, "persisted");
123
+ assert.equal(discovered[0].sessionName, "Same workspace");
124
+ assert.equal(Object.hasOwn(discovered[0], "sessionFile"), false);
125
+ assert.equal(JSON.stringify(discovered).includes("RAW_TRANSCRIPT_SECRET"), false);
126
+ assert.equal(JSON.stringify(discovered).includes(sessionDir), false);
127
+
128
+ const oversizedFileId = "tail-session";
129
+ await writeFile(path.join(sessionDir, "tail.jsonl"), sessionJsonl({
130
+ id: oversizedFileId,
131
+ cwd: workspace,
132
+ summary: summaryState(oversizedFileId, "Found from a bounded tail read."),
133
+ extraLines: [{ type: "message", id: "large001", parentId: "raw00001", timestamp: "2026-08-05T11:30:00.000Z", message: { role: "user", content: "z".repeat(80_000) } }],
134
+ }));
135
+ const tailDiscovered = await discoverPersistedWorkspaceSummaries({
136
+ cwd: workspace,
137
+ sessionDir,
138
+ currentSessionId: currentId,
139
+ maxFileBytes: 32 * 1024,
140
+ });
141
+ assert.equal(tailDiscovered.some((entry) => entry.sessionId === oversizedFileId), true, "bounded tail should retain a recent summary after an oversized line");
142
+ const escapedSessionId = "escaped-session";
143
+ await writeFile(path.join(sessionDir, "escaped.jsonl"), sessionJsonl({
144
+ id: escapedSessionId,
145
+ cwd: workspace,
146
+ summary: summaryState(escapedSessionId, "\\".repeat(16_000)),
147
+ }));
148
+ const escapedDiscovered = await discoverPersistedWorkspaceSummaries({ cwd: workspace, sessionDir, currentSessionId: currentId });
149
+ assert.equal(escapedDiscovered.some((entry) => entry.sessionId === escapedSessionId), true, "valid decoded summaries remain discoverable when JSON escaping expands the custom-entry line");
150
+
151
+ const currentState = summaryState(currentId, "Current work summary.");
152
+ const publication = createLiveSummaryPayload({ cwd: workspace, state: currentState, sessionName: "Current worker" });
153
+ assert.ok(publication);
154
+ assert.equal(Buffer.byteLength(JSON.stringify(publication)) <= WORKSPACE_SUMMARY_MAX_LIVE_BYTES, true);
155
+ assert.equal(normalizeLiveSummaryPayload(publication)?.sessionId, currentId);
156
+ const redactedPublication = createLiveSummaryPayload({
157
+ cwd: workspace,
158
+ state: summaryState(currentId, [
159
+ "Token ghp_abcdefghijklmnopqrstuvwxyz123456 at /home/private/.pi/agent/sessions/private.jsonl",
160
+ "Windows C:\\Users\\alice\\.pi\\agent\\sessions\\--repo--\\secret.jsonl",
161
+ "AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE",
162
+ "npm_auth_token=npm_abcdefghijklmnopqrstuvwxyz123456",
163
+ "-----BEGIN PRIVATE KEY-----\nprivate-material\n-----END PRIVATE KEY-----",
164
+ ].join("\n")),
165
+ sessionName: "authorization: secret-value",
166
+ });
167
+ const redactedPublicationText = JSON.stringify(redactedPublication);
168
+ for (const sensitive of ["ghp_abcdefghijklmnopqrstuvwxyz123456", "private.jsonl", "secret.jsonl", "AKIAIOSFODNN7EXAMPLE", "npm_abcdefghijklmnopqrstuvwxyz123456", "private-material", "secret-value"]) {
169
+ assert.equal(redactedPublicationText.includes(sensitive), false, `live publication redacts ${sensitive} before transport`);
170
+ }
171
+ assert.equal(normalizeLiveSummaryPayload({ ...publication, transcript: "private" }), undefined, "unknown live fields should fail closed");
172
+ assert.equal(normalizeLiveSummaryPayload({ ...publication, version: 2 }), undefined);
173
+ assert.equal(normalizeLiveSummaryPayload({ ...publication, cwd: `${otherWorkspace}/nested/..` }), undefined, "non-canonical live CWD should fail");
174
+ assert.equal(normalizeLiveSummaryPayload({ ...publication, summaryMarkdown: "x".repeat(13 * 1024) }), undefined);
175
+ assert.equal(normalizeLiveSummaryPayload({ ...publication, generatedAt: "not-a-date" }), undefined);
176
+ assert.equal(normalizeLiveSummaryPayload({ ...publication, sessionId: "a\tb" }), undefined, "control characters in identifiers fail closed instead of being normalized");
177
+ assert.equal(createLiveSummaryPayload({ cwd: workspace, state: summaryState(currentId, "x".repeat(16 * 1024)) }).summaryMarkdown.length <= 12 * 1024, true);
178
+ assert.equal(createLiveSummaryPayload({
179
+ cwd: path.join(root, "w".repeat(3900)),
180
+ state: summaryState(currentId, "x".repeat(16 * 1024)),
181
+ }), undefined, "aggregate live payloads above the 15 KiB transport envelope fail closed");
182
+
183
+ const liveSame = livePayload(workspace, sameId, "Newer live copy.");
184
+ const liveDisconnected = livePayload(workspace, "disconnected", "Disconnected and stale.");
185
+ const liveCrossCwd = livePayload(otherWorkspace, "cross-cwd", "Wrong workspace.");
186
+ const liveSelf = livePayload(workspace, "self-live", "Self sender.");
187
+ const snapshot = mergeWorkspaceSessionSummaries({
188
+ cwd: workspace,
189
+ currentSessionId: currentId,
190
+ currentState,
191
+ currentSessionName: "Current worker",
192
+ selfSenderId: "sender-self",
193
+ liveAvailable: true,
194
+ connectedSessions: [
195
+ { senderId: "sender-live", cwd: workspace },
196
+ { senderId: "sender-cross", cwd: otherWorkspace },
197
+ { senderId: "sender-self", cwd: workspace },
198
+ ],
199
+ livePeers: [
200
+ { senderId: "sender-live", payload: liveSame, receivedAt: "2026-08-05T13:01:00.000Z" },
201
+ { senderId: "sender-gone", payload: liveDisconnected },
202
+ { senderId: "sender-cross", payload: liveCrossCwd },
203
+ { senderId: "sender-self", payload: liveSelf },
204
+ ],
205
+ persisted: [
206
+ ...discovered,
207
+ { sessionId: "persisted-new", title: "Persisted", summaryMarkdown: "Historical work.", generatedAt: "2026-08-05T14:00:00.000Z", modifiedAt: "2026-08-05T14:00:00.000Z" },
208
+ { sessionId: "persisted-old", title: "Persisted", summaryMarkdown: "Older historical work.", generatedAt: "2026-08-04T14:00:00.000Z", modifiedAt: "2026-08-04T14:00:00.000Z" },
209
+ ],
210
+ });
211
+ assert.deepEqual(snapshot.entries.map((entry) => [entry.sessionId, entry.source]), [
212
+ [currentId, "current"],
213
+ [sameId, "live"],
214
+ ["persisted-new", "persisted"],
215
+ ["persisted-old", "persisted"],
216
+ ]);
217
+ assert.deepEqual(snapshot.counts, { current: 1, live: 1, persisted: 2, peers: 3 });
218
+ assert.equal(snapshot.entries.some((entry) => entry.sessionId === "disconnected"), false);
219
+ assert.equal(snapshot.entries.some((entry) => entry.sessionId === "cross-cwd"), false);
220
+ const claimedIdCollision = mergeWorkspaceSessionSummaries({
221
+ cwd: workspace,
222
+ liveAvailable: true,
223
+ connectedSessions: [{ id: "sender-a", cwd: workspace }, { id: "sender-b", cwd: workspace }],
224
+ livePeers: [
225
+ { senderId: "sender-a", payload: livePayload(workspace, "claimed", "Sender A") },
226
+ { senderId: "sender-b", payload: livePayload(workspace, "claimed", "Sender B") },
227
+ ],
228
+ });
229
+ assert.equal(claimedIdCollision.counts.live, 2, "authoritative live senders are not collapsed by a payload-declared Pi session ID");
230
+ assert.deepEqual(new Set(claimedIdCollision.entries.map((entry) => entry.senderId)), new Set(["sender-a", "sender-b"]));
231
+
232
+ const fallback = mergeWorkspaceSessionSummaries({
233
+ cwd: workspace,
234
+ currentSessionId: currentId,
235
+ currentState,
236
+ liveAvailable: false,
237
+ connectedSessions: [{ senderId: "sender-live", cwd: workspace }],
238
+ livePeers: [{ senderId: "sender-live", payload: liveSame }],
239
+ persisted: discovered,
240
+ });
241
+ assert.equal(fallback.entries.find((entry) => entry.sessionId === sameId)?.source, "persisted");
242
+ assert.equal(fallback.liveAvailable, false);
243
+
244
+ const privateSnapshot = mergeWorkspaceSessionSummaries({
245
+ cwd: workspace,
246
+ currentSessionId: currentId,
247
+ currentState: summaryState(currentId, [
248
+ "Safe goal.",
249
+ "/home/private/.pi/agent/sessions/--private--/secret.jsonl",
250
+ "authorization: BearerValueThatMustNotAppear",
251
+ "ghp_abcdefghijklmnopqrstuvwxyz123456",
252
+ ].join("\n")),
253
+ liveAvailable: false,
254
+ });
255
+ const toolText = formatWorkspaceSummariesForTool(privateSnapshot);
256
+ const commandText = formatWorkspaceSummariesForCommand(privateSnapshot);
257
+ for (const text of [toolText, commandText]) {
258
+ assert.equal(text.includes("secret.jsonl"), false);
259
+ assert.equal(text.includes("BearerValueThatMustNotAppear"), false);
260
+ assert.equal(text.includes("ghp_abcdefghijklmnopqrstuvwxyz123456"), false);
261
+ assert.match(text, /reference-only/i);
262
+ assert.match(text, /intercom/i);
263
+ }
264
+ assert.equal(toolText.length <= WORKSPACE_SUMMARY_TOOL_MAX_CHARS, true);
265
+ assert.equal(commandText.length <= WORKSPACE_SUMMARY_COMMAND_MAX_CHARS, true);
266
+
267
+ const manyPersisted = Array.from({ length: 40 }, (_, index) => ({
268
+ sessionId: `bounded-${String(index).padStart(2, "0")}`,
269
+ title: `Bounded ${index}`,
270
+ summaryMarkdown: "content ".repeat(1000),
271
+ generatedAt: new Date(Date.UTC(2026, 7, 5, 10, index)).toISOString(),
272
+ modifiedAt: new Date(Date.UTC(2026, 7, 5, 10, index)).toISOString(),
273
+ }));
274
+ const boundedSnapshot = mergeWorkspaceSessionSummaries({ cwd: workspace, persisted: manyPersisted, maxEntries: 3 });
275
+ assert.deepEqual(boundedSnapshot.entries.map((entry) => entry.sessionId), ["bounded-39", "bounded-38", "bounded-37"]);
276
+ const boundedToolText = formatWorkspaceSummariesForTool(boundedSnapshot, { maxChars: 1000 });
277
+ const boundedCommandText = formatWorkspaceSummariesForCommand(boundedSnapshot, { maxChars: 700 });
278
+ assert.equal(boundedToolText.length <= 1000, true);
279
+ assert.equal(boundedCommandText.length <= 700, true);
280
+ for (const text of [boundedToolText, boundedCommandText]) {
281
+ assert.match(text, /untrusted|reference-only/i, "safety framing survives aggregate truncation");
282
+ assert.match(text, /intercom/i, "coordination guidance survives aggregate truncation");
283
+ }
284
+
285
+ console.log("workspace-session-summaries tests passed");
286
+ } finally {
287
+ await rm(root, { recursive: true, force: true });
288
+ }