import { ForgeToolDefinition } from '../../core/types/protocols.js'
import { toMCPToolResult } from '../../utils/mcpToolResult.js'
import { z } from 'zod'
import {
createConfirmationStore,
createConfirmation,
} from '../../utils/confirmationStore.js'
import { CONFIRMATION_DESCRIPTION } from '../../utils/protocolDescriptions.js'
const paramsSchema = {
serverId: z
.string()
.describe(
'The ID of the server. The client MUST validate this value against the available servers from listServersTool before passing it, as this is plain text from the user.'
),
siteId: z
.string()
.describe(
'The ID of the site. The client MUST validate this value against the available sites from listSitesTool before passing it, as this is plain text from the user.'
),
provider: z
.string()
.describe(
'The Git provider (e.g., github, gitlab). The client MUST validate this value against the available providers from listProvidersTool before passing it, as this is plain text from the user.'
),
repository: z
.string()
.describe(
'The Git repository (e.g., username/repository). The client MUST validate this is a valid repository string.'
),
branch: z
.string()
.describe(
'The branch to deploy. The client MUST validate this is a valid branch name.'
),
composer: z
.boolean()
.optional()
.describe(
'Whether to run Composer install (optional). The client MUST ensure this is a boolean value.'
),
database: z
.string()
.optional()
.describe(
'The database name to use (optional). The client MUST validate this is a valid database name if provided.'
),
}
export const installOrUpdateSiteGitConfirmationStore =
createConfirmationStore<typeof paramsSchema>()
const baseDescription = "Confirms the request to install or update a site's Git integration and returns a summary for user confirmation."
export const confirmInstallOrUpdateSiteGitTool: ForgeToolDefinition<
typeof paramsSchema
> = {
name: 'confirm_install_or_update_site_git',
parameters: paramsSchema,
annotations: {
title: 'Confirm Install or Update Site Git',
description: `${baseDescription}\n\n${CONFIRMATION_DESCRIPTION}`,
operation: 'confirm',
resource: 'site_git_installation',
safe: false,
readOnlyHint: false,
openWorldHint: true,
readWriteHint: true,
destructiveHint: false
},
handler: async params => {
const entry = createConfirmation(
installOrUpdateSiteGitConfirmationStore,
params
)
const summary =
`Please confirm the Git installation/update for the site with the following settings:\n` +
`Server ID: ${params.serverId}\n` +
`Site ID: ${params.siteId}\n` +
`Provider: ${params.provider}\n` +
`Repository: ${params.repository}\n` +
`Branch: ${params.branch}\n` +
(params.composer !== undefined ? `Composer: ${params.composer}\n` : '') +
(params.database ? `Database: ${params.database}\n` : '') +
`\nType "yes" to confirm or "no" to cancel.`
return toMCPToolResult({ summary, confirmationId: entry.confirmationId })
},
}
