@apteva/integrations 0.3.61 → 0.15.3

package/src/apps/fred.json

@@ -0,0 +1,156 @@
+{
+  "slug": "fred",
+  "name": "FRED — Federal Reserve Economic Data",
+  "description": "FRED is the St. Louis Fed's economic data warehouse — the authoritative source for ~830,000 US and international macro time series: CPI, unemployment, GDP, Fed funds rate, Treasury yields, M2, mortgage rates, dollar index, oil price, and basically every other macroeconomic indicator a trading agent might want. Free, official, and the API has been stable for over a decade. Required for any agent reasoning about Fed policy, recession risk, inflation, or other macro-driven prediction markets and equities trades. Sign up at https://fredaccount.stlouisfed.org/apikeys for a free api_key.",
+  "logo": "https://www.google.com/s2/favicons?domain=stlouisfed.org&sz=128",
+  "categories": [
+    "finance",
+    "economy",
+    "macro",
+    "research",
+    "fed",
+    "public-data"
+  ],
+  "base_url": "https://api.stlouisfed.org/fred",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "api_key": "{{api_key}}",
+      "file_type": "json"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "FRED API Key",
+        "description": "32-char alphanumeric key from https://fredaccount.stlouisfed.org/apikeys. Free, no rate limit cap; FRED requests you 'be reasonable'."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "series_observations",
+      "description": "Get the time-series values for a FRED series. The most common call — feed it a series_id like 'UNRATE' (unemployment rate), 'CPIAUCSL' (headline CPI), 'FEDFUNDS' (Fed funds rate), 'DGS10' (10-year Treasury), 'GDPC1' (real GDP), etc. Returns date+value pairs. Use limit + offset for big series; use sort_order=desc for the latest first.",
+      "method": "GET",
+      "path": "/series/observations",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "series_id":           {"type": "string", "description": "FRED series id (UNRATE, CPIAUCSL, FEDFUNDS, DGS10, GDPC1, etc.)."},
+          "observation_start":   {"type": "string", "description": "YYYY-MM-DD, default is the series' first observation."},
+          "observation_end":     {"type": "string", "description": "YYYY-MM-DD, default is the latest available."},
+          "limit":               {"type": "integer", "description": "1-100000. Default 100000."},
+          "offset":              {"type": "integer", "description": "Pagination offset."},
+          "sort_order":          {"type": "string", "enum": ["asc", "desc"], "description": "default asc (oldest first); use desc for latest first"},
+          "units":               {"type": "string", "enum": ["lin","chg","ch1","pch","pc1","pca","cch","cca","log"], "description": "lin=levels (default), pch=% change period-over-period, pc1=% change year-over-year, log=natural log."},
+          "frequency":           {"type": "string", "enum": ["d","w","bw","m","q","sa","a"], "description": "Down-sample frequency — d=daily, w=weekly, m=monthly, q=quarterly, a=annual."},
+          "aggregation_method":  {"type": "string", "enum": ["avg","sum","eop"], "description": "How to aggregate when frequency is coarser than source. eop=end-of-period."}
+        },
+        "required": ["series_id"]
+      }
+    },
+    {
+      "name": "series_search",
+      "description": "Find a FRED series by free-text query. Use this when the agent knows the concept (e.g. 'US unemployment rate', 'core CPI services') but not the exact series_id. Returns matches with id + title + frequency + units + last-update.",
+      "method": "GET",
+      "path": "/series/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "search_text": {"type": "string", "description": "Free-text query — 'unemployment', '10 year treasury', 'core cpi services'."},
+          "limit":       {"type": "integer", "description": "Max matches. Default 1000."},
+          "search_type": {"type": "string", "enum": ["full_text", "series_id"], "description": "full_text searches title+notes; series_id matches the id literally."},
+          "order_by":    {"type": "string", "description": "search_rank, series_id, title, units, frequency, observation_start, observation_end, popularity, last_updated."}
+        },
+        "required": ["search_text"]
+      }
+    },
+    {
+      "name": "series_info",
+      "description": "Get the metadata for one series — title, frequency, units, observation range, last-updated, notes. Use after a search to confirm you've got the right thing before pulling observations.",
+      "method": "GET",
+      "path": "/series",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "series_id": {"type": "string"}
+        },
+        "required": ["series_id"]
+      }
+    },
+    {
+      "name": "category_children",
+      "description": "Browse FRED's category tree — alternative to free-text search. Root category id is 0. Use this when exploring a topic ('Money, Banking, & Finance' → 'Interest Rates' → ...).",
+      "method": "GET",
+      "path": "/category/children",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "category_id": {"type": "integer", "description": "FRED category id, 0 = root."}
+        }
+      }
+    },
+    {
+      "name": "category_series",
+      "description": "List every series in a given FRED category. Useful after category_children to enumerate what's available under a topic.",
+      "method": "GET",
+      "path": "/category/series",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "category_id": {"type": "integer"},
+          "limit":       {"type": "integer"},
+          "offset":      {"type": "integer"},
+          "order_by":    {"type": "string"}
+        },
+        "required": ["category_id"]
+      }
+    },
+    {
+      "name": "release_dates",
+      "description": "Calendar of upcoming + recent FRED release dates — when CPI prints, when jobs report drops, etc. Critical for macro prediction markets where the agent wants to know 'when does the next number land?'.",
+      "method": "GET",
+      "path": "/release/dates",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "release_id": {"type": "integer", "description": "FRED release id (50=CPI, 76=Employment Situation, 53=Industrial Production, etc.)."},
+          "limit":      {"type": "integer"},
+          "sort_order": {"type": "string", "enum": ["asc","desc"], "description": "desc returns nearest dates first."}
+        },
+        "required": ["release_id"]
+      }
+    },
+    {
+      "name": "releases",
+      "description": "List every release FRED tracks. Use to discover release_ids to feed release_dates.",
+      "method": "GET",
+      "path": "/releases",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit":  {"type": "integer"},
+          "offset": {"type": "integer"}
+        }
+      }
+    },
+    {
+      "name": "series_updates",
+      "description": "Recently-updated series across FRED. Use as a heartbeat — 'what new data landed in the last day/week?'.",
+      "method": "GET",
+      "path": "/series/updates",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit":            {"type": "integer"},
+          "filter_value":     {"type": "string", "enum": ["macro","regional","all"], "description": "Filter by series scope."},
+          "start_time":       {"type": "string", "description": "YYYYMMDDHhmm format — observations updated on or after."},
+          "end_time":         {"type": "string", "description": "YYYYMMDDHhmm format."}
+        }
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "series_info",
+    "args": {"series_id": "GDP"}
+  }
+}

package/src/apps/gdelt.json

@@ -0,0 +1,96 @@
+{
+  "slug": "gdelt",
+  "name": "GDELT",
+  "description": "The Global Database of Events, Language, and Tone — every news article from 80,000+ sources worldwide, tagged with location, actors, themes, sentiment, and emotion (since 2015 for v2). Updated every 15 minutes. The most comprehensive free real-time geopolitical signal source — useful for war/treaty/election markets, country-risk assessment, and 'is X happening' sentinel queries. No auth required. Several different APIs under one umbrella: DOC (article search), GEO (geographic distribution), GKG (Global Knowledge Graph), Events.",
+  "logo": "https://www.google.com/s2/favicons?domain=gdeltproject.org&sz=128",
+  "categories": [
+    "news",
+    "geopolitics",
+    "events",
+    "research",
+    "public-data",
+    "sentiment"
+  ],
+  "base_url": "https://api.gdeltproject.org/api/v2",
+  "auth": {
+    "types": ["none"],
+    "headers": {
+      "User-Agent": "Apteva-Trading-Agent/1.0"
+    },
+    "credential_fields": []
+  },
+  "tools": [
+    {
+      "name": "doc_search",
+      "description": "Full-text article search across GDELT's worldwide corpus. Returns ArtList = list of matching articles (title, url, domain, language, country, date, image, themes, social-image). Powerful query syntax: 'biden AND trump', '\"interest rate\" AND fed', 'sourcecountry:US AND theme:ECON_INTEREST_RATES'. Use mode=ArtList for articles; TimelineVol/TimelineTone/TimelineLang/TimelineSourceCountry for aggregations.",
+      "method": "GET",
+      "path": "/doc/doc",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query":      {"type": "string", "description": "GDELT DOC query. Supports operators: AND/OR/NOT, parens, themes (theme:ECON_INTEREST_RATES), countries (sourcecountry:US), languages (sourcelang:eng), 'image:airplane' for visual themes."},
+          "mode":       {"type": "string", "enum": ["ArtList","ArtGallery","ImageCollage","TimelineVol","TimelineVolRaw","TimelineTone","TimelineLang","TimelineSourceCountry","WordCloudEnglish","WordCloudImageTags"], "default": "ArtList"},
+          "format":     {"type": "string", "enum": ["json","jsonp","csv","html"], "default": "json"},
+          "timespan":   {"type": "string", "description": "Time window for the query. Format: '24h', '7d', '14d', '30d', 'CUSTOM' (then use startdatetime + enddatetime). Max 90d in one call."},
+          "startdatetime": {"type": "string", "description": "YYYYMMDDHHMMSS (UTC). Use with timespan=CUSTOM."},
+          "enddatetime":   {"type": "string", "description": "YYYYMMDDHHMMSS (UTC)."},
+          "maxrecords": {"type": "integer", "description": "Max articles (1-250). Default 75."},
+          "sort":       {"type": "string", "enum": ["DateDesc","DateAsc","ToneDesc","ToneAsc","HybridRel"], "default": "DateDesc"}
+        },
+        "required": ["query"]
+      }
+    },
+    {
+      "name": "doc_timeline_volume",
+      "description": "Time-series volume of articles matching a query — shows how many sources are covering the topic over time. Spikes correlate with real-world events (elections, market crashes, geopolitical incidents). Convenience wrapper around doc_search with mode=TimelineVol.",
+      "method": "GET",
+      "path": "/doc/doc",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query":    {"type": "string"},
+          "timespan": {"type": "string", "default": "30d"},
+          "format":   {"type": "string", "default": "json"},
+          "mode":     {"type": "string", "default": "TimelineVol"}
+        },
+        "required": ["query"]
+      }
+    },
+    {
+      "name": "doc_timeline_tone",
+      "description": "Aggregate sentiment-tone timeline (positive vs negative coverage) for articles matching a query. Useful for tracking media sentiment shifts on a topic over time — Fed coverage tone before/after FOMC, geopolitical sentiment before/after announcements.",
+      "method": "GET",
+      "path": "/doc/doc",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query":    {"type": "string"},
+          "timespan": {"type": "string", "default": "30d"},
+          "format":   {"type": "string", "default": "json"},
+          "mode":     {"type": "string", "default": "TimelineTone"}
+        },
+        "required": ["query"]
+      }
+    },
+    {
+      "name": "geo_distribution",
+      "description": "Geographic distribution of articles matching a query — returns lat/lng points + intensity. Use to see WHERE a story is being covered most heavily, which correlates with where the event is actually happening.",
+      "method": "GET",
+      "path": "/geo/geo",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query":    {"type": "string"},
+          "mode":     {"type": "string", "enum": ["PointData","HeatmapData"], "default": "PointData"},
+          "format":   {"type": "string", "default": "json"},
+          "timespan": {"type": "string", "default": "24h"}
+        },
+        "required": ["query"]
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "doc_search",
+    "args": {"query": "stock market", "timespan": "24h", "maxrecords": 5}
+  }
+}

package/src/apps/gelato.json

@@ -0,0 +1,123 @@
+{
+  "slug": "gelato",
+  "name": "Gelato",
+  "description": "Gelato print-on-demand product catalog API. Search printable products and inspect catalog variants for Catalog import workflows.",
+  "logo": "https://www.google.com/s2/favicons?domain=gelato.com&sz=128",
+  "categories": [
+    "print-on-demand",
+    "ecommerce",
+    "products",
+    "supplier-catalog",
+    "fulfillment",
+    "dropshipping"
+  ],
+  "base_url": "https://product.gelatoapis.com",
+  "auth": {
+    "types": [
+      "api_key"
+    ],
+    "headers": {
+      "X-API-KEY": "{{api_key}}",
+      "Content-Type": "application/json"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "Gelato API key from the Gelato dashboard."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "catalogs_list",
+      "description": "List Gelato product catalogs. Use to discover product families before searching products.",
+      "method": "GET",
+      "path": "/v3/catalogs",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "catalog_get",
+      "description": "Get a Gelato catalog by catalog UID, including product families and available catalog metadata.",
+      "method": "GET",
+      "path": "/v3/catalogs/{catalogUid}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "catalogUid": {
+            "type": "string",
+            "description": "Gelato catalog UID."
+          }
+        },
+        "required": [
+          "catalogUid"
+        ]
+      }
+    },
+    {
+      "name": "products_search",
+      "description": "Search Gelato products by catalog, product family, country, category, and pagination. Use this as the main Catalog import search source.",
+      "method": "GET",
+      "path": "/v3/products/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "catalogUid": {
+            "type": "string",
+            "description": "Optional catalog UID to scope the search."
+          },
+          "productFamilyUid": {
+            "type": "string",
+            "description": "Optional product family UID to scope the search."
+          },
+          "country": {
+            "type": "string",
+            "description": "Production/destination country code, for example US."
+          },
+          "category": {
+            "type": "string",
+            "description": "Optional Gelato category filter."
+          },
+          "query": {
+            "type": "string",
+            "description": "Free-text product search when supported by Gelato."
+          },
+          "page": {
+            "type": "integer",
+            "default": 1,
+            "description": "Page number."
+          },
+          "limit": {
+            "type": "integer",
+            "default": 50,
+            "description": "Products per page."
+          }
+        }
+      }
+    },
+    {
+      "name": "product_get",
+      "description": "Get a Gelato product by product UID, including variants, printable attributes, dimensions, and catalog metadata.",
+      "method": "GET",
+      "path": "/v3/products/{productUid}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "productUid": {
+            "type": "string",
+            "description": "Gelato product UID."
+          }
+        },
+        "required": [
+          "productUid"
+        ]
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "catalogs_list"
+  }
+}

package/src/apps/gemini.json

@@ -27,11 +27,6 @@
         "name": "api_key",
         "label": "Api Key",
         "description": "Your Google AI API Key (get from https://aistudio.google.com/apikey)"
-      },
-      {
-        "name": "apiKey",
-        "label": "Api Key",
-        "description": "Your Google AI API Key (get from https://aistudio.google.com/apikey)"
       }
     ]
   },
@@ -40,7 +35,7 @@
       "name": "generate_content",
       "description": "Generate text content using Gemini models. Provide a contents array with message parts following the Gemini API format. Supports multimodal input (text, images, audio, video).",
       "method": "POST",
-      "path": "/generate-content",
+      "path": "/models/{model}:generateContent",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -148,9 +143,10 @@
     },
     {
       "name": "generate_image",
-      "description": "Generate images using Gemini models. Uses the native Gemini image generation with responseModalities set to Image. Supports gemini-2.5-flash-image (fast, ~1024px) and gemini-3-pro-image-preview (up to 4K, text rendering).",
+      "description": "Generate images using Gemini models via models/{model}:generateContent. Uses the native Gemini image generation path with responseModalities set to Image. Pass text in contents parts; for reference-image generation, include one or more inlineData image parts in the same contents.",
       "method": "POST",
-      "path": "/generate-image",
+      "path": "/models/{model}:generateContent",
+      "timeout_ms": 180000,
       "input_schema": {
         "type": "object",
         "properties": {
@@ -180,7 +176,7 @@
           },
           "generationConfig": {
             "type": "object",
-            "description": "Must include responseModalities: ['Image']. Can also include imageConfig with aspectRatio and imageSize.",
+            "description": "Must include responseModalities: ['Image']. Can also include responseFormat.image with aspectRatio and imageSize.",
             "properties": {
               "responseModalities": {
                 "type": "array",
@@ -192,40 +188,39 @@
                   "Image"
                 ]
               },
-              "imageConfig": {
+              "responseFormat": {
                 "type": "object",
-                "description": "Image configuration",
+                "description": "Image response format configuration.",
                 "properties": {
-                  "aspectRatio": {
-                    "type": "string",
-                    "enum": [
-                      "1:1",
-                      "2:3",
-                      "3:2",
-                      "3:4",
-                      "4:3",
-                      "4:5",
-                      "5:4",
-                      "9:16",
-                      "16:9",
-                      "21:9"
-                    ],
-                    "default": "1:1"
-                  },
-                  "numberOfImages": {
-                    "type": "integer",
-                    "minimum": 1,
-                    "maximum": 8,
-                    "default": 1
-                  },
-                  "imageSize": {
-                    "type": "string",
-                    "enum": [
-                      "1K",
-                      "2K",
-                      "4K"
-                    ],
-                    "description": "Image size (Pro model only)"
+                  "image": {
+                    "type": "object",
+                    "properties": {
+                      "aspectRatio": {
+                        "type": "string",
+                        "enum": [
+                          "1:1",
+                          "2:3",
+                          "3:2",
+                          "3:4",
+                          "4:3",
+                          "4:5",
+                          "5:4",
+                          "9:16",
+                          "16:9",
+                          "21:9"
+                        ],
+                        "default": "1:1"
+                      },
+                      "imageSize": {
+                        "type": "string",
+                        "enum": [
+                          "1K",
+                          "2K",
+                          "4K"
+                        ],
+                        "description": "Image size (Pro model only)"
+                      }
+                    }
                   }
                 }
               },
@@ -263,11 +258,107 @@
         ]
       }
     },
+    {
+      "name": "edit_image",
+      "description": "Edit an image, compose a new image from multiple references, or transfer style using Gemini image models. Build contents with one text part for the instruction and one or more inlineData image parts for the references.",
+      "method": "POST",
+      "path": "/models/{model}:generateContent",
+      "timeout_ms": 180000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "type": "string",
+            "description": "Gemini image model to use for reference-image editing/composition.",
+            "enum": [
+              "gemini-2.5-flash-image",
+              "gemini-3-pro-image-preview"
+            ],
+            "default": "gemini-2.5-flash-image"
+          },
+          "contents": {
+            "type": "array",
+            "description": "Content array with a prompt part and reference image parts. Example: [{parts:[{text:'put this person in a studio portrait'}, {inlineData:{mimeType:'image/png', data:'base64...'}}, {inlineData:{mimeType:'image/jpeg', data:'base64...'}}]}].",
+            "items": {
+              "type": "object",
+              "properties": {
+                "parts": {
+                  "type": "array",
+                  "items": {
+                    "type": "object"
+                  }
+                }
+              }
+            }
+          },
+          "generationConfig": {
+            "type": "object",
+            "description": "Must include responseModalities: ['Image']. Optional responseFormat.image.aspectRatio controls square/portrait/landscape output; imageSize is for Pro models.",
+            "properties": {
+              "responseModalities": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "default": [
+                  "Image"
+                ]
+              },
+              "responseFormat": {
+                "type": "object",
+                "properties": {
+                  "image": {
+                    "type": "object",
+                    "properties": {
+                      "aspectRatio": {
+                        "type": "string",
+                        "enum": [
+                          "1:1",
+                          "2:3",
+                          "3:2",
+                          "3:4",
+                          "4:3",
+                          "4:5",
+                          "5:4",
+                          "9:16",
+                          "16:9",
+                          "21:9"
+                        ]
+                      },
+                      "imageSize": {
+                        "type": "string",
+                        "enum": [
+                          "1K",
+                          "2K",
+                          "4K"
+                        ]
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "safetySettings": {
+            "type": "array",
+            "description": "Safety filter settings",
+            "items": {
+              "type": "object"
+            }
+          }
+        },
+        "required": [
+          "model",
+          "contents",
+          "generationConfig"
+        ]
+      }
+    },
     {
       "name": "start_video_generation",
       "description": "Generate video from text prompt or animate images using Google Veo. Supports 16:9 landscape and 9:16 portrait, up to 1080p. Returns an operation name to poll with check-video-status.",
       "method": "POST",
-      "path": "/start-video-generation",
+      "path": "/models/{model}:predictLongRunning",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -386,7 +477,7 @@
       "name": "check_video_status",
       "description": "Check the status of a Veo video generation operation. Returns done=true with video URL when complete, or progress percentage when in progress.",
       "method": "GET",
-      "path": "/check-video-status",
+      "path": "/{operationName}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -404,7 +495,7 @@
       "name": "download_video",
       "description": "Download a completed video from Veo generation using the video URL returned by check-video-status",
       "method": "GET",
-      "path": "/download-video",
+      "path": "{videoUrl}",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -423,7 +514,7 @@
       "name": "create_embedding",
       "description": "Create text embeddings using Gemini embedding models. Returns a vector of float values for semantic search, classification, or clustering.",
       "method": "POST",
-      "path": "/create-embedding",
+      "path": "/models/{model}:embedContent",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -474,7 +565,7 @@
       "name": "count_tokens",
       "description": "Count tokens in content for any Gemini model. Returns totalTokens count.",
       "method": "POST",
-      "path": "/count-tokens",
+      "path": "/models/{model}:countTokens",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -513,7 +604,7 @@
       "name": "list_models",
       "description": "List all available Google AI models (Gemini, Veo, Imagen) with their capabilities and limits",
       "method": "GET",
-      "path": "/list-models",
+      "path": "/models",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -529,5 +620,8 @@
         }
       }
     }
-  ]
-}
+  ],
+  "health_check": {
+    "tool": "list_models"
+  }
+}