@yancyyu/openhermit 1.5.8

package/src/shared/types/cliInstaller.ts

@@ -0,0 +1,335 @@
+/**
+ * CLI Installer types — shared between main, preload, and renderer processes.
+ *
+ * Used for detecting, downloading, verifying, and installing Claude Code CLI binary.
+ */
+
+// Stub types for removed codex-account feature
+type CodexAccountAppServerState = string;
+type CodexAccountAuthMode = string;
+type CodexAccountEffectiveAuthMode = string;
+type CodexLaunchReadinessState = string;
+interface CodexLoginStateDto {
+  status: string;
+  error?: string | null;
+  [key: string]: unknown;
+}
+interface CodexManagedAccountDto {
+  type?: string;
+  planType?: string;
+  email?: string;
+  [key: string]: unknown;
+}
+interface CodexRateLimitWindowDto {
+  usedPercent: number;
+  windowDurationMins: number | null;
+  resetsAt: number | null;
+}
+interface CodexRateLimitSnapshotDto {
+  primary: CodexRateLimitWindowDto;
+  secondary?: CodexRateLimitWindowDto | null;
+  credits?: unknown;
+  [key: string]: unknown;
+}
+
+// =============================================================================
+// Platform Detection
+// =============================================================================
+
+/**
+ * Supported platform/architecture combinations for Claude CLI binary distribution.
+ */
+export type CliPlatform =
+  | 'darwin-arm64'
+  | 'darwin-x64'
+  | 'linux-x64'
+  | 'linux-arm64'
+  | 'linux-arm64-musl'
+  | 'linux-x64-musl'
+  | 'win32-x64'
+  | 'win32-arm64';
+
+export type CliFlavor = 'claude' | 'agent_teams_orchestrator';
+
+export type CliProviderId = 'anthropic' | 'codex' | 'gemini' | 'opencode';
+export type CliProviderAuthMode = 'auto' | 'oauth' | 'chatgpt' | 'api_key';
+
+export interface CliProviderConnectionInfo {
+  supportsOAuth: boolean;
+  supportsApiKey: boolean;
+  configurableAuthModes: CliProviderAuthMode[];
+  configuredAuthMode: CliProviderAuthMode | null;
+  apiKeyConfigured: boolean;
+  apiKeySource: 'stored' | 'environment' | null;
+  apiKeySourceLabel?: string | null;
+  codex?: {
+    preferredAuthMode: CodexAccountAuthMode;
+    effectiveAuthMode: CodexAccountEffectiveAuthMode;
+    appServerState: CodexAccountAppServerState;
+    appServerStatusMessage: string | null;
+    managedAccount: CodexManagedAccountDto | null;
+    requiresOpenaiAuth: boolean | null;
+    localAccountArtifactsPresent?: boolean;
+    localActiveChatgptAccountPresent?: boolean;
+    login: CodexLoginStateDto;
+    rateLimits: CodexRateLimitSnapshotDto | null;
+    launchAllowed: boolean;
+    launchIssueMessage: string | null;
+    launchReadinessState: CodexLaunchReadinessState;
+  } | null;
+}
+
+export interface CliProviderBackendOption {
+  id: string;
+  label: string;
+  description: string;
+  selectable: boolean;
+  recommended: boolean;
+  available: boolean;
+  state?:
+    | 'ready'
+    | 'locked'
+    | 'disabled'
+    | 'authentication-required'
+    | 'runtime-missing'
+    | 'degraded';
+  audience?: 'general' | 'internal';
+  statusMessage?: string | null;
+  detailMessage?: string | null;
+}
+
+export interface CliExternalRuntimeDiagnostic {
+  id: string;
+  label: string;
+  detected: boolean;
+  statusMessage?: string | null;
+  detailMessage?: string | null;
+}
+
+export type CliExtensionCapabilityStatus = 'supported' | 'read-only' | 'unsupported';
+export type CliExtensionOwnership = 'shared' | 'provider-scoped';
+
+export interface CliExtensionCapability {
+  status: CliExtensionCapabilityStatus;
+  ownership: CliExtensionOwnership;
+  reason?: string | null;
+}
+
+export interface CliExtensionCapabilities {
+  plugins: CliExtensionCapability;
+  mcp: CliExtensionCapability;
+  skills: CliExtensionCapability;
+  apiKeys: CliExtensionCapability;
+}
+
+export type CliProviderModelAvailabilityStatus =
+  | 'checking'
+  | 'available'
+  | 'unavailable'
+  | 'unknown';
+
+export interface CliProviderModelAvailability {
+  modelId: string;
+  status: CliProviderModelAvailabilityStatus;
+  reason?: string | null;
+  checkedAt?: string | null;
+}
+
+export type CliProviderReasoningEffort =
+  | 'none'
+  | 'minimal'
+  | 'low'
+  | 'medium'
+  | 'high'
+  | 'xhigh'
+  | 'max';
+
+export type CliProviderModelCatalogSource =
+  | 'anthropic-models-api'
+  | 'app-server'
+  | 'static-fallback';
+export type CliProviderModelCatalogStatus = 'ready' | 'stale' | 'degraded' | 'unavailable';
+
+export interface CliProviderModelCatalogItem {
+  id: string;
+  launchModel: string;
+  displayName: string;
+  hidden: boolean;
+  supportedReasoningEfforts: CliProviderReasoningEffort[];
+  defaultReasoningEffort: CliProviderReasoningEffort | null;
+  supportsFastMode?: boolean;
+  inputModalities: string[];
+  supportsPersonality: boolean;
+  isDefault: boolean;
+  upgrade: boolean;
+  source: CliProviderModelCatalogSource;
+  badgeLabel?: string | null;
+  statusMessage?: string | null;
+}
+
+export interface CliProviderModelCatalog {
+  schemaVersion: 1;
+  providerId: CliProviderId;
+  source: CliProviderModelCatalogSource;
+  status: CliProviderModelCatalogStatus;
+  fetchedAt: string;
+  staleAt: string;
+  defaultModelId: string | null;
+  defaultLaunchModel: string | null;
+  models: CliProviderModelCatalogItem[];
+  diagnostics: {
+    configReadState: 'ready' | 'unsupported' | 'failed' | 'skipped';
+    appServerState: 'healthy' | 'degraded' | 'runtime-missing' | 'incompatible';
+    message?: string | null;
+    code?: string | null;
+  };
+}
+
+export interface CliProviderRuntimeCapabilities {
+  modelCatalog?: {
+    dynamic: boolean;
+    source?: CliProviderModelCatalogSource | 'runtime';
+  };
+  reasoningEffort?: {
+    supported: boolean;
+    values: CliProviderReasoningEffort[];
+    configPassthrough?: boolean;
+  };
+  fastMode?: {
+    supported: boolean;
+    available: boolean;
+    reason?: string | null;
+    source: 'runtime';
+  };
+}
+
+export interface CliProviderStatus {
+  providerId: CliProviderId;
+  displayName: string;
+  supported: boolean;
+  authenticated: boolean;
+  authMethod: string | null;
+  verificationState: 'verified' | 'unknown' | 'offline' | 'error';
+  modelVerificationState?: 'idle' | 'verifying' | 'verified';
+  statusMessage?: string | null;
+  detailMessage?: string | null;
+  models: string[];
+  modelCatalog?: CliProviderModelCatalog | null;
+  modelAvailability?: CliProviderModelAvailability[];
+  runtimeCapabilities?: CliProviderRuntimeCapabilities | null;
+  canLoginFromUi: boolean;
+  capabilities: {
+    teamLaunch: boolean;
+    oneShot: boolean;
+    extensions: CliExtensionCapabilities;
+  };
+  selectedBackendId?: string | null;
+  resolvedBackendId?: string | null;
+  availableBackends?: CliProviderBackendOption[];
+  externalRuntimeDiagnostics?: CliExternalRuntimeDiagnostic[];
+  backend?: {
+    kind: string;
+    label: string;
+    endpointLabel?: string | null;
+    projectId?: string | null;
+    authMethodDetail?: string | null;
+  } | null;
+  connection?: CliProviderConnectionInfo | null;
+}
+
+export interface CliFlavorUiOptions {
+  displayName: string;
+  supportsSelfUpdate: boolean;
+  showVersionDetails: boolean;
+  showBinaryPath: boolean;
+}
+
+// =============================================================================
+// Installation Status
+// =============================================================================
+
+/**
+ * Current CLI installation status returned by getStatus().
+ */
+export interface CliInstallationStatus {
+  /** Selected CLI runtime flavor */
+  flavor: CliFlavor;
+  /** Display label for the configured runtime */
+  displayName: string;
+  /** Whether this runtime should expose self-update/install actions in the UI */
+  supportsSelfUpdate: boolean;
+  /** Whether version text should be shown in the UI */
+  showVersionDetails: boolean;
+  /** Whether binary path should be shown in the UI */
+  showBinaryPath: boolean;
+  /** Whether the CLI was found and passed the startup health check (`--version`) */
+  installed: boolean;
+  /** Installed version string (e.g. "2.1.59"), null if unavailable or not installed */
+  installedVersion: string | null;
+  /** Absolute path to the resolved binary candidate, null if not found */
+  binaryPath: string | null;
+  /** Probe failure when a binary was found but could not be started */
+  launchError?: string | null;
+  /** Latest available version from GCS, null if check failed */
+  latestVersion: string | null;
+  /** True when installed version < latest version */
+  updateAvailable: boolean;
+  /** Whether user is logged in (claude auth status) */
+  authLoggedIn: boolean;
+  /** Whether runtime authentication status is still being checked */
+  authStatusChecking: boolean;
+  /** Auth method if logged in (e.g. "oauth_token", "api_key"), null otherwise */
+  authMethod: string | null;
+  /** Provider-level runtime status when supported by the configured runtime */
+  providers: CliProviderStatus[];
+}
+
+// =============================================================================
+// Installer Progress Events
+// =============================================================================
+
+/**
+ * Progress event sent from main→renderer during CLI install/update.
+ */
+export interface CliInstallerProgress {
+  /** Current phase of the installation process */
+  type: 'checking' | 'downloading' | 'verifying' | 'installing' | 'completed' | 'error' | 'status';
+  /** Download progress 0-100, only present for 'downloading' */
+  percent?: number;
+  /** Bytes downloaded so far */
+  transferred?: number;
+  /** Total bytes to download (may be undefined if Content-Length absent) */
+  total?: number;
+  /** Installed version string, only present for 'completed' */
+  version?: string;
+  /** Error message, only present for 'error' */
+  error?: string;
+  /** Status detail text (e.g. stdout lines from `claude install`) */
+  detail?: string;
+  /** Raw terminal output chunk (with ANSI codes), only for 'installing' */
+  rawChunk?: string;
+  /** Partial or full CLI status snapshot during status gathering. */
+  status?: CliInstallationStatus;
+}
+
+// =============================================================================
+// Preload API
+// =============================================================================
+
+/**
+ * CLI Installer API exposed via preload bridge.
+ */
+export interface CliInstallerAPI {
+  /** Get current CLI installation status */
+  getStatus: () => Promise<CliInstallationStatus>;
+  /** Get current runtime/auth status for a single provider */
+  getProviderStatus: (providerId: CliProviderId) => Promise<CliProviderStatus | null>;
+  /** Start on-demand model verification for a single runtime provider */
+  verifyProviderModels: (providerId: CliProviderId) => Promise<CliProviderStatus | null>;
+  /** Start install/update flow. Progress sent via onProgress events. */
+  install: () => Promise<void>;
+  /** Invalidate cached status (forces fresh check on next getStatus) */
+  invalidateStatus: () => Promise<void>;
+  /** Subscribe to progress events. Returns cleanup function. */
+  onProgress: (cb: (event: unknown, data: CliInstallerProgress) => void) => () => void;
+}

package/src/shared/types/editor.ts

@@ -0,0 +1,279 @@
+/**
+ * Editor types shared between main and renderer processes.
+ */
+
+// =============================================================================
+// File Tree
+// =============================================================================
+
+export interface FileTreeEntry {
+  name: string;
+  /** Absolute path */
+  path: string;
+  type: 'file' | 'directory';
+  /** File size in bytes (files only) */
+  size?: number;
+  /** True for .env, .key, credentials, etc. — shown with lock icon */
+  isSensitive?: boolean;
+  /** Lazy-loaded children (populated on expand) */
+  children?: FileTreeEntry[];
+}
+
+// =============================================================================
+// IPC Results
+// =============================================================================
+
+export interface ReadDirResult {
+  entries: FileTreeEntry[];
+  /** True when entries were truncated at MAX_DIR_ENTRIES */
+  truncated: boolean;
+}
+
+export interface ReadFileResult {
+  content: string;
+  size: number;
+  /** Unix timestamp (stats.mtimeMs) — baseline for conflict detection */
+  mtimeMs: number;
+  /** True when file was too large and only preview was returned */
+  truncated: boolean;
+  encoding: string;
+  isBinary: boolean;
+}
+
+// =============================================================================
+// Write Request/Response
+// =============================================================================
+
+export interface WriteFileRequest {
+  filePath: string;
+  content: string;
+}
+
+export interface WriteFileResponse {
+  /** Unix timestamp after write (new mtimeMs) */
+  mtimeMs: number;
+  /** Bytes written */
+  size: number;
+}
+
+// =============================================================================
+// File Operations
+// =============================================================================
+
+export interface CreateFileResponse {
+  filePath: string;
+  mtimeMs: number;
+}
+
+export interface CreateDirResponse {
+  dirPath: string;
+}
+
+export interface DeleteFileResponse {
+  deletedPath: string;
+}
+
+export interface MoveFileResponse {
+  newPath: string;
+  isDirectory: boolean;
+}
+
+// =============================================================================
+// Search
+// =============================================================================
+
+export interface SearchMatch {
+  /** 1-based line number */
+  line: number;
+  /** 0-based column offset */
+  column: number;
+  /** The matching line text (trimmed) */
+  lineContent: string;
+}
+
+export interface SearchFileResult {
+  filePath: string;
+  matches: SearchMatch[];
+}
+
+export interface SearchInFilesResult {
+  results: SearchFileResult[];
+  /** Total number of matches across all files */
+  totalMatches: number;
+  /** True when results were truncated at limit */
+  truncated: boolean;
+}
+
+export interface SearchInFilesOptions {
+  query: string;
+  caseSensitive?: boolean;
+  /** Maximum number of result files (default 100) */
+  maxFiles?: number;
+  /** Maximum number of total matches (default 500) */
+  maxMatches?: number;
+}
+
+// =============================================================================
+// Tab
+// =============================================================================
+
+export interface EditorFileTab {
+  /** Unique key = filePath */
+  id: string;
+  filePath: string;
+  fileName: string;
+  /** Disambiguation suffix for duplicate names, e.g. "(main/utils)" */
+  disambiguatedLabel?: string;
+  /** Language identifier (from file extension) */
+  language: string;
+}
+
+// =============================================================================
+// Git Status
+// =============================================================================
+
+export type GitFileStatusType =
+  | 'modified'
+  | 'untracked'
+  | 'staged'
+  | 'deleted'
+  | 'conflict'
+  | 'renamed';
+
+export interface GitFileStatus {
+  /** Relative path from project root */
+  path: string;
+  status: GitFileStatusType;
+  /** Original path for renamed files */
+  renamedFrom?: string;
+}
+
+export interface GitStatusResult {
+  files: GitFileStatus[];
+  /** True if the project is inside a git repository */
+  isGitRepo: boolean;
+  /** Branch name (null if detached HEAD) */
+  branch: string | null;
+}
+
+// =============================================================================
+// File Watcher Events
+// =============================================================================
+
+export interface EditorFileChangeEvent {
+  type: 'change' | 'create' | 'delete';
+  /** Absolute path of the changed file */
+  path: string;
+}
+
+// =============================================================================
+// Editor API
+// =============================================================================
+
+export interface QuickOpenFile {
+  path: string;
+  name: string;
+  relativePath: string;
+}
+
+export interface EditorAPI {
+  open: (projectPath: string) => Promise<void>;
+  close: () => Promise<void>;
+  readDir: (dirPath: string, maxEntries?: number) => Promise<ReadDirResult>;
+  readFile: (filePath: string) => Promise<ReadFileResult>;
+  writeFile: (
+    filePath: string,
+    content: string,
+    baselineMtimeMs?: number
+  ) => Promise<WriteFileResponse>;
+  createFile: (parentDir: string, fileName: string) => Promise<CreateFileResponse>;
+  createDir: (parentDir: string, dirName: string) => Promise<CreateDirResponse>;
+  deleteFile: (filePath: string) => Promise<DeleteFileResponse>;
+  moveFile: (sourcePath: string, destDir: string) => Promise<MoveFileResponse>;
+  renameFile: (sourcePath: string, newName: string) => Promise<MoveFileResponse>;
+  searchInFiles: (options: SearchInFilesOptions) => Promise<SearchInFilesResult>;
+  listFiles: () => Promise<QuickOpenFile[]>;
+  readBinaryPreview: (filePath: string) => Promise<BinaryPreviewResult>;
+  gitStatus: () => Promise<GitStatusResult>;
+  watchDir: (enable: boolean) => Promise<void>;
+  /**
+   * Provide the list of currently-open file paths (tabs) to watch.
+   * Intended as a performance optimization: avoids watching the whole project tree.
+   */
+  setWatchedFiles: (filePaths: string[]) => Promise<void>;
+  /**
+   * Provide the list of directories to watch shallowly (depth=0).
+   * Intended to keep the explorer tree in sync with external changes without
+   * recursively watching the whole project.
+   */
+  setWatchedDirs: (dirPaths: string[]) => Promise<void>;
+  /** Subscribe to file change events (main → renderer). Returns cleanup function. */
+  onEditorChange: (callback: (event: EditorFileChangeEvent) => void) => () => void;
+}
+
+/** Editor-independent project file operations (e.g. @file mentions). */
+export interface ProjectAPI {
+  listFiles: (projectPath: string) => Promise<QuickOpenFile[]>;
+}
+
+// =============================================================================
+// Workspace (file system browsing)
+// =============================================================================
+
+export interface WorkspaceFileEntry {
+  name: string;
+  isDirectory: boolean;
+  size: number;
+  ext: string;
+}
+
+export interface WorkspaceListResponse {
+  path: string;
+  files: WorkspaceFileEntry[];
+  hasParent: boolean;
+  error?: string;
+}
+
+// =============================================================================
+
+// =============================================================================
+// Binary Preview
+// =============================================================================
+
+export interface BinaryPreviewResult {
+  /** Base64-encoded file content */
+  base64: string;
+  /** MIME type (e.g. 'image/png') */
+  mimeType: string;
+  /** File size in bytes */
+  size: number;
+}
+
+// =============================================================================
+// Selection Action Menu
+// =============================================================================
+
+export interface EditorSelectionInfo {
+  text: string;
+  filePath: string;
+  fromLine: number;
+  toLine: number;
+  /** Screen coords of selection end (for menu positioning) */
+  screenRect: { top: number; right: number; bottom: number };
+}
+
+export interface EditorSelectionAction {
+  type: 'sendMessage' | 'createTask';
+  filePath: string;
+  /** 1-based start line, or null for file-level mentions (no code selection) */
+  fromLine: number | null;
+  /** 1-based end line, or null for file-level mentions (no code selection) */
+  toLine: number | null;
+  selectedText: string;
+  /** Pre-formatted context block (markdown code fence or file reference) */
+  formattedContext: string;
+  /** Relative display path for file-level mentions */
+  displayPath?: string;
+  /** Whether this action represents a folder (not a file) */
+  isFolder?: boolean;
+}

package/src/shared/types/extensions/api.ts

@@ -0,0 +1,90 @@
+/**
+ * Extension Store API contracts — exposed via preload bridge.
+ * Both APIs are OPTIONAL in ElectronAPI (Electron-only V1).
+ */
+
+import type {
+  ApiKeyEntry,
+  ApiKeyLookupResult,
+  ApiKeySaveRequest,
+  ApiKeyStorageStatus,
+} from './apikey';
+import type { InstallScope, OperationResult } from './common';
+import type {
+  InstalledMcpEntry,
+  McpCatalogItem,
+  McpCustomInstallRequest,
+  McpInstallRequest,
+  McpSearchResult,
+  McpServerDiagnostic,
+} from './mcp';
+import type { EnrichedPlugin, PluginInstallRequest } from './plugin';
+import type {
+  SkillCatalogItem,
+  SkillDeleteRequest,
+  SkillDetail,
+  SkillImportRequest,
+  SkillReviewPreview,
+  SkillSource,
+  SkillSourcesSnapshot,
+  SkillUpsertRequest,
+  SkillWatcherEvent,
+} from './skill';
+
+// ── Plugin API ─────────────────────────────────────────────────────────────
+
+export interface PluginCatalogAPI {
+  getAll: (projectPath?: string, forceRefresh?: boolean) => Promise<EnrichedPlugin[]>;
+  getReadme: (pluginId: string) => Promise<string | null>;
+  install: (request: PluginInstallRequest) => Promise<OperationResult>;
+  uninstall: (
+    pluginId: string,
+    scope?: InstallScope,
+    projectPath?: string
+  ) => Promise<OperationResult>;
+}
+
+// ── MCP API ────────────────────────────────────────────────────────────────
+
+export interface McpCatalogAPI {
+  search: (query: string, limit?: number) => Promise<McpSearchResult>;
+  browse: (
+    cursor?: string,
+    limit?: number
+  ) => Promise<{ servers: McpCatalogItem[]; nextCursor?: string }>;
+  getById: (registryId: string) => Promise<McpCatalogItem | null>;
+  getInstalled: (projectPath?: string) => Promise<InstalledMcpEntry[]>;
+  diagnose: (projectPath?: string) => Promise<McpServerDiagnostic[]>;
+  install: (request: McpInstallRequest) => Promise<OperationResult>;
+  installCustom: (request: McpCustomInstallRequest) => Promise<OperationResult>;
+  uninstall: (name: string, scope?: string, projectPath?: string) => Promise<OperationResult>;
+  githubStars: (repositoryUrls: string[]) => Promise<Record<string, number>>;
+}
+
+// ── Skills API ─────────────────────────────────────────────────────────────
+
+export interface SkillsCatalogAPI {
+  list: (projectPath?: string) => Promise<SkillCatalogItem[]>;
+  getDetail: (skillId: string, projectPath?: string) => Promise<SkillDetail | null>;
+  previewUpsert: (request: SkillUpsertRequest) => Promise<SkillReviewPreview>;
+  applyUpsert: (request: SkillUpsertRequest) => Promise<SkillDetail | null>;
+  previewImport: (request: SkillImportRequest) => Promise<SkillReviewPreview>;
+  applyImport: (request: SkillImportRequest) => Promise<SkillDetail | null>;
+  deleteSkill: (request: SkillDeleteRequest) => Promise<void>;
+  listSources: () => Promise<SkillSourcesSnapshot>;
+  saveSources: (sources: SkillSource[]) => Promise<SkillSourcesSnapshot>;
+  refreshSources: () => Promise<SkillSourcesSnapshot>;
+  startWatching: (projectPath?: string) => Promise<string>;
+  stopWatching: (watchId: string) => Promise<void>;
+  onChanged: (callback: (event: SkillWatcherEvent) => void) => () => void;
+}
+
+// ── API Keys API ──────────────────────────────────────────────────────────
+
+export interface ApiKeysAPI {
+  list: () => Promise<ApiKeyEntry[]>;
+  save: (request: ApiKeySaveRequest) => Promise<ApiKeyEntry>;
+  delete: (id: string) => Promise<void>;
+  lookup: (envVarNames: string[], projectPath?: string) => Promise<ApiKeyLookupResult[]>;
+  getStorageStatus: () => Promise<ApiKeyStorageStatus>;
+}