agent-enderun 1.0.8 → 1.1.0

package/dist/tests/framework-init-test/framework-mcp/tests/tools/file_system/replace_text.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { handleReplaceText } from "../../../src/tools/file_system/replace_text";
+const TEST_DIR = path.join(__dirname, "../_temp_test_files");
+const TEST_FILE = path.join(TEST_DIR, "test_file.txt");
+beforeEach(() => {
+    fs.mkdirSync(TEST_DIR, { recursive: true });
+});
+afterEach(() => {
+    fs.rmSync(TEST_DIR, { recursive: true, force: true });
+});
+describe("handleReplaceText", () => {
+    it("should replace a single occurrence of text", () => {
+        fs.writeFileSync(TEST_FILE, "hello world", "utf8");
+        const args = {
+            path: TEST_FILE,
+            oldText: "world",
+            newText: "there",
+        };
+        const result = handleReplaceText(TEST_DIR, args);
+        expect(result.content[0].text).toContain("✅ Surgical edit successful");
+        expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there");
+    });
+    it("should throw an error if text is not found", () => {
+        fs.writeFileSync(TEST_FILE, "hello world", "utf8");
+        const args = {
+            path: TEST_FILE,
+            oldText: "missing",
+            newText: "found",
+        };
+        expect(() => handleReplaceText(TEST_DIR, args)).toThrowError("Text not found in file");
+    });
+    it("should throw an error for ambiguous replacement if allowMultiple is false", () => {
+        fs.writeFileSync(TEST_FILE, "hello world world", "utf8");
+        const args = {
+            path: TEST_FILE,
+            oldText: "world",
+            newText: "there",
+            allowMultiple: false,
+        };
+        expect(() => handleReplaceText(TEST_DIR, args)).toThrowError("Ambiguous replacement");
+    });
+    it("should replace all occurrences of text if allowMultiple is true", () => {
+        fs.writeFileSync(TEST_FILE, "hello world world", "utf8");
+        const args = {
+            path: TEST_FILE,
+            oldText: "world",
+            newText: "there",
+            allowMultiple: true,
+        };
+        const result = handleReplaceText(TEST_DIR, args);
+        expect(result.content[0].text).toContain("✅ Surgical edit successful");
+        expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there there");
+    });
+    it("should handle special characters in oldText when allowMultiple is true", () => {
+        fs.writeFileSync(TEST_FILE, "test.txt", "utf8");
+        const args = {
+            path: TEST_FILE,
+            oldText: ".txt",
+            newText: ".md",
+            allowMultiple: true,
+        };
+        const result = handleReplaceText(TEST_DIR, args);
+        expect(result.content[0].text).toContain("✅ Surgical edit successful");
+        expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("test.md");
+    });
+});
+//# sourceMappingURL=replace_text.test.js.map

package/dist/tests/framework-init-test/framework-mcp/tests/tools/file_system/replace_text.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace_text.test.js","sourceRoot":"","sources":["../../../../../../../tests/framework-init-test/framework-mcp/tests/tools/file_system/replace_text.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/framework-init-test/panda.config.d.ts

@@ -0,0 +1,4 @@
+declare const _default: import("@pandacss/dev").Config & {
+    name: string;
+};
+export default _default;

package/dist/tests/framework-init-test/panda.config.js

@@ -0,0 +1,95 @@
+import { defineConfig } from "@pandacss/dev";
+export default defineConfig({
+    // Whether to use css reset
+    preflight: true,
+    // Where to look for your css declarations
+    include: [
+        "./src/**/*.{js,jsx,ts,tsx}",
+        "./pages/**/*.{js,jsx,ts,tsx}",
+        "./apps/**/*.{js,jsx,ts,tsx}",
+        // Project-internal UI components only (no packages/ui by default)
+        "./apps/**/src/components/**/*.{ts,tsx}",
+        "./apps/**/src/ui/**/*.{ts,tsx}",
+    ],
+    // Files to exclude
+    exclude: [],
+    // Conditions for Dark Mode and other states
+    conditions: {
+        extend: {
+            dark: ".dark &, [data-theme='dark'] &",
+            light: ".light &, [data-theme='light'] &",
+        },
+    },
+    // Theme Customization
+    theme: {
+        extend: {
+            // Base Tokens (Absolute Values)
+            tokens: {
+                colors: {
+                    brand: {
+                        50: { value: "#eef2ff" },
+                        100: { value: "#e0e7ff" },
+                        200: { value: "#c7d2fe" },
+                        300: { value: "#a5b4fc" },
+                        400: { value: "#818cf8" },
+                        500: { value: "#6366f1" },
+                        600: { value: "#4f46e5" },
+                        700: { value: "#4338ca" },
+                        800: { value: "#3730a3" },
+                        900: { value: "#312e81" },
+                        950: { value: "#1e1b4b" },
+                    },
+                },
+                spacing: {
+                    container: { value: "1200px" },
+                },
+            },
+            // Semantic Tokens (Theme Aware)
+            semanticTokens: {
+                colors: {
+                    bg: {
+                        canvas: {
+                            value: { base: "{colors.white}", _dark: "{colors.brand.950}" },
+                        },
+                        surface: {
+                            value: { base: "{colors.gray.50}", _dark: "{colors.brand.900}" },
+                        },
+                        muted: {
+                            value: { base: "{colors.gray.100}", _dark: "{colors.brand.800}" },
+                        },
+                    },
+                    text: {
+                        default: {
+                            value: { base: "{colors.gray.900}", _dark: "{colors.white}" },
+                        },
+                        muted: {
+                            value: { base: "{colors.gray.500}", _dark: "{colors.gray.400}" },
+                        },
+                        brand: {
+                            value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
+                        },
+                    },
+                    accent: {
+                        default: {
+                            value: { base: "{colors.brand.500}", _dark: "{colors.brand.500}" },
+                        },
+                        emphasis: {
+                            value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
+                        },
+                        fg: {
+                            value: { base: "{colors.white}", _dark: "{colors.white}" },
+                        },
+                    },
+                    border: {
+                        default: {
+                            value: { base: "{colors.gray.200}", _dark: "{colors.brand.800}" },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    // The output directory for your css system
+    outdir: "styled-system",
+});
+//# sourceMappingURL=panda.config.js.map

package/dist/tests/framework-init-test/panda.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panda.config.js","sourceRoot":"","sources":["../../../tests/framework-init-test/panda.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,2BAA2B;IAC3B,SAAS,EAAE,IAAI;IAEf,0CAA0C;IAC1C,OAAO,EAAE;QACL,4BAA4B;QAC5B,8BAA8B;QAC9B,6BAA6B;QAC7B,kEAAkE;QAClE,wCAAwC;QACxC,gCAAgC;KACnC;IAED,mBAAmB;IACnB,OAAO,EAAE,EAAE;IAEX,4CAA4C;IAC5C,UAAU,EAAE;QACR,MAAM,EAAE;YACJ,IAAI,EAAE,gCAAgC;YACtC,KAAK,EAAE,kCAAkC;SAC5C;KACJ;IAED,sBAAsB;IACtB,KAAK,EAAE;QACH,MAAM,EAAE;YACJ,gCAAgC;YAChC,MAAM,EAAE;gBACJ,MAAM,EAAE;oBACJ,KAAK,EAAE;wBACH,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACxB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;wBACzB,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;qBAC5B;iBACJ;gBACD,OAAO,EAAE;oBACL,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;iBACjC;aACJ;YACD,gCAAgC;YAChC,cAAc,EAAE;gBACZ,MAAM,EAAE;oBACJ,EAAE,EAAE;wBACA,MAAM,EAAE;4BACJ,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACjE;wBACD,OAAO,EAAE;4BACL,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACnE;wBACD,KAAK,EAAE;4BACH,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACpE;qBACJ;oBACD,IAAI,EAAE;wBACF,OAAO,EAAE;4BACL,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,gBAAgB,EAAE;yBAChE;wBACD,KAAK,EAAE;4BACH,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE;yBACnE;wBACD,KAAK,EAAE;4BACH,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACrE;qBACJ;oBACD,MAAM,EAAE;wBACJ,OAAO,EAAE;4BACL,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACrE;wBACD,QAAQ,EAAE;4BACN,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACrE;wBACD,EAAE,EAAE;4BACA,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE;yBAC7D;qBACJ;oBACD,MAAM,EAAE;wBACJ,OAAO,EAAE;4BACL,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,oBAAoB,EAAE;yBACpE;qBACJ;iBACJ;aACJ;SACJ;KACJ;IAED,2CAA2C;IAC3C,MAAM,EAAE,eAAe;CAC1B,CAAC,CAAC"}

package/dist/tests/framework-init-test/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/tests/framework-init-test/vitest.config.js

@@ -0,0 +1,19 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["tests/**/*.test.ts", "apps/**/*.test.ts"],
+        coverage: {
+            provider: "v8",
+            reporter: ["text", "json", "html"],
+            thresholds: {
+                lines: 80,
+                functions: 80,
+                branches: 80,
+                statements: 80,
+            },
+        },
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/tests/framework-init-test/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../../../tests/framework-init-test/vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;QACpD,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACjB;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/dist/tests/gemini.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/gemini.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from "vitest";
+import { resolveAdapter, isAdapterShimFile, remapFrameworkContent } from "../src/cli/adapters.js";
+describe("Agent Enderun — Gemini CLI Engine Integration Tests", () => {
+    describe("Gemini Adapter Configuration & Directories", () => {
+        it("should successfully resolve the gemini adapter with its distinct .gemini directory name", () => {
+            const config = resolveAdapter("gemini");
+            expect(config.id).toBe("gemini");
+            expect(config.frameworkDir).toBe(".gemini");
+            expect(config.shimFile).toBe("gemini.md");
+            expect(config.nestedDirs).toContain("agents");
+            expect(config.nestedDirs).toContain("skills");
+            expect(config.nestedDirs).toContain("knowledge");
+        });
+        it("should verify that Gemini frameworkDir is distinct from Antigravity CLI paths", () => {
+            const geminiConfig = resolveAdapter("gemini");
+            const cliConfig = resolveAdapter("antigravity-cli");
+            expect(geminiConfig.frameworkDir).not.toBe(cliConfig.frameworkDir);
+        });
+    });
+    describe("Gemini Shim Helpers", () => {
+        it("should validate gemini.md as a valid shim file", () => {
+            expect(isAdapterShimFile("gemini.md")).toBe(true);
+        });
+    });
+    describe("Gemini Path Remapping", () => {
+        it("should replace primary adapter and framework placeholder tokens for gemini", () => {
+            const template = "Welcome to {{ADAPTER}} running on {{FRAMEWORK_DIR}}!";
+            const output = remapFrameworkContent(template, ".gemini", "gemini");
+            expect(output).toBe("Welcome to gemini running on .gemini!");
+        });
+        it("should surgically remap directories to .gemini subfolders", () => {
+            const template = "Constitutions: .enderun/agents/ & .enderun/knowledge/ rules.";
+            const output = remapFrameworkContent(template, ".gemini", "gemini");
+            expect(output).toBe("Constitutions: .gemini/agents/ & .gemini/knowledge/ rules.");
+        });
+    });
+});
+//# sourceMappingURL=gemini.test.js.map

package/dist/tests/gemini.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.test.js","sourceRoot":"","sources":["../../tests/gemini.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACH,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAEjE,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACxD,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;YAC/F,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;YACrF,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;YACpD,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;YAClF,MAAM,QAAQ,GAAG,sDAAsD,CAAC;YACxE,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACpE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACjE,MAAM,QAAQ,GAAG,8DAA8D,CAAC;YAChF,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACpE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tests/initial.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/initial.test.js

@@ -0,0 +1,7 @@
+import { describe, it, expect } from "vitest";
+describe("Initial Setup", () => {
+    it("should verify the testing environment is active", () => {
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=initial.test.js.map

package/dist/tests/initial.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial.test.js","sourceRoot":"","sources":["../../tests/initial.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/vitest.config.js

@@ -0,0 +1,19 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["tests/**/*.test.ts", "apps/**/*.test.ts", "framework-mcp/tests/**/*.test.ts"],
+        coverage: {
+            provider: "v8",
+            reporter: ["text", "json", "html"],
+            thresholds: {
+                lines: 80,
+                functions: 80,
+                branches: 80,
+                statements: 80,
+            },
+        },
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,kCAAkC,CAAC;QACxF,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACjB;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/eslint.config.js

@@ -45,7 +45,7 @@ export default tseslint.config(
         rules: {
             ...styleRules,
             "no-unused-vars": "off",
-            "@typescript-eslint/no-explicit-any": "warn",
+            "@typescript-eslint/no-explicit-any": "error",
             "@typescript-eslint/explicit-module-boundary-types": "off",
             "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
         },

package/framework-mcp/dist/index.js

@@ -4,8 +4,8 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 import { TOOLS, toolHandlers } from "./tools/index.js";
 // ─── Server Setup ─────────────────────────────────────────────────
 const server = new Server({
-    name: "agent-enderun",
-    version: "1.0.0",
+    name: "@agent-enderun/mcp",
+    version: "1.0.9",
 }, {
     capabilities: {
         tools: {},

package/framework-mcp/dist/src/index.js

@@ -0,0 +1,70 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { TOOLS, toolHandlers } from "./tools/index.js";
+// ─── Server Setup ─────────────────────────────────────────────────
+const server = new Server({
+    name: "@agent-enderun/mcp",
+    version: "1.0.9",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const typedRequest = request;
+    const { name, arguments: args } = typedRequest.params;
+    const projectRoot = process.env.ENDERUN_PROJECT_ROOT || process.cwd();
+    try {
+        const handler = toolHandlers[name];
+        if (!handler) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            };
+        }
+        return handler(projectRoot, args || {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            isError: true,
+            content: [{ type: "text", text: message }],
+        };
+    }
+});
+// ─── Graceful Startup & Shutdown ──────────────────────────────────
+async function run() {
+    const transport = new StdioServerTransport();
+    // Prevent unhandled errors from crashing the MCP stream
+    process.on("uncaughtException", (error) => {
+        process.stderr.write(`[agent-enderun-mcp] Uncaught exception: ${error.message}
+`);
+    });
+    process.on("unhandledRejection", (reason) => {
+        const message = reason instanceof Error ? reason.message : String(reason);
+        process.stderr.write(`[agent-enderun-mcp] Unhandled rejection: ${message}
+`);
+    });
+    // Graceful shutdown on SIGINT/SIGTERM
+    const shutdown = async () => {
+        try {
+            await server.close();
+        }
+        catch {
+            // Already closed or failed — safe to ignore
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await server.connect(transport);
+}
+run().catch((error) => {
+    process.stderr.write(`[agent-enderun-mcp] Fatal startup error: ${error.message}
+`);
+    process.exit(1);
+});

package/framework-mcp/dist/src/tools/definitions.js

@@ -0,0 +1,110 @@
+export const TOOLS = [
+    {
+        name: "read_file",
+        description: "Read the content of a file within the project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file relative to project root" },
+            },
+            required: ["path"],
+        },
+    },
+    {
+        name: "write_file",
+        description: "Write content to a file. Creates directories if missing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file relative to project root" },
+                content: { type: "string", description: "Complete content of the file" },
+            },
+            required: ["path", "content"],
+        },
+    },
+    {
+        name: "replace_text",
+        description: "Surgically replace a string in a file with another string.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file" },
+                oldText: { type: "string", description: "The exact text to find" },
+                newText: { type: "string", description: "The text to replace it with" },
+            },
+            required: ["path", "oldText", "newText"],
+        },
+    },
+    {
+        name: "patch_file",
+        description: "Safely update a file by replacing a specific line range with new content.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file" },
+                startLine: { type: "number", description: "Starting line number (1-indexed)" },
+                endLine: { type: "number", description: "Ending line number (inclusive)" },
+                newContent: { type: "string", description: "The new lines to insert" },
+            },
+            required: ["path", "startLine", "endLine", "newContent"],
+        },
+    },
+    {
+        name: "get_framework_status",
+        description: "Get the current project phase, active traces, and agent states.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "update_project_memory",
+        description: "Update a specific section in PROJECT_MEMORY.md.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                section: { type: "string", description: "Section name (e.g., HISTORY, ACTIVE TASKS)" },
+                content: { type: "string", description: "Markdown content to append or set" },
+            },
+            required: ["section", "content"],
+        },
+    },
+    {
+        name: "orchestrate_loop",
+        description: "Process the pending Hermes messages and trigger dynamic state transitions.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "send_agent_message",
+        description: "Send a Hermes protocol message to another agent.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                from: { type: "string", description: "Sender agent (e.g., @manager, @backend). Defaults to @mcp if omitted." },
+                to: { type: "string", description: "Target agent (e.g., @backend, @qa)" },
+                category: { type: "string", enum: ["ACTION", "DELEGATION", "INFO", "ALERT"] },
+                content: { type: "string", description: "Message content" },
+                traceId: { type: "string", description: "Active Trace ID" },
+            },
+            required: ["to", "category", "content", "traceId"],
+        },
+    },
+    {
+        name: "log_agent_action",
+        description: "Log an agent action to the framework logs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent: { type: "string", description: "The agent name (e.g., @manager, @backend)" },
+                action: { type: "string", description: "Action type or name" },
+                traceId: { type: "string", description: "The active Trace ID" },
+                status: { type: "string", enum: ["SUCCESS", "FAILURE"], description: "The status of the action" },
+                summary: { type: "string", description: "Brief description of the action taken" },
+                findings: { type: "string", description: "Optional comma-separated findings or details" }
+            },
+            required: ["agent", "action", "traceId", "status", "summary"]
+        }
+    },
+    {
+        name: "update_contract_hash",
+        description: "Re-generate and synchronize the backend contract SHA-256 hash.",
+        inputSchema: { type: "object", properties: {} }
+    }
+];

package/framework-mcp/dist/src/tools/file_system/patch_file.js

@@ -0,0 +1,18 @@
+import fs from "fs";
+import { safePath } from "../../utils/security.js";
+export function handlePatchFile(projectRoot, args) {
+    const filePath = safePath(projectRoot, args.path);
+    const lines = fs.readFileSync(filePath, "utf8").split("\n");
+    const start = args.startLine - 1;
+    const end = args.endLine;
+    const newContent = args.newContent.split("\n");
+    if (start < 0 || start > lines.length) {
+        throw new Error(`Invalid start line: ${start + 1}. File has ${lines.length} lines.`);
+    }
+    if (end < start + 1 || end > lines.length) {
+        throw new Error(`Invalid end line: ${end}. Must be between ${start + 1} and ${lines.length}.`);
+    }
+    lines.splice(start, end - start, ...newContent);
+    fs.writeFileSync(filePath, lines.join("\n"));
+    return { content: [{ type: "text", text: `✅ File patched successfully: ${args.path}` }] };
+}

package/framework-mcp/dist/src/tools/file_system/read_file.js

@@ -0,0 +1,7 @@
+import fs from "fs";
+import { safePath } from "../../utils/security.js";
+export function handleReadFile(projectRoot, args) {
+    const filePath = safePath(projectRoot, args.path);
+    const content = fs.readFileSync(filePath, "utf8");
+    return { content: [{ type: "text", text: content }] };
+}

package/framework-mcp/dist/src/tools/file_system/replace_text.js

@@ -0,0 +1,31 @@
+import fs from "fs";
+import { safePath } from "../../utils/security.js";
+export function handleReplaceText(projectRoot, args) {
+    const filePath = safePath(projectRoot, args.path);
+    let content = fs.readFileSync(filePath, "utf8");
+    const oldText = args.oldText;
+    const newText = args.newText;
+    const allowMultiple = args.allowMultiple || false; // Default to false
+    if (!content.includes(oldText)) {
+        throw new Error(`Text not found in file: ${oldText.slice(0, 100)}...`);
+    }
+    // Surgical precision guard: reject ambiguous replacements unless allowMultiple is true.
+    if (!allowMultiple) {
+        const firstIndex = content.indexOf(oldText);
+        const lastIndex = content.lastIndexOf(oldText);
+        if (firstIndex !== lastIndex) {
+            const count = (content.match(new RegExp(oldText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g")) || []).length;
+            throw new Error(`Ambiguous replacement: "${oldText.slice(0, 80)}..." found ${count} times in ${args.path}. ` +
+                "Provide a longer, unique context string or set 'allow_multiple' to true.");
+        }
+    }
+    // Perform replacement(s)
+    if (allowMultiple) {
+        content = content.replace(new RegExp(oldText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g"), newText);
+    }
+    else {
+        content = content.replace(oldText, newText);
+    }
+    fs.writeFileSync(filePath, content);
+    return { content: [{ type: "text", text: `✅ Surgical edit successful in ${args.path}` }] };
+}

package/framework-mcp/dist/src/tools/file_system/write_file.js

@@ -0,0 +1,9 @@
+import fs from "fs";
+import path from "path";
+import { safePath } from "../../utils/security.js";
+export function handleWriteFile(projectRoot, args) {
+    const filePath = safePath(projectRoot, args.path);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, args.content);
+    return { content: [{ type: "text", text: `✅ File written: ${args.path}` }] };
+}

package/framework-mcp/dist/src/tools/framework/get_status.js

@@ -0,0 +1,5 @@
+import { safeExec } from "../../utils/cli.js";
+export function handleGetFrameworkStatus(projectRoot, args) {
+    const output = safeExec("npx", ["agent-enderun", "status"], projectRoot, args.timeout);
+    return { content: [{ type: "text", text: output }] };
+}

package/framework-mcp/dist/src/tools/framework/orchestrate.js

@@ -0,0 +1,5 @@
+import { safeExec } from "../../utils/cli.js";
+export function handleOrchestrateLoop(projectRoot, args) {
+    const output = safeExec("npx", ["agent-enderun", "orchestrate"], projectRoot, args.timeout);
+    return { content: [{ type: "text", text: output }] };
+}

package/framework-mcp/dist/src/tools/framework/update_contract_hash.js

@@ -0,0 +1,5 @@
+import { safeExec } from "../../utils/cli.js";
+export function handleUpdateContractHash(projectRoot, args) {
+    const output = safeExec("npx", ["agent-enderun", "update-contract"], projectRoot, args.timeout);
+    return { content: [{ type: "text", text: output }] };
+}

package/framework-mcp/dist/src/tools/framework/update_memory.js

@@ -0,0 +1,8 @@
+import { safeExec } from "../../utils/cli.js";
+export function handleUpdateProjectMemory(projectRoot, args) {
+    const section = args.section;
+    const content = args.content;
+    // Using execFileSync with array args prevents command injection
+    safeExec("npx", ["agent-enderun", "update_project_memory", section, content], projectRoot, args.timeout);
+    return { content: [{ type: "text", text: `✅ Section ${section} updated.` }] };
+}

package/framework-mcp/dist/src/tools/index.js

@@ -0,0 +1,25 @@
+import { TOOLS } from "./definitions.js";
+import { handleReadFile } from "./file_system/read_file.js";
+import { handleWriteFile } from "./file_system/write_file.js";
+import { handleReplaceText } from "./file_system/replace_text.js";
+import { handlePatchFile } from "./file_system/patch_file.js";
+import { handleGetFrameworkStatus } from "./framework/get_status.js";
+import { handleUpdateProjectMemory } from "./framework/update_memory.js";
+import { handleOrchestrateLoop } from "./framework/orchestrate.js";
+import { handleUpdateContractHash } from "./framework/update_contract_hash.js";
+import { handleSendAgentMessage } from "./messaging/send_message.js";
+import { handleLogAgentAction } from "./messaging/log_action.js";
+// Map of tool names to their handler functions
+export const toolHandlers = {
+    read_file: handleReadFile,
+    write_file: handleWriteFile,
+    replace_text: handleReplaceText,
+    patch_file: handlePatchFile,
+    get_framework_status: handleGetFrameworkStatus,
+    update_project_memory: handleUpdateProjectMemory,
+    orchestrate_loop: handleOrchestrateLoop,
+    send_agent_message: handleSendAgentMessage,
+    log_agent_action: handleLogAgentAction,
+    update_contract_hash: handleUpdateContractHash,
+};
+export { TOOLS };