@agentshouse/app-bridge 0.1.0-c3ebb08f5de71 → 0.1.0-c3ee7fcd01608

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 (123) hide show
  1. package/README.md +7 -7
  2. package/dist/index.d.ts +669 -26
  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 +24 -11
  6. package/dist/mdmodel/document.d.ts +15 -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 +44 -15
  14. package/dist/mdmodel/indexed.d.ts +8 -0
  15. package/dist/mdmodel/kinds.d.ts +20 -0
  16. package/dist/mdmodel/markdown.d.ts +74 -0
  17. package/dist/mdmodel/media-type.d.ts +71 -0
  18. package/dist/mdmodel/moment.d.ts +6 -0
  19. package/dist/mdmodel/not-ready.d.ts +1 -0
  20. package/dist/mdmodel/paths.d.ts +15 -1
  21. package/dist/mdmodel/pattern.d.ts +9 -0
  22. package/dist/mdmodel/query/language.d.ts +254 -0
  23. package/dist/mdmodel/query/match.d.ts +13 -0
  24. package/dist/mdmodel/query/rows.d.ts +31 -0
  25. package/dist/mdmodel/query/sql.d.ts +42 -0
  26. package/dist/mdmodel/query/walk.d.ts +62 -0
  27. package/dist/mdmodel/references.d.ts +2 -2
  28. package/dist/mdmodel/reserved.d.ts +5 -0
  29. package/dist/mdmodel/room-types.d.ts +6 -0
  30. package/dist/mdmodel/types.d.ts +22 -17
  31. package/dist/mdmodel/validate.d.ts +12 -6
  32. package/dist/mdmodel/yaml.d.ts +4 -4
  33. package/dist/mdruntime/actions.d.ts +25 -0
  34. package/dist/mdruntime/adapter.d.ts +211 -112
  35. package/dist/mdruntime/attached-model.d.ts +6 -0
  36. package/dist/mdruntime/authored.d.ts +87 -0
  37. package/dist/mdruntime/bootstrap.d.ts +43 -0
  38. package/dist/mdruntime/cell.d.ts +5 -0
  39. package/dist/mdruntime/chain.d.ts +2 -1
  40. package/dist/mdruntime/change-set.d.ts +4 -0
  41. package/dist/mdruntime/change.d.ts +5 -0
  42. package/dist/mdruntime/client.d.ts +39 -26
  43. package/dist/mdruntime/collection.d.ts +32 -7
  44. package/dist/mdruntime/compile.d.ts +8 -6
  45. package/dist/mdruntime/conversation-live.d.ts +151 -0
  46. package/dist/mdruntime/conversation-row.d.ts +39 -0
  47. package/dist/mdruntime/conversation.d.ts +72 -51
  48. package/dist/mdruntime/declaration.d.ts +9 -0
  49. package/dist/mdruntime/durability.d.ts +20 -1
  50. package/dist/mdruntime/failure.d.ts +3 -0
  51. package/dist/mdruntime/figures.d.ts +48 -0
  52. package/dist/mdruntime/holdings.d.ts +28 -0
  53. package/dist/mdruntime/house-query.d.ts +14 -0
  54. package/dist/mdruntime/identity.d.ts +0 -1
  55. package/dist/mdruntime/install.d.ts +59 -0
  56. package/dist/mdruntime/listing.d.ts +59 -0
  57. package/dist/mdruntime/live.d.ts +24 -0
  58. package/dist/mdruntime/media.d.ts +24 -0
  59. package/dist/mdruntime/messages.d.ts +35 -5
  60. package/dist/mdruntime/modal.d.ts +1 -0
  61. package/dist/mdruntime/model.d.ts +12 -13
  62. package/dist/mdruntime/observation.d.ts +31 -13
  63. package/dist/mdruntime/opened.d.ts +1 -1
  64. package/dist/mdruntime/outcome.d.ts +30 -7
  65. package/dist/mdruntime/overlay.d.ts +7 -2
  66. package/dist/mdruntime/preparation.d.ts +45 -0
  67. package/dist/mdruntime/presence.d.ts +57 -0
  68. package/dist/mdruntime/query.d.ts +14 -210
  69. package/dist/mdruntime/reach.d.ts +26 -14
  70. package/dist/mdruntime/readiness.d.ts +23 -22
  71. package/dist/mdruntime/reads.d.ts +38 -0
  72. package/dist/mdruntime/recovery.d.ts +4 -0
  73. package/dist/mdruntime/refresh.d.ts +26 -0
  74. package/dist/mdruntime/replica.d.ts +13 -19
  75. package/dist/mdruntime/retried.d.ts +29 -0
  76. package/dist/mdruntime/room-draft.d.ts +51 -12
  77. package/dist/mdruntime/room-drafts.d.ts +23 -0
  78. package/dist/mdruntime/runtime.d.ts +34 -0
  79. package/dist/mdruntime/save.d.ts +42 -84
  80. package/dist/mdruntime/saves.d.ts +33 -0
  81. package/dist/mdruntime/search.d.ts +12 -63
  82. package/dist/mdruntime/seed.d.ts +11 -2
  83. package/dist/mdruntime/socket/admission.d.ts +6 -0
  84. package/dist/mdruntime/socket/answers.d.ts +5 -0
  85. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  86. package/dist/mdruntime/socket/session.d.ts +40 -0
  87. package/dist/mdruntime/socket.d.ts +67 -0
  88. package/dist/mdruntime/source.d.ts +58 -0
  89. package/dist/mdruntime/status.d.ts +4 -5
  90. package/dist/mdruntime/store/installs.d.ts +29 -0
  91. package/dist/mdruntime/store/readiness.d.ts +10 -0
  92. package/dist/mdruntime/store/records.d.ts +226 -0
  93. package/dist/mdruntime/store/room-held.d.ts +7 -0
  94. package/dist/mdruntime/store/rooms-shown.d.ts +7 -0
  95. package/dist/mdruntime/store/space.d.ts +10 -0
  96. package/dist/mdruntime/store/watchers.d.ts +16 -0
  97. package/dist/mdruntime/store/writes.d.ts +23 -0
  98. package/dist/mdruntime/store.d.ts +114 -156
  99. package/dist/mdruntime/stored.d.ts +87 -58
  100. package/dist/mdruntime/surface.d.ts +93 -0
  101. package/dist/mdruntime/tables.d.ts +129 -107
  102. package/dist/mdruntime/tallies.d.ts +17 -0
  103. package/dist/mdruntime/transfer.d.ts +0 -5
  104. package/dist/mdruntime/wire.d.ts +88 -13
  105. package/dist/session-content/check.d.ts +17 -0
  106. package/dist/session-content/index.d.ts +6 -0
  107. package/dist/session-content/parts.d.ts +30 -0
  108. package/dist/session-content/state.d.ts +59 -0
  109. package/dist/session-content/turn.d.ts +137 -0
  110. package/dist/test-host.d.ts +8 -4
  111. package/dist/test-host.js +46 -29
  112. package/docs/families.md +108 -84
  113. package/package.json +2 -2
  114. package/dist/calls.d.ts +0 -1007
  115. package/dist/calls.js +0 -1
  116. package/dist/mdmodel/blocks.d.ts +0 -10
  117. package/dist/mdmodel/condition.d.ts +0 -160
  118. package/dist/mdmodel/links.d.ts +0 -28
  119. package/dist/mdmodel/profile.d.ts +0 -5
  120. package/dist/mdruntime/connection.d.ts +0 -151
  121. package/dist/mdruntime/file.d.ts +0 -11
  122. package/dist/mdruntime/fulltext.d.ts +0 -26
  123. package/dist/mdruntime/shared.d.ts +0 -15
@@ -1,3 +1,4 @@
1
+ import type { ProviderRefusal } from './adapter.js';
1
2
  export type RuntimeError = Error & {
2
3
  readonly code: string;
3
4
  readonly retryable: boolean;
@@ -8,5 +9,7 @@ export type Described = {
8
9
  retryable: boolean;
9
10
  };
10
11
  export declare function runtimeError(code: string, message?: string, retryable?: boolean): RuntimeError;
12
+ export declare function refusalError(refusal: ProviderRefusal): RuntimeError;
11
13
  export declare function failed(error: unknown): RuntimeError;
14
+ export declare function uncaught(error: unknown): void;
12
15
  export declare function described(error: unknown): Described;
@@ -0,0 +1,48 @@
1
+ import type { ChangeSet } from './change-set.js';
2
+ import type { GroupTotal, PendingResult } from './query.js';
3
+ import type { Deliver, Fail } from './reach.js';
4
+ import type { ConversationTally, RoomTally } from './tallies.js';
5
+ import type { QueryRoom } from './tables.js';
6
+ export declare const HOUSE_DIRECTORY = "house";
7
+ export declare const ROOM_TOTALS: {
8
+ readonly outside: readonly ["house"];
9
+ readonly groupBy: readonly ["room"];
10
+ readonly select: {
11
+ readonly size: true;
12
+ };
13
+ };
14
+ export declare const FIGURES_DAY_MS = 86400000;
15
+ export type DayFigures = {
16
+ readonly created: number;
17
+ readonly changed: number;
18
+ readonly chats: number;
19
+ readonly messages: number;
20
+ };
21
+ export type RoomFigures = {
22
+ readonly room: string;
23
+ readonly day: DayFigures;
24
+ readonly total: {
25
+ readonly documents: GroupTotal;
26
+ readonly files: GroupTotal;
27
+ };
28
+ };
29
+ export type Figures = {
30
+ readonly rooms: readonly RoomFigures[];
31
+ readonly agentMessages: number;
32
+ };
33
+ export type FiguresResult = Figures | PendingResult;
34
+ export type FiguresCover = PendingResult | {
35
+ readonly rooms: readonly QueryRoom[];
36
+ };
37
+ export type FiguresSources = {
38
+ cover(): Promise<FiguresCover>;
39
+ rooms(rooms: readonly QueryRoom[], since: string): Promise<readonly RoomTally[]>;
40
+ conversations(conversations: readonly string[] | null, since: string): Promise<readonly ConversationTally[]>;
41
+ };
42
+ export type FiguresRead = {
43
+ watch(deliver: Deliver, fail: Fail): () => void;
44
+ touched(set: ChangeSet): void;
45
+ recover(): void;
46
+ close(): void;
47
+ };
48
+ export declare function createFigures(sources: FiguresSources): FiguresRead;
@@ -0,0 +1,28 @@
1
+ import type { AppCode } from './durability.js';
2
+ import type { GroupTotal, PendingResult } from './query.js';
3
+ import type { Deliver, Fail } from './reach.js';
4
+ import type { Runtime } from './runtime.js';
5
+ import type { OpenedRoom } from './tables.js';
6
+ export type RoomDocuments = {
7
+ readonly room: string;
8
+ readonly documents: GroupTotal;
9
+ };
10
+ export type HeldApp = ({
11
+ readonly app: string;
12
+ readonly state: 'measured';
13
+ } & AppCode) | {
14
+ readonly app: string;
15
+ readonly state: 'asking' | 'unknown';
16
+ };
17
+ export type Holdings = {
18
+ readonly rooms: readonly RoomDocuments[] | PendingResult;
19
+ readonly opened: GroupTotal & {
20
+ readonly rooms: readonly OpenedRoom[];
21
+ };
22
+ readonly apps: readonly HeldApp[];
23
+ readonly house: number | null;
24
+ readonly total: number | null;
25
+ readonly cleanUp: number | null;
26
+ };
27
+ export declare const CLEANED_TOPIC = "cleaned";
28
+ export declare function watchHoldings({ store, figures, shell }: Runtime, deliver: Deliver, fail: Fail): () => void;
@@ -0,0 +1,14 @@
1
+ import { type DocumentQuery, type GroupQuery } from '../mdmodel/index.js';
2
+ import type { HouseQueryGroups, HouseQueryRows, ProviderRefusal } from './adapter.js';
3
+ import { type Failure, type Offline } from './outcome.js';
4
+ import { type PortReach } from './reach.js';
5
+ import type { Runtime } from './runtime.js';
6
+ export type HouseQuery = (DocumentQuery | GroupQuery) & {
7
+ rooms: readonly [string];
8
+ };
9
+ export type HouseQueryResult = HouseQueryRows | HouseQueryGroups | Offline | (ProviderRefusal & {
10
+ kind: 'rejected';
11
+ }) | (ProviderRefusal & {
12
+ kind: 'undeclared';
13
+ }) | Failure;
14
+ export declare function queriedHouse(runtime: Runtime, input: unknown, reach: PortReach | null): Promise<HouseQueryResult>;
@@ -1,5 +1,4 @@
1
1
  export declare function changeBatchIdentity(at?: number): string;
2
- export declare function identityTime(identity: string): number;
3
2
  export declare function roomDraftRevision(): string;
4
3
  export declare function chatDraftRevision(): string;
5
4
  export declare function transferIdentity(): string;
@@ -0,0 +1,59 @@
1
+ import type { AdapterFailure, Authorization, DiscoveredRoom, NotReady, RetryableRefusal } from './adapter.js';
2
+ import { type Reads } from './bootstrap.js';
3
+ import type { Installation, InstallationAmount, RoomCoverage } from './readiness.js';
4
+ import { advancement, type Refresher } from './refresh.js';
5
+ import type { ReplicaRecord } from './replica.js';
6
+ import type { Runtime } from './runtime.js';
7
+ import type { Live } from './socket.js';
8
+ import { type CoveredRoom, type InstallHold, type RuntimeStore, type Store } from './store.js';
9
+ import { type Unconfirmed } from './transfer.js';
10
+ type Standing = {
11
+ readonly key: number | null;
12
+ readonly confirmed: number;
13
+ };
14
+ export type Unheld = {
15
+ readonly staged: boolean;
16
+ };
17
+ export type Withheld = AdapterFailure | RetryableRefusal | NotReady | Unconfirmed;
18
+ type Landing = {
19
+ readonly kind: 'refreshed';
20
+ readonly from: Standing;
21
+ readonly remodelled: boolean;
22
+ } | {
23
+ readonly kind: 'bootstrapped';
24
+ readonly refreshed: boolean;
25
+ readonly from: Standing;
26
+ };
27
+ type Refreshed = {
28
+ kind: 'advanced';
29
+ record: ReplicaRecord;
30
+ from: Standing;
31
+ remodelled: boolean;
32
+ } | Exclude<Awaited<ReturnType<typeof advancement>>, {
33
+ kind: 'advanced';
34
+ }>;
35
+ export declare const ERASE_BATCH = 512;
36
+ export type InstallShare = {
37
+ readonly installing: boolean;
38
+ readonly downloading: boolean;
39
+ readonly bytes: InstallationAmount;
40
+ };
41
+ export declare function installShare(store: Store, { room, state }: RoomCoverage, held: ReadonlyMap<string, CoveredRoom>): InstallShare;
42
+ export declare function installationOf(installing: number, downloading: number, bytes: InstallationAmount): Installation;
43
+ export declare function roomInFlight(store: Store, locator: string): boolean;
44
+ export declare function sweep({ store, socket }: Runtime): void;
45
+ export declare function caughtUpTo(runtime: Runtime, locator: string): void;
46
+ export declare function catching(store: Store, locator: string): void;
47
+ export declare function standingAt(store: Store, locator: string, held: Pick<ReplicaRecord, 'key'> | undefined): Standing;
48
+ export declare function showing(system: Runtime, locator: string, roomVersion: string, held: string | undefined): void;
49
+ export declare function olderThan(system: Runtime, locator: string, roomVersion: string, held: string | undefined): boolean;
50
+ export declare function replaced(store: Store, locators: readonly string[]): void;
51
+ export declare function reachedBy({ store, socket }: Runtime, locator: string, roomVersion: string): Promise<boolean>;
52
+ export declare function behind({ store, socket }: Runtime, room: DiscoveredRoom): Promise<boolean>;
53
+ export declare function writtenAfter({ store, socket }: Runtime, locator: string, roomVersion: string, path: string): Promise<boolean>;
54
+ export declare function pullRefresh(runtime: Runtime, authorized: Authorization, record: ReplicaRecord, liveness: Live, hold: InstallHold, refresh: Refresher): Promise<Refreshed>;
55
+ export declare function pullBootstrap(runtime: Runtime, authorized: Authorization, room: DiscoveredRoom, local: RuntimeStore, liveness: Live, prior: ReplicaRecord | undefined, from?: Reads, unheld?: Unheld): Promise<import("./bootstrap.js").Bootstrapped | NotReady | import("./adapter.js").RevokedAuthorization | import("./adapter.js").RoomNotReadable | import("./adapter.js").TransportUncertainty | Unconfirmed | {
56
+ readonly kind: 'transport-uncertainty';
57
+ } | RetryableRefusal | import("./adapter.js").ScopedRefusal>;
58
+ export declare function publish(runtime: Runtime, local: RuntimeStore, room: DiscoveredRoom, reached: ReplicaRecord, landing: Landing, live: Live): Promise<boolean>;
59
+ export {};
@@ -0,0 +1,59 @@
1
+ import type { HeldRooms } from '../mdmodel/index.js';
2
+ import type { DiscoveredRoom, HeldRoom, OperationScopes, ProviderRefusal, ReplicaAdmission, RoomDeclaration } from './adapter.js';
3
+ import { type Composition } from './collection.js';
4
+ import type { KeyedChange } from './observation.js';
5
+ import { type MdType, type ModelState, type TypesResult } from './model.js';
6
+ import { type PortReach } from './reach.js';
7
+ import type { ReplicaRecord } from './replica.js';
8
+ import type { Runtime } from './runtime.js';
9
+ import type { Stored } from './store.js';
10
+ type Selection<Model> = {
11
+ roots: readonly string[];
12
+ model: Model;
13
+ };
14
+ type Shown<Model> = {
15
+ name: string;
16
+ locator: string;
17
+ handle: string;
18
+ operations: OperationScopes;
19
+ replica: ReplicaAdmission;
20
+ model: Model;
21
+ typedSelection: Selection<Model> | null;
22
+ providerOwnedPaths: readonly string[];
23
+ authoredPaths: readonly string[];
24
+ roomVersion: string | null;
25
+ documents: number;
26
+ synchronizationAvailable: boolean;
27
+ refusal: ProviderRefusal | null;
28
+ locked: boolean;
29
+ queriesOnly?: true;
30
+ };
31
+ export type AppTypedSelection = Selection<TypesResult>;
32
+ export type AppRoom = Shown<TypesResult>;
33
+ export type ListedRoom = Shown<TypesResult<string>>;
34
+ export type ListedModels = Readonly<Record<string, readonly MdType[]>>;
35
+ export type ListedRooms = {
36
+ readonly rooms: readonly ListedRoom[];
37
+ readonly models: ListedModels;
38
+ };
39
+ export type ListedEntry = Omit<Shown<ModelState>, 'locked'>;
40
+ export type Listing = ReadonlyMap<string, ListedEntry>;
41
+ export type RoomsChange = KeyedChange<string, ListedRoom> & {
42
+ readonly models: ListedModels;
43
+ };
44
+ export declare function modelIn({ socket, presence }: Runtime, locator: string, stored: Stored | undefined): ModelState;
45
+ export declare function compositionFor(runtime: Runtime, record: ReplicaRecord): Composition;
46
+ export declare function declarationOf({ presence }: Runtime, locator: string, stored: Stored | undefined): {
47
+ readonly room: RoomDeclaration;
48
+ readonly available: boolean;
49
+ } | undefined;
50
+ export declare function listedLocators({ presence }: Runtime, held: ReadonlyMap<string, unknown>): string[];
51
+ export declare function listedOrHeld({ presence }: Runtime, held: ReadonlyMap<string, unknown>, locator: string): boolean;
52
+ export declare function listedEntries(runtime: Runtime, touched: readonly string[]): Promise<readonly ListedEntry[] | null>;
53
+ export declare function listingNow(runtime: Runtime): Promise<Listing>;
54
+ export declare function shownRooms(runtime: Runtime, listing: Listing): ListedRooms;
55
+ export declare function shownChange(runtime: Runtime, entries: readonly ListedEntry[]): RoomsChange;
56
+ export declare function roomFacts(runtime: Runtime, reach?: PortReach | null): Promise<HeldRooms>;
57
+ export declare function heldRooms({ store }: Runtime, listed: readonly DiscoveredRoom[]): Promise<HeldRoom[]>;
58
+ export declare function name(runtime: Runtime, locator: string): Promise<void>;
59
+ export {};
@@ -0,0 +1,24 @@
1
+ import type { ChangeSet } from './change-set.js';
2
+ import { type KeyedResult, type QueryMessage } from './observation.js';
3
+ import type { PendingResult, PendingRoom, Plan, QueryCoverage } from './query.js';
4
+ import type { Fail } from './reach.js';
5
+ import type { QueryRoom } from './tables.js';
6
+ export type Cover = {
7
+ coverage: QueryCoverage;
8
+ rooms: readonly QueryRoom[];
9
+ } | PendingResult;
10
+ export type Ran = KeyedResult & {
11
+ readonly current: () => boolean;
12
+ };
13
+ export type Run = (plan: Plan, cover: () => Promise<Cover>) => Promise<Ran>;
14
+ export type PendingAt<H> = (held: H, rooms: readonly string[]) => ReadonlyMap<string, PendingRoom | null> | null;
15
+ type Listener = (message: QueryMessage) => void;
16
+ export type LiveQueries<H> = {
17
+ touched(set: ChangeSet): void;
18
+ recover(locators?: readonly string[]): void;
19
+ watch(plan: Plan, identity: string, cover: (held: H) => Cover, pendingAt: PendingAt<H>, deliver: Listener, failed: Fail): () => void;
20
+ close(): void;
21
+ };
22
+ export declare function readerOf(plan: Plan): (locator: string) => boolean;
23
+ export declare function createLiveQueries<H>(run: Run, holding: () => Promise<H>): LiveQueries<H>;
24
+ export {};
@@ -0,0 +1,24 @@
1
+ import type { MdRuntimeClient } from './client.js';
2
+ import { type DownloadAnswer, type ShownAnswer } from './outcome.js';
3
+ export declare const ROOM_MEDIA = "room-media";
4
+ export declare const KEYED_MEDIA = "ahc-attachment";
5
+ export declare const MEDIA = "room-media, ahc-attachment";
6
+ export declare const DIAGRAM = "md-diagram";
7
+ export declare const VIEWING = "ahc-viewer";
8
+ type Show = (room: string, path: string, revision?: string) => Promise<ShownAnswer>;
9
+ export type MediaAt = {
10
+ readonly link: string;
11
+ } | {
12
+ readonly room: string;
13
+ readonly path: string;
14
+ readonly revision: string | undefined;
15
+ };
16
+ export declare function shownBy(show: Show, client: MdRuntimeClient): MdRuntimeClient;
17
+ export declare function mediaAt(media: Element): MediaAt | null;
18
+ export declare function mediaTag(at: MediaAt): string;
19
+ export declare function downloadAt(client: MdRuntimeClient, at: MediaAt): Promise<DownloadAnswer>;
20
+ export declare function rendered(element: Element): boolean;
21
+ export declare function viewable(element: Element): boolean;
22
+ export declare function viewFile(client: MdRuntimeClient, media: Element): void;
23
+ export declare function defineRoomMedia(client: Promise<MdRuntimeClient> | MdRuntimeClient): void;
24
+ export {};
@@ -1,6 +1,7 @@
1
1
  import type { AcceptedMessage } from './adapter.js';
2
2
  import type { Connection } from './tables.js';
3
3
  export declare const MESSAGE_TABLES: readonly string[];
4
+ export declare const ROWS = "WITH chosen AS (\n SELECT listed.value AS conversation,\n (SELECT id FROM conversation_messages WHERE conversation = listed.value AND json_extract(message, '$.role') = 'assistant' ORDER BY position DESC, identity DESC LIMIT 1) AS answer,\n (SELECT id FROM conversation_messages WHERE conversation = listed.value AND text <> '' ORDER BY position DESC, identity DESC LIMIT 1) AS said,\n (SELECT id FROM conversation_messages WHERE conversation = listed.value AND json_extract(message, '$.role') = 'house' ORDER BY position, identity LIMIT 1) AS opened,\n (SELECT id FROM conversation_messages WHERE conversation = listed.value AND json_extract(message, '$.role') = 'house' AND json_extract(message, '$.waiting') = 1 ORDER BY position, identity LIMIT 1) AS asking\n FROM json_each(?) AS listed\n )\n SELECT chosen.conversation AS conversation,\n substr(said.text, 1, 512) AS said_text,\n json_extract(said.message, '$.role') AS said_role,\n json_extract(said.message, '$.accepted_at') AS said_at,\n answer.turn AS answered,\n substr(json_extract(answer.message, '$.failure'), 1, 512) AS failure,\n COALESCE(\n (SELECT value FROM conversation_facts WHERE conversation = chosen.conversation AND name = 'openedTurn'),\n CASE WHEN julianday(json_extract(answer.message, '$.accepted_at')) < (SELECT julianday(json_extract(value, '$')) FROM replica_facts WHERE name = 'readUntil') THEN answer.turn END\n ) AS opened_turn,\n json_extract(opened.message, '$.source') AS opened_source,\n json_extract(opened.message, '$.sender') AS opened_sender,\n asking.identity AS asking_identity,\n asking.text AS asking_text,\n json_extract(asking.message, '$.accepted_at') AS asking_at,\n json_extract(asking.message, '$.source') AS asking_source,\n json_extract(asking.message, '$.sender') AS asking_sender\n FROM chosen\n LEFT JOIN conversation_messages said ON said.id = chosen.said\n LEFT JOIN conversation_messages answer ON answer.id = chosen.answer\n LEFT JOIN conversation_messages opened ON opened.id = chosen.opened\n LEFT JOIN conversation_messages asking ON asking.id = chosen.asking";
4
5
  export type HeldConversation = {
5
6
  readonly conversation: string;
6
7
  readonly read: string | null | undefined;
@@ -10,6 +11,33 @@ export type MessageWindow = {
10
11
  readonly messages: AcceptedMessage[];
11
12
  readonly more: boolean;
12
13
  };
14
+ export type HeldSource = {
15
+ readonly source: unknown;
16
+ readonly sender: string | null;
17
+ };
18
+ export type HeldRow = {
19
+ readonly conversation: string;
20
+ readonly said: {
21
+ readonly text: string;
22
+ readonly role: string | null;
23
+ readonly at: string | null;
24
+ } | null;
25
+ readonly answered: string | null;
26
+ readonly openedTurn: string | null;
27
+ readonly failure: string | null;
28
+ readonly opened: HeldSource | null;
29
+ readonly asking: (HeldSource & {
30
+ readonly identity: string;
31
+ readonly text: string;
32
+ readonly at: string | null;
33
+ }) | null;
34
+ };
35
+ export type ConversationFact = 'openedTurn' | 'dismissedSuggestion';
36
+ export type HeldFact = {
37
+ readonly conversation: string;
38
+ readonly name: ConversationFact;
39
+ readonly value: string;
40
+ };
13
41
  export type ConversationWrite = {
14
42
  readonly conversation: string;
15
43
  readonly messages: readonly AcceptedMessage[];
@@ -18,10 +46,12 @@ export type ConversationWrite = {
18
46
  readonly partial: boolean;
19
47
  };
20
48
  };
21
- export declare function heldConversations(connection: Connection): HeldConversation[];
49
+ export declare function heldConversations(connection: Connection, conversations: readonly string[] | null): HeldConversation[];
22
50
  export declare function keptMessages(connection: Connection, { conversation, messages, read }: ConversationWrite): null;
23
- export declare function messageWindow(connection: Connection, conversation: string, limit: number, before: readonly [string, string] | null): MessageWindow;
24
- export declare function messageCount(connection: Connection, conversation: string): number;
51
+ export declare function messageWindow(connection: Connection, conversation: string, limit: number, before: readonly [string, string] | null, phrase: string | null): MessageWindow;
52
+ export declare function messageCount(connection: Connection, conversation: string, phrase: string | null): number;
53
+ export declare function conversationRows(connection: Connection, conversations: readonly string[]): HeldRow[];
25
54
  export declare function turnArrived(connection: Connection, conversation: string, turn: string): boolean;
26
- export declare function droppedMessages(connection: Connection, conversations: readonly string[]): void;
27
- export declare function forgottenMessages(connection: Connection): void;
55
+ export declare function conversationFacts(connection: Connection): HeldFact[];
56
+ export declare function keptFact(connection: Connection, { conversation, name, value }: HeldFact): null;
57
+ export declare function forgottenConversations(connection: Connection): void;
@@ -0,0 +1 @@
1
+ export declare function shownModal(dialog: HTMLDialogElement): void;
@@ -1,4 +1,4 @@
1
- import type { Definition, ValueFacts, VerifiedModel } from '../mdmodel/index.js';
1
+ import type { Definition, VerifiedModel } from '../mdmodel/index.js';
2
2
  import type { Open } from './open.js';
3
3
  export type ModelIdentity = {
4
4
  identity: string;
@@ -8,7 +8,7 @@ export type ModelSnapshot = ModelIdentity & {
8
8
  schema: string | null;
9
9
  revision: string | null;
10
10
  };
11
- export type ModelUnavailableReason = Open<'not-readable' | 'revoked' | 'not-acquired' | 'invalid'>;
11
+ export type ModelUnavailableReason = Open<'not-readable' | 'revoked' | 'not-acquired'>;
12
12
  export type ModelResult = {
13
13
  kind: 'model';
14
14
  snapshot: ModelSnapshot;
@@ -20,26 +20,27 @@ export type MdType = Definition;
20
20
  export type ModelState = {
21
21
  status: 'unavailable';
22
22
  reason: ModelUnavailableReason;
23
- schema?: string | null;
24
- revision?: string | null;
25
23
  } | {
26
24
  status: 'current' | 'cached';
27
25
  snapshot: ModelSnapshot;
28
26
  verifiedWith: ModelIdentity;
29
27
  types: VerifiedModel['types'];
30
28
  };
31
- export type TypesResult = {
29
+ export type StoredModel = Extract<ModelState, {
30
+ status: 'unavailable';
31
+ }> | Omit<Extract<ModelState, {
32
+ status: 'current' | 'cached';
33
+ }>, 'types'>;
34
+ export type TypesResult<Types = readonly MdType[]> = {
32
35
  status: Open<'unavailable'>;
33
36
  reason: ModelUnavailableReason;
34
37
  types: null;
35
- schema?: string | null;
36
- revision?: string | null;
37
38
  } | {
38
39
  status: Open<'current' | 'cached'>;
39
40
  identity: string;
40
41
  version: string;
41
42
  verifiedWith: ModelIdentity;
42
- types: readonly MdType[];
43
+ types: Types;
43
44
  schema: string | null;
44
45
  revision: string | null;
45
46
  };
@@ -49,9 +50,7 @@ export type ValidationReceipt = {
49
50
  source: Open<'current' | 'cached'>;
50
51
  };
51
52
  export declare const NO_MODEL: ModelState;
52
- export declare function definitionOf(state: ModelState, type: string | undefined): Definition | undefined;
53
+ export declare function sortedTypes(types: VerifiedModel['types']): readonly MdType[];
53
54
  export declare function modelTypes(state: ModelState): TypesResult;
54
- export declare function cached(state: ModelState): ModelState;
55
- export declare function sameModel(left: ModelIdentity, right: ModelIdentity): boolean;
56
- export declare function sameTyping(left: ModelState, right: ModelState): boolean;
57
- export declare function referenceField(facts: ValueFacts | undefined): boolean;
55
+ export declare function modelResult<Types>(state: ModelState, types: (held: VerifiedModel['types']) => Types): TypesResult<Types>;
56
+ export declare function storedModel(state: ModelState): StoredModel;
@@ -1,4 +1,6 @@
1
- import type { QueryCoverage, QueryDocument, QueryGroup, QueryResult } from './query.js';
1
+ import type { PendingRoom, QueryCoverage, QueryDocument, QueryGroup, QueryResult } from './query.js';
2
+ import type { ReadinessShown, RoomCoverage } from './readiness.js';
3
+ import type { AppRoom, ListedRooms } from './listing.js';
2
4
  export type Observation<T> = {
3
5
  current(): T;
4
6
  subscribe(listener: (value: T) => void): () => void;
@@ -9,15 +11,24 @@ export type KeyedResult = {
9
11
  result: QueryResult;
10
12
  keys: readonly RowKey[];
11
13
  };
12
- export type QueryChange = {
13
- changed: readonly (readonly [RowKey, QueryDocument | QueryGroup])[];
14
- removed: readonly RowKey[];
15
- order: readonly RowKey[] | null;
14
+ export type KeyedChange<K, T> = {
15
+ readonly changed: readonly (readonly [K, T])[];
16
+ readonly removed: readonly K[];
17
+ readonly order: readonly K[] | null;
18
+ };
19
+ export type QueryChange = KeyedChange<RowKey, QueryDocument | QueryGroup> & {
16
20
  coverage?: QueryCoverage;
17
21
  next?: string | null;
18
22
  total?: number;
19
23
  };
20
- export type QueryMessage = KeyedResult | QueryChange;
24
+ export type ReadinessChange = {
25
+ readonly shown: ReadinessShown;
26
+ readonly rooms: KeyedChange<string, RoomCoverage>;
27
+ };
28
+ export type PendingChange = {
29
+ readonly pending: KeyedChange<string, PendingRoom>;
30
+ };
31
+ export type QueryMessage = KeyedResult | QueryChange | PendingChange;
21
32
  export type Observed = {
22
33
  observation: Observation<unknown>;
23
34
  receive(message: unknown): void;
@@ -25,19 +36,26 @@ export type Observed = {
25
36
  };
26
37
  export declare function rowsOf(result: QueryResult): readonly (QueryDocument | QueryGroup)[];
27
38
  export declare function whole(message: QueryMessage): message is KeyedResult;
28
- export declare function applied(keyed: KeyedResult, message: QueryMessage): KeyedResult;
29
- export declare function observed(first: unknown, stop: () => void, keyed: boolean): Observed;
30
- export declare function opened(watch: (deliver: (message: unknown) => void) => () => void, keyed: boolean): Promise<Observation<unknown>>;
31
- export declare function observing<Topic extends string>(watch: (topic: Topic, input: readonly unknown[], deliver: (message: unknown) => void) => () => void): (topic: Topic, ...input: unknown[]) => Promise<Observation<unknown>>;
39
+ export declare function pendingChange(message: QueryMessage): message is PendingChange;
40
+ export declare function unchanged(change: KeyedChange<unknown, unknown>): boolean;
41
+ export declare function keyedChange<K, H, T>(held: ReadonlyMap<K, H>, keys: readonly K[], rows: readonly T[], same: (was: H, now: T) => boolean): KeyedChange<K, T>;
42
+ export declare function keyedAt<K, H, T>(held: ReadonlyMap<K, H>, at: ReadonlyMap<K, T | null>, same: (was: H, now: T) => boolean): KeyedChange<K, T> | null;
43
+ export declare function keyedInto<K, T>(held: Map<K, T>, change: KeyedChange<K, T>): void;
44
+ export declare function samePending(was: PendingRoom, now: PendingRoom): boolean;
45
+ export declare function appRooms({ rooms, models }: ListedRooms): readonly AppRoom[];
46
+ export declare function replaces(topic: string, message: unknown): boolean;
47
+ export declare function observed(first: unknown, stop: () => void, topic: string): Observed;
48
+ export declare function opened(watch: (deliver: (message: unknown) => void, fail: (error: unknown) => void) => () => void, topic: string): Promise<Observation<unknown>>;
49
+ export declare function observing<Topic extends string>(watch: (topic: Topic, input: readonly unknown[], deliver: (message: unknown) => void, fail: (error: unknown) => void) => () => void): (topic: Topic, ...input: unknown[]) => Promise<Observation<unknown>>;
32
50
  export type Digest = {
33
- readonly pending: string;
51
+ readonly pending: Map<string, PendingRoom>;
34
52
  } | {
35
- readonly keys: readonly RowKey[];
36
- readonly rows: ReadonlyMap<RowKey, number>;
53
+ readonly rows: Map<RowKey, number>;
37
54
  readonly coverage: string;
38
55
  readonly next: string | undefined;
39
56
  readonly total: number | undefined;
40
57
  };
58
+ export declare function hashed(text: string): number;
41
59
  export declare function digestOf({ result, keys }: KeyedResult): Digest;
42
60
  export declare function digestApplied(digest: Digest, message: QueryMessage): Digest;
43
61
  export declare function changeOf(previous: Digest, next: KeyedResult): QueryMessage | null;
@@ -18,4 +18,4 @@ export type OpenedFiles = {
18
18
  find(name: OpenedName): Promise<KeptBinary | null>;
19
19
  fetch(name: OpenedName, read: () => Promise<BinaryResult>): Promise<KeptResult>;
20
20
  };
21
- export declare function openedFiles(database: RuntimeDatabase, fenced: (locator: string) => boolean): OpenedFiles;
21
+ export declare function openedFiles(database: RuntimeDatabase, lost: (locator: string) => boolean): OpenedFiles;
@@ -1,5 +1,6 @@
1
- import type { ActionResult, AdapterFailure, BinaryLinkResult, HistoryResult, HistoryRevision, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
1
+ import type { ActionResult, AdapterFailure, AttachResult, BinaryLinkResult, HistoryResult, HistoryRevision, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
2
2
  import type { ChangeBatch } from './change.js';
3
+ import type { Attempt, Retries } from './retried.js';
3
4
  import type { KeptBinary, KeptResult } from './opened.js';
4
5
  type Refused<Kind extends string> = ProviderRefusal & {
5
6
  kind: Kind;
@@ -13,7 +14,9 @@ export type CallResult = {
13
14
  kind: 'action';
14
15
  result: unknown;
15
16
  at?: RoomVersionAt;
16
- } | Refused<'rejected'> | Refused<'undeclared'> | Failure;
17
+ } | (Refused<'rejected'> & {
18
+ reset?: string;
19
+ }) | Refused<'undeclared'> | Failure;
17
20
  export type HistoryAnswer = Exclude<HistoryResult, {
18
21
  kind: Failure['kind'];
19
22
  }> | Failure;
@@ -29,7 +32,21 @@ export type BinaryLinkAnswer = {
29
32
  kind: 'link';
30
33
  url: string;
31
34
  name: string;
35
+ mediaType: string;
32
36
  } | Refused<'rejected'> | Refused<'absent'> | Failure;
37
+ export type HeldShownAnswer = KeptBinary | BinaryLinkAnswer;
38
+ export type ShownAnswer = BinaryAnswer | BinaryLinkAnswer;
39
+ export type AttachAnswer = {
40
+ kind: 'attached';
41
+ path: string;
42
+ } | Offline | Refused<'rejected'> | Failure;
43
+ export type ConversationAttachAnswer = {
44
+ kind: 'attached';
45
+ link: string;
46
+ } | Offline | Refused<'rejected'> | Refused<'undeclared'> | Failure;
47
+ export type DownloadAnswer = {
48
+ kind: 'started';
49
+ } | Refused<'rejected'> | Refused<'absent'> | Refused<'blocked'> | Failure;
33
50
  export type Resolution = {
34
51
  readonly kind: 'document';
35
52
  readonly room: string;
@@ -44,8 +61,14 @@ export declare const UNREADABLE: Refused<'unreadable'>;
44
61
  export declare const LOCKED_UNREADABLE: Refused<'unreadable'>;
45
62
  export declare const ABSENT_TARGET: Refused<'absent'>;
46
63
  export declare function absentBinary(path: string): Refused<'absent'>;
64
+ export declare function declaredType(blob: Blob): string;
65
+ export declare function blobOf(binary: Extract<BinaryAnswer, {
66
+ kind: 'binary';
67
+ }>): Promise<Blob>;
47
68
  export declare function binaryAnswer(result: KeptResult): HeldBinaryAnswer;
48
- export declare function binaryLinkAnswer(result: BinaryLinkResult): BinaryLinkAnswer;
69
+ export declare function binaryLinkAnswer(result: BinaryLinkResult, held?: string): BinaryLinkAnswer;
70
+ export declare function attachAnswer(result: AttachResult): AttachAnswer;
71
+ export declare function linkedAnswer(result: AttachResult): ConversationAttachAnswer;
49
72
  export declare const ROOM_LOCKED = "room-locked";
50
73
  export declare function lockedRoom(locator: string): Refused<'room-locked'> & {
51
74
  locator: string;
@@ -54,8 +77,9 @@ export type Offline = {
54
77
  readonly kind: 'offline';
55
78
  };
56
79
  export declare const OFFLINE: Offline;
80
+ export declare function answeredResult(value: unknown): boolean;
57
81
  export declare const UNCERTAIN: Failure;
58
- export declare function undeclared(name: string): CallResult;
82
+ export declare function undeclared(name: string): Refused<'undeclared'>;
59
83
  export declare function failure(result: AdapterFailure): Failure;
60
84
  export declare function calledResult(result: ActionResult): CallResult;
61
85
  export declare function historyAnswer(result: HistoryResult): HistoryAnswer;
@@ -69,8 +93,7 @@ export type QueueEntry = {
69
93
  readonly batch: ChangeBatch;
70
94
  } & (Submission | {
71
95
  readonly state: 'local';
72
- } | {
73
- readonly state: 'accepted';
74
- readonly roomVersion: string;
75
96
  });
97
+ export declare const UNANSWERED: ActionResult;
98
+ export declare function handedOutcome(retries: Retries, attempt: Attempt | undefined, result: ActionResult): CallResult;
76
99
  export {};
@@ -1,8 +1,11 @@
1
+ import { type ApplyResult } from '../mdmodel/index.js';
1
2
  import type { BinaryFile, HeadChange } from './adapter.js';
2
- import type { ChangeBatch } from './change.js';
3
+ import { type Composition } from './collection.js';
4
+ import { type ChangeBatch } from './change.js';
3
5
  export type Heads = {
4
6
  revisions: Readonly<Record<string, string>>;
5
7
  fileIds: Readonly<Record<string, string>>;
8
+ created: Readonly<Record<string, string>>;
6
9
  changes: Readonly<Record<string, HeadChange>>;
7
10
  };
8
11
  export type HeldBinary = ({
@@ -21,4 +24,6 @@ export type Layer = Heads & {
21
24
  export declare function acceptedBinaries(files: Readonly<Record<string, BinaryFile>>): Generator<readonly [string, HeldBinary]>;
22
25
  export declare function sameBinary(left: HeldBinary | undefined, right: HeldBinary | undefined): boolean;
23
26
  export declare function sameChange(left: HeadChange | undefined, right: HeadChange | undefined): boolean;
24
- export declare function overlaying(base: Layer, queue: readonly ChangeBatch[], unapplied?: () => void): Generator<number, Layer, void>;
27
+ export declare function composed(path: string, fields: Readonly<Record<string, unknown>>, sections: Readonly<Record<string, string>>, composition: Composition): ApplyResult;
28
+ export declare function compose(path: string, fields: Readonly<Record<string, unknown>>, sections: Readonly<Record<string, string>>, composition: Composition): string;
29
+ export declare function overlaying(base: Layer, queue: readonly ChangeBatch[], composition: Composition, unapplied?: () => void): Generator<number, Layer, void>;
@@ -0,0 +1,45 @@
1
+ import { type InstallShare } from './install.js';
2
+ import { type ReadinessChange } from './observation.js';
3
+ import { type PortReach } from './reach.js';
4
+ import { type CodeAvailability, type ConnectionAvailability, type FirstTier, type Readiness, type RoomCoverage } from './readiness.js';
5
+ import type { Runtime } from './runtime.js';
6
+ export type ReadinessPort = {
7
+ readonly target: string;
8
+ readonly code: CodeAvailability;
9
+ readonly first: FirstTier | null;
10
+ readonly inboxed: readonly string[] | null;
11
+ };
12
+ export type ReadinessMessage = Readiness | ReadinessChange;
13
+ export type ReadinessWatch = {
14
+ readonly port: ReadinessPort;
15
+ readonly reach: PortReach | null;
16
+ readonly deliver: (readiness: ReadinessMessage) => void;
17
+ };
18
+ type Share = InstallShare & {
19
+ readonly coverage: RoomCoverage;
20
+ };
21
+ type Settled = {
22
+ acquiring: number;
23
+ unsettled: number;
24
+ };
25
+ type Totals = Settled & {
26
+ installing: number;
27
+ downloading: number;
28
+ done: number;
29
+ total: number;
30
+ };
31
+ export type ReadinessShowing = {
32
+ readonly listing: number;
33
+ readonly roomsListed: boolean;
34
+ readonly named: ReadonlySet<string> | null;
35
+ readonly rooms: Map<string, Share>;
36
+ readonly first: Map<string, string>;
37
+ readonly totals: Totals;
38
+ shown: string;
39
+ };
40
+ export declare function prepare(runtime: Runtime, locators?: readonly string[]): void;
41
+ export declare function connectionNow(runtime: Runtime): Promise<ConnectionAvailability>;
42
+ export declare function deliverOwedReadiness(runtime: Runtime, owed: readonly ReadinessWatch[], touched: ReadonlySet<string> | null): Promise<void>;
43
+ export declare function watchReadiness({ store }: Runtime, port: ReadinessPort, reach: PortReach | null, deliver: (readiness: ReadinessMessage) => void): () => void;
44
+ export declare function filled({ store, socket }: Runtime): void;
45
+ export {};