scai 0.1.178 → 1.0.0

package/dist/agent/tools/index.js

@@ -0,0 +1,199 @@
+/**
+ * Builds bounded tool adapters for the modular agent runtime.
+ *
+ * Why this file exists:
+ * - tool-backed actions should call small read and search ports
+ * - repo/worktree path safety should stay outside action control flow
+ * - search and read should not leak legacy runtime contracts back into the loop
+ */
+import { canReadExplicitTarget, readAgentFile, triageAgentFile, resolveReadTarget, UnresolvedAgentTargetError, } from "../read/index.js";
+import { dedupePaths, looksLikeDirectoryTarget, nowIso } from "../evidence/index.js";
+import { refreshAgentTargetClassification } from "../policy/targetClassification.js";
+import { resolveReadCoverageState } from "../policy/coveragePolicy.js";
+import { DEFAULT_VISIBLE_SEARCH_LIMIT } from "../search/limits.js";
+import { runLoggedDirectorySearch, runLoggedRegexSearch, runSearchDb } from "../search/index.js";
+import { rankAgentSearchHits } from "../search/ranking.js";
+import { LIST_DIRECTORY_SCHEMA, READ_FILE_SCHEMA, SEARCH_DB_SCHEMA, SEARCH_REGEX_SCHEMA, TRIAGE_FILE_SCHEMA, } from "../actions/schemas.js";
+export { canReadExplicitTarget, resolveReadTarget as resolveAgentRepoFilePath, UnresolvedAgentTargetError };
+function groupSearchMatchesByFile(matches) {
+    const grouped = new Map();
+    for (const match of matches) {
+        const list = grouped.get(match.filePath) ?? [];
+        if (list.length >= 2) {
+            continue;
+        }
+        list.push(match);
+        grouped.set(match.filePath, list);
+    }
+    return grouped;
+}
+function recordSearchEvidence(memory, evidence, filePaths) {
+    var _a;
+    memory.evidence.searches.push(evidence);
+    if (filePaths.length === 0) {
+        refreshAgentTargetClassification(memory);
+        return;
+    }
+    memory.evidence.candidateFiles = dedupePaths([...memory.evidence.candidateFiles, ...filePaths]);
+    (_a = memory.evidence).candidateMetadata ?? (_a.candidateMetadata = {});
+    const rankedHits = evidence.topHits ?? rankAgentSearchHits(filePaths, {}, evidence.query, evidence.matches);
+    const groupedMatches = evidence.matches ? groupSearchMatchesByFile(evidence.matches) : new Map();
+    for (const hit of rankedHits) {
+        const existing = memory.evidence.candidateMetadata[hit.filePath] ?? {};
+        memory.evidence.candidateMetadata[hit.filePath] = {
+            ...existing,
+            searchScore: hit.score,
+            searchReasons: hit.reasons,
+            ...(groupedMatches.has(hit.filePath) ? { searchMatches: groupedMatches.get(hit.filePath) } : {}),
+            ...(typeof hit.bm25Raw === "number" ? { bm25Raw: hit.bm25Raw } : {}),
+            ...(typeof existing.triageScore === "number"
+                ? { readPriority: Number((hit.score + existing.triageScore).toFixed(2)) }
+                : { readPriority: hit.score }),
+            lastUpdatedAt: evidence.recordedAt,
+        };
+    }
+    refreshAgentTargetClassification(memory);
+}
+/**
+ * Seeds ranked folder-local candidates after one successful directory listing.
+ * Example: a guards folder listing should promote `executionPolicyResolver.ts` before later reads.
+ */
+function recordDirectoryListingCandidates(memory, directoryPath) {
+    var _a;
+    const folderTarget = resolveReadCoverageState(memory).folderTargets.find((folder) => folder.folderPath === directoryPath);
+    if (!folderTarget || folderTarget.candidates.length === 0) {
+        return;
+    }
+    memory.evidence.candidateFiles = dedupePaths([...memory.evidence.candidateFiles, ...folderTarget.candidates]);
+    (_a = memory.evidence).candidateMetadata ?? (_a.candidateMetadata = {});
+    const rankedHits = rankAgentSearchHits(folderTarget.candidates, {}, memory.task.initialQuery);
+    const recordedAt = nowIso();
+    for (const hit of rankedHits) {
+        const existing = memory.evidence.candidateMetadata[hit.filePath] ?? {};
+        memory.evidence.candidateMetadata[hit.filePath] = {
+            ...existing,
+            searchScore: hit.score,
+            searchReasons: hit.reasons,
+            ...(typeof hit.bm25Raw === "number" ? { bm25Raw: hit.bm25Raw } : {}),
+            readPriority: hit.score,
+            lastUpdatedAt: recordedAt,
+        };
+    }
+    refreshAgentTargetClassification(memory);
+}
+export function buildTools() {
+    return {
+        "search-db": {
+            name: "search-db",
+            description: "Runs deterministic indexed search.",
+            inputSchema: SEARCH_DB_SCHEMA,
+            async invoke(args, memory) {
+                const query = typeof args.query === "string" && args.query.trim().length > 0
+                    ? args.query.trim()
+                    : memory.task.normalizedQuery;
+                const limit = typeof args.limit === "number" ? args.limit : DEFAULT_VISIBLE_SEARCH_LIMIT;
+                const search = await runSearchDb(memory, query, limit);
+                const evidenceAction = "search-db";
+                const evidence = {
+                    action: evidenceAction,
+                    lane: search.lane,
+                    query,
+                    filePaths: search.filePaths,
+                    topHits: search.topHits,
+                    matches: search.matches,
+                    bestScore: search.topHits?.[0]?.score,
+                    ...(search.directoryPath ? { directoryPath: search.directoryPath } : {}),
+                    ...(search.directoryEntries ? { directoryEntries: search.directoryEntries } : {}),
+                    ...(search.summary ? { summary: search.summary } : {}),
+                    ...(search.failure ? { failure: search.failure } : {}),
+                    recordedAt: nowIso(),
+                };
+                recordSearchEvidence(memory, evidence, search.filePaths);
+                return {
+                    filePaths: search.filePaths,
+                    topHits: search.topHits ?? rankAgentSearchHits(search.filePaths, {}, query, search.matches).slice(0, limit),
+                    ...(search.matches ? { matches: search.matches } : {}),
+                    ...(search.directoryPath ? { folderPath: search.directoryPath } : {}),
+                    ...(search.directoryEntries ? { entries: search.directoryEntries } : {}),
+                    ...(search.summary ? { summary: search.summary } : {}),
+                    failure: search.failure,
+                };
+            },
+        },
+        "search-regex": {
+            name: "search-regex",
+            description: "Runs validated regex search.",
+            inputSchema: SEARCH_REGEX_SCHEMA,
+            async invoke(args, memory) {
+                const search = runLoggedRegexSearch(memory, String(args.pattern ?? ""), String(args.target ?? "content"), typeof args.flags === "string" ? args.flags : undefined);
+                const evidence = {
+                    action: "search-regex",
+                    lane: search.lane,
+                    query: memory.task.normalizedQuery,
+                    filePaths: search.filePaths,
+                    matches: search.matches,
+                    matchCount: search.matchCount,
+                    ...(search.failure ? { failure: search.failure } : {}),
+                    recordedAt: nowIso(),
+                };
+                recordSearchEvidence(memory, evidence, search.filePaths);
+                return {
+                    filePaths: search.filePaths,
+                    ...(search.matches ? { matches: search.matches } : {}),
+                    matchCount: search.matchCount,
+                    failure: search.failure,
+                };
+            },
+        },
+        "search-list-directory": {
+            name: "search-list-directory",
+            description: "Lists one resolved directory.",
+            inputSchema: LIST_DIRECTORY_SCHEMA,
+            async invoke(args, memory) {
+                const folderPath = typeof args.folderPath === "string" && args.folderPath.trim().length > 0
+                    ? args.folderPath.trim()
+                    : memory.task.explicitTargets.find((target) => looksLikeDirectoryTarget(target, memory.session.executionPath)) ?? memory.session.executionPath;
+                const search = runLoggedDirectorySearch(memory, folderPath);
+                const entries = search.directoryEntries ?? [];
+                const evidence = {
+                    action: "search-list-directory",
+                    lane: search.lane,
+                    query: folderPath,
+                    filePaths: [],
+                    ...(search.directoryPath ? { directoryPath: search.directoryPath } : {}),
+                    ...(search.directoryEntries ? { directoryEntries: entries } : {}),
+                    ...(search.summary ? { summary: search.summary } : {}),
+                    ...(search.failure ? { failure: search.failure } : {}),
+                    recordedAt: nowIso(),
+                };
+                recordSearchEvidence(memory, evidence, []);
+                if (search.directoryPath && !search.failure) {
+                    recordDirectoryListingCandidates(memory, search.directoryPath);
+                }
+                return {
+                    folderPath: search.directoryPath,
+                    entries,
+                    ...(search.summary ? { summary: search.summary } : {}),
+                    failure: search.failure,
+                };
+            },
+        },
+        "read-file": {
+            name: "read-file",
+            description: "Reads one file with a full model-backed understanding pass.",
+            inputSchema: READ_FILE_SCHEMA,
+            async invoke(args, memory) {
+                return readAgentFile(memory, String(args.target ?? "").trim());
+            },
+        },
+        "triage-file": {
+            name: "triage-file",
+            description: "Runs one deterministic triage read over a candidate file.",
+            inputSchema: TRIAGE_FILE_SCHEMA,
+            async invoke(args, memory) {
+                return triageAgentFile(memory, String(args.target ?? "").trim());
+            },
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builds bounded tool adapters for the modular agent runtime.\n *\n * Why this file exists:\n * - tool-backed actions should call small read and search ports\n * - repo/worktree path safety should stay outside action control flow\n * - search and read should not leak legacy runtime contracts back into the loop\n */\nimport {\n  canReadExplicitTarget,\n  readAgentFile,\n  triageAgentFile,\n  resolveReadTarget,\n  UnresolvedAgentTargetError,\n} from \"../read/index.js\";\nimport { dedupePaths, looksLikeDirectoryTarget, nowIso } from \"../evidence/index.js\";\nimport { refreshAgentTargetClassification } from \"../policy/targetClassification.js\";\nimport { resolveReadCoverageState } from \"../policy/coveragePolicy.js\";\nimport { DEFAULT_VISIBLE_SEARCH_LIMIT } from \"../search/limits.js\";\nimport { runLoggedDirectorySearch, runLoggedRegexSearch, runSearchDb } from \"../search/index.js\";\nimport { rankAgentSearchHits } from \"../search/ranking.js\";\nimport type { AgentMemory, AgentSearchEvidence, AgentTool } from \"../types.js\";\nimport {\n  LIST_DIRECTORY_SCHEMA,\n  READ_FILE_SCHEMA,\n  SEARCH_DB_SCHEMA,\n  SEARCH_REGEX_SCHEMA,\n  TRIAGE_FILE_SCHEMA,\n} from \"../actions/schemas.js\";\n\nexport { canReadExplicitTarget, resolveReadTarget as resolveAgentRepoFilePath, UnresolvedAgentTargetError };\n\nfunction groupSearchMatchesByFile(matches: NonNullable<AgentSearchEvidence[\"matches\"]>): Map<string, NonNullable<AgentSearchEvidence[\"matches\"]>> {\n  const grouped = new Map<string, NonNullable<AgentSearchEvidence[\"matches\"]>>();\n  for (const match of matches) {\n    const list = grouped.get(match.filePath) ?? [];\n    if (list.length >= 2) {\n      continue;\n    }\n    list.push(match);\n    grouped.set(match.filePath, list);\n  }\n  return grouped;\n}\n\nfunction recordSearchEvidence(memory: AgentMemory, evidence: AgentSearchEvidence, filePaths: string[]): void {\n  memory.evidence.searches.push(evidence);\n  if (filePaths.length === 0) {\n    refreshAgentTargetClassification(memory);\n    return;\n  }\n  memory.evidence.candidateFiles = dedupePaths([...memory.evidence.candidateFiles, ...filePaths]);\n  memory.evidence.candidateMetadata ??= {};\n  const rankedHits = evidence.topHits ?? rankAgentSearchHits(filePaths, {}, evidence.query, evidence.matches);\n  const groupedMatches = evidence.matches ? groupSearchMatchesByFile(evidence.matches) : new Map();\n  for (const hit of rankedHits) {\n    const existing = memory.evidence.candidateMetadata[hit.filePath] ?? {};\n    memory.evidence.candidateMetadata[hit.filePath] = {\n      ...existing,\n      searchScore: hit.score,\n      searchReasons: hit.reasons,\n      ...(groupedMatches.has(hit.filePath) ? { searchMatches: groupedMatches.get(hit.filePath) } : {}),\n      ...(typeof hit.bm25Raw === \"number\" ? { bm25Raw: hit.bm25Raw } : {}),\n      ...(typeof existing.triageScore === \"number\"\n        ? { readPriority: Number((hit.score + existing.triageScore).toFixed(2)) }\n        : { readPriority: hit.score }),\n      lastUpdatedAt: evidence.recordedAt,\n    };\n  }\n  refreshAgentTargetClassification(memory);\n}\n\n/**\n * Seeds ranked folder-local candidates after one successful directory listing.\n * Example: a guards folder listing should promote `executionPolicyResolver.ts` before later reads.\n */\nfunction recordDirectoryListingCandidates(memory: AgentMemory, directoryPath: string): void {\n  const folderTarget = resolveReadCoverageState(memory).folderTargets.find((folder) => folder.folderPath === directoryPath);\n  if (!folderTarget || folderTarget.candidates.length === 0) {\n    return;\n  }\n\n  memory.evidence.candidateFiles = dedupePaths([...memory.evidence.candidateFiles, ...folderTarget.candidates]);\n  memory.evidence.candidateMetadata ??= {};\n  const rankedHits = rankAgentSearchHits(folderTarget.candidates, {}, memory.task.initialQuery);\n  const recordedAt = nowIso();\n  for (const hit of rankedHits) {\n    const existing = memory.evidence.candidateMetadata[hit.filePath] ?? {};\n    memory.evidence.candidateMetadata[hit.filePath] = {\n      ...existing,\n      searchScore: hit.score,\n      searchReasons: hit.reasons,\n      ...(typeof hit.bm25Raw === \"number\" ? { bm25Raw: hit.bm25Raw } : {}),\n      readPriority: hit.score,\n      lastUpdatedAt: recordedAt,\n    };\n  }\n  refreshAgentTargetClassification(memory);\n}\n\nexport function buildTools(): Record<string, AgentTool> {\n  return {\n    \"search-db\": {\n      name: \"search-db\",\n      description: \"Runs deterministic indexed search.\",\n      inputSchema: SEARCH_DB_SCHEMA,\n      async invoke(args, memory) {\n        const query = typeof args.query === \"string\" && args.query.trim().length > 0\n          ? args.query.trim()\n          : memory.task.normalizedQuery;\n        const limit = typeof args.limit === \"number\" ? args.limit : DEFAULT_VISIBLE_SEARCH_LIMIT;\n        const search = await runSearchDb(memory, query, limit);\n        const evidenceAction = \"search-db\";\n        const evidence: AgentSearchEvidence = {\n          action: evidenceAction,\n          lane: search.lane,\n          query,\n          filePaths: search.filePaths,\n          topHits: search.topHits,\n          matches: search.matches,\n          bestScore: search.topHits?.[0]?.score,\n          ...(search.directoryPath ? { directoryPath: search.directoryPath } : {}),\n          ...(search.directoryEntries ? { directoryEntries: search.directoryEntries } : {}),\n          ...(search.summary ? { summary: search.summary } : {}),\n          ...(search.failure ? { failure: search.failure } : {}),\n          recordedAt: nowIso(),\n        };\n        recordSearchEvidence(memory, evidence, search.filePaths);\n        return {\n          filePaths: search.filePaths,\n          topHits: search.topHits ?? rankAgentSearchHits(search.filePaths, {}, query, search.matches).slice(0, limit),\n          ...(search.matches ? { matches: search.matches } : {}),\n          ...(search.directoryPath ? { folderPath: search.directoryPath } : {}),\n          ...(search.directoryEntries ? { entries: search.directoryEntries } : {}),\n          ...(search.summary ? { summary: search.summary } : {}),\n          failure: search.failure,\n        };\n      },\n    },\n    \"search-regex\": {\n      name: \"search-regex\",\n      description: \"Runs validated regex search.\",\n      inputSchema: SEARCH_REGEX_SCHEMA,\n      async invoke(args, memory) {\n        const search = runLoggedRegexSearch(\n          memory,\n          String(args.pattern ?? \"\"),\n          String(args.target ?? \"content\") as \"path\" | \"content\" | \"both\",\n          typeof args.flags === \"string\" ? args.flags : undefined\n        );\n        const evidence: AgentSearchEvidence = {\n          action: \"search-regex\",\n          lane: search.lane,\n          query: memory.task.normalizedQuery,\n          filePaths: search.filePaths,\n          matches: search.matches,\n          matchCount: search.matchCount,\n          ...(search.failure ? { failure: search.failure } : {}),\n          recordedAt: nowIso(),\n        };\n        recordSearchEvidence(memory, evidence, search.filePaths);\n        return {\n          filePaths: search.filePaths,\n          ...(search.matches ? { matches: search.matches } : {}),\n          matchCount: search.matchCount,\n          failure: search.failure,\n        };\n      },\n    },\n    \"search-list-directory\": {\n      name: \"search-list-directory\",\n      description: \"Lists one resolved directory.\",\n      inputSchema: LIST_DIRECTORY_SCHEMA,\n      async invoke(args, memory) {\n        const folderPath = typeof args.folderPath === \"string\" && args.folderPath.trim().length > 0\n          ? args.folderPath.trim()\n          : memory.task.explicitTargets.find((target) => looksLikeDirectoryTarget(target, memory.session.executionPath)) ?? memory.session.executionPath;\n        const search = runLoggedDirectorySearch(memory, folderPath);\n        const entries = search.directoryEntries ?? [];\n        const evidence: AgentSearchEvidence = {\n          action: \"search-list-directory\",\n          lane: search.lane,\n          query: folderPath,\n          filePaths: [],\n          ...(search.directoryPath ? { directoryPath: search.directoryPath } : {}),\n          ...(search.directoryEntries ? { directoryEntries: entries } : {}),\n          ...(search.summary ? { summary: search.summary } : {}),\n          ...(search.failure ? { failure: search.failure } : {}),\n          recordedAt: nowIso(),\n        };\n        recordSearchEvidence(memory, evidence, []);\n        if (search.directoryPath && !search.failure) {\n          recordDirectoryListingCandidates(memory, search.directoryPath);\n        }\n        return {\n          folderPath: search.directoryPath,\n          entries,\n          ...(search.summary ? { summary: search.summary } : {}),\n          failure: search.failure,\n        };\n      },\n    },\n    \"read-file\": {\n      name: \"read-file\",\n      description: \"Reads one file with a full model-backed understanding pass.\",\n      inputSchema: READ_FILE_SCHEMA,\n      async invoke(args, memory) {\n        return readAgentFile(memory, String(args.target ?? \"\").trim());\n      },\n    },\n    \"triage-file\": {\n      name: \"triage-file\",\n      description: \"Runs one deterministic triage read over a candidate file.\",\n      inputSchema: TRIAGE_FILE_SCHEMA,\n      async invoke(args, memory) {\n        return triageAgentFile(memory, String(args.target ?? \"\").trim());\n      },\n    },\n  };\n}\n"]}