@agentshouse/app-bridge 0.1.0-caabde65fcc7f → 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 (107) hide show
  1. package/README.md +6 -6
  2. package/dist/index.d.ts +136 -406
  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 +20 -10
  7. package/dist/mdmodel/document.d.ts +14 -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 +34 -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 +21 -12
  25. package/dist/mdmodel/validate.d.ts +10 -6
  26. package/dist/mdruntime/actions.d.ts +25 -0
  27. package/dist/mdruntime/adapter.d.ts +88 -79
  28. package/dist/mdruntime/attached-model.d.ts +6 -0
  29. package/dist/mdruntime/bootstrap.d.ts +43 -0
  30. package/dist/mdruntime/cell.d.ts +5 -0
  31. package/dist/mdruntime/chain.d.ts +2 -1
  32. package/dist/mdruntime/change-set.d.ts +4 -0
  33. package/dist/mdruntime/change.d.ts +1 -0
  34. package/dist/mdruntime/client.d.ts +28 -21
  35. package/dist/mdruntime/collection.d.ts +23 -4
  36. package/dist/mdruntime/compile.d.ts +9 -7
  37. package/dist/mdruntime/conversation-live.d.ts +146 -0
  38. package/dist/mdruntime/conversation-row.d.ts +32 -0
  39. package/dist/mdruntime/conversation.d.ts +62 -45
  40. package/dist/mdruntime/declaration.d.ts +9 -0
  41. package/dist/mdruntime/durability.d.ts +19 -0
  42. package/dist/mdruntime/failure.d.ts +3 -0
  43. package/dist/mdruntime/figures.d.ts +48 -0
  44. package/dist/mdruntime/holdings.d.ts +28 -0
  45. package/dist/mdruntime/identity.d.ts +0 -1
  46. package/dist/mdruntime/listing.d.ts +47 -0
  47. package/dist/mdruntime/live.d.ts +22 -0
  48. package/dist/mdruntime/media.d.ts +1 -1
  49. package/dist/mdruntime/messages.d.ts +33 -5
  50. package/dist/mdruntime/model.d.ts +2 -10
  51. package/dist/mdruntime/observation.d.ts +4 -3
  52. package/dist/mdruntime/opened.d.ts +1 -1
  53. package/dist/mdruntime/outcome.d.ts +7 -1
  54. package/dist/mdruntime/overlay.d.ts +6 -1
  55. package/dist/mdruntime/preparation.d.ts +19 -0
  56. package/dist/mdruntime/presence.d.ts +51 -0
  57. package/dist/mdruntime/query.d.ts +13 -211
  58. package/dist/mdruntime/reach.d.ts +14 -12
  59. package/dist/mdruntime/readiness.d.ts +1 -4
  60. package/dist/mdruntime/reads.d.ts +38 -0
  61. package/dist/mdruntime/recovery.d.ts +3 -1
  62. package/dist/mdruntime/refresh.d.ts +26 -0
  63. package/dist/mdruntime/replica.d.ts +11 -16
  64. package/dist/mdruntime/retried.d.ts +29 -0
  65. package/dist/mdruntime/room-draft.d.ts +6 -7
  66. package/dist/mdruntime/room-drafts.d.ts +23 -0
  67. package/dist/mdruntime/runtime.d.ts +33 -0
  68. package/dist/mdruntime/save.d.ts +42 -86
  69. package/dist/mdruntime/saves.d.ts +31 -0
  70. package/dist/mdruntime/search.d.ts +12 -63
  71. package/dist/mdruntime/seed.d.ts +11 -2
  72. package/dist/mdruntime/socket/admission.d.ts +6 -0
  73. package/dist/mdruntime/socket/answers.d.ts +5 -0
  74. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  75. package/dist/mdruntime/socket/session.d.ts +37 -0
  76. package/dist/mdruntime/socket.d.ts +66 -0
  77. package/dist/mdruntime/source.d.ts +53 -0
  78. package/dist/mdruntime/status.d.ts +0 -2
  79. package/dist/mdruntime/store/installs.d.ts +29 -0
  80. package/dist/mdruntime/store/readiness.d.ts +9 -0
  81. package/dist/mdruntime/store/records.d.ts +214 -0
  82. package/dist/mdruntime/store/room-held.d.ts +7 -0
  83. package/dist/mdruntime/store/space.d.ts +10 -0
  84. package/dist/mdruntime/store/watchers.d.ts +16 -0
  85. package/dist/mdruntime/store/writes.d.ts +23 -0
  86. package/dist/mdruntime/store.d.ts +112 -155
  87. package/dist/mdruntime/stored.d.ts +60 -66
  88. package/dist/mdruntime/surface.d.ts +88 -0
  89. package/dist/mdruntime/tables.d.ts +120 -56
  90. package/dist/mdruntime/tallies.d.ts +17 -0
  91. package/dist/mdruntime/transfer.d.ts +4 -0
  92. package/dist/mdruntime/wire.d.ts +67 -7
  93. package/dist/session-content/bounds.d.ts +7 -0
  94. package/dist/session-content/check.d.ts +18 -0
  95. package/dist/session-content/index.d.ts +7 -0
  96. package/dist/session-content/parts.d.ts +103 -0
  97. package/dist/session-content/state.d.ts +61 -0
  98. package/dist/session-content/turn.d.ts +328 -0
  99. package/dist/test-host.js +1 -1
  100. package/docs/families.md +22 -16
  101. package/package.json +2 -2
  102. package/dist/mdmodel/blocks.d.ts +0 -10
  103. package/dist/mdmodel/condition.d.ts +0 -180
  104. package/dist/mdmodel/links.d.ts +0 -28
  105. package/dist/mdmodel/profile.d.ts +0 -5
  106. package/dist/mdruntime/connection.d.ts +0 -153
  107. package/dist/mdruntime/fulltext.d.ts +0 -26
@@ -1,4 +1,5 @@
1
- import type { BootstrapInventory, MutationResult, OperationScopes, ReplicaAdmission, TypedSelection } from './adapter.js';
1
+ import { type TypedPath } from '../mdmodel/index.js';
2
+ import type { BootstrapInventory, SavedFacts, MutationResult, RoomDeclaration, TypedSelection } from './adapter.js';
2
3
  import { type ChangeBatch, type Precondition } from './change.js';
3
4
  import { type Collection, type Composition } from './collection.js';
4
5
  import { type ModelState } from './model.js';
@@ -6,13 +7,8 @@ import { type Layer } from './overlay.js';
6
7
  import type { HeldEntry, OverlayEntry, StoredEntry } from './tables.js';
7
8
  export type ReplicaRecord = {
8
9
  readonly locator: string;
9
- readonly name: string;
10
- readonly handle: string;
11
- readonly operations: OperationScopes;
12
- readonly replica: ReplicaAdmission;
10
+ readonly declaration: RoomDeclaration;
13
11
  readonly model: ModelState;
14
- readonly typedSelection: TypedSelection | null;
15
- readonly providerOwnedPaths: readonly string[];
16
12
  readonly roomVersion: string;
17
13
  readonly transfer: string;
18
14
  readonly inventory: BootstrapInventory;
@@ -22,23 +18,22 @@ export type HeldReplica = {
22
18
  readonly record: ReplicaRecord;
23
19
  readonly queue: readonly ChangeBatch[];
24
20
  readonly overlaid: ReadonlySet<string>;
25
- readonly count: number;
26
- readonly confirmed: number;
27
- readonly indexed: boolean;
28
21
  };
29
22
  export type VisibleLayer = Layer & {
30
23
  readonly collection: Collection;
31
24
  };
32
25
  export type Slice = Layer & {
33
26
  readonly written: Readonly<Record<string, string>>;
27
+ readonly facts: Readonly<Record<string, SavedFacts>>;
34
28
  readonly held: ReadonlySet<string>;
35
29
  };
36
- export declare function compositionOf(record: Pick<ReplicaRecord, 'model' | 'typedSelection'>, builtIn: ModelState): Composition;
30
+ export declare function compositionOf(model: ModelState, typedSelection: TypedSelection | null, builtIn: ModelState, typedPaths: readonly TypedPath[]): Composition;
37
31
  export declare function storedRecord(record: ReplicaRecord): string;
38
32
  export declare function slicing(entries: readonly HeldEntry[], paths: Iterable<string>): Generator<number, Slice, void>;
33
+ export type LayerEntry = Omit<StoredEntry, 'facts'>;
39
34
  export declare function entryAt(layer: Layer & {
40
35
  readonly written?: Readonly<Record<string, string>>;
41
- }, path: string): StoredEntry | null;
36
+ }, path: string): LayerEntry | null;
42
37
  export declare function slicingWith(slice: Slice, set: readonly StoredEntry[], removed: readonly string[]): Generator<number, Slice, void>;
43
38
  export declare function touchedBy(queue: readonly ChangeBatch[]): Set<string>;
44
39
  export declare function movedBy(queue: readonly ChangeBatch[], locator: string): Set<string>;
@@ -47,9 +42,9 @@ export type Replayed = {
47
42
  readonly touched: ReadonlySet<string>;
48
43
  };
49
44
  export declare function replaying(confirmed: Slice, queue: readonly ChangeBatch[], locator: string, composition: Composition): Generator<number, Replayed, void>;
50
- export declare function overlayOf(visible: Layer, touched: Iterable<string>): Generator<number, OverlayEntry[], void>;
51
- export declare function holds(layer: Layer, preconditions: readonly Precondition[]): boolean;
52
- export declare function landed(batch: ChangeBatch, confirmed: Layer, current?: Readonly<Record<string, string>>): boolean;
45
+ export declare function overlayOf(visible: VisibleLayer, touched: Iterable<string>): Generator<number, OverlayEntry[], void>;
46
+ export declare function holds(layer: Layer, preconditions: readonly Precondition[], composition: Composition): boolean;
47
+ export declare function landed(batch: ChangeBatch, confirmed: Layer, composition: Composition, current?: Readonly<Record<string, string>>): boolean;
53
48
  export type Standing = {
54
49
  readonly withdrawn: readonly ChangeBatch[];
55
50
  readonly kept: readonly ChangeBatch[];
@@ -63,5 +58,5 @@ export type Returned = {
63
58
  readonly removed: readonly string[];
64
59
  };
65
60
  export declare function returnedPaths(submitted: ChangeBatch, accepted: Accepted): Set<string>;
66
- export declare function returning(confirmed: Slice, submitted: ChangeBatch, accepted: Accepted, writtenAt: string): Generator<number, Returned, void>;
61
+ export declare function returning(confirmed: Slice, submitted: ChangeBatch, accepted: Accepted, writtenAt: string, composition: Composition): Generator<number, Returned, void>;
67
62
  export {};
@@ -0,0 +1,29 @@
1
+ import { type RuntimeShell } from './durability.js';
2
+ export declare const STEPS: readonly ['database', 'sign_in', 'connection', 'code', 'download', 'conversations', 'sending', 'reading'];
3
+ export type Step = (typeof STEPS)[number];
4
+ export type RetriedFailure = {
5
+ readonly step: Step;
6
+ readonly answered: false;
7
+ } | {
8
+ readonly step: Step;
9
+ readonly answered: true;
10
+ readonly error: unknown;
11
+ };
12
+ export type Uncertain = {
13
+ readonly failure?: unknown;
14
+ };
15
+ export type Attempt = {
16
+ readonly step: Step;
17
+ readonly instance: string;
18
+ };
19
+ export declare class Unanswered extends Error {
20
+ }
21
+ export declare function uncertainError(uncertainty: Uncertain): unknown;
22
+ export type Retries = {
23
+ failed(step: Step, instance: string, error: unknown): void;
24
+ unanswered(step: Step, instance: string): void;
25
+ uncertain(step: Step, instance: string, uncertainty: Uncertain): void;
26
+ succeeded(step: Step, instance: string): void;
27
+ };
28
+ export declare function createRetries(shell: Pick<RuntimeShell, 'retried' | 'succeeded'>): Retries;
29
+ export declare function retrying<T>(retries: Retries, step: Step, instance: string, ask: () => Promise<T>): () => Promise<T>;
@@ -1,3 +1,4 @@
1
+ import { type DefinitionOf } from '../mdmodel/index.js';
1
2
  import type { ProviderRefusal } from './adapter.js';
2
3
  import type { Open } from './open.js';
3
4
  import type { Change, Precondition } from './change.js';
@@ -90,9 +91,9 @@ type ChangedUnderneath = {
90
91
  readonly file?: string | null;
91
92
  };
92
93
  export type ReturnReason = ProviderRefusal & {
93
- readonly kind: Open<'conflicted' | 'rejected' | 'expired' | 'withdrawn'>;
94
+ readonly kind: Open<'conflicted' | 'rejected' | 'withdrawn'>;
94
95
  };
95
- export declare function returnedBy(kind: 'expired' | 'withdrawn'): ReturnReason;
96
+ export declare function returnedBy(): ReturnReason;
96
97
  export type RoomDraft = {
97
98
  readonly room: string;
98
99
  readonly path: string;
@@ -106,8 +107,6 @@ export type RoomDraftWrite = {
106
107
  readonly roomDraft: RoomDraft | null;
107
108
  } | {
108
109
  readonly outcome: 'stale';
109
- readonly code: string;
110
- readonly retryable: boolean;
111
110
  readonly current: RoomDraft | null;
112
111
  };
113
112
  export declare function staleWrite(current: RoomDraft | null): RoomDraftWrite;
@@ -134,6 +133,7 @@ export declare function underneath(parts: HeldParts, path: string, visible: Visi
134
133
  export declare function heldFile(blob: Blob, base: string | null): Promise<HeldFile>;
135
134
  export declare function binaryBase(visible: VisibleLayer | undefined, path: string): string | null;
136
135
  export declare function changedParts(path: string, parts: HeldParts, visible: VisibleLayer | undefined): readonly ChangedPart[];
136
+ export declare function lineEnded(text: string): string;
137
137
  export type TextParts = {
138
138
  readonly fields?: Readonly<Record<string, {
139
139
  readonly value: unknown;
@@ -145,8 +145,8 @@ export type TextParts = {
145
145
  readonly value: string;
146
146
  };
147
147
  };
148
- export declare function partsAfter(markdown: string, parts: TextParts): string;
149
- export declare function returnedInto(existing: HeldParts | undefined, returned: HeldParts): HeldParts;
148
+ export declare function partsAfter(markdown: string, parts: TextParts, definitions?: DefinitionOf): string | null;
149
+ export declare function returnedInto(existing: HeldParts | undefined, returned: HeldParts, definitions?: DefinitionOf): HeldParts | null;
150
150
  export declare function moveTarget(move: {
151
151
  readonly to: string;
152
152
  }): string;
@@ -168,6 +168,5 @@ export declare function changesOf(path: string, parts: HeldParts): {
168
168
  changes: readonly Change[];
169
169
  bases: readonly Precondition[];
170
170
  };
171
- export declare function joinedDraft(carried: SavedDraft, saved: readonly SavedDraft[]): SavedDraft;
172
171
  export declare function withdrawnDrafts(drafts: readonly SavedDraft[], changes: readonly Change[]): readonly SavedDraft[];
173
172
  export {};
@@ -0,0 +1,23 @@
1
+ import { type ChangeSet } from './change-set.js';
2
+ import { type VisibleLayer } from './replica.js';
3
+ import { type RoomDraft, type RoomDraftWrite } from './room-draft.js';
4
+ import type { Runtime } from './runtime.js';
5
+ import type { Store } from './store.js';
6
+ export type RoomDraftSurface = {
7
+ list(): Promise<readonly RoomDraft[]>;
8
+ read(room: string, path: string): Promise<RoomDraft | null>;
9
+ write(room: string, path: string, revision: string | null, parts: unknown, next?: string): Promise<RoomDraftWrite>;
10
+ discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
11
+ };
12
+ export type PresentationSurface = {
13
+ read(app: string): Promise<unknown>;
14
+ write(app: string, value: unknown): Promise<void>;
15
+ edit(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
16
+ };
17
+ export declare function visibleOf(store: Store, locator: string, paths: readonly string[]): Promise<VisibleLayer | undefined>;
18
+ export declare function publishRoomDrafts({ store, socket }: Runtime, waitingOnly: boolean, touched?: ChangeSet['documents'] | null): Promise<void>;
19
+ export declare function emitPresentation({ store, socket }: Runtime, app: string): Promise<void>;
20
+ export declare function roomDraftSurface(runtime: Runtime): RoomDraftSurface;
21
+ export declare function presentationSurface(runtime: Runtime): PresentationSurface;
22
+ export declare function watchRoomDrafts({ store, socket }: Runtime, deliver: (value: unknown) => void): () => void;
23
+ export declare function watchPresentation({ store, socket }: Runtime, app: string, deliver: (value: unknown) => void): () => void;
@@ -0,0 +1,33 @@
1
+ import type { RoomDeclaration, TypedPath } from './adapter.js';
2
+ import type { RuntimeShell } from './durability.js';
3
+ import type { LiveConversations } from './conversation-live.js';
4
+ import type { WriteRule } from './declaration.js';
5
+ import type { FiguresRead } from './figures.js';
6
+ import type { LiveQueries } from './live.js';
7
+ import type { ModelState } from './model.js';
8
+ import type { Presence } from './presence.js';
9
+ import type { ReadAnswers } from './reads.js';
10
+ import type { Recovery } from './recovery.js';
11
+ import type { Retries } from './retried.js';
12
+ import type { RuntimeSocket } from './socket.js';
13
+ import type { HeldCover, Store } from './store.js';
14
+ import type { schemaTypes } from './attached-model.js';
15
+ export type Runtime = {
16
+ readonly store: Store;
17
+ readonly socket: RuntimeSocket;
18
+ readonly presence: Presence;
19
+ readonly recovery: Recovery;
20
+ readonly retries: Retries;
21
+ readonly shell: RuntimeShell;
22
+ readonly localSaves: boolean;
23
+ readonly roomTypes: Parameters<typeof schemaTypes>[1];
24
+ readonly builtIn: ModelState;
25
+ readonly typedPaths: readonly TypedPath[];
26
+ readonly writeRule: (declaration: RoomDeclaration) => WriteRule;
27
+ readonly usableWhenHeld: readonly string[];
28
+ readonly build: string;
29
+ readonly conversations: LiveConversations;
30
+ readonly liveQueries: LiveQueries<HeldCover>;
31
+ readonly figures: FiguresRead;
32
+ readonly lastAnswers: ReadAnswers;
33
+ };
@@ -1,102 +1,58 @@
1
1
  import { type Validation } from '../mdmodel/index.js';
2
- import type { OperationScopes, ProviderLimit } from './adapter.js';
3
- import { type Change, type ChangeBatch, type Precondition, type WrittenBy } from './change.js';
2
+ import type { ProviderLimit } from './adapter.js';
3
+ import { type ChangeBatch, type WrittenBy } from './change.js';
4
4
  import { type Composition } from './collection.js';
5
+ import type { WriteRule } from './declaration.js';
5
6
  import { type Layer } from './overlay.js';
6
- import type { VisibleLayer } from './replica.js';
7
- import type { ChangedPart } from './room-draft.js';
7
+ import type { ReplicaRecord, VisibleLayer } from './replica.js';
8
+ import { type ChangedPart, type RoomDraftRecord, type SavedDraft } from './room-draft.js';
8
9
  export type SaveRefusal = {
9
10
  code: string;
10
11
  retryable: boolean;
11
12
  file?: string;
12
13
  location?: string;
14
+ line?: number;
13
15
  referrers?: readonly string[];
14
16
  parts?: readonly ChangedPart[];
15
17
  };
16
- export type SaveInput = {
17
- local: boolean;
18
- composition: Composition;
19
- baseRoomVersion: string;
20
- operations: import('./adapter.js').OperationScopes;
21
- providerOwnedPaths: readonly string[];
22
- providerLimits: readonly ProviderLimit[];
23
- visible: VisibleLayer;
24
- folders: ReadonlySet<string>;
25
- handle: string;
26
- changes: readonly Change[];
27
- bases: readonly Precondition[];
28
- queued?: ReadonlySet<string>;
29
- writtenBy?: WrittenBy;
30
- unmodeled: boolean;
31
- validate: Validator;
18
+ export type SaveAsk = {
19
+ readonly saved: readonly SavedDraft[];
20
+ readonly consumed: ReadonlySet<string>;
21
+ readonly writtenBy?: WrittenBy;
22
+ readonly local: boolean;
23
+ readonly providerLimits: readonly ProviderLimit[];
32
24
  };
33
- export type Validator = (resulting: Layer, touched: readonly string[]) => Promise<Validation>;
34
- type Refusing = {
35
- kind: 'refused';
36
- refusal: SaveRefusal;
25
+ export type SavingRoom = {
26
+ readonly record: ReplicaRecord;
27
+ readonly rule: WriteRule;
28
+ readonly composition: Composition;
29
+ readonly queue: readonly ChangeBatch[];
30
+ readonly changeable: ReadonlySet<string>;
31
+ readonly saved: ReadonlyMap<string, readonly SavedDraft[]>;
32
+ readonly replay: (queue: readonly ChangeBatch[]) => Generator<number, VisibleLayer, void>;
33
+ readonly folders: ReadonlySet<string>;
34
+ readonly modelled: boolean;
35
+ readonly drafts: ReadonlyMap<string, RoomDraftRecord>;
36
+ readonly validate: Validator;
37
37
  };
38
- export type BatchResult = {
39
- kind: 'batch';
40
- batch: ChangeBatch;
41
- } | Refusing;
42
- export declare function providerRewritten(batch: ChangeBatch, visible: VisibleLayer): Generator<number, ChangeBatch, void>;
43
- export declare function leavingRewritten(batch: ChangeBatch, visible: VisibleLayer): Generator<number, ChangeBatch, void>;
44
- export declare function rewriting(batch: ChangeBatch, locator: string): boolean;
45
- export declare function effectiveIn(batch: ChangeBatch, locator: string, visible: VisibleLayer): Generator<number, ChangeBatch, void>;
46
- export declare function queuedDocuments(queue: readonly ChangeBatch[]): ReadonlySet<string>;
47
- export type Requeued = {
48
- kind: 'requeued';
49
- queue: readonly ChangeBatch[];
50
- changes: readonly Change[];
51
- queued: ReadonlySet<string>;
52
- withdrawn: ReadonlyMap<string, ChangeBatch | null>;
53
- owners: ReadonlySet<string>;
54
- } | {
55
- kind: 'refused';
56
- refusal: SaveRefusal;
38
+ export type PlannedRoom = {
39
+ readonly locator: string;
40
+ readonly queue: readonly ChangeBatch[];
41
+ readonly saved: ReadonlyMap<string, readonly SavedDraft[]>;
42
+ readonly consumed: readonly string[];
43
+ readonly carried: readonly RoomDraftRecord[];
57
44
  };
58
- export type Joining = {
59
- kind: 'joined';
60
- batch: ChangeBatch;
61
- queue: readonly ChangeBatch[];
45
+ export type SavePlan = {
46
+ readonly kind: 'refused';
47
+ readonly refusal: SaveRefusal;
62
48
  } | {
63
- kind: 'refused';
64
- refusal: SaveRefusal;
65
- };
66
- type VisibleOver = (queue: readonly ChangeBatch[]) => Generator<number, VisibleLayer, void>;
67
- export declare function requeuing(queue: readonly ChangeBatch[], changes: readonly Change[], visible: VisibleLayer, changeable: (batch: ChangeBatch) => boolean, state: VisibleOver): Generator<number, Requeued, void>;
68
- export declare function joined(queue: readonly ChangeBatch[], owner: ChangeBatch, extra: ChangeBatch): Joining;
69
- export declare function limiting(queue: readonly ChangeBatch[], batch: ChangeBatch, limits: readonly ProviderLimit[], state: VisibleOver): Generator<number, SaveRefusal | null, void>;
70
- export declare const MOVE_DOCUMENTS = "move-documents";
71
- export type MoveSide = {
72
- room: string;
73
- handle: string;
74
- baseRoomVersion: string;
75
- composition: Composition;
76
- operations: OperationScopes;
77
- providerOwnedPaths: readonly string[];
78
- visible: VisibleLayer;
79
- folders: ReadonlySet<string>;
80
- queued: ReadonlySet<string>;
81
- unmodeled: boolean;
82
- validate: Validator;
49
+ readonly kind: 'planned';
50
+ readonly identifier: string;
51
+ readonly rooms: readonly PlannedRoom[];
83
52
  };
84
- export type MoveInput = {
85
- source: MoveSide;
86
- destination: MoveSide;
87
- moves: readonly {
88
- readonly path: string;
89
- readonly to: string;
90
- }[];
91
- providerLimits: readonly ProviderLimit[];
92
- local: boolean;
93
- writtenBy?: WrittenBy;
94
- };
95
- export type MoveResult = {
96
- kind: 'moved';
97
- leaving: ChangeBatch;
98
- arriving: ChangeBatch;
99
- } | Refusing;
100
- export declare function buildMove(input: MoveInput): Promise<MoveResult>;
101
- export declare function buildBatch(input: SaveInput): Promise<BatchResult>;
102
- export {};
53
+ export type Validator = (resulting: Layer, touched: readonly string[]) => Promise<Validation>;
54
+ export declare function providerRewritten(batch: ChangeBatch, visible: VisibleLayer): Generator<number, ChangeBatch, void>;
55
+ export declare function rewriting(batch: ChangeBatch, locator: string): boolean;
56
+ export declare function effectiveIn(batch: ChangeBatch, locator: string, visible: VisibleLayer): Generator<number, ChangeBatch, void>;
57
+ export declare function destination(locator: string, saved: readonly SavedDraft[]): string | null;
58
+ export declare function planSave(ask: SaveAsk, room: SavingRoom, into?: SavingRoom): Promise<SavePlan>;
@@ -0,0 +1,31 @@
1
+ import { type ChangeBatch, type WrittenBy } from './change.js';
2
+ import { type AttachAnswer, type BinaryLinkAnswer, type HeldBinaryAnswer, type HeldShownAnswer } from './outcome.js';
3
+ import { type RoomDraftParts } from './room-draft.js';
4
+ import type { Runtime } from './runtime.js';
5
+ import { type SaveRefusal } from './save.js';
6
+ import type { Store } from './store.js';
7
+ export type SaveResult = {
8
+ outcome: 'saved';
9
+ identifier: string;
10
+ } | ({
11
+ outcome: 'refused';
12
+ } & SaveRefusal);
13
+ export type SavedRoomDraft = {
14
+ readonly path: string;
15
+ readonly revision: string;
16
+ };
17
+ export type SavedParts = {
18
+ readonly path: string;
19
+ readonly parts: RoomDraftParts;
20
+ };
21
+ export type BinaryFileSurface = {
22
+ read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
23
+ link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
24
+ show(room: string, path: string, revision?: string): Promise<HeldShownAnswer>;
25
+ attach(room: string, file: File): Promise<AttachAnswer>;
26
+ part(file: string, part: number): Promise<Uint8Array | null>;
27
+ };
28
+ export declare function saveRoomDrafts(runtime: Runtime, locator: string, named: readonly SavedRoomDraft[], writtenBy: WrittenBy | undefined): Promise<SaveResult>;
29
+ export declare function saveParts(runtime: Runtime, locator: string, named: readonly SavedParts[], writtenBy: WrittenBy | undefined): Promise<SaveResult>;
30
+ export declare function batchFile(store: Store, batch: ChangeBatch): (localId: string) => Promise<Blob>;
31
+ export declare function binaryFileSurface(runtime: Runtime): BinaryFileSurface;
@@ -1,72 +1,21 @@
1
- import type { ProviderRefusal } from './adapter.js';
2
- import { type CoveredRoom, type Filter, type PendingRoom } from './query.js';
3
- import type { Open } from './open.js';
4
- export type DocumentPart = Open<'fields' | 'sections' | 'preamble' | 'path'>;
1
+ import type { ProviderRefusal, SearchHit } from './adapter.js';
2
+ import type { Failure, Offline } from './outcome.js';
5
3
  export type SearchRequest = {
6
4
  text: string;
7
- documents?: Filter;
8
- collection?: true;
9
- conversations?: readonly string[];
10
- limit?: number;
11
- after?: string;
12
- total?: true;
5
+ rooms?: readonly string[];
13
6
  };
14
- export type MessagePart = Open<'text'>;
15
- export type Snippet<Part extends string> = {
16
- part: Part;
17
- text: string;
18
- at: readonly [number, number];
19
- };
20
- export type DocumentHit = {
21
- room: string;
22
- path: string;
23
- type: string;
24
- score: number;
25
- matches: Readonly<Record<string, readonly DocumentPart[]>>;
26
- snippet?: Snippet<DocumentPart>;
27
- };
28
- export type MessageHit = {
29
- conversation: string;
30
- identity: string;
31
- score: number;
32
- matches: Readonly<Record<string, readonly MessagePart[]>>;
33
- snippet?: Snippet<MessagePart>;
34
- };
35
- export type SearchCoverage = {
36
- rooms: readonly CoveredRoom[];
37
- conversations: readonly string[];
38
- overlay: readonly string[];
7
+ export type { SearchHit } from './adapter.js';
8
+ export type SearchFound = {
9
+ kind: 'found';
10
+ documents: readonly SearchHit[];
39
11
  };
40
- export type SearchHits = {
41
- documents: readonly DocumentHit[];
42
- messages: readonly MessageHit[];
43
- };
44
- export type SearchWindow = SearchHits & {
45
- next?: string;
46
- total?: {
47
- documents: number;
48
- messages: number;
49
- };
50
- };
51
- export type SearchPending = SearchHits & {
52
- pending: readonly PendingRoom[];
53
- coverage: SearchCoverage;
54
- };
55
- export type SearchUndeclared = ProviderRefusal & {
12
+ export type SearchResult = SearchFound | Offline | (ProviderRefusal & {
13
+ kind: 'rejected';
14
+ }) | (ProviderRefusal & {
56
15
  kind: 'undeclared';
57
- };
58
- export type SearchResult = (SearchWindow & {
59
- coverage: SearchCoverage;
60
- }) | SearchPending | SearchUndeclared;
61
- export declare function undeclaredSearch(): SearchUndeclared;
62
- export type HitCursor = readonly [number, string, string] | readonly [] | null;
16
+ }) | Failure;
63
17
  export type SearchPlan = {
64
18
  text: string;
65
- documents: unknown;
66
- collection: boolean;
67
- conversations: readonly string[] | null;
68
- limit: number | null;
69
- after: readonly [HitCursor, HitCursor] | null;
70
- total: boolean;
19
+ rooms: readonly string[] | null;
71
20
  };
72
21
  export declare function searchPlanOf(input: unknown): SearchPlan;
@@ -1,5 +1,9 @@
1
- import type { KeyedResult } from './observation.js';
2
- import type { QueryRows } from './query.js';
1
+ import type { Cover } from './live.js';
2
+ import { type KeyedResult } from './observation.js';
3
+ import type { Plan, QueryRows } from './query.js';
4
+ import type { Deliver } from './reach.js';
5
+ import type { Runtime } from './runtime.js';
6
+ import type { HeldCover, Store } from './store.js';
3
7
  export type EntrySeed = {
4
8
  readonly at: Readonly<Record<string, string>>;
5
9
  readonly queries: readonly {
@@ -11,5 +15,10 @@ export type Seeded = {
11
15
  readonly rows: QueryRows;
12
16
  readonly at: Readonly<Record<string, string>>;
13
17
  };
18
+ type SeededWatch = (coverOf: (cover: Cover, held: HeldCover) => Cover, deliver: (message: unknown) => void) => () => void;
14
19
  export declare function entrySeedOf(value: unknown): EntrySeed | null;
15
20
  export declare function seededResult(seed: Seeded): KeyedResult;
21
+ export declare function seedApplies(runtime: Runtime, plan: Plan, held: HeldCover): Seeded | null;
22
+ export declare function keepEntrySeed(store: Store, entry: EntrySeed): void;
23
+ export declare function watchSeeded(runtime: Runtime, plan: Plan, deliver: Deliver, watch: SeededWatch): () => void;
24
+ export {};
@@ -0,0 +1,6 @@
1
+ export type Admission = {
2
+ heldStream(): Promise<() => void>;
3
+ unqueued(): Promise<void>;
4
+ queued(text: number): () => void;
5
+ };
6
+ export declare function createAdmission(): Admission;
@@ -0,0 +1,5 @@
1
+ export type Answers = {
2
+ awaitingAnswer(locator: string): () => void;
3
+ answered(locator: string): Promise<void> | undefined;
4
+ };
5
+ export declare function createAnswers(): Answers;
@@ -0,0 +1,27 @@
1
+ import type { CallResult } from '../outcome.js';
2
+ export type Live = () => boolean;
3
+ export type KeptSender = {
4
+ next(): Promise<CallResult>;
5
+ };
6
+ type LaneRules = {
7
+ generation(): number;
8
+ continuing(): boolean;
9
+ stopping(): boolean;
10
+ failed(locator: string, error: unknown): void;
11
+ };
12
+ export type Lanes = {
13
+ task(lane: string, work: (live: Live) => Promise<void>): Promise<void>;
14
+ inRoom<T>(locator: string, work: (live: Live) => Promise<T>): Promise<T>;
15
+ roomTask(locator: string, work: (live: Live) => Promise<void>): Promise<void>;
16
+ roomWork(): number;
17
+ current(): Promise<unknown>;
18
+ finished(): Promise<unknown>;
19
+ sender(operation: string): KeptSender | undefined;
20
+ sending(operation: string, sender: KeptSender): void;
21
+ sent(operation: string, sender: KeptSender): void;
22
+ settled(operation: string): Promise<void>;
23
+ settle(operation: string, lost: boolean): void;
24
+ unclaimed(operation: string): boolean;
25
+ };
26
+ export declare function createLanes({ generation, continuing, stopping, failed }: LaneRules): Lanes;
27
+ export {};
@@ -0,0 +1,37 @@
1
+ import type { Authorization, ProviderRefusal, ServiceMode } from '../adapter.js';
2
+ import { type Cell } from '../cell.js';
3
+ import type { Open } from '../open.js';
4
+ import type { CycleProgress, SyncStatus } from '../status.js';
5
+ export type RefusalReason = 'missing-required-guarantee' | 'revoked-authorization';
6
+ export type ConnectionRefusalCode = Open<RefusalReason>;
7
+ export type ConnectionRefusal = {
8
+ code: ConnectionRefusalCode;
9
+ reauthorizationOffered: boolean;
10
+ refusal: ProviderRefusal | null;
11
+ };
12
+ export type Moving = {
13
+ readonly state: SyncStatus['state'];
14
+ readonly providerUnreachable: boolean;
15
+ readonly resting: boolean;
16
+ };
17
+ export type Session = {
18
+ readonly closed: boolean;
19
+ readonly stopping: boolean;
20
+ readonly paused: boolean;
21
+ readonly authorization: Authorization | undefined;
22
+ readonly refusal: ConnectionRefusal | null;
23
+ readonly discoveries: number;
24
+ readonly roomsNamed: boolean;
25
+ readonly roomsListed: boolean;
26
+ readonly serviceMode: ServiceMode;
27
+ readonly haltedRefusal: boolean;
28
+ readonly openSignals: number;
29
+ readonly authorityChanges: number;
30
+ readonly currencyQueued: number | null;
31
+ readonly moving: Moving;
32
+ readonly complete: boolean;
33
+ readonly recorded: boolean;
34
+ readonly underway: CycleProgress | null;
35
+ readonly streamed: CycleProgress | null;
36
+ };
37
+ export declare function createSession(authorization: Authorization | undefined): Cell<Session>;
@@ -0,0 +1,66 @@
1
+ import type { Adapter, Authorization, ConversationEvent, Discovery, HeldRoom, RoomStreamEvent, ServiceMode } from './adapter.js';
2
+ import type { Reads } from './bootstrap.js';
3
+ import type { Cell } from './cell.js';
4
+ import type { Retries } from './retried.js';
5
+ import { type Admission } from './socket/admission.js';
6
+ import { type Answers } from './socket/answers.js';
7
+ import { type Lanes } from './socket/lanes.js';
8
+ import { type Session } from './socket/session.js';
9
+ export type { KeptSender, Live } from './socket/lanes.js';
10
+ export type { ConnectionRefusal, ConnectionRefusalCode, Moving, RefusalReason, } from './socket/session.js';
11
+ type SocketEvent = {
12
+ readonly kind: 'opened';
13
+ } | {
14
+ readonly kind: 'discovered';
15
+ readonly discovery: Discovery;
16
+ readonly missed: boolean;
17
+ } | {
18
+ readonly kind: 'closed';
19
+ readonly revoked: boolean;
20
+ readonly lost: boolean;
21
+ readonly opened: boolean;
22
+ } | Exclude<RoomStreamEvent, {
23
+ kind: 'opened' | 'discovered' | 'closed';
24
+ }>;
25
+ export type RuntimeSocket = Admission & Answers & {
26
+ readonly reads: Reads;
27
+ readonly streamed: boolean;
28
+ readonly session: Cell<Session>;
29
+ readonly lanes: Lanes;
30
+ readonly ready: Promise<void>;
31
+ readonly firstDiscovery: Promise<void>;
32
+ conversations(): Adapter['conversations'];
33
+ search(): Adapter['search'];
34
+ discover(authorized: Authorization): ReturnType<NonNullable<Adapter['discover']>> | undefined;
35
+ follows: Adapter['follows'];
36
+ mutate: Adapter['mutate'];
37
+ binary: Adapter['binary'];
38
+ link: Adapter['link'];
39
+ attach: Adapter['attach'];
40
+ history: Adapter['history'];
41
+ action: Adapter['action'];
42
+ authorize(): Promise<void>;
43
+ observe(listen: (event: SocketEvent) => void): void;
44
+ observeConversations(listen: (event: ConversationEvent) => void): void;
45
+ observeServiceMode(listen: (mode: ServiceMode) => void): void;
46
+ close(): void;
47
+ readyFromStore(): void;
48
+ notifyReady(): void;
49
+ closed(): boolean;
50
+ stopping(): boolean;
51
+ continuing(): boolean;
52
+ reached(): boolean;
53
+ writesHeld(): boolean;
54
+ haltedSince(opens: number): boolean;
55
+ isOpen(): boolean;
56
+ isAnnounced(): boolean;
57
+ isHanded(): boolean;
58
+ generation(): number;
59
+ naming(): boolean;
60
+ hand(rooms: readonly HeldRoom[]): void;
61
+ name(room: HeldRoom): void;
62
+ named(): void;
63
+ abortReads(): void;
64
+ stopReads(): void;
65
+ };
66
+ export declare function createSocket(adapter: Adapter, retries: Retries, authorization: Authorization | undefined): RuntimeSocket;