feat: lightweight bootstrap context mode for heartbeat/cron runs (openclaw#26064) thanks @jose-velez

Verified:
- pnpm build
- pnpm check (fails on pre-existing unrelated repo issues in extensions/diffs and src/agents/tools/nodes-tool.test.ts)
- pnpm vitest run src/agents/bootstrap-files.test.ts src/infra/heartbeat-runner.model-override.test.ts src/cli/cron-cli.test.ts
- pnpm test:macmini (fails on pre-existing extensions/diffs import errors; touched suites pass)

Co-authored-by: jose-velez <10926182+jose-velez@users.noreply.github.com>
Co-authored-by: Tak Hoffman <781889+Takhoffman@users.noreply.github.com>
This commit is contained in:
Jose E Velez
2026-03-01 21:13:24 -05:00
committed by GitHub
parent 0a182bb4d1
commit 0c8fa63b93
17 changed files with 168 additions and 23 deletions

View File

@@ -13,6 +13,9 @@ import {
type WorkspaceBootstrapFile,
} from "./workspace.js";
export type BootstrapContextMode = "full" | "lightweight";
export type BootstrapContextRunKind = "default" | "heartbeat" | "cron";
export function makeBootstrapWarn(params: {
sessionLabel: string;
warn?: (message: string) => void;
@@ -41,6 +44,23 @@ function sanitizeBootstrapFiles(
return sanitized;
}
function applyContextModeFilter(params: {
files: WorkspaceBootstrapFile[];
contextMode?: BootstrapContextMode;
runKind?: BootstrapContextRunKind;
}): WorkspaceBootstrapFile[] {
const contextMode = params.contextMode ?? "full";
const runKind = params.runKind ?? "default";
if (contextMode !== "lightweight") {
return params.files;
}
if (runKind === "heartbeat") {
return params.files.filter((file) => file.name === "HEARTBEAT.md");
}
// cron/default lightweight mode keeps bootstrap context empty on purpose.
return [];
}
export async function resolveBootstrapFilesForRun(params: {
workspaceDir: string;
config?: OpenClawConfig;
@@ -48,6 +68,8 @@ export async function resolveBootstrapFilesForRun(params: {
sessionId?: string;
agentId?: string;
warn?: (message: string) => void;
contextMode?: BootstrapContextMode;
runKind?: BootstrapContextRunKind;
}): Promise<WorkspaceBootstrapFile[]> {
const sessionKey = params.sessionKey ?? params.sessionId;
const rawFiles = params.sessionKey
@@ -56,7 +78,11 @@ export async function resolveBootstrapFilesForRun(params: {
sessionKey: params.sessionKey,
})
: await loadWorkspaceBootstrapFiles(params.workspaceDir);
const bootstrapFiles = filterBootstrapFilesForSession(rawFiles, sessionKey);
const bootstrapFiles = applyContextModeFilter({
files: filterBootstrapFilesForSession(rawFiles, sessionKey),
contextMode: params.contextMode,
runKind: params.runKind,
});
const updated = await applyBootstrapHookOverrides({
files: bootstrapFiles,
@@ -76,6 +102,8 @@ export async function resolveBootstrapContextForRun(params: {
sessionId?: string;
agentId?: string;
warn?: (message: string) => void;
contextMode?: BootstrapContextMode;
runKind?: BootstrapContextRunKind;
}): Promise<{
bootstrapFiles: WorkspaceBootstrapFile[];
contextFiles: EmbeddedContextFile[];