5.0 KiB
description, kind
| description | kind |
|---|---|
| Standalone two-tool SDK profile for users who need a minimal cross-platform coding agent without the shared base bundle. | package-bundle |
@deepseek-ai/dsh-sdk-minimal
English | 中文
Summary
Use dsh --profile sdk-minimal when an SDK client needs a small, explicit coding-agent runtime. The profile advertises a platform-selected persistent shell and str_replace_editor, persists sessions as uncompressed JSONL, and selects the model from the SDK initialization request. It supplies a complete Cordis tree and deliberately excludes dsh-base, Web, settings, managed credentials, telemetry, compaction, workspace instructions, skills, jobs, and subagents. Its danger-full-access policy lets the shell and editor modify any path available to the process, so use it only with an isolated workspace.
Table of Contents
- Use this package
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
- Dev Note
Use this package
Launch the profile directly or select it from the Python SDK. Supply an explicit DSH_HOME, use a disposable workspace, and provide the model credential through DEEPSEEK_API_KEY.
export DSH_HOME=/absolute/path/to/example-dsh-home
dsh --profile sdk-minimal
DSH_CONTEXT_WINDOW sets the fallback capacity for a model absent from the adapter's advisory catalog. DSH_SYSTEM_PROMPT replaces the default persona. The SDK initialization request is the sole model selection and overrides environment defaults.
Use dsh plugin --profile sdk-minimal to manage persistent external dependencies. Profile, home, and ordered --patch files can replace rows or insert bundles above the complete default tree. The shipped template applies patches only at startup.
The profile mounts exactly one persistent shell stack: Bash on Linux and macOS, or PowerShell on Windows. Both stacks use a 300-second timeout and one owner-scoped terminal; the other platform's rows remain disabled.
Understand the implementation
Implementation internals — click to expand
The bundle's single insert is the complete application tree: SDK stdio startup and JSON-RPC serving, one environment-configured DeepSeek adapter, the executor-less agent spine, local subprocess and unrestricted filesystem providers, a platform-selected persistent shell PTY, the string-replace editor, and uncompressed JSONL persistence under $DSH_HOME/sessions. It does not inherit another bundle, so every extra row is an explicit profile change.
Source map
| File | Role |
|---|---|
cordis.patch.yml |
Complete standalone profile tree and its environment-backed defaults |
src/index.ts |
Bundle package entry |
src/invariant.ts |
Invariant companion for the static composition |
tests/sdk-minimal.spec.ts |
Exact composition, profile-name, and platform-selection checks |
Further Exploration
- Python SDK example — launches this profile from Python against an explicit Harness home.
- SDK application bundle — the JSON-RPC application layer reused by full and minimal SDK profiles.
- Base bundle — the full product foundation that this profile deliberately omits.
Model Experience
Minimal coding-agent composition
What the model sees
The system prompt is DSH_SYSTEM_PROMPT or You are a helpful software engineer assistant.. The only advertised tools are owner-scoped persistent bash on Linux/macOS or pwsh on Windows, plus str_replace_editor; runtime context, workspace instructions, skills, jobs controls, compaction, and Harness identity are absent.
Token effect
One stable persona plus the two tool schemas. Tool results and ordinary conversation history grow with the session.
KV Cache effect
Stable for a fixed persona, platform, provider, model, and bundle patch stack. Profile changes take effect on the next process.
Known Limitations and Deferred Work
- The composition intentionally omits shared product services — select
dsh --profile sdkwhen settings, managed credentials, policy presets, telemetry, Web tools, or the full default tool roster are required. - User patches can expand the tree and corrupt stdout — profile customization is trusted application composition; a plugin that writes ordinary text to stdout can break JSON-RPC framing.
Dev Note
Working context for maintainers — click to expand
None.