DPAgent Node.js Runtime

DPAgent is a local-first TypeScript agent runtime for developer and operations workflows. It provides a Web UI, CLI entrypoint, event-sourced session context, local tools, MCP integration, memory, skills, subagents, automation, Todo governance, Plan Mode, and release gates for internal npm publishing.

Documentation

The current documentation source is doc/.

Start here:

• User guide
• MiniMax Agent to DPAgent migration
• Product baseline
• Design index
• Architecture baseline
• Code module index
• Module flow baseline
• Development playbook
• Release gate overview
• Internal npm publish

Do not use the removed legacy docs/ tree or slim-refactor round notes as a current behavior source.

Common Startup

Development:

npm install
npm run dev:web

Built Web server:

npm run build:web
npm run start:web

Installed package:

npm i @dpvr/dpagent --registry http://10.100.1.10:4873
npx dpagent

The DPAgent rename is a breaking package and CLI rename. Existing @dpvr/minimax-agent installations do not upgrade in place with npm update; install @dpvr/dpagent and update local scripts from npx minimax-agent to npx dpagent. MiniMax provider credentials such as MINIMAX_API_KEY remain unchanged.

Windows easy-run bundles start with:

Run-DPAgent.bat

Common Commands

npm run build
npm run build:web
npm test
npm run smoke:ui
npm run release:source-gate

Release candidates must follow release gate overview.

Repository Layout

src/       Runtime source.
tests/     Unit, integration, and E2E tests.
scripts/   Build, release, smoke, and diagnostic scripts.
agents/    Native agent profiles.
doc/       Current product, spec, playbook, and history documentation.

Runtime outputs such as contexts/, runtime/, logs/, workspace/, ux-workspace/, and dist/ are not source artifacts.