@apteva/integrations 0.3.47 → 0.3.59

package/src/apps/omnikit-intelligence.json

@@ -137,7 +137,7 @@
     },
     {
       "name": "generate_image",
-      "description": "Generate or edit images with AI. IMPORTANT: You MUST set 'provider' to match your chosen model — provider='google' for gemini-* models, provider='openai' for dall-e-* models. If omitted, the backend does NOT auto-detect and will fail. For image editing or reference images, use model='gemini-3-pro-image-preview' with provider='google'. For text-only generation, dall-e-3 with provider='openai' works well.",
+      "description": "Generate or edit images with AI. Provider is auto-detected from the model name (gemini-* → google, dall-e-*/gpt-image-* → openai), so you can just pass a model. For image editing or reference images, use a Gemini model (e.g. gemini-3-pro-image-preview) and pass the 'images' array.",
       "method": "POST",
       "path": "/ai/generate/image",
       "input_schema": {
@@ -153,15 +153,32 @@
               "openai",
               "google"
             ],
-            "description": "REQUIRED. AI provider — MUST match your model choice. Set 'google' for gemini-* models, 'openai' for dall-e-* models. There is NO auto-detection — if you use a gemini model with provider='openai' (or omit provider), you will get an error."
+            "description": "Optional. AI provider. Auto-detected from the model name if omitted (gemini-* → google, dall-e-*/gpt-image-* → openai). Defaults to openai if neither provider nor model is set."
           },
           "model": {
             "type": "string",
-            "description": "Model ID. Options: 'dall-e-3' (OpenAI — set provider='openai'), 'gemini-3-pro-image-preview' (Google — set provider='google', supports reference images and editing). You MUST also set the provider field to match."
+            "description": "Optional model ID. Options: 'dall-e-3' (OpenAI), 'gpt-image-1' (OpenAI), 'gemini-2.5-flash-image' (Google, fast default), 'gemini-3-pro-image-preview' (Google, supports reference images + editing, best quality). If omitted, a default model for the provider is auto-selected from the catalog."
           },
           "images": {
             "type": "array",
-            "description": "Reference images for generation OR images to edit. Use for: (1) character/style consistency - pass reference photo to maintain appearance, (2) image editing - pass image to modify based on prompt. Format: [{url: 'https://...'}]. Requires model='gemini-3-pro-image-preview'."
+            "description": "Reference images for generation OR images to edit. Use for: (1) character/style consistency - pass a reference photo to maintain appearance, (2) image editing - pass an image to modify based on prompt. Requires a Gemini model (e.g. gemini-3-pro-image-preview). Google only — will error on OpenAI providers.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "description": "HTTPS URL of the image (will be fetched and base64-encoded server-side). Supported types: image/png, image/jpeg, image/webp, image/gif."
+                },
+                "data": {
+                  "type": "string",
+                  "description": "Base64-encoded image data. Alternative to url — provide one or the other."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "MIME type when using 'data' (e.g. image/png, image/jpeg). Defaults to image/png."
+                }
+              }
+            }
           },
           "size": {
             "type": "string",
@@ -208,9 +225,7 @@
           }
         },
         "required": [
-          "prompt",
-          "provider",
-          "model"
+          "prompt"
         ]
       }
     },

package/src/apps/omnikit-sites.json

@@ -0,0 +1,246 @@
+{
+  "slug": "omnikit-sites",
+  "name": "OmniKit Sites",
+  "description": "Block-composed multi-tenant marketing sites: provision tenants from templates, manage pages, granularly patch blocks, and publish via the OmniKit content-site runtime.",
+  "logo": "https://cdn.omnikit.co/cdn/project-10/public/omnikit-sites.png",
+  "categories": [
+    "omnikit",
+    "sites",
+    "cms",
+    "website-builder",
+    "pages",
+    "blocks",
+    "multi-tenant"
+  ],
+  "base_url": "https://api.omnikit.co",
+  "auth": {
+    "types": ["api_key"],
+    "headers": { "X-API-Key": "{{api_key}}" },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "Api Key",
+        "description": "Your OmniKit API key (starts with 'okt_'). The project is determined automatically from the key."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "create_site",
+      "description": "Provision a new content-site tenant: inserts the site row, seeds pages from a template, and registers routing. Returns 202 with status='dns_wait' — reconciler handles DNS/TLS.",
+      "method": "POST",
+      "path": "/content-sites",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": { "type": "integer", "description": "Project owning the site" },
+          "primary_domain": { "type": "string", "description": "Hostname the site will serve (e.g. acme.com)" },
+          "name": { "type": "string", "description": "Human-readable label" },
+          "template": { "type": "string", "default": "minimal", "description": "Template slug to seed content from" },
+          "theme": { "type": "string", "enum": ["auto", "light", "dark"], "default": "auto" },
+          "owner_email": { "type": "string" },
+          "metadata": { "type": "object", "default": {} }
+        },
+        "required": ["project_id", "primary_domain", "name"]
+      }
+    },
+    {
+      "name": "list_sites",
+      "description": "List sites, optionally filtered by project_id or status.",
+      "method": "GET",
+      "path": "/content-sites",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "project_id": { "type": "integer" },
+          "status": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "offset": { "type": "integer", "default": 0 }
+        }
+      }
+    },
+    {
+      "name": "get_site",
+      "description": "Get a site with its domains and recent events.",
+      "method": "GET",
+      "path": "/content-sites/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "id": { "type": "string", "description": "Site ID" } },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "update_site",
+      "description": "Update site fields (name, theme, metadata, owner_email). Does not change domain or project ownership.",
+      "method": "PATCH",
+      "path": "/content-sites/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "theme": { "type": "string", "enum": ["auto", "light", "dark"] },
+          "metadata": { "type": "object" },
+          "owner_email": { "type": "string" }
+        },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "delete_site",
+      "description": "Tear down a site: remove routing, clear content, unlink domains.",
+      "method": "DELETE",
+      "path": "/content-sites/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "id": { "type": "string" } },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "list_pages",
+      "description": "List all pages for a site.",
+      "method": "GET",
+      "path": "/content-sites/{site_id}/pages",
+      "input_schema": {
+        "type": "object",
+        "properties": { "site_id": { "type": "string" } },
+        "required": ["site_id"]
+      }
+    },
+    {
+      "name": "get_page",
+      "description": "Get one page with its title, description, and blocks.",
+      "method": "GET",
+      "path": "/content-sites/{site_id}/pages/{slug}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "site_id": { "type": "string" },
+          "slug": { "type": "string" }
+        },
+        "required": ["site_id", "slug"]
+      }
+    },
+    {
+      "name": "put_page",
+      "description": "Create (if slug is new) or overwrite a page. Body is the full page document.",
+      "method": "PUT",
+      "path": "/content-sites/{site_id}/pages/{slug}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "site_id": { "type": "string" },
+          "slug": { "type": "string", "description": "URL-friendly slug (lowercase, a-z 0-9 - _)" },
+          "title": { "type": "string" },
+          "description": { "type": "string" },
+          "blocks": {
+            "type": "array",
+            "description": "Ordered blocks; each is { type, props }",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": { "type": "string", "description": "Block type name from the site's block registry (e.g. Hero, Features, CTA)" },
+                "props": { "type": "object", "description": "Block-specific props" }
+              },
+              "required": ["type"]
+            }
+          }
+        },
+        "required": ["site_id", "slug", "title", "blocks"]
+      }
+    },
+    {
+      "name": "delete_page",
+      "description": "Delete a page.",
+      "method": "DELETE",
+      "path": "/content-sites/{site_id}/pages/{slug}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "site_id": { "type": "string" },
+          "slug": { "type": "string" }
+        },
+        "required": ["site_id", "slug"]
+      }
+    },
+    {
+      "name": "patch_block",
+      "description": "Granular block edit on a page. One of: merge props at index, insert at index, remove at index, reorder, or JSON-Patch (RFC-6902) on the blocks array.\n\nShapes:\n- Merge: { index, type?, props? } — deep-merges props, optionally replaces type\n- { op: 'remove', index }\n- { op: 'insert', index?, block: { type, props } } — index omitted = append\n- { op: 'reorder', order: [int, ...] } — permutation of current indices\n- { op: 'patch_json', patches: [RFC-6902 ops] }",
+      "method": "PATCH",
+      "path": "/content-sites/{site_id}/pages/{slug}/blocks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "site_id": { "type": "string" },
+          "slug": { "type": "string" },
+          "op": { "type": "string", "enum": ["remove", "insert", "reorder", "patch_json"] },
+          "index": { "type": "integer" },
+          "type": { "type": "string" },
+          "props": { "type": "object" },
+          "block": {
+            "type": "object",
+            "properties": {
+              "type": { "type": "string" },
+              "props": { "type": "object" }
+            }
+          },
+          "order": { "type": "array", "items": { "type": "integer" } },
+          "patches": { "type": "array", "items": { "type": "object" } }
+        },
+        "required": ["site_id", "slug"]
+      }
+    },
+    {
+      "name": "list_templates",
+      "description": "List all available site templates.",
+      "method": "GET",
+      "path": "/content-site-templates",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "get_template",
+      "description": "Get one template with full site_json + pages.",
+      "method": "GET",
+      "path": "/content-site-templates/{slug}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "slug": { "type": "string" } },
+        "required": ["slug"]
+      }
+    }
+  ],
+  "webhooks": {
+    "signature_header": "x-webhook-signature",
+    "registration": {
+      "method": "POST",
+      "path": "/webhooks-register",
+      "url_field": "endpoint_url",
+      "events_field": "event_types",
+      "secret_field": "secret_key",
+      "id_field": "webhook_id",
+      "extra": {
+        "name": "Apteva Webhook",
+        "direction": "outgoing",
+        "provider": "custom",
+        "auth_type": "hmac-sha256"
+      },
+      "delete_path": "/webhooks/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhooks",
+      "list_field": "data"
+    },
+    "events": [
+      { "name": "site.created", "description": "New site provisioned" },
+      { "name": "site.updated", "description": "Site fields updated" },
+      { "name": "site.deleted", "description": "Site torn down" },
+      { "name": "site.content_seeded", "description": "Template content seeded into a site" },
+      { "name": "site.routing_added", "description": "Orchestrator routing registered" },
+      { "name": "site.page_created", "description": "New page created on a site" },
+      { "name": "site.page_updated", "description": "Page overwritten" },
+      { "name": "site.page_deleted", "description": "Page deleted" },
+      { "name": "site.block_patched", "description": "Block granularly edited" }
+    ]
+  }
+}

package/src/apps/pagespeed-insights.json

@@ -0,0 +1,66 @@
+{
+  "slug": "pagespeed-insights",
+  "name": "Google PageSpeed Insights",
+  "description": "Run Google's official Lighthouse audit against any URL. Returns full Lighthouse JSON (Performance, Accessibility, SEO, Best Practices, PWA) PLUS real-user Core Web Vitals data from the Chrome User Experience Report (CrUX) when available. Same engine that powers PageSpeed.web.dev. Free with generous rate limits — works without an API key (anonymous, rate-limited) or with a Google Cloud API key for higher quota.",
+  "logo": "https://www.google.com/s2/favicons?domain=pagespeed.web.dev&sz=128",
+  "categories": ["performance", "seo", "lighthouse", "audit", "google", "web-vitals"],
+  "base_url": "https://www.googleapis.com/pagespeedonline/v5",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {},
+    "query_params": {
+      "key": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "Google Cloud API key (optional — leave blank for the anonymous tier)",
+        "required": false
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "run_pagespeed",
+      "description": "Run Lighthouse + CrUX against a URL and return the full audit. Set strategy='mobile' (default) for the mobile audit or 'desktop' for desktop. Pass `category` once per category you want — performance, accessibility, best-practices, seo, pwa. Default is just performance, which is fastest. Returns the full Lighthouse result JSON nested under `lighthouseResult` and Core Web Vitals under `loadingExperience` (origin-level) and `originLoadingExperience` (URL-level). The agent should pull `lighthouseResult.categories.<cat>.score` for the headline 0-1 score per category, and `lighthouseResult.audits.*` for individual issue details.",
+      "method": "GET",
+      "path": "/runPagespeed",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "description": "The URL to audit"
+          },
+          "strategy": {
+            "type": "string",
+            "enum": ["mobile", "desktop"],
+            "default": "mobile",
+            "description": "Device emulation profile. Mobile is throttled to a slow 4G + mid-tier device; desktop is unthrottled."
+          },
+          "category": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": ["performance", "accessibility", "best-practices", "seo", "pwa"]
+            },
+            "default": ["performance"],
+            "description": "Which Lighthouse categories to run. Each adds latency. Performance only ≈ 15-30s; all five ≈ 30-60s."
+          },
+          "locale": {
+            "type": "string",
+            "description": "BCP-47 language code for the audit messages (e.g. 'en', 'fr', 'es', 'ja')"
+          },
+          "utm_source": { "type": "string", "description": "Optional UTM source for analytics" },
+          "utm_campaign": { "type": "string", "description": "Optional UTM campaign for analytics" },
+          "captchaToken": { "type": "string", "description": "reCAPTCHA token if the API requires one (rare)" }
+        },
+        "required": ["url"]
+      },
+      "query_params": [
+        "url", "strategy", "category", "locale",
+        "utm_source", "utm_campaign", "captchaToken"
+      ]
+    }
+  ]
+}

package/src/apps/socialcast.json

@@ -736,7 +736,7 @@
       "url_field": "endpoint_url",
       "events_field": "event_types",
       "secret_field": "secret_key",
-      "id_field": "id",
+      "id_field": "webhook_id",
       "delete_path": "/webhooks/{id}",
       "delete_method": "DELETE",
       "list_path": "/webhooks",

package/src/apps/webpagetest.json

@@ -0,0 +1,159 @@
+{
+  "slug": "webpagetest",
+  "name": "WebPageTest",
+  "description": "Industry-standard performance testing service from Catchpoint. Runs Lighthouse PLUS its own waterfall analysis, filmstrip capture, video comparison, and multi-run averages from real test locations around the world (~40 regions). Async — submit a test with run_test, get a test ID, then poll get_result until status='completed'.",
+  "logo": "https://www.google.com/s2/favicons?domain=webpagetest.org&sz=128",
+  "categories": ["performance", "lighthouse", "audit", "monitoring", "web-vitals"],
+  "base_url": "https://www.webpagetest.org",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {},
+    "query_params": {
+      "k": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "WebPageTest API key (get one at webpagetest.org/getkey.php)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "run_test",
+      "description": "Submit a new test against a URL. Returns a test ID + URLs for the JSON result and the HTML result page. Set runs > 1 for averaged measurements (each run consumes a credit). Supports custom locations, browsers, connection profiles, scripted user journeys, and Lighthouse-only mode. Returns immediately — poll get_result with the returned testId until the data is ready.",
+      "method": "GET",
+      "path": "/runtest.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string", "description": "The URL to test" },
+          "f": {
+            "type": "string",
+            "enum": ["json", "xml"],
+            "default": "json",
+            "description": "Response format. JSON is what you almost always want."
+          },
+          "runs": {
+            "type": "integer",
+            "default": 1,
+            "minimum": 1,
+            "maximum": 10,
+            "description": "Number of test runs to average (each consumes one test credit)"
+          },
+          "fvonly": {
+            "type": "integer",
+            "enum": [0, 1],
+            "default": 0,
+            "description": "0 = test first AND repeat view, 1 = first view only (faster, half the credits)"
+          },
+          "location": {
+            "type": "string",
+            "default": "Dulles:Chrome",
+            "description": "Test location + browser, e.g. 'Dulles:Chrome', 'London:Chrome', 'ec2-eu-central-1:Chrome'. See /getLocations.php for the full list."
+          },
+          "connectivity": {
+            "type": "string",
+            "enum": ["Cable", "DSL", "3G", "3GFast", "4G", "LTE", "Native"],
+            "default": "Cable",
+            "description": "Connection profile (sets bandwidth + latency + packet loss)"
+          },
+          "lighthouse": {
+            "type": "integer",
+            "enum": [0, 1],
+            "default": 1,
+            "description": "Run a Lighthouse audit alongside the WPT measurements"
+          },
+          "mobile": {
+            "type": "integer",
+            "enum": [0, 1],
+            "default": 0,
+            "description": "Use mobile emulation"
+          },
+          "label": { "type": "string", "description": "Free-text label for this test (shown in the UI)" },
+          "private": { "type": "integer", "enum": [0, 1], "default": 0, "description": "Hide from the public test history" },
+          "video": { "type": "integer", "enum": [0, 1], "default": 0, "description": "Capture filmstrip / video" },
+          "block": { "type": "string", "description": "Comma-separated list of substrings to block from being requested" },
+          "script": { "type": "string", "description": "WPT scripting language for multi-step user journeys (login + measure)" },
+          "pingback": { "type": "string", "description": "URL to call when the test is complete (avoids polling)" }
+        },
+        "required": ["url"]
+      },
+      "query_params": [
+        "url", "f", "runs", "fvonly", "location", "connectivity",
+        "lighthouse", "mobile", "label", "private", "video", "block",
+        "script", "pingback"
+      ]
+    },
+    {
+      "name": "get_result",
+      "description": "Get the result of a previously submitted test. Poll this until `data.statusCode === 200` (test complete). Returns the full WPT result including Lighthouse JSON (under `data.lighthouse`), waterfall data, video frames, and per-run metrics.",
+      "method": "GET",
+      "path": "/jsonResult.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "test": { "type": "string", "description": "Test ID returned by run_test" },
+          "pretty": { "type": "integer", "enum": [0, 1], "default": 1 }
+        },
+        "required": ["test"]
+      },
+      "query_params": ["test", "pretty"]
+    },
+    {
+      "name": "test_status",
+      "description": "Lightweight status check for a running test. Returns just the queue position + status code without the full result body — much smaller than get_result while polling.",
+      "method": "GET",
+      "path": "/testStatus.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "test": { "type": "string" },
+          "f": { "type": "string", "enum": ["json"], "default": "json" }
+        },
+        "required": ["test"]
+      },
+      "query_params": ["test", "f"]
+    },
+    {
+      "name": "cancel_test",
+      "description": "Cancel a queued or running test.",
+      "method": "GET",
+      "path": "/cancelTest.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "test": { "type": "string" }
+        },
+        "required": ["test"]
+      },
+      "query_params": ["test"]
+    },
+    {
+      "name": "list_locations",
+      "description": "List the available test locations (geographic regions + browsers + queue depth). Use this to pick a location that matches your real users' geography.",
+      "method": "GET",
+      "path": "/getLocations.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "f": { "type": "string", "enum": ["json", "xml"], "default": "json" }
+        }
+      },
+      "query_params": ["f"]
+    },
+    {
+      "name": "test_balance",
+      "description": "Get the current API key's remaining test credits.",
+      "method": "GET",
+      "path": "/testBalance.php",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "f": { "type": "string", "enum": ["json"], "default": "json" }
+        }
+      },
+      "query_params": ["f"]
+    }
+  ]
+}