Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
"""Client-safe error text for web routes.
A caught exception's ``str()`` can carry internal paths, library reprs or a
provider's raw response body. Routes that answer a local UI with an error
string use :func:`internal_error` instead: the full exception (with its
traceback) goes to the server log, and the client gets a short, stable
sentence it can show next to the button that failed.
Messages the UI must act on (a validation error we raise ourselves, a clear
"package not installed" hint) keep their own text; this helper is for the
unexpected ``except Exception`` branches.
"""
from __future__ import annotations
import logging
_log = logging.getLogger(__name__)
LOG_HINT = "Details are in the Dodaios log."
def internal_error(
action: str,
exc: BaseException,
*,
logger: logging.Logger | None = None,
) -> str:
"""Log *exc* with its traceback and return a generic client message.
``action`` is a short lowercase phrase ("config write", "memory read") that
names what failed; it must not contain exception data.
"""
(logger or _log).warning("%s failed", action, exc_info=(type(exc), exc, exc.__traceback__))
return f"{action} failed. {LOG_HINT}"
def diagnostic_text(exc: BaseException, *, max_chars: int = 300) -> str:
"""One-line ``Type: message`` for a failure the user must diagnose themselves.
For user-configured local processes (an MCP server command, say) the reason
is the whole point of the reply. It never includes a traceback: only the
first line of the message, credential shapes masked, length capped.
"""
from dodaios.core.redact import redact_secrets
first_line = (str(exc).strip().splitlines() or [""])[0]
text = f"{type(exc).__name__}: {first_line}" if first_line else type(exc).__name__
text = redact_secrets(text)
if len(text) > max_chars:
text = text[:max_chars] + "…"
return text
__all__ = ["LOG_HINT", "diagnostic_text", "internal_error"]