@agentshouse/mdruntime-adapter 0.1.0-ccda1a2da11c3 → 0.1.0-ccdfb41af2abb

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 (67) hide show
  1. package/README.md +2 -2
  2. package/dist/actions.d.ts +3 -71
  3. package/dist/actions.d.ts.map +1 -1
  4. package/dist/actions.js +1 -317
  5. package/dist/adapter.d.ts.map +1 -1
  6. package/dist/adapter.js +171 -336
  7. package/dist/app-reference.d.ts +2 -0
  8. package/dist/app-reference.d.ts.map +1 -0
  9. package/dist/app-reference.js +2 -0
  10. package/dist/crockford.d.ts +4 -0
  11. package/dist/crockford.d.ts.map +1 -0
  12. package/dist/crockford.js +3 -0
  13. package/dist/discovery.d.ts +12 -12
  14. package/dist/discovery.d.ts.map +1 -1
  15. package/dist/discovery.js +44 -51
  16. package/dist/history.d.ts +12 -0
  17. package/dist/history.d.ts.map +1 -0
  18. package/dist/history.js +91 -0
  19. package/dist/house-model.d.ts +892 -0
  20. package/dist/house-model.d.ts.map +1 -0
  21. package/dist/house-model.js +482 -0
  22. package/dist/index.d.ts +10 -3
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +9 -2
  25. package/dist/model.d.ts +5 -2
  26. package/dist/model.d.ts.map +1 -1
  27. package/dist/model.js +10 -29
  28. package/dist/part.d.ts +12 -11
  29. package/dist/part.d.ts.map +1 -1
  30. package/dist/part.js +66 -56
  31. package/dist/read.d.ts +19 -56
  32. package/dist/read.d.ts.map +1 -1
  33. package/dist/read.js +138 -297
  34. package/dist/refusal.d.ts +0 -3
  35. package/dist/refusal.d.ts.map +1 -1
  36. package/dist/refusal.js +0 -5
  37. package/dist/room-stream.d.ts +19 -0
  38. package/dist/room-stream.d.ts.map +1 -0
  39. package/dist/room-stream.js +57 -0
  40. package/dist/room-types.d.ts +2 -1
  41. package/dist/room-types.d.ts.map +1 -1
  42. package/dist/room-types.js +62 -3
  43. package/dist/search.d.ts +5 -0
  44. package/dist/search.d.ts.map +1 -0
  45. package/dist/search.js +47 -0
  46. package/dist/site.d.ts.map +1 -1
  47. package/dist/site.js +79 -177
  48. package/dist/stream.d.ts +13 -14
  49. package/dist/stream.d.ts.map +1 -1
  50. package/dist/stream.js +168 -426
  51. package/dist/transport.d.ts +48 -38
  52. package/dist/transport.d.ts.map +1 -1
  53. package/dist/transport.js +55 -11
  54. package/dist/upload.d.ts +12 -0
  55. package/dist/upload.d.ts.map +1 -0
  56. package/dist/upload.js +63 -0
  57. package/dist/write.d.ts +6 -1
  58. package/dist/write.d.ts.map +1 -1
  59. package/dist/write.js +19 -32
  60. package/package.json +8 -4
  61. package/AGENTS.md +0 -309
  62. package/dist/gather.d.ts +0 -4
  63. package/dist/gather.d.ts.map +0 -1
  64. package/dist/gather.js +0 -35
  65. package/dist/referrer.d.ts +0 -9
  66. package/dist/referrer.d.ts.map +0 -1
  67. package/dist/referrer.js +0 -41
package/AGENTS.md DELETED
@@ -1,309 +0,0 @@
1
- # Instructions for the App Creator's agent
2
-
3
- These instructions address an agent in an environment with Git: obtain the App Repository,
4
- change it, build, and push. They are documentation, not enforcement.
5
-
6
- ## The MD Runtime API
7
-
8
- App code reaches the MD Runtime through the remote client. The surfaces are Rooms, Query,
9
- Search, Observe, Types, Room Draft, Save, History, Resolve, the binary file reads, Call,
10
- Reached, Log, the reported persistence answer, reauthorization, conversation, the chat
11
- draft, and Presentation State. Sync Status, readiness, the Service Mode, the storage-loss
12
- statement, the deployment facts and the signed-in member are observations only.
13
-
14
- The host attaches each port with its reach, and every member and observation answers
15
- within it: a Room outside it answers as one the replica does not hold, Rooms lists only
16
- the Rooms reached whole, a Room reached for single Documents shows only them and their
17
- models' Types, and without conversations the conversation members, chat draft and
18
- observation hold none. A changed reach reaches every open observation as its new value.
19
-
20
- Every `observe` resolves, once its first value arrived, to a handle: `current()` is the
21
- latest complete value, `subscribe(listener)` hears each later value whole and returns its
22
- unsubscribe, and `close()` ends it. Closing the port ends every handle and rejects every
23
- pending call and observation; a reconnected client observes again.
24
-
25
- `observe('agents')` answers every Agent a new conversation can go to, each `{ identity,
26
- name }`, with a conversation yet or not. Each conversation the Provider lists is held
27
- complete in the browser. `conversation.list()` and `observe('conversations')` answer each
28
- with its Agent's identity and name, its name, created and finished times, last outcome,
29
- live `state` (`asking` while a question waits, `working` while a turn runs, else `idle`)
30
- and `started`, when the running turn began, or `null`. `observe('conversation', id, {
31
- limit, total: true })` holds its latest `limit` messages, at most 1,000, oldest first,
32
- `total` their count, and `next` while older ones exist, which `after` takes, there or in
33
- `conversation.read(id, { limit, after })`, for the window before; its chat draft; and,
34
- only in memory, what the Provider streams whether or not anything views it: the running
35
- `turn` with its parts and its context in use and window, which the message accepted under
36
- the turn's id replaces, the open questions, the process state, and the CLI's commands and
37
- options, none stored or searchable. `chatDraft.write` and `chatDraft.discard` keep what
38
- the App Creator composes, and `chatDraft.prepend(conversation, draft)` puts a returned
39
- message ahead of it as it stands. Sending it is a Provider Action that needs the Provider
40
- reachable and is never queued. A new conversation's chat draft is keyed `new:<Agent
41
- identity>`: no conversation list removes it, a retired Agent's goes, and the first answer
42
- to `conversation.create({ agent_id, operation_id })` moves it to the created conversation,
43
- where `conversation.send(conversation)` sends it; a replay of that create moves nothing.
44
-
45
- Presentation State is one value per App, kept in the browser and shared by its tabs:
46
- `presentation.read()` answers it, `null` before anything is kept,
47
- `observe('presentation')` hears it whole, `presentation.write(value)` replaces it whole,
48
- and `presentation.edit(members)` sets each member named, or removes one named `null`, in
49
- the state as it stands, so tabs changing different members never lose each other's change:
50
- never write back a value read before. Each rejects when the browser does not keep the
51
- change, and no tab sees it then.
52
-
53
- A binary file at a Path is a binary Path entry. Query lists it by `path`, and History each
54
- of its revisions, with its `binaryFile` record and never its bytes: `{ state: 'accepted',
55
- revision, path, fileRef, byteLength, mediaType, sha256 }`, or, from a Save until the
56
- Provider accepts it, `{ state: 'pending', localId, path, byteLength, mediaType, sha256 }`.
57
- Write one with a Room Draft whose only part is `file: { blob }`, the `Blob`'s `type` its
58
- media type: Save keeps the bytes in its Pending Change, offline too, and acceptance gives
59
- the record the Provider's revision. Move or remove one as a Document, a pending one too,
60
- its bytes following; once its Pending Change has gone to the Provider, Save refuses that
61
- as `unknown-revision` until it is accepted. `binaryFile.read(room, path, revision?)`
62
- answers a pending record's saved bytes, or an accepted one's or a History revision's, a
63
- removed file's last included: the first read asks the Provider and the browser keeps the
64
- bytes, and every later read of that revision, offline too, answers them from the browser.
65
- Text, a Record attachment or a conversation message may name a file by its `fileRef`; read
66
- it with `binaryFile.readReference({ fileRef, referrer })`, the `referrer` the Provider gave
67
- beside it, or `{ room, path }` of the document whose text names it, kept the same way. Both
68
- answer `{ kind: 'binary', stream, byteLength, mediaType }`, the bytes a `ReadableStream`
69
- of parts of at most a mebibyte, or a refusal or failure; read the stream to its end, or
70
- take it whole with `new Response(stream).blob()` where a screen needs one `Blob`.
71
-
72
- Rooms, Query, Search, Observe, Types, Room Draft, Save, and Reached never touch the
73
- network; History, a binary file read the browser does not keep yet and Call go to the
74
- Provider through the Adapter.
75
- Call takes the Action names the Adapter declares, any other answering `undeclared`. A Call
76
- result whose effect the Provider places in a Room carries `at`, that Room and Room
77
- Version: `reached(room, roomVersion)` answers whether the Room's confirmed state has
78
- reached it, refreshing the Room until it has, and `reached(room, roomVersion, path)`
79
- whether the held copy of that document was written later. A History revision names its
80
- author, `{ kind: 'user', id }` or `{ kind: 'site' | 'inbox', id, name }`; History of a Path no
81
- document holds answers the removed document's revisions, newest first, with `deleted:
82
- true`, which a link to the Path opens. Every member is asynchronous and every result a
83
- detached snapshot; nothing returns the authorization, performs a request the App's code
84
- composes, or exposes the browser store. A Room `rooms` names `locked` shows only online.
85
-
86
- Every refusal and failure carries `code` and `retryable`: each Call and History answer
87
- other than its result, a refused Save or Room Draft write, a returned Room Draft's reason,
88
- a Room's refusal, the Connection Refusal and every error a member rejects with, beside its
89
- message, a Provider refusal with the Provider's own `retryable`. Every code and value is
90
- open: handle one you do not know by its `code` and `retryable`. Only a tag telling which
91
- fields a value carries, such as `kind`, is closed: keep a branch for one you do not know.
92
- A model with no usable types answers `types: null`.
93
-
94
- Read the deployment facts with `observe('deployment-facts')`, an opaque value the host's
95
- contract interprets. `observe('member')` answers who uses the App, the only way App code
96
- learns it: the User the Provider signed in, `{ kind: 'user', id, name }` like a change's
97
- `author`, so a Document whose `change.author.id` is its `id` is that User's own; `null`
98
- until the Provider first names one, and where it names none, such as a Site. It is kept
99
- with the Local Replicas, answers offline once known, and every port hears the next member
100
- named; signing out answers `null`, then ends the observation with the authorization.
101
-
102
- ## Local Query rules
103
-
104
- `query(q)` answers once from local state; `observe('query', q)` holds the whole result and
105
- hears it again only when it changes, keeping every unchanged Document the same object, so
106
- a component can tell what changed by identity. `{ documents, coverage }` or `{ groups,
107
- coverage }` is complete for the Rooms its `coverage` names, and `{ pending }` names each
108
- Room not yet acquired, prepared or unlocked, `[{ room, awaits }]`: never read it as empty,
109
- draw it as loading and observe the query to hear the complete answer. A query is data:
110
-
111
- - **Filter.** `rooms` names Room locators and defaults to every Room. `types` names MD
112
- Types, and `any` names untyped Markdown Documents. `pathPrefix` is a directory: `notes`
113
- keeps `notes/a.md` and not `notes2/a.md`; `folder` keeps only what lies directly in it.
114
- `paths` keeps only the Paths it names: read named Documents so, never from a list.
115
- - **Fields.** Every frontmatter value is named by JSON Pointer: `/status`,
116
- `/shipping/city`, `~1` for a `/` and `~0` for a `~` in a key. A segment that meets a
117
- list applies to every item and a number names one item. `where` names pointers, ANDs
118
- them, and nests `$and` and `$or`; a pointer through a list holds if any item satisfies
119
- it. A bare value is equality; the operators are `$eq`, `$ne`, `$in`, `$nin`, `$gt`,
120
- `$gte`, `$lt`, `$lte`, `$all`, `$size` and `$exists`. Equality on a list asks if it
121
- contains the value. Missing, null and empty differ: `$exists: false` keeps a missing
122
- field, `null` an explicit null, `''` empty text and `$size: 0` an empty list. A date
123
- compares in calendar order and never with a date-time. A reference compares by the
124
- Room Path it resolves to. Untyped frontmatter, and a value under `oneOf` or a
125
- conditional, is plain values. There is no text containment or regular expression.
126
- - **Relations.** Within one Room, `hop: { field, types, where, pathPrefix }` keeps Documents
127
- whose reference at pointer `field`, at any depth, points to a matching Document, and
128
- `backlinks` with the same keys those a matching Document references, each once. A body
129
- link, or a reference declaring `cross_room`, may name another Room's
130
- `/rooms/<handle>/<path>`: `resolve(room, path, destination)` answers its `document`, the
131
- `deleted` one's last `revision`, or `unreadable` where the App does not bind it or it is
132
- locked.
133
- - **Parts.** A Document query must `select`: `'all'`, or `fields`, `sections`,
134
- `preamble`, `markdown`, `backlinks`, `change` and `fileId`, where `fields` is `'all'`
135
- or a list of pointers and `sections` `'all'` or a list of names. Selected pointers
136
- return the frontmatter holding only them, nested as written. A backlink names the
137
- referring Path, MD Type and the pointer it came from as `field`. Room and Path always
138
- return; a Markdown Document also returns its MD Type, and at most its first 1,000
139
- backlinks: a query on the referring field reads the rest. A non-Markdown Document
140
- returns only Room, Path and a selected `fileId`, and a binary Path entry its
141
- `binaryFile` record too. An unselected part is absent. Select only what a screen shows:
142
- a list that selects the Markdown hears every edit of it.
143
- - **Change and file ID.** `change` is `{ author, time }` of the Document's head revision
144
- as the Provider last delivered it: `author` is `{ kind: 'user' | 'site' | 'inbox', id, name }`, or
145
- `null` for a write the Provider made itself, and `time` its ISO 8601 change time, or the
146
- whole change `null` where it delivered no time, as at a Site. `fileId` is the Provider's
147
- Stable File ID of the file at the Path, or `null`. An unsent edit keeps both, an unsent
148
- move keeps the change and carries the file ID to the new Path, so a file ID that leaves
149
- one Path for another is the same file moved, and an unsent creation has neither until it
150
- is Accepted. A Room's last change is its Document with the latest `time`.
151
- - **Order and groups.** `orderBy` sorts by `room`, `path`, `type`, `folder` or `{ field }`: missing
152
- and null first, last with `nulls: 'last'`, then numbers and booleans, then text by `locale` or
153
- code point with `stringSort: 'lexical'`, then lists item by item; ties end with Room, then Path.
154
- `groupBy` by `room`, `type`, `folder` or `{ field }` answers `{ groups: [{ key, count }] }`,
155
- counted over every match and ordered by `count` or a key. A sort or group takes only a
156
- single-value pointer. `limit`, at most 1,000 whatever a query names, bounds the Documents or the
157
- groups, and a result it cuts short names `next`: the same query with it as `after` reads the next
158
- window, in the same order, ties included. `total: true` adds `total`, every match's count. An
159
- observed window hears rows entering, leaving or changing, and `next`, `total`.
160
- - **Results and errors.** A result carries no Room Version: read freshness from Rooms and
161
- Sync Status. `coverage` names each Room read as `{ room, generation, current }`,
162
- `current` false while a newer copy of that Room is being fetched, and the queued changes
163
- it includes as `overlay`, which a Save in the Room changes. An invalid query fails with
164
- `invalid-query`, `unknown-type`, `unknown-field` or `wrong-kind`, never an empty answer.
165
-
166
- ## Local Search rules
167
-
168
- `search({ text, documents, collection, conversations, limit, after, total })` answers
169
- once, by words, from local state, with MiniSearch's defaults. There is no observed search.
170
-
171
- - **Declaration.** Only an App whose release declares Local Search searches, its first
172
- readiness waiting for its index; any other App's `search` answers the never retryable
173
- `undeclared` refusal `search-undeclared`, its `fields` naming `local_search`.
174
- - **What is found.** A Document by its field values, its sections' headings and text, its
175
- preamble and its Path, and a message by its text, never a frontmatter key, a Room Draft,
176
- a chat draft or a running turn's parts, with no phrases, word forms, typo tolerance or
177
- prefix matching.
178
- - **Narrowing.** `documents` is a Local Query filter, and `collection: true` leaves out
179
- what each Room's `typedSelection` roots hold; `conversations` names conversations. All
180
- apply before `limit`, which bounds each list, at most 1,000 whatever a search names. A
181
- complete answer it cuts short names `next`, which `after` takes for the next window of
182
- both lists. `total: true` adds `total`, each list's count.
183
- - **Results.** `{ documents, messages, coverage }`, or the same with `pending` naming each
184
- Room or conversation the search still waits for: show its hits, ask again, and never
185
- read pending as no hits. `coverage` names the Rooms and conversations searched. Each
186
- list is ranked by `score`, comparable only within it; ties come by `room`, then `path`,
187
- or by `conversation`, then `identity`. A Document hit names its `room`, `path` and
188
- `type`, a message hit its `conversation` and `identity`; `matches` maps each matched
189
- word to the parts it matched in: `fields`, `sections`, `preamble`, `path` or `text`. A
190
- hit carries no position: mark the words you show. A bad filter fails as a query does.
191
-
192
- ## Room Draft, Save, and outcome rules
193
-
194
- The MD Runtime owns one durable Room Draft per Room and Path, shared by every App and tab
195
- across reloads; a Room the Provider reports lost takes its Room Drafts and queue with it.
196
- Write one with `roomDraft.write(room, path, revision, parts)`, naming the revision you read
197
- or `null`, and every part it now changes: fields, sections and the preamble, or the whole
198
- Markdown, a creation, a move, into another Room when it names `room`, or a removal. A new
199
- part names its base, the value you showed when it was opened, a field's as `{ value }` or
200
- `null` for no such field, and keeps its first base; a binary Path entry's move or removal
201
- takes `null`. A write or discard from an older revision is refused as `stale` with the
202
- current Room Draft.
203
-
204
- Save takes one Room and the Room Drafts of it to save, each with its revision, validates
205
- locally, and on success appends one Change Batch to that Room's queue and removes those Room
206
- Drafts. Refused as `stale`, `changed-underneath` naming each part whose base no longer
207
- matches the visible state, or a local validation rule, it creates nothing and leaves every
208
- Room Draft. A directory move or removal is that part on each Document and binary Path entry
209
- beneath it, saved together; moves into another Room, saved alone, are one Change Batch in
210
- both Rooms' queues. `saveParts(room, [{ path, parts }])` saves parts, each Path once and
211
- each new part with its base, the same way but writes no Room Draft: one held at a saved Path
212
- stays, one at a moved Path moves with it to a destination that holds none. Never save by
213
- writing back a Room Draft read before.
214
-
215
- Outcomes follow the Provider's answer. An Accepted Change Batch stays in the queue, drawn
216
- over the confirmed layer, until that layer reaches the Room Version it was accepted at.
217
- Conflicted and Rejected, an expired operation, and a change that no longer applies each
218
- leave the queue and return as Room Drafts on their Documents, marked with why: the
219
- Provider's structured refusal code and fields as returned, not known to have applied, or
220
- withdrawn locally. The rest of the queue keeps synchronizing, and Sync Status requires
221
- attention until each returned Room Draft is saved or discarded. `observe('queue', room)`
222
- shows each Pending Change Batch, which keeps no outcome once it leaves. Transport failure,
223
- Provider unavailability and a refusal marked retryable, until the reset it names, keep
224
- work Pending; the MD Runtime retries the same Change Batch identity and payload, never
225
- infers an outcome from transport uncertainty, and never combines, reorders, or rebases.
226
-
227
- On a Site, every Save stays in the visitor's browser: write grants and revisions do not
228
- refuse it, and its Pending Change shows in every query and across reloads until the
229
- browser's storage is cleared. It is never sent: `observe('queue', room)` shows it `local`,
230
- Sync Status never waits on it, and once the Room no longer lets it apply it leaves the
231
- queue and returns no Room Draft.
232
-
233
- `observe('service-mode')` answers the Provider's Service Mode, `open` or `write-halted`.
234
- While writes are halted, Save succeeds, its Change Batch waits unsent and the queue is
235
- submitted in order once writes reopen; an Action is never held, and one the halt refuses
236
- returns that refusal: show the Provider as read-only instead of retrying.
237
- `observe('readiness')` tells whether the App's code and bound Rooms are held locally
238
- (`ready`), each Room's state, each refused Room's file and rule, the persistence answer
239
- and a paused preparation's `capacity` cause; `retry()` resumes a paused preparation.
240
-
241
- ## Content safety and launch promises
242
-
243
- The Provider authorization belongs to the Runtime host and is never readable by the App's
244
- code. The App's code reaches the network only at the external origins its manifest
245
- declares, empty by default, and the Provider enforces that set. Rendered Markdown never
246
- executes scripts, renders raw HTML only for the details and summary elements, and loads
247
- images and other resources only from origins the Provider's policy allows. An agent must
248
- never read the authorization, load code from a Room, call the Provider directly, or rebase
249
- a refused Change Batch.
250
-
251
- MD UI uses semantic HTML, is fully operable from a keyboard with visible focus and
252
- labelled controls, and lays out from a 360 pixel wide viewport to a desktop. Its strings
253
- are English only, dates and numbers follow the browser locale, and content is never
254
- translated. Light and dark themes come from CSS custom properties, defaulting to the
255
- browser's preference and respecting an App's override. What an agent adds carries none of
256
- these promises by itself. Data lives only in the App Creator's browser and the Provider.
257
-
258
- ## App code takes the client its host hands it and never constructs a Runtime
259
-
260
- No module outside an Adapter package imports, names, or special-cases a Provider, and
261
- every App and MD UI reach data only through the client entry. In House,
262
- `houseBridge().runtime` from `@agentshouse/app-bridge` resolves to the client House built
263
- into the page. App code imports only types from `@agentshouse/mdruntime/client`, never
264
- calls `connectMdRuntime` or `serveMdRuntime`, and never imports the package main, the host
265
- entry or the Adapter package; the in-memory Adapter at `@agentshouse/mdruntime/memory` is
266
- for tests and ships in no bundle. A Site's page fills its Entry Data Contract's
267
- `{"$param": name}` arguments with `boundQuery` from `@agentshouse/mdruntime/entry`, as
268
- House did for its HTML. While the Site prepares, a query a route's `interaction` names
269
- answers from the entry's result when the page observes that descriptor, and every other
270
- stays pending. House replaces its HTML with the page once its document changed after those
271
- answers, or readiness is `ready`, and then held still for two animation frames, unless the
272
- visitor uses the HTML: draw the route at once, never behind a placeholder. Before
273
- readiness is `ready`, `push` loads a new page.
274
-
275
- A React App may observe and save through `@agentshouse/mdruntime/react`, with React as a
276
- peer dependency. `useObserve(client, topic, ...input)` takes the arguments of `observe`
277
- and returns `{ state: 'loading' }` until the topic's first value arrives, then `{ state:
278
- 'ready', value }`, re-rendering on each change; a `null` client stays loading.
279
- `useSave(client)` returns `busy`, the last `outcome` or `failure`, and `save(room,
280
- parts)`, which saves through `saveParts` and rejects with a recorded failure.
281
- `saveWritten(room, roomDrafts)` saves Room Drafts the App wrote, each named with the
282
- revision its last write returned: one another tab wrote since is refused as `stale`, and
283
- nothing is saved. React-admin and Refine Apps use `@agentshouse/mdruntime-families`.
284
-
285
- ## The Chat
286
-
287
- `@agentshouse/mdruntime/chat` holds the Chat, one data layer for every App; add React as a
288
- dependency in any App, with React DOM and `@assistant-ui/react`. Place the ready chat with
289
- `<Chat client={runtime} conversation={id} agent={agent} width="1/3" showChats />`:
290
- `conversation` opens one, `null` for a new chat, `agent` is the Agent a new chat goes to,
291
- `onOpen` hears each one it opens, and `width` is `full` (the place you give it), or `3/4`,
292
- `1/2` or `1/3` of the window docked at its right edge, whole on a narrow window.
293
- `showChats` adds its conversation list; or draw your own inside a `ChatProvider` around a
294
- `<Chat />` with no `client`. Theme its own styles with CSS custom properties on it or an
295
- ancestor: `--chat-background`, `--chat-surface`, `--chat-text`, `--chat-text-muted`,
296
- `--chat-accent`, `--chat-line`, `--chat-attention`, `--chat-danger`, `--chat-font`,
297
- `--chat-font-mono`, `--chat-font-size`, `--chat-radius` and `--chat-density` (a factor for
298
- spacing); an unset one keeps House's light or dark look. `mountChat(element, { client })`
299
- places it outside React, with `update(props)` and `unmount()`.
300
-
301
- Mix `ChatMessageList` (`components` takes your `UserMessage` and `AssistantMessage`),
302
- `ChatInput` and `ChatQuestionCard` with your own design inside a `ChatProvider`, or
303
- compose assistant-ui's primitives there; `useChat()` gives `send`, the conversations, the
304
- Agents, questions to `answer`, `options` to `choose`, `commands`, the queue to `edit` or
305
- `unqueue`, `stop`, `kill` and outcomes; never replace its messages, sending or store. It
306
- shows a conversation's latest 50 messages, and assistant-ui's `loadEarlier()` the 50
307
- before, which `ChatMessageList` calls as the reader scrolls back. A secret question is
308
- never answered here; typed answers live in the Presentation State members named `typed:…`:
309
- leave them. `Markdown` draws Markdown safely.
package/dist/gather.d.ts DELETED
@@ -1,4 +0,0 @@
1
- export declare function gatheredEach<A, R>(send: (asks: readonly A[], answer: (ask: number, result: R) => void) => Promise<void>): (ask: A) => Promise<R>;
2
- export declare function gathered<A, R>(send: (asks: readonly A[]) => Promise<readonly R[]>): (ask: A) => Promise<R>;
3
- export declare function selections<T>(items: readonly T[], limit: number): readonly (readonly T[])[];
4
- //# sourceMappingURL=gather.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"gather.d.ts","sourceRoot":"","sources":["../src/gather.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GACpF,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAwBxB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,GAClD,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAMxB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAO3F"}
package/dist/gather.js DELETED
@@ -1,35 +0,0 @@
1
- export function gatheredEach(send) {
2
- let held = [];
3
- function flush() {
4
- const taken = held;
5
- held = [];
6
- send(taken.map((entry) => entry.ask), (ask, result) => {
7
- taken[ask]?.resolve(result);
8
- }).catch((reason) => {
9
- for (const entry of taken)
10
- entry.reject(reason);
11
- });
12
- }
13
- return (ask) => new Promise((resolve, reject) => {
14
- if (held.length === 0) {
15
- // Asks made in one task wait a single event-loop turn so they leave as one batch.
16
- setTimeout(flush, 0);
17
- }
18
- held.push({ ask, resolve, reject });
19
- });
20
- }
21
- export function gathered(send) {
22
- return gatheredEach(async (asks, answer) => {
23
- (await send(asks)).forEach((result, ask) => {
24
- answer(ask, result);
25
- });
26
- });
27
- }
28
- export function selections(items, limit) {
29
- const size = Math.max(1, limit);
30
- const parts = [];
31
- for (let start = 0; start < items.length; start += size) {
32
- parts.push(items.slice(start, start + size));
33
- }
34
- return parts;
35
- }
@@ -1,9 +0,0 @@
1
- import type { ReferrerScope } from '@agentshouse/mdruntime';
2
- import type { TrackedAuthority } from './discovery.js';
3
- export type HouseReferrer = {
4
- locator: string;
5
- referrer: Readonly<Record<string, string>>;
6
- };
7
- export declare function houseReferrer(referrer: unknown, tracked: ReadonlyMap<string, TrackedAuthority>): HouseReferrer | null;
8
- export declare function houseReferrerScope(referrer: unknown, tracked: ReadonlyMap<string, TrackedAuthority>): ReferrerScope | null;
9
- //# sourceMappingURL=referrer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"referrer.d.ts","sourceRoot":"","sources":["../src/referrer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAgB5F,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,aAAa,GAAG,IAAI,CAoBtB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,aAAa,GAAG,IAAI,CAOtB"}
package/dist/referrer.js DELETED
@@ -1,41 +0,0 @@
1
- function fields(value) {
2
- return typeof value === 'object' && value !== null && !Array.isArray(value)
3
- ? value
4
- : null;
5
- }
6
- function named(held, ...keys) {
7
- const present = Object.keys(held);
8
- return (present.length === keys.length &&
9
- keys.every((key) => typeof held[key] === 'string' && held[key] !== ''));
10
- }
11
- export function houseReferrer(referrer, tracked) {
12
- const held = fields(referrer);
13
- if (held === null)
14
- return null;
15
- if (named(held, 'room', 'path')) {
16
- const entry = tracked.get(held.room);
17
- if (entry === undefined)
18
- return null;
19
- return {
20
- locator: entry.locator,
21
- referrer: { room_ref: entry.authority, path: held.path },
22
- };
23
- }
24
- if (named(held, 'room_ref', 'record')) {
25
- const roomRef = held.room_ref;
26
- const entry = [...tracked.values()].find((candidate) => candidate.authority === roomRef);
27
- return {
28
- locator: entry?.locator ?? roomRef,
29
- referrer: { room_ref: roomRef, record: held.record },
30
- };
31
- }
32
- return null;
33
- }
34
- export function houseReferrerScope(referrer, tracked) {
35
- const held = fields(referrer);
36
- if (held !== null && named(held, 'room', 'path')) {
37
- return { locator: held.room, path: held.path };
38
- }
39
- const found = houseReferrer(referrer, tracked);
40
- return found === null ? null : { locator: found.locator };
41
- }