MimikkAI VS Code Extension

VS Code расширение для управления документами MimikkAI.

Установка

npm run build      # Сборка
npm run package    # Упаковка в .vsix
npm run publish    # Публикация

Extension API

Extension ID: mimikkai.mimikkai-agents

Другие расширения и агенты могут взаимодействовать с MimikkAI через VS Code команды.

Авторизация

mimikkai.api.setAuthToken

Устанавливает токен авторизации. Токен сохраняется в защищённом хранилище OS (SecretStorage / keychain), не в настройках.

const result = await vscode.commands.executeCommand<{
  success: boolean;
  isAuthenticated: boolean;
  error?: string;
}>("mimikkai.api.setAuthToken", token);

Параметры: | Параметр | Тип | Описание | |---|---|---| | token | string | Токен в формате ключ или ID\|ключ (например 15\|qIi9Lwhi...) |

Возвращает:

{
  success: boolean;        // true если токен сохранён
  isAuthenticated: boolean; // true если сервер подтвердил авторизацию
  error?: string;          // сообщение об ошибке если success = false
}

Пример:

const result = await vscode.commands.executeCommand(
  "mimikkai.api.setAuthToken",
  "15|qIi9Lwhi6LZQ7ZnI0eWW40Do6gfqsPQ4WxzF6hv864d27a66"
);

if (result.isAuthenticated) {
  console.log("Авторизация успешна");
}

mimikkai.api.isAuthenticated

Быстрая проверка авторизации без сетевого запроса (использует кэшированное состояние).

const isAuth = await vscode.commands.executeCommand<boolean>(
  "mimikkai.api.isAuthenticated"
);

Возвращает: true | false

Пример:

const isAuthenticated = await vscode.commands.executeCommand(
  "mimikkai.api.isAuthenticated"
);

if (!isAuthenticated) {
  vscode.window.showWarningMessage("Пользователь не авторизован в MimikkAI");
}

mimikkai.api.getStatus

Возвращает полный статус авторизации включая данные пользователя. Без сетевого запроса.

const status = await vscode.commands.executeCommand<{
  isAuthenticated: boolean;
  user: { id: string; name: string; email: string } | null;
}>("mimikkai.api.getStatus");

Возвращает:

{
  isAuthenticated: boolean;
  user: {
    id: string;
    name: string;
    email: string;
  } | null;
}

Пример:

const status = await vscode.commands.executeCommand("mimikkai.api.getStatus");

if (status.isAuthenticated) {
  console.log(`Пользователь: ${status.user.name} (${status.user.email})`);
}

mimikkai.api.getAuthToken

Возвращает токен авторизации из SecretStorage. Без сетевого запроса.

Для пользовательского интерфейса используйте команду mimikkai.getAuthToken — она показывает токен в диалоговом окне.

const token = await vscode.commands.executeCommand<string>(
  "mimikkai.api.getAuthToken"
);

Возвращает: string — токен или пустая строка если не установлен.

Пример:

const token = await vscode.commands.executeCommand("mimikkai.api.getAuthToken");

if (token) {
  // Использовать токен для прямых запросов к API MimikkAI
  const response = await fetch("https://service.mimikkai.ru/graphql", {
    headers: { Authorization: `Bearer ${token}` },
  });
}

Команды VS Code

Все команды доступны через палитру команд (Ctrl+Shift+P):

Language Model Tools (MCP)

Расширение регистрирует инструменты для Copilot Chat / AI-агентов:

Пример использования в промпте:

#update_entry_fields {"entry_id": "123", "fields": {"A": "значение"}}
#get_document_entries {"document_id": "456", "page": 1, "page_size": 20}
#get_entry_fields {"entry_id": "123"}

Настройки

Токен авторизации хранится в SecretStorage (OS keychain), не в настройках.

Архитектура

src/
  extension.ts              # Точка входа, регистрация команд и API
  services/
    authService.ts          # Авторизация, статус-бар
    secureStorageService.ts # SecretStorage для токена
    graphqlClient.ts        # GraphQL API клиент
    entryProcessingService.ts # Обработка записей
    scenarioStateManager.ts # Управление выбранным сценарием
    webIntegration.ts       # Открытие страниц веб-интерфейса
  providers/
    documentTreeProvider.ts # Дерево документов
    agentModeTreeProvider.ts # Дерево агентских режимов
    apiKeyTreeProvider.ts   # Дерево AI-моделей
  tools/                    # Language Model Tools (MCP)
  utils/
    constants.ts            # Константы команд и конфигурации
    authUtils.ts            # Утилиты авторизации