@agentshouse/app-bridge 0.1.0-c58a055eeaa71 → 0.1.0-c59dd0a694516

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 (114) hide show
  1. package/README.md +11 -9
  2. package/dist/index.d.ts +620 -14
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/built-in.d.ts +3 -0
  5. package/dist/mdmodel/definition.d.ts +90 -0
  6. package/dist/mdmodel/divide.d.ts +2 -0
  7. package/dist/mdmodel/document.d.ts +21 -0
  8. package/dist/mdmodel/event.d.ts +76 -0
  9. package/dist/mdmodel/facts.d.ts +14 -0
  10. package/dist/mdmodel/fields.d.ts +5 -0
  11. package/dist/mdmodel/house-model.d.ts +865 -0
  12. package/dist/mdmodel/house-references/crockford.d.ts +3 -0
  13. package/dist/mdmodel/house-references/patterns.d.ts +8 -0
  14. package/dist/mdmodel/index.d.ts +43 -0
  15. package/dist/mdmodel/kinds.d.ts +17 -0
  16. package/dist/mdmodel/markdown.d.ts +74 -0
  17. package/dist/mdmodel/media-type.d.ts +71 -0
  18. package/dist/mdmodel/not-ready.d.ts +1 -0
  19. package/dist/mdmodel/paths.d.ts +39 -0
  20. package/dist/mdmodel/pattern.d.ts +9 -0
  21. package/dist/mdmodel/project.d.ts +21 -0
  22. package/dist/mdmodel/query/language.d.ts +253 -0
  23. package/dist/mdmodel/query/match.d.ts +13 -0
  24. package/dist/mdmodel/query/rows.d.ts +31 -0
  25. package/dist/mdmodel/query/sql.d.ts +38 -0
  26. package/dist/mdmodel/references.d.ts +3 -0
  27. package/dist/mdmodel/reserved.d.ts +5 -0
  28. package/dist/mdmodel/room-types.d.ts +6 -0
  29. package/dist/mdmodel/types.d.ts +172 -0
  30. package/dist/mdmodel/validate.d.ts +37 -0
  31. package/dist/mdmodel/version.d.ts +1 -0
  32. package/dist/mdmodel/yaml.d.ts +55 -0
  33. package/dist/mdruntime/actions.d.ts +25 -0
  34. package/dist/mdruntime/adapter.d.ts +575 -0
  35. package/dist/mdruntime/attached-model.d.ts +6 -0
  36. package/dist/mdruntime/authored.d.ts +87 -0
  37. package/dist/mdruntime/binary.d.ts +17 -0
  38. package/dist/mdruntime/bootstrap.d.ts +43 -0
  39. package/dist/mdruntime/cell.d.ts +5 -0
  40. package/dist/mdruntime/chain.d.ts +11 -0
  41. package/dist/mdruntime/change-set.d.ts +31 -0
  42. package/dist/mdruntime/change.d.ts +123 -0
  43. package/dist/mdruntime/client.d.ts +98 -0
  44. package/dist/mdruntime/collection.d.ts +49 -0
  45. package/dist/mdruntime/compile.d.ts +17 -0
  46. package/dist/mdruntime/conversation-live.d.ts +149 -0
  47. package/dist/mdruntime/conversation-row.d.ts +39 -0
  48. package/dist/mdruntime/conversation.d.ts +136 -0
  49. package/dist/mdruntime/declaration.d.ts +9 -0
  50. package/dist/mdruntime/durability.d.ts +30 -0
  51. package/dist/mdruntime/failure.d.ts +15 -0
  52. package/dist/mdruntime/figures.d.ts +48 -0
  53. package/dist/mdruntime/holdings.d.ts +28 -0
  54. package/dist/mdruntime/identity.d.ts +5 -0
  55. package/dist/mdruntime/install.d.ts +59 -0
  56. package/dist/mdruntime/listing.d.ts +51 -0
  57. package/dist/mdruntime/live.d.ts +24 -0
  58. package/dist/mdruntime/media.d.ts +12 -0
  59. package/dist/mdruntime/messages.d.ts +57 -0
  60. package/dist/mdruntime/model.d.ts +54 -0
  61. package/dist/mdruntime/observation.d.ts +59 -0
  62. package/dist/mdruntime/open.d.ts +1 -0
  63. package/dist/mdruntime/opened.d.ts +21 -0
  64. package/dist/mdruntime/outcome.d.ts +94 -0
  65. package/dist/mdruntime/overlay.d.ts +29 -0
  66. package/dist/mdruntime/preparation.d.ts +40 -0
  67. package/dist/mdruntime/presence.d.ts +57 -0
  68. package/dist/mdruntime/query.d.ts +87 -0
  69. package/dist/mdruntime/reach.d.ts +54 -0
  70. package/dist/mdruntime/readiness.d.ts +54 -0
  71. package/dist/mdruntime/reads.d.ts +38 -0
  72. package/dist/mdruntime/recovery.d.ts +27 -0
  73. package/dist/mdruntime/refresh.d.ts +26 -0
  74. package/dist/mdruntime/replica.d.ts +62 -0
  75. package/dist/mdruntime/retried.d.ts +29 -0
  76. package/dist/mdruntime/room-draft.d.ts +197 -0
  77. package/dist/mdruntime/room-drafts.d.ts +23 -0
  78. package/dist/mdruntime/runtime.d.ts +33 -0
  79. package/dist/mdruntime/save.d.ts +58 -0
  80. package/dist/mdruntime/saves.d.ts +31 -0
  81. package/dist/mdruntime/search.d.ts +21 -0
  82. package/dist/mdruntime/seed.d.ts +24 -0
  83. package/dist/mdruntime/socket/admission.d.ts +6 -0
  84. package/dist/mdruntime/socket/answers.d.ts +5 -0
  85. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  86. package/dist/mdruntime/socket/session.d.ts +37 -0
  87. package/dist/mdruntime/socket.d.ts +66 -0
  88. package/dist/mdruntime/source.d.ts +58 -0
  89. package/dist/mdruntime/status.d.ts +25 -0
  90. package/dist/mdruntime/store/installs.d.ts +29 -0
  91. package/dist/mdruntime/store/readiness.d.ts +10 -0
  92. package/dist/mdruntime/store/records.d.ts +222 -0
  93. package/dist/mdruntime/store/room-held.d.ts +7 -0
  94. package/dist/mdruntime/store/rooms-shown.d.ts +7 -0
  95. package/dist/mdruntime/store/space.d.ts +10 -0
  96. package/dist/mdruntime/store/watchers.d.ts +16 -0
  97. package/dist/mdruntime/store/writes.d.ts +23 -0
  98. package/dist/mdruntime/store.d.ts +125 -0
  99. package/dist/mdruntime/stored.d.ts +166 -0
  100. package/dist/mdruntime/surface.d.ts +89 -0
  101. package/dist/mdruntime/tables.d.ts +375 -0
  102. package/dist/mdruntime/tallies.d.ts +17 -0
  103. package/dist/mdruntime/transfer.d.ts +4 -0
  104. package/dist/mdruntime/wire.d.ts +288 -0
  105. package/dist/session-content/bounds.d.ts +7 -0
  106. package/dist/session-content/check.d.ts +18 -0
  107. package/dist/session-content/index.d.ts +7 -0
  108. package/dist/session-content/parts.d.ts +103 -0
  109. package/dist/session-content/state.d.ts +61 -0
  110. package/dist/session-content/turn.d.ts +328 -0
  111. package/dist/test-host.d.ts +15 -5
  112. package/dist/test-host.js +74 -23
  113. package/docs/families.md +93 -22
  114. package/package.json +8 -6
package/dist/index.d.ts CHANGED
@@ -1,5 +1,571 @@
1
- import type { MdRuntimeClient } from '@agentshouse/mdruntime/client';
2
- type Open<Value extends string> = Value | (string & {});
1
+ import type { MdRuntimeClient, Open } from './mdruntime/client.js';
2
+ export interface HouseMethods {
3
+ readonly "agent-functions/decide": {
4
+ readonly params: never;
5
+ readonly result: never;
6
+ };
7
+ readonly "agent-functions/requests/list": {
8
+ readonly params: {
9
+ readonly operation_id?: string;
10
+ readonly room_ref: string;
11
+ };
12
+ readonly result: {
13
+ readonly current: readonly {
14
+ readonly document: string;
15
+ readonly name: string;
16
+ }[];
17
+ readonly history: readonly {
18
+ readonly document: string;
19
+ readonly name: string;
20
+ }[];
21
+ };
22
+ };
23
+ readonly "apps/features/list": {
24
+ readonly params: {
25
+ readonly operation_id?: string;
26
+ };
27
+ readonly result: {
28
+ readonly features: readonly {
29
+ readonly allowed: boolean;
30
+ readonly feature: string;
31
+ }[];
32
+ };
33
+ };
34
+ readonly "apps/holders/list": {
35
+ readonly params: {
36
+ readonly operation_id?: string;
37
+ };
38
+ readonly result: {
39
+ readonly holders: readonly {
40
+ readonly name: string;
41
+ readonly user: string;
42
+ }[];
43
+ };
44
+ };
45
+ readonly "apps/messages/send": {
46
+ readonly params: {
47
+ readonly body: unknown;
48
+ readonly operation_id?: string;
49
+ readonly to: string;
50
+ };
51
+ readonly result: {
52
+ readonly [key: string]: never;
53
+ };
54
+ };
55
+ readonly "apps/relay/read": {
56
+ readonly params: {
57
+ readonly operation_id?: string;
58
+ };
59
+ readonly result: {
60
+ readonly expires_at: string;
61
+ readonly ice_servers: readonly {
62
+ readonly credential: string;
63
+ readonly urls: readonly string[];
64
+ readonly username: string;
65
+ }[];
66
+ };
67
+ };
68
+ readonly "apps/ring": {
69
+ readonly params: {
70
+ readonly operation_id?: string;
71
+ readonly to: string;
72
+ };
73
+ readonly result: {
74
+ readonly authority: string;
75
+ readonly log_epoch: string;
76
+ readonly position: string;
77
+ };
78
+ };
79
+ readonly "chats/assign": {
80
+ readonly params: {
81
+ readonly assignee: null | {
82
+ readonly agent: string;
83
+ } | {
84
+ readonly user: string;
85
+ };
86
+ readonly operation_id?: string;
87
+ readonly path: string;
88
+ readonly room_ref: string;
89
+ };
90
+ readonly result: {
91
+ readonly assignee: null | {
92
+ readonly agent: string;
93
+ readonly name: string;
94
+ } | {
95
+ readonly name: string;
96
+ readonly user: string;
97
+ };
98
+ readonly authority: string;
99
+ readonly log_epoch: string;
100
+ readonly path: string;
101
+ readonly position: string;
102
+ readonly return_to: null | {
103
+ readonly agent: string;
104
+ readonly name: string;
105
+ };
106
+ readonly room_ref: string;
107
+ readonly url: string;
108
+ };
109
+ };
110
+ readonly "chats/reply": {
111
+ readonly params: {
112
+ readonly operation_id?: string;
113
+ readonly path: string;
114
+ readonly room_ref: string;
115
+ readonly template?: {
116
+ readonly language: string;
117
+ readonly name: string;
118
+ };
119
+ readonly text?: string;
120
+ readonly values?: {
121
+ readonly [key: string]: string;
122
+ };
123
+ };
124
+ readonly result: {
125
+ readonly authority: string;
126
+ readonly log_epoch: string;
127
+ readonly path: string;
128
+ readonly position: string;
129
+ readonly room_ref: string;
130
+ readonly url: string;
131
+ };
132
+ };
133
+ readonly "chats/return": {
134
+ readonly params: {
135
+ readonly operation_id?: string;
136
+ readonly path: string;
137
+ readonly room_ref: string;
138
+ };
139
+ readonly result: {
140
+ readonly assignee: null | {
141
+ readonly agent: string;
142
+ readonly name: string;
143
+ } | {
144
+ readonly name: string;
145
+ readonly user: string;
146
+ };
147
+ readonly authority: string;
148
+ readonly log_epoch: string;
149
+ readonly path: string;
150
+ readonly position: string;
151
+ readonly return_to: null | {
152
+ readonly agent: string;
153
+ readonly name: string;
154
+ };
155
+ readonly room_ref: string;
156
+ readonly url: string;
157
+ };
158
+ };
159
+ readonly "chats/take-control": {
160
+ readonly params: {
161
+ readonly operation_id?: string;
162
+ readonly path: string;
163
+ readonly room_ref: string;
164
+ };
165
+ readonly result: {
166
+ readonly assignee: null | {
167
+ readonly agent: string;
168
+ readonly name: string;
169
+ } | {
170
+ readonly name: string;
171
+ readonly user: string;
172
+ };
173
+ readonly authority: string;
174
+ readonly log_epoch: string;
175
+ readonly path: string;
176
+ readonly position: string;
177
+ readonly return_to: null | {
178
+ readonly agent: string;
179
+ readonly name: string;
180
+ };
181
+ readonly room_ref: string;
182
+ readonly url: string;
183
+ };
184
+ };
185
+ readonly "conversations/create": {
186
+ readonly params: never;
187
+ readonly result: never;
188
+ };
189
+ readonly "conversations/delete": {
190
+ readonly params: never;
191
+ readonly result: never;
192
+ };
193
+ readonly "conversations/history/list": {
194
+ readonly params: never;
195
+ readonly result: never;
196
+ };
197
+ readonly "conversations/interaction/answer": {
198
+ readonly params: never;
199
+ readonly result: never;
200
+ };
201
+ readonly "conversations/interrupt": {
202
+ readonly params: never;
203
+ readonly result: never;
204
+ };
205
+ readonly "conversations/kill": {
206
+ readonly params: never;
207
+ readonly result: never;
208
+ };
209
+ readonly "conversations/option/set": {
210
+ readonly params: never;
211
+ readonly result: never;
212
+ };
213
+ readonly "conversations/rename": {
214
+ readonly params: never;
215
+ readonly result: never;
216
+ };
217
+ readonly "conversations/retry": {
218
+ readonly params: never;
219
+ readonly result: never;
220
+ };
221
+ readonly "conversations/send": {
222
+ readonly params: never;
223
+ readonly result: never;
224
+ };
225
+ readonly "conversations/take-out": {
226
+ readonly params: never;
227
+ readonly result: never;
228
+ };
229
+ readonly "rooms/access/list": {
230
+ readonly params: {
231
+ readonly operation_id?: string;
232
+ readonly room_ref: string;
233
+ };
234
+ readonly result: {
235
+ readonly authority: "administrator" | "member" | "owner";
236
+ readonly members: readonly {
237
+ readonly admitted_at: null | string;
238
+ readonly direct: readonly {
239
+ readonly level: null | "keep" | "open" | "search";
240
+ readonly namespace: string;
241
+ readonly operations: readonly ("erase" | "export" | "manageAccess" | "write")[];
242
+ }[];
243
+ readonly entries: readonly {
244
+ readonly level: null | "keep" | "open" | "search";
245
+ readonly namespace: string;
246
+ readonly operations: readonly ("erase" | "export" | "manageAccess" | "write")[];
247
+ readonly sources: readonly {
248
+ readonly kind: "direct" | "inherited";
249
+ readonly level: null | "keep" | "open" | "search";
250
+ readonly namespace: string;
251
+ readonly operations: readonly ("erase" | "export" | "manageAccess" | "write")[];
252
+ }[];
253
+ }[];
254
+ readonly key: null | string;
255
+ readonly schema_roles: readonly string[];
256
+ readonly through_space?: true;
257
+ readonly user: string;
258
+ readonly user_name: string;
259
+ }[];
260
+ readonly namespaces: readonly string[];
261
+ readonly owner: string;
262
+ readonly room_ref: string;
263
+ readonly url: string;
264
+ readonly viewer: string;
265
+ };
266
+ };
267
+ readonly "rooms/members/list": {
268
+ readonly params: {
269
+ readonly history?: boolean;
270
+ readonly operation_id?: string;
271
+ readonly room_ref: string;
272
+ };
273
+ readonly result: {
274
+ readonly history?: readonly {
275
+ readonly at: string;
276
+ readonly kind: "granted" | "revoked";
277
+ readonly user: string;
278
+ }[];
279
+ readonly members: readonly {
280
+ readonly access?: "manage" | "owner" | "read" | "write";
281
+ readonly copies?: "online_only" | "search_only";
282
+ readonly display_name: string;
283
+ readonly email?: string;
284
+ readonly member_document: null | string;
285
+ readonly owner: boolean;
286
+ readonly schema_roles?: readonly string[];
287
+ readonly since: null | string;
288
+ readonly through_space?: true;
289
+ readonly user: string;
290
+ }[];
291
+ };
292
+ };
293
+ readonly "rooms/settings/processing/read": {
294
+ readonly params: {
295
+ readonly operation_id?: string;
296
+ readonly path: string;
297
+ readonly room_ref: string;
298
+ };
299
+ readonly result: {
300
+ readonly embedding: {
301
+ readonly condition: null | {
302
+ readonly kind: "demand_failed" | "embed_again_failed";
303
+ readonly path: string;
304
+ };
305
+ readonly embedding_estimate: null | {
306
+ readonly documents: number;
307
+ readonly measured_tokens: number;
308
+ readonly unmeasured_documents: number;
309
+ };
310
+ readonly finished: boolean;
311
+ readonly indexed_chunks: number;
312
+ };
313
+ readonly explicit: readonly {
314
+ readonly path: string;
315
+ readonly policy: "Off" | "On";
316
+ }[];
317
+ readonly path: string;
318
+ readonly policy: {
319
+ readonly from: null | string;
320
+ readonly origin: "default" | "explicit" | "inherited";
321
+ readonly reason: null | "full_house_required" | "room_too_large";
322
+ readonly value: "Off" | "On";
323
+ };
324
+ readonly writable: boolean;
325
+ };
326
+ };
327
+ readonly "sites/submissions/create": {
328
+ readonly params: {
329
+ readonly content: string;
330
+ };
331
+ readonly result: {
332
+ readonly submitted: true;
333
+ };
334
+ };
335
+ readonly "storage/inventory/read": {
336
+ readonly params: {
337
+ readonly operation_id?: string;
338
+ readonly room_ref?: string;
339
+ readonly rooms?: "owned";
340
+ };
341
+ readonly result: {
342
+ readonly blob: {
343
+ readonly bytes: string;
344
+ readonly gigabytes: string;
345
+ };
346
+ readonly freshness: {
347
+ readonly state: "settled";
348
+ };
349
+ readonly indexed_text: {
350
+ readonly bytes: string;
351
+ readonly gigabytes: string;
352
+ };
353
+ readonly room_ref: string;
354
+ readonly total: {
355
+ readonly bytes: string;
356
+ readonly gigabytes: string;
357
+ };
358
+ readonly url: string;
359
+ } | {
360
+ readonly blob: {
361
+ readonly bytes: string;
362
+ readonly gigabytes: string;
363
+ };
364
+ readonly freshness: {
365
+ readonly state: "settled";
366
+ };
367
+ readonly indexed_text: {
368
+ readonly bytes: string;
369
+ readonly gigabytes: string;
370
+ };
371
+ readonly rooms?: readonly {
372
+ readonly blob: {
373
+ readonly bytes: string;
374
+ readonly gigabytes: string;
375
+ };
376
+ readonly freshness: {
377
+ readonly state: "settled";
378
+ };
379
+ readonly indexed_text: {
380
+ readonly bytes: string;
381
+ readonly gigabytes: string;
382
+ };
383
+ readonly room_ref: string;
384
+ readonly total: {
385
+ readonly bytes: string;
386
+ readonly gigabytes: string;
387
+ };
388
+ readonly url: string;
389
+ }[];
390
+ readonly site_images: {
391
+ readonly bound: string;
392
+ readonly bytes: string;
393
+ readonly payloads: string;
394
+ };
395
+ readonly total: {
396
+ readonly bytes: string;
397
+ readonly gigabytes: string;
398
+ };
399
+ };
400
+ };
401
+ readonly "triggers/fired/list": {
402
+ readonly params: {
403
+ readonly operation_id?: string;
404
+ readonly room_ref?: string;
405
+ };
406
+ readonly result: {
407
+ readonly events: readonly {
408
+ readonly actions: readonly ({
409
+ readonly cap: "address_submissions" | "app_sockets" | "environment_functions" | "export_starts" | "kit_connections" | "live_shares" | "open_uploads" | "ownership_offers" | "push_addresses" | "push_deliveries" | "room_triggers" | "service_keys" | "share_creations" | "share_room_creations" | "site_published_bytes" | "site_rooms" | "slot_rooms" | "spaces" | "waiting_web_wizards" | "writes";
410
+ readonly code: "cap_reached";
411
+ readonly outcome: "refused";
412
+ readonly position: number;
413
+ readonly retry_at: string;
414
+ } | {
415
+ readonly cap: "address_submissions" | "app_sockets" | "environment_functions" | "export_starts" | "kit_connections" | "live_shares" | "open_uploads" | "ownership_offers" | "push_addresses" | "push_deliveries" | "room_triggers" | "service_keys" | "share_creations" | "share_room_creations" | "site_published_bytes" | "site_rooms" | "slot_rooms" | "spaces" | "waiting_web_wizards" | "writes";
416
+ readonly code: "cap_reached";
417
+ readonly outcome: "refused";
418
+ readonly position: number;
419
+ } | {
420
+ readonly code: "agent_function_request_not_started";
421
+ readonly final?: true;
422
+ readonly outcome: "failed";
423
+ readonly position: number;
424
+ } | {
425
+ readonly code: "agent_function_unreadable";
426
+ readonly document_path: string;
427
+ readonly final: true;
428
+ readonly outcome: "failed";
429
+ readonly position: number;
430
+ } | {
431
+ readonly code: "agent_unavailable";
432
+ readonly outcome: "withdrawn";
433
+ readonly position: number;
434
+ } | {
435
+ readonly code: "function_failed";
436
+ readonly cut?: boolean;
437
+ readonly error: string;
438
+ readonly exit_code?: number;
439
+ readonly final: true;
440
+ readonly outcome: "failed";
441
+ readonly output?: string;
442
+ readonly position: number;
443
+ readonly run: string;
444
+ } | {
445
+ readonly code: "function_failed";
446
+ readonly error: string;
447
+ readonly final: true;
448
+ readonly outcome: "failed";
449
+ readonly position: number;
450
+ readonly release: string;
451
+ } | {
452
+ readonly code: "function_not_started";
453
+ readonly final?: true;
454
+ readonly outcome: "failed";
455
+ readonly position: number;
456
+ readonly tries: number;
457
+ } | {
458
+ readonly code: "internal_error";
459
+ readonly final: true;
460
+ readonly outcome: "failed";
461
+ readonly position: number;
462
+ } | {
463
+ readonly code: "limit_reached";
464
+ readonly limit: "reads";
465
+ readonly outcome: "refused";
466
+ readonly period: "day" | "minute";
467
+ readonly position: number;
468
+ readonly retry_at: string;
469
+ readonly value: string;
470
+ } | {
471
+ readonly code: "limit_reached";
472
+ readonly limit: "writes";
473
+ readonly outcome: "refused";
474
+ readonly period: "day" | "minute";
475
+ readonly position: number;
476
+ readonly retry_at: string;
477
+ } | {
478
+ readonly code: "limit_reached";
479
+ readonly limit: "blob" | "indexed_text";
480
+ readonly outcome: "refused";
481
+ readonly position: number;
482
+ readonly used: string;
483
+ readonly value: string;
484
+ } | {
485
+ readonly code: "limit_reached";
486
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
487
+ readonly outcome: "refused";
488
+ readonly position: number;
489
+ readonly retry_at: string;
490
+ } | {
491
+ readonly code: "limit_reached";
492
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
493
+ readonly outcome: "refused";
494
+ readonly position: number;
495
+ } | {
496
+ readonly code: "agent_function_retired" | "environment_offline" | "no_recipient" | "not_found" | "target_agent_unavailable";
497
+ readonly outcome: "no_target";
498
+ readonly position: number;
499
+ } | {
500
+ readonly code: string;
501
+ readonly outcome: "refused";
502
+ readonly position: number;
503
+ } | {
504
+ readonly conversations: number;
505
+ readonly outcome: "marked";
506
+ readonly position: number;
507
+ } | {
508
+ readonly cut?: boolean;
509
+ readonly exit_code?: number;
510
+ readonly outcome: "ran";
511
+ readonly output?: string;
512
+ readonly position: number;
513
+ readonly run: string;
514
+ } | {
515
+ readonly outcome: "continued";
516
+ readonly position: number;
517
+ readonly request: string;
518
+ } | {
519
+ readonly outcome: "notified";
520
+ readonly position: number;
521
+ readonly reached: number;
522
+ } | {
523
+ readonly outcome: "paused";
524
+ readonly position: number;
525
+ } | {
526
+ readonly outcome: "ran";
527
+ readonly position: number;
528
+ readonly release: string;
529
+ } | {
530
+ readonly outcome: "requested";
531
+ readonly position: number;
532
+ readonly request: string;
533
+ } | {
534
+ readonly outcome: "running";
535
+ readonly position: number;
536
+ readonly release: string;
537
+ } | {
538
+ readonly outcome: "running";
539
+ readonly position: number;
540
+ readonly run: string;
541
+ } | {
542
+ readonly outcome: "waiting";
543
+ readonly position: number;
544
+ })[];
545
+ readonly code?: "cap_reached";
546
+ readonly created_at: string;
547
+ readonly missed?: "failed" | "skipped";
548
+ readonly moment?: string;
549
+ readonly path?: string;
550
+ readonly room_ref?: string;
551
+ readonly trigger: string;
552
+ readonly url?: string;
553
+ }[];
554
+ };
555
+ };
556
+ }
557
+ export type HouseParams<Name extends string> = Name extends keyof HouseMethods ? HouseMethods[Name]['params'] : unknown;
558
+ type CallResult = Awaited<ReturnType<MdRuntimeClient['call']>>;
559
+ export type HouseResult<Name extends string> = Exclude<CallResult, {
560
+ readonly kind: 'action';
561
+ }> | (Extract<CallResult, {
562
+ readonly kind: 'action';
563
+ }> & {
564
+ readonly result: Name extends keyof HouseMethods ? HouseMethods[Name]['result'] : unknown;
565
+ });
566
+ export interface HouseRuntime extends Omit<MdRuntimeClient, 'call'> {
567
+ call<Name extends Open<keyof HouseMethods>>(method: Name, params: HouseParams<Name>): Promise<HouseResult<Name>>;
568
+ }
3
569
  export interface HouseSyncState {
4
570
  readonly state: string;
5
571
  readonly providerUnreachable: boolean;
@@ -8,6 +574,7 @@ export interface HouseCredentialState {
8
574
  readonly state: Open<'none' | 'held' | 'rejected'>;
9
575
  readonly expiresAt: number | null;
10
576
  }
577
+ export type HouseDatabaseFailure = 'damaged';
11
578
  export type HouseAnalyticsChoice = 'accept' | 'decline';
12
579
  export interface HouseAnalytics {
13
580
  readonly measures: boolean;
@@ -24,9 +591,9 @@ export interface HouseStatus {
24
591
  readonly sync: HouseSyncState | null;
25
592
  readonly refusal: {
26
593
  readonly code: string;
27
- readonly retryable: boolean;
28
594
  } | null;
29
595
  readonly loss: string | null;
596
+ readonly database: Open<HouseDatabaseFailure> | null;
30
597
  readonly analytics: HouseAnalytics;
31
598
  readonly serviceMode: Open<'open' | 'write-halted'> | null;
32
599
  readonly offline: boolean;
@@ -65,8 +632,7 @@ export interface HouseExternalRequest {
65
632
  readonly headers?: Readonly<Record<string, string>>;
66
633
  readonly body?: string;
67
634
  readonly body_base64?: string;
68
- readonly account?: string;
69
- readonly slot?: string;
635
+ readonly room_ref?: string;
70
636
  }
71
637
  export type HouseExternalAnswer = {
72
638
  readonly status: number;
@@ -88,11 +654,14 @@ export interface HouseAppMessage {
88
654
  }
89
655
  export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
90
656
  export type HouseNotifications = Open<'on' | 'off' | 'blocked' | 'unavailable'>;
91
- export interface HouseImageCopy {
92
- readonly attachment: string;
93
- readonly copy: string;
94
- readonly name: string;
95
- readonly media_type: string;
657
+ export interface HouseTelegram {
658
+ readonly state: Open<'available' | 'linked' | 'unavailable'>;
659
+ readonly name: string | null;
660
+ readonly username: string | null;
661
+ }
662
+ export interface HouseCeremonyEnded {
663
+ readonly said: string | null;
664
+ readonly done: boolean;
96
665
  }
97
666
  export interface HouseCeremonyRefused extends Error {
98
667
  readonly name: 'HouseCeremonyRefused';
@@ -110,18 +679,54 @@ export interface HouseBrowserRefused extends Error {
110
679
  readonly code: string;
111
680
  readonly retryable: boolean;
112
681
  }
682
+ export interface HouseCooperation {
683
+ placed(): Promise<void> | void;
684
+ }
685
+ export interface HouseChatOpened {
686
+ readonly conversation: string | null;
687
+ readonly agent: string | null;
688
+ }
689
+ export interface HouseChatOptions {
690
+ readonly conversation?: string | null;
691
+ readonly agent?: string | null;
692
+ readonly onOpen?: (opened: HouseChatOpened) => void;
693
+ readonly onLink?: (href: string) => void;
694
+ }
695
+ export interface HouseMountedChat {
696
+ update(options: HouseChatOptions): void;
697
+ unmount(): void;
698
+ }
699
+ export interface HouseChatButtonOptions {
700
+ readonly onOpen?: (opened: HouseChatOpened) => void;
701
+ readonly onLink?: (href: string) => void;
702
+ }
703
+ export interface HouseChatTarget {
704
+ readonly conversation?: string | null;
705
+ readonly agent?: string | null;
706
+ readonly docked?: boolean;
707
+ }
708
+ export interface HouseChatButton {
709
+ open(target?: HouseChatTarget): void;
710
+ hide(): void;
711
+ update(options: HouseChatButtonOptions): void;
712
+ unmount(): void;
713
+ }
714
+ export interface HouseChat {
715
+ mount(element: object, options?: HouseChatOptions): Promise<HouseMountedChat>;
716
+ mountButton(options?: HouseChatButtonOptions): Promise<HouseChatButton>;
717
+ }
113
718
  export interface HouseBridge {
114
- readonly runtime: Promise<MdRuntimeClient>;
719
+ readonly runtime: Promise<HouseRuntime>;
720
+ readonly chat: HouseChat;
115
721
  address(): string | null;
116
722
  onAddress(listener: (address: string) => void): () => void;
117
723
  push(address: string): Promise<string>;
118
724
  replace(address: string): Promise<string>;
119
- ceremony(path: string): Promise<never>;
725
+ ceremony(path: string): Promise<HouseCeremonyEnded>;
120
726
  install(): Promise<HouseInstallation>;
121
727
  notifications(on?: boolean): Promise<HouseNotifications>;
122
- setBadge(unread: readonly string[]): Promise<void>;
728
+ telegram(link?: true): Promise<HouseTelegram>;
123
729
  setTab(tab: HouseTab): void;
124
- readAttachment(room: string, attachment: string): Promise<HouseImageCopy | null>;
125
730
  sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
126
731
  sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
127
732
  callExternal(request: HouseExternalRequest): Promise<HouseExternalAnswer | HouseRefusal | null>;
@@ -131,6 +736,7 @@ export interface HouseBridge {
131
736
  onStatus(listener: (status: HouseStatus) => void): () => void;
132
737
  messages(listener: (message: HouseAppMessage) => void): () => void;
133
738
  analyticsConsent(choice: HouseAnalyticsChoice): void;
739
+ cooperate(cooperation: HouseCooperation): () => void;
134
740
  }
135
741
  export interface HouseHeld {
136
742
  readonly houseBridge: HouseBridge;