_Kerman
0348599f04
# Conflicts: # docs/event-producer-consumer.i18n.yaml # docs/event-producer-consumer.md # docs/event-producer-consumer.zh.md # packages/acp/acp/tests/harness.ts # packages/api/session-controller/README.i18n.yaml # packages/api/session-controller/README.md # packages/api/session-controller/README.zh.md # packages/api/session-controller/tests/commands-queue-attachment.host.spec.ts # packages/context/agent-instructions/tests/agent-instructions.e2e.ts # packages/fs/tool-fs/tests/harness.ts # packages/preset/agent-presets/tests/invariant.spec.ts # packages/preset/agent-presets/tests/mount.spec.ts # packages/preset/agent-presets/tests/remote.spec.ts # packages/test-support/agent-loop-testkit/package.json
description, kind
| description | kind |
|---|---|
| The preset group map: per-session agent composition from preset files, for users and maintainers navigating the group. | package-group |
packages/preset
English | 中文
Summary
The preset group provides per-session agent composition: an agent preset is a directory holding one agent.cordis.yml, and a session composed from a preset runs that preset's tools, prompt sections, and skills while every other session keeps its own. agent-presets owns the roster — discovery over configured roots plus the harness home, the guarded per-agent mount, and copy-only authoring — and persona supplies the composable row that lets a preset change an agent's identity and not only its tools. Together they let one process run several differently composed agents at once.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
agent-presets |
Preset roster, discovery over trusted and user roots, per-agent composition, copy-only authoring | ctx.agentPresets |
persona |
The composable persona row a preset mounts to shadow or replace the deployment persona | — |
Related documentation
AgentPresetsreference — discovery, mounting, inheritance, and recomposition.- Scope subsystem — scope keys and the parent chain the mount uses to join agents.
- System prompt subsystem — how preset prompt sections register and assemble.
- Per-session agent presets note — design rationale and alternatives.
The presets the deployment ships live in agent-presets/presets/ — one directory per preset, and that directory listing is the roster; naming them here too would be a second list to keep in step.
Dev Note
Working context for maintainers — click to expand
None.