@linghun/tools 0.1.0 → 0.1.2

package/dist/{chunk-NKWRH36V.js → chunk-2R75FXZG.js}

@@ -1,24 +1,30 @@
-import {
-  WebSearchTool
-} from "./chunk-4EZHIDZ6.js";
 import {
   WriteTool
 } from "./chunk-I3Z4OKMS.js";
-import {
-  MultiEditTool
-} from "./chunk-VJDLOFCF.js";
 import {
   WebFetchTool
 } from "./chunk-LGZOG7IQ.js";
+import {
+  WebSearchTool
+} from "./chunk-4EZHIDZ6.js";
+import {
+  ReadSnippetsTool
+} from "./chunk-GI5XI4HN.js";
+import {
+  SourcePackTool
+} from "./chunk-A6FUAM64.js";
+import {
+  TodoTool
+} from "./chunk-MFHY7PBM.js";
 import {
   GrepTool
 } from "./chunk-AZCQL24J.js";
 import {
-  ReadTool
-} from "./chunk-RBHQ5WNR.js";
+  MultiEditTool
+} from "./chunk-VJDLOFCF.js";
 import {
-  TodoTool
-} from "./chunk-4567YAXM.js";
+  ReadTool
+} from "./chunk-TZ6QK52L.js";
 import {
   GlobTool
 } from "./chunk-DN3KJZRV.js";
@@ -35,6 +41,8 @@ import {
 // src/tools/ui.ts
 var toolUserFacingNames = {
   Read: ReadTool.userFacingName,
+  ReadSnippets: ReadSnippetsTool.userFacingName,
+  SourcePack: SourcePackTool.userFacingName,
   Write: WriteTool.userFacingName,
   Edit: EditTool.userFacingName,
   MultiEdit: MultiEditTool.userFacingName,

package/dist/chunk-A6FUAM64.js

@@ -0,0 +1,11 @@
+import {
+  prompt
+} from "./chunk-YCO6C7KF.js";
+
+// src/tools/SourcePack/SourcePackTool.ts
+var userFacingName = "\u5B9A\u4F4D\u4EE3\u7801\u7247\u6BB5";
+var SourcePackTool = { name: "SourcePack", prompt, userFacingName };
+
+export {
+  SourcePackTool
+};

package/dist/{chunk-KGDJAST5.js → chunk-DWXJBDPQ.js}

@@ -1,24 +1,30 @@
-import {
-  WebSearchTool
-} from "./chunk-4EZHIDZ6.js";
 import {
   WriteTool
 } from "./chunk-I3Z4OKMS.js";
-import {
-  MultiEditTool
-} from "./chunk-VJDLOFCF.js";
 import {
   WebFetchTool
 } from "./chunk-LGZOG7IQ.js";
+import {
+  WebSearchTool
+} from "./chunk-4EZHIDZ6.js";
+import {
+  ReadSnippetsTool
+} from "./chunk-GI5XI4HN.js";
+import {
+  SourcePackTool
+} from "./chunk-A6FUAM64.js";
+import {
+  TodoTool
+} from "./chunk-MFHY7PBM.js";
 import {
   GrepTool
 } from "./chunk-AZCQL24J.js";
 import {
-  ReadTool
-} from "./chunk-RBHQ5WNR.js";
+  MultiEditTool
+} from "./chunk-VJDLOFCF.js";
 import {
-  TodoTool
-} from "./chunk-4567YAXM.js";
+  ReadTool
+} from "./chunk-TZ6QK52L.js";
 import {
   GlobTool
 } from "./chunk-DN3KJZRV.js";
@@ -35,6 +41,8 @@ import {
 // src/tools/prompts.ts
 var toolPrompts = {
   Read: ReadTool.prompt,
+  ReadSnippets: ReadSnippetsTool.prompt,
+  SourcePack: SourcePackTool.prompt,
   Write: WriteTool.prompt,
   Edit: EditTool.prompt,
   MultiEdit: MultiEditTool.prompt,

package/dist/chunk-GI5XI4HN.js

@@ -0,0 +1,11 @@
+import {
+  prompt
+} from "./chunk-WEWXKRKL.js";
+
+// src/tools/ReadSnippets/ReadSnippetsTool.ts
+var userFacingName = "\u8BFB\u53D6\u4EE3\u7801\u7247\u6BB5";
+var ReadSnippetsTool = { name: "ReadSnippets", prompt, userFacingName };
+
+export {
+  ReadSnippetsTool
+};

package/dist/chunk-WEWXKRKL.js

@@ -0,0 +1,6 @@
+// src/tools/ReadSnippets/prompt.ts
+var prompt = "Use ReadSnippets to read multiple known file line ranges in one call. Prefer it after search, index, or codebase-memory hits return path/range candidates.";
+
+export {
+  prompt
+};

package/dist/chunk-YCO6C7KF.js

@@ -0,0 +1,6 @@
+// src/tools/SourcePack/prompt.ts
+var prompt = "Use SourcePack to locate a small evidence pack of candidate source snippets for a query. If index/codebase-memory already returned paths or ranges, call ReadSnippets on those candidates first.";
+
+export {
+  prompt
+};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import type { ChildProcess } from "node:child_process";
 import { type ToolDefinition } from "./tool-runtime.js";
 export type { ToolDefinition, ToolFactoryDefinition, ToolInterruptBehavior, ToolLifecycleMetadata, ToolPermissionDecision, } from "./tool-runtime.js";
 export { createTool } from "./tool-runtime.js";
@@ -24,23 +25,41 @@ export type ToolProgressEvent = {
     stream: "stdout" | "stderr" | "system";
     text: string;
 };
+export type ToolChildProcessTrackOptions = {
+    detached?: boolean;
+    label?: string;
+    cwd?: string;
+    retainAfterExit?: boolean;
+};
 export type ReadSnapshot = {
     path: string;
     hash: string;
     mtimeMs: number;
     size: number;
 };
+export type SourcePackCandidate = {
+    path: string;
+    start: number;
+    end: number;
+    reason?: string;
+    confidence?: number;
+};
 export type ToolContext = {
     workspaceRoot: string;
     logRoot?: string;
     changedFiles: string[];
     todos: TodoItem[];
     readSnapshots?: Record<string, ReadSnapshot>;
+    sourcePackCandidates?: SourcePackCandidate[];
     patchSummaries?: Record<string, DiffSummary>;
     abortSignal?: AbortSignal;
     onProgress?: (event: ToolProgressEvent) => void | Promise<void>;
+    trackChildProcess?: (child: Pick<ChildProcess, "kill" | "pid" | "exitCode" | "signalCode" | "once">, options?: ToolChildProcessTrackOptions) => boolean;
+};
+export type ToolContextOptions = {
+    sourcePackCandidates?: SourcePackCandidate[];
 };
-export type ToolName = "Read" | "Write" | "Edit" | "MultiEdit" | "Grep" | "Glob" | "Bash" | "Todo" | "Diff" | "WebSearch" | "WebFetch";
+export type ToolName = "Read" | "ReadSnippets" | "SourcePack" | "Write" | "Edit" | "MultiEdit" | "Grep" | "Glob" | "Bash" | "Todo" | "Diff" | "WebSearch" | "WebFetch";
 export type TodoStatus = "pending" | "in_progress" | "completed" | "blocked";
 export type TodoItem = {
     id: string;
@@ -60,6 +79,17 @@ export type ReadInput = {
     offset?: number;
     limit?: number;
 };
+export type ReadSnippetsInput = {
+    ranges: {
+        path: string;
+        start: number;
+        end: number;
+    }[];
+};
+export type SourcePackInput = {
+    query: string;
+    limit?: number;
+};
 export type WriteInput = {
     path: string;
     content: string;
@@ -117,7 +147,7 @@ export type ToolRunResult = {
     output: ToolOutput;
 };
 export declare const toolRegistryStatus: "ready";
-export declare function createToolContext(workspaceRoot?: string): ToolContext;
+export declare function createToolContext(workspaceRoot?: string, options?: ToolContextOptions): ToolContext;
 /**
  * **UNSAFE LOW-LEVEL PRIMITIVE.** Executes a built-in tool directly without
  * any permission policy check.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,42 +1,46 @@
+import {
+  formatFetchOutput,
+  webFetch
+} from "./chunk-4UHQWBFA.js";
 import {
   applyDomainFilter,
   bingSearch,
   formatSearchOutput
 } from "./chunk-EPIB4FSE.js";
-import {
-  formatFetchOutput,
-  webFetch
-} from "./chunk-4UHQWBFA.js";
 import {
   createTool
 } from "./chunk-MMJX44V6.js";
 import {
   toolPrompts
-} from "./chunk-KGDJAST5.js";
+} from "./chunk-DWXJBDPQ.js";
 import {
   toolUserFacingNames
-} from "./chunk-NKWRH36V.js";
-import "./chunk-4EZHIDZ6.js";
-import "./chunk-YR4HWOR2.js";
-import "./chunk-VAFW24RN.js";
+} from "./chunk-2R75FXZG.js";
 import "./chunk-I3Z4OKMS.js";
 import "./chunk-PS2ZOFZ6.js";
 import "./chunk-NPKLGVDQ.js";
-import "./chunk-VJDLOFCF.js";
-import "./chunk-3RP665TH.js";
-import "./chunk-IOC3BSPT.js";
 import "./chunk-LGZOG7IQ.js";
 import "./chunk-ZYAEUABC.js";
 import "./chunk-SWK6XRZQ.js";
+import "./chunk-4EZHIDZ6.js";
+import "./chunk-YR4HWOR2.js";
+import "./chunk-VAFW24RN.js";
+import "./chunk-GI5XI4HN.js";
+import "./chunk-WEWXKRKL.js";
+import "./chunk-A6FUAM64.js";
+import "./chunk-YCO6C7KF.js";
+import "./chunk-MFHY7PBM.js";
+import "./chunk-SZFZPQGL.js";
+import "./chunk-XZWSO5CM.js";
 import "./chunk-AZCQL24J.js";
 import "./chunk-HUIZOB4A.js";
 import "./chunk-MK3YP2VR.js";
-import "./chunk-RBHQ5WNR.js";
-import "./chunk-HNIVNZIS.js";
+import "./chunk-VJDLOFCF.js";
+import "./chunk-3RP665TH.js";
+import "./chunk-IOC3BSPT.js";
+import "./chunk-TZ6QK52L.js";
 import "./chunk-K3YDFDLP.js";
-import "./chunk-4567YAXM.js";
-import "./chunk-XZWSO5CM.js";
-import "./chunk-SZFZPQGL.js";
+import "./chunk-HNIVNZIS.js";
 import "./chunk-DN3KJZRV.js";
 import "./chunk-2U4BZXAI.js";
 import "./chunk-ITBZHMZQ.js";
@@ -59,6 +63,13 @@ var toolRegistryStatus = "ready";
 var DEFAULT_LIMIT = 200;
 var DEFAULT_SEARCH_LIMIT = 100;
 var DEFAULT_TOOL_TEXT_LIMIT = 5e4;
+var MAX_READ_SNIPPET_RANGES = 20;
+var MAX_READ_SNIPPET_LINES = 120;
+var MAX_READ_SNIPPET_OUTPUT_CHARS = 2e5;
+var SOURCE_PACK_DEFAULT_LIMIT = 6;
+var SOURCE_PACK_MAX_LIMIT = 12;
+var SOURCE_PACK_CONTEXT_LINES = 8;
+var SOURCE_PACK_MAX_TERMS = 6;
 var BASH_PREVIEW_LIMIT = 3e4;
 var BASH_TIMEOUT_MS = 12e4;
 var MAX_TODO_ITEMS = 100;
@@ -66,12 +77,13 @@ var SEARCH_EXCLUDED_DIR_NAMES = ["node_modules", "dist", ".git", ".codebase-memo
 var SEARCH_EXCLUDED_PATH_PREFIXES = [".linghun/logs", ".linghun/agent-runs", ".linghun/failures"];
 var SEARCH_EXCLUDED_FILE_SUFFIXES = [".tsbuildinfo"];
 var RG_TIMEOUT_MS = 3e4;
-function createToolContext(workspaceRoot = process.cwd()) {
+function createToolContext(workspaceRoot = process.cwd(), options = {}) {
   return {
     workspaceRoot: resolve(workspaceRoot),
     changedFiles: [],
     todos: [],
     readSnapshots: {},
+    sourcePackCandidates: options.sourcePackCandidates,
     patchSummaries: {}
   };
 }
@@ -116,6 +128,52 @@ var toolDefinitions = {
     getToolUseSummary: (input) => `Read ${input.path}`,
     getActivityDescription: (input) => `Reading ${input.path}`
   }),
+  ReadSnippets: defineTool({
+    name: "ReadSnippets",
+    title: "\u8BFB\u53D6\u4EE3\u7801\u7247\u6BB5",
+    description: "\u4E00\u6B21\u8BFB\u53D6\u591A\u4E2A\u5DE5\u4F5C\u533A\u6587\u4EF6\u8303\u56F4\u3002",
+    permission: {
+      risk: "low",
+      scope: "workspace",
+      reason: "\u53EA\u8BFB\u67E5\u770B\u591A\u4E2A\u6587\u4EF6\u7247\u6BB5\u3002",
+      phase06Mode: "metadata-only"
+    },
+    isReadOnly: true,
+    isConcurrencySafe: true,
+    lifecycle: {
+      ...readOnlyLifecycle(),
+      maxResultSizeChars: MAX_READ_SNIPPET_OUTPUT_CHARS + 2e3
+    },
+    validateInput: validateReadSnippetsInput,
+    call: readSnippetsTool,
+    prompt: () => toolPrompts.ReadSnippets,
+    userFacingName: () => toolUserFacingNames.ReadSnippets,
+    getToolUseSummary: (input) => `ReadSnippets ${input.ranges.length} ranges`,
+    getActivityDescription: (input) => `Reading ${input.ranges.length} snippets`
+  }),
+  SourcePack: defineTool({
+    name: "SourcePack",
+    title: "\u5B9A\u4F4D\u4EE3\u7801\u7247\u6BB5",
+    description: "\u6309\u67E5\u8BE2\u5B9A\u4F4D\u5E76\u8FD4\u56DE\u5019\u9009\u4EE3\u7801\u7247\u6BB5\u3002",
+    permission: {
+      risk: "low",
+      scope: "workspace",
+      reason: "\u53EA\u8BFB\u641C\u7D22\u5E76\u8FD4\u56DE\u5019\u9009\u4EE3\u7801\u7247\u6BB5\u3002",
+      phase06Mode: "metadata-only"
+    },
+    isReadOnly: true,
+    isConcurrencySafe: true,
+    lifecycle: {
+      ...readOnlyLifecycle(),
+      maxResultSizeChars: MAX_READ_SNIPPET_OUTPUT_CHARS + 2e3
+    },
+    validateInput: validateSourcePackInput,
+    call: sourcePackTool,
+    prompt: () => toolPrompts.SourcePack,
+    userFacingName: () => toolUserFacingNames.SourcePack,
+    getToolUseSummary: (input) => `SourcePack ${input.query}`,
+    getActivityDescription: (input) => `Locating snippets for ${input.query}`
+  }),
   Write: defineTool({
     name: "Write",
     title: "\u5199\u5165\u6587\u4EF6",
@@ -420,6 +478,46 @@ function validateReadInput(input) {
     limit: readOptionalPositiveInteger(record, "limit", "Read")
   };
 }
+function validateReadSnippetsInput(input) {
+  const record = validateRecord(input, "ReadSnippets");
+  const ranges = record.ranges;
+  if (!Array.isArray(ranges) || ranges.length === 0) {
+    throw new Error("ReadSnippets.ranges \u5FC5\u987B\u662F\u975E\u7A7A\u6570\u7EC4\u3002");
+  }
+  if (ranges.length > MAX_READ_SNIPPET_RANGES) {
+    throw new Error(`ReadSnippets.ranges \u6700\u591A ${MAX_READ_SNIPPET_RANGES} \u4E2A\u8303\u56F4\u3002`);
+  }
+  return {
+    ranges: ranges.map((item, index) => {
+      const range = validateRecord(item, "ReadSnippets");
+      const start = readPositiveLineNumber(range, "start", "ReadSnippets");
+      const end = readPositiveLineNumber(range, "end", "ReadSnippets");
+      if (end < start) {
+        throw new Error(`ReadSnippets.ranges[${index}].end \u5FC5\u987B\u5927\u4E8E\u7B49\u4E8E start\u3002`);
+      }
+      return {
+        path: readString(range, "path", "ReadSnippets"),
+        start,
+        end
+      };
+    })
+  };
+}
+function validateSourcePackInput(input) {
+  const record = validateRecord(input, "SourcePack");
+  const limit = readOptionalPositiveInteger(record, "limit", "SourcePack");
+  return {
+    query: readString(record, "query", "SourcePack"),
+    limit: limit === void 0 ? void 0 : Math.min(Math.max(limit, 1), SOURCE_PACK_MAX_LIMIT)
+  };
+}
+function readPositiveLineNumber(record, key, toolName) {
+  const value = record[key];
+  if (!Number.isInteger(value) || value < 1) {
+    throw new Error(`${toolName}.${key} \u5FC5\u987B\u662F 1-based \u6B63\u6574\u6570\u884C\u53F7\u3002`);
+  }
+  return value;
+}
 function validateWriteInput(input) {
   const record = validateRecord(input, "Write");
   return {
@@ -566,6 +664,183 @@ async function readTool(input, context) {
     truncated
   };
 }
+async function readSnippetsTool(input, context) {
+  const ranges = [];
+  let remainingChars = MAX_READ_SNIPPET_OUTPUT_CHARS;
+  let safetyTruncated = false;
+  for (const range of input.ranges) {
+    const requestedEnd = range.end;
+    const boundedEnd = Math.min(range.end, range.start + MAX_READ_SNIPPET_LINES - 1);
+    const rangeLineTruncated = boundedEnd < requestedEnd;
+    try {
+      const filePath = resolveWorkspacePath(context.workspaceRoot, range.path);
+      const content = await readFile(filePath, "utf8");
+      const info = await stat(filePath);
+      rememberReadSnapshot(context, filePath, content, info);
+      const lines = splitContentLines(content);
+      const selected = lines.slice(range.start - 1, boundedEnd);
+      const actualEnd = selected.length > 0 ? range.start + selected.length - 1 : range.start - 1;
+      const numbered = selected.map((line, index) => `${range.start + index}	${line}`).join("\n");
+      const capped = applySnippetSafetyCap(numbered, remainingChars);
+      remainingChars -= capped.usedChars;
+      safetyTruncated ||= capped.truncated;
+      ranges.push({
+        path: relativePath(context.workspaceRoot, filePath),
+        start: range.start,
+        end: actualEnd,
+        content: capped.content,
+        requestedStart: range.start,
+        requestedEnd,
+        totalLines: lines.length,
+        truncated: rangeLineTruncated || capped.truncated
+      });
+      if (capped.truncated) {
+        remainingChars = 0;
+      }
+    } catch (error) {
+      ranges.push({
+        path: range.path,
+        start: range.start,
+        end: boundedEnd,
+        content: "",
+        requestedStart: range.start,
+        requestedEnd,
+        truncated: rangeLineTruncated,
+        error: formatDiagnosticError(error)
+      });
+    }
+  }
+  const text = formatReadSnippetsOutput(ranges, safetyTruncated);
+  const okCount = ranges.filter((range) => !range.error).length;
+  return {
+    text,
+    summary: `ReadSnippets: ${okCount}/${ranges.length} ranges`,
+    data: {
+      ranges,
+      count: okCount,
+      requestedRanges: input.ranges.length,
+      safetyTruncated
+    },
+    truncated: ranges.some((range) => range.truncated) || safetyTruncated
+  };
+}
+function applySnippetSafetyCap(content, remainingChars) {
+  if (remainingChars <= 0) {
+    return {
+      content: "...\uFF08\u7ED3\u679C\u5DF2\u622A\u65AD\uFF0C\u540E\u7EED\u5185\u5BB9\u7701\u7565\uFF1B\u5982\u9700\u7CBE\u8BFB\u8BF7\u6307\u5B9A\u66F4\u5C0F\u8303\u56F4\u3002\uFF09",
+      usedChars: 0,
+      truncated: true
+    };
+  }
+  if (content.length <= remainingChars) {
+    return { content, usedChars: content.length, truncated: false };
+  }
+  const suffix = "\n...\uFF08\u7ED3\u679C\u5DF2\u622A\u65AD\uFF0C\u540E\u7EED\u5185\u5BB9\u7701\u7565\uFF1B\u5982\u9700\u7CBE\u8BFB\u8BF7\u6307\u5B9A\u66F4\u5C0F\u8303\u56F4\u3002\uFF09";
+  const sliceLength = Math.max(0, remainingChars - suffix.length);
+  return {
+    content: `${content.slice(0, sliceLength)}${suffix}`,
+    usedChars: remainingChars,
+    truncated: true
+  };
+}
+function formatReadSnippetsOutput(ranges, safetyTruncated) {
+  const lines = [];
+  for (const range of ranges) {
+    const header = `${range.path}:${range.start}-${range.end}`;
+    if (range.error) {
+      lines.push(`${header}
+ERROR: ${range.error}`);
+      continue;
+    }
+    lines.push(`${header}
+${range.content}`);
+    if (range.truncated) {
+      lines.push("...\uFF08\u8BE5\u8303\u56F4\u5DF2\u622A\u65AD\uFF1B\u53EF\u7EE7\u7EED\u8BFB\u53D6\u540E\u7EED\u8303\u56F4\u3002\uFF09");
+    }
+  }
+  if (safetyTruncated) {
+    lines.push("...\uFF08\u7ED3\u679C\u5DF2\u622A\u65AD\uFF0C\u540E\u7EED\u5185\u5BB9\u7701\u7565\uFF1B\u5982\u9700\u7CBE\u8BFB\u8BF7\u6307\u5B9A\u66F4\u5C0F\u8303\u56F4\u3002\uFF09");
+  }
+  return lines.join("\n\n");
+}
+async function sourcePackTool(input, context) {
+  const limit = input.limit ?? SOURCE_PACK_DEFAULT_LIMIT;
+  const terms = extractSourcePackTerms(input.query);
+  if (terms.length === 0) {
+    return {
+      text: "empty: query did not contain searchable terms.",
+      summary: "SourcePack: 0 snippets",
+      data: { query: input.query, snippets: [], count: 0, empty: true }
+    };
+  }
+  const matchResult = await findSourcePackMatches(input.query, terms, context, limit * 4);
+  const snippets = [];
+  const seen = /* @__PURE__ */ new Set();
+  let remainingChars = MAX_READ_SNIPPET_OUTPUT_CHARS;
+  let safetyTruncated = false;
+  for (const match of matchResult.matches) {
+    if (snippets.length >= limit) break;
+    const start = match.start ?? Math.max(1, match.line - SOURCE_PACK_CONTEXT_LINES);
+    const end = match.end ?? match.line + SOURCE_PACK_CONTEXT_LINES;
+    const key = `${match.path}:${start}:${end}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    try {
+      const filePath = resolveWorkspacePath(context.workspaceRoot, match.path);
+      const content = await readFile(filePath, "utf8");
+      const info = await stat(filePath);
+      rememberReadSnapshot(context, filePath, content, info);
+      const lines = splitContentLines(content);
+      const boundedEnd = Math.min(end, lines.length);
+      const selected = lines.slice(start - 1, boundedEnd);
+      const numbered = selected.map((line, index) => `${start + index}	${line}`).join("\n");
+      const capped = applySnippetSafetyCap(numbered, remainingChars);
+      remainingChars -= capped.usedChars;
+      safetyTruncated ||= capped.truncated;
+      snippets.push({
+        path: relativePath(context.workspaceRoot, filePath),
+        start,
+        end: boundedEnd,
+        content: capped.content,
+        requestedStart: start,
+        requestedEnd: end,
+        totalLines: lines.length,
+        truncated: capped.truncated,
+        reason: match.reason ?? `matched "${match.term}" at line ${match.line}`,
+        confidence: estimateSourcePackConfidence(input.query, match),
+        source: match.source
+      });
+      if (capped.truncated) {
+        break;
+      }
+    } catch {
+      continue;
+    }
+  }
+  if (snippets.length === 0) {
+    return {
+      text: "empty: no matching source snippets found.",
+      summary: "SourcePack: 0 snippets",
+      data: { query: input.query, snippets: [], count: 0, empty: true }
+    };
+  }
+  const text = formatSourcePackOutput(snippets, safetyTruncated);
+  return {
+    text,
+    summary: `SourcePack: ${snippets.length} snippets`,
+    data: {
+      query: input.query,
+      snippets,
+      count: snippets.length,
+      searchedTerms: terms,
+      source: matchResult.source,
+      fallback: matchResult.source !== "index",
+      candidatePaths: unique(snippets.map((snippet) => snippet.path)),
+      safetyTruncated
+    },
+    truncated: safetyTruncated || snippets.some((snippet) => snippet.truncated)
+  };
+}
 function splitContentLines(content) {
   if (content.length === 0) {
     return [];
@@ -744,7 +1019,8 @@ async function bashTool(input, context) {
     context.workspaceRoot,
     timeoutMs,
     context.abortSignal,
-    (stream, text) => void context.onProgress?.({ toolName: "Bash", stream, text })
+    (stream, text) => void context.onProgress?.({ toolName: "Bash", stream, text }),
+    context.trackChildProcess
   );
   const adapterLines = adapted.command === input.command && adapted.adapter === "native" ? [] : [
     `adapter ${adapted.adapter}`,
@@ -763,13 +1039,28 @@ async function bashTool(input, context) {
   const truncated = fullText.length > BASH_PREVIEW_LIMIT;
   const preview = truncated ? `${fullText.slice(0, BASH_PREVIEW_LIMIT)}
 ...\uFF08\u8F93\u51FA\u5DF2\u622A\u65AD\uFF0C\u5B8C\u6574\u65E5\u5FD7\u89C1 fullOutputPath\uFF09` : fullText;
+  const details = createBashDetails(fullOutputPath, fullText);
   return {
     text: preview,
+    details,
     data: adapted.adapter === "native" ? { exitCode: result.exitCode, outcome: result.outcome } : { exitCode: result.exitCode, outcome: result.outcome, adapter: adapted.adapter },
     truncated,
     fullOutputPath
   };
 }
+function createBashDetails(fullOutputPath, fullText) {
+  return [
+    `fullOutputPath: ${fullOutputPath}`,
+    "--- summary",
+    ...fullText.split(/\r?\n/u).slice(0, 8),
+    "--- tail",
+    ...tailLines(fullText, 80)
+  ].join("\n");
+}
+function tailLines(text, limit) {
+  const lines = text.split(/\r?\n/u);
+  return lines.slice(Math.max(0, lines.length - limit));
+}
 function adaptShellCommand(command) {
   return adaptShellCommandForPlatform(command, process.platform);
 }
@@ -1391,6 +1682,149 @@ async function tryRipgrepFiles(input, context, root, limit) {
   if (!result) return null;
   return { matches: result.lines.slice(0, limit), truncated: result.truncated };
 }
+async function findSourcePackMatches(query, terms, context, limit) {
+  const indexMatches = sourcePackMatchesFromCandidates(query, context.sourcePackCandidates, limit);
+  if (indexMatches.length > 0) {
+    return { source: "index", matches: indexMatches };
+  }
+  const rgMatches = await tryRipgrepSourcePack(terms, context, limit);
+  if (rgMatches && rgMatches.length > 0) {
+    return { source: "rg", matches: rgMatches };
+  }
+  const matches = [];
+  for await (const filePath of listFiles(context.workspaceRoot, () => matches.length >= limit)) {
+    const content = await safeReadText(filePath, context);
+    if (content === null) continue;
+    const rel = relativePath(context.workspaceRoot, filePath);
+    const pathTerm = terms.find((item) => rel.toLowerCase().includes(item.toLowerCase()));
+    if (pathTerm) {
+      matches.push({
+        path: rel,
+        line: 1,
+        text: rel,
+        term: pathTerm,
+        source: "file_name",
+        confidence: 0.35,
+        reason: `fallback file name matched "${pathTerm}"`
+      });
+      if (matches.length >= limit) break;
+    }
+    const lines = content.split(/\r?\n/u);
+    for (const [index, line] of lines.entries()) {
+      const lower = line.toLowerCase();
+      const term = terms.find((item) => lower.includes(item.toLowerCase()));
+      if (!term) continue;
+      matches.push({
+        path: rel,
+        line: index + 1,
+        text: line,
+        term,
+        source: "local_scan",
+        confidence: 0.4,
+        reason: `fallback local scan matched "${term}" at line ${index + 1}`
+      });
+      if (matches.length >= limit) break;
+    }
+  }
+  return { source: matches[0]?.source ?? "local_scan", matches };
+}
+async function tryRipgrepSourcePack(terms, context, limit) {
+  const args = [
+    "--line-number",
+    "--no-heading",
+    "--color",
+    "never",
+    "--hidden",
+    "--no-ignore",
+    "--max-columns",
+    "500",
+    "-i",
+    "-F",
+    ...createRgExcludeArgs(context.workspaceRoot, context.workspaceRoot)
+  ];
+  for (const term of terms) {
+    args.push("-e", term);
+  }
+  args.push(".");
+  const result = await runRipgrep(
+    args,
+    context,
+    limit,
+    (line) => normalizeRgGrepLine(line, context.workspaceRoot)
+  );
+  if (!result) return null;
+  return result.lines.flatMap((line) => parseSourcePackRgLine(line, terms));
+}
+function parseSourcePackRgLine(line, terms) {
+  const firstColon = line.indexOf(":");
+  const secondColon = firstColon < 0 ? -1 : line.indexOf(":", firstColon + 1);
+  if (firstColon < 0 || secondColon < 0) return [];
+  const lineNumber = Number.parseInt(line.slice(firstColon + 1, secondColon), 10);
+  if (!Number.isInteger(lineNumber)) return [];
+  const text = line.slice(secondColon + 1).trim();
+  const lower = text.toLowerCase();
+  const term = terms.find((item) => lower.includes(item.toLowerCase())) ?? terms[0];
+  return [
+    {
+      path: line.slice(0, firstColon),
+      line: lineNumber,
+      text,
+      term,
+      source: "rg",
+      confidence: 0.6,
+      reason: `rg matched "${term}" at line ${lineNumber}`
+    }
+  ];
+}
+function sourcePackMatchesFromCandidates(query, candidates, limit) {
+  if (!candidates || candidates.length === 0) return [];
+  const terms = extractSourcePackTerms(query);
+  return candidates.slice(0, limit).map((candidate) => {
+    const start = Math.max(1, candidate.start);
+    const end = Math.max(start, candidate.end);
+    const term = terms[0] ?? query;
+    return {
+      path: candidate.path,
+      line: start,
+      text: candidate.reason ?? candidate.path,
+      term,
+      source: "index",
+      start,
+      end,
+      confidence: candidate.confidence ?? 0.85,
+      reason: candidate.reason ?? `index candidate for "${query}"`
+    };
+  });
+}
+function extractSourcePackTerms(query) {
+  const terms = query.split(/[^\p{L}\p{N}_.$/@-]+/u).map((term) => term.trim()).filter((term) => term.length >= 2 && !/^\d+$/u.test(term));
+  return unique(terms).slice(0, SOURCE_PACK_MAX_TERMS);
+}
+function estimateSourcePackConfidence(query, match) {
+  if (match.confidence !== void 0) return match.confidence;
+  const queryTerms = extractSourcePackTerms(query);
+  const haystack = `${match.path} ${match.text}`.toLowerCase();
+  const hitCount = queryTerms.filter((term) => haystack.includes(term.toLowerCase())).length;
+  const base = match.source === "index" ? 0.7 : match.source === "rg" ? 0.45 : 0.25;
+  const cap = match.source === "index" ? 0.95 : match.source === "rg" ? 0.75 : 0.55;
+  return Math.min(cap, base + hitCount * 0.15);
+}
+function formatSourcePackOutput(snippets, safetyTruncated) {
+  const lines = [];
+  for (const snippet of snippets) {
+    lines.push(
+      [
+        `${snippet.path}:${snippet.start}-${snippet.end}`,
+        `source: ${snippet.source}; reason: ${snippet.reason}; confidence: ${snippet.confidence.toFixed(2)}`,
+        snippet.content
+      ].join("\n")
+    );
+  }
+  if (safetyTruncated) {
+    lines.push("...\uFF08\u7ED3\u679C\u5DF2\u622A\u65AD\uFF0C\u540E\u7EED\u5185\u5BB9\u7701\u7565\uFF1B\u5982\u9700\u7CBE\u8BFB\u8BF7\u6307\u5B9A\u66F4\u5C0F\u8303\u56F4\u3002\uFF09");
+  }
+  return lines.join("\n\n");
+}
 function createRgExcludeArgs(root, workspaceRoot) {
   const searchRootRel = stripCurrentDirectoryPrefix(
     relative(workspaceRoot, root).replaceAll("\\", "/")
@@ -1512,9 +1946,16 @@ function globToRegExp(pattern) {
   }
   return new RegExp(result);
 }
-function runShell(command, cwd, timeoutMs, signal, onProgress) {
+function runShell(command, cwd, timeoutMs, signal, onProgress, trackChildProcess) {
   return new Promise((resolvePromise) => {
-    const child = spawn(command, { cwd, shell: true, windowsHide: true });
+    const detached = process.platform !== "win32";
+    const child = spawn(command, { cwd, shell: true, windowsHide: true, detached });
+    trackChildProcess?.(child, {
+      detached,
+      cwd,
+      label: `Bash:${command.slice(0, 80)}`,
+      retainAfterExit: detached
+    });
     let output = "";
     let settled = false;
     let forcedKillTimer;
@@ -1544,7 +1985,16 @@ function runShell(command, cwd, timeoutMs, signal, onProgress) {
         await stopWindowsProcessTree(child.pid, cwd);
         return;
       }
-      child.kill(force ? "SIGKILL" : "SIGTERM");
+      const signalName = force ? "SIGKILL" : "SIGTERM";
+      if (detached && child.pid) {
+        try {
+          process.kill(-child.pid, signalName);
+        } catch {
+          child.kill(signalName);
+        }
+      } else {
+        child.kill(signalName);
+      }
       if (force) {
         await waitForChildClose();
       }

package/dist/tools/Read/ReadTool.js

@@ -1,8 +1,8 @@
 import {
   ReadTool
-} from "../../chunk-RBHQ5WNR.js";
-import "../../chunk-HNIVNZIS.js";
+} from "../../chunk-TZ6QK52L.js";
 import "../../chunk-K3YDFDLP.js";
+import "../../chunk-HNIVNZIS.js";
 export {
   ReadTool
 };

package/dist/tools/ReadSnippets/ReadSnippetsTool.d.ts

@@ -0,0 +1,6 @@
+export declare const ReadSnippetsTool: {
+    readonly name: "ReadSnippets";
+    readonly prompt: "Use ReadSnippets to read multiple known file line ranges in one call. Prefer it after search, index, or codebase-memory hits return path/range candidates.";
+    readonly userFacingName: "读取代码片段";
+};
+//# sourceMappingURL=ReadSnippetsTool.d.ts.map

package/dist/tools/ReadSnippets/ReadSnippetsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadSnippetsTool.d.ts","sourceRoot":"","sources":["../../../src/tools/ReadSnippets/ReadSnippetsTool.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB;;;;CAA4D,CAAC"}

package/dist/tools/ReadSnippets/ReadSnippetsTool.js

@@ -0,0 +1,7 @@
+import {
+  ReadSnippetsTool
+} from "../../chunk-GI5XI4HN.js";
+import "../../chunk-WEWXKRKL.js";
+export {
+  ReadSnippetsTool
+};

package/dist/tools/ReadSnippets/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const prompt = "Use ReadSnippets to read multiple known file line ranges in one call. Prefer it after search, index, or codebase-memory hits return path/range candidates.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/tools/ReadSnippets/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/tools/ReadSnippets/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,+JAC2I,CAAC"}

package/dist/tools/ReadSnippets/prompt.js

@@ -0,0 +1,6 @@
+import {
+  prompt
+} from "../../chunk-WEWXKRKL.js";
+export {
+  prompt
+};

package/dist/tools/SourcePack/SourcePackTool.d.ts

@@ -0,0 +1,6 @@
+export declare const SourcePackTool: {
+    readonly name: "SourcePack";
+    readonly prompt: "Use SourcePack to locate a small evidence pack of candidate source snippets for a query. If index/codebase-memory already returned paths or ranges, call ReadSnippets on those candidates first.";
+    readonly userFacingName: "定位代码片段";
+};
+//# sourceMappingURL=SourcePackTool.d.ts.map

package/dist/tools/SourcePack/SourcePackTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourcePackTool.d.ts","sourceRoot":"","sources":["../../../src/tools/SourcePack/SourcePackTool.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;CAA0D,CAAC"}

package/dist/tools/SourcePack/SourcePackTool.js

@@ -0,0 +1,7 @@
+import {
+  SourcePackTool
+} from "../../chunk-A6FUAM64.js";
+import "../../chunk-YCO6C7KF.js";
+export {
+  SourcePackTool
+};

package/dist/tools/SourcePack/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const prompt = "Use SourcePack to locate a small evidence pack of candidate source snippets for a query. If index/codebase-memory already returned paths or ranges, call ReadSnippets on those candidates first.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/tools/SourcePack/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/tools/SourcePack/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,qMACiL,CAAC"}

package/dist/tools/SourcePack/prompt.js

@@ -0,0 +1,6 @@
+import {
+  prompt
+} from "../../chunk-YCO6C7KF.js";
+export {
+  prompt
+};

package/dist/tools/Todo/TodoTool.js

@@ -1,8 +1,8 @@
 import {
   TodoTool
-} from "../../chunk-4567YAXM.js";
-import "../../chunk-XZWSO5CM.js";
+} from "../../chunk-MFHY7PBM.js";
 import "../../chunk-SZFZPQGL.js";
+import "../../chunk-XZWSO5CM.js";
 export {
   TodoTool
 };

package/dist/tools/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAYhD,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAchD,CAAC"}

package/dist/tools/prompts.js

@@ -1,27 +1,31 @@
 import {
   toolPrompts
-} from "../chunk-KGDJAST5.js";
-import "../chunk-4EZHIDZ6.js";
-import "../chunk-YR4HWOR2.js";
-import "../chunk-VAFW24RN.js";
+} from "../chunk-DWXJBDPQ.js";
 import "../chunk-I3Z4OKMS.js";
 import "../chunk-PS2ZOFZ6.js";
 import "../chunk-NPKLGVDQ.js";
-import "../chunk-VJDLOFCF.js";
-import "../chunk-3RP665TH.js";
-import "../chunk-IOC3BSPT.js";
 import "../chunk-LGZOG7IQ.js";
 import "../chunk-ZYAEUABC.js";
 import "../chunk-SWK6XRZQ.js";
+import "../chunk-4EZHIDZ6.js";
+import "../chunk-YR4HWOR2.js";
+import "../chunk-VAFW24RN.js";
+import "../chunk-GI5XI4HN.js";
+import "../chunk-WEWXKRKL.js";
+import "../chunk-A6FUAM64.js";
+import "../chunk-YCO6C7KF.js";
+import "../chunk-MFHY7PBM.js";
+import "../chunk-SZFZPQGL.js";
+import "../chunk-XZWSO5CM.js";
 import "../chunk-AZCQL24J.js";
 import "../chunk-HUIZOB4A.js";
 import "../chunk-MK3YP2VR.js";
-import "../chunk-RBHQ5WNR.js";
-import "../chunk-HNIVNZIS.js";
+import "../chunk-VJDLOFCF.js";
+import "../chunk-3RP665TH.js";
+import "../chunk-IOC3BSPT.js";
+import "../chunk-TZ6QK52L.js";
 import "../chunk-K3YDFDLP.js";
-import "../chunk-4567YAXM.js";
-import "../chunk-XZWSO5CM.js";
-import "../chunk-SZFZPQGL.js";
+import "../chunk-HNIVNZIS.js";
 import "../chunk-DN3KJZRV.js";
 import "../chunk-2U4BZXAI.js";
 import "../chunk-ITBZHMZQ.js";

package/dist/tools/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/tools/ui.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAYxD,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/tools/ui.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAcxD,CAAC"}

package/dist/tools/ui.js

@@ -1,27 +1,31 @@
 import {
   toolUserFacingNames
-} from "../chunk-NKWRH36V.js";
-import "../chunk-4EZHIDZ6.js";
-import "../chunk-YR4HWOR2.js";
-import "../chunk-VAFW24RN.js";
+} from "../chunk-2R75FXZG.js";
 import "../chunk-I3Z4OKMS.js";
 import "../chunk-PS2ZOFZ6.js";
 import "../chunk-NPKLGVDQ.js";
-import "../chunk-VJDLOFCF.js";
-import "../chunk-3RP665TH.js";
-import "../chunk-IOC3BSPT.js";
 import "../chunk-LGZOG7IQ.js";
 import "../chunk-ZYAEUABC.js";
 import "../chunk-SWK6XRZQ.js";
+import "../chunk-4EZHIDZ6.js";
+import "../chunk-YR4HWOR2.js";
+import "../chunk-VAFW24RN.js";
+import "../chunk-GI5XI4HN.js";
+import "../chunk-WEWXKRKL.js";
+import "../chunk-A6FUAM64.js";
+import "../chunk-YCO6C7KF.js";
+import "../chunk-MFHY7PBM.js";
+import "../chunk-SZFZPQGL.js";
+import "../chunk-XZWSO5CM.js";
 import "../chunk-AZCQL24J.js";
 import "../chunk-HUIZOB4A.js";
 import "../chunk-MK3YP2VR.js";
-import "../chunk-RBHQ5WNR.js";
-import "../chunk-HNIVNZIS.js";
+import "../chunk-VJDLOFCF.js";
+import "../chunk-3RP665TH.js";
+import "../chunk-IOC3BSPT.js";
+import "../chunk-TZ6QK52L.js";
 import "../chunk-K3YDFDLP.js";
-import "../chunk-4567YAXM.js";
-import "../chunk-XZWSO5CM.js";
-import "../chunk-SZFZPQGL.js";
+import "../chunk-HNIVNZIS.js";
 import "../chunk-DN3KJZRV.js";
 import "../chunk-2U4BZXAI.js";
 import "../chunk-ITBZHMZQ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linghun/tools",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",

package/dist/{chunk-4567YAXM.js → chunk-MFHY7PBM.js}

@@ -1,9 +1,9 @@
-import {
-  userFacingName
-} from "./chunk-XZWSO5CM.js";
 import {
   prompt
 } from "./chunk-SZFZPQGL.js";
+import {
+  userFacingName
+} from "./chunk-XZWSO5CM.js";
 
 // src/tools/Todo/TodoTool.ts
 var TodoTool = { name: "Todo", prompt, userFacingName };

package/dist/{chunk-RBHQ5WNR.js → chunk-TZ6QK52L.js}

@@ -1,9 +1,9 @@
-import {
-  prompt
-} from "./chunk-HNIVNZIS.js";
 import {
   userFacingName
 } from "./chunk-K3YDFDLP.js";
+import {
+  prompt
+} from "./chunk-HNIVNZIS.js";
 
 // src/tools/Read/ReadTool.ts
 var ReadTool = { name: "Read", prompt, userFacingName };