# Development artifacts

Everything in this directory exists only for contributor workflows against a
[DeepSeek-Harness](https://github.com/deepseek-ai/deepseek-harness) source
checkout. None of it ships in the published npm packages.

> **Version scope:** these source patches target the `dsh-v0.2.1-rc.2` tag —
> the current desktop release line. The published packages support official
> `0.2.1-rc.2` and `0.2.1-rc.3` builds without a source patch; the WebUI
> registers through the official extensible right Sidebar. The repository test
> gate runs against the published `0.2.1-rc.3` packages, and the same suite is
> green against `0.2.1-rc.2`.

## `session-branch-surface.patch` — optional engine capability

Adds two things to `packages/core/session`:

- `Session.selectMessageSurface(nodes)` / `Session.messageSurfaceNodes()` — the
  branch-selected message surface used for true in-place model-history
  switching, and
- the durable `session-tree/*` event vocabulary in the session
  known-event-types table.

The rc.2 regeneration follows the release's generic `SurfaceIntent<T>` and the
first-class `ToolResultMessage.toolCallId` shape, and extends the selected path
from `Session.commit()` after the event enters the log.

**This patch is development-only.** The published packages never require it:
`@robiteame/dsh-pi-agent-session-tree` capability-detects the API at runtime
(`typeof session.selectMessageSurface === 'function'`). Without the patch the
plugin runs in stock-surface emulation mode on official builds (an official
empty `replace` surface event plus the plugin-owned sidecar; `/tree` outputs
report `surface: "stock"` and the Host log notes it once per session). With
the patch applied, jump/fork switch the model-visible history directly.

An upstream PR to merge this capability into DeepSeek-Harness is planned;
until it lands, apply the patch only in dev checkouts. *(upstream PR link:
TODO)*

## `harness.patch` — composition and registration

The remaining source-integration changes: `dsh-base`/`dsh-web-app` composition
rows and dependencies for the three packages, `tsconfig.base.json` paths, and
host/client project references. Rows reference the `@robiteame/*` package
names; project references point at each package's `tsconfig.harness.json`.
Current official WebUI builds already expose the right-Sidebar extension API,
so no UI source or generated catalog patch is needed.

## `install.sh` — source-integration installer

```sh
dev/install.sh /path/to/deepseek-harness
ST_NO_SURFACE=1 dev/install.sh /path/to/deepseek-harness   # skip the engine patch
```

Applies both patches (order matters: surface patch first, on upstream files),
copies the three packages and the session-tree docs into the checkout, then
`pnpm install && pnpm run build` as usual.

The bundle/user install path is entirely separate — see the repository
README.