@agentshouse/mdruntime-adapter 0.1.0-cd028205a5103 → 0.1.0-cd0b0339c1003

package/README.md

@@ -24,8 +24,8 @@ host.attach(port, 'my-app');
 ```
 
 App code never imports this package; it reaches the Runtime only through the
-client its host hands it. The rules an App's agent follows are in the
-package's `AGENTS.md`.
+client its host hands it. The rules an App's agent follows are the `apps/` pages
+of House's Guide, which House's `guide/open` opens.
 
 ## License
 

package/dist/actions.d.ts

@@ -1,8 +1,9 @@
-import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents } from '@agentshouse/mdruntime';
+import type { ActionDeclaration, ActionRequest, ActionResult } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
-export declare function houseConversationAgents(locator: string): ConversationAgents;
+export type HouseActDoor = Pick<HouseTransport, 'door'>;
+export declare const HOUSE_UNKEPT_READS: readonly string[];
+export declare const HOUSE_LEADING_READS: readonly string[];
 export declare function declaredActions(routes: readonly string[]): readonly ActionDeclaration[];
-export declare function houseAction(transport: HouseTransport, request: ActionRequest): Promise<ActionResult>;
-export declare function actionOutcome(answer: HouseDoorAnswer, name: string): ActionResult;
-export declare function acceptedMessage(entry: unknown): AcceptedMessage | null;
+export declare function houseAction(transport: HouseActDoor, request: ActionRequest): Promise<ActionResult>;
+export declare function actionOutcome(answer: HouseDoorAnswer, name: string, input: unknown): ActionResult;
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAGxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkBtE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CASvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AA4DD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAWjF;AAuLD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUtE"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAG/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAKhD,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAEvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAIvB;AAwBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAUjG"}

package/dist/actions.js

@@ -1,46 +1,24 @@
-import { changeBatchIdentity, } from '@agentshouse/mdruntime';
 import { doorRefusal } from './refusal.js';
-const HISTORY_PAGE = 100;
-const HISTORY_CONVERSATIONS = 64;
-const OCTET_STREAM = 'application/octet-stream';
-const CONVERSATION_ROUTES = new Map([
-    ['conversation.create', '/door/conversations/create'],
-    ['conversation.send', '/door/conversations/send'],
-    ['conversation.answer', '/door/conversations/interaction/answer'],
-    ['conversation.interrupt', '/door/conversations/interrupt'],
-    ['conversation.kill', '/door/conversations/kill'],
-    ['conversation.delete', '/door/conversations/delete'],
-    ['conversation.history', '/door/conversations/history'],
-]);
-export function houseConversationAgents(locator) {
-    return { locator, type: 'house-agent', identity: 'agent', name: 'name' };
-}
+export const HOUSE_UNKEPT_READS = [
+    'account/security/read',
+    'clients/last-use/list',
+];
+export const HOUSE_LEADING_READS = [
+    'rooms/list',
+    'apps/list',
+    'sites/list',
+    'rooms/members/list',
+];
 export function declaredActions(routes) {
-    const mapped = new Map([...CONVERSATION_ROUTES].map(([name, route]) => [route.slice('/door/'.length), name]));
-    return routes.map((route) => ({
-        name: mapped.get(route) ?? route,
-        inputShape: {},
-        resultKind: 'house',
-    }));
+    return routes.map((name) => ({ name, inputShape: {}, resultKind: 'house', room: 'room_ref' }));
 }
 export function houseAction(transport, request) {
-    if (request.name === 'conversation.send')
-        return sendAction(transport, request.input);
-    if (request.name === 'conversation.history')
-        return historyAction(transport, request.input);
-    if (request.name === 'attachments/upload')
-        return attachAction(transport, request.input);
-    if (request.name === 'attachments/get')
-        return openAction(transport, request.input);
     const route = routeOf(request.name);
     if (route === null)
         return Promise.resolve(malformed());
     return carry(transport, route, request.name, request.input);
 }
 function routeOf(name) {
-    const mapped = CONVERSATION_ROUTES.get(name);
-    if (mapped !== undefined)
-        return mapped;
     const parts = name.split('/');
     if (parts.some((part) => part === '.' || part === '..'))
         return null;
@@ -51,307 +29,30 @@ function routeOf(name) {
         return null;
     }
 }
-function record(value) {
-    return typeof value === 'object' && value !== null ? value : {};
-}
-function text(value, name) {
-    const held = record(value)[name];
-    return typeof held === 'string' ? held : undefined;
-}
-function operationId(input) {
-    return text(input, 'operation_id') ?? changeBatchIdentity();
-}
 function malformed() {
-    return { kind: 'rejected', code: 'invalid_request', fields: {} };
+    return { kind: 'rejected', code: 'invalid_request', fields: {}, retryable: false };
 }
-function bodyOf(name, input) {
-    if (name === 'conversation.create') {
-        return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
-    }
-    if (name === 'conversation.interrupt' ||
-        name === 'conversation.kill' ||
-        name === 'conversation.delete') {
-        return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
-    }
-    if (name === 'conversation.answer') {
-        const nested = record(record(input).answer);
-        return {
-            conversation_id: text(input, 'conversation'),
-            operation_id: operationId(input),
-            interaction_id: text(nested, 'interaction_id'),
-            response: nested.response,
-        };
-    }
-    return input;
+function unimplemented(name) {
+    return { kind: 'rejected', code: 'action-unimplemented', fields: { name }, retryable: false };
 }
-function withTurn(body) {
-    const held = record(body);
-    const turn = text(held, 'message_id');
-    return turn === undefined ? body : { ...held, turn };
+function numbered(input) {
+    return typeof input?.operation_id === 'string';
 }
-export function actionOutcome(answer, name) {
+export function actionOutcome(answer, name, input) {
     if (answer.status === 401)
         return { kind: 'revoked-authorization' };
     const refusal = doorRefusal(answer.body);
-    if (refusal !== null) {
-        return { kind: 'rejected', code: refusal.code, fields: refusal.fields };
+    if (refusal?.code === 'operation_contended' && numbered(input)) {
+        return { kind: 'transport-uncertainty' };
     }
+    if (refusal !== null)
+        return { kind: 'rejected', ...refusal };
     if (answer.status === 404)
-        return { kind: 'rejected', code: 'action-unimplemented', fields: { name } };
+        return unimplemented(name);
     if (answer.status === 0 || answer.status >= 400)
         return { kind: 'transport-uncertainty' };
-    if (name === 'conversation.send')
-        return { kind: 'action', result: withTurn(answer.body) };
     return { kind: 'action', result: answer.body };
 }
 async function carry(transport, route, name, input) {
-    const answer = await transport.door(route, bodyOf(name, input));
-    return actionOutcome(answer, name);
-}
-function sendFile(entry) {
-    const file = record(entry);
-    const name = text(file, 'name');
-    const bytes = file.byteLength;
-    const sha256 = text(file, 'contentHash');
-    if (name === undefined || typeof bytes !== 'number' || sha256 === undefined)
-        return null;
-    const mediaType = text(file, 'mediaType');
-    const width = file.width;
-    const height = file.height;
-    return {
-        name,
-        media_type: mediaType !== undefined && mediaType.length > 0 ? mediaType : OCTET_STREAM,
-        bytes,
-        sha256,
-        ...(typeof width === 'number' && typeof height === 'number'
-            ? { dimensions: { width, height } }
-            : {}),
-    };
-}
-function sendFiles(input) {
-    const files = record(input).files;
-    if (files === undefined)
-        return [];
-    if (!Array.isArray(files))
-        return null;
-    const declared = [];
-    for (const entry of files) {
-        const file = sendFile(entry);
-        if (file === null)
-            return null;
-        declared.push(file);
-    }
-    return declared;
-}
-function sendBody(input) {
-    const files = sendFiles(input);
-    if (files === null)
-        return null;
-    const textValue = text(input, 'text');
-    return {
-        conversation_id: text(input, 'conversation'),
-        operation_id: operationId(input),
-        ...(textValue !== undefined && textValue.length > 0 ? { text: textValue } : {}),
-        ...(files.length === 0 ? {} : { files }),
-    };
-}
-async function fileBytes(file) {
-    const blob = record(file).blob;
-    if (blob === undefined || typeof blob !== 'object' || blob === null)
-        return null;
-    if (!('arrayBuffer' in blob) || typeof blob.arrayBuffer !== 'function')
-        return null;
-    return new Uint8Array(await blob.arrayBuffer());
-}
-function delivered(answer, name) {
-    return answer.status === 200 ? null : actionOutcome(answer, name);
-}
-function uploadGrant(entry) {
-    if (!('upload' in record(entry)))
-        return 'absent';
-    const upload = record(record(entry).upload);
-    if (upload.method !== 'POST')
-        return null;
-    if (typeof upload.operation !== 'string' || typeof upload.url !== 'string')
-        return null;
-    return { method: 'POST', operation: upload.operation, url: upload.url };
-}
-async function uploadOriginals(transport, input, result) {
-    const originals = record(result).originals;
-    if (!Array.isArray(originals) || originals.length === 0)
-        return null;
-    const files = Array.isArray(record(input).files) ? record(input).files : [];
-    for (const [index, entry] of originals.entries()) {
-        const grant = uploadGrant(entry);
-        if (grant === 'absent')
-            continue;
-        if (grant === null)
-            return malformed();
-        const bytes = index < files.length ? await fileBytes(files[index]) : null;
-        if (bytes === null) {
-            return { kind: 'rejected', code: 'conversation_original_descriptor_required', fields: {} };
-        }
-        const failed = delivered(await transport.transfer({
-            act: 'conversation_original_upload',
-            method: 'POST',
-            url: grant.url,
-            answer: 'json',
-            body: bytes,
-            operation: grant.operation,
-        }), 'conversation.send');
-        if (failed !== null)
-            return failed;
-    }
-    return null;
-}
-async function attachAction(transport, input) {
-    const { blob, ...descriptor } = record(input);
-    const bytes = await fileBytes({ blob });
-    if (bytes === null)
-        return malformed();
-    const answer = await transport.door('/door/attachments/upload', descriptor);
-    const outcome = actionOutcome(answer, 'attachments/upload');
-    if (outcome.kind !== 'action')
-        return outcome;
-    const grant = uploadGrant(outcome.result);
-    if (grant === 'absent')
-        return outcome;
-    if (grant === null)
-        return malformed();
-    const stored = await transport.transfer({
-        act: 'original_upload',
-        method: 'POST',
-        url: grant.url,
-        answer: 'json',
-        body: bytes,
-        operation: grant.operation,
-    });
-    return delivered(stored, 'attachments/upload') ?? { kind: 'action', result: stored.body };
-}
-async function openAction(transport, input) {
-    const answer = await transport.door('/door/attachments/get', input);
-    const outcome = actionOutcome(answer, 'attachments/get');
-    if (outcome.kind !== 'action')
-        return outcome;
-    const { download, ...opened } = record(outcome.result);
-    if (download === undefined)
-        return outcome;
-    const grant = record(download);
-    if (grant.method !== 'GET' || typeof grant.url !== 'string')
-        return malformed();
-    const read = await transport.transfer({
-        act: 'original_download',
-        method: 'GET',
-        url: grant.url,
-        answer: 'bytes',
-    });
-    const failed = delivered(read, 'attachments/get');
-    if (failed !== null)
-        return failed;
-    if (!(read.body instanceof Blob))
-        return { kind: 'transport-uncertainty' };
-    return { kind: 'action', result: { ...opened, blob: read.body } };
-}
-async function sendAction(transport, input) {
-    const body = sendBody(input);
-    if (body === null)
-        return malformed();
-    const answer = await transport.door('/door/conversations/send', body);
-    const outcome = actionOutcome(answer, 'conversation.send');
-    if (outcome.kind !== 'action')
-        return outcome;
-    const uploaded = await uploadOriginals(transport, input, outcome.result);
-    if (uploaded !== null)
-        return uploaded;
-    return outcome;
-}
-function historyCursor(value) {
-    const acceptedAt = text(value, 'accepted_at');
-    const messageId = text(value, 'message_id');
-    if (acceptedAt === undefined || messageId === undefined)
-        return null;
-    return { accepted_at: acceptedAt, message_id: messageId };
-}
-function position(cursor) {
-    return JSON.stringify({ accepted_at: cursor.accepted_at, message_id: cursor.message_id });
-}
-function positionCursor(value) {
-    try {
-        return historyCursor(JSON.parse(value));
-    }
-    catch {
-        return null;
-    }
-}
-export function acceptedMessage(entry) {
-    const cursor = historyCursor(entry);
-    if (cursor === null)
-        return null;
-    return {
-        identity: cursor.message_id,
-        turn: text(entry, 'turn_id') ?? cursor.message_id,
-        position: position(cursor),
-        text: text(entry, 'text') ?? '',
-        message: structuredClone(entry),
-    };
-}
-function historyPage(entry) {
-    const held = record(entry);
-    const conversation = text(held, 'conversation_id');
-    if (conversation === undefined || !Array.isArray(held.messages))
-        return null;
-    const messages = [];
-    for (const one of held.messages) {
-        const message = acceptedMessage(one);
-        if (message === null)
-            return null;
-        messages.push(message);
-    }
-    const next = held.next === null || held.next === undefined ? undefined : historyCursor(held.next);
-    if (next === null)
-        return null;
-    return { conversation, messages, ...(next === undefined ? {} : { next: position(next) }) };
-}
-function historyAsks(input) {
-    const asked = record(input).conversations;
-    if (!Array.isArray(asked) || asked.length === 0)
-        return null;
-    const asks = [];
-    for (const entry of asked) {
-        const conversationId = text(entry, 'conversation');
-        if (conversationId === undefined)
-            return null;
-        const afterValue = text(entry, 'after');
-        const after = afterValue === undefined ? undefined : positionCursor(afterValue);
-        if (after === null)
-            return null;
-        asks.push({ conversation_id: conversationId, ...(after === undefined ? {} : { after }) });
-    }
-    return asks;
-}
-async function historyAction(transport, input) {
-    const asks = historyAsks(input);
-    if (asks === null)
-        return malformed();
-    const histories = [];
-    for (let at = 0; at < asks.length; at += HISTORY_CONVERSATIONS) {
-        const answer = await transport.door('/door/conversations/history', {
-            conversations: asks.slice(at, at + HISTORY_CONVERSATIONS),
-            limit: HISTORY_PAGE,
-        });
-        const outcome = actionOutcome(answer, 'conversation.history');
-        if (outcome.kind !== 'action')
-            return outcome;
-        const answered = record(outcome.result).histories;
-        if (!Array.isArray(answered))
-            return { kind: 'transport-uncertainty' };
-        for (const entry of answered) {
-            const page = historyPage(entry);
-            if (page === null)
-                return { kind: 'transport-uncertainty' };
-            histories.push(page);
-        }
-    }
-    const result = { histories };
-    return { kind: 'action', result };
+    return actionOutcome(await transport.door(route, input), name, input);
 }

package/dist/adapter.d.ts

@@ -5,6 +5,7 @@ export type AgentsHouseAdapterOptions = {
     authorize(): Promise<Authorization>;
 } | {
     site: HouseSiteTransport;
+    snapshot?: boolean;
 };
 export declare function createAgentsHouseAdapter(options: AgentsHouseAdapterOptions): Adapter;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EAWd,MAAM,wBAAwB,CAAC;AAqChC,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAyBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAsBjC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAuWpF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EAIP,aAAa,EAed,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAoBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAoBrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAkbpF"}