tandem-plan-compiler 0.4.18

Mission and plan compiler boundary for Tandem
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

// Copyright (c) 2026 Frumu LTD
// Licensed under the Business Source License 1.1

use serde::{Deserialize, Serialize};

use crate::planner_types::PlannerInvocationFailure;

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct TeachingLibrarySummary {
    #[serde(default)]
    pub explanations: Vec<String>,
    #[serde(default)]
    pub objections: Vec<String>,
    #[serde(default)]
    pub proof_points: Vec<String>,
}

pub fn planner_teaching_library_summary() -> TeachingLibrarySummary {
    TeachingLibrarySummary {
        explanations: vec![
            "Summarize the workflow in 2-4 sentences.".to_string(),
            "State which steps produce the final deliverable.".to_string(),
        ],
        objections: vec![
            "Call out missing inputs or unclear dependencies.".to_string(),
            "Highlight missing connectors or unavailable capabilities.".to_string(),
        ],
        proof_points: vec![
            "List artifacts or validations that prove success.".to_string(),
            "Reference evidence sources used by the plan.".to_string(),
        ],
    }
}

pub(crate) fn planner_llm_unavailable_hint() -> &'static str {
    "This workflow needs planner model settings before Tandem can revise it. Configure a planner model and try again."
}

pub(crate) fn planner_llm_invalid_response_hint() -> &'static str {
    "The planner could not produce a valid workflow revision. Keep the current plan or try a more specific request."
}

pub(crate) fn planner_failure_clarifier_hint(failure: &PlannerInvocationFailure) -> String {
    let detail = failure
        .detail
        .as_deref()
        .map(str::trim)
        .filter(|value| !value.is_empty())
        .unwrap_or("");
    let lower = detail.to_ascii_lowercase();
    if failure.reason == "provider_auth_failed"
        || lower.contains("user not found")
        || lower.contains("unauthorized")
        || lower.contains("authentication")
        || lower.contains("invalid api key")
        || lower.contains("403")
        || lower.contains("401")
    {
        return "The configured planner provider rejected authentication (User not found / unauthorized). Check provider account linkage or API key in Settings, or switch planner model/provider.".to_string();
    }
    if detail.is_empty() {
        planner_llm_invalid_response_hint().to_string()
    } else {
        detail.to_string()
    }
}