zen-useragent

When using DeepSeek Harness (DSH) to access OpenCode ZEN free models, users frequently encounter a 429 FreeUsageLimitError that throttles their requests. This happens because DSH's default request headers identify the client as deepseek-harness, while OpenCode ZEN enforces strict rate limiting based on client type, allowing only opencode clients. This plugin addresses the issue by automatically patching DSH's request header handling, enabling user-configured headers like User-Agent to override the default attribution information. As a result, API requests are correctly identified as opencode clients, bypassing the rate limit. The plugin's core capability lies in its idempotent and self-healing mechanism: it disables the native entry point and inserts a wrapper module, ensuring the patch remains effective even after DSH upgrades without disrupting normal behavior for providers without custom headers. It is ideal for developers and users who rely on OpenCode ZEN free models for testing and development, especially those facing persistent 429 errors needing a quick and stable fix. With a focus on reliability, the plugin uses atomic writes and triple validation, requiring only simple configuration and a restart after installation for a seamless experience.