feat: add api key auth, devii agent, openai gateway, and admin service management

This commit introduces a comprehensive set of new features including API key authentication with CLI management commands (get, reset, backfill), a Devii agentic assistant with WebSocket terminal and session bootstrap, an OpenAI-compatible LLM gateway service, and an admin service management panel. It also adds Playwright browser automation for bot support, configures internal gateway URLs, refactors content editing/deletion to support JSON API responses, and updates documentation across AGENTS.md, README.md, and the developer docs site.
2026-06-08 15:38:33 +00:00
parent 921e382cbc
commit e0535bb7c5
270 changed files with 54408 additions and 541 deletions
@@ -0,0 +1,90 @@
+# retoor <retoor@molodetz.nl>
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, Literal
+
+ParamLocation = Literal["path", "query", "body", "file"]
+
+
+@dataclass(frozen=True)
+class Param:
+    name: str
+    location: ParamLocation
+    description: str
+    required: bool = False
+    type: str = "string"
+
+
+@dataclass(frozen=True)
+class Action:
+    name: str
+    method: str
+    path: str
+    summary: str
+    description: str = ""
+    params: tuple[Param, ...] = ()
+    requires_auth: bool = True
+    handler: Literal[
+        "http", "login", "logout", "status", "task", "agentic", "avatar", "client", "fetch",
+        "docs", "cost", "chunks", "rsearch"
+    ] = "http"
+    freeform_body: bool = False
+    ajax: bool = False
+
+    def tool_schema(self) -> dict[str, Any]:
+        properties: dict[str, Any] = {}
+        required: list[str] = []
+        for param in self.params:
+            if param.type == "array":
+                properties[param.name] = {
+                    "type": "array",
+                    "items": {"type": "object"},
+                    "description": param.description,
+                }
+            else:
+                properties[param.name] = {
+                    "type": param.type,
+                    "description": param.description,
+                }
+            if param.required:
+                required.append(param.name)
+        if self.freeform_body:
+            properties["form_fields"] = {
+                "type": "object",
+                "description": "Additional form fields as key/value string pairs.",
+                "additionalProperties": {"type": "string"},
+            }
+        text = self.summary if not self.description else f"{self.summary}. {self.description}"
+        return {
+            "type": "function",
+            "function": {
+                "name": self.name,
+                "description": text,
+                "parameters": {
+                    "type": "object",
+                    "properties": properties,
+                    "required": required,
+                    "additionalProperties": False,
+                },
+            },
+        }
+
+
+@dataclass(frozen=True)
+class Catalog:
+    actions: tuple[Action, ...] = field(default_factory=tuple)
+
+    def by_name(self) -> dict[str, Action]:
+        return {action.name: action for action in self.actions}
+
+    def tool_schemas(self) -> list[dict[str, Any]]:
+        return [action.tool_schema() for action in self.actions]
+
+    def tool_schemas_for(self, authenticated: bool) -> list[dict[str, Any]]:
+        return [
+            action.tool_schema()
+            for action in self.actions
+            if authenticated or not action.requires_auth
+        ]