dooers-workers 0.2.0__py3-none-any.whl

dooers_workers-0.2.0.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: dooers-workers
+Version: 0.2.0
+Summary: Python SDK for dooers.ai chat protocol
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: asyncpg>=0.31.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: sqlalchemy>=2.0.46
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Requires-Dist: ruff>=0.15.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# dooers-workers
+
+Python SDK for dooers.ai chat protocol.
+
+## Install
+
+```bash
+pip install dooers-workers
+```
+
+Or from source:
+
+```bash
+pip install git+https://github.com/dooers/dooers-workers.git
+```
+
+## Usage
+
+```python
+from fastapi import FastAPI, WebSocket
+from openai import AsyncOpenAI
+from dooers import WorkerServer, WorkerConfig
+
+app = FastAPI()
+openai = AsyncOpenAI()
+
+worker_server = WorkerServer(WorkerConfig(
+    database_url="sqlite:///worker.db",
+    database_type="sqlite",
+))
+
+
+async def agent_handler(request, response, memory, analytics, settings):
+    yield response.run_start()
+
+    # Track custom event
+    await analytics.track("llm.called", data={"model": "gpt-4o-mini"})
+
+    completion = await openai.chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[{"role": "user", "content": request.message}],
+    )
+
+    yield response.text(completion.choices[0].message.content)
+    yield response.run_end()
+
+
+@app.websocket("/ws")
+async def ws(websocket: WebSocket):
+    await websocket.accept()
+    await worker_server.handle(websocket, agent_handler)
+```
+
+## agent_handler
+
+```python
+async def agent_handler(request, response, memory, analytics, settings):
+    ...
+```
+
+### Request
+
+```python
+request.message      # str
+request.content      # list[ContentPart]
+request.thread_id    # str
+request.event_id     # str
+request.user_id      # str | None
+```
+
+### Memory
+
+```python
+# Get formatted history (defaults to OpenAI format)
+messages = await memory.get_history(limit=50)
+
+# Specify format for different providers
+messages = await memory.get_history(format="openai")
+messages = await memory.get_history(format="anthropic")
+messages = await memory.get_history(format="google")
+messages = await memory.get_history(format="cohere")
+messages = await memory.get_history(format="voyage")
+
+# Get raw ThreadEvent objects
+events = await memory.get_history_raw(limit=50)
+```
+
+### Response
+
+```python
+yield response.text("Hello, I'm your assistant.")
+yield response.image(url, mime_type?, alt?)
+yield response.document(url, filename, mime_type)
+yield response.tool_call(name, args)
+yield response.tool_result(name, result)
+yield response.run_start(agent_id?)
+yield response.run_end(status?, error?)
+```
+
+### Analytics
+
+```python
+await analytics.track("event.name", data={"key": "value"})
+await analytics.like("event", target_id, reason?)
+await analytics.dislike("event", target_id, reason?)
+```
+
+### Settings
+
+```python
+value = await settings.get("field_id")
+all_values = await settings.get_all()
+await settings.set("field_id", new_value)
+```
+
+## worker_server
+
+### Persistence
+
+Direct database access for threads, events, and settings.
+
+```python
+
+persistence = worker_server.persistence
+
+thread = await persistence.get_thread(thread_id)
+await persistence.create_thread(thread)
+await persistence.update_thread(thread)
+threads = await persistence.list_threads(worker_id, user_id, cursor, limit)
+
+await persistence.create_event(event)
+events = await persistence.get_events(thread_id, after_event_id, limit)
+
+settings = await persistence.get_settings(worker_id)
+await persistence.update_setting(worker_id, field_id, value)
+```
+
+### Broadcast
+
+Pushes events to WebSocket subscribers. `send_event` also persists the event and updates the thread timestamp.
+
+```python
+
+broadcast = worker_server.broadcast
+
+# Persist + broadcast a message (returns event, connections notified)
+event, count = await broadcast.send_event(worker_id, thread_id, content, actor)
+
+# Broadcast a thread change (no persistence, notification only)
+count = await broadcast.send_thread_update(worker_id, thread)
+
+# Create thread + broadcast (convenience)
+thread, count = await broadcast.create_thread_and_broadcast(worker_id, user_id, title)
+```
+
+## Settings Schema
+
+Define configurable settings for your worker:
+
+```python
+from dooers import (
+    WorkerConfig,
+    WorkerServer,
+    SettingsSchema,
+    SettingsField,
+    SettingsFieldType,
+    SettingsSelectOption,
+)
+
+schema = SettingsSchema(
+    fields=[
+        SettingsField(
+            id="model",
+            type=SettingsFieldType.SELECT,
+            label="Model",
+            value="gpt-4o-mini",
+            options=[
+                SettingsSelectOption(value="gpt-4o-mini", label="GPT-4o Mini"),
+                SettingsSelectOption(value="gpt-4o", label="GPT-4o"),
+            ],
+        ),
+        SettingsField(
+            id="temperature",
+            type=SettingsFieldType.NUMBER,
+            label="Temperature",
+            value=0.7,
+            min=0,
+            max=2,
+        ),
+    ]
+)
+
+worker_server = WorkerServer(WorkerConfig(
+    database_url="sqlite:///worker.db",
+    database_type="sqlite",
+    settings_schema=schema,
+))
+```
+
+### Field Types
+
+- `TEXT` - Single-line text input
+- `NUMBER` - Numeric input with optional min/max
+- `SELECT` - Dropdown selection
+- `CHECKBOX` - Boolean toggle
+- `TEXTAREA` - Multi-line text input
+- `PASSWORD` - Password input (hidden)
+- `EMAIL` - Email input
+- `DATE` - Date picker
+- `IMAGE` - Display-only image (e.g., QR codes)
+
+

dooers_workers-0.2.0.dist-info/RECORD

@@ -0,0 +1,33 @@
+dooers/__init__.py,sha256=n6Mrt6VtDrXc93vd0IdiFjZCytcIpja9MrRUuTm2Gpo,1671
+dooers/broadcast.py,sha256=Lt7nJk6_0TLCoLDDLZPrRjNTkIfAkjofyuJyhG6r8xU,5407
+dooers/config.py,sha256=Fzhim7QwYBX-FItNOBKBi0qlU7OJrqPSvX9KxVzW_SA,717
+dooers/registry.py,sha256=5vmq8kNjqyUun0KipuWHONqOhxqNY391jvbJZl3UP8w,3346
+dooers/server.py,sha256=-ct81WZ97KbuDzTGlKFXa2OE4B36SaNGkTpx46nw_EA,6499
+dooers/settings.py,sha256=EAv6ZEBiw0anPfjtmwm73RmkBtWSAwjYSeE7CT6VbAk,142
+dooers/features/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dooers/features/analytics/__init__.py,sha256=Yj5F3o1NtjI2j80P1JfD9LbkiYmmXAOHA0T000ioDqQ,345
+dooers/features/analytics/collector.py,sha256=1AUaoZJ70BE0DCmWCtodP15zwUGbfRQVOPabqEg91UE,7682
+dooers/features/analytics/models.py,sha256=lroX6Nv2RPIu63RJ6TlFgyaYSq5_l5aM-qCUOgkqg4I,1259
+dooers/features/analytics/worker_analytics.py,sha256=0Sdh5DyJ98reqMw-ekYRTro-C_nsVTaDGXHKeU8EjSA,2921
+dooers/features/settings/__init__.py,sha256=0_SL46Qmvgr8hcQp5_hZb06DyTQuAx96fD5qNI8LYcA,352
+dooers/features/settings/broadcaster.py,sha256=eg0jgfdU4FpvJjrt_E42Ap4mG9OXGtXRV7u6OlStdFM,3214
+dooers/features/settings/models.py,sha256=Ib8mOUsAKMZfGYWzhxHnG_k8tWEJPGpiAZgeb9A4Kc4,2050
+dooers/features/settings/worker_settings.py,sha256=pDGHzY_AteXm4_3EZOB8wggTzazEqqCP7HN5-M9FPls,2746
+dooers/handlers/__init__.py,sha256=7pjVKZVpApq961dGJaomD8mi-JctHnbvA3u784VbHz0,516
+dooers/handlers/memory.py,sha256=FHjB25cvaFfbolXsCVfFNxPK0llqucsfFu-BBQo4OrA,3491
+dooers/handlers/request.py,sha256=Awyk0K67m-sFoUxqQUY1zWTeo9heZvj0ivII0f_qH9M,237
+dooers/handlers/response.py,sha256=-fZLX8dZjmLMon4Z2ZCxi3xr_pXKxbFJU_mkuPUgG1E,1777
+dooers/handlers/router.py,sha256=aAKPnu5e-DKtEMZ70EJxvEKmJO8YJQS_bStl1xb75Mo,35503
+dooers/migrations/__init__.py,sha256=gynmHSVs_CQCuKGG0Rw4E6Eh_LCXUsZH-Zpc8tScJfM,92
+dooers/migrations/schemas.py,sha256=9W37t_armHdjjzHQTnQx3OyZ0f012sQ7vAmACBHkuQk,4778
+dooers/persistence/__init__.py,sha256=GnEeNPeS7ZYiEStaFDbqg9cThC5UOJZ7Wpm1aZafgxM,259
+dooers/persistence/base.py,sha256=lR6yLrsuG7UPPRpr0PxuA-pbc9IsPH0-NQambQPIUFk,1545
+dooers/persistence/postgres.py,sha256=GTwJzDkHiOM9OzDto418qoK-DxXZd2kpjTGNncheaFk,15806
+dooers/persistence/sqlite.py,sha256=VJIKMM4cMANLke8ToZEOHPmHtCVkx8UoxZGrhYXmB78,14891
+dooers/protocol/__init__.py,sha256=I9wXiA3XdqY5056vrj-RutFd6Nl3-dvBKKuWYBXDrQI,2573
+dooers/protocol/frames.py,sha256=xyySImv8QZlLba_sqQ3rWEIGQPgMFZh79hAHKaJE7H0,6273
+dooers/protocol/models.py,sha256=_t4zRICS8jtNxu6GLzrfbBkx8dfAn0zbsmEVEV7MvLM,1722
+dooers/protocol/parser.py,sha256=t4umb5stgJt5mB7uncOGWpPzeqe4V9To2z2aDj-sQvk,452
+dooers_workers-0.2.0.dist-info/METADATA,sha256=k_cw9o9zXz81Mt016EqYfGQngbZkAf1JDSwQ1MiPqKo,5539
+dooers_workers-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+dooers_workers-0.2.0.dist-info/RECORD,,

dooers_workers-0.2.0.dist-info/WHEEL

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