@pi-chamber/web 1.0.8-rc.3 → 1.0.8-rc.4

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 (102) hide show
  1. package/dist/assets/{AgentsSurface-wsW9VCRp.js → AgentsSurface-DbCBygRD.js} +1 -1
  2. package/dist/assets/{ChoicesArtifact-EwCf4Yxu.js → ChoicesArtifact-DUqhCvXh.js} +1 -1
  3. package/dist/assets/{DiagramView-BX6N99cQ.js → DiagramView-CnVOyJd2.js} +1 -1
  4. package/dist/assets/{DiffView-CI0eSnPP.js → DiffView-Db8JXsvA.js} +1 -1
  5. package/dist/assets/{FileSaveConflictDialog-GLj2W7VE.js → FileSaveConflictDialog-D6xyf709.js} +1 -1
  6. package/dist/assets/{FilesView-CI0tfZQL.js → FilesView-Cir0Wl9F.js} +1 -1
  7. package/dist/assets/{GitHubDetailScaffold-B85tZ9m7.js → GitHubDetailScaffold-US37Di_K.js} +1 -1
  8. package/dist/assets/{GitHubLinkPicker-Y6AuNiGl.js → GitHubLinkPicker-k_D-sk-e.js} +1 -1
  9. package/dist/assets/{GitHubListPrimitives-BJHBud6i.js → GitHubListPrimitives-DuUXrJGk.js} +1 -1
  10. package/dist/assets/{GitView-DueE69kW.js → GitView-BdX_3XRr.js} +3 -3
  11. package/dist/assets/{IssuesSurface-Cg-xkdIu.js → IssuesSurface-Cw93HC0G.js} +2 -2
  12. package/dist/assets/{JsonTreeView-Cvg6lc40.js → JsonTreeView-Bze4htWt.js} +1 -1
  13. package/dist/assets/{MarkdownRendererImpl-DExPx-QM.js → MarkdownRendererImpl-Ch7NDkF9.js} +1 -1
  14. package/dist/assets/{PatchDiff-_c3HZ34I.js → PatchDiff-l68Yz45X.js} +1 -1
  15. package/dist/assets/{PierreDiffViewer-CZnaqO-_.js → PierreDiffViewer-BHBySiXQ.js} +1 -1
  16. package/dist/assets/{PullRequestsSurface-C9AYPiwo.js → PullRequestsSurface-CGD4_ljc.js} +2 -2
  17. package/dist/assets/{SessionSwitcherContent-DOpnN-8S.js → SessionSwitcherContent-DqP8OWzB.js} +1 -1
  18. package/dist/assets/{SessionSwitcherDropdown-CmHMPZ69.js → SessionSwitcherDropdown-BkTg-cVd.js} +2 -2
  19. package/dist/assets/{SessionUnreadDot-CZCQ4t1J.js → SessionUnreadDot-CgvC3F5e.js} +1 -1
  20. package/dist/assets/{SettingsView-D5PO5M3z.js → SettingsView-CkIxCYhs.js} +3 -3
  21. package/dist/assets/{SettingsWindow-DXV5UOE8.js → SettingsWindow-DSdhzapT.js} +1 -1
  22. package/dist/assets/{SubagentsArtifact-CO1ZiI1x.js → SubagentsArtifact-BN3aX_8M.js} +1 -1
  23. package/dist/assets/{ToolOutputDialog-GOwNLj-y.js → ToolOutputDialog-CLwm4TjA.js} +1 -1
  24. package/dist/assets/{ToolPartDiffPreview-BoaiZji6.js → ToolPartDiffPreview-ERAStEKA.js} +1 -1
  25. package/dist/assets/{VirtualizedFileDiff-Chq1X8nw.js → VirtualizedFileDiff-DwR2fZHv.js} +1 -1
  26. package/dist/assets/{VisualFrame-u7aRcX7O.js → VisualFrame-Dwp7B_st.js} +1 -1
  27. package/dist/assets/{VisualsArtifact-D9vPjihW.js → VisualsArtifact-DlOxifHd.js} +1 -1
  28. package/dist/assets/{collapsible-BjpDEohv.js → collapsible-CW-_qd6v.js} +1 -1
  29. package/dist/assets/{computeVirtualFileMetrics-DmPCxbok.js → computeVirtualFileMetrics-SlBfr8LB.js} +1 -1
  30. package/dist/assets/{contextFileOpenGuard-CukNcUeY.js → contextFileOpenGuard-CHoFT50j.js} +1 -1
  31. package/dist/assets/{fileTreeStatus-CDyfNPYO.js → fileTreeStatus-D0uiC1D0.js} +1 -1
  32. package/dist/assets/{gitStatusPredicates-uI7Y7L5k.js → gitStatusPredicates-Bj3pkh2e.js} +1 -1
  33. package/dist/assets/{githubLink-B9Mxac4R.js → githubLink-CheLNuP0.js} +1 -1
  34. package/dist/assets/{index-BxKPJ9uG.js → index-BFkW-BPM.js} +3 -3
  35. package/dist/assets/{index-BWq2ibCw.js → index-C8zaLvup.js} +1 -1
  36. package/dist/assets/{main-ckQ0ciIN.js → main-CUEqZRu1.js} +2 -2
  37. package/dist/assets/{main-CWfC-9xT.js → main-V66ie29o.js} +4 -4
  38. package/dist/assets/{markdownCore-p2q2Kxwo.js → markdownCore-BRedKgCo.js} +1 -1
  39. package/dist/assets/{miniChat-x2TrwRYA.js → miniChat-BXwuEQhz.js} +2 -2
  40. package/dist/assets/{mobile-B0x2G8h1.js → mobile-7s-xLDG3.js} +2 -2
  41. package/dist/assets/{nativeFileSave-D542OJlG.js → nativeFileSave-Bj-V_9ae.js} +1 -1
  42. package/dist/assets/{pi-session-focus-preference-Q_RZUCnt.js → pi-session-focus-preference-clbekCjz.js} +1 -1
  43. package/dist/assets/{renderDiffWithHighlighter-CSFGSknx.js → renderDiffWithHighlighter-g9eKWi78.js} +1 -1
  44. package/dist/assets/{renderElectronMiniChatApp-CFIdesZT.js → renderElectronMiniChatApp-B6BN8YgC.js} +2 -2
  45. package/dist/assets/{renderFileWithHighlighter-C5JE0mRX.js → renderFileWithHighlighter-DKl6vubK.js} +1 -1
  46. package/dist/assets/{renderMobileApp-B1ybjcGM.js → renderMobileApp-Bp735rW7.js} +3 -3
  47. package/dist/assets/{runtimeEndpointReset-DyZSKCYM.js → runtimeEndpointReset-CtHv_OMT.js} +7 -7
  48. package/dist/assets/{runtimeSurface-BR_dhe7_.js → runtimeSurface-DD4Vn4HC.js} +1 -1
  49. package/dist/assets/{selection-CfOpW4rA.js → selection-DDT954wY.js} +1 -1
  50. package/dist/assets/useAppFontEffects-DJCrUN2D.js +226 -0
  51. package/dist/assets/{useGitHubRemoteSearch-M1AE2YuX.js → useGitHubRemoteSearch-B77fMiwQ.js} +1 -1
  52. package/dist/assets/{useSwitcherItems-D0i2BYYP.js → useSwitcherItems-CFY3mP06.js} +1 -1
  53. package/dist/assets/{web-components-wOQkOurQ.js → web-components-XIP_3VZv.js} +1 -1
  54. package/dist/index.html +3 -3
  55. package/dist/mini-chat.html +2 -2
  56. package/dist/mobile.html +2 -2
  57. package/package.json +2 -1
  58. package/pichamber.d.ts +139 -0
  59. package/plugins/subagents/extension.js +5 -5
  60. package/plugins/subagents/package.json +3 -2
  61. package/plugins/visuals/choices.js +8 -7
  62. package/plugins/visuals/extension.js +4 -4
  63. package/plugins/visuals/package.json +1 -1
  64. package/server/lib/marketplace/DOCUMENTATION.md +2 -2
  65. package/server/lib/marketplace/npm-registry.js +1 -1
  66. package/server/lib/marketplace/npm-registry.test.js +1 -1
  67. package/server/lib/marketplace/service.test.js +4 -4
  68. package/server/lib/open-url/DOCUMENTATION.md +1 -1
  69. package/server/lib/pi/extension-card.js +48 -0
  70. package/server/lib/pi/extension-card.test.js +35 -0
  71. package/server/lib/pi/extension-commands.js +49 -0
  72. package/server/lib/pi/extension-commands.test.js +38 -0
  73. package/server/lib/pi/extension-protocol.js +1 -2
  74. package/server/lib/pi/fixtures/pichamber-gui-demo.ts +52 -223
  75. package/server/lib/pi/routes-extension-events.test.js +35 -48
  76. package/server/lib/pi/routes.js +44 -54
  77. package/server/lib/pi/routes.test.js +32 -0
  78. package/server/lib/pi/session-daemon/DOCUMENTATION.md +7 -7
  79. package/server/lib/pi/session-daemon/extension-bridge-draft.test.js +0 -54
  80. package/server/lib/pi/session-daemon/extension-bridge.js +39 -162
  81. package/server/lib/pi/session-daemon/extension-controls.js +12 -57
  82. package/server/lib/pi/session-daemon/extension-controls.test.js +4 -34
  83. package/server/lib/pi/session-daemon/pichamber-api.js +38 -0
  84. package/server/lib/pi/session-daemon/pichamber-api.test.js +24 -0
  85. package/server/lib/pi/session-daemon/plugin-host.js +5 -7
  86. package/server/lib/pi/session-daemon/plugin-host.test.js +2 -3
  87. package/server/lib/pi/session-daemon/session-daemon-controls.e2e.test.js +53 -7
  88. package/server/lib/pi/session-daemon/session-daemon-drafts.e2e.test.js +5 -5
  89. package/server/lib/pi/session-daemon/session-daemon-extensions.e2e.test.js +9 -4
  90. package/server/lib/pi/session-daemon/session-daemon-extensions.test.js +28 -71
  91. package/server/lib/pi/session-daemon/session-daemon-plugins.e2e.test.js +1 -1
  92. package/server/lib/pi/session-daemon/session-daemon.js +138 -78
  93. package/server/lib/pi/session-daemon/session-daemon.test.js +68 -0
  94. package/server/lib/plugins/DOCUMENTATION.md +3 -3
  95. package/server/lib/plugins/impact.js +2 -4
  96. package/server/lib/plugins/impact.test.js +0 -1
  97. package/server/lib/plugins/manifest.js +9 -5
  98. package/server/lib/plugins/manifest.test.js +5 -4
  99. package/server/lib/plugins/store.test.js +1 -1
  100. package/server/lib/plugins/visuals-extension.test.js +16 -14
  101. package/dist/assets/useAppFontEffects-COMvkffC.js +0 -226
  102. package/server/lib/pi/session-daemon/pichamber-ui.js +0 -44
@@ -6,7 +6,7 @@ import { join } from 'node:path';
6
6
 
7
7
  import { createSessionDaemon } from './session-daemon.js';
8
8
 
9
- // Real SDK: a plain Pi extension declares a composer control on `pi.events`;
9
+ // Real SDK: a plain Pi extension declares a composer control with `pichamber.control`;
10
10
  // the daemon keeps it in the session snapshot, and `extensions.control` runs
11
11
  // the extension's own command for the value asked for. The extension then
12
12
  // reports the new value itself. No model is called.
@@ -16,7 +16,7 @@ const credential = 'controls-e2e-daemon-credential';
16
16
  const MODES_EXTENSION = `
17
17
  export default function (pi) {
18
18
  let mode = 'economy';
19
- const declare = () => pi.events.emit('pichamber:composer', {
19
+ const declare = (ctx) => globalThis.pichamber.control(ctx, {
20
20
  id: 'mode',
21
21
  kind: 'cycle',
22
22
  label: 'Mode',
@@ -29,17 +29,18 @@ export default function (pi) {
29
29
  for (const name of ['economy', 'balance']) {
30
30
  pi.registerCommand(name, {
31
31
  description: 'Switch to ' + name + ' mode',
32
- handler: async () => {
32
+ handler: async (args, ctx) => {
33
33
  mode = name;
34
+ globalThis.__controlsE2eArgs = args;
34
35
  globalThis.__controlsE2eRuns = (globalThis.__controlsE2eRuns ?? 0) + 1;
35
- declare();
36
+ await declare(ctx);
36
37
  },
37
38
  });
38
39
  }
39
- pi.on('session_start', () => {
40
- declare();
40
+ pi.on('session_start', async (_event, ctx) => {
41
+ await declare(ctx);
41
42
  // A control whose command nobody registered never runs.
42
- pi.events.emit('pichamber:composer', { id: 'ghost', kind: 'action', label: 'Ghost', command: 'not-registered' });
43
+ await globalThis.pichamber.control(ctx, { id: 'ghost', kind: 'action', label: 'Ghost', command: 'not-registered' });
43
44
  });
44
45
  }
45
46
  `;
@@ -105,6 +106,7 @@ describe('session daemon composer controls end-to-end with real SDK', () => {
105
106
  await daemon?.stop();
106
107
  daemon = undefined;
107
108
  delete globalThis.__controlsE2eRuns;
109
+ delete globalThis.__controlsE2eArgs;
108
110
  });
109
111
 
110
112
  it('keeps a declared control and runs its command for a click', async () => {
@@ -163,6 +165,50 @@ describe('session daemon composer controls end-to-end with real SDK', () => {
163
165
  expect(globalThis.__controlsE2eRuns).toBe(1);
164
166
  }, 60_000);
165
167
 
168
+ it('runs a card action\'s command by the same rule, and refuses one nobody registered', async () => {
169
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-controls-e2e-'));
170
+ const projectDir = join(root, 'project');
171
+ const agentDir = join(root, 'agent');
172
+ await mkdir(projectDir, { recursive: true });
173
+ await mkdir(join(agentDir, 'extensions'), { recursive: true });
174
+ await writeFile(join(agentDir, 'extensions', 'modes.ts'), MODES_EXTENSION);
175
+ const endpoint = process.platform === 'win32' ? `\\\\.\\pipe\\pichamber-command-e2e-${Date.now()}` : join(root, 'daemon.sock');
176
+
177
+ daemon = createSessionDaemon({ endpoint, credential, cwd: projectDir, agentDir });
178
+ await daemon.start();
179
+ const client = connectClient(endpoint);
180
+ await client.authenticate();
181
+ expect((await client.request('runtime.health')).capabilities).toContain('extensions.command');
182
+
183
+ const created = await client.request('sessions.create', { cwd: projectDir });
184
+ const sessionId = created.session.id;
185
+ await client.request('sessions.open', { sessionId });
186
+
187
+ // A leading `/` is allowed, as in a composer control; args arrive as one line.
188
+ await expect(client.request('extensions.command', { sessionId, command: '/balance', args: ' fast\nplease ' }))
189
+ .resolves.toEqual({ ran: true });
190
+ expect(globalThis.__controlsE2eRuns).toBe(1);
191
+ expect(globalThis.__controlsE2eArgs).toBe('fast please');
192
+ // Nothing reached the transcript.
193
+ expect((await client.request('sessions.open', { sessionId })).messages ?? []).toEqual([]);
194
+ await client.close();
195
+
196
+ const failing = async (payload, code) => {
197
+ const fresh = connectClient(endpoint);
198
+ await fresh.authenticate();
199
+ await expect(fresh.request('extensions.command', payload)).rejects.toThrow(code);
200
+ };
201
+ // Never sent to the model as a prompt.
202
+ await failing({ sessionId, command: 'not-registered' }, 'COMMAND_UNAVAILABLE');
203
+ await failing({ sessionId, command: 'a/b' }, 'INVALID_ARGUMENT');
204
+ await failing({ sessionId, command: 'balance', args: 3 }, 'INVALID_ARGUMENT');
205
+ expect(globalThis.__controlsE2eRuns).toBe(1);
206
+ const check = connectClient(endpoint);
207
+ await check.authenticate();
208
+ expect((await check.request('sessions.open', { sessionId })).messages ?? []).toEqual([]);
209
+ await check.close();
210
+ }, 60_000);
211
+
166
212
  it('holds a settings change until a running shell command ends, then drops the control', async () => {
167
213
  const root = await mkdtemp(join(tmpdir(), 'pichamber-controls-e2e-'));
168
214
  const projectDir = join(root, 'project');
@@ -36,7 +36,7 @@ export default function (pi) {
36
36
  const MODES_EXTENSION = `
37
37
  export default function (pi) {
38
38
  let mode = 'economy';
39
- const declare = () => pi.events.emit('pichamber:composer', {
39
+ const declare = (ctx) => globalThis.pichamber.control(ctx, {
40
40
  id: 'mode',
41
41
  kind: 'cycle',
42
42
  label: 'Mode',
@@ -54,11 +54,11 @@ export default function (pi) {
54
54
  const model = ctx.modelRegistry.find('drafts-mock-provider', name === 'balance' ? 'drafts-smart' : 'drafts-cheap');
55
55
  if (model) await pi.setModel(model);
56
56
  pi.setThinkingLevel(name === 'balance' ? 'high' : 'low');
57
- declare();
57
+ await declare(ctx);
58
58
  },
59
59
  });
60
60
  }
61
- pi.on('session_start', () => declare());
61
+ pi.on('session_start', (_event, ctx) => declare(ctx));
62
62
  }
63
63
  `;
64
64
 
@@ -66,7 +66,7 @@ export default function (pi) {
66
66
  // dialog, and one whose command starts an agent turn.
67
67
  const EXTRAS_EXTENSION = `
68
68
  export default function (pi) {
69
- const declare = () => pi.events.emit('pichamber:composer', {
69
+ const declare = (ctx) => globalThis.pichamber.control(ctx, {
70
70
  id: 'extra',
71
71
  kind: 'cycle',
72
72
  label: 'Extra',
@@ -86,7 +86,7 @@ export default function (pi) {
86
86
  description: 'Start a turn',
87
87
  handler: async () => { pi.sendUserMessage('hello from a control'); },
88
88
  });
89
- pi.on('session_start', () => declare());
89
+ pi.on('session_start', (_event, ctx) => declare(ctx));
90
90
  }
91
91
  `;
92
92
 
@@ -16,6 +16,11 @@ const DEMO_EXTENSION = `
16
16
  const answer = Symbol.for('pichamber-demo-answer');
17
17
 
18
18
  export default function (pi) {
19
+ // A card made while the session starts, before the daemon has registered
20
+ // the runtime, is saved like one from a command.
21
+ pi.on("session_start", async (_event, ctx) => {
22
+ await globalThis.pichamber.card(ctx, { title: "Started", component: "markdown", props: { body: "ready" } });
23
+ });
19
24
  pi.registerCommand("demo-state", {
20
25
  description: "Mutate extension-owned runtime state",
21
26
  handler: async (_args, ctx) => {
@@ -43,7 +48,7 @@ export default function (pi) {
43
48
  description: "Ask a question",
44
49
  handler: async (_args, ctx) => {
45
50
  const ok = await ctx.ui.confirm("Fire the missile?", "This cannot be undone");
46
- pi.appendEntry("pichamber.ui", {
51
+ await globalThis.pichamber.card(ctx, {
47
52
  title: "Demo",
48
53
  component: "badges",
49
54
  props: { items: [{ label: ok ? "confirmed" : "declined", tone: ok ? "success" : "warning" }] },
@@ -177,8 +182,8 @@ describe('pi extensions end-to-end through the real SDK', () => {
177
182
  await dialogPrompt;
178
183
 
179
184
  // Extension saw the answer and emitted its GUI card + custom message.
180
- const card = await client.next((message) => message.kind === 'event' && message.event === 'extension.entry');
181
- expect(card.payload.customType).toBe('pichamber.ui');
185
+ const card = await client.next((message) => message.kind === 'event' && message.event === 'extension.entry' && message.payload.data?.component === 'badges');
186
+ expect(card.payload.customType).toBe('pichamber.card');
182
187
  expect(card.payload.data.component).toBe('badges');
183
188
 
184
189
  const note = await client.next((message) => message.kind === 'event' && message.event === 'extension.message');
@@ -190,7 +195,7 @@ describe('pi extensions end-to-end through the real SDK', () => {
190
195
  // A fresh projection includes both items for reconnect/hydration.
191
196
  const opened = await client.request('sessions.open', { sessionId: created.result.session.id });
192
197
  const extensionItems = opened.result.messages.filter((item) => item.message.role === 'extension');
193
- expect(extensionItems.map((item) => item.message.customType).sort()).toEqual(['demo-note', 'pichamber.ui']);
198
+ expect(extensionItems.map((item) => item.message.customType).sort()).toEqual(['demo-note', 'pichamber.card', 'pichamber.card']);
194
199
 
195
200
  const sessionUpdated = client.next((message) => message.event === 'session.updated' && message.payload?.title === 'Extension-owned title');
196
201
  const treeUpdated = client.next((message) => message.event === 'session.tree.updated');
@@ -760,7 +760,7 @@ describe('Pi session daemon extension bridging', () => {
760
760
  });
761
761
  });
762
762
 
763
- describe('Pi session daemon extension panels, apps, and forms', () => {
763
+ describe('Pi session daemon extension cards and forms', () => {
764
764
  let daemon;
765
765
  let sessions = [];
766
766
 
@@ -801,56 +801,11 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
801
801
  sessions = [];
802
802
  });
803
803
 
804
- it('mirrors pichamber.ui entries into extension.ui panels that update in place and appear in snapshots', async () => {
805
- const { client, session, endpoint } = await startWithExtensibleSession();
806
-
807
- session.emit({
808
- type: 'entry_appended',
809
- entry: { type: 'custom', id: 'entry-1', customType: 'pichamber.ui', data: { protocol: 'pichamber-extension-ui', version: 1, id: 'subagents', title: 'Sub-agents', component: 'progress', props: { value: 10 } }, timestamp: '2026-01-01T00:00:01.000Z' },
810
- });
811
- const first = await client.next((message) => message.event === 'extension.ui');
812
- expect(first.payload).toMatchObject({ id: 'subagents', title: 'Sub-agents', component: 'progress' });
813
-
814
- // Latest wins per id: an update replaces the panel instead of stacking.
815
- session.emit({
816
- type: 'entry_appended',
817
- entry: { type: 'custom', id: 'entry-2', customType: 'pichamber.ui', data: { id: 'subagents', component: 'progress', props: { value: 90 } }, timestamp: '2026-01-01T00:00:02.000Z' },
818
- });
819
- await client.next((message) => message.event === 'extension.ui' && message.payload?.props?.value === 90);
820
-
821
- // A freshly authenticating client receives the normalized panels in its
822
- // authoritative snapshot.
823
- const reconnect = connectClient(endpoint);
824
- const snapshot = await reconnect.authenticate();
825
- expect(snapshot.payload.extensionPanels).toHaveLength(1);
826
- expect(snapshot.payload.extensionPanels[0]).toMatchObject({ id: 'subagents', props: { value: 90 } });
827
- reconnect.close();
828
- });
829
-
830
- it('mirrors pichamber.app entries into extension.app events and unregisters on removal', async () => {
831
- const { client, session } = await startWithExtensibleSession();
832
-
833
- session.emit({
834
- type: 'entry_appended',
835
- entry: { type: 'custom', id: 'app-entry-1', customType: 'pichamber.app', data: { appId: 'board', title: 'Board', html: '<button data-pichamber-command="board-run">Run</button>' }, timestamp: '2026-01-01T00:00:03.000Z' },
836
- });
837
- const appEvent = await client.next((message) => message.event === 'extension.app');
838
- expect(appEvent.payload).toMatchObject({ appId: 'board', title: 'Board' });
839
- expect(appEvent.payload.html).toContain('data-pichamber-command');
840
-
841
- session.emit({
842
- type: 'entry_appended',
843
- entry: { type: 'custom', id: 'app-entry-2', customType: 'pichamber.app', data: { appId: 'board', removed: true }, timestamp: '2026-01-01T00:00:04.000Z' },
844
- });
845
- const removal = await client.next((message) => message.event === 'extension.app' && message.payload?.removed === true);
846
- expect(removal.payload.appId).toBe('board');
847
- });
848
-
849
- it('bridges pichamber.ui.form to a form dialog and resolves with a values object', async () => {
804
+ it('bridges pichamber.form to a form dialog and resolves with a values object', async () => {
850
805
  const { client, session, endpoint } = await startWithExtensibleSession();
851
806
  const ctx = { ui: session.boundBindings.uiContext };
852
807
 
853
- const pending = globalThis.pichamber.ui.form(ctx, 'Spawn agent', [
808
+ const pending = globalThis.pichamber.form(ctx, 'Spawn agent', [
854
809
  { id: 'name', label: 'Name', type: 'text', required: true },
855
810
  { id: 'level', label: 'Level', type: 'select', options: ['low', 'high'], initial: 'high' },
856
811
  { id: 'workers', label: 'Workers', type: 'number', min: 1, max: 4 },
@@ -882,7 +837,7 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
882
837
  expect(await pending).toEqual({ name: 'research', level: 'high', workers: '4' });
883
838
  });
884
839
 
885
- it('bridges pichamber.ui.choose to a choose dialog tied to its tool call', async () => {
840
+ it('bridges pichamber.choose to a choose dialog tied to its tool call', async () => {
886
841
  const { client, session, endpoint } = await startWithExtensibleSession();
887
842
  const ctx = { ui: session.boundBindings.uiContext };
888
843
  const { pichamber } = globalThis;
@@ -895,7 +850,7 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
895
850
  { label: 'no id' },
896
851
  ];
897
852
 
898
- const pending = pichamber.ui.choose(ctx, 'Which header?', choices, { toolCallId: 'call-7', allowNote: true });
853
+ const pending = pichamber.choose(ctx, 'Which header?', choices, { toolCallId: 'call-7', allowNote: true });
899
854
  const request = await client.next((message) => message.kind === 'event' && message.event === 'extension.dialog');
900
855
  expect(request.payload).toMatchObject({
901
856
  method: 'choose',
@@ -924,7 +879,7 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
924
879
  expect(await pending).toEqual({ id: 'b', note: 'darker header' });
925
880
 
926
881
  // A note for a question that takes none is refused; dismissing resolves undefined.
927
- const plain = pichamber.ui.choose(ctx, 'Pick', [{ id: 'x', label: 'X' }]);
882
+ const plain = pichamber.choose(ctx, 'Pick', [{ id: 'x', label: 'X' }]);
928
883
  const plainRequest = await answering.next((message) => message.kind === 'event' && message.event === 'extension.dialog');
929
884
  expect(plainRequest.payload).not.toHaveProperty('allowNote');
930
885
  expect(plainRequest.payload).not.toHaveProperty('toolCallId');
@@ -940,14 +895,14 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
940
895
  expect(await plain).toBeUndefined();
941
896
 
942
897
  // Nothing to choose, or no title: nothing is shown and the call fails.
943
- await expect(pichamber.ui.choose(ctx, 'Pick', [{ label: 'no id' }])).rejects.toThrow(/at least one choice/);
944
- await expect(pichamber.ui.choose(ctx, '', [{ id: 'x', label: 'X' }])).rejects.toThrow(/title/);
898
+ await expect(pichamber.choose(ctx, 'Pick', [{ label: 'no id' }])).rejects.toThrow(/at least one choice/);
899
+ await expect(pichamber.choose(ctx, '', [{ id: 'x', label: 'X' }])).rejects.toThrow(/title/);
945
900
  });
946
901
 
947
- it('exposes globalThis.pichamber with ui, and keeps the released markers', () => {
902
+ it('exposes globalThis.pichamber with every function, and keeps the released markers', () => {
948
903
  expect(Object.isFrozen(globalThis.pichamber)).toBe(true);
949
- expect(globalThis.pichamber.version).toBe(1);
950
- expect(Object.keys(globalThis.pichamber.ui).sort()).toEqual(['choose', 'form', 'openUrl']);
904
+ expect(globalThis.pichamber.apiVersion).toBe(1);
905
+ expect(Object.keys(globalThis.pichamber).sort()).toEqual(['apiVersion', 'card', 'choose', 'control', 'form', 'openUrl']);
951
906
  expect(globalThis.__PICHAMBER__.version).toBe(1);
952
907
  expect(process.env.PICHAMBER).toBe('1');
953
908
  });
@@ -959,17 +914,17 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
959
914
  // PiChamber's own calls are not on Pi's `ctx.ui` under a string name.
960
915
  expect(ctx.ui).not.toHaveProperty('form');
961
916
  expect(ctx.ui).not.toHaveProperty('openUrl');
962
- await expect(globalThis.pichamber.ui.openUrl(ctx, 'file:///etc/passwd')).resolves.toBe(false);
917
+ await expect(globalThis.pichamber.openUrl(ctx, 'file:///etc/passwd')).resolves.toBe(false);
963
918
  });
964
919
 
965
- it('rejects a pichamber.ui call without a PiChamber ctx, never synchronously', async () => {
920
+ it('rejects a pichamber call without a PiChamber ctx, never synchronously', async () => {
966
921
  const { pichamber } = globalThis;
967
- for (const name of ['choose', 'form', 'openUrl']) {
922
+ for (const name of ['choose', 'form', 'openUrl', 'card', 'control']) {
968
923
  let promise;
969
- expect(() => { promise = pichamber.ui[name](undefined, 'T', []); }).not.toThrow();
924
+ expect(() => { promise = pichamber[name](undefined, 'T', []); }).not.toThrow();
970
925
  await expect(promise).rejects.toBeInstanceOf(TypeError);
971
926
  await expect(promise).rejects.toThrow(/ctx/);
972
- await expect(pichamber.ui[name]({ ui: { select: async () => undefined } }, 'T', [])).rejects.toBeInstanceOf(TypeError);
927
+ await expect(pichamber[name]({ ui: { select: async () => undefined } }, 'T', [])).rejects.toBeInstanceOf(TypeError);
973
928
  }
974
929
  });
975
930
 
@@ -1018,7 +973,7 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
1018
973
  expect(setEvent.payload).toMatchObject({ text: 'hello set', mode: 'set' });
1019
974
  });
1020
975
 
1021
- it('excludes idd pichamber.ui entries from sessions.open messages while rebuilding them into live panel snapshots on open and handling removed: true', async () => {
976
+ it('keeps the panels and app surfaces 1.0.6 saved out of the transcript, and shows saved cards', async () => {
1022
977
  const { client, session } = await startWithExtensibleSession({
1023
978
  entries: [
1024
979
  {
@@ -1049,6 +1004,13 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
1049
1004
  data: { id: 'temp-panel', removed: true },
1050
1005
  timestamp: '2026-01-01T00:00:04.000Z',
1051
1006
  },
1007
+ {
1008
+ type: 'custom',
1009
+ id: 'entry-5',
1010
+ customType: 'pichamber.app',
1011
+ data: { appId: 'board', html: '<p>board</p>' },
1012
+ timestamp: '2026-01-01T00:00:04.500Z',
1013
+ },
1052
1014
  {
1053
1015
  type: 'custom',
1054
1016
  id: 'card-1',
@@ -1060,15 +1022,10 @@ describe('Pi session daemon extension panels, apps, and forms', () => {
1060
1022
  });
1061
1023
 
1062
1024
  const openRes = await client.request('sessions.open', { sessionId: session.sessionId });
1063
- expect(openRes.result.extensionPanels).toHaveLength(1);
1064
- expect(openRes.result.extensionPanels[0]).toMatchObject({
1065
- id: 'status-panel',
1066
- title: 'Status',
1067
- component: 'badges',
1068
- props: { status: 'completed' },
1069
- });
1070
- // Id'd entries entry-1, entry-2, entry-3, entry-4 must NOT appear in messages.
1071
- // The un-id'd card-1 entry DOES appear in messages.
1025
+ expect(openRes.result).not.toHaveProperty('extensionPanels');
1026
+ expect(openRes.result).not.toHaveProperty('extensionApps');
1027
+ // The panel entries (an `id`) and the app surface never showed and still
1028
+ // do not; the card saved as `pichamber.ui` does.
1072
1029
  const extensionMessages = openRes.result.messages.filter((m) => m.message.role === 'extension');
1073
1030
  expect(extensionMessages).toHaveLength(1);
1074
1031
  expect(extensionMessages[0].message.id).toBe('card-1');
@@ -10,7 +10,7 @@ import { createSessionDaemon } from './session-daemon.js';
10
10
  // Real SDK: the bundled plugins load through `plugins.configure`, which
11
11
  // recreates the runtime. Visuals has no switch: `render_html` is declared and
12
12
  // runs while the plugin is configured, and `render_choices` shows its options,
13
- // asks through `pichamber.ui.choose` tied to its tool call, and returns the answer.
13
+ // asks through `pichamber.choose` tied to its tool call, and returns the answer.
14
14
  // Sub-agents follows its `on` state: a
15
15
  // state-only change removes `subagent` from the declared tools without
16
16
  // recreation, and a session's own value (its composer switch) applies to