@agentshouse/app-bridge 0.1.0-caae3da69c1c2 → 0.1.0-cac2ee656ded8

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 (113) hide show
  1. package/README.md +9 -9
  2. package/dist/index.d.ts +571 -18
  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 +21 -10
  7. package/dist/mdmodel/document.d.ts +15 -8
  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 +1 -1
  11. package/dist/mdmodel/house-model.d.ts +826 -0
  12. package/dist/mdmodel/house-references.d.ts +3 -0
  13. package/dist/mdmodel/index.d.ts +35 -13
  14. package/dist/mdmodel/kinds.d.ts +17 -0
  15. package/dist/mdmodel/markdown.d.ts +74 -0
  16. package/dist/mdmodel/paths.d.ts +10 -1
  17. package/dist/mdmodel/pattern.d.ts +9 -0
  18. package/dist/mdmodel/query/language.d.ts +253 -0
  19. package/dist/mdmodel/query/match.d.ts +13 -0
  20. package/dist/mdmodel/query/rows.d.ts +31 -0
  21. package/dist/mdmodel/query/sql.d.ts +38 -0
  22. package/dist/mdmodel/reserved.d.ts +5 -0
  23. package/dist/mdmodel/room-types.d.ts +6 -0
  24. package/dist/mdmodel/types.d.ts +29 -10
  25. package/dist/mdmodel/validate.d.ts +31 -6
  26. package/dist/mdruntime/actions.d.ts +25 -0
  27. package/dist/mdruntime/adapter.d.ts +159 -122
  28. package/dist/mdruntime/attached-model.d.ts +6 -0
  29. package/dist/mdruntime/binary.d.ts +0 -5
  30. package/dist/mdruntime/bootstrap.d.ts +43 -0
  31. package/dist/mdruntime/cell.d.ts +5 -0
  32. package/dist/mdruntime/chain.d.ts +11 -0
  33. package/dist/mdruntime/change-set.d.ts +10 -16
  34. package/dist/mdruntime/change.d.ts +32 -1
  35. package/dist/mdruntime/client.d.ts +37 -26
  36. package/dist/mdruntime/collection.d.ts +29 -22
  37. package/dist/mdruntime/compile.d.ts +17 -0
  38. package/dist/mdruntime/conversation-live.d.ts +146 -0
  39. package/dist/mdruntime/conversation-row.d.ts +32 -0
  40. package/dist/mdruntime/conversation.d.ts +68 -49
  41. package/dist/mdruntime/declaration.d.ts +9 -0
  42. package/dist/mdruntime/durability.d.ts +20 -4
  43. package/dist/mdruntime/failure.d.ts +3 -0
  44. package/dist/mdruntime/figures.d.ts +48 -0
  45. package/dist/mdruntime/holdings.d.ts +28 -0
  46. package/dist/mdruntime/identity.d.ts +5 -0
  47. package/dist/mdruntime/listing.d.ts +47 -0
  48. package/dist/mdruntime/live.d.ts +22 -0
  49. package/dist/mdruntime/media.d.ts +7 -0
  50. package/dist/mdruntime/messages.d.ts +55 -0
  51. package/dist/mdruntime/model.d.ts +8 -11
  52. package/dist/mdruntime/observation.d.ts +17 -3
  53. package/dist/mdruntime/opened.d.ts +21 -0
  54. package/dist/mdruntime/outcome.d.ts +47 -9
  55. package/dist/mdruntime/overlay.d.ts +7 -5
  56. package/dist/mdruntime/preparation.d.ts +19 -0
  57. package/dist/mdruntime/presence.d.ts +51 -0
  58. package/dist/mdruntime/query.d.ts +21 -207
  59. package/dist/mdruntime/reach.d.ts +20 -9
  60. package/dist/mdruntime/readiness.d.ts +14 -18
  61. package/dist/mdruntime/reads.d.ts +38 -0
  62. package/dist/mdruntime/recovery.d.ts +5 -2
  63. package/dist/mdruntime/refresh.d.ts +26 -0
  64. package/dist/mdruntime/replica.d.ts +50 -39
  65. package/dist/mdruntime/retried.d.ts +29 -0
  66. package/dist/mdruntime/room-draft.d.ts +28 -11
  67. package/dist/mdruntime/room-drafts.d.ts +23 -0
  68. package/dist/mdruntime/runtime.d.ts +33 -0
  69. package/dist/mdruntime/save.d.ts +43 -50
  70. package/dist/mdruntime/saves.d.ts +31 -0
  71. package/dist/mdruntime/search.d.ts +12 -95
  72. package/dist/mdruntime/seed.d.ts +11 -2
  73. package/dist/mdruntime/socket/admission.d.ts +6 -0
  74. package/dist/mdruntime/socket/answers.d.ts +5 -0
  75. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  76. package/dist/mdruntime/socket/session.d.ts +37 -0
  77. package/dist/mdruntime/socket.d.ts +66 -0
  78. package/dist/mdruntime/source.d.ts +53 -0
  79. package/dist/mdruntime/status.d.ts +4 -5
  80. package/dist/mdruntime/store/installs.d.ts +29 -0
  81. package/dist/mdruntime/store/readiness.d.ts +9 -0
  82. package/dist/mdruntime/store/records.d.ts +214 -0
  83. package/dist/mdruntime/store/room-held.d.ts +7 -0
  84. package/dist/mdruntime/store/space.d.ts +10 -0
  85. package/dist/mdruntime/store/watchers.d.ts +16 -0
  86. package/dist/mdruntime/store/writes.d.ts +23 -0
  87. package/dist/mdruntime/store.d.ts +111 -166
  88. package/dist/mdruntime/stored.d.ts +156 -0
  89. package/dist/mdruntime/surface.d.ts +88 -0
  90. package/dist/mdruntime/tables.d.ts +414 -0
  91. package/dist/mdruntime/tallies.d.ts +17 -0
  92. package/dist/mdruntime/transfer.d.ts +0 -5
  93. package/dist/mdruntime/wire.d.ts +82 -9
  94. package/dist/session-content/bounds.d.ts +7 -0
  95. package/dist/session-content/check.d.ts +18 -0
  96. package/dist/session-content/index.d.ts +7 -0
  97. package/dist/session-content/parts.d.ts +103 -0
  98. package/dist/session-content/state.d.ts +61 -0
  99. package/dist/session-content/turn.d.ts +328 -0
  100. package/dist/test-host.d.ts +7 -4
  101. package/dist/test-host.js +18 -28
  102. package/docs/families.md +65 -57
  103. package/package.json +8 -3
  104. package/dist/calls.d.ts +0 -957
  105. package/dist/calls.js +0 -1
  106. package/dist/mdmodel/blocks.d.ts +0 -10
  107. package/dist/mdmodel/condition.d.ts +0 -147
  108. package/dist/mdmodel/profile.d.ts +0 -5
  109. package/dist/mdruntime/connection.d.ts +0 -146
  110. package/dist/mdruntime/file.d.ts +0 -19
  111. package/dist/mdruntime/rows.d.ts +0 -38
  112. package/dist/mdruntime/shared.d.ts +0 -14
  113. package/dist/mdruntime/turn.d.ts +0 -8
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
 
@@ -42,8 +42,8 @@ async function manageSecurity(securityPath) {
42
42
 
43
43
  `bridge.runtime` resolves to the `MdRuntimeClient` of `@agentshouse/mdruntime/client`,
44
44
  whose README describes its members. Its `call(method, params)` is a remote procedure call
45
- to a House act, such as `call('member.list', { room_ref })`: `HouseMethods` names each
46
- with its `params`, `HouseParams<Name>`, and its `result`, `HouseResult<Name>`.
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>`.
47
47
 
48
48
  ## Test without a House
49
49
 
package/dist/index.d.ts CHANGED
@@ -1,6 +1,547 @@
1
1
  import type { MdRuntimeClient, Open } from './mdruntime/client.js';
2
- import type { HouseMethods } from './calls.js';
3
- export type { HouseMethods } from './calls.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
+ }
4
545
  export type HouseParams<Name extends string> = Name extends keyof HouseMethods ? HouseMethods[Name]['params'] : unknown;
5
546
  type CallResult = Awaited<ReturnType<MdRuntimeClient['call']>>;
6
547
  export type HouseResult<Name extends string> = Exclude<CallResult, {
@@ -21,6 +562,7 @@ export interface HouseCredentialState {
21
562
  readonly state: Open<'none' | 'held' | 'rejected'>;
22
563
  readonly expiresAt: number | null;
23
564
  }
565
+ export type HouseDatabaseFailure = 'damaged';
24
566
  export type HouseAnalyticsChoice = 'accept' | 'decline';
25
567
  export interface HouseAnalytics {
26
568
  readonly measures: boolean;
@@ -37,9 +579,9 @@ export interface HouseStatus {
37
579
  readonly sync: HouseSyncState | null;
38
580
  readonly refusal: {
39
581
  readonly code: string;
40
- readonly retryable: boolean;
41
582
  } | null;
42
583
  readonly loss: string | null;
584
+ readonly database: Open<HouseDatabaseFailure> | null;
43
585
  readonly analytics: HouseAnalytics;
44
586
  readonly serviceMode: Open<'open' | 'write-halted'> | null;
45
587
  readonly offline: boolean;
@@ -78,8 +620,6 @@ export interface HouseExternalRequest {
78
620
  readonly headers?: Readonly<Record<string, string>>;
79
621
  readonly body?: string;
80
622
  readonly body_base64?: string;
81
- readonly account?: string;
82
- readonly slot?: string;
83
623
  readonly room_ref?: string;
84
624
  }
85
625
  export type HouseExternalAnswer = {
@@ -102,6 +642,11 @@ export interface HouseAppMessage {
102
642
  }
103
643
  export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
104
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
+ }
105
650
  export interface HouseCeremonyRefused extends Error {
106
651
  readonly name: 'HouseCeremonyRefused';
107
652
  readonly code: Open<'house_ceremony_refused'>;
@@ -118,22 +663,29 @@ export interface HouseBrowserRefused extends Error {
118
663
  readonly code: string;
119
664
  readonly retryable: boolean;
120
665
  }
121
- export interface HouseTrialWithheld {
122
- readonly code: Open<'house_trial_withheld'>;
123
- readonly retryable: true;
124
- }
125
- export type HouseTask = unknown;
126
- export type HouseActivation = Open<'committed' | 'abandoned'>;
127
666
  export interface HouseCooperation {
128
- checkpoint(): Promise<void> | void;
129
- persist(): Promise<void> | void;
130
- capture(): Promise<HouseTask> | HouseTask;
131
- restore(task: HouseTask | null): Promise<void> | void;
132
- ready(): Promise<boolean> | boolean;
133
- settle(activation: HouseActivation): void;
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>;
134
685
  }
135
686
  export interface HouseBridge {
136
687
  readonly runtime: Promise<HouseRuntime>;
688
+ readonly chat: HouseChat;
137
689
  address(): string | null;
138
690
  onAddress(listener: (address: string) => void): () => void;
139
691
  push(address: string): Promise<string>;
@@ -141,7 +693,7 @@ export interface HouseBridge {
141
693
  ceremony(path: string): Promise<never>;
142
694
  install(): Promise<HouseInstallation>;
143
695
  notifications(on?: boolean): Promise<HouseNotifications>;
144
- setBadge(unread: readonly string[]): Promise<void>;
696
+ telegram(link?: true): Promise<HouseTelegram>;
145
697
  setTab(tab: HouseTab): void;
146
698
  sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
147
699
  sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
@@ -158,3 +710,4 @@ export interface HouseHeld {
158
710
  readonly houseBridge: HouseBridge;
159
711
  }
160
712
  export declare const houseBridge: () => HouseBridge;
713
+ export {};