@wonderwhy-er/desktop-commander 0.2.39 → 0.2.40

package/dist/ui/shared/host-lifecycle.js

@@ -1,41 +0,0 @@
-export function createUiHostLifecycle(rpcClient, options) {
-    const { appName, appVersion = '1.0.0', getRootElement, onHostContext } = options;
-    const resolveRootElement = () => getRootElement?.() ?? (document.getElementById('app')?.firstElementChild ?? document.getElementById('app'));
-    const notifySizeChanged = () => {
-        const node = resolveRootElement();
-        const height = Math.max(28, Math.ceil(node?.getBoundingClientRect().height ?? 0));
-        rpcClient.notify('ui/notifications/size-changed', { height });
-    };
-    return {
-        notifyRender: () => {
-            notifySizeChanged();
-            setTimeout(notifySizeChanged, 80);
-        },
-        observeResize: () => {
-            if (!window.ResizeObserver) {
-                return;
-            }
-            const observer = new ResizeObserver(() => notifySizeChanged());
-            observer.observe(document.documentElement);
-        },
-        initialize: () => {
-            void rpcClient.request('ui/initialize', {
-                appInfo: { name: appName, version: appVersion },
-                appCapabilities: {},
-                protocolVersion: '2026-01-26',
-            }).then((response) => {
-                if (onHostContext && response !== null && typeof response === 'object') {
-                    const hostContext = response.hostContext;
-                    if (hostContext !== null && typeof hostContext === 'object') {
-                        onHostContext(hostContext);
-                    }
-                }
-                rpcClient.notify('ui/notifications/initialized', {});
-            }).catch(() => {
-                // Initialization handshake failure should not break rendering.
-                // Still send initialized in case host is lenient.
-                rpcClient.notify('ui/notifications/initialized', {});
-            });
-        },
-    };
-}

package/dist/ui/shared/rpc-client.d.ts

@@ -1,14 +0,0 @@
-export interface RpcClient {
-    notify: (method: string, params: Record<string, unknown>) => void;
-    request: (method: string, params: Record<string, unknown>) => Promise<unknown>;
-    handleMessageEvent: (event: MessageEvent) => boolean;
-    dispose: () => void;
-}
-export interface RpcClientOptions {
-    targetWindow: Window;
-    targetOrigin?: string;
-    timeoutMs?: number;
-    isTrustedSource?: (source: MessageEvent['source'] | null) => boolean;
-}
-export declare function isTrustedParentMessageSource(source: MessageEvent['source'] | null, expectedSource: Window): boolean;
-export declare function createWindowRpcClient(options: RpcClientOptions): RpcClient;

package/dist/ui/shared/rpc-client.js

@@ -1,72 +0,0 @@
-function isObject(value) {
-    return typeof value === 'object' && value !== null;
-}
-export function isTrustedParentMessageSource(source, expectedSource) {
-    return source === expectedSource;
-}
-export function createWindowRpcClient(options) {
-    const { targetWindow, targetOrigin = '*', timeoutMs = 15000, isTrustedSource = () => true, } = options;
-    let requestId = 1;
-    const pendingRequests = new Map();
-    const postMessage = (payload) => {
-        targetWindow.postMessage(payload, targetOrigin);
-    };
-    const notify = (method, params) => {
-        postMessage({
-            jsonrpc: '2.0',
-            method,
-            params,
-        });
-    };
-    const request = (method, params) => {
-        const id = requestId++;
-        postMessage({
-            jsonrpc: '2.0',
-            id,
-            method,
-            params,
-        });
-        return new Promise((resolve, reject) => {
-            const timer = setTimeout(() => {
-                pendingRequests.delete(id);
-                reject(new Error(`Request timed out for method ${method}`));
-            }, timeoutMs);
-            pendingRequests.set(id, { resolve, reject, timer });
-        });
-    };
-    const handleMessageEvent = (event) => {
-        if (!isTrustedSource(event.source)) {
-            return false;
-        }
-        if (!isObject(event.data) || typeof event.data.id !== 'number') {
-            return false;
-        }
-        const pending = pendingRequests.get(event.data.id);
-        if (!pending) {
-            return false;
-        }
-        clearTimeout(pending.timer);
-        pendingRequests.delete(event.data.id);
-        if (isObject(event.data.error)) {
-            const errorShape = event.data.error;
-            const message = typeof errorShape.message === 'string' ? errorShape.message : 'Unknown RPC error';
-            pending.reject(new Error(message));
-            return true;
-        }
-        pending.resolve(event.data.result);
-        return true;
-    };
-    const dispose = () => {
-        for (const [id, pending] of pendingRequests) {
-            clearTimeout(pending.timer);
-            pending.reject(new Error('RPC client disposed'));
-            pendingRequests.delete(id);
-        }
-    };
-    return {
-        notify,
-        request,
-        handleMessageEvent,
-        dispose,
-    };
-}

package/dist/ui/shared/theme-adaptation.d.ts

@@ -1,10 +0,0 @@
-/**
- * Theme synchronization utilities that adapt embedded UI styles to host light/dark context. It centralizes theme event handling and class/token updates.
- */
-type ThemeMode = 'light' | 'dark';
-export declare function resolveThemeMode(value: unknown): ThemeMode | undefined;
-export interface UiThemeAdapter {
-    applyFromData: (data: unknown) => boolean;
-}
-export declare function createUiThemeAdapter(root?: HTMLElement): UiThemeAdapter;
-export {};

package/dist/ui/shared/theme-adaptation.js

@@ -1,118 +0,0 @@
-function isObject(value) {
-    return typeof value === 'object' && value !== null;
-}
-function normalizeThemeMode(value) {
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === 'dark' || normalized === 'night') {
-        return 'dark';
-    }
-    if (normalized === 'light' || normalized === 'day') {
-        return 'light';
-    }
-    return undefined;
-}
-function pickThemeCandidate(value) {
-    if (!isObject(value)) {
-        return [];
-    }
-    const candidates = [
-        value.theme,
-        value.colorScheme,
-        value.appearance,
-        value.mode,
-    ];
-    if (isObject(value.context)) {
-        candidates.push(value.context, value.context.theme, value.context.colorScheme);
-    }
-    if (isObject(value.params)) {
-        candidates.push(value.params, value.params.theme, value.params.colorScheme, value.params.context);
-    }
-    return candidates;
-}
-export function resolveThemeMode(value) {
-    const direct = normalizeThemeMode(value);
-    if (direct) {
-        return direct;
-    }
-    if (!isObject(value)) {
-        return undefined;
-    }
-    for (const candidate of pickThemeCandidate(value)) {
-        const resolved = resolveThemeMode(candidate);
-        if (resolved) {
-            return resolved;
-        }
-    }
-    return undefined;
-}
-function isSafeCssVariableName(name) {
-    return /^--[a-zA-Z0-9_-]+$/.test(name);
-}
-function extractCssVariableMap(value) {
-    if (!isObject(value)) {
-        return {};
-    }
-    const params = isObject(value.params) ? value.params : undefined;
-    const paramsContext = params && isObject(params.context) ? params.context : undefined;
-    const rawMapCandidates = [
-        value.cssVariables,
-        value.variables,
-        value.tokens,
-        isObject(value.theme) ? value.theme.cssVariables : undefined,
-        isObject(value.theme) ? value.theme.variables : undefined,
-        isObject(value.theme) ? value.theme.tokens : undefined,
-        isObject(value.context) ? value.context.cssVariables : undefined,
-        isObject(value.context) ? value.context.variables : undefined,
-        isObject(value.context) ? value.context.tokens : undefined,
-        params ? params.cssVariables : undefined,
-        params ? params.variables : undefined,
-        params ? params.tokens : undefined,
-        paramsContext ? paramsContext.cssVariables : undefined,
-        paramsContext ? paramsContext.variables : undefined,
-        paramsContext ? paramsContext.tokens : undefined,
-    ];
-    for (const candidate of rawMapCandidates) {
-        if (!isObject(candidate)) {
-            continue;
-        }
-        const next = {};
-        for (const [rawKey, rawValue] of Object.entries(candidate)) {
-            if (typeof rawValue !== 'string') {
-                continue;
-            }
-            const key = rawKey.startsWith('--') ? rawKey : `--${rawKey}`;
-            if (!isSafeCssVariableName(key)) {
-                continue;
-            }
-            next[key] = rawValue.trim();
-        }
-        return next;
-    }
-    return {};
-}
-function applyCssVariables(root, variableMap) {
-    for (const [name, value] of Object.entries(variableMap)) {
-        root.style.setProperty(name, value);
-    }
-}
-export function createUiThemeAdapter(root = document.documentElement) {
-    const applyFromData = (data) => {
-        const mode = resolveThemeMode(data);
-        const variableMap = extractCssVariableMap(data);
-        const hasChanges = Boolean(mode) || Object.keys(variableMap).length > 0;
-        if (mode) {
-            root.dataset.theme = mode;
-            root.style.colorScheme = mode;
-        }
-        if (Object.keys(variableMap).length > 0) {
-            applyCssVariables(root, variableMap);
-        }
-        return hasChanges;
-    };
-    return {
-        applyFromData,
-    };
-}

package/dist/ui/shared/tool-header.d.ts

@@ -1,9 +0,0 @@
-export interface ToolHeaderConfig {
-    pillLabel: string;
-    pillClassName?: string;
-    title: string;
-    subtitle: string;
-    badges: string[];
-    actionsHtml: string;
-}
-export declare function renderToolHeader(config: ToolHeaderConfig): string;

package/dist/ui/shared/tool-header.js

@@ -1,25 +0,0 @@
-/**
- * Reusable header renderer for MCP tool UIs. It provides a consistent title/description/status pattern so each app presents uniform top-of-page context.
- */
-import { escapeHtml } from './escape-html.js';
-export function renderToolHeader(config) {
-    return `
-    <header class="toolbar">
-      <div class="meta">
-        <div class="meta-main">
-          <span class="file-pill ${escapeHtml(config.pillClassName ?? '')}">${escapeHtml(config.pillLabel)}</span>
-          <div class="meta-text">
-            <span class="filename" title="${escapeHtml(config.title)}">${escapeHtml(config.title)}</span>
-            <span class="filepath" title="${escapeHtml(config.subtitle)}">${escapeHtml(config.subtitle)}</span>
-          </div>
-        </div>
-        <div class="meta-badges">
-          ${config.badges.map((badge) => `<span class="badge">${escapeHtml(badge)}</span>`).join('')}
-        </div>
-      </div>
-      <div class="actions">
-        ${config.actionsHtml}
-      </div>
-    </header>
-  `;
-}

package/dist/utils/ui-call-context.d.ts

@@ -1,8 +0,0 @@
-export declare const UI_CALL_CONTEXT_META_KEY = "dcUiContext";
-export interface UiCallTelemetryFields {
-    call_origin: 'ui' | 'llm';
-    ui_component?: string;
-    ui_action?: string;
-    ui_invocation_id?: string;
-}
-export declare function extractUiCallTelemetryFields(metadata: unknown): UiCallTelemetryFields;

package/dist/utils/ui-call-context.js

@@ -1,72 +0,0 @@
-// Shared key used by UI widgets to attach call-origin metadata inside tools/call _meta.
-export const UI_CALL_CONTEXT_META_KEY = 'dcUiContext';
-function normalizeLabel(value, maxLength) {
-    // Keep telemetry labels compact and query-friendly (snake-like + bounded length).
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        return undefined;
-    }
-    const normalized = trimmed
-        .toLowerCase()
-        .replace(/[^a-z0-9_.:-]+/g, '_')
-        .replace(/^_+|_+$/g, '')
-        .slice(0, maxLength);
-    if (normalized.length === 0) {
-        return undefined;
-    }
-    return normalized;
-}
-function normalizeInvocationId(value, maxLength) {
-    // Invocation IDs are correlation-only; strip unusual characters and cap length.
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        return undefined;
-    }
-    const clipped = trimmed.slice(0, maxLength);
-    const sanitized = clipped.replace(/[^A-Za-z0-9_.:-]+/g, '');
-    if (sanitized.length === 0) {
-        return undefined;
-    }
-    return sanitized;
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
-export function extractUiCallTelemetryFields(metadata) {
-    // Default classification is LLM unless an explicit UI-origin envelope is present.
-    const base = { call_origin: 'llm' };
-    if (!isRecord(metadata)) {
-        return base;
-    }
-    const rawContext = metadata[UI_CALL_CONTEXT_META_KEY];
-    if (!isRecord(rawContext)) {
-        return base;
-    }
-    const rawOrigin = typeof rawContext.callOrigin === 'string'
-        ? rawContext.callOrigin.trim().toLowerCase()
-        : '';
-    if (rawOrigin !== 'ui') {
-        // We only elevate to UI when the caller explicitly declares callOrigin="ui".
-        return base;
-    }
-    const result = { call_origin: 'ui' };
-    const component = normalizeLabel(rawContext.uiComponent, 64);
-    if (component) {
-        result.ui_component = component;
-    }
-    const action = normalizeLabel(rawContext.uiAction, 64);
-    if (action) {
-        result.ui_action = action;
-    }
-    const invocationId = normalizeInvocationId(rawContext.uiInvocationId, 120);
-    if (invocationId) {
-        result.ui_invocation_id = invocationId;
-    }
-    return result;
-}