@yancyyu/openhermit 1.6.37 → 1.6.39

package/src/renderer/utils/teamModelAvailability.ts

@@ -402,7 +402,19 @@ export function isTeamModelAvailableForUi(
     return getRuntimeModelAvailability(providerId, trimmed, providerStatus) === 'available';
   }
 
-  return true;
+  if (!providerStatus) {
+    return true;
+  }
+
+  const hasRuntimeModelTruth =
+    providerStatus.models.length > 0 ||
+    (providerStatus.modelCatalog?.models.length ?? 0) > 0 ||
+    (providerStatus.modelAvailability?.length ?? 0) > 0;
+  if (!hasRuntimeModelTruth) {
+    return true;
+  }
+
+  return getRuntimeModelAvailability(providerId, trimmed, providerStatus) === 'available';
 }
 
 export function normalizeExplicitTeamModelForUi(
@@ -437,7 +449,11 @@ export function normalizeTeamModelForUi(
     return isTeamModelAvailableForUi(providerId, trimmed, providerStatus) ? normalized : '';
   }
 
-  return normalized;
+  if (providerId === 'codex' && trimmed === 'gpt-5.4-mini') {
+    return '';
+  }
+
+  return isTeamModelAvailableForUi(providerId, trimmed, providerStatus) ? normalized : '';
 }
 
 export function getTeamModelSelectionError(

package/src/shared/types/api.ts

@@ -81,6 +81,7 @@ import type {
   TeamProvisioningModelVerificationMode,
   TeamProvisioningPrepareResult,
   TeamProvisioningProgress,
+  SystemManagerSummary,
   TeamSummary,
   TeamTask,
   TeamTaskStatus,
@@ -93,6 +94,7 @@ import type {
   ToolApprovalSettings,
   UpdateKanbanPatch,
 } from './team';
+import type { SystemManagerAPI } from './systemManager';
 import type { TerminalAPI } from './terminal';
 import type { WaterfallData } from './visualization';
 import type { RecentProjectsElectronApi } from '@features/recent-projects/contracts';
@@ -491,8 +493,8 @@ export interface CcSession {
   projectId: string;
   sessionKey: string;
   platform: string;
-  userName: string;
-  chatName: string;
+  userName: string | null;
+  chatName: string | null;
   active: boolean;
   live: boolean;
   historyCount: number;
@@ -522,8 +524,122 @@ export interface CcSessionDetail {
   history: CcSessionMessage[];
 }
 
+export type ConversationTelemetryExportFormat = 'csv' | 'json' | 'markdown' | 'plaintext';
+
+export type ConversationTelemetryIncludeContent = 'none' | 'summary' | 'full';
+
+export interface ConversationTelemetryQuery {
+  teamName?: string;
+  platform?: string;
+  from?: string;
+  to?: string;
+  identityType?: 'person' | 'group' | 'unknown';
+  identityId?: string;
+  includeContent?: ConversationTelemetryIncludeContent;
+  includeToolResults?: boolean;
+  includeSystemMessages?: boolean;
+  limit?: number;
+  offset?: number;
+}
+
+export interface ConversationTelemetryMessage {
+  role: 'user' | 'assistant' | 'system' | 'tool' | 'unknown';
+  timestamp?: string;
+  content: string;
+  uuid?: string;
+  parentUuid?: string | null;
+  model?: string;
+  requestId?: string;
+  usage?: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    totalTokens: number;
+  };
+  isMeta?: boolean;
+}
+
+export interface ConversationTelemetryRow {
+  teamName: string;
+  teamDisplayName: string;
+  projectName: string;
+  session: {
+    ccSessionId?: string;
+    sessionKey: string;
+    agentSessionId?: string;
+    claudeSessionId?: string;
+    projectPath?: string;
+    jsonlRelPath?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    startTime?: string;
+    endTime?: string;
+    active?: boolean;
+    live?: boolean;
+    matchStatus: 'matched' | 'missing-agent-session-id' | 'jsonl-not-found' | 'ambiguous' | 'local-only';
+  };
+  identity: {
+    platform: string;
+    type: 'person' | 'group' | 'unknown';
+    id?: string;
+    userId?: string;
+    chatId?: string;
+    displayName: string;
+    userName?: string;
+    chatName?: string;
+    confidence: 'exact-id' | 'name-only' | 'allowlist-fallback' | 'session-key-only' | 'missing-id';
+  };
+  content: {
+    messageCount: number;
+    userMessageCount: number;
+    assistantMessageCount: number;
+    toolResultCount: number;
+    firstUserMessage?: string;
+    firstUserMessageAt?: string;
+    lastUserMessage?: string;
+    lastUserMessageAt?: string;
+    lastMessageRole?: ConversationTelemetryMessage['role'];
+    lastMessageContent?: string;
+    lastMessageAt?: string;
+    text?: string;
+    messages?: ConversationTelemetryMessage[];
+  };
+  usage: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    totalTokens: number;
+    assistantTurnsWithUsage: number;
+    models: Record<string, number>;
+    toolCalls: Record<string, number>;
+    usageSource: 'claude-jsonl' | 'missing';
+  };
+}
+
+export interface ConversationTelemetryResponse {
+  rows: ConversationTelemetryRow[];
+  nextOffset?: number;
+  computedAt: string;
+  summary: {
+    conversations: number;
+    runningConversations: number;
+    missingIdentityIds: number;
+    unmatchedSessions: number;
+    totalTokens: number;
+  };
+}
+
+export interface ConversationTelemetryExportResponse {
+  filename: string;
+  mimeType: string;
+  content: string;
+}
+
 export interface TeamsAPI {
   list: () => Promise<TeamSummary[]>;
+  ensureSystemManager: () => Promise<SystemManagerSummary>;
   getData: (teamName: string) => Promise<TeamViewSnapshot>;
   getTaskChangePresence: (teamName: string) => Promise<Record<string, TaskChangePresenceState>>;
   setChangePresenceTracking: (teamName: string, enabled: boolean) => Promise<void>;
@@ -1096,6 +1212,9 @@ export interface ElectronAPI extends RecentProjectsElectronApi {
   // CLI Installer API
   cliInstaller: CliInstallerAPI;
 
+  // System Manager / Control Console API
+  systemManager: SystemManagerAPI;
+
   // Embedded Terminal API (xterm.js + node-pty)
   terminal: TerminalAPI;
 

package/src/shared/types/ccConnect.ts

@@ -93,6 +93,8 @@ export interface CcProjectSettingsUpdate {
   reply_footer?: boolean;
   inject_sender?: boolean;
   platform_allow_from?: Record<string, string>;
+  /** 群聊允许的 chat ID，* 表示所有群聊 */
+  platform_allow_chat?: Record<string, string>;
 }
 
 export interface CcAddPlatformRequest {

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

@@ -15,6 +15,10 @@ import type {
   McpCatalogItem,
   McpCustomInstallRequest,
   McpInstallRequest,
+  McpLibraryEntry,
+  McpLibraryImportRequest,
+  McpLibraryImportResult,
+  McpLibraryUpsertRequest,
   McpSearchResult,
   McpServerDiagnostic,
 } from './mcp';
@@ -59,6 +63,11 @@ export interface McpCatalogAPI {
   installCustom: (request: McpCustomInstallRequest) => Promise<OperationResult>;
   uninstall: (name: string, scope?: string, projectPath?: string) => Promise<OperationResult>;
   githubStars: (repositoryUrls: string[]) => Promise<Record<string, number>>;
+  // ── Library (cc-switch style global library of server definitions) ──
+  libraryList: () => Promise<McpLibraryEntry[]>;
+  libraryUpsert: (request: McpLibraryUpsertRequest) => Promise<McpLibraryEntry>;
+  libraryDelete: (id: string) => Promise<void>;
+  libraryImport: (request: McpLibraryImportRequest) => Promise<McpLibraryImportResult>;
 }
 
 // ── Skills API ─────────────────────────────────────────────────────────────

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

@@ -21,6 +21,10 @@ export type {
   McpHttpInstallSpec,
   McpInstallRequest,
   McpInstallSpec,
+  McpLibraryEntry,
+  McpLibraryImportRequest,
+  McpLibraryImportResult,
+  McpLibraryUpsertRequest,
   McpSearchResult,
   McpServerDiagnostic,
   McpServerHealthStatus,

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

@@ -132,3 +132,44 @@ export interface McpSearchResult {
   servers: McpCatalogItem[];
   warnings: string[]; // e.g. "Official registry unavailable"
 }
+
+// ── MCP Library (cc-switch style: a reusable global library of server defs) ──
+//
+// A saved server definition lives once in the library and can be enabled for
+// any worker (= installed into that worker's project config) without re-typing
+// the command / URL / env each time.
+
+export interface McpLibraryEntry {
+  id: string; // stable uuid
+  name: string; // server name used when installing (`claude mcp add <name>`)
+  description?: string;
+  installSpec: McpInstallSpec;
+  envValues?: Record<string, string>; // saved non-secret defaults
+  headers?: McpHeaderDef[];
+  createdAt: number;
+  updatedAt: number;
+}
+
+/** Create (omit id) or update (provide id) a library entry. */
+export interface McpLibraryUpsertRequest {
+  id?: string;
+  name: string;
+  description?: string;
+  installSpec: McpInstallSpec;
+  envValues?: Record<string, string>;
+  headers?: McpHeaderDef[];
+}
+
+/**
+ * Import existing MCP servers from live config into the library.
+ * Pulls user-scope servers plus, when a projectPath is given, that worker's
+ * project-scope servers. Existing library entries (matched by name) are skipped.
+ */
+export interface McpLibraryImportRequest {
+  projectPath?: string;
+}
+
+export interface McpLibraryImportResult {
+  imported: string[];
+  skipped: string[];
+}

package/src/shared/types/index.ts

@@ -41,6 +41,9 @@ export type * from './providers';
 // Re-export Terminal types
 export type * from './terminal';
 
+// Re-export System Manager types
+export type * from './systemManager';
+
 // Re-export Editor types
 export type * from './editor';
 

package/src/shared/types/systemManager.ts

@@ -0,0 +1,49 @@
+export interface SystemManagerStatus {
+  displayName: '控制台';
+  defaultWorkDir: string;
+  selectedWorkDir: string;
+  workflowFolder?: string;
+  claudeCommand: 'claude';
+  localStatus: 'ready' | 'missing-claude' | 'error';
+  error?: string;
+}
+
+export interface SystemManagerConfig {
+  schemaVersion: 1;
+  selectedWorkDir: string;
+  workflowFolder?: string;
+  updatedAt: string;
+}
+
+export interface SystemManagerConfigPatch {
+  selectedWorkDir?: string;
+  workflowFolder?: string | null;
+}
+
+export interface WorkflowPromptSummary {
+  id: string;
+  label: string;
+  filename: string;
+  path: string;
+  sizeBytes: number;
+  updatedAt: string;
+}
+
+export interface WorkflowPromptListResponse {
+  folder: string;
+  prompts: WorkflowPromptSummary[];
+  warnings: string[];
+}
+
+export interface WorkflowPromptContentResponse {
+  prompt: WorkflowPromptSummary;
+  content: string;
+}
+
+export interface SystemManagerAPI {
+  getStatus: () => Promise<SystemManagerStatus>;
+  getConfig: () => Promise<SystemManagerConfig>;
+  updateConfig: (patch: SystemManagerConfigPatch) => Promise<SystemManagerConfig>;
+  listWorkflowPrompts: (folder: string) => Promise<WorkflowPromptListResponse>;
+  readWorkflowPrompt: (folder: string, id: string) => Promise<WorkflowPromptContentResponse>;
+}

package/src/shared/types/team.ts

@@ -1,6 +1,22 @@
 import type { ExecutionTarget } from './api';
 import type { EnhancedChunk } from '@main/types';
 
+export const SYSTEM_MANAGER_TEAM_NAME = 'system-manager';
+export const SYSTEM_MANAGER_DISPLAY_NAME = '控制台';
+export const SYSTEM_MANAGER_BIND_PROJECT = 'my-project';
+
+export interface SystemManagerSummary {
+  teamName: typeof SYSTEM_MANAGER_TEAM_NAME;
+  displayName: typeof SYSTEM_MANAGER_DISPLAY_NAME;
+  bindProject: typeof SYSTEM_MANAGER_BIND_PROJECT;
+  workDir: string;
+  projectPath?: string;
+  description: string;
+  localStatus: 'ready';
+  ccConnectProjectStatus: 'bound' | 'missing';
+  feishuStatus: 'unbound' | 'connected' | 'error' | 'unknown';
+}
+
 export interface TeamMember {
   name: string;
   agentId?: string;
@@ -36,6 +52,8 @@ export interface TeamConfig {
   managedSources?: string;
   disabledCommands?: string[];
   platformAllowFrom?: Record<string, string>;
+  /** 群聊允许的 chat ID（按平台），* 表示所有群聊 */
+  platformAllowChat?: Record<string, string>;
   members?: TeamMember[];
   projectPath?: string;
   projectPathHistory?: string[];
@@ -61,6 +79,8 @@ export interface TeamUpdateConfigRequest {
   managedSources?: string;
   disabledCommands?: string[];
   platformAllowFrom?: Record<string, string>;
+  /** 群聊允许的 chat ID（按平台），* 表示所有群聊 */
+  platformAllowChat?: Record<string, string>;
   executionTarget?: ExecutionTarget;
   leadProviderId?: TeamProviderId;
   leadModel?: string;
@@ -122,6 +142,13 @@ export interface TeamSummary {
   runtimeCandidatePendingCount?: number;
   noRuntimePendingCount?: number;
   permissionPendingCount?: number;
+  /** Aggregated session stats from local JSONL files */
+  stats?: {
+    sessions: number;
+    messages: number;
+    tokens: number;
+    durationMs: number;
+  };
 }
 
 export type TeamTaskStatus = 'pending' | 'in_progress' | 'completed' | 'deleted';
@@ -1092,6 +1119,8 @@ export interface TeamViewSnapshot {
   processes: TeamProcess[];
   warnings?: string[];
   isAlive?: boolean;
+  /** Bound external platforms (feishu, telegram, etc.) from cc-connect */
+  platforms?: import('./ccConnect').CcProjectPlatform[];
   /** cc-connect project name this team is bound to */
   bindProject?: string;
   /** 团队协作开关：false = 独立作战，true = 可跨团队调度 */

package/src/shared/types/terminal.ts

@@ -40,8 +40,10 @@ export interface TerminalAPI {
   write: (ptyId: string, data: string) => void;
   /** Resize PTY terminal (fire-and-forget). */
   resize: (ptyId: string, cols: number, rows: number) => void;
-  /** Kill PTY process (fire-and-forget). */
-  kill: (ptyId: string) => void;
+  /** Kill PTY process. */
+  kill: (ptyId: string) => Promise<void>;
+  /** Open command in system Terminal.app (macOS). */
+  openExternal: (options: { command: string; args?: string[]; cwd?: string }) => Promise<void>;
   /** Subscribe to PTY data output. Returns cleanup function. */
   onData: (cb: (event: unknown, ptyId: string, data: string) => void) => () => void;
   /** Subscribe to PTY exit events. Returns cleanup function. */

package/src/shared/utils/extensionNormalizers.ts

@@ -106,6 +106,35 @@ export function buildPluginId(pluginName: string, marketplaceName: string): stri
   return `${pluginName}@${marketplaceName}`;
 }
 
+/**
+ * Substrings that mark a plugin as "essential" (必装) — recommended/required for
+ * the workbench. Matched against both the pluginId and homepage so it works
+ * regardless of the marketplace name a plugin is published under.
+ */
+export const ESSENTIAL_PLUGIN_PATTERNS = ['oh-my-claudecode'] as const;
+
+/**
+ * Marketplace plugins that should not be shown in Hermit's plugin store.
+ */
+export const HIDDEN_PLUGIN_PATTERNS = ['codex@openai-codex', 'codex-plugin-cc'] as const;
+
+/**
+ * Whether a plugin is one of the essential plugins surfaced with a 必装 badge and
+ * the recommendation banner.
+ */
+export function isEssentialPlugin(plugin: { pluginId: string; homepage?: string }): boolean {
+  const haystack = `${plugin.pluginId} ${plugin.homepage ?? ''}`.toLowerCase();
+  return ESSENTIAL_PLUGIN_PATTERNS.some((pattern) => haystack.includes(pattern));
+}
+
+/**
+ * Whether a plugin should be hidden from the plugin store catalog.
+ */
+export function isHiddenPluginFromStore(plugin: { pluginId: string; homepage?: string }): boolean {
+  const haystack = `${plugin.pluginId} ${plugin.homepage ?? ''}`.toLowerCase();
+  return HIDDEN_PLUGIN_PATTERNS.some((pattern) => haystack.includes(pattern));
+}
+
 /**
  * Namespaced operation-state key for plugin install/uninstall UI state.
  */

package/src/shared/utils/providerExtensionCapabilities.ts

@@ -58,12 +58,12 @@ export function createLegacyRuntimeFallbackCliExtensionCapabilities(
 export function getCliProviderExtensionCapabilities(
   provider: Pick<CliProviderStatus, 'capabilities'> | null | undefined
 ): CliExtensionCapabilities {
-  const fallback = createDefaultCliExtensionCapabilities();
   const extensions = provider?.capabilities?.extensions;
   if (!extensions) {
-    return fallback;
+    return createLegacyRuntimeFallbackCliExtensionCapabilities();
   }
 
+  const fallback = createDefaultCliExtensionCapabilities();
   return {
     plugins: extensions.plugins ?? fallback.plugins,
     mcp: extensions.mcp ?? fallback.mcp,