anti
f2b3393669
Replaces LICENSE (GPLv3 -> AGPLv3) and prepends `SPDX-License-Identifier: AGPL-3.0-or-later` to every source file across decnet/, decnet_web/, tests/, scripts/, and tools/. Rationale: closes the GPLv3 ASP loophole so any party operating a modified DECNET as a network service must offer their modified source. Personal copyright (Samuel Paschuan) + inbound=outbound contributions make a future unilateral relicense infeasible. - LICENSE: full AGPL-3.0 text (gnu.org/licenses/agpl-3.0.txt) - COPYRIGHT: project copyright notice - tools/add_spdx_headers.py: idempotent header injector (shebang- and PEP 263-aware) Touches 1565 source files (.py, .ts, .tsx, .js, .jsx, .css, .sh). No behavior change; comments only.
49 lines
1.5 KiB
Python
49 lines
1.5 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""Backend protocol shared by every LLM transport.
|
|
|
|
Deliberately narrow: realism consumers need one async ``generate``
|
|
call that takes a prompt string and returns the model's output text
|
|
plus enough metadata to populate per-event payloads (model name,
|
|
latency, success bit). Streaming, embeddings, multi-turn chat — all
|
|
out of scope here; realism only ever does one-shot single-prompt
|
|
generations.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import Any, Protocol
|
|
|
|
|
|
class LLMTimeout(Exception):
|
|
"""Raised when a generation exceeds the backend's wall-clock cap.
|
|
|
|
Backends MUST raise this rather than returning silently empty
|
|
output; the driver discriminates timeout from "model produced
|
|
nothing useful" so payloads carry the right ``stage`` value.
|
|
"""
|
|
|
|
|
|
@dataclass
|
|
class LLMResult:
|
|
"""Outcome of one ``generate`` call.
|
|
|
|
``success`` is ``False`` when the backend ran cleanly but produced
|
|
no usable output (e.g. an empty stdout). Hard failures (subprocess
|
|
crash, network error) raise; soft failures land here so the driver
|
|
can persist + log them as one event.
|
|
"""
|
|
success: bool
|
|
text: str
|
|
model: str
|
|
latency_ms: int
|
|
extra: dict[str, Any] = field(default_factory=dict)
|
|
|
|
|
|
class LLMBackend(Protocol):
|
|
"""Minimal contract for a realism LLM provider."""
|
|
|
|
model: str
|
|
timeout: float
|
|
|
|
async def generate(self, prompt: str) -> LLMResult: ...
|