zephyr-zecode 0.4.5__tar.gz

zephyr_zecode-0.4.5/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: zephyr-zecode
+Version: 0.4.5
+Summary: PowerShell-native ZeCode terminal client for Zephyr
+Author: Zephyr Project
+License-Expression: LicenseRef-Proprietary
+Keywords: zecode,zephyr,coding-agent,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: mcp<2,>=1.27
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: arabic-reshaper<4,>=3
+Requires-Dist: python-bidi<1,>=0.6
+Requires-Dist: rich<15,>=13.7
+Provides-Extra: classic
+Requires-Dist: textual<7,>=0.85; extra == "classic"
+
+# ZeCode 0.4.5
+
+ZeCode is the PowerShell-native terminal client for Zephyr. It provides one
+chronological conversation with inline tool activity, verified file delivery,
+on-demand terminal menus, and secure Zephyr Gateway v2 device pairing.
+
+Version `0.4.5` uses native terminal input and Rich output, without importing
+Textual or using CSS in the default launch path. It retains normal terminal
+scrollback and requires Zephyr `1.40.8` for session-free home startup.
+
+0.4.5 fixes live group-event filtering, pending-session recovery and the PgUp/Esc screen wipe. Home does not create or attach to a session. Choose Resume explicitly or save automatic resume.
+
+## Terminal experience
+
+- Top-left native terminal home with model, workspace, mode, and effort.
+- One chronological transcript for assistant text and real tool activity.
+- Stable `File`, `Shell`, `Tests`, `Web Search`, `MCP`, and `Delivery` rows.
+- Left-aligned multiline input with temporary menus; full-screen history and source viewers preserve the primary screen.
+- Slash command search, model/theme/mode pickers, and F2 settings.
+- Failed runs release their client lock immediately and do not duplicate chat.
+
+0.4.3 adds batched Windows input, guarded unmarked paste, direct clipboard paste
+with F4 on Windows, and collapsible long drafts (500 characters or six lines).
+F6 toggles full text. Explicit paste waits for Enter. Unmarked input bursts use
+F8 to submit; their Enter characters remain newlines. No backend or model changes.
+
+0.4.2 added an explicit startup choice (new/resume/select session), optional
+automatic resume, incremental row drawing with a single flush per update,
+and role-labelled, wrapped conversation history. PgUp reads the current
+conversation while preserving the draft; arriving output waits until Esc/End.
+PageDown stops at the final full page, including after window resizing.
+`/tools` opens coding tools first; media and other integrations live in
+More tools. Browsing these categories does not alter runtime permissions.
+
+## Install on Windows
+
+Install Python 3.11 or newer, extract the complete release ZIP, then run in
+PowerShell from that folder:
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+.\UPDATE_ZECODE_WINDOWS.ps1
+zecode --version
+```
+
+Start ZeCode:
+
+```powershell
+zecode login
+zecode doctor
+zecode
+```
+
+The script verifies and installs the bundled wheel via pipx, in the same
+PowerShell window. It prioritizes the pipx executable in the current and saved
+user PATH. Internet is needed for pipx and any missing dependencies.
+
+This ZIP is a local owner release, not confirmation of a PyPI publication.
+The following command continues to update from the configured package index;
+use the bundled script to install this exact release:
+
+```powershell
+zecode --update
+```
+
+The installed distribution is named `zephyr-zecode`; the terminal command is
+always `zecode`.
+
+## Native controls
+
+Enter sends ordinary drafts; F8 sends guarded unmarked pastes. F4 on Windows
+reads the clipboard as one paste, without relying on the host's Ctrl+V binding.
+F6 expands/collapses long pasted drafts. Arrow and deletion keys reveal the
+text before editing. Short pastes remain inline. A compact summary is only a
+display representation; the full draft is sent. Shift+Enter (Windows) or
+Alt+Enter inserts a newline. Ctrl+V on
+Windows and bracketed paste insert multiline text as a single draft. `/` opens
+suggestions, F2 settings, Ctrl+P commands, and Ctrl+L sessions. Tab cycles mode;
+Esc stops an active run. Ctrl+Q exits. `/keyboard` lists all native shortcuts.
+
+`/files` searches paths and previews/downloads files; `/diff` previews patches
+and confirms accept/reject of all pending changes. `/mcp`, `/permissions`,
+`/agents` and `/tools` use existing server controls. `/allow`, `/always` and
+`/deny` resolve pending approvals.
+
+Syntax themes color previews; terminal font and background remain terminal
+settings. Native shortcuts are fixed in this release; previous Textual key
+remappings do not apply. Historical Textual source remains for compatibility
+tests with the optional `classic` dependency, and is not the default UI.
+Arabic rendering can be selected in Display preferences.

zephyr_zecode-0.4.5/PYPI_README.md

@@ -0,0 +1,90 @@
+# ZeCode 0.4.5
+
+ZeCode is the PowerShell-native terminal client for Zephyr. It provides one
+chronological conversation with inline tool activity, verified file delivery,
+on-demand terminal menus, and secure Zephyr Gateway v2 device pairing.
+
+Version `0.4.5` uses native terminal input and Rich output, without importing
+Textual or using CSS in the default launch path. It retains normal terminal
+scrollback and requires Zephyr `1.40.8` for session-free home startup.
+
+0.4.5 fixes live group-event filtering, pending-session recovery and the PgUp/Esc screen wipe. Home does not create or attach to a session. Choose Resume explicitly or save automatic resume.
+
+## Terminal experience
+
+- Top-left native terminal home with model, workspace, mode, and effort.
+- One chronological transcript for assistant text and real tool activity.
+- Stable `File`, `Shell`, `Tests`, `Web Search`, `MCP`, and `Delivery` rows.
+- Left-aligned multiline input with temporary menus; full-screen history and source viewers preserve the primary screen.
+- Slash command search, model/theme/mode pickers, and F2 settings.
+- Failed runs release their client lock immediately and do not duplicate chat.
+
+0.4.3 adds batched Windows input, guarded unmarked paste, direct clipboard paste
+with F4 on Windows, and collapsible long drafts (500 characters or six lines).
+F6 toggles full text. Explicit paste waits for Enter. Unmarked input bursts use
+F8 to submit; their Enter characters remain newlines. No backend or model changes.
+
+0.4.2 added an explicit startup choice (new/resume/select session), optional
+automatic resume, incremental row drawing with a single flush per update,
+and role-labelled, wrapped conversation history. PgUp reads the current
+conversation while preserving the draft; arriving output waits until Esc/End.
+PageDown stops at the final full page, including after window resizing.
+`/tools` opens coding tools first; media and other integrations live in
+More tools. Browsing these categories does not alter runtime permissions.
+
+## Install on Windows
+
+Install Python 3.11 or newer, extract the complete release ZIP, then run in
+PowerShell from that folder:
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+.\UPDATE_ZECODE_WINDOWS.ps1
+zecode --version
+```
+
+Start ZeCode:
+
+```powershell
+zecode login
+zecode doctor
+zecode
+```
+
+The script verifies and installs the bundled wheel via pipx, in the same
+PowerShell window. It prioritizes the pipx executable in the current and saved
+user PATH. Internet is needed for pipx and any missing dependencies.
+
+This ZIP is a local owner release, not confirmation of a PyPI publication.
+The following command continues to update from the configured package index;
+use the bundled script to install this exact release:
+
+```powershell
+zecode --update
+```
+
+The installed distribution is named `zephyr-zecode`; the terminal command is
+always `zecode`.
+
+## Native controls
+
+Enter sends ordinary drafts; F8 sends guarded unmarked pastes. F4 on Windows
+reads the clipboard as one paste, without relying on the host's Ctrl+V binding.
+F6 expands/collapses long pasted drafts. Arrow and deletion keys reveal the
+text before editing. Short pastes remain inline. A compact summary is only a
+display representation; the full draft is sent. Shift+Enter (Windows) or
+Alt+Enter inserts a newline. Ctrl+V on
+Windows and bracketed paste insert multiline text as a single draft. `/` opens
+suggestions, F2 settings, Ctrl+P commands, and Ctrl+L sessions. Tab cycles mode;
+Esc stops an active run. Ctrl+Q exits. `/keyboard` lists all native shortcuts.
+
+`/files` searches paths and previews/downloads files; `/diff` previews patches
+and confirms accept/reject of all pending changes. `/mcp`, `/permissions`,
+`/agents` and `/tools` use existing server controls. `/allow`, `/always` and
+`/deny` resolve pending approvals.
+
+Syntax themes color previews; terminal font and background remain terminal
+settings. Native shortcuts are fixed in this release; previous Textual key
+remappings do not apply. Historical Textual source remains for compatibility
+tests with the optional `classic` dependency, and is not the default UI.
+Arabic rendering can be selected in Display preferences.

zephyr_zecode-0.4.5/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zephyr-zecode"
+dynamic = ["version"]
+description = "PowerShell-native ZeCode terminal client for Zephyr"
+readme = "PYPI_README.md"
+requires-python = ">=3.11"
+license = "LicenseRef-Proprietary"
+authors = [
+  {name = "Zephyr Project"},
+]
+keywords = ["zecode", "zephyr", "coding-agent", "terminal"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development",
+]
+dependencies = [
+  "mcp>=1.27,<2",
+  "httpx>=0.27,<1",
+  "arabic-reshaper>=3,<4",
+  "python-bidi>=0.6,<1",
+  "rich>=13.7,<15",
+]
+
+[project.optional-dependencies]
+classic = ["textual>=0.85,<7"]
+
+[project.scripts]
+zecode = "zecode_terminal.__main__:main"
+
+[tool.setuptools.dynamic]
+version = {attr = "zecode_terminal.__version__"}
+
+[tool.setuptools.packages.find]
+include = ["zecode_terminal*"]

zephyr_zecode-0.4.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zephyr_zecode-0.4.5/zecode_terminal/__init__.py

@@ -0,0 +1,4 @@
+"""Owner-only ZeCode terminal client."""
+
+__version__ = "0.4.5"
+ZEPHYR_COMPAT_VERSION = "1.40.8"

zephyr_zecode-0.4.5/zecode_terminal/__main__.py

@@ -0,0 +1,287 @@
+from __future__ import annotations
+
+import argparse
+import asyncio
+from getpass import getpass
+from importlib import metadata
+import shutil
+import socket
+import subprocess
+import sys
+import time
+
+from .app import ZeCodeApp
+from . import __version__
+from .client import (
+    GatewayBridge,
+    MCPBridge,
+    begin_device_pairing,
+    gateway_health,
+    is_transient_disconnect,
+    poll_device_pairing,
+)
+from .secrets import (
+    clear_gateway_credentials,
+    clear_private_link,
+    load_gateway_credentials,
+    load_gateway_url,
+    load_private_link,
+    normalize_gateway_url,
+    save_gateway_credentials,
+    save_private_link,
+)
+from .updater import PYPI_DISTRIBUTION
+
+
+def _parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="zecode")
+    parser.add_argument(
+        "--version", action="version", version=f"ZeCode {__version__}")
+    parser.add_argument(
+        "command",
+        nargs="?",
+        choices=("login", "logout", "doctor", "update", "legacy-login"),
+    )
+    parser.add_argument("--workspace", default="", help="Zephyr workspace key")
+    parser.add_argument(
+        "--gateway", default="", help="HTTPS ZeCode Gateway v2 URL")
+    parser.add_argument(
+        "--device-name", default="", help="Name shown during device approval")
+    parser.add_argument(
+        "--update",
+        action="store_true",
+        dest="update_requested",
+        help="Update ZeCode through pipx in this terminal and exit",
+    )
+    return parser
+
+
+async def _run_app(bridge, workspace: str) -> int:
+    async with bridge:
+        app = ZeCodeApp(bridge, workspace=workspace)
+        if not await app.bootstrap():
+            return 2
+        await app.run()
+        bridge.normal_close = app.ui.requested_exit
+    return 0
+
+
+async def _start(workspace: str) -> int:
+    """Prefer Transport v2; retain the old bridge only for migration."""
+    try:
+        credentials = load_gateway_credentials()
+    except RuntimeError:
+        private_link = load_private_link()
+        for attempt in range(1, 4):
+            bridge = MCPBridge(private_link)
+            try:
+                return await _run_app(bridge, workspace)
+            except BaseException as exc:
+                if attempt >= 3 or not is_transient_disconnect(exc):
+                    raise
+                print(
+                    f"Legacy connection interrupted. Reconnecting ({attempt}/3)…",
+                    file=sys.stderr,
+                )
+                await asyncio.sleep(float(attempt))
+        return 1
+
+    for attempt in range(1, 4):
+        bridge = GatewayBridge(credentials)
+        try:
+            return await _run_app(bridge, workspace)
+        except BaseException as exc:
+            credentials = dict(bridge.credentials)
+            if attempt >= 3 or not is_transient_disconnect(exc):
+                raise
+            print(
+                f"ZeCode connection interrupted. Reconnecting ({attempt}/3)…",
+                file=sys.stderr,
+            )
+            await asyncio.sleep(float(attempt))
+    return 1
+
+
+def _gateway_for_login(explicit: str) -> str:
+    if str(explicit or "").strip():
+        return normalize_gateway_url(explicit)
+    stored = load_gateway_url()
+    if stored:
+        return stored
+    entered = input(
+        "ZeCode Gateway URL (for example https://host.example/zecode/v2): "
+    ).strip()
+    return normalize_gateway_url(entered)
+
+
+async def _login(gateway: str, device_name: str) -> int:
+    endpoint = _gateway_for_login(gateway)
+    health = await gateway_health(endpoint)
+    if not health.get("ok"):
+        raise RuntimeError(
+            str(health.get("error") or "ZeCode Gateway is not ready"))
+    pairing = await begin_device_pairing(
+        endpoint,
+        device_name=(
+            str(device_name or "").strip()
+            or "ZeCode on " + socket.gethostname()
+        ),
+    )
+    code = str(pairing.get("user_code") or "")
+    command = str(pairing.get("verification_command") or "/zecode-pair " + code)
+    print("")
+    print("ZeCode device code: " + code)
+    print("In your Zephyr Discord server, run:")
+    print("  " + command)
+    print("Waiting for owner approval…")
+    interval = max(1, int(pairing.get("interval") or 2))
+    deadline = time.monotonic() + max(30, int(pairing.get("expires_in") or 600))
+    while time.monotonic() < deadline:
+        result = await poll_device_pairing(
+            endpoint, device_code=str(pairing.get("device_code") or ""))
+        if result.get("ok"):
+            save_gateway_credentials(result)
+            clear_private_link()
+            print("ZeCode is linked securely to this device.")
+            return 0
+        await asyncio.sleep(interval)
+    raise RuntimeError("The ZeCode device code expired. Run: zecode login")
+
+
+async def _doctor(explicit_gateway: str) -> int:
+    endpoint = _gateway_for_login(explicit_gateway)
+    print("ZeCode doctor")
+    print("  gateway: " + endpoint)
+    health = await gateway_health(endpoint)
+    print("  HTTPS: " + ("PASS" if health.get("http_status") else "FAIL"))
+    print("  Gateway v2: " + ("PASS" if health.get("ok") else "FAIL"))
+    print("  Server version: " + str(health.get("version") or "unknown"))
+    try:
+        credentials = load_gateway_credentials()
+    except RuntimeError:
+        print("  Device token: NOT LINKED (run: zecode login)")
+        return 2
+    bridge = GatewayBridge(credentials)
+    async with bridge:
+        identity = await bridge.probe_identity()
+    device = identity.get("device") or {}
+    print("  Device token: PASS")
+    print("  Device: " + str(device.get("device_name") or "unknown"))
+    print("  Transport: HTTPS JSON v2")
+    return 0
+
+
+async def _logout() -> int:
+    try:
+        credentials = load_gateway_credentials()
+    except RuntimeError:
+        credentials = {}
+    if credentials:
+        try:
+            bridge = GatewayBridge(credentials)
+            async with bridge:
+                await bridge.revoke()
+        except Exception:
+            # Local logout must still succeed when the server is offline.
+            pass
+    removed = clear_gateway_credentials()
+    legacy_removed = clear_private_link()
+    removed = removed or legacy_removed
+    print("ZeCode device access removed." if removed else "ZeCode was not linked.")
+    return 0
+
+
+def _legacy_login() -> int:
+    private_link = getpass(
+        "Paste the complete owner private link from Discord /mcp-link: ").strip()
+    if not private_link.startswith("https://") or "/mcp/private/" not in private_link:
+        raise SystemExit("Invalid private link. Paste the complete HTTPS URL.")
+    save_private_link(private_link)
+    print("Legacy owner link saved. Run `zecode login` to move to Gateway v2.")
+    return 0
+
+
+def _launch_update() -> int:
+    pipx = shutil.which("pipx")
+    if not pipx:
+        print("ZeCode update requires pipx.", file=sys.stderr)
+        print("Install it in PowerShell with:", file=sys.stderr)
+        print("  py -m pip install --user pipx", file=sys.stderr)
+        print("  py -m pipx ensurepath", file=sys.stderr)
+        return 2
+    try:
+        metadata.version(PYPI_DISTRIBUTION)
+        action = "upgrade"
+        label = "Updating"
+    except metadata.PackageNotFoundError:
+        action = "install"
+        label = "Migrating this source installation to"
+    print("ZeCode update")
+    print(f"  {label} {PYPI_DISTRIBUTION} through pipx...")
+    completed = subprocess.run(
+        [pipx, action, PYPI_DISTRIBUTION],
+        check=False,
+    )
+    if completed.returncode:
+        print(
+            "ZeCode update failed. pipx kept the current installation unchanged.",
+            file=sys.stderr,
+        )
+    else:
+        print("ZeCode update completed in this terminal.")
+    return int(completed.returncode)
+
+
+def _friendly_error(exc: BaseException) -> str:
+    current = exc
+    seen: set[int] = set()
+    while id(current) not in seen:
+        seen.add(id(current))
+        nested = getattr(current, "exceptions", None)
+        if not nested:
+            break
+        current = nested[0]
+    message = str(current or type(current).__name__).strip()
+    try:
+        credentials = load_gateway_credentials()
+    except RuntimeError:
+        credentials = {}
+    for value in (
+        credentials.get("access_token"), credentials.get("refresh_token"),
+    ):
+        if value:
+            message = message.replace(str(value), "<device-token>")
+    try:
+        private_link = load_private_link()
+    except (OSError, RuntimeError, ValueError):
+        private_link = ""
+    if private_link:
+        message = message.replace(private_link, "<private-link>")
+    return message[:800] or type(current).__name__
+
+
+def main() -> int:
+    args = _parser().parse_args()
+    try:
+        if args.update_requested:
+            return _launch_update()
+        if args.command == "login":
+            return asyncio.run(_login(args.gateway, args.device_name))
+        if args.command == "logout":
+            return asyncio.run(_logout())
+        if args.command == "doctor":
+            return asyncio.run(_doctor(args.gateway))
+        if args.command == "legacy-login":
+            return _legacy_login()
+        if args.command == "update":
+            return _launch_update()
+        return asyncio.run(_start(args.workspace))
+    except KeyboardInterrupt:
+        return 130
+    except Exception as exc:
+        print("ZeCode could not start: " + _friendly_error(exc), file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())