Skip to main content
P

dsh-os-suite

perrylink/dsh-os-suite

Token, job and disk budgets with admission decisions and opt-in pre-execute enforcement for DSH agents.

Install

dsh plugin --profile web add github:perrylink/dsh-os-suite

README

dsh-os-suite

CI

Security · Contributing · Changelog

Six small, composable governance-layer plugins for DeepSeek Harness (DSH).

Community project. Not affiliated with, sponsored by, or endorsed by DeepSeek. Apache-2.0. No SLA, no warranty. Early MVP, published as 0.2.5 on npm (2026-11-19).

DSH already has the organs of an agent OS — sessions, tools, agent loop, sandbox, approvals, jobs, teams, worktrees, MCP. What it lacks is the nervous system: who is running, what they consume, why something happened, how to resume after a crash, what can do X, and whether a change made things worse. These six packages target that layer, not another UI skin or file search.

Packages

PackageGapTools
dsh-os-traceCausal audit & tamper-evident evidence bundlestrace_query, trace_why, trace_export, trace_verify
dsh-os-leaseWorkspace lease intents & multi-file transaction plansworkspace_lease, workspace_apply, workspace_rollback, workspace_status
dsh-os-quotaAdvisory token/job/disk budgets & admission decisionsquota_status, quota_set, quota_admit, quota_consume
dsh-os-evalRegression eval gates: cases, baselines, CI verdictseval_run, eval_gate, eval_report
dsh-os-catalogIntent-based capability catalog for tools/plugins/MCPcapability_search, capability_preflight, capability_register
dsh-os-registryLocal service & port registry for dev serversservice_register, service_list, service_stop

Status (2026-11-15)

  • 276/276 tests pass (npm test; six packages).
  • Branch protection: main requires a PR, the CI/CodeQL checks, and an up-to-date branch; force pushes and deletion are blocked.
  • Release provenance: published GitHub releases carry a .intoto.jsonl asset generated from npm attestations (manually for v0.2.4+, automatically for future releases via .github/workflows/release-provenance.yml).
  • Release auth: npm Trusted Publishing (OIDC), verified by the v0.2.5 release; the legacy NPM_TOKEN secret has been removed. Steps/history: docs/trusted-publishing.md.
  • Host-service integration: five tests mount the real DSH 0.2.2-rc.3 service packages (Cordis Context, ToolRuntime, NativeToolExecutor, SessionStore, SessionProjectionRegistry, SessionQuery, TokenMeter) and verify quota denial, trace spans, eval live reads, and token-meter pressure; run npm run test:integration.
  • Coverage gate: lines 85% / functions 80% / branches 70% (npm run test:coverage).
  • 21 tools register through defineTool; all six entries import and apply() under a fake Cordis context.
  • Names verified: npm view <name> → E404; GitHub exact-name search → 0 (2026-11-15). See NAME-CHECK.md.
  • Pre-release audit: AUDIT.md (historical, 0.1.x); the three findings were fixed in 0.2.x.
  • Real install verified in an isolated DSH_HOME: all six tarballs install via dsh plugin --profile web add, and --dump-config lists all six entries.
  • Published: all six packages at 0.2.5 on npm (2026-11-19).

Install

dsh plugin --profile web add dsh-os-trace
dsh plugin --profile web add dsh-os-lease
dsh plugin --profile web add dsh-os-quota
dsh plugin --profile web add dsh-os-eval
dsh plugin --profile web add dsh-os-catalog
dsh plugin --profile web add dsh-os-registry

Quick start

npm install
npm test

# inspect a package tarball without publishing
cd packages/dsh-os-trace && npm pack --dry-run

Each package ships src/, cordis.patch.yml, README.md, DESIGN.md, LICENSE, and declares dsh.bundle.patch + engines.dsh.

Design rules

  • Core logic (src/core.js) imports no @deepseek-ai/*; tests run offline.
  • The plugin entry only registers tools and calls core.
  • Every tool declares explicit parameters and output schemas.
  • Descriptions describe what the MVP actually does; mocks and limits are stated in each README.
  • No network or filesystem writes in core; no secrets.

License

Apache-2.0. See each package's LICENSE.

Related plugins