@geminilight/mindos 0.6.74 → 0.6.75

package/_standalone/lib/im/platforms.ts

@@ -0,0 +1,152 @@
+/** Shared IM platform definitions — used by sidebar nav, content page, and detail page. */
+
+export interface PlatformField {
+  key: string;
+  label: string;
+  placeholder: string;
+  hint?: string;
+}
+
+export interface PlatformDef {
+  id: string;
+  name: string;
+  icon: string;
+  fields: PlatformField[];
+  guide?: string;
+  guideUrl?: string;
+  editHint?: string;
+  purpose?: string;
+  purposeZh?: string;
+  useCases?: string[];
+  useCasesZh?: string[];
+  recipientExample?: string;
+  recipientExampleZh?: string;
+}
+
+export type PlatformStatus = {
+  platform: string;
+  connected: boolean;
+  botName?: string;
+  capabilities: string[];
+  webhook?: {
+    state: 'disabled' | 'pending' | 'ready' | 'error';
+    webhookUrl?: string;
+    publicBaseUrl?: string;
+    lastError?: string;
+  };
+};
+
+export const PLATFORMS: PlatformDef[] = [
+  {
+    id: 'telegram', name: 'Telegram', icon: '📱',
+    guide: '1. Open Telegram → search @BotFather\n2. Send /newbot → follow prompts\n3. Copy the token below',
+    purpose: 'Receive MindOS notifications and quick updates in Telegram.',
+    purposeZh: '通过 Telegram 接收 MindOS 的通知和快速更新。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'e.g. chat ID like 123456789 or -1001234567890',
+    recipientExampleZh: '例如 123456789 或 -1001234567890 这样的 chat ID',
+    fields: [
+      { key: 'bot_token', label: 'Bot Token', placeholder: '123456789:AABBccDD-EeFfGgHh...', hint: 'Format: number:alphanumeric' },
+    ],
+  },
+  {
+    id: 'feishu', name: 'Feishu', icon: '🐦',
+    guide: '1. open.feishu.cn → Create App\n2. Credentials page → copy App ID & Secret\n3. Enable Bot capability + add permissions',
+    guideUrl: 'https://open.feishu.cn/',
+    editHint: 'Need to update credentials? Edit and save below — MindOS will reconnect automatically.',
+    purpose: 'Receive MindOS results in Feishu, or let users message the bot directly when conversations are enabled.',
+    purposeZh: '通过飞书接收 MindOS 的结果；开启对话后，也可以让用户直接在飞书里给机器人发消息。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages', 'Direct bot conversations in Feishu'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息', '在飞书里直接与机器人对话'],
+    recipientExample: 'e.g. ou_xxx, oc_xxx, or a work email',
+    recipientExampleZh: '例如 ou_xxx、oc_xxx，或企业邮箱',
+    fields: [
+      { key: 'app_id', label: 'App ID', placeholder: 'CLI_XXXXXXXXXXXXXXXXX', hint: 'From Credentials page on open.feishu.cn' },
+      { key: 'app_secret', label: 'App Secret', placeholder: 'XXXXXXXXXXXXXXXXXXXXXXXX', hint: 'Keep this secret — do not share' },
+    ],
+  },
+  {
+    id: 'discord', name: 'Discord', icon: '💬',
+    guide: '1. discord.com/developers → New Application\n2. Bot tab → Reset Token → copy\n3. Enable Message Content Intent',
+    purpose: 'Send MindOS updates into Discord channels and DMs.',
+    purposeZh: '把 MindOS 的更新发送到 Discord 频道或私信。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'e.g. Discord channel or user ID',
+    recipientExampleZh: '例如 Discord 频道 ID 或用户 ID',
+    fields: [
+      { key: 'bot_token', label: 'Bot Token', placeholder: 'MTIxNzM...' },
+    ],
+  },
+  {
+    id: 'slack', name: 'Slack', icon: '💼',
+    guide: '1. api.slack.com/apps → Create New App\n2. OAuth & Permissions → add chat:write scope\n3. Install to Workspace → copy Bot Token',
+    purpose: 'Route MindOS notifications into Slack channels and direct messages.',
+    purposeZh: '把 MindOS 的通知发送到 Slack 频道或私信。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'e.g. Slack channel or user ID like C123... or U123...',
+    recipientExampleZh: '例如 Slack 频道 ID 或用户 ID（如 C123... / U123...）',
+    fields: [
+      { key: 'bot_token', label: 'Bot Token', placeholder: 'xoxb-xxxx-xxxx-xxxx', hint: 'Starts with xoxb-' },
+    ],
+  },
+  {
+    id: 'wecom', name: 'WeCom', icon: '🏢',
+    guide: '1. Group chat → Add Robot → Custom\n2. Copy Webhook URL\n3. Extract the key parameter from URL',
+    purpose: 'Deliver MindOS notifications into WeCom group chats.',
+    purposeZh: '把 MindOS 通知投递到企业微信群聊。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'Use your configured robot or WeCom target',
+    recipientExampleZh: '使用你配置好的机器人或企业微信目标',
+    fields: [
+      { key: 'webhook_key', label: 'Webhook Key', placeholder: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', hint: 'The key= value from webhook URL' },
+    ],
+  },
+  {
+    id: 'dingtalk', name: 'DingTalk', icon: '🔔',
+    guide: '1. Group → Settings → Smart Assistant → Add Robot\n2. Select Custom (Webhook)\n3. Copy the full Webhook URL',
+    purpose: 'Push MindOS notifications into DingTalk groups.',
+    purposeZh: '把 MindOS 通知发送到钉钉群。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'Use your configured DingTalk robot target',
+    recipientExampleZh: '使用你配置好的钉钉机器人目标',
+    fields: [
+      { key: 'webhook_url', label: 'Webhook URL', placeholder: 'https://oapi.dingtalk.com/robot/send?access_token=...', hint: 'Full URL including access_token' },
+    ],
+  },
+  {
+    id: 'wechat', name: 'WeChat', icon: '💚',
+    guide: '1. Visit ilinkai.weixin.qq.com\n2. Register & create a bot application\n3. QR login in the console → copy Bot Token from dashboard',
+    purpose: 'Send MindOS updates to WeChat via your configured bot.',
+    purposeZh: '通过你配置好的机器人把 MindOS 更新发送到微信。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'Use the WeChat user or chat ID supported by your bot',
+    recipientExampleZh: '使用你的机器人支持的微信用户或群聊 ID',
+    fields: [
+      { key: 'bot_token', label: 'Bot Token', placeholder: 'wx_xxxxxxxxxxxxxxxx', hint: 'From iLink Bot console after QR login' },
+    ],
+  },
+  {
+    id: 'qq', name: 'QQ', icon: '🐧',
+    guide: '1. q.qq.com → Create Bot\n2. Development tab → copy App ID & Secret\n3. Add group/C2C intents as needed',
+    purpose: 'Deliver MindOS notifications through QQ bot channels.',
+    purposeZh: '通过 QQ 机器人频道接收 MindOS 通知。',
+    useCases: ['Agent completion alerts', 'Error notifications', 'Test messages'],
+    useCasesZh: ['Agent 完成提醒', '错误通知', '测试消息'],
+    recipientExample: 'Use the QQ openid or group_openid for your target',
+    recipientExampleZh: '使用目标 QQ 的 openid 或 group_openid',
+    fields: [
+      { key: 'app_id', label: 'App ID', placeholder: '102xxxxxx' },
+      { key: 'app_secret', label: 'App Secret', placeholder: 'xxxxxxxxxxxxxxxxxxxxxxxx' },
+    ],
+  },
+];
+
+export function getPlatform(id: string): PlatformDef | undefined {
+  return PLATFORMS.find(p => p.id === id);
+}

package/_standalone/lib/image.ts

@@ -0,0 +1,47 @@
+/**
+ * Image path resolution utilities for Markdown.
+ *
+ * Converts markdown image paths (e.g., `![alt](/.media/image.png)`) to API URLs
+ * that can be served by `/api/file/raw?path=...`
+ */
+
+/**
+ * Checks if a path is an absolute path (starts with `/`).
+ */
+function isAbsolutePath(path: string): boolean {
+  return path.startsWith('/');
+}
+
+/**
+ * Checks if a path is a URL (starts with protocol like http://, https://, file://).
+ */
+function isUrl(path: string): boolean {
+  return /^(https?|file):\/\//.test(path);
+}
+
+/**
+ * Resolves an image path to a URL for the API endpoint.
+ *
+ * Rules:
+ * - Absolute paths (start with `/`) → `/api/file/raw?path=...` (strip leading slash)
+ * - URLs (http/https/file) → return as-is
+ * - Relative paths → return as-is (browser handles relative URLs)
+ *
+ * @param imagePath - The image path from markdown syntax
+ * @returns The resolved URL or path
+ */
+export function resolveImagePath(imagePath: string): string {
+  // Already a URL
+  if (isUrl(imagePath)) {
+    return imagePath;
+  }
+
+  // Absolute path like `/.media/image.png` or `/path/to/image.png`
+  if (isAbsolutePath(imagePath)) {
+    const cleanPath = imagePath.slice(1); // Remove leading `/`
+    return `/api/file/raw?path=${encodeURIComponent(cleanPath)}`;
+  }
+
+  // Relative path — return as-is for browser to resolve
+  return imagePath;
+}

package/_standalone/lib/inbox-upload.ts

@@ -0,0 +1,260 @@
+import { toast } from '@/lib/toast';
+import type { useLocale } from '@/lib/stores/locale-store';
+
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB per file
+
+function arrayBufferToBase64(buf: ArrayBuffer): string {
+  const bytes = new Uint8Array(buf);
+  const chunks: string[] = [];
+  for (let i = 0; i < bytes.length; i += 8192) {
+    chunks.push(String.fromCharCode(...bytes.subarray(i, i + 8192)));
+  }
+  return btoa(chunks.join(''));
+}
+
+function showQuickDropToast(
+  saved: number,
+  formatSkipped: number,
+  oversized: number,
+  t: ReturnType<typeof useLocale>['t'],
+) {
+  if (saved > 0 && oversized > 0 && formatSkipped === 0) {
+    toast.success(t.inbox.savedWithOversized(saved, oversized), 4000);
+  } else if (saved > 0 && (formatSkipped + oversized) > 0) {
+    toast.success(t.inbox.savedWithSkipped(saved, formatSkipped + oversized), 4000);
+  } else if (saved > 0) {
+    toast.success(t.inbox.savedToast(saved), 3000);
+  } else {
+    if (oversized > 0) toast.error(t.inbox.tooLarge(oversized), 4000);
+    if (formatSkipped > 0) toast.error(t.inbox.savedWithSkipped(0, formatSkipped), 4000);
+    if (oversized === 0 && formatSkipped === 0) toast.error(t.inbox.saveFailed, 4000);
+  }
+}
+
+export async function quickDropToInbox(
+  files: File[],
+  t: ReturnType<typeof useLocale>['t'],
+) {
+  const payload: Array<{ name: string; content: string; encoding?: string }> = [];
+  let oversizedCount = 0;
+
+  for (const file of files) {
+    if (file.size > MAX_FILE_SIZE) {
+      oversizedCount++;
+      continue;
+    }
+    try {
+      if (file.name.toLowerCase().endsWith('.pdf')) {
+        const buf = await file.arrayBuffer();
+        payload.push({ name: file.name, content: arrayBufferToBase64(buf), encoding: 'base64' });
+      } else {
+        const text = await file.text();
+        payload.push({ name: file.name, content: text });
+      }
+    } catch {
+      /* skip unreadable files */
+    }
+  }
+
+  if (payload.length === 0) {
+    if (oversizedCount > 0) {
+      toast.error(t.inbox.tooLarge(oversizedCount), 4000);
+    } else if (files.length > 0) {
+      toast.error(t.inbox.saveFailed, 4000);
+    }
+    return;
+  }
+
+  try {
+    const res = await fetch('/api/inbox', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ files: payload }),
+    });
+
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      console.error('[QuickDrop] Save failed:', data.error);
+      toast.error(t.inbox.saveFailed, 4000);
+      return;
+    }
+
+    const result = await res.json();
+    const saved = result.saved?.length ?? 0;
+    const formatSkipped = result.skipped?.length ?? 0;
+
+    showQuickDropToast(saved, formatSkipped, oversizedCount, t);
+    window.dispatchEvent(new Event('mindos:files-changed'));
+    window.dispatchEvent(new Event('mindos:inbox-updated'));
+  } catch (err) {
+    console.error('[QuickDrop] Network error:', err);
+    toast.error(t.inbox.saveFailed, 4000);
+  }
+}
+
+/**
+ * Clip a web page URL to the Inbox.
+ * Fetches the page server-side, converts HTML→Markdown via Readability + Turndown,
+ * and saves the result to the Inbox directory.
+ */
+export async function clipUrlToInbox(
+  url: string,
+  t: ReturnType<typeof useLocale>['t'],
+): Promise<{ ok: boolean; title?: string }> {
+  try {
+    const res = await fetch('/api/inbox/clip', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ url }),
+    });
+
+    const data = await res.json();
+
+    if (!res.ok) {
+      const msg = data.error || t.inbox.clipFailed;
+      toast.error(msg, 4000);
+      return { ok: false };
+    }
+
+    toast.success(t.inbox.clipSuccess(data.title || url), 3000);
+    window.dispatchEvent(new Event('mindos:files-changed'));
+    window.dispatchEvent(new Event('mindos:inbox-updated'));
+    return { ok: true, title: data.title };
+  } catch (err) {
+    console.error('[ClipURL] Network error:', err);
+    toast.error(t.inbox.clipFailed, 4000);
+    return { ok: false };
+  }
+}
+
+/**
+ * Detects if a string looks like a URL (http:// or https://).
+ */
+export function looksLikeUrl(text: string): boolean {
+  const trimmed = text.trim();
+  if (!trimmed.startsWith('http://') && !trimmed.startsWith('https://')) return false;
+  try {
+    new URL(trimmed);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Extracts a URL from a DragEvent's dataTransfer.
+ * Checks text/uri-list first, then text/plain.
+ * Returns null if no valid URL found (or if files are present).
+ */
+export function extractUrlFromDrop(e: DragEvent): string | null {
+  if (e.dataTransfer?.files && e.dataTransfer.files.length > 0) return null;
+
+  const uriList = e.dataTransfer?.getData('text/uri-list');
+  if (uriList) {
+    const firstUrl = uriList.split(/[\r\n]+/).find(
+      line => !line.startsWith('#') && line.trim().length > 0,
+    );
+    if (firstUrl && looksLikeUrl(firstUrl)) return firstUrl.trim();
+  }
+
+  const plainText = e.dataTransfer?.getData('text/plain');
+  if (plainText && looksLikeUrl(plainText)) return plainText.trim();
+
+  return null;
+}
+
+/**
+ * Checks whether a DragEvent likely contains a URL (not files).
+ * Used during dragenter/dragover to show the appropriate drop overlay.
+ */
+export function dragContainsUrl(e: DragEvent): boolean {
+  const types = e.dataTransfer?.types ?? [];
+  if (types.includes('Files')) return false;
+  return types.includes('text/uri-list') || types.includes('text/plain');
+}
+
+/**
+ * Drop files into a specific directory via /api/file/import.
+ * Used when user drags external files onto a directory in the file tree.
+ */
+export async function quickDropToDirectory(
+  files: File[],
+  targetDir: string,
+  t: ReturnType<typeof useLocale>['t'],
+) {
+  const payload: Array<{ name: string; content: string; encoding?: string }> = [];
+  let oversizedCount = 0;
+
+  const BINARY_EXTS = new Set([
+    'pdf', 'png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp', 'ico',
+    'mp3', 'wav', 'm4a', 'ogg', 'flac', 'aac', 'mp4', 'webm', 'mov', 'mkv',
+  ]);
+
+  for (const file of files) {
+    if (file.size > MAX_FILE_SIZE) {
+      oversizedCount++;
+      continue;
+    }
+    try {
+      const ext = (file.name.split('.').pop() ?? '').toLowerCase();
+      if (BINARY_EXTS.has(ext)) {
+        const buf = await file.arrayBuffer();
+        payload.push({ name: file.name, content: arrayBufferToBase64(buf), encoding: 'base64' });
+      } else {
+        const text = await file.text();
+        payload.push({ name: file.name, content: text });
+      }
+    } catch {
+      /* skip unreadable files */
+    }
+  }
+
+  if (payload.length === 0) {
+    if (oversizedCount > 0) {
+      toast.error(t.inbox.tooLarge(oversizedCount), 4000);
+    } else if (files.length > 0) {
+      toast.error(t.inbox.saveFailed, 4000);
+    }
+    return;
+  }
+
+  const dirName = targetDir.split('/').pop() || targetDir;
+
+  try {
+    const res = await fetch('/api/file/import', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        files: payload,
+        targetSpace: targetDir,
+        organize: false,
+        conflict: 'rename',
+      }),
+    });
+
+    if (!res.ok) {
+      const data = await res.json().catch(() => ({}));
+      console.error('[TreeDrop] Save failed:', data.error);
+      toast.error(t.inbox.saveFailed, 4000);
+      return;
+    }
+
+    const result = await res.json();
+    const saved = result.created?.length ?? 0;
+    const skipped = result.skipped?.length ?? 0;
+
+    if (saved > 0 && (skipped + oversizedCount) > 0) {
+      toast.success(t.inbox.savedWithSkipped(saved, skipped + oversizedCount), 4000);
+    } else if (saved > 0) {
+      toast.success(t.inbox.savedToDir(saved, dirName), 3000);
+    } else {
+      if (oversizedCount > 0) toast.error(t.inbox.tooLarge(oversizedCount), 4000);
+      if (skipped > 0) toast.error(t.inbox.savedWithSkipped(0, skipped), 4000);
+    }
+
+    window.dispatchEvent(new Event('mindos:files-changed'));
+  } catch (err) {
+    console.error('[TreeDrop] Network error:', err);
+    toast.error(t.inbox.saveFailed, 4000);
+  }
+}

package/_standalone/lib/mcp-snippets.ts

@@ -0,0 +1,107 @@
+/**
+ * Shared MCP config snippet generation utilities.
+ * Extracted from McpServerStatus.tsx for reuse in AgentsPanel.
+ */
+
+import type { AgentInfo, McpStatus } from '@/components/settings/types';
+
+export interface ConfigSnippet {
+  /** Snippet with full token — for clipboard copy */
+  snippet: string;
+  /** Snippet with masked token — for display in UI */
+  displaySnippet: string;
+  /** Target config file path */
+  path: string;
+}
+
+export function generateStdioSnippet(agent: AgentInfo): ConfigSnippet {
+  const stdioEntry: Record<string, unknown> = { type: 'stdio', command: 'mindos', args: ['mcp'] };
+
+  if (agent.format === 'toml') {
+    const lines = [
+      `[${agent.configKey}.mindos]`,
+      `command = "mindos"`,
+      `args = ["mcp"]`,
+      '',
+      `[${agent.configKey}.mindos.env]`,
+      `MCP_TRANSPORT = "stdio"`,
+    ];
+    const s = lines.join('\n');
+    return { snippet: s, displaySnippet: s, path: agent.globalPath };
+  }
+
+  if (agent.globalNestedKey) {
+    const s = JSON.stringify({ [agent.configKey]: { mindos: stdioEntry } }, null, 2);
+    return { snippet: s, displaySnippet: s, path: agent.projectPath ?? agent.globalPath };
+  }
+
+  const s = JSON.stringify({ [agent.configKey]: { mindos: stdioEntry } }, null, 2);
+  return { snippet: s, displaySnippet: s, path: agent.globalPath };
+}
+
+export function generateHttpSnippet(
+  agent: AgentInfo,
+  endpoint: string,
+  token?: string,
+  maskedToken?: string,
+): ConfigSnippet {
+  // Full token for copy
+  const httpEntry: Record<string, unknown> = { url: endpoint };
+  if (token) httpEntry.headers = { Authorization: `Bearer ${token}` };
+
+  // Masked token for display
+  const displayEntry: Record<string, unknown> = { url: endpoint };
+  if (maskedToken) displayEntry.headers = { Authorization: `Bearer ${maskedToken}` };
+
+  const buildSnippet = (entry: Record<string, unknown>) => {
+    if (agent.format === 'toml') {
+      const lines = [
+        `[${agent.configKey}.mindos]`,
+        `type = "http"`,
+        `url = "${endpoint}"`,
+      ];
+      const authVal = (entry.headers as Record<string, string>)?.Authorization;
+      if (authVal) {
+        lines.push('');
+        lines.push(`[${agent.configKey}.mindos.headers]`);
+        lines.push(`Authorization = "${authVal}"`);
+      }
+      return lines.join('\n');
+    }
+
+    if (agent.globalNestedKey) {
+      return JSON.stringify({ [agent.configKey]: { mindos: entry } }, null, 2);
+    }
+
+    return JSON.stringify({ [agent.configKey]: { mindos: entry } }, null, 2);
+  };
+
+  return {
+    snippet: buildSnippet(httpEntry),
+    displaySnippet: buildSnippet(token ? displayEntry : httpEntry),
+    path: agent.format === 'toml'
+      ? agent.globalPath
+      : (agent.globalNestedKey ? (agent.projectPath ?? agent.globalPath) : agent.globalPath),
+  };
+}
+
+/** Generate snippet based on transport mode */
+export function generateSnippet(
+  agent: AgentInfo,
+  status: McpStatus | null,
+  transport: 'stdio' | 'http',
+): ConfigSnippet {
+  if (transport === 'stdio') {
+    return generateStdioSnippet(agent);
+  }
+  // For remote/http mode, prefer localIP over endpoint (which is always localhost)
+  const endpoint = status?.localIP
+    ? `http://${status.localIP}:${status.port}/mcp`
+    : (status?.endpoint ?? 'http://127.0.0.1:8781/mcp');
+  return generateHttpSnippet(
+    agent,
+    endpoint,
+    status?.authToken,
+    status?.maskedToken,
+  );
+}

package/_standalone/lib/obsidian-compat/command-registry.ts

@@ -0,0 +1,85 @@
+/**
+ * Obsidian Plugin Compatibility - Command Registry
+ * Central registry for all plugin-registered commands
+ */
+
+import { Command } from './types';
+
+export interface RegisteredCommand extends Command {
+  pluginId: string;
+  fullId: string; // obsidian:{pluginId}:{commandId}
+}
+
+export class CommandRegistry {
+  private commands: Map<string, RegisteredCommand> = new Map();
+
+  /**
+   * Register a command from a plugin.
+   */
+  register(pluginId: string, command: Command): RegisteredCommand {
+    const fullId = `obsidian:${pluginId}:${command.id}`;
+
+    // Duplicate registration replaces the previous command deterministically.
+
+    const registered: RegisteredCommand = {
+      ...command,
+      pluginId,
+      fullId,
+    };
+
+    this.commands.set(fullId, registered);
+    return registered;
+  }
+
+  /**
+   * Unregister a command by plugin + command ID.
+   */
+  unregister(pluginId: string, commandId: string): void {
+    const fullId = `obsidian:${pluginId}:${commandId}`;
+    this.commands.delete(fullId);
+  }
+
+  /**
+   * Unregister all commands from a plugin.
+   */
+  unregisterAll(pluginId: string): void {
+    for (const [fullId] of Array.from(this.commands.entries())) {
+      if (fullId.startsWith(`obsidian:${pluginId}:`)) {
+        this.commands.delete(fullId);
+      }
+    }
+  }
+
+  /**
+   * List all registered commands.
+   */
+  list(): RegisteredCommand[] {
+    return Array.from(this.commands.values());
+  }
+
+  /**
+   * Get a specific command by full ID.
+   */
+  get(fullId: string): RegisteredCommand | undefined {
+    return this.commands.get(fullId);
+  }
+
+  /**
+   * Execute a command by full ID (calls callback if available).
+   */
+  async execute(fullId: string): Promise<void> {
+    const cmd = this.commands.get(fullId);
+    if (!cmd) {
+      throw new Error(`Command not found: ${fullId}`);
+    }
+
+    try {
+      if (cmd.callback) {
+        cmd.callback();
+      }
+    } catch (err) {
+      console.error(`[obsidian-compat] Command execution failed: ${fullId}`, err);
+      throw err;
+    }
+  }
+}