mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
1c2d51c9ca
Re-audited against origin: master unmoved; approval seam still on feat/sandbox-support; three relevant branches appeared since drafting. - env-state-visibility RFC (fold-from-log + boundary application for env facts): adopt its boundary-narration principle for user-driven mode flips (one coalesced notice when the flushed mode differs from the last request header's fold; net-zero silent; tool exits self-narrate via result), and resolve the one real collision — its config-phase sketch routes ACP session/set_mode to env facts while this RFC claims the picker. Proposed division: picker-to-modes / knobs-to-config-options; a mode definition may later bundle env facts; second lander amends. Also note the source-field contrast (env drift has no log-adjacent cause; every mode/set does). - sandbox-escalation: first live approval composition — named as the precedent our recorded scenarios follow. - ask-user-question / user-interaction seam: the stdio approval answerer rides its one-prompt-owns-stdin queue where mounted. - Config: pin the allowlist as the degenerate form of a per-tool allow|deny|ask map so execution-phase ask policies arrive without a config migration (deferred on approval's allow_always). - Dedup the ACP mapping (one home: Protocol and UI surfaces).
DeepSeek Harness
English | 中文
The DeepSeek Harness SDK is a plugin-based SDK for building agent harnesses.
Development
This monorepo is built on the Cordis framework (vendored as source under vendor/), microkernel-style: everything is a plugin.
pnpm install
pnpm run test # vitest
pnpm run demo:repl # REPL agent demo (needs DEEPSEEK_API_KEY)
pnpm run demo:acp # ACP server agent demo (needs DEEPSEEK_API_KEY)
For humans, start with the development guide for local setup, hooks, environment variables, and quality gates, then read the architecture design and documentation graph index before package work. Local context lives in packages/ and vendor/.
For agents, follow AGENTS.md.