Skip to content

docs: dsh 0.1.0-rc.7: streaming ReplayEnvelope protocol, batch image attachment API, reasoningEffort 'low' - #15

Open
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/sync
Open

docs: dsh 0.1.0-rc.7: streaming ReplayEnvelope protocol, batch image attachment API, reasoningEffort 'low'#15
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/sync

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

The dsh mirror took a full refresh (fetched 2026-08-18 vs 2026-08-13) that tracks a new CLI release, @deepseek-ai/dsh@0.1.0-rc.7 (published 2026-08-17). This is not doc-only churn: the release lands several interface-level changes across the harness — the LLM streaming replay-state protocol, the attachment service surface, and the plugin config schema — plus a brand-new extension cookbook page. dsh is a developer preview that breaks things without migration paths, so plugin and adapter authors should treat these as potentially breaking.

  • Streaming replay-state is now a structured ReplayEnvelope, not opaque JSON. The finish chunk's replayState field (and BlockAssembler.replayState) changed from unknown to a typed envelope holding response-level metadata plus optional per-block entries aligned with the emitted blocks. Assembly prunes content and metadata with a single keep/drop decision (e.g. a max-tokens finish drops tool calls and the matching envelope entries), so stored metadata always describes stored content and the two can't disagree. LLM adapter authors must now emit/consume ReplayEnvelope; an adapter that can't use a stored state degrades that one message to provider-neutral conversion with a diagnostic instead of failing the request.
  • ImageAttachmentService gains a batch saveImages() method — validates one ordered image batch before committing any member, returns durable references in exact input order, and never surfaces partial references on storage failure (already-published content-addressed objects may linger until a future retention policy). acp and mcp-client both gained a dependency on the attachment package, so ACP/MCP image flows are the likely consumers.
  • reasoningEffort config now accepts 'low' (config-catalog.md), a new valid value for the deployment thinking policy alongside off | high | max.
  • New cookbook: adding a settings card — a plugin can now register its own configuration card on the web settings page through a settings.plugin.item slot, joined to a Host-side settingsNamespace. New page is indexed in llms.txt and the extension-cookbook index.
  • run_code tool now attaches image-bearing subtool results after the run; tool docs updated to describe images as part of program output.
  • Watch item: .metadata.json now flags content/en/news/news251201.md ("DeepSeek-V3.2 Release") as serving the SPA fallback shell — the upstream news page may have been removed or renamed. The mirrored file itself is unchanged for now.
  • Minor: snapshot-testing policy extends coverage to the TypeScript and Python SDKs (examples/jsonrpc-agent, scripts/snapshots/python-sdk-single-exe/); the user guide links the DeepSeek API-key page.

@github-actions github-actions Bot changed the title docs: dsh 0.1.0-rc.7: plugin settings cards, ReplayEnvelope, saveImages batch API, reasoning 'low' docs: dsh 0.1.0-rc.7: replay envelope, batch image saves, low reasoning effort Aug 17, 2026
@github-actions
github-actions Bot force-pushed the docs/sync branch 2 times, most recently from b7b7762 to 8b6ff54 Compare August 18, 2026 01:54
@github-actions github-actions Bot changed the title docs: dsh 0.1.0-rc.7: replay envelope, batch image saves, low reasoning effort docs: dsh 0.1.0-rc.7: settings-card cookbook, reasoningEffort 'low', batch image save, structured replay envelopes Aug 18, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.0-rc.7: settings-card cookbook, reasoningEffort 'low', batch image save, structured replay envelopes docs: dsh 0.1.0-rc.7: ReplayEnvelope streaming format, batch image saves, settings-card cookbook Aug 18, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.0-rc.7: ReplayEnvelope streaming format, batch image saves, settings-card cookbook docs: dsh 0.1.0-rc.7: ReplayEnvelope, saveImages batch API, low reasoning effort Aug 18, 2026
…attachment API, reasoningEffort 'low'

The dsh mirror took a full refresh (fetched 2026-08-18 vs 2026-08-13) that tracks a new CLI release, `@deepseek-ai/dsh@0.1.0-rc.7` (published 2026-08-17). This is not doc-only churn: the release lands several interface-level changes across the harness — the LLM streaming replay-state protocol, the attachment service surface, and the plugin config schema — plus a brand-new extension cookbook page. dsh is a developer preview that breaks things without migration paths, so plugin and adapter authors should treat these as potentially breaking.

- **Streaming replay-state is now a structured `ReplayEnvelope`, not opaque JSON.** The `finish` chunk's `replayState` field (and `BlockAssembler.replayState`) changed from `unknown` to a typed envelope holding response-level metadata plus optional per-block entries aligned with the emitted blocks. Assembly prunes content and metadata with a single keep/drop decision (e.g. a `max-tokens` finish drops tool calls and the matching envelope entries), so stored metadata always describes stored content and the two can't disagree. LLM adapter authors must now emit/consume `ReplayEnvelope`; an adapter that can't use a stored state degrades that one message to provider-neutral conversion with a diagnostic instead of failing the request.
- **`ImageAttachmentService` gains a batch `saveImages()` method** — validates one ordered image batch before committing any member, returns durable references in exact input order, and never surfaces partial references on storage failure (already-published content-addressed objects may linger until a future retention policy). `acp` and `mcp-client` both gained a dependency on the `attachment` package, so ACP/MCP image flows are the likely consumers.
- **`reasoningEffort` config now accepts `'low'`** (config-catalog.md), a new valid value for the deployment thinking policy alongside `off | high | max`.
- **New cookbook: adding a settings card** — a plugin can now register its own configuration card on the web settings page through a `settings.plugin.item` slot, joined to a Host-side `settingsNamespace`. New page is indexed in llms.txt and the extension-cookbook index.
- **`run_code` tool now attaches image-bearing subtool results** after the run; tool docs updated to describe images as part of program output.
- Watch item: `.metadata.json` now flags `content/en/news/news251201.md` ("DeepSeek-V3.2 Release") as serving the SPA fallback shell — the upstream news page may have been removed or renamed. The mirrored file itself is unchanged for now.
- Minor: snapshot-testing policy extends coverage to the TypeScript and Python SDKs (`examples/jsonrpc-agent`, `scripts/snapshots/python-sdk-single-exe/`); the user guide links the DeepSeek API-key page.
@github-actions github-actions Bot changed the title docs: dsh 0.1.0-rc.7: ReplayEnvelope, saveImages batch API, low reasoning effort docs: dsh 0.1.0-rc.7: streaming ReplayEnvelope protocol, batch image attachment API, reasoningEffort 'low' Aug 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants