(await readMirroredSessionHistoryMessages(params.sessionFile)) ?? historyMessages;

}

const baseDeveloperInstructions = buildDeveloperInstructions(params);

// Build the workspace bootstrap block before finalizing developer

// instructions so persona files (SOUL.md, IDENTITY.md, ...) reach Codex

// through the explicit `developerInstructions` field.

const workspaceBootstrapInstructions = await buildCodexWorkspaceBootstrapInstructions({

params,

resolvedWorkspace,

effectiveWorkspace,

sessionKey: sandboxSessionKey,

sessionAgentId,

});

let promptText = params.prompt;

let developerInstructions = baseDeveloperInstructions;

let developerInstructions = joinPresentSections(

baseDeveloperInstructions,

workspaceBootstrapInstructions,

);

let prePromptMessageCount = historyMessages.length;

if (activeContextEngine) {

try {

promptText = projection.promptText;

developerInstructions = joinPresentSections(

baseDeveloperInstructions,

workspaceBootstrapInstructions,

projection.developerInstructionAddition,

);

prePromptMessageCount = projection.prePromptMessageCount;

messages: historyMessages,

ctx: hookContext,

});

const workspaceBootstrapInstructions = await buildCodexWorkspaceBootstrapInstructions({

params,

resolvedWorkspace,

effectiveWorkspace,

sessionKey: sandboxSessionKey,

sessionAgentId,

});

const trajectoryRecorder = createCodexTrajectoryRecorder({

attempt: params,

cwd: effectiveWorkspace,

: options.nativeHookRelay?.enabled === false

? buildCodexNativeHookRelayDisabledConfig()

: undefined;

const threadConfig = mergeCodexConfigInstructions(

nativeHookRelayConfig,

workspaceBootstrapInstructions,

);

const threadConfig = nativeHookRelayConfig;

({ client, thread } = await withCodexStartupTimeout({

timeoutMs: params.timeoutMs,

timeoutFloorMs: options.startupTimeoutFloorMs,

return lines.join("\n").trim();

}

function mergeCodexConfigInstructions(

config: JsonObject | undefined,

instructions: string | undefined,

): JsonObject | undefined {

if (!instructions?.trim()) {

return config;

}

const merged: JsonObject = { ...config };

const existingInstructions =

typeof merged.instructions === "string" ? merged.instructions.trim() : undefined;

merged.instructions = joinPresentSections(existingInstructions, instructions);

return merged;

}

function remapCodexContextFilePath(params: {

file: EmbeddedContextFile;

sourceWorkspaceDir: string;