dsh-observability

Two small plugins for DeepSeek Harness that close the observability gap around external subagent runs. Background and upstream proposal: discussion #1493.

Packages

Path	Package	What it does
(root)	dsh-codex-observability	Fingerprints product session roots (~/.codex/sessions, ~/.cursor/chats, …) before and after tracked tool calls and writes an attribution envelope (sessionRef, sessionStatus) to a journal file. Pointers only — never prompt or transcript content.
plugin-cursor/	dsh-tool-cursor	A cursor_delegate tool that delegates a task to the official cursor-agent CLI (headless), ported from the opencodex cursor.ts reference. Read-only by default; edit proposes but never applies changes.

Both are boot-tested in a real composition (isolated DSH_HOME, headless, --patch, dsh 0.1.0-rc.6). Evidence:

{"kind":"subagent-attribution","runId":"c091edac-…","provider":"bash","callId":"call_00_…",
 "error":"none","sessionRef":"/tmp/obs-test-root/new-artifact.jsonl",
 "sessionStatus":"attributed-single-artifact"}

{"kind":"subagent-attribution","runId":"55f45e12-…","provider":"read","callId":"call_00_…",
 "error":"none","sessionRef":null,"sessionStatus":"not-observed"}

Install

# from git (builds via the package's prepare script; pnpm >= 10 asks for
# allowBuilds permission the first time — copy the printed key into the
# profile's pnpm-workspace.yaml, then re-run)
dsh plugin --profile web add github:jeremy9682/dsh-observability

# or from a local checkout
dsh plugin --profile web add ~/Projects/dsh-observability

# cursor tool: local checkout form (the repo root is the observability package)
dsh plugin --profile web add ~/Projects/dsh-observability/plugin-cursor

Requires dsh 0.1.0-rc.6 and Node ^22.19 || >=24.

Configure (defaults shown):

- id: codex-observability
  name: dsh-codex-observability
  config:
    enabled: true
    roots: ['~/.codex/sessions', '~/.cursor/chats']
    tools: [subagent_codex, subagent_claude_code]
    journal: '~/.dsh/storages/codex-observability.jsonl'

- id: tool-cursor
  name: dsh-tool-cursor
  config:
    timeoutSeconds: 600
    defaultMode: ask