@prestyj/cli 5.4.0 → 5.5.0

package/dist/core/agent-session.d.ts

@@ -1,3 +1,4 @@
+import { type AgentTool } from "@prestyj/agent";
 import { type Message, type Provider, type ThinkingLevel } from "@prestyj/ai";
 import { EventBus } from "./event-bus.js";
 import { SlashCommandRegistry } from "./slash-commands.js";
@@ -20,9 +21,12 @@ export interface AgentSessionOptions {
     cwd: string;
     baseUrl?: string;
     systemPrompt?: string;
+    /** Synchronous volatile prompt suffix, refreshed immediately before every run. */
+    getSystemPromptTail?: () => string;
     sessionId?: string;
     continueRecent?: boolean;
     maxTokens?: number;
+    maxTurns?: number;
     thinkingLevel?: ThinkingLevel;
     signal?: AbortSignal;
     /** Prefix used for provider prompt-cache routing keys. */
@@ -94,6 +98,24 @@ export interface AgentSessionOptions {
      * main build session. Default (undefined) = follow `speedProfile`.
      */
     forceLongCacheRetention?: boolean;
+    /** Hidden persistent subagent workers omit the async orchestration tool suite. */
+    subagentWorker?: boolean;
+    /** Session storage root override. Chat agents use a dedicated namespace. */
+    sessionRootDir?: string;
+    /** Register EZ Coder built-in/prompt/custom slash commands. Defaults to true. */
+    coderSlashCommands?: boolean;
+    /** Enable loop-break, re-grounding, and Ideal review hooks. Defaults to true. */
+    selfCorrectionHooks?: boolean;
+    /** Load project skills/agents and create local .ezcoder directories. Defaults to true. */
+    projectCustomization?: boolean;
+    /** Register global + bundled subagents without loading project customization. */
+    globalSubagents?: boolean;
+    /** Load EZ Coder extensions. Defaults to true. */
+    loadExtensions?: boolean;
+    /** Inject EZ Coder's model-specific subagent orchestration prompt. Defaults to true. */
+    orchestrationPrompt?: boolean;
+    /** Host-provided tools appended to this session only (for example, chat delegation). */
+    additionalTools?: AgentTool[];
 }
 export interface AgentSessionState {
     provider: Provider;
@@ -139,12 +161,12 @@ export declare class AgentSession {
     private regroundingInjected;
     private compactionOccurred;
     private originalRequest;
-    /** True after the cache has been pre-warmed for this session. Ensures we only
-     *  fire the warm-up call once (before the first real turn). */
-    private cachePrewarmed;
     private userQueue;
     private processManager?;
     private lspManager?;
+    private subAgentManager?;
+    private managerAbortSignal?;
+    private readonly managerAbortHandler;
     private mcpManager?;
     /** Deferred MCP tools awaiting discovery via tool_search (bench A win). */
     private mcpCatalog?;
@@ -160,6 +182,8 @@ export declare class AgentSession {
     private maxTokens;
     private thinkingLevel?;
     private customSystemPrompt?;
+    /** Stable prompt prefix retained separately from the volatile uncached tail. */
+    private baseSystemPrompt;
     /** Shared with the tool layer so plan-mode restrictions read live state. */
     private planModeRef;
     /** Path of the approved plan currently being implemented, or undefined. When
@@ -167,6 +191,9 @@ export declare class AgentSession {
      *  model emits step-completion markers the UI's plan-progress widget reads. */
     private approvedPlanPath?;
     private sessionId;
+    /** Runtime conversation identity for provider transport headers. Transient
+     *  children need one even though they intentionally have no persisted session. */
+    private readonly transportSessionId;
     private sessionPath;
     private lastPersistedIndex;
     /** Current leaf entry ID in the session DAG — used to chain parentIds for branching. */
@@ -303,6 +330,8 @@ export declare class AgentSession {
     listBackgroundProcesses(): BackgroundProcess[];
     /** Stop a background process by id. Returns a human-readable status string. */
     killBackgroundProcess(id: string): Promise<string>;
+    /** Replace a host-owned system prompt in place without resetting conversation history. */
+    setCustomSystemPrompt(systemPrompt: string, promptCacheKeyPrefix?: string): void;
     /**
      * Toggle plan mode: flips the shared ref (so tools enforce read-only
      * restrictions) and rebuilds the system prompt in place so the model is told
@@ -319,6 +348,8 @@ export declare class AgentSession {
     setApprovedPlan(approvedPlanPath: string | undefined): Promise<void>;
     /** Rebuild messages[0] from current plan-mode + approved-plan state. */
     private rebuildSystemPromptInPlace;
+    private withSystemPromptTail;
+    private refreshSystemPromptTail;
     getMessages(): Message[];
     /** Nolan Grout (mentor) turns recorded against this session, in record order. Used
      *  by the host to interleave Nolan's advisory exchanges back into the transcript
@@ -397,8 +428,11 @@ export declare class AgentSession {
     /** Set the reasoning/thinking level (undefined turns thinking off). Takes
      * effect on the next prompt, since the in-flight loop reads it at start. */
     setThinkingLevel(level: ThinkingLevel | undefined): void;
+    /** Sol/Terra Ultra delegates proactively; lower levels require an explicit request. */
+    private syncUltraOrchestrationPrompt;
     /** Replace the abort signal (e.g. after cancellation). */
     setSignal(signal: AbortSignal): void;
+    private bindManagerCancellation;
     /** True when speedProfile is "optimized" (1-h cache TTL + pre-warm), or the
      *  session was constructed with `forceLongCacheRetention` (Nolan sessions). */
     private isSpeedOptimized;
@@ -410,11 +444,6 @@ export declare class AgentSession {
      * API-only `mimo-v2.5-pro-ultraspeed` has no fallback).
      */
     private currentAuthStorageKeys;
-    /** Fire a cache pre-warm request for Anthropic so the first real turn is a
-     *  cache read instead of a cold write. No-op for other providers and when
-     *  speedProfile is not "optimized". Entirely best-effort — any failure is
-     *  swallowed so prewarm never blocks or aborts the real prompt. */
-    private maybePrewarmCache;
     private getPromptCacheKey;
     /** Stable cache-routing key for downstream sub-agent processes. */
     getCurrentCacheKey(): string | undefined;

package/dist/core/agent-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../src/core/agent-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../src/core/agent-session.ts"],"names":[],"mappings":"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"}

package/dist/core/agent-session.js

@@ -1,5 +1,5 @@
 import { agentLoop, isAbortError } from "@prestyj/agent";
-import { ProviderError, prewarmAnthropicCache, } from "@prestyj/ai";
+import { ProviderError, } from "@prestyj/ai";
 import { EventBus } from "./event-bus.js";
 import { SlashCommandRegistry, createBuiltinCommands, } from "./slash-commands.js";
 import { PROMPT_COMMANDS, getPromptCommand } from "./prompt-commands.js";
@@ -16,6 +16,7 @@ import { discoverSkills } from "./skills.js";
 import { ensureAppDirs } from "../config.js";
 import { buildSystemPrompt } from "../system-prompt.js";
 import { createTools, createWebSearchTool, } from "../tools/index.js";
+import { applyAsyncSubagentPolicy } from "./subagent-policy.js";
 import { MCPClientManager, getAllMcpServers } from "./mcp/index.js";
 import { DeferredToolCatalog } from "./mcp/deferred-catalog.js";
 import { createToolSearchTool } from "../tools/tool-search.js";
@@ -89,9 +90,6 @@ export class AgentSession {
     regroundingInjected = false;
     compactionOccurred = false;
     originalRequest = "";
-    /** True after the cache has been pre-warmed for this session. Ensures we only
-     *  fire the warm-up call once (before the first real turn). */
-    cachePrewarmed = false;
     // Messages queued by the user while a run is in flight. Drained at the
     // mid-loop steering boundary (user steering wins over the hooks), mirroring
     // the TUI's getSteeringMessages. Each entry carries its own attachments so a
@@ -99,6 +97,11 @@ export class AgentSession {
     userQueue = [];
     processManager;
     lspManager;
+    subAgentManager;
+    managerAbortSignal;
+    managerAbortHandler = () => {
+        void this.subAgentManager?.interruptAll();
+    };
     mcpManager;
     /** Deferred MCP tools awaiting discovery via tool_search (bench A win). */
     mcpCatalog;
@@ -114,6 +117,8 @@ export class AgentSession {
     maxTokens;
     thinkingLevel;
     customSystemPrompt;
+    /** Stable prompt prefix retained separately from the volatile uncached tail. */
+    baseSystemPrompt = "";
     /** Shared with the tool layer so plan-mode restrictions read live state. */
     planModeRef = { current: false };
     /** Path of the approved plan currently being implemented, or undefined. When
@@ -121,6 +126,9 @@ export class AgentSession {
      *  model emits step-completion markers the UI's plan-progress widget reads. */
     approvedPlanPath;
     sessionId = "";
+    /** Runtime conversation identity for provider transport headers. Transient
+     *  children need one even though they intentionally have no persisted session. */
+    transportSessionId = crypto.randomUUID();
     sessionPath = "";
     lastPersistedIndex = 0;
     /** Current leaf entry ID in the session DAG — used to chain parentIds for branching. */
@@ -162,24 +170,34 @@ export class AgentSession {
         await this.settingsManager.load();
         this.authStorage = new AuthStorage(paths.authFile);
         await this.authStorage.load();
-        // Session manager
-        this.sessionManager = new SessionManager(paths.sessionsDir);
-        // Ensure project-local .ezcoder directories exist
-        const localEzDir = path.join(this.cwd, ".ezcoder");
-        await fs.mkdir(path.join(localEzDir, "skills"), { recursive: true });
-        await fs.mkdir(path.join(localEzDir, "commands"), { recursive: true });
-        await fs.mkdir(path.join(localEzDir, "agents"), { recursive: true });
-        // Discover skills
-        this.skills = await discoverSkills({
-            globalSkillsDir: paths.skillsDir,
-            projectDir: this.cwd,
-        });
-        // Discover agents and create tools (with sub-agent support)
-        const agents = await discoverAgents({
-            globalAgentsDir: paths.agentsDir,
-            projectDir: this.cwd,
-        });
-        const { tools, processManager, rebuildReadTool, lspManager } = await createTools(this.cwd, {
+        // Session manager. Agent-specific roots keep chat and coder histories isolated.
+        this.sessionManager = new SessionManager(this.opts.sessionRootDir ?? paths.sessionsDir);
+        const projectCustomization = this.opts.projectCustomization !== false;
+        if (projectCustomization) {
+            // Ensure project-local .ezcoder directories exist.
+            const localEzDir = path.join(this.cwd, ".ezcoder");
+            await fs.mkdir(path.join(localEzDir, "skills"), { recursive: true });
+            await fs.mkdir(path.join(localEzDir, "commands"), { recursive: true });
+            await fs.mkdir(path.join(localEzDir, "agents"), { recursive: true });
+            this.skills = await discoverSkills({
+                globalSkillsDir: paths.skillsDir,
+                projectDir: this.cwd,
+            });
+        }
+        else {
+            this.skills = [];
+        }
+        // Discover agents and create tools (with sub-agent support). Chat sessions
+        // can retain bundled workers without loading project/global customization.
+        const agents = projectCustomization
+            ? await discoverAgents({
+                globalAgentsDir: paths.agentsDir,
+                projectDir: this.cwd,
+            })
+            : this.opts.globalSubagents
+                ? await discoverAgents({ globalAgentsDir: paths.agentsDir })
+                : [];
+        const { tools: builtInTools, processManager, rebuildReadTool, lspManager, subAgentManager, } = await createTools(this.cwd, {
             agents,
             skills: this.skills,
             provider: this.provider,
@@ -190,7 +208,11 @@ export class AgentSession {
             // sub-agent spawns read the current parent state at execution time.
             getProvider: () => this.provider,
             getModel: () => this.model,
+            getThinkingLevel: () => this.thinkingLevel,
+            getBaseUrl: () => this.baseUrl,
             getCacheKey: () => this.getPromptCacheKey(),
+            disableAsyncSubagents: this.opts.subagentWorker,
+            onSubAgentState: (snapshot) => this.eventBus.emit("subagent_state", snapshot),
             // Plan mode: only wired when the host supplies callbacks. The ref is
             // shared so bash/edit/write enforce read-only restrictions live.
             ...(this.opts.onEnterPlan || this.opts.onExitPlan
@@ -201,6 +223,7 @@ export class AgentSession {
                 }
                 : {}),
         });
+        const tools = [...builtInTools, ...(this.opts.additionalTools ?? [])];
         // Apply the optional tool allow-list (read-only advisory sessions). Filtering
         // here means the excluded tools are never registered with the agent loop, so
         // a hallucinated call can't mutate the repo — and buildSystemPrompt below is
@@ -209,6 +232,8 @@ export class AgentSession {
         this.rebuildReadTool = rebuildReadTool;
         this.processManager = processManager;
         this.lspManager = lspManager;
+        this.subAgentManager = subAgentManager;
+        this.bindManagerCancellation(this.opts.signal);
         // Connect MCP servers (non-blocking — failures are logged and skipped).
         // Child sessions (subagents and goal workers run via `--json` mode) get the
         // provider defaults only — NOT user-configured servers. The defaults now
@@ -234,7 +259,9 @@ export class AgentSession {
         }
         const basePrompt = this.customSystemPrompt ??
             (await buildSystemPrompt(this.cwd, this.skills, false, undefined, this.tools.map((tool) => tool.name), undefined, this.provider));
-        this.messages = [{ role: "system", content: basePrompt }];
+        this.baseSystemPrompt = basePrompt;
+        this.messages = [{ role: "system", content: this.withSystemPromptTail(basePrompt) }];
+        this.syncUltraOrchestrationPrompt();
         // Load or create session. Transient sessions (subagent spawns) never
         // touch the session store — sessionPath stays empty and persistMessage
         // is a no-op so their transcripts can't pollute `ezcoder continue`.
@@ -256,48 +283,46 @@ export class AgentSession {
         else {
             await this.createNewSession();
         }
-        // Register slash commands
-        const builtins = createBuiltinCommands();
-        for (const cmd of builtins) {
-            this.slashCommands.register(cmd);
-        }
-        // Wire up /help to show all registered + prompt + custom commands
-        const helpCmd = this.slashCommands.get("help");
-        if (helpCmd) {
-            const registry = this.slashCommands;
-            const cwd = this.cwd;
-            helpCmd.execute = async () => {
-                const all = registry.getAll();
-                const lines = all.map((c) => `  /${c.name}${c.aliases.length ? ` (${c.aliases.map((a) => "/" + a).join(", ")})` : ""} — ${c.description}`);
-                // Add prompt-template commands
-                if (PROMPT_COMMANDS.length > 0) {
-                    lines.push("");
-                    lines.push("Prompt commands:");
-                    for (const cmd of PROMPT_COMMANDS) {
-                        lines.push(`  /${cmd.name}${cmd.aliases.length ? ` (${cmd.aliases.map((a) => "/" + a).join(", ")})` : ""} — ${cmd.description}`);
+        // EZ Coder owns its command registry. Other agents start with an isolated
+        // empty registry and can register their own commands in their own file.
+        if (this.opts.coderSlashCommands !== false) {
+            const builtins = createBuiltinCommands();
+            for (const cmd of builtins)
+                this.slashCommands.register(cmd);
+            // Wire up /help to show all registered + prompt + custom commands.
+            const helpCmd = this.slashCommands.get("help");
+            if (helpCmd) {
+                const registry = this.slashCommands;
+                const cwd = this.cwd;
+                helpCmd.execute = async () => {
+                    const all = registry.getAll();
+                    const lines = all.map((c) => `  /${c.name}${c.aliases.length ? ` (${c.aliases.map((a) => "/" + a).join(", ")})` : ""} — ${c.description}`);
+                    if (PROMPT_COMMANDS.length > 0) {
+                        lines.push("", "Prompt commands:");
+                        for (const cmd of PROMPT_COMMANDS) {
+                            lines.push(`  /${cmd.name}${cmd.aliases.length ? ` (${cmd.aliases.map((a) => "/" + a).join(", ")})` : ""} — ${cmd.description}`);
+                        }
                     }
-                }
-                // Add custom commands from .ezcoder/commands/
-                const customCmds = await loadCustomCommands(cwd);
-                if (customCmds.length > 0) {
-                    lines.push("");
-                    lines.push("Custom commands:");
-                    for (const cmd of customCmds) {
-                        lines.push(`  /${cmd.name} — ${cmd.description}`);
+                    const customCmds = await loadCustomCommands(cwd);
+                    if (customCmds.length > 0) {
+                        lines.push("", "Custom commands:");
+                        for (const cmd of customCmds)
+                            lines.push(`  /${cmd.name} — ${cmd.description}`);
                     }
-                }
-                return "Available commands:\n" + lines.join("\n");
+                    return "Available commands:\n" + lines.join("\n");
+                };
+            }
+        }
+        if (this.opts.loadExtensions !== false) {
+            const extContext = {
+                eventBus: this.eventBus,
+                registerTool: (tool) => this.tools.push(tool),
+                registerSlashCommand: (cmd) => this.slashCommands.register(cmd),
+                cwd: this.cwd,
+                settingsManager: this.settingsManager,
             };
+            await this.extensionLoader.loadAll(paths.extensionsDir, extContext);
         }
-        // Load extensions
-        const extContext = {
-            eventBus: this.eventBus,
-            registerTool: (tool) => this.tools.push(tool),
-            registerSlashCommand: (cmd) => this.slashCommands.register(cmd),
-            cwd: this.cwd,
-            settingsManager: this.settingsManager,
-        };
-        await this.extensionLoader.loadAll(paths.extensionsDir, extContext);
         this.eventBus.emit("session_start", { sessionId: this.sessionId });
     }
     /**
@@ -413,12 +438,17 @@ export class AgentSession {
      * Process user input. Handles slash commands or runs agent loop.
      */
     async prompt(content) {
-        // Check for slash commands
-        const parsed = this.slashCommands.parse(content);
+        const parsedInput = this.slashCommands.parse(content);
+        const coderCommands = this.opts.coderSlashCommands !== false;
+        // Non-coder agents only intercept commands registered in their own registry.
+        // Unknown `/text` stays a normal conversational prompt.
+        const parsed = parsedInput && (coderCommands || this.slashCommands.get(parsedInput.name))
+            ? parsedInput
+            : null;
         if (parsed) {
-            // Check prompt-template commands first (built-in + custom)
-            const builtinPromptCmd = getPromptCommand(parsed.name);
-            const customCmds = await loadCustomCommands(this.cwd);
+            // EZ Coder alone can resolve its prompt-template and project commands.
+            const builtinPromptCmd = coderCommands ? getPromptCommand(parsed.name) : undefined;
+            const customCmds = coderCommands ? await loadCustomCommands(this.cwd) : [];
             const customPromptCmd = !builtinPromptCmd
                 ? customCmds.find((c) => c.name === parsed.name)
                 : undefined;
@@ -637,6 +667,8 @@ export class AgentSession {
                 return { role: "user", content: parts };
             });
         }
+        if (this.opts.selfCorrectionHooks === false)
+            return null;
         if (!this.settingsManager.get("idealReviewEnabled"))
             return null;
         if (!this.loopBreakInjected) {
@@ -664,6 +696,8 @@ export class AgentSession {
      * otherwise finish and the change set is substantial enough to warrant it.
      */
     getHookFollowUpMessages() {
+        if (this.opts.selfCorrectionHooks === false)
+            return null;
         if (!this.settingsManager.get("idealReviewEnabled"))
             return null;
         if (this.idealReviewInjected)
@@ -680,6 +714,7 @@ export class AgentSession {
     }
     /** Auto-compact if needed, run agent loop with auth retry, and persist messages. */
     async runLoop() {
+        this.refreshSystemPromptTail();
         // One-shot cache-key marker per session so turn_end cacheRead numbers
         // in the log can be traced back to a specific routing namespace —
         // particularly useful when sub-agents inherit `parentKey:subagent`.
@@ -739,11 +774,13 @@ export class AgentSession {
                 tools: this.tools,
                 webSearch: true,
                 maxTokens: this.maxTokens,
+                maxTurns: this.opts.maxTurns,
                 thinking: this.thinkingLevel,
                 apiKey,
                 baseUrl: effectiveBaseUrl,
                 signal: this.opts.signal,
                 accountId,
+                transportSessionId: this.sessionId || this.transportSessionId,
                 projectId,
                 // Kimi For Coding gates the managed endpoint on coding-agent identity
                 // headers; attach them only when the Kimi OAuth token is in use.
@@ -790,11 +827,6 @@ export class AgentSession {
             }
         };
         try {
-            // Fire cache pre-warm before the first turn (Anthropic + speedProfile optimized).
-            // Runs concurrently with nothing — it must complete before runAgentLoop so
-            // the cache is warm when the real request arrives. Best-effort: swallowed
-            // inside maybePrewarmCache/prewarmAnthropicCache.
-            await this.maybePrewarmCache(creds);
             await runAgentLoop(creds.accessToken, creds.accountId, creds.projectId);
         }
         catch (err) {
@@ -841,6 +873,11 @@ export class AgentSession {
         if (provider)
             this.provider = provider;
         this.model = model;
+        // Keep host-provided option closures (notably chat delegation) aligned with
+        // the live selection after an in-session model switch.
+        this.opts.provider = this.provider;
+        this.opts.model = this.model;
+        this.syncUltraOrchestrationPrompt();
         setEstimatorModel(model);
         // maxTokens must follow the active model — it was frozen at the boot
         // model's `maxOutputTokens` in the constructor, so without this a session
@@ -984,7 +1021,9 @@ export class AgentSession {
         this.appMarkers = [];
         const basePrompt = this.customSystemPrompt ??
             (await buildSystemPrompt(this.cwd, this.skills, false, undefined, this.tools.map((tool) => tool.name), undefined, this.provider));
-        this.messages = [{ role: "system", content: basePrompt }];
+        this.baseSystemPrompt = basePrompt;
+        this.messages = [{ role: "system", content: this.withSystemPromptTail(basePrompt) }];
+        this.syncUltraOrchestrationPrompt();
         // Fresh conversation — new entries must not chain onto the old DAG's leaf.
         this.currentLeafId = null;
         // Transient sessions (Nolan chat/autopilot, subagent spawns) never touch the
@@ -1099,6 +1138,22 @@ export class AgentSession {
             return `No background process with id "${id}"`;
         return this.processManager.stop(id);
     }
+    /** Replace a host-owned system prompt in place without resetting conversation history. */
+    setCustomSystemPrompt(systemPrompt, promptCacheKeyPrefix) {
+        this.customSystemPrompt = systemPrompt;
+        this.baseSystemPrompt = systemPrompt;
+        this.opts.systemPrompt = systemPrompt;
+        if (promptCacheKeyPrefix)
+            this.opts.promptCacheKeyPrefix = promptCacheKeyPrefix;
+        const content = this.withSystemPromptTail(systemPrompt);
+        if (this.messages[0]?.role === "system") {
+            this.messages[0] = { role: "system", content };
+        }
+        else {
+            this.messages.unshift({ role: "system", content });
+        }
+        this.syncUltraOrchestrationPrompt();
+    }
     /**
      * Toggle plan mode: flips the shared ref (so tools enforce read-only
      * restrictions) and rebuilds the system prompt in place so the model is told
@@ -1128,11 +1183,30 @@ export class AgentSession {
         if (this.customSystemPrompt)
             return;
         const rebuilt = await buildSystemPrompt(this.cwd, this.skills, this.planModeRef.current, this.approvedPlanPath, this.tools.map((tool) => tool.name), undefined, this.provider);
+        this.baseSystemPrompt = rebuilt;
+        const content = this.withSystemPromptTail(rebuilt);
         if (this.messages[0]?.role === "system") {
-            this.messages[0] = { role: "system", content: rebuilt };
+            this.messages[0] = { role: "system", content };
         }
         else {
-            this.messages.unshift({ role: "system", content: rebuilt });
+            this.messages.unshift({ role: "system", content });
+        }
+        this.syncUltraOrchestrationPrompt();
+    }
+    withSystemPromptTail(basePrompt) {
+        if (!this.opts.getSystemPromptTail)
+            return basePrompt;
+        return `${basePrompt}\n\n<!-- uncached -->\n${this.opts.getSystemPromptTail()}`;
+    }
+    refreshSystemPromptTail() {
+        if (!this.opts.getSystemPromptTail)
+            return;
+        const content = this.withSystemPromptTail(this.baseSystemPrompt);
+        if (this.messages[0]?.role === "system") {
+            this.messages[0] = { role: "system", content };
+        }
+        else {
+            this.messages.unshift({ role: "system", content });
         }
     }
     getMessages() {
@@ -1367,10 +1441,28 @@ export class AgentSession {
      * effect on the next prompt, since the in-flight loop reads it at start. */
     setThinkingLevel(level) {
         this.thinkingLevel = level;
+        this.syncUltraOrchestrationPrompt();
+    }
+    /** Sol/Terra Ultra delegates proactively; lower levels require an explicit request. */
+    syncUltraOrchestrationPrompt() {
+        if (this.opts.orchestrationPrompt === false)
+            return;
+        const systemMessage = this.messages[0];
+        if (systemMessage?.role !== "system" || typeof systemMessage.content !== "string")
+            return;
+        systemMessage.content = applyAsyncSubagentPolicy(systemMessage.content, this.provider, this.model, this.thinkingLevel, this.tools.map((tool) => tool.name));
     }
     /** Replace the abort signal (e.g. after cancellation). */
     setSignal(signal) {
         this.opts = { ...this.opts, signal };
+        this.bindManagerCancellation(signal);
+    }
+    bindManagerCancellation(signal) {
+        this.managerAbortSignal?.removeEventListener("abort", this.managerAbortHandler);
+        this.managerAbortSignal = signal;
+        signal?.addEventListener("abort", this.managerAbortHandler, { once: true });
+        if (signal?.aborted)
+            this.managerAbortHandler();
     }
     /** True when speedProfile is "optimized" (1-h cache TTL + pre-warm), or the
      *  session was constructed with `forceLongCacheRetention` (Nolan sessions). */
@@ -1388,40 +1480,6 @@ export class AgentSession {
     currentAuthStorageKeys() {
         return getAuthStorageKeys(this.provider, this.model);
     }
-    /** Fire a cache pre-warm request for Anthropic so the first real turn is a
-     *  cache read instead of a cold write. No-op for other providers and when
-     *  speedProfile is not "optimized". Entirely best-effort — any failure is
-     *  swallowed so prewarm never blocks or aborts the real prompt. */
-    async maybePrewarmCache(creds) {
-        if (this.cachePrewarmed || !this.isSpeedOptimized() || this.provider !== "anthropic") {
-            return;
-        }
-        this.cachePrewarmed = true;
-        try {
-            const userAgent = await getClaudeCliUserAgent();
-            const systemText = typeof this.messages[0]?.content === "string" ? this.messages[0].content : "";
-            if (!systemText)
-                return;
-            await prewarmAnthropicCache({
-                apiKey: creds.accessToken,
-                model: this.model,
-                system: systemText,
-                tools: this.tools.map((t) => ({
-                    name: t.name,
-                    description: t.description,
-                    parameters: t.parameters,
-                    ...(t.rawInputSchema ? { rawInputSchema: t.rawInputSchema } : {}),
-                })),
-                baseUrl: this.baseUrl ?? creds.baseUrl,
-                userAgent,
-                cacheRetention: "long",
-                signal: this.opts.signal,
-            });
-        }
-        catch {
-            // Best-effort — prewarm failure must never block the session.
-        }
-    }
     getPromptCacheKey() {
         if (this.opts.promptCacheKey)
             return this.opts.promptCacheKey;
@@ -1434,9 +1492,10 @@ export class AgentSession {
         return this.getPromptCacheKey();
     }
     async dispose() {
+        this.managerAbortSignal?.removeEventListener("abort", this.managerAbortHandler);
         this.processManager?.shutdownAll();
         this.lspManager?.shutdownAll();
-        await this.mcpManager?.dispose();
+        await Promise.all([this.subAgentManager?.shutdownAll(), this.mcpManager?.dispose()]);
         await this.extensionLoader.deactivateAll();
         this.eventBus.removeAllListeners();
         this.messages = [];