portacode 2.2.28.dev4__tar.gz → 2.2.29.dev0__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 (244) hide show
  1. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/PKG-INFO +1 -1
  2. portacode-2.2.29.dev0/docs/domain-dns.md +62 -0
  3. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/_version.py +2 -2
  4. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/cli.py +2 -0
  5. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/__init__.py +2 -0
  6. portacode-2.2.29.dev0/portacode/connection/handlers/domain_dns.py +16 -0
  7. portacode-2.2.29.dev0/portacode/connection/handlers/test_domain_dns.py +134 -0
  8. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/terminal.py +2 -0
  9. portacode-2.2.29.dev0/portacode/dns_cli.py +27 -0
  10. portacode-2.2.29.dev0/portacode/tunneling/dns.py +177 -0
  11. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/PKG-INFO +1 -1
  12. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/SOURCES.txt +5 -0
  13. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/scm_file_list.json +5 -0
  14. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/.gitignore +0 -0
  15. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/LICENSE +0 -0
  16. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/MANIFEST.in +0 -0
  17. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/Makefile +0 -0
  18. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/README.md +0 -0
  19. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/build_android.sh +0 -0
  20. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/connect.py +0 -0
  21. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/connect.sh +0 -0
  22. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/cloudflare-access.md +0 -0
  23. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/cloudflared-domain-connect-containers-audit.md +0 -0
  24. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/creative-team-brief-portacode.md +0 -0
  25. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/device-health-alerting-plan.md +0 -0
  26. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/devops-messaging-ab-tests.md +0 -0
  27. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/guest-host-requests-plan.md +0 -0
  28. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/homepage-dashboard-positioning-fixes.md +0 -0
  29. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/template-guide.html +0 -0
  30. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/README.md +0 -0
  31. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/simple_device/Dockerfile +0 -0
  32. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/simple_device/README.md +0 -0
  33. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/simple_device/docker-compose.yaml +0 -0
  34. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/Dockerfile +0 -0
  35. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/README.md +0 -0
  36. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/docker-compose.yaml +0 -0
  37. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/README.md +0 -0
  38. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/__init__.py +0 -0
  39. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/asgi.py +0 -0
  40. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/settings.py +0 -0
  41. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/urls.py +0 -0
  42. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/wsgi.py +0 -0
  43. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/manage.py +0 -0
  44. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/requirements.txt +0 -0
  45. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/templates/treats/home.html +0 -0
  46. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/__init__.py +0 -0
  47. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/admin.py +0 -0
  48. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/apps.py +0 -0
  49. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/menu.py +0 -0
  50. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/migrations/__init__.py +0 -0
  51. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/models.py +0 -0
  52. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/tests.py +0 -0
  53. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/urls.py +0 -0
  54. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/views.py +0 -0
  55. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/instructions/WELCOME.md +0 -0
  56. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/README.md +0 -0
  57. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/__init__.py +0 -0
  58. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/__main__.py +0 -0
  59. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-github/SKILL.md +0 -0
  60. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-github/agents/openai.yaml +0 -0
  61. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-github/scripts/create_repository.py +0 -0
  62. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-image/SKILL.md +0 -0
  63. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-image/agents/openai.yaml +0 -0
  64. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/browser_cli.py +0 -0
  65. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/browser_prepare.py +0 -0
  66. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/browser_runtime.py +0 -0
  67. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/codex_loopback_proxy.py +0 -0
  68. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/codex_prepare.py +0 -0
  69. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/codex_usage_limit.py +0 -0
  70. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/README.md +0 -0
  71. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/__init__.py +0 -0
  72. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/client.py +0 -0
  73. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/codex_app_server.py +0 -0
  74. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/guest_host_protocol.py +0 -0
  75. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/README.md +0 -0
  76. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/WEBSOCKET_PROTOCOL.md +0 -0
  77. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/automation_v2_handlers.py +0 -0
  78. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/base.py +0 -0
  79. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/browser_handlers.py +0 -0
  80. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/chunked_content.py +0 -0
  81. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/cloudflare_forwarding.py +0 -0
  82. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/cloudflare_tunnel.py +0 -0
  83. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/codex_handlers.py +0 -0
  84. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/diff_handlers.py +0 -0
  85. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/file_handlers.py +0 -0
  86. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/file_transfer_handlers.py +0 -0
  87. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/git_handlers.py +0 -0
  88. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_aware_file_handlers.py +0 -0
  89. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/README.md +0 -0
  90. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/__init__.py +0 -0
  91. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/file_system_watcher.py +0 -0
  92. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/git_manager.py +0 -0
  93. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/handlers.py +0 -0
  94. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/manager.py +0 -0
  95. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/models.py +0 -0
  96. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/test_handlers.py +0 -0
  97. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/test_sync.py +0 -0
  98. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/utils.py +0 -0
  99. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state_handlers.py +0 -0
  100. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/proxmox_infra.py +0 -0
  101. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/registry.py +0 -0
  102. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/resumable_transfer_handlers.py +0 -0
  103. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/runtime_user.py +0 -0
  104. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/session.py +0 -0
  105. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/system_handlers.py +0 -0
  106. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/tab_factory.py +0 -0
  107. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/terminal_handlers.py +0 -0
  108. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_browser_handlers.py +0 -0
  109. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_cloudflare_access.py +0 -0
  110. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_cloudflare_forwarding.py +0 -0
  111. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_file_move_copy.py +0 -0
  112. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_git_handlers.py +0 -0
  113. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_proxmox_infra.py +0 -0
  114. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_runtime_user.py +0 -0
  115. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/update_handler.py +0 -0
  116. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/multiplex.py +0 -0
  117. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/test_guest_host_protocol.py +0 -0
  118. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/test_guest_host_terminal.py +0 -0
  119. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/test_webmin_proxy_config.py +0 -0
  120. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/webmin_proxy_config.py +0 -0
  121. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/data.py +0 -0
  122. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/exit_codes.py +0 -0
  123. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/github_credential.py +0 -0
  124. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/image_cli.py +0 -0
  125. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/keypair.py +0 -0
  126. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/__init__.py +0 -0
  127. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/elinks +0 -0
  128. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/gio-open +0 -0
  129. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/gnome-open +0 -0
  130. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/gvfs-open +0 -0
  131. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/kde-open +0 -0
  132. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/kfmclient +0 -0
  133. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/link_capture_exec.sh +0 -0
  134. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/link_capture_wrapper.py +0 -0
  135. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/links +0 -0
  136. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/links2 +0 -0
  137. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/lynx +0 -0
  138. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/mate-open +0 -0
  139. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/netsurf +0 -0
  140. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/sensible-browser +0 -0
  141. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/w3m +0 -0
  142. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/x-www-browser +0 -0
  143. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/xdg-open +0 -0
  144. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/logging_categories.py +0 -0
  145. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/pairing.py +0 -0
  146. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/provisioning_cache.py +0 -0
  147. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/restart.py +0 -0
  148. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/service.py +0 -0
  149. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/singleton.py +0 -0
  150. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/static/js/test-ntp-clock.html +0 -0
  151. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/static/js/utils/ntp-clock.js +0 -0
  152. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_runtime_paths.py +0 -0
  153. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_service.py +0 -0
  154. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_singleton.py +0 -0
  155. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_terminal_exposed_services.py +0 -0
  156. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_automation_v2_inputs.py +0 -0
  157. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_browser_cli.py +0 -0
  158. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_browser_prepare.py +0 -0
  159. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_cli_service_logs.py +0 -0
  160. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_app_server.py +0 -0
  161. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_handlers.py +0 -0
  162. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_loopback_proxy.py +0 -0
  163. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_prepare.py +0 -0
  164. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_prepare_cli.py +0 -0
  165. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_github_credential.py +0 -0
  166. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_image_cli.py +0 -0
  167. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_image_read_handler.py +0 -0
  168. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_resumable_transfer_handlers.py +0 -0
  169. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_system_handlers.py +0 -0
  170. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_terminal_periodic_system_info.py +0 -0
  171. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_terminal_session_shell.py +0 -0
  172. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/__init__.py +0 -0
  173. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/access.py +0 -0
  174. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/cloudflared_login.py +0 -0
  175. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/ensure_cloudflared.py +0 -0
  176. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/ensure_pyyaml.py +0 -0
  177. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/forwarding_state.py +0 -0
  178. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/get_domain.py +0 -0
  179. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/privileged.py +0 -0
  180. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/service_install.py +0 -0
  181. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/state.py +0 -0
  182. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/updater.py +0 -0
  183. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/NTP_ARCHITECTURE.md +0 -0
  184. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/__init__.py +0 -0
  185. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/diff_apply.py +0 -0
  186. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/diff_renderer.py +0 -0
  187. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/ntp_clock.py +0 -0
  188. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/runtime_paths.py +0 -0
  189. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/dependency_links.txt +0 -0
  190. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/entry_points.txt +0 -0
  191. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/requires.txt +0 -0
  192. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/top_level.txt +0 -0
  193. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/pyproject.toml +0 -0
  194. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/run_tests.py +0 -0
  195. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/scripts/diagnose_codex_gateway.py +0 -0
  196. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/setup.cfg +0 -0
  197. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/setup.py +0 -0
  198. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test.sh +0 -0
  199. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/README.md +0 -0
  200. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/__init__.py +0 -0
  201. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_device_online.py +0 -0
  202. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_file_operations.py +0 -0
  203. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_git_status_ui.py +0 -0
  204. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_login_flow.py +0 -0
  205. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_navigate_testing_folder.py +0 -0
  206. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_play_store_screenshots.py +0 -0
  207. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_buffer_performance.py +0 -0
  208. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_interaction.py +0 -0
  209. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_loading_race_condition.py +0 -0
  210. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_start.py +0 -0
  211. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_request_id.py +0 -0
  212. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_session_terminal_shutdown.py +0 -0
  213. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/.env.example +0 -0
  214. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/README.md +0 -0
  215. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/__init__.py +0 -0
  216. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/cli.py +0 -0
  217. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/__init__.py +0 -0
  218. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/base_test.py +0 -0
  219. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/cli_manager.py +0 -0
  220. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/hierarchical_runner.py +0 -0
  221. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/playwright_manager.py +0 -0
  222. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/runner.py +0 -0
  223. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/shared_cli_manager.py +0 -0
  224. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/test_discovery.py +0 -0
  225. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/requirements.txt +0 -0
  226. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/UI_UX/opening_a_file_on_desktop_results_in_nothing.md +0 -0
  227. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/UI_UX/server_occasionally_stops_communicating_with_all_devices.md +0 -0
  228. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/agent_context_management.md +0 -0
  229. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/django_server_time_sync.md +0 -0
  230. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/device_performance_degradation.md +0 -0
  231. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/git_data_not_captured_in_proxmox.md +0 -0
  232. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/indefinite_resource_loading.md +0 -0
  233. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/portacode_service_silently_down.md +0 -0
  234. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/premature_terminal_exit.md +0 -0
  235. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/project_cpu_hotspots.md +0 -0
  236. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/terminals_exit_upon_starting.md +0 -0
  237. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/websocket_client_silently_dead.md +0 -0
  238. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/wrong_item_classification_on_client_side.md +0 -0
  239. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/smartphone_terminal_input_frustrations.md +0 -0
  240. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/generate_play_store_assets.py +0 -0
  241. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/pairing_tester.py +0 -0
  242. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/run_screenshot_suite.sh +0 -0
  243. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/test_python_ntp_clock.py +0 -0
  244. {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/validate.sh +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: portacode
3
- Version: 2.2.28.dev4
3
+ Version: 2.2.29.dev0
4
4
  Summary: Device agent for the AI platform that builds, tests, deploys, and operates real software
5
5
  Home-page: https://portacode.com/
6
6
  Author: Meena Erian
@@ -0,0 +1,62 @@
1
+ # Connected-domain DNS
2
+
3
+ Available from Portacode **2.2.29**, including **2.2.29.dev0**.
4
+ The connected device uses the Cloudflare login credential in its local
5
+ `cert.pem`. Credentials never appear in responses or travel to the dashboard.
6
+ The tunnel runtime token alone does not provide this functionality.
7
+
8
+ ## WebSocket control command
9
+
10
+ Command: `domain_dns`. Response: `domain_dns_result`, with the original
11
+ `request_id`. Errors use the normal correlated `error` event.
12
+
13
+ ```json
14
+ {"cmd":"domain_dns","action":"list","domain":"example.com","name":"@","record_type":"MX","page":1,"per_page":100,"request_id":"dns-1"}
15
+ ```
16
+
17
+ Actions:
18
+
19
+ - `list`: optional exact `name`, `record_type`, `page`, `per_page` filters;
20
+ returns `records` and Cloudflare `pagination` metadata. Maximum page size 100.
21
+ - `get`: requires `record_id`; returns `record`.
22
+ - `create`: requires a `record` object; returns `record`.
23
+ - `update`: requires `record_id`, a full desired `record` object and `if_match`.
24
+ Uses PATCH; unspecified optional metadata is preserved.
25
+ - `delete`: requires `record_id`, `if_match`, and `confirm_delete: true`.
26
+
27
+ `if_match` is the `modified_on` timestamp from a fresh read. The device checks
28
+ it before updating/deleting and rejects stale values. This is a best-effort
29
+ preflight check; Cloudflare does not provide an atomic compare-and-swap here.
30
+ Device DNS commands are serialized. External DNS writers can still race them.
31
+
32
+ Supported types: A, AAAA, CNAME, MX, TXT, NS, PTR, SRV, CAA.
33
+ Record fields: `type`, `name`, `content`, `ttl`, `priority`, `proxied`, `data`,
34
+ `comment`, `tags`. SRV/CAA use Cloudflare's structured `data` fields. Names are
35
+ fully qualified, or `@` for the connected zone apex. Underscores and leading
36
+ wildcards are supported. TTL is 1 (automatic) or 60–86400 seconds.
37
+
38
+ ```json
39
+ {"cmd":"domain_dns","action":"create","domain":"example.com","record":{"type":"MX","name":"@","content":"mail.example.net","priority":10,"ttl":300},"request_id":"dns-2"}
40
+ ```
41
+
42
+ The requested domain must match both local tunnel state and the zone returned
43
+ by Cloudflare for the local credential. Callers cannot specify credentials,
44
+ zone IDs, credential paths or API endpoints. Record IDs are validated and all
45
+ record operations stay within that verified zone.
46
+
47
+ Creation is not an upsert and does not replace existing records. After an
48
+ ambiguous timeout, list/read the exact name and inspect its contents before
49
+ retrying. SPF merging and mail-provider migration decisions belong to the
50
+ caller; this CRUD API does not invent those policies.
51
+
52
+ ## Local CLI
53
+
54
+ Run as the user that owns the Portacode service and Cloudflare login:
55
+
56
+ ```sh
57
+ portacode domain-dns list --domain example.com --record-type MX
58
+ portacode domain-dns create --domain example.com --record-json '{"type":"TXT","name":"_proof.example.com","content":"proof","ttl":300}'
59
+ portacode domain-dns get --domain example.com --record-id RECORD_ID
60
+ portacode domain-dns update --domain example.com --record-id RECORD_ID --if-match MODIFIED_ON --record-json '{"type":"TXT","name":"_proof.example.com","content":"updated","ttl":300}'
61
+ portacode domain-dns delete --domain example.com --record-id RECORD_ID --if-match MODIFIED_ON --confirm-delete
62
+ ```
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '2.2.28.dev4'
22
- __version_tuple__ = version_tuple = (2, 2, 28, 'dev4')
21
+ __version__ = version = '2.2.29.dev0'
22
+ __version_tuple__ = version_tuple = (2, 2, 29, 'dev0')
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -44,6 +44,8 @@ def cli() -> None:
44
44
 
45
45
  from .browser_cli import browser_group
46
46
  cli.add_command(browser_group)
47
+ from .dns_cli import domain_dns
48
+ cli.add_command(domain_dns)
47
49
 
48
50
 
49
51
  @cli.command("cloudflare-access-setup")
@@ -70,6 +70,7 @@ from .proxmox_infra import (
70
70
  RollbackProxmoxContainerSnapshotHandler,
71
71
  )
72
72
  from .cloudflare_tunnel import CloudflareTunnelSetupHandler
73
+ from .domain_dns import DomainDnsHandler
73
74
  from .cloudflare_forwarding import (
74
75
  CloudflareAccessHandler,
75
76
  CloudflareForwardingHandler,
@@ -155,6 +156,7 @@ __all__ = [
155
156
  "CloudflareTunnelSetupHandler",
156
157
  "CloudflareForwardingHandler",
157
158
  "CloudflareAccessHandler",
159
+ "DomainDnsHandler",
158
160
  "ConfigureProxmoxContainerExposePortsHandler",
159
161
  "AutomationV2StartHandler",
160
162
  "AutomationV2StateHandler",
@@ -0,0 +1,16 @@
1
+ """Connected-domain DNS CRUD over the authenticated control channel."""
2
+ from .base import SyncHandler
3
+ from portacode.tunneling.dns import manage_dns
4
+
5
+
6
+ class DomainDnsHandler(SyncHandler):
7
+ @property
8
+ def command_name(self):
9
+ return 'domain_dns'
10
+
11
+ def execute(self, message):
12
+ allowed = {'action', 'domain', 'record', 'record_id', 'name', 'record_type',
13
+ 'page', 'per_page', 'if_match', 'confirm_delete'}
14
+ result = manage_dns(**{key: value for key, value in message.items() if key in allowed})
15
+ return {'event': 'domain_dns_result', 'success': True,
16
+ 'device_id': str(message.get('device_id') or ''), **result}
@@ -0,0 +1,134 @@
1
+ import io
2
+ import json
3
+ import unittest
4
+ import urllib.error
5
+ from unittest.mock import MagicMock, patch
6
+ from unittest.mock import AsyncMock
7
+
8
+ from portacode.tunneling import dns
9
+ from portacode.connection.handlers.domain_dns import DomainDnsHandler
10
+
11
+ RID = 'a' * 32
12
+ ZONE = 'b' * 32
13
+
14
+
15
+ class DomainDnsTests(unittest.TestCase):
16
+ def record(self, **values):
17
+ return {'type': 'TXT', 'name': '_proof.example.com', 'content': 'proof', **values}
18
+
19
+ def test_names_and_payload_are_confined_to_domain(self):
20
+ for value in ['other.com', 'evilexample.com', 'example.com.evil.test', '../../zones/other', '*.*.example.com']:
21
+ with self.subTest(value=value), self.assertRaises(ValueError):
22
+ dns.normalize_record(self.record(name=value), 'example.com')
23
+ for extra in [{'zone_id': ZONE}, {'proxied': True}, {'ttl': True}, {'ttl': 2}, {'data': {'name': 'evil.com'}}]:
24
+ with self.subTest(extra=extra), self.assertRaises(ValueError):
25
+ dns.normalize_record(self.record(**extra), 'example.com')
26
+ self.assertEqual(dns.normalize_record(self.record(name='@'), 'example.com')['name'], 'example.com')
27
+ self.assertEqual(dns.normalize_record(self.record(name='*.example.com'), 'example.com')['name'], '*.example.com')
28
+
29
+ def test_mx_and_structured_records(self):
30
+ self.assertEqual(dns.normalize_record(self.record(type='MX', content='MAIL.EXAMPLE.NET.', priority=10), 'example.com')['content'], 'mail.example.net')
31
+ with self.assertRaises(ValueError):
32
+ dns.normalize_record(self.record(type='MX', content='mail.example.net'), 'example.com')
33
+ with self.assertRaises(ValueError):
34
+ dns.normalize_record({'type':'SRV','name':'_sip._tcp.example.com','data':{'name':'evil.com'}}, 'example.com')
35
+
36
+ @patch.object(dns, 'DnsClient')
37
+ def test_list_pagination_and_safe_result(self, factory):
38
+ factory.return_value.request.return_value = {'result': [self.record(id=RID, secret='never')], 'result_info': {'page': 2}}
39
+ result = dns.manage_dns(action='list', domain='example.com', page=2, name='_proof.example.com')
40
+ self.assertNotIn('secret', result['records'][0])
41
+ self.assertEqual(result['pagination']['page'], 2)
42
+ self.assertIn('page=2', factory.return_value.request.call_args.args[1])
43
+
44
+ @patch.object(dns, 'DnsClient')
45
+ def test_crud_and_stale_update_guard(self, factory):
46
+ client = factory.return_value
47
+ client.request.return_value = {'result': self.record(id=RID)}
48
+ client.record.return_value = self.record(id=RID, modified_on='revision-1')
49
+ dns.manage_dns(action='create', domain='example.com', record=self.record())
50
+ self.assertEqual(client.request.call_args.args[0], 'POST')
51
+ dns.manage_dns(action='get', domain='example.com', record_id=RID)
52
+ dns.manage_dns(action='update', domain='example.com', record_id=RID, record=self.record(content='new'), if_match='revision-1')
53
+ self.assertEqual(client.request.call_args.args[0], 'PATCH')
54
+ for action in ['update', 'delete']:
55
+ client.request.reset_mock()
56
+ with self.assertRaisesRegex(ValueError, 'changed'):
57
+ dns.manage_dns(action=action, domain='example.com', record_id=RID, record=self.record(), if_match='old', confirm_delete=True)
58
+ client.request.assert_not_called()
59
+ result = dns.manage_dns(action='delete', domain='example.com', record_id=RID, if_match='revision-1', confirm_delete=True)
60
+ self.assertTrue(result['deleted'])
61
+ self.assertEqual(client.request.call_args.args[0], 'DELETE')
62
+
63
+ @patch.object(dns, 'DnsClient')
64
+ def test_delete_confirmation_and_snapshot_required(self, factory):
65
+ for kw in [{}, {'if_match':'now'}, {'if_match':'now', 'confirm_delete':'true'}]:
66
+ with self.assertRaises(ValueError):
67
+ dns.manage_dns(action='delete', domain='example.com', record_id=RID, **kw)
68
+ factory.assert_not_called()
69
+
70
+ @patch.object(dns, 'load_state', return_value={'domain':'example.com','tunnel_id':'tunnel'})
71
+ @patch.object(dns, 'extract_token_json', return_value={'zoneID':ZONE,'apiToken':'private-token'})
72
+ @patch.object(dns.DnsClient, 'request', return_value={'result': {'name':'other.com'}})
73
+ def test_actual_zone_must_match_local_domain(self, request, token, state):
74
+ with self.assertRaisesRegex(ValueError, 'different domain'):
75
+ dns.DnsClient('example.com')
76
+ with self.assertRaisesRegex(ValueError, 'requested domain'):
77
+ dns.DnsClient('other.com')
78
+ self.assertEqual(request.call_count, 1)
79
+
80
+ def test_invalid_ids_and_remote_record_names(self):
81
+ client = object.__new__(dns.DnsClient)
82
+ client.domain = 'example.com'
83
+ client.request = MagicMock(return_value={'result': self.record(name='other.com')})
84
+ for rid in ['../other', '', RID]:
85
+ with self.assertRaises(ValueError): client.record(rid)
86
+ self.assertEqual(client.request.call_count, 1)
87
+
88
+ @patch.object(dns.urllib.request, 'urlopen')
89
+ def test_provider_errors_do_not_expose_secrets(self, urlopen):
90
+ client = object.__new__(dns.DnsClient)
91
+ client.base = '/zones/' + ZONE
92
+ client._token = 'private-token'
93
+ urlopen.side_effect = urllib.error.HTTPError('url', 403, 'private-token', {}, io.BytesIO(b'private-token'))
94
+ with self.assertRaises(RuntimeError) as caught:
95
+ client.request('POST', '/dns_records', self.record())
96
+ self.assertNotIn('private-token', str(caught.exception))
97
+ self.assertIn('403', str(caught.exception))
98
+
99
+ @patch('portacode.connection.handlers.domain_dns.manage_dns', return_value={'records': []})
100
+ def test_handler_accepts_structured_parameters_only(self, manage):
101
+ handler = DomainDnsHandler(None, {})
102
+ self.assertEqual(handler.command_name, 'domain_dns')
103
+ result = handler.execute({'action':'list','domain':'example.com','device_id':42,'url':'evil','token':'secret'})
104
+ manage.assert_called_once_with(action='list', domain='example.com')
105
+ self.assertEqual(result['event'], 'domain_dns_result')
106
+ self.assertNotIn('secret', json.dumps(result))
107
+
108
+ @patch('portacode.dns_cli.manage_dns', return_value={'records': []})
109
+ def test_local_cli_and_invalid_json(self, manage):
110
+ from click.testing import CliRunner
111
+ from portacode.dns_cli import domain_dns
112
+ result = CliRunner().invoke(domain_dns, ['list', '--domain', 'example.com'])
113
+ self.assertEqual(result.exit_code, 0, result.output)
114
+ self.assertEqual(json.loads(result.output), {'records': []})
115
+ result = CliRunner().invoke(domain_dns, ['create', '--domain', 'example.com', '--record-json', '{'])
116
+ self.assertNotEqual(result.exit_code, 0)
117
+
118
+
119
+ class DnsProtocolTests(unittest.IsolatedAsyncioTestCase):
120
+ @patch('portacode.connection.handlers.domain_dns.manage_dns', return_value={'records': []})
121
+ async def test_response_and_error_keep_request_correlation(self, manage):
122
+ channel = MagicMock()
123
+ channel.send = AsyncMock()
124
+ handler = DomainDnsHandler(channel, {})
125
+ await handler.handle({'action':'list', 'domain':'example.com', 'request_id':'unique-request'})
126
+ self.assertEqual(channel.send.call_args.args[0]['request_id'], 'unique-request')
127
+ manage.side_effect = ValueError('Domain mismatch')
128
+ await handler.handle({'action':'list', 'domain':'example.com', 'request_id':'failed-request'})
129
+ self.assertEqual(channel.send.call_args.args[0]['request_id'], 'failed-request')
130
+ self.assertEqual(channel.send.call_args.args[0]['event'], 'error')
131
+
132
+
133
+ if __name__ == '__main__':
134
+ unittest.main()
@@ -86,6 +86,7 @@ from .handlers import (
86
86
  CloudflareTunnelSetupHandler,
87
87
  CloudflareForwardingHandler,
88
88
  CloudflareAccessHandler,
89
+ DomainDnsHandler,
89
90
  ConfigureProxmoxContainerExposePortsHandler,
90
91
  AutomationV2StartHandler,
91
92
  AutomationV2StateHandler,
@@ -633,6 +634,7 @@ class TerminalManager:
633
634
  self._command_registry.register(CloudflareTunnelSetupHandler)
634
635
  self._command_registry.register(CloudflareForwardingHandler)
635
636
  self._command_registry.register(CloudflareAccessHandler)
637
+ self._command_registry.register(DomainDnsHandler)
636
638
  self._command_registry.register(ConfigureProxmoxContainerExposePortsHandler)
637
639
  self._command_registry.register(UpdatePortacodeHandler)
638
640
  self._command_registry.register(AutomationV2StartHandler)
@@ -0,0 +1,27 @@
1
+ """Local interface to the same structured DNS operations used over WebSocket."""
2
+ import json
3
+ import click
4
+ from .tunneling.dns import manage_dns, TYPES
5
+
6
+
7
+ @click.command('domain-dns')
8
+ @click.argument('action', type=click.Choice(['list', 'get', 'create', 'update', 'delete']))
9
+ @click.option('--domain', required=True, help='The currently connected Cloudflare domain.')
10
+ @click.option('--record-id')
11
+ @click.option('--record-json', help='Record object for create/update (full desired record).')
12
+ @click.option('--name', help='Exact fully qualified record-name filter, or @ for the apex.')
13
+ @click.option('--record-type', type=click.Choice(sorted(TYPES)))
14
+ @click.option('--page', default=1, type=int)
15
+ @click.option('--per-page', default=100, type=int)
16
+ @click.option('--if-match', help='modified_on value from the most recent record read.')
17
+ @click.option('--confirm-delete', is_flag=True)
18
+ def domain_dns(action, domain, record_id, record_json, name, record_type, page, per_page, if_match, confirm_delete):
19
+ """Manage connected-domain DNS. Run as the Portacode service user."""
20
+ try:
21
+ result = manage_dns(action=action, domain=domain, record_id=record_id,
22
+ record=json.loads(record_json) if record_json is not None else None,
23
+ name=name, record_type=record_type, page=page, per_page=per_page,
24
+ if_match=if_match, confirm_delete=confirm_delete)
25
+ except (ValueError, RuntimeError) as exc:
26
+ raise click.ClickException(str(exc)) from None
27
+ click.echo(json.dumps(result, indent=2))
@@ -0,0 +1,177 @@
1
+ """Structured DNS operations using the connected domain's local login credential."""
2
+ from __future__ import annotations
3
+
4
+ import ipaddress
5
+ import json
6
+ import re
7
+ import threading
8
+ import urllib.error
9
+ import urllib.parse
10
+ import urllib.request
11
+
12
+ from .get_domain import extract_token_json
13
+ from .state import default_cert_path, load_state
14
+
15
+ TYPES = frozenset({'A', 'AAAA', 'CNAME', 'MX', 'TXT', 'NS', 'PTR', 'SRV', 'CAA'})
16
+ FIELDS = frozenset({'type', 'name', 'content', 'ttl', 'priority', 'proxied', 'data', 'comment', 'tags'})
17
+ READ_FIELDS = FIELDS | {'id', 'created_on', 'modified_on', 'proxiable'}
18
+ _LOCK = threading.RLock()
19
+
20
+
21
+ def domain_name(value):
22
+ if not isinstance(value, str):
23
+ raise ValueError('A domain name is required.')
24
+ try:
25
+ name = value.strip().rstrip('.').encode('idna').decode('ascii').lower()
26
+ except UnicodeError:
27
+ raise ValueError('Invalid domain name.') from None
28
+ if len(name) > 253 or not name or any(not re.fullmatch(r'[a-z0-9_-]{1,63}|\*', label) for label in name.split('.')):
29
+ raise ValueError('Invalid domain name.')
30
+ if '*' in name and (not name.startswith('*.') or name.count('*') != 1):
31
+ raise ValueError('Wildcard must be the first label.')
32
+ return name
33
+
34
+
35
+ def scoped_name(value, domain):
36
+ name = domain if value == '@' else domain_name(value)
37
+ if name != domain and not name.endswith('.' + domain):
38
+ raise ValueError('DNS records must belong to the connected domain.')
39
+ return name
40
+
41
+
42
+ def normalize_record(record, domain):
43
+ if not isinstance(record, dict) or set(record) - FIELDS:
44
+ raise ValueError('Invalid DNS record fields.')
45
+ result = dict(record)
46
+ kind = result.get('type')
47
+ if kind not in TYPES:
48
+ raise ValueError('Unsupported DNS record type.')
49
+ result['name'] = scoped_name(result.get('name'), domain)
50
+ ttl = result.setdefault('ttl', 1)
51
+ if type(ttl) is not int or not (ttl == 1 or 60 <= ttl <= 86400):
52
+ raise ValueError('TTL must be 1 (automatic), or 60–86400 seconds.')
53
+ if 'proxied' in result and (type(result['proxied']) is not bool or (result['proxied'] and kind not in {'A', 'AAAA', 'CNAME'})):
54
+ raise ValueError('Only A, AAAA and CNAME records can be proxied.')
55
+ if kind in {'CAA', 'SRV'}:
56
+ data = result.get('data')
57
+ allowed = {'flags', 'tag', 'value'} if kind == 'CAA' else {'priority', 'weight', 'port', 'target', 'service', 'proto', 'name'}
58
+ if not isinstance(data, dict) or set(data) - allowed or not data:
59
+ raise ValueError('Invalid structured DNS record data.')
60
+ if 'name' in data:
61
+ data = dict(data, name=scoped_name(data['name'], domain))
62
+ result['data'] = data
63
+ else:
64
+ if 'data' in result:
65
+ raise ValueError('This DNS record type does not accept structured data.')
66
+ content = result.get('content')
67
+ if not isinstance(content, str) or not content or len(content) > 8192 or '\x00' in content:
68
+ raise ValueError('Record content is required (maximum 8192 characters).')
69
+ if kind in {'A', 'AAAA'}:
70
+ try:
71
+ addr = ipaddress.ip_address(content)
72
+ if addr.version != (4 if kind == 'A' else 6):
73
+ raise ValueError()
74
+ result['content'] = str(addr)
75
+ except ValueError:
76
+ raise ValueError('Invalid IP address for this record type.') from None
77
+ elif kind in {'CNAME', 'MX', 'NS', 'PTR'}:
78
+ result['content'] = domain_name(content)
79
+ if kind == 'MX' or 'priority' in result:
80
+ if type(result.get('priority')) is not int or not 0 <= result['priority'] <= 65535:
81
+ raise ValueError('Record priority must be between 0 and 65535.')
82
+ if 'comment' in result and (not isinstance(result['comment'], str) or len(result['comment']) > 500):
83
+ raise ValueError('Invalid record comment.')
84
+ if 'tags' in result and (not isinstance(result['tags'], list) or len(result['tags']) > 20 or any(not isinstance(tag, str) or len(tag) > 200 for tag in result['tags'])):
85
+ raise ValueError('Invalid record tags.')
86
+ if len(json.dumps(result)) > 16384:
87
+ raise ValueError('DNS record is too large.')
88
+ return result
89
+
90
+
91
+ class DnsClient:
92
+ def __init__(self, domain):
93
+ state = load_state()
94
+ self.domain = domain_name(domain)
95
+ if domain_name(state.get('domain')) != self.domain or not state.get('tunnel_id'):
96
+ raise ValueError('The requested domain does not match the connected domain.')
97
+ try:
98
+ credential = extract_token_json(str(state.get('cert_path') or default_cert_path()))
99
+ except Exception:
100
+ raise ValueError('Cloudflare login credential unavailable. Reconnect the domain.') from None
101
+ self._token = credential.get('apiToken')
102
+ zone = credential.get('zoneID')
103
+ if not isinstance(zone, str) or not re.fullmatch(r'[a-fA-F0-9]{32}', zone) or not self._token:
104
+ raise ValueError('Cloudflare login credential is incomplete. Reconnect the domain.')
105
+ self.base = '/zones/' + zone
106
+ zone_data = self.request('GET', '')['result']
107
+ if domain_name(zone_data.get('name')) != self.domain:
108
+ raise ValueError('Cloudflare credential belongs to a different domain.')
109
+
110
+ def request(self, method, suffix, payload=None):
111
+ request = urllib.request.Request('https://api.cloudflare.com/client/v4' + self.base + suffix,
112
+ method=method, data=json.dumps(payload).encode() if payload is not None else None,
113
+ headers={'Authorization': 'Bearer ' + self._token, 'Content-Type': 'application/json'})
114
+ try:
115
+ with urllib.request.urlopen(request, timeout=15) as response:
116
+ value = json.load(response)
117
+ except urllib.error.HTTPError as exc:
118
+ # Do not relay provider bodies, request headers or credentials.
119
+ raise RuntimeError('Cloudflare DNS request failed (HTTP %s).' % exc.code) from None
120
+ except (OSError, ValueError):
121
+ raise RuntimeError('Cloudflare DNS is unavailable; check record state before retrying a change.') from None
122
+ if not isinstance(value, dict) or not value.get('success'):
123
+ raise RuntimeError('Cloudflare rejected the DNS operation.')
124
+ return value
125
+
126
+ def record(self, record_id):
127
+ if not isinstance(record_id, str) or not re.fullmatch(r'[a-fA-F0-9]{32}', record_id):
128
+ raise ValueError('Invalid DNS record ID.')
129
+ row = self.request('GET', '/dns_records/' + record_id)['result']
130
+ scoped_name(row.get('name'), self.domain)
131
+ return row
132
+
133
+
134
+ def public_record(row):
135
+ return {key: value for key, value in row.items() if key in READ_FIELDS}
136
+
137
+
138
+ def manage_dns(*, action, domain, record=None, record_id=None, name=None, record_type=None,
139
+ page=1, per_page=100, if_match=None, confirm_delete=False):
140
+ if action not in {'list', 'get', 'create', 'update', 'delete'}:
141
+ raise ValueError('Unsupported DNS action.')
142
+ domain = domain_name(domain)
143
+ if action in {'update', 'delete'} and (not isinstance(if_match, str) or not if_match):
144
+ raise ValueError('Read the record first and supply its modified_on value as if_match.')
145
+ if action == 'delete' and confirm_delete is not True:
146
+ raise ValueError('Explicit confirmation is required to delete a DNS record.')
147
+ desired = normalize_record(record, domain) if action in {'create', 'update'} else None
148
+ if type(page) is not int or page < 1 or type(per_page) is not int or not 1 <= per_page <= 100:
149
+ raise ValueError('Invalid DNS pagination.')
150
+ filters = {'page': page, 'per_page': per_page}
151
+ if name is not None:
152
+ filters['name'] = scoped_name(name, domain)
153
+ if record_type is not None:
154
+ if record_type not in TYPES:
155
+ raise ValueError('Unsupported DNS record type.')
156
+ filters['type'] = record_type
157
+ with _LOCK:
158
+ client = DnsClient(domain)
159
+ if action == 'list':
160
+ data = client.request('GET', '/dns_records?' + urllib.parse.urlencode(filters))
161
+ rows = data.get('result', [])
162
+ for row in rows:
163
+ scoped_name(row.get('name'), domain)
164
+ return {'records': [public_record(row) for row in rows], 'pagination': data.get('result_info', {})}
165
+ if action == 'get':
166
+ return {'record': public_record(client.record(record_id))}
167
+ if action == 'create':
168
+ row = client.request('POST', '/dns_records', desired)['result']
169
+ return {'record': public_record(row)}
170
+ existing = client.record(record_id)
171
+ if existing.get('modified_on') != if_match:
172
+ raise ValueError('DNS record changed since it was read. Refresh before modifying it.')
173
+ if action == 'delete':
174
+ client.request('DELETE', '/dns_records/' + record_id)
175
+ return {'deleted': True, 'record_id': record_id}
176
+ row = client.request('PATCH', '/dns_records/' + record_id, desired)['result']
177
+ return {'record': public_record(row)}
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: portacode
3
- Version: 2.2.28.dev4
3
+ Version: 2.2.29.dev0
4
4
  Summary: Device agent for the AI platform that builds, tests, deploys, and operates real software
5
5
  Home-page: https://portacode.com/
6
6
  Author: Meena Erian
@@ -18,6 +18,7 @@ docs/cloudflared-domain-connect-containers-audit.md
18
18
  docs/creative-team-brief-portacode.md
19
19
  docs/device-health-alerting-plan.md
20
20
  docs/devops-messaging-ab-tests.md
21
+ docs/domain-dns.md
21
22
  docs/guest-host-requests-plan.md
22
23
  docs/homepage-dashboard-positioning-fixes.md
23
24
  docs/template-guide.html
@@ -59,6 +60,7 @@ portacode/codex_loopback_proxy.py
59
60
  portacode/codex_prepare.py
60
61
  portacode/codex_usage_limit.py
61
62
  portacode/data.py
63
+ portacode/dns_cli.py
62
64
  portacode/exit_codes.py
63
65
  portacode/github_credential.py
64
66
  portacode/image_cli.py
@@ -108,6 +110,7 @@ portacode/connection/handlers/cloudflare_forwarding.py
108
110
  portacode/connection/handlers/cloudflare_tunnel.py
109
111
  portacode/connection/handlers/codex_handlers.py
110
112
  portacode/connection/handlers/diff_handlers.py
113
+ portacode/connection/handlers/domain_dns.py
111
114
  portacode/connection/handlers/file_handlers.py
112
115
  portacode/connection/handlers/file_transfer_handlers.py
113
116
  portacode/connection/handlers/git_handlers.py
@@ -124,6 +127,7 @@ portacode/connection/handlers/terminal_handlers.py
124
127
  portacode/connection/handlers/test_browser_handlers.py
125
128
  portacode/connection/handlers/test_cloudflare_access.py
126
129
  portacode/connection/handlers/test_cloudflare_forwarding.py
130
+ portacode/connection/handlers/test_domain_dns.py
127
131
  portacode/connection/handlers/test_file_move_copy.py
128
132
  portacode/connection/handlers/test_git_handlers.py
129
133
  portacode/connection/handlers/test_proxmox_infra.py
@@ -178,6 +182,7 @@ portacode/tests/test_terminal_session_shell.py
178
182
  portacode/tunneling/__init__.py
179
183
  portacode/tunneling/access.py
180
184
  portacode/tunneling/cloudflared_login.py
185
+ portacode/tunneling/dns.py
181
186
  portacode/tunneling/ensure_cloudflared.py
182
187
  portacode/tunneling/ensure_pyyaml.py
183
188
  portacode/tunneling/forwarding_state.py
@@ -13,6 +13,7 @@
13
13
  "docs/creative-team-brief-portacode.md",
14
14
  "docs/device-health-alerting-plan.md",
15
15
  "docs/devops-messaging-ab-tests.md",
16
+ "docs/domain-dns.md",
16
17
  "docs/guest-host-requests-plan.md",
17
18
  "docs/homepage-dashboard-positioning-fixes.md",
18
19
  "docs/template-guide.html",
@@ -73,6 +74,7 @@
73
74
  "portacode/connection/handlers/cloudflare_tunnel.py",
74
75
  "portacode/connection/handlers/codex_handlers.py",
75
76
  "portacode/connection/handlers/diff_handlers.py",
77
+ "portacode/connection/handlers/domain_dns.py",
76
78
  "portacode/connection/handlers/file_handlers.py",
77
79
  "portacode/connection/handlers/file_transfer_handlers.py",
78
80
  "portacode/connection/handlers/git_handlers.py",
@@ -99,6 +101,7 @@
99
101
  "portacode/connection/handlers/test_browser_handlers.py",
100
102
  "portacode/connection/handlers/test_cloudflare_access.py",
101
103
  "portacode/connection/handlers/test_cloudflare_forwarding.py",
104
+ "portacode/connection/handlers/test_domain_dns.py",
102
105
  "portacode/connection/handlers/test_file_move_copy.py",
103
106
  "portacode/connection/handlers/test_git_handlers.py",
104
107
  "portacode/connection/handlers/test_proxmox_infra.py",
@@ -111,6 +114,7 @@
111
114
  "portacode/connection/test_webmin_proxy_config.py",
112
115
  "portacode/connection/webmin_proxy_config.py",
113
116
  "portacode/data.py",
117
+ "portacode/dns_cli.py",
114
118
  "portacode/exit_codes.py",
115
119
  "portacode/github_credential.py",
116
120
  "portacode/image_cli.py",
@@ -164,6 +168,7 @@
164
168
  "portacode/tunneling/__init__.py",
165
169
  "portacode/tunneling/access.py",
166
170
  "portacode/tunneling/cloudflared_login.py",
171
+ "portacode/tunneling/dns.py",
167
172
  "portacode/tunneling/ensure_cloudflared.py",
168
173
  "portacode/tunneling/ensure_pyyaml.py",
169
174
  "portacode/tunneling/forwarding_state.py",
File without changes