@openclaw/liquid-ai-provider 0.0.0-stage → 2026.11.5-beta.1

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# OpenClaw Liquid AI Provider
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Native Liquid AI provider for the `d1` and `d1-ultra` Decision models.
+
+This is an unpublished plugin candidate. Use a development checkout containing
+the Decision V2 contract. See <https://docs.openclaw.ai/providers/liquid-ai> for
+source-checkout setup, credentials, model selection, and supported inputs.

package/assets/activity.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <path fill="currentColor" d="M50 7C38 24 22 40 22 59a28 28 0 0 0 56 0C78 40 62 24 50 7Zm0 72a20 20 0 0 1-20-20c0-12 10-24 20-37 10 13 20 25 20 37a20 20 0 0 1-20 20Z"/>
+  <path fill="currentColor" d="M46 38h8v13h11v8H54v13h-8V59H35v-8h11V38Z"/>
+</svg>

package/dist/.source-module-urls/605ee6ba9f7f64cc9a2cb1f0022e16ab91236fa3a81513ac73855349ee5bc039.json

@@ -0,0 +1 @@
+{"version":3,"entries":[{"output":"decision-provider.js","source":"extensions/liquid-ai/decision-provider.ts"},{"output":"index.js","source":"extensions/liquid-ai/index.ts"}],"chunks":[{"output":"decision-provider.js","sha256":"43b32dcadf7ee42ff05ff26bb6128f829a8e7b18eaecc881a2b7fc4b1d4eb0b0","facadeSource":"extensions/liquid-ai/decision-provider.ts","sources":["extensions/liquid-ai/decision-provider.ts"]},{"output":"index.js","sha256":"63d25af989cc6aa25214a1013f8023a909681d6d86f177803beecb4e7fb7f56d","facadeSource":"extensions/liquid-ai/index.ts","sources":["extensions/liquid-ai/index.ts"]}],"unrenderedSources":[]}

package/dist/decision-provider.js

@@ -0,0 +1,161 @@
+import { resolveAgentConfig } from "openclaw/plugin-sdk/agent-scope-runtime";
+import { decodeSystemOneResponse, encodeSystemOneQuestions, validateDecisionBatchV2, validateDecisionResultV2 } from "openclaw/plugin-sdk/decisions";
+import { fetchWithProviderHttpGuard, readProviderJsonResponse, resolveProviderHttpRequestConfig, resolveProviderTransportSsrFPolicy, sanitizeConfiguredModelProviderRequest } from "openclaw/plugin-sdk/provider-http";
+// extensions/liquid-ai/decision-provider.ts
+const BASE_URL = "https://api.liquid.ai/decisions/v1";
+const MAX_REQUEST_BYTES = 45e5;
+function hasUnsupportedParams(context) {
+	const { config, agentId, model } = context;
+	const agent = agentId ? resolveAgentConfig(config, agentId) : void 0;
+	const modelRef = `liquid-ai/${model.id}`;
+	return [
+		config.models?.providers?.["liquid-ai"]?.params,
+		model.params,
+		config.agents?.defaults?.params,
+		config.agents?.defaults?.models?.[modelRef]?.params,
+		agent?.models?.[modelRef]?.params,
+		agent?.params
+	].some((params) => Object.values(params ?? {}).some((value) => value !== void 0));
+}
+function supportsBatch(batch) {
+	if (!validateDecisionBatchV2(batch) || batch.state.type === "list") return false;
+	if (batch.state.type === "json" && (batch.state.value === null || typeof batch.state.value !== "string" && typeof batch.state.value !== "object")) return false;
+	return Object.values(batch.questions).every((question) => {
+		if (question.type === "boolean") return question.instructions != null || Object.values(question.criteria ?? {}).some((value) => value != null);
+		return question.type === "choice" || question.type === "score";
+	});
+}
+function buildLiquidDecisionProvider(deps) {
+	return {
+		id: "liquid-ai",
+		contractVersion: 2,
+		async evaluate(batch, context) {
+			context.signal.throwIfAborted();
+			if (!["d1", "d1-ultra"].includes(context.model.id) || context.reasoning !== void 0 && context.reasoning !== "auto" || hasUnsupportedParams(context) || !supportsBatch(batch)) return {
+				status: "unavailable",
+				reason: "unsupported-input"
+			};
+			if (!context.auth.apiKey && !context.model.headers) return {
+				status: "unavailable",
+				reason: "credentials-unavailable"
+			};
+			const body = JSON.stringify({
+				model: context.model.id,
+				state: batch.state.type === "text" ? batch.state.text : batch.state.type === "json" ? batch.state.value : batch.state.type === "image" ? batch.state.text ?? "" : void 0,
+				...batch.state.type === "image" ? { images: [batch.state.dataUri] } : {},
+				questions: encodeSystemOneQuestions(batch)
+			});
+			if (Buffer.byteLength(body) >= MAX_REQUEST_BYTES) return {
+				status: "unavailable",
+				reason: "unsupported-input"
+			};
+			let release;
+			let admissionError;
+			const assertActive = () => {
+				context.signal.throwIfAborted();
+				let admitted;
+				try {
+					admitted = context.isAdmissible();
+				} catch (error) {
+					admissionError = { error };
+					throw error;
+				}
+				if (!admitted || performance.now() >= context.deadlineMonotonicMs) throw new Error("Liquid Decision is no longer admitted.");
+			};
+			try {
+				assertActive();
+				if (batch.state.type === "image") {
+					const metadata = await deps.getImageMetadata(Buffer.from(batch.state.dataUri.split(",", 2)[1], "base64"));
+					assertActive();
+					if (!metadata || metadata.width <= 0 || metadata.height <= 0 || Math.max(metadata.width, metadata.height) > 100 * Math.min(metadata.width, metadata.height) || Math.ceil(metadata.width / 32) * Math.ceil(metadata.height / 32) > 1e4) return {
+						status: "unavailable",
+						reason: "unsupported-input"
+					};
+				}
+				const configured = context.config.models?.providers?.["liquid-ai"];
+				const configuredRequest = configured?.request;
+				const request = sanitizeConfiguredModelProviderRequest(configuredRequest ? {
+					proxy: configuredRequest.proxy,
+					tls: configuredRequest.tls,
+					allowPrivateNetwork: configuredRequest.allowPrivateNetwork
+				} : void 0);
+				const requestConfig = resolveProviderHttpRequestConfig({
+					provider: "liquid-ai",
+					capability: "llm",
+					transport: "http",
+					baseUrl: context.model.baseUrl ?? configured?.baseUrl ?? BASE_URL,
+					defaultBaseUrl: BASE_URL,
+					defaultHeaders: {
+						"Content-Type": "application/json",
+						...context.auth.apiKey && (!configuredRequest?.auth || configuredRequest.auth.mode === "provider-default") ? { Authorization: `Bearer ${context.auth.apiKey}` } : {}
+					},
+					headers: context.model.headers,
+					request
+				});
+				const url = requestConfig.baseUrl.replace(/\/+$/u, "") + "/systemone";
+				assertActive();
+				const guarded = await fetchWithProviderHttpGuard({
+					url,
+					init: {
+						method: "POST",
+						headers: requestConfig.headers,
+						body
+					},
+					signal: context.signal,
+					timeoutMs: context.deadlineMonotonicMs - performance.now(),
+					beforeRequest: assertActive,
+					policy: resolveProviderTransportSsrFPolicy({
+						baseUrl: requestConfig.baseUrl,
+						url,
+						allowPrivateNetwork: requestConfig.allowPrivateNetwork,
+						trustConfiguredBaseUrlOrigin: configuredRequest?.allowPrivateNetwork !== false
+					}),
+					dispatcherPolicy: requestConfig.dispatcherPolicy,
+					auditContext: "liquid-ai-decisions"
+				});
+				release = guarded.release;
+				const response = guarded.response;
+				if (!response.ok) return {
+					status: "unavailable",
+					reason: response.status === 401 || response.status === 403 ? "authentication" : response.status === 429 ? "rate-limited" : [
+						400,
+						413,
+						422
+					].includes(response.status) ? "unsupported-input" : "transport"
+				};
+				let value;
+				try {
+					value = await readProviderJsonResponse(response, "Liquid decisions", {
+						maxBytes: 1048576,
+						timeoutMs: Math.max(1, context.deadlineMonotonicMs - performance.now())
+					});
+				} catch {
+					context.signal.throwIfAborted();
+					return {
+						status: "unavailable",
+						reason: "invalid-response"
+					};
+				}
+				assertActive();
+				const result = decodeSystemOneResponse(batch, value);
+				return validateDecisionResultV2(batch, result, context.model.inference?.decision) && result.usage?.outputTokens === 0 ? {
+					status: "ok",
+					result
+				} : {
+					status: "unavailable",
+					reason: "invalid-response"
+				};
+			} catch {
+				context.signal.throwIfAborted();
+				if (admissionError) throw admissionError.error;
+				return {
+					status: "unavailable",
+					reason: "transport"
+				};
+			} finally {
+				await release?.();
+			}
+		}
+	};
+}
+export { buildLiquidDecisionProvider };

package/dist/index.js

@@ -0,0 +1,28 @@
+import { buildLiquidDecisionProvider } from "./decision-provider.js";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key";
+// extensions/liquid-ai/index.ts
+var liquid_ai_default = definePluginEntry({
+	id: "liquid-ai",
+	name: "Liquid AI Provider",
+	description: "Liquid AI native Decision provider",
+	register(api) {
+		api.registerProvider({
+			id: "liquid-ai",
+			label: "Liquid AI",
+			docsPath: "/providers/liquid-ai",
+			envVars: ["LIQUIDAI_API_KEY"],
+			auth: [createProviderApiKeyAuthMethod({
+				providerId: "liquid-ai",
+				methodId: "api-key",
+				label: "Liquid AI API key",
+				optionKey: "liquidAiApiKey",
+				flagName: "--liquid-ai-api-key",
+				envVar: "LIQUIDAI_API_KEY",
+				promptMessage: "Enter Liquid AI API key"
+			})]
+		});
+		api.registerDecisionProvider(buildLiquidDecisionProvider({ getImageMetadata: (buffer) => api.runtime.media.getImageMetadata(buffer) }));
+	}
+});
+export { liquid_ai_default as default };

package/openclaw.plugin.json

@@ -0,0 +1,94 @@
+{
+  "id": "liquid-ai",
+  "categories": ["models"],
+  "activation": { "onStartup": false },
+  "enabledByDefault": true,
+  "providers": ["liquid-ai"],
+  "providerEndpoints": [
+    { "endpointClass": "liquid-ai-native", "hosts": ["api.liquid.ai"] }
+  ],
+  "providerRequest": { "providers": { "liquid-ai": { "family": "liquid-ai" } } },
+  "modelCatalog": {
+    "providers": {
+      "liquid-ai": {
+        "baseUrl": "https://api.liquid.ai/decisions/v1",
+        "models": [
+          {
+            "id": "d1",
+            "name": "Liquid AI d1",
+            "input": ["text", "image"],
+            "inference": {
+              "chat": false,
+              "decision": {
+                "protocol": "liquid-ai-systemone",
+                "input": ["text", "image"],
+                "questions": {
+                  "boolean": { "probabilities": "boolean", "abstention": false },
+                  "choice": { "probabilities": "categorical", "abstention": false, "minOptions": 2 },
+                  "score": { "probabilities": "categorical", "abstention": false, "minOptions": 2 }
+                },
+                "confidence": "provider-specific",
+                "reasoning": { "modes": ["auto"] },
+                "limits": {
+                  "image": {
+                    "maxBytes": 4194304,
+                    "mimeTypes": ["image/png", "image/jpeg", "image/webp"],
+                    "remoteUrls": false
+                  }
+                },
+                "billing": { "unit": "tokens", "source": "provider-docs", "usdPerMillion": { "output": 0 } }
+              }
+            }
+          },
+          {
+            "id": "d1-ultra",
+            "name": "Liquid AI d1 Ultra",
+            "input": ["text", "image"],
+            "inference": {
+              "chat": false,
+              "decision": {
+                "protocol": "liquid-ai-systemone",
+                "input": ["text", "image"],
+                "questions": {
+                  "boolean": { "probabilities": "boolean", "abstention": false },
+                  "choice": { "probabilities": "categorical", "abstention": false, "minOptions": 2 },
+                  "score": { "probabilities": "categorical", "abstention": false, "minOptions": 2 }
+                },
+                "confidence": "provider-specific",
+                "reasoning": { "modes": ["auto"] },
+                "limits": {
+                  "image": {
+                    "maxBytes": 4194304,
+                    "mimeTypes": ["image/png", "image/jpeg", "image/webp"],
+                    "remoteUrls": false
+                  }
+                },
+                "billing": { "unit": "tokens", "source": "provider-docs", "usdPerMillion": { "input": 0.042, "output": 0 } }
+              }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "setup": { "providers": [{ "id": "liquid-ai", "envVars": ["LIQUIDAI_API_KEY"] }] },
+  "providerAuthChoices": [
+    {
+      "provider": "liquid-ai",
+      "method": "api-key",
+      "choiceId": "liquid-ai-api-key",
+      "appGuidedSecret": true,
+      "credentialOnly": true,
+      "choiceLabel": "Liquid AI API key",
+      "groupId": "liquid-ai",
+      "groupLabel": "Liquid AI",
+      "groupHint": "Native Decision models",
+      "optionKey": "liquidAiApiKey",
+      "cliFlag": "--liquid-ai-api-key",
+      "cliOption": "--liquid-ai-api-key <key>",
+      "cliDescription": "Liquid AI API key"
+    }
+  ],
+  "contracts": { "decisionProviders": ["liquid-ai"] },
+  "configSchema": { "type": "object", "additionalProperties": false, "properties": {} }
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@openclaw/liquid-ai-provider",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2026.11.5-beta.1",
+  "description": "OpenClaw Liquid AI provider plugin.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw"
+  },
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/liquid-ai-provider",
+      "npmSpec": "@openclaw/liquid-ai-provider",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.10.6"
+    },
+    "compat": {
+      "pluginApi": ">=2026.11.5-beta.1"
+    },
+    "build": {
+      "openclawVersion": "2026.11.5-beta.1",
+      "bundledDist": false
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist/**",
+    "openclaw.plugin.json",
+    "README.md",
+    "assets/icon.png",
+    "assets/activity.svg"
+  ],
+  "peerDependencies": {
+    "openclaw": ">=2026.11.5-beta.1"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "bundledDependencies": []
+}