Skip to content

FALLBACK-1: fallback pipeline plugin specification#39

Merged
JarbasAl merged 2 commits into
devfrom
spec/fallback
Jun 26, 2026
Merged

FALLBACK-1: fallback pipeline plugin specification#39
JarbasAl merged 2 commits into
devfrom
spec/fallback

Conversation

@JarbasAl

@JarbasAl JarbasAl commented May 27, 2026

Copy link
Copy Markdown
Member

Companion issue: #48

Summary

Defines the fallback pipeline plugin — the final stage(s) in the utterance lifecycle that handle utterances no earlier stage claimed, by querying registered fallback skills in priority order and dispatching to the first willing one.

The defining property of a fallback skill is that it evaluates the utterance with its own logic rather than relying on registered intents. Regular skills declare coverage through INTENT-4; fallback skills receive the raw utterance at query time and decide for themselves — analogous to CONVERSE-1's per-skill poll.

What the spec covers

  • §3 — Skill registration (ovos.fallback.register / .deregister) with priority hint; session-scoped per INTENT-4 §11
  • §3.3 — 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 at priority 100
  • §4 — Session field session.fallback_handlers (ordered preference list, same composition model as transformers)
  • §5 — Pool construction: preference → stage range → availability → session.blacklisted_skills
  • §6 — Match contract: sequential unicast ping/pong (<skill_id>.fallback.ping / <skill_id>.fallback.pong); request carries utterances + lang so skill can parse the utterance itself
  • §7 — Dispatch via <skill_id>:fallback (reserved intent name, PIPELINE-1 §7.3)
  • §8 — Pipeline positioning; multi-stage interleaving (fallback_high/medium/low) preserved via per-instance priority ranges

Companion edits (same PR)

  • ovos-pipeline-1.md §7.3 — reserve intent_name fallback
  • ovos-session-1.md §3 — register fallback_handlers field

@coderabbitai

coderabbitai Bot commented May 27, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@JarbasAl, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 37 minutes and 19 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more credits in the billing tab to continue.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 40d98704-d4a1-4867-b973-ce63820e5d3e

📥 Commits

Reviewing files that changed from the base of the PR and between 22b1d56 and 5b908b1.

📒 Files selected for processing (2)
  • CHANGELOG.md
  • fallback.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch spec/fallback

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

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

@JarbasAl JarbasAl changed the title OVOS-FALLBACK-1: Fallback Pipeline Plugin Specification (v1 draft) OVOS-FALLBACK-1: Fallback Pipeline Plugin Specification May 28, 2026
@JarbasAl

Copy link
Copy Markdown
Member Author

Merge-readiness: resolved.

Merges resolved across two commits (c158adf + db0bace):

  1. dev merge (auto): Added AUDIO-IN-1 spec file and compliance fix (owner_id→skill_id in ovos-session-1.md + ovos-stop-1.md). No conflict — dev's clean fast-forward context.
  2. Remote branch catch-up (db0bace): Remote spec/fallback had 4 commits (rewrite + rename fallback.request/response → fallback.ping/pong) not in local. Conflict in ovos-session-1.md: dev had removed the fallback_handlers row (it wasn't there yet), remote added it. Preserved the PR's normative content: fallback_handlers | array of string | OVOS-FALLBACK-1 §4 kept.

Added FALLBACK-1, COMMON-QUERY-1, BRIDGE-1 in-review rows to README spec table.

No other semantic flags. Cross-references in fallback.md use spec IDs only.

Note on #55: fallback.md filename reference in README will need updating if filename-rename PR merges first.

JarbasAl added a commit that referenced this pull request Jun 22, 2026
…isten field

Consolidates the PIPELINE-1 companion edits previously bundled into the
union-slots (#56), FALLBACK-1 (#39), COMMON-QUERY-1 (#40) and AUDIO-1 (#38)
feature PRs into a single one-file change to ovos-pipeline-1.md.

- §6.1/§6.2 — orchestrator backstop for required_slots (INTENT-3 §5.3):
  the orchestrator treats a Match as declined if any required slot is
  absent. Second line of defense behind engine-side enforcement.
- §7.3 — reserve intent_names "fallback" (FALLBACK-1 §6.3) and
  "common_query" (COMMON-QUERY-1 §3). COMMON-QUERY-1 asserted the
  reservation but never registered the row; this closes that gap.
- §9.6 — add the OPTIONAL listen field to ovos.utterance.speak; the
  output-side behaviour is owned by AUDIO-1.

All additions are backwards-compatible. PIPELINE-1 is already V2 (its
namespaced topics replace the pre-spec names); these refinements do not
change the class, so the Version stays 2. Adds the missing PIPELINE-1
CHANGELOG section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@JarbasAl JarbasAl changed the title OVOS-FALLBACK-1: Fallback Pipeline Plugin Specification FALLBACK-1: fallback pipeline plugin specification Jun 22, 2026
@JarbasAl JarbasAl marked this pull request as ready for review June 26, 2026 20:56
@JarbasAl JarbasAl merged commit 28adf46 into dev Jun 26, 2026
1 check passed
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.

1 participant