@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/cli/migrate-wa.mjs

@@ -19,6 +19,7 @@ deprecated Lyra 21 member names
 change what a site reaches, preserves changed defaults, and reports everything else, including
 listeners of events whose detail changed. --origin=lyra-v22 reports deprecated theme APIs,
 stylesheets, window events and root attributes; review their replacement semantics explicitly.
+--origin=lyra-v25 migrates names that change from Lyra 25 to Lyra 26 and reports the rest.
 --origin=lyra-v26 moves the package specifiers and root-barrel types that Lyra 27 relocated,
 reports removed localization keys, and runs the theme-scopes rule. Lyra profiles never rewrite
 tags. Run a Lyra profile with the CLI of the installed release, after upgrading.
@@ -28,6 +29,7 @@ tags. Run a Lyra profile with the CLI of the installed release, after upgrading.
   --diff               print a unified diff of the changes instead of writing source files
   --origin=lyra-v21    migrate names and defaults that change from Lyra 21 to Lyra 22
   --origin=lyra-v22    review Lyra 22 module contracts retained through Lyra 23
+  --origin=lyra-v25    migrate names that change from Lyra 25 to Lyra 26
   --origin=lyra-v26    move specifiers and types relocated in Lyra 27, report removed locale keys
                        and apply --rule=theme-scopes
   --rule=theme-scopes  Lyra 27: mark elements whose inline style sets a token-layer input with

package/dist/components/agent-tools/activity-feed/activity-feed.class.d.ts

@@ -61,6 +61,7 @@ export type ActivityFeedMode=LyraTranscriptMode;export interface ActivityFeedTog
 *   expanded }`.
 * @event lr-follow-change - A user scroll released or re-engaged `follow`. `detail: {
 *   following }`. Direct property/attribute assignments never echo an event.
+* @csspart limit - Notice of input entries omitted by retention limits.
 * @csspart base - The outer container.
 * @csspart header - The clickable header (`<button>`).
 * @csspart status-dot - The decorative mode indicator dot; pulses while `mode="live"`.
@@ -111,12 +112,13 @@ export type ActivityFeedMode=LyraTranscriptMode;export interface ActivityFeedTog
 * @status stable
 * @since 4.0.0
 */
-export declare class LyraActivityFeed extends LyraElement<LyraActivityFeedEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];
+export declare class LyraActivityFeed extends LyraElement<LyraActivityFeedEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];protected static readonly appendOrderedCollectionProperties:readonly string[];
 /** Entries may carry opaque caller `data`. Keep each admitted entry's identity only, rather
 *  than deep-cloning unknown data -- the same policy `<lr-prompt-queue>`'s `items` uses for its
 *  own opaque `metadata` field. */
 protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];
-/** Append-only: stable ids, new entries at the end. Entries never change state once added.
+/** Append-only: stable ids, new entries at the end. The newest 10,000 caller-owned entry
+*  identities are retained; a localized limit notice discloses omitted history. Entries never change state once added.
 *  Empty/blank ids are omitted and duplicates normalize first-wins before summary,
 *  virtualization, and rendering. */
 entries:readonly ActivityEntry[];private _mode;get mode():ActivityFeedMode;set mode(next:ActivityFeedMode);
@@ -156,4 +158,4 @@ formatTimestamp?:(date:Date)=>string;
 *  other descendant markup stays reachable only by inheritance or an inline style. */
 renderText?:(entry:ActivityEntry)=>TemplateResult;
 /** Above this entry count, the body renders through an internal `<lr-virtual-list>`. */
-virtualizeAt:number;private liveRegion?;private virtualListEl?;private readonly headerId;private readonly bodyId;private readonly activityEntryKey;private isMounting;private scrollRafId?;private scrollRafOwner?;private scrollRafDocument?;private virtualAnchorReleaseRafId?;private virtualAnchorReleaseRafOwner?;private virtualAnchorReleaseRafDocument?;private anchoringVirtualTail;private ownerRealmGeneration;private virtualAnchorRequest;private externalLabelledByLease?;private externalDescribedByLease?;private relationshipSyncRequest;private pendingEntryFocusRepair?;private entryFocusRepairRequest;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private get effectiveVirtualizeAt();private get normalizedEntries();private get isVirtualized();private get shouldFollowLiveTail();private cancelScrollFrame;private cancelVirtualAnchorReleaseFrame;private resetOwnerRealmWork;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private get headerElement();private repairFocusOnCollapse;private captureEntryFocusRepair;private settleEntryFocusRepair;private scrollToLatest;private completedStepsSummary;private get listSemanticOwner();private syncListRelationships;private scheduleListRelationshipSync;private releaseListRelationships;private toggle;private setFollowFromUser;private onBodyScroll;private onVirtualListRangeChanged;private stopOwnedEvent;private normalizedTimestamp;private entryTemplate;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-activity-feed':LyraActivityFeed;}}
+virtualizeAt:number;private liveRegion?;private virtualListEl?;private readonly headerId;private readonly bodyId;private readonly activityEntryKey;private isMounting;private scrollRafId?;private scrollRafOwner?;private scrollRafDocument?;private virtualAnchorReleaseRafId?;private virtualAnchorReleaseRafOwner?;private virtualAnchorReleaseRafDocument?;private anchoringVirtualTail;private ownerRealmGeneration;private virtualAnchorRequest;private externalLabelledByLease?;private externalDescribedByLease?;private relationshipSyncRequest;private pendingEntryFocusRepair?;private entryFocusRepairRequest;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private get effectiveVirtualizeAt();private get normalizedEntries();private get isVirtualized();private get shouldFollowLiveTail();private cancelScrollFrame;private cancelVirtualAnchorReleaseFrame;private resetOwnerRealmWork;protected willUpdate(changed:PropertyValues):void;private explicitRowRefresh;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;protected updated(changed:PropertyValues):void;private get headerElement();private repairFocusOnCollapse;private captureEntryFocusRepair;private settleEntryFocusRepair;private scrollToLatest;private completedStepsSummary;private get listSemanticOwner();private syncListRelationships;private scheduleListRelationshipSync;private releaseListRelationships;private toggle;private setFollowFromUser;private onBodyScroll;private onVirtualListRangeChanged;private stopOwnedEvent;private normalizedTimestamp;private readonly renderEntry;private entryTemplate;private lastInputNotice;private inputLimitMessage;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-activity-feed':LyraActivityFeed;}}

package/dist/components/agent-tools/activity-feed/activity-feed.class.js

@@ -1,4 +1,4 @@
-import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property,query}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{repeat}from"lit/directives/repeat.js";import{LyraElement}from"../../../internal/lyra-element.js";import{nextId}from"../../../internal/a11y.js";import{acquireResolvedAriaRelationship}from"../../../internal/aria-controls.js";import{applyComposedFocusRepair,captureComposedFocusRepair,repairComposedFocus}from"../../../internal/focus-navigation.js";import{chevronIcon}from"../../../internal/icons.js";import{formatTimeOfDay,getNumberFormat}from"../../../internal/intl-cache.js";import{finiteCount}from"../../../internal/numbers.js";import{styles}from"./activity-feed.styles.js";import{literalSetConverter,trueDefaultBooleanConverter}from"../../../internal/converters.js";import{firstByIdentityMemo}from"../collection-identity.js";import{LYRA_DEFAULT_activityFeedCompletedSteps,LYRA_DEFAULT_activityFeedLabel}from"../../../internal/default-strings/agent-tools.generated.js";const ACTIVITY_FEED_MODE=literalSetConverter(["live","post-hoc"],"live"),NEAR_BOTTOM_PX=48,entryId=entry=>entry.id;function variantDotPart(variant){return variant==="brand"?"variant-dot variant-dot-brand":variant==="success"?"variant-dot variant-dot-success":variant==="warning"?"variant-dot variant-dot-warning":variant==="danger"?"variant-dot variant-dot-danger":"variant-dot variant-dot-neutral"}class LyraActivityFeed extends LyraElement{constructor(){super(...arguments),this.entries=[],this._mode="live",this.follow=!0,this.expanded=!1,this.size="m",this.frame="card",this.withTimestamps=!1,this.virtualizeAt=199,this.headerId=nextId("activity-feed-header"),this.bodyId=nextId("activity-feed-body"),this.activityEntryKey=item=>item.id,this.isMounting=!0,this.anchoringVirtualTail=!1,this.ownerRealmGeneration=0,this.virtualAnchorRequest=0,this.relationshipSyncRequest=0,this.entryFocusRepairRequest=0,this.toggle=()=>{const expanded=!this.expanded;this.emit("lr-toggle-request",{expanded},{cancelable:!0}).defaultPrevented||(this.expanded=expanded,this.emit("lr-toggle",{expanded}))},this.onBodyScroll=e=>{if(this.isVirtualized||this.mode!=="live")return;const body=e.currentTarget,nearBottom=body.scrollHeight-body.scrollTop-body.clientHeight<=NEAR_BOTTOM_PX;this.setFollowFromUser(nearBottom)},this.onVirtualListRangeChanged=e=>{if(e.stopPropagation(),this.mode!=="live"||this.anchoringVirtualTail)return;const entries=this.normalizedEntries,atBottom=entries.length>0&&e.detail.end>=entries.length-1;this.setFollowFromUser(atBottom)},this.stopOwnedEvent=event=>{event.stopPropagation()}}static{this.defaultStrings={...super.defaultStrings,activityFeedCompletedSteps:LYRA_DEFAULT_activityFeedCompletedSteps,activityFeedLabel:LYRA_DEFAULT_activityFeedLabel}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["entries"])}static{this.identityCollectionProperties=Object.freeze(["entries"])}static{this.styles=[LyraElement.styles,styles]}get mode(){return this._mode}set mode(next){const normalized=ACTIVITY_FEED_MODE.normalizeReflected(this,"mode",next),old=this._mode;old!==normalized&&(this._mode=normalized,this.requestUpdate("mode",old))}connectedCallback(){super.connectedCallback(),this.hasUpdated&&(this.syncListRelationships(),this.scheduleListRelationshipSync()),this.hasUpdated&&this.shouldFollowLiveTail&&this.scrollToLatest()}disconnectedCallback(){this.releaseListRelationships(),this.resetOwnerRealmWork(),super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.releaseListRelationships(),this.resetOwnerRealmWork(),this.isConnected&&this.hasUpdated&&(this.syncListRelationships(),this.scheduleListRelationshipSync()),this.isConnected&&this.shouldFollowLiveTail&&this.scrollToLatest()}get effectiveVirtualizeAt(){return finiteCount(this.virtualizeAt,199)}get normalizedEntries(){return firstByIdentityMemo(Array.isArray(this.entries)?this.entries:[],entryId)}get isVirtualized(){return this.normalizedEntries.length>this.effectiveVirtualizeAt}get shouldFollowLiveTail(){return this.expanded&&this.mode==="live"&&this.follow}cancelScrollFrame(){this.scrollRafId!==void 0&&this.scrollRafOwner?.cancelAnimationFrame(this.scrollRafId),this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0}cancelVirtualAnchorReleaseFrame(){this.virtualAnchorReleaseRafId!==void 0&&this.virtualAnchorReleaseRafOwner?.cancelAnimationFrame(this.virtualAnchorReleaseRafId),this.virtualAnchorReleaseRafId=void 0,this.virtualAnchorReleaseRafOwner=void 0,this.virtualAnchorReleaseRafDocument=void 0}resetOwnerRealmWork(){this.ownerRealmGeneration+=1,this.virtualAnchorRequest+=1,this.relationshipSyncRequest+=1,this.entryFocusRepairRequest+=1,this.pendingEntryFocusRepair=void 0,this.cancelScrollFrame(),this.cancelVirtualAnchorReleaseFrame(),this.anchoringVirtualTail=!1}willUpdate(changed){super.willUpdate(changed),(changed.has("expanded")||changed.has("mode"))&&this.expanded&&this.mode==="live"&&(this.follow=!0),changed.has("expanded")&&changed.get("expanded")===!0&&!this.expanded&&this.repairFocusOnCollapse(),changed.has("entries")&&this.captureEntryFocusRepair()}updated(changed){super.updated(changed),this.syncListRelationships(),this.scheduleListRelationshipSync();const wasMounting=this.isMounting;if(this.isMounting=!1,!wasMounting&&changed.has("mode")&&changed.get("mode")==="live"&&this.mode==="post-hoc"){const region=this.liveRegion;region&&(region.mode="polite",region.announce(this.completedStepsSummary(this.normalizedEntries.length),{force:!0}))}const justAnchored=(changed.has("expanded")||changed.has("mode"))&&this.expanded&&this.mode==="live",followingChangedRenderPath=changed.has("virtualizeAt")&&this.expanded&&this.mode==="live"&&this.follow;(justAnchored||followingChangedRenderPath||changed.has("entries")&&this.expanded&&this.mode==="live"&&this.follow)&&this.scrollToLatest(),changed.has("entries")&&this.pendingEntryFocusRepair&&this.settleEntryFocusRepair()}get headerElement(){return this.hasUpdated?this.renderRoot?.querySelector('[part="header"]')??null:null}repairFocusOnCollapse(){repairComposedFocus(this,()=>this.headerElement)}captureEntryFocusRepair(){this.pendingEntryFocusRepair=captureComposedFocusRepair(this,this.headerElement)??void 0}settleEntryFocusRepair(){const pending=this.pendingEntryFocusRepair;if(this.pendingEntryFocusRepair=void 0,!pending)return;const request=++this.entryFocusRepairRequest,generation=this.ownerRealmGeneration,settle=()=>{request!==this.entryFocusRepairRequest||generation!==this.ownerRealmGeneration||!this.isConnected||pending.activeElement.isConnected||applyComposedFocusRepair(pending,()=>this.headerElement)},list=this.virtualListEl;list?list.updateComplete.then(settle):settle()}scrollToLatest(){const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!ownerWindow||!this.isConnected||!this.shouldFollowLiveTail)return;const generation=this.ownerRealmGeneration;if(this.isVirtualized){this.cancelScrollFrame(),this.cancelVirtualAnchorReleaseFrame(),this.anchoringVirtualTail=!0;const request=++this.virtualAnchorRequest;this.updateComplete.then(()=>{const list=this.virtualListEl;if(request!==this.virtualAnchorRequest||generation!==this.ownerRealmGeneration||this.ownerDocument!==ownerDocument||!this.isConnected)return;if(!list||!this.isVirtualized||!this.shouldFollowLiveTail){this.anchoringVirtualTail=!1;return}list.scrollToIndex(this.normalizedEntries.length-1,{align:"end",behavior:"auto"});const firstHandle=ownerWindow.requestAnimationFrame(()=>{if(this.virtualAnchorReleaseRafId!==firstHandle||this.virtualAnchorReleaseRafOwner!==ownerWindow||this.virtualAnchorReleaseRafDocument!==ownerDocument||request!==this.virtualAnchorRequest||generation!==this.ownerRealmGeneration||!this.isConnected||this.ownerDocument!==ownerDocument)return;if(this.virtualAnchorReleaseRafId=void 0,this.virtualAnchorReleaseRafOwner=void 0,this.virtualAnchorReleaseRafDocument=void 0,!this.anchoringVirtualTail||!this.isVirtualized||!this.shouldFollowLiveTail){this.anchoringVirtualTail=!1;return}const secondHandle=ownerWindow.requestAnimationFrame(()=>{this.virtualAnchorReleaseRafId!==secondHandle||this.virtualAnchorReleaseRafOwner!==ownerWindow||this.virtualAnchorReleaseRafDocument!==ownerDocument||request!==this.virtualAnchorRequest||generation!==this.ownerRealmGeneration||!this.isConnected||this.ownerDocument!==ownerDocument||(this.virtualAnchorReleaseRafId=void 0,this.virtualAnchorReleaseRafOwner=void 0,this.virtualAnchorReleaseRafDocument=void 0,this.anchoringVirtualTail=!1)});this.virtualAnchorReleaseRafId=secondHandle,this.virtualAnchorReleaseRafOwner=ownerWindow,this.virtualAnchorReleaseRafDocument=ownerDocument});this.virtualAnchorReleaseRafId=firstHandle,this.virtualAnchorReleaseRafOwner=ownerWindow,this.virtualAnchorReleaseRafDocument=ownerDocument});return}if(this.virtualAnchorRequest+=1,this.cancelVirtualAnchorReleaseFrame(),this.anchoringVirtualTail=!1,this.scrollRafId!==void 0)return;const handle=ownerWindow.requestAnimationFrame(()=>{if(this.scrollRafId!==handle||this.scrollRafOwner!==ownerWindow||this.scrollRafDocument!==ownerDocument||generation!==this.ownerRealmGeneration||!this.isConnected||this.ownerDocument!==ownerDocument||(this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0,!this.shouldFollowLiveTail||this.isVirtualized))return;const body=this.renderRoot.querySelector('[part="body"]');body&&(body.scrollTop=body.scrollHeight)});this.scrollRafId=handle,this.scrollRafOwner=ownerWindow,this.scrollRafDocument=ownerDocument}completedStepsSummary(count){return this.localize("activityFeedCompletedSteps",void 0,{count:getNumberFormat(this.effectiveLocale).format(count),pluralCount:count})}get listSemanticOwner(){return this.isVirtualized?this.virtualListEl?.scrollContainer??null:this.renderRoot.querySelector('[part="body"][role="list"]')}syncListRelationships(){const target=this.listSemanticOwner;if(!target){this.releaseListRelationships();return}this.externalLabelledByLease?this.externalLabelledByLease.update(target):this.externalLabelledByLease=acquireResolvedAriaRelationship(this,target,"aria-labelledby"),this.externalDescribedByLease?this.externalDescribedByLease.update(target):this.externalDescribedByLease=acquireResolvedAriaRelationship(this,target,"aria-describedby")}scheduleListRelationshipSync(){const list=this.virtualListEl;if(!this.isVirtualized||!list||!this.isConnected){this.relationshipSyncRequest+=1;return}const request=++this.relationshipSyncRequest,ownerDocument=this.ownerDocument,generation=this.ownerRealmGeneration;list.updateComplete.then(()=>{request!==this.relationshipSyncRequest||generation!==this.ownerRealmGeneration||this.ownerDocument!==ownerDocument||!this.isConnected||!this.isVirtualized||this.virtualListEl!==list||this.syncListRelationships()})}releaseListRelationships(){this.externalLabelledByLease?.release(),this.externalLabelledByLease=void 0,this.externalDescribedByLease?.release(),this.externalDescribedByLease=void 0}setFollowFromUser(following){following!==this.follow&&(this.follow=following,this.emit("lr-follow-change",{following}))}normalizedTimestamp(value){if(value===void 0)return;const date=value instanceof Date?value:new Date(value);return Number.isNaN(date.getTime())?void 0:date}entryTemplate(entry,ownRole){const ts=this.normalizedTimestamp(entry.timestamp),formatter=this.formatTimestamp??(date=>formatTimeOfDay(date,this.effectiveLocale)),variant=entry.variant??"neutral",dotPart=variantDotPart(variant);return html`
+import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property,query}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{repeat}from"lit/directives/repeat.js";import{LyraElement}from"../../../internal/lyra-element.js";import{nextId}from"../../../internal/a11y.js";import{acquireResolvedAriaRelationship}from"../../../internal/aria-controls.js";import{applyComposedFocusRepair,captureComposedFocusRepair,repairComposedFocus}from"../../../internal/focus-navigation.js";import{chevronIcon}from"../../../internal/icons.js";import{formatTimeOfDay,getNumberFormat}from"../../../internal/intl-cache.js";import{finiteCount}from"../../../internal/numbers.js";import{styles}from"./activity-feed.styles.js";import{literalSetConverter,trueDefaultBooleanConverter}from"../../../internal/converters.js";import{firstByIdentityMemo}from"../collection-identity.js";import{LYRA_DEFAULT_activityFeedCompletedSteps,LYRA_DEFAULT_activityFeedInputLimit,LYRA_DEFAULT_activityFeedLabel}from"../../../internal/default-strings/agent-tools.generated.js";const ACTIVITY_FEED_MODE=literalSetConverter(["live","post-hoc"],"live"),NEAR_BOTTOM_PX=48,entryId=entry=>entry.id;function variantDotPart(variant){return variant==="brand"?"variant-dot variant-dot-brand":variant==="success"?"variant-dot variant-dot-success":variant==="warning"?"variant-dot variant-dot-warning":variant==="danger"?"variant-dot variant-dot-danger":"variant-dot variant-dot-neutral"}class LyraActivityFeed extends LyraElement{constructor(){super(...arguments),this.entries=[],this._mode="live",this.follow=!0,this.expanded=!1,this.size="m",this.frame="card",this.withTimestamps=!1,this.virtualizeAt=199,this.headerId=nextId("activity-feed-header"),this.bodyId=nextId("activity-feed-body"),this.activityEntryKey=item=>item.id,this.isMounting=!0,this.anchoringVirtualTail=!1,this.ownerRealmGeneration=0,this.virtualAnchorRequest=0,this.relationshipSyncRequest=0,this.entryFocusRepairRequest=0,this.explicitRowRefresh=!1,this.toggle=()=>{const expanded=!this.expanded;this.emit("lr-toggle-request",{expanded},{cancelable:!0}).defaultPrevented||(this.expanded=expanded,this.emit("lr-toggle",{expanded}))},this.onBodyScroll=e=>{if(this.isVirtualized||this.mode!=="live")return;const body=e.currentTarget,nearBottom=body.scrollHeight-body.scrollTop-body.clientHeight<=NEAR_BOTTOM_PX;this.setFollowFromUser(nearBottom)},this.onVirtualListRangeChanged=e=>{if(e.stopPropagation(),this.mode!=="live"||this.anchoringVirtualTail)return;const entries=this.normalizedEntries,atBottom=entries.length>0&&e.detail.end>=entries.length-1;this.setFollowFromUser(atBottom)},this.stopOwnedEvent=event=>{event.stopPropagation()},this.renderEntry=item=>this.entryTemplate(item,!1),this.lastInputNotice=""}static{this.defaultStrings={...super.defaultStrings,activityFeedCompletedSteps:LYRA_DEFAULT_activityFeedCompletedSteps,activityFeedInputLimit:LYRA_DEFAULT_activityFeedInputLimit,activityFeedLabel:LYRA_DEFAULT_activityFeedLabel}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["entries"])}static{this.appendOrderedCollectionProperties=Object.freeze(["entries"])}static{this.identityCollectionProperties=Object.freeze(["entries"])}static{this.styles=[LyraElement.styles,styles]}get mode(){return this._mode}set mode(next){const normalized=ACTIVITY_FEED_MODE.normalizeReflected(this,"mode",next),old=this._mode;old!==normalized&&(this._mode=normalized,this.requestUpdate("mode",old))}connectedCallback(){super.connectedCallback(),this.hasUpdated&&(this.syncListRelationships(),this.scheduleListRelationshipSync()),this.hasUpdated&&this.shouldFollowLiveTail&&this.scrollToLatest()}disconnectedCallback(){this.releaseListRelationships(),this.resetOwnerRealmWork(),super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.releaseListRelationships(),this.resetOwnerRealmWork(),this.isConnected&&this.hasUpdated&&(this.syncListRelationships(),this.scheduleListRelationshipSync()),this.isConnected&&this.shouldFollowLiveTail&&this.scrollToLatest()}get effectiveVirtualizeAt(){return finiteCount(this.virtualizeAt,199)}get normalizedEntries(){return firstByIdentityMemo(Array.isArray(this.entries)?this.entries:[],entryId)}get isVirtualized(){return this.normalizedEntries.length>this.effectiveVirtualizeAt}get shouldFollowLiveTail(){return this.expanded&&this.mode==="live"&&this.follow}cancelScrollFrame(){this.scrollRafId!==void 0&&this.scrollRafOwner?.cancelAnimationFrame(this.scrollRafId),this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0}cancelVirtualAnchorReleaseFrame(){this.virtualAnchorReleaseRafId!==void 0&&this.virtualAnchorReleaseRafOwner?.cancelAnimationFrame(this.virtualAnchorReleaseRafId),this.virtualAnchorReleaseRafId=void 0,this.virtualAnchorReleaseRafOwner=void 0,this.virtualAnchorReleaseRafDocument=void 0}resetOwnerRealmWork(){this.ownerRealmGeneration+=1,this.virtualAnchorRequest+=1,this.relationshipSyncRequest+=1,this.entryFocusRepairRequest+=1,this.pendingEntryFocusRepair=void 0,this.cancelScrollFrame(),this.cancelVirtualAnchorReleaseFrame(),this.anchoringVirtualTail=!1}willUpdate(changed){super.willUpdate(changed),(changed.has("expanded")||changed.has("mode"))&&this.expanded&&this.mode==="live"&&(this.follow=!0),changed.has("expanded")&&changed.get("expanded")===!0&&!this.expanded&&this.repairFocusOnCollapse(),changed.has("entries")&&this.captureEntryFocusRepair()}requestUpdate(...args){args[0]===void 0&&(this.explicitRowRefresh=!0),super.requestUpdate(...args)}updated(changed){super.updated(changed);const explicitRefresh=this.explicitRowRefresh;this.explicitRowRefresh=!1,(explicitRefresh||["withTimestamps","formatTimestamp","renderText","locale","strings"].some(name=>changed.has(name)))&&this.virtualListEl?.requestUpdate(),this.syncListRelationships(),this.scheduleListRelationshipSync();const wasMounting=this.isMounting;this.isMounting=!1;const inputNotice=this.inputLimitMessage();if(!wasMounting&&inputNotice&&inputNotice!==this.lastInputNotice&&this.liveRegion?.announce(inputNotice,{force:!0}),this.lastInputNotice=inputNotice,!wasMounting&&changed.has("mode")&&changed.get("mode")==="live"&&this.mode==="post-hoc"){const region=this.liveRegion;region&&(region.mode="polite",region.announce(this.completedStepsSummary(this.normalizedEntries.length),{force:!0}))}const justAnchored=(changed.has("expanded")||changed.has("mode"))&&this.expanded&&this.mode==="live",followingChangedRenderPath=changed.has("virtualizeAt")&&this.expanded&&this.mode==="live"&&this.follow;(justAnchored||followingChangedRenderPath||changed.has("entries")&&this.expanded&&this.mode==="live"&&this.follow)&&this.scrollToLatest(),changed.has("entries")&&this.pendingEntryFocusRepair&&this.settleEntryFocusRepair()}get headerElement(){return this.hasUpdated?this.renderRoot?.querySelector('[part="header"]')??null:null}repairFocusOnCollapse(){repairComposedFocus(this,()=>this.headerElement)}captureEntryFocusRepair(){this.pendingEntryFocusRepair=captureComposedFocusRepair(this,this.headerElement)??void 0}settleEntryFocusRepair(){const pending=this.pendingEntryFocusRepair;if(this.pendingEntryFocusRepair=void 0,!pending)return;const request=++this.entryFocusRepairRequest,generation=this.ownerRealmGeneration,settle=()=>{request!==this.entryFocusRepairRequest||generation!==this.ownerRealmGeneration||!this.isConnected||pending.activeElement.isConnected||applyComposedFocusRepair(pending,()=>this.headerElement)},list=this.virtualListEl;list?list.updateComplete.then(settle):settle()}scrollToLatest(){const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!ownerWindow||!this.isConnected||!this.shouldFollowLiveTail)return;const generation=this.ownerRealmGeneration;if(this.isVirtualized){this.cancelScrollFrame(),this.cancelVirtualAnchorReleaseFrame(),this.anchoringVirtualTail=!0;const request=++this.virtualAnchorRequest;this.updateComplete.then(()=>{const list=this.virtualListEl;if(request!==this.virtualAnchorRequest||generation!==this.ownerRealmGeneration||this.ownerDocument!==ownerDocument||!this.isConnected)return;if(!list||!this.isVirtualized||!this.shouldFollowLiveTail){this.anchoringVirtualTail=!1;return}list.scrollToIndex(this.normalizedEntries.length-1,{align:"end",behavior:"auto"});const firstHandle=ownerWindow.requestAnimationFrame(()=>{if(this.virtualAnchorReleaseRafId!==firstHandle||this.virtualAnchorReleaseRafOwner!==ownerWindow||this.virtualAnchorReleaseRafDocument!==ownerDocument||request!==this.virtualAnchorRequest||generation!==this.ownerRealmGeneration||!this.isConnected||this.ownerDocument!==ownerDocument)return;if(this.virtualAnchorReleaseRafId=void 0,this.virtualAnchorReleaseRafOwner=void 0,this.virtualAnchorReleaseRafDocument=void 0,!this.anchoringVirtualTail||!this.isVirtualized||!this.shouldFollowLiveTail){this.anchoringVirtualTail=!1;return}const secondHandle=ownerWindow.requestAnimationFrame(()=>{this.virtualAnchorReleaseRafId!==secondHandle||this.virtualAnchorReleaseRafOwner!==ownerWindow||this.virtualAnchorReleaseRafDocument!==ownerDocument||request!==this.virtualAnchorRequest||generation!==this.ownerRealmGeneration||!this.isConnected||this.ownerDocument!==ownerDocument||(this.virtualAnchorReleaseRafId=void 0,this.virtualAnchorReleaseRafOwner=void 0,this.virtualAnchorReleaseRafDocument=void 0,this.anchoringVirtualTail=!1)});this.virtualAnchorReleaseRafId=secondHandle,this.virtualAnchorReleaseRafOwner=ownerWindow,this.virtualAnchorReleaseRafDocument=ownerDocument});this.virtualAnchorReleaseRafId=firstHandle,this.virtualAnchorReleaseRafOwner=ownerWindow,this.virtualAnchorReleaseRafDocument=ownerDocument});return}if(this.virtualAnchorRequest+=1,this.cancelVirtualAnchorReleaseFrame(),this.anchoringVirtualTail=!1,this.scrollRafId!==void 0)return;const handle=ownerWindow.requestAnimationFrame(()=>{if(this.scrollRafId!==handle||this.scrollRafOwner!==ownerWindow||this.scrollRafDocument!==ownerDocument||generation!==this.ownerRealmGeneration||!this.isConnected||this.ownerDocument!==ownerDocument||(this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0,!this.shouldFollowLiveTail||this.isVirtualized))return;const body=this.renderRoot.querySelector('[part="body"]');body&&(body.scrollTop=body.scrollHeight)});this.scrollRafId=handle,this.scrollRafOwner=ownerWindow,this.scrollRafDocument=ownerDocument}completedStepsSummary(count){return this.localize("activityFeedCompletedSteps",void 0,{count:getNumberFormat(this.effectiveLocale).format(count),pluralCount:count})}get listSemanticOwner(){return this.isVirtualized?this.virtualListEl?.scrollContainer??null:this.renderRoot.querySelector('[part="body"][role="list"]')}syncListRelationships(){const target=this.listSemanticOwner;if(!target){this.releaseListRelationships();return}this.externalLabelledByLease?this.externalLabelledByLease.update(target):this.externalLabelledByLease=acquireResolvedAriaRelationship(this,target,"aria-labelledby"),this.externalDescribedByLease?this.externalDescribedByLease.update(target):this.externalDescribedByLease=acquireResolvedAriaRelationship(this,target,"aria-describedby")}scheduleListRelationshipSync(){const list=this.virtualListEl;if(!this.isVirtualized||!list||!this.isConnected){this.relationshipSyncRequest+=1;return}const request=++this.relationshipSyncRequest,ownerDocument=this.ownerDocument,generation=this.ownerRealmGeneration;list.updateComplete.then(()=>{request!==this.relationshipSyncRequest||generation!==this.ownerRealmGeneration||this.ownerDocument!==ownerDocument||!this.isConnected||!this.isVirtualized||this.virtualListEl!==list||this.syncListRelationships()})}releaseListRelationships(){this.externalLabelledByLease?.release(),this.externalLabelledByLease=void 0,this.externalDescribedByLease?.release(),this.externalDescribedByLease=void 0}setFollowFromUser(following){following!==this.follow&&(this.follow=following,this.emit("lr-follow-change",{following}))}normalizedTimestamp(value){if(value===void 0)return;const date=value instanceof Date?value:new Date(value);return Number.isNaN(date.getTime())?void 0:date}entryTemplate(entry,ownRole){const ts=this.normalizedTimestamp(entry.timestamp),formatter=this.formatTimestamp??(date=>formatTimeOfDay(date,this.effectiveLocale)),variant=entry.variant??"neutral",dotPart=variantDotPart(variant);return html`
       <div part="entry" role=${ownRole?"listitem":nothing} data-variant=${variant}>
         <span part="entry-icon" aria-hidden="true"
           >${entry.icon?entry.icon:html`<span part=${dotPart} data-variant=${variant}></span>`}</span
@@ -6,8 +6,9 @@ import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/co
         <span part="entry-text" data-lr-virtual-list-link>${this.renderText?this.renderText(entry):entry.text}</span>
         ${this.withTimestamps&&ts?html`<time part="entry-timestamp" datetime=${ts.toISOString()}>${formatter(ts)}</time>`:nothing}
       </div>
-    `}render(){const entries=this.normalizedEntries,fallbackLabel=this.localize("activityFeedLabel"),label=this.label==null?fallbackLabel:this.label,headerText=this.mode==="live"?entries[entries.length-1]?.text??"":this.completedStepsSummary(entries.length),listAriaLabel=this.hasAttribute("aria-label")?this.getAttribute("aria-label")??"":fallbackLabel,headerAriaLabel=`${label} ${headerText}`.trim()?nothing:fallbackLabel,virtualized=entries.length>this.effectiveVirtualizeAt;return html`
+    `}inputLimitMessage(){const loss=publicCollectionTruncation(this,"entries");return loss?this.localize("activityFeedInputLimit",void 0,{count:getNumberFormat(this.effectiveLocale).format(loss.retained),total:getNumberFormat(this.effectiveLocale).format(loss.source)}):""}render(){const entries=this.normalizedEntries,fallbackLabel=this.localize("activityFeedLabel"),label=this.label==null?fallbackLabel:this.label,headerText=this.mode==="live"?entries[entries.length-1]?.text??"":this.completedStepsSummary(entries.length),listAriaLabel=this.hasAttribute("aria-label")?this.getAttribute("aria-label")??"":fallbackLabel,headerAriaLabel=`${label} ${headerText}`.trim()?nothing:fallbackLabel,virtualized=entries.length>this.effectiveVirtualizeAt;return html`
       <div part="base">
+        ${this.inputLimitMessage()?html`<p part="limit">${this.inputLimitMessage()}</p>`:nothing}
         <button
           part="header"
           type="button"
@@ -34,7 +35,7 @@ import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/co
           ${virtualized?html`<lr-virtual-list
                 exportparts="entry:entry, entry-icon:entry-icon, variant-dot:variant-dot, variant-dot-neutral:variant-dot-neutral, variant-dot-brand:variant-dot-brand, variant-dot-success:variant-dot-success, variant-dot-warning:variant-dot-warning, variant-dot-danger:variant-dot-danger, entry-text:entry-text, entry-timestamp:entry-timestamp"
                 .items=${guard([this.entries],()=>entries)}
-                .renderItem=${item=>this.entryTemplate(item,!1)}
+                .renderItem=${this.renderEntry}
                 .keyFunction=${this.activityEntryKey}
                 aria-label=${listAriaLabel}
                 @lr-visible-range-change=${this.onVirtualListRangeChanged}

package/dist/components/agent-tools/activity-feed/activity-feed.styles.js

@@ -1 +1 @@
-import{disclosureHeader}from"../../../internal/layout-fragments.styles.js";import{css}from"lit";const styles=css` :host { display: block; --_lr-activity-feed-max-height: var(--lr-size-16rem); } [part="base"] { border: var(--lr-border-width-thin) solid var(--lr-activity-feed-border-color, var(--lr-color-border-subtle)); border-radius: var(--lr-activity-feed-radius, var(--lr-radius)); background: var(--lr-activity-feed-bg, var(--lr-color-surface)); overflow: hidden; } :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) [part="header"] { padding: var( --lr-activity-feed-compact-header-padding, var(--lr-space-2xs) var(--lr-space-s) ); gap: var(--lr-activity-feed-compact-header-gap, var(--lr-space-2xs)); } :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) [part="entry"], :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) lr-virtual-list::part(entry) { padding: var( --lr-activity-feed-compact-entry-padding, var(--lr-space-2xs) var(--lr-space-s) ); gap: var(--lr-activity-feed-compact-entry-gap, var(--lr-space-2xs)); } :host([frame="plain"]) [part="base"] { border: 0; border-radius: 0; background: transparent; } [part="header"] { ${disclosureHeader} box-sizing: border-box; } [part="header"]:hover { background: var(--lr-color-brand-quiet); color: var(--lr-color-brand); } [part="header"]:active { background: color-mix( in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active) ); } [part="header"]:focus-visible { outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color); outline-offset: calc(-1 * max(var(--lr-focus-ring-width), calc(var(--lr-focus-ring-width) + var(--lr-focus-ring-offset)))); } [part="toggle"] { display: inline-flex; flex: 0 0 auto; transition: transform var(--lr-transition-fast); } :host([expanded]) [part="toggle"] { transform: rotate(90deg); } :host(:not([expanded]):dir(rtl)) [part="toggle"] { transform: scaleX(-1); } [part="status-dot"] { flex: 0 0 auto; inline-size: var(--lr-size-0-5rem); block-size: var(--lr-size-0-5rem); border-radius: var(--lr-radius-pill); background: var(--lr-color-text-quiet); } :host([mode="live"]) [part="status-dot"] { background: var( --lr-activity-feed-live-status-color, var(--lr-color-brand) ); animation: var(--_lr-motion-animation, lr-activity-feed-pulse var(--lr-transition-ambient) infinite); } [part="label"] { flex: 0 1 auto; min-inline-size: 0; max-inline-size: 50%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: var(--lr-font-weight-semibold); } [part="summary"] { flex: 1 1 auto; min-inline-size: var(--lr-size-3ch); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: var(--lr-font-size-sm); color: var(--lr-color-text-quiet); text-align: start; } [part="body"] { display: flex; flex-direction: column; max-block-size: var( --lr-activity-feed-max-height, var(--_lr-activity-feed-max-height) ); overflow-x: hidden; overflow-y: auto; overscroll-behavior: contain; border-block-start: var(--lr-border-width-thin) solid var(--lr-activity-feed-border-color, var(--lr-color-border-subtle)); } [part="body"]:focus-visible { outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color); outline-offset: calc(-1 * max(var(--lr-focus-ring-width), calc(var(--lr-focus-ring-width) + var(--lr-focus-ring-offset)))); } [part="body"][hidden] { display: none; } lr-virtual-list { --lr-virtual-list-row-link-color: var(--lr-activity-feed-entry-text-link-color, var(--lr-color-brand)); display: block; inline-size: 100%; block-size: var( --lr-activity-feed-max-height, var(--_lr-activity-feed-max-height) ); } [part="entry"], lr-virtual-list::part(entry) { display: flex; flex-wrap: wrap; align-items: baseline; gap: var(--lr-space-xs); padding: var(--lr-space-2xs) var(--lr-space-m); } [part="entry-icon"], lr-virtual-list::part(entry-icon) { flex: 0 0 auto; display: inline-flex; align-items: center; inline-size: var(--lr-size-1em); } [part~="variant-dot"], lr-virtual-list::part(variant-dot) { display: block; inline-size: var(--lr-size-0-5rem); block-size: var(--lr-size-0-5rem); border-radius: var(--lr-radius-pill); } [part~="variant-dot-neutral"], lr-virtual-list::part(variant-dot-neutral) { background: var(--lr-color-text-quiet); } [part~="variant-dot-brand"], lr-virtual-list::part(variant-dot-brand) { background: var(--lr-color-brand); } [part~="variant-dot-success"], lr-virtual-list::part(variant-dot-success) { background: var(--lr-color-success); } [part~="variant-dot-warning"], lr-virtual-list::part(variant-dot-warning) { background: var(--lr-color-warning); } [part~="variant-dot-danger"], lr-virtual-list::part(variant-dot-danger) { background: var(--lr-color-danger); } [part="entry-text"], lr-virtual-list::part(entry-text) { flex: 1 1 auto; min-inline-size: var(--lr-size-3ch); overflow-wrap: anywhere; font-size: var(--lr-font-size-sm); } [part="entry-text"] a:where(:any-link) { color: var(--lr-activity-feed-entry-text-link-color, var(--lr-color-brand)); } [part="entry-timestamp"], lr-virtual-list::part(entry-timestamp) { flex: 0 0 auto; font-size: var(--lr-font-size-xs); color: var(--lr-color-text-quiet); } @keyframes lr-activity-feed-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.35; } } @media (prefers-reduced-motion: reduce) { [part="toggle"] { transition: none !important; } [part="status-dot"] { animation: none !important; } } `;export{styles};
+import{disclosureHeader}from"../../../internal/layout-fragments.styles.js";import{css}from"lit";const styles=css` :host { display: block; --_lr-activity-feed-max-height: var(--lr-size-16rem); } [part="base"] { border: var(--lr-border-width-thin) solid var(--lr-activity-feed-border-color, var(--lr-color-border-subtle)); border-radius: var(--lr-activity-feed-radius, var(--lr-radius)); background: var(--lr-activity-feed-bg, var(--lr-color-surface)); overflow: hidden; } :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) [part="header"] { padding: var( --lr-activity-feed-compact-header-padding, var(--lr-space-2xs) var(--lr-space-s) ); gap: var(--lr-activity-feed-compact-header-gap, var(--lr-space-2xs)); } :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) [part="entry"], :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) lr-virtual-list::part(entry) { padding: var( --lr-activity-feed-compact-entry-padding, var(--lr-space-2xs) var(--lr-space-s) ); gap: var(--lr-activity-feed-compact-entry-gap, var(--lr-space-2xs)); } :host([frame="plain"]) [part="base"] { border: 0; border-radius: 0; background: transparent; } [part="header"] { ${disclosureHeader} box-sizing: border-box; } [part="header"]:hover { background: var(--lr-color-brand-quiet); color: var(--lr-color-brand); } [part="header"]:active { background: color-mix( in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active) ); } [part="header"]:focus-visible { outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color); outline-offset: calc(-1 * max(var(--lr-focus-ring-width), calc(var(--lr-focus-ring-width) + var(--lr-focus-ring-offset)))); } [part="toggle"] { display: inline-flex; flex: 0 0 auto; transition: transform var(--lr-transition-fast); } :host([expanded]) [part="toggle"] { transform: rotate(90deg); } :host(:not([expanded]):dir(rtl)) [part="toggle"] { transform: scaleX(-1); } [part="status-dot"] { flex: 0 0 auto; inline-size: var(--lr-size-0-5rem); block-size: var(--lr-size-0-5rem); border-radius: var(--lr-radius-pill); background: var(--lr-color-text-quiet); } :host([mode="live"]) [part="status-dot"] { background: var( --lr-activity-feed-live-status-color, var(--lr-color-brand) ); animation: var(--_lr-motion-animation, lr-activity-feed-pulse var(--lr-transition-ambient) infinite); } [part="label"] { flex: 0 1 auto; min-inline-size: 0; max-inline-size: 50%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: var(--lr-font-weight-semibold); } [part="summary"] { flex: 1 1 auto; min-inline-size: var(--lr-size-3ch); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: var(--lr-font-size-sm); color: var(--lr-color-text-quiet); text-align: start; } [part="body"] { display: flex; flex-direction: column; max-block-size: var( --lr-activity-feed-max-height, var(--_lr-activity-feed-max-height) ); overflow-x: hidden; overflow-y: auto; overscroll-behavior: contain; border-block-start: var(--lr-border-width-thin) solid var(--lr-activity-feed-border-color, var(--lr-color-border-subtle)); } [part="body"]:focus-visible { outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color); outline-offset: calc(-1 * max(var(--lr-focus-ring-width), calc(var(--lr-focus-ring-width) + var(--lr-focus-ring-offset)))); } [part="body"][hidden] { display: none; } lr-virtual-list { --lr-virtual-list-row-link-color: var(--lr-activity-feed-entry-text-link-color, var(--lr-color-brand)); display: block; inline-size: 100%; block-size: var( --lr-activity-feed-max-height, var(--_lr-activity-feed-max-height) ); } [part="entry"], lr-virtual-list::part(entry) { display: flex; flex-wrap: wrap; align-items: baseline; gap: var(--lr-space-xs); padding: var(--lr-space-2xs) var(--lr-space-m); } [part="entry-icon"], lr-virtual-list::part(entry-icon) { flex: 0 0 auto; display: inline-flex; align-items: center; inline-size: var(--lr-size-1em); } [part~="variant-dot"], lr-virtual-list::part(variant-dot) { display: block; inline-size: var(--lr-size-0-5rem); block-size: var(--lr-size-0-5rem); border-radius: var(--lr-radius-pill); } [part~="variant-dot-neutral"], lr-virtual-list::part(variant-dot-neutral) { background: var(--lr-color-text-quiet); } [part~="variant-dot-brand"], lr-virtual-list::part(variant-dot-brand) { background: var(--lr-color-brand); } [part~="variant-dot-success"], lr-virtual-list::part(variant-dot-success) { background: var(--lr-color-success); } [part~="variant-dot-warning"], lr-virtual-list::part(variant-dot-warning) { background: var(--lr-color-warning); } [part~="variant-dot-danger"], lr-virtual-list::part(variant-dot-danger) { background: var(--lr-color-danger); } [part="entry-text"], lr-virtual-list::part(entry-text) { flex: 1 1 auto; min-inline-size: var(--lr-size-3ch); overflow-wrap: anywhere; font-size: var(--lr-font-size-sm); } [part="entry-text"] a:where(:any-link) { color: var(--lr-activity-feed-entry-text-link-color, var(--lr-color-brand)); } [part="entry-timestamp"], lr-virtual-list::part(entry-timestamp) { flex: 0 0 auto; font-size: var(--lr-font-size-xs); color: var(--lr-color-text-quiet); } @keyframes lr-activity-feed-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.35; } } @media (prefers-reduced-motion: reduce) { [part="toggle"] { transition: none !important; } [part="status-dot"] { animation: none !important; } } [part='limit'] { margin: 0; padding: var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } `;export{styles};

package/dist/components/agent-tools/agent-trace/agent-trace.class.d.ts

@@ -1,4 +1,4 @@
-import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';export type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';import{type LyraSpan}from'../trace-tree/span.js';export type{LyraSpan}from'../trace-tree/span.js';export interface LyraAgentTraceEventMap{
+import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';export type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';import type{LyraSpan}from'../trace-tree/span.js';import type{TraceTreeSource}from'../trace-tree/trace-tree.class.js';export type{TraceTreeSource}from'../trace-tree/trace-tree.class.js';export type{LyraSpan}from'../trace-tree/span.js';export interface LyraAgentTraceEventMap{
 /** Bubbles, composed, from the composed `<lr-trace-tree>` (identical `{ spanId }` detail), or is
 *  fired directly when a handoff quick-jump entry is activated -- a host handles both origins
 *  through this one event. */
@@ -40,14 +40,19 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 * rendering never re-reads an admitted source row. Create a new collection and reassign it after
 * changes; mutating the assigned array does not update the view.
 *
+* With treeSource defined, the child owns the complete provider preorder and global timing
+* summary. The filter offers all six known kinds; the legacy handoff quick-jump list is omitted.
+* No source rows are copied into spans or scanned to discover kinds or handoffs.
+*
 * @customElement lr-agent-trace
 * @event lr-span-select - `detail: { spanId }` — a span was activated, from the tree or the handoff list.
 * @event lr-span-toggle - `detail: { spanId, expanded }` — a tree row was expanded or collapsed.
 * @event lr-span-visibility-change - `detail: { hiddenKinds }` — the span-kind filter changed.
 * @csspart base - The root wrapper.
-* @csspart filter - The composed `<lr-graph-legend>` filter row, only rendered while `spans` has at least one span.
+* @csspart filter - The composed `<lr-graph-legend>` filter row; all six kinds in provider mode, otherwise the kinds present in `spans`.
 * @csspart handoffs - The handoff quick-jump list wrapper, only rendered while at least one visible span has `kind: 'agent'`.
 * @csspart handoff - One handoff quick-jump entry (a `<button>` wrapping an `<lr-handoff-divider>`); carries `data-active`.
+* @csspart limit - Source admission limit notice when the composed tree has no projection notice.
 * @csspart tree - The composed `<lr-trace-tree>`.
 * @cssprop [--lr-agent-trace-handoff-active-bg=var(--lr-color-brand-quiet)] - Background of the active
 *   (`activeSpanId`) handoff quick-jump entry. Shadow Parts forbids an attribute selector after
@@ -60,11 +65,22 @@ export declare class LyraAgentTrace extends LyraElement<LyraAgentTraceEventMap>{
 /** Span sources can carry opaque provider metadata; the shared normalizer copies only its closed
 * display schema once, so cloning each whole source record would both lose opaque identity and
 * create an unsafe second traversal. */
-protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
+protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];private _treeSource;private sourceVersion;private sourceTree?;private forwardedTree?;private forwardedKinds?;
+/** Immutable full-source preorder, forwarded to the single trace-tree child.
+* Defined sources override legacy spans. Provider mode offers all six kind filters and omits
+* the legacy handoff list; expansion, selection, global timing summary and bounded rows belong
+* to the child. Reassign or requestUpdate() after changing the provider revision.
+* @default undefined */
+get treeSource():TraceTreeSource|undefined;set treeSource(value:TraceTreeSource|undefined);
+/** Reveals and focuses a full-source span using the child; false if absent or superseded. */
+revealSourceKey(key:string):Promise<boolean>;private forwardKinds;private bindTree;requestUpdate(name?:PropertyKey,oldValue?:unknown):void;disconnectedCallback():void;
 /** The full, unfiltered span array -- identical contract to `<lr-trace-tree>.spans`. Controlled
 *  and never mutated by this component; `activeSpanId` and its ancestor path reserve positions
-*  inside the shared 500-row projection before kind filtering. */
+*  inside the maxNodes projection (default 500) before kind filtering. */
 spans:readonly LyraSpan[];
+/** Maximum projected rows, from 1 to 5000. Invalid or unset values use 500.
+* Source admission keeps the first 10000 outer entries without cloning opaque metadata. */
+maxNodes:number;private get effectiveMaxNodes();private readonly announcements;private sourceNotice;private previousSourceNotice;private noticeInitialized;connectedCallback():void;adoptedCallback():void;private limitMessage;protected updated(changed:PropertyValues):void;
 /** Controlled selection, forwarded verbatim into the composed `<lr-trace-tree>`. Updated
 *  locally (and re-emitted as `lr-span-select`) whenever a span is activated from either the
 *  tree or the handoff quick-jump list, so a host can also treat it as a two-way binding. */
@@ -83,4 +99,4 @@ withTokens:boolean;
 withCost:boolean;
 /** Suppresses the inline duration bar on the composed `<lr-trace-tree>`, for dense/narrow
 *  embeddings. */
-withoutBars:boolean;private projectionSource?;private projectionActiveSpanId;private projectionCache?;private filteredSource?;private filteredKinds?;private filteredCache;private presentKindsSource?;private presentKindsCache;private handoffsSource?;private handoffsCache;private legendKinds?;private legendLabels;private legendTypes;private projectedSpans;private presentKinds;private filteredSpans;private handoffSpans;private handoffFromAgent;private handoffAccessibleLabel;private onVisibilityChange;private onVisibilityChangeProposal;private onTreeSpanSelect;private selectSpan;private renderFilter;private renderHandoff;private renderHandoffs;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-agent-trace':LyraAgentTrace;}}
+withoutBars:boolean;private projectionLimit;private projectionSource?;private projectionActiveSpanId;private projectionCache?;private filteredSource?;private filteredKinds?;private filteredCache;private presentKindsSource?;private presentKindsCache;private handoffsSource?;private handoffsCache;private legendKinds?;private legendLabels;private legendTypes;private projectedSpans;private presentKinds;private filteredSpans;private handoffSpans;private handoffFromAgent;private handoffAccessibleLabel;private onVisibilityChange;private onVisibilityChangeProposal;private onTreeSpanSelect;private selectSpan;private renderFilter;private renderHandoff;private renderHandoffs;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-agent-trace':LyraAgentTrace;}}

package/dist/components/agent-tools/agent-trace/agent-trace.class.js

@@ -1,36 +1,39 @@
-import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{repeat}from"lit/directives/repeat.js";import{LyraElement}from"../../../internal/lyra-element.js";import{styles}from"./agent-trace.styles.js";import{normalizeLyraSpans}from"../trace-tree/span.js";import{LYRA_DEFAULT_agentTraceFilterLabel,LYRA_DEFAULT_spanKindAgent,LYRA_DEFAULT_spanKindEmbedding,LYRA_DEFAULT_spanKindLlm,LYRA_DEFAULT_spanKindOther,LYRA_DEFAULT_spanKindRetriever,LYRA_DEFAULT_spanKindTool}from"../../../internal/default-strings/agent-tools.generated.js";import{LYRA_DEFAULT_copy,LYRA_DEFAULT_date,LYRA_DEFAULT_handoffFromToAgent,LYRA_DEFAULT_handoffToAgent,LYRA_DEFAULT_map,LYRA_DEFAULT_tokensIn,LYRA_DEFAULT_tokensOut}from"../../../internal/default-strings/shared.generated.js";const KIND_ORDER=["agent","llm","tool","retriever","embedding","other"],KIND_LABEL_KEY={agent:"spanKindAgent",llm:"spanKindLlm",tool:"spanKindTool",retriever:"spanKindRetriever",embedding:"spanKindEmbedding",other:"spanKindOther"};class LyraAgentTrace extends LyraElement{constructor(){super(...arguments),this.spans=[],this.activeSpanId=null,this.hiddenKinds=[],this.withTokens=!1,this.withCost=!1,this.withoutBars=!1,this.projectionActiveSpanId=null,this.filteredCache=[],this.presentKindsCache=[],this.handoffsCache=[],this.legendLabels=[],this.legendTypes=[],this.onVisibilityChange=e=>{e.stopPropagation(),this.hiddenKinds=e.detail.hiddenTypes,this.emit("lr-span-visibility-change",{hiddenKinds:[...this.hiddenKinds]})},this.onVisibilityChangeProposal=event=>{event.stopPropagation()},this.onTreeSpanSelect=e=>{this.activeSpanId=e.detail.spanId}}static{this.defaultStrings={...super.defaultStrings,agentTraceFilterLabel:LYRA_DEFAULT_agentTraceFilterLabel,copy:LYRA_DEFAULT_copy,date:LYRA_DEFAULT_date,handoffFromToAgent:LYRA_DEFAULT_handoffFromToAgent,handoffToAgent:LYRA_DEFAULT_handoffToAgent,map:LYRA_DEFAULT_map,spanKindAgent:LYRA_DEFAULT_spanKindAgent,spanKindEmbedding:LYRA_DEFAULT_spanKindEmbedding,spanKindLlm:LYRA_DEFAULT_spanKindLlm,spanKindOther:LYRA_DEFAULT_spanKindOther,spanKindRetriever:LYRA_DEFAULT_spanKindRetriever,spanKindTool:LYRA_DEFAULT_spanKindTool,tokensIn:LYRA_DEFAULT_tokensIn,tokensOut:LYRA_DEFAULT_tokensOut}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["spans","hiddenKinds"])}static{this.identityCollectionProperties=Object.freeze(["spans"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-span-visibility-change"])}projectedSpans(){return(this.projectionSource!==this.spans||this.projectionActiveSpanId!==this.activeSpanId)&&(this.projectionSource=this.spans,this.projectionActiveSpanId=this.activeSpanId,this.projectionCache=normalizeLyraSpans(this.spans,this.activeSpanId)),this.projectionCache}presentKinds(spans){if(this.presentKindsSource!==spans){this.presentKindsSource=spans;const present=new Set(spans.map(span=>span.kind));this.presentKindsCache=KIND_ORDER.filter(kind=>present.has(kind))}return this.presentKindsCache}filteredSpans(spans){if(this.filteredSource!==spans||this.filteredKinds!==this.hiddenKinds){this.filteredSource=spans,this.filteredKinds=this.hiddenKinds;const hidden=new Set(this.hiddenKinds);this.filteredCache=hidden.size===0?[...spans]:spans.filter(span=>!hidden.has(span.kind))}return this.filteredCache}handoffSpans(spans){return this.handoffsSource!==spans&&(this.handoffsSource=spans,this.handoffsCache=spans.filter(span=>span.kind==="agent")),this.handoffsCache}handoffFromAgent(span,byId){if(!span.parentId)return"";const parent=byId.get(span.parentId);return parent?.kind==="agent"?parent.name:""}handoffAccessibleLabel(span,fromAgent){return fromAgent?this.localize("handoffFromToAgent",void 0,{from:fromAgent,to:span.name}):this.localize("handoffToAgent",void 0,{agent:span.name})}selectSpan(id){this.activeSpanId=id,this.emit("lr-span-select",{spanId:id})}renderFilter(spans){const kinds=this.presentKinds(spans);if(kinds.length===0)return nothing;const labels=kinds.map(kind=>this.localize(KIND_LABEL_KEY[kind]));return(this.legendKinds!==kinds||labels.some((label,index)=>label!==this.legendLabels[index]))&&(this.legendKinds=kinds,this.legendLabels=labels,this.legendTypes=kinds.map((kind,index)=>({id:kind,label:labels[index]}))),html`
+import{__decorate}from"tslib";import{finiteCount}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{AnnouncementSinkController}from"../../../internal/announcer.js";import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{ref}from"lit/directives/ref.js";import{repeat}from"lit/directives/repeat.js";import{LyraElement}from"../../../internal/lyra-element.js";import{styles}from"./agent-trace.styles.js";import{projectLyraSpans}from"../trace-tree/span-projection.js";import{LYRA_DEFAULT_agentTraceFilterLabel,LYRA_DEFAULT_spanKindAgent,LYRA_DEFAULT_spanKindEmbedding,LYRA_DEFAULT_spanKindLlm,LYRA_DEFAULT_spanKindOther,LYRA_DEFAULT_spanKindRetriever,LYRA_DEFAULT_spanKindTool,LYRA_DEFAULT_spanProjectionLimit}from"../../../internal/default-strings/agent-tools.generated.js";import{LYRA_DEFAULT_collapse,LYRA_DEFAULT_copy,LYRA_DEFAULT_date,LYRA_DEFAULT_details,LYRA_DEFAULT_handoffFromToAgent,LYRA_DEFAULT_handoffToAgent,LYRA_DEFAULT_loading,LYRA_DEFAULT_map,LYRA_DEFAULT_open,LYRA_DEFAULT_tokensIn,LYRA_DEFAULT_tokensOut}from"../../../internal/default-strings/shared.generated.js";const EMPTY_SPANS=Object.freeze([]),KIND_ORDER=["agent","llm","tool","retriever","embedding","other"],KIND_LABEL_KEY={agent:"spanKindAgent",llm:"spanKindLlm",tool:"spanKindTool",retriever:"spanKindRetriever",embedding:"spanKindEmbedding",other:"spanKindOther"};class LyraAgentTrace extends LyraElement{constructor(){super(...arguments),this._treeSource=void 0,this.sourceVersion=0,this.bindTree=element=>{const tree=element;if(this.sourceTree=tree,!tree)return;const version=this.sourceVersion,source=this.treeSource;this.forwardKinds(tree),!(this.sourceTree!==tree||this.sourceVersion!==version||this.treeSource!==source)&&tree.treeSource!==source&&(tree.treeSource=source)},this.spans=[],this.maxNodes=500,this.announcements=new AnnouncementSinkController(this,{eager:["polite"]}),this.sourceNotice=!1,this.previousSourceNotice=!1,this.noticeInitialized=!1,this.activeSpanId=null,this.hiddenKinds=[],this.withTokens=!1,this.withCost=!1,this.withoutBars=!1,this.projectionLimit=0,this.projectionActiveSpanId=null,this.filteredCache=[],this.presentKindsCache=[],this.handoffsCache=[],this.legendLabels=[],this.legendTypes=[],this.onVisibilityChange=e=>{e.stopPropagation();const version=this.sourceVersion,source=this.treeSource;this.hiddenKinds=e.detail.hiddenTypes,!(!this.isConnected||this.sourceVersion!==version||this.treeSource!==source)&&this.emit("lr-span-visibility-change",{hiddenKinds:[...this.hiddenKinds]})},this.onVisibilityChangeProposal=event=>{event.stopPropagation()},this.onTreeSpanSelect=e=>{!this.isConnected||e.currentTarget!==this.sourceTree||this.sourceTree.treeSource!==this.treeSource||(this.activeSpanId=e.detail.spanId)}}static{this.defaultStrings={...super.defaultStrings,agentTraceFilterLabel:LYRA_DEFAULT_agentTraceFilterLabel,collapse:LYRA_DEFAULT_collapse,copy:LYRA_DEFAULT_copy,date:LYRA_DEFAULT_date,details:LYRA_DEFAULT_details,handoffFromToAgent:LYRA_DEFAULT_handoffFromToAgent,handoffToAgent:LYRA_DEFAULT_handoffToAgent,loading:LYRA_DEFAULT_loading,map:LYRA_DEFAULT_map,open:LYRA_DEFAULT_open,spanKindAgent:LYRA_DEFAULT_spanKindAgent,spanKindEmbedding:LYRA_DEFAULT_spanKindEmbedding,spanKindLlm:LYRA_DEFAULT_spanKindLlm,spanKindOther:LYRA_DEFAULT_spanKindOther,spanKindRetriever:LYRA_DEFAULT_spanKindRetriever,spanKindTool:LYRA_DEFAULT_spanKindTool,spanProjectionLimit:LYRA_DEFAULT_spanProjectionLimit,tokensIn:LYRA_DEFAULT_tokensIn,tokensOut:LYRA_DEFAULT_tokensOut}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["spans","hiddenKinds"])}static{this.identityCollectionProperties=Object.freeze(["spans"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-span-visibility-change"])}get treeSource(){return this._treeSource}set treeSource(value){const previous=this._treeSource;this._treeSource=value,this.sourceVersion++;const tree=this.sourceTree;tree&&(tree.treeSource=value),this.requestUpdate("treeSource",previous)}async revealSourceKey(key){const source=this.treeSource;if(source===void 0)return!1;const version=this.sourceVersion,owner=this.ownerDocument,current=()=>this.isConnected&&this.ownerDocument===owner&&this.treeSource===source&&this.sourceVersion===version;await this.updateComplete;const tree=this.sourceTree;if(!current()||!tree||tree.treeSource!==source)return!1;const revealed=await tree.revealSourceKey(key);return current()&&this.sourceTree===tree&&tree.treeSource===source&&revealed}forwardKinds(tree){(this.forwardedTree!==tree||this.forwardedKinds!==this.hiddenKinds)&&(this.forwardedTree=tree,this.forwardedKinds=this.hiddenKinds,tree.hiddenKinds=this.hiddenKinds)}requestUpdate(name,oldValue){name==="hiddenKinds"&&this.sourceTree&&this.forwardKinds(this.sourceTree),name===void 0&&this._treeSource!==void 0&&(this.sourceVersion++,this.sourceTree?.requestUpdate()),super.requestUpdate(name,oldValue)}disconnectedCallback(){this.sourceVersion++,super.disconnectedCallback()}get effectiveMaxNodes(){return Math.max(1,Math.min(5e3,finiteCount(this.maxNodes,500)))}connectedCallback(){super.connectedCallback(),this.noticeInitialized=this.hasUpdated,this.previousSourceNotice=this.sourceNotice}adoptedCallback(){super.adoptedCallback(),this.sourceVersion++,this.announcements.adopted()}limitMessage(){return this.localize("spanProjectionLimit",void 0,{count:getNumberFormat(this.effectiveLocale).format(this.effectiveMaxNodes)})}updated(changed){if(super.updated(changed),this.treeSource!==void 0)return;const version=this.sourceVersion,owner=this.ownerDocument,notice=this.sourceNotice,current=()=>this.isConnected&&this.ownerDocument===owner&&this.sourceVersion===version&&this.treeSource===void 0&&this.sourceNotice===notice;if(this.noticeInitialized&&notice&&!this.previousSourceNotice){const message=this.limitMessage();if(!current()||(this.announcements.announcePolite(message),!current()))return}this.noticeInitialized=!0,this.previousSourceNotice=notice}projectedSpans(){return(this.projectionSource!==this.spans||this.projectionActiveSpanId!==this.activeSpanId||this.projectionLimit!==this.effectiveMaxNodes)&&(this.projectionSource=this.spans,this.projectionActiveSpanId=this.activeSpanId,this.projectionLimit=this.effectiveMaxNodes,this.projectionCache=projectLyraSpans(this.spans,this.activeSpanId,this.effectiveMaxNodes)),this.projectionCache}presentKinds(spans){if(this.presentKindsSource!==spans){this.presentKindsSource=spans;const present=new Set(spans.map(span=>span.kind));this.presentKindsCache=KIND_ORDER.filter(kind=>present.has(kind))}return this.presentKindsCache}filteredSpans(spans){if(this.filteredSource!==spans||this.filteredKinds!==this.hiddenKinds){this.filteredSource=spans,this.filteredKinds=this.hiddenKinds;const hidden=new Set(this.hiddenKinds);this.filteredCache=hidden.size===0?[...spans]:spans.filter(span=>!hidden.has(span.kind))}return this.filteredCache}handoffSpans(spans){return this.handoffsSource!==spans&&(this.handoffsSource=spans,this.handoffsCache=spans.filter(span=>span.kind==="agent")),this.handoffsCache}handoffFromAgent(span,byId){if(!span.parentId)return"";const parent=byId.get(span.parentId);return parent?.kind==="agent"?parent.name:""}handoffAccessibleLabel(span,fromAgent){return fromAgent?this.localize("handoffFromToAgent",void 0,{from:fromAgent,to:span.name}):this.localize("handoffToAgent",void 0,{agent:span.name})}selectSpan(id){this.treeSource!==void 0||!this.isConnected||(this.activeSpanId=id,this.emit("lr-span-select",{spanId:id}))}renderFilter(spans){const version=this.sourceVersion,hiddenKinds=this.hiddenKinds,kinds=this.treeSource!==void 0?KIND_ORDER:this.presentKinds(spans);if(kinds.length===0)return nothing;const labels=kinds.map(kind=>this.localize(KIND_LABEL_KEY[kind])),label=this.localize("agentTraceFilterLabel");if(version!==this.sourceVersion||hiddenKinds!==this.hiddenKinds)return nothing;(this.legendKinds!==kinds||labels.some((label2,index)=>label2!==this.legendLabels[index]))&&(this.legendKinds=kinds,this.legendLabels=labels,this.legendTypes=kinds.map((kind,index)=>({id:kind,label:labels[index]})));const current=event=>this.isConnected&&this.sourceVersion===version&&this.hiddenKinds===hiddenKinds&&event.currentTarget?.getRootNode()===this.renderRoot;return html`
       <lr-graph-legend
         part="filter"
-        .label=${this.localize("agentTraceFilterLabel")}
+        .label=${label}
         .types=${this.legendTypes}
         .hiddenTypes=${this.hiddenKinds}
-        @lr-visibility-change-request=${this.onVisibilityChangeProposal}
-        @lr-visibility-change=${this.onVisibilityChange}
+        @lr-visibility-change-request=${event=>{this.onVisibilityChangeProposal(event),current(event)||event.preventDefault()}}
+        @lr-visibility-change=${event=>{event.stopPropagation(),current(event)&&this.onVisibilityChange(event)}}
       ></lr-graph-legend>
-    `}renderHandoff(span,byId){const fromAgent=this.handoffFromAgent(span,byId),isActive=this.activeSpanId===span.id;return html`
+    `}renderHandoff(span,byId){const version=this.sourceVersion,spans=this.spans,fromAgent=this.handoffFromAgent(span,byId),isActive=this.activeSpanId===span.id;return html`
       <button
         part="handoff"
         type="button"
         aria-label=${this.handoffAccessibleLabel(span,fromAgent)}
         aria-current=${isActive?"true":"false"}
         ?data-active=${isActive}
-        @click=${()=>this.selectSpan(span.id)}
+        @click=${event=>{this.treeSource===void 0&&this.sourceVersion===version&&this.spans===spans&&event.currentTarget?.getRootNode()===this.renderRoot&&this.selectSpan(span.id)}}
       >
         <lr-handoff-divider aria-hidden="true" to-agent=${span.name} from-agent=${fromAgent}></lr-handoff-divider>
       </button>
-    `}renderHandoffs(spans,byId){const handoffs=this.handoffSpans(spans);return handoffs.length===0?nothing:html`<div part="handoffs">${repeat(handoffs,span=>span.id,span=>this.renderHandoff(span,byId))}</div>`}render(){const projection=this.projectedSpans(),filteredSpans=this.filteredSpans(projection.spans);return html`
+    `}renderHandoffs(spans,byId){const handoffs=this.handoffSpans(spans);return handoffs.length===0?nothing:html`<div part="handoffs">${repeat(handoffs,span=>span.id,span=>this.renderHandoff(span,byId))}</div>`}render(){const sourceMode=this.treeSource!==void 0,projection=sourceMode?void 0:this.projectedSpans(),filteredSpans=projection?this.filteredSpans(projection.spans):EMPTY_SPANS;return this.sourceNotice=!!projection&&!!publicCollectionTruncation(this,"spans")&&!projection.truncated,html`
       <div part="base">
-        ${this.renderFilter(projection.spans)} ${this.renderHandoffs(filteredSpans,projection.byId)}
+        ${this.renderFilter(projection?.spans??EMPTY_SPANS)} ${projection?this.renderHandoffs(filteredSpans,projection.byId):nothing}
         <lr-trace-tree
           part="tree"
-          .spans=${guard([this.spans],()=>this.spans)}
-          .hiddenKinds=${this.hiddenKinds}
+          .maxNodes=${this.effectiveMaxNodes}
+          .spans=${sourceMode?EMPTY_SPANS:guard([this.spans],()=>this.spans)}
           .activeSpanId=${this.activeSpanId}
           .label=${this.label}
+          .strings=${this.strings}
           ?with-tokens=${this.withTokens}
           ?with-cost=${this.withCost}
           ?without-bars=${this.withoutBars}
           @lr-span-select=${this.onTreeSpanSelect}
+          ${ref(this.bindTree)}
         ></lr-trace-tree>
+        ${this.sourceNotice?html`<p part="limit" role="note">${this.limitMessage()}</p>`:nothing}
       </div>
-    `}}__decorate([property({attribute:!1})],LyraAgentTrace.prototype,"spans",void 0),__decorate([property({attribute:"active-span-id"})],LyraAgentTrace.prototype,"activeSpanId",void 0),__decorate([property({attribute:!1})],LyraAgentTrace.prototype,"hiddenKinds",void 0),__decorate([property()],LyraAgentTrace.prototype,"label",void 0),__decorate([property({type:Boolean,attribute:"with-tokens"})],LyraAgentTrace.prototype,"withTokens",void 0),__decorate([property({type:Boolean,attribute:"with-cost"})],LyraAgentTrace.prototype,"withCost",void 0),__decorate([property({type:Boolean,attribute:"without-bars"})],LyraAgentTrace.prototype,"withoutBars",void 0);export{LyraAgentTrace};
+    `}}__decorate([property({attribute:!1})],LyraAgentTrace.prototype,"treeSource",null),__decorate([property({attribute:!1})],LyraAgentTrace.prototype,"spans",void 0),__decorate([property({type:Number,attribute:"max-nodes"})],LyraAgentTrace.prototype,"maxNodes",void 0),__decorate([property({attribute:"active-span-id"})],LyraAgentTrace.prototype,"activeSpanId",void 0),__decorate([property({attribute:!1})],LyraAgentTrace.prototype,"hiddenKinds",void 0),__decorate([property()],LyraAgentTrace.prototype,"label",void 0),__decorate([property({type:Boolean,attribute:"with-tokens"})],LyraAgentTrace.prototype,"withTokens",void 0),__decorate([property({type:Boolean,attribute:"with-cost"})],LyraAgentTrace.prototype,"withCost",void 0),__decorate([property({type:Boolean,attribute:"without-bars"})],LyraAgentTrace.prototype,"withoutBars",void 0);export{LyraAgentTrace};

package/dist/components/agent-tools/agent-trace/agent-trace.styles.js

@@ -1 +1 @@
-import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; container-type: inline-size; contain-intrinsic-inline-size: var(--lr-size-20rem); } [part='base'] { display: flex; flex-direction: column; gap: var(--lr-space-m); max-inline-size: 100%; box-sizing: border-box; } [part='filter'] { max-inline-size: 100%; } [part='handoffs'] { display: flex; flex-direction: column; gap: var(--lr-space-2xs); padding: var(--lr-space-xs); border: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); border-radius: var(--lr-radius); background: var(--lr-color-surface-raised); box-sizing: border-box; max-inline-size: 100%; } [part='handoff'] { display: block; inline-size: 100%; ${iconHitTarget} max-inline-size: 100%; box-sizing: border-box; padding: 0; border: none; background: none; font: inherit; text-align: start; color: inherit; cursor: pointer; border-radius: var(--lr-radius-xs); transition: background-color var(--lr-transition-fast), color var(--lr-transition-fast); } [part='handoff']:hover { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-hover)); } [part='handoff']:active { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='handoff']:focus-visible { ${focusRing} } [part='handoff'][data-active] { background: var(--lr-agent-trace-handoff-active-bg, var(--lr-color-brand-quiet)); } [part='handoff'][data-active]:active { background: color-mix( in oklab, var(--lr-agent-trace-handoff-active-bg, var(--lr-color-brand-quiet)), var(--lr-color-mix-partner) var(--lr-color-mix-active) ); } [part='tree'] { max-inline-size: 100%; } `;export{styles};
+import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; container-type: inline-size; contain-intrinsic-inline-size: var(--lr-size-20rem); } [part='base'] { display: flex; flex-direction: column; gap: var(--lr-space-m); max-inline-size: 100%; box-sizing: border-box; } [part='limit'] { margin: var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-xs); } [part='filter'] { max-inline-size: 100%; } [part='handoffs'] { display: flex; flex-direction: column; gap: var(--lr-space-2xs); padding: var(--lr-space-xs); border: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); border-radius: var(--lr-radius); background: var(--lr-color-surface-raised); box-sizing: border-box; max-inline-size: 100%; } [part='handoff'] { display: block; inline-size: 100%; ${iconHitTarget} max-inline-size: 100%; box-sizing: border-box; padding: 0; border: none; background: none; font: inherit; text-align: start; color: inherit; cursor: pointer; border-radius: var(--lr-radius-xs); transition: background-color var(--lr-transition-fast), color var(--lr-transition-fast); } [part='handoff']:hover { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-hover)); } [part='handoff']:active { background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='handoff']:focus-visible { ${focusRing} } [part='handoff'][data-active] { background: var(--lr-agent-trace-handoff-active-bg, var(--lr-color-brand-quiet)); } [part='handoff'][data-active]:active { background: color-mix( in oklab, var(--lr-agent-trace-handoff-active-bg, var(--lr-color-brand-quiet)), var(--lr-color-mix-partner) var(--lr-color-mix-active) ); } [part='tree'] { max-inline-size: 100%; } `;export{styles};

package/dist/components/agent-tools/confirm-bar/confirm-bar.class.js

@@ -1,4 +1,4 @@
-import{__decorate}from"tslib";import{html,nothing,svg}from"lit";import{property,query,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{renderApproveAction,renderDenyAction}from"../approval-action-buttons.js";import{hasRealContent,hostAriaLabel,nextId}from"../../../internal/a11y.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import{deferComposedFocusRepair,focusFirstAvailable,isComposedFocusAvailable,repairComposedFocus}from"../../../internal/focus-navigation.js";import{markVetoGuardWrite,VetoWriteGuard}from"../../../internal/veto-write-guard.js";import{resolveLocalizedParts}from"../../../internal/localization-runtime.js";import{optionalLiteralSetConverter}from"../../../internal/converters.js";import"../../layout/details/details.class.js";import"../../utility/json-viewer/json-viewer.class.js";import"../../utility/live-region/live-region.class.js";import"../../forms/button/button.class.js";import{styles}from"./confirm-bar.styles.js";import{approvalAction}from"../approval-state.js";import{createWaitUntil}from"../../../internal/approval-wait-until.js";import{LYRA_DEFAULT_confirmApproved,LYRA_DEFAULT_confirmApprovedAnnounce,LYRA_DEFAULT_confirmDenied,LYRA_DEFAULT_confirmDeniedAnnounce,LYRA_DEFAULT_toolApprovalArgsLabel,LYRA_DEFAULT_toolApprovalGenericTool,LYRA_DEFAULT_toolApprovalHeading}from"../../../internal/default-strings/agent-tools.generated.js";import{LYRA_DEFAULT_approve,LYRA_DEFAULT_collapse,LYRA_DEFAULT_date,LYRA_DEFAULT_deny,LYRA_DEFAULT_details,LYRA_DEFAULT_loading,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_progress,LYRA_DEFAULT_search,LYRA_DEFAULT_select,LYRA_DEFAULT_viewerSearchActiveMatch,LYRA_DEFAULT_viewerSearchMatchCount,LYRA_DEFAULT_viewerSearchNoMatches}from"../../../internal/default-strings/shared.generated.js";const CONFIRM_BAR_DECISION=optionalLiteralSetConverter(["approved","denied"]),CONFIRM_BAR_PENDING_ACTION=optionalLiteralSetConverter(["approve","deny"]),ICON_VIEW_BOX="0 0 24 24",ICON_STROKE_WIDTH="1.75";function approvedIcon(){return svg`
+import{__decorate}from"tslib";import{html,nothing,svg}from"lit";import{property,query,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{renderApproveAction,renderDenyAction}from"../approval-action-buttons.js";import{hasRealContent,hostAriaLabel,nextId}from"../../../internal/a11y.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import{deferComposedFocusRepair,focusFirstAvailable,isComposedFocusAvailable,repairComposedFocus}from"../../../internal/focus-navigation.js";import{markVetoGuardWrite,VetoWriteGuard}from"../../../internal/veto-write-guard.js";import{resolveLocalizedParts}from"../../../internal/localization-runtime.js";import{optionalLiteralSetConverter}from"../../../internal/converters.js";import"../../layout/details/details.class.js";import"../../utility/json-viewer/json-viewer.class.js";import"../../utility/live-region/live-region.class.js";import"../../forms/button/button.class.js";import{styles}from"./confirm-bar.styles.js";import{approvalAction}from"../approval-state.js";import{createWaitUntil}from"../../../internal/approval-wait-until.js";import{LYRA_DEFAULT_confirmApproved,LYRA_DEFAULT_confirmApprovedAnnounce,LYRA_DEFAULT_confirmDenied,LYRA_DEFAULT_confirmDeniedAnnounce,LYRA_DEFAULT_toolApprovalArgsLabel,LYRA_DEFAULT_toolApprovalGenericTool,LYRA_DEFAULT_toolApprovalHeading}from"../../../internal/default-strings/agent-tools.generated.js";import{LYRA_DEFAULT_approve,LYRA_DEFAULT_collapse,LYRA_DEFAULT_copy,LYRA_DEFAULT_date,LYRA_DEFAULT_deny,LYRA_DEFAULT_details,LYRA_DEFAULT_loading,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_progress,LYRA_DEFAULT_search,LYRA_DEFAULT_select,LYRA_DEFAULT_viewerSearchActiveMatch,LYRA_DEFAULT_viewerSearchMatchCount,LYRA_DEFAULT_viewerSearchNoMatches}from"../../../internal/default-strings/shared.generated.js";const CONFIRM_BAR_DECISION=optionalLiteralSetConverter(["approved","denied"]),CONFIRM_BAR_PENDING_ACTION=optionalLiteralSetConverter(["approve","deny"]),ICON_VIEW_BOX="0 0 24 24",ICON_STROKE_WIDTH="1.75";function approvedIcon(){return svg`
     <svg width="1em" height="1em" viewBox=${ICON_VIEW_BOX} fill="none" stroke="currentColor" stroke-width=${ICON_STROKE_WIDTH} stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">
       <circle cx="12" cy="12" r="9"></circle>
       <polyline points="8 12.5 11 15.5 16 9.5"></polyline>
@@ -9,7 +9,7 @@ import{__decorate}from"tslib";import{html,nothing,svg}from"lit";import{property,
       <line x1="9" y1="9" x2="15" y2="15"></line>
       <line x1="15" y1="9" x2="9" y2="15"></line>
     </svg>
-  `}class LyraConfirmBar extends LyraElement{constructor(){super(...arguments),this.toolName="",this.heading="",this.headingLevel="none",this.args=void 0,this._decision=null,this._pending=null,this.dispatchWriteGuard=new VetoWriteGuard,this.disabled=!1,this.variant="neutral",this.size="m",this.frame="card",this.autofocus=!1,this.escapeDenies=!1,this.returnFocusTo=null,this.hasBodySlot=!1,this.headingId=nextId("confirm-bar-heading"),this.deferralGeneration=0,this.onBodySlotChange=e=>{this.hasBodySlot=hasRealContent(e.target.assignedNodes({flatten:!0}))},this.onBaseKeyDown=event=>{if(!this.escapeDenies||event.key!=="Escape")return;const path=event.composedPath(),inOpenPopup=path.slice(0,path.indexOf(this)).some(node=>node instanceof Element&&node.hasAttribute("open"));if(event.defaultPrevented||event.isComposing||inOpenPopup)return;const decisionBefore=this.decision,pendingBefore=this.pendingAction;this.decide("denied"),(this.decision!==decisionBefore||this.pendingAction!==pendingBefore)&&event.stopPropagation()},this.decisionDispatching=!1}static{this.defaultStrings={...super.defaultStrings,approve:LYRA_DEFAULT_approve,collapse:LYRA_DEFAULT_collapse,confirmApproved:LYRA_DEFAULT_confirmApproved,confirmApprovedAnnounce:LYRA_DEFAULT_confirmApprovedAnnounce,confirmDenied:LYRA_DEFAULT_confirmDenied,confirmDeniedAnnounce:LYRA_DEFAULT_confirmDeniedAnnounce,date:LYRA_DEFAULT_date,deny:LYRA_DEFAULT_deny,details:LYRA_DEFAULT_details,loading:LYRA_DEFAULT_loading,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,progress:LYRA_DEFAULT_progress,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select,toolApprovalArgsLabel:LYRA_DEFAULT_toolApprovalArgsLabel,toolApprovalGenericTool:LYRA_DEFAULT_toolApprovalGenericTool,toolApprovalHeading:LYRA_DEFAULT_toolApprovalHeading,viewerSearchActiveMatch:LYRA_DEFAULT_viewerSearchActiveMatch,viewerSearchMatchCount:LYRA_DEFAULT_viewerSearchMatchCount,viewerSearchNoMatches:LYRA_DEFAULT_viewerSearchNoMatches}}emitApproveRequest(detail){return this.emit("lr-approve-request",Object.freeze(detail),{cancelable:!0})}emitDenyRequest(detail){return this.emit("lr-deny-request",Object.freeze(detail),{cancelable:!0})}static{this.styles=[LyraElement.styles,styles]}get decision(){return this._decision}set decision(value){const previous=this._decision;this._decision=CONFIRM_BAR_DECISION.normalizeReflected(this,"decision",value)??null,markVetoGuardWrite(this.dispatchWriteGuard),this.requestUpdate("decision",previous)}get pendingAction(){return this._pending}set pendingAction(value){const previous=this._pending;this._pending=CONFIRM_BAR_PENDING_ACTION.normalizeReflected(this,"pending-action",value)??null,markVetoGuardWrite(this.dispatchWriteGuard),this.requestUpdate("pendingAction",previous)}willUpdate(changed){if(super.willUpdate(changed),!this.hasUpdated){const defaultSlotNodes=Array.from(this.childNodes).filter(node=>node.nodeType!==Node.ELEMENT_NODE||!node.getAttribute("slot"));this.hasBodySlot=hasRealContent(defaultSlotNodes)}changed.has("decision")&&changed.get("decision")!==void 0&&this.decision!=null&&this.pendingAction!=null&&(this.handOffDecidedFocus(),this.pendingAction=null)}firstUpdated(changed){super.firstUpdated(changed),this.autofocus&&this.focusInitial()}focusInitial(){this.updateComplete.then(async()=>{if(!this.isConnected)return;const deny=this.renderRoot.querySelector('[part="deny-button"]');if(await deny?.updateComplete,!this.isConnected)return;(deny&&isComposedFocusAvailable(deny)?deny:this.statusEl)?.focus()})}decide(next){if(!this.decisionDispatching){this.decisionDispatching=!0;try{if(this.disabled||this.decision!=null||this.pendingAction!=null)return;const{waitUntil,deferrals,seal}=createWaitUntil("confirm-bar");this.dispatchWriteGuard.open();const event=next==="approved"?this.emitApproveRequest({args:this.args,waitUntil}):this.emitDenyRequest({waitUntil});seal();const listenerResolvedItself=this.dispatchWriteGuard.touched;if(deferrals.length>0||event.defaultPrevented){if(this.statusEl?.focus(),listenerResolvedItself){for(const deferral of deferrals)deferral.catch(()=>{});return}this.pendingAction=approvalAction(next),deferrals.length>0&&this.awaitDeferredDecision(Promise.all(deferrals),next);return}if(listenerResolvedItself)return;this.handOffDecidedFocus(),this.decision=next}finally{this.decisionDispatching=!1}}}awaitDeferredDecision(promise,next){const action=approvalAction(next);this.deferralGeneration+=1;const generation=this.deferralGeneration,stillOurs=()=>generation===this.deferralGeneration&&this.decision==null&&this.pendingAction===action;promise.then(()=>{stillOurs()&&(this.decision=next)},()=>{stillOurs()&&(this.pendingAction=null,this.returnFocusAfterBounce(action))})}returnFocusAfterBounce(action){this.updateComplete.then(()=>{!this.isConnected||this.decision!=null||this.pendingAction!=null||repairComposedFocus(this,()=>this.renderRoot.querySelector(`[part="${action}-button"]`))})}resolvedReturnFocusTarget(){const target=this.returnFocusTo;return typeof target=="function"?target():target}handOffDecidedFocus(){const target=this.resolvedReturnFocusTarget();target&&focusFirstAvailable([target])||(focusFirstAvailable([this.statusEl]),typeof this.returnFocusTo=="function"&&this.statusEl&&deferComposedFocusRepair(this,this.statusEl,()=>this.resolvedReturnFocusTarget()))}updated(changed){super.updated(changed);const decision=this.decision;if(changed.has("decision")&&changed.get("decision")!==void 0&&decision!=null){const key=decision==="approved"?"confirmApprovedAnnounce":"confirmDeniedAnnounce";this.liveRegion?.announce(this.localize(key),{force:!0}),this.emit("lr-decision-settled",{decision})}}renderHeading(){if(this.heading)return html`${this.heading}`;const toolName=this.toolName||this.localize("toolApprovalGenericTool"),template=this.localize("toolApprovalHeading"),pieces=resolveLocalizedParts(template,marker=>this.localize("toolApprovalHeading",void 0,{tool:marker}));return html`${pieces.map((piece,index)=>index<pieces.length-1?html`${piece}<span part="tool-name" dir="auto">${toolName}</span>`:piece)}`}statusText(){return this.decision==="approved"?this.localize("confirmApproved"):this.localize("confirmDenied")}stopNestedLifecycle(event){event.stopPropagation()}render(){const decided=this.decision!=null,hostLabel=hostAriaLabel(this),headingLevel=resolveHeadingLevel(this.headingLevel??"none");return html`
+  `}class LyraConfirmBar extends LyraElement{constructor(){super(...arguments),this.toolName="",this.heading="",this.headingLevel="none",this.args=void 0,this._decision=null,this._pending=null,this.dispatchWriteGuard=new VetoWriteGuard,this.disabled=!1,this.variant="neutral",this.size="m",this.frame="card",this.autofocus=!1,this.escapeDenies=!1,this.returnFocusTo=null,this.hasBodySlot=!1,this.headingId=nextId("confirm-bar-heading"),this.deferralGeneration=0,this.onBodySlotChange=e=>{this.hasBodySlot=hasRealContent(e.target.assignedNodes({flatten:!0}))},this.onBaseKeyDown=event=>{if(!this.escapeDenies||event.key!=="Escape")return;const path=event.composedPath(),inOpenPopup=path.slice(0,path.indexOf(this)).some(node=>node instanceof Element&&node.hasAttribute("open"));if(event.defaultPrevented||event.isComposing||inOpenPopup)return;const decisionBefore=this.decision,pendingBefore=this.pendingAction;this.decide("denied"),(this.decision!==decisionBefore||this.pendingAction!==pendingBefore)&&event.stopPropagation()},this.decisionDispatching=!1}static{this.defaultStrings={...super.defaultStrings,approve:LYRA_DEFAULT_approve,collapse:LYRA_DEFAULT_collapse,confirmApproved:LYRA_DEFAULT_confirmApproved,confirmApprovedAnnounce:LYRA_DEFAULT_confirmApprovedAnnounce,confirmDenied:LYRA_DEFAULT_confirmDenied,confirmDeniedAnnounce:LYRA_DEFAULT_confirmDeniedAnnounce,copy:LYRA_DEFAULT_copy,date:LYRA_DEFAULT_date,deny:LYRA_DEFAULT_deny,details:LYRA_DEFAULT_details,loading:LYRA_DEFAULT_loading,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,progress:LYRA_DEFAULT_progress,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select,toolApprovalArgsLabel:LYRA_DEFAULT_toolApprovalArgsLabel,toolApprovalGenericTool:LYRA_DEFAULT_toolApprovalGenericTool,toolApprovalHeading:LYRA_DEFAULT_toolApprovalHeading,viewerSearchActiveMatch:LYRA_DEFAULT_viewerSearchActiveMatch,viewerSearchMatchCount:LYRA_DEFAULT_viewerSearchMatchCount,viewerSearchNoMatches:LYRA_DEFAULT_viewerSearchNoMatches}}emitApproveRequest(detail){return this.emit("lr-approve-request",Object.freeze(detail),{cancelable:!0})}emitDenyRequest(detail){return this.emit("lr-deny-request",Object.freeze(detail),{cancelable:!0})}static{this.styles=[LyraElement.styles,styles]}get decision(){return this._decision}set decision(value){const previous=this._decision;this._decision=CONFIRM_BAR_DECISION.normalizeReflected(this,"decision",value)??null,markVetoGuardWrite(this.dispatchWriteGuard),this.requestUpdate("decision",previous)}get pendingAction(){return this._pending}set pendingAction(value){const previous=this._pending;this._pending=CONFIRM_BAR_PENDING_ACTION.normalizeReflected(this,"pending-action",value)??null,markVetoGuardWrite(this.dispatchWriteGuard),this.requestUpdate("pendingAction",previous)}willUpdate(changed){if(super.willUpdate(changed),!this.hasUpdated){const defaultSlotNodes=Array.from(this.childNodes).filter(node=>node.nodeType!==Node.ELEMENT_NODE||!node.getAttribute("slot"));this.hasBodySlot=hasRealContent(defaultSlotNodes)}changed.has("decision")&&changed.get("decision")!==void 0&&this.decision!=null&&this.pendingAction!=null&&(this.handOffDecidedFocus(),this.pendingAction=null)}firstUpdated(changed){super.firstUpdated(changed),this.autofocus&&this.focusInitial()}focusInitial(){this.updateComplete.then(async()=>{if(!this.isConnected)return;const deny=this.renderRoot.querySelector('[part="deny-button"]');if(await deny?.updateComplete,!this.isConnected)return;(deny&&isComposedFocusAvailable(deny)?deny:this.statusEl)?.focus()})}decide(next){if(!this.decisionDispatching){this.decisionDispatching=!0;try{if(this.disabled||this.decision!=null||this.pendingAction!=null)return;const{waitUntil,deferrals,seal}=createWaitUntil("confirm-bar");this.dispatchWriteGuard.open();const event=next==="approved"?this.emitApproveRequest({args:this.args,waitUntil}):this.emitDenyRequest({waitUntil});seal();const listenerResolvedItself=this.dispatchWriteGuard.touched;if(deferrals.length>0||event.defaultPrevented){if(this.statusEl?.focus(),listenerResolvedItself){for(const deferral of deferrals)deferral.catch(()=>{});return}this.pendingAction=approvalAction(next),deferrals.length>0&&this.awaitDeferredDecision(Promise.all(deferrals),next);return}if(listenerResolvedItself)return;this.handOffDecidedFocus(),this.decision=next}finally{this.decisionDispatching=!1}}}awaitDeferredDecision(promise,next){const action=approvalAction(next);this.deferralGeneration+=1;const generation=this.deferralGeneration,stillOurs=()=>generation===this.deferralGeneration&&this.decision==null&&this.pendingAction===action;promise.then(()=>{stillOurs()&&(this.decision=next)},()=>{stillOurs()&&(this.pendingAction=null,this.returnFocusAfterBounce(action))})}returnFocusAfterBounce(action){this.updateComplete.then(()=>{!this.isConnected||this.decision!=null||this.pendingAction!=null||repairComposedFocus(this,()=>this.renderRoot.querySelector(`[part="${action}-button"]`))})}resolvedReturnFocusTarget(){const target=this.returnFocusTo;return typeof target=="function"?target():target}handOffDecidedFocus(){const target=this.resolvedReturnFocusTarget();target&&focusFirstAvailable([target])||(focusFirstAvailable([this.statusEl]),typeof this.returnFocusTo=="function"&&this.statusEl&&deferComposedFocusRepair(this,this.statusEl,()=>this.resolvedReturnFocusTarget()))}updated(changed){super.updated(changed);const decision=this.decision;if(changed.has("decision")&&changed.get("decision")!==void 0&&decision!=null){const key=decision==="approved"?"confirmApprovedAnnounce":"confirmDeniedAnnounce";this.liveRegion?.announce(this.localize(key),{force:!0}),this.emit("lr-decision-settled",{decision})}}renderHeading(){if(this.heading)return html`${this.heading}`;const toolName=this.toolName||this.localize("toolApprovalGenericTool"),template=this.localize("toolApprovalHeading"),pieces=resolveLocalizedParts(template,marker=>this.localize("toolApprovalHeading",void 0,{tool:marker}));return html`${pieces.map((piece,index)=>index<pieces.length-1?html`${piece}<span part="tool-name" dir="auto">${toolName}</span>`:piece)}`}statusText(){return this.decision==="approved"?this.localize("confirmApproved"):this.localize("confirmDenied")}stopNestedLifecycle(event){event.stopPropagation()}render(){const decided=this.decision!=null,hostLabel=hostAriaLabel(this),headingLevel=resolveHeadingLevel(this.headingLevel??"none");return html`
       <div
         part="base"
         role="group"

package/dist/components/agent-tools/eval-dataset/eval-dataset.class.d.ts

@@ -1,4 +1,4 @@
-import'../../forms/input/input.class.js';import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraTableEventMap}from'../../data/table/table.class.js';import type{LyraExportFormatOption}from'../../utility/export-button/export-button.class.js';
+import type{LyraPageSource}from'../../../data-sources.js';import'../../forms/input/input.class.js';import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraTableEventMap}from'../../data/table/table.class.js';import type{LyraExportFormatOption}from'../../utility/export-button/export-button.class.js';
 /**
 * One row of an evaluation dataset -- a single labeled test case an eval run scores a
 * model/prompt against. Deliberately its own small shape rather than reusing anything from
@@ -8,7 +8,9 @@ import'../../forms/input/input.class.js';import type{LyraEventDetailSnapshot}fro
 * it. `input`/`expectedOutput` are plain strings (not `unknown`/structured payloads) since every
 * column's `cell()` here renders them as plain text.
 */
-export interface EvalExample{id:string;input:string;expectedOutput?:string;tags?:readonly string[];metadata?:Record<string,unknown>;}export interface LyraEvalDatasetEventMap{'lr-example-select':CustomEvent<{exampleId:string|null;}>;'lr-example-add-request':CustomEvent<null>;'lr-example-remove-request':CustomEvent<{exampleId:string;}>;'lr-import-request':CustomEvent<LyraEventDetailSnapshot<{files:File[];}>>;'lr-export-request':CustomEvent<{format:string;}>;
+export interface EvalExample{id:string;input:string;expectedOutput?:string;tags?:readonly string[];metadata?:Record<string,unknown>;}
+/** Full-source example query; tags use OR semantics, combined with text search. */
+export interface EvalDatasetSourceQuery{readonly search:string;readonly tags:readonly string[];readonly sortKey:string|null;readonly sortDir:'asc'|'desc';}export type EvalDatasetSource=LyraPageSource<EvalExample,EvalDatasetSourceQuery>;export interface LyraEvalDatasetEventMap{'lr-example-select':CustomEvent<{exampleId:string|null;}>;'lr-example-add-request':CustomEvent<null>;'lr-example-remove-request':CustomEvent<{exampleId:string;}>;'lr-import-request':CustomEvent<LyraEventDetailSnapshot<{files:File[];}>>;'lr-export-request':CustomEvent<{format:string;}>;
 /** Deliberate pass-through from the controlled comparison table. */
 'lr-sort':LyraTableEventMap<EvalExample>['lr-sort'];focus:FocusEvent;blur:FocusEvent;}
 /**
@@ -44,8 +46,24 @@ export interface EvalExample{id:string;input:string;expectedOutput?:string;tags?
 * array -- the same "the host owns the actual data" contract as every other mutation this
 * component surfaces.
 *
-* Public collection properties take bounded, clone-owned readonly snapshots. Create a new
-* collection and reassign it after changes; mutating the assigned array does not update the view.
+* Public collection arrays take bounded readonly snapshots. Example records retain identity so
+* opaque metadata stays intact; reassign `examples` after editing records. At most 10,000 examples
+* are admitted, with an existing limit notice when more are supplied. Other owned collections
+* retain the 10,000-entry and 50,000-node clone limits.
+*
+* Tag facets show at most 500 locale-sorted distinct tags, keeping selected tags visible and
+* filling the remaining places with the earliest tags. A localized note counts omitted tags.
+* Search and filtering continue to use the complete admitted dataset.
+*
+* With dataSource, the provider owns global text filtering, OR-tag filtering and server sorting.
+* Zero-based sourcePage and sourcePageSize (1..500) address the complete source; sourceTotal is
+* null until an authoritative page arrives. Provider rows have at most 500 tags and 65,536 total
+* display-text UTF-16 units; opaque metadata is not traversed or rendered. Catalogue facets are
+* required, independent of the loaded page, and reserve active tags inside the 500-facet budget.
+* Only unavailableSelected removes active filters. Page/query transitions clear the private
+* selected example once, keeping Remove restricted to a visible row. Import/export/add intents
+* keep their existing host-owned behavior; source mode does not export only the loaded page.
+* Reassign dataSource or call requestUpdate() to refresh; named paints keep source caches stable.
 *
 * @customElement lr-eval-dataset
 * @event lr-example-select - A row was activated. `detail: { exampleId }` -- `exampleId` is `null` once the
@@ -81,7 +99,7 @@ export interface EvalExample{id:string;input:string;expectedOutput?:string;tags?
 * @csspart tag-filter - The tag-filter chip group's wrapper. Only rendered while `examples`
 *   carries at least one tag.
 * @csspart grid - The internal `<lr-table>`.
-* @csspart limit - Visible notice when the collection boundary retained only the first examples.
+* @csspart limit - Visible notice for omitted examples or tags beyond the 500-facet ceiling.
 * The search field is a composed `<lr-input>`, so it is themed through the shared `--lr-input-*` and
 * `--lr-form-control-*` tokens.
 *
@@ -90,7 +108,16 @@ export interface EvalExample{id:string;input:string;expectedOutput?:string;tags?
 */
 export declare class LyraEvalDataset extends LyraElement<LyraEvalDatasetEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];
 /** Rows carry opaque `metadata` that is never read, so they are kept by identity, not cloned. */
-protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];private readonly limitAnnouncements;private limitAnnouncementInitialized;private previouslyTruncated;private examplesTruncated;adoptedCallback():void;protected updated(changed:PropertyValues):void;protected static readonly immutableEventDetails:readonly string[];
+protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];private readonly limitAnnouncements;private limitAnnouncementInitialized;private previouslyTruncated;private examplesTruncated;connectedCallback():void;adoptedCallback():void;protected updated(changed:PropertyValues):void;protected static readonly immutableEventDetails:readonly string[];private sourceStateVersion;private _dataSource?;private sourceEpoch;private sourceSyncing;private sourceInputs?;private sourceQueryInputs?;private sourceFailure;private sourceResult?;private sourceRows;private sourceTags;private sourceFacetLabels;private sourceSortKey;private sourceSortDir;private readonly sourcePages;
+/** Host-owned full-source pages; wins over examples even when invalid. Reassign the same
+* provider or call requestUpdate() to refresh. undefined restores the current examples input. */
+get dataSource():EvalDatasetSource|undefined;set dataSource(value:EvalDatasetSource|undefined);
+/** Zero-based provider page; legacy table paging is unchanged. */
+sourcePage:number;
+/** Provider rows per page, normalized to 1..500. */
+sourcePageSize:number;
+/** Exact current-query total, or null while pending, invalid or outside provider mode. */
+get sourceTotal():number|null;private get sourceMode();private get sourceBlocked();private projectSourceExample;private syncSource;private acceptSourcePage;private onSourcePage;private onSourceSort;private onSourceRetry;
 /** Controlled dataset: every example currently known to the host. This component never
 *  mutates its own copy of it -- add/remove/import/export are all *requests*; the host performs
 *  the actual mutation (and any persistence/API call) and passes the updated array back in.
@@ -134,4 +161,4 @@ disabled:boolean;
 /** Accessible name for the nested example grid. This wins over the localized
 *  `evalDatasetLabel` default, which also applies when it is empty since the grid needs a name; a
 *  host `aria-label` names the host itself and is not cloned onto the independently interactive grid. */
-label:string;private searchText;private activeTags;private selectedId;private normalizedFor?;private normalizedCache;private get normalizedExamples();protected willUpdate(changed:PropertyValues):void;private clearSelection;private allTags;private visibleExamples;private filterExamples;private columnsCache?;private selectedKeysCache?;private buildColumns;private selectedKeys;private createColumns;private onAddClick;private onRemoveClick;private onGridRowActivate;private onFiles;private onExportButtonExport;private onTagChipToggle;private stopOwnedEvent;private renderToolbar;private renderSearch;private readonly gateDisabledClear;private renderTagFilter;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-eval-dataset':LyraEvalDataset;}}
+label:string;private searchText;private activeTags;private selectedId;private normalizedFor?;private normalizedCache;private get normalizedExamples();private explicitRefresh;private normalizedRefresh;private filterMemo?;private readonly searchCorpus;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;protected willUpdate(changed:PropertyValues):void;private clearSelection;private tagsMemo?;private allTags;private visibleExamples;private filterExamples;private columnsCache?;private selectedKeysCache?;private buildColumns;private selectedKeys;private createColumns;private onAddClick;private onRemoveClick;private onGridRowActivate;private onFiles;private onExportButtonExport;private onTagChipToggle;private stopOwnedEvent;private renderToolbar;private renderSearch;private readonly gateDisabledClear;private facetMemo?;private visibleTagFacets;private tagTemplateMemo?;private renderTagFilter;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-eval-dataset':LyraEvalDataset;}}