mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-09 15:59:30 +00:00
062f88e3e3
* refactor: extract reusable AI runtime package * refactor: complete AI provider relocation * refactor: keep llm core internal * refactor(ai): make @openclaw/ai self-contained with host policy ports Move pure transport helpers (tool projections, strict-schema normalization, prompt-cache boundary, stream guards, anthropic/openai compat, request activity) from src into packages/ai; move utf16-slice into normalization-core. Inject host policy (guarded fetch, redaction, strict-tool defaults, diagnostics logging) through AiTransportHost with inert library defaults installed by src/llm/stream.ts. Narrow the public barrel to instance-scoped createApiRegistry/createLlmRuntime; the process-default runtime moves behind internal/ and registerBuiltInApiProviders takes an explicit registry. Delete the src/llm/api-registry re-export facade. * fix(ai): teach node, jiti, and vite resolvers the @openclaw/ai and utf16-slice subpaths The workspace alias tables in root-alias.cjs, plugin-sdk-native-resolver, sdk-alias, the shared vitest config, and the Control UI vite config only knew @openclaw/llm-core; Node-side plugin loading resolved @openclaw/ai through the pnpm symlink to the unbuilt dist (checks-node-compact CI failures), and the Control UI build broke on the new normalization-core/utf16-slice subpath. * chore(ui): drop leftover service-worker debug logging * build(release): ship @openclaw/ai with its own shrinkwrap and honest dependency set packages/ai declares only its six real runtime deps (kysely, chalk, json5, tslog, zod, fs-safe, and proxyline were never imported); orphaned root deps removed. generate-npm-shrinkwrap now treats publishable packages/* like publishable plugins so the AI tarball pins its transitive tree even though workspace deps are omitted from the root shrinkwrap. knip learns the package entry points; the tsdown dts neverBundle option moves to its documented deps.dts home; the README documents the no-semver internal/* contract and host ports. * docs(ai): add minimal external-consumer example app examples/ai-chat consumes only the public @openclaw/ai surface (built dist via the workspace link): isolated runtime, built-in provider registration, one streamed completion. Supports Anthropic/OpenAI via env keys and a keyless local Ollama target; live-verified against Ollama. * docs(ai): document the @openclaw/ai package and workspace shrinkwrap boundary * chore(check): include examples/ in duplicate-scan targets * fix: emit normalization package subpaths * fix: complete AI package boundary artifacts * fix: align AI package boundary contracts * fix(ci): stabilize package release contracts * test: align documentation contract checks * test: keep cron docs guard aligned * test: align restored docs contract guards * test: follow upstream docs contracts * docs: drop superseded talk wording
29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
# @openclaw/ai example: minimal chat completion
|
|
|
|
Smallest possible consumer of the published `@openclaw/ai` package: creates an
|
|
isolated runtime, registers the built-in API providers, and streams one
|
|
completion. No OpenClaw application code is involved — inside this repo the
|
|
workspace link resolves to the package's built `dist`, the same artifact npm
|
|
consumers install, so `pnpm build` must have run first.
|
|
|
|
```sh
|
|
ANTHROPIC_API_KEY=sk-ant-... node index.mjs "Say hello"
|
|
OPENAI_API_KEY=sk-... node index.mjs --provider openai "Say hello"
|
|
# keyless, against a local Ollama server (OLLAMA_MODEL overrides the model id)
|
|
node index.mjs --provider ollama "Say hello"
|
|
```
|
|
|
|
Text deltas stream to stdout; stop reason and token usage go to stderr.
|
|
|
|
Notes for library consumers:
|
|
|
|
- `createLlmRuntime()` gives you an isolated registry; nothing is registered
|
|
globally by importing the package.
|
|
- `registerBuiltInApiProviders(runtime.registry)` opts into the eight built-in
|
|
transports (Anthropic, OpenAI Completions/Responses, Azure OpenAI, ChatGPT
|
|
Responses, Google, Vertex, Mistral). Provider SDK modules load lazily on
|
|
first use.
|
|
- Host policy (custom fetch, secret redaction, strict-tool defaults, logging)
|
|
is injectable via `configureAiTransportHost`; the defaults are inert.
|
|
- Full TypeScript types ship with the package; this example uses plain ESM so
|
|
it runs with bare `node`.
|