@generative-a11y/devtools 0.1.1 → 0.2.0

package/README.md

@@ -11,17 +11,17 @@ npm install --save-dev @generative-a11y/devtools
 ```
 
 ```ts
-import { createDevtoolsStore } from "@generative-a11y/devtools";
-import { THREAD_ADAPTER_METADATA } from "@generative-a11y/assistant-ui";
+import { createStore } from "@generative-a11y/devtools";
+import { adapterInfo } from "@generative-a11y/assistant-ui";
 
-const store = createDevtoolsStore({ maxEntries: 250 });
+const store = createStore({ maxEntries: 250 });
 const detach = store.attachRuntime({
   id: "support",
   runtime,
   source: {
-    adapter: THREAD_ADAPTER_METADATA.name,
-    fidelity: THREAD_ADAPTER_METADATA.fidelity,
-    evidence: THREAD_ADAPTER_METADATA.observedRuntimeMethods,
+    adapter: adapterInfo.name,
+    fidelity: adapterInfo.fidelity,
+    evidence: adapterInfo.observedRuntimeMethods,
   },
 });
 const unsubscribe = store.subscribe(renderDiagnostics);
@@ -39,9 +39,9 @@ store.dispose();
 
 ## Store API
 
-- `createDevtoolsStore({ maxEntries })` creates an isolated store. `maxEntries`
-  defaults to `250`, must be a positive safe integer, and bounds the retained
-  ring buffer. `droppedCount` reports records evicted since the last `clear()`.
+- `createStore({ maxEntries })` creates an isolated store. `maxEntries` defaults
+  to `250`, must be a positive safe integer, and bounds the retained ring
+  buffer. `droppedCount` reports records evicted since the last `clear()`.
 - `attachRuntime({ id, runtime })` validates a non-empty ID, subscribes only to
   public diagnostics, captures an initial safe snapshot, and returns an
   idempotent detach function. Attaching the same ID replaces its subscription
@@ -100,15 +100,30 @@ subscribes to a runtime.
 ## Browser delivery correlation
 
 The store intentionally does not import `@generative-a11y/dom`. Connect the
-announcer's public diagnostic callback yourself to capture a content-free
+active binding's `onDelivery` callback yourself to capture a content-free
 delivery record alongside runtime decisions:
 
 ```ts
-const announcer = createDOMAnnouncer({
-  onDiagnostic(result) {
+import { createRuntime } from "@generative-a11y/core";
+import { bindRuntime } from "@generative-a11y/dom";
+import { createStore } from "@generative-a11y/devtools";
+
+export const runtime = createRuntime();
+export const store = createStore();
+const detach = store.attachRuntime({ id: "support", runtime });
+const delivery = bindRuntime(runtime, {
+  onDelivery(result) {
     store.recordDelivery({ runtimeId: "support", result });
   },
 });
+
+// Dispatch your host events through runtime. Keep this binding for the session.
+export function disposeChat() {
+  delivery.dispose();
+  detach();
+  store.dispose();
+  runtime.dispose();
+}
 ```
 
 This exposes the browser-level method and status (`aria-notify`, fallback live
@@ -133,12 +148,28 @@ focus. The overlay does not trap focus, create a live region, modify host
 layout, or install global shortcuts.
 
 ```ts
-import { mountDevtoolsOverlay } from "@generative-a11y/devtools/overlay";
+import { mountOverlay } from "@generative-a11y/devtools/overlay";
 
-const overlay = mountDevtoolsOverlay({ store });
-overlay.dispose();
+const overlay = mountOverlay({ store });
+// Call overlay.dispose() when removing the workbench.
 ```
 
+## Attention decisions
+
+When core attention control is enabled, runtime snapshots include the observed
+mode, explicit user override, and effective normal/quiet state. The inspector
+shows these values under policy and scheduling. `attention-updated` explains
+control transitions; `attention-quiet` explains discarded routine output without
+an announcement backlog.
+
+`DevtoolsRecord.attentionMode` and `attentionOverride` preserve only recognized
+enum values from control events. Invalid mode payloads are omitted. Exports
+contain no DOM targets or reading history; the observation named
+`reading-history` means only the latest registered response is outside the
+intersection while the document is visible and focused. It does not track a
+screen-reader virtual cursor or prove what someone read. Existing trace schema 1
+consumers can ignore the optional fields.
+
 ## Documentation
 
 - [Devtools guide](https://generativea11y.com/docs/devtools)
@@ -154,3 +185,17 @@ overlay.dispose();
 - [`@generative-a11y/core/testing`](https://generativea11y.com/api/core/testing)
   provides deterministic replay and semantic test assertions without another
   package installation.
+
+## Localized announcements
+
+Runtime snapshots include optional `messages: { catalogId, locale }`. The
+inspector exposes only these fields and `catalog-format-error`; catalog
+messages, formatter arguments/functions and error text are not retained. Use a
+non-sensitive catalog ID.
+
+See the
+[localization guide](https://generativea11y.com/docs/localized-announcements).
+
+For React, pass the same callback through
+`<A11yProvider delivery={{ onDelivery }}>`. Do not create another announcer
+beside the provider; its existing delivery path supplies the reports.

package/dist/index.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  createDevtoolsStore: () => createDevtoolsStore
+  createStore: () => createStore
 });
 module.exports = __toCommonJS(index_exports);
 function asRecord(runtimeId, event, captureSequence, runtimeSourceId) {
@@ -33,6 +33,14 @@ function asRecord(runtimeId, event, captureSequence, runtimeSourceId) {
       at: event.at,
       kind: event.kind,
       sourceType: event.event.type,
+      ...event.event.type === "attention.changed" && [
+        "foreground",
+        "background",
+        "reading-history",
+        "away",
+        "unknown"
+      ].includes(event.event.mode) ? { attentionMode: event.event.mode } : {},
+      ...event.event.type === "attention.override" && ["auto", "normal", "quiet"].includes(event.event.mode) ? { attentionOverride: event.event.mode } : {},
       ...event.event.eventId ? { sourceEventId: event.event.eventId } : {},
       ..."runId" in event.event && event.event.runId ? { runId: event.event.runId } : {},
       ..."runInstanceId" in event.event && event.event.runInstanceId ? { runInstanceId: event.event.runInstanceId } : {},
@@ -191,8 +199,27 @@ function copyRuntimeSnapshot(source) {
       ...source.policy,
       text: Object.freeze({ ...source.policy.text }),
       tools: Object.freeze({ ...source.policy.tools }),
-      workflows: Object.freeze({ ...source.policy.workflows })
+      workflows: Object.freeze({ ...source.policy.workflows }),
+      ...source.policy.attention ? {
+        attention: Object.freeze({
+          ...source.policy.attention,
+          quietWhen: Object.freeze([...source.policy.attention.quietWhen])
+        })
+      } : {}
     }),
+    ...source.messages ? {
+      messages: Object.freeze({
+        catalogId: source.messages.catalogId,
+        locale: source.messages.locale
+      })
+    } : {},
+    ...source.attention ? {
+      attention: Object.freeze({
+        observed: source.attention.observed,
+        override: source.attention.override,
+        effective: source.attention.effective
+      })
+    } : {},
     pending: Object.freeze({
       announcements: Object.freeze(
         source.pending.announcements.map((item) => Object.freeze({ ...item }))
@@ -220,7 +247,7 @@ function copyRuntimeSnapshot(source) {
     pendingCount: source.pendingCount
   });
 }
-function createDevtoolsStore(options = {}) {
+function createStore(options = {}) {
   const maxEntries = options.maxEntries ?? 250;
   if (!Number.isSafeInteger(maxEntries) || maxEntries <= 0)
     throw new RangeError("maxEntries must be a positive safe integer");
@@ -427,5 +454,5 @@ function createDevtoolsStore(options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createDevtoolsStore
+  createStore
 });

package/dist/index.d.cts

@@ -1,7 +1,9 @@
-import { GenerativeA11yRuntime, AdapterFidelity, RuntimeDiagnosticEventV1, RuntimeDiagnosticSnapshotV1 } from '@generative-a11y/core';
+import { Runtime, AdapterFidelity, AttentionMode, AttentionOverride, RuntimeDiagnosticEventV1, RuntimeDiagnosticSnapshotV1 } from '@generative-a11y/core';
 
 type DevtoolsRecordKind = RuntimeDiagnosticEventV1["kind"] | "dom-delivery";
 interface DevtoolsRecord {
+    readonly attentionMode?: AttentionMode;
+    readonly attentionOverride?: AttentionOverride;
     readonly runtimeId: string;
     /** Opaque key for the immutable adapter evidence captured with this record. */
     readonly runtimeSourceId?: string;
@@ -113,15 +115,15 @@ interface DevtoolsTraceExportV1 {
     readonly runtimeSnapshots: Readonly<Record<string, RuntimeDiagnosticSnapshotV1>>;
     readonly runtimeSources: Readonly<Record<string, DevtoolsRuntimeSource>>;
 }
-interface DevtoolsStoreOptions {
+interface StoreOptions {
     readonly maxEntries?: number;
 }
 interface AttachRuntimeOptions {
     readonly id: string;
-    readonly runtime: Pick<GenerativeA11yRuntime, "subscribeDiagnosticEvents" | "getDiagnosticSnapshot">;
+    readonly runtime: Pick<Runtime, "subscribeDiagnosticEvents" | "getDiagnosticSnapshot">;
     readonly source?: DevtoolsRuntimeSource;
 }
-interface DevtoolsStore {
+interface Store {
     attachRuntime(options: AttachRuntimeOptions): () => void;
     getSnapshot(): DevtoolsSnapshot;
     subscribe(listener: () => void): () => void;
@@ -133,6 +135,6 @@ interface DevtoolsStore {
     exportTrace(): DevtoolsTraceExportV1;
     dispose(): void;
 }
-declare function createDevtoolsStore(options?: DevtoolsStoreOptions): DevtoolsStore;
+declare function createStore(options?: StoreOptions): Store;
 
-export { type AttachRuntimeOptions, type DeliveryRecordInput, type DevtoolsRecord, type DevtoolsRecordKind, type DevtoolsRuntimeSource, type DevtoolsSnapshot, type DevtoolsStore, type DevtoolsStoreOptions, type DevtoolsTraceExportV1, createDevtoolsStore };
+export { type AttachRuntimeOptions, type DeliveryRecordInput, type DevtoolsRecord, type DevtoolsRecordKind, type DevtoolsRuntimeSource, type DevtoolsSnapshot, type DevtoolsTraceExportV1, type Store, type StoreOptions, createStore };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-import { GenerativeA11yRuntime, AdapterFidelity, RuntimeDiagnosticEventV1, RuntimeDiagnosticSnapshotV1 } from '@generative-a11y/core';
+import { Runtime, AdapterFidelity, AttentionMode, AttentionOverride, RuntimeDiagnosticEventV1, RuntimeDiagnosticSnapshotV1 } from '@generative-a11y/core';
 
 type DevtoolsRecordKind = RuntimeDiagnosticEventV1["kind"] | "dom-delivery";
 interface DevtoolsRecord {
+    readonly attentionMode?: AttentionMode;
+    readonly attentionOverride?: AttentionOverride;
     readonly runtimeId: string;
     /** Opaque key for the immutable adapter evidence captured with this record. */
     readonly runtimeSourceId?: string;
@@ -113,15 +115,15 @@ interface DevtoolsTraceExportV1 {
     readonly runtimeSnapshots: Readonly<Record<string, RuntimeDiagnosticSnapshotV1>>;
     readonly runtimeSources: Readonly<Record<string, DevtoolsRuntimeSource>>;
 }
-interface DevtoolsStoreOptions {
+interface StoreOptions {
     readonly maxEntries?: number;
 }
 interface AttachRuntimeOptions {
     readonly id: string;
-    readonly runtime: Pick<GenerativeA11yRuntime, "subscribeDiagnosticEvents" | "getDiagnosticSnapshot">;
+    readonly runtime: Pick<Runtime, "subscribeDiagnosticEvents" | "getDiagnosticSnapshot">;
     readonly source?: DevtoolsRuntimeSource;
 }
-interface DevtoolsStore {
+interface Store {
     attachRuntime(options: AttachRuntimeOptions): () => void;
     getSnapshot(): DevtoolsSnapshot;
     subscribe(listener: () => void): () => void;
@@ -133,6 +135,6 @@ interface DevtoolsStore {
     exportTrace(): DevtoolsTraceExportV1;
     dispose(): void;
 }
-declare function createDevtoolsStore(options?: DevtoolsStoreOptions): DevtoolsStore;
+declare function createStore(options?: StoreOptions): Store;
 
-export { type AttachRuntimeOptions, type DeliveryRecordInput, type DevtoolsRecord, type DevtoolsRecordKind, type DevtoolsRuntimeSource, type DevtoolsSnapshot, type DevtoolsStore, type DevtoolsStoreOptions, type DevtoolsTraceExportV1, createDevtoolsStore };
+export { type AttachRuntimeOptions, type DeliveryRecordInput, type DevtoolsRecord, type DevtoolsRecordKind, type DevtoolsRuntimeSource, type DevtoolsSnapshot, type DevtoolsTraceExportV1, type Store, type StoreOptions, createStore };

package/dist/index.js

@@ -9,6 +9,14 @@ function asRecord(runtimeId, event, captureSequence, runtimeSourceId) {
       at: event.at,
       kind: event.kind,
       sourceType: event.event.type,
+      ...event.event.type === "attention.changed" && [
+        "foreground",
+        "background",
+        "reading-history",
+        "away",
+        "unknown"
+      ].includes(event.event.mode) ? { attentionMode: event.event.mode } : {},
+      ...event.event.type === "attention.override" && ["auto", "normal", "quiet"].includes(event.event.mode) ? { attentionOverride: event.event.mode } : {},
       ...event.event.eventId ? { sourceEventId: event.event.eventId } : {},
       ..."runId" in event.event && event.event.runId ? { runId: event.event.runId } : {},
       ..."runInstanceId" in event.event && event.event.runInstanceId ? { runInstanceId: event.event.runInstanceId } : {},
@@ -167,8 +175,27 @@ function copyRuntimeSnapshot(source) {
       ...source.policy,
       text: Object.freeze({ ...source.policy.text }),
       tools: Object.freeze({ ...source.policy.tools }),
-      workflows: Object.freeze({ ...source.policy.workflows })
+      workflows: Object.freeze({ ...source.policy.workflows }),
+      ...source.policy.attention ? {
+        attention: Object.freeze({
+          ...source.policy.attention,
+          quietWhen: Object.freeze([...source.policy.attention.quietWhen])
+        })
+      } : {}
     }),
+    ...source.messages ? {
+      messages: Object.freeze({
+        catalogId: source.messages.catalogId,
+        locale: source.messages.locale
+      })
+    } : {},
+    ...source.attention ? {
+      attention: Object.freeze({
+        observed: source.attention.observed,
+        override: source.attention.override,
+        effective: source.attention.effective
+      })
+    } : {},
     pending: Object.freeze({
       announcements: Object.freeze(
         source.pending.announcements.map((item) => Object.freeze({ ...item }))
@@ -196,7 +223,7 @@ function copyRuntimeSnapshot(source) {
     pendingCount: source.pendingCount
   });
 }
-function createDevtoolsStore(options = {}) {
+function createStore(options = {}) {
   const maxEntries = options.maxEntries ?? 250;
   if (!Number.isSafeInteger(maxEntries) || maxEntries <= 0)
     throw new RangeError("maxEntries must be a positive safe integer");
@@ -402,5 +429,5 @@ function createDevtoolsStore(options = {}) {
   };
 }
 export {
-  createDevtoolsStore
+  createStore
 };

package/dist/overlay.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/overlay.ts
 var overlay_exports = {};
 __export(overlay_exports, {
-  mountDevtoolsOverlay: () => mountDevtoolsOverlay
+  mountOverlay: () => mountOverlay
 });
 module.exports = __toCommonJS(overlay_exports);
 var import_react2 = require("react");
@@ -284,7 +284,7 @@ function relatedRecords(records, selected) {
 }
 function explain(record) {
   if (record.kind === "event-observed")
-    return "The adapter supplied this normalized public lifecycle signal.";
+    return record.sourceType?.startsWith("attention.") ? "The host supplied an attention observation or explicit user override. Browser evidence does not establish what someone is reading." : "The adapter supplied this normalized public lifecycle signal.";
   if (record.kind === "dom-delivery")
     return record.deliveryStatus === "unavailable" ? "The DOM driver was unavailable, so no browser delivery action was observed." : "The DOM driver reported this delivery action.";
   return {
@@ -292,6 +292,9 @@ function explain(record) {
     coalesced: "The runtime merged this work with an existing queued announcement.",
     duplicate: "The runtime suppressed a recently delivered duplicate.",
     "policy-silent": "The active policy intentionally made this event silent.",
+    "catalog-format-error": "The host message formatter failed; the runtime used a generic English notice without retaining the error or parameters.",
+    "attention-quiet": "Quiet mode discarded routine output without retaining an announcement backlog.",
+    "attention-updated": "The runtime updated its attention observation or user override without announcing the control event.",
     "queue-capacity": "The bounded queue rejected or displaced this work.",
     "scope-cancelled": "The lifecycle scope ended before this queued work delivered.",
     "runtime-disposed": "The runtime was disposed and cancelled remaining queued work.",
@@ -443,6 +446,30 @@ function Detail({
     /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("section", { className: "ga-detail-section", children: [
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("h4", { children: "Policy and scheduling" }),
       runtime ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("dl", { className: "ga-key-values", children: [
+        runtime.messages && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dt", { children: "Announcement catalog" }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dd", { children: runtime.messages.catalogId })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dt", { children: "Notice language" }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dd", { children: runtime.messages.locale })
+          ] })
+        ] }),
+        runtime.attention && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dt", { children: "Effective announcements" }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dd", { children: runtime.attention.effective })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dt", { children: "Observed attention" }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dd", { children: runtime.attention.observed })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dt", { children: "User override" }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dd", { children: runtime.attention.override })
+          ] })
+        ] }),
         /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
           /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("dt", { children: "Queue" }),
           /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("dd", { children: [
@@ -532,11 +559,7 @@ function List({
     }
   );
 }
-function DevtoolsInspector({
-  store,
-  onClose,
-  onCopy
-}) {
+function Inspector({ store, onClose, onCopy }) {
   const snapshot = useSnapshot(store);
   const reduceMotion = (0, import_react.useReducedMotion)();
   const [query, setQuery] = React4.useState("");
@@ -842,7 +865,7 @@ button:focus-visible, input:focus-visible, [role="listbox"]:focus-visible, [role
 .ga-workspace-feedback { top: 68px; color: #f7f7f7; background: #111; border-color: #111; border-radius: 3px; box-shadow: none; }
 @media (max-width: 760px) { .ga-bottom-dock { height: min(720px, 80vh); } .ga-inspector-header, .ga-session-toolbar { padding-right: 12px; padding-left: 12px; } .ga-session-toolbar { flex-wrap: wrap; } .ga-inspector-search { width: 100%; } .ga-session-count { margin-left: 0; } .ga-explorer-layout { flex-direction: column; } [data-slot="resizable-handle"] { width: 100%; height: 1px; } .ga-trace-row { grid-template-columns: 70px 1fr; padding: 8px 12px; } .ga-trace-row span, .ga-trace-row code { grid-column: 2; } .ga-trace-detail { padding: 18px 12px; } .ga-key-values { grid-template-columns: 1fr; } .ga-key-values-wide { grid-column: auto; } }
 `;
-function mountDevtoolsOverlay(options) {
+function mountOverlay(options) {
   const selectedDocument = options.document ?? (typeof document === "undefined" ? void 0 : document);
   if (!selectedDocument?.body)
     throw new Error("A mountable document is required");
@@ -897,7 +920,7 @@ function mountDevtoolsOverlay(options) {
       return clipboard.writeText(value);
     });
     root.render(
-      (0, import_react2.createElement)(DevtoolsInspector, {
+      (0, import_react2.createElement)(Inspector, {
         onClose: close,
         onCopy: copyText,
         store: options.store
@@ -936,5 +959,5 @@ function mountDevtoolsOverlay(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  mountDevtoolsOverlay
+  mountOverlay
 });

package/dist/overlay.d.cts

@@ -1,15 +1,15 @@
-import { DevtoolsStore } from './index.cjs';
+import { Store } from './index.cjs';
 import '@generative-a11y/core';
 
-interface MountDevtoolsOverlayOptions {
-    readonly store: DevtoolsStore;
+interface OverlayOptions {
+    readonly store: Store;
     readonly document?: Document;
     readonly copyText?: (value: string) => void | Promise<void>;
 }
-interface MountedDevtoolsOverlay {
+interface Overlay {
     readonly host: HTMLElement;
     dispose(): void;
 }
-declare function mountDevtoolsOverlay(options: MountDevtoolsOverlayOptions): MountedDevtoolsOverlay;
+declare function mountOverlay(options: OverlayOptions): Overlay;
 
-export { type MountDevtoolsOverlayOptions, type MountedDevtoolsOverlay, mountDevtoolsOverlay };
+export { type Overlay, type OverlayOptions, mountOverlay };

package/dist/overlay.d.ts

@@ -1,15 +1,15 @@
-import { DevtoolsStore } from './index.js';
+import { Store } from './index.js';
 import '@generative-a11y/core';
 
-interface MountDevtoolsOverlayOptions {
-    readonly store: DevtoolsStore;
+interface OverlayOptions {
+    readonly store: Store;
     readonly document?: Document;
     readonly copyText?: (value: string) => void | Promise<void>;
 }
-interface MountedDevtoolsOverlay {
+interface Overlay {
     readonly host: HTMLElement;
     dispose(): void;
 }
-declare function mountDevtoolsOverlay(options: MountDevtoolsOverlayOptions): MountedDevtoolsOverlay;
+declare function mountOverlay(options: OverlayOptions): Overlay;
 
-export { type MountDevtoolsOverlayOptions, type MountedDevtoolsOverlay, mountDevtoolsOverlay };
+export { type Overlay, type OverlayOptions, mountOverlay };

package/dist/overlay.js

@@ -187,7 +187,7 @@ function ScrollBar({
 }
 
 // src/inspector.tsx
-import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
 var key = (record) => String(record.captureSequence);
 var time = (value) => value >= 1e10 ? new Date(value).toISOString().slice(11, 23) : `+${(value / 1e3).toFixed(2)}s`;
 var stage = (record) => record.kind === "event-observed" ? "Source evidence" : record.kind === "decision" ? "Runtime decision" : "DOM delivery";
@@ -250,7 +250,7 @@ function relatedRecords(records, selected) {
 }
 function explain(record) {
   if (record.kind === "event-observed")
-    return "The adapter supplied this normalized public lifecycle signal.";
+    return record.sourceType?.startsWith("attention.") ? "The host supplied an attention observation or explicit user override. Browser evidence does not establish what someone is reading." : "The adapter supplied this normalized public lifecycle signal.";
   if (record.kind === "dom-delivery")
     return record.deliveryStatus === "unavailable" ? "The DOM driver was unavailable, so no browser delivery action was observed." : "The DOM driver reported this delivery action.";
   return {
@@ -258,6 +258,9 @@ function explain(record) {
     coalesced: "The runtime merged this work with an existing queued announcement.",
     duplicate: "The runtime suppressed a recently delivered duplicate.",
     "policy-silent": "The active policy intentionally made this event silent.",
+    "catalog-format-error": "The host message formatter failed; the runtime used a generic English notice without retaining the error or parameters.",
+    "attention-quiet": "Quiet mode discarded routine output without retaining an announcement backlog.",
+    "attention-updated": "The runtime updated its attention observation or user override without announcing the control event.",
     "queue-capacity": "The bounded queue rejected or displaced this work.",
     "scope-cancelled": "The lifecycle scope ended before this queued work delivered.",
     "runtime-disposed": "The runtime was disposed and cancelled remaining queued work.",
@@ -409,6 +412,30 @@ function Detail({
     /* @__PURE__ */ jsxs2("section", { className: "ga-detail-section", children: [
       /* @__PURE__ */ jsx5("h4", { children: "Policy and scheduling" }),
       runtime ? /* @__PURE__ */ jsxs2("dl", { className: "ga-key-values", children: [
+        runtime.messages && /* @__PURE__ */ jsxs2(Fragment, { children: [
+          /* @__PURE__ */ jsxs2("div", { children: [
+            /* @__PURE__ */ jsx5("dt", { children: "Announcement catalog" }),
+            /* @__PURE__ */ jsx5("dd", { children: runtime.messages.catalogId })
+          ] }),
+          /* @__PURE__ */ jsxs2("div", { children: [
+            /* @__PURE__ */ jsx5("dt", { children: "Notice language" }),
+            /* @__PURE__ */ jsx5("dd", { children: runtime.messages.locale })
+          ] })
+        ] }),
+        runtime.attention && /* @__PURE__ */ jsxs2(Fragment, { children: [
+          /* @__PURE__ */ jsxs2("div", { children: [
+            /* @__PURE__ */ jsx5("dt", { children: "Effective announcements" }),
+            /* @__PURE__ */ jsx5("dd", { children: runtime.attention.effective })
+          ] }),
+          /* @__PURE__ */ jsxs2("div", { children: [
+            /* @__PURE__ */ jsx5("dt", { children: "Observed attention" }),
+            /* @__PURE__ */ jsx5("dd", { children: runtime.attention.observed })
+          ] }),
+          /* @__PURE__ */ jsxs2("div", { children: [
+            /* @__PURE__ */ jsx5("dt", { children: "User override" }),
+            /* @__PURE__ */ jsx5("dd", { children: runtime.attention.override })
+          ] })
+        ] }),
         /* @__PURE__ */ jsxs2("div", { children: [
           /* @__PURE__ */ jsx5("dt", { children: "Queue" }),
           /* @__PURE__ */ jsxs2("dd", { children: [
@@ -498,11 +525,7 @@ function List({
     }
   );
 }
-function DevtoolsInspector({
-  store,
-  onClose,
-  onCopy
-}) {
+function Inspector({ store, onClose, onCopy }) {
   const snapshot = useSnapshot(store);
   const reduceMotion = useReducedMotion();
   const [query, setQuery] = React4.useState("");
@@ -808,7 +831,7 @@ button:focus-visible, input:focus-visible, [role="listbox"]:focus-visible, [role
 .ga-workspace-feedback { top: 68px; color: #f7f7f7; background: #111; border-color: #111; border-radius: 3px; box-shadow: none; }
 @media (max-width: 760px) { .ga-bottom-dock { height: min(720px, 80vh); } .ga-inspector-header, .ga-session-toolbar { padding-right: 12px; padding-left: 12px; } .ga-session-toolbar { flex-wrap: wrap; } .ga-inspector-search { width: 100%; } .ga-session-count { margin-left: 0; } .ga-explorer-layout { flex-direction: column; } [data-slot="resizable-handle"] { width: 100%; height: 1px; } .ga-trace-row { grid-template-columns: 70px 1fr; padding: 8px 12px; } .ga-trace-row span, .ga-trace-row code { grid-column: 2; } .ga-trace-detail { padding: 18px 12px; } .ga-key-values { grid-template-columns: 1fr; } .ga-key-values-wide { grid-column: auto; } }
 `;
-function mountDevtoolsOverlay(options) {
+function mountOverlay(options) {
   const selectedDocument = options.document ?? (typeof document === "undefined" ? void 0 : document);
   if (!selectedDocument?.body)
     throw new Error("A mountable document is required");
@@ -863,7 +886,7 @@ function mountDevtoolsOverlay(options) {
       return clipboard.writeText(value);
     });
     root.render(
-      createElement(DevtoolsInspector, {
+      createElement(Inspector, {
         onClose: close,
         onCopy: copyText,
         store: options.store
@@ -901,5 +924,5 @@ function mountDevtoolsOverlay(options) {
   };
 }
 export {
-  mountDevtoolsOverlay
+  mountOverlay
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@generative-a11y/devtools",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Development-only accessibility diagnostics and a redacted trace explorer for screen-reader announcements in AI runtimes.",
   "keywords": [
     "accessibility",
@@ -56,11 +56,11 @@
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
     "lucide-react": "1.31.0",
-    "motion": "^12.23.12",
+    "motion": "^13.1.1",
     "radix-ui": "1.6.7",
     "react-resizable-panels": "^4.12.3",
     "tailwind-merge": "3.6.0",
-    "@generative-a11y/core": "0.3.0"
+    "@generative-a11y/core": "0.4.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",