@agentshouse/app-bridge 0.1.0-c4999e714a13d → 0.1.0-c4acf776964fd

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 +9 -9
  2. package/dist/index.d.ts +576 -19
  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 +20 -10
  6. package/dist/mdmodel/document.d.ts +14 -7
  7. package/dist/mdmodel/event.d.ts +76 -0
  8. package/dist/mdmodel/facts.d.ts +14 -0
  9. package/dist/mdmodel/fields.d.ts +1 -1
  10. package/dist/mdmodel/house-model.d.ts +826 -0
  11. package/dist/mdmodel/house-references/crockford.d.ts +3 -0
  12. package/dist/mdmodel/house-references/patterns.d.ts +8 -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/media-type.d.ts +71 -0
  17. package/dist/mdmodel/paths.d.ts +10 -1
  18. package/dist/mdmodel/pattern.d.ts +9 -0
  19. package/dist/mdmodel/query/language.d.ts +253 -0
  20. package/dist/mdmodel/query/match.d.ts +13 -0
  21. package/dist/mdmodel/query/rows.d.ts +31 -0
  22. package/dist/mdmodel/query/sql.d.ts +38 -0
  23. package/dist/mdmodel/reserved.d.ts +5 -0
  24. package/dist/mdmodel/room-types.d.ts +6 -0
  25. package/dist/mdmodel/types.d.ts +22 -7
  26. package/dist/mdmodel/validate.d.ts +10 -6
  27. package/dist/mdruntime/actions.d.ts +25 -0
  28. package/dist/mdruntime/adapter.d.ts +144 -122
  29. package/dist/mdruntime/attached-model.d.ts +6 -0
  30. package/dist/mdruntime/binary.d.ts +0 -5
  31. package/dist/mdruntime/bootstrap.d.ts +43 -0
  32. package/dist/mdruntime/cell.d.ts +5 -0
  33. package/dist/mdruntime/chain.d.ts +2 -1
  34. package/dist/mdruntime/change-set.d.ts +5 -7
  35. package/dist/mdruntime/change.d.ts +1 -0
  36. package/dist/mdruntime/client.d.ts +34 -28
  37. package/dist/mdruntime/collection.d.ts +28 -7
  38. package/dist/mdruntime/compile.d.ts +7 -0
  39. package/dist/mdruntime/conversation-live.d.ts +146 -0
  40. package/dist/mdruntime/conversation-row.d.ts +32 -0
  41. package/dist/mdruntime/conversation.d.ts +68 -49
  42. package/dist/mdruntime/declaration.d.ts +9 -0
  43. package/dist/mdruntime/durability.d.ts +19 -4
  44. package/dist/mdruntime/failure.d.ts +3 -0
  45. package/dist/mdruntime/figures.d.ts +48 -0
  46. package/dist/mdruntime/holdings.d.ts +28 -0
  47. package/dist/mdruntime/identity.d.ts +5 -0
  48. package/dist/mdruntime/listing.d.ts +47 -0
  49. package/dist/mdruntime/live.d.ts +22 -0
  50. package/dist/mdruntime/media.d.ts +7 -0
  51. package/dist/mdruntime/messages.d.ts +55 -0
  52. package/dist/mdruntime/model.d.ts +8 -11
  53. package/dist/mdruntime/observation.d.ts +5 -3
  54. package/dist/mdruntime/opened.d.ts +1 -1
  55. package/dist/mdruntime/outcome.d.ts +24 -7
  56. package/dist/mdruntime/overlay.d.ts +6 -1
  57. package/dist/mdruntime/preparation.d.ts +19 -0
  58. package/dist/mdruntime/presence.d.ts +51 -0
  59. package/dist/mdruntime/query.d.ts +20 -207
  60. package/dist/mdruntime/reach.d.ts +20 -13
  61. package/dist/mdruntime/readiness.d.ts +14 -18
  62. package/dist/mdruntime/reads.d.ts +38 -0
  63. package/dist/mdruntime/recovery.d.ts +3 -0
  64. package/dist/mdruntime/refresh.d.ts +26 -0
  65. package/dist/mdruntime/replica.d.ts +13 -18
  66. package/dist/mdruntime/retried.d.ts +29 -0
  67. package/dist/mdruntime/room-draft.d.ts +25 -10
  68. package/dist/mdruntime/room-drafts.d.ts +23 -0
  69. package/dist/mdruntime/runtime.d.ts +33 -0
  70. package/dist/mdruntime/save.d.ts +42 -84
  71. package/dist/mdruntime/saves.d.ts +31 -0
  72. package/dist/mdruntime/search.d.ts +12 -95
  73. package/dist/mdruntime/seed.d.ts +11 -2
  74. package/dist/mdruntime/socket/admission.d.ts +6 -0
  75. package/dist/mdruntime/socket/answers.d.ts +5 -0
  76. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  77. package/dist/mdruntime/socket/session.d.ts +37 -0
  78. package/dist/mdruntime/socket.d.ts +66 -0
  79. package/dist/mdruntime/source.d.ts +53 -0
  80. package/dist/mdruntime/status.d.ts +4 -5
  81. package/dist/mdruntime/store/installs.d.ts +29 -0
  82. package/dist/mdruntime/store/readiness.d.ts +9 -0
  83. package/dist/mdruntime/store/records.d.ts +214 -0
  84. package/dist/mdruntime/store/room-held.d.ts +7 -0
  85. package/dist/mdruntime/store/space.d.ts +10 -0
  86. package/dist/mdruntime/store/watchers.d.ts +16 -0
  87. package/dist/mdruntime/store/writes.d.ts +23 -0
  88. package/dist/mdruntime/store.d.ts +116 -183
  89. package/dist/mdruntime/stored.d.ts +68 -54
  90. package/dist/mdruntime/surface.d.ts +88 -0
  91. package/dist/mdruntime/tables.d.ts +159 -64
  92. package/dist/mdruntime/tallies.d.ts +17 -0
  93. package/dist/mdruntime/transfer.d.ts +0 -5
  94. package/dist/mdruntime/wire.d.ts +71 -14
  95. package/dist/session-content/bounds.d.ts +7 -0
  96. package/dist/session-content/check.d.ts +18 -0
  97. package/dist/session-content/index.d.ts +7 -0
  98. package/dist/session-content/parts.d.ts +103 -0
  99. package/dist/session-content/state.d.ts +61 -0
  100. package/dist/session-content/turn.d.ts +328 -0
  101. package/dist/test-host.d.ts +7 -4
  102. package/dist/test-host.js +18 -28
  103. package/docs/families.md +65 -57
  104. package/package.json +8 -3
  105. package/dist/calls.d.ts +0 -1033
  106. package/dist/calls.js +0 -1
  107. package/dist/mdmodel/blocks.d.ts +0 -10
  108. package/dist/mdmodel/condition.d.ts +0 -161
  109. package/dist/mdmodel/links.d.ts +0 -28
  110. package/dist/mdmodel/profile.d.ts +0 -5
  111. package/dist/mdruntime/connection.d.ts +0 -152
  112. package/dist/mdruntime/file.d.ts +0 -11
  113. package/dist/mdruntime/shared.d.ts +0 -15
  114. 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,553 @@
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_function_request_not_started";
421
+ readonly final?: true;
422
+ readonly outcome: "failed";
423
+ readonly position: number;
424
+ } | {
425
+ readonly code: "agent_unavailable";
426
+ readonly outcome: "withdrawn";
427
+ readonly position: number;
428
+ } | {
429
+ readonly code: "function_failed";
430
+ readonly cut?: boolean;
431
+ readonly error: string;
432
+ readonly exit_code?: number;
433
+ readonly final: true;
434
+ readonly outcome: "failed";
435
+ readonly output?: string;
436
+ readonly position: number;
437
+ readonly run: string;
438
+ } | {
439
+ readonly code: "function_failed";
440
+ readonly error: string;
441
+ readonly final: true;
442
+ readonly outcome: "failed";
443
+ readonly position: number;
444
+ readonly release: string;
445
+ } | {
446
+ readonly code: "function_not_started";
447
+ readonly final?: true;
448
+ readonly outcome: "failed";
449
+ readonly position: number;
450
+ readonly tries: number;
451
+ } | {
452
+ readonly code: "internal_error";
453
+ readonly final: true;
454
+ readonly outcome: "failed";
455
+ readonly position: number;
456
+ } | {
457
+ readonly code: "limit_reached";
458
+ readonly limit: "reads";
459
+ readonly outcome: "refused";
460
+ readonly period: "day" | "minute";
461
+ readonly position: number;
462
+ readonly retry_at: string;
463
+ readonly value: string;
464
+ } | {
465
+ readonly code: "limit_reached";
466
+ readonly limit: "writes";
467
+ readonly outcome: "refused";
468
+ readonly period: "day" | "minute";
469
+ readonly position: number;
470
+ readonly retry_at: string;
471
+ } | {
472
+ readonly code: "limit_reached";
473
+ readonly limit: "blob" | "indexed_text";
474
+ readonly outcome: "refused";
475
+ readonly position: number;
476
+ readonly used: string;
477
+ readonly value: string;
478
+ } | {
479
+ readonly code: "limit_reached";
480
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
481
+ readonly outcome: "refused";
482
+ readonly position: number;
483
+ readonly retry_at: 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
+ } | {
490
+ readonly code: "agent_function_retired" | "environment_offline" | "no_recipient" | "not_found" | "target_agent_unavailable";
491
+ readonly outcome: "no_target";
492
+ readonly position: number;
493
+ } | {
494
+ readonly code: string;
495
+ readonly outcome: "refused";
496
+ readonly position: number;
497
+ } | {
498
+ readonly conversations: number;
499
+ readonly outcome: "marked";
500
+ readonly position: number;
501
+ } | {
502
+ readonly cut?: boolean;
503
+ readonly exit_code?: number;
504
+ readonly outcome: "ran";
505
+ readonly output?: string;
506
+ readonly position: number;
507
+ readonly run: string;
508
+ } | {
509
+ readonly outcome: "continued";
510
+ readonly position: number;
511
+ readonly request: string;
512
+ } | {
513
+ readonly outcome: "notified";
514
+ readonly position: number;
515
+ readonly reached: number;
516
+ } | {
517
+ readonly outcome: "paused";
518
+ readonly position: number;
519
+ } | {
520
+ readonly outcome: "ran";
521
+ readonly position: number;
522
+ readonly release: string;
523
+ } | {
524
+ readonly outcome: "requested";
525
+ readonly position: number;
526
+ readonly request: string;
527
+ } | {
528
+ readonly outcome: "running";
529
+ readonly position: number;
530
+ readonly release: string;
531
+ } | {
532
+ readonly outcome: "running";
533
+ readonly position: number;
534
+ readonly run: string;
535
+ } | {
536
+ readonly outcome: "waiting";
537
+ readonly position: number;
538
+ })[];
539
+ readonly code?: "cap_reached";
540
+ readonly created_at: string;
541
+ readonly missed?: "failed" | "skipped";
542
+ readonly moment?: string;
543
+ readonly path?: string;
544
+ readonly room_ref?: string;
545
+ readonly trigger: string;
546
+ readonly url?: string;
547
+ }[];
548
+ };
549
+ };
550
+ }
4
551
  export type HouseParams<Name extends string> = Name extends keyof HouseMethods ? HouseMethods[Name]['params'] : unknown;
5
552
  type CallResult = Awaited<ReturnType<MdRuntimeClient['call']>>;
6
553
  export type HouseResult<Name extends string> = Exclude<CallResult, {
@@ -21,7 +568,7 @@ export interface HouseCredentialState {
21
568
  readonly state: Open<'none' | 'held' | 'rejected'>;
22
569
  readonly expiresAt: number | null;
23
570
  }
24
- export type HouseDatabaseFailure = 'unsupported' | 'damaged' | 'update-required';
571
+ export type HouseDatabaseFailure = 'damaged';
25
572
  export type HouseAnalyticsChoice = 'accept' | 'decline';
26
573
  export interface HouseAnalytics {
27
574
  readonly measures: boolean;
@@ -38,7 +585,6 @@ export interface HouseStatus {
38
585
  readonly sync: HouseSyncState | null;
39
586
  readonly refusal: {
40
587
  readonly code: string;
41
- readonly retryable: boolean;
42
588
  } | null;
43
589
  readonly loss: string | null;
44
590
  readonly database: Open<HouseDatabaseFailure> | null;
@@ -80,8 +626,6 @@ export interface HouseExternalRequest {
80
626
  readonly headers?: Readonly<Record<string, string>>;
81
627
  readonly body?: string;
82
628
  readonly body_base64?: string;
83
- readonly account?: string;
84
- readonly slot?: string;
85
629
  readonly room_ref?: string;
86
630
  }
87
631
  export type HouseExternalAnswer = {
@@ -104,6 +648,11 @@ export interface HouseAppMessage {
104
648
  }
105
649
  export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
106
650
  export type HouseNotifications = Open<'on' | 'off' | 'blocked' | 'unavailable'>;
651
+ export interface HouseTelegram {
652
+ readonly state: Open<'available' | 'linked' | 'unavailable'>;
653
+ readonly name: string | null;
654
+ readonly username: string | null;
655
+ }
107
656
  export interface HouseCeremonyRefused extends Error {
108
657
  readonly name: 'HouseCeremonyRefused';
109
658
  readonly code: Open<'house_ceremony_refused'>;
@@ -120,22 +669,29 @@ export interface HouseBrowserRefused extends Error {
120
669
  readonly code: string;
121
670
  readonly retryable: boolean;
122
671
  }
123
- export interface HouseTrialWithheld {
124
- readonly code: Open<'house_trial_withheld'>;
125
- readonly retryable: true;
126
- }
127
- export type HouseTask = unknown;
128
- export type HouseActivation = Open<'committed' | 'abandoned'>;
129
672
  export interface HouseCooperation {
130
- checkpoint(): Promise<void> | void;
131
- persist(): Promise<void> | void;
132
- capture(): Promise<HouseTask> | HouseTask;
133
- restore(task: HouseTask | null): Promise<void> | void;
134
- ready(): Promise<boolean> | boolean;
135
- settle(activation: HouseActivation): void;
673
+ placed(): Promise<void> | void;
674
+ }
675
+ export interface HouseChatOpened {
676
+ readonly conversation: string | null;
677
+ readonly agent: string | null;
678
+ }
679
+ export interface HouseChatOptions {
680
+ readonly conversation?: string | null;
681
+ readonly agent?: string | null;
682
+ readonly onOpen?: (opened: HouseChatOpened) => void;
683
+ readonly onLink?: (href: string) => void;
684
+ }
685
+ export interface HouseMountedChat {
686
+ update(options: HouseChatOptions): void;
687
+ unmount(): void;
688
+ }
689
+ export interface HouseChat {
690
+ mount(element: object, options?: HouseChatOptions): Promise<HouseMountedChat>;
136
691
  }
137
692
  export interface HouseBridge {
138
693
  readonly runtime: Promise<HouseRuntime>;
694
+ readonly chat: HouseChat;
139
695
  address(): string | null;
140
696
  onAddress(listener: (address: string) => void): () => void;
141
697
  push(address: string): Promise<string>;
@@ -143,7 +699,7 @@ export interface HouseBridge {
143
699
  ceremony(path: string): Promise<never>;
144
700
  install(): Promise<HouseInstallation>;
145
701
  notifications(on?: boolean): Promise<HouseNotifications>;
146
- setBadge(unread: readonly string[]): Promise<void>;
702
+ telegram(link?: true): Promise<HouseTelegram>;
147
703
  setTab(tab: HouseTab): void;
148
704
  sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
149
705
  sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
@@ -160,3 +716,4 @@ export interface HouseHeld {
160
716
  readonly houseBridge: HouseBridge;
161
717
  }
162
718
  export declare const houseBridge: () => HouseBridge;
719
+ export {};