@openclaw/meta-provider 2026.7.2-beta.5 → 2026.8.1-beta.2

package/README.md

@@ -1,20 +1,49 @@
 # Meta provider
 
-Bundled OpenClaw provider plugin for the **Meta API** — an OpenAI-compatible
+Official OpenClaw provider plugin for the **Meta API** — an OpenAI-compatible
 **Responses API** endpoint (`POST /v1/responses`).
 
 - **Base URL:** `https://api.meta.ai/v1`
 - **Auth:** `Authorization: Bearer $MODEL_API_KEY`
-- **Model:** `muse-spark-1.1` (reasoning model)
+- **Models:** `muse-spark-1.1`, `muse-spark-1.2`, `muse-spark-1.2-contributor` (reasoning models)
   - Context window: 1,048,576 tokens (input + output share the budget)
-  - Maximum output: 131,072 tokens
-  - Reasoning effort: `minimal | low | medium | high | xhigh` (default: `high`)
+  - Reasoning effort: `minimal | low | medium | high | xhigh` (OpenClaw default: `high`)
   - Vision: image input in `user` messages
   - Tool calling + streaming
   - Stateless encrypted reasoning replay (`store: false`)
 
+> [!WARNING]
+> Meta's [pricing documentation](https://dev.meta.ai/docs/pricing-rate-limits/) and
+> [Terms of Service](https://dev.meta.ai/legal/terms-of-service) distinguish Standard
+> Services from Contributor/Discounted Services:
+>
+> - Standard Services are the default. Meta says prompts and completions submitted to
+>   Standard Services are not used to train Meta models.
+> - By using Contributor/Discounted Services, you permit Meta to use Content submitted
+>   to and generated by those services as described in the Terms. Under the Terms, use
+>   of Discounted Services acknowledges that permission. You must not submit sensitive,
+>   confidential, or personal information to the Discounted Services.
+>
+> Meta's [Geographic Use Policy](https://dev.meta.ai/legal/geographic-use-policy)
+> governs availability. It limits API access in some jurisdictions and adds end-user
+> deployment restrictions for products built with the Contributor/Discounted model;
+> those additional restrictions do not apply to your own use or products built with
+> Standard Services.
+
+Meta's [model catalog](https://dev.meta.ai/docs/models) lists text, image, video,
+audio, and PDF input for these models. OpenClaw's model catalog directly represents
+text and image input only; the other upstream modalities are not model-manifest input
+values. Meta does not publish an exact maximum-output figure for these catalog rows.
+
 ## Usage
 
+Install the plugin and restart Gateway:
+
+```bash
+openclaw plugins install @openclaw/meta-provider
+openclaw gateway restart
+```
+
 Set the API key and select the model:
 
 ```bash
@@ -37,7 +66,10 @@ Or run onboarding and choose **Meta**.
 ## Thinking / reasoning
 
 `--thinking <level>` and `/think <level>` map to Responses API `reasoning.effort`.
-Default thinking level is `high`. `off` maps to `minimal` because Muse Spark does
+OpenClaw defaults to `high`. Meta's
+[reasoning documentation](https://dev.meta.ai/docs/reasoning/) says that an
+omitted effort uses a model-determined level, so `high` is an OpenClaw policy rather
+than Meta's omitted-parameter default. `off` maps to `minimal` because Muse Spark does
 not accept `none`.
 
 ## Docs
@@ -51,4 +83,4 @@ export MODEL_API_KEY=<key>
 pnpm test:live -- extensions/meta/meta.live.test.ts
 ```
 
-Live tests call `muse-spark-1.1` on `/v1/responses`.
+The live suite exercises enabled Meta cases against `POST /v1/responses`.

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as META_MODEL_CATALOG, r as buildMetaCatalogModels, t as META_BASE_URL } from "./models-BHj_98-y.js";
+import { META_BASE_URL, META_MODEL_CATALOG, buildMetaCatalogModels } from "./models.js";
 import { META_DEFAULT_MODEL_REF, applyMetaConfig } from "./onboard.js";
 import { buildMetaProvider } from "./provider-catalog.js";
 export { META_BASE_URL, META_DEFAULT_MODEL_REF, META_MODEL_CATALOG, applyMetaConfig, buildMetaCatalogModels, buildMetaProvider };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { i as openclaw_plugin_default } from "./models-BHj_98-y.js";
+import { t as openclaw_plugin_default } from "./openclaw.plugin-Drxs3Dwe.js";
 import { applyMetaConfig } from "./onboard.js";
 import { buildMetaProvider } from "./provider-catalog.js";
 import { wrapMetaProviderStream } from "./stream.js";
@@ -8,7 +8,7 @@ import { buildProviderReplayFamilyHooks } from "openclaw/plugin-sdk/provider-mod
 var meta_default = defineSingleProviderPluginEntry({
 	id: "meta",
 	name: "Meta Provider",
-	description: "Bundled Meta provider plugin",
+	description: "Meta provider plugin",
 	manifest: openclaw_plugin_default,
 	provider: {
 		label: "Meta",
@@ -24,8 +24,9 @@ var meta_default = defineSingleProviderPluginEntry({
 			liveModelDiscovery: true
 		},
 		...buildProviderReplayFamilyHooks({ family: "openai-compatible" }),
+		wrapSimpleCompletionStreamFn: wrapMetaProviderStream,
 		wrapStreamFn: wrapMetaProviderStream,
-		resolveThinkingProfile: ({ modelId }) => resolveMetaThinkingProfile(modelId)
+		resolveThinkingProfile: resolveMetaThinkingProfile
 	}
 });
 //#endregion

package/dist/models.js

@@ -1,2 +1,20 @@
-import { n as META_MODEL_CATALOG, r as buildMetaCatalogModels, t as META_BASE_URL } from "./models-BHj_98-y.js";
+import { t as openclaw_plugin_default } from "./openclaw.plugin-Drxs3Dwe.js";
+import { buildManifestModelDefinition } from "openclaw/plugin-sdk/provider-catalog-shared";
+//#region extensions/meta/models.ts
+/**
+* Meta model catalog helpers derived from the plugin manifest.
+*/
+const META_MANIFEST_CATALOG = openclaw_plugin_default.modelCatalog.providers["meta"];
+/** Base URL for Meta OpenAI-compatible inference. */
+const META_BASE_URL = META_MANIFEST_CATALOG.baseUrl;
+/** Meta model catalog entries from the plugin manifest. */
+const META_MODEL_CATALOG = META_MANIFEST_CATALOG.models;
+/** Builds normalized Meta catalog model definitions. */
+function buildMetaCatalogModels() {
+	return META_MODEL_CATALOG.map(buildManifestModelDefinition({
+		providerId: "meta",
+		catalog: META_MANIFEST_CATALOG
+	}));
+}
+//#endregion
 export { META_BASE_URL, META_MODEL_CATALOG, buildMetaCatalogModels };

package/dist/onboard.js

@@ -1,4 +1,5 @@
-import { i as openclaw_plugin_default, r as buildMetaCatalogModels, t as META_BASE_URL } from "./models-BHj_98-y.js";
+import { t as openclaw_plugin_default } from "./openclaw.plugin-Drxs3Dwe.js";
+import { META_BASE_URL, buildMetaCatalogModels } from "./models.js";
 import { readManifestProviderDefaultModelRef } from "openclaw/plugin-sdk/provider-catalog-shared";
 import { createModelCatalogPresetAppliers } from "openclaw/plugin-sdk/provider-onboard";
 //#region extensions/meta/onboard.ts
@@ -7,9 +8,10 @@ import { createModelCatalogPresetAppliers } from "openclaw/plugin-sdk/provider-o
 */
 /** Default Meta model reference used after onboarding. */
 const META_DEFAULT_MODEL_REF = readManifestProviderDefaultModelRef(openclaw_plugin_default, "meta");
-const metaPresetAppliers = createModelCatalogPresetAppliers({
+/** Applies Meta provider/catalog config and default model aliases. */
+const { applyConfig: applyMetaConfig } = createModelCatalogPresetAppliers({
 	primaryModelRef: META_DEFAULT_MODEL_REF,
-	resolveParams: (_cfg) => ({
+	resolveParams: () => ({
 		providerId: "meta",
 		api: "openai-responses",
 		baseUrl: META_BASE_URL,
@@ -20,9 +22,5 @@ const metaPresetAppliers = createModelCatalogPresetAppliers({
 		}]
 	})
 });
-/** Applies Meta provider/catalog config and default model aliases. */
-function applyMetaConfig(cfg) {
-	return metaPresetAppliers.applyConfig(cfg);
-}
 //#endregion
 export { META_DEFAULT_MODEL_REF, applyMetaConfig };

package/dist/openclaw.plugin-Drxs3Dwe.js

@@ -0,0 +1,149 @@
+//#region extensions/meta/openclaw.plugin.json
+var openclaw_plugin_default = {
+	id: "meta",
+	activation: { "onStartup": false },
+	enabledByDefault: true,
+	providers: ["meta"],
+	providerEndpoints: [{
+		"endpointClass": "meta-native",
+		"hosts": ["api.meta.ai"]
+	}],
+	providerRequest: { "providers": { "meta": { "family": "meta" } } },
+	modelCatalog: {
+		"providers": { "meta": {
+			"baseUrl": "https://api.meta.ai/v1",
+			"api": "openai-responses",
+			"defaultModel": "muse-spark-1.1",
+			"models": [
+				{
+					"id": "muse-spark-1.1",
+					"name": "Muse Spark 1.1",
+					"reasoning": true,
+					"input": ["text", "image"],
+					"contextWindow": 1048576,
+					"maxTokens": 131072,
+					"thinkingLevelMap": {
+						"off": "minimal",
+						"minimal": "minimal",
+						"low": "low",
+						"medium": "medium",
+						"high": "high",
+						"xhigh": "xhigh"
+					},
+					"compat": {
+						"supportsTools": true,
+						"supportsReasoningEffort": true,
+						"supportedReasoningEfforts": [
+							"minimal",
+							"low",
+							"medium",
+							"high",
+							"xhigh"
+						]
+					},
+					"cost": {
+						"input": 1.25,
+						"output": 4.25,
+						"cacheRead": .15,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "muse-spark-1.2",
+					"name": "Muse Spark 1.2",
+					"reasoning": true,
+					"input": ["text", "image"],
+					"contextWindow": 1048576,
+					"maxTokens": 131072,
+					"thinkingLevelMap": {
+						"off": "minimal",
+						"minimal": "minimal",
+						"low": "low",
+						"medium": "medium",
+						"high": "high",
+						"xhigh": "xhigh"
+					},
+					"compat": {
+						"supportsTools": true,
+						"supportsReasoningEffort": true,
+						"supportedReasoningEfforts": [
+							"minimal",
+							"low",
+							"medium",
+							"high",
+							"xhigh"
+						]
+					},
+					"cost": {
+						"input": 1.25,
+						"output": 4.25,
+						"cacheRead": .15,
+						"cacheWrite": 0
+					}
+				},
+				{
+					"id": "muse-spark-1.2-contributor",
+					"name": "Muse Spark 1.2 Contributor",
+					"reasoning": true,
+					"input": ["text", "image"],
+					"contextWindow": 1048576,
+					"maxTokens": 131072,
+					"thinkingLevelMap": {
+						"off": "minimal",
+						"minimal": "minimal",
+						"low": "low",
+						"medium": "medium",
+						"high": "high",
+						"xhigh": "xhigh"
+					},
+					"compat": {
+						"supportsTools": true,
+						"supportsReasoningEffort": true,
+						"supportedReasoningEfforts": [
+							"minimal",
+							"low",
+							"medium",
+							"high",
+							"xhigh"
+						]
+					},
+					"cost": {
+						"input": .1,
+						"output": .2,
+						"cacheRead": .002,
+						"cacheWrite": 0
+					}
+				}
+			]
+		} },
+		"discovery": { "meta": "refreshable" }
+	},
+	setup: { "providers": [{
+		"id": "meta",
+		"authMethods": ["api-key"],
+		"envVars": ["MODEL_API_KEY"]
+	}] },
+	providerAuthChoices: [{
+		"provider": "meta",
+		"method": "api-key",
+		"choiceId": "meta-api-key",
+		"appGuidedSecret": true,
+		"choiceLabel": "Meta API key",
+		"choiceHint": "Meta (Responses API)",
+		"groupId": "meta",
+		"groupLabel": "Meta",
+		"groupHint": "Meta (Responses API)",
+		"onboardingFeatured": true,
+		"optionKey": "metaApiKey",
+		"cliFlag": "--meta-api-key",
+		"cliOption": "--meta-api-key <key>",
+		"cliDescription": "Meta API key"
+	}],
+	configSchema: {
+		"type": "object",
+		"additionalProperties": false,
+		"properties": {}
+	}
+};
+//#endregion
+export { openclaw_plugin_default as t };

package/dist/provider-catalog.js

@@ -1,12 +1,15 @@
-import { r as buildMetaCatalogModels, t as META_BASE_URL } from "./models-BHj_98-y.js";
+import { t as openclaw_plugin_default } from "./openclaw.plugin-Drxs3Dwe.js";
+import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
 //#region extensions/meta/provider-catalog.ts
+/**
+* Meta model provider builder.
+*/
 /** Builds the Meta OpenAI-compatible model provider config. */
 function buildMetaProvider() {
-	return {
-		baseUrl: META_BASE_URL,
-		api: "openai-responses",
-		models: buildMetaCatalogModels()
-	};
+	return buildManifestModelProviderConfig({
+		providerId: "meta",
+		catalog: openclaw_plugin_default.modelCatalog.providers.meta
+	});
 }
 //#endregion
 export { buildMetaProvider };

package/dist/stream.js

@@ -1,25 +1,18 @@
-import { streamSimple } from "openclaw/plugin-sdk/llm";
-import { streamWithPayloadPatch } from "openclaw/plugin-sdk/provider-stream-shared";
+import { createPayloadPatchStreamWrapper } from "openclaw/plugin-sdk/provider-stream-shared";
+import { filterStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/meta/stream.ts
 const META_REASONING_ENCRYPTED_CONTENT_INCLUDE = "reasoning.encrypted_content";
-function ensureMetaResponsesReplayFields(payloadObj) {
-	const existing = payloadObj.include;
-	const include = Array.isArray(existing) ? existing.filter((entry) => typeof entry === "string") : [];
-	if (!include.includes(META_REASONING_ENCRYPTED_CONTENT_INCLUDE)) include.push(META_REASONING_ENCRYPTED_CONTENT_INCLUDE);
-	payloadObj.include = include;
-	payloadObj.store = false;
-}
-function createMetaResponsesWrapper(baseStreamFn) {
-	const underlying = baseStreamFn ?? streamSimple;
-	return (model, context, options) => streamWithPayloadPatch(underlying, model, context, options, (payloadObj) => {
-		if (model.provider !== "meta" || model.api !== "openai-responses") return;
+function wrapMetaProviderStream(ctx) {
+	if (ctx.provider !== "meta" || (ctx.sourceApi ?? ctx.model?.api) !== "openai-responses") return;
+	return createPayloadPatchStreamWrapper(ctx.streamFn, ({ payload, model, options }) => {
+		if (model.provider !== "meta") return;
+		if (options?.maxTokens === 0 && payload.max_output_tokens === void 0) payload.max_output_tokens = model.maxTokens;
 		if (!model.reasoning) return;
-		ensureMetaResponsesReplayFields(payloadObj);
+		const include = filterStringEntries(payload.include);
+		if (!include.includes(META_REASONING_ENCRYPTED_CONTENT_INCLUDE)) include.push(META_REASONING_ENCRYPTED_CONTENT_INCLUDE);
+		payload.include = include;
+		payload.store = false;
 	});
 }
-function wrapMetaProviderStream(ctx) {
-	if (ctx.provider !== "meta" || ctx.model?.api !== "openai-responses") return;
-	return createMetaResponsesWrapper(ctx.streamFn);
-}
 //#endregion
 export { wrapMetaProviderStream };

package/dist/thinking.js

@@ -1,8 +1,6 @@
+import { META_MODEL_CATALOG } from "./models.js";
 //#region extensions/meta/thinking.ts
-const META_REASONING_MODEL_ID = "muse-spark-1.1";
-function isMetaReasoningModelId(modelId) {
-	return modelId.toLowerCase() === META_REASONING_MODEL_ID;
-}
+const META_REASONING_MODEL_IDS = new Set(META_MODEL_CATALOG.filter((model) => model.reasoning).map((model) => model.id.toLowerCase()));
 const META_THINKING_PROFILE = {
 	levels: [
 		"off",
@@ -14,8 +12,8 @@ const META_THINKING_PROFILE = {
 	].map((id) => ({ id })),
 	defaultLevel: "high"
 };
-function resolveMetaThinkingProfile(modelId) {
-	return isMetaReasoningModelId(modelId) ? META_THINKING_PROFILE : void 0;
+function resolveMetaThinkingProfile(context) {
+	return context.reasoning ?? META_REASONING_MODEL_IDS.has(context.modelId.toLowerCase()) ? META_THINKING_PROFILE : void 0;
 }
 //#endregion
 export { resolveMetaThinkingProfile };

package/openclaw.plugin.json

@@ -64,6 +64,78 @@
               "cacheRead": 0.15,
               "cacheWrite": 0
             }
+          },
+          {
+            "id": "muse-spark-1.2",
+            "name": "Muse Spark 1.2",
+            "reasoning": true,
+            "input": [
+              "text",
+              "image"
+            ],
+            "contextWindow": 1048576,
+            "maxTokens": 131072,
+            "thinkingLevelMap": {
+              "off": "minimal",
+              "minimal": "minimal",
+              "low": "low",
+              "medium": "medium",
+              "high": "high",
+              "xhigh": "xhigh"
+            },
+            "compat": {
+              "supportsTools": true,
+              "supportsReasoningEffort": true,
+              "supportedReasoningEfforts": [
+                "minimal",
+                "low",
+                "medium",
+                "high",
+                "xhigh"
+              ]
+            },
+            "cost": {
+              "input": 1.25,
+              "output": 4.25,
+              "cacheRead": 0.15,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "muse-spark-1.2-contributor",
+            "name": "Muse Spark 1.2 Contributor",
+            "reasoning": true,
+            "input": [
+              "text",
+              "image"
+            ],
+            "contextWindow": 1048576,
+            "maxTokens": 131072,
+            "thinkingLevelMap": {
+              "off": "minimal",
+              "minimal": "minimal",
+              "low": "low",
+              "medium": "medium",
+              "high": "high",
+              "xhigh": "xhigh"
+            },
+            "compat": {
+              "supportsTools": true,
+              "supportsReasoningEffort": true,
+              "supportedReasoningEfforts": [
+                "minimal",
+                "low",
+                "medium",
+                "high",
+                "xhigh"
+              ]
+            },
+            "cost": {
+              "input": 0.1,
+              "output": 0.2,
+              "cacheRead": 0.002,
+              "cacheWrite": 0
+            }
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/meta-provider",
-  "version": "2026.7.2-beta.5",
+  "version": "2026.8.1-beta.2",
   "description": "OpenClaw Meta provider plugin.",
   "repository": {
     "type": "git",
@@ -18,11 +18,11 @@
       "minHostVersion": ">=2026.6.11"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.5"
+      "pluginApi": ">=2026.8.1-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.5",
-      "bundledDist": true
+      "openclawVersion": "2026.8.1-beta.2",
+      "bundledDist": false
     },
     "release": {
       "publishToClawHub": true,
@@ -38,7 +38,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.5"
+    "openclaw": ">=2026.8.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/models-BHj_98-y.js

@@ -1,99 +0,0 @@
-import { buildManifestModelDefinition } from "openclaw/plugin-sdk/provider-catalog-shared";
-//#region extensions/meta/openclaw.plugin.json
-var openclaw_plugin_default = {
-	id: "meta",
-	activation: { "onStartup": false },
-	enabledByDefault: true,
-	providers: ["meta"],
-	providerEndpoints: [{
-		"endpointClass": "meta-native",
-		"hosts": ["api.meta.ai"]
-	}],
-	providerRequest: { "providers": { "meta": { "family": "meta" } } },
-	modelCatalog: {
-		"providers": { "meta": {
-			"baseUrl": "https://api.meta.ai/v1",
-			"api": "openai-responses",
-			"defaultModel": "muse-spark-1.1",
-			"models": [{
-				"id": "muse-spark-1.1",
-				"name": "Muse Spark 1.1",
-				"reasoning": true,
-				"input": ["text", "image"],
-				"contextWindow": 1048576,
-				"maxTokens": 131072,
-				"thinkingLevelMap": {
-					"off": "minimal",
-					"minimal": "minimal",
-					"low": "low",
-					"medium": "medium",
-					"high": "high",
-					"xhigh": "xhigh"
-				},
-				"compat": {
-					"supportsTools": true,
-					"supportsReasoningEffort": true,
-					"supportedReasoningEfforts": [
-						"minimal",
-						"low",
-						"medium",
-						"high",
-						"xhigh"
-					]
-				},
-				"cost": {
-					"input": 1.25,
-					"output": 4.25,
-					"cacheRead": .15,
-					"cacheWrite": 0
-				}
-			}]
-		} },
-		"discovery": { "meta": "refreshable" }
-	},
-	setup: { "providers": [{
-		"id": "meta",
-		"authMethods": ["api-key"],
-		"envVars": ["MODEL_API_KEY"]
-	}] },
-	providerAuthChoices: [{
-		"provider": "meta",
-		"method": "api-key",
-		"choiceId": "meta-api-key",
-		"appGuidedSecret": true,
-		"choiceLabel": "Meta API key",
-		"choiceHint": "Meta (Responses API)",
-		"groupId": "meta",
-		"groupLabel": "Meta",
-		"groupHint": "Meta (Responses API)",
-		"onboardingFeatured": true,
-		"optionKey": "metaApiKey",
-		"cliFlag": "--meta-api-key",
-		"cliOption": "--meta-api-key <key>",
-		"cliDescription": "Meta API key"
-	}],
-	configSchema: {
-		"type": "object",
-		"additionalProperties": false,
-		"properties": {}
-	}
-};
-//#endregion
-//#region extensions/meta/models.ts
-/**
-* Meta model catalog helpers derived from the plugin manifest.
-*/
-const META_MANIFEST_CATALOG = openclaw_plugin_default.modelCatalog.providers["meta"];
-/** Base URL for Meta OpenAI-compatible inference. */
-const META_BASE_URL = META_MANIFEST_CATALOG.baseUrl;
-/** Meta model catalog entries from the plugin manifest. */
-const META_MODEL_CATALOG = META_MANIFEST_CATALOG.models;
-/** Builds normalized Meta catalog model definitions. */
-function buildMetaCatalogModels() {
-	return META_MODEL_CATALOG.map(buildManifestModelDefinition({
-		providerId: "meta",
-		catalog: META_MANIFEST_CATALOG
-	}));
-}
-//#endregion
-export { openclaw_plugin_default as i, META_MODEL_CATALOG as n, buildMetaCatalogModels as r, META_BASE_URL as t };