@apteva/integrations 0.15.10 → 0.15.11

package/src/apps/deepgram.json

@@ -14,7 +14,7 @@
       {
         "name": "api_key",
         "label": "Deepgram API Key",
-        "description": "Create one at https://console.deepgram.com/project/default/keys — needs usage:write scope."
+        "description": "Create one at https://console.deepgram.com/project/default/keys. Speech calls need the normal request scopes; reporting tools need usage:read, and billing/balance/purchase tools need billing:read."
       }
     ]
   },
@@ -345,6 +345,293 @@
         },
         "required": ["project_id", "model_id"]
       }
+    },
+    {
+      "name": "get_usage",
+      "description": "Get raw Deepgram usage records for a project over a date range. Use this for detailed request-level usage auditing before summarizing cost. Dates use YYYY-MM-DD. Start with list_usage_fields to discover valid models, tags, features, and processing methods.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/usage",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          },
+          "start": {
+            "type": "string",
+            "description": "Start date, YYYY-MM-DD."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date, YYYY-MM-DD."
+          },
+          "accessor": {
+            "type": "string",
+            "description": "Filter by accessor UUID."
+          },
+          "deployment": {
+            "type": "string",
+            "description": "Filter by deployment type such as hosted, beta, self-hosted, or dedicated."
+          },
+          "endpoint": {
+            "type": "string",
+            "description": "Filter by API endpoint."
+          },
+          "method": {
+            "type": "string",
+            "description": "Filter by processing method, for example sync, async, or streaming."
+          },
+          "model": {
+            "type": "string",
+            "description": "Filter by model id."
+          },
+          "tag": {
+            "type": "string",
+            "description": "Filter by request tag."
+          },
+          "language": {
+            "type": "string",
+            "description": "Filter by language code."
+          },
+          "punctuate": {
+            "type": "boolean",
+            "description": "Filter by whether punctuate was enabled."
+          },
+          "smart_format": {
+            "type": "boolean",
+            "description": "Filter by whether smart_format was enabled."
+          },
+          "diarize": {
+            "type": "boolean",
+            "description": "Filter by whether diarize was enabled."
+          },
+          "detect_language": {
+            "type": "boolean",
+            "description": "Filter by whether language detection was enabled."
+          },
+          "summarize": {
+            "type": "string",
+            "description": "Filter by summarization setting."
+          },
+          "topics": {
+            "type": "boolean",
+            "description": "Filter by whether topic detection was enabled."
+          },
+          "intents": {
+            "type": "boolean",
+            "description": "Filter by whether intent detection was enabled."
+          },
+          "sentiment": {
+            "type": "boolean",
+            "description": "Filter by whether sentiment analysis was enabled."
+          }
+        },
+        "required": ["project_id"]
+      },
+      "query_params": ["start", "end", "accessor", "deployment", "endpoint", "method", "model", "tag", "language", "punctuate", "smart_format", "diarize", "detect_language", "summarize", "topics", "intents", "sentiment"]
+    },
+    {
+      "name": "get_usage_breakdown",
+      "description": "Aggregate Deepgram usage for a project by fields such as accessor, endpoint, feature_set, models, method, tags, and deployment. Use this to answer questions like which models or tags drove usage this month.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/usage/breakdown",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          },
+          "start": {
+            "type": "string",
+            "description": "Start date, YYYY-MM-DD."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date, YYYY-MM-DD."
+          },
+          "grouping": {
+            "type": "array",
+            "description": "Fields to group by. Official values: accessor, endpoint, feature_set, models, method, tags, deployment.",
+            "items": {
+              "type": "string",
+              "enum": ["accessor", "endpoint", "feature_set", "models", "method", "tags", "deployment"]
+            }
+          },
+          "accessor": {
+            "type": "string",
+            "description": "Filter by accessor UUID."
+          },
+          "deployment": {
+            "type": "string",
+            "description": "Filter by deployment type."
+          },
+          "endpoint": {
+            "type": "string",
+            "description": "Filter by API endpoint."
+          },
+          "method": {
+            "type": "string",
+            "description": "Filter by processing method."
+          },
+          "model": {
+            "type": "string",
+            "description": "Filter by model id."
+          },
+          "tag": {
+            "type": "string",
+            "description": "Filter by request tag."
+          },
+          "language": {
+            "type": "string",
+            "description": "Filter by language code."
+          }
+        },
+        "required": ["project_id"]
+      },
+      "query_params": ["start", "end", "grouping", "accessor", "deployment", "endpoint", "method", "model", "tag", "language"]
+    },
+    {
+      "name": "list_usage_fields",
+      "description": "List usage filter fields available for a project in a date range: tags, models, processing methods, and features. Call this before get_usage or get_usage_breakdown when an agent needs valid filter values.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/usage/fields",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          },
+          "start": {
+            "type": "string",
+            "description": "Start date, YYYY-MM-DD."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date, YYYY-MM-DD."
+          }
+        },
+        "required": ["project_id"]
+      },
+      "query_params": ["start", "end"]
+    },
+    {
+      "name": "get_billing_breakdown",
+      "description": "Get Deepgram billing cost breakdown for a project. Results include USD dollar amounts, so this is the primary tool for questions like 'how much did Deepgram cost this month?' Use start/end dates in YYYY-MM-DD and optional grouping such as accessor, deployment, line_item, or tags.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/billing/breakdown",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          },
+          "start": {
+            "type": "string",
+            "description": "Start date, YYYY-MM-DD."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date, YYYY-MM-DD."
+          },
+          "grouping": {
+            "type": "array",
+            "description": "Fields to group by. Official values include accessor, deployment, line_item, and tags.",
+            "items": {
+              "type": "string",
+              "enum": ["accessor", "deployment", "line_item", "tags"]
+            }
+          },
+          "accessor": {
+            "type": "string",
+            "description": "Filter by accessor UUID."
+          },
+          "deployment": {
+            "type": "string",
+            "description": "Filter by deployment type."
+          },
+          "tag": {
+            "type": "string",
+            "description": "Filter by billing tag."
+          },
+          "line_item": {
+            "type": "string",
+            "description": "Filter by billing line item."
+          }
+        },
+        "required": ["project_id"]
+      },
+      "query_params": ["start", "end", "grouping", "accessor", "deployment", "tag", "line_item"]
+    },
+    {
+      "name": "list_billing_fields",
+      "description": "List billing filter fields available for a project in a date range: accessors, deployments, tags, and line_items. Use this to discover valid filters before get_billing_breakdown.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/billing/fields",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          },
+          "start": {
+            "type": "string",
+            "description": "Start date, YYYY-MM-DD."
+          },
+          "end": {
+            "type": "string",
+            "description": "End date, YYYY-MM-DD."
+          }
+        },
+        "required": ["project_id"]
+      },
+      "query_params": ["start", "end"]
+    },
+    {
+      "name": "list_balances",
+      "description": "List outstanding Deepgram balances for a project, including amount, units, balance_id, and purchase_order_id.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/balances",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          }
+        },
+        "required": ["project_id"]
+      }
+    },
+    {
+      "name": "list_purchases",
+      "description": "List Deepgram project purchases and order transactions, including amount, units, created date, expiration, order_id, and order_type.",
+      "method": "GET",
+      "path": "/v1/projects/{project_id}/purchases",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": {
+            "type": "string",
+            "description": "Target project id from list_projects."
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Number of purchases to return. Default 10, maximum 1000.",
+            "minimum": 1,
+            "maximum": 1000
+          }
+        },
+        "required": ["project_id"]
+      },
+      "query_params": ["limit"]
     }
   ]
 }

package/src/apps/elevenlabs.json

@@ -539,6 +539,15 @@
             "maxLength": 1000,
             "description": "Description of the voice to create, including age, gender, accent, tone, pacing, and audio quality."
           },
+          "model_id": {
+            "type": "string",
+            "enum": [
+              "eleven_ttv_v3",
+              "eleven_multilingual_ttv_v2"
+            ],
+            "default": "eleven_ttv_v3",
+            "description": "ElevenLabs Voice Design model. Use eleven_ttv_v3 for the newer expressive voice design model, or eleven_multilingual_ttv_v2 for the previous multilingual voice design model."
+          },
           "text": {
             "type": "string",
             "minLength": 100,

package/src/apps/gladia.json

@@ -0,0 +1,158 @@
+{
+  "slug": "gladia",
+  "name": "Gladia",
+  "description": "Gladia v2 speech-to-text API for pre-recorded transcription, uploads, diarization, translation, summarization, subtitles, sentiment, NER, PII redaction, and custom metadata.",
+  "logo": "https://www.google.com/s2/favicons?domain=gladia.io&sz=128",
+  "categories": ["ai", "speech", "speech-to-text", "transcription", "audio-intelligence"],
+  "base_url": "https://api.gladia.io",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {
+      "x-gladia-key": "{{api_key}}",
+      "Content-Type": "application/json"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "Gladia API key from app.gladia.io/apikeys."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "upload_audio_url",
+      "description": "Ask Gladia to ingest an audio/video URL and return a Gladia audio_url usable by create_transcription.",
+      "method": "POST",
+      "path": "/v2/upload",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "audio_url": { "type": "string", "description": "Publicly reachable audio or video URL." }
+        },
+        "required": ["audio_url"]
+      }
+    },
+    {
+      "name": "upload_audio_file",
+      "description": "Upload an audio/video file to Gladia and return a Gladia audio_url usable by create_transcription.",
+      "method": "POST",
+      "path": "/v2/upload",
+      "timeout_ms": 600000,
+      "multipart_form": {
+        "file_fields": { "audio": "audio" }
+      },
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "audio": { "type": "string", "description": "Audio/video file content as blobref://, base64, data URL, or raw string." },
+          "audio_filename": { "type": "string", "description": "Optional filename for the multipart upload." }
+        },
+        "required": ["audio"]
+      }
+    },
+    {
+      "name": "create_transcription",
+      "description": "Initiate a Gladia v2 pre-recorded transcription. Use audio_url from upload_audio_url/upload_audio_file or an external URL. Optional add-ons include diarization, subtitles, translation, summarization, NER, sentiment, PII redaction, audio_to_llm, sentences, and custom metadata.",
+      "method": "POST",
+      "path": "/v2/pre-recorded",
+      "timeout_ms": 600000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "audio_url": { "type": "string" },
+          "model": { "type": "string", "description": "solaria-1 or solaria-3 where available." },
+          "language_config": { "type": "object", "description": "Language config, e.g. {\"languages\":[\"en\"],\"code_switching\":false}." },
+          "callback": { "type": "boolean" },
+          "callback_config": { "type": "object" },
+          "diarization": { "type": "boolean" },
+          "diarization_config": { "type": "object" },
+          "subtitles": { "type": "boolean" },
+          "subtitles_config": { "type": "object" },
+          "translation": { "type": "boolean" },
+          "translation_config": { "type": "object" },
+          "summarization": { "type": "boolean" },
+          "summarization_config": { "type": "object" },
+          "named_entity_recognition": { "type": "boolean" },
+          "sentiment_analysis": { "type": "boolean" },
+          "pii_redaction": { "type": "boolean" },
+          "pii_redaction_config": { "type": "object" },
+          "audio_to_llm": { "type": "boolean" },
+          "audio_to_llm_config": { "type": "object" },
+          "custom_vocabulary": { "type": ["boolean", "array"] },
+          "custom_vocabulary_config": { "type": "object" },
+          "custom_spelling": { "type": "boolean" },
+          "custom_spelling_config": { "type": "object" },
+          "custom_metadata": { "type": "object" },
+          "sentences": { "type": "boolean" },
+          "punctuation_enhanced": { "type": "boolean" }
+        },
+        "required": ["audio_url"]
+      }
+    },
+    {
+      "name": "create_transcription_raw",
+      "description": "Initiate a Gladia pre-recorded transcription with a raw request body. Use this when the standard tool schema does not expose a new Gladia option yet.",
+      "method": "POST",
+      "path": "/v2/pre-recorded",
+      "timeout_ms": 600000,
+      "body_root_param": "body",
+      "input_schema": { "type": "object", "properties": { "body": { "type": "object" } }, "required": ["body"] }
+    },
+    {
+      "name": "list_transcriptions",
+      "description": "List Gladia pre-recorded transcriptions with pagination, date, status, and metadata filters.",
+      "method": "GET",
+      "path": "/v2/pre-recorded",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "offset": { "type": "integer" },
+          "limit": { "type": "integer" },
+          "date": { "type": "string" },
+          "before_date": { "type": "string" },
+          "after_date": { "type": "string" },
+          "status": { "type": "string", "description": "queued, processing, done, or error." }
+        }
+      }
+    },
+    {
+      "name": "get_transcription",
+      "description": "Get a Gladia pre-recorded transcription status, parameters, and result. Result is available when status is done.",
+      "method": "GET",
+      "path": "/v2/pre-recorded/{id}",
+      "timeout_ms": 300000,
+      "input_schema": { "type": "object", "properties": { "id": { "type": "string" } }, "required": ["id"] }
+    },
+    {
+      "name": "download_audio",
+      "description": "Download the audio file used by a Gladia pre-recorded transcription.",
+      "method": "GET",
+      "path": "/v2/pre-recorded/{id}/file",
+      "timeout_ms": 600000,
+      "input_schema": { "type": "object", "properties": { "id": { "type": "string" } }, "required": ["id"] }
+    },
+    {
+      "name": "delete_transcription",
+      "description": "Delete a Gladia pre-recorded transcription and all related data.",
+      "method": "DELETE",
+      "path": "/v2/pre-recorded/{id}",
+      "input_schema": { "type": "object", "properties": { "id": { "type": "string" } }, "required": ["id"] }
+    }
+  ],
+  "webhooks": {
+    "signature_header": "x-gladia-key",
+    "events": [
+      { "name": "transcription.created", "description": "A Gladia pre-recorded transcription was created." },
+      { "name": "transcription.success", "description": "A Gladia pre-recorded transcription completed successfully." },
+      { "name": "transcription.error", "description": "A Gladia pre-recorded transcription failed." }
+    ],
+    "registration": {
+      "method": "POST",
+      "path": "/",
+      "url_field": "url",
+      "manual_setup": "Gladia callbacks are configured per transcription request with callback=true and callback_config.url. This integration does not auto-register a global webhook."
+    }
+  },
+  "health_check": { "tool": "list_transcriptions", "input": { "limit": 1 } }
+}

package/src/apps/gmail.json

@@ -462,7 +462,7 @@
     },
     {
       "name": "list_threads",
-      "description": "List email thread IDs with optional search. Returns thread IDs and snippets \u2014 use gmail-get-thread to fetch full conversation messages",
+      "description": "List email thread IDs with optional search. Returns thread IDs and snippets. Use gmail_get_thread first to inspect a compact latest-message summary, then fetch a specific message with gmail_get_message only when body text is needed.",
       "method": "GET",
       "path": "/users/me/threads",
       "input_schema": {
@@ -509,7 +509,7 @@
     },
     {
       "name": "get_thread",
-      "description": "Get an email thread efficiently. Defaults to metadata-only so long conversations do not flood the agent context. Use this first to inspect senders, dates, subjects, snippets, labels, and message IDs. If you need full body text, fetch only the specific message(s) you need with gmail_get_message; avoid format=full on large threads unless explicitly necessary.",
+      "description": "Get a compact email thread index. Output includes thread id, history id, messageCount, messageIds, and messages with compact per-message metadata/snippet only. It intentionally does not return message bodies, HTML, or attachments. Use this first to choose which message IDs matter, then call gmail_get_message for the specific body/content needed.",
       "method": "GET",
       "path": "/users/me/threads/{threadId}",
       "input_schema": {
@@ -583,9 +583,6 @@
             "sizeEstimate": 2048
           }
         ]
-      },
-      "response_transform": {
-        "type": "email_thread"
       }
     },
     {