dsh-hyper-tools
使 Charm Hyper 请求保持在网关 10 MiB 的请求体上限以内：发送前将最旧的图像替换为占位符（保留最新图像）；如果网关仍拒绝该请求体，则使用更严格的投影重试。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:samuelrubiodev/dsh-hyper-tools#08c09324a9959dfd95b22259a00b723dccfef6bdHyper Tools 以 dsh-hyper-tools 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Keeps Charm Hyper model requests under the gateway's strict 10 MiB request-body cap.
Charm Hyper's HTTP gateway (Google Frontend in front of a Go backend) rejects any request body above 10 MiB with:
{ "error": { "message": "invalid request body", "type": "invalid_request_error", "code": null } }
Long conversations accumulate images, and every image is inlined as a base64 image_url part. Once the serialized body crosses the cap, the whole request fails before inference — even though the images are ordinary attachments. This plugin registers one llm/stream middleware for the configured Charm Hyper provider routes:
maxRequestImageBytes (default 6 MiB). The oldest images become the harness-standard deterministic placeholders ([image omitted to fit request image limits; …]) and the newest images stay. A request that already fits is dispatched untouched through next() — no extra provider attempt.invalid request body failure and re-dispatches once with the image budget multiplied by recoveryBudgetFactor (default 0.5), which replaces more of the oldest images. If a tighter projection cannot remove anything further, the original failure is surfaced unchanged.Accounting and placeholders come from the harness itself (offloadRequestImagesWithPolicy, offloadedImageText): base64 length of every image occurrence — nested tool-result images included — and the same deterministic placeholder text shipped adapters use.
Checked live against https://hyper.charm.land/v1 (deepseek-v4.1-flash, six 1024×683 PNG screenshots):
| Request | Serialized body | Result |
|---|---|---|
| Accumulated images, unprojected | 16,794,575 bytes | 400 invalid request body |
| Same history projected by this plugin | 5,599,267 bytes (4 oldest images replaced) | 200 OK |
The gateway cap was measured at 10 MiB (10,485,760 bytes): a 10,400,000-byte body passes the gateway, a 10,490,000-byte body is rejected. scripts/probe-hyper.py reproduces the probe; tests/live.test.ts reproduces the table above.
dsh plugin --profile <profile> add dsh-hyper-tools
From a checkout or tarball:
dsh plugin --profile <profile> add ./dsh-hyper-tools
# or
npm pack && dsh plugin --profile <profile> add ./dsh-hyper-tools-0.1.0.tgz
From git (the built lib/ is committed, so pnpm needs no build permission):
dsh plugin --profile <profile> add github:samuelrubiodev/dsh-hyper-tools#main
The bundle patch (cordis.patch.yml) inserts one row (hyper-tools).
Every field is optional; the row config carries them.
| Field | Default | Meaning |
|---|---|---|
providers | ['charm-hyper', 'hyper'] | Provider routes to guard; matching is case-insensitive. |
maxRequestImageBytes | 6291456 (6 MiB) | Aggregate base64 image payload one request may carry. |
maxImagesPerRequest | absent | Optional bound on images per request. |
recovery | true | Retry once when the gateway rejects the body. |
recoveryBudgetFactor | 0.5 | Image-budget multiplier for the recovery retry. |
byteQuantum | 1 | Whole-step removal quantum for byte overflow; 1 keeps the newest retainable images. |
countQuantum | 1 | Whole-step removal quantum for count overflow. |
- id: hyper-tools
name: 'dsh-hyper-tools'
config:
providers: ['charm-hyper']
maxRequestImageBytes: 6291456
attachment.bytes); any provider-side re-encode only makes the actual payload smaller, so the estimate errs toward replacing slightly early.providers are touched; every other provider request passes through untouched.GenerateOptions.provider, so it guards Charm Hyper whether it is served by @deepseek-ai/dsh-llm-pi-ai, a custom gateway adapter, or anything else.npm ci
npm run typecheck
npm test # unit + integration against the real cordis + @deepseek-ai/dsh-llm runtime
npm run build
HYPER_API_KEY=... npx vitest run tests/live.test.ts # live check against Charm Hyper
The compiled lib/ is committed so github: installs need no build step; npm pack / npm publish refresh it through prepack.
Compatibility: @deepseek-ai/dsh-llm ^0.1.5-rc.1, @deepseek-ai/cordis ^4.0.1.