scai 0.1.178 → 1.0.0

package/dist/agent/evidence/index.js

@@ -0,0 +1,320 @@
+import { dedupePaths, looksLikeDirectoryTarget, nowIso, summarizeFileRead, uniqueStrings, } from "../read/summarizeReadEvidence.js";
+export { dedupePaths, looksLikeDirectoryTarget, nowIso, summarizeFileRead, uniqueStrings };
+const MAX_PRIMARY_GROUNDED_FILES = 4;
+const MAX_SUPPORTING_GROUNDED_FILES = 2;
+const MAX_FILE_FACTS = 3;
+const MAX_MUST_MENTION_SYMBOLS = 8;
+const MAX_MUST_MENTION_FACTS = 6;
+const FILTERED_SYMBOL_PATTERN = /^(?:repo:path|package:basename|json:filename|[a-z0-9_-]+:(?:path|basename|filename))$/i;
+const FILTERED_FACT_PATTERNS = [
+    /^relevant block near the strongest query match\.?$/i,
+    /^relevant code block near the strongest query match\.?$/i,
+    /^matches query terms:/i,
+    /^defines exported symbols:/i,
+];
+function looksLikeWeakGroundedSnippet(snippet) {
+    const trimmed = String(snippet ?? "").trim();
+    return (trimmed.length === 0 ||
+        /^(\d+: )?(?:\/\*\*|\*\/|\*\s*)/.test(trimmed) ||
+        /^(\d+: )?\/\/\s*File:/.test(trimmed) ||
+        /^(\d+: )?import\s+/.test(trimmed) ||
+        /^(\d+: )?export\s+(?:\*|\{[\s\S]+?\})\s+from\s+["'][^"']+["'];?$/.test(trimmed));
+}
+function excerptStrength(read) {
+    const excerpts = read.excerpts ?? [];
+    const snippetCount = (read.snippets ?? []).filter((snippet) => !looksLikeWeakGroundedSnippet(snippet)).length;
+    const commandExcerpt = excerpts.some((excerpt) => /\.command\(/.test(String(excerpt.code ?? "")));
+    const queryExcerpt = excerpts.some((excerpt) => /\.prepare\(|\bprepare\([^)]+\)\s*\.\s*(?:all|get|run)\(/.test(String(excerpt.code ?? "")));
+    const bridgeOnly = excerpts.length > 0 && excerpts.every((excerpt) => /^Legacy bridge re-export to /i.test(excerpt.description));
+    const weakSnippetOnly = (read.snippets ?? []).length > 0 && (read.snippets ?? []).every((snippet) => looksLikeWeakGroundedSnippet(snippet));
+    return ((commandExcerpt ? 60 : 0) +
+        (queryExcerpt ? 45 : 0) +
+        excerpts.length * 15 +
+        snippetCount * 6 -
+        (bridgeOnly ? 45 : 0) -
+        (weakSnippetOnly ? 40 : 0));
+}
+function collectCommandLiteralFacts(read) {
+    const facts = new Set();
+    for (const excerpt of read.excerpts ?? []) {
+        const code = String(excerpt.code ?? "");
+        const commandPattern = /\.command\(\s*["'`]([^"'`]+)["'`]\s*\)(?:[\s\S]{0,240}?)\.description\(\s*["'`]([^"'`]+)["'`]\s*\)/g;
+        let describedMatch;
+        while ((describedMatch = commandPattern.exec(code)) !== null) {
+            facts.add(`CLI command: ${describedMatch[1]}`);
+            facts.add(`The CLI registers "${describedMatch[1]}" to ${describedMatch[2].replace(/\.$/, "").toLowerCase()}.`);
+        }
+        const bareCommandPattern = /\.command\(\s*["'`]([^"'`]+)["'`]\s*\)/g;
+        let bareMatch;
+        while ((bareMatch = bareCommandPattern.exec(code)) !== null) {
+            facts.add(`CLI command: ${bareMatch[1]}`);
+        }
+    }
+    return Array.from(facts).slice(0, 6);
+}
+function collectExactTargetFacts(read) {
+    return (read.strengthSignals?.exactTargetPhrases ?? []).map((phrase) => `Exact target phrase: ${phrase}`);
+}
+function collectCommandLiteralSymbols(read) {
+    const symbols = new Set();
+    for (const excerpt of read.excerpts ?? []) {
+        const code = String(excerpt.code ?? "");
+        const bareCommandPattern = /\.command\(\s*["'`]([^"'`]+)["'`]\s*\)/g;
+        let match;
+        while ((match = bareCommandPattern.exec(code)) !== null) {
+            symbols.add(match[1]);
+        }
+    }
+    return Array.from(symbols).slice(0, 6);
+}
+function extractCliBinaryNames(read) {
+    const names = new Set();
+    const codeBlocks = [
+        ...(read.excerpts ?? []).map((excerpt) => String(excerpt.code ?? "")),
+        ...(read.snippets ?? []),
+    ];
+    for (const block of codeBlocks) {
+        const match = block.match(/["']([A-Za-z0-9_-]+)["']\s*:\s*["']\.\/dist\/index\.js["']/);
+        if (match?.[1]) {
+            names.add(match[1]);
+        }
+    }
+    return Array.from(names).slice(0, 3);
+}
+function isAnswerSymbolCandidate(symbol) {
+    const trimmed = String(symbol ?? "").trim();
+    if (!trimmed) {
+        return false;
+    }
+    return !FILTERED_SYMBOL_PATTERN.test(trimmed);
+}
+function isAnswerFactCandidate(fact) {
+    const trimmed = String(fact ?? "").trim();
+    if (!trimmed) {
+        return false;
+    }
+    return !FILTERED_FACT_PATTERNS.some((pattern) => pattern.test(trimmed));
+}
+function collectExcerptSymbols(read) {
+    return uniqueStrings((read.excerpts ?? []).flatMap((excerpt) => excerpt.symbols ?? [])).slice(0, 6);
+}
+function collectSearchFactHints(read, candidateReasons) {
+    const hints = new Set();
+    for (const symbol of [...(read.keySymbols ?? []), ...collectExcerptSymbols(read)]) {
+        const trimmed = String(symbol ?? "").trim();
+        if (isAnswerSymbolCandidate(trimmed)) {
+            hints.add(trimmed);
+        }
+    }
+    for (const reason of candidateReasons) {
+        const detail = String(reason ?? "").match(/^(?:symbol|match-confirmation):(.+)$/i)?.[1];
+        if (!detail) {
+            continue;
+        }
+        for (const token of detail.split(",")) {
+            const trimmed = token.trim();
+            if (isAnswerSymbolCandidate(trimmed)) {
+                hints.add(trimmed);
+            }
+        }
+    }
+    return Array.from(hints).slice(0, 8);
+}
+function collectCrossFileCommandFacts(reads) {
+    const binaries = uniqueStrings(reads.flatMap((read) => extractCliBinaryNames(read))).slice(0, 3);
+    if (binaries.length === 0) {
+        return [];
+    }
+    const commandFacts = new Set();
+    for (const read of reads) {
+        for (const fact of read.strengthSignals?.directAnswerFacts ?? collectCommandLiteralFacts(read)) {
+            const commandMatch = fact.match(/^CLI command:\s+(.+)$/i);
+            if (!commandMatch?.[1]) {
+                continue;
+            }
+            for (const binary of binaries) {
+                commandFacts.add(`CLI command: ${binary} ${commandMatch[1]}`);
+            }
+        }
+    }
+    return Array.from(commandFacts).slice(0, 6);
+}
+function normalizeFactKey(text) {
+    return String(text ?? "").trim().toLowerCase().replace(/\s+/g, " ");
+}
+function collectAnswerFacts(read) {
+    return uniqueStrings([
+        ...collectExactTargetFacts(read),
+        ...(read.strengthSignals?.directAnswerFacts ?? []),
+        ...collectCommandLiteralFacts(read),
+        ...(read.relevantContext ?? []).map((context) => context.text),
+        ...(read.excerpts ?? []).map((excerpt) => excerpt.description),
+        read.relevanceExplanation ?? "",
+        read.summary,
+    ]).filter(isAnswerFactCandidate).slice(0, MAX_FILE_FACTS);
+}
+function collectGroundedSymbols(read, candidateReasons) {
+    const commandLiteralSymbols = collectCommandLiteralSymbols(read);
+    const genericCommandNoise = new Set(["test", "tests", "command", "commands"]);
+    const symbols = uniqueStrings([
+        ...(read.strengthSignals?.implementationSymbols ?? []),
+        ...commandLiteralSymbols,
+        ...(read.keySymbols ?? []),
+        ...collectExcerptSymbols(read),
+        ...collectSearchFactHints(read, candidateReasons),
+    ]).filter(isAnswerSymbolCandidate);
+    const filteredSymbols = commandLiteralSymbols.length > 0
+        ? symbols.filter((symbol) => !genericCommandNoise.has(symbol.toLowerCase()))
+        : symbols;
+    return filteredSymbols.slice(0, MAX_MUST_MENTION_SYMBOLS);
+}
+function hasDirectGroundedAnswerSignal(read, candidateReasons) {
+    return collectGroundedSymbols(read, candidateReasons).length > 0
+        || collectAnswerFacts(read).length >= 2
+        || (read.matchedTerms ?? []).length >= 2
+        || (read.excerpts ?? []).length > 0;
+}
+function carriesExactTargetFact(candidate) {
+    return candidate.answerFacts.some((fact) => /^Exact target phrase:/i.test(fact));
+}
+function carriesDirectAnswerFacts(candidate) {
+    return candidate.answerFacts.some((fact) => /^CLI command:/i.test(fact))
+        || candidate.answerFacts.some((fact) => /^The CLI registers /i.test(fact));
+}
+function carriesStrongImplementation(candidate) {
+    return candidate.groundedSymbols.length > 0
+        && candidate.answerFacts.some((fact) => /implementation block|query execution|command registration/i.test(fact));
+}
+function buildGroundedFileCandidate(memory, read) {
+    const isHardTarget = memory.task.hardFileTargets.includes(read.filePath);
+    const isFullRead = (read.readMode ?? "full") === "full";
+    const candidateReasons = memory.evidence.candidateMetadata?.[read.filePath]?.searchReasons ?? [];
+    const groundedSymbols = collectGroundedSymbols(read, candidateReasons);
+    const answerFacts = collectAnswerFacts(read);
+    const role = isHardTarget
+        || read.role === "primary"
+        || (isFullRead && read.role !== "contextual" && hasDirectGroundedAnswerSignal(read, candidateReasons))
+        ? "primary"
+        : "supporting";
+    const score = ((isHardTarget ? 1000 : 0) +
+        (isFullRead ? 100 : 0) +
+        (role === "primary" ? 50 : 0) +
+        ((read.strengthSignals?.exactTargetPhrases.length ?? 0) * 90) +
+        ((read.strengthSignals?.implementationSymbols.length ?? 0) * 20) +
+        ((read.strengthSignals?.directAnswerFacts.length ?? 0) * 35) +
+        (read.strengthSignals?.strongestImplementationExcerpt ? 40 : 0) +
+        (read.strengthSignals?.strongestConceptExcerpt ? 20 : 0) +
+        excerptStrength(read) +
+        Math.round((memory.evidence.candidateMetadata?.[read.filePath]?.readPriority ?? read.triageScore ?? 0) * 100));
+    return {
+        filePath: read.filePath,
+        role,
+        isHardTarget,
+        isFullRead,
+        score,
+        groundedSymbols,
+        answerFacts,
+        whyItMatters: read.relevanceExplanation?.trim() || read.relevantContext[0]?.text || read.summary,
+        relevantContext: (read.relevantContext ?? []).slice(0, 3),
+        excerpts: (read.excerpts ?? []).slice(0, 2).map((excerpt) => ({
+            description: excerpt.description,
+            startLine: excerpt.startLine,
+            endLine: excerpt.endLine,
+            symbols: excerpt.symbols,
+            code: excerpt.code,
+        })),
+    };
+}
+function groundedFileToPacketEntry(candidate) {
+    return {
+        filePath: candidate.filePath,
+        role: candidate.role,
+        whyItMatters: candidate.whyItMatters,
+        keySymbols: candidate.groundedSymbols,
+        answerFacts: candidate.answerFacts,
+        relevantContext: candidate.relevantContext,
+        excerpts: candidate.excerpts,
+    };
+}
+function hasDistinctSupportingValue(candidate, primaryFactKeys) {
+    return candidate.answerFacts.some((fact) => !primaryFactKeys.has(normalizeFactKey(fact)));
+}
+export function buildAnswerReadyEvidence(memory) {
+    const allReads = Object.values(memory.evidence.fileReads);
+    if (memory.task.queryScope === "general" && allReads.length === 0) {
+        return {
+            normalizedQuery: memory.task.normalizedQuery,
+            primaryIntent: memory.task.primaryIntent,
+            queryScope: memory.task.queryScope,
+            explicitTargets: memory.task.explicitTargets,
+            groundedPrimaryFiles: [],
+            groundedSupportingFiles: [],
+            fileReads: [],
+            mustMentionFiles: [],
+            mustMentionSymbols: [],
+            mustMentionFacts: [],
+        };
+    }
+    const hardTargets = new Set(memory.task.hardFileTargets);
+    const candidates = allReads
+        .sort((left, right) => {
+        const leftHard = hardTargets.has(left.filePath) ? 1 : 0;
+        const rightHard = hardTargets.has(right.filePath) ? 1 : 0;
+        if (leftHard !== rightHard) {
+            return rightHard - leftHard;
+        }
+        const leftFull = (left.readMode ?? "full") === "full" ? 1 : 0;
+        const rightFull = (right.readMode ?? "full") === "full" ? 1 : 0;
+        if (leftFull !== rightFull) {
+            return rightFull - leftFull;
+        }
+        const leftPriority = memory.evidence.candidateMetadata?.[left.filePath]?.readPriority ?? left.triageScore ?? 0;
+        const rightPriority = memory.evidence.candidateMetadata?.[right.filePath]?.readPriority ?? right.triageScore ?? 0;
+        return rightPriority - leftPriority;
+    })
+        .map((read) => buildGroundedFileCandidate(memory, read))
+        .sort((left, right) => right.score - left.score);
+    const primaryCandidates = candidates
+        .filter((candidate) => candidate.role === "primary")
+        .slice(0, MAX_PRIMARY_GROUNDED_FILES);
+    const fallbackPrimary = primaryCandidates.length > 0 ? primaryCandidates : candidates.slice(0, Math.min(1, candidates.length));
+    const primaryFactKeys = new Set(fallbackPrimary.flatMap((candidate) => candidate.answerFacts.map(normalizeFactKey)));
+    const supportingCandidates = candidates
+        .filter((candidate) => !fallbackPrimary.some((primary) => primary.filePath === candidate.filePath))
+        .filter((candidate) => hasDistinctSupportingValue(candidate, primaryFactKeys))
+        .slice(0, MAX_SUPPORTING_GROUNDED_FILES);
+    const groundedPrimaryFiles = fallbackPrimary.map(groundedFileToPacketEntry);
+    const groundedSupportingFiles = supportingCandidates.map(groundedFileToPacketEntry);
+    const selectedFiles = [...groundedPrimaryFiles, ...groundedSupportingFiles];
+    const selectedCandidates = [...fallbackPrimary, ...supportingCandidates];
+    const exactTargetFacts = uniqueStrings(selectedCandidates.flatMap((candidate) => candidate.answerFacts.filter((fact) => /^Exact target phrase:/i.test(fact))));
+    const directCommandFacts = uniqueStrings([
+        ...selectedCandidates.flatMap((candidate) => candidate.answerFacts.filter((fact) => /^CLI command:/i.test(fact))),
+        ...collectCrossFileCommandFacts(allReads),
+    ]);
+    const prioritizedFacts = uniqueStrings([
+        ...exactTargetFacts,
+        ...directCommandFacts,
+        ...selectedCandidates.flatMap((candidate) => candidate.answerFacts),
+    ]).slice(0, MAX_MUST_MENTION_FACTS);
+    const prioritizedSymbols = uniqueStrings([
+        ...selectedCandidates
+            .filter((candidate) => carriesExactTargetFact(candidate) || carriesStrongImplementation(candidate) || carriesDirectAnswerFacts(candidate))
+            .flatMap((candidate) => candidate.groundedSymbols),
+        ...selectedFiles.flatMap((file) => file.keySymbols),
+    ]).slice(0, MAX_MUST_MENTION_SYMBOLS);
+    return {
+        normalizedQuery: memory.task.normalizedQuery,
+        primaryIntent: memory.task.primaryIntent,
+        queryScope: memory.task.queryScope,
+        explicitTargets: memory.task.explicitTargets,
+        groundedPrimaryFiles,
+        groundedSupportingFiles,
+        // Keep the older flat alias while callers move to primary/supporting grouping.
+        fileReads: selectedFiles,
+        mustMentionFiles: uniqueStrings(selectedFiles.map((file) => file.filePath)),
+        mustMentionSymbols: prioritizedSymbols,
+        mustMentionFacts: prioritizedFacts,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/evidence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/evidence/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Owns small evidence helpers for the modular agent runtime.\n *\n * Why this file exists:\n * - evidence shaping should stay separate from read execution and loop control\n * - shared string and path helpers should not live inside runtime files\n * - final-answer input should come from one compact evidence view\n */\nimport type { AgentMemory, FinalAnswerPacket, GroundedAnswerFile } from \"../types.js\";\nimport {\n  dedupePaths,\n  looksLikeDirectoryTarget,\n  nowIso,\n  summarizeFileRead,\n  uniqueStrings,\n} from \"../read/summarizeReadEvidence.js\";\n\nexport { dedupePaths, looksLikeDirectoryTarget, nowIso, summarizeFileRead, uniqueStrings };\n\nconst MAX_PRIMARY_GROUNDED_FILES = 4;\nconst MAX_SUPPORTING_GROUNDED_FILES = 2;\nconst MAX_FILE_FACTS = 3;\nconst MAX_MUST_MENTION_SYMBOLS = 8;\nconst MAX_MUST_MENTION_FACTS = 6;\nconst FILTERED_SYMBOL_PATTERN = /^(?:repo:path|package:basename|json:filename|[a-z0-9_-]+:(?:path|basename|filename))$/i;\nconst FILTERED_FACT_PATTERNS = [\n  /^relevant block near the strongest query match\\.?$/i,\n  /^relevant code block near the strongest query match\\.?$/i,\n  /^matches query terms:/i,\n  /^defines exported symbols:/i,\n];\n\nfunction looksLikeWeakGroundedSnippet(snippet: string): boolean {\n  const trimmed = String(snippet ?? \"\").trim();\n  return (\n    trimmed.length === 0 ||\n    /^(\\d+: )?(?:\\/\\*\\*|\\*\\/|\\*\\s*)/.test(trimmed) ||\n    /^(\\d+: )?\\/\\/\\s*File:/.test(trimmed) ||\n    /^(\\d+: )?import\\s+/.test(trimmed) ||\n    /^(\\d+: )?export\\s+(?:\\*|\\{[\\s\\S]+?\\})\\s+from\\s+[\"'][^\"']+[\"'];?$/.test(trimmed)\n  );\n}\n\nfunction excerptStrength(read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>): number {\n  const excerpts = read.excerpts ?? [];\n  const snippetCount = (read.snippets ?? []).filter((snippet) => !looksLikeWeakGroundedSnippet(snippet)).length;\n  const commandExcerpt = excerpts.some((excerpt) => /\\.command\\(/.test(String(excerpt.code ?? \"\")));\n  const queryExcerpt = excerpts.some((excerpt) => /\\.prepare\\(|\\bprepare\\([^)]+\\)\\s*\\.\\s*(?:all|get|run)\\(/.test(String(excerpt.code ?? \"\")));\n  const bridgeOnly = excerpts.length > 0 && excerpts.every((excerpt) => /^Legacy bridge re-export to /i.test(excerpt.description));\n  const weakSnippetOnly = (read.snippets ?? []).length > 0 && (read.snippets ?? []).every((snippet) => looksLikeWeakGroundedSnippet(snippet));\n\n  return (\n    (commandExcerpt ? 60 : 0) +\n    (queryExcerpt ? 45 : 0) +\n    excerpts.length * 15 +\n    snippetCount * 6 -\n    (bridgeOnly ? 45 : 0) -\n    (weakSnippetOnly ? 40 : 0)\n  );\n}\n\nfunction collectCommandLiteralFacts(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): string[] {\n  const facts = new Set<string>();\n\n  for (const excerpt of read.excerpts ?? []) {\n    const code = String(excerpt.code ?? \"\");\n    const commandPattern = /\\.command\\(\\s*[\"'`]([^\"'`]+)[\"'`]\\s*\\)(?:[\\s\\S]{0,240}?)\\.description\\(\\s*[\"'`]([^\"'`]+)[\"'`]\\s*\\)/g;\n    let describedMatch: RegExpExecArray | null;\n    while ((describedMatch = commandPattern.exec(code)) !== null) {\n      facts.add(`CLI command: ${describedMatch[1]}`);\n      facts.add(`The CLI registers \"${describedMatch[1]}\" to ${describedMatch[2].replace(/\\.$/, \"\").toLowerCase()}.`);\n    }\n\n    const bareCommandPattern = /\\.command\\(\\s*[\"'`]([^\"'`]+)[\"'`]\\s*\\)/g;\n    let bareMatch: RegExpExecArray | null;\n    while ((bareMatch = bareCommandPattern.exec(code)) !== null) {\n      facts.add(`CLI command: ${bareMatch[1]}`);\n    }\n  }\n\n  return Array.from(facts).slice(0, 6);\n}\n\nfunction collectExactTargetFacts(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): string[] {\n  return (read.strengthSignals?.exactTargetPhrases ?? []).map((phrase) => `Exact target phrase: ${phrase}`);\n}\n\nfunction collectCommandLiteralSymbols(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): string[] {\n  const symbols = new Set<string>();\n  for (const excerpt of read.excerpts ?? []) {\n    const code = String(excerpt.code ?? \"\");\n    const bareCommandPattern = /\\.command\\(\\s*[\"'`]([^\"'`]+)[\"'`]\\s*\\)/g;\n    let match: RegExpExecArray | null;\n    while ((match = bareCommandPattern.exec(code)) !== null) {\n      symbols.add(match[1]);\n    }\n  }\n  return Array.from(symbols).slice(0, 6);\n}\n\nfunction extractCliBinaryNames(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): string[] {\n  const names = new Set<string>();\n  const codeBlocks = [\n    ...(read.excerpts ?? []).map((excerpt) => String(excerpt.code ?? \"\")),\n    ...(read.snippets ?? []),\n  ];\n  for (const block of codeBlocks) {\n    const match = block.match(/[\"']([A-Za-z0-9_-]+)[\"']\\s*:\\s*[\"']\\.\\/dist\\/index\\.js[\"']/);\n    if (match?.[1]) {\n      names.add(match[1]);\n    }\n  }\n  return Array.from(names).slice(0, 3);\n}\n\nfunction isAnswerSymbolCandidate(symbol: string): boolean {\n  const trimmed = String(symbol ?? \"\").trim();\n  if (!trimmed) {\n    return false;\n  }\n  return !FILTERED_SYMBOL_PATTERN.test(trimmed);\n}\n\nfunction isAnswerFactCandidate(fact: string): boolean {\n  const trimmed = String(fact ?? \"\").trim();\n  if (!trimmed) {\n    return false;\n  }\n  return !FILTERED_FACT_PATTERNS.some((pattern) => pattern.test(trimmed));\n}\n\nfunction collectExcerptSymbols(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): string[] {\n  return uniqueStrings(\n    (read.excerpts ?? []).flatMap((excerpt) => excerpt.symbols ?? [])\n  ).slice(0, 6);\n}\n\nfunction collectSearchFactHints(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>,\n  candidateReasons: string[]\n): string[] {\n  const hints = new Set<string>();\n  for (const symbol of [...(read.keySymbols ?? []), ...collectExcerptSymbols(read)]) {\n    const trimmed = String(symbol ?? \"\").trim();\n    if (isAnswerSymbolCandidate(trimmed)) {\n      hints.add(trimmed);\n    }\n  }\n  for (const reason of candidateReasons) {\n    const detail = String(reason ?? \"\").match(/^(?:symbol|match-confirmation):(.+)$/i)?.[1];\n    if (!detail) {\n      continue;\n    }\n    for (const token of detail.split(\",\")) {\n      const trimmed = token.trim();\n      if (isAnswerSymbolCandidate(trimmed)) {\n        hints.add(trimmed);\n      }\n    }\n  }\n  return Array.from(hints).slice(0, 8);\n}\n\nfunction collectCrossFileCommandFacts(\n  reads: Array<NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>>\n): string[] {\n  const binaries = uniqueStrings(reads.flatMap((read) => extractCliBinaryNames(read))).slice(0, 3);\n  if (binaries.length === 0) {\n    return [];\n  }\n\n  const commandFacts = new Set<string>();\n  for (const read of reads) {\n    for (const fact of read.strengthSignals?.directAnswerFacts ?? collectCommandLiteralFacts(read)) {\n      const commandMatch = fact.match(/^CLI command:\\s+(.+)$/i);\n      if (!commandMatch?.[1]) {\n        continue;\n      }\n      for (const binary of binaries) {\n        commandFacts.add(`CLI command: ${binary} ${commandMatch[1]}`);\n      }\n    }\n  }\n  return Array.from(commandFacts).slice(0, 6);\n}\n\nfunction normalizeFactKey(text: string): string {\n  return String(text ?? \"\").trim().toLowerCase().replace(/\\s+/g, \" \");\n}\n\nfunction collectAnswerFacts(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): string[] {\n  return uniqueStrings([\n    ...collectExactTargetFacts(read),\n    ...(read.strengthSignals?.directAnswerFacts ?? []),\n    ...collectCommandLiteralFacts(read),\n    ...(read.relevantContext ?? []).map((context) => context.text),\n    ...(read.excerpts ?? []).map((excerpt) => excerpt.description),\n    read.relevanceExplanation ?? \"\",\n    read.summary,\n  ]).filter(isAnswerFactCandidate).slice(0, MAX_FILE_FACTS);\n}\n\nfunction collectGroundedSymbols(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>,\n  candidateReasons: string[]\n): string[] {\n  const commandLiteralSymbols = collectCommandLiteralSymbols(read);\n  const genericCommandNoise = new Set([\"test\", \"tests\", \"command\", \"commands\"]);\n  const symbols = uniqueStrings([\n    ...(read.strengthSignals?.implementationSymbols ?? []),\n    ...commandLiteralSymbols,\n    ...(read.keySymbols ?? []),\n    ...collectExcerptSymbols(read),\n    ...collectSearchFactHints(read, candidateReasons),\n  ]).filter(isAnswerSymbolCandidate);\n\n  const filteredSymbols = commandLiteralSymbols.length > 0\n    ? symbols.filter((symbol) => !genericCommandNoise.has(symbol.toLowerCase()))\n    : symbols;\n\n  return filteredSymbols.slice(0, MAX_MUST_MENTION_SYMBOLS);\n}\n\nfunction hasDirectGroundedAnswerSignal(\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>,\n  candidateReasons: string[]\n): boolean {\n  return collectGroundedSymbols(read, candidateReasons).length > 0\n    || collectAnswerFacts(read).length >= 2\n    || (read.matchedTerms ?? []).length >= 2\n    || (read.excerpts ?? []).length > 0;\n}\n\ntype GroundedFileCandidate = {\n  filePath: string;\n  role: \"primary\" | \"supporting\";\n  isHardTarget: boolean;\n  isFullRead: boolean;\n  score: number;\n  groundedSymbols: string[];\n  answerFacts: string[];\n  whyItMatters: string;\n  relevantContext: GroundedAnswerFile[\"relevantContext\"];\n  excerpts: GroundedAnswerFile[\"excerpts\"];\n};\n\nfunction carriesExactTargetFact(candidate: GroundedFileCandidate): boolean {\n  return candidate.answerFacts.some((fact) => /^Exact target phrase:/i.test(fact));\n}\n\nfunction carriesDirectAnswerFacts(candidate: GroundedFileCandidate): boolean {\n  return candidate.answerFacts.some((fact) => /^CLI command:/i.test(fact))\n    || candidate.answerFacts.some((fact) => /^The CLI registers /i.test(fact));\n}\n\nfunction carriesStrongImplementation(candidate: GroundedFileCandidate): boolean {\n  return candidate.groundedSymbols.length > 0\n    && candidate.answerFacts.some((fact) => /implementation block|query execution|command registration/i.test(fact));\n}\n\nfunction buildGroundedFileCandidate(\n  memory: AgentMemory,\n  read: NonNullable<AgentMemory[\"evidence\"][\"fileReads\"][string]>\n): GroundedFileCandidate {\n  const isHardTarget = memory.task.hardFileTargets.includes(read.filePath);\n  const isFullRead = (read.readMode ?? \"full\") === \"full\";\n  const candidateReasons = memory.evidence.candidateMetadata?.[read.filePath]?.searchReasons ?? [];\n  const groundedSymbols = collectGroundedSymbols(read, candidateReasons);\n  const answerFacts = collectAnswerFacts(read);\n  const role = isHardTarget\n    || read.role === \"primary\"\n    || (isFullRead && read.role !== \"contextual\" && hasDirectGroundedAnswerSignal(read, candidateReasons))\n    ? \"primary\"\n    : \"supporting\";\n  const score = (\n    (isHardTarget ? 1000 : 0) +\n    (isFullRead ? 100 : 0) +\n    (role === \"primary\" ? 50 : 0) +\n    ((read.strengthSignals?.exactTargetPhrases.length ?? 0) * 90) +\n    ((read.strengthSignals?.implementationSymbols.length ?? 0) * 20) +\n    ((read.strengthSignals?.directAnswerFacts.length ?? 0) * 35) +\n    (read.strengthSignals?.strongestImplementationExcerpt ? 40 : 0) +\n    (read.strengthSignals?.strongestConceptExcerpt ? 20 : 0) +\n    excerptStrength(read) +\n    Math.round((memory.evidence.candidateMetadata?.[read.filePath]?.readPriority ?? read.triageScore ?? 0) * 100)\n  );\n\n  return {\n    filePath: read.filePath,\n    role,\n    isHardTarget,\n    isFullRead,\n    score,\n    groundedSymbols,\n    answerFacts,\n    whyItMatters: read.relevanceExplanation?.trim() || read.relevantContext[0]?.text || read.summary,\n    relevantContext: (read.relevantContext ?? []).slice(0, 3),\n    excerpts: (read.excerpts ?? []).slice(0, 2).map((excerpt) => ({\n      description: excerpt.description,\n      startLine: excerpt.startLine,\n      endLine: excerpt.endLine,\n      symbols: excerpt.symbols,\n      code: excerpt.code,\n    })),\n  };\n}\n\nfunction groundedFileToPacketEntry(candidate: GroundedFileCandidate): GroundedAnswerFile {\n  return {\n    filePath: candidate.filePath,\n    role: candidate.role,\n    whyItMatters: candidate.whyItMatters,\n    keySymbols: candidate.groundedSymbols,\n    answerFacts: candidate.answerFacts,\n    relevantContext: candidate.relevantContext,\n    excerpts: candidate.excerpts,\n  };\n}\n\nfunction hasDistinctSupportingValue(\n  candidate: GroundedFileCandidate,\n  primaryFactKeys: Set<string>\n): boolean {\n  return candidate.answerFacts.some((fact) => !primaryFactKeys.has(normalizeFactKey(fact)));\n}\n\nexport function buildAnswerReadyEvidence(memory: AgentMemory): FinalAnswerPacket {\n  const allReads = Object.values(memory.evidence.fileReads);\n  if (memory.task.queryScope === \"general\" && allReads.length === 0) {\n    return {\n      normalizedQuery: memory.task.normalizedQuery,\n      primaryIntent: memory.task.primaryIntent,\n      queryScope: memory.task.queryScope,\n      explicitTargets: memory.task.explicitTargets,\n      groundedPrimaryFiles: [],\n      groundedSupportingFiles: [],\n      fileReads: [],\n      mustMentionFiles: [],\n      mustMentionSymbols: [],\n      mustMentionFacts: [],\n    };\n  }\n  const hardTargets = new Set(memory.task.hardFileTargets);\n  const candidates = allReads\n    .sort((left, right) => {\n      const leftHard = hardTargets.has(left.filePath) ? 1 : 0;\n      const rightHard = hardTargets.has(right.filePath) ? 1 : 0;\n      if (leftHard !== rightHard) {\n        return rightHard - leftHard;\n      }\n      const leftFull = (left.readMode ?? \"full\") === \"full\" ? 1 : 0;\n      const rightFull = (right.readMode ?? \"full\") === \"full\" ? 1 : 0;\n      if (leftFull !== rightFull) {\n        return rightFull - leftFull;\n      }\n      const leftPriority = memory.evidence.candidateMetadata?.[left.filePath]?.readPriority ?? left.triageScore ?? 0;\n      const rightPriority = memory.evidence.candidateMetadata?.[right.filePath]?.readPriority ?? right.triageScore ?? 0;\n      return rightPriority - leftPriority;\n    })\n    .map((read) => buildGroundedFileCandidate(memory, read))\n    .sort((left, right) => right.score - left.score);\n\n  const primaryCandidates = candidates\n    .filter((candidate) => candidate.role === \"primary\")\n    .slice(0, MAX_PRIMARY_GROUNDED_FILES);\n  const fallbackPrimary = primaryCandidates.length > 0 ? primaryCandidates : candidates.slice(0, Math.min(1, candidates.length));\n  const primaryFactKeys = new Set(\n    fallbackPrimary.flatMap((candidate) => candidate.answerFacts.map(normalizeFactKey))\n  );\n  const supportingCandidates = candidates\n    .filter((candidate) => !fallbackPrimary.some((primary) => primary.filePath === candidate.filePath))\n    .filter((candidate) => hasDistinctSupportingValue(candidate, primaryFactKeys))\n    .slice(0, MAX_SUPPORTING_GROUNDED_FILES);\n\n  const groundedPrimaryFiles = fallbackPrimary.map(groundedFileToPacketEntry);\n  const groundedSupportingFiles = supportingCandidates.map(groundedFileToPacketEntry);\n  const selectedFiles = [...groundedPrimaryFiles, ...groundedSupportingFiles];\n  const selectedCandidates = [...fallbackPrimary, ...supportingCandidates];\n  const exactTargetFacts = uniqueStrings(selectedCandidates.flatMap((candidate) =>\n    candidate.answerFacts.filter((fact) => /^Exact target phrase:/i.test(fact))\n  ));\n  const directCommandFacts = uniqueStrings([\n    ...selectedCandidates.flatMap((candidate) => candidate.answerFacts.filter((fact) => /^CLI command:/i.test(fact))),\n    ...collectCrossFileCommandFacts(allReads),\n  ]);\n  const prioritizedFacts = uniqueStrings([\n    ...exactTargetFacts,\n    ...directCommandFacts,\n    ...selectedCandidates.flatMap((candidate) => candidate.answerFacts),\n  ]).slice(0, MAX_MUST_MENTION_FACTS);\n  const prioritizedSymbols = uniqueStrings([\n    ...selectedCandidates\n      .filter((candidate) => carriesExactTargetFact(candidate) || carriesStrongImplementation(candidate) || carriesDirectAnswerFacts(candidate))\n      .flatMap((candidate) => candidate.groundedSymbols),\n    ...selectedFiles.flatMap((file) => file.keySymbols),\n  ]).slice(0, MAX_MUST_MENTION_SYMBOLS);\n\n  return {\n    normalizedQuery: memory.task.normalizedQuery,\n    primaryIntent: memory.task.primaryIntent,\n    queryScope: memory.task.queryScope,\n    explicitTargets: memory.task.explicitTargets,\n    groundedPrimaryFiles,\n    groundedSupportingFiles,\n    // Keep the older flat alias while callers move to primary/supporting grouping.\n    fileReads: selectedFiles,\n    mustMentionFiles: uniqueStrings(selectedFiles.map((file) => file.filePath)),\n    mustMentionSymbols: prioritizedSymbols,\n    mustMentionFacts: prioritizedFacts,\n  };\n}\n"]}

package/dist/agent/feedback/index.js

@@ -0,0 +1,187 @@
+/**
+ * Owns simple-agent waiting state and follow-up reply handling.
+ *
+ * Why this file exists:
+ * - feedback should stay out of `agentLoop.ts` and shell glue
+ * - one task-scoped dialog shape should drive waiting, replies, and later persistence
+ * - follow-up replies should become explicit runtime facts instead of ad hoc prompt text
+ */
+import { nowIso } from "../evidence/index.js";
+import { resolveAgentTargetClassification } from "../policy/targetClassification.js";
+import { resumeTask } from "../state/index.js";
+function normalizeOptionId(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, "-");
+}
+function looksLikeConcretePath(value) {
+    return value.includes("/") || /\.[A-Za-z0-9_]{1,10}$/.test(value);
+}
+function buildClarificationPrompt(memory) {
+    const classification = resolveAgentTargetClassification(memory);
+    const ambiguous = classification.ambiguousTargets[0];
+    if (ambiguous) {
+        return `Which in-repo file path did you mean for "${ambiguous.target}"?`;
+    }
+    if (memory.task.explicitTargets.length > 0) {
+        return "Reply with the exact in-repo file path or symbol name I should inspect next.";
+    }
+    return "Reply with one concrete file path, folder, symbol name, or a narrower scope so I can continue.";
+}
+export function createAgentClarificationDialog(memory) {
+    const classification = resolveAgentTargetClassification(memory);
+    const ambiguous = classification.ambiguousTargets[0];
+    return {
+        status: "awaiting-user",
+        kind: "clarification",
+        prompt: buildClarificationPrompt(memory),
+        options: ambiguous?.candidates ?? [],
+        target: ambiguous?.target,
+        allowFreeText: true,
+        createdAt: nowIso(),
+    };
+}
+export function buildRequestUserInputMessage(memory, dialog) {
+    const lines = [
+        "I could not answer yet.",
+        "I tried:",
+        ...buildAttemptLines(memory),
+        "",
+        "I need one thing from you:",
+        `- ${dialog.prompt}`,
+    ];
+    if (dialog.options.length > 0) {
+        lines.push(...dialog.options.map((option, index) => `${index + 1}. ${option}`));
+        lines.push(dialog.allowFreeText
+            ? `- Choose [1-${dialog.options.length}] or paste a path.`
+            : `- Choose [1-${dialog.options.length}].`);
+    }
+    return lines.join("\n");
+}
+export function hasAwaitingAgentDialog(memory) {
+    return memory.task.dialogState?.status === "awaiting-user";
+}
+export function prepareAgentWaitingState(memory) {
+    const existing = memory.task.dialogState;
+    if (existing?.status === "awaiting-user") {
+        return existing;
+    }
+    const dialog = createAgentClarificationDialog(memory);
+    memory.task.dialogState = dialog;
+    return dialog;
+}
+function parseAgentDialogReply(dialog, rawResponse) {
+    const response = rawResponse.trim();
+    if (!response) {
+        return { response: "" };
+    }
+    const lines = response
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const firstLine = lines[0] ?? response;
+    const separatorMatch = firstLine.match(/^([^:|-]+)\s*[:|-]\s*(.+)$/);
+    const knownOptions = new Map(dialog.options.map((option) => [normalizeOptionId(option), option]));
+    const numericSelection = firstLine.match(/^(\d+)(?:\s*[:|-]\s*(.+))?$/);
+    if (separatorMatch) {
+        const option = knownOptions.get(normalizeOptionId(separatorMatch[1] ?? ""));
+        if (option) {
+            const tail = [separatorMatch[2], ...lines.slice(1)].filter(Boolean).join(" ").trim();
+            return { response, selectedOption: option, comment: tail || undefined };
+        }
+    }
+    if (numericSelection) {
+        const optionIndex = Number.parseInt(numericSelection[1] ?? "", 10) - 1;
+        const option = dialog.options[optionIndex];
+        if (option) {
+            const tail = [numericSelection[2], ...lines.slice(1)].filter(Boolean).join(" ").trim();
+            return { response, selectedOption: option, comment: tail || undefined };
+        }
+    }
+    const exactOption = knownOptions.get(normalizeOptionId(firstLine));
+    if (exactOption) {
+        const tail = lines.slice(1).join(" ").trim();
+        return { response, selectedOption: exactOption, comment: tail || undefined };
+    }
+    return {
+        response,
+        comment: response,
+    };
+}
+function applyAgentDialogReply(memory, parsed) {
+    if (!memory.task.dialogState) {
+        return;
+    }
+    const chosenValue = parsed.selectedOption ?? parsed.comment?.trim() ?? parsed.response.trim();
+    if (memory.task.dialogState.target && chosenValue && looksLikeConcretePath(chosenValue)) {
+        memory.task.explicitTargetOverrides[memory.task.dialogState.target] = chosenValue;
+    }
+    memory.task.dialogState = {
+        ...memory.task.dialogState,
+        status: "answered",
+        selectedOption: parsed.selectedOption,
+        response: parsed.response,
+        comment: parsed.comment,
+        answeredAt: nowIso(),
+    };
+}
+function buildContinuedTaskQuery(memory, parsed) {
+    const prompt = memory.task.dialogState?.prompt?.trim();
+    const reply = parsed.comment?.trim() || parsed.response.trim();
+    if (!reply) {
+        return memory.task.initialQuery;
+    }
+    return [
+        memory.task.initialQuery,
+        prompt ? `Clarification request: ${prompt}` : null,
+        `User clarification: ${reply}`,
+    ].filter((line) => !!line && line.trim().length > 0).join("\n\n");
+}
+export function continueAgentTaskFromFeedback(memory, rawReply) {
+    if (!hasAwaitingAgentDialog(memory)) {
+        return false;
+    }
+    const dialog = memory.task.dialogState;
+    const parsed = parseAgentDialogReply(dialog, rawReply);
+    if (!parsed.response.trim()) {
+        return false;
+    }
+    applyAgentDialogReply(memory, parsed);
+    memory.evidence.notes.push(`User clarification: ${parsed.comment?.trim() || parsed.response.trim()}`);
+    memory.task.initialQuery = buildContinuedTaskQuery(memory, parsed);
+    memory.task.normalizedQuery = memory.task.initialQuery;
+    resumeTask(memory);
+    return true;
+}
+function buildAttemptLines(memory) {
+    const completedSteps = memory.steps.filter((step) => step.status === "done" || step.status === "failed" || step.status === "blocked");
+    const actionCounts = new Map();
+    for (const step of completedSteps) {
+        if (step.action === "final-answer" || step.action === "cannot-answer" || step.action === "request-user-input") {
+            continue;
+        }
+        actionCounts.set(step.action, (actionCounts.get(step.action) ?? 0) + 1);
+    }
+    const actionLines = Array.from(actionCounts.entries()).map(([action, count]) => {
+        switch (action) {
+            case "plan":
+                return `- replanned ${count} ${count === 1 ? "time" : "times"}`;
+            case "search-db":
+                return `- searched indexed files ${count} ${count === 1 ? "time" : "times"}`;
+            case "search-regex":
+                return `- ran regex search ${count} ${count === 1 ? "time" : "times"}`;
+            case "search-list-directory":
+                return `- listed directories ${count} ${count === 1 ? "time" : "times"}`;
+            case "triage-file":
+                return `- triaged files ${count} ${count === 1 ? "time" : "times"}`;
+            case "read-file":
+                return `- read files ${count} ${count === 1 ? "time" : "times"}`;
+            default:
+                return null;
+        }
+    }).filter((line) => !!line);
+    return [
+        ...actionLines,
+        `- searched ${memory.evidence.searches.length} ${memory.evidence.searches.length === 1 ? "time" : "times"}`,
+        `- read ${Object.keys(memory.evidence.fileReads).length} ${Object.keys(memory.evidence.fileReads).length === 1 ? "file" : "files"}`,
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/feedback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/feedback/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS/C,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAmB;IACnD,MAAM,cAAc,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,6CAA6C,SAAS,CAAC,MAAM,IAAI,CAAC;IAC3E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,8EAA8E,CAAC;IACxF,CAAC;IACD,OAAO,gGAAgG,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAmB;IAChE,MAAM,cAAc,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC;QACxC,OAAO,EAAE,SAAS,EAAE,UAAU,IAAI,EAAE;QACpC,MAAM,EAAE,SAAS,EAAE,MAAM;QACzB,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAmB,EAAE,MAAwB;IACxF,MAAM,KAAK,GAAG;QACZ,yBAAyB;QACzB,UAAU;QACV,GAAG,iBAAiB,CAAC,MAAM,CAAC;QAC5B,EAAE;QACF,4BAA4B;QAC5B,KAAK,MAAM,CAAC,MAAM,EAAE;KACrB,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa;YAC7B,CAAC,CAAC,eAAe,MAAM,CAAC,OAAO,CAAC,MAAM,oBAAoB;YAC1D,CAAC,CAAC,eAAe,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,eAAe,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAmB;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;IACzC,IAAI,QAAQ,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAwB,EAAE,WAAmB;IAC1E,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ;SACnB,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IACvC,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CACpE,CAAC;IACF,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAExE,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACrF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACvF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;IACnE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,QAAQ;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAmB,EAAE,MAA8B;IAChF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9F,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,WAAW,IAAI,qBAAqB,CAAC,WAAW,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;IACpF,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG;QACxB,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW;QAC1B,MAAM,EAAE,UAAU;QAClB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,EAAE;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAmB,EAAE,MAA8B;IAClF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;IAClC,CAAC;IACD,OAAO;QACL,MAAM,CAAC,IAAI,CAAC,YAAY;QACxB,MAAM,CAAC,CAAC,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;QAClD,uBAAuB,KAAK,EAAE;KAC/B,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAmB,EAAE,QAAgB;IACjF,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAY,CAAC;IACxC,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtG,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;IACvD,UAAU,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACtI,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;YAC9G,SAAS;QACX,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE;QAC7E,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,eAAe,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAClE,KAAK,WAAW;gBACd,OAAO,4BAA4B,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/E,KAAK,cAAc;gBACjB,OAAO,sBAAsB,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACzE,KAAK,uBAAuB;gBAC1B,OAAO,wBAAwB,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC3E,KAAK,aAAa;gBAChB,OAAO,mBAAmB,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACtE,KAAK,WAAW;gBACd,OAAO,gBAAgB,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACnE;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO;QACL,GAAG,WAAW;QACd,cAAc,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;QAC3G,UAAU,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;KACpI,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Owns simple-agent waiting state and follow-up reply handling.\n *\n * Why this file exists:\n * - feedback should stay out of `agentLoop.ts` and shell glue\n * - one task-scoped dialog shape should drive waiting, replies, and later persistence\n * - follow-up replies should become explicit runtime facts instead of ad hoc prompt text\n */\nimport { nowIso } from \"../evidence/index.js\";\nimport { resolveAgentTargetClassification } from \"../policy/targetClassification.js\";\nimport { resumeTask } from \"../state/index.js\";\nimport type { AgentDialogState, AgentMemory } from \"../types.js\";\n\ninterface ParsedAgentDialogReply {\n  response: string;\n  selectedOption?: string;\n  comment?: string;\n}\n\nfunction normalizeOptionId(value: string): string {\n  return value.trim().toLowerCase().replace(/\\s+/g, \"-\");\n}\n\nfunction looksLikeConcretePath(value: string): boolean {\n  return value.includes(\"/\") || /\\.[A-Za-z0-9_]{1,10}$/.test(value);\n}\n\nfunction buildClarificationPrompt(memory: AgentMemory): string {\n  const classification = resolveAgentTargetClassification(memory);\n  const ambiguous = classification.ambiguousTargets[0];\n  if (ambiguous) {\n    return `Which in-repo file path did you mean for \"${ambiguous.target}\"?`;\n  }\n  if (memory.task.explicitTargets.length > 0) {\n    return \"Reply with the exact in-repo file path or symbol name I should inspect next.\";\n  }\n  return \"Reply with one concrete file path, folder, symbol name, or a narrower scope so I can continue.\";\n}\n\nexport function createAgentClarificationDialog(memory: AgentMemory): AgentDialogState {\n  const classification = resolveAgentTargetClassification(memory);\n  const ambiguous = classification.ambiguousTargets[0];\n  return {\n    status: \"awaiting-user\",\n    kind: \"clarification\",\n    prompt: buildClarificationPrompt(memory),\n    options: ambiguous?.candidates ?? [],\n    target: ambiguous?.target,\n    allowFreeText: true,\n    createdAt: nowIso(),\n  };\n}\n\nexport function buildRequestUserInputMessage(memory: AgentMemory, dialog: AgentDialogState): string {\n  const lines = [\n    \"I could not answer yet.\",\n    \"I tried:\",\n    ...buildAttemptLines(memory),\n    \"\",\n    \"I need one thing from you:\",\n    `- ${dialog.prompt}`,\n  ];\n\n  if (dialog.options.length > 0) {\n    lines.push(...dialog.options.map((option, index) => `${index + 1}. ${option}`));\n    lines.push(dialog.allowFreeText\n      ? `- Choose [1-${dialog.options.length}] or paste a path.`\n      : `- Choose [1-${dialog.options.length}].`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nexport function hasAwaitingAgentDialog(memory: AgentMemory): boolean {\n  return memory.task.dialogState?.status === \"awaiting-user\";\n}\n\nexport function prepareAgentWaitingState(memory: AgentMemory): AgentDialogState {\n  const existing = memory.task.dialogState;\n  if (existing?.status === \"awaiting-user\") {\n    return existing;\n  }\n  const dialog = createAgentClarificationDialog(memory);\n  memory.task.dialogState = dialog;\n  return dialog;\n}\n\nfunction parseAgentDialogReply(dialog: AgentDialogState, rawResponse: string): ParsedAgentDialogReply {\n  const response = rawResponse.trim();\n  if (!response) {\n    return { response: \"\" };\n  }\n\n  const lines = response\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter(Boolean);\n  const firstLine = lines[0] ?? response;\n  const separatorMatch = firstLine.match(/^([^:|-]+)\\s*[:|-]\\s*(.+)$/);\n  const knownOptions = new Map(\n    dialog.options.map((option) => [normalizeOptionId(option), option])\n  );\n  const numericSelection = firstLine.match(/^(\\d+)(?:\\s*[:|-]\\s*(.+))?$/);\n\n  if (separatorMatch) {\n    const option = knownOptions.get(normalizeOptionId(separatorMatch[1] ?? \"\"));\n    if (option) {\n      const tail = [separatorMatch[2], ...lines.slice(1)].filter(Boolean).join(\" \").trim();\n      return { response, selectedOption: option, comment: tail || undefined };\n    }\n  }\n\n  if (numericSelection) {\n    const optionIndex = Number.parseInt(numericSelection[1] ?? \"\", 10) - 1;\n    const option = dialog.options[optionIndex];\n    if (option) {\n      const tail = [numericSelection[2], ...lines.slice(1)].filter(Boolean).join(\" \").trim();\n      return { response, selectedOption: option, comment: tail || undefined };\n    }\n  }\n\n  const exactOption = knownOptions.get(normalizeOptionId(firstLine));\n  if (exactOption) {\n    const tail = lines.slice(1).join(\" \").trim();\n    return { response, selectedOption: exactOption, comment: tail || undefined };\n  }\n\n  return {\n    response,\n    comment: response,\n  };\n}\n\nfunction applyAgentDialogReply(memory: AgentMemory, parsed: ParsedAgentDialogReply): void {\n  if (!memory.task.dialogState) {\n    return;\n  }\n  const chosenValue = parsed.selectedOption ?? parsed.comment?.trim() ?? parsed.response.trim();\n  if (memory.task.dialogState.target && chosenValue && looksLikeConcretePath(chosenValue)) {\n    memory.task.explicitTargetOverrides[memory.task.dialogState.target] = chosenValue;\n  }\n  memory.task.dialogState = {\n    ...memory.task.dialogState,\n    status: \"answered\",\n    selectedOption: parsed.selectedOption,\n    response: parsed.response,\n    comment: parsed.comment,\n    answeredAt: nowIso(),\n  };\n}\n\nfunction buildContinuedTaskQuery(memory: AgentMemory, parsed: ParsedAgentDialogReply): string {\n  const prompt = memory.task.dialogState?.prompt?.trim();\n  const reply = parsed.comment?.trim() || parsed.response.trim();\n  if (!reply) {\n    return memory.task.initialQuery;\n  }\n  return [\n    memory.task.initialQuery,\n    prompt ? `Clarification request: ${prompt}` : null,\n    `User clarification: ${reply}`,\n  ].filter((line): line is string => !!line && line.trim().length > 0).join(\"\\n\\n\");\n}\n\nexport function continueAgentTaskFromFeedback(memory: AgentMemory, rawReply: string): boolean {\n  if (!hasAwaitingAgentDialog(memory)) {\n    return false;\n  }\n  const dialog = memory.task.dialogState!;\n  const parsed = parseAgentDialogReply(dialog, rawReply);\n  if (!parsed.response.trim()) {\n    return false;\n  }\n\n  applyAgentDialogReply(memory, parsed);\n  memory.evidence.notes.push(`User clarification: ${parsed.comment?.trim() || parsed.response.trim()}`);\n  memory.task.initialQuery = buildContinuedTaskQuery(memory, parsed);\n  memory.task.normalizedQuery = memory.task.initialQuery;\n  resumeTask(memory);\n  return true;\n}\n\nfunction buildAttemptLines(memory: AgentMemory): string[] {\n  const completedSteps = memory.steps.filter((step) => step.status === \"done\" || step.status === \"failed\" || step.status === \"blocked\");\n  const actionCounts = new Map<string, number>();\n  for (const step of completedSteps) {\n    if (step.action === \"final-answer\" || step.action === \"cannot-answer\" || step.action === \"request-user-input\") {\n      continue;\n    }\n    actionCounts.set(step.action, (actionCounts.get(step.action) ?? 0) + 1);\n  }\n\n  const actionLines = Array.from(actionCounts.entries()).map(([action, count]) => {\n    switch (action) {\n      case \"plan\":\n        return `- replanned ${count} ${count === 1 ? \"time\" : \"times\"}`;\n      case \"search-db\":\n        return `- searched indexed files ${count} ${count === 1 ? \"time\" : \"times\"}`;\n      case \"search-regex\":\n        return `- ran regex search ${count} ${count === 1 ? \"time\" : \"times\"}`;\n      case \"search-list-directory\":\n        return `- listed directories ${count} ${count === 1 ? \"time\" : \"times\"}`;\n      case \"triage-file\":\n        return `- triaged files ${count} ${count === 1 ? \"time\" : \"times\"}`;\n      case \"read-file\":\n        return `- read files ${count} ${count === 1 ? \"time\" : \"times\"}`;\n      default:\n        return null;\n    }\n  }).filter((line): line is string => !!line);\n\n  return [\n    ...actionLines,\n    `- searched ${memory.evidence.searches.length} ${memory.evidence.searches.length === 1 ? \"time\" : \"times\"}`,\n    `- read ${Object.keys(memory.evidence.fileReads).length} ${Object.keys(memory.evidence.fileReads).length === 1 ? \"file\" : \"files\"}`,\n  ];\n}\n"]}

package/dist/agent/finalization/index.js

@@ -0,0 +1,35 @@
+import { resolvePolicyState } from "../policy/index.js";
+import { finalizeTask, setWaitingTask } from "../state/index.js";
+export function resolveForcedEndDecision(memory) {
+    const decision = resolvePolicyState(memory, { forcedEnd: true }).endDecision;
+    if (!decision) {
+        return {
+            kind: "finalize",
+            taskStatus: "blocked",
+            stopReason: "missing-end-decision",
+        };
+    }
+    return {
+        kind: "run-action",
+        action: decision.action,
+        taskStatus: decision.taskStatus,
+        stopReason: decision.stopReason,
+        purpose: decision.purpose,
+        expectedEvidence: decision.expectedEvidence,
+    };
+}
+export function applyFinalTaskStatus(memory, result, decision) {
+    if (decision.kind !== "run-action") {
+        throw new Error("applyFinalTaskStatus only supports run-action decisions.");
+    }
+    const policy = resolvePolicyState(memory);
+    const finalStatus = decision.action === "final-answer"
+        ? ((result.ok || policy.hasGroundedEvidence) ? "done" : decision.taskStatus)
+        : decision.taskStatus;
+    if (finalStatus === "waiting") {
+        setWaitingTask(memory, decision.stopReason);
+        return;
+    }
+    finalizeTask(memory, finalStatus, finalStatus === "done" ? "completed" : decision.stopReason);
+}
+//# sourceMappingURL=index.js.map