deepseek-harness/docs
Yichen Jiang 2f481fa352 fix(apiproxy): echo the preset a created session runs, not its header
`session.create` also adopts an already-live session, and the preceding
commit newly allows adopting one under the preset it switched to while
blank. Its response still echoed `header.agentPreset`, so that adoption
answered with the preset the session had just left — contradicting the
request it had accepted and the row `session.list` serves for the same
session from `resolveSessionPreset()`. The echo now resolves the same way.

The `assertPresetUnchanged` parameter doc said `existing` was the preset
the session was created under; both callers now pass what it runs.

`composeFrom()` was documented as "infallible" and "cannot fail" beside two
`@throws`. It has no composition failure mode — no roster read, no mount, no
file — but it does reject a caller error, and the wording now says which.

The package-level "switched preset" test re-linked to the same preset id,
so it could not tell reading the parent's live scope chain from reading its
creation header. A second fixture preset makes the switch real.

The Web browser lane's subagent goldens gain the preset badge a child now
shows, which is the visible consequence of recording its composition. That
lane runs only under DSH_EXAMPLE_MODE=lib and was missed before.

The Agent Note records two limits found in review: a cold-resumed
continuable child joins its parent's current composition rather than the one
its header names, and `toolFilter` does not constrain a joined child. The
latter is a regression from the agent-plane move rather than anything this
change introduces — with the same tools in the global layer the filter
applies normally — and is tracked in #2185.

Refs #2185
2026-08-10 19:28:40 +08:00
..
cookbook docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
cordis-api docs: fix review findings — residual ordinals, hypothetical IPC row, citation-rule amendments 2026-08-09 21:10:59 +08:00
cordis-tutorial docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
i18n docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
postmortem docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
subsystems fix(apiproxy): echo the preset a created session runs, not its header 2026-08-10 19:28:40 +08:00
user docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
agent-lifecycle.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
agent-lifecycle.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
agent-lifecycle.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
AGENTS.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
api-gateway.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
api-gateway.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
api-gateway.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
architecture.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
architecture.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
architecture.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
capability-seams.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
capability-seams.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
capability-seams.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
config-catalog.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
config-catalog.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
config-catalog.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
cordis-paper.pdf docs: add cordis paper 2026-07-31 15:54:36 +08:00
cordis-primer.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
cordis-primer.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
cordis-primer.zh.md docs(i18n): standardize contract terminology 2026-08-09 11:33:14 +08:00
defensive-patterns.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
defensive-patterns.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
defensive-patterns.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
development.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
development.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
development.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
event-producer-consumer.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
event-producer-consumer.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
event-producer-consumer.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
glossary.i18n.yaml docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
glossary.md docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
glossary.zh.md docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
graph-atlas.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
graph-atlas.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
graph-atlas.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
module-graph.i18n.yaml Merge remote-tracking branch 'origin/master' into worktree/subagent-missing-tools-fb2359 2026-08-10 17:57:59 +08:00
module-graph.md Merge remote-tracking branch 'origin/master' into worktree/subagent-missing-tools-fb2359 2026-08-10 17:57:59 +08:00
module-graph.zh.md Merge remote-tracking branch 'origin/master' into worktree/subagent-missing-tools-fb2359 2026-08-10 17:57:59 +08:00
persistence-catalog.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
persistence-catalog.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
persistence-catalog.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
testing.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
testing.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
testing.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
tool-catalog.i18n.yaml Merge branch 'feat/windows-pwsh-default' into feat/windows-acl-sandbox 2026-08-09 23:19:14 +08:00
tool-catalog.md Merge branch 'feat/windows-pwsh-default' into feat/windows-acl-sandbox 2026-08-09 23:19:14 +08:00
tool-catalog.zh.md Merge branch 'feat/windows-pwsh-default' into feat/windows-acl-sandbox 2026-08-09 23:19:14 +08:00
tool-execution-pipeline.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
tool-execution-pipeline.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
tool-execution-pipeline.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
web-styling.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
web-styling.md docs: rescan rebased documentation hierarchy 2026-08-05 16:16:57 +08:00
web-styling.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00