Skip to content

config_routes

config_routes

Config get/set HTTP API (writes ~/.diapason/config.toml).

Functions:

set_config_value 

set_config_value(key: str, value: Any) -> Any

Validate, coerce, write TOML, clear load_config cache. Returns typed value.

Source code in src/diapason/server/config_routes.py 
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
71
72
73
74
75
76
77
78
79
80
81
def set_config_value(key: str, value: Any) -> Any:
    """Validate, coerce, write TOML, clear load_config cache. Returns typed value."""
    import tomlkit

    from diapason.core.config import load_config, validate_config_key

    target_type = validate_config_key(key)
    if isinstance(value, str):
        if target_type is bool:
            low = value.lower()
            if low in ("true", "1", "yes"):
                typed: Any = True
            elif low in ("false", "0", "no"):
                typed = False
            else:
                raise ValueError(f"Invalid bool: {value!r}")
        elif target_type is int:
            typed = int(value)
        elif target_type is float:
            typed = float(value)
        else:
            typed = value
    else:
        typed = value
        if target_type is bool:
            typed = bool(value)
        elif target_type is int:
            typed = int(value)
        elif target_type is float:
            typed = float(value)

    path = _config_path()
    if path.exists():
        doc = tomlkit.parse(path.read_text(encoding="utf-8"))
    else:
        doc = tomlkit.document()
        path.parent.mkdir(parents=True, exist_ok=True)

    parts = key.split(".")
    current = doc
    for part in parts[:-1]:
        if part not in current:
            current.add(part, tomlkit.table())
        current = current[part]
    current[parts[-1]] = typed
    path.write_text(tomlkit.dumps(doc), encoding="utf-8")
    try:
        load_config.cache_clear()
    except Exception:
        pass
    return typed

get_config_snippet 

get_config_snippet() -> Dict[str, Any]

Return settings useful for the desktop Settings UI.

Source code in src/diapason/server/config_routes.py 
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
def get_config_snippet() -> Dict[str, Any]:
    """Return settings useful for the desktop Settings UI."""
    from diapason.core.config import load_config

    cfg = load_config()
    v = cfg.desktop.vision
    d = cfg.dictation
    w = cfg.speech.wakeword
    return {
        "desktop": {
            "vision": {
                "enabled": v.enabled,
                "allow_cloud": v.allow_cloud,
                "model": v.model,
                "share_interval_s": v.share_interval_s,
                "share_max_minutes": v.share_max_minutes,
                "monitor": v.monitor,
            }
        },
        "dictation": {
            "polish": d.polish,
            "dictionary": d.dictionary,
            "llm_polish": d.llm_polish,
            "email_mode": d.email_mode,
            "auto_learn": bool(getattr(d, "auto_learn", True)),
        },
        "speech": {
            "wakeword": {
                "enabled": w.enabled,
                "text_gate": w.text_gate,
                "backend": w.backend,
                "sensitivity": w.sensitivity,
            }
        },
        "heartbeat": {
            "enabled": cfg.heartbeat.enabled,
            "interval_seconds": cfg.heartbeat.interval_seconds,
        },
        "routines": {"enabled": cfg.routines.enabled},
        "agent": {"tool_approval": cfg.agent.tool_approval},
    }