@kenkaiiii/gg-agent 4.2.2 → 4.2.3

package/dist/index.cjs

@@ -0,0 +1,370 @@
+"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_gg_ai2 = require("@kenkaiiii/gg-ai");
+
+// src/agent-loop.ts
+var import_gg_ai = require("@kenkaiiii/gg-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();
+  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_gg_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_gg_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 });
+    Promise.all(executions).then((results) => {
+      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);
+      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_gg_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 \"@kenkaiiii/gg-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 \"@kenkaiiii/gg-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  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    Promise.all(executions)\n      .then((results) => {\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      // 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_gg_ai"]}

package/dist/index.d.cts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { StreamOptions, Tool, ServerToolDefinition, Message, StopReason, Usage, AssistantMessage } from '@kenkaiiii/gg-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 };