netconverter-cli 0.5.0__tar.gz → 0.7.0__tar.gz

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 (127) hide show
  1. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/CHANGELOG.md +29 -0
  2. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/PKG-INFO +13 -4
  3. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/README.md +12 -3
  4. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/COMMANDS.md +45 -8
  5. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/README.md +2 -2
  6. netconverter_cli-0.7.0/docs/connect/chatgpt.md +63 -0
  7. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/pyproject.toml +1 -1
  8. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/__init__.py +1 -1
  9. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/catalog.py +2 -1
  10. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/cli.py +13 -2
  11. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/connect.py +6 -1
  12. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/drafts.py +16 -8
  13. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/job_options.py +1 -1
  14. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/mcp_client_features.py +25 -4
  15. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/mcp_server.py +187 -40
  16. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/mcp_workflows.py +2 -2
  17. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_drafts.py +28 -1
  18. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_guided_mapping_012.py +3 -1
  19. netconverter_cli-0.7.0/tests/test_guided_prescan_037.py +316 -0
  20. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_mcp.py +7 -2
  21. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_mcp_features_020.py +16 -3
  22. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_mcp_workflows.py +1 -1
  23. netconverter_cli-0.5.0/docs/connect/chatgpt.md +0 -22
  24. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/.gitignore +0 -0
  25. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/LICENSE +0 -0
  26. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/QUICK_START.md +0 -0
  27. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/SECURITY.md +0 -0
  28. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/PRIVACY.md +0 -0
  29. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/RELEASING.md +0 -0
  30. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/VERIFICATION.md +0 -0
  31. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/claude-ai.md +0 -0
  32. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/claude-code.md +0 -0
  33. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/claude-desktop.md +0 -0
  34. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/compatibility.md +0 -0
  35. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/getting-access.md +0 -0
  36. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/openclaw.md +0 -0
  37. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/connect/other-assistants.md +0 -0
  38. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/docs/guided-workflows.md +0 -0
  39. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/examples/README.md +0 -0
  40. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/activity.py +0 -0
  41. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/api.py +0 -0
  42. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/backend.py +0 -0
  43. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/branding.py +0 -0
  44. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/clerk.py +0 -0
  45. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/commands.py +0 -0
  46. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/connect_openclaw.py +0 -0
  47. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/controller.py +0 -0
  48. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/credential_file.py +0 -0
  49. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/credentials.py +0 -0
  50. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/design_catalog.py +0 -0
  51. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/draft_cli.py +0 -0
  52. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/draft_io.py +0 -0
  53. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/errors.py +0 -0
  54. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/exposure.py +0 -0
  55. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/guided.py +0 -0
  56. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/guided_operations.json +0 -0
  57. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/guided_projects.json +0 -0
  58. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/license.py +0 -0
  59. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/one_shot.py +0 -0
  60. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/palette.py +0 -0
  61. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/presentation.py +0 -0
  62. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/privacy.py +0 -0
  63. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/privacy_apply.py +0 -0
  64. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/privacy_cli.py +0 -0
  65. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/project_cli.py +0 -0
  66. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/projects.py +0 -0
  67. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/providers.py +0 -0
  68. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/remote_mcp.py +0 -0
  69. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/setup.py +0 -0
  70. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/summary.py +0 -0
  71. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/tui.py +0 -0
  72. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/update.py +0 -0
  73. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/walkthrough.py +0 -0
  74. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/windows_draft_io.py +0 -0
  75. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/src/netconverter_cli/workspace.py +0 -0
  76. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/conftest.py +0 -0
  77. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/fixtures/jobs/opt_4056e02e5b66.json +0 -0
  78. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/fixtures/jobs/tra_4058ef406cd6.json +0 -0
  79. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/fixtures/jobs/tra_running.json +0 -0
  80. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/fixtures/jobs/val_9f9acb9b5a59.json +0 -0
  81. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/fixtures/jobs/val_9f9acb9b5a59.sarif +0 -0
  82. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_autodetect_v5.py +0 -0
  83. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_boundaries.py +0 -0
  84. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_bridge_polish_021.py +0 -0
  85. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_clerk.py +0 -0
  86. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_clerk_host_binding.py +0 -0
  87. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_cli_020.py +0 -0
  88. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_connect_030.py +0 -0
  89. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_connect_031.py +0 -0
  90. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_connect_compat_014.py +0 -0
  91. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_connect_direct_entry.py +0 -0
  92. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_connect_openclaw_014.py +0 -0
  93. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_credential_file_010.py +0 -0
  94. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_download_analysis.py +0 -0
  95. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_draft_cli.py +0 -0
  96. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_draft_io.py +0 -0
  97. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_draft_jobs.py +0 -0
  98. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_errors_009.py +0 -0
  99. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_exposure_levels_013.py +0 -0
  100. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_folders_cd_ls.py +0 -0
  101. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_guided_full_api_019.py +0 -0
  102. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_help_008.py +0 -0
  103. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_inline.py +0 -0
  104. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_keyring_bus_017.py +0 -0
  105. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_keyring_timeout_010.py +0 -0
  106. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_license.py +0 -0
  107. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_mcp_auth_016.py +0 -0
  108. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_mcp_jobs.py +0 -0
  109. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_options_011_019.py +0 -0
  110. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_polish_028.py +0 -0
  111. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_presentation.py +0 -0
  112. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_privacy_apply_013.py +0 -0
  113. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_privacy_cli_013.py +0 -0
  114. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_projects.py +0 -0
  115. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_protocols.py +0 -0
  116. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_readonly_workspace.py +0 -0
  117. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_sessions.py +0 -0
  118. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_setup.py +0 -0
  119. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_signin_default.py +0 -0
  120. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_stage_029.py +0 -0
  121. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_strict_default_011.py +0 -0
  122. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_strict_view_015.py +0 -0
  123. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_summary_007.py +0 -0
  124. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_update.py +0 -0
  125. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_vendor_error_022.py +0 -0
  126. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_walkthrough.py +0 -0
  127. {netconverter_cli-0.5.0 → netconverter_cli-0.7.0}/tests/test_windows_draft_io.py +0 -0
@@ -1,5 +1,34 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.7.0 — 2026-11-02
4
+
5
+ - New: guided migration from your AI assistant (devnexthop/aws-netconverter.ai#1090).
6
+ `submit_file(..., job_type="prescan")` uploads the file and stops at a `psc_` prescan
7
+ (`target_vendor` optional); the result names the next steps. The bridge now proxies
8
+ `list_operations`, `get_decision_document`, `validate_decision_document`,
9
+ `propose_operations` and `submit_conversion` (the one remote `submit_*` it allows: a prescan
10
+ id and a revision, no configuration text). They need exposure level `full`; the two write
11
+ tools appear only where the server enables them for the tenant, and the server gates and
12
+ audits each call. `submit_conversion` asks for confirmation like an upload. Also proxied at
13
+ `full`: `set_view_level` (it can only lower the server's view for the session).
14
+ - New: `account` reports `guided_migration` (the guided tools this session lists, or the fix
15
+ when the level hides them), and the remote `get_account` carries the same note below `full`.
16
+ - Fix (#37): assistants that advertise forms but decline without showing them (ChatGPT, Claude
17
+ Code) no longer block every upload. A decline within 1.5 s returns `confirmation_required`
18
+ with a single-use `confirm_token` for that exact call: the assistant asks you in the
19
+ conversation and retries with it; no more forms are sent in that session. Declines now carry
20
+ `reason` (`user_declined`, `form_dismissed`, `client_declined_form`). New
21
+ `netconverter mcp --no-upload-confirm` / `NETCONVERTER_MCP_UPLOAD_CONFIRM=0` turns the forms
22
+ off and relies on the assistant's own tool approval.
23
+
24
+ ## 0.6.0 — 2026-10-30
25
+
26
+ - Guided drafts retain the server-advertised ASA target format (Palo Alto SET,
27
+ standalone XML, or Panorama). Preparation refuses targets absent from the
28
+ credential's current capabilities before reading a source file, and rejects a
29
+ response that substitutes another target. Server rollout qualification still
30
+ controls availability.
31
+
3
32
  ## 0.5.0 — 2026-10-29
4
33
 
5
34
  **Upgrade note.** Each folder now has an exposure level for AI assistants, default
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: netconverter-cli
3
- Version: 0.5.0
3
+ Version: 0.7.0
4
4
  Summary: NetConverter CLI — any-vendor network configuration migration, validation and optimization, and a local MCP bridge for your AI assistant
5
5
  Project-URL: Homepage, https://netconverter.ai
6
6
  Project-URL: Repository, https://github.com/valeronlabs/netconverter_terminals
@@ -42,7 +42,7 @@ Description-Content-Type: text/markdown
42
42
  NetConverter — by ValeronLabs LLC.
43
43
 
44
44
  ```text
45
- ◆ NetConverter v0.5.0 ● Server ◆ Bridge claude-code · 2m ago
45
+ ◆ NetConverter v0.7.0 ● Server ◆ Bridge claude-code · 2m ago
46
46
  ▍ Start
47
47
  ▍ /convert Migrate a configuration to another vendor
48
48
  ▍ /validate Check a configuration before migrating
@@ -142,9 +142,18 @@ works on your configurations only through the bridge.
142
142
  Then ask your assistant, for example: *"Validate edge-fw.conf and tell me what it finds,"*
143
143
  *"Convert it to Palo Alto XML,"* *"Can WEB reach DB on tcp/1433?"*
144
144
 
145
+ **Guided migration:** *"Prescan edge-fw.conf for Palo Alto XML and walk me through the decisions."*
146
+ `submit_file(..., job_type="prescan")` stops at a `psc_` prescan; the assistant reads the decisions
147
+ (`list_operations`, `get_decision_document`, `validate_decision_document`), records your choices
148
+ (`propose_operations`) and, with your OK, queues the conversion (`submit_conversion`). These tools
149
+ need the folder at `netconverter privacy level full`; the two write tools also need them enabled
150
+ for your tenant (docs/COMMANDS.md § Guided migration). If your assistant declines the upload
151
+ confirmation without showing it (ChatGPT, Claude Code), approve in the conversation or run the
152
+ bridge with `--no-upload-confirm`.
153
+
145
154
  Bridge tools: `submit_file`, `job_status`, `wait_for_job`, `account`, `download`,
146
- plus an allowlist of NetConverter's read-only tools (reports, evidence, NAT, flows,
147
- knowledge base). What the assistant sees is this folder's **exposure level**
155
+ plus an allowlist of NetConverter's tools (reports, evidence, NAT, flows, knowledge base,
156
+ guided mapping and guided migration). What the assistant sees is this folder's **exposure level**
148
157
  (`netconverter privacy level none|masked|selected|full`, default **masked**: the strict view,
149
158
  names as tokens, addresses masked, no configuration content); secrets are removed at every
150
159
  level, and raising the level needs a confirmation typed in a terminal (docs/PRIVACY.md).
@@ -7,7 +7,7 @@
7
7
  NetConverter — by ValeronLabs LLC.
8
8
 
9
9
  ```text
10
- ◆ NetConverter v0.5.0 ● Server ◆ Bridge claude-code · 2m ago
10
+ ◆ NetConverter v0.7.0 ● Server ◆ Bridge claude-code · 2m ago
11
11
  ▍ Start
12
12
  ▍ /convert Migrate a configuration to another vendor
13
13
  ▍ /validate Check a configuration before migrating
@@ -107,9 +107,18 @@ works on your configurations only through the bridge.
107
107
  Then ask your assistant, for example: *"Validate edge-fw.conf and tell me what it finds,"*
108
108
  *"Convert it to Palo Alto XML,"* *"Can WEB reach DB on tcp/1433?"*
109
109
 
110
+ **Guided migration:** *"Prescan edge-fw.conf for Palo Alto XML and walk me through the decisions."*
111
+ `submit_file(..., job_type="prescan")` stops at a `psc_` prescan; the assistant reads the decisions
112
+ (`list_operations`, `get_decision_document`, `validate_decision_document`), records your choices
113
+ (`propose_operations`) and, with your OK, queues the conversion (`submit_conversion`). These tools
114
+ need the folder at `netconverter privacy level full`; the two write tools also need them enabled
115
+ for your tenant (docs/COMMANDS.md § Guided migration). If your assistant declines the upload
116
+ confirmation without showing it (ChatGPT, Claude Code), approve in the conversation or run the
117
+ bridge with `--no-upload-confirm`.
118
+
110
119
  Bridge tools: `submit_file`, `job_status`, `wait_for_job`, `account`, `download`,
111
- plus an allowlist of NetConverter's read-only tools (reports, evidence, NAT, flows,
112
- knowledge base). What the assistant sees is this folder's **exposure level**
120
+ plus an allowlist of NetConverter's tools (reports, evidence, NAT, flows, knowledge base,
121
+ guided mapping and guided migration). What the assistant sees is this folder's **exposure level**
113
122
  (`netconverter privacy level none|masked|selected|full`, default **masked**: the strict view,
114
123
  names as tokens, addresses masked, no configuration content); secrets are removed at every
115
124
  level, and raising the level needs a confirmation typed in a terminal (docs/PRIVACY.md).
@@ -132,6 +132,7 @@ netconverter connect --all # every assistant found on this compute
132
132
  netconverter connect chatgpt # ChatGPT / claude.ai: prints remote-connector setup steps
133
133
  netconverter mcp --workspace ~/migrations # what an assistant runs; not for interactive use
134
134
  netconverter mcp --level none --workspace ~/migrations # lower this folder's level for one bridge
135
+ netconverter mcp --no-upload-confirm --workspace ~/migrations # no confirmation forms (ChatGPT, Claude Code)
135
136
  netconverter privacy status # this folder's exposure level, what each level shows, recent changes
136
137
  netconverter privacy level none # verdicts and counts only (lowering needs no confirmation)
137
138
  netconverter privacy level full # raising asks you to type "raise to full" in a terminal
@@ -212,38 +213,71 @@ delays a command; its result is cached in your user cache folder.
212
213
 
213
214
  | Tool | Returns |
214
215
  | --- | --- |
215
- | `submit_file(path, source_vendor, target_vendor?, job_type?, options?)` | `job_id`, `status`, `sha256`, `bytes`. `job_type`: `convert`, `validate`, `optimize`, or `analyze` (= validate). `options` keys (typed; anything else is refused naming it): `selected_device_groups`, `file_name`, `optimization_options` (optimize), and for convert `zone_mapping`, `remove_unused_objects`, `enable_appid`, `app_id_implementation`, `add_security_profiles`, `log_all_rules`, `implicit_deny`, `panos_target_version` / `routing_engine` / `default_profile_group` (Palo Alto targets), `panorama_device_group` / `panorama_template` (Panorama), `pipeline_mode` (pilot keys). On the full API the convert settings travel as a `yaml_v2` decisions document |
216
+ | `submit_file(path, source_vendor, target_vendor?, job_type?, options?, confirm_token?)` | `job_id`, `status`, `sha256`, `bytes`. `job_type`: `convert`, `validate`, `optimize`, `prescan`, or `analyze` (= validate). `prescan` starts a guided migration: the job stops at a `psc_` prescan for your decisions (`target_vendor` optional; only `file_name` as an option) and the result adds `job_type`, `next_steps` and `guided_tools` (see Guided migration below). `confirm_token` only after a `confirmation_required` error. `options` keys (typed; anything else is refused naming it): `selected_device_groups`, `file_name`, `optimization_options` (optimize), and for convert `zone_mapping`, `remove_unused_objects`, `enable_appid`, `app_id_implementation`, `add_security_profiles`, `log_all_rules`, `implicit_deny`, `panos_target_version` / `routing_engine` / `default_profile_group` (Palo Alto targets), `panorama_device_group` / `panorama_template` (Panorama), `pipeline_mode` (pilot keys). On the full API the convert settings travel as a `yaml_v2` decisions document |
216
217
  | `job_status(job_id)` | Status, verdict, review flag, progress and stage when sent, reason counts, vendors |
217
218
  | `wait_for_job(job_id, timeout_s=45)` | The `job_status` summary plus `waited_s` and `timed_out` (plus `next` when still running: call it again); polls 2 s, ×1.5, up to 15 s apart, at most 600 s. The default stays under the 60 s tool timeout of Codex and OpenClaw; pass a larger `timeout_s` only when the client allows it. Sends MCP progress notifications when the call has a progress token |
218
- | `account()` | Signed out: `status` (`signed_out`, `keyring_unreachable`), `signed_in: false`, `message`, `client_version`, `update_available`, `latest_version` (not an error). Signed in: `tier`, `job_types`, `rate_limit_per_min`, `daily_quota`, `auth_kind`, `profile`, `client_version`, `update_available`, `latest_version`, `strict_mode` (true below `full`), `exposure_level` and `exposure_sections` (the level in force, see Exposure levels), `view_mode_grant` and `view_clamped` when the server reports them, `view_mode` (the view the server applies to this session, from `get_account`), `strict_enforced_by` (`server` when that view is strict, `client` while the bridge enforces it locally), `credential_source` (`clerk_session`, `api_key_environment`, `api_key_stored` or `none`; the one credential REST and the remote tools share) |
219
+ | `account()` | Signed out: `status` (`signed_out`, `keyring_unreachable`), `signed_in: false`, `message`, `client_version`, `update_available`, `latest_version` (not an error). Signed in: `tier`, `job_types`, `rate_limit_per_min`, `daily_quota`, `auth_kind`, `profile`, `client_version`, `update_available`, `latest_version`, `strict_mode` (true below `full`), `exposure_level` and `exposure_sections` (the level in force, see Exposure levels), `view_mode_grant` and `view_clamped` when the server reports them, `view_mode` (the view the server applies to this session, from `get_account`), `strict_enforced_by` (`server` when that view is strict, `client` while the bridge enforces it locally), `guided_migration` (full API: `tools` the session lists, and `hidden_by_level` with the `fix` when the level hides them, or a `note` naming the write tools the server does not list for this account), `credential_source` (`clerk_session`, `api_key_environment`, `api_key_stored` or `none`; the one credential REST and the remote tools share) |
219
220
  | `download(job_id, dest_dir=".")` | Saved file names, sizes and SHA-256 |
220
221
 
221
222
  Every local tool declares an `outputSchema` for its `structuredContent` (error results carry
222
223
  none). When the assistant advertises form elicitation in `initialize` (Claude Code, Codex, Cursor
223
224
  CLI), `submit_file` first asks in the assistant's own dialog: "Upload <path> (<bytes>, SHA-256 …) to
224
225
  NetConverter for <job type>?". Accept uploads; Decline or a dismissed dialog sends nothing and the
225
- tool returns `upload_declined`. Without elicitation, or when the assistant answers the request with
226
- an error, the upload proceeds after the assistant's own tool approval, as before. The dialog shows
227
- the path, size and hash only, never the file's text.
226
+ tool returns `upload_declined` (`reason`: `user_declined` or `form_dismissed`). Without elicitation,
227
+ or when the assistant answers the request with an error, the upload proceeds after the assistant's
228
+ own tool approval, as before. The dialog shows the path, size and hash only, never the file's text.
229
+ `apply_mapping_answers` and `submit_conversion` ask the same way before a conversion is queued
230
+ (`apply_declined`).
231
+
232
+ Some assistants (ChatGPT, Claude Code) advertise form elicitation but decline without showing the
233
+ form. A decline or dismissal that comes back within 1.5 seconds is treated as the client's, not
234
+ yours: nothing is sent, the tool returns `confirmation_required` (`reason: client_declined_form`)
235
+ with a single-use `confirm_token` bound to that exact call (10 minutes), and the bridge sends no
236
+ more forms in that session. The assistant asks you in the conversation; only on your yes does it
237
+ repeat the call with `confirm_token`. To skip forms entirely and rely on the assistant's own tool
238
+ approval, start the bridge with `netconverter mcp --no-upload-confirm` (or set
239
+ `NETCONVERTER_MCP_UPLOAD_CONFIRM=0` in the assistant's MCP server environment).
228
240
 
229
241
  The bridge also offers two MCP prompts: `guided-migration` (from a file path to a verdict and
230
242
  artifacts) and `mapping-review` (optional `job_id`: what was mapped, what needs review, what is
231
243
  blocked). Both tell the assistant it will not get configuration content and name the folder's
232
244
  exposure level. `--guided` keeps its own prompts (`migration-studio`, `pre-cutover-review`).
233
245
 
246
+ ### Guided migration (prescan → decisions → conversion)
247
+
248
+ 1. `submit_file(path, source_vendor, target_vendor?, job_type="prescan")` uploads the file and
249
+ returns a `psc_` job id; nothing is converted yet. `wait_for_job` until it is completed.
250
+ 2. `list_operations`, `get_decision_document` and `validate_decision_document` with
251
+ `job_id=psc_…` read the decisions the prescan found.
252
+ 3. With your OK, `propose_operations(job_id, changes, base_sha256)` records each choice as a new
253
+ revision, and `submit_conversion(job_id, revision)` queues the conversion (confirmed like an
254
+ upload); it answers with the new `tra_` job id. `wait_for_job` and `download` as usual.
255
+
256
+ The guided tools are in the default list only, so they need exposure level `full`:
257
+ run `netconverter privacy level full` in a terminal in the folder, then reconnect the assistant's
258
+ netconverter server (assistants cache the tool list). `propose_operations` and `submit_conversion`
259
+ are write tools: the server lists them only where they are enabled for your tenant, and checks
260
+ and audits every call. `account` (`guided_migration`) and the remote `get_account` say which tools
261
+ this session has and why any are missing. A sign-in (`netconverter login --clerk`) or an
262
+ enterprise API key with `write:jobs` both work; pilot (Terminal Quick) keys have no prescan.
263
+
234
264
  Remote NetConverter tools are proxied only from a fixed allowlist, and never a
235
- `submit_*` tool. Default: `compare_against_intent`, `fetch`, `get_account`,
265
+ `submit_*` tool other than `submit_conversion` (a prescan id and a revision, no
266
+ configuration text). Default: `compare_against_intent`, `fetch`, `get_account`,
236
267
  `get_acl_summary`, `get_critical_object_impact`, `get_dependency_chains`,
237
268
  `get_evidence`, `get_interface_summary`, `get_job_brief`, `get_management_config`,
238
269
  `get_nat_summary`, `get_object_dependencies`, `get_object_summary`, `get_report`,
239
270
  `get_route_summary`, `get_target_config`, `get_translation_edge_summary`,
240
271
  `get_unused_objects`, `get_vpn_summary`, `get_zone_summary`, `kb_explain`,
241
272
  `kb_search`, `list_jobs`, `list_objects_with_attribute`, `list_rules_matching`,
242
- `query_ir`, `search`, `select_job`, `simulate_flow`, `vendor_capability_lookup`.
273
+ `query_ir`, `search`, `select_job`, `simulate_flow`, `vendor_capability_lookup`,
274
+ `get_mapping_questions`, `validate_mapping`, `apply_mapping_answers`, `list_operations`,
275
+ `get_decision_document`, `validate_decision_document`, `propose_operations`, `submit_conversion`,
276
+ `set_view_level` (lowers the server's view for the session; it can never raise it).
243
277
  At levels `none`, `masked` and `selected` (the default is masked; `full` uses the default list):
244
278
  `list_jobs`, `select_job`, `get_account`, `search`, `fetch`,
245
279
  `kb_search`, `kb_explain`, `vendor_capability_lookup`, `get_job_brief`,
246
- `get_evidence`, `get_report`, plus the chosen sections' tools under `selected`. A listed tool appears
280
+ `get_evidence`, `get_report`, the three guided-mapping tools, plus the chosen sections' tools under `selected`. A listed tool appears
247
281
  only if the server offers it.
248
282
  The bridge sends the level on every request (`X-NetConverter-View: none|masked|selected|full`;
249
283
  the server may only lower the grant's view, never raise it) and reads the view in force from
@@ -259,6 +293,7 @@ Environment: `NETCONVERTER_URL`, `NETCONVERTER_PROVIDER`, `NETCONVERTER_MODEL`,
259
293
  your sign-in, while `mcp` prefers the sign-in and says on stderr which API key it leaves unused;
260
294
  `NETCONVERTER_MCP_AUTH` overrides it for `mcp` only), `NETCONVERTER_TRUSTED_HOSTS`, `NETCONVERTER_MCP_VIEW=none|masked|selected|full|strict` (same as `mcp --level`; it can only lower
261
295
  the folder's exposure level, and an explicit flag wins),
296
+ `NETCONVERTER_MCP_UPLOAD_CONFIRM=0` (same as `mcp --no-upload-confirm`),
262
297
  `NETCONVERTER_NO_UPDATE_CHECK=1` (no daily update check or notice; `account` then reports
263
298
  `update_available: null`), `NETCONVERTER_KEYRING_TIMEOUT_S` (how long to wait for the OS keyring
264
299
  before reporting it locked; default 5), `NETCONVERTER_CREDENTIAL_STORE`,
@@ -309,6 +344,8 @@ file is reported as a missing file, never as "not signed in".
309
344
  | "the credentials are in the encrypted file …, which this process cannot open" | Set `NETCONVERTER_CREDENTIAL_PASSPHRASE` (or `NETCONVERTER_CREDENTIAL_PASSPHRASE_FILE`) to the passphrase used at sign-in, in the shell or in the AI client's `env` for the bridge. "does not open" means a wrong passphrase or an altered file |
310
345
  | "Your system keyring is locked" (exit 3) | The OS keyring did not answer within 5 seconds (a locked Secret Service collection after a reboot, or a keychain waiting for a password). Unlock it (for example by logging in to the desktop session), or sign in again with `netconverter login` |
311
346
  | `keyring_unreachable` from the bridge (Linux) | The assistant launched `netconverter mcp` without `DBUS_SESSION_BUS_ADDRESS`; the bridge tries `$XDG_RUNTIME_DIR/bus` and `/run/user/<uid>/bus`, else set that variable (or `NETCONVERTER_API_KEY`) in the assistant's MCP server environment and restart it |
347
+ | `submit_file` always fails `upload_declined` / `confirmation_required` (ChatGPT, Claude Code) | The assistant declines confirmation forms without showing them. Say yes in the conversation so it can retry with the `confirm_token`, or start the bridge with `--no-upload-confirm` (`NETCONVERTER_MCP_UPLOAD_CONFIRM=0`) |
348
+ | Guided tools (`list_operations`, `submit_conversion` …) missing | They need exposure level `full` (`netconverter privacy level full`, then reconnect the assistant); the two write tools also need the tenant to have them enabled. `account` → `guided_migration` says which |
312
349
  | Assistant cannot see a NetConverter tool | The bridge lists only allowlisted remote tools the server offers (fewer below `full`; `netconverter privacy status` shows the level); update the client with `netconverter update` |
313
350
  | `netconverter update` says uv is not on PATH | Install uv, or follow the printed download, `shasum -a 256 -c SHA256SUMS` and `uv tool install --force` steps |
314
351
 
@@ -4,7 +4,7 @@ NetConverter reaches your AI assistant in one of two ways. Pick the one your ass
4
4
 
5
5
  | Way | What your AI can do | Assistants |
6
6
  |---|---|---|
7
- | **Terminal bridge** (`netconverter mcp`, runs on your computer) | Everything below, **plus submit** configurations for conversion, validation and optimization. The bridge uploads the file from disk; the configuration never passes through the model. | Claude Desktop, Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code, Devin Desktop / Windsurf, LM Studio, OpenClaw |
7
+ | **Terminal bridge** (`netconverter mcp`, runs on your computer) | Everything below, **plus submit** configurations for conversion, validation and optimization. The bridge uploads the file from disk; the configuration never passes through the model. | Claude Desktop, Claude Code, Cursor, Gemini CLI, Codex CLI, ChatGPT desktop agent, VS Code, Devin Desktop / Windsurf, LM Studio, OpenClaw |
8
8
  | **Remote connector** (`https://api.netconverter.ai/mcp/v1`) | Read your jobs, verdicts, evidence and reports, your account, and the NetConverter migration knowledge base. No file submission. | claude.ai (web, mobile, Desktop chat), ChatGPT |
9
9
 
10
10
  Both need a NetConverter account with **MCP access enabled** by your administrator
@@ -14,7 +14,7 @@ Both need a NetConverter account with **MCP access enabled** by your administrat
14
14
 
15
15
  - **[Getting access](getting-access.md)** — new users and administrators start here
16
16
  - [claude.ai, Claude Desktop chat and the Claude mobile app](claude-ai.md) — remote connector
17
- - [ChatGPT](chatgpt.md) — remote connector
17
+ - [ChatGPT](chatgpt.md) — desktop agent (terminal bridge: upload and guided migration) or remote connector
18
18
  - [Claude Desktop](claude-desktop.md) — terminal bridge
19
19
  - [Claude Code](claude-code.md) — terminal bridge
20
20
  - [Cursor, Gemini CLI, Codex CLI, VS Code, Devin Desktop / Windsurf, LM Studio](other-assistants.md) — terminal bridge
@@ -0,0 +1,63 @@
1
+ # ChatGPT
2
+
3
+ ChatGPT reaches NetConverter in two ways:
4
+
5
+ - **ChatGPT desktop app's agent (Codex)**, on your computer: it runs this terminal's bridge, so
6
+ it can **upload configuration files** by path and run a **guided migration** (prescan →
7
+ decisions → conversion). Setup below under *Upload files from ChatGPT*.
8
+ - **The hosted connector** (chatgpt.com, any ChatGPT app): reads your jobs, results, account
9
+ and the knowledge base; it cannot submit configurations. Setup under *Add the connector*.
10
+
11
+ `netconverter connect chatgpt` prints both.
12
+
13
+ ## Upload files from ChatGPT (desktop app agent)
14
+
15
+ The ChatGPT desktop app's agent reads its MCP servers from `~/.codex/config.toml`, the same
16
+ file Codex CLI uses. Use a dedicated folder for your configurations (not your home folder):
17
+
18
+ ```sh
19
+ netconverter login --clerk # once; or an enterprise API key with write:jobs
20
+ mkdir -p ~/migrations && cd ~/migrations
21
+ netconverter connect codex # adds [mcp_servers.netconverter] for this folder
22
+ netconverter privacy level full # needed for the guided-migration tools; type the phrase
23
+ ```
24
+
25
+ Then restart ChatGPT. If `~/.codex/config.toml` already has `[mcp_servers.netconverter]`,
26
+ `connect` shows the table instead of changing it: edit its `args` to
27
+ `["mcp", "--workspace", "/Users/<you>/migrations"]`.
28
+
29
+ What happens in a chat (*"Prescan ~/migrations/edge.cfg from ASA to Palo Alto XML and walk me
30
+ through the decisions"*):
31
+
32
+ 1. ChatGPT asks to run `submit_file`: approve it in ChatGPT's own tool prompt.
33
+ 2. ChatGPT cannot show the bridge's upload form (it declines it unseen), so the bridge sends
34
+ nothing and answers `confirmation_required`. ChatGPT asks you in the chat whether to upload
35
+ that file (path and size); only when you say yes does it repeat the call with the
36
+ single-use `confirm_token`. The file goes from disk to NetConverter; its text never passes
37
+ through ChatGPT. The job stops at a `psc_` prescan.
38
+ 3. ChatGPT reads the decisions (`list_operations`, `get_decision_document`,
39
+ `validate_decision_document`), asks you about each one, records your choices with
40
+ `propose_operations`, and with your OK queues the conversion with `submit_conversion`
41
+ (asked in the chat the same way). `download` saves the Palo Alto output in the folder.
42
+
43
+ Exposure level: the guided-migration tools need `full` for the folder. At `masked` (the default)
44
+ the prescan still runs, and `account` says the tools are hidden and how to fix it. The write tools
45
+ (`propose_operations`, `submit_conversion`) are listed only where they are enabled for your
46
+ tenant. If you prefer ChatGPT's own tool approval as the only confirmation, add
47
+ `"--no-upload-confirm"` to the `args` (or set `NETCONVERTER_MCP_UPLOAD_CONFIRM=0`).
48
+ ChatGPT keeps the tool list from when it started: restart it after an update or a level change.
49
+
50
+ ## Add the connector
51
+
52
+ 1. In ChatGPT: **Settings → Apps & Connectors → Advanced settings** → turn on
53
+ **Developer mode**, then **Create** a custom connector.
54
+ 2. Fill it in:
55
+ - **Name:** `NetConverter`
56
+ - **MCP server URL:** `https://api.netconverter.ai/mcp/v1`
57
+ - **Authentication:** OAuth. Under the advanced OAuth settings enter
58
+ **Client ID** `RjSv1z2Gms6iS96s` and leave the client secret empty.
59
+ 3. Save, then sign in with your NetConverter account when asked.
60
+ 4. In a chat, enable NetConverter from the **+** menu (Developer mode).
61
+
62
+ Developer mode and custom connectors depend on your ChatGPT plan and workspace
63
+ settings; on business workspaces an admin may need to allow them.
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "netconverter-cli"
7
- version = "0.5.0"
7
+ version = "0.7.0"
8
8
  description = "NetConverter CLI — any-vendor network configuration migration, validation and optimization, and a local MCP bridge for your AI assistant"
9
9
  readme = "README.md"
10
10
  license = "LicenseRef-NetConverter-Proprietary"
@@ -1,3 +1,3 @@
1
1
  """NetConverter CLI: file transfer and conversation are separate paths."""
2
2
 
3
- __version__ = "0.5.0"
3
+ __version__ = "0.7.0"
@@ -11,7 +11,7 @@ from __future__ import annotations
11
11
 
12
12
  from dataclasses import dataclass, field
13
13
 
14
- JOB_TYPES = ("convert", "validate", "optimize")
14
+ JOB_TYPES = ("convert", "validate", "optimize", "prescan")
15
15
  QUICK_SOURCES = ("cisco_asa", "palo_alto_set", "palo_alto_xml", "palo_alto_panorama")
16
16
  QUICK_LIMIT_BYTES = 50_000
17
17
  DEVICE_TYPES = ("firewall", "router", "switch")
@@ -32,6 +32,7 @@ LABELS = {
32
32
  "convert": "Convert",
33
33
  "validate": "Validate",
34
34
  "optimize": "Optimize",
35
+ "prescan": "Prescan",
35
36
  "analyze": "Validate",
36
37
  }
37
38
  FIELD_LABELS = {
@@ -191,6 +191,11 @@ def mcp_view_default() -> str | None:
191
191
  return value if value in MCP_VIEWS else None
192
192
 
193
193
 
194
+ def mcp_upload_confirm_default() -> bool:
195
+ """`mcp` asks for upload/convert confirmation forms unless NETCONVERTER_MCP_UPLOAD_CONFIRM is 0/false/off (#37)."""
196
+ return os.getenv("NETCONVERTER_MCP_UPLOAD_CONFIRM", "").strip().lower() not in {"0", "false", "no", "off"}
197
+
198
+
194
199
  def mcp_auth_default() -> str:
195
200
  """`mcp --auth` default: NETCONVERTER_MCP_AUTH, else NETCONVERTER_AUTH (#16), else auto."""
196
201
  for name in ("NETCONVERTER_MCP_AUTH", "NETCONVERTER_AUTH"):
@@ -281,7 +286,7 @@ def run_mcp(args):
281
286
  options["credential_loader"] = lambda: choose_mcp_credential(args.auth, args.server, mcp_url)
282
287
  run_stdio(Bridge(args.workspace, args.server, rest, remote, strict=strict,
283
288
  credential_source=source, level=cap.level, sections=cap.sections,
284
- workspace_level=True, **options))
289
+ workspace_level=True, upload_confirm=getattr(args, "upload_confirm", True), **options))
285
290
  finally:
286
291
  if remote:
287
292
  remote.close()
@@ -606,7 +611,13 @@ def parser():
606
611
  mcp.add_argument("--strict", dest="view", action="store_const", const="strict",
607
612
  help="at most masked (the strict view)")
608
613
  mcp.add_argument("--full", dest="view", action="store_const", const="full",
609
- help="up to full, when this folder's level is full")
614
+ help="up to full, when this folder's level is full (`netconverter privacy level full`; "
615
+ "the guided-migration tools, prescan to submit_conversion, need it)")
616
+ mcp.add_argument("--no-upload-confirm", dest="upload_confirm", action="store_false",
617
+ default=mcp_upload_confirm_default(),
618
+ help="never send a confirmation form before an upload or a queued conversion; the AI "
619
+ "client's own tool approval confirms instead (for clients that decline forms "
620
+ "unseen, e.g. ChatGPT, Claude Code; NETCONVERTER_MCP_UPLOAD_CONFIRM=0)")
610
621
  mcp.add_argument("--workspace", default=argparse.SUPPRESS, help="folder the file tools may read and write")
611
622
  from .connect import CLIENTS as _AI_CLIENTS
612
623
  connect = subs.add_parser(
@@ -371,7 +371,12 @@ REMOTE_STEPS = {
371
371
  " Authentication: OAuth. Under advanced OAuth settings enter the NetConverter OAuth\n"
372
372
  " client ID your administrator gives you, then sign in with your\n"
373
373
  " NetConverter account when asked.\n"
374
- "Then enable NetConverter in a chat from the + menu (Developer mode)."),
374
+ "Then enable NetConverter in a chat from the + menu (Developer mode).\n"
375
+ "To upload configuration files from ChatGPT: the ChatGPT desktop app's agent (Codex) runs\n"
376
+ "this bridge from ~/.codex/config.toml. In your migrations folder run\n"
377
+ "`netconverter connect codex` and, for the guided-migration tools,\n"
378
+ "`netconverter privacy level full`; then restart ChatGPT. ChatGPT cannot show the\n"
379
+ "upload form, so it asks you in the chat before each upload (docs/connect/chatgpt.md)."),
375
380
  "claude-ai": (
376
381
  "claude.ai (web and mobile)",
377
382
  "On claude.ai: Settings → Connectors → Add custom connector.\n"
@@ -27,6 +27,7 @@ JOB_ACTIONS = ("get_job_status", "download_artifact")
27
27
  from .projects import OPERATIONS as PROJECT_ACTIONS, CONTRACT as PROJECT_CONTRACT
28
28
  _ALL_ACTIONS = ACTIONS + RESOURCE_ACTIONS + JOB_ACTIONS + PROJECT_ACTIONS
29
29
  JOB_STATUSES = ("queued", "running", "complete", "failed", "stale")
30
+ MIGRATION_TARGETS = ("palo_alto_set", "palo_alto_xml", "palo_alto_panorama")
30
31
  _ID = re.compile(r"[A-Za-z0-9_-]{1,80}\Z")
31
32
  _HASH = re.compile(r"[a-f0-9]{64}\Z")
32
33
  _KEY = re.compile(r"[A-Za-z0-9_-]{8,128}\Z")
@@ -90,9 +91,9 @@ DATA_PROPERTIES = {
90
91
  "manifest_revision": REV_SCHEMA, "progress": {"type": "integer", "minimum": 0, "maximum": 100},
91
92
  "waited_s": {"type": "number", "minimum": 0}, "timed_out": {"type": "boolean"},
92
93
  "draft_kind": {"const": "migration"},
93
- "source_vendor": {"const": "cisco_asa"}, "target_vendor": {"const": "palo_alto_set"},
94
- "migration_pairs": {"type": "array", "maxItems": 1, "items": _object({
95
- "source_vendor": {"const": "cisco_asa"}, "target_vendor": {"const": "palo_alto_set"},
94
+ "source_vendor": {"const": "cisco_asa"}, "target_vendor": {"enum": list(MIGRATION_TARGETS)},
95
+ "migration_pairs": {"type": "array", "maxItems": len(MIGRATION_TARGETS), "uniqueItems": True, "items": _object({
96
+ "source_vendor": {"const": "cisco_asa"}, "target_vendor": {"enum": list(MIGRATION_TARGETS)},
96
97
  }, ("source_vendor", "target_vendor"))},
97
98
  **{name: ID_SCHEMA for name in ("draft_id", "job_id", "validation_id", "review_id", "approval_ref", "view_id", "catalog_version", "entry_id")},
98
99
  **{name: HASH_SCHEMA for name in ("content_sha256", "source_sha256", "document_sha256", "validation_sha256", "sha256")},
@@ -355,11 +356,14 @@ class DraftService:
355
356
  any(not isinstance(item, str) for item in guided["operations"]) or
356
357
  not isinstance(guided.get("migration_pairs"), list) or
357
358
  not any(isinstance(pair, dict) and pair.get("source_vendor") == "cisco_asa" and
358
- pair.get("target_vendor") == "palo_alto_set" for pair in guided["migration_pairs"])):
359
+ pair.get("target_vendor") in MIGRATION_TARGETS for pair in guided["migration_pairs"])):
359
360
  raise DraftError("unsupported_capability")
360
361
  return {"enabled": True, "contract_version": "1", "approval_mode": "human_bound", "agent_restricted": True,
361
362
  "view_mode": "strict", "view_enforced_by": "server",
362
- "migration_pairs": [{"source_vendor": "cisco_asa", "target_vendor": "palo_alto_set"}],
363
+ "migration_pairs": [{"source_vendor": "cisco_asa", "target_vendor": target}
364
+ for target in MIGRATION_TARGETS if any(isinstance(pair, dict) and
365
+ pair.get("source_vendor") == "cisco_asa" and pair.get("target_vendor") == target
366
+ for pair in guided["migration_pairs"])],
363
367
  "operations": [action for action in _ALL_ACTIONS if action in guided["operations"]]}
364
368
 
365
369
  def capabilities(self):
@@ -392,6 +396,9 @@ class DraftService:
392
396
  capabilities = self._capabilities()
393
397
  if action not in capabilities["operations"]:
394
398
  raise DraftError("unsupported_capability")
399
+ if action == "prepare_draft" and {"source_vendor": arguments.get("source_vendor", "cisco_asa"),
400
+ "target_vendor": arguments.get("target_vendor", "palo_alto_set")} not in capabilities["migration_pairs"]:
401
+ raise DraftError("unsupported_capability")
395
402
  return _success(self._run(action, arguments))
396
403
  except APIError as exc:
397
404
  return self._api_error(exc)
@@ -437,7 +444,7 @@ class DraftService:
437
444
  @staticmethod
438
445
  def _migration(data):
439
446
  if (data.get("draft_kind") != "migration" or data.get("source_vendor") != "cisco_asa" or
440
- data.get("target_vendor") != "palo_alto_set"):
447
+ data.get("target_vendor") not in MIGRATION_TARGETS):
441
448
  raise DraftError("unsupported_capability")
442
449
 
443
450
  def _current_draft(self, draft_id, revision):
@@ -480,7 +487,7 @@ class DraftService:
480
487
  self._arguments(args, ("path", "idempotency_key"), ("source_vendor", "target_vendor", "workflow"))
481
488
  key = self._idempotency(args)
482
489
  source, target, workflow = args.get("source_vendor", "cisco_asa"), args.get("target_vendor", "palo_alto_set"), args.get("workflow", "studio")
483
- if source != "cisco_asa" or target != "palo_alto_set" or workflow not in {"studio", "quick"}:
490
+ if source != "cisco_asa" or target not in MIGRATION_TARGETS or workflow not in {"studio", "quick"}:
484
491
  raise DraftError("unsupported_capability")
485
492
  _, content, sha = secure_snapshot(self.workspace, args["path"])
486
493
  data = self.client.request("POST", "drafts", idempotency_key=key,
@@ -490,7 +497,8 @@ class DraftService:
490
497
  _identifier(projected.get("draft_id"))
491
498
  _revision(projected.get("revision"))
492
499
  self._migration(projected)
493
- if projected.get("source_sha256") != sha:
500
+ if (projected.get("source_sha256") != sha or projected.get("source_vendor") != source
501
+ or projected.get("target_vendor") != target):
494
502
  raise DraftError("invalid_response")
495
503
  return projected
496
504
  if action in RESOURCE_ACTIONS:
@@ -57,7 +57,7 @@ BODY_OPTIONS = {
57
57
  "properties": {k: {"type": "boolean"} for k in OPTIMIZATION_FLAGS},
58
58
  "description": "Optimize only: analysis switches."}, ("optimize",)),
59
59
  "file_name": ({**_text(255), "description": "Name shown for the job in the portal."},
60
- ("convert", "validate", "optimize")),
60
+ ("convert", "validate", "optimize", "prescan")),
61
61
  }
62
62
  DECISION_OPTIONS = {
63
63
  "zone_mapping": ({"type": "object", "additionalProperties": _text(200), "maxProperties": 500,
@@ -32,11 +32,24 @@ _JOB_SUMMARY = {
32
32
  "source_vendor": _VENDOR, "target_vendor": _VENDOR,
33
33
  }
34
34
 
35
+ # Which guided-migration tools a session lists, or why not (aws#1090).
36
+ _GUIDED = {
37
+ "type": "object",
38
+ "properties": {"exposure_level": {"type": "string", "enum": list(LEVELS)},
39
+ "tools": {"type": "array", "items": {"type": "string"}},
40
+ "hidden_by_level": {"type": "boolean"}, "fix": {"type": "string"},
41
+ "note": {"type": "string"}},
42
+ "required": ["exposure_level", "tools"],
43
+ "additionalProperties": False,
44
+ }
45
+
35
46
  OUTPUT_SCHEMAS = {
36
47
  "submit_file": {
37
48
  "type": "object",
38
49
  "properties": {"job_id": _JOB_ID, "status": _STATUS, "sha256": _SHA256,
39
- "bytes": {"type": "integer", "minimum": 1}},
50
+ "bytes": {"type": "integer", "minimum": 1},
51
+ "job_type": {"type": "string", "enum": ["prescan"]},
52
+ "next_steps": {"type": "string"}, "guided_tools": _GUIDED},
40
53
  "required": ["job_id", "status", "sha256", "bytes"],
41
54
  "additionalProperties": False,
42
55
  },
@@ -68,6 +81,7 @@ OUTPUT_SCHEMAS = {
68
81
  "view_mode": {"type": ["string", "null"]}, "view_mode_grant": {"type": "string"},
69
82
  "view_clamped": {"type": "boolean"},
70
83
  "strict_enforced_by": {"type": ["string", "null"], "enum": ["server", "client", None]},
84
+ "guided_migration": _GUIDED,
71
85
  },
72
86
  "required": ["client_version"],
73
87
  },
@@ -179,9 +193,16 @@ def upload_request(details: dict, protocol: str) -> dict:
179
193
  def apply_request(details: dict, protocol: str) -> dict:
180
194
  """elicitation/create params before a guided-mapping apply queues a re-conversion (#12)."""
181
195
  count = details.get("answers") or 0
182
- message = (f"Apply {count} mapping answer{'' if count == 1 else 's'} to job {details['job_id']}? "
183
- "NetConverter queues a new conversion with these decisions; your configuration is not "
184
- "shown to the assistant.")
196
+ if details.get("tool") == "submit_conversion":
197
+ revision = details.get("revision")
198
+ message = (f"Convert prescan {details['job_id']} with decision revision "
199
+ f"{revision if type(revision) is int else '(as given)'}? NetConverter queues the "
200
+ "conversion as a new job with the decisions you recorded; your configuration is not "
201
+ "shown to the assistant.")
202
+ else:
203
+ message = (f"Apply {count} mapping answer{'' if count == 1 else 's'} to job {details['job_id']}? "
204
+ "NetConverter queues a new conversion with these decisions; your configuration is not "
205
+ "shown to the assistant.")
185
206
  params = {"message": message, "requestedSchema": {
186
207
  "type": "object",
187
208
  "properties": {"apply": {"type": "boolean", "title": "Queue the new conversion",