Skip to content

HostSpark v0.4.3

Choose a tag to compare

@gemini960114 gemini960114 released this 04 Sep 02:00
· 4 commits to main since this release

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.md directly 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 nohup tunnels are terminated by the agent environment's process reaper when awaiting user input or on context reset. Promoted Docker containerization (cloudflare/cloudflared:latest with --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.com tunnels 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.sh to 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 urlparse to prevent handler crashes on complex markdown links with query parameters or relative paths (2167a68).

⚙️ Configuration & Documentation

  • Streaming Verbosity (AGY_VERBOSE): Documented AGY_VERBOSE in .env.example and README.md (detailed for full thinking traces, compact for single-line summaries, silent to 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.sh

The install script will automatically sync the bundled skills to your global AGY configuration and restart the service.