@openclaw/fireworks-provider 0.0.0 → 2026.6.11

package/README.md

@@ -1,3 +1,13 @@
-# @openclaw/fireworks-provider
+# Fireworks OpenClaw provider
 
-Bootstrap reservation for the OpenClaw Fireworks provider package.
+Official OpenClaw provider plugin for Fireworks.
+
+## Install
+
+```sh
+openclaw plugins install @openclaw/fireworks-provider
+```
+
+## Docs
+
+See `docs/providers/fireworks.md` in the OpenClaw repository, or the published docs at `https://docs.openclaw.ai/providers/fireworks`.

package/dist/index.js

@@ -0,0 +1,83 @@
+import { isFireworksKimiModelId } from "./model-id.js";
+import { n as FIREWORKS_DEFAULT_CONTEXT_WINDOW, o as buildFireworksProvider, r as FIREWORKS_DEFAULT_MAX_TOKENS, s as isFireworksCatalogModelId, t as FIREWORKS_BASE_URL } from "./provider-catalog-DfjnZjS3.js";
+import { FIREWORKS_DEFAULT_MODEL_REF, applyFireworksConfig } from "./onboard.js";
+import { wrapFireworksProviderStream } from "./stream.js";
+import { resolveFireworksThinkingProfile } from "./thinking-policy.js";
+import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
+import { DEFAULT_CONTEXT_TOKENS, OPENAI_COMPATIBLE_REPLAY_HOOKS, cloneFirstTemplateModel, normalizeModelCompat } from "openclaw/plugin-sdk/provider-model-shared";
+//#region extensions/fireworks/index.ts
+const PROVIDER_ID = "fireworks";
+function isFireworksGlmModelId(modelId) {
+	const normalized = modelId.trim().toLowerCase();
+	const lastSegment = normalized.split("/").pop() ?? normalized;
+	return /^glm[-_.]/.test(lastSegment);
+}
+function resolveFireworksDynamicInput(modelId) {
+	return isFireworksGlmModelId(modelId) ? ["text"] : ["text", "image"];
+}
+function resolveFireworksDynamicModel(ctx) {
+	const modelId = ctx.modelId.trim();
+	if (!modelId) return;
+	if (isFireworksCatalogModelId(modelId)) return;
+	const isKimiModel = isFireworksKimiModelId(modelId);
+	const input = resolveFireworksDynamicInput(modelId);
+	return cloneFirstTemplateModel({
+		providerId: PROVIDER_ID,
+		modelId,
+		templateIds: ["accounts/fireworks/routers/kimi-k2p5-turbo"],
+		ctx,
+		patch: {
+			provider: PROVIDER_ID,
+			reasoning: !isKimiModel,
+			input
+		}
+	}) ?? normalizeModelCompat({
+		id: modelId,
+		name: modelId,
+		provider: PROVIDER_ID,
+		api: "openai-completions",
+		baseUrl: FIREWORKS_BASE_URL,
+		reasoning: !isKimiModel,
+		input,
+		cost: {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: FIREWORKS_DEFAULT_CONTEXT_WINDOW,
+		maxTokens: FIREWORKS_DEFAULT_MAX_TOKENS || DEFAULT_CONTEXT_TOKENS
+	});
+}
+var fireworks_default = defineSingleProviderPluginEntry({
+	id: PROVIDER_ID,
+	name: "Fireworks Provider",
+	description: "Bundled Fireworks AI provider plugin",
+	provider: {
+		label: "Fireworks",
+		aliases: ["fireworks-ai"],
+		docsPath: "/providers/fireworks",
+		auth: [{
+			methodId: "api-key",
+			label: "Fireworks API key",
+			hint: "API key",
+			optionKey: "fireworksApiKey",
+			flagName: "--fireworks-api-key",
+			envVar: "FIREWORKS_API_KEY",
+			promptMessage: "Enter Fireworks API key",
+			defaultModel: FIREWORKS_DEFAULT_MODEL_REF,
+			applyConfig: (cfg) => applyFireworksConfig(cfg)
+		}],
+		catalog: {
+			buildProvider: buildFireworksProvider,
+			allowExplicitBaseUrl: true
+		},
+		...OPENAI_COMPATIBLE_REPLAY_HOOKS,
+		wrapStreamFn: wrapFireworksProviderStream,
+		resolveThinkingProfile: ({ modelId }) => resolveFireworksThinkingProfile(modelId),
+		resolveDynamicModel: (ctx) => resolveFireworksDynamicModel(ctx),
+		isModernModelRef: () => true
+	}
+});
+//#endregion
+export { fireworks_default as default };

package/dist/model-id.js

@@ -0,0 +1,8 @@
+//#region extensions/fireworks/model-id.ts
+function isFireworksKimiModelId(modelId) {
+	const normalized = modelId.trim().toLowerCase();
+	const lastSegment = normalized.split("/").pop() ?? normalized;
+	return /^kimi-k2(?:p[56]|[.-][56])(?:[-_].+)?$/.test(lastSegment);
+}
+//#endregion
+export { isFireworksKimiModelId };

package/dist/onboard.js

@@ -0,0 +1,26 @@
+import { a as buildFireworksCatalogModels, i as FIREWORKS_DEFAULT_MODEL_ID, o as buildFireworksProvider } from "./provider-catalog-DfjnZjS3.js";
+import { createDefaultModelsPresetAppliers } from "openclaw/plugin-sdk/provider-onboard";
+//#region extensions/fireworks/onboard.ts
+const FIREWORKS_DEFAULT_MODEL_REF = `fireworks/${FIREWORKS_DEFAULT_MODEL_ID}`;
+const fireworksPresetAppliers = createDefaultModelsPresetAppliers({
+	primaryModelRef: FIREWORKS_DEFAULT_MODEL_REF,
+	resolveParams: (_cfg) => {
+		const defaultProvider = buildFireworksProvider();
+		return {
+			providerId: "fireworks",
+			api: defaultProvider.api ?? "openai-completions",
+			baseUrl: defaultProvider.baseUrl,
+			defaultModels: buildFireworksCatalogModels(),
+			defaultModelId: FIREWORKS_DEFAULT_MODEL_ID,
+			aliases: [{
+				modelRef: FIREWORKS_DEFAULT_MODEL_REF,
+				alias: "Kimi K2.5 Turbo"
+			}]
+		};
+	}
+});
+function applyFireworksConfig(cfg) {
+	return fireworksPresetAppliers.applyConfig(cfg);
+}
+//#endregion
+export { FIREWORKS_DEFAULT_MODEL_REF, applyFireworksConfig };

package/dist/provider-catalog-DfjnZjS3.js

@@ -0,0 +1,67 @@
+import { buildManifestModelProviderConfig } from "openclaw/plugin-sdk/provider-catalog-shared";
+//#region extensions/fireworks/openclaw.plugin.json
+var modelCatalog = {
+	"providers": { "fireworks": {
+		"baseUrl": "https://api.fireworks.ai/inference/v1",
+		"api": "openai-completions",
+		"models": [{
+			"id": "accounts/fireworks/models/kimi-k2p6",
+			"name": "Kimi K2.6",
+			"reasoning": false,
+			"input": ["text", "image"],
+			"contextWindow": 262144,
+			"maxTokens": 262144,
+			"cost": {
+				"input": .95,
+				"output": 4,
+				"cacheRead": 0,
+				"cacheWrite": 0
+			}
+		}, {
+			"id": "accounts/fireworks/routers/kimi-k2p5-turbo",
+			"name": "Kimi K2.5 Turbo (Fire Pass)",
+			"reasoning": false,
+			"input": ["text", "image"],
+			"contextWindow": 256e3,
+			"maxTokens": 256e3,
+			"compat": { "unsupportedToolSchemaKeywords": ["not"] },
+			"cost": {
+				"input": 0,
+				"output": 0,
+				"cacheRead": 0,
+				"cacheWrite": 0
+			}
+		}]
+	} },
+	"discovery": { "fireworks": "static" }
+};
+//#endregion
+//#region extensions/fireworks/provider-catalog.ts
+const FIREWORKS_MANIFEST_PROVIDER = buildManifestModelProviderConfig({
+	providerId: "fireworks",
+	catalog: modelCatalog.providers.fireworks
+});
+const FIREWORKS_BASE_URL = FIREWORKS_MANIFEST_PROVIDER.baseUrl;
+const FIREWORKS_DEFAULT_MODEL_ID = "accounts/fireworks/routers/kimi-k2p5-turbo";
+function requireFireworksManifestModel(id) {
+	const model = FIREWORKS_MANIFEST_PROVIDER.models.find((entry) => entry.id === id);
+	if (!model) throw new Error(`Missing Fireworks modelCatalog row ${id}`);
+	return model;
+}
+const FIREWORKS_DEFAULT_MODEL = requireFireworksManifestModel(FIREWORKS_DEFAULT_MODEL_ID);
+const FIREWORKS_DEFAULT_CONTEXT_WINDOW = FIREWORKS_DEFAULT_MODEL.contextWindow;
+const FIREWORKS_DEFAULT_MAX_TOKENS = FIREWORKS_DEFAULT_MODEL.maxTokens;
+function isFireworksCatalogModelId(modelId) {
+	return FIREWORKS_MANIFEST_PROVIDER.models.some((model) => model.id === modelId);
+}
+function buildFireworksCatalogModels() {
+	return FIREWORKS_MANIFEST_PROVIDER.models.map((model) => structuredClone(model));
+}
+function buildFireworksProvider() {
+	return buildManifestModelProviderConfig({
+		providerId: "fireworks",
+		catalog: modelCatalog.providers.fireworks
+	});
+}
+//#endregion
+export { buildFireworksCatalogModels as a, FIREWORKS_DEFAULT_MODEL_ID as i, FIREWORKS_DEFAULT_CONTEXT_WINDOW as n, buildFireworksProvider as o, FIREWORKS_DEFAULT_MAX_TOKENS as r, isFireworksCatalogModelId as s, FIREWORKS_BASE_URL as t };

package/dist/provider-catalog.js

@@ -0,0 +1,2 @@
+import { a as buildFireworksCatalogModels, i as FIREWORKS_DEFAULT_MODEL_ID, n as FIREWORKS_DEFAULT_CONTEXT_WINDOW, o as buildFireworksProvider, r as FIREWORKS_DEFAULT_MAX_TOKENS, s as isFireworksCatalogModelId, t as FIREWORKS_BASE_URL } from "./provider-catalog-DfjnZjS3.js";
+export { FIREWORKS_BASE_URL, FIREWORKS_DEFAULT_CONTEXT_WINDOW, FIREWORKS_DEFAULT_MAX_TOKENS, FIREWORKS_DEFAULT_MODEL_ID, buildFireworksCatalogModels, buildFireworksProvider, isFireworksCatalogModelId };

package/dist/provider-policy-api.js

@@ -0,0 +1,7 @@
+import { resolveFireworksThinkingProfile } from "./thinking-policy.js";
+//#region extensions/fireworks/provider-policy-api.ts
+function resolveThinkingProfile(params) {
+	return resolveFireworksThinkingProfile(params.modelId);
+}
+//#endregion
+export { resolveThinkingProfile };

package/dist/stream.js

@@ -0,0 +1,24 @@
+import { isFireworksKimiModelId } from "./model-id.js";
+import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared";
+import { streamSimple } from "openclaw/plugin-sdk/llm";
+import { streamWithPayloadPatch } from "openclaw/plugin-sdk/provider-stream-shared";
+//#region extensions/fireworks/stream.ts
+function isFireworksProviderId(providerId) {
+	const normalized = normalizeProviderId(providerId);
+	return normalized === "fireworks" || normalized === "fireworks-ai";
+}
+function createFireworksKimiThinkingDisabledWrapper(baseStreamFn) {
+	const underlying = baseStreamFn ?? streamSimple;
+	return (model, context, options) => streamWithPayloadPatch(underlying, model, context, options, (payloadObj) => {
+		payloadObj.thinking = { type: "disabled" };
+		delete payloadObj.reasoning;
+		delete payloadObj.reasoning_effort;
+		delete payloadObj.reasoningEffort;
+	});
+}
+function wrapFireworksProviderStream(ctx) {
+	if (!isFireworksProviderId(ctx.provider) || ctx.model?.api !== "openai-completions" || !isFireworksKimiModelId(ctx.modelId)) return;
+	return createFireworksKimiThinkingDisabledWrapper(ctx.streamFn);
+}
+//#endregion
+export { createFireworksKimiThinkingDisabledWrapper, wrapFireworksProviderStream };

package/dist/thinking-policy.js

@@ -0,0 +1,12 @@
+import { isFireworksKimiModelId } from "./model-id.js";
+//#region extensions/fireworks/thinking-policy.ts
+const FIREWORKS_KIMI_THINKING_PROFILE = {
+	levels: [{ id: "off" }],
+	defaultLevel: "off"
+};
+function resolveFireworksThinkingProfile(modelId) {
+	if (!isFireworksKimiModelId(modelId)) return;
+	return FIREWORKS_KIMI_THINKING_PROFILE;
+}
+//#endregion
+export { resolveFireworksThinkingProfile };

package/npm-shrinkwrap.json

@@ -0,0 +1,12 @@
+{
+  "name": "@openclaw/fireworks-provider",
+  "version": "2026.6.11",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@openclaw/fireworks-provider",
+      "version": "2026.6.11"
+    }
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,80 @@
+{
+  "id": "fireworks",
+  "activation": {
+    "onStartup": false
+  },
+  "enabledByDefault": true,
+  "providers": ["fireworks"],
+  "setup": {
+    "providers": [
+      {
+        "id": "fireworks",
+        "envVars": ["FIREWORKS_API_KEY"]
+      }
+    ]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "fireworks",
+      "method": "api-key",
+      "choiceId": "fireworks-api-key",
+      "choiceLabel": "Fireworks API key",
+      "groupId": "fireworks",
+      "groupLabel": "Fireworks",
+      "groupHint": "API key",
+      "optionKey": "fireworksApiKey",
+      "cliFlag": "--fireworks-api-key",
+      "cliOption": "--fireworks-api-key <key>",
+      "cliDescription": "Fireworks API key"
+    }
+  ],
+  "modelCatalog": {
+    "providers": {
+      "fireworks": {
+        "baseUrl": "https://api.fireworks.ai/inference/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "accounts/fireworks/models/kimi-k2p6",
+            "name": "Kimi K2.6",
+            "reasoning": false,
+            "input": ["text", "image"],
+            "contextWindow": 262144,
+            "maxTokens": 262144,
+            "cost": {
+              "input": 0.95,
+              "output": 4,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          },
+          {
+            "id": "accounts/fireworks/routers/kimi-k2p5-turbo",
+            "name": "Kimi K2.5 Turbo (Fire Pass)",
+            "reasoning": false,
+            "input": ["text", "image"],
+            "contextWindow": 256000,
+            "maxTokens": 256000,
+            "compat": {
+              "unsupportedToolSchemaKeywords": ["not"]
+            },
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          }
+        ]
+      }
+    },
+    "discovery": {
+      "fireworks": "static"
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,13 +1,50 @@
 {
   "name": "@openclaw/fireworks-provider",
-  "version": "0.0.0",
-  "description": "Bootstrap reservation for the OpenClaw Fireworks provider package.",
+  "version": "2026.6.11",
+  "description": "OpenClaw Fireworks provider plugin",
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/fireworks-provider",
+      "npmSpec": "@openclaw/fireworks-provider",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.6.9"
+    },
+    "compat": {
+      "pluginApi": ">=2026.6.11"
+    },
+    "build": {
+      "openclawVersion": "2026.6.11",
+      "bundledDist": false
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/openclaw/openclaw.git"
+    "url": "https://github.com/openclaw/openclaw"
+  },
+  "files": [
+    "dist/**",
+    "openclaw.plugin.json",
+    "npm-shrinkwrap.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "openclaw": ">=2026.6.11"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
   },
-  "license": "Apache-2.0",
-  "publishConfig": {
-    "access": "public"
-  }
+  "bundledDependencies": []
 }