/**

* Analyzes injected workspace bootstrap files and builds warnings when context

* was truncated before an agent sees it.

*/

import path from "node:path";

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import type { EmbeddedContextFile } from "./embedded-agent-helpers.js";

return next.slice(-DEFAULT_BOOTSTRAP_PROMPT_WARNING_SIGNATURE_HISTORY_MAX);

}

/** Restores prompt-warning dedupe state from a previous bootstrap report. */

export function resolveBootstrapWarningSignaturesSeen(report?: {

bootstrapTruncation?: {

warningMode?: BootstrapPromptWarningMode;

return single ? [single] : [];

}

/** Compares raw bootstrap files with the injected context files the agent received. */

export function buildBootstrapInjectionStats(params: {

bootstrapFiles: WorkspaceBootstrapFile[];

injectedFiles: EmbeddedContextFile[];

});

}

/** Classifies bootstrap truncation and near-limit pressure for prompt/report output. */

export function analyzeBootstrapBudget(params: {

files: BootstrapInjectionStat[];

bootstrapMaxChars: number;

};

}

/** Builds a stable signature for once-per-truncation warning suppression. */

export function buildBootstrapTruncationSignature(

analysis: BootstrapBudgetAnalysis,

): string | undefined {

});

}

/** Formats human-readable warning lines for the most important truncated files. */

export function formatBootstrapTruncationWarningLines(params: {

analysis: BootstrapBudgetAnalysis;

maxFiles?: number;

return lines;

}

/** Decides whether to show a prompt warning and returns the updated dedupe state. */

export function buildBootstrapPromptWarning(params: {

analysis: BootstrapBudgetAnalysis;

mode: BootstrapPromptWarningMode;

};

}

/** Appends a detailed truncation warning block to the agent prompt when needed. */

export function appendBootstrapPromptWarning(

prompt: string,

warningLines?: string[],

return prompt ? `${prompt}\n\n${warningBlock}` : warningBlock;

}

/** Builds the compact truncation notice mirrored into run metadata. */

export function buildBootstrapPromptWarningNotice(warningLines?: string[]): string | undefined {

const hasWarning = (warningLines ?? []).some((line) => line.trim().length > 0);

if (!hasWarning) {

].join("\n");

}

/** Serializes truncation warning state for run reports and future dedupe. */

export function buildBootstrapTruncationReportMeta(params: {

analysis: BootstrapBudgetAnalysis;

warningMode: BootstrapPromptWarningMode;