openclaw/dist/error-format-Cae7EwnT.js

Multi-channel AI gateway with extensible messaging integrations

import { r as truncateUtf16Safe } from "./utf16-slice-D_ngcYKd.js";
import { t as formatCliCommand } from "./command-format-C7YfyMTd.js";
//#region src/cli/error-format.ts
const DEFAULT_GATEWAY_PORT_EXAMPLE = 18789;
function formatInlineCliCommand(command) {
	return `\`${formatCliCommand(command)}\``;
}
/** Explain the valid TCP port range with a concrete example. */
function formatPortRangeHint(example = DEFAULT_GATEWAY_PORT_EXAMPLE) {
	return `Use a port number from 1 to 65535, for example ${example}.`;
}
/** Format an invalid CLI port option using the shared port-range hint. */
function formatInvalidPortOption(option, example = DEFAULT_GATEWAY_PORT_EXAMPLE) {
	return `Invalid ${option}. ${formatPortRangeHint(example)}`;
}
/** Explain a bad configured port and include the equivalent CLI override. */
function formatInvalidConfigPort(path, example = DEFAULT_GATEWAY_PORT_EXAMPLE) {
	return `Invalid ${path} in config. Set ${path} to a number from 1 to 65535, or pass --port ${example}.`;
}
/** Format the standard missing-channel error plus channel-list recovery command. */
function formatUnknownChannelMessage(params) {
	const purpose = params.purpose ? ` for ${params.purpose}` : "";
	const listCommand = params.listCommand ?? "openclaw channels list --all";
	return `Unknown channel "${params.channel}"${purpose}. Run ${formatInlineCliCommand(listCommand)} to see configured and installable channels.`;
}
/** Format a channel capability miss with the inspection command for that channel. */
function formatUnsupportedChannelActionMessage(params) {
	const inspectCommand = params.inspectCommand ?? `openclaw channels capabilities --channel ${params.channel}`;
	return `Channel "${params.channel}" does not support ${params.action}. Run ${formatInlineCliCommand(inspectCommand)} to inspect supported actions.`;
}
/** Format strict JSON parsing failures without exposing long untrusted input verbatim. */
function formatStrictJsonParseFailure(params) {
	const cause = (params.cause instanceof Error ? params.cause.message : String(params.cause)).trim().replace(/[.。]+$/u, "");
	const preview = params.value.length > 48 ? `${truncateUtf16Safe(params.value, 45).trimEnd()}...` : params.value;
	return [
		`Could not parse ${JSON.stringify(preview)} as JSON for --strict-json.`,
		`${cause}.`,
		`Use valid JSON. For structured changes, use a JSON5 config patch object file with ${formatInlineCliCommand("openclaw config patch --file <path> --dry-run")}.`,
		"For plain strings, omit --strict-json."
	].join(" ");
}
/** Normalize gateway failure text and attach the deep-status recovery command. */
function formatGatewayCommandFailure(params) {
	const message = (params.error instanceof Error ? params.error.message : String(params.error)).replace(/\s*Run [`"]?openclaw doctor[`"]? for diagnostics\.?/gi, "").replace(/\s+Gateway target:\s+.*$/isu, "").replace(/\s+/g, " ").trim().replace(/[.。]+$/u, "");
	const inspectCommand = params.inspectCommand ?? "openclaw gateway status --deep";
	const detail = message ? `: ${message}` : "";
	return `Could not ${params.action} because the Gateway did not respond${detail}. Run ${formatInlineCliCommand(inspectCommand)} to inspect the active Gateway.`;
}
/** Format a generic lookup miss with the list command that can recover it. */
function formatLookupMiss(params) {
	const valueLabel = params.valueLabel ?? params.noun.toLowerCase();
	return `${params.noun} not found: ${params.value}. Run ${formatInlineCliCommand(params.listCommand)} to see recent ${valueLabel}s.`;
}
/** Format a plugin lookup miss with optional ClawHub search guidance. */
function formatMissingPluginMessage(params) {
	const listCommand = params.listCommand ?? "openclaw plugins list";
	const searchHint = params.includeSearch ? `, or ${formatInlineCliCommand("openclaw plugins search " + params.id)} to look for installable plugins` : "";
	return `Plugin not found: ${params.id}. Run ${formatInlineCliCommand(listCommand)} to see installed plugins${searchHint}.`;
}
//#endregion
export { formatMissingPluginMessage as a, formatUnknownChannelMessage as c, formatLookupMiss as i, formatUnsupportedChannelActionMessage as l, formatInvalidConfigPort as n, formatPortRangeHint as o, formatInvalidPortOption as r, formatStrictJsonParseFailure as s, formatGatewayCommandFailure as t };