@utcp/http 1.0.12 → 1.1.0

package/dist/index.cjs

@@ -4105,7 +4105,8 @@ var HttpCallTemplateSchema = external_exports.object({
       return new import_sdk.AuthSerializer().validateDict(val);
     }
     return val;
-  }).describe("Authentication configuration for generated tools")
+  }).describe("Authentication configuration for generated tools"),
+  allowed_communication_protocols: external_exports.array(external_exports.string()).optional().describe("Optional list of allowed communication protocol types for tools within this manual.")
 });
 var HttpCallTemplateSerializer = class extends import_sdk2.Serializer {
   toDict(obj) {
@@ -4119,7 +4120,8 @@ var HttpCallTemplateSerializer = class extends import_sdk2.Serializer {
       auth_tools: obj.auth_tools ? new import_sdk.AuthSerializer().toDict(obj.auth_tools) : null,
       headers: obj.headers,
       body_field: obj.body_field,
-      header_fields: obj.header_fields
+      header_fields: obj.header_fields,
+      allowed_communication_protocols: obj.allowed_communication_protocols
     };
   }
   validateDict(obj) {
@@ -4146,7 +4148,8 @@ var StreamableHttpCallTemplateSchema = external_exports.object({
   auth: import_sdk3.AuthSchema.optional().describe("Optional authentication configuration."),
   headers: external_exports.record(external_exports.string(), external_exports.string()).optional().describe("Optional static headers to include in requests."),
   body_field: external_exports.string().nullable().optional().describe("The name of the single input field to be sent as the request body."),
-  header_fields: external_exports.array(external_exports.string()).nullable().optional().describe("List of input fields to be sent as request headers.")
+  header_fields: external_exports.array(external_exports.string()).nullable().optional().describe("List of input fields to be sent as request headers."),
+  allowed_communication_protocols: external_exports.array(external_exports.string()).optional().describe("Optional list of allowed communication protocol types for tools within this manual.")
 });
 var StreamableHttpCallTemplateSerializer = class extends import_sdk4.Serializer {
   /**
@@ -4165,7 +4168,8 @@ var StreamableHttpCallTemplateSerializer = class extends import_sdk4.Serializer
       auth: obj.auth,
       headers: obj.headers,
       body_field: obj.body_field,
-      header_fields: obj.header_fields
+      header_fields: obj.header_fields,
+      allowed_communication_protocols: obj.allowed_communication_protocols
     };
   }
   /**
@@ -4195,7 +4199,8 @@ var SseCallTemplateSchema = external_exports.object({
   auth: import_sdk5.AuthSchema.optional().describe("Optional authentication configuration."),
   headers: external_exports.record(external_exports.string(), external_exports.string()).optional().describe("Optional static headers for the initial connection."),
   body_field: external_exports.string().nullable().optional().describe("The name of the single input field to be sent as the request body."),
-  header_fields: external_exports.array(external_exports.string()).nullable().optional().describe("List of input fields to be sent as request headers for the initial connection.")
+  header_fields: external_exports.array(external_exports.string()).nullable().optional().describe("List of input fields to be sent as request headers for the initial connection."),
+  allowed_communication_protocols: external_exports.array(external_exports.string()).optional().describe("Optional list of allowed communication protocol types for tools within this manual.")
 });
 var SseCallTemplateSerializer = class extends import_sdk6.Serializer {
   /**
@@ -4213,7 +4218,8 @@ var SseCallTemplateSerializer = class extends import_sdk6.Serializer {
       auth: obj.auth,
       headers: obj.headers,
       body_field: obj.body_field,
-      header_fields: obj.header_fields
+      header_fields: obj.header_fields,
+      allowed_communication_protocols: obj.allowed_communication_protocols
     };
   }
   /**
@@ -4241,6 +4247,7 @@ var import_sdk8 = require("@utcp/sdk");
 var OpenApiConverter = class {
   spec;
   spec_url;
+  base_url;
   auth_tools;
   placeholder_counter = 0;
   call_template_name;
@@ -4248,14 +4255,16 @@ var OpenApiConverter = class {
    * Initializes the OpenAPI converter.
    *
    * @param openapi_spec Parsed OpenAPI specification as a dictionary.
-   * @param options Optional settings including spec_url, call_template_name, and auth_tools.
+   * @param options Optional settings including spec_url, call_template_name, auth_tools, and baseUrl.
    *     - specUrl: URL where the specification was retrieved from.
    *     - callTemplateName: Custom name for the call_template if spec title not provided.
    *     - authTools: Optional auth configuration for generated tools.
+   *     - baseUrl: Optional base URL override for all API endpoints.
    */
   constructor(openapi_spec, options) {
     this.spec = openapi_spec;
     this.spec_url = options?.specUrl;
+    this.base_url = options?.baseUrl;
     this.auth_tools = options?.authTools;
     this.placeholder_counter = 0;
     let callTemplateName = options?.callTemplateName;
@@ -4290,10 +4299,15 @@ var OpenApiConverter = class {
     this.placeholder_counter = 0;
     const tools = [];
     let baseUrl = "/";
-    const servers = this.spec.servers;
-    if (servers && Array.isArray(servers) && servers.length > 0 && servers[0].url) {
-      baseUrl = servers[0].url;
-    } else if (this.spec_url) {
+    if (this.base_url) {
+      baseUrl = this.base_url;
+    } else if (this.spec.servers && Array.isArray(this.spec.servers) && this.spec.servers.length > 0 && this.spec.servers[0].url) {
+      baseUrl = this.spec.servers[0].url;
+    } else if (this.spec.host) {
+      const scheme = this.spec.schemes?.[0] || "https";
+      const basePath = this.spec.basePath || "";
+      baseUrl = `${scheme}://${this.spec.host}${basePath}`;
+    } else if (this.spec_url && (this.spec_url.startsWith("http://") || this.spec_url.startsWith("https://"))) {
       try {
         const parsedUrl = new URL(this.spec_url);
         baseUrl = `${parsedUrl.protocol}//${parsedUrl.host}`;
@@ -4301,7 +4315,7 @@ var OpenApiConverter = class {
         console.error(`[OpenApiConverter] Invalid spec_url provided: ${this.spec_url}`);
       }
     } else {
-      console.warn("[OpenApiConverter] No server info or spec URL provided. Using fallback base URL: '/'");
+      console.warn("[OpenApiConverter] No server info found in OpenAPI spec. Using fallback base URL: '/'. Tools may not work correctly without a valid base URL.");
     }
     const paths = this.spec.paths || {};
     for (const [path, pathItem] of Object.entries(paths)) {
@@ -4871,11 +4885,12 @@ var HttpCommunicationProtocol = class {
         if (!apiKeyAuth.api_key) {
           throw new Error("API key for ApiKeyAuth is empty.");
         }
-        if (apiKeyAuth.location === "header") {
+        const location = apiKeyAuth.location || "header";
+        if (location === "header") {
           requestConfig.headers = { ...requestConfig.headers, [apiKeyAuth.var_name]: apiKeyAuth.api_key };
-        } else if (apiKeyAuth.location === "query") {
+        } else if (location === "query") {
           requestConfig.params = { ...requestConfig.params, [apiKeyAuth.var_name]: apiKeyAuth.api_key };
-        } else if (apiKeyAuth.location === "cookie") {
+        } else if (location === "cookie") {
           cookies[apiKeyAuth.var_name] = apiKeyAuth.api_key;
         }
       } else if (httpCallTemplate.auth.auth_type === "basic") {
@@ -5016,11 +5031,12 @@ var StreamableHttpCommunicationProtocol = class {
       if ("api_key" in provider.auth) {
         const apiKeyAuth = provider.auth;
         if (apiKeyAuth.api_key) {
-          if (apiKeyAuth.location === "header") {
+          const location = apiKeyAuth.location || "header";
+          if (location === "header") {
             headers[apiKeyAuth.var_name] = apiKeyAuth.api_key;
-          } else if (apiKeyAuth.location === "query") {
+          } else if (location === "query") {
             queryParams[apiKeyAuth.var_name] = apiKeyAuth.api_key;
-          } else if (apiKeyAuth.location === "cookie") {
+          } else if (location === "cookie") {
             cookies[apiKeyAuth.var_name] = apiKeyAuth.api_key;
           }
         } else {
@@ -5147,11 +5163,12 @@ var SseCommunicationProtocol = class {
       if ("api_key" in provider.auth) {
         const apiKeyAuth = provider.auth;
         if (apiKeyAuth.api_key) {
-          if (apiKeyAuth.location === "header") {
+          const location = apiKeyAuth.location || "header";
+          if (location === "header") {
             headers[apiKeyAuth.var_name] = apiKeyAuth.api_key;
-          } else if (apiKeyAuth.location === "query") {
+          } else if (location === "query") {
             queryParams[apiKeyAuth.var_name] = apiKeyAuth.api_key;
-          } else if (apiKeyAuth.location === "cookie") {
+          } else if (location === "cookie") {
             cookies[apiKeyAuth.var_name] = apiKeyAuth.api_key;
           }
         } else {