@tooluminati/diagnostics 0.1.0

package/dist/webmcp-environment.js

@@ -0,0 +1,156 @@
+import { getModelContext, isWebMcpSupported, } from '@tooluminati/core';
+export function createWebMcpEnvironmentSummary(options = {}) {
+    const globalObject = options.globalObject ?? globalThis;
+    let usingNavigatorFallback = false;
+    const documentContext = typeof globalObject.document !== 'undefined'
+        ? globalObject.document
+            .modelContext
+        : undefined;
+    getModelContext({
+        globalObject,
+        onNavigatorFallback: () => {
+            usingNavigatorFallback = true;
+        },
+    });
+    const supported = isWebMcpSupported({ globalObject });
+    const origin = typeof globalObject.location !== 'undefined'
+        ? globalObject.location.origin
+        : 'unknown';
+    const toolCount = options.registry?.getRegisteredToolNames().length ?? 0;
+    const checks = [];
+    const warnings = [];
+    checks.push({
+        id: 'document.modelContext',
+        label: 'document.modelContext',
+        value: documentContext ? 'available' : 'missing',
+        status: documentContext ? 'ok' : 'fail',
+        ...(documentContext
+            ? {}
+            : {
+                hint: 'No document.modelContext on this page. Enable WebMCP in Chrome ' +
+                    'or attach the Model Context Inspector Extension.',
+            }),
+    });
+    checks.push({
+        id: 'navigator.modelContext',
+        label: 'navigator.modelContext fallback',
+        value: usingNavigatorFallback ? 'in use' : 'not used',
+        status: usingNavigatorFallback ? 'warn' : 'ok',
+        ...(usingNavigatorFallback
+            ? {
+                hint: 'Deprecated navigator.modelContext path detected. Migrate to ' +
+                    'document.modelContext.',
+            }
+            : {}),
+    });
+    const originIsolation = detectOriginIsolationIssue(globalObject);
+    checks.push({
+        id: 'origin-isolation',
+        label: 'Origin isolation',
+        value: originIsolation.value,
+        status: originIsolation.status,
+        ...(originIsolation.hint ? { hint: originIsolation.hint } : {}),
+    });
+    if (originIsolation.warning) {
+        warnings.push(originIsolation.warning);
+    }
+    const permissionsPolicy = detectPermissionsPolicy(globalObject);
+    checks.push({
+        id: 'permissions-policy',
+        label: 'tools Permissions-Policy',
+        value: permissionsPolicy.value,
+        status: permissionsPolicy.status,
+        ...(permissionsPolicy.hint ? { hint: permissionsPolicy.hint } : {}),
+    });
+    if (permissionsPolicy.warning) {
+        warnings.push(permissionsPolicy.warning);
+    }
+    if (toolCount === 0 && supported) {
+        warnings.push('No tools registered yet.');
+        checks.push({
+            id: 'tool-count',
+            label: 'Registered tools',
+            value: '0',
+            status: 'warn',
+            hint: 'WebMCP is supported but no tools are registered. Verify the ' +
+                'Tooluminati provider is mounted.',
+        });
+    }
+    if (!supported) {
+        warnings.push('WebMCP is unsupported in this browser context.');
+    }
+    return {
+        supported,
+        toolCount,
+        origin,
+        usingNavigatorFallback,
+        checks,
+        warnings,
+    };
+}
+function detectOriginIsolationIssue(globalObject) {
+    if (typeof globalObject.document === 'undefined') {
+        return { value: 'n/a', status: 'muted' };
+    }
+    const doc = globalObject.document;
+    if (doc.domain && doc.domain.length > 0) {
+        const hint = 'document.domain is set. Origin-Agent-Cluster may be ?0. Remove ' +
+            'document.domain writes or set Origin-Agent-Cluster: ?1.';
+        return {
+            value: 'review',
+            status: 'warn',
+            hint,
+            warning: hint,
+        };
+    }
+    return { value: 'ok', status: 'ok' };
+}
+function detectPermissionsPolicy(globalObject) {
+    if (typeof globalObject.document === 'undefined') {
+        return { value: 'n/a', status: 'muted' };
+    }
+    const doc = globalObject.document;
+    if (doc.permissionsPolicy?.allowsFeature) {
+        const allowed = doc.permissionsPolicy.allowsFeature('tools');
+        if (!allowed) {
+            const hint = 'tools is blocked by Permissions-Policy. Allow tools for this ' +
+                'origin or review iframe allow attributes.';
+            return {
+                value: 'blocked',
+                status: 'fail',
+                hint,
+                warning: hint,
+            };
+        }
+    }
+    if (typeof globalObject.document.querySelector !== 'function') {
+        return { value: 'self', status: 'ok' };
+    }
+    const iframe = globalObject.document.querySelector('iframe');
+    if (iframe &&
+        iframe.src &&
+        !iframe.src.startsWith(globalObject.location.origin)) {
+        const hint = 'Cross-origin iframe detected. Verify Permissions-Policy allows ' +
+            'tools for embedded origins.';
+        return {
+            value: 'review cross-origin iframe',
+            status: 'warn',
+            hint,
+            warning: hint,
+        };
+    }
+    return { value: 'self', status: 'ok' };
+}
+export function createWebMcpEnvironmentTool(getSummary, name = 'get_webmcp_environment') {
+    return {
+        name,
+        description: 'Reports WebMCP browser support, registered tool count, and setup warnings.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true },
+        execute: () => getSummary(),
+    };
+}

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

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

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

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

package/dist/webmcp-environment.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import { createWebMcpEnvironmentSummary, createWebMcpEnvironmentTool, } from './webmcp-environment';
+describe('createWebMcpEnvironmentSummary', () => {
+    it('reports unsupported when modelContext is missing', () => {
+        const summary = createWebMcpEnvironmentSummary({
+            globalObject: {
+                window: {},
+                document: {},
+                location: { origin: 'https://app.test' },
+            },
+        });
+        expect(summary.supported).toBe(false);
+        expect(summary.checks[0]?.status).toBe('fail');
+        expect(summary.warnings.length).toBeGreaterThan(0);
+    });
+    it('includes registered tool count from registry', () => {
+        const registry = {
+            getRegisteredToolNames: () => ['demo_tool'],
+        };
+        const summary = createWebMcpEnvironmentSummary({
+            registry,
+            globalObject: {
+                window: {},
+                document: { modelContext: {} },
+                location: { origin: 'https://app.test' },
+            },
+        });
+        expect(summary.toolCount).toBe(1);
+        expect(summary.supported).toBe(true);
+    });
+    it('warns when document.domain is set', () => {
+        const summary = createWebMcpEnvironmentSummary({
+            globalObject: {
+                window: {},
+                document: { modelContext: {}, domain: 'example.com' },
+                location: { origin: 'https://app.test' },
+            },
+        });
+        const originCheck = summary.checks.find((c) => c.id === 'origin-isolation');
+        expect(originCheck?.status).toBe('warn');
+    });
+});
+describe('createWebMcpEnvironmentTool', () => {
+    it('returns summary from getter', async () => {
+        const tool = createWebMcpEnvironmentTool(() => createWebMcpEnvironmentSummary());
+        const result = await tool.execute({}, {});
+        expect(result).toHaveProperty('checks');
+    });
+});

package/dist/workflow-blockers.d.ts

@@ -0,0 +1,53 @@
+import type { WebMcpToolDescriptor } from '@tooluminati/core';
+import type { ActionAvailabilityProvider } from './action-availability';
+import type { ClientErrorSummary } from './errors';
+import type { MountedFormSummary } from './mounted-forms';
+export interface FormDiagnosticSummary {
+    name: string;
+    valid: boolean;
+    submitting?: boolean | undefined;
+    blockers: string[];
+}
+export interface DeclarativeFormSummary {
+    toolName: string;
+    formId?: string | undefined;
+    autoSubmit?: boolean | undefined;
+}
+export interface QuerySummary {
+    queryKey: string;
+    status: string;
+    error?: string | undefined;
+    isFetching?: boolean | undefined;
+}
+export interface WorkflowBlockersSources {
+    actionProvider?: ActionAvailabilityProvider | undefined;
+    formSummaries?: () => FormDiagnosticSummary[];
+    declarativeFormSummaries?: () => DeclarativeFormSummary[];
+    querySummaries?: () => QuerySummary[];
+    recentErrors?: () => ClientErrorSummary[];
+    hydrationHealth?: () => {
+        healthy: boolean;
+        issues: string[];
+    };
+    featureFlags?: () => Record<string, boolean>;
+}
+export interface WorkflowBlockersResult {
+    actions: Array<{
+        actionId: string;
+        available: boolean;
+        reasons: string[];
+    }>;
+    forms: FormDiagnosticSummary[];
+    declarativeForms: DeclarativeFormSummary[];
+    queries: QuerySummary[];
+    errors: ClientErrorSummary[];
+    hydration?: {
+        healthy: boolean;
+        issues: string[];
+    };
+    featureFlags?: Record<string, boolean>;
+}
+export declare function createWorkflowBlockersTool(sources: WorkflowBlockersSources, name?: string): WebMcpToolDescriptor<Record<string, never>, WorkflowBlockersResult>;
+export declare function formSummaryFromMounted(form: MountedFormSummary): FormDiagnosticSummary;
+export declare function discoverDeclarativeForms(root?: ParentNode): DeclarativeFormSummary[];
+//# sourceMappingURL=workflow-blockers.d.ts.map

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

@@ -0,0 +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"}

package/dist/workflow-blockers.js

@@ -0,0 +1,62 @@
+export function createWorkflowBlockersTool(sources, name = 'get_workflow_blockers') {
+    return {
+        name,
+        description: 'Aggregates action, form, query, and error blockers for the current workflow.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        annotations: { readOnlyHint: true, untrustedContentHint: true },
+        execute: () => {
+            const actions = sources.actionProvider?.listActions?.().map((action) => ({
+                actionId: action.actionId,
+                available: action.available,
+                reasons: action.available ? [] : action.reasons,
+            })) ?? [];
+            const result = {
+                actions,
+                forms: sources.formSummaries?.() ?? [],
+                declarativeForms: sources.declarativeFormSummaries?.() ?? [],
+                queries: sources.querySummaries?.() ?? [],
+                errors: sources.recentErrors?.() ?? [],
+            };
+            const hydration = sources.hydrationHealth?.();
+            if (hydration) {
+                result.hydration = hydration;
+            }
+            const flags = sources.featureFlags?.();
+            if (flags) {
+                result.featureFlags = flags;
+            }
+            return result;
+        },
+    };
+}
+export function formSummaryFromMounted(form) {
+    const blockers = form.errors.map((e) => `${e.path}: ${e.message}`);
+    if (form.submitting) {
+        blockers.push('Form is submitting.');
+    }
+    return {
+        name: form.name,
+        valid: blockers.length === 0,
+        submitting: form.submitting,
+        blockers,
+    };
+}
+export function discoverDeclarativeForms(root = typeof document !== 'undefined' ? document : null) {
+    if (!root) {
+        return [];
+    }
+    const summaries = new Map();
+    for (const form of root.querySelectorAll('form[toolname]')) {
+        const el = form;
+        summaries.set(el.getAttribute('toolname') ?? 'unknown', {
+            toolName: el.getAttribute('toolname') ?? 'unknown',
+            ...(el.id ? { formId: el.id } : {}),
+            autoSubmit: el.hasAttribute('toolautosubmit'),
+        });
+    }
+    return [...summaries.values()];
+}

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

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

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

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

package/dist/workflow-blockers.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest';
+import { createListActionsTool } from './action-availability';
+import { createWorkflowBlockersTool } from './workflow-blockers';
+describe('createWorkflowBlockersTool', () => {
+    it('aggregates action and error sources', async () => {
+        const provider = {
+            getActionAvailability: (id) => ({
+                actionId: id,
+                label: id,
+                available: false,
+                reasons: ['blocked'],
+            }),
+            listActions: () => [
+                {
+                    actionId: 'submit',
+                    label: 'Submit',
+                    available: false,
+                    reasons: ['invalid form'],
+                },
+            ],
+        };
+        const tool = createWorkflowBlockersTool({
+            actionProvider: provider,
+            recentErrors: () => [
+                {
+                    message: 'err',
+                    source: 'app',
+                    timestamp: new Date().toISOString(),
+                },
+            ],
+        });
+        const result = await tool.execute({}, {});
+        expect(result.actions[0]?.reasons).toContain('invalid form');
+        expect(result.errors).toHaveLength(1);
+    });
+});
+describe('createListActionsTool export', () => {
+    it('is re-exported from action-availability', () => {
+        expect(createListActionsTool).toBeDefined();
+    });
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tooluminati/diagnostics",
+  "version": "0.1.0",
+  "description": "Runtime diagnostic tool factories for Tooluminati.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@tooluminati/core": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jitterbox/Tooluminati.git",
+    "directory": "packages/diagnostics"
+  },
+  "bugs": {
+    "url": "https://github.com/jitterbox/Tooluminati/issues"
+  },
+  "homepage": "https://github.com/jitterbox/Tooluminati#readme",
+  "keywords": [
+    "tooluminati",
+    "webmcp",
+    "react",
+    "diagnostics",
+    "observability"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs && tsc -p tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}