catui-agent 1.0.0-beta.0

package/dist/core/extensions-host/types.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var t=(o,e)=>r(o,"name",{value:e,configurable:!0});function l(o){return o.toolName==="bash"}t(l,"isBashToolResult");function u(o){return o.toolName==="read"}t(u,"isReadToolResult");function i(o){return o.toolName==="edit"}t(i,"isEditToolResult");function s(o){return o.toolName==="write"}t(s,"isWriteToolResult");function a(o){return o.toolName==="grep"}t(a,"isGrepToolResult");function p(o){return o.toolName==="find"}t(p,"isFindToolResult");function f(o){return o.toolName==="ls"}t(f,"isLsToolResult");function T(o,e){return e.toolName===o}t(T,"isToolCallEventType");export{l as isBashToolResult,i as isEditToolResult,p as isFindToolResult,a as isGrepToolResult,f as isLsToolResult,u as isReadToolResult,T as isToolCallEventType,s as isWriteToolResult};

package/dist/core/extensions-host/wrapper.d.ts

@@ -0,0 +1,29 @@
+/**
+ * [WHO]: wrapRegisteredTool()
+ * [FROM]: Depends on agent-core, extensions/runner, extensions/types
+ * [TO]: Consumed by core/extensions-host/index.ts
+ * [HERE]: core/extensions-host/wrapper.ts - wraps RegisteredTool into AgentTool
+ */
+import type { AgentTool } from "@catui/agent-core";
+import type { ExtensionRunner } from "./runner.js";
+import type { RegisteredTool } from "./types.js";
+/**
+ * Wrap a RegisteredTool into an AgentTool.
+ * Uses the runner's createContext() for consistent context across tools and event handlers.
+ */
+export declare function wrapRegisteredTool(registeredTool: RegisteredTool, runner: ExtensionRunner): AgentTool;
+/**
+ * Wrap all registered tools into AgentTools.
+ * Uses the runner's createContext() for consistent context across tools and event handlers.
+ */
+export declare function wrapRegisteredTools(registeredTools: RegisteredTool[], runner: ExtensionRunner): AgentTool[];
+/**
+ * Wrap a tool with extension callbacks for interception.
+ * - Emits tool_call event before execution (can block)
+ * - Emits tool_result event after execution (can modify result)
+ */
+export declare function wrapToolWithExtensions<T>(tool: AgentTool<any, T>, runner: ExtensionRunner): AgentTool<any, T>;
+/**
+ * Wrap all tools with extension callbacks.
+ */
+export declare function wrapToolsWithExtensions<T>(tools: AgentTool<any, T>[], runner: ExtensionRunner): AgentTool<any, T>[];

package/dist/core/extensions-host/wrapper.js

@@ -0,0 +1,2 @@
+var f=Object.defineProperty;var i=(r,n)=>f(r,"name",{value:n,configurable:!0});function m(r,n){const{definition:e}=r;return{name:e.name,label:e.label,description:e.description,parameters:e.parameters,aliases:e.aliases,isConcurrencySafe:e.isConcurrencySafe,interruptBehavior:e.interruptBehavior,validateInput:e.validateInput,maxResultSizeChars:e.maxResultSizeChars,execute:i((s,l,c,a)=>e.execute(s,l,c,a,n.createContext()),"execute")}}i(m,"wrapRegisteredTool");function w(r,n){return r.map(e=>m(e,n))}i(w,"wrapRegisteredTools");function x(r,n){return{...r,execute:i(async(e,s,l,c)=>{let a=s;if(n.hasHandlers("tool_call"))try{const t=await n.emitToolCall({type:"tool_call",toolName:r.name,toolCallId:e,input:a});if(t?.block){const o=t.reason||"Tool execution was blocked by an extension";throw new Error(o)}t?.input&&(a=t.input)}catch(t){throw t instanceof Error?t:new Error(`Extension failed, blocking execution: ${String(t)}`)}try{const t=await r.execute(e,a,l,c);if(n.hasHandlers("tool_result")){const o=await n.emitToolResult({type:"tool_result",toolName:r.name,toolCallId:e,input:a,content:t.content,details:t.details,isError:!1});if(o)return{content:o.content??t.content,details:o.details??t.details}}return t}catch(t){if(n.hasHandlers("tool_result")){const o=await n.emitToolResult({type:"tool_result",toolName:r.name,toolCallId:e,input:a,content:[{type:"text",text:t instanceof Error?t.message:String(t)}],details:void 0,isError:!0});if(o?.content){const p=o.content.filter(u=>u.type==="text").map(u=>u.text).join(`
+`);throw new Error(p||(t instanceof Error?t.message:String(t)))}}throw t}},"execute")}}i(x,"wrapToolWithExtensions");function h(r,n){return r.map(e=>x(e,n))}i(h,"wrapToolsWithExtensions");export{m as wrapRegisteredTool,w as wrapRegisteredTools,x as wrapToolWithExtensions,h as wrapToolsWithExtensions};

package/dist/core/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * [WHO]: Barrel exports for core API surface
+ * [FROM]: Depends on runtime/, tools/, extensions/, session/, model/, config/
+ * [TO]: Consumed by index.ts (package root barrel)
+ * [HERE]: Public entry point for core functionality; consumed by modes and SDK
+ */
+export { AgentSession, type AgentSessionConfig, type AgentSessionEvent, type AgentSessionEventListener, type ModelCycleResult, type PromptOptions, type SessionStats, } from "./runtime/agent-session.js";
+export { type BashExecutorOptions, type BashResult, executeBash, executeBashWithOperations, } from "./platform/exec/bash-executor.js";
+export type { CompactionResult } from "./session/compaction/index.js";
+export { createEventBus, type EventBus, type EventBusController, } from "./runtime/event-bus.js";
+export { CatuiAgent, quickAgent, type CatuiAgentOptions, } from "./runtime/catui-agent.js";
+export { type SDKLogger, silentLogger, defaultLogger, } from "./runtime/sdk.js";
+export { type AgentEndEvent, type AgentStartEvent, type AgentToolResult, type AgentToolUpdateCallback, type BeforeAgentStartEvent, type ContextEvent, discoverAndLoadExtensions, type ExecOptions, type ExecResult, type Extension, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ExtensionError, type ExtensionEvent, type ExtensionFactory, type ExtensionFlag, type ExtensionHandler, ExtensionRunner, type ExtensionShortcut, type ExtensionUIContext, type LoadExtensionsResult, type MessageRenderer, type RegisteredCommand, type SessionBeforeCompactEvent, type SessionBeforeForkEvent, type SessionBeforeSwitchEvent, type SessionBeforeTreeEvent, type SessionCompactEvent, type SessionForkEvent, type SessionShutdownEvent, type SessionStartEvent, type SessionSwitchEvent, type SessionTreeEvent, type ToolCallEvent, type ToolDefinition, type ToolRenderResultOptions, type ToolResultEvent, type TurnEndEvent, type TurnStartEvent, wrapToolsWithExtensions, } from "./extensions-host/index.js";
+export { MCPManager } from "./mcp/mcp-manager.js";
+export { getDebugLogger, createDebugLogger, debug, type DebugLogLevel, } from "./lib/ai/dist/debug-logger.js";
+export type { MCPServerConfig, MCPTool, MCPToolResult, } from "./mcp/mcp-types.js";
+export { loadMCPConfig, saveMCPConfig, addMCPServer, removeMCPServer, getMCPServer, listMCPServers, listEnabledMCPServers, } from "./mcp/mcp-config.js";

package/dist/core/index.js

@@ -0,0 +1 @@
+import{AgentSession as o}from"./runtime/agent-session.js";import{executeBash as n,executeBashWithOperations as g}from"./platform/exec/bash-executor.js";import{createEventBus as a}from"./runtime/event-bus.js";import{CatuiAgent as x,quickAgent as f}from"./runtime/catui-agent.js";import{silentLogger as C,defaultLogger as m}from"./runtime/sdk.js";import{discoverAndLoadExtensions as d,ExtensionRunner as v,wrapToolsWithExtensions as M}from"./extensions-host/index.js";import{MCPManager as l}from"./mcp/mcp-manager.js";import{getDebugLogger as S,createDebugLogger as E,debug as L}from"./lib/ai/dist/debug-logger.js";import{loadMCPConfig as h,saveMCPConfig as A,addMCPServer as B,removeMCPServer as D,getMCPServer as W,listMCPServers as k,listEnabledMCPServers as q}from"./mcp/mcp-config.js";export{o as AgentSession,x as CatuiAgent,v as ExtensionRunner,l as MCPManager,B as addMCPServer,E as createDebugLogger,a as createEventBus,L as debug,m as defaultLogger,d as discoverAndLoadExtensions,n as executeBash,g as executeBashWithOperations,S as getDebugLogger,W as getMCPServer,q as listEnabledMCPServers,k as listMCPServers,h as loadMCPConfig,f as quickAgent,D as removeMCPServer,A as saveMCPConfig,C as silentLogger,M as wrapToolsWithExtensions};

package/dist/core/lib/agent-core/src/agent-loop-continuations.d.ts

@@ -0,0 +1,17 @@
+/**
+ * [WHO]: Provides output-token recovery and token-budget continuation helpers for agent loops.
+ * [FROM]: Depends on @catui/ai message types and AgentLoopConfig budget settings.
+ * [TO]: Consumed by standard and structured-adaptive agent loops.
+ * [HERE]: core/lib/agent-core/src/agent-loop-continuations.ts within agent-core; shared loop continuation policy.
+ */
+import type { AssistantMessage, UserMessage } from "@catui/ai/types";
+import type { AgentLoopConfig } from "./types.js";
+export declare const DEFAULT_OUTPUT_TOKEN_BUDGET_THRESHOLD_PCT = 0.9;
+export declare const DEFAULT_OUTPUT_TOKEN_BUDGET_CONTINUATIONS = 3;
+export declare function computeRecoveryMaxTokens(config: AgentLoopConfig, message: AssistantMessage): number | undefined;
+export declare function createOutputTokenRecoveryMessage(attempt: number): UserMessage;
+export declare function createTokenBudgetContinuation(config: AgentLoopConfig, outputTokens: number, continuationCount: number): {
+    message: UserMessage;
+    outputTokens: number;
+    targetTokens: number;
+} | undefined;

package/dist/core/lib/agent-core/src/agent-loop-continuations.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var s=(t,e)=>c(t,"name",{value:e,configurable:!0});const x=.9,p=3;function M(t,e){const a=Math.max(1,Math.floor(t.model.maxTokens||1)),o=t.maxTokens!==void 0?Math.max(1,Math.floor(t.maxTokens)):void 0,n=Math.max(1,Math.floor(e.usage.output||1)),u=o??n,i=Math.max(u+1,Math.ceil(Math.max(u,n)*1.5));return Math.min(a,i)}s(M,"computeRecoveryMaxTokens");function l(t){return{role:"user",content:[{type:"text",text:`Continue the previous response from exactly where it stopped. This is automatic output-token recovery attempt ${t}.`}],timestamp:Date.now()}}s(l,"createOutputTokenRecoveryMessage");function f(t,e,a){const o=t.outputTokenBudget;if(!o)return;const n=Math.max(1,Math.floor(o.targetTokens)),u=d(o.thresholdPct??.9,0,1);if(Math.max(0,Math.floor(o.maxContinuations??3))<=a)return;const r=Math.max(0,Math.floor(e)),T=Math.ceil(n*u);return r>=T?void 0:{message:{role:"user",content:[{type:"text",text:`Continue because the output token budget is underused (${r}/${n} tokens). Add the missing useful detail directly; do not recap or apologize.`}],timestamp:Date.now()},outputTokens:r,targetTokens:n}}s(f,"createTokenBudgetContinuation");function d(t,e,a){return Number.isFinite(t)?Math.min(a,Math.max(e,t)):e}s(d,"clamp");export{p as DEFAULT_OUTPUT_TOKEN_BUDGET_CONTINUATIONS,x as DEFAULT_OUTPUT_TOKEN_BUDGET_THRESHOLD_PCT,M as computeRecoveryMaxTokens,l as createOutputTokenRecoveryMessage,f as createTokenBudgetContinuation};

package/dist/core/lib/agent-core/src/agent-loop-stream-events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * [WHO]: Provides waitForAbortableOperation(), waitForAssistantStream(), waitForAssistantStreamEvent()
+ * [FROM]: Depends on @catui/ai AssistantMessageEvent/AssistantMessageEventStream contracts.
+ * [TO]: Consumed by standard and structured-adaptive agent loops.
+ * [HERE]: core/lib/agent-core/src/agent-loop-stream-events.ts within agent-core; shared abortable operation and assistant-stream iterator utilities.
+ */
+import type { AssistantMessageEvent } from "@catui/ai/types";
+import type { AssistantMessageEventStream } from "@catui/ai/events";
+export type AssistantStreamNext = IteratorResult<AssistantMessageEvent> | "aborted";
+export type AssistantStreamStart = AssistantMessageEventStream | "aborted";
+export type AbortableOperationResult<T> = {
+    type: "resolved";
+    value: T;
+} | {
+    type: "aborted";
+};
+export declare function waitForAbortableOperation<T>(valueOrPromise: T | Promise<T>, signal?: AbortSignal): Promise<AbortableOperationResult<T>>;
+export declare function waitForAssistantStream(streamOrPromise: AssistantMessageEventStream | Promise<AssistantMessageEventStream>, signal?: AbortSignal): Promise<AssistantStreamStart>;
+export declare function waitForAssistantStreamEvent(iterator: AsyncIterator<AssistantMessageEvent>, signal?: AbortSignal): Promise<AssistantStreamNext>;

package/dist/core/lib/agent-core/src/agent-loop-stream-events.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var r=(o,e)=>s(o,"name",{value:e,configurable:!0});function u(o,e){return e?.aborted?Promise.resolve({type:"aborted"}):new Promise((t,b)=>{const n=r(()=>{e?.removeEventListener("abort",i)},"cleanup"),i=r(()=>{n(),t({type:"aborted"})},"onAbort");e?.addEventListener("abort",i,{once:!0}),Promise.resolve(o).then(a=>{n(),t({type:"resolved",value:a})},a=>{n(),b(a)})})}r(u,"waitForAbortableOperation");function c(o,e){return u(o,e).then(t=>t.type==="aborted"?"aborted":t.value)}r(c,"waitForAssistantStream");function p(o,e){return e?.aborted?Promise.resolve("aborted"):new Promise((t,b)=>{const n=r(()=>{e?.removeEventListener("abort",i)},"cleanup"),i=r(()=>{n(),t("aborted")},"onAbort");e?.addEventListener("abort",i,{once:!0}),o.next().then(a=>{n(),t(a)},a=>{n(),b(a)})})}r(p,"waitForAssistantStreamEvent");export{u as waitForAbortableOperation,c as waitForAssistantStream,p as waitForAssistantStreamEvent};

package/dist/core/lib/agent-core/src/agent-loop-tool-results.d.ts

@@ -0,0 +1,10 @@
+/**
+ * [WHO]: Provides enforceToolResultBatchSize(), createInterruptedToolResults(), and createSkippedToolCallLimitResults() for bounded and complete tool-result batches.
+ * [FROM]: Depends on @catui/ai AssistantMessage/ToolResultMessage/TextContent shapes.
+ * [TO]: Consumed by standard and structured-adaptive agent loops before appending tool results.
+ * [HERE]: core/lib/agent-core/src/agent-loop-tool-results.ts within agent-core; shared tool-result budget policy.
+ */
+import type { AssistantMessage, ToolResultMessage } from "@catui/ai/types";
+export declare function enforceToolResultBatchSize(toolResults: ToolResultMessage[], maxChars: number | undefined): ToolResultMessage[];
+export declare function createInterruptedToolResults(assistantMessage: AssistantMessage, existingToolResultIds?: ReadonlySet<string>): ToolResultMessage[];
+export declare function createSkippedToolCallLimitResults(assistantMessage: AssistantMessage, reasonText: string): ToolResultMessage[];

package/dist/core/lib/agent-core/src/agent-loop-tool-results.js

@@ -0,0 +1,3 @@
+var x=Object.defineProperty;var a=(t,e)=>x(t,"name",{value:e,configurable:!0});function m(t,e){if(!e||e<=0||t.length===0)return t;const r=Math.floor(e);let n=p(t);if(n<=r)return t;const s=[...t],i=t.map((o,l)=>({index:l,size:d(o.content),isError:o.isError})).filter(o=>o.size>0).sort((o,l)=>o.isError!==l.isError?o.isError?1:-1:l.size-o.size||o.index-l.index);for(const o of i){if(n<=r)break;const l=n-r,c=Math.max(0,o.size-l),u=f(s[o.index],c,r);s[o.index]=u.result,n=n-o.size+u.textChars}return s}a(m,"enforceToolResultBatchSize");function y(t,e=new Set){const r=t.content.filter(i=>i.type==="toolCall");if(r.length===0)return[];const n=t.stopReason,s=n==="aborted"?"Tool call interrupted because the assistant response was aborted.":"Tool call interrupted because the assistant response ended with an error.";return r.filter(i=>!e.has(i.id)).map(i=>({role:"toolResult",toolCallId:i.id,toolName:i.name,content:[{type:"text",text:s}],details:{errorType:"interrupted_tool_call",stopReason:n,errorMessage:t.errorMessage},isError:!0,timestamp:Date.now()}))}a(y,"createInterruptedToolResults");function b(t,e){return t.content.filter(n=>n.type==="toolCall").map(n=>({role:"toolResult",toolCallId:n.id,toolName:n.name,content:[{type:"text",text:e}],details:{errorType:"tool_call_limit_reached",toolName:n.name,toolCallId:n.id},isError:!0,timestamp:Date.now()}))}a(b,"createSkippedToolCallLimitResults");function f(t,e,r){const n=d(t.content);if(n<=e)return{result:t,textChars:n};const s=`[Tool result truncated by batch budget: original ${n} chars.]`;let i="";if(e>0)if(e<=s.length)i=s.slice(0,e);else{const c=`
+
+${s}`,u=Math.max(0,e-c.length);i=`${h(t.content).slice(0,u)}${c}`}let o=!1;const l=t.content.map(c=>c.type!=="text"?c:o?{...c,text:""}:(o=!0,{...c,text:i}));return o||l.push({type:"text",text:i}),{result:{...t,content:l,details:{...typeof t.details=="object"&&t.details!==null?t.details:{},truncationReason:"tool_result_batch_budget",originalTextChars:n,retainedTextChars:i.length,maxToolResultBatchSizeChars:r}},textChars:i.length}}a(f,"truncateToolResultToTextChars");function p(t){return t.reduce((e,r)=>e+d(r.content),0)}a(p,"sumToolResultTextChars");function d(t){return t.reduce((e,r)=>e+(r.type==="text"?r.text.length:0),0)}a(d,"sumTextContentChars");function h(t){return t.filter(e=>e.type==="text").map(e=>e.text).join("")}a(h,"flattenTextContent");export{y as createInterruptedToolResults,b as createSkippedToolCallLimitResults,m as enforceToolResultBatchSize};

package/dist/core/lib/agent-core/src/agent-loop-tool-summaries.d.ts

@@ -0,0 +1,22 @@
+/**
+ * [WHO]: Provides PendingToolUseSummary, flushReadyToolUseSummaries(), and startToolUseSummary().
+ * [FROM]: Depends on AgentLoopConfig/AgentMessage contracts and tool result message shapes.
+ * [TO]: Consumed by standard and structured-adaptive agent loops for non-blocking tool summaries.
+ * [HERE]: core/lib/agent-core/src/agent-loop-tool-summaries.ts within agent-core; shared tool summary policy.
+ */
+import type { ToolResultMessage } from "@catui/ai/types";
+import type { EventStream } from "@catui/ai/events";
+import type { AgentEvent, AgentLoopConfig, AgentMessage } from "./types.js";
+export type PendingToolUseSummary = {
+    read(): {
+        settled: boolean;
+        value?: AgentMessage;
+    };
+};
+export declare function flushReadyToolUseSummaries(pendingSummaries: PendingToolUseSummary[], currentMessages: AgentMessage[], newMessages: AgentMessage[], stream: EventStream<AgentEvent, AgentMessage[]>): PendingToolUseSummary[];
+export declare function startToolUseSummary(config: AgentLoopConfig, event: {
+    assistantMessage: AgentMessage;
+    toolResults: ToolResultMessage[];
+    contextMessages: AgentMessage[];
+    messages: AgentMessage[];
+}): PendingToolUseSummary | undefined;

package/dist/core/lib/agent-core/src/agent-loop-tool-summaries.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var r=(e,t)=>l(e,"name",{value:t,configurable:!0});function c(e,t,u,n){if(e.length===0)return e;const a=[];for(const o of e){const s=o.read();if(!s.settled){a.push(o);continue}s.value&&(t.push(s.value),u.push(s.value),n.push({type:"message_start",message:s.value}),n.push({type:"message_end",message:s.value}))}return a}r(c,"flushReadyToolUseSummaries");function i(e,t){if(e.createToolUseSummary)try{const u=e.createToolUseSummary({...t,messages:[...t.messages]});return f(u)}catch{return}}r(i,"startToolUseSummary");function f(e){if(!e)return;if(typeof e.then!="function")return{read:r(()=>({settled:!0,value:e}),"read")};let t=!1,u;return e.then(n=>{t=!0,u=n},()=>{t=!0,u=void 0}),{read:r(()=>({settled:t,value:u}),"read")}}r(f,"trackToolUseSummary");export{c as flushReadyToolUseSummaries,i as startToolUseSummary};

package/dist/core/lib/agent-core/src/agent-loop.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Agent loop that works with AgentMessage throughout.
+ * Transforms to Message[] only at the LLM call boundary.
+ */
+/**
+ * [WHO]: Provides agentLoop(), agentLoopContinue(), standard loop event emission, continuation recovery, recovered-error tombstoning, and serial tool execution.
+ * [FROM]: Depends on @catui/ai streams/messages, ./types contracts, ./errors, and shared loop helpers.
+ * [TO]: Consumed by agent.ts and package exports as the default agent execution loop.
+ * [HERE]: core/lib/agent-core/src/agent-loop.ts within agent-core; standard counterpart to structured-adaptive-agent-loop.ts.
+ */
+import { EventStream } from "@catui/ai/events";
+import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from "./types.js";
+/**
+ * Start an agent loop with a new prompt message.
+ * The prompt is added to the context and events are emitted for it.
+ */
+export declare function agentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;
+/**
+ * Continue an agent loop from the current context without adding a new message.
+ * Used for retries - context already has user message or tool results.
+ *
+ * **Important:** The last message in context must convert to a `user` or `toolResult` message
+ * via `convertToLlm`. If it doesn't, the LLM provider will reject the request.
+ * This cannot be validated here since `convertToLlm` is only called once per turn.
+ */
+export declare function agentLoopContinue(context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;

package/dist/core/lib/agent-core/src/agent-loop.js

@@ -0,0 +1,4 @@
+var se=Object.defineProperty;var h=(e,t)=>se(e,"name",{value:t,configurable:!0});import{EventStream as oe}from"@catui/ai/events";import{isContextOverflow as ae}from"@catui/ai/overflow";import{validateToolArguments as ne}from"@catui/ai/schema";import{streamSimple as re}from"@catui/ai/stream";import{ToolNotFoundError as le,ValidationError as G}from"./errors.js";import{computeRecoveryMaxTokens as ue,createOutputTokenRecoveryMessage as pe,createTokenBudgetContinuation as ie}from"./agent-loop-continuations.js";import{createInterruptedToolResults as me,createSkippedToolCallLimitResults as de,enforceToolResultBatchSize as ce}from"./agent-loop-tool-results.js";import{flushReadyToolUseSummaries as he,startToolUseSummary as ge}from"./agent-loop-tool-summaries.js";import{buildAgentRunPolicy as _e,resolveAgentRunLoopFramework as ye}from"./agent-run-result.js";import{waitForAbortableOperation as U,waitForAssistantStream as fe,waitForAssistantStreamEvent as Re}from"./agent-loop-stream-events.js";const Te=256,ke=512,Me=3,Se=1,be=1;function O(e){if(process.env.CATUI_DEBUG==="1")try{const{appendFileSync:t}=require("fs"),{join:s}=require("path"),{homedir:a}=require("os");t(s(a(),".catui","agent","catui-debug.log"),`[${new Date().toISOString()}] [loop] ${e}
+`)}catch{}}h(O,"_tlog");function Ke(e,t,s,a,o){const i=J();return(async()=>{const p=[...e],n={...t,messages:[...t.messages,...e]};try{i.push({type:"agent_start"}),i.push({type:"turn_start"});for(const d of e)i.push({type:"message_start",message:d}),i.push({type:"message_end",message:d});await Z(n,p,s,a,i,o)}catch(d){Q(i,p,s,d,a)}})(),i}h(Ke,"agentLoop");function Xe(e,t,s,a){if(e.messages.length===0)throw new G("Cannot continue: no messages in context");if(e.messages[e.messages.length-1].role==="assistant")throw new G("Cannot continue from message role: assistant");const o=J();return(async()=>{const i=[],p={...e};try{o.push({type:"agent_start"}),o.push({type:"turn_start"}),await Z(p,i,t,s,o,a)}catch(n){Q(o,i,t,n,s)}})(),o}h(Xe,"agentLoopContinue");function J(){return new oe(e=>e.type==="agent_end",e=>e.type==="agent_end"?e.messages:[])}h(J,"createAgentStream");function x(e,t){return{role:"assistant",content:[{type:"text",text:""}],api:e.model.api,provider:e.model.provider,model:e.model.id,usage:{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}},stopReason:"error",errorMessage:t,timestamp:Date.now()}}h(x,"createLoopLimitMessage");function Q(e,t,s,a,o){const i=x(s,a instanceof Error?a.message:String(a));o?.aborted&&(i.stopReason="aborted"),t.push(i),e.push({type:"message_start",message:{...i}}),e.push({type:"message_end",message:i}),e.push({type:"turn_end",message:i,toolResults:[]}),N(e,t,{config:s,turnCount:0,toolCallCount:0,startedAt:Date.now(),usage:ee(),permissionDenials:[],stopReason:i.stopReason,errorMessage:i.errorMessage,errorSubtype:o?.aborted?"aborted":"loop_error"})}h(Q,"endWithLoopError");async function Z(e,t,s,a,o,i){let p=!0,n=0,d=0;const k=Date.now(),D={loopStart:performance.now(),streamStart:0,firstTokenAt:0,turnCount:0};O("run_loop start");const g=ee(),r=[],T=s.maxTurnsPerPrompt??Te,C=s.maxToolCallsPerPrompt??ke,_=s.maxStopHookContinuations??Me,M=s.maxModelErrorRecoveryAttempts??Se,P=s.maxOutputTokenRecoveryAttempts??be;let S=0,l=0,y=0,c,R={reason:"start"};const E=[],$=h(A=>(R=A,E.push(A),A),"recordTransition");let H=[],B=!1,L=0;const j=await U(s.getSteeringMessages?s.getSteeringMessages():[],a);if(j.type==="aborted"){X(o,e,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,transitions:E,lastTransition:R});return}let v=j.value||[];for(;;){let A=!0,F=null;for(;A||v.length>0;){if(p?p=!1:o.push({type:"turn_start"}),H=he(H,e.messages,t,o),v.length>0){for(const u of v)o.push({type:"message_start",message:u}),o.push({type:"message_end",message:u}),e.messages.push(u),t.push(u);v=[]}if(n++,n>T){const u=x(s,`Stopped after ${T} assistant turns to prevent a runaway agent loop.`);e.messages.push(u),t.push(u),o.push({type:"message_start",message:{...u}}),o.push({type:"message_end",message:u}),o.push({type:"turn_end",message:u,toolResults:[]}),N(o,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,stopReason:u.stopReason,transitions:E,lastTransition:$({reason:"max_turns_reached",maxTurns:T,turnCount:n}),errorMessage:u.errorMessage,errorSubtype:"max_turns_reached"});return}D.turnCount++;const te=t.length,f=await Ce(e,s,a,o,i,c,D);if(ve(g,f.usage),c=void 0,t.push(f),f.stopReason==="error"||f.stopReason==="aborted"){const u=f.stopReason==="aborted"?"aborted":ae(f,s.model.contextWindow)?"context_overflow":"model_error",w=me(f);for(const m of w)e.messages.push(m),t.push(m),o.push({type:"message_start",message:m}),o.push({type:"message_end",message:m});if(f.stopReason==="error"&&s.recoverModelError&&S<M){const m=S+1,b=await s.recoverModelError({message:f,messages:e.messages,errorSubtype:u,attempt:m});if(b.action==="retry"){o.push({type:"turn_end",message:f,toolResults:w}),S=m,t.splice(te),e.messages=b.messages,$(b.transition??{reason:"model_error_recovery",subtype:u,attempt:m});continue}}o.push({type:"turn_end",message:f,toolResults:w}),N(o,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,stopReason:f.stopReason,transitions:E,lastTransition:R,errorMessage:f.errorMessage,errorSubtype:u});return}const I=f.content.filter(u=>u.type==="toolCall");A=I.length>0;const q=[];if(A){if(d+I.length>C){const m=de(f,`Tool call skipped because this prompt reached the ${C} tool-call limit.`);for(const W of m)e.messages.push(W),t.push(W),o.push({type:"message_start",message:W}),o.push({type:"message_end",message:W});const b=x(s,`Stopped before executing ${I.length} tool call${I.length===1?"":"s"} because this prompt reached the ${C} tool-call limit.`);e.messages.push(b),t.push(b),o.push({type:"message_start",message:{...b}}),o.push({type:"message_end",message:b}),o.push({type:"turn_end",message:b,toolResults:m}),N(o,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,stopReason:b.stopReason,transitions:E,lastTransition:$({reason:"tool_call_limit_reached",maxToolCalls:C,requestedToolCalls:I.length,toolCallCount:d}),errorMessage:b.errorMessage,errorSubtype:"tool_call_limit_reached"});return}d+=I.length;const u=await we(e.tools,f,a,o,s.getSteeringMessages,s.canUseTool);q.push(...ce(u.toolResults,s.maxToolResultBatchSizeChars)),r.push(...Ae(u.toolResults)),F=u.steeringMessages??null;for(const m of q)e.messages.push(m),t.push(m),o.push({type:"message_start",message:m}),o.push({type:"message_end",message:m});for(const m of u.contextMessages)e.messages.push(m),t.push(m),o.push({type:"message_start",message:m}),o.push({type:"message_end",message:m});const w=ge(s,{assistantMessage:f,toolResults:q,contextMessages:u.contextMessages,messages:e.messages});w&&H.push(w),$({reason:"tool_result",toolCallCount:I.length})}if(o.push({type:"turn_end",message:f,toolResults:q}),!A&&f.stopReason==="length"&&l<P){l+=1,c=ue(s,f),v=[pe(l)],$({reason:"max_output_tokens_recovery",attempt:l});continue}if(!A&&s.runStopHooks&&!B){B=!0;const u=await U(s.runStopHooks({message:f,messages:e.messages}),a);if(B=!1,u.type==="aborted"){X(o,e,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,transitions:E,lastTransition:R});return}const w=u.value;if(w.action==="continue"&&w.messages.length>0){if(L>=_){const m=x(s,`stop_hook_limit_reached: stopped after ${_} stop-hook continuation turns.`);e.messages.push(m),t.push(m),o.push({type:"message_start",message:{...m}}),o.push({type:"message_end",message:m}),o.push({type:"turn_end",message:m,toolResults:[]}),N(o,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,stopReason:m.stopReason,transitions:E,lastTransition:$({reason:"stop_hook_limit_reached",maxContinuations:_,continuationCount:L}),errorMessage:m.errorMessage,errorSubtype:"stop_hook_limit_reached"});return}L+=1,v=w.messages,$({reason:"stop_hook_blocking",continuationCount:L});continue}}if(!A){const u=ie(s,g.output,y);if(u){y+=1,v=[u.message],$({reason:"token_budget_continuation",continuationCount:y,outputTokens:u.outputTokens,targetTokens:u.targetTokens});continue}}F&&F.length>0?(v=F,F=null):v=await s.getSteeringMessages?.()||[]}const Y=await U(s.getFollowUpMessages?s.getFollowUpMessages():[],a);if(Y.type==="aborted"){X(o,e,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,transitions:E,lastTransition:R});return}const z=Y.value||[];if(z.length>0){v=z,$({reason:"follow_up"});continue}break}N(o,t,{config:s,turnCount:n,toolCallCount:d,startedAt:k,usage:g,permissionDenials:r,stopReason:V(t),transitions:E,lastTransition:R})}h(Z,"runLoop");async function Ce(e,t,s,a,o,i,p){let n=e.messages;if(t.transformContext){const l=await U(t.transformContext(n,s),s);if(l.type==="aborted")return K(e,a,t);n=l.value}const d=await U(t.convertToLlm(n),s);if(d.type==="aborted")return K(e,a,t);const k=d.value,D={systemPrompt:e.systemPrompt,messages:k,tools:e.tools},g=o||re,r=await U(t.getApiKey?t.getApiKey(t.model.provider):void 0,s);if(r.type==="aborted")return K(e,a,t);const T=r.value||t.apiKey;p&&(p.streamStart=performance.now(),O(`stream_request_start model=${t.model.id} provider=${t.model.provider} msgCount=${k.length} maxTokens=${i??t.maxTokens} (+${(p.streamStart-p.loopStart).toFixed(0)}ms from loop_start)`)),a.push({type:"stream_request_start",model:t.model.id,provider:t.model.provider,api:t.model.api,messageCount:k.length,maxTokens:i??t.maxTokens});const C=await fe(g(t.model,D,{...t,maxTokens:i??t.maxTokens,apiKey:T,signal:s}),s);if(C==="aborted"){const l=x(t,"Request was aborted");return l.stopReason="aborted",e.messages.push(l),a.push({type:"message_start",message:{...l}}),a.push({type:"message_end",message:l}),l}let _=null,M=!1;const P=C[Symbol.asyncIterator]();for(;;){let l;try{l=await Re(P,s)}catch(c){const R=x(t,c instanceof Error?c.message:String(c));return M?e.messages[e.messages.length-1]=R:(e.messages.push(R),a.push({type:"message_start",message:{...R}})),a.push({type:"message_end",message:R}),R}if(l==="aborted"){P.return?.();const c=x(t,"Request was aborted");return c.stopReason="aborted",M?e.messages[e.messages.length-1]=c:(e.messages.push(c),a.push({type:"message_start",message:{...c}})),a.push({type:"message_end",message:c}),c}if(l.done)break;const y=l.value;switch(p&&!p.firstTokenAt&&(p.firstTokenAt=performance.now(),O(`first_token ttft=${(p.firstTokenAt-p.streamStart).toFixed(0)}ms (+${(p.firstTokenAt-p.loopStart).toFixed(0)}ms from loop_start)`)),y.type){case"start":_=y.partial,e.messages.push(_),M=!0,a.push({type:"message_start",message:{..._}});break;case"text_start":case"text_delta":case"text_end":case"thinking_start":case"thinking_delta":case"thinking_end":case"toolcall_start":case"toolcall_delta":case"toolcall_end":_&&(_=y.partial,e.messages[e.messages.length-1]=_,a.push({type:"message_update",assistantMessageEvent:y,message:{..._}}));break;case"done":case"error":{const c=y.type==="done"?y.message:y.error;return M?e.messages[e.messages.length-1]=c:e.messages.push(c),M||a.push({type:"message_start",message:{...c}}),a.push({type:"message_end",message:c}),c}}}if(p){const l=performance.now();O(`stream_end duration=${(l-p.streamStart).toFixed(0)}ms total=${(l-p.loopStart).toFixed(0)}ms`)}const S=C.resultIfResolved()??x(t,"Provider stream ended without a final assistant message");return M?e.messages[e.messages.length-1]=S:(e.messages.push(S),a.push({type:"message_start",message:{...S}})),a.push({type:"message_end",message:S}),S}h(Ce,"streamAssistantResponse");function K(e,t,s){const a=x(s,"Request was aborted");return a.stopReason="aborted",e.messages.push(a),t.push({type:"message_start",message:{...a}}),t.push({type:"message_end",message:a}),a}h(K,"pushAbortedAssistantMessage");function X(e,t,s,a){const o=x(a.config,"Request was aborted");o.stopReason="aborted",t.messages.push(o),s.push(o),e.push({type:"message_start",message:{...o}}),e.push({type:"message_end",message:o}),e.push({type:"turn_end",message:o,toolResults:[]}),N(e,s,{...a,stopReason:"aborted",errorMessage:o.errorMessage,errorSubtype:"aborted"})}h(X,"finishStandardLoopWithAbortedTurn");function N(e,t,s){e.push({type:"agent_result",stopReason:s.stopReason??V(t),loopFramework:ye(s.config),loopPolicy:_e(s.config),turnCount:s.turnCount,toolCallCount:s.toolCallCount,durationMs:Date.now()-s.startedAt,usage:s.usage,permissionDenialCount:s.permissionDenials.length,permissionDenials:s.permissionDenials,transitions:s.transitions&&s.transitions.length>0?s.transitions:void 0,lastTransition:s.lastTransition,errorMessage:s.errorMessage,errorSubtype:s.errorSubtype}),O(`loop_finished stopReason=${s.stopReason??V(t)} turns=${s.turnCount} tools=${s.toolCallCount} duration=${Date.now()-s.startedAt}ms`),e.push({type:"agent_end",messages:t}),e.end(t)}h(N,"finishStandardLoop");function ee(){return{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}}}h(ee,"emptyUsage");function ve(e,t){e.input+=t.input,e.output+=t.output,e.cacheRead+=t.cacheRead,e.cacheWrite+=t.cacheWrite,e.totalTokens+=t.totalTokens,e.cost.input+=t.cost.input,e.cost.output+=t.cost.output,e.cost.cacheRead+=t.cost.cacheRead,e.cost.cacheWrite+=t.cost.cacheWrite,e.cost.total+=t.cost.total}h(ve,"addUsage");function V(e){for(let t=e.length-1;t>=0;t-=1){const s=e[t];if(s?.role==="assistant")return s.stopReason??"stop"}return"stop"}h(V,"inferStopReason");function Ae(e){const t=[];for(const s of e){const a=s.details;if(!a||typeof a!="object"||a.errorType!=="permission_denied")continue;const o=a.reason;t.push({toolCallId:s.toolCallId,toolName:s.toolName,reason:typeof o=="string"&&o.length>0?o:void 0})}return t}h(Ae,"collectPermissionDenials");async function we(e,t,s,a,o,i){const p=t.content.filter(g=>g.type==="toolCall"),n=xe(e),d=[],k=[];let D;for(let g=0;g<p.length;g++){const r=p[g],T=n.get(r.name),C=Date.now();O(`tool_exec_start [${g}] name=${r.name}`),a.push({type:"tool_execution_start",toolCallId:r.id,toolName:r.name,args:r.arguments});let _,M=!1;try{if(!T)throw new le(r.name);const l=ne(T,r),y=await T.validateInput?.(l);if(typeof y=="string"&&y.trim())throw new Error(y);const c=await i?.({toolCallId:r.id,toolName:T.name,requestedToolName:r.name,input:l,rawInput:r.arguments,tool:T});if(c?.decision==="deny"){const R=c.reason?.trim();_={content:[{type:"text",text:R?`Permission denied: ${R}`:`Permission denied for ${T.name}`}],details:{errorType:"permission_denied",reason:R,toolName:T.name,toolCallId:r.id}},M=!0}else _=await T.execute(r.id,l,s,R=>{a.push({type:"tool_execution_update",toolCallId:r.id,toolName:r.name,args:r.arguments,partialResult:R})}),_=$e(_,T.maxResultSizeChars)}catch(l){const y=l instanceof Error?l.message:String(l);_={content:[{type:"text",text:y}],details:Ee(y)?{errorType:"permission_denied",reason:y,toolName:T?.name??r.name,toolCallId:r.id}:{}},M=!0}const P=Date.now()-C;a.push({type:"tool_execution_end",toolCallId:r.id,toolName:r.name,result:_,isError:M,durationMs:P}),O(`tool_exec_end [${g}] name=${r.name} duration=${P}ms`);const S={role:"toolResult",toolCallId:r.id,toolName:r.name,content:_.content,details:_.details,isError:M,timestamp:Date.now()};if(d.push(S),k.push(..._.contextMessages??[]),o){const l=await o();if(l.length>0){D=l;const y=p.slice(g+1);for(const c of y)d.push(De(c,a));break}}}return{toolResults:d,contextMessages:k,steeringMessages:D}}h(we,"executeToolCalls");function xe(e){const t=new Map;for(const s of e??[]){t.set(s.name,s);for(const a of s.aliases??[])t.has(a)||t.set(a,s)}return t}h(xe,"buildToolMap");function Ee(e){return/^Permission (denied|request was cancelled)/i.test(e.trim())}h(Ee,"isPermissionDeniedMessage");function $e(e,t){if(!t||t<=0)return e;let s=Math.floor(t),a=!1;const o=e.content.map(n=>{if(n.type!=="text")return n;if(s<=0)return a=!0,{...n,text:""};if(n.text.length<=s)return s-=n.text.length,n;a=!0;const d=n.text.slice(0,s);return s=0,{...n,text:d}});if(!a)return e;const i=`
+
+[Tool result truncated to ${Math.floor(t)} characters.]`;let p=-1;for(let n=o.length-1;n>=0;n-=1)if(o[n]?.type==="text"){p=n;break}if(p>=0){const n=o[p];o[p]={...n,text:`${n.text}${i}`}}else o.push({type:"text",text:i.trimStart()});return{...e,content:o}}h($e,"enforceMaxResultSize");function De(e,t){const s={content:[{type:"text",text:"Skipped due to queued user message."}],details:{}};return t.push({type:"tool_execution_start",toolCallId:e.id,toolName:e.name,args:e.arguments}),t.push({type:"tool_execution_end",toolCallId:e.id,toolName:e.name,result:s,isError:!0}),{role:"toolResult",toolCallId:e.id,toolName:e.name,content:s.content,details:{},isError:!0,timestamp:Date.now()}}h(De,"skipToolCall");export{Ke as agentLoop,Xe as agentLoopContinue};

package/dist/core/lib/agent-core/src/agent-run-result.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [WHO]: Provides resolveAgentRunLoopFramework(), buildAgentRunPolicy()
+ * [FROM]: Depends on AgentLoopConfig, AgentRunPolicy, normalizeAgentLoopFramework
+ * [TO]: Consumed by standard and structured-adaptive agent loops
+ * [HERE]: core/lib/agent-core/src/agent-run-result.ts - shared result telemetry helpers
+ */
+import type { AgentLoopConfig, AgentLoopFramework, AgentRunPolicy } from "./types.js";
+export declare function resolveAgentRunLoopFramework(config: AgentLoopConfig): AgentLoopFramework;
+export declare function buildAgentRunPolicy(config: AgentLoopConfig): AgentRunPolicy;

package/dist/core/lib/agent-core/src/agent-run-result.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var t=(e,o)=>r(e,"name",{value:o,configurable:!0});import{normalizeAgentLoopFramework as u}from"./types.js";function n(e){return u(e.loopFramework)??"standard"}t(n,"resolveAgentRunLoopFramework");function p(e){const o={};return e.maxModelErrorRecoveryAttempts!==void 0&&(o.maxModelErrorRecoveryAttempts=e.maxModelErrorRecoveryAttempts),e.maxOutputTokenRecoveryAttempts!==void 0&&(o.maxOutputTokenRecoveryAttempts=e.maxOutputTokenRecoveryAttempts),e.outputTokenBudget!==void 0&&(o.outputTokenBudget={...e.outputTokenBudget}),e.maxStopHookContinuations!==void 0&&(o.maxStopHookContinuations=e.maxStopHookContinuations),e.maxToolConcurrency!==void 0&&(o.maxToolConcurrency=e.maxToolConcurrency),e.maxToolResultBatchSizeChars!==void 0&&(o.maxToolResultBatchSizeChars=e.maxToolResultBatchSizeChars),e.maxTurnsPerPrompt!==void 0&&(o.maxTurnsPerPrompt=e.maxTurnsPerPrompt),e.maxToolCallsPerPrompt!==void 0&&(o.maxToolCallsPerPrompt=e.maxToolCallsPerPrompt),o}t(p,"buildAgentRunPolicy");export{p as buildAgentRunPolicy,n as resolveAgentRunLoopFramework};

package/dist/core/lib/agent-core/src/agent.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Agent class that uses the agent-loop directly.
+ * No transport abstraction - calls streamSimple via the loop.
+ */
+/**
+ * [WHO]: AgentOptions, Agent, and loop policy option plumbing
+ * [FROM]: Depends on ./agent-loop.js and ./structured-adaptive-agent-loop.js
+ * [TO]: Consumed by core/lib/agent-core/src/index.ts
+ * [HERE]: core/lib/agent-core/src/agent.ts -
+ */
+import { type ImageContent, type Message, type Model, type ThinkingBudgets, type Transport } from "@catui/ai/types";
+import type { AgentEvent, AgentLoopFramework, AgentLoopFrameworkInput, AgentLoopConfig, AgentMessage, AgentState, AgentTool, StreamFn, ThinkingLevel } from "./types.js";
+export interface AgentOptions {
+    initialState?: Partial<AgentState>;
+    /**
+     * Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.
+     * Default filters to user/assistant/toolResult and converts attachments.
+     */
+    convertToLlm?: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;
+    /**
+     * Optional transform applied to context before convertToLlm.
+     * Use for context pruning, injecting external context, etc.
+     */
+    transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
+    /**
+     * Steering mode: "all" = send all steering messages at once, "one-at-a-time" = one per turn
+     */
+    steeringMode?: "all" | "one-at-a-time";
+    /**
+     * Follow-up mode: "all" = send all follow-up messages at once, "one-at-a-time" = one per turn
+     */
+    followUpMode?: "all" | "one-at-a-time";
+    /**
+     * Custom stream function (for proxy backends, etc.). Default uses streamSimple.
+     */
+    streamFn?: StreamFn;
+    /**
+     * Optional session identifier forwarded to LLM providers.
+     * Used by providers that support session-based caching (e.g., OpenAI Codex).
+     */
+    sessionId?: string;
+    /**
+     * Resolves an API key dynamically for each LLM call.
+     * Useful for expiring tokens (e.g., GitHub Copilot OAuth).
+     */
+    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
+    /**
+     * Custom token budgets for thinking levels (token-based providers only).
+     */
+    thinkingBudgets?: ThinkingBudgets;
+    /**
+     * Preferred transport for providers that support multiple transports.
+     */
+    transport?: Transport;
+    /**
+     * Maximum delay in milliseconds to wait for a retry when the server requests a long wait.
+     * If the server's requested delay exceeds this value, the request fails immediately,
+     * allowing higher-level retry logic to handle it with user visibility.
+     * Default: 60000 (60 seconds). Set to 0 to disable the cap.
+     */
+    maxRetryDelayMs?: number;
+    /**
+     * Force a loop framework for all models in this Agent.
+     * When omitted, the current model's `agentLoopFramework` setting is used.
+     */
+    agentLoopFramework?: AgentLoopFrameworkInput;
+    /**
+     * Optional tool permission gate used by loop execution.
+     */
+    canUseTool?: AgentLoopConfig["canUseTool"];
+    /**
+     * Optional aggregate tool-result batch budget used by loop execution.
+     */
+    maxToolResultBatchSizeChars?: AgentLoopConfig["maxToolResultBatchSizeChars"];
+    /**
+     * Optional in-loop model error recovery hook used by loop execution.
+     */
+    recoverModelError?: AgentLoopConfig["recoverModelError"];
+    /** Maximum in-loop model error recoveries per prompt. */
+    maxModelErrorRecoveryAttempts?: number;
+    /** Maximum automatic output-token recovery turns per prompt. */
+    maxOutputTokenRecoveryAttempts?: number;
+    /** Optional target for automatic continuation when output is under-complete. */
+    outputTokenBudget?: AgentLoopConfig["outputTokenBudget"];
+    /** Optional stop hook for validation/correction continuation turns. */
+    runStopHooks?: AgentLoopConfig["runStopHooks"];
+    /** Maximum stop-hook continuation turns per prompt. */
+    maxStopHookContinuations?: number;
+    /** Optional non-blocking summary hook for completed tool batches. */
+    createToolUseSummary?: AgentLoopConfig["createToolUseSummary"];
+    /** Maximum concurrency for concurrency-safe tool batches. */
+    maxToolConcurrency?: number;
+    /** Maximum assistant turns allowed for one prompt/continue loop. */
+    maxTurnsPerPrompt?: number;
+    /** Maximum tool calls allowed for one prompt/continue loop. */
+    maxToolCallsPerPrompt?: number;
+}
+export type AgentLoopPolicyOptions = Pick<AgentOptions, "canUseTool" | "maxToolResultBatchSizeChars" | "recoverModelError" | "maxModelErrorRecoveryAttempts" | "maxOutputTokenRecoveryAttempts" | "outputTokenBudget" | "runStopHooks" | "maxStopHookContinuations" | "createToolUseSummary" | "maxToolConcurrency" | "maxTurnsPerPrompt" | "maxToolCallsPerPrompt">;
+export declare class Agent {
+    private _state;
+    private listeners;
+    private abortController?;
+    private convertToLlm;
+    private transformContext?;
+    private steeringQueue;
+    private followUpQueue;
+    private steeringMode;
+    private followUpMode;
+    streamFn: StreamFn;
+    private _sessionId?;
+    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
+    private runningPrompt?;
+    private resolveRunningPrompt?;
+    private _thinkingBudgets?;
+    private _transport;
+    private _maxRetryDelayMs?;
+    private _agentLoopFramework?;
+    private canUseTool?;
+    private maxToolResultBatchSizeChars?;
+    private recoverModelError?;
+    private maxModelErrorRecoveryAttempts?;
+    private maxOutputTokenRecoveryAttempts?;
+    private outputTokenBudget?;
+    private runStopHooks?;
+    private maxStopHookContinuations?;
+    private createToolUseSummary?;
+    private maxToolConcurrency?;
+    private maxTurnsPerPrompt?;
+    private maxToolCallsPerPrompt?;
+    constructor(opts?: AgentOptions);
+    /**
+     * Get the current session ID used for provider caching.
+     */
+    get sessionId(): string | undefined;
+    /**
+     * Set the session ID for provider caching.
+     * Call this when switching sessions (new session, branch, resume).
+     */
+    set sessionId(value: string | undefined);
+    /**
+     * Get the current thinking budgets.
+     */
+    get thinkingBudgets(): ThinkingBudgets | undefined;
+    /**
+     * Set custom thinking budgets for token-based providers.
+     */
+    set thinkingBudgets(value: ThinkingBudgets | undefined);
+    /**
+     * Get the current preferred transport.
+     */
+    get transport(): Transport;
+    /**
+     * Set the preferred transport.
+     */
+    setTransport(value: Transport): void;
+    /**
+     * Get the current max retry delay in milliseconds.
+     */
+    get maxRetryDelayMs(): number | undefined;
+    /**
+     * Set the maximum delay to wait for server-requested retries.
+     * Set to 0 to disable the cap.
+     */
+    set maxRetryDelayMs(value: number | undefined);
+    get agentLoopFramework(): AgentLoopFramework;
+    setAgentLoopFramework(value: AgentLoopFrameworkInput | undefined): void;
+    get state(): AgentState;
+    subscribe(fn: (e: AgentEvent) => void): () => void;
+    setSystemPrompt(v: string): void;
+    setModel(m: Model<any>): void;
+    setThinkingLevel(l: ThinkingLevel): void;
+    setSteeringMode(mode: "all" | "one-at-a-time"): void;
+    getSteeringMode(): "all" | "one-at-a-time";
+    setFollowUpMode(mode: "all" | "one-at-a-time"): void;
+    getFollowUpMode(): "all" | "one-at-a-time";
+    setTools(t: AgentTool<any>[]): void;
+    setLoopPolicy(options: Partial<AgentLoopPolicyOptions>): void;
+    setModelErrorRecovery(recoverModelError: AgentLoopConfig["recoverModelError"] | undefined): void;
+    replaceMessages(ms: AgentMessage[]): void;
+    appendMessage(m: AgentMessage): void;
+    /**
+     * Queue a steering message to interrupt the agent mid-run.
+     * Delivered after current tool execution, skips remaining tools.
+     */
+    steer(m: AgentMessage): void;
+    /**
+     * Queue a follow-up message to be processed after the agent finishes.
+     * Delivered only when agent has no more tool calls or steering messages.
+     */
+    followUp(m: AgentMessage): void;
+    clearSteeringQueue(): void;
+    clearFollowUpQueue(): void;
+    clearAllQueues(): void;
+    hasQueuedMessages(): boolean;
+    private dequeueSteeringMessages;
+    private dequeueFollowUpMessages;
+    clearMessages(): void;
+    abort(): void;
+    waitForIdle(): Promise<void>;
+    reset(): void;
+    /** Send a prompt with an AgentMessage */
+    prompt(message: AgentMessage | AgentMessage[]): Promise<void>;
+    prompt(input: string, images?: ImageContent[]): Promise<void>;
+    /**
+     * Continue from current context (used for retries and resuming queued messages).
+     */
+    continue(): Promise<void>;
+    /**
+     * Run the agent loop.
+     * If messages are provided, starts a new conversation turn with those messages.
+     * Otherwise, continues from existing context.
+     */
+    private _runLoop;
+    private emit;
+}

package/dist/core/lib/agent-core/src/agent.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var h=(g,e)=>c(g,"name",{value:e,configurable:!0});import{getModel as f}from"@catui/ai/models";import{streamSimple as y}from"@catui/ai/stream";import{agentLoop as _,agentLoopContinue as T}from"./agent-loop.js";import{structuredAdaptiveAgentLoop as x,structuredAdaptiveAgentLoopContinue as w}from"./structured-adaptive-agent-loop.js";import{normalizeAgentLoopFramework as p}from"./types.js";function k(g){return g.filter(e=>e.role==="user"||e.role==="assistant"||e.role==="toolResult")}h(k,"defaultConvertToLlm");class U{static{h(this,"Agent")}_state={systemPrompt:"",model:f("google","gemini-2.5-flash-lite"),thinkingLevel:"off",tools:[],messages:[],isStreaming:!1,streamMessage:null,pendingToolCalls:new Set,lastResult:void 0,error:void 0};listeners=new Set;abortController;convertToLlm;transformContext;steeringQueue=[];followUpQueue=[];steeringMode;followUpMode;streamFn;_sessionId;getApiKey;runningPrompt;resolveRunningPrompt;_thinkingBudgets;_transport;_maxRetryDelayMs;_agentLoopFramework;canUseTool;maxToolResultBatchSizeChars;recoverModelError;maxModelErrorRecoveryAttempts;maxOutputTokenRecoveryAttempts;outputTokenBudget;runStopHooks;maxStopHookContinuations;createToolUseSummary;maxToolConcurrency;maxTurnsPerPrompt;maxToolCallsPerPrompt;constructor(e={}){this._state={...this._state,...e.initialState},this.convertToLlm=e.convertToLlm||k,this.transformContext=e.transformContext,this.steeringMode=e.steeringMode||"one-at-a-time",this.followUpMode=e.followUpMode||"one-at-a-time",this.streamFn=e.streamFn||y,this._sessionId=e.sessionId,this.getApiKey=e.getApiKey,this._thinkingBudgets=e.thinkingBudgets,this._transport=e.transport??"sse",this._maxRetryDelayMs=e.maxRetryDelayMs,this._agentLoopFramework=p(e.agentLoopFramework),this.canUseTool=e.canUseTool,this.maxToolResultBatchSizeChars=e.maxToolResultBatchSizeChars,this.recoverModelError=e.recoverModelError,this.maxModelErrorRecoveryAttempts=e.maxModelErrorRecoveryAttempts,this.maxOutputTokenRecoveryAttempts=e.maxOutputTokenRecoveryAttempts,this.outputTokenBudget=e.outputTokenBudget,this.runStopHooks=e.runStopHooks,this.maxStopHookContinuations=e.maxStopHookContinuations,this.createToolUseSummary=e.createToolUseSummary,this.maxToolConcurrency=e.maxToolConcurrency,this.maxTurnsPerPrompt=e.maxTurnsPerPrompt,this.maxToolCallsPerPrompt=e.maxToolCallsPerPrompt}get sessionId(){return this._sessionId}set sessionId(e){this._sessionId=e}get thinkingBudgets(){return this._thinkingBudgets}set thinkingBudgets(e){this._thinkingBudgets=e}get transport(){return this._transport}setTransport(e){this._transport=e}get maxRetryDelayMs(){return this._maxRetryDelayMs}set maxRetryDelayMs(e){this._maxRetryDelayMs=e}get agentLoopFramework(){return p(this._agentLoopFramework??this._state.model.agentLoopFramework)??"standard"}setAgentLoopFramework(e){this._agentLoopFramework=p(e)}get state(){return this._state}subscribe(e){return this.listeners.add(e),()=>this.listeners.delete(e)}setSystemPrompt(e){this._state.systemPrompt=e}setModel(e){this._state.model=e}setThinkingLevel(e){this._state.thinkingLevel=e}setSteeringMode(e){this.steeringMode=e}getSteeringMode(){return this.steeringMode}setFollowUpMode(e){this.followUpMode=e}getFollowUpMode(){return this.followUpMode}setTools(e){this._state.tools=e}setLoopPolicy(e){"canUseTool"in e&&(this.canUseTool=e.canUseTool),"maxToolResultBatchSizeChars"in e&&(this.maxToolResultBatchSizeChars=e.maxToolResultBatchSizeChars),"recoverModelError"in e&&(this.recoverModelError=e.recoverModelError),"maxModelErrorRecoveryAttempts"in e&&(this.maxModelErrorRecoveryAttempts=e.maxModelErrorRecoveryAttempts),"maxOutputTokenRecoveryAttempts"in e&&(this.maxOutputTokenRecoveryAttempts=e.maxOutputTokenRecoveryAttempts),"outputTokenBudget"in e&&(this.outputTokenBudget=e.outputTokenBudget),"runStopHooks"in e&&(this.runStopHooks=e.runStopHooks),"maxStopHookContinuations"in e&&(this.maxStopHookContinuations=e.maxStopHookContinuations),"createToolUseSummary"in e&&(this.createToolUseSummary=e.createToolUseSummary),"maxToolConcurrency"in e&&(this.maxToolConcurrency=e.maxToolConcurrency),"maxTurnsPerPrompt"in e&&(this.maxTurnsPerPrompt=e.maxTurnsPerPrompt),"maxToolCallsPerPrompt"in e&&(this.maxToolCallsPerPrompt=e.maxToolCallsPerPrompt)}setModelErrorRecovery(e){this.setLoopPolicy({recoverModelError:e})}replaceMessages(e){this._state.messages=e.slice()}appendMessage(e){this._state.messages=[...this._state.messages,e]}steer(e){this.steeringQueue.push(e)}followUp(e){this.followUpQueue.push(e)}clearSteeringQueue(){this.steeringQueue=[]}clearFollowUpQueue(){this.followUpQueue=[]}clearAllQueues(){this.steeringQueue=[],this.followUpQueue=[]}hasQueuedMessages(){return this.steeringQueue.length>0||this.followUpQueue.length>0}dequeueSteeringMessages(){if(this.steeringMode==="one-at-a-time"){if(this.steeringQueue.length>0){const s=this.steeringQueue[0];return this.steeringQueue=this.steeringQueue.slice(1),[s]}return[]}const e=this.steeringQueue.slice();return this.steeringQueue=[],e}dequeueFollowUpMessages(){if(this.followUpMode==="one-at-a-time"){if(this.followUpQueue.length>0){const s=this.followUpQueue[0];return this.followUpQueue=this.followUpQueue.slice(1),[s]}return[]}const e=this.followUpQueue.slice();return this.followUpQueue=[],e}clearMessages(){this._state.messages=[],this._state.lastResult=void 0}abort(){this.abortController?.abort()}waitForIdle(){return this.runningPrompt??Promise.resolve()}reset(){this._state.messages=[],this._state.isStreaming=!1,this._state.streamMessage=null,this._state.pendingToolCalls=new Set,this._state.lastResult=void 0,this._state.error=void 0,this.steeringQueue=[],this.followUpQueue=[]}async prompt(e,s){if(this._state.isStreaming)throw new Error("Agent is already processing a prompt. Use steer() or followUp() to queue messages, or wait for completion.");if(!this._state.model)throw new Error("No model configured");let l;if(Array.isArray(e))l=e;else if(typeof e=="string"){const i=[{type:"text",text:e}];s&&s.length>0&&i.push(...s),l=[{role:"user",content:i,timestamp:Date.now()}]}else l=[e];await this._runLoop(l)}async continue(){if(this._state.isStreaming)throw new Error("Agent is already processing. Wait for completion before continuing.");const e=this._state.messages;if(e.length===0)throw new Error("No messages to continue from");if(e[e.length-1].role==="assistant"){const s=this.dequeueSteeringMessages();if(s.length>0){await this._runLoop(s,{skipInitialSteeringPoll:!0});return}const r=this.dequeueFollowUpMessages();if(r.length>0){await this._runLoop(r);return}throw new Error("Cannot continue from message role: assistant")}await this._runLoop(void 0)}async _runLoop(e,s){const r=this._state.model;if(!r)throw new Error("No model configured");this.runningPrompt=new Promise(a=>{this.resolveRunningPrompt=a}),this.abortController=new AbortController,this._state.isStreaming=!0,this._state.streamMessage=null,this._state.lastResult=void 0,this._state.error=void 0;const l=this._state.thinkingLevel==="off"?void 0:this._state.thinkingLevel,i={systemPrompt:this._state.systemPrompt,messages:this._state.messages.slice(),tools:this._state.tools};let d=s?.skipInitialSteeringPoll===!0;const m={model:r,loopFramework:this.agentLoopFramework,reasoning:l,sessionId:this._sessionId,transport:this._transport,thinkingBudgets:this._thinkingBudgets,maxRetryDelayMs:this._maxRetryDelayMs,convertToLlm:this.convertToLlm,transformContext:this.transformContext,getApiKey:this.getApiKey,canUseTool:this.canUseTool,maxToolResultBatchSizeChars:this.maxToolResultBatchSizeChars,recoverModelError:this.recoverModelError,maxModelErrorRecoveryAttempts:this.maxModelErrorRecoveryAttempts,maxOutputTokenRecoveryAttempts:this.maxOutputTokenRecoveryAttempts,outputTokenBudget:this.outputTokenBudget,runStopHooks:this.runStopHooks,maxStopHookContinuations:this.maxStopHookContinuations,createToolUseSummary:this.createToolUseSummary,maxToolConcurrency:this.maxToolConcurrency,maxTurnsPerPrompt:this.maxTurnsPerPrompt,maxToolCallsPerPrompt:this.maxToolCallsPerPrompt,getSteeringMessages:h(async()=>d?(d=!1,[]):this.dequeueSteeringMessages(),"getSteeringMessages"),getFollowUpMessages:h(async()=>this.dequeueFollowUpMessages(),"getFollowUpMessages")};let n=null;try{const a=m.loopFramework==="weak-model-compatible",u=e?a?x(e,i,m,this.abortController.signal,this.streamFn):_(e,i,m,this.abortController.signal,this.streamFn):a?w(i,m,this.abortController.signal,this.streamFn):T(i,m,this.abortController.signal,this.streamFn);for await(const t of u){switch(t.type){case"message_start":n=t.message,this._state.streamMessage=t.message;break;case"message_update":n=t.message,this._state.streamMessage=t.message;break;case"message_end":n=null,this._state.streamMessage=null,this.appendMessage(t.message);break;case"tool_execution_start":{const o=new Set(this._state.pendingToolCalls);o.add(t.toolCallId),this._state.pendingToolCalls=o;break}case"tool_execution_end":{const o=new Set(this._state.pendingToolCalls);o.delete(t.toolCallId),this._state.pendingToolCalls=o;break}case"turn_end":t.message.role==="assistant"&&t.message.errorMessage&&(this._state.error=t.message.errorMessage);break;case"agent_result":this._state.lastResult={stopReason:t.stopReason,loopFramework:t.loopFramework,loopPolicy:t.loopPolicy,turnCount:t.turnCount,toolCallCount:t.toolCallCount,durationMs:t.durationMs,usage:t.usage,permissionDenialCount:t.permissionDenialCount,permissionDenials:t.permissionDenials,transitions:t.transitions,lastTransition:t.lastTransition,errorMessage:t.errorMessage,errorSubtype:t.errorSubtype};break;case"agent_end":this._state.isStreaming=!1,this._state.streamMessage=null;break}this.emit(t)}if(n&&n.role==="assistant"&&n.content.length>0){if(!!n.content.some(o=>o.type==="thinking"&&o.thinking.trim().length>0||o.type==="text"&&o.text.trim().length>0||o.type==="toolCall"&&o.name.trim().length>0))this.appendMessage(n);else if(this.abortController?.signal.aborted)throw new Error("Request was aborted")}}catch(a){const u={role:"assistant",content:[{type:"text",text:""}],api:r.api,provider:r.provider,model:r.id,usage:{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}},stopReason:this.abortController?.signal.aborted?"aborted":"error",errorMessage:a?.message||String(a),timestamp:Date.now()};this.appendMessage(u),this._state.error=a?.message||String(a),this.emit({type:"message_start",message:u}),this.emit({type:"message_end",message:u}),this.emit({type:"agent_end",messages:[u]})}finally{this._state.isStreaming=!1,this._state.streamMessage=null,this._state.pendingToolCalls=new Set,this.abortController=void 0,this.resolveRunningPrompt?.(),this.runningPrompt=void 0,this.resolveRunningPrompt=void 0}}emit(e){for(const s of this.listeners)s(e)}}export{U as Agent};

package/dist/core/lib/agent-core/src/errors.d.ts

@@ -0,0 +1,62 @@
+/**
+ * [WHO]: AgentError hierarchy — AgentError, NetworkError, ContextOverflowError, ToolExecutionError, ValidationError, ExtensionError
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by agent-loop, agent, proxy, and downstream consumers
+ * [HERE]: core/lib/agent-core/src/errors.ts - unified error type system
+ */
+/**
+ * Base error class for all agent-related errors.
+ * Provides structured error info (code, retriable flag) for consistent handling.
+ */
+export declare class AgentError extends Error {
+    readonly code: string;
+    readonly retriable: boolean;
+    readonly details?: unknown;
+    constructor(message: string, code: string, retriable?: boolean, details?: unknown);
+}
+export declare class NetworkError extends AgentError {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+export declare class RateLimitError extends NetworkError {
+    readonly retryAfterMs?: number;
+    constructor(message: string, retryAfterMs?: number);
+}
+export declare class TimeoutError extends NetworkError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ConnectionError extends NetworkError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ContextOverflowError extends AgentError {
+    readonly estimatedTokens?: number;
+    readonly contextWindow?: number;
+    constructor(message: string, estimatedTokens?: number, contextWindow?: number);
+}
+export declare class ToolExecutionError extends AgentError {
+    readonly toolName: string;
+    readonly toolCallId?: string;
+    constructor(message: string, toolName: string, toolCallId?: string);
+}
+export declare class ToolTimeoutError extends ToolExecutionError {
+    constructor(toolName: string, toolCallId: string, timeoutMs: number);
+}
+export declare class ToolNotFoundError extends ToolExecutionError {
+    constructor(toolName: string);
+}
+export declare class ValidationError extends AgentError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ExtensionError extends AgentError {
+    readonly extensionName?: string;
+    constructor(message: string, extensionName?: string);
+}
+/** Type guard: is the error retriable? */
+export declare function isRetriableError(error: unknown): boolean;
+/** Type guard: is this a context overflow error? */
+export declare function isContextOverflowError(error: unknown): boolean;
+/**
+ * Classify an HTTP-like error (status code + message) into the appropriate AgentError subclass.
+ * Useful for normalizing raw provider errors into the typed hierarchy.
+ */
+export declare function classifyApiError(statusCode: number | undefined, message: string): AgentError;

package/dist/core/lib/agent-core/src/errors.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var o=(t,r)=>l(t,"name",{value:r,configurable:!0});class s extends Error{static{o(this,"AgentError")}code;retriable;details;constructor(r,e,n=!1,E){super(r),this.name="AgentError",this.code=e,this.retriable=n,this.details=E}}class i extends s{static{o(this,"NetworkError")}statusCode;constructor(r,e,n){super(r,"NETWORK_ERROR",!0,n),this.name="NetworkError",this.statusCode=e}}class a extends i{static{o(this,"RateLimitError")}retryAfterMs;constructor(r,e){super(r,429),this.name="RateLimitError",this.retryAfterMs=e}}class p extends i{static{o(this,"TimeoutError")}constructor(r,e){super(r,void 0,e),this.name="TimeoutError"}}class d extends i{static{o(this,"ConnectionError")}constructor(r,e){super(r,void 0,e),this.name="ConnectionError"}}class c extends s{static{o(this,"ContextOverflowError")}estimatedTokens;contextWindow;constructor(r,e,n){super(r,"CONTEXT_OVERFLOW",!1,{estimatedTokens:e,contextWindow:n}),this.name="ContextOverflowError",this.estimatedTokens=e,this.contextWindow=n}}class u extends s{static{o(this,"ToolExecutionError")}toolName;toolCallId;constructor(r,e,n){super(r,"TOOL_EXECUTION_ERROR",!1,{toolName:e,toolCallId:n}),this.name="ToolExecutionError",this.toolName=e,this.toolCallId=n}}class h extends u{static{o(this,"ToolTimeoutError")}constructor(r,e,n){super(`Tool "${r}" timed out after ${n}ms`,r,e),this.name="ToolTimeoutError"}}class T extends u{static{o(this,"ToolNotFoundError")}constructor(r){super(`Tool "${r}" not found`,r),this.name="ToolNotFoundError"}}class x extends s{static{o(this,"ValidationError")}constructor(r,e){super(r,"VALIDATION_ERROR",!1,e),this.name="ValidationError"}}class m extends s{static{o(this,"ExtensionError")}extensionName;constructor(r,e){super(r,"EXTENSION_ERROR",!1,{extensionName:e}),this.name="ExtensionError",this.extensionName=e}}function R(t){return t instanceof s&&t.retriable}o(R,"isRetriableError");function O(t){return t instanceof c}o(O,"isContextOverflowError");function w(t,r){if(t===429){const e=r.match(/retry[_-]after[:\s]+(\d+)/i),n=e?parseInt(e[1],10)*1e3:void 0;return new a(r,n)}return t===413||t===400&&/context|token|prompt.*too long|overflow/i.test(r)?new c(r):t!==void 0&&t>=500?new i(r,t):t!==void 0&&t>=400?new x(r,{statusCode:t}):new i(r,t)}o(w,"classifyApiError");export{s as AgentError,d as ConnectionError,c as ContextOverflowError,m as ExtensionError,i as NetworkError,a as RateLimitError,p as TimeoutError,u as ToolExecutionError,T as ToolNotFoundError,h as ToolTimeoutError,x as ValidationError,w as classifyApiError,O as isContextOverflowError,R as isRetriableError};

package/dist/core/lib/agent-core/src/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * [WHO]: agent-core barrel exports
+ * [FROM]: Depends on agent.js, agent-loop.js, structured-adaptive-agent-loop.js, structured-adaptive-tool-orchestration.js, structured-adaptive-streaming-tool-executor.js, proxy.js, types.js
+ * [TO]: Consumed by @catui/agent-core package consumers
+ * [HERE]: core/lib/agent-core/src/index.ts - agent-core entry point
+ */
+export * from "./agent.js";
+export * from "./agent-loop.js";
+export * from "./structured-adaptive-agent-loop.js";
+export * from "./structured-adaptive-tool-orchestration.js";
+export * from "./structured-adaptive-streaming-tool-executor.js";
+export * from "./proxy.js";
+export * from "./types.js";
+export * from "./errors.js";

package/dist/core/lib/agent-core/src/index.js

@@ -0,0 +1 @@
+export*from"./agent.js";export*from"./agent-loop.js";export*from"./structured-adaptive-agent-loop.js";export*from"./structured-adaptive-tool-orchestration.js";export*from"./structured-adaptive-streaming-tool-executor.js";export*from"./proxy.js";export*from"./types.js";export*from"./errors.js";