scai 0.1.178 → 1.0.0

package/dist/agent/search/shell.js

@@ -0,0 +1,202 @@
+/**
+ * Runs shell-backed fixed-string content search for broad repo questions.
+ *
+ * Why this file exists:
+ * - broad "where is X set?" asks benefit from literal content search before semantic retrieval
+ * - grep-style execution should have one owner in the new agent search area
+ * - `rg` is preferred, but the lane must still work with an in-process fallback
+ * - shell search should retrieve a broad frontier, not own final candidate ordering
+ */
+import { execFileSync } from "child_process";
+import { collectFixedStringMatches, collectSearchablePaths, dedupeStrings, tokenizeSearchTerms } from "./shared.js";
+const GENERIC_TERMS = new Set(["agent", "code", "config", "file", "files", "repo", "runtime"]);
+const SECONDARY_TERMS = new Set(["point", "points", "configured", "configure", "configuration"]);
+const OWNER_SIGNAL_TERMS = new Set(["command", "count", "entry", "limit", "loop", "max", "register", "test", "tests", "threshold", "turn"]);
+function deriveShellTerms(query) {
+    const rawTerms = tokenizeSearchTerms(query).flatMap((term) => {
+        const normalized = term.endsWith("s") && term.length > 4 ? term.slice(0, -1) : term;
+        return normalized !== term ? [normalized, term] : [term];
+    });
+    const preferredTerms = rawTerms.filter((term) => !GENERIC_TERMS.has(term));
+    const strongTerms = preferredTerms.filter((term) => !SECONDARY_TERMS.has(term));
+    const secondaryTerms = preferredTerms.filter((term) => SECONDARY_TERMS.has(term));
+    const ordered = strongTerms.length > 0
+        ? [...strongTerms, ...secondaryTerms, ...rawTerms]
+        : preferredTerms.length > 0
+            ? [...preferredTerms, ...rawTerms]
+            : rawTerms;
+    return dedupeStrings(ordered).slice(0, 10);
+}
+function clampSnippet(snippet) {
+    return snippet.trim().slice(0, 220);
+}
+function dedupeMatches(matches) {
+    const seen = new Set();
+    const out = [];
+    for (const match of matches) {
+        const key = [match.filePath, match.line ?? "", match.column ?? "", match.snippet, match.matchKind].join("|");
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        out.push(match);
+    }
+    return out;
+}
+function buildShellFrontier(matches, limit) {
+    const maxFiles = Math.max(limit * 6, 24);
+    const filePaths = [];
+    const seen = new Set();
+    for (const match of matches) {
+        if (seen.has(match.filePath)) {
+            continue;
+        }
+        seen.add(match.filePath);
+        filePaths.push(match.filePath);
+        if (filePaths.length >= maxFiles) {
+            break;
+        }
+    }
+    return filePaths;
+}
+function extractMatchedTerms(matches) {
+    return dedupeStrings(matches
+        .flatMap((match) => match.reasons ?? [])
+        .map((reason) => reason.match(/^term:(.+)$/i)?.[1]?.toLowerCase())
+        .filter((term) => Boolean(term)));
+}
+function isGenericShellTerm(term) {
+    return GENERIC_TERMS.has(term) || SECONDARY_TERMS.has(term);
+}
+function resolveShellWeakReason(matches, filePaths) {
+    if (filePaths.length === 0) {
+        return "no-match";
+    }
+    const matchedTerms = extractMatchedTerms(matches);
+    if (matchedTerms.length === 0) {
+        return "no-term-confirmation";
+    }
+    const strongMatchedTerms = matchedTerms.filter((term) => !isGenericShellTerm(term));
+    if (strongMatchedTerms.length === 0) {
+        const ownerSignalTerms = matchedTerms.filter((term) => OWNER_SIGNAL_TERMS.has(term));
+        return ownerSignalTerms.length >= 2 ? undefined : "generic-terms-only";
+    }
+    return undefined;
+}
+function collectShellMatchesWithRg(rootDir, terms, limit) {
+    const matches = [];
+    for (const term of terms) {
+        const maxPerTerm = Math.max(limit * 2, 8);
+        const maxTotal = Math.max(limit * 10, 40);
+        let output = "";
+        try {
+            output = execFileSync("rg", [
+                "--line-number",
+                "--column",
+                "--no-heading",
+                "--color",
+                "never",
+                "--ignore-case",
+                "--fixed-strings",
+                "--glob",
+                "!node_modules",
+                "--glob",
+                "!.git",
+                term,
+                rootDir,
+            ], {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes("spawnSync rg ENOENT")) {
+                throw error;
+            }
+            output = typeof error.stdout === "string"
+                ? error.stdout ?? ""
+                : "";
+        }
+        let addedForTerm = 0;
+        for (const line of output.split(/\r?\n/)) {
+            if (!line.trim() || addedForTerm >= maxPerTerm || matches.length >= maxTotal)
+                continue;
+            const parts = line.match(/^(.+?):(\d+):(\d+):(.*)$/);
+            if (!parts)
+                continue;
+            matches.push({
+                filePath: parts[1],
+                line: Number(parts[2]),
+                column: Number(parts[3]),
+                snippet: clampSnippet(parts[4]),
+                matchKind: "shell-content",
+                score: term.length,
+                reasons: [`term:${term}`],
+            });
+            addedForTerm += 1;
+        }
+    }
+    return dedupeMatches(matches);
+}
+function collectShellMatches(rootDir, terms, limit) {
+    try {
+        return collectShellMatchesWithRg(rootDir, terms, limit);
+    }
+    catch {
+        const files = collectSearchablePaths(rootDir);
+        return collectFixedStringMatches(files, terms, "shell-content", {
+            caseSensitive: false,
+            maxPerFile: 2,
+            maxTotal: Math.max(limit * 10, 40),
+        });
+    }
+}
+export function shouldFallbackFromShell(packet) {
+    if (packet.lane !== "shell-content") {
+        return false;
+    }
+    return packet.failure?.failureClass === "no-match" || packet.debug?.recoveryReason === "weak-shell-results";
+}
+export function runShellSearch(rootDir, query, limit = 5) {
+    const terms = deriveShellTerms(query);
+    if (terms.length === 0) {
+        return {
+            lane: "shell-content",
+            query,
+            filePaths: [],
+            failure: {
+                status: "failed",
+                failureClass: "no-match",
+                message: "Shell content search could not derive any useful search terms.",
+            },
+        };
+    }
+    const matches = collectShellMatches(rootDir, terms, limit);
+    const filePaths = buildShellFrontier(matches, limit);
+    const weakReason = resolveShellWeakReason(matches, filePaths);
+    return {
+        lane: "shell-content",
+        query,
+        filePaths,
+        matches,
+        debug: {
+            matchTerms: terms,
+            ...(weakReason ? { recoveryReason: "weak-shell-results" } : {}),
+        },
+        ...(filePaths.length === 0 ? {
+            failure: {
+                status: "failed",
+                failureClass: "no-match",
+                message: "Shell content search found no matches in scope.",
+            },
+        } : weakReason ? {
+            failure: {
+                status: "failed",
+                failureClass: "too-broad",
+                message: `Shell content search found only weak matches: ${weakReason}.`,
+            },
+        } : {}),
+    };
+}
+//# sourceMappingURL=shell.js.map

package/dist/agent/search/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/agent/search/shell.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs shell-backed fixed-string content search for broad repo questions.\n *\n * Why this file exists:\n * - broad \"where is X set?\" asks benefit from literal content search before semantic retrieval\n * - grep-style execution should have one owner in the new agent search area\n * - `rg` is preferred, but the lane must still work with an in-process fallback\n * - shell search should retrieve a broad frontier, not own final candidate ordering\n */\nimport { execFileSync } from \"child_process\";\nimport type { AgentSearchMatch } from \"../types.js\";\nimport type { AgentSearchPacket } from \"./types.js\";\nimport { collectFixedStringMatches, collectSearchablePaths, dedupeStrings, tokenizeSearchTerms } from \"./shared.js\";\n\nconst GENERIC_TERMS = new Set([\"agent\", \"code\", \"config\", \"file\", \"files\", \"repo\", \"runtime\"]);\nconst SECONDARY_TERMS = new Set([\"point\", \"points\", \"configured\", \"configure\", \"configuration\"]);\nconst OWNER_SIGNAL_TERMS = new Set([\"command\", \"count\", \"entry\", \"limit\", \"loop\", \"max\", \"register\", \"test\", \"tests\", \"threshold\", \"turn\"]);\n\nfunction deriveShellTerms(query: string): string[] {\n  const rawTerms = tokenizeSearchTerms(query).flatMap((term) => {\n    const normalized = term.endsWith(\"s\") && term.length > 4 ? term.slice(0, -1) : term;\n    return normalized !== term ? [normalized, term] : [term];\n  });\n  const preferredTerms = rawTerms.filter((term) => !GENERIC_TERMS.has(term));\n  const strongTerms = preferredTerms.filter((term) => !SECONDARY_TERMS.has(term));\n  const secondaryTerms = preferredTerms.filter((term) => SECONDARY_TERMS.has(term));\n  const ordered = strongTerms.length > 0\n    ? [...strongTerms, ...secondaryTerms, ...rawTerms]\n    : preferredTerms.length > 0\n      ? [...preferredTerms, ...rawTerms]\n      : rawTerms;\n  return dedupeStrings(ordered).slice(0, 10);\n}\n\nfunction clampSnippet(snippet: string): string {\n  return snippet.trim().slice(0, 220);\n}\n\nfunction dedupeMatches(matches: AgentSearchMatch[]): AgentSearchMatch[] {\n  const seen = new Set<string>();\n  const out: AgentSearchMatch[] = [];\n  for (const match of matches) {\n    const key = [match.filePath, match.line ?? \"\", match.column ?? \"\", match.snippet, match.matchKind].join(\"|\");\n    if (seen.has(key)) {\n      continue;\n    }\n    seen.add(key);\n    out.push(match);\n  }\n  return out;\n}\n\nfunction buildShellFrontier(matches: AgentSearchMatch[], limit: number): string[] {\n  const maxFiles = Math.max(limit * 6, 24);\n  const filePaths: string[] = [];\n  const seen = new Set<string>();\n  for (const match of matches) {\n    if (seen.has(match.filePath)) {\n      continue;\n    }\n    seen.add(match.filePath);\n    filePaths.push(match.filePath);\n    if (filePaths.length >= maxFiles) {\n      break;\n    }\n  }\n  return filePaths;\n}\n\nfunction extractMatchedTerms(matches: AgentSearchMatch[]): string[] {\n  return dedupeStrings(\n    matches\n      .flatMap((match) => match.reasons ?? [])\n      .map((reason) => reason.match(/^term:(.+)$/i)?.[1]?.toLowerCase())\n      .filter((term): term is string => Boolean(term))\n  );\n}\n\nfunction isGenericShellTerm(term: string): boolean {\n  return GENERIC_TERMS.has(term) || SECONDARY_TERMS.has(term);\n}\n\nfunction resolveShellWeakReason(matches: AgentSearchMatch[], filePaths: string[]): string | undefined {\n  if (filePaths.length === 0) {\n    return \"no-match\";\n  }\n\n  const matchedTerms = extractMatchedTerms(matches);\n  if (matchedTerms.length === 0) {\n    return \"no-term-confirmation\";\n  }\n\n  const strongMatchedTerms = matchedTerms.filter((term) => !isGenericShellTerm(term));\n  if (strongMatchedTerms.length === 0) {\n    const ownerSignalTerms = matchedTerms.filter((term) => OWNER_SIGNAL_TERMS.has(term));\n    return ownerSignalTerms.length >= 2 ? undefined : \"generic-terms-only\";\n  }\n  return undefined;\n}\n\nfunction collectShellMatchesWithRg(rootDir: string, terms: string[], limit: number): AgentSearchMatch[] {\n  const matches: AgentSearchMatch[] = [];\n  for (const term of terms) {\n    const maxPerTerm = Math.max(limit * 2, 8);\n    const maxTotal = Math.max(limit * 10, 40);\n    let output = \"\";\n    try {\n      output = execFileSync(\"rg\", [\n        \"--line-number\",\n        \"--column\",\n        \"--no-heading\",\n        \"--color\",\n        \"never\",\n        \"--ignore-case\",\n        \"--fixed-strings\",\n        \"--glob\",\n        \"!node_modules\",\n        \"--glob\",\n        \"!.git\",\n        term,\n        rootDir,\n      ], {\n        encoding: \"utf8\",\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      if (message.includes(\"spawnSync rg ENOENT\")) {\n        throw error;\n      }\n      output = typeof (error as { stdout?: string }).stdout === \"string\"\n        ? (error as { stdout?: string }).stdout ?? \"\"\n        : \"\";\n    }\n\n    let addedForTerm = 0;\n    for (const line of output.split(/\\r?\\n/)) {\n      if (!line.trim() || addedForTerm >= maxPerTerm || matches.length >= maxTotal) continue;\n      const parts = line.match(/^(.+?):(\\d+):(\\d+):(.*)$/);\n      if (!parts) continue;\n      matches.push({\n        filePath: parts[1],\n        line: Number(parts[2]),\n        column: Number(parts[3]),\n        snippet: clampSnippet(parts[4]),\n        matchKind: \"shell-content\",\n        score: term.length,\n        reasons: [`term:${term}`],\n      });\n      addedForTerm += 1;\n    }\n  }\n  return dedupeMatches(matches);\n}\n\nfunction collectShellMatches(rootDir: string, terms: string[], limit: number): AgentSearchMatch[] {\n  try {\n    return collectShellMatchesWithRg(rootDir, terms, limit);\n  } catch {\n    const files = collectSearchablePaths(rootDir);\n    return collectFixedStringMatches(files, terms, \"shell-content\", {\n      caseSensitive: false,\n      maxPerFile: 2,\n      maxTotal: Math.max(limit * 10, 40),\n    });\n  }\n}\n\nexport function shouldFallbackFromShell(packet: AgentSearchPacket): boolean {\n  if (packet.lane !== \"shell-content\") {\n    return false;\n  }\n  return packet.failure?.failureClass === \"no-match\" || packet.debug?.recoveryReason === \"weak-shell-results\";\n}\n\nexport function runShellSearch(rootDir: string, query: string, limit = 5): AgentSearchPacket {\n  const terms = deriveShellTerms(query);\n  if (terms.length === 0) {\n    return {\n      lane: \"shell-content\",\n      query,\n      filePaths: [],\n      failure: {\n        status: \"failed\",\n        failureClass: \"no-match\",\n        message: \"Shell content search could not derive any useful search terms.\",\n      },\n    };\n  }\n\n  const matches = collectShellMatches(rootDir, terms, limit);\n  const filePaths = buildShellFrontier(matches, limit);\n  const weakReason = resolveShellWeakReason(matches, filePaths);\n  return {\n    lane: \"shell-content\",\n    query,\n    filePaths,\n    matches,\n    debug: {\n      matchTerms: terms,\n      ...(weakReason ? { recoveryReason: \"weak-shell-results\" } : {}),\n    },\n    ...(filePaths.length === 0 ? {\n      failure: {\n        status: \"failed\" as const,\n        failureClass: \"no-match\" as const,\n        message: \"Shell content search found no matches in scope.\",\n      },\n    } : weakReason ? {\n      failure: {\n        status: \"failed\" as const,\n        failureClass: \"too-broad\" as const,\n        message: `Shell content search found only weak matches: ${weakReason}.`,\n      },\n    } : {}),\n  };\n}\n"]}

package/dist/agent/search/snippetEvidence.js

@@ -0,0 +1,57 @@
+/**
+ * Labels one snippet by structural value.
+ * Example: `import { Foo } from "./x"` -> `reference-signal`.
+ */
+export function classifySnippetEvidence(snippet, matchKind) {
+    const trimmed = String(snippet ?? "").trim();
+    if (!trimmed) {
+        return "noise";
+    }
+    // Example: `query: "\"Find foo\""` or `"Explain foo",`
+    if (/\b(?:query|userQuery|prompt|input|expected|fixture)\s*:/.test(trimmed)) {
+        return "noise";
+    }
+    if (/^["'`][^"'`]+["'`],?$/.test(trimmed)) {
+        return "noise";
+    }
+    if (/^import\s+(?:type\s+)?[\s\S]+?\s+from\s+["'][^"']+["'];?$/.test(trimmed) ||
+        /^export\s+\*\s+from\s+["'][^"']+["'];?$/.test(trimmed) ||
+        /^export\s+\{[\s\S]+?\}\s+from\s+["'][^"']+["'];?$/.test(trimmed) ||
+        /^const\s+[A-Za-z0-9_$]+\s*=\s*require\(\s*["'][^"']+["']\s*\);?$/.test(trimmed)) {
+        return "reference-signal";
+    }
+    // Example: `type AgentActions = Record<...>;`
+    if (/^(?:export\s+)?type\s+[A-Za-z0-9_$]+\s*=/.test(trimmed)) {
+        return "reference-signal";
+    }
+    if (/\.(?:command|action)\s*\(/.test(trimmed) ||
+        /\b(?:export\s+)?(?:async\s+)?function\b/.test(trimmed) ||
+        /\bclass\s+[A-Za-z0-9_$]+/.test(trimmed) ||
+        /\b(?:if|switch|return)\b/.test(trimmed) ||
+        /\bprocess\.env\b/.test(trimmed) ||
+        /\b(?:export\s+)?(?:const|let|var)\s+[A-Za-z0-9_$]+\s*=/.test(trimmed) ||
+        /^[A-Za-z0-9_$"'`.-]+\s*:\s*(?:["'`[{]|true\b|false\b|null\b|\d)/.test(trimmed)) {
+        return "answer-evidence";
+    }
+    if (matchKind === "path-match") {
+        return "reference-signal";
+    }
+    return "answer-evidence";
+}
+/**
+ * Keeps answer-evidence by default and allows one weak fallback per file.
+ * Example: a file with only `export * from "./x"` may keep one fallback snippet.
+ */
+export function shouldKeepSnippetInMatches(kind, state) {
+    if (kind === "noise") {
+        return false;
+    }
+    if (kind === "answer-evidence") {
+        return state.keptAnswerCount < state.maxPerFile;
+    }
+    if (state.hasAnswerEvidence) {
+        return false;
+    }
+    return state.keptReferenceCount < 1;
+}
+//# sourceMappingURL=snippetEvidence.js.map

package/dist/agent/search/snippetEvidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippetEvidence.js","sourceRoot":"","sources":["../../../src/agent/search/snippetEvidence.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,SAA+B;IAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uDAAuD;IACvD,IAAI,yDAAyD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IACE,2DAA2D,CAAC,IAAI,CAAC,OAAO,CAAC;QACzE,yCAAyC,CAAC,IAAI,CAAC,OAAO,CAAC;QACvD,mDAAmD,CAAC,IAAI,CAAC,OAAO,CAAC;QACjE,kEAAkE,CAAC,IAAI,CAAC,OAAO,CAAC,EAChF,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,8CAA8C;IAC9C,IAAI,0CAA0C,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IACE,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,yCAAyC,CAAC,IAAI,CAAC,OAAO,CAAC;QACvD,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC;QACxC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC;QACxC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,wDAAwD,CAAC,IAAI,CAAC,OAAO,CAAC;QACtE,iEAAiE,CAAC,IAAI,CAAC,OAAO,CAAC,EAC/E,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAA8B,EAC9B,KAAiC;IAEjC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,UAAU,CAAC;IAClD,CAAC;IAED,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAC;AACtC,CAAC","sourcesContent":["/**\n * Classifies search snippets by how useful they are as answer evidence.\n *\n * Why this file exists:\n * - shared match extraction should decide snippet quality in one place\n * - imports and re-exports are still useful as follow-up hints, but weak as answer proof\n * - query echoes and fixture text should not show up as primary search evidence\n */\nimport type { AgentSearchMatchKind } from \"../types.js\";\n\nexport type AgentSnippetEvidenceKind = \"answer-evidence\" | \"reference-signal\" | \"noise\";\n\nexport type SnippetMatchSelectionState = {\n  maxPerFile: number;\n  hasAnswerEvidence: boolean;\n  keptAnswerCount: number;\n  keptReferenceCount: number;\n};\n\n/**\n * Labels one snippet by structural value.\n * Example: `import { Foo } from \"./x\"` -> `reference-signal`.\n */\nexport function classifySnippetEvidence(\n  snippet: string,\n  matchKind: AgentSearchMatchKind\n): AgentSnippetEvidenceKind {\n  const trimmed = String(snippet ?? \"\").trim();\n  if (!trimmed) {\n    return \"noise\";\n  }\n\n  // Example: `query: \"\\\"Find foo\\\"\"` or `\"Explain foo\",`\n  if (/\\b(?:query|userQuery|prompt|input|expected|fixture)\\s*:/.test(trimmed)) {\n    return \"noise\";\n  }\n\n  if (/^[\"'`][^\"'`]+[\"'`],?$/.test(trimmed)) {\n    return \"noise\";\n  }\n\n  if (\n    /^import\\s+(?:type\\s+)?[\\s\\S]+?\\s+from\\s+[\"'][^\"']+[\"'];?$/.test(trimmed) ||\n    /^export\\s+\\*\\s+from\\s+[\"'][^\"']+[\"'];?$/.test(trimmed) ||\n    /^export\\s+\\{[\\s\\S]+?\\}\\s+from\\s+[\"'][^\"']+[\"'];?$/.test(trimmed) ||\n    /^const\\s+[A-Za-z0-9_$]+\\s*=\\s*require\\(\\s*[\"'][^\"']+[\"']\\s*\\);?$/.test(trimmed)\n  ) {\n    return \"reference-signal\";\n  }\n\n  // Example: `type AgentActions = Record<...>;`\n  if (/^(?:export\\s+)?type\\s+[A-Za-z0-9_$]+\\s*=/.test(trimmed)) {\n    return \"reference-signal\";\n  }\n\n  if (\n    /\\.(?:command|action)\\s*\\(/.test(trimmed) ||\n    /\\b(?:export\\s+)?(?:async\\s+)?function\\b/.test(trimmed) ||\n    /\\bclass\\s+[A-Za-z0-9_$]+/.test(trimmed) ||\n    /\\b(?:if|switch|return)\\b/.test(trimmed) ||\n    /\\bprocess\\.env\\b/.test(trimmed) ||\n    /\\b(?:export\\s+)?(?:const|let|var)\\s+[A-Za-z0-9_$]+\\s*=/.test(trimmed) ||\n    /^[A-Za-z0-9_$\"'`.-]+\\s*:\\s*(?:[\"'`[{]|true\\b|false\\b|null\\b|\\d)/.test(trimmed)\n  ) {\n    return \"answer-evidence\";\n  }\n\n  if (matchKind === \"path-match\") {\n    return \"reference-signal\";\n  }\n\n  return \"answer-evidence\";\n}\n\n/**\n * Keeps answer-evidence by default and allows one weak fallback per file.\n * Example: a file with only `export * from \"./x\"` may keep one fallback snippet.\n */\nexport function shouldKeepSnippetInMatches(\n  kind: AgentSnippetEvidenceKind,\n  state: SnippetMatchSelectionState\n): boolean {\n  if (kind === \"noise\") {\n    return false;\n  }\n\n  if (kind === \"answer-evidence\") {\n    return state.keptAnswerCount < state.maxPerFile;\n  }\n\n  if (state.hasAnswerEvidence) {\n    return false;\n  }\n\n  return state.keptReferenceCount < 1;\n}\n"]}

package/dist/agent/search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/search/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Defines small public search packet types for the modular agent runtime.\n */\nimport type { AgentSearchMatch } from \"../types.js\";\n\nexport type AgentSearchLane = \"exact-target\" | \"semantic\" | \"regex\" | \"directory\" | \"fragment\" | \"shell-content\";\n\nexport interface AgentLaneDecision {\n  lane: AgentSearchLane;\n  reason: string;\n  resolvedTarget?: string;\n}\n\nexport type AgentSearchFailureClass =\n  | \"no-match\"\n  | \"too-broad\"\n  | \"ambiguous\"\n  | \"invalid-regex\"\n  | \"scope-missing\"\n  | \"executor-error\";\n\nexport interface AgentSearchFailure {\n  status: \"failed\";\n  failureClass: AgentSearchFailureClass;\n  message: string;\n  pattern?: string;\n  flags?: string;\n}\n\nexport interface AgentDirectoryEntry {\n  name: string;\n  kind: \"file\" | \"folder\";\n}\n\nexport interface AgentSearchPacket {\n  lane: AgentSearchLane;\n  query: string;\n  filePaths: string[];\n  relatedFileScores?: Record<string, number>;\n  topHits?: Array<{\n    filePath: string;\n    score: number;\n    bm25Raw?: number;\n    reasons: string[];\n  }>;\n  matches?: AgentSearchMatch[];\n  directoryPath?: string;\n  directoryEntries?: AgentDirectoryEntry[];\n  summary?: string;\n  matchCount?: number;\n  failure?: AgentSearchFailure;\n  debug?: {\n    queriesRun?: string[];\n    recoveryUsed?: boolean;\n    recoveryReason?: string;\n    matchTerms?: string[];\n    batchDebug?: Array<{\n      query: string;\n      source: \"base-query\" | \"search-term-group\";\n      termGroupIndex?: number;\n      kind?: \"repo-anchor\" | \"command-path\" | \"generic\";\n      terms?: string[];\n      continued: boolean;\n      strongEnough: boolean;\n      strongReason?: string;\n    }>;\n  };\n}\n"]}

package/dist/agent/state/index.js

@@ -0,0 +1,99 @@
+/**
+ * Applies explicit task and step state transitions for the new simple agent.
+ *
+ * Why this file exists:
+ * - status changes should not be open-coded across the loop
+ * - invalid transitions should fail fast in tests and during development
+ * - the first runtime slice only needs a small validated state helper
+ * - runtime-created steps should come from one shared helper
+ */
+import { nowIso } from "../evidence/index.js";
+const ALLOWED_STEP_TRANSITIONS = {
+    pending: ["running", "skipped", "blocked"],
+    running: ["done", "failed", "blocked"],
+    done: [],
+    failed: [],
+    blocked: [],
+    skipped: [],
+};
+const ALLOWED_TASK_TRANSITIONS = {
+    active: ["waiting", "done", "blocked", "failed"],
+    waiting: ["active", "blocked", "failed", "done"],
+    done: [],
+    blocked: [],
+    failed: [],
+};
+function assertStepTransition(from, to) {
+    if (!ALLOWED_STEP_TRANSITIONS[from].includes(to)) {
+        throw new Error(`Invalid agent step transition: ${from} -> ${to}`);
+    }
+}
+function assertTaskTransition(from, to) {
+    if (!ALLOWED_TASK_TRANSITIONS[from].includes(to)) {
+        throw new Error(`Invalid agent task transition: ${from} -> ${to}`);
+    }
+}
+function createStepId(memory) {
+    return `step-${String(memory.steps.length + 1).padStart(3, "0")}`;
+}
+/**
+ * Creates one pending runtime step in a shared way.
+ * Example: a chosen `read-file` action becomes one explicit `pending` step.
+ */
+export function createRuntimeStep(memory, action, purpose, args = {}, expectedEvidence = []) {
+    const step = {
+        id: createStepId(memory),
+        action,
+        status: "pending",
+        args,
+        purpose,
+        expectedEvidence,
+        createdAt: nowIso(),
+    };
+    memory.steps.push(step);
+    return step;
+}
+export function startStep(memory, step) {
+    assertStepTransition(step.status, "running");
+    step.status = "running";
+    step.startedAt = nowIso();
+    memory.task.currentStepId = step.id;
+}
+export function finishStep(memory, step, nextStatus, summary) {
+    assertStepTransition(step.status, nextStatus);
+    step.status = nextStatus;
+    step.resultSummary = summary;
+    step.completedAt = nowIso();
+    memory.task.currentStepId = undefined;
+}
+export function failStep(memory, step, summary) {
+    finishStep(memory, step, "failed", summary);
+}
+export function finalizeTask(memory, nextStatus, stopReason) {
+    assertTaskTransition(memory.task.status, nextStatus);
+    memory.task.status = nextStatus;
+    memory.task.stopReason = stopReason;
+}
+/**
+ * Resumes one waiting task after the user supplies the missing clarification.
+ * Example: `waiting -> active` keeps the same task id while clearing the prior stop reason.
+ */
+export function resumeTask(memory) {
+    assertTaskTransition(memory.task.status, "active");
+    memory.task.status = "active";
+    memory.task.stopReason = undefined;
+}
+/**
+ * Moves one task into the shared waiting state before the loop returns to the user.
+ * Example: `active -> waiting` records that one concrete clarification is still needed.
+ */
+export function setWaitingTask(memory, stopReason = "need-user-input") {
+    finalizeTask(memory, "waiting", stopReason);
+}
+export function requestReplan(memory) {
+    if (memory.steps.some((candidate) => candidate.status === "pending" && candidate.action === "plan")) {
+        return undefined;
+    }
+    return createRuntimeStep(memory, "plan", "Adjust the next steps using the latest evidence.", {}, ["revised plan"]);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/state/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Applies explicit task and step state transitions for the new simple agent.\n *\n * Why this file exists:\n * - status changes should not be open-coded across the loop\n * - invalid transitions should fail fast in tests and during development\n * - the first runtime slice only needs a small validated state helper\n * - runtime-created steps should come from one shared helper\n */\nimport { nowIso } from \"../evidence/index.js\";\nimport type { AgentActionName, AgentMemory, AgentStep, AgentStepStatus, AgentTaskStatus } from \"../types.js\";\n\nconst ALLOWED_STEP_TRANSITIONS: Record<AgentStepStatus, AgentStepStatus[]> = {\n  pending: [\"running\", \"skipped\", \"blocked\"],\n  running: [\"done\", \"failed\", \"blocked\"],\n  done: [],\n  failed: [],\n  blocked: [],\n  skipped: [],\n};\n\nconst ALLOWED_TASK_TRANSITIONS: Record<AgentTaskStatus, AgentTaskStatus[]> = {\n  active: [\"waiting\", \"done\", \"blocked\", \"failed\"],\n  waiting: [\"active\", \"blocked\", \"failed\", \"done\"],\n  done: [],\n  blocked: [],\n  failed: [],\n};\n\nfunction assertStepTransition(from: AgentStepStatus, to: AgentStepStatus): void {\n  if (!ALLOWED_STEP_TRANSITIONS[from].includes(to)) {\n    throw new Error(`Invalid agent step transition: ${from} -> ${to}`);\n  }\n}\n\nfunction assertTaskTransition(from: AgentTaskStatus, to: AgentTaskStatus): void {\n  if (!ALLOWED_TASK_TRANSITIONS[from].includes(to)) {\n    throw new Error(`Invalid agent task transition: ${from} -> ${to}`);\n  }\n}\n\nfunction createStepId(memory: AgentMemory): string {\n  return `step-${String(memory.steps.length + 1).padStart(3, \"0\")}`;\n}\n\n/**\n * Creates one pending runtime step in a shared way.\n * Example: a chosen `read-file` action becomes one explicit `pending` step.\n */\nexport function createRuntimeStep(\n  memory: AgentMemory,\n  action: AgentActionName,\n  purpose: string,\n  args: Record<string, unknown> = {},\n  expectedEvidence: string[] = []\n): AgentStep {\n  const step: AgentStep = {\n    id: createStepId(memory),\n    action,\n    status: \"pending\",\n    args,\n    purpose,\n    expectedEvidence,\n    createdAt: nowIso(),\n  };\n  memory.steps.push(step);\n  return step;\n}\n\nexport function startStep(memory: AgentMemory, step: AgentStep): void {\n  assertStepTransition(step.status, \"running\");\n  step.status = \"running\";\n  step.startedAt = nowIso();\n  memory.task.currentStepId = step.id;\n}\n\nexport function finishStep(\n  memory: AgentMemory,\n  step: AgentStep,\n  nextStatus: Extract<AgentStepStatus, \"done\" | \"failed\" | \"blocked\" | \"skipped\">,\n  summary: string\n): void {\n  assertStepTransition(step.status, nextStatus);\n  step.status = nextStatus;\n  step.resultSummary = summary;\n  step.completedAt = nowIso();\n  memory.task.currentStepId = undefined;\n}\n\nexport function failStep(memory: AgentMemory, step: AgentStep, summary: string): void {\n  finishStep(memory, step, \"failed\", summary);\n}\n\nexport function finalizeTask(\n  memory: AgentMemory,\n  nextStatus: Extract<AgentTaskStatus, \"waiting\" | \"done\" | \"blocked\" | \"failed\">,\n  stopReason?: string\n): void {\n  assertTaskTransition(memory.task.status, nextStatus);\n  memory.task.status = nextStatus;\n  memory.task.stopReason = stopReason;\n}\n\n/**\n * Resumes one waiting task after the user supplies the missing clarification.\n * Example: `waiting -> active` keeps the same task id while clearing the prior stop reason.\n */\nexport function resumeTask(memory: AgentMemory): void {\n  assertTaskTransition(memory.task.status, \"active\");\n  memory.task.status = \"active\";\n  memory.task.stopReason = undefined;\n}\n\n/**\n * Moves one task into the shared waiting state before the loop returns to the user.\n * Example: `active -> waiting` records that one concrete clarification is still needed.\n */\nexport function setWaitingTask(memory: AgentMemory, stopReason = \"need-user-input\"): void {\n  finalizeTask(memory, \"waiting\", stopReason);\n}\n\nexport function requestReplan(memory: AgentMemory): AgentStep | undefined {\n  if (memory.steps.some((candidate) => candidate.status === \"pending\" && candidate.action === \"plan\")) {\n    return undefined;\n  }\n  return createRuntimeStep(\n    memory,\n    \"plan\",\n    \"Adjust the next steps using the latest evidence.\",\n    {},\n    [\"revised plan\"]\n  );\n}\n"]}

package/dist/agent/state/memory.js

@@ -0,0 +1,56 @@
+import { nowIso } from "../evidence/index.js";
+let nextSessionId = 1;
+let nextTaskId = 1;
+export function createAgentMemory(query, repoRootPath, executionPath) {
+    const startedAt = nowIso();
+    const sessionId = nextSessionId++;
+    const taskId = nextTaskId++;
+    return {
+        session: {
+            id: sessionId,
+            runtime: "agent",
+            startedAt,
+            repoRootPath,
+            executionPath,
+            initialQuery: query,
+        },
+        task: {
+            id: taskId,
+            mode: "ask",
+            initialQuery: query,
+            normalizedQuery: query,
+            status: "active",
+            primaryIntent: "Understand and answer the user's request.",
+            alternativeIntents: [],
+            searchTermGroups: [],
+            ambiguityFlags: [],
+            queryScope: "general",
+            explicitTargets: [],
+            explicitTargetOverrides: {},
+            hardFileTargets: [],
+            softHints: [],
+            constraints: [],
+            turnCount: 0,
+            replanCount: 0,
+            maxTurns: 12,
+        },
+        steps: [],
+        evidence: {
+            candidateFiles: [],
+            candidateMetadata: {},
+            targetResolutions: {},
+            searches: [],
+            fileReads: {},
+            notes: [],
+        },
+        artifacts: {
+            plans: [],
+            actionResults: {},
+            transform: {
+                files: {},
+            },
+        },
+        events: [],
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/agent/state/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/agent/state/memory.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,IAAI,aAAa,GAAG,CAAC,CAAC;AACtB,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,YAAoB,EAAE,aAAqB;IAC1F,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO;QACL,OAAO,EAAE;YACP,EAAE,EAAE,SAAS;YACb,OAAO,EAAE,OAAO;YAChB,SAAS;YACT,YAAY;YACZ,aAAa;YACb,YAAY,EAAE,KAAK;SACpB;QACD,IAAI,EAAE;YACJ,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,KAAK;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,2CAA2C;YAC1D,kBAAkB,EAAE,EAAE;YACtB,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,EAAE;YAClB,UAAU,EAAE,SAAS;YACrB,eAAe,EAAE,EAAE;YACnB,uBAAuB,EAAE,EAAE;YAC3B,eAAe,EAAE,EAAE;YACnB,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,EAAE;SACb;QACD,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE;YACR,cAAc,EAAE,EAAE;YAClB,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;YACrB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;QACD,SAAS,EAAE;YACT,KAAK,EAAE,EAAE;YACT,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE;gBACT,KAAK,EAAE,EAAE;aACV;SACF;QACD,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Creates the in-memory runtime state for the new simple agent.\n *\n * Why this file exists:\n * - runtime state creation should stay separate from loop execution\n * - `memory` is the public shape for the new runtime state\n * - ids and default budgets should stay in one place\n * - transform memory needs one default home from the start\n */\nimport type { AgentMemory } from \"../types.js\";\nimport { nowIso } from \"../evidence/index.js\";\n\nlet nextSessionId = 1;\nlet nextTaskId = 1;\n\nexport function createAgentMemory(query: string, repoRootPath: string, executionPath: string): AgentMemory {\n  const startedAt = nowIso();\n  const sessionId = nextSessionId++;\n  const taskId = nextTaskId++;\n  return {\n    session: {\n      id: sessionId,\n      runtime: \"agent\",\n      startedAt,\n      repoRootPath,\n      executionPath,\n      initialQuery: query,\n    },\n    task: {\n      id: taskId,\n      mode: \"ask\",\n      initialQuery: query,\n      normalizedQuery: query,\n      status: \"active\",\n      primaryIntent: \"Understand and answer the user's request.\",\n      alternativeIntents: [],\n      searchTermGroups: [],\n      ambiguityFlags: [],\n      queryScope: \"general\",\n      explicitTargets: [],\n      explicitTargetOverrides: {},\n      hardFileTargets: [],\n      softHints: [],\n      constraints: [],\n      turnCount: 0,\n      replanCount: 0,\n      maxTurns: 12,\n    },\n    steps: [],\n    evidence: {\n      candidateFiles: [],\n      candidateMetadata: {},\n      targetResolutions: {},\n      searches: [],\n      fileReads: {},\n      notes: [],\n    },\n    artifacts: {\n      plans: [],\n      actionResults: {},\n      transform: {\n        files: {},\n      },\n    },\n    events: [],\n  };\n}\n"]}

package/dist/agent/structuredOutput/index.js

@@ -0,0 +1,28 @@
+export function parseStructuredJsonResult(raw, options) {
+    const trimmed = raw.trim();
+    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidate = fenced?.[1]?.trim() || trimmed;
+    try {
+        return {
+            value: JSON.parse(candidate),
+            meta: {
+                usedFallback: false,
+                candidateSource: fenced ? "fenced" : "plain",
+            },
+        };
+    }
+    catch (error) {
+        return {
+            value: options.fallback,
+            meta: {
+                usedFallback: true,
+                candidateSource: fenced ? "fenced" : "plain",
+                parseError: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+}
+export function parseStructuredJson(raw, options) {
+    return parseStructuredJsonResult(raw, options).value;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/structuredOutput/index.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,yBAAyB,CAAI,GAAW,EAAE,OAAwB;IAChF,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;IACjD,IAAI,CAAC;QACH,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAM;YACjC,IAAI,EAAE;gBACJ,YAAY,EAAE,KAAK;gBACnB,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;aAC7C;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,QAAQ;YACvB,IAAI,EAAE;gBACJ,YAAY,EAAE,IAAI;gBAClB,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;gBAC5C,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aACnE;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAI,GAAW,EAAE,OAAwB;IAC1E,OAAO,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC","sourcesContent":["/**\n * Owns shared structured output parsing for new-agent model calls.\n *\n * Why this file exists:\n * - model output parsing should stay separate from prompt building\n * - fenced JSON fallback should not live inside one action-specific prompt file\n * - new-agent call sites should share one small parser under one owner\n */\nexport interface StructuredJsonParseMeta {\n  usedFallback: boolean;\n  candidateSource: \"plain\" | \"fenced\";\n  parseError?: string;\n}\n\nexport interface StructuredJsonParseResult<T> {\n  value: T;\n  meta: StructuredJsonParseMeta;\n}\n\nexport function parseStructuredJsonResult<T>(raw: string, options: { fallback: T }): StructuredJsonParseResult<T> {\n  const trimmed = raw.trim();\n  const fenced = trimmed.match(/```(?:json)?\\s*([\\s\\S]*?)```/i);\n  const candidate = fenced?.[1]?.trim() || trimmed;\n  try {\n    return {\n      value: JSON.parse(candidate) as T,\n      meta: {\n        usedFallback: false,\n        candidateSource: fenced ? \"fenced\" : \"plain\",\n      },\n    };\n  } catch (error) {\n    return {\n      value: options.fallback,\n      meta: {\n        usedFallback: true,\n        candidateSource: fenced ? \"fenced\" : \"plain\",\n        parseError: error instanceof Error ? error.message : String(error),\n      },\n    };\n  }\n}\n\nexport function parseStructuredJson<T>(raw: string, options: { fallback: T }): T {\n  return parseStructuredJsonResult(raw, options).value;\n}\n"]}