@agentshouse/mdruntime-adapter 0.1.0-cf22c8563f9f4 → 0.1.0-cfd03209dcd82
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 +42 -1
- package/dist/actions.d.ts.map +1 -1
- package/dist/actions.js +140 -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 +17 -3
- 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 +44 -6
- 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 +3 -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,78 @@ 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 SITE_SUBMIT = 'submit';
|
|
51
|
+
export const HOUSE_SITE_ACTS = {
|
|
52
|
+
[SITE_SUBMIT]: 'site/submission',
|
|
53
|
+
};
|
|
54
|
+
export const HOUSE_APP_BATCHES = Object.fromEntries(Object.entries(APP_ACTS).flatMap(([name, act]) => act.batched === undefined ? [] : [[name, act.batched]]));
|
|
55
|
+
const APP_NAMES = new Map(Object.entries(APP_ACTS).map(([name, act]) => [act.door, name]));
|
|
15
56
|
export function houseConversationAgents(locator) {
|
|
16
|
-
return { locator, type: 'house-agent', identity: 'agent', name: 'name' };
|
|
57
|
+
return { locator, type: 'house-agent', identity: 'agent', name: 'name', retired: 'retired' };
|
|
17
58
|
}
|
|
18
59
|
export function declaredActions(routes) {
|
|
19
|
-
const mapped = new Map([...CONVERSATION_ROUTES].map(([name, route]) => [route.slice('/door/'.length), name]));
|
|
20
60
|
return routes.map((route) => ({
|
|
21
|
-
name:
|
|
61
|
+
name: APP_NAMES.get(route) ?? route,
|
|
22
62
|
inputShape: {},
|
|
23
63
|
resultKind: 'house',
|
|
24
64
|
}));
|
|
25
65
|
}
|
|
26
66
|
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);
|
|
67
|
+
if (Object.hasOwn(APP_ACTS, request.name)) {
|
|
68
|
+
return APP_ACTS[request.name].carry(transport, request.input, request.name);
|
|
69
|
+
}
|
|
70
|
+
if (APP_NAMES.has(request.name))
|
|
71
|
+
return Promise.resolve(unimplemented(request.name));
|
|
35
72
|
const route = routeOf(request.name);
|
|
36
73
|
if (route === null)
|
|
37
74
|
return Promise.resolve(malformed());
|
|
38
75
|
return carry(transport, route, request.name, request.input);
|
|
39
76
|
}
|
|
40
77
|
function routeOf(name) {
|
|
41
|
-
const mapped = CONVERSATION_ROUTES.get(name);
|
|
42
|
-
if (mapped !== undefined)
|
|
43
|
-
return mapped;
|
|
44
78
|
const parts = name.split('/');
|
|
45
79
|
if (parts.some((part) => part === '.' || part === '..'))
|
|
46
80
|
return null;
|
|
@@ -62,51 +96,78 @@ function operationId(input) {
|
|
|
62
96
|
return text(input, 'operation_id') ?? changeBatchIdentity();
|
|
63
97
|
}
|
|
64
98
|
function malformed() {
|
|
65
|
-
return { kind: 'rejected', code: 'invalid_request', fields: {} };
|
|
99
|
+
return { kind: 'rejected', code: 'invalid_request', fields: {}, retryable: false };
|
|
66
100
|
}
|
|
67
|
-
function
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
101
|
+
function unimplemented(name) {
|
|
102
|
+
return { kind: 'rejected', code: 'action-unimplemented', fields: { name }, retryable: false };
|
|
103
|
+
}
|
|
104
|
+
function createBody(input) {
|
|
105
|
+
return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
|
|
106
|
+
}
|
|
107
|
+
function controlBody(input) {
|
|
108
|
+
return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
|
|
109
|
+
}
|
|
110
|
+
function answerBody(input) {
|
|
111
|
+
const nested = record(record(input).answer);
|
|
112
|
+
return {
|
|
113
|
+
conversation_id: text(input, 'conversation'),
|
|
114
|
+
operation_id: operationId(input),
|
|
115
|
+
interaction_id: text(nested, 'interaction_id'),
|
|
116
|
+
response: nested.response,
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
async function createAction(transport, route, input, name) {
|
|
120
|
+
const outcome = actionOutcome(await transport.door(route, createBody(input)), name);
|
|
121
|
+
if (outcome.kind !== 'action')
|
|
122
|
+
return outcome;
|
|
123
|
+
const held = record(outcome.result);
|
|
124
|
+
const conversation = text(held, 'conversation_id');
|
|
125
|
+
return conversation === undefined ? outcome : { ...outcome, result: { ...held, conversation } };
|
|
86
126
|
}
|
|
87
127
|
function withTurn(body) {
|
|
88
128
|
const held = record(body);
|
|
89
129
|
const turn = text(held, 'message_id');
|
|
90
|
-
return turn === undefined
|
|
130
|
+
return turn === undefined
|
|
131
|
+
? body
|
|
132
|
+
: { ...held, turn };
|
|
91
133
|
}
|
|
92
134
|
export function actionOutcome(answer, name) {
|
|
93
135
|
if (answer.status === 401)
|
|
94
136
|
return { kind: 'revoked-authorization' };
|
|
95
137
|
const refusal = doorRefusal(answer.body);
|
|
96
|
-
if (refusal !== null)
|
|
97
|
-
return { kind: 'rejected',
|
|
98
|
-
}
|
|
138
|
+
if (refusal !== null)
|
|
139
|
+
return { kind: 'rejected', ...refusal };
|
|
99
140
|
if (answer.status === 404)
|
|
100
|
-
return
|
|
141
|
+
return unimplemented(name);
|
|
101
142
|
if (answer.status === 0 || answer.status >= 400)
|
|
102
143
|
return { kind: 'transport-uncertainty' };
|
|
103
|
-
if (name === 'conversation.send')
|
|
104
|
-
return { kind: 'action', result: withTurn(answer.body) };
|
|
105
144
|
return { kind: 'action', result: answer.body };
|
|
106
145
|
}
|
|
146
|
+
function referredRecord(view, roomRef) {
|
|
147
|
+
const held = record(view);
|
|
148
|
+
if (roomRef === undefined || typeof held.record !== 'string' || !Array.isArray(held.attachments))
|
|
149
|
+
return view;
|
|
150
|
+
const referrer = { room_ref: roomRef, record: held.record };
|
|
151
|
+
return {
|
|
152
|
+
...held,
|
|
153
|
+
attachments: held.attachments.map((attachment) => ({ ...record(attachment), referrer })),
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
async function recordsAction(transport, route, input, name) {
|
|
157
|
+
const outcome = actionOutcome(await transport.door(route, input), name);
|
|
158
|
+
if (outcome.kind !== 'action')
|
|
159
|
+
return outcome;
|
|
160
|
+
const roomRef = text(input, 'room_ref');
|
|
161
|
+
const read = record(outcome.result);
|
|
162
|
+
return {
|
|
163
|
+
...outcome,
|
|
164
|
+
result: Array.isArray(read.records)
|
|
165
|
+
? { ...read, records: read.records.map((view) => referredRecord(view, roomRef)) }
|
|
166
|
+
: referredRecord(outcome.result, roomRef),
|
|
167
|
+
};
|
|
168
|
+
}
|
|
107
169
|
async function carry(transport, route, name, input) {
|
|
108
|
-
|
|
109
|
-
return actionOutcome(answer, name);
|
|
170
|
+
return actionOutcome(await transport.door(route, input), name);
|
|
110
171
|
}
|
|
111
172
|
function sendFile(entry) {
|
|
112
173
|
const file = record(entry);
|
|
@@ -176,12 +237,12 @@ function uploadGrant(entry) {
|
|
|
176
237
|
return null;
|
|
177
238
|
return { method: 'POST', operation: upload.operation, url: upload.url };
|
|
178
239
|
}
|
|
179
|
-
async function
|
|
180
|
-
const
|
|
181
|
-
if (!Array.isArray(
|
|
240
|
+
async function uploadFiles(transport, input, result, name) {
|
|
241
|
+
const sent = record(result).files;
|
|
242
|
+
if (!Array.isArray(sent) || sent.length === 0)
|
|
182
243
|
return null;
|
|
183
244
|
const files = Array.isArray(record(input).files) ? record(input).files : [];
|
|
184
|
-
for (const [index, entry] of
|
|
245
|
+
for (const [index, entry] of sent.entries()) {
|
|
185
246
|
const grant = uploadGrant(entry);
|
|
186
247
|
if (grant === 'absent')
|
|
187
248
|
continue;
|
|
@@ -189,81 +250,35 @@ async function uploadOriginals(transport, input, result) {
|
|
|
189
250
|
return malformed();
|
|
190
251
|
const bytes = index < files.length ? await fileBytes(files[index]) : null;
|
|
191
252
|
if (bytes === null) {
|
|
192
|
-
return {
|
|
253
|
+
return {
|
|
254
|
+
kind: 'rejected',
|
|
255
|
+
code: 'conversation_file_descriptor_required',
|
|
256
|
+
fields: {},
|
|
257
|
+
retryable: false,
|
|
258
|
+
};
|
|
193
259
|
}
|
|
194
260
|
const failed = delivered(await transport.transfer({
|
|
195
|
-
act: '
|
|
196
|
-
method: 'POST',
|
|
261
|
+
act: 'conversation_file_upload',
|
|
197
262
|
url: grant.url,
|
|
198
|
-
answer: 'json',
|
|
199
263
|
body: bytes,
|
|
200
264
|
operation: grant.operation,
|
|
201
|
-
}),
|
|
265
|
+
}), name);
|
|
202
266
|
if (failed !== null)
|
|
203
267
|
return failed;
|
|
204
268
|
}
|
|
205
269
|
return null;
|
|
206
270
|
}
|
|
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) {
|
|
271
|
+
async function sendAction(transport, route, input, name) {
|
|
256
272
|
const body = sendBody(input);
|
|
257
273
|
if (body === null)
|
|
258
274
|
return malformed();
|
|
259
|
-
const
|
|
260
|
-
const outcome = actionOutcome(answer, 'conversation.send');
|
|
275
|
+
const outcome = actionOutcome(await transport.door(route, body), name);
|
|
261
276
|
if (outcome.kind !== 'action')
|
|
262
277
|
return outcome;
|
|
263
|
-
const uploaded = await
|
|
278
|
+
const uploaded = await uploadFiles(transport, input, outcome.result, name);
|
|
264
279
|
if (uploaded !== null)
|
|
265
280
|
return uploaded;
|
|
266
|
-
return outcome;
|
|
281
|
+
return { ...outcome, result: withTurn(outcome.result) };
|
|
267
282
|
}
|
|
268
283
|
function historyCursor(value) {
|
|
269
284
|
const acceptedAt = text(value, 'accepted_at');
|
|
@@ -287,12 +302,19 @@ export function acceptedMessage(entry) {
|
|
|
287
302
|
const cursor = historyCursor(entry);
|
|
288
303
|
if (cursor === null)
|
|
289
304
|
return null;
|
|
305
|
+
const message = structuredClone(record(entry));
|
|
306
|
+
const referrer = { message: cursor.message_id };
|
|
290
307
|
return {
|
|
291
308
|
identity: cursor.message_id,
|
|
292
309
|
turn: text(entry, 'turn_id') ?? cursor.message_id,
|
|
293
310
|
position: position(cursor),
|
|
294
311
|
text: text(entry, 'text') ?? '',
|
|
295
|
-
message:
|
|
312
|
+
message: Array.isArray(message.files)
|
|
313
|
+
? {
|
|
314
|
+
...message,
|
|
315
|
+
files: message.files.map((file) => ({ ...record(file), referrer })),
|
|
316
|
+
}
|
|
317
|
+
: message,
|
|
296
318
|
};
|
|
297
319
|
}
|
|
298
320
|
function historyPage(entry) {
|
|
@@ -329,17 +351,17 @@ function historyAsks(input) {
|
|
|
329
351
|
}
|
|
330
352
|
return asks;
|
|
331
353
|
}
|
|
332
|
-
async function historyAction(transport, input) {
|
|
354
|
+
async function historyAction(transport, route, input, name) {
|
|
333
355
|
const asks = historyAsks(input);
|
|
334
356
|
if (asks === null)
|
|
335
357
|
return malformed();
|
|
336
358
|
const histories = [];
|
|
337
359
|
for (let at = 0; at < asks.length; at += HISTORY_CONVERSATIONS) {
|
|
338
|
-
const answer = await transport.door(
|
|
360
|
+
const answer = await transport.door(route, {
|
|
339
361
|
conversations: asks.slice(at, at + HISTORY_CONVERSATIONS),
|
|
340
362
|
limit: HISTORY_PAGE,
|
|
341
363
|
});
|
|
342
|
-
const outcome = actionOutcome(answer,
|
|
364
|
+
const outcome = actionOutcome(answer, name);
|
|
343
365
|
if (outcome.kind !== 'action')
|
|
344
366
|
return outcome;
|
|
345
367
|
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"}
|