@ -18,16 +18,27 @@ import type {
IngestBatchResult ,
IngestResult ,
} from "../../../context-engine/types.js" ;
import type { EmbeddedContextFile } from "../../pi-embedded-helpers.js" ;
import { createHostSandboxFsBridge } from "../../test-helpers/host-sandbox-fs-bridge.js" ;
import { createPiToolsSandboxContext } from "../../test-helpers/pi-tools-sandbox-context.js" ;
import type { WorkspaceBootstrapFile } from "../../workspace.js" ;
const hoisted = vi . hoisted ( ( ) = > {
type BootstrapContext = {
bootstrapFiles : WorkspaceBootstrapFile [ ] ;
contextFiles : EmbeddedContextFile [ ] ;
} ;
const spawnSubagentDirectMock = vi . fn ( ) ;
const createAgentSessionMock = vi . fn ( ) ;
const sessionManagerOpenMock = vi . fn ( ) ;
const resolveSandboxContextMock = vi . fn ( ) ;
const subscribeEmbeddedPiSessionMock = vi . fn ( ) ;
const acquireSessionWriteLockMock = vi . fn ( ) ;
const resolveBootstrapContextForRunMock = vi . fn < ( ) = > Promise < BootstrapContext > > ( async ( ) = > ( {
bootstrapFiles : [ ] ,
contextFiles : [ ] ,
} ) ) ;
const getGlobalHookRunnerMock = vi . fn < ( ) = > unknown > ( ( ) = > undefined ) ;
const sessionManager = {
getLeafEntry : vi.fn ( ( ) = > null ) ,
branch : vi.fn ( ) ,
@ -42,6 +53,8 @@ const hoisted = vi.hoisted(() => {
resolveSandboxContextMock ,
subscribeEmbeddedPiSessionMock ,
acquireSessionWriteLockMock ,
resolveBootstrapContextForRunMock ,
getGlobalHookRunnerMock ,
sessionManager ,
} ;
} ) ;
@ -80,7 +93,7 @@ vi.mock("../../pi-embedded-subscribe.js", () => ({
} ) ) ;
vi . mock ( "../../../plugins/hook-runner-global.js" , ( ) = > ( {
getGlobalHookRunner : ( ) = > undefined ,
getGlobalHookRunner : hoisted.getGlobalHookRunnerMock ,
} ) ) ;
vi . mock ( "../../../infra/machine-name.js" , ( ) = > ( {
@ -94,7 +107,7 @@ vi.mock("../../../infra/net/undici-global-dispatcher.js", () => ({
vi . mock ( "../../bootstrap-files.js" , ( ) = > ( {
makeBootstrapWarn : ( ) = > ( ) = > { } ,
resolveBootstrapContextForRun : async ( ) = > ( { bootstrapFiles : [ ] , contextFiles : [ ] } ) ,
resolveBootstrapContextForRun : hoisted.resolveBootstrapContextForRunMock ,
} ) ) ;
vi . mock ( "../../skills.js" , ( ) = > ( {
@ -269,6 +282,11 @@ function resetEmbeddedAttemptHarness(
hoisted . acquireSessionWriteLockMock . mockReset ( ) . mockResolvedValue ( {
release : async ( ) = > { } ,
} ) ;
hoisted . resolveBootstrapContextForRunMock . mockReset ( ) . mockResolvedValue ( {
bootstrapFiles : [ ] ,
contextFiles : [ ] ,
} ) ;
hoisted . getGlobalHookRunnerMock . mockReset ( ) . mockReturnValue ( undefined ) ;
hoisted . sessionManager . getLeafEntry . mockReset ( ) . mockReturnValue ( null ) ;
hoisted . sessionManager . branch . mockReset ( ) ;
hoisted . sessionManager . resetLeaf . mockReset ( ) ;
@ -291,7 +309,11 @@ async function cleanupTempPaths(tempPaths: string[]) {
}
function createDefaultEmbeddedSession ( params ? : {
prompt ? : ( session : MutableSession ) = > Promise < void > ;
prompt ? : (
session : MutableSession ,
prompt : string ,
options ? : { images? : unknown [ ] } ,
) = > Promise < void > ;
} ) : MutableSession {
const session : MutableSession = {
sessionId : "embedded-session" ,
@ -303,9 +325,9 @@ function createDefaultEmbeddedSession(params?: {
session . messages = [ . . . messages ] ;
} ,
} ,
prompt : async ( ) = > {
prompt : async ( prompt , options ) = > {
if ( params ? . prompt ) {
await params . prompt ( session );
await params . prompt ( session , prompt , options );
return ;
}
session . messages = [
@ -450,6 +472,90 @@ describe("runEmbeddedAttempt sessions_spawn workspace inheritance", () => {
} ) ;
} ) ;
describe ( "runEmbeddedAttempt bootstrap warning prompt assembly" , ( ) = > {
const tempPaths : string [ ] = [ ] ;
beforeEach ( ( ) = > {
resetEmbeddedAttemptHarness ( {
subscribeImpl : createSubscriptionMock ,
} ) ;
} ) ;
afterEach ( async ( ) = > {
await cleanupTempPaths ( tempPaths ) ;
} ) ;
it ( "keeps bootstrap warnings in the sent prompt after hook prepend context" , async ( ) = > {
const workspaceDir = await fs . mkdtemp ( path . join ( os . tmpdir ( ) , "openclaw-warning-workspace-" ) ) ;
const agentDir = await fs . mkdtemp ( path . join ( os . tmpdir ( ) , "openclaw-warning-agent-dir-" ) ) ;
const sessionFile = path . join ( workspaceDir , "session.jsonl" ) ;
tempPaths . push ( workspaceDir , agentDir ) ;
await fs . writeFile ( sessionFile , "" , "utf8" ) ;
hoisted . resolveBootstrapContextForRunMock . mockResolvedValue ( {
bootstrapFiles : [
{
name : "AGENTS.md" ,
path : path.join ( workspaceDir , "AGENTS.md" ) ,
content : "A" . repeat ( 200 ) ,
missing : false ,
} ,
] ,
contextFiles : [ { path : "AGENTS.md" , content : "A" . repeat ( 20 ) } ] ,
} ) ;
hoisted . getGlobalHookRunnerMock . mockReturnValue ( {
hasHooks : ( hookName : string ) = > hookName === "before_prompt_build" ,
runBeforePromptBuild : async ( ) = > ( { prependContext : "hook context" } ) ,
} ) ;
let seenPrompt = "" ;
hoisted . createAgentSessionMock . mockImplementation ( async ( ) = > ( {
session : createDefaultEmbeddedSession ( {
prompt : async ( session , prompt ) = > {
seenPrompt = prompt ;
session . messages = [
. . . session . messages ,
{ role : "assistant" , content : "done" , timestamp : 2 } ,
] ;
} ,
} ) ,
} ) ) ;
const result = await runEmbeddedAttempt ( {
sessionId : "embedded-session" ,
sessionKey : "agent:main:main" ,
sessionFile ,
workspaceDir ,
agentDir ,
config : {
agents : {
defaults : {
bootstrapMaxChars : 50 ,
bootstrapTotalMaxChars : 50 ,
} ,
} ,
} ,
prompt : "hello" ,
timeoutMs : 10_000 ,
runId : "run-warning" ,
provider : "openai" ,
modelId : "gpt-test" ,
model : testModel ,
authStorage : { } as AuthStorage ,
modelRegistry : { } as ModelRegistry ,
thinkLevel : "off" ,
senderIsOwner : true ,
disableMessageTool : true ,
} ) ;
expect ( result . promptError ) . toBeNull ( ) ;
expect ( seenPrompt ) . toContain ( "hook context" ) ;
expect ( seenPrompt ) . toContain ( "[Bootstrap truncation warning]" ) ;
expect ( seenPrompt ) . toContain ( "- AGENTS.md: 200 raw -> 20 injected" ) ;
expect ( seenPrompt ) . toContain ( "hello" ) ;
} ) ;
} ) ;
describe ( "runEmbeddedAttempt cache-ttl tracking after compaction" , ( ) = > {
const tempPaths : string [ ] = [ ] ;