@aceshooting/lyra-ui 4.2.0 → 5.1.0

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.class.js

@@ -0,0 +1,429 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html, nothing } from 'lit';
+import { property, state } from 'lit/decorators.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { activateOverlay } from '../../../internal/overlay-manager.js';
+import { lockScroll } from '../../../internal/scroll-lock.js';
+import { nextId, srOnly } from '../../../internal/a11y.js';
+import { styles } from './tool-select-dialog.styles.js';
+import '../../forms/checkbox/checkbox.class.js';
+import '../../forms/switch/switch.class.js';
+/**
+ * String-aware boolean attribute converter for `spellcheck`. Lit's built-in `type: Boolean`
+ * converter is presence-based -- the attribute's mere presence (regardless of its string value)
+ * maps to `true`, so a plain-markup consumer writing the literal `spellcheck="false"` would
+ * actually get `true` (this property's default), the opposite of what that string reads as -- the
+ * same bug class `<lr-textarea>`'s `spellcheckConverter` and `<lr-model-select>`'s identical
+ * converter document and fix.
+ */
+const spellcheckConverter = {
+    fromAttribute(value) {
+        return value !== 'false';
+    },
+    toAttribute(value) {
+        // `true` is this property's default, so there's nothing worth reflecting for it; only the
+        // non-default `false` needs an attribute at all.
+        return value ? null : 'false';
+    },
+};
+const OTHER_CATEGORY = 'Other';
+/** Default `filter`: case-insensitive substring match against the tool's name and description. */
+function defaultFilter(tool, query) {
+    return tool.name.toLowerCase().includes(query) || (tool.description ?? '').toLowerCase().includes(query);
+}
+/**
+ * `<lr-tool-select-dialog>` — a category-grouped, filterable, searchable
+ * tool-enablement dialog for picking which agent tools are available in a
+ * conversation.
+ *
+ * This renders its own dialog panel rather than nesting a `<lr-dialog>` in
+ * its shadow template. Shared overlay infrastructure coordinates stacking,
+ * focus trapping, Escape/backdrop dismissal, and focus return with every
+ * other overlay in the same document.
+ *
+ * `useDefaults` is a single top-level switch: while `true`, every per-tool
+ * checkbox below renders disabled (still reflecting whatever `selected`
+ * holds — a consumer should populate that with its own default tool set
+ * whenever `useDefaults` is true) and a hint explains that turning the
+ * switch off is how to customize. Turning it off is the "customize"
+ * affordance — it's the only thing that both flips `useDefaults` to `false`
+ * *and* unlocks the per-tool checkboxes for editing, so there's exactly one
+ * control for that transition rather than a separate button duplicating it.
+ *
+ * There is no built-in footer/close button — like `<lr-dialog>`, dismissal
+ * happens via Escape, a backdrop click, or a consumer's own `footer`-slotted
+ * action calling `close()`. This also means the search input is the very
+ * first focusable element in the panel with no special-casing needed, so
+ * it's what receives focus on open (see `updated()`).
+ *
+ * @customElement lr-tool-select-dialog
+ * @slot footer - Optional action buttons (e.g. a "Done" button), rendered in a bottom row.
+ * Changes already apply live via `lr-change`, so this is optional.
+ * @event lr-change - The enabled-tool selection or the `useDefaults` toggle changed.
+ * `detail: { selected: string[], useDefaults: boolean }`.
+ * @event lr-close - `detail: ToolSelectDialogCloseReason`. Fired exactly once per dismissal,
+ * via Escape, a backdrop click, or a `close()` call.
+ * @csspart backdrop - The full-viewport scrim behind the panel.
+ * @csspart panel - The dialog panel itself (`role="dialog"` while open).
+ * @csspart header - The wrapper around the title/subtitle.
+ * @csspart title - The dialog's heading.
+ * @csspart subtitle - The "N of M tools enabled" summary line.
+ * @csspart search-row - The wrapper around the search input.
+ * @csspart search-input - The filter text input.
+ * @csspart defaults-row - The wrapper around the use-defaults switch and its hint.
+ * @csspart defaults-toggle - The built-in `<lr-switch>` bound to `useDefaults`.
+ * @csspart defaults-hint - The "turn off to customize" hint, shown only while `useDefaults` is true.
+ * @csspart body - The scrollable wrapper around the grouped tool list.
+ * @csspart empty - The "no tools" / "no matches" message.
+ * @csspart category - A single category's wrapper (`role="group"`).
+ * @csspart category-heading - A category's heading.
+ * @csspart category-count - The terse, `aria-hidden` tool count next to a category heading
+ * (the heading's accessible name gets the full sentence from an sr-only sibling instead).
+ * @csspart category-list - The `<ul>` of tool rows within a category.
+ * @csspart tool-row - A single tool's `<li>` row.
+ * @csspart tool-checkbox - A row's `<lr-checkbox>`.
+ * @csspart tool-name - A row's name text (plus its `icon`, if set).
+ * @csspart tool-icon - A row's leading icon glyph, when `icon` is set.
+ * @csspart tool-description - A row's optional description text.
+ * @csspart tool-disabled-reason - A disabled row's `disabledReason` text, slotted inside
+ * `tool-checkbox` (alongside `tool-name`/`tool-description`) so it contributes to the
+ * checkbox's accessible name/description instead of going unannounced.
+ * @csspart footer - The wrapper around the `footer` slot.
+ * @cssprop [--lr-tool-select-dialog-overlay-color=var(--lr-color-overlay)] - Backdrop scrim color.
+ */
+export class LyraToolSelectDialog extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Whether the dialog is open. Set this (or call `close()`) — there is no separate `show()`/`hide()` pair. */
+        this.open = false;
+        /** The full set of tools a consumer offers, across all categories. */
+        this.tools = [];
+        /** The currently-enabled tool ids. */
+        this.selected = [];
+        /** Whether the conversation is using the default tool set (`true`) or a custom selection (`false`) — see the class doc for the exact interaction with `selected`/per-tool editing. */
+        this.useDefaults = false;
+        /** The dialog's visible heading and accessible name. */
+        this.label = 'Select tools';
+        /** Overrides the dialog panel's accessible name, taking precedence over the visible `label`
+         *  heading -- mirrors `<lr-dialog>`'s/`<lr-tool-result-dialog>`'s own host-`aria-label`
+         *  override pattern. Fed only by a host `aria-label`. */
+        this.accessibleLabel = null;
+        this.searchPlaceholder = 'Search tools…';
+        /** Native editing-assistance and virtual-keyboard hints forwarded to the search input. */
+        this.autocomplete = '';
+        this.spellcheck = true;
+        this.autocapitalize = '';
+        this.autoCorrect = '';
+        this.inputMode = '';
+        this.enterKeyHint = '';
+        /** Overrides the built-in case-insensitive name/description substring match. */
+        this.filter = null;
+        this.query = '';
+        this.hasFooterSlot = false;
+        this.titleId = nextId('tool-select-dialog-title');
+        // Stable per-category heading ids, keyed by category name -- generated
+        // once (not regenerated every render/keystroke) so a category's
+        // aria-labelledby target keeps the same id across re-renders.
+        this.categoryIds = new Map();
+        this.onFooterSlotChange = (e) => {
+            this.hasFooterSlot = e.target.assignedElements({ flatten: true }).length > 0;
+        };
+        this.onBackdropClick = () => {
+            this.overlay?.dismissBackdrop();
+        };
+        this.onSearchInput = (e) => {
+            this.query = e.target.value;
+        };
+        this.onSearchFocus = () => { this.emit('focus'); };
+        this.onSearchBlur = () => { this.emit('blur'); };
+        this.onDefaultsToggle = (e) => {
+            this.useDefaults = e.detail.checked;
+            this.emitChange();
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles, srOnly]; }
+    willUpdate(changed) {
+        if (!this.hasUpdated) {
+            this.hasFooterSlot = Array.from(this.children).some((el) => el.getAttribute('slot') === 'footer');
+        }
+        if (changed.has('open')) {
+            if (this.open) {
+                this.releaseScrollLock ??= lockScroll(this.ownerDocument);
+                this.activateOverlay();
+            }
+            else {
+                this.releaseScrollLock?.();
+                this.releaseScrollLock = undefined;
+                this.overlay?.deactivate();
+                this.overlay = undefined;
+                // Otherwise a long-lived instance reopens still showing whatever
+                // search filter/collapsed-category state the previous session left
+                // behind, rather than the fresh, unfiltered list a reopen implies.
+                this.query = '';
+            }
+        }
+    }
+    // Runs after render (not willUpdate) so [part="panel"] and its contents
+    // have already landed in the DOM before the focus call below can rely on
+    // them -- mirrors lr-dialog's/lr-tool-result-dialog's identical
+    // ordering rationale.
+    updated(changed) {
+        if (changed.has('open') && this.open) {
+            this.overlay?.focusInitial();
+        }
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (this.hasUpdated && this.open) {
+            this.releaseScrollLock ??= lockScroll(this.ownerDocument);
+            this.activateOverlay();
+            queueMicrotask(() => this.overlay?.focusInitial());
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.releaseScrollLock?.();
+        this.releaseScrollLock = undefined;
+        this.overlay?.suspend();
+    }
+    activateOverlay() {
+        if (this.overlay?.isActive()) {
+            this.overlay.resume();
+            return;
+        }
+        this.overlay = activateOverlay({
+            host: this,
+            panel: () => this.shadowRoot?.querySelector('[part="panel"]') ?? null,
+            onEscape: () => this.close('escape'),
+            onBackdrop: () => this.close('backdrop'),
+        });
+    }
+    /**
+     * Close the dialog and return focus to whatever had it before the dialog
+     * opened. `reason` is forwarded as the `lr-close` detail — built-in
+     * triggers pass `'escape'`/`'backdrop'`; a consumer's own close affordance
+     * (e.g. a footer Done button) should call this directly with its own
+     * reason string, so every dismissal path funnels through the same event
+     * instead of the consumer having to also toggle `open` itself.
+     */
+    close(reason = 'api') {
+        if (!this.open)
+            return;
+        this.open = false;
+        this.emit('lr-close', reason);
+    }
+    emitChange() {
+        this.emit('lr-change', {
+            selected: [...this.selected],
+            useDefaults: this.useDefaults,
+        });
+    }
+    onToolToggle(tool, e) {
+        const set = new Set(this.selected);
+        e.detail.checked ? set.add(tool.id) : set.delete(tool.id);
+        this.selected = [...set];
+        this.emitChange();
+    }
+    categoryId(category) {
+        let id = this.categoryIds.get(category);
+        if (!id) {
+            id = nextId('tool-select-dialog-category');
+            this.categoryIds.set(category, id);
+        }
+        return id;
+    }
+    /** Tools grouped by `category` (first-seen order), with an uncategorized
+     *  bucket always last, then filtered by the active search query -- a
+     *  category left with zero matches is dropped entirely rather than
+     *  rendered as an empty heading. */
+    get groups() {
+        const order = [];
+        const byCategory = new Map();
+        for (const tool of this.tools) {
+            const category = tool.category?.trim() || OTHER_CATEGORY;
+            let bucket = byCategory.get(category);
+            if (!bucket) {
+                bucket = [];
+                byCategory.set(category, bucket);
+                if (category !== OTHER_CATEGORY)
+                    order.push(category);
+            }
+            bucket.push(tool);
+        }
+        if (byCategory.has(OTHER_CATEGORY))
+            order.push(OTHER_CATEGORY);
+        const q = this.query.trim().toLowerCase();
+        const matches = q ? (tool) => (this.filter ?? defaultFilter)(tool, q) : () => true;
+        return order
+            .map((category) => ({ category, tools: byCategory.get(category).filter(matches) }))
+            .filter((group) => group.tools.length > 0);
+    }
+    renderTool(tool) {
+        const rowDisabled = Boolean(tool.disabled) || this.useDefaults;
+        return html `
+      <li part="tool-row" ?data-disabled=${rowDisabled}>
+        <lr-checkbox
+          part="tool-checkbox"
+          value=${tool.id}
+          ?checked=${this.selected.includes(tool.id)}
+          ?disabled=${rowDisabled}
+          @lr-change=${(e) => this.onToolToggle(tool, e)}
+        >
+          <span part="tool-name">
+            ${tool.icon ? html `<span part="tool-icon" aria-hidden="true">${tool.icon}</span>` : nothing}${tool.name}
+          </span>
+          ${tool.description ? html `<span part="tool-description">${tool.description}</span>` : nothing}
+          ${tool.disabled && tool.disabledReason
+            ? html `<span part="tool-disabled-reason">${tool.disabledReason}</span>`
+            : nothing}
+        </lr-checkbox>
+      </li>
+    `;
+    }
+    renderCategory(group) {
+        const headingId = this.categoryId(group.category);
+        return html `
+      <div part="category" role="group" aria-labelledby=${headingId}>
+        <h3 part="category-heading" id=${headingId}>
+          ${group.category === OTHER_CATEGORY ? this.localize('otherCategory') : group.category}<span
+            part="category-count"
+            aria-hidden="true"
+            >${group.tools.length}</span
+          ><span class="sr-only"
+            >${this.localize(group.tools.length === 1 ? 'toolCount' : 'toolCountPlural', undefined, {
+            count: group.tools.length,
+        })}</span
+          >
+        </h3>
+        <ul part="category-list">
+          ${group.tools.map((tool) => this.renderTool(tool))}
+        </ul>
+      </div>
+    `;
+    }
+    render() {
+        const groups = this.groups;
+        const hasTools = this.tools.length > 0;
+        const label = this.localize('selectTools', this.label === 'Select tools' ? undefined : this.label);
+        const searchPlaceholder = this.localize('searchToolsPlaceholder', this.searchPlaceholder === 'Search tools…' ? undefined : this.searchPlaceholder);
+        return html `
+      <div part="backdrop" @click=${this.onBackdropClick}></div>
+      <div
+        part="panel"
+        role=${this.open ? 'dialog' : nothing}
+        aria-modal=${this.open ? 'true' : nothing}
+        aria-label=${this.accessibleLabel || nothing}
+        aria-labelledby=${this.accessibleLabel ? nothing : this.titleId}
+        tabindex="-1"
+      >
+        <div part="header">
+          <h2 part="title" id=${this.titleId}>${label}</h2>
+          <p
+            part="subtitle"
+            ?hidden=${!hasTools}
+            >${this.localize('toolSelectSummary', undefined, {
+            selected: this.selected.length,
+            total: this.tools.length,
+        })}</p
+          >
+        </div>
+        <div part="search-row">
+          <input
+            part="search-input"
+            type="search"
+            .value=${this.query}
+            placeholder=${searchPlaceholder}
+            aria-label=${searchPlaceholder}
+            autocomplete=${this.autocomplete || nothing}
+            .spellcheck=${this.spellcheck}
+            autocapitalize=${this.autocapitalize || nothing}
+            autocorrect=${this.autoCorrect || nothing}
+            inputmode=${this.inputMode || nothing}
+            enterkeyhint=${this.enterKeyHint || nothing}
+            @input=${this.onSearchInput}
+            @focus=${this.onSearchFocus}
+            @blur=${this.onSearchBlur}
+          />
+        </div>
+        <div part="defaults-row">
+          <lr-switch
+            part="defaults-toggle"
+            ?checked=${this.useDefaults}
+            @lr-change=${this.onDefaultsToggle}
+          >
+            ${this.localize('useDefaultTools')}
+          </lr-switch>
+          ${this.useDefaults
+            ? html `<p part="defaults-hint">${this.localize('toolSelectCustomizeHint')}</p>`
+            : nothing}
+        </div>
+        <div part="body">
+          ${groups.length === 0
+            ? html `<p part="empty">
+                ${hasTools
+                ? this.localize('noMatchesQuery', undefined, { query: this.query })
+                : this.localize('toolSelectNoneAvailable')}
+              </p>`
+            : groups.map((group) => this.renderCategory(group))}
+        </div>
+        <div part="footer" ?hidden=${!this.hasFooterSlot}>
+          <slot name="footer" @slotchange=${this.onFooterSlotChange}></slot>
+        </div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraToolSelectDialog.prototype, "open", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraToolSelectDialog.prototype, "tools", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraToolSelectDialog.prototype, "selected", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'use-defaults' })
+], LyraToolSelectDialog.prototype, "useDefaults", void 0);
+__decorate([
+    property()
+], LyraToolSelectDialog.prototype, "label", void 0);
+__decorate([
+    property({ attribute: 'aria-label' })
+], LyraToolSelectDialog.prototype, "accessibleLabel", void 0);
+__decorate([
+    property({ attribute: 'search-placeholder' })
+], LyraToolSelectDialog.prototype, "searchPlaceholder", void 0);
+__decorate([
+    property()
+], LyraToolSelectDialog.prototype, "autocomplete", void 0);
+__decorate([
+    property({ converter: spellcheckConverter })
+], LyraToolSelectDialog.prototype, "spellcheck", void 0);
+__decorate([
+    property()
+], LyraToolSelectDialog.prototype, "autocapitalize", void 0);
+__decorate([
+    property({ attribute: 'autocorrect' })
+], LyraToolSelectDialog.prototype, "autoCorrect", void 0);
+__decorate([
+    property({ attribute: 'inputmode' })
+], LyraToolSelectDialog.prototype, "inputMode", void 0);
+__decorate([
+    property({ attribute: 'enterkeyhint' })
+], LyraToolSelectDialog.prototype, "enterKeyHint", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraToolSelectDialog.prototype, "filter", void 0);
+__decorate([
+    state()
+], LyraToolSelectDialog.prototype, "query", void 0);
+__decorate([
+    state()
+], LyraToolSelectDialog.prototype, "hasFooterSlot", void 0);
+//# sourceMappingURL=tool-select-dialog.class.js.map

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-select-dialog.class.js","sourceRoot":"","sources":["../../../../src/components/agent-tools/tool-select-dialog/tool-select-dialog.class.ts"],"names":[],"mappings":"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"}

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.d.ts

@@ -0,0 +1,4 @@
+export * from './tool-select-dialog.class.js';
+import "../../forms/checkbox/checkbox.js";
+import "../../forms/switch/switch.js";
+//# sourceMappingURL=tool-select-dialog.d.ts.map

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-select-dialog.d.ts","sourceRoot":"","sources":["../../../../src/components/agent-tools/tool-select-dialog/tool-select-dialog.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAG9C,OAAO,kCAAkC,CAAC;AAC1C,OAAO,8BAA8B,CAAC"}

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.js

@@ -0,0 +1,7 @@
+export * from './tool-select-dialog.class.js';
+import { LyraToolSelectDialog } from './tool-select-dialog.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+import "../../forms/checkbox/checkbox.js";
+import "../../forms/switch/switch.js";
+defineElement('tool-select-dialog', LyraToolSelectDialog);
+//# sourceMappingURL=tool-select-dialog.js.map

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-select-dialog.js","sourceRoot":"","sources":["../../../../src/components/agent-tools/tool-select-dialog/tool-select-dialog.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,kCAAkC,CAAC;AAC1C,OAAO,8BAA8B,CAAC;AACtC,aAAa,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-select-dialog.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/agent-tools/tool-select-dialog/tool-select-dialog.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAgMlB,CAAC"}

package/dist/components/agent-tools/tool-select-dialog/tool-select-dialog.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-select-dialog.styles.js","sourceRoot":"","sources":["../../../../src/components/agent-tools/tool-select-dialog/tool-select-dialog.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgMxB,CAAC"}

package/dist/components/agent-tools/tool-timeline/tool-timeline.class.d.ts

@@ -0,0 +1,142 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import type { ToolInvocation, ToolApprovalEventDetail } from '../../../ai/types.js';
+import '../tool-call-chip/tool-call-chip.js';
+import '../tool-result-view/tool-result-view.js';
+import '../tool-approval-dialog/tool-approval-dialog.js';
+import '../../layout/details/details.js';
+/**
+ * One entry in a `<lr-tool-timeline>`. Extends `ToolInvocation` (`src/ai/types.ts`) with exactly
+ * the timeline-specific fields the roadmap calls for that a bare invocation record doesn't carry
+ * on its own: when the call ran (`startedAt`/`endedAt`, from which duration is derived), how many
+ * times it was retried before landing on its current `status`, which of its `args`/`result`/
+ * `error` fields should render masked, and a human-in-the-loop approval decision. The inherited
+ * `ToolInvocation` fields still assign directly onto `<lr-tool-call-chip>`/`<lr-tool-result-view>`
+ * with no adapter, exactly as `ToolInvocation` itself already does.
+ */
+export interface ToolTimelineEntry extends ToolInvocation {
+    /** Epoch milliseconds the call started. Entries are ordered by this field (ascending); an entry
+     *  with no `startedAt` sorts after every timed entry, keeping its relative position among any
+     *  other untimed entries, and renders with no visible timestamp. */
+    startedAt?: number;
+    /** Epoch milliseconds the call reached a terminal state. Paired with `startedAt` to derive the
+     *  duration handed to `<lr-tool-call-chip>`'s own `durationMs` -- omitted (or paired with no
+     *  `startedAt`) while still pending/running, or whenever the duration isn't known. */
+    endedAt?: number;
+    /** Number of retry attempts before this entry's current `status` -- `2` means the call reached
+     *  its current state on its third try. Omitted or `0` renders no retry indicator. */
+    retryCount?: number;
+    /** Dotted field paths within `args`/`result`/`error` to mask in the rendered detail view, e.g.
+     *  `['args.apiKey', 'result.rows.0.ssn']`, or the bare `'args'`/`'result'`/`'error'` to mask an
+     *  entire branch. A path with no matching field is a no-op, never a thrown error. Never applied
+     *  to the copy of `args` handed to the approval dialog -- see the class doc's approval note. */
+    redactedFields?: string[];
+    /** Whether this call is gated behind a human approval decision. While `true` and `approved` is
+     *  still `undefined`, activating the entry's chip opens the shared approval dialog instead of
+     *  merely firing the chip's own selection event. */
+    needsApproval?: boolean;
+    /** The approval decision, once made. `undefined` means still pending a decision. */
+    approved?: boolean;
+}
+/**
+ * `detail` for `lr-tool-approval-decide` -- extends the shared `ToolApprovalEventDetail`
+ * (`src/ai/types.ts`) with the (possibly host-edited) `args` the approval dialog produced,
+ * present only when `approved` is `true`. A listener that only cares about the shared
+ * `{ invocationId, approved }` shape can ignore `args` entirely; one driving actual tool
+ * execution needs it, since the dialog's optional inline editing step can hand back different
+ * arguments than the entry originally proposed.
+ */
+export interface ToolTimelineApprovalDetail extends ToolApprovalEventDetail {
+    args?: unknown;
+}
+export interface LyraToolTimelineEventMap {
+    'lr-tool-approval-decide': CustomEvent<ToolTimelineApprovalDetail>;
+}
+/**
+ * `<lr-tool-timeline>` — a chronological list of an agent run's tool/function calls, each
+ * rendered through `<lr-tool-call-chip>` (name/status/duration) and `<lr-tool-result-view>`
+ * (args/result), with per-entry retry counts, sensitive-field redaction, and a shared
+ * `<lr-tool-approval-dialog>` for entries gated behind a human approval decision. This component
+ * owns none of the actual per-call rendering -- that is entirely those three existing
+ * primitives -- its own job is ordering `entries` chronologically, computing each entry's
+ * duration from `startedAt`/`endedAt`, masking `redactedFields` before handing `args`/`result` to
+ * `<lr-tool-result-view>`, and opening/closing the one shared approval dialog for whichever entry
+ * is currently pending a decision.
+ *
+ * Ordering: `entries` is sorted ascending by `startedAt`; an entry with no `startedAt` sorts after
+ * every timed entry, keeping its position relative to any other untimed entries stable (input
+ * order is preserved among ties) — a still-pending call with no timestamp yet naturally lands at
+ * the end without needing to be pre-sorted by the host.
+ *
+ * Redaction only ever affects the read-only detail view: the copy of `args` handed to the
+ * approval dialog is always the entry's real, unmasked value. Approving a masked-args call must
+ * let the reviewer see (and, if `approvalEditable`, edit) what will actually be sent — handing the
+ * dialog a placeholder string in place of a real field would silently corrupt the decision.
+ *
+ * Approval: activating the chip (`lr-tool-call-chip-select`) of an entry with `needsApproval` and
+ * an undecided `approved` opens the shared dialog for that entry; approving or denying emits this
+ * component's own `lr-tool-approval-decide` and closes the dialog. This component never mutates
+ * `entries` itself — a host applies the decision (and any resulting status change) and re-assigns
+ * `entries`; if the entry currently under review disappears or no longer qualifies as pending
+ * (its `approved` was resolved some other way) by the time `entries` changes, the dialog closes on
+ * its own rather than staying open over stale data. A chip belonging to an entry that isn't
+ * pending approval is left alone — its own `lr-tool-call-chip-select` (and deprecated
+ * `lr-tool-chip-select` alias) still bubble out normally for a host that wants to react to raw
+ * chip selection for its own purposes.
+ *
+ * @customElement lr-tool-timeline
+ * @event lr-tool-approval-decide - A pending entry's approval dialog was resolved.
+ *   `detail: { invocationId, approved, args? }` — `args` (the dialog's current, possibly
+ *   host-edited arguments) is present only when `approved` is `true`.
+ * @csspart base - The root `<ol>`.
+ * @csspart entry - One entry's `<li>`; carries `data-status` (the entry's `status`) and
+ *   `data-pending-approval` (`"true"`/`"false"`).
+ * @csspart entry-marker - The decorative rail dot/connector for one entry.
+ * @csspart entry-body - Wrapper around one entry's header and details.
+ * @csspart entry-header - Wrapper around the timestamp, chip, retry badge, and approval status.
+ * @csspart entry-timestamp - The formatted `startedAt`, only rendered while it's set.
+ * @csspart entry-retries - The retry-count badge, only rendered while `retryCount > 0`.
+ * @csspart entry-retries-label - The localized "Retry" text within the retry badge.
+ * @csspart entry-retries-count - The formatted retry count within the retry badge.
+ * @csspart entry-approval-status - The "Approved"/"Denied" badge, only rendered once `approved`
+ *   is set; carries `data-decision` (`"approved"`/`"denied"`).
+ * @csspart entry-redacted-indicator - A decorative marker shown when `redactedFields` is
+ *   non-empty for that entry.
+ * @csspart entry-details - The `<lr-details>` disclosure wrapping the entry's result view.
+ * @csspart entry-result - The entry's `<lr-tool-result-view>`.
+ * @csspart entry-error - The entry's `error` text, only rendered when set.
+ * @csspart approval-dialog - The single shared `<lr-tool-approval-dialog>` instance.
+ * @cssprop [--lr-tool-timeline-gap=var(--lr-space-l)] - Vertical gap between entries.
+ * @cssprop [--lr-tool-timeline-marker-size=var(--lr-size-0-625rem)] - Diameter of an entry's rail
+ *   dot; also the width of the marker gutter column.
+ */
+export declare class LyraToolTimeline extends LyraElement<LyraToolTimelineEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** The calls to render, in any order — see the class doc's ordering note. */
+    entries: ToolTimelineEntry[];
+    /** Forwarded to the shared approval dialog's own `editable` — whether a reviewer can edit an
+     *  entry's arguments before approving it. */
+    approvalEditable: boolean;
+    /** Overrides the default `hour:minute` rendering of every entry's `startedAt`. */
+    formatTimestamp?: (date: Date) => string;
+    /** The `id` of the entry currently under review in the shared approval dialog, or `undefined`
+     *  while it's closed. */
+    private reviewingEntryId?;
+    protected willUpdate(changed: PropertyValues): void;
+    private get sortedEntries();
+    private get reviewingEntry();
+    private durationFor;
+    private normalizedDate;
+    private onChipSelect;
+    private onDialogApprove;
+    private onDialogDeny;
+    private onDialogClose;
+    private entryTemplate;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-tool-timeline': LyraToolTimeline;
+    }
+}
+//# sourceMappingURL=tool-timeline.class.d.ts.map

package/dist/components/agent-tools/tool-timeline/tool-timeline.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-timeline.class.d.ts","sourceRoot":"","sources":["../../../../src/components/agent-tools/tool-timeline/tool-timeline.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAkC,MAAM,KAAK,CAAC;AAG9G,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIhE,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,OAAO,qCAAqC,CAAC;AAC7C,OAAO,yCAAyC,CAAC;AACjD,OAAO,iDAAiD,CAAC;AACzD,OAAO,iCAAiC,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;wEAEoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;0FAEsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;yFACqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;oGAGgG;IAChG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;wDAEoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,yBAAyB,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;CACpE;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,qBAAa,gBAAiB,SAAQ,WAAW,CAAC,wBAAwB,CAAC;IACzE,MAAM,CAAC,MAAM,iCAAgC;IAE7C,6EAA6E;IAC7C,OAAO,EAAE,iBAAiB,EAAE,CAAM;IAElE;iDAC6C;IAE7C,gBAAgB,UAAQ;IAExB,kFAAkF;IAClD,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAEzE;6BACyB;IAChB,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAE3C,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAOlD;IAED,OAAO,KAAK,aAAa,GASxB;IAED,OAAO,KAAK,cAAc,GAIzB;IAED,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,eAAe,CAUrB;IAEF,OAAO,CAAC,YAAY,CAMlB;IAEF,OAAO,CAAC,aAAa,CAGnB;IAEF,OAAO,CAAC,aAAa;IAkErB,MAAM,IAAI,cAAc,CAoBvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,gBAAgB,CAAC;KACtC;CACF"}