openclaw/dist/doctor-bootstrap-size-DnDimIGw.mjs

Multi-channel AI gateway with extensible messaging integrations

import { d as resolveAgentWorkspaceDir, w as tryResolveConfiguredAgentWorkspaceDir } from "./agent-scope-config-BU4qc9bA.mjs";
import { i as listAgentIds, o as tryResolveDefaultAgentId } from "./agent-roster-B45JERT5.mjs";
import { t as resolveDefaultAgentWorkspaceDir } from "./workspace-default-path-BG9KN4ds.mjs";
import "./workspace-default-CQbD5G-j.mjs";
import "./agent-scope-DWB4x52T.mjs";
import { t as note } from "./note-BpWs6H5N.mjs";
import { i as resolveBootstrapTotalMaxChars, r as resolveBootstrapMaxChars, t as USER_BOOTSTRAP_MAX_CHARS } from "./bootstrap-Q-AcdcrE.mjs";
import "./embedded-agent-helpers-DKuJhdd0.mjs";
import { o as isFixedUserCapFile, r as buildBootstrapInjectionStats, t as analyzeBootstrapBudget } from "./bootstrap-budget-aB9vu7j-.mjs";
import { o as resolveBootstrapContextWithProjectedHookFiles } from "./bootstrap-files-Dv5-lWCI.mjs";
import { t as loadDeclaredExtraBootstrapFiles } from "./declared-files-C_ZtMrkz.mjs";
import { t as loadWorkspaceHookEntries } from "./workspace-DtwjBExX.mjs";
import { r as resolveInternalHookSelection, t as isHookLoadable } from "./configured-9et3h1pT.mjs";
//#region src/agents/bootstrap-files-diagnostics.ts
function isBundledExtraFilesHookSelected(config) {
	if (!config) return false;
	const selection = resolveInternalHookSelection(config);
	if (!selection.configured) return false;
	const discoveryDir = tryResolveConfiguredAgentWorkspaceDir(config) ?? resolveDefaultAgentWorkspaceDir();
	const selected = loadWorkspaceHookEntries(discoveryDir, { config }).find((entry) => entry.hook.name === "bootstrap-extra-files");
	return selected?.hook.source === "openclaw-bundled" && isHookLoadable({
		entry: selected,
		config,
		names: selection.names
	});
}
/** Projects fresh-start bundled declarations without importing or invoking hook handlers. */
async function resolveBootstrapContextForDiagnostics(params) {
	if (!isBundledExtraFilesHookSelected(params.config)) return resolveBootstrapContextWithProjectedHookFiles(params, []);
	const declared = await loadDeclaredExtraBootstrapFiles({
		config: params.config,
		workspaceDir: params.workspaceDir
	});
	return resolveBootstrapContextWithProjectedHookFiles(params, declared.files);
}
//#endregion
//#region src/commands/doctor-bootstrap-size.ts
/** Doctor note for workspace bootstrap file size and truncation risk. */
let integerFormatter;
function formatInt(value) {
	return (integerFormatter ??= new Intl.NumberFormat("en-US")).format(Math.max(0, Math.floor(value)));
}
function formatPercent(numerator, denominator) {
	if (!Number.isFinite(denominator) || denominator <= 0) return "0%";
	return `${Math.min(100, Math.max(0, Math.round(numerator / denominator * 100)))}%`;
}
function formatCauses(causes) {
	if (causes.length === 0) return "unknown";
	return causes.map((cause) => cause === "per-file-limit" ? "max/file" : "max/total").join(", ");
}
async function collectBootstrapFileSize(cfg, workspaceDir, agentId) {
	const bootstrapMaxChars = resolveBootstrapMaxChars(cfg, agentId);
	const bootstrapTotalMaxChars = resolveBootstrapTotalMaxChars(cfg, agentId);
	const { bootstrapFiles, contextFiles } = await resolveBootstrapContextForDiagnostics({
		workspaceDir,
		config: cfg,
		agentId
	});
	return {
		bootstrapTotalMaxChars,
		analysis: analyzeBootstrapBudget({
			files: buildBootstrapInjectionStats({
				bootstrapFiles,
				injectedFiles: contextFiles
			}),
			bootstrapMaxChars,
			bootstrapTotalMaxChars
		})
	};
}
/**
* Analyzes configured bootstrap files and emits warnings when injection will truncate content.
*
* Returns the raw budget analysis for tests and callers that need structured evidence.
*/
async function noteBootstrapFileSize(cfg) {
	const defaultAgentId = tryResolveDefaultAgentId(cfg);
	const agentIds = listAgentIds(cfg);
	let defaultAnalysis;
	for (const agentId of agentIds) {
		const { analysis, bootstrapTotalMaxChars } = await collectBootstrapFileSize(cfg, resolveAgentWorkspaceDir(cfg, agentId), agentId);
		if (agentId === defaultAgentId) defaultAnalysis = analysis;
		if (!analysis.hasTruncation && analysis.nearLimitFiles.length === 0 && !analysis.totalNearLimit) continue;
		const lines = agentIds.length > 1 ? [`Agent "${agentId}":`] : [];
		if (analysis.hasTruncation) {
			lines.push("Workspace bootstrap files exceed limits and will be truncated:");
			for (const file of analysis.truncatedFiles) {
				const truncatedChars = Math.max(0, file.rawChars - file.injectedChars);
				lines.push(`- ${file.name}: ${formatInt(file.rawChars)} raw / ${formatInt(file.injectedChars)} injected (${formatPercent(truncatedChars, file.rawChars)} truncated; ${formatCauses(file.causes)})`);
			}
		} else lines.push("Workspace bootstrap files are near configured limits:");
		const nonTruncatedNearLimit = analysis.nearLimitFiles.filter((file) => !file.truncated);
		if (nonTruncatedNearLimit.length > 0) for (const file of nonTruncatedNearLimit) lines.push(`- ${file.name}: ${formatInt(file.rawChars)} chars (${formatPercent(file.rawChars, file.effectiveFileLimit)} of max/file ${formatInt(file.effectiveFileLimit)})`);
		lines.push(`Total bootstrap injected chars: ${formatInt(analysis.totals.injectedChars)} (${formatPercent(analysis.totals.injectedChars, bootstrapTotalMaxChars)} of max/total ${formatInt(bootstrapTotalMaxChars)}).`);
		lines.push(`Total bootstrap raw chars (before truncation): ${formatInt(analysis.totals.rawChars)}.`);
		const fixedUserCapApplied = analysis.truncatedFiles.some((file) => isFixedUserCapFile(file) && file.causes.includes("per-file-limit"));
		const fixedUserCapNearLimit = analysis.nearLimitFiles.some(isFixedUserCapFile);
		const fixedUserCapRelevant = fixedUserCapApplied || fixedUserCapNearLimit;
		const needsPerFileTip = analysis.truncatedFiles.some((file) => file.causes.includes("per-file-limit") && !isFixedUserCapFile(file)) || analysis.nearLimitFiles.some((file) => !isFixedUserCapFile(file));
		const needsTotalTip = analysis.truncatedFiles.some((file) => file.causes.includes("total-limit")) || analysis.totalNearLimit;
		if (needsPerFileTip || needsTotalTip || fixedUserCapRelevant) lines.push("");
		if (fixedUserCapRelevant) lines.push(`USER.md has a fixed ${formatInt(USER_BOOTSTRAP_MAX_CHARS)}-character bootstrap cap; keep it compact.`);
		if (needsPerFileTip) lines.push("- Tip: tune `agents.entries.*.bootstrapMaxChars` for this agent, or `agents.defaults.bootstrapMaxChars` as fallback, for per-file limits.");
		if (needsTotalTip) lines.push("- Tip: tune `agents.entries.*.bootstrapTotalMaxChars` for this agent, or `agents.defaults.bootstrapTotalMaxChars` as fallback, for total-budget limits.");
		note(lines.join("\n"), "Bootstrap file size");
	}
	return defaultAnalysis;
}
//#endregion
export { collectBootstrapFileSize, noteBootstrapFileSize };