@openspecui/core 3.0.0 → 3.0.1

package/dist/index.d.mts

@@ -19,13 +19,13 @@ declare const ChangeFileSchema: z.ZodObject<{
   /** Optional byte size for files */
   size: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   type: "file" | "directory";
+  path: string;
   content?: string | undefined;
   size?: number | undefined;
 }, {
-  path: string;
   type: "file" | "directory";
+  path: string;
   content?: string | undefined;
   size?: number | undefined;
 }>;
@@ -1326,8 +1326,11 @@ declare function createFileChangeObservable(watcher: OpenSpecWatcher): {
 //#endregion
 //#region src/config.d.ts
 declare const CODE_EDITOR_THEME_VALUES: readonly ["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"];
+declare const OPSX_AGENT_INVOCATION_MODE_VALUES: readonly ["compose", "command"];
 declare const TerminalRendererEngineSchema: z.ZodEnum<["xterm", "ghostty"]>;
 type TerminalRendererEngine = z.infer<typeof TerminalRendererEngineSchema>;
+declare const OpsxAgentInvocationModeSchema: z.ZodEnum<["compose", "command"]>;
+type OpsxAgentInvocationMode = z.infer<typeof OpsxAgentInvocationModeSchema>;
 declare const CodeEditorThemeSchema: z.ZodEnum<["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"]>;
 type CodeEditorTheme = z.infer<typeof CodeEditorThemeSchema>;
 declare function isTerminalRendererEngine(value: string): value is TerminalRendererEngine;
@@ -1436,6 +1439,14 @@ declare const GitConfigSchema: z.ZodObject<{
   diffEagerLineBudget?: number | undefined;
 }>;
 type GitConfig = z.infer<typeof GitConfigSchema>;
+declare const OpsxConfigSchema: z.ZodObject<{
+  agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
+}, "strip", z.ZodTypeAny, {
+  agentInvocationMode: "command" | "compose";
+}, {
+  agentInvocationMode?: "command" | "compose" | undefined;
+}>;
+type OpsxConfig = z.infer<typeof OpsxConfigSchema>;
 /**
  * OpenSpecUI 配置 Schema
  *
@@ -1467,6 +1478,14 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   }>>;
   /** Hosted app 基础 URL（空字符串表示使用官方默认值） */
   appBaseUrl: z.ZodDefault<z.ZodString>;
+  /** OPSX workflow invocation preferences */
+  opsx: z.ZodDefault<z.ZodObject<{
+    agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
+  }, "strip", z.ZodTypeAny, {
+    agentInvocationMode: "command" | "compose";
+  }, {
+    agentInvocationMode?: "command" | "compose" | undefined;
+  }>>;
   /** 终端配置 */
   terminal: z.ZodDefault<z.ZodObject<{
     fontSize: z.ZodDefault<z.ZodNumber>;
@@ -1516,6 +1535,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     theme: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord";
   };
   appBaseUrl: string;
+  opsx: {
+    agentInvocationMode: "command" | "compose";
+  };
   terminal: {
     fontSize: number;
     fontFamily: string;
@@ -1540,6 +1562,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     theme?: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord" | undefined;
   } | undefined;
   appBaseUrl?: string | undefined;
+  opsx?: {
+    agentInvocationMode?: "command" | "compose" | undefined;
+  } | undefined;
   terminal?: {
     fontSize?: number | undefined;
     fontFamily?: string | undefined;
@@ -1564,6 +1589,7 @@ type OpenSpecUIConfigUpdate = {
   theme?: OpenSpecUIConfig['theme'];
   codeEditor?: Partial<OpenSpecUIConfig['codeEditor']>;
   appBaseUrl?: OpenSpecUIConfig['appBaseUrl'];
+  opsx?: Partial<OpsxConfig>;
   terminal?: Partial<TerminalConfig>;
   dashboard?: Partial<DashboardConfig>;
   git?: Partial<GitConfig>;
@@ -1957,14 +1983,14 @@ declare const ArtifactStatusSchema: z.ZodObject<{
   missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
   relativePath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  id: string;
   status: "done" | "ready" | "blocked";
+  id: string;
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
 }, {
-  id: string;
   status: "done" | "ready" | "blocked";
+  id: string;
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
@@ -1982,14 +2008,14 @@ declare const ChangeStatusSchema: z.ZodObject<{
     missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relativePath: z.ZodOptional<z.ZodString>;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
   }, {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -2000,8 +2026,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -2012,8 +2038,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -2026,13 +2052,13 @@ declare const DependencyInfoSchema: z.ZodObject<{
   path: z.ZodString;
   description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  id: string;
   path: string;
+  id: string;
   description: string;
   done: boolean;
 }, {
-  id: string;
   path: string;
+  id: string;
   description: string;
   done: boolean;
 }>;
@@ -2141,13 +2167,13 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
     path: z.ZodString;
     description: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }, {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }>, "many">;
@@ -2161,8 +2187,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }[];
@@ -2179,8 +2205,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }[];
@@ -2226,8 +2252,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
     displayPath?: string | undefined;
   }>, "many">;
 }, "strip", z.ZodTypeAny, {
-  name: string;
   path: string;
+  name: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2236,8 +2262,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
   }[];
   displayPath?: string | undefined;
 }, {
-  name: string;
   path: string;
+  name: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2666,22 +2692,22 @@ declare const PtySessionInfoSchema: z.ZodObject<{
   closeTip: z.ZodOptional<z.ZodString>;
   closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
 }, "strip", z.ZodTypeAny, {
-  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
+  id: string;
   isExited: boolean;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
-  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
+  id: string;
   isExited: boolean;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2698,19 +2724,19 @@ declare const PtyCreateMessageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>;
@@ -2788,19 +2814,19 @@ declare const PtyClientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>, z.ZodObject<{
@@ -2942,22 +2968,22 @@ declare const PtyListResponseSchema: z.ZodObject<{
     closeTip: z.ZodOptional<z.ZodString>;
     closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
   }, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2965,12 +2991,12 @@ declare const PtyListResponseSchema: z.ZodObject<{
 }, "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;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2978,12 +3004,12 @@ declare const PtyListResponseSchema: z.ZodObject<{
 }, {
   type: "list";
   sessions: {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2996,14 +3022,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" | "PTY_CREATE_FAILED";
   message: string;
-  type: "error";
   sessionId?: string | undefined;
 }, {
+  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND" | "PTY_CREATE_FAILED";
   message: string;
-  type: "error";
   sessionId?: string | undefined;
 }>;
 declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -3082,22 +3108,22 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     closeTip: z.ZodOptional<z.ZodString>;
     closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
   }, {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3105,12 +3131,12 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "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;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3118,12 +3144,12 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, {
   type: "list";
   sessions: {
-    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
+    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -3134,14 +3160,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" | "PTY_CREATE_FAILED";
   message: string;
-  type: "error";
   sessionId?: string | undefined;
 }, {
+  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND" | "PTY_CREATE_FAILED";
   message: string;
-  type: "error";
   sessionId?: string | undefined;
 }>]>;
 type PtyClientMessage = z.infer<typeof PtyClientMessageSchema>;
@@ -3149,4 +3175,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, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, type DashboardCardAvailability, type DashboardConfig, DashboardConfigSchema, type DashboardGitCommitEntry, type DashboardGitDiffStats, type DashboardGitEntry, type DashboardGitSnapshot, type DashboardGitUncommittedEntry, type DashboardGitWorktree, type DashboardMetricKey, type DashboardOverview, type DashboardSummary, type DashboardTrendKind, type DashboardTrendMeta, type DashboardTrendPoint, type DashboardTriColorTrendPoint, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, type GitConfig, GitConfigSchema, type GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, type GitEntryFiles, type GitEntryPatch, type GitEntrySelector, type GitEntryShell, type GitFileChangeType, type GitPatchFile, type GitPatchState, type GitWorktreeHandoff, type GitWorktreeOverview, type GitWorktreeSummary, type HostedAppChannelKind, type HostedAppChannelManifest, type HostedAppCompatibilityEntry, type HostedAppVersionManifest, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, 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, TOOL_WORKFLOW_TO_SKILL_DIR, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };
+export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, type DashboardCardAvailability, type DashboardConfig, DashboardConfigSchema, type DashboardGitCommitEntry, type DashboardGitDiffStats, type DashboardGitEntry, type DashboardGitSnapshot, type DashboardGitUncommittedEntry, type DashboardGitWorktree, type DashboardMetricKey, type DashboardOverview, type DashboardSummary, type DashboardTrendKind, type DashboardTrendMeta, type DashboardTrendPoint, type DashboardTriColorTrendPoint, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, type GitConfig, GitConfigSchema, type GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, type GitEntryFiles, type GitEntryPatch, type GitEntrySelector, type GitEntryShell, type GitFileChangeType, type GitPatchFile, type GitPatchState, type GitWorktreeHandoff, type GitWorktreeOverview, type GitWorktreeSummary, type HostedAppChannelKind, type HostedAppChannelManifest, type HostedAppCompatibilityEntry, type HostedAppVersionManifest, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, type OpsxAgentInvocationMode, OpsxAgentInvocationModeSchema, type OpsxConfig, OpsxConfigSchema, OpsxKernel, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, 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, TOOL_WORKFLOW_TO_SKILL_DIR, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/dist/index.mjs

@@ -2117,7 +2117,9 @@ const CODE_EDITOR_THEME_VALUES = [
 	"nord"
 ];
 const TERMINAL_RENDERER_ENGINE_VALUES = ["xterm", "ghostty"];
+const OPSX_AGENT_INVOCATION_MODE_VALUES = ["compose", "command"];
 const TerminalRendererEngineSchema = z.enum(TERMINAL_RENDERER_ENGINE_VALUES);
+const OpsxAgentInvocationModeSchema = z.enum(OPSX_AGENT_INVOCATION_MODE_VALUES);
 const CodeEditorThemeSchema = z.enum(CODE_EDITOR_THEME_VALUES);
 function isTerminalRendererEngine(value) {
 	return TERMINAL_RENDERER_ENGINE_VALUES.includes(value);
@@ -2495,6 +2497,7 @@ const DashboardConfigSchema = z.object({ trendPointLimit: z.number().int().min(2
 const DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET = 1e3;
 const GitConfigSchema = z.object({ diffEagerLineBudget: z.number().int().min(0).max(2e5).default(DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET) });
 const CodeEditorConfigSchema = z.object({ theme: CodeEditorThemeSchema.default("github") });
+const OpsxConfigSchema = z.object({ agentInvocationMode: OpsxAgentInvocationModeSchema.default("compose") });
 /**
 * OpenSpecUI 配置 Schema
 *
@@ -2508,6 +2511,7 @@ const OpenSpecUIConfigSchema = z.object({
 	theme: z.enum(THEME_VALUES).default("system"),
 	codeEditor: CodeEditorConfigSchema.default(CodeEditorConfigSchema.parse({})),
 	appBaseUrl: z.string().default(""),
+	opsx: OpsxConfigSchema.default(OpsxConfigSchema.parse({})),
 	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
 	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({})),
 	git: GitConfigSchema.default(GitConfigSchema.parse({}))
@@ -2518,6 +2522,7 @@ const DEFAULT_CONFIG = {
 	theme: "system",
 	codeEditor: CodeEditorConfigSchema.parse({}),
 	appBaseUrl: "",
+	opsx: OpsxConfigSchema.parse({}),
 	terminal: TerminalConfigSchema.parse({}),
 	dashboard: DashboardConfigSchema.parse({}),
 	git: GitConfigSchema.parse({})
@@ -2560,6 +2565,9 @@ function toPersistedConfig(config, options = {}) {
 	if (config.codeEditor.theme !== DEFAULT_CONFIG.codeEditor.theme) codeEditor.theme = config.codeEditor.theme;
 	if (hasOwnEntries(codeEditor)) persisted.codeEditor = codeEditor;
 	if (config.appBaseUrl !== DEFAULT_CONFIG.appBaseUrl) persisted.appBaseUrl = config.appBaseUrl;
+	const opsx = {};
+	if (config.opsx.agentInvocationMode !== DEFAULT_CONFIG.opsx.agentInvocationMode) opsx.agentInvocationMode = config.opsx.agentInvocationMode;
+	if (hasOwnEntries(opsx)) persisted.opsx = opsx;
 	const terminal = {};
 	if (config.terminal.fontSize !== DEFAULT_CONFIG.terminal.fontSize) terminal.fontSize = config.terminal.fontSize;
 	if (config.terminal.fontFamily !== DEFAULT_CONFIG.terminal.fontFamily) terminal.fontFamily = config.terminal.fontFamily;
@@ -2653,6 +2661,10 @@ var ConfigManager = class {
 				...config.codeEditor
 			},
 			appBaseUrl: config.appBaseUrl ?? current.appBaseUrl,
+			opsx: {
+				...current.opsx,
+				...config.opsx
+			},
 			terminal: {
 				...current.terminal,
 				...config.terminal
@@ -4575,4 +4587,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, GitConfigSchema, MarkdownParser, OFFICIAL_APP_BASE_URL, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TOOL_WORKFLOW_TO_SKILL_DIR, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };
+export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, GitConfigSchema, MarkdownParser, OFFICIAL_APP_BASE_URL, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TOOL_WORKFLOW_TO_SKILL_DIR, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",