@exulu/backend 1.61.3 → 1.62.1

package/dist/{chunk-PFKAWGB6.js → chunk-4TCN467I.js}

@@ -220,7 +220,8 @@ import { resolve } from "path";
 var MAX_CRASHES = 5;
 var INITIAL_BACKOFF_MS = 1e3;
 var MAX_BACKOFF_MS = 3e4;
-var READY_TIMEOUT_MS = 3e4;
+var READY_TIMEOUT_MS = 9e4;
+var WAIT_TIMEOUT_MS = 6e4;
 var READY_POLL_INTERVAL_MS = 200;
 var SHUTDOWN_GRACE_MS = 5e3;
 var internal = {
@@ -236,7 +237,7 @@ var resolveConfig = (packageRoot) => {
   const host = process.env.LITELLM_HOST ?? "127.0.0.1";
   const port = process.env.LITELLM_PORT ?? "4000";
   const masterKey = process.env.LITELLM_MASTER_KEY;
-  const configPath = process.env.LITELLM_CONFIG_PATH ?? resolve(packageRoot, "./config.litellm.yaml");
+  const configPath = process.env.LITELLM_CONFIG_PATH ?? resolve(process.cwd(), "./config.litellm.yaml");
   const venvBin = resolve(packageRoot, "ee/python/.venv/bin");
   const venvPython = resolve(venvBin, "python");
   const litellmBin = resolve(venvBin, "litellm");
@@ -263,7 +264,13 @@ var spawnLiteLLM = (cfg) => {
     `Spawning LiteLLM: ${cfg.litellmBin} --config ${cfg.configPath} --port ${cfg.port} --host ${cfg.host}`
   );
   const { DEBUG: _debug, ...rest } = process.env;
-  const childEnv = { ...rest, DEBUG: "false" };
+  const childEnv = {
+    ...rest,
+    DEBUG: "false"
+  };
+  if (process.env.EXULU_LITELLM_UI_PATH && !process.env.SERVER_ROOT_PATH) {
+    childEnv.SERVER_ROOT_PATH = process.env.EXULU_LITELLM_UI_PATH;
+  }
   const child = spawn(
     cfg.litellmBin,
     [
@@ -388,10 +395,18 @@ var startLiteLLMSupervisor = async (options = {}) => {
 var waitForLiteLLMReady = async () => {
   if (!isLiteLLMEnabled()) return;
   if (!internal.readyPromise) {
-    await startLiteLLMSupervisor();
-    return;
+    return startLiteLLMSupervisor();
   }
-  return internal.readyPromise;
+  const deadline = Date.now() + WAIT_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    const s = getSupervisorState();
+    if (s === "ready") return;
+    if (s === "given_up") {
+      throw new Error("LiteLLM supervisor has given up.");
+    }
+    await new Promise((r) => setTimeout(r, READY_POLL_INTERVAL_MS));
+  }
+  throw new Error("Timed out waiting for LiteLLM to become ready.");
 };
 var stopLiteLLM = (signal = "SIGTERM") => {
   internal.shutdownRequested = true;
@@ -418,6 +433,7 @@ var registerShutdownHandlers = () => {
   process.on("SIGTERM", () => stopLiteLLM("SIGTERM"));
   process.on("exit", () => stopLiteLLM("SIGTERM"));
 };
+var getSupervisorState = () => internal.state;
 
 // src/exulu/tags.ts
 var MAX_LEN = 63;
@@ -577,7 +593,17 @@ var getLiteLLMProvider = ({
     name: "litellm",
     baseURL: `http://${host}:${port}/v1`,
     apiKey: masterKey,
-    fetch: createTaggedFetch(tags)
+    fetch: createTaggedFetch(tags),
+    // Without this flag the openai-compatible provider strips any
+    // responseFormat.schema before sending and warns
+    // "JSON response format schema is only supported with structuredOutputs".
+    // Models then return free-form JSON that fails Zod parsing in callers
+    // using `Output.object({ schema })`. LiteLLM forwards
+    // `response_format: { type: "json_schema", ... }` to every upstream it
+    // supports — including Vertex Gemini, which translates it into
+    // responseSchema/responseMimeType — so enabling this matches the actual
+    // proxy contract.
+    supportsStructuredOutputs: true
   });
   return _litellmProvider;
 };
@@ -744,7 +770,7 @@ var ExuluTool = class {
       });
       providerapikey = resolved.apiKey;
     }
-    const { convertExuluToolsToAiSdkTools: convertExuluToolsToAiSdkTools2 } = await import("./convert-exulu-tools-to-ai-sdk-tools-VRZ45OGI.js");
+    const { convertExuluToolsToAiSdkTools: convertExuluToolsToAiSdkTools2 } = await import("./convert-exulu-tools-to-ai-sdk-tools-FZ4ZCVBZ.js");
     const tools = await convertExuluToolsToAiSdkTools2(
       [this],
       [],

package/dist/{convert-exulu-tools-to-ai-sdk-tools-VRZ45OGI.js → convert-exulu-tools-to-ai-sdk-tools-FZ4ZCVBZ.js}

@@ -1,6 +1,6 @@
 import {
   convertExuluToolsToAiSdkTools
-} from "./chunk-PFKAWGB6.js";
+} from "./chunk-4TCN467I.js";
 export {
   convertExuluToolsToAiSdkTools
 };

package/dist/index.cjs

@@ -376,7 +376,7 @@ var init_statistics = __esm({
 });
 
 // src/exulu/litellm/supervisor.ts
-var import_node_child_process, import_node_fs, import_node_path, MAX_CRASHES, INITIAL_BACKOFF_MS, MAX_BACKOFF_MS, READY_TIMEOUT_MS, READY_POLL_INTERVAL_MS, SHUTDOWN_GRACE_MS, internal, isLiteLLMEnabled, resolveConfig, log, pollHealth, spawnLiteLLM, supervise, _packageRoot, setLiteLLMPackageRoot, startLiteLLMSupervisor, waitForLiteLLMReady, stopLiteLLM, shutdownHandlersRegistered, registerShutdownHandlers;
+var import_node_child_process, import_node_fs, import_node_path, MAX_CRASHES, INITIAL_BACKOFF_MS, MAX_BACKOFF_MS, READY_TIMEOUT_MS, WAIT_TIMEOUT_MS, READY_POLL_INTERVAL_MS, SHUTDOWN_GRACE_MS, internal, isLiteLLMEnabled, resolveConfig, log, pollHealth, spawnLiteLLM, supervise, _packageRoot, setLiteLLMPackageRoot, startLiteLLMSupervisor, waitForLiteLLMReady, stopLiteLLM, shutdownHandlersRegistered, registerShutdownHandlers, getSupervisorState;
 var init_supervisor = __esm({
   "src/exulu/litellm/supervisor.ts"() {
     "use strict";
@@ -387,7 +387,8 @@ var init_supervisor = __esm({
     MAX_CRASHES = 5;
     INITIAL_BACKOFF_MS = 1e3;
     MAX_BACKOFF_MS = 3e4;
-    READY_TIMEOUT_MS = 3e4;
+    READY_TIMEOUT_MS = 9e4;
+    WAIT_TIMEOUT_MS = 6e4;
     READY_POLL_INTERVAL_MS = 200;
     SHUTDOWN_GRACE_MS = 5e3;
     internal = {
@@ -403,7 +404,7 @@ var init_supervisor = __esm({
       const host = process.env.LITELLM_HOST ?? "127.0.0.1";
       const port = process.env.LITELLM_PORT ?? "4000";
       const masterKey = process.env.LITELLM_MASTER_KEY;
-      const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path.resolve)(packageRoot, "./config.litellm.yaml");
+      const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path.resolve)(process.cwd(), "./config.litellm.yaml");
       const venvBin = (0, import_node_path.resolve)(packageRoot, "ee/python/.venv/bin");
       const venvPython = (0, import_node_path.resolve)(venvBin, "python");
       const litellmBin = (0, import_node_path.resolve)(venvBin, "litellm");
@@ -430,7 +431,13 @@ var init_supervisor = __esm({
         `Spawning LiteLLM: ${cfg.litellmBin} --config ${cfg.configPath} --port ${cfg.port} --host ${cfg.host}`
       );
       const { DEBUG: _debug, ...rest } = process.env;
-      const childEnv = { ...rest, DEBUG: "false" };
+      const childEnv = {
+        ...rest,
+        DEBUG: "false"
+      };
+      if (process.env.EXULU_LITELLM_UI_PATH && !process.env.SERVER_ROOT_PATH) {
+        childEnv.SERVER_ROOT_PATH = process.env.EXULU_LITELLM_UI_PATH;
+      }
       const child = (0, import_node_child_process.spawn)(
         cfg.litellmBin,
         [
@@ -554,10 +561,18 @@ var init_supervisor = __esm({
     waitForLiteLLMReady = async () => {
       if (!isLiteLLMEnabled()) return;
       if (!internal.readyPromise) {
-        await startLiteLLMSupervisor();
-        return;
+        return startLiteLLMSupervisor();
       }
-      return internal.readyPromise;
+      const deadline = Date.now() + WAIT_TIMEOUT_MS;
+      while (Date.now() < deadline) {
+        const s = getSupervisorState();
+        if (s === "ready") return;
+        if (s === "given_up") {
+          throw new Error("LiteLLM supervisor has given up.");
+        }
+        await new Promise((r) => setTimeout(r, READY_POLL_INTERVAL_MS));
+      }
+      throw new Error("Timed out waiting for LiteLLM to become ready.");
     };
     stopLiteLLM = (signal = "SIGTERM") => {
       internal.shutdownRequested = true;
@@ -584,6 +599,7 @@ var init_supervisor = __esm({
       process.on("SIGTERM", () => stopLiteLLM("SIGTERM"));
       process.on("exit", () => stopLiteLLM("SIGTERM"));
     };
+    getSupervisorState = () => internal.state;
   }
 });
 
@@ -1002,7 +1018,17 @@ var init_resolve_model = __esm({
         name: "litellm",
         baseURL: `http://${host}:${port}/v1`,
         apiKey: masterKey,
-        fetch: createTaggedFetch(tags)
+        fetch: createTaggedFetch(tags),
+        // Without this flag the openai-compatible provider strips any
+        // responseFormat.schema before sending and warns
+        // "JSON response format schema is only supported with structuredOutputs".
+        // Models then return free-form JSON that fails Zod parsing in callers
+        // using `Output.object({ schema })`. LiteLLM forwards
+        // `response_format: { type: "json_schema", ... }` to every upstream it
+        // supports — including Vertex Gemini, which translates it into
+        // responseSchema/responseMimeType — so enabling this matches the actual
+        // proxy contract.
+        supportsStructuredOutputs: true
       });
       return _litellmProvider;
     };
@@ -13034,30 +13060,6 @@ type LiteLLMModel {
         pageInfo: PageInfo!
     }
     `;
-  typeDefs += `
-   agentWorldAgents: [AgentWorldAgent!]!
-  `;
-  resolvers.Query["agentWorldAgents"] = async (_, _args, context) => {
-    const { db: db2 } = context;
-    const sessions = await db2("agent_sessions as s").select([
-      "s.id as sessionId",
-      "s.agent as agentId",
-      "s.currenttask as currentTask",
-      "s.createdAt as lastActivityAt",
-      "s.created_by as userId"
-    ]).whereNotNull("s.currenttask").limit(20).orderBy("s.createdAt", "desc");
-    return sessions.map((row) => {
-      const agent = providers.find((p) => p.id === row.agentId);
-      return {
-        sessionId: row.sessionId,
-        agentId: row.agentId ?? "",
-        agentName: agent?.name ?? row.agentId ?? "Agent",
-        agentImage: agent?.image ?? null,
-        currentTask: row.currentTask,
-        lastActivityAt: row.lastActivityAt
-      };
-    });
-  };
   typeDefs += "}\n";
   mutationDefs += "}\n";
   const genericTypes = `
@@ -13272,15 +13274,6 @@ type StatisticsResult {
   group: String!
   count: Int!
 }
-
-type AgentWorldAgent {
-  sessionId: ID!
-  agentId: ID!
-  agentName: String!
-  agentImage: String
-  currentTask: String
-  lastActivityAt: String
-}
 `;
   const fullSDL = typeDefs + mutationDefs + modelDefs + genericTypes;
   const schema = (0, import_schema.makeExecutableSchema)({
@@ -13491,7 +13484,7 @@ var import_utils5 = require("@apollo/utils.keyvaluecache");
 var import_body_parser = __toESM(require("body-parser"), 1);
 var import_crypto_js8 = __toESM(require("crypto-js"), 1);
 var import_openai = __toESM(require("openai"), 1);
-var import_fs4 = __toESM(require("fs"), 1);
+var import_fs3 = __toESM(require("fs"), 1);
 var import_node_crypto5 = require("crypto");
 var import_api2 = require("@opentelemetry/api");
 init_check_record_access();
@@ -13574,7 +13567,7 @@ async function clearSessionCurrentTask(session) {
 }
 
 // src/exulu/provider.ts
-var import_fs2 = __toESM(require("fs"), 1);
+var import_fs2 = require("fs");
 var ExuluProvider = class {
   // Must begin with a letter (a-z) or underscore (_). Subsequent characters in a name can be letters, digits (0-9), or
   // underscores and be a max length of 80 characters and at least 5 characters long.
@@ -14237,7 +14230,6 @@ ${extractedText}
         // todo make this configurable?
         page: 1
       });
-      import_fs2.default.writeFileSync("pre-fetched-relevant-information.json", JSON.stringify(result2, null, 2));
       if (result2?.chunks?.length) {
         memoryItems = result2.chunks;
         memoryContext = `
@@ -14888,212 +14880,6 @@ See docs/superpowers/specs/2026-05-31-in-chat-image-generation-design.md for the
 
 // src/exulu/routes.ts
 var import_node_path5 = require("path");
-
-// src/utils/python-setup.ts
-init_cjs_shims();
-var import_child_process = require("child_process");
-var import_util = require("util");
-var import_path = require("path");
-var import_fs3 = require("fs");
-var import_url = require("url");
-var execAsync4 = (0, import_util.promisify)(import_child_process.exec);
-function getPackageRoot() {
-  const currentFile = (0, import_url.fileURLToPath)(importMetaUrl);
-  let currentDir = (0, import_path.dirname)(currentFile);
-  let attempts = 0;
-  const maxAttempts = 10;
-  while (attempts < maxAttempts) {
-    const packageJsonPath = (0, import_path.join)(currentDir, "package.json");
-    if ((0, import_fs3.existsSync)(packageJsonPath)) {
-      try {
-        const packageJson = JSON.parse((0, import_fs3.readFileSync)(packageJsonPath, "utf-8"));
-        if (packageJson.name === "@exulu/backend") {
-          return currentDir;
-        }
-      } catch {
-      }
-    }
-    const parentDir = (0, import_path.resolve)(currentDir, "..");
-    if (parentDir === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-    attempts++;
-  }
-  const fallback = (0, import_path.resolve)((0, import_path.dirname)((0, import_url.fileURLToPath)(importMetaUrl)), "../..");
-  return fallback;
-}
-function getSetupScriptPath(packageRoot) {
-  return (0, import_path.resolve)(packageRoot, "ee/python/setup.sh");
-}
-function getVenvPath(packageRoot) {
-  return (0, import_path.resolve)(packageRoot, "ee/python/.venv");
-}
-function isPythonEnvironmentSetup(packageRoot) {
-  const root = packageRoot ?? getPackageRoot();
-  const venvPath = getVenvPath(root);
-  const pythonPath = (0, import_path.join)(venvPath, "bin", "python");
-  return (0, import_fs3.existsSync)(venvPath) && (0, import_fs3.existsSync)(pythonPath);
-}
-async function setupPythonEnvironment(options = {}) {
-  const {
-    packageRoot = getPackageRoot(),
-    force = false,
-    verbose = false,
-    timeout = 6e5
-    // 10 minutes
-  } = options;
-  if (!force && isPythonEnvironmentSetup(packageRoot)) {
-    if (verbose) {
-      console.log("\u2713 Python environment already set up");
-    }
-    return {
-      success: true,
-      message: "Python environment already exists",
-      alreadyExists: true
-    };
-  }
-  const setupScriptPath = getSetupScriptPath(packageRoot);
-  if (!(0, import_fs3.existsSync)(setupScriptPath)) {
-    return {
-      success: false,
-      message: `Setup script not found at: ${setupScriptPath}`,
-      alreadyExists: false
-    };
-  }
-  try {
-    if (verbose) {
-      console.log("Setting up Python environment...");
-    }
-    const { stdout, stderr } = await execAsync4(`bash "${setupScriptPath}"`, {
-      cwd: packageRoot,
-      timeout,
-      env: {
-        ...process.env,
-        // Ensure script can write to the directory
-        PYTHONDONTWRITEBYTECODE: "1"
-      },
-      maxBuffer: 10 * 1024 * 1024
-      // 10MB buffer
-    });
-    const output = stdout + stderr;
-    const versionMatch = output.match(/Python (\d+\.\d+\.\d+)/);
-    const pythonVersion = versionMatch ? versionMatch[1] : void 0;
-    if (verbose) {
-      console.log(output);
-    }
-    return {
-      success: true,
-      message: "Python environment set up successfully",
-      alreadyExists: false,
-      pythonVersion,
-      output
-    };
-  } catch (error) {
-    const errorOutput = error.stdout + error.stderr;
-    return {
-      success: false,
-      message: `Setup failed: ${error.message}`,
-      alreadyExists: false,
-      output: errorOutput
-    };
-  }
-}
-function getPythonSetupInstructions() {
-  return `
-Python environment not set up. Please run one of the following commands:
-
-Option 1 (Automatic):
-  import { setupPythonEnvironment } from '@exulu/backend';
-  await setupPythonEnvironment();
-
-Option 2 (Manual - for package consumers):
-  npx @exulu/backend setup-python
-
-Option 3 (Manual - for contributors):
-  npm run python:setup
-
-These commands will automatically create a Python virtual environment (.venv)
-in the @exulu/backend package and install all required dependencies.
-
-Requirements:
-  - Python 3.10 or higher must be installed
-  - pip must be available
-  - venv module must be available (for creating virtual environments)
-
-If Python dependencies are not installed, install them first, then run one of the commands above:
-  - macOS: brew install python@3.12
-  - Ubuntu/Debian: sudo apt-get install python3.12 python3-pip python3-venv
-  - Alpine Linux: apk add python3 py3-pip python3-dev
-  - Windows: Download from https://www.python.org/downloads/
-
-Note: In Docker containers, ensure you install all three components:
-  Ubuntu/Debian: apt-get install -y python3 python3-pip python3-venv
-  Alpine: apk add python3 py3-pip python3-dev
-`.trim();
-}
-async function validatePythonEnvironment(packageRoot, checkPackages = true) {
-  const root = packageRoot ?? getPackageRoot();
-  const venvPath = getVenvPath(root);
-  const pythonPath = (0, import_path.join)(venvPath, "bin", "python");
-  if (!(0, import_fs3.existsSync)(venvPath)) {
-    return {
-      valid: false,
-      message: getPythonSetupInstructions()
-    };
-  }
-  if (!(0, import_fs3.existsSync)(pythonPath)) {
-    return {
-      valid: false,
-      message: "Python virtual environment is corrupted. Please run:\n  await setupPythonEnvironment({ force: true })"
-    };
-  }
-  try {
-    await execAsync4(`"${pythonPath}" --version`, { cwd: root });
-  } catch {
-    return {
-      valid: false,
-      message: "Python executable is not working. Please run:\n  await setupPythonEnvironment({ force: true })"
-    };
-  }
-  if (checkPackages) {
-    const criticalPackages = ["docling", "transformers"];
-    const missingPackages = [];
-    for (const pkg of criticalPackages) {
-      try {
-        await execAsync4(`"${pythonPath}" -c "import ${pkg}"`, {
-          cwd: root,
-          timeout: 1e4
-          // 10 second timeout per import check
-        });
-      } catch {
-        missingPackages.push(pkg);
-      }
-    }
-    if (missingPackages.length > 0) {
-      return {
-        valid: false,
-        message: `Python environment exists but required packages are not installed: ${missingPackages.join(", ")}
-
-This usually happens when:
-1. The .venv folder was copied but dependencies were not installed
-2. The package was installed via npm but setup script was not run
-
-Please run:
-  await setupPythonEnvironment({ force: true })
-
-Or manually run the setup script:
-  bash ` + getSetupScriptPath(root)
-      };
-    }
-  }
-  return {
-    valid: true,
-    message: "Python environment is valid"
-  };
-}
-
-// src/exulu/routes.ts
 init_tags();
 var import_multer = __toESM(require("multer"), 1);
 
@@ -15769,7 +15555,7 @@ var REQUEST_SIZE_LIMIT = "50mb";
 var getExuluVersionNumber = async () => {
   try {
     const path3 = process.cwd();
-    const packageJson = import_fs4.default.readFileSync(path3 + "/package.json", "utf8");
+    const packageJson = import_fs3.default.readFileSync(path3 + "/package.json", "utf8");
     const packageData = JSON.parse(packageJson);
     const exuluVersion = packageData.dependencies["@exulu/backend"];
     console.log(`[EXULU] Installed exulu-backend version: ${exuluVersion}`);
@@ -16689,7 +16475,7 @@ ${customInstructions}` : agent.instructions;
   const imageModelsByName = (() => {
     if (!isLiteLLMEnabled() || !config?.fileUploads) return /* @__PURE__ */ new Map();
     try {
-      const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path5.resolve)(getPackageRoot(), "./config.litellm.yaml");
+      const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path5.resolve)(process.cwd(), "./config.litellm.yaml");
       const models2 = parseImageGenerationModels(configPath);
       return new Map(models2.map((m) => [m.model_name, m]));
     } catch (err) {
@@ -17167,6 +16953,80 @@ ${style.markdown}` : params.prompt;
     }));
     res.status(200).json({ history });
   });
+  const litellmUiPath = "/litellm-admin";
+  if (isLiteLLMEnabled() && litellmUiPath) {
+    console.log("[EXULU] Registering LiteLLM UI at", litellmUiPath);
+    app.use(litellmUiPath, async (req, res) => {
+      const host = process.env.LITELLM_HOST ?? "127.0.0.1";
+      const port = process.env.LITELLM_PORT ?? "4000";
+      const upstreamUrl = `http://${host}:${port}${litellmUiPath}${req.url}`;
+      const upstreamHeaders = {};
+      for (const [name, value] of Object.entries(req.headers)) {
+        if (value === void 0) continue;
+        const lower = name.toLowerCase();
+        if (lower === "host" || lower === "content-length" || lower === "connection" || lower === "transfer-encoding" || lower === "accept-encoding")
+          continue;
+        upstreamHeaders[name] = Array.isArray(value) ? value.join(", ") : value;
+      }
+      const methodHasBody = !["GET", "HEAD"].includes(req.method);
+      let body;
+      if (methodHasBody && req.body && typeof req.body === "object" && Object.keys(req.body).length > 0) {
+        body = JSON.stringify(req.body);
+        upstreamHeaders["content-type"] = "application/json";
+      }
+      try {
+        const upstream = await fetch(upstreamUrl, {
+          method: req.method,
+          headers: upstreamHeaders,
+          body,
+          // Pass redirects through to the browser so LiteLLM's post-login
+          // redirect lands the user on the right URL (the Location already
+          // includes SERVER_ROOT_PATH).
+          redirect: "manual"
+        });
+        res.status(upstream.status);
+        const upstreamOrigin = `http://${host}:${port}`;
+        upstream.headers.forEach((value, name) => {
+          const lower = name.toLowerCase();
+          if (lower === "content-encoding" || lower === "content-length" || lower === "transfer-encoding" || lower === "connection")
+            return;
+          if (lower === "location") {
+            let loc = value.startsWith(upstreamOrigin) ? value.slice(upstreamOrigin.length) : value;
+            if (loc.startsWith("/") && loc !== litellmUiPath && !loc.startsWith(`${litellmUiPath}/`)) {
+              loc = `${litellmUiPath}${loc}`;
+            }
+            res.setHeader(name, loc);
+            return;
+          }
+          res.setHeader(name, value);
+        });
+        if (!upstream.body) {
+          res.end();
+          return;
+        }
+        const reader = upstream.body.getReader();
+        try {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            if (value) res.write(value);
+          }
+        } finally {
+          reader.releaseLock();
+        }
+        res.end();
+      } catch (err) {
+        console.error("[EXULU] LiteLLM UI proxy failed", err);
+        if (!res.headersSent) {
+          res.status(502).json({
+            detail: err instanceof Error ? err.message : "LiteLLM UI proxy failed."
+          });
+        } else {
+          res.end();
+        }
+      }
+    });
+  }
   app.use("/litellm/:project", async (req, res) => {
     if (!isLiteLLMEnabled()) {
       res.status(503).json({
@@ -20676,6 +20536,210 @@ init_entitlements();
 init_system_dependencies();
 init_supervisor();
 
+// src/utils/python-setup.ts
+init_cjs_shims();
+var import_child_process = require("child_process");
+var import_util = require("util");
+var import_path = require("path");
+var import_fs4 = require("fs");
+var import_url = require("url");
+var execAsync4 = (0, import_util.promisify)(import_child_process.exec);
+function getPackageRoot() {
+  const currentFile = (0, import_url.fileURLToPath)(importMetaUrl);
+  let currentDir = (0, import_path.dirname)(currentFile);
+  let attempts = 0;
+  const maxAttempts = 10;
+  while (attempts < maxAttempts) {
+    const packageJsonPath = (0, import_path.join)(currentDir, "package.json");
+    if ((0, import_fs4.existsSync)(packageJsonPath)) {
+      try {
+        const packageJson = JSON.parse((0, import_fs4.readFileSync)(packageJsonPath, "utf-8"));
+        if (packageJson.name === "@exulu/backend") {
+          return currentDir;
+        }
+      } catch {
+      }
+    }
+    const parentDir = (0, import_path.resolve)(currentDir, "..");
+    if (parentDir === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
+    attempts++;
+  }
+  const fallback = (0, import_path.resolve)((0, import_path.dirname)((0, import_url.fileURLToPath)(importMetaUrl)), "../..");
+  return fallback;
+}
+function getSetupScriptPath(packageRoot) {
+  return (0, import_path.resolve)(packageRoot, "ee/python/setup.sh");
+}
+function getVenvPath(packageRoot) {
+  return (0, import_path.resolve)(packageRoot, "ee/python/.venv");
+}
+function isPythonEnvironmentSetup(packageRoot) {
+  const root = packageRoot ?? getPackageRoot();
+  const venvPath = getVenvPath(root);
+  const pythonPath = (0, import_path.join)(venvPath, "bin", "python");
+  return (0, import_fs4.existsSync)(venvPath) && (0, import_fs4.existsSync)(pythonPath);
+}
+async function setupPythonEnvironment(options = {}) {
+  const {
+    packageRoot = getPackageRoot(),
+    force = false,
+    verbose = false,
+    timeout = 6e5
+    // 10 minutes
+  } = options;
+  if (!force && isPythonEnvironmentSetup(packageRoot)) {
+    if (verbose) {
+      console.log("\u2713 Python environment already set up");
+    }
+    return {
+      success: true,
+      message: "Python environment already exists",
+      alreadyExists: true
+    };
+  }
+  const setupScriptPath = getSetupScriptPath(packageRoot);
+  if (!(0, import_fs4.existsSync)(setupScriptPath)) {
+    return {
+      success: false,
+      message: `Setup script not found at: ${setupScriptPath}`,
+      alreadyExists: false
+    };
+  }
+  try {
+    if (verbose) {
+      console.log("Setting up Python environment...");
+    }
+    const { stdout, stderr } = await execAsync4(`bash "${setupScriptPath}"`, {
+      cwd: packageRoot,
+      timeout,
+      env: {
+        ...process.env,
+        // Ensure script can write to the directory
+        PYTHONDONTWRITEBYTECODE: "1"
+      },
+      maxBuffer: 10 * 1024 * 1024
+      // 10MB buffer
+    });
+    const output = stdout + stderr;
+    const versionMatch = output.match(/Python (\d+\.\d+\.\d+)/);
+    const pythonVersion = versionMatch ? versionMatch[1] : void 0;
+    if (verbose) {
+      console.log(output);
+    }
+    return {
+      success: true,
+      message: "Python environment set up successfully",
+      alreadyExists: false,
+      pythonVersion,
+      output
+    };
+  } catch (error) {
+    const errorOutput = error.stdout + error.stderr;
+    return {
+      success: false,
+      message: `Setup failed: ${error.message}`,
+      alreadyExists: false,
+      output: errorOutput
+    };
+  }
+}
+function getPythonSetupInstructions() {
+  return `
+Python environment not set up. Please run one of the following commands:
+
+Option 1 (Automatic):
+  import { setupPythonEnvironment } from '@exulu/backend';
+  await setupPythonEnvironment();
+
+Option 2 (Manual - for package consumers):
+  npx @exulu/backend setup-python
+
+Option 3 (Manual - for contributors):
+  npm run python:setup
+
+These commands will automatically create a Python virtual environment (.venv)
+in the @exulu/backend package and install all required dependencies.
+
+Requirements:
+  - Python 3.10 or higher must be installed
+  - pip must be available
+  - venv module must be available (for creating virtual environments)
+
+If Python dependencies are not installed, install them first, then run one of the commands above:
+  - macOS: brew install python@3.12
+  - Ubuntu/Debian: sudo apt-get install python3.12 python3-pip python3-venv
+  - Alpine Linux: apk add python3 py3-pip python3-dev
+  - Windows: Download from https://www.python.org/downloads/
+
+Note: In Docker containers, ensure you install all three components:
+  Ubuntu/Debian: apt-get install -y python3 python3-pip python3-venv
+  Alpine: apk add python3 py3-pip python3-dev
+`.trim();
+}
+async function validatePythonEnvironment(packageRoot, checkPackages = true) {
+  const root = packageRoot ?? getPackageRoot();
+  const venvPath = getVenvPath(root);
+  const pythonPath = (0, import_path.join)(venvPath, "bin", "python");
+  if (!(0, import_fs4.existsSync)(venvPath)) {
+    return {
+      valid: false,
+      message: getPythonSetupInstructions()
+    };
+  }
+  if (!(0, import_fs4.existsSync)(pythonPath)) {
+    return {
+      valid: false,
+      message: "Python virtual environment is corrupted. Please run:\n  await setupPythonEnvironment({ force: true })"
+    };
+  }
+  try {
+    await execAsync4(`"${pythonPath}" --version`, { cwd: root });
+  } catch {
+    return {
+      valid: false,
+      message: "Python executable is not working. Please run:\n  await setupPythonEnvironment({ force: true })"
+    };
+  }
+  if (checkPackages) {
+    const criticalPackages = ["docling", "transformers"];
+    const missingPackages = [];
+    for (const pkg of criticalPackages) {
+      try {
+        await execAsync4(`"${pythonPath}" -c "import ${pkg}"`, {
+          cwd: root,
+          timeout: 1e4
+          // 10 second timeout per import check
+        });
+      } catch {
+        missingPackages.push(pkg);
+      }
+    }
+    if (missingPackages.length > 0) {
+      return {
+        valid: false,
+        message: `Python environment exists but required packages are not installed: ${missingPackages.join(", ")}
+
+This usually happens when:
+1. The .venv folder was copied but dependencies were not installed
+2. The package was installed via npm but setup script was not run
+
+Please run:
+  await setupPythonEnvironment({ force: true })
+
+Or manually run the setup script:
+  bash ` + getSetupScriptPath(root)
+      };
+    }
+  }
+  return {
+    valid: true,
+    message: "Python environment is valid"
+  };
+}
+
 // src/templates/contexts/index.ts
 init_cjs_shims();
 
@@ -20838,6 +20902,12 @@ var ExuluApp = class {
       ...providers ?? []
     ];
     this._config = config;
+    if (isLiteLLMEnabled()) {
+      const uiPath = "/litellm-admin";
+      if (uiPath) {
+        process.env.EXULU_LITELLM_UI_PATH = uiPath;
+      }
+    }
     const transcriptionTools = [];
     if (process.env.TRANSCRIPTION_MODEL && config?.fileUploads && config?.fileUploads?.s3region && config?.fileUploads?.s3key && config?.fileUploads?.s3secret && config?.fileUploads?.s3Bucket) {
       transcriptionTools.push(transcribeTool);
@@ -20845,7 +20915,7 @@ var ExuluApp = class {
     const imageGenerationTools = [];
     const s3Configured = !!config?.fileUploads && !!config.fileUploads.s3region && !!config.fileUploads.s3key && !!config.fileUploads.s3secret && !!config.fileUploads.s3Bucket;
     if (isLiteLLMEnabled() && s3Configured) {
-      const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path7.resolve)(getPackageRoot(), "./config.litellm.yaml");
+      const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path7.resolve)(process.cwd(), "./config.litellm.yaml");
       const imageModels = parseImageGenerationModels(configPath);
       if (imageModels.length > 0) {
         console.log(
@@ -23119,7 +23189,7 @@ ${WARNING_BANNER}`);
 };
 var log3 = (line) => console.log(`[EXULU-LITELLM] ${line}`);
 var initLiteLLMDatabase = async (packageRoot) => {
-  const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path8.resolve)(packageRoot, "./config.litellm.yaml");
+  const configPath = process.env.LITELLM_CONFIG_PATH ?? (0, import_node_path8.resolve)(process.cwd(), "./config.litellm.yaml");
   const safety = checkLiteLLMDatabaseSafety(configPath);
   if (safety.ok && safety.reason === "no-litellm-db-mode") return;
   if (!safety.ok && safety.reason === "unparseable-url") {

package/dist/index.js

@@ -53,7 +53,7 @@ import {
   vectorSearch,
   waitForLiteLLMReady,
   withRetry
-} from "./chunk-PFKAWGB6.js";
+} from "./chunk-4TCN467I.js";
 import {
   findLiteLLMModel
 } from "./chunk-ILAHW4UT.js";
@@ -5182,30 +5182,6 @@ type LiteLLMModel {
         pageInfo: PageInfo!
     }
     `;
-  typeDefs += `
-   agentWorldAgents: [AgentWorldAgent!]!
-  `;
-  resolvers.Query["agentWorldAgents"] = async (_, _args, context) => {
-    const { db } = context;
-    const sessions = await db("agent_sessions as s").select([
-      "s.id as sessionId",
-      "s.agent as agentId",
-      "s.currenttask as currentTask",
-      "s.createdAt as lastActivityAt",
-      "s.created_by as userId"
-    ]).whereNotNull("s.currenttask").limit(20).orderBy("s.createdAt", "desc");
-    return sessions.map((row) => {
-      const agent = providers.find((p) => p.id === row.agentId);
-      return {
-        sessionId: row.sessionId,
-        agentId: row.agentId ?? "",
-        agentName: agent?.name ?? row.agentId ?? "Agent",
-        agentImage: agent?.image ?? null,
-        currentTask: row.currentTask,
-        lastActivityAt: row.lastActivityAt
-      };
-    });
-  };
   typeDefs += "}\n";
   mutationDefs += "}\n";
   const genericTypes = `
@@ -5420,15 +5396,6 @@ type StatisticsResult {
   group: String!
   count: Int!
 }
-
-type AgentWorldAgent {
-  sessionId: ID!
-  agentId: ID!
-  agentName: String!
-  agentImage: String
-  currentTask: String
-  lastActivityAt: String
-}
 `;
   const fullSDL = typeDefs + mutationDefs + modelDefs + genericTypes;
   const schema = makeExecutableSchema({
@@ -5703,7 +5670,7 @@ async function clearSessionCurrentTask(session) {
 }
 
 // src/exulu/provider.ts
-import fs2 from "fs";
+import "fs";
 var ExuluProvider = class {
   // Must begin with a letter (a-z) or underscore (_). Subsequent characters in a name can be letters, digits (0-9), or
   // underscores and be a max length of 80 characters and at least 5 characters long.
@@ -6366,7 +6333,6 @@ ${extractedText}
         // todo make this configurable?
         page: 1
       });
-      fs2.writeFileSync("pre-fetched-relevant-information.json", JSON.stringify(result2, null, 2));
       if (result2?.chunks?.length) {
         memoryItems = result2.chunks;
         memoryContext = `
@@ -8594,7 +8560,7 @@ ${customInstructions}` : agent.instructions;
   const imageModelsByName = (() => {
     if (!isLiteLLMEnabled() || !config?.fileUploads) return /* @__PURE__ */ new Map();
     try {
-      const configPath = process.env.LITELLM_CONFIG_PATH ?? resolvePath(getPackageRoot(), "./config.litellm.yaml");
+      const configPath = process.env.LITELLM_CONFIG_PATH ?? resolvePath(process.cwd(), "./config.litellm.yaml");
       const models2 = parseImageGenerationModels(configPath);
       return new Map(models2.map((m) => [m.model_name, m]));
     } catch (err) {
@@ -9072,6 +9038,80 @@ ${style.markdown}` : params.prompt;
     }));
     res.status(200).json({ history });
   });
+  const litellmUiPath = "/litellm-admin";
+  if (isLiteLLMEnabled() && litellmUiPath) {
+    console.log("[EXULU] Registering LiteLLM UI at", litellmUiPath);
+    app.use(litellmUiPath, async (req, res) => {
+      const host = process.env.LITELLM_HOST ?? "127.0.0.1";
+      const port = process.env.LITELLM_PORT ?? "4000";
+      const upstreamUrl = `http://${host}:${port}${litellmUiPath}${req.url}`;
+      const upstreamHeaders = {};
+      for (const [name, value] of Object.entries(req.headers)) {
+        if (value === void 0) continue;
+        const lower = name.toLowerCase();
+        if (lower === "host" || lower === "content-length" || lower === "connection" || lower === "transfer-encoding" || lower === "accept-encoding")
+          continue;
+        upstreamHeaders[name] = Array.isArray(value) ? value.join(", ") : value;
+      }
+      const methodHasBody = !["GET", "HEAD"].includes(req.method);
+      let body;
+      if (methodHasBody && req.body && typeof req.body === "object" && Object.keys(req.body).length > 0) {
+        body = JSON.stringify(req.body);
+        upstreamHeaders["content-type"] = "application/json";
+      }
+      try {
+        const upstream = await fetch(upstreamUrl, {
+          method: req.method,
+          headers: upstreamHeaders,
+          body,
+          // Pass redirects through to the browser so LiteLLM's post-login
+          // redirect lands the user on the right URL (the Location already
+          // includes SERVER_ROOT_PATH).
+          redirect: "manual"
+        });
+        res.status(upstream.status);
+        const upstreamOrigin = `http://${host}:${port}`;
+        upstream.headers.forEach((value, name) => {
+          const lower = name.toLowerCase();
+          if (lower === "content-encoding" || lower === "content-length" || lower === "transfer-encoding" || lower === "connection")
+            return;
+          if (lower === "location") {
+            let loc = value.startsWith(upstreamOrigin) ? value.slice(upstreamOrigin.length) : value;
+            if (loc.startsWith("/") && loc !== litellmUiPath && !loc.startsWith(`${litellmUiPath}/`)) {
+              loc = `${litellmUiPath}${loc}`;
+            }
+            res.setHeader(name, loc);
+            return;
+          }
+          res.setHeader(name, value);
+        });
+        if (!upstream.body) {
+          res.end();
+          return;
+        }
+        const reader = upstream.body.getReader();
+        try {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            if (value) res.write(value);
+          }
+        } finally {
+          reader.releaseLock();
+        }
+        res.end();
+      } catch (err) {
+        console.error("[EXULU] LiteLLM UI proxy failed", err);
+        if (!res.headersSent) {
+          res.status(502).json({
+            detail: err instanceof Error ? err.message : "LiteLLM UI proxy failed."
+          });
+        } else {
+          res.end();
+        }
+      }
+    });
+  }
   app.use("/litellm/:project", async (req, res) => {
     if (!isLiteLLMEnabled()) {
       res.status(503).json({
@@ -12677,6 +12717,12 @@ var ExuluApp = class {
       ...providers ?? []
     ];
     this._config = config;
+    if (isLiteLLMEnabled()) {
+      const uiPath = "/litellm-admin";
+      if (uiPath) {
+        process.env.EXULU_LITELLM_UI_PATH = uiPath;
+      }
+    }
     const transcriptionTools = [];
     if (process.env.TRANSCRIPTION_MODEL && config?.fileUploads && config?.fileUploads?.s3region && config?.fileUploads?.s3key && config?.fileUploads?.s3secret && config?.fileUploads?.s3Bucket) {
       transcriptionTools.push(transcribeTool);
@@ -12684,7 +12730,7 @@ var ExuluApp = class {
     const imageGenerationTools = [];
     const s3Configured = !!config?.fileUploads && !!config.fileUploads.s3region && !!config.fileUploads.s3key && !!config.fileUploads.s3secret && !!config.fileUploads.s3Bucket;
     if (isLiteLLMEnabled() && s3Configured) {
-      const configPath = process.env.LITELLM_CONFIG_PATH ?? resolve(getPackageRoot(), "./config.litellm.yaml");
+      const configPath = process.env.LITELLM_CONFIG_PATH ?? resolve(process.cwd(), "./config.litellm.yaml");
       const imageModels = parseImageGenerationModels(configPath);
       if (imageModels.length > 0) {
         console.log(
@@ -14919,7 +14965,7 @@ ${WARNING_BANNER}`);
 };
 var log2 = (line) => console.log(`[EXULU-LITELLM] ${line}`);
 var initLiteLLMDatabase = async (packageRoot) => {
-  const configPath = process.env.LITELLM_CONFIG_PATH ?? resolve2(packageRoot, "./config.litellm.yaml");
+  const configPath = process.env.LITELLM_CONFIG_PATH ?? resolve2(process.cwd(), "./config.litellm.yaml");
   const safety = checkLiteLLMDatabaseSafety(configPath);
   if (safety.ok && safety.reason === "no-litellm-db-mode") return;
   if (!safety.ok && safety.reason === "unparseable-url") {

package/package.json

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