@prestyj/agent 4.2.15

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nolan Grout
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# @prestyj/agent
+
+<p align="center">
+  <strong>Agent loop with multi-turn tool execution. Build agents that think, act, and loop.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@prestyj/agent"><img src="https://img.shields.io/npm/v/@prestyj/agent?style=for-the-badge" alt="npm version"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+</p>
+
+Give an LLM tools. It calls them. Results go back in. It loops until it's done. That's it.
+
+Built on top of [`@prestyj/ai`](../ai/README.md). Part of the [EZCoder](../../README.md) monorepo.
+
+---
+
+## Install
+
+```bash
+npm i @prestyj/agent
+```
+
+---
+
+## How it works
+
+Create an `Agent` with a provider, model, and tools. Call `agent.prompt()` to start a conversation.
+
+- **`for await`** gives you streaming events (`text_delta`, `tool_call_start`, `tool_call_end`, `agent_done`, etc.)
+- **`await`** gives you the final result (`message`, `totalTurns`, `totalUsage`)
+
+Same dual-nature pattern as `@prestyj/ai`. The `Agent` class maintains conversation history — each `prompt()` call continues the conversation.
+
+For full control, use `agentLoop()` directly — a pure async generator that takes a messages array and options.
+
+### Tools
+
+Define tools with a name, description, Zod schema for parameters, and an `execute` function. The execute function receives typed args and a `ToolContext` with `signal`, `toolCallId`, and `onUpdate`.
+
+Return a string, or a `{ content, details }` object for structured results. If `execute` throws, the error becomes a tool result (not a crash). The agent sees the error and can retry or adjust.
+
+### Safety
+
+- `maxTurns` (default: 100) prevents runaway loops
+- `AbortSignal` support for cancellation
+- Zod validation on tool args
+- `maxContinuations` (default: 5) caps consecutive `pause_turn` continuations
+
+---
+
+## Events
+
+| Event | Description |
+|---|---|
+| `text_delta` | Incremental text output |
+| `thinking_delta` | Extended thinking output |
+| `tool_call_start` | Tool invocation started (name, args) |
+| `tool_call_update` | Progress update from a running tool |
+| `tool_call_end` | Tool finished (result, duration, isError) |
+| `server_tool_call` | Server-side tool invocation |
+| `server_tool_result` | Server-side tool result |
+| `turn_end` | One LLM call completed (stop reason, usage) |
+| `agent_done` | All turns finished (total turns, total usage) |
+| `error` | Fatal error |
+
+---
+
+## Options
+
+| Option | Type | Description |
+|---|---|---|
+| `provider` | `"anthropic" \| "openai" \| "glm" \| "moonshot"` | Required |
+| `model` | `string` | Required |
+| `system` | `string` | System prompt |
+| `tools` | `AgentTool[]` | Tools with Zod schemas and execute functions |
+| `serverTools` | `ServerToolDefinition[]` | Server-side tool definitions |
+| `maxTurns` | `number` | Max LLM calls (default: 100) |
+| `maxTokens` | `number` | Max output tokens per turn |
+| `temperature` | `number` | Sampling temperature |
+| `thinking` | `"low" \| "medium" \| "high" \| "max"` | Extended thinking |
+| `apiKey` | `string` | Provider API key |
+| `baseUrl` | `string` | Custom endpoint |
+| `signal` | `AbortSignal` | Cancellation |
+| `cacheRetention` | `"none" \| "short" \| "long"` | Prompt cache preference |
+| `compaction` | `boolean` | Server-side compaction (Anthropic only) |
+| `maxContinuations` | `number` | Max pause_turn continuations (default: 5) |
+| `transformContext` | `(messages) => messages` | Transform messages before each LLM call |
+
+`transformContext` is called before each LLM call. Use it for compaction, truncation, or injecting dynamic context.
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,376 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Agent: () => Agent,
+  AgentStream: () => AgentStream,
+  agentLoop: () => agentLoop,
+  isContextOverflow: () => isContextOverflow
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/agent.ts
+var import_ai2 = require("@prestyj/ai");
+
+// src/agent-loop.ts
+var import_ai = require("@prestyj/ai");
+var DEFAULT_MAX_TURNS = 100;
+function isContextOverflow(err) {
+  if (!(err instanceof Error)) return false;
+  const msg = err.message.toLowerCase();
+  return msg.includes("prompt is too long") || msg.includes("context_length_exceeded") || msg.includes("maximum context length") || msg.includes("token") && msg.includes("exceed");
+}
+function isOverloaded(err) {
+  if (!(err instanceof Error)) return false;
+  const msg = err.message.toLowerCase();
+  if (msg.includes("insufficient balance") || msg.includes("quota exceeded") || msg.includes("billing")) {
+    return false;
+  }
+  return msg.includes("overloaded") || msg.includes("rate limit") || msg.includes("too many requests") || msg.includes("429") || msg.includes("529");
+}
+async function* agentLoop(messages, options) {
+  const maxTurns = options.maxTurns ?? DEFAULT_MAX_TURNS;
+  const maxContinuations = options.maxContinuations ?? 5;
+  const toolMap = new Map((options.tools ?? []).map((t) => [t.name, t]));
+  const totalUsage = { inputTokens: 0, outputTokens: 0 };
+  let turn = 0;
+  let consecutivePauses = 0;
+  let overflowRetries = 0;
+  let overloadRetries = 0;
+  const MAX_OVERFLOW_RETRIES = 3;
+  const MAX_OVERLOAD_RETRIES = 3;
+  const OVERLOAD_RETRY_DELAY_MS = 3e3;
+  while (turn < maxTurns) {
+    options.signal?.throwIfAborted();
+    turn++;
+    if (options.transformContext) {
+      const transformed = await options.transformContext(messages);
+      if (transformed !== messages) {
+        messages.length = 0;
+        messages.push(...transformed);
+      }
+    }
+    let response;
+    try {
+      const result = (0, import_ai.stream)({
+        provider: options.provider,
+        model: options.model,
+        messages,
+        tools: options.tools,
+        serverTools: options.serverTools,
+        webSearch: options.webSearch,
+        maxTokens: options.maxTokens,
+        temperature: options.temperature,
+        thinking: options.thinking,
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        signal: options.signal,
+        accountId: options.accountId,
+        cacheRetention: options.cacheRetention,
+        compaction: options.compaction
+      });
+      result.response.catch(() => {
+      });
+      for await (const event of result) {
+        if (event.type === "text_delta") {
+          yield { type: "text_delta", text: event.text };
+        } else if (event.type === "thinking_delta") {
+          yield { type: "thinking_delta", text: event.text };
+        } else if (event.type === "server_toolcall") {
+          yield {
+            type: "server_tool_call",
+            id: event.id,
+            name: event.name,
+            input: event.input
+          };
+        } else if (event.type === "server_toolresult") {
+          yield {
+            type: "server_tool_result",
+            toolUseId: event.toolUseId,
+            resultType: event.resultType,
+            data: event.data
+          };
+        }
+      }
+      response = await result.response;
+    } catch (err) {
+      if (overflowRetries < MAX_OVERFLOW_RETRIES && isContextOverflow(err) && options.transformContext) {
+        overflowRetries++;
+        const transformed = await options.transformContext(messages, { force: true });
+        if (transformed !== messages) {
+          messages.length = 0;
+          messages.push(...transformed);
+        }
+        turn--;
+        continue;
+      }
+      if (overloadRetries < MAX_OVERLOAD_RETRIES && isOverloaded(err)) {
+        overloadRetries++;
+        await new Promise((r) => setTimeout(r, OVERLOAD_RETRY_DELAY_MS));
+        turn--;
+        continue;
+      }
+      throw err;
+    }
+    overflowRetries = 0;
+    overloadRetries = 0;
+    totalUsage.inputTokens += response.usage.inputTokens;
+    totalUsage.outputTokens += response.usage.outputTokens;
+    if (response.usage.cacheRead) {
+      totalUsage.cacheRead = (totalUsage.cacheRead ?? 0) + response.usage.cacheRead;
+    }
+    if (response.usage.cacheWrite) {
+      totalUsage.cacheWrite = (totalUsage.cacheWrite ?? 0) + response.usage.cacheWrite;
+    }
+    messages.push(response.message);
+    yield {
+      type: "turn_end",
+      turn,
+      stopReason: response.stopReason,
+      usage: response.usage
+    };
+    if (response.stopReason === "pause_turn") {
+      consecutivePauses++;
+      if (consecutivePauses >= maxContinuations) {
+        break;
+      }
+      continue;
+    }
+    consecutivePauses = 0;
+    if (response.stopReason !== "tool_use") {
+      yield {
+        type: "agent_done",
+        totalTurns: turn,
+        totalUsage: { ...totalUsage }
+      };
+      return {
+        message: response.message,
+        totalTurns: turn,
+        totalUsage: { ...totalUsage }
+      };
+    }
+    const allToolCalls = extractToolCalls(response.message.content);
+    const toolCalls = [];
+    const toolResults = [];
+    for (const tc of allToolCalls) {
+      if (tc.name.startsWith("$")) {
+        toolResults.push({
+          type: "tool_result",
+          toolCallId: tc.id,
+          content: JSON.stringify(tc.args)
+        });
+      } else {
+        toolCalls.push(tc);
+      }
+    }
+    const eventStream = new import_ai.EventStream();
+    const executions = toolCalls.map(async (toolCall) => {
+      const startTime = Date.now();
+      eventStream.push({
+        type: "tool_call_start",
+        toolCallId: toolCall.id,
+        name: toolCall.name,
+        args: toolCall.args
+      });
+      let resultContent;
+      let details;
+      let isError = false;
+      const tool = toolMap.get(toolCall.name);
+      if (!tool) {
+        resultContent = `Unknown tool: ${toolCall.name}`;
+        isError = true;
+      } else {
+        try {
+          const parsed = tool.parameters.parse(toolCall.args);
+          const ctx = {
+            signal: options.signal ?? AbortSignal.timeout(3e5),
+            toolCallId: toolCall.id,
+            onUpdate: (update) => {
+              eventStream.push({
+                type: "tool_call_update",
+                toolCallId: toolCall.id,
+                update
+              });
+            }
+          };
+          const raw = await tool.execute(parsed, ctx);
+          const normalized = normalizeToolResult(raw);
+          resultContent = normalized.content;
+          details = normalized.details;
+        } catch (err) {
+          isError = true;
+          resultContent = err instanceof Error ? err.message : String(err);
+        }
+      }
+      const durationMs = Date.now() - startTime;
+      eventStream.push({
+        type: "tool_call_end",
+        toolCallId: toolCall.id,
+        result: resultContent,
+        details,
+        isError,
+        durationMs
+      });
+      return { toolCallId: toolCall.id, content: resultContent, isError };
+    });
+    const abortHandler = () => eventStream.abort(new Error("aborted"));
+    options.signal?.addEventListener("abort", abortHandler, { once: true });
+    let toolResultsFinalized = false;
+    Promise.all(executions).then((results) => {
+      if (toolResultsFinalized) return;
+      for (const tc of toolCalls) {
+        const r = results.find((x) => x.toolCallId === tc.id);
+        toolResults.push({
+          type: "tool_result",
+          toolCallId: tc.id,
+          content: r.content,
+          isError: r.isError || void 0
+        });
+      }
+      eventStream.close();
+    }).catch((err) => eventStream.abort(err instanceof Error ? err : new Error(String(err))));
+    try {
+      for await (const event of eventStream) {
+        yield event;
+      }
+    } finally {
+      options.signal?.removeEventListener("abort", abortHandler);
+      toolResultsFinalized = true;
+      for (const tc of toolCalls) {
+        if (!toolResults.some((r) => r.toolCallId === tc.id)) {
+          toolResults.push({
+            type: "tool_result",
+            toolCallId: tc.id,
+            content: "Tool execution was aborted.",
+            isError: true
+          });
+        }
+      }
+      messages.push({ role: "tool", content: toolResults });
+    }
+  }
+  let lastAssistant;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    if (messages[i].role === "assistant") {
+      lastAssistant = messages[i];
+      break;
+    }
+  }
+  yield {
+    type: "agent_done",
+    totalTurns: turn,
+    totalUsage: { ...totalUsage }
+  };
+  return {
+    message: lastAssistant ?? { role: "assistant", content: [] },
+    totalTurns: turn,
+    totalUsage: { ...totalUsage }
+  };
+}
+function normalizeToolResult(raw) {
+  return typeof raw === "string" ? { content: raw } : raw;
+}
+function extractToolCalls(content) {
+  if (typeof content === "string") return [];
+  return content.filter((part) => part.type === "tool_call");
+}
+
+// src/agent.ts
+var AgentStream = class {
+  events;
+  resultPromise;
+  resolveResult;
+  rejectResult;
+  hasConsumer = false;
+  constructor(generator, onDone) {
+    this.events = new import_ai2.EventStream();
+    this.resultPromise = new Promise((resolve, reject) => {
+      this.resolveResult = resolve;
+      this.rejectResult = reject;
+    });
+    this.pump(generator, onDone);
+  }
+  async pump(generator, onDone) {
+    try {
+      let next = await generator.next();
+      while (!next.done) {
+        this.events.push(next.value);
+        next = await generator.next();
+      }
+      this.events.close();
+      this.resolveResult(next.value);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.events.abort(error);
+      this.rejectResult(error);
+    } finally {
+      onDone();
+    }
+  }
+  [Symbol.asyncIterator]() {
+    this.hasConsumer = true;
+    return this.events[Symbol.asyncIterator]();
+  }
+  then(onfulfilled, onrejected) {
+    this.drainEvents().catch(() => {
+    });
+    return this.resultPromise.then(onfulfilled, onrejected);
+  }
+  async drainEvents() {
+    if (this.hasConsumer) return;
+    this.hasConsumer = true;
+    for await (const _ of this.events) {
+    }
+  }
+};
+var Agent = class {
+  messages = [];
+  _running = false;
+  options;
+  constructor(options) {
+    this.options = options;
+    if (options.system) {
+      this.messages.push({ role: "system", content: options.system });
+    }
+  }
+  get running() {
+    return this._running;
+  }
+  prompt(content) {
+    if (this._running) {
+      throw new Error("Agent is already running");
+    }
+    this._running = true;
+    this.messages.push({ role: "user", content });
+    const generator = agentLoop(this.messages, this.options);
+    return new AgentStream(generator, () => {
+      this._running = false;
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Agent,
+  AgentStream,
+  agentLoop,
+  isContextOverflow
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/agent.ts","../src/agent-loop.ts"],"sourcesContent":["// Core\nexport { Agent, AgentStream } from \"./agent.js\";\nexport { agentLoop, isContextOverflow } from \"./agent-loop.js\";\n\n// Types\nexport type {\n  StructuredToolResult,\n  ToolExecuteResult,\n  ToolContext,\n  AgentTool,\n  AgentTextDeltaEvent,\n  AgentThinkingDeltaEvent,\n  AgentToolCallStartEvent,\n  AgentToolCallUpdateEvent,\n  AgentToolCallEndEvent,\n  AgentServerToolCallEvent,\n  AgentServerToolResultEvent,\n  AgentTurnEndEvent,\n  AgentDoneEvent,\n  AgentErrorEvent,\n  AgentEvent,\n  AgentOptions,\n  AgentResult,\n} from \"./types.js\";\n","import { EventStream, type Message } from \"@prestyj/ai\";\nimport { agentLoop } from \"./agent-loop.js\";\nimport type { AgentEvent, AgentOptions, AgentResult } from \"./types.js\";\n\n// ── AgentStream ─────────────────────────────────────────────\n\n/**\n * Dual-nature result: async iterable for streaming events,\n * thenable for awaiting the final AgentResult.\n *\n * ```ts\n * // Stream events\n * for await (const event of agent.prompt(\"hello\")) { ... }\n *\n * // Or just await the result\n * const result = await agent.prompt(\"hello\");\n * ```\n */\nexport class AgentStream implements AsyncIterable<AgentEvent> {\n  private events: EventStream<AgentEvent>;\n  private resultPromise: Promise<AgentResult>;\n  private resolveResult!: (r: AgentResult) => void;\n  private rejectResult!: (e: Error) => void;\n  private hasConsumer = false;\n\n  constructor(generator: AsyncGenerator<AgentEvent, AgentResult>, onDone: () => void) {\n    this.events = new EventStream<AgentEvent>();\n    this.resultPromise = new Promise<AgentResult>((resolve, reject) => {\n      this.resolveResult = resolve;\n      this.rejectResult = reject;\n    });\n    this.pump(generator, onDone);\n  }\n\n  private async pump(\n    generator: AsyncGenerator<AgentEvent, AgentResult>,\n    onDone: () => void,\n  ): Promise<void> {\n    try {\n      let next = await generator.next();\n      while (!next.done) {\n        this.events.push(next.value);\n        next = await generator.next();\n      }\n      this.events.close();\n      this.resolveResult(next.value);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.events.abort(error);\n      this.rejectResult(error);\n    } finally {\n      onDone();\n    }\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<AgentEvent> {\n    this.hasConsumer = true;\n    return this.events[Symbol.asyncIterator]();\n  }\n\n  then<TResult1 = AgentResult, TResult2 = never>(\n    onfulfilled?: ((value: AgentResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): Promise<TResult1 | TResult2> {\n    this.drainEvents().catch(() => {});\n    return this.resultPromise.then(onfulfilled, onrejected);\n  }\n\n  private async drainEvents(): Promise<void> {\n    if (this.hasConsumer) return;\n    this.hasConsumer = true;\n    for await (const _ of this.events) {\n      // consume silently\n    }\n  }\n}\n\n// ── Agent ───────────────────────────────────────────────────\n\nexport class Agent {\n  private messages: Message[] = [];\n  private _running = false;\n  private options: AgentOptions;\n\n  constructor(options: AgentOptions) {\n    this.options = options;\n    if (options.system) {\n      this.messages.push({ role: \"system\", content: options.system });\n    }\n  }\n\n  get running(): boolean {\n    return this._running;\n  }\n\n  prompt(content: string): AgentStream {\n    if (this._running) {\n      throw new Error(\"Agent is already running\");\n    }\n    this._running = true;\n\n    this.messages.push({ role: \"user\", content });\n\n    const generator = agentLoop(this.messages, this.options);\n    return new AgentStream(generator, () => {\n      this._running = false;\n    });\n  }\n}\n","import {\n  stream,\n  EventStream,\n  type Message,\n  type ToolCall,\n  type ToolResult,\n  type Usage,\n  type ContentPart,\n  type AssistantMessage,\n} from \"@prestyj/ai\";\nimport type {\n  AgentEvent,\n  AgentOptions,\n  AgentResult,\n  AgentTool,\n  ToolContext,\n  ToolExecuteResult,\n  StructuredToolResult,\n} from \"./types.js\";\n\nconst DEFAULT_MAX_TURNS = 100;\n\n/**\n * Detect context window overflow errors from LLM providers.\n * Anthropic: \"prompt is too long: N tokens > M maximum\"\n * OpenAI:    \"context_length_exceeded\" / \"maximum context length\"\n */\nexport function isContextOverflow(err: unknown): boolean {\n  if (!(err instanceof Error)) return false;\n  const msg = err.message.toLowerCase();\n  return (\n    msg.includes(\"prompt is too long\") ||\n    msg.includes(\"context_length_exceeded\") ||\n    msg.includes(\"maximum context length\") ||\n    (msg.includes(\"token\") && msg.includes(\"exceed\"))\n  );\n}\n\n/**\n * Detect overloaded/rate-limit errors from LLM providers.\n * HTTP 429 (rate limit) or 529/503 (overloaded).\n */\nexport function isOverloaded(err: unknown): boolean {\n  if (!(err instanceof Error)) return false;\n  const msg = err.message.toLowerCase();\n  // Billing/balance errors often come as 429 but should not be retried\n  if (\n    msg.includes(\"insufficient balance\") ||\n    msg.includes(\"quota exceeded\") ||\n    msg.includes(\"billing\")\n  ) {\n    return false;\n  }\n  return (\n    msg.includes(\"overloaded\") ||\n    msg.includes(\"rate limit\") ||\n    msg.includes(\"too many requests\") ||\n    msg.includes(\"429\") ||\n    msg.includes(\"529\")\n  );\n}\n\nexport async function* agentLoop(\n  messages: Message[],\n  options: AgentOptions,\n): AsyncGenerator<AgentEvent, AgentResult> {\n  const maxTurns = options.maxTurns ?? DEFAULT_MAX_TURNS;\n  const maxContinuations = options.maxContinuations ?? 5;\n  const toolMap = new Map<string, AgentTool>((options.tools ?? []).map((t) => [t.name, t]));\n\n  const totalUsage: Usage = { inputTokens: 0, outputTokens: 0 };\n  let turn = 0;\n  let consecutivePauses = 0;\n  let overflowRetries = 0;\n  let overloadRetries = 0;\n  const MAX_OVERFLOW_RETRIES = 3;\n  const MAX_OVERLOAD_RETRIES = 3;\n  const OVERLOAD_RETRY_DELAY_MS = 3_000;\n\n  while (turn < maxTurns) {\n    options.signal?.throwIfAborted();\n    turn++;\n\n    // ── Mid-loop context transform (compaction / truncation) ──\n    if (options.transformContext) {\n      const transformed = await options.transformContext(messages);\n      if (transformed !== messages) {\n        messages.length = 0;\n        messages.push(...transformed);\n      }\n    }\n\n    // ── Call LLM with overflow recovery ──\n    let response;\n    try {\n      const result = stream({\n        provider: options.provider,\n        model: options.model,\n        messages,\n        tools: options.tools,\n        serverTools: options.serverTools,\n        webSearch: options.webSearch,\n        maxTokens: options.maxTokens,\n        temperature: options.temperature,\n        thinking: options.thinking,\n        apiKey: options.apiKey,\n        baseUrl: options.baseUrl,\n        signal: options.signal,\n        accountId: options.accountId,\n        cacheRetention: options.cacheRetention,\n        compaction: options.compaction,\n      });\n\n      // Suppress unhandled rejection if the iterator path throws first\n      result.response.catch(() => {});\n\n      // Forward streaming deltas\n      for await (const event of result) {\n        if (event.type === \"text_delta\") {\n          yield { type: \"text_delta\" as const, text: event.text };\n        } else if (event.type === \"thinking_delta\") {\n          yield { type: \"thinking_delta\" as const, text: event.text };\n        } else if (event.type === \"server_toolcall\") {\n          yield {\n            type: \"server_tool_call\" as const,\n            id: event.id,\n            name: event.name,\n            input: event.input,\n          };\n        } else if (event.type === \"server_toolresult\") {\n          yield {\n            type: \"server_tool_result\" as const,\n            toolUseId: event.toolUseId,\n            resultType: event.resultType,\n            data: event.data,\n          };\n        }\n      }\n\n      response = await result.response;\n    } catch (err) {\n      // Context overflow: force-compact via transformContext and retry (up to 3 times)\n      if (\n        overflowRetries < MAX_OVERFLOW_RETRIES &&\n        isContextOverflow(err) &&\n        options.transformContext\n      ) {\n        overflowRetries++;\n        const transformed = await options.transformContext(messages, { force: true });\n        if (transformed !== messages) {\n          messages.length = 0;\n          messages.push(...transformed);\n        }\n        turn--; // Don't count the failed turn\n        continue;\n      }\n      // Overloaded / rate-limited: wait 3s and retry (up to 3 times)\n      if (overloadRetries < MAX_OVERLOAD_RETRIES && isOverloaded(err)) {\n        overloadRetries++;\n        await new Promise((r) => setTimeout(r, OVERLOAD_RETRY_DELAY_MS));\n        turn--; // Don't count the failed turn\n        continue;\n      }\n      throw err;\n    }\n\n    // Reset retry counters after successful call\n    overflowRetries = 0;\n    overloadRetries = 0;\n\n    // Accumulate usage\n    totalUsage.inputTokens += response.usage.inputTokens;\n    totalUsage.outputTokens += response.usage.outputTokens;\n    if (response.usage.cacheRead) {\n      totalUsage.cacheRead = (totalUsage.cacheRead ?? 0) + response.usage.cacheRead;\n    }\n    if (response.usage.cacheWrite) {\n      totalUsage.cacheWrite = (totalUsage.cacheWrite ?? 0) + response.usage.cacheWrite;\n    }\n\n    // Append assistant message to conversation\n    messages.push(response.message);\n\n    yield {\n      type: \"turn_end\" as const,\n      turn,\n      stopReason: response.stopReason,\n      usage: response.usage,\n    };\n\n    // Server-side tool hit iteration limit — re-send to continue.\n    // Do NOT add an extra user message; the API detects the trailing\n    // server_tool_use block and resumes automatically.\n    if (response.stopReason === \"pause_turn\") {\n      consecutivePauses++;\n      if (consecutivePauses >= maxContinuations) {\n        break; // Safety limit — fall through to agent_done below\n      }\n      continue;\n    }\n    consecutivePauses = 0;\n\n    // If not tool_use, we're done\n    if (response.stopReason !== \"tool_use\") {\n      yield {\n        type: \"agent_done\" as const,\n        totalTurns: turn,\n        totalUsage: { ...totalUsage },\n      };\n      return {\n        message: response.message,\n        totalTurns: turn,\n        totalUsage: { ...totalUsage },\n      };\n    }\n\n    // Extract tool calls — separate client-executed from provider built-in (e.g. Moonshot $web_search)\n    const allToolCalls = extractToolCalls(response.message.content);\n    const toolCalls: ToolCall[] = [];\n    const toolResults: ToolResult[] = [];\n\n    for (const tc of allToolCalls) {\n      if (tc.name.startsWith(\"$\")) {\n        // Provider built-in tool (e.g. Moonshot $web_search) — not locally executed.\n        // Still needs a tool_result for the message history round-trip.\n        toolResults.push({\n          type: \"tool_result\",\n          toolCallId: tc.id,\n          content: JSON.stringify(tc.args),\n        });\n      } else {\n        toolCalls.push(tc);\n      }\n    }\n    const eventStream = new EventStream<AgentEvent>();\n\n    // Launch all tool calls in parallel\n    const executions = toolCalls.map(async (toolCall) => {\n      const startTime = Date.now();\n\n      eventStream.push({\n        type: \"tool_call_start\" as const,\n        toolCallId: toolCall.id,\n        name: toolCall.name,\n        args: toolCall.args,\n      });\n\n      let resultContent: string;\n      let details: unknown;\n      let isError = false;\n\n      const tool = toolMap.get(toolCall.name);\n      if (!tool) {\n        resultContent = `Unknown tool: ${toolCall.name}`;\n        isError = true;\n      } else {\n        try {\n          const parsed = tool.parameters.parse(toolCall.args);\n          const ctx: ToolContext = {\n            signal: options.signal ?? AbortSignal.timeout(300_000),\n            toolCallId: toolCall.id,\n            onUpdate: (update: unknown) => {\n              eventStream.push({\n                type: \"tool_call_update\" as const,\n                toolCallId: toolCall.id,\n                update,\n              });\n            },\n          };\n          const raw = await tool.execute(parsed, ctx);\n          const normalized = normalizeToolResult(raw);\n          resultContent = normalized.content;\n          details = normalized.details;\n        } catch (err) {\n          isError = true;\n          resultContent = err instanceof Error ? err.message : String(err);\n        }\n      }\n\n      const durationMs = Date.now() - startTime;\n\n      eventStream.push({\n        type: \"tool_call_end\" as const,\n        toolCallId: toolCall.id,\n        result: resultContent,\n        details,\n        isError,\n        durationMs,\n      });\n\n      return { toolCallId: toolCall.id, content: resultContent, isError };\n    });\n\n    // Abort the tool event stream when the signal fires so Ctrl+C\n    // doesn't hang waiting for long-running tools to finish.\n    const abortHandler = () => eventStream.abort(new Error(\"aborted\"));\n    options.signal?.addEventListener(\"abort\", abortHandler, { once: true });\n\n    // Close event stream when all tools complete.\n    // Track whether the finally block has already consumed toolResults\n    // to prevent the race where .then() mutates toolResults after\n    // messages.push() has already captured the array by reference.\n    let toolResultsFinalized = false;\n\n    Promise.all(executions)\n      .then((results) => {\n        if (toolResultsFinalized) return;\n        for (const tc of toolCalls) {\n          const r = results.find((x) => x.toolCallId === tc.id)!;\n          toolResults.push({\n            type: \"tool_result\",\n            toolCallId: tc.id,\n            content: r.content,\n            isError: r.isError || undefined,\n          });\n        }\n        eventStream.close();\n      })\n      .catch((err) => eventStream.abort(err instanceof Error ? err : new Error(String(err))));\n\n    // Yield events as they arrive from parallel tools\n    try {\n      for await (const event of eventStream) {\n        yield event;\n      }\n    } finally {\n      options.signal?.removeEventListener(\"abort\", abortHandler);\n\n      // Prevent the Promise.all .then() from mutating toolResults after\n      // we finalize and push them into messages.\n      toolResultsFinalized = true;\n\n      // Ensure every tool_use has a matching tool_result, even on abort.\n      // Without this, an aborted turn leaves an orphaned tool_use in the\n      // message history which causes Anthropic API 400 errors on the next\n      // request.\n      for (const tc of toolCalls) {\n        if (!toolResults.some((r) => r.toolCallId === tc.id)) {\n          toolResults.push({\n            type: \"tool_result\",\n            toolCallId: tc.id,\n            content: \"Tool execution was aborted.\",\n            isError: true,\n          });\n        }\n      }\n      messages.push({ role: \"tool\", content: toolResults });\n    }\n  }\n\n  // Exceeded max turns — return last assistant message\n  let lastAssistant: AssistantMessage | undefined;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i]!.role === \"assistant\") {\n      lastAssistant = messages[i] as AssistantMessage;\n      break;\n    }\n  }\n\n  yield {\n    type: \"agent_done\" as const,\n    totalTurns: turn,\n    totalUsage: { ...totalUsage },\n  };\n\n  return {\n    message: lastAssistant ?? { role: \"assistant\" as const, content: [] },\n    totalTurns: turn,\n    totalUsage: { ...totalUsage },\n  };\n}\n\nfunction normalizeToolResult(raw: ToolExecuteResult): StructuredToolResult {\n  return typeof raw === \"string\" ? { content: raw } : raw;\n}\n\nfunction extractToolCalls(content: string | ContentPart[]): ToolCall[] {\n  if (typeof content === \"string\") return [];\n  return content.filter((part): part is ToolCall => part.type === \"tool_call\");\n}\n"],"mappings":"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","names":["import_ai"]}

package/dist/index.d.cts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { StreamOptions, Tool, ServerToolDefinition, Message, StopReason, Usage, AssistantMessage } from '@prestyj/ai';
+
+interface StructuredToolResult {
+    content: string;
+    details?: unknown;
+}
+type ToolExecuteResult = string | StructuredToolResult;
+interface ToolContext {
+    signal: AbortSignal;
+    toolCallId: string;
+    onUpdate?: (update: unknown) => void;
+}
+interface AgentTool<T extends z.ZodType = z.ZodType> extends Tool {
+    parameters: T;
+    execute: (args: z.infer<T>, context: ToolContext) => ToolExecuteResult | Promise<ToolExecuteResult>;
+}
+interface AgentTextDeltaEvent {
+    type: "text_delta";
+    text: string;
+}
+interface AgentThinkingDeltaEvent {
+    type: "thinking_delta";
+    text: string;
+}
+interface AgentToolCallStartEvent {
+    type: "tool_call_start";
+    toolCallId: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+interface AgentToolCallUpdateEvent {
+    type: "tool_call_update";
+    toolCallId: string;
+    update: unknown;
+}
+interface AgentToolCallEndEvent {
+    type: "tool_call_end";
+    toolCallId: string;
+    result: string;
+    details?: unknown;
+    isError: boolean;
+    durationMs: number;
+}
+interface AgentTurnEndEvent {
+    type: "turn_end";
+    turn: number;
+    stopReason: StopReason;
+    usage: Usage;
+}
+interface AgentDoneEvent {
+    type: "agent_done";
+    totalTurns: number;
+    totalUsage: Usage;
+}
+interface AgentErrorEvent {
+    type: "error";
+    error: Error;
+}
+interface AgentServerToolCallEvent {
+    type: "server_tool_call";
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface AgentServerToolResultEvent {
+    type: "server_tool_result";
+    toolUseId: string;
+    resultType: string;
+    data: unknown;
+}
+type AgentEvent = AgentTextDeltaEvent | AgentThinkingDeltaEvent | AgentToolCallStartEvent | AgentToolCallUpdateEvent | AgentToolCallEndEvent | AgentServerToolCallEvent | AgentServerToolResultEvent | AgentTurnEndEvent | AgentDoneEvent | AgentErrorEvent;
+interface AgentOptions {
+    provider: StreamOptions["provider"];
+    model: string;
+    system?: string;
+    tools?: AgentTool[];
+    serverTools?: ServerToolDefinition[];
+    maxTurns?: number;
+    maxTokens?: number;
+    temperature?: number;
+    thinking?: StreamOptions["thinking"];
+    apiKey?: string;
+    baseUrl?: string;
+    signal?: AbortSignal;
+    accountId?: string;
+    cacheRetention?: StreamOptions["cacheRetention"];
+    /** Enable provider-native web search. */
+    webSearch?: boolean;
+    /** Enable server-side compaction (Anthropic only, beta). */
+    compaction?: boolean;
+    /** Max consecutive pause_turn continuations before stopping (default: 5).
+     *  Prevents infinite loops when server-side tools keep pausing. */
+    maxContinuations?: number;
+    /**
+     * Called before each LLM call. Allows the caller to inspect and transform
+     * the messages array (e.g. compaction, truncation). Return the same array
+     * for no-op, or a new array to replace the conversation context.
+     *
+     * When `options.force` is true, the caller should compact unconditionally
+     * (e.g. after a context overflow error from the API).
+     */
+    transformContext?: (messages: Message[], options?: {
+        force?: boolean;
+    }) => Message[] | Promise<Message[]>;
+}
+interface AgentResult {
+    message: AssistantMessage;
+    totalTurns: number;
+    totalUsage: Usage;
+}
+
+/**
+ * Dual-nature result: async iterable for streaming events,
+ * thenable for awaiting the final AgentResult.
+ *
+ * ```ts
+ * // Stream events
+ * for await (const event of agent.prompt("hello")) { ... }
+ *
+ * // Or just await the result
+ * const result = await agent.prompt("hello");
+ * ```
+ */
+declare class AgentStream implements AsyncIterable<AgentEvent> {
+    private events;
+    private resultPromise;
+    private resolveResult;
+    private rejectResult;
+    private hasConsumer;
+    constructor(generator: AsyncGenerator<AgentEvent, AgentResult>, onDone: () => void);
+    private pump;
+    [Symbol.asyncIterator](): AsyncIterator<AgentEvent>;
+    then<TResult1 = AgentResult, TResult2 = never>(onfulfilled?: ((value: AgentResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    private drainEvents;
+}
+declare class Agent {
+    private messages;
+    private _running;
+    private options;
+    constructor(options: AgentOptions);
+    get running(): boolean;
+    prompt(content: string): AgentStream;
+}
+
+/**
+ * Detect context window overflow errors from LLM providers.
+ * Anthropic: "prompt is too long: N tokens > M maximum"
+ * OpenAI:    "context_length_exceeded" / "maximum context length"
+ */
+declare function isContextOverflow(err: unknown): boolean;
+declare function agentLoop(messages: Message[], options: AgentOptions): AsyncGenerator<AgentEvent, AgentResult>;
+
+export { Agent, type AgentDoneEvent, type AgentErrorEvent, type AgentEvent, type AgentOptions, type AgentResult, type AgentServerToolCallEvent, type AgentServerToolResultEvent, AgentStream, type AgentTextDeltaEvent, type AgentThinkingDeltaEvent, type AgentTool, type AgentToolCallEndEvent, type AgentToolCallStartEvent, type AgentToolCallUpdateEvent, type AgentTurnEndEvent, type StructuredToolResult, type ToolContext, type ToolExecuteResult, agentLoop, isContextOverflow };

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { StreamOptions, Tool, ServerToolDefinition, Message, StopReason, Usage, AssistantMessage } from '@prestyj/ai';
+
+interface StructuredToolResult {
+    content: string;
+    details?: unknown;
+}
+type ToolExecuteResult = string | StructuredToolResult;
+interface ToolContext {
+    signal: AbortSignal;
+    toolCallId: string;
+    onUpdate?: (update: unknown) => void;
+}
+interface AgentTool<T extends z.ZodType = z.ZodType> extends Tool {
+    parameters: T;
+    execute: (args: z.infer<T>, context: ToolContext) => ToolExecuteResult | Promise<ToolExecuteResult>;
+}
+interface AgentTextDeltaEvent {
+    type: "text_delta";
+    text: string;
+}
+interface AgentThinkingDeltaEvent {
+    type: "thinking_delta";
+    text: string;
+}
+interface AgentToolCallStartEvent {
+    type: "tool_call_start";
+    toolCallId: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+interface AgentToolCallUpdateEvent {
+    type: "tool_call_update";
+    toolCallId: string;
+    update: unknown;
+}
+interface AgentToolCallEndEvent {
+    type: "tool_call_end";
+    toolCallId: string;
+    result: string;
+    details?: unknown;
+    isError: boolean;
+    durationMs: number;
+}
+interface AgentTurnEndEvent {
+    type: "turn_end";
+    turn: number;
+    stopReason: StopReason;
+    usage: Usage;
+}
+interface AgentDoneEvent {
+    type: "agent_done";
+    totalTurns: number;
+    totalUsage: Usage;
+}
+interface AgentErrorEvent {
+    type: "error";
+    error: Error;
+}
+interface AgentServerToolCallEvent {
+    type: "server_tool_call";
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface AgentServerToolResultEvent {
+    type: "server_tool_result";
+    toolUseId: string;
+    resultType: string;
+    data: unknown;
+}
+type AgentEvent = AgentTextDeltaEvent | AgentThinkingDeltaEvent | AgentToolCallStartEvent | AgentToolCallUpdateEvent | AgentToolCallEndEvent | AgentServerToolCallEvent | AgentServerToolResultEvent | AgentTurnEndEvent | AgentDoneEvent | AgentErrorEvent;
+interface AgentOptions {
+    provider: StreamOptions["provider"];
+    model: string;
+    system?: string;
+    tools?: AgentTool[];
+    serverTools?: ServerToolDefinition[];
+    maxTurns?: number;
+    maxTokens?: number;
+    temperature?: number;
+    thinking?: StreamOptions["thinking"];
+    apiKey?: string;
+    baseUrl?: string;
+    signal?: AbortSignal;
+    accountId?: string;
+    cacheRetention?: StreamOptions["cacheRetention"];
+    /** Enable provider-native web search. */
+    webSearch?: boolean;
+    /** Enable server-side compaction (Anthropic only, beta). */
+    compaction?: boolean;
+    /** Max consecutive pause_turn continuations before stopping (default: 5).
+     *  Prevents infinite loops when server-side tools keep pausing. */
+    maxContinuations?: number;
+    /**
+     * Called before each LLM call. Allows the caller to inspect and transform
+     * the messages array (e.g. compaction, truncation). Return the same array
+     * for no-op, or a new array to replace the conversation context.
+     *
+     * When `options.force` is true, the caller should compact unconditionally
+     * (e.g. after a context overflow error from the API).
+     */
+    transformContext?: (messages: Message[], options?: {
+        force?: boolean;
+    }) => Message[] | Promise<Message[]>;
+}
+interface AgentResult {
+    message: AssistantMessage;
+    totalTurns: number;
+    totalUsage: Usage;
+}
+
+/**
+ * Dual-nature result: async iterable for streaming events,
+ * thenable for awaiting the final AgentResult.
+ *
+ * ```ts
+ * // Stream events
+ * for await (const event of agent.prompt("hello")) { ... }
+ *
+ * // Or just await the result
+ * const result = await agent.prompt("hello");
+ * ```
+ */
+declare class AgentStream implements AsyncIterable<AgentEvent> {
+    private events;
+    private resultPromise;
+    private resolveResult;
+    private rejectResult;
+    private hasConsumer;
+    constructor(generator: AsyncGenerator<AgentEvent, AgentResult>, onDone: () => void);
+    private pump;
+    [Symbol.asyncIterator](): AsyncIterator<AgentEvent>;
+    then<TResult1 = AgentResult, TResult2 = never>(onfulfilled?: ((value: AgentResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    private drainEvents;
+}
+declare class Agent {
+    private messages;
+    private _running;
+    private options;
+    constructor(options: AgentOptions);
+    get running(): boolean;
+    prompt(content: string): AgentStream;
+}
+
+/**
+ * Detect context window overflow errors from LLM providers.
+ * Anthropic: "prompt is too long: N tokens > M maximum"
+ * OpenAI:    "context_length_exceeded" / "maximum context length"
+ */
+declare function isContextOverflow(err: unknown): boolean;
+declare function agentLoop(messages: Message[], options: AgentOptions): AsyncGenerator<AgentEvent, AgentResult>;
+
+export { Agent, type AgentDoneEvent, type AgentErrorEvent, type AgentEvent, type AgentOptions, type AgentResult, type AgentServerToolCallEvent, type AgentServerToolResultEvent, AgentStream, type AgentTextDeltaEvent, type AgentThinkingDeltaEvent, type AgentTool, type AgentToolCallEndEvent, type AgentToolCallStartEvent, type AgentToolCallUpdateEvent, type AgentTurnEndEvent, type StructuredToolResult, type ToolContext, type ToolExecuteResult, agentLoop, isContextOverflow };

package/dist/index.js

@@ -0,0 +1,349 @@
+// src/agent.ts
+import { EventStream as EventStream2 } from "@prestyj/ai";
+
+// src/agent-loop.ts
+import {
+  stream,
+  EventStream
+} from "@prestyj/ai";
+var DEFAULT_MAX_TURNS = 100;
+function isContextOverflow(err) {
+  if (!(err instanceof Error)) return false;
+  const msg = err.message.toLowerCase();
+  return msg.includes("prompt is too long") || msg.includes("context_length_exceeded") || msg.includes("maximum context length") || msg.includes("token") && msg.includes("exceed");
+}
+function isOverloaded(err) {
+  if (!(err instanceof Error)) return false;
+  const msg = err.message.toLowerCase();
+  if (msg.includes("insufficient balance") || msg.includes("quota exceeded") || msg.includes("billing")) {
+    return false;
+  }
+  return msg.includes("overloaded") || msg.includes("rate limit") || msg.includes("too many requests") || msg.includes("429") || msg.includes("529");
+}
+async function* agentLoop(messages, options) {
+  const maxTurns = options.maxTurns ?? DEFAULT_MAX_TURNS;
+  const maxContinuations = options.maxContinuations ?? 5;
+  const toolMap = new Map((options.tools ?? []).map((t) => [t.name, t]));
+  const totalUsage = { inputTokens: 0, outputTokens: 0 };
+  let turn = 0;
+  let consecutivePauses = 0;
+  let overflowRetries = 0;
+  let overloadRetries = 0;
+  const MAX_OVERFLOW_RETRIES = 3;
+  const MAX_OVERLOAD_RETRIES = 3;
+  const OVERLOAD_RETRY_DELAY_MS = 3e3;
+  while (turn < maxTurns) {
+    options.signal?.throwIfAborted();
+    turn++;
+    if (options.transformContext) {
+      const transformed = await options.transformContext(messages);
+      if (transformed !== messages) {
+        messages.length = 0;
+        messages.push(...transformed);
+      }
+    }
+    let response;
+    try {
+      const result = stream({
+        provider: options.provider,
+        model: options.model,
+        messages,
+        tools: options.tools,
+        serverTools: options.serverTools,
+        webSearch: options.webSearch,
+        maxTokens: options.maxTokens,
+        temperature: options.temperature,
+        thinking: options.thinking,
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        signal: options.signal,
+        accountId: options.accountId,
+        cacheRetention: options.cacheRetention,
+        compaction: options.compaction
+      });
+      result.response.catch(() => {
+      });
+      for await (const event of result) {
+        if (event.type === "text_delta") {
+          yield { type: "text_delta", text: event.text };
+        } else if (event.type === "thinking_delta") {
+          yield { type: "thinking_delta", text: event.text };
+        } else if (event.type === "server_toolcall") {
+          yield {
+            type: "server_tool_call",
+            id: event.id,
+            name: event.name,
+            input: event.input
+          };
+        } else if (event.type === "server_toolresult") {
+          yield {
+            type: "server_tool_result",
+            toolUseId: event.toolUseId,
+            resultType: event.resultType,
+            data: event.data
+          };
+        }
+      }
+      response = await result.response;
+    } catch (err) {
+      if (overflowRetries < MAX_OVERFLOW_RETRIES && isContextOverflow(err) && options.transformContext) {
+        overflowRetries++;
+        const transformed = await options.transformContext(messages, { force: true });
+        if (transformed !== messages) {
+          messages.length = 0;
+          messages.push(...transformed);
+        }
+        turn--;
+        continue;
+      }
+      if (overloadRetries < MAX_OVERLOAD_RETRIES && isOverloaded(err)) {
+        overloadRetries++;
+        await new Promise((r) => setTimeout(r, OVERLOAD_RETRY_DELAY_MS));
+        turn--;
+        continue;
+      }
+      throw err;
+    }
+    overflowRetries = 0;
+    overloadRetries = 0;
+    totalUsage.inputTokens += response.usage.inputTokens;
+    totalUsage.outputTokens += response.usage.outputTokens;
+    if (response.usage.cacheRead) {
+      totalUsage.cacheRead = (totalUsage.cacheRead ?? 0) + response.usage.cacheRead;
+    }
+    if (response.usage.cacheWrite) {
+      totalUsage.cacheWrite = (totalUsage.cacheWrite ?? 0) + response.usage.cacheWrite;
+    }
+    messages.push(response.message);
+    yield {
+      type: "turn_end",
+      turn,
+      stopReason: response.stopReason,
+      usage: response.usage
+    };
+    if (response.stopReason === "pause_turn") {
+      consecutivePauses++;
+      if (consecutivePauses >= maxContinuations) {
+        break;
+      }
+      continue;
+    }
+    consecutivePauses = 0;
+    if (response.stopReason !== "tool_use") {
+      yield {
+        type: "agent_done",
+        totalTurns: turn,
+        totalUsage: { ...totalUsage }
+      };
+      return {
+        message: response.message,
+        totalTurns: turn,
+        totalUsage: { ...totalUsage }
+      };
+    }
+    const allToolCalls = extractToolCalls(response.message.content);
+    const toolCalls = [];
+    const toolResults = [];
+    for (const tc of allToolCalls) {
+      if (tc.name.startsWith("$")) {
+        toolResults.push({
+          type: "tool_result",
+          toolCallId: tc.id,
+          content: JSON.stringify(tc.args)
+        });
+      } else {
+        toolCalls.push(tc);
+      }
+    }
+    const eventStream = new EventStream();
+    const executions = toolCalls.map(async (toolCall) => {
+      const startTime = Date.now();
+      eventStream.push({
+        type: "tool_call_start",
+        toolCallId: toolCall.id,
+        name: toolCall.name,
+        args: toolCall.args
+      });
+      let resultContent;
+      let details;
+      let isError = false;
+      const tool = toolMap.get(toolCall.name);
+      if (!tool) {
+        resultContent = `Unknown tool: ${toolCall.name}`;
+        isError = true;
+      } else {
+        try {
+          const parsed = tool.parameters.parse(toolCall.args);
+          const ctx = {
+            signal: options.signal ?? AbortSignal.timeout(3e5),
+            toolCallId: toolCall.id,
+            onUpdate: (update) => {
+              eventStream.push({
+                type: "tool_call_update",
+                toolCallId: toolCall.id,
+                update
+              });
+            }
+          };
+          const raw = await tool.execute(parsed, ctx);
+          const normalized = normalizeToolResult(raw);
+          resultContent = normalized.content;
+          details = normalized.details;
+        } catch (err) {
+          isError = true;
+          resultContent = err instanceof Error ? err.message : String(err);
+        }
+      }
+      const durationMs = Date.now() - startTime;
+      eventStream.push({
+        type: "tool_call_end",
+        toolCallId: toolCall.id,
+        result: resultContent,
+        details,
+        isError,
+        durationMs
+      });
+      return { toolCallId: toolCall.id, content: resultContent, isError };
+    });
+    const abortHandler = () => eventStream.abort(new Error("aborted"));
+    options.signal?.addEventListener("abort", abortHandler, { once: true });
+    let toolResultsFinalized = false;
+    Promise.all(executions).then((results) => {
+      if (toolResultsFinalized) return;
+      for (const tc of toolCalls) {
+        const r = results.find((x) => x.toolCallId === tc.id);
+        toolResults.push({
+          type: "tool_result",
+          toolCallId: tc.id,
+          content: r.content,
+          isError: r.isError || void 0
+        });
+      }
+      eventStream.close();
+    }).catch((err) => eventStream.abort(err instanceof Error ? err : new Error(String(err))));
+    try {
+      for await (const event of eventStream) {
+        yield event;
+      }
+    } finally {
+      options.signal?.removeEventListener("abort", abortHandler);
+      toolResultsFinalized = true;
+      for (const tc of toolCalls) {
+        if (!toolResults.some((r) => r.toolCallId === tc.id)) {
+          toolResults.push({
+            type: "tool_result",
+            toolCallId: tc.id,
+            content: "Tool execution was aborted.",
+            isError: true
+          });
+        }
+      }
+      messages.push({ role: "tool", content: toolResults });
+    }
+  }
+  let lastAssistant;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    if (messages[i].role === "assistant") {
+      lastAssistant = messages[i];
+      break;
+    }
+  }
+  yield {
+    type: "agent_done",
+    totalTurns: turn,
+    totalUsage: { ...totalUsage }
+  };
+  return {
+    message: lastAssistant ?? { role: "assistant", content: [] },
+    totalTurns: turn,
+    totalUsage: { ...totalUsage }
+  };
+}
+function normalizeToolResult(raw) {
+  return typeof raw === "string" ? { content: raw } : raw;
+}
+function extractToolCalls(content) {
+  if (typeof content === "string") return [];
+  return content.filter((part) => part.type === "tool_call");
+}
+
+// src/agent.ts
+var AgentStream = class {
+  events;
+  resultPromise;
+  resolveResult;
+  rejectResult;
+  hasConsumer = false;
+  constructor(generator, onDone) {
+    this.events = new EventStream2();
+    this.resultPromise = new Promise((resolve, reject) => {
+      this.resolveResult = resolve;
+      this.rejectResult = reject;
+    });
+    this.pump(generator, onDone);
+  }
+  async pump(generator, onDone) {
+    try {
+      let next = await generator.next();
+      while (!next.done) {
+        this.events.push(next.value);
+        next = await generator.next();
+      }
+      this.events.close();
+      this.resolveResult(next.value);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.events.abort(error);
+      this.rejectResult(error);
+    } finally {
+      onDone();
+    }
+  }
+  [Symbol.asyncIterator]() {
+    this.hasConsumer = true;
+    return this.events[Symbol.asyncIterator]();
+  }
+  then(onfulfilled, onrejected) {
+    this.drainEvents().catch(() => {
+    });
+    return this.resultPromise.then(onfulfilled, onrejected);
+  }
+  async drainEvents() {
+    if (this.hasConsumer) return;
+    this.hasConsumer = true;
+    for await (const _ of this.events) {
+    }
+  }
+};
+var Agent = class {
+  messages = [];
+  _running = false;
+  options;
+  constructor(options) {
+    this.options = options;
+    if (options.system) {
+      this.messages.push({ role: "system", content: options.system });
+    }
+  }
+  get running() {
+    return this._running;
+  }
+  prompt(content) {
+    if (this._running) {
+      throw new Error("Agent is already running");
+    }
+    this._running = true;
+    this.messages.push({ role: "user", content });
+    const generator = agentLoop(this.messages, this.options);
+    return new AgentStream(generator, () => {
+      this._running = false;
+    });
+  }
+};
+export {
+  Agent,
+  AgentStream,
+  agentLoop,
+  isContextOverflow
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent.ts","../src/agent-loop.ts"],"sourcesContent":["import { EventStream, type Message } from \"@prestyj/ai\";\nimport { agentLoop } from \"./agent-loop.js\";\nimport type { AgentEvent, AgentOptions, AgentResult } from \"./types.js\";\n\n// ── AgentStream ─────────────────────────────────────────────\n\n/**\n * Dual-nature result: async iterable for streaming events,\n * thenable for awaiting the final AgentResult.\n *\n * ```ts\n * // Stream events\n * for await (const event of agent.prompt(\"hello\")) { ... }\n *\n * // Or just await the result\n * const result = await agent.prompt(\"hello\");\n * ```\n */\nexport class AgentStream implements AsyncIterable<AgentEvent> {\n  private events: EventStream<AgentEvent>;\n  private resultPromise: Promise<AgentResult>;\n  private resolveResult!: (r: AgentResult) => void;\n  private rejectResult!: (e: Error) => void;\n  private hasConsumer = false;\n\n  constructor(generator: AsyncGenerator<AgentEvent, AgentResult>, onDone: () => void) {\n    this.events = new EventStream<AgentEvent>();\n    this.resultPromise = new Promise<AgentResult>((resolve, reject) => {\n      this.resolveResult = resolve;\n      this.rejectResult = reject;\n    });\n    this.pump(generator, onDone);\n  }\n\n  private async pump(\n    generator: AsyncGenerator<AgentEvent, AgentResult>,\n    onDone: () => void,\n  ): Promise<void> {\n    try {\n      let next = await generator.next();\n      while (!next.done) {\n        this.events.push(next.value);\n        next = await generator.next();\n      }\n      this.events.close();\n      this.resolveResult(next.value);\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      this.events.abort(error);\n      this.rejectResult(error);\n    } finally {\n      onDone();\n    }\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<AgentEvent> {\n    this.hasConsumer = true;\n    return this.events[Symbol.asyncIterator]();\n  }\n\n  then<TResult1 = AgentResult, TResult2 = never>(\n    onfulfilled?: ((value: AgentResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): Promise<TResult1 | TResult2> {\n    this.drainEvents().catch(() => {});\n    return this.resultPromise.then(onfulfilled, onrejected);\n  }\n\n  private async drainEvents(): Promise<void> {\n    if (this.hasConsumer) return;\n    this.hasConsumer = true;\n    for await (const _ of this.events) {\n      // consume silently\n    }\n  }\n}\n\n// ── Agent ───────────────────────────────────────────────────\n\nexport class Agent {\n  private messages: Message[] = [];\n  private _running = false;\n  private options: AgentOptions;\n\n  constructor(options: AgentOptions) {\n    this.options = options;\n    if (options.system) {\n      this.messages.push({ role: \"system\", content: options.system });\n    }\n  }\n\n  get running(): boolean {\n    return this._running;\n  }\n\n  prompt(content: string): AgentStream {\n    if (this._running) {\n      throw new Error(\"Agent is already running\");\n    }\n    this._running = true;\n\n    this.messages.push({ role: \"user\", content });\n\n    const generator = agentLoop(this.messages, this.options);\n    return new AgentStream(generator, () => {\n      this._running = false;\n    });\n  }\n}\n","import {\n  stream,\n  EventStream,\n  type Message,\n  type ToolCall,\n  type ToolResult,\n  type Usage,\n  type ContentPart,\n  type AssistantMessage,\n} from \"@prestyj/ai\";\nimport type {\n  AgentEvent,\n  AgentOptions,\n  AgentResult,\n  AgentTool,\n  ToolContext,\n  ToolExecuteResult,\n  StructuredToolResult,\n} from \"./types.js\";\n\nconst DEFAULT_MAX_TURNS = 100;\n\n/**\n * Detect context window overflow errors from LLM providers.\n * Anthropic: \"prompt is too long: N tokens > M maximum\"\n * OpenAI:    \"context_length_exceeded\" / \"maximum context length\"\n */\nexport function isContextOverflow(err: unknown): boolean {\n  if (!(err instanceof Error)) return false;\n  const msg = err.message.toLowerCase();\n  return (\n    msg.includes(\"prompt is too long\") ||\n    msg.includes(\"context_length_exceeded\") ||\n    msg.includes(\"maximum context length\") ||\n    (msg.includes(\"token\") && msg.includes(\"exceed\"))\n  );\n}\n\n/**\n * Detect overloaded/rate-limit errors from LLM providers.\n * HTTP 429 (rate limit) or 529/503 (overloaded).\n */\nexport function isOverloaded(err: unknown): boolean {\n  if (!(err instanceof Error)) return false;\n  const msg = err.message.toLowerCase();\n  // Billing/balance errors often come as 429 but should not be retried\n  if (\n    msg.includes(\"insufficient balance\") ||\n    msg.includes(\"quota exceeded\") ||\n    msg.includes(\"billing\")\n  ) {\n    return false;\n  }\n  return (\n    msg.includes(\"overloaded\") ||\n    msg.includes(\"rate limit\") ||\n    msg.includes(\"too many requests\") ||\n    msg.includes(\"429\") ||\n    msg.includes(\"529\")\n  );\n}\n\nexport async function* agentLoop(\n  messages: Message[],\n  options: AgentOptions,\n): AsyncGenerator<AgentEvent, AgentResult> {\n  const maxTurns = options.maxTurns ?? DEFAULT_MAX_TURNS;\n  const maxContinuations = options.maxContinuations ?? 5;\n  const toolMap = new Map<string, AgentTool>((options.tools ?? []).map((t) => [t.name, t]));\n\n  const totalUsage: Usage = { inputTokens: 0, outputTokens: 0 };\n  let turn = 0;\n  let consecutivePauses = 0;\n  let overflowRetries = 0;\n  let overloadRetries = 0;\n  const MAX_OVERFLOW_RETRIES = 3;\n  const MAX_OVERLOAD_RETRIES = 3;\n  const OVERLOAD_RETRY_DELAY_MS = 3_000;\n\n  while (turn < maxTurns) {\n    options.signal?.throwIfAborted();\n    turn++;\n\n    // ── Mid-loop context transform (compaction / truncation) ──\n    if (options.transformContext) {\n      const transformed = await options.transformContext(messages);\n      if (transformed !== messages) {\n        messages.length = 0;\n        messages.push(...transformed);\n      }\n    }\n\n    // ── Call LLM with overflow recovery ──\n    let response;\n    try {\n      const result = stream({\n        provider: options.provider,\n        model: options.model,\n        messages,\n        tools: options.tools,\n        serverTools: options.serverTools,\n        webSearch: options.webSearch,\n        maxTokens: options.maxTokens,\n        temperature: options.temperature,\n        thinking: options.thinking,\n        apiKey: options.apiKey,\n        baseUrl: options.baseUrl,\n        signal: options.signal,\n        accountId: options.accountId,\n        cacheRetention: options.cacheRetention,\n        compaction: options.compaction,\n      });\n\n      // Suppress unhandled rejection if the iterator path throws first\n      result.response.catch(() => {});\n\n      // Forward streaming deltas\n      for await (const event of result) {\n        if (event.type === \"text_delta\") {\n          yield { type: \"text_delta\" as const, text: event.text };\n        } else if (event.type === \"thinking_delta\") {\n          yield { type: \"thinking_delta\" as const, text: event.text };\n        } else if (event.type === \"server_toolcall\") {\n          yield {\n            type: \"server_tool_call\" as const,\n            id: event.id,\n            name: event.name,\n            input: event.input,\n          };\n        } else if (event.type === \"server_toolresult\") {\n          yield {\n            type: \"server_tool_result\" as const,\n            toolUseId: event.toolUseId,\n            resultType: event.resultType,\n            data: event.data,\n          };\n        }\n      }\n\n      response = await result.response;\n    } catch (err) {\n      // Context overflow: force-compact via transformContext and retry (up to 3 times)\n      if (\n        overflowRetries < MAX_OVERFLOW_RETRIES &&\n        isContextOverflow(err) &&\n        options.transformContext\n      ) {\n        overflowRetries++;\n        const transformed = await options.transformContext(messages, { force: true });\n        if (transformed !== messages) {\n          messages.length = 0;\n          messages.push(...transformed);\n        }\n        turn--; // Don't count the failed turn\n        continue;\n      }\n      // Overloaded / rate-limited: wait 3s and retry (up to 3 times)\n      if (overloadRetries < MAX_OVERLOAD_RETRIES && isOverloaded(err)) {\n        overloadRetries++;\n        await new Promise((r) => setTimeout(r, OVERLOAD_RETRY_DELAY_MS));\n        turn--; // Don't count the failed turn\n        continue;\n      }\n      throw err;\n    }\n\n    // Reset retry counters after successful call\n    overflowRetries = 0;\n    overloadRetries = 0;\n\n    // Accumulate usage\n    totalUsage.inputTokens += response.usage.inputTokens;\n    totalUsage.outputTokens += response.usage.outputTokens;\n    if (response.usage.cacheRead) {\n      totalUsage.cacheRead = (totalUsage.cacheRead ?? 0) + response.usage.cacheRead;\n    }\n    if (response.usage.cacheWrite) {\n      totalUsage.cacheWrite = (totalUsage.cacheWrite ?? 0) + response.usage.cacheWrite;\n    }\n\n    // Append assistant message to conversation\n    messages.push(response.message);\n\n    yield {\n      type: \"turn_end\" as const,\n      turn,\n      stopReason: response.stopReason,\n      usage: response.usage,\n    };\n\n    // Server-side tool hit iteration limit — re-send to continue.\n    // Do NOT add an extra user message; the API detects the trailing\n    // server_tool_use block and resumes automatically.\n    if (response.stopReason === \"pause_turn\") {\n      consecutivePauses++;\n      if (consecutivePauses >= maxContinuations) {\n        break; // Safety limit — fall through to agent_done below\n      }\n      continue;\n    }\n    consecutivePauses = 0;\n\n    // If not tool_use, we're done\n    if (response.stopReason !== \"tool_use\") {\n      yield {\n        type: \"agent_done\" as const,\n        totalTurns: turn,\n        totalUsage: { ...totalUsage },\n      };\n      return {\n        message: response.message,\n        totalTurns: turn,\n        totalUsage: { ...totalUsage },\n      };\n    }\n\n    // Extract tool calls — separate client-executed from provider built-in (e.g. Moonshot $web_search)\n    const allToolCalls = extractToolCalls(response.message.content);\n    const toolCalls: ToolCall[] = [];\n    const toolResults: ToolResult[] = [];\n\n    for (const tc of allToolCalls) {\n      if (tc.name.startsWith(\"$\")) {\n        // Provider built-in tool (e.g. Moonshot $web_search) — not locally executed.\n        // Still needs a tool_result for the message history round-trip.\n        toolResults.push({\n          type: \"tool_result\",\n          toolCallId: tc.id,\n          content: JSON.stringify(tc.args),\n        });\n      } else {\n        toolCalls.push(tc);\n      }\n    }\n    const eventStream = new EventStream<AgentEvent>();\n\n    // Launch all tool calls in parallel\n    const executions = toolCalls.map(async (toolCall) => {\n      const startTime = Date.now();\n\n      eventStream.push({\n        type: \"tool_call_start\" as const,\n        toolCallId: toolCall.id,\n        name: toolCall.name,\n        args: toolCall.args,\n      });\n\n      let resultContent: string;\n      let details: unknown;\n      let isError = false;\n\n      const tool = toolMap.get(toolCall.name);\n      if (!tool) {\n        resultContent = `Unknown tool: ${toolCall.name}`;\n        isError = true;\n      } else {\n        try {\n          const parsed = tool.parameters.parse(toolCall.args);\n          const ctx: ToolContext = {\n            signal: options.signal ?? AbortSignal.timeout(300_000),\n            toolCallId: toolCall.id,\n            onUpdate: (update: unknown) => {\n              eventStream.push({\n                type: \"tool_call_update\" as const,\n                toolCallId: toolCall.id,\n                update,\n              });\n            },\n          };\n          const raw = await tool.execute(parsed, ctx);\n          const normalized = normalizeToolResult(raw);\n          resultContent = normalized.content;\n          details = normalized.details;\n        } catch (err) {\n          isError = true;\n          resultContent = err instanceof Error ? err.message : String(err);\n        }\n      }\n\n      const durationMs = Date.now() - startTime;\n\n      eventStream.push({\n        type: \"tool_call_end\" as const,\n        toolCallId: toolCall.id,\n        result: resultContent,\n        details,\n        isError,\n        durationMs,\n      });\n\n      return { toolCallId: toolCall.id, content: resultContent, isError };\n    });\n\n    // Abort the tool event stream when the signal fires so Ctrl+C\n    // doesn't hang waiting for long-running tools to finish.\n    const abortHandler = () => eventStream.abort(new Error(\"aborted\"));\n    options.signal?.addEventListener(\"abort\", abortHandler, { once: true });\n\n    // Close event stream when all tools complete.\n    // Track whether the finally block has already consumed toolResults\n    // to prevent the race where .then() mutates toolResults after\n    // messages.push() has already captured the array by reference.\n    let toolResultsFinalized = false;\n\n    Promise.all(executions)\n      .then((results) => {\n        if (toolResultsFinalized) return;\n        for (const tc of toolCalls) {\n          const r = results.find((x) => x.toolCallId === tc.id)!;\n          toolResults.push({\n            type: \"tool_result\",\n            toolCallId: tc.id,\n            content: r.content,\n            isError: r.isError || undefined,\n          });\n        }\n        eventStream.close();\n      })\n      .catch((err) => eventStream.abort(err instanceof Error ? err : new Error(String(err))));\n\n    // Yield events as they arrive from parallel tools\n    try {\n      for await (const event of eventStream) {\n        yield event;\n      }\n    } finally {\n      options.signal?.removeEventListener(\"abort\", abortHandler);\n\n      // Prevent the Promise.all .then() from mutating toolResults after\n      // we finalize and push them into messages.\n      toolResultsFinalized = true;\n\n      // Ensure every tool_use has a matching tool_result, even on abort.\n      // Without this, an aborted turn leaves an orphaned tool_use in the\n      // message history which causes Anthropic API 400 errors on the next\n      // request.\n      for (const tc of toolCalls) {\n        if (!toolResults.some((r) => r.toolCallId === tc.id)) {\n          toolResults.push({\n            type: \"tool_result\",\n            toolCallId: tc.id,\n            content: \"Tool execution was aborted.\",\n            isError: true,\n          });\n        }\n      }\n      messages.push({ role: \"tool\", content: toolResults });\n    }\n  }\n\n  // Exceeded max turns — return last assistant message\n  let lastAssistant: AssistantMessage | undefined;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i]!.role === \"assistant\") {\n      lastAssistant = messages[i] as AssistantMessage;\n      break;\n    }\n  }\n\n  yield {\n    type: \"agent_done\" as const,\n    totalTurns: turn,\n    totalUsage: { ...totalUsage },\n  };\n\n  return {\n    message: lastAssistant ?? { role: \"assistant\" as const, content: [] },\n    totalTurns: turn,\n    totalUsage: { ...totalUsage },\n  };\n}\n\nfunction normalizeToolResult(raw: ToolExecuteResult): StructuredToolResult {\n  return typeof raw === \"string\" ? { content: raw } : raw;\n}\n\nfunction extractToolCalls(content: string | ContentPart[]): ToolCall[] {\n  if (typeof content === \"string\") return [];\n  return content.filter((part): part is ToolCall => part.type === \"tool_call\");\n}\n"],"mappings":"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","names":["EventStream","EventStream"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@prestyj/agent",
+  "version": "4.2.15",
+  "type": "module",
+  "description": "Agentic loop system with tool execution for LLMs",
+  "license": "MIT",
+  "author": "Nolan Grout",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ezcoder/ezcoder.git",
+    "directory": "packages/agent"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@prestyj/ai": "4.2.15"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check": "tsc --noEmit"
+  }
+}