@agentshouse/mdruntime-adapter 0.1.0-cbc5a1c3e1e08 → 0.1.0-cc097cb3b7109

package/README.md

@@ -25,7 +25,7 @@ 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 the `apps/` pages
-of House's Guide, which House's `open_guide` opens.
+of House's Guide, which House's `guide/open` opens.
 
 ## License
 

package/dist/actions.d.ts

@@ -1,58 +1,9 @@
-import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents, type ConversationHistories, type ConversationHistoryRequest, type FileDeclaration } from '@agentshouse/mdruntime';
+import type { ActionDeclaration, ActionRequest, ActionResult } 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;
-};
-export type AppInputs = {
-    readonly 'conversation.attach': FileDeclaration & {
-        readonly room: string;
-        readonly blob: Blob;
-    };
-    readonly 'conversation.answer': ConversationControl & {
-        readonly answer: {
-            readonly interaction_id: string;
-            readonly response: unknown;
-        };
-    };
-    readonly 'conversation.create': Operated & {
-        readonly agent_id: string;
-        readonly replaces?: 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;
-    };
-};
-export type AppAnswers = {
-    readonly 'conversation.attach': {
-        readonly path: string;
-    };
-    readonly 'conversation.history': ConversationHistories;
-};
-export type AppAnswerAdditions = {
-    readonly 'conversation.create': {
-        readonly conversation: string;
-    };
-    readonly 'conversation.send': {
-        readonly turn: 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 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 {};
+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":"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"}
+{"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,CAajG"}

package/dist/actions.js

@@ -1,79 +1,18 @@
-import { changeBatchIdentity, HISTORY_CONVERSATIONS, } from '@agentshouse/mdruntime';
-import { doorRefusal } from './refusal.js';
-import { finishedUpload, houseUpload } from './upload.js';
-export const HISTORY_PAGE = 100;
-const OCTET_STREAM = 'application/octet-stream';
-function mapped(door, input = (given) => given) {
-    return {
-        door,
-        async carry(transport, given, name) {
-            return actionOutcome(await transport.door(`/door/${door}`, input(given)), name);
-        },
-    };
-}
-function carried(door, carry, batched, room) {
-    return {
-        door,
-        ...(batched === undefined ? {} : { batched }),
-        ...(room === undefined ? {} : { room }),
-        carry: (transport, input, name) => carry(transport, `/door/${door}`, input, name),
-    };
-}
-const APP_ACTS = {
-    'access.read': mapped('rooms/access/read'),
-    'conversation.answer': mapped('conversations/interaction/answer', answerBody),
-    'conversation.attach': carried('conversations/attach', attachAction, undefined, 'room'),
-    'conversation.create': carried('conversations/create', createAction),
-    'conversation.delete': mapped('conversations/delete', controlBody),
-    'conversation.history': carried('conversations/history', historyAction, ['conversations']),
-    'conversation.interrupt': mapped('conversations/interrupt', controlBody),
-    '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': 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'),
-    '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]));
-const APP_ROOMS = new Map(Object.entries(APP_ACTS).flatMap(([name, act]) => act.room === undefined ? [] : [[name, act.room]]));
-export function houseConversationAgents(locator) {
-    return { locator, type: 'house-agent', identity: 'agent', name: 'name', retired: 'retired' };
-}
+import { doorRefusal, resetOf } from './refusal.js';
+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) {
-    return routes.map((route) => {
-        const name = APP_NAMES.get(route) ?? route;
-        return { name, inputShape: {}, resultKind: 'house', room: APP_ROOMS.get(name) ?? 'room_ref' };
-    });
+    return routes.map((name) => ({ name, inputShape: {}, resultKind: 'house', room: 'room_ref' }));
 }
 export function houseAction(transport, request) {
-    if (Object.hasOwn(APP_ACTS, request.name)) {
-        return APP_ACTS[request.name].carry(transport, request.input, request.name);
-    }
-    if (APP_NAMES.has(request.name))
-        return Promise.resolve(unimplemented(request.name));
     const route = routeOf(request.name);
     if (route === null)
         return Promise.resolve(malformed());
@@ -90,70 +29,26 @@ 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: {}, retryable: false };
 }
 function unimplemented(name) {
     return { kind: 'rejected', code: 'action-unimplemented', fields: { name }, retryable: false };
 }
-function createBody(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) };
-}
-function answerBody(input) {
-    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,
-    };
-}
-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 };
+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?.code === 'operation_contended')
+    if (refusal?.code === 'operation_contended' && numbered(input)) {
         return { kind: 'transport-uncertainty' };
-    if (refusal !== null)
-        return { kind: 'rejected', ...refusal };
+    }
+    if (refusal !== null) {
+        const reset = resetOf(refusal);
+        return { kind: 'rejected', ...refusal, ...(reset === undefined ? {} : { reset }) };
+    }
     if (answer.status === 404)
         return unimplemented(name);
     if (answer.status === 0 || answer.status >= 400)
@@ -161,152 +56,5 @@ export function actionOutcome(answer, name) {
     return { kind: 'action', result: answer.body };
 }
 async function carry(transport, route, name, input) {
-    return actionOutcome(await transport.door(route, input), name);
-}
-function sendBody(input) {
-    const operation = text(input, 'operation_id');
-    const said = text(input, 'text');
-    if (operation === undefined || said === undefined)
-        return null;
-    return { conversation_id: text(input, 'conversation'), operation_id: operation, text: said };
-}
-async function sendAction(transport, route, input, name) {
-    const body = sendBody(input);
-    if (body === null)
-        return malformed();
-    const outcome = actionOutcome(await transport.door(route, body), name);
-    if (outcome.kind !== 'action')
-        return outcome;
-    return { ...outcome, result: withTurn(outcome.result) };
-}
-function attachBody(input) {
-    const room = text(input, 'room');
-    const name = text(input, 'name');
-    const sha256 = text(input, 'contentHash');
-    const bytes = record(input).byteLength;
-    if (room === undefined || name === undefined || sha256 === undefined)
-        return null;
-    if (typeof bytes !== 'number')
-        return null;
-    const mediaType = text(input, 'mediaType');
-    return {
-        room_ref: room,
-        name,
-        bytes,
-        sha256,
-        media_type: mediaType !== undefined && mediaType.length > 0 ? mediaType : OCTET_STREAM,
-    };
-}
-async function attachAction(transport, route, input, name) {
-    const body = attachBody(input);
-    const blob = record(input).blob;
-    if (body === null || !(blob instanceof Blob))
-        return malformed();
-    const outcome = actionOutcome(await transport.door(route, body), name);
-    if (outcome.kind !== 'action')
-        return outcome;
-    const upload = houseUpload(record(outcome.result).upload);
-    if (upload === null)
-        return { kind: 'transport-uncertainty' };
-    const finished = await finishedUpload(transport, upload, blob);
-    if (finished === null)
-        return { kind: 'transport-uncertainty' };
-    const settled = actionOutcome(finished, name);
-    if (settled.kind !== 'action')
-        return settled;
-    const path = text(settled.result, 'path');
-    if (path === undefined)
-        return { kind: 'transport-uncertainty' };
-    const result = { path };
-    return { kind: 'action', result };
-}
-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(record(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, route, input, name) {
-    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(route, {
-            conversations: asks.slice(at, at + HISTORY_CONVERSATIONS),
-            limit: HISTORY_PAGE,
-        });
-        const outcome = actionOutcome(answer, name);
-        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.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EACP,aAAa,EAkBd,MAAM,wBAAwB,CAAC;AA0ChC,OAAO,EASL,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;AA8ErD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAmoBpF"}
+{"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;AAqBxB,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,CA+apF"}