@aparte/core 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/dist/client/agent-runner.d.ts.map +1 -1
  2. package/dist/client/aparte-client.d.ts +6 -0
  3. package/dist/client/aparte-client.d.ts.map +1 -1
  4. package/dist/client/stream-adapter.d.ts +72 -2
  5. package/dist/client/stream-adapter.d.ts.map +1 -1
  6. package/dist/client/wire-history.d.ts +5 -2
  7. package/dist/client/wire-history.d.ts.map +1 -1
  8. package/dist/components/bubble/aparte-chat-bubble.d.ts +15 -1
  9. package/dist/components/bubble/aparte-chat-bubble.d.ts.map +1 -1
  10. package/dist/components/conversation-list/aparte-conversation-list.d.ts +46 -22
  11. package/dist/components/conversation-list/aparte-conversation-list.d.ts.map +1 -1
  12. package/dist/components/viewport/aparte-chat-viewport.d.ts +10 -0
  13. package/dist/components/viewport/aparte-chat-viewport.d.ts.map +1 -1
  14. package/dist/config/aparte-config.d.ts +112 -4
  15. package/dist/config/aparte-config.d.ts.map +1 -1
  16. package/dist/config/bubble-shell-renderer.d.ts +3 -0
  17. package/dist/config/bubble-shell-renderer.d.ts.map +1 -1
  18. package/dist/config/index.d.ts +1 -1
  19. package/dist/config/index.d.ts.map +1 -1
  20. package/dist/config/locale.d.ts +9 -0
  21. package/dist/config/locale.d.ts.map +1 -1
  22. package/dist/custom-elements.json +1233 -77
  23. package/dist/{defer-hydration-lK-7XQXf.js → defer-hydration-o5MFsc_Z.js} +730 -237
  24. package/dist/defer-hydration-o5MFsc_Z.js.map +1 -0
  25. package/dist/elicitation/panel.d.ts.map +1 -1
  26. package/dist/host/aparte-chat-host.d.ts +8 -0
  27. package/dist/host/aparte-chat-host.d.ts.map +1 -1
  28. package/dist/index.css +1 -1
  29. package/dist/index.d.ts +11 -3
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +278 -211
  32. package/dist/index.js.map +1 -1
  33. package/dist/index.node.d.ts +11 -3
  34. package/dist/index.node.d.ts.map +1 -1
  35. package/dist/index.node.js +46 -36
  36. package/dist/index.node.js.map +1 -1
  37. package/dist/kit-keyboard-BUSLQ5i4.js +434 -0
  38. package/dist/kit-keyboard-BUSLQ5i4.js.map +1 -0
  39. package/dist/renderers/segment-renderers.d.ts.map +1 -1
  40. package/dist/renderers/segments/activity.d.ts +5 -0
  41. package/dist/renderers/segments/activity.d.ts.map +1 -0
  42. package/dist/renderers/segments/tool-call.d.ts.map +1 -1
  43. package/dist/transport/agent-handler.d.ts.map +1 -1
  44. package/dist/types/chat.d.ts +22 -0
  45. package/dist/types/chat.d.ts.map +1 -1
  46. package/dist/types/event-map.d.ts +4 -0
  47. package/dist/types/event-map.d.ts.map +1 -1
  48. package/dist/types/index.d.ts +2 -2
  49. package/dist/types/index.d.ts.map +1 -1
  50. package/dist/types/segments.d.ts +53 -1
  51. package/dist/types/segments.d.ts.map +1 -1
  52. package/dist/types/tools.d.ts +67 -1
  53. package/dist/types/tools.d.ts.map +1 -1
  54. package/dist/utils/menu.d.ts +90 -0
  55. package/dist/utils/menu.d.ts.map +1 -0
  56. package/dist/utils/segment-list.d.ts +49 -0
  57. package/dist/utils/segment-list.d.ts.map +1 -0
  58. package/dist/utils/tabs.d.ts +49 -0
  59. package/dist/utils/tabs.d.ts.map +1 -0
  60. package/dist/utils/tool-line.d.ts +36 -9
  61. package/dist/utils/tool-line.d.ts.map +1 -1
  62. package/package.json +2 -2
  63. package/dist/defer-hydration-lK-7XQXf.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"event-map.d.ts","sourceRoot":"","sources":["../../src/types/event-map.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"event-map.d.ts","sourceRoot":"","sources":["../../src/types/event-map.ts"],"names":[],"mappings":"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"}
@@ -11,12 +11,12 @@ export type { AparteStreamBlock, AparteStreamBlockMatch } from './stream-blocks.
11
11
  export type { AparteCompactor, AparteCompactorRequest, AparteCompactorOutcome, AparteCompactorReason } from './compactor.js';
12
12
  export type { AparteSendEventDetail, AparteSiblingInfo, AparteBranchNavigateEventDetail, AparteLinkClickEventDetail, ApartePathChangedEventDetail, AparteRetryEventDetail, AparteEditEventDetail, AparteFeedbackEventDetail, AparteFeedbackReasonEventDetail, AparteCollectCommandsEventDetail, AparteTriggerSelectEventDetail, AparteCommand, AparteCommandScope, AparteCommandContext, AparteActionEventDetail } from './events.js';
13
13
  export type { AparteContentParser, AparteParserRegistry } from './parsers.js';
14
- export type { AparteSegmentBase, AparteSegmentDefaults, AparteSegmentTiming, AparteTextSegment, AparteSource, AparteCitation, AparteThinkingSegment, AparteCodeSegment, AparteErrorSegment, AparteSegment, AparteSegmentTypes, AparteCustomSegment, AparteToolCallSegment, AparteSegmentType, AparteSegmentRenderer, AparteSegmentMount, AparteSegmentUpdateEventDetail } from './segments.js';
14
+ export type { AparteSegmentBase, AparteSegmentDefaults, AparteSegmentTiming, AparteTextSegment, AparteSource, AparteCitation, AparteThinkingSegment, AparteCodeSegment, AparteErrorSegment, AparteSegment, AparteSegmentTypes, AparteCustomSegment, AparteToolCallSegment, AparteActivitySegment, AparteActivityRenderer, AparteSegmentType, AparteSegmentRenderer, AparteSegmentMount, AparteSegmentUpdateEventDetail } from './segments.js';
15
15
  export type { AparteThemeVariables } from './theming.js';
16
16
  export type { AparteAIModel, AparteAIProvider, AparteAIProviderMetadata, AparteAIProviderConfigField, AparteAIProviderConfigSchema, AparteModelConfig, ModelStatus, ModelLoadProgress } from './model-provider.js';
17
17
  export type { AparteChatRequest, AparteRequestMeta, AparteChatResponse, AparteChatMessage, AparteContentPart, AparteTextPart, AparteImagePart, AparteStreamEvent, AparteStreamEventMap, AparteUsage, AparteFinishReason } from './chat.js';
18
18
  export { contentToText } from './chat.js';
19
- export type { AparteTool, AparteToolCall, AparteApprovalPolicy, AparteApprovalRuling, AparteToolResult, AparteToolHandler, AparteToolContext, AparteToolRenderer, AparteToolSummary, AparteToolInputFormatter, AparteToolMatcher, AparteToolDisplay, AparteToolDetails, AparteToolCallView, AparteMountedView, AparteToolMount, AparteToolApprovalRequestDetail, } from './tools.js';
19
+ export type { AparteTool, AparteToolCall, AparteApprovalPolicy, AparteApprovalRuling, AparteToolResult, AparteToolHandler, AparteToolContext, AparteToolRun, AparteToolRenderer, AparteToolSummary, AparteToolInputFormatter, AparteToolMatcher, AparteToolDisplay, AparteToolDetails, AparteToolLine, AparteToolLineOpen, AparteToolCallView, AparteMountedView, AparteToolMount, AparteToolApprovalRequestDetail, } from './tools.js';
20
20
  export { AparteErrorCode, AparteError } from './errors.js';
21
21
  export type { AparteModelChangeEventDetail, AparteApprovalModeChangeEventDetail, AparteMessageDoneEventDetail, AparteMessageStartEventDetail, AparteMessageErrorEventDetail, AparteMessageAbortedEventDetail, AparteMessagePausedEventDetail, AparteMessageResumedEventDetail, AparteAbortEventDetail, AparteCompactEventDetail, AparteCompactDoneEventDetail, AparteCompactStartEventDetail, AparteCompactErrorEventDetail, AparteAttachmentPreviewEventDetail, AparteMessageInfoEventDetail, } from './events.js';
22
22
  export type { AparteElementAttributes, AparteElementTagName, AparteAttrValue, AparteTemplateAttrs, AparteNoAttributes, AparteChatAttributes, AparteChatViewportAttributes, AparteChatBubbleAttributes, AparteChatStatusAttributes, AparteComposerAttributes, AparteComposerInputAttributes, AparteComposerActionAttributes, AparteComposerAddAttachmentAttributes, AparteComposerToolbarAttributes, AparteConversationListAttributes, AparteSelectAttributes, AparteOptionAttributes, AparteOptgroupAttributes, AparteProgressSpinnerAttributes, AparteContextAttributes, AparteIconAttributes, AparteScrollRailAttributes, AparteSidebarAttributes, AparteSplitAttributes, AparteLauncherAttributes, AparteSuggestionsAttributes } from './element-attributes.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
@@ -348,13 +348,65 @@ export interface AparteCustomSegment extends AparteSegmentBase {
348
348
  /** Arbitrary data payload for the component */
349
349
  data?: unknown;
350
350
  }
351
+ /**
352
+ * An agent's activity — structured progress it reports while it works ("3 of 5 sources
353
+ * read"), placed in the reply where it first arrived and updated in place each time the
354
+ * agent sends it again. The stream carries it as an `activity` run event (AG-UI's
355
+ * `ACTIVITY_SNAPSHOT` / `ACTIVITY_DELTA`, a model stream, a sub-agent), always whole.
356
+ *
357
+ * Drawn by the renderer the app registers for its `activityType`
358
+ * (`config.registerActivityRenderer`). With none, it is kept on the message and draws
359
+ * nothing. Never sent to the model.
360
+ *
361
+ * @example
362
+ * {
363
+ * id: 'activity-a1',
364
+ * type: 'activity',
365
+ * activityId: 'a1',
366
+ * activityType: 'search-progress',
367
+ * content: { read: 3, of: 5 },
368
+ * }
369
+ */
370
+ export interface AparteActivitySegment extends AparteSegmentBase {
371
+ type: 'activity';
372
+ /** The activity's own id, as the agent named it: a later event with this id updates this segment. */
373
+ activityId: string;
374
+ /** What kind of activity it is — the agent's vocabulary, and the key its renderer is registered under. */
375
+ activityType: string;
376
+ /** Its whole current value, as the agent sent it last. Untrusted: the agent chose it. */
377
+ content: unknown;
378
+ }
379
+ /**
380
+ * How one type of activity is drawn — `config.registerActivityRenderer(type, renderer)`.
381
+ * The same contract as a segment renderer, for one `activityType`.
382
+ *
383
+ * `content` is whatever the agent sent: untrusted. Return an **HTMLElement** and set
384
+ * `textContent`, or return a **string** and escape every value you interpolate
385
+ * (`escapeHtml`). Keep one root element: core finds it again by its segment's id.
386
+ */
387
+ export interface AparteActivityRenderer {
388
+ /** Draw the activity, as a DOM element or an HTML string. An empty string draws nothing. */
389
+ render(segment: AparteActivitySegment): string | HTMLElement;
390
+ /** After `render`, with its element: listeners, a framework mount. */
391
+ setup?(element: HTMLElement, segment: AparteActivitySegment): void;
392
+ /**
393
+ * The agent sent the activity again: patch `element` in place. Without it, core draws it
394
+ * again from `render()` on every change, which loses whatever the element held (a focused
395
+ * control, an opened disclosure).
396
+ */
397
+ update?(element: HTMLElement, segment: AparteActivitySegment): void;
398
+ /** Re-read the locale or the icon provider without adding or removing a child node. */
399
+ relabel?(element: HTMLElement, segment: AparteActivitySegment): void;
400
+ /** The element leaves the page for good: unmount what `setup` mounted. */
401
+ cleanup?(element: HTMLElement, segment: AparteActivitySegment): void;
402
+ }
351
403
  /**
352
404
  * All built-in segment types. An `artifact` is not one of them any more: it is a
353
405
  * convention an app teaches its model, and `@aparte/plugin-artifacts` registers its
354
406
  * segment — a `type` of its own, through `registerSegmentRenderer` and
355
407
  * `registerStreamBlock` — the way any consumer registers a `chart` or a `citation`.
356
408
  */
357
- export type AparteSegment = AparteTextSegment | AparteThinkingSegment | AparteCodeSegment | AparteErrorSegment | AparteCustomSegment | AparteToolCallSegment | AparteSegmentTypes[keyof AparteSegmentTypes];
409
+ export type AparteSegment = AparteTextSegment | AparteThinkingSegment | AparteCodeSegment | AparteErrorSegment | AparteCustomSegment | AparteToolCallSegment | AparteActivitySegment | AparteSegmentTypes[keyof AparteSegmentTypes];
358
410
  /**
359
411
  * The segment types an app or a plugin adds, one key per `type`, merged into this interface;
360
412
  * each one joins {@link AparteSegment}, so `addSegment`, `appendMessage` and
@@ -1 +1 @@
1
- {"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/types/segments.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/types/segments.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,7 @@
4
4
  */
5
5
  import type { AparteToolCallSegment } from './segments.js';
6
6
  import type { AparteIconName } from '../config/icon-provider.js';
7
+ import type { StreamToolRun } from '@aparte/engine';
7
8
  /** Definition of a tool the AI can call */
8
9
  export interface AparteTool {
9
10
  name: string;
@@ -51,6 +52,8 @@ export interface AparteToolApprovalRequestDetail {
51
52
  toolCallId: string;
52
53
  toolName: string;
53
54
  input: Record<string, unknown>;
55
+ /** The sub-agent whose call this is; absent for the reply's own. */
56
+ agentId?: string;
54
57
  }
55
58
  /** A tool call emitted by the AI during streaming */
56
59
  export interface AparteToolCall {
@@ -135,7 +138,18 @@ export interface AparteToolContext {
135
138
  * through the DOM — a handler running in a worker, or one reading a provider.
136
139
  */
137
140
  config?: unknown;
141
+ /**
142
+ * The run this call belongs to, for a handler that opens a sub-agent: pass it to
143
+ * `runSubAgent`. The loop supplies it, in the page and on the server; a browser tool
144
+ * answering a paused server run has none.
145
+ */
146
+ run?: AparteToolRun;
138
147
  }
148
+ /**
149
+ * The run a tool call belongs to — engine's `StreamToolRun`. Handed to a handler as
150
+ * `context.run`; what `runSubAgent` opens a sub-agent from.
151
+ */
152
+ export type AparteToolRun = StreamToolRun;
139
153
  /**
140
154
  * What a call targets, in one line: the text the DEFAULT tool row shows after the
141
155
  * tool's name — `read_file skills.json` rather than `read_file` alone.
@@ -237,11 +251,63 @@ export interface AparteToolDisplay {
237
251
  * markup that is harmless but can still mislead. Return `''` for nothing behind the
238
252
  * line yet: no disclosure, which appears once there is something (a result, say).
239
253
  *
254
+ * `held` is the element this row shows behind its line now, when the function returned one
255
+ * the last time it was asked for this row: hand it back to keep it, and what the reader did
256
+ * in it (a fold opened, a field half written). It is absent on a row's first drawing, so an
257
+ * element is never shared by two rows drawing the same call (a reply and a pane beside it),
258
+ * and nothing needs keeping once the row is gone.
259
+ *
240
260
  * A function that throws costs the row its detail, never its line, and never falls back
241
261
  * to the raw Input and Output. Register the same function rather than a new closure each
242
262
  * time: a different `details` redraws the messages on screen.
243
263
  */
244
- export type AparteToolDetails = (segment: AparteToolCallSegment) => HTMLElement | string;
264
+ export type AparteToolDetails = (segment: AparteToolCallSegment, held?: HTMLElement) => HTMLElement | string;
265
+ /**
266
+ * What a tool-line provider says about one call — `AparteConfig.setToolLineProvider`. A
267
+ * plugin that knows more about a call than its name (what ran it, what it is doing now)
268
+ * fills the default row with it; every field is plain text, never HTML, and every field is
269
+ * optional.
270
+ *
271
+ * The app's display always wins, field by field: `label` and `target` are read only when
272
+ * the display gives none, and `details` only when the display has no `details` key.
273
+ * `activity` and `note` have no display field of their own.
274
+ */
275
+ export interface AparteToolLine {
276
+ /** What the call goes by, when the display declares no label. */
277
+ label?: string;
278
+ /** What the call targets, when the display declares no summary. */
279
+ target?: string;
280
+ /**
281
+ * A second line under the name: what the call is doing now, and once it is over what it
282
+ * did, in every state the provider gives it. Give it for the call's whole life, or never:
283
+ * a line that comes and goes changes the row's height, and every row under it moves.
284
+ */
285
+ activity?: string;
286
+ /** A short trailing text, after the state word, in every state: "3 tools · 12 s". */
287
+ note?: string;
288
+ /** What is behind the line, when the display has no `details` key. */
289
+ details?: false | AparteToolDetails;
290
+ /**
291
+ * Somewhere else the call can be opened: a pane beside the chat that shows what it stands
292
+ * for. Core draws an Open button at the end of the line and calls `onOpen` when it is
293
+ * pressed (click, Enter, Space). A row with nothing behind it also opens on a click
294
+ * anywhere on its line; a row with a disclosure keeps its line for the disclosure, so one
295
+ * click never means two things. Left out, nothing: no button, no pointer.
296
+ */
297
+ open?: AparteToolLineOpen;
298
+ }
299
+ /** What a tool line opens elsewhere — {@link AparteToolLine.open}. */
300
+ export interface AparteToolLineOpen {
301
+ /** The Open button's accessible name and tooltip, in the reader's language ("Open Researcher"). Plain text. */
302
+ label: string;
303
+ /** Called with the row when the reader opens it. */
304
+ onOpen: (row: HTMLElement) => void;
305
+ /**
306
+ * What the call stands for is the one open elsewhere now: the button carries
307
+ * `aria-current="true"` and the row `data-current`, so a reader sees which one is shown.
308
+ */
309
+ current?: boolean;
310
+ }
245
311
  /**
246
312
  * Per-tool segment renderer.
247
313
  * Registered via aparteGlobalConfig.registerToolRenderer(toolName, renderer).
@@ -1 +1 @@
1
- {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,90 @@
1
+ import { type AparteFloatingOptions } from './place-floating.js';
2
+ /** What `enhanceMenu` takes besides its two elements: where the menu goes, and two hooks. */
3
+ export interface AparteMenuOptions extends AparteFloatingOptions {
4
+ /**
5
+ * Called as the menu is about to open, before it shows: fill it here when its items
6
+ * depend on the moment. Return `false` to keep it closed.
7
+ */
8
+ onOpen?: () => boolean | void;
9
+ /** Called once the menu has closed, whatever closed it. */
10
+ onClose?: () => void;
11
+ }
12
+ /** What `enhanceContextMenu` takes besides its two elements. */
13
+ export interface AparteContextMenuOptions {
14
+ /** Distance from the focused element when a key opens it, in px. At the pointer it opens on the spot. */
15
+ gap?: number;
16
+ /** Room kept free at the edges of the window, in px. Default 8. */
17
+ margin?: number;
18
+ /** The writing direction is right to left. Read from the region when left out. */
19
+ rtl?: boolean;
20
+ /**
21
+ * Called as the menu is about to open, with the element it was asked about: the one
22
+ * under the pointer, or the focused one for a key. Fill the menu for it here. Return
23
+ * `false` to keep it closed and leave the browser its own menu.
24
+ */
25
+ onOpen?: (target: Element) => boolean | void;
26
+ /** Called once the menu has closed, whatever closed it. */
27
+ onClose?: () => void;
28
+ }
29
+ /**
30
+ * The item chosen in a menu that `enhanceMenu` or `enhanceContextMenu` drives. Dispatched
31
+ * on the menu before it closes; `preventDefault()` keeps it open. A checkbox or radio item
32
+ * is not ticked for you: set its `aria-checked` here.
33
+ *
34
+ * @event aparte-menu-select
35
+ */
36
+ export interface AparteMenuSelectDetail {
37
+ /** The item, or the other button inside the menu, that was pressed. */
38
+ item: HTMLElement;
39
+ }
40
+ /** An item a reader can reach: not `disabled`, not `aria-disabled`, not hidden. */
41
+ export declare function usableIn(el: HTMLElement, root: HTMLElement): boolean;
42
+ /**
43
+ * Drives a menu drawn with the kit (`.aparte-menu`, `role="menuitem"` items) from the button
44
+ * that opens it, the way the WAI-ARIA menu button pattern asks, and returns the function that
45
+ * stops it.
46
+ *
47
+ * The button opens it on a click (so Enter and Space, which click a button), ArrowDown (on the
48
+ * first item) and ArrowUp (on the last). Inside, the arrows move and wrap round, Home and End
49
+ * jump to the ends, and a letter moves to the next item that starts with it; an item that is
50
+ * `disabled`, `aria-disabled="true"` or hidden is passed over. Escape closes it and puts the
51
+ * focus back on the button; Tab closes it and moves on from the button. A press outside, the
52
+ * focus leaving or a resize close it, and so does a scroll that moves the button (the page, a
53
+ * list it is in) — not one beside it, such as a reply streaming in. One menu is open at a time.
54
+ *
55
+ * Choosing an item fires `aparte-menu-select` on the menu with `{ item }`, then closes it and
56
+ * puts the focus back. A `menuitemcheckbox` or `menuitemradio` is not ticked for you: set its
57
+ * `aria-checked` in that listener. `preventDefault()` on the event keeps the menu open.
58
+ *
59
+ * The menu is shown and hidden with `hidden`, and placed with `placeFloating` against the
60
+ * button, fixed to the window. To open or close it from code, call `trigger.click()`.
61
+ *
62
+ * Touches no DOM until it is called, so it can be imported on a server.
63
+ *
64
+ * @example
65
+ * const release = enhanceMenu(button, menu, { align: 'end' });
66
+ * menu.addEventListener('aparte-menu-select', (e) => run(e.detail.item.dataset.action));
67
+ * // later, when the menu goes away:
68
+ * release();
69
+ */
70
+ export declare function enhanceMenu(trigger: HTMLElement, menu: HTMLElement, options?: AparteMenuOptions): () => void;
71
+ /**
72
+ * The same menu as `enhanceMenu`, opened by a right click, Shift+F10 or the Menu key inside
73
+ * `region` — at the pointer for a click, under the focused element for a key — and returns
74
+ * the function that stops it. One menu serves the whole region: `onOpen(target)` says which
75
+ * element it was asked about, so the menu can be filled for that row.
76
+ *
77
+ * Inside, it behaves as `enhanceMenu`'s does: the same keys, the same `aparte-menu-select`,
78
+ * the same ways to close. Escape puts the focus back on the element that had it.
79
+ *
80
+ * @example
81
+ * const release = enhanceContextMenu(list, menu, {
82
+ * onOpen: (target) => {
83
+ * const row = target.closest('[data-id]');
84
+ * if (!row) return false; // not a row: the browser keeps its own menu
85
+ * menu.dataset.for = row.dataset.id;
86
+ * },
87
+ * });
88
+ */
89
+ export declare function enhanceContextMenu(region: HTMLElement, menu: HTMLElement, options?: AparteContextMenuOptions): () => void;
90
+ //# sourceMappingURL=menu.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/utils/menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,6FAA6F;AAC7F,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC5D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,wBAAwB;IACrC,yGAAyG;IACzG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAC;IAC7C,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACnC,uEAAuE;IACvE,IAAI,EAAE,WAAW,CAAC;CACrB;AA6BD,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAIpE;AA2PD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,IAAI,CA+ChH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,wBAA6B,GAAG,MAAM,IAAI,CAkD7H"}
@@ -0,0 +1,49 @@
1
+ /**
2
+ * A list of segments that is not a message: what a stream adapter can write into when what it
3
+ * writes is not the reply on screen — a sub-agent's conversation, kept on the call that opened
4
+ * it, or anything a plugin draws apart from the transcript.
5
+ *
6
+ * It stamps what joins it exactly as the two owners of a message's array do (`segments.ts`),
7
+ * so a segment that lives here carries the same identity and the same measurements: `index`
8
+ * is its position in THIS list, `startedAt` the moment it joined, `endedAt` the moment its
9
+ * content last arrived. A list handed over at creation is adopted, not inserted: a list saved
10
+ * while it ran comes back settled — nothing streaming, an open call stopped — and no time is
11
+ * invented for it.
12
+ *
13
+ * DOM-free, so the SSR barrel carries it and a plugin's wiring can be tested in Node.
14
+ */
15
+ import type { AparteConfig } from '../config/aparte-config.js';
16
+ import type { StreamAdapterTarget } from '../client/stream-adapter.js';
17
+ import type { AparteSegment } from '../types/index.js';
18
+ /**
19
+ * A segment list a stream adapter writes into (`createStreamAdapter({ target: list, … })`):
20
+ * its segments, and a way to hear each change.
21
+ */
22
+ export interface AparteSegmentList extends StreamAdapterTarget {
23
+ /** The segments, in order. A new array after every change; never mutate it. */
24
+ readonly segments: readonly AparteSegment[];
25
+ /** Called after each segment added or updated. Returns the function that stops it. */
26
+ onChange(fn: () => void): () => void;
27
+ }
28
+ /**
29
+ * A segment list a stream adapter can write into, stamped like a message's.
30
+ *
31
+ * `messageId` is the id stamped on each segment — the message the list belongs to. With a
32
+ * `config`, a segment joining the list takes that config's segment defaults
33
+ * (`setSegmentDefaults`), as it would in a chat. `segments` is a list saved earlier, adopted.
34
+ *
35
+ * `addSegment` and `updateSegment` are the writes; `updateMessage` and `setUsage` do nothing
36
+ * (there is no message here), and `dispatchEvent` dispatches nothing: the events of the run
37
+ * are the caller's to hear, with `observeRunEvents`.
38
+ *
39
+ * @example
40
+ * const list = createSegmentList({ messageId });
41
+ * const adapter = createStreamAdapter({ target: list, config, messageId });
42
+ * list.onChange(() => draw(list.segments));
43
+ */
44
+ export declare function createSegmentList(opts: {
45
+ messageId: string;
46
+ segments?: readonly AparteSegment[];
47
+ config?: AparteConfig;
48
+ }): AparteSegmentList;
49
+ //# sourceMappingURL=segment-list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"segment-list.d.ts","sourceRoot":"","sources":["../../src/utils/segment-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC1D,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACxC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB,GAAG,iBAAiB,CA+CpB"}
@@ -0,0 +1,49 @@
1
+ /** What `enhanceTabs` takes besides the tablist. */
2
+ export interface AparteTabsOptions {
3
+ /**
4
+ * `automatic` (the default): an arrow key selects the tab it moves to. `manual`: the
5
+ * arrows only move the focus, and Enter or Space selects — for a panel that is slow to show.
6
+ */
7
+ activation?: 'automatic' | 'manual';
8
+ }
9
+ /**
10
+ * A tab about to be selected in a tablist that `enhanceTabs` drives. Dispatched on the
11
+ * tablist before the panels change, so a listener can fill or measure them;
12
+ * `preventDefault()` keeps the current tab.
13
+ *
14
+ * @event aparte-tab-change
15
+ */
16
+ export interface AparteTabChangeDetail {
17
+ /** The tab being selected. */
18
+ tab: HTMLElement;
19
+ /** The panel it controls (`aria-controls`), still hidden; `null` when it names none. */
20
+ panel: HTMLElement | null;
21
+ /** The tab that was selected until now. */
22
+ previous: HTMLElement | null;
23
+ }
24
+ /**
25
+ * Drives a row of tabs drawn with the kit (`role="tablist"`, `role="tab"` buttons with
26
+ * `aria-controls`), the way the WAI-ARIA tabs pattern asks, and returns the function that
27
+ * stops it.
28
+ *
29
+ * The row is one tab stop: the selected tab has `tabindex="0"`, the others `-1`. ArrowRight
30
+ * and ArrowLeft move to the next and the previous tab and wrap round — the other way round in
31
+ * a right-to-left row — or ArrowDown and ArrowUp when the list says
32
+ * `aria-orientation="vertical"`. Home and End go to the ends. A tab that is `disabled`,
33
+ * `aria-disabled="true"` or hidden is passed over. A click selects too.
34
+ *
35
+ * Selecting sets `aria-selected`, moves the tab stop, shows the panel the tab's
36
+ * `aria-controls` names and puts `hidden` on the others. `aparte-tab-change` fires on the
37
+ * tablist just before, with `{ tab, panel, previous }`; `preventDefault()` keeps the current
38
+ * tab. To select a tab from code, call its `click()`.
39
+ *
40
+ * With nothing marked `aria-selected="true"`, the first tab that can be used is selected.
41
+ * Touches no DOM until it is called, so it can be imported on a server.
42
+ *
43
+ * @example
44
+ * const release = enhanceTabs(document.querySelector('[role="tablist"]'));
45
+ * // later, when the tabs go away:
46
+ * release();
47
+ */
48
+ export declare function enhanceTabs(tablist: HTMLElement, options?: AparteTabsOptions): () => void;
49
+ //# sourceMappingURL=tabs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/utils/tabs.ts"],"names":[],"mappings":"AAGA,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IAClC,8BAA8B;IAC9B,GAAG,EAAE,WAAW,CAAC;IACjB,wFAAwF;IACxF,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,IAAI,CA4F7F"}
@@ -4,20 +4,47 @@
4
4
  * `tool-input.ts` exists for the arguments).
5
5
  */
6
6
  import type { AparteConfig } from '../config/aparte-config.js';
7
- import type { AparteToolCallSegment } from '../types/index.js';
7
+ import type { AparteToolCallSegment, AparteToolLine } from '../types/index.js';
8
8
  /**
9
- * The name a call goes by: the label its display declares (`registerToolDisplay`), else
10
- * the identifier — the app's wire format, which core never turns into words on its own.
11
- * A label that throws or says nothing costs the call its label, not its render.
9
+ * What the config's tool-line provider says about this call (`setToolLineProvider`), or
10
+ * `undefined` when there is none, it says nothing, or it throws — the default line then.
11
+ * Called at every draw, update and relabel, never stored: its words follow the locale.
12
12
  */
13
- export declare function toolNameOf(segment: AparteToolCallSegment, config: AparteConfig): {
13
+ export declare function toolLineOf(segment: AparteToolCallSegment, config: AparteConfig): AparteToolLine | undefined;
14
+ /**
15
+ * The name a call goes by: the label its display declares (`registerToolDisplay`), else the
16
+ * label the tool-line provider gives, else the identifier — the app's wire format, which
17
+ * core never turns into words on its own. A label that throws or says nothing costs the
18
+ * call its label, not its render.
19
+ *
20
+ * `line` is the provider's answer when the caller already asked for it (the row asks once
21
+ * per draw); left out, it is asked here.
22
+ */
23
+ export declare function toolNameOf(segment: AparteToolCallSegment, config: AparteConfig, line?: AparteToolLine | undefined): {
14
24
  text: string;
15
25
  isLabel: boolean;
16
26
  };
17
27
  /**
18
- * What a call targets, from the summary its display declares — `''` when there is none,
19
- * or when it throws: a summary reads model-chosen input, and a bad one must cost the call
20
- * its one line, not the bubble its render.
28
+ * What a call targets, from the summary its display declares, else the target the
29
+ * tool-line provider gives — `''` when neither says anything, or when the summary throws:
30
+ * a summary reads model-chosen input, and a bad one must cost the call its one line, not
31
+ * the bubble its render.
32
+ */
33
+ export declare function toolTargetOf(segment: AparteToolCallSegment, config: AparteConfig, line?: AparteToolLine | undefined): string;
34
+ /**
35
+ * The target and where it came from: `isWords` when the tool-line provider gave it (a
36
+ * sentence for a person — a sub-agent's task), not the app's summary, which is read off the
37
+ * arguments (a path, a command) and keeps the code face on an agent's row.
38
+ */
39
+ export declare function toolTargetPartsOf(segment: AparteToolCallSegment, config: AparteConfig, line?: AparteToolLine | undefined): {
40
+ text: string;
41
+ isWords: boolean;
42
+ };
43
+ /**
44
+ * The row's second line, from the tool-line provider, in every state it gives one: what the
45
+ * call is doing now, and once it is over what it did. Core says nothing there on its own.
21
46
  */
22
- export declare function toolTargetOf(segment: AparteToolCallSegment, config: AparteConfig): string;
47
+ export declare function toolActivityOf(_segment: AparteToolCallSegment, line: AparteToolLine | undefined): string;
48
+ /** The provider's trailing note, in every state. */
49
+ export declare function toolLineNoteOf(line: AparteToolLine | undefined): string;
23
50
  //# sourceMappingURL=tool-line.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tool-line.d.ts","sourceRoot":"","sources":["../../src/utils/tool-line.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAUnH;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CASzF"}
1
+ {"version":3,"file":"tool-line.d.ts","sourceRoot":"","sources":["../../src/utils/tool-line.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAK/E;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAa3G;AAKD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,cAAc,GAAG,SAAuC,GAC/D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAYpC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,cAAc,GAAG,SAAuC,GAC/D,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,cAAc,GAAG,SAAuC,GAC/D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAUpC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAIxG;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAEvE"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aparte/core",
3
- "version": "1.5.0",
3
+ "version": "1.7.0",
4
4
  "homepage": "https://apartejs.dev/",
5
5
  "description": "AI chat Web Components with the agent loop inside: your OpenAI-compatible backend, approved tool calls, generative UI cards. Zero third-party deps.",
6
6
  "type": "module",
@@ -80,7 +80,7 @@
80
80
  "node": ">=18"
81
81
  },
82
82
  "dependencies": {
83
- "@aparte/engine": "1.5.0"
83
+ "@aparte/engine": "1.7.0"
84
84
  },
85
85
  "devDependencies": {
86
86
  "@custom-elements-manifest/analyzer": "^0.11.0",