npm - @teith/openclaw-runware-provider - Versions diffs - 0.2.7 → 0.2.9 - Mend

@teith/openclaw-runware-provider 0.2.7 → 0.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/README.md +87 -69
package/dist/catalog.d.ts.map +1 -1
package/dist/catalog.js +10 -1
package/dist/catalog.js.map +1 -1
package/dist/index.d.ts.map +1 -1
package/dist/index.js +10 -0
package/dist/index.js.map +1 -1
package/dist/logger.d.ts +33 -0
package/dist/logger.d.ts.map +1 -0
package/dist/logger.js +68 -0
package/dist/logger.js.map +1 -0
package/dist/openclaw-api.d.ts +18 -0
package/dist/openclaw-api.d.ts.map +1 -1
package/dist/provider-discovery.d.ts.map +1 -1
package/dist/provider-discovery.js +15 -2
package/dist/provider-discovery.js.map +1 -1
package/dist/stream-wrap.d.ts +24 -0
package/dist/stream-wrap.d.ts.map +1 -0
package/dist/stream-wrap.js +51 -0
package/dist/stream-wrap.js.map +1 -0
package/package.json +2 -7
package/dist/types.d.ts +0 -2
package/dist/types.d.ts.map +0 -1
package/dist/types.js +0 -2
package/dist/types.js.map +0 -1

package/README.md CHANGED Viewed

@@ -1,102 +1,120 @@
-# @runware/openclaw-provider
+# openclaw-runware-provider
-OpenClaw provider plugin for [Runware](https://runware.ai) — a unified
-OpenAI-compatible endpoint that proxies Claude, GPT, Gemini, Qwen, GLM,
-MiniMax, Kimi, and Gemma models.
+OpenClaw plugin that wires Runware (a unified OpenAI-compatible endpoint
+proxying Claude, GPT, Gemini, Qwen, GLM, MiniMax, Kimi, Gemma, …) into
+OpenClaw as a first-class provider. Published as
+`@teith/openclaw-runware-provider` on npm.
-## Install
+The plugin is the inference contract between the Runware-hosted managed
+OpenClaw service (driven by [openclaw-manager][manager]) and the OpenClaw
+gateway running inside each per-tenant pod. The manager installs this
+package into the pod via `OpenClawInstance.spec.plugins`; the plugin
+discovers the model catalog live from `GET /v1/models` on every gateway
+start.
-```bash
-openclaw plugins install git:github.com/runware/openclaw-provider@v0.1.0
-```
-Set your API key:
+[manager]: https://github.com/runware/openclaw-manager
-```bash
-export RUNWARE_API_KEY=...your key...
-```
+## Configuration
-Register the provider — this fetches the model catalog from Runware and
-writes it into your OpenClaw config:
+The plugin is configured entirely through environment variables — no
+config file, no CLI onboarding step. The managed deployment injects these
+from a per-instance Kubernetes Secret; for local development, export them
+in the shell before launching the gateway.
+| Variable           | Required | Default                       | Purpose                                                          |
+|--------------------|----------|-------------------------------|------------------------------------------------------------------|
+| `RUNWARE_API_KEY`  | yes      | —                             | Bearer token used for `/v1/models` and inference                 |
+| `RUNWARE_BASE_URL` | no       | `https://api.runware.ai/v1`   | Endpoint override (e.g. `https://api.runware.dev/v1` for staging) |
+`RUNWARE_API_KEY` resolution prefers `process.env` over openclaw's
+runtime `resolveProviderApiKey(...)` — env is the source of truth in
+the managed deployment, and openclaw's resolver can return stale values
+from internal credential caches.
+## What the plugin does
+- Registers `runware` as an OpenAI-compatible provider in OpenClaw via
+  the `providerCatalogEntry` manifest hook (the surface openclaw
+  2026.5.x actually calls; mirrors the bundled `ollama` plugin).
+- Fetches `/v1/models` on every catalog resolution. TTL-cached for 5
+  minutes; concurrent requests are deduplicated; the last-known-good
+  catalog is served on transient upstream failures.
+- Injects `extra_body: { reasoning_effort: "high" }` into every chat
+  completions request so reasoning-capable models stream thinking content.
-```bash
-openclaw models auth login --provider runware
-```
+## Logging
-Restart the Gateway if it's running. All Runware models appear in the
-Control UI picker.
+The plugin emits structured log lines prefixed with
+`[runware-openclaw-provider]` on these conditions:
-## Configuration
+| Level | When                                                                 |
+|-------|----------------------------------------------------------------------|
+| warn  | `RUNWARE_API_KEY` missing — empty catalog returned                   |
+| warn  | `/v1/models` upstream failed but a cached catalog is being served    |
+| error | `/v1/models` upstream failed and no cached catalog exists            |
+| error | Any other failure inside `catalog.run` — falls back to empty catalog |
-| Variable | Required | Default | Purpose |
-|---|---|---|---|
-| `RUNWARE_API_KEY` | yes | — | API key, used for `/v1/models` discovery and inference |
-| `RUNWARE_BASE_URL` | no | `https://api.runware.ai/v1` | Override for dev / staging |
+Transport is `console.{error,warn,info,debug}` by default. The openclaw
+gateway CLI captures process console output into the shared gateway log,
+so these lines show up in `openclaw logs --follow`, the Control UI Logs
+tab, and the gateway stderr without any additional wiring. If a future
+openclaw version starts invoking `register(api)` for external plugins,
+the logger is automatically swapped to `api.logger` so lines are tagged
+by the openclaw scoped logger instead.
-Switching environments:
+To follow plugin output in a running managed deployment:
 ```bash
-# dev
-export RUNWARE_BASE_URL=https://api.runware.dev/v1
-export RUNWARE_API_KEY=...dev key...
-openclaw models auth login --provider runware
-# prod (unset override)
-unset RUNWARE_BASE_URL
-export RUNWARE_API_KEY=...prod key...
-openclaw models auth login --provider runware
+openclaw logs --follow | grep runware-openclaw-provider
 ```
-## What this plugin does
-- Registers `runware` as an OpenAI-compatible provider in OpenClaw.
-- Discovers the model catalog live from `GET /v1/models` on registration.
-  TTL-cached for 5 minutes; last-known-good on transient failures.
-- Injects `extra_body: { reasoning_effort: "high" }` into every chat
-  completions request, so reasoning-capable models stream thinking content.
 ## Architecture
-Two-file core:
+```
+src/
+├── index.ts                  plugin entry — register(api) callback
+├── provider-discovery.ts     default export consumed by providerCatalogEntry
+├── models.ts                 shared model-building primitives + env resolution
+├── catalog.ts                TTL-cached /v1/models fetcher with dedup
+└── openclaw-api.ts           local type stubs for the openclaw runtime API
+```
-- `src/index.ts` — plugin entry. Registers the provider, defines the
-  auth flow, and builds the model catalog.
-- `src/catalog.ts` — TTL-cached `GET /v1/models` fetcher with concurrent
-  request deduplication and last-known-good fallback.
+`models.ts` is the single source of truth. Both `index.ts`
+(`register(api)` flow, declared but currently not invoked by openclaw
+2026.5.x for external plugins) and `provider-discovery.ts`
+(`providerCatalogEntry` flow, the one openclaw actually calls) share its
+`resolveApiKey`, `resolveBaseUrl`, `buildProvider`, and
+`buildCatalogRows` helpers — so the picker catalog and the inference
+provider always reflect the same `/v1/models` snapshot.
-OpenClaw API surface is described locally in `src/openclaw-api.ts` —
-the plugin does not import from the `openclaw` package at runtime.
+The plugin does not import from the `openclaw` npm package at runtime;
+the API surface is described locally in `openclaw-api.ts`.
 ## Development
 ```bash
 pnpm install
-pnpm test
+pnpm test         # vitest, 24 tests
 pnpm typecheck
-pnpm build
-```
-Local install for testing:
-```bash
-openclaw plugins install -l /absolute/path/to/this/repo
+pnpm build        # tsc → ./dist
 ```
-Use `-l` to symlink — rebuilds become visible after `pnpm build` and a
-Gateway restart, without reinstalling.
+`dist/` is committed to git and shipped in the npm tarball because
+openclaw installs plugins with `npm install --ignore-scripts` and cannot
+run a build step inside the operator's init container.
 ## Release
 ```bash
-pnpm test && pnpm build
-git add . && git commit -m "Release v0.1.0"
-git tag v0.1.0
+pnpm test && pnpm clean && pnpm build
+# bump version in package.json
+git commit -am "Release vX.Y.Z"
+git tag vX.Y.Z
 git push origin main --tags
+npm publish --access public
 ```
-`dist/` is committed to the repository because OpenClaw installs plugins
-with `npm install --ignore-scripts` and cannot run a build step.
-## License
-MIT
+Bumping the version requires a matching bump of `cfg.plugin_package` in
+[openclaw-manager][manager]/`src/openclaw_manager/config.py` (and the
+chart values) — the manager pins to an exact version so the install is
+reproducible across instances.

package/dist/catalog.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"~~AAeA~~,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,~~CAsBtF~~;AAwBD,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}
1	+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAiBA,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkCtF;AAwBD,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/catalog.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { logger } from "./logger.js";
 const CACHE_TTL_MS = 5 * 60 * 1000;
 const FETCH_TIMEOUT_MS = 5000;
 let cache = null;
@@ -16,8 +17,16 @@ export async function fetchModelIds(baseUrl, apiKey) {
             return ids;
         }
         catch (err) {
-            if (cache)
+            const message = err instanceof Error ? err.message : String(err);
+            if (cache) {
+                logger.warn("upstream /v1/models fetch failed; serving stale catalog", {
+                    baseUrl,
+                    cachedModels: cache.modelIds.length,
+                    error: message,
+                });
                 return cache.modelIds;
+            }
+            logger.error("upstream /v1/models fetch failed and no cached catalog is available", { baseUrl, error: message });
             throw err;
         }
         finally {

package/dist/catalog.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAW9B,IAAI,KAAK,GAAsB,IAAI,CAAC;AACpC,IAAI,QAAQ,GAA6B,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,MAAc;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrD,KAAK,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,KAAK;~~gBAAE~~,OAAO,KAAK,CAAC,QAAQ,CAAC;~~YACjC~~,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc;IAC9D,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC1E,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACpD,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,GAAG,IAAI,CAAC;IACb,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}
1	+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAW9B,IAAI,KAAK,GAAsB,IAAI,CAAC;AACpC,IAAI,QAAQ,GAA6B,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,MAAc;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACrD,KAAK,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,yDAAyD,EAAE;oBACrE,OAAO;oBACP,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;oBACnC,KAAK,EAAE,OAAO;iBACf,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC,QAAQ,CAAC;YACxB,CAAC;YACD,MAAM,CAAC,KAAK,CACV,qEAAqE,EACrE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAC5B,CAAC;YACF,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc;IAC9D,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC1E,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACpD,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,GAAG,IAAI,CAAC;IACb,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"~~AAUA~~,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAC;~~AAIrE~~;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,KAAK,EAAE,~~WAkCZ~~,CAAC;AAEF,eAAe,KAAK,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,KAAK,EAAE,WAyCZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,6 @@
+import { setHostLogger } from "./logger.js";
 import { API_KEY_ENV_VAR, BASE_URL_ENV_VAR, PROVIDER_ID, PROVIDER_LABEL, buildCatalogRows, buildProvider, resolveApiKey, resolveBaseUrl, } from "./models.js";
+import { buildRunwareStreamWrapper } from "./stream-wrap.js";
 const PLUGIN_ID = "runware-openclaw-provider";
 /**
  * Plugin entry that openclaw's plugin loader invokes after `npm install`-ing
@@ -26,6 +28,8 @@ const entry = {
     name: PROVIDER_LABEL,
     description: "Runware — unified OpenAI-compatible access to Claude, GPT, Gemini, Qwen, GLM, MiniMax, Kimi, and Gemma.",
     register(api) {
+        if (api.logger)
+            setHostLogger(api.logger);
         api.registerProvider({
             id: PROVIDER_ID,
             label: PROVIDER_LABEL,
@@ -42,6 +46,12 @@ const entry = {
                     return { provider };
                 },
             },
+            // Strip `temperature` from outbound Runware requests (their text
+            // inference endpoint rejects it with HTTP 400) and prefix raw
+            // upstream errors with "Runware:" so end users see the actual cause
+            // in webchat instead of openclaw's generic "provider rejected the
+            // request schema or tool payload" classifier text.
+            wrapStreamFn: buildRunwareStreamWrapper,
         });
         api.registerModelCatalogProvider({
             provider: PROVIDER_ID,

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;~~AAGrB~~,MAAM,SAAS,GAAG,2BAA2B,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,KAAK,GAAgB;IACzB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,yGAAyG;IAE3G,QAAQ,CAAC,GAAG;QACV,GAAG,CAAC,gBAAgB,CAAC;YACnB,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE,yBAAyB;YACnC,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;YAC5C,IAAI,EAAE,EAAE;YACR,OAAO,EAAE;gBACP,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;oBACjC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;oBAClC,IAAI,CAAC,MAAM;wBAAE,OAAO,IAAI,CAAC;oBACzB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;oBACtE,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtB,CAAC;aACF;~~SACF~~,CAAC,CAAC;QAEH,GAAG,CAAC,4BAA4B,CAAC;YAC/B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;gBACzC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAC;gBACzB,OAAO,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,KAAK,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,SAAS,GAAG,2BAA2B,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,KAAK,GAAgB;IACzB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,yGAAyG;IAE3G,QAAQ,CAAC,GAAG;QACV,IAAI,GAAG,CAAC,MAAM;YAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,GAAG,CAAC,gBAAgB,CAAC;YACnB,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE,yBAAyB;YACnC,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;YAC5C,IAAI,EAAE,EAAE;YACR,OAAO,EAAE;gBACP,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;oBACjC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;oBAClC,IAAI,CAAC,MAAM;wBAAE,OAAO,IAAI,CAAC;oBACzB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;oBACtE,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtB,CAAC;aACF;YACD,iEAAiE;YACjE,8DAA8D;YAC9D,oEAAoE;YACpE,kEAAkE;YAClE,mDAAmD;YACnD,YAAY,EAAE,yBAAyB;SACxC,CAAC,CAAC;QAEH,GAAG,CAAC,4BAA4B,CAAC;YAC/B,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;gBACzC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAC;gBACzB,OAAO,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/logger.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+/**
+ * Plugin-scoped logger with two transports:
+ *
+ * - default: console.error/warn/info/debug. OpenClaw's gateway CLI
+ *   captures process console output and writes it to the shared gateway
+ *   log file alongside its own logger output, so anything we emit here
+ *   surfaces in `openclaw logs --follow` and the Control UI Logs tab
+ *   without any wiring. This is the only path available from the
+ *   `providerCatalogEntry` hook, where we never get a `register(api)` call
+ *   and therefore never see `api.logger`.
+ *
+ * - host: `setHostLogger(api.logger)` swaps console for openclaw's plugin
+ *   logger. Used from the `register(api)` flow when openclaw actually
+ *   invokes it (currently 2026.5.x does not for external plugins, but
+ *   future versions are expected to per the SDK docs).
+ *
+ * Both modes prepend the plugin id so the line is greppable in the shared
+ * gateway log next to log lines from bundled plugins.
+ */
+export interface HostLogger {
+    error: (message: string) => void;
+    warn: (message: string) => void;
+    info: (message: string) => void;
+    debug?: (message: string) => void;
+}
+export declare function setHostLogger(next: HostLogger | null): void;
+export declare const logger: {
+    readonly error: (message: string, meta?: Record<string, unknown>) => void;
+    readonly warn: (message: string, meta?: Record<string, unknown>) => void;
+    readonly info: (message: string, meta?: Record<string, unknown>) => void;
+    readonly debug: (message: string, meta?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE3D;AAeD,eAAO,MAAM,MAAM;8BACF,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;6BAK9C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;6BAK7C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;8BAK5C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;CAKpD,CAAC"}

package/dist/logger.js ADDED Viewed

@@ -0,0 +1,68 @@
+/**
+ * Plugin-scoped logger with two transports:
+ *
+ * - default: console.error/warn/info/debug. OpenClaw's gateway CLI
+ *   captures process console output and writes it to the shared gateway
+ *   log file alongside its own logger output, so anything we emit here
+ *   surfaces in `openclaw logs --follow` and the Control UI Logs tab
+ *   without any wiring. This is the only path available from the
+ *   `providerCatalogEntry` hook, where we never get a `register(api)` call
+ *   and therefore never see `api.logger`.
+ *
+ * - host: `setHostLogger(api.logger)` swaps console for openclaw's plugin
+ *   logger. Used from the `register(api)` flow when openclaw actually
+ *   invokes it (currently 2026.5.x does not for external plugins, but
+ *   future versions are expected to per the SDK docs).
+ *
+ * Both modes prepend the plugin id so the line is greppable in the shared
+ * gateway log next to log lines from bundled plugins.
+ */
+const PREFIX = "[runware-openclaw-provider]";
+let host = null;
+export function setHostLogger(next) {
+    host = next;
+}
+function safeStringify(meta) {
+    try {
+        return JSON.stringify(meta);
+    }
+    catch {
+        return "[unserializable meta]";
+    }
+}
+function format(message, meta) {
+    if (!meta || Object.keys(meta).length === 0)
+        return `${PREFIX} ${message}`;
+    return `${PREFIX} ${message} ${safeStringify(meta)}`;
+}
+export const logger = {
+    error(message, meta) {
+        const line = format(message, meta);
+        if (host)
+            host.error(line);
+        else
+            console.error(line);
+    },
+    warn(message, meta) {
+        const line = format(message, meta);
+        if (host)
+            host.warn(line);
+        else
+            console.warn(line);
+    },
+    info(message, meta) {
+        const line = format(message, meta);
+        if (host)
+            host.info(line);
+        else
+            console.info(line);
+    },
+    debug(message, meta) {
+        const line = format(message, meta);
+        if (host?.debug)
+            host.debug(line);
+        else if (!host)
+            (console.debug ?? console.log).call(console, line);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,GAAG,6BAA6B,CAAC;AAS7C,IAAI,IAAI,GAAsB,IAAI,CAAC;AAEnC,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,IAA6B;IAClD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAAe,EAAE,IAA8B;IAC7D,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAC3E,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,EAAE,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAC7B,IAAI,CAAC,IAAI;YAAE,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;CACO,CAAC"}

package/dist/openclaw-api.d.ts CHANGED Viewed

@@ -5,6 +5,7 @@
  * a downstream consumer of openclaw's TypeScript types. Keeping the surface
  * minimal here also lets us track exactly which hooks we touch.
  */
+import type { HostLogger } from "./logger.js";
 import type { ModelCatalogRow } from "./models.js";
 /**
  * Context passed to plugin hooks (`registerProvider.catalog.run`,
@@ -23,7 +24,24 @@ export interface CatalogContext {
  * actually call. Other methods (registerMemoryEmbeddingProvider, etc) are
  * available on the underlying object — we just don't type them here.
  */
+/**
+ * Params object passed to a wrapped openai-completions StreamFn. Shape is
+ * the openclaw internal one — we type only the fields we touch. Other keys
+ * (messages, model, tools, headers, etc) pass through unchanged.
+ */
+export interface StreamFnParams {
+    temperature?: number;
+    [key: string]: unknown;
+}
+export type StreamFn = (params: StreamFnParams) => Promise<unknown>;
+export interface WrapStreamFnCtx {
+    streamFn?: StreamFn;
+    model?: {
+        id?: string;
+    };
+}
 export interface PluginApi {
+    logger?: HostLogger;
     registerProvider: (spec: unknown) => void;
     registerModelCatalogProvider: (spec: {
         provider: string;

package/dist/openclaw-api.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"openclaw-api.d.ts","sourceRoot":"","sources":["../src/openclaw-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,4BAA4B,EAAE,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,WAAW,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;KACzE,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC"}
1	+ {"version":3,"file":"openclaw-api.d.ts","sourceRoot":"","sources":["../src/openclaw-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,4BAA4B,EAAE,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,WAAW,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;KACzE,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC"}

package/dist/provider-discovery.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"provider-discovery.d.ts","sourceRoot":"","sources":["../src/provider-discovery.ts"],"names":[],"mappings":"~~AAAA~~,OAAO,EAGL,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AAEH,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAYD,iBAAe,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,~~CAUxF~~;AAED,QAAA,MAAM,wBAAwB;;;;;;;;;;CAU7B,CAAC;AAEF,eAAe,wBAAwB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
1	+ {"version":3,"file":"provider-discovery.d.ts","sourceRoot":"","sources":["../src/provider-discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AAEH,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAYD,iBAAe,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,CA4BxF;AAED,QAAA,MAAM,wBAAwB;;;;;;;;;;CAU7B,CAAC;AAEF,eAAe,wBAAwB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/provider-discovery.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { logger } from "./logger.js";
 import { API_KEY_ENV_VAR, BASE_URL_ENV_VAR, DEFAULT_BASE_URL, PROVIDER_ID, PROVIDER_LABEL, buildProvider, resolveApiKey, resolveBaseUrl, } from "./models.js";
 function emptyProvider(baseUrl) {
     return {
@@ -16,9 +17,21 @@ async function runwareCatalogRun(ctx) {
     // an empty provider shape so openclaw treats the catalog as "known but
     // currently unpopulated" rather than crashing. The next invocation will
     // re-resolve and fill in models once the key is present.
-    if (!apiKey)
+    if (!apiKey) {
+        logger.warn(`${API_KEY_ENV_VAR} is not set — returning an empty Runware catalog`, { baseUrl });
         return { provider: emptyProvider(baseUrl) };
-    return { provider: await buildProvider(apiKey, baseUrl) };
+    }
+    try {
+        return { provider: await buildProvider(apiKey, baseUrl) };
+    }
+    catch (err) {
+        // openclaw silently swallows rejections from catalog.run, which is why
+        // upstream failures were previously invisible. Log explicitly via the
+        // gateway CLI's console capture and degrade to an empty catalog so the
+        // gateway keeps booting — the next invocation will retry.
+        logger.error("failed to build Runware provider catalog — returning empty fallback", { baseUrl, error: err instanceof Error ? err.message : String(err) });
+        return { provider: emptyProvider(baseUrl) };
+    }
 }
 const runwareProviderDiscovery = {
     id: PROVIDER_ID,

package/dist/provider-discovery.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"provider-discovery.js","sourceRoot":"","sources":["../src/provider-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAwBrB,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO;QACL,OAAO;QACP,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,oBAAoB;QACzB,cAAc,EAAE,GAAG;QACnB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAiB;IAChD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,wEAAwE;IACxE,yDAAyD;IACzD,IAAI,CAAC,MAAM;~~QAAE~~,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;~~IACzD~~,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;~~AAC5D~~,CAAC;AAED,MAAM,wBAAwB,GAAG;IAC/B,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,yBAAyB;IACnC,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC5C,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP,KAAK,EAAE,MAAe;QACtB,GAAG,EAAE,iBAAiB;KACvB;CACF,CAAC;AAEF,eAAe,wBAAwB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
1	+ {"version":3,"file":"provider-discovery.js","sourceRoot":"","sources":["../src/provider-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAwBrB,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO;QACL,OAAO;QACP,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,oBAAoB;QACzB,cAAc,EAAE,GAAG;QACnB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAiB;IAChD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,wEAAwE;IACxE,yDAAyD;IACzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CACT,GAAG,eAAe,kDAAkD,EACpE,EAAE,OAAO,EAAE,CACZ,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uEAAuE;QACvE,sEAAsE;QACtE,uEAAuE;QACvE,0DAA0D;QAC1D,MAAM,CAAC,KAAK,CACV,qEAAqE,EACrE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrE,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,wBAAwB,GAAG;IAC/B,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,yBAAyB;IACnC,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC5C,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP,KAAK,EAAE,MAAe;QACtB,GAAG,EAAE,iBAAiB;KACvB;CACF,CAAC;AAEF,eAAe,wBAAwB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/stream-wrap.d.ts ADDED Viewed

@@ -0,0 +1,24 @@
+import type { StreamFn, WrapStreamFnCtx } from "./openclaw-api.js";
+/**
+ * StreamFn wrapper for Runware. Two responsibilities:
+ *
+ *  1. Strip outgoing params Runware's text-inference endpoint rejects.
+ *     Runware /v1/chat/completions returns HTTP 400 with
+ *     "Unsupported use of 'settings.temperature' parameter. This
+ *     parameter is not supported for text inference" if the request body
+ *     contains a top-level `temperature`. Openclaw's bundled pi-ai
+ *     openai-completions builder hardcodes sending temperature whenever a
+ *     numeric value is configured (see openclaw#32496 — only `temperature`
+ *     and `maxTokens` are forwarded out of extraParams, and there is no
+ *     documented `compat` flag to skip it). Deleting the key on the way
+ *     out is the only surface available to a plugin.
+ *
+ *  2. Translate cryptic upstream errors into a Runware-prefixed message
+ *     that openclaw's `surface_error` path will show to the end user in
+ *     webchat / TUI verbatim. Without this, every Runware 4xx collapses
+ *     into openclaw's generic "provider rejected the request schema or
+ *     tool payload" classifier and the actual cause is buried in
+ *     diagnostics-only logs.
+ */
+export declare function buildRunwareStreamWrapper(ctx: WrapStreamFnCtx): StreamFn | undefined;
+//# sourceMappingURL=stream-wrap.d.ts.map

package/dist/stream-wrap.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"stream-wrap.d.ts","sourceRoot":"","sources":["../src/stream-wrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,eAAe,GACnB,QAAQ,GAAG,SAAS,CA2BtB"}

package/dist/stream-wrap.js ADDED Viewed

@@ -0,0 +1,51 @@
+import { logger } from "./logger.js";
+/**
+ * StreamFn wrapper for Runware. Two responsibilities:
+ *
+ *  1. Strip outgoing params Runware's text-inference endpoint rejects.
+ *     Runware /v1/chat/completions returns HTTP 400 with
+ *     "Unsupported use of 'settings.temperature' parameter. This
+ *     parameter is not supported for text inference" if the request body
+ *     contains a top-level `temperature`. Openclaw's bundled pi-ai
+ *     openai-completions builder hardcodes sending temperature whenever a
+ *     numeric value is configured (see openclaw#32496 — only `temperature`
+ *     and `maxTokens` are forwarded out of extraParams, and there is no
+ *     documented `compat` flag to skip it). Deleting the key on the way
+ *     out is the only surface available to a plugin.
+ *
+ *  2. Translate cryptic upstream errors into a Runware-prefixed message
+ *     that openclaw's `surface_error` path will show to the end user in
+ *     webchat / TUI verbatim. Without this, every Runware 4xx collapses
+ *     into openclaw's generic "provider rejected the request schema or
+ *     tool payload" classifier and the actual cause is buried in
+ *     diagnostics-only logs.
+ */
+export function buildRunwareStreamWrapper(ctx) {
+    if (!ctx.streamFn)
+        return undefined;
+    const inner = ctx.streamFn;
+    const modelId = ctx.model?.id;
+    return async (params) => {
+        if ("temperature" in params) {
+            logger.debug("stripping unsupported `temperature` param for Runware request", {
+                model: modelId,
+            });
+            delete params.temperature;
+        }
+        try {
+            return await inner(params);
+        }
+        catch (err) {
+            const raw = err instanceof Error ? err.message : String(err);
+            logger.error("Runware inference call failed", {
+                model: modelId,
+                error: raw,
+            });
+            // Re-throw with a "Runware:" prefix so the gateway's surface_error
+            // path shows the real upstream message to the user instead of the
+            // generic classifier text.
+            throw new Error(`Runware: ${raw}`);
+        }
+    };
+}
+//# sourceMappingURL=stream-wrap.js.map

package/dist/stream-wrap.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"stream-wrap.js","sourceRoot":"","sources":["../src/stream-wrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAoB;IAEpB,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;IAE9B,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,aAAa,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,+DAA+D,EAAE;gBAC5E,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,WAAW,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBAC5C,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;YACH,mEAAmE;YACnE,kEAAkE;YAClE,2BAA2B;YAC3B,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@teith/openclaw-runware-provider",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "OpenClaw provider plugin for Runware — unified OpenAI-compatible access to Claude, GPT, Gemini, Qwen, GLM, MiniMax, Kimi, and Gemma.",
   "license": "MIT",
   "type": "module",
@@ -17,8 +17,7 @@
   "files": [
     "dist",
     "openclaw.plugin.json",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -38,10 +37,6 @@
       "runware"
     ]
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/runware/openclaw-provider.git"
-  },
   "keywords": [
     "openclaw",
     "openclaw-plugin",

package/dist/types.d.ts DELETED Viewed

	@@ -1,2 +0,0 @@
1	- export type { ModelCatalogRow, ProviderShape, ModelEntry } from "./models.js";
2	- //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map DELETED Viewed

	@@ -1 +0,0 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.js DELETED Viewed

	@@ -1,2 +0,0 @@
1	- export {};
2	- //# sourceMappingURL=types.js.map

package/dist/types.js.map DELETED Viewed

	@@ -1 +0,0 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}