@openspecui/core 3.0.0 → 3.1.0

package/dist/hosted-app-B6b6fAYZ.d.mts

@@ -0,0 +1,31 @@
+//#region src/hosted-app.d.ts
+declare const OFFICIAL_APP_BASE_URL = "https://app.openspecui.com";
+declare const HOSTED_SHELL_PROTOCOL_VERSION = 1;
+interface HostedBackendHealthResponse {
+  status: 'ok';
+  projectDir: string;
+  projectName: string;
+  watcherEnabled: boolean;
+  openspecuiVersion: string;
+  hostedShellProtocolVersion: typeof HOSTED_SHELL_PROTOCOL_VERSION;
+  embeddedUiUrl: string;
+}
+declare function normalizeHostedAppBaseUrl(input: string): string;
+declare function resolveHostedAppBaseUrl(options: {
+  override?: string | null;
+  configured?: string | null;
+}): string;
+declare function normalizeEmbeddedUiUrl(input: string): string;
+declare function isSupportedEmbeddedUiUrl(input: string): boolean;
+declare function buildHostedLaunchUrl(options: {
+  baseUrl: string;
+  apiBaseUrl: string;
+}): string;
+declare function buildEmbeddedUiLaunchUrl(options: {
+  embeddedUiUrl: string;
+  apiBaseUrl: string;
+  sessionId: string;
+}): string;
+declare function isHostedBackendHealthResponse(value: unknown): value is HostedBackendHealthResponse;
+//#endregion
+export { buildHostedLaunchUrl as a, normalizeEmbeddedUiUrl as c, buildEmbeddedUiLaunchUrl as i, normalizeHostedAppBaseUrl as l, HostedBackendHealthResponse as n, isHostedBackendHealthResponse as o, OFFICIAL_APP_BASE_URL as r, isSupportedEmbeddedUiUrl as s, HOSTED_SHELL_PROTOCOL_VERSION as t, resolveHostedAppBaseUrl as u };

package/dist/hosted-app-RXZDSUtU.mjs

@@ -0,0 +1,74 @@
+//#region src/hosted-app.ts
+const OFFICIAL_APP_BASE_URL = "https://app.openspecui.com";
+const HOSTED_SHELL_PROTOCOL_VERSION = 1;
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function withHttpsProtocol(value) {
+	if (/^[a-zA-Z][a-zA-Z\d+.-]*:\/\//.test(value)) return value;
+	return `https://${value}`;
+}
+function normalizeHostedAppBaseUrl(input) {
+	const trimmed = input.trim();
+	if (!trimmed) throw new Error("Hosted app base URL must not be empty");
+	let parsed;
+	try {
+		parsed = new URL(withHttpsProtocol(trimmed));
+	} catch (error) {
+		throw new Error(`Invalid hosted app base URL: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	parsed.hash = "";
+	parsed.search = "";
+	const pathname = parsed.pathname.replace(/\/+$/, "");
+	parsed.pathname = pathname.length > 0 ? pathname : "/";
+	return parsed.toString().replace(/\/$/, parsed.pathname === "/" ? "" : "");
+}
+function resolveHostedAppBaseUrl(options) {
+	return normalizeHostedAppBaseUrl(options.override?.trim() || options.configured?.trim() || OFFICIAL_APP_BASE_URL);
+}
+function normalizeEmbeddedUiUrl(input) {
+	const trimmed = input.trim();
+	if (!trimmed) throw new Error("Embedded UI URL must not be empty");
+	let parsed;
+	try {
+		parsed = new URL(trimmed);
+	} catch (error) {
+		throw new Error(`Invalid embedded UI URL: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	parsed.hash = "";
+	const pathname = parsed.pathname.replace(/\/+$/, "");
+	parsed.pathname = pathname.length > 0 ? pathname : "/";
+	return parsed.toString().replace(/\/$/, parsed.pathname === "/" ? "" : "");
+}
+function isLoopbackHostname(hostname) {
+	const normalized = hostname.toLowerCase();
+	return normalized === "localhost" || normalized === "127.0.0.1" || normalized === "[::1]" || normalized.endsWith(".localhost");
+}
+function isSupportedEmbeddedUiUrl(input) {
+	let parsed;
+	try {
+		parsed = new URL(input);
+	} catch {
+		return false;
+	}
+	if (parsed.protocol === "https:") return true;
+	return parsed.protocol === "http:" && isLoopbackHostname(parsed.hostname);
+}
+function buildHostedLaunchUrl(options) {
+	const url = new URL(normalizeHostedAppBaseUrl(options.baseUrl));
+	url.searchParams.set("api", options.apiBaseUrl);
+	return url.toString();
+}
+function buildEmbeddedUiLaunchUrl(options) {
+	const url = new URL(normalizeEmbeddedUiUrl(options.embeddedUiUrl));
+	url.searchParams.set("api", options.apiBaseUrl);
+	url.searchParams.set("session", options.sessionId);
+	return url.toString();
+}
+function isHostedBackendHealthResponse(value) {
+	if (!isRecord(value)) return false;
+	return value.status === "ok" && typeof value.projectDir === "string" && typeof value.projectName === "string" && typeof value.watcherEnabled === "boolean" && typeof value.openspecuiVersion === "string" && value.hostedShellProtocolVersion === HOSTED_SHELL_PROTOCOL_VERSION && typeof value.embeddedUiUrl === "string" && isSupportedEmbeddedUiUrl(value.embeddedUiUrl);
+}
+
+//#endregion
+export { isHostedBackendHealthResponse as a, normalizeHostedAppBaseUrl as c, buildHostedLaunchUrl as i, resolveHostedAppBaseUrl as l, OFFICIAL_APP_BASE_URL as n, isSupportedEmbeddedUiUrl as o, buildEmbeddedUiLaunchUrl as r, normalizeEmbeddedUiUrl as s, HOSTED_SHELL_PROTOCOL_VERSION as t };

package/dist/hosted-app.d.mts

@@ -1,2 +1,2 @@
-import { a as HostedBackendHealthResponse, c as buildHostedVersionManifestUrl, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as HostedAppVersionManifest, l as isHostedAppVersionManifest, n as HostedAppChannelManifest, o as OFFICIAL_APP_BASE_URL, p as resolveHostedChannelForVersion, r as HostedAppCompatibilityEntry, s as buildHostedLaunchUrl, t as HostedAppChannelKind, u as isHostedBackendHealthResponse } from "./hosted-app-Dy4D7wV9.mjs";
-export { HostedAppChannelKind, HostedAppChannelManifest, HostedAppCompatibilityEntry, HostedAppVersionManifest, HostedBackendHealthResponse, OFFICIAL_APP_BASE_URL, buildHostedLaunchUrl, buildHostedVersionManifestUrl, isHostedAppVersionManifest, isHostedBackendHealthResponse, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl, resolveHostedChannelForVersion };
+import { a as buildHostedLaunchUrl, c as normalizeEmbeddedUiUrl, i as buildEmbeddedUiLaunchUrl, l as normalizeHostedAppBaseUrl, n as HostedBackendHealthResponse, o as isHostedBackendHealthResponse, r as OFFICIAL_APP_BASE_URL, s as isSupportedEmbeddedUiUrl, t as HOSTED_SHELL_PROTOCOL_VERSION, u as resolveHostedAppBaseUrl } from "./hosted-app-B6b6fAYZ.mjs";
+export { HOSTED_SHELL_PROTOCOL_VERSION, HostedBackendHealthResponse, OFFICIAL_APP_BASE_URL, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl };

package/dist/hosted-app.mjs

@@ -1,3 +1,3 @@
-import { a as isHostedBackendHealthResponse, c as resolveHostedChannelForVersion, i as isHostedAppVersionManifest, n as buildHostedLaunchUrl, o as normalizeHostedAppBaseUrl, r as buildHostedVersionManifestUrl, s as resolveHostedAppBaseUrl, t as OFFICIAL_APP_BASE_URL } from "./hosted-app-Bv10mEdq.mjs";
+import { a as isHostedBackendHealthResponse, c as normalizeHostedAppBaseUrl, i as buildHostedLaunchUrl, l as resolveHostedAppBaseUrl, n as OFFICIAL_APP_BASE_URL, o as isSupportedEmbeddedUiUrl, r as buildEmbeddedUiLaunchUrl, s as normalizeEmbeddedUiUrl, t as HOSTED_SHELL_PROTOCOL_VERSION } from "./hosted-app-RXZDSUtU.mjs";
 
-export { OFFICIAL_APP_BASE_URL, buildHostedLaunchUrl, buildHostedVersionManifestUrl, isHostedAppVersionManifest, isHostedBackendHealthResponse, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl, resolveHostedChannelForVersion };
+export { HOSTED_SHELL_PROTOCOL_VERSION, OFFICIAL_APP_BASE_URL, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as HostedBackendHealthResponse, c as buildHostedVersionManifestUrl, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as HostedAppVersionManifest, l as isHostedAppVersionManifest, n as HostedAppChannelManifest, o as OFFICIAL_APP_BASE_URL, p as resolveHostedChannelForVersion, r as HostedAppCompatibilityEntry, s as buildHostedLaunchUrl, t as HostedAppChannelKind, u as isHostedBackendHealthResponse } from "./hosted-app-Dy4D7wV9.mjs";
+import { a as buildHostedLaunchUrl, c as normalizeEmbeddedUiUrl, i as buildEmbeddedUiLaunchUrl, l as normalizeHostedAppBaseUrl, n as HostedBackendHealthResponse, o as isHostedBackendHealthResponse, r as OFFICIAL_APP_BASE_URL, s as isSupportedEmbeddedUiUrl, t as HOSTED_SHELL_PROTOCOL_VERSION, u as resolveHostedAppBaseUrl } from "./hosted-app-B6b6fAYZ.mjs";
 import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-C1H1ryBL.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
@@ -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: "compose" | "command";
+}, {
+  agentInvocationMode?: "compose" | "command" | 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: "compose" | "command";
+  }, {
+    agentInvocationMode?: "compose" | "command" | 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: "compose" | "command";
+  };
   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?: "compose" | "command" | 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>;
@@ -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, HOSTED_SHELL_PROTOCOL_VERSION, 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, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as isHostedBackendHealthResponse, c as resolveHostedChannelForVersion, i as isHostedAppVersionManifest, n as buildHostedLaunchUrl, o as normalizeHostedAppBaseUrl, r as buildHostedVersionManifestUrl, s as resolveHostedAppBaseUrl, t as OFFICIAL_APP_BASE_URL } from "./hosted-app-Bv10mEdq.mjs";
+import { a as isHostedBackendHealthResponse, c as normalizeHostedAppBaseUrl, i as buildHostedLaunchUrl, l as resolveHostedAppBaseUrl, n as OFFICIAL_APP_BASE_URL, o as isSupportedEmbeddedUiUrl, r as buildEmbeddedUiLaunchUrl, s as normalizeEmbeddedUiUrl, t as HOSTED_SHELL_PROTOCOL_VERSION } from "./hosted-app-RXZDSUtU.mjs";
 import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-Cja3Bt1P.mjs";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
@@ -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, HOSTED_SHELL_PROTOCOL_VERSION, 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, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/package.json

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

package/dist/hosted-app-Bv10mEdq.mjs

@@ -1,86 +0,0 @@
-//#region src/hosted-app.ts
-const OFFICIAL_APP_BASE_URL = "https://app.openspecui.com";
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function withHttpsProtocol(value) {
-	if (/^[a-zA-Z][a-zA-Z\d+.-]*:\/\//.test(value)) return value;
-	return `https://${value}`;
-}
-function parseVersionTuple(raw) {
-	const match = raw.trim().match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
-	if (!match) return null;
-	return {
-		major: Number(match[1]),
-		minor: Number(match[2]),
-		patch: Number(match[3])
-	};
-}
-function parseCompatibilityRange(range) {
-	const match = range.trim().match(/^~(\d+)\.(\d+)\.\d+$/);
-	if (!match) return null;
-	return {
-		major: Number(match[1]),
-		minor: Number(match[2])
-	};
-}
-function normalizeHostedAppBaseUrl(input) {
-	const trimmed = input.trim();
-	if (!trimmed) throw new Error("Hosted app base URL must not be empty");
-	let parsed;
-	try {
-		parsed = new URL(withHttpsProtocol(trimmed));
-	} catch (error) {
-		throw new Error(`Invalid hosted app base URL: ${error instanceof Error ? error.message : String(error)}`);
-	}
-	parsed.hash = "";
-	parsed.search = "";
-	const pathname = parsed.pathname.replace(/\/+$/, "");
-	parsed.pathname = pathname.length > 0 ? pathname : "/";
-	return parsed.toString().replace(/\/$/, parsed.pathname === "/" ? "" : "");
-}
-function resolveHostedAppBaseUrl(options) {
-	return normalizeHostedAppBaseUrl(options.override?.trim() || options.configured?.trim() || OFFICIAL_APP_BASE_URL);
-}
-function buildHostedVersionManifestUrl(baseUrl) {
-	return `${normalizeHostedAppBaseUrl(baseUrl)}/version.json`;
-}
-function buildHostedLaunchUrl(options) {
-	const url = new URL(normalizeHostedAppBaseUrl(options.baseUrl));
-	url.searchParams.set("api", options.apiBaseUrl);
-	return url.toString();
-}
-function isHostedAppVersionManifest(value) {
-	if (!isRecord(value)) return false;
-	if (value.packageName !== "openspecui") return false;
-	if (typeof value.generatedAt !== "string") return false;
-	if (typeof value.defaultChannel !== "string") return false;
-	if (!isRecord(value.channels)) return false;
-	if (!Array.isArray(value.compatibility)) return false;
-	return Object.values(value.channels).every((channel) => {
-		if (!isRecord(channel)) return false;
-		return typeof channel.id === "string" && typeof channel.kind === "string" && typeof channel.selector === "string" && typeof channel.resolvedVersion === "string" && typeof channel.rootPath === "string" && typeof channel.shellPath === "string" && typeof channel.major === "number";
-	});
-}
-function isHostedBackendHealthResponse(value) {
-	if (!isRecord(value)) return false;
-	return value.status === "ok" && typeof value.projectDir === "string" && typeof value.projectName === "string" && typeof value.watcherEnabled === "boolean" && typeof value.openspecuiVersion === "string";
-}
-function resolveHostedChannelForVersion(manifest, version) {
-	const parsed = parseVersionTuple(version);
-	if (!parsed) return null;
-	for (const entry of manifest.compatibility) {
-		const range = parseCompatibilityRange(entry.range);
-		if (!range) continue;
-		if (!manifest.channels[entry.channel]) continue;
-		if (range.major === parsed.major && range.minor === parsed.minor) return entry.channel;
-	}
-	const exactMinorChannel = `v${parsed.major}.${parsed.minor}`;
-	if (manifest.channels[exactMinorChannel]) return exactMinorChannel;
-	const majorChannel = `v${parsed.major}`;
-	if (manifest.channels[majorChannel]) return majorChannel;
-	return manifest.channels[manifest.defaultChannel] ? manifest.defaultChannel : null;
-}
-
-//#endregion
-export { isHostedBackendHealthResponse as a, resolveHostedChannelForVersion as c, isHostedAppVersionManifest as i, buildHostedLaunchUrl as n, normalizeHostedAppBaseUrl as o, buildHostedVersionManifestUrl as r, resolveHostedAppBaseUrl as s, OFFICIAL_APP_BASE_URL as t };

package/dist/hosted-app-Dy4D7wV9.d.mts

@@ -1,46 +0,0 @@
-//#region src/hosted-app.d.ts
-declare const OFFICIAL_APP_BASE_URL = "https://app.openspecui.com";
-type HostedAppChannelKind = 'latest' | 'major' | 'minor';
-interface HostedAppChannelManifest {
-  id: string;
-  kind: HostedAppChannelKind;
-  selector: string;
-  resolvedVersion: string;
-  rootPath: string;
-  shellPath: string;
-  major: number;
-  minor?: number;
-}
-interface HostedAppCompatibilityEntry {
-  range: string;
-  channel: string;
-}
-interface HostedAppVersionManifest {
-  packageName: 'openspecui';
-  generatedAt: string;
-  defaultChannel: string;
-  channels: Record<string, HostedAppChannelManifest>;
-  compatibility: HostedAppCompatibilityEntry[];
-}
-interface HostedBackendHealthResponse {
-  status: 'ok';
-  projectDir: string;
-  projectName: string;
-  watcherEnabled: boolean;
-  openspecuiVersion: string;
-}
-declare function normalizeHostedAppBaseUrl(input: string): string;
-declare function resolveHostedAppBaseUrl(options: {
-  override?: string | null;
-  configured?: string | null;
-}): string;
-declare function buildHostedVersionManifestUrl(baseUrl: string): string;
-declare function buildHostedLaunchUrl(options: {
-  baseUrl: string;
-  apiBaseUrl: string;
-}): string;
-declare function isHostedAppVersionManifest(value: unknown): value is HostedAppVersionManifest;
-declare function isHostedBackendHealthResponse(value: unknown): value is HostedBackendHealthResponse;
-declare function resolveHostedChannelForVersion(manifest: HostedAppVersionManifest, version: string): string | null;
-//#endregion
-export { HostedBackendHealthResponse as a, buildHostedVersionManifestUrl as c, normalizeHostedAppBaseUrl as d, resolveHostedAppBaseUrl as f, HostedAppVersionManifest as i, isHostedAppVersionManifest as l, HostedAppChannelManifest as n, OFFICIAL_APP_BASE_URL as o, resolveHostedChannelForVersion as p, HostedAppCompatibilityEntry as r, buildHostedLaunchUrl as s, HostedAppChannelKind as t, isHostedBackendHealthResponse as u };