Files
deepseek-harness/packages/core
sjw1231 cdd7c76f2a Merge branch 'master' into feat/apply-patch
# Conflicts:
#	apps/cli/tests/profiles/headless/tests/expected/subagent-inheritance/parent.expected.jsonl
#	docs/config-catalog.md
#	docs/config-catalog.zh.md
#	packages/fs/tool-fs/README.i18n.yaml
#	scripts/verify-package-readme-model-experience.ts
#	snapshots/sdk/dynamic-tool-updates/notifications.expected.jsonl
#	snapshots/sdk/dynamic-tool-updates/session.v4.jsonl
#	snapshots/sdk/tool-error-details/notifications.expected.jsonl
#	snapshots/sdk/tool-error-details/session.v4.jsonl
#	snapshots/session/advanced-toolchain/session.v4.jsonl
#	snapshots/session/dynamic-tool-prompt-updates/session.v4.jsonl
#	snapshots/session/dynamic-tool-updates/session.v4.jsonl
#	snapshots/session/pi-ai-conversation-updates/session.v4.jsonl
#	snapshots/session/plugin-manager-mcp/session.v4.jsonl
#	snapshots/web/collapse-timing/next-message.expected.md
#	snapshots/web/collapse-timing/verbose.expected.md
2026-10-22 16:23:14 +08:00
..
2026-10-17 15:10:31 +08:00

description, kind
description kind
The core group map: the session log, system-prompt assembly, tool registry, agent vocabulary, and default loop that form the product API spine. package-group

packages/core

English | 中文

Summary

Use the core packages to build or extend an agent that records durable session history, assembles system prompts, exposes tools, selects a default model, and runs model turns. These packages define the shared APIs used by every composition, while executable product assemblies live under packages/bundle. Choose this group when developing agent behavior or replacing one of those capabilities; start with dsh-base when you need the default runnable composition.

Table of Contents


Packages

Package Role ctx key
scope/ Scoped registration and event routing that isolate one agent's contributions library — no ctx key
session/ The append-only session event log every agent's history derives from ctx.sessions
system-prompt/ System-prompt assembly from ordered sections, tool schemas, and variables ctx.systemPrompt
tools/ The tool registry and guarded execution pipeline the loop dispatches through ctx.tools
agent-tool-presentation/ Per-agent tool-presentation selector for presets no ctx key
agent/ The Agent handle plugins program against, plus its live registry and events ctx.agents
agent-default-model/ The deployment default model selection entry points apply to fresh agents ctx.agentDefaultModel
agent-loop/ The default agent driver: creates agents and runs the turn and step lifecycle ctx.agentLoop

scope supplies the shared scoping primitive; agent owns the public Agent contract, while agent-loop is its default implementation, so extension plugins depend on agent and the driver stays swappable. agent-default-model owns the deployment selection an entry point applies when a session has none of its own. Runnable compositions live under packages/bundle; this group owns only the swappable spine pieces.



Dev Note

Working context for maintainers — click to expand

None.