OpenVoiceOS / OpenVoiceOS/architecture

Spec proposal: OVOS-CONVERSE-1 — Active Handlers and Interactive Response

Open
#24 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
3
Forks
0
Avg merge
15h 20m
Merged PRs (30d)
90

Description

Proposal for OVOS-CONVERSE-1, the imperative continuous-dialog specification.

Problem

OVOS has active-handler tracking and response-mode mechanics but no normative contract. session.active_handlers, session.response_mode, the converse plugin's poll, and the response-mode delivery path are all implementation-defined.

Proposal

  • Two session fields: session.converse_handlers (recency-ordered list of active handler {skill_id, activated_at}) and session.response_mode (single {skill_id, expires_at} entry when a handler holds the next utterance)
  • Converse plugin is a pure matcher (PIPELINE-1 §7.0): checks response_mode first, then polls converse_handlers via unicast ping/pong (<skill_id>.converse.ping / <skill_id>.converse.pong)
  • Response mode is session-resident: entered/left via in-handler session mutation; delivered via <skill_id>:response dispatch (reserved intent name)
  • Ordinary PIPELINE-1 dispatches: <skill_id>:converse and <skill_id>:response are standard dispatches on reserved intent names — no special routing

PR

PR #25

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing PR #25 alongside the OVOS-CONVERSE-1 proposal and its definitions of converse_handlers, response_mode, polling, and reserved dispatches. Done means the specification establishes a normative contract for active-handler tracking, response-mode delivery, and ordinary PIPELINE-1 dispatches.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.