@joe-broadhead/opencode-mem 0.9.5 → 0.9.14
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/CHANGELOG.md +1408 -0
- package/README.md +120 -41
- package/docs/agent-instructions.md +17 -0
- package/docs/agent-protocol.md +28 -27
- package/docs/permissions.md +150 -0
- package/package.json +386 -17
- package/skills/mem.pages/SKILL.md +40 -16
- package/skills/mem.sharing/SKILL.md +39 -6
- package/skills/mem.sources/SKILL.md +41 -10
- package/skills/mem.usage/SKILL.md +37 -16
- package/src/backend/records.js +8 -0
- package/src/backend/v3.js +15 -10
- package/src/call-shapes.js +18 -25
- package/src/capture-pause.js +136 -0
- package/src/capture.js +7 -5
- package/src/collector-service.js +212 -35
- package/src/collector.js +187 -47
- package/src/commands.js +37 -0
- package/src/compaction.js +4 -2
- package/src/config.js +151 -1
- package/src/curation.js +6 -10
- package/src/events.js +144 -36
- package/src/forget-purge.js +377 -0
- package/src/forgotten.js +152 -0
- package/src/hooks.js +9 -4
- package/src/index.js +5 -3
- package/src/permissions.js +116 -38
- package/src/protocol.js +32 -11
- package/src/recall.js +13 -1
- package/src/records.js +4 -1
- package/src/runtime.js +202 -15
- package/src/shapes.js +63 -0
- package/src/sources.js +205 -12
- package/src/spaces.js +58 -1
- package/src/spool.js +442 -64
- package/src/stated.js +334 -0
- package/src/storable.js +477 -0
- package/src/tools/aliases.js +36 -147
- package/src/tools/commitments.js +79 -13
- package/src/tools/held-write.js +5 -1
- package/src/tools/index.js +25 -43
- package/src/tools/ingest.js +33 -128
- package/src/tools/memory.js +525 -911
- package/src/tools/page-sections.js +147 -0
- package/src/tools/page.js +314 -82
- package/src/tools/recall-browse.js +173 -0
- package/src/tools/recall.js +36 -8
- package/src/tools/records-kit.js +2 -1
- package/src/tools/share.js +494 -131
- package/src/tools/shared.js +97 -19
- package/src/tools/spaces.js +194 -101
- package/src/tools/status.js +31 -3
- package/src/tools/wiki.js +5 -13
- package/src/util.js +10 -59
- package/src/views/contracts.js +258 -20
- package/src/views/overdue.js +1 -1
- package/src/views/profile.js +2 -3
- package/src/views/receipt.js +81 -0
- package/src/views/records-reads.js +545 -25
- package/src/views/rpc.js +41 -3
- package/views/memory.html +16 -3
- package/views/remembered.html +130 -0
- package/src/erase.js +0 -36
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@joe-broadhead/opencode-mem",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.14",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Durable private and shared-space memory for OpenCode agents",
|
|
6
6
|
"license": "MIT",
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
"title": "Memory",
|
|
16
16
|
"summary": "Your decisions, preferences and notes, across conversations and agents.",
|
|
17
17
|
"icon": "assets/icon.svg",
|
|
18
|
+
"instructions": "docs/agent-instructions.md",
|
|
18
19
|
"tools": [
|
|
19
20
|
{
|
|
20
21
|
"name": "mem.recall",
|
|
@@ -85,14 +86,14 @@
|
|
|
85
86
|
{
|
|
86
87
|
"name": "mem.forget",
|
|
87
88
|
"permission": "mem_forget",
|
|
88
|
-
"effect": "
|
|
89
|
-
"readOnly":
|
|
89
|
+
"effect": "allow",
|
|
90
|
+
"readOnly": true
|
|
90
91
|
},
|
|
91
92
|
{
|
|
92
93
|
"name": "mem.promote",
|
|
93
94
|
"permission": "mem_promote",
|
|
94
95
|
"effect": "allow",
|
|
95
|
-
"readOnly":
|
|
96
|
+
"readOnly": true
|
|
96
97
|
},
|
|
97
98
|
{
|
|
98
99
|
"name": "mem.status",
|
|
@@ -207,6 +208,23 @@
|
|
|
207
208
|
"unavailable"
|
|
208
209
|
]
|
|
209
210
|
},
|
|
211
|
+
"spool": {
|
|
212
|
+
"type": "object",
|
|
213
|
+
"additionalProperties": false,
|
|
214
|
+
"required": [
|
|
215
|
+
"depth"
|
|
216
|
+
],
|
|
217
|
+
"properties": {
|
|
218
|
+
"depth": {
|
|
219
|
+
"type": "integer",
|
|
220
|
+
"minimum": 0
|
|
221
|
+
},
|
|
222
|
+
"oldest": {
|
|
223
|
+
"type": "string",
|
|
224
|
+
"maxLength": 40
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
},
|
|
210
228
|
"space": {
|
|
211
229
|
"type": "object",
|
|
212
230
|
"additionalProperties": false,
|
|
@@ -343,6 +361,14 @@
|
|
|
343
361
|
"type": "string",
|
|
344
362
|
"maxLength": 200
|
|
345
363
|
},
|
|
364
|
+
"agent": {
|
|
365
|
+
"type": "string",
|
|
366
|
+
"maxLength": 200
|
|
367
|
+
},
|
|
368
|
+
"task": {
|
|
369
|
+
"type": "string",
|
|
370
|
+
"maxLength": 200
|
|
371
|
+
},
|
|
346
372
|
"jellySpeaker": {
|
|
347
373
|
"type": "string"
|
|
348
374
|
}
|
|
@@ -456,7 +482,9 @@
|
|
|
456
482
|
"type",
|
|
457
483
|
"at",
|
|
458
484
|
"space",
|
|
459
|
-
"status"
|
|
485
|
+
"status",
|
|
486
|
+
"version",
|
|
487
|
+
"copies"
|
|
460
488
|
],
|
|
461
489
|
"properties": {
|
|
462
490
|
"id": {
|
|
@@ -509,6 +537,36 @@
|
|
|
509
537
|
"source": {
|
|
510
538
|
"type": "string",
|
|
511
539
|
"maxLength": 200
|
|
540
|
+
},
|
|
541
|
+
"agent": {
|
|
542
|
+
"type": "string",
|
|
543
|
+
"maxLength": 80
|
|
544
|
+
},
|
|
545
|
+
"task": {
|
|
546
|
+
"type": "string",
|
|
547
|
+
"maxLength": 200
|
|
548
|
+
},
|
|
549
|
+
"version": {
|
|
550
|
+
"type": "integer",
|
|
551
|
+
"minimum": 0
|
|
552
|
+
},
|
|
553
|
+
"copies": {
|
|
554
|
+
"type": "object",
|
|
555
|
+
"additionalProperties": false,
|
|
556
|
+
"properties": {
|
|
557
|
+
"supersedes": {
|
|
558
|
+
"type": "array",
|
|
559
|
+
"maxItems": 20,
|
|
560
|
+
"items": {
|
|
561
|
+
"type": "string",
|
|
562
|
+
"maxLength": 200
|
|
563
|
+
}
|
|
564
|
+
},
|
|
565
|
+
"supersededBy": {
|
|
566
|
+
"type": "string",
|
|
567
|
+
"maxLength": 200
|
|
568
|
+
}
|
|
569
|
+
}
|
|
512
570
|
}
|
|
513
571
|
}
|
|
514
572
|
}
|
|
@@ -1158,7 +1216,8 @@
|
|
|
1158
1216
|
"evidence",
|
|
1159
1217
|
"proposed",
|
|
1160
1218
|
"expires",
|
|
1161
|
-
"created"
|
|
1219
|
+
"created",
|
|
1220
|
+
"held"
|
|
1162
1221
|
],
|
|
1163
1222
|
"properties": {
|
|
1164
1223
|
"id": {
|
|
@@ -1199,6 +1258,35 @@
|
|
|
1199
1258
|
"type": "string",
|
|
1200
1259
|
"maxLength": 200
|
|
1201
1260
|
},
|
|
1261
|
+
"session": {
|
|
1262
|
+
"type": "string",
|
|
1263
|
+
"maxLength": 200
|
|
1264
|
+
},
|
|
1265
|
+
"turn": {
|
|
1266
|
+
"type": "string",
|
|
1267
|
+
"maxLength": 200
|
|
1268
|
+
},
|
|
1269
|
+
"held": {
|
|
1270
|
+
"type": "boolean"
|
|
1271
|
+
},
|
|
1272
|
+
"space": {
|
|
1273
|
+
"type": "object",
|
|
1274
|
+
"additionalProperties": false,
|
|
1275
|
+
"required": [
|
|
1276
|
+
"id",
|
|
1277
|
+
"name"
|
|
1278
|
+
],
|
|
1279
|
+
"properties": {
|
|
1280
|
+
"id": {
|
|
1281
|
+
"type": "string",
|
|
1282
|
+
"maxLength": 200
|
|
1283
|
+
},
|
|
1284
|
+
"name": {
|
|
1285
|
+
"type": "string",
|
|
1286
|
+
"maxLength": 200
|
|
1287
|
+
}
|
|
1288
|
+
}
|
|
1289
|
+
},
|
|
1202
1290
|
"external": {
|
|
1203
1291
|
"type": "boolean"
|
|
1204
1292
|
},
|
|
@@ -1244,6 +1332,27 @@
|
|
|
1244
1332
|
"created": {
|
|
1245
1333
|
"type": "string",
|
|
1246
1334
|
"maxLength": 40
|
|
1335
|
+
},
|
|
1336
|
+
"payload": {
|
|
1337
|
+
"type": "object",
|
|
1338
|
+
"additionalProperties": false,
|
|
1339
|
+
"required": [
|
|
1340
|
+
"kind"
|
|
1341
|
+
],
|
|
1342
|
+
"properties": {
|
|
1343
|
+
"kind": {
|
|
1344
|
+
"type": "string",
|
|
1345
|
+
"enum": [
|
|
1346
|
+
"memory",
|
|
1347
|
+
"page",
|
|
1348
|
+
"commitment"
|
|
1349
|
+
]
|
|
1350
|
+
},
|
|
1351
|
+
"type": {
|
|
1352
|
+
"type": "string",
|
|
1353
|
+
"maxLength": 40
|
|
1354
|
+
}
|
|
1355
|
+
}
|
|
1247
1356
|
}
|
|
1248
1357
|
}
|
|
1249
1358
|
}
|
|
@@ -1316,6 +1425,10 @@
|
|
|
1316
1425
|
"at": {
|
|
1317
1426
|
"type": "string",
|
|
1318
1427
|
"maxLength": 40
|
|
1428
|
+
},
|
|
1429
|
+
"kind": {
|
|
1430
|
+
"type": "string",
|
|
1431
|
+
"maxLength": 40
|
|
1319
1432
|
}
|
|
1320
1433
|
}
|
|
1321
1434
|
}
|
|
@@ -1340,6 +1453,10 @@
|
|
|
1340
1453
|
"type": "string",
|
|
1341
1454
|
"maxLength": 64
|
|
1342
1455
|
},
|
|
1456
|
+
"cursor": {
|
|
1457
|
+
"type": "string",
|
|
1458
|
+
"maxLength": 600
|
|
1459
|
+
},
|
|
1343
1460
|
"jellySpeaker": {
|
|
1344
1461
|
"type": "string"
|
|
1345
1462
|
}
|
|
@@ -1437,12 +1554,41 @@
|
|
|
1437
1554
|
"updated": {
|
|
1438
1555
|
"type": "string",
|
|
1439
1556
|
"maxLength": 40
|
|
1557
|
+
},
|
|
1558
|
+
"owner": {
|
|
1559
|
+
"type": "object",
|
|
1560
|
+
"additionalProperties": false,
|
|
1561
|
+
"required": [
|
|
1562
|
+
"id",
|
|
1563
|
+
"name"
|
|
1564
|
+
],
|
|
1565
|
+
"properties": {
|
|
1566
|
+
"id": {
|
|
1567
|
+
"type": "string",
|
|
1568
|
+
"maxLength": 200
|
|
1569
|
+
},
|
|
1570
|
+
"name": {
|
|
1571
|
+
"type": "string",
|
|
1572
|
+
"maxLength": 120
|
|
1573
|
+
}
|
|
1574
|
+
}
|
|
1575
|
+
},
|
|
1576
|
+
"backlinks": {
|
|
1577
|
+
"type": "integer",
|
|
1578
|
+
"minimum": 0
|
|
1579
|
+
},
|
|
1580
|
+
"backlinksMore": {
|
|
1581
|
+
"type": "boolean"
|
|
1440
1582
|
}
|
|
1441
1583
|
}
|
|
1442
1584
|
}
|
|
1443
1585
|
},
|
|
1444
1586
|
"more": {
|
|
1445
1587
|
"type": "boolean"
|
|
1588
|
+
},
|
|
1589
|
+
"cursor": {
|
|
1590
|
+
"type": "string",
|
|
1591
|
+
"maxLength": 600
|
|
1446
1592
|
}
|
|
1447
1593
|
}
|
|
1448
1594
|
}
|
|
@@ -1558,6 +1704,31 @@
|
|
|
1558
1704
|
"type": "integer",
|
|
1559
1705
|
"minimum": 0
|
|
1560
1706
|
},
|
|
1707
|
+
"owner": {
|
|
1708
|
+
"type": "object",
|
|
1709
|
+
"additionalProperties": false,
|
|
1710
|
+
"required": [
|
|
1711
|
+
"id",
|
|
1712
|
+
"name"
|
|
1713
|
+
],
|
|
1714
|
+
"properties": {
|
|
1715
|
+
"id": {
|
|
1716
|
+
"type": "string",
|
|
1717
|
+
"maxLength": 200
|
|
1718
|
+
},
|
|
1719
|
+
"name": {
|
|
1720
|
+
"type": "string",
|
|
1721
|
+
"maxLength": 120
|
|
1722
|
+
}
|
|
1723
|
+
}
|
|
1724
|
+
},
|
|
1725
|
+
"reviewed": {
|
|
1726
|
+
"type": "string",
|
|
1727
|
+
"maxLength": 40
|
|
1728
|
+
},
|
|
1729
|
+
"reviewDue": {
|
|
1730
|
+
"type": "boolean"
|
|
1731
|
+
},
|
|
1561
1732
|
"fields": {
|
|
1562
1733
|
"type": "array",
|
|
1563
1734
|
"maxItems": 24,
|
|
@@ -1805,6 +1976,10 @@
|
|
|
1805
1976
|
"type": "string",
|
|
1806
1977
|
"maxLength": 200
|
|
1807
1978
|
},
|
|
1979
|
+
"folder": {
|
|
1980
|
+
"type": "string",
|
|
1981
|
+
"maxLength": 64
|
|
1982
|
+
},
|
|
1808
1983
|
"depth": {
|
|
1809
1984
|
"type": "integer",
|
|
1810
1985
|
"minimum": 1,
|
|
@@ -2075,6 +2250,129 @@
|
|
|
2075
2250
|
}
|
|
2076
2251
|
}
|
|
2077
2252
|
}
|
|
2253
|
+
},
|
|
2254
|
+
{
|
|
2255
|
+
"name": "terms.list",
|
|
2256
|
+
"label": "list the people and names Memory knows",
|
|
2257
|
+
"permission": "mem_page",
|
|
2258
|
+
"readOnly": true,
|
|
2259
|
+
"input": {
|
|
2260
|
+
"type": "object",
|
|
2261
|
+
"additionalProperties": false,
|
|
2262
|
+
"properties": {
|
|
2263
|
+
"space": {
|
|
2264
|
+
"type": "string",
|
|
2265
|
+
"maxLength": 200
|
|
2266
|
+
},
|
|
2267
|
+
"types": {
|
|
2268
|
+
"type": "array",
|
|
2269
|
+
"maxItems": 4,
|
|
2270
|
+
"items": {
|
|
2271
|
+
"type": "string",
|
|
2272
|
+
"enum": [
|
|
2273
|
+
"person",
|
|
2274
|
+
"project",
|
|
2275
|
+
"team",
|
|
2276
|
+
"glossary"
|
|
2277
|
+
]
|
|
2278
|
+
}
|
|
2279
|
+
},
|
|
2280
|
+
"max": {
|
|
2281
|
+
"type": "integer",
|
|
2282
|
+
"minimum": 10,
|
|
2283
|
+
"maximum": 500
|
|
2284
|
+
},
|
|
2285
|
+
"jellySpeaker": {
|
|
2286
|
+
"type": "string"
|
|
2287
|
+
}
|
|
2288
|
+
}
|
|
2289
|
+
},
|
|
2290
|
+
"output": {
|
|
2291
|
+
"type": "object",
|
|
2292
|
+
"additionalProperties": false,
|
|
2293
|
+
"required": [
|
|
2294
|
+
"terms",
|
|
2295
|
+
"more",
|
|
2296
|
+
"incomplete"
|
|
2297
|
+
],
|
|
2298
|
+
"properties": {
|
|
2299
|
+
"terms": {
|
|
2300
|
+
"type": "array",
|
|
2301
|
+
"maxItems": 500,
|
|
2302
|
+
"items": {
|
|
2303
|
+
"type": "object",
|
|
2304
|
+
"additionalProperties": false,
|
|
2305
|
+
"required": [
|
|
2306
|
+
"text",
|
|
2307
|
+
"kind",
|
|
2308
|
+
"space"
|
|
2309
|
+
],
|
|
2310
|
+
"properties": {
|
|
2311
|
+
"text": {
|
|
2312
|
+
"type": "string",
|
|
2313
|
+
"maxLength": 80
|
|
2314
|
+
},
|
|
2315
|
+
"kind": {
|
|
2316
|
+
"type": "string",
|
|
2317
|
+
"maxLength": 40
|
|
2318
|
+
},
|
|
2319
|
+
"space": {
|
|
2320
|
+
"type": "object",
|
|
2321
|
+
"additionalProperties": false,
|
|
2322
|
+
"required": [
|
|
2323
|
+
"id",
|
|
2324
|
+
"name"
|
|
2325
|
+
],
|
|
2326
|
+
"properties": {
|
|
2327
|
+
"id": {
|
|
2328
|
+
"type": "string",
|
|
2329
|
+
"maxLength": 200
|
|
2330
|
+
},
|
|
2331
|
+
"name": {
|
|
2332
|
+
"type": "string",
|
|
2333
|
+
"maxLength": 200
|
|
2334
|
+
}
|
|
2335
|
+
}
|
|
2336
|
+
},
|
|
2337
|
+
"path": {
|
|
2338
|
+
"type": "string",
|
|
2339
|
+
"maxLength": 200
|
|
2340
|
+
}
|
|
2341
|
+
}
|
|
2342
|
+
}
|
|
2343
|
+
},
|
|
2344
|
+
"more": {
|
|
2345
|
+
"type": "boolean"
|
|
2346
|
+
},
|
|
2347
|
+
"incomplete": {
|
|
2348
|
+
"type": "array",
|
|
2349
|
+
"maxItems": 100,
|
|
2350
|
+
"items": {
|
|
2351
|
+
"type": "object",
|
|
2352
|
+
"additionalProperties": false,
|
|
2353
|
+
"required": [
|
|
2354
|
+
"id",
|
|
2355
|
+
"name",
|
|
2356
|
+
"reason"
|
|
2357
|
+
],
|
|
2358
|
+
"properties": {
|
|
2359
|
+
"id": {
|
|
2360
|
+
"type": "string",
|
|
2361
|
+
"maxLength": 200
|
|
2362
|
+
},
|
|
2363
|
+
"name": {
|
|
2364
|
+
"type": "string",
|
|
2365
|
+
"maxLength": 200
|
|
2366
|
+
},
|
|
2367
|
+
"reason": {
|
|
2368
|
+
"type": "string",
|
|
2369
|
+
"maxLength": 200
|
|
2370
|
+
}
|
|
2371
|
+
}
|
|
2372
|
+
}
|
|
2373
|
+
}
|
|
2374
|
+
}
|
|
2375
|
+
}
|
|
2078
2376
|
}
|
|
2079
2377
|
],
|
|
2080
2378
|
"views": [
|
|
@@ -2128,7 +2426,8 @@
|
|
|
2128
2426
|
"wiki.pages",
|
|
2129
2427
|
"wiki.read",
|
|
2130
2428
|
"commitments.list",
|
|
2131
|
-
"profile.read"
|
|
2429
|
+
"profile.read",
|
|
2430
|
+
"terms.list"
|
|
2132
2431
|
]
|
|
2133
2432
|
},
|
|
2134
2433
|
{
|
|
@@ -2227,13 +2526,67 @@
|
|
|
2227
2526
|
"data"
|
|
2228
2527
|
],
|
|
2229
2528
|
"rpc": []
|
|
2529
|
+
},
|
|
2530
|
+
{
|
|
2531
|
+
"v": 1,
|
|
2532
|
+
"id": "remembered",
|
|
2533
|
+
"place": "tool-result",
|
|
2534
|
+
"title": "Saved to memory",
|
|
2535
|
+
"tools": [
|
|
2536
|
+
"mem.remember",
|
|
2537
|
+
"mem.revise",
|
|
2538
|
+
"mem.commitments"
|
|
2539
|
+
],
|
|
2540
|
+
"page": "views/remembered.html",
|
|
2541
|
+
"grants": [
|
|
2542
|
+
"data"
|
|
2543
|
+
],
|
|
2544
|
+
"rpc": []
|
|
2230
2545
|
}
|
|
2231
2546
|
],
|
|
2232
2547
|
"signIns": [],
|
|
2233
2548
|
"contributes": {
|
|
2234
2549
|
"homeFeeds": [],
|
|
2235
2550
|
"homeWidgets": [],
|
|
2236
|
-
"workKinds": [
|
|
2551
|
+
"workKinds": [
|
|
2552
|
+
{
|
|
2553
|
+
"id": "recall",
|
|
2554
|
+
"label": "Searching memory",
|
|
2555
|
+
"icon": "file-text",
|
|
2556
|
+
"tools": [
|
|
2557
|
+
"mem.recall",
|
|
2558
|
+
"mem.status",
|
|
2559
|
+
"mem.cursor",
|
|
2560
|
+
"mem.wiki",
|
|
2561
|
+
"mem.members",
|
|
2562
|
+
"mem.grants"
|
|
2563
|
+
]
|
|
2564
|
+
},
|
|
2565
|
+
{
|
|
2566
|
+
"id": "remember",
|
|
2567
|
+
"label": "Saving to memory",
|
|
2568
|
+
"icon": "work",
|
|
2569
|
+
"tools": [
|
|
2570
|
+
"mem.remember",
|
|
2571
|
+
"mem.commitments",
|
|
2572
|
+
"mem.revise",
|
|
2573
|
+
"mem.page"
|
|
2574
|
+
]
|
|
2575
|
+
},
|
|
2576
|
+
{
|
|
2577
|
+
"id": "organise",
|
|
2578
|
+
"label": "Organising memory",
|
|
2579
|
+
"icon": "wrench",
|
|
2580
|
+
"tools": [
|
|
2581
|
+
"mem.spaces",
|
|
2582
|
+
"mem.share",
|
|
2583
|
+
"mem.promote",
|
|
2584
|
+
"mem.forget",
|
|
2585
|
+
"mem.collect",
|
|
2586
|
+
"mem.ingest"
|
|
2587
|
+
]
|
|
2588
|
+
}
|
|
2589
|
+
],
|
|
2237
2590
|
"settings": [
|
|
2238
2591
|
{
|
|
2239
2592
|
"key": "controlURL",
|
|
@@ -2245,8 +2598,15 @@
|
|
|
2245
2598
|
"key": "capture",
|
|
2246
2599
|
"label": "Remember conversations",
|
|
2247
2600
|
"type": "boolean",
|
|
2601
|
+
"default": true,
|
|
2248
2602
|
"description": "On by default: finished turns are saved to your private memory. Off: the memory tools still work, and nothing is saved unless the agent is asked to remember it."
|
|
2249
2603
|
},
|
|
2604
|
+
{
|
|
2605
|
+
"key": "skipAsks",
|
|
2606
|
+
"label": "Run without asking",
|
|
2607
|
+
"type": "string",
|
|
2608
|
+
"description": "Empty by default. Memory's asks to turn off, separated by commas, such as memory.forget, page.delete; a deny still stands. The full list is in Memory's docs/permissions.md. A team write held in your Inbox still waits there."
|
|
2609
|
+
},
|
|
2250
2610
|
{
|
|
2251
2611
|
"key": "token",
|
|
2252
2612
|
"label": "Memory key",
|
|
@@ -2259,10 +2619,8 @@
|
|
|
2259
2619
|
"memory"
|
|
2260
2620
|
],
|
|
2261
2621
|
"asks": [
|
|
2262
|
-
"memory.remember",
|
|
2263
2622
|
"memory.forget",
|
|
2264
2623
|
"memory.promote",
|
|
2265
|
-
"memory.promote.revoke",
|
|
2266
2624
|
"wiki.write",
|
|
2267
2625
|
"wiki.delete",
|
|
2268
2626
|
"memory.revise",
|
|
@@ -2271,7 +2629,9 @@
|
|
|
2271
2629
|
"share.grant",
|
|
2272
2630
|
"share.revoke",
|
|
2273
2631
|
"share.transfer",
|
|
2274
|
-
"
|
|
2632
|
+
"share.move",
|
|
2633
|
+
"session.bind",
|
|
2634
|
+
"sources.unbind"
|
|
2275
2635
|
],
|
|
2276
2636
|
"routines": [
|
|
2277
2637
|
{
|
|
@@ -2302,23 +2662,26 @@
|
|
|
2302
2662
|
"views/pages.html",
|
|
2303
2663
|
"views/graph.html",
|
|
2304
2664
|
"docs/agent-protocol.md",
|
|
2665
|
+
"docs/agent-instructions.md",
|
|
2666
|
+
"docs/permissions.md",
|
|
2305
2667
|
"!docs/README.md",
|
|
2306
2668
|
"README.md",
|
|
2307
2669
|
"LICENSE",
|
|
2308
2670
|
"SECURITY.md",
|
|
2309
2671
|
"CHANGELOG.md",
|
|
2310
|
-
"views/recall.html"
|
|
2672
|
+
"views/recall.html",
|
|
2673
|
+
"views/remembered.html"
|
|
2311
2674
|
],
|
|
2312
2675
|
"publishConfig": {
|
|
2313
2676
|
"access": "public"
|
|
2314
2677
|
},
|
|
2315
2678
|
"scripts": {
|
|
2316
|
-
"test": "node --experimental-strip-types --test test/*.test.js",
|
|
2317
|
-
"test:load": "node --test test/load-harness.test.js test/load-gateway.test.js",
|
|
2318
|
-
"test:ops": "node --test test/ops-control.test.js",
|
|
2319
|
-
"test:eval": "node --test test/agent-eval.test.js",
|
|
2679
|
+
"test": "node --experimental-strip-types --import ./test/support/tmp-isolation.js --test test/*.test.js",
|
|
2680
|
+
"test:load": "node --import ./test/support/tmp-isolation.js --test test/load-harness.test.js test/load-gateway.test.js",
|
|
2681
|
+
"test:ops": "node --import ./test/support/tmp-isolation.js --test test/ops-control.test.js",
|
|
2682
|
+
"test:eval": "node --import ./test/support/tmp-isolation.js --test test/agent-eval.test.js",
|
|
2320
2683
|
"test:pack": "node --test test/package-contents.test.js",
|
|
2321
|
-
"test:records": "node --disable-warning=ExperimentalWarning --test records/test/*.test.js",
|
|
2684
|
+
"test:records": "node --disable-warning=ExperimentalWarning --import ./test/support/tmp-isolation.js --test records/test/*.test.js",
|
|
2322
2685
|
"eval:agent": "node scripts/eval/agent-eval.mjs",
|
|
2323
2686
|
"eval:core": "node scripts/eval/agent-eval.mjs --suite core --runs 1 --timeout 120",
|
|
2324
2687
|
"eval:core:release": "node scripts/eval/agent-eval.mjs --suite core --runs 3 --timeout 120",
|
|
@@ -2331,6 +2694,11 @@
|
|
|
2331
2694
|
"eval:closed-book": "node scripts/eval/agent-eval.mjs --suite core --closed-book --runs 1 --timeout 120 --scenario core-recall-model --scenario core-recall-orb --scenario core-recall-port --scenario core-recall-region --scenario core-prior-db --scenario core-prior-version --scenario core-source-attribution --scenario core-preference --scenario core-update-owner --scenario core-update-region",
|
|
2332
2695
|
"eval:agent:list": "node scripts/eval/agent-eval.mjs --list",
|
|
2333
2696
|
"eval:controls": "node scripts/eval/controls.mjs",
|
|
2697
|
+
"eval:regrade": "node scripts/eval/regrade.mjs",
|
|
2698
|
+
"eval:c1": "node scripts/eval/c1.mjs",
|
|
2699
|
+
"eval:gate-v2": "node scripts/eval/gate-v2.mjs",
|
|
2700
|
+
"eval:writes": "node scripts/eval/write-allowlist.mjs",
|
|
2701
|
+
"eval:asks": "node scripts/eval/ask-policy.mjs",
|
|
2334
2702
|
"load:spaces": "node scripts/loadtest-spaces.mjs",
|
|
2335
2703
|
"load:gateway": "node scripts/loadtest-gateway.mjs",
|
|
2336
2704
|
"load:cell": "node scripts/loadtest-cell.mjs",
|
|
@@ -2363,6 +2731,7 @@
|
|
|
2363
2731
|
"check:copies": "node scripts/check-copies.mjs",
|
|
2364
2732
|
"check": "npm test && npm run check:syntax && npm run check:docs && npm run check:protocol && npm run check:copies",
|
|
2365
2733
|
"check:jelly": "bun scripts/check-jelly-declaration.mjs",
|
|
2734
|
+
"check:jelly:master": "scripts/check-jelly-master.sh",
|
|
2366
2735
|
"shots:views": "node scripts/view-shots.mjs"
|
|
2367
2736
|
},
|
|
2368
2737
|
"keywords": [
|
|
@@ -26,28 +26,45 @@ await tools.mem.page({ action: "list", prefix: "projects/" }) // mem_page({ ac
|
|
|
26
26
|
await tools.mem.page({ action: "read", path: "people/ama" }) // mem_page({ action: "read", path: "people/ama" })
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
`read` shows the fields,
|
|
30
|
-
|
|
31
|
-
|
|
29
|
+
`read` shows the metadata first (fields, sections, links, backlinks, version),
|
|
30
|
+
then the body alone inside `<page_body>`. Only the text inside it is the page:
|
|
31
|
+
never copy the metadata or the markers into a write, which refuses them. Before
|
|
32
|
+
creating a page at an unknown path, check for an existing one rather than
|
|
33
|
+
making a near-duplicate.
|
|
32
34
|
|
|
33
|
-
##
|
|
35
|
+
## Replace, append and write
|
|
34
36
|
|
|
35
37
|
```js
|
|
36
|
-
await tools.mem.page({ action: "
|
|
37
|
-
await tools.mem.page({ action: "
|
|
38
|
+
await tools.mem.page({ action: "replace", path: "projects/checkout-v3", section: "Status", content: "- Launch 18 Nov, after the legal review (2026-11-05)." })
|
|
39
|
+
await tools.mem.page({ action: "append", path: "projects/checkout-v3", section: "Log", content: "- 2026-11-05: launch moved to 18 Nov after the legal review." })
|
|
38
40
|
```
|
|
39
41
|
|
|
42
|
+
- `replace` sets one `## section`'s text and keeps every other line: Status,
|
|
43
|
+
Purpose, People. "Status" also finds "Status (as of …)", for append too. A
|
|
44
|
+
name that fits two headings is refused, with their lines: rename or merge
|
|
45
|
+
one with `write`. Close any code fence you open. If someone changed that
|
|
46
|
+
section since this session's read, it is a conflict: read, merge, replace again.
|
|
40
47
|
- `append` adds one line under a `## section`, creating it when missing: Log,
|
|
41
|
-
Timeline, Decisions.
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
+
Timeline, Decisions. On the person's own pages, one Log line per change,
|
|
49
|
+
starting with "- ". Don't re-read a successful write unless the answer
|
|
50
|
+
depends on the updated page.
|
|
51
|
+
- `write` replaces the whole body: for a new page or a restructure. Read the
|
|
52
|
+
page first, send only the body; a missing or stale version conflicts, so
|
|
53
|
+
read the latest and merge rather than overwrite.
|
|
54
|
+
- Date every "now" claim.
|
|
48
55
|
- A shared write follows host permission settings: it defaults to ask, but an
|
|
49
56
|
allow or remembered always may proceed without a prompt. Jelly with
|
|
50
|
-
`heldTeamWrites` holds it in the Inbox. A private write never asks
|
|
57
|
+
`heldTeamWrites` holds it in the Inbox. A private write never asks
|
|
58
|
+
(docs/permissions.md says how to change any ask).
|
|
59
|
+
- Where a page lands: `journal/` always in the personal space; a page that
|
|
60
|
+
exists in the session's shared space stays there; a new page is personal
|
|
61
|
+
unless the call passes the shared `space`, only when the person asked.
|
|
62
|
+
- On a team page (one that exists in a shared space) an agent only adds
|
|
63
|
+
lines, and only what the person asked for: `append` it, such as a dated
|
|
64
|
+
"Status:" line. No Log line, timeline entry or "noted that…" about your own
|
|
65
|
+
change; that bookkeeping is for the person's own pages. `write`,
|
|
66
|
+
`replace`, `move` and `delete` are refused there, and a journal page is
|
|
67
|
+
never written there. The person edits or removes lines in Memory's console.
|
|
51
68
|
|
|
52
69
|
## Links and timelines
|
|
53
70
|
|
|
@@ -63,7 +80,8 @@ await tools.mem.page({ action: "move", path: "topics/pricing", to: "projects/pri
|
|
|
63
80
|
|
|
64
81
|
A **Timeline** section is a dated list of what happened with a person or a
|
|
65
82
|
project. The daily routine appends to it, each line citing its source; append to
|
|
66
|
-
it yourself with the date first
|
|
83
|
+
it yourself with the date first, on the person's own pages (a team page gets
|
|
84
|
+
only what the person asked for).
|
|
67
85
|
|
|
68
86
|
## Page templates
|
|
69
87
|
|
|
@@ -96,6 +114,11 @@ items.
|
|
|
96
114
|
memory: Context, Decision, Alternatives, Consequences, Status.
|
|
97
115
|
- **Runbook** (`runbooks/<slug>`): When to use, Steps, Checks, Rollback, "Last
|
|
98
116
|
verified <date> by <who>".
|
|
117
|
+
- **Meeting** (`meetings/<date>-<slug>`, type `meeting`): Date, Attendees (as
|
|
118
|
+
`[[people/<slug>]]` links, never names as text), Decisions, and what was
|
|
119
|
+
agreed. A meeting page in a shared space takes append or a proposal, like any
|
|
120
|
+
team page; nothing writes one on its own yet, so a person or an agent asked
|
|
121
|
+
to keep a meeting's notes writes it by hand.
|
|
99
122
|
|
|
100
123
|
## The journal
|
|
101
124
|
|
|
@@ -112,7 +135,8 @@ with `revise`.
|
|
|
112
135
|
## The dashboard
|
|
113
136
|
|
|
114
137
|
`index` is the dashboard, pinned at the start of every session (at most 60
|
|
115
|
-
lines).
|
|
138
|
+
lines). Writing, appending to or moving it asks the person, in every space:
|
|
139
|
+
it changes what every later session starts with. The routine owns only the block between `<!-- routine:dashboard -->` and
|
|
116
140
|
`<!-- /routine -->` (goals, active projects, due items, recent decisions, what
|
|
117
141
|
needs review) and keeps everything the person writes outside it. To set goals,
|
|
118
142
|
write them above the block:
|