@docyrus/docyrus 0.0.62 → 0.0.64

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -362,8 +362,27 @@ Inside the interactive agent TUI:
362
362
  /end-read-only # exit read-only mode and resume normal operation
363
363
  /tasks # browse the canonical project-plan phases, features, and tasks
364
364
  /todos # interactive todo manager
365
+ /souls # list available agent "souls" (communication styles)
366
+ /soul <id> # switch the agent's soul (e.g. caveman, master-yoda, pirate) — takes effect next session
365
367
  ```
366
368
 
369
+ #### Souls
370
+
371
+ A "soul" is a style-only prompt overlay that changes how the agent *talks* without changing what it *does*. Tool usage, Docyrus CLI rules, and structured (`--json`) output are always preserved; souls only affect narrative prose.
372
+
373
+ Select a soul inside the pi agent (`docyrus agent` / `docyrus coder`) with `/soul <id>` and list available souls with `/souls`. The selection is persisted in `<settings-root>/config.json` (same scope as environment/auth) and takes effect on the next agent session.
374
+
375
+ Over HTTP (`docyrus server`):
376
+
377
+ ```bash
378
+ curl http://localhost:3111/api/souls
379
+ curl -X POST http://localhost:3111/api/souls/select \
380
+ -H 'content-type: application/json' \
381
+ -d '{"soulId":"pirate"}'
382
+ ```
383
+
384
+ Full server API reference for **Soul**, **MCP**, and **Skill** endpoints: [`docs/server-api.md`](./docs/server-api.md).
385
+
367
386
  When running through `docyrus server`, `/plan` can be sent through `/api/chat` as normal chat input. If clarification is needed, the server emits a synthetic `ask_user` client tool. Frontends using AI SDK `useChat` should render that tool and submit structured answers back with `addToolOutput`.
368
387
 
369
388
  ### Planning-Model Policy
package/agent-loader.js CHANGED
@@ -2861,7 +2861,7 @@ async function main() {
2861
2861
  agentDir,
2862
2862
  settingsManager,
2863
2863
  additionalExtensionPaths: packagedExtensionPaths,
2864
- systemPrompt: (0, import_node_path4.join)(
2864
+ systemPrompt: process.env.DOCYRUS_PI_SYSTEM_PROMPT_PATH ?? (0, import_node_path4.join)(
2865
2865
  resourceRoot,
2866
2866
  "prompts",
2867
2867
  request.profile === "agent" ? "agent-system.md" : "coder-system.md"