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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/README.md +9 -9
  2. package/dist/index.d.ts +571 -18
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/built-in.d.ts +3 -0
  5. package/dist/mdmodel/crockford.d.ts +3 -0
  6. package/dist/mdmodel/definition.d.ts +21 -10
  7. package/dist/mdmodel/document.d.ts +15 -8
  8. package/dist/mdmodel/event.d.ts +76 -0
  9. package/dist/mdmodel/facts.d.ts +14 -0
  10. package/dist/mdmodel/fields.d.ts +1 -1
  11. package/dist/mdmodel/house-model.d.ts +826 -0
  12. package/dist/mdmodel/house-references.d.ts +3 -0
  13. package/dist/mdmodel/index.d.ts +35 -13
  14. package/dist/mdmodel/kinds.d.ts +17 -0
  15. package/dist/mdmodel/markdown.d.ts +74 -0
  16. package/dist/mdmodel/paths.d.ts +10 -1
  17. package/dist/mdmodel/pattern.d.ts +9 -0
  18. package/dist/mdmodel/query/language.d.ts +253 -0
  19. package/dist/mdmodel/query/match.d.ts +13 -0
  20. package/dist/mdmodel/query/rows.d.ts +31 -0
  21. package/dist/mdmodel/query/sql.d.ts +38 -0
  22. package/dist/mdmodel/reserved.d.ts +5 -0
  23. package/dist/mdmodel/room-types.d.ts +6 -0
  24. package/dist/mdmodel/types.d.ts +29 -10
  25. package/dist/mdmodel/validate.d.ts +31 -6
  26. package/dist/mdruntime/actions.d.ts +25 -0
  27. package/dist/mdruntime/adapter.d.ts +159 -122
  28. package/dist/mdruntime/attached-model.d.ts +6 -0
  29. package/dist/mdruntime/binary.d.ts +0 -5
  30. package/dist/mdruntime/bootstrap.d.ts +43 -0
  31. package/dist/mdruntime/cell.d.ts +5 -0
  32. package/dist/mdruntime/chain.d.ts +11 -0
  33. package/dist/mdruntime/change-set.d.ts +10 -16
  34. package/dist/mdruntime/change.d.ts +32 -1
  35. package/dist/mdruntime/client.d.ts +37 -26
  36. package/dist/mdruntime/collection.d.ts +29 -22
  37. package/dist/mdruntime/compile.d.ts +17 -0
  38. package/dist/mdruntime/conversation-live.d.ts +146 -0
  39. package/dist/mdruntime/conversation-row.d.ts +32 -0
  40. package/dist/mdruntime/conversation.d.ts +68 -49
  41. package/dist/mdruntime/declaration.d.ts +9 -0
  42. package/dist/mdruntime/durability.d.ts +20 -4
  43. package/dist/mdruntime/failure.d.ts +3 -0
  44. package/dist/mdruntime/figures.d.ts +48 -0
  45. package/dist/mdruntime/holdings.d.ts +28 -0
  46. package/dist/mdruntime/identity.d.ts +5 -0
  47. package/dist/mdruntime/listing.d.ts +47 -0
  48. package/dist/mdruntime/live.d.ts +22 -0
  49. package/dist/mdruntime/media.d.ts +7 -0
  50. package/dist/mdruntime/messages.d.ts +55 -0
  51. package/dist/mdruntime/model.d.ts +8 -11
  52. package/dist/mdruntime/observation.d.ts +17 -3
  53. package/dist/mdruntime/opened.d.ts +21 -0
  54. package/dist/mdruntime/outcome.d.ts +47 -9
  55. package/dist/mdruntime/overlay.d.ts +7 -5
  56. package/dist/mdruntime/preparation.d.ts +19 -0
  57. package/dist/mdruntime/presence.d.ts +51 -0
  58. package/dist/mdruntime/query.d.ts +21 -207
  59. package/dist/mdruntime/reach.d.ts +20 -9
  60. package/dist/mdruntime/readiness.d.ts +14 -18
  61. package/dist/mdruntime/reads.d.ts +38 -0
  62. package/dist/mdruntime/recovery.d.ts +5 -2
  63. package/dist/mdruntime/refresh.d.ts +26 -0
  64. package/dist/mdruntime/replica.d.ts +50 -39
  65. package/dist/mdruntime/retried.d.ts +29 -0
  66. package/dist/mdruntime/room-draft.d.ts +28 -11
  67. package/dist/mdruntime/room-drafts.d.ts +23 -0
  68. package/dist/mdruntime/runtime.d.ts +33 -0
  69. package/dist/mdruntime/save.d.ts +43 -50
  70. package/dist/mdruntime/saves.d.ts +31 -0
  71. package/dist/mdruntime/search.d.ts +12 -95
  72. package/dist/mdruntime/seed.d.ts +11 -2
  73. package/dist/mdruntime/socket/admission.d.ts +6 -0
  74. package/dist/mdruntime/socket/answers.d.ts +5 -0
  75. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  76. package/dist/mdruntime/socket/session.d.ts +37 -0
  77. package/dist/mdruntime/socket.d.ts +66 -0
  78. package/dist/mdruntime/source.d.ts +53 -0
  79. package/dist/mdruntime/status.d.ts +4 -5
  80. package/dist/mdruntime/store/installs.d.ts +29 -0
  81. package/dist/mdruntime/store/readiness.d.ts +9 -0
  82. package/dist/mdruntime/store/records.d.ts +214 -0
  83. package/dist/mdruntime/store/room-held.d.ts +7 -0
  84. package/dist/mdruntime/store/space.d.ts +10 -0
  85. package/dist/mdruntime/store/watchers.d.ts +16 -0
  86. package/dist/mdruntime/store/writes.d.ts +23 -0
  87. package/dist/mdruntime/store.d.ts +111 -166
  88. package/dist/mdruntime/stored.d.ts +156 -0
  89. package/dist/mdruntime/surface.d.ts +88 -0
  90. package/dist/mdruntime/tables.d.ts +414 -0
  91. package/dist/mdruntime/tallies.d.ts +17 -0
  92. package/dist/mdruntime/transfer.d.ts +0 -5
  93. package/dist/mdruntime/wire.d.ts +82 -9
  94. package/dist/session-content/bounds.d.ts +7 -0
  95. package/dist/session-content/check.d.ts +18 -0
  96. package/dist/session-content/index.d.ts +7 -0
  97. package/dist/session-content/parts.d.ts +103 -0
  98. package/dist/session-content/state.d.ts +61 -0
  99. package/dist/session-content/turn.d.ts +328 -0
  100. package/dist/test-host.d.ts +7 -4
  101. package/dist/test-host.js +18 -28
  102. package/docs/families.md +65 -57
  103. package/package.json +8 -3
  104. package/dist/calls.d.ts +0 -957
  105. package/dist/calls.js +0 -1
  106. package/dist/mdmodel/blocks.d.ts +0 -10
  107. package/dist/mdmodel/condition.d.ts +0 -147
  108. package/dist/mdmodel/profile.d.ts +0 -5
  109. package/dist/mdruntime/connection.d.ts +0 -146
  110. package/dist/mdruntime/file.d.ts +0 -19
  111. package/dist/mdruntime/rows.d.ts +0 -38
  112. package/dist/mdruntime/shared.d.ts +0 -14
  113. package/dist/mdruntime/turn.d.ts +0 -8
@@ -0,0 +1,328 @@
1
+ import { type Check, type Checked } from './check.js';
2
+ import { type Part } from './parts.js';
3
+ declare const OPERATION: Check<import("./check.js").Shaped<{
4
+ readonly op: Check<"start">;
5
+ readonly index: Check<number>;
6
+ readonly part: Check<import("./check.js").Shaped<{
7
+ readonly type: Check<"call">;
8
+ readonly parent: Check<number | null>;
9
+ readonly line: Check<string>;
10
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
11
+ readonly duration: Check<number | null>;
12
+ readonly kind: Check<"command">;
13
+ readonly exit: Check<number | null>;
14
+ readonly output: Check<string>;
15
+ }> | import("./check.js").Shaped<{
16
+ readonly type: Check<"call">;
17
+ readonly parent: Check<number | null>;
18
+ readonly line: Check<string>;
19
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
20
+ readonly duration: Check<number | null>;
21
+ readonly kind: Check<"edit">;
22
+ readonly files: Check<readonly import("./check.js").Shaped<{
23
+ readonly path: Check<string>;
24
+ readonly added: Check<number>;
25
+ readonly removed: Check<number>;
26
+ readonly diff: Check<string | null>;
27
+ }>[]>;
28
+ }> | import("./check.js").Shaped<{
29
+ readonly type: Check<"call">;
30
+ readonly parent: Check<number | null>;
31
+ readonly line: Check<string>;
32
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
33
+ readonly duration: Check<number | null>;
34
+ readonly kind: Check<"read" | "search">;
35
+ readonly returned: Check<number | null>;
36
+ }> | import("./check.js").Shaped<{
37
+ readonly type: Check<"call">;
38
+ readonly parent: Check<number | null>;
39
+ readonly line: Check<string>;
40
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
41
+ readonly duration: Check<number | null>;
42
+ readonly kind: Check<"fetch" | "other" | "tool">;
43
+ readonly output: Check<string>;
44
+ }> | import("./check.js").Shaped<{
45
+ readonly type: Check<"subagent">;
46
+ readonly parent: Check<number | null>;
47
+ readonly kind: Check<"agent" | "fork" | "workflow">;
48
+ readonly name: Check<string | null>;
49
+ readonly task: Check<string>;
50
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
51
+ readonly step: Check<string | null>;
52
+ readonly report: Check<string | null>;
53
+ readonly tokens: Check<number | null>;
54
+ readonly calls: Check<number | null>;
55
+ readonly duration: Check<number | null>;
56
+ }> | import("./check.js").Shaped<{
57
+ readonly type: Check<"reasoning" | "text">;
58
+ readonly parent: Check<number | null>;
59
+ readonly text: Check<string>;
60
+ }> | import("./check.js").Shaped<{
61
+ readonly type: Check<"message">;
62
+ readonly parent: Check<number | null>;
63
+ readonly command: Check<"agent-functions/cancel" | "agent-functions/mail/send" | "agent-functions/send">;
64
+ readonly target: Check<string | null>;
65
+ }> | import("./check.js").Shaped<{
66
+ readonly type: Check<"image">;
67
+ readonly parent: Check<number | null>;
68
+ readonly file: Check<string>;
69
+ readonly name: Check<string>;
70
+ readonly media_type: Check<string>;
71
+ }> | import("./check.js").Shaped<{
72
+ readonly type: Check<"plan">;
73
+ readonly parent: Check<number | null>;
74
+ readonly entries: Check<readonly import("./check.js").Shaped<{
75
+ readonly content: Check<string>;
76
+ readonly status: Check<"done" | "pending" | "running">;
77
+ }>[]>;
78
+ }> | import("./check.js").Shaped<{
79
+ readonly type: Check<"notice">;
80
+ readonly parent: Check<number | null>;
81
+ readonly kind: Check<"compaction" | "error" | "info" | "mode" | "model" | "retry" | "warning">;
82
+ readonly text: Check<string>;
83
+ }> | import("./check.js").Shaped<{
84
+ readonly type: Check<"background">;
85
+ readonly parent: Check<number | null>;
86
+ readonly kind: Check<"monitor" | "schedule" | "shell" | "task">;
87
+ readonly label: Check<string>;
88
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
89
+ }>>;
90
+ }> | import("./check.js").Shaped<{
91
+ readonly op: Check<"append">;
92
+ readonly index: Check<number>;
93
+ readonly text: Check<string>;
94
+ }> | import("./check.js").Shaped<{
95
+ readonly op: Check<"set">;
96
+ readonly index: Check<number>;
97
+ readonly part: Check<import("./check.js").Shaped<{
98
+ readonly type: Check<"call">;
99
+ readonly parent: Check<number | null>;
100
+ readonly line: Check<string>;
101
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
102
+ readonly duration: Check<number | null>;
103
+ readonly kind: Check<"command">;
104
+ readonly exit: Check<number | null>;
105
+ readonly output: Check<string>;
106
+ }> | import("./check.js").Shaped<{
107
+ readonly type: Check<"call">;
108
+ readonly parent: Check<number | null>;
109
+ readonly line: Check<string>;
110
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
111
+ readonly duration: Check<number | null>;
112
+ readonly kind: Check<"edit">;
113
+ readonly files: Check<readonly import("./check.js").Shaped<{
114
+ readonly path: Check<string>;
115
+ readonly added: Check<number>;
116
+ readonly removed: Check<number>;
117
+ readonly diff: Check<string | null>;
118
+ }>[]>;
119
+ }> | import("./check.js").Shaped<{
120
+ readonly type: Check<"call">;
121
+ readonly parent: Check<number | null>;
122
+ readonly line: Check<string>;
123
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
124
+ readonly duration: Check<number | null>;
125
+ readonly kind: Check<"read" | "search">;
126
+ readonly returned: Check<number | null>;
127
+ }> | import("./check.js").Shaped<{
128
+ readonly type: Check<"call">;
129
+ readonly parent: Check<number | null>;
130
+ readonly line: Check<string>;
131
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
132
+ readonly duration: Check<number | null>;
133
+ readonly kind: Check<"fetch" | "other" | "tool">;
134
+ readonly output: Check<string>;
135
+ }> | import("./check.js").Shaped<{
136
+ readonly type: Check<"subagent">;
137
+ readonly parent: Check<number | null>;
138
+ readonly kind: Check<"agent" | "fork" | "workflow">;
139
+ readonly name: Check<string | null>;
140
+ readonly task: Check<string>;
141
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
142
+ readonly step: Check<string | null>;
143
+ readonly report: Check<string | null>;
144
+ readonly tokens: Check<number | null>;
145
+ readonly calls: Check<number | null>;
146
+ readonly duration: Check<number | null>;
147
+ }> | import("./check.js").Shaped<{
148
+ readonly type: Check<"reasoning" | "text">;
149
+ readonly parent: Check<number | null>;
150
+ readonly text: Check<string>;
151
+ }> | import("./check.js").Shaped<{
152
+ readonly type: Check<"message">;
153
+ readonly parent: Check<number | null>;
154
+ readonly command: Check<"agent-functions/cancel" | "agent-functions/mail/send" | "agent-functions/send">;
155
+ readonly target: Check<string | null>;
156
+ }> | import("./check.js").Shaped<{
157
+ readonly type: Check<"image">;
158
+ readonly parent: Check<number | null>;
159
+ readonly file: Check<string>;
160
+ readonly name: Check<string>;
161
+ readonly media_type: Check<string>;
162
+ }> | import("./check.js").Shaped<{
163
+ readonly type: Check<"plan">;
164
+ readonly parent: Check<number | null>;
165
+ readonly entries: Check<readonly import("./check.js").Shaped<{
166
+ readonly content: Check<string>;
167
+ readonly status: Check<"done" | "pending" | "running">;
168
+ }>[]>;
169
+ }> | import("./check.js").Shaped<{
170
+ readonly type: Check<"notice">;
171
+ readonly parent: Check<number | null>;
172
+ readonly kind: Check<"compaction" | "error" | "info" | "mode" | "model" | "retry" | "warning">;
173
+ readonly text: Check<string>;
174
+ }> | import("./check.js").Shaped<{
175
+ readonly type: Check<"background">;
176
+ readonly parent: Check<number | null>;
177
+ readonly kind: Check<"monitor" | "schedule" | "shell" | "task">;
178
+ readonly label: Check<string>;
179
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
180
+ }>>;
181
+ }>>;
182
+ export type Operation = Checked<typeof OPERATION>;
183
+ export declare const isOperation: Check<Operation>;
184
+ declare const TURN: Check<import("./check.js").Shaped<{
185
+ readonly parts: Check<readonly (import("./check.js").Shaped<{
186
+ readonly type: Check<"call">;
187
+ readonly parent: Check<number | null>;
188
+ readonly line: Check<string>;
189
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
190
+ readonly duration: Check<number | null>;
191
+ readonly kind: Check<"command">;
192
+ readonly exit: Check<number | null>;
193
+ readonly output: Check<string>;
194
+ }> | import("./check.js").Shaped<{
195
+ readonly type: Check<"call">;
196
+ readonly parent: Check<number | null>;
197
+ readonly line: Check<string>;
198
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
199
+ readonly duration: Check<number | null>;
200
+ readonly kind: Check<"edit">;
201
+ readonly files: Check<readonly import("./check.js").Shaped<{
202
+ readonly path: Check<string>;
203
+ readonly added: Check<number>;
204
+ readonly removed: Check<number>;
205
+ readonly diff: Check<string | null>;
206
+ }>[]>;
207
+ }> | import("./check.js").Shaped<{
208
+ readonly type: Check<"call">;
209
+ readonly parent: Check<number | null>;
210
+ readonly line: Check<string>;
211
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
212
+ readonly duration: Check<number | null>;
213
+ readonly kind: Check<"read" | "search">;
214
+ readonly returned: Check<number | null>;
215
+ }> | import("./check.js").Shaped<{
216
+ readonly type: Check<"call">;
217
+ readonly parent: Check<number | null>;
218
+ readonly line: Check<string>;
219
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
220
+ readonly duration: Check<number | null>;
221
+ readonly kind: Check<"fetch" | "other" | "tool">;
222
+ readonly output: Check<string>;
223
+ }> | import("./check.js").Shaped<{
224
+ readonly type: Check<"subagent">;
225
+ readonly parent: Check<number | null>;
226
+ readonly kind: Check<"agent" | "fork" | "workflow">;
227
+ readonly name: Check<string | null>;
228
+ readonly task: Check<string>;
229
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
230
+ readonly step: Check<string | null>;
231
+ readonly report: Check<string | null>;
232
+ readonly tokens: Check<number | null>;
233
+ readonly calls: Check<number | null>;
234
+ readonly duration: Check<number | null>;
235
+ }> | import("./check.js").Shaped<{
236
+ readonly type: Check<"reasoning" | "text">;
237
+ readonly parent: Check<number | null>;
238
+ readonly text: Check<string>;
239
+ }> | import("./check.js").Shaped<{
240
+ readonly type: Check<"message">;
241
+ readonly parent: Check<number | null>;
242
+ readonly command: Check<"agent-functions/cancel" | "agent-functions/mail/send" | "agent-functions/send">;
243
+ readonly target: Check<string | null>;
244
+ }> | import("./check.js").Shaped<{
245
+ readonly type: Check<"image">;
246
+ readonly parent: Check<number | null>;
247
+ readonly file: Check<string>;
248
+ readonly name: Check<string>;
249
+ readonly media_type: Check<string>;
250
+ }> | import("./check.js").Shaped<{
251
+ readonly type: Check<"plan">;
252
+ readonly parent: Check<number | null>;
253
+ readonly entries: Check<readonly import("./check.js").Shaped<{
254
+ readonly content: Check<string>;
255
+ readonly status: Check<"done" | "pending" | "running">;
256
+ }>[]>;
257
+ }> | import("./check.js").Shaped<{
258
+ readonly type: Check<"notice">;
259
+ readonly parent: Check<number | null>;
260
+ readonly kind: Check<"compaction" | "error" | "info" | "mode" | "model" | "retry" | "warning">;
261
+ readonly text: Check<string>;
262
+ }> | import("./check.js").Shaped<{
263
+ readonly type: Check<"background">;
264
+ readonly parent: Check<number | null>;
265
+ readonly kind: Check<"monitor" | "schedule" | "shell" | "task">;
266
+ readonly label: Check<string>;
267
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
268
+ }>)[]>;
269
+ readonly tokens: Check<import("./check.js").Shaped<{
270
+ readonly input: Check<number>;
271
+ readonly output: Check<number>;
272
+ readonly cache_read: Check<number>;
273
+ readonly cache_write: Check<number>;
274
+ }> | null>;
275
+ readonly state: Check<import("./check.js").Shaped<{
276
+ readonly title: Check<string | null>;
277
+ readonly context: Check<import("./check.js").Shaped<{
278
+ readonly used: Check<number>;
279
+ readonly window: Check<number>;
280
+ readonly breakdown: Check<readonly import("./check.js").Shaped<{
281
+ readonly name: Check<string>;
282
+ readonly tokens: Check<number>;
283
+ }>[]>;
284
+ }> | null>;
285
+ readonly limits: Check<readonly import("./check.js").Shaped<{
286
+ readonly name: Check<string | null>;
287
+ readonly minutes: Check<number>;
288
+ readonly percent: Check<number>;
289
+ readonly resets: Check<string | null>;
290
+ }>[]>;
291
+ readonly cost: Check<import("./check.js").Shaped<{
292
+ readonly amount: Check<number>;
293
+ readonly currency: Check<string>;
294
+ }> | null>;
295
+ readonly tokens: Check<import("./check.js").Shaped<{
296
+ readonly input: Check<number>;
297
+ readonly output: Check<number>;
298
+ readonly cache_read: Check<number>;
299
+ readonly cache_write: Check<number>;
300
+ }> | null>;
301
+ readonly duration: Check<number | null>;
302
+ readonly files: Check<readonly import("./check.js").Shaped<{
303
+ readonly path: Check<string>;
304
+ readonly added: Check<number>;
305
+ readonly removed: Check<number>;
306
+ }>[]>;
307
+ readonly branch: Check<string | null>;
308
+ readonly worktree: Check<string | null>;
309
+ readonly pull: Check<import("./check.js").Shaped<{
310
+ readonly number: Check<number>;
311
+ readonly url: Check<string>;
312
+ }> | null>;
313
+ readonly model: Check<string | null>;
314
+ readonly effort: Check<string | null>;
315
+ readonly mode: Check<string | null>;
316
+ readonly suggestion: Check<string | null>;
317
+ readonly running: Check<readonly import("./check.js").Shaped<{
318
+ readonly kind: Check<"monitor" | "schedule" | "shell" | "subagent" | "task">;
319
+ readonly label: Check<string>;
320
+ readonly progress: Check<string | null>;
321
+ readonly next: Check<string | null>;
322
+ }>[]>;
323
+ }>>;
324
+ }>>;
325
+ export type Turn = Checked<typeof TURN>;
326
+ export declare const isTurn: Check<Turn>;
327
+ export declare function applied(parts: readonly Part[], operation: Operation): readonly Part[] | null;
328
+ export {};
@@ -1,11 +1,17 @@
1
1
  import type { MdRuntimeClient } from './mdruntime/client.js';
2
- import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
2
+ import type { HouseAnalyticsChoice, HouseAppMessage, HouseChatOptions, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
3
3
  export interface HouseBridgeNavigation {
4
4
  readonly mode: HouseNavigationMode;
5
5
  readonly address: string;
6
6
  }
7
+ export interface HouseBridgeChat {
8
+ readonly element: object;
9
+ readonly options: HouseChatOptions;
10
+ readonly mounted: boolean;
11
+ }
7
12
  export interface HouseBridgeTestHost {
8
13
  readonly navigations: readonly HouseBridgeNavigation[];
14
+ readonly chats: readonly HouseBridgeChat[];
9
15
  readonly ceremonies: readonly string[];
10
16
  readonly consents: readonly HouseAnalyticsChoice[];
11
17
  readonly tabs: readonly HouseTab[];
@@ -15,9 +21,6 @@ export interface HouseBridgeTestHost {
15
21
  publish(status: HouseStatus): void;
16
22
  message(message: HouseAppMessage): void;
17
23
  attachRuntime(runtime: MdRuntimeClient): void;
18
- checkpoint(): Promise<HouseTask>;
19
- restore(task: HouseTask | null): Promise<boolean>;
20
- settle(activation: HouseActivation): void;
21
24
  }
22
25
  export interface HouseBridgeTestHostOptions {
23
26
  readonly address?: string;
package/dist/test-host.js CHANGED
@@ -50,6 +50,7 @@ export function createHouseBridgeTestHost(options = {}) {
50
50
  const consents = [];
51
51
  const tabs = [];
52
52
  const externalCalls = [];
53
+ const chats = [];
53
54
  const addressListeners = new Set();
54
55
  const statusListeners = new Set();
55
56
  const messageListeners = new Set();
@@ -57,7 +58,6 @@ export function createHouseBridgeTestHost(options = {}) {
57
58
  let published = options.status ?? null;
58
59
  let shown = null;
59
60
  let seen = null;
60
- let cooperation = null;
61
61
  let attached = () => { };
62
62
  const runtime = new Promise((resolve) => {
63
63
  attached = resolve;
@@ -100,6 +100,20 @@ export function createHouseBridgeTestHost(options = {}) {
100
100
  }
101
101
  const bridge = {
102
102
  runtime: runtime,
103
+ chat: {
104
+ mount(element, options = {}) {
105
+ const chat = { element, options, mounted: true };
106
+ chats.push(chat);
107
+ return Promise.resolve({
108
+ update(next) {
109
+ chat.options = next;
110
+ },
111
+ unmount() {
112
+ chat.mounted = false;
113
+ },
114
+ });
115
+ },
116
+ },
103
117
  address: () => shown,
104
118
  onAddress(listener) {
105
119
  return followHeld(addressListeners, listener, () => shown);
@@ -115,7 +129,7 @@ export function createHouseBridgeTestHost(options = {}) {
115
129
  },
116
130
  install: () => Promise.resolve('manual'),
117
131
  notifications: () => Promise.resolve('unavailable'),
118
- setBadge: () => Promise.resolve(),
132
+ telegram: () => Promise.resolve({ state: 'unavailable', name: null, username: null }),
119
133
  setTab(tab) {
120
134
  tabs.push(tab);
121
135
  },
@@ -145,25 +159,15 @@ export function createHouseBridgeTestHost(options = {}) {
145
159
  consents.push(choice);
146
160
  publish({ ...published, analytics: { measures: true, choice } });
147
161
  },
148
- cooperate(given) {
149
- cooperation = given;
150
- return () => {
151
- if (cooperation === given)
152
- cooperation = null;
153
- };
154
- },
162
+ cooperate: () => () => { },
155
163
  };
156
- function cooperating() {
157
- if (cooperation === null)
158
- throw new Error('the App registered no cooperation');
159
- return cooperation;
160
- }
161
164
  Object.defineProperty(globalThis, 'houseBridge', { value: bridge, configurable: true });
162
165
  if (published !== null)
163
166
  publish(published);
164
167
  arrive(current);
165
168
  return {
166
169
  navigations,
170
+ chats,
167
171
  ceremonies,
168
172
  consents,
169
173
  tabs,
@@ -182,19 +186,5 @@ export function createHouseBridgeTestHost(options = {}) {
182
186
  attachRuntime(client) {
183
187
  attached(client);
184
188
  },
185
- async checkpoint() {
186
- const held = cooperating();
187
- await held.checkpoint();
188
- await held.persist();
189
- return JSON.parse(JSON.stringify((await held.capture()) ?? null));
190
- },
191
- async restore(task) {
192
- const held = cooperating();
193
- await held.restore(task);
194
- return (await held.ready()) === true;
195
- },
196
- settle(activation) {
197
- cooperating().settle(activation);
198
- },
199
189
  };
200
190
  }
package/docs/families.md CHANGED
@@ -13,8 +13,8 @@
13
13
  absolute path, carries its current address as the return target, and the page
14
14
  returns there when it completes. An App names an address House gave it in a
15
15
  reading and composes one only for `/bind/<app_ref>`, where the User binds
16
- its Rooms and connects its account slots, with `?slot=<name>` to open at one
17
- slot.
16
+ its Rooms, with `?slot=<name>` to open at one slot, and `/sign-out`, which
17
+ signs the User out and opens sign-in.
18
18
  - **Installation** - `install()` offers the page as a Home-screen app. Where the
19
19
  browser has an install prompt ready the shell shows it and the call resolves
20
20
  `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
@@ -29,11 +29,22 @@
29
29
  notifications, or `'unavailable'` where it has no push, as on an iPhone or
30
30
  iPad outside a Home-screen app. `notifications(true)` asks the browser's
31
31
  permission and subscribes, `notifications(false)` unsubscribes, and each
32
- answers the state it leaves; a failure of the browser's push service, and
33
- of `setBadge`, rejects the same way. Call `notifications(true)` from a
34
- click. `setBadge(unread)` takes the identifiers of the Human Notifications
35
- unread in this storage and sets the icon's badge to their number, or clears
36
- it at none, where the browser shows one.
32
+ answers the state it leaves; a failure of the browser's push service
33
+ rejects the same way. Call `notifications(true)` from a click. House's
34
+ service worker counts the icon's badge itself, as pushes arrive and as
35
+ read marks reach this storage.
36
+ - **Telegram** - House's own panel alone, refused to an App or a Site the same
37
+ way. `telegram()` answers `{ state, name, username }`: `state` is
38
+ `'available'` where the page runs inside a House bot's Mini App that gave it
39
+ Telegram's launch data naming an account, with that account's `name` and its
40
+ `username` or `null`, and `'unavailable'` with both `null` elsewhere.
41
+ `telegram(true)` links the signed-in User to that account and answers
42
+ `'linked'` with it; where the User's sign-in is
43
+ not recent, the page goes to sign in again, and nothing links until a later
44
+ `telegram(true)`.
45
+ Telegram's refusal rejects with an error coded `linked_elsewhere`,
46
+ `rate_limited` or `refused`, and a failed request with the browser's own
47
+ error name.
37
48
  - **Status** - the App reference the runtime client is attached under,
38
49
  `preferences`: the `roomRef` and Path of the App's own preferences document,
39
50
  or `null` until the runtime holds that Room, sync
@@ -47,18 +58,19 @@
47
58
  The App reports the visitor's choice with `analyticsConsent('accept')` or
48
59
  `analyticsConsent('decline')`; the shell hands it to House's analytics loader, and
49
60
  the choice never reaches House.
50
- - **Handoff** - when House hands its runtime over to a newer build, the App keeps
51
- running, its `runtime` client and observations included: a call it makes
52
- meanwhile waits for the newer runtime, however long that takes, and is
53
- answered once, by it; each observation goes on with the newer runtime's
54
- values; and the status and the address arrive again. A runtime that ended
55
- before answering has its reads answered by the next one; since it may have
56
- applied any other call, an act on House is answered the outcome
57
- `transport-uncertainty`, and every other call, a Save or a draft write among
58
- them, fails with the retryable code `transport-uncertainty`.
59
- - **Site image read** - given a Published Room and an original attachment
60
- reference, it answers the web copy's path and metadata, or `null` when no
61
- copy exists. The original bytes never cross this bridge at a Site.
61
+ - **Releases and builds** - an open App keeps the release it loaded: a newer
62
+ release, or a newer House build, takes effect at the App's next load, offline
63
+ too once the browser stored it. When one tab loads a newer House build, the
64
+ other House tabs reload into it; Room Drafts, chat drafts and unsent changes
65
+ survive the reload.
66
+ - **A runtime that ends** - when the browser ends House's runtime under an open
67
+ App, the App keeps running, its `runtime` client and observations included:
68
+ each observation goes on with the next runtime's values, and the status and
69
+ the address arrive again. A runtime that ended before answering has its reads
70
+ answered by the next one; since it may have applied any other call, an act on
71
+ House is answered the outcome `transport-uncertainty`, and every other call,
72
+ a Save or a draft write among them, fails with the retryable code
73
+ `transport-uncertainty`.
62
74
  - **App release code** - `sourceTop(app, release)` answers the top level of
63
75
  the latest successful release of an App the User may use: its folders, its
64
76
  files with their sizes and its root README's text, or `null` for none;
@@ -66,25 +78,24 @@
66
78
  path, its size and its `text`, or its bytes as `base64`. The browser keeps
67
79
  each answer per App and release: a read naming a release it holds answers
68
80
  without asking House, and keeping a newer release drops the earlier one. A
69
- refusal is House's `{ error: { code, retryable } }`, `app_release_not_found` for an
81
+ refusal is House's `{ error: { code, retryable } }`, `not_found` for an
70
82
  App with no release; a read House does not answer, or one that outlived
71
83
  the browser's signed-in User, is `null`.
72
- - **External calls** - `callExternal({ url, method, headers, body, slot, room_ref })`
84
+ - **External calls** - `callExternal({ url, method, headers, body, room_ref })`
73
85
  has House's server send an HTTPS request to one of the release's declared
74
86
  external origins and resolves with the service's `status`, `headers` and its
75
87
  body as `body` text or `body_base64`, or a refusal as House's
76
88
  `{ error: { code, retryable } }`, or `null` when House does not answer. House fills in the
77
- App and its running release; naming an account slot and one of the App's
78
- bound Rooms places the key of the account that Room connects to the slot,
79
- when the User holds one of the account's roles there, which the App never
80
- sees, and naming neither sends no key. A Site's call names no slot, and the House panel names an
81
- `account` instead. `body_base64` replaces `body` for bytes.
89
+ App and its running release. A `room_ref` names a Room the signed-in User binds to the App
90
+ in a `write` slot, and House adds that Room's Service key for the URL's origin, which App
91
+ code never sees; a call naming no Room carries no key, and a Site's call names no Room.
92
+ `body_base64` replaces `body` for bytes.
82
93
  - **App messages** - `messages(listener)` hands the listener each message
83
94
  another holder of this App sends to this User's running copies, as `from`,
84
95
  the sender's User id, and `body`, the JSON value they sent, until the
85
96
  function it returns is called. App code sends one through the Runtime's
86
- `call('message.send', { to, body })` with the recipient's User id and
87
- a body of at most 32 KiB of JSON; House fills in the App and relays it only
97
+ `call('apps/messages/send', { to, body })` with the recipient's User id and
98
+ a body of at most 32 kB of JSON; House fills in the App and relays it only
88
99
  to copies running now, storing nothing. The panel sends none.
89
100
  - **App screenshot read** - given an App reference, `readScreenshot(app)`
90
101
  answers the image this browser captured of that App's screen the first time
@@ -96,30 +107,27 @@
96
107
  after its latest release, as a JPEG `Blob`, or `null` when House holds none
97
108
  or does not answer. A Site's own renderer reads none.
98
109
 
99
- - **Cooperation** - `cooperate({ checkpoint, persist, capture, restore,
100
- ready, settle })` lets House activate a newer release of the App while it
101
- runs, keeping the User's task; the function it returns withdraws it.
102
- Register it in the entry script, before the first draw, or House treats the
103
- page as not cooperating and the newer release waits for the App's next
104
- open. When a newer release is stored, House calls `checkpoint()`, which
105
- resolves at the App's next safe checkpoint and may never resolve, then
106
- `persist()`, which makes authored work durable, then `capture()`, which
107
- answers the meaningful task the App owns, such as the selected record,
108
- filters, cursor, selection and scroll position, as JSON of at most 65,536
109
- characters; House keeps the address itself. In the newer release House
110
- calls `restore(task)` once its document has drawn, so the scroll position
111
- and focus it sets hold, or `restore(null)` when it opens the release without
112
- a task, then `ready()`, the App's own check that its local data and
113
- capabilities work, and finally `settle('committed')` once the release is
114
- active or `settle('abandoned')` when House returns to the release before
115
- it, restoring the same task there. A release House opens already active is
116
- settled `'committed'` at once, after `restore(task)` when House hands it a
117
- task, and a cooperation registered after House settled is settled at its
118
- registration. Until `settle('committed')` House fails the release's outside
119
- calls at once, as offline, those of the workers it starts included, and
120
- refuses its Saves, write acts and external calls with the retryable code
121
- `house_trial_withheld`, so a start-up effect is not repeated; run start-up
122
- effects after `settle('committed')`.
110
+ - **Chat** - `chat.mount(element, options)` places House's Chat, the one chat
111
+ in which the User's Agent conversations show, in `element` over the page's
112
+ `runtime` client, and resolves to a handle: `update(options)` replaces its
113
+ options and `unmount()` removes it. House serves the Chat with the page and
114
+ keeps it current, so the App installs and bundles nothing for it. The
115
+ options: the Chat fills the element with one chat, `conversation` opens one,
116
+ `null` for a new chat with `agent`, the Agent it goes to, `onOpen` hears
117
+ each conversation it opens as `{ conversation, agent }`, and `onLink` takes
118
+ a link without a scheme in place of the browser. CSS custom properties named `--chat-*` on the element
119
+ or an ancestor set its look. It shows conversations only to a release that
120
+ declares them. A Site and the House panel have none: their call rejects with
121
+ an error named and coded `NotSupportedError`, with `retryable` false.
122
+
123
+ - **First place** - `cooperate({ placed })` tells House when the page has
124
+ drawn the place it opened on; the function it returns withdraws it. Register
125
+ it in the entry script, before the first draw. `placed()` resolves once the
126
+ page has drawn that place with what it shows: House keeps its
127
+ first-preparation surface over a page registered by its first draw until
128
+ then, and lifts it at the first draw of a page that registered none, so the
129
+ User goes from the surface to a drawn place in one change. House asks the
130
+ page for nothing else.
123
131
 
124
132
  ## The test host
125
133
 
@@ -141,9 +149,9 @@ records in `tabs` each `setTab`, answers a release code read from the
141
149
  by App reference and `readSiteScreenshot` from the `siteScreenshots` it was
142
150
  given by Site identifier, answers every `install()` `'manual'`, as a browser
143
151
  with no install prompt does, answers every `notifications()` `'unavailable'`,
144
- as a browser without push does, settles every `setBadge`, delivers each App
152
+ as a browser without push does, records in `chats`
153
+ each Chat `chat.mount` places, with its `element`, the `options` it was last
154
+ given and whether it is still `mounted`, drawing nothing, delivers each App
145
155
  message `message({ from, body })` plays, and hands `bridge.runtime` the MD
146
- Runtime client `attachRuntime(client)` gives it. `checkpoint()` runs the
147
- registered cooperation's checkpoint, persist and capture and answers the task,
148
- `restore(task)` runs its restore and answers its readiness check, and
149
- `settle(activation)` hands it the outcome.
156
+ Runtime client `attachRuntime(client)` gives it. It takes a `cooperate` and
157
+ never calls `placed()`.