feat(confluence): add Cloud page actions and polling triggers

BUNDLE_API.md

@@ -224,6 +224,13 @@ the deserialize half is covered by
 
 ## Changelog
 
+- **Headless integration context checks (2026-10-28).** `Component` checks the
+  selected capability's declared deployment contexts before resolving a
+  connection or running an integration action. Unsupported headless actions
+  raise `IntegrationContextUnsupportedError` with the existing
+  `action-unsupported` code instead of suggesting credential setup. Supported
+  contexts and public signatures are unchanged, so `BUNDLE_API_VERSION` remains `1`.
+
 - **Decision model inputs (2026-10-22).** `ModelInput` accepts `model_type="decision"`:
   such a field never connects other models (`input_types=[]`, no external options), and
   `value="connect_other_models"` is refused. `FloatInput` gains `preserve_empty`

design/provider-integrations/confluence.md

@@ -0,0 +1,26 @@
+# Confluence Cloud preview
+
+Status: draft
+Owners (sign-off roles): platform owner, release owner
+
+The lfx-confluence package owns provider confluence and the separate confluence_integrations category. Legacy lfx-bundles Confluence components retain their category and class identities.
+
+| Capability | Auth and scope | Context | Delivery or API |
+| --- | --- | --- | --- |
+| Search pages by exact title or list one approved space | Delegated user and read:page:confluence | Hosted and self-managed | REST v2 pages with bounded explicit cursor |
+| Read a current page and storage body | Delegated user and read:page:confluence | Hosted and self-managed | REST v2 page by ID |
+| Create a current page in an approved space | Delegated user and read:page:confluence plus write:page:confluence | Hosted and self-managed | REST v2 page create with optional verified parent |
+| Replace a page at the expected version | Delegated user and read:page:confluence plus write:page:confluence | Hosted and self-managed | REST v2 page update with optimistic content version |
+| Observe newly created pages after a silent baseline | Delegated user, read:page:confluence and offline_access, background consent | Self-managed | Full bounded current-page snapshots |
+| Observe higher versions of previously seen pages | Delegated user, read:page:confluence and offline_access, background consent | Self-managed | Full bounded current-page snapshots |
+
+All capabilities are preview. One operator-configured Cloud site and approved numeric spaces constrain targets. The account and verified grant bind credentials to that site. New page creation uses createdAt rather than first appearance in the space. Snapshot observations cannot recover intermediate edits, deletion history or all changes during access gaps.
+
+Data Center, Desktop, headless manual credentials, hosted triggers and push webhooks are unsupported. Setup, limits, rate handling, write ambiguity and recovery are documented in the [bundle README](../../src/bundles/confluence/README.md). Live tenant acceptance remains unverified.
+
+## Sign-off
+
+| Role | Name | Date | PR |
+| --- | --- | --- | --- |
+| platform owner | | | |
+| release owner | | | |

design/provider-integrations/contracts/confluence.v1.json

@@ -0,0 +1,201 @@
+{
+  "schema_version": 1,
+  "provider_id": "confluence",
+  "distribution": "lfx-confluence",
+  "manifest": {
+    "schema_version": 1,
+    "provider_id": "confluence",
+    "display_name": "Confluence Cloud",
+    "icon": "Confluence",
+    "docs_url": "https://github.com/langflow-ai/langflow/blob/d4dffe227d3ec238f430736d7ca6d16bbf084c9b/src/bundles/confluence/README.md#setup",
+    "auth_profiles": [
+      {
+        "id": "user",
+        "kind": "oauth2_authorization_code",
+        "identity": "user_delegated",
+        "supports_pkce": false,
+        "supports_refresh": true,
+        "default_scopes": [
+          "offline_access",
+          "read:confluence-user",
+          "read:page:confluence",
+          "write:page:confluence"
+        ],
+        "client_type_by_context": {
+          "hosted": "confidential",
+          "self_managed": "confidential"
+        },
+        "owner_by_context": {
+          "hosted": "either",
+          "self_managed": "customer"
+        }
+      }
+    ],
+    "capabilities": [
+      {
+        "id": "confluence.page.search",
+        "display_name": "Confluence: Search Pages",
+        "auth_profile_id": "user",
+        "identity": "user_delegated",
+        "required_scopes": [
+          "read:page:confluence",
+          "read:confluence-user"
+        ],
+        "policy_keys": [
+          "integrations.confluence.page.search"
+        ],
+        "substrate": "rest",
+        "maturity": "preview",
+        "deployment_contexts": [
+          "hosted",
+          "self_managed"
+        ],
+        "risk": "read",
+        "component_ref": "ConfluenceSearchPagesComponent"
+      },
+      {
+        "id": "confluence.page.read",
+        "display_name": "Confluence: Read Page",
+        "auth_profile_id": "user",
+        "identity": "user_delegated",
+        "required_scopes": [
+          "read:page:confluence",
+          "read:confluence-user"
+        ],
+        "policy_keys": [
+          "integrations.confluence.page.read"
+        ],
+        "substrate": "rest",
+        "maturity": "preview",
+        "deployment_contexts": [
+          "hosted",
+          "self_managed"
+        ],
+        "risk": "read",
+        "component_ref": "ConfluenceReadPageComponent"
+      },
+      {
+        "id": "confluence.page.create",
+        "display_name": "Confluence: Create Page",
+        "auth_profile_id": "user",
+        "identity": "user_delegated",
+        "required_scopes": [
+          "read:page:confluence",
+          "write:page:confluence",
+          "read:confluence-user"
+        ],
+        "policy_keys": [
+          "integrations.confluence.page.create"
+        ],
+        "substrate": "rest",
+        "maturity": "preview",
+        "deployment_contexts": [
+          "hosted",
+          "self_managed"
+        ],
+        "risk": "write",
+        "component_ref": "ConfluenceCreatePageComponent"
+      },
+      {
+        "id": "confluence.page.update",
+        "display_name": "Confluence: Update Page",
+        "auth_profile_id": "user",
+        "identity": "user_delegated",
+        "required_scopes": [
+          "read:page:confluence",
+          "write:page:confluence",
+          "read:confluence-user"
+        ],
+        "policy_keys": [
+          "integrations.confluence.page.update"
+        ],
+        "substrate": "rest",
+        "maturity": "preview",
+        "deployment_contexts": [
+          "hosted",
+          "self_managed"
+        ],
+        "risk": "write",
+        "component_ref": "ConfluenceUpdatePageComponent"
+      },
+      {
+        "id": "confluence.trigger.created",
+        "display_name": "Confluence: On Page Created",
+        "auth_profile_id": "user",
+        "identity": "user_delegated",
+        "required_scopes": [
+          "read:page:confluence",
+          "offline_access",
+          "read:confluence-user"
+        ],
+        "policy_keys": [
+          "integrations.confluence.trigger.created"
+        ],
+        "substrate": "rest",
+        "maturity": "preview",
+        "deployment_contexts": [
+          "self_managed"
+        ],
+        "risk": "read",
+        "component_ref": "ConfluenceOnPageCreatedTriggerComponent"
+      },
+      {
+        "id": "confluence.trigger.updated",
+        "display_name": "Confluence: On Page Updated",
+        "auth_profile_id": "user",
+        "identity": "user_delegated",
+        "required_scopes": [
+          "read:page:confluence",
+          "offline_access",
+          "read:confluence-user"
+        ],
+        "policy_keys": [
+          "integrations.confluence.trigger.updated"
+        ],
+        "substrate": "rest",
+        "maturity": "preview",
+        "deployment_contexts": [
+          "self_managed"
+        ],
+        "risk": "read",
+        "component_ref": "ConfluenceOnPageUpdatedTriggerComponent"
+      }
+    ]
+  },
+  "sources": [
+    {
+      "url": "https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/",
+      "title": "Confluence Cloud REST v2 page API",
+      "verified_on": "2026-10-22"
+    },
+    {
+      "url": "https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/",
+      "title": "Confluence Cloud OAuth 2.0 3LO apps",
+      "verified_on": "2026-10-22"
+    },
+    {
+      "url": "https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-users/#api-wiki-rest-api-user-current-get",
+      "title": "Confluence current user API",
+      "verified_on": "2026-10-22"
+    }
+  ],
+  "transport_limitations": [
+    "One operator-configured Confluence Cloud site and approved numeric spaces only.",
+    "Hosted actions and self-managed actions and polling are preview. Hosted triggers, Data Center, Desktop, headless manual credentials and webhooks are unsupported.",
+    "Polls observe latest versions after a silent baseline. They can miss intermediate edits, deletions, short-lived pages and access gaps.",
+    "Original createdAt separates newly created pages from old pages moved into a space. Newly visible existing pages are not update events until a later version is observed.",
+    "Each source retains at most 5000 distinct observed IDs and completes at most 50 requests of 100 pages. Partial snapshots never advance cursors."
+  ],
+  "evidence_paths": [
+    "src/bundles/confluence/tests/test_contract.py",
+    "src/backend/tests/unit/services/triggers/test_confluence_provider.py",
+    "src/backend/tests/unit/services/triggers/test_confluence_lifecycle.py",
+    "src/bundles/confluence/scripts/verify_wheel.py",
+    "src/bundles/confluence/README.md",
+    "design/provider-integrations/confluence.md"
+  ],
+  "owner_acceptance": {
+    "status": "pending",
+    "note": "Platform and release owners still need to review this preview. Operator app registration, provider distribution requirements, real tenant authorization, live content writes and production delivery acceptance remain unverified."
+  }
+}

design/provider-integrations/index.json

@@ -1,6 +1,10 @@
 {
   "schema_version": 1,
   "providers": [
+    {
+      "provider_id": "confluence",
+      "contract": "contracts/confluence.v1.json"
+    },
     {
       "provider_id": "github",
       "contract": "contracts/github.v1.json"

pyproject.toml

@@ -45,6 +45,7 @@ dependencies = [
     "lfx-google>=0.4.0,<1.0.0",
     "lfx-microsoft>=0.1.5,<1.0.0",
     "lfx-slack>=0.2.3,<1.0.0",
+    "lfx-confluence>=0.1.0,<1.0.0",
     "lfx-github>=0.1.0,<1.0.0",
     # langflow-extensions:bundle-deps-end
 ]
@@ -134,6 +135,7 @@ lfx-serply = { workspace = true }
 lfx-serpingapi = { workspace = true }
 lfx-microsoft = { workspace = true }
 lfx-slack = { workspace = true }
+lfx-confluence = { workspace = true }
 lfx-github = { workspace = true }
 # langflow-extensions:bundle-sources-end
 torch = { index = "pytorch-cpu" }
@@ -175,6 +177,7 @@ members = [
     "src/bundles/serpingapi",
     "src/bundles/microsoft",
     "src/bundles/slack",
+    "src/bundles/confluence",
     "src/bundles/github",
     # langflow-extensions:bundle-members-end
 ]

scripts/ci/bundle_profile_locks/enterprise-hardened.lock.json

@@ -52,6 +52,16 @@
       "requirement": "lfx-cohere==0.2.1",
       "resolved_version": "0.2.1"
     },
+    {
+      "distribution": "lfx-confluence",
+      "extras": [],
+      "providers": [
+        "lfx-confluence"
+      ],
+      "requested": ">=0.1.0,<1.0.0",
+      "requirement": "lfx-confluence==0.1.0",
+      "resolved_version": "0.1.0"
+    },
     {
       "distribution": "lfx-datastax",
       "extras": [],
@@ -190,12 +200,13 @@
     "https://pypi.org/simple"
   ],
   "profile": "enterprise-hardened",
-  "profile_digest": "sha256:311190439f5c0ab6",
+  "profile_digest": "sha256:5c9c26a194741a34",
   "providers": [
     "lfx-amazon",
     "lfx-anthropic",
     "lfx-azure",
     "lfx-cohere",
+    "lfx-confluence",
     "lfx-datastax",
     "lfx-docling",
     "lfx-github",

scripts/ci/bundle_profiles.json

@@ -163,6 +163,14 @@
           "providers": [
             "lfx-github"
           ]
+        },
+        {
+          "distribution": "lfx-confluence",
+          "extras": [],
+          "version": ">=0.1.0,<1.0.0",
+          "providers": [
+            "lfx-confluence"
+          ]
         }
       ]
     }

scripts/ci/release_inventory_contract.json

@@ -67,6 +67,7 @@
         "lfx-anthropic",
         "lfx-azure",
         "lfx-cohere",
+        "lfx-confluence",
         "lfx-datastax",
         "lfx-docling",
         "lfx-github",
@@ -104,6 +105,7 @@
           "lfx-anthropic",
           "lfx-azure",
           "lfx-cohere",
+          "lfx-confluence",
           "lfx-datastax",
           "lfx-docling",
           "lfx-github",
@@ -242,6 +244,7 @@
           "lfx-arxiv",
           "lfx-azure",
           "lfx-cohere",
+          "lfx-confluence",
           "lfx-confluent",
           "lfx-datastax",
           "lfx-docling",