PERSONA-1: persona pipeline plugin specification

[JarbasAl]

Companion issue: #50

Summary

Defines the persona pipeline plugin — a complete conversational agent that, when active for a session, claims every utterance that reaches its pipeline stage and generates natural-language responses.

What the spec covers

• §3 — persona_id session field: absent = no-persona mode (deterministic pipeline); present = named persona active
• §4 — No-persona mode: persona stages MUST decline except for embedded commands
• §5–§6 — Summon (self-summon via Match.updated_session, or external via session field) and dismiss
• §7 — Match contract: two routes — embedded persona command detection (always active) and utterance claim when persona is active
• §8 — Handler contract: standard PIPELINE-1 dispatch; multi-turn via CONVERSE-1; session.fallback_pipeline_id for per-persona fallback chains; conversation history via SESSION-2 MAY-internal pathway
• §8.5 — Out-of-band query: ovos.persona.query / ovos.persona.answer — direct text-in/text-out bypassing the pipeline; session for history from context.session.session_id
• §9 — Multiple persona coexistence: each plugin declares supported persona_ids; at most one active per session
• §10 — Pipeline positioning: after deterministic intents and converse, before fallback
• §11 — Bus surface
• §12 — Conformance

Bus surface

Topic	Purpose
ovos.persona.query	Out-of-band query to a persona
ovos.persona.answer	Persona's generated response
ovos.persona.list	Enumerate supported persona identities
ovos.persona.list.response	Supported-identity listing
ovos.persona.register	Runtime persona registration
ovos.persona.deregister	Runtime persona deregistration

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 40c26977-afad-4903-bdcb-990293473c94

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch spec/persona

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[JarbasAl]

Merge-ready (MERGEABLE, dev merged in). Template conformance: header present (OVOS-PERSONA-1 v1 Draft), RFC-2119 boilerplate present, 12 numbered sections plus See also. Fixed: OVOS-PERSONA-1 was absent from README spec table and CHANGELOG — both added. Spec filename persona.md is already using clean naming (consistent with #55). Note: after #55 merges, GLOSSARY.md in this branch will need ovos-intent-*.md links updated.