@openclaw/byteplus-provider 0.0.0 → 2026.8.1-beta.3

package/README.md

@@ -1,3 +1,17 @@
-# @openclaw/byteplus-provider
+# OpenClaw BytePlus Provider
 
-Reserved placeholder for the official OpenClaw plugin package. Use a published release version instead.
+Official OpenClaw provider plugin for BytePlus model inference and Seedance
+video generation.
+
+Install from OpenClaw:
+
+```bash
+openclaw plugins install @openclaw/byteplus-provider
+openclaw gateway restart
+```
+
+Set `BYTEPLUS_API_KEY`, then select a `byteplus/*` or `byteplus-plan/*` model.
+
+See <https://docs.openclaw.ai/concepts/model-providers#byteplus-international>
+for model setup and <https://docs.openclaw.ai/tools/video-generation> for
+Seedance video generation.

package/dist/api.js

@@ -0,0 +1,2 @@
+import { i as BYTEPLUS_MODEL_CATALOG, n as BYTEPLUS_CODING_BASE_URL, r as BYTEPLUS_CODING_MODEL_CATALOG, t as BYTEPLUS_BASE_URL } from "./models-DdB2dJk5.js";
+export { BYTEPLUS_BASE_URL, BYTEPLUS_CODING_BASE_URL, BYTEPLUS_CODING_MODEL_CATALOG, BYTEPLUS_MODEL_CATALOG };

package/dist/index.js

@@ -0,0 +1,40 @@
+import { a as BYTEPLUS_PROVIDER_CATALOG, o as openclaw_plugin_default } from "./models-DdB2dJk5.js";
+import { buildBytePlusVideoGenerationProvider } from "./video-generation-provider.js";
+import { buildOpenAICompatibleProviderFamilyCatalog } from "openclaw/plugin-sdk/provider-catalog-live-runtime";
+import { readManifestProviderDefaultModelRef } from "openclaw/plugin-sdk/provider-catalog-shared";
+import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
+import { ensureModelAllowlistEntry } from "openclaw/plugin-sdk/provider-onboard";
+//#region extensions/byteplus/index.ts
+/**
+* BytePlus provider plugin entrypoint for model and video generation providers.
+*/
+const PROVIDER_ID = "byteplus";
+const BYTEPLUS_DEFAULT_MODEL_REF = readManifestProviderDefaultModelRef(openclaw_plugin_default, "byteplus-plan");
+var byteplus_default = defineSingleProviderPluginEntry({
+	id: PROVIDER_ID,
+	name: "BytePlus Provider",
+	description: "BytePlus provider plugin",
+	manifest: openclaw_plugin_default,
+	provider: {
+		label: "BytePlus",
+		docsPath: "/concepts/model-providers#byteplus-international",
+		manifestAuth: {
+			defaultModel: BYTEPLUS_DEFAULT_MODEL_REF,
+			applyConfig: (cfg) => ensureModelAllowlistEntry({
+				cfg,
+				modelRef: BYTEPLUS_DEFAULT_MODEL_REF
+			})
+		},
+		...buildOpenAICompatibleProviderFamilyCatalog({
+			credentialProviderId: PROVIDER_ID,
+			entries: BYTEPLUS_PROVIDER_CATALOG.entries,
+			staticCatalog: BYTEPLUS_PROVIDER_CATALOG.staticCatalog,
+			augmentModelCatalog: BYTEPLUS_PROVIDER_CATALOG.augmentModelCatalog
+		})
+	},
+	register(api) {
+		api.registerVideoGenerationProvider(buildBytePlusVideoGenerationProvider());
+	}
+});
+//#endregion
+export { byteplus_default as default };

package/dist/models-DdB2dJk5.js

@@ -0,0 +1,191 @@
+import { buildManifestProviderCatalogFamily } from "openclaw/plugin-sdk/provider-catalog-shared";
+//#region extensions/byteplus/openclaw.plugin.json
+var openclaw_plugin_default = {
+	id: "byteplus",
+	activation: { "onStartup": false },
+	enabledByDefault: true,
+	providerCatalogEntry: "./provider-discovery.ts",
+	providers: ["byteplus", "byteplus-plan"],
+	setup: { "providers": [{
+		"id": "byteplus",
+		"envVars": ["BYTEPLUS_API_KEY"]
+	}] },
+	providerAuthAliases: { "byteplus-plan": "byteplus" },
+	modelCatalog: {
+		"providers": {
+			"byteplus": {
+				"baseUrl": "https://ark.ap-southeast.bytepluses.com/api/v3",
+				"api": "openai-completions",
+				"models": [
+					{
+						"id": "dola-seed-2-1-turbo-260628",
+						"name": "Dola Seed 2.1 Turbo",
+						"reasoning": true,
+						"input": ["text", "image"],
+						"contextWindow": 256e3,
+						"maxTokens": 256e3,
+						"cost": {
+							"input": .5,
+							"output": 2.5,
+							"cacheRead": .1,
+							"cacheWrite": 0
+						}
+					},
+					{
+						"id": "seed-2-0-code-preview-260328",
+						"name": "Seed 2.0 Code Preview",
+						"reasoning": true,
+						"input": ["text", "image"],
+						"contextWindow": 256e3,
+						"maxTokens": 128e3,
+						"cost": {
+							"input": .5,
+							"output": 3,
+							"cacheRead": .1,
+							"cacheWrite": 0
+						}
+					},
+					{
+						"id": "glm-5-2-260617",
+						"name": "GLM 5.2",
+						"reasoning": true,
+						"input": ["text"],
+						"contextWindow": 1024e3,
+						"maxTokens": 128e3,
+						"cost": {
+							"input": 1.4,
+							"output": 4.4,
+							"cacheRead": .26,
+							"cacheWrite": 0
+						}
+					},
+					{
+						"id": "deepseek-v4-pro-260425",
+						"name": "DeepSeek V4 Pro",
+						"reasoning": true,
+						"input": ["text"],
+						"contextWindow": 1024e3,
+						"maxTokens": 384e3,
+						"cost": {
+							"input": 1.74,
+							"output": 3.48,
+							"cacheRead": .145,
+							"cacheWrite": 0
+						}
+					},
+					{
+						"id": "deepseek-v4-flash-260425",
+						"name": "DeepSeek V4 Flash",
+						"reasoning": true,
+						"input": ["text"],
+						"contextWindow": 1024e3,
+						"maxTokens": 384e3,
+						"cost": {
+							"input": .14,
+							"output": .28,
+							"cacheRead": .028,
+							"cacheWrite": 0
+						}
+					},
+					{
+						"id": "glm-4-7-251222",
+						"name": "GLM 4.7",
+						"status": "deprecated",
+						"replacedBy": "glm-5-2-260617",
+						"reasoning": true,
+						"input": ["text"],
+						"contextWindow": 256e3,
+						"maxTokens": 128e3,
+						"cost": {
+							"input": .6,
+							"output": 2.2,
+							"cacheRead": .11,
+							"cacheWrite": 0
+						}
+					}
+				]
+			},
+			"byteplus-plan": {
+				"baseUrl": "https://ark.ap-southeast.bytepluses.com/api/coding/v3",
+				"api": "openai-completions",
+				"defaultModel": "ark-code-latest",
+				"models": [{
+					"id": "ark-code-latest",
+					"name": "Ark Coding Plan",
+					"input": ["text"],
+					"contextWindow": 256e3,
+					"maxTokens": 4096,
+					"cost": {
+						"input": 0,
+						"output": 0,
+						"cacheRead": 0,
+						"cacheWrite": 0
+					}
+				}, {
+					"id": "kimi-k2.5",
+					"name": "Kimi K2.5 Coding",
+					"reasoning": true,
+					"input": ["text", "image"],
+					"contextWindow": 256e3,
+					"maxTokens": 32768,
+					"cost": {
+						"input": 0,
+						"output": 0,
+						"cacheRead": 0,
+						"cacheWrite": 0
+					}
+				}]
+			}
+		},
+		"discovery": {
+			"byteplus": "refreshable",
+			"byteplus-plan": "refreshable"
+		}
+	},
+	providerAuthChoices: [{
+		"provider": "byteplus",
+		"method": "api-key",
+		"choiceId": "byteplus-api-key",
+		"appGuidedSecret": true,
+		"choiceLabel": "BytePlus API key",
+		"groupId": "byteplus",
+		"groupLabel": "BytePlus",
+		"groupHint": "API key",
+		"optionKey": "byteplusApiKey",
+		"cliFlag": "--byteplus-api-key",
+		"cliOption": "--byteplus-api-key <key>",
+		"cliDescription": "BytePlus API key"
+	}],
+	contracts: { "videoGenerationProviders": ["byteplus"] },
+	configSchema: {
+		"type": "object",
+		"additionalProperties": false,
+		"properties": {}
+	}
+};
+//#endregion
+//#region extensions/byteplus/models.ts
+/**
+* BytePlus model catalog helpers derived from the plugin manifest.
+*/
+const BYTEPLUS_PROVIDER_CATALOG = buildManifestProviderCatalogFamily({ surfaces: [{
+	id: "byteplus",
+	label: "BytePlus",
+	catalog: openclaw_plugin_default.modelCatalog.providers.byteplus
+}, {
+	id: "byteplus-plan",
+	label: "BytePlus Plan",
+	catalog: openclaw_plugin_default.modelCatalog.providers["byteplus-plan"]
+}] });
+const BYTEPLUS_PROVIDER = BYTEPLUS_PROVIDER_CATALOG.entries[0];
+const BYTEPLUS_CODING_PROVIDER = BYTEPLUS_PROVIDER_CATALOG.entries[1];
+/** Base URL for BytePlus chat/model APIs from the manifest catalog. */
+const BYTEPLUS_BASE_URL = BYTEPLUS_PROVIDER.baseUrl;
+/** Base URL for BytePlus Plan coding APIs from the manifest catalog. */
+const BYTEPLUS_CODING_BASE_URL = BYTEPLUS_CODING_PROVIDER.baseUrl;
+/** BytePlus general model catalog entries. */
+const BYTEPLUS_MODEL_CATALOG = BYTEPLUS_PROVIDER.models;
+/** BytePlus coding/planning model catalog entries. */
+const BYTEPLUS_CODING_MODEL_CATALOG = BYTEPLUS_CODING_PROVIDER.models;
+//#endregion
+export { BYTEPLUS_PROVIDER_CATALOG as a, BYTEPLUS_MODEL_CATALOG as i, BYTEPLUS_CODING_BASE_URL as n, openclaw_plugin_default as o, BYTEPLUS_CODING_MODEL_CATALOG as r, BYTEPLUS_BASE_URL as t };

package/dist/models.js

@@ -0,0 +1,2 @@
+import { a as BYTEPLUS_PROVIDER_CATALOG, i as BYTEPLUS_MODEL_CATALOG, n as BYTEPLUS_CODING_BASE_URL, r as BYTEPLUS_CODING_MODEL_CATALOG, t as BYTEPLUS_BASE_URL } from "./models-DdB2dJk5.js";
+export { BYTEPLUS_BASE_URL, BYTEPLUS_CODING_BASE_URL, BYTEPLUS_CODING_MODEL_CATALOG, BYTEPLUS_MODEL_CATALOG, BYTEPLUS_PROVIDER_CATALOG };

package/dist/provider-discovery.js

@@ -0,0 +1,8 @@
+import { a as BYTEPLUS_PROVIDER_CATALOG } from "./models-DdB2dJk5.js";
+//#region extensions/byteplus/provider-discovery.ts
+/**
+* Static provider discovery entries for BytePlus manifest-backed catalogs.
+*/
+var provider_discovery_default = BYTEPLUS_PROVIDER_CATALOG.staticDiscovery;
+//#endregion
+export { provider_discovery_default as default };

package/dist/video-generation-provider.js

@@ -0,0 +1,270 @@
+import { t as BYTEPLUS_BASE_URL } from "./models-DdB2dJk5.js";
+import { toImageDataUrl } from "openclaw/plugin-sdk/image-generation";
+import { downloadGeneratedVideoAsset, resolveGeneratedMediaMaxBytes } from "openclaw/plugin-sdk/media-generation-runtime";
+import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
+import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime";
+import { assertOkOrThrowHttpError, createProviderOperationDeadline, createProviderOperationTimeoutResolver, fetchProviderDownloadResponse, pollProviderOperationJson, postJsonRequest, readProviderJsonResponse, resolveProviderHttpRequestConfig, resolveProviderOperationTimeoutMs } from "openclaw/plugin-sdk/provider-http";
+import { asSafeIntegerInRange, isRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+//#region extensions/byteplus/video-generation-provider.ts
+/**
+* BytePlus Seedance video generation provider implementation.
+*/
+const DEFAULT_BYTEPLUS_VIDEO_MODEL = "seedance-1-0-pro-250528";
+const DEFAULT_TIMEOUT_MS = 12e4;
+const POLL_INTERVAL_MS = 5e3;
+const MAX_POLL_ATTEMPTS = 120;
+const BYTEPLUS_SEED_MAX = 2147483647;
+const BYTEPLUS_MIN_DURATION_SECONDS = 2;
+const BYTEPLUS_MAX_DURATION_SECONDS = 12;
+async function readBytePlusJsonResponse(response, label) {
+	const payload = await readProviderJsonResponse(response, label);
+	if (!isRecord(payload)) throw new Error(`${label}: malformed JSON response`);
+	return payload;
+}
+function readBytePlusTaskStatus(payload) {
+	const status = normalizeOptionalString(payload.status);
+	switch (status) {
+		case "running":
+		case "failed":
+		case "queued":
+		case "succeeded":
+		case "cancelled": return status;
+		case void 0: throw new Error("BytePlus video status response missing task status");
+		default: throw new Error(`BytePlus video status response returned unknown task status: ${status}`);
+	}
+}
+function readBytePlusErrorMessage(error) {
+	return isRecord(error) ? normalizeOptionalString(error.message) : void 0;
+}
+function readBytePlusVideoUrl(payload) {
+	const content = payload.content;
+	if (content !== void 0 && !isRecord(content)) throw new Error("BytePlus video generation completed with malformed content");
+	const videoUrl = normalizeOptionalString(content?.video_url);
+	if (!videoUrl) throw new Error("BytePlus video generation completed without a video URL");
+	return videoUrl;
+}
+function resolveBytePlusVideoBaseUrl(req) {
+	return normalizeOptionalString(req.cfg?.models?.providers?.byteplus?.baseUrl) ?? BYTEPLUS_BASE_URL;
+}
+function resolveBytePlusImageUrl(req) {
+	const input = req.inputImages?.[0];
+	if (!input) return;
+	const inputUrl = normalizeOptionalString(input.url);
+	if (inputUrl) return inputUrl;
+	if (!input.buffer) throw new Error("BytePlus reference image is missing image data.");
+	return toImageDataUrl({
+		...input,
+		buffer: input.buffer,
+		defaultMimeType: "image/png"
+	});
+}
+function resolveBytePlusSeed(value) {
+	return asSafeIntegerInRange(value, {
+		min: -1,
+		max: BYTEPLUS_SEED_MAX
+	});
+}
+function resolveBytePlusDurationSeconds(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return;
+	return asSafeIntegerInRange(Math.round(value), {
+		min: BYTEPLUS_MIN_DURATION_SECONDS,
+		max: BYTEPLUS_MAX_DURATION_SECONDS
+	});
+}
+function readBytePlusDurationSeconds(value) {
+	return asSafeIntegerInRange(value, {
+		min: BYTEPLUS_MIN_DURATION_SECONDS,
+		max: BYTEPLUS_MAX_DURATION_SECONDS
+	});
+}
+async function pollBytePlusTask(params) {
+	const deadline = createProviderOperationDeadline({
+		timeoutMs: params.timeoutMs,
+		label: `BytePlus video generation task ${params.taskId}`
+	});
+	return await pollProviderOperationJson({
+		url: `${params.baseUrl}/contents/generations/tasks/${params.taskId}`,
+		headers: params.headers,
+		deadline,
+		defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+		fetchFn: params.fetchFn,
+		maxAttempts: MAX_POLL_ATTEMPTS,
+		pollIntervalMs: POLL_INTERVAL_MS,
+		requestFailedMessage: "BytePlus video status request failed",
+		timeoutMessage: `BytePlus video generation task ${params.taskId} did not finish in time`,
+		isComplete: (payload) => readBytePlusTaskStatus(payload) === "succeeded",
+		getFailureMessage: (payload) => {
+			const status = readBytePlusTaskStatus(payload);
+			return status === "failed" || status === "cancelled" ? readBytePlusErrorMessage(payload.error) || "BytePlus video generation failed" : void 0;
+		}
+	});
+}
+async function downloadBytePlusVideo(params) {
+	return await downloadGeneratedVideoAsset({
+		url: params.url,
+		timeoutMs: params.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+		defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+		fetchFn: params.fetchFn,
+		provider: "byteplus",
+		label: "BytePlus generated video download",
+		requestFailedMessage: "BytePlus generated video download failed",
+		maxBytes: params.maxBytes,
+		validateBinaryResponse: true,
+		fetchResponse: async ({ deadline }) => ({ response: await fetchProviderDownloadResponse({
+			url: params.url,
+			init: { method: "GET" },
+			deadline,
+			fetchFn: params.fetchFn,
+			provider: "byteplus",
+			requestFailedMessage: "BytePlus generated video download failed"
+		}) })
+	});
+}
+/** Builds the BytePlus video generation provider registered by the plugin. */
+function buildBytePlusVideoGenerationProvider() {
+	return {
+		id: "byteplus",
+		label: "BytePlus",
+		defaultModel: DEFAULT_BYTEPLUS_VIDEO_MODEL,
+		models: [DEFAULT_BYTEPLUS_VIDEO_MODEL, "seedance-1-5-pro-251215"],
+		isConfigured: (ctx) => isProviderApiKeyConfigured({
+			provider: "byteplus",
+			...ctx
+		}),
+		capabilities: {
+			providerOptions: {
+				seed: "number",
+				draft: "boolean",
+				camera_fixed: "boolean"
+			},
+			generate: {
+				maxVideos: 1,
+				maxDurationSeconds: 12,
+				supportsAspectRatio: true,
+				supportsResolution: true,
+				supportsAudio: true,
+				supportsWatermark: true
+			},
+			imageToVideo: {
+				enabled: true,
+				maxVideos: 1,
+				maxInputImages: 1,
+				maxDurationSeconds: 12,
+				supportsAspectRatio: true,
+				supportsResolution: true,
+				supportsAudio: true,
+				supportsWatermark: true
+			},
+			videoToVideo: { enabled: false }
+		},
+		async generateVideo(req) {
+			if ((req.inputVideos?.length ?? 0) > 0) throw new Error("BytePlus video generation does not support video reference inputs.");
+			const auth = await resolveApiKeyForProvider({
+				provider: "byteplus",
+				cfg: req.cfg,
+				agentDir: req.agentDir,
+				store: req.authStore
+			});
+			if (!auth.apiKey) throw new Error("BytePlus API key missing");
+			const fetchFn = fetch;
+			const deadline = createProviderOperationDeadline({
+				timeoutMs: req.timeoutMs,
+				label: "BytePlus video generation"
+			});
+			const { baseUrl, allowPrivateNetwork, headers, dispatcherPolicy } = resolveProviderHttpRequestConfig({
+				baseUrl: resolveBytePlusVideoBaseUrl(req),
+				defaultBaseUrl: BYTEPLUS_BASE_URL,
+				allowPrivateNetwork: false,
+				defaultHeaders: {
+					Authorization: `Bearer ${auth.apiKey}`,
+					"Content-Type": "application/json"
+				},
+				provider: "byteplus",
+				capability: "video",
+				transport: "http"
+			});
+			const resolvedModel = normalizeOptionalString(req.model) || DEFAULT_BYTEPLUS_VIDEO_MODEL;
+			const content = [{
+				type: "text",
+				text: req.prompt
+			}];
+			const imageUrl = resolveBytePlusImageUrl(req);
+			if (imageUrl) content.push({
+				type: "image_url",
+				image_url: { url: imageUrl },
+				role: "first_frame"
+			});
+			const body = {
+				model: resolvedModel,
+				content
+			};
+			const aspectRatio = normalizeOptionalString(req.aspectRatio);
+			if (aspectRatio) body.ratio = aspectRatio;
+			const resolution = normalizeOptionalString(req.resolution)?.toLowerCase();
+			if (resolution) body.resolution = resolution;
+			const duration = resolveBytePlusDurationSeconds(req.durationSeconds);
+			if (duration !== void 0) body.duration = duration;
+			if (typeof req.audio === "boolean") body.generate_audio = req.audio;
+			if (typeof req.watermark === "boolean") body.watermark = req.watermark;
+			const opts = req.providerOptions ?? {};
+			const seed = resolveBytePlusSeed(opts.seed);
+			const draft = opts.draft === true;
+			const cameraFixed = typeof opts.camera_fixed === "boolean" ? opts.camera_fixed : void 0;
+			if (seed != null) body.seed = seed;
+			if (draft && !body.resolution) body.resolution = "480p";
+			if (cameraFixed != null) body.camera_fixed = cameraFixed;
+			const { response, release } = await postJsonRequest({
+				url: `${baseUrl}/contents/generations/tasks`,
+				headers,
+				body,
+				timeoutMs: resolveProviderOperationTimeoutMs({
+					deadline,
+					defaultTimeoutMs: DEFAULT_TIMEOUT_MS
+				}),
+				fetchFn,
+				allowPrivateNetwork,
+				dispatcherPolicy
+			});
+			try {
+				await assertOkOrThrowHttpError(response, "BytePlus video generation failed");
+				const taskId = normalizeOptionalString((await readBytePlusJsonResponse(response, "BytePlus video generation failed")).id);
+				if (!taskId) throw new Error("BytePlus video generation response missing task id");
+				const completed = await pollBytePlusTask({
+					taskId,
+					headers,
+					timeoutMs: resolveProviderOperationTimeoutMs({
+						deadline,
+						defaultTimeoutMs: DEFAULT_TIMEOUT_MS
+					}),
+					baseUrl,
+					fetchFn
+				});
+				const videoUrl = readBytePlusVideoUrl(completed);
+				return {
+					videos: [await downloadBytePlusVideo({
+						url: videoUrl,
+						timeoutMs: createProviderOperationTimeoutResolver({
+							deadline,
+							defaultTimeoutMs: DEFAULT_TIMEOUT_MS
+						}),
+						fetchFn,
+						maxBytes: resolveGeneratedMediaMaxBytes(req.cfg, "video")
+					})],
+					model: normalizeOptionalString(completed.model) ?? resolvedModel,
+					metadata: {
+						taskId,
+						status: normalizeOptionalString(completed.status),
+						videoUrl,
+						ratio: normalizeOptionalString(completed.ratio),
+						resolution: normalizeOptionalString(completed.resolution),
+						duration: readBytePlusDurationSeconds(completed.duration)
+					}
+				};
+			} finally {
+				await release();
+			}
+		}
+	};
+}
+//#endregion
+export { buildBytePlusVideoGenerationProvider };

package/openclaw.plugin.json

@@ -0,0 +1,178 @@
+{
+  "id": "byteplus",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providerCatalogEntry": "./provider-discovery.ts",
+  "providers": ["byteplus", "byteplus-plan"],
+  "setup": {
+    "providers": [
+      {
+        "id": "byteplus",
+        "envVars": ["BYTEPLUS_API_KEY"]
+      }
+    ]
+  },
+  "providerAuthAliases": {
+    "byteplus-plan": "byteplus"
+  },
+  "modelCatalog": {
+    "providers": {
+      "byteplus": {
+        "baseUrl": "https://ark.ap-southeast.bytepluses.com/api/v3",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "dola-seed-2-1-turbo-260628",
+            "name": "Dola Seed 2.1 Turbo",
+            "reasoning": true,
+            "input": ["text", "image"],
+            "contextWindow": 256000,
+            "maxTokens": 256000,
+            "cost": {
+              "input": 0.5,
+              "output": 2.5,
+              "cacheRead": 0.1,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "seed-2-0-code-preview-260328",
+            "name": "Seed 2.0 Code Preview",
+            "reasoning": true,
+            "input": ["text", "image"],
+            "contextWindow": 256000,
+            "maxTokens": 128000,
+            "cost": {
+              "input": 0.5,
+              "output": 3,
+              "cacheRead": 0.1,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "glm-5-2-260617",
+            "name": "GLM 5.2",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 1024000,
+            "maxTokens": 128000,
+            "cost": {
+              "input": 1.4,
+              "output": 4.4,
+              "cacheRead": 0.26,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "deepseek-v4-pro-260425",
+            "name": "DeepSeek V4 Pro",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 1024000,
+            "maxTokens": 384000,
+            "cost": {
+              "input": 1.74,
+              "output": 3.48,
+              "cacheRead": 0.145,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "deepseek-v4-flash-260425",
+            "name": "DeepSeek V4 Flash",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 1024000,
+            "maxTokens": 384000,
+            "cost": {
+              "input": 0.14,
+              "output": 0.28,
+              "cacheRead": 0.028,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "glm-4-7-251222",
+            "name": "GLM 4.7",
+            "status": "deprecated",
+            "replacedBy": "glm-5-2-260617",
+            "reasoning": true,
+            "input": ["text"],
+            "contextWindow": 256000,
+            "maxTokens": 128000,
+            "cost": {
+              "input": 0.6,
+              "output": 2.2,
+              "cacheRead": 0.11,
+              "cacheWrite": 0
+            }
+          }
+        ]
+      },
+      "byteplus-plan": {
+        "baseUrl": "https://ark.ap-southeast.bytepluses.com/api/coding/v3",
+        "api": "openai-completions",
+        "defaultModel": "ark-code-latest",
+        "models": [
+          {
+            "id": "ark-code-latest",
+            "name": "Ark Coding Plan",
+            "input": ["text"],
+            "contextWindow": 256000,
+            "maxTokens": 4096,
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "kimi-k2.5",
+            "name": "Kimi K2.5 Coding",
+            "reasoning": true,
+            "input": ["text", "image"],
+            "contextWindow": 256000,
+            "maxTokens": 32768,
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "byteplus": "refreshable",
+      "byteplus-plan": "refreshable"
+    }
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "byteplus",
+      "method": "api-key",
+      "choiceId": "byteplus-api-key",
+      "appGuidedSecret": true,
+      "choiceLabel": "BytePlus API key",
+      "groupId": "byteplus",
+      "groupLabel": "BytePlus",
+      "groupHint": "API key",
+      "optionKey": "byteplusApiKey",
+      "cliFlag": "--byteplus-api-key",
+      "cliOption": "--byteplus-api-key <key>",
+      "cliDescription": "BytePlus API key"
+    }
+  ],
+  "contracts": {
+    "videoGenerationProviders": ["byteplus"]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,14 +1,49 @@
 {
   "name": "@openclaw/byteplus-provider",
-  "version": "0.0.0",
-  "description": "Reserved package name for an official OpenClaw plugin.",
-  "license": "MIT",
+  "version": "2026.8.1-beta.3",
+  "description": "OpenClaw BytePlus provider plugin.",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/openclaw/openclaw.git"
+    "url": "https://github.com/openclaw/openclaw"
   },
-  "publishConfig": {
-    "access": "public",
-    "tag": "placeholder"
-  }
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/byteplus-provider",
+      "npmSpec": "@openclaw/byteplus-provider",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.7.2"
+    },
+    "compat": {
+      "pluginApi": ">=2026.8.1-beta.3"
+    },
+    "build": {
+      "openclawVersion": "2026.8.1-beta.3",
+      "bundledDist": false
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist/**",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "openclaw": ">=2026.8.1-beta.3"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "bundledDependencies": []
 }