@commandable/integration-data 0.0.6 → 0.1.0

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

@@ -0,0 +1,193 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv } from '../../__tests__/liveHarness.js'
+
+// LIVE Jira read tests using credentials
+//
+// Variant: api_token
+// - JIRA_DOMAIN
+// - JIRA_EMAIL
+// - JIRA_API_TOKEN
+//
+// Optional (improves coverage):
+// - JIRA_TEST_PROJECT_KEY
+
+const env = process.env as Record<string, string | undefined>
+
+const suiteOrSkip = hasEnv('JIRA_DOMAIN', 'JIRA_EMAIL', 'JIRA_API_TOKEN') ? describe : describe.skip
+
+suiteOrSkip('jira read handlers (live)', () => {
+  describe('variant: api_token', () => {
+      const ctx: {
+        projectKey?: string
+        issueKey?: string
+        boardId?: number
+        sprintId?: number
+      } = {}
+
+      let jira: ReturnType<typeof createToolbox>
+
+      beforeAll(async () => {
+        const credentialStore = createCredentialStore(async () => ({
+          domain: env.JIRA_DOMAIN!,
+          email: env.JIRA_EMAIL!,
+          apiToken: env.JIRA_API_TOKEN!,
+        }))
+        const proxy = createProxy(credentialStore)
+        jira = createToolbox('jira', proxy, createIntegrationNode('jira', { label: 'Jira', credentialId: 'jira-creds', credentialVariant: 'api_token' }), 'api_token')
+
+        try {
+          const list_projects = jira.read('list_projects')
+          const projectsResp = await list_projects({ maxResults: 5 })
+          const first = projectsResp?.projects?.[0]
+          ctx.projectKey = env.JIRA_TEST_PROJECT_KEY || first?.key
+        }
+        catch {}
+
+        try {
+          if (ctx.projectKey) {
+            const search_issues = jira.read('search_issues')
+            const issuesResp = await search_issues({
+              jql: `project = ${ctx.projectKey} ORDER BY updated DESC`,
+              fields: ['summary', 'updated'],
+              maxResults: 1,
+            })
+            const firstIssue = issuesResp?.issues?.[0]
+            ctx.issueKey = firstIssue?.key
+          }
+        }
+        catch {}
+
+        try {
+          const list_boards = jira.read('list_boards')
+          const boardsResp = await list_boards({ maxResults: 5 })
+          const firstBoard = boardsResp?.boards?.[0]
+          ctx.boardId = typeof firstBoard?.id === 'number' ? firstBoard.id : undefined
+        }
+        catch {}
+
+        try {
+          if (ctx.boardId) {
+            const list_sprints = jira.read('list_sprints')
+            const sprintsResp = await list_sprints({ boardId: ctx.boardId, maxResults: 5 })
+            const firstSprint = sprintsResp?.sprints?.[0]
+            ctx.sprintId = typeof firstSprint?.id === 'number' ? firstSprint.id : undefined
+          }
+        }
+        catch {}
+      }, 60000)
+
+      it('get_myself returns authenticated user', async () => {
+        const get_myself = jira.read('get_myself')
+        const me = await get_myself({})
+        expect(me?.accountId).toBeTruthy()
+      }, 30000)
+
+      it('list_projects returns projects', async () => {
+        const list_projects = jira.read('list_projects')
+        const res = await list_projects({ maxResults: 5 })
+        expect(res?.projects).toBeTruthy()
+        expect(Array.isArray(res.projects)).toBe(true)
+      }, 30000)
+
+      it('get_project returns issueTypes when available', async () => {
+        if (!ctx.projectKey)
+          return expect(true).toBe(true)
+        const get_project = jira.read('get_project')
+        const project = await get_project({ projectIdOrKey: ctx.projectKey, expandIssueTypes: true })
+        expect(project?.key?.toUpperCase?.()).toBe(ctx.projectKey.toUpperCase())
+        expect(Array.isArray(project?.issueTypes)).toBe(true)
+      }, 30000)
+
+      it('search_issues returns issue list (best effort)', async () => {
+        if (!ctx.projectKey)
+          return expect(true).toBe(true)
+        const search_issues = jira.read('search_issues')
+        const res = await search_issues({ jql: `project = ${ctx.projectKey} ORDER BY updated DESC`, maxResults: 5 })
+        expect(res?.issues).toBeTruthy()
+        expect(Array.isArray(res.issues)).toBe(true)
+      }, 30000)
+
+      it('get_issue returns issue details (if any issue key discovered)', async () => {
+        if (!ctx.issueKey)
+          return expect(true).toBe(true)
+        const get_issue = jira.read('get_issue')
+        const issue = await get_issue({ issueIdOrKey: ctx.issueKey })
+        expect(issue?.key).toBe(ctx.issueKey)
+      }, 30000)
+
+      it('get_issue_comments returns comments (if any issue key discovered)', async () => {
+        if (!ctx.issueKey)
+          return expect(true).toBe(true)
+        const get_issue_comments = jira.read('get_issue_comments')
+        const comments = await get_issue_comments({ issueIdOrKey: ctx.issueKey, maxResults: 5 })
+        expect(comments?.comments).toBeTruthy()
+        expect(Array.isArray(comments.comments)).toBe(true)
+      }, 30000)
+
+      it('get_transitions returns transitions (if any issue key discovered)', async () => {
+        if (!ctx.issueKey)
+          return expect(true).toBe(true)
+        const get_transitions = jira.read('get_transitions')
+        const res = await get_transitions({ issueIdOrKey: ctx.issueKey })
+        expect(Array.isArray(res?.transitions)).toBe(true)
+      }, 30000)
+
+      it('search_users returns users (best effort)', async () => {
+        const get_myself = jira.read('get_myself')
+        const me = await get_myself({})
+        const query = me?.displayName || 'a'
+        const search_users = jira.read('search_users')
+        const res = await search_users({ query, maxResults: 5 })
+        expect(Array.isArray(res?.users)).toBe(true)
+      }, 30000)
+
+      it('boards: list_boards works (best effort)', async () => {
+        const list_boards = jira.read('list_boards')
+        const res = await list_boards({ maxResults: 5 })
+        expect(res?.boards).toBeTruthy()
+        expect(Array.isArray(res.boards)).toBe(true)
+      }, 30000)
+
+      it('boards: get_board works when boardId is available', async () => {
+        if (!ctx.boardId)
+          return expect(true).toBe(true)
+        const get_board = jira.read('get_board')
+        const board = await get_board({ boardId: ctx.boardId })
+        expect(board?.id).toBe(ctx.boardId)
+      }, 30000)
+
+      it('boards: list_sprints works when boardId is available', async () => {
+        if (!ctx.boardId)
+          return expect(true).toBe(true)
+        const list_sprints = jira.read('list_sprints')
+        const res = await list_sprints({ boardId: ctx.boardId, maxResults: 5 })
+        expect(res?.sprints).toBeTruthy()
+        expect(Array.isArray(res.sprints)).toBe(true)
+      }, 30000)
+
+      it('boards: get_sprint works when sprintId is available', async () => {
+        if (!ctx.sprintId)
+          return expect(true).toBe(true)
+        const get_sprint = jira.read('get_sprint')
+        const sprint = await get_sprint({ sprintId: ctx.sprintId })
+        expect(sprint?.id).toBe(ctx.sprintId)
+      }, 30000)
+
+      it('boards: get_sprint_issues works when sprintId is available', async () => {
+        if (!ctx.sprintId)
+          return expect(true).toBe(true)
+        const get_sprint_issues = jira.read('get_sprint_issues')
+        const res = await get_sprint_issues({ sprintId: ctx.sprintId, maxResults: 5 })
+        expect(res).toBeTruthy()
+      }, 30000)
+
+      it('boards: get_backlog_issues works when boardId is available', async () => {
+        if (!ctx.boardId)
+          return expect(true).toBe(true)
+        const get_backlog_issues = jira.read('get_backlog_issues')
+        const res = await get_backlog_issues({ boardId: ctx.boardId, maxResults: 5 })
+        expect(res).toBeTruthy()
+      }, 30000)
+  })
+})
+

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

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

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

@@ -0,0 +1,157 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv, safeCleanup } from '../../__tests__/liveHarness.js'
+
+// LIVE Jira write tests using credentials
+//
+// Required for write tests:
+// - JIRA_TEST_PROJECT_KEY
+//
+// Variant: api_token
+// - JIRA_DOMAIN
+// - JIRA_EMAIL
+// - JIRA_API_TOKEN
+//
+// Optional:
+// - JIRA_TEST_TRANSITION_NAME (enables transition_issue)
+// - JIRA_TEST_BOARD_ID (enables sprint roundtrip: create_sprint -> update_sprint -> move_issues_to_sprint -> update_sprint)
+
+const env = process.env as Record<string, string | undefined>
+
+const suiteOrSkip = (hasEnv('JIRA_DOMAIN', 'JIRA_EMAIL', 'JIRA_API_TOKEN') && hasEnv('JIRA_TEST_PROJECT_KEY'))
+  ? describe
+  : describe.skip
+
+suiteOrSkip('jira write handlers (live)', () => {
+  describe('variant: api_token', () => {
+      const ctx: {
+        createdIssueKey?: string
+        createdSprintId?: number
+      } = {}
+
+      let jira: ReturnType<typeof createToolbox>
+
+      beforeAll(async () => {
+        const credentialStore = createCredentialStore(async () => ({
+          domain: env.JIRA_DOMAIN!,
+          email: env.JIRA_EMAIL!,
+          apiToken: env.JIRA_API_TOKEN!,
+        }))
+        const proxy = createProxy(credentialStore)
+        jira = createToolbox('jira', proxy, createIntegrationNode('jira', { label: 'Jira', credentialId: 'jira-creds', credentialVariant: 'api_token' }), 'api_token')
+      }, 60000)
+
+      afterAll(async () => {
+        await safeCleanup(async () => {
+          if (!ctx.createdSprintId)
+            return
+          const update_sprint = jira.write('update_sprint')
+          await update_sprint({ sprintId: ctx.createdSprintId, state: 'closed' })
+        })
+        await safeCleanup(async () => {
+          if (!ctx.createdIssueKey)
+            return
+          const delete_issue = jira.write('delete_issue')
+          await delete_issue({ issueIdOrKey: ctx.createdIssueKey })
+        })
+      }, 60000)
+
+      it('create_issue -> get_issue -> update_issue -> add_comment -> get_issue_comments (and optional assign/transition) roundtrip', async () => {
+        const get_myself = jira.read('get_myself')
+        const me = await get_myself({})
+        expect(me?.accountId).toBeTruthy()
+
+        const get_project = jira.read('get_project')
+        const project = await get_project({ projectIdOrKey: env.JIRA_TEST_PROJECT_KEY, expandIssueTypes: true })
+        const issueTypes = Array.isArray(project?.issueTypes) ? project.issueTypes : []
+        const picked = issueTypes.find((t: any) => t && t.subtask === false) || issueTypes[0]
+        if (!picked?.id && !picked?.name)
+          return expect(true).toBe(true)
+
+        const create_issue = jira.write('create_issue')
+        const created = await create_issue({
+          projectKey: env.JIRA_TEST_PROJECT_KEY,
+          issueTypeId: picked?.id || undefined,
+          issueTypeName: picked?.id ? undefined : (picked?.name || undefined),
+          summary: `CmdTest ${Date.now()}`,
+          descriptionText: 'Created by integration tests.',
+          assigneeAccountId: me.accountId,
+          labels: ['cmdtest'],
+        })
+        const issueKey = created?.key || created?.id
+        expect(issueKey).toBeTruthy()
+        ctx.createdIssueKey = created?.key || created?.id
+
+        const get_issue = jira.read('get_issue')
+        const got = await get_issue({ issueIdOrKey: issueKey })
+        expect(got?.key).toBeTruthy()
+
+        const update_issue = jira.write('update_issue')
+        const updated = await update_issue({
+          issueIdOrKey: issueKey,
+          summary: `CmdTest Updated ${Date.now()}`,
+          descriptionText: 'Updated by integration tests.',
+        })
+        expect(updated?.success === true || updated).toBeTruthy()
+
+        const add_comment = jira.write('add_comment')
+        const commentText = `Test comment ${Date.now()}`
+        const comment = await add_comment({ issueIdOrKey: issueKey, bodyText: commentText })
+        expect(comment?.id).toBeTruthy()
+
+        const get_issue_comments = jira.read('get_issue_comments')
+        const comments = await get_issue_comments({ issueIdOrKey: issueKey, maxResults: 20 })
+        const found = (comments?.comments || []).some((c: any) =>
+          (c?.bodyMarkdown && String(c.bodyMarkdown).includes('Test comment'))
+          || (c?.bodyText && String(c.bodyText).includes('Test comment')),
+        )
+        expect(found).toBe(true)
+
+        const assign_issue = jira.write('assign_issue')
+        const assigned = await assign_issue({ issueIdOrKey: issueKey, accountId: me.accountId })
+        expect(assigned?.success === true || assigned).toBeTruthy()
+        const unassigned = await assign_issue({ issueIdOrKey: issueKey, accountId: null })
+        expect(unassigned?.success === true || unassigned).toBeTruthy()
+
+        if (env.JIRA_TEST_TRANSITION_NAME) {
+          const transition_issue = jira.write('transition_issue')
+          const transitioned = await transition_issue({
+            issueIdOrKey: issueKey,
+            transitionName: env.JIRA_TEST_TRANSITION_NAME,
+            commentText: 'Transitioned by integration tests.',
+          })
+          expect(transitioned?.success === true || transitioned).toBeTruthy()
+        }
+      }, 120000)
+
+      it('sprint roundtrip: create_sprint -> update_sprint (start) -> move_issues_to_sprint -> update_sprint (close) (optional)', async () => {
+        if (!env.JIRA_TEST_BOARD_ID || !ctx.createdIssueKey)
+          return expect(true).toBe(true)
+        const boardId = Number(env.JIRA_TEST_BOARD_ID)
+        if (!Number.isFinite(boardId))
+          return expect(true).toBe(true)
+
+        const create_sprint = jira.write('create_sprint')
+        const name = `CmdTest Sprint ${Date.now()}`
+        const sprint = await create_sprint({ boardId, name })
+        const sprintId = sprint?.id
+        expect(typeof sprintId).toBe('number')
+        ctx.createdSprintId = sprintId
+
+        const update_sprint = jira.write('update_sprint')
+        const today = new Date().toISOString().slice(0, 10)
+        const twoWeeks = new Date(Date.now() + 14 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10)
+        const started = await update_sprint({ sprintId, state: 'active', startDate: today, endDate: twoWeeks })
+        expect(started?.state === 'active' || started?.id === sprintId || started).toBeTruthy()
+
+        const move_issues_to_sprint = jira.write('move_issues_to_sprint')
+        const moved = await move_issues_to_sprint({ sprintId, issueKeys: [ctx.createdIssueKey] })
+        expect(moved?.success === true || moved).toBeTruthy()
+
+        const closed = await update_sprint({ sprintId, state: 'closed' })
+        expect(closed?.state === 'closed' || closed?.id === sprintId || closed).toBeTruthy()
+        ctx.createdSprintId = undefined
+      }, 120000)
+
+  })
+})
+

package/integrations/jira/credentials.json

@@ -0,0 +1,39 @@
+{
+  "variants": {
+    "api_token": {
+      "label": "API Token (Email + Token)",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "domain": {
+            "type": "string",
+            "title": "Jira site domain",
+            "description": "The subdomain of your Jira Cloud site. Example: for https://mycompany.atlassian.net, 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 Jira Cloud. Combined with your email to form the Basic auth header."
+          }
+        },
+        "required": ["domain", "email", "apiToken"],
+        "additionalProperties": false
+      },
+      "baseUrlTemplate": "https://{{domain}}.atlassian.net",
+      "injection": {
+        "headers": {
+          "Authorization": "Basic {{base64(email + \":\" + apiToken)}}",
+          "Accept": "application/json"
+        }
+      },
+      "healthCheck": { "path": "/rest/api/3/myself" }
+    }
+  },
+  "default": "api_token"
+}
+

package/integrations/jira/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/jira/credentials_hint_api_token.md

@@ -0,0 +1,6 @@
+1. Open your Jira Cloud site in the browser (it looks like `https://YOUR_DOMAIN.atlassian.net`).
+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 same Atlassian account email as `email` and paste the token as `apiToken`.
+5. Ensure the Atlassian account has access to the Jira projects you want to work with.
+

package/integrations/jira/credentials_hint_oauth_token.md

@@ -0,0 +1,6 @@
+1. Create an OAuth 2.0 (3LO) app in the Atlassian developer console.
+2. Add Jira scopes (typical minimum): `read:jira-work`, `write:jira-work`, `read:jira-user` (and `offline_access` if you want refresh tokens).
+3. Complete the OAuth flow to obtain an access token.
+4. Discover your `cloudId` by calling `GET https://api.atlassian.com/oauth/token/accessible-resources` with `Authorization: Bearer <access_token>` and using the returned `id`.
+5. Paste `cloudId` and the current OAuth `token` here.
+

package/integrations/jira/handlers/add_comment.js

@@ -0,0 +1,9 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/comment`, {
+    method: 'POST',
+    body: { body: utils.adf?.fromMarkdown(input.bodyText) },
+  })
+
+  return await res.json()
+}
+

package/integrations/jira/handlers/assign_issue.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/assignee`, {
+    method: 'PUT',
+    body: { accountId: input.accountId },
+  })
+
+  if (res.status === 204)
+    return { success: true }
+  return await res.json()
+}
+

package/integrations/jira/handlers/create_issue.js

@@ -0,0 +1,37 @@
+async (input) => {
+  const fields = {
+    project: { key: input.projectKey },
+    summary: input.summary,
+  }
+
+  if (input.descriptionText)
+    fields.description = utils.adf?.fromMarkdown(input.descriptionText)
+
+  if (input.issueTypeId) {
+    fields.issuetype = { id: String(input.issueTypeId) }
+  }
+  else if (input.issueTypeName) {
+    fields.issuetype = { name: String(input.issueTypeName) }
+  }
+  else {
+    throw new Error(`Missing issue type. Provide issueTypeId or issueTypeName (call get_project to discover available issue types).`)
+  }
+
+  if (input.priorityId)
+    fields.priority = { id: input.priorityId }
+  else if (input.priorityName)
+    fields.priority = { name: input.priorityName }
+
+  if (Array.isArray(input.labels))
+    fields.labels = input.labels
+
+  if (input.assigneeAccountId)
+    fields.assignee = { accountId: input.assigneeAccountId }
+
+  const res = await integration.fetch('/rest/api/3/issue', {
+    method: 'POST',
+    body: { fields },
+  })
+
+  return await res.json()
+}

package/integrations/jira/handlers/create_sprint.js

@@ -0,0 +1,19 @@
+async (input) => {
+  const body = {
+    originBoardId: input.boardId,
+    name: input.name,
+  }
+  if (input.startDate)
+    body.startDate = input.startDate
+  if (input.endDate)
+    body.endDate = input.endDate
+  if (input.goal)
+    body.goal = input.goal
+
+  const res = await integration.fetch('/rest/agile/1.0/sprint', {
+    method: 'POST',
+    body,
+  })
+  return await res.json()
+}
+

package/integrations/jira/handlers/delete_issue.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}`, {
+    method: 'DELETE',
+  })
+
+  if (res.status === 204)
+    return { success: true }
+  return await res.json()
+}
+

package/integrations/jira/handlers/get_backlog_issues.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.jql)
+    params.set('jql', input.jql)
+  if (Array.isArray(input.fields) && input.fields.length)
+    params.set('fields', input.fields.join(','))
+  params.set('startAt', String(input.startAt ?? 0))
+  params.set('maxResults', String(input.maxResults ?? 50))
+
+  const res = await integration.fetch(`/rest/agile/1.0/board/${encodeURIComponent(String(input.boardId))}/backlog?${params.toString()}`)
+  return await res.json()
+}
+

package/integrations/jira/handlers/get_board.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/agile/1.0/board/${encodeURIComponent(String(input.boardId))}`)
+  const data = await res.json()
+  return data
+}
+

package/integrations/jira/handlers/get_issue.js

@@ -0,0 +1,63 @@
+async (input) => {
+  const defaultFields = [
+    'summary',
+    'status',
+    'assignee',
+    'priority',
+    'issuetype',
+    'project',
+    'description',
+    'created',
+    'updated',
+    'labels',
+  ]
+
+  const fields = Array.isArray(input.fields) && input.fields.length ? input.fields : defaultFields
+  const params = new URLSearchParams()
+  if (fields?.length)
+    params.set('fields', fields.join(','))
+  if (Array.isArray(input.expand) && input.expand.length)
+    params.set('expand', input.expand.join(','))
+
+  const path = `/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}${params.toString() ? `?${params.toString()}` : ''}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+
+  const descAdf = data?.fields?.description
+  const descMarkdown = utils.adf?.toMarkdown(descAdf) || ''
+  const descText = descMarkdown ? '' : (utils.adf?.toPlainText(descAdf) || '')
+
+  return {
+    id: data.id ?? null,
+    key: data.key ?? null,
+    self: data.self ?? null,
+    summary: data.fields?.summary ?? null,
+    status: data.fields?.status
+      ? {
+          id: data.fields.status.id ?? null,
+          name: data.fields.status.name ?? null,
+          category: data.fields.status.statusCategory
+            ? {
+                key: data.fields.status.statusCategory.key ?? null,
+                name: data.fields.status.statusCategory.name ?? null,
+              }
+            : null,
+        }
+      : null,
+    assignee: data.fields?.assignee
+      ? {
+          accountId: data.fields.assignee.accountId ?? null,
+          displayName: data.fields.assignee.displayName ?? null,
+        }
+      : null,
+    priority: data.fields?.priority ? { id: data.fields.priority.id ?? null, name: data.fields.priority.name ?? null } : null,
+    issueType: data.fields?.issuetype ? { id: data.fields.issuetype.id ?? null, name: data.fields.issuetype.name ?? null } : null,
+    project: data.fields?.project ? { id: data.fields.project.id ?? null, key: data.fields.project.key ?? null, name: data.fields.project.name ?? null } : null,
+    labels: Array.isArray(data.fields?.labels) ? data.fields.labels : [],
+    descriptionMarkdown: descMarkdown || null,
+    descriptionText: descMarkdown ? null : (descText || null),
+    created: data.fields?.created ?? null,
+    updated: data.fields?.updated ?? null,
+  }
+}
+

package/integrations/jira/handlers/get_issue_comments.js

@@ -0,0 +1,31 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('startAt', String(input.startAt ?? 0))
+  params.set('maxResults', String(input.maxResults ?? 50))
+
+  const path = `/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/comment?${params.toString()}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+  const comments = Array.isArray(data.comments) ? data.comments : []
+
+  return {
+    startAt: data.startAt ?? (input.startAt ?? 0),
+    maxResults: data.maxResults ?? (input.maxResults ?? 50),
+    total: data.total ?? comments.length,
+    comments: comments.map((c) => {
+      const md = utils.adf?.toMarkdown(c.body) || ''
+      const text = md ? '' : (utils.adf?.toPlainText(c.body) || '')
+      return {
+        id: c.id ?? null,
+        created: c.created ?? null,
+        updated: c.updated ?? null,
+        author: c.author
+          ? { accountId: c.author.accountId ?? null, displayName: c.author.displayName ?? null }
+          : null,
+        bodyMarkdown: md || null,
+        bodyText: md ? null : (text || null),
+      }
+    }),
+  }
+}
+

package/integrations/jira/handlers/get_myself.js

@@ -0,0 +1,14 @@
+async (_input) => {
+  const res = await integration.fetch('/rest/api/3/myself')
+  const data = await res.json()
+
+  return {
+    accountId: data.accountId ?? null,
+    displayName: data.displayName ?? null,
+    active: data.active ?? null,
+    timeZone: data.timeZone ?? null,
+    locale: data.locale ?? null,
+    emailAddress: data.emailAddress ?? null,
+  }
+}
+