Zum Hauptinhalt springen
P

dsh-os (allow)

perrylink/dsh-os/packages/allow

Revocable, expiring capability grants with scope and a local audit trail for DSH plugins and out-of-turn authorization checks. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Installation

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

Dieses Plugin befindet sich im Unterverzeichnis packages/allow des Repositorys.

README

dsh-os

A family of OS-level primitives for DeepSeek Harness: 11 core modules (Act, Allow, Snip, Check, Nest, Trigger, Seek, Trace, Stage, Ring, Root), 5 optional modules (Help, Context, Cost, Backup, Notify), plus a thin contract, an optional UI shell, a catalog CLI and a dependency-only kit.

The modules stay small and independent: one Host service, ≤6 agent tools, zero runtime dependencies, independent semver, no cross-module imports. The contract (dsh-os-contract) and the optional shell are the only shared layers; the kit contains no business code.

Not affiliated with DeepSeek. DeepSeek and DeepSeek Harness are trademarks of their respective owners. These are independent community packages, published under MIT.

Terminal card: dsh-check prints "Check REGRESSION" and exits 1

Runnable in 10 minutes: examples/os-kit has two dependency-free demos — Allow + Act + Snip (deny → 30-minute Grant → allow → revoke → deny) and the Check regression gate. node examples/os-kit/demo.mjs needs only Node 22+; nothing is installed or published.

Docs: Quickstart · AI handbook · Real-model eval (10-scenario, 19/20) · Web approval bridge · Architecture 0.3 · AI capability cards · Validation plan · Validation status · Local smoke (0.2.0) · Recipes (CI gate, agent writes, clipboard) · Troubleshooting.

Packages

ProductPackageStatusDesign
Actdsh-act0.7.0 (one-approval proof)design
Allowdsh-allow0.4.0 (one-time grants)design
Snipdsh-snip0.4.0 (capture + taint)design
Checkdsh-canary0.4.0 (runner + envelope)design
Nestdsh-nest0.1.0 MVPdesign
Triggerdsh-trigger0.4.0 (payload + taint)design
Seekdsh-seek0.5.0 (trace + taint)design
Tracedsh-record0.3.0 (memento + ref verify)design
Stagedsh-stage0.2.0 (macOS/Windows adapters)design
Ringdsh-ring0.4.0 (Grant-gated delivery)design
Rootdsh-runtime-env0.1.2 MVPdesign
Helpdsh-help0.1.0 optionalinstall doctor / first run
Contextdsh-scene0.1.0 optionalcontext provider protocol
Costdsh-price0.1.0 optionaladapter for dsh-cost-meter
Backupdsh-timecapsule0.2.0 optionalallowlisted snapshot / restore plan
Notifydsh-buzz0.1.0 optionalchannel registry / attention router
Shelldsh-os-shell0.4.0 optionalinjection-safe approvals/activity
CLIdsh-os-cli0.2.0 tooldsh-os list/doctor/install/approvals
Contractdsh-os-contract0.2.0 libraryresult/error/handle protocols
Kitdsh-os-kit0.10.0 meta bundleinstalls 6 latest modules
Kerneldsh-os-kernel0.6.0 coreclean one-approval bridge
MCPdsh-os-mcp0.2.0 toolread-only default + write approval path
A2Adsh-os-a2a0.1.0 toolagent card + task protocol prototype

All packages are unscoped. Where the exact bare name was already taken or blocked by npm's name-similarity rule, the package uses a nearby bare name: Check → dsh-canary, Root → dsh-runtime-env, Trace → dsh-record, Context → dsh-scene, Cost → dsh-price, Backup → dsh-timecapsule, Notify → dsh-buzz. Product names stay Check/Root/Trace/Context/Cost/Backup/Notify.

Install

# one-shot: core four + Kernel + Shell
dsh plugin --profile web add dsh-os-kit

# or individually
dsh plugin --profile web add dsh-act
dsh plugin --profile web add dsh-allow
dsh plugin --profile web add dsh-snip
dsh plugin --profile web add dsh-nest
dsh plugin --profile web add dsh-trigger
dsh plugin --profile web add dsh-seek
dsh plugin --profile web add dsh-stage
dsh plugin --profile web add dsh-ring
dsh plugin --profile web add dsh-canary
dsh plugin --profile web add dsh-runtime-env
dsh plugin --profile web add dsh-record

# AI gateway kernel (capability registry + os_* verbs)
dsh plugin --profile web add dsh-os-kernel

# optional small modules
dsh plugin --profile web add dsh-help
dsh plugin --profile web add dsh-scene
dsh plugin --profile web add dsh-price
dsh plugin --profile web add dsh-timecapsule
dsh plugin --profile web add dsh-buzz
dsh plugin --profile web add dsh-os-shell

# catalog CLI (no network, prints install plans)
npm i -g dsh-os-cli
dsh-os list
dsh-os doctor
dsh-os approvals list --state ~/.dsh/allow.json

# read-only MCP server prototype
npm i -g dsh-os-mcp
dsh-os-mcp --help

# A2A agent-card/task prototype (stdio)
npm i -g dsh-os-a2a
dsh-os-a2a --help

Repository layout

packages/    one npm package per primitive
examples/    dependency-free runnable demos
docs/        design notes and the implementation contract
scripts/     scaffold, test and publish helpers

Status

Twenty-three packages ship a 0.1.x–0.4.x MVP: services, agent tools, tests and a bundle manifest (libraries/CLI where applicable). 0.2.0 added real adapters; 0.3.0 adds the kernel + permission request flow + Act fs actions + human oversight: Check headless runner, Snip clipboard capture, Trigger agent/fs/webhook sources, Seek locator/memento providers, Stage macOS/Windows windows, Trace memento adapter, Ring webhook/ntfy/console channels and the React shell. 0.4.0 adds one-time/use-budgeted grants (Allow 0.4), the kernel legacy-tool bridge, MCP write approval, safer Check runs and the four-module dsh-os-kit 0.4. node scripts/test-all.mjs runs 21 suites; npm run verify runs the full four-gate release check. See 0.4 release notes for what is installable and what is still a known limitation.

Development

node scripts/scaffold.mjs
node scripts/test-all.mjs
node scripts/publish.mjs act allow   # requires NPM_TOKEN

CI and release

CI (.github/workflows/ci.yml) runs on a Node 22 + 24 matrix with the npm cache enabled, and executes four gates in order:

node scripts/test-all.mjs
node scripts/conformance.mjs
node scripts/pack-smoke.mjs
node scripts/check-versions.mjs
  • pack-smoke runs npm pack --dry-run --json for every packages/* and fails if the tarball lacks package.json, index.js, cordis.patch.yml, README.md or LICENSE.
  • check-versions fails on an invalid version, an engines.dsh range without an upper bound, a publishConfig.registry that is not npmjs, or a non-empty dependencies.

The same sequence, including the package tests, runs locally as npm run verify.

Releases are never published automatically. .github/workflows/release.yml is workflow_dispatch-only: it takes a comma-separated package input (directory names such as act,allow or npm names such as dsh-act), runs the same gates on Node 24, then npm packs only the selected packages and uploads the tarballs as a build artifact. Publishing is a manual maintainer step: it needs the NPM_TOKEN repository secret (a granular npm token allowed to publish dsh-*), an approval-protected environment, and an explicit npm publish of the reviewed tarballs. The workflow never runs npm publish.

Community / Validation

License

MIT.

Ähnliche Plugins