@vedangiitb/qwintly-core 1.0.2

package/README.md

@@ -0,0 +1,8 @@
+# qwintly-core
+
+A shared package consisting of 
+1. Shared AI tools
+2. Project indexer
+3. Status logging
+
+These components are used in qwintly website generator project

package/dist/ai/ai.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/ai/ai.ts"],"names":[],"mappings":""}

package/dist/ai/ai.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai.js.map

package/dist/ai/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/ai/ai.ts"],"names":[],"mappings":"","sourcesContent":[""]}

package/dist/ai/generate/gemini.client.d.ts

@@ -0,0 +1,15 @@
+import { FunctionCallingConfigMode, GoogleGenAI, Tool } from "@google/genai";
+import type { ZodSchema } from "zod";
+type AIResponseOptions = {
+    tools?: Tool[];
+    schema?: ZodSchema;
+    toolCallingMode?: FunctionCallingConfigMode;
+};
+export declare class GenerateGeminiReponse {
+    gemini: GoogleGenAI;
+    model: string;
+    constructor(geminiApiKey: string, model?: string);
+    aiResponse(request: unknown, options?: AIResponseOptions): Promise<import("@google/genai").GenerateContentResponse>;
+}
+export {};
+//# sourceMappingURL=gemini.client.d.ts.map

package/dist/ai/generate/gemini.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.client.d.ts","sourceRoot":"","sources":["../../../src/ai/generate/gemini.client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EAEzB,WAAW,EACX,IAAI,EACL,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAKrC,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C,CAAC;AAEF,qBAAa,qBAAqB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAiB;gBAEzB,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAOnC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB;CAmC1E"}

package/dist/ai/generate/gemini.client.js

@@ -0,0 +1,39 @@
+import { FunctionCallingConfigMode, GoogleGenAI, } from "@google/genai";
+import { zodToJsonSchema } from "zod-to-json-schema";
+const DEFAULT_MODEL = "gemini-2.5-flash-lite";
+export class GenerateGeminiReponse {
+    constructor(geminiApiKey, model) {
+        this.model = DEFAULT_MODEL;
+        this.gemini = new GoogleGenAI({ apiKey: geminiApiKey });
+        if (model) {
+            this.model = model;
+        }
+    }
+    async aiResponse(request, options = {}) {
+        const { tools, schema, toolCallingMode = FunctionCallingConfigMode.AUTO, } = options;
+        const config = {};
+        if (tools && tools.length > 0) {
+            config.tools = tools;
+            config.toolConfig = {
+                functionCallingConfig: {
+                    mode: toolCallingMode,
+                },
+            };
+        }
+        if (schema) {
+            config.responseMimeType = "application/json";
+            config.responseJsonSchema = zodToJsonSchema(schema);
+        }
+        try {
+            return await this.gemini.models.generateContent({
+                model: this.model,
+                contents: request,
+                ...(Object.keys(config).length > 0 && { config }),
+            });
+        }
+        catch (err) {
+            throw new Error(`AI generation failed: ${err?.message || "Unknown error"}`);
+        }
+    }
+}
+//# sourceMappingURL=gemini.client.js.map

package/dist/ai/generate/gemini.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.client.js","sourceRoot":"","sources":["../../../src/ai/generate/gemini.client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EAEzB,WAAW,GAEZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAQ9C,MAAM,OAAO,qBAAqB;IAIhC,YAAY,YAAoB,EAAE,KAAc;QAFzC,UAAK,GAAW,aAAa,CAAC;QAGnC,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,UAA6B,EAAE;QACvE,MAAM,EACJ,KAAK,EACL,MAAM,EACN,eAAe,GAAG,yBAAyB,CAAC,IAAI,GACjD,GAAG,OAAO,CAAC;QAEZ,MAAM,MAAM,GAA0B,EAAE,CAAC;QAEzC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YACrB,MAAM,CAAC,UAAU,GAAG;gBAClB,qBAAqB,EAAE;oBACrB,IAAI,EAAE,eAAe;iBACtB;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,gBAAgB,GAAG,kBAAkB,CAAC;YAC7C,MAAM,CAAC,kBAAkB,GAAG,eAAe,CAAC,MAAa,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;gBAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,OAAc;gBACxB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,EAAE,OAAO,IAAI,eAAe,EAAE,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\n  FunctionCallingConfigMode,\n  GenerateContentConfig,\n  GoogleGenAI,\n  Tool,\n} from \"@google/genai\";\nimport type { ZodSchema } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\n\nconst DEFAULT_MODEL = \"gemini-2.5-flash-lite\";\n\ntype AIResponseOptions = {\n  tools?: Tool[];\n  schema?: ZodSchema;\n  toolCallingMode?: FunctionCallingConfigMode;\n};\n\nexport class GenerateGeminiReponse {\n  public gemini: GoogleGenAI;\n  public model: string = DEFAULT_MODEL;\n\n  constructor(geminiApiKey: string, model?: string) {\n    this.gemini = new GoogleGenAI({ apiKey: geminiApiKey });\n    if (model) {\n      this.model = model;\n    }\n  }\n\n  public async aiResponse(request: unknown, options: AIResponseOptions = {}) {\n    const {\n      tools,\n      schema,\n      toolCallingMode = FunctionCallingConfigMode.AUTO,\n    } = options;\n\n    const config: GenerateContentConfig = {};\n\n    if (tools && tools.length > 0) {\n      config.tools = tools;\n      config.toolConfig = {\n        functionCallingConfig: {\n          mode: toolCallingMode,\n        },\n      };\n    }\n\n    if (schema) {\n      config.responseMimeType = \"application/json\";\n      config.responseJsonSchema = zodToJsonSchema(schema as any);\n    }\n\n    try {\n      return await this.gemini.models.generateContent({\n        model: this.model,\n        contents: request as any,\n        ...(Object.keys(config).length > 0 && { config }),\n      });\n    } catch (err: any) {\n      throw new Error(\n        `AI generation failed: ${err?.message || \"Unknown error\"}`,\n      );\n    }\n  }\n}\n"]}

package/dist/ai/generate/generateClient.d.ts

@@ -0,0 +1,3 @@
+import { GenerateGeminiReponse } from "./gemini.client.js";
+export declare const getClient: (provider: string, apiKey: string, model?: string) => GenerateGeminiReponse;
+//# sourceMappingURL=generateClient.d.ts.map

package/dist/ai/generate/generateClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateClient.d.ts","sourceRoot":"","sources":["../../../src/ai/generate/generateClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,QAAQ,MAAM,0BAMf,CAAC"}

package/dist/ai/generate/generateClient.js

@@ -0,0 +1,8 @@
+import { GenerateGeminiReponse } from "./gemini.client.js";
+export const getClient = (provider, apiKey, model) => {
+    if (provider === "gemini") {
+        return new GenerateGeminiReponse(apiKey, model);
+    }
+    throw new Error(`Unknown provider: ${provider}`);
+};
+//# sourceMappingURL=generateClient.js.map

package/dist/ai/generate/generateClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateClient.js","sourceRoot":"","sources":["../../../src/ai/generate/generateClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAgB,EAChB,MAAc,EACd,KAAc,EACd,EAAE;IACF,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC","sourcesContent":["import { GenerateGeminiReponse } from \"./gemini.client.js\";\r\n\r\nexport const getClient = (\r\n  provider: string,\r\n  apiKey: string,\r\n  model?: string,\r\n) => {\r\n  if (provider === \"gemini\") {\r\n    return new GenerateGeminiReponse(apiKey, model);\r\n  }\r\n  throw new Error(`Unknown provider: ${provider}`);\r\n};\r\n"]}

package/dist/ai/toolLoop/toolLoopContext.d.ts

@@ -0,0 +1,33 @@
+export type ToolEvent = {
+    name: string;
+    summary: string;
+};
+export type ToolLoopContextPolicy = {
+    readFileDefaultMaxLines?: number;
+    tailMessages?: number;
+    maxModelChars?: number;
+    logApproxModelChars?: boolean;
+};
+export declare const DEFAULT_CONTEXT_POLICY: Required<ToolLoopContextPolicy>;
+export declare const redactFunctionCallArgs: (name: string, args: Record<string, unknown>) => Record<string, unknown>;
+export declare const compactForModel: (input: {
+    initialCount: number;
+    modelContents: any[];
+    toolEvents: ToolEvent[];
+    policy: Required<ToolLoopContextPolicy>;
+}) => any[];
+export declare const normalizeReadFileArgs: (args: Record<string, unknown>, maxLines: number) => {
+    effectiveArgs: {
+        start_line: number;
+        end_line: number;
+    };
+    start: number;
+    end: number;
+    wasCapped: boolean;
+};
+export declare const getApplyPatchEventMeta: (args: Record<string, unknown>) => {
+    chars: number;
+    sha256: string;
+    files: string[];
+};
+//# sourceMappingURL=toolLoopContext.d.ts.map

package/dist/ai/toolLoop/toolLoopContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolLoopContext.d.ts","sourceRoot":"","sources":["../../../src/ai/toolLoop/toolLoopContext.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,qBAAqB,CAKlE,CAAC;AAuBF,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4BAqB9B,CAAC;AAiBF,eAAO,MAAM,eAAe,GAAI,OAAO;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CACzC,UA8BA,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,MAAM;;;;;;;;CAmCjB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;CAOnE,CAAC"}

package/dist/ai/toolLoop/toolLoopContext.js

@@ -0,0 +1,112 @@
+import crypto from "node:crypto";
+export const DEFAULT_CONTEXT_POLICY = {
+    readFileDefaultMaxLines: 200,
+    tailMessages: 12,
+    maxModelChars: 120000,
+    logApproxModelChars: false,
+};
+const sha256Hex = (value) => crypto.createHash("sha256").update(value, "utf8").digest("hex");
+const extractPatchFiles = (patchString) => {
+    const lines = patchString.replace(/\r\n/g, "\n").split("\n");
+    const files = new Set();
+    for (const line of lines) {
+        const match = /^\*\*\* (Update File|Add File|Delete File):\s+(.+)$/.exec(line) ??
+            /^\*\*\* Move to:\s+(.+)$/.exec(line);
+        if (!match)
+            continue;
+        const filePath = (match[2] ?? match[1] ?? "").trim();
+        if (filePath)
+            files.add(filePath);
+    }
+    return [...files];
+};
+export const redactFunctionCallArgs = (name, args) => {
+    if (name !== "apply_patch")
+        return args;
+    const patch = typeof args.patch_string === "string" ? args.patch_string : "";
+    if (!patch) {
+        return {
+            ...args,
+            patch_string: { omitted: true, chars: 0, sha256: sha256Hex(""), files: [] },
+        };
+    }
+    return {
+        ...args,
+        patch_string: {
+            omitted: true,
+            chars: patch.length,
+            sha256: sha256Hex(patch),
+            files: extractPatchFiles(patch),
+        },
+    };
+};
+const isMemoryMessage = (item) => {
+    const text = item?.parts?.[0]?.text;
+    return (item?.role === "model" &&
+        typeof text === "string" &&
+        text.startsWith("MEMORY (tool trace summary):"));
+};
+const buildMemoryText = (events) => {
+    if (events.length === 0)
+        return "";
+    const lines = events.map((e) => `- ${e.summary}`);
+    return `MEMORY (tool trace summary):\n${lines.join("\n")}`;
+};
+export const compactForModel = (input) => {
+    const { initialCount, modelContents, toolEvents, policy } = input;
+    const withoutOldMemory = modelContents.filter((c) => !isMemoryMessage(c));
+    const tailStart = Math.max(initialCount, withoutOldMemory.length - policy.tailMessages);
+    const initial = withoutOldMemory.slice(0, initialCount);
+    const tail = withoutOldMemory.slice(tailStart);
+    const memoryText = buildMemoryText(toolEvents);
+    const memory = memoryText
+        ? [{ role: "model", parts: [{ text: memoryText }] }]
+        : [];
+    let compacted = [...initial, ...memory, ...tail];
+    const maxChars = Math.max(10000, policy.maxModelChars);
+    while (JSON.stringify(compacted).length > maxChars) {
+        const minLen = initial.length + memory.length + 1;
+        if (compacted.length <= minLen)
+            break;
+        compacted = [
+            ...initial,
+            ...memory,
+            ...compacted.slice(initial.length + memory.length + 1),
+        ];
+    }
+    return compacted;
+};
+export const normalizeReadFileArgs = (args, maxLines) => {
+    const requestedStart = args.start_line === undefined || args.start_line === null
+        ? 1
+        : Number(args.start_line);
+    const requestedEnd = args.end_line === undefined || args.end_line === null
+        ? undefined
+        : Number(args.end_line);
+    const start = Number.isFinite(requestedStart) && requestedStart > 0 ? requestedStart : 1;
+    const cap = Math.max(1, Math.floor(maxLines));
+    const desiredEnd = requestedEnd === undefined ||
+        !Number.isFinite(requestedEnd) ||
+        requestedEnd < start
+        ? start + cap - 1
+        : requestedEnd;
+    const cappedEnd = Math.min(desiredEnd, start + cap - 1);
+    const wasCapped = requestedEnd === undefined ||
+        desiredEnd !== requestedEnd ||
+        cappedEnd !== desiredEnd;
+    return {
+        effectiveArgs: { ...args, start_line: start, end_line: cappedEnd },
+        start,
+        end: cappedEnd,
+        wasCapped,
+    };
+};
+export const getApplyPatchEventMeta = (args) => {
+    const patch = typeof args.patch_string === "string" ? args.patch_string : "";
+    return {
+        chars: patch.length,
+        sha256: sha256Hex(patch),
+        files: extractPatchFiles(patch),
+    };
+};
+//# sourceMappingURL=toolLoopContext.js.map

package/dist/ai/toolLoop/toolLoopContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolLoopContext.js","sourceRoot":"","sources":["../../../src/ai/toolLoop/toolLoopContext.ts"],"names":[],"mappings":"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","sourcesContent":["import crypto from \"node:crypto\";\n\nexport type ToolEvent = {\n  name: string;\n  summary: string;\n};\n\nexport type ToolLoopContextPolicy = {\n  readFileDefaultMaxLines?: number;\n  tailMessages?: number;\n  maxModelChars?: number;\n  logApproxModelChars?: boolean;\n};\n\nexport const DEFAULT_CONTEXT_POLICY: Required<ToolLoopContextPolicy> = {\n  readFileDefaultMaxLines: 200,\n  tailMessages: 12,\n  maxModelChars: 120_000,\n  logApproxModelChars: false,\n};\n\nconst sha256Hex = (value: string) =>\n  crypto.createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n\nconst extractPatchFiles = (patchString: string): string[] => {\n  const lines = patchString.replace(/\\r\\n/g, \"\\n\").split(\"\\n\");\n  const files = new Set<string>();\n\n  for (const line of lines) {\n    const match =\n      /^\\*\\*\\* (Update File|Add File|Delete File):\\s+(.+)$/.exec(line) ??\n      /^\\*\\*\\* Move to:\\s+(.+)$/.exec(line);\n\n    if (!match) continue;\n\n    const filePath = (match[2] ?? match[1] ?? \"\").trim();\n    if (filePath) files.add(filePath);\n  }\n\n  return [...files];\n};\n\nexport const redactFunctionCallArgs = (\n  name: string,\n  args: Record<string, unknown>,\n) => {\n  if (name !== \"apply_patch\") return args;\n\n  const patch = typeof args.patch_string === \"string\" ? args.patch_string : \"\";\n  if (!patch) {\n    return {\n      ...args,\n      patch_string: { omitted: true, chars: 0, sha256: sha256Hex(\"\"), files: [] },\n    };\n  }\n\n  return {\n    ...args,\n    patch_string: {\n      omitted: true,\n      chars: patch.length,\n      sha256: sha256Hex(patch),\n      files: extractPatchFiles(patch),\n    },\n  };\n};\n\nconst isMemoryMessage = (item: any) => {\n  const text = item?.parts?.[0]?.text;\n  return (\n    item?.role === \"model\" &&\n    typeof text === \"string\" &&\n    text.startsWith(\"MEMORY (tool trace summary):\")\n  );\n};\n\nconst buildMemoryText = (events: ToolEvent[]) => {\n  if (events.length === 0) return \"\";\n  const lines = events.map((e) => `- ${e.summary}`);\n  return `MEMORY (tool trace summary):\\n${lines.join(\"\\n\")}`;\n};\n\nexport const compactForModel = (input: {\n  initialCount: number;\n  modelContents: any[];\n  toolEvents: ToolEvent[];\n  policy: Required<ToolLoopContextPolicy>;\n}) => {\n  const { initialCount, modelContents, toolEvents, policy } = input;\n\n  const withoutOldMemory = modelContents.filter((c) => !isMemoryMessage(c));\n  const tailStart = Math.max(\n    initialCount,\n    withoutOldMemory.length - policy.tailMessages,\n  );\n\n  const initial = withoutOldMemory.slice(0, initialCount);\n  const tail = withoutOldMemory.slice(tailStart);\n  const memoryText = buildMemoryText(toolEvents);\n  const memory = memoryText\n    ? [{ role: \"model\", parts: [{ text: memoryText }] }]\n    : [];\n\n  let compacted = [...initial, ...memory, ...tail];\n\n  const maxChars = Math.max(10_000, policy.maxModelChars);\n  while (JSON.stringify(compacted).length > maxChars) {\n    const minLen = initial.length + memory.length + 1;\n    if (compacted.length <= minLen) break;\n    compacted = [\n      ...initial,\n      ...memory,\n      ...compacted.slice(initial.length + memory.length + 1),\n    ];\n  }\n\n  return compacted;\n};\n\nexport const normalizeReadFileArgs = (\n  args: Record<string, unknown>,\n  maxLines: number,\n) => {\n  const requestedStart =\n    args.start_line === undefined || args.start_line === null\n      ? 1\n      : Number(args.start_line);\n\n  const requestedEnd =\n    args.end_line === undefined || args.end_line === null\n      ? undefined\n      : Number(args.end_line);\n\n  const start =\n    Number.isFinite(requestedStart) && requestedStart > 0 ? requestedStart : 1;\n  const cap = Math.max(1, Math.floor(maxLines));\n\n  const desiredEnd =\n    requestedEnd === undefined ||\n    !Number.isFinite(requestedEnd) ||\n    requestedEnd < start\n      ? start + cap - 1\n      : requestedEnd;\n\n  const cappedEnd = Math.min(desiredEnd, start + cap - 1);\n  const wasCapped =\n    requestedEnd === undefined ||\n    desiredEnd !== requestedEnd ||\n    cappedEnd !== desiredEnd;\n\n  return {\n    effectiveArgs: { ...args, start_line: start, end_line: cappedEnd },\n    start,\n    end: cappedEnd,\n    wasCapped,\n  };\n};\n\nexport const getApplyPatchEventMeta = (args: Record<string, unknown>) => {\n  const patch = typeof args.patch_string === \"string\" ? args.patch_string : \"\";\n  return {\n    chars: patch.length,\n    sha256: sha256Hex(patch),\n    files: extractPatchFiles(patch),\n  };\n};\n\n"]}

package/dist/ai/toolLoop/toolLoopRunner.d.ts

@@ -0,0 +1,43 @@
+import { FunctionCallingConfigMode, Tool } from "@google/genai";
+import { EventType } from "../../types/events.js";
+import { ToolLoopContextPolicy } from "./toolLoopContext.js";
+export type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
+export type ToolLoopResult = {
+    contents: any[];
+    modelContents: any[];
+    finalText: string;
+    steps: number;
+    terminalCall?: {
+        name: string;
+        args: Record<string, unknown>;
+        response: unknown;
+    };
+};
+export type Logger = (message: string, eventType: EventType) => Promise<void>;
+export type AiCallResponse = {
+    functionCalls?: any[];
+    text?: string;
+};
+export type AiCallFn = (request: unknown, options: {
+    tools?: Tool[];
+    model?: string;
+    toolCallingMode?: FunctionCallingConfigMode;
+}) => Promise<AiCallResponse>;
+export type RunToolLoopOptions = {
+    initialContents: any[];
+    tools: Tool[];
+    handlers: Record<string, ToolHandler>;
+    maxSteps?: number;
+    toolCallingMode?: FunctionCallingConfigMode;
+    terminalToolNames?: string[];
+    keepFullTrace?: boolean;
+    contextPolicy?: ToolLoopContextPolicy;
+    aiCall: AiCallFn;
+    logger: Logger;
+    applyPatchAutoRetryMax?: number;
+    aiCallAutoRetryMax?: number;
+    aiCallAutoRetryBaseMs?: number;
+    aiCallAutoRetryMaxMs?: number;
+};
+export declare function runToolLoop(options: RunToolLoopOptions): Promise<ToolLoopResult>;
+//# sourceMappingURL=toolLoopRunner.d.ts.map

package/dist/ai/toolLoop/toolLoopRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolLoopRunner.d.ts","sourceRoot":"","sources":["../../../src/ai/toolLoop/toolLoopRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAe,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAML,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C,KACE,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,cAAc,CAAC,CA2RzB"}

package/dist/ai/toolLoop/toolLoopRunner.js

@@ -0,0 +1,227 @@
+import { FunctionCallingConfigMode } from "@google/genai";
+import { EVENT_TYPES } from "../../types/events.js";
+import { compactForModel, DEFAULT_CONTEXT_POLICY, normalizeReadFileArgs, redactFunctionCallArgs, } from "./toolLoopContext.js";
+import { aiCallWithRetry, buildToolStatusMessage, recordToolEvent, serializeError, } from "./toolLoopRunnerUtils.js";
+export async function runToolLoop(options) {
+    const { initialContents, tools, handlers, maxSteps = 30, toolCallingMode = FunctionCallingConfigMode.ANY, terminalToolNames = [], keepFullTrace = true, contextPolicy, aiCall, logger, applyPatchAutoRetryMax = 2, aiCallAutoRetryMax = 3, // must have it to try 3 times as gemini errors a lot due to high demand sometimes
+    aiCallAutoRetryBaseMs = 400, aiCallAutoRetryMaxMs = 10000, } = options;
+    if (typeof aiCall !== "function") {
+        throw new Error("Tool loop: aiCall is required.");
+    }
+    const policy = {
+        ...DEFAULT_CONTEXT_POLICY,
+        ...(contextPolicy ?? {}),
+    };
+    const toolEvents = [];
+    let applyPatchRetryCount = 0;
+    const fullTraceContents = keepFullTrace ? [...initialContents] : [];
+    let modelContents = [...initialContents];
+    const pushBoth = (fullItem, modelItem) => {
+        if (keepFullTrace)
+            fullTraceContents.push(fullItem);
+        modelContents.push(modelItem);
+    };
+    const pushModelOnly = (modelItem) => {
+        modelContents.push(modelItem);
+    };
+    for (let step = 0; step < maxSteps; step++) {
+        modelContents = compactForModel({
+            initialCount: initialContents.length,
+            modelContents,
+            toolEvents,
+            policy,
+        });
+        if (policy.logApproxModelChars) {
+            const approxChars = JSON.stringify(modelContents).length;
+            console.log("Tool loop: approx model chars", {
+                approxChars,
+                step: step + 1,
+            });
+        }
+        let response;
+        response = await aiCallWithRetry({
+            aiCall,
+            request: modelContents,
+            options: { tools, toolCallingMode },
+            retryMax: aiCallAutoRetryMax,
+            retryBaseMs: aiCallAutoRetryBaseMs,
+            retryMaxMs: aiCallAutoRetryMaxMs,
+            step: step + 1,
+            logger,
+        });
+        const functionCalls = response.functionCalls ?? [];
+        if (functionCalls.length === 0) {
+            return {
+                contents: keepFullTrace ? fullTraceContents : modelContents,
+                modelContents,
+                finalText: (response.text ?? "").trim(),
+                steps: step + 1,
+            };
+        }
+        for (const call of functionCalls) {
+            const name = call.name?.toString() ?? "";
+            const args = (call.args ?? {});
+            if (!name) {
+                throw new Error("Tool loop: function call missing name.");
+            }
+            const handler = handlers[name];
+            const handlerMissingResult = !handler
+                ? {
+                    success: false,
+                    error: `No handler registered for "${name}".`,
+                    error_detail: {
+                        name: "MissingToolHandlerError",
+                        message: `No handler registered for "${name}".`,
+                    },
+                }
+                : null;
+            let effectiveArgs = args;
+            let readFileMeta = null;
+            if (name === "read_file") {
+                const normalized = normalizeReadFileArgs(effectiveArgs, policy.readFileDefaultMaxLines);
+                effectiveArgs = normalized.effectiveArgs;
+                readFileMeta = {
+                    start: normalized.start,
+                    end: normalized.end,
+                    wasCapped: normalized.wasCapped,
+                };
+            }
+            logger(buildToolStatusMessage(name, effectiveArgs, readFileMeta), EVENT_TYPES.STEP_STARTED);
+            const modelArgs = redactFunctionCallArgs(name, effectiveArgs);
+            const assistantFull = {
+                role: "model",
+                parts: [
+                    {
+                        functionCall: {
+                            name,
+                            args: effectiveArgs,
+                        },
+                    },
+                ],
+            };
+            const assistantModel = {
+                role: "model",
+                parts: [
+                    {
+                        functionCall: {
+                            name,
+                            args: modelArgs,
+                        },
+                    },
+                ],
+            };
+            if (keepFullTrace) {
+                pushBoth(assistantFull, assistantModel);
+            }
+            else {
+                pushModelOnly(assistantModel);
+            }
+            let toolResultRaw;
+            if (handlerMissingResult) {
+                toolResultRaw = handlerMissingResult;
+            }
+            else {
+                try {
+                    toolResultRaw = await handler(effectiveArgs);
+                }
+                catch (err) {
+                    logger(`AI tool: ${name} failed`, EVENT_TYPES.STEP_ERROR);
+                    console.error("Tool loop: handler threw", err, {
+                        tool: name,
+                        step: step + 1,
+                    });
+                    toolResultRaw = {
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                        error_detail: serializeError(err),
+                        note: "Tool handler threw. Inspect error_detail and retry with corrected args or a different approach.",
+                    };
+                }
+            }
+            let toolResult = toolResultRaw;
+            if (name === "read_file" && readFileMeta) {
+                const path = String(effectiveArgs.path ?? "");
+                const rawContent = typeof toolResultRaw?.content === "string"
+                    ? String(toolResultRaw.content)
+                    : typeof toolResultRaw === "string"
+                        ? toolResultRaw
+                        : JSON.stringify(toolResultRaw ?? null);
+                toolResult = {
+                    path,
+                    start_line: readFileMeta.start,
+                    end_line: readFileMeta.end,
+                    truncated: readFileMeta.wasCapped,
+                    content: rawContent,
+                    note: readFileMeta.wasCapped
+                        ? `Capped to ${policy.readFileDefaultMaxLines} lines. Request more with start_line/end_line.`
+                        : undefined,
+                };
+            }
+            const responseFull = {
+                role: "user",
+                parts: [
+                    {
+                        functionResponse: {
+                            name,
+                            response: toolResult,
+                        },
+                    },
+                ],
+            };
+            if (keepFullTrace) {
+                fullTraceContents.push(responseFull);
+            }
+            modelContents.push(responseFull);
+            if (name === "apply_patch" &&
+                toolResult?.success === false &&
+                applyPatchAutoRetryMax > 0 &&
+                applyPatchRetryCount < applyPatchAutoRetryMax) {
+                applyPatchRetryCount += 1;
+                const error = String(toolResult?.error ?? "unknown error");
+                const debugFiles = Array.isArray(toolResult?.debug?.files)
+                    ? toolResult.debug.files
+                    : [];
+                const debugText = debugFiles.length > 0
+                    ? `\n\nFILE SNAPSHOTS (for regenerating the patch):\n${debugFiles
+                        .slice(0, 3)
+                        .map((f) => `--- ${String(f.path ?? "")} ---\n${String(f.head ?? "")}\n--- end ---`)
+                        .join("\n\n")}`
+                    : "";
+                const retryInstruction = {
+                    role: "user",
+                    parts: [
+                        {
+                            text: `apply_patch failed (attempt ${applyPatchRetryCount}/${applyPatchAutoRetryMax}): ${error}\n` +
+                                `Regenerate a patch that matches the current file contents. ` +
+                                `For large rewrites, prefer write_file(path, content) or Delete+Add instead of Update.` +
+                                debugText,
+                        },
+                    ],
+                };
+                if (keepFullTrace)
+                    fullTraceContents.push(retryInstruction);
+                modelContents.push(retryInstruction);
+            }
+            recordToolEvent({
+                toolEvents,
+                name,
+                effectiveArgs,
+                modelArgs,
+                readFileMeta,
+                toolResult,
+                toolResultRaw,
+            });
+            if (terminalToolNames.includes(name)) {
+                return {
+                    contents: keepFullTrace ? fullTraceContents : modelContents,
+                    modelContents,
+                    finalText: "",
+                    steps: step + 1,
+                    terminalCall: { name, args: effectiveArgs, response: toolResultRaw },
+                };
+            }
+        }
+    }
+    throw new Error(`Tool loop: max steps reached (${maxSteps}).`);
+}
+//# sourceMappingURL=toolLoopRunner.js.map

package/dist/ai/toolLoop/toolLoopRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolLoopRunner.js","sourceRoot":"","sources":["../../../src/ai/toolLoop/toolLoopRunner.ts"],"names":[],"mappings":"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","sourcesContent":["import { FunctionCallingConfigMode, Tool } from \"@google/genai\";\nimport { EVENT_TYPES, EventType } from \"../../types/events.js\";\nimport {\n  compactForModel,\n  DEFAULT_CONTEXT_POLICY,\n  normalizeReadFileArgs,\n  redactFunctionCallArgs,\n  ToolEvent,\n  ToolLoopContextPolicy,\n} from \"./toolLoopContext.js\";\nimport {\n  aiCallWithRetry,\n  buildToolStatusMessage,\n  recordToolEvent,\n  serializeError,\n} from \"./toolLoopRunnerUtils.js\";\n\nexport type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;\n\nexport type ToolLoopResult = {\n  contents: any[];\n  modelContents: any[];\n  finalText: string;\n  steps: number;\n  terminalCall?: {\n    name: string;\n    args: Record<string, unknown>;\n    response: unknown;\n  };\n};\n\nexport type Logger = (message: string, eventType: EventType) => Promise<void>;\n\nexport type AiCallResponse = {\n  functionCalls?: any[];\n  text?: string;\n};\n\nexport type AiCallFn = (\n  request: unknown,\n  options: {\n    tools?: Tool[];\n    model?: string;\n    toolCallingMode?: FunctionCallingConfigMode;\n  },\n) => Promise<AiCallResponse>;\n\nexport type RunToolLoopOptions = {\n  initialContents: any[];\n  tools: Tool[];\n  handlers: Record<string, ToolHandler>;\n  maxSteps?: number;\n  toolCallingMode?: FunctionCallingConfigMode;\n  terminalToolNames?: string[];\n  keepFullTrace?: boolean;\n  contextPolicy?: ToolLoopContextPolicy;\n  aiCall: AiCallFn;\n  logger: Logger;\n  applyPatchAutoRetryMax?: number;\n  aiCallAutoRetryMax?: number;\n  aiCallAutoRetryBaseMs?: number;\n  aiCallAutoRetryMaxMs?: number;\n};\n\nexport async function runToolLoop(\n  options: RunToolLoopOptions,\n): Promise<ToolLoopResult> {\n  const {\n    initialContents,\n    tools,\n    handlers,\n    maxSteps = 30,\n    toolCallingMode = FunctionCallingConfigMode.ANY,\n    terminalToolNames = [],\n    keepFullTrace = true,\n    contextPolicy,\n    aiCall,\n    logger,\n    applyPatchAutoRetryMax = 2,\n    aiCallAutoRetryMax = 3, // must have it to try 3 times as gemini errors a lot due to high demand sometimes\n    aiCallAutoRetryBaseMs = 400,\n    aiCallAutoRetryMaxMs = 10_000,\n  } = options;\n\n  if (typeof aiCall !== \"function\") {\n    throw new Error(\"Tool loop: aiCall is required.\");\n  }\n\n  const policy: Required<ToolLoopContextPolicy> = {\n    ...DEFAULT_CONTEXT_POLICY,\n    ...(contextPolicy ?? {}),\n  };\n\n  const toolEvents: ToolEvent[] = [];\n  let applyPatchRetryCount = 0;\n\n  const fullTraceContents: any[] = keepFullTrace ? [...initialContents] : [];\n  let modelContents: any[] = [...initialContents];\n  const pushBoth = (fullItem: any, modelItem: any) => {\n    if (keepFullTrace) fullTraceContents.push(fullItem);\n    modelContents.push(modelItem);\n  };\n  const pushModelOnly = (modelItem: any) => {\n    modelContents.push(modelItem);\n  };\n\n  for (let step = 0; step < maxSteps; step++) {\n    modelContents = compactForModel({\n      initialCount: initialContents.length,\n      modelContents,\n      toolEvents,\n      policy,\n    });\n\n    if (policy.logApproxModelChars) {\n      const approxChars = JSON.stringify(modelContents).length;\n      console.log(\"Tool loop: approx model chars\", {\n        approxChars,\n        step: step + 1,\n      });\n    }\n\n    let response: Awaited<ReturnType<AiCallFn>>;\n    response = await aiCallWithRetry({\n      aiCall,\n      request: modelContents,\n      options: { tools, toolCallingMode },\n      retryMax: aiCallAutoRetryMax,\n      retryBaseMs: aiCallAutoRetryBaseMs,\n      retryMaxMs: aiCallAutoRetryMaxMs,\n      step: step + 1,\n      logger,\n    });\n\n    const functionCalls = response.functionCalls ?? [];\n    if (functionCalls.length === 0) {\n      return {\n        contents: keepFullTrace ? fullTraceContents : modelContents,\n        modelContents,\n        finalText: (response.text ?? \"\").trim(),\n        steps: step + 1,\n      };\n    }\n\n    for (const call of functionCalls) {\n      const name = call.name?.toString() ?? \"\";\n      const args = (call.args ?? {}) as Record<string, unknown>;\n\n      if (!name) {\n        throw new Error(\"Tool loop: function call missing name.\");\n      }\n\n      const handler = handlers[name];\n      const handlerMissingResult = !handler\n        ? {\n            success: false,\n            error: `No handler registered for \"${name}\".`,\n            error_detail: {\n              name: \"MissingToolHandlerError\",\n              message: `No handler registered for \"${name}\".`,\n            },\n          }\n        : null;\n\n      let effectiveArgs: Record<string, unknown> = args;\n      let readFileMeta: {\n        start: number;\n        end: number;\n        wasCapped: boolean;\n      } | null = null;\n      if (name === \"read_file\") {\n        const normalized = normalizeReadFileArgs(\n          effectiveArgs,\n          policy.readFileDefaultMaxLines,\n        );\n        effectiveArgs = normalized.effectiveArgs;\n        readFileMeta = {\n          start: normalized.start,\n          end: normalized.end,\n          wasCapped: normalized.wasCapped,\n        };\n      }\n\n      logger(\n        buildToolStatusMessage(name, effectiveArgs, readFileMeta),\n        EVENT_TYPES.STEP_STARTED,\n      );\n\n      const modelArgs = redactFunctionCallArgs(name, effectiveArgs);\n\n      const assistantFull = {\n        role: \"model\",\n        parts: [\n          {\n            functionCall: {\n              name,\n              args: effectiveArgs,\n            },\n          },\n        ],\n      };\n\n      const assistantModel = {\n        role: \"model\",\n        parts: [\n          {\n            functionCall: {\n              name,\n              args: modelArgs,\n            },\n          },\n        ],\n      };\n\n      if (keepFullTrace) {\n        pushBoth(assistantFull, assistantModel);\n      } else {\n        pushModelOnly(assistantModel);\n      }\n\n      let toolResultRaw: unknown;\n      if (handlerMissingResult) {\n        toolResultRaw = handlerMissingResult;\n      } else {\n        try {\n          toolResultRaw = await handler(effectiveArgs);\n        } catch (err) {\n          logger(`AI tool: ${name} failed`, EVENT_TYPES.STEP_ERROR);\n          console.error(\"Tool loop: handler threw\", err, {\n            tool: name,\n            step: step + 1,\n          });\n          toolResultRaw = {\n            success: false,\n            error: err instanceof Error ? err.message : String(err),\n            error_detail: serializeError(err),\n            note: \"Tool handler threw. Inspect error_detail and retry with corrected args or a different approach.\",\n          };\n        }\n      }\n      let toolResult: unknown = toolResultRaw;\n\n      if (name === \"read_file\" && readFileMeta) {\n        const path = String(effectiveArgs.path ?? \"\");\n        const rawContent =\n          typeof (toolResultRaw as any)?.content === \"string\"\n            ? String((toolResultRaw as any).content)\n            : typeof toolResultRaw === \"string\"\n              ? toolResultRaw\n              : JSON.stringify(toolResultRaw ?? null);\n\n        toolResult = {\n          path,\n          start_line: readFileMeta.start,\n          end_line: readFileMeta.end,\n          truncated: readFileMeta.wasCapped,\n          content: rawContent,\n          note: readFileMeta.wasCapped\n            ? `Capped to ${policy.readFileDefaultMaxLines} lines. Request more with start_line/end_line.`\n            : undefined,\n        };\n      }\n\n      const responseFull = {\n        role: \"user\",\n        parts: [\n          {\n            functionResponse: {\n              name,\n              response: toolResult,\n            },\n          },\n        ],\n      };\n\n      if (keepFullTrace) {\n        fullTraceContents.push(responseFull);\n      }\n      modelContents.push(responseFull);\n\n      if (\n        name === \"apply_patch\" &&\n        (toolResult as any)?.success === false &&\n        applyPatchAutoRetryMax > 0 &&\n        applyPatchRetryCount < applyPatchAutoRetryMax\n      ) {\n        applyPatchRetryCount += 1;\n\n        const error = String((toolResult as any)?.error ?? \"unknown error\");\n        const debugFiles = Array.isArray((toolResult as any)?.debug?.files)\n          ? ((toolResult as any).debug.files as Array<{\n              path?: string;\n              head?: string;\n            }>)\n          : [];\n\n        const debugText =\n          debugFiles.length > 0\n            ? `\\n\\nFILE SNAPSHOTS (for regenerating the patch):\\n${debugFiles\n                .slice(0, 3)\n                .map(\n                  (f) =>\n                    `--- ${String(f.path ?? \"\")} ---\\n${String(\n                      f.head ?? \"\",\n                    )}\\n--- end ---`,\n                )\n                .join(\"\\n\\n\")}`\n            : \"\";\n\n        const retryInstruction = {\n          role: \"user\",\n          parts: [\n            {\n              text:\n                `apply_patch failed (attempt ${applyPatchRetryCount}/${applyPatchAutoRetryMax}): ${error}\\n` +\n                `Regenerate a patch that matches the current file contents. ` +\n                `For large rewrites, prefer write_file(path, content) or Delete+Add instead of Update.` +\n                debugText,\n            },\n          ],\n        };\n\n        if (keepFullTrace) fullTraceContents.push(retryInstruction);\n        modelContents.push(retryInstruction);\n      }\n\n      recordToolEvent({\n        toolEvents,\n        name,\n        effectiveArgs,\n        modelArgs,\n        readFileMeta,\n        toolResult,\n        toolResultRaw,\n      });\n\n      if (terminalToolNames.includes(name)) {\n        return {\n          contents: keepFullTrace ? fullTraceContents : modelContents,\n          modelContents,\n          finalText: \"\",\n          steps: step + 1,\n          terminalCall: { name, args: effectiveArgs, response: toolResultRaw },\n        };\n      }\n    }\n  }\n\n  throw new Error(`Tool loop: max steps reached (${maxSteps}).`);\n}\n"]}