pi-pocket 0.25.0 → 0.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/AGENTS.md +2 -0
  2. package/README.md +5 -3
  3. package/docs/architecture.md +21 -0
  4. package/docs/design/design-mode.md +108 -0
  5. package/docs/design/notes-a.md +106 -0
  6. package/docs/design/notes-b.md +123 -0
  7. package/docs/design/notes-c.md +92 -0
  8. package/docs/design/notes-d.md +78 -0
  9. package/docs/design/release-notes-design.md +46 -0
  10. package/docs/extensions/browser-modules.md +2 -0
  11. package/docs/extensions/policies/api-stability.md +2 -0
  12. package/docs/extensions/reference/api-versions.md +1 -0
  13. package/docs/extensions/reference/host.md +1 -1
  14. package/docs/extensions/reference/limits.md +4 -0
  15. package/docs/extensions/reference/names.md +2 -2
  16. package/docs/extensions/reference/pocket.md +38 -0
  17. package/docs/features.md +19 -5
  18. package/docs/map.md +75 -54
  19. package/docs/release-notes.md +1 -1
  20. package/docs/self-editing.md +1 -1
  21. package/docs/systemd.md +1 -1
  22. package/npm-shrinkwrap.json +2 -2
  23. package/package.json +1 -1
  24. package/src/launcher/main.ts +20 -9
  25. package/src/server/app.ts +113 -4
  26. package/src/server/background.ts +3 -3
  27. package/src/server/cache-keeper.ts +605 -0
  28. package/src/server/compaction.ts +68 -15
  29. package/src/server/design/bundle.ts +65 -0
  30. package/src/server/design/export.ts +118 -0
  31. package/src/server/design/files.ts +49 -0
  32. package/src/server/design/guide.ts +56 -0
  33. package/src/server/design/index.ts +232 -0
  34. package/src/server/design/pptx.ts +304 -0
  35. package/src/server/design/render.ts +593 -0
  36. package/src/server/design/system.ts +248 -0
  37. package/src/server/docs.ts +55 -0
  38. package/src/server/extensions/artifacts.ts +202 -18
  39. package/src/server/extensions/design/canvas.js +304 -0
  40. package/src/server/extensions/design/comments.js +15 -0
  41. package/src/server/extensions/design/data.js +263 -0
  42. package/src/server/extensions/design/devices.js +70 -0
  43. package/src/server/extensions/design/docks.js +647 -0
  44. package/src/server/extensions/design/edits.js +37 -0
  45. package/src/server/extensions/design/index.js +326 -0
  46. package/src/server/extensions/design/messages.js +92 -0
  47. package/src/server/extensions/design/parts.js +160 -0
  48. package/src/server/extensions/design/state.js +146 -0
  49. package/src/server/extensions/design/style.css +1332 -0
  50. package/src/server/extensions/design/tweaks.js +161 -0
  51. package/src/server/extensions/design/views.js +375 -0
  52. package/src/server/extensions/design/workspace.js +723 -0
  53. package/src/server/extensions/design.ts +620 -0
  54. package/src/server/extensions/plan.ts +11 -9
  55. package/src/server/extensions/prompt.ts +11 -3
  56. package/src/server/extensions/subagents.ts +7 -1
  57. package/src/server/extensions/updates/index.js +16 -6
  58. package/src/server/extensions/updates.ts +2 -2
  59. package/src/server/http/artifact-assets.ts +216 -0
  60. package/src/server/http/artifact-inspect.ts +1281 -0
  61. package/src/server/http/artifacts.ts +89 -14
  62. package/src/server/http/conversation-routes.ts +46 -1
  63. package/src/server/http.ts +12 -4
  64. package/src/server/main.ts +4 -0
  65. package/src/server/npm-install.ts +82 -0
  66. package/src/server/npm-update.ts +100 -0
  67. package/src/server/reload.ts +5 -0
  68. package/src/server/room.ts +2 -0
  69. package/src/server/spend.ts +73 -9
  70. package/src/server/update-state.ts +257 -8
  71. package/src/server/updates.ts +268 -33
  72. package/src/server/zip.ts +163 -0
  73. package/types/pocket.d.ts +32 -0
  74. package/web/activity-fold.js +28 -0
  75. package/web/artifact-bridge.js +506 -82
  76. package/web/extension-ui.js +21 -1
  77. package/web/pip.js +46 -9
  78. package/web/sessions.js +1 -1
  79. package/web/sheets/appearance.js +10 -0
  80. package/web/sheets/viewers.js +26 -1
  81. package/web/style.css +11 -0
  82. package/web/taps.js +26 -0
  83. package/web/theme.js +6 -0
  84. package/web/transcript.js +19 -10
  85. package/src/server/http/public.ts +0 -30
package/types/pocket.d.ts CHANGED
@@ -2378,6 +2378,32 @@ export interface SwitchProps {
2378
2378
  disabled?: boolean;
2379
2379
  }
2380
2380
 
2381
+ /**
2382
+ * What `pocket.pip.ask` answers. It does not throw when PiP is not there: `reason` tells why nothing happened. `sent` is
2383
+ * false when the text waits in PiP's message box.
2384
+ * @since 0.26.0
2385
+ * @experimental
2386
+ */
2387
+ export type PipAskResult = { ok: true; sent: boolean } | { ok: false; reason: string };
2388
+
2389
+ /**
2390
+ * The part of `pocket` that talks to PiP.
2391
+ * @since 0.26.0
2392
+ * @experimental
2393
+ */
2394
+ export interface PipApi {
2395
+ /**
2396
+ * Gives PiP text as the person's own message. By default it opens PiP and puts the text in its message box, after
2397
+ * what is there, for the person to read, edit, and send. With `send: true` it sends the text at once, but only just
2398
+ * after the person tapped or pressed a key: one tap serves for 5 seconds and for one send. The text starts with the
2399
+ * module's title, so the person and PiP see where it came from. It resolves with `{ ok: false, reason }` when the
2400
+ * person has no PiP, and when `send` has no tap to use. Text that is empty or past 100,000 characters throws.
2401
+ * @since 0.26.0
2402
+ * @experimental
2403
+ */
2404
+ ask(text: string, options?: { send?: boolean }): Promise<PipAskResult>;
2405
+ }
2406
+
2381
2407
  /**
2382
2408
  * The app's API for a browser module: the argument of its default export.
2383
2409
  * @since 0.14.0
@@ -2637,6 +2663,12 @@ export interface Pocket {
2637
2663
  * @experimental
2638
2664
  */
2639
2665
  insertText(text: string, options?: { inline?: boolean }): void;
2666
+ /**
2667
+ * Gives text to the person's PiP, their assistant.
2668
+ * @since 0.26.0
2669
+ * @experimental
2670
+ */
2671
+ readonly pip: PipApi;
2640
2672
  /**
2641
2673
  * Hides or reorders a slot's items, the app's own too. A person's own choices in Appearance → Layout win.
2642
2674
  * @since 0.19.0
@@ -0,0 +1,28 @@
1
+ // Whether an activity group in the conversation shows its timeline. Appearance's Keep activity folded keeps every group
2
+ // on its one line until someone opens it, also while it runs or sits in the newest turn; off, the newest turn's groups
3
+ // open as they come. A jump to one of a group's answers opens it as a click does, and a thought alone in its group keeps
4
+ // its own rule (its words follow Show thinking). No DOM here, so `test/activity-fold.test.ts` can check it.
5
+
6
+ /**
7
+ * Whether a group opens, from what it is and what was chosen for it.
8
+ *
9
+ * `chosen` is a click on its line, or a jump to one of its answers (`pocket:reveal`): true opened it, false closed it,
10
+ * undefined leaves it to the rules below. `lone` is the group's only step when that step is a thought, else null.
11
+ * `fold` is Appearance's Keep activity folded.
12
+ */
13
+ export function activityOpen({ chosen, lone, live, newest, reading, fold }) {
14
+ // A thought whose words have not come yet (a session opening) stays folded until they have.
15
+ if (lone?.partial === true) {
16
+ return false;
17
+ }
18
+
19
+ if (chosen !== undefined) {
20
+ return chosen;
21
+ }
22
+
23
+ if (lone) {
24
+ return reading === true && lone.streaming !== true && Boolean(lone.text?.trim());
25
+ }
26
+
27
+ return fold === true ? false : live === true || newest === true;
28
+ }