@agentshouse/app-bridge 0.1.0-c43d9cbcf6c8d → 0.1.0-c44cf2cfcc09a

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 (103) hide show
  1. package/README.md +6 -6
  2. package/dist/index.d.ts +143 -399
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/definition.d.ts +20 -10
  5. package/dist/mdmodel/document.d.ts +14 -7
  6. package/dist/mdmodel/event.d.ts +76 -0
  7. package/dist/mdmodel/facts.d.ts +14 -0
  8. package/dist/mdmodel/fields.d.ts +1 -1
  9. package/dist/mdmodel/index.d.ts +27 -13
  10. package/dist/mdmodel/kinds.d.ts +17 -0
  11. package/dist/mdmodel/markdown.d.ts +74 -0
  12. package/dist/mdmodel/paths.d.ts +10 -1
  13. package/dist/mdmodel/pattern.d.ts +9 -0
  14. package/dist/mdmodel/query/language.d.ts +253 -0
  15. package/dist/mdmodel/query/match.d.ts +13 -0
  16. package/dist/mdmodel/query/rows.d.ts +31 -0
  17. package/dist/mdmodel/query/sql.d.ts +38 -0
  18. package/dist/mdmodel/reserved.d.ts +5 -0
  19. package/dist/mdmodel/types.d.ts +21 -7
  20. package/dist/mdmodel/validate.d.ts +10 -6
  21. package/dist/mdruntime/actions.d.ts +25 -0
  22. package/dist/mdruntime/adapter.d.ts +71 -69
  23. package/dist/mdruntime/attached-model.d.ts +7 -0
  24. package/dist/mdruntime/bootstrap.d.ts +43 -0
  25. package/dist/mdruntime/cell.d.ts +5 -0
  26. package/dist/mdruntime/chain.d.ts +2 -1
  27. package/dist/mdruntime/change-set.d.ts +4 -0
  28. package/dist/mdruntime/change.d.ts +1 -0
  29. package/dist/mdruntime/client.d.ts +27 -19
  30. package/dist/mdruntime/collection.d.ts +23 -4
  31. package/dist/mdruntime/compile.d.ts +8 -6
  32. package/dist/mdruntime/conversation-live.d.ts +139 -0
  33. package/dist/mdruntime/conversation-row.d.ts +32 -0
  34. package/dist/mdruntime/conversation.d.ts +59 -45
  35. package/dist/mdruntime/declaration.d.ts +9 -0
  36. package/dist/mdruntime/durability.d.ts +18 -0
  37. package/dist/mdruntime/failure.d.ts +3 -0
  38. package/dist/mdruntime/figures.d.ts +48 -0
  39. package/dist/mdruntime/holdings.d.ts +28 -0
  40. package/dist/mdruntime/identity.d.ts +0 -1
  41. package/dist/mdruntime/listing.d.ts +47 -0
  42. package/dist/mdruntime/live.d.ts +22 -0
  43. package/dist/mdruntime/log.d.ts +5 -0
  44. package/dist/mdruntime/media.d.ts +1 -1
  45. package/dist/mdruntime/messages.d.ts +24 -3
  46. package/dist/mdruntime/model.d.ts +2 -10
  47. package/dist/mdruntime/observation.d.ts +2 -2
  48. package/dist/mdruntime/opened.d.ts +1 -1
  49. package/dist/mdruntime/outcome.d.ts +7 -1
  50. package/dist/mdruntime/overlay.d.ts +6 -1
  51. package/dist/mdruntime/preparation.d.ts +19 -0
  52. package/dist/mdruntime/presence.d.ts +51 -0
  53. package/dist/mdruntime/query.d.ts +13 -209
  54. package/dist/mdruntime/reach.d.ts +14 -12
  55. package/dist/mdruntime/readiness.d.ts +0 -3
  56. package/dist/mdruntime/reads.d.ts +38 -0
  57. package/dist/mdruntime/recovery.d.ts +3 -1
  58. package/dist/mdruntime/refresh.d.ts +26 -0
  59. package/dist/mdruntime/replica.d.ts +11 -16
  60. package/dist/mdruntime/retried.d.ts +29 -0
  61. package/dist/mdruntime/room-draft.d.ts +7 -8
  62. package/dist/mdruntime/room-drafts.d.ts +23 -0
  63. package/dist/mdruntime/runtime.d.ts +35 -0
  64. package/dist/mdruntime/save.d.ts +42 -86
  65. package/dist/mdruntime/saves.d.ts +31 -0
  66. package/dist/mdruntime/search.d.ts +12 -63
  67. package/dist/mdruntime/seed.d.ts +11 -2
  68. package/dist/mdruntime/socket/admission.d.ts +6 -0
  69. package/dist/mdruntime/socket/answers.d.ts +5 -0
  70. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  71. package/dist/mdruntime/socket/session.d.ts +37 -0
  72. package/dist/mdruntime/socket.d.ts +67 -0
  73. package/dist/mdruntime/source.d.ts +53 -0
  74. package/dist/mdruntime/status.d.ts +0 -2
  75. package/dist/mdruntime/store/installs.d.ts +29 -0
  76. package/dist/mdruntime/store/readiness.d.ts +9 -0
  77. package/dist/mdruntime/store/records.d.ts +212 -0
  78. package/dist/mdruntime/store/room-held.d.ts +7 -0
  79. package/dist/mdruntime/store/space.d.ts +10 -0
  80. package/dist/mdruntime/store/watchers.d.ts +16 -0
  81. package/dist/mdruntime/store/writes.d.ts +23 -0
  82. package/dist/mdruntime/store.d.ts +112 -145
  83. package/dist/mdruntime/stored.d.ts +59 -33
  84. package/dist/mdruntime/surface.d.ts +88 -0
  85. package/dist/mdruntime/tables.d.ts +116 -29
  86. package/dist/mdruntime/tallies.d.ts +17 -0
  87. package/dist/mdruntime/transfer.d.ts +4 -0
  88. package/dist/mdruntime/wire.d.ts +69 -5
  89. package/dist/session-content/bounds.d.ts +7 -0
  90. package/dist/session-content/check.d.ts +18 -0
  91. package/dist/session-content/index.d.ts +7 -0
  92. package/dist/session-content/parts.d.ts +102 -0
  93. package/dist/session-content/state.d.ts +61 -0
  94. package/dist/session-content/turn.d.ts +328 -0
  95. package/dist/test-host.js +1 -1
  96. package/docs/families.md +24 -17
  97. package/package.json +2 -2
  98. package/dist/mdmodel/blocks.d.ts +0 -10
  99. package/dist/mdmodel/condition.d.ts +0 -179
  100. package/dist/mdmodel/links.d.ts +0 -28
  101. package/dist/mdmodel/profile.d.ts +0 -5
  102. package/dist/mdruntime/connection.d.ts +0 -152
  103. package/dist/mdruntime/fulltext.d.ts +0 -26
@@ -0,0 +1,18 @@
1
+ export type Check<T> = (value: unknown) => value is T;
2
+ export type Checked<C> = C extends Check<infer T> ? T : never;
3
+ type Shape = Readonly<Record<string, Check<unknown>>>;
4
+ export type Shaped<S extends Shape> = {
5
+ readonly [K in keyof S]: Checked<S[K]>;
6
+ };
7
+ export declare const text: Check<string>;
8
+ export declare const integer: Check<number>;
9
+ export declare const count: Check<number>;
10
+ export declare const figure: Check<number>;
11
+ export declare const instant: Check<string>;
12
+ export declare function oneOf<const V extends readonly string[]>(...values: V): Check<V[number]>;
13
+ export declare function where<T>(check: Check<T>, holds: (value: T) => boolean): Check<T>;
14
+ export declare function nullable<T>(check: Check<T>): Check<T | null>;
15
+ export declare function list<T>(check: Check<T>): Check<readonly T[]>;
16
+ export declare function exact<const S extends Shape>(shape: S): Check<Shaped<S>>;
17
+ export declare function anyOf<const C extends readonly Check<unknown>[]>(...checks: C): Check<Checked<C[number]>>;
18
+ export {};
@@ -0,0 +1,7 @@
1
+ export { DIFF_CHARACTERS, FIRST_PART_CHARACTERS, firstPart, keptDiff, lastLines, OUTPUT_CHARACTERS, OUTPUT_LINES, } from './bounds.js';
2
+ export { isOwn, isPart } from './parts.js';
3
+ export type { Call, FileChange, Part, Status } from './parts.js';
4
+ export { isState, standingState } from './state.js';
5
+ export type { SessionState, Tokens } from './state.js';
6
+ export { applied, isOperation, isTurn } from './turn.js';
7
+ export type { Operation, Turn } from './turn.js';
@@ -0,0 +1,102 @@
1
+ import { type Check, type Checked } from './check.js';
2
+ declare const STATUS: Check<"done" | "failed" | "running" | "stopped">;
3
+ export type Status = Checked<typeof STATUS>;
4
+ declare const FILE_CHANGE: Check<import("./check.js").Shaped<{
5
+ readonly path: Check<string>;
6
+ readonly added: Check<number>;
7
+ readonly removed: Check<number>;
8
+ readonly diff: Check<string | null>;
9
+ }>>;
10
+ export type FileChange = Checked<typeof FILE_CHANGE>;
11
+ export declare const BACKGROUND_KINDS: readonly ['shell', 'task', 'monitor', 'schedule'];
12
+ declare const PART: Check<import("./check.js").Shaped<{
13
+ readonly type: Check<"call">;
14
+ readonly parent: Check<number | null>;
15
+ readonly line: Check<string>;
16
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
17
+ readonly duration: Check<number | null>;
18
+ readonly kind: Check<"command">;
19
+ readonly exit: Check<number | null>;
20
+ readonly output: Check<string>;
21
+ }> | import("./check.js").Shaped<{
22
+ readonly type: Check<"call">;
23
+ readonly parent: Check<number | null>;
24
+ readonly line: Check<string>;
25
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
26
+ readonly duration: Check<number | null>;
27
+ readonly kind: Check<"edit">;
28
+ readonly files: Check<readonly import("./check.js").Shaped<{
29
+ readonly path: Check<string>;
30
+ readonly added: Check<number>;
31
+ readonly removed: Check<number>;
32
+ readonly diff: Check<string | null>;
33
+ }>[]>;
34
+ }> | import("./check.js").Shaped<{
35
+ readonly type: Check<"call">;
36
+ readonly parent: Check<number | null>;
37
+ readonly line: Check<string>;
38
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
39
+ readonly duration: Check<number | null>;
40
+ readonly kind: Check<"read" | "search">;
41
+ readonly returned: Check<number | null>;
42
+ }> | import("./check.js").Shaped<{
43
+ readonly type: Check<"call">;
44
+ readonly parent: Check<number | null>;
45
+ readonly line: Check<string>;
46
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
47
+ readonly duration: Check<number | null>;
48
+ readonly kind: Check<"fetch" | "other" | "tool">;
49
+ readonly output: Check<string>;
50
+ }> | import("./check.js").Shaped<{
51
+ readonly type: Check<"subagent">;
52
+ readonly parent: Check<number | null>;
53
+ readonly kind: Check<"agent" | "fork" | "workflow">;
54
+ readonly name: Check<string | null>;
55
+ readonly task: Check<string>;
56
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
57
+ readonly step: Check<string | null>;
58
+ readonly report: Check<string | null>;
59
+ readonly tokens: Check<number | null>;
60
+ readonly calls: Check<number | null>;
61
+ readonly duration: Check<number | null>;
62
+ }> | import("./check.js").Shaped<{
63
+ readonly type: Check<"reasoning" | "text">;
64
+ readonly parent: Check<number | null>;
65
+ readonly text: Check<string>;
66
+ }> | import("./check.js").Shaped<{
67
+ readonly type: Check<"message">;
68
+ readonly parent: Check<number | null>;
69
+ readonly command: Check<string>;
70
+ readonly target: Check<string | null>;
71
+ }> | import("./check.js").Shaped<{
72
+ readonly type: Check<"image">;
73
+ readonly parent: Check<number | null>;
74
+ readonly file: Check<string>;
75
+ readonly name: Check<string>;
76
+ readonly media_type: Check<string>;
77
+ }> | import("./check.js").Shaped<{
78
+ readonly type: Check<"plan">;
79
+ readonly parent: Check<number | null>;
80
+ readonly entries: Check<readonly import("./check.js").Shaped<{
81
+ readonly content: Check<string>;
82
+ readonly status: Check<"done" | "pending" | "running">;
83
+ }>[]>;
84
+ }> | import("./check.js").Shaped<{
85
+ readonly type: Check<"notice">;
86
+ readonly parent: Check<number | null>;
87
+ readonly kind: Check<"compaction" | "error" | "info" | "mode" | "model" | "retry" | "warning">;
88
+ readonly text: Check<string>;
89
+ }> | import("./check.js").Shaped<{
90
+ readonly type: Check<"background">;
91
+ readonly parent: Check<number | null>;
92
+ readonly kind: Check<"monitor" | "schedule" | "shell" | "task">;
93
+ readonly label: Check<string>;
94
+ readonly status: Check<"done" | "failed" | "running" | "stopped">;
95
+ }>>;
96
+ export type Part = Checked<typeof PART>;
97
+ export type Call = Extract<Part, {
98
+ readonly type: 'call';
99
+ }>;
100
+ export declare const isPart: Check<Part>;
101
+ export declare function isOwn(part: Part): boolean;
102
+ export {};
@@ -0,0 +1,61 @@
1
+ import { type Check, type Checked } from './check.js';
2
+ export declare const TOKENS: Check<import("./check.js").Shaped<{
3
+ readonly input: Check<number>;
4
+ readonly output: Check<number>;
5
+ readonly cache_read: Check<number>;
6
+ readonly cache_write: Check<number>;
7
+ }>>;
8
+ export type Tokens = Checked<typeof TOKENS>;
9
+ declare const STATE: Check<import("./check.js").Shaped<{
10
+ readonly title: Check<string | null>;
11
+ readonly context: Check<import("./check.js").Shaped<{
12
+ readonly used: Check<number>;
13
+ readonly window: Check<number>;
14
+ readonly breakdown: Check<readonly import("./check.js").Shaped<{
15
+ readonly name: Check<string>;
16
+ readonly tokens: Check<number>;
17
+ }>[]>;
18
+ }> | null>;
19
+ readonly limits: Check<readonly import("./check.js").Shaped<{
20
+ readonly name: Check<string | null>;
21
+ readonly minutes: Check<number>;
22
+ readonly percent: Check<number>;
23
+ readonly resets: Check<string | null>;
24
+ }>[]>;
25
+ readonly cost: Check<import("./check.js").Shaped<{
26
+ readonly amount: Check<number>;
27
+ readonly currency: Check<string>;
28
+ }> | null>;
29
+ readonly tokens: Check<import("./check.js").Shaped<{
30
+ readonly input: Check<number>;
31
+ readonly output: Check<number>;
32
+ readonly cache_read: Check<number>;
33
+ readonly cache_write: Check<number>;
34
+ }> | null>;
35
+ readonly duration: Check<number | null>;
36
+ readonly files: Check<readonly import("./check.js").Shaped<{
37
+ readonly path: Check<string>;
38
+ readonly added: Check<number>;
39
+ readonly removed: Check<number>;
40
+ }>[]>;
41
+ readonly branch: Check<string | null>;
42
+ readonly worktree: Check<string | null>;
43
+ readonly pull: Check<import("./check.js").Shaped<{
44
+ readonly number: Check<number>;
45
+ readonly url: Check<string>;
46
+ }> | null>;
47
+ readonly model: Check<string | null>;
48
+ readonly effort: Check<string | null>;
49
+ readonly mode: Check<string | null>;
50
+ readonly suggestion: Check<string | null>;
51
+ readonly running: Check<readonly import("./check.js").Shaped<{
52
+ readonly kind: Check<"monitor" | "schedule" | "shell" | "subagent" | "task">;
53
+ readonly label: Check<string>;
54
+ readonly progress: Check<string | null>;
55
+ readonly next: Check<string | null>;
56
+ }>[]>;
57
+ }>>;
58
+ export type SessionState = Checked<typeof STATE>;
59
+ export declare const isState: Check<SessionState>;
60
+ export declare function standingState(state: SessionState, saved: string, ended: string | null): SessionState;
61
+ export {};
@@ -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<string>;
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<string>;
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<string>;
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 {};
package/dist/test-host.js CHANGED
@@ -129,7 +129,7 @@ export function createHouseBridgeTestHost(options = {}) {
129
129
  },
130
130
  install: () => Promise.resolve('manual'),
131
131
  notifications: () => Promise.resolve('unavailable'),
132
- setBadge: () => Promise.resolve(),
132
+ telegram: () => Promise.resolve({ state: 'unavailable', name: null, username: null }),
133
133
  setTab(tab) {
134
134
  tabs.push(tab);
135
135
  },
package/docs/families.md CHANGED
@@ -13,7 +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, 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.
17
18
  - **Installation** - `install()` offers the page as a Home-screen app. Where the
18
19
  browser has an install prompt ready the shell shows it and the call resolves
19
20
  `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
@@ -28,11 +29,22 @@
28
29
  notifications, or `'unavailable'` where it has no push, as on an iPhone or
29
30
  iPad outside a Home-screen app. `notifications(true)` asks the browser's
30
31
  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.
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.
36
48
  - **Status** - the App reference the runtime client is attached under,
37
49
  `preferences`: the `roomRef` and Path of the App's own preferences document,
38
50
  or `null` until the runtime holds that Room, sync
@@ -59,9 +71,6 @@
59
71
  House is answered the outcome `transport-uncertainty`, and every other call,
60
72
  a Save or a draft write among them, fails with the retryable code
61
73
  `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
74
  - **App release code** - `sourceTop(app, release)` answers the top level of
66
75
  the latest successful release of an App the User may use: its folders, its
67
76
  files with their sizes and its root README's text, or `null` for none;
@@ -69,7 +78,7 @@
69
78
  path, its size and its `text`, or its bytes as `base64`. The browser keeps
70
79
  each answer per App and release: a read naming a release it holds answers
71
80
  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
81
+ refusal is House's `{ error: { code, retryable } }`, `not_found` for an
73
82
  App with no release; a read House does not answer, or one that outlived
74
83
  the browser's signed-in User, is `null`.
75
84
  - **External calls** - `callExternal({ url, method, headers, body, room_ref })`
@@ -103,12 +112,10 @@
103
112
  `runtime` client, and resolves to a handle: `update(options)` replaces its
104
113
  options and `unmount()` removes it. House serves the Chat with the page and
105
114
  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
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
112
119
  or an ancestor set its look. It shows conversations only to a release that
113
120
  declares them. A Site and the House panel have none: their call rejects with
114
121
  an error named and coded `NotSupportedError`, with `retryable` false.
@@ -142,7 +149,7 @@ records in `tabs` each `setTab`, answers a release code read from the
142
149
  by App reference and `readSiteScreenshot` from the `siteScreenshots` it was
143
150
  given by Site identifier, answers every `install()` `'manual'`, as a browser
144
151
  with no install prompt does, answers every `notifications()` `'unavailable'`,
145
- as a browser without push does, settles every `setBadge`, records in `chats`
152
+ as a browser without push does, records in `chats`
146
153
  each Chat `chat.mount` places, with its `element`, the `options` it was last
147
154
  given and whether it is still `mounted`, drawing nothing, delivers each App
148
155
  message `message({ from, body })` plays, and hands `bridge.runtime` the MD
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agentshouse/app-bridge",
3
- "version": "0.1.0-c43d9cbcf6c8d",
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-c44cf2cfcc09a",
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[];