kiwi-code 0.0.4__py3-none-any.whl

kiwi_code-0.0.4.dist-info/METADATA

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: kiwi-code
+Version: 0.0.4
+Summary: A textual-based terminal user interface application
+Project-URL: Homepage, https://meetkiwi.ai
+Project-URL: Repository, https://github.com/jetoslabs/kiwi-code
+Author-email: Anurag Jha <anurag@meetkiwi.co>
+License: MIT
+Keywords: cli,terminal,textual,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <4.0,>=3.13
+Requires-Dist: autobots-client==0.1.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: textual-dev>=1.8.0
+Requires-Dist: textual>=8.1.1
+Requires-Dist: typer>=0.24.1
+Requires-Dist: websockets>=14.1
+Description-Content-Type: text/markdown
+
+# Kiwi Code
+
+A terminal-based interface for the [Kiwi AI](https://meetkiwi.ai) platform. Built with [Textual](https://textual.textualize.io/) and [Typer](https://typer.tiangolo.com/), it provides a chat-style TUI and command-line access to manage and interact with actions, action graphs, and their runs.
+
+Requires Python 3.13+.
+
+## Architecture
+
+Kiwi Code has three entry points, but they are **not three services** — they are independent frontends to the same shared code:
+
+```
+                  ┌──────────────────────────────────┐
+                  │         Shared Libraries          │
+                  │                                    │
+                  │  commands.py   Command handlers    │
+                  │  client.py     HTTP/SSE client     │
+                  │  auth.py       Token management    │
+                  │  autobots_client  (generated SDK)  │
+                  └──────┬───────────┬─────────────────┘
+                         │           │
+              ┌──────────┘           └──────────┐
+              │                                  │
+     ┌────────▼────────┐              ┌─────────▼─────────┐
+     │   kiwi (TUI)    │              │  kiwicli (CLI)     │
+     │                  │              │                    │
+     │  Full-screen     │              │  Typer commands    │
+     │  Textual app     │              │  for scripting     │
+     │                  │              │  and automation    │
+     └────────┬─────────┘              └────────────────────┘
+              │ auto-starts
+              │ (if not already running)
+              │
+     ┌────────▼──────────────────────────────────────────┐
+     │                kiwi-runtime                        │
+     │                                                    │
+     │  Independent process — one per working directory   │
+     │  Connects to Kiwi server via WebSocket             │
+     │  Executes shell commands for the LLM agent         │
+     │                                                    │
+     │  Can also be started directly:                     │
+     │    kiwi-runtime connect --server app               │
+     │                                                    │
+     │  Survives TUI quit, logout, and restarts           │
+     │  Stop explicitly: kiwicli runtime stop             │
+     └───────────────────────────────────────────────────┘
+```
+
+**Key points:**
+
+- **`kiwi` and `kiwicli` do not depend on each other.** They both import the same `commands.py`, `client.py`, and `auth.py` modules directly. Neither needs the other to be running.
+- **`kiwi` automatically spawns `kiwi-runtime`** when you log in. The runtime runs as an independent process — quitting or restarting the TUI does **not** kill it.
+- **One runtime per directory.** Each working directory gets its own runtime, scoped to that directory. Opening the TUI in two different project folders runs two independent runtimes.
+- **`kiwicli` is for headless/scripting use.** It provides the same query commands (actions, runs, graphs) as the TUI, but as standalone CLI commands.
+- **Authentication is shared.** Both use `TokenManager` to read/write tokens from `~/.autobots-tui/tokens.json`, so logging in via one works for the other.
+- **Runtime lifecycle is independent.** The runtime persists across TUI restarts. Use `kiwicli runtime stop` to explicitly stop it.
+
+## Installation
+
+```bash
+pip install kiwi-code
+```
+
+This installs three commands:
+
+| Command | Description |
+|---------|-------------|
+| `kiwi` | Launch the interactive TUI (auto-starts runtime) |
+| `kiwicli` | CLI for scripting — login, query actions/runs/graphs |
+| `kiwi-runtime` | WebSocket agent for LLM command execution (usually auto-started by TUI) |
+
+## Quick Start
+
+```bash
+# Login (once — tokens are saved locally)
+kiwicli login
+
+# Launch the interactive TUI (starts runtime automatically)
+kiwi
+
+# Or use CLI commands directly
+kiwicli actions list
+kiwicli runs list --status processing
+```
+
+## Commands
+
+```
+kiwicli login                                  Authenticate with email and password
+kiwicli logout                                 Logout and clear saved tokens
+kiwicli whoami                                 Check authentication status
+kiwicli tui                                    Launch the interactive TUI
+
+kiwicli actions list [--name N]                List actions
+kiwicli actions get <id>                       Get action details
+
+kiwicli runs list [--action-id ID]             List action runs (results)
+       [--action-name N] [--status S]
+kiwicli runs get <id>                          Get run details
+
+kiwicli graphs list [--name N]                 List action graphs
+kiwicli graphs get <id>                        Get graph details
+
+kiwicli graph-runs list [--graph-id ID]        List graph runs (results)
+       [--graph-name N] [--status S]
+kiwicli graph-runs get <id>                    Get graph run details
+
+kiwicli runtime status                         Check if runtime is running (current dir)
+kiwicli runtime stop [--all]                   Stop runtime (current dir, or all)
+kiwicli runtime list                           List all runtimes across directories
+kiwicli runtime logs                           Tail the runtime log (current dir)
+```
+
+All list commands support `--limit` and `--offset` for pagination. Runs can be filtered by `--status` (processing, success, error, stuck, waiting).
+
+## Interactive TUI
+
+Launch with `kiwi` or `kiwicli tui`. The TUI provides a full-screen chat interface for conversing with actions in real time.
+
+- **Chat interface** — Send messages to actions and receive streamed responses via SSE
+- **Session management** — Switch actions, continue existing runs, or start new conversations
+- **Slash commands** — All CLI commands work inside the TUI chat with a `/` prefix
+- **Authentication** — Login screen with automatic token refresh
+- **Runtime logs** — View the runtime agent's output in real time (`Ctrl+R`)
+- **Theming** — Dark/light mode toggle (`Ctrl+D`)
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Ctrl+C` | Quit |
+| `Ctrl+R` | Runtime logs |
+| `Ctrl+D` | Toggle dark/light mode |
+| `Ctrl+L` | Logout |
+
+### Slash Commands (inside TUI)
+
+```
+/use <action_id>              Switch to a different action
+/continue <run_id>            Continue an existing conversation run
+/new                          Start a new conversation (resets to default action)
+/status                       Show current action and run IDs
+
+/actions list                 List all actions
+/runs list --status success   Filter runs by status
+/graphs get <id>              View graph details
+/help                         Show all available commands
+```
+
+### Streaming
+
+Actions execute asynchronously. The TUI streams status updates in real time via SSE and automatically fetches the final result on completion. Falls back to polling if the SSE stream ends without delivering a result.
+
+## Runtime Agent
+
+The runtime agent connects to the Kiwi server via WebSocket and executes terminal commands on behalf of the LLM agent.
+
+The TUI auto-starts the runtime on login. Each working directory gets its own runtime instance, restricted to that directory. The runtime runs as an **independent process** — it survives TUI quit, logout, and restarts. When the TUI starts again, it detects the running runtime and reattaches to its logs.
+
+To manage runtimes independently:
+
+```bash
+kiwicli runtime status    # Check if running (for current directory)
+kiwicli runtime stop      # Stop the runtime (for current directory)
+kiwicli runtime stop --all # Stop all runtimes
+kiwicli runtime list      # List all runtimes across directories
+kiwicli runtime logs      # Tail the runtime log (for current directory)
+```
+
+You can also run it standalone:
+
+```bash
+kiwi-runtime connect --server app           # Production (api.meetkiwi.ai)
+kiwi-runtime connect --server dev           # Development
+kiwi-runtime connect --server local         # Localhost
+kiwi-runtime connect --server wss://custom  # Custom URL
+kiwi-runtime connect --scope full           # Unrestricted execution (default: restricted)
+kiwi-runtime connect --allow /extra/dir     # Allow additional directory in restricted mode
+```
+
+In **restricted mode** (default), commands are sandboxed to the current working directory. The `--allow` flag adds extra allowed paths.
+
+## Configuration
+
+Stored at `~/.autobots-tui/config.json`:
+
+```json
+{
+  "backend_url": "https://api.example.com",
+  "log_level": "INFO",
+  "theme": "dark",
+  "refresh_interval": 5
+}
+```
+
+Logs are written to `~/.autobots-tui/autobots_tui.log`.
+
+## Development
+
+```bash
+git clone https://github.com/jetoslabs/kiwi-code.git
+cd kiwi-code
+uv sync
+uv run kiwi
+```
+
+## License
+
+MIT

kiwi_code-0.0.4.dist-info/RECORD

@@ -0,0 +1,24 @@
+kiwi_runtime/__init__.py,sha256=ZReaJwO3ZZMDQeei-5lkwkHC9GKYuzJBGOZjreJawYI,104
+kiwi_runtime/__main__.py,sha256=FxmEl4G17ig5ByYU88qFKJn9xj2RbUoLCqpBIl6LN2I,79
+kiwi_runtime/main.py,sha256=1Ci7iLnJjxPmBOZBLtSxjpKMup38VPB8FPxIn2hFHg0,36827
+kiwi_tui/__init__.py,sha256=UXU9lAZ-Z0xZXaRvPgStWQueAzbW4fkOkLG0QWaxWw4,85
+kiwi_tui/auth.py,sha256=qF7ejXX2_iI-_Dsv9Pg5F_CUw245QS4ptJ1oeAWVGjE,3585
+kiwi_tui/cli.py,sha256=5NB5EPktpUzq49HysKy67Tg0qJR-SupLbC5t5VfTG9A,8158
+kiwi_tui/client.py,sha256=wR1700-XwufV3G1lRkWtgZs0eRSLr82WkGfxUg6q5kw,22163
+kiwi_tui/commands.py,sha256=_YZrDsLr2vTKTnfjMoVsQ4FL3pYJN4htIBigejsdQSs,15677
+kiwi_tui/config.py,sha256=HtyWBLVg7JKgXAGtnF_uOA-1IT8rB7P1rHG4Ut8XAfQ,2503
+kiwi_tui/logger.py,sha256=ngDaZ_L3XGdsZDkpy1lR5kfFtgqLCifrEHmhcSnUDGM,963
+kiwi_tui/main.py,sha256=LTAwjcwmlX4x0q_wtc15Z09wUyOoJJDNF74eOkLKr3Q,11042
+kiwi_tui/models.py,sha256=aF_wbjVcB8OQBhQWstYrD4LgaLasinspJHp0nHjP0MY,2163
+kiwi_tui/runtime_manager.py,sha256=2nSL_ada1JOEziQ8iGnRaZZjqG5bq4pPQw8-CzhSL7Y,3698
+kiwi_tui/widgets.py,sha256=PFGJ-E9vgIOf__mYzB_4-NiwUmqrfk-wPyb4gXRTZ8A,4594
+kiwi_tui/screens/__init__.py,sha256=U2oRLA8rRQIi2h35Y-VQS9BGY8GVHUkib8_-6DPk5No,321
+kiwi_tui/screens/actions.py,sha256=oYVn4Fo4OMJjESkUJF8EEYhtnoEy9TXM7orahtIM7V8,8240
+kiwi_tui/screens/autobots.py,sha256=hA9n3Ru2e_Z6jc2ZZbw4-FOUDUvuLfSx9G2mxtF4I94,6407
+kiwi_tui/screens/dashboard.py,sha256=THJzYn1shOYai0VOzLDVaOkVhaWHKwyT0NMa0cgWivM,23481
+kiwi_tui/screens/login.py,sha256=zGrPciuAIbhfoe_XbhZsAn_1aD-QP8y27PkMFyEp5vA,8977
+kiwi_tui/screens/runtime_logs.py,sha256=3fV35kHSTEzNiHfebASP5Y_4mCysv2PALVjgvedE82I,2918
+kiwi_code-0.0.4.dist-info/METADATA,sha256=euPp9OWhzC2fNa5T1654hgEWtqDtOPw7gmNsdeIr5DI,10341
+kiwi_code-0.0.4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+kiwi_code-0.0.4.dist-info/entry_points.txt,sha256=W-gHjylQjsWHrWmnz-GQMsduaFMRkSbOTAUqxNlD2ks,109
+kiwi_code-0.0.4.dist-info/RECORD,,

kiwi_code-0.0.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

kiwi_code-0.0.4.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+kiwi = kiwi_tui.main:main
+kiwi-runtime = kiwi_runtime.main:main
+kiwicli = kiwi_tui.cli:cli

kiwi_runtime/__init__.py

@@ -0,0 +1,3 @@
+"""Kiwi Runtime — terminal agent that connects to the server via WebSocket."""
+
+__version__ = "0.1.0"

kiwi_runtime/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m kiwi_runtime"""
+
+from .main import main
+
+main()