Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

docs/reference/openclaw-ai.md

@@ -0,0 +1,71 @@
+---
+summary: "The @openclaw/ai npm package: reusable model transports, isolated runtimes, and host policy ports"
+title: "@openclaw/ai package"
+read_when:
+  - You want to reuse OpenClaw's model transports in another application
+  - You are changing packages/ai or the AI transport host ports
+  - You are reviewing what the openclaw release publishes to npm besides the root package
+---
+
+`@openclaw/ai` is the publishable library form of OpenClaw's model execution
+layer: provider-neutral message/tool/stream contracts, validation, diagnostics,
+event streams, an isolated runtime registry, and lazy adapters for the eight
+built-in API families (Anthropic Messages, OpenAI Completions, OpenAI
+Responses, Azure OpenAI Responses, ChatGPT/Codex Responses, Google Generative
+AI, Google Vertex, Mistral Conversations).
+
+It publishes alongside the root `openclaw` package on every release, pinned to
+the same version, with its own `npm-shrinkwrap.json` so its transitive
+dependency tree is locked at install time. Installing `openclaw` installs the
+matching `@openclaw/ai` automatically; library consumers can depend on it
+directly without any OpenClaw application code.
+
+## Quick start
+
+```js
+import { createLlmRuntime } from "@openclaw/ai";
+import { registerBuiltInApiProviders } from "@openclaw/ai/providers";
+
+const runtime = createLlmRuntime();
+registerBuiltInApiProviders(runtime.registry);
+
+const stream = runtime.streamSimple(model, { messages }, { apiKey });
+for await (const event of stream) {
+  if (event.type === "text_delta") process.stdout.write(event.delta);
+}
+const result = await stream.result();
+```
+
+A runnable version lives in the repository at `examples/ai-chat`.
+
+## Design contract
+
+- **Instance-scoped by default.** Importing the package registers nothing
+  globally. `createApiRegistry()` / `createLlmRuntime()` return isolated
+  instances; `registerBuiltInApiProviders(registry)` opts one registry into the
+  built-in transports. Provider SDK modules load lazily on first use.
+- **Host policy is injected, not bundled.** Request fetch guarding (for
+  example SSRF policy), secret redaction of tool-result replay text, OpenAI
+  strict-tool defaults, and diagnostics logging are `AiTransportHost` ports
+  configured with `configureAiTransportHost`. The library defaults are inert;
+  OpenClaw installs its real implementations in its stream facade.
+- **One event-stream identity.** `@openclaw/ai/event-stream` is the canonical
+  `EventStream` constructor shared by OpenClaw core, agent-core, and external
+  consumers.
+- **`internal/*` subpaths are not API.** They exist for the OpenClaw
+  application itself and carry no semver guarantee.
+- Provider ids, credentials, model catalogs, retries, and failover remain
+  application concerns. OpenClaw layers those around this package; a library
+  consumer supplies a `Model` object and options directly.
+
+## Subpath exports
+
+| Subpath          | Contents                                                                       |
+| ---------------- | ------------------------------------------------------------------------------ |
+| `.`              | Contracts, `createApiRegistry`, `createLlmRuntime`, `configureAiTransportHost` |
+| `./providers`    | `registerBuiltInApiProviders`, `resetApiProviders`                             |
+| `./types`        | Model/message/tool/stream types                                                |
+| `./validation`   | Tool argument validation                                                       |
+| `./diagnostics`  | Diagnostics contracts                                                          |
+| `./event-stream` | Shared `EventStream` implementation                                            |
+| `./internal/*`   | OpenClaw-internal, no semver guarantee                                         |