@agentshouse/app-bridge 0.1.0-ccf413b4e709d → 0.1.0-ccf6bf7d473e2

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 (110) hide show
  1. package/README.md +11 -9
  2. package/dist/index.d.ts +588 -7
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/built-in.d.ts +3 -0
  5. package/dist/mdmodel/crockford.d.ts +3 -0
  6. package/dist/mdmodel/definition.d.ts +90 -0
  7. package/dist/mdmodel/divide.d.ts +2 -0
  8. package/dist/mdmodel/document.d.ts +22 -0
  9. package/dist/mdmodel/event.d.ts +76 -0
  10. package/dist/mdmodel/facts.d.ts +14 -0
  11. package/dist/mdmodel/fields.d.ts +5 -0
  12. package/dist/mdmodel/house-model.d.ts +826 -0
  13. package/dist/mdmodel/house-references.d.ts +3 -0
  14. package/dist/mdmodel/index.d.ts +42 -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/paths.d.ts +34 -0
  19. package/dist/mdmodel/pattern.d.ts +9 -0
  20. package/dist/mdmodel/project.d.ts +21 -0
  21. package/dist/mdmodel/query/language.d.ts +253 -0
  22. package/dist/mdmodel/query/match.d.ts +13 -0
  23. package/dist/mdmodel/query/rows.d.ts +31 -0
  24. package/dist/mdmodel/query/sql.d.ts +38 -0
  25. package/dist/mdmodel/references.d.ts +3 -0
  26. package/dist/mdmodel/reserved.d.ts +5 -0
  27. package/dist/mdmodel/room-types.d.ts +6 -0
  28. package/dist/mdmodel/types.d.ts +181 -0
  29. package/dist/mdmodel/validate.d.ts +35 -0
  30. package/dist/mdmodel/version.d.ts +1 -0
  31. package/dist/mdmodel/yaml.d.ts +55 -0
  32. package/dist/mdruntime/actions.d.ts +25 -0
  33. package/dist/mdruntime/adapter.d.ts +540 -0
  34. package/dist/mdruntime/attached-model.d.ts +6 -0
  35. package/dist/mdruntime/binary.d.ts +17 -0
  36. package/dist/mdruntime/bootstrap.d.ts +43 -0
  37. package/dist/mdruntime/cell.d.ts +5 -0
  38. package/dist/mdruntime/chain.d.ts +11 -0
  39. package/dist/mdruntime/change-set.d.ts +31 -0
  40. package/dist/mdruntime/change.d.ts +119 -0
  41. package/dist/mdruntime/client.d.ts +97 -0
  42. package/dist/mdruntime/collection.d.ts +46 -0
  43. package/dist/mdruntime/compile.d.ts +17 -0
  44. package/dist/mdruntime/conversation-live.d.ts +146 -0
  45. package/dist/mdruntime/conversation-row.d.ts +32 -0
  46. package/dist/mdruntime/conversation.d.ts +135 -0
  47. package/dist/mdruntime/declaration.d.ts +9 -0
  48. package/dist/mdruntime/durability.d.ts +30 -0
  49. package/dist/mdruntime/failure.d.ts +15 -0
  50. package/dist/mdruntime/figures.d.ts +48 -0
  51. package/dist/mdruntime/holdings.d.ts +28 -0
  52. package/dist/mdruntime/identity.d.ts +5 -0
  53. package/dist/mdruntime/listing.d.ts +47 -0
  54. package/dist/mdruntime/live.d.ts +22 -0
  55. package/dist/mdruntime/media.d.ts +7 -0
  56. package/dist/mdruntime/messages.d.ts +55 -0
  57. package/dist/mdruntime/model.d.ts +54 -0
  58. package/dist/mdruntime/observation.d.ts +45 -0
  59. package/dist/mdruntime/open.d.ts +1 -0
  60. package/dist/mdruntime/opened.d.ts +21 -0
  61. package/dist/mdruntime/outcome.d.ts +94 -0
  62. package/dist/mdruntime/overlay.d.ts +29 -0
  63. package/dist/mdruntime/preparation.d.ts +19 -0
  64. package/dist/mdruntime/presence.d.ts +51 -0
  65. package/dist/mdruntime/query.d.ts +87 -0
  66. package/dist/mdruntime/reach.d.ts +55 -0
  67. package/dist/mdruntime/readiness.d.ts +48 -0
  68. package/dist/mdruntime/reads.d.ts +38 -0
  69. package/dist/mdruntime/recovery.d.ts +27 -0
  70. package/dist/mdruntime/refresh.d.ts +26 -0
  71. package/dist/mdruntime/replica.d.ts +62 -0
  72. package/dist/mdruntime/retried.d.ts +29 -0
  73. package/dist/mdruntime/room-draft.d.ts +172 -0
  74. package/dist/mdruntime/room-drafts.d.ts +23 -0
  75. package/dist/mdruntime/runtime.d.ts +33 -0
  76. package/dist/mdruntime/save.d.ts +58 -0
  77. package/dist/mdruntime/saves.d.ts +31 -0
  78. package/dist/mdruntime/search.d.ts +21 -0
  79. package/dist/mdruntime/seed.d.ts +24 -0
  80. package/dist/mdruntime/socket/admission.d.ts +6 -0
  81. package/dist/mdruntime/socket/answers.d.ts +5 -0
  82. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  83. package/dist/mdruntime/socket/session.d.ts +37 -0
  84. package/dist/mdruntime/socket.d.ts +66 -0
  85. package/dist/mdruntime/source.d.ts +53 -0
  86. package/dist/mdruntime/status.d.ts +25 -0
  87. package/dist/mdruntime/store/installs.d.ts +29 -0
  88. package/dist/mdruntime/store/readiness.d.ts +9 -0
  89. package/dist/mdruntime/store/records.d.ts +214 -0
  90. package/dist/mdruntime/store/room-held.d.ts +7 -0
  91. package/dist/mdruntime/store/space.d.ts +10 -0
  92. package/dist/mdruntime/store/watchers.d.ts +16 -0
  93. package/dist/mdruntime/store/writes.d.ts +23 -0
  94. package/dist/mdruntime/store.d.ts +121 -0
  95. package/dist/mdruntime/stored.d.ts +156 -0
  96. package/dist/mdruntime/surface.d.ts +88 -0
  97. package/dist/mdruntime/tables.d.ts +414 -0
  98. package/dist/mdruntime/tallies.d.ts +17 -0
  99. package/dist/mdruntime/transfer.d.ts +4 -0
  100. package/dist/mdruntime/wire.d.ts +295 -0
  101. package/dist/session-content/bounds.d.ts +7 -0
  102. package/dist/session-content/check.d.ts +18 -0
  103. package/dist/session-content/index.d.ts +7 -0
  104. package/dist/session-content/parts.d.ts +103 -0
  105. package/dist/session-content/state.d.ts +61 -0
  106. package/dist/session-content/turn.d.ts +328 -0
  107. package/dist/test-host.d.ts +8 -2
  108. package/dist/test-host.js +48 -12
  109. package/docs/families.md +70 -20
  110. package/package.json +8 -6
package/README.md CHANGED
@@ -3,16 +3,16 @@
3
3
  The types of the agents.house App bridge, an accessor and an in-page test host.
4
4
  House builds the bridge object in every App it serves and hands it to the page
5
5
  before the App's own scripts run; `houseBridge()` returns that object, so an App
6
- carries no bridge code of its own. It carries eleven families: navigation,
7
- ceremonies, installation, notifications, status, Site image reads, App release
8
- code, external calls, App messages and App and Site screenshot reads.
9
- [docs/families.md](docs/families.md) describes each and the test host.
6
+ carries no bridge code of its own. It carries these families: navigation,
7
+ ceremonies, installation, notifications, Telegram, status, App
8
+ release code, external calls, App messages, App and Site screenshot reads and the
9
+ Chat. [docs/families.md](docs/families.md) describes each and the test host.
10
10
 
11
11
  The bridge carries no credential handling and no Runtime family. House builds
12
- the MD Runtime client into the page beside the bridge, and `bridge.runtime`
13
- resolves to that client, so the App imports and constructs none.
12
+ the MD Runtime client into the page beside the bridge and serves it the Chat, so
13
+ the App imports, constructs and bundles neither: `bridge.runtime` resolves to the client.
14
14
 
15
- House's `find_command` "App" is the guide to building an App or a Site.
15
+ House's guide to building an App is its Guide's `apps/` pages, which `guide/open` opens.
16
16
 
17
17
  ## Use
18
18
 
@@ -40,8 +40,10 @@ async function manageSecurity(securityPath) {
40
40
  }
41
41
  ```
42
42
 
43
- `bridge.runtime` resolves to the `MdRuntimeClient` of
44
- `@agentshouse/mdruntime/client`, whose README describes its members.
43
+ `bridge.runtime` resolves to the `MdRuntimeClient` of `@agentshouse/mdruntime/client`,
44
+ whose README describes its members. Its `call(method, params)` is a remote procedure call
45
+ to a House act by its name, such as `call('rooms/members/list', { room_ref })`: `HouseMethods`
46
+ names each with House's own input, `HouseParams<Name>`, and answer, `HouseResult<Name>`.
45
47
 
46
48
  ## Test without a House
47
49
 
package/dist/index.d.ts CHANGED
@@ -1,5 +1,559 @@
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 | "room_too_large" | "unfunded";
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_unavailable";
421
+ readonly outcome: "withdrawn";
422
+ readonly position: number;
423
+ } | {
424
+ readonly code: "function_failed";
425
+ readonly cut?: boolean;
426
+ readonly error: string;
427
+ readonly exit_code?: number;
428
+ readonly final: true;
429
+ readonly outcome: "failed";
430
+ readonly output?: string;
431
+ readonly position: number;
432
+ readonly run: string;
433
+ } | {
434
+ readonly code: "function_failed";
435
+ readonly error: string;
436
+ readonly final: true;
437
+ readonly outcome: "failed";
438
+ readonly position: number;
439
+ readonly release: string;
440
+ } | {
441
+ readonly code: "function_not_started";
442
+ readonly final?: true;
443
+ readonly outcome: "failed";
444
+ readonly position: number;
445
+ readonly tries: number;
446
+ } | {
447
+ readonly code: "limit_reached";
448
+ readonly limit: "reads";
449
+ readonly outcome: "refused";
450
+ readonly period: "day" | "minute";
451
+ readonly position: number;
452
+ readonly retry_at: string;
453
+ readonly value: string;
454
+ } | {
455
+ readonly code: "limit_reached";
456
+ readonly limit: "writes";
457
+ readonly outcome: "refused";
458
+ readonly period: "day" | "minute";
459
+ readonly position: number;
460
+ readonly retry_at: string;
461
+ } | {
462
+ readonly code: "limit_reached";
463
+ readonly limit: "blob" | "indexed_text";
464
+ readonly outcome: "refused";
465
+ readonly position: number;
466
+ readonly used: string;
467
+ readonly value: string;
468
+ } | {
469
+ readonly code: "limit_reached";
470
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
471
+ readonly outcome: "refused";
472
+ readonly position: number;
473
+ readonly retry_at: string;
474
+ } | {
475
+ readonly code: "limit_reached";
476
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
477
+ readonly outcome: "refused";
478
+ readonly position: number;
479
+ } | {
480
+ readonly code: "agent_function_request_not_started" | "internal_error";
481
+ readonly outcome: "failed";
482
+ readonly position: number;
483
+ } | {
484
+ readonly code: "agent_function_retired" | "environment_offline" | "no_recipient" | "not_found" | "target_agent_unavailable";
485
+ readonly outcome: "no_target";
486
+ readonly position: number;
487
+ } | {
488
+ readonly code: string;
489
+ readonly outcome: "refused";
490
+ readonly position: number;
491
+ } | {
492
+ readonly conversations: number;
493
+ readonly outcome: "marked";
494
+ readonly position: number;
495
+ } | {
496
+ readonly cut?: boolean;
497
+ readonly exit_code?: number;
498
+ readonly outcome: "ran";
499
+ readonly output?: string;
500
+ readonly position: number;
501
+ readonly run: string;
502
+ } | {
503
+ readonly outcome: "continued";
504
+ readonly position: number;
505
+ readonly request: string;
506
+ } | {
507
+ readonly outcome: "notified";
508
+ readonly position: number;
509
+ readonly reached: number;
510
+ } | {
511
+ readonly outcome: "paused";
512
+ readonly position: number;
513
+ } | {
514
+ readonly outcome: "ran";
515
+ readonly position: number;
516
+ readonly release: string;
517
+ } | {
518
+ readonly outcome: "requested";
519
+ readonly position: number;
520
+ readonly request: string;
521
+ } | {
522
+ readonly outcome: "running";
523
+ readonly position: number;
524
+ readonly release: string;
525
+ } | {
526
+ readonly outcome: "running";
527
+ readonly position: number;
528
+ readonly run: string;
529
+ } | {
530
+ readonly outcome: "waiting";
531
+ readonly position: number;
532
+ })[];
533
+ readonly code?: "cap_reached";
534
+ readonly created_at: string;
535
+ readonly missed?: "failed" | "skipped";
536
+ readonly moment?: string;
537
+ readonly path?: string;
538
+ readonly room_ref?: string;
539
+ readonly trigger: string;
540
+ readonly url?: string;
541
+ }[];
542
+ };
543
+ };
544
+ }
545
+ export type HouseParams<Name extends string> = Name extends keyof HouseMethods ? HouseMethods[Name]['params'] : unknown;
546
+ type CallResult = Awaited<ReturnType<MdRuntimeClient['call']>>;
547
+ export type HouseResult<Name extends string> = Exclude<CallResult, {
548
+ readonly kind: 'action';
549
+ }> | (Extract<CallResult, {
550
+ readonly kind: 'action';
551
+ }> & {
552
+ readonly result: Name extends keyof HouseMethods ? HouseMethods[Name]['result'] : unknown;
553
+ });
554
+ export interface HouseRuntime extends Omit<MdRuntimeClient, 'call'> {
555
+ call<Name extends Open<keyof HouseMethods>>(method: Name, params: HouseParams<Name>): Promise<HouseResult<Name>>;
556
+ }
3
557
  export interface HouseSyncState {
4
558
  readonly state: string;
5
559
  readonly providerUnreachable: boolean;
@@ -8,6 +562,7 @@ export interface HouseCredentialState {
8
562
  readonly state: Open<'none' | 'held' | 'rejected'>;
9
563
  readonly expiresAt: number | null;
10
564
  }
565
+ export type HouseDatabaseFailure = 'damaged';
11
566
  export type HouseAnalyticsChoice = 'accept' | 'decline';
12
567
  export interface HouseAnalytics {
13
568
  readonly measures: boolean;
@@ -24,9 +579,9 @@ export interface HouseStatus {
24
579
  readonly sync: HouseSyncState | null;
25
580
  readonly refusal: {
26
581
  readonly code: string;
27
- readonly retryable: boolean;
28
582
  } | null;
29
583
  readonly loss: string | null;
584
+ readonly database: Open<HouseDatabaseFailure> | null;
30
585
  readonly analytics: HouseAnalytics;
31
586
  readonly serviceMode: Open<'open' | 'write-halted'> | null;
32
587
  readonly offline: boolean;
@@ -65,8 +620,7 @@ export interface HouseExternalRequest {
65
620
  readonly headers?: Readonly<Record<string, string>>;
66
621
  readonly body?: string;
67
622
  readonly body_base64?: string;
68
- readonly account?: string;
69
- readonly slot?: string;
623
+ readonly room_ref?: string;
70
624
  }
71
625
  export type HouseExternalAnswer = {
72
626
  readonly status: number;
@@ -88,6 +642,11 @@ export interface HouseAppMessage {
88
642
  }
89
643
  export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
90
644
  export type HouseNotifications = Open<'on' | 'off' | 'blocked' | 'unavailable'>;
645
+ export interface HouseTelegram {
646
+ readonly state: Open<'available' | 'linked' | 'unavailable'>;
647
+ readonly name: string | null;
648
+ readonly username: string | null;
649
+ }
91
650
  export interface HouseCeremonyRefused extends Error {
92
651
  readonly name: 'HouseCeremonyRefused';
93
652
  readonly code: Open<'house_ceremony_refused'>;
@@ -104,8 +663,29 @@ export interface HouseBrowserRefused extends Error {
104
663
  readonly code: string;
105
664
  readonly retryable: boolean;
106
665
  }
666
+ export interface HouseCooperation {
667
+ placed(): Promise<void> | void;
668
+ }
669
+ export interface HouseChatOpened {
670
+ readonly conversation: string | null;
671
+ readonly agent: string | null;
672
+ }
673
+ export interface HouseChatOptions {
674
+ readonly conversation?: string | null;
675
+ readonly agent?: string | null;
676
+ readonly onOpen?: (opened: HouseChatOpened) => void;
677
+ readonly onLink?: (href: string) => void;
678
+ }
679
+ export interface HouseMountedChat {
680
+ update(options: HouseChatOptions): void;
681
+ unmount(): void;
682
+ }
683
+ export interface HouseChat {
684
+ mount(element: object, options?: HouseChatOptions): Promise<HouseMountedChat>;
685
+ }
107
686
  export interface HouseBridge {
108
- readonly runtime: Promise<MdRuntimeClient>;
687
+ readonly runtime: Promise<HouseRuntime>;
688
+ readonly chat: HouseChat;
109
689
  address(): string | null;
110
690
  onAddress(listener: (address: string) => void): () => void;
111
691
  push(address: string): Promise<string>;
@@ -113,7 +693,7 @@ export interface HouseBridge {
113
693
  ceremony(path: string): Promise<never>;
114
694
  install(): Promise<HouseInstallation>;
115
695
  notifications(on?: boolean): Promise<HouseNotifications>;
116
- setBadge(unread: readonly string[]): Promise<void>;
696
+ telegram(link?: true): Promise<HouseTelegram>;
117
697
  setTab(tab: HouseTab): void;
118
698
  sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
119
699
  sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
@@ -124,6 +704,7 @@ export interface HouseBridge {
124
704
  onStatus(listener: (status: HouseStatus) => void): () => void;
125
705
  messages(listener: (message: HouseAppMessage) => void): () => void;
126
706
  analyticsConsent(choice: HouseAnalyticsChoice): void;
707
+ cooperate(cooperation: HouseCooperation): () => void;
127
708
  }
128
709
  export interface HouseHeld {
129
710
  readonly houseBridge: HouseBridge;