Files
deepseek-harness/examples/desktop/config/echo-jsonrpc.yml
ZiyaZhang e8f5c0b51b feat(desktop): DSH Electron desktop shell — harness internals visualized
Minimal Electron shell over the DSH JSON-RPC runtime — a first-look at
what a ChatGPT.app-style host on top of the DeepSeek Harness looks
like, with the harness's normally-invisible internals (trace timeline,
context surface, subagent tree, compaction, plugin registry, rubrics)
brought forward as first-class UI surfaces so plugin authors and
researchers can see what the agent is actually doing.

Runs against three keyless-to-live profiles (stdio-echo works on
master out of the box; daemon-echo / daemon-vibe-echo activate once
the daemon-demo lands; stdio-deepseek and daemon-vibe hit the real
DeepSeek API when you supply a key). HARNESS_DEV auto-resolves to the
in-repo runtime when this shell ships under examples/desktop/, so a
fresh clone launches without config; env DSH_DEV_ROOT overrides for
custom layouts, and a sibling deepseek-harness-dev/ checkout is the
original dev workflow.

Cold-clone gate (P0 fixes for first-time-clone usability):
- HARNESS_DEV: 3-candidate resolver (env → walk-up in-repo marker →
  sibling), unit-tested via mock fs so ordering is locked without
  needing either real layout on disk.
- config yml leaves rewritten at assemble time so the sibling-clone
  paths (../../deepseek-harness-dev/examples/echo-agent/…) become
  the in-repo paths (../../echo-agent/…) in the released tree —
  source yml stays usable for local dev, released tree ships a
  working shape.
- pnpm-workspace.yaml allowBuilds.electron = true (was placeholder).
- missing-key card in stdio-deepseek offers a one-click switch to
  stdio-echo (the keyless profile that works on master) rather than
  daemon-echo (blocked on the not-yet-shipped daemon-demo).
- assemble-oss-release.sh rewrites the source-side breadcrumb name
  'dsh-desktop-demo' → 'dsh-desktop' for the released package.json.

FOUC guard on the onboarding gate (41fc5df carried) keeps the
first-launch splash from flashing before the runtime probe finishes.

Test suite (1634 tests in source, 3990 in the runtime repo) covers
resolver ordering, renderer classifiers, trace timeline shape,
compaction diff rendering, rubric parity, and the missing-key
onboarding paths.
2026-07-18 12:59:34 -07:00

53 lines
2.2 KiB
YAML

# JSON-RPC serving config for the desktop demo — keyless echo profile.
#
# The runtime bin (packages/examples/jsonrpc-demo) hosts these plugins:
# `dsh-jsonrpc` serves newline-delimited JSON-RPC on stdio, the spine gives
# the agent shape, and the leaf plugins supply a mock adapter + echo tool so
# there's no network dependency. Matches the shape in
# python/sdk-runtime/src/deepseek_harness_runtime/runtime/cordis.yml but with
# the mock-echo adapter swapped in.
# Stdio JSON-RPC serving surface — the demo's whole reason to exist.
- id: jsonrpc
name: '@deepseek-ai/dsh-jsonrpc'
# Agent spine — the SDK server creates agents per sessionId.
# agent-spine-demo requires an explicit workspaceContext (Config | false)
# because it changes model-visible input; there is no schema default.
# `false` = hermetic prompts (no workspace overview injected), which is the
# right shape for the keyless mock path — the mock adapter ignores any
# workspace context anyway.
- id: agent-core
name: '@deepseek-ai/dsh-agent-spine-demo'
config:
workspaceContext: false
# Mock adapter from the echo-agent leaf. Path is relative to this file.
- id: mock-llm
name: '../../echo-agent/src/mock-llm.ts'
# Echo tool so the UI has something to render as a tool call.
- id: echo-tool
name: '../../echo-agent/src/echo-tool.ts'
# Bash executor sits behind agent-core's bash tool schema — required by the spine.
- id: bash
name: '@deepseek-ai/dsh-bash-local'
# User-interaction seam: required whenever the JSON-RPC client announces
# capabilities.interruptions=true (the desktop shell always does; see
# main.js:handshake). Without this the daemon logs
# "jsonrpc client announced capabilities.interruptions=true but the composition
# has no ctx.userInteraction" and the shell's runtime-error banner fires on
# the empty state — hiding the four differentiator cards behind an error
# strip. Kept in the echo profile too so all default profiles bind the same
# interaction surface (product-flow-review A-P0-2 root cause, 2026-07-16).
- id: user-interaction
name: '@deepseek-ai/dsh-user-interaction'
# JSONL persistence — sessions land under ./.sessions inside this dir.
- id: sessions
name: '@deepseek-ai/dsh-session-persistence-jsonl'
config:
root: './.sessions'