@almadar/core 10.65.0 → 10.67.0

package/dist/patterns/services-registry.json

@@ -1,12 +1,13 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-08-16T04:55:02.135Z",
+  "exportedAt": "2026-08-23T09:11:28.111Z",
   "services": {
     "llm": {
       "name": "llm",
       "description": "LLM service — text generation, classification, extraction, summarization",
       "category": "ai",
       "package": "@almadar/llm",
+      "backend": "production",
       "actions": [
         {
           "name": "generate",
@@ -138,6 +139,27 @@
             "summary": "string",
             "keyPoints": "string[]"
           }
+        },
+        {
+          "name": "embed",
+          "description": "Generate embeddings for an array of texts.",
+          "params": [
+            {
+              "name": "texts",
+              "type": "string[]",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "model",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "embeddings": "number[][]"
+          }
         }
       ],
       "credentials": [
@@ -151,13 +173,15 @@
           "required": false,
           "description": "OpenAI API key (use this OR ANTHROPIC_API_KEY)"
         }
-      ]
+      ],
+      "hooks": []
     },
     "ml": {
       "name": "ml",
       "description": "ML service — model inference on a trained or off-the-shelf model",
       "category": "ai",
       "package": "@almadar/llm",
+      "backend": "production",
       "actions": [
         {
           "name": "infer",
@@ -194,13 +218,15 @@
           "required": true,
           "description": "Kebab-case trait name the serving orbital exposes its /events route under"
         }
-      ]
+      ],
+      "hooks": []
     },
     "data": {
       "name": "data",
       "description": "Data service — CRUD operations on entities",
       "category": "infrastructure",
       "package": "@almadar/server",
+      "backend": "production",
       "actions": [
         {
           "name": "list",
@@ -308,13 +334,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "eventbus": {
       "name": "eventbus",
       "description": "Event bus — cross-trait pub/sub messaging",
       "category": "infrastructure",
       "package": "@almadar/server",
+      "backend": "production",
       "actions": [
         {
           "name": "emit",
@@ -346,13 +374,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "discovery": {
       "name": "discovery",
       "description": "Service discovery — register and find services",
       "category": "infrastructure",
       "package": "@almadar/server",
+      "backend": "production",
       "actions": [
         {
           "name": "register",
@@ -430,13 +460,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "migration": {
       "name": "migration",
       "description": "Migration service — import external data (notes, docs, references) into the system",
       "category": "infrastructure",
       "package": "@almadar-io/migration",
+      "backend": "production",
       "actions": [
         {
           "name": "listDocuments",
@@ -521,13 +553,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "skills": {
       "name": "skills",
       "description": "Skills service — AI-powered schema generation",
       "category": "ai",
       "package": "@almadar/skills",
+      "backend": "production",
       "actions": [
         {
           "name": "generateOrbitals",
@@ -595,13 +629,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "github": {
       "name": "github",
       "description": "GitHub integration — repos, issues, PRs",
       "category": "devtools",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "cloneRepo",
@@ -710,16 +746,22 @@
               "description": ""
             },
             {
-              "name": "head",
+              "name": "baseBranch",
               "type": "string",
               "required": true,
               "description": ""
             },
             {
-              "name": "base",
+              "name": "headBranch",
               "type": "string",
               "required": true,
               "description": ""
+            },
+            {
+              "name": "draft",
+              "type": "boolean",
+              "required": false,
+              "description": ""
             }
           ],
           "responseShape": {
@@ -921,13 +963,15 @@
           "required": false,
           "description": "Default repository name"
         }
-      ]
+      ],
+      "hooks": []
     },
     "stripe": {
       "name": "stripe",
       "description": "Stripe integration — payments, subscriptions, invoices",
       "category": "payment",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "createPaymentIntent",
@@ -1011,13 +1055,15 @@
           "required": false,
           "description": "Webhook endpoint signing secret"
         }
-      ]
+      ],
+      "hooks": []
     },
     "llm-integration": {
       "name": "llm-integration",
       "description": "LLM integration — generate, embed, classify via external providers",
       "category": "ai",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "generate",
@@ -1180,13 +1226,15 @@
           "required": false,
           "description": "OpenAI API key"
         }
-      ]
+      ],
+      "hooks": []
     },
     "youtube": {
       "name": "youtube",
       "description": "YouTube Data API — search videos, get video/channel details",
       "category": "media",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "search",
@@ -1255,13 +1303,15 @@
           "required": true,
           "description": "YouTube Data API key"
         }
-      ]
+      ],
+      "hooks": []
     },
     "twilio": {
       "name": "twilio",
       "description": "Twilio — SMS, voice calls, verification",
       "category": "messaging",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "sendSMS",
@@ -1278,6 +1328,12 @@
               "type": "string",
               "required": true,
               "description": ""
+            },
+            {
+              "name": "from",
+              "type": "string",
+              "required": false,
+              "description": ""
             }
           ],
           "responseShape": {
@@ -1324,13 +1380,15 @@
           "required": false,
           "description": "Default sender phone number"
         }
-      ]
+      ],
+      "hooks": []
     },
     "email": {
       "name": "email",
       "description": "Email service — send, send with template",
       "category": "messaging",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "send",
@@ -1359,6 +1417,24 @@
               "type": "string",
               "required": false,
               "description": ""
+            },
+            {
+              "name": "htmlBody",
+              "type": "string",
+              "required": false,
+              "description": "HTML content; when present `body` becomes the plain-text alternative."
+            },
+            {
+              "name": "replyTo",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "templateId",
+              "type": "string",
+              "required": false,
+              "description": "Provider template reference (SendGrid dynamic templates; Resend rejects it loudly)."
             }
           ],
           "responseShape": {
@@ -1383,13 +1459,15 @@
           "required": false,
           "description": "Default sender email address"
         }
-      ]
+      ],
+      "hooks": []
     },
     "webhook": {
       "name": "webhook",
       "description": "Outbound webhook — signed HTTP POST notifications to external endpoints",
       "category": "messaging",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "send",
@@ -1438,207 +1516,1051 @@
           "required": false,
           "description": "Per-request timeout (ms, default 10000)"
         }
-      ]
+      ],
+      "hooks": []
     },
-    "docker": {
-      "name": "docker",
-      "description": "Docker — container and image management",
-      "category": "devtools",
+    "push": {
+      "name": "push",
+      "description": "Web Push — VAPID-signed browser push notifications",
+      "category": "messaging",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
-          "name": "build",
+          "name": "send",
           "description": "",
           "params": [
             {
-              "name": "tag",
+              "name": "subscription",
+              "type": "object",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "title",
               "type": "string",
               "required": true,
               "description": ""
             },
             {
-              "name": "dockerfile",
+              "name": "body",
               "type": "string",
-              "required": false,
+              "required": true,
               "description": ""
             },
             {
-              "name": "context",
+              "name": "url",
               "type": "string",
               "required": false,
               "description": ""
             },
             {
-              "name": "buildArgs",
-              "type": "object",
+              "name": "icon",
+              "type": "string",
               "required": false,
               "description": ""
             }
           ],
           "responseShape": {
-            "imageId": "string",
-            "tag": "string",
-            "size": "number",
-            "buildTime": "number"
+            "statusCode": "number",
+            "ok": "boolean",
+            "expired": "boolean"
           }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "VAPID_PUBLIC_KEY",
+          "required": true,
+          "description": "VAPID public key (web-push generate-vapid-keys)"
         },
         {
-          "name": "run",
+          "envVar": "VAPID_PRIVATE_KEY",
+          "required": true,
+          "description": "VAPID private key"
+        },
+        {
+          "envVar": "VAPID_SUBJECT",
+          "required": true,
+          "description": "VAPID subject (mailto: or https: contact URI)"
+        }
+      ],
+      "hooks": []
+    },
+    "calendar": {
+      "name": "calendar",
+      "description": "Google Calendar — list/create/update/delete events, free-busy, push-channel watch (service account, domain-wide delegation)",
+      "category": "infrastructure",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "listEvents",
           "description": "",
           "params": [
             {
-              "name": "image",
-              "type": "string",
-              "required": true,
-              "description": ""
-            },
-            {
-              "name": "name",
+              "name": "calendarId",
               "type": "string",
               "required": false,
               "description": ""
             },
             {
-              "name": "ports",
-              "type": "array",
+              "name": "timeMin",
+              "type": "string",
               "required": false,
               "description": ""
             },
             {
-              "name": "env",
-              "type": "object",
+              "name": "timeMax",
+              "type": "string",
               "required": false,
               "description": ""
             },
             {
-              "name": "volumes",
-              "type": "array",
+              "name": "syncToken",
+              "type": "string",
               "required": false,
               "description": ""
             },
             {
-              "name": "command",
-              "type": "string",
+              "name": "maxResults",
+              "type": "number",
               "required": false,
               "description": ""
             }
           ],
           "responseShape": {
-            "containerId": "string",
-            "name": "string",
-            "status": "string",
-            "ports": "array"
+            "events": "array",
+            "nextSyncToken": "string | null"
           }
         },
         {
-          "name": "stop",
+          "name": "createEvent",
           "description": "",
           "params": [
             {
-              "name": "containerId",
+              "name": "calendarId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "summary",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "description",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "location",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "start",
               "type": "string",
               "required": true,
               "description": ""
+            },
+            {
+              "name": "end",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "durationMinutes",
+              "type": "number",
+              "required": false,
+              "description": ""
             }
           ],
           "responseShape": {
-            "containerId": "string",
+            "id": "string",
             "status": "string",
-            "stoppedAt": "number"
+            "htmlLink": "string"
           }
         },
         {
-          "name": "remove",
+          "name": "updateEvent",
           "description": "",
           "params": [
             {
-              "name": "containerId",
+              "name": "calendarId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "eventId",
               "type": "string",
               "required": true,
               "description": ""
             },
             {
-              "name": "force",
-              "type": "boolean",
+              "name": "summary",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "description",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "location",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "start",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "end",
+              "type": "string",
               "required": false,
               "description": ""
             }
           ],
           "responseShape": {
-            "containerId": "string",
-            "removed": "boolean"
+            "id": "string",
+            "status": "string"
           }
         },
         {
-          "name": "logs",
+          "name": "deleteEvent",
           "description": "",
           "params": [
             {
-              "name": "containerId",
+              "name": "calendarId",
               "type": "string",
-              "required": true,
-              "description": ""
-            },
-            {
-              "name": "tail",
-              "type": "number",
               "required": false,
               "description": ""
             },
             {
-              "name": "since",
+              "name": "eventId",
               "type": "string",
-              "required": false,
+              "required": true,
               "description": ""
             }
           ],
           "responseShape": {
-            "containerId": "string",
-            "logs": "string[]",
-            "lineCount": "number"
+            "id": "string",
+            "deleted": "boolean"
           }
         },
         {
-          "name": "status",
+          "name": "freeBusy",
           "description": "",
           "params": [
             {
-              "name": "containerId",
+              "name": "calendarId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "timeMin",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "timeMax",
               "type": "string",
               "required": true,
               "description": ""
             }
           ],
           "responseShape": {
-            "containerId": "string",
-            "name": "string",
-            "image": "string",
-            "status": "string",
-            "ports": "array",
-            "createdAt": "number",
-            "startedAt": "number | null",
-            "stoppedAt": "number | null"
+            "busy": "array"
           }
         },
         {
-          "name": "list",
+          "name": "watch",
           "description": "",
           "params": [
             {
-              "name": "all",
-              "type": "boolean",
+              "name": "calendarId",
+              "type": "string",
               "required": false,
               "description": ""
             },
             {
-              "name": "filterByLabel",
+              "name": "channelId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "address",
               "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "ttlSeconds",
+              "type": "number",
               "required": false,
               "description": ""
             }
           ],
           "responseShape": {
-            "containers": "array",
+            "channelId": "string",
+            "resourceId": "string",
+            "expiration": "string"
+          }
+        },
+        {
+          "name": "stopWatch",
+          "description": "",
+          "params": [
+            {
+              "name": "channelId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "resourceId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "stopped": "boolean"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "GOOGLE_CALENDAR_SA_KEY",
+          "required": true,
+          "description": "Google service-account key JSON (raw or base64) with calendar scope; store in Secret Manager, bind as env"
+        },
+        {
+          "envVar": "GOOGLE_CALENDAR_SUBJECT",
+          "required": false,
+          "description": "Workspace user to impersonate (domain-wide delegation); empty = act as the service account"
+        },
+        {
+          "envVar": "GOOGLE_CALENDAR_ID",
+          "required": false,
+          "description": "Default calendar id (default: primary)"
+        },
+        {
+          "envVar": "GOOGLE_CALENDAR_CHANNEL_TOKEN",
+          "required": false,
+          "description": "Watch-channel verification token — required to receive inbound calendar hooks (two-way sync)"
+        }
+      ],
+      "hooks": [
+        {
+          "provider": "google-calendar",
+          "event": "CAL_REMOTE_CHANGED",
+          "credentialEnv": "GOOGLE_CALENDAR_CHANNEL_TOKEN",
+          "providerExport": "googleCalendarHookProvider"
+        }
+      ]
+    },
+    "drive": {
+      "name": "drive",
+      "description": "Google Drive — list/get/upload files, folders, sharing (service account, domain-wide delegation)",
+      "category": "infrastructure",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "listFiles",
+          "description": "",
+          "params": [
+            {
+              "name": "folderId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "query",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "maxResults",
+              "type": "number",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "files": "array"
+          }
+        },
+        {
+          "name": "getFile",
+          "description": "",
+          "params": [
+            {
+              "name": "fileId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "id": "string",
+            "name": "string",
+            "mimeType": "string",
+            "content": "string",
+            "size": "number"
+          }
+        },
+        {
+          "name": "uploadFile",
+          "description": "",
+          "params": [
+            {
+              "name": "name",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "content",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "mimeType",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "folderId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "id": "string",
+            "name": "string",
+            "webViewLink": "string"
+          }
+        },
+        {
+          "name": "createFolder",
+          "description": "",
+          "params": [
+            {
+              "name": "name",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "parentId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "id": "string",
+            "name": "string"
+          }
+        },
+        {
+          "name": "shareFile",
+          "description": "",
+          "params": [
+            {
+              "name": "fileId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "email",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "role",
+              "type": "'reader' | 'writer' | 'commenter'",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "shared": "boolean",
+            "permissionId": "string"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "GOOGLE_DRIVE_SA_KEY",
+          "required": false,
+          "description": "Google service-account key JSON (raw or base64) with drive scope — serves reads; store in Secret Manager, bind as env"
+        },
+        {
+          "envVar": "GOOGLE_DRIVE_SUBJECT",
+          "required": false,
+          "description": "Workspace user to impersonate (domain-wide delegation); empty = act as the service account"
+        },
+        {
+          "envVar": "GOOGLE_DRIVE_REFRESH_TOKEN",
+          "required": false,
+          "description": "User OAuth refresh token (drive-consent.mjs) — serves writes; SA uploads are impossible on personal accounts (no SA storage quota)"
+        },
+        {
+          "envVar": "GOOGLE_DRIVE_FOLDER_ID",
+          "required": false,
+          "description": "Default parent folder for uploads/new folders when the call names none"
+        }
+      ],
+      "hooks": []
+    },
+    "metaAds": {
+      "name": "metaAds",
+      "description": "Meta Ads — read-only Marketing Insights (spend, campaigns) for profitability reporting",
+      "category": "marketing",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "getSpend",
+          "description": "",
+          "params": [
+            {
+              "name": "accountId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "since",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "until",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "clientTag",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "spend": "number",
+            "currency": "string",
+            "impressions": "number",
+            "clicks": "number"
+          }
+        },
+        {
+          "name": "listCampaigns",
+          "description": "",
+          "params": [
+            {
+              "name": "accountId",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "status",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "campaigns": "array"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "META_ACCESS_TOKEN",
+          "required": true,
+          "description": "Meta Graph API access token (Marketing API, ads_read)"
+        },
+        {
+          "envVar": "META_AD_ACCOUNT_ID",
+          "required": false,
+          "description": "Default ad account id (act_…); per-call accountId overrides"
+        }
+      ],
+      "hooks": []
+    },
+    "accounting": {
+      "name": "accounting",
+      "description": "Accounting export — invoice/journal rows to import-ready CSV (provider-pluggable)",
+      "category": "finance",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "exportInvoices",
+          "description": "",
+          "params": [
+            {
+              "name": "invoices",
+              "type": "array",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "format",
+              "type": "'csv'",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "content": "string",
+            "filename": "string",
+            "count": "number"
+          }
+        },
+        {
+          "name": "exportJournal",
+          "description": "",
+          "params": [
+            {
+              "name": "entries",
+              "type": "array",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "format",
+              "type": "'csv'",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "content": "string",
+            "filename": "string",
+            "count": "number"
+          }
+        }
+      ],
+      "credentials": [],
+      "hooks": []
+    },
+    "banking": {
+      "name": "banking",
+      "description": "Banking — GoCardless Bank Account Data (requisitions, accounts, transactions) for reconciliation",
+      "category": "finance",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "createRequisition",
+          "description": "",
+          "params": [
+            {
+              "name": "institutionId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "redirectUrl",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "reference",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "requisitionId": "string",
+            "link": "string"
+          }
+        },
+        {
+          "name": "listAccounts",
+          "description": "",
+          "params": [
+            {
+              "name": "requisitionId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "accounts": "string[]"
+          }
+        },
+        {
+          "name": "listTransactions",
+          "description": "",
+          "params": [
+            {
+              "name": "accountId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "dateFrom",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "dateTo",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "transactions": "array"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "GOCARDLESS_SECRET_ID",
+          "required": true,
+          "description": "GoCardless Bank Account Data secret id"
+        },
+        {
+          "envVar": "GOCARDLESS_SECRET_KEY",
+          "required": true,
+          "description": "GoCardless Bank Account Data secret key"
+        }
+      ],
+      "hooks": []
+    },
+    "esign": {
+      "name": "esign",
+      "description": "E-signature — send/track/download envelopes (DocuSign first, provider-pluggable)",
+      "category": "infrastructure",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "sendEnvelope",
+          "description": "",
+          "params": [
+            {
+              "name": "recipientEmail",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "recipientName",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "documentName",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "documentContent",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "emailSubject",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "envelopeId": "string",
+            "status": "string"
+          }
+        },
+        {
+          "name": "getEnvelopeStatus",
+          "description": "",
+          "params": [
+            {
+              "name": "envelopeId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "status": "string",
+            "completedAt": "string"
+          }
+        },
+        {
+          "name": "downloadDocument",
+          "description": "",
+          "params": [
+            {
+              "name": "envelopeId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "content": "string",
+            "documentName": "string"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "DOCUSIGN_BASE_URL",
+          "required": true,
+          "description": "DocuSign REST base (e.g. https://demo.docusign.net/restapi/v2.1/accounts/<accountId>)"
+        },
+        {
+          "envVar": "DOCUSIGN_ACCESS_TOKEN",
+          "required": true,
+          "description": "DocuSign OAuth access token (JWT grant rotation is the deployment concern)"
+        }
+      ],
+      "hooks": []
+    },
+    "docker": {
+      "name": "docker",
+      "description": "Docker — container and image management",
+      "category": "devtools",
+      "package": "@almadar/integrations",
+      "backend": "simulated",
+      "actions": [
+        {
+          "name": "build",
+          "description": "",
+          "params": [
+            {
+              "name": "tag",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "dockerfile",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "context",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "buildArgs",
+              "type": "object",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "imageId": "string",
+            "tag": "string",
+            "size": "number",
+            "buildTime": "number"
+          }
+        },
+        {
+          "name": "run",
+          "description": "",
+          "params": [
+            {
+              "name": "image",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "name",
+              "type": "string",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "ports",
+              "type": "array",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "env",
+              "type": "object",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "volumes",
+              "type": "array",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "command",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "containerId": "string",
+            "name": "string",
+            "status": "string",
+            "ports": "array"
+          }
+        },
+        {
+          "name": "stop",
+          "description": "",
+          "params": [
+            {
+              "name": "containerId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "containerId": "string",
+            "status": "string",
+            "stoppedAt": "number"
+          }
+        },
+        {
+          "name": "remove",
+          "description": "",
+          "params": [
+            {
+              "name": "containerId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "force",
+              "type": "boolean",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "containerId": "string",
+            "removed": "boolean"
+          }
+        },
+        {
+          "name": "logs",
+          "description": "",
+          "params": [
+            {
+              "name": "containerId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "tail",
+              "type": "number",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "since",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "containerId": "string",
+            "logs": "string[]",
+            "lineCount": "number"
+          }
+        },
+        {
+          "name": "status",
+          "description": "",
+          "params": [
+            {
+              "name": "containerId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "containerId": "string",
+            "name": "string",
+            "image": "string",
+            "status": "string",
+            "ports": "array",
+            "createdAt": "number",
+            "startedAt": "number | null",
+            "stoppedAt": "number | null"
+          }
+        },
+        {
+          "name": "list",
+          "description": "",
+          "params": [
+            {
+              "name": "all",
+              "type": "boolean",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "filterByLabel",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "containers": "array",
             "total": "number"
           }
         }
@@ -1649,13 +2571,15 @@
           "required": false,
           "description": "Docker daemon host URL"
         }
-      ]
+      ],
+      "hooks": []
     },
     "database": {
       "name": "database",
       "description": "Database integration — read-only SQL queries over external connections",
       "category": "infrastructure",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "query",
@@ -1686,13 +2610,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "storage": {
       "name": "storage",
       "description": "Object storage — upload, download, delete, list files",
       "category": "infrastructure",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "upload",
@@ -1724,7 +2650,7 @@
             },
             {
               "name": "file",
-              "type": "IntegrationParams",
+              "type": "object",
               "required": false,
               "description": ""
             },
@@ -1751,7 +2677,9 @@
             "key": "string",
             "bucket": "string",
             "size": "number",
-            "etag": "string"
+            "etag": "string",
+            "id": "string",
+            "url": "string"
           }
         },
         {
@@ -1795,15 +2723,22 @@
               "description": ""
             },
             {
-              "name": "maxKeys",
-              "type": "number",
+              "name": "maxKeys",
+              "type": "number",
+              "required": false,
+              "description": ""
+            },
+            {
+              "name": "continuationToken",
+              "type": "string",
               "required": false,
               "description": ""
             }
           ],
           "responseShape": {
             "keys": "array",
-            "truncated": "boolean"
+            "truncated": "boolean",
+            "nextToken": "string"
           }
         },
         {
@@ -1863,23 +2798,45 @@
         }
       ],
       "credentials": [
+        {
+          "envVar": "STORAGE_ACCESS_KEY_ID",
+          "required": true,
+          "description": "S3-compatible access key id"
+        },
+        {
+          "envVar": "STORAGE_SECRET_ACCESS_KEY",
+          "required": true,
+          "description": "S3-compatible secret access key"
+        },
         {
           "envVar": "STORAGE_BUCKET",
           "required": true,
-          "description": "Cloud storage bucket name"
+          "description": "Default bucket name"
         },
         {
           "envVar": "STORAGE_REGION",
           "required": false,
-          "description": "Storage region"
+          "description": "Region (default us-east-1)"
+        },
+        {
+          "envVar": "STORAGE_ENDPOINT",
+          "required": false,
+          "description": "Custom S3-compatible endpoint (R2/MinIO/…); empty = AWS S3"
+        },
+        {
+          "envVar": "STORAGE_PUBLIC_URL_BASE",
+          "required": false,
+          "description": "Base URL for public-acl object links; empty = endpoint-derived"
         }
-      ]
+      ],
+      "hooks": []
     },
     "queue": {
       "name": "queue",
       "description": "Message queue — publish, subscribe, acknowledge messages",
       "category": "infrastructure",
       "package": "@almadar/integrations",
+      "backend": "simulated",
       "actions": [
         {
           "name": "enqueue",
@@ -2027,13 +2984,15 @@
           "required": true,
           "description": "Message queue connection URL"
         }
-      ]
+      ],
+      "hooks": []
     },
     "redis": {
       "name": "redis",
       "description": "Redis — cache get/set/delete, pub/sub",
       "category": "infrastructure",
       "package": "@almadar/integrations",
+      "backend": "simulated",
       "actions": [
         {
           "name": "get",
@@ -2220,13 +3179,15 @@
           "required": true,
           "description": "Redis connection URL"
         }
-      ]
+      ],
+      "hooks": []
     },
     "oauth": {
       "name": "oauth",
-      "description": "OAuth — authorization flow, token management",
+      "description": "OAuth/OIDC — authorization-code + PKCE flow, token management, userinfo",
       "category": "auth",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "authorize",
@@ -2334,25 +3295,151 @@
         {
           "envVar": "OAUTH_CLIENT_ID",
           "required": true,
-          "description": "OAuth2 client ID"
+          "description": "OIDC client ID"
         },
         {
           "envVar": "OAUTH_CLIENT_SECRET",
           "required": true,
-          "description": "OAuth2 client secret"
+          "description": "OIDC client secret"
         },
         {
           "envVar": "OAUTH_REDIRECT_URI",
           "required": false,
-          "description": "OAuth2 redirect URI"
+          "description": "OIDC redirect URI (default per-call param)"
+        },
+        {
+          "envVar": "OIDC_ISSUER_URL",
+          "required": false,
+          "description": "OIDC issuer URL (default https://accounts.google.com)"
         }
-      ]
+      ],
+      "hooks": []
+    },
+    "credentials": {
+      "name": "credentials",
+      "description": "Tenant credential store — masked list, set/remove, test connection, master-key rotation (settings-page backend)",
+      "category": "auth",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "list",
+          "description": "",
+          "params": [
+            {
+              "name": "service",
+              "type": "string",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "enabled": "boolean",
+            "entries": "array"
+          }
+        },
+        {
+          "name": "set",
+          "description": "",
+          "params": [
+            {
+              "name": "service",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "envVar",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "value",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "saved": "boolean",
+            "service": "string",
+            "envVar": "string",
+            "last4": "string"
+          }
+        },
+        {
+          "name": "remove",
+          "description": "",
+          "params": [
+            {
+              "name": "service",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "envVar",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "removed": "boolean"
+          }
+        },
+        {
+          "name": "test",
+          "description": "",
+          "params": [
+            {
+              "name": "service",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "service": "string",
+            "configured": "boolean",
+            "missing": "string[]",
+            "probed": "boolean",
+            "ok": "boolean",
+            "message": "string"
+          }
+        },
+        {
+          "name": "rotate",
+          "description": "",
+          "params": [],
+          "responseShape": {
+            "rotated": "number",
+            "alreadyCurrent": "number",
+            "unreadable": "number"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "ALMADAR_CREDENTIAL_MASTER_KEY",
+          "required": false,
+          "description": "AES-256 master key (64-char hex) enabling the hosted credential store — hold it alone in the platform secret store"
+        },
+        {
+          "envVar": "ALMADAR_CREDENTIAL_MASTER_KEY_PREVIOUS",
+          "required": false,
+          "description": "Previous master key, present only during a rotation window — decrypts old rows until `credentials.rotate` re-encrypts them"
+        }
+      ],
+      "hooks": []
     },
     "otel": {
       "name": "otel",
       "description": "OpenTelemetry — spans, metrics, logs",
       "category": "infrastructure",
       "package": "@almadar/integrations",
+      "backend": "simulated",
       "actions": [
         {
           "name": "startSpan",
@@ -2494,13 +3581,15 @@
           "required": false,
           "description": "Service name for traces"
         }
-      ]
+      ],
+      "hooks": []
     },
     "cli": {
       "name": "cli",
       "description": "CLI tool execution — run commands, get output",
       "category": "devtools",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "validate",
@@ -2521,13 +3610,15 @@
           }
         }
       ],
-      "credentials": []
+      "credentials": [],
+      "hooks": []
     },
     "deepagent": {
       "name": "deepagent",
       "description": "DeepAgent — AI agent orchestration",
       "category": "ai",
       "package": "@almadar/integrations",
+      "backend": "production",
       "actions": [
         {
           "name": "sendMessage",
@@ -2643,16 +3734,291 @@
           "required": false,
           "description": "DeepAgent API key"
         }
-      ]
+      ],
+      "hooks": []
+    },
+    "wikimedia": {
+      "name": "wikimedia",
+      "description": "Wikipedia API — redirect-resolved page lookup (description, portrait, lead extract)",
+      "category": "reference",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "getPage",
+          "description": "",
+          "params": [
+            {
+              "name": "title",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "title": "string",
+            "description": "string",
+            "portraitUrl": "string",
+            "extract": "string"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "WIKIMEDIA_USER_AGENT",
+          "required": false,
+          "description": "Descriptive User-Agent for the Wikipedia API"
+        },
+        {
+          "envVar": "WIKIMEDIA_TIMEOUT_MS",
+          "required": false,
+          "description": "Per-request timeout (ms)"
+        }
+      ],
+      "hooks": []
+    },
+    "iconify": {
+      "name": "iconify",
+      "description": "Iconify API — brand-logo / icon resolution, search, and body fetch",
+      "category": "reference",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "svgExists",
+          "description": "",
+          "params": [
+            {
+              "name": "path",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "exists": "boolean"
+          }
+        },
+        {
+          "name": "search",
+          "description": "",
+          "params": [
+            {
+              "name": "query",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "limit",
+              "type": "number",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "icons": "string[]"
+          }
+        },
+        {
+          "name": "getIconBody",
+          "description": "",
+          "params": [
+            {
+              "name": "iconId",
+              "type": "string",
+              "required": true,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "body": "string | null"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "ICONIFY_USER_AGENT",
+          "required": false,
+          "description": "User-Agent for the Iconify API"
+        },
+        {
+          "envVar": "ICONIFY_TIMEOUT_MS",
+          "required": false,
+          "description": "Per-request timeout (ms)"
+        }
+      ],
+      "hooks": []
+    },
+    "arxiv": {
+      "name": "arxiv",
+      "description": "arXiv API — frontier academic preprint search (emerging-axis research backend)",
+      "category": "reference",
+      "package": "@almadar/integrations",
+      "backend": "production",
+      "actions": [
+        {
+          "name": "search",
+          "description": "",
+          "params": [
+            {
+              "name": "query",
+              "type": "string",
+              "required": true,
+              "description": ""
+            },
+            {
+              "name": "maxResults",
+              "type": "number",
+              "required": false,
+              "description": ""
+            }
+          ],
+          "responseShape": {
+            "results": "array"
+          }
+        }
+      ],
+      "credentials": [
+        {
+          "envVar": "ARXIV_TIMEOUT_MS",
+          "required": false,
+          "description": "Per-request timeout (ms)"
+        }
+      ],
+      "hooks": []
+    },
+    "calendar-ical": {
+      "name": "calendar-ical",
+      "description": "Host-provided .ics generation service (std-service-calendar-ical)",
+      "category": "infrastructure",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "custom-bearer-api": {
+      "name": "custom-bearer-api",
+      "description": "Caller-configured bearer-token HTTP API (std-service-custom-bearer)",
+      "category": "infrastructure",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "customBearer": {
+      "name": "customBearer",
+      "description": "Caller-configured bearer-token HTTP API (std-service-custom-bearer, unquoted spelling)",
+      "category": "infrastructure",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "knowledge": {
+      "name": "knowledge",
+      "description": "Host-provided knowledge/research service",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "maps": {
+      "name": "maps",
+      "description": "Host-provided maps service (std-service-maps)",
+      "category": "infrastructure",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "print": {
+      "name": "print",
+      "description": "Host-provided print service (std-service-print)",
+      "category": "infrastructure",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "builder": {
+      "name": "builder",
+      "description": "Rabit-internal agent service (rabit.lolo)",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "composer": {
+      "name": "composer",
+      "description": "Rabit-internal agent service (rabit.lolo)",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "coordinator": {
+      "name": "coordinator",
+      "description": "Rabit-internal agent service (rabit.lolo)",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "planner": {
+      "name": "planner",
+      "description": "Rabit-internal agent service (rabit.lolo)",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "repair": {
+      "name": "repair",
+      "description": "Rabit-internal agent service (rabit.lolo)",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
+    },
+    "validator": {
+      "name": "validator",
+      "description": "Rabit-internal agent service (rabit.lolo)",
+      "category": "ai",
+      "package": "(host-injected)",
+      "backend": "host-injected",
+      "actions": [],
+      "credentials": [],
+      "hooks": []
     }
   },
   "categories": [
     "ai",
     "auth",
     "devtools",
+    "finance",
     "infrastructure",
+    "marketing",
     "media",
     "messaging",
-    "payment"
+    "payment",
+    "reference"
   ]
 }