@openspecui/core 3.0.1 → 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";
@@ -19,13 +19,13 @@ declare const ChangeFileSchema: z.ZodObject<{
   /** Optional byte size for files */
   size: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-  type: "file" | "directory";
   path: string;
+  type: "file" | "directory";
   content?: string | undefined;
   size?: number | undefined;
 }, {
-  type: "file" | "directory";
   path: string;
+  type: "file" | "directory";
   content?: string | undefined;
   size?: number | undefined;
 }>;
@@ -1442,9 +1442,9 @@ 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: "compose" | "command";
 }, {
-  agentInvocationMode?: "command" | "compose" | undefined;
+  agentInvocationMode?: "compose" | "command" | undefined;
 }>;
 type OpsxConfig = z.infer<typeof OpsxConfigSchema>;
 /**
@@ -1482,9 +1482,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   opsx: z.ZodDefault<z.ZodObject<{
     agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
   }, "strip", z.ZodTypeAny, {
-    agentInvocationMode: "command" | "compose";
+    agentInvocationMode: "compose" | "command";
   }, {
-    agentInvocationMode?: "command" | "compose" | undefined;
+    agentInvocationMode?: "compose" | "command" | undefined;
   }>>;
   /** 终端配置 */
   terminal: z.ZodDefault<z.ZodObject<{
@@ -1536,7 +1536,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   };
   appBaseUrl: string;
   opsx: {
-    agentInvocationMode: "command" | "compose";
+    agentInvocationMode: "compose" | "command";
   };
   terminal: {
     fontSize: number;
@@ -1563,7 +1563,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   } | undefined;
   appBaseUrl?: string | undefined;
   opsx?: {
-    agentInvocationMode?: "command" | "compose" | undefined;
+    agentInvocationMode?: "compose" | "command" | undefined;
   } | undefined;
   terminal?: {
     fontSize?: number | undefined;
@@ -1983,14 +1983,14 @@ declare const ArtifactStatusSchema: z.ZodObject<{
   missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
   relativePath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  status: "done" | "ready" | "blocked";
   id: string;
+  status: "done" | "ready" | "blocked";
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
 }, {
-  status: "done" | "ready" | "blocked";
   id: string;
+  status: "done" | "ready" | "blocked";
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
@@ -2008,14 +2008,14 @@ declare const ChangeStatusSchema: z.ZodObject<{
     missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relativePath: z.ZodOptional<z.ZodString>;
   }, "strip", z.ZodTypeAny, {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
   }, {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -2026,8 +2026,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -2038,8 +2038,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -2052,13 +2052,13 @@ declare const DependencyInfoSchema: z.ZodObject<{
   path: z.ZodString;
   description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   id: string;
+  path: string;
   description: string;
   done: boolean;
 }, {
-  path: string;
   id: string;
+  path: string;
   description: string;
   done: boolean;
 }>;
@@ -2167,13 +2167,13 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
     path: z.ZodString;
     description: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }, {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }>, "many">;
@@ -2187,8 +2187,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -2205,8 +2205,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -2252,8 +2252,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
     displayPath?: string | undefined;
   }>, "many">;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   name: string;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2262,8 +2262,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
   }[];
   displayPath?: string | undefined;
 }, {
-  path: string;
   name: string;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2692,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;
@@ -2724,19 +2724,19 @@ declare const PtyCreateMessageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>;
@@ -2814,19 +2814,19 @@ declare const PtyClientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>, z.ZodObject<{
@@ -2968,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;
@@ -2991,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;
@@ -3004,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;
@@ -3022,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<{
@@ -3108,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;
@@ -3131,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;
@@ -3144,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;
@@ -3160,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>;
@@ -3175,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, 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 };
+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";
@@ -4587,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, 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 };
+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.1",
+  "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 };