@usex/mikrotik-mcp 5.16.0 → 5.18.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 (40) hide show
  1. package/README.md +180 -5
  2. package/dist/cli.js +7298 -4293
  3. package/dist/index.d.ts +12 -1
  4. package/dist/index.js +54 -16
  5. package/dist/shared/cli-97csvm6f.js +25 -0
  6. package/dist/shared/cli-ff6yww2e.js +13 -0
  7. package/dist/shared/cli-s423xk9v.js +7 -0
  8. package/dist/shared/{library-pdyv4a32.js → library-08g0pwc9.js} +1 -1
  9. package/dist/shared/{library-0ysgbdj6.js → library-552hdvw2.js} +6244 -4454
  10. package/dist/shared/library-gmx9pzx3.js +17 -0
  11. package/dist/shared/library-w5tyng4c.js +7 -0
  12. package/dist/shared/library-xbg1d52n.js +13 -0
  13. package/dist/ui/client-check.html +80 -0
  14. package/dist/ui/observability.html +136 -75
  15. package/package.json +20 -7
  16. package/schemas/README.md +1 -1
  17. package/schemas/config.schema.json +18 -0
  18. package/schemas/devtools-manifest.json +11996 -0
  19. package/schemas/tool-catalog.json +755 -3
  20. package/schemas/tools/apply_router_migration.json +27 -0
  21. package/schemas/tools/close_client_check.json +14 -0
  22. package/schemas/tools/compare_client_checks.json +24 -0
  23. package/schemas/tools/create_client_check.json +25 -0
  24. package/schemas/tools/create_support_bundle.json +41 -0
  25. package/schemas/tools/delete_support_bundle.json +18 -0
  26. package/schemas/tools/export_support_bundle.json +19 -0
  27. package/schemas/tools/inspect_router_migration.json +7 -0
  28. package/schemas/tools/list_client_checks.json +7 -0
  29. package/schemas/tools/list_router_migrations.json +7 -0
  30. package/schemas/tools/list_support_bundles.json +7 -0
  31. package/schemas/tools/memory_get_scope.json +14 -0
  32. package/schemas/tools/memory_history.json +14 -0
  33. package/schemas/tools/memory_recall.json +35 -0
  34. package/schemas/tools/memory_remember.json +65 -0
  35. package/schemas/tools/memory_review.json +44 -0
  36. package/schemas/tools/memory_revise.json +61 -0
  37. package/schemas/tools/memory_set_scope.json +37 -0
  38. package/schemas/tools/preview_router_migration.json +62 -0
  39. package/schemas/tools/undo_router_migration.json +18 -0
  40. /package/dist/shared/{cli-gee7615j.js → cli-3zrj182m.js} +0 -0
@@ -1,9 +1,416 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "5.16.0",
3
+ "version": "5.18.0",
4
4
  "generated": "by scripts/gen-schemas.ts — do not edit by hand",
5
- "toolCount": 911,
5
+ "toolCount": 931,
6
6
  "tools": [
7
+ {
8
+ "name": "create_client_check",
9
+ "title": "Create a Client Network Check",
10
+ "risk": "write",
11
+ "annotations": {
12
+ "destructiveHint": false,
13
+ "openWorldHint": false
14
+ },
15
+ "description": "Create a 5–60 minute, six-run browser test invitation. Open returned clientPath on the affected phone/laptop via a reachable dashboard address; the fragment token grants test access only, never dashboard access. Explicit user start transfers at most 20 MiB per run to THIS MCP host. This is not internet throughput unless the host is on the remote path. Measures browser HTTP latency, loaded latency and transfers, not ICMP, DNS leakage, PMTU or app availability. Optional caseId links historical investigation evidence. No router changes.",
16
+ "inputSchema": {
17
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
18
+ "type": "object",
19
+ "properties": {
20
+ "label": {
21
+ "type": "string",
22
+ "minLength": 1,
23
+ "maxLength": 80
24
+ },
25
+ "caseId": {
26
+ "type": "string",
27
+ "format": "uuid",
28
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
29
+ },
30
+ "minutes": {
31
+ "default": 15,
32
+ "type": "integer",
33
+ "minimum": 5,
34
+ "maximum": 60
35
+ }
36
+ },
37
+ "required": ["label", "minutes"],
38
+ "additionalProperties": false
39
+ }
40
+ },
41
+ {
42
+ "name": "list_client_checks",
43
+ "title": "Read Client Network Checks",
44
+ "risk": "read",
45
+ "annotations": {
46
+ "readOnlyHint": true,
47
+ "idempotentHint": true,
48
+ "openWorldHint": false
49
+ },
50
+ "description": "Read browser-reported measurements saved for this router. Tokens are never returned. Observed peer IP belongs to this HTTP connection, not necessarily the user's public internet exit. Does not run tests or contact routers.",
51
+ "inputSchema": {
52
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
53
+ "type": "object",
54
+ "properties": {},
55
+ "additionalProperties": false
56
+ }
57
+ },
58
+ {
59
+ "name": "compare_client_checks",
60
+ "title": "Compare Two Client Test Runs",
61
+ "risk": "read",
62
+ "annotations": {
63
+ "readOnlyHint": true,
64
+ "idempotentHint": true,
65
+ "openWorldHint": false
66
+ },
67
+ "description": "Compare two complete browser test runs in one session, for example Wi-Fi vs WireGuard. Requires the same endpoint. Measurements are client-reported and sequential, not proof of a bottleneck or a fastest route.",
68
+ "inputSchema": {
69
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
70
+ "type": "object",
71
+ "properties": {
72
+ "id": {
73
+ "type": "string",
74
+ "format": "uuid",
75
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
76
+ },
77
+ "first": {
78
+ "type": "string",
79
+ "format": "uuid",
80
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
81
+ },
82
+ "second": {
83
+ "type": "string",
84
+ "format": "uuid",
85
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
86
+ }
87
+ },
88
+ "required": ["id", "first", "second"],
89
+ "additionalProperties": false
90
+ }
91
+ },
92
+ {
93
+ "name": "close_client_check",
94
+ "title": "Revoke a Client Check Invitation",
95
+ "risk": "write",
96
+ "annotations": {
97
+ "destructiveHint": false,
98
+ "openWorldHint": false
99
+ },
100
+ "description": "Immediately close the selected test invitation. Rejects further measurements while retaining saved history. No router configuration changes.",
101
+ "inputSchema": {
102
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
103
+ "type": "object",
104
+ "properties": {
105
+ "id": {
106
+ "type": "string",
107
+ "format": "uuid",
108
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
109
+ }
110
+ },
111
+ "required": ["id"],
112
+ "additionalProperties": false
113
+ }
114
+ },
115
+ {
116
+ "name": "inspect_router_migration",
117
+ "title": "Inspect Router Migration Capabilities",
118
+ "risk": "read",
119
+ "annotations": {
120
+ "readOnlyHint": true,
121
+ "idempotentHint": true,
122
+ "openWorldHint": false
123
+ },
124
+ "description": "Read router hardware, RouterOS version, installed packages and interfaces for a replacement migration. Does not expose the raw export or change configuration. Use a dedicated, unmapped management port on target.",
125
+ "inputSchema": {
126
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
127
+ "type": "object",
128
+ "properties": {},
129
+ "additionalProperties": false
130
+ }
131
+ },
132
+ {
133
+ "name": "preview_router_migration",
134
+ "title": "Preview a Router Replacement",
135
+ "risk": "write",
136
+ "annotations": {
137
+ "destructiveHint": false,
138
+ "openWorldHint": false
139
+ },
140
+ "description": "Read source and target, map physical Ethernet ports and persist a five-minute, device-bound staging plan. Select supported sections; incompatible fields, collisions and unresolved dependencies BLOCK staging. Lists ALL unselected/unsupported sections as manual work. Same RouterOS 7 version required. Never copies credentials, certificates, scripts, Wi-Fi drivers or VPN secrets, and never changes target management. Preview changes local state only.",
141
+ "inputSchema": {
142
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
143
+ "type": "object",
144
+ "properties": {
145
+ "source": {
146
+ "type": "string",
147
+ "minLength": 1,
148
+ "maxLength": 120
149
+ },
150
+ "target": {
151
+ "type": "string",
152
+ "minLength": 1,
153
+ "maxLength": 120
154
+ },
155
+ "managementInterface": {
156
+ "type": "string",
157
+ "minLength": 1,
158
+ "maxLength": 80
159
+ },
160
+ "mapping": {
161
+ "type": "object",
162
+ "propertyNames": {
163
+ "type": "string",
164
+ "minLength": 1,
165
+ "maxLength": 80
166
+ },
167
+ "additionalProperties": {
168
+ "type": "string",
169
+ "minLength": 1,
170
+ "maxLength": 80
171
+ }
172
+ },
173
+ "sections": {
174
+ "minItems": 1,
175
+ "maxItems": 15,
176
+ "type": "array",
177
+ "items": {
178
+ "type": "string",
179
+ "enum": [
180
+ "/interface/bridge",
181
+ "/interface/vlan",
182
+ "/interface/list",
183
+ "/interface/list/member",
184
+ "/interface/bridge/port",
185
+ "/ip/pool",
186
+ "/ip/address",
187
+ "/ip/dhcp-server/network",
188
+ "/ip/dhcp-server",
189
+ "/ip/dhcp-server/lease",
190
+ "/routing/table",
191
+ "/ip/route",
192
+ "/ip/firewall/address-list",
193
+ "/ip/firewall/filter",
194
+ "/ip/firewall/nat"
195
+ ]
196
+ }
197
+ }
198
+ },
199
+ "required": ["source", "target", "managementInterface", "mapping", "sections"],
200
+ "additionalProperties": false
201
+ }
202
+ },
203
+ {
204
+ "name": "list_router_migrations",
205
+ "title": "Read Router Migration Plans",
206
+ "risk": "read",
207
+ "annotations": {
208
+ "readOnlyHint": true,
209
+ "idempotentHint": true,
210
+ "openWorldHint": false
211
+ },
212
+ "description": "Read durable migration previews, backup references, rehearsal/staging outcomes and manual cutover items for the selected TARGET router.",
213
+ "inputSchema": {
214
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
215
+ "type": "object",
216
+ "properties": {},
217
+ "additionalProperties": false
218
+ }
219
+ },
220
+ {
221
+ "name": "apply_router_migration",
222
+ "title": "Rehearse or Stage an Approved Migration",
223
+ "risk": "write",
224
+ "annotations": {
225
+ "destructiveHint": false,
226
+ "openWorldHint": false
227
+ },
228
+ "description": "Only after user reviews the exact preview: back up source and target locally, reject stale state, acquire NEW Safe Mode, apply at most 60 additive objects and read each back. Default rehearse rolls back and verifies the original export; stage commits INACTIVE addresses, ports, DHCP, routes and firewall rules. Never resets a router or activates duplicate networks. Manual physical cutover, secrets and application verification remain required. No direct-write fallback; uncertain results must not be retried.",
229
+ "inputSchema": {
230
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
231
+ "type": "object",
232
+ "properties": {
233
+ "id": {
234
+ "type": "string",
235
+ "format": "uuid",
236
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
237
+ },
238
+ "mode": {
239
+ "default": "rehearse",
240
+ "type": "string",
241
+ "enum": ["rehearse", "stage"]
242
+ },
243
+ "confirm": {
244
+ "default": false,
245
+ "type": "boolean"
246
+ },
247
+ "acknowledgeManual": {
248
+ "default": false,
249
+ "type": "boolean"
250
+ }
251
+ },
252
+ "required": ["id", "mode", "confirm", "acknowledgeManual"],
253
+ "additionalProperties": false
254
+ }
255
+ },
256
+ {
257
+ "name": "undo_router_migration",
258
+ "title": "Remove Unchanged Staged Migration Objects",
259
+ "risk": "destructive",
260
+ "annotations": {
261
+ "destructiveHint": true,
262
+ "idempotentHint": true,
263
+ "openWorldHint": false
264
+ },
265
+ "description": "After explicit approval remove ONLY this plan's staged objects under Safe Mode, provided none was edited or activated. Verify target export matches pre-migration snapshot before commit. Refuses uncertain migrations; never wipes unrelated target configuration.",
266
+ "inputSchema": {
267
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
268
+ "type": "object",
269
+ "properties": {
270
+ "id": {
271
+ "type": "string",
272
+ "format": "uuid",
273
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
274
+ },
275
+ "confirm": {
276
+ "default": false,
277
+ "type": "boolean"
278
+ }
279
+ },
280
+ "required": ["id", "confirm"],
281
+ "additionalProperties": false
282
+ }
283
+ },
284
+ {
285
+ "name": "create_support_bundle",
286
+ "title": "Prepare a Minimised Support Report",
287
+ "risk": "write",
288
+ "annotations": {
289
+ "destructiveHint": false,
290
+ "openWorldHint": false
291
+ },
292
+ "description": "Build a local support package for at most seven days using selected investigations, event metadata, snapshot section counts and client-check summaries. No live router queries or uploads. Excludes raw logs/exports/tool bodies, secrets, comments and personal labels BEFORE persistence; aliases network identifiers consistently within this bundle. Missing evidence remains unknown. Review timestamps/counts/relationships before sharing: minimisation is not absolute anonymity.",
293
+ "inputSchema": {
294
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
295
+ "type": "object",
296
+ "properties": {
297
+ "since": {
298
+ "type": "integer",
299
+ "exclusiveMinimum": 0,
300
+ "maximum": 9007199254740991
301
+ },
302
+ "until": {
303
+ "type": "integer",
304
+ "exclusiveMinimum": 0,
305
+ "maximum": 9007199254740991
306
+ },
307
+ "cases": {
308
+ "default": [],
309
+ "maxItems": 10,
310
+ "type": "array",
311
+ "items": {
312
+ "type": "string",
313
+ "format": "uuid",
314
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
315
+ }
316
+ },
317
+ "includeEvents": {
318
+ "default": true,
319
+ "type": "boolean"
320
+ },
321
+ "includeSnapshots": {
322
+ "default": true,
323
+ "type": "boolean"
324
+ },
325
+ "includeChecks": {
326
+ "default": true,
327
+ "type": "boolean"
328
+ }
329
+ },
330
+ "required": [
331
+ "since",
332
+ "until",
333
+ "cases",
334
+ "includeEvents",
335
+ "includeSnapshots",
336
+ "includeChecks"
337
+ ],
338
+ "additionalProperties": false
339
+ }
340
+ },
341
+ {
342
+ "name": "list_support_bundles",
343
+ "title": "Read Local Support Reports",
344
+ "risk": "read",
345
+ "annotations": {
346
+ "readOnlyHint": true,
347
+ "idempotentHint": true,
348
+ "openWorldHint": false
349
+ },
350
+ "description": "Read minimised locally saved support reports for this router. Does not send reports to anyone.",
351
+ "inputSchema": {
352
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
353
+ "type": "object",
354
+ "properties": {},
355
+ "additionalProperties": false
356
+ }
357
+ },
358
+ {
359
+ "name": "export_support_bundle",
360
+ "title": "Export a Reviewed Support Report",
361
+ "risk": "read",
362
+ "annotations": {
363
+ "readOnlyHint": true,
364
+ "idempotentHint": true,
365
+ "openWorldHint": false
366
+ },
367
+ "description": "Return a saved, minimised support report as JSON or self-contained script-free HTML. No filesystem path or external destination is accepted. Review before sharing; no automatic upload.",
368
+ "inputSchema": {
369
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
370
+ "type": "object",
371
+ "properties": {
372
+ "id": {
373
+ "type": "string",
374
+ "format": "uuid",
375
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
376
+ },
377
+ "format": {
378
+ "default": "json",
379
+ "type": "string",
380
+ "enum": ["json", "html"]
381
+ }
382
+ },
383
+ "required": ["id", "format"],
384
+ "additionalProperties": false
385
+ }
386
+ },
387
+ {
388
+ "name": "delete_support_bundle",
389
+ "title": "Delete a Local Support Report",
390
+ "risk": "write",
391
+ "annotations": {
392
+ "destructiveHint": false,
393
+ "openWorldHint": false
394
+ },
395
+ "description": "Delete this saved minimised report only after explicit approval. Original investigations, snapshots and events are retained; exported copies cannot be revoked.",
396
+ "inputSchema": {
397
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
398
+ "type": "object",
399
+ "properties": {
400
+ "id": {
401
+ "type": "string",
402
+ "format": "uuid",
403
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
404
+ },
405
+ "confirm": {
406
+ "default": false,
407
+ "type": "boolean"
408
+ }
409
+ },
410
+ "required": ["id", "confirm"],
411
+ "additionalProperties": false
412
+ }
413
+ },
7
414
  {
8
415
  "name": "diagnose_home_internet",
9
416
  "title": "Why Is My Internet Slow?",
@@ -24438,7 +24845,7 @@
24438
24845
  "idempotentHint": true,
24439
24846
  "openWorldHint": false
24440
24847
  },
24441
- "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.",
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. 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.",
24442
24849
  "inputSchema": {
24443
24850
  "$schema": "https://json-schema.org/draft/2020-12/schema",
24444
24851
  "type": "object",
@@ -31849,6 +32256,351 @@
31849
32256
  "additionalProperties": false
31850
32257
  }
31851
32258
  },
32259
+ {
32260
+ "name": "memory_get_scope",
32261
+ "title": "Inspect Memory Sharing Scope",
32262
+ "risk": "read",
32263
+ "annotations": {
32264
+ "readOnlyHint": true,
32265
+ "idempotentHint": true,
32266
+ "openWorldHint": false
32267
+ },
32268
+ "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.",
32269
+ "inputSchema": {
32270
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32271
+ "type": "object",
32272
+ "properties": {
32273
+ "entityName": {
32274
+ "type": "string",
32275
+ "minLength": 1,
32276
+ "maxLength": 200
32277
+ }
32278
+ },
32279
+ "required": ["entityName"],
32280
+ "additionalProperties": false
32281
+ }
32282
+ },
32283
+ {
32284
+ "name": "memory_set_scope",
32285
+ "title": "Set Memory Sharing Scope",
32286
+ "risk": "write",
32287
+ "annotations": {
32288
+ "destructiveHint": false,
32289
+ "openWorldHint": false
32290
+ },
32291
+ "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.",
32292
+ "inputSchema": {
32293
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32294
+ "type": "object",
32295
+ "properties": {
32296
+ "entityName": {
32297
+ "type": "string",
32298
+ "minLength": 1,
32299
+ "maxLength": 200
32300
+ },
32301
+ "scope": {
32302
+ "type": "string",
32303
+ "enum": ["device", "group", "shared"]
32304
+ },
32305
+ "members": {
32306
+ "default": [],
32307
+ "maxItems": 100,
32308
+ "type": "array",
32309
+ "items": {
32310
+ "type": "string",
32311
+ "minLength": 1,
32312
+ "maxLength": 200
32313
+ }
32314
+ },
32315
+ "expectedRevision": {
32316
+ "type": "integer",
32317
+ "minimum": 0,
32318
+ "maximum": 9007199254740991
32319
+ },
32320
+ "confirmSharing": {
32321
+ "default": false,
32322
+ "type": "boolean"
32323
+ }
32324
+ },
32325
+ "required": ["entityName", "scope", "members", "expectedRevision", "confirmSharing"],
32326
+ "additionalProperties": false
32327
+ }
32328
+ },
32329
+ {
32330
+ "name": "memory_remember",
32331
+ "title": "Remember Network Knowledge",
32332
+ "risk": "write",
32333
+ "annotations": {
32334
+ "destructiveHint": false,
32335
+ "openWorldHint": false
32336
+ },
32337
+ "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.",
32338
+ "inputSchema": {
32339
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32340
+ "type": "object",
32341
+ "properties": {
32342
+ "entityName": {
32343
+ "type": "string",
32344
+ "minLength": 1,
32345
+ "maxLength": 200
32346
+ },
32347
+ "content": {
32348
+ "type": "string",
32349
+ "minLength": 1,
32350
+ "maxLength": 8000
32351
+ },
32352
+ "key": {
32353
+ "anyOf": [
32354
+ {
32355
+ "type": "string",
32356
+ "minLength": 1,
32357
+ "maxLength": 120
32358
+ },
32359
+ {
32360
+ "type": "null"
32361
+ }
32362
+ ]
32363
+ },
32364
+ "kind": {
32365
+ "default": "fact",
32366
+ "type": "string",
32367
+ "enum": ["fact", "constraint", "lesson", "preference", "procedure"]
32368
+ },
32369
+ "source": {
32370
+ "default": "unspecified",
32371
+ "type": "string",
32372
+ "minLength": 1,
32373
+ "maxLength": 500
32374
+ },
32375
+ "confidence": {
32376
+ "default": 0.5,
32377
+ "type": "number",
32378
+ "minimum": 0,
32379
+ "maximum": 1
32380
+ },
32381
+ "pinned": {
32382
+ "default": false,
32383
+ "type": "boolean"
32384
+ },
32385
+ "expiresAt": {
32386
+ "default": null,
32387
+ "anyOf": [
32388
+ {
32389
+ "type": "integer",
32390
+ "exclusiveMinimum": 0,
32391
+ "maximum": 9007199254740991
32392
+ },
32393
+ {
32394
+ "type": "null"
32395
+ }
32396
+ ]
32397
+ }
32398
+ },
32399
+ "required": [
32400
+ "entityName",
32401
+ "content",
32402
+ "kind",
32403
+ "source",
32404
+ "confidence",
32405
+ "pinned",
32406
+ "expiresAt"
32407
+ ],
32408
+ "additionalProperties": false
32409
+ }
32410
+ },
32411
+ {
32412
+ "name": "memory_recall",
32413
+ "title": "Recall Relevant Network Context",
32414
+ "risk": "read",
32415
+ "annotations": {
32416
+ "readOnlyHint": true,
32417
+ "idempotentHint": true,
32418
+ "openWorldHint": false
32419
+ },
32420
+ "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.",
32421
+ "inputSchema": {
32422
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32423
+ "type": "object",
32424
+ "properties": {
32425
+ "query": {
32426
+ "default": "",
32427
+ "type": "string",
32428
+ "maxLength": 500
32429
+ },
32430
+ "entityName": {
32431
+ "type": "string",
32432
+ "minLength": 1,
32433
+ "maxLength": 200
32434
+ },
32435
+ "limit": {
32436
+ "default": 12,
32437
+ "type": "integer",
32438
+ "minimum": 1,
32439
+ "maximum": 50
32440
+ },
32441
+ "maxChars": {
32442
+ "default": 6000,
32443
+ "type": "integer",
32444
+ "minimum": 500,
32445
+ "maximum": 16000
32446
+ },
32447
+ "includeRelated": {
32448
+ "default": true,
32449
+ "type": "boolean"
32450
+ }
32451
+ },
32452
+ "required": ["query", "limit", "maxChars", "includeRelated"],
32453
+ "additionalProperties": false
32454
+ }
32455
+ },
32456
+ {
32457
+ "name": "memory_review",
32458
+ "title": "Browse and Review Memories",
32459
+ "risk": "read",
32460
+ "annotations": {
32461
+ "readOnlyHint": true,
32462
+ "idempotentHint": true,
32463
+ "openWorldHint": false
32464
+ },
32465
+ "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.",
32466
+ "inputSchema": {
32467
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32468
+ "type": "object",
32469
+ "properties": {
32470
+ "query": {
32471
+ "default": "",
32472
+ "type": "string",
32473
+ "maxLength": 500
32474
+ },
32475
+ "entityName": {
32476
+ "type": "string",
32477
+ "minLength": 1,
32478
+ "maxLength": 200
32479
+ },
32480
+ "scope": {
32481
+ "type": "string",
32482
+ "enum": ["device", "group", "shared"]
32483
+ },
32484
+ "kind": {
32485
+ "type": "string",
32486
+ "enum": ["fact", "constraint", "lesson", "preference", "procedure"]
32487
+ },
32488
+ "state": {
32489
+ "default": "active",
32490
+ "type": "string",
32491
+ "enum": ["active", "review", "pinned", "archived", "all"]
32492
+ },
32493
+ "limit": {
32494
+ "default": 30,
32495
+ "type": "integer",
32496
+ "minimum": 1,
32497
+ "maximum": 100
32498
+ },
32499
+ "offset": {
32500
+ "default": 0,
32501
+ "type": "integer",
32502
+ "minimum": 0,
32503
+ "maximum": 1000000
32504
+ }
32505
+ },
32506
+ "required": ["query", "state", "limit", "offset"],
32507
+ "additionalProperties": false
32508
+ }
32509
+ },
32510
+ {
32511
+ "name": "memory_revise",
32512
+ "title": "Revise or Verify a Memory",
32513
+ "risk": "write",
32514
+ "annotations": {
32515
+ "destructiveHint": false,
32516
+ "openWorldHint": false
32517
+ },
32518
+ "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.",
32519
+ "inputSchema": {
32520
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32521
+ "type": "object",
32522
+ "properties": {
32523
+ "id": {
32524
+ "type": "integer",
32525
+ "exclusiveMinimum": 0,
32526
+ "maximum": 9007199254740991
32527
+ },
32528
+ "expectedRevision": {
32529
+ "type": "integer",
32530
+ "exclusiveMinimum": 0,
32531
+ "maximum": 9007199254740991
32532
+ },
32533
+ "content": {
32534
+ "type": "string",
32535
+ "minLength": 1,
32536
+ "maxLength": 8000
32537
+ },
32538
+ "kind": {
32539
+ "type": "string",
32540
+ "enum": ["fact", "constraint", "lesson", "preference", "procedure"]
32541
+ },
32542
+ "source": {
32543
+ "type": "string",
32544
+ "minLength": 1,
32545
+ "maxLength": 500
32546
+ },
32547
+ "confidence": {
32548
+ "type": "number",
32549
+ "minimum": 0,
32550
+ "maximum": 1
32551
+ },
32552
+ "pinned": {
32553
+ "type": "boolean"
32554
+ },
32555
+ "expiresAt": {
32556
+ "anyOf": [
32557
+ {
32558
+ "type": "integer",
32559
+ "exclusiveMinimum": 0,
32560
+ "maximum": 9007199254740991
32561
+ },
32562
+ {
32563
+ "type": "null"
32564
+ }
32565
+ ]
32566
+ },
32567
+ "status": {
32568
+ "type": "string",
32569
+ "enum": ["active", "archived"]
32570
+ },
32571
+ "verified": {
32572
+ "type": "boolean",
32573
+ "const": true
32574
+ }
32575
+ },
32576
+ "required": ["id", "expectedRevision"],
32577
+ "additionalProperties": false
32578
+ }
32579
+ },
32580
+ {
32581
+ "name": "memory_history",
32582
+ "title": "Memory Revision History",
32583
+ "risk": "read",
32584
+ "annotations": {
32585
+ "readOnlyHint": true,
32586
+ "idempotentHint": true,
32587
+ "openWorldHint": false
32588
+ },
32589
+ "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.",
32590
+ "inputSchema": {
32591
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
32592
+ "type": "object",
32593
+ "properties": {
32594
+ "id": {
32595
+ "type": "integer",
32596
+ "exclusiveMinimum": 0,
32597
+ "maximum": 9007199254740991
32598
+ }
32599
+ },
32600
+ "required": ["id"],
32601
+ "additionalProperties": false
32602
+ }
32603
+ },
31852
32604
  {
31853
32605
  "name": "memory_create_entities",
31854
32606
  "title": "Create Knowledge Graph Entities",