@exulu/backend 1.29.0 → 1.30.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-# [1.29.0](https://github.com/Qventu/exulu-backend/compare/v1.28.2...v1.29.0) (2025-10-28)
+## [1.30.1](https://github.com/Qventu/exulu-backend/compare/v1.30.0...v1.30.1) (2025-11-04)
 
 
-### Features
+### Bug Fixes
 
-* add agent animations, math tools, and improve file handling ([d335a7e](https://github.com/Qventu/exulu-backend/commit/d335a7e6c8454490d971ec63dc8486fcd60ef59b))
+* dont add eval tools if redis not configured ([4ebbb5c](https://github.com/Qventu/exulu-backend/commit/4ebbb5ce44aaf07072adaf6b6963e6eac376e022))

package/dist/index.cjs

@@ -437,7 +437,8 @@ var sanitizeName = (name) => {
 
 // src/registry/classes.ts
 var import_crypto_js2 = __toESM(require("crypto-js"), 1);
-var import_express2 = require("express");
+var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+var import_mcp_stdio = require("ai/mcp-stdio");
 
 // src/registry/utils/graphql.ts
 var import_schema = require("@graphql-tools/schema");
@@ -2428,7 +2429,7 @@ var applyAccessControl = (table, user, query) => {
   console.log("[EXULU] table.name.plural", table.name.plural);
   if (!user.super_admin && (!user.role || !(table.name.plural === "agents" && (user.role.agents === "read" || user.role.agents === "write")) && !(table.name.plural === "workflow_templates" && (user.role.workflows === "read" || user.role.workflows === "write")) && !(table.name.plural === "variables" && (user.role.variables === "read" || user.role.variables === "write")) && !(table.name.plural === "users" && (user.role.users === "read" || user.role.users === "write")) && !((table.name.plural === "test_cases" || table.name.plural === "eval_sets" || table.name.plural === "eval_runs") && (user.role.evals === "read" || user.role.evals === "write")))) {
     console.error("==== Access control error: no role found or no access to entity type. ====");
-    return query.where("id", "=", "0");
+    throw new Error("Access control error: no role found or no access to entity type.");
   }
   const hasRBAC = table.RBAC === true;
   console.log("[EXULU] hasRBAC", hasRBAC);
@@ -2532,11 +2533,14 @@ var addAgentFields = async (requestedFields, agents, result, tools, user) => {
         } else {
           hydrated = tools.find((t) => t.id === tool2.id);
         }
-        return {
+        const hydratedTool = {
           ...tool2,
           name: hydrated?.name || "",
-          description: hydrated?.description || ""
+          description: hydrated?.description || "",
+          category: tool2?.category || "default"
         };
+        console.log("[EXULU] hydratedTool", hydratedTool);
+        return hydratedTool;
       }));
       result.tools = result.tools.filter((tool2) => tool2 !== null);
     } else {
@@ -3480,7 +3484,8 @@ type PageInfo {
     deleteJob(queue: QueueEnum!, id: String!): JobActionReturnPayload
     `;
   typeDefs += `
-   tools: ToolPaginationResult
+   tools(search: String, category: String, limit: Int, page: Int): ToolPaginationResult
+   toolCategories: [String!]!
     `;
   typeDefs += `
    jobs(queue: QueueEnum!, statusses: [JobStateEnum!]): JobPaginationResult
@@ -3800,6 +3805,7 @@ type PageInfo {
   };
   resolvers.Query["tools"] = async (_, args, context, info) => {
     const requestedFields = getRequestedFields(info);
+    const { search, category, limit = 100, page = 0 } = args;
     const instances = await loadAgents();
     let agentTools = await Promise.all(
       instances.map(async (instance) => {
@@ -3811,16 +3817,39 @@ type PageInfo {
       })
     );
     const filtered = agentTools.filter((tool2) => tool2 !== null);
+    let allTools = [...filtered, ...tools];
+    if (search && search.trim()) {
+      const searchTerm = search.toLowerCase().trim();
+      allTools = allTools.filter(
+        (tool2) => tool2.name?.toLowerCase().includes(searchTerm) || tool2.description?.toLowerCase().includes(searchTerm)
+      );
+    }
+    if (category && category.trim()) {
+      allTools = allTools.filter((tool2) => tool2.category === category);
+    }
+    const total = allTools.length;
+    const start = page * limit;
+    const end = start + limit;
+    const paginatedTools = allTools.slice(start, end);
     return {
-      items: [...filtered, ...tools].map((tool2) => {
+      items: paginatedTools.map((tool2) => {
         const object = {};
         requestedFields.forEach((field) => {
           object[field] = tool2[field];
         });
         return object;
-      })
+      }),
+      total,
+      page,
+      limit
     };
   };
+  resolvers.Query["toolCategories"] = async () => {
+    const array = tools.map((tool2) => tool2.category).filter((category) => category && typeof category === "string");
+    array.push("contexts");
+    array.push("agents");
+    return [...new Set(array)].sort();
+  };
   modelDefs += `
     type ProviderPaginationResult {
         items: [Provider]!
@@ -3859,6 +3888,9 @@ type PageInfo {
   modelDefs += `
     type ToolPaginationResult {
     items: [Tool]!
+    total: Int!
+    page: Int!
+    limit: Int!
     }
     `;
   modelDefs += `
@@ -3968,6 +4000,7 @@ type Tool {
   id: ID!
   name: String!
   description: String
+  category: String
   type: String
   config: JSON
 }
@@ -4599,6 +4632,7 @@ var createUppyRoutes = async (app, config) => {
 };
 
 // src/registry/classes.ts
+var import_streamableHttp2 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 var s3Client2;
 function sanitizeToolName(name) {
   if (typeof name !== "string") return "";
@@ -4617,12 +4651,6 @@ var convertToolsArrayToObject = (currentTools, allExuluTools, configs, providera
     name: sanitizeToolName(tool2.name)
   })) : [];
   console.log("[EXULU] Sanitized tools", sanitizedTools.map((x) => x.name + " (" + x.id + ")"));
-  const askForConfirmation = {
-    description: "Ask the user for confirmation.",
-    inputSchema: import_zod.z.object({
-      message: import_zod.z.string().describe("The message to ask for confirmation.")
-    })
-  };
   return {
     ...sanitizedTools?.reduce(
       (prev, cur) => ({
@@ -4721,8 +4749,8 @@ var convertToolsArrayToObject = (currentTools, allExuluTools, configs, providera
         }
       }),
       {}
-    ),
-    askForConfirmation
+    )
+    // askForConfirmation
   };
 };
 var hydrateVariables = async (tool2) => {
@@ -4856,6 +4884,7 @@ var ExuluAgent2 = class {
       id: agentInstance.id,
       name: `${agentInstance.name}`,
       type: "agent",
+      category: "agents",
       inputSchema: import_zod.z.object({
         prompt: import_zod.z.string().describe("The prompt (usually a question for the agent) to send to the agent."),
         information: import_zod.z.string().describe("A summary of relevant context / information from the current session")
@@ -5284,13 +5313,15 @@ var ExuluTool2 = class {
   id;
   name;
   description;
+  category;
   inputSchema;
   type;
   tool;
   config;
-  constructor({ id, name, description, inputSchema, type, execute: execute2, config }) {
+  constructor({ id, name, description, category, inputSchema, type, execute: execute2, config }) {
     this.id = id;
     this.config = config;
+    this.category = category || "default";
     this.name = name;
     this.description = description;
     this.inputSchema = inputSchema;
@@ -5719,6 +5750,7 @@ var ExuluContext = class {
       id: this.id,
       name: `${this.name}`,
       type: "context",
+      category: "contexts",
       inputSchema: import_zod.z.object({
         query: import_zod.z.string()
       }),
@@ -5756,7 +5788,6 @@ var ExuluContext = class {
   };
 };
 var updateStatistic = async (statistic) => {
-  console.log("[EXULU] Updating statistic", statistic);
   const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   const { db: db3 } = await postgresClient();
   const existing = await db3.from("tracking").where({
@@ -5767,7 +5798,6 @@ var updateStatistic = async (statistic) => {
     type: statistic.type,
     createdAt: currentDate
   }).first();
-  console.log("[EXULU] Existing", existing);
   if (!existing) {
     await db3.from("tracking").insert({
       name: statistic.name,
@@ -5838,11 +5868,11 @@ var getMimeType = (type) => {
 };
 
 // src/registry/index.ts
-var import_express7 = require("express");
+var import_express6 = require("express");
 
 // src/registry/routes.ts
-var import_express3 = require("express");
-var import_express4 = __toESM(require("express"), 1);
+var import_express2 = require("express");
+var import_express3 = __toESM(require("express"), 1);
 var import_server2 = require("@apollo/server");
 var import_cors = __toESM(require("cors"), 1);
 var import_reflect_metadata = require("reflect-metadata");
@@ -5909,7 +5939,7 @@ var createExpressRoutes = async (app, agents, tools, contexts, config, evals, tr
     optionsSuccessStatus: 200
     // some legacy browsers (IE11, various SmartTVs) choke on 204
   };
-  app.use(import_express4.default.json({ limit: REQUEST_SIZE_LIMIT }));
+  app.use(import_express3.default.json({ limit: REQUEST_SIZE_LIMIT }));
   app.use((0, import_cors.default)(corsOptions));
   app.use(import_body_parser.default.urlencoded({ extended: true, limit: REQUEST_SIZE_LIMIT }));
   app.use(import_body_parser.default.json({ limit: REQUEST_SIZE_LIMIT }));
@@ -5949,7 +5979,7 @@ var createExpressRoutes = async (app, agents, tools, contexts, config, evals, tr
   app.use(
     "/graphql",
     (0, import_cors.default)(corsOptions),
-    import_express4.default.json({ limit: REQUEST_SIZE_LIMIT }),
+    import_express3.default.json({ limit: REQUEST_SIZE_LIMIT }),
     (0, import_express5.expressMiddleware)(server, {
       context: async ({ req }) => {
         console.info("[EXULU] Incoming graphql request", {
@@ -6325,7 +6355,7 @@ Mood: friendly and intelligent.
       }
     });
   });
-  app.use("/gateway/anthropic/:id", import_express4.default.raw({ type: "*/*", limit: REQUEST_SIZE_LIMIT }), async (req, res) => {
+  app.use("/gateway/anthropic/:id", import_express3.default.raw({ type: "*/*", limit: REQUEST_SIZE_LIMIT }), async (req, res) => {
     try {
       if (!req.body.tools) {
         req.body.tools = [];
@@ -6466,7 +6496,7 @@ data: ${JSON.stringify(event)}
       }
     }
   });
-  app.use(import_express4.default.static("public"));
+  app.use(import_express3.default.static("public"));
   return app;
 };
 var createCustomAnthropicStreamingMessage = (message) => {
@@ -7168,10 +7198,10 @@ function getAverage(arr) {
 // src/mcp/index.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_node_crypto4 = require("crypto");
-var import_streamableHttp = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+var import_streamableHttp3 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_zod2 = require("zod");
-var import_express6 = require("express");
+var import_express4 = require("express");
 var import_api3 = require("@opentelemetry/api");
 var SESSION_ID_HEADER = "mcp-session-id";
 var ExuluMCP = class {
@@ -7258,7 +7288,7 @@ ${code}`
       if (sessionId && this.transports[sessionId]) {
         transport = this.transports[sessionId];
       } else if (!sessionId && (0, import_types.isInitializeRequest)(req.body)) {
-        transport = new import_streamableHttp.StreamableHTTPServerTransport({
+        transport = new import_streamableHttp3.StreamableHTTPServerTransport({
           sessionIdGenerator: () => (0, import_node_crypto4.randomUUID)(),
           onsessioninitialized: (sessionId2) => {
             this.transports[sessionId2] = transport;
@@ -7299,7 +7329,7 @@ ${code}`
 };
 
 // src/registry/index.ts
-var import_express8 = __toESM(require("express"), 1);
+var import_express7 = __toESM(require("express"), 1);
 
 // src/templates/agents/anthropic/claude.ts
 var import_anthropic = require("@ai-sdk/anthropic");
@@ -8104,6 +8134,7 @@ var additionTool = new ExuluTool2({
   name: "Addition",
   description: "Adds two numbers together",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     firstNumber: import_zod4.z.number().describe("The first addend"),
@@ -8119,6 +8150,7 @@ var subtractionTool = new ExuluTool2({
   name: "Subtraction",
   description: "Subtracts the second number from the first number",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     minuend: import_zod4.z.number().describe("The number to subtract from (minuend)"),
@@ -8134,6 +8166,7 @@ var multiplicationTool = new ExuluTool2({
   name: "Multiplication",
   description: "Multiplies two numbers together",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     firstNumber: import_zod4.z.number().describe("The first number"),
@@ -8149,6 +8182,7 @@ var divisionTool = new ExuluTool2({
   name: "Division",
   description: "Divides the first number by the second number",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numerator: import_zod4.z.number().describe("The number being divided (numerator)"),
@@ -8164,6 +8198,7 @@ var sumTool = new ExuluTool2({
   name: "Sum",
   description: "Adds any number of numbers together",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numbers: import_zod4.z.array(import_zod4.z.number()).min(1).describe("Array of numbers to sum")
@@ -8178,6 +8213,7 @@ var moduloTool = new ExuluTool2({
   name: "Modulo",
   description: "Divides two numbers and returns the remainder",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numerator: import_zod4.z.number().describe("The number being divided (numerator)"),
@@ -8193,6 +8229,7 @@ var meanTool = new ExuluTool2({
   name: "Mean",
   description: "Calculates the arithmetic mean of a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numbers: import_zod4.z.array(import_zod4.z.number()).min(1).describe("Array of numbers to find the mean of")
@@ -8207,6 +8244,7 @@ var medianTool = new ExuluTool2({
   name: "Median",
   description: "Calculates the median of a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numbers: import_zod4.z.array(import_zod4.z.number()).min(1).describe("Array of numbers to find the median of")
@@ -8221,6 +8259,7 @@ var modeTool = new ExuluTool2({
   name: "Mode",
   description: "Finds the most common number in a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numbers: import_zod4.z.array(import_zod4.z.number()).describe("Array of numbers to find the mode of")
@@ -8235,6 +8274,7 @@ var minTool = new ExuluTool2({
   name: "Minimum",
   description: "Finds the minimum value from a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numbers: import_zod4.z.array(import_zod4.z.number()).describe("Array of numbers to find the minimum of")
@@ -8249,6 +8289,7 @@ var maxTool = new ExuluTool2({
   name: "Maximum",
   description: "Finds the maximum value from a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     numbers: import_zod4.z.array(import_zod4.z.number()).describe("Array of numbers to find the maximum of")
@@ -8263,6 +8304,7 @@ var floorTool = new ExuluTool2({
   name: "Floor",
   description: "Rounds a number down to the nearest integer",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number to round down")
@@ -8277,6 +8319,7 @@ var ceilingTool = new ExuluTool2({
   name: "Ceiling",
   description: "Rounds a number up to the nearest integer",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number to round up")
@@ -8291,6 +8334,7 @@ var roundTool = new ExuluTool2({
   name: "Round",
   description: "Rounds a number to the nearest integer",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number to round")
@@ -8305,6 +8349,7 @@ var sinTool = new ExuluTool2({
   name: "Sine",
   description: "Calculates the sine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number in radians to find the sine of")
@@ -8319,6 +8364,7 @@ var arcsinTool = new ExuluTool2({
   name: "Arcsine",
   description: "Calculates the arcsine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number to find the arcsine of")
@@ -8333,6 +8379,7 @@ var cosTool = new ExuluTool2({
   name: "Cosine",
   description: "Calculates the cosine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number in radians to find the cosine of")
@@ -8347,6 +8394,7 @@ var arccosTool = new ExuluTool2({
   name: "Arccosine",
   description: "Calculates the arccosine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number to find the arccosine of")
@@ -8361,6 +8409,7 @@ var tanTool = new ExuluTool2({
   name: "Tangent",
   description: "Calculates the tangent of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number in radians to find the tangent of")
@@ -8375,6 +8424,7 @@ var arctanTool = new ExuluTool2({
   name: "Arctangent",
   description: "Calculates the arctangent of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number to find the arctangent of")
@@ -8389,6 +8439,7 @@ var radiansToDegreesTool = new ExuluTool2({
   name: "Radians to Degrees",
   description: "Converts a radian value to its equivalent in degrees",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number in radians to convert to degrees")
@@ -8403,6 +8454,7 @@ var degreesToRadiansTool = new ExuluTool2({
   name: "Degrees to Radians",
   description: "Converts a degree value to its equivalent in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: import_zod4.z.object({
     number: import_zod4.z.number().describe("The number in degrees to convert to radians")
@@ -8481,10 +8533,10 @@ var ExuluApp = class {
   // Factory function so we can async 
   // initialize the MCP server if needed.
   create = async ({ contexts, agents, config, tools, evals }) => {
-    this._evals = [
+    this._evals = redisServer.host?.length && redisServer.port?.length ? [
       llmAsJudgeEval,
       ...evals ?? []
-    ];
+    ] : [];
     this._contexts = {
       ...contexts,
       codeStandardsContext,
@@ -8514,6 +8566,7 @@ var ExuluApp = class {
       // Because agents are stored in the database,  we add those as tools
       // at request time, not during ExuluApp initialization. We add them
       // in the grahql tools resolver.
+      // ...mcpTools
     ];
     const checks = [
       ...Object.keys(this._contexts || {}).map((x) => ({
@@ -8552,7 +8605,7 @@ var ExuluApp = class {
   express = {
     init: async () => {
       if (!this._expressApp) {
-        this._expressApp = (0, import_express8.default)();
+        this._expressApp = (0, import_express7.default)();
         await this.server.express.init();
         console.log("[EXULU] Express app initialized.");
       }

package/dist/index.d.cts

@@ -469,6 +469,7 @@ declare class ExuluTool {
     id: string;
     name: string;
     description: string;
+    category: string;
     inputSchema?: z.ZodType;
     type: "context" | "function" | "agent";
     tool: Tool;
@@ -476,10 +477,11 @@ declare class ExuluTool {
         name: string;
         description: string;
     }[];
-    constructor({ id, name, description, inputSchema, type, execute, config }: {
+    constructor({ id, name, description, category, inputSchema, type, execute, config }: {
         id: string;
         name: string;
         description: string;
+        category?: string;
         inputSchema?: z.ZodType;
         type: "context" | "function" | "agent";
         config: {
@@ -563,6 +565,7 @@ declare class ExuluContext {
         fields: ExuluContextFieldDefinition[];
         description: string;
         embedder?: ExuluEmbedder;
+        category?: string;
         active: boolean;
         rateLimit?: RateLimiterRule;
         queryRewriter?: (query: string) => Promise<string>;

package/dist/index.d.ts

@@ -469,6 +469,7 @@ declare class ExuluTool {
     id: string;
     name: string;
     description: string;
+    category: string;
     inputSchema?: z.ZodType;
     type: "context" | "function" | "agent";
     tool: Tool;
@@ -476,10 +477,11 @@ declare class ExuluTool {
         name: string;
         description: string;
     }[];
-    constructor({ id, name, description, inputSchema, type, execute, config }: {
+    constructor({ id, name, description, category, inputSchema, type, execute, config }: {
         id: string;
         name: string;
         description: string;
+        category?: string;
         inputSchema?: z.ZodType;
         type: "context" | "function" | "agent";
         config: {
@@ -563,6 +565,7 @@ declare class ExuluContext {
         fields: ExuluContextFieldDefinition[];
         description: string;
         embedder?: ExuluEmbedder;
+        category?: string;
         active: boolean;
         rateLimit?: RateLimiterRule;
         queryRewriter?: (query: string) => Promise<string>;

package/dist/index.js

@@ -385,7 +385,8 @@ var sanitizeName = (name) => {
 
 // src/registry/classes.ts
 import CryptoJS2 from "crypto-js";
-import "express";
+import "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import "ai/mcp-stdio";
 
 // src/registry/utils/graphql.ts
 import { makeExecutableSchema } from "@graphql-tools/schema";
@@ -2376,7 +2377,7 @@ var applyAccessControl = (table, user, query) => {
   console.log("[EXULU] table.name.plural", table.name.plural);
   if (!user.super_admin && (!user.role || !(table.name.plural === "agents" && (user.role.agents === "read" || user.role.agents === "write")) && !(table.name.plural === "workflow_templates" && (user.role.workflows === "read" || user.role.workflows === "write")) && !(table.name.plural === "variables" && (user.role.variables === "read" || user.role.variables === "write")) && !(table.name.plural === "users" && (user.role.users === "read" || user.role.users === "write")) && !((table.name.plural === "test_cases" || table.name.plural === "eval_sets" || table.name.plural === "eval_runs") && (user.role.evals === "read" || user.role.evals === "write")))) {
     console.error("==== Access control error: no role found or no access to entity type. ====");
-    return query.where("id", "=", "0");
+    throw new Error("Access control error: no role found or no access to entity type.");
   }
   const hasRBAC = table.RBAC === true;
   console.log("[EXULU] hasRBAC", hasRBAC);
@@ -2480,11 +2481,14 @@ var addAgentFields = async (requestedFields, agents, result, tools, user) => {
         } else {
           hydrated = tools.find((t) => t.id === tool2.id);
         }
-        return {
+        const hydratedTool = {
           ...tool2,
           name: hydrated?.name || "",
-          description: hydrated?.description || ""
+          description: hydrated?.description || "",
+          category: tool2?.category || "default"
         };
+        console.log("[EXULU] hydratedTool", hydratedTool);
+        return hydratedTool;
       }));
       result.tools = result.tools.filter((tool2) => tool2 !== null);
     } else {
@@ -3428,7 +3432,8 @@ type PageInfo {
     deleteJob(queue: QueueEnum!, id: String!): JobActionReturnPayload
     `;
   typeDefs += `
-   tools: ToolPaginationResult
+   tools(search: String, category: String, limit: Int, page: Int): ToolPaginationResult
+   toolCategories: [String!]!
     `;
   typeDefs += `
    jobs(queue: QueueEnum!, statusses: [JobStateEnum!]): JobPaginationResult
@@ -3748,6 +3753,7 @@ type PageInfo {
   };
   resolvers.Query["tools"] = async (_, args, context, info) => {
     const requestedFields = getRequestedFields(info);
+    const { search, category, limit = 100, page = 0 } = args;
     const instances = await loadAgents();
     let agentTools = await Promise.all(
       instances.map(async (instance) => {
@@ -3759,16 +3765,39 @@ type PageInfo {
       })
     );
     const filtered = agentTools.filter((tool2) => tool2 !== null);
+    let allTools = [...filtered, ...tools];
+    if (search && search.trim()) {
+      const searchTerm = search.toLowerCase().trim();
+      allTools = allTools.filter(
+        (tool2) => tool2.name?.toLowerCase().includes(searchTerm) || tool2.description?.toLowerCase().includes(searchTerm)
+      );
+    }
+    if (category && category.trim()) {
+      allTools = allTools.filter((tool2) => tool2.category === category);
+    }
+    const total = allTools.length;
+    const start = page * limit;
+    const end = start + limit;
+    const paginatedTools = allTools.slice(start, end);
     return {
-      items: [...filtered, ...tools].map((tool2) => {
+      items: paginatedTools.map((tool2) => {
         const object = {};
         requestedFields.forEach((field) => {
           object[field] = tool2[field];
         });
         return object;
-      })
+      }),
+      total,
+      page,
+      limit
     };
   };
+  resolvers.Query["toolCategories"] = async () => {
+    const array = tools.map((tool2) => tool2.category).filter((category) => category && typeof category === "string");
+    array.push("contexts");
+    array.push("agents");
+    return [...new Set(array)].sort();
+  };
   modelDefs += `
     type ProviderPaginationResult {
         items: [Provider]!
@@ -3807,6 +3836,9 @@ type PageInfo {
   modelDefs += `
     type ToolPaginationResult {
     items: [Tool]!
+    total: Int!
+    page: Int!
+    limit: Int!
     }
     `;
   modelDefs += `
@@ -3916,6 +3948,7 @@ type Tool {
   id: ID!
   name: String!
   description: String
+  category: String
   type: String
   config: JSON
 }
@@ -4566,6 +4599,7 @@ var createUppyRoutes = async (app, config) => {
 };
 
 // src/registry/classes.ts
+import "@modelcontextprotocol/sdk/server/streamableHttp.js";
 var s3Client2;
 function sanitizeToolName(name) {
   if (typeof name !== "string") return "";
@@ -4584,12 +4618,6 @@ var convertToolsArrayToObject = (currentTools, allExuluTools, configs, providera
     name: sanitizeToolName(tool2.name)
   })) : [];
   console.log("[EXULU] Sanitized tools", sanitizedTools.map((x) => x.name + " (" + x.id + ")"));
-  const askForConfirmation = {
-    description: "Ask the user for confirmation.",
-    inputSchema: z.object({
-      message: z.string().describe("The message to ask for confirmation.")
-    })
-  };
   return {
     ...sanitizedTools?.reduce(
       (prev, cur) => ({
@@ -4688,8 +4716,8 @@ var convertToolsArrayToObject = (currentTools, allExuluTools, configs, providera
         }
       }),
       {}
-    ),
-    askForConfirmation
+    )
+    // askForConfirmation
   };
 };
 var hydrateVariables = async (tool2) => {
@@ -4823,6 +4851,7 @@ var ExuluAgent2 = class {
       id: agentInstance.id,
       name: `${agentInstance.name}`,
       type: "agent",
+      category: "agents",
       inputSchema: z.object({
         prompt: z.string().describe("The prompt (usually a question for the agent) to send to the agent."),
         information: z.string().describe("A summary of relevant context / information from the current session")
@@ -5251,13 +5280,15 @@ var ExuluTool2 = class {
   id;
   name;
   description;
+  category;
   inputSchema;
   type;
   tool;
   config;
-  constructor({ id, name, description, inputSchema, type, execute: execute2, config }) {
+  constructor({ id, name, description, category, inputSchema, type, execute: execute2, config }) {
     this.id = id;
     this.config = config;
+    this.category = category || "default";
     this.name = name;
     this.description = description;
     this.inputSchema = inputSchema;
@@ -5686,6 +5717,7 @@ var ExuluContext = class {
       id: this.id,
       name: `${this.name}`,
       type: "context",
+      category: "contexts",
       inputSchema: z.object({
         query: z.string()
       }),
@@ -5723,7 +5755,6 @@ var ExuluContext = class {
   };
 };
 var updateStatistic = async (statistic) => {
-  console.log("[EXULU] Updating statistic", statistic);
   const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   const { db: db3 } = await postgresClient();
   const existing = await db3.from("tracking").where({
@@ -5734,7 +5765,6 @@ var updateStatistic = async (statistic) => {
     type: statistic.type,
     createdAt: currentDate
   }).first();
-  console.log("[EXULU] Existing", existing);
   if (!existing) {
     await db3.from("tracking").insert({
       name: statistic.name,
@@ -5846,7 +5876,7 @@ var CLAUDE_MESSAGES = {
 };
 
 // src/registry/routes.ts
-import { createIdGenerator as createIdGenerator2 } from "ai";
+import { createIdGenerator } from "ai";
 var REQUEST_SIZE_LIMIT = "50mb";
 var global_queues = {
   eval_runs: "eval_runs"
@@ -6201,7 +6231,7 @@ Mood: friendly and intelligent.
             console.error("[EXULU] chat response error.", error);
             return errorHandler(error);
           },
-          generateMessageId: createIdGenerator2({
+          generateMessageId: createIdGenerator({
             prefix: "msg_",
             size: 16
           }),
@@ -7135,7 +7165,7 @@ function getAverage(arr) {
 // src/mcp/index.ts
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { randomUUID as randomUUID4 } from "crypto";
-import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { StreamableHTTPServerTransport as StreamableHTTPServerTransport2 } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 import { z as z2 } from "zod";
 import "express";
@@ -7225,7 +7255,7 @@ ${code}`
       if (sessionId && this.transports[sessionId]) {
         transport = this.transports[sessionId];
       } else if (!sessionId && isInitializeRequest(req.body)) {
-        transport = new StreamableHTTPServerTransport({
+        transport = new StreamableHTTPServerTransport2({
           sessionIdGenerator: () => randomUUID4(),
           onsessioninitialized: (sessionId2) => {
             this.transports[sessionId2] = transport;
@@ -8071,6 +8101,7 @@ var additionTool = new ExuluTool2({
   name: "Addition",
   description: "Adds two numbers together",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     firstNumber: z4.number().describe("The first addend"),
@@ -8086,6 +8117,7 @@ var subtractionTool = new ExuluTool2({
   name: "Subtraction",
   description: "Subtracts the second number from the first number",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     minuend: z4.number().describe("The number to subtract from (minuend)"),
@@ -8101,6 +8133,7 @@ var multiplicationTool = new ExuluTool2({
   name: "Multiplication",
   description: "Multiplies two numbers together",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     firstNumber: z4.number().describe("The first number"),
@@ -8116,6 +8149,7 @@ var divisionTool = new ExuluTool2({
   name: "Division",
   description: "Divides the first number by the second number",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numerator: z4.number().describe("The number being divided (numerator)"),
@@ -8131,6 +8165,7 @@ var sumTool = new ExuluTool2({
   name: "Sum",
   description: "Adds any number of numbers together",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numbers: z4.array(z4.number()).min(1).describe("Array of numbers to sum")
@@ -8145,6 +8180,7 @@ var moduloTool = new ExuluTool2({
   name: "Modulo",
   description: "Divides two numbers and returns the remainder",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numerator: z4.number().describe("The number being divided (numerator)"),
@@ -8160,6 +8196,7 @@ var meanTool = new ExuluTool2({
   name: "Mean",
   description: "Calculates the arithmetic mean of a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numbers: z4.array(z4.number()).min(1).describe("Array of numbers to find the mean of")
@@ -8174,6 +8211,7 @@ var medianTool = new ExuluTool2({
   name: "Median",
   description: "Calculates the median of a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numbers: z4.array(z4.number()).min(1).describe("Array of numbers to find the median of")
@@ -8188,6 +8226,7 @@ var modeTool = new ExuluTool2({
   name: "Mode",
   description: "Finds the most common number in a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numbers: z4.array(z4.number()).describe("Array of numbers to find the mode of")
@@ -8202,6 +8241,7 @@ var minTool = new ExuluTool2({
   name: "Minimum",
   description: "Finds the minimum value from a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numbers: z4.array(z4.number()).describe("Array of numbers to find the minimum of")
@@ -8216,6 +8256,7 @@ var maxTool = new ExuluTool2({
   name: "Maximum",
   description: "Finds the maximum value from a list of numbers",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     numbers: z4.array(z4.number()).describe("Array of numbers to find the maximum of")
@@ -8230,6 +8271,7 @@ var floorTool = new ExuluTool2({
   name: "Floor",
   description: "Rounds a number down to the nearest integer",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number to round down")
@@ -8244,6 +8286,7 @@ var ceilingTool = new ExuluTool2({
   name: "Ceiling",
   description: "Rounds a number up to the nearest integer",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number to round up")
@@ -8258,6 +8301,7 @@ var roundTool = new ExuluTool2({
   name: "Round",
   description: "Rounds a number to the nearest integer",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number to round")
@@ -8272,6 +8316,7 @@ var sinTool = new ExuluTool2({
   name: "Sine",
   description: "Calculates the sine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number in radians to find the sine of")
@@ -8286,6 +8331,7 @@ var arcsinTool = new ExuluTool2({
   name: "Arcsine",
   description: "Calculates the arcsine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number to find the arcsine of")
@@ -8300,6 +8346,7 @@ var cosTool = new ExuluTool2({
   name: "Cosine",
   description: "Calculates the cosine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number in radians to find the cosine of")
@@ -8314,6 +8361,7 @@ var arccosTool = new ExuluTool2({
   name: "Arccosine",
   description: "Calculates the arccosine of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number to find the arccosine of")
@@ -8328,6 +8376,7 @@ var tanTool = new ExuluTool2({
   name: "Tangent",
   description: "Calculates the tangent of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number in radians to find the tangent of")
@@ -8342,6 +8391,7 @@ var arctanTool = new ExuluTool2({
   name: "Arctangent",
   description: "Calculates the arctangent of a number in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number to find the arctangent of")
@@ -8356,6 +8406,7 @@ var radiansToDegreesTool = new ExuluTool2({
   name: "Radians to Degrees",
   description: "Converts a radian value to its equivalent in degrees",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number in radians to convert to degrees")
@@ -8370,6 +8421,7 @@ var degreesToRadiansTool = new ExuluTool2({
   name: "Degrees to Radians",
   description: "Converts a degree value to its equivalent in radians",
   type: "function",
+  category: "math",
   config: [],
   inputSchema: z4.object({
     number: z4.number().describe("The number in degrees to convert to radians")
@@ -8448,10 +8500,10 @@ var ExuluApp = class {
   // Factory function so we can async 
   // initialize the MCP server if needed.
   create = async ({ contexts, agents, config, tools, evals }) => {
-    this._evals = [
+    this._evals = redisServer.host?.length && redisServer.port?.length ? [
       llmAsJudgeEval,
       ...evals ?? []
-    ];
+    ] : [];
     this._contexts = {
       ...contexts,
       codeStandardsContext,
@@ -8481,6 +8533,7 @@ var ExuluApp = class {
       // Because agents are stored in the database,  we add those as tools
       // at request time, not during ExuluApp initialization. We add them
       // in the grahql tools resolver.
+      // ...mcpTools
     ];
     const checks = [
       ...Object.keys(this._contexts || {}).map((x) => ({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exulu/backend",
   "author": "Qventu Bv.",
-  "version": "1.29.0",
+  "version": "1.30.1",
   "main": "./dist/index.js",
   "private": false,
   "publishConfig": {

package/types/models/tool.ts

@@ -5,4 +5,5 @@ export interface Tool {
     type: string;
     inputSchema: any;
     outputSchema: any;
+    category: string;
 }