stcode 0.0.1a0__py3-none-any.whl

stcode/__init__.py

@@ -0,0 +1,10 @@
+"""
+stcode — Terminal Coding Agent
+"""
+
+import importlib.metadata
+
+try:
+    __version__ = importlib.metadata.version("stcode")
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "0.0.0"

stcode/cli/__init__.py

@@ -0,0 +1,9 @@
+"""
+CLI — what the user sees and types: the typer entrypoint, the textual screens, and the
+copy they display.
+
+A separate program from `stcode.core`: neither imports the other. The UI reaches the
+engine only through the daemon's socket (`client.py`), and starts one as a subprocess
+when none is listening (`launcher.py`). No re-exports: every screen imports
+`stcode.cli.labels`, and pulling typer in through this `__init__` would be dead weight.
+"""

stcode/cli/bootstrap.py

@@ -0,0 +1,70 @@
+"""Construct client dependencies before handing the terminal to Textual."""
+
+from __future__ import annotations
+
+import contextlib
+from pathlib import Path
+
+from stcode.cli.logic.connection import Connection
+from stcode.cli.logic.state import ClientState
+from stcode.cli.models import ApprovalMode, StartOptions
+from stcode.cli.services.launcher import Launcher
+from stcode.cli.services.preferences import load_prefs, save_prefs, ui_path
+from stcode.cli.ui.app import StcodeApp
+from stcode.cli.ui.theme import TerminalMode, detect_terminal_mode
+
+
+def build_app(
+    launcher: Launcher,
+    *,
+    daemonless: bool = False,
+    restart: bool = False,
+    cwd: Path | None = None,
+    resume: str = "",
+    mode: ApprovalMode | None = None,
+    role: str = "",
+    terminal_mode: TerminalMode = "dark",
+    prefs_path: Path | None = None,
+) -> StcodeApp:
+    path = prefs_path or ui_path()
+    prefs = load_prefs(path)
+
+    def save_preferences() -> None:
+        with contextlib.suppress(OSError):
+            save_prefs(prefs, path)
+
+    return StcodeApp(
+        Connection(launcher),
+        ClientState(),
+        StartOptions(
+            cwd or Path.cwd(), cwd is not None, daemonless, resume, mode, role
+        ),
+        prefs,
+        path,
+        save_preferences=save_preferences,
+        restart=restart,
+        terminal_mode=terminal_mode,
+    )
+
+
+def run(
+    launcher: Launcher,
+    *,
+    daemonless: bool = False,
+    restart: bool = False,
+    cwd: Path | None = None,
+    resume: str = "",
+    mode: ApprovalMode | None = None,
+    role: str = "",
+) -> None:
+    # Detection must precede Textual taking ownership of the tty.
+    build_app(
+        launcher,
+        daemonless=daemonless,
+        restart=restart,
+        cwd=cwd,
+        resume=resume,
+        mode=mode,
+        role=role,
+        terminal_mode=detect_terminal_mode(),
+    ).run()