@agentshouse/app-bridge 0.1.0-ccf413b4e709d → 0.1.0-ccf6bf7d473e2

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 (110) hide show
  1. package/README.md +11 -9
  2. package/dist/index.d.ts +588 -7
  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 +90 -0
  7. package/dist/mdmodel/divide.d.ts +2 -0
  8. package/dist/mdmodel/document.d.ts +22 -0
  9. package/dist/mdmodel/event.d.ts +76 -0
  10. package/dist/mdmodel/facts.d.ts +14 -0
  11. package/dist/mdmodel/fields.d.ts +5 -0
  12. package/dist/mdmodel/house-model.d.ts +826 -0
  13. package/dist/mdmodel/house-references.d.ts +3 -0
  14. package/dist/mdmodel/index.d.ts +42 -0
  15. package/dist/mdmodel/kinds.d.ts +17 -0
  16. package/dist/mdmodel/markdown.d.ts +74 -0
  17. package/dist/mdmodel/media-type.d.ts +71 -0
  18. package/dist/mdmodel/paths.d.ts +34 -0
  19. package/dist/mdmodel/pattern.d.ts +9 -0
  20. package/dist/mdmodel/project.d.ts +21 -0
  21. package/dist/mdmodel/query/language.d.ts +253 -0
  22. package/dist/mdmodel/query/match.d.ts +13 -0
  23. package/dist/mdmodel/query/rows.d.ts +31 -0
  24. package/dist/mdmodel/query/sql.d.ts +38 -0
  25. package/dist/mdmodel/references.d.ts +3 -0
  26. package/dist/mdmodel/reserved.d.ts +5 -0
  27. package/dist/mdmodel/room-types.d.ts +6 -0
  28. package/dist/mdmodel/types.d.ts +181 -0
  29. package/dist/mdmodel/validate.d.ts +35 -0
  30. package/dist/mdmodel/version.d.ts +1 -0
  31. package/dist/mdmodel/yaml.d.ts +55 -0
  32. package/dist/mdruntime/actions.d.ts +25 -0
  33. package/dist/mdruntime/adapter.d.ts +540 -0
  34. package/dist/mdruntime/attached-model.d.ts +6 -0
  35. package/dist/mdruntime/binary.d.ts +17 -0
  36. package/dist/mdruntime/bootstrap.d.ts +43 -0
  37. package/dist/mdruntime/cell.d.ts +5 -0
  38. package/dist/mdruntime/chain.d.ts +11 -0
  39. package/dist/mdruntime/change-set.d.ts +31 -0
  40. package/dist/mdruntime/change.d.ts +119 -0
  41. package/dist/mdruntime/client.d.ts +97 -0
  42. package/dist/mdruntime/collection.d.ts +46 -0
  43. package/dist/mdruntime/compile.d.ts +17 -0
  44. package/dist/mdruntime/conversation-live.d.ts +146 -0
  45. package/dist/mdruntime/conversation-row.d.ts +32 -0
  46. package/dist/mdruntime/conversation.d.ts +135 -0
  47. package/dist/mdruntime/declaration.d.ts +9 -0
  48. package/dist/mdruntime/durability.d.ts +30 -0
  49. package/dist/mdruntime/failure.d.ts +15 -0
  50. package/dist/mdruntime/figures.d.ts +48 -0
  51. package/dist/mdruntime/holdings.d.ts +28 -0
  52. package/dist/mdruntime/identity.d.ts +5 -0
  53. package/dist/mdruntime/listing.d.ts +47 -0
  54. package/dist/mdruntime/live.d.ts +22 -0
  55. package/dist/mdruntime/media.d.ts +7 -0
  56. package/dist/mdruntime/messages.d.ts +55 -0
  57. package/dist/mdruntime/model.d.ts +54 -0
  58. package/dist/mdruntime/observation.d.ts +45 -0
  59. package/dist/mdruntime/open.d.ts +1 -0
  60. package/dist/mdruntime/opened.d.ts +21 -0
  61. package/dist/mdruntime/outcome.d.ts +94 -0
  62. package/dist/mdruntime/overlay.d.ts +29 -0
  63. package/dist/mdruntime/preparation.d.ts +19 -0
  64. package/dist/mdruntime/presence.d.ts +51 -0
  65. package/dist/mdruntime/query.d.ts +87 -0
  66. package/dist/mdruntime/reach.d.ts +55 -0
  67. package/dist/mdruntime/readiness.d.ts +48 -0
  68. package/dist/mdruntime/reads.d.ts +38 -0
  69. package/dist/mdruntime/recovery.d.ts +27 -0
  70. package/dist/mdruntime/refresh.d.ts +26 -0
  71. package/dist/mdruntime/replica.d.ts +62 -0
  72. package/dist/mdruntime/retried.d.ts +29 -0
  73. package/dist/mdruntime/room-draft.d.ts +172 -0
  74. package/dist/mdruntime/room-drafts.d.ts +23 -0
  75. package/dist/mdruntime/runtime.d.ts +33 -0
  76. package/dist/mdruntime/save.d.ts +58 -0
  77. package/dist/mdruntime/saves.d.ts +31 -0
  78. package/dist/mdruntime/search.d.ts +21 -0
  79. package/dist/mdruntime/seed.d.ts +24 -0
  80. package/dist/mdruntime/socket/admission.d.ts +6 -0
  81. package/dist/mdruntime/socket/answers.d.ts +5 -0
  82. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  83. package/dist/mdruntime/socket/session.d.ts +37 -0
  84. package/dist/mdruntime/socket.d.ts +66 -0
  85. package/dist/mdruntime/source.d.ts +53 -0
  86. package/dist/mdruntime/status.d.ts +25 -0
  87. package/dist/mdruntime/store/installs.d.ts +29 -0
  88. package/dist/mdruntime/store/readiness.d.ts +9 -0
  89. package/dist/mdruntime/store/records.d.ts +214 -0
  90. package/dist/mdruntime/store/room-held.d.ts +7 -0
  91. package/dist/mdruntime/store/space.d.ts +10 -0
  92. package/dist/mdruntime/store/watchers.d.ts +16 -0
  93. package/dist/mdruntime/store/writes.d.ts +23 -0
  94. package/dist/mdruntime/store.d.ts +121 -0
  95. package/dist/mdruntime/stored.d.ts +156 -0
  96. package/dist/mdruntime/surface.d.ts +88 -0
  97. package/dist/mdruntime/tables.d.ts +414 -0
  98. package/dist/mdruntime/tallies.d.ts +17 -0
  99. package/dist/mdruntime/transfer.d.ts +4 -0
  100. package/dist/mdruntime/wire.d.ts +295 -0
  101. package/dist/session-content/bounds.d.ts +7 -0
  102. package/dist/session-content/check.d.ts +18 -0
  103. package/dist/session-content/index.d.ts +7 -0
  104. package/dist/session-content/parts.d.ts +103 -0
  105. package/dist/session-content/state.d.ts +61 -0
  106. package/dist/session-content/turn.d.ts +328 -0
  107. package/dist/test-host.d.ts +8 -2
  108. package/dist/test-host.js +48 -12
  109. package/docs/families.md +70 -20
  110. package/package.json +8 -6
@@ -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
- import type { MdRuntimeClient } from '@agentshouse/mdruntime/client';
2
- import type { HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
1
+ import type { MdRuntimeClient } from './mdruntime/client.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[];
package/dist/test-host.js CHANGED
@@ -1,5 +1,5 @@
1
1
  const HOST_ORIGIN = 'https://house.invalid';
2
- const ADDRESS_MAX_CHARS = 1000;
2
+ const ADDRESS_MAX_CHARS = 64 * 1024;
3
3
  function sameOriginPath(value) {
4
4
  if (typeof value !== 'string')
5
5
  return null;
@@ -29,12 +29,28 @@ function navigationRefused(address) {
29
29
  address,
30
30
  });
31
31
  }
32
+ function followHeld(listeners, listener, held) {
33
+ let following = true;
34
+ queueMicrotask(() => {
35
+ if (!following)
36
+ return;
37
+ listeners.add(listener);
38
+ const value = held();
39
+ if (value !== null)
40
+ listener(value);
41
+ });
42
+ return () => {
43
+ following = false;
44
+ listeners.delete(listener);
45
+ };
46
+ }
32
47
  export function createHouseBridgeTestHost(options = {}) {
33
48
  const navigations = [];
34
49
  const ceremonies = [];
35
50
  const consents = [];
36
51
  const tabs = [];
37
52
  const externalCalls = [];
53
+ const chats = [];
38
54
  const addressListeners = new Set();
39
55
  const statusListeners = new Set();
40
56
  const messageListeners = new Set();
@@ -63,7 +79,17 @@ export function createHouseBridgeTestHost(options = {}) {
63
79
  });
64
80
  }
65
81
  function navigate(mode, asked) {
66
- const target = sameOriginPath(asked);
82
+ let path = asked;
83
+ if (/^https?:\/\//i.test(asked)) {
84
+ try {
85
+ const target = new URL(asked);
86
+ path = target.origin === HOST_ORIGIN ? target.pathname + target.search + target.hash : '';
87
+ }
88
+ catch {
89
+ path = '';
90
+ }
91
+ }
92
+ const target = sameOriginPath(path);
67
93
  if (target === null)
68
94
  return Promise.reject(navigationRefused(asked));
69
95
  navigations.push({ mode, address: target });
@@ -73,13 +99,24 @@ export function createHouseBridgeTestHost(options = {}) {
73
99
  });
74
100
  }
75
101
  const bridge = {
76
- runtime,
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
+ },
77
117
  address: () => shown,
78
118
  onAddress(listener) {
79
- addressListeners.add(listener);
80
- return () => {
81
- addressListeners.delete(listener);
82
- };
119
+ return followHeld(addressListeners, listener, () => shown);
83
120
  },
84
121
  push: (asked) => navigate('push', asked),
85
122
  replace: (asked) => navigate('replace', asked),
@@ -92,7 +129,7 @@ export function createHouseBridgeTestHost(options = {}) {
92
129
  },
93
130
  install: () => Promise.resolve('manual'),
94
131
  notifications: () => Promise.resolve('unavailable'),
95
- setBadge: () => Promise.resolve(),
132
+ telegram: () => Promise.resolve({ state: 'unavailable', name: null, username: null }),
96
133
  setTab(tab) {
97
134
  tabs.push(tab);
98
135
  },
@@ -106,10 +143,7 @@ export function createHouseBridgeTestHost(options = {}) {
106
143
  readSiteScreenshot: (site) => Promise.resolve(options.siteScreenshots?.[site] ?? null),
107
144
  status: () => seen,
108
145
  onStatus(listener) {
109
- statusListeners.add(listener);
110
- return () => {
111
- statusListeners.delete(listener);
112
- };
146
+ return followHeld(statusListeners, listener, () => seen);
113
147
  },
114
148
  messages(listener) {
115
149
  messageListeners.add(listener);
@@ -125,6 +159,7 @@ export function createHouseBridgeTestHost(options = {}) {
125
159
  consents.push(choice);
126
160
  publish({ ...published, analytics: { measures: true, choice } });
127
161
  },
162
+ cooperate: () => () => { },
128
163
  };
129
164
  Object.defineProperty(globalThis, 'houseBridge', { value: bridge, configurable: true });
130
165
  if (published !== null)
@@ -132,6 +167,7 @@ export function createHouseBridgeTestHost(options = {}) {
132
167
  arrive(current);
133
168
  return {
134
169
  navigations,
170
+ chats,
135
171
  ceremonies,
136
172
  consents,
137
173
  tabs,
package/docs/families.md CHANGED
@@ -12,7 +12,9 @@
12
12
  purpose-bound authenticated pages. The shell navigates only to a same-origin
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
- reading and composes none.
15
+ reading and composes one only for `/bind/<app_ref>`, where the User binds
16
+ its Rooms, with `?slot=<name>` to open at one slot, and `/sign-out`, which
17
+ signs the User out and opens sign-in.
16
18
  - **Installation** - `install()` offers the page as a Home-screen app. Where the
17
19
  browser has an install prompt ready the shell shows it and the call resolves
18
20
  `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
@@ -27,11 +29,22 @@
27
29
  notifications, or `'unavailable'` where it has no push, as on an iPhone or
28
30
  iPad outside a Home-screen app. `notifications(true)` asks the browser's
29
31
  permission and subscribes, `notifications(false)` unsubscribes, and each
30
- answers the state it leaves; a failure of the browser's push service, and
31
- of `setBadge`, rejects the same way. Call `notifications(true)` from a
32
- click. `setBadge(unread)` takes the identifiers of the Human Notifications
33
- unread in this storage and sets the icon's badge to their number, or clears
34
- 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.
35
48
  - **Status** - the App reference the runtime client is attached under,
36
49
  `preferences`: the `roomRef` and Path of the App's own preferences document,
37
50
  or `null` until the runtime holds that Room, sync
@@ -39,13 +52,25 @@
39
52
  whether the page measures and the visitor's stored analytics choice, and
40
53
  `serviceMode`: `open`, `write-halted` while House refuses writes, so the
41
54
  App can stop retrying them, or `null` while the runtime holds no House
42
- connection. Every status field is camelCase.
55
+ connection. Every status field is camelCase. `onStatus(listener)` and
56
+ `onAddress(listener)` hand a listener the status and the address the bridge
57
+ already holds, then each change.
43
58
  The App reports the visitor's choice with `analyticsConsent('accept')` or
44
59
  `analyticsConsent('decline')`; the shell hands it to House's analytics loader, and
45
60
  the choice never reaches House.
46
- - **Site image read** - given a Published Room and an original attachment
47
- reference, it answers the web copy's path and metadata, or `null` when no
48
- 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`.
49
74
  - **App release code** - `sourceTop(app, release)` answers the top level of
50
75
  the latest successful release of an App the User may use: its folders, its
51
76
  files with their sizes and its root README's text, or `null` for none;
@@ -53,24 +78,24 @@
53
78
  path, its size and its `text`, or its bytes as `base64`. The browser keeps
54
79
  each answer per App and release: a read naming a release it holds answers
55
80
  without asking House, and keeping a newer release drops the earlier one. A
56
- 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
57
82
  App with no release; a read House does not answer, or one that outlived
58
83
  the browser's signed-in User, is `null`.
59
- - **External calls** - `callExternal({ url, method, headers, body, slot })`
84
+ - **External calls** - `callExternal({ url, method, headers, body, room_ref })`
60
85
  has House's server send an HTTPS request to one of the release's declared
61
86
  external origins and resolves with the service's `status`, `headers` and its
62
87
  body as `body` text or `body_base64`, or a refusal as House's
63
88
  `{ error: { code, retryable } }`, or `null` when House does not answer. House fills in the
64
- App and its running release; naming an account slot places the key of the
65
- account the User connected to it, which the App never sees, and naming none
66
- sends no key. A Site's call names no slot, and the House panel names an
67
- `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.
68
93
  - **App messages** - `messages(listener)` hands the listener each message
69
94
  another holder of this App sends to this User's running copies, as `from`,
70
95
  the sender's User id, and `body`, the JSON value they sent, until the
71
96
  function it returns is called. App code sends one through the Runtime's
72
- `call('message.send', { to, body })` with the recipient's User id and
73
- 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
74
99
  to copies running now, storing nothing. The panel sends none.
75
100
  - **App screenshot read** - given an App reference, `readScreenshot(app)`
76
101
  answers the image this browser captured of that App's screen the first time
@@ -82,6 +107,28 @@
82
107
  after its latest release, as a JPEG `Blob`, or `null` when House holds none
83
108
  or does not answer. A Site's own renderer reads none.
84
109
 
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.
131
+
85
132
  ## The test host
86
133
 
87
134
  `createHouseBridgeTestHost(options)` plays House in one page: it installs a
@@ -102,6 +149,9 @@ records in `tabs` each `setTab`, answers a release code read from the
102
149
  by App reference and `readSiteScreenshot` from the `siteScreenshots` it was
103
150
  given by Site identifier, answers every `install()` `'manual'`, as a browser
104
151
  with no install prompt does, answers every `notifications()` `'unavailable'`,
105
- 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
106
155
  message `message({ from, body })` plays, and hands `bridge.runtime` the MD
107
- Runtime client `attachRuntime(client)` gives it.
156
+ Runtime client `attachRuntime(client)` gives it. It takes a `cooperate` and
157
+ never calls `placed()`.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agentshouse/app-bridge",
3
- "version": "0.1.0-ccf413b4e709d",
4
- "description": "Types of the agents.house App bridge House hands every App: navigation, the tab title and icon, ceremonies, installation, notifications and the icon badge, status, Site image reads, App release code, App and Site screenshot reads, and App messages, with an accessor and an in-page test host.",
3
+ "version": "0.1.0-ccf6bf7d473e2",
4
+ "description": "Types of the agents.house App bridge House hands every App: navigation, the tab title and icon, ceremonies, installation, notifications, status, App release code, App and Site screenshot reads, App messages and the Chat, with an accessor and an in-page test host.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "sideEffects": false,
@@ -18,13 +18,15 @@
18
18
  "default": "./dist/test-host.js"
19
19
  }
20
20
  },
21
- "dependencies": {
22
- "@agentshouse/mdruntime": "0.1.0-c2aaa9c0e3ca4"
23
- },
24
21
  "files": [
25
22
  "dist",
26
23
  "docs",
27
24
  "README.md",
28
25
  "LICENSE"
29
- ]
26
+ ],
27
+ "repository": {
28
+ "type": "git",
29
+ "url": "git+https://github.com/agentshouse/core.git",
30
+ "directory": "client"
31
+ }
30
32
  }