@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/earthly-cloud.json

@@ -0,0 +1,84 @@
+{
+  "slug": "earthly-cloud",
+  "name": "Earthly Cloud",
+  "description": "Earthly Satellites — managed remote BuildKit instances with persistent cache. Generous free tier (6000 build-minutes/month). Authenticate with EARTHLY_TOKEN. v1 API exposes satellite lifecycle (launch / wake / sleep / rm) and project management; the actual build is driven by the earthly CLI talking to a selected satellite.",
+  "logo": "https://www.google.com/s2/favicons?domain=earthly.dev&sz=128",
+  "categories": ["build", "ci", "buildkit", "docker", "devops"],
+  "base_url": "https://api.earthly.dev",
+  "auth": {
+    "types": ["bearer"],
+    "headers": { "Authorization": "Bearer {{token}}" },
+    "credential_fields": [
+      { "name": "token", "label": "EARTHLY_TOKEN", "description": "Login token from `earthly account create-token`", "required": true, "type": "password" },
+      { "name": "org", "label": "Organization", "description": "Earthly Cloud organization slug", "required": true, "type": "text" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_satellites",
+      "description": "List satellites for the organization. Args: org.",
+      "method": "GET",
+      "path": "/api/v0/satellites?org={{org}}",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "launch_satellite",
+      "description": "Provision a new satellite. Args: name, size (xsmall|small|medium|large|xlarge), platform (linux/amd64|linux/arm64), feature_flags?.",
+      "method": "POST",
+      "path": "/api/v0/satellites",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "size": { "type": "string", "enum": ["xsmall", "small", "medium", "large", "xlarge"] },
+          "platform": { "type": "string" },
+          "feature_flags": { "type": "array", "items": { "type": "string" } }
+        },
+        "required": ["name", "size"]
+      }
+    },
+    {
+      "name": "wake_satellite",
+      "description": "Wake a sleeping satellite so a build can target it. Args: name.",
+      "method": "POST",
+      "path": "/api/v0/satellites/{name}/wake",
+      "input_schema": {
+        "type": "object",
+        "properties": { "name": { "type": "string" } },
+        "required": ["name"]
+      }
+    },
+    {
+      "name": "sleep_satellite",
+      "description": "Put a satellite to sleep to stop billing. Args: name.",
+      "method": "POST",
+      "path": "/api/v0/satellites/{name}/sleep",
+      "input_schema": {
+        "type": "object",
+        "properties": { "name": { "type": "string" } },
+        "required": ["name"]
+      }
+    },
+    {
+      "name": "delete_satellite",
+      "description": "Destroy a satellite permanently. Args: name.",
+      "method": "DELETE",
+      "path": "/api/v0/satellites/{name}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "name": { "type": "string" } },
+        "required": ["name"]
+      }
+    },
+    {
+      "name": "list_builds",
+      "description": "Recent builds for the organization with status, duration, satellite. Args: org, limit?.",
+      "method": "GET",
+      "path": "/api/v0/builds?org={{org}}&limit={limit}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "limit": { "type": "integer" } }
+      }
+    }
+  ]
+}

package/src/apps/eia.json

@@ -0,0 +1,121 @@
+{
+  "slug": "eia",
+  "name": "EIA — U.S. Energy Information Administration",
+  "description": "Official US energy data — crude oil spot + futures prices, refined product prices (gasoline, diesel, jet fuel, heating oil), natural gas, electricity retail + generation, coal, renewables, and country-level energy stats. Drives commodity markets, energy ETF/stock prices, transport-sector inflation expectations, and (less obviously) crypto mining cost discussions. Free, official, no rate limit cap. Sign up at https://www.eia.gov/opendata/register.php. v2 API is category-routed — paths like /petroleum/pri/spt/data fetch petroleum spot prices.",
+  "logo": "https://www.google.com/s2/favicons?domain=eia.gov&sz=128",
+  "categories": [
+    "energy",
+    "commodities",
+    "macro",
+    "oil",
+    "gas",
+    "electricity",
+    "public-data",
+    "government"
+  ],
+  "base_url": "https://api.eia.gov/v2",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "api_key": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "EIA API Key",
+        "description": "From https://www.eia.gov/opendata/register.php. Free, no cap. Email-based signup."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "browse_route",
+      "description": "Walk the EIA category tree to discover what data exists. Pass a route prefix (or empty string for root) and EIA returns the children + leaf-data-endpoints. Use to drill from 'petroleum' → 'pri' (prices) → 'spt' (spot) → 'data' (the time-series).",
+      "method": "GET",
+      "path": "/{route}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "route": {"type": "string", "description": "Empty (root) or a slash-path like 'petroleum/pri/spt'."}
+        }
+      }
+    },
+    {
+      "name": "get_data",
+      "description": "Fetch observations from a leaf-data route. Generic — works for any EIA series once you know the route. Apply facets to narrow by series, region, fuel type, etc. The agent typically calls browse_route first to find the right route + facet keys.",
+      "method": "GET",
+      "path": "/{route}/data/",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "route":         {"type": "string", "description": "Leaf route, e.g. 'petroleum/pri/spt' for petroleum spot prices."},
+          "frequency":     {"type": "string", "enum": ["daily","weekly","monthly","quarterly","annual"], "description": "Resample frequency."},
+          "data[0]":       {"type": "string", "description": "Data column to return — 'value' is the standard."},
+          "facets[series][]": {"type": "string", "description": "Series filter (route-specific). E.g. for petroleum/pri/spt: RWTC (WTI Cushing) or RBRTE (Brent)."},
+          "start":         {"type": "string", "description": "YYYY-MM-DD or YYYY-MM. Lower bound."},
+          "end":           {"type": "string", "description": "Upper bound."},
+          "sort[0][column]": {"type": "string", "default": "period"},
+          "sort[0][direction]": {"type": "string", "enum": ["asc","desc"], "default": "desc"},
+          "length":        {"type": "integer", "default": 5000, "description": "Max rows (default 5000, max ~5000 per page)."},
+          "offset":        {"type": "integer", "default": 0}
+        },
+        "required": ["route"]
+      }
+    },
+    {
+      "name": "petroleum_spot_prices",
+      "description": "Helper for the most-asked-for series: petroleum spot prices (WTI, Brent, and refined products). Calls /petroleum/pri/spt/data with the right facets. Series codes: RWTC (WTI Cushing OK), RBRTE (Brent spot), EER_EPMRU_PF4_RGC_DPG (RBOB gasoline), EER_EPD2DXL0_PF4_RGC_DPG (Distillate).",
+      "method": "GET",
+      "path": "/petroleum/pri/spt/data/",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "frequency": {"type": "string", "enum": ["daily","weekly","monthly","annual"], "default": "daily"},
+          "data[0]":   {"type": "string", "default": "value"},
+          "facets[series][]": {"type": "string", "default": "RWTC"},
+          "start":     {"type": "string"},
+          "end":       {"type": "string"},
+          "length":    {"type": "integer", "default": 100}
+        }
+      }
+    },
+    {
+      "name": "natural_gas_prices",
+      "description": "Helper: Henry Hub + other natural gas spot prices. Calls /natural-gas/pri/fut/data with futures or /natural-gas/pri/sum/data for spot summary. Henry Hub spot series = RNGWHHD.",
+      "method": "GET",
+      "path": "/natural-gas/pri/sum/data/",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "frequency": {"type": "string", "enum": ["daily","weekly","monthly","annual"], "default": "daily"},
+          "data[0]":   {"type": "string", "default": "value"},
+          "facets[series][]": {"type": "string", "default": "RNGWHHD"},
+          "start":     {"type": "string"},
+          "end":       {"type": "string"},
+          "length":    {"type": "integer", "default": 100}
+        }
+      }
+    },
+    {
+      "name": "electricity_retail_sales",
+      "description": "Helper: US retail electricity sales by state + sector. Useful for tracking economic activity proxies + crypto-mining-region demand.",
+      "method": "GET",
+      "path": "/electricity/retail-sales/data/",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "frequency": {"type": "string", "enum": ["monthly","quarterly","annual"], "default": "monthly"},
+          "data[0]":   {"type": "string", "default": "sales"},
+          "facets[stateid][]": {"type": "string", "description": "Two-letter state code (US, TX, CA, ...). Default: US (national total)."},
+          "facets[sectorid][]": {"type": "string", "description": "ALL, IND (industrial), COM (commercial), RES (residential), TRA (transport)."},
+          "start":     {"type": "string"},
+          "end":       {"type": "string"},
+          "length":    {"type": "integer", "default": 100}
+        }
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "browse_route"
+  }
+}

package/src/apps/elasticsearch.json

@@ -0,0 +1,282 @@
+{
+  "slug": "elasticsearch",
+  "name": "Elasticsearch",
+  "description": "Distributed search and analytics engine. Index, search, and analyze documents across one or more indices via the Elasticsearch REST API.",
+  "logo": "https://www.google.com/s2/favicons?domain=elastic.co&sz=128",
+  "categories": [
+    "search",
+    "database",
+    "analytics",
+    "logs",
+    "observability",
+    "vector-search"
+  ],
+  "base_url": "https://{{host}}",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "ApiKey {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "API Key",
+        "description": "Encoded Elasticsearch API key (the base64 'encoded' value generated by Kibana > Stack Management > API Keys, or the POST /_security/api_key response field)."
+      },
+      {
+        "name": "host",
+        "label": "Host",
+        "description": "Elasticsearch endpoint without scheme (e.g. 'my-cluster.es.us-east-1.aws.elastic-cloud.com' or 'localhost:9200')."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "search",
+      "description": "Run a search query against one or more indices using the Elasticsearch Query DSL. Returns matching documents with relevance scores, plus optional aggregations.",
+      "method": "POST",
+      "path": "/{index}/_search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Index name or comma-separated list of indices to search (use '_all' or '*' for every index)."
+          },
+          "query": {
+            "type": "object",
+            "description": "Query DSL object (e.g. { match: { title: 'hello' } })."
+          },
+          "size": {
+            "type": "integer",
+            "description": "Maximum number of hits to return. Defaults to 10."
+          },
+          "from": {
+            "type": "integer",
+            "description": "Starting offset for pagination. Defaults to 0."
+          },
+          "sort": {
+            "type": "array",
+            "description": "Sort criteria (e.g. [{ '@timestamp': 'desc' }])."
+          },
+          "aggs": {
+            "type": "object",
+            "description": "Aggregations to compute over matching documents."
+          },
+          "_source": {
+            "description": "Fields to include in each hit's _source. Pass false to exclude _source entirely."
+          }
+        },
+        "required": [
+          "index"
+        ]
+      }
+    },
+    {
+      "name": "get_document",
+      "description": "Retrieve a single document by its _id from a specific index.",
+      "method": "GET",
+      "path": "/{index}/_doc/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Name of the index containing the document."
+          },
+          "id": {
+            "type": "string",
+            "description": "The document's _id."
+          }
+        },
+        "required": [
+          "index",
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "index_document",
+      "description": "Index (create or replace) a document. Provide an id to upsert a specific document, or omit it to let Elasticsearch auto-generate one (uses POST /_doc).",
+      "method": "PUT",
+      "path": "/{index}/_doc/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Target index name. Created automatically if it does not exist (subject to cluster settings)."
+          },
+          "id": {
+            "type": "string",
+            "description": "Document _id. Required for PUT; for auto-generated ids use the bulk_index tool or omit and switch method to POST."
+          },
+          "document": {
+            "type": "object",
+            "description": "Document body to index."
+          },
+          "refresh": {
+            "type": "string",
+            "description": "If 'true' the affected shards are refreshed so the change is visible to search immediately. Use 'wait_for' to block until the next refresh."
+          }
+        },
+        "required": [
+          "index",
+          "id",
+          "document"
+        ]
+      }
+    },
+    {
+      "name": "delete_document",
+      "description": "Delete a document by its _id from a specific index.",
+      "method": "DELETE",
+      "path": "/{index}/_doc/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Name of the index containing the document."
+          },
+          "id": {
+            "type": "string",
+            "description": "The document's _id."
+          }
+        },
+        "required": [
+          "index",
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "bulk",
+      "description": "Perform multiple index, create, update, or delete operations in a single request using the Elasticsearch bulk API. The body must follow the newline-delimited JSON format described in Elasticsearch docs.",
+      "method": "POST",
+      "path": "/_bulk",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "body": {
+            "type": "string",
+            "description": "Newline-delimited JSON: each action line (e.g. { 'index': { '_index': 'foo', '_id': '1' } }) followed by its document, ending with a final newline."
+          },
+          "refresh": {
+            "type": "string",
+            "description": "Refresh behavior: 'true', 'false', or 'wait_for'."
+          }
+        },
+        "required": [
+          "body"
+        ]
+      }
+    },
+    {
+      "name": "list_indices",
+      "description": "List all indices in the cluster with their health, document count, and size, via the _cat/indices API. Returns JSON when format=json is set.",
+      "method": "GET",
+      "path": "/_cat/indices",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "format": {
+            "type": "string",
+            "description": "Response format. Use 'json' for structured output."
+          },
+          "v": {
+            "type": "boolean",
+            "description": "Include column headers when format is the default plain text."
+          }
+        }
+      }
+    },
+    {
+      "name": "create_index",
+      "description": "Create a new index, optionally specifying mappings, settings, and aliases.",
+      "method": "PUT",
+      "path": "/{index}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Name of the index to create."
+          },
+          "mappings": {
+            "type": "object",
+            "description": "Field mappings for the index (e.g. { properties: { title: { type: 'text' } } })."
+          },
+          "settings": {
+            "type": "object",
+            "description": "Index-level settings such as number_of_shards and number_of_replicas."
+          },
+          "aliases": {
+            "type": "object",
+            "description": "Aliases to associate with the new index."
+          }
+        },
+        "required": [
+          "index"
+        ]
+      }
+    },
+    {
+      "name": "delete_index",
+      "description": "Delete an index and all of its documents. This action is irreversible.",
+      "method": "DELETE",
+      "path": "/{index}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Name of the index to delete."
+          }
+        },
+        "required": [
+          "index"
+        ]
+      }
+    },
+    {
+      "name": "count",
+      "description": "Return the number of documents matching a query (or all documents in the index if no query is provided).",
+      "method": "POST",
+      "path": "/{index}/_count",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "string",
+            "description": "Index name or comma-separated list of indices."
+          },
+          "query": {
+            "type": "object",
+            "description": "Optional Query DSL object to scope the count."
+          }
+        },
+        "required": [
+          "index"
+        ]
+      }
+    },
+    {
+      "name": "cluster_health",
+      "description": "Return the cluster health status (green/yellow/red), node counts, and shard statistics.",
+      "method": "GET",
+      "path": "/_cluster/health",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "level": {
+            "type": "string",
+            "description": "Detail level: 'cluster', 'indices', or 'shards'."
+          }
+        }
+      }
+    }
+  ]
+}