refactor!: make agents more composable

- add `NullReporter` and `NULL_REPORTER` to `askui.reporting`
- make Claude 4 available to `AndroidVisionAgent`
- extract common base class `AgentBase` from `VisionAgent` and `AndroidVisionAgent`
- make all settings for llm apis (messages / chat completions / responses) and agents
  configurable through environment variables

BREAKING CHANGE:
- remove `exceptions.AskUiApiError` and `AskUiApiRequestFailedError`
  (unused)
- remove old ways of configuring (env vars and `*Settings` classes)
  Inference and Anthropic APIs / models except
  `ASKUI_TOKEN`, `ASKUI_WORKSPACE_ID` and `ASKUI_INFERENCE_ENDPOINT`,
  and `ANTHROPIC_API_KEY` (still work as before)
- extend `ActModel.act` by 2 new parameters `tools` and `settings`

Author: adi-wan-askui

README.md

@@ -287,6 +287,7 @@ Here's how to create and use custom models:
 import functools
 from askui import (
     ActModel,
+    ActSettings,
     GetModel,
     LocateModel,
     Locator,
@@ -310,6 +311,8 @@ class MyActModel(ActModel):
         messages: list[MessageParam],
         model_choice: str,
         on_message: OnMessageCb | None = None,
+        tools: list[Tool] | None = None,
+        settings: ActSettings | None = None,
     ) -> None:
         # Implement custom act logic, e.g.:
         # - Use a different AI model
@@ -389,6 +392,8 @@ class DynamicActModel(ActModel):
         messages: list[MessageParam],
         model_choice: str,
         on_message: OnMessageCb | None = None,
+        tools: list[Tool] | None = None,
+        settings: ActSettings | None = None,
     ) -> None:
         pass
 

src/askui/__init__.py

@@ -31,13 +31,15 @@
     ToolUseBlockParam,
     UrlImageSourceParam,
 )
+from .models.shared.settings import ActSettings, MessageSettings
 from .models.types.response_schemas import ResponseSchema, ResponseSchemaBase
 from .retry import ConfigurableRetry, Retry
 from .tools import ModifierKey, PcKey
 from .utils.image_utils import ImageSource, Img
 
 __all__ = [
     "ActModel",
+    "ActSettings",
     "Base64ImageSourceParam",
     "CacheControlEphemeralParam",
     "CitationCharLocationParam",
@@ -52,6 +54,7 @@
     "LocateModel",
     "Locator",
     "MessageParam",
+    "MessageSettings",
     "Model",
     "ModelChoice",
     "ModelComposition",