@commandable/integration-data 0.0.5 → 0.0.7

package/integrations/airtable/__tests__/get_handlers.test.ts

@@ -1,4 +1,4 @@
-import { beforeAll, describe, expect, it } from 'vitest'
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
 import { IntegrationProxy } from '../../../../server/src/integrations/proxy.js'
 import { loadIntegrationTools } from '../../../../server/src/integrations/dataLoader.js'
 
@@ -13,6 +13,7 @@ interface Ctx {
   baseId?: string
   tableId?: string
   recordId?: string
+  ownedRecordId?: string
 }
 
 const env = process.env as Record<string, string>
@@ -26,6 +27,7 @@ const suite = hasEnv(
 suite('airtable read handlers (live)', () => {
   const ctx: Ctx = {}
   let buildHandler: (name: string) => ((input: any) => Promise<any>)
+  let buildWriteHandler: (name: string) => ((input: any) => Promise<any>)
 
   beforeAll(async () => {
     const credentialStore = {
@@ -56,6 +58,16 @@ suite('airtable read handlers (live)', () => {
       return build(integration) as (input: any) => Promise<any>
     }
 
+    buildWriteHandler = (name: string) => {
+      const tool = tools!.write.find(t => t.name === name)
+      expect(tool, `write tool ${name} exists`).toBeTruthy()
+      const integration = {
+        fetch: (path: string, init?: RequestInit) => proxy.call(integrationNode, path, init),
+      }
+      const build = new Function('integration', `return (${tool!.handlerCode});`)
+      return build(integration) as (input: any) => Promise<any>
+    }
+
     // Use explicit test base/table if provided, otherwise auto-discover from first base
     if (env.AIRTABLE_TEST_WRITE_BASE_ID && env.AIRTABLE_TEST_WRITE_TABLE_ID) {
       ctx.baseId = env.AIRTABLE_TEST_WRITE_BASE_ID
@@ -74,14 +86,40 @@ suite('airtable read handlers (live)', () => {
       }
     }
 
+    // Create a dedicated record so get_record has a stable ID that the concurrent
+    // write suite cannot accidentally delete out from under us.
     if (ctx.baseId && ctx.tableId) {
-      const list_records = buildHandler('list_records')
-      const recs = await list_records({ baseId: ctx.baseId, tableId: ctx.tableId, pageSize: 1 })
-      const records = recs?.records || recs
-      ctx.recordId = records?.[0]?.id
+      try {
+        const create_record = buildWriteHandler('create_record')
+        const created = await create_record({
+          baseId: ctx.baseId,
+          tableId: ctx.tableId,
+          fields: { Name: `ReadTest ${Date.now()}` },
+        })
+        const rec = created?.records?.[0] || created
+        ctx.ownedRecordId = rec?.id
+        ctx.recordId = rec?.id
+      }
+      catch {
+        // If create fails (e.g. no write permission), fall back to discovering a record
+        const list_records = buildHandler('list_records')
+        const recs = await list_records({ baseId: ctx.baseId, tableId: ctx.tableId, pageSize: 1 })
+        const records = recs?.records || recs
+        ctx.recordId = records?.[0]?.id
+      }
     }
   }, 60000)
 
+  afterAll(async () => {
+    if (ctx.ownedRecordId && ctx.baseId && ctx.tableId) {
+      try {
+        const delete_record = buildWriteHandler('delete_record')
+        await delete_record({ baseId: ctx.baseId, tableId: ctx.tableId, recordId: ctx.ownedRecordId })
+      }
+      catch {}
+    }
+  })
+
   it('list_bases returns bases', async () => {
     const handler = buildHandler('list_bases')
     const result = await handler({})

package/integrations/confluence/.env.test

@@ -0,0 +1,25 @@
+# Confluence (Confluence Cloud) live integration tests
+#
+# Two credential variants are supported — provide one to test that variant:
+#
+# ----------------------
+# Variant: api_token
+# ----------------------
+# CONFLUENCE_DOMAIN:
+# - If your site URL is https://YOUR_DOMAIN.atlassian.net/wiki, then YOUR_DOMAIN is the value.
+CONFLUENCE_DOMAIN=commandable
+# CONFLUENCE_EMAIL:
+# - The email address of the Atlassian account that owns the API token.
+CONFLUENCE_EMAIL=theo@commandable.ai
+# CONFLUENCE_API_TOKEN:
+# - Create an Atlassian API token at: https://id.atlassian.com/manage-profile/security/api-tokens
+CONFLUENCE_API_TOKEN=ATATT3xFfGF0q1hqu1FdEJJHaLHdP6aHe2YwVWg2gu4TEBtP0ZWfFh46z7ZQDg0VHIE2PuVLw2MB7tgR-47cjuyVTXGS_UO1-VoKbODopCGCAR_BOWdcdWc5yN4QnIsU_V7LsWqj8hRNn9wEwkxthy3Um5brD26ehgEUeY9cvpjboiIqLcvEA6k=787A1BCE
+
+#
+# ----------------------
+# Write test configuration
+# ----------------------
+# Space key to use for write tests (create/update/delete pages)
+CONFLUENCE_TEST_SPACE_KEY=SD
+# Optional: parent page ID under which test pages will be created
+CONFLUENCE_TEST_PARENT_PAGE_ID=360450

package/integrations/confluence/.env.test.example

@@ -0,0 +1,36 @@
+# Confluence (Confluence Cloud) live integration tests
+#
+# Two credential variants are supported — provide one to test that variant:
+#
+# ----------------------
+# Variant: api_token
+# ----------------------
+# CONFLUENCE_DOMAIN:
+# - If your site URL is https://YOUR_DOMAIN.atlassian.net/wiki, then YOUR_DOMAIN is the value.
+CONFLUENCE_DOMAIN=
+# CONFLUENCE_EMAIL:
+# - The email address of the Atlassian account that owns the API token.
+CONFLUENCE_EMAIL=
+# CONFLUENCE_API_TOKEN:
+# - Create an Atlassian API token at: https://id.atlassian.com/manage-profile/security/api-tokens
+CONFLUENCE_API_TOKEN=
+#
+# ----------------------
+# Variant: oauth_token
+# ----------------------
+# CONFLUENCE_CLOUD_ID:
+# - Your Atlassian Cloud resource ID. Discover it via:
+#   GET https://api.atlassian.com/oauth/token/accessible-resources (using your access token)
+CONFLUENCE_CLOUD_ID=
+# CONFLUENCE_TOKEN:
+# - OAuth 2.0 access token with Confluence scopes
+#   (read:page:confluence, write:page:confluence, read:space:confluence, etc.)
+CONFLUENCE_TOKEN=
+#
+# ----------------------
+# Write test configuration
+# ----------------------
+# Space key to use for write tests (create/update/delete pages)
+CONFLUENCE_TEST_SPACE_KEY=
+# Optional: parent page ID under which test pages will be created
+CONFLUENCE_TEST_PARENT_PAGE_ID=

package/integrations/confluence/README.md

@@ -0,0 +1,28 @@
+# Confluence
+
+**11 tools**
+
+![Confluence tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-confluence.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `api_token` | API Token (Email + Token) _(default)_ |
+| `oauth_token` | OAuth Access Token (3LO) |
+
+## Tools
+
+| Tool | Scope | Description |
+|---|---|---|
+| `list_spaces` | read | List Confluence spaces you can access. Use this to discover `spaceId`/`spaceKey` before s… |
+| `get_space` | read | Get a Confluence space by `spaceId`, including its homepage and basic metadata. |
+| `search_pages` | read | Search for pages using CQL (Confluence Query Language). Use this as the primary discovery… |
+| `read_page` | read | Read a page and return agent-friendly Markdown extracted from Confluence storage format (… |
+| `get_page_children` | read | List child content under a page (typically child pages). Use this to navigate page hierar… |
+| `get_comments` | read | List footer comments for a page, optionally including their child replies. Use this to re… |
+| `create_page` | write | Create a new Confluence page. Provide the body as Confluence storage format (XHTML). For … |
+| `update_page` | write | Update an existing Confluence page. This tool auto-fetches the current version number and… |
+| `delete_page` | write | Delete a Confluence page (moves it to trash by default). Use carefully. |
+| `add_comment` | write | Add a footer comment to a Confluence page. Provide the body as Confluence storage format … |
+| `add_label` | write | Add one or more labels to a Confluence page. Labels are useful for discovery via CQL (`la… |

package/integrations/confluence/__tests__/get_handlers.test.ts

@@ -0,0 +1,121 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv } from '../../__tests__/liveHarness.js'
+
+// LIVE Confluence read tests using credentials
+//
+// Variant: api_token
+// - CONFLUENCE_DOMAIN
+// - CONFLUENCE_EMAIL
+// - CONFLUENCE_API_TOKEN
+
+const env = process.env as Record<string, string | undefined>
+
+const suiteOrSkip = hasEnv('CONFLUENCE_DOMAIN', 'CONFLUENCE_EMAIL', 'CONFLUENCE_API_TOKEN') ? describe : describe.skip
+
+suiteOrSkip('confluence read handlers (live)', () => {
+  describe('variant: api_token', () => {
+    const ctx: {
+      spaceId?: string
+      spaceKey?: string
+      homepageId?: string
+      pageId?: string
+    } = {}
+
+    let confluence: ReturnType<typeof createToolbox>
+
+    beforeAll(async () => {
+      const credentialStore = createCredentialStore(async () => ({
+        domain: env.CONFLUENCE_DOMAIN!,
+        email: env.CONFLUENCE_EMAIL!,
+        apiToken: env.CONFLUENCE_API_TOKEN!,
+      }))
+      const proxy = createProxy(credentialStore)
+      confluence = createToolbox(
+        'confluence',
+        proxy,
+        createIntegrationNode('confluence', { label: 'Confluence', credentialId: 'confluence-creds', credentialVariant: 'api_token' }),
+        'api_token',
+      )
+
+      try {
+        const list_spaces = confluence.read('list_spaces')
+        const spaces = await list_spaces({ limit: 10 })
+        const first = spaces?.results?.[0]
+        ctx.spaceId = first?.id
+        ctx.spaceKey = first?.key
+        ctx.homepageId = first?.homepageId
+      }
+      catch {}
+
+      try {
+        if (ctx.spaceKey) {
+          const search_pages = confluence.read('search_pages')
+          const found = await search_pages({
+            cql: `space = "${ctx.spaceKey}" AND type = page ORDER BY lastmodified DESC`,
+            limit: 5,
+          })
+          const first = found?.results?.[0]
+          ctx.pageId = first?.id || ctx.homepageId
+        }
+        else {
+          ctx.pageId = ctx.homepageId
+        }
+      }
+      catch {
+        ctx.pageId = ctx.pageId || ctx.homepageId
+      }
+    }, 60000)
+
+    it('list_spaces returns spaces', async () => {
+      const list_spaces = confluence.read('list_spaces')
+      const res = await list_spaces({ limit: 10 })
+      expect(Array.isArray(res?.results)).toBe(true)
+    }, 30000)
+
+    it('get_space returns a space when spaceId is available', async () => {
+      if (!ctx.spaceId)
+        return expect(true).toBe(true)
+      const get_space = confluence.read('get_space')
+      const res = await get_space({ spaceId: ctx.spaceId })
+      expect(res?.id).toBe(ctx.spaceId)
+    }, 30000)
+
+    it('search_pages returns results for a basic CQL query (best effort)', async () => {
+      if (!ctx.spaceKey)
+        return expect(true).toBe(true)
+      const search_pages = confluence.read('search_pages')
+      const res = await search_pages({
+        cql: `space = "${ctx.spaceKey}" AND type = page ORDER BY lastmodified DESC`,
+        limit: 5,
+      })
+      expect(Array.isArray(res?.results)).toBe(true)
+    }, 30000)
+
+    it('read_page returns page content (storage) when pageId is available', async () => {
+      if (!ctx.pageId)
+        return expect(true).toBe(true)
+      const read_page = confluence.read('read_page')
+      const page = await read_page({ pageId: ctx.pageId, outputMarkdown: false })
+      expect(page?.id).toBe(ctx.pageId)
+      // Can be null for unusual pages; just require a usable response.
+      expect(page).toBeTruthy()
+    }, 30000)
+
+    it('get_page_children returns an array when pageId is available (best effort)', async () => {
+      if (!ctx.pageId)
+        return expect(true).toBe(true)
+      const get_page_children = confluence.read('get_page_children')
+      const res = await get_page_children({ pageId: ctx.pageId, limit: 10 })
+      expect(Array.isArray(res?.results)).toBe(true)
+    }, 30000)
+
+    it('get_comments returns an array when pageId is available (best effort)', async () => {
+      if (!ctx.pageId)
+        return expect(true).toBe(true)
+      const get_comments = confluence.read('get_comments')
+      const res = await get_comments({ pageId: ctx.pageId, limit: 10 })
+      expect(Array.isArray(res?.results)).toBe(true)
+    }, 30000)
+  })
+})
+

package/integrations/confluence/__tests__/usage_parity.test.ts

@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest'
+import { getMissingToolUsages } from '../../__tests__/usageParity.js'
+
+describe('confluence static usage parity', () => {
+  it('every api_token tool is referenced in tests', () => {
+    const missing = getMissingToolUsages({
+      integrationName: 'confluence',
+      importMetaUrl: import.meta.url,
+      credentialVariant: 'api_token',
+    })
+    expect(missing, `Missing handler usages in tests: ${missing.join(', ')}`).toEqual([])
+  })
+})
+

package/integrations/confluence/__tests__/write_handlers.test.ts

@@ -0,0 +1,131 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv, safeCleanup } from '../../__tests__/liveHarness.js'
+
+// LIVE Confluence write tests using credentials
+//
+// Required for write tests:
+// - CONFLUENCE_TEST_SPACE_KEY
+// Optional:
+// - CONFLUENCE_TEST_PARENT_PAGE_ID
+//
+// Variant: api_token
+// - CONFLUENCE_DOMAIN
+// - CONFLUENCE_EMAIL
+// - CONFLUENCE_API_TOKEN
+
+const env = process.env as Record<string, string | undefined>
+
+const suiteOrSkip = (hasEnv('CONFLUENCE_DOMAIN', 'CONFLUENCE_EMAIL', 'CONFLUENCE_API_TOKEN') && hasEnv('CONFLUENCE_TEST_SPACE_KEY'))
+  ? describe
+  : describe.skip
+
+suiteOrSkip('confluence write handlers (live)', () => {
+  describe('variant: api_token', () => {
+    const ctx: {
+      spaceId?: string
+      createdPageId?: string
+      createdLabel?: string
+      createdCommentId?: string
+    } = {}
+
+    let confluence: ReturnType<typeof createToolbox>
+
+    beforeAll(async () => {
+      const credentialStore = createCredentialStore(async () => ({
+        domain: env.CONFLUENCE_DOMAIN!,
+        email: env.CONFLUENCE_EMAIL!,
+        apiToken: env.CONFLUENCE_API_TOKEN!,
+      }))
+      const proxy = createProxy(credentialStore)
+      confluence = createToolbox(
+        'confluence',
+        proxy,
+        createIntegrationNode('confluence', { label: 'Confluence', credentialId: 'confluence-creds', credentialVariant: 'api_token' }),
+        'api_token',
+      )
+
+      // Resolve spaceId from configured space key.
+      try {
+        const list_spaces = confluence.read('list_spaces')
+        const spaces = await list_spaces({ keys: [env.CONFLUENCE_TEST_SPACE_KEY!], limit: 5 })
+        const first = spaces?.results?.[0]
+        ctx.spaceId = first?.id
+      }
+      catch {}
+    }, 60000)
+
+    afterAll(async () => {
+      await safeCleanup(async () => {
+        if (!ctx.createdPageId)
+          return
+        const delete_page = confluence.write('delete_page')
+        await delete_page({ pageId: ctx.createdPageId })
+      })
+    }, 60000)
+
+    it('create_page -> read_page -> update_page -> add_label -> add_comment -> get_comments -> delete_page roundtrip', async () => {
+      if (!ctx.spaceId)
+        return expect(true).toBe(true)
+
+      const parentId = env.CONFLUENCE_TEST_PARENT_PAGE_ID || null
+      const timestamp = Date.now()
+
+      const create_page = confluence.write('create_page')
+      const created = await create_page({
+        spaceId: ctx.spaceId,
+        parentId,
+        title: `CmdTest Confluence ${timestamp}`,
+        bodyStorage: `<p>Created by integration tests at ${timestamp}.</p>`,
+      })
+      const pageId = created?.id
+      expect(pageId).toBeTruthy()
+      ctx.createdPageId = pageId
+
+      const read_page = confluence.read('read_page')
+      const got = await read_page({ pageId, includeLabels: true, outputMarkdown: true })
+      expect(got?.id).toBe(pageId)
+
+      const update_page = confluence.write('update_page')
+      const updated = await update_page({
+        pageId,
+        title: `CmdTest Confluence Updated ${timestamp}`,
+        bodyStorage: `<p>Updated by integration tests at ${timestamp}.</p>`,
+        versionMessage: 'Updated by integration tests',
+      })
+      expect(updated?.id || updated?.title || updated).toBeTruthy()
+
+      const add_label = confluence.write('add_label')
+      const label = `cmdtest-${timestamp}`
+      ctx.createdLabel = label
+      const labelRes = await add_label({ pageId, labels: [label] })
+      expect(labelRes).toBeTruthy()
+
+      // Verify label via read_page (labels are included when includeLabels is true)
+      const afterLabel = await read_page({ pageId, includeLabels: true, outputMarkdown: false })
+      const labelNames = Array.isArray(afterLabel?.labels)
+        ? afterLabel.labels.map((l: any) => l?.name).filter(Boolean)
+        : []
+      expect(labelNames.includes(label)).toBe(true)
+
+      const add_comment = confluence.write('add_comment')
+      const commentText = `Test comment ${timestamp}`
+      const comment = await add_comment({ pageId, bodyStorage: `<p>${commentText}</p>` })
+      ctx.createdCommentId = comment?.id
+      expect(comment?.id || comment).toBeTruthy()
+
+      const get_comments = confluence.read('get_comments')
+      const comments = await get_comments({ pageId, limit: 50 })
+      const found = (comments?.results || []).some((c: any) =>
+        (c?.id && ctx.createdCommentId && String(c.id) === String(ctx.createdCommentId))
+        || (c?.body && JSON.stringify(c.body).includes(commentText)),
+      )
+      expect(found).toBe(true)
+
+      const delete_page = confluence.write('delete_page')
+      const deleted = await delete_page({ pageId })
+      expect(deleted?.ok === true || deleted).toBeTruthy()
+      ctx.createdPageId = undefined
+    }, 150000)
+  })
+})
+

package/integrations/confluence/credentials.json

@@ -0,0 +1,39 @@
+{
+  "variants": {
+    "api_token": {
+      "label": "API Token (Email + Token)",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "domain": {
+            "type": "string",
+            "title": "Confluence site domain",
+            "description": "The subdomain of your Confluence Cloud site. Example: for https://mycompany.atlassian.net/wiki, enter 'mycompany'."
+          },
+          "email": {
+            "type": "string",
+            "title": "Atlassian account email",
+            "description": "Email address of the Atlassian account that owns the API token."
+          },
+          "apiToken": {
+            "type": "string",
+            "title": "Atlassian API token",
+            "description": "Atlassian API token for Confluence Cloud. The server will convert this into the required Basic auth header."
+          }
+        },
+        "required": ["domain", "email", "apiToken"],
+        "additionalProperties": false
+      },
+      "baseUrlTemplate": "https://{{domain}}.atlassian.net",
+      "injection": {
+        "headers": {
+          "Authorization": "Basic {{basicAuth}}",
+          "Accept": "application/json"
+        }
+      },
+      "preprocess": "confluence_api_token"
+    }
+  },
+  "default": "api_token"
+}
+

package/integrations/confluence/credentials_hint.md

@@ -0,0 +1,4 @@
+Recommended: use **API Token (Email + Token)** unless you specifically need OAuth.
+
+If you have multiple credential variants available, select one and follow its setup instructions.
+

package/integrations/confluence/credentials_hint_api_token.md

@@ -0,0 +1,9 @@
+Set up Confluence Cloud API token auth:
+
+1. Open your Confluence site (it looks like `https://YOUR_DOMAIN.atlassian.net/wiki`)
+2. Copy `YOUR_DOMAIN` (the subdomain) and use it as `domain`
+3. Create an Atlassian API token at `https://id.atlassian.com/manage-profile/security/api-tokens`
+4. Use the Atlassian account email as `email` and paste the token as `apiToken`
+
+Note: The server computes the required Basic auth header for you.
+

package/integrations/confluence/credentials_hint_oauth_token.md

@@ -0,0 +1,8 @@
+Set up Confluence Cloud OAuth (3LO):
+
+1. Create an OAuth 2.0 (3LO) app in the Atlassian developer console
+2. Add Confluence scopes (typical minimum): read:page:confluence, write:page:confluence, read:space:confluence (plus offline_access if you want refresh tokens)
+3. Complete the OAuth flow to obtain an access token
+4. Call `GET https://api.atlassian.com/oauth/token/accessible-resources` with `Authorization: Bearer <access_token>` to get `cloudId`
+5. Paste `cloudId` and the OAuth access `token` here
+

package/integrations/confluence/handlers/add_comment.js

@@ -0,0 +1,19 @@
+async (input) => {
+  const body = {
+    pageId: String(input.pageId),
+    body: {
+      representation: 'storage',
+      value: String(input.bodyStorage),
+    },
+  }
+
+  if (input.parentCommentId)
+    body.parentCommentId = String(input.parentCommentId)
+
+  const res = await integration.fetch('/wiki/api/v2/footer-comments', {
+    method: 'POST',
+    body,
+  })
+  return await res.json()
+}
+

package/integrations/confluence/handlers/add_label.js

@@ -0,0 +1,16 @@
+async (input) => {
+  const pageId = encodeURIComponent(String(input.pageId))
+  const labels = Array.isArray(input.labels) ? input.labels : []
+
+  const body = labels
+    .map((name) => String(name).trim())
+    .filter(Boolean)
+    .map((name) => ({ prefix: 'global', name }))
+
+  const res = await integration.fetch(`/wiki/rest/api/content/${pageId}/label`, {
+    method: 'POST',
+    body,
+  })
+  return await res.json()
+}
+

package/integrations/confluence/handlers/create_page.js

@@ -0,0 +1,22 @@
+async (input) => {
+  const body = {
+    spaceId: String(input.spaceId),
+    status: input.status || 'current',
+    title: String(input.title),
+    body: {
+      representation: 'storage',
+      value: String(input.bodyStorage),
+    },
+  }
+
+  if (input.parentId)
+    body.parentId = String(input.parentId)
+
+  const res = await integration.fetch('/wiki/api/v2/pages', {
+    method: 'POST',
+    body,
+  })
+
+  return await res.json()
+}
+

package/integrations/confluence/handlers/delete_page.js

@@ -0,0 +1,17 @@
+async (input) => {
+  const pageId = encodeURIComponent(String(input.pageId))
+  const params = new URLSearchParams()
+  if (input.purge) params.set('purge', 'true')
+  if (input.draft) params.set('draft', 'true')
+
+  const res = await integration.fetch(`/wiki/api/v2/pages/${pageId}${params.toString() ? `?${params}` : ''}`, {
+    method: 'DELETE',
+  })
+
+  if (res.status === 204)
+    return { ok: true }
+
+  // Some proxies/APIs may still return JSON; try to parse.
+  try { return await res.json() } catch { return { ok: res.ok, status: res.status } }
+}
+

package/integrations/confluence/handlers/get_comments.js

@@ -0,0 +1,33 @@
+async (input) => {
+  const pageId = encodeURIComponent(String(input.pageId))
+  const params = new URLSearchParams()
+
+  params.set('body-format', 'STORAGE')
+
+  const limit = typeof input.limit === 'number' ? input.limit : undefined
+  if (limit) params.set('limit', String(limit))
+  if (input.cursor) params.set('cursor', String(input.cursor))
+
+  const res = await integration.fetch(`/wiki/api/v2/pages/${pageId}/footer-comments?${params}`)
+  const data = await res.json()
+
+  const results = Array.isArray(data?.results)
+    ? data.results.map((c) => ({
+        id: c.id,
+        status: c.status,
+        title: c.title,
+        pageId: c.pageId,
+        version: c?.version?.number,
+        authorId: c?.version?.authorId,
+        createdAt: c?.version?.createdAt,
+        body: c?.body,
+        webui: c?._links?.webui,
+      }))
+    : []
+
+  return {
+    results,
+    links: data?._links || {},
+  }
+}
+

package/integrations/confluence/handlers/get_page_children.js

@@ -0,0 +1,30 @@
+async (input) => {
+  const pageId = encodeURIComponent(String(input.pageId))
+  const params = new URLSearchParams()
+
+  const limit = typeof input.limit === 'number' ? input.limit : undefined
+  if (limit) params.set('limit', String(limit))
+  if (input.cursor) params.set('cursor', String(input.cursor))
+  if (typeof input.sort === 'string' && input.sort) params.set('sort', input.sort)
+
+  const res = await integration.fetch(`/wiki/api/v2/pages/${pageId}/children${params.toString() ? `?${params}` : ''}`)
+  const data = await res.json()
+
+  const results = Array.isArray(data?.results)
+    ? data.results.map((c) => ({
+        id: c.id,
+        type: c.type,
+        status: c.status,
+        title: c.title,
+        parentId: c.parentId,
+        spaceId: c.spaceId,
+        links: c?._links || {},
+      }))
+    : []
+
+  return {
+    results,
+    links: data?._links || {},
+  }
+}
+

package/integrations/confluence/handlers/get_space.js

@@ -0,0 +1,22 @@
+async (input) => {
+  const spaceId = encodeURIComponent(String(input.spaceId))
+  const params = new URLSearchParams()
+  if (input.includePermissions) params.set('include-permissions', 'true')
+
+  const path = `/wiki/api/v2/spaces/${spaceId}${params.toString() ? `?${params}` : ''}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+
+  return {
+    id: data?.id,
+    key: data?.key,
+    name: data?.name,
+    type: data?.type,
+    status: data?.status,
+    homepageId: data?.homepageId,
+    description: data?.description,
+    links: data?._links || {},
+    raw: data,
+  }
+}
+