Skip to content

feat: Coven familiars as dynamic agents + familiars docs section#2

Merged
BunsDev merged 2 commits into
mainfrom
daemon-integration
May 29, 2026
Merged

feat: Coven familiars as dynamic agents + familiars docs section#2
BunsDev merged 2 commits into
mainfrom
daemon-integration

Conversation

@BunsDev
Copy link
Copy Markdown
Member

@BunsDev BunsDev commented May 29, 2026

Summary

Familiars from the Coven daemon are now surfaced as first-class agent personas inside Coven Code — automatically, with no extra config.

What changed

Core bridge (agents_view.rs)

  • Added familiar_as_agent_def() — converts CovenFamiliarAgentDefinition with source tag coven:familiar:<id>, synthesised persona system prompt, and workspace memory scope
  • load_agent_definitions() now appends Coven daemon familiars after user workspace agents; user definitions with the same display name take precedence

TUI (agents overlay)

  • Agents list splits into "Workspace Agents" and "Coven Familiars" sections; familiars section uses violet accent header
  • Detail view shows "Persona" label and violet "Coven Familiar" source badge for familiar-sourced entries

CLI commands (named_commands.rs)

  • agents list: grouped output with star bullets for familiars, count, switch hint
  • agents familiars: new subcommand — list only familiar-sourced agents
  • agent <name> (new command): resolve by display name or familiar id, show persona preview + --agent invocation hint; --list flag enumerates all

Docs

  • docs/familiars.md: new dedicated section covering familiar detection, familiars.toml format, TUI/CLI usage, workspace agent overrides, standalone mode fallback, glyph reference
  • docs/agents.md: cross-link callout at top
  • docs/index.md: Coven ecosystem integration section + familiars nav link

Tests

All 47 command tests pass; 553 TUI tests pass. 5 pre-existing failures are unrelated to this change.

Copilot AI review requested due to automatic review settings May 29, 2026 21:45
BunsDev added 2 commits May 29, 2026 16:46
- agents_view: import coven_shared; add familiar_as_agent_def() builder
  that converts CovenFamiliar → AgentDefinition with source tag
  'coven:familiar:<id>', synthesised persona prompt, workspace memory scope
- load_agent_definitions(): append Coven daemon familiars after user agents;
  user definitions with the same display name take precedence (shadow check)
- TUI agents list: split into 'Workspace Agents' and '✨ Coven Familiars'
  sections with violet accent for the familiars section header
- render_agent_detail(): familiar-sourced entries show 'Persona' instead of
  'Prompt', violet badge 'Coven Familiar · <id>', persona-preview truncation
- named_commands: agents list shows grouped output with ★ bullets for
  familiars, switch hint, familiar count
- named_commands: new 'agents familiars' subcommand lists only familiar-
  sourced agents
- named_commands: new AgentCommand ('coven-code agent <name>') resolves by
  display name or familiar id, shows persona preview + --agent invocation
  hint; --list flag enumerates all with ✨/• badges
- docs/familiars.md: new dedicated section covering familiar detection,
  familiars.toml format, TUI/CLI usage, workspace agent overrides, glyphs
- docs/agents.md: cross-link callout to familiars page at top
- docs/index.md: Coven ecosystem integration section + familiars nav entry

All 47 command tests pass; 553 TUI tests pass (5 pre-existing failures
unrelated to this change).
@BunsDev BunsDev force-pushed the daemon-integration branch from be402e9 to 619a632 Compare May 29, 2026 21:46
@BunsDev BunsDev merged commit 8dcc516 into main May 29, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants