@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.
- package/README.md +166 -1
- package/dist/cli.js +2000 -512
- package/dist/index.d.ts +12 -1
- package/dist/index.js +64 -8
- package/dist/shared/{cli-51yqa57b.js → cli-j07tbrke.js} +8 -0
- package/dist/shared/{library-85ayxzg9.js → library-7wcv2ckk.js} +1369 -163
- package/dist/shared/{library-xw54vgxq.js → library-f3be6g03.js} +11 -1
- package/dist/shared/{library-b7vtz46e.js → library-ppnv0f07.js} +1 -1
- package/dist/shared/{library-rw1d7smw.js → library-tqrvrykj.js} +1 -1
- package/dist/shared/{library-y97z4cef.js → library-z7qsdq88.js} +1 -1
- package/dist/ui/observability.html +80 -80
- package/package.json +2 -1
- package/schemas/README.md +1 -1
- package/schemas/config.schema.json +18 -0
- package/schemas/devtools-manifest.json +135 -1
- package/schemas/tool-catalog.json +661 -3
- package/schemas/tools/confirm_mcp_settings.json +19 -0
- package/schemas/tools/get_mcp_settings.json +7 -0
- package/schemas/tools/get_mcp_settings_schema.json +7 -0
- package/schemas/tools/memory_get_scope.json +14 -0
- package/schemas/tools/memory_history.json +14 -0
- package/schemas/tools/memory_recall.json +35 -0
- package/schemas/tools/memory_remember.json +65 -0
- package/schemas/tools/memory_review.json +44 -0
- package/schemas/tools/memory_revise.json +61 -0
- package/schemas/tools/memory_set_scope.json +37 -0
- package/schemas/tools/preview_mcp_settings.json +94 -0
- package/schemas/tools/rollback_mcp_settings.json +19 -0
- package/schemas/tools/update_mcp_settings.json +110 -0
- /package/dist/shared/{cli-5rs21zfv.js → cli-gtq5bw8q.js} +0 -0
- /package/dist/shared/{cli-s1kg75zm.js → cli-s0rxncz4.js} +0 -0
- /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.
|
|
3
|
+
"version": "5.19.0",
|
|
4
4
|
"generated": "by scripts/gen-schemas.ts — do not edit by hand",
|
|
5
|
-
"toolCount":
|
|
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.
|
|
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",
|