jeremy9682/dsh-observability

Name: jeremy9682/dsh-observability
Author: jeremy9682

插件Plugin 原生Native ⭐ 2 MIT cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.observabilitycat_label.observability cat_label.subagentcat_label.subagent

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-observability 是 DeepSeek Harness 的两个插件，用于补齐外部子代理运行的可观测性：codex-observability 在工具调用前后指纹会话目录，把会话引用与状态写入 JSONL 日志（仅指针，不含提示词或对话内容）；tool-cursor 提供 cursor_delegate 工具，无头调用官方 cursor-agent CLI，默认只读、edit 仅提议不应用。适用于追踪 codex、cursor 等子代理产物归属。注意：会话内持久日志指针受上游 #1493 阻塞，目前依赖文件日志。

dsh-observability is a pair of DeepSeek Harness plugins closing the observability gap around external subagent runs. codex-observability fingerprints session roots before and after tracked tool calls and writes attribution envelopes (sessionRef, sessionStatus) to a JSONL journal—pointers only, never prompt or transcript content. tool-cursor adds a cursor_delegate tool that runs the official headless cursor-agent CLI, read-only by default with edit proposing but never applying changes. Use it to attribute subagent artifacts; note durable in-session-log pointers are blocked upstream (#1493), so a file journal is the fallback.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-observability】【https://github.com/jeremy9682/dsh-observability】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:jeremy9682/dsh-observability

把 jeremy9682/dsh-observability 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.1 KB · 缓存于 2026-08-27 05:42:07 · 3.1 KB

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

Standalone utility (no DSH needed)

bin/dsh-run-attributed.mjs wraps any CLI with the same fingerprint + envelope + three-tier timeout (first-event / idle / total):

node bin/dsh-run-attributed.mjs --provider codex --seat codex-landing \
  --root ~/.codex/sessions --first-event 60 --idle 240 --total 300 \
  -- codex exec --json "<task>"

Known upstream blocker

The durable in-session-log pointer (instead of the file journal) waits on two upstream items, raised in #1493: a downstream event-type registration surface, and append-time ignorable control. Session.append() offers neither today; KNOWN_SESSION_EVENT_TYPES excludes out-of-repo plugin events by construction. The file journal is the working fallback until then.

License

MIT.

渲染基于仓库 jeremy9682/dsh-observability 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install