synapse-cli-agent 0.1.13__py3-none-any.whl

synapse/commands/theme.py

@@ -0,0 +1,99 @@
+"""Theme selection slash-command handler."""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from synapse.commands.helpers import markdown_escape
+from synapse.commands.result import SlashResult
+
+
+def handle_theme(
+    args: list[str],
+    *,
+    settings: Any,
+    project_root: Path,
+) -> SlashResult:
+    """List or switch UI themes; persist selection to user settings.json."""
+    from synapse.ui.theme import (
+        format_theme_list_lines,
+        get_theme,
+        list_theme_names,
+        reload_theme_catalog,
+        set_theme,
+    )
+
+    reload_theme_catalog(project_root)
+    if not args or args[0].casefold() in {"list", "ls", "show"}:
+        active = getattr(settings, "theme", None) or get_theme().name
+        plain = format_theme_list_lines(active=active)
+        from synapse.ui.theme import list_themes, theme_kind
+
+        md = (
+            "## Themes\n\n"
+            f"**current**: `{active}`\n\n"
+            "|   | Name | Label | Kind |\n|---|---|---|---|\n"
+        )
+        for t in list_themes():
+            mark = "*" if t.name == active else " "
+            tone = theme_kind(t)
+            from synapse.ui.theme import BUILTIN_THEMES, _custom
+
+            if t.name in _custom and t.name not in BUILTIN_THEMES:
+                kind = f"custom/{tone}"
+            elif t.name in _custom:
+                kind = f"override/{tone}"
+            else:
+                kind = f"built-in/{tone}"
+            md += (
+                f"| {mark} | `{markdown_escape(t.name)}` "
+                f"| {markdown_escape(t.label)} | {markdown_escape(kind)} |\n"
+            )
+        md += "\nusage: `/theme <name>`\n\nconfig: `settings.json` theme + optional `themes.json`"
+        return SlashResult(handled=True, lines=plain, markdown=md)
+
+    name = args[0].strip()
+    # Optional: /theme set <name> | /theme use <name>
+    if name.casefold() in {"set", "use", "switch"} and len(args) >= 2:
+        name = args[1].strip()
+    try:
+        theme = set_theme(
+            name,
+            workspace=project_root,
+            persist=True,
+            scope="user",
+            reload=False,
+        )
+    except KeyError as exc:
+        names = ", ".join(list_theme_names())
+        return SlashResult(
+            handled=True,
+            lines=[str(exc), f"available: {names}"],
+            error=True,
+        )
+    except Exception as exc:  # noqa: BLE001
+        return SlashResult(
+            handled=True,
+            lines=[f"theme switch failed: {exc}"],
+            error=True,
+        )
+
+    try:
+        settings.theme = theme.name
+    except Exception:  # noqa: BLE001
+        pass
+    return SlashResult(
+        handled=True,
+        lines=[
+            f"theme switched to {theme.name} ({theme.label})",
+            "saved to ~/.coding-agent/settings.json",
+        ],
+        markdown=(
+            "## Theme\n\n"
+            f"- **name**: `{markdown_escape(theme.name)}`\n"
+            f"- **label**: {markdown_escape(theme.label)}\n\n"
+            "*saved to `~/.coding-agent/settings.json`*"
+        ),
+        settings_changed=True,
+        theme_name=theme.name,
+    )

synapse/config.py

@@ -0,0 +1,27 @@
+"""Compatibility exports for the settings domain.
+
+New code should import from :mod:`synapse.settings`. This module remains so
+existing integrations and extension code do not need an atomic migration.
+"""
+
+from synapse.settings.schema import (
+    Settings,
+    bootstrap_project_env,
+    config_search_roots,
+    executable_config_dirs,
+    find_dotenv,
+    load_settings,
+    project_config_dir,
+    user_config_dir,
+)
+
+__all__ = [
+    "Settings",
+    "bootstrap_project_env",
+    "config_search_roots",
+    "executable_config_dirs",
+    "find_dotenv",
+    "load_settings",
+    "project_config_dir",
+    "user_config_dir",
+]

synapse/content/__init__.py

@@ -0,0 +1 @@
+"""Prompt, skill, input, and multimodal content services."""

synapse/content/input_history.py

@@ -0,0 +1,122 @@
+"""Project-scoped input history for chat CLI / TUI (up/down navigation)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def _read_text_lossy(path: Path) -> str:
+    """Read history file, tolerating legacy Windows encodings (GBK etc.)."""
+    data = path.read_bytes()
+    if not data:
+        return ""
+    # UTF-8 BOM
+    if data.startswith(b"\xef\xbb\xbf"):
+        return data.decode("utf-8-sig")
+    # UTF-16 LE/BE BOM
+    if data.startswith(b"\xff\xfe"):
+        return data.decode("utf-16-le")
+    if data.startswith(b"\xfe\xff"):
+        return data.decode("utf-16-be")
+    for enc in ("utf-8", "gbk", "cp936", "gb18030", "cp1252", "latin-1"):
+        try:
+            return data.decode(enc)
+        except UnicodeDecodeError:
+            continue
+    return data.decode("utf-8", errors="replace")
+
+
+class InputHistory:
+    """Line-based history stored under the project ``.synapse/`` dir.
+
+    Shares the same default file as the readline chat CLI
+    (``.synapse/history``) so entries accumulate across UIs.
+    """
+
+    def __init__(
+        self,
+        path: Path,
+        *,
+        max_entries: int = 1000,
+    ) -> None:
+        self.path = Path(path)
+        self.max_entries = max(1, int(max_entries))
+        self.entries: list[str] = []
+        self._index: int | None = None
+        self._draft: str = ""
+        self.load()
+
+    @classmethod
+    def for_project(cls, project_root: Path | None = None, **kwargs) -> InputHistory:
+        from synapse.settings.config_paths import SYNAPSE_DIRNAME
+
+        root = Path(project_root or Path.cwd()).expanduser().resolve()
+        return cls(root / SYNAPSE_DIRNAME / "history", **kwargs)
+
+    def load(self) -> None:
+        self.entries = []
+        try:
+            raw = _read_text_lossy(self.path)
+        except (FileNotFoundError, OSError):
+            return
+        for line in raw.splitlines():
+            text = line.rstrip("\n\r")
+            if not text or text.startswith("_HiStOrY_"):
+                continue
+            # readline may escape leading spaces; keep content as-is after strip of
+            # trailing junk only. Preserve intentional leading spaces rarely used.
+            self.entries.append(text)
+        if len(self.entries) > self.max_entries:
+            self.entries = self.entries[-self.max_entries :]
+
+    def save(self) -> None:
+        try:
+            self.path.parent.mkdir(parents=True, exist_ok=True)
+            body = "\n".join(self.entries[-self.max_entries :])
+            if body:
+                body += "\n"
+            self.path.write_text(body, encoding="utf-8")
+        except OSError:
+            pass
+
+    def add(self, text: str) -> None:
+        line = (text or "").strip()
+        if not line:
+            self.reset_cursor()
+            return
+        if self.entries and self.entries[-1] == line:
+            self.reset_cursor()
+            return
+        self.entries.append(line)
+        if len(self.entries) > self.max_entries:
+            self.entries = self.entries[-self.max_entries :]
+        self.save()
+        self.reset_cursor()
+
+    def reset_cursor(self) -> None:
+        self._index = None
+        self._draft = ""
+
+    def up(self, current: str) -> str | None:
+        """Move to older entry. Returns text to put in the prompt, or None."""
+        if not self.entries:
+            return None
+        if self._index is None:
+            self._draft = current or ""
+            self._index = len(self.entries) - 1
+        elif self._index > 0:
+            self._index -= 1
+        return self.entries[self._index]
+
+    def down(self, current: str) -> str | None:  # noqa: ARG002
+        """Move to newer entry, or restore the draft when leaving history."""
+        if self._index is None:
+            return None
+        if self._index < len(self.entries) - 1:
+            self._index += 1
+            return self.entries[self._index]
+        # Past the newest → restore live draft
+        self._index = None
+        draft = self._draft
+        self._draft = ""
+        return draft