@utcp/http 1.0.12 → 1.1.0

package/dist/index.d.cts

@@ -18,6 +18,7 @@ interface HttpCallTemplate extends CallTemplate {
     body_field?: string;
     header_fields?: string[];
     auth_tools?: Auth | null;
+    allowed_communication_protocols?: string[];
 }
 /**
  * HTTP Call Template schema for RESTful HTTP/HTTPS API tools.
@@ -149,6 +150,7 @@ interface StreamableHttpCallTemplate extends CallTemplate {
     headers?: Record<string, string>;
     body_field?: string | null;
     header_fields?: string[] | null;
+    allowed_communication_protocols?: string[];
 }
 /**
  * Streamable HTTP Call Template schema.
@@ -245,6 +247,7 @@ interface SseCallTemplate extends CallTemplate {
     headers?: Record<string, string>;
     body_field?: string | null;
     header_fields?: string[] | null;
+    allowed_communication_protocols?: string[];
 }
 /**
  * SSE Call Template schema.
@@ -319,6 +322,7 @@ interface OpenApiConverterOptions {
     specUrl?: string;
     callTemplateName?: string;
     authTools?: Auth;
+    baseUrl?: string;
 }
 /**
  * REQUIRED
@@ -332,6 +336,7 @@ interface OpenApiConverterOptions {
 declare class OpenApiConverter {
     private spec;
     private spec_url;
+    private base_url;
     private auth_tools;
     private placeholder_counter;
     private call_template_name;
@@ -339,10 +344,11 @@ declare class OpenApiConverter {
      * 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: Record<string, any>, options?: OpenApiConverterOptions);
     private _generateUuid;

package/dist/index.d.ts

@@ -18,6 +18,7 @@ interface HttpCallTemplate extends CallTemplate {
     body_field?: string;
     header_fields?: string[];
     auth_tools?: Auth | null;
+    allowed_communication_protocols?: string[];
 }
 /**
  * HTTP Call Template schema for RESTful HTTP/HTTPS API tools.
@@ -149,6 +150,7 @@ interface StreamableHttpCallTemplate extends CallTemplate {
     headers?: Record<string, string>;
     body_field?: string | null;
     header_fields?: string[] | null;
+    allowed_communication_protocols?: string[];
 }
 /**
  * Streamable HTTP Call Template schema.
@@ -245,6 +247,7 @@ interface SseCallTemplate extends CallTemplate {
     headers?: Record<string, string>;
     body_field?: string | null;
     header_fields?: string[] | null;
+    allowed_communication_protocols?: string[];
 }
 /**
  * SSE Call Template schema.
@@ -319,6 +322,7 @@ interface OpenApiConverterOptions {
     specUrl?: string;
     callTemplateName?: string;
     authTools?: Auth;
+    baseUrl?: string;
 }
 /**
  * REQUIRED
@@ -332,6 +336,7 @@ interface OpenApiConverterOptions {
 declare class OpenApiConverter {
     private spec;
     private spec_url;
+    private base_url;
     private auth_tools;
     private placeholder_counter;
     private call_template_name;
@@ -339,10 +344,11 @@ declare class OpenApiConverter {
      * 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: Record<string, any>, options?: OpenApiConverterOptions);
     private _generateUuid;

package/dist/index.js

@@ -4067,7 +4067,8 @@ var HttpCallTemplateSchema = external_exports.object({
       return new 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 Serializer {
   toDict(obj) {
@@ -4081,7 +4082,8 @@ var HttpCallTemplateSerializer = class extends Serializer {
       auth_tools: obj.auth_tools ? new 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) {
@@ -4108,7 +4110,8 @@ var StreamableHttpCallTemplateSchema = external_exports.object({
   auth: AuthSchema2.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 Serializer2 {
   /**
@@ -4127,7 +4130,8 @@ var StreamableHttpCallTemplateSerializer = class extends Serializer2 {
       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
     };
   }
   /**
@@ -4157,7 +4161,8 @@ var SseCallTemplateSchema = external_exports.object({
   auth: AuthSchema3.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 Serializer3 {
   /**
@@ -4175,7 +4180,8 @@ var SseCallTemplateSerializer = class extends Serializer3 {
       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
     };
   }
   /**
@@ -4203,6 +4209,7 @@ import { UtcpManualSerializer } from "@utcp/sdk";
 var OpenApiConverter = class {
   spec;
   spec_url;
+  base_url;
   auth_tools;
   placeholder_counter = 0;
   call_template_name;
@@ -4210,14 +4217,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;
@@ -4252,10 +4261,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}`;
@@ -4263,7 +4277,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)) {
@@ -4833,11 +4847,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") {
@@ -4978,11 +4993,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 {
@@ -5109,11 +5125,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 {