@world-engines/project-host 0.1.0-alpha.0

package/dist/cli-command.d.ts

@@ -0,0 +1,60 @@
+import { LocalPreviewRuntime } from "./preview-runtime.js";
+import { type DownloadReplaceDependencies, type ProjectTransferTransport } from "./transfer/download.js";
+import { type ProjectDocumentIngestionCapability } from "./authoring-ingestion.js";
+import type { AuthoringEmbeddingPort, AuthoringModelConnection } from "./authoring-model-connection.js";
+import type { DesktopAuthoringCapabilities } from "./desktop-authoring-runtime.js";
+import { type LosslessDocumentIngestionCapability } from "./document-ingestion.js";
+import { type FrozenReviewLocalPipeline, type FrozenReviewRecoveryPort } from "./frozen-review.js";
+import { startLocalGuiServer } from "./local-gui-server.js";
+import type { LocalGuiServer } from "./local-gui-contract.js";
+export declare function verifyLocalGuiAssets(overrides?: Readonly<{
+    source?: string;
+    generated?: string;
+}>): Promise<void>;
+export interface WorldengineCliIo {
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    /** tty adapter 注入后才允许无 --confirm-plan 的逐目标交互确认。 */
+    readonly confirmUploadTarget?: (target: Readonly<Record<string, unknown>>) => Promise<boolean>;
+}
+/** 由 T012 的 ProjectAuthBroker 受控 transport 注入；CLI 自己不能构造 cookie/header。 */
+export interface WorldengineDownloadRuntime {
+    readonly transport?: ProjectTransferTransport;
+    readonly dependencies?: DownloadReplaceDependencies;
+}
+export interface WorldengineUploadRuntime {
+    readonly transport?: ProjectTransferTransport;
+}
+export interface WorldengineReviewRuntime {
+    readonly transport?: ProjectTransferTransport;
+    readonly pipeline?: FrozenReviewLocalPipeline;
+    readonly recovery?: FrozenReviewRecoveryPort;
+}
+export interface WorldengineAuthoringRuntime {
+    /** 外部 harness 的模型不属于 Host；登录代理只提供独立 embedding capability。 */
+    readonly embedding?: AuthoringEmbeddingPort;
+    /** 只有语义检索/显式准备才要求登录，MCP 发现与普通作者编辑不预先认证。 */
+    readonly resolveEmbedding?: () => Promise<AuthoringEmbeddingPort>;
+    readonly ingestion?: ProjectDocumentIngestionCapability;
+    readonly losslessIngestion?: LosslessDocumentIngestionCapability;
+    readonly modelConnection?: AuthoringModelConnection;
+    readonly desktopAuthoringCapabilities?: DesktopAuthoringCapabilities;
+}
+export interface WorldengineGuiRuntime {
+    readonly openBrowser?: (url: string) => Promise<void>;
+    readonly startServer?: typeof startLocalGuiServer;
+    readonly onServerStarted?: (server: LocalGuiServer) => void;
+    /** 模型代理复用当前 GUI 私有登录态；启动失败不得留下半运行的 GUI。 */
+    readonly startModelProxy?: (server: LocalGuiServer, project: Readonly<{
+        root: string;
+        project_id: string;
+    }>) => Promise<{
+        close(): Promise<void>;
+    }>;
+    readonly runtimesForTransport?: (transport: ProjectTransferTransport) => {
+        readonly download: WorldengineDownloadRuntime;
+        readonly upload: WorldengineUploadRuntime;
+        readonly review: WorldengineReviewRuntime;
+    };
+}
+export declare function runWorldengineCli(args: readonly string[], cwd: string, io: WorldengineCliIo, previewRuntime?: LocalPreviewRuntime, downloadRuntime?: WorldengineDownloadRuntime, uploadRuntime?: WorldengineUploadRuntime, authoringRuntime?: WorldengineAuthoringRuntime, reviewRuntime?: WorldengineReviewRuntime, guiRuntime?: WorldengineGuiRuntime): Promise<number>;