@agentshouse/app-bridge 0.1.0-c18a49dbe286b → 0.1.0-c1996d56f778a

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 (62) hide show
  1. package/README.md +2 -2
  2. package/dist/index.d.ts +47 -408
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/definition.d.ts +19 -9
  5. package/dist/mdmodel/document.d.ts +10 -5
  6. package/dist/mdmodel/event.d.ts +1 -2
  7. package/dist/mdmodel/fields.d.ts +1 -1
  8. package/dist/mdmodel/index.d.ts +9 -7
  9. package/dist/mdmodel/markdown.d.ts +28 -4
  10. package/dist/mdmodel/paths.d.ts +10 -1
  11. package/dist/mdmodel/types.d.ts +10 -7
  12. package/dist/mdmodel/validate.d.ts +4 -2
  13. package/dist/mdruntime/actions.d.ts +8 -2
  14. package/dist/mdruntime/adapter.d.ts +27 -48
  15. package/dist/mdruntime/bootstrap.d.ts +1 -1
  16. package/dist/mdruntime/change-set.d.ts +4 -0
  17. package/dist/mdruntime/client.d.ts +6 -17
  18. package/dist/mdruntime/collection.d.ts +22 -4
  19. package/dist/mdruntime/compile.d.ts +2 -0
  20. package/dist/mdruntime/conversation-live.d.ts +10 -6
  21. package/dist/mdruntime/conversation.d.ts +28 -10
  22. package/dist/mdruntime/declaration.d.ts +9 -0
  23. package/dist/mdruntime/durability.d.ts +3 -0
  24. package/dist/mdruntime/failure.d.ts +3 -0
  25. package/dist/mdruntime/listing.d.ts +6 -11
  26. package/dist/mdruntime/messages.d.ts +9 -5
  27. package/dist/mdruntime/model.d.ts +0 -1
  28. package/dist/mdruntime/opened.d.ts +1 -1
  29. package/dist/mdruntime/outcome.d.ts +3 -0
  30. package/dist/mdruntime/overlay.d.ts +5 -1
  31. package/dist/mdruntime/presence.d.ts +51 -0
  32. package/dist/mdruntime/reads.d.ts +3 -1
  33. package/dist/mdruntime/recovery.d.ts +3 -1
  34. package/dist/mdruntime/replica.d.ts +5 -11
  35. package/dist/mdruntime/retried.d.ts +29 -0
  36. package/dist/mdruntime/room-draft.d.ts +3 -3
  37. package/dist/mdruntime/runtime.d.ts +9 -18
  38. package/dist/mdruntime/save.d.ts +42 -90
  39. package/dist/mdruntime/saves.d.ts +2 -40
  40. package/dist/mdruntime/socket/lanes.d.ts +12 -4
  41. package/dist/mdruntime/socket.d.ts +3 -6
  42. package/dist/mdruntime/source.d.ts +0 -7
  43. package/dist/mdruntime/store/records.d.ts +7 -5
  44. package/dist/mdruntime/store.d.ts +11 -6
  45. package/dist/mdruntime/stored.d.ts +1 -0
  46. package/dist/mdruntime/surface.d.ts +1 -1
  47. package/dist/mdruntime/tables.d.ts +6 -7
  48. package/dist/mdruntime/wire.d.ts +51 -7
  49. package/dist/session-content/bounds.d.ts +7 -0
  50. package/dist/session-content/check.d.ts +18 -0
  51. package/dist/session-content/index.d.ts +7 -0
  52. package/dist/session-content/parts.d.ts +103 -0
  53. package/dist/session-content/state.d.ts +61 -0
  54. package/dist/session-content/turn.d.ts +328 -0
  55. package/docs/families.md +4 -9
  56. package/package.json +2 -2
  57. package/dist/mdruntime/install.d.ts +0 -55
  58. package/dist/mdruntime/job.d.ts +0 -32
  59. package/dist/mdruntime/log.d.ts +0 -5
  60. package/dist/mdruntime/socket/rooms.d.ts +0 -43
  61. package/dist/mdruntime/store/fences.d.ts +0 -15
  62. package/dist/mdruntime/turn.d.ts +0 -8
package/README.md CHANGED
@@ -3,8 +3,8 @@
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 thirteen families: navigation,
7
- ceremonies, installation, notifications, Telegram, status, Site image reads, App
6
+ carries no bridge code of its own. It carries these families: navigation,
7
+ ceremonies, installation, notifications, Telegram, status, App
8
8
  release code, external calls, App messages, App and Site screenshot reads and the
9
9
  Chat. [docs/families.md](docs/families.md) describes each and the test host.
10
10
 
package/dist/index.d.ts CHANGED
@@ -1,7 +1,12 @@
1
1
  import type { MdRuntimeClient, Open } from './mdruntime/client.js';
2
2
  export interface HouseMethods {
3
+ readonly "agent-functions/decide": {
4
+ readonly params: never;
5
+ readonly result: never;
6
+ };
3
7
  readonly "agent-functions/requests/list": {
4
8
  readonly params: {
9
+ readonly operation_id?: string;
5
10
  readonly room_ref: string;
6
11
  };
7
12
  readonly result: {
@@ -16,7 +21,9 @@ export interface HouseMethods {
16
21
  };
17
22
  };
18
23
  readonly "apps/features/list": {
19
- readonly params: {};
24
+ readonly params: {
25
+ readonly operation_id?: string;
26
+ };
20
27
  readonly result: {
21
28
  readonly features: readonly {
22
29
  readonly allowed: boolean;
@@ -25,7 +32,9 @@ export interface HouseMethods {
25
32
  };
26
33
  };
27
34
  readonly "apps/holders/list": {
28
- readonly params: {};
35
+ readonly params: {
36
+ readonly operation_id?: string;
37
+ };
29
38
  readonly result: {
30
39
  readonly holders: readonly {
31
40
  readonly name: string;
@@ -36,6 +45,7 @@ export interface HouseMethods {
36
45
  readonly "apps/messages/send": {
37
46
  readonly params: {
38
47
  readonly body: unknown;
48
+ readonly operation_id?: string;
39
49
  readonly to: string;
40
50
  };
41
51
  readonly result: {
@@ -44,7 +54,7 @@ export interface HouseMethods {
44
54
  };
45
55
  readonly "apps/relay/read": {
46
56
  readonly params: {
47
- readonly [key: string]: never;
57
+ readonly operation_id?: string;
48
58
  };
49
59
  readonly result: {
50
60
  readonly expires_at: string;
@@ -57,6 +67,7 @@ export interface HouseMethods {
57
67
  };
58
68
  readonly "apps/ring": {
59
69
  readonly params: {
70
+ readonly operation_id?: string;
60
71
  readonly to: string;
61
72
  };
62
73
  readonly result: {
@@ -72,7 +83,7 @@ export interface HouseMethods {
72
83
  } | {
73
84
  readonly user: string;
74
85
  };
75
- readonly operation_id: string;
86
+ readonly operation_id?: string;
76
87
  readonly path: string;
77
88
  readonly room_ref: string;
78
89
  };
@@ -98,7 +109,7 @@ export interface HouseMethods {
98
109
  };
99
110
  readonly "chats/reply": {
100
111
  readonly params: {
101
- readonly operation_id: string;
112
+ readonly operation_id?: string;
102
113
  readonly path: string;
103
114
  readonly room_ref: string;
104
115
  readonly template?: {
@@ -121,6 +132,7 @@ export interface HouseMethods {
121
132
  };
122
133
  readonly "chats/return": {
123
134
  readonly params: {
135
+ readonly operation_id?: string;
124
136
  readonly path: string;
125
137
  readonly room_ref: string;
126
138
  };
@@ -146,7 +158,7 @@ export interface HouseMethods {
146
158
  };
147
159
  readonly "chats/take-control": {
148
160
  readonly params: {
149
- readonly operation_id: string;
161
+ readonly operation_id?: string;
150
162
  readonly path: string;
151
163
  readonly room_ref: string;
152
164
  };
@@ -171,341 +183,52 @@ export interface HouseMethods {
171
183
  };
172
184
  };
173
185
  readonly "conversations/create": {
174
- readonly params: {
175
- readonly agent_id: string;
176
- readonly operation_id: string;
177
- };
178
- readonly result: {
179
- readonly agent_id: string;
180
- readonly authority: string;
181
- readonly conversation_id: string;
182
- readonly log_epoch: string;
183
- readonly position: string;
184
- readonly url: string;
185
- };
186
+ readonly params: never;
187
+ readonly result: never;
186
188
  };
187
189
  readonly "conversations/delete": {
188
- readonly params: {
189
- readonly conversation_id: string;
190
- readonly operation_id: string;
191
- };
192
- readonly result: {
193
- readonly authority: string;
194
- readonly conversation_id: string;
195
- readonly log_epoch: string;
196
- readonly outcome: "deleted";
197
- readonly position: string;
198
- };
199
- };
200
- readonly "conversations/end": {
201
- readonly params: {
202
- readonly conversation_id: string;
203
- readonly operation_id: string;
204
- };
205
- readonly result: {
206
- readonly agent_id: string;
207
- readonly authority: string;
208
- readonly conversation_id: string;
209
- readonly jobs: readonly {
210
- readonly name: string;
211
- readonly running_since: string;
212
- }[];
213
- readonly log_epoch: string;
214
- readonly position: string;
215
- readonly url: string;
216
- };
190
+ readonly params: never;
191
+ readonly result: never;
217
192
  };
218
193
  readonly "conversations/history/list": {
219
- readonly params: {
220
- readonly conversations: readonly {
221
- readonly after?: {
222
- readonly accepted_at: string;
223
- readonly message_id: string;
224
- };
225
- readonly conversation_id: string;
226
- }[];
227
- readonly limit?: number;
228
- };
229
- readonly result: {
230
- readonly histories: readonly {
231
- readonly agent_id: string;
232
- readonly conversation_id: string;
233
- readonly messages: readonly {
234
- readonly accepted_at: string;
235
- readonly context: null | {
236
- readonly used: number;
237
- readonly window: number;
238
- };
239
- readonly conversation_id: string;
240
- readonly failure: null | string;
241
- readonly message_id: string;
242
- readonly parts: readonly ({
243
- readonly command: string;
244
- readonly target: null | string;
245
- readonly type: "message";
246
- } | {
247
- readonly count: number;
248
- readonly type: "commands";
249
- } | {
250
- readonly description: string;
251
- readonly result: null | string;
252
- readonly status: "done" | "running";
253
- readonly type: "subagent";
254
- } | {
255
- readonly entries: readonly {
256
- readonly content: string;
257
- readonly status: string;
258
- }[];
259
- readonly type: "plan";
260
- } | {
261
- readonly file: string;
262
- readonly media_type: string;
263
- readonly name: string;
264
- readonly type: "image";
265
- } | {
266
- readonly marker: "compaction" | "job" | "mode" | "model" | "retry";
267
- readonly text: string;
268
- readonly type: "marker";
269
- } | {
270
- readonly text: string;
271
- readonly type: "reasoning";
272
- } | {
273
- readonly text: string;
274
- readonly type: "text";
275
- })[];
276
- readonly role: "assistant" | "house" | "user";
277
- readonly sender?: "conversation" | "customer" | "owner" | "replier" | "report" | "requester" | "trigger";
278
- readonly source?: {
279
- readonly agent: {
280
- readonly id: string;
281
- readonly name: string;
282
- readonly url: string;
283
- };
284
- readonly approved_at?: string;
285
- readonly declined_at?: string;
286
- readonly kind: "mail";
287
- readonly owner: {
288
- readonly name: string;
289
- readonly user: string;
290
- };
291
- readonly request: string;
292
- readonly room: string;
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
- };
323
- readonly approved_at: null | string;
324
- readonly kind: "request";
325
- readonly request: string;
326
- readonly requester: {
327
- readonly name: string;
328
- readonly room: string;
329
- readonly url: string;
330
- } | {
331
- readonly name: string;
332
- readonly user: string;
333
- };
334
- readonly room: {
335
- readonly handle: string;
336
- readonly name: string;
337
- readonly ref: string;
338
- readonly url: string;
339
- };
340
- } | {
341
- readonly kind: "reply";
342
- readonly name: string;
343
- } | {
344
- readonly kind: "trigger";
345
- readonly path: null | string;
346
- readonly room: {
347
- readonly handle: string;
348
- readonly name: string;
349
- readonly ref: string;
350
- readonly url: string;
351
- };
352
- readonly trigger: {
353
- readonly description: string;
354
- readonly id: string;
355
- };
356
- };
357
- readonly telegram_undelivered?: true;
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
- };
365
- readonly transcripts?: readonly {
366
- readonly path: string;
367
- readonly text: string;
368
- }[];
369
- readonly turn_id: null | string;
370
- readonly url?: string;
371
- readonly waiting?: true;
372
- }[];
373
- readonly next: null | {
374
- readonly accepted_at: string;
375
- readonly message_id: string;
376
- };
377
- readonly url: string;
378
- }[];
379
- };
194
+ readonly params: never;
195
+ readonly result: never;
380
196
  };
381
197
  readonly "conversations/interaction/answer": {
382
- readonly params: {
383
- readonly conversation_id: string;
384
- readonly interaction_id: string;
385
- readonly operation_id: string;
386
- readonly response: readonly unknown[] | boolean | null | number | {
387
- readonly [key: string]: unknown;
388
- } | string;
389
- };
390
- readonly result: {
391
- readonly agent_id: string;
392
- readonly authority: string;
393
- readonly conversation_id: string;
394
- readonly interaction_id: string;
395
- readonly log_epoch: string;
396
- readonly position: string;
397
- readonly url: string;
398
- };
198
+ readonly params: never;
199
+ readonly result: never;
399
200
  };
400
201
  readonly "conversations/interrupt": {
401
- readonly params: {
402
- readonly conversation_id: string;
403
- readonly operation_id: string;
404
- };
405
- readonly result: {
406
- readonly agent_id: string;
407
- readonly authority: string;
408
- readonly conversation_id: string;
409
- readonly log_epoch: string;
410
- readonly position: string;
411
- readonly url: string;
412
- };
202
+ readonly params: never;
203
+ readonly result: never;
413
204
  };
414
205
  readonly "conversations/kill": {
415
- readonly params: {
416
- readonly conversation_id: string;
417
- readonly operation_id: string;
418
- };
419
- readonly result: {
420
- readonly agent_id: string;
421
- readonly authority: string;
422
- readonly conversation_id: string;
423
- readonly log_epoch: string;
424
- readonly position: string;
425
- readonly url: string;
426
- };
206
+ readonly params: never;
207
+ readonly result: never;
427
208
  };
428
209
  readonly "conversations/option/set": {
429
- readonly params: {
430
- readonly conversation_id: string;
431
- readonly operation_id: string;
432
- readonly option: string;
433
- readonly value: boolean | string;
434
- };
435
- readonly result: {
436
- readonly agent_id: string;
437
- readonly authority: string;
438
- readonly conversation_id: string;
439
- readonly log_epoch: string;
440
- readonly position: string;
441
- readonly url: string;
442
- };
210
+ readonly params: never;
211
+ readonly result: never;
443
212
  };
444
213
  readonly "conversations/rename": {
445
- readonly params: {
446
- readonly conversation_id: string;
447
- readonly name: string;
448
- readonly operation_id: string;
449
- };
450
- readonly result: {
451
- readonly agent_id: string;
452
- readonly authority: string;
453
- readonly conversation_id: string;
454
- readonly log_epoch: string;
455
- readonly name: string;
456
- readonly position: string;
457
- readonly url: string;
458
- };
214
+ readonly params: never;
215
+ readonly result: never;
459
216
  };
460
217
  readonly "conversations/retry": {
461
- readonly params: {
462
- readonly conversation_id: string;
463
- readonly message_id: string;
464
- readonly operation_id: string;
465
- };
466
- readonly result: {
467
- readonly agent_id: string;
468
- readonly authority: string;
469
- readonly conversation_id: string;
470
- readonly log_epoch: string;
471
- readonly message_id: string;
472
- readonly position: string;
473
- readonly url: string;
474
- };
218
+ readonly params: never;
219
+ readonly result: never;
475
220
  };
476
221
  readonly "conversations/send": {
477
- readonly params: {
478
- readonly conversation_id: string;
479
- readonly operation_id: string;
480
- readonly text: string;
481
- };
482
- readonly result: {
483
- readonly agent_id: string;
484
- readonly authority: string;
485
- readonly conversation_id: string;
486
- readonly log_epoch: string;
487
- readonly message_id: string;
488
- readonly position: string;
489
- readonly url: string;
490
- };
222
+ readonly params: never;
223
+ readonly result: never;
491
224
  };
492
- readonly "records/list": {
493
- readonly params: {
494
- readonly order?: "asc" | "desc";
495
- readonly room_ref: string;
496
- };
497
- readonly result: {
498
- readonly records: readonly {
499
- readonly body: null | string;
500
- readonly claimed: unknown;
501
- readonly created_at: string;
502
- readonly record: string;
503
- readonly ref: string;
504
- }[];
505
- };
225
+ readonly "conversations/take-out": {
226
+ readonly params: never;
227
+ readonly result: never;
506
228
  };
507
229
  readonly "rooms/access/list": {
508
230
  readonly params: {
231
+ readonly operation_id?: string;
509
232
  readonly room_ref: string;
510
233
  };
511
234
  readonly result: {
@@ -544,6 +267,7 @@ export interface HouseMethods {
544
267
  readonly "rooms/members/list": {
545
268
  readonly params: {
546
269
  readonly history?: boolean;
270
+ readonly operation_id?: string;
547
271
  readonly room_ref: string;
548
272
  };
549
273
  readonly result: {
@@ -568,6 +292,7 @@ export interface HouseMethods {
568
292
  };
569
293
  readonly "rooms/settings/processing/read": {
570
294
  readonly params: {
295
+ readonly operation_id?: string;
571
296
  readonly path: string;
572
297
  readonly room_ref: string;
573
298
  };
@@ -609,6 +334,7 @@ export interface HouseMethods {
609
334
  };
610
335
  readonly "storage/inventory/read": {
611
336
  readonly params: {
337
+ readonly operation_id?: string;
612
338
  readonly room_ref?: string;
613
339
  readonly rooms?: "owned";
614
340
  };
@@ -621,19 +347,9 @@ export interface HouseMethods {
621
347
  readonly state: "settled";
622
348
  };
623
349
  readonly indexed_text: {
624
- readonly approximate_pages: null | string;
625
350
  readonly bytes: string;
626
351
  readonly gigabytes: string;
627
352
  };
628
- readonly measurement: {
629
- readonly page_reference: null | {
630
- readonly bytes_per_page: string;
631
- readonly encoding: string;
632
- readonly font: string;
633
- readonly font_size_pt: string;
634
- readonly layout: string;
635
- };
636
- };
637
353
  readonly room_ref: string;
638
354
  readonly total: {
639
355
  readonly bytes: string;
@@ -649,19 +365,9 @@ export interface HouseMethods {
649
365
  readonly state: "settled";
650
366
  };
651
367
  readonly indexed_text: {
652
- readonly approximate_pages: null | string;
653
368
  readonly bytes: string;
654
369
  readonly gigabytes: string;
655
370
  };
656
- readonly measurement: {
657
- readonly page_reference: null | {
658
- readonly bytes_per_page: string;
659
- readonly encoding: string;
660
- readonly font: string;
661
- readonly font_size_pt: string;
662
- readonly layout: string;
663
- };
664
- };
665
371
  readonly rooms?: readonly {
666
372
  readonly blob: {
667
373
  readonly bytes: string;
@@ -671,19 +377,9 @@ export interface HouseMethods {
671
377
  readonly state: "settled";
672
378
  };
673
379
  readonly indexed_text: {
674
- readonly approximate_pages: null | string;
675
380
  readonly bytes: string;
676
381
  readonly gigabytes: string;
677
382
  };
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
383
  readonly room_ref: string;
688
384
  readonly total: {
689
385
  readonly bytes: string;
@@ -700,65 +396,11 @@ export interface HouseMethods {
700
396
  readonly bytes: string;
701
397
  readonly gigabytes: string;
702
398
  };
703
- } | {
704
- readonly blob: {
705
- readonly bytes: string;
706
- readonly gigabytes: string;
707
- };
708
- readonly freshness: {
709
- readonly state: "settled";
710
- };
711
- readonly indexed_text: {
712
- readonly approximate_pages: null | string;
713
- readonly bytes: string;
714
- readonly gigabytes: string;
715
- };
716
- readonly measurement: {
717
- readonly page_reference: null | {
718
- readonly bytes_per_page: string;
719
- readonly encoding: string;
720
- readonly font: string;
721
- readonly font_size_pt: string;
722
- readonly layout: string;
723
- };
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
- }[];
754
- readonly total: {
755
- readonly bytes: string;
756
- readonly gigabytes: string;
757
- };
758
399
  };
759
400
  };
760
401
  readonly "triggers/fired/list": {
761
402
  readonly params: {
403
+ readonly operation_id?: string;
762
404
  readonly room_ref?: string;
763
405
  };
764
406
  readonly result: {
@@ -920,7 +562,7 @@ export interface HouseCredentialState {
920
562
  readonly state: Open<'none' | 'held' | 'rejected'>;
921
563
  readonly expiresAt: number | null;
922
564
  }
923
- export type HouseDatabaseFailure = 'unsupported' | 'damaged';
565
+ export type HouseDatabaseFailure = 'damaged';
924
566
  export type HouseAnalyticsChoice = 'accept' | 'decline';
925
567
  export interface HouseAnalytics {
926
568
  readonly measures: boolean;
@@ -1024,7 +666,6 @@ export interface HouseBrowserRefused extends Error {
1024
666
  export interface HouseCooperation {
1025
667
  placed(): Promise<void> | void;
1026
668
  }
1027
- export type HouseChatWidth = 'full' | '3/4' | '1/2' | '1/3';
1028
669
  export interface HouseChatOpened {
1029
670
  readonly conversation: string | null;
1030
671
  readonly agent: string | null;
@@ -1032,8 +673,6 @@ export interface HouseChatOpened {
1032
673
  export interface HouseChatOptions {
1033
674
  readonly conversation?: string | null;
1034
675
  readonly agent?: string | null;
1035
- readonly showChats?: boolean;
1036
- readonly width?: HouseChatWidth;
1037
676
  readonly onOpen?: (opened: HouseChatOpened) => void;
1038
677
  readonly onLink?: (href: string) => void;
1039
678
  }