@agentshouse/app-bridge 0.1.0-c1ccced28150f → 0.1.0-c1e94bea3fb3f

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 (85) hide show
  1. package/README.md +6 -6
  2. package/dist/index.d.ts +183 -67
  3. package/dist/mdmodel/definition.d.ts +1 -1
  4. package/dist/mdmodel/document.d.ts +2 -1
  5. package/dist/mdmodel/event.d.ts +77 -0
  6. package/dist/mdmodel/facts.d.ts +14 -0
  7. package/dist/mdmodel/index.d.ts +19 -6
  8. package/dist/mdmodel/kinds.d.ts +18 -0
  9. package/dist/mdmodel/pattern.d.ts +9 -0
  10. package/dist/mdmodel/query/language.d.ts +253 -0
  11. package/dist/mdmodel/query/match.d.ts +13 -0
  12. package/dist/mdmodel/query/rows.d.ts +31 -0
  13. package/dist/mdmodel/query/sql.d.ts +38 -0
  14. package/dist/mdmodel/reserved.d.ts +4 -0
  15. package/dist/mdmodel/types.d.ts +11 -0
  16. package/dist/mdmodel/validate.d.ts +7 -5
  17. package/dist/mdruntime/actions.d.ts +19 -0
  18. package/dist/mdruntime/adapter.d.ts +42 -25
  19. package/dist/mdruntime/attached-model.d.ts +7 -0
  20. package/dist/mdruntime/bootstrap.d.ts +43 -0
  21. package/dist/mdruntime/cell.d.ts +5 -0
  22. package/dist/mdruntime/chain.d.ts +2 -1
  23. package/dist/mdruntime/change.d.ts +1 -0
  24. package/dist/mdruntime/client.d.ts +20 -4
  25. package/dist/mdruntime/collection.d.ts +2 -1
  26. package/dist/mdruntime/compile.d.ts +6 -6
  27. package/dist/mdruntime/conversation-row.d.ts +32 -0
  28. package/dist/mdruntime/conversation.d.ts +20 -9
  29. package/dist/mdruntime/durability.d.ts +15 -0
  30. package/dist/mdruntime/figures.d.ts +47 -0
  31. package/dist/mdruntime/holdings.d.ts +28 -0
  32. package/dist/mdruntime/identity.d.ts +0 -1
  33. package/dist/mdruntime/install.d.ts +55 -0
  34. package/dist/mdruntime/job.d.ts +32 -0
  35. package/dist/mdruntime/listing.d.ts +52 -0
  36. package/dist/mdruntime/live.d.ts +22 -0
  37. package/dist/mdruntime/log.d.ts +5 -0
  38. package/dist/mdruntime/messages.d.ts +27 -3
  39. package/dist/mdruntime/model.d.ts +2 -9
  40. package/dist/mdruntime/observation.d.ts +2 -2
  41. package/dist/mdruntime/outcome.d.ts +4 -1
  42. package/dist/mdruntime/overlay.d.ts +1 -0
  43. package/dist/mdruntime/preparation.d.ts +19 -0
  44. package/dist/mdruntime/query.d.ts +13 -208
  45. package/dist/mdruntime/reach.d.ts +14 -12
  46. package/dist/mdruntime/readiness.d.ts +0 -2
  47. package/dist/mdruntime/reads.d.ts +35 -0
  48. package/dist/mdruntime/refresh.d.ts +26 -0
  49. package/dist/mdruntime/replica.d.ts +8 -8
  50. package/dist/mdruntime/room-draft.d.ts +4 -3
  51. package/dist/mdruntime/room-drafts.d.ts +23 -0
  52. package/dist/mdruntime/runtime.d.ts +41 -0
  53. package/dist/mdruntime/saves.d.ts +69 -0
  54. package/dist/mdruntime/search.d.ts +12 -63
  55. package/dist/mdruntime/seed.d.ts +11 -2
  56. package/dist/mdruntime/socket/admission.d.ts +6 -0
  57. package/dist/mdruntime/socket/answers.d.ts +5 -0
  58. package/dist/mdruntime/socket/lanes.d.ts +19 -0
  59. package/dist/mdruntime/socket/rooms.d.ts +42 -0
  60. package/dist/mdruntime/socket/session.d.ts +38 -0
  61. package/dist/mdruntime/socket.d.ts +69 -0
  62. package/dist/mdruntime/source.d.ts +60 -0
  63. package/dist/mdruntime/status.d.ts +0 -2
  64. package/dist/mdruntime/store/fences.d.ts +15 -0
  65. package/dist/mdruntime/store/installs.d.ts +29 -0
  66. package/dist/mdruntime/store/readiness.d.ts +9 -0
  67. package/dist/mdruntime/store/records.d.ts +211 -0
  68. package/dist/mdruntime/store/room-held.d.ts +7 -0
  69. package/dist/mdruntime/store/space.d.ts +10 -0
  70. package/dist/mdruntime/store/watchers.d.ts +16 -0
  71. package/dist/mdruntime/store/writes.d.ts +23 -0
  72. package/dist/mdruntime/store.d.ts +107 -145
  73. package/dist/mdruntime/stored.d.ts +58 -32
  74. package/dist/mdruntime/surface.d.ts +87 -0
  75. package/dist/mdruntime/tables.d.ts +116 -26
  76. package/dist/mdruntime/tallies.d.ts +17 -0
  77. package/dist/mdruntime/transfer.d.ts +4 -0
  78. package/dist/mdruntime/turn.d.ts +8 -0
  79. package/dist/mdruntime/wire.d.ts +17 -1
  80. package/dist/test-host.js +1 -1
  81. package/docs/families.md +19 -7
  82. package/package.json +1 -1
  83. package/dist/mdmodel/condition.d.ts +0 -179
  84. package/dist/mdruntime/connection.d.ts +0 -152
  85. package/dist/mdruntime/fulltext.d.ts +0 -26
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 thirteen families: navigation,
7
+ ceremonies, installation, notifications, Telegram, status, Site image reads, 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,7 +42,7 @@ 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 by its name, such as `call('rooms/members', { room_ref })`: `HouseMethods`
45
+ to a House act by its name, such as `call('rooms/members/list', { room_ref })`: `HouseMethods`
46
46
  names each with House's own input, `HouseParams<Name>`, and answer, `HouseResult<Name>`.
47
47
 
48
48
  ## Test without a House
package/dist/index.d.ts CHANGED
@@ -1,6 +1,21 @@
1
1
  import type { MdRuntimeClient, Open } from './mdruntime/client.js';
2
2
  export interface HouseMethods {
3
- readonly "apps/features/read": {
3
+ readonly "agent-functions/requests/list": {
4
+ readonly params: {
5
+ readonly room_ref: string;
6
+ };
7
+ readonly result: {
8
+ readonly current: readonly {
9
+ readonly document: string;
10
+ readonly name: string;
11
+ }[];
12
+ readonly history: readonly {
13
+ readonly document: string;
14
+ readonly name: string;
15
+ }[];
16
+ };
17
+ };
18
+ readonly "apps/features/list": {
4
19
  readonly params: {};
5
20
  readonly result: {
6
21
  readonly features: readonly {
@@ -9,11 +24,10 @@ export interface HouseMethods {
9
24
  }[];
10
25
  };
11
26
  };
12
- readonly "apps/holders": {
27
+ readonly "apps/holders/list": {
13
28
  readonly params: {};
14
29
  readonly result: {
15
30
  readonly holders: readonly {
16
- readonly email: string;
17
31
  readonly name: string;
18
32
  readonly user: string;
19
33
  }[];
@@ -28,7 +42,7 @@ export interface HouseMethods {
28
42
  readonly [key: string]: never;
29
43
  };
30
44
  };
31
- readonly "apps/relay": {
45
+ readonly "apps/relay/read": {
32
46
  readonly params: {
33
47
  readonly [key: string]: never;
34
48
  };
@@ -58,6 +72,7 @@ export interface HouseMethods {
58
72
  } | {
59
73
  readonly user: string;
60
74
  };
75
+ readonly operation_id: string;
61
76
  readonly path: string;
62
77
  readonly room_ref: string;
63
78
  };
@@ -81,6 +96,29 @@ export interface HouseMethods {
81
96
  readonly url: string;
82
97
  };
83
98
  };
99
+ readonly "chats/reply": {
100
+ readonly params: {
101
+ readonly operation_id: string;
102
+ readonly path: string;
103
+ readonly room_ref: string;
104
+ readonly template?: {
105
+ readonly language: string;
106
+ readonly name: string;
107
+ };
108
+ readonly text?: string;
109
+ readonly values?: {
110
+ readonly [key: string]: string;
111
+ };
112
+ };
113
+ readonly result: {
114
+ readonly authority: string;
115
+ readonly log_epoch: string;
116
+ readonly path: string;
117
+ readonly position: string;
118
+ readonly room_ref: string;
119
+ readonly url: string;
120
+ };
121
+ };
84
122
  readonly "chats/return": {
85
123
  readonly params: {
86
124
  readonly path: string;
@@ -108,6 +146,7 @@ export interface HouseMethods {
108
146
  };
109
147
  readonly "chats/take-control": {
110
148
  readonly params: {
149
+ readonly operation_id: string;
111
150
  readonly path: string;
112
151
  readonly room_ref: string;
113
152
  };
@@ -135,7 +174,6 @@ export interface HouseMethods {
135
174
  readonly params: {
136
175
  readonly agent_id: string;
137
176
  readonly operation_id: string;
138
- readonly replaces?: string;
139
177
  };
140
178
  readonly result: {
141
179
  readonly agent_id: string;
@@ -159,23 +197,25 @@ export interface HouseMethods {
159
197
  readonly position: string;
160
198
  };
161
199
  };
162
- readonly "conversations/done": {
200
+ readonly "conversations/end": {
163
201
  readonly params: {
164
- readonly conversation_id?: string;
202
+ readonly conversation_id: string;
165
203
  readonly operation_id: string;
166
- readonly result?: string;
167
204
  };
168
205
  readonly result: {
169
206
  readonly agent_id: string;
170
207
  readonly authority: string;
171
208
  readonly conversation_id: string;
172
- readonly done: null | string;
209
+ readonly jobs: readonly {
210
+ readonly name: string;
211
+ readonly running_since: string;
212
+ }[];
173
213
  readonly log_epoch: string;
174
214
  readonly position: string;
175
215
  readonly url: string;
176
216
  };
177
217
  };
178
- readonly "conversations/history": {
218
+ readonly "conversations/history/list": {
179
219
  readonly params: {
180
220
  readonly conversations: readonly {
181
221
  readonly after?: {
@@ -234,20 +274,52 @@ export interface HouseMethods {
234
274
  readonly type: "text";
235
275
  })[];
236
276
  readonly role: "assistant" | "house" | "user";
237
- readonly sender?: "conversation" | "customer" | "owner" | "report" | "requester" | "trigger";
277
+ readonly sender?: "conversation" | "customer" | "owner" | "replier" | "report" | "requester" | "trigger";
238
278
  readonly source?: {
239
279
  readonly agent: {
240
280
  readonly id: string;
241
281
  readonly name: string;
242
282
  readonly url: string;
243
283
  };
284
+ readonly approved_at?: string;
285
+ readonly declined_at?: string;
244
286
  readonly kind: "mail";
245
287
  readonly owner: {
246
288
  readonly name: string;
247
289
  readonly user: string;
248
290
  };
249
291
  readonly request: string;
292
+ readonly room: string;
250
293
  } | {
294
+ readonly agent: {
295
+ readonly id: string;
296
+ readonly name: string;
297
+ readonly url: string;
298
+ };
299
+ readonly conversation: {
300
+ readonly id: string;
301
+ readonly name: string;
302
+ readonly url: string;
303
+ };
304
+ readonly kind: "conversation";
305
+ } | {
306
+ readonly agent: {
307
+ readonly id: string;
308
+ readonly name: string;
309
+ readonly url: string;
310
+ };
311
+ readonly kind: "declined";
312
+ readonly owner: {
313
+ readonly name: string;
314
+ readonly user: string;
315
+ };
316
+ readonly request: string;
317
+ } | {
318
+ readonly agent_function: null | {
319
+ readonly id: string;
320
+ readonly name: string;
321
+ readonly version: number;
322
+ };
251
323
  readonly approved_at: null | string;
252
324
  readonly kind: "request";
253
325
  readonly request: string;
@@ -265,11 +337,9 @@ export interface HouseMethods {
265
337
  readonly ref: string;
266
338
  readonly url: string;
267
339
  };
268
- readonly routine: null | {
269
- readonly id: string;
270
- readonly name: string;
271
- readonly version: number;
272
- };
340
+ } | {
341
+ readonly kind: "reply";
342
+ readonly name: string;
273
343
  } | {
274
344
  readonly kind: "trigger";
275
345
  readonly path: null | string;
@@ -286,6 +356,12 @@ export interface HouseMethods {
286
356
  };
287
357
  readonly telegram_undelivered?: true;
288
358
  readonly text: string;
359
+ readonly tokens?: {
360
+ readonly cache_read: number;
361
+ readonly cache_write: number;
362
+ readonly input: number;
363
+ readonly output: number;
364
+ };
289
365
  readonly transcripts?: readonly {
290
366
  readonly path: string;
291
367
  readonly text: string;
@@ -349,7 +425,7 @@ export interface HouseMethods {
349
425
  readonly url: string;
350
426
  };
351
427
  };
352
- readonly "conversations/option": {
428
+ readonly "conversations/option/set": {
353
429
  readonly params: {
354
430
  readonly conversation_id: string;
355
431
  readonly operation_id: string;
@@ -413,15 +489,12 @@ export interface HouseMethods {
413
489
  readonly url: string;
414
490
  };
415
491
  };
416
- readonly "records/read": {
492
+ readonly "records/list": {
417
493
  readonly params: {
418
- readonly cursor?: string;
419
- readonly limit?: number;
420
494
  readonly order?: "asc" | "desc";
421
495
  readonly room_ref: string;
422
496
  };
423
497
  readonly result: {
424
- readonly next_cursor?: string;
425
498
  readonly records: readonly {
426
499
  readonly body: null | string;
427
500
  readonly claimed: unknown;
@@ -431,10 +504,9 @@ export interface HouseMethods {
431
504
  }[];
432
505
  };
433
506
  };
434
- readonly "rooms/access/read": {
507
+ readonly "rooms/access/list": {
435
508
  readonly params: {
436
509
  readonly room_ref: string;
437
- readonly statistics?: boolean;
438
510
  };
439
511
  readonly result: {
440
512
  readonly authority: "administrator" | "member" | "owner";
@@ -443,45 +515,35 @@ export interface HouseMethods {
443
515
  readonly direct: readonly {
444
516
  readonly level: null | "keep" | "open" | "search";
445
517
  readonly namespace: string;
446
- readonly operations: readonly ("delete" | "export" | "manageAccess" | "write")[];
518
+ readonly operations: readonly ("erase" | "export" | "manageAccess" | "write")[];
447
519
  }[];
448
- readonly downloads_per_day?: number;
449
520
  readonly entries: readonly {
450
521
  readonly level: null | "keep" | "open" | "search";
451
522
  readonly namespace: string;
452
- readonly operations: readonly ("delete" | "export" | "manageAccess" | "write")[];
523
+ readonly operations: readonly ("erase" | "export" | "manageAccess" | "write")[];
453
524
  readonly sources: readonly {
454
525
  readonly kind: "direct" | "inherited";
455
526
  readonly level: null | "keep" | "open" | "search";
456
527
  readonly namespace: string;
457
- readonly operations: readonly ("delete" | "export" | "manageAccess" | "write")[];
528
+ readonly operations: readonly ("erase" | "export" | "manageAccess" | "write")[];
458
529
  }[];
459
530
  }[];
460
531
  readonly key: null | string;
461
- readonly requests_per_day?: number;
462
532
  readonly schema_roles: readonly string[];
533
+ readonly through_space?: true;
463
534
  readonly user: string;
464
535
  readonly user_name: string;
465
536
  }[];
466
537
  readonly namespaces: readonly string[];
467
538
  readonly owner: string;
468
539
  readonly room_ref: string;
469
- readonly statistics?: readonly {
470
- readonly day: string;
471
- readonly downloads: number;
472
- readonly requests: number;
473
- readonly text_bytes: number;
474
- readonly user: string;
475
- }[];
476
540
  readonly url: string;
477
541
  readonly viewer: string;
478
542
  };
479
543
  };
480
- readonly "rooms/members": {
544
+ readonly "rooms/members/list": {
481
545
  readonly params: {
482
- readonly cursor?: string;
483
546
  readonly history?: boolean;
484
- readonly limit?: number;
485
547
  readonly room_ref: string;
486
548
  };
487
549
  readonly result: {
@@ -491,17 +553,17 @@ export interface HouseMethods {
491
553
  readonly user: string;
492
554
  }[];
493
555
  readonly members: readonly {
494
- readonly access?: "edit" | "keep" | "manage" | "open" | "owner" | "search";
556
+ readonly access?: "manage" | "owner" | "read" | "write";
557
+ readonly copies?: "online_only" | "search_only";
495
558
  readonly display_name: string;
496
559
  readonly email?: string;
497
560
  readonly member_document: null | string;
498
- readonly only_while_online?: true;
499
561
  readonly owner: boolean;
500
562
  readonly schema_roles?: readonly string[];
501
563
  readonly since: null | string;
564
+ readonly through_space?: true;
502
565
  readonly user: string;
503
566
  }[];
504
- readonly next_cursor?: string;
505
567
  };
506
568
  };
507
569
  readonly "rooms/settings/processing/read": {
@@ -537,22 +599,7 @@ export interface HouseMethods {
537
599
  readonly writable: boolean;
538
600
  };
539
601
  };
540
- readonly "routines/requests": {
541
- readonly params: {
542
- readonly room_ref: string;
543
- };
544
- readonly result: {
545
- readonly current: readonly {
546
- readonly document: string;
547
- readonly name: string;
548
- }[];
549
- readonly history: readonly {
550
- readonly document: string;
551
- readonly name: string;
552
- }[];
553
- };
554
- };
555
- readonly "site/submission": {
602
+ readonly "sites/submissions/create": {
556
603
  readonly params: {
557
604
  readonly content: string;
558
605
  };
@@ -560,9 +607,10 @@ export interface HouseMethods {
560
607
  readonly submitted: true;
561
608
  };
562
609
  };
563
- readonly "storage/inventory": {
610
+ readonly "storage/inventory/read": {
564
611
  readonly params: {
565
612
  readonly room_ref?: string;
613
+ readonly rooms?: "owned";
566
614
  };
567
615
  readonly result: {
568
616
  readonly blob: {
@@ -614,6 +662,35 @@ export interface HouseMethods {
614
662
  readonly layout: string;
615
663
  };
616
664
  };
665
+ readonly rooms?: readonly {
666
+ readonly blob: {
667
+ readonly bytes: string;
668
+ readonly gigabytes: string;
669
+ };
670
+ readonly freshness: {
671
+ readonly state: "settled";
672
+ };
673
+ readonly indexed_text: {
674
+ readonly approximate_pages: null | string;
675
+ readonly bytes: string;
676
+ readonly gigabytes: string;
677
+ };
678
+ readonly measurement: {
679
+ readonly page_reference: null | {
680
+ readonly bytes_per_page: string;
681
+ readonly encoding: string;
682
+ readonly font: string;
683
+ readonly font_size_pt: string;
684
+ readonly layout: string;
685
+ };
686
+ };
687
+ readonly room_ref: string;
688
+ readonly total: {
689
+ readonly bytes: string;
690
+ readonly gigabytes: string;
691
+ };
692
+ readonly url: string;
693
+ }[];
617
694
  readonly site_images: {
618
695
  readonly bound: string;
619
696
  readonly bytes: string;
@@ -645,26 +722,55 @@ export interface HouseMethods {
645
722
  readonly layout: string;
646
723
  };
647
724
  };
725
+ readonly rooms?: readonly {
726
+ readonly blob: {
727
+ readonly bytes: string;
728
+ readonly gigabytes: string;
729
+ };
730
+ readonly freshness: {
731
+ readonly state: "settled";
732
+ };
733
+ readonly indexed_text: {
734
+ readonly approximate_pages: null | string;
735
+ readonly bytes: string;
736
+ readonly gigabytes: string;
737
+ };
738
+ readonly measurement: {
739
+ readonly page_reference: null | {
740
+ readonly bytes_per_page: string;
741
+ readonly encoding: string;
742
+ readonly font: string;
743
+ readonly font_size_pt: string;
744
+ readonly layout: string;
745
+ };
746
+ };
747
+ readonly room_ref: string;
748
+ readonly total: {
749
+ readonly bytes: string;
750
+ readonly gigabytes: string;
751
+ };
752
+ readonly url: string;
753
+ }[];
648
754
  readonly total: {
649
755
  readonly bytes: string;
650
756
  readonly gigabytes: string;
651
757
  };
652
758
  };
653
759
  };
654
- readonly "triggers/fired": {
760
+ readonly "triggers/fired/list": {
655
761
  readonly params: {
656
- readonly room_ref: string;
762
+ readonly room_ref?: string;
657
763
  };
658
764
  readonly result: {
659
765
  readonly events: readonly {
660
766
  readonly actions: readonly ({
661
- readonly cap: "address_submissions" | "app_sockets" | "environment_functions" | "export_starts" | "folder_subscriptions" | "kit_connections" | "live_shares" | "open_uploads" | "ownership_offers" | "push_addresses" | "push_deliveries" | "room_triggers" | "service_keys" | "share_creations" | "share_room_creations" | "shared_schemas" | "site_rooms" | "slot_rooms" | "waiting_web_wizards" | "writes";
767
+ 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";
662
768
  readonly code: "cap_reached";
663
769
  readonly outcome: "refused";
664
770
  readonly position: number;
665
771
  readonly retry_at: string;
666
772
  } | {
667
- readonly cap: "address_submissions" | "app_sockets" | "environment_functions" | "export_starts" | "folder_subscriptions" | "kit_connections" | "live_shares" | "open_uploads" | "ownership_offers" | "push_addresses" | "push_deliveries" | "room_triggers" | "service_keys" | "share_creations" | "share_room_creations" | "shared_schemas" | "site_rooms" | "slot_rooms" | "waiting_web_wizards" | "writes";
773
+ 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";
668
774
  readonly code: "cap_reached";
669
775
  readonly outcome: "refused";
670
776
  readonly position: number;
@@ -719,27 +825,31 @@ export interface HouseMethods {
719
825
  readonly value: string;
720
826
  } | {
721
827
  readonly code: "limit_reached";
722
- readonly limit: "custom_domains" | "external_calls" | "mcp_downloads" | "mcp_reads" | "publish_data" | "site_submissions" | "sites";
828
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
723
829
  readonly outcome: "refused";
724
830
  readonly position: number;
725
831
  readonly retry_at: string;
726
832
  } | {
727
833
  readonly code: "limit_reached";
728
- readonly limit: "custom_domains" | "external_calls" | "mcp_downloads" | "mcp_reads" | "publish_data" | "site_submissions" | "sites";
834
+ readonly limit: "custom_domains" | "external_calls" | "publish_data" | "sites";
729
835
  readonly outcome: "refused";
730
836
  readonly position: number;
731
837
  } | {
732
- readonly code: "app_function_not_found" | "app_not_found" | "environment_function_not_found" | "environment_offline" | "no_recipient" | "routine_not_found" | "routine_retired" | "target_agent_unavailable";
838
+ readonly code: "agent_function_not_found" | "agent_function_retired" | "app_function_not_found" | "app_not_found" | "environment_function_not_found" | "environment_offline" | "no_recipient" | "target_agent_unavailable";
733
839
  readonly outcome: "no_target";
734
840
  readonly position: number;
735
841
  } | {
736
- readonly code: "internal_error" | "routine_request_not_started";
842
+ readonly code: "agent_function_request_not_started" | "internal_error";
737
843
  readonly outcome: "failed";
738
844
  readonly position: number;
739
845
  } | {
740
846
  readonly code: string;
741
847
  readonly outcome: "refused";
742
848
  readonly position: number;
849
+ } | {
850
+ readonly conversations: number;
851
+ readonly outcome: "marked";
852
+ readonly position: number;
743
853
  } | {
744
854
  readonly cut?: boolean;
745
855
  readonly exit_code?: number;
@@ -783,6 +893,7 @@ export interface HouseMethods {
783
893
  readonly missed?: "failed" | "skipped";
784
894
  readonly moment?: string;
785
895
  readonly path?: string;
896
+ readonly room_ref?: string;
786
897
  readonly trigger: string;
787
898
  readonly url?: string;
788
899
  }[];
@@ -890,6 +1001,11 @@ export interface HouseAppMessage {
890
1001
  }
891
1002
  export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
892
1003
  export type HouseNotifications = Open<'on' | 'off' | 'blocked' | 'unavailable'>;
1004
+ export interface HouseTelegram {
1005
+ readonly state: Open<'available' | 'linked' | 'unavailable'>;
1006
+ readonly name: string | null;
1007
+ readonly username: string | null;
1008
+ }
893
1009
  export interface HouseCeremonyRefused extends Error {
894
1010
  readonly name: 'HouseCeremonyRefused';
895
1011
  readonly code: Open<'house_ceremony_refused'>;
@@ -939,7 +1055,7 @@ export interface HouseBridge {
939
1055
  ceremony(path: string): Promise<never>;
940
1056
  install(): Promise<HouseInstallation>;
941
1057
  notifications(on?: boolean): Promise<HouseNotifications>;
942
- setBadge(unread: readonly string[]): Promise<void>;
1058
+ telegram(link?: true): Promise<HouseTelegram>;
943
1059
  setTab(tab: HouseTab): void;
944
1060
  sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
945
1061
  sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
@@ -78,4 +78,4 @@ export type PointerFacts = {
78
78
  export declare function crossedFacts(facts: ValueFacts): ValueFacts[];
79
79
  export declare function fieldFacts(definition: Definition, key: string): ValueFacts | undefined;
80
80
  export declare function pointerFacts(definition: Definition, pointer: string): PointerFacts | undefined;
81
- export declare function readSchema(text: string, provided?: VerifiedModel): VerifiedModel | Failure;
81
+ export declare function readSchema(text: string, provided?: VerifiedModel, checked?: boolean): VerifiedModel | Failure;
@@ -1,6 +1,6 @@
1
1
  import { type Definition } from './definition.js';
2
2
  import { type LinkInventory } from './links.js';
3
- import type { ApplyResult, BodyResult, FrontmatterResult, Change, Document, Link, ParseResult } from './types.js';
3
+ import type { ApplyResult, BodyResult, FrontmatterResult, Change, Document, Link, ParseResult, UnlinkedBody } from './types.js';
4
4
  import { type YamlMap } from './yaml.js';
5
5
  export declare function inventoryOf(document: Document): LinkInventory;
6
6
  export declare function parseFrontmatter(content: string, file?: string): FrontmatterResult;
@@ -8,6 +8,7 @@ export declare function parse(content: string, file?: string): ParseResult;
8
8
  export declare function relativize(document: Document, file: string, handle: string, definition?: Definition, kept?: ReadonlySet<string>): ApplyResult;
9
9
  export declare function relativizeBody(body: string, file: string, handle: string): BodyResult;
10
10
  export declare function relinkBody(body: string, file: string, moves: ReadonlyMap<string, string>): BodyResult;
11
+ export declare function unlinkBody(body: string, hrefs: ReadonlySet<string>): UnlinkedBody;
11
12
  export declare function links(document: Document, file: string): readonly Link[];
12
13
  export declare function bodyLinks(body: string, file: string): readonly Link[];
13
14
  export declare function apply(document: Document, changes: readonly Change[]): ApplyResult;
@@ -0,0 +1,77 @@
1
+ import { type Definition } from './definition.js';
2
+ import type { Candidate } from './query/match.js';
3
+ import type { Document, VerifiedModel } from './types.js';
4
+ export type FactKind = 'string' | 'number' | 'boolean' | 'date' | 'time' | 'enum' | 'reference';
5
+ type Scalar = string | number | boolean;
6
+ export type Fact = {
7
+ readonly kind: FactKind;
8
+ readonly value: Scalar;
9
+ readonly member?: string;
10
+ } | {
11
+ readonly kind: 'prose';
12
+ } | {
13
+ readonly kind: 'null';
14
+ } | {
15
+ readonly kind: 'unreadable';
16
+ } | {
17
+ readonly kind: 'list';
18
+ readonly items: readonly Fact[];
19
+ } | {
20
+ readonly kind: 'object';
21
+ readonly fields: Readonly<Record<string, Fact>>;
22
+ };
23
+ export type DocumentFacts = {
24
+ readonly id: string;
25
+ readonly path: string;
26
+ readonly type: string | null;
27
+ readonly fields: Readonly<Record<string, Fact>>;
28
+ readonly sections: readonly string[];
29
+ };
30
+ export declare const TEXT_FIELD = "/text";
31
+ export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client', 'function'];
32
+ export type WriteDoor = (typeof WRITE_DOORS)[number];
33
+ export type Actor = {
34
+ readonly user?: string;
35
+ readonly site?: string;
36
+ readonly app?: string;
37
+ readonly door?: WriteDoor;
38
+ };
39
+ export type DocumentEvent = {
40
+ readonly before: DocumentFacts | null;
41
+ readonly after: DocumentFacts | null;
42
+ readonly changed: readonly string[];
43
+ readonly by: Actor;
44
+ readonly moved_between_rooms: boolean;
45
+ };
46
+ export type ItemFacts = {
47
+ readonly delivery: string;
48
+ readonly source: string | null;
49
+ readonly address: string | null;
50
+ readonly container: string | null;
51
+ readonly author: string | null;
52
+ readonly headers: Readonly<Record<string, string>>;
53
+ readonly json: {
54
+ readonly value: unknown;
55
+ } | null;
56
+ };
57
+ export type MessageFacts = {
58
+ readonly sender: string;
59
+ readonly agent_function: string | null;
60
+ readonly path: string | null;
61
+ };
62
+ export type Resolved = {
63
+ readonly id: string;
64
+ readonly member?: string;
65
+ };
66
+ export declare function facts(document: Pick<Document, 'type' | 'fields' | 'sections'>, at: {
67
+ readonly id: string;
68
+ readonly path: string;
69
+ }, model: VerifiedModel, resolve: (target: string) => Resolved | undefined): DocumentFacts;
70
+ export declare function prosePaths(facts: DocumentFacts): string[];
71
+ export declare function members(document: DocumentFacts, path: string): readonly string[];
72
+ export declare function pointed(value: unknown, pointer: string): unknown;
73
+ export declare function valuedChange(definition: Definition, pointer: string): boolean;
74
+ export declare function datePointers(definition: Definition): string[];
75
+ export declare function memberPointers(definition: Definition, memberType: string): string[];
76
+ export declare function candidateOf(document: DocumentFacts): Candidate;
77
+ export {};
@@ -0,0 +1,14 @@
1
+ import type { Document, ParseResult, VerifiedModel } from './types.js';
2
+ export type SavedFacts = {
3
+ readonly type: string;
4
+ readonly fields: Readonly<Record<string, unknown>>;
5
+ readonly links: readonly string[];
6
+ };
7
+ export type ReferenceTarget = {
8
+ readonly location: string;
9
+ readonly to: readonly string[];
10
+ readonly target: string;
11
+ };
12
+ export declare function referenceTarget(file: string, value: string): string | null;
13
+ export declare function referenceTargets(document: Document, file: string, model: VerifiedModel): readonly ReferenceTarget[];
14
+ export declare function documentFacts(file: string, parsed: ParseResult, model: VerifiedModel): SavedFacts | null;