@agentshouse/app-bridge 0.1.0-c5e33dff6615d → 0.1.0-c5f443c80729e

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 (117) hide show
  1. package/README.md +7 -7
  2. package/dist/index.d.ts +586 -25
  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 -11
  6. package/dist/mdmodel/document.d.ts +14 -8
  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 +865 -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 +38 -15
  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/not-ready.d.ts +1 -0
  18. package/dist/mdmodel/paths.d.ts +10 -1
  19. package/dist/mdmodel/pattern.d.ts +9 -0
  20. package/dist/mdmodel/query/language.d.ts +253 -0
  21. package/dist/mdmodel/query/match.d.ts +13 -0
  22. package/dist/mdmodel/query/rows.d.ts +31 -0
  23. package/dist/mdmodel/query/sql.d.ts +38 -0
  24. package/dist/mdmodel/references.d.ts +2 -2
  25. package/dist/mdmodel/reserved.d.ts +5 -0
  26. package/dist/mdmodel/room-types.d.ts +6 -0
  27. package/dist/mdmodel/types.d.ts +22 -17
  28. package/dist/mdmodel/validate.d.ts +10 -6
  29. package/dist/mdmodel/yaml.d.ts +4 -4
  30. package/dist/mdruntime/actions.d.ts +25 -0
  31. package/dist/mdruntime/adapter.d.ts +156 -111
  32. package/dist/mdruntime/attached-model.d.ts +6 -0
  33. package/dist/mdruntime/bootstrap.d.ts +43 -0
  34. package/dist/mdruntime/cell.d.ts +5 -0
  35. package/dist/mdruntime/chain.d.ts +2 -1
  36. package/dist/mdruntime/change-set.d.ts +4 -0
  37. package/dist/mdruntime/change.d.ts +5 -0
  38. package/dist/mdruntime/client.d.ts +31 -23
  39. package/dist/mdruntime/collection.d.ts +26 -7
  40. package/dist/mdruntime/compile.d.ts +8 -6
  41. package/dist/mdruntime/conversation-live.d.ts +149 -0
  42. package/dist/mdruntime/conversation-row.d.ts +39 -0
  43. package/dist/mdruntime/conversation.d.ts +68 -48
  44. package/dist/mdruntime/declaration.d.ts +9 -0
  45. package/dist/mdruntime/durability.d.ts +19 -1
  46. package/dist/mdruntime/failure.d.ts +3 -0
  47. package/dist/mdruntime/figures.d.ts +48 -0
  48. package/dist/mdruntime/holdings.d.ts +28 -0
  49. package/dist/mdruntime/identity.d.ts +0 -1
  50. package/dist/mdruntime/install.d.ts +59 -0
  51. package/dist/mdruntime/listing.d.ts +51 -0
  52. package/dist/mdruntime/live.d.ts +24 -0
  53. package/dist/mdruntime/media.d.ts +7 -2
  54. package/dist/mdruntime/messages.d.ts +35 -5
  55. package/dist/mdruntime/model.d.ts +2 -11
  56. package/dist/mdruntime/observation.d.ts +28 -13
  57. package/dist/mdruntime/opened.d.ts +1 -1
  58. package/dist/mdruntime/outcome.d.ts +11 -4
  59. package/dist/mdruntime/overlay.d.ts +7 -2
  60. package/dist/mdruntime/preparation.d.ts +40 -0
  61. package/dist/mdruntime/presence.d.ts +57 -0
  62. package/dist/mdruntime/query.d.ts +14 -210
  63. package/dist/mdruntime/reach.d.ts +16 -14
  64. package/dist/mdruntime/readiness.d.ts +12 -21
  65. package/dist/mdruntime/reads.d.ts +38 -0
  66. package/dist/mdruntime/recovery.d.ts +3 -0
  67. package/dist/mdruntime/refresh.d.ts +26 -0
  68. package/dist/mdruntime/replica.d.ts +12 -18
  69. package/dist/mdruntime/retried.d.ts +29 -0
  70. package/dist/mdruntime/room-draft.d.ts +51 -12
  71. package/dist/mdruntime/room-drafts.d.ts +23 -0
  72. package/dist/mdruntime/runtime.d.ts +33 -0
  73. package/dist/mdruntime/save.d.ts +42 -84
  74. package/dist/mdruntime/saves.d.ts +31 -0
  75. package/dist/mdruntime/search.d.ts +12 -63
  76. package/dist/mdruntime/seed.d.ts +11 -2
  77. package/dist/mdruntime/socket/admission.d.ts +6 -0
  78. package/dist/mdruntime/socket/answers.d.ts +5 -0
  79. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  80. package/dist/mdruntime/socket/session.d.ts +37 -0
  81. package/dist/mdruntime/socket.d.ts +66 -0
  82. package/dist/mdruntime/source.d.ts +58 -0
  83. package/dist/mdruntime/status.d.ts +4 -5
  84. package/dist/mdruntime/store/installs.d.ts +29 -0
  85. package/dist/mdruntime/store/readiness.d.ts +10 -0
  86. package/dist/mdruntime/store/records.d.ts +217 -0
  87. package/dist/mdruntime/store/room-held.d.ts +7 -0
  88. package/dist/mdruntime/store/rooms-shown.d.ts +7 -0
  89. package/dist/mdruntime/store/space.d.ts +10 -0
  90. package/dist/mdruntime/store/watchers.d.ts +16 -0
  91. package/dist/mdruntime/store/writes.d.ts +23 -0
  92. package/dist/mdruntime/store.d.ts +124 -171
  93. package/dist/mdruntime/stored.d.ts +75 -60
  94. package/dist/mdruntime/surface.d.ts +89 -0
  95. package/dist/mdruntime/tables.d.ts +130 -65
  96. package/dist/mdruntime/tallies.d.ts +17 -0
  97. package/dist/mdruntime/transfer.d.ts +0 -5
  98. package/dist/mdruntime/wire.d.ts +59 -9
  99. package/dist/session-content/bounds.d.ts +7 -0
  100. package/dist/session-content/check.d.ts +18 -0
  101. package/dist/session-content/index.d.ts +7 -0
  102. package/dist/session-content/parts.d.ts +103 -0
  103. package/dist/session-content/state.d.ts +61 -0
  104. package/dist/session-content/turn.d.ts +328 -0
  105. package/dist/test-host.d.ts +8 -4
  106. package/dist/test-host.js +28 -28
  107. package/docs/families.md +79 -72
  108. package/package.json +2 -2
  109. package/dist/calls.d.ts +0 -707
  110. package/dist/calls.js +0 -1
  111. package/dist/mdmodel/blocks.d.ts +0 -10
  112. package/dist/mdmodel/condition.d.ts +0 -160
  113. package/dist/mdmodel/links.d.ts +0 -28
  114. package/dist/mdmodel/profile.d.ts +0 -5
  115. package/dist/mdruntime/connection.d.ts +0 -154
  116. package/dist/mdruntime/fulltext.d.ts +0 -26
  117. package/dist/mdruntime/shared.d.ts +0 -15
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 twelve families: navigation,
7
- ceremonies, installation, notifications, status, Site image reads, App release
8
- code, external calls, App messages, App and Site screenshot reads and the Chat.
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
12
  the MD Runtime client into the page beside the bridge and serves it the Chat, so
13
13
  the App imports, constructs and bundles neither: `bridge.runtime` resolves to the client.
14
14
 
15
- House's guide to building an App is its Guide's `apps/` pages, which `open_guide` opens.
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,559 @@
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 | "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
+ }
4
557
  export type HouseParams<Name extends string> = Name extends keyof HouseMethods ? HouseMethods[Name]['params'] : unknown;
5
558
  type CallResult = Awaited<ReturnType<MdRuntimeClient['call']>>;
6
559
  export type HouseResult<Name extends string> = Exclude<CallResult, {
@@ -21,7 +574,7 @@ export interface HouseCredentialState {
21
574
  readonly state: Open<'none' | 'held' | 'rejected'>;
22
575
  readonly expiresAt: number | null;
23
576
  }
24
- export type HouseDatabaseFailure = 'unsupported' | 'damaged';
577
+ export type HouseDatabaseFailure = 'damaged';
25
578
  export type HouseAnalyticsChoice = 'accept' | 'decline';
26
579
  export interface HouseAnalytics {
27
580
  readonly measures: boolean;
@@ -38,7 +591,6 @@ export interface HouseStatus {
38
591
  readonly sync: HouseSyncState | null;
39
592
  readonly refusal: {
40
593
  readonly code: string;
41
- readonly retryable: boolean;
42
594
  } | null;
43
595
  readonly loss: string | null;
44
596
  readonly database: Open<HouseDatabaseFailure> | null;
@@ -80,8 +632,6 @@ export interface HouseExternalRequest {
80
632
  readonly headers?: Readonly<Record<string, string>>;
81
633
  readonly body?: string;
82
634
  readonly body_base64?: string;
83
- readonly account?: string;
84
- readonly slot?: string;
85
635
  readonly room_ref?: string;
86
636
  }
87
637
  export type HouseExternalAnswer = {
@@ -104,6 +654,15 @@ export interface HouseAppMessage {
104
654
  }
105
655
  export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
106
656
  export type HouseNotifications = Open<'on' | 'off' | 'blocked' | 'unavailable'>;
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;
665
+ }
107
666
  export interface HouseCeremonyRefused extends Error {
108
667
  readonly name: 'HouseCeremonyRefused';
109
668
  readonly code: Open<'house_ceremony_refused'>;
@@ -120,22 +679,9 @@ export interface HouseBrowserRefused extends Error {
120
679
  readonly code: string;
121
680
  readonly retryable: boolean;
122
681
  }
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
682
  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
- placed?(): Promise<void> | void;
136
- settle(activation: HouseActivation): void;
137
- }
138
- export type HouseChatWidth = 'full' | '3/4' | '1/2' | '1/3';
683
+ placed(): Promise<void> | void;
684
+ }
139
685
  export interface HouseChatOpened {
140
686
  readonly conversation: string | null;
141
687
  readonly agent: string | null;
@@ -143,8 +689,6 @@ export interface HouseChatOpened {
143
689
  export interface HouseChatOptions {
144
690
  readonly conversation?: string | null;
145
691
  readonly agent?: string | null;
146
- readonly showChats?: boolean;
147
- readonly width?: HouseChatWidth;
148
692
  readonly onOpen?: (opened: HouseChatOpened) => void;
149
693
  readonly onLink?: (href: string) => void;
150
694
  }
@@ -152,8 +696,24 @@ export interface HouseMountedChat {
152
696
  update(options: HouseChatOptions): void;
153
697
  unmount(): void;
154
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
+ }
155
714
  export interface HouseChat {
156
715
  mount(element: object, options?: HouseChatOptions): Promise<HouseMountedChat>;
716
+ mountButton(options?: HouseChatButtonOptions): Promise<HouseChatButton>;
157
717
  }
158
718
  export interface HouseBridge {
159
719
  readonly runtime: Promise<HouseRuntime>;
@@ -162,10 +722,10 @@ export interface HouseBridge {
162
722
  onAddress(listener: (address: string) => void): () => void;
163
723
  push(address: string): Promise<string>;
164
724
  replace(address: string): Promise<string>;
165
- ceremony(path: string): Promise<never>;
725
+ ceremony(path: string): Promise<HouseCeremonyEnded>;
166
726
  install(): Promise<HouseInstallation>;
167
727
  notifications(on?: boolean): Promise<HouseNotifications>;
168
- setBadge(unread: readonly string[]): Promise<void>;
728
+ telegram(link?: true): Promise<HouseTelegram>;
169
729
  setTab(tab: HouseTab): void;
170
730
  sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
171
731
  sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
@@ -182,3 +742,4 @@ export interface HouseHeld {
182
742
  readonly houseBridge: HouseBridge;
183
743
  }
184
744
  export declare const houseBridge: () => HouseBridge;
745
+ export {};