OpenVoiceOS / OpenVoiceOS/architecture

Spec proposal: OVOS-FALLBACK-1 — Fallback Pipeline Plugin

Open
#48 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-FALLBACK-1, the fallback pipeline plugin specification.

Problem

Fallback skills — those that handle utterances through their own internal logic rather than registered intents — have no normative contract. The current implementation uses a broadcast ping/pong and numeric priorities but lacks any specification for session-level ordering preferences, session-scoped registration, or the conceptual distinction between intent-based and fallback skills.

Proposal

The defining property of a fallback skill is that it evaluates the utterance using its own logic rather than relying on an intent model. Regular skills declare coverage through INTENT-4 registrations; fallback skills receive the raw utterance at query time and decide for themselves.

Pool ordering follows the transformer/pipeline composition model:

  • session.fallback_handlers (session preference) — ordered list of skill_ids
  • Registered priority (default ordering hint)
  • session.blacklisted_skills (policy)

Per-skill query uses the CONVERSE-1 unicast ping/pong pattern: <skill_id>.fallback.ping / <skill_id>.fallback.pong, sequential, stops at first willing skill.

Multi-stage interleaving preserved: fallback_high / fallback_medium / fallback_low stages with per-instance priority ranges remain valid.

Priority guidance: 0–49 high confidence (knowledge bases), 50–74 medium (web search), 75–100 low confidence (LLM catch-alls). Every deployment SHOULD include a catch-all skill at priority 100.

PR

PR #39

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 the OVOS-FALLBACK-1 proposal and PR #39. Compare the proposed fallback-skill contract with the existing INTENT-4 and CONVERSE-1 patterns mentioned in the issue. Done means the specification resolves the ordering, registration, query, staging, and priority requirements.

Written by the indexing model from the issue text.

Assessment

Domain
backend-api-design
Issue type
Feature
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.