Repository navigation
HostSpark v0.4.3
What's Changed in HostSpark v0.4.3
A stability and capability release bundling our official Web Service Deployment & Cloudflare Tunnel Skill, introducing Docker-based persistent tunnel management to eliminate Error 1033, auto-syncing skills on install, fixing a markdown link crash in media detection, and refining streaming verbosity configuration.
🚀 Bundled web-service-deployer Skill & Persistent Docker Tunnel
- Out-of-the-Box Server Deployment Skill: Added
skills/web-service-deployer/SKILL.mddirectly into the repository. Teaches the AI assistant to safely deploy web apps (Vite, React, Vue, Flask, FastAPI, Express, Docker) without terminal blocking. - Docker Persistent Tunnel Architecture (Eliminates Error 1033): Addressed the critical issue where host-level
nohuptunnels are terminated by the agent environment's process reaper when awaiting user input or on context reset. Promoted Docker containerization (cloudflare/cloudflared:latestwith--restart unless-stopped) as the golden standard for both container networks and host port proxying (--net=host). - Zero-Blocking Architecture: Enforces background detachment to prevent headless Telegram bot sessions from locking up when running dev servers.
- Instant Mobile Previews via Cloudflare Quick Tunnel: AI automatically provisions
*.trycloudflare.comtunnels for zero-config public HTTPS testing on mobile devices. - Error 1033 Troubleshooting & Lifecycle Documentation: Added diagnostic instructions for Cloudflare Tunnel
Error 1033(daemon disconnected/terminated) and explained the ephemeral lifecycle of quick tunnels along with Anycast PoP routing (location=hkg09/location=tpe01). - Automatic Skill Sync: Updated
install.shto automatically install all bundled skills into~/.gemini/config/skills/on initial setup or upgrade.
🐛 Bug Fixes & Stability
- Media Link Parsing: Hardened URL extraction regex and added safety wrappers around
urlparseto prevent handler crashes on complex markdown links with query parameters or relative paths (2167a68).
⚙️ Configuration & Documentation
- Streaming Verbosity (
AGY_VERBOSE): DocumentedAGY_VERBOSEin.env.exampleandREADME.md(detailedfor full thinking traces,compactfor single-line summaries,silentto disable). - Progress Reporting Alignment: Clarified valid values for
AGY_PROGRESS_MODE(full,compact,delete). - Rule Prompt Recommendations: Added daemon backgrounding guidance to the default
AGY_RULE_PROMPT.
📦 Upgrade Notes
To upgrade an existing HostSpark installation to v0.4.3:
git pull origin main
./install.shThe install script will automatically sync the bundled skills to your global AGY configuration and restart the service.