@agentshouse/mdruntime-adapter 0.1.0-cb89e0425af50 → 0.1.0-cbbc9b36e7fd4

package/dist/actions.d.ts

@@ -1,9 +1,69 @@
-import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents } from '@agentshouse/mdruntime';
+import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents, type ConversationHistories, type ConversationHistoryRequest, type FileDeclaration } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
+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: {
+            readonly interaction_id: string;
+            readonly response: unknown;
+        };
+    };
+    readonly 'conversation.create': Operated & {
+        readonly agent_id: string;
+    };
+    readonly 'conversation.delete': ConversationControl;
+    readonly 'conversation.history': ConversationHistoryRequest;
+    readonly 'conversation.interrupt': ConversationControl;
+    readonly 'conversation.kill': ConversationControl;
+    readonly 'conversation.send': ConversationControl & {
+        readonly operation_id: string;
+        readonly text?: string;
+        readonly files?: readonly SentFile[];
+    };
+};
+export type AppAnswers = {
+    readonly 'conversation.history': ConversationHistories;
+};
+export type AppAnswerAdditions = {
+    readonly 'conversation.create': {
+        readonly conversation: string;
+    };
+    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";
+export declare const HOUSE_SITE_ACTS: Readonly<Record<string, string>>;
+export declare const HOUSE_APP_BATCHES: Readonly<Partial<Record<string, readonly string[]>>>;
 export declare function houseConversationAgents(locator: string): ConversationAgents;
 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 {};
 //# 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;AAmEtE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3D,CAAC;AAMF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAMvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AAyDD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAOjF;AAwMD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUtE"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/dist/actions.js

@@ -11,20 +11,19 @@ function mapped(door, input = (given) => given) {
         },
     };
 }
-function carried(door, carry) {
+function carried(door, carry, batched) {
     return {
         door,
+        ...(batched === undefined ? {} : { batched }),
         carry: (transport, input, name) => carry(transport, `/door/${door}`, input, name),
     };
 }
 const APP_ACTS = {
     'access.read': mapped('rooms/access/read'),
-    'attachment.read': carried('attachments/get', openAction),
-    'attachment.upload': carried('attachments/upload', attachAction),
     'conversation.answer': mapped('conversations/interaction/answer', answerBody),
-    'conversation.create': mapped('conversations/create', createBody),
+    'conversation.create': carried('conversations/create', createAction),
     'conversation.delete': mapped('conversations/delete', controlBody),
-    'conversation.history': carried('conversations/history', historyAction),
+    'conversation.history': carried('conversations/history', historyAction, ['conversations']),
     'conversation.interrupt': mapped('conversations/interrupt', controlBody),
     'conversation.kill': mapped('conversations/kill', controlBody),
     'conversation.markDone': mapped('conversations/done'),
@@ -37,7 +36,7 @@ const APP_ACTS = {
     'member.list': mapped('rooms/members'),
     'message.send': mapped('apps/messages/send'),
     'processing.read': mapped('rooms/settings/processing/read'),
-    'record.list': mapped('records/read'),
+    'record.list': carried('records/read', recordsAction),
     'relay.read': mapped('apps/relay'),
     'routine.list': mapped('routines/access'),
     'routineAccess.list': mapped('routines/granted'),
@@ -48,9 +47,14 @@ const APP_ACTS = {
     'triggerOccurrence.list': mapped('triggers/fired'),
 };
 export const HOUSE_APP_ACTS = Object.fromEntries(Object.entries(APP_ACTS).map(([name, act]) => [name, act.door]));
+export const SITE_SUBMIT = 'submit';
+export const HOUSE_SITE_ACTS = {
+    [SITE_SUBMIT]: 'site/submission',
+};
+export const HOUSE_APP_BATCHES = Object.fromEntries(Object.entries(APP_ACTS).flatMap(([name, act]) => act.batched === undefined ? [] : [[name, act.batched]]));
 const APP_NAMES = new Map(Object.entries(APP_ACTS).map(([name, act]) => [act.door, name]));
 export function houseConversationAgents(locator) {
-    return { locator, type: 'house-agent', identity: 'agent', name: 'name' };
+    return { locator, type: 'house-agent', identity: 'agent', name: 'name', retired: 'retired' };
 }
 export function declaredActions(routes) {
     return routes.map((route) => ({
@@ -112,10 +116,25 @@ function answerBody(input) {
         response: nested.response,
     };
 }
+async function createAction(transport, route, input, name) {
+    const outcome = actionOutcome(await transport.door(route, createBody(input)), name);
+    if (outcome.kind !== 'action')
+        return outcome;
+    const held = record(outcome.result);
+    const conversation = text(held, 'conversation_id');
+    return conversation === undefined
+        ? outcome
+        : {
+            ...outcome,
+            result: { ...held, conversation },
+        };
+}
 function withTurn(body) {
     const held = record(body);
     const turn = text(held, 'message_id');
-    return turn === undefined ? body : { ...held, turn };
+    return turn === undefined
+        ? body
+        : { ...held, turn };
 }
 export function actionOutcome(answer, name) {
     if (answer.status === 401)
@@ -129,6 +148,32 @@ 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);
 }
@@ -169,12 +214,13 @@ function sendFiles(input) {
 }
 function sendBody(input) {
     const files = sendFiles(input);
-    if (files === null)
+    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: operationId(input),
+        operation_id: operation,
         ...(textValue !== undefined && textValue.length > 0 ? { text: textValue } : {}),
         ...(files.length === 0 ? {} : { files }),
     };
@@ -187,9 +233,6 @@ async function fileBytes(file) {
         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';
@@ -200,84 +243,28 @@ function uploadGrant(entry) {
         return null;
     return { method: 'POST', operation: upload.operation, url: upload.url };
 }
-async function uploadOriginals(transport, input, result, name) {
-    const originals = record(result).originals;
-    if (!Array.isArray(originals) || originals.length === 0)
-        return null;
+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 originals.entries()) {
+    for (const [index, entry] of sent.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: {},
-                retryable: false,
-            };
-        }
-        const failed = delivered(await transport.transfer({
-            act: 'conversation_original_upload',
-            method: 'POST',
+        if (grant === null || bytes === null)
+            return false;
+        const answer = await transport.transfer({
+            act: 'conversation_file_upload',
             url: grant.url,
-            answer: 'json',
             body: bytes,
             operation: grant.operation,
-        }), name);
-        if (failed !== null)
-            return failed;
+        });
+        if (answer.status !== 200)
+            return false;
     }
-    return null;
-}
-async function attachAction(transport, route, input, name) {
-    const { blob, ...descriptor } = record(input);
-    const bytes = await fileBytes({ blob });
-    if (bytes === null)
-        return malformed();
-    const outcome = actionOutcome(await transport.door(route, descriptor), name);
-    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, name) ?? { kind: 'action', result: stored.body };
-}
-async function openAction(transport, route, input, name) {
-    const outcome = actionOutcome(await transport.door(route, input), name);
-    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, name);
-    if (failed !== null)
-        return failed;
-    if (!(read.body instanceof Blob))
-        return { kind: 'transport-uncertainty' };
-    return { kind: 'action', result: { ...opened, blob: read.body } };
+    return true;
 }
 async function sendAction(transport, route, input, name) {
     const body = sendBody(input);
@@ -286,9 +273,9 @@ async function sendAction(transport, route, input, name) {
     const outcome = actionOutcome(await transport.door(route, body), name);
     if (outcome.kind !== 'action')
         return outcome;
-    const uploaded = await uploadOriginals(transport, input, outcome.result, name);
-    if (uploaded !== null)
-        return uploaded;
+    if (!(await uploadFiles(transport, input, outcome.result))) {
+        return { kind: 'transport-uncertainty' };
+    }
     return { ...outcome, result: withTurn(outcome.result) };
 }
 function historyCursor(value) {
@@ -313,12 +300,19 @@ 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: structuredClone(entry),
+        message: Array.isArray(message.files)
+            ? {
+                ...message,
+                files: message.files.map((file) => ({ ...record(file), referrer })),
+            }
+            : message,
     };
 }
 function historyPage(entry) {

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;AAuChC,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;AAwBjC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAyYpF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,OAAO,EACP,aAAa,EAiBd,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,CA0hBpF"}