flowseeker 0.1.7

package/dist/gateway/agentPrompts.js

@@ -0,0 +1,176 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGuidancePrompt = createGuidancePrompt;
+exports.createPlanPrompt = createPlanPrompt;
+exports.createApprovedEditPrompt = createApprovedEditPrompt;
+exports.createPromptWithInstruction = createPromptWithInstruction;
+exports.createPlanInstruction = createPlanInstruction;
+exports.createApprovedEditInstruction = createApprovedEditInstruction;
+const vscode = __importStar(require("vscode"));
+const responseLanguage_1 = require("../pipeline/responseLanguage");
+const solvePacket_1 = require("../pipeline/solvePacket");
+const tokenSavings_1 = require("../pipeline/tokenSavings");
+const approvalPolicy_1 = require("../agent/approvalPolicy");
+const mcpToolRunner_1 = require("../agent/mcpToolRunner");
+function createGuidancePrompt(result) {
+    return createBasePrompt(result, "Return concise markdown guidance. Explain the likely edit files, why they matter, what to inspect, what to change, risks, and focused verification steps. Do not invent files that are not supported by the retrieved context.");
+}
+function createPlanPrompt(result) {
+    return createBasePrompt(result, createPlanInstruction());
+}
+function createApprovedEditPrompt(result, approvedPlan) {
+    return createBasePrompt(result, createApprovedEditInstruction(approvedPlan));
+}
+function createPromptWithInstruction(result, instruction) {
+    return createBasePrompt(result, instruction);
+}
+function createPlanInstruction() {
+    return [
+        "Return a reviewable implementation plan in markdown only.",
+        "Do not output code edits, patches, diffs, or JSON.",
+        "The plan must include: goal, files likely to edit, files to inspect only, step-by-step change plan, test/verification plan, and risks/unknowns.",
+        "Keep the plan specific to the retrieved files and explain if confidence is low.",
+        "End with: Awaiting user approval before generating edits."
+    ].join(" ");
+}
+function createApprovedEditInstruction(approvedPlan) {
+    return [
+        "The user approved this plan:",
+        approvedPlan,
+        "",
+        "CRITICAL — YOUR ENTIRE RESPONSE MUST BE A SINGLE JSON OBJECT AND NOTHING ELSE.",
+        "No markdown. No code fences. No explanation before or after the JSON. Start with { and end with }.",
+        "",
+        "Schema (every field is required):",
+        "{",
+        "  \"message\": \"short summary of what was changed\",",
+        "  \"edits\": [",
+        "    {",
+        "      \"file\": \"relative/path/from/workspace/root\",",
+        "      \"range\": { \"startLine\": 1, \"startColumn\": 1, \"endLine\": 1, \"endColumn\": 1 },",
+        "      \"text\": \"complete replacement text for that range\"",
+        "    }",
+        "  ],",
+        "  \"commands\": [{ \"command\": \"npm run test\", \"rationale\": \"why this verifies the change\" }],",
+        "  \"mcpTools\": [{ \"tool\": \"tool.name\", \"input\": {}, \"rationale\": \"why this tool is needed\" }]",
+        "}",
+        "",
+        "Rules:",
+        "- edits MUST be an array. A single edit object is invalid.",
+        "- Use 1-based line and column numbers.",
+        "- Every edit needs file + range + text.",
+        "- Only edit files that appear in the context above and are in the approved plan.",
+        "- If you cannot safely produce edits, return {\"message\":\"explain why\",\"edits\":[],\"commands\":[],\"mcpTools\":[]}.",
+        "- Commands and mcpTools are optional (empty arrays are fine).",
+        "",
+        "REMINDER: Output raw JSON only. First character must be {. Last character must be }."
+    ].join("\n");
+}
+function createBasePrompt(result, instruction) {
+    const packetMarkdown = result.solvePacket ? (0, solvePacket_1.renderSolvePacketMarkdown)(result.solvePacket) : result.contextPack;
+    const lang = vscode.workspace.getConfiguration("flowseeker").get("ai.outputLanguage", "auto");
+    const langInstruction = (0, responseLanguage_1.buildResponseLanguageInstruction)(lang, result.task);
+    const ruleInstruction = renderRuleInstruction();
+    const approvalInstruction = renderApprovalPolicyInstruction();
+    return [
+        "You are FlowSeeker's codebase-solving agent.",
+        "FlowSeeker already retrieved a bounded context pack from a large repository to reduce token use.",
+        renderPromptTokenSavings(result),
+        "Use only this context unless you clearly explain why extra files are needed.",
+        "FlowSeeker evidence is candidate context, not guaranteed truth.",
+        "Validate relevance before editing. Drop irrelevant files. Identify missing links before guessing.",
+        modeSpecificPromptPolicy(result),
+        approvalInstruction,
+        renderMcpToolInventory(),
+        ruleInstruction,
+        langInstruction,
+        "",
+        "Task:",
+        result.task,
+        "",
+        packetMarkdown,
+        "",
+        "---",
+        "",
+        instruction
+    ].join("\n");
+}
+function renderMcpToolInventory() {
+    const tools = (0, mcpToolRunner_1.availableToolNames)();
+    if (tools.length === 0) {
+        return "Available MCP/tools: none detected in this editor host.";
+    }
+    return ["Available MCP/tools:", ...tools.slice(0, 40).map((tool) => `- ${tool}`)].join("\n");
+}
+function renderApprovalPolicyInstruction() {
+    const policy = (0, approvalPolicy_1.getApprovalPolicy)();
+    return [
+        "Agent approval policy:",
+        `- Workspace reads/searches are ${policy.readWorkspace ? "allowed" : "not auto-approved"}.`,
+        `- Workspace edits are ${policy.editWorkspace ? "auto-approved by current settings" : "not auto-approved; produce a plan/diff and wait for user approval"}.`,
+        `- Safe verification commands are ${policy.safeCommands ? "auto-approved" : "not auto-approved unless explicitly requested by the user"}.`,
+        `- Arbitrary commands are ${policy.allCommands ? "auto-approved except destructive operations" : "not auto-approved"}.`,
+        `- MCP tools are ${policy.mcpTools ? "auto-approved" : "not auto-approved"}.`
+    ].join("\n");
+}
+function renderRuleInstruction() {
+    const rules = (0, approvalPolicy_1.getApprovalPolicy)().rules.map((rule) => rule.trim()).filter(Boolean);
+    if (rules.length === 0) {
+        return "User rules: none configured.";
+    }
+    return ["User rules:", ...rules.map((rule) => `- ${rule}`)].join("\n");
+}
+function modeSpecificPromptPolicy(result) {
+    if (["investigation", "unknown"].includes(result.profile.taskShape)) {
+        return [
+            "Task mode: read-only investigation/explanation.",
+            "Answer the user's question from the packet instead of producing an implementation plan.",
+            "Do not suggest edits or ask for expansion unless the retrieved context is genuinely insufficient.",
+            "When context is partial but enough to explain the likely flow, state that clearly and continue."
+        ].join(" ");
+    }
+    return "Task mode: implementation support. Produce a plan first for edits, then wait for user approval before generating changes.";
+}
+function renderPromptTokenSavings(result) {
+    const metrics = result.tokenSavings;
+    if (!metrics || metrics.status === "unavailable") {
+        return "Token savings metrics are unavailable for this run.";
+    }
+    const basis = metrics.basis === "workspace_index" ? "workspace index" : "scanned candidate text";
+    const warning = metrics.proofWarnings.length > 0 ? ` Proof warnings: ${metrics.proofWarnings.join("; ")}.` : "";
+    return `Measured token savings: Solve Packet ${(0, tokenSavings_1.formatTokenCount)(metrics.solvePacketTokensEstimate)} tokens vs ${basis} ${(0, tokenSavings_1.formatTokenCount)(metrics.workspaceTokensEstimate)} tokens by ${metrics.tokenizer} (${(0, tokenSavings_1.formatReductionPercent)(metrics.reductionPercent)} reduction, proof ${metrics.proofStatus}).${warning}`;
+}
+//# sourceMappingURL=agentPrompts.js.map