Plugin directory / Security / dsh-infra-observability
dsh-infra-observability
Verified · install-tested on dsh Bryan-cmf
What it does
DSH-Plugin: structural observability layer - real tool/skill usage recording (tools/result), skill-catalog audit, watchdog. No model self-reporting.
Works — verified, early-stage project
DSH-Plugin: structural observability layer - real tool/skill usage recording (tools/result), skill-catalog audit, watchdog. No model self-reporting. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
⚠️ 此套件已併入
@bryan-cmf/dsh-insights(2026-08-17)。此 repo 僅保留作合併前歷史,後續迭代請到 dsh-insights。
🔭 Infra Observability — DSH-Plugin
結構化觀測層:真實的工具/技能使用記錄(
tools/result)、技能目錄審計、看門狗。零模型自報——平台記什麼,報告就寫什麼。
A DeepSeek Harness host plugin
that replaces model self-reporting with structural recording:
tools/resultlistener — every real tool execution (name + outcome) is
recorded by the platform into a ring buffer and per-day aggregates.agent/error/agent/status— error totals and live-agent tracking.- Watchdog — timer-driven alert when agent errors spike (≥ N in 5 min).
- Three tools for the model and humans:
| Tool | What it reports |
|---|---|
usage_report |
Per-day tool/skill aggregates (calls / ok / err) + recent executions |
audit_skills |
Catalog totals, provider spread, warnings (missing description, non-kebab names), today's skill usage |
infra_health |
Uptime, records kept, error counts, running agents, catalog size, watchdog state |
Dashboard (browser)
The client half registers an 「觀測」view tab (order 20, right of
chat / trajectory) rendering a live per-session dashboard from the infraView
session projection: turn counts, failure count, tool/skill TOP lists with
success-rate bars, and the recent execution trail. Data updates as events
commit — no refresh needed.
Install
Path A — Host composition (recommended, always-on)
Add to the profile's package.json dsh.profile.bundles (the package ships adsh.bundle.patch that inserts the plugin row):
"dsh": { "profile": { "bundles": ["@bryan-cmf/dsh-infra-observability"] } }
Path B — Agent preset row
- id: infra-observability
name: '@bryan-cmf/dsh-infra-observability'
Requirements
- DSH
>= 0.1.0-rc.6(services:tools,timer,skills— all part of the
shippeddsh-basebundle)
Configuration
| Key | Default | Meaning |
|---|---|---|
maxRecords |
5000 |
Ring-buffer cap for recent execution records |
healthIntervalMs |
60000 |
Watchdog check interval |
errorAlertThreshold |
5 |
Alert at ≥ this many agent errors per 5-minute window |
Scope notes
- Aggregates are process-lifetime (like
dsh-skill-trail); the durable source
of truth remains the session log. Cross-restart persistence is planned. - Companion package:
@bryan-cmf/dsh-skill-trail
renders the per-reply badge row; this package is the backend layer.
Development
pnpm install --store-dir .pnpm-store
pnpm build
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-infra-observability for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:Bryan-cmf/dsh-infra-observabilityHeadless (CLI) profile:
dsh plugin --profile headless add github:Bryan-cmf/dsh-infra-observabilityTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-infra-observability/)<a href="https://dshbase.com/plugins/dsh-infra-observability/"><img src="https://dshbase.com/badges/dsh-infra-observability.svg" alt="dshbase install-tested"></a>