@world-engines/protocol-ts 0.1.0-alpha.0

package/dist/gen/v1/rest/creator.d.ts

@@ -0,0 +1,354 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { AttachmentRef, ErrorInfo } from "../common.js";
+export declare enum EmbeddingOperationStatus {
+    EMBEDDING_OPERATION_STATUS_UNSPECIFIED = 0,
+    EMBEDDING_OPERATION_STATUS_PENDING = 1,
+    EMBEDDING_OPERATION_STATUS_SETTLED = 2,
+    EMBEDDING_OPERATION_STATUS_FAILED = 3,
+    UNRECOGNIZED = -1
+}
+export declare function embeddingOperationStatusFromJSON(object: any): EmbeddingOperationStatus;
+export declare function embeddingOperationStatusToJSON(object: EmbeddingOperationStatus): string;
+export declare enum EmbeddingInputKind {
+    EMBEDDING_INPUT_KIND_UNSPECIFIED = 0,
+    EMBEDDING_INPUT_KIND_DOCUMENT = 1,
+    EMBEDDING_INPUT_KIND_QUERY = 2,
+    UNRECOGNIZED = -1
+}
+export declare function embeddingInputKindFromJSON(object: any): EmbeddingInputKind;
+export declare function embeddingInputKindToJSON(object: EmbeddingInputKind): string;
+export interface AiGenerateRequest {
+    prompt: string;
+    model_id: string;
+    context_scenario_id: string;
+    extra_json: Uint8Array;
+    max_tokens: number;
+    temperature: number;
+    attachments: AttachmentRef[];
+    idempotency_key: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AiGenerateResponse {
+    text: string;
+    input_tokens: string;
+    output_tokens: string;
+    finish_reason: string;
+    charged_units: string;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 透传第三方 LLM API 服务端做计费 + 签名 不解 raw_payload 语义 */
+export interface AiProxyRequest {
+    upstream: string;
+    raw_payload: Uint8Array;
+    headers: {
+        [key: string]: string;
+    };
+    upstream_path: string;
+    method: string;
+    attachments: AttachmentRef[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AiProxyRequest_HeadersEntry {
+    key: string;
+    value: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AiProxyResponse {
+    raw_response: Uint8Array;
+    status_code: number;
+    response_headers: {
+        [key: string]: string;
+    };
+    input_tokens: string;
+    output_tokens: string;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AiProxyResponse_ResponseHeadersEntry {
+    key: string;
+    value: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingRequest {
+    inputs: string[];
+    model_id: string;
+    operation_id?: string | undefined;
+    idempotency_key_sha256?: string | undefined;
+    /** TurnCommit 已冻结的 descriptor；服务端只绑定/比对，不从客户端降低约束。 */
+    expected_descriptor_sha256?: string | undefined;
+    input_kind: EmbeddingInputKind;
+    /** 用户确认时冻结的完整报价身份。执行端必须逐字段重算并比对，禁止只依赖客户端摘要。 */
+    request_instance_id: string;
+    quote_category: string;
+    quote_provider_model_id: string;
+    quote_revision: string;
+    quote_snapshot_sha256: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingQueryRequest {
+    operation_id: string;
+    idempotency_key_sha256: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingDescriptorPolicyRequest {
+    runtime_lease_id: string;
+    reviewed_artifact_sha256: string;
+    input_kind: EmbeddingInputKind;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * Provider 调用前由服务端目录冻结的向量空间策略。policy_revision 对 domain
+ * `world-engines/embedding-policy-revision/v1` 与 provider/model/decimal dimension/
+ * metric/source_schema/normalization/input_kind/prompt_version/routing_policy_sha256
+ * 逐段执行 u32 big-endian 长度前缀编码后求 SHA-256；descriptor_sha256 在同一
+ * canonical bytes 末尾追加 policy_revision，并切换 descriptor domain 后求 SHA-256。
+ */
+export interface EmbeddingPolicyDescriptorV1 {
+    provider: string;
+    model: string;
+    dimension: number;
+    metric: string;
+    source_schema: string;
+    normalization: string;
+    input_kind: EmbeddingInputKind;
+    prompt_version: string;
+    policy_revision: string;
+    routing_policy_sha256: string;
+    descriptor_sha256: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingDescriptorPolicyResponse {
+    descriptor?: EmbeddingPolicyDescriptorV1 | undefined;
+    runtime_lease_id: string;
+    reviewed_artifact_sha256: string;
+    receipt_sha256: string;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingVector {
+    values: number[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingResponse {
+    vectors: EmbeddingVector[];
+    input_tokens: string;
+    charged_units: string;
+    /**
+     * Provider 调用前冻结的 EmbeddingPolicyDescriptorV1；同次调用的 probe 仅作为
+     * 独立执行证明，必须与该策略一致，不能替换或降低已冻结的 descriptor。
+     */
+    descriptor_sha256?: string | undefined;
+    operation_status: EmbeddingOperationStatus;
+    operation_id?: string | undefined;
+    idempotency_key_sha256?: string | undefined;
+    canonical_request_sha256?: string | undefined;
+    provider_request_sha256?: string | undefined;
+    authorization_receipt_sha256?: string | undefined;
+    settlement_receipt_sha256?: string | undefined;
+    provider_receipt_sha256?: string | undefined;
+    currency?: string | undefined;
+    ledger_unit_scale?: number | undefined;
+    error?: ErrorInfo | undefined;
+    ledger_version?: number | undefined;
+    failure_code?: string | undefined;
+    retryable?: boolean | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 官方发布的检索评测；缺失该 message 表示官方没有发布对应维度的 8B 结果。 */
+export interface EmbeddingRetrievalEffect {
+    benchmark: string;
+    score_bps: number;
+    retention_bps: number;
+    source_url: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 模型支持范围内的目录采样点。runtime_bytes_per_object 仅计 FLOAT 向量本体。 */
+export interface EmbeddingDimensionProfile {
+    dimension: number;
+    runtime_bytes_per_object: number;
+    retrieval_effect?: EmbeddingRetrievalEffect | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingRevisionAttestationV1 {
+    revision_kind: string;
+    routing_policy_sha256: string;
+    probe_schema: string;
+    probe_input_sha256: string;
+    vector_canonicalization: string;
+    probe_vector_sha256: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * 向量空间的完整身份。V1 canonical bytes 是 domain segment
+ * `world-engines/embedding-descriptor/v1`，随后依次为 provider/model/model_revision/
+ * decimal dimension/metric/source_schema/normalization 和 revision_attestation 的六个字段；
+ * 每个 segment 均为 u32 big-endian 长度 + UTF-8 bytes。descriptor_sha256 对这些 bytes
+ * 求 SHA-256；字段缺失表示该目录项不支持版本化向量，消费者不得用 unknown/default 补齐。
+ */
+export interface EmbeddingDescriptorV1 {
+    provider: string;
+    model: string;
+    model_revision: string;
+    dimension: number;
+    metric: string;
+    source_schema: string;
+    normalization: string;
+    descriptor_sha256: string;
+    revision_attestation?: EmbeddingRevisionAttestationV1 | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * Catalog 只发布可验证的固定策略，不伪造调用前尚不存在的 model revision。
+ * 实际 EmbeddingDescriptorV1 由同一次 N+1 provider call 的 probe 生成，作为
+ * EmbeddingPolicyDescriptorV1 的独立执行证明，不建立第二个调用前策略权威。
+ */
+export interface EmbeddingAttestationPolicyV1 {
+    expected_provider_slug: string;
+    exact_quantization: string;
+    probe_schema: string;
+    probe_input_sha256: string;
+    vector_canonicalization: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingCatalogEntry {
+    model_id: string;
+    display_name: string;
+    model_type: string;
+    base_model_id: string;
+    parameter_count_label: string;
+    layer_count: number;
+    context_length_label: string;
+    default_dimension: number;
+    min_dimension: number;
+    max_dimension: number;
+    supports_custom_dimensions: boolean;
+    bytes_per_component: number;
+    metric: string;
+    api_kind: string;
+    sample_dimension_profiles: EmbeddingDimensionProfile[];
+    model_card_url: string;
+    technical_report_url: string;
+    retention_unavailable_reason: string;
+    component_type: string;
+    attestation_policy?: EmbeddingAttestationPolicyV1 | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EmbeddingCatalogResponse {
+    entry?: EmbeddingCatalogEntry | undefined;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * GET /v1/creator/release-capabilities
+ * 这是 Creator 客户端唯一可投影的服务端 release/capability authority。
+ */
+export interface ReleaseCapabilitySnapshot {
+    schema_version: number;
+    revision: string;
+    canonical_digest: string;
+    previous_canonical_digest?: string | undefined;
+    author_alpha: boolean;
+    player_ga: boolean;
+    suno_enabled: boolean;
+    gpu_textoon_enabled: boolean;
+    author_alpha_release_receipt_sha256?: string | undefined;
+    player_ga_release_receipt_sha256?: string | undefined;
+    suno_qualification_receipt_sha256?: string | undefined;
+    suno_producer_receipt_sha256?: string | undefined;
+    gpu_textoon_qualification_receipt_sha256?: string | undefined;
+    gpu_textoon_producer_receipt_sha256?: string | undefined;
+    updated_by: string;
+    updated_at_ms: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ReleaseCapabilitiesResponse {
+    authority?: ReleaseCapabilitySnapshot | undefined;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const AiGenerateRequest: MessageFns<AiGenerateRequest>;
+export declare const AiGenerateResponse: MessageFns<AiGenerateResponse>;
+export declare const AiProxyRequest: MessageFns<AiProxyRequest>;
+export declare const AiProxyRequest_HeadersEntry: MessageFns<AiProxyRequest_HeadersEntry>;
+export declare const AiProxyResponse: MessageFns<AiProxyResponse>;
+export declare const AiProxyResponse_ResponseHeadersEntry: MessageFns<AiProxyResponse_ResponseHeadersEntry>;
+export declare const EmbeddingRequest: MessageFns<EmbeddingRequest>;
+export declare const EmbeddingQueryRequest: MessageFns<EmbeddingQueryRequest>;
+export declare const EmbeddingDescriptorPolicyRequest: MessageFns<EmbeddingDescriptorPolicyRequest>;
+export declare const EmbeddingPolicyDescriptorV1: MessageFns<EmbeddingPolicyDescriptorV1>;
+export declare const EmbeddingDescriptorPolicyResponse: MessageFns<EmbeddingDescriptorPolicyResponse>;
+export declare const EmbeddingVector: MessageFns<EmbeddingVector>;
+export declare const EmbeddingResponse: MessageFns<EmbeddingResponse>;
+export declare const EmbeddingRetrievalEffect: MessageFns<EmbeddingRetrievalEffect>;
+export declare const EmbeddingDimensionProfile: MessageFns<EmbeddingDimensionProfile>;
+export declare const EmbeddingRevisionAttestationV1: MessageFns<EmbeddingRevisionAttestationV1>;
+export declare const EmbeddingDescriptorV1: MessageFns<EmbeddingDescriptorV1>;
+export declare const EmbeddingAttestationPolicyV1: MessageFns<EmbeddingAttestationPolicyV1>;
+export declare const EmbeddingCatalogEntry: MessageFns<EmbeddingCatalogEntry>;
+export declare const EmbeddingCatalogResponse: MessageFns<EmbeddingCatalogResponse>;
+export declare const ReleaseCapabilitySnapshot: MessageFns<ReleaseCapabilitySnapshot>;
+export declare const ReleaseCapabilitiesResponse: MessageFns<ReleaseCapabilitiesResponse>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};