@agentshouse/app-bridge 0.1.0-c1bc683ed8f4e → 0.1.0-c1e11b9031ca4

package/dist/calls.d.ts

@@ -1,6 +1,7 @@
 export interface HouseCalls {
     readonly 'access.read': {
         readonly room_ref: string;
+        readonly statistics?: boolean;
     };
     readonly 'conversation.answer': {
         readonly answer: {

package/dist/index.d.ts

@@ -72,6 +72,7 @@ export interface HouseExternalRequest {
     readonly body_base64?: string;
     readonly account?: string;
     readonly slot?: string;
+    readonly room_ref?: string;
 }
 export type HouseExternalAnswer = {
     readonly status: number;

package/dist/mdmodel/definition.d.ts

@@ -29,12 +29,26 @@ export type Shape = {
     readonly schema: Readonly<Record<string, unknown>>;
     readonly defs: Readonly<Record<string, unknown>>;
 };
+export type RuleValue = string | number | boolean | null;
+export type Transition = {
+    readonly from: RuleValue;
+    readonly to: RuleValue;
+    readonly roles?: readonly string[];
+};
+export type FieldRules = {
+    readonly changeRoles?: readonly string[];
+    readonly initialRoles?: readonly string[];
+    readonly transitions?: readonly Transition[];
+};
 export type Definition = {
     readonly name: string;
     readonly memberDocument: boolean;
     readonly frontmatter: ValueFacts;
     readonly fields: Readonly<Record<string, ValueFacts>>;
     readonly sections: Readonly<Record<string, SectionSpec>>;
+    readonly rules: Readonly<Record<string, FieldRules>>;
+    readonly createRoles?: readonly string[];
+    readonly deleteRoles?: readonly string[];
     readonly shape: Shape;
 };
 export type Failure = {

package/dist/mdmodel/index.d.ts

@@ -10,9 +10,9 @@ export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
 export { project } from './project.js';
 export { references } from './references.js';
 export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
-export type { Definition, JsonType, PatternFacts, PointerFacts, SectionSpec, Shape, ValueFacts, } from './definition.js';
+export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, SectionSpec, Shape, Transition, ValueFacts, } from './definition.js';
 export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, LinkOccurrence, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, Span, Validation, ValidationContext, VerifiedModel, } from './types.js';
 export { checkDocument, resolves, sectionReferences, validate, verify } from './validate.js';
 export { VERSION } from './version.js';
-export { equalValue, frontmatterValue } from './yaml.js';
+export { bodyAfterFrontmatter, equalValue, frontmatterValue } from './yaml.js';
 export type { FrontmatterValue } from './yaml.js';

package/dist/mdruntime/adapter.d.ts

@@ -277,6 +277,7 @@ export type BootstrapPage = {
     models?: RoomModels;
     documents: Readonly<Record<string, string>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     pageToken?: PageToken;
@@ -296,6 +297,7 @@ export type RefreshPage = {
     models?: RoomModels;
     documents: Readonly<Record<string, string>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     removals: readonly string[];
@@ -324,6 +326,7 @@ export type MutationResult = {
     roomVersion: string;
     documents: Readonly<Record<string, string>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     removals: readonly string[];
     binaryFiles?: Readonly<Record<string, BinaryFile>>;
@@ -423,6 +426,7 @@ export type RoomStreamEvent = {
 } | {
     kind: 'closed';
     revoked: boolean;
+    lost: boolean;
 } | {
     kind: 'opening';
     expired: readonly string[];

package/dist/mdruntime/connection.d.ts

@@ -1,6 +1,7 @@
 import { type TypesResult } from './model.js';
 import { type Observation } from './observation.js';
 import { type DocumentQuery, type DocumentResult, type GroupQuery, type GroupResult, type PendingResult } from './query.js';
+import { type EntrySeed } from './seed.js';
 import { type SearchRequest, type SearchResult } from './search.js';
 import { type Adapter, type Authorization, type Member, type ProviderRefusal, type ServiceMode } from './adapter.js';
 import { type ChatDraftSurface, type ConversationAgent, type ConversationEntry, type ConversationOptions, type ConversationSurface, type ConversationView } from './conversation.js';
@@ -14,7 +15,7 @@ import { type RoomDraft, type RoomDraftWrite } from './room-draft.js';
 import { type SyncStatus } from './status.js';
 import { type RuntimeShell } from './durability.js';
 import { type RuntimeDemand } from './acquisition.js';
-import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness } from './readiness.js';
+import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness, type SearchObligation } from './readiness.js';
 import { type NarrowedView, type PortReach, type RuntimeView } from './reach.js';
 export type AppTypedSelection = {
     roots: readonly string[];
@@ -126,8 +127,10 @@ export type ReadinessPort = {
     readonly target: string;
     readonly code: CodeAvailability;
     readonly capacity: CapacityCause | null;
+    readonly search: SearchObligation;
 };
 export type ComposedRuntime = RuntimeView & {
+    seed(entry: EntrySeed): void;
     stop(): Promise<void>;
     lose(locators: readonly string[]): Promise<void>;
     acquire(demand: RuntimeDemand): void;

package/dist/mdruntime/conversation.d.ts

@@ -89,6 +89,7 @@ export type ConversationStore = {
     known(): boolean;
     reconnected(): void;
     reopened(): void;
+    lost(): void;
     watch(conversation: string, options: ConversationOptions, deliver: (view: ConversationView) => void): () => void;
     watchList(deliver: (entries: readonly ConversationEntry[]) => void): () => void;
     watchAgents(deliver: (agents: readonly ConversationAgent[]) => void): () => void;
@@ -100,4 +101,5 @@ export type ConversationStore = {
 };
 export declare function unheldView(conversation: string): ConversationView;
 export declare const SESSION_STARTED = "Session started";
+export declare function newChat(agent: string): string;
 export declare function createConversationStore(deps: ConversationDependencies): ConversationStore;

package/dist/mdruntime/overlay.d.ts

@@ -2,6 +2,7 @@ import type { BinaryFile, HeadChange } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 export type Heads = {
     revisions: Readonly<Record<string, string>>;
+    fileIds: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
 };
 export type HeldBinary = ({

package/dist/mdruntime/query.d.ts

@@ -55,6 +55,7 @@ export type Select = 'all' | {
     markdown?: true;
     backlinks?: true;
     change?: true;
+    fileId?: true;
 };
 export type OrderOptions = {
     nulls?: 'first' | 'last';
@@ -95,6 +96,7 @@ export type QueryDocument = {
     markdown?: string;
     backlinks?: readonly Backlink[];
     change?: HeadChange | null;
+    fileId?: string | null;
     binaryFile?: BinaryFileRecord;
 };
 export type QueryGroup = {
@@ -199,6 +201,7 @@ export type DocumentShape = {
     markdown: boolean;
     backlinks: boolean;
     change: boolean;
+    fileId: boolean;
     orderBy: readonly {
         key: KeyPlan;
         options: OrderOptions & {
@@ -219,6 +222,7 @@ export type PlanReach = {
     documents: readonly string[];
 };
 export type Plan = {
+    key: string;
     rooms: readonly string[] | null;
     reach: PlanReach | null;
     root: Scope;
@@ -240,8 +244,10 @@ type Entries = Readonly<Record<string, unknown>>;
 export declare function invalid(at: string, problem: string): never;
 export declare function plain(value: unknown): value is Entries;
 export declare function known(value: Entries, allowed: readonly string[], at: string): void;
+export declare function flag(input: unknown, at: string): boolean;
 export declare function planOf(input: unknown, facts: HeldRooms, reach?: PlanReach | null): Plan;
 export declare function limitOf(input: unknown): number | null;
 export declare function filterOf(input: unknown, facts: HeldRooms, reach?: PlanReach | null): Plan;
+export declare function queryKey(query: unknown): string;
 export declare function identityOf(plan: Plan): string;
 export {};

package/dist/mdruntime/reach.d.ts

@@ -2,7 +2,7 @@ import type { ReferrerScope } from './adapter.js';
 import type { MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
 import type { Readiness } from './readiness.js';
-import type { SearchResult } from './search.js';
+import { type SearchResult } from './search.js';
 export type ReachedDocument = {
     readonly room: string;
     readonly path: string;
@@ -27,7 +27,6 @@ export type Reachable = RuntimeView & {
     query(plan: Plan): Promise<QueryResult>;
     watchPlan(plan: Plan, deliver: (message: unknown) => void): () => void;
     search(input: unknown, reach: PortReach | null): Promise<SearchResult>;
-    searching(target: string): void;
     watchReadiness(port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
     referrerScope(referrer: unknown): ReferrerScope | null;
 };

package/dist/mdruntime/room-draft.d.ts

@@ -130,6 +130,18 @@ export declare function underneath(parts: HeldParts, path: string, visible: Visi
 export declare function heldFile(blob: Blob, base: string | null): Promise<HeldFile>;
 export declare function binaryBase(visible: VisibleLayer | undefined, path: string): string | null;
 export declare function changedParts(path: string, report: ChangedUnderneath): readonly ChangedPart[];
+export type TextParts = {
+    readonly fields?: Readonly<Record<string, {
+        readonly value: unknown;
+    }>>;
+    readonly sections?: Readonly<Record<string, {
+        readonly value: string;
+    }>>;
+    readonly preamble?: {
+        readonly value: string;
+    };
+};
+export declare function partsAfter(markdown: string, parts: TextParts): string;
 export declare function returnedInto(existing: HeldParts | undefined, returned: HeldParts): HeldParts;
 export declare function moveTarget(move: {
     readonly to: string;

package/dist/mdruntime/rows.d.ts

@@ -15,6 +15,7 @@ export type DocumentRow = {
     directories: readonly string[];
     text: string | null;
     change: HeadChange | null;
+    fileId: string | null;
     binary: BinaryFileRecord | null;
 };
 export type ReferenceRow = {
@@ -32,5 +33,5 @@ export type Row = DocumentRow | ReferenceRow;
 export declare function documentKey(room: string, path: string): string;
 export declare function roomOfKey(key: string): string;
 export declare function markdownPath(path: string): boolean;
-export declare function rowsOf(room: string, path: string, document: Frontmatter | null, composition: Composition, change: HeadChange | null, binary: BinaryFileRecord | null): readonly Row[];
+export declare function rowsOf(room: string, path: string, document: Frontmatter | null, composition: Composition, change: HeadChange | null, fileId: string | null, binary: BinaryFileRecord | null): readonly Row[];
 export {};

package/dist/mdruntime/search.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderRefusal } from './adapter.js';
 import type { ChangeSet } from './change-set.js';
 import { type CoveredRoom, type Filter, type PendingRoom } from './query.js';
 import type { Open } from './open.js';
@@ -5,6 +6,7 @@ export type DocumentPart = Open<'fields' | 'sections' | 'preamble' | 'path'>;
 export type SearchRequest = {
     text: string;
     documents?: Filter;
+    collection?: true;
     conversations?: readonly string[];
     limit?: number;
 };
@@ -31,16 +33,21 @@ export type PendingConversation = {
     conversation: string;
     awaits: Open<'index'>;
 };
-export type SearchPending = {
-    pending: readonly (PendingRoom | PendingConversation)[];
-};
 export type SearchHits = {
     documents: readonly DocumentHit[];
     messages: readonly MessageHit[];
 };
+export type SearchPending = SearchHits & {
+    pending: readonly (PendingRoom | PendingConversation)[];
+    coverage: SearchCoverage;
+};
+export type SearchUndeclared = ProviderRefusal & {
+    kind: 'undeclared';
+};
 export type SearchResult = (SearchHits & {
     coverage: SearchCoverage;
-}) | SearchPending;
+}) | SearchPending | SearchUndeclared;
+export declare function undeclaredSearch(): SearchUndeclared;
 export type SearchedDocument = {
     room: string;
     path: string;
@@ -61,6 +68,7 @@ export type SearchSource = {
 export type SearchPlan = {
     text: string;
     documents: unknown;
+    collection: boolean;
     conversations: readonly string[] | null;
     limit: number | null;
 };
@@ -77,7 +85,7 @@ export type SearchIndex = {
     search(plan: SearchPlan, documents: readonly {
         room: string;
         path: string;
-    }[] | null, conversations: readonly string[]): SearchHits;
+    }[] | null, conversations: readonly string[], rooms: ReadonlySet<string> | null, selections: ReadonlyMap<string, readonly string[]> | null): SearchHits;
 };
 export declare function searchPlanOf(input: unknown): SearchPlan;
 export declare function createSearchIndex(source: SearchSource): SearchIndex;

package/dist/mdruntime/seed.d.ts

@@ -0,0 +1,15 @@
+import type { KeyedResult } from './observation.js';
+import type { QueryRows } from './query.js';
+export type EntrySeed = {
+    readonly at: Readonly<Record<string, string>>;
+    readonly queries: readonly {
+        readonly query: unknown;
+        readonly rows: QueryRows;
+    }[];
+};
+export type Seeded = {
+    readonly rows: QueryRows;
+    readonly at: Readonly<Record<string, string>>;
+};
+export declare function entrySeedOf(value: unknown): EntrySeed | null;
+export declare function seededResult(seed: Seeded): KeyedResult;

package/dist/mdruntime/store.d.ts

@@ -23,10 +23,11 @@ export type ReplicaRecord = {
     documents: Readonly<Record<string, string>>;
     binaries: Readonly<Record<string, HeldBinary>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     written: Readonly<Record<string, string>>;
 };
-export type StagedLayer = Pick<ReplicaRecord, 'documents' | 'binaries' | 'revisions' | 'changes' | 'written'>;
+export type StagedLayer = Pick<ReplicaRecord, 'documents' | 'binaries' | 'revisions' | 'fileIds' | 'changes' | 'written'>;
 export type TransferRecord = {
     locator: string;
     transfer: string;
@@ -48,7 +49,6 @@ export type PendingState = {
 };
 export type TargetRecord = {
     established: boolean;
-    search: boolean;
 };
 export type QueueRecord = {
     locator: string;
@@ -86,6 +86,7 @@ export type ChatDraftRecord = {
     files: readonly ChatDraftFile[];
     revision: string;
     submitted?: readonly ChatSubmission[];
+    moves?: readonly string[];
 };
 export type RecordWrite = {
     next: ReplicaRecord;
@@ -128,7 +129,7 @@ export type RuntimeStore = {
     turnArrived(conversation: string, turn: string): Promise<boolean>;
     dropConversations(conversations: readonly string[]): Promise<void>;
     chatDrafts(): Promise<readonly ChatDraftRecord[]>;
-    keepChatDraft(record: ChatDraftRecord): Promise<void>;
+    keepChatDrafts(records: readonly ChatDraftRecord[]): Promise<void>;
     dropChatDraft(conversation: string): Promise<void>;
     keepRoomDraft(record: RoomDraftRecord): Promise<void>;
     discardRoomDraft(locator: string, path: string): Promise<void>;

package/docs/families.md

@@ -67,14 +67,15 @@
   refusal is House's `{ error: { code, retryable } }`, `app_release_not_found` for an
   App with no release; a read House does not answer, or one that outlived
   the browser's signed-in User, is `null`.
-- **External calls** - `callExternal({ url, method, headers, body, slot })`
+- **External calls** - `callExternal({ url, method, headers, body, slot, room_ref })`
   has House's server send an HTTPS request to one of the release's declared
   external origins and resolves with the service's `status`, `headers` and its
   body as `body` text or `body_base64`, or a refusal as House's
   `{ error: { code, retryable } }`, or `null` when House does not answer. House fills in the
-  App and its running release; naming an account slot places the key of the
-  account the User connected to it, which the App never sees, and naming none
-  sends no key. A Site's call names no slot, and the House panel names an
+  App and its running release; naming an account slot and one of the App's
+  bound Rooms places the key of the account that Room connects to the slot,
+  when the User holds one of the account's roles there, which the App never
+  sees, and naming neither sends no key. A Site's call names no slot, and the House panel names an
   `account` instead. `body_base64` replaces `body` for bytes.
 - **App messages** - `messages(listener)` hands the listener each message
   another holder of this App sends to this User's running copies, as `from`,
@@ -104,7 +105,8 @@ ready, settle })` lets House activate a newer release of the App while it
   answers the meaningful task the App owns, such as the selected record,
   filters, cursor, selection and scroll position, as JSON of at most 65,536
   characters; House keeps the address itself. In the newer release House
-  calls `restore(task)`, or `restore(null)` when it opens the release without
+  calls `restore(task)` once its document has drawn, so the scroll position
+  and focus it sets hold, or `restore(null)` when it opens the release without
   a task, then `ready()`, the App's own check that its local data and
   capabilities work, and finally `settle('committed')` once the release is
   active or `settle('abandoned')` when House returns to the release before

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-c1bc683ed8f4e",
+  "version": "0.1.0-c1e11b9031ca4",
   "description": "Types of the agents.house App bridge House hands every App: navigation, the tab title and icon, ceremonies, installation, notifications and the icon badge, status, Site image reads, App release code, App and Site screenshot reads, and App messages, with an accessor and an in-page test host.",
   "license": "MIT",
   "type": "module",