@vedangiitb/qwintly-core 1.4.11 → 1.4.13

package/dist/ai/toolLoop/helpers/signatures.helper.js

@@ -0,0 +1,23 @@
+export function extractThoughtSignatures(response) {
+    try {
+        const candidates = Array.isArray(response?.candidates)
+            ? response.candidates
+            : [];
+        const parts = candidates?.[0]?.content?.parts;
+        const arr = Array.isArray(parts) ? parts : [];
+        const map = new Map();
+        for (const p of arr) {
+            const fc = p?.functionCall;
+            const id = fc?.id;
+            const sig = p?.thoughtSignature ?? p?.thought_signature;
+            if (typeof id === "string" && typeof sig === "string" && sig) {
+                map.set(id, sig);
+            }
+        }
+        return map;
+    }
+    catch {
+        return new Map();
+    }
+}
+//# sourceMappingURL=signatures.helper.js.map

package/dist/ai/toolLoop/helpers/signatures.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatures.helper.js","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/signatures.helper.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,QAAa;IACpD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;YACpD,CAAC,CAAE,QAAQ,CAAC,UAAoB;YAChC,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC;QAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,CAAC;YAC3B,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,CAAC,EAAE,gBAAgB,IAAI,CAAC,EAAE,iBAAiB,CAAC;YACxD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,EAAE,CAAC;gBAC7D,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAkB,CAAC;IACnC,CAAC;AACH,CAAC","sourcesContent":["export function extractThoughtSignatures(response: any): Map<string, string> {\n  try {\n    const candidates = Array.isArray(response?.candidates)\n      ? (response.candidates as any[])\n      : [];\n    const parts = candidates?.[0]?.content?.parts;\n    const arr = Array.isArray(parts) ? (parts as any[]) : [];\n    const map = new Map<string, string>();\n    for (const p of arr) {\n      const fc = p?.functionCall;\n      const id = fc?.id;\n      const sig = p?.thoughtSignature ?? p?.thought_signature;\n      if (typeof id === \"string\" && typeof sig === \"string\" && sig) {\n        map.set(id, sig);\n      }\n    }\n    return map;\n  } catch {\n    return new Map<string, string>();\n  }\n}\n"]}

package/dist/ai/toolLoop/helpers/toolArgs.helper.d.ts

@@ -0,0 +1,12 @@
+export declare function normalizeToolArgs(name: string, args: Record<string, unknown>, options: {
+    readFileDefaultMaxLines: number;
+    styleTokenKeySet: Set<string>;
+}): {
+    effectiveArgs: Record<string, unknown>;
+    readFileMeta: {
+        start: number;
+        end: number;
+        wasCapped: boolean;
+    } | null;
+};
+//# sourceMappingURL=toolArgs.helper.d.ts.map

package/dist/ai/toolLoop/helpers/toolArgs.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolArgs.helper.d.ts","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/toolArgs.helper.ts"],"names":[],"mappings":"AA2BA,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE;IACP,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC/B,GACA;IACD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,OAAO,CAAC;KACpB,GAAG,IAAI,CAAC;CACV,CAwBA"}

package/dist/ai/toolLoop/helpers/toolArgs.helper.js

@@ -0,0 +1,40 @@
+import { isPlainObject } from "../../../utils/utils.js";
+import { normalizeReadFileArgs } from "./readFile.helpers.js";
+function normalizeUpdateGlobalStylesArgs(args, styleTokenKeySet) {
+    const normalized = {};
+    const tokensMaybe = args?.tokens;
+    if (isPlainObject(tokensMaybe)) {
+        for (const [k, v] of Object.entries(tokensMaybe)) {
+            if (styleTokenKeySet.has(k) && typeof v === "string") {
+                normalized[k] = v;
+            }
+        }
+    }
+    for (const [k, v] of Object.entries(args ?? {})) {
+        if (styleTokenKeySet.has(k) && typeof v === "string") {
+            normalized[k] = v;
+        }
+    }
+    return normalized;
+}
+export function normalizeToolArgs(name, args, options) {
+    if (name === "read_file") {
+        const normalized = normalizeReadFileArgs(args, options.readFileDefaultMaxLines);
+        return {
+            effectiveArgs: normalized.effectiveArgs,
+            readFileMeta: {
+                start: normalized.start,
+                end: normalized.end,
+                wasCapped: normalized.wasCapped,
+            },
+        };
+    }
+    if (name === "update_global_styles") {
+        return {
+            effectiveArgs: normalizeUpdateGlobalStylesArgs(args, options.styleTokenKeySet),
+            readFileMeta: null,
+        };
+    }
+    return { effectiveArgs: args, readFileMeta: null };
+}
+//# sourceMappingURL=toolArgs.helper.js.map

package/dist/ai/toolLoop/helpers/toolArgs.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolArgs.helper.js","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/toolArgs.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,SAAS,+BAA+B,CACtC,IAA6B,EAC7B,gBAA6B;IAE7B,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,MAAM,WAAW,GAAG,IAAI,EAAE,MAAM,CAAC;IACjC,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACrD,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QAChD,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrD,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAA6B,EAC7B,OAGC;IASD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,qBAAqB,CACtC,IAAI,EACJ,OAAO,CAAC,uBAAuB,CAChC,CAAC;QACF,OAAO;YACL,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,YAAY,EAAE;gBACZ,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,GAAG,EAAE,UAAU,CAAC,GAAG;gBACnB,SAAS,EAAE,UAAU,CAAC,SAAS;aAChC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;QACpC,OAAO;YACL,aAAa,EAAE,+BAA+B,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC;YAC9E,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC","sourcesContent":["import { isPlainObject } from \"../../../utils/utils.js\";\nimport { normalizeReadFileArgs } from \"./readFile.helpers.js\";\n\nfunction normalizeUpdateGlobalStylesArgs(\n  args: Record<string, unknown>,\n  styleTokenKeySet: Set<string>\n): Record<string, unknown> {\n  const normalized: Record<string, unknown> = {};\n\n  const tokensMaybe = args?.tokens;\n  if (isPlainObject(tokensMaybe)) {\n    for (const [k, v] of Object.entries(tokensMaybe)) {\n      if (styleTokenKeySet.has(k) && typeof v === \"string\") {\n        normalized[k] = v;\n      }\n    }\n  }\n\n  for (const [k, v] of Object.entries(args ?? {})) {\n    if (styleTokenKeySet.has(k) && typeof v === \"string\") {\n      normalized[k] = v;\n    }\n  }\n\n  return normalized;\n}\n\nexport function normalizeToolArgs(\n  name: string,\n  args: Record<string, unknown>,\n  options: {\n    readFileDefaultMaxLines: number;\n    styleTokenKeySet: Set<string>;\n  }\n): {\n  effectiveArgs: Record<string, unknown>;\n  readFileMeta: {\n    start: number;\n    end: number;\n    wasCapped: boolean;\n  } | null;\n} {\n  if (name === \"read_file\") {\n    const normalized = normalizeReadFileArgs(\n      args,\n      options.readFileDefaultMaxLines,\n    );\n    return {\n      effectiveArgs: normalized.effectiveArgs,\n      readFileMeta: {\n        start: normalized.start,\n        end: normalized.end,\n        wasCapped: normalized.wasCapped,\n      },\n    };\n  }\n\n  if (name === \"update_global_styles\") {\n    return {\n      effectiveArgs: normalizeUpdateGlobalStylesArgs(args, options.styleTokenKeySet),\n      readFileMeta: null,\n    };\n  }\n\n  return { effectiveArgs: args, readFileMeta: null };\n}\n"]}

package/dist/ai/toolLoop/helpers/toolExecution.helper.d.ts

@@ -0,0 +1,22 @@
+import { EventType } from "../../../types/events.js";
+export type Logger = (message: string, eventType: EventType, displayedSummary?: boolean) => Promise<void>;
+export declare function executeToolHandler(params: {
+    name: string;
+    handler: ((args: any) => Promise<any>) | undefined;
+    effectiveArgs: Record<string, unknown>;
+    styleTokenKeySet: Set<string>;
+    step: number;
+    logger: Logger;
+}): Promise<unknown>;
+export declare function postProcessToolResult(params: {
+    name: string;
+    toolResultRaw: unknown;
+    effectiveArgs: Record<string, unknown>;
+    readFileMeta: {
+        start: number;
+        end: number;
+        wasCapped: boolean;
+    } | null;
+    readFileDefaultMaxLines?: number;
+}): unknown;
+//# sourceMappingURL=toolExecution.helper.d.ts.map

package/dist/ai/toolLoop/helpers/toolExecution.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolExecution.helper.d.ts","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/toolExecution.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,MAAM,MAAM,GAAG,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,gBAAgB,CAAC,EAAE,OAAO,KACvB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CnB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAoCV"}

package/dist/ai/toolLoop/helpers/toolExecution.helper.js

@@ -0,0 +1,75 @@
+import { EVENT_TYPES } from "../../../types/events.js";
+import { serializeError } from "./errors.helper.js";
+export async function executeToolHandler(params) {
+    const { name, handler, effectiveArgs, styleTokenKeySet, step, logger } = params;
+    if (!handler) {
+        return {
+            success: false,
+            error: `No handler registered for "${name}".`,
+            error_detail: {
+                name: "MissingToolHandlerError",
+                message: `No handler registered for "${name}".`,
+            },
+        };
+    }
+    try {
+        if (name === "update_global_styles") {
+            const flatKeys = Object.keys(effectiveArgs ?? {}).filter((k) => styleTokenKeySet.has(k));
+            if (flatKeys.length === 0) {
+                return {
+                    success: false,
+                    error: "must include at least one token key/value",
+                    error_detail: {
+                        name: "InvalidToolArgumentsError",
+                        message: 'update_global_styles requires at least one token key/value (e.g. { radius: "0.75rem" }).',
+                    },
+                    note: "Resend update_global_styles with at least one token key/value, or skip this tool call.",
+                };
+            }
+        }
+        return await handler(effectiveArgs);
+    }
+    catch (err) {
+        logger(`AI tool: ${name} failed`, EVENT_TYPES.STEP_ERROR, true);
+        console.error("Tool loop: handler threw", err, {
+            tool: name,
+            step,
+        });
+        return {
+            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.",
+        };
+    }
+}
+export function postProcessToolResult(params) {
+    const { name, toolResultRaw, effectiveArgs, readFileMeta, readFileDefaultMaxLines } = params;
+    if (name === "read_file" && readFileMeta) {
+        const path = typeof effectiveArgs.path === "string" ? effectiveArgs.path : "";
+        const originalJsonPayload = toolResultRaw?.kind === "json"
+            ? toolResultRaw?.json
+            : undefined;
+        if (originalJsonPayload !== undefined) {
+            // Token-efficient: return JSON as structured data (no double-stringifying).
+            return { path, json: originalJsonPayload };
+        }
+        const rawContent = typeof toolResultRaw?.content === "string"
+            ? String(toolResultRaw.content)
+            : typeof toolResultRaw === "string"
+                ? toolResultRaw
+                : JSON.stringify(toolResultRaw ?? null);
+        return {
+            path,
+            start_line: readFileMeta.start,
+            end_line: readFileMeta.end,
+            truncated: readFileMeta.wasCapped,
+            content: rawContent,
+            note: readFileMeta.wasCapped
+                ? `Capped to ${readFileDefaultMaxLines} lines. Request more with start_line/end_line.`
+                : undefined,
+        };
+    }
+    return toolResultRaw;
+}
+//# sourceMappingURL=toolExecution.helper.js.map

package/dist/ai/toolLoop/helpers/toolExecution.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolExecution.helper.js","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/toolExecution.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { EVENT_TYPES, EventType } from \"../../../types/events.js\";\nimport { serializeError } from \"./errors.helper.js\";\n\nexport type Logger = (\n  message: string,\n  eventType: EventType,\n  displayedSummary?: boolean,\n) => Promise<void>;\n\nexport async function executeToolHandler(params: {\n  name: string;\n  handler: ((args: any) => Promise<any>) | undefined;\n  effectiveArgs: Record<string, unknown>;\n  styleTokenKeySet: Set<string>;\n  step: number;\n  logger: Logger;\n}): Promise<unknown> {\n  const { name, handler, effectiveArgs, styleTokenKeySet, step, logger } = params;\n\n  if (!handler) {\n    return {\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  }\n\n  try {\n    if (name === \"update_global_styles\") {\n      const flatKeys = Object.keys(effectiveArgs ?? {}).filter((k) =>\n        styleTokenKeySet.has(k),\n      );\n      if (flatKeys.length === 0) {\n        return {\n          success: false,\n          error: \"must include at least one token key/value\",\n          error_detail: {\n            name: \"InvalidToolArgumentsError\",\n            message:\n              'update_global_styles requires at least one token key/value (e.g. { radius: \"0.75rem\" }).',\n          },\n          note: \"Resend update_global_styles with at least one token key/value, or skip this tool call.\",\n        };\n      }\n    }\n    return await handler(effectiveArgs);\n  } catch (err) {\n    logger(`AI tool: ${name} failed`, EVENT_TYPES.STEP_ERROR, true);\n    console.error(\"Tool loop: handler threw\", err, {\n      tool: name,\n      step,\n    });\n    return {\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\nexport function postProcessToolResult(params: {\n  name: string;\n  toolResultRaw: unknown;\n  effectiveArgs: Record<string, unknown>;\n  readFileMeta: { start: number; end: number; wasCapped: boolean } | null;\n  readFileDefaultMaxLines?: number;\n}): unknown {\n  const { name, toolResultRaw, effectiveArgs, readFileMeta, readFileDefaultMaxLines } = params;\n\n  if (name === \"read_file\" && readFileMeta) {\n    const path = typeof effectiveArgs.path === \"string\" ? effectiveArgs.path : \"\";\n\n    const originalJsonPayload =\n      (toolResultRaw as any)?.kind === \"json\"\n        ? (toolResultRaw as any)?.json\n        : undefined;\n\n    if (originalJsonPayload !== undefined) {\n      // Token-efficient: return JSON as structured data (no double-stringifying).\n      return { path, json: originalJsonPayload };\n    }\n\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    return {\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 ${readFileDefaultMaxLines} lines. Request more with start_line/end_line.`\n        : undefined,\n    };\n  }\n\n  return toolResultRaw;\n}\n"]}

package/dist/ai/toolLoop/helpers/toolHandlers.helper.d.ts

@@ -0,0 +1,6 @@
+import { createWorkspaceToolImpls } from "../../tools/implementations/factories.js";
+export declare function createToolHandlers(params: {
+    impls: ReturnType<typeof createWorkspaceToolImpls>;
+    workspaceRoot: string;
+}): Record<string, (args: any) => Promise<any>>;
+//# sourceMappingURL=toolHandlers.helper.d.ts.map

package/dist/ai/toolLoop/helpers/toolHandlers.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHandlers.helper.d.ts","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/toolHandlers.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAIpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CA4F9C"}

package/dist/ai/toolLoop/helpers/toolHandlers.helper.js

@@ -0,0 +1,86 @@
+import { getAvailableRoutes } from "../../tools/helpers/pageConfigJson.helpers.js";
+import { nodeFs } from "./fsHelpers.js";
+import { parsePlannerTasksUnknown } from "./plannerTaskParser.js";
+export function createToolHandlers(params) {
+    return {
+        read_file: async (args) => {
+            const path = String(args.path ?? "");
+            const startLine = args.start_line === undefined ? undefined : Number(args.start_line);
+            const endLine = args.end_line === undefined ? undefined : Number(args.end_line);
+            const content = await params.impls.readFileImpl(path, startLine, endLine);
+            return { path, content };
+        },
+        write_file: (args) => params.impls.writeFileImpl(String(args.path ?? ""), String(args.content ?? "")),
+        list_dir: async (args) => {
+            const content = await params.impls.listDirImpl(String(args.path ?? ""), Number(args.depth ?? 1));
+            return { content };
+        },
+        search: async (args) => {
+            const results = await params.impls.searchImpl(String(args.search_query ?? ""));
+            return { results };
+        },
+        apply_patch: (args) => params.impls.applyPatchImpl(String(args.patch_string ?? "")),
+        update_global_styles: async (args) => {
+            const result = await params.impls.updateGlobalStylesImpl(args);
+            return result;
+        },
+        create_new_route: async (args) => {
+            const parentRoute = String(args.parent_route ?? "");
+            const routeName = String(args.route_name ?? "");
+            const result = await params.impls.createNewRouteImpl(parentRoute, routeName);
+            return result;
+        },
+        delete_element: async (args) => {
+            const route = String(args.route ?? "");
+            const element_id = String(args.element_id ?? "");
+            const result = await params.impls.deleteElementImpl(route, element_id);
+            return result;
+        },
+        insert_element: async (args) => {
+            const result = await params.impls.insertElementImpl(args);
+            if (!result.success) {
+                const available = await getAvailableRoutes({
+                    workspaceRoot: params.workspaceRoot,
+                    fs: nodeFs,
+                });
+                return {
+                    success: false,
+                    error: `insert_element failed: ${result.error}. Available routes are: ${JSON.stringify(available)}. If you intend to create a new route, create it using the 'create_new_route' tool.`,
+                    available_routes: available,
+                };
+            }
+            return result;
+        },
+        update_props: async (args) => {
+            const route = String(args.route ?? "");
+            const element_id = String(args.element_id ?? "");
+            const props = args.props;
+            const result = await params.impls.updatePropsImpl({
+                route,
+                element_id,
+                ...props,
+            });
+            return result;
+        },
+        update_classname: async (args) => {
+            const route = String(args.route ?? "");
+            const element_id = String(args.element_id ?? "");
+            const class_name = String(args.class_name ?? "");
+            const result = await params.impls.updateClassNameImpl(route, element_id, class_name);
+            return result;
+        },
+        get_available_routes: async (args) => {
+            const routes = await getAvailableRoutes({ workspaceRoot: params.workspaceRoot, fs: nodeFs });
+            return { success: true, routes };
+        },
+        submit_codegen_done: async (args) => ({
+            success: true,
+            summary: String(args.summary ?? "").trim(),
+        }),
+        submit_planner_tasks: async (args) => {
+            const tasks = parsePlannerTasksUnknown(args.planner_tasks);
+            return { success: true, count: tasks.length };
+        },
+    };
+}
+//# sourceMappingURL=toolHandlers.helper.js.map

package/dist/ai/toolLoop/helpers/toolHandlers.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHandlers.helper.js","sourceRoot":"","sources":["../../../../src/ai/toolLoop/helpers/toolHandlers.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAvailableRoutes } from \"../../tools/helpers/pageConfigJson.helpers.js\";\nimport { createWorkspaceToolImpls } from \"../../tools/implementations/factories.js\";\nimport { nodeFs } from \"./fsHelpers.js\";\nimport { parsePlannerTasksUnknown } from \"./plannerTaskParser.js\";\n\nexport function createToolHandlers(params: {\n  impls: ReturnType<typeof createWorkspaceToolImpls>;\n  workspaceRoot: string;\n}): Record<string, (args: any) => Promise<any>> {\n  return {\n    read_file: async (args) => {\n      const path = String(args.path ?? \"\");\n      const startLine =\n        args.start_line === undefined ? undefined : Number(args.start_line);\n      const endLine =\n        args.end_line === undefined ? undefined : Number(args.end_line);\n      const content = await params.impls.readFileImpl(path, startLine, endLine);\n      return { path, content };\n    },\n    write_file: (args) =>\n      params.impls.writeFileImpl(String(args.path ?? \"\"), String(args.content ?? \"\")),\n    list_dir: async (args) => {\n      const content = await params.impls.listDirImpl(\n        String(args.path ?? \"\"),\n        Number(args.depth ?? 1),\n      );\n      return { content };\n    },\n    search: async (args) => {\n      const results = await params.impls.searchImpl(String(args.search_query ?? \"\"));\n      return { results };\n    },\n    apply_patch: (args) =>\n      params.impls.applyPatchImpl(String(args.patch_string ?? \"\")),\n    update_global_styles: async (args) => {\n      const result = await params.impls.updateGlobalStylesImpl(args);\n      return result;\n    },\n    create_new_route: async (args) => {\n      const parentRoute = String(args.parent_route ?? \"\");\n      const routeName = String(args.route_name ?? \"\");\n      const result = await params.impls.createNewRouteImpl(parentRoute, routeName);\n      return result;\n    },\n    delete_element: async (args) => {\n      const route = String(args.route ?? \"\");\n      const element_id = String(args.element_id ?? \"\");\n      const result = await params.impls.deleteElementImpl(route, element_id);\n      return result;\n    },\n    insert_element: async (args) => {\n      const result = await params.impls.insertElementImpl(args);\n      if (!result.success) {\n        const available = await getAvailableRoutes({\n          workspaceRoot: params.workspaceRoot,\n          fs: nodeFs,\n        });\n        return {\n          success: false,\n          error: `insert_element failed: ${result.error}. Available routes are: ${JSON.stringify(available)}. If you intend to create a new route, create it using the 'create_new_route' tool.`,\n          available_routes: available,\n        };\n      }\n      return result;\n    },\n    update_props: async (args) => {\n      const route = String(args.route ?? \"\");\n      const element_id = String(args.element_id ?? \"\");\n      const props: any = args.props;\n      const result = await params.impls.updatePropsImpl({\n        route,\n        element_id,\n        ...props,\n      });\n      return result;\n    },\n    update_classname: async (args) => {\n      const route = String(args.route ?? \"\");\n      const element_id = String(args.element_id ?? \"\");\n      const class_name = String(args.class_name ?? \"\");\n      const result = await params.impls.updateClassNameImpl(\n        route,\n        element_id,\n        class_name,\n      );\n      return result;\n    },\n    get_available_routes: async (args) => {\n      const routes = await getAvailableRoutes({ workspaceRoot: params.workspaceRoot, fs: nodeFs });\n      return { success: true, routes };\n    },\n    submit_codegen_done: async (args) => ({\n      success: true,\n      summary: String(args.summary ?? \"\").trim(),\n    }),\n    submit_planner_tasks: async (args) => {\n      const tasks = parsePlannerTasksUnknown(args.planner_tasks);\n      return { success: true, count: tasks.length };\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,28 @@
+import { ToolEvent } from "./toolLoopContext.js";
+export type ToolEventSummaryInput = {
+    name: string;
+    effectiveArgs: Record<string, unknown>;
+    modelArgs: Record<string, unknown>;
+    readFileMeta: {
+        start: number;
+        end: number;
+        wasCapped: boolean;
+    } | null;
+    toolResult: unknown;
+    toolResultRaw: unknown;
+};
+export declare const buildToolEventSummary: (input: ToolEventSummaryInput) => ToolEvent;
+export declare const recordToolEvent: (params: {
+    name: string;
+    effectiveArgs: Record<string, unknown>;
+    modelArgs: Record<string, unknown>;
+    readFileMeta: {
+        start: number;
+        end: number;
+        wasCapped: boolean;
+    } | null;
+    toolEvents: ToolEvent[];
+    toolResult: unknown;
+    toolResultRaw: unknown;
+}) => void;
+//# sourceMappingURL=toolEventSummary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolEventSummary.d.ts","sourceRoot":"","sources":["../../../src/ai/toolLoop/toolEventSummary.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AA0RF,eAAO,MAAM,qBAAqB,GAChC,OAAO,qBAAqB,KAC3B,SAMF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB,SAQA,CAAC"}

package/dist/ai/toolLoop/toolEventSummary.js

@@ -0,0 +1,253 @@
+import { STYLE_TOKEN_KEYS } from "../../types/styleConfig.js";
+import { getApplyPatchEventMeta } from "./helpers/applyPatch.helper.js";
+const oneLine = (value, maxLen = 140) => {
+    let raw = "";
+    if (typeof value === "string") {
+        raw = value;
+    }
+    else if (value === undefined) {
+        raw = "";
+    }
+    else if (value === null) {
+        raw = "null";
+    }
+    else {
+        raw = JSON.stringify(value);
+    }
+    const collapsed = raw.replace(/\s+/g, " ").trim();
+    if (collapsed.length <= maxLen)
+        return collapsed;
+    return `${collapsed.slice(0, Math.max(0, maxLen - 1))}…`;
+};
+const getStringArg = (effectiveArgs, key) => oneLine(effectiveArgs[key] ?? "");
+const summarizeReadFile = (input) => {
+    if (input.name !== "read_file")
+        return null;
+    const path = typeof input.effectiveArgs.path === "string" ? input.effectiveArgs.path : "";
+    const start = input.readFileMeta?.start ?? Number(input.effectiveArgs.start_line ?? 1);
+    const end = input.readFileMeta?.end ?? Number(input.effectiveArgs.end_line ?? start);
+    return {
+        name: input.name,
+        summary: `read_file ${path}:${start}-${end}${input.readFileMeta?.wasCapped ? " (capped)" : ""}`,
+    };
+};
+const summarizeApplyPatch = (input) => {
+    if (input.name !== "apply_patch")
+        return null;
+    const meta = typeof input.modelArgs.patch_string === "object"
+        ? input.modelArgs.patch_string
+        : null;
+    const fallback = getApplyPatchEventMeta(input.effectiveArgs);
+    let ok = "done";
+    if (input.toolResult?.success === true) {
+        ok = "success";
+    }
+    else if (input.toolResult?.success === false) {
+        ok = "failure";
+    }
+    return {
+        name: input.name,
+        summary: `apply_patch files=${JSON.stringify(meta?.files ?? fallback.files)} sha256=${String(meta?.sha256 ?? fallback.sha256).slice(0, 12)} chars=${meta?.chars ?? fallback.chars} result=${ok}`,
+    };
+};
+const summarizeCreateNewRoute = (input) => {
+    if (input.name !== "create_new_route")
+        return null;
+    const parentRoute = getStringArg(input.effectiveArgs, "parent_route") || "/";
+    const routeName = getStringArg(input.effectiveArgs, "route_name");
+    const successVal = input.toolResult?.success;
+    if (typeof successVal !== "boolean")
+        return null;
+    const route = oneLine(input.toolResult?.route ?? "");
+    const createdFiles = Array.isArray(input.toolResult?.created_files)
+        ? input.toolResult.created_files
+        : [];
+    const filesText = successVal === true ? ` created_files=${createdFiles.length}` : "";
+    const routeText = route ? ` route=${route}` : "";
+    const errText = successVal === false
+        ? ` error=${oneLine(input.toolResult?.error ?? "unknown", 160)}`
+        : "";
+    return {
+        name: input.name,
+        summary: `create_new_route ${successVal ? "success" : "failure"} parent_route=${parentRoute} route_name=${routeName}${routeText}${filesText}${errText}`,
+    };
+};
+const summarizeInsertElement = (input) => {
+    if (input.name !== "insert_element")
+        return null;
+    const route = getStringArg(input.effectiveArgs, "route");
+    const parentId = getStringArg(input.effectiveArgs, "parent_id");
+    const beforeId = getStringArg(input.effectiveArgs, "before_id");
+    const successVal = input.toolResult?.success;
+    if (typeof successVal !== "boolean")
+        return null;
+    const insertedId = oneLine(input.toolResult?.inserted_id ?? "");
+    const changedVal = input.toolResult?.changed;
+    const changedText = typeof changedVal === "boolean" ? ` changed=${changedVal}` : "";
+    const beforeText = beforeId ? ` before_id=${beforeId}` : "";
+    const insertedText = insertedId ? ` inserted_id=${insertedId}` : "";
+    const errText = successVal === false
+        ? ` error=${oneLine(input.toolResult?.error ?? "unknown", 160)}`
+        : "";
+    return {
+        name: input.name,
+        summary: `insert_element ${successVal ? "success" : "failure"} route=${route} parent_id=${parentId}${beforeText}${insertedText}${changedText}${errText}`,
+    };
+};
+const summarizeUpdateClassname = (input) => {
+    if (input.name !== "update_classname")
+        return null;
+    const route = getStringArg(input.effectiveArgs, "route");
+    const elementId = getStringArg(input.effectiveArgs, "element_id");
+    const className = oneLine(input.effectiveArgs.className ?? "", 160);
+    const successVal = input.toolResult?.success;
+    if (typeof successVal !== "boolean")
+        return null;
+    const changedVal = input.toolResult?.changed;
+    const changedText = typeof changedVal === "boolean" ? ` changed=${changedVal}` : "";
+    const updatedId = oneLine(input.toolResult?.updated_id ?? "");
+    const updatedText = updatedId ? ` updated_id=${updatedId}` : "";
+    const errText = successVal === false
+        ? ` error=${oneLine(input.toolResult?.error ?? "unknown", 160)}`
+        : "";
+    return {
+        name: input.name,
+        summary: `update_classname ${successVal ? "success" : "failure"} route=${route} element_id=${elementId} className="${className}"${updatedText}${changedText}${errText}`,
+    };
+};
+const summarizeUpdateProps = (input) => {
+    if (input.name !== "update_props")
+        return null;
+    const route = getStringArg(input.effectiveArgs, "route");
+    const elementId = getStringArg(input.effectiveArgs, "element_id");
+    const successVal = input.toolResult?.success;
+    if (typeof successVal !== "boolean")
+        return null;
+    const changedVal = input.toolResult?.changed;
+    const changedText = typeof changedVal === "boolean" ? ` changed=${changedVal}` : "";
+    const updatedId = oneLine(input.toolResult?.updated_id ?? "");
+    const updatedText = updatedId ? ` updated_id=${updatedId}` : "";
+    const patchKeys = Object.keys(input.effectiveArgs ?? {}).filter((k) => {
+        if (k === "route" || k === "element_id")
+            return false;
+        const v = input.effectiveArgs[k];
+        return v !== undefined && v !== null;
+    });
+    patchKeys.sort((a, b) => a.localeCompare(b));
+    const keysText = patchKeys.length > 0
+        ? ` keys=${oneLine(patchKeys.join(","), 140)}`
+        : "";
+    const errText = successVal === false
+        ? ` error=${oneLine(input.toolResult?.error ?? "unknown", 160)}`
+        : "";
+    return {
+        name: input.name,
+        summary: `update_props ${successVal ? "success" : "failure"} route=${route} element_id=${elementId}${keysText}${updatedText}${changedText}${errText}`,
+    };
+};
+const summarizeUpdateGlobalStyles = (input) => {
+    if (input.name !== "update_global_styles")
+        return null;
+    const tokenKeySet = new Set(STYLE_TOKEN_KEYS);
+    const tokenKeys = Object.keys(input.effectiveArgs ?? {}).filter((k) => tokenKeySet.has(k));
+    const successVal = input.toolResult?.success;
+    if (typeof successVal !== "boolean")
+        return null;
+    const changedVal = input.toolResult?.changed;
+    const changedText = typeof changedVal === "boolean" ? ` changed=${changedVal}` : "";
+    const version = input.toolResult?.version;
+    const versionText = typeof version === "number" && Number.isFinite(version)
+        ? ` version=${version}`
+        : "";
+    const created = input.toolResult?.created;
+    const createdText = typeof created === "boolean" ? ` created=${created}` : "";
+    tokenKeys.sort((a, b) => a.localeCompare(b));
+    const keysText = tokenKeys.length > 0
+        ? ` tokens=${oneLine(tokenKeys.join(","), 160)}`
+        : "";
+    const errText = successVal === false
+        ? ` error=${oneLine(input.toolResult?.error ?? "unknown", 160)}`
+        : "";
+    return {
+        name: input.name,
+        summary: `update_global_styles ${successVal ? "success" : "failure"}${keysText}${versionText}${createdText}${changedText}${errText}`,
+    };
+};
+const summarizeSearch = (input) => {
+    if (input.name !== "search")
+        return null;
+    const q = typeof input.effectiveArgs.search_query === "string" ? input.effectiveArgs.search_query.trim() : "";
+    const results = Array.isArray(input.toolResultRaw?.results)
+        ? input.toolResultRaw.results
+        : [];
+    return {
+        name: input.name,
+        summary: `search "${q}" -> ${results.length} results`,
+    };
+};
+const summarizeListDir = (input) => {
+    if (input.name !== "list_dir")
+        return null;
+    const p = typeof input.effectiveArgs.path === "string" ? input.effectiveArgs.path : "";
+    const d = Number(input.effectiveArgs.depth ?? 1);
+    return { name: input.name, summary: `list_dir ${p} depth=${d}` };
+};
+const summarizeCreateFile = (input) => {
+    if (input.name !== "create_file")
+        return null;
+    const p = typeof input.effectiveArgs.path === "string" ? input.effectiveArgs.path : "";
+    return { name: input.name, summary: `create_file ${p}` };
+};
+const summarizeDeleteFile = (input) => {
+    if (input.name !== "delete_file")
+        return null;
+    const p = typeof input.effectiveArgs.path === "string" ? input.effectiveArgs.path : "";
+    return { name: input.name, summary: `delete_file ${p}` };
+};
+const summarizeGenericSuccessFailure = (input) => {
+    const successVal = input.toolResult?.success;
+    if (typeof successVal !== "boolean")
+        return null;
+    const changedVal = input.toolResult?.changed;
+    const changedText = typeof changedVal === "boolean" ? ` changed=${changedVal}` : "";
+    const errText = successVal === false
+        ? ` error=${oneLine(input.toolResult?.error ?? "unknown", 160)}`
+        : "";
+    return {
+        name: input.name,
+        summary: `${input.name} ${successVal ? "success" : "failure"}${changedText}${errText}`,
+    };
+};
+const SUMMARIZERS = [
+    summarizeReadFile,
+    summarizeApplyPatch,
+    summarizeCreateNewRoute,
+    summarizeInsertElement,
+    summarizeUpdateClassname,
+    summarizeUpdateProps,
+    summarizeUpdateGlobalStyles,
+    summarizeSearch,
+    summarizeListDir,
+    summarizeCreateFile,
+    summarizeDeleteFile,
+    summarizeGenericSuccessFailure,
+];
+export const buildToolEventSummary = (input) => {
+    for (const summarizer of SUMMARIZERS) {
+        const evt = summarizer(input);
+        if (evt)
+            return evt;
+    }
+    return { name: input.name, summary: `${input.name} called` };
+};
+export const recordToolEvent = (params) => {
+    const { toolEvents, name } = params;
+    try {
+        toolEvents.push(buildToolEventSummary(params));
+    }
+    catch {
+        toolEvents.push({ name, summary: `${name} called` });
+        return;
+    }
+};
+//# sourceMappingURL=toolEventSummary.js.map