75 KiB
Jinkendo – KI-Gateway, Providerzugriff & Privacy Blueprint
v0.1 · 16.10.2026 · Spezial-Blueprint 2 nach Phase 3.3 · technischer Entwurf, keine Implementierung
1. Geltung und Nachweis
Dieser Blueprint beschreibt den produktlokalen Übergang von autorisiertem Anwendungskontext zu einem KI-Modell und zurück. Er konkretisiert Providerrollen, Datenminimierung, vollständige Egressprüfung, Maskierung, Transport, Antwortvalidierung und Fehlerbehandlung. Primäres Vorbild ist Kanshōs Privacy Gateway. Mitais Prompt-/Platzhalter-/Workflow-System bleibt die primäre vorgelagerte Laufzeit; dessen eigener Spezial-Blueprint folgt gesondert.
Grundlage sind Referenzarchitektur A v0.3, Foundation B v0.3, Entscheidungen C v0.3, Auth-/Session-/Scope-Blueprint und Release-/Betrieb-/Recovery-Blueprint.
Beschlossene ADRs bleiben maßgeblich, besonders ADR-02/04/09/10/12/13/14. ADR-09 erlaubt produktbezogen lokale Verarbeitung oder autorisierte minimierte Weitergabe an geeignete Anbieter. Er erteilt keine pauschale Providerfreigabe und schwächt Kanshōs eigene Privacy-Invarianten nicht ab. Dieser Blueprint trifft keine neue rechtliche Bewertung und aktiviert keinen Anbieter.
Nachweis: V = vorgeschlagene technische Ausgestaltung; I = vorhandene statisch nachgelesene Implementierungsreferenz; T = tatsächlich bestandener Test mit Stand, Umfang und Umgebung; K = noch nicht integrierte/getestete Kombination. Dieses Dokument samt Code-/Payloadbeispielen ist V/K. Produktquellen und Testassertionen sind I; es wurden keine Anwendungstests oder Modellaufrufe ausgeführt. Keine Produktionsreife und keine vollständige semantische Erkennung werden behauptet.
Es entstehen keine gemeinsame KI-Plattform, zentrale Tenant-Datenbank, SSO-, Billing- oder Worker-Infrastruktur. Bestehende Anwendungen bleiben unverändert. Die tatsächliche spätere Umsetzung betrifft nur ein ausdrücklich benanntes Zielrepository.
1.1 Verträge und Defaults
| Verbindlicher Vertrag | Bevorzugter technischer Default |
|---|---|
| Nur aktuell autorisierte Daten aus dem expliziten Scope, für registrierten Zweck | Produktlokaler ModelGateway; pro Anfrage materialisierter unveränderlicher Kontext |
| Class-A-/Local-only-Inhalte verlassen ihre erlaubte Vertrauenszone nicht | Externe Generate-Aufrufe mit Klasse A verweigern; B minimieren/maskieren; C kontrolliert generisch |
| Persönlicher Egress durchläuft die vollständige Pipeline; kein Direktaufruf oder Ausfallbypass | Kanshō-Manifest, lokale semantische Detection, bestätigte Registry und Prüfung des endgültigen Payloads |
| Detect, Generate und Tools sind getrennte Empfänger-/Zweckverträge | Lokaler explizit registrierter Detect-Endpunkt; externer Generate-Adapter nur bei geeigneter Route |
| Kein ungeprüftes Downgrade, kein Export lokaler Mappings oder Sessiondaten | Kein automatischer Modell-/Providerfallback, kein Remote-Klartext-Detect im neuen Standard |
| Anbieterfähigkeit wird belegt und technisch erzwungen, nicht aus einem Boolean geraten | Versionierte Providerprofile und Policybelege; OpenRouter als vorhandener Adapterkandidat |
| Kein Netzaufruf in offener Fachtransaktion; Audit und fachlicher Ergebniswrite atomar | Drei kurze DB-Phasen um lokale Verarbeitung/HTTP herum |
| Antwort bleibt untrusted; keine selbstständigen Tools/DBwrites | Vollständig gepufferte Text-/JSONantwort; lokale Validierung und Rehydration |
| Ressourcen und Mehrfachausführung begrenzt; unbekannte Kosten nicht null | Ein Generate-Versuch pro Call; persistente lokale Call-ID/Idempotenz; Verbrauchsport für nächsten Blueprint |
Timeouts, Größen, Dateinamen, Transportadapter und Chunkgrößen sind begründet anpassbare Defaults. Datenraum-/Privacy-/Releaseverträge bleiben bestehen. Eine begründete lokale Anpassung mit passenden Tests erfordert keinen neuen ADR oder zusätzlichen allgemeinen Freigabezyklus.
2. Vorhandene Mechanismen und gezielte Anpassung
Ausgangspunkt sind Phase-3.1-Wissenselemente, Quellen, Tests und Kanshōs führende Guardrails. Nachgelesen wurden gezielt die relevanten Funktionen; keine neue Gesamtanalyse der Repositories.
| Referenz I | Wiederverwenden | Erforderliche Zielanpassung V/K |
|---|---|---|
| Kanshō KI-KAN-09: Gateway, Maskierung, Pre-Egress-Gate | Reihenfolge vor Modellaufruf, requestbezogenes Manifest, spanbasierte Ersetzungen und lokale Rückübersetzung | Alle tatsächlich versandten Nachrichten/Felder erfassen; keine nachträglichen ungescannten Ergänzungen; Snapshot-/Payloadbindung für vorab geprüfte Mappings |
| Kanshō: Manifesttypen, Antwortprüfung | Aktive Ersetzungen, Alias-/Oberflächenformtrennung und interne Prüffassung | Mappings nur im lokalen Callkontext; ausschließlich tatsächlich ausgegebene/aktive Tokens rehydrieren, keine fremden/inaktiven Tokens nachschlagen |
| Kanshō KI-KAN-10: Providerrollen, Transport, Profilprüfung | Getrennte Detect-/Generate-Konfiguration, kleiner HTTP-Adapter, Usage/Finishreason | Keine pauschale Vertrauensannahme für private IPs/.local; keine ZDR-Zusage aus lokalem Default; exakte Endpunkt-/Routenprüfung; keine Providerfehlertexte an Clients |
| Kanshō KI-KAN-11: Kontextaufbau, Budgetprüfung | Zweckbezogene Materialisierung und explizite Größen-/Kontextgrenze | Zugriffs- und Quellenrevisionen binden; Zeichenschätzung nicht als exakten Tokenizer oder Privacybeweis behandeln |
| Mitai KI-MIT-09/10: Promptausführung, Modellcallback | Übergabepunkt nach vollständiger Platzhalterauflösung/Frageergänzung | Callback ruft ausschließlich Gateway auf; keine direkte Providerclosure, aufgelösten Werte/Promptvolltexte nicht automatisch debuggen; JSONschema tatsächlich validieren statt nur JSON parsen |
| Shinkan KI-SHK-08: REST-Client, Textblöcke | Kleiner Adapter statt zusätzlichem Agentenframework; bekannte Textvarianten | Refusal/Tool-/Reasoningblöcke unterscheiden; unbekannte Formen verweigern; keine Raw-HTTP-/Providerfehlerschnipsel weiterreichen |
| Kairo KI-KAI-14: Secretreferenzprüfung | Konfiguration ohne rohe Secretwerte | Produktlokaler Providerprofiladapter, keine eigene zweite Connection innerhalb der Fach-UoW übernehmen |
Kanshō dokumentiert ausdrücklich, dass technische Detectionabdeckung keine semantische Vollständigkeitsgarantie ist und neue unbekannte Identitäten ungelöste Fälle erzeugen können. Guardrails 22.2. Bestehende Remote-Detect-/Lernmodusübergänge sind produktlokal dokumentierte Ausnahmen; der neue Standard übernimmt sie nicht automatisch. Er ändert sie im Bestand auch nicht. Kein KANSHO_ALLOW_REMOTE_DETECT- oder Fake-Provider-Runtimeflag wird als allgemeiner Familienmechanismus eingeführt.
3. Komponenten und Schnitt zur Prompt-/Workflow-Laufzeit
Fachroute → Fachservice / ContextMaterializer → Prompt-/Workflow-Renderer
→ ModelGateway
→ PurposePolicy / aktuelle Accessprüfung
→ vollständige Textinventur / Minimierung / Detect / Registry
→ MaskingManifest / finale Payloadprüfung / DispatchPermit
→ genau ein registrierter ProviderTransport
→ Envelope-/Inhalts-/Schema-/Privacyprüfung / lokale Rehydration
→ frische Autorisierung / Fachservice-Ergebniswrite oder sichere Ausgabe
| Baustein | Aufgabe |
|---|---|
modules/ai_gateway/service.py |
Gesamtablauf und Phasensteuerung; keine Prompt-DB-/Workflowengine neu entwickeln |
contracts.py, policies.py |
Typisierte Calls/Ergebnisse, Zweck-/Datenklassen-/Ausgabeverträge |
privacy/inventory.py |
Alle endgültigen Textkanäle und kontrollierten technischen Felder erfassen |
privacy/detect.py, mask.py, response.py |
Kanshō-Mechanismen angepasst an unveränderliche Calls und vollständige Abdeckung |
profiles.py, routing.py |
Aktuelle Profil-/Policyrevision, Empfängerrolle, Eignung und Capabilityprüfung |
transports/openrouter.py, optional local_detect.py |
Protokolladapter mit strengem Endpoint, Secretinjektion und begrenztem HTTP |
repository.py |
Callledger und Audit auf explizitem Transaktionshandle |
| Fach-/Promptadapter | Scoped Quellen materialisieren, Vorlage rendern, Outputtyp registrieren; Gateway konsumieren |
create_app(settings, providers)/Lifespan der Foundation verdrahten diese Adapter. Nur Transportmodule dürfen Modell-HTTP ausführen. Direkte Provider-SDK-/HTTP-Aufrufe in Renderern, Feature-Routern, Diagnosen, Lern-/Precomputejobs oder Workflownodes sind kein zulässiger zweiter KI-Pfad. Andere fachliche HTTP-Integrationen werden dadurch nicht zu Modelladaptern erklärt.
Mitai liefert nach Auflösung aller Variablen und Augmentierungen RenderedPrompt, nicht bereits einen externen Call. Das Gateway darf vor Versand keinen fachlichen Promptteil auslassen. Ergebnis-/Formatinstruktionen werden vor der vollständigen Egressinventur ergänzt. Der nachfolgende Workflow-Blueprint muss dieselben DTOs und Fehler-/Idempotenzverträge verwenden. Jeder Modellnode und jeder erneute Aufruf erhält eine eigene Call-ID und durchläuft erneut das Gateway; eine alte Maskierungsfreigabe gilt nicht für neue Nodeinputs.
Erster Implementierungsschnitt: Textnachrichten, keine externen Tools/Plugins, keine Bilder/Audio-/Dateiuploads oder Remote-URLs, keine autonomen Agenten. Nicht registrierte Modalitäten werden verweigert. Spätere Erweiterungen benötigen denselben Empfänger-, Inhalts-, Test- und Datenschutzvertrag; sie werden nicht durch dict[str, Any] still akzeptiert.
4. Datenklassen, Identität und Quellenvertrag
RequestContext kommt unverändert aus Phase 3.3: geprüfter Principal, expliziter Scope und Request-ID. profile_id, Rollen, Policyklasse, Provider-URL und privacy_checked=true aus einem Browserbody sind keine Autorität. Ein Fachzweck ist in einer immutable Registry registriert und bestimmt Mindestschutz, erlaubte Quellen, Modellprofil und Ausgabeschema serverseitig.
| Klasse | Anwendung im Gateway |
|---|---|
| A / Local only | Externer Generate verweigert; Geheimnisse, vollständige Identityregistry/Mapping und nicht erforderliche Rohdaten gehören nicht in den externen Kontext. Ein lokaler Fachfallback ist eine eigene registrierte Funktion. |
| B / persönlicher Kontext | Nur notwendige autorisierte Daten, vollständige lokale Detection/Registry-/Maskierungsprüfung, geeignete externe Route. Pseudonymisierung ist keine behauptete Anonymisierung. |
| C / generischer Kontext | Nur tatsächlich nicht persönliche freigegebene Inhalte. Gemeinsamer Gateway-/Endpoint-/Fehlerpfad bleibt bestehen; C ist kein Umbenennen persönlicher Daten. |
Materialisierung klassifiziert Quellen/Felder anhand des Produktvertrags. Enthält eine Anfrage erforderliche Local-only-Bestandteile, darf sie nicht durch bloße Gesamtkennzeichnung B/C passieren. A-Felder müssen vor externem Rendering begründet ausgeschlossen sein; sonst Blockade. Bekannter Personenbezug in vermeintlichem C führt zur strengeren B-Prüfung, sofern für den Zweck zugelassen, andernfalls Ablehnung. Fehlende/unklare Klassifikation wird nicht C.
Im ersten Schnitt ist C auf registrierte generische Vorlagen-/Katalogquellen begrenzt. Freier Usertext, persönliche Historie oder materialisierte Personendaten sind mindestens B; ein generischer Zweckname stuft sie nicht herunter. Ein lokaler vorgelagerter ForbiddenContentGuard verweigert bekannte Secrets, Private-Keyblöcke, credentialhaltige URLs/DSNs und als Local-only definierte direkte Identifikatorfelder vor Weiterverarbeitung. Dafür werden konkrete Struktur-/Secretregeln verwendet, keine Food-/Namensheuristiken als Ersatz für semantische Detection. Auch diese Prüfung behauptet keine vollständige Erkennung unbekannter Geheimnisse in beliebigem Freitext.
SourceBinding enthält lokal Objekttyp/-ID, erwartete Version, Owner-/Scopebindung und ausgewählte Felder. Alle Quellen werden mit derselben AccessPolicy und scoped Repositoryabfragen geladen, einschließlich RAG-/Graph-/Memory-/Toolresultatquellen. Öffentlicher/globaler Katalog ist eine ausdrücklich erlaubte Quellenart, kein Join auf fremde private Daten. Bereits erzeugter Modelltext bleibt untrusted Eingabe und erhält keine höhere Anweisungspriorität.
Der Dispatcher lädt niemals „alle Profile“ als Kontext. Minimierung ist eine Produktfeld-/Quellenauswahl, kein bloßes strip() oder pauschales Abschneiden. Bei Budgetüberschreitung wird abgebrochen oder im Fachadapter ein ausdrücklich anderer kompakter Kontext neu erzeugt; dieser durchläuft erneut die gesamte Pipeline. Keine unsichtbare providerseitige Kontextkompression.
5. Python-Verträge und lokale Identitäten
Illustrative Schnittstellen V/K. Importpfade für RequestContext, ScopeRef und Foundation-UoW werden im Zielprojekt aus den vorhandenen Verträgen übernommen. Inhalte sind im Speicher vertraulich, auch wenn repr=False ihre versehentliche Repräsentation reduziert.
from dataclasses import dataclass, field
from typing import Literal, Protocol
from app.core.context import RequestContext
@dataclass(frozen=True, slots=True)
class SourceBinding:
kind: str
source_id: str
version: str
selected_fields: tuple[str, ...]
@dataclass(frozen=True, slots=True)
class PromptMessage:
role: Literal["system", "developer", "user", "assistant", "tool"]
content: str = field(repr=False)
@dataclass(frozen=True, slots=True)
class RenderedPrompt:
template_id: str
template_revision: str
messages: tuple[PromptMessage, ...] = field(repr=False)
sources: tuple[SourceBinding, ...]
@dataclass(frozen=True, slots=True)
class GatewayCall:
call_id: str
execution_id: str
node_key: str
purpose: str
rendered: RenderedPrompt = field(repr=False)
result_spec_id: str
@dataclass(frozen=True, slots=True)
class UsageReport:
input_tokens: int | None
output_tokens: int | None
reported_cost: str | None
currency: str | None
status: Literal["reported", "estimated", "unknown"]
@dataclass(frozen=True, slots=True)
class ModelResult:
call_id: str
content: str = field(repr=False)
result_spec_id: str
usage: UsageReport
class ModelGateway(Protocol):
async def complete(self, context: RequestContext,
call: GatewayCall) -> ModelResult: ...
Ein RenderedPrompt ist ein internes Ergebnis des autorisierten Render-/Materialisierungsadapters, kein frei deserialisiertes APIobjekt. purpose, ResultSpec und Vorlagenrevision werden gegen registrierte serverseitige Definitionen geprüft. ResultSpec legt text oder ein konkretes Pydanticmodell, maximale Länge, erlaubte Werte und rehydrierbare Textpfade fest. ModelResult.content ist bei JSON eine validierte kanonische JSONzeichenkette; Fachadapter erhält anschließend das explizite lokale DTO. Keine rohen Providerdicts.
Providertransport erhält weder RequestContext noch SourceBinding oder Manifest. Er bekommt eine interne SealedEgress-Struktur: Call-ID, registrierte Route-/Profil-/Policyrevision, unveränderliche Bodybytes, Bytehash, Größenlimit, Deadline und eine kurzlebige interne DispatchPermit. Diese Objekte werden ausschließlich durch die Gatewaypipeline erstellt, nicht aus einem Clientflag. Sie sind lokale Programmgrenzen, kein Kryptografiebeweis gegen kompromittierten Servercode.
Hier bezeichnet SealedEgress den Generate-Ausgang. Die vorgelagerte lokale Detection verwendet einen getrennten typisierten LocalDetectInput(call_id,inventory_revision,text_fields) und LocalDetectTransport: nur nach T1/ForbiddenContentGuard, nur zum eligible lokalen Detectprofil, ohne Registry-/Rehydrationstabelle und ohne externe Generate-Permit. Der lokale Detectadapter validiert Ziel, Größen, Rolle und Antwortschema, bevor er Coverage liefert. Er kann keine Generate-Route auswählen. So entsteht kein zirkuläres „vor Detection bereits vollständig maskiert“-Erfordernis und kein als Detect getarnter externer Klartextpfad.
Der kleine Detect-Port präzisiert die Rückgabe. Coveragebereiche werden lokal vom Adapter aus tatsächlich erfolgreich verarbeiteten Chunks aufgebaut, nicht aus einer Modellbehauptung übernommen. Spans werden am exakt gebundenen Text validiert.
@dataclass(frozen=True, slots=True)
class TextField:
path: str
revision: str
text: str = field(repr=False)
@dataclass(frozen=True, slots=True)
class LocalDetectInput:
call_id: str
inventory_revision: str
text_fields: tuple[TextField, ...] = field(repr=False)
@dataclass(frozen=True, slots=True)
class DetectedSpan:
field_path: str
start: int
end: int
observed: str = field(repr=False)
entity_type: Literal["PERSON", "PLACE", "ORG", "PROJECT"]
@dataclass(frozen=True, slots=True)
class DetectionCoverage:
inventory_revision: str
detector_profile_revision: str
processed_ranges: tuple[tuple[str, int, int], ...]
spans: tuple[DetectedSpan, ...] = field(repr=False)
class SemanticDetector(Protocol):
async def detect(self, request: LocalDetectInput) -> DetectionCoverage: ...
Die lokale MaskingManifest-Variante übernimmt Kanshōs aktive Ersetzungen, Typen, Vorkommen und Rehydrationstabelle, ergänzt aber zwingend Call-ID, Subject/Scope-Namespace, genaue Inventur-/Payloadrevision, Detection-/Registry-/Reviewrevision und technische Coverage. Keine dieser Zuordnungen wird in externe Metadaten oder globale mutable Variablen gelegt. Gleichzeitige A-/B-Calls besitzen getrennte Manifeste; kein globales last_trace als Quelle persönlicher Ergebnisse.
6. Providerprofile, Trust Zones und Eignung
Ein Profil ist produktlokal versioniert und enthält ausschließlich Konfiguration/Secretreferenzen. Konkrete erforderliche Felder:
| Gruppe | Felder / Regel |
|---|---|
| Identität | profile_id, revision, adapter_kind, Rolle `detect |
| Ziel | Exakte erlaubte Scheme/Host/Port/Path-Kombination, TLS-/CAprofil, explizite Netzwerk-/Adressgrenze, trust_zone_id |
| Modell | Registrierte Modell-ID, erlaubte Rollen/Modalitäten, Contextwindow/Tokenizer bzw. Schätzverfahren, Ausgabegrenze, unterstützte Formate |
| Privacy | Policy-ID/-revision, erlaubte Zwecke/Datenklassen, erforderlicher ZDR-/No-training-/Region-/Loggingzustand, Belegreferenzen und checked_at/valid_until |
| Adapter | Erzwungene Requestparameter, erlaubte Upstreamprovider/Endpoints, Redirect-/Retry-/Transformverhalten, Transportlimitprofil |
| Secret | Ausschließlich credential_ref; Rohwert nur im Secret-/Transportadapter, nicht im Profil-Response oder Log |
Ein Boolean zdr=true ohne Beleg/Adapterfähigkeit reicht nicht. Eignung erfordert passende aktuelle Policy, dokumentierte tatsächliche Account-/Endpointkonfiguration und technische Erzwingbarkeit der geforderten Einschränkungen. Unbekannt/abgelaufen → Route nicht eligible. Default für erneute technische Belegprüfung sieben Tage und bei Profil-/Provideränderung; lokale Gründe können andere Fristen verlangen. Dies ist ein veränderbarer technischer Prüfzyklus, keine neue Familienfreigabe.
Aktuelle Bedingungen des konkret gewählten Empfängers sind gemäß ADR-09 vor realer persönlicher Nutzung zu prüfen. Diese Lieferung aktiviert keinen Provider und liest keine Account-/Keyeinstellungen. Tests verwenden synthetische Profile/Keys. Fehlt ein realer Beleg, bleibt der betreffende Pfad geschlossen; andere Appfunktionen können weiterlaufen.
6.1 Detect, Generate und lokale Empfänger
Detect: bevorzugt ein bereits vorhandener lokaler, ausdrücklich registrierter semantischer Detector. Er sieht nur den für Detection notwendigen finalen Text, keine vollständige Identityregistry, Sessioncredentials oder DBsecrets. Bestätigte lokale Identitäten werden im Gateway angewendet. Eine lokale IP oder .local beweist keine Vertrauenszone: Betreiber-/Zugriffs-/Logginggrenze, konkretes Ziel und Netzweg müssen zum Profil passen.
Generate: nur maskierter/minimierter B-Kontext bzw. kontrolliertes C, passendes Modell und Providerpolicy. Kein derselbe Key als stiller Fallback zwischen Rollen. Tools/Websuche/Embeddings/Transkription: eigene spätere Zweck-/Empfängerpfade; im ersten Schnitt nicht aktiviert. OpenRouter-ZDR ist keine Freigabe aller zusätzlich einschaltbaren Tools.
Neuer Standard: kein externer Klartext-Detect, auch nicht allein wegen APP_ENV=development. Persönliche Development-/Testdaten bleiben persönlich; CI arbeitet synthetisch. Kanshōs ausdrücklich beschriebene Übergänge bleiben dortige Bestandsregeln und werden im Reuseadapter als Abweichung dokumentiert. Es entsteht kein neuer Runtime-„Privacy aus“-Schalter und kein notwendiger neuer Detectdienst in diesem Auftrag. Ohne vorhandenen geeigneten Detect-/Reviewadapter bleibt B-Egress geschlossen.
6.2 Endpunkt- und Secretgrenze
Keine URL, Base-URL, Proxyadresse oder Callbackadresse aus Fach-/Browserinput. Nur registrierte Adapterziele; HTTPS mit Zertifikatsprüfung extern, HTTP ausschließlich für explizit erlaubte kontrollierte lokale Empfänger. Keine Userinfo/Secrets in URLs, keine frei wählbaren Header, keine Redirects. openrouter.ai wird exakt geprüft; ein Anzeigename oder endswith('openrouter.ai') ist keine Zielautorität.
DNS-Auflösung und tatsächlicher Verbindungsweg müssen die registrierte Zielgrenze einhalten. Netzwerkregeln des vorhandenen Containers/Hosts begrenzen den Adapter zusätzlich; DNS-Rebinding auf Loopback/Metadata-/fremde private Ziele darf kein neues Ziel öffnen. Eine pauschale Freigabe aller RFC1918-/Link-local-Adressen ist ausgeschlossen. Erforderliche lokale Adressen werden ausdrücklich registriert. Kann ein Adapter seine Verbindungsgrenze nicht gewährleisten, wird er nicht als eligible markiert.
HTTPX verwendet trust_env=False, keine impliziten Proxy-/CAumgebungswechsel, und ein ausdrücklich konfiguriertes TLS-/CAprofil. Client wird im Lifespan wiederverwendet und geschlossen; Keys werden nur für das konkrete legitime Authheaderziel injiziert. Provider-APIkeys sind notwendige Transportcredentials dieses Empfängers, keine erlaubten Modellkontextfelder. App-/DB-/Sessionsecrets und Mappingdaten gehen niemals in Payload, Attribution oder URL. HTTPX Umgebungsvariablen.
6.3 Konkreter OpenRouter-Adapter
OpenRouter ist ein vorhandener Adapterkandidat, kein Architekturzwang. Für entsprechend freigegebenen B-Egress setzt der Adapter insbesondere:
{
"model": "registered-model-id",
"messages": [{"role": "user", "content": "Freigegebener maskierter Text"}],
"max_tokens": 2048,
"stream": false,
"provider": {
"only": ["registered-upstream-slug"],
"allow_fallbacks": false,
"require_parameters": true,
"data_collection": "deny",
"zdr": true
}
}
Platzhalter-IDs werden aus dem passenden eligible Profil eingesetzt; keine aktuelle Modell-/Providerempfehlung oder bereits erteilte Freigabe. Keine Modellfallbackliste, Auto-Router, Tools, Plugins oder dynamischen Presets. Providerseitige Kontextkompression/zusätzliche Transformation ist für persönliche Payloads nicht zugelassen; die konkrete Deaktivierung muss der eingesetzte Adapter nachweisen. Der Gatewayadapter setzt Filter selbst; ein Renderer darf sie nicht überschreiben.
Die Parameter only, allow_fallbacks, require_parameters und data_collection werden in der OpenRouter-Routingdokumentation beschrieben. Bei fehlender geeigneter Route wird abgebrochen. Ein Providername allein belegt keine verlangte Region; wenn Region verpflichtend ist, braucht das Profil einen passenden tatsächlich erzwingbaren Endpoint-/Routingnachweis.
provider.zdr=true ist separat erforderlich; ein lokaler No-training-Boolean bzw. data_collection allein wird nicht als vollständiger Retentionsnachweis dargestellt. OpenRouter beschreibt ZDR für Inferenzrouting, weist Tools/Plugins eigene Policies zu und zählt bestimmte In-memory-Caches nicht als Retention. Daher bleibt die konkret benötigte Schutzwirkung zu prüfen. OpenRouter ZDR. Das sind begrenzte technische Gegenprüfungen, keine Aussage, jeder aktuelle Endpoint erfülle Jinkendos Anforderungen.
7. Ablauf und sichere Transaktionsgrenzen
7.1 Phase T1: autorisierte Aufnahme
In einer kurzen Foundation-UoW: aktuelle Session/Principal, Scope, Fachcapability und gegebenenfalls Entitlement prüfen; alle ausgewählten Quellen samt Version/Owner-/Scopegrenze materialisieren; unveränderlichen lokalen Snapshot erzeugen. Call-ID/Idempotenz registrieren und sicheren Auditmetadatensatz schreiben. Kein Modell-/Detector-/HTTP-Aufruf in dieser Transaktion. Der Renderer verarbeitet nur diesen autorisierten Snapshot und freigegebene Vorlagen-/Formatinstruktionen.
Die Berechtigung wird nicht aus den später vom Renderer eingetragenen SourceBinding-Strings geglaubt. Der Materialisierungsadapter erzeugt und bindet sie serverseitig. Nicht benötigte Felder werden vor Rendering ausgeschlossen. Eine nachträglich hinzugefügte Quelle verlangt erneute autorisierte Aufnahme.
7.2 Lokale Verarbeitung ohne offene DB-Transaktion
Vollständige Vorlage inklusive System-/Developer-/Historien-/Userteilen und statischem Outputvertrag fertigstellen. Inventur/Minimierung/Budgetprüfung durchführen. Für B den gesamten endgültigen Text lokal untersuchen, bestätigte eigene Registry ergänzen, offene Konflikte behandeln, requestbezogen maskieren. Payload einschließlich Adapterparameter fertigstellen und final validieren/sealen. Reihenfolge und Bindung stehen in Abschnitt 8/9.
Ein Reviewbedarf wird als privacy_review_required an den Fachadapter zurückgegeben. Generate wurde dann nicht aufgerufen. Vorhandene lokale Reviewmechanismen dürfen verwendet werden; fehlt ein geeigneter Adapter, bleibt dieser Fall geschlossen. Dieser Blueprint baut kein neues allgemeines Reviewportal und verlangt keine pauschale Bestätigung jeder Anfrage.
7.3 Phase T2: aktueller Dispatchentscheid
Unmittelbar vor Transport erneut unter kurzer UoW prüfen: aktueller Principal/Sessionsgeneration/Kontostatus, Scope/Mitgliedschaft, Fachrecht, alle Quellenversionen, Vorlagenrevision, aktive Policy-/Registry-/Providerprofilrevision und gegebenenfalls genau gebundene Reviewentscheidung. Weicht benötigter Kontext ab, context_changed statt Versand eines alten Snapshots. Keine stillschweigende Neuzusammenstellung nach der Privacyprüfung.
Bei Erfolg Dispatchintent samt Call-/Payload-/Routenbindung und erforderlichem Audit committen; kurzlebige interne Permit erzeugen, Default zwei Sekunden bis Beginn des Sendens. Hat das Warten auf Transportkapazität diese Frist überschritten, erneute T2-Prüfung vor Senden. Wiederholungen dieser kurzen lokalen Prüfung sind keine weiteren Modellversuche. Widerruf vor dem Dispatchentscheid sperrt den Call.
Zwischen DBcommit und externem Netzwerk besteht keine verteilte Transaktion. Eine Sperre unmittelbar nach dem Dispatchentscheid kann bereits freigegebene Bytes nicht zuverlässig zurückholen. Der Vertrag benennt deshalb diesen Autorisierungszeitpunkt, bindet den exakten Snapshot, hält das Zeitfenster klein und prüft nachher erneut. Es wird keine unmögliche Atomarität mit dem Provider behauptet.
7.4 Transport und Phase T3
Genau ein Generate-Versuch mit den geprüften Bytes; Antwort begrenzt einlesen, validieren und lokal rehydrieren. Danach erneut aktuelles Konto/Scope/Objekt-/Ausgaberecht prüfen. Bei Entzug oder Quellenkonflikt keine persönliche Antwort anzeigen oder als Fachergebnis speichern. Verbrauchs-/Fehlermetadaten des bereits erfolgten Aufrufs dürfen der Server unter eigenem engen Auditvertrag abschließen; sie geben keine Fachrechte zurück.
Wenn ein Fachergebnis gespeichert wird, verwenden Ausgaberecht, erwartete Objektversion, Ergebniswrite, Callabschluss und Audit dieselbe Foundation-Transaktion. Erst nach Commit Erfolg zurückgeben. Für reine Anzeige erhält T3 einen atomaren Metadatenabschluss plus aktuelle Lesefreigabe; das Ergebnis lebt nur im Antwortspeicher. Ein danach erfolgter Scopewechsel wird zusätzlich durch die Frontend-epoch abgefangen.
Fachservice/Workflow hält über den Gatewayawait keine DB-UoW offen. Der Gateway-HTTPpfad ist tatsächlich asynchron (httpx.AsyncClient); synchrone Psycopg-UoWs laufen über klar abgegrenzte Threadbridge-Funktionen, beispielsweise anyio.to_thread.run_sync. Kein blockierender SQLaufruf direkt im Eventloop und keine Connection über await weiterreichen. Abbruch beendet lokale Arbeit/Transport soweit möglich; ein bereits angestoßener Providercall kann trotzdem verarbeitet/berechnet worden sein.
8. Vollständige Detection und Maskierung
8.1 Inventur vor Detection
Der Adapter definiert eine geschlossene Payloadschema-Version. Für den ersten Schnitt enthält sie Modell-ID, erlaubte Textnachrichten, begrenzte numerische Parameter, Streamflag, kontrollierte Providerfilter und gegebenenfalls einen registrierten statischen Outputschema-Vertrag. Keine frei ergänzbaren metadata, user, Promptsuffixe, Plugins oder Tools.
Die Textinventur enumeriert alle endgültigen Nachrichtentexte: System, gegebenenfalls unterstützter Developerkanal, User, frühere Assistanttexte sowie jeder neu zusammengesetzte Kontext/Formattext. Tooltexte und weitere Felder sind entweder ausdrücklich unterstützt und vollständig inventarisiert oder verweigert; unbekannte Kanäle werden nicht ignoriert. Statische JSONschemabeschreibungen sind ebenfalls im Textinventar. Technische Schlüssel/Modell-/Provider-IDs stammen ausschließlich aus einer kontrollierten nicht persönlichen Registry; keine dynamischen persönlichen JSONkeys oder Schemas vom Browser. Externe $ref-/URLauflösung ist nicht erlaubt.
Inventareintrag: stabiler lokaler Feldpfad, Textrevision, lokale Quellenbindung, UTF-8-Bytegröße und Coveragebereiche. Derselbe Textstand wird für Detection und Maskierung verwendet. Unicode-/Zeilenendenaufbereitung findet, falls überhaupt nötig, vor dieser Bindung statt. Danach keine Normalisierung, die Spans verschiebt.
8.2 Semantische Detection, Registry und Review
Kanshōs requestbezogene Span-/Registrytrennung wird übernommen. Jeder notwendige Detect-Chunk muss tatsächlich erfolgreich verarbeitet und sein Ergebnis lokal am Originaltext geerdet sein: Feldpfad, Start/Ende als Python-Codepointindizes, beobachteter Text und Typ passen exakt. Schemafehler, abgeschnittene Antwort, Lücken oder Timeout verweigern B-Generate. Überlappende Chunks werden mit lokalen Offsets zusammengeführt; Randfälle dürfen weder verschwinden noch doppelt Identitäten bestätigen.
PERSON, PLACE, ORG, PROJECT sind die vorhandenen Ausgangstypen. Erweiterung nur bei konkretem Produktbedarf. Bestätigte eigene Identitäten/Aliase bleiben lokale Autorität. Ein Detect-Ergebnis erzeugt keine dauerhaft bestätigte Identität. Homonyme werden pro Vorkommen behandelt; keine neuen globalen Food-/Wetter-/Großschreibungswortlisten und kein Regexfallback, der einen semantischen Detectausfall als erfolgreich ausgibt.
coverage_complete=true bedeutet ausschließlich vollständige technische Verarbeitung des gebundenen Inventars. semantic_identity_guaranteed=false bleibt ausdrücklich erhalten. Ein Nulltreffer beweist nicht Identitätsfreiheit. Bekannte offene Konflikte oder erforderliche unbestätigte Entscheidungen blockieren bis zur gebundenen lokalen Klärung. Falls die konkrete Produktpolicy darüber hinaus eine geprüfte vollständige Freigabe persönlicher Eingabe verlangt, muss dieser Review-/Prüfadapter vorhanden sein; ein Fake „alles sicher“ ist unzulässig. Diese Grenze wird nicht durch neue Heuristiken verdeckt.
Vorab berechnete Treffer/Reviews sind nur wiederverwendbar, wenn Subject/Scope, sämtliche Feld-/Payloadrevisionen, Quellen, Registry-/Detector-/Policyrevision und Ablauf exakt passen. Ein Boolean full_detection_coverage=true aus dem Aufrufer reicht nicht. Ein bloßer Review des letzten Nutzersatzes deckt nicht automatisch Systemtext, Historie, RAG und spätere Renderergänzungen ab. Nicht abgedeckte Felder durchlaufen weiterhin Detection. Ändert sich die Vorlage oder ein nachgelagerter Nodeinput, gilt der alte Nachweis nicht.
8.3 Pseudonyme und lokales Manifest
Spanersetzungen aus Kanshō werden von hinten nach vorne auf den gebundenen Text angewandt. Überlappungen werden deterministisch aufgelöst oder als unklar verweigert; bestätigte Alias-/Identitätsregeln bleiben getrennt von unbestätigten Treffern. Nur tatsächlich eingesetzte Ersetzungen werden aktiv. Der Manifestnamespace ist mindestens Produkt + Scope + Subject + Call; ein Token aus B wird nie über A aufgelöst.
Vorhandenes Syntaxmuster [[PERSON:01]] bleibt als lokaler Adapterdefault möglich. Tokens sind innerhalb des Calls konsistent. Bestätigte lokale Identität kann intern über Calls stabil sein; extern wird standardmäßig pro Call neu zugeordnet, damit kein globales Personenkennzeichen entsteht. Kontextübergreifende stabile externe Pseudonyme sind keine Foundationpflicht. Aliase enthalten keine zusätzlichen Krankheiten, Herkunfts- oder Beziehungsinformationen.
Untrusted Eingabe darf die reservierte Identitätstokensyntax nicht selbst als Mappingbefehl einschleusen. Default: entsprechende rohe Tokens in neuen Quell-/Usertexten mit reserved_identity_syntax verweigern. Ein später tatsächlich benötigter Literaladapter kann sie eindeutig getrennt kodieren und muss getestet sein; kein stilles Verschlucken legitimen Inhalts. Vertrauenswürdige Vorlagen erzeugen konkrete aktive Tokens nur über den Manifestadapter.
Rehydrationstabelle enthält nur autorisierte aktive Tokens des Calls, nicht die ganze Profilregistry. Bestätigte Aliase können kanonisch, unbestätigte Requesttreffer in beobachteter Schreibweise rehydriert werden, entsprechend Kanshō. Kein Provider, Debugclient oder fremder Scope erhält diese Tabelle. Standardlebensdauer ist die Anfrage; nach Abschluss/Abbruch Referenzen freigeben. Persistente Quelldaten/Registries bleiben lokale Produktdaten und werden nicht als temporäre Diagnose gelöscht.
9. Finales Egress-Gate und unveränderlicher Transport
Nach Maskierung werden alle erlaubten Provider-/Formatparameter ergänzt, ein striktes endgültiges Payloadschema validiert und sämtliche ausgehenden Textfelder gegen das Manifest geprüft. Bekannte zu maskierende Identitätsvorkommen müssen ersetzt, technische Felder kontrolliert, Class-A-Felder entfernt und alle notwendigen Coverage-/Reviewbindungen gültig sein. Fehlender Beleg oder eine nicht unterstützte Zusatzoption sperrt den Versand.
Der Registry-Safety-Net-Adapter prüft die erwarteten zu schützenden Vorkommen im vollständigen Inventar, nicht ausschließlich bereits erfolgreich als manifest.replacements eingetragene Treffer. Eine zuvor ausgelassene bekannte Identität darf nicht dadurch unsichtbar werden, dass sie nie als aktive Ersetzung registriert wurde. Vorkommensbezogene Homonym-/Reviewregeln bleiben dabei bestehen; unbekannte semantisch übersehene Identitäten werden weiterhin nicht als garantiert erkannt dargestellt.
Serialisierung: deterministische JSONbytes in UTF-8, ensure_ascii=False, kompakte Separatoren, stabile Schlüsselreihenfolge, allow_nan=False; ungültige Surrogate oder nicht erlaubte Werte verweigern. Der interne Bytehash bindet genau diese Bytes an Route/Profil/Policy/Manifest/Call. Der Transport sendet content=sealed.body mit festem JSON-Content-Type, nicht erneut json=<veränderliches dict>. Keine SDK-/Middleware, die anschließend Promptteile/Tools/Metadaten anhängt.
Die einzige anschließende Ergänzung sind kontrollierte Transportheader, insbesondere der für genau diesen Empfänger benötigte Provider-Authheader. Keine Principal-/Profil-IDs, Cookie-/Sessionheader, freie Useragentzusätze oder rohe Quellnamen als Attribution. Request-ID/Call-ID bleibt lokal, sofern kein explizit geprüfter Transportvertrag eine nicht persönliche Korrelation benötigt. Finaler Endpoint und tatsächlicher Verbindungsweg sind Teil des Gates.
Vor .send verlangt der Adapter gültige Permit, passende Profil-/Policyrevision, Hash/Größe und freie Kapazität. Re-Rendering oder Änderung an Body, Schema, Modell, Route, Schlüsselzuordnung oder Prompt nach dem Gate macht den Seal ungültig. Ein Sendversuch konsumiert die interne Permit. Ein zweiter Generate benötigt eine neue explizite Callentscheidung; der Workflow kann nicht dieselbe Permit beliebig wiederverwenden.
Secretreferenzen liefern eine begrenzte Credentialversion zusätzlich zum Rohwert; die Version ist an die Route/Permit gebunden, der Rohwert bleibt nur im Transport. Eine zwischenzeitlich geänderte Zuordnung darf nicht denselben geprüften Call an ein anderes Konto/Ziel schicken. Der interne Status sent_or_unknown und ein begrenzter Providerrequestbezug können lokal gespeichert werden; ein möglicherweise vom Provider gelieferter Freitextbezug wird nicht ungeprüft als ID übernommen.
Eine spätere Antwortprüfung kann einen bereits erfolgten Datenversand nicht rückgängig machen. Deshalb müssen Canary-/Wiretests den tatsächlichen Adapterausgang untersuchen und nicht nur prüfen, dass eine Maskierungsfunktion aufgerufen wurde.
10. Transportgrenzen, Abbruch und Wiederholungen
10.1 Ressourcenprofil
| Einstellung | Technischer Ausgangswert |
|---|---|
| Gesamter Gatewaylauf einschließlich Detect/Queue/Generate | 90 Sekunden monotone Deadline; Fachzwecke dürfen begründet andere begrenzte Werte wählen |
| HTTP connect / pool / write / read inactivity | 5 / 2 / 10 / 30 Sekunden, jeweils zusätzlich zur verbleibenden Gesamtdauer |
| Parallelität | Zwei Gatewayläufe je Backendprozess, begrenzte Warteschlange 16; voller Eingang 503 |
| Eingabepayload | Maximal 64 KiB UTF-8 über sämtliche Textteile; Modellkontext zusätzlich prüfen |
| Detect-Chunks | Default 4.000 Codepoints mit begrenzter Überlappung 200; maximal 32 Chunks; vollständige Coverage Pflicht |
| Ausgabe | Default maximal 2.048 Outputtokens; tatsächliches Modellprofil und Zweck können kleinere Grenzen setzen |
| Providerresponse | Maximal 2 MiB decodierte Bodybytes und begrenzte Message-/Textlänge; Chunks zählen statt erst unbeschränkt .json() zu laden |
| Idempotenz-/Callmetadaten | Default sieben Tage, an produktbezogene Audit-/Abrechnungszwecke anpassen |
HTTPX unterscheidet Connect-/Read-/Write-/Pooltimeouts; Readtimeout ist eine Inaktivitätsgrenze pro empfangenem Chunk und keine Gesamtlaufzeit. Die zusätzliche monotone Deadline wird z. B. mit anyio.fail_after umgesetzt; Netzwerkressourcen werden bei Abbruch geschlossen. HTTPX Timeouts. Ein langsamer kontinuierlicher Bytestrom darf das Gesamtbudget nicht unbegrenzt verlängern.
Connectionpool und Admissionlimit sind explizit begrenzt. Bei mehreren Prozessen werden Limits budgetiert; ein Prozesslimit ist keine zugesicherte globale Kontenquote. Tokenbudget nutzt Modellprofil, reservierte Ausgabe und Sicherheitsmarge. Wenn nur eine konservative Zeichenschätzung verfügbar ist, wird sie so bezeichnet; unbekanntes Modellfenster oder Grenzverletzung führt zu lokalem Abbruch, nicht zu blindem Versand. Automatische Kürzung/Kompression nach dem Egress-Gate ist verboten.
10.2 Fehlerzustand und Kostenunsicherheit
Kein automatischer Generate-Retry, Reparaturprompt oder Modell-/Providerwechsel. Das gilt für 429/5xx, ungültiges JSON, Refusal, Verbindungsabbruch und Antwortvalidierungsfehler. Die erste erzeugte Antwort bleibt nicht durch eine heimliche zweite ersetzt. Eine bewusst angeforderte neue fachliche Ausführung erhält eine neue Call-ID und durchläuft Autorisierung/Privacy/Budget erneut.
not_sent ist nur zulässig, wenn der eigene Adapter sicher keinen Sendversuch begonnen hat. Nach Eintritt in den Transport ist bei Timeout/Abbruch der konservative Zustand sent_or_unknown, sofern kein engerer Nachweis existiert. Eine Exception oder Clientdisconnect bedeutet nicht „Provider hat nichts verarbeitet/keine Kosten“. Der Adapter speichert bekannte Usage, ansonsten unknown; keine erfundene Nullbuchung oder stille Freigabe einer möglichen Verbrauchsreservierung.
Bekannte HTTP-429-Antwort wird in ein sicheres begrenztes Retry-After übersetzt; der Client erhält keine automatische Wiederholungsanweisung für denselben Write. SDK-/Transportretrys werden ausdrücklich deaktiviert (Default null); kein versteckter HTTPTransport(retries=...) oder aus Providerbibliotheken übernommener Retry. Reine lokale T2-Neuprüfung und spätere lesende Statusabfrage sind davon getrennt.
11. Antwortvalidierung, JSON und Streaming
- Envelope streng prüfen: HTTPstatus, Content-Type, Bodylimit, eine erwartete Choice, bekannte Contentblöcke und Finishreason. Unbekanntes Format, versteckte Toolcalls oder
finish_reason=lengthbei erforderlichem vollständigem Ergebnis werden nicht als erfolgreiches Fachresultat behandelt. Refusal ist ein eigenes Ergebnis/Fehlercode, kein normaler Textblock. - Reasoning-/Thinking-/Toolblöcke werden nicht als sichtbarer Text ausgegeben oder in spätere Prompts übernommen. Nur ausdrücklich unterstützte Textblocktypen normalisieren; keine generische Rekursion durch alle Dictionarywerte.
- Für JSON: vollständige strikte JSONsyntax und das registrierte Pydantic-Ausgabemodell einschließlich Grenzen/Enums/
extra='forbid'tatsächlich validieren. Kein bloßesjson.loads(schema_ignored)und kein automatischer Repaircall. Default keine Markdown-Codefenceheuristik; ein bewusst benötigter Wrapperadapter ist eine getestete begrenzte Variante. - Privacy-/Tokenintegrität prüfen. Unbekannte, fremde oder inaktive Identitätstokens verweigern; keine freie Registryauflösung. Erkennbare unzulässige Identitätsvermutung/PII gemäß Produktpolicy blockiert die Antwort, ohne erneuten Generate. Homonyme bleiben vorkommensbezogen, keine globale Wortersetzung.
- Nur bekannte aktive Tokens lokal rehydrieren. Eine interne normalisierte Prüffassung ist nicht die sichtbare Fassung. Akzeptierter modellseitiger Klartext behält seine Oberflächenform; nach Demasking keine semantische/grammatische Umschreibung des Journaltextes. Das folgt Kanshōs bestehender Trennung. JSONkeys, IDs, URLs, Datum-/Zahlenwerte oder später gedachte Toolargumente werden nicht unkontrolliert rehydriert; ResultSpec nennt erlaubte Textpfade.
- Nach Rehydration erneut Ausgabelänge/JSONschema/zulässige Struktur prüfen und gemäß T3 autorisieren. Fachliche Plausibilität gehört zum konkreten Fachadapter; „valides JSON“ beweist weder Wahrheit noch aktuelle Gültigkeit. Kein Vorgriff auf ADR-16.
Das Gateway validiert untrusted Ausgabe und verleiht ihr keine Befehlsgewalt. Quellen-/Modellanweisungen können weder Datenklasse, Endpoint, Scope, Zugriffspolitik noch Toolrechte erweitern. HTML/Markdown wird im Frontend nach vorhandenem sicherem Renderingvertrag behandelt; kein rohes dangerouslySetInnerHTML aus Modelltext. Links werden nicht serverseitig automatisch besucht.
Auch der Browser darf keine modellseitigen Remote-Bilder, eingebetteten Inhalte oder Linkpreview-/Prefetchrequests automatisch laden. Default ist sichere Textdarstellung bzw. ein Renderer mit registrierten internen Medienreferenzen; aktive URLschemata werden verweigert. Identitätstokens in URLs/Markdown-Linkzielen werden nicht zu privaten Klartext-URLs rehydriert. Ein Modell darf lokale Demaskierung nicht in eine spätere Browserausleitung verwandeln.
Streamingdefault: stream=false; vollständiges Ergebnis puffern und erst nach Validierung/Demaskierung freigeben. Falls ein konkretes Produkt Upstream-SSE benötigt, wird es begrenzt gesammelt und erst das vollständige geprüfte Ergebnis ausgegeben. Kein persönlicher Rohdelta-/Reasoningstream an Browser oder DebugUI. Fortschrittsanzeigen dürfen reine sichere Phasenereignisse senden, aber keine ungeprüften Tokens. Ein späteres echtes inkrementelles Freigabeverfahren braucht einen eigenen nachgewiesenen Vertrag; es wird hier nicht als bereits sicher angenommen.
Verbindung zum Browser bei Scopewechsel/Logout schließen, alte Ergebnisse/Fehler nach epoch verwerfen. Der Caller setzt für lange KI-Operationen bewusst größere begrenzte Zeitbudgets, Default Client 105 Sekunden/Proxy 110 Sekunden bei Gatewaydeadline 90; der allgemeine Foundation-15-Sekunden-Default wird nicht global entfernt. Produktlokale längere Jobs sind Gegenstand des folgenden Workflowblueprints, kein neuer Worker in diesem Dokument.
12. Callledger, Idempotenz, Audit und Quotenport
Persistente lokale Metadaten verhindern unbemerkte doppelte Generate-Ausführung. Logischer Datensatz ai_calls:
| Feldgruppe | Inhalt |
|---|---|
| Identität/Owner | call_id UUID PK, subject_id, scope_kind, scope_id, execution_id, node_key, purpose; Owner-/Scopefilter bei jedem Lookup |
| Inputbindung | Vorlagen-/ResultSpec-/Policy-/Profilrevisionen, Quellenversionsdigest und HMAC-Fingerprint der vollständigen semantischen Eingabe; keine Promptvolltexte |
| Zustand | prepared, awaiting_review, dispatching, validated, completed, blocked, failed_unsent, unknown, rejected_output, discarded_after_revoke |
| Versand/Nachweis | dispatch_decided_at, Beginn/Ende, sicherer Outcome-/Reasoncode, bekannte Modell-/Routen-ID, Technik-/Reviewcoverage und Maskierungszähler |
| Ergebnis/Verbrauch | Optional erlaubte fachliche result_ref, validierter Usage-/Kostenzustand, optional späterer Reservierungsbezug; keine generelle Providerresponseablage |
Ein Unique-Constraint über Subject + Scope + execution_id/node_key bindet eine logische Ausführung. IDs sind begrenzt/validiert und nicht frei als Pfade verwendbar. Gleicher Schlüssel mit anderer Eingabe → 409 call_conflict. Während Dispatch oder bei unknown wird kein zweiter Call gestartet. awaiting_review kann nur mit derselben aktuellen Inputbindung und legitimer lokaler Reviewentscheidung fortgesetzt werden; inhaltlich geänderte Anfrage ist eine neue Ausführung. Keine HTTPbody-Flags als Freigabe.
Fingerprints werden mit einem separaten produktlokalen AI_FINGERPRINT_KEY als HMAC berechnet, damit gespeicherte Hashes kurzer persönlicher Texte kein einfaches Wörterbuchorakel bilden. Rohes Payload-SHA dient nur intern zur unmittelbaren Bytebindung und wird nicht als öffentlicher Debugwert persistiert. Fingerprint bindet Subject/Scope/Zweck, Input-/Vorlagen-/Quellen-/Policy-/Profilstand und Ergebnisformat, nicht die Cookiegeneration; spätere legitime Sessionerneuerung erzeugt keine neue logische Facheingabe. Aktuelle Autorisierung bleibt trotzdem bei jedem Lookup Pflicht.
Der Ledger speichert die Fingerprint-Key-ID; benötigte alte Keyversionen bleiben über die Idempotenz-/Aufbewahrungsfrist verfügbar bzw. werden kontrolliert migriert. Fehlt nach Rotation/Restore eine benötigte Version, wird ein bestehender unbekannter Call nicht als neue freie Ausführung behandelt. Der Recovery-Schlüsselvertrag aus dem vorherigen Blueprint umfasst diesen Bedarf, ohne den Key in Datenarchiv oder Logs zu schreiben.
Schema/Fremdschlüssel nutzen die lokalen Account-/Scope-IDtypen der Zielanwendung; für einen neuen Foundationaufbau die in Phase 3.3 vorgesehenen Konten. Kein universeller Tenantstore. Callabschluss/Ergebniswrite/Audit committen zusammen. Netzcall und DB können nicht atomar sein: Prozessabbruch nach Dispatchintent wird konservativ als ungeklärter Aufruf behandelt, nie automatisch erneut gesendet. Nach Neustart sind offene dispatching-Zeilen zu klären bzw. unknown; ein Ablaufdatum erteilt keine neue Generate-Erlaubnis.
Die siebentägige Standardretention betrifft abgeschlossene ungebundene Metadaten. Laufende/ungeklärte Calls und durch Fach-/Workflowausführungen referenzierte Call-IDs behalten mindestens ihren gesperrten Idempotenz-/Outcometombstone; Cleanup darf sie nicht zu unbekannten „neuen“ Ausführungen machen. Für abgeschlossene Calls außerhalb des ausdrücklich zugesicherten Idempotenzfensters wird keine unbegrenzte Wiederabrufgarantie behauptet. Eine bewusst neue Generierung verwendet eine neue Ausführungs-ID.
Ein bereits abgeschlossenes persistiertes Fachergebnis kann nach aktueller Autorisierung per result_ref erneut gelesen werden. Bei reiner Anzeige ohne gespeichertes Resultat gibt es keinen langlebigen Antwortcache; Wiederabruf desselben Calls liefert result_unavailable, keine kostenpflichtige Neugenerierung. Der Fachauftrag kann ausdrücklich eine neue Ausführung anfordern. Keine personenbezogenen globalen Antwort-/Promptcaches.
12.1 Auditgrenzen und Speicherung
Pflichtmetadaten: Call-/Request-ID, lokale Subject-/Scopebindung, Zweck, verwendete Profil-/Policy-/Vorlagenrevision, lokale Dispatchentscheidung, Coverageart, semantic_identity_guaranteed=false, Zähler/Größen/Dauer, bekannter Usagezustand, Ausgabestatus und sicherer Reasoncode. Keine echten Labels, Aliase, Mappings, Cookie-/Provider-/DBsecrets, System-/Userpromptvolltexte oder Modellantworten in Log/APM/Exceptions/DebugUI. Providerfehlertexte können Eingaben spiegeln und werden daher nicht durch bloßes Abschneiden sicher.
Der Gateway speichert standardmäßig keine Rohprompts, Rohantworten oder Manifestmappings. Fachlich bewusst bewahrte Originalquellen und akzeptierte Ergebnisse bleiben normale lokale Produktdaten mit eigener Autorisierung/Retention; Kanshōs Quellbewahrung wird dadurch nicht abgeschafft. Diagnoseberechtigung ist keine pauschale Freigabe privater Texte. Tests dürfen Wirebodies ausschließlich mit synthetischen Inhalten und für den Testlauf aufzeichnen.
Fehlt der erforderliche Auditspeicher vor Dispatch, kein Versand. Scheitert der Abschluss nach möglichem Versand, wird kein zweiter Call zur „Reparatur“ erzeugt; Fehler und späterer Reconcile bleiben sichtbar. Das Release-/Recoveryverfahren aus dem vorherigen Blueprint muss auch Callledger und ungeklärte Zustände erhalten; Restore macht alte dispatching-Zeilen nicht erneut ausführbar.
12.2 Anschluss an Entitlements und Verbrauch
EntitlementPolicy ist zusätzlich zur AccessPolicy erforderlich, soweit das Produkt die Funktion begrenzt. Für spätere harte Kontingente gilt der kleine lokale Port:
@dataclass(frozen=True, slots=True)
class BudgetEnvelope:
call_count: int
upper_input_tokens: int | None
upper_output_tokens: int | None
maximum_cost: str | None
cost_basis_revision: str | None
class UsageBudgetPort(Protocol):
def reserve(self, tx: object, context: RequestContext,
call_id: str, upper_bound: BudgetEnvelope) -> str: ...
def settle(self, tx: object, reservation_id: str,
actual: UsageReport) -> None: ...
def mark_unknown(self, tx: object, reservation_id: str) -> None: ...
def release_unsent(self, tx: object, reservation_id: str) -> None: ...
Dieser Port ist noch keine Billing-/Quotenimplementierung. Der folgende Entitlements-/Quota-Blueprint konkretisiert Atomarität, Perioden und Buchungsregeln. Ein Produkt ohne harte Quoten braucht nur die technischen Limits und Usageerfassung; es darf deshalb keine zugesicherte Kontingentgarantie behaupten. Ein Produkt mit harter Grenze bleibt ohne passenden echten Adapter geschlossen. Mitais heutiges „nach Erfolg hochzählen“ wird nicht als sichere parallele Reservierung oder Abrechnung unbekannter Ergebnisse ausgegeben. Fehlende Usage ist unknown, nicht kostenfrei.
Eine Schätzung ist keine zugesicherte Obergrenze. Der Adapter erhält im BudgetEnvelope nur tatsächlich belastbare obere Schranken, ansonsten None; er darf eine verpflichtende harte Token-/Kostengrenze dann nicht durch einen Schätzwert freigeben. Die Generate-Callanzahl kann für diesen Schnitt eindeutig mit eins begrenzt werden. Detect-/Toolverbräuche erhalten gegebenenfalls eigene Budgetzwecke und werden nicht unsichtbar in einen Generateerfolg eingerechnet.
13. Fach-API, Fehler und Frontendanschluss
Es entsteht kein öffentliches „beliebigen Prompt an beliebige URL senden“-API. Fachmodule registrieren konkrete Operationen mit festem Zweck, ResultSpec und serverseitiger Quellenauflösung. Beispiel: POST /api/v1/<feature>/{resource_id}/generate mit {expected_version, instruction?}; Session, CSRF/Origin und Scopeheader folgen Phase 3.3. instruction ist begrenzter untrusted Eingabetext und Bestandteil der Privacyinventur, keine übergeordnete Policy.
Idempotency-Key ist eine begrenzte kanonische UUID des Fachauftrags; node_key setzt der Server. Die Call-ID wird serverseitig erzeugt. Bodyfelder wie provider_url, api_key, data_class, profile_id, privacy_checked, precomputed_mappings, tools und frei gewählte model-IDs sind im Fach-DTO nicht erlaubt. Ein zugelassener Modellwunsch wäre höchstens ein registrierter serverseitig erneut geprüfter Variantenbezeichner.
FastAPI-Anschluss als Illustration V/K; das eigentliche Fachmodul implementiert den benannten Service. Synchrone DBphasen liegen innerhalb dessen expliziter Threadbridge, der Gatewayawait enthält keine offene DBverbindung:
from typing import Annotated
from uuid import UUID
from fastapi import APIRouter, Depends, Header, Request
from pydantic import BaseModel, ConfigDict, Field
from app.api.dependencies import scoped_context
from app.core.context import RequestContext
class GenerateInput(BaseModel):
model_config = ConfigDict(extra="forbid", strict=True)
expected_version: int = Field(ge=1)
instruction: str | None = Field(default=None, max_length=2000)
class GenerateOutput(BaseModel):
call_id: str
content: str
router = APIRouter(prefix="/api/v1/feature")
@router.post("/{resource_id}/generate", response_model=GenerateOutput)
async def generate(
resource_id: str, body: GenerateInput, request: Request,
context: Annotated[RequestContext, Depends(scoped_context)],
idempotency_key: Annotated[UUID, Header(alias="Idempotency-Key")],
):
return await request.app.state.providers.feature_service.generate(
context, resource_id, body, str(idempotency_key),
)
Eine optionale reine Statusroute GET /api/v1/ai/calls/{call_id} liefert nur call_id,status,usage_status,result_ref? nach aktuellem Recht und Subject-/Scopefilter. Fremder oder unsichtbarer Call: 404. Sie gibt keine Prompts/Manifestlabels/Providerfehler zurück und löst keinen neuen Modellaufruf aus. Ein Review-/Fortsetzungsendpunkt ist produktlokal; er verwendet einen serverseitig gebundenen kurzlebigen Reviewbeleg, nicht confirmed=true aus dem Client. Er ändert keinen bestehenden Datenstand ohne den entsprechenden Fach-/CSRF-/Versionsvertrag.
| HTTP / stabiler Code | Bedeutung und Wirkung |
|---|---|
401 session_invalid |
Kein aktueller Principal; kein Dispatch oder keine Ergebnisfreigabe |
403 capability_denied, scope_forbidden, ai_policy_denied |
Zugriff/Zweck/Datenklasse/Privacy nicht erlaubt; keine Daten nach außen |
404 not_found |
Fachquelle/Call fremd, unsichtbar oder fehlend |
409 context_changed, call_conflict, call_in_progress, call_outcome_unknown, result_unavailable |
Kontext oder Ausführungszustand benötigt bewusste neue Entscheidung; kein automatischer Callretry |
409 privacy_review_required |
Generate noch nicht gesendet; Produkt kann seinen bestehenden lokalen Reviewpfad öffnen |
422 validation_failed, prompt_budget_exceeded, reserved_identity_syntax, unsupported_modality |
Eingabe/Format/Limit vor Versand verweigert |
429 ai_rate_limited |
Explizites Kontolimit bzw. sichere normalisierte Providerbegrenzung; Retry-After begrenzt, keine automatische Mutation |
502 provider_invalid_response, output_invalid, model_refused |
Upstreamantwort/ResultSpec/Integrität nicht nutzbar; kein Repaircall |
503 ai_unavailable, privacy_detection_unavailable, ai_busy, policy_unavailable |
Fehlende Pflichtadapter/Eignung/Kapazität; keine unsichere Fallbackroute |
504 ai_deadline_exceeded |
Zeitlimit; Outcome kann bereits sent_or_unknown sein, kein Erfolg/keine Nullkostenbehauptung |
RFC-9457-Problemformat mit sicheren Maschinen-/Requestcodes gemäß Foundation. Insbesondere keine Rohwerte in Feldfehlern, keine Unknown-Tokenlabels oder Providerantwortschnipsel in detail. Für alle persönlichen Erfolgs-/Fehler-/Statusantworten Cache-Control: no-store. Fach-DTOs nennen keine Authcredentials oder Backendproviderprofile.
Frontend nutzt zentralen Cookie-/CSRF-/Scopeclient, setzt begrenzten KI-Timeout ausdrücklich, zeigt sichere Phasen-/Fehlermeldungen und verwirft alte Resultate/Fehler nach epoch. Ein 403/503 ist kein Logout; ein 504 löst keinen automatischen zweiten Generate aus. Kein persönliches Ergebnis im Service Worker, LocalStorage oder gemeinsamem Modellcache. Ausgabe wird mit dem jeweiligen sicheren Text-/Markdown-/Rich-Textadapter angezeigt.
14. Automatisierte Negativ- und Sicherheitsprüfungen
Die Matrix ist ein Testauftrag, kein Ergebnisbericht. Verwendet werden synthetische Personen-/Orgdaten, eigene Call-/Providerprofile, Fakedetectoren, Wire-Capture-Transport und isoliertes echtes PostgreSQL mit begrenzter Runtime-Rolle. Keine realen Providerkeys, privaten Textbestände oder Live-Modellaufrufe. Testfakes werden nur über Testproviderverdrahtung bereitgestellt; der Runtimeaufbau kann sie nicht per Flag auswählen.
Canaries erscheinen in jedem erlaubten Textkanal: System-/Developertext soweit unterstützt, User, Historie, Kontext/RAG, Registryalias und JSONschemabeschreibung. Unbekannte Zusatzfelder/Modalitäten erhalten eigene Ablehnungstests. Tests prüfen die an den Providertransport übergebenen endgültigen Bytes und alle erlaubten Transportmetadaten. Nicht nur den Aufruf einer Maskierungsfunktion mocken. Synthetische Wireaufzeichnung bleibt lokal im Test; keine Produktionsdebugfunktion daraus ableiten.
| ID / Suite | Testfall | Zwingende Assertions |
|---|---|---|
A01 test_gateway_access.py |
Keine/abgelaufene Session, falscher Scope, fremdes Profil/Objekt, fehlende Capability | 401/403/404 vor jedem Detect-/Generatezugriff auf fremde Inhalte; keine Cross-Profilequelle |
| A02 | Gemischte eigene/fremde RAG-/Eltern-/Memoryquellen | Jede Quelle scoped geprüft; keine fremden Inhalte/Counts in Kontext, Wire oder Fehler |
| A03 | Sitzung/Mitgliedschaft/Recht nach T1 entzogen, Quelle/Vorlage geändert | T2 verhindert alten Dispatch; kein unverifizierter Neuaufbau |
| A04 | Rechte-/Objektänderung während Generate | Keine unautorisierte Anzeige/Fachspeicherung; Callusage sicher abgeschlossen, kein zweiter Call |
| A05 | Class A, unbekannte Klasse, persönlicher Text als C, vom Client behauptete Klasse | Local-only extern nie gesendet; C nicht als Bypass; Klassifikation serverseitig |
| A06 | Bekannter Providerkey/Private-Keyblock oder credentialhaltige URL im Input | ForbiddenContentGuard blockiert vor Detect/Generate; keine Secretwerte in Fehlern oder Logs |
I01 test_egress_inventory.py |
Canaries in sämtlichen Textkanälen und statischer Schema-/Formatinstruktion | Vollständige Inventur/Maskierung/Prüfung; erwarteter endgültiger Body ohne zu schützenden Canaryklartext |
| I02 | Aufgelöster Platzhalter/Frageergänzung erst nach Nutzertextreview | Alte Coverage reicht nicht; fehlende finale Felder neu prüfen oder blockieren |
| I03 | Geänderte Template-/Source-/Registry-/Policyrevision bei precomputed Mappings/Review | Alte Belege zurückweisen; bloßes full_detection_coverage=true reicht nicht |
| I04 | Abgeschnittener/fehlender Detectchunk, UTF-8-/Unicodeoffset, Randüberlappung | Coverage-/Spangrounding korrekt; kein Generate bei technischer Lücke; kein stilles Truncation |
| I05 | Detect-Timeout, Nulltreffer, ungültiges Detectschema, unbekannter Typ | Ausfall blockiert; Nulltreffer nicht als semantische Garantie; keine Heuristik-/Wortlistenrettung |
M01 test_masking.py |
Vorkommensbezogener Homonymfall, Alias, überlappende Namen, Projektname | Nur passende geerdete Spans; bestätigte/unbestätigte Herkunft getrennt; kein globales Ersetzen aller gleichen Wörter |
| M02 | Zwei parallele Subjects/Scopes mit gleich aussehenden Tokens | Getrennte Manifeste/Antworten, keine globalen Traces oder Cross-Profile-Rehydration |
| M03 | Inaktives Mapping, fremder/erratener Token, reservierte Syntax aus Userquelle | Nur tatsächlich aktive eigene Tokens auflösbar; Injection/unknown Token verweigert |
| M04 | Bekannter Alias vs. unbestätigter Treffer, akzeptierter Modellklartext | Kanonisch/beobachtet korrekt; Prüffassung nicht sichtbare Ausgabe; keine grammatische Umformung |
P01 test_provider_policy.py |
Fehlendes/abgelaufenes Eignungsdokument, Boolean-ZDR ohne Beleg, ungeeignete Region/Endpoint | Nicht eligible, keine Generierung; keine pauschale Providerfreigabe |
| P02 | OpenRouter-Payload, ungeeigneter Fallback, nur data_collection gesetzt |
Gültiger vollständiger Profilvertrag setzt erforderliche Filter; kein Modell-/Providerfallback oder unerlaubter Transform |
| P03 | URL aus Userinput, Suffixtrick, Redirect, DNS-Rebinding, Metadata-/fremde interne IP | Vor bzw. am Connect verweigert; kein Secret an fremdes Ziel; private IP allein ist keine Vertrauenszone |
| P04 | Impliziter Proxy/CA aus Umgebung, falsches Zertifikat, fremder Authheader | trust_env=False/explizite CA wirksam; falsches TLS abgelehnt; nur richtiger Profilkey am Ziel |
| P05 | Remote-Klartext-Detect per Devmodus/Flag, Fakeprovider im Runtimeaufbau | Kein Standardbypass; ungeeigneter B-Pfad geschlossen; Tests injecten Fakes ausschließlich lokal |
| P06 | LocalDetectInput gegen Generate-/externes Detectprofil oder mit Registrydaten | Typ-/Rollen-/Trust-Zone-Grenze verweigert; lokaler Detect erhält nur erlaubte Textfelder |
T01 test_transport.py |
Body/Modell/Profil/Policy nach Seal verändert, abgelaufene Permit | Kein Versand; Bytehash-/Revisions-/Zeitbindung greift |
| T02 | Genau ein erlaubter Send, danach erneute Permitverwendung | Keine zweite Sendung; Wirebytes entsprechen finaler Prüfung, keine nachträglichen SDKfelder |
| T03 | Connect-/Pool-/Read-/Writefehler, langsam kontinuierlicher Stream | Einzel-/Gesamtlaufzeitgrenzen; Ressourcen frei; nach möglichem Versand Outcome unknown statt kostenfrei |
| T04 | 429/5xx, ungültiges JSON, Refusal, Disconnect nach Providerannahme | Kein versteckter Retry/Repaircall; sichere Fehler; keine Behauptung „Provider hat abgebrochen“ |
| T05 | Queue/Pool voll, mehrere Prozesse, riesige Input-/Responsebody | Begrenzte Ablehnung und gemessene Limits; keine Poolumgehung oder unbeschränkte .json()-Allokation |
O01 test_model_output.py |
Falsche Envelope/Choice/Finishreason, Reasoning/Toolblocks | Nur erlaubte Formate; keine versteckten Tools/Reasoninginhalte in Ergebnis/Historie |
| O02 | Valides JSON mit falschem Schema/extra Feldern/NaN/Grenzwerten | Lokales striktes ResultSpec tatsächlich geprüft; keine TODO-Schemaannahme oder Repairgenerierung |
| O03 | Unbekannter/inaktiver Token, unzulässige Identitätsvermutung | Ausgabe verworfen, keine fremde Lookupauflösung; Egress nicht nachträglich als ungeschehen erklärt |
| O04 | Rehydration in JSONtext gegenüber Keys/IDs/Zahlen/URLs | Nur erlaubte Textpfade; Schema nach Rehydration nochmals gültig |
| O05 | Persönlicher Upstreamdelta-/Fehlerstream vor Validierung | Kein Rohdelta an Browser/Debug; begrenztes Puffern bzw. Ablehnung, nur sichere Fortschrittsereignisse |
| O06 | Modellantwort mit Remote-Bild/HTML/aktivem Link oder Identitätstoken in URL | Kein automatisches Browser-/Serverfetch und keine private Rehydration in Linkziele; sicherer Renderer |
C01 test_gateway_calls.py |
Parallele gleiche Idempotenz, geänderter Fingerprint, alter Scope | Ein Send höchstens, 409 bei Konflikt; jeder Lookup aktuell autorisiert |
| C02 | Prozessabbruch vor/nach Dispatchintent bzw. nach Ergebnis, vor Abschlusscommit | Keine automatische erneute Sendung; unknown/persistierte Resultreferenz korrekt |
| C03 | Metadaten-/Auditfehler vor Dispatch vs. danach | Vorher kein Versand; nachher sichtbarer ungeklärter Zustand, keine Erfolgsausgabe oder heimliche Wiederholung |
| C04 | Usage fehlt, echte Nullusage, abgeschätzte statt oberer Budgetgrenze | Unknown von null getrennt; harte Quoten nicht durch unbewiesene Schätzung freigeben |
| C05 | Restore alter offener Calls, Fingerprintkeywechsel | Alte dispatching/unknown Calls werden nicht automatisch ausführbar; Idempotenz-/Key-ID-Vertrag bleibt nachvollziehbar |
L01 test_ai_diagnostics.py |
Providerfehler enthält Canary/Prompt/Key, Exception/Repr/Log/APM | Keine sensitiven Spiegelungen in HTTP/Logs/DTOs; Maskierungszähler statt Labels |
| L02 | Debugberechtigung, gespeicherte Fachquelle, temporäres Mapping | Debug exportiert keine Volltexte/Mapping; Fachquellbewahrung unverändert; Callmapping nur lokal |
| F01 Frontend-/APItests | Fehlende CSRF/Scope, fremde Call-ID, extra Providerbodyfelder | Phase-3.3-/DTO-Verträge wirksam; keine generische freie Proxyroute |
| F02 | Scopewechsel/Logout mit verspäteter KIantwort/401/504 | epoch verwirft alte Antworten/Fehler; kein Autoretry, 403/503 kein Logout |
14.1 Anschluss an vorhandene Testquellen I
- Kanshō Manifestfälle: aktive/inaktive Mappings, Homonyme, Alias-/Prüffassung und Rehydration übernehmen; um komplette Payload-/Scoped-/Wirebindung erweitern.
- Kanshō Span-/Pre-Egress-Test: Spangrounding, Überlappung und Blockade vor Provider als Ausgangsfälle.
- Kanshō Detectionverträge: Fakes belegen Schema/Fail-Closed-Verhalten, ausdrücklich keine Livequalität.
- Kanshō verwendet einen eigenen pytest-Collector, der Testskripte über
main()als je einen Fall sammelt. Eine Testdatei oder gefundene Hilfsfunktion beweist deshalb weder einzelne pytest-Coverage noch Erfolg. Im neuen Zielaufbau diese Fälle als einzeln benannte native pytest-Tests mit konkreter Pflichtcollection anlegen; Bestandscollector nicht pauschal kopieren.
Integrationstests verwenden echten isolierten PostgreSQLzustand nach dem Releaseblueprint. Reine Transformationen laufen ohne DB/Netz, Transporttests mit Fake-/Wireadapter. Nach Einführung eines tatsächlichen lokalen Detectors ist eine separate synthetische Qualitätsauswertung mit benanntem Modell/Stand nötig; sie wird nicht aus Mocktest-Erfolg abgeleitet. Reale persönliche Providererprobung ist nicht Teil dieser Lieferung oder Pflicht-CI.
15. Implementierungsauftrag für Cursor und nachfolgende Blueprints
Dieser Abschnitt wird hier nicht ausgeführt. Der spätere Auftrag benennt das Zielrepository und die erste tatsächliche KI-Funktion. Ohne konkrete Zielfunktion keine bestehende App als allgemeines Gatewayframework umbauen.
- Foundation v0.3, Phase-3.3-Kontext/Access/UoW und Releaseblueprint beibehalten. Lokales Gatewaymodul mit explizitem Composition Root/Ports aufbauen; keine Cross-Repoimporte oder neue zentrale Inferenzplattform.
- Kanshōs Maskierungsmanifest, Span-/Alias-/Registryregeln und Pre-Egress-Reihenfolge gezielt übertragen. Aktuelle Source-/Profil-/Policy-/Inventurbindung und Callisolation ergänzen. Vorhandene Globaldiagnose, Fake-Runtimeflags und pauschale Local-URL-Vertrauensprüfung nicht übernehmen.
- Den einen Fachzweck mit erlaubten Quellen/Feldern, B/C-Regel, Vorlage und lokalem ResultSpec registrieren. Scoped Materialisierung über vorhandene Repositories; keine neue Prompt-/Workflowengine. Mitais späteren Adapter an
RenderedPrompt/ModelGateway.completebinden. - Echte lokale Detect-/Reviewadapter und Profil-/Secret-/Eligibilityadapter anbinden, soweit vorhanden. Für Tests ausschließlich synthetische Fakes. Fehlende reale Eignung/Detection lässt persönlichen Egress geschlossen und wird als offen dokumentiert; keine echten Keys/privaten Texte zu „Smokezwecken“ verwenden. Kein neuer Detectdienst wird automatisch installiert.
- Payloadinventur, technische Coverage, Spangrounding, aktive Manifestmaske und den finalen Byte-Seal implementieren. Unbekannte Zusatzfelder, Klasse A, reservierte Tokeninjektion und ungeklärte Konflikte sperren. Keine ungescannten Format-/Systemtexte nachreichen.
- Async-HTTPadapter im Lifespan mit expliziten Endpunkten/TLS/Proxygrenzen, null Retries, Pool-/Admission-/Bodylimits und monotoner Gesamtdauer implementieren. Synchrone DBphasen in getrennten Threadbridge-UoWs; kein SQL-/HTTPmix in einer offenen Transaktion. OpenRouterparameter nur bei tatsächlich entsprechend eligible Profil verwenden.
- Callledger/Uniqueconstraints und T1/T2/T3 mit aktuellem Recht, Quellen-/Profilrevision, Dispatchintent, Audit und konservativem unknown-Zustand implementieren. Ergebniswrite atomar mit fachlichem Audit. Reviewfortsetzung exakt binden; keinen booleschen Clientnachweis akzeptieren.
- Envelope-, JSON-/Pydantic-, Token-/Privacyprüfung und lokale Rehydration implementieren. Kein Live-Rohstream oder Repaircall. Akzeptierten Journaltext nicht nachträglich umschreiben. Usage unbekannt korrekt erhalten, Quotenport nur bei realer Anforderung verdrahten.
- Fachrouter/Statusroute mit Auth-/CSRF-/Scope-/Idempotenzvertrag und sicheren Problemcodes anbinden. Zentralen Frontendclient/epoch beibehalten, begrenzten KI-Timeout lokal setzen, Ausgabe sicher rendern; keine persönlichen Webcaches oder Providerkeys im Frontend.
- Native Tests aus Abschnitt 14 tatsächlich sammeln/ausführen, Wirecanaries über alle Kanäle und negative Nebenpfade prüfen. In beiden Releasevarianten blockieren fehlende/rote KI-Pflicht-Gates vor Produktion. Produktionsmodus ebenfalls isoliert mit synthetischen Profilen prüfen; kein Devflag lockert Privacy. Ergebnisbericht nennt Commit, Image-/Policy-/Profil-/Detectorstand, Tests/Umgebung und offene Adapter. Nur tatsächliche bestandene Tests als T kennzeichnen.
Der nächste Prompt-/Platzhalter-/Workflow-Blueprint konkretisiert Vorlagenversionierung, Registrierungen, Graph-/Nodezustände und Wiederaufnahme. Er konsumiert diesen Gatewayvertrag; jeder Modellnode erhält ihn, ohne Privacy und Providertransport nochmals zu erfinden. Der anschließende Entitlements-/Verbrauch-/Quota-Blueprint konkretisiert Reservierung/Abrechnung, insbesondere parallele und unbekannte Ergebnisse. Beide werden durch dieses Dokument nicht automatisch gestartet.
Abnahme eines späteren ersten vertikalen Slices: autorisierte synthetische Quelle → vollständig gerenderter Prompt → lokale Detection/Maskierung → nachweislich geprüfte Wirebytes zum Fakeprovider → valides maskiertes Ergebnis → nur eigene lokale Rehydration → aktuell autorisierte Ausgabe/atomarer Fachwrite. Cross-Scope-Daten, Direct-HTTP-Bypass, unbekannter Outcome und ungültige Antwort müssen dabei sichtbar verweigert werden. Ein grüner Slice bleibt ein begrenzter Integrationsnachweis, keine universelle Detektions-/Produktreifezusage.
16. Prüfstand dieser Lieferung
Erstellt wurde ausschließlich dieses neue Blueprintdokument. Produktrepos, Foundation, Auth- und Releaseblueprint blieben unverändert. Keine Codeimplementierung, Modell-/Live-APIaufrufe, produktiven Credentials/Datenbanken, privaten Testtexte, Paketinstallationen, Migrationen, Deployments oder Anwendungstestläufe.
Dokumentprüfung umfasst lokale Referenzen/Zeilen, Python-/JSONbeispielsyntax und Konsistenz von Context-/Provider-/Payload-/Call-/Fehler-/Testverträgen. Das ist kein T-Nachweis für die geplante Lösung. Technische Providerdetails wurden begrenzt gegen offizielle OpenRouter-/HTTPX-Dokumentation geprüft; konkrete Account-/Endpointbedingungen und lokale Detectorqualität wurden nicht erhoben oder freigegeben.
16.1 Lokaler Quellstand
Lesestand 16.10.2026. Hashes über vollständige Dateien; Git-HEAD allein ist kein Beleg eines sauberen Checkouts.
Kansho: Git-HEAD89d149684eab9211d6ef21181d018de097a61783shinkan-jinkendo: Git-HEADf10c28e5cdcef52cc44e953a8494b4bbe35b77femitai-jinkendo: Git-HEAD95453d548a2113555cd7e8f01fbbf267cbe34f3fkairo-jinkendo: Git-HEADea0aa18b8dd9a55f663a996d74e63b7e3ee0dc16
| Gezielt verwendete Produktquelle | SHA-256 |
|---|---|
| Kansho/backend/privacy_gateway.py | 0e729287b6a87ba1a8ef92c6dce27cc3c3e1e829b6958130e59b4e90ff2a3d74 |
| Kansho/backend/providers.py | 86b6924d680ce8fe35e723f82226ac5c76bb7abe900fbdec1c20250de7af069f |
| Kansho/backend/provider_settings.py | c38b352b289bbe6cce46d5d8482f26aabc4af8e29b8e3e6cd8f16460f98a122f |
| Kansho/backend/engine.py | 79b86c6ff69ff87ea4e02c26203ac39beebccf2cce7078ed246ae73971488159 |
| Kansho/backend/context_builder.py | 712cb720267b57ac7fe471d7ec2a7cb25d9cd41cf8a19d63a8b083599c96586a |
| Kansho/backend/prompt_budget.py | b95a36a6cd9e0ee704cd88b495bf9475230cdf5f0a2cb711458f27382af2be78 |
| Kansho/backend/tests/test_privacy_manifest.py | b48e16b901668efcd31f1534575400836cd3f68e5bd658d711ac7429c23526c5 |
| Kansho/backend/tests/test_privacy_response_integrity.py | b98035d558007b84c268b6d1b03e28d5b3b35f1984f821b6bbce9e9e84e6ae38 |
| Kansho/backend/tests/test_privacy_detect.py | 7b1043509fbe173f02e6ef050e2527a7adb27919dfbc1265832533e5c9d50347 |
| Kansho/docs/architecture/functional/guardrails.md | deadd95b5019fe807026616f6ff74a2467d9d951702c032573d59f27c125dc4b |
| Kansho/docs/architecture/technical/privacy_gateway.md | 496c8661f645b8935edc8ce46214cfda3becca2588125eae345a7a860d9a07c5 |
| shinkan-jinkendo/backend/openrouter_chat.py | 606941440d7a7dd0a971cc0606e4ed8a5ad07f0b454374dc25dab8dd5c8a149a |
| mitai-jinkendo/backend/prompt_executor.py | 7e0e97047fe16d7b5efb92ccbe573b6459c4d32b41931aa9e33d6f00f14028da |
| kairo-jinkendo/backend/config_service.py | 5d4f4b75216fe5915874ee9db1776354bdf91f233286f29ea71ff112e2f5555e |
| Kansho/backend/tests/conftest.py | 15c8a860538203e2dd63ee459b187cfb9fb586585e32a4c665ed74646c3f5ed8 |
| Kansho/backend/pytest.ini | cb919d485cff5f19a829ec584bf12019b4d7b6c4eb03e9254d690416b6e38a94 |
Ende dieses Blueprintauftrags. Keine Implementierung und kein weiterer Blueprint werden automatisch gestartet.