catui-agent 1.0.0-beta.0

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

@@ -0,0 +1,91 @@
+/**
+ * Proxy stream function for apps that route LLM calls through a server.
+ * The server manages auth and proxies requests to LLM providers.
+ */
+/**
+ * [WHO]: ProxyStreamOptions, streamProxy
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/lib/agent-core/src/index.ts
+ * [HERE]: core/lib/agent-core/src/proxy.ts -
+ */
+import { type AssistantMessage, type AssistantMessageEvent, type Context, type Model, type SimpleStreamOptions, type StopReason } from "@catui/ai/types";
+import { EventStream } from "@catui/ai/events";
+declare class ProxyMessageEventStream extends EventStream<AssistantMessageEvent, AssistantMessage> {
+    constructor();
+}
+/**
+ * Proxy event types - server sends these with partial field stripped to reduce bandwidth.
+ */
+export type ProxyAssistantMessageEvent = {
+    type: "start";
+} | {
+    type: "text_start";
+    contentIndex: number;
+} | {
+    type: "text_delta";
+    contentIndex: number;
+    delta: string;
+} | {
+    type: "text_end";
+    contentIndex: number;
+    contentSignature?: string;
+} | {
+    type: "thinking_start";
+    contentIndex: number;
+} | {
+    type: "thinking_delta";
+    contentIndex: number;
+    delta: string;
+} | {
+    type: "thinking_end";
+    contentIndex: number;
+    contentSignature?: string;
+} | {
+    type: "toolcall_start";
+    contentIndex: number;
+    id: string;
+    toolName: string;
+} | {
+    type: "toolcall_delta";
+    contentIndex: number;
+    delta: string;
+} | {
+    type: "toolcall_end";
+    contentIndex: number;
+} | {
+    type: "done";
+    reason: Extract<StopReason, "stop" | "length" | "toolUse">;
+    usage: AssistantMessage["usage"];
+} | {
+    type: "error";
+    reason: Extract<StopReason, "aborted" | "error">;
+    errorMessage?: string;
+    usage: AssistantMessage["usage"];
+};
+export interface ProxyStreamOptions extends SimpleStreamOptions {
+    /** Auth token for the proxy server */
+    authToken: string;
+    /** Proxy server URL (e.g., "https://genai.example.com") */
+    proxyUrl: string;
+}
+/**
+ * Stream function that proxies through a server instead of calling LLM providers directly.
+ * The server strips the partial field from delta events to reduce bandwidth.
+ * We reconstruct the partial message client-side.
+ *
+ * Use this as the `streamFn` option when creating an Agent that needs to go through a proxy.
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent({
+ *   streamFn: (model, context, options) =>
+ *     streamProxy(model, context, {
+ *       ...options,
+ *       authToken: await getAuthToken(),
+ *       proxyUrl: "https://genai.example.com",
+ *     }),
+ * });
+ * ```
+ */
+export declare function streamProxy(model: Model<any>, context: Context, options: ProxyStreamOptions): ProxyMessageEventStream;
+export {};

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

@@ -0,0 +1,2 @@
+var k=Object.defineProperty;var a=(e,t)=>k(e,"name",{value:t,configurable:!0});import{EventStream as x}from"@catui/ai/events";import{parseStreamingJson as b}from"@catui/ai/json";class R extends x{static{a(this,"ProxyMessageEventStream")}constructor(){super(t=>t.type==="done"||t.type==="error",t=>{if(t.type==="done")return t.message;if(t.type==="error")return t.error;throw new Error("Unexpected event type")})}}function w(e){return e?.type==="toolCall"&&typeof e.partialJson=="string"}a(w,"isStreamingToolCall");function C(e,t,n){const s=new R;return(async()=>{const r={role:"assistant",stopReason:"stop",content:[],api:e.api,provider:e.provider,model:e.id,usage:{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}},timestamp:Date.now()};let d;const g=a(()=>{d&&d.cancel("Request aborted by user").catch(()=>{})},"abortHandler");n.signal&&n.signal.addEventListener("abort",g,{once:!0});try{const o=await fetch(`${n.proxyUrl}/api/stream`,{method:"POST",headers:{Authorization:`Bearer ${n.authToken}`,"Content-Type":"application/json"},body:JSON.stringify({model:e,context:t,options:{temperature:n.temperature,maxTokens:n.maxTokens,reasoning:n.reasoning}}),signal:n.signal});if(!o.ok){let i=`Proxy error: ${o.status} ${o.statusText}`;try{const l=await o.json();l.error&&(i=`Proxy error: ${l.error}`)}catch{}throw new Error(i)}d=o.body.getReader();const u=new TextDecoder;let c="";for(;;){const{done:i,value:l}=await d.read();if(i)break;if(n.signal?.aborted)throw new Error("Request aborted by user");c+=u.decode(l,{stream:!0});const h=c.split(`
+`);c=h.pop()||"";for(const f of h)if(f.startsWith("data: ")){const I=f.slice(6).trim();if(I){const _=JSON.parse(I),m=S(_,r);m&&s.push(m)}}}if(n.signal?.aborted)throw new Error("Request aborted by user");s.end()}catch(o){const u=o instanceof Error?o.message:String(o),c=n.signal?.aborted?"aborted":"error";r.stopReason=c,r.errorMessage=u,s.push({type:"error",reason:c,error:r}),s.end()}finally{n.signal&&n.signal.removeEventListener("abort",g)}})(),s}a(C,"streamProxy");function S(e,t){switch(e.type){case"start":return{type:"start",partial:t};case"text_start":return t.content[e.contentIndex]={type:"text",text:""},{type:"text_start",contentIndex:e.contentIndex,partial:t};case"text_delta":{const n=t.content[e.contentIndex];if(n?.type==="text")return n.text+=e.delta,{type:"text_delta",contentIndex:e.contentIndex,delta:e.delta,partial:t};throw new Error("Received text_delta for non-text content")}case"text_end":{const n=t.content[e.contentIndex];if(n?.type==="text")return n.textSignature=e.contentSignature,{type:"text_end",contentIndex:e.contentIndex,content:n.text,partial:t};throw new Error("Received text_end for non-text content")}case"thinking_start":return t.content[e.contentIndex]={type:"thinking",thinking:""},{type:"thinking_start",contentIndex:e.contentIndex,partial:t};case"thinking_delta":{const n=t.content[e.contentIndex];if(n?.type==="thinking")return n.thinking+=e.delta,{type:"thinking_delta",contentIndex:e.contentIndex,delta:e.delta,partial:t};throw new Error("Received thinking_delta for non-thinking content")}case"thinking_end":{const n=t.content[e.contentIndex];if(n?.type==="thinking")return n.thinkingSignature=e.contentSignature,{type:"thinking_end",contentIndex:e.contentIndex,content:n.thinking,partial:t};throw new Error("Received thinking_end for non-thinking content")}case"toolcall_start":{const n={type:"toolCall",id:e.id,name:e.toolName,arguments:{},partialJson:""};return t.content[e.contentIndex]=n,{type:"toolcall_start",contentIndex:e.contentIndex,partial:t}}case"toolcall_delta":{const n=t.content[e.contentIndex];if(w(n))return n.partialJson+=e.delta,n.arguments=b(n.partialJson)||{},t.content[e.contentIndex]={...n},{type:"toolcall_delta",contentIndex:e.contentIndex,delta:e.delta,partial:t};throw new Error("Received toolcall_delta for non-toolCall content")}case"toolcall_end":{const n=t.content[e.contentIndex];if(w(n)){const{partialJson:s,...r}=n;return t.content[e.contentIndex]=r,{type:"toolcall_end",contentIndex:e.contentIndex,toolCall:r,partial:t}}return}case"done":return t.stopReason=e.reason,t.usage=e.usage,{type:"done",reason:e.reason,message:t};case"error":return t.stopReason=e.reason,t.errorMessage=e.errorMessage,t.usage=e.usage,{type:"error",reason:e.reason,error:t};default:return}}a(S,"processProxyEvent");export{C as streamProxy};

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

@@ -0,0 +1,15 @@
+/**
+ * Structured-adaptive agent loop for Catui.
+ * Keeps the public AgentMessage/EventStream contract while using a query-loop
+ * state machine with ordered tool-result pairing and safe tool batching.
+ */
+/**
+ * [WHO]: structuredAdaptiveAgentLoop, structuredAdaptiveAgentLoopContinue
+ * [FROM]: Depends on @catui/ai, ./types, ./errors, structured-adaptive tool executors, and shared loop helpers.
+ * [TO]: Consumed by core/lib/agent-core/src/agent.ts and index.ts
+ * [HERE]: core/lib/agent-core/src/structured-adaptive-agent-loop.ts - selectable structured-adaptive query loop framework with recovered-error tombstoning
+ */
+import { EventStream } from "@catui/ai/events";
+import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from "./types.js";
+export declare function structuredAdaptiveAgentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;
+export declare function structuredAdaptiveAgentLoopContinue(context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;

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

@@ -0,0 +1,2 @@
+var z=Object.defineProperty;var c=(e,s)=>z(e,"name",{value:s,configurable:!0});import{EventStream as N}from"@catui/ai/events";import{isContextOverflow as X}from"@catui/ai/overflow";import{streamSimple as V}from"@catui/ai/stream";import{resolveMaxToolConcurrency as Y,runStructuredAdaptiveTools as j}from"./structured-adaptive-tool-orchestration.js";import{StructuredAdaptiveStreamingToolExecutor as G}from"./structured-adaptive-streaming-tool-executor.js";import{ValidationError as L}from"./errors.js";import{computeRecoveryMaxTokens as Q,createOutputTokenRecoveryMessage as J,createTokenBudgetContinuation as Z}from"./agent-loop-continuations.js";import{createInterruptedToolResults as ee,createSkippedToolCallLimitResults as se,enforceToolResultBatchSize as B}from"./agent-loop-tool-results.js";import{flushReadyToolUseSummaries as te,startToolUseSummary as oe}from"./agent-loop-tool-summaries.js";import{buildAgentRunPolicy as ae,resolveAgentRunLoopFramework as ne}from"./agent-run-result.js";import{waitForAbortableOperation as b,waitForAssistantStream as re,waitForAssistantStreamEvent as ue}from"./agent-loop-stream-events.js";const pe=256,le=512,ie=1,me=3,de=1;function O(e){if(process.env.CATUI_DEBUG==="1")try{const{appendFileSync:s}=require("fs"),{join:t}=require("path"),{homedir:r}=require("os");s(t(r(),".catui","agent","catui-debug.log"),`[${new Date().toISOString()}] [loop] ${e}
+`)}catch{}}c(O,"_tlog");function be(e,s,t,r,a){const p=W();return(async()=>{const y=[...e],l={...s,messages:[...s.messages,...e]};try{p.push({type:"agent_start"}),p.push({type:"turn_start"});for(const R of e)p.push({type:"message_start",message:R}),p.push({type:"message_end",message:R});await q(l,y,t,r,p,a)}catch(R){I(p,y,t,R,r)}})(),p}c(be,"structuredAdaptiveAgentLoop");function Ee(e,s,t,r){if(e.messages.length===0)throw new L("Cannot continue: no messages in context");if(e.messages[e.messages.length-1].role==="assistant")throw new L("Cannot continue from message role: assistant");const a=W();return(async()=>{const p=[],y={...e};try{a.push({type:"agent_start"}),a.push({type:"turn_start"}),await q(y,p,s,t,a,r)}catch(l){I(a,p,s,l,t)}})(),a}c(Ee,"structuredAdaptiveAgentLoopContinue");function W(){return new N(e=>e.type==="agent_end",e=>e.type==="agent_end"?e.messages:[])}c(W,"createAgentStream");async function q(e,s,t,r,a,p){const y=t.maxTurnsPerPrompt??pe,l=t.maxToolCallsPerPrompt??le,R=t.maxOutputTokenRecoveryAttempts??ie,A=t.maxStopHookContinuations??me,E=t.maxModelErrorRecoveryAttempts??de,w=await b(t.getSteeringMessages?t.getSteeringMessages():[],r),U={loopStart:performance.now(),streamStart:0,firstTokenAt:0,turnCount:0};O("run_loop start (structured-adaptive)");const o={config:t,turnCount:0,toolCallCount:0,transition:{reason:"start"},transitions:[],pendingMessages:w.type==="resolved"?w.value||[]:[],pendingToolUseSummaries:[],stopHookActive:!1,stopHookContinuationCount:0,maxOutputTokensRecoveryCount:0,modelErrorRecoveryCount:0,tokenBudgetContinuationCount:0,hasAttemptedReactiveCompact:!1,startedAt:Date.now(),usage:K(),permissionDenials:[]};if(w.type==="aborted"){F(a,e,s,o);return}let D=!0;for(;;){if(D?D=!1:a.push({type:"turn_start"}),o.pendingToolUseSummaries=te(o.pendingToolUseSummaries,e.messages,s,a),o.pendingMessages.length>0){for(const n of o.pendingMessages)a.push({type:"message_start",message:n}),a.push({type:"message_end",message:n}),e.messages.push(n),s.push(n);o.pendingMessages=[]}if(o.turnCount+=1,o.turnCount>y){const n=C(t,`max_turns_reached: stopped after ${y} assistant turns to prevent a runaway agent loop.`);e.messages.push(n),s.push(n),a.push({type:"message_start",message:{...n}}),a.push({type:"message_end",message:n}),a.push({type:"turn_end",message:n,toolResults:[]}),S(o,{reason:"max_turns_reached",maxTurns:y,turnCount:o.turnCount}),o.finalStopReason="error",o.finalErrorMessage=n.errorMessage,o.finalErrorSubtype="max_turns_reached",M(a,s,o);return}const k=new G(e.tools,r,a,Y(t.maxToolConcurrency),t.canUseTool);U.turnCount++;const g=s.length,u=await ce(e,t,r,a,p,o.maxOutputTokensOverride,k,U);if(s.push(u),ge(o.usage,u.usage),o.maxOutputTokensOverride=void 0,u.stopReason==="error"||u.stopReason==="aborted"){const n=u.stopReason==="aborted"?"aborted":X(u,t.model.contextWindow)?"context_overflow":"model_error",d=k.size>0?await k.discardAndDrain(u.stopReason==="aborted"?"assistant stream aborted":"assistant stream error",u.stopReason==="aborted"?"cancel":"all"):{toolResults:[],contextMessages:[],permissionDenials:[]},T=B(d.toolResults,t.maxToolResultBatchSizeChars),x=ee(u,new Set(T.map(i=>i.toolCallId))),v=[...T,...x];for(const i of v)e.messages.push(i),s.push(i),a.push({type:"message_start",message:i}),a.push({type:"message_end",message:i});for(const i of d.contextMessages)e.messages.push(i),s.push(i),a.push({type:"message_start",message:i}),a.push({type:"message_end",message:i});if(u.stopReason==="error"&&t.recoverModelError&&o.modelErrorRecoveryCount<E){const i=o.modelErrorRecoveryCount+1,$=await t.recoverModelError({message:u,messages:e.messages,errorSubtype:n,attempt:i});if($.action==="retry"){a.push({type:"turn_end",message:u,toolResults:v}),o.modelErrorRecoveryCount=i,s.splice(g),e.messages=$.messages,S(o,$.transition??{reason:"model_error_recovery",subtype:n,attempt:i});continue}}o.permissionDenials.push(...d.permissionDenials),a.push({type:"turn_end",message:u,toolResults:v}),o.finalStopReason=u.stopReason,o.finalErrorMessage=u.errorMessage,o.finalErrorSubtype=n,M(a,s,o);return}const f=u.content.filter(n=>n.type==="toolCall");if(f.length===0){if(a.push({type:"turn_end",message:u,toolResults:[]}),u.stopReason==="length"&&o.maxOutputTokensRecoveryCount<R){o.maxOutputTokensRecoveryCount+=1,o.maxOutputTokensOverride=Q(t,u),o.pendingMessages=[J(o.maxOutputTokensRecoveryCount)],S(o,{reason:"max_output_tokens_recovery",attempt:o.maxOutputTokensRecoveryCount});continue}if(t.runStopHooks&&!o.stopHookActive){o.stopHookActive=!0;const x=await b(t.runStopHooks({message:u,messages:e.messages}),r);if(o.stopHookActive=!1,x.type==="aborted"){F(a,e,s,o);return}const v=x.value;if(v.action==="continue"&&v.messages.length>0){if(o.stopHookContinuationCount>=A){const i=C(t,`stop_hook_limit_reached: stopped after ${A} stop-hook continuation turns.`);e.messages.push(i),s.push(i),a.push({type:"message_start",message:{...i}}),a.push({type:"message_end",message:i}),a.push({type:"turn_end",message:i,toolResults:[]}),S(o,{reason:"stop_hook_limit_reached",maxContinuations:A,continuationCount:o.stopHookContinuationCount}),o.finalStopReason="error",o.finalErrorMessage=i.errorMessage,o.finalErrorSubtype="stop_hook_limit_reached",M(a,s,o);return}o.stopHookContinuationCount+=1,o.pendingMessages=v.messages,S(o,{reason:"stop_hook_blocking",continuationCount:o.stopHookContinuationCount});continue}}const n=Z(t,o.usage.output,o.tokenBudgetContinuationCount);if(n){o.tokenBudgetContinuationCount+=1,o.pendingMessages=[n.message],S(o,{reason:"token_budget_continuation",continuationCount:o.tokenBudgetContinuationCount,outputTokens:n.outputTokens,targetTokens:n.targetTokens});continue}const d=await b(t.getFollowUpMessages?t.getFollowUpMessages():[],r);if(d.type==="aborted"){F(a,e,s,o);return}const T=d.value||[];if(T.length===0)break;o.pendingMessages=T,S(o,{reason:"follow_up"});continue}if(o.toolCallCount+f.length>l){const n=se(u,`Tool call skipped because this prompt reached the ${l} tool-call limit.`);for(const T of n)e.messages.push(T),s.push(T),a.push({type:"message_start",message:T}),a.push({type:"message_end",message:T});const d=C(t,`tool_call_limit_reached: stopped before executing ${f.length} tool call${f.length===1?"":"s"} because this prompt reached the ${l} tool-call limit.`);e.messages.push(d),s.push(d),a.push({type:"message_start",message:{...d}}),a.push({type:"message_end",message:d}),a.push({type:"turn_end",message:d,toolResults:n}),S(o,{reason:"tool_call_limit_reached",maxToolCalls:l,requestedToolCalls:f.length,toolCallCount:o.toolCallCount}),o.finalStopReason="error",o.finalErrorMessage=d.errorMessage,o.finalErrorSubtype="tool_call_limit_reached",M(a,s,o);return}o.toolCallCount+=f.length;const h=k.size>0?await k.drain():await j(f,e.tools,r,a,t.getSteeringMessages,t.maxToolConcurrency,t.canUseTool),m=B(h.toolResults,t.maxToolResultBatchSizeChars);o.permissionDenials.push(...h.permissionDenials);for(const n of m)e.messages.push(n),s.push(n),a.push({type:"message_start",message:n}),a.push({type:"message_end",message:n});for(const n of h.contextMessages)e.messages.push(n),s.push(n),a.push({type:"message_start",message:n}),a.push({type:"message_end",message:n});const _=oe(t,{assistantMessage:u,toolResults:m,contextMessages:h.contextMessages,messages:e.messages});_&&o.pendingToolUseSummaries.push(_),a.push({type:"turn_end",message:u,toolResults:m}),h.steeringMessages&&h.steeringMessages.length>0?o.pendingMessages=h.steeringMessages:o.pendingMessages=await t.getSteeringMessages?.()||[],S(o,{reason:"tool_result",toolCallCount:f.length})}o.finalStopReason=o.finalStopReason??H(s),M(a,s,o)}c(q,"runStructuredAdaptiveQueryLoop");async function ce(e,s,t,r,a,p,y,l){let R=e.messages;if(s.transformContext){const m=await b(s.transformContext(R,t),t);if(m.type==="aborted")return P(e,r,s);R=m.value}const A=await b(s.convertToLlm(R),t);if(A.type==="aborted")return P(e,r,s);const E=A.value,w={systemPrompt:e.systemPrompt,messages:E,tools:e.tools},U=a||V,o=await b(s.getApiKey?s.getApiKey(s.model.provider):void 0,t);if(o.type==="aborted")return P(e,r,s);const D=o.value||s.apiKey;l&&(l.streamStart=performance.now(),O(`stream_request_start model=${s.model.id} provider=${s.model.provider} msgCount=${E.length} maxTokens=${p??s.maxTokens} (+${(l.streamStart-l.loopStart).toFixed(0)}ms from loop_start)`)),r.push({type:"stream_request_start",model:s.model.id,provider:s.model.provider,api:s.model.api,messageCount:E.length,maxTokens:p??s.maxTokens});const k=await re(U(s.model,w,{...s,maxTokens:p??s.maxTokens,apiKey:D,signal:t}),t);if(k==="aborted"){const m=C(s,"Request was aborted");return m.stopReason="aborted",e.messages.push(m),r.push({type:"message_start",message:{...m}}),r.push({type:"message_end",message:m}),m}let g=null,u=!1;const f=k[Symbol.asyncIterator]();for(;;){let m;try{m=await ue(f,t)}catch(n){const d=C(s,n instanceof Error?n.message:String(n));return u?e.messages[e.messages.length-1]=d:(e.messages.push(d),r.push({type:"message_start",message:{...d}})),r.push({type:"message_end",message:d}),d}if(m==="aborted"){f.return?.();const n=C(s,"Request was aborted");return n.stopReason="aborted",u?e.messages[e.messages.length-1]=n:(e.messages.push(n),r.push({type:"message_start",message:{...n}})),r.push({type:"message_end",message:n}),n}if(m.done)break;const _=m.value;switch(l&&!l.firstTokenAt&&(l.firstTokenAt=performance.now(),O(`first_token ttft=${(l.firstTokenAt-l.streamStart).toFixed(0)}ms (+${(l.firstTokenAt-l.loopStart).toFixed(0)}ms from loop_start)`)),_.type){case"start":g=_.partial,e.messages.push(g),u=!0,r.push({type:"message_start",message:{...g}});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":g&&(g=_.partial,e.messages[e.messages.length-1]=g,r.push({type:"message_update",assistantMessageEvent:_,message:{...g}}));break;case"toolcall_end":g&&(g=_.partial,e.messages[e.messages.length-1]=g,r.push({type:"message_update",assistantMessageEvent:_,message:{...g}}),y?.addTool(_.toolCall));break;case"done":case"error":{const n=_.type==="done"?_.message:_.error;return u?e.messages[e.messages.length-1]=n:e.messages.push(n),u||r.push({type:"message_start",message:{...n}}),r.push({type:"message_end",message:n}),n}}}if(l){const m=performance.now();O(`stream_end duration=${(m-l.streamStart).toFixed(0)}ms total=${(m-l.loopStart).toFixed(0)}ms`)}const h=k.resultIfResolved()??C(s,"Provider stream ended without a final assistant message");return u?e.messages[e.messages.length-1]=h:(e.messages.push(h),r.push({type:"message_start",message:{...h}})),r.push({type:"message_end",message:h}),h}c(ce,"streamAssistantResponse");function P(e,s,t){const r=C(t,"Request was aborted");return r.stopReason="aborted",e.messages.push(r),s.push({type:"message_start",message:{...r}}),s.push({type:"message_end",message:r}),r}c(P,"pushAbortedAssistantMessage");function F(e,s,t,r){const a=C(r.config,"Request was aborted");a.stopReason="aborted",s.messages.push(a),t.push(a),e.push({type:"message_start",message:{...a}}),e.push({type:"message_end",message:a}),e.push({type:"turn_end",message:a,toolResults:[]}),r.finalStopReason="aborted",r.finalErrorMessage=a.errorMessage,r.finalErrorSubtype="aborted",M(e,t,r)}c(F,"finishStructuredAdaptiveWithAbortedTurn");function C(e,s){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:s,timestamp:Date.now()}}c(C,"createLoopLimitMessage");function I(e,s,t,r,a){const p=C(t,r instanceof Error?r.message:String(r));a?.aborted&&(p.stopReason="aborted"),s.push(p),e.push({type:"message_start",message:{...p}}),e.push({type:"message_end",message:p}),e.push({type:"turn_end",message:p,toolResults:[]});const y={config:t,turnCount:0,toolCallCount:0,transition:{reason:"start"},transitions:[],pendingMessages:[],pendingToolUseSummaries:[],stopHookActive:!1,stopHookContinuationCount:0,maxOutputTokensRecoveryCount:0,modelErrorRecoveryCount:0,tokenBudgetContinuationCount:0,hasAttemptedReactiveCompact:!1,startedAt:Date.now(),usage:K(),permissionDenials:[],finalStopReason:p.stopReason,finalErrorMessage:p.errorMessage,finalErrorSubtype:a?.aborted?"aborted":"loop_error"};M(e,s,y)}c(I,"endWithLoopError");function M(e,s,t){e.push({type:"agent_result",stopReason:t.finalStopReason??H(s),loopFramework:ne(t.config),loopPolicy:ae(t.config),turnCount:t.turnCount,toolCallCount:t.toolCallCount,durationMs:Date.now()-t.startedAt,usage:t.usage,permissionDenialCount:t.permissionDenials.length,permissionDenials:t.permissionDenials,transitions:t.transitions.length>0?t.transitions:void 0,lastTransition:t.transition,errorMessage:t.finalErrorMessage,errorSubtype:t.finalErrorSubtype}),O(`loop_finished stopReason=${t.finalStopReason??H(s)} turns=${t.turnCount} tools=${t.toolCallCount} duration=${Date.now()-t.startedAt}ms`),e.push({type:"agent_end",messages:s}),e.end(s)}c(M,"finish");function S(e,s){e.transition=s,e.transitions.push(s)}c(S,"recordTransition");function K(){return{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}}}c(K,"emptyUsage");function ge(e,s){e.input+=s.input,e.output+=s.output,e.cacheRead+=s.cacheRead,e.cacheWrite+=s.cacheWrite,e.totalTokens+=s.totalTokens,e.cost.input+=s.cost.input,e.cost.output+=s.cost.output,e.cost.cacheRead+=s.cost.cacheRead,e.cost.cacheWrite+=s.cost.cacheWrite,e.cost.total+=s.cost.total}c(ge,"addUsage");function H(e){for(let s=e.length-1;s>=0;s-=1){const t=e[s];if(t?.role==="assistant")return t.stopReason}return"stop"}c(H,"inferStopReason");export{be as structuredAdaptiveAgentLoop,Ee as structuredAdaptiveAgentLoopContinue};

package/dist/core/lib/agent-core/src/structured-adaptive-streaming-tool-executor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Structured-adaptive streaming tool executor.
+ * Starts complete streamed tool calls before the assistant response finishes,
+ * while preserving ordered tool_result emission for the next model turn.
+ */
+/**
+ * [WHO]: StructuredAdaptiveStreamingToolExecutor
+ * [FROM]: Depends on @catui/ai, ./types, ./structured-adaptive-tool-orchestration
+ * [TO]: Consumed by ./structured-adaptive-agent-loop.ts
+ * [HERE]: core/lib/agent-core/src/structured-adaptive-streaming-tool-executor.ts - streaming tool scheduling for weak-model-compatible loop
+ */
+import { EventStream } from "@catui/ai/events";
+import type { AgentEvent, AgentLoopConfig, AgentMessage, AgentTool } from "./types.js";
+import { type StructuredAdaptiveToolCall, type StructuredAdaptiveToolRunResult } from "./structured-adaptive-tool-orchestration.js";
+export declare class StructuredAdaptiveStreamingToolExecutor {
+    private readonly stream;
+    private readonly canUseTool?;
+    private readonly toolByName;
+    private readonly records;
+    private readonly maxConcurrency;
+    private discardedReason;
+    private parentAborted;
+    private parentAbortReason;
+    constructor(tools: AgentTool<any>[] | undefined, signal: AbortSignal | undefined, stream: EventStream<AgentEvent, AgentMessage[]>, maxConcurrency: number, canUseTool?: AgentLoopConfig["canUseTool"]);
+    get size(): number;
+    addTool(toolCall: StructuredAdaptiveToolCall): void;
+    drain(): Promise<StructuredAdaptiveToolRunResult>;
+    discardAndDrain(reason: string, abortMode?: "all" | "cancel"): Promise<StructuredAdaptiveToolRunResult>;
+    private processQueue;
+    private canStart;
+    private start;
+    private completeWithSyntheticError;
+}

package/dist/core/lib/agent-core/src/structured-adaptive-streaming-tool-executor.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var i=(r,t)=>l(r,"name",{value:t,configurable:!0});import{buildToolMap as c,isStructuredAdaptiveToolCallConcurrencySafe as u,resolveStructuredAdaptiveToolInterruptBehavior as d,runStructuredAdaptiveToolUse as h}from"./structured-adaptive-tool-orchestration.js";class C{static{i(this,"StructuredAdaptiveStreamingToolExecutor")}stream;canUseTool;toolByName;records=[];maxConcurrency;discardedReason;parentAborted=!1;parentAbortReason;constructor(t,e,o,s,a){this.stream=o,this.canUseTool=a,this.toolByName=c(t),this.maxConcurrency=Math.max(1,Math.floor(s)),e?.aborted?(this.parentAborted=!0,this.parentAbortReason=e.reason):e?.addEventListener("abort",()=>{this.parentAborted=!0,this.parentAbortReason=e.reason;for(const n of this.records)n.interruptBehavior==="cancel"&&!n.abortController.signal.aborted&&n.abortController.abort(e.reason)},{once:!0})}get size(){return this.records.length}addTool(t){if(this.records.some(a=>a.toolCall.id===t.id))return;const e=this.toolByName.get(t.name),o=new AbortController,s=d(t,e);this.parentAborted&&s==="cancel"&&o.abort(this.parentAbortReason),this.records.push({toolCall:t,tool:e,isConcurrencySafe:u(t,e),interruptBehavior:s,status:"queued",abortController:o,contextMessages:[]}),this.processQueue()}async drain(){for(this.processQueue();this.records.some(e=>e.status!=="completed");){const e=this.records.filter(o=>o.status==="executing"&&o.promise).map(o=>o.promise);if(e.length===0){this.processQueue();continue}await Promise.race(e),this.processQueue()}const t=this.records.map(e=>e.toolResult);return{toolResults:t,contextMessages:this.records.flatMap(e=>e.contextMessages),permissionDenials:p(t)}}async discardAndDrain(t,e="all"){this.discardedReason=t;for(const o of this.records)o.status==="executing"&&(e==="all"||o.interruptBehavior==="cancel")&&!o.abortController.signal.aborted&&o.abortController.abort(t),o.status==="queued"&&this.completeWithSyntheticError(o,t);return this.drain()}processQueue(){for(const t of this.records)if(t.status==="queued"){if(this.discardedReason){this.completeWithSyntheticError(t,this.discardedReason);continue}if(!this.canStart(t)){if(!t.isConcurrencySafe)return;continue}this.start(t)}}canStart(t){const e=this.records.filter(o=>o.status==="executing");return t.isConcurrencySafe?e.length<this.maxConcurrency&&e.every(o=>o.isConcurrencySafe):e.length===0}start(t){t.status="executing",t.promise=h(t.toolCall,t.tool,t.abortController.signal,this.stream,this.canUseTool).then(e=>{t.toolResult=e.toolResult,t.contextMessages=e.contextMessages}).finally(()=>{t.status="completed"})}completeWithSyntheticError(t,e){const o=Date.now(),s={content:[{type:"text",text:`Tool discarded because ${e}.`}],details:{errorType:"streaming_tool_discarded",reason:e,toolName:t.tool?.name??t.toolCall.name,toolCallId:t.toolCall.id}};this.stream.push({type:"tool_execution_start",toolCallId:t.toolCall.id,toolName:t.toolCall.name,args:t.toolCall.arguments}),this.stream.push({type:"tool_execution_end",toolCallId:t.toolCall.id,toolName:t.toolCall.name,result:s,isError:!0,durationMs:Date.now()-o}),t.toolResult={role:"toolResult",toolCallId:t.toolCall.id,toolName:t.toolCall.name,content:s.content,details:s.details,isError:!0,timestamp:Date.now()},t.contextMessages=[],t.status="completed"}}function p(r){const t=[];for(const e of r){const o=e.details;if(!o||typeof o!="object"||o.errorType!=="permission_denied")continue;const s=o.reason;t.push({toolCallId:e.toolCallId,toolName:e.toolName,reason:typeof s=="string"&&s.length>0?s:void 0})}return t}i(p,"extractPermissionDenials");export{C as StructuredAdaptiveStreamingToolExecutor};

package/dist/core/lib/agent-core/src/structured-adaptive-tool-orchestration.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Structured-adaptive tool orchestration for the selectable structured loop.
+ * Batches concurrency-safe tools, keeps stateful tools serial, and returns
+ * ordered tool_result messages matching assistant tool_use order.
+ */
+/**
+ * [WHO]: runStructuredAdaptiveTools, partitionStructuredAdaptiveToolCalls, StructuredAdaptiveToolCall
+ * [FROM]: Depends on @catui/ai, ./types, ./errors
+ * [TO]: Consumed by ./structured-adaptive-agent-loop.ts and agent-core tests
+ * [HERE]: core/lib/agent-core/src/structured-adaptive-tool-orchestration.ts - tool batching/execution layer for structured-adaptive loop
+ */
+import { type AssistantMessage, type ToolResultMessage } from "@catui/ai/types";
+import { EventStream } from "@catui/ai/events";
+import type { AgentEvent, AgentLoopConfig, AgentMessage, AgentTool, AgentToolPermissionDenial } from "./types.js";
+export type StructuredAdaptiveToolCall = Extract<AssistantMessage["content"][number], {
+    type: "toolCall";
+}>;
+export interface StructuredAdaptiveToolRunResult {
+    toolResults: ToolResultMessage[];
+    contextMessages: AgentMessage[];
+    steeringMessages?: AgentMessage[];
+    permissionDenials: AgentToolPermissionDenial[];
+}
+interface StructuredAdaptiveToolUseResult {
+    toolResult: ToolResultMessage;
+    contextMessages: AgentMessage[];
+}
+export declare function runStructuredAdaptiveTools(toolCalls: StructuredAdaptiveToolCall[], tools: AgentTool<any>[] | undefined, signal: AbortSignal | undefined, stream: EventStream<AgentEvent, AgentMessage[]>, getSteeringMessages?: AgentLoopConfig["getSteeringMessages"], maxConcurrency?: number, canUseTool?: AgentLoopConfig["canUseTool"]): Promise<StructuredAdaptiveToolRunResult>;
+export declare function resolveMaxToolConcurrency(maxConcurrency: number | undefined): number;
+export declare function buildToolMap(tools: AgentTool<any>[] | undefined): Map<string, AgentTool<any>>;
+export declare function partitionStructuredAdaptiveToolCalls(toolCalls: StructuredAdaptiveToolCall[], toolByName: Map<string, AgentTool<any>>): StructuredAdaptiveToolCall[][];
+export declare function isStructuredAdaptiveToolCallConcurrencySafe(toolCall: StructuredAdaptiveToolCall, tool: AgentTool<any> | undefined): boolean;
+export declare function resolveStructuredAdaptiveToolInterruptBehavior(toolCall: StructuredAdaptiveToolCall, tool: AgentTool<any> | undefined): "cancel" | "block";
+export declare function runStructuredAdaptiveToolUse(toolCall: StructuredAdaptiveToolCall, tool: AgentTool<any> | undefined, signal: AbortSignal | undefined, stream: EventStream<AgentEvent, AgentMessage[]>, canUseTool?: AgentLoopConfig["canUseTool"]): Promise<StructuredAdaptiveToolUseResult>;
+export {};

package/dist/core/lib/agent-core/src/structured-adaptive-tool-orchestration.js

@@ -0,0 +1,3 @@
+var T=Object.defineProperty;var a=(e,t)=>T(e,"name",{value:t,configurable:!0});import{validateToolArguments as h}from"@catui/ai/schema";import{ToolNotFoundError as M}from"./errors.js";const _=new Set(["read","find","grep","ls","source","time","web_search","web_fetch","CronList"]),y=10,A="CATUI_MAX_TOOL_USE_CONCURRENCY",E="NANOPENCIL_MAX_TOOL_USE_CONCURRENCY";async function Y(e,t,n,o,s,c,i){const r=[],f=[],u=[],d=b(t),l=v(e,d);let m=0;for(const x of l){const g=await I(x,p=>S(p,d.get(p.name),n,o,i),c),N=g.map(p=>p.toolResult);if(r.push(...N),f.push(...g.flatMap(p=>p.contextMessages)),u.push(...D(N)),m+=x.length,s){const p=await s();if(p.length>0){for(const w of e.slice(m))r.push(k(w,o));return{toolResults:r,contextMessages:f,steeringMessages:p,permissionDenials:u}}}}return{toolResults:r,contextMessages:f,permissionDenials:u}}a(Y,"runStructuredAdaptiveTools");async function I(e,t,n){const o=O(n),s=new Array(e.length);let c=0;async function i(){for(;c<e.length;){const f=c;c+=1,s[f]=await t(e[f])}}a(i,"worker");const r=Math.min(o,e.length);return await Promise.all(Array.from({length:r},()=>i())),s}a(I,"runToolBatch");function O(e){if(e!==void 0)return Math.max(1,Math.floor(e||y));const t=typeof process<"u"?process.env[A]??process.env[E]:void 0,n=t?Number.parseInt(t,10):Number.NaN;return Number.isFinite(n)&&n>0?Math.floor(n):y}a(O,"resolveMaxToolConcurrency");function b(e){const t=new Map;for(const n of e??[]){t.set(n.name,n);for(const o of n.aliases??[])t.has(o)||t.set(o,n)}return t}a(b,"buildToolMap");function v(e,t){const n=[];let o=[];for(const s of e){const c=t.get(s.name);if(R(s,c)){o.push(s);continue}o.length>0&&(n.push(o),o=[]),n.push([s])}return o.length>0&&n.push(o),n}a(v,"partitionStructuredAdaptiveToolCalls");function R(e,t){if(!t)return _.has(e.name);const n=t.isConcurrencySafe;if(typeof n=="function")try{return n(h(t,e))}catch{return!1}return n??_.has(e.name)}a(R,"isStructuredAdaptiveToolCallConcurrencySafe");function F(e,t){if(!t)return"block";const n=t?.interruptBehavior;if(typeof n=="function")try{return n(h(t,e))}catch{return"block"}return n??"block"}a(F,"resolveStructuredAdaptiveToolInterruptBehavior");async function S(e,t,n,o,s){const c=Date.now();o.push({type:"tool_execution_start",toolCallId:e.id,toolName:e.name,args:e.arguments});let i,r=!1;try{if(!t)throw new M(e.name);const u=h(t,e),d=await t.validateInput?.(u);if(typeof d=="string"&&d.trim())throw new Error(d);const l=await s?.({toolCallId:e.id,toolName:t.name,requestedToolName:e.name,input:u,rawInput:e.arguments,tool:t});if(l?.decision==="deny"){const m=l.reason?.trim();i={content:[{type:"text",text:m?`Permission denied: ${m}`:`Permission denied for ${t.name}`}],details:{errorType:"permission_denied",reason:m,toolName:t.name,toolCallId:e.id}},r=!0}else i=await t.execute(e.id,u,n,m=>{o.push({type:"tool_execution_update",toolCallId:e.id,toolName:e.name,args:e.arguments,partialResult:m})}),i=L(i,t.maxResultSizeChars)}catch(u){const d=u instanceof Error?u.message:String(u);i={content:[{type:"text",text:d}],details:U(d)?{errorType:"permission_denied",reason:d,toolName:t?.name??e.name,toolCallId:e.id}:{}},r=!0}return o.push({type:"tool_execution_end",toolCallId:e.id,toolName:e.name,result:i,isError:r,durationMs:Date.now()-c}),{toolResult:{role:"toolResult",toolCallId:e.id,toolName:e.name,content:i.content,details:i.details,isError:r,timestamp:Date.now()},contextMessages:i.contextMessages??[]}}a(S,"runStructuredAdaptiveToolUse");function U(e){return/^Permission (denied|request was cancelled)/i.test(e.trim())}a(U,"isPermissionDeniedMessage");function D(e){const t=[];for(const n of e){const o=n.details;if(!o||typeof o!="object"||o.errorType!=="permission_denied")continue;const s=o.reason;t.push({toolCallId:n.toolCallId,toolName:n.toolName,reason:typeof s=="string"&&s.length>0?s:void 0})}return t}a(D,"extractPermissionDenials");function L(e,t){if(!t||t<=0)return e;let n=Math.floor(t),o=!1;const s=e.content.map(r=>{if(r.type!=="text")return r;if(n<=0)return o=!0,{...r,text:""};if(r.text.length<=n)return n-=r.text.length,r;o=!0;const f=r.text.slice(0,n);return n=0,{...r,text:f}});if(!o)return e;const c=`
+
+[Tool result truncated to ${Math.floor(t)} characters.]`;let i=-1;for(let r=s.length-1;r>=0;r-=1)if(s[r]?.type==="text"){i=r;break}if(i>=0){const r=s[i];s[i]={...r,text:`${r.text}${c}`}}else s.push({type:"text",text:c.trimStart()});return{...e,content:s}}a(L,"enforceMaxResultSize");function k(e,t){const n=Date.now(),o={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:o,isError:!0,durationMs:Date.now()-n}),{role:"toolResult",toolCallId:e.id,toolName:e.name,content:o.content,details:o.details,isError:!0,timestamp:Date.now()}}a(k,"skipStructuredAdaptiveToolCall");export{b as buildToolMap,R as isStructuredAdaptiveToolCallConcurrencySafe,v as partitionStructuredAdaptiveToolCalls,O as resolveMaxToolConcurrency,F as resolveStructuredAdaptiveToolInterruptBehavior,S as runStructuredAdaptiveToolUse,Y as runStructuredAdaptiveTools};