@agentshouse/app-bridge 0.1.0-ccef427e0f56d → 0.1.0-cd2d3edbf9805

package/README.md

@@ -12,7 +12,7 @@ The bridge carries no credential handling and no Runtime family. House builds
 the MD Runtime client into the page beside the bridge and serves it the Chat, so
 the App imports, constructs and bundles neither: `bridge.runtime` resolves to the client.
 
-House's `find_command` "App" is the guide to building an App or a Site.
+House's guide to building an App is its Guide's `apps/` pages, which `open_guide` opens.
 
 ## Use
 

package/dist/calls.d.ts

@@ -16,18 +16,18 @@ export interface HouseMethods {
                 readonly user_name: string;
                 readonly entries: readonly {
                     readonly namespace: string;
-                    readonly read: 'mcp' | 'online' | 'local' | null;
+                    readonly level: 'search' | 'open' | 'keep' | null;
                     readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                     readonly sources: readonly {
                         readonly kind: 'direct' | 'inherited';
                         readonly namespace: string;
-                        readonly read: 'mcp' | 'online' | 'local' | null;
+                        readonly level: 'search' | 'open' | 'keep' | null;
                         readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                     }[];
                 }[];
                 readonly direct: readonly {
                     readonly namespace: string;
-                    readonly read: 'mcp' | 'online' | 'local' | null;
+                    readonly level: 'search' | 'open' | 'keep' | null;
                     readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                 }[];
                 readonly admitted_at: string | null;
@@ -64,19 +64,6 @@ export interface HouseMethods {
             readonly url: string;
         };
     };
-    readonly 'conversation.attach': {
-        readonly params: {
-            readonly blob: Blob;
-            readonly byteLength: number;
-            readonly contentHash: string;
-            readonly mediaType: string;
-            readonly name: string;
-            readonly room: string;
-        };
-        readonly result: {
-            readonly path: string;
-        };
-    };
     readonly 'conversation.create': {
         readonly params: {
             readonly agent_id: string;
@@ -240,7 +227,7 @@ export interface HouseMethods {
         readonly params: Readonly<Record<string, never>>;
         readonly result: {
             readonly features: readonly {
-                readonly feature: 'microphone' | 'camera' | 'geolocation' | 'clipboard-read' | 'notifications';
+                readonly feature: string;
                 readonly allowed: boolean;
             }[];
         };
@@ -359,7 +346,8 @@ export interface HouseMethods {
                 readonly owner: boolean;
                 readonly email?: string;
                 readonly since: string | null;
-                readonly access?: 'owner' | 'manage' | 'edit' | 'read';
+                readonly access?: 'owner' | 'manage' | 'edit' | 'keep' | 'open' | 'search';
+                readonly only_while_online?: true;
                 readonly member_document: string | null;
                 readonly schema_roles?: readonly string[];
             }[];
@@ -506,11 +494,7 @@ export interface HouseMethods {
                     readonly reach: 'selected';
                     readonly refs: readonly string[];
                 };
-                readonly accounts?: readonly {
-                    readonly id: string;
-                    readonly name: string;
-                    readonly origin: string;
-                }[];
+                readonly key_origins?: readonly string[];
                 readonly url: string;
             }[];
         };
@@ -623,303 +607,17 @@ export interface HouseMethods {
             readonly submitted: true;
         };
     };
-    readonly 'trigger.list': {
-        readonly params: {
-            readonly room_refs: readonly string[];
-        };
-        readonly result: {
-            readonly rooms: readonly {
-                readonly room_ref: string;
-                readonly triggers: readonly {
-                    readonly trigger: string;
-                    readonly creator: {
-                        readonly user: string;
-                        readonly name: string;
-                    };
-                    readonly description: string;
-                    readonly condition: {
-                        readonly on: 'documents';
-                        readonly scope: {
-                            readonly type: string;
-                        } | {
-                            readonly folder: string;
-                        } | {
-                            readonly document: string;
-                        };
-                        readonly mode: 'starts_matching';
-                        readonly new_documents: boolean;
-                        readonly match: {
-                            readonly all: readonly unknown[];
-                        } | {
-                            readonly any: readonly unknown[];
-                        } | {
-                            readonly not: unknown;
-                        } | {
-                            readonly path: string;
-                            readonly eq: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly in: readonly (string | number | boolean)[];
-                        } | {
-                            readonly path: string;
-                            readonly exists: boolean;
-                        } | {
-                            readonly path: string;
-                            readonly contains: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly gt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly gte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly prefix: string;
-                        };
-                        readonly by?: {
-                            readonly all: readonly unknown[];
-                        } | {
-                            readonly any: readonly unknown[];
-                        } | {
-                            readonly not: unknown;
-                        } | {
-                            readonly path: string;
-                            readonly eq: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly in: readonly (string | number | boolean)[];
-                        } | {
-                            readonly path: string;
-                            readonly exists: boolean;
-                        } | {
-                            readonly path: string;
-                            readonly contains: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly gt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly gte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly prefix: string;
-                        };
-                        readonly moved_between_rooms?: boolean;
-                    } | {
-                        readonly on: 'documents';
-                        readonly scope: {
-                            readonly type: string;
-                        } | {
-                            readonly folder: string;
-                        } | {
-                            readonly document: string;
-                        };
-                        readonly mode: 'field_changes';
-                        readonly field: string;
-                        readonly from?: readonly (string | number | boolean)[] | 'new';
-                        readonly to?: readonly (string | number | boolean)[] | 'deleted';
-                        readonly match?: {
-                            readonly all: readonly unknown[];
-                        } | {
-                            readonly any: readonly unknown[];
-                        } | {
-                            readonly not: unknown;
-                        } | {
-                            readonly path: string;
-                            readonly eq: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly in: readonly (string | number | boolean)[];
-                        } | {
-                            readonly path: string;
-                            readonly exists: boolean;
-                        } | {
-                            readonly path: string;
-                            readonly contains: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly gt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly gte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly prefix: string;
-                        };
-                        readonly by?: {
-                            readonly all: readonly unknown[];
-                        } | {
-                            readonly any: readonly unknown[];
-                        } | {
-                            readonly not: unknown;
-                        } | {
-                            readonly path: string;
-                            readonly eq: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly in: readonly (string | number | boolean)[];
-                        } | {
-                            readonly path: string;
-                            readonly exists: boolean;
-                        } | {
-                            readonly path: string;
-                            readonly contains: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly gt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly gte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly prefix: string;
-                        };
-                        readonly moved_between_rooms?: boolean;
-                    } | {
-                        readonly on: 'items';
-                        readonly source?: string;
-                        readonly address?: string;
-                        readonly match?: {
-                            readonly all: readonly unknown[];
-                        } | {
-                            readonly any: readonly unknown[];
-                        } | {
-                            readonly not: unknown;
-                        } | {
-                            readonly path: string;
-                            readonly eq: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly in: readonly (string | number | boolean)[];
-                        } | {
-                            readonly path: string;
-                            readonly exists: boolean;
-                        } | {
-                            readonly path: string;
-                            readonly contains: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly gt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly gte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly prefix: string;
-                        };
-                    } | {
-                        readonly on: 'clock';
-                        readonly cron: string;
-                        readonly time_zone: string;
-                    } | {
-                        readonly on: 'clock';
-                        readonly scope: {
-                            readonly type: string;
-                        };
-                        readonly date: string;
-                        readonly days: number;
-                        readonly at: string;
-                        readonly time_zone: string;
-                        readonly match?: {
-                            readonly all: readonly unknown[];
-                        } | {
-                            readonly any: readonly unknown[];
-                        } | {
-                            readonly not: unknown;
-                        } | {
-                            readonly path: string;
-                            readonly eq: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly in: readonly (string | number | boolean)[];
-                        } | {
-                            readonly path: string;
-                            readonly exists: boolean;
-                        } | {
-                            readonly path: string;
-                            readonly contains: string | number | boolean;
-                        } | {
-                            readonly path: string;
-                            readonly gt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly gte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lt: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly lte: number | string;
-                        } | {
-                            readonly path: string;
-                            readonly prefix: string;
-                        };
-                    };
-                    readonly enabled: boolean;
-                    readonly paused_by?: 'types';
-                    readonly actions: readonly ({
-                        readonly kind: 'notify';
-                        readonly enabled: boolean;
-                        readonly title: string;
-                        readonly text: string;
-                        readonly to: {
-                            readonly users: readonly string[];
-                            readonly fields: readonly string[];
-                            readonly roles: readonly string[];
-                        };
-                        readonly holds: boolean;
-                    } | {
-                        readonly kind: 'routine';
-                        readonly enabled: boolean;
-                        readonly access?: string;
-                        readonly payload: string;
-                        readonly holds: boolean;
-                    })[];
-                }[];
-                readonly url: string;
-            }[];
-        };
-    };
-    readonly 'triggerOccurrence.list': {
+    readonly 'triggerEvent.list': {
         readonly params: {
             readonly room_ref: string;
         };
         readonly result: {
-            readonly occurrences: readonly {
+            readonly events: readonly {
                 readonly trigger: string;
                 readonly path?: string;
                 readonly moment?: string;
                 readonly missed?: 'skipped' | 'failed';
+                readonly code?: 'cap_reached';
                 readonly created_at: string;
                 readonly actions: readonly ({
                     readonly position: number;
@@ -928,7 +626,7 @@ export interface HouseMethods {
                 } | {
                     readonly position: number;
                     readonly outcome: 'no_target';
-                    readonly code: 'no_recipient' | 'routine_access_not_found' | 'routine_retired' | 'target_agent_unavailable';
+                    readonly code: 'no_recipient' | 'routine_access_not_found' | 'routine_retired' | 'target_agent_unavailable' | 'app_not_found' | 'app_function_not_found' | 'environment_function_not_found' | 'environment_offline';
                 } | {
                     readonly position: number;
                     readonly outcome: 'requested';
@@ -978,12 +676,12 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards' | 'folder_subscriptions';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'service_keys' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards' | 'environment_functions' | 'folder_subscriptions';
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards' | 'folder_subscriptions';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'service_keys' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards' | 'environment_functions' | 'folder_subscriptions';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;
@@ -993,6 +691,48 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'failed';
                     readonly code: 'internal_error' | 'routine_request_not_started';
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'function_failed';
+                    readonly error: string;
+                    readonly release: string;
+                    readonly final: true;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'function_failed';
+                    readonly error: string;
+                    readonly run: string;
+                    readonly final: true;
+                    readonly exit_code?: number;
+                    readonly output?: string;
+                    readonly cut?: boolean;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'function_not_started';
+                    readonly tries: number;
+                    readonly final?: true;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'running';
+                    readonly release: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'running';
+                    readonly run: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'ran';
+                    readonly release: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'ran';
+                    readonly run: string;
+                    readonly exit_code?: number;
+                    readonly output?: string;
+                    readonly cut?: boolean;
                 } | {
                     readonly position: number;
                     readonly outcome: 'waiting';

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export interface HouseCredentialState {
     readonly state: Open<'none' | 'held' | 'rejected'>;
     readonly expiresAt: number | null;
 }
-export type HouseDatabaseFailure = 'unsupported' | 'damaged' | 'update-required';
+export type HouseDatabaseFailure = 'unsupported' | 'damaged';
 export type HouseAnalyticsChoice = 'accept' | 'decline';
 export interface HouseAnalytics {
     readonly measures: boolean;
@@ -80,8 +80,6 @@ export interface HouseExternalRequest {
     readonly headers?: Readonly<Record<string, string>>;
     readonly body?: string;
     readonly body_base64?: string;
-    readonly account?: string;
-    readonly slot?: string;
     readonly room_ref?: string;
 }
 export type HouseExternalAnswer = {
@@ -120,19 +118,8 @@ export interface HouseBrowserRefused extends Error {
     readonly code: string;
     readonly retryable: boolean;
 }
-export interface HouseTrialWithheld {
-    readonly code: Open<'house_trial_withheld'>;
-    readonly retryable: true;
-}
-export type HouseTask = unknown;
-export type HouseActivation = Open<'committed' | 'abandoned'>;
 export interface HouseCooperation {
-    checkpoint(): Promise<void> | void;
-    persist(): Promise<void> | void;
-    capture(): Promise<HouseTask> | HouseTask;
-    restore(task: HouseTask | null): Promise<void> | void;
-    ready(): Promise<boolean> | boolean;
-    settle(activation: HouseActivation): void;
+    placed(): Promise<void> | void;
 }
 export type HouseChatWidth = 'full' | '3/4' | '1/2' | '1/3';
 export interface HouseChatOpened {

package/dist/mdmodel/condition.d.ts

@@ -76,7 +76,11 @@ export type DateCondition = {
     readonly time_zone: string;
     readonly match?: ConditionTest;
 };
-export type Condition = DocumentCondition | ItemCondition | CronCondition | DateCondition;
+export type NotificationCondition = {
+    readonly on: 'notifications';
+    readonly match?: ConditionTest;
+};
+export type Condition = DocumentCondition | ItemCondition | CronCondition | DateCondition | NotificationCondition;
 export type FactKind = 'string' | 'number' | 'boolean' | 'date' | 'time' | 'enum' | 'reference';
 type Scalar = string | number | boolean;
 export type Fact = {
@@ -103,11 +107,13 @@ export type DocumentFacts = {
     readonly fields: Readonly<Record<string, Fact>>;
     readonly sections: readonly string[];
 };
-export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client'];
+export declare const TEXT_FIELD = "/text";
+export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client', 'function'];
 export type WriteDoor = (typeof WRITE_DOORS)[number];
 export type Actor = {
     readonly user?: string;
     readonly site?: string;
+    readonly app?: string;
     readonly door?: WriteDoor;
 };
 export type DocumentEvent = {
@@ -157,4 +163,5 @@ export declare function members(document: DocumentFacts, path: string): readonly
 export declare function holds(test: ConditionTest, document: DocumentFacts): Truth;
 export declare function fires(condition: DocumentCondition, event: DocumentEvent): boolean;
 export declare function itemFires(condition: ItemCondition, item: ItemFacts): boolean;
+export declare function notificationFires(condition: NotificationCondition, notification: DocumentFacts): boolean;
 export {};

package/dist/mdmodel/index.d.ts

@@ -1,5 +1,5 @@
-export { ACTOR_PATHS, actorOperators, changeFields, CONDITION_OPERATORS, dated, datePointers, DOCUMENT_PATHS, factKind, facts, fires, holds, instant, ITEM_PATHS, itemFires, itemKind, itemOperators, memberPointers, members, pointed, prosePaths, testOperators, valuedChange, WRITE_DOORS, } from './condition.js';
-export type { Actor, Condition, ConditionOperator, ConditionScope, ConditionTest, ConditionValue, CronCondition, DateCondition, DocumentCondition, DocumentEvent, DocumentFacts, Fact, FactKind, ItemCondition, ItemFacts, Resolved, WriteDoor, } from './condition.js';
+export { ACTOR_PATHS, actorOperators, changeFields, CONDITION_OPERATORS, dated, datePointers, DOCUMENT_PATHS, factKind, facts, fires, holds, instant, ITEM_PATHS, itemFires, itemKind, itemOperators, memberPointers, members, notificationFires, pointed, prosePaths, testOperators, TEXT_FIELD, valuedChange, WRITE_DOORS, } from './condition.js';
+export type { Actor, Condition, ConditionOperator, ConditionScope, ConditionTest, ConditionValue, CronCondition, DateCondition, DocumentCondition, DocumentEvent, DocumentFacts, Fact, FactKind, ItemCondition, ItemFacts, NotificationCondition, Resolved, WriteDoor, } from './condition.js';
 export { headingLines } from './blocks.js';
 export type { HeadingLine } from './blocks.js';
 export { divide } from './divide.js';