cline/cline · error

settings payload '${key}' must be a string.

Error message

settings payload '${key}' must be a string.

What it means

Error "settings payload '${key}' must be a string." thrown in cline/cline.

Source

Thrown at sdk/packages/core/src/hub/server/hub-server-transport.ts:151

	"plugins",
	"tools",
	"mcp",
]);

function isPayloadObject(value: unknown): value is Record<string, unknown> {
	return typeof value === "object" && value !== null && !Array.isArray(value);
}

function requireOptionalString(
	payload: Record<string, unknown>,
	key: "cwd" | "workspaceRoot" | "id" | "path" | "name",
): string | undefined {
	const value = payload[key];
	if (value === undefined) {
		return undefined;
	}
	if (typeof value !== "string") {
		throw new Error(`settings payload '${key}' must be a string.`);
	}
	return value;
}

function requireOptionalBoolean(
	payload: Record<string, unknown>,
	key: "enabled",
): boolean | undefined {
	const value = payload[key];
	if (value === undefined) {
		return undefined;
	}
	if (typeof value !== "boolean") {
		throw new Error(`settings payload '${key}' must be a boolean.`);
	}
	return value;
}

View on GitHub (pinned to 491b30b806)

When it happens

Trigger: Thrown at sdk/packages/core/src/hub/server/hub-server-transport.ts:151 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cline/cline@491b30b806 (2026-08-25). Data as JSON: /api/errors/d7a202feaeebc42b. Report an issue: GitHub.