@aceshooting/lyra-ui 4.0.0 → 4.1.0

package/dist/ai/types.contract.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.contract.d.ts.map

package/dist/ai/types.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.contract.d.ts","sourceRoot":"","sources":["../../src/ai/types.contract.ts"],"names":[],"mappings":""}

package/dist/ai/types.contract.js

@@ -0,0 +1,139 @@
+/**
+ * Compile-time-only structural assertions for `./types.ts` -- there is no runtime behavior to
+ * test in a types-only module, so "test" here means "fails `tsc` if a shape is wrong", the same
+ * idea as this package's root-level `type-tests/*.ts` files (see `tsconfig.type-tests.json`).
+ *
+ * Deliberately NOT named `types.test.ts`: this package's `tsconfig.json` excludes
+ * `src/**\/*.test.ts` from the very `tsc -p tsconfig.json` run that both `pnpm build` and
+ * `pnpm lint` use to type-check `src/ai/**` (verified empirically -- a deliberately wrong
+ * assignment in a `src/ai/types.test.ts` was silently accepted by every gate), and
+ * `web-test-runner.config.js`'s `files: 'src/**\/*.test.ts'` glob would additionally load a
+ * `types.test.ts` here as a zero-assertion browser spec (harmless, but pointless, and it still
+ * wouldn't type-check anything -- `wtr`'s `esbuildPlugin` transpiles, it does not type-check).
+ * `tsconfig.type-tests.json`'s own `include` (`type-tests/**\/*.ts`, `src/**\/*.d.ts`) does not
+ * reach a plain `.ts` file under `src/ai/` either. A plain, non-`.test.ts`-suffixed file under
+ * `src/` is therefore the only name that is actually covered by `tsc -p tsconfig.json` -- i.e.
+ * the only name that makes a wrong shape here fail `pnpm build`/`pnpm lint` for real.
+ *
+ * Nothing below is ever executed (`declare const` bindings have no runtime value, and the
+ * "binder" functions are declared but never called) -- this file compiles into a practically
+ * empty `dist/ai/types.contract.js`, and a wrong shape fails `tsc` at the offending line instead.
+ */
+// --- Standalone literal construction: compiles only if every required field is present with the
+// --- right type, and no extra/misspelled field sneaks past excess-property checking. ---
+const status = { kind: 'running', message: 'Searching…' };
+const step = {
+    id: 'step-1',
+    kind: 'retrieval',
+    label: 'Searching knowledge base',
+    status,
+    startedAt: 0,
+    endedAt: 120,
+};
+const run = {
+    id: 'run-1',
+    status,
+    startedAt: 0,
+    endedAt: 4200,
+    model: 'gpt-5',
+    costEstimate: 0.0042,
+    steps: [step],
+};
+const documentRef = {
+    id: 'doc-1',
+    name: 'annual_report.pdf',
+    mimeType: 'application/pdf',
+    uri: 'https://example.com/annual_report.pdf',
+    version: '3',
+};
+const citation = {
+    id: 'cite-1',
+    chunkId: 'chunk-1',
+    sourceId: 'doc-1',
+    span: { start: 0, end: 42 },
+    label: '[1]',
+};
+const retrievalQuery = {
+    text: 'quarterly revenue growth',
+    filters: { year: 2026 },
+    mode: 'hybrid',
+    scope: ['doc-1', 'doc-2'],
+};
+void retrievalQuery;
+const retrievalChunk = {
+    id: 'chunk-1',
+    text: 'Revenue grew 12% year over year…',
+    score: 0.87,
+    source: documentRef,
+    metadata: { page: 12 },
+};
+void retrievalChunk;
+const groundingAssessment = {
+    supportedClaims: 8,
+    unsupportedClaims: 1,
+    coverage: 0.89,
+    confidence: 0.7,
+    warnings: ['One claim could not be matched to a source.'],
+};
+void groundingAssessment;
+const chatMessage = {
+    id: 'msg-1',
+    role: 'assistant',
+    status: 'sent',
+    timestamp: new Date(),
+    text: 'Revenue grew 12% year over year.',
+    attachments: [documentRef],
+};
+const toolInvocation = {
+    id: 'call-1',
+    name: 'web_search',
+    args: { query: 'quarterly revenue growth' },
+    status: 'success',
+    result: { hits: 3 },
+};
+const runLifecycleDetail = { runId: run.id, status };
+void runLifecycleDetail;
+const retrievalProgressDetail = { queryId: 'query-1', stage: 'ranking', progress: 0.5 };
+void retrievalProgressDetail;
+const citationSelectDetail = { citation };
+void citationSelectDetail;
+const toolApprovalDetail = { invocationId: toolInvocation.id, approved: true };
+void toolApprovalDetail;
+const cancelDetail = { reason: 'user-cancelled' };
+void cancelDetail;
+const retryDetail = { attempt: 2 };
+void retryDetail;
+const exportDetail = { format: 'markdown' };
+void exportDetail;
+function bindChatMessage(message) {
+    chatMessageEl.role = message.role;
+    chatMessageEl.status = message.status ?? 'sent';
+    chatMessageEl.timestamp = message.timestamp;
+}
+void bindChatMessage;
+function bindToolInvocationToChip(invocation) {
+    toolCallChipEl.callId = invocation.id;
+    toolCallChipEl.name = invocation.name;
+    toolCallChipEl.status = invocation.status;
+}
+void bindToolInvocationToChip;
+function bindToolInvocationToResultView(invocation) {
+    toolResultViewEl.toolName = invocation.name;
+    toolResultViewEl.args = invocation.args;
+    toolResultViewEl.result = invocation.result;
+}
+void bindToolInvocationToResultView;
+function bindCitationToSourceCard(value) {
+    // `Citation.sourceId` is optional (a citation without a resolved source is still valid); the
+    // fallback empty string matches `<lr-source-card>`'s own `sourceId = ''` default.
+    sourceCardEl.sourceId = value.sourceId ?? '';
+}
+void bindCitationToSourceCard;
+function bindDocumentRef(ref) {
+    attachmentChipEl.name = ref.name;
+    attachmentChipEl.mimeType = ref.mimeType ?? '';
+    documentPreviewEl.mimeType = ref.mimeType ?? '';
+}
+void bindDocumentRef;
+export {};
+//# sourceMappingURL=types.contract.js.map

package/dist/ai/types.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.contract.js","sourceRoot":"","sources":["../../src/ai/types.contract.ts"],"names":[],"mappings":"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"}

package/dist/ai/types.d.ts

@@ -0,0 +1,199 @@
+import type { ChatMessageRole, ChatMessageStatus } from '../components/chat-message/chat-message.class.js';
+import type { ToolCallStatus } from '../components/tool-call-chip/tool-call-chip.class.js';
+export type { ChatMessageRole, ChatMessageStatus, ToolCallStatus };
+/**
+ * Provider-neutral shared type surface for the agentic AI component layer built on top of this
+ * package's existing chat/agent/tool/graph primitives (`lr-chat-message`, `lr-citation-badge`,
+ * `lr-tool-call-chip`, `lr-tool-result-view`, `lr-source-card`, `lr-chunk-inspector`, etc.).
+ * Nothing exported here is a custom element, has a runtime side effect, or binds to any specific
+ * LLM/agent vendor -- it is the plain-data vocabulary that retrieval, agent-run, knowledge-graph,
+ * dashboard, and evaluation components compose those existing primitives around.
+ *
+ * Every shape below is deliberately structurally compatible with -- never a divergent duplicate
+ * of -- the prop/event shapes those existing components already expose. Where a type reuses an
+ * existing component's own exported type outright (`ChatMessageRole`, `ChatMessageStatus`,
+ * `ToolCallStatus`), it is imported and re-exported here rather than redefined. See each
+ * interface's own doc comment below for the specific existing component(s) it composes with.
+ * `types.contract.ts` (a sibling file -- see its own header for why it is deliberately not named
+ * `*.test.ts`) asserts this compatibility at compile time.
+ *
+ * Every `*EventDetail` type below is plain serializable data (no class instances, no functions),
+ * matching this package's own `*EventMap`/`*Detail` event-contract convention (e.g.
+ * `LyraCitationBadgeEventMap` / `CitationActivateDetail` in `citation-badge.class.ts`), since
+ * these are meant to cross a `CustomEvent<T>` boundary.
+ */
+/**
+ * Coarse lifecycle state for a whole agent run or a single step within one. Broader than any
+ * single existing component's own status vocabulary (e.g. `ToolCallStatus`'s `'pending' |
+ * 'running' | 'success' | 'error' | 'denied'`, reused as-is by `ToolInvocation` below) because a
+ * run/step can also be waiting on the user (`'waiting-input'`), waiting on an approval gate
+ * (`'waiting-approval'`), or user-cancelled (`'cancelled'`) -- states a single tool call's own
+ * terminal status has no need to express.
+ */
+export type AgentStatusKind = 'idle' | 'running' | 'waiting-input' | 'waiting-approval' | 'done' | 'error' | 'cancelled';
+/** A status value paired with an optional human-readable detail, e.g. `{ kind: 'error', message: 'Rate limited' }`. */
+export interface AgentStatus {
+    kind: AgentStatusKind;
+    message?: string;
+}
+/**
+ * One step in an agent run's summary timeline. A coarser unit than `LyraSpan`
+ * (`trace-tree/span.ts`), which models a single trace span for the more detailed
+ * `lr-trace-tree`/`lr-span-waterfall` views -- `kind` is intentionally a free-form string here
+ * (not `LyraSpan['kind']`'s closed `'agent' | 'llm' | 'tool' | 'retriever' | 'embedding' |
+ * 'other'` union) since an agent run's own step taxonomy is application-defined.
+ */
+export interface AgentStep {
+    id: string;
+    kind: string;
+    label: string;
+    status: AgentStatus;
+    /** Epoch milliseconds. */
+    startedAt?: number;
+    /** Epoch milliseconds. */
+    endedAt?: number;
+}
+/** A complete agent run: overall status plus its ordered `steps`. */
+export interface AgentRun {
+    id: string;
+    status: AgentStatus;
+    /** Epoch milliseconds. */
+    startedAt?: number;
+    /** Epoch milliseconds. */
+    endedAt?: number;
+    model?: string;
+    costEstimate?: number;
+    steps: AgentStep[];
+}
+/**
+ * One message in a conversation, for orchestration-level components that hold/replay message
+ * history. `<lr-chat-message>` itself takes these as individual properties rather than one object
+ * prop, since it is a presentation shell around an arbitrary slotted body (see its own class
+ * doc) -- but `role`/`status`/`timestamp` here reuse `<lr-chat-message>`'s own exported
+ * `ChatMessageRole` / `ChatMessageStatus` types and its own `Date | string` timestamp shape
+ * verbatim, so spreading a `ChatMessage`'s fields onto a `<lr-chat-message>` element's properties
+ * (`message.role -> el.role`, `message.status -> el.status`, `message.timestamp -> el.timestamp`)
+ * type-checks with no conversion.
+ */
+export interface ChatMessage {
+    id: string;
+    role: ChatMessageRole;
+    status?: ChatMessageStatus;
+    timestamp?: Date | string;
+    /** Plain-text (or app-rendered-markdown-source) body; `<lr-chat-message>` renders none of the message content itself, so this is for state-holding/serialization, not direct binding. */
+    text?: string;
+    attachments?: DocumentRef[];
+}
+/**
+ * One tool/function call an agent made -- the same concept `<lr-tool-call-chip>` and
+ * `<lr-tool-result-view>` already render. `status` reuses `ToolCallStatus` (not the broader
+ * `AgentStatus` above) so a `ToolInvocation` assigns directly onto `<lr-tool-call-chip>`'s own
+ * `status` property with no adapter; that component's own `callId`/`name` properties correspond
+ * to `id`/`name` here. `args`/`result` widen (never narrow) `<lr-tool-result-view>`'s own
+ * `args: unknown` / `result: unknown` properties, so a `ToolInvocation`'s fields assign directly
+ * onto that component too.
+ */
+export interface ToolInvocation {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    status: ToolCallStatus;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * A reference to a source document. `name`/`mimeType` match `<lr-attachment-chip>`'s own
+ * `name`/`mimeType` properties and `<lr-document-preview>`'s own `mimeType` property field-for-
+ * field, so a `DocumentRef` composes directly into either without renaming.
+ */
+export interface DocumentRef {
+    id: string;
+    name: string;
+    mimeType?: string;
+    uri?: string;
+    version?: string;
+}
+/**
+ * A single citation record, e.g. one entry a retrieval/grounding step produces. `sourceId`
+ * matches the `sourceId` field carried by `<lr-citation-badge>`'s own `lr-citation-activate` /
+ * `lr-citation-open` events (`CitationActivateDetail` / `CitationOpenDetail` in
+ * `citation-badge.class.ts`) and `<lr-source-card>`'s own `source-id` property -- the same stable
+ * id already used to correlate a citation badge with its source card. `span` follows this
+ * package's established range-anchor shape (see `LyraChunkAnchor`'s `'line-range'` /
+ * `'time-range'` variants, both `{ start; end? }`, in `chunk-inspector.class.ts`).
+ */
+export interface Citation {
+    id: string;
+    chunkId?: string;
+    sourceId?: string;
+    span?: {
+        start: number;
+        end: number;
+    };
+    label?: string;
+}
+/** A retrieval request. Provider/backend-neutral -- no vendor-specific filter/query shape. */
+export interface RetrievalQuery {
+    text: string;
+    filters?: Record<string, unknown>;
+    mode: 'vector' | 'keyword' | 'hybrid';
+    scope?: string[];
+}
+/**
+ * One retrieved chunk. `source` carries a full `DocumentRef` (not just a bare id) since a
+ * retrieval result set is exactly where a chunk's full document metadata first becomes
+ * available. Maps onto `<lr-chunk-inspector>`'s own flatter `LyraChunk` display-row shape
+ * (`chunk-inspector.class.ts`) via `source.id -> sourceId` and `source.name -> title` --
+ * `lr-chunk-inspector` renders a display row per chunk; this type is the richer data record a
+ * retrieval step produces upstream of that rendering step.
+ */
+export interface RetrievalChunk {
+    id: string;
+    text: string;
+    score: number;
+    source: DocumentRef;
+    metadata?: Record<string, unknown>;
+}
+/** How well a generated response is supported by its retrieved/cited sources. */
+export interface GroundingAssessment {
+    supportedClaims: number;
+    unsupportedClaims: number;
+    /** 0-1. */
+    coverage: number;
+    /** 0-1. */
+    confidence?: number;
+    warnings?: string[];
+}
+/** `detail` for a run-lifecycle event (e.g. an agent run's status changing). */
+export interface RunLifecycleEventDetail {
+    runId: string;
+    status: AgentStatus;
+}
+/** `detail` for a retrieval-in-progress event. */
+export interface RetrievalProgressEventDetail {
+    queryId: string;
+    stage: string;
+    progress?: number;
+}
+/** `detail` for a citation being selected/activated in an orchestration-level surface. */
+export interface CitationSelectEventDetail {
+    citation: Citation;
+}
+/** `detail` for a tool-approval decision (a human-in-the-loop gate). */
+export interface ToolApprovalEventDetail {
+    invocationId: string;
+    approved: boolean;
+}
+/** `detail` for a cancellation request. */
+export interface CancelEventDetail {
+    reason?: string;
+}
+/** `detail` for a retry request. */
+export interface RetryEventDetail {
+    attempt: number;
+}
+/** `detail` for an export request, e.g. "export this conversation/run as `format`". */
+export interface ExportEventDetail {
+    format: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"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"}

package/dist/ai/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":""}

package/dist/components/agent-run/agent-run.class.d.ts

@@ -0,0 +1,158 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import type { AgentRun, CancelEventDetail, RetryEventDetail } from '../../ai/types.js';
+import '../generation-status/generation-status.js';
+import '../usage-badge/usage-badge.js';
+import '../task-list/task-list.js';
+import '../badge/badge.js';
+import '../empty/empty.js';
+import '../live-region/live-region.js';
+export interface LyraAgentRunEventMap {
+    'lr-cancel': CustomEvent<CancelEventDetail>;
+    'lr-retry': CustomEvent<RetryEventDetail>;
+}
+/**
+ * `<lr-agent-run>` — the top-level shell for one `AgentRun`: lifecycle-status badge, elapsed
+ * time, current step, model/cost summary, and built-in Cancel/Retry controls in a header, plus
+ * four named composition slots (`tasks`/`tools`/`reasoning`/`output`) for the run's actual
+ * content. This is deliberately a SHELL, not a new step-rendering surface — every piece of
+ * per-step or per-invocation rendering routes through an existing primitive:
+ *
+ * - **Elapsed time**: composes `<lr-generation-status>` (`active`/`started-at`, its own built-in
+ *   Stop button hidden via `show-stop="false"` since this component renders its own Cancel/Retry
+ *   pair instead) for the *live, ticking* readout while the run is genuinely in progress
+ *   (`running`/`waiting-input`/`waiting-approval`). `<lr-stream-status>` was considered too (per
+ *   this family's own composition brief) but doesn't fit: its `phase` vocabulary
+ *   (`idle`/`connecting`/`streaming`/`stalled`) models transport/connection health, not an agent
+ *   run's seven-state lifecycle, and it exposes no elapsed-time readout at all — exactly the
+ *   distinction `<lr-generation-status>`'s own class doc already draws between the two. Once the
+ *   run reaches a terminal state (`done`/`error`/`cancelled`) with both a `startedAt` and an
+ *   `endedAt`, this component instead renders a small locally-formatted static duration
+ *   (`endedAt - startedAt`): `<lr-generation-status>`'s freeze-on-`active=false` semantics only
+ *   ever freeze at whatever it last computed *live*, so mounting it directly against a completed
+ *   run loaded from history (e.g. `startedAt` yesterday, `endedAt` five minutes later, loaded
+ *   today) would either show a stale zero or the wrong multi-hour span — it has no way to render a
+ *   fixed historical span on demand. That static fallback reuses the same small `formatDuration()`
+ *   algorithm `<lr-usage-badge>` and `<lr-tool-call-chip>` already duplicate locally for the same
+ *   reason (see this file's own copy).
+ * - **Model + cost summary**: composes `<lr-usage-badge>`, fed `run.costEstimate` (formatted via
+ *   `formatCost`, or a plain `Intl.NumberFormat` by default — this library never assumes a
+ *   currency, see `<lr-format-number>`'s own explicit `currency` prop) as its `cost-text`.
+ *   `run.model` (a plain string with no analogous `<lr-usage-badge>` property) renders alongside
+ *   as plain text.
+ * - **Current step**: a single-line summary of whichever `run.steps` entry currently has
+ *   `status.kind === 'running'` (the last such entry, if more than one) — a plain text line, not a
+ *   list, so it doesn't duplicate `<lr-task-list>`'s own per-item rendering.
+ * - **Tasks slot default content**: when the host doesn't slot anything into `tasks` and
+ *   `run.steps` is non-empty, this component's own `<slot>` fallback renders a `<lr-task-list>`
+ *   populated by mapping every `AgentStep` to a `TaskItem` (see `toTaskItem()`) — a plain data
+ *   adapter between the two existing shapes, not new rendering.
+ * - **Status badge**: composes `<lr-badge>`. **Empty state**: composes `<lr-empty>` when `run` is
+ *   `null`.
+ *
+ * `tools`/`reasoning`/`output` are plain named slots with no default content — entirely the
+ * host's own composition (typically `<lr-tool-call-chip>`/`<lr-tool-result-view>` rows,
+ * reasoning/streaming text, and final output respectively). An `actions` slot adds extra header
+ * controls alongside the built-in Cancel/Retry pair.
+ *
+ * The built-in Cancel button renders while `showCancel` is true and the run's status is one of
+ * `TICKING_KINDS` (still genuinely in progress); Retry renders while `showRetry` is true and the
+ * status is `error` or `cancelled`. Clicking either fires `lr-cancel`/`lr-retry` with
+ * `CancelEventDetail`/`RetryEventDetail` from `src/ai/types.ts` — this component never cancels or
+ * retries anything itself, it only requests. `RetryEventDetail.attempt` is a 1-based counter
+ * local to this component, incremented on every `lr-retry` click and reset to `0` whenever
+ * `run.id` changes (a genuinely new run replacing the old one, as opposed to the same run's status
+ * merely updating in place).
+ *
+ * Lifecycle transitions into an attention-needing or terminal state (`waiting-input`,
+ * `waiting-approval`, `done`, `error`, `cancelled`) are announced through an internal
+ * `<lr-live-region>`, mirroring `<lr-stream-status>`'s own stall/recover announcements —
+ * `running`/`idle` transitions are frequent and not independently actionable, so they stay
+ * silent, and whatever status a freshly-assigned `run` (a new `run.id`) happens to already carry
+ * is never itself treated as an eventful transition, only a later in-place change is.
+ *
+ * @customElement lr-agent-run
+ * @slot tasks - Task/plan content. Falls back to a `<lr-task-list>` built from `run.steps` when
+ *   nothing is slotted and `run.steps` is non-empty.
+ * @slot tools - Tool-call content (e.g. `<lr-tool-call-chip>`/`<lr-tool-result-view>` rows). No
+ *   default content.
+ * @slot reasoning - Reasoning/thinking content. No default content.
+ * @slot output - The run's final output content. No default content.
+ * @slot actions - Extra header actions alongside the built-in Cancel/Retry buttons.
+ * @event lr-cancel - The built-in Cancel button was activated. `detail: CancelEventDetail`
+ *   (`{ reason }`, always `undefined` from the built-in button itself).
+ * @event lr-retry - The built-in Retry button was activated. `detail: RetryEventDetail`
+ *   (`{ attempt }`, a 1-based counter reset per `run.id`).
+ * @csspart base - The root container.
+ * @csspart empty - The `<lr-empty>` shown when `run` is `null`.
+ * @csspart header - The header row wrapping status, elapsed time, current step, summary, and actions.
+ * @csspart status - Wrapper around the status badge and optional status message.
+ * @csspart status-badge - The resolved `<lr-badge>` lifecycle-status pill.
+ * @csspart status-message - `run.status.message`, when set.
+ * @csspart elapsed - The composed `<lr-generation-status>`, only rendered while the run is
+ *   actively ticking (see the class doc).
+ * @csspart elapsed-static - The static formatted duration for a terminal run with both
+ *   `startedAt` and `endedAt`.
+ * @csspart current-step - Wrapper around the current-step icon and label. Only rendered while a
+ *   step has `status.kind === 'running'`.
+ * @csspart current-step-icon - The spinning current-step icon.
+ * @csspart current-step-label - The current step's `label` text.
+ * @csspart summary - Wrapper around the model text and the composed `<lr-usage-badge>`. Only
+ *   rendered while `run.model` or a valid `run.costEstimate` is present.
+ * @csspart model - `run.model`, when set.
+ * @csspart usage - The composed `<lr-usage-badge>`.
+ * @csspart actions - Wrapper around the `actions` slot and the built-in Cancel/Retry buttons.
+ * @csspart cancel-button - The built-in Cancel button. Only rendered while cancelable (see the
+ *   class doc).
+ * @csspart retry-button - The built-in Retry button. Only rendered while retryable.
+ * @csspart body - Wrapper around the four composition slots.
+ * @csspart tasks - The `tasks` slot.
+ * @csspart tools - The `tools` slot.
+ * @csspart reasoning - The `reasoning` slot.
+ * @csspart output - The `output` slot.
+ */
+export declare class LyraAgentRun extends LyraElement<LyraAgentRunEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** The run to display. Controlled and never mutated by this component -- pass a new object to
+     *  update it. `null` renders the shared `<lr-empty>` `noData` state. */
+    run: AgentRun | null;
+    /** Overrides the default plain `Intl.NumberFormat` rendering of `run.costEstimate` fed to the
+     *  composed `<lr-usage-badge>`'s `cost-text` -- e.g. to add a currency symbol/code, which this
+     *  library never assumes on a host's behalf. */
+    formatCost?: (cost: number) => string;
+    /** Whether the built-in Cancel button can render at all -- still gated by the run's own status
+     *  being cancelable (`running`/`waiting-input`/`waiting-approval`). Set `false` for a read-only
+     *  viewer. */
+    showCancel: boolean;
+    /** Whether the built-in Retry button can render at all -- still gated by the run's own status
+     *  being retryable (`error`/`cancelled`). */
+    showRetry: boolean;
+    private retryAttempt;
+    private liveRegion?;
+    private previousRunId?;
+    private previousStatusKind?;
+    protected willUpdate(changed: PropertyValues): void;
+    protected updated(changed: PropertyValues): void;
+    private handleRunChange;
+    private isAttentionKind;
+    private announceStatus;
+    private statusLabel;
+    private get currentStep();
+    private get isTicking();
+    /** The static formatted duration for a terminal run with both `startedAt` and `endedAt` --
+     *  `undefined` while ticking, not yet terminal, or missing either timestamp (see the class
+     *  doc's "elapsed time" section for why a terminal run doesn't reuse the live ticker). */
+    private get staticElapsedText();
+    private get costText();
+    private get canCancel();
+    private get canRetry();
+    private onCancelClick;
+    private onRetryClick;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-agent-run': LyraAgentRun;
+    }
+}
+//# sourceMappingURL=agent-run.class.d.ts.map

package/dist/components/agent-run/agent-run.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run.class.d.ts","sourceRoot":"","sources":["../../../src/components/agent-run/agent-run.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAkC,MAAM,KAAK,CAAC;AAE9G,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK7D,OAAO,KAAK,EAAE,QAAQ,EAA8B,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUnH,OAAO,2CAA2C,CAAC;AACnD,OAAO,+BAA+B,CAAC;AACvC,OAAO,2BAA2B,CAAC;AACnC,OAAO,mBAAmB,CAAC;AAC3B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,+BAA+B,CAAC;AA8FvC,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAC5C,UAAU,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AACH,qBAAa,YAAa,SAAQ,WAAW,CAAC,oBAAoB,CAAC;IACjE,MAAM,CAAC,MAAM,iCAAwC;IAErD;4EACwE;IACxC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAE5D;;oDAEgD;IAChB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAEtE;;kBAEc;IACiF,UAAU,UAAQ;IAEjH;iDAC6C;IACiD,SAAS,UAAQ;IAEtG,OAAO,CAAC,YAAY,CAAK;IAET,OAAO,CAAC,UAAU,CAAC,CAAiB;IAM7D,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAkB;IAE7C,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAIlD;IAED,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE/C;IAED,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,WAAW;IAInB,OAAO,KAAK,WAAW,GAOtB;IAED,OAAO,KAAK,SAAS,GAGpB;IAED;;8FAE0F;IAC1F,OAAO,KAAK,iBAAiB,GAM5B;IAED,OAAO,KAAK,QAAQ,GAMnB;IAED,OAAO,KAAK,SAAS,GAGpB;IAED,OAAO,KAAK,QAAQ,GAGnB;IAED,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,YAAY,CAGlB;IAEF,MAAM,IAAI,cAAc,CA+EvB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,YAAY,CAAC;KAC9B;CACF"}