@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/AGENTS.md +149 -94
- package/dist/actions.d.ts +40 -1
- package/dist/actions.d.ts.map +1 -1
- package/dist/actions.js +136 -118
- package/dist/adapter.d.ts.map +1 -1
- package/dist/adapter.js +171 -69
- package/dist/discovery.d.ts +2 -1
- package/dist/discovery.d.ts.map +1 -1
- package/dist/discovery.js +12 -1
- package/dist/gather.d.ts +1 -0
- package/dist/gather.d.ts.map +1 -1
- package/dist/gather.js +11 -6
- package/dist/handed.d.ts +15 -0
- package/dist/handed.d.ts.map +1 -0
- package/dist/handed.js +38 -0
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/model.d.ts +1 -0
- package/dist/model.d.ts.map +1 -1
- package/dist/model.js +23 -6
- package/dist/read.d.ts +13 -7
- package/dist/read.d.ts.map +1 -1
- package/dist/read.js +74 -79
- package/dist/referrer.d.ts +7 -0
- package/dist/referrer.d.ts.map +1 -0
- package/dist/referrer.js +35 -0
- package/dist/refusal.d.ts +2 -5
- package/dist/refusal.d.ts.map +1 -1
- package/dist/refusal.js +4 -8
- package/dist/site.d.ts.map +1 -1
- package/dist/site.js +41 -3
- package/dist/stream.d.ts +1 -0
- package/dist/stream.d.ts.map +1 -1
- package/dist/stream.js +18 -6
- package/dist/transport.d.ts +16 -6
- package/dist/transport.d.ts.map +1 -1
- package/dist/transport.js +3 -0
- package/dist/write.d.ts +3 -9
- package/dist/write.d.ts.map +1 -1
- package/dist/write.js +85 -11
- package/package.json +4 -4
- package/dist/links.d.ts +0 -20
- package/dist/links.d.ts.map +0 -1
- package/dist/links.js +0 -104
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
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
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:
|
|
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
|
|
28
|
-
return
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
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
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
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
|
|
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',
|
|
98
|
-
}
|
|
134
|
+
if (refusal !== null)
|
|
135
|
+
return { kind: 'rejected', ...refusal };
|
|
99
136
|
if (answer.status === 404)
|
|
100
|
-
return
|
|
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
|
-
|
|
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
|
|
180
|
-
const
|
|
181
|
-
if (!Array.isArray(
|
|
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
|
|
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 {
|
|
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: '
|
|
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
|
-
}),
|
|
261
|
+
}), name);
|
|
202
262
|
if (failed !== null)
|
|
203
263
|
return failed;
|
|
204
264
|
}
|
|
205
265
|
return null;
|
|
206
266
|
}
|
|
207
|
-
async function
|
|
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
|
|
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
|
|
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:
|
|
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(
|
|
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,
|
|
360
|
+
const outcome = actionOutcome(answer, name);
|
|
343
361
|
if (outcome.kind !== 'action')
|
|
344
362
|
return outcome;
|
|
345
363
|
const answered = record(outcome.result).histories;
|
package/dist/adapter.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,
|
|
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"}
|