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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/README.md +9 -9
  2. package/dist/index.d.ts +571 -18
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/built-in.d.ts +3 -0
  5. package/dist/mdmodel/crockford.d.ts +3 -0
  6. package/dist/mdmodel/definition.d.ts +21 -10
  7. package/dist/mdmodel/document.d.ts +15 -8
  8. package/dist/mdmodel/event.d.ts +76 -0
  9. package/dist/mdmodel/facts.d.ts +14 -0
  10. package/dist/mdmodel/fields.d.ts +1 -1
  11. package/dist/mdmodel/house-model.d.ts +826 -0
  12. package/dist/mdmodel/house-references.d.ts +3 -0
  13. package/dist/mdmodel/index.d.ts +35 -13
  14. package/dist/mdmodel/kinds.d.ts +17 -0
  15. package/dist/mdmodel/markdown.d.ts +74 -0
  16. package/dist/mdmodel/paths.d.ts +10 -1
  17. package/dist/mdmodel/pattern.d.ts +9 -0
  18. package/dist/mdmodel/query/language.d.ts +253 -0
  19. package/dist/mdmodel/query/match.d.ts +13 -0
  20. package/dist/mdmodel/query/rows.d.ts +31 -0
  21. package/dist/mdmodel/query/sql.d.ts +38 -0
  22. package/dist/mdmodel/reserved.d.ts +5 -0
  23. package/dist/mdmodel/room-types.d.ts +6 -0
  24. package/dist/mdmodel/types.d.ts +29 -10
  25. package/dist/mdmodel/validate.d.ts +31 -6
  26. package/dist/mdruntime/actions.d.ts +25 -0
  27. package/dist/mdruntime/adapter.d.ts +159 -122
  28. package/dist/mdruntime/attached-model.d.ts +6 -0
  29. package/dist/mdruntime/binary.d.ts +0 -5
  30. package/dist/mdruntime/bootstrap.d.ts +43 -0
  31. package/dist/mdruntime/cell.d.ts +5 -0
  32. package/dist/mdruntime/chain.d.ts +11 -0
  33. package/dist/mdruntime/change-set.d.ts +10 -16
  34. package/dist/mdruntime/change.d.ts +32 -1
  35. package/dist/mdruntime/client.d.ts +37 -26
  36. package/dist/mdruntime/collection.d.ts +29 -22
  37. package/dist/mdruntime/compile.d.ts +17 -0
  38. package/dist/mdruntime/conversation-live.d.ts +146 -0
  39. package/dist/mdruntime/conversation-row.d.ts +32 -0
  40. package/dist/mdruntime/conversation.d.ts +68 -49
  41. package/dist/mdruntime/declaration.d.ts +9 -0
  42. package/dist/mdruntime/durability.d.ts +20 -4
  43. package/dist/mdruntime/failure.d.ts +3 -0
  44. package/dist/mdruntime/figures.d.ts +48 -0
  45. package/dist/mdruntime/holdings.d.ts +28 -0
  46. package/dist/mdruntime/identity.d.ts +5 -0
  47. package/dist/mdruntime/listing.d.ts +47 -0
  48. package/dist/mdruntime/live.d.ts +22 -0
  49. package/dist/mdruntime/media.d.ts +7 -0
  50. package/dist/mdruntime/messages.d.ts +55 -0
  51. package/dist/mdruntime/model.d.ts +8 -11
  52. package/dist/mdruntime/observation.d.ts +17 -3
  53. package/dist/mdruntime/opened.d.ts +21 -0
  54. package/dist/mdruntime/outcome.d.ts +47 -9
  55. package/dist/mdruntime/overlay.d.ts +7 -5
  56. package/dist/mdruntime/preparation.d.ts +19 -0
  57. package/dist/mdruntime/presence.d.ts +51 -0
  58. package/dist/mdruntime/query.d.ts +21 -207
  59. package/dist/mdruntime/reach.d.ts +20 -9
  60. package/dist/mdruntime/readiness.d.ts +14 -18
  61. package/dist/mdruntime/reads.d.ts +38 -0
  62. package/dist/mdruntime/recovery.d.ts +5 -2
  63. package/dist/mdruntime/refresh.d.ts +26 -0
  64. package/dist/mdruntime/replica.d.ts +50 -39
  65. package/dist/mdruntime/retried.d.ts +29 -0
  66. package/dist/mdruntime/room-draft.d.ts +28 -11
  67. package/dist/mdruntime/room-drafts.d.ts +23 -0
  68. package/dist/mdruntime/runtime.d.ts +33 -0
  69. package/dist/mdruntime/save.d.ts +43 -50
  70. package/dist/mdruntime/saves.d.ts +31 -0
  71. package/dist/mdruntime/search.d.ts +12 -95
  72. package/dist/mdruntime/seed.d.ts +11 -2
  73. package/dist/mdruntime/socket/admission.d.ts +6 -0
  74. package/dist/mdruntime/socket/answers.d.ts +5 -0
  75. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  76. package/dist/mdruntime/socket/session.d.ts +37 -0
  77. package/dist/mdruntime/socket.d.ts +66 -0
  78. package/dist/mdruntime/source.d.ts +53 -0
  79. package/dist/mdruntime/status.d.ts +4 -5
  80. package/dist/mdruntime/store/installs.d.ts +29 -0
  81. package/dist/mdruntime/store/readiness.d.ts +9 -0
  82. package/dist/mdruntime/store/records.d.ts +214 -0
  83. package/dist/mdruntime/store/room-held.d.ts +7 -0
  84. package/dist/mdruntime/store/space.d.ts +10 -0
  85. package/dist/mdruntime/store/watchers.d.ts +16 -0
  86. package/dist/mdruntime/store/writes.d.ts +23 -0
  87. package/dist/mdruntime/store.d.ts +111 -166
  88. package/dist/mdruntime/stored.d.ts +156 -0
  89. package/dist/mdruntime/surface.d.ts +88 -0
  90. package/dist/mdruntime/tables.d.ts +414 -0
  91. package/dist/mdruntime/tallies.d.ts +17 -0
  92. package/dist/mdruntime/transfer.d.ts +0 -5
  93. package/dist/mdruntime/wire.d.ts +82 -9
  94. package/dist/session-content/bounds.d.ts +7 -0
  95. package/dist/session-content/check.d.ts +18 -0
  96. package/dist/session-content/index.d.ts +7 -0
  97. package/dist/session-content/parts.d.ts +103 -0
  98. package/dist/session-content/state.d.ts +61 -0
  99. package/dist/session-content/turn.d.ts +328 -0
  100. package/dist/test-host.d.ts +7 -4
  101. package/dist/test-host.js +18 -28
  102. package/docs/families.md +65 -57
  103. package/package.json +8 -3
  104. package/dist/calls.d.ts +0 -957
  105. package/dist/calls.js +0 -1
  106. package/dist/mdmodel/blocks.d.ts +0 -10
  107. package/dist/mdmodel/condition.d.ts +0 -147
  108. package/dist/mdmodel/profile.d.ts +0 -5
  109. package/dist/mdruntime/connection.d.ts +0 -146
  110. package/dist/mdruntime/file.d.ts +0 -19
  111. package/dist/mdruntime/rows.d.ts +0 -38
  112. package/dist/mdruntime/shared.d.ts +0 -14
  113. package/dist/mdruntime/turn.d.ts +0 -8
@@ -0,0 +1,3 @@
1
+ export declare const ROOM_REFERENCE_PATTERN: RegExp;
2
+ export declare const APP_REFERENCE_PATTERN: RegExp;
3
+ export declare const SPACE_REFERENCE_PATTERN: RegExp;
@@ -1,19 +1,41 @@
1
- export { dated, datePointers, factKind, facts, fires, holds, instant, itemFires, members, pointed, prosePaths, WRITE_DOORS, } from './condition.js';
2
- export type { Actor, Condition, ConditionScope, ConditionTest, ConditionValue, CronCondition, DateCondition, DocumentCondition, DocumentEvent, DocumentFacts, Fact, FactKind, ItemCondition, ItemFacts, Resolved, WriteDoor, } from './condition.js';
3
- export { headingLines } from './blocks.js';
4
- export type { HeadingLine } from './blocks.js';
1
+ export { candidateOf, datePointers, facts, memberPointers, members, pointed, prosePaths, TEXT_FIELD, valuedChange, WRITE_DOORS, } from './event.js';
2
+ export type { Actor, DocumentEvent, DocumentFacts, Fact, ItemFacts, MessageFacts, Resolved, WriteDoor, } from './event.js';
3
+ export { byCodePoint, compared, dated, fitsKind, instant, instantKey, kindOf, kindWords, } from './kinds.js';
4
+ export type { Kind, Ordering } from './kinds.js';
5
+ export { bodied, cursorOf, decodedCursor, identityOf, invalid, known, placeText, planOf, QueryError, queryKey, } from './query/language.js';
6
+ export type { Clause, Continuation, Direction, DocumentQuery, DocumentShape, Filter, GroupKey, GroupOrder, GroupQuery, GroupSelect, GroupShape, HeldRooms, Key, KeyPlan, LocalQuery, OrderOptions, Place, Predicate, QueryErrorCode, QueryPlan, Related, RoomFacts, Scope, Select, Test, Value, Where, } from './query/language.js';
7
+ export { heldAt, matches } from './query/match.js';
8
+ export type { Candidate } from './query/match.js';
9
+ export { heldKind, indexed } from './query/rows.js';
10
+ export type { HeldKind, HeldLink, HeldValue, Indexed, Reach } from './query/rows.js';
11
+ export * as sql from './query/sql.js';
12
+ export { headingLines } from './markdown.js';
13
+ export type { HeadingLine } from './markdown.js';
14
+ export { labelAt, NAME_FIELD } from './body.js';
15
+ export type { Naming } from './body.js';
5
16
  export { divide } from './divide.js';
6
- export { apply, bodyLinks, fieldStart, linkOccurrences, links, parse, parseFrontmatter, relativize, relativizeBody, relinkBody, serialize, } from './document.js';
17
+ export { apply, bodyLinks, create, links, parse, parseFrontmatter, relabel, relabels, relativize, relativizeBody, relinkBody, serialize, textSpans, unlinkBody, } from './document.js';
18
+ export { documentFacts, referenceTarget, referenceTargets } from './facts.js';
19
+ export type { ReferenceTarget, SavedFacts } from './facts.js';
20
+ export { CROCKFORD_ALPHABET, CROCKFORD_CHARACTER, CROCKFORD_LEADING_CHARACTER, } from './crockford.js';
7
21
  export { HOUSE_FIELDS, MEMBER_FIELD, RECEIVED_FIELD, SITE_FIELD, TYPE_FIELD } from './fields.js';
8
- export { relative, retarget, roomPath, roomTarget, target } from './paths.js';
9
- export type { RoomTarget } from './paths.js';
10
- export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
22
+ export { HOUSE_MODEL, HOUSE_ROOM_TYPES } from './built-in.js';
23
+ export { APP_PREFERENCES_HOME, HOUSE_MODEL_DECLARATION, HOUSE_TYPED_PATHS } from './house-model.js';
24
+ export { APP_REFERENCE_PATTERN, ROOM_REFERENCE_PATTERN, SPACE_REFERENCE_PATTERN, } from './house-references.js';
25
+ export type { HouseDocumentFields, HouseModelType } from './house-model.js';
26
+ export { CHAT_MESSAGE_TYPE, CHAT_TYPE, INBOX_CHANNEL_KINDS, INBOX_TYPES } from './room-types.js';
27
+ export type { InboxChannelKind } from './room-types.js';
28
+ export { linkedPath, relative, retarget, roomPath, roomTarget, target } from './paths.js';
29
+ export { openPatternBudget } from './pattern.js';
30
+ export type { LinkedPath, RoomTarget } from './paths.js';
11
31
  export { project } from './project.js';
12
32
  export { references } from './references.js';
13
- export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
14
- export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, SectionSpec, Shape, Transition, ValueFacts, } from './definition.js';
15
- export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, LinkOccurrence, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, Validation, ValidationContext, VerifiedModel, } from './types.js';
16
- export { bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verify, } from './validate.js';
33
+ export { CAPTURE_HOME, isDocumentPath, isReservedName, RESERVED_NAMES, ROOM_DESCRIPTION, } from './reserved.js';
34
+ export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, JSON_POINTER, memberFacts, pointerFacts, pointerSegments, untitled, } from './definition.js';
35
+ export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, Shape, Transition, ValueFacts, } from './definition.js';
36
+ export type { ApplyResult, BodyResult, Change, DefinitionOf, Division, DivisionContext, Document, DocumentCheck, Extent, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, TypedPath, UnlinkedBody, Validation, ValidationContext, ValidationStep, VerifiedModel, } from './types.js';
37
+ export { assess, assessReferences, bodyRoomLinks, checkDocument, definitionAt, readTypes, resolves, roomReferences, validate, validateParsed, validating, verdicts, verify, } from './validate.js';
38
+ export type { Assessment, Verdicts } from './validate.js';
17
39
  export { VERSION } from './version.js';
18
- export { bodyAfterFrontmatter, equalValue, frontmatterValue } from './yaml.js';
40
+ export { bodyAfterFrontmatter, equalValue, frontmatterValue, plain } from './yaml.js';
19
41
  export type { FrontmatterValue } from './yaml.js';
@@ -0,0 +1,17 @@
1
+ import type { ValueFacts } from './definition.js';
2
+ export type Kind = 'string' | 'number' | 'integer' | 'boolean' | 'date' | 'date-time' | 'time' | 'enum' | 'reference';
3
+ export type Ordering = {
4
+ readonly direction: 'asc' | 'desc';
5
+ readonly nulls: 'first' | 'last';
6
+ readonly stringSort: 'lexical' | 'locale';
7
+ readonly locale: string | undefined;
8
+ readonly localeOptions: Intl.CollatorOptions | undefined;
9
+ };
10
+ export declare function kindOf(facts: ValueFacts): Kind | null;
11
+ export declare function fitsKind(kind: Kind, facts: ValueFacts, value: unknown): boolean;
12
+ export declare function kindWords(facts: ValueFacts | undefined): readonly string[];
13
+ export declare function dated(value: unknown): value is string;
14
+ export declare function instant(value: unknown): bigint | undefined;
15
+ export declare function instantKey(value: unknown): string | null;
16
+ export declare function byCodePoint(left: string, right: string): number;
17
+ export declare function compared(left: unknown, right: unknown, ordering: Ordering): number;
@@ -0,0 +1,74 @@
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 type HrefOccurrence = {
10
+ readonly href: string;
11
+ readonly start: number;
12
+ readonly end: number;
13
+ readonly bracketed: boolean;
14
+ };
15
+ export type LinkUse = {
16
+ readonly start: number;
17
+ readonly end: number;
18
+ readonly labelStart: number;
19
+ readonly labelEnd: number;
20
+ readonly destination: HrefOccurrence;
21
+ };
22
+ export type DefinitionBlock = {
23
+ readonly start: number;
24
+ readonly end: number;
25
+ readonly destination: HrefOccurrence;
26
+ };
27
+ export type Node = {
28
+ readonly type: string;
29
+ readonly position?: {
30
+ readonly start: {
31
+ readonly offset?: number;
32
+ };
33
+ readonly end: {
34
+ readonly offset?: number;
35
+ };
36
+ };
37
+ readonly children?: readonly Node[];
38
+ readonly depth?: number;
39
+ readonly identifier?: string;
40
+ readonly checked?: boolean | null;
41
+ readonly ordered?: boolean | null;
42
+ readonly lang?: string | null;
43
+ readonly value?: string;
44
+ };
45
+ export type Reading = {
46
+ readonly headings: readonly HeadingLine[];
47
+ readonly blocks: readonly Extent[];
48
+ readonly uses: readonly LinkUse[];
49
+ readonly definitions: readonly DefinitionBlock[];
50
+ readonly tree: readonly Node[];
51
+ readonly base: number;
52
+ };
53
+ export declare function lineBreaks(text: string): readonly number[];
54
+ export declare function lineNumber(breaks: readonly number[], offset: number): number;
55
+ export declare function lineStart(text: string, index: number): number;
56
+ export declare function lineEnd(text: string, index: number): {
57
+ readonly end: number;
58
+ readonly next: number;
59
+ };
60
+ export declare function read(text: string, at?: number): Reading;
61
+ export declare function destinations(reading: Reading): readonly HrefOccurrence[];
62
+ export declare function linkable(text: string, from?: number): boolean;
63
+ export declare function hrefOccurrences(body: string): readonly HrefOccurrence[];
64
+ export declare function headingLines(content: string, from: number, to: number): HeadingLine[];
65
+ export type SectionSpan = {
66
+ readonly name: string;
67
+ readonly headingStart: number;
68
+ readonly bodyStart: number;
69
+ readonly bodyEnd: number;
70
+ };
71
+ export declare function sectionSpans(reading: Reading, end: number): SectionSpan[];
72
+ export declare function sectionsRecord(spans: readonly SectionSpan[], content: string): Record<string, string>;
73
+ export declare function headingsIn(reading: Reading, from: number, to: number): readonly HeadingLine[];
74
+ export declare function blockRanges(reading: Reading, from: number, to: number): Extent[];
@@ -6,7 +6,7 @@ export type RoomTarget = {
6
6
  readonly handle: string;
7
7
  readonly path: string;
8
8
  };
9
- export declare function classifyHref(from: string, href: string): {
9
+ type Classified = {
10
10
  kind: 'skip';
11
11
  } | {
12
12
  kind: 'path';
@@ -16,10 +16,19 @@ export declare function classifyHref(from: string, href: string): {
16
16
  } & RoomTarget) | {
17
17
  kind: 'invalid';
18
18
  };
19
+ export declare function classifyHref(from: string, href: string): Classified;
19
20
  export declare function roomTarget(href: string): RoomTarget | null;
20
21
  export declare function roomPath(href: string): string | null;
21
22
  export declare function target(from: string, href: string): string | null;
23
+ export interface LinkedPath {
24
+ readonly handle: string | null;
25
+ readonly path: string;
26
+ readonly fragment: string | null;
27
+ }
28
+ export declare function linkedPath(from: string, href: string): LinkedPath | null;
22
29
  export declare function retarget(href: string, to: string): string;
23
30
  export declare function relative(from: string, target: string): string;
24
31
  export declare const SHELL_ROOMS = "/rooms/";
25
32
  export declare function shellTarget(href: string, handle: string): string | null;
33
+ export declare function destinationText(to: string, bracketed: boolean): string | null;
34
+ export {};
@@ -0,0 +1,9 @@
1
+ export declare const PATTERN_STATES = 1000;
2
+ export declare class PatternTooCostly extends Error {
3
+ }
4
+ export type Pattern = {
5
+ readonly test: (text: string) => boolean;
6
+ };
7
+ export declare function linearPattern(source: string): Pattern | null;
8
+ export declare function withLinearRegExp<T>(run: () => T): T;
9
+ export declare function openPatternBudget(): () => void;
@@ -0,0 +1,253 @@
1
+ import { type Definition } from '../definition.js';
2
+ export type Value = string | number | boolean | null;
3
+ export type Predicate = Value | {
4
+ $eq: Value;
5
+ } | {
6
+ $ne: Value;
7
+ } | {
8
+ $in: readonly Value[];
9
+ } | {
10
+ $nin: readonly Value[];
11
+ } | {
12
+ $gt?: Value;
13
+ $gte?: Value;
14
+ $lt?: Value;
15
+ $lte?: Value;
16
+ } | {
17
+ $all: readonly Value[];
18
+ } | {
19
+ $size: number;
20
+ } | {
21
+ $exists: boolean;
22
+ } | {
23
+ $prefix: string;
24
+ };
25
+ export type Where = {
26
+ $and?: readonly Where[];
27
+ $or?: readonly Where[];
28
+ [field: string]: Predicate | readonly Where[] | undefined;
29
+ };
30
+ export type Related = {
31
+ types?: readonly string[];
32
+ where?: Where;
33
+ pathPrefix?: string;
34
+ };
35
+ export type Filter = {
36
+ rooms?: readonly string[];
37
+ types?: readonly string[];
38
+ where?: Where;
39
+ pathPrefix?: string;
40
+ outside?: readonly string[];
41
+ folder?: string;
42
+ paths?: readonly string[];
43
+ fileIds?: readonly string[];
44
+ hop?: Related & {
45
+ field: string;
46
+ };
47
+ backlinks?: Related & {
48
+ field?: string;
49
+ };
50
+ text?: string;
51
+ };
52
+ export type Key = 'room' | 'path' | 'type' | 'folder' | 'size' | 'created' | 'updated' | {
53
+ field: string;
54
+ };
55
+ export type GroupKey = 'room' | 'type' | 'folder' | 'subfolder' | {
56
+ field: string;
57
+ };
58
+ export type Select = 'all' | {
59
+ fields?: 'all' | readonly string[];
60
+ sections?: 'all' | readonly string[];
61
+ preamble?: true;
62
+ markdown?: true;
63
+ backlinks?: true;
64
+ change?: true;
65
+ fileId?: true;
66
+ revision?: true;
67
+ size?: true;
68
+ created?: true;
69
+ };
70
+ export type GroupSelect = {
71
+ size?: true;
72
+ updated?: true;
73
+ greatest?: {
74
+ field: string;
75
+ };
76
+ };
77
+ export type GroupOrder = 'count' | 'size' | 'updated' | 'greatest';
78
+ export type OrderOptions = {
79
+ nulls?: 'first' | 'last';
80
+ stringSort?: 'lexical' | 'locale';
81
+ locale?: string;
82
+ localeOptions?: Readonly<Record<string, unknown>>;
83
+ };
84
+ export type Direction = 'asc' | 'desc';
85
+ export type DocumentQuery = Filter & {
86
+ select: Select;
87
+ orderBy?: readonly ({
88
+ by: Key;
89
+ direction?: Direction;
90
+ } & OrderOptions)[];
91
+ limit?: number;
92
+ after?: string;
93
+ total?: true;
94
+ };
95
+ export type GroupQuery = Filter & {
96
+ groupBy: readonly GroupKey[];
97
+ select?: GroupSelect;
98
+ orderBy?: readonly {
99
+ by: GroupOrder | GroupKey;
100
+ direction?: Direction;
101
+ nulls?: 'first' | 'last';
102
+ }[];
103
+ limit?: number;
104
+ after?: string;
105
+ total?: true;
106
+ };
107
+ export type LocalQuery = DocumentQuery | GroupQuery;
108
+ export type QueryErrorCode = 'invalid-query' | 'unknown-type' | 'unknown-field' | 'wrong-kind';
109
+ export type RoomFacts = {
110
+ locator: string;
111
+ available: boolean;
112
+ types: readonly Definition[];
113
+ };
114
+ export type HeldRooms = {
115
+ listed: boolean;
116
+ rooms: readonly RoomFacts[];
117
+ };
118
+ export type Test = {
119
+ op: 'eq';
120
+ value: Value;
121
+ } | {
122
+ op: 'ne';
123
+ value: Value;
124
+ } | {
125
+ op: 'in';
126
+ values: readonly Value[];
127
+ } | {
128
+ op: 'nin';
129
+ values: readonly Value[];
130
+ } | {
131
+ op: 'range';
132
+ bounds: readonly (readonly ['gt' | 'gte' | 'lt' | 'lte', Value])[];
133
+ } | {
134
+ op: 'all';
135
+ values: readonly Value[];
136
+ } | {
137
+ op: 'size';
138
+ size: number;
139
+ } | {
140
+ op: 'exists';
141
+ exists: boolean;
142
+ } | {
143
+ op: 'prefix';
144
+ prefix: string;
145
+ };
146
+ export type Clause = {
147
+ every: readonly Clause[];
148
+ } | {
149
+ some: readonly Clause[];
150
+ } | {
151
+ field: string;
152
+ test: Test;
153
+ };
154
+ export type Scope = {
155
+ types: readonly string[] | null;
156
+ where: Clause | null;
157
+ pathPrefix: string | null;
158
+ };
159
+ export type KeyPlan = {
160
+ of: 'room';
161
+ } | {
162
+ of: 'path';
163
+ } | {
164
+ of: 'type';
165
+ } | {
166
+ of: 'folder';
167
+ } | {
168
+ of: 'subfolder';
169
+ } | {
170
+ of: 'size';
171
+ } | {
172
+ of: 'created';
173
+ } | {
174
+ of: 'updated';
175
+ } | {
176
+ of: 'field';
177
+ field: string;
178
+ };
179
+ export type DocumentShape = {
180
+ kind: 'documents';
181
+ fields: 'all' | readonly string[] | null;
182
+ sections: 'all' | readonly string[] | null;
183
+ preamble: boolean;
184
+ markdown: boolean;
185
+ backlinks: boolean;
186
+ change: boolean;
187
+ fileId: boolean;
188
+ revision: boolean;
189
+ size: boolean;
190
+ created: boolean;
191
+ orderBy: readonly {
192
+ key: KeyPlan;
193
+ options: OrderOptions & {
194
+ direction: Direction;
195
+ };
196
+ }[];
197
+ };
198
+ export type GroupShape = {
199
+ kind: 'groups';
200
+ groupBy: readonly KeyPlan[];
201
+ size: boolean;
202
+ updated: boolean;
203
+ greatest: string | null;
204
+ orderBy: readonly {
205
+ by: GroupOrder | number;
206
+ direction: Direction;
207
+ nulls: 'first' | 'last' | null;
208
+ }[];
209
+ };
210
+ export type Continuation = {
211
+ text: string;
212
+ values: readonly unknown[] | null;
213
+ };
214
+ export type QueryPlan = {
215
+ key: string;
216
+ rooms: readonly string[] | null;
217
+ root: Scope;
218
+ outside: readonly string[] | null;
219
+ folder: string | null;
220
+ paths: readonly string[] | null;
221
+ fileIds: readonly string[] | null;
222
+ hop: (Scope & {
223
+ field: string;
224
+ }) | null;
225
+ backlinks: (Scope & {
226
+ field: string | null;
227
+ }) | null;
228
+ text: string | null;
229
+ shape: DocumentShape | GroupShape;
230
+ limit: number | null;
231
+ after: Continuation | null;
232
+ total: boolean;
233
+ };
234
+ export type Place = readonly (string | number)[];
235
+ type At = Place | string;
236
+ export declare class QueryError extends Error {
237
+ readonly code: QueryErrorCode;
238
+ readonly place: Place;
239
+ readonly accepts: readonly string[];
240
+ readonly retryable = false;
241
+ constructor(code: QueryErrorCode, at: At, problem: string, accepts?: readonly string[]);
242
+ }
243
+ type Entries = Readonly<Record<string, unknown>>;
244
+ export declare function bodied(shape: DocumentShape): boolean;
245
+ export declare function invalid(at: At, problem: string, accepts?: readonly string[]): never;
246
+ export declare function placeText(at: Place): string;
247
+ export declare function known(value: Entries, allowed: readonly string[], at: At): void;
248
+ export declare function planOf(input: unknown, facts: HeldRooms): QueryPlan;
249
+ export declare function cursorOf(values: readonly unknown[]): string;
250
+ export declare function decodedCursor(text: string): readonly unknown[] | null;
251
+ export declare function queryKey(query: unknown): string;
252
+ export declare function identityOf(plan: QueryPlan): string;
253
+ export {};
@@ -0,0 +1,13 @@
1
+ import type { Definition } from '../definition.js';
2
+ import { type QueryPlan } from './language.js';
3
+ import { type HeldValue } from './rows.js';
4
+ export type Candidate = {
5
+ readonly path: string;
6
+ readonly type: string | null;
7
+ readonly fileId: string | null;
8
+ readonly fields: Readonly<Record<string, unknown>>;
9
+ readonly definition?: Pick<Definition, 'frontmatter'>;
10
+ readonly text: string | null;
11
+ };
12
+ export declare function heldAt(candidate: Candidate, field: string): readonly HeldValue[];
13
+ export declare function matches(plan: QueryPlan, candidate: Candidate): boolean;
@@ -0,0 +1,31 @@
1
+ import { type Definition } from '../definition.js';
2
+ export type HeldKind = 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object' | 'undefined';
3
+ export type HeldValue = {
4
+ readonly keys: string;
5
+ readonly places: string;
6
+ readonly item: number;
7
+ readonly kind: HeldKind;
8
+ readonly value: string | number | null;
9
+ readonly size: number | null;
10
+ readonly instant: string | null;
11
+ };
12
+ export type HeldLink = {
13
+ readonly kind: 'field';
14
+ readonly keys: string;
15
+ readonly places: string;
16
+ readonly target: string;
17
+ readonly field: string;
18
+ };
19
+ export type Indexed = {
20
+ readonly values: readonly HeldValue[];
21
+ readonly links: readonly HeldLink[];
22
+ };
23
+ export type Reach = 'exact' | 'value' | 'link';
24
+ export type Placed = {
25
+ readonly keys: string;
26
+ readonly places: string;
27
+ readonly glob: boolean;
28
+ };
29
+ export declare function placedOf(pointer: string, reach: Reach): Placed;
30
+ export declare function heldKind(value: unknown): HeldKind;
31
+ export declare function indexed(path: string, fields: Readonly<Record<string, unknown>>, definition: Pick<Definition, 'frontmatter'> | undefined): Indexed;
@@ -0,0 +1,38 @@
1
+ import { type Ordering } from '../kinds.js';
2
+ import type { QueryPlan, Scope } from './language.js';
3
+ import { type HeldValue, type Reach } from './rows.js';
4
+ export type SqlValue = string | number | bigint | Uint8Array | null;
5
+ export type Fragment = {
6
+ readonly sql: string;
7
+ readonly bind: readonly SqlValue[];
8
+ };
9
+ export type Collate = (ordering: Ordering, lists: boolean, total: boolean) => string | null;
10
+ export type Term = {
11
+ readonly ordering: Ordering;
12
+ readonly kind: Fragment;
13
+ readonly value: Fragment;
14
+ readonly instant?: Fragment;
15
+ readonly total?: boolean;
16
+ };
17
+ export type Following = {
18
+ readonly beyond: Fragment;
19
+ readonly equal: Fragment;
20
+ };
21
+ export declare const VALUE_TABLE = "CREATE TABLE replica_values (doc INTEGER NOT NULL, keys TEXT NOT NULL, places TEXT NOT NULL, item INTEGER NOT NULL, kind TEXT NOT NULL, value, size INTEGER, instant TEXT, PRIMARY KEY (doc, keys, places, item)) WITHOUT ROWID";
22
+ export declare const HOLDS_PHRASE = "holds_phrase";
23
+ export declare function holdsPhrase(_context: number, text: unknown, phrase: unknown): number;
24
+ export declare function fragment(sql: string, bind?: readonly SqlValue[]): Fragment;
25
+ export declare function joined(parts: readonly Fragment[], separator: string): Fragment;
26
+ export declare function all(parts: readonly Fragment[]): Fragment;
27
+ export declare function any(parts: readonly Fragment[]): Fragment;
28
+ export declare function grouped(part: Fragment): Fragment;
29
+ export declare function listed(values: readonly SqlValue[]): Fragment;
30
+ export declare function exists(part: Fragment): Fragment;
31
+ export declare function insertedValues(doc: number, values: readonly HeldValue[]): Fragment;
32
+ export declare function placed(alias: string, field: string, reach: Reach): Fragment;
33
+ export declare function scoped(alias: string, scope: Scope, byPaths?: boolean): Fragment;
34
+ export declare function tests(alias: string, plan: QueryPlan): Fragment;
35
+ export declare function sortValue(kind: SqlValue | undefined, value: unknown, instant: SqlValue | undefined): unknown;
36
+ export declare function sorted(collate: Collate, term: Term): Fragment;
37
+ export declare function beyond(collate: Collate, term: Term, value: unknown): Following;
38
+ export declare function following(parts: readonly Following[], tie: Fragment): Fragment;
@@ -0,0 +1,5 @@
1
+ export declare const ROOM_DESCRIPTION = "ROOM.md";
2
+ export declare const CAPTURE_HOME = "capture";
3
+ export declare const RESERVED_NAMES: readonly string[];
4
+ export declare function isReservedName(name: string): boolean;
5
+ export declare function isDocumentPath(path: string): boolean;
@@ -0,0 +1,6 @@
1
+ export declare const CHAT_TYPE = "chat";
2
+ export declare const CHAT_MESSAGE_TYPE = "chat-message";
3
+ export declare const INBOX_TYPES: readonly string[];
4
+ export declare const INBOX_CHANNEL_KINDS: readonly ['telegram-bot', 'telegram-business', 'whatsapp', 'messenger', 'instagram', 'viber', 'tiktok'];
5
+ export type InboxChannelKind = (typeof INBOX_CHANNEL_KINDS)[number];
6
+ export declare const ROOM_TYPES_TEXT: string;
@@ -2,6 +2,7 @@ import type { Definition } from './definition.js';
2
2
  export type Library = Readonly<Record<string, string>>;
3
3
  export type VerifiedModel = {
4
4
  readonly types: Readonly<Record<string, Definition>>;
5
+ readonly nameable?: readonly string[];
5
6
  };
6
7
  export type ModelVerification = {
7
8
  readonly verdict: 'accept';
@@ -11,15 +12,23 @@ export type ModelVerification = {
11
12
  readonly rule: string;
12
13
  readonly location?: string;
13
14
  };
15
+ export type TypedPath = {
16
+ readonly path: string;
17
+ readonly type: string;
18
+ readonly named: boolean;
19
+ readonly body: boolean;
20
+ };
14
21
  export type ValidationContext = {
15
22
  readonly binaryTargets: readonly string[];
23
+ readonly anyRoom?: true;
24
+ readonly typedPaths?: readonly TypedPath[];
16
25
  };
17
26
  export type ProjectionContext = {
18
27
  readonly documentTargets: readonly string[];
19
28
  readonly definition?: Definition;
20
29
  };
21
30
  export type DivisionContext = ProjectionContext & {
22
- readonly budget: number;
31
+ readonly bound: number;
23
32
  };
24
33
  export type Extent = {
25
34
  readonly start: number;
@@ -36,11 +45,16 @@ export type Frontmatter = {
36
45
  export type Document = Frontmatter & {
37
46
  readonly preamble: string;
38
47
  readonly sections: Readonly<Record<string, string>>;
48
+ readonly text: string;
49
+ readonly ranges: Readonly<Record<string, Extent>>;
50
+ readonly listEnd: number;
39
51
  };
52
+ export type DefinitionOf = (type: string | undefined) => Definition | undefined;
40
53
  export type Refusal = {
41
54
  readonly file: string;
42
55
  readonly rule: string;
43
56
  readonly location?: string;
57
+ readonly line?: number;
44
58
  readonly referrers?: readonly string[];
45
59
  };
46
60
  export type Reached = {
@@ -60,6 +74,10 @@ export type Validation = {
60
74
  } | ({
61
75
  readonly verdict: 'refuse';
62
76
  } & Refusal);
77
+ export type ValidationStep = {
78
+ readonly path: string;
79
+ readonly resolved: number;
80
+ };
63
81
  export type Projection = {
64
82
  readonly ok: true;
65
83
  readonly text: string;
@@ -92,9 +110,6 @@ export type Link = {
92
110
  readonly href: string;
93
111
  readonly target: string;
94
112
  };
95
- export type LinkOccurrence = Link & {
96
- readonly start: number;
97
- };
98
113
  export type Reference = {
99
114
  readonly pointer: string;
100
115
  readonly value: string;
@@ -112,11 +127,7 @@ export type RoomReference = {
112
127
  readonly pointer: string;
113
128
  readonly value: string;
114
129
  readonly to: readonly string[];
115
- } | {
116
- readonly kind: 'item';
117
- readonly section: string;
118
- readonly href: string;
119
- readonly to: readonly string[];
130
+ readonly crossRoom?: true;
120
131
  });
121
132
  export type Change = {
122
133
  readonly kind: 'field';
@@ -127,11 +138,15 @@ export type Change = {
127
138
  readonly kind: 'section';
128
139
  readonly name: string;
129
140
  readonly value: string;
130
- readonly prior: string;
141
+ readonly prior: string | undefined;
131
142
  } | {
132
143
  readonly kind: 'preamble';
133
144
  readonly value: string;
134
145
  readonly prior: string;
146
+ } | {
147
+ readonly kind: 'text';
148
+ readonly value: string;
149
+ readonly prior: string;
135
150
  } | {
136
151
  readonly kind: 'link';
137
152
  readonly href: string;
@@ -160,3 +175,7 @@ export type BodyResult = {
160
175
  readonly outcome: 'refuse';
161
176
  readonly refusal: Refusal;
162
177
  };
178
+ export type UnlinkedBody = {
179
+ readonly body: string;
180
+ readonly links: ReadonlyMap<string, string>;
181
+ };