@exulu/backend 1.64.0 → 1.66.0

package/dist/{chunk-A5AZEDLP.js → chunk-KQDNL5WU.js}

@@ -1562,7 +1562,10 @@ var createUppyRoutes = async (app, config) => {
       Bucket: config.fileUploads.s3Bucket,
       Key: fullKey,
       ContentType: type,
-      Metadata: metadata
+      // S3 metadata values must be US-ASCII. Sanitize here (same as uploadFile)
+      // so non-ASCII characters in the filename — e.g. the en-dash "–" in
+      // "… CEST – Recording.mp4" — don't trigger a SignatureDoesNotMatch.
+      Metadata: sanitizeMetadata(metadata)
     };
     const command = new CreateMultipartUploadCommand(params);
     return client2.send(command, (err, data) => {
@@ -5700,7 +5703,7 @@ function createAgenticRetrievalToolV3({
     return void 0;
   }
   const contextNames = contexts.map((c) => c.id).join(", ");
-  return new ExuluTool({
+  return ExuluTool.internal({
     id: "agentic_context_search",
     name: "Context Search",
     description: `Intelligent context search with query classification, strategy-based retrieval, and virtual filesystem filtering. Searches: ${contextNames}`,
@@ -6040,7 +6043,7 @@ var createProjectItemsRetrievalTool = async ({
   if (!project.project_items?.length) {
     return;
   }
-  const projectRetrievalTool = new ExuluTool({
+  const projectRetrievalTool = ExuluTool.internal({
     id: "context_search_in_knowledge_items_added_to_project_" + projectId,
     name: "context_search in knowledge items added to project " + project.name,
     description: "This tool retrieves information about a project from conversations and items that were added to the project " + project.name + ".",
@@ -12379,7 +12382,7 @@ var ExuluProvider = class {
     if (!license["multi-agent-tooling"]) {
       console.warn(`[EXULU] You are not licensed to use multi-agent tooling so cannot export this agent as a tool. Please set your EXULU_ENTERPRISE_LICENSE env variable.`);
     }
-    return new ExuluTool({
+    return ExuluTool.internal({
       id: agent.id,
       name: `${agent.name}`,
       type: "agent",
@@ -18543,7 +18546,6 @@ var ResolveModelError = class extends Error {
     this.name = "ResolveModelError";
   }
 };
-var _litellmProvider;
 var getLiteLLMProvider = ({
   user,
   role,
@@ -18551,7 +18553,6 @@ var getLiteLLMProvider = ({
   agent,
   team
 }) => {
-  if (_litellmProvider) return _litellmProvider;
   const host = process.env.LITELLM_HOST ?? "127.0.0.1";
   const port = process.env.LITELLM_PORT ?? "4000";
   const masterKey = process.env.LITELLM_MASTER_KEY;
@@ -18573,7 +18574,7 @@ var getLiteLLMProvider = ({
       "LITELLM_MASTER_KEY is required when EXULU_USE_LITELLM=true"
     );
   }
-  _litellmProvider = createOpenAICompatible({
+  return createOpenAICompatible({
     name: "litellm",
     baseURL: `http://${host}:${port}/v1`,
     apiKey: masterKey,
@@ -18589,7 +18590,6 @@ var getLiteLLMProvider = ({
     // proxy contract.
     supportsStructuredOutputs: true
   });
-  return _litellmProvider;
 };
 async function resolveModel(input) {
   const { modelId, user, providers, agent, project, rbacBypass } = input;
@@ -18686,7 +18686,8 @@ async function resolveModel(input) {
 }
 
 // src/exulu/tool.ts
-var ExuluTool = class {
+var PUBLIC_TOOL_TYPES = ["function", "web_search", "skill"];
+var ExuluTool = class _ExuluTool {
   // 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.
   // The ID is used for storing references to tools so it is important it does not change.
@@ -18710,6 +18711,13 @@ var ExuluTool = class {
     config,
     needsApproval
   }) {
+    if (!PUBLIC_TOOL_TYPES.includes(type)) {
+      throw new Error(
+        `ExuluTool "${id}": invalid type "${type}". Allowed types are ${PUBLIC_TOOL_TYPES.join(
+          ", "
+        )}. The "agent" and "context" types are managed by Exulu internally and cannot be set on a tool.`
+      );
+    }
     this.id = id;
     this.config = config;
     this.needsApproval = needsApproval ?? true;
@@ -18724,6 +18732,19 @@ var ExuluTool = class {
       execute
     });
   }
+  /**
+   * Framework-only factory for tools whose `type` is managed by Exulu itself —
+   * "agent" (agent-as-tool instrumentation) and "context" (internal retrieval
+   * tools). NOT part of the public API: package consumers must use
+   * `new ExuluTool(...)`, which only accepts a {@link PublicToolType}. Building
+   * the tool as a "function" and then setting the managed type bypasses the
+   * constructor guard without weakening it for consumers.
+   */
+  static internal(params) {
+    const instance2 = new _ExuluTool({ ...params, type: "function" });
+    instance2.type = params.type;
+    return instance2;
+  }
   execute = async ({
     agent: agentId,
     config,
@@ -18756,7 +18777,7 @@ var ExuluTool = class {
       });
       providerapikey = resolved.apiKey;
     }
-    const { convertExuluToolsToAiSdkTools: convertExuluToolsToAiSdkTools2 } = await import("./convert-exulu-tools-to-ai-sdk-tools-D35XXTKW.js");
+    const { convertExuluToolsToAiSdkTools: convertExuluToolsToAiSdkTools2 } = await import("./convert-exulu-tools-to-ai-sdk-tools-ZFIN7A5V.js");
     const tools = await convertExuluToolsToAiSdkTools2(
       [this],
       [],
@@ -18816,7 +18837,7 @@ var createSessionItemsRetrievalTool = async ({
   items
 }) => {
   console.log("[EXULU] Session search tool created for session", items);
-  const sessionItemsRetrievalTool = new ExuluTool({
+  const sessionItemsRetrievalTool = ExuluTool.internal({
     id: "session_items_information_context_search",
     name: "context_search in knowledge items added to session.",
     description: "Context search in knowledge items added to session.",
@@ -19252,9 +19273,10 @@ var convertExuluToolsToAiSdkTools = async (currentTools, currentSkills, approved
                   if (!s3Client2) {
                     throw new Error("S3 client not initialized");
                   }
-                  const response2 = await s3Client2.send(command);
-                  console.log(response2);
-                  return response2;
+                  await s3Client2.send(command);
+                  const bucket = exuluConfig?.fileUploads?.s3Bucket ?? "";
+                  const presignedUrl = await getPresignedUrl(bucket, key, exuluConfig);
+                  return { url: presignedUrl, key: `${bucket}/${key}` };
                 } catch (caught) {
                   if (caught instanceof S3ServiceException && caught.name === "EntityTooLarge") {
                     throw new Error(`[EXULU] Error from S3 while uploading object to ${exuluConfig?.fileUploads?.s3Bucket}.                                       The object was too large. To upload objects larger than 5GB, use the S3 console (160GB max)                                       or the multipart upload API (5TB max).`);

package/dist/{convert-exulu-tools-to-ai-sdk-tools-D35XXTKW.js → convert-exulu-tools-to-ai-sdk-tools-ZFIN7A5V.js}

@@ -1,6 +1,6 @@
 import {
   convertExuluToolsToAiSdkTools
-} from "./chunk-A5AZEDLP.js";
+} from "./chunk-KQDNL5WU.js";
 import "./chunk-YCE44CMU.js";
 export {
   convertExuluToolsToAiSdkTools

package/dist/index.cjs

@@ -1695,7 +1695,7 @@ async function resolveModel(input) {
   });
   return { languageModel, model, exuluProvider, apiKey };
 }
-var import_crypto_js, import_openai_compatible, LITELLM_PROVIDER_SENTINEL, ResolveModelError, _litellmProvider, getLiteLLMProvider;
+var import_crypto_js, import_openai_compatible, LITELLM_PROVIDER_SENTINEL, ResolveModelError, getLiteLLMProvider;
 var init_resolve_model = __esm({
   "src/exulu/resolve-model.ts"() {
     "use strict";
@@ -1736,7 +1736,6 @@ var init_resolve_model = __esm({
       agent,
       team
     }) => {
-      if (_litellmProvider) return _litellmProvider;
       const host = process.env.LITELLM_HOST ?? "127.0.0.1";
       const port = process.env.LITELLM_PORT ?? "4000";
       const masterKey = process.env.LITELLM_MASTER_KEY;
@@ -1758,7 +1757,7 @@ var init_resolve_model = __esm({
           "LITELLM_MASTER_KEY is required when EXULU_USE_LITELLM=true"
         );
       }
-      _litellmProvider = (0, import_openai_compatible.createOpenAICompatible)({
+      return (0, import_openai_compatible.createOpenAICompatible)({
         name: "litellm",
         baseURL: `http://${host}:${port}/v1`,
         apiKey: masterKey,
@@ -1774,7 +1773,6 @@ var init_resolve_model = __esm({
         // proxy contract.
         supportsStructuredOutputs: true
       });
-      return _litellmProvider;
     };
   }
 });
@@ -1845,7 +1843,7 @@ var init_project_retrieval_tool = __esm({
       if (!project.project_items?.length) {
         return;
       }
-      const projectRetrievalTool = new ExuluTool({
+      const projectRetrievalTool = ExuluTool.internal({
         id: "context_search_in_knowledge_items_added_to_project_" + projectId,
         name: "context_search in knowledge items added to project " + project.name,
         description: "This tool retrieves information about a project from conversations and items that were added to the project " + project.name + ".",
@@ -1947,7 +1945,7 @@ var init_session_items_retrieval_tool = __esm({
       items
     }) => {
       console.log("[EXULU] Session search tool created for session", items);
-      const sessionItemsRetrievalTool = new ExuluTool({
+      const sessionItemsRetrievalTool = ExuluTool.internal({
         id: "session_items_information_context_search",
         name: "context_search in knowledge items added to session.",
         description: "Context search in knowledge items added to session.",
@@ -2779,7 +2777,10 @@ var init_uppy = __esm({
           Bucket: config.fileUploads.s3Bucket,
           Key: fullKey,
           ContentType: type,
-          Metadata: metadata
+          // S3 metadata values must be US-ASCII. Sanitize here (same as uploadFile)
+          // so non-ASCII characters in the filename — e.g. the en-dash "–" in
+          // "… CEST – Recording.mp4" — don't trigger a SignatureDoesNotMatch.
+          Metadata: sanitizeMetadata(metadata)
         };
         const command = new import_client_s3.CreateMultipartUploadCommand(params);
         return client2.send(command, (err, data) => {
@@ -3893,9 +3894,10 @@ var init_convert_exulu_tools_to_ai_sdk_tools = __esm({
                       if (!s3Client2) {
                         throw new Error("S3 client not initialized");
                       }
-                      const response2 = await s3Client2.send(command);
-                      console.log(response2);
-                      return response2;
+                      await s3Client2.send(command);
+                      const bucket = exuluConfig?.fileUploads?.s3Bucket ?? "";
+                      const presignedUrl = await getPresignedUrl(bucket, key, exuluConfig);
+                      return { url: presignedUrl, key: `${bucket}/${key}` };
                     } catch (caught) {
                       if (caught instanceof import_client_s32.S3ServiceException && caught.name === "EntityTooLarge") {
                         throw new Error(`[EXULU] Error from S3 while uploading object to ${exuluConfig?.fileUploads?.s3Bucket}.                                       The object was too large. To upload objects larger than 5GB, use the S3 console (160GB max)                                       or the multipart upload API (5TB max).`);
@@ -3970,7 +3972,7 @@ var init_convert_exulu_tools_to_ai_sdk_tools = __esm({
 });
 
 // src/exulu/tool.ts
-var import_ai2, import_zod5, import_node_crypto3, ExuluTool;
+var import_ai2, import_zod5, import_node_crypto3, PUBLIC_TOOL_TYPES, ExuluTool;
 var init_tool = __esm({
   "src/exulu/tool.ts"() {
     "use strict";
@@ -3982,7 +3984,8 @@ var init_tool = __esm({
     import_node_crypto3 = require("crypto");
     init_singleton();
     init_resolve_model();
-    ExuluTool = class {
+    PUBLIC_TOOL_TYPES = ["function", "web_search", "skill"];
+    ExuluTool = class _ExuluTool {
       // 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.
       // The ID is used for storing references to tools so it is important it does not change.
@@ -4006,6 +4009,13 @@ var init_tool = __esm({
         config,
         needsApproval
       }) {
+        if (!PUBLIC_TOOL_TYPES.includes(type)) {
+          throw new Error(
+            `ExuluTool "${id}": invalid type "${type}". Allowed types are ${PUBLIC_TOOL_TYPES.join(
+              ", "
+            )}. The "agent" and "context" types are managed by Exulu internally and cannot be set on a tool.`
+          );
+        }
         this.id = id;
         this.config = config;
         this.needsApproval = needsApproval ?? true;
@@ -4020,6 +4030,19 @@ var init_tool = __esm({
           execute: execute2
         });
       }
+      /**
+       * Framework-only factory for tools whose `type` is managed by Exulu itself —
+       * "agent" (agent-as-tool instrumentation) and "context" (internal retrieval
+       * tools). NOT part of the public API: package consumers must use
+       * `new ExuluTool(...)`, which only accepts a {@link PublicToolType}. Building
+       * the tool as a "function" and then setting the managed type bypasses the
+       * constructor guard without weakening it for consumers.
+       */
+      static internal(params) {
+        const instance2 = new _ExuluTool({ ...params, type: "function" });
+        instance2.type = params.type;
+        return instance2;
+      }
       execute = async ({
         agent: agentId,
         config,
@@ -8305,7 +8328,7 @@ function createAgenticRetrievalToolV3({
     return void 0;
   }
   const contextNames = contexts.map((c) => c.id).join(", ");
-  return new ExuluTool({
+  return ExuluTool.internal({
     id: "agentic_context_search",
     name: "Context Search",
     description: `Intelligent context search with query classification, strategy-based retrieval, and virtual filesystem filtering. Searches: ${contextNames}`,
@@ -14179,7 +14202,7 @@ var init_provider = __esm({
         if (!license["multi-agent-tooling"]) {
           console.warn(`[EXULU] You are not licensed to use multi-agent tooling so cannot export this agent as a tool. Please set your EXULU_ENTERPRISE_LICENSE env variable.`);
         }
-        return new ExuluTool({
+        return ExuluTool.internal({
           id: agent.id,
           name: `${agent.name}`,
           type: "agent",

package/dist/index.d.cts

@@ -184,13 +184,16 @@ interface Item {
     [key: string]: any;
 }
 
+declare const PUBLIC_TOOL_TYPES: readonly ["function", "web_search", "skill"];
+type PublicToolType = (typeof PUBLIC_TOOL_TYPES)[number];
+type ToolType = PublicToolType | "agent" | "context";
 declare class ExuluTool {
     id: string;
     name: string;
     description: string;
     category: string;
     inputSchema?: z.ZodType;
-    type: "context" | "function" | "agent" | "web_search" | "skill";
+    type: ToolType;
     tool: Tool;
     needsApproval: boolean;
     config: {
@@ -205,7 +208,7 @@ declare class ExuluTool {
         description: string;
         category?: string;
         inputSchema?: z.ZodType;
-        type: "context" | "function" | "agent" | "web_search" | "skill";
+        type: PublicToolType;
         config: {
             name: string;
             description: string;
@@ -223,6 +226,17 @@ declare class ExuluTool {
             items?: Item[];
         }>;
     });
+    /**
+     * Framework-only factory for tools whose `type` is managed by Exulu itself —
+     * "agent" (agent-as-tool instrumentation) and "context" (internal retrieval
+     * tools). NOT part of the public API: package consumers must use
+     * `new ExuluTool(...)`, which only accepts a {@link PublicToolType}. Building
+     * the tool as a "function" and then setting the managed type bypasses the
+     * constructor guard without weakening it for consumers.
+     */
+    static internal(params: Omit<ConstructorParameters<typeof ExuluTool>[0], "type"> & {
+        type: ToolType;
+    }): ExuluTool;
     execute: ({ agent: agentId, config, user, inputs, project, items, }: {
         agent: string;
         config: ExuluConfig;

package/dist/index.d.ts

@@ -184,13 +184,16 @@ interface Item {
     [key: string]: any;
 }
 
+declare const PUBLIC_TOOL_TYPES: readonly ["function", "web_search", "skill"];
+type PublicToolType = (typeof PUBLIC_TOOL_TYPES)[number];
+type ToolType = PublicToolType | "agent" | "context";
 declare class ExuluTool {
     id: string;
     name: string;
     description: string;
     category: string;
     inputSchema?: z.ZodType;
-    type: "context" | "function" | "agent" | "web_search" | "skill";
+    type: ToolType;
     tool: Tool;
     needsApproval: boolean;
     config: {
@@ -205,7 +208,7 @@ declare class ExuluTool {
         description: string;
         category?: string;
         inputSchema?: z.ZodType;
-        type: "context" | "function" | "agent" | "web_search" | "skill";
+        type: PublicToolType;
         config: {
             name: string;
             description: string;
@@ -223,6 +226,17 @@ declare class ExuluTool {
             items?: Item[];
         }>;
     });
+    /**
+     * Framework-only factory for tools whose `type` is managed by Exulu itself —
+     * "agent" (agent-as-tool instrumentation) and "context" (internal retrieval
+     * tools). NOT part of the public API: package consumers must use
+     * `new ExuluTool(...)`, which only accepts a {@link PublicToolType}. Building
+     * the tool as a "function" and then setting the managed type bypasses the
+     * constructor guard without weakening it for consumers.
+     */
+    static internal(params: Omit<ConstructorParameters<typeof ExuluTool>[0], "type"> & {
+        type: ToolType;
+    }): ExuluTool;
     execute: ({ agent: agentId, config, user, inputs, project, items, }: {
         agent: string;
         config: ExuluConfig;

package/dist/index.js

@@ -53,7 +53,7 @@ import {
   uploadFile,
   validateHermesAtBoot,
   withRetry
-} from "./chunk-A5AZEDLP.js";
+} from "./chunk-KQDNL5WU.js";
 import "./chunk-YCE44CMU.js";
 
 // src/index.ts

package/ee/agentic-retrieval/v3/index.ts

@@ -213,7 +213,7 @@ export function createAgenticRetrievalToolV3({
 
   const contextNames = contexts.map((c) => c.id).join(", ");
 
-  return new ExuluTool({
+  return ExuluTool.internal({
     id: "agentic_context_search",
     name: "Context Search",
     description: `Intelligent context search with query classification, strategy-based retrieval, and virtual filesystem filtering. Searches: ${contextNames}`,

package/ee/agentic-retrieval/v4/index.ts

@@ -152,7 +152,7 @@ export function createAgenticRetrievalToolV4({
 
     const contextNames = contexts.map((c) => c.id).join(", ");
 
-    return new ExuluTool({
+    return ExuluTool.internal({
         id: "agentic_context_search",
         name: "Context Search",
         description: `Intelligent context search with query classification, strategy-based retrieval, and virtual filesystem filtering. Searches: ${contextNames}`,

package/package.json

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