catui-agent 1.0.0-beta.0

package/dist/core/runtime/agent-session.js

@@ -0,0 +1,15 @@
+var E=Object.defineProperty;var n=(a,e)=>E(a,"name",{value:e,configurable:!0});import{appendFileSync as v,readFileSync as k}from"node:fs";import{homedir as L}from"node:os";import{basename as P,dirname as I,join as f}from"node:path";import{isContextOverflow as b}from"@catui/ai/overflow";import{resetApiProviders as F}from"@catui/ai/registry";import{getDocsPath as C}from"../../config.js";import{stripFrontmatter as N}from"../../utils/frontmatter.js";import{calculateContextTokens as w,collectEntriesForBranchSummary as U,estimateContextTokens as B,shouldCompact as D}from"../session/compaction/index.js";import{ToolOrchestrator as O}from"../tools/orchestrator.js";import{DEFAULT_THINKING_LEVEL as $}from"../platform/config/defaults.js";import{createExtensionTelemetrySink as j}from"../platform/telemetry/index.js";import{ExtensionRunner as W}from"../extensions-host/index.js";import{expandPromptTemplate as y}from"../prompt/prompt-templates.js";import{getLatestCompactionEntry as x}from"../session/session-manager.js";import{t as H}from"../platform/i18n/index.js";import{toSoulContext as S,extractSessionContext as R}from"../soul-integration.js";import{createDefaultRuntimeTools as K}from"./default-tools.js";import{BashRunner as V}from"./bash-runner.js";import{Listeners as q}from"../platform/listeners.js";import{ModelController as Q}from"./model-controller.js";import{CompactionController as G}from"./compaction-controller.js";import{SessionLifecycleController as X}from"./session-lifecycle-controller.js";import{SessionTreeController as z}from"./session-tree-controller.js";import{ToolRuntimeController as J}from"./tool-runtime-controller.js";import{buildRuntimeSystemPrompt as Y,getActiveBaseToolNames as Z}from"./prompt-assembly.js";import{exportSessionHtml as ee,getLastAssistantText as te}from"./export-bridge.js";import{ExtensionEventBridge as se}from"./event-bridge.js";import{bindExtensionCore as ne}from"./extension-core-bindings.js";import{buildSessionSlashCommands as oe}from"./slash-command-catalog.js";import{RetryCoordinator as ie}from"./retry-coordinator.js";import{createLogger as re}from"../platform/utils/logger.js";import{createAgentTool as ae,createTaskToolAlias as le,createSendMessageTool as he,AGENT_TOOL_NAME as M,TASK_TOOL_NAME as ge,SEND_MESSAGE_TOOL_NAME as T}from"../sub-agent/index.js";import{CycleModelError as Je}from"./model-controller.js";function Qe(a){const e=a.match(/^<skill name="([^"]+)" location="([^"]+)">\n([\s\S]*?)\n<\/skill>(?:\n\n([\s\S]+))?$/);return e?{name:e[1],location:e[2],content:e[3],userMessage:e[4]?.trim()||void 0}:null}n(Qe,"parseSkillBlock");function A(a,e){const t=new Set(e.content.filter(o=>o.type==="toolCall").map(o=>o.id));let s=a.length;for(;s>0&&ce(a[s-1],t);)s--;return s>0&&me(a[s-1],e)&&s--,a.slice(0,s)}n(A,"pruneRecoverableErrorTail");function ce(a,e){return a.role==="toolResult"&&e.has(a.toolCallId)}n(ce,"isRecoverableTailToolResult");function me(a,e){return a.role==="assistant"&&a.stopReason===e.stopReason&&a.timestamp===e.timestamp&&a.provider===e.provider&&a.model===e.model&&a.api===e.api&&a.errorMessage===e.errorMessage}n(me,"isSameRecoverableAssistantMessage");function ue(a){switch(a.type){case"agent_start":return{type:"sub_agent_start",subAgentId:a.subAgentId,agentType:a.agentType,description:a.description,isAsync:a.isAsync};case"tool_start":return{type:"sub_agent_tool_start",subAgentId:a.subAgentId,toolName:a.toolName};case"tool_end":return{type:"sub_agent_tool_end",subAgentId:a.subAgentId,toolName:a.toolName,isError:a.isError};case"agent_end":return{type:"sub_agent_end",subAgentId:a.subAgentId,success:a.success};default:return}}n(ue,"mapSubAgentEvent");class Ge{static{n(this,"AgentSession")}agent;sessionManager;settingsManager;agentCtx;_scopedModels;_unsubscribeAgent;_detachExternalAbort;_listeners=new q;_steeringMessages=[];_followUpMessages=[];_pendingNextTurnMessages=[];_retryCoordinator;_logger;_bashRunner;_extensionRunner=void 0;_slashCommandExecutor=void 0;_extensionEventBridge;_resourceLoader;_theme;_debugLevel="off";_dbg(e){if(process.env.CATUI_DEBUG_SESSION==="1")try{const t=f(L(),".catui","agent","catui-debug.log");v(t,`[${new Date().toISOString()}] [session] ${e}
+`)}catch{}}_customTools;_staticCustomTools;_mcpToolsFactory;_soulManagerFactory;_baseToolRegistry=new Map;_agentTool;_createSessionFactory;_cwd;_extensionRunnerRef;_soulManager;_lastSoulInjection;_initialActiveToolNames;_baseToolsOverride;_extensionUIContext;_extensionCommandContextActions;_extensionShutdownHandler;_extensionErrorListener;_extensionErrorUnsubscriber;_modelRegistry;_agentDir;_baseSystemPrompt="";_modelController;_compactionController;_sessionTreeController;_lifecycleController;_toolOrchestrator;_toolRuntimeController;constructor(e){if(this.agent=e.agent,this.sessionManager=e.sessionManager,this.settingsManager=e.settingsManager,this.agentCtx=e.agentCtx,this._scopedModels=e.scopedModels??[],this._resourceLoader=e.resourceLoader,this._theme=e.theme,this._debugLevel=e.debugLevel??"off",this._bashRunner=new V({getCwd:n(()=>this._cwd,"getCwd"),getShellCommandPrefix:n(()=>this.settingsManager.getShellCommandPrefix(),"getShellCommandPrefix"),appendToAgent:n(t=>this.agent.appendMessage(t),"appendToAgent"),appendToSession:n(t=>this.sessionManager.appendMessage(t),"appendToSession"),isStreaming:n(()=>this.isStreaming,"isStreaming")}),this._staticCustomTools=e.customTools??[],this._mcpToolsFactory=e.mcpToolsFactory,this._soulManagerFactory=e.soulManagerFactory,this._customTools=[...this._staticCustomTools,...e.initialMcpTools??[]],this._initialActiveToolNames=e.initialActiveToolNames,this._toolOrchestrator=new O({customTools:this._customTools,initialActiveToolNames:this._initialActiveToolNames,getExtensionTools:n(()=>new Map((this._extensionRunner?.getAllRegisteredTools()??[]).map(t=>[t.definition.name,t.definition])),"getExtensionTools")}),this._toolRuntimeController=new J(this._toolOrchestrator),this._cwd=e.cwd,this._agentDir=e.agentDir,this._modelRegistry=e.modelRegistry,this._extensionRunnerRef=e.extensionRunnerRef,this._soulManager=e.soulManager,this._baseToolsOverride=e.baseToolsOverride,this._createSessionFactory=e.createSession,this._extensionEventBridge=new se({getExtensionRunner:n(()=>this._extensionRunner,"getExtensionRunner")}),this._modelController=new Q({getModel:n(()=>this.model,"getModel"),getThinkingLevel:n(()=>this.thinkingLevel,"getThinkingLevel"),getScopedModels:n(()=>this._scopedModels,"getScopedModels"),setAgentModel:n(t=>this.agent.setModel(t),"setAgentModel"),setAgentThinkingLevel:n(t=>this.agent.setThinkingLevel(t),"setAgentThinkingLevel"),setAgentLoopFramework:n(t=>this.agent.setAgentLoopFramework(t),"setAgentLoopFramework"),setLoopPolicy:n(t=>this.agent.setLoopPolicy(t),"setLoopPolicy"),getApiKey:n(t=>this._modelRegistry.getApiKey(t),"getApiKey"),getApiKeyForProvider:n(t=>this._modelRegistry.getApiKeyForProvider(t),"getApiKeyForProvider"),getAvailableModels:n(()=>this._modelRegistry.getAvailableAsync(),"getAvailableModels"),getAuthCredential:n(t=>this._modelRegistry.authStorage.get(t),"getAuthCredential"),appendModelChange:n((t,s)=>this.sessionManager.appendModelChange(t,s),"appendModelChange"),appendThinkingLevelChange:n(t=>this.sessionManager.appendThinkingLevelChange(t),"appendThinkingLevelChange"),setDefaultModelAndProvider:n((t,s)=>this.settingsManager.setDefaultModelAndProvider(t,s),"setDefaultModelAndProvider"),setDefaultThinkingLevel:n(t=>this.settingsManager.setDefaultThinkingLevel(t),"setDefaultThinkingLevel"),emitModelSelect:n(async({model:t,previousModel:s,source:o})=>{this._extensionRunner&&await this._extensionRunner.emit({type:"model_select",model:t,previousModel:s,source:o})},"emitModelSelect")}),this._compactionController=new G({getModel:n(()=>this.model,"getModel"),getApiKey:n(t=>this._modelRegistry.getApiKey(t),"getApiKey"),getExtensionRunner:n(()=>this._extensionRunner,"getExtensionRunner"),getBranch:n(()=>this.sessionManager.getBranch(),"getBranch"),getEntries:n(()=>this.sessionManager.getEntries(),"getEntries"),getCompactionSettings:n(()=>this.settingsManager.getCompactionSettings(),"getCompactionSettings"),appendCompaction:n((t,s,o,r,i)=>this.sessionManager.appendCompaction(t,s,o,r,i),"appendCompaction"),applyCompactedMessages:n(()=>{const t=this.sessionManager.buildSessionContext();return this.agent.replaceMessages(t.messages),t.messages},"applyCompactedMessages"),logInfo:n((t,s)=>this._logger.info(t,s),"logInfo"),disconnectFromAgent:n(()=>this._disconnectFromAgent(),"disconnectFromAgent"),reconnectToAgent:n(()=>this._reconnectToAgent(),"reconnectToAgent"),abortAgent:n(()=>this.abort(),"abortAgent"),emitAutoCompactionStart:n(t=>this._emit({type:"auto_compaction_start",reason:t}),"emitAutoCompactionStart"),emitAutoCompactionEnd:n(t=>this._emit({type:"auto_compaction_end",...t}),"emitAutoCompactionEnd"),getAutoCompactionEnabled:n(()=>this.settingsManager.getCompactionEnabled(),"getAutoCompactionEnabled"),setAutoCompactionEnabled:n(t=>this.settingsManager.setCompactionEnabled(t),"setAutoCompactionEnabled")}),this._sessionTreeController=new z({getModel:n(()=>this.model,"getModel"),getApiKey:n(t=>this._modelRegistry.getApiKey(t),"getApiKey"),getExtensionRunner:n(()=>this._extensionRunner,"getExtensionRunner"),getLeafId:n(()=>this.sessionManager.getLeafId(),"getLeafId"),getEntry:n(t=>this.sessionManager.getEntry(t),"getEntry"),collectBranchSummaryEntries:n((t,s)=>U(this.sessionManager,t,s),"collectBranchSummaryEntries"),getBranchSummaryReserveTokens:n(()=>this.settingsManager.getBranchSummarySettings().reserveTokens,"getBranchSummaryReserveTokens"),branchWithSummary:n((t,s,o,r)=>this.sessionManager.branchWithSummary(t,s,o,r),"branchWithSummary"),appendLabelChange:n((t,s)=>this.sessionManager.appendLabelChange(t,s),"appendLabelChange"),resetLeaf:n(()=>this.sessionManager.resetLeaf(),"resetLeaf"),branch:n(t=>this.sessionManager.branch(t),"branch"),rebuildAgentMessages:n(()=>{const t=this.sessionManager.buildSessionContext();this.agent.replaceMessages(t.messages)},"rebuildAgentMessages"),extractUserMessageText:n(t=>this._extractUserMessageText(t),"extractUserMessageText")}),this._lifecycleController=new X({getSessionFile:n(()=>this.sessionManager.getSessionFile(),"getSessionFile"),getExtensionRunner:n(()=>this._extensionRunner,"getExtensionRunner"),disconnectFromAgent:n(()=>this._disconnectFromAgent(),"disconnectFromAgent"),reconnectToAgent:n(()=>this._reconnectToAgent(),"reconnectToAgent"),abortAgent:n(()=>this.abort(),"abortAgent"),resetAgent:n(()=>this.agent.reset(),"resetAgent"),syncAgentSessionId:n(()=>{this.agent.sessionId=this.sessionManager.getSessionId()},"syncAgentSessionId"),clearPendingQueues:n(()=>{this._steeringMessages=[],this._followUpMessages=[],this._pendingNextTurnMessages=[]},"clearPendingQueues"),clearPendingNextTurnMessages:n(()=>{this._pendingNextTurnMessages=[]},"clearPendingNextTurnMessages"),sessionNewSession:n(t=>this.sessionManager.newSession({parentSession:t}),"sessionNewSession"),sessionSetFile:n(t=>this.sessionManager.setSessionFile(t),"sessionSetFile"),sessionCreateBranchedSession:n(t=>this.sessionManager.createBranchedSession(t),"sessionCreateBranchedSession"),getEntry:n(t=>this.sessionManager.getEntry(t),"getEntry"),buildSessionContext:n(()=>this.sessionManager.buildSessionContext(),"buildSessionContext"),replaceAgentMessages:n(t=>this.agent.replaceMessages(t),"replaceAgentMessages"),appendThinkingLevelChange:n(t=>this.sessionManager.appendThinkingLevelChange(t),"appendThinkingLevelChange"),getThinkingLevel:n(()=>this.thinkingLevel,"getThinkingLevel"),getBranch:n(()=>this.sessionManager.getBranch(),"getBranch"),getDefaultThinkingLevel:n(()=>this.settingsManager.getDefaultThinkingLevel()??$,"getDefaultThinkingLevel"),getAvailableModels:n(()=>this._modelRegistry.getAvailable(),"getAvailableModels"),restoreModel:n(t=>this._modelController.restoreModel(t),"restoreModel"),restoreThinkingLevel:n(t=>this._modelController.restoreThinkingLevel(t),"restoreThinkingLevel"),runSetup:n(t=>t(this.sessionManager),"runSetup"),extractUserMessageText:n(t=>this._extractUserMessageText(t),"extractUserMessageText")}),this.agent.setModelErrorRecovery(t=>this._recoverModelErrorInLoop(t)),this._unsubscribeAgent=this.agent.subscribe(this._handleAgentEvent),e.signal){const t=n(()=>{this.abort()},"externalAbortHandler");e.signal.addEventListener("abort",t,{once:!0}),this._detachExternalAbort=()=>{e.signal?.removeEventListener("abort",t)}}this._buildRuntime({activeToolNames:this._initialActiveToolNames,includeAllExtensionTools:!0}),this._retryCoordinator=new ie(this._createRetryHost()),this._logger=re({sessionId:this.sessionManager.getSessionId(),component:"agent-session"}),this._emitDebug("basic","session","session_created",{sessionId:this.sessionManager.getSessionId()})}get modelRegistry(){return this._modelRegistry}get cwd(){return this._cwd}get agentDir(){return this._agentDir}getSlashCommands(){return oe({promptTemplates:this.promptTemplates,resourceLoader:this._resourceLoader,extensionRunner:this._extensionRunner},H)}async tryExecuteExtensionCommand(e){return this._tryExecuteExtensionCommand(e)}async executeSlashCommand(e){return e.startsWith("/")?this._slashCommandExecutor&&await this._slashCommandExecutor(e)?!0:this._tryExecuteExtensionCommand(e):!1}setSlashCommandExecutor(e){this._slashCommandExecutor=e}_emit(e){this._listeners.emit(e)}_emitDebug(e,t,s,o){this._debugLevel!=="off"&&(e==="verbose"&&this._debugLevel!=="verbose"||this._emit({type:"debug",level:e,source:t,message:s,data:o,timestamp:Date.now()}))}_lastAssistantMessage=void 0;_handleAgentEvent=n(async e=>{if(e.type==="message_start"&&e.message.role==="user"){const t=this._getUserMessageText(e.message);if(t){const s=this._steeringMessages.indexOf(t);if(s!==-1)this._steeringMessages.splice(s,1);else{const o=this._followUpMessages.indexOf(t);o!==-1&&this._followUpMessages.splice(o,1)}}}if(e.type==="message_update")this._emit(e),this._extensionEventBridge.emitExtensionEvent(e).catch(t=>{this._logger.error("[extension] message_update event error",{error:t})});else{const t=this._extensionEventBridge.emitExtensionEvent(e);this._emit(e),await t}if(e.type==="tool_execution_start"?this._emitDebug("verbose","tool","tool_start",{toolName:e.toolName,toolCallId:e.toolCallId}):e.type==="tool_execution_end"&&this._emitDebug("verbose","tool","tool_end",{toolName:e.toolName,isError:e.isError}),e.type==="message_end"&&(e.message.role==="custom"?this.sessionManager.appendCustomMessageEntry(e.message.customType,e.message.content,e.message.display,e.message.details):(e.message.role==="user"||e.message.role==="assistant"||e.message.role==="toolResult")&&this.sessionManager.appendMessage(e.message),e.message.role==="assistant"&&(this._lastAssistantMessage=e.message,e.message.stopReason!=="error"&&this._retryCoordinator.onSuccess())),e.type==="agent_end"&&this._lastAssistantMessage){const t=this._lastAssistantMessage;if(this._lastAssistantMessage=void 0,this._retryCoordinator.isRetryableError(t)&&await this._retryCoordinator.handleError(t))return;if(await this._checkCompaction(t),this._soulManager){const s=t.stopReason==="error"?"failure":"success",o=this._cwd.split(/[/\\]/).pop()||"unknown",{tags:r,complexity:i,toolUsage:l}=R(this.state.messages,this._cwd),m=S(o,r,i,l),g=r[0]||o;(async()=>{try{await this._soulManager.recordInteraction(m,s,"turn"),await this._soulManager.updateExpertise(g,r,s==="success")}catch(c){this._logger.warn("[soul] recordInteraction/updateExpertise failed",{error:c})}})()}}e.type==="agent_end"&&this._extensionRunner&&this._extensionRunner.emit({type:"agent_end",messages:e.messages}).catch(t=>{this._logger.error("[extension] agent_end event error",{error:t})})},"_handleAgentEvent");_getUserMessageText(e){if(e.role!=="user")return"";const t=e.content;return typeof t=="string"?t:t.filter(o=>o.type==="text").map(o=>o.text).join("")}_findLastAssistantMessage(){const e=this.agent.state.messages;for(let t=e.length-1;t>=0;t--){const s=e[t];if(s.role==="assistant")return s}}subscribe(e){return this._listeners.add(e)}_disconnectFromAgent(){this._unsubscribeAgent&&(this._unsubscribeAgent(),this._unsubscribeAgent=void 0)}_reconnectToAgent(){this._unsubscribeAgent||(this._unsubscribeAgent=this.agent.subscribe(this._handleAgentEvent))}dispose(){this._disconnectFromAgent(),this._extensionRunner?.dispose(),this._listeners.clear(),this._detachExternalAbort&&(this._detachExternalAbort(),this._detachExternalAbort=void 0)}get state(){return this.agent.state}get model(){return this.agent.state.model}get thinkingLevel(){return this.agent.state.thinkingLevel}get agentLoopFramework(){return this.agent.agentLoopFramework}get isStreaming(){return this.agent.state.isStreaming}get systemPrompt(){return this.agent.state.systemPrompt}get soulManager(){return this._soulManager}get retryAttempt(){return this._retryCoordinator.attempt}getActiveToolNames(){return this.agent.state.tools.map(e=>e.name)}getAllTools(){return this._toolOrchestrator.getAllTools()}setActiveToolsByName(e){const{tools:t,validToolNames:s}=this._toolOrchestrator.setActiveToolsByName(e);this.agent.setTools(t),this._baseSystemPrompt=this._rebuildSystemPrompt(s),this.agent.setSystemPrompt(this._baseSystemPrompt)}get isCompacting(){return this._compactionController.isCompacting}get messages(){return this.agent.state.messages}get steeringMode(){return this.agent.getSteeringMode()}get followUpMode(){return this.agent.getFollowUpMode()}get sessionFile(){return this.sessionManager.getSessionFile()}get sessionId(){return this.sessionManager.getSessionId()}get sessionName(){return this.sessionManager.getSessionName()}get scopedModels(){return this._scopedModels}setScopedModels(e){this._scopedModels=e}get promptTemplates(){return this._resourceLoader.getPrompts().prompts}_rebuildSystemPrompt(e,t){return Y({cwd:this._cwd,resourceLoader:this._resourceLoader,toolNames:e,baseToolRegistry:this._baseToolRegistry,soulInjection:t?.soulInjection??this._lastSoulInjection})}_getActiveBaseToolNames(){return Z(this.getActiveToolNames(),this._baseToolRegistry)}async _generateSoulInjection(){if(!this._soulManager){this._lastSoulInjection=void 0;return}try{const e=this._cwd.split(/[/\\]/).pop()||"unknown",{tags:t,complexity:s,toolUsage:o}=R(this.state.messages,this._cwd),r=await this._soulManager.generateInjection(S(e,t,s,o));return this._lastSoulInjection=typeof r=="string"&&r.trim().length>0?r:void 0,this._lastSoulInjection}catch(e){return this._emit({type:"sdk:error",source:"soul",error:e}),this._lastSoulInjection}}async prompt(e,t){const s=performance.now(),o=t?.expandPromptTemplates??!0;if(this._dbg(`prompt: "${e.slice(0,80)}" isStreaming=${this.isStreaming} hasModel=${!!this.model}`),o&&e.startsWith("/")){const u=await this.executeSlashCommand(e);if(this._dbg(`prompt: slash handled=${u}`),u)return}let r=e,i=t?.images;if(this._extensionRunner?.hasHandlers("input")){const u=await this._extensionRunner.emitInput(r,i,t?.source??"interactive");if(u.action==="handled")return;u.action==="transform"&&(r=u.text,i=u.images??i)}let l=r;if(o&&(l=this._expandSkillCommand(l),l=y(l,[...this.promptTemplates])),this.isStreaming){if(!t?.streamingBehavior)throw new Error("Agent is already processing. Specify streamingBehavior ('steer' or 'followUp') to queue the message.");t.streamingBehavior==="followUp"?await this._queueFollowUp(l,i):await this._queueSteer(l,i);return}if(this._bashRunner.flushPending(),!this.model)throw new Error(`No model selected.
+
+Use /login or set an API key environment variable. See ${f(C(),"providers.md")}
+
+Then use /model to select a model.`);if(!await this._modelRegistry.getApiKey(this.model))throw this._modelRegistry.isUsingOAuth(this.model)?new Error(`Authentication failed for "${this.model.provider}". Credentials may have expired or network is unavailable. Run '/login ${this.model.provider}' to re-authenticate.`):new Error(`No API key found for ${this.model.provider}.
+
+Use /login or set an API key environment variable. See ${f(C(),"providers.md")}`);const g=this._findLastAssistantMessage();g&&await this._checkCompaction(g,!1);const c=[],h=[{type:"text",text:l}];i&&h.push(...i),c.push({role:"user",content:h,timestamp:Date.now()});for(const u of this._pendingNextTurnMessages)c.push(u);this._pendingNextTurnMessages=[];const d=this._getActiveBaseToolNames(),_=await this._generateSoulInjection();if(this._baseSystemPrompt=this._rebuildSystemPrompt(d,{soulInjection:_}),this._extensionRunner){const u=await this._extensionRunner.emitBeforeAgentStart(l,i,this._baseSystemPrompt);if(u?.messages)for(const p of u.messages)c.push({role:"custom",customType:p.customType,content:p.content,display:p.display,details:p.details,timestamp:Date.now()});u?.systemPrompt?this.agent.setSystemPrompt(u.systemPrompt):this.agent.setSystemPrompt(this._baseSystemPrompt)}else this.agent.setSystemPrompt(this._baseSystemPrompt);this._dbg(`calling agent.prompt with ${c.length} message(s)`),await this.agent.prompt(c),this._dbg(`agent.prompt returned (${(performance.now()-s).toFixed(0)}ms)`),await this.waitForRetry()}async _tryExecuteExtensionCommand(e){if(!this._extensionRunner)return!1;const t=e.indexOf(" "),s=t===-1?e.slice(1):e.slice(1,t),o=t===-1?"":e.slice(t+1),r=this._extensionRunner.createCommandContext();return(await this._extensionRunner.invokeCommand(s,o,r,{sessionId:this.sessionManager.getSessionId()})).found}_expandSkillCommand(e){if(!e.startsWith("/skill:"))return e;const t=e.indexOf(" "),s=t===-1?e.slice(7):e.slice(7,t),o=t===-1?"":e.slice(t+1).trim(),r=this.resourceLoader.getSkills().skills.find(i=>i.name===s);if(!r)return e;try{const i=k(r.filePath,"utf-8"),l=N(i).trim(),m=`<skill name="${r.name}" location="${r.filePath}">
+References are relative to ${r.baseDir}.
+
+${l}
+</skill>`;return o?`${m}
+
+${o}`:m}catch(i){return this._extensionRunner?.emitError({extensionPath:r.filePath,event:"skill_expansion",error:i instanceof Error?i.message:String(i)}),e}}async steer(e,t){e.startsWith("/")&&this._throwIfExtensionCommand(e);let s=this._expandSkillCommand(e);s=y(s,[...this.promptTemplates]),await this._queueSteer(s,t)}async followUp(e,t){e.startsWith("/")&&this._throwIfExtensionCommand(e);let s=this._expandSkillCommand(e);s=y(s,[...this.promptTemplates]),await this._queueFollowUp(s,t)}async _queueSteer(e,t){this._steeringMessages.push(e);const s=[{type:"text",text:e}];t&&s.push(...t),this.agent.steer({role:"user",content:s,timestamp:Date.now()})}async _queueFollowUp(e,t){this._followUpMessages.push(e);const s=[{type:"text",text:e}];t&&s.push(...t),this.agent.followUp({role:"user",content:s,timestamp:Date.now()})}_throwIfExtensionCommand(e){if(!this._extensionRunner)return;const t=e.indexOf(" "),s=t===-1?e.slice(1):e.slice(1,t);if(this._extensionRunner.getCommand(s))throw new Error(`Extension command "/${s}" cannot be queued. Use prompt() or execute the command when not streaming.`)}async sendCustomMessage(e,t){const s={role:"custom",customType:e.customType,content:e.content,display:e.display,details:e.details,timestamp:Date.now()};t?.deliverAs==="nextTurn"?this._pendingNextTurnMessages.push(s):this.isStreaming?t?.deliverAs==="followUp"?this.agent.followUp(s):this.agent.steer(s):t?.triggerTurn?await this.agent.prompt(s):(this.agent.appendMessage(s),this.sessionManager.appendCustomMessageEntry(e.customType,e.content,e.display,e.details),this._emit({type:"message_start",message:s}),this._emit({type:"message_end",message:s}))}async sendUserMessage(e,t){let s,o;if(typeof e=="string")s=e;else{const r=[];o=[];for(const i of e)i.type==="text"?r.push(i.text):i.type==="image"&&o.push(i);s=r.join(`
+`),o.length===0&&(o=void 0)}await this.prompt(s,{expandPromptTemplates:!1,streamingBehavior:t?.deliverAs,images:o,source:"extension"})}clearQueue(){const e=[...this._steeringMessages],t=[...this._followUpMessages];return this._steeringMessages=[],this._followUpMessages=[],this.agent.clearAllQueues(),{steering:e,followUp:t}}get pendingMessageCount(){return this._steeringMessages.length+this._followUpMessages.length}getSteeringMessages(){return this._steeringMessages}getFollowUpMessages(){return this._followUpMessages}get resourceLoader(){return this._resourceLoader}async abort(){this.abortRetry(),this.agent.abort(),await this.agent.waitForIdle(),this._extensionRunner?.emit({type:"agent_abort"})}async newSession(e){return this._lifecycleController.newSession(e)}async setModel(e){await this._modelController.setModel(e),this._emitDebug("basic","model","model_change",{provider:e.api,modelId:e.id})}async cycleModel(e="forward"){const t=await this._modelController.cycleModel(e);return t&&this._emitDebug("basic","model","model_cycle",{direction:e,provider:t.model.api,modelId:t.model.id}),t}setThinkingLevel(e){this._modelController.setThinkingLevel(e)}setAgentLoopFramework(e){this._modelController.setAgentLoopFramework(e)}setLoopPolicy(e){this._modelController.setLoopPolicy(e)}cycleThinkingLevel(){return this._modelController.cycleThinkingLevel()}getAvailableThinkingLevels(){return this._modelController.getAvailableThinkingLevels()}supportsXhighThinking(){return this._modelController.supportsXhighThinking()}supportsThinking(){return this._modelController.supportsThinking()}setSteeringMode(e){this.agent.setSteeringMode(e),this.settingsManager.setSteeringMode(e)}setFollowUpMode(e){this.agent.setFollowUpMode(e),this.settingsManager.setFollowUpMode(e)}async compact(e){return this._compactionController.compact(e)}abortCompaction(){this._compactionController.abort()}abortBranchSummary(){this._sessionTreeController.abortBranchSummary()}async _checkCompaction(e,t=!0){const s=this.settingsManager.getCompactionSettings();if(!s.enabled||t&&e.stopReason==="aborted")return;const o=this.model?.contextWindow??0,r=this.model&&e.provider===this.model.provider&&e.model===this.model.id,i=x(this.sessionManager.getBranch()),l=i!==null&&e.timestamp<new Date(i.timestamp).getTime();if(r&&!l&&b(e,o)){const g=this.agent.state.messages;g.length>0&&g[g.length-1].role==="assistant"&&this.agent.replaceMessages(g.slice(0,-1)),await this._runAutoCompaction("overflow",!0);return}if(e.stopReason==="error")return;const m=w(e.usage);D(m,o,s)&&await this._runAutoCompaction("threshold",!1)}async _recoverModelErrorInLoop(e){const t=this.settingsManager.getCompactionSettings();if(e.message.role!=="assistant")return{action:"stop"};const s=e.message;if(e.errorSubtype!=="context_overflow"){if(!this._retryCoordinator.isRetryableError(s))return{action:"stop"};if(!await this._retryCoordinator.handleErrorInLoop(s))return{action:"stop"};const h=A(this.agent.state.messages,s);return this.agent.replaceMessages(h),{action:"retry",messages:h,transition:{reason:"model_error_recovery",subtype:e.errorSubtype,attempt:e.attempt}}}if(!t.enabled)return{action:"stop"};const o=this.model?.contextWindow??0;if(!(this.model&&s.provider===this.model.provider&&s.model===this.model.id)||!b(s,o))return{action:"stop"};const i=x(this.sessionManager.getBranch());if(i!==null&&s.timestamp<new Date(i.timestamp).getTime())return{action:"stop"};const m=this.agent.state.messages;this.agent.replaceMessages(A(m,s));const g=await this._runAutoCompaction("overflow",!0,{triggerContinue:!1});return g?{action:"retry",messages:g,transition:{reason:"model_error_recovery",subtype:e.errorSubtype,attempt:e.attempt}}:{action:"stop"}}async _runAutoCompaction(e,t,s){const o=s?.triggerContinue??!0,r=await this._compactionController.runAuto(e,t);if(r!==void 0){if(t&&o){const i=this.agent.state.messages,l=i[i.length-1];l?.role==="assistant"&&l.stopReason==="error"&&this.agent.replaceMessages(i.slice(0,-1)),setTimeout(()=>{this.agent.continue().catch(()=>{})},100)}else!t&&this.agent.hasQueuedMessages()&&setTimeout(()=>{this.agent.continue().catch(()=>{})},100);return r}}setAutoCompactionEnabled(e){this._compactionController.setAutoCompactionEnabled(e)}get autoCompactionEnabled(){return this._compactionController.autoCompactionEnabled}async bindExtensions(e){e.uiContext!==void 0&&(this._extensionUIContext=e.uiContext),e.commandContextActions!==void 0&&(this._extensionCommandContextActions=e.commandContextActions),e.shutdownHandler!==void 0&&(this._extensionShutdownHandler=e.shutdownHandler),e.onError!==void 0&&(this._extensionErrorListener=e.onError),this._extensionRunner&&(this._applyExtensionBindings(this._extensionRunner),await this._extensionRunner.emit({type:"session_start"}),await this.extendResourcesFromExtensions("startup")),this._emitDebug("basic","extension","extensions_bound")}async extendResourcesFromExtensions(e){if(!this._extensionRunner?.hasHandlers("resources_discover"))return;const{skillPaths:t,promptPaths:s,themePaths:o}=await this._extensionRunner.emitResourcesDiscover(this._cwd,e);if(t.length===0&&s.length===0&&o.length===0)return;const r={skillPaths:this.buildExtensionResourcePaths(t),promptPaths:this.buildExtensionResourcePaths(s),themePaths:this.buildExtensionResourcePaths(o)};this._resourceLoader.extendResources(r),this._baseSystemPrompt=this._rebuildSystemPrompt(this.getActiveToolNames()),this.agent.setSystemPrompt(this._baseSystemPrompt)}buildExtensionResourcePaths(e){return e.map(t=>{const s=this.getExtensionSourceLabel(t.extensionPath),o=t.extensionPath.startsWith("<")?void 0:I(t.extensionPath);return{path:t.path,metadata:{source:s,scope:"temporary",origin:"top-level",baseDir:o}}})}getExtensionSourceLabel(e){return e.startsWith("<")?`extension:${e.replace(/[<>]/g,"")}`:`extension:${P(e).replace(/\.(ts|js)$/,"")}`}_applyExtensionBindings(e){e.setUIContext(this._extensionUIContext),e.bindCommandContext(this._extensionCommandContextActions),this._extensionErrorUnsubscriber?.(),this._extensionErrorUnsubscriber=this._extensionErrorListener?e.onError(this._extensionErrorListener):void 0}_bindExtensionCore(e){const t=this;ne(e,{promptTemplates:this.promptTemplates,resourceLoader:this._resourceLoader,modelRegistry:this.modelRegistry,sessionManager:this.sessionManager,settingsManager:this.settingsManager,shutdownHandler:this._extensionShutdownHandler,soulManager:this._soulManager,get model(){return t.model},get thinkingLevel(){return t.thinkingLevel},get isStreaming(){return t.isStreaming},get pendingMessageCount(){return t.pendingMessageCount},get systemPrompt(){return t.systemPrompt},sendCustomMessage:n((s,o)=>this.sendCustomMessage(s,o),"sendCustomMessage"),sendUserMessage:n((s,o)=>this.sendUserMessage(s,o),"sendUserMessage"),executeSlashCommand:n(s=>this.executeSlashCommand(s),"executeSlashCommand"),getActiveToolNames:n(()=>this.getActiveToolNames(),"getActiveToolNames"),getAllTools:n(()=>this.getAllTools(),"getAllTools"),setActiveToolsByName:n(s=>this.setActiveToolsByName(s),"setActiveToolsByName"),setModel:n(s=>this.setModel(s),"setModel"),setThinkingLevel:n(s=>this.setThinkingLevel(s),"setThinkingLevel"),abort:n(()=>this.abort(),"abort"),clearFollowUpQueue:n(()=>{this.agent.clearFollowUpQueue(),this._followUpMessages=[]},"clearFollowUpQueue"),getContextUsage:n(()=>this.getContextUsage(),"getContextUsage"),compact:n(s=>this.compact(s),"compact")})}_buildRuntime(e){const t=this._baseToolsOverride?this._baseToolsOverride:K(this._cwd,this.settingsManager);this._baseToolRegistry=new Map(Object.entries(t).map(([c,h])=>[c,h]));const s=this._resourceLoader.getExtensions();if(e.flagValues)for(const[c,h]of e.flagValues)s.runtime.flagValues.set(c,h);const o=s.extensions.length>0,r=this._customTools.length>0;this._extensionRunner=o||r?new W(s.extensions,s.runtime,this._cwd,this._agentDir,this.sessionManager,this._modelRegistry):void 0,this._extensionRunnerRef&&(this._extensionRunnerRef.current=this._extensionRunner),this._extensionRunner&&(this._bindExtensionCore(this._extensionRunner),this._applyExtensionBindings(this._extensionRunner),this._extensionRunner.setTelemetrySink(j({workspaceRoot:this._cwd})));const i=this._toolRuntimeController.build({baseTools:this._baseToolRegistry,baseToolsOverride:this._baseToolsOverride,customTools:this._customTools,activeToolNames:e.activeToolNames,includeAllExtensionTools:e.includeAllExtensionTools,extensionRunner:this._extensionRunner}),l=n(c=>{const h=ue(c);h&&this._emit(h)},"onSubAgentEvent");this._agentTool=ae({parentSession:this,parentPermissionMode:"default",parentModel:this.model,createSession:this._createSessionFactory,onSubAgentEvent:l}),i.activeTools.push(this._agentTool),this._toolOrchestrator.registerTool(M,this._agentTool);const m=le({parentSession:this,parentPermissionMode:"default",parentModel:this.model,createSession:this._createSessionFactory,onSubAgentEvent:l});i.activeTools.push(m),this._toolOrchestrator.registerTool(ge,m);const g=he({parentSession:this,parentPermissionMode:"default",parentModel:this.model,createSession:this._createSessionFactory});i.activeTools.push(g),this._toolOrchestrator.registerTool(T,g),i.systemPromptToolNames.includes(M)||i.systemPromptToolNames.push(M),i.systemPromptToolNames.includes(T)||i.systemPromptToolNames.push(T),this.agent.setTools(i.activeTools),this._baseSystemPrompt=this._rebuildSystemPrompt(i.systemPromptToolNames),this.agent.setSystemPrompt(this._baseSystemPrompt)}async _refreshMcpTools(){if(!this._mcpToolsFactory)return 0;try{const e=await this._mcpToolsFactory();return this._customTools=[...this._staticCustomTools,...e],e.length}catch(e){this._emit({type:"sdk:error",source:"mcp",error:e});const t=this._customTools.filter(s=>s.name.startsWith("mcp_"));return this._customTools=[...this._staticCustomTools,...t],t.length}}async warmupMcpTools(){if(this._mcpToolsFactory)try{const e=await this._refreshMcpTools();this._buildRuntime({activeToolNames:this.getActiveToolNames(),flagValues:this._extensionRunner?.getFlagValues(),includeAllExtensionTools:!0}),this._emit({type:"sdk:mcp_ready",toolCount:e}),this._emitDebug("basic","mcp","mcp_warmup_complete",{toolCount:e})}catch(e){this._emit({type:"sdk:error",source:"mcp",error:e})}}async reload(){this._emitDebug("basic","resource","reload_start");const e=this._extensionRunner?.getFlagValues();if(await this._extensionRunner?.emit({type:"session_shutdown"}),this.settingsManager.reload(),F(),await this._resourceLoader.reload(),await this._refreshMcpTools(),this._soulManagerFactory)try{this._soulManager=await this._soulManagerFactory(),this._lastSoulInjection=void 0}catch(s){this._emit({type:"sdk:error",source:"soul",error:s})}this._buildRuntime({activeToolNames:this.getActiveToolNames(),flagValues:e,includeAllExtensionTools:!0});const t=this._extensionUIContext||this._extensionCommandContextActions||this._extensionShutdownHandler||this._extensionErrorListener;this._extensionRunner&&t&&(await this._extensionRunner.emit({type:"session_start"}),await this.extendResourcesFromExtensions("reload")),this._emitDebug("basic","resource","reload_end")}_createRetryHost(){return{getContextWindow:n(()=>this.model?.contextWindow??0,"getContextWindow"),getRetrySettings:n(()=>this.settingsManager.getRetrySettings(),"getRetrySettings"),removeLastAssistantMessage:n(()=>{const e=this.agent.state.messages;e.length>0&&e[e.length-1].role==="assistant"&&this.agent.replaceMessages(e.slice(0,-1))},"removeLastAssistantMessage"),triggerContinue:n(()=>{setTimeout(()=>{this.agent.continue().catch(()=>{})},0)},"triggerContinue"),emitEvent:n(e=>{this._emit(e)},"emitEvent")}}abortRetry(){this._retryCoordinator.abort()}async waitForRetry(){await this._retryCoordinator.waitForCompletion()}get isRetrying(){return this._retryCoordinator.isActive}get autoRetryEnabled(){return this.settingsManager.getRetryEnabled()}setAutoRetryEnabled(e){this.settingsManager.setRetryEnabled(e)}async executeBash(e,t,s){return this._bashRunner.execute(e,t,s)}recordBashResult(e,t,s){this._bashRunner.recordResult(e,t,s)}abortBash(){this._bashRunner.abort()}get isBashRunning(){return this._bashRunner.isRunning}get hasPendingBashMessages(){return this._bashRunner.hasPending}async switchSession(e){return this._lifecycleController.switchSession(e)}setSessionName(e){this.sessionManager.appendSessionInfo(e)}async fork(e){return this._lifecycleController.fork(e)}async navigateTree(e,t={}){return this._sessionTreeController.navigateTree(e,t)}getUserMessagesForForking(){const e=this.sessionManager.getEntries(),t=[];for(const s of e){if(s.type!=="message"||s.message.role!=="user")continue;const o=this._extractUserMessageText(s.message.content);o&&t.push({entryId:s.id,text:o})}return t}_extractUserMessageText(e){return typeof e=="string"?e:Array.isArray(e)?e.filter(t=>t.type==="text").map(t=>t.text).join(""):""}getSessionStats(){const e=this.state,t=e.messages.filter(h=>h.role==="user").length,s=e.messages.filter(h=>h.role==="assistant").length,o=e.messages.filter(h=>h.role==="toolResult").length;let r=0,i=0,l=0,m=0,g=0,c=0;for(const h of e.messages)if(h.role==="assistant"){const d=h;r+=d.content.filter(_=>_.type==="toolCall").length,i+=d.usage.input,l+=d.usage.output,m+=d.usage.cacheRead,g+=d.usage.cacheWrite,c+=d.usage.cost.total}return{sessionFile:this.sessionFile,sessionId:this.sessionId,userMessages:t,assistantMessages:s,toolCalls:r,toolResults:o,totalMessages:e.messages.length,tokens:{input:i,output:l,cacheRead:m,cacheWrite:g,total:i+l+m+g},cost:c}}getContextUsage(){const e=this.model;if(!e)return;const t=e.contextWindow??0;if(t<=0)return;const s=this.sessionManager.getBranch(),o=x(s);if(o){const l=s.lastIndexOf(o);let m=!1;for(let g=s.length-1;g>l;g--){const c=s[g];if(c.type==="message"&&c.message.role==="assistant"){const h=c.message;if(h.stopReason!=="aborted"&&h.stopReason!=="error"){w(h.usage)>0&&(m=!0);break}}}if(!m)return{tokens:null,contextWindow:t,percent:null}}const r=B(this.messages),i=r.tokens/t*100;return{tokens:r.tokens,contextWindow:t,percent:i}}async exportToHtml(e){return await ee({sessionManager:this.sessionManager,state:this.state,outputPath:e,themeName:this.settingsManager.getTheme(),extensionRunner:this._extensionRunner,theme:this._theme})}getLastAssistantText(){return te(this.messages)}hasExtensionHandlers(e){return this._extensionRunner?.hasHandlers(e)??!1}get extensionRunner(){return this._extensionRunner}}export{Ge as AgentSession,Je as CycleModelError,Qe as parseSkillBlock,A as pruneRecoverableErrorTail};

package/dist/core/runtime/bash-runner.d.ts

@@ -0,0 +1,56 @@
+/**
+ * [WHO]: Provides BashRunner, BashRunnerDeps — bash execution + pending-message queue for a session
+ * [FROM]: Depends on core/platform/exec/bash-executor (execution), core/messages (BashExecutionMessage),
+ *         core/tools/bash (BashOperations); host wiring passed in via closures (no agent/session import)
+ * [TO]: Consumed by core/runtime/agent-session.ts (composition root delegates executeBash/abortBash/…)
+ * [HERE]: core/runtime/agent-session.ts split — owns _bashAbortController + _pendingBashMessages
+ *
+ * Extracted from AgentSession (P4.1). Behavior-identical: the session's executeBash /
+ * recordBashResult / abortBash / isBashRunning / hasPendingBashMessages / flushPending methods
+ * now delegate here. Dependencies are injected as closures so this module stays decoupled from
+ * Agent / SessionManager / SettingsManager.
+ */
+import { type BashResult } from "../platform/exec/bash-executor.js";
+import type { BashExecutionMessage } from "../messages.js";
+import type { BashOperations } from "../tools/bash.js";
+export interface BashRunnerDeps {
+    /** Current working directory (read lazily — may change across session switches). */
+    getCwd: () => string;
+    /** Optional shell command prefix (e.g. alias expansion) from settings. */
+    getShellCommandPrefix: () => string | undefined;
+    /** Append a message to live agent state. */
+    appendToAgent: (message: BashExecutionMessage) => void;
+    /** Persist a message to the session. */
+    appendToSession: (message: BashExecutionMessage) => void;
+    /** Whether the agent is mid-stream (defer message to preserve tool ordering). */
+    isStreaming: () => boolean;
+}
+export declare class BashRunner {
+    private readonly deps;
+    private _abortController;
+    private _pending;
+    constructor(deps: BashRunnerDeps);
+    /** Run a bash command, recording its result in session history. */
+    execute(command: string, onChunk?: (chunk: string) => void, options?: {
+        excludeFromContext?: boolean;
+        operations?: BashOperations;
+    }): Promise<BashResult>;
+    /**
+     * Record a bash execution result in session history.
+     * Used by execute() and by extensions that handle bash execution themselves.
+     */
+    recordResult(command: string, result: BashResult, options?: {
+        excludeFromContext?: boolean;
+    }): void;
+    /** Cancel running bash command. */
+    abort(): void;
+    /** Whether a bash command is currently running. */
+    get isRunning(): boolean;
+    /** Whether there are pending bash messages waiting to be flushed. */
+    get hasPending(): boolean;
+    /**
+     * Flush pending bash messages to agent state and session.
+     * Called after agent turn completes to maintain proper message ordering.
+     */
+    flushPending(): void;
+}

package/dist/core/runtime/bash-runner.js

@@ -0,0 +1,2 @@
+var l=Object.defineProperty;var d=(o,e)=>l(o,"name",{value:e,configurable:!0});import{executeBash as h,executeBashWithOperations as p}from"../platform/exec/bash-executor.js";class g{static{d(this,"BashRunner")}deps;_abortController=void 0;_pending=[];constructor(e){this.deps=e}async execute(e,t,s){this._abortController=new AbortController;const n=this.deps.getShellCommandPrefix(),i=n?`${n}
+${e}`:e,r=this.deps.getCwd();try{const a=s?.operations?await p(i,r,s.operations,{onChunk:t,signal:this._abortController.signal}):await h(i,{onChunk:t,signal:this._abortController.signal,cwd:r});return this.recordResult(e,a,s),a}finally{this._abortController=void 0}}recordResult(e,t,s){const n={role:"bashExecution",command:e,output:t.output,exitCode:t.exitCode,cancelled:t.cancelled,truncated:t.truncated,fullOutputPath:t.fullOutputPath,timestamp:Date.now(),excludeFromContext:s?.excludeFromContext};this.deps.isStreaming()?this._pending.push(n):(this.deps.appendToAgent(n),this.deps.appendToSession(n))}abort(){this._abortController?.abort()}get isRunning(){return this._abortController!==void 0}get hasPending(){return this._pending.length>0}flushPending(){if(this._pending.length!==0){for(const e of this._pending)this.deps.appendToAgent(e),this.deps.appendToSession(e);this._pending=[]}}}export{g as BashRunner};

package/dist/core/runtime/catui-agent.d.ts

@@ -0,0 +1,182 @@
+/**
+ * [WHO]: CatuiAgent - Simplified SDK wrapper for better DX
+ * [FROM]: Depends on sdk.ts, agent-session.ts, tools/index.ts
+ * [TO]: Consumed by index.ts, external SDK users
+ * [HERE]: core/runtime/catui-agent.ts - high-level wrapper class with simplified API
+ */
+import { type SDKLogger } from "./sdk.js";
+import { type AgentSessionEvent } from "./agent-session.js";
+import type { Api } from "@catui/ai/types";
+import type { ThinkingLevel } from "@catui/agent-core";
+/**
+ * Simplified options for CatuiAgent wrapper.
+ */
+export interface CatuiAgentOptions {
+    /** API key for the provider. If omitted, uses environment variable. */
+    apiKey?: string;
+    /** Provider name: 'anthropic', 'openai', 'google', or any custom provider in models.json. */
+    provider?: string;
+    /** Model ID: 'claude-4-5-20250920', 'gpt-4o', etc. */
+    model?: string;
+    /**
+     * Optional base URL when registering a custom provider on the fly.
+     * Required when `provider` + `model` is not already defined in
+     * ~/.catui/agents/default/models.json. Ignored when the model is found.
+     */
+    baseUrl?: string;
+    /**
+     * Optional API protocol for the dynamically-registered provider.
+     * Defaults to "openai-completions". Ignored when the model is found.
+     */
+    api?: Api;
+    /** Thinking level: 'off' | 'low' | 'medium' | 'high' */
+    thinkingLevel?: ThinkingLevel;
+    /** Working directory. Default: process.cwd() */
+    cwd?: string;
+    /** Initial tool names: ['read', 'bash', 'edit', 'write'] */
+    tools?: string[];
+    /** Enable MCP tools */
+    enableMCP?: boolean;
+    /** Enable Soul personality */
+    enableSoul?: boolean;
+    /** Suppress all console output */
+    silent?: boolean;
+    /** Custom logger */
+    logger?: SDKLogger;
+    /** In-memory session (no persistence) */
+    inMemory?: boolean;
+    /** Abort signal for external control */
+    signal?: AbortSignal;
+}
+/**
+ * Simplified wrapper for Catui SDK.
+ *
+ * @example
+ * ```typescript
+ * // Minimal usage
+ * const agent = new CatuiAgent();
+ * await agent.init();
+ * const result = await agent.run('Hello');
+ *
+ * // With explicit config
+ * const agent = new CatuiAgent({
+ *   apiKey: 'sk-xxx',
+ *   silent: true,
+ * });
+ * await agent.init();
+ * ```
+ */
+export declare class CatuiAgent {
+    private session;
+    private sessionResult;
+    private logger;
+    private options;
+    private cwd;
+    private initialized;
+    private collectedText;
+    private eventListeners;
+    constructor(options?: CatuiAgentOptions);
+    /**
+     * Initialize the agent session.
+     * Must be called before run/chat.
+     */
+    init(): Promise<void>;
+    /**
+     * Resolve constructor-provided provider/model into a Model<any>.
+     *
+     * Lookup order:
+     *   1. Existing entry in modelRegistry (e.g. ~/.catui/agents/default/models.json
+     *      already declares this provider/model — common case for users who ran
+     *      /sal:setup or hand-edited models.json).
+     *   2. Dynamic registration when caller supplied baseUrl + apiKey — lets a
+     *      one-line constructor call wire up a brand-new OpenAI-compatible
+     *      endpoint without touching disk.
+     *   3. Otherwise return undefined and let createAgentSession fall back to
+     *      findInitialModel() (built-in default). The logger surfaces a warning
+     *      in this case so the caller knows their args were not honoured.
+     */
+    private resolveRequestedModel;
+    /**
+     * Handle session events - collects text for run()
+     */
+    private handleEvent;
+    /**
+     * Ensure session is initialized.
+     */
+    private ensureInit;
+    /**
+     * Run a complete task - returns final result.
+     * Blocks until agent finishes all tool calls.
+     *
+     * @example
+     * ```typescript
+     * await agent.init();
+     * const result = await agent.run('Read README.md and summarize');
+     * ```
+     */
+    run(message: string): Promise<string>;
+    /**
+     * Send a prompt and collect events.
+     *
+     * @example
+     * ```typescript
+     * await agent.init();
+     * agent.subscribe((event) => {
+     *   if (event.type === 'tool_call') {
+     *     console.log('Tool:', event.name);
+     *   }
+     * });
+     * await agent.prompt('Hello');
+     * ```
+     */
+    prompt(message: string): Promise<void>;
+    /**
+     * Reset the session (clear conversation history, start a new session).
+     */
+    reset(): Promise<void>;
+    /**
+     * Shutdown the session.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Subscribe to agent events.
+     *
+     * @example
+     * ```typescript
+     * await agent.init();
+     * agent.subscribe((event) => {
+     *   if (event.type === 'sdk:error') {
+     *     console.error('SDK error:', event.error);
+     *   }
+     * });
+     * ```
+     */
+    subscribe(listener: (event: AgentSessionEvent) => void): void;
+    /**
+     * Remove event subscription.
+     */
+    unsubscribe(listener: (event: AgentSessionEvent) => void): void;
+    /**
+     * Check if agent is initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Get last collected text.
+     */
+    getLastText(): string;
+}
+/**
+ * Quick factory for CatuiAgent with auto-init.
+ *
+ * @example
+ * ```typescript
+ * const agent = await quickAgent({ apiKey: 'sk-xxx' });
+ * ```
+ */
+export declare function quickAgent(options?: CatuiAgentOptions): Promise<CatuiAgent>;
+/**
+ * Legacy compatibility alias for SDK users migrating from the Pencil brand.
+ * New code should import CatuiAgent/CatuiAgentOptions from @catui/agent.
+ */
+export { CatuiAgent as PencilAgent };
+export type { CatuiAgentOptions as PencilAgentOptions };

package/dist/core/runtime/catui-agent.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var r=(o,e)=>d(o,"name",{value:e,configurable:!0});import{createAgentSession as c,silentLogger as p,defaultLogger as u}from"./sdk.js";import{allTools as g}from"../tools/index.js";import{AuthStorage as l}from"../platform/config/auth-storage.js";import{SessionManager as a}from"../session/session-manager.js";import{ModelRegistry as f}from"../model-registry.js";class h{static{r(this,"CatuiAgent")}session=null;sessionResult=null;logger;options;cwd;initialized=!1;collectedText="";eventListeners=[];constructor(e={}){this.cwd=e.cwd??process.cwd(),this.options=e,this.logger=e.silent?p:e.logger??u}async init(){if(this.initialized)return;const e=this.options.inMemory?l.inMemory():l.create(),s=new f(e);this.options.apiKey&&this.options.provider&&await e.set(this.options.provider,{type:"api_key",key:this.options.apiKey});const t=this.resolveRequestedModel(s);let n;this.options.tools&&this.options.tools.length>0&&(n=this.options.tools.map(i=>g[i]).filter(i=>i!==void 0)),this.sessionResult=await c({cwd:this.cwd,model:t,thinkingLevel:this.options.thinkingLevel,tools:n,authStorage:e,modelRegistry:s,sessionManager:this.options.inMemory?a.inMemory():a.create(this.cwd),enableMCP:this.options.enableMCP??!1,enableSoul:this.options.enableSoul??!1,silent:this.options.silent,logger:this.logger,signal:this.options.signal}),this.session=this.sessionResult.session,this.sessionResult.modelFallbackMessage&&this.logger.warn(this.sessionResult.modelFallbackMessage),this.session.subscribe(this.handleEvent.bind(this)),this.initialized=!0}resolveRequestedModel(e){const s=this.options.provider,t=this.options.model;if(!s||!t)return;const n=e.find(s,t);if(n)return n;if(this.options.baseUrl)try{e.registerProvider(s,{api:this.options.api??"openai-completions",baseUrl:this.options.baseUrl,apiKey:this.options.apiKey,models:[{id:t,name:t,reasoning:!1,input:["text"],cost:{input:0,output:0,cacheRead:0,cacheWrite:0},contextWindow:128e3,maxTokens:8192}]});const i=e.find(s,t);if(i)return i}catch(i){this.logger.warn(`[CatuiAgent] dynamic provider registration failed for ${s}/${t}: ${i.message}`)}this.logger.warn(`[CatuiAgent] model ${s}/${t} not found in registry. Either add it to ~/.catui/agent/models.json or pass { baseUrl, apiKey } to register it dynamically. Falling back to default model selection.`)}handleEvent(e){for(const s of this.eventListeners)s(e);if(e.type==="message_end"&&e.message?.role==="assistant"){const s=e.message.content;if(typeof s=="string")this.collectedText+=s;else if(Array.isArray(s))for(const t of s)t.type==="text"&&(this.collectedText+=t.text)}}ensureInit(){if(!this.initialized||!this.session)throw new Error("CatuiAgent not initialized. Call init() first.")}async run(e){return this.ensureInit(),this.collectedText="",await this.session.prompt(e),this.collectedText}async prompt(e){this.ensureInit(),await this.session.prompt(e)}async reset(){this.ensureInit(),this.collectedText="",await this.session.newSession()}async shutdown(){this.session&&(this.logger.info("Session shutdown"),this.initialized=!1,this.session=null,this.sessionResult=null)}subscribe(e){this.eventListeners.push(e)}unsubscribe(e){const s=this.eventListeners.indexOf(e);s>=0&&this.eventListeners.splice(s,1)}isInitialized(){return this.initialized}getLastText(){return this.collectedText}}async function M(o={}){const e=new h(o);return await e.init(),e}r(M,"quickAgent");export{h as CatuiAgent,h as PencilAgent,M as quickAgent};

package/dist/core/runtime/compaction-controller.d.ts

@@ -0,0 +1,43 @@
+/**
+ * [WHO]: Provides CompactionController — manual context-window compaction + its abort state
+ * [FROM]: Depends on session/compaction (compact, prepareCompaction, CompactionResult),
+ *         session-manager (CompactionEntry), extensions-host (SessionBeforeCompactResult),
+ *         platform/abort-slot, and ./session-context (CompactionControllerContext)
+ * [TO]: Consumed by core/runtime/agent-session.ts (constructs one, delegates compact()/abortCompaction())
+ * [HERE]: core/runtime/agent-session.ts split (P4.x-a) — owns the manual-compaction abort slot
+ *
+ * Extracted from AgentSession (AS04). Owns the manual compaction flow and its cancellation state.
+ * Auto-compaction (loop-driven) is a later slice (P4.x-b). Session state is reached through the
+ * narrow CompactionControllerContext; behavior is identical to the former AgentSession.compact().
+ */
+import type { AgentMessage } from "@catui/agent-core";
+import { type CompactionResult } from "../session/compaction/index.js";
+import type { CompactionControllerContext } from "./session-context.js";
+export declare class CompactionController {
+    private readonly ctx;
+    /** Cancellation slot for the in-flight manual compaction. */
+    private readonly _slot;
+    /** Cancellation slot for the in-flight auto (loop-driven) compaction. */
+    private readonly _autoSlot;
+    constructor(ctx: CompactionControllerContext);
+    /** Whether a manual or auto compaction is currently running. */
+    get isCompacting(): boolean;
+    /** Cancel an in-progress compaction (manual or auto). */
+    abort(): void;
+    /** Whether auto-compaction is enabled. */
+    get autoCompactionEnabled(): boolean;
+    /** Toggle auto-compaction. */
+    setAutoCompactionEnabled(enabled: boolean): void;
+    /**
+     * Compact the current branch: summarize older entries and rebuild agent messages.
+     * Detaches the agent during the operation and reconnects in finally.
+     */
+    compact(customInstructions?: string): Promise<CompactionResult>;
+    /**
+     * Run auto-compaction (loop-driven). Performs the compaction + emits
+     * auto_compaction_start/end, and returns the rebuilt messages on success (or undefined when
+     * compaction was skipped/aborted/failed). The loop-continuation decision (retry / kick the
+     * queue) stays in AgentSession — this only owns the compaction itself.
+     */
+    runAuto(reason: "overflow" | "threshold", willRetry: boolean): Promise<AgentMessage[] | undefined>;
+}

package/dist/core/runtime/compaction-controller.js

@@ -0,0 +1 @@
+var S=Object.defineProperty;var w=(E,e)=>S(E,"name",{value:e,configurable:!0});import{compact as C,prepareCompaction as b}from"../session/compaction/index.js";import{AbortSlot as A}from"../platform/abort-slot.js";class v{static{w(this,"CompactionController")}ctx;_slot=new A;_autoSlot=new A;constructor(e){this.ctx=e}get isCompacting(){return this._slot.active||this._autoSlot.active}abort(){this._slot.abort(),this._autoSlot.abort()}get autoCompactionEnabled(){return this.ctx.getAutoCompactionEnabled()}setAutoCompactionEnabled(e){this.ctx.setAutoCompactionEnabled(e)}async compact(e){this.ctx.logInfo("Manual compaction started",{hasCustomInstructions:!!e}),this.ctx.disconnectFromAgent(),await this.ctx.abortAgent();const d=this._slot.begin();try{const f=this.ctx.getModel();if(!f)throw new Error("No model selected");const u=await this.ctx.getApiKey(f);if(!u)throw new Error(`No API key for ${f.provider}`);const o=this.ctx.getBranch(),p=this.ctx.getCompactionSettings(),h=b(o,p);if(!h)throw o[o.length-1]?.type==="compaction"?new Error("Already compacted"):new Error("Nothing to compact (session too small)");let i,s=!1;const m=this.ctx.getExtensionRunner();if(m?.hasHandlers("session_before_compact")){const t=await m.emit({type:"session_before_compact",preparation:h,branchEntries:o,customInstructions:e,signal:d});if(t?.cancel)throw new Error("Compaction cancelled");t?.compaction&&(i=t.compaction,s=!0)}let a,r,c,l;if(i)a=i.summary,r=i.firstKeptEntryId,c=i.tokensBefore,l=i.details;else{const t=await C(h,f,u,e,d);a=t.summary,r=t.firstKeptEntryId,c=t.tokensBefore,l=t.details}if(d.aborted)throw new Error("Compaction cancelled");this.ctx.appendCompaction(a,r,c,l,s);const y=this.ctx.getEntries();this.ctx.applyCompactedMessages();const x=y.find(t=>t.type==="compaction"&&t.summary===a);return m&&x&&await m.emit({type:"session_compact",compactionEntry:x,fromExtension:s}),{summary:a,firstKeptEntryId:r,tokensBefore:c,details:l}}finally{this._slot.clear(),this.ctx.reconnectToAgent()}}async runAuto(e,d){this.ctx.logInfo("Auto-compaction triggered",{reason:e,willRetry:d});const f=this.ctx.getCompactionSettings();this.ctx.emitAutoCompactionStart(e);const u=this._autoSlot.begin();try{const o=this.ctx.getModel();if(!o){this.ctx.emitAutoCompactionEnd({result:void 0,aborted:!1,willRetry:!1});return}const p=await this.ctx.getApiKey(o);if(!p){this.ctx.emitAutoCompactionEnd({result:void 0,aborted:!1,willRetry:!1});return}const h=this.ctx.getBranch(),i=b(h,f);if(!i){this.ctx.emitAutoCompactionEnd({result:void 0,aborted:!1,willRetry:!1});return}let s,m=!1;const a=this.ctx.getExtensionRunner();if(a?.hasHandlers("session_before_compact")){const n=await a.emit({type:"session_before_compact",preparation:i,branchEntries:h,customInstructions:void 0,signal:u});if(n?.cancel){this.ctx.emitAutoCompactionEnd({result:void 0,aborted:!0,willRetry:!1});return}n?.compaction&&(s=n.compaction,m=!0)}let r,c,l,y;if(s)r=s.summary,c=s.firstKeptEntryId,l=s.tokensBefore,y=s.details;else{const n=await C(i,o,p,void 0,u);r=n.summary,c=n.firstKeptEntryId,l=n.tokensBefore,y=n.details}if(u.aborted){this.ctx.emitAutoCompactionEnd({result:void 0,aborted:!0,willRetry:!1});return}this.ctx.appendCompaction(r,c,l,y,m);const x=this.ctx.getEntries(),t=this.ctx.applyCompactedMessages(),g=x.find(n=>n.type==="compaction"&&n.summary===r);a&&g&&await a.emit({type:"session_compact",compactionEntry:g,fromExtension:m});const _={summary:r,firstKeptEntryId:c,tokensBefore:l,details:y};return this.ctx.emitAutoCompactionEnd({result:_,aborted:!1,willRetry:d}),t}catch(o){const p=o instanceof Error?o.message:"compaction failed";this.ctx.emitAutoCompactionEnd({result:void 0,aborted:!1,willRetry:!1,errorMessage:e==="overflow"?`Context overflow recovery failed: ${p}`:`Auto-compaction failed: ${p}`});return}finally{this._autoSlot.clear()}}}export{v as CompactionController};

package/dist/core/runtime/default-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [WHO]: Provides createDefaultRuntimeTools()
+ * [FROM]: Depends on SettingsManager and core/tools factories for default runtime tool wiring
+ * [TO]: Consumed by AgentSession runtime construction
+ * [HERE]: core/runtime/default-tools.ts - isolates default tool configuration from session orchestration
+ */
+import type { SettingsManager } from "../platform/config/settings-manager.js";
+import { type Tool, type ToolName } from "../tools/index.js";
+export declare function createDefaultRuntimeTools(cwd: string, settingsManager: SettingsManager): Record<ToolName, Tool>;

package/dist/core/runtime/default-tools.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(e,r)=>a(e,"name",{value:r,configurable:!0});import{createAllTools as i,createWorkspaceWriteGuard as m}from"../tools/index.js";function f(e,r){const t=m(e);return i(e,{read:{autoResizeImages:r.getImageAutoResize()},bash:{commandPrefix:r.getShellCommandPrefix()},edit:{beforeWrite:t},write:{beforeWrite:t}})}o(f,"createDefaultRuntimeTools");export{f as createDefaultRuntimeTools};

package/dist/core/runtime/event-bridge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * [WHO]: Provides ExtensionEventBridge, ExtensionEventBridgeDeps
+ * [FROM]: Depends on agent-core AgentEvent, extensions-host event types, and ExtensionRunner
+ * [TO]: Consumed by core/runtime/agent-session.ts for extension-facing event fanout
+ * [HERE]: core/runtime/event-bridge.ts - narrow extension event mapping extracted from AgentSession
+ *
+ * Extracted from AgentSession (P4.7 / AS07). This bridge owns only AgentEvent ->
+ * extension event mapping and extension turn indexing. AgentSession keeps public
+ * subscribe(), session persistence, retry/compaction ordering, and Soul lifecycle work.
+ */
+import type { AgentEvent } from "@catui/agent-core";
+import { type ExtensionRunner } from "../extensions-host/index.js";
+export interface ExtensionEventBridgeDeps {
+    getExtensionRunner: () => ExtensionRunner | undefined;
+}
+export declare class ExtensionEventBridge {
+    private readonly deps;
+    private _turnIndex;
+    constructor(deps: ExtensionEventBridgeDeps);
+    emitExtensionEvent(event: AgentEvent): Promise<void>;
+}

package/dist/core/runtime/event-bridge.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var o=(a,t)=>i(a,"name",{value:t,configurable:!0});class l{static{o(this,"ExtensionEventBridge")}deps;_turnIndex=0;constructor(t){this.deps=t}async emitExtensionEvent(t){const s=this.deps.getExtensionRunner();if(s){if(t.type==="agent_start")this._turnIndex=0,await s.emit({type:"agent_start"});else if(t.type==="agent_result"){const e={...t};await s.emit(e)}else if(t.type==="turn_start"){const e={type:"turn_start",turnIndex:this._turnIndex,timestamp:Date.now()};await s.emit(e)}else if(t.type==="turn_end"){const e={type:"turn_end",turnIndex:this._turnIndex,message:t.message,toolResults:t.toolResults};await s.emit(e),this._turnIndex++}else if(t.type==="message_start"){const e={type:"message_start",message:t.message};await s.emit(e)}else if(t.type==="message_update"){const e={type:"message_update",message:t.message,assistantMessageEvent:t.assistantMessageEvent};await s.emit(e)}else if(t.type==="message_end"){const e={type:"message_end",message:t.message};await s.emit(e)}else if(t.type==="tool_execution_start"){const e={type:"tool_execution_start",toolCallId:t.toolCallId,toolName:t.toolName,args:t.args};await s.emit(e)}else if(t.type==="tool_execution_update"){const e={type:"tool_execution_update",toolCallId:t.toolCallId,toolName:t.toolName,args:t.args,partialResult:t.partialResult};await s.emit(e)}else if(t.type==="tool_execution_end"){const e={type:"tool_execution_end",toolCallId:t.toolCallId,toolName:t.toolName,result:t.result,isError:t.isError};await s.emit(e)}}}}export{l as ExtensionEventBridge};

package/dist/core/runtime/event-bus.d.ts

@@ -0,0 +1,8 @@
+export interface EventBus {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: (data: unknown) => void): () => void;
+}
+export interface EventBusController extends EventBus {
+    clear(): void;
+}
+export declare function createEventBus(): EventBusController;

package/dist/core/runtime/event-bus.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var t=(e,r)=>s(e,"name",{value:r,configurable:!0});import{EventEmitter as a}from"node:events";function u(){const e=new a;return{emit:t((r,n)=>{e.emit(r,n)},"emit"),on:t((r,n)=>{const o=t(async i=>{try{await n(i)}catch(m){e.emit("eventbus:handler-error",{channel:r,error:m})}},"safeHandler");return e.on(r,o),()=>e.off(r,o)},"on"),clear:t(()=>{e.removeAllListeners()},"clear")}}t(u,"createEventBus");export{u as createEventBus};

package/dist/core/runtime/export-bridge.d.ts

@@ -0,0 +1,23 @@
+/**
+ * [WHO]: Provides exportSessionHtml(), getLastAssistantText()
+ * [FROM]: Depends on agent-core/ai public message types, export-html, ExtensionRunner, SessionManager, Theme
+ * [TO]: Consumed by core/runtime/agent-session.ts facade methods
+ * [HERE]: core/runtime/export-bridge.ts - HTML export bridge extracted from AgentSession
+ *
+ * Extracted from AgentSession (P4.6). This module owns HTML export wiring and last-assistant
+ * text extraction. AgentSession remains the public facade and injects the optional Theme.
+ */
+import type { AgentMessage, AgentState } from "@catui/agent-core";
+import type { ExtensionRunner } from "../extensions-host/index.js";
+import type { SessionManager } from "../session/session-manager.js";
+import type { Theme } from "../theme-contract.js";
+export interface ExportSessionHtmlOptions {
+    sessionManager: SessionManager;
+    state: AgentState;
+    outputPath?: string;
+    themeName?: string;
+    extensionRunner?: ExtensionRunner;
+    theme?: Theme;
+}
+export declare function exportSessionHtml(options: ExportSessionHtmlOptions): Promise<string>;
+export declare function getLastAssistantText(messages: ReadonlyArray<AgentMessage>): string | undefined;

package/dist/core/runtime/export-bridge.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var o=(e,t)=>i(e,"name",{value:t,configurable:!0});import{exportSessionToHtml as s}from"../export-html/index.js";import{createToolHtmlRenderer as a}from"../export-html/tool-renderer.js";async function m(e){const t=e.extensionRunner&&e.theme?a({getToolDefinition:o(r=>e.extensionRunner.getToolDefinition(r),"getToolDefinition"),theme:e.theme}):void 0;return await s(e.sessionManager,e.state,{outputPath:e.outputPath,themeName:e.themeName,toolRenderer:t})}o(m,"exportSessionHtml");function c(e){const t=e.slice().reverse().find(n=>!(n.role!=="assistant"||n.stopReason==="aborted"&&n.content.length===0));if(!t)return;let r="";for(const n of t.content)n.type==="text"&&(r+=n.text);return r.trim()||void 0}o(c,"getLastAssistantText");export{m as exportSessionHtml,c as getLastAssistantText};

package/dist/core/runtime/extension-core-bindings.d.ts

@@ -0,0 +1,46 @@
+/**
+ * [WHO]: Provides bindExtensionCore() — wires AgentSession host methods to ExtensionRunner APIs, including LLM call telemetry (every ctx.completeSimple / completeSimpleWithUsage / completeJson emits one ext_llm_calls row)
+ * [FROM]: Depends on ExtensionRunner, model/session/resource abstractions, slash command metadata, core/platform/telemetry (getExtCallerContext for caller attribution + LlmCallEventInput shape)
+ * [TO]: Consumed by AgentSession when initializing extension runtime capabilities
+ * [HERE]: core/runtime/extension-core-bindings.ts - the LLM-call instrumentation point; reads AsyncLocalStorage context pushed by runner.invokeCommand (user-initiated=true) or runner.invokeHookHandler (user-initiated=false) to attribute each call. is_user_initiated=false rows grouped by extension_name + caller_context are the idle-thinking bug detector.
+ */
+import type { Model } from "@catui/ai/types";
+import type { ThinkingLevel } from "@catui/agent-core";
+import type { SettingsManager } from "../platform/config/settings-manager.js";
+import type { ResourceLoader } from "../platform/config/resource-loader.js";
+import type { ExtensionActions, ExtensionRunner, ToolInfo } from "../extensions-host/index.js";
+import type { ModelRegistry } from "../model-registry.js";
+import type { PromptTemplate } from "../prompt/prompt-templates.js";
+import type { SessionManager } from "../session/session-manager.js";
+import type { ContextUsage } from "../extensions-host/types.js";
+import type { CompactionResult } from "../session/compaction/index.js";
+type SendMessage = ExtensionActions["sendMessage"];
+type SendUserMessage = ExtensionActions["sendUserMessage"];
+export interface ExtensionCoreBindingHost {
+    promptTemplates: ReadonlyArray<PromptTemplate>;
+    resourceLoader: ResourceLoader;
+    modelRegistry: ModelRegistry;
+    sessionManager: SessionManager;
+    settingsManager: SettingsManager;
+    shutdownHandler?: () => void;
+    soulManager?: unknown;
+    get model(): Model<any> | undefined;
+    get thinkingLevel(): ThinkingLevel;
+    get isStreaming(): boolean;
+    get pendingMessageCount(): number;
+    get systemPrompt(): string;
+    sendCustomMessage: (message: Parameters<SendMessage>[0], options?: Parameters<SendMessage>[1]) => Promise<void>;
+    sendUserMessage: (content: Parameters<SendUserMessage>[0], options?: Parameters<SendUserMessage>[1]) => Promise<void>;
+    executeSlashCommand(text: string): Promise<boolean>;
+    getActiveToolNames(): string[];
+    getAllTools(): ToolInfo[];
+    setActiveToolsByName(toolNames: string[]): void;
+    setModel(model: Model<any>): Promise<void>;
+    setThinkingLevel(level: ThinkingLevel): void;
+    abort(): Promise<void> | void;
+    clearFollowUpQueue(): void;
+    getContextUsage(): ContextUsage | undefined;
+    compact(customInstructions?: string): Promise<CompactionResult>;
+}
+export declare function bindExtensionCore(runner: ExtensionRunner, host: ExtensionCoreBindingHost): void;
+export {};

package/dist/core/runtime/extension-core-bindings.js

@@ -0,0 +1,3 @@
+var E=Object.defineProperty;var t=(n,e)=>E(n,"name",{value:e,configurable:!0});import{completeSimple as S}from"@catui/ai/stream";import{getExtCallerContext as T}from"../platform/telemetry/index.js";import{buildExtensionSlashCommands as A}from"./slash-command-catalog.js";function I(n,e){switch(n.api){case"openai-completions":return{type:"function",function:{name:e}};case"anthropic-messages":case"bedrock-converse-stream":return{type:"tool",name:e};case"google-generative-ai":case"google-gemini-cli":case"google-vertex":return"any";default:return"required"}}t(I,"getStructuredToolChoice");function L(n){return n.type==="text"}t(L,"isTextContent");function N(n,e){return n.type==="toolCall"&&"name"in n&&n.name===e}t(N,"isNamedToolCall");function v(n){const e=T();return{extensionName:e?.extensionName??"unknown",callerContext:e?.callerContext??"unknown",isUserInitiated:e?.isUserInitiated??!1,modelId:n.model?.id??null,tokensIn:n.usage?.input??null,tokensOut:n.usage?.output??null,costTotal:n.usage?.cost?.total??null,durationMs:Math.round(performance.now()-n.startPerf),ok:n.ok,errorCode:n.errorCode,startedAt:n.startedAt,endedAt:new Date,sessionId:e?.sessionId??n.host.sessionManager.getSessionId(),runId:e?.runId??null,variant:e?.variant??null}}t(v,"buildLlmCallEvent");async function P(n,e,o,r){return(await M(n,e,o,r))?.text}t(P,"completeTextWithCurrentModel");async function M(n,e,o,r){const a=e.model;if(!a)return;const s=await e.modelRegistry.getApiKey(a);if(!s)return;const c=new Date,d=performance.now();let i=!0,g=null,m,u;try{const l=await S(a,{systemPrompt:o,messages:[{role:"user",content:r,timestamp:Date.now()}]},{maxTokens:1500,temperature:.2,apiKey:s});m=l.usage,u=l.content?.filter(L).map(p=>p.text??"").join("")??""}catch(l){i=!1,g=l instanceof Error?l.constructor.name:"unknown"}if(n.writeLlmCallEvent(v({host:e,model:a,startedAt:c,startPerf:d,ok:i,errorCode:g,usage:m})),!(!i||u===void 0||m===void 0))return{text:u,usage:m}}t(M,"completeTextWithUsage");async function U(n,e,o,r,a,s){const c=e.model;if(!c)return;const d=await e.modelRegistry.getApiKey(c);if(!d)return;const i=s?.toolName||"submit_json",g=new Date,m=performance.now();let u=!0,l=null,p,w;try{const f=a,k={maxTokens:1500,temperature:0,apiKey:d,toolChoice:I(c,i)},x=await S(c,{systemPrompt:`${o}
+
+You must call the ${i} tool exactly once with the final structured JSON payload. Do not answer in prose.`,messages:[{role:"user",content:r,timestamp:Date.now()}],tools:[{name:i,description:"Submit the final structured JSON payload.",parameters:f}]},k);p=x.usage;const y=x.content?.find(C=>N(C,i));if(y){const C=s?.resultKey?y.arguments?.[s.resultKey]:y.arguments;w=JSON.stringify(C)}}catch(f){u=!1,l=f instanceof Error?f.constructor.name:"unknown"}if(n.writeLlmCallEvent(v({host:e,model:c,startedAt:g,startPerf:m,ok:u,errorCode:l,usage:p})),!!u)return w}t(U,"completeJsonWithCurrentModel");function O(n,e){n.bindCore({sendMessage:t((o,r)=>{e.sendCustomMessage(o,r).catch(a=>{n.emitError({extensionPath:"<runtime>",event:"send_message",error:a instanceof Error?a.message:String(a)})})},"sendMessage"),sendUserMessage:t((o,r)=>{e.sendUserMessage(o,r).catch(a=>{n.emitError({extensionPath:"<runtime>",event:"send_user_message",error:a instanceof Error?a.message:String(a)})})},"sendUserMessage"),executeCommand:t(async o=>{try{return await e.executeSlashCommand(o)}catch(r){return n.emitError({extensionPath:"<runtime>",event:"execute_command",error:r instanceof Error?r.message:String(r)}),!1}},"executeCommand"),appendEntry:t((o,r)=>{e.sessionManager.appendCustomEntry(o,r)},"appendEntry"),setSessionName:t(o=>{e.sessionManager.appendSessionInfo(o)},"setSessionName"),getSessionName:t(()=>e.sessionManager.getSessionName(),"getSessionName"),setLabel:t((o,r)=>{e.sessionManager.appendLabelChange(o,r)},"setLabel"),getActiveTools:t(()=>e.getActiveToolNames(),"getActiveTools"),getAllTools:t(()=>e.getAllTools(),"getAllTools"),setActiveTools:t(o=>e.setActiveToolsByName(o),"setActiveTools"),getCommands:t(()=>A({promptTemplates:e.promptTemplates,resourceLoader:e.resourceLoader,extensionRunner:n}),"getCommands"),setModel:t(async o=>await e.modelRegistry.getApiKey(o)?(await e.setModel(o),!0):!1,"setModel"),getThinkingLevel:t(()=>e.thinkingLevel,"getThinkingLevel"),setThinkingLevel:t(o=>e.setThinkingLevel(o),"setThinkingLevel")},{getModel:t(()=>e.model,"getModel"),completeSimple:t((o,r)=>P(n,e,o,r),"completeSimple"),completeSimpleWithUsage:t((o,r)=>M(n,e,o,r),"completeSimpleWithUsage"),completeJson:t((o,r,a,s)=>U(n,e,o,r,a,s),"completeJson"),getSettings:t(()=>e.settingsManager.getSettings(),"getSettings"),isIdle:t(()=>!e.isStreaming,"isIdle"),abort:t(()=>{e.abort()},"abort"),clearFollowUpQueue:t(()=>e.clearFollowUpQueue(),"clearFollowUpQueue"),hasPendingMessages:t(()=>e.pendingMessageCount>0,"hasPendingMessages"),shutdown:t(()=>{e.shutdownHandler?.()},"shutdown"),getContextUsage:t(()=>e.getContextUsage(),"getContextUsage"),compact:t(o=>{(async()=>{try{const r=await e.compact(o?.customInstructions);o?.onComplete?.(r)}catch(r){const a=r instanceof Error?r:new Error(String(r));o?.onError?.(a)}})()},"compact"),getSystemPrompt:t(()=>e.systemPrompt,"getSystemPrompt"),getSoulManager:t(()=>e.soulManager,"getSoulManager"),getSkills:t(()=>e.resourceLoader.getSkills().skills,"getSkills")})}t(O,"bindExtensionCore");export{O as bindExtensionCore};