@agentshouse/mdruntime-adapter 0.1.0-c98ad03e03daf → 0.1.0-c9cac5b21ac0b

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 `open_guide` opens.
 
 ## License
 

package/dist/actions.d.ts

@@ -1,14 +1,12 @@
-import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents, type ConversationHistories, type ConversationHistoryRequest, type FileDeclaration } from '@agentshouse/mdruntime';
+import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents, type ConversationHistories, type ConversationHistoryRequest } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
+export declare const HISTORY_PAGE = 100;
 type Operated = {
     readonly operation_id?: string;
 };
 type ConversationControl = Operated & {
     readonly conversation: string;
 };
-type SentFile = FileDeclaration & {
-    readonly blob: Blob;
-};
 export type AppInputs = {
     readonly 'conversation.answer': ConversationControl & {
         readonly answer: {
@@ -18,6 +16,7 @@ export type AppInputs = {
     };
     readonly 'conversation.create': Operated & {
         readonly agent_id: string;
+        readonly replaces?: string;
     };
     readonly 'conversation.delete': ConversationControl;
     readonly 'conversation.history': ConversationHistoryRequest;
@@ -25,8 +24,7 @@ export type AppInputs = {
     readonly 'conversation.kill': ConversationControl;
     readonly 'conversation.send': ConversationControl & {
         readonly operation_id: string;
-        readonly text?: string;
-        readonly files?: readonly SentFile[];
+        readonly text: string;
     };
 };
 export type AppAnswers = {
@@ -39,22 +37,6 @@ export type AppAnswerAdditions = {
     readonly 'conversation.send': {
         readonly turn: string;
     };
-    readonly 'record.list': {
-        readonly attachments: readonly {
-            readonly referrer: {
-                readonly room_ref: string;
-                readonly record: string;
-            };
-        }[];
-        readonly records: readonly {
-            readonly attachments: readonly {
-                readonly referrer: {
-                    readonly room_ref: string;
-                    readonly record: string;
-                };
-            }[];
-        }[];
-    };
 };
 export declare const HOUSE_APP_ACTS: Readonly<Record<string, string>>;
 export declare const SITE_SUBMIT = "submit";

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAE1B,KAAK,0BAA0B,EAChC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,KAAK,mBAAmB,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,GAAG;QACpD,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAC;KAClF,CAAC;IACF,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,GAAG;QACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;IACpD,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;IAC5D,QAAQ,CAAC,wBAAwB,EAAE,mBAAmB,CAAC;IACvD,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,GAAG;QAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,qBAAqB,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,mBAAmB,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC;AA2EF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3D,CAAC;AAEF,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5D,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAKhF,CAAC;AAMJ,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAKvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AAkFD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAQjF;AAoDD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUtE"}

package/dist/actions.js

@@ -1,8 +1,6 @@
-import { changeBatchIdentity, } from '@agentshouse/mdruntime';
+import { changeBatchIdentity, HISTORY_CONVERSATIONS, } from '@agentshouse/mdruntime';
 import { doorRefusal } from './refusal.js';
-const HISTORY_PAGE = 100;
-const HISTORY_CONVERSATIONS = 64;
-const OCTET_STREAM = 'application/octet-stream';
+export const HISTORY_PAGE = 100;
 function mapped(door, input = (given) => given) {
     return {
         door,
@@ -28,22 +26,25 @@ const APP_ACTS = {
     'conversation.kill': mapped('conversations/kill', controlBody),
     'conversation.markDone': mapped('conversations/done'),
     'conversation.rename': mapped('conversations/rename'),
+    'conversation.retry': mapped('conversations/retry'),
     'conversation.send': carried('conversations/send', sendAction),
     'conversation.setOption': mapped('conversations/option'),
     'feature.list': mapped('apps/features/read'),
     'holder.list': mapped('apps/holders'),
     'holder.ring': mapped('apps/ring'),
+    'inboxChat.assign': mapped('chats/assign'),
+    'inboxChat.return': mapped('chats/return'),
+    'inboxChat.takeControl': mapped('chats/take-control'),
     'member.list': mapped('rooms/members'),
     'message.send': mapped('apps/messages/send'),
     'processing.read': mapped('rooms/settings/processing/read'),
-    'record.list': carried('records/read', recordsAction),
+    'record.list': mapped('records/read'),
     'relay.read': mapped('apps/relay'),
     'routine.list': mapped('routines/access'),
     'routineAccess.list': mapped('routines/granted'),
     'routineAllowance.list': mapped('routines/allowance'),
     'routineRequest.list': mapped('routines/requests'),
     'storage.read': mapped('storage/inventory'),
-    'trigger.list': mapped('triggers/read'),
     'triggerOccurrence.list': mapped('triggers/fired'),
 };
 export const HOUSE_APP_ACTS = Object.fromEntries(Object.entries(APP_ACTS).map(([name, act]) => [name, act.door]));
@@ -57,11 +58,10 @@ export function houseConversationAgents(locator) {
     return { locator, type: 'house-agent', identity: 'agent', name: 'name', retired: 'retired' };
 }
 export function declaredActions(routes) {
-    return routes.map((route) => ({
-        name: APP_NAMES.get(route) ?? route,
-        inputShape: {},
-        resultKind: 'house',
-    }));
+    return routes.map((route) => {
+        const name = APP_NAMES.get(route) ?? route;
+        return { name, inputShape: {}, resultKind: 'house', room: 'room_ref' };
+    });
 }
 export function houseAction(transport, request) {
     if (Object.hasOwn(APP_ACTS, request.name)) {
@@ -102,7 +102,12 @@ function unimplemented(name) {
     return { kind: 'rejected', code: 'action-unimplemented', fields: { name }, retryable: false };
 }
 function createBody(input) {
-    return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
+    const replaces = text(input, 'replaces');
+    return {
+        agent_id: text(input, 'agent_id'),
+        operation_id: operationId(input),
+        ...(replaces === undefined ? {} : { replaces }),
+    };
 }
 function controlBody(input) {
     return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
@@ -150,123 +155,15 @@ export function actionOutcome(answer, name) {
         return { kind: 'transport-uncertainty' };
     return { kind: 'action', result: answer.body };
 }
-function referredRecord(view, roomRef) {
-    const held = record(view);
-    if (roomRef === undefined || typeof held.record !== 'string' || !Array.isArray(held.attachments))
-        return view;
-    const referrer = {
-        room_ref: roomRef,
-        record: held.record,
-    };
-    return {
-        ...held,
-        attachments: held.attachments.map((attachment) => ({ ...record(attachment), referrer })),
-    };
-}
-async function recordsAction(transport, route, input, name) {
-    const outcome = actionOutcome(await transport.door(route, input), name);
-    if (outcome.kind !== 'action')
-        return outcome;
-    const roomRef = text(input, 'room_ref');
-    const read = record(outcome.result);
-    return {
-        ...outcome,
-        result: Array.isArray(read.records)
-            ? { ...read, records: read.records.map((view) => referredRecord(view, roomRef)) }
-            : referredRecord(outcome.result, roomRef),
-    };
-}
 async function carry(transport, route, name, input) {
     return actionOutcome(await transport.door(route, input), 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);
     const operation = text(input, 'operation_id');
-    if (files === null || operation === undefined)
-        return null;
-    const textValue = text(input, 'text');
-    return {
-        conversation_id: text(input, 'conversation'),
-        operation_id: operation,
-        ...(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')
+    const said = text(input, 'text');
+    if (operation === undefined || said === undefined)
         return null;
-    return new Uint8Array(await blob.arrayBuffer());
-}
-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 uploadFiles(transport, input, result) {
-    const sent = record(result).files;
-    if (!Array.isArray(sent))
-        return true;
-    const files = Array.isArray(record(input).files) ? record(input).files : [];
-    for (const [index, entry] of sent.entries()) {
-        const grant = uploadGrant(entry);
-        if (grant === 'absent')
-            continue;
-        const bytes = index < files.length ? await fileBytes(files[index]) : null;
-        if (grant === null || bytes === null)
-            return false;
-        const answer = await transport.transfer({
-            act: 'conversation_file_upload',
-            url: grant.url,
-            body: bytes,
-            operation: grant.operation,
-        });
-        if (answer.status !== 200)
-            return false;
-    }
-    return true;
+    return { conversation_id: text(input, 'conversation'), operation_id: operation, text: said };
 }
 async function sendAction(transport, route, input, name) {
     const body = sendBody(input);
@@ -275,9 +172,6 @@ async function sendAction(transport, route, input, name) {
     const outcome = actionOutcome(await transport.door(route, body), name);
     if (outcome.kind !== 'action')
         return outcome;
-    if (!(await uploadFiles(transport, input, outcome.result))) {
-        return { kind: 'transport-uncertainty' };
-    }
     return { ...outcome, result: withTurn(outcome.result) };
 }
 function historyCursor(value) {
@@ -302,19 +196,12 @@ export function acceptedMessage(entry) {
     const cursor = historyCursor(entry);
     if (cursor === null)
         return null;
-    const message = structuredClone(record(entry));
-    const referrer = { message: cursor.message_id };
     return {
         identity: cursor.message_id,
         turn: text(entry, 'turn_id') ?? cursor.message_id,
         position: position(cursor),
         text: text(entry, 'text') ?? '',
-        message: Array.isArray(message.files)
-            ? {
-                ...message,
-                files: message.files.map((file) => ({ ...record(file), referrer })),
-            }
-            : message,
+        message: structuredClone(record(entry)),
     };
 }
 function historyPage(entry) {

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,OAAO,EACP,aAAa,EAmBd,MAAM,wBAAwB,CAAC;AA4ChC,OAAO,EASL,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,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAsErD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAyjBpF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EAGP,aAAa,EAkBd,MAAM,wBAAwB,CAAC;AA0ChC,OAAO,EAUL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AA0BxB,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;AAgFrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAyqBpF"}