@oomol-lab/open-connector 1.6.5 → 1.8.0

package/README.md

@@ -87,6 +87,10 @@ original request URL when you forward.
 `/oauth/callback`, and admin `/api/*`. `connector.close()` aborts in-flight
 work and closes owned storage. It is safe to call more than once.
 
+## Provider Triggers
+
+Provider Triggers use the same headless runtime and selected provider registry as Actions. Grant explicit `allowedTriggers` on a persistent runtime token to manage remote subscriptions; public proxy grants are independent. Runtime shutdown cancels and waits for maintenance. Include the generated catalog and migrations supplied by `getConnectorBuildOptions`; selected-provider builds include only those providers' Trigger executors. See the [Trigger runtime reference](https://github.com/oomol-lab/open-connector/blob/main/docs/runtime-api.md#provider-triggers) for request shapes and cleanup.
+
 ## Connector SDK
 
 [`@oomol-lab/connector`](https://www.npmjs.com/package/@oomol-lab/connector) is

package/assets/open-connector/catalog/apps/airtable.json

@@ -1768,5 +1768,139 @@
         "airtable.get_base_schema"
       ]
     }
+  ],
+  "triggers": [
+    {
+      "configInputs": [
+        {
+          "handle": "baseId",
+          "jsonSchema": {
+            "type": "string",
+            "pattern": "^app[A-Za-z0-9]{14}$"
+          },
+          "nullable": false
+        },
+        {
+          "handle": "fields",
+          "jsonSchema": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "nullable": false,
+          "value": []
+        },
+        {
+          "handle": "formula",
+          "jsonSchema": {
+            "type": "string"
+          },
+          "nullable": false,
+          "value": ""
+        },
+        {
+          "handle": "maxRecordsPerPoll",
+          "jsonSchema": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 1000
+          },
+          "nullable": false,
+          "value": 200
+        },
+        {
+          "handle": "tableIdOrName",
+          "jsonSchema": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 255
+          },
+          "nullable": false
+        },
+        {
+          "handle": "triggerField",
+          "jsonSchema": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 255,
+            "pattern": "^[^}]*$"
+          },
+          "nullable": false
+        },
+        {
+          "handle": "view",
+          "jsonSchema": {
+            "type": "string"
+          },
+          "nullable": false,
+          "value": ""
+        }
+      ],
+      "definitionVersion": 2,
+      "description": "Polls an Airtable table and triggers when a record is created or updated, ordered by a time field.",
+      "displayName": "Record Created or Updated",
+      "key": "airtable.on_record_changed",
+      "name": "on_record_changed",
+      "outputs": [
+        {
+          "handle": "events",
+          "jsonSchema": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "baseId": {
+                  "type": "string"
+                },
+                "createdTime": {
+                  "type": "string"
+                },
+                "fields": {
+                  "type": "object"
+                },
+                "recordId": {
+                  "type": "string"
+                },
+                "tableIdOrName": {
+                  "type": "string"
+                },
+                "triggerField": {
+                  "type": "string"
+                },
+                "triggerFieldValue": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "baseId",
+                "tableIdOrName",
+                "recordId",
+                "createdTime",
+                "triggerField",
+                "triggerFieldValue",
+                "fields"
+              ]
+            }
+          },
+          "nullable": false
+        }
+      ],
+      "provider": "airtable",
+      "type": "poll"
+    }
+  ],
+  "triggerPermissions": [
+    {
+      "id": "airtable.on_record_changed",
+      "name": "Record Created or Updated",
+      "description": "Reads records in the selected base and table to detect creations or updates. Does not modify records.",
+      "providerPermissions": [
+        "data.records:read"
+      ],
+      "instructions": "Grant the token access to the selected base. The configured timestamp field must reflect the changes to monitor."
+    }
   ]
 }