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

package/dist/gen/v1/sav.d.ts

@@ -0,0 +1,987 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { ViewStateSnapshot } from "./view_state.js";
+/** 玩家存档的 canonical section 类型。数值会进入 SAVBIN section table，禁止复用。 */
+export declare enum SaveSectionKind {
+    SAVE_SECTION_KIND_UNSPECIFIED = 0,
+    SAVE_SECTION_KIND_MANIFEST = 1,
+    SAVE_SECTION_KIND_CONVERSATION_LEDGER = 2,
+    SAVE_SECTION_KIND_LADYBUG_OVERLAY_WAL = 3,
+    SAVE_SECTION_KIND_LADYBUG_OVERLAY_CHECKPOINT = 4,
+    SAVE_SECTION_KIND_PHYSICAL_INDEX_CHECKPOINT = 5,
+    SAVE_SECTION_KIND_TRIGGER_RUNTIME_STATE = 6,
+    SAVE_SECTION_KIND_VIEW_STATE_SNAPSHOT = 7,
+    SAVE_SECTION_KIND_SCENARIO_RUNTIME_STATE = 8,
+    SAVE_SECTION_KIND_ASSET_REFS = 9,
+    SAVE_SECTION_KIND_IN_FLIGHT_RECOVERY = 10,
+    SAVE_SECTION_KIND_INTEGRITY_CHECKPOINT = 11,
+    SAVE_SECTION_KIND_EXTENSION = 12,
+    SAVE_SECTION_KIND_WORLDLINE_CATALOG = 13,
+    SAVE_SECTION_KIND_WORLDLINE_OP_DAG = 14,
+    SAVE_SECTION_KIND_WORLDLINE_BLOB_STORE = 15,
+    SAVE_SECTION_KIND_PRESENTATION_PLAN_STORE = 16,
+    SAVE_SECTION_KIND_PRESENTATION_CURSOR = 17,
+    SAVE_SECTION_KIND_AUDIO_RUNTIME_SNAPSHOT = 18,
+    UNRECOGNIZED = -1
+}
+export declare function saveSectionKindFromJSON(object: any): SaveSectionKind;
+export declare function saveSectionKindToJSON(object: SaveSectionKind): string;
+export declare enum WorldlineOpKind {
+    WORLDLINE_OP_KIND_UNSPECIFIED = 0,
+    WORLDLINE_OP_KIND_MESSAGE = 1,
+    WORLDLINE_OP_KIND_DB_MUTATION = 2,
+    WORLDLINE_OP_KIND_VIEW_STATE = 3,
+    WORLDLINE_OP_KIND_TRIGGER_STATE = 4,
+    WORLDLINE_OP_KIND_SCENARIO_STATE = 5,
+    WORLDLINE_OP_KIND_EDIT = 6,
+    WORLDLINE_OP_KIND_REWIND = 7,
+    WORLDLINE_OP_KIND_REGENERATE = 8,
+    WORLDLINE_OP_KIND_CHECKPOINT = 9,
+    UNRECOGNIZED = -1
+}
+export declare function worldlineOpKindFromJSON(object: any): WorldlineOpKind;
+export declare function worldlineOpKindToJSON(object: WorldlineOpKind): string;
+export declare enum WorldlineBlobKind {
+    WORLDLINE_BLOB_KIND_UNSPECIFIED = 0,
+    WORLDLINE_BLOB_KIND_MESSAGE_CONTENT = 1,
+    WORLDLINE_BLOB_KIND_DB_OP_BATCH = 2,
+    WORLDLINE_BLOB_KIND_VIEW_STATE = 3,
+    WORLDLINE_BLOB_KIND_CUSTOM_STATE = 4,
+    WORLDLINE_BLOB_KIND_TRIGGER_STATE = 5,
+    WORLDLINE_BLOB_KIND_SCENARIO_STATE = 6,
+    WORLDLINE_BLOB_KIND_ASSET_REFS = 7,
+    WORLDLINE_BLOB_KIND_CHECKPOINT = 8,
+    UNRECOGNIZED = -1
+}
+export declare function worldlineBlobKindFromJSON(object: any): WorldlineBlobKind;
+export declare function worldlineBlobKindToJSON(object: WorldlineBlobKind): string;
+export declare enum AttributeOwnerKind {
+    ATTRIBUTE_OWNER_KIND_UNSPECIFIED = 0,
+    ATTRIBUTE_OWNER_KIND_ENTITY = 1,
+    ATTRIBUTE_OWNER_KIND_RELATION = 2,
+    UNRECOGNIZED = -1
+}
+export declare function attributeOwnerKindFromJSON(object: any): AttributeOwnerKind;
+export declare function attributeOwnerKindToJSON(object: AttributeOwnerKind): string;
+export declare enum ConversationRole {
+    CONVERSATION_ROLE_UNSPECIFIED = 0,
+    CONVERSATION_ROLE_SYSTEM = 1,
+    CONVERSATION_ROLE_USER = 2,
+    CONVERSATION_ROLE_ASSISTANT = 3,
+    CONVERSATION_ROLE_TOOL = 4,
+    UNRECOGNIZED = -1
+}
+export declare function conversationRoleFromJSON(object: any): ConversationRole;
+export declare function conversationRoleToJSON(object: ConversationRole): string;
+export declare enum ConversationRecordKind {
+    CONVERSATION_RECORD_KIND_UNSPECIFIED = 0,
+    CONVERSATION_RECORD_KIND_MESSAGE = 1,
+    CONVERSATION_RECORD_KIND_TOOL_CALL = 2,
+    CONVERSATION_RECORD_KIND_TOOL_RESULT = 3,
+    CONVERSATION_RECORD_KIND_EDIT = 4,
+    CONVERSATION_RECORD_KIND_SUPERSEDE = 5,
+    CONVERSATION_RECORD_KIND_TOMBSTONE = 6,
+    CONVERSATION_RECORD_KIND_REWIND = 7,
+    CONVERSATION_RECORD_KIND_FORK = 8,
+    CONVERSATION_RECORD_KIND_REGENERATE = 9,
+    UNRECOGNIZED = -1
+}
+export declare function conversationRecordKindFromJSON(object: any): ConversationRecordKind;
+export declare function conversationRecordKindToJSON(object: ConversationRecordKind): string;
+export declare enum ConversationRecordStatus {
+    CONVERSATION_RECORD_STATUS_UNSPECIFIED = 0,
+    CONVERSATION_RECORD_STATUS_STAGED = 1,
+    CONVERSATION_RECORD_STATUS_COMMITTED = 2,
+    CONVERSATION_RECORD_STATUS_SUPERSEDED = 3,
+    CONVERSATION_RECORD_STATUS_TOMBSTONED = 4,
+    UNRECOGNIZED = -1
+}
+export declare function conversationRecordStatusFromJSON(object: any): ConversationRecordStatus;
+export declare function conversationRecordStatusToJSON(object: ConversationRecordStatus): string;
+/**
+ * 记录的可审计来源。旧数据无法证明完整来源时必须使用
+ * LEGACY_UNVERIFIABLE，禁止伪装成实时 client ledger 记录。
+ */
+export declare enum ConversationProvenanceKind {
+    CONVERSATION_PROVENANCE_KIND_UNSPECIFIED = 0,
+    CONVERSATION_PROVENANCE_KIND_CLIENT_LEDGER = 1,
+    CONVERSATION_PROVENANCE_KIND_LEGACY_IMPORT = 2,
+    CONVERSATION_PROVENANCE_KIND_EDGE_ARCHIVE_BACKFILL = 3,
+    CONVERSATION_PROVENANCE_KIND_LEGACY_UNVERIFIABLE = 4,
+    UNRECOGNIZED = -1
+}
+export declare function conversationProvenanceKindFromJSON(object: any): ConversationProvenanceKind;
+export declare function conversationProvenanceKindToJSON(object: ConversationProvenanceKind): string;
+export declare enum RuntimeVariableScope {
+    RUNTIME_VARIABLE_SCOPE_UNSPECIFIED = 0,
+    RUNTIME_VARIABLE_SCOPE_PUBLIC = 1,
+    RUNTIME_VARIABLE_SCOPE_PROTECTED = 2,
+    UNRECOGNIZED = -1
+}
+export declare function runtimeVariableScopeFromJSON(object: any): RuntimeVariableScope;
+export declare function runtimeVariableScopeToJSON(object: RuntimeVariableScope): string;
+export declare enum RuntimeActionStatus {
+    RUNTIME_ACTION_STATUS_UNSPECIFIED = 0,
+    RUNTIME_ACTION_STATUS_QUEUED = 1,
+    RUNTIME_ACTION_STATUS_EXECUTING = 2,
+    RUNTIME_ACTION_STATUS_COMMITTED = 3,
+    RUNTIME_ACTION_STATUS_ROLLED_BACK = 4,
+    UNRECOGNIZED = -1
+}
+export declare function runtimeActionStatusFromJSON(object: any): RuntimeActionStatus;
+export declare function runtimeActionStatusToJSON(object: RuntimeActionStatus): string;
+export declare enum PlayerAssetKind {
+    PLAYER_ASSET_KIND_UNSPECIFIED = 0,
+    PLAYER_ASSET_KIND_IMAGE = 1,
+    PLAYER_ASSET_KIND_VOICE = 2,
+    PLAYER_ASSET_KIND_PUPPET = 3,
+    PLAYER_ASSET_KIND_CUSTOM = 4,
+    UNRECOGNIZED = -1
+}
+export declare function playerAssetKindFromJSON(object: any): PlayerAssetKind;
+export declare function playerAssetKindToJSON(object: PlayerAssetKind): string;
+export declare enum AssetLifecycleEventKind {
+    ASSET_LIFECYCLE_EVENT_KIND_UNSPECIFIED = 0,
+    ASSET_LIFECYCLE_EVENT_KIND_ADDED = 1,
+    ASSET_LIFECYCLE_EVENT_KIND_REMOVED = 2,
+    UNRECOGNIZED = -1
+}
+export declare function assetLifecycleEventKindFromJSON(object: any): AssetLifecycleEventKind;
+export declare function assetLifecycleEventKindToJSON(object: AssetLifecycleEventKind): string;
+export declare enum InFlightKind {
+    IN_FLIGHT_KIND_UNSPECIFIED = 0,
+    IN_FLIGHT_KIND_TURN_EXTRACTION = 1,
+    IN_FLIGHT_KIND_DB_TRANSACTION = 2,
+    IN_FLIGHT_KIND_TRIGGER_ACTION = 3,
+    IN_FLIGHT_KIND_VIEW_CAPTURE = 4,
+    IN_FLIGHT_KIND_SAVE_COMMIT = 5,
+    UNRECOGNIZED = -1
+}
+export declare function inFlightKindFromJSON(object: any): InFlightKind;
+export declare function inFlightKindToJSON(object: InFlightKind): string;
+export declare enum InFlightStatus {
+    IN_FLIGHT_STATUS_UNSPECIFIED = 0,
+    IN_FLIGHT_STATUS_STAGED = 1,
+    IN_FLIGHT_STATUS_EXECUTING = 2,
+    IN_FLIGHT_STATUS_PERSISTENCE_READY = 3,
+    IN_FLIGHT_STATUS_PERSISTENCE_BLOCKED = 4,
+    IN_FLIGHT_STATUS_COMMITTED = 5,
+    IN_FLIGHT_STATUS_ROLLED_BACK = 6,
+    UNRECOGNIZED = -1
+}
+export declare function inFlightStatusFromJSON(object: any): InFlightStatus;
+export declare function inFlightStatusToJSON(object: InFlightStatus): string;
+/** 某 section 在一个 immutable generation 内的已提交 head。 */
+export interface SectionHead {
+    kind: SaveSectionKind;
+    section_id: string;
+    revision: string;
+    logical_head: string;
+    plaintext_sha256: Uint8Array;
+    plaintext_size: string;
+    ciphertext_sha256: Uint8Array;
+    ciphertext_size: string;
+    codec: string;
+    required: boolean;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 一个玩家存档 generation 的根绑定。不得携带 origin object key、密钥或作者明文。 */
+export interface SaveManifest {
+    format_version: number;
+    save_id: string;
+    scenario_id: string;
+    active_release_id: string;
+    database_origin_sha256: Uint8Array;
+    view_pc_sha256: Uint8Array;
+    view_mobile_sha256: Uint8Array;
+    active_platform: string;
+    runtime_major: number;
+    last_resolved_runtime_patch: number;
+    sdk_schema_version: number;
+    generation: string;
+    branch_id: string;
+    parent_save_id: string;
+    forked_at_message_id: string;
+    last_committed_turn_bundle_id: string;
+    section_heads: SectionHead[];
+    created_at_ms: string;
+    updated_at_ms: string;
+    previous_generation_digest: Uint8Array;
+    canonical_generation_digest: Uint8Array;
+    /** SAV v3 单存档世界线。旧 format_version=2 读取时由 client 合成 root line。 */
+    active_worldline_id: string;
+    root_worldline_id: string;
+    worldline_catalog_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 一条世界线只保存 head，不复制从 root 到 head 的操作或 payload。 */
+export interface WorldlineDescriptor {
+    worldline_id: string;
+    title: string;
+    parent_worldline_id: string;
+    fork_anchor_op_id: string;
+    head_op_id: string;
+    created_at_ms: string;
+    updated_at_ms: string;
+    revision: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface WorldlineCatalog {
+    schema_version: number;
+    save_id: string;
+    scenario_id: string;
+    active_worldline_id: string;
+    root_worldline_id: string;
+    worldlines: WorldlineDescriptor[];
+    revision: string;
+    previous_catalog_sha256: Uint8Array;
+    catalog_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** section state 通过 content-addressed blob 引用，不在每条世界线做深拷贝。 */
+export interface WorldlineStateRef {
+    section_kind: SaveSectionKind;
+    blob_sha256: Uint8Array;
+    revision: string;
+    logical_head: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * op_id 必须由 canonical 编码摘要派生。parent_op_ids 允许未来无损表达 merge，
+ * 普通提交与 fork head 均只有一个 parent。
+ */
+export interface WorldlineOp {
+    op_id: string;
+    parent_op_ids: string[];
+    kind: WorldlineOpKind;
+    message_id: string;
+    turn_bundle_id: string;
+    content_blob_sha256: Uint8Array;
+    db_ops_blob_sha256: Uint8Array;
+    state_refs: WorldlineStateRef[];
+    idempotency_key: string;
+    created_at_ms: string;
+    op_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface WorldlineOpDag {
+    schema_version: number;
+    ops: WorldlineOp[];
+    dag_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface WorldlineBlob {
+    sha256: Uint8Array;
+    kind: WorldlineBlobKind;
+    codec: string;
+    payload: Uint8Array;
+    plaintext_size: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface WorldlineBlobStore {
+    schema_version: number;
+    blobs: WorldlineBlob[];
+    store_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 写入前置条件。upsert/delete 必须显式声明预期旧 revision/hash，防止静默覆盖。 */
+export interface ExpectedPriorState {
+    revision: string;
+    state_sha256: Uint8Array;
+    must_exist: boolean;
+    incarnation: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 写入后的 canonical revision 与内容摘要。 */
+export interface PostImageRevision {
+    revision: string;
+    incarnation: string;
+    state_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 写操作溯源。node/edge/attr/trigger 可同时出现，表示一次跨对象原子抽取。 */
+export interface WriteProvenance {
+    source_message_id: string;
+    assistant_message_id: string;
+    extraction_message_id: string;
+    turn_bundle_id: string;
+    node_id: string;
+    edge_id: string;
+    attr_path: string;
+    trigger_id: string;
+    model: string;
+    provider: string;
+    attempt_id: string;
+    input_sha256: Uint8Array;
+    output_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 增量存档单条数据库操作。字段 1-5 与 10-12 为已发布编号，禁止变更语义。 */
+export interface DbOpEntry {
+    entity_upsert?: EntityUpsertOp | undefined;
+    entity_remove?: EntityRemoveOp | undefined;
+    relation_upsert?: RelationUpsertOp | undefined;
+    relation_remove?: RelationRemoveOp | undefined;
+    vector_upsert?: VectorUpsertOp | undefined;
+    write_seq: string;
+    message_id: string;
+    turn_id: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EntityUpsertOp {
+    entity_id: string;
+    entity_kind: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EntityRemoveOp {
+    entity_id: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RelationUpsertOp {
+    src: string;
+    dst: string;
+    relation_kind: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RelationRemoveOp {
+    src: string;
+    dst: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface VectorUpsertOp {
+    entity_id: string;
+    vector: number[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * 兼容层保留上方已发布的 DbOp* 消息；正式保存协议使用 canonical 消息，
+ * 避免给 prost 生成的旧结构体增加必填初始化字段。
+ */
+export interface CanonicalDbOpEntry {
+    entity_upsert?: CanonicalEntityUpsertOp | undefined;
+    entity_remove?: EntityTombstoneOp | undefined;
+    relation_upsert?: CanonicalRelationUpsertOp | undefined;
+    relation_remove?: RelationTombstoneOp | undefined;
+    vector_upsert?: CanonicalVectorUpsertOp | undefined;
+    vector_remove?: VectorTombstoneOp | undefined;
+    attribute_upsert?: AttributeUpsertOp | undefined;
+    attribute_remove?: AttributeRemoveOp | undefined;
+    attribute_history_append?: AttributeHistoryAppendOp | undefined;
+    write_seq: string;
+    message_id: string;
+    turn_id: string;
+    idempotency_key: string;
+    provenance?: WriteProvenance | undefined;
+    schema_version: number;
+    occurred_at_ms: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 完整 entity post-image；canonical_props 不是 patch。 */
+export interface CanonicalEntityUpsertOp {
+    entity_id: string;
+    entity_kind: string;
+    canonical_props: Uint8Array;
+    props_codec: string;
+    expected_prior?: ExpectedPriorState | undefined;
+    post_image?: PostImageRevision | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface EntityTombstoneOp {
+    entity_id: string;
+    expected_prior?: ExpectedPriorState | undefined;
+    tombstone_revision: string;
+    deleted_incarnation: string;
+    tombstone_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** relation_id 是跨 checkpoint/replay 稳定的关系身份；src/dst/kind 不能替代它。 */
+export interface CanonicalRelationUpsertOp {
+    src: string;
+    dst: string;
+    relation_kind: string;
+    relation_id: string;
+    canonical_props: Uint8Array;
+    props_codec: string;
+    expected_prior?: ExpectedPriorState | undefined;
+    post_image?: PostImageRevision | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RelationTombstoneOp {
+    src: string;
+    dst: string;
+    relation_id: string;
+    expected_prior?: ExpectedPriorState | undefined;
+    tombstone_revision: string;
+    deleted_incarnation: string;
+    tombstone_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface CanonicalVectorUpsertOp {
+    entity_id: string;
+    vector: number[];
+    vector_space: string;
+    embedding_model: string;
+    dimension: number;
+    expected_prior?: ExpectedPriorState | undefined;
+    post_image?: PostImageRevision | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface VectorTombstoneOp {
+    entity_id: string;
+    vector_space: string;
+    expected_prior?: ExpectedPriorState | undefined;
+    tombstone_revision: string;
+    tombstone_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AttributeAddress {
+    owner_kind: AttributeOwnerKind;
+    owner_id: string;
+    attr_key: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 完整 attribute post-image；canonical_value 不允许仅携带局部 patch。 */
+export interface AttributeUpsertOp {
+    address?: AttributeAddress | undefined;
+    canonical_value: Uint8Array;
+    value_codec: string;
+    expected_prior?: ExpectedPriorState | undefined;
+    post_image?: PostImageRevision | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AttributeRemoveOp {
+    address?: AttributeAddress | undefined;
+    expected_prior?: ExpectedPriorState | undefined;
+    tombstone_revision: string;
+    tombstone_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** history_entry_id 为 append-only stable id，重复 replay 必须幂等。 */
+export interface AttributeHistoryAppendOp {
+    history_entry_id: string;
+    address?: AttributeAddress | undefined;
+    canonical_value: Uint8Array;
+    value_codec: string;
+    history_revision: string;
+    previous_history_entry_sha256: Uint8Array;
+    history_entry_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** snapshot_delta_since 与 WAL section 共用的有序操作批次。 */
+export interface DbOpBatch {
+    ops: DbOpEntry[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** snapshot_delta_since 与 WAL section 共用的有序 canonical 操作批次。 */
+export interface CanonicalDbOpBatch {
+    ops: CanonicalDbOpEntry[];
+    first_write_seq: string;
+    last_write_seq: string;
+    previous_batch_sha256: Uint8Array;
+    batch_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ConversationRecordProvenance {
+    kind: ConversationProvenanceKind;
+    source_record_id: string;
+    source_message_id: string;
+    import_batch_id: string;
+    source_sha256: Uint8Array;
+    verifiable: boolean;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ConversationRecord {
+    ledger_seq: string;
+    message_id: string;
+    turn_bundle_id: string;
+    turn_seq: string;
+    branch_id: string;
+    parent_message_id: string;
+    role: ConversationRole;
+    kind: ConversationRecordKind;
+    content: Uint8Array;
+    content_codec: string;
+    created_at_ms: string;
+    status: ConversationRecordStatus;
+    tool_call_id: string;
+    tool_name: string;
+    tool_arguments: Uint8Array;
+    tool_result: Uint8Array;
+    assistant_message_id: string;
+    extraction_message_id: string;
+    model: string;
+    provider: string;
+    target_message_id: string;
+    target_ledger_seq: string;
+    content_sha256: Uint8Array;
+    previous_record_sha256: Uint8Array;
+    record_sha256: Uint8Array;
+    idempotency_key: string;
+    /**
+     * v2 append-only fields。record_id 是跨 projection 的 canonical identity；
+     * turn_id 与 turn_bundle_id 分离，兼容旧记录只有 bundle identity 的情况。
+     */
+    record_id: string;
+    turn_id: string;
+    canonical_meta: Uint8Array;
+    canonical_meta_codec: string;
+    message_status: string;
+    role_raw: string;
+    provenance?: ConversationRecordProvenance | undefined;
+    tool_arguments_codec: string;
+    tool_result_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ConversationLedger {
+    schema_version: number;
+    branch_id: string;
+    records: ConversationRecord[];
+    first_ledger_seq: string;
+    last_ledger_seq: string;
+    previous_ledger_sha256: Uint8Array;
+    ledger_sha256: Uint8Array;
+    /** v2 identity/backfill fields；schema_version=1 的历史 payload 仍可读取。 */
+    save_id: string;
+    scenario_id: string;
+    backfill_required: boolean;
+    updated_at_ms: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface LadybugOverlayWal {
+    schema_version: number;
+    active_release_id: string;
+    database_origin_sha256: Uint8Array;
+    batches: CanonicalDbOpBatch[];
+    first_write_seq: string;
+    last_write_seq: string;
+    wal_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 当前 overlay shadow/tombstone 的逻辑 checkpoint，可由 origin + WAL 重建。 */
+export interface LadybugOverlayCheckpoint {
+    schema_version: number;
+    active_release_id: string;
+    database_origin_sha256: Uint8Array;
+    checkpoint_head_write_seq: string;
+    entity_shadows: CanonicalEntityUpsertOp[];
+    entity_tombstones: EntityTombstoneOp[];
+    relation_shadows: CanonicalRelationUpsertOp[];
+    relation_tombstones: RelationTombstoneOp[];
+    attribute_shadows: AttributeUpsertOp[];
+    attribute_tombstones: AttributeRemoveOp[];
+    attribute_history: AttributeHistoryAppendOp[];
+    vectors: CanonicalVectorUpsertOp[];
+    vector_tombstones: VectorTombstoneOp[];
+    checkpoint_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 纯加速缓存；任一版本/hash 不匹配即可丢弃并确定性重建。 */
+export interface PhysicalIndexCheckpoint {
+    schema_version: number;
+    ladybug_version: string;
+    wasm_build: string;
+    index_config_sha256: Uint8Array;
+    logical_state_sha256: Uint8Array;
+    checkpoint_bytes: Uint8Array;
+    checkpoint_sha256: Uint8Array;
+    checkpoint_head_write_seq: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RuntimeVariable {
+    name: string;
+    canonical_value: Uint8Array;
+    value_codec: string;
+    revision: string;
+    scope: RuntimeVariableScope;
+    authorized_user_ids: string[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RuntimeLatch {
+    latch_id: string;
+    latch_kind: string;
+    closed: boolean;
+    fired: boolean;
+    ordinal: string;
+    canonical_state: Uint8Array;
+    state_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RuntimeAction {
+    action_id: string;
+    trigger_id: string;
+    action_ordinal: string;
+    status: RuntimeActionStatus;
+    idempotency_key: string;
+    canonical_payload: Uint8Array;
+    payload_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface RuntimeTransaction {
+    transaction_id: string;
+    entity_id: string;
+    state_id: string;
+    expires_at_world_time_ms: string;
+    status: RuntimeActionStatus;
+    idempotency_key: string;
+    canonical_state: Uint8Array;
+    state_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ScheduledRuntimeEvent {
+    event_id: string;
+    event_kind: string;
+    due_world_time_ms: string;
+    event_ordinal: string;
+    idempotency_key: string;
+    canonical_payload: Uint8Array;
+    payload_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * TriggerProgramRuntime 按脚本下标保存的 value_changed 比较基线。
+ * 该值不能只保存数量，否则恢复后的第一次 value_changed 会被误判为首次观察。
+ */
+export interface RuntimeLastValue {
+    script_index: number;
+    canonical_value: Uint8Array;
+    value_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface TriggerRuntimeState {
+    schema_version: number;
+    trigger_definition_sha256: Uint8Array;
+    state_revision: string;
+    world_time_ms: string;
+    calendar_id: string;
+    rng_algorithm: string;
+    rng_version: number;
+    rng_state: Uint8Array;
+    rng_counter: string;
+    variables: RuntimeVariable[];
+    entity_states: RuntimeVariable[];
+    pending_transactions: RuntimeTransaction[];
+    latches: RuntimeLatch[];
+    fired_trigger_ids: string[];
+    fired_condition_ids: string[];
+    pending_events: ScheduledRuntimeEvent[];
+    active_global_events: ScheduledRuntimeEvent[];
+    last_value_ordinal: string;
+    event_ordinal: string;
+    action_ordinal: string;
+    recall_ordinal: string;
+    consumed_recall_ids: string[];
+    scheduled_timers: ScheduledRuntimeEvent[];
+    queued_actions: RuntimeAction[];
+    scheduler_paused: boolean;
+    state_sha256: Uint8Array;
+    last_values: RuntimeLastValue[];
+    receipt_ordinal: string;
+    action_journal: RuntimeAction[];
+    queued_runtime_events: ScheduledRuntimeEvent[];
+    fired_trigger_markers: RuntimeVariable[];
+    fired_condition_markers: RuntimeVariable[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ScenarioRuntimeState {
+    schema_version: number;
+    state_revision: string;
+    scene_id: string;
+    chapter_id: string;
+    progress: number;
+    unlocked_resource_ids: string[];
+    customization_state: Uint8Array;
+    customization_codec: string;
+    media_state: Uint8Array;
+    media_state_codec: string;
+    custom_state: RuntimeVariable[];
+    state_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface PlayerAssetRef {
+    asset_id: string;
+    kind: PlayerAssetKind;
+    uri: string;
+    sha256: Uint8Array;
+    size_bytes: string;
+    mime_type: string;
+    source_message_id: string;
+    generation_metadata: Uint8Array;
+    metadata_codec: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AssetLifecycleEvent {
+    event_seq: string;
+    kind: AssetLifecycleEventKind;
+    asset?: PlayerAssetRef | undefined;
+    message_id: string;
+    occurred_at_ms: string;
+    previous_event_sha256: Uint8Array;
+    event_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface AssetRefs {
+    schema_version: number;
+    active_assets: PlayerAssetRef[];
+    events: AssetLifecycleEvent[];
+    last_event_seq: string;
+    section_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface InFlightAttempt {
+    attempt_id: string;
+    extraction_message_id: string;
+    model: string;
+    provider: string;
+    validator_errors: string[];
+    input_sha256: Uint8Array;
+    output_sha256: Uint8Array;
+    cost_reservation_id: string;
+    status: InFlightStatus;
+    attempt_number: number;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface InFlightItem {
+    in_flight_id: string;
+    kind: InFlightKind;
+    status: InFlightStatus;
+    turn_bundle_id: string;
+    idempotency_key: string;
+    proposed_generation: string;
+    attempts: InFlightAttempt[];
+    recovery_payload: Uint8Array;
+    recovery_codec: string;
+    updated_at_ms: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface InFlightRecovery {
+    schema_version: number;
+    items: InFlightItem[];
+    section_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface IntegrityCheckpoint {
+    schema_version: number;
+    generation: string;
+    section_heads: SectionHead[];
+    manifest_sha256: Uint8Array;
+    previous_generation_digest: Uint8Array;
+    canonical_generation_digest: Uint8Array;
+    last_committed_turn_bundle_id: string;
+    overlay_head_write_seq: string;
+    ledger_head_seq: string;
+    trigger_state_revision: string;
+    view_state_revision: string;
+    scenario_state_revision: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ExtensionSection {
+    extension_id: string;
+    schema_version: number;
+    payload: Uint8Array;
+    codec: string;
+    payload_sha256: Uint8Array;
+    required: boolean;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 统一 generation 逻辑容器；物理 SAVBIN 可将各字段编码为独立 AEAD section。 */
+export interface SaveGeneration {
+    manifest?: SaveManifest | undefined;
+    conversation_ledger?: ConversationLedger | undefined;
+    overlay_wal?: LadybugOverlayWal | undefined;
+    overlay_checkpoint?: LadybugOverlayCheckpoint | undefined;
+    physical_index_checkpoint?: PhysicalIndexCheckpoint | undefined;
+    trigger_runtime_state?: TriggerRuntimeState | undefined;
+    view_state_snapshot?: ViewStateSnapshot | undefined;
+    scenario_runtime_state?: ScenarioRuntimeState | undefined;
+    asset_refs?: AssetRefs | undefined;
+    in_flight_recovery?: InFlightRecovery | undefined;
+    integrity_checkpoint?: IntegrityCheckpoint | undefined;
+    extension_sections: ExtensionSection[];
+    worldline_catalog?: WorldlineCatalog | undefined;
+    worldline_op_dag?: WorldlineOpDag | undefined;
+    worldline_blob_store?: WorldlineBlobStore | undefined;
+    presentation_plan_store: Uint8Array;
+    presentation_cursor: Uint8Array;
+    audio_runtime_snapshot: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const SectionHead: MessageFns<SectionHead>;
+export declare const SaveManifest: MessageFns<SaveManifest>;
+export declare const WorldlineDescriptor: MessageFns<WorldlineDescriptor>;
+export declare const WorldlineCatalog: MessageFns<WorldlineCatalog>;
+export declare const WorldlineStateRef: MessageFns<WorldlineStateRef>;
+export declare const WorldlineOp: MessageFns<WorldlineOp>;
+export declare const WorldlineOpDag: MessageFns<WorldlineOpDag>;
+export declare const WorldlineBlob: MessageFns<WorldlineBlob>;
+export declare const WorldlineBlobStore: MessageFns<WorldlineBlobStore>;
+export declare const ExpectedPriorState: MessageFns<ExpectedPriorState>;
+export declare const PostImageRevision: MessageFns<PostImageRevision>;
+export declare const WriteProvenance: MessageFns<WriteProvenance>;
+export declare const DbOpEntry: MessageFns<DbOpEntry>;
+export declare const EntityUpsertOp: MessageFns<EntityUpsertOp>;
+export declare const EntityRemoveOp: MessageFns<EntityRemoveOp>;
+export declare const RelationUpsertOp: MessageFns<RelationUpsertOp>;
+export declare const RelationRemoveOp: MessageFns<RelationRemoveOp>;
+export declare const VectorUpsertOp: MessageFns<VectorUpsertOp>;
+export declare const CanonicalDbOpEntry: MessageFns<CanonicalDbOpEntry>;
+export declare const CanonicalEntityUpsertOp: MessageFns<CanonicalEntityUpsertOp>;
+export declare const EntityTombstoneOp: MessageFns<EntityTombstoneOp>;
+export declare const CanonicalRelationUpsertOp: MessageFns<CanonicalRelationUpsertOp>;
+export declare const RelationTombstoneOp: MessageFns<RelationTombstoneOp>;
+export declare const CanonicalVectorUpsertOp: MessageFns<CanonicalVectorUpsertOp>;
+export declare const VectorTombstoneOp: MessageFns<VectorTombstoneOp>;
+export declare const AttributeAddress: MessageFns<AttributeAddress>;
+export declare const AttributeUpsertOp: MessageFns<AttributeUpsertOp>;
+export declare const AttributeRemoveOp: MessageFns<AttributeRemoveOp>;
+export declare const AttributeHistoryAppendOp: MessageFns<AttributeHistoryAppendOp>;
+export declare const DbOpBatch: MessageFns<DbOpBatch>;
+export declare const CanonicalDbOpBatch: MessageFns<CanonicalDbOpBatch>;
+export declare const ConversationRecordProvenance: MessageFns<ConversationRecordProvenance>;
+export declare const ConversationRecord: MessageFns<ConversationRecord>;
+export declare const ConversationLedger: MessageFns<ConversationLedger>;
+export declare const LadybugOverlayWal: MessageFns<LadybugOverlayWal>;
+export declare const LadybugOverlayCheckpoint: MessageFns<LadybugOverlayCheckpoint>;
+export declare const PhysicalIndexCheckpoint: MessageFns<PhysicalIndexCheckpoint>;
+export declare const RuntimeVariable: MessageFns<RuntimeVariable>;
+export declare const RuntimeLatch: MessageFns<RuntimeLatch>;
+export declare const RuntimeAction: MessageFns<RuntimeAction>;
+export declare const RuntimeTransaction: MessageFns<RuntimeTransaction>;
+export declare const ScheduledRuntimeEvent: MessageFns<ScheduledRuntimeEvent>;
+export declare const RuntimeLastValue: MessageFns<RuntimeLastValue>;
+export declare const TriggerRuntimeState: MessageFns<TriggerRuntimeState>;
+export declare const ScenarioRuntimeState: MessageFns<ScenarioRuntimeState>;
+export declare const PlayerAssetRef: MessageFns<PlayerAssetRef>;
+export declare const AssetLifecycleEvent: MessageFns<AssetLifecycleEvent>;
+export declare const AssetRefs: MessageFns<AssetRefs>;
+export declare const InFlightAttempt: MessageFns<InFlightAttempt>;
+export declare const InFlightItem: MessageFns<InFlightItem>;
+export declare const InFlightRecovery: MessageFns<InFlightRecovery>;
+export declare const IntegrityCheckpoint: MessageFns<IntegrityCheckpoint>;
+export declare const ExtensionSection: MessageFns<ExtensionSection>;
+export declare const SaveGeneration: MessageFns<SaveGeneration>;
+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 {};