@openspecui/core 2.0.0 → 2.1.0

package/dist/hosted-app-Bn-MNDZ0.mjs

@@ -0,0 +1,86 @@
+//#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-CY1XHUcf.d.mts

@@ -0,0 +1,46 @@
+//#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 };

package/dist/hosted-app.d.mts

@@ -0,0 +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-CY1XHUcf.mjs";
+export { HostedAppChannelKind, HostedAppChannelManifest, HostedAppCompatibilityEntry, HostedAppVersionManifest, HostedBackendHealthResponse, OFFICIAL_APP_BASE_URL, buildHostedLaunchUrl, buildHostedVersionManifestUrl, isHostedAppVersionManifest, isHostedBackendHealthResponse, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl, resolveHostedChannelForVersion };

package/dist/hosted-app.mjs

@@ -0,0 +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-Bn-MNDZ0.mjs";
+
+export { OFFICIAL_APP_BASE_URL, buildHostedLaunchUrl, buildHostedVersionManifestUrl, isHostedAppVersionManifest, isHostedBackendHealthResponse, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl, resolveHostedChannelForVersion };

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-RBULE8_G.mjs";
+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-CY1XHUcf.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-k65bc8bW.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
 import { EventEmitter } from "events";
@@ -18,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;
 }>;
@@ -1442,6 +1443,8 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   }, {
     theme?: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord" | undefined;
   }>>;
+  /** Hosted app 基础 URL（空字符串表示使用官方默认值） */
+  appBaseUrl: z.ZodDefault<z.ZodString>;
   /** 终端配置 */
   terminal: z.ZodDefault<z.ZodObject<{
     fontSize: z.ZodDefault<z.ZodNumber>;
@@ -1482,6 +1485,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   codeEditor: {
     theme: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord";
   };
+  appBaseUrl: string;
   terminal: {
     fontSize: number;
     fontFamily: string;
@@ -1502,6 +1506,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   codeEditor?: {
     theme?: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord" | undefined;
   } | undefined;
+  appBaseUrl?: string | undefined;
   terminal?: {
     fontSize?: number | undefined;
     fontFamily?: string | undefined;
@@ -1522,6 +1527,7 @@ type OpenSpecUIConfigUpdate = {
   };
   theme?: OpenSpecUIConfig['theme'];
   codeEditor?: Partial<OpenSpecUIConfig['codeEditor']>;
+  appBaseUrl?: OpenSpecUIConfig['appBaseUrl'];
   terminal?: Partial<TerminalConfig>;
   dashboard?: Partial<DashboardConfig>;
 };
@@ -1853,14 +1859,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;
@@ -1878,14 +1884,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;
@@ -1896,8 +1902,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;
@@ -1908,8 +1914,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;
@@ -1922,13 +1928,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;
 }>;
@@ -2036,13 +2042,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">;
@@ -2056,8 +2062,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }[];
@@ -2074,8 +2080,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }[];
@@ -2121,8 +2127,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;
@@ -2131,8 +2137,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
   }[];
   displayPath?: string | undefined;
 }, {
-  name: string;
   path: string;
+  name: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2472,22 +2478,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;
@@ -2504,19 +2510,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;
 }>;
@@ -2594,19 +2600,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<{
@@ -2748,22 +2754,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;
@@ -2771,12 +2777,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;
@@ -2784,12 +2790,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;
@@ -2802,14 +2808,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<{
@@ -2888,22 +2894,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;
@@ -2911,12 +2917,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;
@@ -2924,12 +2930,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;
@@ -2940,14 +2946,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>;
@@ -2955,4 +2961,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, 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, 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, MarkdownParser, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, 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 TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli, toOpsxDisplayPath };
+export { type AIToolOption, AI_TOOLS, type ApplyInstructions, 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, 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 HostedAppChannelKind, type HostedAppChannelManifest, type HostedAppCompatibilityEntry, type HostedAppVersionManifest, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, 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 TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, 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, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, toOpsxDisplayPath };

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-DYIjMsbM.mjs";
+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-Bn-MNDZ0.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-D-YbNUvQ.mjs";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -2330,6 +2331,7 @@ const OpenSpecUIConfigSchema = z.object({
 	}).default({}),
 	theme: z.enum(THEME_VALUES).default("system"),
 	codeEditor: CodeEditorConfigSchema.default(CodeEditorConfigSchema.parse({})),
+	appBaseUrl: z.string().default(""),
 	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
 	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({}))
 });
@@ -2338,6 +2340,7 @@ const DEFAULT_CONFIG = {
 	cli: {},
 	theme: "system",
 	codeEditor: CodeEditorConfigSchema.parse({}),
+	appBaseUrl: "",
 	terminal: TerminalConfigSchema.parse({}),
 	dashboard: DashboardConfigSchema.parse({})
 };
@@ -2406,6 +2409,7 @@ var ConfigManager = class {
 				...current.codeEditor,
 				...config.codeEditor
 			},
+			appBaseUrl: config.appBaseUrl ?? current.appBaseUrl,
 			terminal: {
 				...current.terminal,
 				...config.terminal
@@ -4075,4 +4079,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, MarkdownParser, 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, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli, toOpsxDisplayPath };
+export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, 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, 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, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, toOpsxDisplayPath };

package/dist/opsx-display-path.d.mts

@@ -1,2 +1,2 @@
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-RBULE8_G.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-k65bc8bW.mjs";
 export { VIRTUAL_PROJECT_DIRNAME, toOpsxDisplayPath };

package/dist/opsx-display-path.mjs

@@ -1,3 +1,3 @@
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-DYIjMsbM.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-D-YbNUvQ.mjs";
 
 export { VIRTUAL_PROJECT_DIRNAME, toOpsxDisplayPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -10,6 +10,10 @@
       "import": "./dist/index.mjs",
       "types": "./dist/index.d.mts"
     },
+    "./hosted-app": {
+      "import": "./dist/hosted-app.mjs",
+      "types": "./dist/hosted-app.d.mts"
+    },
     "./opsx-display-path": {
       "import": "./dist/opsx-display-path.mjs",
       "types": "./dist/opsx-display-path.d.mts"
@@ -33,8 +37,8 @@
     "typescript": "^5.0.0"
   },
   "scripts": {
-    "build": "tsdown src/index.ts src/opsx-display-path.ts --format esm --dts",
-    "dev": "tsdown src/index.ts src/opsx-display-path.ts --format esm --dts --watch",
+    "build": "tsdown src/index.ts src/opsx-display-path.ts src/hosted-app.ts --format esm --dts",
+    "dev": "tsdown src/index.ts src/opsx-display-path.ts src/hosted-app.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"