Rename package from "pine-ai" to "pine-assistant" and update related references in configuration, README, and CLI. Add initial implementation of the assistant SDK with core functionalities including authentication, session management, and chat capabilities.

Author: bojieli

.github/workflows/ci.yml

@@ -30,7 +30,7 @@ jobs:
         run: pip install .
 
       - name: Verify import
-        run: python -c "from pine_ai import PineAI, AsyncPineAI, __version__; print(f'pine-ai {__version__} OK')"
+        run: python -c "from pine_assistant import PineAI, AsyncPineAI, __version__; print(f'pine-assistant {__version__} OK')"
 
       - name: Run tests
         run: pip install pytest pytest-asyncio && pytest tests/ -v --ignore=tests/integration || echo "No unit tests yet"

README.md

@@ -1,22 +1,22 @@
-# pine-ai
+# pine-assistant
 
-[![PyPI version](https://img.shields.io/pypi/v/pine-ai)](https://pypi.org/project/pine-ai/)
-[![Python versions](https://img.shields.io/pypi/pyversions/pine-ai)](https://pypi.org/project/pine-ai/)
-[![license](https://img.shields.io/pypi/l/pine-ai)](./LICENSE)
+[![PyPI version](https://img.shields.io/pypi/v/pine-assistant)](https://pypi.org/project/pine-assistant/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pine-assistant)](https://pypi.org/project/pine-assistant/)
+[![license](https://img.shields.io/pypi/l/pine-assistant)](./LICENSE)
 
 Pine AI SDK for Python. Let Pine AI handle your digital chores.
 
 ## Install
 
 ```bash
-pip install pine-ai          # SDK only
-pip install pine-ai[cli]     # SDK + CLI
+pip install pine-assistant          # SDK only
+pip install pine-assistant[cli]     # SDK + CLI
 ```
 
 ## Quick Start (Async)
 
 ```python
-from pine_ai import AsyncPineAI
+from pine_assistant import AsyncPineAI
 
 client = AsyncPineAI(access_token="...", user_id="...")
 await client.connect()
@@ -77,7 +77,7 @@ not individual chunks. Work log parts are debounced (3s silence).
 Pro subscription recommended. For non-subscribers:
 
 ```python
-from pine_ai import AsyncPineAI
+from pine_assistant import AsyncPineAI
 print(f"Pay at: {AsyncPineAI.session_url(session_id)}")
 ```
 

RELEASING.md

@@ -1,12 +1,12 @@
-# Releasing pine-ai (Python)
+# Releasing pine-assistant (Python)
 
 This package uses **PyPI trusted publishing** (OIDC) — no PyPI tokens are stored in GitHub.
 
 ## One-time setup
 
 ### Register the trusted publisher on PyPI
 
-1. Go to <https://pypi.org/manage/project/pine-ai/settings/publishing/> (or add a **pending publisher** at <https://pypi.org/manage/account/publishing/> if the project doesn't exist on PyPI yet).
+1. Go to <https://pypi.org/manage/project/pine-assistant/settings/publishing/> (or add a **pending publisher** at <https://pypi.org/manage/account/publishing/> if the project doesn't exist on PyPI yet).
 2. Under **Add a new publisher**, fill in:
    - **Owner:** `pineai`
    - **Repository:** `pine-python`
@@ -22,7 +22,7 @@ It installs, imports, builds, and verifies the package across Python 3.10 – 3.
 
 1. Bump the version in **both** places:
    - `pyproject.toml` → `version = "X.Y.Z"`
-   - `src/pine_ai/__init__.py` → `__version__ = "X.Y.Z"`
+   - `src/pine_assistant/__init__.py` → `__version__ = "X.Y.Z"`
 2. Commit, tag, and push:
    ```bash
    git add -A && git commit -m "release: vX.Y.Z"

pyproject.toml

@@ -3,14 +3,14 @@ requires = ["setuptools>=68.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "pine-ai"
+name = "pine-assistant"
 version = "0.1.0"
 description = "Pine AI SDK — Let Pine AI handle your digital chores. Socket.IO + REST client."
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
 authors = [{name = "Pine AI"}]
-keywords = ["pine-ai", "pine", "ai", "customer-service", "sdk", "socketio"]
+keywords = ["pine-assistant", "pine", "ai", "customer-service", "sdk", "socketio"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -39,10 +39,10 @@ Repository = "https://github.com/pineai/pine-python"
 Issues = "https://github.com/pineai/pine-python/issues"
 
 [project.scripts]
-pine = "pine_ai.cli.main:main"
+pine = "pine_assistant.cli.main:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
 [tool.setuptools.package-data]
-pine_ai = ["py.typed"]
+pine_assistant = ["py.typed"]

src/pine_ai/__init__.py

@@ -0,0 +1,27 @@
+"""
+pine-assistant — Pine AI SDK for Python.
+
+Let Pine AI handle your digital chores.
+Socket.IO + REST client for the Pine AI backend.
+"""
+
+from pine_assistant.client import PineAI, AsyncPineAI
+from pine_assistant.auth import Auth
+from pine_assistant.sessions import SessionsAPI
+from pine_assistant.errors import PineAIError, AuthError, SessionError, ConnectionError
+from pine_assistant.models.events import C2SEvent, S2CEvent, NotificationEvent
+
+__version__ = "0.1.0"
+__all__ = [
+    "PineAI",
+    "AsyncPineAI",
+    "Auth",
+    "SessionsAPI",
+    "PineAIError",
+    "AuthError",
+    "SessionError",
+    "ConnectionError",
+    "C2SEvent",
+    "S2CEvent",
+    "NotificationEvent",
+]

src/pine_ai/models/__init__.py

@@ -6,8 +6,8 @@
 
 from typing import Any
 
-from pine_ai.transport.http import HttpClient
-from pine_ai.errors import AuthError
+from pine_assistant.transport.http import HttpClient
+from pine_assistant.errors import AuthError
 
 
 class Auth:

src/pine_assistant/__init__.py

@@ -11,8 +11,8 @@
 import time
 from typing import Any, AsyncGenerator, Callable, Coroutine, Optional
 
-from pine_ai.models.events import C2SEvent, S2CEvent
-from pine_ai.transport.socketio import SocketIOManager
+from pine_assistant.models.events import C2SEvent, S2CEvent
+from pine_assistant.transport.socketio import SocketIOManager
 
 TERMINAL_STATES = {"task_finished", "task_cancelled", "task_stale"}
 DEFAULT_IDLE_TIMEOUT_S = 120.0