@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
@@ -12,9 +12,16 @@ export type ModelVerification = {
12
12
  readonly rule: string;
13
13
  readonly location?: string;
14
14
  };
15
+ export type TypedPath = {
16
+ readonly path: string;
17
+ readonly type: string;
18
+ readonly named: boolean;
19
+ readonly body: boolean;
20
+ };
15
21
  export type ValidationContext = {
16
22
  readonly binaryTargets: readonly string[];
17
23
  readonly anyRoom?: true;
24
+ readonly typedPaths?: readonly TypedPath[];
18
25
  };
19
26
  export type ProjectionContext = {
20
27
  readonly documentTargets: readonly string[];
@@ -30,19 +37,22 @@ export type Extent = {
30
37
  export type Span = Extent & {
31
38
  readonly text: string;
32
39
  };
33
- export type Frontmatter = {
40
+ export type Document = {
34
41
  readonly content: string;
35
42
  readonly type: string | undefined;
36
43
  readonly fields: Readonly<Record<string, unknown>>;
37
- };
38
- export type Document = Frontmatter & {
39
44
  readonly preamble: string;
40
45
  readonly sections: Readonly<Record<string, string>>;
46
+ readonly text: string;
47
+ readonly ranges: Readonly<Record<string, Extent>>;
48
+ readonly listEnd: number;
41
49
  };
50
+ export type DefinitionOf = (type: string | undefined) => Definition | undefined;
42
51
  export type Refusal = {
43
52
  readonly file: string;
44
53
  readonly rule: string;
45
54
  readonly location?: string;
55
+ readonly line?: number;
46
56
  readonly referrers?: readonly string[];
47
57
  };
48
58
  export type Reached = {
@@ -80,13 +90,6 @@ export type Division = {
80
90
  readonly ok: false;
81
91
  readonly refusal: Refusal;
82
92
  };
83
- export type FrontmatterResult = {
84
- readonly ok: true;
85
- readonly frontmatter: Frontmatter;
86
- } | {
87
- readonly ok: false;
88
- readonly refusal: Refusal;
89
- };
90
93
  export type ParseResult = {
91
94
  readonly ok: true;
92
95
  readonly document: Document;
@@ -116,12 +119,6 @@ export type RoomReference = {
116
119
  readonly value: string;
117
120
  readonly to: readonly string[];
118
121
  readonly crossRoom?: true;
119
- } | {
120
- readonly kind: 'item';
121
- readonly section: string;
122
- readonly href: string;
123
- readonly to: readonly string[];
124
- readonly crossRoom?: true;
125
122
  });
126
123
  export type Change = {
127
124
  readonly kind: 'field';
@@ -132,11 +129,15 @@ export type Change = {
132
129
  readonly kind: 'section';
133
130
  readonly name: string;
134
131
  readonly value: string;
135
- readonly prior: string;
132
+ readonly prior: string | undefined;
136
133
  } | {
137
134
  readonly kind: 'preamble';
138
135
  readonly value: string;
139
136
  readonly prior: string;
137
+ } | {
138
+ readonly kind: 'text';
139
+ readonly value: string;
140
+ readonly prior: string;
140
141
  } | {
141
142
  readonly kind: 'link';
142
143
  readonly href: string;
@@ -165,3 +166,7 @@ export type BodyResult = {
165
166
  readonly outcome: 'refuse';
166
167
  readonly refusal: Refusal;
167
168
  };
169
+ export type UnlinkedBody = {
170
+ readonly body: string;
171
+ readonly links: ReadonlyMap<string, string>;
172
+ };
@@ -1,14 +1,19 @@
1
1
  import { type Definition } from './definition.js';
2
- import type { DocumentCheck, Library, ModelVerification, Reached, RoomReference, Validation, ValidationContext, ValidationStep, VerifiedModel } from './types.js';
2
+ import { type KeyedLink } from './paths.js';
3
+ import type { DefinitionOf, Document, DocumentCheck, Library, ModelVerification, ParseResult, Reached, RoomReference, TypedPath, Validation, ValidationContext, ValidationStep, VerifiedModel } from './types.js';
4
+ export declare function definitionAt(model: VerifiedModel, file: string, typedPaths?: readonly TypedPath[]): DefinitionOf;
3
5
  export declare function resolves(reference: Reached, typeOf: (path: string) => string | undefined, binary: (path: string) => boolean): boolean;
4
6
  export declare function verify(schema: string, provided?: VerifiedModel): ModelVerification;
5
- export declare function checkDocument(file: string, content: string, model: VerifiedModel, context?: Pick<ValidationContext, 'anyRoom'>): DocumentCheck;
6
- export declare function sectionReferences(file: string, content: string, definition: Definition): readonly Reached[];
7
+ export declare function readTypes(schema: string, provided?: VerifiedModel): VerifiedModel;
8
+ type Placing = Pick<ValidationContext, 'anyRoom' | 'typedPaths'>;
9
+ export declare function checkDocument(file: string, content: string, model: VerifiedModel, context?: Placing): DocumentCheck;
7
10
  export declare function bodyRoomLinks(body: string): RoomReference[];
8
- export declare function roomReferences(file: string, content: string, definition?: Definition): readonly RoomReference[];
11
+ export declare function bodyKeyedLinks(body: string): KeyedLink[];
12
+ export declare function roomReferences(document: Document, definition?: Definition): readonly RoomReference[];
9
13
  type Placed = {
10
14
  readonly reference: Reached;
11
15
  readonly location: string;
16
+ readonly line?: number;
12
17
  };
13
18
  export type Assessment = {
14
19
  readonly file: string;
@@ -18,9 +23,9 @@ export type Assessment = {
18
23
  readonly structured: Validation | null;
19
24
  readonly fields: readonly Placed[];
20
25
  readonly linked: boolean;
21
- readonly sections: readonly Placed[];
22
26
  };
23
- export declare function assess(file: string, content: string, binary: boolean, model?: VerifiedModel, context?: Pick<ValidationContext, 'anyRoom'>): Assessment;
27
+ export declare function assess(file: string, parsed: ParseResult, binary: boolean, model?: VerifiedModel, context?: Placing): Assessment;
28
+ export declare function assessReferences(file: string, parsed: ParseResult, changed: ReadonlySet<string>, model?: VerifiedModel, context?: Placing): Assessment;
24
29
  export type Verdicts = {
25
30
  add(assessment: Assessment, typeOf: (path: string) => string | undefined, binary: (path: string) => boolean): number;
26
31
  verdict(): Validation;
@@ -28,4 +33,5 @@ export type Verdicts = {
28
33
  export declare function verdicts(): Verdicts;
29
34
  export declare function validating(library: ReadonlyMap<string, string>, context?: ValidationContext, model?: VerifiedModel): Generator<ValidationStep, Validation, void>;
30
35
  export declare function validate(library: Library, context?: ValidationContext, model?: VerifiedModel): Validation;
36
+ export declare function validateParsed(library: ReadonlyMap<string, ParseResult>, context?: ValidationContext, model?: VerifiedModel): Validation;
31
37
  export {};
@@ -31,12 +31,12 @@ export declare function parseYamlMapping(text: string, start: number, end: numbe
31
31
  export declare function jsValue(node: YamlNode): unknown;
32
32
  export declare function mapEntry(map: YamlMap, key: string): YamlEntry | undefined;
33
33
  export declare function isPlainSafe(text: string): boolean;
34
- export type FrontmatterValue = string | number | boolean | null | readonly FrontmatterValue[] | {
35
- readonly [name: string]: FrontmatterValue;
34
+ export type DocumentValue = string | number | boolean | null | readonly DocumentValue[] | {
35
+ readonly [name: string]: DocumentValue;
36
36
  };
37
37
  export declare function plain(value: unknown): value is Record<string, unknown>;
38
- export declare function frontmatterValue(value: unknown): value is FrontmatterValue;
39
- export declare function serializeJs(value: FrontmatterValue): string;
38
+ export declare function documentValue(value: unknown): value is DocumentValue;
39
+ export declare function serializeJs(value: DocumentValue): string;
40
40
  export declare function isRecord(value: unknown): value is Record<string, unknown>;
41
41
  export declare function serializeKey(name: string): string;
42
42
  export declare function bodyStartAfterYaml(content: string, yamlEnd: number): number;
@@ -0,0 +1,25 @@
1
+ import type { ConversationHistoryRequest } from './adapter.js';
2
+ import { type CallResult, type HistoryAnswer, type Resolution } from './outcome.js';
3
+ import type { Attempted } from './recovery.js';
4
+ import type { Attempt } from './retried.js';
5
+ import type { Runtime } from './runtime.js';
6
+ export type HistoryQuery = {
7
+ revision?: string;
8
+ pageToken?: string;
9
+ };
10
+ export declare function readHistory(runtime: Runtime, locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
11
+ export declare function located(runtime: Runtime, room: string, path: string, destination: string): Promise<{
12
+ room: string;
13
+ path: string;
14
+ } | null>;
15
+ export declare function resolveReference(runtime: Runtime, room: string, path: string, destination: string): Promise<Resolution>;
16
+ export type Invoked = {
17
+ readonly dispatching?: () => Promise<void>;
18
+ readonly attempt?: Attempt;
19
+ };
20
+ export declare function invokeAction(runtime: Runtime, name: string, input: unknown, { dispatching, attempt }?: Invoked): Promise<CallResult>;
21
+ export declare function readConversationHistory(runtime: Runtime, request: ConversationHistoryRequest): Promise<CallResult>;
22
+ export declare function called(runtime: Runtime, name: string, input: unknown, attempt?: Attempt): Promise<CallResult>;
23
+ export declare function answeredCall(runtime: Runtime, operation: string): Promise<boolean>;
24
+ export declare function resendCalls(runtime: Runtime, signal: AbortSignal): Promise<Attempted>;
25
+ export declare function resendLater(runtime: Runtime): void;
@@ -1,4 +1,7 @@
1
+ import type { SavedFacts, TypedPath, VerifiedModel } from '../mdmodel/index.js';
2
+ import type { Operation, SessionState } from '../session-content/index.js';
1
3
  import type { ModelResult } from './model.js';
4
+ export type { SavedFacts, TypedPath };
2
5
  import type { Open } from './open.js';
3
6
  import type { ChangeBatch } from './change.js';
4
7
  export type Authorization = object;
@@ -11,22 +14,25 @@ export type TypedSelection = {
11
14
  };
12
15
  export type OperationScopes = {
13
16
  write: readonly string[];
14
- delete: readonly string[];
17
+ erase: readonly string[];
15
18
  };
16
19
  export type ReplicaAdmission = {
17
20
  selection: string;
18
21
  admission: Open<'admitted' | 'unavailable'>;
19
22
  offline: Open<'locked' | 'open'>;
20
23
  };
21
- export type DiscoveredRoom = {
22
- name: string;
23
- locator: string;
24
- handle: string;
25
- roomVersion: string;
26
- operations: OperationScopes;
27
- replica: ReplicaAdmission;
28
- typedSelection?: TypedSelection;
29
- providerOwnedPaths: readonly string[];
24
+ export type RoomDeclaration = {
25
+ readonly name: string;
26
+ readonly handle: string;
27
+ readonly operations: OperationScopes;
28
+ readonly replica: ReplicaAdmission;
29
+ readonly typedSelection: TypedSelection | null;
30
+ readonly providerOwnedPaths: readonly string[];
31
+ readonly authoredPaths: readonly string[];
32
+ };
33
+ export type DiscoveredRoom = RoomDeclaration & {
34
+ readonly locator: string;
35
+ readonly roomVersion: string;
30
36
  };
31
37
  export type Capability = {
32
38
  name: string;
@@ -36,16 +42,16 @@ export type Capability = {
36
42
  export type ListedConversation = {
37
43
  conversation: string;
38
44
  agent: string;
39
- agentName: string;
40
- agentRetired: boolean;
41
45
  name: string;
42
46
  created: string;
43
47
  finished: string | null;
44
48
  outcome: string | null;
45
49
  waiting: boolean;
46
50
  newest: string | null;
51
+ processEnded: string | null;
52
+ subject: string | null;
47
53
  };
48
- export type ConversationAction = 'conversations/create' | 'conversations/send' | 'conversations/interaction/answer' | 'conversations/interrupt' | 'conversations/kill' | 'conversations/delete';
54
+ export type ConversationAction = 'conversations/create' | 'conversations/send' | 'conversations/interaction/answer' | 'conversations/interrupt' | 'conversations/kill' | 'conversations/delete' | 'conversations/take-out' | 'conversations/rename' | 'conversations/option/set' | 'conversations/retry' | 'agent-functions/decide';
49
55
  export type ConversationMessage = {
50
56
  identity: string;
51
57
  turn: string;
@@ -54,6 +60,7 @@ export type ConversationMessage = {
54
60
  };
55
61
  export type AcceptedMessage = ConversationMessage & {
56
62
  position: string;
63
+ change: string;
57
64
  };
58
65
  export type ConversationHistoryRequest = {
59
66
  conversations: readonly {
@@ -69,37 +76,10 @@ export type ConversationHistoryPage = {
69
76
  export type ConversationHistories = {
70
77
  histories: readonly ConversationHistoryPage[];
71
78
  };
72
- export type TurnContext = {
73
- used: number;
74
- window: number;
75
- };
76
79
  export type TurnOperation = {
77
80
  op: 'begin';
78
81
  at: string;
79
- } | {
80
- op: 'start';
81
- index: number;
82
- part: unknown;
83
- } | {
84
- op: 'append';
85
- index: number;
86
- text: string;
87
- } | {
88
- op: 'status';
89
- index: number;
90
- status: string;
91
- result: unknown;
92
- } | {
93
- op: 'count';
94
- index: number;
95
- count: number;
96
- } | {
97
- op: 'plan';
98
- index: number;
99
- entries: readonly unknown[];
100
- } | ({
101
- op: 'context';
102
- } & TurnContext);
82
+ } | Operation;
103
83
  export type ProcessCommand = {
104
84
  [field: string]: unknown;
105
85
  name: string;
@@ -136,10 +116,6 @@ export type SessionOption = (SessionOptionNaming & {
136
116
  type: 'boolean';
137
117
  currentValue: boolean;
138
118
  });
139
- export type RunningSubagent = {
140
- description: string;
141
- activity: string | null;
142
- };
143
119
  export type ConversationEvent = {
144
120
  kind: 'turn';
145
121
  conversation: string;
@@ -166,9 +142,9 @@ export type ConversationEvent = {
166
142
  conversation: string;
167
143
  step: string | null;
168
144
  } | {
169
- kind: 'subagents';
145
+ kind: 'state';
170
146
  conversation: string;
171
- subagents: readonly RunningSubagent[];
147
+ state: SessionState | null;
172
148
  } | {
173
149
  kind: 'link';
174
150
  conversation: string;
@@ -176,6 +152,7 @@ export type ConversationEvent = {
176
152
  } | {
177
153
  kind: 'deliveries';
178
154
  conversation: string;
155
+ waiting: readonly string[];
179
156
  unknown: readonly string[];
180
157
  } | {
181
158
  kind: 'accepted-message';
@@ -186,6 +163,7 @@ export type ConversationEvent = {
186
163
  conversation: string;
187
164
  } | {
188
165
  kind: 'list';
166
+ agents: readonly ListedAgent[];
189
167
  entries: readonly ListedConversation[];
190
168
  whole: boolean;
191
169
  more: boolean;
@@ -193,20 +171,68 @@ export type ConversationEvent = {
193
171
  } | {
194
172
  kind: 'listed';
195
173
  entry: ListedConversation;
174
+ } | {
175
+ kind: 'agent';
176
+ agent: ListedAgent;
196
177
  } | {
197
178
  kind: 'unlisted';
198
179
  conversation: string;
199
180
  };
181
+ export type AgentEnvironment = {
182
+ identity: string;
183
+ name: string;
184
+ state: 'online' | 'offline';
185
+ };
186
+ export type ListedOwner = {
187
+ readonly user: string;
188
+ readonly name: string;
189
+ };
190
+ export type ListedSpaceRef = {
191
+ readonly space_ref: string;
192
+ readonly name: string;
193
+ };
194
+ export type RoomListEntry = {
195
+ readonly room_ref: string;
196
+ readonly room_handle: string;
197
+ readonly name: string;
198
+ readonly level: 'search' | 'open' | 'keep';
199
+ readonly access: 'owner' | 'manage' | 'write' | 'read' | 'public';
200
+ readonly owner: ListedOwner;
201
+ readonly created: string;
202
+ readonly archived?: string;
203
+ readonly exportable?: true;
204
+ readonly space?: ListedSpaceRef;
205
+ };
206
+ export type SpaceListEntry = ListedSpaceRef & {
207
+ readonly owner: ListedOwner;
208
+ readonly created: string;
209
+ readonly manages?: true;
210
+ };
211
+ export type RoomList = {
212
+ readonly rooms: readonly RoomListEntry[];
213
+ readonly spaces: readonly SpaceListEntry[];
214
+ };
200
215
  export type ListedAgent = {
201
- agent: string;
216
+ id: string;
202
217
  name: string;
203
- retired: boolean;
218
+ revision: number;
219
+ environment: string;
220
+ environment_name: string;
221
+ environment_connected: boolean;
222
+ launch_directory: string;
223
+ cli: string;
224
+ model: string | null;
225
+ effort: string | null;
226
+ mode: string | null;
227
+ base_instructions: string;
228
+ in_telegram: boolean;
229
+ created: string;
230
+ retired_at: string | null;
204
231
  };
205
232
  export type ConversationStream = {
206
233
  replicate(conversations: readonly string[]): void;
207
234
  hold(cursor: string | null): void;
208
235
  observe(notify: (event: ConversationEvent) => void): () => void;
209
- agents?(): Promise<readonly ListedAgent[] | null>;
210
236
  history?(request: ConversationHistoryRequest): Promise<ActionResult>;
211
237
  };
212
238
  export type ActionDeclaration = {
@@ -227,7 +253,6 @@ export type HistoryRetention = {
227
253
  };
228
254
  export type Retention = {
229
255
  history: HistoryRetention;
230
- outcome: number;
231
256
  refreshHorizon: number;
232
257
  };
233
258
  export type Discovery = {
@@ -237,9 +262,12 @@ export type Discovery = {
237
262
  providerLimits: readonly ProviderLimit[];
238
263
  retention: Retention;
239
264
  member?: Member;
265
+ timeZone?: string | null;
266
+ roomList?: RoomList;
240
267
  };
241
268
  export type TransportUncertainty = {
242
269
  kind: 'transport-uncertainty';
270
+ failure?: unknown;
243
271
  };
244
272
  export type RoomNotReadable = {
245
273
  kind: 'room-not-readable';
@@ -283,25 +311,17 @@ export type BinaryFile = {
283
311
  mediaType: string;
284
312
  sha256: string;
285
313
  };
286
- export type HeldFile = {
287
- readonly path: string;
288
- readonly revision: string;
289
- };
290
- export type HeldContent = {
291
- files(after: string | null, limit: number): Promise<readonly HeldFile[]>;
292
- contents(paths: readonly string[]): Promise<ReadonlyMap<string, {
293
- readonly content: string;
294
- readonly revision: string;
295
- }>>;
296
- };
297
314
  export type BootstrapRequest = {
298
315
  locator: string;
299
316
  selection: string;
300
317
  pageToken?: PageToken;
301
- held?: HeldContent;
302
318
  arriving?: (bytes: number) => void;
303
319
  signal?: AbortSignal;
304
320
  };
321
+ export type BootstrapPart = {
322
+ readonly id: string;
323
+ readonly bytes: number;
324
+ };
305
325
  export type BootstrapInventory = {
306
326
  readonly bytes: number;
307
327
  };
@@ -313,17 +333,23 @@ export type BootstrapPage = {
313
333
  roomVersion: string;
314
334
  models?: RoomModels;
315
335
  documents: Readonly<Record<string, string>>;
336
+ facts: Readonly<Record<string, SavedFacts>>;
316
337
  revisions: Readonly<Record<string, string>>;
317
338
  fileIds?: Readonly<Record<string, string>>;
339
+ created?: Readonly<Record<string, string>>;
318
340
  changes: Readonly<Record<string, HeadChange>>;
319
341
  binaryFiles: Readonly<Record<string, BinaryFile>>;
320
342
  folders?: readonly string[];
321
343
  pageToken?: PageToken;
344
+ parts?: readonly BootstrapPart[];
322
345
  bytes?: number;
323
346
  };
347
+ export type NotReady = {
348
+ kind: 'not-ready';
349
+ };
324
350
  export type BootstrapResult = BootstrapPage | {
325
351
  kind: 'beyond-horizon';
326
- } | AdapterFailure;
352
+ } | NotReady | AdapterFailure;
327
353
  export type RefreshRequest = {
328
354
  locator: string;
329
355
  selection: string;
@@ -335,8 +361,10 @@ export type RefreshPage = {
335
361
  roomVersion: string;
336
362
  models?: RoomModels;
337
363
  documents: Readonly<Record<string, string>>;
364
+ facts: Readonly<Record<string, SavedFacts>>;
338
365
  revisions: Readonly<Record<string, string>>;
339
366
  fileIds?: Readonly<Record<string, string>>;
367
+ created?: Readonly<Record<string, string>>;
340
368
  changes: Readonly<Record<string, HeadChange>>;
341
369
  binaryFiles: Readonly<Record<string, BinaryFile>>;
342
370
  removals: readonly string[];
@@ -374,27 +402,18 @@ export type AcceptedRoom = {
374
402
  };
375
403
  export type MutationResult = (AcceptedRoom & {
376
404
  kind: 'accepted';
377
- author?: string;
378
- time?: string;
379
405
  destination?: AcceptedRoom;
380
406
  }) | (ProviderRefusal & {
381
407
  kind: 'conflicted';
382
- roomVersion?: string;
383
408
  affected: Readonly<Record<string, string>>;
384
409
  }) | (ProviderRefusal & {
385
410
  kind: 'rejected';
386
411
  affected: Readonly<Record<string, string>>;
387
412
  }) | RetryableRefusal | {
388
413
  kind: 'write-halted';
389
- } | {
390
- kind: 'expired';
391
- restored?: true;
392
414
  } | AdapterFailure;
393
415
  export type HistoryAuthor = {
394
- kind: 'user';
395
- id: string;
396
- } | {
397
- kind: 'site' | 'inbox' | 'app';
416
+ kind: 'user' | 'site' | 'inbox' | 'app';
398
417
  id: string;
399
418
  name: string;
400
419
  };
@@ -427,6 +446,10 @@ export type BinaryRequest = {
427
446
  path: string;
428
447
  revision: string;
429
448
  };
449
+ export type KeyedRequest = {
450
+ kind: 'key';
451
+ link: string;
452
+ };
430
453
  export type BinaryResult = {
431
454
  kind: 'binary';
432
455
  body: ReadableStream<Uint8Array>;
@@ -444,7 +467,7 @@ export type BinaryLinkResult = {
444
467
  kind: 'rejected';
445
468
  }) | AdapterFailure;
446
469
  export type AttachRequest = {
447
- locator: string;
470
+ locator?: string;
448
471
  name: string;
449
472
  mediaType: string;
450
473
  byteLength: number;
@@ -455,6 +478,9 @@ export type AttachResult = {
455
478
  kind: 'attached';
456
479
  path: string;
457
480
  revision: string;
481
+ } | {
482
+ kind: 'linked';
483
+ link: string;
458
484
  } | (ProviderRefusal & {
459
485
  kind: 'rejected';
460
486
  }) | AdapterFailure;
@@ -470,17 +496,34 @@ export type ActionResult = {
470
496
  kind: 'action';
471
497
  result: unknown;
472
498
  at?: RoomVersionAt;
499
+ } | (ProviderRefusal & {
500
+ kind: 'rejected';
501
+ reset?: string;
502
+ }) | AdapterFailure;
503
+ export type SearchHit = {
504
+ room: string;
505
+ path: string;
506
+ line?: number;
507
+ snippet?: string;
508
+ };
509
+ export type SearchAsk = {
510
+ text: string;
511
+ rooms: readonly string[] | null;
512
+ };
513
+ export type SearchAnswer = {
514
+ kind: 'found';
515
+ documents: readonly SearchHit[];
473
516
  } | (ProviderRefusal & {
474
517
  kind: 'rejected';
475
518
  }) | AdapterFailure;
476
519
  export type HeldRoom = {
477
520
  locator: string;
478
- roomVersion: string;
521
+ roomVersion: string | null;
479
522
  };
480
523
  export type RoomChange = {
481
524
  kind: 'room-change';
482
525
  locator: string;
483
- from: string;
526
+ from: string | null;
484
527
  roomVersion: string;
485
528
  read(): Promise<RefreshPage>;
486
529
  };
@@ -489,6 +532,10 @@ export type AuthorityChange = {
489
532
  rooms: readonly DiscoveredRoom[];
490
533
  left: readonly string[];
491
534
  member?: Member;
535
+ timeZone?: string | null;
536
+ roomList?: RoomList & {
537
+ readonly left: readonly string[];
538
+ };
492
539
  };
493
540
  export type RoomStreamEvent = {
494
541
  kind: 'opened';
@@ -499,18 +546,25 @@ export type RoomStreamEvent = {
499
546
  kind: 'closed';
500
547
  revoked: boolean;
501
548
  lost: boolean;
549
+ authorityChanged: boolean;
502
550
  } | {
503
551
  kind: 'caught-up';
504
552
  expired: readonly string[];
553
+ } | {
554
+ kind: 'reported';
505
555
  } | AuthorityChange | RoomChange;
506
556
  export type RoomStream = {
507
557
  hold(rooms: readonly HeldRoom[]): void;
508
558
  observe(notify: (event: RoomStreamEvent) => void): () => void;
509
559
  };
560
+ export type PathRule = (path: string) => boolean;
510
561
  export type Adapter = {
511
562
  readonly localSaves?: true;
512
- readonly roomTypes?: string;
513
- readonly nameableRoomTypes?: readonly string[];
563
+ readonly roomTypes?: VerifiedModel;
564
+ readonly typedPaths?: readonly TypedPath[];
565
+ readonly pathRule?: PathRule;
566
+ readonly unkeptReads?: readonly string[];
567
+ readonly leadingReads?: readonly string[];
514
568
  authorize(): Promise<Authorization>;
515
569
  discover?(authorization: Authorization): Promise<DiscoverResult>;
516
570
  bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;
@@ -518,13 +572,13 @@ export type Adapter = {
518
572
  mutate(authorization: Authorization, request: MutationRequest, keep: (upload: unknown) => Promise<void>): Promise<MutationResult>;
519
573
  history(authorization: Authorization, request: HistoryRequest): Promise<HistoryResult>;
520
574
  binary(authorization: Authorization, request: BinaryRequest): Promise<BinaryResult>;
521
- link(authorization: Authorization, request: BinaryRequest): Promise<BinaryLinkResult>;
575
+ link(authorization: Authorization, request: BinaryRequest | KeyedRequest): Promise<BinaryLinkResult>;
522
576
  attach(authorization: Authorization, request: AttachRequest): Promise<AttachResult>;
523
577
  action(authorization: Authorization, request: ActionRequest): Promise<ActionResult>;
578
+ search?(authorization: Authorization, request: SearchAsk): Promise<SearchAnswer>;
524
579
  reached(locator: string, roomVersion: string, target: string): boolean;
525
580
  follows(locator: string, roomVersion: string, next: string): boolean;
526
581
  roomStream?: RoomStream;
527
582
  conversations?: ConversationStream;
528
583
  serviceMode?: ServiceModeSignal;
529
584
  };
530
- export {};
@@ -0,0 +1,6 @@
1
+ import { type VerifiedModel } from '../mdmodel/index.js';
2
+ import type { ModelResult, ModelState } from './model.js';
3
+ export declare const NO_ROOM_TYPES: VerifiedModel;
4
+ export declare function builtInModel(roomTypes: VerifiedModel): ModelState;
5
+ export declare function schemaTypes(schema: string | null, roomTypes: VerifiedModel): VerifiedModel['types'];
6
+ export declare function attachedModel(answer: ModelResult, roomTypes: VerifiedModel): ModelState;