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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/LICENSE +46 -0
  2. package/dist/entity-prop-envelope.d.ts +36 -0
  3. package/dist/entity-prop-envelope.js +50 -0
  4. package/dist/gen/v1/auth.d.ts +46 -0
  5. package/dist/gen/v1/auth.js +278 -0
  6. package/dist/gen/v1/billing.d.ts +71 -0
  7. package/dist/gen/v1/billing.js +521 -0
  8. package/dist/gen/v1/common.d.ts +65 -0
  9. package/dist/gen/v1/common.js +387 -0
  10. package/dist/gen/v1/llm.d.ts +317 -0
  11. package/dist/gen/v1/llm.js +3557 -0
  12. package/dist/gen/v1/mcp.d.ts +373 -0
  13. package/dist/gen/v1/mcp.js +3190 -0
  14. package/dist/gen/v1/moderation.d.ts +51 -0
  15. package/dist/gen/v1/moderation.js +368 -0
  16. package/dist/gen/v1/neutral_scenario_source.d.ts +80 -0
  17. package/dist/gen/v1/neutral_scenario_source.js +569 -0
  18. package/dist/gen/v1/relation_kind.d.ts +105 -0
  19. package/dist/gen/v1/relation_kind.js +562 -0
  20. package/dist/gen/v1/rest/admin.d.ts +432 -0
  21. package/dist/gen/v1/rest/admin.js +4957 -0
  22. package/dist/gen/v1/rest/asset.d.ts +205 -0
  23. package/dist/gen/v1/rest/asset.js +2200 -0
  24. package/dist/gen/v1/rest/auth.d.ts +275 -0
  25. package/dist/gen/v1/rest/auth.js +2896 -0
  26. package/dist/gen/v1/rest/billing.d.ts +101 -0
  27. package/dist/gen/v1/rest/billing.js +866 -0
  28. package/dist/gen/v1/rest/common.d.ts +179 -0
  29. package/dist/gen/v1/rest/common.js +1358 -0
  30. package/dist/gen/v1/rest/creator.d.ts +354 -0
  31. package/dist/gen/v1/rest/creator.js +4169 -0
  32. package/dist/gen/v1/rest/messaging.d.ts +190 -0
  33. package/dist/gen/v1/rest/messaging.js +2017 -0
  34. package/dist/gen/v1/rest/moderation.d.ts +61 -0
  35. package/dist/gen/v1/rest/moderation.js +569 -0
  36. package/dist/gen/v1/rest/pet.d.ts +98 -0
  37. package/dist/gen/v1/rest/pet.js +698 -0
  38. package/dist/gen/v1/rest/project_transfer.d.ts +470 -0
  39. package/dist/gen/v1/rest/project_transfer.js +5266 -0
  40. package/dist/gen/v1/rest/scenario.d.ts +756 -0
  41. package/dist/gen/v1/rest/scenario.js +8768 -0
  42. package/dist/gen/v1/rest/stock_bounty.d.ts +154 -0
  43. package/dist/gen/v1/rest/stock_bounty.js +1547 -0
  44. package/dist/gen/v1/rest/stocks.d.ts +465 -0
  45. package/dist/gen/v1/rest/stocks.js +5200 -0
  46. package/dist/gen/v1/rest/support_ticket.d.ts +61 -0
  47. package/dist/gen/v1/rest/support_ticket.js +511 -0
  48. package/dist/gen/v1/rest/users.d.ts +292 -0
  49. package/dist/gen/v1/rest/users.js +2879 -0
  50. package/dist/gen/v1/rest/violations.d.ts +52 -0
  51. package/dist/gen/v1/rest/violations.js +338 -0
  52. package/dist/gen/v1/sav.d.ts +987 -0
  53. package/dist/gen/v1/sav.js +12327 -0
  54. package/dist/gen/v1/save.d.ts +68 -0
  55. package/dist/gen/v1/save.js +595 -0
  56. package/dist/gen/v1/scenario_part_source.d.ts +94 -0
  57. package/dist/gen/v1/scenario_part_source.js +913 -0
  58. package/dist/gen/v1/session.d.ts +49 -0
  59. package/dist/gen/v1/session.js +311 -0
  60. package/dist/gen/v1/view_state.d.ts +267 -0
  61. package/dist/gen/v1/view_state.js +3239 -0
  62. package/dist/gen/v1/world.d.ts +82 -0
  63. package/dist/gen/v1/world.js +707 -0
  64. package/dist/gen/v1/world_memory.d.ts +545 -0
  65. package/dist/gen/v1/world_memory.js +5816 -0
  66. package/dist/gen/v1/world_memory_privacy.d.ts +96 -0
  67. package/dist/gen/v1/world_memory_privacy.js +994 -0
  68. package/dist/gen/v1/ws_frame.d.ts +1626 -0
  69. package/dist/gen/v1/ws_frame.js +18253 -0
  70. package/dist/index.d.ts +2 -0
  71. package/dist/index.js +5 -0
  72. package/dist/ladybug-extraction.d.ts +36 -0
  73. package/dist/ladybug-extraction.js +1 -0
  74. package/package.json +65 -0
@@ -0,0 +1,545 @@
1
+ import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
2
+ export declare enum WorldMemoryRecallPurpose {
3
+ WORLD_MEMORY_RECALL_PURPOSE_UNSPECIFIED = 0,
4
+ WORLD_MEMORY_RECALL_PURPOSE_DIRECTOR_INVESTIGATE = 1,
5
+ WORLD_MEMORY_RECALL_PURPOSE_TRIGGER_PREFILTER = 2,
6
+ WORLD_MEMORY_RECALL_PURPOSE_SCRIBE_READ = 3,
7
+ WORLD_MEMORY_RECALL_PURPOSE_TRUSTED_AUDIT = 4,
8
+ UNRECOGNIZED = -1
9
+ }
10
+ export declare function worldMemoryRecallPurposeFromJSON(object: any): WorldMemoryRecallPurpose;
11
+ export declare function worldMemoryRecallPurposeToJSON(object: WorldMemoryRecallPurpose): string;
12
+ export declare enum WorldMemoryRetrievalChannel {
13
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_UNSPECIFIED = 0,
14
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_ENTITY_VECTOR = 1,
15
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_ENTITY_BM25 = 2,
16
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_RELATIONAL = 3,
17
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_TRIE = 4,
18
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_NGRAM = 5,
19
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_EPISODE_VECTOR = 6,
20
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_EPISODE_BM25 = 7,
21
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_DERIVED_VECTOR = 8,
22
+ WORLD_MEMORY_RETRIEVAL_CHANNEL_DERIVED_BM25 = 9,
23
+ UNRECOGNIZED = -1
24
+ }
25
+ export declare function worldMemoryRetrievalChannelFromJSON(object: any): WorldMemoryRetrievalChannel;
26
+ export declare function worldMemoryRetrievalChannelToJSON(object: WorldMemoryRetrievalChannel): string;
27
+ export declare enum WorldMemoryClass {
28
+ WORLD_MEMORY_CLASS_UNSPECIFIED = 0,
29
+ WORLD_MEMORY_CLASS_WORLD_FACT = 1,
30
+ WORLD_MEMORY_CLASS_EPISODE = 2,
31
+ WORLD_MEMORY_CLASS_OBSERVATION = 3,
32
+ WORLD_MEMORY_CLASS_EXPERIENCE = 4,
33
+ WORLD_MEMORY_CLASS_SUMMARY = 5,
34
+ UNRECOGNIZED = -1
35
+ }
36
+ export declare function worldMemoryClassFromJSON(object: any): WorldMemoryClass;
37
+ export declare function worldMemoryClassToJSON(object: WorldMemoryClass): string;
38
+ export declare enum WorldMemoryEvidenceStatus {
39
+ WORLD_MEMORY_EVIDENCE_STATUS_UNSPECIFIED = 0,
40
+ WORLD_MEMORY_EVIDENCE_STATUS_CURRENT = 1,
41
+ WORLD_MEMORY_EVIDENCE_STATUS_HISTORICAL = 2,
42
+ WORLD_MEMORY_EVIDENCE_STATUS_CONTRADICTED = 3,
43
+ UNRECOGNIZED = -1
44
+ }
45
+ export declare function worldMemoryEvidenceStatusFromJSON(object: any): WorldMemoryEvidenceStatus;
46
+ export declare function worldMemoryEvidenceStatusToJSON(object: WorldMemoryEvidenceStatus): string;
47
+ export declare enum WorldMemoryMutationOperation {
48
+ WORLD_MEMORY_MUTATION_OPERATION_UNSPECIFIED = 0,
49
+ WORLD_MEMORY_MUTATION_OPERATION_UPSERT = 1,
50
+ WORLD_MEMORY_MUTATION_OPERATION_REMOVE = 2,
51
+ UNRECOGNIZED = -1
52
+ }
53
+ export declare function worldMemoryMutationOperationFromJSON(object: any): WorldMemoryMutationOperation;
54
+ export declare function worldMemoryMutationOperationToJSON(object: WorldMemoryMutationOperation): string;
55
+ export declare enum WorldMemoryDerivedKind {
56
+ WORLD_MEMORY_DERIVED_KIND_UNSPECIFIED = 0,
57
+ WORLD_MEMORY_DERIVED_KIND_OBSERVATION = 1,
58
+ WORLD_MEMORY_DERIVED_KIND_EXPERIENCE = 2,
59
+ WORLD_MEMORY_DERIVED_KIND_SUMMARY = 3,
60
+ UNRECOGNIZED = -1
61
+ }
62
+ export declare function worldMemoryDerivedKindFromJSON(object: any): WorldMemoryDerivedKind;
63
+ export declare function worldMemoryDerivedKindToJSON(object: WorldMemoryDerivedKind): string;
64
+ export declare enum WorldMemoryChangeOutcome {
65
+ WORLD_MEMORY_CHANGE_OUTCOME_UNSPECIFIED = 0,
66
+ WORLD_MEMORY_CHANGE_OUTCOME_COMMITTED = 1,
67
+ WORLD_MEMORY_CHANGE_OUTCOME_DERIVED = 2,
68
+ WORLD_MEMORY_CHANGE_OUTCOME_RETRACTED = 3,
69
+ WORLD_MEMORY_CHANGE_OUTCOME_ERASED = 4,
70
+ WORLD_MEMORY_CHANGE_OUTCOME_REPLAYED = 5,
71
+ UNRECOGNIZED = -1
72
+ }
73
+ export declare function worldMemoryChangeOutcomeFromJSON(object: any): WorldMemoryChangeOutcome;
74
+ export declare function worldMemoryChangeOutcomeToJSON(object: WorldMemoryChangeOutcome): string;
75
+ export declare enum WorldMemoryClaimClassification {
76
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_UNSPECIFIED = 0,
77
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_DUPLICATE = 1,
78
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_EXTENDS_SOURCE = 2,
79
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_UPDATES = 3,
80
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_LATE_HISTORY = 4,
81
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_CONTRADICTS = 5,
82
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_RETRACTS = 6,
83
+ WORLD_MEMORY_CLAIM_CLASSIFICATION_ERASES = 7,
84
+ UNRECOGNIZED = -1
85
+ }
86
+ export declare function worldMemoryClaimClassificationFromJSON(object: any): WorldMemoryClaimClassification;
87
+ export declare function worldMemoryClaimClassificationToJSON(object: WorldMemoryClaimClassification): string;
88
+ /**
89
+ * 可信宿主签发的世界版本。该消息只允许由宿主随 recall/change 回执返回,或作为
90
+ * temporal revision view 的已验证 token 使用;接收端必须重算 revision_sha256 并校验
91
+ * 全部绑定字段,不能把客户端传入的字段当成授权依据。
92
+ */
93
+ export interface WorldRevision {
94
+ revision_sha256: Uint8Array;
95
+ account_id: string;
96
+ account_epoch: string;
97
+ scenario_id: string;
98
+ save_id: string;
99
+ worldline_id: string;
100
+ runtime_lease_id: string;
101
+ runtime_lease_epoch: string;
102
+ wasm_session_epoch: string;
103
+ sav_generation: string;
104
+ catalog_revision: string;
105
+ canonical_head_operation_id?: string | undefined;
106
+ canonical_head_write_seq: string;
107
+ physical_state_sha256: Uint8Array;
108
+ _unknownFields?: {
109
+ [key: number]: Uint8Array[];
110
+ } | undefined;
111
+ }
112
+ export interface WorldMemoryCurrentView {
113
+ _unknownFields?: {
114
+ [key: number]: Uint8Array[];
115
+ } | undefined;
116
+ }
117
+ export interface WorldMemoryWorldTimeView {
118
+ world_seconds: string;
119
+ _unknownFields?: {
120
+ [key: number]: Uint8Array[];
121
+ } | undefined;
122
+ }
123
+ /**
124
+ * current、世界时间与精确 revision 三种读取视图。revision 视图必须使用可信宿主
125
+ * 先前签发且仍可由 checkpoint + canonical WAL 重放的 WorldRevision。
126
+ */
127
+ export interface WorldMemoryTemporalView {
128
+ current?: WorldMemoryCurrentView | undefined;
129
+ world_time?: WorldMemoryWorldTimeView | undefined;
130
+ revision?: WorldRevision | undefined;
131
+ _unknownFields?: {
132
+ [key: number]: Uint8Array[];
133
+ } | undefined;
134
+ }
135
+ export interface WorldMemoryWorldInterval {
136
+ valid_from_world_seconds: string;
137
+ valid_to_world_seconds_exclusive?: string | undefined;
138
+ _unknownFields?: {
139
+ [key: number]: Uint8Array[];
140
+ } | undefined;
141
+ }
142
+ export interface WorldMemoryBitemporalInterval {
143
+ recorded_from_write_seq: string;
144
+ recorded_to_write_seq_exclusive?: string | undefined;
145
+ valid_from_world_seconds: string;
146
+ valid_to_world_seconds_exclusive?: string | undefined;
147
+ _unknownFields?: {
148
+ [key: number]: Uint8Array[];
149
+ } | undefined;
150
+ }
151
+ export interface WorldMemoryRecallQuestion {
152
+ question_id: string;
153
+ goal: string;
154
+ hint?: string | undefined;
155
+ context?: string | undefined;
156
+ _unknownFields?: {
157
+ [key: number]: Uint8Array[];
158
+ } | undefined;
159
+ }
160
+ /** 作用域不在请求中;宿主依据当前绑定的 WorldMemory 实例执行召回。 */
161
+ export interface WorldMemoryRecallRequest {
162
+ contract_version: number;
163
+ request_id: string;
164
+ questions: WorldMemoryRecallQuestion[];
165
+ purpose: WorldMemoryRecallPurpose;
166
+ temporal_view?: WorldMemoryTemporalView | undefined;
167
+ _unknownFields?: {
168
+ [key: number]: Uint8Array[];
169
+ } | undefined;
170
+ }
171
+ export interface WorldMemoryEvidenceItem {
172
+ evidence_id: string;
173
+ subject_id?: string | undefined;
174
+ memory_class: WorldMemoryClass;
175
+ snippet: string;
176
+ status: WorldMemoryEvidenceStatus;
177
+ temporal?: WorldMemoryBitemporalInterval | undefined;
178
+ source_sha256: Uint8Array;
179
+ source_count: number;
180
+ matched_question_ids: string[];
181
+ retrieval_channels: WorldMemoryRetrievalChannel[];
182
+ score: number;
183
+ truncated: boolean;
184
+ _unknownFields?: {
185
+ [key: number]: Uint8Array[];
186
+ } | undefined;
187
+ }
188
+ export interface WorldMemoryEvidenceBudgetReceipt {
189
+ soft_token_budget: number;
190
+ hard_token_budget: number;
191
+ used_tokens: number;
192
+ encoded_bytes: number;
193
+ deadline_ms: number;
194
+ elapsed_ms: number;
195
+ truncated: boolean;
196
+ _unknownFields?: {
197
+ [key: number]: Uint8Array[];
198
+ } | undefined;
199
+ }
200
+ /** Judge 只接收该最小证据包,不能接收完整 LadybugDB、作者私有数据或未蒸馏候选。 */
201
+ export interface WorldMemoryEvidenceBundle {
202
+ contract_version: number;
203
+ request_id: string;
204
+ revision?: WorldRevision | undefined;
205
+ temporal_view?: WorldMemoryTemporalView | undefined;
206
+ items: WorldMemoryEvidenceItem[];
207
+ candidate_count: number;
208
+ judged_count: number;
209
+ revision_retry_count: number;
210
+ evidence_bundle_sha256: Uint8Array;
211
+ budget?: WorldMemoryEvidenceBudgetReceipt | undefined;
212
+ _unknownFields?: {
213
+ [key: number]: Uint8Array[];
214
+ } | undefined;
215
+ }
216
+ export interface WorldMemoryOriginalMessageSource {
217
+ message_id: string;
218
+ turn_id: string;
219
+ source_sha256: Uint8Array;
220
+ _unknownFields?: {
221
+ [key: number]: Uint8Array[];
222
+ } | undefined;
223
+ }
224
+ export interface WorldMemoryRecordSource {
225
+ memory_id: string;
226
+ source_sha256: Uint8Array;
227
+ _unknownFields?: {
228
+ [key: number]: Uint8Array[];
229
+ } | undefined;
230
+ }
231
+ export interface WorldMemoryHostCauseSource {
232
+ cause_id: string;
233
+ source_sha256: Uint8Array;
234
+ _unknownFields?: {
235
+ [key: number]: Uint8Array[];
236
+ } | undefined;
237
+ }
238
+ export interface WorldMemoryRetrievedEvidenceSource {
239
+ request_id: string;
240
+ evidence_id: string;
241
+ source_sha256: Uint8Array;
242
+ _unknownFields?: {
243
+ [key: number]: Uint8Array[];
244
+ } | undefined;
245
+ }
246
+ export interface WorldMemoryChangeSource {
247
+ original_message?: WorldMemoryOriginalMessageSource | undefined;
248
+ memory_record?: WorldMemoryRecordSource | undefined;
249
+ host_cause?: WorldMemoryHostCauseSource | undefined;
250
+ retrieved_evidence?: WorldMemoryRetrievedEvidenceSource | undefined;
251
+ _unknownFields?: {
252
+ [key: number]: Uint8Array[];
253
+ } | undefined;
254
+ }
255
+ /** 由可信宿主从当前 turn/attempt 封印;LLM 只能引用,不能生成或替换。 */
256
+ export interface WorldMemoryHostSealedCause {
257
+ cause_id: string;
258
+ cause_sha256: Uint8Array;
259
+ turn_id?: string | undefined;
260
+ attempt_id?: string | undefined;
261
+ _unknownFields?: {
262
+ [key: number]: Uint8Array[];
263
+ } | undefined;
264
+ }
265
+ export interface WorldMemoryEntityMutation {
266
+ operation: WorldMemoryMutationOperation;
267
+ entity_id: string;
268
+ entity_kind: string;
269
+ canonical_props: Uint8Array;
270
+ props_codec: string;
271
+ valid?: WorldMemoryWorldInterval | undefined;
272
+ confidence?: number | undefined;
273
+ _unknownFields?: {
274
+ [key: number]: Uint8Array[];
275
+ } | undefined;
276
+ }
277
+ export interface WorldMemoryRelationMutation {
278
+ operation: WorldMemoryMutationOperation;
279
+ relation_id?: string | undefined;
280
+ source_entity_id: string;
281
+ target_entity_id: string;
282
+ relation_kind: string;
283
+ canonical_props: Uint8Array;
284
+ props_codec: string;
285
+ valid?: WorldMemoryWorldInterval | undefined;
286
+ confidence?: number | undefined;
287
+ _unknownFields?: {
288
+ [key: number]: Uint8Array[];
289
+ } | undefined;
290
+ }
291
+ export interface WorldMemoryAttributeMutation {
292
+ operation: WorldMemoryMutationOperation;
293
+ entity_id: string;
294
+ attribute_path: string;
295
+ canonical_value: Uint8Array;
296
+ value_codec: string;
297
+ valid?: WorldMemoryWorldInterval | undefined;
298
+ confidence?: number | undefined;
299
+ _unknownFields?: {
300
+ [key: number]: Uint8Array[];
301
+ } | undefined;
302
+ }
303
+ /**
304
+ * 事件是可检索 episode 的输入,不允许调用方指定 WmEpisode/WmClaim/WmDerived 表名、
305
+ * 内部 relation kind、向量索引或 claim current pointer。
306
+ */
307
+ export interface WorldMemoryEventMutation {
308
+ event_id: string;
309
+ event_type: string;
310
+ summary: string;
311
+ actor_entity_ids: string[];
312
+ target_entity_ids: string[];
313
+ occurred?: WorldMemoryWorldInterval | undefined;
314
+ _unknownFields?: {
315
+ [key: number]: Uint8Array[];
316
+ } | undefined;
317
+ }
318
+ export interface WorldMemoryCanonicalMutation {
319
+ mutation_id: string;
320
+ entity?: WorldMemoryEntityMutation | undefined;
321
+ relation?: WorldMemoryRelationMutation | undefined;
322
+ attribute?: WorldMemoryAttributeMutation | undefined;
323
+ event?: WorldMemoryEventMutation | undefined;
324
+ _unknownFields?: {
325
+ [key: number]: Uint8Array[];
326
+ } | undefined;
327
+ }
328
+ export interface WorldMemoryCommitIntent {
329
+ mutations: WorldMemoryCanonicalMutation[];
330
+ _unknownFields?: {
331
+ [key: number]: Uint8Array[];
332
+ } | undefined;
333
+ }
334
+ /**
335
+ * 由可信宿主在解析完 Scribe 结果后生成的精确 embedding 正文。content_utf8 是送入
336
+ * embedding provider 的原始 UTF-8 bytes,不允许 Player、作者视图、MCP 或模型根据
337
+ * entity props 再次推导。order 必须从 0 连续递增,content_sha256 必须逐字节重算。
338
+ */
339
+ export interface WorldMemoryEmbeddingContentIntent {
340
+ intent_id: string;
341
+ order: number;
342
+ /** v2 必须为空;Player 只可在 commit 时从 durable message authority 物化正文。 */
343
+ content_utf8: Uint8Array;
344
+ content_sha256: Uint8Array;
345
+ entity_id: string;
346
+ source_message_id: string;
347
+ canonicalization_version: number;
348
+ source_sha256: Uint8Array;
349
+ _unknownFields?: {
350
+ [key: number]: Uint8Array[];
351
+ } | undefined;
352
+ }
353
+ /**
354
+ * v2 是 content-free envelope。ordered_intents_sha256 封印按 wire order 排列的
355
+ * identity/source digest;bundle_sha256 进一步封印 bundle_version、intent_count 与每项完整
356
+ * identity/hash image。所有可变长项统一使用 LP(x)=u32_be(len)||x。
357
+ * canonical bytes 使用固定 domain、u32 big-endian 整数、u32 big-endian 长度前缀 bytes:
358
+ * order = SHA256("world-engines/world-memory-embedding-content-order/v2\\0" || count ||
359
+ * repeated(order || LP(intent_id) || LP(entity_id) || LP(source_message_id) ||
360
+ * canonicalization_version || LP(content_sha256) || LP(source_sha256)));
361
+ * bundle = SHA256("world-engines/world-memory-embedding-content-bundle/v2\\0" ||
362
+ * bundle_version || intent_count || LP(order_digest) || repeated(与 order 相同的完整项))。
363
+ * 接收端必须拒绝非 v2、非空 content_utf8、非 32-byte hash 或 identity/order 漂移。
364
+ */
365
+ export interface WorldMemoryEmbeddingContentBundle {
366
+ intent_count: number;
367
+ intents: WorldMemoryEmbeddingContentIntent[];
368
+ ordered_intents_sha256: Uint8Array;
369
+ bundle_sha256: Uint8Array;
370
+ bundle_version: number;
371
+ _unknownFields?: {
372
+ [key: number]: Uint8Array[];
373
+ } | undefined;
374
+ }
375
+ /**
376
+ * Edge 从真实 Scribe/Judge/repair provider dispatch、ExactFlat v2 结算与成功 ACK 的
377
+ * world_event_emit 序列一次性封印。集合与 receipt 均使用 domain-separated SHA-256 和
378
+ * LP(x)=u32_be(len)||x;evidence_receipt_sha256 不包含 proposal_sha256,避免循环。
379
+ */
380
+ export interface PlayerTurnCommitEvidenceV1 {
381
+ evidence_version: number;
382
+ turn_id: string;
383
+ assistant_message_id: string;
384
+ extraction_message_id: string;
385
+ proposal_id: string;
386
+ idempotency_key: string;
387
+ player_turn_contract_sha256: Uint8Array;
388
+ canonical_payload_sha256: Uint8Array;
389
+ billing_call_count: number;
390
+ provider_request_set_sha256: Uint8Array;
391
+ billing_authorization_set_sha256: Uint8Array;
392
+ billing_settlement_set_sha256: Uint8Array;
393
+ ledger_unit: string;
394
+ ledger_unit_scale: number;
395
+ ledger_version: number;
396
+ charged_units: string;
397
+ staged_mutation_count: number;
398
+ staged_trigger_upsert_count: number;
399
+ staged_mutation_plan_sha256: Uint8Array;
400
+ embedding_content_bundle_sha256: Uint8Array;
401
+ evidence_receipt_sha256: Uint8Array;
402
+ _unknownFields?: {
403
+ [key: number]: Uint8Array[];
404
+ } | undefined;
405
+ }
406
+ /** 仅本地 scheduler capability 可提交;Director、Scribe、作者、LLM 与 MCP 不得调用。 */
407
+ export interface WorldMemoryDeriveIntent {
408
+ kind: WorldMemoryDerivedKind;
409
+ text: string;
410
+ coverage_ids: string[];
411
+ summarized_through_operation_id?: string | undefined;
412
+ valid?: WorldMemoryWorldInterval | undefined;
413
+ model: string;
414
+ provider: string;
415
+ prompt_version: string;
416
+ tokenizer_version: string;
417
+ _unknownFields?: {
418
+ [key: number]: Uint8Array[];
419
+ } | undefined;
420
+ }
421
+ export interface WorldMemoryRetractIntent {
422
+ selector_id: string;
423
+ _unknownFields?: {
424
+ [key: number]: Uint8Array[];
425
+ } | undefined;
426
+ }
427
+ export interface WorldMemoryEraseIntent {
428
+ selector_id: string;
429
+ authorization_sha256: Uint8Array;
430
+ _unknownFields?: {
431
+ [key: number]: Uint8Array[];
432
+ } | undefined;
433
+ }
434
+ /**
435
+ * 单个 typed proposal 取代逐条 world_event_emit。expected_revision_sha256 只引用当前
436
+ * 宿主绑定 revision,proposal 本身没有任何可选择 scope 的字段。接收端还必须拒绝
437
+ * source 全部为 retrieved_evidence 的回灌请求。
438
+ */
439
+ export interface WorldMemoryChangeProposal {
440
+ contract_version: number;
441
+ proposal_id: string;
442
+ expected_revision_sha256: Uint8Array;
443
+ sealed_cause?: WorldMemoryHostSealedCause | undefined;
444
+ idempotency_key: string;
445
+ canonical_payload_sha256: Uint8Array;
446
+ active_source_reachability_sha256: Uint8Array;
447
+ source_refs: WorldMemoryChangeSource[];
448
+ embedding_content_bundle?: WorldMemoryEmbeddingContentBundle | undefined;
449
+ commit?: WorldMemoryCommitIntent | undefined;
450
+ derive?: WorldMemoryDeriveIntent | undefined;
451
+ retract?: WorldMemoryRetractIntent | undefined;
452
+ erase?: WorldMemoryEraseIntent | undefined;
453
+ /**
454
+ * SHA256("world-engines/world-memory-change-proposal/v1\\0" || protobuf_encode(proposal)),
455
+ * 其中编码前必须清空本字段;schema 不含 map/unknown fields。因而 embedding bundle 的
456
+ * count/order/digests 与正文都属于 proposal hash image。
457
+ */
458
+ proposal_sha256: Uint8Array;
459
+ /**
460
+ * 仅由 Edge 从本轮冻结的 PlayerTurnContract 投影;Player、作者 iframe、MCP 与模型
461
+ * 均不得提供或替换。接收端必须校验为 32 bytes,并与本轮 contract hash 完全一致。
462
+ */
463
+ player_turn_contract_sha256: Uint8Array;
464
+ /**
465
+ * 仅由 Edge 在全部 staged ToolCall ACK 成功后封印;Player 只严格解码并交给 opaque
466
+ * commit handle,作者 iframe、MCP、模型与客户端 ACK 均不得提供或替换。
467
+ */
468
+ player_turn_commit_evidence?: PlayerTurnCommitEvidenceV1 | undefined;
469
+ _unknownFields?: {
470
+ [key: number]: Uint8Array[];
471
+ } | undefined;
472
+ }
473
+ /**
474
+ * 可信宿主完成 Ladybug、canonical WAL、索引与 SAV barrier 后签发的唯一 terminal
475
+ * receipt。previous_revision/revision 均必须重新校验 scope 与摘要;replayed 通过 outcome
476
+ * 表达,仍返回原 operation_id 和同一 receipt_sha256。
477
+ */
478
+ export interface WorldMemoryChangeReceipt {
479
+ contract_version: number;
480
+ proposal_id: string;
481
+ operation_id: string;
482
+ idempotency_key: string;
483
+ canonical_payload_sha256: Uint8Array;
484
+ previous_revision?: WorldRevision | undefined;
485
+ revision?: WorldRevision | undefined;
486
+ canonical_wal_sha256: Uint8Array;
487
+ state_sha256: Uint8Array;
488
+ receipt_sha256: Uint8Array;
489
+ outcome: WorldMemoryChangeOutcome;
490
+ classification?: WorldMemoryClaimClassification | undefined;
491
+ completed_at_ms: string;
492
+ _unknownFields?: {
493
+ [key: number]: Uint8Array[];
494
+ } | undefined;
495
+ }
496
+ export declare const WorldRevision: MessageFns<WorldRevision>;
497
+ export declare const WorldMemoryCurrentView: MessageFns<WorldMemoryCurrentView>;
498
+ export declare const WorldMemoryWorldTimeView: MessageFns<WorldMemoryWorldTimeView>;
499
+ export declare const WorldMemoryTemporalView: MessageFns<WorldMemoryTemporalView>;
500
+ export declare const WorldMemoryWorldInterval: MessageFns<WorldMemoryWorldInterval>;
501
+ export declare const WorldMemoryBitemporalInterval: MessageFns<WorldMemoryBitemporalInterval>;
502
+ export declare const WorldMemoryRecallQuestion: MessageFns<WorldMemoryRecallQuestion>;
503
+ export declare const WorldMemoryRecallRequest: MessageFns<WorldMemoryRecallRequest>;
504
+ export declare const WorldMemoryEvidenceItem: MessageFns<WorldMemoryEvidenceItem>;
505
+ export declare const WorldMemoryEvidenceBudgetReceipt: MessageFns<WorldMemoryEvidenceBudgetReceipt>;
506
+ export declare const WorldMemoryEvidenceBundle: MessageFns<WorldMemoryEvidenceBundle>;
507
+ export declare const WorldMemoryOriginalMessageSource: MessageFns<WorldMemoryOriginalMessageSource>;
508
+ export declare const WorldMemoryRecordSource: MessageFns<WorldMemoryRecordSource>;
509
+ export declare const WorldMemoryHostCauseSource: MessageFns<WorldMemoryHostCauseSource>;
510
+ export declare const WorldMemoryRetrievedEvidenceSource: MessageFns<WorldMemoryRetrievedEvidenceSource>;
511
+ export declare const WorldMemoryChangeSource: MessageFns<WorldMemoryChangeSource>;
512
+ export declare const WorldMemoryHostSealedCause: MessageFns<WorldMemoryHostSealedCause>;
513
+ export declare const WorldMemoryEntityMutation: MessageFns<WorldMemoryEntityMutation>;
514
+ export declare const WorldMemoryRelationMutation: MessageFns<WorldMemoryRelationMutation>;
515
+ export declare const WorldMemoryAttributeMutation: MessageFns<WorldMemoryAttributeMutation>;
516
+ export declare const WorldMemoryEventMutation: MessageFns<WorldMemoryEventMutation>;
517
+ export declare const WorldMemoryCanonicalMutation: MessageFns<WorldMemoryCanonicalMutation>;
518
+ export declare const WorldMemoryCommitIntent: MessageFns<WorldMemoryCommitIntent>;
519
+ export declare const WorldMemoryEmbeddingContentIntent: MessageFns<WorldMemoryEmbeddingContentIntent>;
520
+ export declare const WorldMemoryEmbeddingContentBundle: MessageFns<WorldMemoryEmbeddingContentBundle>;
521
+ export declare const PlayerTurnCommitEvidenceV1: MessageFns<PlayerTurnCommitEvidenceV1>;
522
+ export declare const WorldMemoryDeriveIntent: MessageFns<WorldMemoryDeriveIntent>;
523
+ export declare const WorldMemoryRetractIntent: MessageFns<WorldMemoryRetractIntent>;
524
+ export declare const WorldMemoryEraseIntent: MessageFns<WorldMemoryEraseIntent>;
525
+ export declare const WorldMemoryChangeProposal: MessageFns<WorldMemoryChangeProposal>;
526
+ export declare const WorldMemoryChangeReceipt: MessageFns<WorldMemoryChangeReceipt>;
527
+ type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
528
+ 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 {} ? {
529
+ [K in keyof T]?: DeepPartial<T[K]>;
530
+ } : Partial<T>;
531
+ type KeysOfUnion<T> = T extends T ? keyof T : never;
532
+ type Exact<P, I extends P> = P extends Builtin ? P : P & {
533
+ [K in keyof P]: Exact<P[K], I[K]>;
534
+ } & {
535
+ [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
536
+ };
537
+ interface MessageFns<T> {
538
+ encode(message: T, writer?: BinaryWriter): BinaryWriter;
539
+ decode(input: BinaryReader | Uint8Array, length?: number): T;
540
+ fromJSON(object: any): T;
541
+ toJSON(message: T): unknown;
542
+ create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
543
+ fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
544
+ }
545
+ export {};