Function handleAsk

packages/cli/src/server/tools/coding-tools.ts:459–743

(
	params: zod.infer<typeof AskSchema>,
	logger: Logger = gatewayLog,
)

}

async function handleAsk(
	params: zod.infer<typeof AskSchema>,
	logger: Logger = gatewayLog,
) {
	if (!existsSync(params.dir)) {
		return {success: false, error: `Directory "${params.dir}" does not exist`};
	}

	// Scope enforcement: coding requires a folder with `coding` scope
	if (listFolders().length > 0) {
		const resolved = resolveFolderForPath(params.dir, 'coding');
		if (!resolved) {
			const err = folderScopeError(params.dir, 'coding');
			return {
				success: false,
				error: `${err.error.code}: ${err.error.message}`,
			};
		}
	}

	if (params.worktree && (!params.baseBranch || !params.branch)) {
		return {
			success: false,
			error:
				'Parameters "baseBranch" and "branch" are required when worktree is true',
		};
	}

	const resolved = resolveAgent(params.agent);
	if ('error' in resolved) return {success: false, error: resolved.error};
	const agentName = resolved.agent;

	let config = getAgentConfig(agentName);
	if (!config) {
		return {
			success: false,
			error: `Agent "${agentName}" not configured. Run 'corebrain coding config --agent ${agentName}' to set up.`,
		};
	}

	const isResume = Boolean(params.sessionId);
	let sessionId = params.sessionId || randomUUID();

	// On resume, if a previous PTY is still alive for this id, kill it before
	// respawning. The TUI has no API to inject a new prompt into a running
	// instance, so the only way to deliver `params.prompt` is a fresh
	// `--resume <id>` process. SIGTERM gives the agent a chance to flush its
	// transcript; we escalate to SIGKILL only if it doesn't exit in time.
	if (isResume && isProcessRunning(sessionId)) {
		logger(`coding_ask resume: killing running pty for sessionId=${sessionId}`);
		stopProcess(sessionId);
		let exited = await waitForProcessExit(sessionId, 5_000);
		if (!exited) {
			logger(`coding_ask resume: SIGTERM did not exit, escalating to SIGKILL`);
			ptyManager.kill(sessionId, 'SIGKILL');
			exited = await waitForProcessExit(sessionId, 2_000);
		}
		if (!exited) {