@usex/mikrotik-mcp 5.17.0 → 5.19.0

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.
Files changed (32) hide show
  1. package/README.md +166 -1
  2. package/dist/cli.js +2000 -512
  3. package/dist/index.d.ts +12 -1
  4. package/dist/index.js +64 -8
  5. package/dist/shared/{cli-51yqa57b.js → cli-j07tbrke.js} +8 -0
  6. package/dist/shared/{library-85ayxzg9.js → library-7wcv2ckk.js} +1369 -163
  7. package/dist/shared/{library-xw54vgxq.js → library-f3be6g03.js} +11 -1
  8. package/dist/shared/{library-b7vtz46e.js → library-ppnv0f07.js} +1 -1
  9. package/dist/shared/{library-rw1d7smw.js → library-tqrvrykj.js} +1 -1
  10. package/dist/shared/{library-y97z4cef.js → library-z7qsdq88.js} +1 -1
  11. package/dist/ui/observability.html +80 -80
  12. package/package.json +2 -1
  13. package/schemas/README.md +1 -1
  14. package/schemas/config.schema.json +18 -0
  15. package/schemas/devtools-manifest.json +135 -1
  16. package/schemas/tool-catalog.json +661 -3
  17. package/schemas/tools/confirm_mcp_settings.json +19 -0
  18. package/schemas/tools/get_mcp_settings.json +7 -0
  19. package/schemas/tools/get_mcp_settings_schema.json +7 -0
  20. package/schemas/tools/memory_get_scope.json +14 -0
  21. package/schemas/tools/memory_history.json +14 -0
  22. package/schemas/tools/memory_recall.json +35 -0
  23. package/schemas/tools/memory_remember.json +65 -0
  24. package/schemas/tools/memory_review.json +44 -0
  25. package/schemas/tools/memory_revise.json +61 -0
  26. package/schemas/tools/memory_set_scope.json +37 -0
  27. package/schemas/tools/preview_mcp_settings.json +94 -0
  28. package/schemas/tools/rollback_mcp_settings.json +19 -0
  29. package/schemas/tools/update_mcp_settings.json +110 -0
  30. /package/dist/shared/{cli-5rs21zfv.js → cli-gtq5bw8q.js} +0 -0
  31. /package/dist/shared/{cli-s1kg75zm.js → cli-s0rxncz4.js} +0 -0
  32. /package/dist/shared/{cli-s5nnez6j.js → cli-y00nwzxx.js} +0 -0
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "5.17.0",
3
+ "version": "5.19.0",
4
4
  "generated": "by scripts/gen-schemas.ts — do not edit by hand",
5
- "toolCount": 924,
5
+ "toolCount": 937,
6
6
  "tools": [
7
7
  {
8
8
  "name": "create_client_check",
@@ -1339,6 +1339,319 @@
1339
1339
  "additionalProperties": false
1340
1340
  }
1341
1341
  },
1342
+ {
1343
+ "name": "get_mcp_settings",
1344
+ "title": "Read MCP Server Settings",
1345
+ "risk": "read",
1346
+ "annotations": {
1347
+ "readOnlyHint": true,
1348
+ "idempotentHint": true,
1349
+ "openWorldHint": false
1350
+ },
1351
+ "description": "Read the MCP host's editable settings, opaque revision and pending change. Covers tool presentation, SSH pooling, dashboard recording, Memory enablement and startup update checks. Contains no credentials; never contacts a router. These are configured values, not proof a startup-only component has restarted. Read before preview_mcp_settings or update_mcp_settings.",
1352
+ "inputSchema": {
1353
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1354
+ "type": "object",
1355
+ "properties": {},
1356
+ "additionalProperties": false
1357
+ }
1358
+ },
1359
+ {
1360
+ "name": "get_mcp_settings_schema",
1361
+ "title": "Describe Editable MCP Settings",
1362
+ "risk": "read",
1363
+ "annotations": {
1364
+ "readOnlyHint": true,
1365
+ "idempotentHint": true,
1366
+ "openWorldHint": false
1367
+ },
1368
+ "description": "Get the exact JSON Schema for the partial changes accepted by preview_mcp_settings and update_mcp_settings. Unknown/protected fields are rejected, omitted fields stay unchanged. Credentials, listeners, file paths, device inventory and permission ceilings are operator-managed. No device or file changes.",
1369
+ "inputSchema": {
1370
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1371
+ "type": "object",
1372
+ "properties": {},
1373
+ "additionalProperties": false
1374
+ }
1375
+ },
1376
+ {
1377
+ "name": "preview_mcp_settings",
1378
+ "title": "Validate and Preview MCP Settings",
1379
+ "risk": "read",
1380
+ "annotations": {
1381
+ "readOnlyHint": true,
1382
+ "idempotentHint": true,
1383
+ "openWorldHint": false
1384
+ },
1385
+ "description": "Validate a partial MCP settings change against live configuration and return changed paths, a secret-free diff, revision and restart requirements. No file writes or router contact. Show the preview and obtain user approval before applying; never guess setting names.",
1386
+ "inputSchema": {
1387
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1388
+ "type": "object",
1389
+ "properties": {
1390
+ "changes": {
1391
+ "type": "object",
1392
+ "properties": {
1393
+ "mcp": {
1394
+ "type": "object",
1395
+ "properties": {
1396
+ "toolPageSize": {
1397
+ "type": "integer",
1398
+ "minimum": 0,
1399
+ "maximum": 9007199254740991
1400
+ },
1401
+ "appViews": {
1402
+ "type": "boolean"
1403
+ },
1404
+ "capabilityGating": {
1405
+ "type": "string",
1406
+ "enum": ["off", "annotate", "filter"]
1407
+ }
1408
+ },
1409
+ "additionalProperties": false
1410
+ },
1411
+ "ssh": {
1412
+ "type": "object",
1413
+ "properties": {
1414
+ "keepAlive": {
1415
+ "type": "boolean"
1416
+ },
1417
+ "keepAliveInterval": {
1418
+ "type": "integer",
1419
+ "minimum": 0,
1420
+ "maximum": 9007199254740991
1421
+ },
1422
+ "idleTimeout": {
1423
+ "type": "integer",
1424
+ "exclusiveMinimum": 0,
1425
+ "maximum": 9007199254740991
1426
+ }
1427
+ },
1428
+ "additionalProperties": false
1429
+ },
1430
+ "dashboard": {
1431
+ "type": "object",
1432
+ "properties": {
1433
+ "maxEvents": {
1434
+ "type": "integer",
1435
+ "exclusiveMinimum": 0,
1436
+ "maximum": 9007199254740991
1437
+ },
1438
+ "captureBody": {
1439
+ "type": "boolean"
1440
+ },
1441
+ "redactInput": {
1442
+ "description": "May enable redaction, never disable it.",
1443
+ "type": "boolean",
1444
+ "const": true
1445
+ },
1446
+ "maxBodyBytes": {
1447
+ "type": "integer",
1448
+ "minimum": 0,
1449
+ "maximum": 9007199254740991
1450
+ },
1451
+ "feedLimit": {
1452
+ "type": "integer",
1453
+ "exclusiveMinimum": 0,
1454
+ "maximum": 10000
1455
+ }
1456
+ },
1457
+ "additionalProperties": false
1458
+ },
1459
+ "memory": {
1460
+ "type": "object",
1461
+ "properties": {
1462
+ "enabled": {
1463
+ "type": "boolean"
1464
+ }
1465
+ },
1466
+ "additionalProperties": false
1467
+ },
1468
+ "disableUpdateCheck": {
1469
+ "type": "boolean"
1470
+ }
1471
+ },
1472
+ "additionalProperties": false,
1473
+ "description": "Only the fields to change; omitted values are preserved."
1474
+ }
1475
+ },
1476
+ "required": ["changes"],
1477
+ "additionalProperties": false
1478
+ }
1479
+ },
1480
+ {
1481
+ "name": "update_mcp_settings",
1482
+ "title": "Safely Update MCP Settings",
1483
+ "risk": "write",
1484
+ "annotations": {
1485
+ "destructiveHint": false,
1486
+ "openWorldHint": false
1487
+ },
1488
+ "description": "Apply explicitly user-approved MCP host settings, not RouterOS configuration. First get_mcp_settings_schema and preview_mcp_settings; supply that revision and confirm=true. Backs up the config locally, saves atomically and arms a 30–600s in-process rollback (default 60s). Conflicts with another pending dashboard/tool edit are rejected. Verify configured values with get_mcp_settings, then confirm_mcp_settings before the deadline or rollback_mcp_settings. Never restart while pending: the rollback timer does not survive process exit. Restart-required settings are only fully activated after confirmation and a separate operator-controlled restart. Does not widen access scopes or change router addresses/credentials.",
1489
+ "inputSchema": {
1490
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1491
+ "type": "object",
1492
+ "properties": {
1493
+ "changes": {
1494
+ "type": "object",
1495
+ "properties": {
1496
+ "mcp": {
1497
+ "type": "object",
1498
+ "properties": {
1499
+ "toolPageSize": {
1500
+ "type": "integer",
1501
+ "minimum": 0,
1502
+ "maximum": 9007199254740991
1503
+ },
1504
+ "appViews": {
1505
+ "type": "boolean"
1506
+ },
1507
+ "capabilityGating": {
1508
+ "type": "string",
1509
+ "enum": ["off", "annotate", "filter"]
1510
+ }
1511
+ },
1512
+ "additionalProperties": false
1513
+ },
1514
+ "ssh": {
1515
+ "type": "object",
1516
+ "properties": {
1517
+ "keepAlive": {
1518
+ "type": "boolean"
1519
+ },
1520
+ "keepAliveInterval": {
1521
+ "type": "integer",
1522
+ "minimum": 0,
1523
+ "maximum": 9007199254740991
1524
+ },
1525
+ "idleTimeout": {
1526
+ "type": "integer",
1527
+ "exclusiveMinimum": 0,
1528
+ "maximum": 9007199254740991
1529
+ }
1530
+ },
1531
+ "additionalProperties": false
1532
+ },
1533
+ "dashboard": {
1534
+ "type": "object",
1535
+ "properties": {
1536
+ "maxEvents": {
1537
+ "type": "integer",
1538
+ "exclusiveMinimum": 0,
1539
+ "maximum": 9007199254740991
1540
+ },
1541
+ "captureBody": {
1542
+ "type": "boolean"
1543
+ },
1544
+ "redactInput": {
1545
+ "description": "May enable redaction, never disable it.",
1546
+ "type": "boolean",
1547
+ "const": true
1548
+ },
1549
+ "maxBodyBytes": {
1550
+ "type": "integer",
1551
+ "minimum": 0,
1552
+ "maximum": 9007199254740991
1553
+ },
1554
+ "feedLimit": {
1555
+ "type": "integer",
1556
+ "exclusiveMinimum": 0,
1557
+ "maximum": 10000
1558
+ }
1559
+ },
1560
+ "additionalProperties": false
1561
+ },
1562
+ "memory": {
1563
+ "type": "object",
1564
+ "properties": {
1565
+ "enabled": {
1566
+ "type": "boolean"
1567
+ }
1568
+ },
1569
+ "additionalProperties": false
1570
+ },
1571
+ "disableUpdateCheck": {
1572
+ "type": "boolean"
1573
+ }
1574
+ },
1575
+ "additionalProperties": false
1576
+ },
1577
+ "revision": {
1578
+ "type": "string",
1579
+ "minLength": 64,
1580
+ "maxLength": 64,
1581
+ "description": "Current revision from get_mcp_settings or preview_mcp_settings."
1582
+ },
1583
+ "confirm": {
1584
+ "type": "boolean",
1585
+ "const": true,
1586
+ "description": "Only set after the user authorizes these exact changes."
1587
+ },
1588
+ "rollback_seconds": {
1589
+ "default": 60,
1590
+ "type": "integer",
1591
+ "minimum": 30,
1592
+ "maximum": 600
1593
+ }
1594
+ },
1595
+ "required": ["changes", "revision", "confirm", "rollback_seconds"],
1596
+ "additionalProperties": false
1597
+ }
1598
+ },
1599
+ {
1600
+ "name": "confirm_mcp_settings",
1601
+ "title": "Keep a Pending MCP Settings Change",
1602
+ "risk": "write",
1603
+ "annotations": {
1604
+ "destructiveHint": false,
1605
+ "openWorldHint": false
1606
+ },
1607
+ "description": "Keep the exact pending change created by update_mcp_settings after reading back its values. Cancels its rollback timer. Requires the current revision and pending_id; cannot confirm dashboard-owned, expired or superseded changes. Does not restart the MCP server or contact routers.",
1608
+ "inputSchema": {
1609
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1610
+ "type": "object",
1611
+ "properties": {
1612
+ "pending_id": {
1613
+ "type": "string",
1614
+ "minLength": 1
1615
+ },
1616
+ "revision": {
1617
+ "type": "string",
1618
+ "minLength": 64,
1619
+ "maxLength": 64,
1620
+ "description": "Revision returned by update_mcp_settings or get_mcp_settings."
1621
+ }
1622
+ },
1623
+ "required": ["pending_id", "revision"],
1624
+ "additionalProperties": false
1625
+ }
1626
+ },
1627
+ {
1628
+ "name": "rollback_mcp_settings",
1629
+ "title": "Revert a Pending MCP Settings Change",
1630
+ "risk": "write",
1631
+ "annotations": {
1632
+ "destructiveHint": false,
1633
+ "openWorldHint": false
1634
+ },
1635
+ "description": "Restore the host-side config backup for a still-pending update_mcp_settings change. Requires its pending_id and current revision. Refuses dashboard-owned transactions or changes that would overwrite newer configuration. Restores configured values only; no router changes, server restart or deletion of knowledge data.",
1636
+ "inputSchema": {
1637
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
1638
+ "type": "object",
1639
+ "properties": {
1640
+ "pending_id": {
1641
+ "type": "string",
1642
+ "minLength": 1
1643
+ },
1644
+ "revision": {
1645
+ "type": "string",
1646
+ "minLength": 64,
1647
+ "maxLength": 64,
1648
+ "description": "Revision returned by update_mcp_settings or get_mcp_settings."
1649
+ }
1650
+ },
1651
+ "required": ["pending_id", "revision"],
1652
+ "additionalProperties": false
1653
+ }
1654
+ },
1342
1655
  {
1343
1656
  "name": "get_device_capabilities",
1344
1657
  "title": "Get Device Capabilities",
@@ -24845,7 +25158,7 @@
24845
25158
  "idempotentHint": true,
24846
25159
  "openWorldHint": false
24847
25160
  },
24848
- "description": "List all MikroTik devices registered in this server's configuration (server-side metadata — no RouterOS command is run, no SSH connection is opened). Use this to discover the exact device name strings required by the `device` argument on every other tool, especially when working across multiple routers (e.g. building a tunnel between two devices). Returns each device's name, username, host, port, auth method (key / password / none), optional description, and which entry is the default. This name → host:port mapping is FIXED for the life of the server process — it does NOT change mid-session, so a given device name always reaches the same physical router. Call this to verify the exact target before any write/destructive change when several routers are configured. Credentials and private-key material are never included in the output.",
25161
+ "description": "List all MikroTik devices registered in this server's configuration (server-side metadata — no RouterOS command is run, no SSH connection is opened). Use this to discover the exact device name strings required by the `device` argument on every other tool, especially when working across multiple routers (e.g. building a tunnel between two devices). Returns each device's name, username, host, port, auth method (key / password / none), optional description, and which entry is the default. Includes Primary, ordered alternate management IPs, open connections and last connection observations. Alternate IPs must all belong to the same physical router. Automatic failover happens only while connecting; dispatched commands are never replayed. Last success is historical, not proof of a currently open session. Call this to verify the exact target before any write/destructive change when several routers are configured. Credentials and private-key material are never included in the output.",
24849
25162
  "inputSchema": {
24850
25163
  "$schema": "https://json-schema.org/draft/2020-12/schema",
24851
25164
  "type": "object",
@@ -32256,6 +32569,351 @@
32256
32569
  "additionalProperties": false
32257
32570
  }
32258
32571
  },
32572
+ {
32573
+ "name": "memory_get_scope",
32574
+ "title": "Inspect Memory Sharing Scope",
32575
+ "risk": "read",
32576
+ "annotations": {
32577
+ "readOnlyHint": true,
32578
+ "idempotentHint": true,
32579
+ "openWorldHint": false
32580
+ },
32581
+ "description": "Read an existing entity's memory scope, explicit group members and scope revision. Device is the safe default. Shared applies to every device in this MCP database; Group only to its exact members. Scope is logical applicability, not an access-control boundary. Does not contact a router.",
32582
+ "inputSchema": {
32583
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32584
+ "type": "object",
32585
+ "properties": {
32586
+ "entityName": {
32587
+ "type": "string",
32588
+ "minLength": 1,
32589
+ "maxLength": 200
32590
+ }
32591
+ },
32592
+ "required": ["entityName"],
32593
+ "additionalProperties": false
32594
+ }
32595
+ },
32596
+ {
32597
+ "name": "memory_set_scope",
32598
+ "title": "Set Memory Sharing Scope",
32599
+ "risk": "write",
32600
+ "annotations": {
32601
+ "destructiveHint": false,
32602
+ "openWorldHint": false
32603
+ },
32604
+ "description": "Explicitly configure Device, Group or Shared scope for an existing knowledge entity. ALL its existing and future memories inherit the scope. Read memory_get_scope first and supply expectedRevision. Shared/Group require confirmSharing=true after reviewing all affected knowledge and the user's intent; never promote a router's local facts automatically. Prefer a new dedicated policy entity. Group members must be exact existing Device-scoped entities, no nested groups; members replaces the full list. No router changes.",
32605
+ "inputSchema": {
32606
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32607
+ "type": "object",
32608
+ "properties": {
32609
+ "entityName": {
32610
+ "type": "string",
32611
+ "minLength": 1,
32612
+ "maxLength": 200
32613
+ },
32614
+ "scope": {
32615
+ "type": "string",
32616
+ "enum": ["device", "group", "shared"]
32617
+ },
32618
+ "members": {
32619
+ "default": [],
32620
+ "maxItems": 100,
32621
+ "type": "array",
32622
+ "items": {
32623
+ "type": "string",
32624
+ "minLength": 1,
32625
+ "maxLength": 200
32626
+ }
32627
+ },
32628
+ "expectedRevision": {
32629
+ "type": "integer",
32630
+ "minimum": 0,
32631
+ "maximum": 9007199254740991
32632
+ },
32633
+ "confirmSharing": {
32634
+ "default": false,
32635
+ "type": "boolean"
32636
+ }
32637
+ },
32638
+ "required": ["entityName", "scope", "members", "expectedRevision", "confirmSharing"],
32639
+ "additionalProperties": false
32640
+ }
32641
+ },
32642
+ {
32643
+ "name": "memory_remember",
32644
+ "title": "Remember Network Knowledge",
32645
+ "risk": "write",
32646
+ "annotations": {
32647
+ "destructiveHint": false,
32648
+ "openWorldHint": false
32649
+ },
32650
+ "description": "Save a fact, constraint, lesson, preference or procedure for an existing entity. Supply a source, author-assessed confidence, optional expiry and pin. A stable key (e.g. wan.provider) replaces that entity's previous value atomically and preserves revision history. Never store credentials or raw command dumps. No router changes.",
32651
+ "inputSchema": {
32652
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32653
+ "type": "object",
32654
+ "properties": {
32655
+ "entityName": {
32656
+ "type": "string",
32657
+ "minLength": 1,
32658
+ "maxLength": 200
32659
+ },
32660
+ "content": {
32661
+ "type": "string",
32662
+ "minLength": 1,
32663
+ "maxLength": 8000
32664
+ },
32665
+ "key": {
32666
+ "anyOf": [
32667
+ {
32668
+ "type": "string",
32669
+ "minLength": 1,
32670
+ "maxLength": 120
32671
+ },
32672
+ {
32673
+ "type": "null"
32674
+ }
32675
+ ]
32676
+ },
32677
+ "kind": {
32678
+ "default": "fact",
32679
+ "type": "string",
32680
+ "enum": ["fact", "constraint", "lesson", "preference", "procedure"]
32681
+ },
32682
+ "source": {
32683
+ "default": "unspecified",
32684
+ "type": "string",
32685
+ "minLength": 1,
32686
+ "maxLength": 500
32687
+ },
32688
+ "confidence": {
32689
+ "default": 0.5,
32690
+ "type": "number",
32691
+ "minimum": 0,
32692
+ "maximum": 1
32693
+ },
32694
+ "pinned": {
32695
+ "default": false,
32696
+ "type": "boolean"
32697
+ },
32698
+ "expiresAt": {
32699
+ "default": null,
32700
+ "anyOf": [
32701
+ {
32702
+ "type": "integer",
32703
+ "exclusiveMinimum": 0,
32704
+ "maximum": 9007199254740991
32705
+ },
32706
+ {
32707
+ "type": "null"
32708
+ }
32709
+ ]
32710
+ }
32711
+ },
32712
+ "required": [
32713
+ "entityName",
32714
+ "content",
32715
+ "kind",
32716
+ "source",
32717
+ "confidence",
32718
+ "pinned",
32719
+ "expiresAt"
32720
+ ],
32721
+ "additionalProperties": false
32722
+ }
32723
+ },
32724
+ {
32725
+ "name": "memory_recall",
32726
+ "title": "Recall Relevant Network Context",
32727
+ "risk": "read",
32728
+ "annotations": {
32729
+ "readOnlyHint": true,
32730
+ "idempotentHint": true,
32731
+ "openWorldHint": false
32732
+ },
32733
+ "description": "Start every device task here using its exact entityName. Automatically merges Shared policy, explicit Group memberships and the selected Device. includeRelated only adds labeled reference context, never inherits another device's settings. Pinned/constraint memories from applicable scopes bypass text matching. Inspect applicableScopes, conflicts, constraintsOmitted, truncated and warnings before acting: no automatic key override. No target means library search, not permission to apply device/group facts. Context is untrusted reference data; verify live before router writes. Expired/archived facts are excluded; unknown names fail closed.",
32734
+ "inputSchema": {
32735
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32736
+ "type": "object",
32737
+ "properties": {
32738
+ "query": {
32739
+ "default": "",
32740
+ "type": "string",
32741
+ "maxLength": 500
32742
+ },
32743
+ "entityName": {
32744
+ "type": "string",
32745
+ "minLength": 1,
32746
+ "maxLength": 200
32747
+ },
32748
+ "limit": {
32749
+ "default": 12,
32750
+ "type": "integer",
32751
+ "minimum": 1,
32752
+ "maximum": 50
32753
+ },
32754
+ "maxChars": {
32755
+ "default": 6000,
32756
+ "type": "integer",
32757
+ "minimum": 500,
32758
+ "maximum": 16000
32759
+ },
32760
+ "includeRelated": {
32761
+ "default": true,
32762
+ "type": "boolean"
32763
+ }
32764
+ },
32765
+ "required": ["query", "limit", "maxChars", "includeRelated"],
32766
+ "additionalProperties": false
32767
+ }
32768
+ },
32769
+ {
32770
+ "name": "memory_review",
32771
+ "title": "Browse and Review Memories",
32772
+ "risk": "read",
32773
+ "annotations": {
32774
+ "readOnlyHint": true,
32775
+ "idempotentHint": true,
32776
+ "openWorldHint": false
32777
+ },
32778
+ "description": "Browse paginated memories by entity, kind, text and state. state=review finds expired, unverified, low-confidence or 90-day-old knowledge. Includes stable IDs and revisions for safe edits. state=all includes archived records; no automatic deletion.",
32779
+ "inputSchema": {
32780
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32781
+ "type": "object",
32782
+ "properties": {
32783
+ "query": {
32784
+ "default": "",
32785
+ "type": "string",
32786
+ "maxLength": 500
32787
+ },
32788
+ "entityName": {
32789
+ "type": "string",
32790
+ "minLength": 1,
32791
+ "maxLength": 200
32792
+ },
32793
+ "scope": {
32794
+ "type": "string",
32795
+ "enum": ["device", "group", "shared"]
32796
+ },
32797
+ "kind": {
32798
+ "type": "string",
32799
+ "enum": ["fact", "constraint", "lesson", "preference", "procedure"]
32800
+ },
32801
+ "state": {
32802
+ "default": "active",
32803
+ "type": "string",
32804
+ "enum": ["active", "review", "pinned", "archived", "all"]
32805
+ },
32806
+ "limit": {
32807
+ "default": 30,
32808
+ "type": "integer",
32809
+ "minimum": 1,
32810
+ "maximum": 100
32811
+ },
32812
+ "offset": {
32813
+ "default": 0,
32814
+ "type": "integer",
32815
+ "minimum": 0,
32816
+ "maximum": 1000000
32817
+ }
32818
+ },
32819
+ "required": ["query", "state", "limit", "offset"],
32820
+ "additionalProperties": false
32821
+ }
32822
+ },
32823
+ {
32824
+ "name": "memory_revise",
32825
+ "title": "Revise or Verify a Memory",
32826
+ "risk": "write",
32827
+ "annotations": {
32828
+ "destructiveHint": false,
32829
+ "openWorldHint": false
32830
+ },
32831
+ "description": "Correct, pin, archive or restore a stored memory with its expectedRevision from memory_review. Keeps previous versions and rejects stale edits. Set verified=true only after actually confirming the fact; this does not test any router. Changing content/source resets verification. Expiry is not extended by verification; revise expiresAt explicitly after checking.",
32832
+ "inputSchema": {
32833
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32834
+ "type": "object",
32835
+ "properties": {
32836
+ "id": {
32837
+ "type": "integer",
32838
+ "exclusiveMinimum": 0,
32839
+ "maximum": 9007199254740991
32840
+ },
32841
+ "expectedRevision": {
32842
+ "type": "integer",
32843
+ "exclusiveMinimum": 0,
32844
+ "maximum": 9007199254740991
32845
+ },
32846
+ "content": {
32847
+ "type": "string",
32848
+ "minLength": 1,
32849
+ "maxLength": 8000
32850
+ },
32851
+ "kind": {
32852
+ "type": "string",
32853
+ "enum": ["fact", "constraint", "lesson", "preference", "procedure"]
32854
+ },
32855
+ "source": {
32856
+ "type": "string",
32857
+ "minLength": 1,
32858
+ "maxLength": 500
32859
+ },
32860
+ "confidence": {
32861
+ "type": "number",
32862
+ "minimum": 0,
32863
+ "maximum": 1
32864
+ },
32865
+ "pinned": {
32866
+ "type": "boolean"
32867
+ },
32868
+ "expiresAt": {
32869
+ "anyOf": [
32870
+ {
32871
+ "type": "integer",
32872
+ "exclusiveMinimum": 0,
32873
+ "maximum": 9007199254740991
32874
+ },
32875
+ {
32876
+ "type": "null"
32877
+ }
32878
+ ]
32879
+ },
32880
+ "status": {
32881
+ "type": "string",
32882
+ "enum": ["active", "archived"]
32883
+ },
32884
+ "verified": {
32885
+ "type": "boolean",
32886
+ "const": true
32887
+ }
32888
+ },
32889
+ "required": ["id", "expectedRevision"],
32890
+ "additionalProperties": false
32891
+ }
32892
+ },
32893
+ {
32894
+ "name": "memory_history",
32895
+ "title": "Memory Revision History",
32896
+ "risk": "read",
32897
+ "annotations": {
32898
+ "readOnlyHint": true,
32899
+ "idempotentHint": true,
32900
+ "openWorldHint": false
32901
+ },
32902
+ "description": "Read up to 100 previous revisions of one memory, newest first. Historical values are evidence of prior beliefs, not current facts. Retrieve the current record with memory_review.",
32903
+ "inputSchema": {
32904
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32905
+ "type": "object",
32906
+ "properties": {
32907
+ "id": {
32908
+ "type": "integer",
32909
+ "exclusiveMinimum": 0,
32910
+ "maximum": 9007199254740991
32911
+ }
32912
+ },
32913
+ "required": ["id"],
32914
+ "additionalProperties": false
32915
+ }
32916
+ },
32259
32917
  {
32260
32918
  "name": "memory_create_entities",
32261
32919
  "title": "Create Knowledge Graph Entities",