createSystemPromptOverride,

} from "../system-prompt.js";

import { dropThinkingBlocks } from "../thinking.js";

import { collectAllowedToolNames } from "../tool-name-allowlist.js";

import {

collectAllowedToolNames,

collectRegisteredToolNames,

PI_RESERVED_TOOL_NAMES,

toSessionToolAllowlist,

} from "../tool-name-allowlist.js";

import {

installContextEngineLoopHook,

installToolResultContextGuard,

// Get hook runner early so it's available when creating tools

const hookRunner = getGlobalHookRunner();

const { builtInTools, customTools } = splitSdkTools({

const { customTools } = splitSdkTools({

tools: effectiveTools,

sandboxEnabled: !!sandbox?.enabled,

});

);

const clientToolNameConflicts = findClientToolNameConflicts({

tools: clientTools ?? [],

existingToolNames: coreBuiltinToolNames,

existingToolNames: [...coreBuiltinToolNames, ...PI_RESERVED_TOOL_NAMES],

});

if (clientToolNameConflicts.length > 0) {

throw createClientToolNameConflictError(clientToolNameConflicts);

: [];

const allCustomTools = [...customTools, ...clientToolDefs];

// OpenClaw registers filtered tools through `customTools`; keep Pi's

// built-in tool list empty so the SDK does not re-enable defaults.

// Pi 0.68.1 uses `tools` as a global allowlist across built-in and

// custom tools. Keep the built-in tool list empty, but still pass the

// exact registered custom-tool names so our OpenClaw-managed

// registrations remain active without widening the session boundary to

// raw client-provided names.

const sessionToolAllowlist = toSessionToolAllowlist(

collectRegisteredToolNames(allCustomTools),

);

({ session } = await createEmbeddedAgentSessionWithResourceLoader({

createAgentSession: async (options) =>

modelRegistry: params.modelRegistry,

model: params.model,

thinkingLevel: mapThinkingLevel(params.thinkLevel),

tools: builtInTools,

tools: sessionToolAllowlist,

customTools: allCustomTools,

sessionManager,

settingsManager,

}

const cacheObservabilityEnabled = Boolean(cacheTrace) || log.isEnabled("debug");

const promptCacheToolNames = collectPromptCacheToolNames([

...builtInTools,

...allCustomTools,

] as Array<{ name?: string }>);

const promptCacheToolNames = collectPromptCacheToolNames(

allCustomTools as Array<{ name?: string }>,

);

let promptCacheChangesForTurn: PromptCacheChange[] | null = null;

if (cacheTrace) {