import type { CreateReleaseParams, ReleaseResponse } from '@/tools/github/types' import { RELEASE_ASSET_OUTPUT_PROPERTIES, RELEASE_OUTPUT_PROPERTIES, USER_OUTPUT, } from '@/tools/github/types' import type { ToolConfig } from '@/tools/types' export const createReleaseTool: ToolConfig = { id: 'github_create_release', name: 'GitHub Create Release', description: 'Create a new release for a GitHub repository. Specify tag name, target commit, title, description, and whether it should be a draft or prerelease.', version: '1.0.0', params: { owner: { type: 'string', required: true, visibility: 'user-or-llm', description: 'Repository owner (user or organization)', }, repo: { type: 'string', required: true, visibility: 'user-or-llm', description: 'Repository name', }, tag_name: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The name of the tag for this release', }, target_commitish: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Defaults to the repository default branch.', }, name: { type: 'string', required: false, visibility: 'user-or-llm', description: 'The name of the release', }, body: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Text describing the contents of the release (markdown supported)', }, draft: { type: 'boolean', required: false, visibility: 'user-or-llm', description: 'true to create a draft (unpublished) release, false to create a published one', default: false, }, prerelease: { type: 'boolean', required: false, visibility: 'user-or-llm', description: 'true to identify the release as a prerelease, false to identify as a full release', default: false, }, apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'GitHub Personal Access Token', }, }, request: { url: (params) => `https://api.github.com/repos/${params.owner}/${params.repo}/releases`, method: 'POST', headers: (params) => ({ Accept: 'application/vnd.github+json', Authorization: `Bearer ${params.apiKey}`, 'X-GitHub-Api-Version': '2022-11-28', }), body: (params) => { const body: any = { tag_name: params.tag_name, } if (params.target_commitish) { body.target_commitish = params.target_commitish } if (params.name) { body.name = params.name } if (params.body) { body.body = params.body } if (params.draft !== undefined) { body.draft = params.draft } if (params.prerelease !== undefined) { body.prerelease = params.prerelease } return body }, }, transformResponse: async (response) => { const data = await response.json() const releaseType = data.draft ? 'Draft' : data.prerelease ? 'Prerelease' : 'Release' const content = `${releaseType} created: "${data.name || data.tag_name}" Tag: ${data.tag_name} URL: ${data.html_url} Created: ${data.created_at} ${data.published_at ? `Published: ${data.published_at}` : 'Not yet published'} Download URLs: - Tarball: ${data.tarball_url} - Zipball: ${data.zipball_url}` return { success: true, output: { content, metadata: { id: data.id, tag_name: data.tag_name, name: data.name || data.tag_name, html_url: data.html_url, tarball_url: data.tarball_url, zipball_url: data.zipball_url, draft: data.draft, prerelease: data.prerelease, created_at: data.created_at, published_at: data.published_at, }, }, } }, outputs: { content: { type: 'string', description: 'Human-readable release creation summary' }, metadata: { type: 'object', description: 'Release metadata including download URLs', properties: { id: { type: 'number', description: 'Release ID' }, tag_name: { type: 'string', description: 'Git tag name' }, name: { type: 'string', description: 'Release name' }, html_url: { type: 'string', description: 'GitHub web URL for the release' }, tarball_url: { type: 'string', description: 'URL to download release as tarball' }, zipball_url: { type: 'string', description: 'URL to download release as zipball' }, draft: { type: 'boolean', description: 'Whether this is a draft release' }, prerelease: { type: 'boolean', description: 'Whether this is a prerelease' }, created_at: { type: 'string', description: 'Creation timestamp' }, published_at: { type: 'string', description: 'Publication timestamp' }, }, }, }, } export const createReleaseV2Tool: ToolConfig = { id: 'github_create_release_v2', name: createReleaseTool.name, description: createReleaseTool.description, version: '2.0.0', params: createReleaseTool.params, request: createReleaseTool.request, oauth: createReleaseTool.oauth, transformResponse: async (response: Response) => { const data = await response.json() return { success: true, output: { id: data.id, tag_name: data.tag_name, name: data.name, body: data.body ?? null, html_url: data.html_url, tarball_url: data.tarball_url, zipball_url: data.zipball_url, draft: data.draft, prerelease: data.prerelease, author: data.author, assets: data.assets, target_commitish: data.target_commitish, created_at: data.created_at, published_at: data.published_at ?? null, }, } }, outputs: { ...RELEASE_OUTPUT_PROPERTIES, author: USER_OUTPUT, assets: { type: 'array', description: 'Release assets', items: { type: 'object', properties: { ...RELEASE_ASSET_OUTPUT_PROPERTIES, uploader: USER_OUTPUT, }, }, }, }, }