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

package/dist/frozen-review.d.ts

@@ -0,0 +1,131 @@
+import { type FrozenArtifactObjectKind, type FrozenPublishInput, type PublishOperationKey } from "@world-engines/scenario-review-snapshot";
+import type { ProjectTransferTransport } from "./transfer/transport.js";
+export interface FrozenReviewCapture {
+    readonly project_id: string;
+    readonly owner_id: string;
+    readonly scenario_id: string;
+    readonly content_epoch: number;
+    readonly source_revision: number;
+    readonly source_sha256: string;
+    readonly revision_digest: string;
+    readonly revision_id: string;
+}
+export interface FrozenReviewCompilation {
+    readonly source_revision_digest: string;
+    readonly compiler_receipt_sha256: string;
+}
+export interface FrozenReviewEmbedding {
+    readonly source_revision_digest: string;
+    readonly descriptor_sha256: string;
+    readonly vector_count: number;
+}
+/**
+ * Node/GUI 共用的本地流水线 seam。每一步只消费上一步冻结值；实现不得回读 live source。
+ * `freeze` 必须返回 ArtifactV5 的唯一共享输入，wire/digest 不由调用方手拼。
+ */
+export interface FrozenReviewLocalPipeline {
+    capture(signal?: AbortSignal): Promise<FrozenReviewCapture>;
+    compile(capture: FrozenReviewCapture, signal?: AbortSignal): Promise<FrozenReviewCompilation>;
+    embed(capture: FrozenReviewCapture, compilation: FrozenReviewCompilation, signal?: AbortSignal): Promise<FrozenReviewEmbedding>;
+    freeze(capture: FrozenReviewCapture, compilation: FrozenReviewCompilation, embedding: FrozenReviewEmbedding, signal?: AbortSignal): Promise<FrozenPublishInput>;
+}
+/**
+ * project-scoped 恢复密文边界。实现负责在每次调用内从 ProjectAuth/OS protected
+ * provider 取得密钥并调用受信 WASM；Coordinator 永不接触或持久化密钥。
+ */
+export interface FrozenReviewRecoveryPort {
+    seal(projectId: string, plaintext: Uint8Array): Promise<Uint8Array>;
+    open(projectId: string, ciphertext: Uint8Array): Promise<Uint8Array>;
+}
+export interface FrozenReviewWireObject {
+    readonly kind: FrozenArtifactObjectKind;
+    readonly relative_path: string;
+    readonly media_type: string;
+    readonly encoding: "bytes";
+    readonly size_bytes: number;
+    readonly sha256: string;
+    readonly bytes_base64: string;
+}
+export interface FrozenReviewWireRequest {
+    readonly operation_key: PublishOperationKey;
+    readonly review_note: string | null;
+    readonly release_at: number | null;
+    readonly bundle: Readonly<{
+        artifact: Readonly<{
+            scenario_id: string;
+            epoch: number;
+            runtime_generation: 3;
+            runtime_contract_hash: string;
+            source_revision_digest: string;
+            trigger_document_sha256: string;
+            compiled_plan_sha256: string;
+            view_interaction_mobile_sha256: string;
+            view_interaction_pc_sha256: string;
+            music_candidate_source_sha256: string;
+            canonical_digest: string;
+        }>;
+        artifact_manifest_sha256: string;
+        artifact_manifest_base64: string;
+        review_database: Readonly<{
+            encoding: "bytes";
+            size_bytes: number;
+            sha256: string;
+            /** 仅 legacy JSON submit 使用；stream submit 必须省略 plaintext bytes。 */
+            bytes_base64?: string;
+        }>;
+        objects: readonly FrozenReviewWireObject[];
+    }>;
+}
+export declare const FROZEN_REVIEW_SUBMIT_STREAM_CONTENT_TYPE: "application/x-ndjson; profile=\"chat-artifact-v5-submit-stream-v1\"";
+export interface FrozenReviewSubmitStream {
+    readonly content_type: typeof FROZEN_REVIEW_SUBMIT_STREAM_CONTENT_TYPE;
+    readonly bytes: Uint8Array;
+    readonly sha256: string;
+    readonly byte_length: number;
+}
+export declare function serializeFrozenReviewSubmitStream(request: FrozenReviewWireRequest): FrozenReviewSubmitStream;
+export interface FrozenReviewAttempt {
+    readonly attempt_id: string;
+    readonly operation_key: PublishOperationKey;
+    readonly scenario_id: string;
+    readonly artifact_canonical_digest: string;
+    readonly review_snapshot_hash: string;
+    readonly review_coverage_hash: string;
+    readonly state: "pending_review";
+}
+export type FrozenReviewOperationState = "prepared" | "submitting" | "pending_review";
+export interface FrozenReviewOperation {
+    readonly schema_version: 1;
+    readonly project_id: string;
+    readonly operation_key: PublishOperationKey;
+    readonly owner_id: string;
+    readonly scenario_id: string;
+    readonly source_revision_digest: string;
+    readonly artifact_canonical_digest: string;
+    readonly artifact_manifest_sha256: string;
+    readonly object_count: number;
+    readonly review_note: string | null;
+    readonly release_at: number | null;
+    readonly request_digest: string;
+    readonly state: FrozenReviewOperationState;
+    readonly attempt: FrozenReviewAttempt | null;
+}
+export interface PrepareFrozenReviewInput {
+    readonly operation_key: string;
+    readonly review_note?: string;
+    readonly release_at?: number;
+    readonly signal?: AbortSignal;
+}
+export declare class FrozenReviewCoordinator {
+    #private;
+    private constructor();
+    static open(root: string, projectId: string, options?: Readonly<{
+        pipeline?: FrozenReviewLocalPipeline;
+        transport?: ProjectTransferTransport;
+        recovery?: FrozenReviewRecoveryPort;
+    }>): Promise<FrozenReviewCoordinator>;
+    prepare(input: PrepareFrozenReviewInput): Promise<FrozenReviewOperation>;
+    submit(input: PrepareFrozenReviewInput): Promise<FrozenReviewOperation>;
+    status(operationKeyValue: string, reconcile?: boolean): Promise<FrozenReviewOperation>;
+}
+export declare function frozenReviewObjectKeys(request: FrozenReviewWireRequest): readonly string[];