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.
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/PKG-INFO +1 -1
- portacode-2.2.29.dev0/docs/domain-dns.md +62 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/_version.py +2 -2
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/cli.py +2 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/__init__.py +2 -0
- portacode-2.2.29.dev0/portacode/connection/handlers/domain_dns.py +16 -0
- portacode-2.2.29.dev0/portacode/connection/handlers/test_domain_dns.py +134 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/terminal.py +2 -0
- portacode-2.2.29.dev0/portacode/dns_cli.py +27 -0
- portacode-2.2.29.dev0/portacode/tunneling/dns.py +177 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/PKG-INFO +1 -1
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/SOURCES.txt +5 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/scm_file_list.json +5 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/.gitignore +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/LICENSE +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/MANIFEST.in +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/Makefile +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/build_android.sh +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/connect.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/connect.sh +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/cloudflare-access.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/cloudflared-domain-connect-containers-audit.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/creative-team-brief-portacode.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/device-health-alerting-plan.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/devops-messaging-ab-tests.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/guest-host-requests-plan.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/homepage-dashboard-positioning-fixes.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/template-guide.html +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/simple_device/Dockerfile +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/simple_device/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/simple_device/docker-compose.yaml +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/Dockerfile +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/docker-compose.yaml +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/asgi.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/settings.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/urls.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/galactic_bakeshop/wsgi.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/manage.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/requirements.txt +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/templates/treats/home.html +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/admin.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/apps.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/menu.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/migrations/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/models.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/tests.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/urls.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/treats/views.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/instructions/WELCOME.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/__main__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-github/SKILL.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-github/agents/openai.yaml +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-github/scripts/create_repository.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-image/SKILL.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/assets/skills/portacode-image/agents/openai.yaml +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/browser_cli.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/browser_prepare.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/browser_runtime.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/codex_loopback_proxy.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/codex_prepare.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/codex_usage_limit.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/client.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/codex_app_server.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/guest_host_protocol.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/WEBSOCKET_PROTOCOL.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/automation_v2_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/base.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/browser_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/chunked_content.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/cloudflare_forwarding.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/cloudflare_tunnel.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/codex_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/diff_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/file_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/file_transfer_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/git_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_aware_file_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/file_system_watcher.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/git_manager.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/manager.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/models.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/test_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/test_sync.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state/utils.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/project_state_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/proxmox_infra.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/registry.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/resumable_transfer_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/runtime_user.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/session.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/system_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/tab_factory.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/terminal_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_browser_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_cloudflare_access.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_cloudflare_forwarding.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_file_move_copy.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_git_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_proxmox_infra.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/test_runtime_user.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/handlers/update_handler.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/multiplex.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/test_guest_host_protocol.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/test_guest_host_terminal.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/test_webmin_proxy_config.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/connection/webmin_proxy_config.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/data.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/exit_codes.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/github_credential.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/image_cli.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/keypair.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/elinks +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/gio-open +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/gnome-open +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/gvfs-open +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/kde-open +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/kfmclient +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/link_capture_exec.sh +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/link_capture_wrapper.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/links +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/links2 +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/lynx +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/mate-open +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/netsurf +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/sensible-browser +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/w3m +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/x-www-browser +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/link_capture/bin/xdg-open +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/logging_categories.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/pairing.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/provisioning_cache.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/restart.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/service.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/singleton.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/static/js/test-ntp-clock.html +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/static/js/utils/ntp-clock.js +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_runtime_paths.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_service.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_singleton.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/test_terminal_exposed_services.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_automation_v2_inputs.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_browser_cli.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_browser_prepare.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_cli_service_logs.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_app_server.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_loopback_proxy.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_prepare.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_codex_prepare_cli.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_github_credential.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_image_cli.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_image_read_handler.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_resumable_transfer_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_system_handlers.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_terminal_periodic_system_info.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tests/test_terminal_session_shell.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/access.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/cloudflared_login.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/ensure_cloudflared.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/ensure_pyyaml.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/forwarding_state.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/get_domain.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/privileged.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/service_install.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/tunneling/state.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/updater.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/NTP_ARCHITECTURE.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/diff_apply.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/diff_renderer.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/ntp_clock.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode/utils/runtime_paths.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/dependency_links.txt +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/entry_points.txt +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/requires.txt +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/portacode.egg-info/top_level.txt +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/pyproject.toml +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/run_tests.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/scripts/diagnose_codex_gateway.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/setup.cfg +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/setup.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test.sh +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_device_online.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_file_operations.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_git_status_ui.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_login_flow.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_navigate_testing_folder.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_play_store_screenshots.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_buffer_performance.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_interaction.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_loading_race_condition.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_modules/test_terminal_start.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_request_id.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/test_session_terminal_shutdown.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/.env.example +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/README.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/cli.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/__init__.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/base_test.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/cli_manager.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/hierarchical_runner.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/playwright_manager.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/runner.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/shared_cli_manager.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/core/test_discovery.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/testing_framework/requirements.txt +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/UI_UX/opening_a_file_on_desktop_results_in_nothing.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/UI_UX/server_occasionally_stops_communicating_with_all_devices.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/agent_context_management.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/django_server_time_sync.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/device_performance_degradation.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/git_data_not_captured_in_proxmox.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/indefinite_resource_loading.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/portacode_service_silently_down.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/premature_terminal_exit.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/project_cpu_hotspots.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/terminals_exit_upon_starting.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/websocket_client_silently_dead.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/issues/wrong_item_classification_on_client_side.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/todo/smartphone_terminal_input_frustrations.md +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/generate_play_store_assets.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/pairing_tester.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/run_screenshot_suite.sh +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/tools/test_python_ntp_clock.py +0 -0
- {portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/validate.sh +0 -0
|
@@ -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.
|
|
22
|
-
__version_tuple__ = version_tuple = (2, 2,
|
|
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
|
|
@@ -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)}
|
|
@@ -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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/cloudflared-domain-connect-containers-audit.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/docs/homepage-dashboard-positioning-fixes.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{portacode-2.2.28.dev4 → portacode-2.2.29.dev0}/examples/workshop_fleet/initial_content/README.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|