mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-08-29 04:26:38 +00:00
refactor: apply repository naming contract
Apply the accepted pre-release package, service, type, directory, and role renames as one repository-wide change.
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# AGENTS.md
|
||||
|
||||
DeepSeek Harness SDK is a plugin-based agent harness on vendored Cordis: **everything is a plugin**. Read [docs/architecture.md](docs/architecture.md) before changing `packages/`; follow [docs/AGENTS.md](docs/AGENTS.md) for documentation.
|
||||
DeepSeek Harness is a plugin-based agent harness on vendored Cordis: **everything is a plugin**. Read [docs/architecture.md](docs/architecture.md) before changing `packages/`; follow [docs/AGENTS.md](docs/AGENTS.md) for documentation.
|
||||
|
||||
## Pre-release stance: foundation over blast radius
|
||||
|
||||
@@ -12,18 +12,18 @@ DeepSeek Harness SDK is a plugin-based agent harness on vendored Cordis: **every
|
||||
vendor/ Vendored Cordis source — manifest + sync procedure in vendor/README.md
|
||||
packages/ @deepseek-ai/dsh-<pkg> workspaces at packages/<group>/<pkg>/
|
||||
core/ product API spine: session, system-prompt, tools, agent, agent-loop
|
||||
api/ Remote BFF assembly and TypeRT RPC gateway
|
||||
api/ Remote BFF assembly and Typert RPC gateway
|
||||
typert/ type graph generator, loader, and runtime registry
|
||||
llm/ LLM capability: Service Definition/Consumer + DeepSeek providers
|
||||
e2b/ E2B POC: sandbox + FS/subprocess adapters
|
||||
bash/ bash capability: Service Definition + local/pwsh providers + shell Consumers
|
||||
shell/ bash capability: Service Definition + local/pwsh providers + shell Consumers
|
||||
subprocess/ subprocess capability + local process-tree provider
|
||||
pty/ persistent PTY capability
|
||||
terminal/ persistent sessions
|
||||
fs/ filesystem capability + policy
|
||||
lsp/ language-server capability
|
||||
skill/ skill provider registry + local impl + catalog/loader tool
|
||||
web/ web capability: Service Definition + search/fetch providers + tool Consumer
|
||||
compact/ compaction capability + basic provider
|
||||
compaction/ compaction capability + basic provider
|
||||
context/ request-context plugins
|
||||
subagent/ subagent capability: Service Definition + providers + delegation Consumers
|
||||
bundle/ installable dsh --profile patch-layer bundles
|
||||
@@ -35,6 +35,7 @@ packages/ @deepseek-ai/dsh-<pkg> workspaces at packages/<group>/<pkg>/
|
||||
self-modification/ the agent inspects/mounts its own plugins
|
||||
hooks/ Claude Code/Codex hook bridges + wire-protocol library
|
||||
session/ durable session data: persistence, projection, titles, telemetry
|
||||
identity/ anonymous identity
|
||||
settings/ user-settings capability + file provider
|
||||
credentials/ credential-reference capability + env/.env provider
|
||||
acp/ automation-only Agent Client Protocol server
|
||||
@@ -107,7 +108,7 @@ Real-API tests and demos read `DEEPSEEK_API_KEY`, optional `DEEPSEEK_BASE_URL`,
|
||||
- **Plugins, not loop changes**: new behavior goes on documented extension points; changing `agent-loop` requires updating docs/architecture.md.
|
||||
- **A capability seam comprises Service Definition / Service provider / Consumer roles.** It is complete, never one role; split only when roles evolve independently ([glossary](docs/glossary.md#capability-seam)).
|
||||
- **Prefer maintained dependencies over hand-rolling** when they genuinely delete owned code and tests ([policy](.agents/notes/implemented/process/2026-07-26-dependencies-over-hand-rolling.md)).
|
||||
- **Explicit > implicit at package boundaries**: defaulting is an explicit `resolve(request): Spec` step in the owning implementation, never a hidden `?? default` inside `run()` (the `dsh-bash` request/spec split is the template).
|
||||
- **Explicit > implicit at package boundaries**: defaulting is an explicit `resolve(request): Spec` step in the owning implementation, never a hidden `?? default` inside `run()` (the `dsh-shell` request/spec split is the template).
|
||||
- **No hardcoded tunables in plugins**: deployment-varying choices are validated `Config` fields changeable from cordis.yml; a `DEFAULT_*` constant or test hook is not configurability. Protocol constants, external specs, and security invariants stay fixed.
|
||||
- **Misconfiguration fails loud** at load when self-contained, otherwise at the earliest resolvable point; never silently skip a missing referent.
|
||||
- **Opaque cross-boundary ids are branded** (`Branded<B>` from `dsh-brand`), never bare `string`.
|
||||
|
||||
Reference in New Issue
Block a user