@aparte/core 1.9.0 → 1.10.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 (102) hide show
  1. package/dist/client/aparte-client.d.ts +48 -11
  2. package/dist/client/aparte-client.d.ts.map +1 -1
  3. package/dist/client/stream-adapter.d.ts +5 -0
  4. package/dist/client/stream-adapter.d.ts.map +1 -1
  5. package/dist/client/wire-history.d.ts +21 -1
  6. package/dist/client/wire-history.d.ts.map +1 -1
  7. package/dist/components/bubble/aparte-chat-bubble.d.ts.map +1 -1
  8. package/dist/components/composer/aparte-composer-action.d.ts +2 -1
  9. package/dist/components/composer/aparte-composer-action.d.ts.map +1 -1
  10. package/dist/components/composer/aparte-composer-add-attachment.d.ts.map +1 -1
  11. package/dist/components/composer/aparte-composer-attachments.d.ts.map +1 -1
  12. package/dist/components/composer/aparte-composer-input.d.ts.map +1 -1
  13. package/dist/components/composer/aparte-composer.d.ts +2 -1
  14. package/dist/components/composer/aparte-composer.d.ts.map +1 -1
  15. package/dist/components/context/aparte-context.d.ts +1 -1
  16. package/dist/components/context/aparte-context.d.ts.map +1 -1
  17. package/dist/components/conversation-list/aparte-conversation-list.d.ts +49 -2
  18. package/dist/components/conversation-list/aparte-conversation-list.d.ts.map +1 -1
  19. package/dist/components/conversation-list/index.d.ts +1 -1
  20. package/dist/components/conversation-list/index.d.ts.map +1 -1
  21. package/dist/components/elicitation/aparte-elicitation.d.ts.map +1 -1
  22. package/dist/components/index.d.ts +1 -1
  23. package/dist/components/index.d.ts.map +1 -1
  24. package/dist/components/launcher/aparte-launcher.d.ts.map +1 -1
  25. package/dist/components/scroll-rail/aparte-scroll-rail.d.ts +1 -1
  26. package/dist/components/scroll-rail/aparte-scroll-rail.d.ts.map +1 -1
  27. package/dist/components/sidebar/aparte-sidebar.d.ts +14 -1
  28. package/dist/components/sidebar/aparte-sidebar.d.ts.map +1 -1
  29. package/dist/components/split/aparte-split.d.ts +1 -1
  30. package/dist/components/split/aparte-split.d.ts.map +1 -1
  31. package/dist/components/suggestions/aparte-suggestions.d.ts +3 -2
  32. package/dist/components/suggestions/aparte-suggestions.d.ts.map +1 -1
  33. package/dist/components/viewport/aparte-chat-viewport.d.ts +3 -0
  34. package/dist/components/viewport/aparte-chat-viewport.d.ts.map +1 -1
  35. package/dist/config/aparte-config.d.ts +24 -3
  36. package/dist/config/aparte-config.d.ts.map +1 -1
  37. package/dist/context/checkpoint-state.d.ts +0 -7
  38. package/dist/context/checkpoint-state.d.ts.map +1 -1
  39. package/dist/context/measure.d.ts +3 -1
  40. package/dist/context/measure.d.ts.map +1 -1
  41. package/dist/conversations/conversation-controller.d.ts +48 -6
  42. package/dist/conversations/conversation-controller.d.ts.map +1 -1
  43. package/dist/custom-elements.json +1474 -592
  44. package/dist/{defer-hydration-Ch3TOEJC.js → defer-hydration-OFqdbk3O.js} +647 -248
  45. package/dist/defer-hydration-OFqdbk3O.js.map +1 -0
  46. package/dist/elicitation/approval-panel.d.ts +1 -1
  47. package/dist/elicitation/approval-panel.d.ts.map +1 -1
  48. package/dist/elicitation/option-keys.d.ts +26 -0
  49. package/dist/elicitation/option-keys.d.ts.map +1 -0
  50. package/dist/elicitation/types.d.ts +16 -0
  51. package/dist/elicitation/types.d.ts.map +1 -1
  52. package/dist/generated/element-attributes.d.ts +2 -2
  53. package/dist/generated/element-attributes.d.ts.map +1 -1
  54. package/dist/{glyphs-LolG04CC.js → glyphs-BgKFtByg.js} +10 -10
  55. package/dist/{glyphs-LolG04CC.js.map → glyphs-BgKFtByg.js.map} +1 -1
  56. package/dist/host/aparte-chat-host.d.ts +42 -1
  57. package/dist/host/aparte-chat-host.d.ts.map +1 -1
  58. package/dist/icons/extended.d.ts +9 -0
  59. package/dist/icons/extended.d.ts.map +1 -1
  60. package/dist/icons.js +20 -11
  61. package/dist/icons.js.map +1 -1
  62. package/dist/index.css +1 -1
  63. package/dist/index.d.ts +8 -2
  64. package/dist/index.d.ts.map +1 -1
  65. package/dist/index.js +271 -190
  66. package/dist/index.js.map +1 -1
  67. package/dist/index.node.d.ts +7 -2
  68. package/dist/index.node.d.ts.map +1 -1
  69. package/dist/index.node.js +61 -58
  70. package/dist/index.node.js.map +1 -1
  71. package/dist/interop/chat-events.d.ts +64 -0
  72. package/dist/interop/chat-events.d.ts.map +1 -0
  73. package/dist/interop/element-props.d.ts +6 -0
  74. package/dist/interop/element-props.d.ts.map +1 -1
  75. package/dist/interop/element-spec.d.ts +85 -0
  76. package/dist/interop/element-spec.d.ts.map +1 -0
  77. package/dist/primitives/progress-spinner/aparte-progress-spinner.d.ts +1 -1
  78. package/dist/primitives/progress-spinner/aparte-progress-spinner.d.ts.map +1 -1
  79. package/dist/primitives/select/aparte-option.d.ts +1 -1
  80. package/dist/primitives/select/aparte-option.d.ts.map +1 -1
  81. package/dist/primitives/select/aparte-select.d.ts.map +1 -1
  82. package/dist/renderers/citations.d.ts.map +1 -1
  83. package/dist/transport/agent-handler.d.ts +8 -4
  84. package/dist/transport/agent-handler.d.ts.map +1 -1
  85. package/dist/types/events.d.ts +11 -10
  86. package/dist/types/events.d.ts.map +1 -1
  87. package/dist/types/imperative-api.d.ts +11 -0
  88. package/dist/types/imperative-api.d.ts.map +1 -1
  89. package/dist/types/index.d.ts +1 -1
  90. package/dist/types/index.d.ts.map +1 -1
  91. package/dist/types/models.d.ts +26 -0
  92. package/dist/types/models.d.ts.map +1 -1
  93. package/dist/types/segments.d.ts +2 -1
  94. package/dist/types/segments.d.ts.map +1 -1
  95. package/dist/types/tools.d.ts +51 -5
  96. package/dist/types/tools.d.ts.map +1 -1
  97. package/dist/utils/segments.d.ts +1 -0
  98. package/dist/utils/segments.d.ts.map +1 -1
  99. package/dist/utils/tool-line.d.ts +9 -8
  100. package/dist/utils/tool-line.d.ts.map +1 -1
  101. package/package.json +2 -2
  102. package/dist/defer-hydration-Ch3TOEJC.js.map +0 -1
@@ -201,6 +201,14 @@
201
201
  "module": "./types/index.js"
202
202
  }
203
203
  },
204
+ {
205
+ "kind": "js",
206
+ "name": "AparteDeferredCall",
207
+ "declaration": {
208
+ "name": "AparteDeferredCall",
209
+ "module": "./types/index.js"
210
+ }
211
+ },
204
212
  {
205
213
  "kind": "js",
206
214
  "name": "AparteComposerCaret",
@@ -1497,6 +1505,14 @@
1497
1505
  "module": "./components/index.js"
1498
1506
  }
1499
1507
  },
1508
+ {
1509
+ "kind": "js",
1510
+ "name": "AparteConversationMetaRenderer",
1511
+ "declaration": {
1512
+ "name": "AparteConversationMetaRenderer",
1513
+ "module": "./components/index.js"
1514
+ }
1515
+ },
1500
1516
  {
1501
1517
  "kind": "js",
1502
1518
  "name": "AparteConversationSelectDetail",
@@ -2481,6 +2497,14 @@
2481
2497
  "module": "./context/measure.js"
2482
2498
  }
2483
2499
  },
2500
+ {
2501
+ "kind": "js",
2502
+ "name": "withoutAbandonedTurns",
2503
+ "declaration": {
2504
+ "name": "withoutAbandonedTurns",
2505
+ "module": "./client/wire-history.js"
2506
+ }
2507
+ },
2484
2508
  {
2485
2509
  "kind": "js",
2486
2510
  "name": "AparteContextMeasure",
@@ -2513,6 +2537,14 @@
2513
2537
  "module": "./client/aparte-client.js"
2514
2538
  }
2515
2539
  },
2540
+ {
2541
+ "kind": "js",
2542
+ "name": "AparteTurnContext",
2543
+ "declaration": {
2544
+ "name": "AparteTurnContext",
2545
+ "module": "./types/tools.js"
2546
+ }
2547
+ },
2516
2548
  {
2517
2549
  "kind": "js",
2518
2550
  "name": "createStreamAdapter",
@@ -2665,6 +2697,78 @@
2665
2697
  "module": "./interop/element-props.js"
2666
2698
  }
2667
2699
  },
2700
+ {
2701
+ "kind": "js",
2702
+ "name": "chatIdOf",
2703
+ "declaration": {
2704
+ "name": "chatIdOf",
2705
+ "module": "./interop/chat-events.js"
2706
+ }
2707
+ },
2708
+ {
2709
+ "kind": "js",
2710
+ "name": "dispatchChatEvent",
2711
+ "declaration": {
2712
+ "name": "dispatchChatEvent",
2713
+ "module": "./interop/chat-events.js"
2714
+ }
2715
+ },
2716
+ {
2717
+ "kind": "js",
2718
+ "name": "AparteChatScoped",
2719
+ "declaration": {
2720
+ "name": "AparteChatScoped",
2721
+ "module": "./interop/chat-events.js"
2722
+ }
2723
+ },
2724
+ {
2725
+ "kind": "js",
2726
+ "name": "AparteElementSpec",
2727
+ "declaration": {
2728
+ "name": "AparteElementSpec",
2729
+ "module": "./interop/element-spec.js"
2730
+ }
2731
+ },
2732
+ {
2733
+ "kind": "js",
2734
+ "name": "AparteElementSpecEvent",
2735
+ "declaration": {
2736
+ "name": "AparteElementSpecEvent",
2737
+ "module": "./interop/element-spec.js"
2738
+ }
2739
+ },
2740
+ {
2741
+ "kind": "js",
2742
+ "name": "AparteElementSpecEvents",
2743
+ "declaration": {
2744
+ "name": "AparteElementSpecEvents",
2745
+ "module": "./interop/element-spec.js"
2746
+ }
2747
+ },
2748
+ {
2749
+ "kind": "js",
2750
+ "name": "AparteSpecAttributes",
2751
+ "declaration": {
2752
+ "name": "AparteSpecAttributes",
2753
+ "module": "./interop/element-spec.js"
2754
+ }
2755
+ },
2756
+ {
2757
+ "kind": "js",
2758
+ "name": "AparteSpecProperties",
2759
+ "declaration": {
2760
+ "name": "AparteSpecProperties",
2761
+ "module": "./interop/element-spec.js"
2762
+ }
2763
+ },
2764
+ {
2765
+ "kind": "js",
2766
+ "name": "AparteSpecEvents",
2767
+ "declaration": {
2768
+ "name": "AparteSpecEvents",
2769
+ "module": "./interop/element-spec.js"
2770
+ }
2771
+ },
2668
2772
  {
2669
2773
  "kind": "js",
2670
2774
  "name": "AparteUiEventName",
@@ -3299,6 +3403,14 @@
3299
3403
  "module": "./types/index.js"
3300
3404
  }
3301
3405
  },
3406
+ {
3407
+ "kind": "js",
3408
+ "name": "AparteDeferredCall",
3409
+ "declaration": {
3410
+ "name": "AparteDeferredCall",
3411
+ "module": "./types/index.js"
3412
+ }
3413
+ },
3302
3414
  {
3303
3415
  "kind": "js",
3304
3416
  "name": "AparteComposerCaret",
@@ -4707,6 +4819,14 @@
4707
4819
  "module": "./components/index.js"
4708
4820
  }
4709
4821
  },
4822
+ {
4823
+ "kind": "js",
4824
+ "name": "AparteConversationMetaRenderer",
4825
+ "declaration": {
4826
+ "name": "AparteConversationMetaRenderer",
4827
+ "module": "./components/index.js"
4828
+ }
4829
+ },
4710
4830
  {
4711
4831
  "kind": "js",
4712
4832
  "name": "AparteConversationSelectDetail",
@@ -5395,6 +5515,14 @@
5395
5515
  "module": "./context/measure.js"
5396
5516
  }
5397
5517
  },
5518
+ {
5519
+ "kind": "js",
5520
+ "name": "withoutAbandonedTurns",
5521
+ "declaration": {
5522
+ "name": "withoutAbandonedTurns",
5523
+ "module": "./client/wire-history.js"
5524
+ }
5525
+ },
5398
5526
  {
5399
5527
  "kind": "js",
5400
5528
  "name": "AparteContextMeasure",
@@ -5435,6 +5563,78 @@
5435
5563
  "module": "./interop/element-props.js"
5436
5564
  }
5437
5565
  },
5566
+ {
5567
+ "kind": "js",
5568
+ "name": "chatIdOf",
5569
+ "declaration": {
5570
+ "name": "chatIdOf",
5571
+ "module": "./interop/chat-events.js"
5572
+ }
5573
+ },
5574
+ {
5575
+ "kind": "js",
5576
+ "name": "dispatchChatEvent",
5577
+ "declaration": {
5578
+ "name": "dispatchChatEvent",
5579
+ "module": "./interop/chat-events.js"
5580
+ }
5581
+ },
5582
+ {
5583
+ "kind": "js",
5584
+ "name": "AparteChatScoped",
5585
+ "declaration": {
5586
+ "name": "AparteChatScoped",
5587
+ "module": "./interop/chat-events.js"
5588
+ }
5589
+ },
5590
+ {
5591
+ "kind": "js",
5592
+ "name": "AparteElementSpec",
5593
+ "declaration": {
5594
+ "name": "AparteElementSpec",
5595
+ "module": "./interop/element-spec.js"
5596
+ }
5597
+ },
5598
+ {
5599
+ "kind": "js",
5600
+ "name": "AparteElementSpecEvent",
5601
+ "declaration": {
5602
+ "name": "AparteElementSpecEvent",
5603
+ "module": "./interop/element-spec.js"
5604
+ }
5605
+ },
5606
+ {
5607
+ "kind": "js",
5608
+ "name": "AparteElementSpecEvents",
5609
+ "declaration": {
5610
+ "name": "AparteElementSpecEvents",
5611
+ "module": "./interop/element-spec.js"
5612
+ }
5613
+ },
5614
+ {
5615
+ "kind": "js",
5616
+ "name": "AparteSpecAttributes",
5617
+ "declaration": {
5618
+ "name": "AparteSpecAttributes",
5619
+ "module": "./interop/element-spec.js"
5620
+ }
5621
+ },
5622
+ {
5623
+ "kind": "js",
5624
+ "name": "AparteSpecProperties",
5625
+ "declaration": {
5626
+ "name": "AparteSpecProperties",
5627
+ "module": "./interop/element-spec.js"
5628
+ }
5629
+ },
5630
+ {
5631
+ "kind": "js",
5632
+ "name": "AparteSpecEvents",
5633
+ "declaration": {
5634
+ "name": "AparteSpecEvents",
5635
+ "module": "./interop/element-spec.js"
5636
+ }
5637
+ },
5438
5638
  {
5439
5639
  "kind": "js",
5440
5640
  "name": "filesToAttachments",
@@ -5667,6 +5867,14 @@
5667
5867
  "module": "./client/aparte-client.js"
5668
5868
  }
5669
5869
  },
5870
+ {
5871
+ "kind": "js",
5872
+ "name": "AparteTurnContext",
5873
+ "declaration": {
5874
+ "name": "AparteTurnContext",
5875
+ "module": "./types/tools.js"
5876
+ }
5877
+ },
5670
5878
  {
5671
5879
  "kind": "js",
5672
5880
  "name": "createStreamAdapter",
@@ -6358,6 +6566,31 @@
6358
6566
  },
6359
6567
  "description": "Abort the current streaming response and all active tool calls.\nDispatches `aparte-message-aborted` on the target element."
6360
6568
  },
6569
+ {
6570
+ "kind": "method",
6571
+ "name": "_approvalPreviewOf",
6572
+ "privacy": "private",
6573
+ "return": {
6574
+ "type": {
6575
+ "text": "HTMLElement | string | undefined"
6576
+ }
6577
+ },
6578
+ "parameters": [
6579
+ {
6580
+ "name": "call",
6581
+ "type": {
6582
+ "text": "AparteToolCall"
6583
+ }
6584
+ },
6585
+ {
6586
+ "name": "target",
6587
+ "type": {
6588
+ "text": "HTMLElement"
6589
+ }
6590
+ }
6591
+ ],
6592
+ "description": "What the call would do, as the tool's display draws it for the approval panel\n(`AparteToolDisplay.approvalPreview`), read from the chat's config, the one the row\nrenders with. `undefined` when the display has none, answers `null`, or throws: the\nquestion then shows the arguments alone."
6593
+ },
6361
6594
  {
6362
6595
  "kind": "method",
6363
6596
  "name": "_askForApproval",
@@ -6385,6 +6618,12 @@
6385
6618
  "type": {
6386
6619
  "text": "HTMLElement"
6387
6620
  }
6621
+ },
6622
+ {
6623
+ "name": "turn",
6624
+ "type": {
6625
+ "text": "AparteTurnContext"
6626
+ }
6388
6627
  }
6389
6628
  ],
6390
6629
  "description": "Ask the human at the COMPOSER, and report what they decided.\n\nThe default channel. Routing through `requestUserInput` puts the decision\nwhere every other request for the user already goes, which is the whole point:\none queue, one panel slot, one teardown, and the same behaviour whether the\nrequest came from a tool handler or from this gate.\n\nThe tool NAME is the question and its ARGUMENTS are the body, because the\narguments are what is being approved — a decision surface that names the act and\nhides its subject asks for a signature on a blank page. The transcript row stays the\nanchor, but it is not the only place the call can be read. The panel is capped\nat 50vh and the block inside it scrolls, so a long input cannot push the options\noff the surface they are asked on.\n\nThere is no `aparte-tool-decision` event and no `document` listener that answers\none: a decision is answered by a typed presenter registered per config instance,\nnever by a window event. A host\nthat wants to answer programmatically registers an `approvalResolver` (headless,\nno DOM) or its own presenter, both strictly more capable than an id on an event."
@@ -6486,7 +6725,7 @@
6486
6725
  "name": "opts",
6487
6726
  "optional": true,
6488
6727
  "type": {
6489
- "text": "{\n temperature?: number;\n /** Resume a turn a server loop paused (a reload): skip the first run. */\n resume?: NonNullable<AparteRunResult['suspended']>;\n /**\n * Builds the messages of this request again, exactly as the caller built them the\n * first time (a send inlines its files as parts again). Called once the history\n * has become smaller — after a compactor wrote a checkpoint, before the request\n * goes out or after the model refused it as too long. Without it the turn cannot\n * be resent, so it neither waits for a compactor nor retries an overflow.\n */\n rebuild?: () => Promise<AparteChatMessage[]>;\n /** The files picked for this message, for a runner that uploads them itself. */\n files?: readonly File[];\n /** What goes in the request's `_meta` from the message that started this turn. */\n meta?: AparteRequestMeta;\n /**\n * The conversation open in the chat when the person acted, read by the caller\n * before its first await. Handed to the runner on every run of the turn, the\n * resume of a pause included.\n */\n conversationId?: string;\n }"
6728
+ "text": "{\n temperature?: number;\n /** Resume a turn a server loop paused (a reload): skip the first run. */\n resume?: NonNullable<AparteRunResult['suspended']>;\n /**\n * Builds the messages of this request again, exactly as the caller built them the\n * first time (a send inlines its files as parts again). Called once the history\n * has become smaller — after a compactor wrote a checkpoint, before the request\n * goes out or after the model refused it as too long. Without it the turn cannot\n * be resent, so it neither waits for a compactor nor retries an overflow.\n */\n rebuild?: () => Promise<AparteChatMessage[]>;\n /** The files picked for this message, for a runner that uploads them itself. */\n files?: readonly File[];\n /** What goes in the request's `_meta` from the message that started this turn. */\n meta?: AparteRequestMeta;\n /**\n * The conversation open in the chat when the person acted, read by the caller\n * before its first await. Handed to the runner on every run of the turn, the\n * resume of a pause included.\n */\n conversationId?: string;\n /**\n * The person's message this turn answers, as it was sent — for a runner whose agent\n * keeps its own memory (see `StreamRunOptions.userMessage`). Every run of the turn.\n */\n userMessage?: AparteStreamRunOptions['userMessage'];\n /** The sub-agents a resumed pause already named, by `agentId`: its run announces them no more. */\n agentNames?: ReadonlyMap<string, string>;\n }"
6490
6729
  }
6491
6730
  }
6492
6731
  ],
@@ -6861,6 +7100,32 @@
6861
7100
  ],
6862
7101
  "description": "Build the initial messages array, prepending system prompts and conversation history."
6863
7102
  },
7103
+ {
7104
+ "kind": "method",
7105
+ "name": "_userContent",
7106
+ "privacy": "private",
7107
+ "return": {
7108
+ "type": {
7109
+ "text": "AparteChatMessage['content']"
7110
+ }
7111
+ },
7112
+ "parameters": [
7113
+ {
7114
+ "name": "text",
7115
+ "type": {
7116
+ "text": "string"
7117
+ }
7118
+ },
7119
+ {
7120
+ "name": "parts",
7121
+ "optional": true,
7122
+ "type": {
7123
+ "text": "AparteContentPart[]"
7124
+ }
7125
+ }
7126
+ ],
7127
+ "description": "The message being sent, as the request carries it: the text, then the files inlined as parts."
7128
+ },
6864
7129
  {
6865
7130
  "kind": "method",
6866
7131
  "name": "_toHistoryMessages",
@@ -6984,6 +7249,13 @@
6984
7249
  "type": {
6985
7250
  "text": "string"
6986
7251
  }
7252
+ },
7253
+ {
7254
+ "name": "userMessage",
7255
+ "optional": true,
7256
+ "type": {
7257
+ "text": "AparteStreamRunOptions['userMessage']"
7258
+ }
6987
7259
  }
6988
7260
  ],
6989
7261
  "description": "One run of the loop: its usage, and whether it paused (a server loop)."
@@ -7060,6 +7332,13 @@
7060
7332
  "type": {
7061
7333
  "text": "string"
7062
7334
  }
7335
+ },
7336
+ {
7337
+ "name": "userMessage",
7338
+ "optional": true,
7339
+ "type": {
7340
+ "text": "AparteStreamRunOptions['userMessage']"
7341
+ }
7063
7342
  }
7064
7343
  ],
7065
7344
  "description": "Run the loop through a AparteStreamRunner — the engine's by default —\nrendering its DOM-free events through createStreamAdapter. Builds the\nrunner's dependencies from this client's config / provider / transport. The\nleading writes (status streaming, prefix segments) happen here; the runner's\n`run-start` re-asserts `streaming` idempotently. The call sequence this\nproduces is pinned by the `stream-parity` suite's snapshots, recorded while\nthe inline loop it replaced still ran beside it."
@@ -7080,6 +7359,12 @@
7080
7359
  "text": "AparteChatTargetElement"
7081
7360
  }
7082
7361
  },
7362
+ {
7363
+ "name": "turn",
7364
+ "type": {
7365
+ "text": "AparteTurnContext"
7366
+ }
7367
+ },
7083
7368
  {
7084
7369
  "name": "gatedElsewhere",
7085
7370
  "default": "false"
@@ -7104,9 +7389,9 @@
7104
7389
  }
7105
7390
  },
7106
7391
  {
7107
- "name": "messageId",
7392
+ "name": "turn",
7108
7393
  "type": {
7109
- "text": "string"
7394
+ "text": "AparteTurnContext"
7110
7395
  }
7111
7396
  },
7112
7397
  {
@@ -7173,6 +7458,12 @@
7173
7458
  "text": "AparteChatTargetElement"
7174
7459
  }
7175
7460
  },
7461
+ {
7462
+ "name": "turn",
7463
+ "type": {
7464
+ "text": "AparteTurnContext"
7465
+ }
7466
+ },
7176
7467
  {
7177
7468
  "name": "rowEvents",
7178
7469
  "optional": true,
@@ -7208,6 +7499,68 @@
7208
7499
  ],
7209
7500
  "description": "The ticket is spent the moment the resume leaves: the server answers these calls\nnow, so a pause saved from here on — the conversation manager saves before it cuts a\nswitch — would be resumed a second time, against a server that has moved on. The\nhistory that resumes them is built first; a new pause marks what still waits."
7210
7501
  },
7502
+ {
7503
+ "kind": "method",
7504
+ "name": "_messageOf",
7505
+ "privacy": "private",
7506
+ "return": {
7507
+ "type": {
7508
+ "text": "AparteMessage | undefined"
7509
+ }
7510
+ },
7511
+ "parameters": [
7512
+ {
7513
+ "name": "targetElement",
7514
+ "type": {
7515
+ "text": "AparteChatTargetElement"
7516
+ }
7517
+ },
7518
+ {
7519
+ "name": "messageId",
7520
+ "type": {
7521
+ "text": "string"
7522
+ }
7523
+ }
7524
+ ],
7525
+ "description": "A reply by its id, tree-wide first: a retry during the wait moves the path."
7526
+ },
7527
+ {
7528
+ "kind": "method",
7529
+ "name": "_keepSubAgentCalls",
7530
+ "privacy": "private",
7531
+ "return": {
7532
+ "type": {
7533
+ "text": "void"
7534
+ }
7535
+ },
7536
+ "parameters": [
7537
+ {
7538
+ "name": "targetElement",
7539
+ "type": {
7540
+ "text": "AparteChatTargetElement"
7541
+ }
7542
+ },
7543
+ {
7544
+ "name": "messageId",
7545
+ "type": {
7546
+ "text": "string"
7547
+ }
7548
+ },
7549
+ {
7550
+ "name": "pending",
7551
+ "type": {
7552
+ "text": "readonly StreamDeferredCall[]"
7553
+ }
7554
+ },
7555
+ {
7556
+ "name": "ticket",
7557
+ "type": {
7558
+ "text": "unknown"
7559
+ }
7560
+ }
7561
+ ],
7562
+ "description": "Keep on the reply the calls a paused run left that no row of the reply holds: a\nsub-agent's, which its line draws. The rows of the reply carry their own pause\n(`deferred`); these would otherwise be in nothing the conversation saves, and a reload\nwould find no pause to resume. Each keeps the name its sub-agent was announced with,\nwhich a reload has no other way to know."
7563
+ },
7211
7564
  {
7212
7565
  "kind": "method",
7213
7566
  "name": "_closeOpenCalls",
@@ -7754,6 +8107,24 @@
7754
8107
  ],
7755
8108
  "description": "A message's text as the MODEL should read it — the one mapper both history\npaths use, so the compaction preamble cannot be applied on retry and edit and\nforgotten on the ordinary send, which is what the first review of this feature\ncaught: the summary went out on every normal turn as something the user said."
7756
8109
  },
8110
+ {
8111
+ "kind": "function",
8112
+ "name": "withoutAbandonedTurns",
8113
+ "return": {
8114
+ "type": {
8115
+ "text": "AparteMessage[]"
8116
+ }
8117
+ },
8118
+ "parameters": [
8119
+ {
8120
+ "name": "messages",
8121
+ "type": {
8122
+ "text": "readonly AparteMessage[]"
8123
+ }
8124
+ }
8125
+ ],
8126
+ "description": "The messages, without the turns a later request gives up on: each reply that failed for\ngood and the messages that asked it — every user message since the last reply that did\nnot fail, since a failure the request got past sends its message again with the next one.\n\nA compaction summary message is part of no turn and always stays.\n\nEvery other message stays, a failure the request can get past included: its message goes\nwith the next one (`mergeAdjacentUserMessages` joins the two), from the very next request\non, as a retry or an edit sends it, and its reply is sent as nothing (`wireMessages`).\n\nThe one rule for send, retry, edit, a resume, the context gauge and a compaction, so the\nhistory a server is sent never changes under it from one request to the next."
8127
+ },
7757
8128
  {
7758
8129
  "kind": "function",
7759
8130
  "name": "wireMessages",
@@ -7770,7 +8141,7 @@
7770
8141
  }
7771
8142
  }
7772
8143
  ],
7773
- "description": "The one rule for what a list of messages contributes to the wire.\n\nNot the slice — the contribution: a role the wire has (`user`/`assistant`), a\nturn that neither failed nor is still in flight, and text that is not empty. A reply\nthat called tools goes out as the calls and their answers, in the order it showed\nthem (`wireTurns`); every other message keeps its one text, compaction preamble\nincluded.\n\n`messageWireText` (not `m.content`): assistant replies stream their text into\n`segments`, leaving `content` as '', so without flattening every reply would be\nempty here and the drop below would swallow the whole transcript.\n\nPure, so the client that SENDS this history and the measure that ESTIMATES it\n(`estimateWireTokens`) read the same serialisation and cannot drift."
8144
+ "description": "The one rule for what a list of messages contributes to the wire.\n\nNot the slice — the contribution: a role the wire has (`user`/`assistant`), a\nturn that neither failed nor is still in flight, and text that is not empty. A user\nmessage whose reply failed for good is left out as well (`withoutAbandonedTurns`). A reply\nthat called tools goes out as the calls and their answers, in the order it showed\nthem (`wireTurns`); every other message keeps its one text, compaction preamble\nincluded.\n\n`messageWireText` (not `m.content`): assistant replies stream their text into\n`segments`, leaving `content` as '', so without flattening every reply would be\nempty here and the drop below would swallow the whole transcript.\n\nPure, so the client that SENDS this history and the measure that ESTIMATES it\n(`estimateWireTokens`) read the same serialisation and cannot drift."
7774
8145
  }
7775
8146
  ],
7776
8147
  "exports": [
@@ -7854,6 +8225,14 @@
7854
8225
  "module": "src/client/wire-history.ts"
7855
8226
  }
7856
8227
  },
8228
+ {
8229
+ "kind": "js",
8230
+ "name": "withoutAbandonedTurns",
8231
+ "declaration": {
8232
+ "name": "withoutAbandonedTurns",
8233
+ "module": "src/client/wire-history.ts"
8234
+ }
8235
+ },
7857
8236
  {
7858
8237
  "kind": "js",
7859
8238
  "name": "wireMessages",
@@ -8053,6 +8432,14 @@
8053
8432
  "module": "./conversation-list/index.js"
8054
8433
  }
8055
8434
  },
8435
+ {
8436
+ "kind": "js",
8437
+ "name": "AparteConversationMetaRenderer",
8438
+ "declaration": {
8439
+ "name": "AparteConversationMetaRenderer",
8440
+ "module": "./conversation-list/index.js"
8441
+ }
8442
+ },
8056
8443
  {
8057
8444
  "kind": "js",
8058
8445
  "name": "AparteConversationSelectDetail",
@@ -8723,6 +9110,16 @@
8723
9110
  "default": "null",
8724
9111
  "description": "What a plugin says about a call, read after the app's display — see setToolLineProvider."
8725
9112
  },
9113
+ {
9114
+ "kind": "field",
9115
+ "name": "_extraToolLineProviders",
9116
+ "type": {
9117
+ "text": "Array<(segment: AparteToolCallSegment) => AparteToolLine | undefined>"
9118
+ },
9119
+ "privacy": "private",
9120
+ "default": "[]",
9121
+ "description": "Providers added with `registerToolLineProvider`, asked in the order they were added."
9122
+ },
8726
9123
  {
8727
9124
  "kind": "field",
8728
9125
  "name": "_stepLabels",
@@ -9958,9 +10355,16 @@
9958
10355
  "type": {
9959
10356
  "text": "AparteToolCall"
9960
10357
  }
10358
+ },
10359
+ {
10360
+ "name": "turn",
10361
+ "optional": true,
10362
+ "type": {
10363
+ "text": "AparteTurnContext"
10364
+ }
9961
10365
  }
9962
10366
  ],
9963
- "description": "What the policy says about one call, with the tool's own `needsApproval` as the\nanswer when it has no opinion. The one place the two are combined, so the client's\ngate predicate and its approval channel cannot disagree."
10367
+ "description": "What the policy says about one call, with the tool's own `needsApproval` as the\nanswer when it has no opinion. The one place the two are combined, so the client's\ngate predicate and its approval channel cannot disagree. `turn` is handed to the\npolicy as its third argument; the client passes the turn the call belongs to."
9964
10368
  },
9965
10369
  {
9966
10370
  "kind": "method",
@@ -10619,6 +11023,37 @@
10619
11023
  "aparteGlobalConfig.setToolLineProvider((segment) =>\n segment.toolCall.name === 'delegate' ? { activity: 'Reading the parser', note: '3 tools' } : undefined);"
10620
11024
  ]
10621
11025
  },
11026
+ {
11027
+ "kind": "method",
11028
+ "name": "registerToolLineProvider",
11029
+ "return": {
11030
+ "type": {
11031
+ "text": "() => void"
11032
+ }
11033
+ },
11034
+ "parameters": [
11035
+ {
11036
+ "name": "provider",
11037
+ "type": {
11038
+ "text": "(segment: AparteToolCallSegment) => AparteToolLine | undefined"
11039
+ }
11040
+ }
11041
+ ],
11042
+ "description": "Add a tool-line provider beside the one AparteConfig.setToolLineProvider| setToolLineProvider()\nholds, and return the function that removes it. The providers are asked in order — the\napp's `setToolLineProvider` first, then these in the order they were added — and the\nfirst one that answers a call wins, so a plugin registering its own never replaces the\napp's, nor another plugin's. Each call is a provider of its own, even with the same function.",
11043
+ "examples": [
11044
+ "const release = aparteGlobalConfig.registerToolLineProvider((segment) =>\n segment.toolCall.name === 'delegate' ? { activity: 'Reading the parser' } : undefined);\nrelease();"
11045
+ ]
11046
+ },
11047
+ {
11048
+ "kind": "method",
11049
+ "name": "getToolLineProviders",
11050
+ "return": {
11051
+ "type": {
11052
+ "text": "Array<(segment: AparteToolCallSegment) => AparteToolLine | undefined>"
11053
+ }
11054
+ },
11055
+ "description": "Every tool-line provider this config reads, in the order they are asked: its own\n(`setToolLineProvider`, then the registered ones), else the page's."
11056
+ },
10622
11057
  {
10623
11058
  "kind": "method",
10624
11059
  "name": "getToolLineProvider",
@@ -10627,7 +11062,7 @@
10627
11062
  "text": "((segment: AparteToolCallSegment) => AparteToolLine | undefined) | null"
10628
11063
  }
10629
11064
  },
10630
- "description": "The tool-line provider this config reads: its own, else the page's."
11065
+ "description": "The tool-line provider `setToolLineProvider` set: this config's own, else the page's."
10631
11066
  },
10632
11067
  {
10633
11068
  "kind": "method",
@@ -12824,24 +13259,6 @@
12824
13259
  "kind": "javascript-module",
12825
13260
  "path": "src/context/checkpoint-state.ts",
12826
13261
  "declarations": [
12827
- {
12828
- "kind": "function",
12829
- "name": "chatIdOf",
12830
- "return": {
12831
- "type": {
12832
- "text": "string | undefined"
12833
- }
12834
- },
12835
- "parameters": [
12836
- {
12837
- "name": "el",
12838
- "type": {
12839
- "text": "Element"
12840
- }
12841
- }
12842
- ],
12843
- "description": "The id of the chat `el` belongs to: the nearest `<aparte-chat>` or `[data-aparte-chat]`\nabove it that HAS one, `undefined` for an unnamed chat. The same climb the bubble, the\ncomposer and the gauge make for their own events, so an event naming a chat and an element\nanswering for it agree about which is which."
12844
- },
12845
13262
  {
12846
13263
  "kind": "class",
12847
13264
  "description": "Says on the bubble what a compaction is doing to the message it will sit on.\n\nA checkpoint is written onto the first message the model keeps verbatim, and the\ncompaction names that message the moment it starts (`aparte-compact-start.messageId`).\nFrom then on, until the summary arrives or fails, that bubble carries\n`data-checkpoint=\"pending\"` and the separator above it says the context is being\nsummarised; on a failure it carries `data-checkpoint=\"failed\"` (and\n`data-checkpoint-reason`) and the separator offers Retry. The bubble draws it — this only\nsets the two attributes, so the vanilla viewport and the framework host, which have\ndifferent bubbles to find and different lifetimes, share one rule for WHEN.\n\nWhat clears it, and what must not:\n- a `-done` for that very message, unless it was skipped (a skipped run did not write\n what the pending line announced, so the line stays until something answers it);\n- the next `-start`, which names a message of its own;\n- a conversation switch (`clear()`), because the bubble is not that chat's any more.\nA `-done` or `-error` for another message, or for another chat on the page, changes\nnothing: two chats compact at the same time, and one of them finishing must not wipe the\nline of the other. A chat with no id is addressed by events with no id, as everywhere, and\nan event is acted on only when its message is in this chat's transcript (`owns`).\n\nThe state is remembered here as well as written to the bubble, because under a framework\nthe bubble can be created after the event (`reapply()` writes it again on every sync).",
@@ -12978,14 +13395,6 @@
12978
13395
  }
12979
13396
  ],
12980
13397
  "exports": [
12981
- {
12982
- "kind": "js",
12983
- "name": "chatIdOf",
12984
- "declaration": {
12985
- "name": "chatIdOf",
12986
- "module": "src/context/checkpoint-state.ts"
12987
- }
12988
- },
12989
13398
  {
12990
13399
  "kind": "js",
12991
13400
  "name": "CheckpointStateWatcher",
@@ -13122,7 +13531,7 @@
13122
13531
  }
13123
13532
  }
13124
13533
  ],
13125
- "description": "The estimate of what the wire sends for these messages: the same serialisation the\nclient builds its history with (`wireMessages`) — a reply's thinking is not sent, its\ntext is, and a tool call and its result count as the envelope and the `tool` message\nthe wire carries. A failed turn and one still in flight send nothing.\n\nNot `estimateTokens(message.content)`: assistant replies keep their text in\n`segments` with `content` empty, so that sum would read a whole conversation as free."
13534
+ "description": "The estimate of what the wire sends for these messages: the same serialisation the\nclient builds its history with (`wireMessages`) — a reply's thinking is not sent, its\ntext is, and a tool call and its result count as the envelope and the `tool` message\nthe wire carries. A failed reply and one still in flight send nothing, and neither does a\nmessage whose reply failed for good (`withoutAbandonedTurns`); one whose reply failed on\nthe network is counted, since it goes with the next message.\n\nNot `estimateTokens(message.content)`: assistant replies keep their text in\n`segments` with `content` empty, so that sum would read a whole conversation as free."
13126
13535
  },
13127
13536
  {
13128
13537
  "kind": "function",
@@ -13394,6 +13803,16 @@
13394
13803
  "privacy": "private",
13395
13804
  "default": "null"
13396
13805
  },
13806
+ {
13807
+ "kind": "field",
13808
+ "name": "_pendingId",
13809
+ "type": {
13810
+ "text": "string | null"
13811
+ },
13812
+ "privacy": "private",
13813
+ "default": "null",
13814
+ "description": "The conversation this chat's first message is creating, from the moment `createNew()`\nis called until it resolves — see pendingId."
13815
+ },
13397
13816
  {
13398
13817
  "kind": "field",
13399
13818
  "name": "_turn",
@@ -13559,6 +13978,15 @@
13559
13978
  "description": "The current active conversation id (null when none selected).",
13560
13979
  "readonly": true
13561
13980
  },
13981
+ {
13982
+ "kind": "field",
13983
+ "name": "pendingId",
13984
+ "type": {
13985
+ "text": "string | null"
13986
+ },
13987
+ "description": "The conversation this chat's first message is creating, while it is being created:\nset when the send calls `createNew()`, `null` again once activeId holds it.\n\nIt is this chat's own, whatever the manager says. The manager has ONE `activeId`,\nwhich every chat on it writes when it opens or creates a conversation; with two chats\nit names the one that moved last. A wrapper that is handed this id back — through\n`onConversationCreated`, or bound to the manager's `activeId`, which changes before\nthe creation resolves — knows from it that the chat already shows that conversation.",
13988
+ "readonly": true
13989
+ },
13562
13990
  {
13563
13991
  "kind": "method",
13564
13992
  "name": "_openId",
@@ -13568,7 +13996,7 @@
13568
13996
  "text": "string | null"
13569
13997
  }
13570
13998
  },
13571
- "description": "The conversation a message sent now belongs to: the open one, or — for the first\nmessage of a chat — the one that send is creating. `createNew()` makes it the\nmanager's active conversation synchronously, so the client, which hears the send\nright after this controller does, already finds it there; this controller's own id\nfollows once the conversation is saved. `_ensureConversationAndPersist` reads the\nsame two places to decide where the message is saved, so a turn is carried to the\nconversation its message was written in."
13999
+ "description": "The conversation a message sent now belongs to: the open one, or — for the first\nmessage of a chat — the one that send is creating. The client hears the send right\nafter this controller does, so the creation has already started and its id is known\n(pendingId); this controller's own id follows once the conversation is saved.\n`_ensureConversationAndPersist` reads the same two places to decide where the message\nis saved, so a turn is carried to the conversation its message was written in. Never\nthe manager's `activeId`: that may be another chat's conversation."
13572
14000
  },
13573
14001
  {
13574
14002
  "kind": "method",
@@ -13581,6 +14009,36 @@
13581
14009
  },
13582
14010
  "description": "Lazily resolve the conversation manager. Returns `undefined` if none is\nregistered — the controller then runs in degraded mode: optimistic UI\nstill works (user message is appended) but no persistence happens. This\nkeeps backward compatibility with hosts that haven't opted into the\nconversation lifecycle yet."
13583
14011
  },
14012
+ {
14013
+ "kind": "field",
14014
+ "name": "_keptManager",
14015
+ "type": {
14016
+ "text": "AparteConversationManager | null"
14017
+ },
14018
+ "privacy": "private",
14019
+ "default": "null",
14020
+ "description": "The manager a config change could not take the open conversation away from: the new\nconfig's manager does not hold it, or the new config has none. The chat keeps saving\nthat conversation where it lives until it opens another — see followConfig."
14021
+ },
14022
+ {
14023
+ "kind": "field",
14024
+ "name": "_stopConfigWait",
14025
+ "type": {
14026
+ "text": "(() => void) | null"
14027
+ },
14028
+ "privacy": "private",
14029
+ "default": "null",
14030
+ "description": "Release handle for a wait on a new manager still loading its list (see followConfig)."
14031
+ },
14032
+ {
14033
+ "kind": "method",
14034
+ "name": "followConfig",
14035
+ "return": {
14036
+ "type": {
14037
+ "text": "void"
14038
+ }
14039
+ },
14040
+ "description": "The chat was given another config (`AparteChatHost.setConfig`), and its conversation\nmanager may be another one. Nothing on screen is lost either way:\n- the new manager holds the open conversation: it is opened again from there, and saved there;\n- it does not, or the new config has no manager: the chat keeps the manager it had for\n the conversation it shows, and goes on saving it there; the next conversation it\n opens comes from the new config.\nA manager still loading its list is waited for before it is asked."
14041
+ },
13584
14042
  {
13585
14043
  "kind": "field",
13586
14044
  "name": "_warnedNoManager",
@@ -13885,6 +14343,25 @@
13885
14343
  }
13886
14344
  }
13887
14345
  },
14346
+ {
14347
+ "kind": "method",
14348
+ "name": "_adoptable",
14349
+ "privacy": "private",
14350
+ "return": {
14351
+ "type": {
14352
+ "text": "string | null"
14353
+ }
14354
+ },
14355
+ "parameters": [
14356
+ {
14357
+ "name": "manager",
14358
+ "type": {
14359
+ "text": "AparteConversationManager"
14360
+ }
14361
+ }
14362
+ ],
14363
+ "description": "The conversation the manager names as active, for a chat that has none: only when this\ncontroller is the one chat on that manager (an app that called `manager.createNew()`\nitself and never gave the id to the chat), and only an empty conversation, whose\nmessages are in memory — a save from this chat must not write over messages it never\nshowed. With several chats the manager's `activeId` names whichever moved last."
14364
+ },
13888
14365
  {
13889
14366
  "kind": "method",
13890
14367
  "name": "_ensureConversationAndPersist",
@@ -14968,6 +15445,13 @@
14968
15445
  {
14969
15446
  "name": "allowOther",
14970
15447
  "default": "true"
15448
+ },
15449
+ {
15450
+ "name": "preview",
15451
+ "optional": true,
15452
+ "type": {
15453
+ "text": "HTMLElement | string"
15454
+ }
14971
15455
  }
14972
15456
  ]
14973
15457
  }
@@ -15145,6 +15629,66 @@
15145
15629
  }
15146
15630
  ]
15147
15631
  },
15632
+ {
15633
+ "kind": "javascript-module",
15634
+ "path": "src/elicitation/option-keys.ts",
15635
+ "declarations": [
15636
+ {
15637
+ "kind": "function",
15638
+ "name": "numberOptions",
15639
+ "return": {
15640
+ "type": {
15641
+ "text": "void"
15642
+ }
15643
+ },
15644
+ "parameters": [
15645
+ {
15646
+ "name": "panel",
15647
+ "type": {
15648
+ "text": "HTMLElement"
15649
+ }
15650
+ }
15651
+ ],
15652
+ "description": "Number the options (at most nine) and say so to assistive technology. Call after the panel is built."
15653
+ },
15654
+ {
15655
+ "kind": "function",
15656
+ "name": "bindOptionKeys",
15657
+ "return": {
15658
+ "type": {
15659
+ "text": "() => void"
15660
+ }
15661
+ },
15662
+ "parameters": [
15663
+ {
15664
+ "name": "panel",
15665
+ "type": {
15666
+ "text": "HTMLElement"
15667
+ }
15668
+ }
15669
+ ],
15670
+ "description": "Listen on `panel` for the keys above. Returns the function that stops listening (the panel\nis removed on close, so a caller may ignore it)."
15671
+ }
15672
+ ],
15673
+ "exports": [
15674
+ {
15675
+ "kind": "js",
15676
+ "name": "numberOptions",
15677
+ "declaration": {
15678
+ "name": "numberOptions",
15679
+ "module": "src/elicitation/option-keys.ts"
15680
+ }
15681
+ },
15682
+ {
15683
+ "kind": "js",
15684
+ "name": "bindOptionKeys",
15685
+ "declaration": {
15686
+ "name": "bindOptionKeys",
15687
+ "module": "src/elicitation/option-keys.ts"
15688
+ }
15689
+ }
15690
+ ]
15691
+ },
15148
15692
  {
15149
15693
  "kind": "javascript-module",
15150
15694
  "path": "src/elicitation/panel.ts",
@@ -15453,6 +15997,16 @@
15453
15997
  "privacy": "private",
15454
15998
  "default": "false"
15455
15999
  },
16000
+ {
16001
+ "kind": "field",
16002
+ "name": "_nextConfig",
16003
+ "type": {
16004
+ "text": "{ config: AparteConfig | undefined } | null"
16005
+ },
16006
+ "privacy": "private",
16007
+ "default": "null",
16008
+ "description": "A config given while a turn was in flight, applied when it ends — see setConfig."
16009
+ },
15456
16010
  {
15457
16011
  "kind": "method",
15458
16012
  "name": "_report",
@@ -15562,6 +16116,42 @@
15562
16116
  }
15563
16117
  ]
15564
16118
  },
16119
+ {
16120
+ "kind": "method",
16121
+ "name": "setConfig",
16122
+ "return": {
16123
+ "type": {
16124
+ "text": "void"
16125
+ }
16126
+ },
16127
+ "parameters": [
16128
+ {
16129
+ "name": "config",
16130
+ "type": {
16131
+ "text": "AparteConfig | undefined"
16132
+ }
16133
+ }
16134
+ ],
16135
+ "description": "Give the chat another instance config, or none (`undefined`: the page's). A wrapper\ncalls it when its `config` prop changes: the boundary on the host moves, and every\nelement inside re-resolves its config. The config it already has changes nothing, so a\nwrapper may hand it on every render — a NEW object each render is a new config each time.\n\nThe messages stay. When the new config's conversation manager is another one, the open\nconversation is opened again from it if it holds that conversation; otherwise the chat\nkeeps saving it to the manager it had, until it opens another one.\n\nNot in the middle of a turn: a reply half-drawn with one configuration's renderers and\nfinished with another's is worse than a change that waits. The last config given\nduring the turn is applied when the turn ends."
16136
+ },
16137
+ {
16138
+ "kind": "method",
16139
+ "name": "_applyConfig",
16140
+ "privacy": "private",
16141
+ "return": {
16142
+ "type": {
16143
+ "text": "void"
16144
+ }
16145
+ },
16146
+ "parameters": [
16147
+ {
16148
+ "name": "config",
16149
+ "type": {
16150
+ "text": "AparteConfig | undefined"
16151
+ }
16152
+ }
16153
+ ]
16154
+ },
15565
16155
  {
15566
16156
  "kind": "method",
15567
16157
  "name": "setConversationId",
@@ -15578,7 +16168,35 @@
15578
16168
  }
15579
16169
  }
15580
16170
  ],
15581
- "description": "Load / switch the active conversation via the controller."
16171
+ "description": "Load / switch the active conversation via the controller. The same id again re-reads\nit from the manager: this is the imperative call, the one that means \"open this now\".\nA `conversationId` prop goes through syncConversationId."
16172
+ },
16173
+ {
16174
+ "kind": "method",
16175
+ "name": "syncConversationId",
16176
+ "return": {
16177
+ "type": {
16178
+ "text": "Promise<void>"
16179
+ }
16180
+ },
16181
+ "parameters": [
16182
+ {
16183
+ "name": "id",
16184
+ "type": {
16185
+ "text": "string | null"
16186
+ }
16187
+ }
16188
+ ],
16189
+ "description": "Follow a wrapper's `conversationId` prop: open `id`, unless it is the conversation this\nchat already shows or is creating.\n\nThe documented pattern gives the created conversation back to the chat — the prop set\nfrom `onConversationCreated`, or bound to the manager's `activeId`, which names the new\nconversation before the creation even resolves. That id arrives while the first reply\nstreams, and opening it then re-read a conversation the manager did not hold the reply\nof yet: the transcript was replaced under the stream. Compared with the controller, not\nwith the last prop: the person opens other conversations from the list without the prop\nhearing of it."
16190
+ },
16191
+ {
16192
+ "kind": "method",
16193
+ "name": "getConversationId",
16194
+ "return": {
16195
+ "type": {
16196
+ "text": "string | null"
16197
+ }
16198
+ },
16199
+ "description": "The conversation this chat shows: the one it opened, or the one its first message is\ncreating; `null` for a chat with none yet. Per chat, which the manager's single\n`activeId` cannot say once several chats share it."
15582
16200
  },
15583
16201
  {
15584
16202
  "kind": "field",
@@ -16242,6 +16860,24 @@
16242
16860
  "default": "nextBranchIcon",
16243
16861
  "description": "Next. Alias of the branch picker glyph — see chevronLeftIcon."
16244
16862
  },
16863
+ {
16864
+ "kind": "variable",
16865
+ "name": "chevronDownIcon",
16866
+ "default": "expandIcon",
16867
+ "description": "Down. Alias of the expand glyph, named by direction rather than state."
16868
+ },
16869
+ {
16870
+ "kind": "variable",
16871
+ "name": "chevronUpIcon",
16872
+ "default": "collapseIcon",
16873
+ "description": "Up. Alias of the collapse glyph, named by direction rather than state."
16874
+ },
16875
+ {
16876
+ "kind": "variable",
16877
+ "name": "panelLeftIcon",
16878
+ "default": "`<svg class=\"aparte-icon\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><rect x=\"3\" y=\"3\" width=\"18\" height=\"18\" rx=\"2\"/><path d=\"M9 3v18\"/></svg>`",
16879
+ "description": "Sidebar panel: toggles a desktop sidebar."
16880
+ },
16245
16881
  {
16246
16882
  "kind": "variable",
16247
16883
  "name": "arrowUpIcon",
@@ -16420,9 +17056,9 @@
16420
17056
  "kind": "variable",
16421
17057
  "name": "APARTE_EXTENDED_ICON_GLYPHS",
16422
17058
  "type": {
16423
- "text": "{\n plus: plusIcon,\n minus: minusIcon,\n search: searchIcon,\n filter: filterIcon,\n moreHorizontal: moreHorizontalIcon,\n moreVertical: moreVerticalIcon,\n chevronLeft: chevronLeftIcon,\n chevronRight: chevronRightIcon,\n arrowUp: arrowUpIcon,\n arrowRight: arrowRightIcon,\n externalLink: externalLinkIcon,\n link: linkIcon,\n folder: folderIcon,\n code: codeIcon,\n clipboard: clipboardIcon,\n trash: trashIcon,\n save: saveIcon,\n upload: uploadIcon,\n settings: settingsIcon,\n user: userIcon,\n bot: botIcon,\n sparkles: sparklesIcon,\n cpu: cpuIcon,\n database: databaseIcon,\n globe: globeIcon,\n key: keyIcon,\n mic: micIcon,\n micOff: micOffIcon,\n eye: eyeIcon,\n eyeOff: eyeOffIcon,\n clock: clockIcon,\n history: historyIcon,\n star: starIcon,\n share: shareIcon,\n checkCircle: checkCircleIcon,\n xCircle: xCircleIcon,\n messageSquare: messageSquareIcon,\n sun: sunIcon,\n moon: moonIcon,\n}"
17059
+ "text": "{\n plus: plusIcon,\n minus: minusIcon,\n search: searchIcon,\n filter: filterIcon,\n moreHorizontal: moreHorizontalIcon,\n moreVertical: moreVerticalIcon,\n chevronLeft: chevronLeftIcon,\n chevronRight: chevronRightIcon,\n chevronDown: chevronDownIcon,\n chevronUp: chevronUpIcon,\n panelLeft: panelLeftIcon,\n arrowUp: arrowUpIcon,\n arrowRight: arrowRightIcon,\n externalLink: externalLinkIcon,\n link: linkIcon,\n folder: folderIcon,\n code: codeIcon,\n clipboard: clipboardIcon,\n trash: trashIcon,\n save: saveIcon,\n upload: uploadIcon,\n settings: settingsIcon,\n user: userIcon,\n bot: botIcon,\n sparkles: sparklesIcon,\n cpu: cpuIcon,\n database: databaseIcon,\n globe: globeIcon,\n key: keyIcon,\n mic: micIcon,\n micOff: micOffIcon,\n eye: eyeIcon,\n eyeOff: eyeOffIcon,\n clock: clockIcon,\n history: historyIcon,\n star: starIcon,\n share: shareIcon,\n checkCircle: checkCircleIcon,\n xCircle: xCircleIcon,\n messageSquare: messageSquareIcon,\n sun: sunIcon,\n moon: moonIcon,\n}"
16424
17060
  },
16425
- "default": "{ plus: plusIcon, minus: minusIcon, search: searchIcon, filter: filterIcon, moreHorizontal: moreHorizontalIcon, moreVertical: moreVerticalIcon, chevronLeft: chevronLeftIcon, chevronRight: chevronRightIcon, arrowUp: arrowUpIcon, arrowRight: arrowRightIcon, externalLink: externalLinkIcon, link: linkIcon, folder: folderIcon, code: codeIcon, clipboard: clipboardIcon, trash: trashIcon, save: saveIcon, upload: uploadIcon, settings: settingsIcon, user: userIcon, bot: botIcon, sparkles: sparklesIcon, cpu: cpuIcon, database: databaseIcon, globe: globeIcon, key: keyIcon, mic: micIcon, micOff: micOffIcon, eye: eyeIcon, eyeOff: eyeOffIcon, clock: clockIcon, history: historyIcon, star: starIcon, share: shareIcon, checkCircle: checkCircleIcon, xCircle: xCircleIcon, messageSquare: messageSquareIcon, sun: sunIcon, moon: moonIcon, }",
17061
+ "default": "{ plus: plusIcon, minus: minusIcon, search: searchIcon, filter: filterIcon, moreHorizontal: moreHorizontalIcon, moreVertical: moreVerticalIcon, chevronLeft: chevronLeftIcon, chevronRight: chevronRightIcon, chevronDown: chevronDownIcon, chevronUp: chevronUpIcon, panelLeft: panelLeftIcon, arrowUp: arrowUpIcon, arrowRight: arrowRightIcon, externalLink: externalLinkIcon, link: linkIcon, folder: folderIcon, code: codeIcon, clipboard: clipboardIcon, trash: trashIcon, save: saveIcon, upload: uploadIcon, settings: settingsIcon, user: userIcon, bot: botIcon, sparkles: sparklesIcon, cpu: cpuIcon, database: databaseIcon, globe: globeIcon, key: keyIcon, mic: micIcon, micOff: micOffIcon, eye: eyeIcon, eyeOff: eyeOffIcon, clock: clockIcon, history: historyIcon, star: starIcon, share: shareIcon, checkCircle: checkCircleIcon, xCircle: xCircleIcon, messageSquare: messageSquareIcon, sun: sunIcon, moon: moonIcon, }",
16426
17062
  "description": "Every extended glyph, by name. Importing this object defeats tree-shaking:\nit is here for a gallery or a picker, not for drawing one icon."
16427
17063
  }
16428
17064
  ],
@@ -16491,6 +17127,30 @@
16491
17127
  "module": "src/icons/extended.ts"
16492
17128
  }
16493
17129
  },
17130
+ {
17131
+ "kind": "js",
17132
+ "name": "chevronDownIcon",
17133
+ "declaration": {
17134
+ "name": "chevronDownIcon",
17135
+ "module": "src/icons/extended.ts"
17136
+ }
17137
+ },
17138
+ {
17139
+ "kind": "js",
17140
+ "name": "chevronUpIcon",
17141
+ "declaration": {
17142
+ "name": "chevronUpIcon",
17143
+ "module": "src/icons/extended.ts"
17144
+ }
17145
+ },
17146
+ {
17147
+ "kind": "js",
17148
+ "name": "panelLeftIcon",
17149
+ "declaration": {
17150
+ "name": "panelLeftIcon",
17151
+ "module": "src/icons/extended.ts"
17152
+ }
17153
+ },
16494
17154
  {
16495
17155
  "kind": "js",
16496
17156
  "name": "arrowUpIcon",
@@ -17272,6 +17932,85 @@
17272
17932
  }
17273
17933
  ]
17274
17934
  },
17935
+ {
17936
+ "kind": "javascript-module",
17937
+ "path": "src/interop/chat-events.ts",
17938
+ "declarations": [
17939
+ {
17940
+ "kind": "function",
17941
+ "name": "chatIdOf",
17942
+ "return": {
17943
+ "type": {
17944
+ "text": "string | undefined"
17945
+ }
17946
+ },
17947
+ "parameters": [
17948
+ {
17949
+ "name": "el",
17950
+ "type": {
17951
+ "text": "Element | null | undefined"
17952
+ }
17953
+ }
17954
+ ],
17955
+ "description": "The id of the chat `el` belongs to, or `undefined` when it belongs to none with an id.\n\nClimbing from `el` itself: the first aparté element with a `target` attribute names its chat\n(a composer, a suggestions row or a gauge placed outside the chat it serves says so there);\notherwise the nearest `<aparte-chat>` or `[data-aparte-chat]` root that has an id. An id-less\nhost is passed over rather than answered with \"no id\", so a chat nested in another names the\none that has a name.\n\n`undefined` is an answer, not an error: a page with one chat needs no id, and an event that\nnames no chat is, by the rule every receiver in core follows, for every chat."
17956
+ },
17957
+ {
17958
+ "kind": "function",
17959
+ "name": "dispatchChatEvent",
17960
+ "return": {
17961
+ "type": {
17962
+ "text": "boolean"
17963
+ }
17964
+ },
17965
+ "parameters": [
17966
+ {
17967
+ "name": "el",
17968
+ "type": {
17969
+ "text": "Element"
17970
+ }
17971
+ },
17972
+ {
17973
+ "name": "type",
17974
+ "type": {
17975
+ "text": "string"
17976
+ }
17977
+ },
17978
+ {
17979
+ "name": "detail",
17980
+ "type": {
17981
+ "text": "T"
17982
+ }
17983
+ },
17984
+ {
17985
+ "name": "init",
17986
+ "default": "{}",
17987
+ "type": {
17988
+ "text": "{ cancelable?: boolean }"
17989
+ }
17990
+ }
17991
+ ],
17992
+ "description": "Dispatch `type` on `el`, bubbling and composed, its detail stamped with the chat `el` belongs to\n(`targetId`, from chatIdOf) — the stamp `dispatchLifecycleEvent` puts on the turn's own\nevents, for everything else a chat's content or its composer sends.\n\nA `targetId` the detail already carries is kept: the sender knew better. Without a chat to name,\nthe detail goes as it is, with no `targetId` key. Returns what `dispatchEvent` returns, so a\ncancelable event (`{ cancelable: true }`) tells the sender whether a listener cancelled it."
17993
+ }
17994
+ ],
17995
+ "exports": [
17996
+ {
17997
+ "kind": "js",
17998
+ "name": "chatIdOf",
17999
+ "declaration": {
18000
+ "name": "chatIdOf",
18001
+ "module": "src/interop/chat-events.ts"
18002
+ }
18003
+ },
18004
+ {
18005
+ "kind": "js",
18006
+ "name": "dispatchChatEvent",
18007
+ "declaration": {
18008
+ "name": "dispatchChatEvent",
18009
+ "module": "src/interop/chat-events.ts"
18010
+ }
18011
+ }
18012
+ ]
18013
+ },
17275
18014
  {
17276
18015
  "kind": "javascript-module",
17277
18016
  "path": "src/interop/default-on-attributes.ts",
@@ -17463,7 +18202,7 @@
17463
18202
  }
17464
18203
  }
17465
18204
  ],
17466
- "description": "Apply props to an aparté custom element. aparté elements are\n**attribute-driven** (`observedAttributes`): assigning a property is either a\nsilent no-op (nothing observes it) or throws outright on a getter-only\naccessor — `<aparte-composer>`'s `placeholder`/`disabled` are exactly that.\nSo primitives go through `setAttribute`; only values an attribute cannot carry\n(objects, functions) are handed over as properties. Keys starting with `--`\nbecome CSS variables; `on…` function values are ignored (event forwarding is\nthe wrapper's job).\n\n`transformValue` is applied to object/function values before they're set as\nproperties — Vue passes `toRaw` to unwrap its reactive proxy (a deep proxy\nbreaks Maps/class internals on a plain custom element); it defaults to identity."
18205
+ "description": "Apply props to an aparté custom element. aparté elements are\n**attribute-driven** (`observedAttributes`): assigning a property is either a\nsilent no-op (nothing observes it) or throws outright on a getter-only\naccessor — `<aparte-composer>`'s `placeholder`/`disabled` are exactly that.\nSo primitives go through `setAttribute`; only values an attribute cannot carry\n(objects, functions) are handed over as properties. Keys starting with `--`\nbecome CSS variables; `on…` function values are ignored (event forwarding is\nthe wrapper's job).\n\n`transformValue` is applied to object/function values before they're set as\nproperties — Vue passes `toRaw` to unwrap its reactive proxy (a deep proxy\nbreaks Maps/class internals on a plain custom element); it defaults to identity.\n\nA wrapper calls this with the whole bag whenever the bag changes, so an attribute or a CSS\nvariable is written only when its value differs from the one this function last wrote on that\nelement: re-writing the same string still runs `attributeChangedCallback`. An object or a\nfunction is assigned every time, even the same one, because it may have been mutated in place;\nthe element's setter keeps its state when it is handed what it already holds."
17467
18206
  }
17468
18207
  ],
17469
18208
  "exports": [
@@ -17485,6 +18224,12 @@
17485
18224
  }
17486
18225
  ]
17487
18226
  },
18227
+ {
18228
+ "kind": "javascript-module",
18229
+ "path": "src/interop/element-spec.ts",
18230
+ "declarations": [],
18231
+ "exports": []
18232
+ },
17488
18233
  {
17489
18234
  "kind": "javascript-module",
17490
18235
  "path": "src/interop/image-holds.ts",
@@ -20843,6 +21588,14 @@
20843
21588
  "module": "./models.js"
20844
21589
  }
20845
21590
  },
21591
+ {
21592
+ "kind": "js",
21593
+ "name": "AparteDeferredCall",
21594
+ "declaration": {
21595
+ "name": "AparteDeferredCall",
21596
+ "module": "./models.js"
21597
+ }
21598
+ },
20846
21599
  {
20847
21600
  "kind": "js",
20848
21601
  "name": "AparteComposerCaret",
@@ -23383,7 +24136,7 @@
23383
24136
  }
23384
24137
  }
23385
24138
  ],
23386
- "description": "What the config's tool-line provider says about this call (`setToolLineProvider`), or\n`undefined` when there is none, it says nothing, or it throws — the default line then.\nCalled at every draw, update and relabel, never stored: its words follow the locale."
24139
+ "description": "What the config's tool-line providers say about this call (`setToolLineProvider`, then\neach `registerToolLineProvider` in order — the first to answer wins), or `undefined` when\nthere is none, none says anything, or a throwing one is the only one — the default line\nthen. Called at every draw, update and relabel, never stored: its words follow the locale."
23387
24140
  },
23388
24141
  {
23389
24142
  "kind": "function",
@@ -23488,7 +24241,7 @@
23488
24241
  },
23489
24242
  "parameters": [
23490
24243
  {
23491
- "name": "_segment",
24244
+ "name": "segment",
23492
24245
  "type": {
23493
24246
  "text": "AparteToolCallSegment"
23494
24247
  }
@@ -23498,9 +24251,15 @@
23498
24251
  "type": {
23499
24252
  "text": "AparteToolLine | undefined"
23500
24253
  }
24254
+ },
24255
+ {
24256
+ "name": "config",
24257
+ "type": {
24258
+ "text": "AparteConfig"
24259
+ }
23501
24260
  }
23502
24261
  ],
23503
- "description": "The row's second line, from the tool-line provider, in every state it gives one: what the\ncall is doing now, and once it is over what it did. Core says nothing there on its own."
24262
+ "description": "The row's second line: the app's `activity` on the tool's display, else the tool-line\nprovider's, in every state it gives one. Core says nothing there on its own."
23504
24263
  },
23505
24264
  {
23506
24265
  "kind": "function",
@@ -23511,14 +24270,26 @@
23511
24270
  }
23512
24271
  },
23513
24272
  "parameters": [
24273
+ {
24274
+ "name": "segment",
24275
+ "type": {
24276
+ "text": "AparteToolCallSegment"
24277
+ }
24278
+ },
23514
24279
  {
23515
24280
  "name": "line",
23516
24281
  "type": {
23517
24282
  "text": "AparteToolLine | undefined"
23518
24283
  }
24284
+ },
24285
+ {
24286
+ "name": "config",
24287
+ "type": {
24288
+ "text": "AparteConfig"
24289
+ }
23519
24290
  }
23520
24291
  ],
23521
- "description": "The provider's trailing note, in every state."
24292
+ "description": "The row's trailing note: the app's `note` on the tool's display, else the provider's, in every state."
23522
24293
  }
23523
24294
  ],
23524
24295
  "exports": [
@@ -25743,60 +26514,60 @@
25743
26514
  ],
25744
26515
  "events": [
25745
26516
  {
25746
- "name": "aparte-feedback-reason",
26517
+ "name": "aparte-retry",
25747
26518
  "type": {
25748
- "text": "CustomEvent<AparteFeedbackReasonEventDetail>"
26519
+ "text": "CustomEvent<AparteRetryEventDetail>"
25749
26520
  },
25750
- "description": "The reason picked after a thumbs-down."
26521
+ "description": "Retry was pressed; the host forks the turn."
25751
26522
  },
25752
26523
  {
25753
- "name": "aparte-attachment-preview",
26524
+ "name": "aparte-edit",
25754
26525
  "type": {
25755
- "text": "CustomEvent<AparteAttachmentPreviewEventDetail>"
26526
+ "text": "CustomEvent<AparteEditEventDetail>"
25756
26527
  },
25757
- "description": "An attached image was clicked, asking the app to open it full-size — or a file, with `filePreview`, asking the app to open it."
26528
+ "description": "An edit was saved."
25758
26529
  },
25759
26530
  {
25760
- "name": "aparte-action",
25761
26531
  "type": {
25762
26532
  "text": "CustomEvent<AparteActionEventDetail>"
25763
26533
  },
25764
- "description": "A custom action-bar button was pressed."
26534
+ "description": "A custom action-bar button was pressed.",
26535
+ "name": "aparte-action"
25765
26536
  },
25766
26537
  {
25767
- "name": "aparte-retry",
25768
26538
  "type": {
25769
- "text": "CustomEvent<AparteRetryEventDetail>"
26539
+ "text": "CustomEvent<AparteFeedbackEventDetail>"
25770
26540
  },
25771
- "description": "Retry was pressed; the host forks the turn."
26541
+ "description": "Thumbs up or down.",
26542
+ "name": "aparte-feedback"
25772
26543
  },
25773
26544
  {
25774
- "name": "aparte-feedback",
25775
26545
  "type": {
25776
- "text": "CustomEvent<AparteFeedbackEventDetail>"
26546
+ "text": "CustomEvent<AparteFeedbackReasonEventDetail>"
25777
26547
  },
25778
- "description": "Thumbs up or down."
26548
+ "description": "The reason picked after a thumbs-down.",
26549
+ "name": "aparte-feedback-reason"
25779
26550
  },
25780
26551
  {
25781
- "name": "aparte-message-info",
25782
26552
  "type": {
25783
26553
  "text": "CustomEvent<AparteMessageInfoEventDetail>"
25784
26554
  },
25785
- "description": "The info affordance was pressed."
26555
+ "description": "The info affordance was pressed.",
26556
+ "name": "aparte-message-info"
25786
26557
  },
25787
26558
  {
25788
- "name": "aparte-edit",
25789
26559
  "type": {
25790
- "text": "CustomEvent<AparteEditEventDetail>"
26560
+ "text": "CustomEvent<AparteBranchNavigateEventDetail>"
25791
26561
  },
25792
- "description": "An edit was saved."
26562
+ "description": "The `‹1/2›` picker moved between sibling versions.",
26563
+ "name": "aparte-branch-navigate"
25793
26564
  },
25794
26565
  {
25795
26566
  "type": {
25796
- "text": "CustomEvent<AparteBranchNavigateEventDetail>"
26567
+ "text": "CustomEvent<AparteAttachmentPreviewEventDetail>"
25797
26568
  },
25798
- "description": "The `‹1/2›` picker moved between sibling versions.",
25799
- "name": "aparte-branch-navigate"
26569
+ "description": "An attached image was clicked, asking the app to open it full-size — or a file, with `filePreview`, asking the app to open it.",
26570
+ "name": "aparte-attachment-preview"
25800
26571
  },
25801
26572
  {
25802
26573
  "type": {
@@ -26875,11 +27646,11 @@
26875
27646
  ],
26876
27647
  "events": [
26877
27648
  {
26878
- "name": "aparte-action-click",
26879
27649
  "type": {
26880
27650
  "text": "CustomEvent<AparteActionClickEventDetail>"
26881
27651
  },
26882
- "description": "Bubbles up when the button is clicked, carrying which button it was and the composer it belongs to. The type argument is not decoration: a BARE `@fires` records `CustomEvent` with no argument, and the bindings generator then emits `EventEmitter<void>` with a listener that drops `$event` — so an Angular consumer with two custom buttons could not tell which one fired. detail: { actionId: string, composer: AparteComposer | null }"
27652
+ "description": "Bubbles up when the button is clicked, carrying which button it was and the composer it belongs to. The type argument is not decoration: a BARE `@fires` records `CustomEvent` with no argument, and the bindings generator then emits `EventEmitter<void>` with a listener that drops `$event` — so an Angular consumer with two custom buttons could not tell which one fired. detail: { actionId: string, composer: AparteComposer | null }",
27653
+ "name": "aparte-action-click"
26883
27654
  }
26884
27655
  ],
26885
27656
  "attributes": [
@@ -27322,11 +28093,11 @@
27322
28093
  ],
27323
28094
  "events": [
27324
28095
  {
27325
- "name": "aparte-attachment-preview",
27326
28096
  "type": {
27327
28097
  "text": "CustomEvent<AparteAttachmentPreviewEventDetail>"
27328
28098
  },
27329
- "description": "An attached image was clicked; the app opens it full-size, and only if it declared `attachmentPreview`."
28099
+ "description": "An attached image was clicked; the app opens it full-size, and only if it declared `attachmentPreview`.",
28100
+ "name": "aparte-attachment-preview"
27330
28101
  }
27331
28102
  ],
27332
28103
  "superclass": {
@@ -29199,13 +29970,6 @@
29199
29970
  },
29200
29971
  "description": "The stop button was pressed. No detail; the two window events below carry the target."
29201
29972
  },
29202
- {
29203
- "name": "aparte-composer-change",
29204
- "type": {
29205
- "text": "CustomEvent<AparteComposerChangeEventDetail>"
29206
- },
29207
- "description": "Any of value / streaming / disabled / attachments / panel changed, folded into one event."
29208
- },
29209
29973
  {
29210
29974
  "type": {
29211
29975
  "text": "CustomEvent<AparteAbortEventDetail>"
@@ -29219,6 +29983,13 @@
29219
29983
  },
29220
29984
  "description": "The run for this target ended early — the user pressed Stop, or `abort()` was called. This element dispatches it on `window`; `AparteClient` also dispatches it on the chat host, so it is listenable on either.",
29221
29985
  "name": "aparte-message-aborted"
29986
+ },
29987
+ {
29988
+ "type": {
29989
+ "text": "CustomEvent<AparteComposerChangeEventDetail>"
29990
+ },
29991
+ "description": "Any of value / streaming / disabled / attachments / panel changed, folded into one event.",
29992
+ "name": "aparte-composer-change"
29222
29993
  }
29223
29994
  ],
29224
29995
  "attributes": [
@@ -30533,11 +31304,70 @@
30533
31304
  {
30534
31305
  "kind": "field",
30535
31306
  "name": "conversations",
30536
- "description": "Set the list of conversations to display. Triggers a re-render.",
31307
+ "description": "Set the list of conversations to display. Triggers a re-render — held while a row's menu is\nopen or a title is being renamed, and run when that ends.\n\nA host assigns this on every manager change, and a wrapper on every render of the app around\nit, often the very array the list holds (mutated in place, so it is drawn again rather than\nskipped). A render replaces the rows, and with them the open menu and the field being typed\nin: those are the reader's, so the rows wait for them, as they wait for a press to land.",
30537
31308
  "type": {
30538
31309
  "text": "AparteConversationListItem[]"
30539
31310
  }
30540
31311
  },
31312
+ {
31313
+ "kind": "field",
31314
+ "name": "_renderAfterMenu",
31315
+ "type": {
31316
+ "text": "boolean"
31317
+ },
31318
+ "privacy": "private",
31319
+ "default": "false",
31320
+ "description": "A render held by an open menu or a rename (see `conversations`): run once it is over."
31321
+ },
31322
+ {
31323
+ "kind": "method",
31324
+ "name": "_renderUnlessHeld",
31325
+ "privacy": "private",
31326
+ "return": {
31327
+ "type": {
31328
+ "text": "void"
31329
+ }
31330
+ },
31331
+ "description": "The one way a render asked from outside runs: held while a row menu is open or a title is\nbeing renamed, drawn once that ends. A press's deferred render goes through it too, so a\nrename started by the click that closed a menu is not wiped by the render that menu held."
31332
+ },
31333
+ {
31334
+ "kind": "method",
31335
+ "name": "_renderHeld",
31336
+ "privacy": "private",
31337
+ "return": {
31338
+ "type": {
31339
+ "text": "void"
31340
+ }
31341
+ }
31342
+ },
31343
+ {
31344
+ "kind": "field",
31345
+ "name": "_renderMeta",
31346
+ "type": {
31347
+ "text": "AparteConversationMetaRenderer | null"
31348
+ },
31349
+ "privacy": "private",
31350
+ "default": "null"
31351
+ },
31352
+ {
31353
+ "kind": "field",
31354
+ "name": "renderMeta",
31355
+ "description": "Draws something of the app's after a row's title — a shared mark, a count, a status\npill — and returns `null` for a row with nothing to say. An element goes in as it is;\na string is text, never markup. It sits BESIDE the title button, not inside it, so it\nmay hold a button or a link of its own, with its own accessible name. Setting it draws\nthe rows again, held like `conversations` while a menu is open or a title is being\nrenamed; the same function handed again draws nothing. It is read on every render after that.",
31356
+ "type": {
31357
+ "text": "AparteConversationMetaRenderer | null"
31358
+ }
31359
+ },
31360
+ {
31361
+ "kind": "method",
31362
+ "name": "_applyMeta",
31363
+ "privacy": "private",
31364
+ "return": {
31365
+ "type": {
31366
+ "text": "void"
31367
+ }
31368
+ },
31369
+ "description": "Puts what `renderMeta` returns after each row's title. Rows are strings, so this runs on the built DOM."
31370
+ },
30541
31371
  {
30542
31372
  "kind": "field",
30543
31373
  "name": "_pressed",
@@ -31135,6 +31965,14 @@
31135
31965
  "module": "./aparte-conversation-list.js"
31136
31966
  }
31137
31967
  },
31968
+ {
31969
+ "kind": "js",
31970
+ "name": "AparteConversationMetaRenderer",
31971
+ "declaration": {
31972
+ "name": "AparteConversationMetaRenderer",
31973
+ "module": "./aparte-conversation-list.js"
31974
+ }
31975
+ },
31138
31976
  {
31139
31977
  "kind": "js",
31140
31978
  "name": "AparteConversationSelectDetail",
@@ -33198,7 +34036,7 @@
33198
34036
  "declarations": [
33199
34037
  {
33200
34038
  "kind": "class",
33201
- "description": "The column beside the chat — conversations, a new-chat button, a search field, an\naccount row — as an element, because it has behaviour: it collapses, it becomes a\ndrawer on a narrow window, and its search field filters the conversation list.\n\nWhat it does NOT own is its content. Children are yours, in the order you want them:\na `.aparte-sidebar__header`, a `.aparte-sidebar__search`, a `.aparte-sidebar__body`\nholding the `<aparte-conversation-list>`, a `.aparte-sidebar__footer`. The\nstylesheet lays those out and draws nothing you did not put there — the recipe\n(`.aparte-sidebar`, in `styles/shell/sidebar.css`) is the look, this element is\nthe three behaviours.\n\n**Collapse.** `collapsed` is an attribute, reflected, so the host can set it, read\nit and persist it. Any element carrying `data-aparte-sidebar-toggle` anywhere on\nthe page toggles its sidebar: the one it is in, else the one of the `.aparte-app-shell`\nit is in, else the first of the page (or the one whose id the attribute names). So\na hamburger in the header needs no script — and the sidebar keeps `aria-expanded`\nand `aria-controls` on that control in step, whoever changed the state (it gives\nitself an id when the host wrote none). `aparte-sidebar-toggle` fires on every\nchange, whoever caused it.\n\n**Drawer.** Under 48rem of window the sidebar leaves the flow and slides over the\npage (`data-drawer`, set by the element from a media query); open, it draws a\nscrim, moves the focus to its first focusable child, closes on Escape from anywhere\non the page or on a click outside, and hands the focus back to the control that\nopened it. Nothing here is a portal: the drawer is the same element in the same\nplace, positioned fixed, which is all a sidebar needs and what a dialog would not\nget away with. Collapsed — folded as a column or slid off as a drawer — it carries\n`inert` and `aria-hidden`, so nothing invisible keeps a tab stop.\n\n**In the floating chat.** Inside `<aparte-launcher>` the chat is a card a few hundred pixels\nwide in the widest window, so a sidebar that is the direct child of the card's\n`.aparte-app-shell` follows the chat and not the window: a drawer in the card, held by the\nshell, whose scrim covers the card and not the page; a column again once the chat fills the\nwindow (maximized, unless `maximizable=\"panel\"`, which is still narrow); and closed when the\nchat closes. `breakpoint=\"none\"` keeps it a column there too. Anywhere else in a card it\nfollows the window, as it does on a page.\n\n**Search.** An input carrying `data-aparte-sidebar-search` filters the conversation\nlist below it by title as the user types — rows that do not match are hidden, and a\ndate group with nothing left hides with them. Client-side, on the titles the list\nalready has: an index over message bodies is the storage adapter's business.",
34039
+ "description": "The column beside the chat — conversations, a new-chat button, a search field, an\naccount row — as an element, because it has behaviour: it collapses, it becomes a\ndrawer on a narrow window, and its search field filters the conversation list.\n\nWhat it does NOT own is its content. Children are yours, in the order you want them:\na `.aparte-sidebar__header`, a `.aparte-sidebar__search`, a `.aparte-sidebar__body`\nholding the `<aparte-conversation-list>`, a `.aparte-sidebar__footer`. The\nstylesheet lays those out and draws nothing you did not put there — the recipe\n(`.aparte-sidebar`, in `styles/shell/sidebar.css`) is the look, this element is\nthe three behaviours.\n\n**Collapse.** `collapsed` is an attribute, reflected, so the host can set it, read\nit and persist it. Any element carrying `data-aparte-sidebar-toggle` anywhere on\nthe page toggles its sidebar: the one it is in, else the one of the `.aparte-app-shell`\nit is in, else the first of the page (or the one whose id the attribute names). So\na hamburger in the header needs no script — and the sidebar keeps `aria-expanded`\nand `aria-controls` on that control in step, whoever changed the state (it gives\nitself an id when the host wrote none). `aparte-sidebar-toggle` fires on every\nchange, whoever caused it.\n\n**Drawer.** Under 48rem of window the sidebar leaves the flow and slides over the\npage (`data-drawer`, set by the element from a media query); open, it draws a\nscrim, moves the focus to its first focusable child, closes on Escape from anywhere\non the page or on a click outside, and hands the focus back to the control that\nopened it. Nothing here is a portal: the drawer is the same element in the same\nplace, positioned fixed, which is all a sidebar needs and what a dialog would not\nget away with. Collapsed — folded as a column or slid off as a drawer — it carries\n`inert` and `aria-hidden`, so nothing invisible keeps a tab stop.\n\n**Rail.** `collapsed=\"rail\"` folds the column to `--aparte-sidebar-rail-width` and keeps it\nin the flow: the children marked `data-rail` stay (icon buttons, an avatar), the rest and the\n`.aparte-sidebar__label` texts hide, and it takes no `inert`. `collapsed` is still true, so a\ntoggle reads it as folded; the app swaps `collapsed` for `rail` itself, which is its call.\n\n**In the floating chat.** Inside `<aparte-launcher>` the chat is a card a few hundred pixels\nwide in the widest window, so a sidebar that is the direct child of the card's\n`.aparte-app-shell` follows the chat and not the window: a drawer in the card, held by the\nshell, whose scrim covers the card and not the page; a column again once the chat fills the\nwindow (maximized, unless `maximizable=\"panel\"`, which is still narrow); and closed when the\nchat closes. `breakpoint=\"none\"` keeps it a column there too. Anywhere else in a card it\nfollows the window, as it does on a page.\n\n**Search.** An input carrying `data-aparte-sidebar-search` filters the conversation\nlist below it by title as the user types — rows that do not match are hidden, and a\ndate group with nothing left hides with them. Client-side, on the titles the list\nalready has: an index over message bodies is the storage adapter's business.",
33202
34040
  "name": "AparteSidebar",
33203
34041
  "cssProperties": [
33204
34042
  {
@@ -33206,6 +34044,11 @@
33206
34044
  "name": "--aparte-sidebar-width",
33207
34045
  "default": "260px"
33208
34046
  },
34047
+ {
34048
+ "description": "Width of the column folded to a rail (`collapsed=\"rail\"`).",
34049
+ "name": "--aparte-sidebar-rail-width",
34050
+ "default": "56px"
34051
+ },
33209
34052
  {
33210
34053
  "description": "The inline inset of the four regions (header, search, body, footer): one value, so their content stands on one axis.",
33211
34054
  "name": "--aparte-sidebar-inset",
@@ -33255,6 +34098,15 @@
33255
34098
  "privacy": "private",
33256
34099
  "default": "null"
33257
34100
  },
34101
+ {
34102
+ "kind": "field",
34103
+ "name": "_lastRail",
34104
+ "type": {
34105
+ "text": "boolean"
34106
+ },
34107
+ "privacy": "private",
34108
+ "default": "false"
34109
+ },
33258
34110
  {
33259
34111
  "kind": "field",
33260
34112
  "name": "_ready",
@@ -33352,6 +34204,17 @@
33352
34204
  },
33353
34205
  "description": "Whether the sidebar is collapsed (hidden in the flow, or closed as a drawer)."
33354
34206
  },
34207
+ {
34208
+ "kind": "method",
34209
+ "name": "_rail",
34210
+ "privacy": "private",
34211
+ "return": {
34212
+ "type": {
34213
+ "text": "boolean"
34214
+ }
34215
+ },
34216
+ "description": "A rail is a column folded to `--aparte-sidebar-rail-width` that stays in the flow and\nstays usable (`collapsed=\"rail\"`). Only in the flow: a drawer is open or closed, and a\nclosed one is off-screen whatever its attribute says."
34217
+ },
33355
34218
  {
33356
34219
  "kind": "field",
33357
34220
  "name": "drawer",
@@ -33632,9 +34495,9 @@
33632
34495
  {
33633
34496
  "name": "collapsed",
33634
34497
  "type": {
33635
- "text": "boolean"
34498
+ "text": "boolean|\"rail\""
33636
34499
  },
33637
- "description": "Hidden (in the flow) or closed (as a drawer). Reflected; set it to start closed."
34500
+ "description": "Hidden (in the flow) or closed (as a drawer). `collapsed=\"rail\"` folds the column to a narrow rail that stays usable instead of to nothing. Reflected; set it to start closed."
33638
34501
  },
33639
34502
  {
33640
34503
  "name": "breakpoint",
@@ -34923,6 +35786,517 @@
34923
35786
  }
34924
35787
  ]
34925
35788
  },
35789
+ {
35790
+ "kind": "javascript-module",
35791
+ "path": "src/components/suggestions/aparte-suggestions.ts",
35792
+ "declarations": [
35793
+ {
35794
+ "kind": "class",
35795
+ "description": "Prompt starters — a row of suggested prompts a reader clicks instead of typing.\n\nEvery chat product opens on three or four of these. This element is that pattern\ndone once, wearing the button recipe.\n\nA click goes THROUGH the composer — `setValue()` then `submit()` — never a synthetic\n`aparte-send`. The composer's `submit()` is where every gate lives (disabled, already\nstreaming, `requireModelSelection`), and a chip that bypassed them could send a\nrequest with an empty model id while the composer was visibly greyed out. So the\nelement needs a composer: the nearest `<aparte-composer>` ancestor, else the one\nserving the chat named by `target`, else the first one in the document.\n\nCore honours the click alone, so it is live by default. `aparte-suggestion` fires first and is cancelable — `preventDefault()`\nleaves the composer untouched, for an app that wants the prompt for itself.\n\nIt declares no custom property of its own: the gap comes from the global\n`--aparte-space-*` tokens and the chips from the `aparte-btn` recipe, so it inherits\na theme rather than exposing knobs to re-set.",
35796
+ "name": "AparteSuggestions",
35797
+ "members": [
35798
+ {
35799
+ "kind": "field",
35800
+ "name": "_suggestions",
35801
+ "type": {
35802
+ "text": "AparteSuggestion[]"
35803
+ },
35804
+ "privacy": "private",
35805
+ "default": "[]"
35806
+ },
35807
+ {
35808
+ "kind": "field",
35809
+ "name": "_composer",
35810
+ "type": {
35811
+ "text": "AparteComposer | null"
35812
+ },
35813
+ "privacy": "private",
35814
+ "default": "null"
35815
+ },
35816
+ {
35817
+ "kind": "field",
35818
+ "name": "_transcript",
35819
+ "type": {
35820
+ "text": "Element | null"
35821
+ },
35822
+ "privacy": "private",
35823
+ "default": "null",
35824
+ "description": "The viewport of the chat this row serves, while `empty-only` follows it."
35825
+ },
35826
+ {
35827
+ "kind": "field",
35828
+ "name": "_transcriptObserver",
35829
+ "type": {
35830
+ "text": "MutationObserver | null"
35831
+ },
35832
+ "privacy": "private",
35833
+ "default": "null"
35834
+ },
35835
+ {
35836
+ "kind": "field",
35837
+ "name": "_sent",
35838
+ "type": {
35839
+ "text": "boolean"
35840
+ },
35841
+ "privacy": "private",
35842
+ "default": "false",
35843
+ "description": "The composer sent since the transcript was last seen empty."
35844
+ },
35845
+ {
35846
+ "kind": "field",
35847
+ "name": "_wasEmpty",
35848
+ "type": {
35849
+ "text": "boolean"
35850
+ },
35851
+ "privacy": "private",
35852
+ "default": "true"
35853
+ },
35854
+ {
35855
+ "kind": "field",
35856
+ "name": "_hidOwn",
35857
+ "type": {
35858
+ "text": "boolean"
35859
+ },
35860
+ "privacy": "private",
35861
+ "default": "false",
35862
+ "description": "`hidden` was written by this element, so it is this element's to lift."
35863
+ },
35864
+ {
35865
+ "kind": "field",
35866
+ "name": "_onSend",
35867
+ "privacy": "private"
35868
+ },
35869
+ {
35870
+ "kind": "field",
35871
+ "name": "_applyEmptyOnly",
35872
+ "privacy": "private"
35873
+ },
35874
+ {
35875
+ "kind": "field",
35876
+ "name": "_onConfigChange",
35877
+ "privacy": "private"
35878
+ },
35879
+ {
35880
+ "kind": "field",
35881
+ "name": "suggestions",
35882
+ "type": {
35883
+ "text": "AparteSuggestion[]"
35884
+ },
35885
+ "description": "Takes the array, or the JSON string the attribute documents.\n\nBoth, because both arrive: React 19 and Svelte assign the PROPERTY whenever the\nelement has one of that name, so `<aparte-suggestions suggestions='[…]'>` — the\ndocumented spelling, typed valid by both wrappers — reaches this setter as a\nstring while the attribute (and so `attributeChangedCallback`) is never written."
35886
+ },
35887
+ {
35888
+ "kind": "method",
35889
+ "name": "_groupLabel",
35890
+ "privacy": "private",
35891
+ "return": {
35892
+ "type": {
35893
+ "text": "string"
35894
+ }
35895
+ }
35896
+ },
35897
+ {
35898
+ "kind": "field",
35899
+ "name": "_parsed",
35900
+ "type": {
35901
+ "text": "string | null"
35902
+ },
35903
+ "privacy": "private",
35904
+ "default": "null"
35905
+ },
35906
+ {
35907
+ "kind": "method",
35908
+ "name": "_readAttribute",
35909
+ "privacy": "private",
35910
+ "return": {
35911
+ "type": {
35912
+ "text": "void"
35913
+ }
35914
+ },
35915
+ "description": "Parse the `suggestions` attribute once per value. The attribute callback and\n`connectedCallback` both arrive for a parsed element, in an order the parser\ndecides; without this, an invalid value warned twice."
35916
+ },
35917
+ {
35918
+ "kind": "method",
35919
+ "name": "_resolveComposer",
35920
+ "privacy": "private",
35921
+ "return": {
35922
+ "type": {
35923
+ "text": "AparteComposer | null"
35924
+ }
35925
+ },
35926
+ "description": "The composer the click goes through, resolved the way the composer's own parts\nresolve it — by ancestry first. Outside a composer, `target` names the chat and the\ncomposer serving it is either inside that chat or points at it; the first composer\non the page is the last resort, so the one-chat page needs no attribute at all."
35927
+ },
35928
+ {
35929
+ "kind": "method",
35930
+ "name": "_watchComposer",
35931
+ "privacy": "private",
35932
+ "return": {
35933
+ "type": {
35934
+ "text": "void"
35935
+ }
35936
+ }
35937
+ },
35938
+ {
35939
+ "kind": "method",
35940
+ "name": "_resolveTranscript",
35941
+ "privacy": "private",
35942
+ "return": {
35943
+ "type": {
35944
+ "text": "Element | null"
35945
+ }
35946
+ },
35947
+ "description": "The transcript of the chat the click goes to: the chat around the composer, else\nthe one around this element, else the one `target` names (here, or on that\ncomposer). No last resort on the page, unlike the composer's: following another\nchat's transcript would be worse than following none, which falls back to the send."
35948
+ },
35949
+ {
35950
+ "kind": "method",
35951
+ "name": "_watchTranscript",
35952
+ "privacy": "private",
35953
+ "return": {
35954
+ "type": {
35955
+ "text": "void"
35956
+ }
35957
+ },
35958
+ "description": "Follow the transcript while `empty-only` or `answers` is set, and stop following it when neither is."
35959
+ },
35960
+ {
35961
+ "kind": "field",
35962
+ "name": "_onTranscript",
35963
+ "privacy": "private"
35964
+ },
35965
+ {
35966
+ "kind": "method",
35967
+ "name": "_applyAnswers",
35968
+ "privacy": "private",
35969
+ "return": {
35970
+ "type": {
35971
+ "text": "void"
35972
+ }
35973
+ },
35974
+ "description": "`answers`: the replies the LAST message offered, written by a ```suggestions block\n(`setupSuggestionBlocks`) as a hidden `[data-aparte-suggestions]` mark in that\nmessage. A last message that is the person's, or that offers none, shows none: the\noffer was for the answer it came with."
35975
+ },
35976
+ {
35977
+ "kind": "method",
35978
+ "name": "_showAnswers",
35979
+ "privacy": "private",
35980
+ "return": {
35981
+ "type": {
35982
+ "text": "void"
35983
+ }
35984
+ },
35985
+ "parameters": [
35986
+ {
35987
+ "name": "list",
35988
+ "type": {
35989
+ "text": "AparteSuggestion[]"
35990
+ }
35991
+ }
35992
+ ],
35993
+ "description": "Show these replies; the same ones already shown redraw nothing (a transcript mutation is frequent)."
35994
+ },
35995
+ {
35996
+ "kind": "method",
35997
+ "name": "_setHidden",
35998
+ "privacy": "private",
35999
+ "return": {
36000
+ "type": {
36001
+ "text": "void"
36002
+ }
36003
+ },
36004
+ "parameters": [
36005
+ {
36006
+ "name": "hide",
36007
+ "type": {
36008
+ "text": "boolean"
36009
+ }
36010
+ }
36011
+ ],
36012
+ "description": "Set `hidden`, or lift it only when this element set it: a `hidden` the page wrote stays."
36013
+ },
36014
+ {
36015
+ "kind": "method",
36016
+ "name": "_render",
36017
+ "privacy": "private",
36018
+ "return": {
36019
+ "type": {
36020
+ "text": "void"
36021
+ }
36022
+ }
36023
+ },
36024
+ {
36025
+ "kind": "field",
36026
+ "name": "_sending",
36027
+ "type": {
36028
+ "text": "boolean"
36029
+ },
36030
+ "privacy": "private",
36031
+ "default": "false"
36032
+ },
36033
+ {
36034
+ "kind": "field",
36035
+ "name": "_sendingTimer",
36036
+ "type": {
36037
+ "text": "ReturnType<typeof setTimeout> | undefined"
36038
+ },
36039
+ "privacy": "private"
36040
+ },
36041
+ {
36042
+ "kind": "field",
36043
+ "name": "_stopHolding",
36044
+ "privacy": "private"
36045
+ },
36046
+ {
36047
+ "kind": "field",
36048
+ "name": "_onTurnStart",
36049
+ "privacy": "private",
36050
+ "description": "The latch ends when ITS chat's turn starts. Another chat's `aparte-message-start` crosses the\nwindow too, and must not release it: the second chip would then send a second message while the\nfirst is still being built. The composer's own rule: an event naming no chat is for every chat."
36051
+ },
36052
+ {
36053
+ "kind": "method",
36054
+ "name": "_ownChatId",
36055
+ "privacy": "private",
36056
+ "return": {
36057
+ "type": {
36058
+ "text": "string | undefined"
36059
+ }
36060
+ },
36061
+ "description": "The chat the sending composer belongs to: its `target`, else the id of the chat host above it."
36062
+ },
36063
+ {
36064
+ "kind": "method",
36065
+ "name": "_holdUntilStreaming",
36066
+ "privacy": "private",
36067
+ "return": {
36068
+ "type": {
36069
+ "text": "void"
36070
+ }
36071
+ },
36072
+ "description": "A chip sent: no other chip sends until the turn has started, or a second has passed without one."
36073
+ },
36074
+ {
36075
+ "kind": "method",
36076
+ "name": "_activate",
36077
+ "privacy": "private",
36078
+ "return": {
36079
+ "type": {
36080
+ "text": "void"
36081
+ }
36082
+ },
36083
+ "parameters": [
36084
+ {
36085
+ "name": "suggestion",
36086
+ "type": {
36087
+ "text": "AparteSuggestion"
36088
+ }
36089
+ }
36090
+ ]
36091
+ }
36092
+ ],
36093
+ "events": [
36094
+ {
36095
+ "type": {
36096
+ "text": "CustomEvent<AparteSuggestionEventDetail>"
36097
+ },
36098
+ "description": "A starter was clicked. Bubbles, and is cancelable: `preventDefault()` stops the composer from being filled or submitted.",
36099
+ "name": "aparte-suggestion"
36100
+ }
36101
+ ],
36102
+ "attributes": [
36103
+ {
36104
+ "name": "suggestions",
36105
+ "type": {
36106
+ "text": "string"
36107
+ },
36108
+ "description": "The starters, as a JSON array: strings, or `{ \"label\", \"prompt\" }` objects when the visible label and the sent text differ. The `suggestions` PROPERTY takes the same shape without the JSON."
36109
+ },
36110
+ {
36111
+ "name": "target",
36112
+ "type": {
36113
+ "text": "string"
36114
+ },
36115
+ "description": "The id of the `<aparte-chat>` whose composer should receive the click, when the element is not inside that composer."
36116
+ },
36117
+ {
36118
+ "name": "empty-only",
36119
+ "type": {
36120
+ "text": "boolean"
36121
+ },
36122
+ "description": "Shows the row only while the conversation it serves is empty: hidden (`hidden`) once a message is in its transcript or on its way — a thread being loaded counts — and shown again when the transcript is cleared, by a new chat for instance. The composer's send hides it at once, before its message lands. The element sets and lifts `hidden` itself and never lifts one you set. With no transcript to read — a composer outside any chat — the first send hides it until the attribute is removed."
36123
+ },
36124
+ {
36125
+ "name": "answers",
36126
+ "type": {
36127
+ "text": "boolean"
36128
+ },
36129
+ "description": "Shows the replies the LAST message offered instead of fixed starters: a code block in language `suggestions` in that answer (`setupSuggestionBlocks`), e.g. the free times a booking bot proposes. Written by the model, so a reply sends what its chip shows: its label, never a `prompt`. Empty until an answer offers some, emptied the moment a message is sent, and when the last message is the person's."
36130
+ },
36131
+ {
36132
+ "type": {
36133
+ "text": "string"
36134
+ },
36135
+ "description": "`send` (default): the click fills the composer and submits. `fill`: the click fills the composer and focuses it, so the reader edits first.",
36136
+ "name": "mode"
36137
+ },
36138
+ {
36139
+ "type": {
36140
+ "text": "boolean"
36141
+ },
36142
+ "description": "Reflected BY the element while it has no suggestion to show; the stylesheet hides it then. Read-only, do not set it yourself.",
36143
+ "name": "data-empty"
36144
+ }
36145
+ ],
36146
+ "superclass": {
36147
+ "name": "HTMLElement"
36148
+ },
36149
+ "tagName": "aparte-suggestions",
36150
+ "customElement": true,
36151
+ "examples": [
36152
+ "<!-- The starters sit above the input, inside the composer; a click fills and sends. -->\n<aparte-composer>\n <aparte-suggestions empty-only\n suggestions='[\"What is aparté?\", {\"label\": \"Write a haiku\", \"prompt\": \"Write a haiku about web components.\"}]'>\n </aparte-suggestions>\n <div class=\"aparte-composer-shell\">\n <div class=\"aparte-composer-row\">\n <aparte-composer-input></aparte-composer-input>\n <aparte-composer-send></aparte-composer-send>\n </div>\n </div>\n</aparte-composer>"
36153
+ ]
36154
+ }
36155
+ ],
36156
+ "exports": [
36157
+ {
36158
+ "kind": "js",
36159
+ "name": "AparteSuggestions",
36160
+ "declaration": {
36161
+ "name": "AparteSuggestions",
36162
+ "module": "src/components/suggestions/aparte-suggestions.ts"
36163
+ }
36164
+ },
36165
+ {
36166
+ "kind": "custom-element-definition",
36167
+ "name": "aparte-suggestions",
36168
+ "declaration": {
36169
+ "name": "AparteSuggestions",
36170
+ "module": "src/components/suggestions/aparte-suggestions.ts"
36171
+ }
36172
+ }
36173
+ ]
36174
+ },
36175
+ {
36176
+ "kind": "javascript-module",
36177
+ "path": "src/components/suggestions/index.ts",
36178
+ "declarations": [],
36179
+ "exports": [
36180
+ {
36181
+ "kind": "js",
36182
+ "name": "AparteSuggestions",
36183
+ "declaration": {
36184
+ "name": "AparteSuggestions",
36185
+ "module": "./aparte-suggestions.js"
36186
+ }
36187
+ },
36188
+ {
36189
+ "kind": "js",
36190
+ "name": "setupSuggestionBlocks",
36191
+ "declaration": {
36192
+ "name": "setupSuggestionBlocks",
36193
+ "module": "./suggestion-blocks.js"
36194
+ }
36195
+ },
36196
+ {
36197
+ "kind": "js",
36198
+ "name": "SUGGESTIONS_BLOCK_LANGUAGE",
36199
+ "declaration": {
36200
+ "name": "SUGGESTIONS_BLOCK_LANGUAGE",
36201
+ "module": "./suggestion-blocks.js"
36202
+ }
36203
+ },
36204
+ {
36205
+ "kind": "js",
36206
+ "name": "AparteSuggestion",
36207
+ "declaration": {
36208
+ "name": "AparteSuggestion",
36209
+ "module": "./aparte-suggestions.js"
36210
+ }
36211
+ },
36212
+ {
36213
+ "kind": "js",
36214
+ "name": "AparteSuggestionEventDetail",
36215
+ "declaration": {
36216
+ "name": "AparteSuggestionEventDetail",
36217
+ "module": "./aparte-suggestions.js"
36218
+ }
36219
+ }
36220
+ ]
36221
+ },
36222
+ {
36223
+ "kind": "javascript-module",
36224
+ "path": "src/components/suggestions/suggestion-blocks.ts",
36225
+ "declarations": [
36226
+ {
36227
+ "kind": "variable",
36228
+ "name": "SUGGESTIONS_BLOCK_LANGUAGE",
36229
+ "type": {
36230
+ "text": "string"
36231
+ },
36232
+ "default": "'suggestions'",
36233
+ "description": "The language the block is written in."
36234
+ },
36235
+ {
36236
+ "kind": "function",
36237
+ "name": "visibleReply",
36238
+ "return": {
36239
+ "type": {
36240
+ "text": "string | null"
36241
+ }
36242
+ },
36243
+ "parameters": [
36244
+ {
36245
+ "name": "reply",
36246
+ "type": {
36247
+ "text": "Reply"
36248
+ }
36249
+ }
36250
+ ],
36251
+ "description": "A model-written reply, reduced to what its button shows: the label alone, never a `prompt`.\nRuns of whitespace collapse to one space. `null` for a reply with no label to see (blank),\na label with anything in it that draws nothing or reorders what is drawn (bidi controls,\ntag characters, variation selectors, stray joiners), and a label past 100 characters: what\nis sent must be exactly what the person can read on the chip."
36252
+ },
36253
+ {
36254
+ "kind": "function",
36255
+ "name": "setupSuggestionBlocks",
36256
+ "return": {
36257
+ "type": {
36258
+ "text": "() => void"
36259
+ }
36260
+ },
36261
+ "parameters": [
36262
+ {
36263
+ "name": "config",
36264
+ "default": "aparteGlobalConfig",
36265
+ "type": {
36266
+ "text": "AparteConfig"
36267
+ }
36268
+ }
36269
+ ],
36270
+ "description": "Read the code blocks in language `suggestions` in replies as the replies that\n`<aparte-suggestions answers>` offers. Returns the function that stops it. Off until called: a block is then no longer\nshown as code, so it is the app's choice."
36271
+ }
36272
+ ],
36273
+ "exports": [
36274
+ {
36275
+ "kind": "js",
36276
+ "name": "SUGGESTIONS_BLOCK_LANGUAGE",
36277
+ "declaration": {
36278
+ "name": "SUGGESTIONS_BLOCK_LANGUAGE",
36279
+ "module": "src/components/suggestions/suggestion-blocks.ts"
36280
+ }
36281
+ },
36282
+ {
36283
+ "kind": "js",
36284
+ "name": "visibleReply",
36285
+ "declaration": {
36286
+ "name": "visibleReply",
36287
+ "module": "src/components/suggestions/suggestion-blocks.ts"
36288
+ }
36289
+ },
36290
+ {
36291
+ "kind": "js",
36292
+ "name": "setupSuggestionBlocks",
36293
+ "declaration": {
36294
+ "name": "setupSuggestionBlocks",
36295
+ "module": "src/components/suggestions/suggestion-blocks.ts"
36296
+ }
36297
+ }
36298
+ ]
36299
+ },
34926
36300
  {
34927
36301
  "kind": "javascript-module",
34928
36302
  "path": "src/components/viewport/aparte-chat-viewport.ts",
@@ -35526,6 +36900,25 @@
35526
36900
  ],
35527
36901
  "description": "Append content to a specific segment within a message"
35528
36902
  },
36903
+ {
36904
+ "kind": "field",
36905
+ "name": "_chatId",
36906
+ "type": {
36907
+ "text": "string | undefined"
36908
+ },
36909
+ "privacy": "private",
36910
+ "description": "The chat this viewport is in, while it stays connected — see `appendToSegment`."
36911
+ },
36912
+ {
36913
+ "kind": "method",
36914
+ "name": "_chatIdOnce",
36915
+ "privacy": "private",
36916
+ "return": {
36917
+ "type": {
36918
+ "text": "string | undefined"
36919
+ }
36920
+ }
36921
+ },
35529
36922
  {
35530
36923
  "kind": "method",
35531
36924
  "name": "_activeMessageId",
@@ -36702,11 +38095,11 @@
36702
38095
  "description": "`clearAll()` finished emptying the transcript. No detail."
36703
38096
  },
36704
38097
  {
36705
- "name": "aparte-path-changed",
36706
38098
  "type": {
36707
38099
  "text": "CustomEvent<ApartePathChangedEventDetail>"
36708
38100
  },
36709
- "description": "The active branch path changed, after a retry fork or a navigation."
38101
+ "description": "The active branch path changed, after a retry fork or a navigation.",
38102
+ "name": "aparte-path-changed"
36710
38103
  }
36711
38104
  ],
36712
38105
  "attributes": [
@@ -36791,517 +38184,6 @@
36791
38184
  }
36792
38185
  ]
36793
38186
  },
36794
- {
36795
- "kind": "javascript-module",
36796
- "path": "src/components/suggestions/aparte-suggestions.ts",
36797
- "declarations": [
36798
- {
36799
- "kind": "class",
36800
- "description": "Prompt starters — a row of suggested prompts a reader clicks instead of typing.\n\nEvery chat product opens on three or four of these. This element is that pattern\ndone once, wearing the button recipe.\n\nA click goes THROUGH the composer — `setValue()` then `submit()` — never a synthetic\n`aparte-send`. The composer's `submit()` is where every gate lives (disabled, already\nstreaming, `requireModelSelection`), and a chip that bypassed them could send a\nrequest with an empty model id while the composer was visibly greyed out. So the\nelement needs a composer: the nearest `<aparte-composer>` ancestor, else the one\nserving the chat named by `target`, else the first one in the document.\n\nCore honours the click alone, so it is live by default. `aparte-suggestion` fires first and is cancelable — `preventDefault()`\nleaves the composer untouched, for an app that wants the prompt for itself.\n\nIt declares no custom property of its own: the gap comes from the global\n`--aparte-space-*` tokens and the chips from the `aparte-btn` recipe, so it inherits\na theme rather than exposing knobs to re-set.",
36801
- "name": "AparteSuggestions",
36802
- "members": [
36803
- {
36804
- "kind": "field",
36805
- "name": "_suggestions",
36806
- "type": {
36807
- "text": "AparteSuggestion[]"
36808
- },
36809
- "privacy": "private",
36810
- "default": "[]"
36811
- },
36812
- {
36813
- "kind": "field",
36814
- "name": "_composer",
36815
- "type": {
36816
- "text": "AparteComposer | null"
36817
- },
36818
- "privacy": "private",
36819
- "default": "null"
36820
- },
36821
- {
36822
- "kind": "field",
36823
- "name": "_transcript",
36824
- "type": {
36825
- "text": "Element | null"
36826
- },
36827
- "privacy": "private",
36828
- "default": "null",
36829
- "description": "The viewport of the chat this row serves, while `empty-only` follows it."
36830
- },
36831
- {
36832
- "kind": "field",
36833
- "name": "_transcriptObserver",
36834
- "type": {
36835
- "text": "MutationObserver | null"
36836
- },
36837
- "privacy": "private",
36838
- "default": "null"
36839
- },
36840
- {
36841
- "kind": "field",
36842
- "name": "_sent",
36843
- "type": {
36844
- "text": "boolean"
36845
- },
36846
- "privacy": "private",
36847
- "default": "false",
36848
- "description": "The composer sent since the transcript was last seen empty."
36849
- },
36850
- {
36851
- "kind": "field",
36852
- "name": "_wasEmpty",
36853
- "type": {
36854
- "text": "boolean"
36855
- },
36856
- "privacy": "private",
36857
- "default": "true"
36858
- },
36859
- {
36860
- "kind": "field",
36861
- "name": "_hidOwn",
36862
- "type": {
36863
- "text": "boolean"
36864
- },
36865
- "privacy": "private",
36866
- "default": "false",
36867
- "description": "`hidden` was written by this element, so it is this element's to lift."
36868
- },
36869
- {
36870
- "kind": "field",
36871
- "name": "_onSend",
36872
- "privacy": "private"
36873
- },
36874
- {
36875
- "kind": "field",
36876
- "name": "_applyEmptyOnly",
36877
- "privacy": "private"
36878
- },
36879
- {
36880
- "kind": "field",
36881
- "name": "_onConfigChange",
36882
- "privacy": "private"
36883
- },
36884
- {
36885
- "kind": "field",
36886
- "name": "suggestions",
36887
- "type": {
36888
- "text": "AparteSuggestion[]"
36889
- },
36890
- "description": "Takes the array, or the JSON string the attribute documents.\n\nBoth, because both arrive: React 19 and Svelte assign the PROPERTY whenever the\nelement has one of that name, so `<aparte-suggestions suggestions='[…]'>` — the\ndocumented spelling, typed valid by both wrappers — reaches this setter as a\nstring while the attribute (and so `attributeChangedCallback`) is never written."
36891
- },
36892
- {
36893
- "kind": "method",
36894
- "name": "_groupLabel",
36895
- "privacy": "private",
36896
- "return": {
36897
- "type": {
36898
- "text": "string"
36899
- }
36900
- }
36901
- },
36902
- {
36903
- "kind": "field",
36904
- "name": "_parsed",
36905
- "type": {
36906
- "text": "string | null"
36907
- },
36908
- "privacy": "private",
36909
- "default": "null"
36910
- },
36911
- {
36912
- "kind": "method",
36913
- "name": "_readAttribute",
36914
- "privacy": "private",
36915
- "return": {
36916
- "type": {
36917
- "text": "void"
36918
- }
36919
- },
36920
- "description": "Parse the `suggestions` attribute once per value. The attribute callback and\n`connectedCallback` both arrive for a parsed element, in an order the parser\ndecides; without this, an invalid value warned twice."
36921
- },
36922
- {
36923
- "kind": "method",
36924
- "name": "_resolveComposer",
36925
- "privacy": "private",
36926
- "return": {
36927
- "type": {
36928
- "text": "AparteComposer | null"
36929
- }
36930
- },
36931
- "description": "The composer the click goes through, resolved the way the composer's own parts\nresolve it — by ancestry first. Outside a composer, `target` names the chat and the\ncomposer serving it is either inside that chat or points at it; the first composer\non the page is the last resort, so the one-chat page needs no attribute at all."
36932
- },
36933
- {
36934
- "kind": "method",
36935
- "name": "_watchComposer",
36936
- "privacy": "private",
36937
- "return": {
36938
- "type": {
36939
- "text": "void"
36940
- }
36941
- }
36942
- },
36943
- {
36944
- "kind": "method",
36945
- "name": "_resolveTranscript",
36946
- "privacy": "private",
36947
- "return": {
36948
- "type": {
36949
- "text": "Element | null"
36950
- }
36951
- },
36952
- "description": "The transcript of the chat the click goes to: the chat around the composer, else\nthe one around this element, else the one `target` names (here, or on that\ncomposer). No last resort on the page, unlike the composer's: following another\nchat's transcript would be worse than following none, which falls back to the send."
36953
- },
36954
- {
36955
- "kind": "method",
36956
- "name": "_watchTranscript",
36957
- "privacy": "private",
36958
- "return": {
36959
- "type": {
36960
- "text": "void"
36961
- }
36962
- },
36963
- "description": "Follow the transcript while `empty-only` or `answers` is set, and stop following it when neither is."
36964
- },
36965
- {
36966
- "kind": "field",
36967
- "name": "_onTranscript",
36968
- "privacy": "private"
36969
- },
36970
- {
36971
- "kind": "method",
36972
- "name": "_applyAnswers",
36973
- "privacy": "private",
36974
- "return": {
36975
- "type": {
36976
- "text": "void"
36977
- }
36978
- },
36979
- "description": "`answers`: the replies the LAST message offered, written by a ```suggestions block\n(`setupSuggestionBlocks`) as a hidden `[data-aparte-suggestions]` mark in that\nmessage. A last message that is the person's, or that offers none, shows none: the\noffer was for the answer it came with."
36980
- },
36981
- {
36982
- "kind": "method",
36983
- "name": "_showAnswers",
36984
- "privacy": "private",
36985
- "return": {
36986
- "type": {
36987
- "text": "void"
36988
- }
36989
- },
36990
- "parameters": [
36991
- {
36992
- "name": "list",
36993
- "type": {
36994
- "text": "AparteSuggestion[]"
36995
- }
36996
- }
36997
- ],
36998
- "description": "Show these replies; the same ones already shown redraw nothing (a transcript mutation is frequent)."
36999
- },
37000
- {
37001
- "kind": "method",
37002
- "name": "_setHidden",
37003
- "privacy": "private",
37004
- "return": {
37005
- "type": {
37006
- "text": "void"
37007
- }
37008
- },
37009
- "parameters": [
37010
- {
37011
- "name": "hide",
37012
- "type": {
37013
- "text": "boolean"
37014
- }
37015
- }
37016
- ],
37017
- "description": "Set `hidden`, or lift it only when this element set it: a `hidden` the page wrote stays."
37018
- },
37019
- {
37020
- "kind": "method",
37021
- "name": "_render",
37022
- "privacy": "private",
37023
- "return": {
37024
- "type": {
37025
- "text": "void"
37026
- }
37027
- }
37028
- },
37029
- {
37030
- "kind": "field",
37031
- "name": "_sending",
37032
- "type": {
37033
- "text": "boolean"
37034
- },
37035
- "privacy": "private",
37036
- "default": "false"
37037
- },
37038
- {
37039
- "kind": "field",
37040
- "name": "_sendingTimer",
37041
- "type": {
37042
- "text": "ReturnType<typeof setTimeout> | undefined"
37043
- },
37044
- "privacy": "private"
37045
- },
37046
- {
37047
- "kind": "field",
37048
- "name": "_stopHolding",
37049
- "privacy": "private"
37050
- },
37051
- {
37052
- "kind": "field",
37053
- "name": "_onTurnStart",
37054
- "privacy": "private",
37055
- "description": "The latch ends when ITS chat's turn starts. Another chat's `aparte-message-start` crosses the\nwindow too, and must not release it: the second chip would then send a second message while the\nfirst is still being built. The composer's own rule: an event naming no chat is for every chat."
37056
- },
37057
- {
37058
- "kind": "method",
37059
- "name": "_ownChatId",
37060
- "privacy": "private",
37061
- "return": {
37062
- "type": {
37063
- "text": "string | undefined"
37064
- }
37065
- },
37066
- "description": "The chat the sending composer belongs to: its `target`, else the id of the chat host above it."
37067
- },
37068
- {
37069
- "kind": "method",
37070
- "name": "_holdUntilStreaming",
37071
- "privacy": "private",
37072
- "return": {
37073
- "type": {
37074
- "text": "void"
37075
- }
37076
- },
37077
- "description": "A chip sent: no other chip sends until the turn has started, or a second has passed without one."
37078
- },
37079
- {
37080
- "kind": "method",
37081
- "name": "_activate",
37082
- "privacy": "private",
37083
- "return": {
37084
- "type": {
37085
- "text": "void"
37086
- }
37087
- },
37088
- "parameters": [
37089
- {
37090
- "name": "suggestion",
37091
- "type": {
37092
- "text": "AparteSuggestion"
37093
- }
37094
- }
37095
- ]
37096
- }
37097
- ],
37098
- "events": [
37099
- {
37100
- "name": "aparte-suggestion",
37101
- "type": {
37102
- "text": "CustomEvent<AparteSuggestionEventDetail>"
37103
- },
37104
- "description": "A starter was clicked. Bubbles, and is cancelable: `preventDefault()` stops the composer from being filled or submitted."
37105
- }
37106
- ],
37107
- "attributes": [
37108
- {
37109
- "name": "suggestions",
37110
- "type": {
37111
- "text": "string"
37112
- },
37113
- "description": "The starters, as a JSON array: strings, or `{ \"label\", \"prompt\" }` objects when the visible label and the sent text differ. The `suggestions` PROPERTY takes the same shape without the JSON."
37114
- },
37115
- {
37116
- "name": "target",
37117
- "type": {
37118
- "text": "string"
37119
- },
37120
- "description": "The id of the `<aparte-chat>` whose composer should receive the click, when the element is not inside that composer."
37121
- },
37122
- {
37123
- "name": "empty-only",
37124
- "type": {
37125
- "text": "boolean"
37126
- },
37127
- "description": "Shows the row only while the conversation it serves is empty: hidden (`hidden`) once a message is in its transcript or on its way — a thread being loaded counts — and shown again when the transcript is cleared, by a new chat for instance. The composer's send hides it at once, before its message lands. The element sets and lifts `hidden` itself and never lifts one you set. With no transcript to read — a composer outside any chat — the first send hides it until the attribute is removed."
37128
- },
37129
- {
37130
- "name": "answers",
37131
- "type": {
37132
- "text": "boolean"
37133
- },
37134
- "description": "Shows the replies the LAST message offered instead of fixed starters: a code block in language `suggestions` in that answer (`setupSuggestionBlocks`), e.g. the free times a booking bot proposes. Written by the model, so a reply sends what its chip shows: its label, never a `prompt`. Empty until an answer offers some, emptied the moment a message is sent, and when the last message is the person's."
37135
- },
37136
- {
37137
- "type": {
37138
- "text": "string"
37139
- },
37140
- "description": "`send` (default): the click fills the composer and submits. `fill`: the click fills the composer and focuses it, so the reader edits first.",
37141
- "name": "mode"
37142
- },
37143
- {
37144
- "type": {
37145
- "text": "boolean"
37146
- },
37147
- "description": "Reflected BY the element while it has no suggestion to show; the stylesheet hides it then. Read-only, do not set it yourself.",
37148
- "name": "data-empty"
37149
- }
37150
- ],
37151
- "superclass": {
37152
- "name": "HTMLElement"
37153
- },
37154
- "tagName": "aparte-suggestions",
37155
- "customElement": true,
37156
- "examples": [
37157
- "<!-- The starters sit above the input, inside the composer; a click fills and sends. -->\n<aparte-composer>\n <aparte-suggestions empty-only\n suggestions='[\"What is aparté?\", {\"label\": \"Write a haiku\", \"prompt\": \"Write a haiku about web components.\"}]'>\n </aparte-suggestions>\n <div class=\"aparte-composer-shell\">\n <div class=\"aparte-composer-row\">\n <aparte-composer-input></aparte-composer-input>\n <aparte-composer-send></aparte-composer-send>\n </div>\n </div>\n</aparte-composer>"
37158
- ]
37159
- }
37160
- ],
37161
- "exports": [
37162
- {
37163
- "kind": "js",
37164
- "name": "AparteSuggestions",
37165
- "declaration": {
37166
- "name": "AparteSuggestions",
37167
- "module": "src/components/suggestions/aparte-suggestions.ts"
37168
- }
37169
- },
37170
- {
37171
- "kind": "custom-element-definition",
37172
- "name": "aparte-suggestions",
37173
- "declaration": {
37174
- "name": "AparteSuggestions",
37175
- "module": "src/components/suggestions/aparte-suggestions.ts"
37176
- }
37177
- }
37178
- ]
37179
- },
37180
- {
37181
- "kind": "javascript-module",
37182
- "path": "src/components/suggestions/index.ts",
37183
- "declarations": [],
37184
- "exports": [
37185
- {
37186
- "kind": "js",
37187
- "name": "AparteSuggestions",
37188
- "declaration": {
37189
- "name": "AparteSuggestions",
37190
- "module": "./aparte-suggestions.js"
37191
- }
37192
- },
37193
- {
37194
- "kind": "js",
37195
- "name": "setupSuggestionBlocks",
37196
- "declaration": {
37197
- "name": "setupSuggestionBlocks",
37198
- "module": "./suggestion-blocks.js"
37199
- }
37200
- },
37201
- {
37202
- "kind": "js",
37203
- "name": "SUGGESTIONS_BLOCK_LANGUAGE",
37204
- "declaration": {
37205
- "name": "SUGGESTIONS_BLOCK_LANGUAGE",
37206
- "module": "./suggestion-blocks.js"
37207
- }
37208
- },
37209
- {
37210
- "kind": "js",
37211
- "name": "AparteSuggestion",
37212
- "declaration": {
37213
- "name": "AparteSuggestion",
37214
- "module": "./aparte-suggestions.js"
37215
- }
37216
- },
37217
- {
37218
- "kind": "js",
37219
- "name": "AparteSuggestionEventDetail",
37220
- "declaration": {
37221
- "name": "AparteSuggestionEventDetail",
37222
- "module": "./aparte-suggestions.js"
37223
- }
37224
- }
37225
- ]
37226
- },
37227
- {
37228
- "kind": "javascript-module",
37229
- "path": "src/components/suggestions/suggestion-blocks.ts",
37230
- "declarations": [
37231
- {
37232
- "kind": "variable",
37233
- "name": "SUGGESTIONS_BLOCK_LANGUAGE",
37234
- "type": {
37235
- "text": "string"
37236
- },
37237
- "default": "'suggestions'",
37238
- "description": "The language the block is written in."
37239
- },
37240
- {
37241
- "kind": "function",
37242
- "name": "visibleReply",
37243
- "return": {
37244
- "type": {
37245
- "text": "string | null"
37246
- }
37247
- },
37248
- "parameters": [
37249
- {
37250
- "name": "reply",
37251
- "type": {
37252
- "text": "Reply"
37253
- }
37254
- }
37255
- ],
37256
- "description": "A model-written reply, reduced to what its button shows: the label alone, never a `prompt`.\nRuns of whitespace collapse to one space. `null` for a reply with no label to see (blank),\na label with anything in it that draws nothing or reorders what is drawn (bidi controls,\ntag characters, variation selectors, stray joiners), and a label past 100 characters: what\nis sent must be exactly what the person can read on the chip."
37257
- },
37258
- {
37259
- "kind": "function",
37260
- "name": "setupSuggestionBlocks",
37261
- "return": {
37262
- "type": {
37263
- "text": "() => void"
37264
- }
37265
- },
37266
- "parameters": [
37267
- {
37268
- "name": "config",
37269
- "default": "aparteGlobalConfig",
37270
- "type": {
37271
- "text": "AparteConfig"
37272
- }
37273
- }
37274
- ],
37275
- "description": "Read the code blocks in language `suggestions` in replies as the replies that\n`<aparte-suggestions answers>` offers. Returns the function that stops it. Off until called: a block is then no longer\nshown as code, so it is the app's choice."
37276
- }
37277
- ],
37278
- "exports": [
37279
- {
37280
- "kind": "js",
37281
- "name": "SUGGESTIONS_BLOCK_LANGUAGE",
37282
- "declaration": {
37283
- "name": "SUGGESTIONS_BLOCK_LANGUAGE",
37284
- "module": "src/components/suggestions/suggestion-blocks.ts"
37285
- }
37286
- },
37287
- {
37288
- "kind": "js",
37289
- "name": "visibleReply",
37290
- "declaration": {
37291
- "name": "visibleReply",
37292
- "module": "src/components/suggestions/suggestion-blocks.ts"
37293
- }
37294
- },
37295
- {
37296
- "kind": "js",
37297
- "name": "setupSuggestionBlocks",
37298
- "declaration": {
37299
- "name": "setupSuggestionBlocks",
37300
- "module": "src/components/suggestions/suggestion-blocks.ts"
37301
- }
37302
- }
37303
- ]
37304
- },
37305
38187
  {
37306
38188
  "kind": "javascript-module",
37307
38189
  "path": "src/primitives/icon/aparte-icon.ts",