@agentshouse/mdruntime 0.1.0-ca9afacd5aebd → 0.1.0-cab6762661a85

package/AGENTS.md

@@ -1,318 +0,0 @@
-# Instructions for the App Creator's agent
-
-These instructions address an agent in an environment with Git. Obtain the
-App Repository, change it, build, and push. They are documentation, not enforcement.
-
-## The MD Runtime API
-
-App code reaches the MD Runtime through the remote client. The surfaces are
-Rooms, Query, Search, Observe, Types, Room Draft, Save, History, the binary file
-reads, Call, Reached, Log,
-the reported persistence answer, reauthorization, conversation, the chat draft,
-and Presentation State. Sync Status, the Service Mode, the storage-loss
-statement, the deployment facts and the signed-in member are observations only.
-
-The host attaches each port with its reach, and every member and observation
-answers within it: a Room outside it answers as one the replica does not hold,
-Rooms lists only the Rooms reached whole, a Room reached for single Documents
-shows only those Documents and the Types of the models that govern them, and
-without conversations the conversation members, the chat draft and the
-conversation observation hold none.
-A change of the reach reaches every open observation as its new value, a query
-keeping every unchanged Document the same object.
-
-Every `observe` resolves, once its first value has arrived, to a handle:
-`current()` is the latest complete value, `subscribe(listener)` hears each later
-value whole and returns its unsubscribe, and `close()` ends the observation.
-Closing the port ends every handle and rejects every pending call and
-observation; a client that reconnects observes again.
-
-`observe('agents')` answers every Agent a new conversation can go to, each
-`{ identity, name }`, whether or not it has a conversation yet.
-Each conversation the Provider's conversation list names is held complete in the
-browser. `conversation.list()` and `observe('conversations')` answer each with its
-Agent's identity and name, its name, created and finished times, last outcome and live
-`state`: `asking` while a question waits, `working` while a turn runs, else `idle`,
-and `started`, when the running turn began, or `null`.
-Observe one with `observe('conversation', id, { limit })`: the view
-holds its latest `limit` messages, or all of them, oldest first, its chat
-draft, and what the Provider streams for it whether or not anything views it:
-the running `turn` with its message parts and its context in use and window, the
-open questions, the process state, and the CLI's commands and options. These live
-only in memory: the message accepted under the turn's id replaces the running turn,
-and none of them is stored or searchable.
-`chatDraft.write` and `chatDraft.discard` keep what the App Creator composes;
-sending it is a Provider Action that needs the Provider reachable and is never
-queued.
-
-A binary file at a Path of a Room is a binary Path entry. Query lists it by
-`path` with its `binaryFile` record and never its bytes: `{ state: 'accepted',
-revision, path, fileRef, byteLength, mediaType, sha256 }`, or, from a Save until
-the Provider accepts it, `{ state: 'pending', localId, path, byteLength,
-mediaType, sha256 }` with no revision. Write one with a Room Draft whose only part
-is `file: { blob }`, a `Blob` whose `type` is its media type; Save keeps the bytes
-in its Pending Change, works offline, and the record turns accepted with the
-Provider's revision once the Pending Change is accepted. Move or remove an
-accepted one as a Document. Move or remove a pending one the same way, before or
-after Save: the Room Draft or its queued Pending Change carries the bytes to the
-new Path or drops them, and once that Pending Change has gone to the Provider
-Save refuses it as `unknown-revision` until it is accepted. Read the bytes with
-`binaryFile.read(room, path)`: a pending record answers its saved bytes, and
-every read of an accepted one asks the Provider again and keeps nothing. Pass a
-History revision as `binaryFile.read(room, path, revision)` to open that
-revision, a removed file's last one included. Text, a Record attachment or a conversation
-message may name a file directly by its `fileRef`; read that file with
-`binaryFile.readReference({ fileRef, referrer })`, where the referrer is the
-`referrer` the Provider gave beside the reference, or `{ room, path }` of the
-document whose text names it. Both answer `{ kind: 'binary', blob }` or a
-refusal or failure. History of a binary Path lists each revision's
-`binaryFile` metadata without bytes.
-
-Rooms, Query, Search, Observe, Types, Room Draft, Save, and Reached never
-touch the network.
-History, the binary file reads and Call go to the Provider through the Adapter. Call takes the Action names
-the Adapter declares; any other name answers `undeclared` without reaching the
-Provider. A Call result whose
-effect the Provider places in a Room carries `at`, that Room and Room Version;
-`reached(room, roomVersion)` answers whether the Room's confirmed state has
-reached it, and the MD Runtime keeps refreshing that Room until it has;
-`reached(room, roomVersion, path)` answers whether the held confirmed copy of
-that document was written at a later Room Version. Each History revision
-names its author, `{ kind: 'user', id }` or `{ kind: 'site', id, name }`.
-History of a Path no current document holds answers the removed document's
-revisions with `deleted: true`, newest first; that revision is what a link to
-the Path opens. Every
-member of the
-client is asynchronous. Results are detached snapshots. Nothing in this
-surface returns the authorization, performs a request the App's code
-composes, or exposes the browser store.
-
-Every refusal and failure carries `code` and `retryable`: each Call and History answer
-other than its result, a refused Save or Room Draft write, a returned Room Draft's
-reason, a Room's refusal and the Connection Refusal, and every error a member rejects
-with, beside its message. A Provider refusal carries the Provider's own `retryable`.
-Every code and every value the API answers is open: handle one you do not know by its
-`code` and `retryable`.
-
-Read the deployment facts with `observe('deployment-facts')`. Interpret the
-opaque value using the host's contract.
-
-`observe('member')` answers who uses the App: the User the Provider signed in,
-`{ kind: 'user', id, name }` in the shape of a change's `author`, so a Document
-whose `change.author.id` equals its `id` is that User's own. It is `null` until
-the Provider first names one, and where it names none, such as a Site. The
-MD Runtime keeps it with the Local Replicas, so it answers offline once known,
-and every port hears the next member the Provider names; signing out answers
-`null`, then ends the observation with the authorization. It is the only way App code learns who
-uses it.
-
-The in-memory Adapter at `@agentshouse/mdruntime/memory` is for tests and
-ships in no bundle.
-
-## Local Query rules
-
-`query(q)` answers once from local state; `observe('query', q)` holds the whole
-result and hears it again only when it changes, keeping every unchanged Document
-the same object, so a component can tell what changed by identity. A query is
-data:
-
-- **Filter.** `rooms` names Room locators and defaults to every Room. `types`
-  names MD Types, and `any` names untyped Markdown Documents. `pathPrefix` is a
-  directory: `notes` keeps `notes/a.md` and not `notes2/a.md`.
-- **Fields.** Every frontmatter value is named by JSON Pointer: `/status`,
-  `/shipping/city`, `~1` for a `/` and `~0` for a `~` in a key. A segment that
-  meets a list applies to every item and a number names one item. `where` names
-  pointers, ANDs them, and nests `$and` and `$or`; a pointer through a list holds
-  when any item satisfies it. A bare value is equality; the operators are `$eq`,
-  `$ne`, `$in`, `$nin`, `$gt`, `$gte`, `$lt`, `$lte`, `$all`, `$size` and
-  `$exists`. Equality on a list asks whether it contains the value. Missing, null and empty differ:
-  `$exists: false` keeps a missing field, `null` an explicit null, `''` empty
-  text and `$size: 0` an empty list. A date compares in calendar order and never
-  with a date-time. A reference compares by the Room Path it resolves to.
-  Untyped frontmatter, and a value under `oneOf` or a conditional, is plain
-  values. There is no text containment or regular
-  expression.
-- **Relations.** `hop: { field, types, where, pathPrefix }` keeps Documents whose
-  reference at pointer `field`, at any depth, points to a matching Document of the
-  same Room. `backlinks: { field, types, where, pathPrefix }` keeps Documents that a
-  matching Document of the same Room references. Each keeps a Document once.
-- **Parts.** A Document query must `select`: `'all'`, or `fields`, `sections`,
-  `preamble`, `markdown`, `backlinks` and `change`, where `fields` is `'all'` or a
-  list of pointers and `sections` `'all'` or a list of names. Selected pointers
-  return the frontmatter holding only them, nested as written. A backlink names
-  the referring Path, MD Type and the pointer it came from as `field`. Room and Path always return; a Markdown
-  Document also returns its MD Type. A non-Markdown Document returns only Room
-  and Path, and a binary Path entry Room, Path and its `binaryFile` record,
-  whatever is selected. An unselected part is absent. Select only
-  what a screen shows: a list that selects the Markdown hears every edit of it.
-- **Change.** `change` is `{ author, time }` of the Document's head revision as
-  the Provider last delivered it: `author` is `{ kind: 'user' | 'site', id, name }`
-  or `null` for a write the Provider made itself, and `time` is the Provider's
-  ISO 8601 change time. It is `null` where the Provider delivered no time, as at
-  a Site. An unsent edit or move keeps it, an unsent creation has none, and a
-  saved write takes the Provider's own once it is Accepted. A
-  Room's last change is its Document with the latest `time`.
-- **Order and groups.** `orderBy` sorts by `room`, `path`, `type` or `{ field }`
-  with TanStack DB's own options, and ties end with Room, then Path. `groupBy` by
-  `room`, `type` or `{ field }` answers `{ groups: [{ key, count }] }`, counted
-  over every match and ordered by `count` or a key. A sort or group takes only a
-  pointer that holds one value. `limit` bounds the Documents or the groups.
-- **Results and errors.** A result carries no Room Version: read freshness from
-  Rooms and Sync Status. An invalid query fails with the `code`
-  `invalid-query`, `unknown-type`, `unknown-field` or `wrong-kind`, naming where,
-  and never answers an empty result in its place.
-
-## Local Search rules
-
-`search({ text, documents, conversations, limit })` answers once, by words, from
-local state, with MiniSearch at its default configuration. There is no observed
-search.
-
-- **What is found.** A Document by its field values, its sections' headings and
-  text, its preamble and its Path; a message by its text. Frontmatter keys, Room
-  Drafts, chat drafts and a running turn's parts are never found. There are no phrases,
-  word forms, typo tolerance or prefix matching.
-- **Narrowing.** `documents` is a Local Query filter: `rooms`, `types`, `where`,
-  `pathPrefix`, `hop` and `backlinks`. `conversations` names conversations. Both
-  apply before `limit`, which bounds each list; without it every hit returns.
-- **Results.** `{ documents, messages }`, each ranked by `score`, which compares
-  hits of one list of one search. A Document hit names its `room`, `path` and
-  `type`, a message hit its `conversation` and `identity`, and `matches` maps each
-  matched word to the parts it matched in: `fields`, `sections`, `preamble` or
-  `path`, or `text`. A hit carries no position; mark the words in the text you
-  show. An invalid filter fails with its Local Query error.
-
-## Room Draft, Save, and outcome rules
-
-The MD Runtime owns one Room Draft per Room and Path, shared by every App and
-tab. It is durable: it survives reload and navigation. A Room that Discovery
-stops listing takes its Room Drafts and its queue with it.
-Write a Room Draft with `roomDraft.write(room, path, revision, parts)`, naming
-the revision you read, or `null` when there was none, and every part it should
-now change: fields, sections and the preamble, or the whole Markdown, a
-creation, a move, or a removal. A part new to the Room Draft names its base,
-the value you showed when it was opened; the MD Runtime keeps a part's first
-base. A binary link target has a Room Draft too, for a move or a removal, with
-`null` as its base. A write or a discard from an older revision is refused as `stale` with
-the current Room Draft; read it and write again.
-
-Save takes one Room and the Room Drafts of it to save, each with its revision,
-validates locally, and on success appends one Change Batch to that Room's
-queue and removes those Room Drafts. It is refused with the `code` `stale`,
-`changed-underneath` naming each part whose base no longer matches the visible
-state, or a local validation rule, and then creates nothing and leaves every
-Room Draft in place. A directory move or removal is a move or removal part on
-each Document and binary link target beneath it, saved together.
-
-Outcomes follow the Provider's answer. An Accepted Change Batch stays in the
-queue, drawn over the confirmed layer, until the confirmed layer reaches the
-Room Version it was accepted at, and then leaves it. Conflicted and Rejected, an expired operation, and a change that no
-longer applies over the Room each leave the queue and return as Room Drafts on
-the Documents they changed, marked with why: the Provider's structured refusal
-code and fields as returned, not known to have applied, or withdrawn locally.
-The rest of the queue keeps synchronizing, and Sync Status requires attention
-until each returned Room Draft is saved again or discarded. A Change Batch
-keeps no outcome once it leaves the queue; `observe('queue', room)` shows each
-Pending one, and a returned Room Draft says why it returned. Transport
-failure and Provider unavailability keep work Pending and do not infer a
-rejection. A refusal the Provider marks retryable stays Pending until the reset
-it names; the MD Runtime retries the same Change Batch identity and payload and
-never infers an outcome from transport uncertainty. The MD Runtime never
-combines, reorders, or rebases.
-
-On a Site, every Save stays in the visitor's browser. Write grants and
-revisions do not refuse it, and its Pending Change shows in every query and
-across reloads until the browser's storage is cleared. It is never sent:
-`observe('queue', room)` shows it `local`, and Sync Status never waits on it.
-Once the Room changes so that it no longer applies, it leaves the queue and
-returns no Room Draft.
-
-`observe('service-mode')` answers the Provider's Service
-Mode, `open` or `write-halted`. While writes are halted, Save still succeeds,
-its Change Batch waits unsent, and the queue is submitted in order once the
-Provider reopens writes. An Action is never held: a write the Provider refuses
-for the halt returns that refusal to its caller. Show the Provider as read-only
-instead of retrying.
-
-## The neutrality rule
-
-No module outside an Adapter package imports, names, or special-cases a
-Provider. MD UI and every App reach data only through the client entry.
-
-## Content-safety rules
-
-The Provider authorization belongs to the Runtime host and is never readable
-by the App's code. The App's code reaches the network only at the external
-origins its manifest declares, empty by default, and the Provider enforces
-that set. Every request to the Provider itself goes through the MD Runtime.
-Rendered Markdown never executes scripts, renders raw HTML only for the
-details and summary elements, and loads images and other resources only from
-origins the Provider's policy allows.
-
-## Launch promises MD UI keeps
-
-MD UI uses semantic HTML, is fully operable from a keyboard with visible
-focus and labelled controls, and lays out from a 360 pixel wide viewport to
-a desktop. Its strings are English only, dates and numbers follow the
-browser locale, and content is never translated. Light and dark themes come
-from CSS custom properties with the browser's preference as the default and
-an App's override respected. What an App Creator's agent adds carries none
-of these promises by itself. Reading, querying and searching never wait for
-the network. Data lives only in the App Creator's browser and with the Provider.
-
-## App code takes the client its host hands it and never constructs a Runtime
-
-App code takes the client its host hands it: in House, `houseBridge().runtime`
-from `@agentshouse/app-bridge` resolves to the client House built into the page.
-It never constructs a Runtime or a client. It imports only types from
-`@agentshouse/mdruntime/client`, does not call `connectMdRuntime` or
-`serveMdRuntime`, and does not import the package main, the host entry, or the
-Adapter package. Hosts and tests use those entries; the served App does not.
-
-A React App may observe and save through `@agentshouse/mdruntime/react`, which
-names React as a peer dependency. `useObserve(client, topic, ...input)` takes
-the arguments of `observe` and returns `{ state: 'loading' }` until the topic's
-first value arrives, then `{ state: 'ready', value }`, re-rendering on each
-change; a `null` client observes nothing and stays loading. `useSave(client)`
-returns `busy`, the last `outcome` or `failure`, and `save(room, roomDrafts)`,
-which writes each Path's parts onto the Room Draft already there, keeping the
-bases its parts have, or onto a new one, and saves them together. A refused
-Save leaves the Room Drafts for the App to save again or discard; a failure is
-recorded and rejects. `saveRoomDrafts(client, room, roomDrafts)` is that save
-outside a component. A react-admin or Refine App reads and writes its Rooms
-through the data providers of `@agentshouse/mdruntime-families`.
-
-## The Chat
-
-`@agentshouse/mdruntime/chat` holds the Chat, one data layer for every App.
-Its required peers are React, React DOM and `@assistant-ui/react`: add React as
-a dependency, also in an App not written in React.
-
-Place the ready chat with `<Chat client={runtime} conversation={id}
-agent={agent} width="1/3" showChats />`: `conversation` opens one, `null` for a
-new chat, `agent` is the Agent a new chat goes to, `onOpen` hears each one it
-opens, and `width` is `full` (the place you give it), or `3/4`, `1/2` or `1/3`
-of the window docked at its right edge, whole on a narrow window. `showChats`
-adds its conversation list; or draw your own inside a `ChatProvider` around a
-`<Chat />` with no `client`. It carries its own styles; theme it with CSS custom
-properties on it or an ancestor: `--chat-background`, `--chat-surface`,
-`--chat-text`, `--chat-text-muted`, `--chat-accent`, `--chat-line`,
-`--chat-attention`, `--chat-danger`, `--chat-font`, `--chat-font-mono`,
-`--chat-font-size`, `--chat-radius` and `--chat-density` (a factor for spacing);
-an unset one keeps House's light or dark look. `mountChat(element, { client })`
-places it outside React and returns `update(props)` and `unmount()`.
-
-Mix `ChatMessageList` (`components` takes your `UserMessage` and
-`AssistantMessage`), `ChatInput` and `ChatQuestionCard` with your own design
-inside a `ChatProvider`, or compose assistant-ui's primitives there; `useChat()`
-gives `send`, the conversations, the Agents, questions to `answer`, `options`
-to `choose`, `commands`, the queue to `edit` or `unqueue`, `stop`, `kill` and
-outcomes; never replace its messages, sending or store. A secret question is
-never answered here; typed answers live in Presentation State's `typed` key:
-keep it, and change Presentation State only inside `inTurn(client, work)` from
-`@agentshouse/mdruntime/client`. `Markdown` draws Markdown safely.
-
-## What an agent must never do
-
-An agent must never read the authorization, load code from a Room, call the
-Provider directly, or rebase a refused Change Batch.

package/dist/chat/acts.d.ts

@@ -1,34 +0,0 @@
-import { type Answered } from '../attempt.js';
-import { type CallResult } from '../outcome.js';
-import type { Expected } from './overlay.js';
-export type ChatResult = CallResult | {
-    readonly kind: 'offline';
-};
-export type ChatOutcome = {
-    readonly state: 'sending';
-} | {
-    readonly state: 'offline';
-} | {
-    readonly state: 'failed';
-    readonly result: CallResult;
-};
-export declare function accepted(result: ChatResult): result is Extract<CallResult, {
-    readonly kind: 'action';
-}>;
-export declare function unanswered(result: ChatResult): boolean;
-export declare function outcomeOf(result: ChatResult): ChatOutcome | null;
-export declare function answeredOf(result: ChatResult): Answered;
-export type Sender = {
-    carried(name: string, about: unknown, sending: (operation: string) => Promise<CallResult>): Promise<ChatResult>;
-    expect(expected: Expected): void;
-    draw(expected: Expected): void;
-};
-type Senders = {
-    readonly online: boolean;
-    identity(intent: string): string;
-    expect(expected: Expected): void;
-    draw(expected: Expected): void;
-};
-export declare function sender({ online, identity, expect, draw }: Senders): Sender;
-export {};
-//# sourceMappingURL=acts.d.ts.map

package/dist/chat/acts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"acts.d.ts","sourceRoot":"","sources":["../../src/chat/acts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE9D,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,GACjB,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAE5D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAGhE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAIvD;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,KAAK,OAAO,GAAG;IACb,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,GAAG,MAAM,CAa1E"}

package/dist/chat/acts.js

@@ -1,36 +0,0 @@
-import { intentOf } from '../attempt.js';
-import { UNCERTAIN } from '../outcome.js';
-export function accepted(result) {
-    return result.kind === 'action';
-}
-export function unanswered(result) {
-    return result.kind === 'transport-uncertainty';
-}
-export function outcomeOf(result) {
-    if (accepted(result))
-        return null;
-    return result.kind === 'offline' ? { state: 'offline' } : { state: 'failed', result };
-}
-export function answeredOf(result) {
-    if (accepted(result))
-        return 'accepted';
-    if (result.kind === 'offline')
-        return 'offline';
-    return unanswered(result) ? 'unanswered' : 'refused';
-}
-export function sender({ online, identity, expect, draw }) {
-    return {
-        async carried(name, about, sending) {
-            if (!online)
-                return { kind: 'offline' };
-            try {
-                return await sending(identity(intentOf(name, about)));
-            }
-            catch {
-                return UNCERTAIN;
-            }
-        },
-        expect,
-        draw,
-    };
-}

package/dist/chat/context.d.ts

@@ -1,3 +0,0 @@
-import type { TurnContext } from '../adapter.js';
-export declare function contextText(context: TurnContext): string;
-//# sourceMappingURL=context.d.ts.map

package/dist/chat/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/chat/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQjD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAExD"}

package/dist/chat/context.js

@@ -1,10 +0,0 @@
-function figure(tokens) {
-    if (tokens >= 1_000_000)
-        return `${(tokens / 1_000_000).toFixed(1).replace(/\.0$/, '')}M`;
-    if (tokens >= 1_000)
-        return `${Math.round(tokens / 1_000)}k`;
-    return String(tokens);
-}
-export function contextText(context) {
-    return `${figure(context.used)}/${figure(context.window)}`;
-}

package/dist/chat/input.d.ts

@@ -1,9 +0,0 @@
-import { type ReactElement, type ReactNode } from 'react';
-import { type ChatNoteProps } from './kit.js';
-export type ChatInputProps = {
-    readonly messageLength?: number;
-    readonly note?: (note: ChatNoteProps) => ReactNode;
-    readonly autoFocus?: boolean;
-};
-export declare function ChatInput({ messageLength, note, autoFocus, }: ChatInputProps): ReactElement;
-//# sourceMappingURL=input.d.ts.map

package/dist/chat/input.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/chat/input.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBlG,OAAO,EAAsD,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAMlG,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,SAAS,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAiGF,wBAAgB,SAAS,CAAC,EACxB,aAAa,EACb,IAAY,EACZ,SAAiB,GAClB,EAAE,cAAc,GAAG,YAAY,CA+K/B"}

package/dist/chat/input.js

@@ -1,99 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useContext, useEffect, useMemo, useRef } from 'react';
-import { ComposerPrimitive, useAui, useAuiState, } from '@assistant-ui/react';
-import { DropdownMenu } from 'radix-ui';
-import ArrowUp from 'lucide-react/dist/esm/icons/arrow-up.mjs';
-import Check from 'lucide-react/dist/esm/icons/check.mjs';
-import ChevronDown from 'lucide-react/dist/esm/icons/chevron-down.mjs';
-import CornerDownRight from 'lucide-react/dist/esm/icons/corner-down-right.mjs';
-import ListEnd from 'lucide-react/dist/esm/icons/list-end.mjs';
-import Paperclip from 'lucide-react/dist/esm/icons/paperclip.mjs';
-import Pencil from 'lucide-react/dist/esm/icons/pencil.mjs';
-import Plus from 'lucide-react/dist/esm/icons/plus.mjs';
-import Square from 'lucide-react/dist/esm/icons/square.mjs';
-import X from 'lucide-react/dist/esm/icons/x.mjs';
-import { contextText } from './context.js';
-import { Button, ChatNote, IconButton, Name, Portal, Scoped } from './kit.js';
-import { COMMAND } from './process.js';
-import { useChat, useChatScope } from './provider.js';
-import { forgetAnswers } from './question.js';
-import { useOpened } from './opened.js';
-const commanded = {
-    serialize: (item) => `${COMMAND}${item.id}`,
-    parse: (said) => [{ kind: 'text', text: said }],
-};
-const atStart = (said, char, cursor) => {
-    const typed = said.slice(0, cursor);
-    return typed.startsWith(char) && !/\s/.test(typed)
-        ? { query: typed.slice(char.length), offset: 0, endOffset: cursor }
-        : null;
-};
-function commandItem(command) {
-    return {
-        id: command.name,
-        type: 'command',
-        label: `${COMMAND}${command.name}`,
-        description: command.description,
-    };
-}
-function commandsFound(commands, query) {
-    const asked = query.toLowerCase();
-    const named = commands.filter((one) => one.name.toLowerCase().startsWith(asked));
-    const within = commands.filter((one) => !named.includes(one) && one.name.toLowerCase().includes(asked));
-    return [...named, ...within].map(commandItem);
-}
-function Attached({ id, name }) {
-    const aui = useAui();
-    return (_jsxs("span", { className: "ahc-chip ahc-chip--removable", children: [_jsx(Paperclip, { "aria-hidden": "true" }), _jsx(Name, { text: name }), _jsx(IconButton, { label: `Remove ${name}`, compact: true, onClick: () => void aui.composer().attachment({ id }).remove(), children: _jsx(X, { "aria-hidden": "true" }) })] }));
-}
-function Picker({ option, choose, }) {
-    const container = useContext(Portal);
-    return (_jsxs(DropdownMenu.Root, { modal: false, children: [_jsxs(DropdownMenu.Trigger, { className: "ahc-btn ahc-picker", "aria-label": option.name, title: option.name, children: [_jsx(Name, { text: option.values.find((one) => one.value === option.value)?.name ?? option.value }), _jsx(ChevronDown, { "aria-hidden": "true" })] }), _jsx(DropdownMenu.Portal, { container: container, children: _jsxs(DropdownMenu.Content, { className: "ahc-menu", side: "top", align: "start", children: [_jsx(DropdownMenu.Label, { className: "ahc-menu__heading", children: option.name }), _jsx(DropdownMenu.RadioGroup, { value: option.value, onValueChange: (value) => {
-                                if (value !== option.value)
-                                    void choose(option.id, value);
-                            }, children: option.values.map((one) => (_jsxs(DropdownMenu.RadioItem, { value: one.value, className: "ahc-row", children: [_jsx("span", { className: "ahc-row__label", children: one.name }), _jsx(DropdownMenu.ItemIndicator, { asChild: true, children: _jsx(Check, { "aria-hidden": "true" }) })] }, one.value))) })] }) })] }));
-}
-function noted(note) {
-    return _jsx(ChatNote, { ...note });
-}
-export function ChatInput({ messageLength, note = noted, autoFocus = false, }) {
-    const chat = useChat();
-    const { client } = useChatScope();
-    const aui = useAui();
-    const opened = useOpened();
-    const { lone, commands, context, queued, running } = opened;
-    const conversation = chat.conversation ?? '';
-    const input = useRef(null);
-    const picker = useRef(null);
-    const thread = chat.conversation ?? `new:${chat.agent ?? ''}`;
-    useEffect(() => {
-        if (autoFocus)
-            input.current?.focus();
-    }, [autoFocus, thread]);
-    const typed = useAuiState((s) => s.composer.text);
-    const attached = useAuiState((s) => s.composer.attachments.length > 0);
-    const fault = messageLength !== undefined && typed.length > messageLength
-        ? `Keep it to ${messageLength} characters.`
-        : null;
-    const listed = useMemo(() => ({
-        categories: () => [],
-        categoryItems: () => [],
-        search: (query) => commandsFound(commands, query),
-    }), [commands]);
-    const interrupt = () => void chat.stop().then((stopped) => {
-        if (stopped)
-            void forgetAnswers(client, conversation);
-    });
-    const edit = (id) => {
-        chat.edit(id);
-        input.current?.focus();
-    };
-    const drafted = typed.trim() !== '' || attached;
-    const readOnly = opened.deleted;
-    return (_jsx(Scoped, { children: _jsxs("div", { className: "ahc-input-area", children: [readOnly || queued.length === 0 ? null : (_jsxs("div", { role: "group", "aria-label": "Queued messages", className: "ahc-queue", children: [_jsxs("div", { className: "ahc-queue__head", children: [_jsx(ListEnd, { "aria-hidden": "true" }), _jsx("span", { className: "ahc-queue__said", children: `${queued.length} ${queued.length === 1 ? 'message waits' : 'messages wait'} for ${opened.name} to finish` }), running ? (_jsx(Button, { variant: "outline", compact: true, onClick: interrupt, children: "Send now" })) : null] }), queued.map((item) => (_jsxs("div", { className: "ahc-queue-row", children: [_jsx(CornerDownRight, { "aria-hidden": "true", className: "ahc-muted" }), _jsx("span", { className: "ahc-queue-row__text", children: item.text }), _jsx(IconButton, { label: "Edit queued message", compact: true, onClick: () => edit(item.id), children: _jsx(Pencil, { "aria-hidden": "true" }) }), _jsx(IconButton, { label: "Remove queued message", compact: true, onClick: () => chat.unqueue(item.id), children: _jsx(X, { "aria-hidden": "true" }) })] }, item.id)))] })), readOnly ? null : (_jsx(ComposerPrimitive.Root, { className: "ahc-composer", children: _jsxs(ComposerPrimitive.Unstable_TriggerPopoverRoot, { children: [commands.length === 0 ? null : (_jsxs(ComposerPrimitive.Unstable_TriggerPopover, { char: COMMAND, matcher: atStart, adapter: listed, "aria-label": "Commands", className: "ahc-menu ahc-commands", children: [_jsx(ComposerPrimitive.Unstable_TriggerPopover.Directive, { formatter: commanded }), _jsx(ComposerPrimitive.Unstable_TriggerPopoverItems, { children: (items) => items.map((item, index) => (_jsx(ComposerPrimitive.Unstable_TriggerPopoverItem, { item: item, index: index, className: "ahc-row ahc-row--two", children: _jsxs("span", { className: "ahc-row__label", children: [_jsx("span", { className: "ahc-row__title ahc-mono", children: item.label }), _jsx("span", { className: "ahc-row__sub", children: item.description })] }) }, item.id))) })] })), attached ? (_jsx("div", { className: "ahc-chips", children: _jsx(ComposerPrimitive.Attachments, { children: ({ attachment }) => _jsx(Attached, { id: attachment.id, name: attachment.name }) }) })) : null, _jsx(ComposerPrimitive.Input, { asChild: true, "aria-label": "Message", placeholder: lone === null ? `Message ${opened.name}` : lone.field.prompt, submitMode: fault === null ? 'enter' : 'none', children: _jsx("textarea", { ref: input, className: "ahc-composer__input", rows: 1 }) }), _jsxs("div", { className: "ahc-composer__bar", children: [_jsx(IconButton, { label: "Add files", onClick: () => picker.current?.click(), children: _jsx(Plus, { size: 20, "aria-hidden": "true" }) }), _jsx("input", { ref: picker, type: "file", multiple: true, hidden: true, onChange: (event) => {
-                                            const chosen = [...(event.target.files ?? [])];
-                                            event.target.value = '';
-                                            for (const file of chosen)
-                                                void aui.composer().addAttachment(file);
-                                        } }), opened.options.map((option) => (_jsx(Picker, { option: option, choose: chat.choose }, option.id))), _jsx("span", { className: "ahc-spacer" }), context === null ? null : (_jsx("span", { title: "Context in use", className: "ahc-meta", children: contextText(context) })), running ? (_jsx("button", { type: "button", className: `ahc-btn ahc-btn--icon ${drafted ? 'ahc-btn--outline' : 'ahc-btn--ink'}`, "aria-label": "Stop", title: "Stop", onClick: interrupt, children: _jsx(Square, { "aria-hidden": "true" }) })) : null, running && !drafted ? null : (_jsx(ComposerPrimitive.Send, { className: "ahc-btn ahc-btn--icon ahc-btn--ink", "aria-label": running ? 'Queue message' : 'Send', disabled: fault !== null, children: _jsx(ArrowUp, { size: 20, "aria-hidden": "true" }) }))] })] }) })), fault === null ? null : (_jsx("p", { className: "ahc-note", role: "status", "data-state": "refused", children: fault })), note({ outcome: chat.acting.outcome }), note({ outcome: chat.sending.outcome, again: chat.sending.again ?? undefined })] }) }));
-}

package/dist/chat/kit.d.ts

@@ -1,60 +0,0 @@
-import { type ComponentPropsWithRef, type ReactElement, type ReactNode } from 'react';
-import type { ChatOutcome } from './acts.js';
-export type Variant = 'quiet' | 'ink' | 'outline' | 'danger' | 'danger-outline';
-export declare const Portal: import("react").Context<HTMLElement | null>;
-export declare function Within({ root, children, }: {
-    root: HTMLElement;
-    children: ReactNode;
-}): ReactElement;
-export declare function Scoped({ children }: {
-    children: ReactNode;
-}): ReactElement;
-export declare function buttonClass(variant: Variant, compact: boolean, icon: boolean): string;
-type Native = Omit<ComponentPropsWithRef<'button'>, 'className'>;
-export declare function Button({ variant, compact, type, children, ...rest }: Native & {
-    variant?: Variant;
-    compact?: boolean;
-}): ReactElement;
-export declare function IconButton({ label, variant, compact, type, ...rest }: Native & {
-    label: string;
-    variant?: Variant;
-    compact?: boolean;
-}): ReactElement;
-export declare function Name({ text, className }: {
-    text: string;
-    className?: string;
-}): ReactElement;
-export declare function Menu({ trigger, children, }: {
-    trigger: ReactElement;
-    children: ReactNode;
-}): ReactElement;
-export declare function MenuGap(): ReactElement;
-export declare function MenuItem({ icon, danger, onSelect, children, }: {
-    icon: ReactNode;
-    danger?: boolean;
-    onSelect: () => void;
-    children: ReactNode;
-}): ReactElement;
-export declare function Confirm({ title, text, action, onConfirm, onClose, }: {
-    title: string;
-    text: string;
-    action: string;
-    onConfirm: () => void;
-    onClose: () => void;
-}): ReactElement;
-export declare function ItemRow({ lead, title, sub, trailing, }: {
-    lead: ReactNode;
-    title: ReactNode;
-    sub: ReactNode;
-    trailing: ReactNode;
-}): ReactElement;
-export declare function Working({ step }: {
-    step?: string | undefined;
-}): ReactElement;
-export type ChatNoteProps = {
-    readonly outcome: ChatOutcome | null;
-    readonly again?: (() => void) | undefined;
-};
-export declare function ChatNote({ outcome, again }: ChatNoteProps): ReactElement | null;
-export {};
-//# sourceMappingURL=kit.d.ts.map

package/dist/chat/kit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/chat/kit.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAEhF,eAAO,MAAM,MAAM,6CAA0C,CAAC;AAE9D,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAQf;AAED,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CAa1E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CASrF;AAED,KAAK,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AA0BjE,wBAAgB,MAAM,CAAC,EACrB,OAAiB,EACjB,OAAe,EACf,IAAe,EACf,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,MAAM,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAMlE;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,OAAiB,EACjB,OAAe,EACf,IAAe,EACf,GAAG,IAAI,EACR,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CASjF;AAED,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAM5F;AAED,wBAAgB,IAAI,CAAC,EACnB,OAAO,EACP,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAqBf;AAED,wBAAgB,OAAO,IAAI,YAAY,CAEtC;AAED,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,MAAc,EACd,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAYf;AAED,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,IAAI,EACJ,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,GAAG,YAAY,CAsDf;AAED,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,KAAK,EACL,GAAG,EACH,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAWf;AAMD,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,YAAY,CAiB7E;AASD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAuB/E"}