@arcgis/ai-components 5.2.0-next.98 → 6.0.0-next.0

package/dist/components/arcgis-assistant-observation-panel/customElement.d.ts

@@ -0,0 +1,28 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisAssistant } from "../arcgis-assistant/customElement.js";
+import type { RuntimeSpanEvent } from "../../orchestrator/orchestrator/orchestratorEvents.js";
+import type { ObservationSnapshot } from "./support/observationSnapshot.js";
+import type { ModelPricingCatalog } from "./support/modelPricing.js";
+
+/**
+ * Displays assistant runs and their spans, payloads, timings, failures, and token usage.
+ *
+ * @internal
+ */
+export abstract class ArcgisAssistantObservationPanel extends LitElement {
+  /** Runtime span lifecycle events for all runs to display. Replace the array to update or clear the history. */
+  accessor events: readonly RuntimeSpanEvent[];
+  /**
+   * USD text-token pricing for cost estimates. Replace the catalog to apply new rates to all displayed runs.
+   * Supply overrides for Azure, custom deployments or other processing tiers.
+   */
+  accessor pricing: ModelPricingCatalog;
+  /**
+   * Assistant element, ID, or selector to observe. Requires runtimeEventsEnabled on the assistant.
+   * When omitted, only events supplied through the events property are shown.
+   */
+  accessor referenceElement: ArcgisAssistant | string | undefined;
+  /** Data behind all displayed runs and aggregate metrics. Payloads are retained unchanged. */
+  accessor snapshot: ObservationSnapshot;
+}

package/dist/components/arcgis-assistant-observation-panel/customElement.js

@@ -0,0 +1,68 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as h } from "../../chunks/runtime.js";
+import { css as d, html as o } from "lit";
+import { LitElement as p } from "@arcgis/lumina";
+import { log as u } from "@arcgis/toolkit/log";
+import { b as v } from "../../chunks/utils2.js";
+import { b as l } from "../../chunks/observationSnapshot.js";
+import { d as g, f as m } from "../../chunks/modelPricing.js";
+const f = d`:host{display:block;container-type:inline-size;min-height:20rem;color:var(--calcite-color-text-1);background:var(--calcite-color-foreground-1)}.observation{position:relative;width:100%;height:100%;min-height:inherit}calcite-shell-panel{--calcite-shell-panel-width: min(40rem, 60cqi);--calcite-shell-panel-max-width: 100cqi}calcite-shell-panel[slot=panel-bottom]{--calcite-shell-panel-min-height: 0px}.runs{min-width:0;min-height:0}.viewer{height:100%}.connection{--calcite-action-text-color: var(--calcite-color-status-danger);--calcite-action-text-color-press: var(--calcite-action-text-color)}.connection.connected{--calcite-action-text-color: var(--calcite-color-status-success)}.empty{padding:var(--calcite-spacing-lg);color:var(--calcite-color-text-3);text-align:center}`;
+class $ extends p {
+  constructor() {
+    super(), this._connected = !1, this.events = [], this.pricing = g, this.snapshot = l([]), this.listen("calcitePanelClose", (t) => {
+      t.stopPropagation(), this._selection = void 0;
+    }), this.manager.onLifecycle(() => (this.#i(), () => {
+      this.#t?.(), this.#t = void 0, this._connected = !1;
+    }));
+  }
+  static {
+    this.properties = { _selection: 16, _connected: 16, events: 0, pricing: 0, snapshot: 0, referenceElement: 1 };
+  }
+  static {
+    this.styles = f;
+  }
+  #e;
+  #t;
+  willUpdate(t) {
+    (!this.hasUpdated || t.has("referenceElement")) && this.#i(), (!this.hasUpdated || t.has("events") || t.has("pricing")) && (this.snapshot = l(this.events, this.pricing));
+  }
+  async copy() {
+    try {
+      await navigator.clipboard.writeText(JSON.stringify(this.snapshot, null, 2));
+    } catch (t) {
+      u("warn", "assistant-observation-panel", "Failed to copy conversation as JSON", {
+        once: !0,
+        detail: { error: t }
+      });
+    }
+  }
+  #i() {
+    if (!this.el.isConnected)
+      return;
+    const t = v(this.el, this.referenceElement);
+    if (!(t === this.#e && this.#t)) {
+      if (this.#t?.(), this.#t = void 0, t !== this.#e && (this._selection = void 0, this.events = [], this.#e = t), t) {
+        const e = (n) => {
+          const s = n.detail;
+          this.events.some(({ runId: c }) => c === s.runId) || (this._selection = { runId: s.runId }), this.events = [...this.events, s];
+        };
+        t.addEventListener("arcgisRuntime", e), this.#t = () => t.removeEventListener("arcgisRuntime", e);
+      }
+      this._connected = !!this.#t;
+    }
+  }
+  render() {
+    const t = this._selection, { runs: e, totals: n } = this.snapshot, s = e.find((i) => i.id === t?.runId), c = s?.spans.find((i) => i.id === t?.spanId), r = s && t?.spanId === void 0;
+    return o`<calcite-shell class="observation"><calcite-panel class="runs" heading=Runs .description=${`${n.runCount} ${n.runCount === 1 ? "run" : "runs"} | ${n.usage.knownTokens.total.toLocaleString()} tokens (${m(n.usage.cost?.total)})`} aria-label="Run history" scale=s><calcite-action slot=header-actions-end icon=copy-to-clipboard text="Copy conversation JSON" title="Copy conversation JSON" .disabled=${!e.length} @click=${this.copy}></calcite-action><calcite-action slot=header-actions-end icon=trash text="Clear runs" .disabled=${!e.length} @click=${() => {
+      this._selection = void 0, this.events = [];
+    }}></calcite-action><calcite-action slot=header-actions-end class=${`connection${this._connected ? " connected" : ""}`} .icon=${this._connected ? "check-circle" : "exclamation-mark-circle"} .text=${this._connected ? "Connected" : "Disconnected"} .title=${this._connected ? "Connected" : "Disconnected"}></calcite-action>${e.length ? null : o`<div class="empty">No runs recorded.</div>`}${e.map((i) => o`<arcgis-assistant-observation-run .run=${i} .selectedSpanId=${i.id === t?.runId ? t.spanId : void 0} @arcgisInternalRunSelect=${(a) => {
+      a.stopPropagation(), this._selection = { runId: i.id };
+    }} @arcgisInternalSpanSelect=${(a) => {
+      a.stopPropagation(), this._selection = { runId: i.id, spanId: a.detail };
+    }}></arcgis-assistant-observation-run>`)}</calcite-panel>${r || c ? o`<calcite-shell-panel slot=panel-end width=l resizable><arcgis-assistant-observation-inspector class="viewer" .span=${c} .run=${s} .pricing=${this.pricing}></arcgis-assistant-observation-inspector></calcite-shell-panel>` : null}</calcite-shell>`;
+  }
+}
+h("arcgis-assistant-observation-panel", $);
+export {
+  $ as ArcgisAssistantObservationPanel
+};

package/dist/components/arcgis-assistant-observation-panel/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-observation-panel/index.js

@@ -0,0 +1,7 @@
+import "@esri/calcite-components/components/calcite-shell";
+import "@esri/calcite-components/components/calcite-panel";
+import "@esri/calcite-components/components/calcite-action";
+import "../arcgis-assistant-observation-run/index.js";
+import "@esri/calcite-components/components/calcite-shell-panel";
+import "../arcgis-assistant-observation-inspector/index.js";
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-observation-panel/support/modelPricing.d.ts

@@ -0,0 +1,34 @@
+/**
+ * USD rates per million text tokens.
+ *
+ * @internal
+ */
+export type ModelTokenPricing = {
+  input: number;
+  cachedInput?: number;
+  cacheWrite?: number;
+  output: number;
+  longContext?: {
+      aboveInputTokens: number;
+      input: number;
+      cachedInput?: number;
+      cacheWrite?: number;
+      output: number;
+  };
+};
+
+/** @internal */
+export type ModelPricingCatalog = {
+  updatedAt: string;
+  models: Readonly<Record<string, ModelTokenPricing>>;
+};
+
+/** @internal */
+export type ModelTokenCost = {
+  input: number;
+  cachedInput: number;
+  cacheWrite: number;
+  output: number;
+  total: number;
+  rates: ModelTokenPricing;
+};

package/dist/components/arcgis-assistant-observation-panel/support/observationSnapshot.d.ts

@@ -0,0 +1,63 @@
+import type { RuntimeTokenUsage } from "../../../orchestrator/orchestrator/orchestratorEvents.js";
+import type { ModelPricingCatalog, ModelTokenCost } from "./modelPricing.js";
+import type { RunLatency, RuntimeSpan, RuntimeSpanStatus } from "./runtimeSpans.js";
+
+/** @internal */
+export type ObservationUsage = {
+  tokens: Partial<RuntimeTokenUsage>;
+  knownTokens: Required<RuntimeTokenUsage>;
+  completeTokens: Record<keyof RuntimeTokenUsage, boolean>;
+  cost?: Omit<ModelTokenCost, "rates">;
+  knownCost: Omit<ModelTokenCost, "rates">;
+  completeCost: boolean;
+  modelCalls: number;
+  rates?: ModelTokenCost["rates"];
+  uncached?: number;
+};
+
+/** @internal */
+export type ObservationSpan = RuntimeSpan
+  & {
+  timingRecorded: boolean;
+  usage?: ObservationUsage;
+  pricingTier?: "long-context" | "standard";
+};
+
+/** @internal */
+export type RuntimeRun = {
+  id: string;
+  number: number;
+  prompt: string;
+  status: RuntimeSpanStatus;
+  startedAt: number;
+  endedAt?: number;
+  durationMs: number;
+  spans: readonly ObservationSpan[];
+  usage: ObservationUsage;
+  models: readonly {
+      model?: string;
+      usage: ObservationUsage;
+  }[];
+  latency: RunLatency & {
+      timelineMs: number;
+      steps: readonly {
+          spanId: string;
+          offsetMs: number;
+          durationMs?: number;
+          timingRecorded: boolean;
+      }[];
+  };
+};
+
+/** @internal */
+export type ObservationSnapshot = {
+  schemaVersion: 1;
+  pricing: ModelPricingCatalog;
+  runs: readonly RuntimeRun[];
+  totals: {
+      runCount: number;
+      spanCount: number;
+      failedSpanCount: number;
+      usage: ObservationUsage;
+  };
+};

package/dist/components/arcgis-assistant-observation-panel/support/runtimeSpans.d.ts

@@ -0,0 +1,36 @@
+import type { RuntimeSpanError, RuntimeSpanEvent, RuntimeSpanMetadata, RuntimeSpanType } from "../../../orchestrator/orchestrator/orchestratorEvents.js";
+
+/** @internal */
+export type RuntimeSpanStatus = "cancelled" | "completed" | "failed" | "interrupted" | "running";
+
+/** @internal */
+export type RuntimeSpan = {
+  runId: string;
+  id: string;
+  parentId?: string;
+  agentId?: string;
+  label: string;
+  type: RuntimeSpanType;
+  status: RuntimeSpanStatus;
+  startedAt: number;
+  endedAt?: number;
+  durationMs?: number;
+  input?: unknown;
+  output?: unknown;
+  error?: RuntimeSpanError;
+  metadata?: RuntimeSpanMetadata;
+};
+
+/** @internal */
+export type RunLatency = {
+  elapsedMs?: number;
+  interruptWaitMs: number;
+  elapsedExcludingInterruptsMs?: number;
+};
+
+/**
+ * @param span
+ * @param events
+ * @internal
+ */
+export function getRunLatency(span: RuntimeSpan, events: readonly RuntimeSpanEvent[]): RunLatency;

package/dist/components/arcgis-assistant-observation-run/customElement.d.ts

@@ -0,0 +1,21 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { RuntimeSpanEvent } from "../../orchestrator/orchestrator/orchestratorEvents.js";
+import type { ModelPricingCatalog } from "../arcgis-assistant-observation-panel/support/modelPricing.js";
+import type { RuntimeRun } from "../arcgis-assistant-observation-panel/support/observationSnapshot.js";
+
+/**
+ * Displays an expandable run summary and selectable runtime span hierarchy.
+ *
+ * @internal
+ */
+export abstract class ArcgisAssistantObservationRun extends LitElement {
+  /** Runtime events belonging to this run. */
+  accessor events: readonly RuntimeSpanEvent[];
+  /** Pricing catalog used for this run's cost estimate. */
+  accessor pricing: ModelPricingCatalog;
+  /** Prepared run data supplied by the observation panel. */
+  accessor run: RuntimeRun | undefined;
+  /** The selected span within this run, if any. */
+  accessor selectedSpanId: string | undefined;
+}

package/dist/components/arcgis-assistant-observation-run/customElement.js

@@ -0,0 +1,43 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as $ } from "../../chunks/runtime.js";
+import { css as f, html as i } from "lit";
+import { LitElement as v, createEvent as p, nothing as b } from "@arcgis/lumina";
+import { d as S, f as x } from "../../chunks/modelPricing.js";
+import { s as u, f as m, c as I } from "../../chunks/runtimeSpans.js";
+import { b as w } from "../../chunks/observationSnapshot.js";
+const k = f`:host{display:block;min-width:0}.span-title.completed{color:var(--calcite-color-status-success)}.span-title.failed{color:var(--calcite-color-status-danger)}.span-title.interrupted{color:var(--calcite-color-status-warning)}.span-title.running{color:var(--calcite-color-status-info)}.duration{color:var(--calcite-color-text-3);font-size:var(--calcite-font-size-relative-sm);min-width:3.4rem;text-align:right;font-variant-numeric:tabular-nums}.span-title{display:inline-flex;align-items:center;gap:var(--calcite-spacing-xxs)}.span-title>span{color:var(--calcite-color-text-1);overflow-wrap:anywhere}`;
+class R extends v {
+  constructor() {
+    super(...arguments), this.events = [], this.pricing = S, this.arcgisInternalSpanSelect = p(), this.arcgisInternalRunSelect = p();
+  }
+  static {
+    this.properties = { events: 0, run: 0, pricing: 0, selectedSpanId: 1 };
+  }
+  static {
+    this.styles = k;
+  }
+  #t;
+  willUpdate(t) {
+    (!this.hasUpdated || t.has("run") || t.has("events") || t.has("pricing")) && (this.#t = this.run ?? w(this.events, this.pricing).runs[0]);
+  }
+  renderSpan(t, s) {
+    const n = s.get(t.id) ?? [];
+    return i`<calcite-tree-item .label=${t.label} data-span-id=${t.id ?? b} .selected=${t.id === this.selectedSpanId} .expanded=${n.length > 0}><span class=${`span-title ${t.status}`}><calcite-icon .icon=${u[t.status]} scale=s></calcite-icon><span>${t.label}</span></span><span class="duration" slot=actions-end>${m(t)}</span>${n.length ? i`<calcite-tree slot=children lines scale=s selection-mode=single>${n.map((c) => this.renderSpan(c, s))}</calcite-tree>` : null}</calcite-tree-item>`;
+  }
+  render() {
+    const t = this.#t;
+    if (!t)
+      return null;
+    const { visibleSpans: s, childrenByParent: n, rootSpans: c } = I(t.spans), h = t.prompt.length > 80 ? `${t.prompt.slice(0, 77)}...` : t.prompt, a = t.status, g = t.usage.knownTokens.total, l = s.filter((e) => e.status === "failed").length, r = t.usage.cost?.total, o = r === void 0 ? void 0 : x(r);
+    return i`<calcite-block .heading=${h || `Run ${t.number}`} .description=${`${s.length} spans | ${m(t)} | ${g.toLocaleString()} tokens${o === void 0 ? "" : ` (${o})`}${l ? ` | ${l} failed` : ""}`} .iconStart=${a === "running" ? void 0 : u[a]} .label=${`Run ${t.number}: ${a}`} scale=s expandable expanded><calcite-action slot=actions-end icon=information scale=s text="View run details" @click=${(e) => {
+      e.stopPropagation(), this.arcgisInternalRunSelect.emit();
+    }}></calcite-action>${a === "running" ? i`<calcite-loader slot=content-start inline scale=s .label=${`Run ${t.number} running`}></calcite-loader>` : null}<calcite-tree aria-label=${`Run ${t.number} spans`} lines scale=s selection-mode=children @calciteTreeSelect=${(e) => {
+      const d = e.currentTarget.selectedItems[0]?.dataset.spanId;
+      d && this.arcgisInternalSpanSelect.emit(d);
+    }}>${c.map((e) => this.renderSpan(e, n))}</calcite-tree></calcite-block>`;
+  }
+}
+$("arcgis-assistant-observation-run", R);
+export {
+  R as ArcgisAssistantObservationRun
+};

package/dist/components/arcgis-assistant-observation-run/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-observation-run/index.js

@@ -0,0 +1,7 @@
+import "@esri/calcite-components/components/calcite-tree-item";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-tree";
+import "@esri/calcite-components/components/calcite-block";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-loader";
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-observation-usage/customElement.d.ts

@@ -0,0 +1,22 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ObservationUsage } from "../arcgis-assistant-observation-panel/support/observationSnapshot.js";
+import type { ModelPricingCatalog } from "../arcgis-assistant-observation-panel/support/modelPricing.js";
+
+/**
+ * Displays token usage and estimated costs for a span or a run's model calls.
+ *
+ * @internal
+ */
+export abstract class ArcgisAssistantObservationUsage extends LitElement {
+  /**
+   * Whether to display aggregate usage without per-model rates.
+   *
+   * @default false
+   */
+  accessor aggregate: boolean;
+  /** Pricing catalog used for estimated text-token costs. */
+  accessor pricing: ModelPricingCatalog;
+  /** Prepared token usage and cost breakdown. */
+  accessor usage: ObservationUsage | undefined;
+}

package/dist/components/arcgis-assistant-observation-usage/customElement.js

@@ -0,0 +1,82 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as g } from "../../chunks/runtime.js";
+import { css as u, html as l } from "lit";
+import { LitElement as b } from "@arcgis/lumina";
+import { d as p, f as c } from "../../chunks/modelPricing.js";
+const h = u`:host{display:block;min-width:0}h3{margin:0 0 var(--calcite-spacing-sm);font-size:var(--calcite-font-size-relative-base);font-weight:var(--calcite-font-weight-semibold)}.token-table{overflow-x:auto}calcite-table{font-variant-numeric:tabular-nums}.pricing{margin:var(--calcite-spacing-sm) 0 0;color:var(--calcite-color-text-3);font-size:var(--calcite-font-size-relative-sm);overflow-wrap:anywhere}`, m = new Intl.NumberFormat(void 0, {
+  style: "currency",
+  currency: "USD",
+  maximumFractionDigits: 6
+});
+function n(r) {
+  return r === void 0 ? "Unavailable" : m.format(r);
+}
+class v extends b {
+  constructor() {
+    super(...arguments), this.aggregate = !1, this.pricing = p;
+  }
+  static {
+    this.properties = { usage: 0, aggregate: 5, pricing: 0 };
+  }
+  static {
+    this.styles = h;
+  }
+  render() {
+    const s = this.usage;
+    if (!s)
+      return null;
+    const { tokens: t, cost: e, rates: i, uncached: o } = s, d = [
+      // Input tokens neither read from nor written to cache.
+      {
+        group: "Input",
+        groupRows: 4,
+        label: "Non-cached input",
+        tokens: o === void 0 ? "Not reported" : Number.isFinite(o) && o >= 0 ? o.toLocaleString() : "Invalid usage",
+        rate: n(i?.input),
+        cost: c(e?.input)
+      },
+      // Input tokens reused from an existing cache.
+      {
+        label: "Cache reads",
+        tokens: t.cacheRead?.toLocaleString() ?? "Not reported",
+        rate: n(i?.cachedInput),
+        cost: t.cacheRead === void 0 ? "Not reported" : c(e?.cachedInput)
+      },
+      // Input tokens stored in cache for later reuse.
+      {
+        label: "Cache writes",
+        tokens: t.cacheWrite?.toLocaleString() ?? "Not reported",
+        rate: n(i?.cacheWrite),
+        cost: t.cacheWrite === void 0 ? "Not reported" : c(e?.cacheWrite)
+      },
+      // All input tokens and costs across the three input categories.
+      {
+        label: "Input (total)",
+        tokens: t.input?.toLocaleString() ?? "Unavailable",
+        rate: "-",
+        cost: c(e ? e.input + e.cachedInput + e.cacheWrite : void 0)
+      },
+      // Reasoning tokens are a subset of output and are not charged again.
+      {
+        group: "Output",
+        groupRows: 2,
+        label: "Reasoning (within output)",
+        tokens: t.reasoning?.toLocaleString() ?? "Not reported",
+        rate: "-",
+        cost: "Included in output"
+      },
+      // All generated tokens, including reasoning tokens.
+      {
+        label: "Output (total)",
+        tokens: t.output?.toLocaleString() ?? "Unavailable",
+        rate: n(i?.output),
+        cost: c(e?.output)
+      }
+    ];
+    return l`<section aria-label=Usage><h3>Usage</h3><div class="token-table"><calcite-table aria-label="Token usage and estimated cost (USD)" caption="Token usage and estimated cost (USD)" scale=s interaction-mode=static bordered><calcite-table-row slot=table-header><calcite-table-header heading=Category col-span=2></calcite-table-header><calcite-table-header heading=Tokens alignment=end></calcite-table-header>${this.aggregate ? null : l`<calcite-table-header heading="Rate / 1M" alignment=end></calcite-table-header>`}<calcite-table-header heading="Est. cost" alignment=end></calcite-table-header></calcite-table-row>${d.map((a) => l`<calcite-table-row>${a.group ? l`<calcite-table-header .heading=${a.group} .rowSpan=${a.groupRows}></calcite-table-header>` : null}<calcite-table-header .heading=${a.label}></calcite-table-header><calcite-table-cell alignment=end>${a.tokens}</calcite-table-cell>${this.aggregate ? null : l`<calcite-table-cell alignment=end>${a.rate}</calcite-table-cell>`}<calcite-table-cell alignment=end>${a.cost}</calcite-table-cell></calcite-table-row>`)}<calcite-table-row slot=table-footer><calcite-table-header heading=Total col-span=2></calcite-table-header><calcite-table-cell alignment=end>${t.total?.toLocaleString() ?? "Unavailable"}</calcite-table-cell>${this.aggregate ? null : l`<calcite-table-cell alignment=end>-</calcite-table-cell>`}<calcite-table-cell alignment=end>${c(e?.total)}</calcite-table-cell></calcite-table-row></calcite-table></div><p class="pricing">Rates last updated: ${this.pricing.updatedAt}</p></section>`;
+  }
+}
+g("arcgis-assistant-observation-usage", v);
+export {
+  v as ArcgisAssistantObservationUsage
+};

package/dist/components/arcgis-assistant-observation-usage/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-observation-usage/index.js

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-table";
+import "@esri/calcite-components/components/calcite-table-row";
+import "@esri/calcite-components/components/calcite-table-header";
+import "@esri/calcite-components/components/calcite-table-cell";
+export * from "./customElement.js";

package/dist/components/assistant/assistant-agents/types.d.ts

@@ -0,0 +1,19 @@
+import type { AgentRegistration } from "../../../orchestrator/types.js";
+
+export type AssistantAgentDefinition = AgentRegistration | AgentRegistrationSource;
+
+/**
+ * An agent instance that provides the registration consumed by the assistant.
+ *
+ * @since 5.2
+ */
+export interface AgentRegistrationSource {
+  /** The unique identifier for the agent. */
+  readonly id: string;
+  /** The human-readable name of the agent. */
+  readonly name: string;
+  /** A description of the agent's purpose and capabilities. */
+  readonly description: string;
+  /** The registration consumed by the assistant. */
+  readonly registration: AgentRegistration;
+}