@apteva/integrations 0.3.19 → 0.3.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apteva/integrations",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Local integrations, connections, and webhooks for Apteva. Self-contained app templates, OAuth engine, and trigger provider.",
   "author": "Apteva <hello@apteva.com>",
   "license": "Elastic-2.0",

package/src/apps/omnikit-analytics.json

@@ -33,23 +33,17 @@
   "tools": [
     {
       "name": "list_sources",
-      "description": "Get available analytics sources (web, patreon, youtube, stripe, etc.) and their metrics. Shows which sources have data and summary statistics.",
+      "description": "ALWAYS call this first before importing or querying metrics. Returns all configured analytics sources with their available metric names, including sources without data yet. The response contains the exact metric_name values needed for import-metrics and query-metrics. Sources with has_data=false still have valid metrics that can be imported into.",
       "method": "GET",
       "path": "/analytics/sources",
       "input_schema": {
         "type": "object",
-        "properties": {
-          "include_empty": {
-            "type": "boolean",
-            "description": "Include sources without data (shows all configured sources)",
-            "default": true
-          }
-        }
+        "properties": {}
       }
     },
     {
       "name": "import_metrics",
-      "description": "Import external/platform-specific metrics directly. Supports single metric or bulk import. Use for YouTube views, Patreon patrons, social media stats, etc.",
+      "description": "Import metrics data. First call list-sources to discover the exact metric_name values available for each source. Supports single metric or bulk import via the metrics array.",
       "method": "POST",
       "path": "/analytics/metrics/import",
       "input_schema": {
@@ -57,7 +51,7 @@
         "properties": {
           "metric_name": {
             "type": "string",
-            "description": "Metric name for single import (e.g., 'youtube_views', 'patreon_patrons')"
+            "description": "Metric name for single import - use exact values from list-sources"
           },
           "value": {
             "type": "number",
@@ -83,7 +77,7 @@
           },
           "source": {
             "type": "string",
-            "description": "Source platform (e.g., 'youtube', 'patreon', 'twitter', 'instagram', 'stripe')"
+            "description": "Source platform identifier - use the source id from list-sources"
           },
           "dimensions": {
             "type": "object",
@@ -133,7 +127,7 @@
     },
     {
       "name": "query_metrics",
-      "description": "Query pre-aggregated metrics data with flexible filtering, grouping, and date ranges. Returns time-series data for charts and reports.",
+      "description": "Query metrics data with flexible filtering, grouping, and date ranges. First call list-sources to discover available metric_name values. Returns time-series data for charts and reports.",
       "method": "GET",
       "path": "/analytics/metrics/{metric_name}",
       "input_schema": {

package/src/apps/omnikit-storage.json

@@ -57,16 +57,16 @@
       "name": "get_file",
       "description": "Get detailed file info including optional transcripts and thumbnails",
       "method": "GET",
-      "path": "/files/{{id}}",
+      "path": "/files/{file_id}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "id": { "type": "integer", "description": "File ID" },
+          "file_id": { "type": "integer", "description": "File ID" },
           "include_transcripts": { "type": "boolean", "default": false, "description": "Include transcript metadata" },
           "include_transcript_segments": { "type": "boolean", "default": false, "description": "Include transcript segments with timecodes" },
           "include_thumbnails": { "type": "boolean", "default": false, "description": "Include thumbnail URLs" }
         },
-        "required": ["id"]
+        "required": ["file_id"]
       }
     },
     {
@@ -92,32 +92,32 @@
       "name": "update_file",
       "description": "Update file metadata, tags, or move to a different folder",
       "method": "PUT",
-      "path": "/files/{{id}}",
+      "path": "/files/{file_id}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "id": { "type": "integer", "description": "File ID to update" },
+          "file_id": { "type": "integer", "description": "File ID to update" },
           "name": { "type": "string", "description": "New file name" },
           "description": { "type": "string", "description": "New description" },
           "folder_id": { "type": "integer", "description": "Move to different folder" },
           "tags": { "type": "array", "items": { "type": "string" }, "description": "Update tags" },
           "access_level": { "type": "string", "enum": ["private", "public"], "description": "Update access level" }
         },
-        "required": ["id"]
+        "required": ["file_id"]
       }
     },
     {
       "name": "delete_file",
       "description": "Delete a file from storage",
       "method": "DELETE",
-      "path": "/files/{{id}}",
+      "path": "/files/{file_id}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "id": { "type": "integer", "description": "File ID to delete" },
+          "file_id": { "type": "integer", "description": "File ID to delete" },
           "force": { "type": "boolean", "default": false, "description": "Force delete without trash" }
         },
-        "required": ["id"]
+        "required": ["file_id"]
       }
     },
     {