Files
shockbot/mcp/askQuestion.ts
T
Colin McDonnell 2017922780 Improve delegate (#377)
* Improve delegate

* fix stale log regexes in delegate tests and add test-coupling comments

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-23 23:41:27 +00:00

61 lines
2.3 KiB
TypeScript

import { type } from "arktype";
import { ghPullfrogMcpName } from "../external.ts";
import { log } from "../utils/cli.ts";
import type { ToolContext } from "./server.ts";
import { execute, tool } from "./shared.ts";
import { createSubagentState, hasRunningSubagents, runSubagent } from "./subagent.ts";
export const AskQuestionParams = type({
question: type.string.describe(
"the question to answer about the codebase, architecture, or implementation details"
),
});
function buildQuestionPrompt(question: string): string {
return `Answer the following question by exploring the codebase using the available MCP tools (${ghPullfrogMcpName}/file_read, ${ghPullfrogMcpName}/list_directory, etc.).
Be thorough in your investigation but concise in your answer. Key facts only, no filler, no preamble.
Question: ${question}`;
}
export function AskQuestionTool(ctx: ToolContext) {
return tool({
name: "ask_question",
description:
"Ask a question about the codebase and get a concise answer from a lightweight research subagent. The intermediate exploration context stays in the subagent — only the concise answer returns to you.",
parameters: AskQuestionParams,
execute: execute(async (params) => {
if (hasRunningSubagents(ctx)) {
return { error: "cannot ask questions while subagents are running" };
}
const label = `ask-${params.question
.slice(0, 40)
.toLowerCase()
.replace(/[^a-z0-9]+/g, "-")
.replace(/^-|-$/g, "")}`;
const subagent = createSubagentState({ ctx, mode: "ask_question", label });
// matched by delegateAskQuestion test validator — update tests if changed
log.info(`» ask_question "${label}": ${params.question.slice(0, 100)}`);
const result = await runSubagent({
ctx,
subagent,
effort: "mini",
instructions: buildQuestionPrompt(params.question),
});
log.info(`» ask_question completed (success=${result.success})`);
return {
success: result.success,
answer:
subagent.output ??
result.error ??
"no answer produced — the subagent may not have called set_output. check stdoutFile for details.",
stdoutFile: subagent.stdoutFilePath,
};
}),
});
}