import type { FileOperationResponse, UpdateFileParams } from '@/tools/github/types' import type { ToolConfig } from '@/tools/types' export const updateFileTool: ToolConfig = { id: 'github_update_file', name: 'GitHub Update File', description: 'Update an existing file in a GitHub repository. Requires the file SHA. Content will be automatically Base64 encoded. Supports files up to 1MB.', 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', }, path: { type: 'string', required: true, visibility: 'user-or-llm', description: 'Path to the file to update (e.g., "src/index.ts")', }, message: { type: 'string', required: true, visibility: 'user-or-llm', description: 'Commit message for this file update', }, content: { type: 'string', required: true, visibility: 'user-or-llm', description: 'New file content (plain text, will be Base64 encoded automatically)', }, sha: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The blob SHA of the file being replaced (get from github_get_file_content)', }, branch: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Branch to update the file in (defaults to repository default branch)', }, 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}/contents/${params.path}`, method: 'PUT', headers: (params) => ({ Accept: 'application/vnd.github+json', Authorization: `Bearer ${params.apiKey}`, 'X-GitHub-Api-Version': '2022-11-28', }), body: (params) => { const base64Content = Buffer.from(params.content).toString('base64') const body: Record = { message: params.message, content: base64Content, sha: params.sha, // Required for update } if (params.branch) { body.branch = params.branch } return body }, }, transformResponse: async (response) => { const data = await response.json() const content = `File updated successfully! Path: ${data.content.path} Name: ${data.content.name} Size: ${data.content.size} bytes New SHA: ${data.content.sha} Commit: - SHA: ${data.commit.sha} - Message: ${data.commit.message} - Author: ${data.commit.author.name} - Date: ${data.commit.author.date} View file: ${data.content.html_url}` return { success: true, output: { content, metadata: { file: { name: data.content.name, path: data.content.path, sha: data.content.sha, size: data.content.size, type: data.content.type, download_url: data.content.download_url, html_url: data.content.html_url, }, commit: { sha: data.commit.sha, message: data.commit.message, author: { name: data.commit.author.name, email: data.commit.author.email, date: data.commit.author.date, }, committer: { name: data.commit.committer.name, email: data.commit.committer.email, date: data.commit.committer.date, }, html_url: data.commit.html_url, }, }, }, } }, outputs: { content: { type: 'string', description: 'Human-readable file update confirmation' }, metadata: { type: 'object', description: 'Updated file and commit metadata', properties: { file: { type: 'object', description: 'Updated file information', properties: { name: { type: 'string', description: 'File name' }, path: { type: 'string', description: 'Full path in repository' }, sha: { type: 'string', description: 'New git blob SHA' }, size: { type: 'number', description: 'File size in bytes' }, type: { type: 'string', description: 'Content type' }, download_url: { type: 'string', description: 'Direct download URL' }, html_url: { type: 'string', description: 'GitHub web UI URL' }, }, }, commit: { type: 'object', description: 'Commit information', properties: { sha: { type: 'string', description: 'Commit SHA' }, message: { type: 'string', description: 'Commit message' }, author: { type: 'object', description: 'Author information', }, committer: { type: 'object', description: 'Committer information', }, html_url: { type: 'string', description: 'Commit URL' }, }, }, }, }, }, } export const updateFileV2Tool: ToolConfig = { id: 'github_update_file_v2', name: updateFileTool.name, description: updateFileTool.description, version: '2.0.0', params: updateFileTool.params, request: updateFileTool.request, oauth: updateFileTool.oauth, transformResponse: async (response: Response) => { const data = await response.json() return { success: true, output: { content: data.content, commit: data.commit, }, } }, outputs: { content: { type: 'json', description: 'Updated file content info' }, commit: { type: 'json', description: 'Commit information' }, }, }