farmon 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,163 @@
+# Farmon
+
+**Farmon** is an AI-powered coding assistant that understands and edits your React codebase through deterministic code transformations.
+
+Unlike chat-based assistants that generate code snippets, Farmon analyzes your project, plans the required changes, and applies them directly to your source code while preserving project structure and formatting.
+
+> **Status:** Early Preview 🚧
+
+---
+
+## Philosophy
+
+Every week, a new LLM claims higher benchmark scores and better reasoning capabilities.
+
+But there's a more practical question:
+
+> **Can it reliably modify a real codebase over time?**
+
+Software is deterministic. Large Language Models are probabilistic.
+
+Farmon's goal is to bridge these two worlds by combining the reasoning ability of LLMs with deterministic software operations.
+
+Today's AI coding tools often generate entire files or even complete projects in a single step. While this is impressive, the result can quickly become a black box—code that works, but is difficult to understand, review, debug, or evolve.
+
+Farmon takes a different approach.
+
+Instead of asking an LLM to generate an entire application, every request is decomposed into a sequence of small, deterministic mutation tasks. Each task performs one well-defined change to the existing codebase.
+
+This keeps AI-generated software transparent rather than opaque. Every change can be inspected, reviewed, tested, undone, and reproduced.
+
+The LLM decides **what** should change.
+
+Farmon decides **how** that change is applied safely and consistently.
+
+---
+
+## Features
+
+- 🤖 Natural language code editing
+- ⚛️ React-aware component manipulation
+- 🌳 AST-based code transformations
+- 🎯 Deterministic mutation tasks
+- ↩️ Built-in undo/redo architecture
+- 🎨 Automatic code formatting
+- 🔍 Project-aware code analysis
+
+---
+
+## Requirements
+
+- Node.js 22+
+- LLM API details (local or remote)
+
+---
+
+## Installation
+
+Install Farmon:
+
+```bash
+npm install --save-dev farmon
+```
+
+Create farmon.config.js
+
+```jsx
+/** @type {import("farmon").farmonConfig} */
+export default {
+  llm: {
+    provider: "openai-compatible", // "openai-compatible" | "ollama"
+    baseUrl: "http://localhost:1234/v1", // "http://localhost:1234/v1"
+    model: "qwen3.5-9b", //"qwen3:8b",
+  },
+  appUrl: "http://localhost:5173", // user's app url
+  serverPort: 3001, // farmon server will run on this port
+  uiPort: 5174, // farmon iframe will run on this port
+
+  screenshot: {
+    enabled: true,
+  },
+  componentsDirectory: "src",
+
+  componentStructure: [".jsx", ".css", "index.ts"],
+
+  componentIdAttribute: "data-farmon-id", // this is for component selection system
+  selection: {
+    hoverColor: "#3b82f6",
+  },
+};
+```
+
+Start the Farmon server:
+
+```bash
+farmon start
+```
+
+Then import the runtime into your application:
+
+```jsx
+// inside main.jsx
+
+import { init } from "farmon";
+
+if (import.meta.env.DEV) {
+  init({
+    serverUrl: "http://localhost:3001", // the url where farmon server will run
+  });
+}
+```
+
+---
+
+## Example Commands
+
+Farmon understands instructions such as:
+
+- Remove the React starter code.
+- Create a hero section.
+- Add a navigation bar.
+- Add a sticky header.
+- Rename this component to `HeroSection`.
+- Extract this JSX into a new component.
+- Add a footer.
+- Change the background color to gray.
+- Make this button darker.
+- Center this section.
+- Rename this CSS class.
+- Move this component into the `components/layout` directory.
+
+## Roadmap
+
+Current priorities include:
+
+- Improved planning and reasoning
+- Better project understanding
+- Richer React support
+- Enhanced undo/redo
+- Expanded mutation library
+
+---
+
+## Roadmap
+
+Current priorities include:
+
+- Improved planning and reasoning
+- Better project understanding
+- Richer React support
+- Enhanced undo/redo
+- Expanded mutation library
+
+---
+
+## Contributing
+
+Farmon is under active development. Contributions, ideas, bug reports, and feature requests are welcome.
+
+---
+
+## License
+
+MIT

package/dist/bin/farmon.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+const command = process.argv[2] ?? "start";
+switch (command) {
+    case "start":
+        await import("../server/run.js");
+        break;
+    default:
+        console.error(`Unknown command: ${command}`);
+        process.exit(1);
+}
+export {};
+//# sourceMappingURL=farmon.js.map

package/dist/bin/farmon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"farmon.js","sourceRoot":"","sources":["../../bin/farmon.ts"],"names":[],"mappings":";AAEA,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;AAE3C,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,OAAO;QACV,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACjC,MAAM;IAER;QACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/execute/agents/index.js

@@ -0,0 +1,19 @@
+// export * from "./instruction-classifier-agent.js";
+// export * from "./mutation-agent.js";
+// export * from "./query-agent.js";
+// agents/index.ts
+import classifyInstruction from "./instruction-classifier-agent.js";
+import mutationAgent from "./mutation-agent.js";
+import queryAgent from "./query-agent.js";
+// Bundle your agents into a structured object
+const agents = {
+    classifyInstruction,
+    mutationAgent,
+    queryAgent,
+    // You can easily add more agents here later:
+    // coder: codeAgent,
+    // writer: writeAgent,
+};
+// Export the bundle as the default export
+export default agents;
+//# sourceMappingURL=index.js.map

package/dist/execute/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../execute/agents/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,uCAAuC;AACvC,oCAAoC;AAEpC,kBAAkB;AAClB,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;AACpE,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAE1C,8CAA8C;AAC9C,MAAM,MAAM,GAAG;IACb,mBAAmB;IACnB,aAAa;IACb,UAAU;IACV,6CAA6C;IAC7C,oBAAoB;IACpB,sBAAsB;CACvB,CAAC;AAEF,0CAA0C;AAC1C,eAAe,MAAM,CAAC"}

package/dist/execute/agents/instruction-classifier-agent.js

@@ -0,0 +1,16 @@
+import promptMaker from "../../execute/helpers/prompt-maker.js";
+import { callLLM } from "../../execute/llm/call.js";
+import { instructionClassificationSchema } from "../../schemas/index.js";
+import sse from "../../server/sse.js";
+export default async function classifyInstruction(command, ctx) {
+    sse.emitInfo("Understanding your request...");
+    const prompt = promptMaker.buildInstructionClassifierPrompt(command);
+    sse.emitInfo(`Calling llm...`);
+    const response = await callLLM(prompt, {
+        ...ctx,
+        caller: "instruction-classifier-agent",
+    });
+    const parsed = JSON.parse(response);
+    return instructionClassificationSchema.parse(parsed);
+}
+//# sourceMappingURL=instruction-classifier-agent.js.map

package/dist/execute/agents/instruction-classifier-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-classifier-agent.js","sourceRoot":"","sources":["../../../execute/agents/instruction-classifier-agent.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,GAAG,MAAM,qBAAqB,CAAC;AAEtC,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe,EAAE,GAAG;IACpE,GAAG,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,WAAW,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAErE,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE;QACrC,GAAG,GAAG;QACN,MAAM,EAAE,8BAA8B;KACvC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEpC,OAAO,+BAA+B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACvD,CAAC"}

package/dist/execute/agents/mutation-agent.js

@@ -0,0 +1,272 @@
+import history from "../../execute/history/history-manager.js";
+import sse from "../../server/sse.js";
+import generalHelpers from "../../execute/helpers/general.js";
+import rollback from "../../execute/history/rollback-handlers.js";
+import promptMaker from "../../execute/helpers/prompt-maker.js";
+import { callLLM } from "../../execute/llm/call.js";
+import { getComponentContext } from "../../server/app-context.js";
+import { ERROR_CODES, } from "../../schemas/index.js";
+import { mutations, generators, } from "../../execute/tasks/index.js";
+import { EVENTS, TaskRegistry, } from "../../schemas/index.js";
+import { LoomaError } from "../../server/error.js";
+import parsers from "../helpers/parsers.js";
+// import { buildInstructionClassifierPrompt } from "../../execute/helpers/prompt-maker.js";
+// import invokeLLM, { callLLM, } from "../../execute/llm/llm.js";
+import validator from "../../execute/helpers/validators.js";
+const taskRegistry = {
+    // ...ast.default,
+    ...mutations.default,
+    ...generators.default,
+};
+export async function executeTask({ task, payload, taskOutputs, }, appContext) {
+    const resolvedPayload = generalHelpers.resolveTaskReferences({
+        value: payload,
+        taskOutputs,
+    });
+    console.log(`\n\nExecuting task: ${task} with resolvedPayload:`, resolvedPayload);
+    const schema = TaskRegistry[task];
+    const validatedPayload = schema.payload.parse(resolvedPayload);
+    const handler = taskRegistry[task];
+    if (!handler) {
+        throw new LoomaError(ERROR_CODES.TASK_NOT_FOUND, "Unknown task", {
+            task,
+        });
+    }
+    return await handler({
+        ...validatedPayload,
+    }, appContext);
+}
+// -------------------------------------------------
+// Execute action and append to history.
+// -------------------------------------------------
+async function executeAction({ actions, executionContext, }) {
+    sse.emitInfo("Executing action plan...");
+    const { componentContext, eventBus } = executionContext;
+    // ----------------------------------------------------------
+    // This object acts as shared memory between tasks.
+    //
+    // Each task output is stored using its taskId so that
+    // subsequent tasks can reference previous outputs.
+    // ----------------------------------------------------------
+    const taskOutputs = {
+        componentContext,
+    };
+    const mutationTasks = await generalHelpers.getExportedFunctionNames("mutation");
+    // ----------------------------------------------------------
+    // Collect mutation operations so that the entire action
+    // can be rolled back if any task fails.
+    // ----------------------------------------------------------
+    const operations = [];
+    const responseMessage = [];
+    try {
+        // ----------------------------------------------------------
+        // Execute tasks sequentially.
+        //
+        // Ordering matters because later tasks may depend on
+        // outputs produced by earlier tasks.
+        // ----------------------------------------------------------
+        for (const { taskId, task, payload } of actions) {
+            // logger.addStep("TASK_STARTED", { taskId, task, payload });
+            // sse.emitTaskStart({
+            //   taskId,
+            //   task,
+            // });
+            eventBus.emit(EVENTS.TASK_STARTED, { taskId, task, payload });
+            // ----------------------------------------------------------
+            // Execute the task.
+            // ----------------------------------------------------------
+            const taskOutput = await executeTask({
+                task: task,
+                payload,
+                taskOutputs,
+            }, executionContext.appContext);
+            eventBus.emit(EVENTS.TASK_COMPLETED, { taskId, task, payload });
+            // ----------------------------------------------------------
+            // Store task output for future tasks.
+            // ----------------------------------------------------------
+            taskOutputs[taskId] = taskOutput;
+            // ----------------------------------------------------------
+            // Mutation tasks produce operations that can later be
+            // undone or redone.
+            // ----------------------------------------------------------
+            if (mutationTasks.includes(task)) {
+                const operation = rollback.operationSerializers[task]({
+                    payload,
+                    result: taskOutput,
+                });
+                responseMessage.push(taskOutput.message);
+                operations.push({
+                    taskId,
+                    task,
+                    payload,
+                    taskOutput,
+                    ...operation,
+                });
+            }
+        }
+        // ----------------------------------------------------------
+        // Entire action executed successfully.
+        // ----------------------------------------------------------
+        return {
+            success: true,
+            operations,
+            responseMessage,
+        };
+    }
+    catch (error) {
+        const originalError = error instanceof Error ? error : new Error(String(error));
+        console.error(`Operation failed: ${originalError.message}. Rolling back...`);
+        const details = originalError instanceof LoomaError ? originalError.details : {};
+        eventBus.emit(EVENTS.TASK_FAILED, {
+            message: originalError.message,
+            ...details,
+        });
+        try {
+            history.rollbackAction({ operations });
+            throw new LoomaError(ERROR_CODES.TASK_EXECUTION_FAILED, originalError.message, originalError);
+        }
+        catch (rollbackError) {
+            const rollback = rollbackError instanceof Error
+                ? rollbackError
+                : new Error(String(rollbackError));
+            console.error("CRITICAL: Failed to rollback operations.", rollback);
+            throw new LoomaError(ERROR_CODES.ROLLBACK_FAILED, `Task execution failed and rollback was unsuccessful.`, {
+                originalError,
+                rollbackError: rollback,
+                operations,
+            });
+        }
+    }
+}
+export default async function mutationAgent(executionContext) {
+    const { command, request, logger, appContext, eventBus, } = executionContext;
+    const { componentId } = request;
+    const { componentRegistry } = appContext;
+    // ----------------------------------------------------------
+    // STEP 2:
+    // Resolve the selected component's context.
+    // This provides the LLM with information about the component
+    // the user is currently working on.
+    // ----------------------------------------------------------
+    const componentContext = getComponentContext({
+        componentId,
+        componentRegistry,
+    });
+    if (!componentContext) {
+        throw new LoomaError(ERROR_CODES.COMPONENT_NOT_FOUND, `Component context not found for componentId: ${componentId}`);
+    }
+    eventBus.emit(EVENTS.COMPONENT_CONTEXT, { componentContext });
+    executionContext.componentContext = componentContext;
+    // -------------------------------------------------
+    // Ask planner to create action plan.
+    // -------------------------------------------------
+    const plan = await gereratePlan(executionContext);
+    eventBus.emit(EVENTS.PLAN_GENERATED, { actions: plan.actions });
+    const actionExecutionResult = await executeAction({
+        actions: plan.actions,
+        executionContext,
+    });
+    generalHelpers.appendAction({
+        command,
+        operations: actionExecutionResult.operations,
+        undoPath: executionContext.appContext.project.undoPath,
+    });
+    // Prepare proper response
+    return "Done! " + actionExecutionResult.responseMessage.join(", ");
+}
+/**
+ *
+ *
+ * You should provide:
+ * - user command
+ * - selected component context
+ * - available task definitions
+ * - architectural constraints
+ * - response schema
+ * - hard rules
+
+ * @param { command, componentCode} param0
+ * @returns actions []  having task and related prompt
+ */
+async function gereratePlan(executionContext) {
+    sse.emitInfo("Generating plan...");
+    const { command, logger, appContext, componentContext, eventBus, } = executionContext;
+    let basePrompt = await promptMaker.generatePlannerPrompt({
+        command,
+        componentContext,
+        projectDependencies: appContext.projectDependencies,
+    });
+    let previousError = null;
+    let actions;
+    // let caller: "planner" | "jsx" | "css" | "component";
+    const MAX_RETRIES = 3;
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            // 1. Construct the prompt fresh for this specific attempt
+            let activePrompt = basePrompt;
+            if (previousError) {
+                activePrompt += `
+            Previous attempt produced invalid response.
+  
+            Error:
+            ${previousError}
+            
+            Avoid repeating this error and regenerate the entire code.
+          `;
+            }
+            let response;
+            sse.emitInfo(`Calling llm...`);
+            eventBus.emit(EVENTS.PLANNER_PROMPT, { prompt: basePrompt });
+            response = await callLLM(activePrompt, {
+                ...executionContext.appContext,
+                caller: "mutation-agent",
+            });
+            eventBus.emit(EVENTS.PLANNER_RESPONSE, { response });
+            const parsedResponse = parsers.parseLLMJsonResponse(response);
+            eventBus.emit(EVENTS.PLANNER_RESPONSE, { parsedResponse });
+            validator.validateResponse({
+                response: parsedResponse,
+            });
+            actions = parsedResponse;
+            // update it for caller
+            // if caller is jsx, css, componentCode
+            // then only format code
+            // otherwise check schema
+            // if (caller !== "planner") {
+            //   return formatObjectCode(parsedResponse);
+            // }
+            return { actions };
+        }
+        catch (error) {
+            console.error(`generatePlan [Attempt ${attempt}]:`, error.message); // Error: LLM returned very invalid JSON.
+            eventBus.emit(EVENTS.ERROR, { message: error.message });
+            previousError = error.message;
+            // 5. If we've exhausted all retries, throw the error so the UI knows it completely failed
+            if (attempt === MAX_RETRIES) {
+                throw new LoomaError(ERROR_CODES.LLM_INVALID_RESPONSE, `LLM generation failed after ${MAX_RETRIES} attempts. Last error: ${error.message}`);
+            }
+        }
+    }
+}
+/*
+// === EXAMPLE USAGE ===
+const messyLLMResponse = `
+Sure! Here is the user data you requested:
+\`\`\`json
+{
+  "id": 101,
+  "name": "Alex Carter",
+  "roles": ["admin", "editor"],
+}
+\`\`\`
+Let me know if you need anything else!`;
+
+try {
+  const data = extractJSONFromLLM(messyLLMResponse);
+  console.log("Successfully extracted object:", data);
+} catch (error) {
+  console.error("Extraction failed:", error.message);
+}
+
+*/
+//# sourceMappingURL=mutation-agent.js.map

package/dist/execute/agents/mutation-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-agent.js","sourceRoot":"","sources":["../../../execute/agents/mutation-agent.ts"],"names":[],"mappings":"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"}

package/dist/execute/agents/query-agent.js

@@ -0,0 +1,118 @@
+import utils from "../../execute/helpers/general.js";
+import promptMaker from "../../execute/helpers/prompt-maker.js";
+import sse from "../../server/sse.js";
+import { queryAgentResponseSchema, EVENTS, ERROR_CODES, } from "../../schemas/index.js";
+import { query } from "../../execute/tasks/index.js";
+import { callLLM } from "../../execute/llm/call.js";
+import { LoomaError } from "../../server/error.js";
+import parsers from "../helpers/parsers.js";
+// type LLMResponse = Action[] | JSXResponse | CSSResponse | ComponentResponse;
+const taskRegistry = {
+    ...query.default,
+};
+export default async function queryAgent(executionContext) {
+    sse.emitInfo("Processing query...");
+    const { command, eventBus } = executionContext;
+    const { queryTasks } = await utils.generateTasksDocs();
+    const previousResults = [];
+    for (let step = 0; step < 10; step++) {
+        const prompt = promptMaker.createQueryAgentPrompt({
+            command,
+            taskDocs: queryTasks,
+            previousResults: JSON.stringify(previousResults, null, 2),
+        });
+        eventBus.emit(EVENTS.QUERY_AGENT_PROMPT, { prompt });
+        sse.emitInfo(`Calling llm...`);
+        const response = await callLLM(prompt, {
+            ...executionContext.appContext,
+            caller: "query-agent",
+        });
+        eventBus.emit(EVENTS.QUERY_AGENT_RESPONSE, { response });
+        const decision = queryAgentResponseSchema.parse(parsers.parseLLMJsonResponse(response));
+        if (decision.status === "done") {
+            return decision.response;
+        }
+        eventBus.emit(EVENTS.TASK_STARTED, { decision });
+        const result = await executeQueryTask({
+            task: decision.task,
+            payload: decision.payload,
+        }, executionContext.appContext);
+        eventBus.emit(EVENTS.TASK_COMPLETED, {
+            task: decision.task,
+            result,
+        });
+        previousResults.push({
+            task: decision.task,
+            result,
+        });
+    }
+    throw new LoomaError(ERROR_CODES.QUERY_AGENT_FAILED, `Query Agent exceeded maximum iterations.`);
+}
+export async function executeQueryTask({ task, payload }, appContext = {}) {
+    const handler = taskRegistry[task];
+    if (!handler) {
+        throw new LoomaError(ERROR_CODES.TASK_NOT_FOUND, `Unknown task: ${task}`);
+    }
+    return await handler({
+        ...payload,
+    }, appContext);
+}
+// function parser.(response: string) {
+//   try {
+//     return JSON.parse(response);
+//   } catch {
+//     try {
+//       const extractedData = extractJSONFromLLM(response);
+//       // CRITICAL FIX: You must explicitly return the extracted data here
+//       return extractedData;
+//     } catch (error) {
+//       throw new LoomaError(
+//         ERROR_CODES.LLM_INVALID_RESPONSE,
+//         "LLM's response in invalid JSON",
+//         {
+//           response,
+//           originalError: error instanceof Error ? error.message : String(error),
+//         },
+//       );
+//     }
+//   }
+// }
+// function extractJSONFromLLM(llmResponse) {
+//   try {
+//     // 1. Clean markdown code blocks if present
+//     let cleanedText = llmResponse
+//       .replace(/```json/gi, "")
+//       .replace(/```/g, "")
+//       .trim();
+//     // 2. Use regex to find the first '{' or '[' and the last '}' or ']'
+//     const jsonMatch = cleanedText.match(/[\{\[]([\s\S]*?)[\}\]]/);
+//     if (!jsonMatch) {
+//       throw new Error("No JSON structure found in the response.");
+//     }
+//     // Extract the matched substring including the outer brackets
+//     const jsonString = jsonMatch[0];
+//     // 3. Attempt to parse the extracted string
+//     return JSON.parse(jsonString);
+//   } catch (firstError) {
+//     // 4. Fallback: Heavy cleaning for common LLM syntax errors
+//     try {
+//       const sanitized = repairLLMJsonString(llmResponse);
+//       return JSON.parse(sanitized);
+//     } catch (secondError) {
+//       throw new Error(
+//         `Failed to parse LLM JSON. Original error: ${firstError.message}`,
+//       );
+//     }
+//   }
+// }
+// function repairLLMJsonString(text) {
+//   // Isolate the text between first '{' and last '}'
+//   const start = text.indexOf("{");
+//   const end = text.lastIndexOf("}");
+//   if (start === -1 || end === -1) throw new Error("Brackets missing");
+//   let jsonStr = text.substring(start, end + 1);
+//   // Strip trailing commas before closing braces/brackets
+//   jsonStr = jsonStr.replace(/,\s*([\]\}])/g, "$1");
+//   return jsonStr;
+// }
+//# sourceMappingURL=query-agent.js.map

package/dist/execute/agents/query-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-agent.js","sourceRoot":"","sources":["../../../execute/agents/query-agent.ts"],"names":[],"mappings":"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"}

package/dist/execute/helpers/analyzers.js

@@ -0,0 +1,8 @@
+export {};
+// Analyzers (instead of many parseX functions)
+// analyzeComponent
+// analyzeDependencies
+// analyzeTypes
+// analyzeHooks
+// analyzeExports
+//# sourceMappingURL=analyzers.js.map

package/dist/execute/helpers/analyzers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzers.js","sourceRoot":"","sources":["../../../execute/helpers/analyzers.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,mBAAmB;AACnB,sBAAsB;AACtB,eAAe;AACf,eAAe;AACf,iBAAiB"}