@tooluminati/diagnostics 0.1.1 → 0.2.0

package/dist/action-availability.js

@@ -13,7 +13,7 @@ export function createActionAvailabilityTool(provider, name = 'why_is_action_una
             required: ['actionId'],
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         validateArgs(args) {
             if (typeof args !== 'object' ||
                 args === null ||
@@ -38,7 +38,7 @@ export function createListActionsTool(provider, name = 'list_available_actions')
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: () => ({ actions: provider.listActions?.() ?? [] }),
     };
 }

package/dist/annotations.test.d.ts

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

package/dist/annotations.test.d.ts.map

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

package/dist/annotations.test.js

@@ -0,0 +1,32 @@
+import { expect, it } from 'vitest';
+import { createAppInfoTool, createVisibleToolsTool, createActionAvailabilityTool, createListActionsTool, createFeatureFlagsTool, createHydrationHealthTool, createMountedFormsRegistry, createMountedFormsSummaryTool, createRecentClientErrorsTool, ClientErrorBuffer, createTroubleshootingTimelineTool, TroubleshootingTimelineBuffer, createWorkflowBlockersTool, createWebMcpEnvironmentTool, createWebMcpEnvironmentSummary, } from './index';
+const actions = { getActionAvailability: () => undefined };
+const tools = [
+    createAppInfoTool(() => ({ name: 'test' })),
+    createVisibleToolsTool(),
+    createActionAvailabilityTool(actions),
+    createListActionsTool(actions),
+    createFeatureFlagsTool(() => []),
+    createHydrationHealthTool(() => ({ recoverableErrorCount: 0 })),
+    createMountedFormsSummaryTool(createMountedFormsRegistry()),
+    createRecentClientErrorsTool(new ClientErrorBuffer()),
+    createTroubleshootingTimelineTool(new TroubleshootingTimelineBuffer()),
+    createWorkflowBlockersTool({}),
+    createWebMcpEnvironmentTool(() => createWebMcpEnvironmentSummary()),
+];
+it.each(tools.map((tool) => [tool.name, tool]))('%s is annotated as a read-only diagnostic', (_name, tool) => {
+    expect(tool.annotations).toMatchObject({
+        readOnlyHint: true,
+        debugging: true,
+    });
+    expect(tool.annotations?.consequentialHint).not.toBe(true);
+});
+it.each(tools
+    .filter((tool) => [
+    'get_recent_client_errors',
+    'get_troubleshooting_timeline',
+    'get_workflow_blockers',
+].includes(tool.name))
+    .map((tool) => [tool.name, tool]))('%s retains untrusted-content annotation', (_name, tool) => {
+    expect(tool.annotations?.untrustedContentHint).toBe(true);
+});

package/dist/app-info.js

@@ -7,7 +7,7 @@ export function createAppInfoTool(getInfo, name = 'get_app_info') {
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: () => getInfo(),
     };
 }
@@ -20,7 +20,7 @@ export function createVisibleToolsTool(name = 'get_visible_agent_tools') {
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: (_args, context) => ({
             tools: context.registry.getVisibleToolSummaries(),
         }),

package/dist/declarative-submit.d.ts

@@ -0,0 +1,5 @@
+export declare const WEBMCP_DECLARATIVE_FOCUS_STYLES = "\nform:tool-form-active {\n  outline: light-dark(#0aadf2, #0aadf2) dashed 1px;\n  outline-offset: -1px;\n}\n\n:tool-submit-active {\n  outline: light-dark(#fecd10, #fecd10) dashed 1px;\n  outline-offset: -1px;\n}\n";
+export declare function isAgentInvokedSubmit(event: Event): boolean;
+export declare function respondWithAgentResult(event: Event, result: unknown): boolean;
+export declare function ensureDeclarativeFocusStyles(): void;
+//# sourceMappingURL=declarative-submit.d.ts.map

package/dist/declarative-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarative-submit.d.ts","sourceRoot":"","sources":["../src/declarative-submit.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,2NAU3C,CAAC;AAOF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE1D;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,GACd,OAAO,CAST;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAcnD"}

package/dist/declarative-submit.js

@@ -0,0 +1,36 @@
+export const WEBMCP_DECLARATIVE_FOCUS_STYLES = `
+form:tool-form-active {
+  outline: light-dark(#0aadf2, #0aadf2) dashed 1px;
+  outline-offset: -1px;
+}
+
+:tool-submit-active {
+  outline: light-dark(#fecd10, #fecd10) dashed 1px;
+  outline-offset: -1px;
+}
+`;
+export function isAgentInvokedSubmit(event) {
+    return Boolean(event.agentInvoked);
+}
+export function respondWithAgentResult(event, result) {
+    const submit = event;
+    if (!submit.agentInvoked || typeof submit.respondWith !== 'function') {
+        return false;
+    }
+    submit.preventDefault();
+    submit.respondWith(Promise.resolve(result));
+    return true;
+}
+export function ensureDeclarativeFocusStyles() {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const id = 'tooluminati-webmcp-declarative-focus';
+    if (document.getElementById(id)) {
+        return;
+    }
+    const style = document.createElement('style');
+    style.id = id;
+    style.textContent = WEBMCP_DECLARATIVE_FOCUS_STYLES;
+    document.head.appendChild(style);
+}

package/dist/declarative-submit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=declarative-submit.test.d.ts.map

package/dist/declarative-submit.test.d.ts.map

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

package/dist/declarative-submit.test.js

@@ -0,0 +1,61 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { ensureDeclarativeFocusStyles, isAgentInvokedSubmit, respondWithAgentResult, WEBMCP_DECLARATIVE_FOCUS_STYLES, } from './declarative-submit';
+afterEach(() => {
+    vi.unstubAllGlobals();
+    document.getElementById('tooluminati-webmcp-declarative-focus')?.remove();
+});
+function submit(agentInvoked, respondWith) {
+    return Object.assign(new Event('submit', { cancelable: true }), {
+        agentInvoked,
+        respondWith,
+    });
+}
+describe('agent results', () => {
+    it.each([false, undefined])('leaves human submits untouched (%s)', (agentInvoked) => {
+        const respondWith = vi.fn();
+        const event = submit(agentInvoked, respondWith);
+        expect(isAgentInvokedSubmit(event)).toBe(false);
+        expect(respondWithAgentResult(event, 'done')).toBe(false);
+        expect(event.defaultPrevented).toBe(false);
+        expect(respondWith).not.toHaveBeenCalled();
+    });
+    it.each([undefined, true, 'invalid'])('ignores unsupported respondWith %s', (respondWith) => {
+        const event = submit(true, respondWith);
+        expect(respondWithAgentResult(event, 'done')).toBe(false);
+        expect(event.defaultPrevented).toBe(false);
+    });
+    it('passes a resolved promise synchronously and prevents default submission', async () => {
+        const respondWith = vi.fn();
+        const event = submit(true, respondWith);
+        expect(respondWithAgentResult(event, { saved: true })).toBe(true);
+        expect(event.defaultPrevented).toBe(true);
+        expect(respondWith).toHaveBeenCalledOnce();
+        await expect(respondWith.mock.calls[0][0]).resolves.toEqual({
+            saved: true,
+        });
+    });
+    it('preserves rejection for the browser consumer', async () => {
+        const error = new Error('save failed');
+        const result = Promise.reject(error);
+        const respondWith = vi.fn();
+        respondWithAgentResult(submit(true, respondWith), result);
+        expect(respondWith.mock.calls[0][0]).toBe(result);
+        await expect(result).rejects.toBe(error);
+    });
+});
+describe('declarative focus styles', () => {
+    it('injects one shared style node across repeated calls', () => {
+        ensureDeclarativeFocusStyles();
+        const style = document.getElementById('tooluminati-webmcp-declarative-focus');
+        ensureDeclarativeFocusStyles();
+        expect(document.querySelectorAll('#tooluminati-webmcp-declarative-focus')).toHaveLength(1);
+        expect(style?.parentElement).toBe(document.head);
+        expect(style?.textContent).toBe(WEBMCP_DECLARATIVE_FOCUS_STYLES);
+        expect(style?.textContent).toContain('form:tool-form-active');
+        expect(style?.textContent).toContain(':tool-submit-active');
+    });
+    it('does nothing during SSR', () => {
+        vi.stubGlobal('document', undefined);
+        expect(ensureDeclarativeFocusStyles).not.toThrow();
+    });
+});

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACrC;AAQD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAoD;IAC5E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA2B;gBAEzC,OAAO,GAAE,wBAAwB,GAAG,MAAW;IAgB3D,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAkBrC,IAAI,IAAI,kBAAkB,EAAE;IAI5B,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,oBAAoB;AACpB,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,MAAM,IAAI,CAkCZ;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,iBAAiB,EACzB,IAAI,SAA6B,GAChC,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAa/E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACrC;AAQD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAoD;IAC5E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA2B;gBAEzC,OAAO,GAAE,wBAAwB,GAAG,MAAW;IAgB3D,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAkBrC,IAAI,IAAI,kBAAkB,EAAE;IAI5B,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,oBAAoB;AACpB,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,MAAM,IAAI,CAkCZ;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,iBAAiB,EACzB,IAAI,SAA6B,GAChC,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAiB/E"}

package/dist/errors.js

@@ -85,7 +85,11 @@ export function createRecentClientErrorsTool(buffer, name = 'get_recent_client_e
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true, untrustedContentHint: true },
+        annotations: {
+            readOnlyHint: true,
+            untrustedContentHint: true,
+            debugging: true,
+        },
         execute: () => ({ errors: buffer.list() }),
     };
 }

package/dist/feature-flags.js

@@ -7,7 +7,7 @@ export function createFeatureFlagsTool(getFlags, name = 'get_feature_flags_summa
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: () => ({ flags: getFlags() }),
     };
 }

package/dist/hydration.js

@@ -20,7 +20,7 @@ export function createHydrationHealthTool(getHealth, name = 'get_hydration_healt
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: () => getHealth(),
     };
 }

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   ClientErrorBuffer: () => ClientErrorBuffer,
   TROUBLESHOOTING_GUIDANCE: () => TROUBLESHOOTING_GUIDANCE,
   TroubleshootingTimelineBuffer: () => TroubleshootingTimelineBuffer,
+  WEBMCP_DECLARATIVE_FOCUS_STYLES: () => WEBMCP_DECLARATIVE_FOCUS_STYLES,
   buildTroubleshootingPanelSnapshot: () => buildTroubleshootingPanelSnapshot,
   computeTroubleshootingPanelState: () => computeTroubleshootingPanelState,
   createActionAvailabilityTool: () => createActionAvailabilityTool,
@@ -46,13 +47,16 @@ __export(index_exports, {
   createWebMcpLifecycleCollector: () => createWebMcpLifecycleCollector,
   createWorkflowBlockersTool: () => createWorkflowBlockersTool,
   discoverDeclarativeForms: () => discoverDeclarativeForms,
+  ensureDeclarativeFocusStyles: () => ensureDeclarativeFocusStyles,
   filterPanelEvents: () => filterPanelEvents,
   formSummaryFromMounted: () => formSummaryFromMounted,
   getGuidanceForClientError: () => getGuidanceForClientError,
   getGuidanceForEnvironmentCheck: () => getGuidanceForEnvironmentCheck,
   getGuidanceForTimelineEvent: () => getGuidanceForTimelineEvent,
+  isAgentInvokedSubmit: () => isAgentInvokedSubmit,
   isPanelEnabledByDefault: () => isPanelEnabledByDefault,
   isPanelUrlOverrideEnabled: () => isPanelUrlOverrideEnabled,
+  respondWithAgentResult: () => respondWithAgentResult,
   serializeTroubleshootingDiagnostics: () => serializeTroubleshootingDiagnostics,
   timelineEventGroup: () => timelineEventGroup
 });
@@ -74,7 +78,7 @@ function createActionAvailabilityTool(provider, name = "why_is_action_unavailabl
       required: ["actionId"],
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     validateArgs(args) {
       if (typeof args !== "object" || args === null || typeof args.actionId !== "string") {
         throw new Error("Expected { actionId: string }.");
@@ -97,7 +101,7 @@ function createListActionsTool(provider, name = "list_available_actions") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => ({ actions: provider.listActions?.() ?? [] })
   };
 }
@@ -112,7 +116,7 @@ function createAppInfoTool(getInfo, name = "get_app_info") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => getInfo()
   };
 }
@@ -125,13 +129,51 @@ function createVisibleToolsTool(name = "get_visible_agent_tools") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: (_args, context) => ({
       tools: context.registry.getVisibleToolSummaries()
     })
   };
 }
 
+// src/declarative-submit.ts
+var WEBMCP_DECLARATIVE_FOCUS_STYLES = `
+form:tool-form-active {
+  outline: light-dark(#0aadf2, #0aadf2) dashed 1px;
+  outline-offset: -1px;
+}
+
+:tool-submit-active {
+  outline: light-dark(#fecd10, #fecd10) dashed 1px;
+  outline-offset: -1px;
+}
+`;
+function isAgentInvokedSubmit(event) {
+  return Boolean(event.agentInvoked);
+}
+function respondWithAgentResult(event, result) {
+  const submit = event;
+  if (!submit.agentInvoked || typeof submit.respondWith !== "function") {
+    return false;
+  }
+  submit.preventDefault();
+  submit.respondWith(Promise.resolve(result));
+  return true;
+}
+function ensureDeclarativeFocusStyles() {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const id = "tooluminati-webmcp-declarative-focus";
+  if (document.getElementById(id)) {
+    return;
+  }
+  const style = document.createElement("style");
+  style.id = id;
+  style.textContent = WEBMCP_DECLARATIVE_FOCUS_STYLES;
+  document.head.appendChild(style);
+}
+
 // src/errors.ts
 function isDevEnvironment() {
   return typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
@@ -219,7 +261,11 @@ function createRecentClientErrorsTool(buffer, name = "get_recent_client_errors")
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true, untrustedContentHint: true },
+    annotations: {
+      readOnlyHint: true,
+      untrustedContentHint: true,
+      debugging: true
+    },
     execute: () => ({ errors: buffer.list() })
   };
 }
@@ -234,7 +280,7 @@ function createFeatureFlagsTool(getFlags, name = "get_feature_flags_summary") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => ({ flags: getFlags() })
   };
 }
@@ -261,7 +307,7 @@ function createHydrationHealthTool(getHealth, name = "get_hydration_health") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => getHealth()
   };
 }
@@ -293,7 +339,7 @@ function createMountedFormsSummaryTool(registry, name = "get_mounted_forms_summa
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => ({ forms: registry.list() })
   };
 }
@@ -562,7 +608,11 @@ function createTroubleshootingTimelineTool(buffer, name = "get_troubleshooting_t
       },
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true, untrustedContentHint: true },
+    annotations: {
+      readOnlyHint: true,
+      untrustedContentHint: true,
+      debugging: true
+    },
     validateArgs(args) {
       if (typeof args !== "object" || args === null) {
         return {};
@@ -599,29 +649,44 @@ function createTroubleshootingTimelineTool(buffer, name = "get_troubleshooting_t
 
 // src/webmcp-environment.ts
 var import_core = require("@tooluminati/core");
+var WEBMCP_CONSUMERS = [
+  "Chrome DevTools / Model Context Inspector",
+  "ChatGPT Site tools (imperative registerTool only)",
+  "Safari/Firefox: no native WebMCP"
+];
 function createWebMcpEnvironmentSummary(options = {}) {
   const globalObject = options.globalObject ?? globalThis;
   let usingNavigatorFallback = false;
   const documentContext = typeof globalObject.document !== "undefined" ? globalObject.document.modelContext : void 0;
-  (0, import_core.getModelContext)({
+  const modelContext = (0, import_core.getModelContext)({
     globalObject,
     onNavigatorFallback: () => {
       usingNavigatorFallback = true;
     }
   });
   const supported = (0, import_core.isWebMcpSupported)({ globalObject });
+  const registerToolAvailable = (0, import_core.isUsableModelContext)(modelContext);
   const origin = typeof globalObject.location !== "undefined" ? globalObject.location.origin : "unknown";
   const toolCount = options.registry?.getRegisteredToolNames().length ?? 0;
   const checks = [];
   const warnings = [];
-  const documentContextStatus = documentContext ? "ok" : supported ? "warn" : "fail";
+  const documentContextStatus = (0, import_core.isUsableModelContext)(documentContext) ? "ok" : supported ? "warn" : "fail";
   checks.push({
     id: "document.modelContext",
     label: "document.modelContext",
-    value: documentContext ? "available" : supported ? "missing; using fallback" : "missing",
+    value: (0, import_core.isUsableModelContext)(documentContext) ? "available" : supported ? "missing; using fallback" : "missing",
     status: documentContextStatus,
-    ...documentContext ? {} : {
-      hint: supported ? "No document.modelContext on this page, but WebMCP is available through navigator.modelContext in this Chrome build." : "No document.modelContext on this page. Enable WebMCP in Chrome or attach the Model Context Inspector Extension."
+    ...documentContextStatus === "ok" ? {} : {
+      hint: supported ? "No document.modelContext.registerTool on this page, but WebMCP is available through navigator.modelContext in this Chrome build." : "No document.modelContext.registerTool on this page. Enable WebMCP in Chrome or attach the Model Context Inspector Extension."
+    }
+  });
+  checks.push({
+    id: "registerTool",
+    label: "registerTool",
+    value: registerToolAvailable ? "available" : "missing",
+    status: registerToolAvailable ? "ok" : "fail",
+    ...registerToolAvailable ? {} : {
+      hint: 'Feature-detect typeof modelContext.registerTool === "function" before registering tools.'
     }
   });
   checks.push({
@@ -633,6 +698,13 @@ function createWebMcpEnvironmentSummary(options = {}) {
       hint: "Deprecated navigator.modelContext path detected. Migrate to document.modelContext."
     } : {}
   });
+  checks.push({
+    id: "origin-trial",
+    label: "Origin trial / flag",
+    value: "required until the API ships",
+    status: "muted",
+    hint: "Chrome 149\u2013156 need #enable-webmcp-testing or an Origin-Trial token. Chrome 157 is a target, not a ship contract."
+  });
   const originIsolation = detectOriginIsolationIssue(globalObject);
   checks.push({
     id: "origin-isolation",
@@ -655,6 +727,13 @@ function createWebMcpEnvironmentSummary(options = {}) {
   if (permissionsPolicy.warning) {
     warnings.push(permissionsPolicy.warning);
   }
+  checks.push({
+    id: "consumers",
+    label: "Known agent consumers",
+    value: WEBMCP_CONSUMERS.join("; "),
+    status: "muted",
+    hint: "Treat tools as progressive enhancement. Declarative forms are Chrome-only today; ChatGPT Site tools see registerTool only."
+  });
   if (toolCount === 0 && supported) {
     warnings.push("No tools registered yet.");
     checks.push({
@@ -673,6 +752,8 @@ function createWebMcpEnvironmentSummary(options = {}) {
     toolCount,
     origin,
     usingNavigatorFallback,
+    registerToolAvailable,
+    consumers: WEBMCP_CONSUMERS,
     checks,
     warnings
   };
@@ -734,7 +815,7 @@ function createWebMcpEnvironmentTool(getSummary, name = "get_webmcp_environment"
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => getSummary()
   };
 }
@@ -749,7 +830,11 @@ function createWorkflowBlockersTool(sources, name = "get_workflow_blockers") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true, untrustedContentHint: true },
+    annotations: {
+      readOnlyHint: true,
+      untrustedContentHint: true,
+      debugging: true
+    },
     execute: () => {
       const actions = sources.actionProvider?.listActions?.().map((action) => ({
         actionId: action.actionId,
@@ -1165,6 +1250,7 @@ function filterPanelEvents(events, filter) {
   ClientErrorBuffer,
   TROUBLESHOOTING_GUIDANCE,
   TroubleshootingTimelineBuffer,
+  WEBMCP_DECLARATIVE_FOCUS_STYLES,
   buildTroubleshootingPanelSnapshot,
   computeTroubleshootingPanelState,
   createActionAvailabilityTool,
@@ -1188,13 +1274,16 @@ function filterPanelEvents(events, filter) {
   createWebMcpLifecycleCollector,
   createWorkflowBlockersTool,
   discoverDeclarativeForms,
+  ensureDeclarativeFocusStyles,
   filterPanelEvents,
   formSummaryFromMounted,
   getGuidanceForClientError,
   getGuidanceForEnvironmentCheck,
   getGuidanceForTimelineEvent,
+  isAgentInvokedSubmit,
   isPanelEnabledByDefault,
   isPanelUrlOverrideEnabled,
+  respondWithAgentResult,
   serializeTroubleshootingDiagnostics,
   timelineEventGroup
 });

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './action-availability';
 export * from './app-info';
+export * from './declarative-submit';
 export * from './errors';
 export * from './feature-flags';
 export * from './hydration';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -14,7 +14,7 @@ function createActionAvailabilityTool(provider, name = "why_is_action_unavailabl
       required: ["actionId"],
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     validateArgs(args) {
       if (typeof args !== "object" || args === null || typeof args.actionId !== "string") {
         throw new Error("Expected { actionId: string }.");
@@ -37,7 +37,7 @@ function createListActionsTool(provider, name = "list_available_actions") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => ({ actions: provider.listActions?.() ?? [] })
   };
 }
@@ -52,7 +52,7 @@ function createAppInfoTool(getInfo, name = "get_app_info") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => getInfo()
   };
 }
@@ -65,13 +65,51 @@ function createVisibleToolsTool(name = "get_visible_agent_tools") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: (_args, context) => ({
       tools: context.registry.getVisibleToolSummaries()
     })
   };
 }
 
+// src/declarative-submit.ts
+var WEBMCP_DECLARATIVE_FOCUS_STYLES = `
+form:tool-form-active {
+  outline: light-dark(#0aadf2, #0aadf2) dashed 1px;
+  outline-offset: -1px;
+}
+
+:tool-submit-active {
+  outline: light-dark(#fecd10, #fecd10) dashed 1px;
+  outline-offset: -1px;
+}
+`;
+function isAgentInvokedSubmit(event) {
+  return Boolean(event.agentInvoked);
+}
+function respondWithAgentResult(event, result) {
+  const submit = event;
+  if (!submit.agentInvoked || typeof submit.respondWith !== "function") {
+    return false;
+  }
+  submit.preventDefault();
+  submit.respondWith(Promise.resolve(result));
+  return true;
+}
+function ensureDeclarativeFocusStyles() {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const id = "tooluminati-webmcp-declarative-focus";
+  if (document.getElementById(id)) {
+    return;
+  }
+  const style = document.createElement("style");
+  style.id = id;
+  style.textContent = WEBMCP_DECLARATIVE_FOCUS_STYLES;
+  document.head.appendChild(style);
+}
+
 // src/errors.ts
 function isDevEnvironment() {
   return typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
@@ -159,7 +197,11 @@ function createRecentClientErrorsTool(buffer, name = "get_recent_client_errors")
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true, untrustedContentHint: true },
+    annotations: {
+      readOnlyHint: true,
+      untrustedContentHint: true,
+      debugging: true
+    },
     execute: () => ({ errors: buffer.list() })
   };
 }
@@ -174,7 +216,7 @@ function createFeatureFlagsTool(getFlags, name = "get_feature_flags_summary") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => ({ flags: getFlags() })
   };
 }
@@ -201,7 +243,7 @@ function createHydrationHealthTool(getHealth, name = "get_hydration_health") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => getHealth()
   };
 }
@@ -233,7 +275,7 @@ function createMountedFormsSummaryTool(registry, name = "get_mounted_forms_summa
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => ({ forms: registry.list() })
   };
 }
@@ -502,7 +544,11 @@ function createTroubleshootingTimelineTool(buffer, name = "get_troubleshooting_t
       },
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true, untrustedContentHint: true },
+    annotations: {
+      readOnlyHint: true,
+      untrustedContentHint: true,
+      debugging: true
+    },
     validateArgs(args) {
       if (typeof args !== "object" || args === null) {
         return {};
@@ -540,31 +586,47 @@ function createTroubleshootingTimelineTool(buffer, name = "get_troubleshooting_t
 // src/webmcp-environment.ts
 import {
   getModelContext,
+  isUsableModelContext,
   isWebMcpSupported
 } from "@tooluminati/core";
+var WEBMCP_CONSUMERS = [
+  "Chrome DevTools / Model Context Inspector",
+  "ChatGPT Site tools (imperative registerTool only)",
+  "Safari/Firefox: no native WebMCP"
+];
 function createWebMcpEnvironmentSummary(options = {}) {
   const globalObject = options.globalObject ?? globalThis;
   let usingNavigatorFallback = false;
   const documentContext = typeof globalObject.document !== "undefined" ? globalObject.document.modelContext : void 0;
-  getModelContext({
+  const modelContext = getModelContext({
     globalObject,
     onNavigatorFallback: () => {
       usingNavigatorFallback = true;
     }
   });
   const supported = isWebMcpSupported({ globalObject });
+  const registerToolAvailable = isUsableModelContext(modelContext);
   const origin = typeof globalObject.location !== "undefined" ? globalObject.location.origin : "unknown";
   const toolCount = options.registry?.getRegisteredToolNames().length ?? 0;
   const checks = [];
   const warnings = [];
-  const documentContextStatus = documentContext ? "ok" : supported ? "warn" : "fail";
+  const documentContextStatus = isUsableModelContext(documentContext) ? "ok" : supported ? "warn" : "fail";
   checks.push({
     id: "document.modelContext",
     label: "document.modelContext",
-    value: documentContext ? "available" : supported ? "missing; using fallback" : "missing",
+    value: isUsableModelContext(documentContext) ? "available" : supported ? "missing; using fallback" : "missing",
     status: documentContextStatus,
-    ...documentContext ? {} : {
-      hint: supported ? "No document.modelContext on this page, but WebMCP is available through navigator.modelContext in this Chrome build." : "No document.modelContext on this page. Enable WebMCP in Chrome or attach the Model Context Inspector Extension."
+    ...documentContextStatus === "ok" ? {} : {
+      hint: supported ? "No document.modelContext.registerTool on this page, but WebMCP is available through navigator.modelContext in this Chrome build." : "No document.modelContext.registerTool on this page. Enable WebMCP in Chrome or attach the Model Context Inspector Extension."
+    }
+  });
+  checks.push({
+    id: "registerTool",
+    label: "registerTool",
+    value: registerToolAvailable ? "available" : "missing",
+    status: registerToolAvailable ? "ok" : "fail",
+    ...registerToolAvailable ? {} : {
+      hint: 'Feature-detect typeof modelContext.registerTool === "function" before registering tools.'
     }
   });
   checks.push({
@@ -576,6 +638,13 @@ function createWebMcpEnvironmentSummary(options = {}) {
       hint: "Deprecated navigator.modelContext path detected. Migrate to document.modelContext."
     } : {}
   });
+  checks.push({
+    id: "origin-trial",
+    label: "Origin trial / flag",
+    value: "required until the API ships",
+    status: "muted",
+    hint: "Chrome 149\u2013156 need #enable-webmcp-testing or an Origin-Trial token. Chrome 157 is a target, not a ship contract."
+  });
   const originIsolation = detectOriginIsolationIssue(globalObject);
   checks.push({
     id: "origin-isolation",
@@ -598,6 +667,13 @@ function createWebMcpEnvironmentSummary(options = {}) {
   if (permissionsPolicy.warning) {
     warnings.push(permissionsPolicy.warning);
   }
+  checks.push({
+    id: "consumers",
+    label: "Known agent consumers",
+    value: WEBMCP_CONSUMERS.join("; "),
+    status: "muted",
+    hint: "Treat tools as progressive enhancement. Declarative forms are Chrome-only today; ChatGPT Site tools see registerTool only."
+  });
   if (toolCount === 0 && supported) {
     warnings.push("No tools registered yet.");
     checks.push({
@@ -616,6 +692,8 @@ function createWebMcpEnvironmentSummary(options = {}) {
     toolCount,
     origin,
     usingNavigatorFallback,
+    registerToolAvailable,
+    consumers: WEBMCP_CONSUMERS,
     checks,
     warnings
   };
@@ -677,7 +755,7 @@ function createWebMcpEnvironmentTool(getSummary, name = "get_webmcp_environment"
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true },
+    annotations: { readOnlyHint: true, debugging: true },
     execute: () => getSummary()
   };
 }
@@ -692,7 +770,11 @@ function createWorkflowBlockersTool(sources, name = "get_workflow_blockers") {
       properties: {},
       additionalProperties: false
     },
-    annotations: { readOnlyHint: true, untrustedContentHint: true },
+    annotations: {
+      readOnlyHint: true,
+      untrustedContentHint: true,
+      debugging: true
+    },
     execute: () => {
       const actions = sources.actionProvider?.listActions?.().map((action) => ({
         actionId: action.actionId,
@@ -1107,6 +1189,7 @@ export {
   ClientErrorBuffer,
   TROUBLESHOOTING_GUIDANCE,
   TroubleshootingTimelineBuffer,
+  WEBMCP_DECLARATIVE_FOCUS_STYLES,
   buildTroubleshootingPanelSnapshot,
   computeTroubleshootingPanelState,
   createActionAvailabilityTool,
@@ -1130,13 +1213,16 @@ export {
   createWebMcpLifecycleCollector,
   createWorkflowBlockersTool,
   discoverDeclarativeForms,
+  ensureDeclarativeFocusStyles,
   filterPanelEvents,
   formSummaryFromMounted,
   getGuidanceForClientError,
   getGuidanceForEnvironmentCheck,
   getGuidanceForTimelineEvent,
+  isAgentInvokedSubmit,
   isPanelEnabledByDefault,
   isPanelUrlOverrideEnabled,
+  respondWithAgentResult,
   serializeTroubleshootingDiagnostics,
   timelineEventGroup
 };

package/dist/mounted-forms.js

@@ -26,7 +26,7 @@ export function createMountedFormsSummaryTool(registry, name = 'get_mounted_form
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: () => ({ forms: registry.list() }),
     };
 }

package/dist/timeline.d.ts.map

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

package/dist/timeline.js

@@ -266,7 +266,11 @@ export function createTroubleshootingTimelineTool(buffer, name = 'get_troublesho
             },
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true, untrustedContentHint: true },
+        annotations: {
+            readOnlyHint: true,
+            untrustedContentHint: true,
+            debugging: true,
+        },
         validateArgs(args) {
             if (typeof args !== 'object' || args === null) {
                 return {};

package/dist/troubleshooting-panel.test.js

@@ -5,7 +5,7 @@ import { TroubleshootingTimelineBuffer } from './timeline';
 import { createWebMcpEnvironmentSummary } from './webmcp-environment';
 const globalObject = {
     window: {},
-    document: { modelContext: {} },
+    document: { modelContext: { registerTool: () => undefined } },
     location: { origin: 'https://app.test' },
 };
 describe('troubleshooting panel snapshot', () => {
@@ -23,7 +23,10 @@ describe('troubleshooting panel snapshot', () => {
             environment: () => createWebMcpEnvironmentSummary({
                 globalObject: {
                     window: {},
-                    document: { modelContext: {}, domain: 'x.com' },
+                    document: {
+                        modelContext: { registerTool: () => undefined },
+                        domain: 'x.com',
+                    },
                     location: { origin: 'https://app.test' },
                 },
             }),

package/dist/webmcp-environment.d.ts

@@ -11,6 +11,8 @@ export interface WebMcpEnvironmentSummary {
     toolCount: number;
     origin: string;
     usingNavigatorFallback: boolean;
+    registerToolAvailable: boolean;
+    consumers: string[];
     checks: WebMcpEnvironmentCheck[];
     warnings: string[];
 }

package/dist/webmcp-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webmcp-environment.d.ts","sourceRoot":"","sources":["../src/webmcp-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,OAAO,CAAC;IAChC,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;CAClC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CAgH1B;AA8ED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,wBAAwB,EAC1C,IAAI,SAA2B,GAC9B,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAavE"}
+{"version":3,"file":"webmcp-environment.d.ts","sourceRoot":"","sources":["../src/webmcp-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;CAClC;AAQD,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CAsJ1B;AA8ED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,wBAAwB,EAC1C,IAAI,SAA2B,GAC9B,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAavE"}

package/dist/webmcp-environment.js

@@ -1,4 +1,9 @@
-import { getModelContext, isWebMcpSupported, } from '@tooluminati/core';
+import { getModelContext, isUsableModelContext, isWebMcpSupported, } from '@tooluminati/core';
+const WEBMCP_CONSUMERS = [
+    'Chrome DevTools / Model Context Inspector',
+    'ChatGPT Site tools (imperative registerTool only)',
+    'Safari/Firefox: no native WebMCP',
+];
 export function createWebMcpEnvironmentSummary(options = {}) {
     const globalObject = options.globalObject ?? globalThis;
     let usingNavigatorFallback = false;
@@ -6,29 +11,56 @@ export function createWebMcpEnvironmentSummary(options = {}) {
         ? globalObject.document
             .modelContext
         : undefined;
-    getModelContext({
+    const modelContext = getModelContext({
         globalObject,
         onNavigatorFallback: () => {
             usingNavigatorFallback = true;
         },
     });
     const supported = isWebMcpSupported({ globalObject });
+    const registerToolAvailable = isUsableModelContext(modelContext);
     const origin = typeof globalObject.location !== 'undefined'
         ? globalObject.location.origin
         : 'unknown';
     const toolCount = options.registry?.getRegisteredToolNames().length ?? 0;
     const checks = [];
     const warnings = [];
+    const documentContextStatus = isUsableModelContext(documentContext)
+        ? 'ok'
+        : supported
+            ? 'warn'
+            : 'fail';
     checks.push({
         id: 'document.modelContext',
         label: 'document.modelContext',
-        value: documentContext ? 'available' : 'missing',
-        status: documentContext ? 'ok' : 'fail',
-        ...(documentContext
+        value: isUsableModelContext(documentContext)
+            ? 'available'
+            : supported
+                ? 'missing; using fallback'
+                : 'missing',
+        status: documentContextStatus,
+        ...(documentContextStatus === 'ok'
             ? {}
             : {
-                hint: 'No document.modelContext on this page. Enable WebMCP in Chrome ' +
-                    'or attach the Model Context Inspector Extension.',
+                hint: supported
+                    ? 'No document.modelContext.registerTool on this page, ' +
+                        'but WebMCP is available through navigator.modelContext ' +
+                        'in this Chrome build.'
+                    : 'No document.modelContext.registerTool on this page. ' +
+                        'Enable WebMCP in Chrome or attach the Model Context ' +
+                        'Inspector Extension.',
+            }),
+    });
+    checks.push({
+        id: 'registerTool',
+        label: 'registerTool',
+        value: registerToolAvailable ? 'available' : 'missing',
+        status: registerToolAvailable ? 'ok' : 'fail',
+        ...(registerToolAvailable
+            ? {}
+            : {
+                hint: 'Feature-detect typeof modelContext.registerTool === ' +
+                    '"function" before registering tools.',
             }),
     });
     checks.push({
@@ -38,11 +70,19 @@ export function createWebMcpEnvironmentSummary(options = {}) {
         status: usingNavigatorFallback ? 'warn' : 'ok',
         ...(usingNavigatorFallback
             ? {
-                hint: 'Deprecated navigator.modelContext path detected. Migrate to ' +
-                    'document.modelContext.',
+                hint: 'Deprecated navigator.modelContext path detected. Migrate ' +
+                    'to document.modelContext.',
             }
             : {}),
     });
+    checks.push({
+        id: 'origin-trial',
+        label: 'Origin trial / flag',
+        value: 'required until the API ships',
+        status: 'muted',
+        hint: 'Chrome 149–156 need #enable-webmcp-testing or an Origin-Trial ' +
+            'token. Chrome 157 is a target, not a ship contract.',
+    });
     const originIsolation = detectOriginIsolationIssue(globalObject);
     checks.push({
         id: 'origin-isolation',
@@ -65,6 +105,14 @@ export function createWebMcpEnvironmentSummary(options = {}) {
     if (permissionsPolicy.warning) {
         warnings.push(permissionsPolicy.warning);
     }
+    checks.push({
+        id: 'consumers',
+        label: 'Known agent consumers',
+        value: WEBMCP_CONSUMERS.join('; '),
+        status: 'muted',
+        hint: 'Treat tools as progressive enhancement. Declarative forms are ' +
+            'Chrome-only today; ChatGPT Site tools see registerTool only.',
+    });
     if (toolCount === 0 && supported) {
         warnings.push('No tools registered yet.');
         checks.push({
@@ -84,6 +132,8 @@ export function createWebMcpEnvironmentSummary(options = {}) {
         toolCount,
         origin,
         usingNavigatorFallback,
+        registerToolAvailable,
+        consumers: WEBMCP_CONSUMERS,
         checks,
         warnings,
     };
@@ -150,7 +200,7 @@ export function createWebMcpEnvironmentTool(getSummary, name = 'get_webmcp_envir
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, debugging: true },
         execute: () => getSummary(),
     };
 }

package/dist/webmcp-environment.test.js

@@ -21,12 +21,32 @@ describe('createWebMcpEnvironmentSummary', () => {
             registry,
             globalObject: {
                 window: {},
-                document: { modelContext: {} },
+                document: { modelContext: { registerTool: () => undefined } },
                 location: { origin: 'https://app.test' },
             },
         });
         expect(summary.toolCount).toBe(1);
         expect(summary.supported).toBe(true);
+        expect(summary.registerToolAvailable).toBe(true);
+        expect(summary.consumers.length).toBeGreaterThan(0);
+        expect(summary.checks.some((check) => check.id === 'origin-trial')).toBe(true);
+    });
+    it('supports Chrome 149 navigator.modelContext fallback', () => {
+        const summary = createWebMcpEnvironmentSummary({
+            globalObject: {
+                window: {},
+                document: {},
+                navigator: { modelContext: { registerTool: () => undefined } },
+                location: { origin: 'https://app.test' },
+            },
+        });
+        const documentCheck = summary.checks.find((check) => check.id === 'document.modelContext');
+        const navigatorCheck = summary.checks.find((check) => check.id === 'navigator.modelContext');
+        expect(summary.supported).toBe(true);
+        expect(summary.usingNavigatorFallback).toBe(true);
+        expect(documentCheck?.status).toBe('warn');
+        expect(documentCheck?.value).toBe('missing; using fallback');
+        expect(navigatorCheck?.status).toBe('warn');
     });
     it('warns when document.domain is set', () => {
         const summary = createWebMcpEnvironmentSummary({
@@ -47,3 +67,23 @@ describe('createWebMcpEnvironmentTool', () => {
         expect(result).toHaveProperty('checks');
     });
 });
+it.each([undefined, {}, { registerTool: true }])('reports unsupported malformed context %s', (modelContext) => {
+    const summary = createWebMcpEnvironmentSummary({
+        globalObject: {
+            window: {},
+            document: { modelContext },
+        },
+    });
+    expect(summary.supported).toBe(false);
+    expect(summary.registerToolAvailable).toBe(false);
+    expect(summary.usingNavigatorFallback).toBe(false);
+    expect(summary.checks).toContainEqual(expect.objectContaining({ id: 'registerTool', status: 'fail' }));
+});
+it('reports SSR as unsupported without accessing the DOM', () => {
+    const summary = createWebMcpEnvironmentSummary({
+        globalObject: {},
+    });
+    expect(summary.supported).toBe(false);
+    expect(summary.origin).toBe('unknown');
+    expect(summary.checks).toContainEqual(expect.objectContaining({ id: 'origin-trial', status: 'muted' }));
+});

package/dist/workflow-blockers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-blockers.d.ts","sourceRoot":"","sources":["../src/workflow-blockers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,qBAAqB,EAAE,CAAC;IAC9C,wBAAwB,CAAC,EAAE,MAAM,sBAAsB,EAAE,CAAC;IAC1D,cAAc,CAAC,EAAE,MAAM,YAAY,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,kBAAkB,EAAE,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/D,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;IAC3C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,EAChC,IAAI,SAA0B,GAC7B,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAwCrE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,kBAAkB,GACvB,qBAAqB,CAWvB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,UAAyE,GAC9E,sBAAsB,EAAE,CAgB1B"}
+{"version":3,"file":"workflow-blockers.d.ts","sourceRoot":"","sources":["../src/workflow-blockers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,qBAAqB,EAAE,CAAC;IAC9C,wBAAwB,CAAC,EAAE,MAAM,sBAAsB,EAAE,CAAC;IAC1D,cAAc,CAAC,EAAE,MAAM,YAAY,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,kBAAkB,EAAE,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/D,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;IAC3C,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,EAChC,IAAI,SAA0B,GAC7B,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,CAAC,CA4CrE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,kBAAkB,GACvB,qBAAqB,CAWvB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,UAAyE,GAC9E,sBAAsB,EAAE,CAgB1B"}

package/dist/workflow-blockers.js

@@ -7,7 +7,11 @@ export function createWorkflowBlockersTool(sources, name = 'get_workflow_blocker
             properties: {},
             additionalProperties: false,
         },
-        annotations: { readOnlyHint: true, untrustedContentHint: true },
+        annotations: {
+            readOnlyHint: true,
+            untrustedContentHint: true,
+            debugging: true,
+        },
         execute: () => {
             const actions = sources.actionProvider?.listActions?.().map((action) => ({
                 actionId: action.actionId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tooluminati/diagnostics",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Runtime diagnostic tool factories for Tooluminati.",
   "type": "module",
   "sideEffects": false,
@@ -15,7 +15,7 @@
     }
   },
   "dependencies": {
-    "@tooluminati/core": "0.1.1"
+    "@tooluminati/core": "0.2.0"
   },
   "files": [
     "dist"