@agentshouse/mdruntime-adapter 0.1.0-c8654c2657ee5 → 0.1.0-c86eddcb309ff

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/actions.js CHANGED
@@ -3,44 +3,74 @@ import { doorRefusal } from './refusal.js';
3
3
  const HISTORY_PAGE = 100;
4
4
  const HISTORY_CONVERSATIONS = 64;
5
5
  const OCTET_STREAM = 'application/octet-stream';
6
- const CONVERSATION_ROUTES = new Map([
7
- ['conversation.create', '/door/conversations/create'],
8
- ['conversation.send', '/door/conversations/send'],
9
- ['conversation.answer', '/door/conversations/interaction/answer'],
10
- ['conversation.interrupt', '/door/conversations/interrupt'],
11
- ['conversation.kill', '/door/conversations/kill'],
12
- ['conversation.delete', '/door/conversations/delete'],
13
- ['conversation.history', '/door/conversations/history'],
14
- ]);
6
+ function mapped(door, input = (given) => given) {
7
+ return {
8
+ door,
9
+ async carry(transport, given, name) {
10
+ return actionOutcome(await transport.door(`/door/${door}`, input(given)), name);
11
+ },
12
+ };
13
+ }
14
+ function carried(door, carry, batched) {
15
+ return {
16
+ door,
17
+ ...(batched === undefined ? {} : { batched }),
18
+ carry: (transport, input, name) => carry(transport, `/door/${door}`, input, name),
19
+ };
20
+ }
21
+ const APP_ACTS = {
22
+ 'access.read': mapped('rooms/access/read'),
23
+ 'conversation.answer': mapped('conversations/interaction/answer', answerBody),
24
+ 'conversation.create': carried('conversations/create', createAction),
25
+ 'conversation.delete': mapped('conversations/delete', controlBody),
26
+ 'conversation.history': carried('conversations/history', historyAction, ['conversations']),
27
+ 'conversation.interrupt': mapped('conversations/interrupt', controlBody),
28
+ 'conversation.kill': mapped('conversations/kill', controlBody),
29
+ 'conversation.markDone': mapped('conversations/done'),
30
+ 'conversation.rename': mapped('conversations/rename'),
31
+ 'conversation.send': carried('conversations/send', sendAction),
32
+ 'conversation.setOption': mapped('conversations/option'),
33
+ 'feature.list': mapped('apps/features/read'),
34
+ 'holder.list': mapped('apps/holders'),
35
+ 'holder.ring': mapped('apps/ring'),
36
+ 'member.list': mapped('rooms/members'),
37
+ 'message.send': mapped('apps/messages/send'),
38
+ 'processing.read': mapped('rooms/settings/processing/read'),
39
+ 'record.list': carried('records/read', recordsAction),
40
+ 'relay.read': mapped('apps/relay'),
41
+ 'routine.list': mapped('routines/access'),
42
+ 'routineAccess.list': mapped('routines/granted'),
43
+ 'routineAllowance.list': mapped('routines/allowance'),
44
+ 'routineRequest.list': mapped('routines/requests'),
45
+ 'storage.read': mapped('storage/inventory'),
46
+ 'trigger.list': mapped('triggers/read'),
47
+ 'triggerOccurrence.list': mapped('triggers/fired'),
48
+ };
49
+ export const HOUSE_APP_ACTS = Object.fromEntries(Object.entries(APP_ACTS).map(([name, act]) => [name, act.door]));
50
+ export const HOUSE_APP_BATCHES = Object.fromEntries(Object.entries(APP_ACTS).flatMap(([name, act]) => act.batched === undefined ? [] : [[name, act.batched]]));
51
+ const APP_NAMES = new Map(Object.entries(APP_ACTS).map(([name, act]) => [act.door, name]));
15
52
  export function houseConversationAgents(locator) {
16
- return { locator, type: 'house-agent', identity: 'agent', name: 'name' };
53
+ return { locator, type: 'house-agent', identity: 'agent', name: 'name', retired: 'retired' };
17
54
  }
18
55
  export function declaredActions(routes) {
19
- const mapped = new Map([...CONVERSATION_ROUTES].map(([name, route]) => [route.slice('/door/'.length), name]));
20
56
  return routes.map((route) => ({
21
- name: mapped.get(route) ?? route,
57
+ name: APP_NAMES.get(route) ?? route,
22
58
  inputShape: {},
23
59
  resultKind: 'house',
24
60
  }));
25
61
  }
26
62
  export function houseAction(transport, request) {
27
- if (request.name === 'conversation.send')
28
- return sendAction(transport, request.input);
29
- if (request.name === 'conversation.history')
30
- return historyAction(transport, request.input);
31
- if (request.name === 'attachments/upload')
32
- return attachAction(transport, request.input);
33
- if (request.name === 'attachments/get')
34
- return openAction(transport, request.input);
63
+ if (Object.hasOwn(APP_ACTS, request.name)) {
64
+ return APP_ACTS[request.name].carry(transport, request.input, request.name);
65
+ }
66
+ if (APP_NAMES.has(request.name))
67
+ return Promise.resolve(unimplemented(request.name));
35
68
  const route = routeOf(request.name);
36
69
  if (route === null)
37
70
  return Promise.resolve(malformed());
38
71
  return carry(transport, route, request.name, request.input);
39
72
  }
40
73
  function routeOf(name) {
41
- const mapped = CONVERSATION_ROUTES.get(name);
42
- if (mapped !== undefined)
43
- return mapped;
44
74
  const parts = name.split('/');
45
75
  if (parts.some((part) => part === '.' || part === '..'))
46
76
  return null;
@@ -62,51 +92,78 @@ function operationId(input) {
62
92
  return text(input, 'operation_id') ?? changeBatchIdentity();
63
93
  }
64
94
  function malformed() {
65
- return { kind: 'rejected', code: 'invalid_request', fields: {} };
95
+ return { kind: 'rejected', code: 'invalid_request', fields: {}, retryable: false };
66
96
  }
67
- function bodyOf(name, input) {
68
- if (name === 'conversation.create') {
69
- return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
70
- }
71
- if (name === 'conversation.interrupt' ||
72
- name === 'conversation.kill' ||
73
- name === 'conversation.delete') {
74
- return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
75
- }
76
- if (name === 'conversation.answer') {
77
- const nested = record(record(input).answer);
78
- return {
79
- conversation_id: text(input, 'conversation'),
80
- operation_id: operationId(input),
81
- interaction_id: text(nested, 'interaction_id'),
82
- response: nested.response,
83
- };
84
- }
85
- return input;
97
+ function unimplemented(name) {
98
+ return { kind: 'rejected', code: 'action-unimplemented', fields: { name }, retryable: false };
99
+ }
100
+ function createBody(input) {
101
+ return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
102
+ }
103
+ function controlBody(input) {
104
+ return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
105
+ }
106
+ function answerBody(input) {
107
+ const nested = record(record(input).answer);
108
+ return {
109
+ conversation_id: text(input, 'conversation'),
110
+ operation_id: operationId(input),
111
+ interaction_id: text(nested, 'interaction_id'),
112
+ response: nested.response,
113
+ };
114
+ }
115
+ async function createAction(transport, route, input, name) {
116
+ const outcome = actionOutcome(await transport.door(route, createBody(input)), name);
117
+ if (outcome.kind !== 'action')
118
+ return outcome;
119
+ const held = record(outcome.result);
120
+ const conversation = text(held, 'conversation_id');
121
+ return conversation === undefined ? outcome : { ...outcome, result: { ...held, conversation } };
86
122
  }
87
123
  function withTurn(body) {
88
124
  const held = record(body);
89
125
  const turn = text(held, 'message_id');
90
- return turn === undefined ? body : { ...held, turn };
126
+ return turn === undefined
127
+ ? body
128
+ : { ...held, turn };
91
129
  }
92
130
  export function actionOutcome(answer, name) {
93
131
  if (answer.status === 401)
94
132
  return { kind: 'revoked-authorization' };
95
133
  const refusal = doorRefusal(answer.body);
96
- if (refusal !== null) {
97
- return { kind: 'rejected', code: refusal.code, fields: refusal.fields };
98
- }
134
+ if (refusal !== null)
135
+ return { kind: 'rejected', ...refusal };
99
136
  if (answer.status === 404)
100
- return { kind: 'rejected', code: 'action-unimplemented', fields: { name } };
137
+ return unimplemented(name);
101
138
  if (answer.status === 0 || answer.status >= 400)
102
139
  return { kind: 'transport-uncertainty' };
103
- if (name === 'conversation.send')
104
- return { kind: 'action', result: withTurn(answer.body) };
105
140
  return { kind: 'action', result: answer.body };
106
141
  }
142
+ function referredRecord(view, roomRef) {
143
+ const held = record(view);
144
+ if (roomRef === undefined || typeof held.record !== 'string' || !Array.isArray(held.attachments))
145
+ return view;
146
+ const referrer = { room_ref: roomRef, record: held.record };
147
+ return {
148
+ ...held,
149
+ attachments: held.attachments.map((attachment) => ({ ...record(attachment), referrer })),
150
+ };
151
+ }
152
+ async function recordsAction(transport, route, input, name) {
153
+ const outcome = actionOutcome(await transport.door(route, input), name);
154
+ if (outcome.kind !== 'action')
155
+ return outcome;
156
+ const roomRef = text(input, 'room_ref');
157
+ const read = record(outcome.result);
158
+ return {
159
+ ...outcome,
160
+ result: Array.isArray(read.records)
161
+ ? { ...read, records: read.records.map((view) => referredRecord(view, roomRef)) }
162
+ : referredRecord(outcome.result, roomRef),
163
+ };
164
+ }
107
165
  async function carry(transport, route, name, input) {
108
- const answer = await transport.door(route, bodyOf(name, input));
109
- return actionOutcome(answer, name);
166
+ return actionOutcome(await transport.door(route, input), name);
110
167
  }
111
168
  function sendFile(entry) {
112
169
  const file = record(entry);
@@ -176,12 +233,12 @@ function uploadGrant(entry) {
176
233
  return null;
177
234
  return { method: 'POST', operation: upload.operation, url: upload.url };
178
235
  }
179
- async function uploadOriginals(transport, input, result) {
180
- const originals = record(result).originals;
181
- if (!Array.isArray(originals) || originals.length === 0)
236
+ async function uploadFiles(transport, input, result, name) {
237
+ const sent = record(result).files;
238
+ if (!Array.isArray(sent) || sent.length === 0)
182
239
  return null;
183
240
  const files = Array.isArray(record(input).files) ? record(input).files : [];
184
- for (const [index, entry] of originals.entries()) {
241
+ for (const [index, entry] of sent.entries()) {
185
242
  const grant = uploadGrant(entry);
186
243
  if (grant === 'absent')
187
244
  continue;
@@ -189,81 +246,35 @@ async function uploadOriginals(transport, input, result) {
189
246
  return malformed();
190
247
  const bytes = index < files.length ? await fileBytes(files[index]) : null;
191
248
  if (bytes === null) {
192
- return { kind: 'rejected', code: 'conversation_original_descriptor_required', fields: {} };
249
+ return {
250
+ kind: 'rejected',
251
+ code: 'conversation_file_descriptor_required',
252
+ fields: {},
253
+ retryable: false,
254
+ };
193
255
  }
194
256
  const failed = delivered(await transport.transfer({
195
- act: 'conversation_original_upload',
196
- method: 'POST',
257
+ act: 'conversation_file_upload',
197
258
  url: grant.url,
198
- answer: 'json',
199
259
  body: bytes,
200
260
  operation: grant.operation,
201
- }), 'conversation.send');
261
+ }), name);
202
262
  if (failed !== null)
203
263
  return failed;
204
264
  }
205
265
  return null;
206
266
  }
207
- async function attachAction(transport, input) {
208
- const { blob, ...descriptor } = record(input);
209
- const bytes = await fileBytes({ blob });
210
- if (bytes === null)
211
- return malformed();
212
- const answer = await transport.door('/door/attachments/upload', descriptor);
213
- const outcome = actionOutcome(answer, 'attachments/upload');
214
- if (outcome.kind !== 'action')
215
- return outcome;
216
- const grant = uploadGrant(outcome.result);
217
- if (grant === 'absent')
218
- return outcome;
219
- if (grant === null)
220
- return malformed();
221
- const stored = await transport.transfer({
222
- act: 'original_upload',
223
- method: 'POST',
224
- url: grant.url,
225
- answer: 'json',
226
- body: bytes,
227
- operation: grant.operation,
228
- });
229
- return delivered(stored, 'attachments/upload') ?? { kind: 'action', result: stored.body };
230
- }
231
- async function openAction(transport, input) {
232
- const answer = await transport.door('/door/attachments/get', input);
233
- const outcome = actionOutcome(answer, 'attachments/get');
234
- if (outcome.kind !== 'action')
235
- return outcome;
236
- const { download, ...opened } = record(outcome.result);
237
- if (download === undefined)
238
- return outcome;
239
- const grant = record(download);
240
- if (grant.method !== 'GET' || typeof grant.url !== 'string')
241
- return malformed();
242
- const read = await transport.transfer({
243
- act: 'original_download',
244
- method: 'GET',
245
- url: grant.url,
246
- answer: 'bytes',
247
- });
248
- const failed = delivered(read, 'attachments/get');
249
- if (failed !== null)
250
- return failed;
251
- if (!(read.body instanceof Blob))
252
- return { kind: 'transport-uncertainty' };
253
- return { kind: 'action', result: { ...opened, blob: read.body } };
254
- }
255
- async function sendAction(transport, input) {
267
+ async function sendAction(transport, route, input, name) {
256
268
  const body = sendBody(input);
257
269
  if (body === null)
258
270
  return malformed();
259
- const answer = await transport.door('/door/conversations/send', body);
260
- const outcome = actionOutcome(answer, 'conversation.send');
271
+ const outcome = actionOutcome(await transport.door(route, body), name);
261
272
  if (outcome.kind !== 'action')
262
273
  return outcome;
263
- const uploaded = await uploadOriginals(transport, input, outcome.result);
274
+ const uploaded = await uploadFiles(transport, input, outcome.result, name);
264
275
  if (uploaded !== null)
265
276
  return uploaded;
266
- return outcome;
277
+ return { ...outcome, result: withTurn(outcome.result) };
267
278
  }
268
279
  function historyCursor(value) {
269
280
  const acceptedAt = text(value, 'accepted_at');
@@ -287,12 +298,19 @@ export function acceptedMessage(entry) {
287
298
  const cursor = historyCursor(entry);
288
299
  if (cursor === null)
289
300
  return null;
301
+ const message = structuredClone(record(entry));
302
+ const referrer = { message: cursor.message_id };
290
303
  return {
291
304
  identity: cursor.message_id,
292
305
  turn: text(entry, 'turn_id') ?? cursor.message_id,
293
306
  position: position(cursor),
294
307
  text: text(entry, 'text') ?? '',
295
- message: structuredClone(entry),
308
+ message: Array.isArray(message.files)
309
+ ? {
310
+ ...message,
311
+ files: message.files.map((file) => ({ ...record(file), referrer })),
312
+ }
313
+ : message,
296
314
  };
297
315
  }
298
316
  function historyPage(entry) {
@@ -329,17 +347,17 @@ function historyAsks(input) {
329
347
  }
330
348
  return asks;
331
349
  }
332
- async function historyAction(transport, input) {
350
+ async function historyAction(transport, route, input, name) {
333
351
  const asks = historyAsks(input);
334
352
  if (asks === null)
335
353
  return malformed();
336
354
  const histories = [];
337
355
  for (let at = 0; at < asks.length; at += HISTORY_CONVERSATIONS) {
338
- const answer = await transport.door('/door/conversations/history', {
356
+ const answer = await transport.door(route, {
339
357
  conversations: asks.slice(at, at + HISTORY_CONVERSATIONS),
340
358
  limit: HISTORY_PAGE,
341
359
  });
342
- const outcome = actionOutcome(answer, 'conversation.history');
360
+ const outcome = actionOutcome(answer, name);
343
361
  if (outcome.kind !== 'action')
344
362
  return outcome;
345
363
  const answered = record(outcome.result).histories;
@@ -1 +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"}
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EAgBd,MAAM,wBAAwB,CAAC;AAuChC,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,CAAA;CAAE,CAAC;AAwBjC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CA8cpF"}