import { type IssueTriageInput, requireRecord, requireStringOrNumber, triageIssue } from './client.ts'

/**
 * Build an agent-ready triage bundle for one Sentry issue.
 *
 * @param params.issueId - Sentry issue id (required).
 * @param params.recentEventLimit - How many recent events to include.
 * @param params.host - Optional API host. Default `sentry.io`.
 * @returns Issue metadata, latest summary, and recent event summaries.
 * @example
 * import triageIssue from 'kody:@kody/sentry/triage-issue'
 * const triage = await triageIssue({ issueId: '1234567890', recentEventLimit: 3 })
 * // => { issue: { ... }, latestEventSummary: { ... }, recentEvents: [...] }
 */
export default async function triageIssueEntrypoint(params: unknown) {
	const input = requireRecord(params, 'triage-issue')
	requireStringOrNumber(input, 'issueId', 'triage-issue')
	return triageIssue(input as IssueTriageInput)
}