tooluniverse 1.0.9.1__py3-none-any.whl → 1.0.11__py3-none-any.whl

tooluniverse/data/file_download_tools.json

@@ -0,0 +1,275 @@
+[
+  {
+    "type": "FileDownloadTool",
+    "name": "download_file",
+    "description": "Download files from HTTP/HTTPS URLs with cross-platform support (Windows, Mac, Linux). Similar to curl but platform-independent. Can save to specified path or temporary directory.",
+    "fields": {
+      "return_key": "file_path"
+    },
+    "parameter": {
+      "type": "object",
+      "required": [
+        "url"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "HTTP or HTTPS URL to download from (e.g., https://example.com/file.txt)",
+          "format": "uri"
+        },
+        "output_path": {
+          "type": "string",
+          "description": "Optional path to save the file. If not specified, file will be saved to system temp directory.",
+          "example": "/tmp/downloaded_file.txt or C:\\Users\\Downloads\\file.txt"
+        },
+        "timeout": {
+          "type": "integer",
+          "description": "Request timeout in seconds",
+          "minimum": 1,
+          "maximum": 300,
+          "default": 30
+        },
+        "return_content": {
+          "type": "boolean",
+          "description": "If true, return file content as text instead of saving to disk (default: false)",
+          "default": false
+        },
+        "chunk_size": {
+          "type": "integer",
+          "description": "Download chunk size in bytes (default: 8192)",
+          "minimum": 1024,
+          "maximum": 10485760,
+          "default": 8192
+        },
+        "follow_redirects": {
+          "type": "boolean",
+          "description": "Follow HTTP redirects (default: true)",
+          "default": true
+        }
+      }
+    },
+    "return_schema": {
+      "oneOf": [
+        {
+          "type": "object",
+          "description": "Successfully downloaded file",
+          "properties": {
+            "file_path": {
+              "type": "string",
+              "description": "Absolute path to the downloaded file"
+            },
+            "file_size": {
+              "type": "integer",
+              "description": "Size of the file in bytes"
+            },
+            "url": {
+              "type": "string",
+              "description": "Original URL that was downloaded"
+            },
+            "content_type": {
+              "type": "string",
+              "description": "MIME type of the downloaded content"
+            },
+            "status_code": {
+              "type": "integer",
+              "description": "HTTP status code"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Returned content (when return_content=true)",
+          "properties": {
+            "content": {
+              "type": "string",
+              "description": "File content as text"
+            },
+            "content_type": {
+              "type": "string",
+              "description": "MIME type of the content"
+            },
+            "size": {
+              "type": "integer",
+              "description": "Size of content in characters"
+            },
+            "url": {
+              "type": "string",
+              "description": "Original URL"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Error response",
+          "properties": {
+            "error": {
+              "type": "string",
+              "description": "Error message"
+            }
+          }
+        }
+      ]
+    }
+  },
+  {
+    "type": "BinaryDownloadTool",
+    "name": "download_binary_file",
+    "description": "Download binary files (images, videos, executables) with chunked streaming for better memory management. Optimized for large files.",
+    "fields": {
+      "return_key": "file_path"
+    },
+    "parameter": {
+      "type": "object",
+      "required": [
+        "url",
+        "output_path"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "HTTP or HTTPS URL to download from",
+          "format": "uri"
+        },
+        "output_path": {
+          "type": "string",
+          "description": "Full path where to save the binary file (e.g., /tmp/image.jpg or C:\\Users\\Downloads\\video.mp4)",
+          "example": "/path/to/save/file.bin"
+        },
+        "chunk_size": {
+          "type": "integer",
+          "description": "Download chunk size in bytes (default: 1MB for binary files)",
+          "minimum": 1024,
+          "maximum": 10485760,
+          "default": 1048576
+        },
+        "timeout": {
+          "type": "integer",
+          "description": "Request timeout in seconds",
+          "minimum": 1,
+          "maximum": 300,
+          "default": 30
+        }
+      }
+    },
+    "return_schema": {
+      "oneOf": [
+        {
+          "type": "object",
+          "description": "Successfully downloaded binary file",
+          "properties": {
+            "file_path": {
+              "type": "string",
+              "description": "Absolute path to the downloaded file"
+            },
+            "size": {
+              "type": "integer",
+              "description": "Size of the file in bytes"
+            },
+            "content_type": {
+              "type": "string",
+              "description": "MIME type of the downloaded content"
+            },
+            "content_length": {
+              "type": "string",
+              "description": "Content-Length header value"
+            },
+            "url": {
+              "type": "string",
+              "description": "Original URL"
+            },
+            "status_code": {
+              "type": "integer",
+              "description": "HTTP status code"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Error response",
+          "properties": {
+            "error": {
+              "type": "string",
+              "description": "Error message"
+            }
+          }
+        }
+      ]
+    }
+  },
+  {
+    "type": "TextDownloadTool",
+    "name": "download_text_content",
+    "description": "Download and return text content from URLs. Optimized for text files with automatic encoding detection.",
+    "fields": {
+      "return_key": "content"
+    },
+    "parameter": {
+      "type": "object",
+      "required": [
+        "url"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "description": "HTTP or HTTPS URL to download text from",
+          "format": "uri"
+        },
+        "encoding": {
+          "type": "string",
+          "description": "Text encoding (e.g., utf-8, latin1). Auto-detected if not specified.",
+          "example": "utf-8"
+        },
+        "timeout": {
+          "type": "integer",
+          "description": "Request timeout in seconds",
+          "minimum": 1,
+          "maximum": 300,
+          "default": 30
+        }
+      }
+    },
+    "return_schema": {
+      "oneOf": [
+        {
+          "type": "object",
+          "description": "Successfully downloaded text content",
+          "properties": {
+            "content": {
+              "type": "string",
+              "description": "Text content from the URL"
+            },
+            "encoding": {
+              "type": "string",
+              "description": "Detected or specified encoding"
+            },
+            "size": {
+              "type": "integer",
+              "description": "Size of content in characters"
+            },
+            "url": {
+              "type": "string",
+              "description": "Original URL"
+            },
+            "content_type": {
+              "type": "string",
+              "description": "MIME type of the content"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Error response",
+          "properties": {
+            "error": {
+              "type": "string",
+              "description": "Error message"
+            }
+          }
+        }
+      ]
+    }
+  }
+]

tooluniverse/data/geo_tools.json

@@ -1,49 +1,39 @@
 [
   {
-    "type": "GEORESTTool",
-    "name": "GEO_search_expression_data",
-    "description": "Search gene expression data from the GEO database. GEO is a public repository that archives and freely distributes microarray, next-generation sequencing, and other forms of high-throughput functional genomics data.",
+    "type": "GEOSearchDatasets",
+    "name": "geo_search_datasets",
+    "description": "Search GEO datasets by query terms, organism, study type, or platform. Returns dataset IDs and basic information.",
     "parameter": {
       "type": "object",
       "properties": {
         "query": {
           "type": "string",
-          "description": "Search query (e.g., 'cancer', 'diabetes', 'microarray')",
-          "minLength": 1
+          "description": "Search query terms (e.g., 'cancer', 'diabetes', 'microarray')"
         },
         "organism": {
           "type": "string",
           "description": "Organism name (e.g., 'Homo sapiens', 'Mus musculus')",
-          "default": "Homo sapiens"
+          "default": ""
         },
         "study_type": {
           "type": "string",
-          "description": "Type of study (e.g., 'expression', 'methylation', 'genome')",
-          "enum": ["expression", "methylation", "genome", "sequence", "other"]
+          "description": "Type of study (e.g., 'Expression profiling by array', 'Expression profiling by high throughput sequencing')",
+          "default": ""
         },
         "platform": {
           "type": "string",
-          "description": "Platform used (e.g., 'GPL96', 'GPL570')"
-        },
-        "date_range": {
-          "type": "string",
-          "description": "Date range in format 'YYYY:YYYY' (e.g., '2020:2023')"
+          "description": "Platform used (e.g., 'GPL570', 'GPL96')",
+          "default": ""
         },
         "limit": {
           "type": "integer",
-          "description": "Maximum number of results to return (default: 50)",
+          "description": "Maximum number of results to return",
+          "default": 50,
           "minimum": 1,
-          "maximum": 500,
-          "default": 50
-        },
-        "sort": {
-          "type": "string",
-          "description": "Sort order ('relevance', 'date', 'title')",
-          "enum": ["relevance", "date", "title"],
-          "default": "relevance"
+          "maximum": 500
         }
       },
-      "required": ["query"]
+      "required": []
     },
     "fields": {
       "endpoint": "/esearch.fcgi",
@@ -51,36 +41,198 @@
     },
     "return_schema": {
       "type": "object",
+      "description": "GEO dataset search results",
       "properties": {
-        "success": {"type": "boolean"},
-        "count": {"type": "integer"},
-        "studies": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "id": {"type": "string"},
-              "title": {"type": "string"},
-              "summary": {"type": "string"},
-              "organism": {"type": "string"},
-              "platform": {"type": "string"},
-              "samples": {"type": "integer"},
-              "series_type": {"type": "string"},
-              "publication_date": {"type": "string"},
-              "submission_date": {"type": "string"},
-              "contact": {"type": "string"},
-              "citation": {"type": "string"}
+        "esearchresult": {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "string",
+              "description": "Number of datasets found"
+            },
+            "idlist": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of GEO dataset IDs"
+            },
+            "querytranslation": {
+              "type": "string",
+              "description": "Translated search query"
             }
           }
-        },
-        "query_translation": {"type": "string"},
-        "error": {"type": "string"}
+        }
+      }
+    },
+    "test_examples": [
+      {
+        "query": "cancer",
+        "organism": "Homo sapiens",
+        "limit": 10
+      },
+      {
+        "query": "diabetes",
+        "study_type": "Expression profiling by array",
+        "limit": 5
+      }
+    ],
+    "label": [
+      "GEO",
+      "Dataset",
+      "Search"
+    ],
+    "metadata": {
+      "tags": ["expression", "microarray", "search"],
+      "difficulty_level": "easy",
+      "estimated_execution_time": "< 3 seconds"
+    }
+  },
+  {
+    "type": "GEOGetDatasetInfo",
+    "name": "geo_get_dataset_info",
+    "description": "Get detailed information about a specific GEO dataset including title, summary, and metadata.",
+    "parameter": {
+      "type": "object",
+      "properties": {
+        "dataset_id": {
+          "type": "string",
+          "description": "GEO dataset ID (e.g., 'GDS1234', 'GSE12345')"
+        }
+      },
+      "required": ["dataset_id"]
+    },
+    "fields": {
+      "endpoint": "/esummary.fcgi",
+      "return_format": "JSON"
+    },
+    "return_schema": {
+      "type": "object",
+      "description": "GEO dataset information",
+      "properties": {
+        "result": {
+          "type": "object",
+          "description": "Dataset information from GEO",
+          "properties": {
+            "uid": {
+              "type": "string",
+              "description": "Dataset UID"
+            },
+            "title": {
+              "type": "string",
+              "description": "Dataset title"
+            },
+            "summary": {
+              "type": "string",
+              "description": "Dataset summary"
+            },
+            "organism": {
+              "type": "string",
+              "description": "Organism"
+            },
+            "platform": {
+              "type": "string",
+              "description": "Platform used"
+            },
+            "samples": {
+              "type": "string",
+              "description": "Number of samples"
+            }
+          }
+        }
+      }
+    },
+    "test_examples": [
+      {
+        "dataset_id": "GDS1234"
+      },
+      {
+        "dataset_id": "GSE12345"
+      }
+    ],
+    "label": [
+      "GEO",
+      "Dataset",
+      "Information"
+    ],
+    "metadata": {
+      "tags": ["dataset", "metadata", "expression"],
+      "difficulty_level": "easy",
+      "estimated_execution_time": "< 3 seconds"
+    }
+  },
+  {
+    "type": "GEOGetSampleInfo",
+    "name": "geo_get_sample_info",
+    "description": "Get sample information for a GEO dataset including sample characteristics and experimental conditions.",
+    "parameter": {
+      "type": "object",
+      "properties": {
+        "dataset_id": {
+          "type": "string",
+          "description": "GEO dataset ID (e.g., 'GDS1234', 'GSE12345')"
+        }
+      },
+      "required": ["dataset_id"]
+    },
+    "fields": {
+      "endpoint": "/esummary.fcgi",
+      "return_format": "JSON"
+    },
+    "return_schema": {
+      "type": "object",
+      "description": "GEO sample information",
+      "properties": {
+        "result": {
+          "type": "object",
+          "description": "Sample information from GEO",
+          "properties": {
+            "uid": {
+              "type": "string",
+              "description": "Dataset UID"
+            },
+            "samples": {
+              "type": "array",
+              "description": "Array of sample information",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "sample_id": {
+                    "type": "string",
+                    "description": "Sample identifier"
+                  },
+                  "characteristics": {
+                    "type": "string",
+                    "description": "Sample characteristics"
+                  },
+                  "treatment": {
+                    "type": "string",
+                    "description": "Treatment conditions"
+                  }
+                }
+              }
+            }
+          }
+        }
       }
     },
-    "implementation": {
-      "language": "python",
-      "dependencies": ["requests"],
-      "source_file": "geo_tool.py"
+    "test_examples": [
+      {
+        "dataset_id": "GDS1234"
+      },
+      {
+        "dataset_id": "GSE12345"
+      }
+    ],
+    "label": [
+      "GEO",
+      "Sample",
+      "Information"
+    ],
+    "metadata": {
+      "tags": ["sample", "characteristics", "expression"],
+      "difficulty_level": "easy",
+      "estimated_execution_time": "< 3 seconds"
     }
   }
 ]

tooluniverse/data/gnomad_tools.json

@@ -0,0 +1,109 @@
+[
+  {
+    "type": "gnomADGetGeneConstraints",
+    "name": "gnomad_get_gene_constraints",
+    "description": "Get gene constraint metrics from gnomAD. Returns pLI, LOEUF, and other constraint scores for genes.",
+    "parameter": {
+      "type": "object",
+      "properties": {
+        "gene_symbol": {
+          "type": "string",
+          "description": "Gene symbol (e.g., 'BRCA1', 'TP53')"
+        }
+      },
+      "required": ["gene_symbol"]
+    },
+    "fields": {
+      "endpoint": "https://gnomad.broadinstitute.org/api",
+      "return_format": "JSON",
+      "query_schema": "query GeneConstraints($geneSymbol: String!) { gene(gene_symbol: $geneSymbol, reference_genome: GRCh38) { symbol gene_id exac_constraint { exp_lof obs_lof pLI exp_mis obs_mis exp_syn obs_syn } gnomad_constraint { exp_lof obs_lof oe_lof pLI exp_mis obs_mis oe_mis exp_syn obs_syn oe_syn } } }"
+    },
+    "return_schema": {
+      "type": "object",
+      "description": "gnomAD gene constraint data",
+      "properties": {
+        "status": {
+          "type": "string",
+          "description": "Status of the request"
+        },
+        "data": {
+          "type": "object",
+          "description": "GraphQL response data",
+          "properties": {
+            "data": {
+              "type": "object",
+              "properties": {
+                "gene": {
+                  "type": "object",
+                  "properties": {
+                    "symbol": {
+                      "type": "string",
+                      "description": "Gene symbol"
+                    },
+                    "gene_id": {
+                      "type": "string",
+                      "description": "Ensembl gene ID"
+                    },
+                    "exac_constraint": {
+                      "type": "object",
+                      "description": "ExAC constraint metrics",
+                      "properties": {
+                        "exp_lof": {
+                          "type": "number",
+                          "description": "Expected number of loss-of-function variants"
+                        },
+                        "obs_lof": {
+                          "type": "number",
+                          "description": "Observed number of loss-of-function variants"
+                        },
+                        "pLI": {
+                          "type": "number",
+                          "description": "Probability of being loss-of-function intolerant"
+                        }
+                      }
+                    },
+                    "gnomad_constraint": {
+                      "type": "object",
+                      "description": "gnomAD constraint metrics",
+                      "properties": {
+                        "oe_lof": {
+                          "type": "number",
+                          "description": "Observed/Expected ratio for loss-of-function variants"
+                        },
+                        "pLI": {
+                          "type": "number",
+                          "description": "Probability of being loss-of-function intolerant"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "gene_symbol": {
+          "type": "string",
+          "description": "Input gene symbol"
+        }
+      }
+    },
+    "test_examples": [
+      {
+        "description": "Get constraint metrics for BRCA1 gene",
+        "input": {
+          "gene_symbol": "BRCA1"
+        },
+        "expected_output": {
+          "status": "success",
+          "data": "Gene constraint data with pLI and LOEUF scores"
+        }
+      }
+    ],
+    "metadata": {
+      "tags": ["constraint", "pLI", "LOEUF", "gnomAD"],
+      "difficulty_level": "intermediate",
+      "estimated_execution_time": "< 3 seconds"
+    }
+  }
+]