@openclaw/chutes-provider 0.0.0 → 2026.6.9

package/README.md

@@ -1,3 +1,12 @@
-# @openclaw/chutes-provider
+# OpenClaw Chutes Provider
 
-Reserved placeholder for the official OpenClaw plugin package. Use a published release version instead.
+Official OpenClaw provider plugin for Chutes.
+
+Install from OpenClaw:
+
+```bash
+openclaw plugins install @openclaw/chutes-provider
+openclaw gateway restart
+```
+
+See <https://docs.openclaw.ai/providers/chutes> for setup and configuration.

package/dist/api.js

@@ -0,0 +1,4 @@
+import { CHUTES_BASE_URL, CHUTES_DEFAULT_MODEL_ID, CHUTES_DEFAULT_MODEL_REF, CHUTES_MODEL_CATALOG, buildChutesModelDefinition, discoverChutesModels } from "./models.js";
+import { applyChutesApiKeyConfig, applyChutesConfig, applyChutesProviderConfig } from "./onboard.js";
+import { buildChutesProvider } from "./provider-catalog.js";
+export { CHUTES_BASE_URL, CHUTES_DEFAULT_MODEL_ID, CHUTES_DEFAULT_MODEL_REF, CHUTES_MODEL_CATALOG, applyChutesApiKeyConfig, applyChutesConfig, applyChutesProviderConfig, buildChutesModelDefinition, buildChutesProvider, discoverChutesModels };

package/dist/index.js

@@ -0,0 +1,149 @@
+import { loginChutes } from "./oauth.js";
+import { CHUTES_DEFAULT_MODEL_REF } from "./models.js";
+import { applyChutesApiKeyConfig, applyChutesProviderConfig } from "./onboard.js";
+import { buildChutesProvider, buildStaticChutesProvider } from "./provider-catalog.js";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { buildOauthProviderAuthResult, resolveOAuthApiKeyMarker } from "openclaw/plugin-sdk/provider-auth";
+import { createProviderApiKeyAuthMethod } from "openclaw/plugin-sdk/provider-auth-api-key";
+import { normalizeOptionalString, readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime";
+//#region extensions/chutes/index.ts
+/**
+* Chutes provider plugin entrypoint with OAuth and API-key auth methods.
+*/
+const PROVIDER_ID = "chutes";
+async function runChutesOAuth(ctx) {
+	const isRemote = ctx.isRemote;
+	const redirectUri = process.env.CHUTES_OAUTH_REDIRECT_URI?.trim() || "http://127.0.0.1:1456/oauth-callback";
+	const scopes = process.env.CHUTES_OAUTH_SCOPES?.trim() || "openid profile chutes:invoke";
+	const clientId = process.env.CHUTES_CLIENT_ID?.trim() || (await ctx.prompter.text({
+		message: "Enter Chutes OAuth client id",
+		placeholder: "cid_xxx",
+		validate: (value) => value?.trim() ? void 0 : "Required"
+	})).trim();
+	const clientSecret = normalizeOptionalString(process.env.CHUTES_CLIENT_SECRET);
+	await ctx.prompter.note(isRemote ? [
+		"You are running in a remote/VPS environment.",
+		"A URL will be shown for you to open in your LOCAL browser.",
+		"After signing in, paste the redirect URL back here.",
+		"",
+		`Redirect URI: ${redirectUri}`
+	].join("\n") : [
+		"Browser will open for Chutes authentication.",
+		"If the callback doesn't auto-complete, paste the redirect URL.",
+		"",
+		`Redirect URI: ${redirectUri}`
+	].join("\n"), "Chutes OAuth");
+	const progress = ctx.prompter.progress("Starting Chutes OAuth…");
+	try {
+		const { onAuth, onPrompt } = ctx.oauth.createVpsAwareHandlers({
+			isRemote,
+			prompter: ctx.prompter,
+			runtime: ctx.runtime,
+			spin: progress,
+			openUrl: ctx.openUrl,
+			localBrowserMessage: "Complete sign-in in browser…"
+		});
+		const creds = await loginChutes({
+			app: {
+				clientId,
+				clientSecret,
+				redirectUri,
+				scopes: scopes.split(/\s+/).filter(Boolean)
+			},
+			manual: isRemote,
+			onAuth,
+			onPrompt,
+			onProgress: (message) => progress.update(message)
+		});
+		progress.stop("Chutes OAuth complete");
+		return buildOauthProviderAuthResult({
+			providerId: PROVIDER_ID,
+			defaultModel: CHUTES_DEFAULT_MODEL_REF,
+			access: creds.access,
+			refresh: creds.refresh,
+			expires: creds.expires,
+			email: readStringValue(creds.email),
+			credentialExtra: {
+				clientId,
+				..."accountId" in creds && typeof creds.accountId === "string" ? { accountId: creds.accountId } : {}
+			},
+			configPatch: applyChutesProviderConfig({}),
+			notes: ["Chutes OAuth tokens auto-refresh. Re-run login if refresh fails or access is revoked.", `Redirect URI: ${redirectUri}`]
+		});
+	} catch (err) {
+		progress.stop("Chutes OAuth failed");
+		await ctx.prompter.note([
+			"Trouble with OAuth?",
+			"Verify CHUTES_CLIENT_ID (and CHUTES_CLIENT_SECRET if required).",
+			`Verify the OAuth app redirect URI includes: ${redirectUri}`,
+			"Chutes docs: https://chutes.ai/docs/sign-in-with-chutes/overview"
+		].join("\n"), "OAuth help");
+		throw err;
+	}
+}
+var chutes_default = definePluginEntry({
+	id: PROVIDER_ID,
+	name: "Chutes Provider",
+	description: "Bundled Chutes.ai provider plugin",
+	register(api) {
+		api.registerProvider({
+			id: PROVIDER_ID,
+			label: "Chutes",
+			docsPath: "/providers/chutes",
+			envVars: ["CHUTES_API_KEY", "CHUTES_OAUTH_TOKEN"],
+			auth: [{
+				id: "oauth",
+				label: "Chutes OAuth",
+				hint: "Browser sign-in",
+				kind: "oauth",
+				wizard: {
+					choiceId: "chutes",
+					choiceLabel: "Chutes (OAuth)",
+					choiceHint: "Browser sign-in",
+					groupId: "chutes",
+					groupLabel: "Chutes",
+					groupHint: "OAuth + API key"
+				},
+				run: async (ctx) => await runChutesOAuth(ctx)
+			}, createProviderApiKeyAuthMethod({
+				providerId: PROVIDER_ID,
+				methodId: "api-key",
+				label: "Chutes API key",
+				hint: "Open-source models including Llama, DeepSeek, and more",
+				optionKey: "chutesApiKey",
+				flagName: "--chutes-api-key",
+				envVar: "CHUTES_API_KEY",
+				promptMessage: "Enter Chutes API key",
+				noteTitle: "Chutes",
+				noteMessage: ["Chutes provides access to leading open-source models including Llama, DeepSeek, and more.", "Get your API key at: https://chutes.ai/settings/api-keys"].join("\n"),
+				defaultModel: CHUTES_DEFAULT_MODEL_REF,
+				expectedProviders: ["chutes"],
+				applyConfig: (cfg) => applyChutesApiKeyConfig(cfg),
+				wizard: {
+					choiceId: "chutes-api-key",
+					choiceLabel: "Chutes API key",
+					groupId: "chutes",
+					groupLabel: "Chutes",
+					groupHint: "OAuth + API key"
+				}
+			})],
+			catalog: {
+				order: "profile",
+				run: async (ctx) => {
+					const { apiKey, discoveryApiKey } = ctx.resolveProviderAuth(PROVIDER_ID, { oauthMarker: resolveOAuthApiKeyMarker(PROVIDER_ID) });
+					if (!apiKey) return null;
+					return { provider: {
+						...await buildChutesProvider(discoveryApiKey),
+						apiKey
+					} };
+				}
+			},
+			staticCatalog: {
+				order: "profile",
+				run: async () => ({ provider: buildStaticChutesProvider() })
+			}
+		});
+	}
+});
+//#endregion
+export { chutes_default as default };

package/dist/model-discovery-env.js

@@ -0,0 +1,10 @@
+//#region extensions/chutes/model-discovery-env.ts
+/**
+* Environment helper for Chutes model discovery behavior in tests.
+*/
+/** Returns whether dynamic Chutes model discovery should use test behavior. */
+function isChutesModelDiscoveryTestEnvironment(env = process.env) {
+	return env.NODE_ENV === "test" || env.VITEST === "true";
+}
+//#endregion
+export { isChutesModelDiscoveryTestEnvironment };