@yancyyu/openhermit 1.6.42 → 1.6.43

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

@@ -0,0 +1,118 @@
+export type CapabilityScope = 'admin-loop' | 'team-loop' | 'kanban-card' | 'task-detail';
+
+export type CapabilitySafety = 'read-only' | 'reporting' | 'proposal-only' | 'write' | 'audit';
+
+export type CapabilityCommandSurface = 'slash' | 'quick-run';
+
+export type CapabilityCommandExecutionType = 'send-message' | 'loop-session';
+
+export interface CapabilityCommandExecution {
+  type: CapabilityCommandExecutionType;
+  reuse?: boolean;
+}
+
+export interface CapabilityCommand {
+  id: string;
+  alias: string;
+  title: string;
+  description?: string;
+  scope: CapabilityScope[];
+  surfaces: CapabilityCommandSurface[];
+  safety: CapabilitySafety;
+  prompt: string;
+  usesSkills?: string[];
+  workflow?: string | null;
+  order?: number;
+  execution?: CapabilityCommandExecution;
+}
+
+export interface CapabilitySkill {
+  id: string;
+  name: string;
+  description?: string;
+  path: string;
+}
+
+export interface CapabilityWorkflow {
+  id: string;
+  name: string;
+  description?: string;
+  path: string;
+}
+
+export interface CapabilityPackManifest {
+  schemaVersion: 1;
+  id: string;
+  name: string;
+  namespace: string;
+  version: string;
+  author?: string;
+  description?: string;
+  capabilities: {
+    commands?: CapabilityCommand[];
+    skills?: CapabilitySkill[];
+    workflows?: CapabilityWorkflow[];
+  };
+}
+
+export type CapabilityPackSource = 'builtin' | 'user' | 'project';
+
+export interface LoadedCapabilityPack {
+  manifest: CapabilityPackManifest;
+  packDir: string;
+  source: CapabilityPackSource;
+  enabled: boolean;
+  warnings: string[];
+}
+
+export interface CapabilityPackListResult {
+  packs: LoadedCapabilityPack[];
+  warnings: string[];
+  rootDir: string;
+}
+
+export interface CapabilityPackImportRequest {
+  sourceDir: string;
+  overwrite?: boolean;
+}
+
+export interface CapabilityPackExportRequest {
+  packId: string;
+  destinationDir: string;
+  overwrite?: boolean;
+}
+
+export interface CapabilityPackMutationResult {
+  pack: LoadedCapabilityPack | null;
+  warnings: string[];
+}
+
+export interface CapabilityCommandPromptRequest {
+  canonicalId: string;
+  scope?: CapabilityScope;
+}
+
+export interface CapabilityCommandPromptResult {
+  command: RegisteredSlashCommand;
+  prompt: string;
+}
+
+export type SlashCommandSource = 'builtin' | 'project' | 'pack' | 'official';
+
+export interface RegisteredSlashCommand {
+  canonicalId: string;
+  alias: string;
+  namespace: string;
+  slash: `/${string}`;
+  namespacedSlash: `/${string}:${string}`;
+  source: SlashCommandSource;
+  packId?: string;
+  command: CapabilityCommand;
+  conflictsWith?: string[];
+}
+
+export interface SlashCommandResolveResult {
+  status: 'not-found' | 'resolved' | 'conflict';
+  command?: RegisteredSlashCommand;
+  candidates?: RegisteredSlashCommand[];
+}

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

@@ -2,13 +2,41 @@
  * Extension Store types — barrel export.
  */
 
-export type { ApiKeysAPI, McpCatalogAPI, PluginCatalogAPI, SkillsCatalogAPI } from './api';
+export type {
+  ApiKeysAPI,
+  CapabilityPacksAPI,
+  McpCatalogAPI,
+  PluginCatalogAPI,
+  SkillsCatalogAPI,
+} from './api';
 export type {
   ApiKeyEntry,
   ApiKeyLookupResult,
   ApiKeySaveRequest,
   ApiKeyStorageStatus,
 } from './apikey';
+export type {
+  CapabilityCommand,
+  CapabilityCommandExecution,
+  CapabilityCommandExecutionType,
+  CapabilityCommandSurface,
+  CapabilityPackImportRequest,
+  CapabilityPackExportRequest,
+  CapabilityPackListResult,
+  CapabilityPackManifest,
+  CapabilityPackMutationResult,
+  CapabilityPackSource,
+  CapabilityCommandPromptRequest,
+  CapabilityCommandPromptResult,
+  CapabilitySafety,
+  CapabilityScope,
+  CapabilitySkill,
+  CapabilityWorkflow,
+  LoadedCapabilityPack,
+  RegisteredSlashCommand,
+  SlashCommandResolveResult,
+  SlashCommandSource,
+} from './capabilityPack';
 export type { ExtensionOperationState, InstallScope, OperationResult } from './common';
 export type {
   InstalledMcpEntry,

package/src/shared/types/index.ts

@@ -44,6 +44,12 @@ export type * from './terminal';
 // Re-export System Manager types
 export type * from './systemManager';
 
+// Re-export Worker types
+export type * from './worker';
+
+// Re-export Loop Assets types
+export type * from './loopAssets';
+
 // Re-export Editor types
 export type * from './editor';
 

package/src/shared/types/loopAssets.ts

@@ -0,0 +1,54 @@
+export type LoopAssetCategoryKey = 'automations' | 'worktrees' | 'skills' | 'subagents' | 'state';
+
+export type LoopAssetStatus = 'ready' | 'partial' | 'missing' | 'warning';
+
+export type LoopAssetLifecycle = 'ready' | 'active' | 'missing-assets' | 'stale' | 'unknown';
+
+export interface LoopAssetAction {
+  id: string;
+  label: string;
+  kind:
+    | 'navigate'
+    | 'open-dialog'
+    | 'open-file'
+    | 'run-workflow'
+    | 'copy-command'
+    | 'loop-session'
+    | 'run-command';
+  target?: string;
+  payload?: Record<string, unknown>;
+  disabled?: boolean;
+  tooltip?: string;
+}
+
+export interface LoopAssetSourceRef {
+  label: string;
+  path?: string;
+  scope: 'project' | 'team' | 'user' | 'system' | 'external';
+  kind?: string;
+}
+
+export interface LoopAssetCategorySnapshot {
+  key: LoopAssetCategoryKey;
+  title: string;
+  subtitle: string;
+  status: LoopAssetStatus;
+  count: number;
+  details: string[];
+  gap: string;
+  sources: LoopAssetSourceRef[];
+  actions: LoopAssetAction[];
+  warnings?: string[];
+}
+
+export interface LoopAssetsSnapshot {
+  teamName: string;
+  displayName?: string;
+  bindProject?: string;
+  workDir: string;
+  lifecycle: LoopAssetLifecycle;
+  healthScore: number;
+  scannedAt: string;
+  categories: LoopAssetCategorySnapshot[];
+  warnings?: string[];
+}

package/src/shared/types/providers.ts

@@ -98,19 +98,3 @@ export interface ProviderPresetsResponse {
   updated_at?: string;
   providers: ProviderPreset[];
 }
-
-/** Result of reading from cc-switch SQLite DB. */
-export interface CCSwitchProvider {
-  name: string;
-  app_type: string;
-  api_key?: string;
-  base_url?: string;
-  model?: string;
-  is_current: boolean;
-}
-
-export interface CCSwitchListResponse {
-  providers: CCSwitchProvider[];
-  available: boolean;
-  error?: string;
-}

package/src/shared/types/systemManager.ts

@@ -1,8 +1,11 @@
 export interface SystemManagerStatus {
-  displayName: '控制台';
+  displayName: 'Helm Loop';
+  /** Canonical, isolated runtime path for the admin loop (~/.hermit/admin-workspace). */
+  adminWorkDir: string;
   defaultWorkDir: string;
   selectedWorkDir: string;
   workflowFolder?: string;
+  globalHermitWorkflowFolder?: string;
   claudeCommand: 'claude';
   localStatus: 'ready' | 'missing-claude' | 'error';
   error?: string;
@@ -12,14 +15,28 @@ export interface SystemManagerConfig {
   schemaVersion: 1;
   selectedWorkDir: string;
   workflowFolder?: string;
+  /** One-shot marker: the ops-guide bootstrap has been fed into the admin lead session. */
+  adminInitialized?: boolean;
   updatedAt: string;
 }
 
 export interface SystemManagerConfigPatch {
   selectedWorkDir?: string;
   workflowFolder?: string | null;
+  adminInitialized?: boolean;
 }
 
+export type WorkflowPromptSource = 'claude-command' | 'workflow-folder';
+
+export type WorkflowPromptSafety =
+  | 'read-only'
+  | 'reporting'
+  | 'audit'
+  | 'proposal-only'
+  | 'apply'
+  | 'destructive'
+  | 'unknown';
+
 export interface WorkflowPromptSummary {
   id: string;
   label: string;
@@ -27,6 +44,14 @@ export interface WorkflowPromptSummary {
   path: string;
   sizeBytes: number;
   updatedAt: string;
+  folder?: string;
+  source?: WorkflowPromptSource;
+  commandName?: string;
+  description?: string;
+  category?: string;
+  safety?: WorkflowPromptSafety;
+  builtin?: boolean;
+  order?: number;
 }
 
 export interface WorkflowPromptListResponse {

package/src/shared/types/team.ts

@@ -2,7 +2,7 @@ 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_DISPLAY_NAME = 'Helm Loop';
 export const SYSTEM_MANAGER_BIND_PROJECT = 'my-project';
 
 export interface SystemManagerSummary {
@@ -57,6 +57,7 @@ export interface TeamConfig {
   members?: TeamMember[];
   projectPath?: string;
   projectPathHistory?: string[];
+  ccSyncError?: string | null;
   /** Default machine/cwd used when launching this team. */
   executionTarget?: ExecutionTarget;
   leadSessionId?: string;
@@ -105,6 +106,8 @@ export interface TeamSummary {
   color?: string;
   memberCount: number;
   members?: TeamSummaryMember[];
+  /** Runtime harness used to launch the team, e.g. claudecode/codex/opencode. */
+  harness?: string;
   taskCount: number;
   lastActivity: string | null;
   projectPath?: string;
@@ -149,6 +152,10 @@ export interface TeamSummary {
     sessions: number;
     messages: number;
     tokens: number;
+    tokensIn?: number;
+    tokensOut?: number;
+    cacheRead?: number;
+    cacheCreation?: number;
     durationMs: number;
   };
 }
@@ -200,6 +207,8 @@ export interface DiscoverableTeam {
   capabilities?: AgentCapability[];
   description?: string;
   harness?: string;
+  /** Canonical project path — surfaced via /workers so admins know where each team lives. */
+  workDir?: string;
 }
 
 export interface TaskBusConfig {
@@ -272,7 +281,9 @@ export interface TaskHandshakeResponse {
 
 export type CollabTaskStatus =
   | 'pending_accept'
+  | 'received'
   | 'accepted'
+  | 'in_progress'
   | 'delivered'
   | 'approved'
   | 'revision'
@@ -324,6 +335,8 @@ export interface CollabTask {
   rejectedAt?: string;
   deliveredAt?: string;
   approvedAt?: string;
+  completedAt?: string;
+  remoteTaskId?: string;
 }
 
 export interface TaskWorkInterval {
@@ -1185,6 +1198,13 @@ export interface TeamLaunchRequest {
 
 export interface TeamLaunchResponse {
   runId: string;
+  ok?: boolean;
+  data?: {
+    teamName: string;
+    bindProject: string;
+    projectExists: boolean;
+    isOnline: boolean;
+  };
 }
 
 export interface CreateTaskRequest {
@@ -1393,11 +1413,24 @@ export interface TeamChangeEvent {
     | 'lead-message'
     | 'tool-activity'
     | 'process'
-    | 'member-spawn';
+    | 'member-spawn'
+    | 'direct-cli-stream';
   teamName: string;
   runId?: string;
   detail?: string;
   taskId?: string;
+  /** direct-cli-stream: which session this live token/turn came from. */
+  sessionKey?: string;
+  /** direct-cli-stream: optimistic id shared with the canonical reply (drives dedup). */
+  messageId?: string;
+  /** direct-cli-stream: init | delta | thinking | tool. */
+  kind?: string;
+  /** direct-cli-stream: incremental assistant text (delta) or tool name. */
+  text?: string;
+  toolName?: string;
+  toolInput?: unknown;
+  /** direct-cli-stream: reply sender shown during streaming (team name or member name). */
+  from?: string;
 }
 
 export interface ProjectBranchChangeEvent {
@@ -1502,9 +1535,10 @@ export interface TeamProvisioningMemberInput {
 
 export interface TeamCreateRequest {
   teamName: string;
-  /** cc-connect project name — ASCII, unique. Auto-generated if not provided. */
-  bindProject?: string;
-  displayName?: string;
+  /** cc-connect project name — ASCII, unique. Required for URL routing and cc-connect binding. */
+  bindProject: string;
+  /** Human-facing display name. Required and may contain Chinese/Unicode characters. */
+  displayName: string;
   description?: string;
   color?: string;
   members: TeamProvisioningMemberInput[];
@@ -1747,6 +1781,8 @@ export interface MemberFullStats {
   inputTokens: number;
   outputTokens: number;
   cacheReadTokens: number;
+  cacheCreationTokens: number;
+  totalTokens: number;
   costUsd: number;
   tasksCompleted: number;
   messageCount: number;

package/src/shared/types/terminal.ts

@@ -1,31 +1,9 @@
 /**
  * Terminal types — shared between main, preload, and renderer processes.
  *
- * Used for embedded PTY terminal (xterm.js + node-pty).
+ * Commands open in the system/default terminal.
  */
 
-// =============================================================================
-// PTY Spawn Options
-// =============================================================================
-
-/**
- * Options for spawning a new PTY process.
- */
-export interface PtySpawnOptions {
-  /** Command to run (default: user's shell) */
-  command?: string;
-  /** Arguments for the command */
-  args?: string[];
-  /** Working directory */
-  cwd?: string;
-  /** Environment variables (merged with process.env) */
-  env?: Record<string, string>;
-  /** Initial terminal columns */
-  cols?: number;
-  /** Initial terminal rows */
-  rows?: number;
-}
-
 // =============================================================================
 // Preload API
 // =============================================================================
@@ -34,18 +12,6 @@ export interface PtySpawnOptions {
  * Terminal API exposed via preload bridge.
  */
 export interface TerminalAPI {
-  /** Spawn a new PTY process. Returns unique pty ID. */
-  spawn: (options?: PtySpawnOptions) => Promise<string>;
-  /** Write data to PTY stdin (fire-and-forget). */
-  write: (ptyId: string, data: string) => void;
-  /** Resize PTY terminal (fire-and-forget). */
-  resize: (ptyId: string, cols: number, rows: number) => void;
-  /** Kill PTY process. */
-  kill: (ptyId: string) => Promise<void>;
-  /** Open command in system Terminal.app (macOS). */
+  /** Open command in the system terminal. */
   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. */
-  onExit: (cb: (event: unknown, ptyId: string, exitCode: number) => void) => () => void;
 }

package/src/shared/types/worker.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from 'vitest';
+
+import { discoverableTeamToWorker } from './worker';
+import type { DiscoverableTeam } from './team';
+
+function makeTeam(overrides: Partial<DiscoverableTeam> = {}): DiscoverableTeam {
+  return {
+    slug: 'team-1',
+    displayName: '产品助手',
+    location: 'local',
+    status: 'online',
+    collaboration: true,
+    ...overrides,
+  };
+}
+
+describe('discoverableTeamToWorker', () => {
+  it('forwards the workDir so /workers can show where each team lives', () => {
+    const worker = discoverableTeamToWorker(makeTeam({ workDir: '/Users/x/projects/demo' }));
+    expect(worker.workerId).toBe('team-1');
+    expect(worker.workDir).toBe('/Users/x/projects/demo');
+  });
+
+  it('leaves workDir undefined when the team manifest has none', () => {
+    const worker = discoverableTeamToWorker(makeTeam());
+    expect(worker.workDir).toBeUndefined();
+  });
+});

package/src/shared/types/worker.ts

@@ -28,6 +28,8 @@ export interface DiscoverableWorker extends WorkerIdentity {
   status: 'online' | 'offline';
   capabilities?: WorkerCapability[];
   description?: string;
+  /** Canonical project path, forwarded from the team manifest for /workers output. */
+  workDir?: string;
 }
 
 /** atomic worker 的 dispatch 立即响应（fire-and-forget，不阻塞长任务）。 */
@@ -58,5 +60,6 @@ export function discoverableTeamToWorker(team: DiscoverableTeam): DiscoverableWo
     status: team.status,
     capabilities: team.capabilities,
     description: team.description,
+    workDir: team.workDir,
   };
 }

package/src/shared/utils/__tests__/effortLevels.test.ts

@@ -0,0 +1,88 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  ANTHROPIC_TEAM_EFFORT_LEVELS,
+  CODEX_TEAM_EFFORT_LEVELS,
+  formatEffortLevelList,
+  formatEffortLevelListForProvider,
+  isTeamEffortLevel,
+  isTeamEffortLevelForProvider,
+  TEAM_EFFORT_LEVELS,
+} from '../effortLevels';
+
+describe('TEAM_EFFORT_LEVELS', () => {
+  it('contains the full ordered set of effort levels', () => {
+    expect(TEAM_EFFORT_LEVELS).toEqual([
+      'none',
+      'minimal',
+      'low',
+      'medium',
+      'high',
+      'xhigh',
+      'max',
+    ]);
+  });
+});
+
+describe('isTeamEffortLevel', () => {
+  it.each(TEAM_EFFORT_LEVELS)('accepts %s', (level) => {
+    expect(isTeamEffortLevel(level)).toBe(true);
+  });
+
+  it.each(['', 'turbo', 'extra', undefined, null, 5])('rejects %s', (level) => {
+    expect(isTeamEffortLevel(level)).toBe(false);
+  });
+});
+
+describe('isTeamEffortLevelForProvider', () => {
+  it('accepts Codex effort levels for Codex', () => {
+    for (const level of CODEX_TEAM_EFFORT_LEVELS) {
+      expect(isTeamEffortLevelForProvider(level, 'codex')).toBe(true);
+    }
+  });
+
+  it('rejects max effort for Codex (not in its set)', () => {
+    expect(isTeamEffortLevelForProvider('max', 'codex')).toBe(false);
+  });
+
+  it('accepts Anthropic effort levels for Anthropic', () => {
+    for (const level of ANTHROPIC_TEAM_EFFORT_LEVELS) {
+      expect(isTeamEffortLevelForProvider(level, 'anthropic')).toBe(true);
+    }
+  });
+
+  it('rejects minimal effort for Anthropic', () => {
+    expect(isTeamEffortLevelForProvider('minimal', 'anthropic')).toBe(false);
+  });
+
+  it('falls back to the legacy set for gemini/opencode (low/medium/high only)', () => {
+    expect(isTeamEffortLevelForProvider('low', 'gemini')).toBe(true);
+    expect(isTeamEffortLevelForProvider('medium', 'opencode')).toBe(true);
+    expect(isTeamEffortLevelForProvider('high', 'gemini')).toBe(true);
+    expect(isTeamEffortLevelForProvider('minimal', 'gemini')).toBe(false);
+    expect(isTeamEffortLevelForProvider('max', 'opencode')).toBe(false);
+  });
+});
+
+describe('formatEffortLevelList', () => {
+  it('returns the full comma-separated list', () => {
+    expect(formatEffortLevelList()).toBe(TEAM_EFFORT_LEVELS.join(', '));
+  });
+});
+
+describe('formatEffortLevelListForProvider', () => {
+  it('returns the Codex-specific list', () => {
+    expect(formatEffortLevelListForProvider('codex')).toBe(CODEX_TEAM_EFFORT_LEVELS.join(', '));
+  });
+
+  it('returns the Anthropic-specific list', () => {
+    expect(formatEffortLevelListForProvider('anthropic')).toBe(
+      ANTHROPIC_TEAM_EFFORT_LEVELS.join(', ')
+    );
+  });
+
+  it('returns the legacy list for other providers', () => {
+    expect(formatEffortLevelListForProvider('gemini')).toBe('low, medium, high');
+    expect(formatEffortLevelListForProvider()).toBe('low, medium, high');
+  });
+});