@agentshouse/app-bridge 0.1.0-cd3bc6240e9ba → 0.1.0-cd44fa24fb809

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/README.md +6 -6
  2. package/dist/index.d.ts +186 -376
  3. package/dist/mdmodel/body.d.ts +84 -0
  4. package/dist/mdmodel/built-in.d.ts +3 -0
  5. package/dist/mdmodel/definition.d.ts +20 -11
  6. package/dist/mdmodel/document.d.ts +14 -8
  7. package/dist/mdmodel/event.d.ts +76 -0
  8. package/dist/mdmodel/facts.d.ts +14 -0
  9. package/dist/mdmodel/fields.d.ts +1 -1
  10. package/dist/mdmodel/house-model.d.ts +869 -0
  11. package/dist/mdmodel/house-references/crockford.d.ts +3 -0
  12. package/dist/mdmodel/house-references/patterns.d.ts +8 -0
  13. package/dist/mdmodel/index.d.ts +40 -15
  14. package/dist/mdmodel/kinds.d.ts +17 -0
  15. package/dist/mdmodel/markdown.d.ts +74 -0
  16. package/dist/mdmodel/media-type.d.ts +71 -0
  17. package/dist/mdmodel/moment.d.ts +6 -0
  18. package/dist/mdmodel/not-ready.d.ts +1 -0
  19. package/dist/mdmodel/paths.d.ts +15 -1
  20. package/dist/mdmodel/pattern.d.ts +9 -0
  21. package/dist/mdmodel/query/language.d.ts +253 -0
  22. package/dist/mdmodel/query/match.d.ts +13 -0
  23. package/dist/mdmodel/query/rows.d.ts +31 -0
  24. package/dist/mdmodel/query/sql.d.ts +38 -0
  25. package/dist/mdmodel/references.d.ts +2 -2
  26. package/dist/mdmodel/reserved.d.ts +5 -0
  27. package/dist/mdmodel/room-types.d.ts +6 -0
  28. package/dist/mdmodel/types.d.ts +22 -17
  29. package/dist/mdmodel/validate.d.ts +12 -6
  30. package/dist/mdmodel/yaml.d.ts +4 -4
  31. package/dist/mdruntime/actions.d.ts +25 -0
  32. package/dist/mdruntime/adapter.d.ts +135 -81
  33. package/dist/mdruntime/attached-model.d.ts +6 -0
  34. package/dist/mdruntime/authored.d.ts +87 -0
  35. package/dist/mdruntime/bootstrap.d.ts +43 -0
  36. package/dist/mdruntime/cell.d.ts +5 -0
  37. package/dist/mdruntime/chain.d.ts +2 -1
  38. package/dist/mdruntime/change-set.d.ts +4 -0
  39. package/dist/mdruntime/change.d.ts +5 -0
  40. package/dist/mdruntime/client.d.ts +33 -22
  41. package/dist/mdruntime/collection.d.ts +26 -4
  42. package/dist/mdruntime/compile.d.ts +8 -6
  43. package/dist/mdruntime/conversation-live.d.ts +149 -0
  44. package/dist/mdruntime/conversation-row.d.ts +39 -0
  45. package/dist/mdruntime/conversation.d.ts +67 -46
  46. package/dist/mdruntime/declaration.d.ts +9 -0
  47. package/dist/mdruntime/durability.d.ts +20 -0
  48. package/dist/mdruntime/failure.d.ts +3 -0
  49. package/dist/mdruntime/figures.d.ts +48 -0
  50. package/dist/mdruntime/holdings.d.ts +28 -0
  51. package/dist/mdruntime/identity.d.ts +0 -1
  52. package/dist/mdruntime/install.d.ts +59 -0
  53. package/dist/mdruntime/listing.d.ts +51 -0
  54. package/dist/mdruntime/live.d.ts +24 -0
  55. package/dist/mdruntime/media.d.ts +19 -2
  56. package/dist/mdruntime/messages.d.ts +35 -5
  57. package/dist/mdruntime/model.d.ts +2 -10
  58. package/dist/mdruntime/observation.d.ts +28 -13
  59. package/dist/mdruntime/opened.d.ts +1 -1
  60. package/dist/mdruntime/outcome.d.ts +17 -2
  61. package/dist/mdruntime/overlay.d.ts +7 -2
  62. package/dist/mdruntime/preparation.d.ts +40 -0
  63. package/dist/mdruntime/presence.d.ts +57 -0
  64. package/dist/mdruntime/query.d.ts +13 -209
  65. package/dist/mdruntime/reach.d.ts +15 -14
  66. package/dist/mdruntime/readiness.d.ts +9 -6
  67. package/dist/mdruntime/reads.d.ts +38 -0
  68. package/dist/mdruntime/recovery.d.ts +3 -1
  69. package/dist/mdruntime/refresh.d.ts +26 -0
  70. package/dist/mdruntime/replica.d.ts +11 -16
  71. package/dist/mdruntime/retried.d.ts +29 -0
  72. package/dist/mdruntime/room-draft.d.ts +34 -10
  73. package/dist/mdruntime/room-drafts.d.ts +23 -0
  74. package/dist/mdruntime/runtime.d.ts +33 -0
  75. package/dist/mdruntime/save.d.ts +42 -86
  76. package/dist/mdruntime/saves.d.ts +33 -0
  77. package/dist/mdruntime/search.d.ts +12 -63
  78. package/dist/mdruntime/seed.d.ts +11 -2
  79. package/dist/mdruntime/socket/admission.d.ts +6 -0
  80. package/dist/mdruntime/socket/answers.d.ts +5 -0
  81. package/dist/mdruntime/socket/lanes.d.ts +27 -0
  82. package/dist/mdruntime/socket/session.d.ts +37 -0
  83. package/dist/mdruntime/socket.d.ts +66 -0
  84. package/dist/mdruntime/source.d.ts +58 -0
  85. package/dist/mdruntime/status.d.ts +0 -2
  86. package/dist/mdruntime/store/installs.d.ts +29 -0
  87. package/dist/mdruntime/store/readiness.d.ts +10 -0
  88. package/dist/mdruntime/store/records.d.ts +223 -0
  89. package/dist/mdruntime/store/room-held.d.ts +7 -0
  90. package/dist/mdruntime/store/rooms-shown.d.ts +7 -0
  91. package/dist/mdruntime/store/space.d.ts +10 -0
  92. package/dist/mdruntime/store/watchers.d.ts +16 -0
  93. package/dist/mdruntime/store/writes.d.ts +23 -0
  94. package/dist/mdruntime/store.d.ts +115 -144
  95. package/dist/mdruntime/stored.d.ts +72 -35
  96. package/dist/mdruntime/surface.d.ts +91 -0
  97. package/dist/mdruntime/tables.d.ts +118 -67
  98. package/dist/mdruntime/tallies.d.ts +17 -0
  99. package/dist/mdruntime/transfer.d.ts +4 -0
  100. package/dist/mdruntime/wire.d.ts +74 -7
  101. package/dist/session-content/bounds.d.ts +7 -0
  102. package/dist/session-content/check.d.ts +18 -0
  103. package/dist/session-content/index.d.ts +7 -0
  104. package/dist/session-content/parts.d.ts +103 -0
  105. package/dist/session-content/state.d.ts +61 -0
  106. package/dist/session-content/turn.d.ts +328 -0
  107. package/dist/test-host.d.ts +8 -1
  108. package/dist/test-host.js +27 -1
  109. package/docs/families.md +52 -22
  110. package/package.json +2 -2
  111. package/dist/mdmodel/blocks.d.ts +0 -10
  112. package/dist/mdmodel/condition.d.ts +0 -179
  113. package/dist/mdmodel/links.d.ts +0 -28
  114. package/dist/mdmodel/profile.d.ts +0 -5
  115. package/dist/mdruntime/connection.d.ts +0 -152
  116. package/dist/mdruntime/fulltext.d.ts +0 -26
@@ -0,0 +1,87 @@
1
+ import type { UnsentWork } from './durability.js';
2
+ import type { Connection, FileSpool, HeldStatus } from './tables.js';
3
+ export declare const FILE_PART_BYTES = 1048576;
4
+ export declare const AUTHORED_TABLES: readonly string[];
5
+ export type AuthoredFact = 'holder' | 'generation' | 'format';
6
+ export type StoredFile = {
7
+ readonly key: string;
8
+ readonly blob: Blob;
9
+ };
10
+ type KeptPending = {
11
+ readonly id: string;
12
+ readonly batch: string;
13
+ readonly state: string;
14
+ readonly files: readonly string[];
15
+ readonly paths: readonly string[];
16
+ readonly moving: boolean;
17
+ };
18
+ export type KeptRecord = {
19
+ readonly record: string;
20
+ readonly files: readonly string[];
21
+ };
22
+ export type AuthoredRows = {
23
+ readonly locator: string;
24
+ readonly order?: readonly string[];
25
+ readonly added?: readonly KeptPending[];
26
+ readonly founded?: readonly Omit<KeptPending, 'state'>[];
27
+ readonly roomDrafts?: readonly (KeptRecord & {
28
+ readonly path: string;
29
+ })[];
30
+ readonly consumedRoomDrafts?: readonly string[];
31
+ };
32
+ export type AuthoredWrite = {
33
+ readonly writes: readonly AuthoredRows[];
34
+ readonly files: readonly StoredFile[];
35
+ readonly whole: boolean;
36
+ };
37
+ export type HeldQueues = {
38
+ readonly queues: readonly {
39
+ readonly locator: string;
40
+ readonly ids: readonly string[];
41
+ }[];
42
+ readonly pending: readonly QueuedRow[];
43
+ };
44
+ type QueuedRow = {
45
+ readonly locator: string;
46
+ readonly id: string;
47
+ readonly batch: string;
48
+ readonly state: string;
49
+ };
50
+ export declare function authoredTable(name: string): boolean;
51
+ export declare function heldTables(connection: Connection): string[];
52
+ export declare function formatted(connection: Connection, format: string, tables: readonly string[]): void;
53
+ export declare function fact(connection: Connection, name: AuthoredFact): string | null;
54
+ export declare function remember(connection: Connection, name: AuthoredFact, value: string): null;
55
+ export declare function fenced(connection: Connection, locator: string): boolean;
56
+ export declare function authoredPart(connection: Connection, key: string, part: number): Uint8Array | null;
57
+ export declare function spooled(connection: Connection, spool: FileSpool, key: string, type: string): Promise<Blob>;
58
+ export declare function queues(connection: Connection): HeldQueues['queues'];
59
+ export declare function queuedLocators(connection: Connection): string[];
60
+ export declare function authoredLocators(connection: Connection): string[];
61
+ export declare function heldOrder(connection: Connection, locator: string): readonly string[];
62
+ export declare function queueOf(connection: Connection, locator: string): Omit<QueuedRow, 'locator'>[];
63
+ export declare function moving(connection: Connection): HeldQueues;
64
+ export declare function unsentStatus(connection: Connection): Omit<HeldStatus, 'lastCompleted'>;
65
+ export declare function pendingState(connection: Connection, locator: string, id: string): string | null;
66
+ export declare function pendingBatch(connection: Connection, locator: string, id: string): string | null;
67
+ export declare function roomDraftRecords(connection: Connection, locator: string | null, paths: readonly string[] | null): string[];
68
+ export declare function chatDraftRecord(connection: Connection, conversation: string): string | null;
69
+ export declare function chatDraftRecords(connection: Connection): string[];
70
+ export declare function chatDraftConversations(connection: Connection, conversations: readonly string[] | null): string[];
71
+ export declare function chatDraftsDropped(connection: Connection, conversations: readonly string[]): void;
72
+ export declare function callRecords(connection: Connection): string[];
73
+ export declare function fences(connection: Connection): string[];
74
+ export declare function kept(connection: Connection, { writes, files, whole }: AuthoredWrite): Promise<string | null>;
75
+ export declare function amended(connection: Connection, locator: string, id: string, amendment: string): null;
76
+ export declare function roomDraft(connection: Connection, locator: string, path: string, draft: KeptRecord | null, files: readonly StoredFile[]): Promise<string | null>;
77
+ export declare function chatDraft(connection: Connection, drafts: readonly {
78
+ readonly conversation: string;
79
+ readonly record: string;
80
+ }[], dropped: readonly string[]): null;
81
+ export declare function call(connection: Connection, operation: string, held: KeptRecord | null, files: readonly StoredFile[]): Promise<null>;
82
+ export declare function fencedWork(connection: Connection, locators: readonly string[]): void;
83
+ export declare function unfenced(connection: Connection, locators: readonly string[]): void;
84
+ export declare function claim(connection: Connection, holder: string): boolean;
85
+ export declare function authoredEmptied(connection: Connection): void;
86
+ export declare function unsent(connection: Connection): UnsentWork[];
87
+ export {};
@@ -0,0 +1,43 @@
1
+ import type { ModelState } from './model.js';
2
+ import type { Adapter, TypedPath, AdapterFailure, Authorization, BootstrapPart, DiscoveredRoom, NotReady, RetryableRefusal, RoomModels } from './adapter.js';
3
+ import type { Composition } from './collection.js';
4
+ import type { InstallationStep } from './readiness.js';
5
+ import { type Refreshing } from './refresh.js';
6
+ import { type ReplicaRecord } from './replica.js';
7
+ import type { StagedPage, TransferRecord } from './store.js';
8
+ import { type Unconfirmed } from './transfer.js';
9
+ export type Bootstrapped = {
10
+ kind: 'staged';
11
+ record: ReplicaRecord;
12
+ refreshed: boolean;
13
+ };
14
+ export type BootstrapOutcome = Bootstrapped | Unconfirmed | NotReady | RetryableRefusal | AdapterFailure;
15
+ export type HeldModels = {
16
+ collection: ModelState;
17
+ };
18
+ export type Remodel = (models: RoomModels | undefined, held: HeldModels) => HeldModels;
19
+ export type Reads = Pick<Adapter, 'bootstrap' | 'refresh' | 'reached'>;
20
+ export type Arriving = {
21
+ at(bytes: number): void;
22
+ end(): void;
23
+ };
24
+ export type Resumed = {
25
+ readonly record: TransferRecord | null;
26
+ readonly staged: ReadonlySet<string>;
27
+ };
28
+ export type Staging = {
29
+ held(locator: string): TransferRecord | null;
30
+ turn(locator: string, step: InstallationStep): Promise<() => void>;
31
+ unqueued(): Promise<void>;
32
+ queued(text: number): () => void;
33
+ arriving(locator: string): Arriving;
34
+ readonly streamed: boolean;
35
+ stage(record: TransferRecord, page: StagedPage, composition: Composition): Promise<TransferRecord | null>;
36
+ resume(record: TransferRecord, parts: readonly BootstrapPart[], composition: Composition): Promise<Resumed | null>;
37
+ derive(locator: string, key: number, composition: Composition): Promise<boolean>;
38
+ refreshing(locator: string, key: number, composition: Composition): Promise<Refreshing>;
39
+ abandon(locator: string): Promise<void>;
40
+ setAside(locator: string): Promise<void>;
41
+ release(key: number): Promise<void>;
42
+ };
43
+ export declare function bootstrapRoom(adapter: Reads, authorization: Authorization, room: DiscoveredRoom, held: HeldModels, builtIn: ModelState, typedPaths: readonly TypedPath[], remodel: Remodel, continuing: () => boolean, staging: Staging): Promise<BootstrapOutcome>;
@@ -0,0 +1,5 @@
1
+ export type Cell<T> = {
2
+ now(): T;
3
+ set(change: Partial<T>): void;
4
+ };
5
+ export declare function createCell<T extends object>(first: T): Cell<T>;
@@ -1,5 +1,6 @@
1
+ import type { DocumentQuery, GroupQuery } from '../mdmodel/index.js';
1
2
  import type { MdRuntimeClient } from './client.js';
2
- import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
3
+ import type { DocumentResult, GroupResult, PendingResult } from './query.js';
3
4
  type Rows = DocumentResult | GroupResult;
4
5
  export type WindowAnswer = Rows | PendingResult;
5
6
  export type WindowChain = {
@@ -12,6 +12,8 @@ export type ChangeSet = {
12
12
  queues: readonly string[];
13
13
  presentations: readonly string[];
14
14
  conversations: readonly string[];
15
+ unindexed: readonly string[];
16
+ due: readonly string[];
15
17
  };
16
18
  type Changed = {
17
19
  documents?: readonly string[] | null;
@@ -19,6 +21,8 @@ type Changed = {
19
21
  room?: boolean;
20
22
  queue?: boolean;
21
23
  presentation?: string;
24
+ unindexed?: boolean;
25
+ due?: boolean;
22
26
  };
23
27
  export declare function changeSet(locator: string, changed?: Changed): ChangeSet;
24
28
  export declare function conversationChangeSet(conversations: readonly string[]): ChangeSet;
@@ -50,8 +50,13 @@ type Arriving = {
50
50
  readonly path: string;
51
51
  readonly revision?: string;
52
52
  readonly fileId?: string;
53
+ readonly created?: string;
53
54
  readonly change?: HeadChange;
54
55
  };
56
+ export type PartChange = Extract<Change, {
57
+ readonly kind: 'field' | 'section' | 'preamble';
58
+ }>;
59
+ export declare function isPart(change: Change): change is PartChange;
55
60
  export type RoomMove = {
56
61
  readonly source: {
57
62
  readonly room: string;
@@ -1,15 +1,26 @@
1
- import type { AppRoom, ConnectionRefusal, HistoryQuery, RoomSchemas, SavedParts, SavedRoomDraft, SaveResult } from './connection.js';
2
- import type { Member, ServiceMode } from './adapter.js';
3
- import type { ChatDraft, ConversationAgent, ConversationAnswer, ConversationEntry, ConversationOptions, ConversationView } from './conversation.js';
1
+ import type { DocumentQuery, GroupQuery } from '../mdmodel/index.js';
2
+ import type { HistoryQuery } from './actions.js';
3
+ import type { AppRoom } from './listing.js';
4
+ import type { ConnectionRefusal } from './socket.js';
5
+ import type { RoomSchemas } from './surface.js';
6
+ import type { SavedParts, SavedRoomDraft, SaveResult } from './saves.js';
7
+ import type { ListedAgent, Member, RoomList, ServiceMode } from './adapter.js';
8
+ import type { UnsentWork } from './durability.js';
9
+ import type { ChatDraftSurface, ConversationAgent, ConversationEntry, ConversationOptions, ConversationSurface, ConversationView } from './conversation.js';
4
10
  import { type Observation } from './observation.js';
5
- import type { AttachAnswer, BinaryAnswer, CallResult, DownloadAnswer, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
6
- import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
11
+ import { type AttachAnswer, type BinaryAnswer, type CallResult, type DownloadAnswer, type HistoryAnswer, type QueueEntry, type Resolution } from './outcome.js';
12
+ import type { FiguresResult } from './figures.js';
13
+ import type { Holdings } from './holdings.js';
14
+ import type { DocumentResult, GroupResult, PendingResult } from './query.js';
7
15
  import type { RoomDraft, RoomDraftParts, RoomDraftWrite } from './room-draft.js';
8
16
  import type { SearchRequest, SearchResult } from './search.js';
9
17
  import type { Readiness } from './readiness.js';
18
+ import type { ObservedRead } from './reads.js';
10
19
  import type { SyncStatus } from './status.js';
11
20
  import { type RuntimePort } from './wire.js';
21
+ export type BuildFile = (name: string) => Promise<Blob | null>;
12
22
  export type MdRuntimeClient = {
23
+ buildFile(name: string): Promise<Blob | null>;
13
24
  rooms(): Promise<readonly AppRoom[]>;
14
25
  query: {
15
26
  (query: DocumentQuery): Promise<DocumentResult | PendingResult>;
@@ -30,21 +41,10 @@ export type MdRuntimeClient = {
30
41
  write(value: unknown): Promise<void>;
31
42
  edit(members: Readonly<Record<string, unknown>>): Promise<void>;
32
43
  };
33
- conversation: {
34
- list(): Promise<readonly ConversationEntry[]>;
35
- read(conversation: string, options?: ConversationOptions): Promise<ConversationView>;
36
- create(input: unknown): Promise<CallResult>;
37
- send(conversation: string, operation?: string, draft?: ChatDraft): Promise<CallResult | Offline>;
38
- answer(conversation: string, answer: ConversationAnswer): Promise<CallResult>;
39
- interrupt(conversation: string): Promise<CallResult>;
40
- kill(conversation: string): Promise<CallResult>;
41
- delete(conversation: string): Promise<CallResult>;
42
- };
43
- chatDraft: {
44
- write(conversation: string, draft: ChatDraft, revision?: string): Promise<void>;
45
- prepend(conversation: string, draft: ChatDraft): Promise<void>;
46
- discard(conversation: string): Promise<void>;
44
+ conversation: ConversationSurface & {
45
+ pageMetadata(app: string, address: string): Promise<string>;
47
46
  };
47
+ chatDraft: ChatDraftSurface;
48
48
  history(locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
49
49
  resolve(room: string, path: string, destination: string): Promise<Resolution>;
50
50
  binaryFile: {
@@ -53,11 +53,15 @@ export type MdRuntimeClient = {
53
53
  download(room: string, path: string, revision?: string): Promise<DownloadAnswer>;
54
54
  };
55
55
  call(name: string, input: unknown): Promise<CallResult>;
56
+ answered(operation: string): Promise<boolean>;
56
57
  reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;
57
- log(): Promise<string>;
58
58
  persistence(): Promise<boolean>;
59
59
  retry(): Promise<void>;
60
60
  cleanUp(): Promise<number>;
61
+ unsent(): Promise<readonly UnsentWork[]>;
62
+ sent(): Promise<void>;
63
+ reset(): Promise<void>;
64
+ readAgain(): Promise<void>;
61
65
  observe: {
62
66
  (topic: 'deployment-facts'): Promise<Observation<unknown>>;
63
67
  (topic: 'rooms'): Promise<Observation<readonly AppRoom[]>>;
@@ -67,6 +71,8 @@ export type MdRuntimeClient = {
67
71
  (topic: 'sync-status'): Promise<Observation<SyncStatus>>;
68
72
  (topic: 'service-mode'): Promise<Observation<ServiceMode>>;
69
73
  (topic: 'member'): Promise<Observation<Member | null>>;
74
+ (topic: 'time-zone'): Promise<Observation<string | null>>;
75
+ (topic: 'authority-changes'): Promise<Observation<number>>;
70
76
  (topic: 'query', query: DocumentQuery): Promise<Observation<DocumentResult | PendingResult>>;
71
77
  (topic: 'query', query: GroupQuery): Promise<Observation<GroupResult | PendingResult>>;
72
78
  (topic: 'queue', locator: string): Promise<Observation<readonly QueueEntry[]>>;
@@ -75,15 +81,20 @@ export type MdRuntimeClient = {
75
81
  (topic: 'conversation', conversation: string, options: ConversationOptions): Promise<Observation<ConversationView>>;
76
82
  (topic: 'conversations'): Promise<Observation<readonly ConversationEntry[]>>;
77
83
  (topic: 'agents'): Promise<Observation<readonly ConversationAgent[]>>;
84
+ (topic: 'listed-agents'): Promise<Observation<readonly ListedAgent[]>>;
85
+ (topic: 'room-list'): Promise<Observation<RoomList | null>>;
86
+ (topic: 'figures'): Promise<Observation<FiguresResult>>;
87
+ (topic: 'holdings'): Promise<Observation<Holdings>>;
88
+ (topic: 'read', name: string, input: unknown): Promise<Observation<ObservedRead>>;
78
89
  };
79
90
  reauthorize(): Promise<void>;
80
91
  settled(): Promise<void>;
81
92
  };
82
- export declare function connectMdRuntime(port: RuntimePort): MdRuntimeClient;
93
+ export declare function connectMdRuntime(port: RuntimePort, buildFile?: BuildFile): MdRuntimeClient;
83
94
  export declare function inTurn(client: MdRuntimeClient, work: () => Promise<void>): Promise<void>;
84
95
  export { chainedWindows, type WindowAnswer, type WindowChain } from './chain.js';
85
96
  export { roomDraftRevision } from './identity.js';
86
- export { defineRoomMedia, ROOM_MEDIA } from './media.js';
97
+ export { defineRoomMedia, ROOM_MEDIA, viewFile } from './media.js';
87
98
  export type { Observation } from './observation.js';
88
99
  export type { Open } from './open.js';
89
100
  export { unanswered, type RuntimePort, type WireMember } from './wire.js';
@@ -1,5 +1,6 @@
1
- import { type Document } from '../mdmodel/index.js';
2
- import type { ModelState } from './model.js';
1
+ import { type DefinitionOf, type Document, type ParseResult, type TypedPath } from '../mdmodel/index.js';
2
+ import type { ModelState, TypesResult } from './model.js';
3
+ import type { AppTypedSelection } from './listing.js';
3
4
  import type { MdModelIdentity } from './adapter.js';
4
5
  export declare const MD_MODEL: MdModelIdentity;
5
6
  export type Collection = {
@@ -13,15 +14,36 @@ export type Composition = {
13
14
  roots: readonly string[];
14
15
  model: ModelState;
15
16
  } | null;
17
+ typedPaths: readonly TypedPath[];
16
18
  };
17
19
  export type Composed = {
18
20
  readonly composition: Composition;
19
21
  readonly fingerprint: string;
20
22
  };
21
23
  export declare function composedOf(composition: Composition): Composed;
22
- export declare function selected(composition: Composition, path: string): boolean;
23
- export declare function governing(composition: Composition, path: string): ModelState;
24
+ type Selecting<M> = {
25
+ readonly model: M;
26
+ readonly selection: {
27
+ readonly roots: readonly string[];
28
+ readonly model: M;
29
+ } | null;
30
+ };
31
+ export declare function selected(composition: {
32
+ readonly selection: {
33
+ readonly roots: readonly string[];
34
+ } | null;
35
+ }, path: string): boolean;
36
+ export declare function governing<M>(composition: Selecting<M>, path: string): M;
37
+ export declare function definitionsAt(composition: Composition, path: string): DefinitionOf;
38
+ export declare function definitionsIn(room: {
39
+ readonly model: TypesResult;
40
+ readonly typedSelection: AppTypedSelection | null;
41
+ }, path: string, typedPaths: readonly TypedPath[]): DefinitionOf;
24
42
  export declare function collectionOf(text: Readonly<Record<string, string>>, composition: Composition): Collection;
25
43
  export declare function documentsOf(collection: Collection): Generator<number, Iterable<readonly [string, Document]>, void>;
26
44
  export declare function validRoot(root: unknown): root is string;
45
+ export declare const UNTYPED = "any";
46
+ export declare function textType(read: ParseResult): string | undefined;
47
+ export declare function typedText(read: ParseResult): boolean;
27
48
  export declare function available(composition: Composition): boolean;
49
+ export {};
@@ -1,15 +1,17 @@
1
+ import { sql } from '../mdmodel/index.js';
2
+ import { type Composition } from './collection.js';
1
3
  import type { Plan, QueryRows } from './query.js';
2
- import type { Connection, Value } from './tables.js';
4
+ import type { Connection } from './tables.js';
3
5
  export type QueryRoom = {
4
6
  readonly locator: string;
5
7
  readonly key: number;
8
+ readonly composition?: Composition;
6
9
  };
7
- export type Fragment = {
8
- readonly sql: string;
9
- readonly bind: readonly Value[];
10
- };
10
+ type Fragment = sql.Fragment;
11
+ export declare const VISIBLE: (alias: string) => string;
12
+ export declare function within(alias: string, path: string): Fragment;
11
13
  export type QueryAnswer = QueryRows & {
12
14
  readonly more?: string;
13
15
  };
14
- export declare function selected(connection: Connection, plan: Plan, rooms: readonly QueryRoom[]): Fragment;
15
16
  export declare function answerQuery(connection: Connection, plan: Plan, rooms: readonly QueryRoom[], budget?: number | null): QueryAnswer;
17
+ export {};
@@ -0,0 +1,149 @@
1
+ import type { SessionState } from '../session-content/index.js';
2
+ import type { AcceptedMessage, ConversationAction, ConversationHistoryRequest, ConversationStream, ListedAgent, ListedConversation, ProcessCommand, SessionOption } from './adapter.js';
3
+ import { type Cell } from './cell.js';
4
+ import type { ChangeSet } from './change-set.js';
5
+ import type { Asked, ConversationAgent, ConversationEntry, ConversationView, RunningTurn } from './conversation.js';
6
+ import type { CallResult } from './outcome.js';
7
+ import type { Recovery } from './recovery.js';
8
+ import type { Attempt, Retries } from './retried.js';
9
+ import type { ChatDraftRecord, RuntimeStore } from './store.js';
10
+ export type ConversationDependencies = {
11
+ call(name: ConversationAction, input: unknown, attempt?: Attempt): Promise<CallResult>;
12
+ history(request: ConversationHistoryRequest): Promise<CallResult>;
13
+ durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
14
+ local(): Promise<RuntimeStore>;
15
+ again(): void;
16
+ settled(): void;
17
+ stream(): ConversationStream | undefined;
18
+ publish(set: ChangeSet): void;
19
+ online(): boolean;
20
+ full(): boolean;
21
+ closed(): boolean;
22
+ unanswered(): void;
23
+ heard(operation: string, lost: boolean): void;
24
+ readonly recovery: Recovery;
25
+ readonly retries: Retries;
26
+ };
27
+ export type Live = {
28
+ turn: RunningTurn | null;
29
+ questions: readonly unknown[];
30
+ process: {
31
+ running: boolean;
32
+ } | null;
33
+ commands: readonly ProcessCommand[];
34
+ options: readonly SessionOption[];
35
+ starting: string | null;
36
+ state: SessionState | null;
37
+ link: {
38
+ connected: boolean;
39
+ } | null;
40
+ deliveryWaiting: readonly string[];
41
+ deliveryUnknown: readonly string[];
42
+ };
43
+ export declare const QUIET: Live;
44
+ export type Fact = Exclude<keyof Live, 'turn'>;
45
+ export declare const FACTS: readonly Fact[];
46
+ type Watcher = {
47
+ readonly notify: (view: ConversationView) => void;
48
+ };
49
+ export type Kept = {
50
+ readonly draft: ChatDraftRecord | null;
51
+ readonly ended: string | null;
52
+ readonly dismissed: string | null;
53
+ readonly pins: readonly string[];
54
+ };
55
+ type HeldWindow = Kept & {
56
+ readonly window: readonly AcceptedMessage[] | null;
57
+ readonly more: boolean;
58
+ readonly total: number | null;
59
+ };
60
+ export type SharedView = {
61
+ readonly conversation: string;
62
+ readonly asked: Asked;
63
+ readonly held: Cell<HeldWindow>;
64
+ ready(): readonly Watcher[];
65
+ join(watcher: Watcher): void;
66
+ admit(watcher: Watcher): boolean;
67
+ leave(watcher: Watcher): boolean;
68
+ empty(): boolean;
69
+ };
70
+ type Listing<T> = (value: T) => void;
71
+ export type Audience<T> = {
72
+ waiting(): boolean;
73
+ told(): boolean;
74
+ join(watcher: Listing<T>): void;
75
+ leave(watcher: Listing<T>): void;
76
+ tell(value: T): void;
77
+ welcome(value: T): void;
78
+ clear(): void;
79
+ };
80
+ type HeldFacts = {
81
+ readonly listKnown: boolean;
82
+ readonly openingRead: boolean;
83
+ readonly openingListed: boolean;
84
+ readonly listOwed: boolean;
85
+ readonly listTelling: boolean;
86
+ readonly agentsShown: string | null;
87
+ readonly listedShown: string | null;
88
+ readonly replicated: ReadonlySet<string>;
89
+ readonly handedReplicated: string | undefined;
90
+ };
91
+ export type Dispatch = Cell<{
92
+ readonly answered: boolean;
93
+ }>;
94
+ export type Relisted = {
95
+ readonly conversations: ReadonlyMap<string, ListedConversation>;
96
+ readonly agents: ReadonlyMap<string, ListedAgent>;
97
+ };
98
+ export type LiveConversations = {
99
+ readonly deps: ConversationDependencies;
100
+ readonly held: Cell<HeldFacts>;
101
+ readonly closing: AbortSignal;
102
+ readonly listeners: Audience<readonly ConversationEntry[]>;
103
+ readonly agentListeners: Audience<readonly ConversationAgent[]>;
104
+ readonly listedListeners: Audience<readonly ListedAgent[]>;
105
+ views(): Iterable<SharedView>;
106
+ viewJoined(key: string, conversation: string, asked: Asked, notify: (view: ConversationView) => void): {
107
+ readonly view: SharedView;
108
+ readonly watcher: Watcher;
109
+ };
110
+ viewLeft(key: string, view: SharedView, watcher: Watcher): void;
111
+ liveOf(conversation: string): Live;
112
+ liveHeld(conversation: string): Live | undefined;
113
+ holdLive(conversation: string, next: Live | null): void;
114
+ factsOwed(conversation: string): void;
115
+ factsHeard(conversation: string, facts: readonly Fact[]): void;
116
+ factsTaken(): readonly (readonly [string, ReadonlySet<Fact>])[];
117
+ behind(conversation: string): boolean;
118
+ behindAll(): readonly string[];
119
+ fellBehind(conversation: string): void;
120
+ caughtUpTo(conversation: string): void;
121
+ gapOpened(conversation: string): void;
122
+ generation(conversation: string): number;
123
+ heardAt(conversation: string, change: string): void;
124
+ newestHeard(conversation: string): string | undefined;
125
+ catching(conversation: string): Promise<void> | undefined;
126
+ catchingUntil(conversation: string, ended: Promise<void>): void;
127
+ creating(conversation: string): void;
128
+ created(conversation: string): void;
129
+ isCreating(conversation: string): boolean;
130
+ relisting(): boolean;
131
+ relistBegun(): void;
132
+ relistHeard(entries: readonly ListedConversation[], agents: readonly ListedAgent[]): void;
133
+ relistDropped(conversation: string): void;
134
+ relistTaken(): Relisted | null;
135
+ sendingBegan(operation: string): Dispatch;
136
+ sendingEnded(operation: string, dispatch: Dispatch): void;
137
+ sending(operation: string): boolean;
138
+ rowSoon(tell: () => void): void;
139
+ inOrder(work: () => Promise<void>): void;
140
+ forget(conversation: string): void;
141
+ current(): boolean;
142
+ known(): boolean;
143
+ listed(): boolean;
144
+ reopened(): void;
145
+ lost(): void;
146
+ close(): void;
147
+ };
148
+ export declare function createLiveConversations(deps: ConversationDependencies): LiveConversations;
149
+ export {};
@@ -0,0 +1,39 @@
1
+ import type { HeldRow } from './messages.js';
2
+ import { type HouseSource, type RequestAnswer } from './source.js';
3
+ export type ConversationLast = {
4
+ readonly text: string;
5
+ readonly by: 'owner' | 'agent' | 'house';
6
+ readonly at: string;
7
+ };
8
+ export type ConversationStart = Extract<HouseSource, {
9
+ readonly kind: 'request' | 'trigger';
10
+ }>;
11
+ export type ConversationAsk = {
12
+ readonly who: string;
13
+ readonly fromRoom: boolean;
14
+ readonly agent: string | null;
15
+ readonly room: {
16
+ readonly ref: string;
17
+ readonly handle: string;
18
+ readonly name: string;
19
+ };
20
+ readonly prompt: string;
21
+ readonly agentFunction: string | null;
22
+ readonly answer: RequestAnswer | null;
23
+ readonly instruction: string | null;
24
+ readonly at: string;
25
+ readonly request: string;
26
+ readonly message?: string;
27
+ };
28
+ export type ConversationHeld = {
29
+ readonly last: ConversationLast | null;
30
+ readonly answered: string | null;
31
+ readonly opened: string | null;
32
+ readonly failure: string | null;
33
+ readonly startedBy: ConversationStart | null;
34
+ readonly asks: ConversationAsk | null;
35
+ };
36
+ export declare function heldFacts(held: HeldRow | undefined, listed: {
37
+ readonly outcome: string | null;
38
+ readonly waiting: boolean;
39
+ }): ConversationHeld;