import type { SentryGetIssueParams, SentryGetIssueResponse } from '@/tools/sentry/types' import type { ToolConfig } from '@/tools/types' export const getIssueTool: ToolConfig = { id: 'sentry_issues_get', name: 'Get Issue', description: 'Retrieve detailed information about a specific Sentry issue by its ID. Returns complete issue details including metadata, tags, and statistics.', version: '1.0.0', params: { apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'Sentry API authentication token', }, organizationSlug: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The slug of the organization (e.g., "my-org")', }, issueId: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The unique ID of the issue to retrieve (e.g., "12345")', }, }, request: { url: (params) => `https://sentry.io/api/0/organizations/${params.organizationSlug}/issues/${params.issueId}/`, method: 'GET', headers: (params) => ({ Authorization: `Bearer ${params.apiKey}`, 'Content-Type': 'application/json', }), }, transformResponse: async (response: Response) => { const issue = await response.json() return { success: true, output: { issue: { id: issue.id, shortId: issue.shortId, title: issue.title, culprit: issue.culprit ?? null, permalink: issue.permalink, logger: issue.logger ?? null, level: issue.level, status: issue.status, substatus: issue.substatus ?? null, priority: issue.priority ?? null, statusDetails: issue.statusDetails || {}, isPublic: issue.isPublic, platform: issue.platform ?? null, project: { id: issue.project?.id || '', name: issue.project?.name || '', slug: issue.project?.slug || '', platform: issue.project?.platform || '', }, type: issue.type ?? null, metadata: { type: issue.metadata?.type || null, value: issue.metadata?.value || null, function: issue.metadata?.function || null, }, numComments: issue.numComments || 0, assignedTo: issue.assignedTo ? { id: issue.assignedTo.id, name: issue.assignedTo.name, email: issue.assignedTo.email, } : null, isBookmarked: issue.isBookmarked, isSubscribed: issue.isSubscribed, subscriptionDetails: issue.subscriptionDetails ?? null, hasSeen: issue.hasSeen, annotations: issue.annotations || [], isUnhandled: issue.isUnhandled, count: issue.count, userCount: issue.userCount || 0, firstSeen: issue.firstSeen, lastSeen: issue.lastSeen, stats: issue.stats || {}, }, }, } }, outputs: { issue: { type: 'object', description: 'Detailed information about the Sentry issue', properties: { id: { type: 'string', description: 'Unique issue ID' }, shortId: { type: 'string', description: 'Short issue identifier' }, title: { type: 'string', description: 'Issue title' }, culprit: { type: 'string', description: 'Function or location that caused the issue', optional: true, }, permalink: { type: 'string', description: 'Direct link to the issue in Sentry' }, logger: { type: 'string', description: 'Logger name that reported the issue', optional: true, }, level: { type: 'string', description: 'Severity level (error, warning, info, etc.)' }, status: { type: 'string', description: 'Current issue status' }, substatus: { type: 'string', description: 'Issue substatus (e.g., ongoing, escalating, new, archived_until_escalating)', optional: true, }, priority: { type: 'string', description: 'Issue priority (high, medium, or low)', optional: true, }, statusDetails: { type: 'object', description: 'Additional details about the status', }, isPublic: { type: 'boolean', description: 'Whether the issue is publicly visible' }, platform: { type: 'string', description: 'Platform where the issue occurred', optional: true, }, project: { type: 'object', description: 'Project information', properties: { id: { type: 'string', description: 'Project ID' }, name: { type: 'string', description: 'Project name' }, slug: { type: 'string', description: 'Project slug' }, platform: { type: 'string', description: 'Project platform' }, }, }, type: { type: 'string', description: 'Issue type', optional: true }, metadata: { type: 'object', description: 'Error metadata', properties: { type: { type: 'string', description: 'Type of error (e.g., TypeError, ValueError)' }, value: { type: 'string', description: 'Error message or value' }, function: { type: 'string', description: 'Function where the error occurred' }, }, }, numComments: { type: 'number', description: 'Number of comments on the issue' }, assignedTo: { type: 'object', description: 'User assigned to the issue (if any)', properties: { id: { type: 'string', description: 'User ID' }, name: { type: 'string', description: 'User name' }, email: { type: 'string', description: 'User email' }, }, }, isBookmarked: { type: 'boolean', description: 'Whether the issue is bookmarked' }, isSubscribed: { type: 'boolean', description: 'Whether the user is subscribed to updates' }, hasSeen: { type: 'boolean', description: 'Whether the user has seen this issue' }, annotations: { type: 'array', description: 'Issue annotations' }, isUnhandled: { type: 'boolean', description: 'Whether the issue is unhandled' }, count: { type: 'string', description: 'Total number of occurrences' }, userCount: { type: 'number', description: 'Number of unique users affected' }, firstSeen: { type: 'string', description: 'When the issue was first seen (ISO timestamp)' }, lastSeen: { type: 'string', description: 'When the issue was last seen (ISO timestamp)' }, stats: { type: 'object', description: 'Statistical information about the issue' }, }, }, }, }