@agentshouse/app-bridge 0.1.0-cd3bc6240e9ba → 0.1.0-cd44fa24fb809

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 (116) hide show
  1. package/README.md +6 -6
  2. package/dist/index.d.ts +186 -376
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/built-in.d.ts +3 -0
  5. package/dist/mdmodel/definition.d.ts +20 -11
  6. package/dist/mdmodel/document.d.ts +14 -8
  7. package/dist/mdmodel/event.d.ts +76 -0
  8. package/dist/mdmodel/facts.d.ts +14 -0
  9. package/dist/mdmodel/fields.d.ts +1 -1
  10. package/dist/mdmodel/house-model.d.ts +869 -0
  11. package/dist/mdmodel/house-references/crockford.d.ts +3 -0
  12. package/dist/mdmodel/house-references/patterns.d.ts +8 -0
  13. package/dist/mdmodel/index.d.ts +40 -15
  14. package/dist/mdmodel/kinds.d.ts +17 -0
  15. package/dist/mdmodel/markdown.d.ts +74 -0
  16. package/dist/mdmodel/media-type.d.ts +71 -0
  17. package/dist/mdmodel/moment.d.ts +6 -0
  18. package/dist/mdmodel/not-ready.d.ts +1 -0
  19. package/dist/mdmodel/paths.d.ts +15 -1
  20. package/dist/mdmodel/pattern.d.ts +9 -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 +2 -2
  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 +22 -17
  29. package/dist/mdmodel/validate.d.ts +12 -6
  30. package/dist/mdmodel/yaml.d.ts +4 -4
  31. package/dist/mdruntime/actions.d.ts +25 -0
  32. package/dist/mdruntime/adapter.d.ts +135 -81
  33. package/dist/mdruntime/attached-model.d.ts +6 -0
  34. package/dist/mdruntime/authored.d.ts +87 -0
  35. package/dist/mdruntime/bootstrap.d.ts +43 -0
  36. package/dist/mdruntime/cell.d.ts +5 -0
  37. package/dist/mdruntime/chain.d.ts +2 -1
  38. package/dist/mdruntime/change-set.d.ts +4 -0
  39. package/dist/mdruntime/change.d.ts +5 -0
  40. package/dist/mdruntime/client.d.ts +33 -22
  41. package/dist/mdruntime/collection.d.ts +26 -4
  42. package/dist/mdruntime/compile.d.ts +8 -6
  43. package/dist/mdruntime/conversation-live.d.ts +149 -0
  44. package/dist/mdruntime/conversation-row.d.ts +39 -0
  45. package/dist/mdruntime/conversation.d.ts +67 -46
  46. package/dist/mdruntime/declaration.d.ts +9 -0
  47. package/dist/mdruntime/durability.d.ts +20 -0
  48. package/dist/mdruntime/failure.d.ts +3 -0
  49. package/dist/mdruntime/figures.d.ts +48 -0
  50. package/dist/mdruntime/holdings.d.ts +28 -0
  51. package/dist/mdruntime/identity.d.ts +0 -1
  52. package/dist/mdruntime/install.d.ts +59 -0
  53. package/dist/mdruntime/listing.d.ts +51 -0
  54. package/dist/mdruntime/live.d.ts +24 -0
  55. package/dist/mdruntime/media.d.ts +19 -2
  56. package/dist/mdruntime/messages.d.ts +35 -5
  57. package/dist/mdruntime/model.d.ts +2 -10
  58. package/dist/mdruntime/observation.d.ts +28 -13
  59. package/dist/mdruntime/opened.d.ts +1 -1
  60. package/dist/mdruntime/outcome.d.ts +17 -2
  61. package/dist/mdruntime/overlay.d.ts +7 -2
  62. package/dist/mdruntime/preparation.d.ts +40 -0
  63. package/dist/mdruntime/presence.d.ts +57 -0
  64. package/dist/mdruntime/query.d.ts +13 -209
  65. package/dist/mdruntime/reach.d.ts +15 -14
  66. package/dist/mdruntime/readiness.d.ts +9 -6
  67. package/dist/mdruntime/reads.d.ts +38 -0
  68. package/dist/mdruntime/recovery.d.ts +3 -1
  69. package/dist/mdruntime/refresh.d.ts +26 -0
  70. package/dist/mdruntime/replica.d.ts +11 -16
  71. package/dist/mdruntime/retried.d.ts +29 -0
  72. package/dist/mdruntime/room-draft.d.ts +34 -10
  73. package/dist/mdruntime/room-drafts.d.ts +23 -0
  74. package/dist/mdruntime/runtime.d.ts +33 -0
  75. package/dist/mdruntime/save.d.ts +42 -86
  76. package/dist/mdruntime/saves.d.ts +33 -0
  77. package/dist/mdruntime/search.d.ts +12 -63
  78. package/dist/mdruntime/seed.d.ts +11 -2
  79. package/dist/mdruntime/socket/admission.d.ts +6 -0
  80. package/dist/mdruntime/socket/answers.d.ts +5 -0
  81. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  82. package/dist/mdruntime/socket/session.d.ts +37 -0
  83. package/dist/mdruntime/socket.d.ts +66 -0
  84. package/dist/mdruntime/source.d.ts +58 -0
  85. package/dist/mdruntime/status.d.ts +0 -2
  86. package/dist/mdruntime/store/installs.d.ts +29 -0
  87. package/dist/mdruntime/store/readiness.d.ts +10 -0
  88. package/dist/mdruntime/store/records.d.ts +223 -0
  89. package/dist/mdruntime/store/room-held.d.ts +7 -0
  90. package/dist/mdruntime/store/rooms-shown.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 +115 -144
  95. package/dist/mdruntime/stored.d.ts +72 -35
  96. package/dist/mdruntime/surface.d.ts +91 -0
  97. package/dist/mdruntime/tables.d.ts +118 -67
  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 +74 -7
  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 -1
  108. package/dist/test-host.js +27 -1
  109. package/docs/families.md +52 -22
  110. package/package.json +2 -2
  111. package/dist/mdmodel/blocks.d.ts +0 -10
  112. package/dist/mdmodel/condition.d.ts +0 -179
  113. package/dist/mdmodel/links.d.ts +0 -28
  114. package/dist/mdmodel/profile.d.ts +0 -5
  115. package/dist/mdruntime/connection.d.ts +0 -152
  116. package/dist/mdruntime/fulltext.d.ts +0 -26
@@ -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,5 +1,5 @@
1
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';
2
+ import type { HouseAnalyticsChoice, HouseAppMessage, HouseChatButtonMount, HouseChatOptions, HouseChatTarget, 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;
@@ -9,9 +9,16 @@ export interface HouseBridgeChat {
9
9
  readonly options: HouseChatOptions;
10
10
  readonly mounted: boolean;
11
11
  }
12
+ export interface HouseBridgeChatButton {
13
+ readonly options: HouseChatButtonMount;
14
+ readonly shown: boolean;
15
+ readonly target: HouseChatTarget | null;
16
+ readonly mounted: boolean;
17
+ }
12
18
  export interface HouseBridgeTestHost {
13
19
  readonly navigations: readonly HouseBridgeNavigation[];
14
20
  readonly chats: readonly HouseBridgeChat[];
21
+ readonly chatButtons: readonly HouseBridgeChatButton[];
15
22
  readonly ceremonies: readonly string[];
16
23
  readonly consents: readonly HouseAnalyticsChoice[];
17
24
  readonly tabs: readonly HouseTab[];
package/dist/test-host.js CHANGED
@@ -51,6 +51,7 @@ export function createHouseBridgeTestHost(options = {}) {
51
51
  const tabs = [];
52
52
  const externalCalls = [];
53
53
  const chats = [];
54
+ const chatButtons = [];
54
55
  const addressListeners = new Set();
55
56
  const statusListeners = new Set();
56
57
  const messageListeners = new Set();
@@ -113,6 +114,30 @@ export function createHouseBridgeTestHost(options = {}) {
113
114
  },
114
115
  });
115
116
  },
117
+ mountButton(options = {}) {
118
+ const button = {
119
+ options,
120
+ shown: false,
121
+ target: null,
122
+ mounted: true,
123
+ };
124
+ chatButtons.push(button);
125
+ return Promise.resolve({
126
+ open(target) {
127
+ button.shown = true;
128
+ button.target = target ?? null;
129
+ },
130
+ hide() {
131
+ button.shown = false;
132
+ },
133
+ update(next) {
134
+ button.options = next;
135
+ },
136
+ unmount() {
137
+ button.mounted = false;
138
+ },
139
+ });
140
+ },
116
141
  },
117
142
  address: () => shown,
118
143
  onAddress(listener) {
@@ -129,7 +154,7 @@ export function createHouseBridgeTestHost(options = {}) {
129
154
  },
130
155
  install: () => Promise.resolve('manual'),
131
156
  notifications: () => Promise.resolve('unavailable'),
132
- setBadge: () => Promise.resolve(),
157
+ telegram: () => Promise.resolve({ state: 'unavailable', name: null, username: null }),
133
158
  setTab(tab) {
134
159
  tabs.push(tab);
135
160
  },
@@ -168,6 +193,7 @@ export function createHouseBridgeTestHost(options = {}) {
168
193
  return {
169
194
  navigations,
170
195
  chats,
196
+ chatButtons,
171
197
  ceremonies,
172
198
  consents,
173
199
  tabs,
package/docs/families.md CHANGED
@@ -13,7 +13,14 @@
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, with `?slot=<name>` to open at one 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. A decision House asks over the App, a
18
+ prepared act's approval at `/approve/<ref>` and a secret or a CLI's sign-in
19
+ at `/secret-input/<id>`, stays in the App: the shell draws House's page as
20
+ its own dialog over the App, which the App cannot reach, and `ceremony()`
21
+ resolves once it closes, with `said`, what the page said it ended with, or
22
+ `null` when it closed with nothing said, and `done`, whether the decision was
23
+ carried out.
17
24
  - **Installation** - `install()` offers the page as a Home-screen app. Where the
18
25
  browser has an install prompt ready the shell shows it and the call resolves
19
26
  `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
@@ -28,11 +35,22 @@
28
35
  notifications, or `'unavailable'` where it has no push, as on an iPhone or
29
36
  iPad outside a Home-screen app. `notifications(true)` asks the browser's
30
37
  permission and subscribes, `notifications(false)` unsubscribes, and each
31
- answers the state it leaves; a failure of the browser's push service, and
32
- of `setBadge`, rejects the same way. Call `notifications(true)` from a
33
- click. `setBadge(unread)` takes the identifiers of the Human Notifications
34
- unread in this storage and sets the icon's badge to their number, or clears
35
- it at none, where the browser shows one.
38
+ answers the state it leaves; a failure of the browser's push service
39
+ rejects the same way. Call `notifications(true)` from a click. House's
40
+ service worker counts the icon's badge itself, as pushes arrive and as
41
+ read marks reach this storage.
42
+ - **Telegram** - House's own panel alone, refused to an App or a Site the same
43
+ way. `telegram()` answers `{ state, name, username }`: `state` is
44
+ `'available'` where the page runs inside a House bot's Mini App that gave it
45
+ Telegram's launch data naming an account, with that account's `name` and its
46
+ `username` or `null`, and `'unavailable'` with both `null` elsewhere.
47
+ `telegram(true)` links the signed-in User to that account and answers
48
+ `'linked'` with it; where the User's sign-in is
49
+ not recent, the page goes to sign in again, and nothing links until a later
50
+ `telegram(true)`.
51
+ Telegram's refusal rejects with an error coded `linked_elsewhere`,
52
+ `rate_limited` or `refused`, and a failed request with the browser's own
53
+ error name.
36
54
  - **Status** - the App reference the runtime client is attached under,
37
55
  `preferences`: the `roomRef` and Path of the App's own preferences document,
38
56
  or `null` until the runtime holds that Room, sync
@@ -44,8 +62,8 @@
44
62
  `onAddress(listener)` hand a listener the status and the address the bridge
45
63
  already holds, then each change.
46
64
  The App reports the visitor's choice with `analyticsConsent('accept')` or
47
- `analyticsConsent('decline')`; the shell hands it to House's analytics loader, and
48
- the choice never reaches House.
65
+ `analyticsConsent('decline')`; a Site's shell that measures hands it to House's
66
+ analytics loader, every other shell drops it, and the choice never reaches House.
49
67
  - **Releases and builds** - an open App keeps the release it loaded: a newer
50
68
  release, or a newer House build, takes effect at the App's next load, offline
51
69
  too once the browser stored it. When one tab loads a newer House build, the
@@ -59,9 +77,6 @@
59
77
  House is answered the outcome `transport-uncertainty`, and every other call,
60
78
  a Save or a draft write among them, fails with the retryable code
61
79
  `transport-uncertainty`.
62
- - **Site image read** - given a Published Room and the Path of one of its
63
- binary entries, it answers the web copy's path and metadata, or `null` when no
64
- copy exists. The original bytes never cross this bridge at a Site.
65
80
  - **App release code** - `sourceTop(app, release)` answers the top level of
66
81
  the latest successful release of an App the User may use: its folders, its
67
82
  files with their sizes and its root README's text, or `null` for none;
@@ -69,7 +84,7 @@
69
84
  path, its size and its `text`, or its bytes as `base64`. The browser keeps
70
85
  each answer per App and release: a read naming a release it holds answers
71
86
  without asking House, and keeping a newer release drops the earlier one. A
72
- refusal is House's `{ error: { code, retryable } }`, `app_release_not_found` for an
87
+ refusal is House's `{ error: { code, retryable } }`, `not_found` for an
73
88
  App with no release; a read House does not answer, or one that outlived
74
89
  the browser's signed-in User, is `null`.
75
90
  - **External calls** - `callExternal({ url, method, headers, body, room_ref })`
@@ -103,14 +118,26 @@
103
118
  `runtime` client, and resolves to a handle: `update(options)` replaces its
104
119
  options and `unmount()` removes it. House serves the Chat with the page and
105
120
  keeps it current, so the App installs and bundles nothing for it. The
106
- options: `conversation` opens one, `null` for a new chat, `agent` is the
107
- Agent a new chat goes to, `showChats` adds its conversation list, `width` is
108
- `full`, the element, or `3/4`, `1/2` or `1/3` of the window docked at its
109
- right edge, `onOpen` hears each conversation it opens as
110
- `{ conversation, agent }`, and `onLink` takes a link without a scheme in
111
- place of the browser. CSS custom properties named `--chat-*` on the element
112
- or an ancestor set its look. It shows conversations only to a release that
113
- declares them. A Site and the House panel have none: their call rejects with
121
+ options: the Chat fills the element and lays itself out by its width, the
122
+ list of the User's chats or one chat, the list beside the chat, or the list,
123
+ the chat and its details, `conversation` opens one, `null` for a new chat with
124
+ `agent`, the Agent it goes to, or the list with neither, `onOpen` hears
125
+ each conversation it opens as `{ conversation, agent }` and both `null` on
126
+ the way back to the list, and `onLink` takes
127
+ a link without a scheme in place of the browser. CSS custom properties named `--chat-*` on the element
128
+ or an ancestor set its look, and no other rule of the page's stylesheets reaches it. It shows conversations only to a release that
129
+ declares them. `chat.mountButton(options)` places the Chat as the Chat button
130
+ instead, with no element: House's dot at the window's bottom-right corner, which
131
+ counts what asks the User or, while nothing does, the chats that replied since the User
132
+ opened them, breathes while a turn runs and opens and hides the Chat in a sheet the User
133
+ moves, resizes and fills the window with, over a page that never changes under it. It
134
+ resolves to a handle: `open(target)` shows the sheet, on `target.conversation` or a new
135
+ chat with `target.agent` when it names one, docked at full height when `target.docked` is
136
+ `true`, `hide()` hides it, keeping its chat, scroll and typed text, and `update(options)` and
137
+ `unmount()` work as above, with `onOpen` and `onLink`. `agent` among the mount's options
138
+ names the Agent the dot first opens the sheet on, a new chat with it in place of the chat the
139
+ sheet kept, and leaves the sheet hidden. The page's Presentation State
140
+ keeps the sheet's size, place, list and open chat. A Site and the House panel have none: both calls reject with
114
141
  an error named and coded `NotSupportedError`, with `retryable` false.
115
142
 
116
143
  - **First place** - `cooperate({ placed })` tells House when the page has
@@ -142,9 +169,12 @@ records in `tabs` each `setTab`, answers a release code read from the
142
169
  by App reference and `readSiteScreenshot` from the `siteScreenshots` it was
143
170
  given by Site identifier, answers every `install()` `'manual'`, as a browser
144
171
  with no install prompt does, answers every `notifications()` `'unavailable'`,
145
- as a browser without push does, settles every `setBadge`, records in `chats`
172
+ as a browser without push does, records in `chats`
146
173
  each Chat `chat.mount` places, with its `element`, the `options` it was last
147
- given and whether it is still `mounted`, drawing nothing, delivers each App
174
+ given and whether it is still `mounted`, and in `chatButtons` each Chat button
175
+ `chat.mountButton` places, with the `options` it was last given, whether its
176
+ sheet is `shown`, the `target` its last `open` named or `null`, and whether it is
177
+ still `mounted`, drawing nothing, delivers each App
148
178
  message `message({ from, body })` plays, and hands `bridge.runtime` the MD
149
179
  Runtime client `attachRuntime(client)` gives it. It takes a `cooperate` and
150
180
  never calls `placed()`.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agentshouse/app-bridge",
3
- "version": "0.1.0-cd3bc6240e9ba",
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, App messages and the Chat, with an accessor and an in-page test host.",
3
+ "version": "0.1.0-cd44fa24fb809",
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,
@@ -1,10 +0,0 @@
1
- import type { Extent } from './types.js';
2
- export type HeadingLine = {
3
- readonly level: number;
4
- readonly name: string;
5
- readonly start: number;
6
- readonly textEnd: number;
7
- readonly next: number;
8
- };
9
- export declare function headingLines(content: string, from: number, to: number): HeadingLine[];
10
- export declare function blockRanges(content: string, from: number, to: number): Extent[];