roboticus-api 0.11.3

HTTP routes, WebSocket, auth, rate limiting, and dashboard for the Roboticus agent runtime
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! Conversational shortcut handler — only AcknowledgementShortcut survives.
//!
//! All other conversational shortcuts (CapabilitySummary, PersonalityProfile,
//! ProviderInventory) were retired in v0.11.1. See docs/architecture/shortcut-registry.md.

use super::super::core::InferenceOutput;
use super::super::intent_registry::Intent;
use super::{ShortcutContext, ShortcutHandler, shortcut_output};

// ── Acknowledgement (always eligible, no cache bypass) ──────────────────

pub struct AcknowledgementShortcut;

#[async_trait::async_trait]
impl ShortcutHandler for AcknowledgementShortcut {
    fn handles(&self, intents: &[Intent]) -> bool {
        intents.contains(&Intent::Acknowledgement)
    }

    fn requires_cache_bypass(&self) -> bool {
        false
    }

    fn execution_confidence(&self, ctx: &ShortcutContext) -> (f64, &'static str) {
        // Acknowledgement fires on very short, explicit confirmation phrases.
        // High confidence from brevity + common ack patterns.
        let trimmed = ctx.user_content.trim();
        let word_count = trimmed.split_whitespace().count();
        if word_count <= 3 {
            let lower = trimmed.to_ascii_lowercase();
            let ack_phrases = [
                "ok",
                "okay",
                "got it",
                "understood",
                "noted",
                "acknowledged",
                "roger",
                "copy",
                "ack",
                "yep",
                "yes",
                "sure",
                "thanks",
                "thank you",
                "ty",
            ];
            if ack_phrases
                .iter()
                .any(|p| lower == *p || lower.starts_with(p))
            {
                return (1.0, "short explicit acknowledgment phrase");
            }
        }
        (0.0, "not a clear acknowledgment")
    }

    async fn execute(
        &self,
        ctx: &mut ShortcutContext<'_>,
    ) -> Result<Option<InferenceOutput>, String> {
        Ok(Some(shortcut_output(
            ctx.prepared_model,
            "Acknowledged, awaiting your next instruction.".to_string(),
            1.0,
            vec![],
            ctx.turn_id,
        )))
    }
}