@robinmordasiewicz/f5xc-api-mcp 2.0.5-2601050335 → 2.0.13-2601051957

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 (82) hide show
  1. package/CHANGELOG.md +25 -14
  2. package/README.md +9 -5
  3. package/dist/generator/domain-metadata.d.ts +162 -3
  4. package/dist/generator/domain-metadata.d.ts.map +1 -1
  5. package/dist/generator/domain-metadata.js +263 -20
  6. package/dist/generator/domain-metadata.js.map +1 -1
  7. package/dist/generator/naming/acronyms.d.ts +9 -2
  8. package/dist/generator/naming/acronyms.d.ts.map +1 -1
  9. package/dist/generator/naming/acronyms.js +35 -129
  10. package/dist/generator/naming/acronyms.js.map +1 -1
  11. package/dist/generator/naming/index.d.ts +1 -1
  12. package/dist/generator/naming/index.d.ts.map +1 -1
  13. package/dist/generator/naming/index.js +1 -1
  14. package/dist/generator/naming/index.js.map +1 -1
  15. package/dist/prompts/error-resolution.d.ts +7 -24
  16. package/dist/prompts/error-resolution.d.ts.map +1 -1
  17. package/dist/prompts/error-resolution.js +94 -296
  18. package/dist/prompts/error-resolution.js.map +1 -1
  19. package/dist/prompts/index.d.ts +2 -2
  20. package/dist/prompts/index.d.ts.map +1 -1
  21. package/dist/prompts/index.js +3 -3
  22. package/dist/prompts/index.js.map +1 -1
  23. package/dist/prompts/workflows.d.ts +8 -16
  24. package/dist/prompts/workflows.d.ts.map +1 -1
  25. package/dist/prompts/workflows.js +100 -306
  26. package/dist/prompts/workflows.js.map +1 -1
  27. package/dist/server.d.ts.map +1 -1
  28. package/dist/server.js +9 -7
  29. package/dist/server.js.map +1 -1
  30. package/dist/tools/discovery/best-practices.d.ts +1 -0
  31. package/dist/tools/discovery/best-practices.d.ts.map +1 -1
  32. package/dist/tools/discovery/best-practices.js +135 -226
  33. package/dist/tools/discovery/best-practices.js.map +1 -1
  34. package/dist/tools/discovery/cost-estimator.d.ts.map +1 -1
  35. package/dist/tools/discovery/cost-estimator.js +16 -4
  36. package/dist/tools/discovery/cost-estimator.js.map +1 -1
  37. package/dist/tools/generated/dependency-graph.json +1 -1
  38. package/dist/version.d.ts +2 -2
  39. package/dist/version.d.ts.map +1 -1
  40. package/dist/version.js +2 -2
  41. package/dist/version.js.map +1 -1
  42. package/manifest.json +1 -1
  43. package/package.json +1 -1
  44. package/specs/domains/admin_console_and_ui.json +90 -26
  45. package/specs/domains/ai_services.json +149 -22
  46. package/specs/domains/api.json +598 -179
  47. package/specs/domains/authentication.json +198 -46
  48. package/specs/domains/bigip.json +326 -98
  49. package/specs/domains/billing_and_usage.json +289 -64
  50. package/specs/domains/blindfold.json +384 -110
  51. package/specs/domains/bot_and_threat_defense.json +256 -66
  52. package/specs/domains/cdn.json +477 -181
  53. package/specs/domains/ce_management.json +398 -118
  54. package/specs/domains/certificates.json +253 -78
  55. package/specs/domains/cloud_infrastructure.json +412 -115
  56. package/specs/domains/container_services.json +260 -95
  57. package/specs/domains/data_and_privacy_security.json +210 -68
  58. package/specs/domains/data_intelligence.json +225 -63
  59. package/specs/domains/ddos.json +690 -156
  60. package/specs/domains/dns.json +614 -149
  61. package/specs/domains/managed_kubernetes.json +317 -89
  62. package/specs/domains/marketplace.json +427 -104
  63. package/specs/domains/network.json +950 -231
  64. package/specs/domains/network_security.json +749 -188
  65. package/specs/domains/nginx_one.json +211 -63
  66. package/specs/domains/object_storage.json +126 -13
  67. package/specs/domains/observability.json +622 -103
  68. package/specs/domains/rate_limiting.json +208 -53
  69. package/specs/domains/secops_and_incident_response.json +122 -37
  70. package/specs/domains/service_mesh.json +484 -123
  71. package/specs/domains/shape.json +2359 -314
  72. package/specs/domains/sites.json +1572 -390
  73. package/specs/domains/statistics.json +892 -226
  74. package/specs/domains/support.json +544 -109
  75. package/specs/domains/telemetry_and_insights.json +312 -73
  76. package/specs/domains/tenant_and_identity.json +1881 -273
  77. package/specs/domains/threat_campaign.json +124 -67
  78. package/specs/domains/users.json +225 -72
  79. package/specs/domains/virtual.json +1157 -245
  80. package/specs/domains/vpm_and_node_management.json +59 -2
  81. package/specs/domains/waf.json +565 -140
  82. package/specs/index.json +1758 -5
@@ -3,7 +3,7 @@
3
3
  "info": {
4
4
  "title": "Ai Services",
5
5
  "description": "Query handling through inference routing with production and test modes. Positive and negative quality markers with detailed categorization capture assistant performance. Streaming connections support authenticated access, subscription lifecycles, and feature flags. IP provisioning services allocate infrastructure resources for model workloads across distributed systems.",
6
- "version": "2.0.5",
6
+ "version": "2.0.13",
7
7
  "contact": {
8
8
  "name": "F5 Distributed Cloud",
9
9
  "url": "https://docs.cloud.f5.com"
@@ -13,7 +13,57 @@
13
13
  "url": "https://www.f5.com/company/policies/eula"
14
14
  },
15
15
  "summary": "Natural language processing with quality signals and anomaly monitoring. Token authentication for data stream subscriptions.",
16
- "x-f5xc-cli-domain": "ai_services"
16
+ "x-f5xc-cli-domain": "ai_services",
17
+ "x-f5xc-best-practices": {
18
+ "common_errors": [
19
+ {
20
+ "code": 400,
21
+ "message": "Invalid request body",
22
+ "resolution": "Validate JSON structure and required fields before submission",
23
+ "prevention": "Use schema validation from OpenAPI spec"
24
+ },
25
+ {
26
+ "code": 401,
27
+ "message": "Authentication failed",
28
+ "resolution": "Verify API token is valid and not expired",
29
+ "prevention": "Use environment variables for token management"
30
+ },
31
+ {
32
+ "code": 403,
33
+ "message": "Permission denied",
34
+ "resolution": "Check user role and namespace permissions",
35
+ "prevention": "Verify RBAC policies before operations"
36
+ },
37
+ {
38
+ "code": 404,
39
+ "message": "Resource not found",
40
+ "resolution": "Verify resource name and namespace exist",
41
+ "prevention": "List resources before attempting operations"
42
+ },
43
+ {
44
+ "code": 409,
45
+ "message": "Resource already exists",
46
+ "resolution": "Use unique name or delete existing resource",
47
+ "prevention": "Check existence before creation"
48
+ },
49
+ {
50
+ "code": 429,
51
+ "message": "Rate limit exceeded",
52
+ "resolution": "Implement exponential backoff and retry logic",
53
+ "prevention": "Batch operations and add delays between requests"
54
+ }
55
+ ],
56
+ "security_notes": [
57
+ "Always use HTTPS for all API communications",
58
+ "Store API tokens securely, never in source code",
59
+ "Rotate API tokens regularly following security policies"
60
+ ],
61
+ "performance_tips": [
62
+ "Use pagination for large result sets",
63
+ "Batch related operations when possible",
64
+ "Cache read-only responses appropriately"
65
+ ]
66
+ }
17
67
  },
18
68
  "servers": [
19
69
  {
@@ -273,6 +323,13 @@
273
323
  "latency": "low",
274
324
  "resource_usage": "low"
275
325
  }
326
+ },
327
+ "x-f5xc-discovered-response-time": {
328
+ "p50_ms": 1000,
329
+ "p95_ms": 3000,
330
+ "p99_ms": 8000,
331
+ "sample_count": 0,
332
+ "source": "estimate"
276
333
  }
277
334
  },
278
335
  "x-displayname": "AI Assistant APIs.",
@@ -480,6 +537,13 @@
480
537
  "latency": "low",
481
538
  "resource_usage": "low"
482
539
  }
540
+ },
541
+ "x-f5xc-discovered-response-time": {
542
+ "p50_ms": 1000,
543
+ "p95_ms": 3000,
544
+ "p99_ms": 8000,
545
+ "sample_count": 0,
546
+ "source": "estimate"
483
547
  }
484
548
  },
485
549
  "x-displayname": "AI Assistant APIs.",
@@ -687,6 +751,13 @@
687
751
  "latency": "low",
688
752
  "resource_usage": "low"
689
753
  }
754
+ },
755
+ "x-f5xc-discovered-response-time": {
756
+ "p50_ms": 1000,
757
+ "p95_ms": 3000,
758
+ "p99_ms": 8000,
759
+ "sample_count": 0,
760
+ "source": "estimate"
690
761
  }
691
762
  },
692
763
  "x-displayname": "AI Assistant APIs.",
@@ -894,6 +965,13 @@
894
965
  "latency": "low",
895
966
  "resource_usage": "low"
896
967
  }
968
+ },
969
+ "x-f5xc-discovered-response-time": {
970
+ "p50_ms": 1000,
971
+ "p95_ms": 3000,
972
+ "p99_ms": 8000,
973
+ "sample_count": 0,
974
+ "source": "estimate"
897
975
  }
898
976
  },
899
977
  "x-displayname": "AI Assistant APIs.",
@@ -1094,6 +1172,13 @@
1094
1172
  "latency": "low",
1095
1173
  "resource_usage": "low"
1096
1174
  }
1175
+ },
1176
+ "x-f5xc-discovered-response-time": {
1177
+ "p50_ms": 1000,
1178
+ "p95_ms": 3000,
1179
+ "p99_ms": 8000,
1180
+ "sample_count": 0,
1181
+ "source": "estimate"
1097
1182
  }
1098
1183
  },
1099
1184
  "x-displayname": "BFDP APIs",
@@ -1293,6 +1378,13 @@
1293
1378
  "latency": "low",
1294
1379
  "resource_usage": "low"
1295
1380
  }
1381
+ },
1382
+ "x-f5xc-discovered-response-time": {
1383
+ "p50_ms": 1000,
1384
+ "p95_ms": 3000,
1385
+ "p99_ms": 8000,
1386
+ "sample_count": 0,
1387
+ "source": "estimate"
1296
1388
  }
1297
1389
  },
1298
1390
  "x-displayname": "BFDP APIs",
@@ -1492,6 +1584,13 @@
1492
1584
  "latency": "low",
1493
1585
  "resource_usage": "low"
1494
1586
  }
1587
+ },
1588
+ "x-f5xc-discovered-response-time": {
1589
+ "p50_ms": 1000,
1590
+ "p95_ms": 3000,
1591
+ "p99_ms": 8000,
1592
+ "sample_count": 0,
1593
+ "source": "estimate"
1495
1594
  }
1496
1595
  },
1497
1596
  "x-displayname": "BFDP Subscription API.",
@@ -1691,6 +1790,13 @@
1691
1790
  "latency": "low",
1692
1791
  "resource_usage": "low"
1693
1792
  }
1793
+ },
1794
+ "x-f5xc-discovered-response-time": {
1795
+ "p50_ms": 1000,
1796
+ "p95_ms": 3000,
1797
+ "p99_ms": 8000,
1798
+ "sample_count": 0,
1799
+ "source": "estimate"
1694
1800
  }
1695
1801
  },
1696
1802
  "x-displayname": "BFDP Subscription API.",
@@ -1890,6 +1996,13 @@
1890
1996
  "latency": "low",
1891
1997
  "resource_usage": "low"
1892
1998
  }
1999
+ },
2000
+ "x-f5xc-discovered-response-time": {
2001
+ "p50_ms": 1000,
2002
+ "p95_ms": 3000,
2003
+ "p99_ms": 8000,
2004
+ "sample_count": 0,
2005
+ "source": "estimate"
1893
2006
  }
1894
2007
  },
1895
2008
  "x-displayname": "BFDP Subscription API.",
@@ -2087,6 +2200,13 @@
2087
2200
  "latency": "low",
2088
2201
  "resource_usage": "low"
2089
2202
  }
2203
+ },
2204
+ "x-f5xc-discovered-response-time": {
2205
+ "p50_ms": 1000,
2206
+ "p95_ms": 3000,
2207
+ "p99_ms": 8000,
2208
+ "sample_count": 0,
2209
+ "source": "estimate"
2090
2210
  }
2091
2211
  },
2092
2212
  "x-displayname": "Global IP Allocator.",
@@ -2277,6 +2397,13 @@
2277
2397
  "latency": "low",
2278
2398
  "resource_usage": "low"
2279
2399
  }
2400
+ },
2401
+ "x-f5xc-discovered-response-time": {
2402
+ "p50_ms": 500,
2403
+ "p95_ms": 1500,
2404
+ "p99_ms": 4000,
2405
+ "sample_count": 0,
2406
+ "source": "estimate"
2280
2407
  }
2281
2408
  },
2282
2409
  "x-displayname": "Global IP Allocator.",
@@ -2341,7 +2468,7 @@
2341
2468
  },
2342
2469
  "x-original-maxLength": 1024,
2343
2470
  "x-reconciled-from-discovery": true,
2344
- "x-reconciled-at": "2026-01-05T03:03:05.817762+00:00"
2471
+ "x-reconciled-at": "2026-01-05T18:28:36.407523+00:00"
2345
2472
  },
2346
2473
  "negative_feedback": {
2347
2474
  "$ref": "#/components/schemas/ai_assistantNegativeFeedbackDetails"
@@ -2446,7 +2573,7 @@
2446
2573
  },
2447
2574
  "x-original-maxLength": 1024,
2448
2575
  "x-reconciled-from-discovery": true,
2449
- "x-reconciled-at": "2026-01-05T03:03:05.817781+00:00"
2576
+ "x-reconciled-at": "2026-01-05T18:28:36.407544+00:00"
2450
2577
  }
2451
2578
  },
2452
2579
  "x-f5xc-minimum-configuration": {
@@ -2787,7 +2914,7 @@
2787
2914
  },
2788
2915
  "x-original-maxLength": 1024,
2789
2916
  "x-reconciled-from-discovery": true,
2790
- "x-reconciled-at": "2026-01-05T03:03:05.817803+00:00"
2917
+ "x-reconciled-at": "2026-01-05T18:28:36.407570+00:00"
2791
2918
  },
2792
2919
  "log_filters": {
2793
2920
  "type": "array",
@@ -2821,7 +2948,7 @@
2821
2948
  },
2822
2949
  "x-original-maxLength": 1024,
2823
2950
  "x-reconciled-from-discovery": true,
2824
- "x-reconciled-at": "2026-01-05T03:03:05.817809+00:00"
2951
+ "x-reconciled-at": "2026-01-05T18:28:36.407576+00:00"
2825
2952
  },
2826
2953
  "object_name": {
2827
2954
  "type": "string",
@@ -2872,7 +2999,7 @@
2872
2999
  },
2873
3000
  "x-original-maxLength": 1024,
2874
3001
  "x-reconciled-from-discovery": true,
2875
- "x-reconciled-at": "2026-01-05T03:03:05.817815+00:00"
3002
+ "x-reconciled-at": "2026-01-05T18:28:36.407585+00:00"
2876
3003
  },
2877
3004
  "type": {
2878
3005
  "$ref": "#/components/schemas/commonDashboardLinkType"
@@ -3030,7 +3157,7 @@
3030
3157
  },
3031
3158
  "x-original-maxLength": 1024,
3032
3159
  "x-reconciled-from-discovery": true,
3033
- "x-reconciled-at": "2026-01-05T03:03:05.817826+00:00"
3160
+ "x-reconciled-at": "2026-01-05T18:28:36.407599+00:00"
3034
3161
  },
3035
3162
  "title": {
3036
3163
  "type": "string",
@@ -3049,7 +3176,7 @@
3049
3176
  },
3050
3177
  "x-original-maxLength": 1024,
3051
3178
  "x-reconciled-from-discovery": true,
3052
- "x-reconciled-at": "2026-01-05T03:03:05.817830+00:00"
3179
+ "x-reconciled-at": "2026-01-05T18:28:36.407604+00:00"
3053
3180
  },
3054
3181
  "tooltip": {
3055
3182
  "type": "string",
@@ -3162,7 +3289,7 @@
3162
3289
  },
3163
3290
  "x-original-maxLength": 1024,
3164
3291
  "x-reconciled-from-discovery": true,
3165
- "x-reconciled-at": "2026-01-05T03:03:05.817837+00:00"
3292
+ "x-reconciled-at": "2026-01-05T18:28:36.407612+00:00"
3166
3293
  },
3167
3294
  "title": {
3168
3295
  "type": "string",
@@ -3181,7 +3308,7 @@
3181
3308
  },
3182
3309
  "x-original-maxLength": 1024,
3183
3310
  "x-reconciled-from-discovery": true,
3184
- "x-reconciled-at": "2026-01-05T03:03:05.817841+00:00"
3311
+ "x-reconciled-at": "2026-01-05T18:28:36.407617+00:00"
3185
3312
  },
3186
3313
  "url": {
3187
3314
  "type": "string",
@@ -3323,7 +3450,7 @@
3323
3450
  },
3324
3451
  "x-original-maxLength": 1024,
3325
3452
  "x-reconciled-from-discovery": true,
3326
- "x-reconciled-at": "2026-01-05T03:03:05.817853+00:00"
3453
+ "x-reconciled-at": "2026-01-05T18:28:36.407632+00:00"
3327
3454
  },
3328
3455
  "op": {
3329
3456
  "$ref": "#/components/schemas/commonFilterOperator"
@@ -3393,7 +3520,7 @@
3393
3520
  },
3394
3521
  "x-original-maxLength": 1024,
3395
3522
  "x-reconciled-from-discovery": true,
3396
- "x-reconciled-at": "2026-01-05T03:03:05.817860+00:00"
3523
+ "x-reconciled-at": "2026-01-05T18:28:36.407641+00:00"
3397
3524
  },
3398
3525
  "type": {
3399
3526
  "$ref": "#/components/schemas/commonDashboardLinkType"
@@ -3648,7 +3775,7 @@
3648
3775
  },
3649
3776
  "x-original-maxLength": 1024,
3650
3777
  "x-reconciled-from-discovery": true,
3651
- "x-reconciled-at": "2026-01-05T03:03:05.817876+00:00"
3778
+ "x-reconciled-at": "2026-01-05T18:28:36.407659+00:00"
3652
3779
  },
3653
3780
  "type": {
3654
3781
  "type": "string",
@@ -3928,7 +4055,7 @@
3928
4055
  "x-original-maxLength": 1024,
3929
4056
  "format": "hostname",
3930
4057
  "x-reconciled-from-discovery": true,
3931
- "x-reconciled-at": "2026-01-05T03:03:05.817898+00:00"
4058
+ "x-reconciled-at": "2026-01-05T18:28:36.407684+00:00"
3932
4059
  },
3933
4060
  "rsp_code": {
3934
4061
  "type": "integer",
@@ -4088,7 +4215,7 @@
4088
4215
  },
4089
4216
  "x-original-maxLength": 1024,
4090
4217
  "x-reconciled-from-discovery": true,
4091
- "x-reconciled-at": "2026-01-05T03:03:05.817913+00:00"
4218
+ "x-reconciled-at": "2026-01-05T18:28:36.407701+00:00"
4092
4219
  },
4093
4220
  "state": {
4094
4221
  "type": "string",
@@ -4283,7 +4410,7 @@
4283
4410
  },
4284
4411
  "x-original-maxLength": 1024,
4285
4412
  "x-reconciled-from-discovery": true,
4286
- "x-reconciled-at": "2026-01-05T03:03:05.817929+00:00"
4413
+ "x-reconciled-at": "2026-01-05T18:28:36.407719+00:00"
4287
4414
  }
4288
4415
  },
4289
4416
  "x-f5xc-minimum-configuration": {
@@ -4372,7 +4499,7 @@
4372
4499
  },
4373
4500
  "x-original-maxLength": 1024,
4374
4501
  "x-reconciled-from-discovery": true,
4375
- "x-reconciled-at": "2026-01-05T03:03:05.817937+00:00"
4502
+ "x-reconciled-at": "2026-01-05T18:28:36.407728+00:00"
4376
4503
  },
4377
4504
  "state": {
4378
4505
  "type": "string",
@@ -4615,7 +4742,7 @@
4615
4742
  "maxLength": 26,
4616
4743
  "minLength": 15,
4617
4744
  "x-reconciled-from-discovery": true,
4618
- "x-reconciled-at": "2026-01-05T03:03:05.817957+00:00"
4745
+ "x-reconciled-at": "2026-01-05T18:28:36.407751+00:00"
4619
4746
  },
4620
4747
  "title": {
4621
4748
  "type": "string",
@@ -4634,7 +4761,7 @@
4634
4761
  },
4635
4762
  "x-original-maxLength": 1024,
4636
4763
  "x-reconciled-from-discovery": true,
4637
- "x-reconciled-at": "2026-01-05T03:03:05.817961+00:00"
4764
+ "x-reconciled-at": "2026-01-05T18:28:36.407755+00:00"
4638
4765
  }
4639
4766
  },
4640
4767
  "x-f5xc-minimum-configuration": {
@@ -4787,7 +4914,7 @@
4787
4914
  },
4788
4915
  "x-original-maxLength": 1024,
4789
4916
  "x-reconciled-from-discovery": true,
4790
- "x-reconciled-at": "2026-01-05T03:03:05.817971+00:00"
4917
+ "x-reconciled-at": "2026-01-05T18:28:36.407766+00:00"
4791
4918
  }
4792
4919
  },
4793
4920
  "x-f5xc-minimum-configuration": {
@@ -5010,7 +5137,7 @@
5010
5137
  },
5011
5138
  "x-original-maxLength": 1024,
5012
5139
  "x-reconciled-from-discovery": true,
5013
- "x-reconciled-at": "2026-01-05T03:03:05.817996+00:00"
5140
+ "x-reconciled-at": "2026-01-05T18:28:36.407785+00:00"
5014
5141
  }
5015
5142
  },
5016
5143
  "x-f5xc-minimum-configuration": {