@jarkkojs/readseek-api 0.11.1 → 0.11.3

package/dist/contract.d.ts

@@ -12,7 +12,6 @@ export declare const PARAM_DESCRIPTIONS: {
     readonly projectSearchPath: "File or directory to search; defaults to the project directory";
     readonly searchPath: "File or directory to search; defaults to the current directory";
     readonly language: "Language override when auto-detection is ambiguous";
-    readonly languageOverride: "Language override";
     readonly languageSymbol: "Language override for symbol replacement";
     readonly pattern: "AST pattern (ast-grep style), such as console.log($$$ARGS)";
     readonly patternContext: "Surrounding code context for sub-statement patterns";
@@ -29,14 +28,10 @@ export declare const PARAM_DESCRIPTIONS: {
     readonly end: "Last line to include";
     readonly limit: "Maximum number of lines to include";
     readonly depth: "Maximum structural depth for structure output; defaults to 1 in agent tools";
-    readonly offset: "One-based starting line";
-    readonly readLimit: "Maximum lines to return";
-    readonly symbolRead: "Symbol name to read";
-    readonly bundle: "Include related symbols from the same file; requires symbol";
     readonly level: "Explicit inference level: low (default), medium, or high";
     readonly include: "Additional caption tasks: text and/or objects";
     readonly kind: "Restrict structure to this node kind";
-    readonly outline: "Return a symbol outline";
+    readonly outline: "Show outline of document hierarchy or source symbols";
     readonly noAnchors: "Omit source line anchors";
     readonly text: "Literal native text query; adapter find_text also supports regex via pattern";
     readonly edits: "Use set_line, replace_lines, insert_after, replace_symbol, or replace";
@@ -92,6 +87,7 @@ export declare const TOOL_DESCRIPTIONS: {
     readonly rename_symbol: "Rename a symbol at a line or hash cursor with binding-aware edits and stale-plan protection.";
     readonly write_file: "Create or replace a complete text file and return `LINE:HASH` anchors. Use `edit_text` for small changes.";
 };
+export declare function rewriteBacktickedToolNames(text: string, aliases?: Readonly<Partial<Record<ToolName, string>>>): string;
 export declare function renderToolDescription(name: ToolName, aliases?: Readonly<Partial<Record<ToolName, string>>>): string;
 export type JsonSchema = {
     type: "object";

package/dist/index.js

@@ -32,7 +32,6 @@ var PARAM_DESCRIPTIONS = {
   projectSearchPath: "File or directory to search; defaults to the project directory",
   searchPath: "File or directory to search; defaults to the current directory",
   language: "Language override when auto-detection is ambiguous",
-  languageOverride: "Language override",
   languageSymbol: "Language override for symbol replacement",
   pattern: "AST pattern (ast-grep style), such as console.log($$$ARGS)",
   patternContext: "Surrounding code context for sub-statement patterns",
@@ -49,14 +48,10 @@ var PARAM_DESCRIPTIONS = {
   end: "Last line to include",
   limit: "Maximum number of lines to include",
   depth: "Maximum structural depth for structure output; defaults to 1 in agent tools",
-  offset: "One-based starting line",
-  readLimit: "Maximum lines to return",
-  symbolRead: "Symbol name to read",
-  bundle: "Include related symbols from the same file; requires symbol",
   level: "Explicit inference level: low (default), medium, or high",
   include: "Additional caption tasks: text and/or objects",
   kind: "Restrict structure to this node kind",
-  outline: "Return a symbol outline",
+  outline: "Show outline of document hierarchy or source symbols",
   noAnchors: "Omit source line anchors",
   text: "Literal native text query; adapter find_text also supports regex via pattern",
   edits: "Use set_line, replace_lines, insert_after, replace_symbol, or replace",
@@ -112,11 +107,14 @@ var TOOL_DESCRIPTIONS = {
   rename_symbol: "Rename a symbol at a line or hash cursor with binding-aware edits and stale-plan protection.",
   write_file: "Create or replace a complete text file and return `LINE:HASH` anchors. Use `edit_text` for small changes."
 };
+function rewriteBacktickedToolNames(text, aliases = {}) {
+  return TOOL_NAMES.reduce((rewritten, toolName) => rewritten.replaceAll(`\`${toolName}\``, `\`${aliases[toolName] ?? toolName}\``), text);
+}
 function renderToolDescription(name, aliases = {}) {
   const desc = TOOL_DESCRIPTIONS[name];
   if (!desc)
     throw new Error(`Missing TOOL_DESCRIPTIONS for ${name}`);
-  return TOOL_NAMES.reduce((description, toolName) => description.replaceAll(`\`${toolName}\``, `\`${aliases[toolName] ?? toolName}\``), desc);
+  return rewriteBacktickedToolNames(desc, aliases);
 }
 var gitScopeSchema = {
   gitScope: {
@@ -205,7 +203,7 @@ var TOOL_CONTRACTS = [
   tool("show_metadata", "Show metadata", { ...path, ...lang, ...stdin }, ["path"]),
   tool("show_assets", "Show assets", { ...path, at: string(PARAM_DESCRIPTIONS.assetAt), ...stdin }, ["path"]),
   tool("check_syntax", "Check syntax", { ...path, ...lang, ...stdin }, ["path"]),
-  tool("check_rules", "Check rules", { ...path, ...gitScopeSchema, rules: string(PARAM_DESCRIPTIONS.rules) }, ["rules"]),
+  tool("check_rules", "Check rules", { path: string(PARAM_DESCRIPTIONS.searchPath), ...gitScopeSchema, rules: string(PARAM_DESCRIPTIONS.rules) }, ["rules"]),
   tool("generate_caption", "Generate caption", { ...path, ...at, ...stdin, ...level, include: { type: "array", items: { type: "string", enum: ["text", "objects"] }, minItems: 1, uniqueItems: true, description: PARAM_DESCRIPTIONS.include } }, ["path"]),
   tool("detect_objects", "Detect objects", { ...path, ...at, ...stdin, ...level }, ["path"]),
   tool("recognize_text", "Recognize text", { ...path, ...at, ...stdin, ...level }, ["path"]),
@@ -277,12 +275,12 @@ var PREFERENCE_LEADS = {
   show_content: "Preferred for reading source with anchors.",
   edit_text: "Preferred for editing existing text files with fresh LINE:HASH anchors.",
   write_file: "Preferred for creating or replacing a complete text file; returns LINE:HASH anchors.",
-  find_text: "Preferred text/regex find_nodes; returns edit_text-ready LINE:HASH anchors.",
-  find_nodes: "Preferred for AST or structural code find_nodes with ast-find_text-style patterns.",
+  find_text: "Preferred text/regex search; returns edit-ready LINE:HASH anchors.",
+  find_nodes: "Preferred for AST or structural code search with ast-grep-style patterns.",
   find_definitions: "Preferred for go-to-definition or declaration lookup by name.",
   find_references: "Preferred for finding identifier-name matches or binding-specific references before rename_symbol or delete.",
   rename_symbol: "Preferred for renaming a symbol with binding-aware, verified edits.",
-  show_assets: "Preferred for saving a selected document asset to a file."
+  show_assets: "Preferred for materializing selected document assets with usable cached paths."
 };
 var FALLBACK_TEMPLATES = {
   read: "Prefer `show_content` with fresh LINE:HASH anchors.",
@@ -294,9 +292,6 @@ var FALLBACK_TEMPLATES = {
 function resolveToolName(name, aliases = {}) {
   return aliases[name] ?? name;
 }
-function rewriteBacktickedToolNames(text, aliases = {}) {
-  return TOOL_NAMES.reduce((rewritten, toolName) => rewritten.replaceAll(`\`${toolName}\``, `\`${resolveToolName(toolName, aliases)}\``), text);
-}
 function renderCompactGuidelines(name, aliases = {}) {
   return (TOOL_COMPACT_GUIDELINES[name] ?? []).map((guideline) => rewriteBacktickedToolNames(guideline, aliases));
 }
@@ -320,15 +315,6 @@ function renderToolRoutingPolicy(options = {}) {
   const find_references = resolveToolName("find_references", aliases);
   const rename_symbol = resolveToolName("rename_symbol", aliases);
   const show_assets = resolveToolName("show_assets", aliases);
-  if (options.style === "server") {
-    return [
-      "Structural code navigation, document inspection, and hash-verified edits with readseek.",
-      "For structural questions, prefer these tools to text Grep/Bash: targeted definitions, references, and AST patterns; shallow show_structure views; check_syntax diagnostics and show_content cursor context; and document inspection.",
-      `Use ${edit_text} for LINE:HASH-anchored mutations (preview with apply=false; apply defaults to true and re-checks plan_hash).`,
-      "Paths resolve against CLAUDE_PROJECT_DIR. Native Read/Grep/Edit hooks provide passive context;",
-      "call MCP tools for active navigation, document questions, or anchored edits."
-    ].join(" ");
-  }
   const title = options.title ?? "ReadSeek tool policy:";
   const bullets = [];
   if (options.preferOverBuiltIns) {
@@ -1363,10 +1349,10 @@ function text(value) {
 function count(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
 }
-function safe(value) {
+function safe(value, preserveTabs = false) {
   return value.replace(/[\x00-\x09\x0b-\x1f\x7f-\x9f]/g, (char) => {
     if (char === "\t")
-      return "\\t";
+      return preserveTabs ? char : "\\t";
     if (char === "\r")
       return "\\r";
     return `\\x${char.charCodeAt(0).toString(16).padStart(2, "0")}`;
@@ -1526,7 +1512,7 @@ ${assetList(assets)}`);
     const lang = text(metadata.language || content.language);
     if (lang)
       summary.push(inline(lang));
-    const rows = lines.map((line) => `${line.line}${options.noAnchors ? "" : `:${text(line.hash)}`} | ${safe(text(line.text)).replaceAll("\\n", "\\\\n")}`);
+    const rows = lines.map((line) => `${line.line}${options.noAnchors ? "" : `:${text(line.hash)}`} | ${safe(text(line.text), true)}`);
     const identifier = record(cursor.identifier);
     if (count(cursor.line) !== undefined)
       result.metadata.line = cursor.line;

package/dist/policy.d.ts

@@ -1,4 +1,5 @@
 import { type ToolName } from "./contract.ts";
+export { rewriteBacktickedToolNames } from "./contract.ts";
 export type ToolAliasMap = Readonly<Partial<Record<ToolName, string>>>;
 export type ReplaceableTool = {
     tool: ToolName;
@@ -9,7 +10,6 @@ export declare const REPLACEABLE_TOOLS: readonly ReplaceableTool[];
 export declare const TOOL_COMPACT_GUIDELINES: Readonly<Partial<Record<ToolName, readonly string[]>>>;
 export declare const BUILTIN_FALLBACKS: Readonly<Record<string, ToolName>>;
 export declare function resolveToolName(name: ToolName, aliases?: ToolAliasMap): string;
-export declare function rewriteBacktickedToolNames(text: string, aliases?: ToolAliasMap): string;
 export declare function renderCompactGuidelines(name: ToolName, aliases?: ToolAliasMap): string[];
 export declare function renderPreferredToolDescription(name: ToolName, aliases?: ToolAliasMap): string;
 export declare function renderFallbackToolDescription(builtIn: string, aliases?: ToolAliasMap): string | undefined;
@@ -18,7 +18,6 @@ export type ToolRoutingPolicyOptions = {
     title?: string;
     preferOverBuiltIns?: boolean;
     demoteBuiltIns?: readonly string[];
-    style?: "bullets" | "server";
 };
 export declare function renderToolRoutingPolicy(options?: ToolRoutingPolicyOptions): string;
 export declare function preferredToolDescriptionMap(aliases?: ToolAliasMap): Readonly<Record<string, string>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jarkkojs/readseek-api",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "description": "Shared ReadSeek CLI contract, validation, argv builders, and bounded process runners",
   "type": "module",
   "license": "Apache-2.0",
@@ -51,7 +51,7 @@
     "vitest": "^4.1.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.11.1",
+    "@jarkkojs/readseek": "^0.11.3",
     "@bgotink/kdl": "0.4.0",
     "@sinclair/typebox": "0.34.52"
   }