@openspecui/core 1.0.0 → 1.0.2

package/dist/index.d.mts

@@ -17,13 +17,13 @@ declare const ChangeFileSchema: z.ZodObject<{
   /** Optional byte size for files */
   size: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-  type: "file" | "directory";
   path: string;
+  type: "file" | "directory";
   content?: string | undefined;
   size?: number | undefined;
 }, {
-  type: "file" | "directory";
   path: string;
+  type: "file" | "directory";
   content?: string | undefined;
   size?: number | undefined;
 }>;
@@ -1284,16 +1284,40 @@ declare function createFileChangeObservable(watcher: OpenSpecWatcher): {
 };
 //#endregion
 //#region src/config.d.ts
+type RunnerId = 'configured' | 'openspec' | 'npx' | 'bunx' | 'deno' | 'pnpm' | 'yarn';
+interface CliRunnerCandidate {
+  id: RunnerId;
+  source: string;
+  commandParts: readonly string[];
+}
+interface CliRunnerAttempt {
+  source: string;
+  command: string;
+  success: boolean;
+  version?: string;
+  error?: string;
+  exitCode: number | null;
+}
+interface ResolvedCliRunner {
+  source: string;
+  command: string;
+  commandParts: readonly string[];
+  version?: string;
+  attempts: readonly CliRunnerAttempt[];
+}
 /**
  * 解析 CLI 命令字符串为数组
  *
  * 支持两种格式：
  * 1. JSON 数组：以 `[` 开头，如 `["npx", "@fission-ai/openspec"]`
- * 2. 简单字符串：用空格分割，如 `npx @fission-ai/openspec`
- *
- * 注意：简单字符串解析不支持带引号的参数，如需复杂命令请使用 JSON 数组格式
+ * 2. shell-like 字符串：支持引号与基础转义
  */
 declare function parseCliCommand(command: string): string[];
+declare function buildCliRunnerCandidates(options: {
+  configuredCommandParts?: readonly string[];
+  userAgent?: string | null;
+}): readonly CliRunnerCandidate[];
+declare function createCleanCliEnv(baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 /** CLI 嗅探结果 */
 interface CliSniffResult {
   /** 是否存在全局 openspec 命令 */
@@ -1325,6 +1349,26 @@ declare function getDefaultCliCommand(): Promise<readonly string[]>;
  * 获取默认 CLI 命令的字符串形式（用于 UI 显示）
  */
 declare function getDefaultCliCommandString(): Promise<string>;
+declare const TerminalConfigSchema: z.ZodObject<{
+  fontSize: z.ZodDefault<z.ZodNumber>;
+  fontFamily: z.ZodDefault<z.ZodString>;
+  cursorBlink: z.ZodDefault<z.ZodBoolean>;
+  cursorStyle: z.ZodDefault<z.ZodEnum<["block", "underline", "bar"]>>;
+  scrollback: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  fontSize: number;
+  fontFamily: string;
+  cursorBlink: boolean;
+  cursorStyle: "block" | "underline" | "bar";
+  scrollback: number;
+}, {
+  fontSize?: number | undefined;
+  fontFamily?: string | undefined;
+  cursorBlink?: boolean | undefined;
+  cursorStyle?: "block" | "underline" | "bar" | undefined;
+  scrollback?: number | undefined;
+}>;
+type TerminalConfig = z.infer<typeof TerminalConfigSchema>;
 /**
  * OpenSpecUI 配置 Schema
  *
@@ -1335,36 +1379,73 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   cli: z.ZodDefault<z.ZodObject<{
     /** CLI 命令前缀 */
     command: z.ZodOptional<z.ZodString>;
+    /** CLI 命令参数 */
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
   }, "strip", z.ZodTypeAny, {
     command?: string | undefined;
+    args?: string[] | undefined;
   }, {
     command?: string | undefined;
+    args?: string[] | undefined;
   }>>;
-  /** UI 配置 */
-  ui: z.ZodDefault<z.ZodObject<{
-    /** 主题 */
-    theme: z.ZodDefault<z.ZodEnum<["light", "dark", "system"]>>;
+  /** 主题 */
+  theme: z.ZodDefault<z.ZodEnum<["light", "dark", "system"]>>;
+  /** 终端配置 */
+  terminal: z.ZodDefault<z.ZodObject<{
+    fontSize: z.ZodDefault<z.ZodNumber>;
+    fontFamily: z.ZodDefault<z.ZodString>;
+    cursorBlink: z.ZodDefault<z.ZodBoolean>;
+    cursorStyle: z.ZodDefault<z.ZodEnum<["block", "underline", "bar"]>>;
+    scrollback: z.ZodDefault<z.ZodNumber>;
   }, "strip", z.ZodTypeAny, {
-    theme: "light" | "dark" | "system";
+    fontSize: number;
+    fontFamily: string;
+    cursorBlink: boolean;
+    cursorStyle: "block" | "underline" | "bar";
+    scrollback: number;
   }, {
-    theme?: "light" | "dark" | "system" | undefined;
+    fontSize?: number | undefined;
+    fontFamily?: string | undefined;
+    cursorBlink?: boolean | undefined;
+    cursorStyle?: "block" | "underline" | "bar" | undefined;
+    scrollback?: number | undefined;
   }>>;
 }, "strip", z.ZodTypeAny, {
   cli: {
     command?: string | undefined;
+    args?: string[] | undefined;
   };
-  ui: {
-    theme: "light" | "dark" | "system";
+  theme: "light" | "dark" | "system";
+  terminal: {
+    fontSize: number;
+    fontFamily: string;
+    cursorBlink: boolean;
+    cursorStyle: "block" | "underline" | "bar";
+    scrollback: number;
   };
 }, {
   cli?: {
     command?: string | undefined;
+    args?: string[] | undefined;
   } | undefined;
-  ui?: {
-    theme?: "light" | "dark" | "system" | undefined;
+  theme?: "light" | "dark" | "system" | undefined;
+  terminal?: {
+    fontSize?: number | undefined;
+    fontFamily?: string | undefined;
+    cursorBlink?: boolean | undefined;
+    cursorStyle?: "block" | "underline" | "bar" | undefined;
+    scrollback?: number | undefined;
   } | undefined;
 }>;
 type OpenSpecUIConfig = z.infer<typeof OpenSpecUIConfigSchema>;
+type OpenSpecUIConfigUpdate = {
+  cli?: {
+    command?: string | null;
+    args?: string[] | null;
+  };
+  theme?: OpenSpecUIConfig['theme'];
+  terminal?: Partial<TerminalConfig>;
+};
 /** 默认配置（静态，用于测试和类型） */
 declare const DEFAULT_CONFIG: OpenSpecUIConfig;
 /**
@@ -1375,6 +1456,9 @@ declare const DEFAULT_CONFIG: OpenSpecUIConfig;
  */
 declare class ConfigManager {
   private configPath;
+  private projectDir;
+  private resolvedRunner;
+  private resolvingRunnerPromise;
   constructor(projectDir: string);
   /**
    * 读取配置（响应式）
@@ -1388,23 +1472,41 @@ declare class ConfigManager {
    *
    * 会触发文件监听，自动更新订阅者。
    */
-  writeConfig(config: Partial<OpenSpecUIConfig>): Promise<void>;
+  writeConfig(config: OpenSpecUIConfigUpdate): Promise<void>;
+  /**
+   * 解析并缓存可用 CLI runner。
+   */
+  private resolveCliRunner;
+  private resolveCliRunnerUncached;
   /**
    * 获取 CLI 命令（数组形式）
-   *
-   * 优先级：配置文件 > 全局 openspec 命令 > npx fallback
-   *
-   * @returns CLI 命令数组，如 `['openspec']` 或 `['npx', '@fission-ai/openspec']`
    */
   getCliCommand(): Promise<readonly string[]>;
   /**
    * 获取 CLI 命令的字符串形式（用于 UI 显示）
    */
   getCliCommandString(): Promise<string>;
+  /**
+   * 获取 CLI 解析结果（用于诊断）
+   */
+  getResolvedCliRunner(): Promise<ResolvedCliRunner>;
+  /**
+   * 清理 CLI 解析缓存（用于 ENOENT 自愈）
+   */
+  invalidateResolvedCliRunner(): void;
   /**
    * 设置 CLI 命令
    */
   setCliCommand(command: string): Promise<void>;
+  private getConfiguredCommandParts;
+  /**
+   * 设置主题
+   */
+  setTheme(theme: OpenSpecUIConfig['theme']): Promise<void>;
+  /**
+   * 设置终端配置（部分更新）
+   */
+  setTerminalConfig(terminal: Partial<TerminalConfig>): Promise<void>;
 }
 //#endregion
 //#region src/cli-executor.d.ts
@@ -1424,48 +1526,26 @@ interface CliStreamEvent {
 /**
  * CLI 执行器
  *
- * 负责调用外部 openspec CLI 命令。
- * 命令前缀从 ConfigManager 获取，支持：
- * - ['npx', '@fission-ai/openspec'] (默认)
- * - ['openspec'] (全局安装)
- * - 自定义数组或字符串
- *
- * 注意：所有命令都使用 shell: false 执行，避免 shell 注入风险
+ * 负责调用外部 openspec CLI 命令，统一通过 ConfigManager 的 runner 解析结果执行。
+ * 所有命令都使用 shell: false，避免 shell 注入风险。
  */
 declare class CliExecutor {
   private configManager;
   private projectDir;
   constructor(configManager: ConfigManager, projectDir: string);
-  /**
-   * 创建干净的环境变量，移除 pnpm 特有的配置
-   * 避免 pnpm 环境变量污染 npx/npm 执行
-   */
-  private getCleanEnv;
-  /**
-   * 构建完整命令数组
-   *
-   * @param args CLI 参数，如 ['init'] 或 ['archive', 'change-id']
-   * @returns [command, ...commandArgs, ...args]
-   */
   private buildCommandArray;
+  private runCommandOnce;
+  private executeInternal;
   /**
    * 执行 CLI 命令
-   *
-   * @param args CLI 参数，如 ['init'] 或 ['archive', 'change-id']
-   * @returns 执行结果
    */
   execute(args: string[]): Promise<CliResult>;
   /**
    * 执行 openspec init（非交互式）
-   *
-   * @param tools 工具列表，如 ['claude', 'cursor'] 或 'all' 或 'none'
    */
   init(tools?: string[] | 'all' | 'none'): Promise<CliResult>;
   /**
    * 执行 openspec archive <changeId>（非交互式）
-   *
-   * @param changeId 要归档的 change ID
-   * @param options 选项
    */
   archive(changeId: string, options?: {
     skipSpecs?: boolean;
@@ -1493,19 +1573,16 @@ declare class CliExecutor {
   validateStream(type: 'spec' | 'change' | undefined, id: string | undefined, onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
   /**
    * 检查 CLI 是否可用
-   * @param timeout 超时时间（毫秒），默认 10 秒
    */
   checkAvailability(timeout?: number): Promise<{
     available: boolean;
     version?: string;
     error?: string;
+    effectiveCommand?: string;
+    tried?: string[];
   }>;
   /**
    * 流式执行 CLI 命令
-   *
-   * @param args CLI 参数
-   * @param onEvent 事件回调
-   * @returns 取消函数
    */
   executeStream(args: string[], onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
   /**
@@ -1521,13 +1598,6 @@ declare class CliExecutor {
   }, onEvent: (event: CliStreamEvent) => void): Promise<() => void>;
   /**
    * 流式执行任意命令（数组形式）
-   *
-   * 用于执行不需要 openspec CLI 前缀的命令，如 npm install。
-   * 使用 shell: false 避免 shell 注入风险。
-   *
-   * @param command 命令数组，如 ['npm', 'install', '-g', '@fission-ai/openspec']
-   * @param onEvent 事件回调
-   * @returns 取消函数
    */
   executeCommandStream(command: readonly string[], onEvent: (event: CliStreamEvent) => void): () => void;
 }
@@ -1603,14 +1673,14 @@ declare const ArtifactStatusSchema: z.ZodObject<{
   missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
   relativePath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  status: "done" | "ready" | "blocked";
   id: string;
+  status: "done" | "ready" | "blocked";
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
 }, {
-  status: "done" | "ready" | "blocked";
   id: string;
+  status: "done" | "ready" | "blocked";
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
@@ -1628,14 +1698,14 @@ declare const ChangeStatusSchema: z.ZodObject<{
     missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relativePath: z.ZodOptional<z.ZodString>;
   }, "strip", z.ZodTypeAny, {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
   }, {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1646,8 +1716,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1658,8 +1728,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1672,13 +1742,13 @@ declare const DependencyInfoSchema: z.ZodObject<{
   path: z.ZodString;
   description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   id: string;
+  path: string;
   description: string;
   done: boolean;
 }, {
-  path: string;
   id: string;
+  path: string;
   description: string;
   done: boolean;
 }>;
@@ -1786,13 +1856,13 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
     path: z.ZodString;
     description: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }, {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }>, "many">;
@@ -1806,8 +1876,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -1824,8 +1894,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -1867,16 +1937,16 @@ declare const SchemaResolutionSchema: z.ZodObject<{
     source: "project" | "user" | "package";
   }>, "many">;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   name: string;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
     source: "project" | "user" | "package";
   }[];
 }, {
-  path: string;
   name: string;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2174,20 +2244,20 @@ declare const PtySessionInfoSchema: z.ZodObject<{
   isExited: z.ZodBoolean;
   exitCode: z.ZodNullable<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
-  id: string;
   isExited: boolean;
 }, {
+  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
-  id: string;
   isExited: boolean;
 }>;
 declare const PtyCreateMessageSchema: z.ZodObject<{
@@ -2432,42 +2502,42 @@ declare const PtyListResponseSchema: z.ZodObject<{
     isExited: z.ZodBoolean;
     exitCode: z.ZodNullable<z.ZodNumber>;
   }, "strip", z.ZodTypeAny, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }>, "many">;
 }, "strip", z.ZodTypeAny, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }[];
 }, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }[];
 }>;
@@ -2478,14 +2548,14 @@ declare const PtyErrorResponseSchema: z.ZodObject<{
   message: z.ZodString;
   sessionId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }>;
 declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -2562,42 +2632,42 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     isExited: z.ZodBoolean;
     exitCode: z.ZodNullable<z.ZodNumber>;
   }, "strip", z.ZodTypeAny, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }>, "many">;
 }, "strip", z.ZodTypeAny, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }[];
 }, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
   }[];
 }>, z.ZodObject<{
@@ -2606,14 +2676,14 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
   message: z.ZodString;
   sessionId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }>]>;
 type PtyClientMessage = z.infer<typeof PtyClientMessageSchema>;
@@ -2621,4 +2691,4 @@ type PtyServerMessage = z.infer<typeof PtyServerMessageSchema>;
 type PtySessionInfo = z.infer<typeof PtySessionInfoSchema>;
 type PtyPlatform = z.infer<typeof PtyPlatformSchema>;
 //#endregion
-export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliSniffResult, type CliStreamEvent, ConfigManager, DEFAULT_CONFIG, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, MarkdownParser, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxKernel, type PathCallback, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type Requirement, RequirementSchema, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, type Spec, type SpecMeta, SpecSchema, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type ToolConfig, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, acquireWatcher, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, initWatcherPool, isGlobPattern, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli };
+export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, ConfigManager, DEFAULT_CONFIG, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, MarkdownParser, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type Requirement, RequirementSchema, type ResolvedCliRunner, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, type Spec, type SpecMeta, SpecSchema, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type ToolConfig, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, initWatcherPool, isGlobPattern, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli };