@camera.ui/server 2.2.5-beta.4 → 2.2.5

package/dist/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/server",
-  "version": "2.2.5-beta.4",
+  "version": "2.2.5",
   "description": "camera.ui server",
   "author": "seydx (https://github.com/cameraui/camera.ui)",
   "type": "module",
@@ -24,13 +24,13 @@
   "scripts": {
     "build": "npm run build:server && npm run copy:files && node scripts/build-docs.mjs",
     "build:server": "rimraf dist/server && tsc && mypy src",
-    "check": "tsc --noEmit",
+    "check": "tsc --noEmit && node ../scripts/check-imports.mjs server",
     "copy:files": "cpy package.json dist/server && cpy requirements.txt dist/server && cpy 'src/**/*.py' dist/server/src --parents",
     "format": "prettier --write 'src/' 'bin/' --ignore-unknown --no-error-on-unmatched-pattern && ruff format",
     "install-updates": "npm i --save --legacy-peer-deps",
     "lint": "eslint --fix . && ruff check --fix && mypy --config-file ./mypy.ini src",
     "update": "updates -M npm,pypi,go,cargo,docker,make --update ./ && cupdate",
-    "prepublishOnly": "npm i --package-lock-only && npm --prefix .. run check:sensors && npm run lint && npm run format && npm run build && npm --prefix ../ui run lint && npm --prefix ../ui run format && npm --prefix ../ui run build",
+    "prepublishOnly": "npm i --package-lock-only && node ../scripts/check-imports.mjs server && npm --prefix .. run check:sensors && npm run lint && npm run format && npm run build && npm --prefix ../ui run lint && npm --prefix ../ui run format && npm --prefix ../ui run build",
     "prepack": "node ../scripts/shrinkwrap.mjs create",
     "postpack": "node ../scripts/shrinkwrap.mjs cleanup",
     "publish:dev": "npm publish --tag dev"
@@ -39,44 +39,44 @@
     "@bjia56/portable-python": "^0.1.166",
     "@camera.ui/cloudflared": "^2026.9.1-cui.1",
     "@camera.ui/common": "~0.0.58-beta.2",
-    "@camera.ui/go2rtc": "^1.9.14-cui.45",
+    "@camera.ui/go2rtc": "^1.9.14-cui.46",
     "@camera.ui/nats": "^2.15.0",
     "@camera.ui/rpc": "^1.0.12",
     "@camera.ui/rust-detector": "~0.0.12",
-    "@camera.ui/rust-postprocessor": "~0.1.8",
-    "@camera.ui/sdk": "~1.2.39",
-    "@camera.ui/tunnel": "^1.0.4",
+    "@camera.ui/rust-postprocessor": "~0.1.9",
+    "@camera.ui/sdk": "~1.3.3",
+    "@camera.ui/tunnel": "^1.0.7",
     "@eneris/push-receiver": "^4.3.1",
     "@fastify/cors": "^11.3.0",
     "@fastify/helmet": "^13.1.1",
     "@fastify/http-proxy": "^11.6.2",
-    "@fastify/multipart": "^10.1.1",
+    "@fastify/multipart": "^10.1.2",
     "@fastify/static": "^10.1.4",
-    "@fastify/swagger": "^9.8.1",
+    "@fastify/swagger": "^9.9.0",
     "@fastify/swagger-ui": "^6.1.1",
     "@homebridge/ciao": "npm:@seydx/ciao@1.3.10",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@peculiar/asn1-schema": "^2.9.4",
-    "@peculiar/asn1-x509": "^2.9.4",
+    "@peculiar/asn1-schema": "^2.9.5",
+    "@peculiar/asn1-x509": "^2.9.5",
     "@peculiar/x509": "1.14.3",
     "@scrypted/node-pty": "^1.0.25",
-    "@tanstack/ai": "^0.55.0",
-    "@tanstack/ai-anthropic": "^0.18.7",
-    "@tanstack/ai-compaction": "^0.1.3",
-    "@tanstack/ai-gemini": "^0.30.0",
-    "@tanstack/ai-memory": "^0.2.0",
-    "@tanstack/ai-ollama": "^0.11.3",
-    "@tanstack/ai-openai": "^0.22.8",
-    "@tanstack/ai-openrouter": "^0.19.12",
-    "@tanstack/ai-persistence": "^0.6.0",
-    "@tanstack/ai-skills": "^0.1.4",
+    "@tanstack/ai": "^0.58.0",
+    "@tanstack/ai-anthropic": "^0.18.11",
+    "@tanstack/ai-compaction": "^0.1.6",
+    "@tanstack/ai-gemini": "^0.32.0",
+    "@tanstack/ai-memory": "^0.2.3",
+    "@tanstack/ai-ollama": "^0.11.6",
+    "@tanstack/ai-openai": "^0.23.1",
+    "@tanstack/ai-openrouter": "^0.19.16",
+    "@tanstack/ai-persistence": "^0.6.4",
+    "@tanstack/ai-skills": "^0.1.7",
     "adm-zip": "^0.6.1",
     "aedes": "^1.2.0",
     "croner": "^10.0.1",
     "fastify": "^5.12.5",
     "fastify-plugin": "^6.0.0",
     "fastify-type-provider-zod": "7.0.0",
-    "fs-extra": "^11.4.0",
+    "fs-extra": "^11.4.1",
     "js-yaml": "^5.4.2",
     "jsonwebtoken": "^9.0.3",
     "lmdb": "^3.5.6",
@@ -87,10 +87,10 @@
     "reflect-metadata": "^0.2.2",
     "semver": "^7.8.5",
     "socket.io": "^4.8.3",
-    "systeminformation": "^5.33.12",
+    "systeminformation": "^5.33.13",
     "tar": "^7.5.22",
     "tsyringe": "^4.10.0",
-    "undici": "^8.10.2",
+    "undici": "^8.11.0",
     "werift": "^0.24.4",
     "ws": "^8.21.3",
     "zod": "4.6.5"
@@ -102,7 +102,7 @@
     "@types/adm-zip": "^0.5.8",
     "@types/fs-extra": "^11.0.4",
     "@types/jsonwebtoken": "^9.0.10",
-    "@types/node": "26.6.1",
+    "@types/node": "26.6.2",
     "@types/node-forge": "^1.3.14",
     "@types/npm-registry-fetch": "^8.0.9",
     "@types/pacote": "^11.1.8",
@@ -110,7 +110,7 @@
     "@types/semver": "^7.8.0",
     "@types/tail": "^2.2.3",
     "@types/ws": "^8.18.1",
-    "@typescript-eslint/parser": "^8.70.0",
+    "@typescript-eslint/parser": "^8.70.1",
     "ansicolor": "^2.0.3",
     "cpy-cli": "^7.0.0",
     "cross-env": "^10.1.0",
@@ -126,8 +126,8 @@
     "rimraf": "^6.1.3",
     "tail": "^2.2.6",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.70.0",
-    "updates": "^18.1.1",
+    "typescript-eslint": "^8.70.1",
+    "updates": "^19.0.0",
     "vitest": "^5.0.1"
   },
   "overrides": {

package/dist/server/requirements.txt

@@ -1,10 +1,10 @@
-camera-ui-sdk==1.2.39
+camera-ui-sdk==1.3.3
 camera-ui-common==1.0.24
 camera-ui-rpc==1.0.10
 certifi==2026.7.22
 deepdiff==9.1.0
 msgpack==1.2.2
-virtualenv==21.7.14
+virtualenv==21.10.0
 setproctitle==1.3.7
 ormsgpack==1.12.2
 truststore==0.10.4

package/dist/server/src/_camera_ui_tools/camera_ui_sdk/__init__.py

@@ -114,6 +114,22 @@ from .plugin import (
     API_EVENT,
     PROTOCOL_LEVEL,
     APIListener,
+    AssistantModelChunk,
+    AssistantModelContent,
+    AssistantModelContext,
+    AssistantModelDoneChunk,
+    AssistantModelImage,
+    AssistantModelMessage,
+    AssistantModelProvider,
+    AssistantModelRequest,
+    AssistantModelSpec,
+    AssistantModelStatus,
+    AssistantModelText,
+    AssistantModelTextChunk,
+    AssistantModelTool,
+    AssistantModelToolCall,
+    AssistantModelToolCallChunk,
+    AssistantModelUsageChunk,
     AssistantToolArrayProperty,
     AssistantToolBooleanProperty,
     AssistantToolContext,
@@ -139,6 +155,8 @@ from .plugin import (
     DiscoveryProvider,
     FaceDetectionInterface,
     FaceDetectionPluginResponse,
+    FaceEmbeddingInterface,
+    FaceEmbeddingPluginResponse,
     ImageMetadata,
     LicensePlateDetectionInterface,
     LicensePlateDetectionPluginResponse,
@@ -167,6 +185,7 @@ from .plugin import (
     PluginRole,
     PythonVersion,
     SensorDiscoveryProvider,
+    ServicePlugin,
     Severity,
     can_create_cameras,
     can_provide_sensors_to_any_cameras,
@@ -175,6 +194,7 @@ from .plugin import (
     has_capability,
     has_interface,
     is_hub,
+    is_service,
     validate_contract_consistency,
 )
 from .sensor import (
@@ -209,6 +229,8 @@ from .sensor import (
     DoorbellTrigger,
     FaceDetection,
     FaceDetectorSensor,
+    FaceEmbedderSensor,
+    FaceEmbeddingResult,
     FaceResult,
     FaceSensor,
     GarageControl,
@@ -436,6 +458,7 @@ __all__ = [
     "AudioDetectorSensor",
     "FaceSensor",
     "FaceDetectorSensor",
+    "FaceEmbedderSensor",
     "LicensePlateSensor",
     "LicensePlateDetectorSensor",
     "ClassifierDetection",
@@ -554,6 +577,7 @@ __all__ = [
     "AudioFrameData",
     "MotionResult",
     "ObjectResult",
+    "FaceEmbeddingResult",
     "FaceResult",
     "AudioResult",
     "LicensePlateResult",
@@ -568,9 +592,12 @@ __all__ = [
     "ClassifierDetectionPluginResponse",
     "ClipDetectionInterface",
     "ClipDetectionPluginResponse",
+    "FaceEmbeddingInterface",
+    "FaceEmbeddingPluginResponse",
     "ClipTextEmbeddingResult",
     "PluginAPI",
     "BasePlugin",
+    "ServicePlugin",
     "MotionDetectionInterface",
     "ObjectDetectionInterface",
     "AudioDetectionInterface",
@@ -586,6 +613,7 @@ __all__ = [
     "get_contract_validation_errors",
     "validate_contract_consistency",
     "is_hub",
+    "is_service",
     "can_create_cameras",
     "can_provide_sensors_to_any_cameras",
     "has_interface",
@@ -617,6 +645,22 @@ __all__ = [
     "AssistantToolReference",
     "AssistantToolResult",
     "AssistantToolSchema",
+    "AssistantModelChunk",
+    "AssistantModelContent",
+    "AssistantModelContext",
+    "AssistantModelDoneChunk",
+    "AssistantModelImage",
+    "AssistantModelMessage",
+    "AssistantModelProvider",
+    "AssistantModelRequest",
+    "AssistantModelSpec",
+    "AssistantModelStatus",
+    "AssistantModelText",
+    "AssistantModelTextChunk",
+    "AssistantModelTool",
+    "AssistantModelToolCall",
+    "AssistantModelToolCallChunk",
+    "AssistantModelUsageChunk",
     "AssistantToolSpec",
     "AssistantToolStringProperty",
     "define_assistant_tool",

package/dist/server/src/_camera_ui_tools/camera_ui_sdk/camera/config.py

@@ -165,6 +165,8 @@ class PluginAssignments(TypedDict, total=False):
     """Audio detection plugin."""
     face: AssignedPlugin
     """Face detection plugin."""
+    faceEmbedder: AssignedPlugin
+    """Face embedding plugin."""
     licensePlate: AssignedPlugin
     """License plate detection plugin."""
     ptz: AssignedPlugin

package/dist/server/src/_camera_ui_tools/camera_ui_sdk/camera/detection.py

@@ -163,13 +163,18 @@ class AudioDetectionSettings(TypedDict):
     """Minimum confidence threshold (0 - 1) for a labelled audio detection to count."""
 
 
+FaceMatchSensitivity = Literal["strict", "balanced", "relaxed"]
+"""How readily a face counts as a known person."""
+
+
 class FaceDetectionSettings(TypedDict):
     """Face detection settings."""
 
     confidence: NotRequired[float]
     """Minimum confidence threshold (0 - 1) for a face to count."""
-    matchThreshold: NotRequired[float]
-    """Minimum similarity (0 - 1) for a face to be recognized as an enrolled person."""
+    matchSensitivity: NotRequired[FaceMatchSensitivity]
+    """How readily a face is recognized as an enrolled person. Named rather than numeric
+    because the similarity a model calls a match differs per model."""
 
 
 class LicensePlateDetectionSettings(TypedDict):

package/dist/server/src/_camera_ui_tools/camera_ui_sdk/plugin/__init__.py

@@ -17,6 +17,24 @@ from .assistant import (
     AssistantToolStringProperty,
     define_assistant_tool,
 )
+from .assistant_models import (
+    AssistantModelChunk,
+    AssistantModelContent,
+    AssistantModelContext,
+    AssistantModelDoneChunk,
+    AssistantModelImage,
+    AssistantModelMessage,
+    AssistantModelProvider,
+    AssistantModelRequest,
+    AssistantModelSpec,
+    AssistantModelStatus,
+    AssistantModelText,
+    AssistantModelTextChunk,
+    AssistantModelTool,
+    AssistantModelToolCall,
+    AssistantModelToolCallChunk,
+    AssistantModelUsageChunk,
+)
 from .contract import (
     PROTOCOL_LEVEL,
     PluginCapability,
@@ -33,6 +51,7 @@ from .helper import (
     has_capability,
     has_interface,
     is_hub,
+    is_service,
     validate_contract_consistency,
 )
 from .interfaces import (
@@ -48,6 +67,8 @@ from .interfaces import (
     DiscoveryProvider,
     FaceDetectionInterface,
     FaceDetectionPluginResponse,
+    FaceEmbeddingInterface,
+    FaceEmbeddingPluginResponse,
     ImageMetadata,
     LicensePlateDetectionInterface,
     LicensePlateDetectionPluginResponse,
@@ -57,6 +78,7 @@ from .interfaces import (
     ObjectDetectionPluginResponse,
     PluginInterfaces,
     SensorDiscoveryProvider,
+    ServicePlugin,
 )
 from .notifier import (
     Notification,
@@ -77,6 +99,22 @@ from .oauth import (
 )
 
 __all__ = [
+    "AssistantModelChunk",
+    "AssistantModelContent",
+    "AssistantModelContext",
+    "AssistantModelDoneChunk",
+    "AssistantModelImage",
+    "AssistantModelMessage",
+    "AssistantModelProvider",
+    "AssistantModelRequest",
+    "AssistantModelSpec",
+    "AssistantModelStatus",
+    "AssistantModelText",
+    "AssistantModelTextChunk",
+    "AssistantModelTool",
+    "AssistantModelToolCall",
+    "AssistantModelToolCallChunk",
+    "AssistantModelUsageChunk",
     "PROTOCOL_LEVEL",
     "PythonVersion",
     "PluginInfo",
@@ -97,9 +135,12 @@ __all__ = [
     "ClassifierDetectionPluginResponse",
     "ClipDetectionInterface",
     "ClipDetectionPluginResponse",
+    "FaceEmbeddingInterface",
+    "FaceEmbeddingPluginResponse",
     "ClipTextEmbeddingResult",
     "PluginAPI",
     "BasePlugin",
+    "ServicePlugin",
     "DiscoveryProvider",
     "SensorDiscoveryProvider",
     "MotionDetectionInterface",
@@ -111,6 +152,7 @@ __all__ = [
     "get_contract_validation_errors",
     "validate_contract_consistency",
     "is_hub",
+    "is_service",
     "can_create_cameras",
     "can_provide_sensors_to_any_cameras",
     "has_interface",

package/dist/server/src/_camera_ui_tools/camera_ui_sdk/plugin/assistant_models.py

@@ -0,0 +1,300 @@
+from __future__ import annotations
+
+from collections.abc import AsyncIterator
+from typing import Any, Literal, NotRequired, Protocol, TypedDict, runtime_checkable
+
+
+class AssistantModelSpec(TypedDict):
+    """One model a plugin offers to the assistant. The user picks it under
+    Settings, Assistant like any other model; the host never sees a key or an
+    endpoint of it.
+
+    Example:
+        ```python
+        on_device: AssistantModelSpec = {
+            "id": "apple-on-device",
+            "name": "Apple on-device",
+            "contextTokens": 8192,
+            "vision": True,
+            "toolCalling": True,
+            "structuredOutput": True,
+            "note": "Runs on this Mac, nothing leaves the house.",
+        }
+        ```
+    """
+
+    id: str
+    """Model id, unique within the plugin and stable across restarts: the settings store it."""
+
+    name: str
+    """Name shown in the model list."""
+
+    contextTokens: int
+    """Hard context limit of the model in tokens. The host plans prompt, tools and history with it."""
+
+    vision: bool
+    """The model reads images. Without it the host sends text only."""
+
+    toolCalling: bool
+    """The model calls tools. Without it the assistant answers from the conversation alone."""
+
+    structuredOutput: bool
+    """The model honors a JSON schema. Without it the host asks for free text and parses defensively."""
+
+    toolRouting: NotRequired[bool]
+    """The host picks the tools for a question with a short call of its own and puts only
+    those in front of the model. For a small model that calls the tools it sees but
+    does not work through a catalog of fifty."""
+
+    note: NotRequired[str]
+    """One line shown next to the model, for example where it runs or what it costs."""
+
+
+class AssistantModelText(TypedDict):
+    """Text part of a message."""
+
+    type: Literal["text"]
+    """Always ``text``."""
+
+    text: str
+    """The text itself."""
+
+
+class AssistantModelImage(TypedDict):
+    """Image part of a message. Arrives only for a model whose spec says
+    ``vision``, and only when the instance allows pictures to reach the model."""
+
+    type: Literal["image"]
+    """Always ``image``."""
+
+    data: str
+    """Base64-encoded image bytes."""
+
+    mimeType: Literal["image/jpeg", "image/png", "image/webp"]
+    """MIME type of ``data``."""
+
+
+AssistantModelContent = AssistantModelText | AssistantModelImage
+"""Part of a message: text or an image."""
+
+
+class AssistantModelToolCall(TypedDict):
+    """A tool call: which tool with which arguments."""
+
+    id: str
+    """Id the host uses to match the result, unique within the request."""
+
+    name: str
+    """Name of the tool as declared in ``AssistantModelRequest["tools"]``."""
+
+    arguments: dict[str, Any]
+    """Arguments as parsed JSON, matching the tool's input schema."""
+
+
+class AssistantModelMessage(TypedDict):
+    """One message of the conversation. ``tool`` messages carry the result of
+    the call with the matching ``toolCallId``."""
+
+    role: Literal["user", "assistant", "tool"]
+    """Who wrote it."""
+
+    content: list[AssistantModelContent]
+    """Text and images of the message."""
+
+    toolCalls: NotRequired[list[AssistantModelToolCall]]
+    """Tool calls the assistant asked for, on ``assistant`` messages."""
+
+    toolCallId: NotRequired[str]
+    """Call this message answers, on ``tool`` messages."""
+
+
+class AssistantModelTool(TypedDict):
+    """A tool the model may call in this request."""
+
+    name: str
+    """Name the model uses in its call."""
+
+    description: str
+    """What the tool does, written for the model."""
+
+    inputSchema: dict[str, Any]
+    """JSON Schema object of the arguments."""
+
+
+class AssistantModelRequest(TypedDict):
+    """One request to a plugin model: the conversation so far plus what the
+    model may do with it."""
+
+    modelId: str
+    """Model id from ``AssistantModelSpec["id"]``."""
+
+    system: list[str]
+    """Instructions that precede the conversation."""
+
+    messages: list[AssistantModelMessage]
+    """The conversation, oldest first. The host has already trimmed it to ``contextTokens``."""
+
+    tools: list[AssistantModelTool]
+    """Tools the model may call. Empty when the run allows none."""
+
+    outputSchema: NotRequired[dict[str, Any]]
+    """JSON Schema the answer has to match. Only set for models whose spec says ``structuredOutput``."""
+
+    maxOutputTokens: NotRequired[int]
+    """Upper bound for the answer in tokens, when the host has one."""
+
+
+class AssistantModelTextChunk(TypedDict):
+    """A piece of the answer text."""
+
+    type: Literal["text"]
+    """Always ``text``."""
+
+    delta: str
+    """The text generated since the last chunk."""
+
+
+class AssistantModelToolCallChunk(TypedDict):
+    """A tool call the model asks for, with complete arguments."""
+
+    type: Literal["tool_call"]
+    """Always ``tool_call``."""
+
+    call: AssistantModelToolCall
+    """The call itself."""
+
+
+class AssistantModelUsageChunk(TypedDict):
+    """What the answer consumed."""
+
+    type: Literal["usage"]
+    """Always ``usage``."""
+
+    promptTokens: int
+    """Tokens the request consumed."""
+
+    completionTokens: int
+    """Tokens the answer consumed."""
+
+
+class AssistantModelDoneChunk(TypedDict):
+    """End of the answer, yielded exactly once."""
+
+    type: Literal["done"]
+    """Always ``done``."""
+
+    finish: Literal["stop", "tool_calls", "length", "error"]
+    """Why the model stopped."""
+
+    message: NotRequired[str]
+    """What went wrong, with ``error``."""
+
+
+AssistantModelChunk = (
+    AssistantModelTextChunk | AssistantModelToolCallChunk | AssistantModelUsageChunk | AssistantModelDoneChunk
+)
+"""A piece of the answer: text, a tool call, token counts, or the end."""
+
+
+class AssistantModelStatus(TypedDict):
+    """Whether the plugin can answer right now. A model that has to be
+    downloaded or loaded first reports ``ready: False`` with a line the settings
+    page shows, and a ``progress`` while it knows one.
+
+    Example:
+        ```python
+        {"ready": False, "message": "macOS is downloading the model", "progress": 0.62}
+        ```
+    """
+
+    ready: bool
+    """The models of this plugin can answer right now."""
+
+    message: NotRequired[str]
+    """One line for the user: what the plugin is waiting for, or what it is doing."""
+
+    progress: NotRequired[float]
+    """How far the loading got, between 0 and 1."""
+
+
+class AssistantModelContext(TypedDict):
+    """Who the answer is for and when to stop writing it."""
+
+    userId: NotRequired[str]
+    """ID of the user the answer is for. Absent for scheduled runs and plugin requests."""
+
+    language: str
+    """BCP 47 language tag the answer should use."""
+
+    timeoutMs: int
+    """Milliseconds the host waits before it drops the answer."""
+
+
+@runtime_checkable
+class AssistantModelProvider(Protocol):
+    """Implemented by plugins that list ``PluginInterface.AssistantModels`` in
+    their contract. Such a plugin is a bridge to a model the host cannot reach
+    itself: one without an HTTP API, one behind an unusual authentication, or
+    one that lives on the machine the plugin runs on. The plugin holds no
+    conversation state, every request carries the whole conversation.
+
+    Example:
+        ```python
+        class ApplePlugin(BasePlugin):
+            async def assistantModels(self) -> list[AssistantModelSpec]:
+                return [
+                    {
+                        "id": "apple-on-device",
+                        "name": "Apple on-device",
+                        "contextTokens": 8192,
+                        "vision": True,
+                        "toolCalling": True,
+                        "structuredOutput": True,
+                    }
+                ]
+
+            async def assistantGenerate(
+                self, request: AssistantModelRequest, ctx: AssistantModelContext
+            ) -> AsyncIterator[AssistantModelChunk]:
+                async for delta in self.session.stream(request, ctx["timeoutMs"]):
+                    yield {"type": "text", "delta": delta}
+                yield {"type": "done", "finish": "stop"}
+        ```
+    """
+
+    async def assistantModels(self) -> list[AssistantModelSpec]:
+        """List the models this plugin offers. Called after the plugin is ready
+        and whenever the settings page is opened.
+
+        Returns:
+            The specs, empty while the plugin has no usable model (no hardware,
+            no permission yet).
+        """
+        ...
+
+    async def assistantModelStatus(self) -> AssistantModelStatus:
+        """Report whether the models can answer right now. The host asks before
+        it offers them and while the settings page is open, so a model that is
+        still downloading shows up as busy instead of missing. Leave it out when
+        the models are usable as soon as the plugin runs.
+
+        Returns:
+            Readiness, with a line and a progress while it loads.
+        """
+        ...
+
+    def assistantGenerate(
+        self, request: AssistantModelRequest, ctx: AssistantModelContext
+    ) -> AsyncIterator[AssistantModelChunk]:
+        """Answer one request. The host reads chunks until ``done``, then either
+        returns the text to the user or runs the tool calls and asks again with
+        their results in ``messages``.
+
+        Args:
+            request: Conversation, tools and schema for this answer.
+            ctx: Who asks, in which language, and how long the host waits.
+
+        Returns:
+            The answer in pieces.
+        """
+        ...