kiwi-code 0.0.446__tar.gz → 0.0.447__tar.gz

kiwi_code-0.0.447/CLAUDE.md

@@ -0,0 +1,79 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Kiwi Code is a TUI + CLI client for the Kiwi AI platform. It provides a chat interface (Textual) and CLI tools (Typer) for managing AI actions, action graphs, and their runs. A WebSocket-based runtime agent executes shell commands on behalf of the LLM.
+
+## Build & Run Commands
+
+```bash
+# Package manager: uv | Build backend: hatchling | Python: 3.13+
+uv sync                    # Install/sync dependencies
+uv build                   # Build package
+
+# Run
+make run                   # Launch TUI (kiwi)
+make dev                   # TUI with live reload
+make serve                 # Serve TUI in browser (port 8566)
+make cli                   # Run CLI (kiwicli)
+make runtime ARGS="..."    # Run runtime agent with args
+
+# Test
+make test-hello            # Test backend API connection
+uv run python test_hello.py  # Same, without make
+
+# Clean
+make clean                 # Remove caches and build artifacts
+```
+
+There are three entry points defined in pyproject.toml:
+- `kiwi` → `kiwi_tui.main:main` (TUI)
+- `kiwicli` → `kiwi_cli.cli:cli` (CLI)
+- `kiwi-runtime` → `kiwi_runtime.main:main` (WebSocket agent)
+
+## Architecture
+
+```
+┌─────────────────────────────────┐
+│      Shared Libraries           │
+│  commands.py · client.py        │
+│  auth.py · models.py · server.py│
+└──────────┬──────────┬───────────┘
+           │          │
+    ┌──────▼──────┐   └──────────────┐
+    │ kiwi (TUI)  │   kiwicli (CLI)  │
+    │ Textual app │   Typer CLI      │
+    └──────┬──────┘   └──────────────┘
+           │ auto-starts
+    ┌──────▼──────────────────┐
+    │ kiwi-runtime            │
+    │ WebSocket agent         │
+    │ One per working dir     │
+    │ Survives TUI restarts   │
+    └─────────────────────────┘
+```
+
+**Key design decisions:**
+- Shared infrastructure lives in `kiwi_cli`; TUI imports from it via absolute imports (e.g., `from kiwi_cli.auth import TokenManager`)
+- One runtime agent per working directory, managed via `runtime_manager.py`
+- Runtime state stored in `~/.kiwi/runtimes/<key>/` (pid, log, cwd, tokens)
+- Auth tokens stored in `~/.kiwi/tokens.json` with 0600 permissions
+- No persisted app config; server is selected per invocation via `--server` (defaults to prod)
+
+## Three Source Packages
+
+- **`src/kiwi_cli/`** — Typer CLI app and shared infrastructure: auth, client, server, commands, models, runtime_manager, logger. Both `kiwi_tui` and the CLI entry point depend on this package.
+- **`src/kiwi_tui/`** — Textual TUI app, screens, and widgets. Imports shared modules from `kiwi_cli`.
+- **`src/kiwi_runtime/`** — Standalone WebSocket agent (~43KB `main.py`) that connects to Kiwi server and executes shell commands, sandboxed to CWD by default
+
+## Server Presets (runtime)
+
+- `app` → `https://api.meetkiwi.ai` (production)
+- `dev` → `https://dev.api.myautobots.com` (default for TUI)
+- `local` → `http://localhost:8000`
+
+## CI/CD
+
+GitHub Actions (`publish.yml`): triggered by manual dispatch or `v*.*.*` tags. Runs smoke tests (`kiwicli --help`, `kiwi-runtime --help`, `kiwicli runtime status`), builds, and publishes to PyPI.

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kiwi-code
-Version: 0.0.446
+Version: 0.0.447
 Summary: A textual-based terminal user interface application
 Project-URL: Homepage, https://meetkiwi.ai
 Author-email: Anurag <anurag@meetkiwi.co>
@@ -14,11 +14,11 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <4.0,>=3.11
+Requires-Dist: autobots-client==0.1.1
 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: pykiwiai==0.0.11
 Requires-Dist: setproctitle>=1.3.0
 Requires-Dist: textual-dev>=1.8.0
 Requires-Dist: textual>=8.1.1

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "kiwi-code"
-version = "0.0.446"
+version = "0.0.447"
 description = "A textual-based terminal user interface application"
 readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.11,<4.0"
 dependencies = [
-    "pykiwiai==0.0.11",
+    "autobots-client==0.1.1",
     "loguru>=0.7.3",
     "pydantic>=2.12.5",
     "textual>=8.1.1",
@@ -54,9 +54,8 @@ filterwarnings = [
     "ignore::DeprecationWarning",
 ]
 
-
 [tool.hatch.build.targets.wheel]
-packages = ["src/common", "src/kiwi_cli", "src/kiwi_tui", "src/kiwi_runtime"]
+packages = ["src/kiwi_cli", "src/kiwi_tui", "src/kiwi_runtime"]
 
 [build-system]
 requires = ["hatchling"]

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/src/kiwi_cli/__init__.py

@@ -1,3 +1,4 @@
 """Kiwi CLI - command-line interface and shared infrastructure modules."""
 
-__version__ = "0.0.446"
+
+__version__ = "0.0.447"

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/src/kiwi_cli/cli.py

@@ -3,7 +3,7 @@ from typing import Optional, Callable
 from loguru import logger
 logger.remove()  # Suppress loguru console output in CLI mode
 import typer
-from pykiwiai import AuthenticatedClient
+from autobots_client import AuthenticatedClient
 from .auth import TokenManager
 from .models import AppConfig
 from .server import http_url_from_server

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/src/kiwi_cli/client.py

@@ -6,20 +6,20 @@ import json
 import codecs
 import httpx
 from loguru import logger
-from pykiwiai import Client, AuthenticatedClient
-from pykiwiai.api.hello import hello_v1_hello_get
-from pykiwiai.api.auth import (
+from autobots_client import Client, AuthenticatedClient
+from autobots_client.api.hello import hello_v1_hello_get
+from autobots_client.api.auth import (
     return_user_and_session_v1_auth_post,
 )
-from pykiwiai.api.actions import async_run_action_v1_actions_id_async_run_post
-from pykiwiai.api.action_results import get_action_result_v1_action_results_id_get
-from pykiwiai.models.body_return_user_and_session_v1_auth_post import (
+from autobots_client.api.actions import async_run_action_v1_actions_id_async_run_post
+from autobots_client.api.action_results import get_action_result_v1_action_results_id_get
+from autobots_client.models.body_return_user_and_session_v1_auth_post import (
     BodyReturnUserAndSessionV1AuthPost,
 )
-from pykiwiai.models.body_async_run_action_v1_actions_id_async_run_post import (
+from autobots_client.models.body_async_run_action_v1_actions_id_async_run_post import (
     BodyAsyncRunActionV1ActionsIdAsyncRunPost,
 )
-from pykiwiai.models.body_async_run_action_v1_actions_id_async_run_post_input import (
+from autobots_client.models.body_async_run_action_v1_actions_id_async_run_post_input import (
     BodyAsyncRunActionV1ActionsIdAsyncRunPostInput,
 )
 from .models import AuthTokens, LoginCredentials
@@ -253,8 +253,8 @@ class AutobotsClientWrapper:
 
             import mimetypes
             from pathlib import Path
-            from pykiwiai.api.files import upload_files_v1_files_post
-            from pykiwiai.models.body_upload_files_v1_files_post import BodyUploadFilesV1FilesPost
+            from autobots_client.api.files import upload_files_v1_files_post
+            from autobots_client.models.body_upload_files_v1_files_post import BodyUploadFilesV1FilesPost
 
             # Validate all files exist first
             paths = []
@@ -344,7 +344,7 @@ class AutobotsClientWrapper:
             logger.info(f"Request body: {body.to_dict()}")
 
             # Import UNSET for optional parameter
-            from pykiwiai.types import UNSET
+            from autobots_client.types import UNSET
 
             response = async_run_action_v1_actions_id_async_run_post.sync_detailed(
                 id=action_id,
@@ -464,8 +464,7 @@ class AutobotsClientWrapper:
                 logger.info(f"Result structure keys: {result_dict.keys()}")
                 if "result" in result_dict and isinstance(result_dict["result"], dict):
                     logger.info(f"Result.result keys: {result_dict['result'].keys()}")
-                    result = result_dict['result']
-                    logger.info(f"Result's results : {result['results']}")
+
                 return True, result_dict, "Result retrieved"
             else:
                 error_msg = f"Failed to get result: status {response.status_code}"

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/src/kiwi_cli/commands.py

@@ -5,17 +5,17 @@ and returns a list of strings (output lines).
 """
 
 from typing import Optional
-from pykiwiai import AuthenticatedClient
-from pykiwiai.api.actions import (
+from autobots_client import AuthenticatedClient
+from autobots_client.api.actions import (
     list_actions_v1_actions_get,
     get_action_v1_actions_id_get,
 )
-from pykiwiai.api.action_results import (
+from autobots_client.api.action_results import (
     list_action_result_v1_action_results_get,
     get_action_result_v1_action_results_id_get,
 )
 
-from pykiwiai.types import UNSET
+from autobots_client.types import UNSET
 
 
 # Helpers
@@ -35,18 +35,6 @@ def _val(v) -> str:
     return str(v)
 
 
-def _enum(v) -> str:
-    """Return a stable string for either Enum-like objects or plain strings.
-
-    pykiwiai <=0.0.1 used Enum types (value attribute).
-    pykiwiai >=0.0.11 uses Literal[str] so fields are plain strings.
-    """
-    if v is None or isinstance(v, type(UNSET)):
-        return ""
-    return str(getattr(v, "value", v))
-
-
-
 # actions
 
 def actions_list(client: AuthenticatedClient, *, name: Optional[str] = None, limit: int = 20, offset: int = 0) -> list[str]:
@@ -69,7 +57,7 @@ def actions_list(client: AuthenticatedClient, *, name: Optional[str] = None, lim
     ]
     for doc in result.docs:
         lines.append(
-            f"{doc.field_id:<28} {_val(doc.name):<30} {_val(_enum(doc.type_)):<25} "
+            f"{doc.field_id:<28} {_val(doc.name):<30} {_val(doc.type_.value):<25} "
             f"{_val(doc.version):<6} {_fmt_date(doc.created_at)}"
         )
     return lines
@@ -85,7 +73,7 @@ def actions_get(client: AuthenticatedClient, *, id: str) -> list[str]:
     return [
         f"ID:          {doc.field_id}",
         f"Name:        {doc.name}",
-        f"Type:        {_enum(doc.type_)}",
+        f"Type:        {doc.type_.value}",
         f"Version:     {_val(doc.version)}",
         f"Description: {_val(doc.description)}",
         f"Published:   {_val(doc.is_published)}",
@@ -100,13 +88,13 @@ def actions_get(client: AuthenticatedClient, *, id: str) -> list[str]:
 def runs_list(client: AuthenticatedClient, *, action_id: Optional[str] = None, action_name: Optional[str] = None,
               status: Optional[str] = None, limit: int = 20, offset: int = 0) -> list[str]:
     """List action runs. Returns output lines."""
-    from pykiwiai.models.event_result_status import check_event_result_status
+    from autobots_client.models.event_result_status import EventResultStatus
 
     status_enum = UNSET
     if status:
         try:
-            status_enum = check_event_result_status(status.lower())
-        except TypeError:
+            status_enum = EventResultStatus(status.lower())
+        except ValueError:
             return [f"Invalid status: {status}. Valid: processing, success, error, stuck, waiting"]
 
     resp = list_action_result_v1_action_results_get.sync_detailed(
@@ -129,7 +117,7 @@ def runs_list(client: AuthenticatedClient, *, action_id: Optional[str] = None, a
     ]
     for doc in result.docs:
         lines.append(
-            f"{doc.field_id:<28} {_enum(doc.status):<12} {_val(doc.name):<30} "
+            f"{doc.field_id:<28} {doc.status.value:<12} {_val(doc.name):<30} "
             f"{_fmt_date(doc.created_at):<18} {_fmt_date(doc.updated_at)}"
         )
     return lines
@@ -144,9 +132,9 @@ def runs_get(client: AuthenticatedClient, *, id: str) -> list[str]:
     doc = resp.parsed
     lines = [
         f"ID:          {doc.field_id}",
-        f"Status:      {_enum(doc.status)}",
+        f"Status:      {doc.status.value}",
         f"Name:        {_val(doc.name)}",
-        f"Type:        {_enum(doc.type_)}",
+        f"Type:        {doc.type_.value}",
         f"Saved:       {_val(doc.is_saved)}",
         f"Created:     {_fmt_date(doc.created_at)}",
         f"Updated:     {_fmt_date(doc.updated_at)}",
@@ -156,7 +144,7 @@ def runs_get(client: AuthenticatedClient, *, id: str) -> list[str]:
             "",
             "Action:",
             f"  Name:    {doc.result.name}",
-            f"  Type:    {_enum(doc.result.type_)}",
+            f"  Type:    {doc.result.type_.value}",
             f"  ID:      {doc.result.field_id}",
         ]
     return lines

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/src/kiwi_cli/models.py

@@ -115,7 +115,7 @@ class LoginCredentials(BaseModel):
 
 class AppConfig(BaseModel):
     """Application configuration."""
-    backend_url: str = "https://api.runkai.ai"
+    backend_url: str = "https://api.meetkiwi.ai"
     api_key: Optional[str] = None
     log_level: str = "INFO"
     theme: str = "dark"

{kiwi_code-0.0.446 → kiwi_code-0.0.447}/src/kiwi_cli/server.py

@@ -11,7 +11,7 @@ The value can be:
 This module intentionally contains *no persistence*. It is runtime-only.
 """
 SERVER_PRESETS: dict[str, dict[str, str]] = {
-    "app": {"ws": "wss://api.runkai.ai", "http": "https://api.runkai.ai"},
+    "app": {"ws": "wss://api.meetkiwi.ai", "http": "https://api.meetkiwi.ai"},
     "dev": {"ws": "wss://dev.api.myautobots.com", "http": "https://dev.api.myautobots.com"},
     "local": {"ws": "ws://localhost:8000", "http": "http://localhost:8000"},
 }