@cortexkit/aft-pi 0.30.3 → 0.31.1

package/dist/config.d.ts

@@ -107,7 +107,7 @@ export interface AftConfig {
     semantic?: SemanticConfig;
     /**
      * Maximum source files allowed for call-graph operations (callers, trace_to,
-     * trace_data, impact). Projects above this size return `project_too_large`.
+     * trace_to_symbol, trace_data, impact). Projects above this size return `project_too_large`.
      * Default: 20000 (applied Rust-side; undefined here means "use default").
      */
     max_callgraph_files?: number;

package/dist/index.d.ts

@@ -17,7 +17,7 @@
  *   - aft_outline    Structural outline (symbols, headings) for files/URLs
  *   - aft_zoom       Symbol-level inspection with call-graph annotations
  *   - aft_search     Semantic search (when semantic_search=true)
- *   - aft_navigate   Call-graph navigation (callers, call_tree, impact, trace_to, trace_data)
+ *   - aft_navigate   Call-graph navigation (callers, call_tree, impact, trace_to, trace_to_symbol, trace_data)
  *   - aft_conflicts  One-call merge conflict inspection
  *   - aft_import     Language-aware import add/remove/organize
  *   - aft_safety     Per-file undo, checkpoints, restore
@@ -61,6 +61,7 @@ declare function resolveToolSurface(config: ReturnType<typeof loadAftConfig>): {
     hoistWrite: boolean;
     hoistEdit: boolean;
     hoistGrep: boolean;
+    restrictToProjectRoot: boolean;
     outline: boolean;
     zoom: boolean;
     semantic: boolean;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AASpE,OAAO,EACL,KAAK,SAAS,EACd,aAAa,EAId,MAAM,aAAa,CAAC;AA6DrB,KAAK,mBAAmB,GAAG;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF,iBAAS,4BAA4B,CACnC,OAAO,EAAE,MAAM,mBAAmB,GAAG,SAAS,EAC9C,sBAAsB,GAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAgB,IAOrE,eAAe,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyCjF;AA6DD,iBAAS,wBAAwB,CAC/B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,iBAAiB,GAAG,UAAU,CAAC,GACtD,OAAO,CAGT;AAED,iBAAS,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9E;AASD,iBAAe,iCAAiC,CAAC,OAAO,EAAE;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC,OAAO,uBAAuB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACnE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED;;;;;;;;GAQG;AACH,iBAAS,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GAAG;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAiEA;AAED;;;;GAIG;AACH,yBAA+B,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkc9D;AAED,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AASpE,OAAO,EACL,KAAK,SAAS,EACd,aAAa,EAId,MAAM,aAAa,CAAC;AA6DrB,KAAK,mBAAmB,GAAG;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF,iBAAS,4BAA4B,CACnC,OAAO,EAAE,MAAM,mBAAmB,GAAG,SAAS,EAC9C,sBAAsB,GAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAgB,IAOrE,eAAe,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyCjF;AA6DD,iBAAS,wBAAwB,CAC/B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,iBAAiB,GAAG,UAAU,CAAC,GACtD,OAAO,CAGT;AAED,iBAAS,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9E;AASD,iBAAe,iCAAiC,CAAC,OAAO,EAAE;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC,OAAO,uBAAuB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACnE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED;;;;;;;;GAQG;AACH,iBAAS,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GAAG;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAwEA;AAED;;;;GAIG;AACH,yBAA+B,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkc9D;AAED,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAC"}

package/dist/index.js

@@ -13035,7 +13035,7 @@ async function ensureStorageMigrated(opts) {
 import { execFileSync } from "node:child_process";
 import { createHash as createHash2 } from "node:crypto";
 import { chmodSync as chmodSync3, closeSync as closeSync2, copyFileSync as copyFileSync2, createWriteStream as createWriteStream2, existsSync as existsSync5, lstatSync, mkdirSync as mkdirSync5, openSync as openSync2, readdirSync, readFileSync as readFileSync3, readlinkSync, realpathSync, rmSync as rmSync2, statSync as statSync2, symlinkSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { basename, dirname as dirname3, join as join6, relative, resolve } from "node:path";
+import { basename, dirname as dirname3, isAbsolute, join as join6, relative, resolve, win32 } from "node:path";
 import { Readable as Readable2 } from "node:stream";
 import { pipeline as pipeline2 } from "node:stream/promises";
 var ORT_VERSION = "1.24.4";
@@ -13238,6 +13238,29 @@ function isOnnxVersionCompatible(version) {
     return false;
   return minor >= REQUIRED_ORT_MIN_MINOR;
 }
+function pathEnvValue() {
+  return process.env.PATH ?? process.env.Path ?? process.env.path ?? "";
+}
+function pathEntriesForPlatform() {
+  const delimiter = process.platform === "win32" ? ";" : ":";
+  return pathEnvValue().split(delimiter).map((entry) => entry.trim().replace(/^"|"$/g, "")).filter((entry) => {
+    if (!entry || entry === "." || entry.includes("\x00"))
+      return false;
+    return isAbsolute(entry) || win32.isAbsolute(entry);
+  });
+}
+function directoryContainsLibrary(dir, libName) {
+  try {
+    const entries = readdirSync(dir);
+    if (process.platform === "win32") {
+      const expected = libName.toLowerCase();
+      return entries.some((entry) => entry.toLowerCase() === expected);
+    }
+    return entries.includes(libName);
+  } catch {
+    return false;
+  }
+}
 function findSystemOnnxRuntime(libName) {
   if (!libName)
     return null;
@@ -13246,9 +13269,15 @@ function findSystemOnnxRuntime(libName) {
     searchPaths.push("/opt/homebrew/lib", "/usr/local/lib");
   } else if (process.platform === "linux") {
     searchPaths.push("/usr/lib", "/usr/lib/x86_64-linux-gnu", "/usr/lib/aarch64-linux-gnu", "/usr/local/lib");
+  } else if (process.platform === "win32") {
+    searchPaths.push(...pathEntriesForPlatform());
   }
+  const seen = new Set;
   for (const dir of searchPaths) {
-    if (!existsSync5(join6(dir, libName)))
+    if (seen.has(dir))
+      continue;
+    seen.add(dir);
+    if (!directoryContainsLibrary(dir, libName))
       continue;
     const version = detectOnnxVersion(dir, libName);
     if (version && !isOnnxVersionCompatible(version)) {
@@ -13827,6 +13856,36 @@ function formatZoomText(targetLabel, response) {
   return out.join(`
 `);
 }
+function formatZoomMultiTargetResult(entries) {
+  const rendered = entries.map((entry) => {
+    const { targetLabel, name, response } = entry;
+    if (response.success === false) {
+      const message = typeof response.message === "string" && response.message.length > 0 ? response.message : "zoom failed";
+      return { targetLabel, name, success: false, error: message };
+    }
+    return {
+      targetLabel,
+      name,
+      success: true,
+      content: formatZoomText(targetLabel, response)
+    };
+  });
+  const complete = rendered.every((entry) => entry.success);
+  const sections = [];
+  if (!complete) {
+    sections.push("Incomplete zoom results: one or more symbols failed.");
+  }
+  for (const entry of rendered) {
+    if (entry.success) {
+      sections.push(entry.content ?? "");
+    } else {
+      sections.push(`Symbol "${entry.name}" not found in ${entry.targetLabel}: ${entry.error ?? "zoom failed"}`);
+    }
+  }
+  return { complete, entries: rendered, text: sections.join(`
+
+`) };
+}
 // src/logger.ts
 import * as fs from "node:fs";
 import * as os from "node:os";
@@ -14475,7 +14534,7 @@ import {
 // package.json
 var package_default = {
   name: "@cortexkit/aft-pi",
-  version: "0.30.3",
+  version: "0.31.1",
   type: "module",
   description: "Pi coding agent extension for Agent File Tools (AFT) — tree-sitter and LSP-powered code analysis",
   main: "dist/index.js",
@@ -14497,7 +14556,7 @@ var package_default = {
     prepublishOnly: "bun run build"
   },
   dependencies: {
-    "@cortexkit/aft-bridge": "0.30.3",
+    "@cortexkit/aft-bridge": "0.31.1",
     "@xterm/headless": "^5.5.0",
     "comment-json": "^5.0.0",
     diff: "^8.0.4",
@@ -14505,12 +14564,12 @@ var package_default = {
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.30.3",
-    "@cortexkit/aft-darwin-x64": "0.30.3",
-    "@cortexkit/aft-linux-arm64": "0.30.3",
-    "@cortexkit/aft-linux-x64": "0.30.3",
-    "@cortexkit/aft-win32-arm64": "0.30.3",
-    "@cortexkit/aft-win32-x64": "0.30.3"
+    "@cortexkit/aft-darwin-arm64": "0.31.1",
+    "@cortexkit/aft-darwin-x64": "0.31.1",
+    "@cortexkit/aft-linux-arm64": "0.31.1",
+    "@cortexkit/aft-linux-x64": "0.31.1",
+    "@cortexkit/aft-win32-arm64": "0.31.1",
+    "@cortexkit/aft-win32-x64": "0.31.1"
   },
   devDependencies: {
     "@earendil-works/pi-coding-agent": "*",
@@ -14723,6 +14782,7 @@ function coerceOptionalInt(v, paramName, min, max) {
 var LONG_RUNNING_COMMAND_TIMEOUT_MS = {
   callers: 60000,
   trace_to: 60000,
+  trace_to_symbol: 60000,
   trace_data: 60000,
   impact: 60000,
   grep: 60000,
@@ -14732,6 +14792,68 @@ var LONG_RUNNING_COMMAND_TIMEOUT_MS = {
 function timeoutForCommand(command) {
   return LONG_RUNNING_COMMAND_TIMEOUT_MS[command];
 }
+function asPlainObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return;
+  return value;
+}
+function candidateLocation(candidate) {
+  const file = typeof candidate.file === "string" && candidate.file.length > 0 ? candidate.file : undefined;
+  if (!file)
+    return;
+  const line = typeof candidate.line === "number" && Number.isFinite(candidate.line) ? candidate.line : undefined;
+  return line === undefined ? file : `${file}:${line}`;
+}
+function stringifyData(data) {
+  if (data === undefined)
+    return;
+  try {
+    return JSON.stringify(data, null, 2);
+  } catch {
+    return String(data);
+  }
+}
+function formatBridgeErrorMessage(command, response, params = {}) {
+  const code = typeof response.code === "string" && response.code.length > 0 ? response.code : undefined;
+  const message = typeof response.message === "string" && response.message.length > 0 ? response.message : `${command} failed`;
+  const data = asPlainObject(response.data);
+  const rawCandidates = Array.isArray(response.candidates) ? response.candidates : Array.isArray(data?.candidates) ? data.candidates : undefined;
+  const rawSymbol = typeof response.symbol === "string" && response.symbol.length > 0 ? response.symbol : typeof data?.symbol === "string" && data.symbol.length > 0 ? data.symbol : undefined;
+  if (code === "ambiguous_target" || code === "target_symbol_not_in_file") {
+    const candidates = (rawCandidates ?? []).map(asPlainObject).filter((candidate) => candidate !== undefined).map(candidateLocation).filter((candidate) => candidate !== undefined);
+    if (candidates.length > 0) {
+      const symbol = typeof params.toSymbol === "string" && params.toSymbol.length > 0 ? params.toSymbol : rawSymbol;
+      const target = symbol ? `multiple symbols named "${symbol}"` : message.replace(/[.!?]+$/, "");
+      const action = code === "ambiguous_target" ? "Pass toFile to disambiguate" : "Try one of these files for toFile";
+      return `${command}: ${code} — ${target}. ${action}:
+${candidates.map((candidate) => `  - ${candidate}`).join(`
+`)}`;
+    }
+  }
+  if (!code)
+    return message;
+  const lines = [`${command}: ${code} — ${message}`];
+  const extras = collectStructuredExtras(response);
+  if (extras)
+    lines.push(`data: ${extras}`);
+  return lines.join(`
+`);
+}
+function collectStructuredExtras(response) {
+  const reserved = new Set(["id", "success", "code", "message", "data"]);
+  const extras = {};
+  for (const [key, value] of Object.entries(response)) {
+    if (reserved.has(key))
+      continue;
+    extras[key] = value;
+  }
+  if (Object.keys(extras).length === 0) {
+    return stringifyData(response.data);
+  }
+  if (response.data !== undefined)
+    extras.data = response.data;
+  return stringifyData(extras);
+}
 function bridgeFor(ctx, cwd) {
   return ctx.pool.getBridge(cwd);
 }
@@ -14754,8 +14876,7 @@ async function callBridge(bridge, command, params = {}, extCtx, options) {
   };
   const response = await bridge.send(command, merged, Object.keys(sendOptions).length > 0 ? sendOptions : undefined);
   if (response.success === false) {
-    const message = typeof response.message === "string" && response.message.length > 0 ? response.message : `${command} failed`;
-    throw new Error(message);
+    throw new Error(formatBridgeErrorMessage(command, response, merged));
   }
   ingestBgCompletions(sessionId, response.bg_completions);
   return response;
@@ -31708,7 +31829,7 @@ function createBashStatusTool(ctx) {
   return {
     name: "bash_status",
     label: "bash_status",
-    description: "Read-only snapshot of a background bash task. Returns immediately. Use bash_watch to block on or register for pattern matches and exit events.",
+    description: "Read-only snapshot of a background bash task. Returns immediately. Never waits. Use bash_watch to block on or register for pattern matches and exit events.",
     promptSnippet: "Inspect a background bash task by task_id",
     parameters: BashStatusParams,
     async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
@@ -32170,8 +32291,12 @@ var DeleteParams = Type5.Object({
   }))
 });
 var MoveParams = Type5.Object({
-  filePath: Type5.String({ description: "Source file path to move" }),
-  destination: Type5.String({ description: "Destination file path" })
+  filePath: Type5.String({
+    description: "Source file path to move (absolute or relative to project root)"
+  }),
+  destination: Type5.String({
+    description: "Destination file path (absolute or relative to project root)"
+  })
 });
 function renderFsCall(toolName, args, theme, context) {
   if (toolName === "aft_delete") {
@@ -32274,7 +32399,7 @@ function registerFsTools(pi, ctx, surface) {
 // src/tools/hoisted.ts
 import { stat } from "node:fs/promises";
 import { homedir as homedir9 } from "node:os";
-import { isAbsolute, relative as relative3, resolve as resolve3 } from "node:path";
+import { isAbsolute as isAbsolute2, relative as relative3, resolve as resolve3, sep } from "node:path";
 import {
   renderDiff as renderDiff2
 } from "@earendil-works/pi-coding-agent";
@@ -32386,32 +32511,76 @@ function formatDiffForPi(oldContent, newContent, contextLines = DEFAULT_CONTEXT_
 // src/tools/hoisted.ts
 function containsPath(parent, child) {
   const rel = relative3(parent, child);
-  return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
+  return rel === "" || !rel.startsWith("..") && !isAbsolute2(rel);
+}
+function expandTilde(path2) {
+  if (!path2 || !path2.startsWith("~"))
+    return path2;
+  if (path2 === "~")
+    return homedir9();
+  if (path2.startsWith(`~${sep}`) || path2.startsWith("~/")) {
+    return resolve3(homedir9(), path2.slice(2));
+  }
+  return path2;
 }
-async function assertExternalDirectoryPermission(extCtx, target, action = "modify") {
+function externalDirectoryPromptTimeoutMs() {
+  const raw = process.env.AFT_PI_EXTERNAL_PROMPT_TIMEOUT_MS;
+  if (raw === undefined)
+    return 30000;
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 30000;
+}
+async function assertExternalDirectoryPermission(extCtx, target, action = "modify", options = {}) {
   if (!target)
     return;
-  const absoluteTarget = isAbsolute(target) ? target : resolve3(extCtx.cwd, target);
+  const expanded = expandTilde(target);
+  const absoluteTarget = isAbsolute2(expanded) ? expanded : resolve3(extCtx.cwd, expanded);
   if (containsPath(extCtx.cwd, absoluteTarget))
     return;
-  const confirmed = await extCtx.ui?.confirm?.("Allow external directory access?", `AFT wants to ${action} outside the project: ${absoluteTarget}`);
-  if (confirmed === true)
+  if (options.restrictToProjectRoot === false)
     return;
-  throw new Error("Permission denied: external directory access was cancelled.");
+  const confirmFn = extCtx.ui?.confirm;
+  if (extCtx.hasUI === false || !confirmFn) {
+    throw new Error(`Permission denied: cannot prompt for ${action} outside the project (${absoluteTarget}).`);
+  }
+  const timeoutMs = externalDirectoryPromptTimeoutMs();
+  let timer;
+  const timeoutPromise = new Promise((resolve4) => {
+    timer = setTimeout(() => resolve4("timeout"), timeoutMs);
+  });
+  try {
+    const result = await Promise.race([
+      confirmFn("Allow external directory access?", `AFT wants to ${action} outside the project: ${absoluteTarget}`),
+      timeoutPromise
+    ]);
+    if (result === true)
+      return;
+    if (result === "timeout") {
+      throw new Error(`Permission denied: external directory prompt timed out after ${timeoutMs}ms.`);
+    }
+    throw new Error("Permission denied: external directory access was cancelled.");
+  } finally {
+    if (timer !== undefined)
+      clearTimeout(timer);
+  }
 }
 var ReadParams = Type6.Object({
-  path: Type6.String({ description: "Path to the file to read (relative or absolute)" }),
+  path: Type6.String({
+    description: "Path to the file to read (absolute or relative to project root)"
+  }),
   offset: optionalInt(1, Number.MAX_SAFE_INTEGER),
   limit: optionalInt(1, Number.MAX_SAFE_INTEGER)
 });
 var WriteParams = Type6.Object({
   filePath: Type6.String({
-    description: "Path to the file to write (absolute or project-relative)"
+    description: "Path to the file to write (absolute or relative to project root)"
   }),
   content: Type6.String({ description: "Full file contents to write" })
 });
 var EditParams = Type6.Object({
-  filePath: Type6.String({ description: "Path to the file to edit" }),
+  filePath: Type6.String({
+    description: "Path to the file to edit (absolute or relative to project root)"
+  }),
   oldString: Type6.Optional(Type6.String({ description: "Text to find (exact match, fuzzy fallback)" })),
   newString: Type6.Optional(Type6.String({ description: "Replacement text (omit to delete match)" })),
   replaceAll: Type6.Optional(Type6.Boolean({ description: "Replace every occurrence" })),
@@ -32422,7 +32591,9 @@ var EditParams = Type6.Object({
 });
 var GrepParams = Type6.Object({
   pattern: Type6.String({ description: "Regex pattern to search for" }),
-  path: Type6.Optional(Type6.String({ description: "Path scope (file or directory)" })),
+  path: Type6.Optional(Type6.String({
+    description: "Path scope (file or directory; absolute or relative to project root)"
+  })),
   include: Type6.Optional(Type6.String({ description: "Glob filter for included files (e.g. '*.ts,*.tsx')" })),
   caseSensitive: Type6.Optional(Type6.Boolean({ description: "Case-sensitive matching" })),
   contextLines: optionalInt(1, Number.MAX_SAFE_INTEGER)
@@ -32472,7 +32643,9 @@ function registerHoistedTools(pi, ctx, surface) {
       promptGuidelines: ["Use write only for new files or complete rewrites."],
       parameters: WriteParams,
       async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
-        await assertExternalDirectoryPermission(extCtx, params.filePath, "modify");
+        await assertExternalDirectoryPermission(extCtx, params.filePath, "modify", {
+          restrictToProjectRoot: surface.restrictToProjectRoot
+        });
         const bridge = bridgeFor(ctx, extCtx.cwd);
         const response = await callBridge(bridge, "write", {
           file: params.filePath,
@@ -32503,7 +32676,9 @@ function registerHoistedTools(pi, ctx, surface) {
       ],
       parameters: EditParams,
       async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
-        await assertExternalDirectoryPermission(extCtx, params.filePath, "modify");
+        await assertExternalDirectoryPermission(extCtx, params.filePath, "modify", {
+          restrictToProjectRoot: surface.restrictToProjectRoot
+        });
         const bridge = bridgeFor(ctx, extCtx.cwd);
         if (typeof params.appendContent === "string") {
           const req2 = {
@@ -32551,7 +32726,9 @@ function registerHoistedTools(pi, ctx, surface) {
         const bridge = bridgeFor(ctx, extCtx.cwd);
         const req = { pattern: params.pattern };
         if (params.path) {
-          await assertExternalDirectoryPermission(extCtx, params.path, "search");
+          await assertExternalDirectoryPermission(extCtx, params.path, "search", {
+            restrictToProjectRoot: surface.restrictToProjectRoot
+          });
           req.path = await resolvePathArg(extCtx.cwd, params.path);
         }
         if (params.include)
@@ -32724,12 +32901,13 @@ function shortenPath2(path2) {
   return path2;
 }
 async function resolvePathArg(cwd, path2) {
-  const abs = resolve3(cwd, path2);
+  const expanded = expandTilde(path2);
+  const abs = isAbsolute2(expanded) ? expanded : resolve3(cwd, expanded);
   try {
     await stat(abs);
     return abs;
   } catch {
-    return path2;
+    return expanded;
   }
 }
 function splitIncludeGlobs(include) {
@@ -32782,7 +32960,7 @@ import { StringEnum as StringEnum2 } from "@earendil-works/pi-ai";
 import { Type as Type7 } from "typebox";
 var ImportParams = Type7.Object({
   op: StringEnum2(["add", "remove", "organize"], { description: "Import operation" }),
-  filePath: Type7.String({ description: "Path to the file" }),
+  filePath: Type7.String({ description: "Path to the file (absolute or relative to project root)" }),
   module: Type7.Optional(Type7.String({ description: "Module path (required for add/remove), e.g. 'react', './utils'" })),
   names: Type7.Optional(Type7.Array(Type7.String(), { description: "Named imports to add, e.g. ['useState']" })),
   defaultImport: Type7.Optional(Type7.String({ description: "Default import name (e.g. 'React')" })),
@@ -32939,7 +33117,7 @@ function registerLspTools(pi, ctx) {
   pi.registerTool({
     name: "lsp_diagnostics",
     label: "lsp diagnostics",
-    description: "On-demand LSP file/scope check. Spawns the relevant language server (if registered for the extension), opens the document, prefers LSP 3.17 pull diagnostics where supported, falls back to push + waitMs otherwise. NOT a project-wide type checker — for full coverage run `tsc --noEmit`, `cargo check`, `pyright`, etc.\n\nResponse fields: `diagnostics`, `total`, `files_with_errors`, `complete` (true = trustable absence), `lsp_servers_used` (per-server status, e.g. `pull_ok`, `push_only`, `binary_not_installed: <name>`, `no_root_marker (...)`), and (directory mode) `unchecked_files`.\n\nReading honestly:\n- `total: 0` + empty `lsp_servers_used` → **nothing was checked** (no server registered for this extension). Tell the user, don't claim 'no errors'.\n- `total: 0` + `pull_ok` → the file is genuinely clean.\n- `binary_not_installed: <name>` → server matched the extension but its binary isn't on PATH. Tell the user to install it.\n- `no_root_marker (...)` → server is registered but couldn't find a workspace root marker. The user's project layout doesn't match what the server expects.\n\nProvide `filePath` for a single file, `directory` for files under a path (workspace pull from active servers + 200-file walk for unchecked listing), or omit both to dump cached diagnostics.\n\n**When this tool gives an unhelpful answer**, run `npx @cortexkit/aft doctor lsp <filePath>` from a terminal to get a full per-server breakdown (registered servers, binary resolution, root-marker resolution, spawn outcome).",
+    description: "On-demand LSP file/scope check. NOT a project-wide type checker — use `tsc --noEmit`, `cargo check`, `pyright` etc. for full coverage.\n\nHonesty: `total: 0` is only clean when `complete: true` AND `lsp_servers_used[].status` includes `pull_ok`. Empty `lsp_servers_used`, or any `binary_not_installed`/`spawn_failed`/`no_root_marker`/`push_only` without diagnostics means the file wasn't actually checked — say so, don't report 'clean'. For per-server breakdown run `npx @cortexkit/aft doctor lsp <filePath>`.",
     parameters: LspDiagnosticsParams,
     async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
       const hasFile = typeof params.filePath === "string" && params.filePath.length > 0;
@@ -32974,13 +33152,21 @@ import { StringEnum as StringEnum4 } from "@earendil-works/pi-ai";
 import { Type as Type9 } from "typebox";
 function navigateParamsSchema() {
   return Type9.Object({
-    op: StringEnum4(["call_tree", "callers", "trace_to", "impact", "trace_data"], {
+    op: StringEnum4(["call_tree", "callers", "trace_to", "trace_to_symbol", "impact", "trace_data"], {
       description: "Navigation operation"
     }),
-    filePath: Type9.String({ description: "Source file containing the symbol" }),
+    filePath: Type9.String({
+      description: "Source file containing the symbol (absolute or relative to project root)"
+    }),
     symbol: Type9.String({ description: "Name of the symbol to analyze" }),
     depth: optionalInt(1, Number.MAX_SAFE_INTEGER),
-    expression: Type9.Optional(Type9.String({ description: "Expression to track (required for trace_data)" }))
+    expression: Type9.Optional(Type9.String({ description: "Expression to track (required for trace_data)" })),
+    toSymbol: Type9.Optional(Type9.String({
+      description: "Target symbol for trace_to_symbol; the returned path ends here"
+    })),
+    toFile: Type9.Optional(Type9.String({
+      description: "Optional target file for trace_to_symbol; required when toSymbol exists in multiple files"
+    }))
   });
 }
 function treeLine(depth, text) {
@@ -33042,6 +33228,23 @@ function buildNavigateSections(args, payload, theme) {
     });
     return sections2;
   }
+  if (args.op === "trace_to_symbol") {
+    const path2 = asRecords(response.path);
+    const complete = asBoolean(response.complete);
+    const reason = asString(response.reason);
+    if (path2.length === 0) {
+      const prefix = complete === false ? theme.fg("warning", "No complete path") : theme.fg("muted", "No path");
+      return [`${prefix}${reason ? ` (${reason})` : ""}`];
+    }
+    const lines = [theme.fg("success", `${path2.length} hop${path2.length === 1 ? "" : "s"}`)];
+    path2.forEach((hop, index) => {
+      const symbol2 = asString(hop.symbol) ?? "(unknown)";
+      const file2 = shortenPath(asString(hop.file) ?? "(unknown file)");
+      const line = asNumber(hop.line);
+      lines.push(treeLine(index + 1, `${symbol2} ${line !== undefined ? `[${file2}:${line}]` : `[${file2}]`}`));
+    });
+    return lines;
+  }
   if (args.op === "trace_to") {
     const paths = asRecords(response.paths);
     const warning = depthWarning(response, theme, "max_depth_reached", "truncated_paths");
@@ -33103,7 +33306,8 @@ function renderNavigateCall(args, theme, context) {
   const summary = [
     theme.fg("accent", args.op),
     accentPath(theme, args.filePath),
-    theme.fg("toolOutput", args.symbol)
+    theme.fg("toolOutput", args.symbol),
+    args.toSymbol ? theme.fg("toolOutput", `→ ${args.toSymbol}`) : undefined
   ].filter(Boolean).join(" ");
   return renderToolCall("navigate", summary, theme, context);
 }
@@ -33116,12 +33320,15 @@ function registerNavigateTool(pi, ctx) {
   pi.registerTool({
     name: "aft_navigate",
     label: "navigate",
-    description: "Navigate code structure across files using call graph analysis. All ops require both `filePath` and `symbol`. Use `call_tree` for what a function calls, `callers` for call sites, `trace_to` for entry points, `impact` for blast radius, `trace_data` to follow a value.",
+    description: "Navigate code structure across files using call graph analysis. All ops require both `filePath` and `symbol`. Use `call_tree` for what a function calls, `callers` for call sites, `trace_to` for entry points, `trace_to_symbol` for a path from one symbol to another (requires `toSymbol`; if ambiguous, the error returns candidate files — retry with `toFile`), `impact` for blast radius, `trace_data` to follow a value.",
     parameters: navigateParamsSchema(),
     async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
       if (params.op === "trace_data" && !params.expression) {
         throw new Error("op='trace_data' requires an `expression`");
       }
+      if (params.op === "trace_to_symbol" && !params.toSymbol) {
+        throw new Error("op='trace_to_symbol' requires a `toSymbol`");
+      }
       const bridge = bridgeFor(ctx, extCtx.cwd);
       const req = {
         op: params.op,
@@ -33133,6 +33340,10 @@ function registerNavigateTool(pi, ctx) {
         req.depth = depth;
       if (params.expression !== undefined)
         req.expression = params.expression;
+      if (params.toSymbol !== undefined)
+        req.toSymbol = params.toSymbol;
+      if (params.toFile !== undefined)
+        req.toFile = params.toFile;
       const response = await callBridge(bridge, params.op, req, extCtx);
       return textResult(JSON.stringify(response, null, 2));
     },
@@ -33152,15 +33363,26 @@ import { Type as Type10 } from "typebox";
 var OutlineParams = Type10.Object({
   target: Type10.Union([Type10.String(), Type10.Array(Type10.String())], {
     description: "What to outline: a file path, directory path, URL (http:// or https://), or array of file paths. The mode is auto-detected: URLs by `http://`/`https://` prefix, directories by stat, arrays as multi-file. Directory walks cap at 200 files."
-  })
+  }),
+  files: Type10.Optional(Type10.Boolean({
+    description: "Directory-only mode: when true, target must be a directory or array of directories and the result is a flat file tree with path, language, symbol count, and byte size instead of a symbol outline."
+  }))
+});
+var ZoomTarget = Type10.Object({
+  filePath: Type10.String({ description: "Path to file (absolute or project-relative)" }),
+  symbol: Type10.String({ description: "Symbol name in that file" })
 });
 var ZoomParams = Type10.Object({
   filePath: Type10.Optional(Type10.String({ description: "Path to file (absolute or project-relative)" })),
   url: Type10.Optional(Type10.String({
     description: "HTTP/HTTPS URL of an HTML or Markdown document to fetch and zoom into"
   })),
-  symbol: Type10.Optional(Type10.String({ description: "Symbol name (function/class/type) or Markdown heading" })),
-  symbols: Type10.Optional(Type10.Array(Type10.String(), { description: "Multiple symbols — returns array of matches" })),
+  symbols: Type10.Optional(Type10.Union([Type10.String(), Type10.Array(Type10.String())], {
+    description: "Symbol name for code, or heading text for Markdown/HTML. Pass a string for one lookup or an array for batched lookups in the same file/URL."
+  })),
+  targets: Type10.Optional(Type10.Union([ZoomTarget, Type10.Array(ZoomTarget)], {
+    description: "Cross-file batch: `{ filePath, symbol }` or an array of them. Mutually exclusive with filePath/url/symbols."
+  })),
   contextLines: Type10.Optional(Type10.Number({ description: "Lines of context before/after (default: 3)" }))
 });
 function isUrl(s) {
@@ -33241,7 +33463,7 @@ function buildZoomSections(args, payload, theme) {
   }).filter(Boolean);
 }
 function renderOutlineCall(args, theme, context) {
-  const summary = Array.isArray(args.target) ? theme.fg("accent", `${args.target.length} files`) : typeof args.target === "string" ? accentPath(theme, args.target) : undefined;
+  const summary = Array.isArray(args.target) ? theme.fg("accent", `${args.target.length} ${args.files ? "directories" : "files"}`) : typeof args.target === "string" ? `${accentPath(theme, args.target)}${args.files ? " files" : ""}` : undefined;
   return renderToolCall("outline", summary, theme, context);
 }
 function renderOutlineResult(result, theme, context) {
@@ -33250,8 +33472,21 @@ function renderOutlineResult(result, theme, context) {
   return renderSections(buildOutlineSections(collectTextContent(result), theme), context);
 }
 function renderZoomCall(args, theme, context) {
-  const target = args.symbol ? theme.fg("toolOutput", args.symbol) : args.symbols && args.symbols.length > 0 ? theme.fg("toolOutput", `${args.symbols.length} symbols`) : theme.fg("toolOutput", "lines");
-  return renderToolCall("zoom", `${accentPath(theme, zoomTargetLabel(args))} ${target}`, theme, context);
+  const symbols = args.symbols;
+  const targets = args.targets;
+  let summary;
+  if (typeof symbols === "string") {
+    summary = theme.fg("toolOutput", symbols);
+  } else if (Array.isArray(symbols) && symbols.length > 0) {
+    summary = theme.fg("toolOutput", `${symbols.length} symbols`);
+  } else if (Array.isArray(targets) && targets.length > 0) {
+    summary = theme.fg("toolOutput", `${targets.length} targets`);
+  } else if (targets && typeof targets === "object" && !Array.isArray(targets)) {
+    summary = theme.fg("toolOutput", targets.symbol ?? "1 target");
+  } else {
+    summary = theme.fg("toolOutput", "lines");
+  }
+  return renderToolCall("zoom", `${accentPath(theme, zoomTargetLabel(args))} ${summary}`, theme, context);
 }
 function renderZoomResult(result, args, theme, context) {
   if (context.isError)
@@ -33263,18 +33498,46 @@ function registerReadingTools(pi, ctx, surface) {
     pi.registerTool({
       name: "aft_outline",
       label: "outline",
-      description: `Structural outline of source code, documentation files, or remote URLs. For code, returns symbols (functions, classes, types) with line ranges. For Markdown and HTML, returns heading hierarchy. Use this to explore structure before reading specific sections with aft_zoom.
+      description: `Structural outline of source code, documentation files, or remote URLs. For code, returns symbols (functions, classes, types) with line ranges. For Markdown and HTML, returns heading hierarchy. Use this to explore structure before reading specific sections with aft_zoom. Set \`files: true\` with a directory target for a flat indexed file tree with language, symbol count, and byte metadata.
 
 Pass a single \`target\`:
   • file path → outline that file (with signatures)
   • directory path → outline source files under it (recursively, up to 200 files)
   • URL (http:// or https://) → fetch and outline a remote HTML/Markdown document
-  • array of paths → outline multiple files in one call`,
+  • array of paths → outline multiple files in one call; with files:true, every path must be a directory`,
       parameters: OutlineParams,
       async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
         const bridge = bridgeFor(ctx, extCtx.cwd);
         const target = params.target;
+        const filesMode = params.files === true;
         const isArray = Array.isArray(target) && target.length > 0;
+        if (filesMode) {
+          if (Array.isArray(target)) {
+            if (target.length === 0) {
+              throw new Error("'target' must be a non-empty string or array of strings");
+            }
+            const response3 = await callBridge(bridge, "outline", { target, files: true }, extCtx);
+            if (response3.success === false) {
+              throw new Error(response3.message || "outline failed");
+            }
+            return textResult(formatOutlineFilesText(response3), response3);
+          }
+          if (typeof target !== "string" || target.length === 0) {
+            throw new Error("'target' must be a non-empty string or array of strings");
+          }
+          let isDirectory2 = false;
+          try {
+            const resolved = resolve4(extCtx.cwd, target);
+            const st = await stat2(resolved);
+            isDirectory2 = st.isDirectory();
+          } catch {}
+          const request = isDirectory2 ? { directory: resolve4(extCtx.cwd, target), files: true } : { file: target, files: true };
+          const response2 = await callBridge(bridge, "outline", request, extCtx);
+          if (response2.success === false) {
+            throw new Error(response2.message || "outline failed");
+          }
+          return textResult(formatOutlineFilesText(response2), response2);
+        }
         if (typeof target === "string" && isUrl(target)) {
           const response2 = await callBridge(bridge, "outline", { file: target }, extCtx);
           if (response2.success === false) {
@@ -33315,22 +33578,58 @@ Pass a single \`target\`:
     pi.registerTool({
       name: "aft_zoom",
       label: "zoom",
-      description: "Inspect a code symbol or Markdown/HTML section. For code, returns the full source of the symbol with call-graph annotations (calls/called-by). Pass `symbols` for batched lookups.\n\nProvide exactly ONE of `filePath` or `url`.",
+      description: "Inspect code symbols or documentation sections. For code, returns the full source of a symbol with call-graph annotations (calls/called-by). For Markdown and HTML, returns the section content under the given heading.\n\nUse exactly ONE mode: `{ filePath, symbols }`, `{ url, symbols }`, or `{ targets }`. `symbols` can be a string or array (one or many lookups in the same file/URL). Use `targets` for cross-file batches: `{ filePath, symbol }` or an array of them.",
       parameters: ZoomParams,
       async execute(_toolCallId, params, _signal, _onUpdate, extCtx) {
         const bridge = bridgeFor(ctx, extCtx.cwd);
         const hasFilePath = typeof params.filePath === "string" && params.filePath.length > 0;
         const hasUrl = typeof params.url === "string" && params.url.length > 0;
+        const hasTargets = params.targets !== undefined && params.targets !== null;
+        const hasSymbols = params.symbols !== undefined && params.symbols !== null && (typeof params.symbols === "string" ? params.symbols.length > 0 : Array.isArray(params.symbols) && params.symbols.length > 0);
+        if (hasTargets) {
+          if (hasFilePath || hasUrl || hasSymbols) {
+            throw new Error("'targets' is mutually exclusive with 'filePath', 'url', and 'symbols'");
+          }
+          const targets = Array.isArray(params.targets) ? params.targets : [params.targets];
+          if (targets.length === 0) {
+            throw new Error("'targets' must be a non-empty object or array");
+          }
+          for (const [i, entry] of targets.entries()) {
+            if (!entry || typeof entry.filePath !== "string" || entry.filePath.length === 0) {
+              throw new Error(`targets[${i}].filePath must be a non-empty string`);
+            }
+            if (typeof entry.symbol !== "string" || entry.symbol.length === 0) {
+              throw new Error(`targets[${i}].symbol must be a non-empty string`);
+            }
+          }
+          const responses = await Promise.all(targets.map((t) => {
+            const req2 = { file: t.filePath, symbol: t.symbol };
+            if (params.contextLines !== undefined)
+              req2.context_lines = params.contextLines;
+            return callBridge(bridge, "zoom", req2, extCtx).catch((err) => ({
+              success: false,
+              message: err instanceof Error ? err.message : String(err)
+            }));
+          }));
+          const entries = targets.map((t, i) => ({
+            targetLabel: t.filePath,
+            name: t.symbol,
+            response: responses[i] ?? { success: false, message: "missing zoom response" }
+          }));
+          const batch = formatZoomMultiTargetResult(entries);
+          return textResult(batch.text, batch);
+        }
         if (!hasFilePath && !hasUrl) {
-          throw new Error("Provide exactly one of 'filePath' or 'url'");
+          throw new Error("Provide exactly one of 'filePath', 'url', or 'targets'");
         }
         if (hasFilePath && hasUrl) {
           throw new Error("Provide exactly ONE of 'filePath' or 'url' — not both");
         }
         const file2 = hasUrl ? params.url : params.filePath;
         const targetLabel = (hasUrl ? params.url : params.filePath) ?? file2;
-        if (Array.isArray(params.symbols) && params.symbols.length > 0) {
-          const results = await Promise.all(params.symbols.map((sym) => {
+        const symbolsArray = hasSymbols ? typeof params.symbols === "string" ? [params.symbols] : params.symbols : undefined;
+        if (symbolsArray) {
+          const results = await Promise.all(symbolsArray.map((sym) => {
             const req2 = { file: file2, symbol: sym };
             if (params.contextLines !== undefined)
               req2.context_lines = params.contextLines;
@@ -33339,12 +33638,17 @@ Pass a single \`target\`:
               message: err instanceof Error ? err.message : String(err)
             }));
           }));
-          const batch = formatZoomBatchResult(targetLabel, params.symbols, results);
+          if (symbolsArray.length === 1) {
+            const response2 = results[0] ?? { success: false, message: "missing zoom response" };
+            if (response2.success === false) {
+              throw new Error(response2.message || "zoom failed");
+            }
+            return textResult(formatZoomText(targetLabel, response2), response2);
+          }
+          const batch = formatZoomBatchResult(targetLabel, symbolsArray, results);
           return textResult(batch.text, batch);
         }
         const req = { file: file2 };
-        if (params.symbol)
-          req.symbol = params.symbol;
         if (params.contextLines !== undefined)
           req.context_lines = params.contextLines;
         const response = await callBridge(bridge, "zoom", req, extCtx);
@@ -33387,6 +33691,7 @@ function formatZoomBatchResult(targetLabel, symbols, responses) {
 
 `) };
 }
+var MAX_UNCHECKED_FILES_IN_FOOTER = 10;
 function formatOutlineText(response) {
   const text = response.text ?? "";
   const skipped = response.skipped_files;
@@ -33401,13 +33706,45 @@ function formatOutlineText(response) {
   return `${header}Skipped ${skipped.length} file(s):
 ${lines}`;
 }
+function formatOutlineFilesText(response) {
+  const text = formatOutlineText(response);
+  const uncheckedFiles = Array.isArray(response.unchecked_files) ? response.unchecked_files.filter((file2) => typeof file2 === "string" && file2.length > 0) : [];
+  const isPartial = response.complete === false || response.walk_truncated === true || uncheckedFiles.length > 0;
+  if (!isPartial) {
+    return text;
+  }
+  const footer = [];
+  if (response.walk_truncated === true) {
+    const uncheckedCount = uncheckedFiles.length;
+    const suffix = uncheckedCount > 0 ? ` ${uncheckedCount} additional files in this directory were not indexed.` : " Some files in this directory were not indexed.";
+    footer.push(`⚠ Partial result: walk truncated at 200 files.${suffix}`);
+  } else {
+    const suffix = uncheckedFiles.length > 0 ? ` ${uncheckedFiles.length} files in this directory were not indexed.` : " Some files in this directory were not indexed.";
+    footer.push(`⚠ Partial result:${suffix}`);
+  }
+  if (uncheckedFiles.length > 0) {
+    footer.push("Unchecked files:");
+    footer.push(...uncheckedFiles.slice(0, MAX_UNCHECKED_FILES_IN_FOOTER).map((file2) => `  ${file2}`));
+    const remaining = uncheckedFiles.length - MAX_UNCHECKED_FILES_IN_FOOTER;
+    if (remaining > 0) {
+      footer.push(`  ... +${remaining} more`);
+    }
+  }
+  const header = text.length > 0 ? `${text}
+
+` : "";
+  return `${header}${footer.join(`
+`)}`;
+}
 
 // src/tools/refactor.ts
 import { StringEnum as StringEnum5 } from "@earendil-works/pi-ai";
 import { Type as Type11 } from "typebox";
 var RefactorParams = Type11.Object({
   op: StringEnum5(["move", "extract", "inline"], { description: "Refactoring operation" }),
-  filePath: Type11.String({ description: "Source file" }),
+  filePath: Type11.String({
+    description: "Source file (absolute or relative to project root)"
+  }),
   symbol: Type11.Optional(Type11.String({ description: "Symbol name (for move, inline)" })),
   destination: Type11.Optional(Type11.String({ description: "Target file (for move)" })),
   scope: Type11.Optional(Type11.String({ description: "Disambiguation scope for move op" })),
@@ -33509,7 +33846,9 @@ var SafetyParams = Type12.Object({
   op: StringEnum6(["undo", "history", "checkpoint", "restore", "list"], {
     description: "Safety operation"
   }),
-  filePath: Type12.Optional(Type12.String({ description: "File path (required for history, optional for undo)" })),
+  filePath: Type12.Optional(Type12.String({
+    description: "File path (required for history, optional for undo). Absolute or relative to project root."
+  })),
   name: Type12.Optional(Type12.String({ description: "Checkpoint name (required for checkpoint, restore)" })),
   files: Type12.Optional(Type12.Array(Type12.String(), {
     description: "Specific files for checkpoint (optional, defaults to all tracked)"
@@ -33751,7 +34090,9 @@ import { StringEnum as StringEnum7 } from "@earendil-works/pi-ai";
 import { Type as Type14 } from "typebox";
 var TransformParams = Type14.Object({
   op: StringEnum7(["add_member", "add_derive", "wrap_try_catch", "add_decorator", "add_struct_tags"], { description: "Transformation operation" }),
-  filePath: Type14.String({ description: "Path to the source file" }),
+  filePath: Type14.String({
+    description: "Path to the source file (absolute or relative to project root)"
+  }),
   container: Type14.Optional(Type14.String({ description: "Class/struct/impl name for add_member" })),
   code: Type14.Optional(Type14.String({ description: "Member code to insert (add_member)" })),
   target: Type14.Optional(Type14.String({ description: "Target symbol name" })),
@@ -33883,7 +34224,7 @@ function buildWorkflowHints(opts) {
   const hasNavigate = opts.toolSurface === "all" && !opts.absentTools.has("aft_navigate");
   const hasBgBash = opts.bashBackgroundEnabled && !opts.absentTools.has(bashName) && !opts.absentTools.has("bash_status");
   if (hasOutline && hasZoom) {
-    sections.push(`**Web/URL access**: \`aft_outline({ target: "<url>" })\` first for structure, then \`aft_zoom({ target: "<url>", symbol: "<heading>" })\` for the specific section.`);
+    sections.push(`**Web/URL access**: \`aft_outline({ target: "<url>" })\` first for structure, then \`aft_zoom({ url: "<url>", symbols: "<heading>" })\` for the specific section.`);
   }
   if (hasOutline && hasZoom && (hasGrep || hasSearch)) {
     const locator = hasGrep ? `\`${grepName}\`` : "`aft_search`";
@@ -33895,6 +34236,7 @@ function buildWorkflowHints(opts) {
       "- `callers` — find all call sites before changing a function signature",
       "- `impact` — blast radius (which functions/files will need updates)",
       "- `trace_to` — how execution reaches this code from entry points (routes, exports, main)",
+      "- `trace_to_symbol` — shortest call path from one symbol to another",
       "- `trace_data` — follow a value through assignments and parameters across files"
     ].join(`
 `));
@@ -33994,13 +34336,13 @@ var PLUGIN_VERSION = (() => {
     return "0.0.0";
   }
 })();
-var ANNOUNCEMENT_VERSION = "0.30.0";
+var ANNOUNCEMENT_VERSION = "0.31.0";
 var ANNOUNCEMENT_FEATURES = [
-  'PTY support for interactive bash. `bash({pty: true, background: true})` spawns commands inside a real terminal — runs Python/Node REPLs, vim, htop, less, and nested TUIs. Use `ptyRows`/`ptyCols` (up to 60×140) to size the terminal, `bash_status({outputMode: "screen"})` for the rendered view, and `bash_write` to send keystrokes.',
-  "New `bash_watch` tool unifies pattern notifications and sync waits. `bash_watch({taskId, pattern?, timeoutMs?})` blocks inline; `bash_watch({taskId, pattern, background: true})` registers an async watcher that fires `[BG BASH NOTIFY]` on match or task exit and suppresses the default completion reminder.",
-  "`bash_status` is now a pure snapshot tool — wait and watch semantics moved to `bash_watch`.",
-  "URL fetches in `aft_outline` and `aft_zoom` no longer hang indefinitely on slow servers — body reads abort with a clear stall error after 15 seconds without data.",
-  "Post-restart bg-bash replay is fixed: previously-delivered task completions no longer fire fresh reminders after OpenCode restarts."
+  "`aft_navigate` has a new `trace_to_symbol` op for path-between-symbols queries. One call returns the shortest call path from one function to another with file + line for every hop. Honest errors for ambiguous, missing, or unreachable targets — including a candidate list to disambiguate.",
+  '`aft_outline target: "<dir>", files: true` returns an indexed file tree with language, symbol count, and byte size per file. Lets agents pick which files to actually open without first reading symbol bodies. Honest truncation (`complete: false` + `walk_truncated`/`unchecked_files`) when the directory exceeds the walk cap.',
+  '`aft_zoom` adds `targets` for cross-file batches — pull bodies from different files in one call. Schema breaking change: `symbol` is removed; pass `symbols: "name"` (string) or `symbols: ["a", "b"]` (array). Same shape works for `url` mode so you can grab multiple sections from one URL fetch.',
+  "Pi `grep`/`write`/`edit` no longer hang on external paths. The plugin used to nag with an `Allow external directory access?` prompt even under the Pi default (`restrict_to_project_root: false`) which explicitly opts into no restriction. The plugin now defers to Rust without prompting in that case, expands `~/...` paths correctly, and bounds the prompt with a 30s timeout when strict mode is enabled.",
+  "Tool descriptions trimmed: ~1.2K agent-facing tokens removed by dropping redundant `Returns:` blocks and compressing `lsp_diagnostics` while preserving its load-bearing honesty guidance."
 ];
 var ANNOUNCEMENT_FOOTER = "Join us on Discord: https://discord.gg/F2uWxjGnU";
 var ALL_ONLY_TOOLS = new Set([
@@ -34066,6 +34408,7 @@ function resolveToolSurface(config2) {
   const disabled = new Set(config2.disabled_tools ?? []);
   const ok = (name) => !disabled.has(name);
   const allOnly = (name) => ALL_ONLY_TOOLS.has(name) && ok(name);
+  const restrictToProjectRoot = config2.restrict_to_project_root ?? false;
   if (surface === "minimal") {
     return {
       hoistBash: ok("bash"),
@@ -34073,6 +34416,7 @@ function resolveToolSurface(config2) {
       hoistWrite: false,
       hoistEdit: false,
       hoistGrep: false,
+      restrictToProjectRoot,
       outline: ok("aft_outline"),
       zoom: ok("aft_zoom"),
       semantic: false,
@@ -34095,6 +34439,7 @@ function resolveToolSurface(config2) {
     hoistWrite: ok("write"),
     hoistEdit: ok("edit"),
     hoistGrep: ok("grep") && config2.search_index === true,
+    restrictToProjectRoot,
     outline: ok("aft_outline"),
     zoom: ok("aft_zoom"),
     semantic: ok("aft_search") && config2.semantic_search === true,

package/dist/tools/_shared.d.ts

@@ -18,6 +18,8 @@ export declare function coerceOptionalInt(v: unknown, paramName: string, min: nu
 export declare const LONG_RUNNING_COMMAND_TIMEOUT_MS: Record<string, number>;
 /** Returns the per-command timeout override, or undefined to use the bridge default. */
 export declare function timeoutForCommand(command: string): number | undefined;
+/** Format bridge failure envelopes without dropping structured error data. */
+export declare function formatBridgeErrorMessage(command: string, response: Record<string, unknown>, params?: Record<string, unknown>): string;
 /** Get the session bridge for the current working directory. */
 export declare function bridgeFor(ctx: PluginContext, cwd: string): BinaryBridge;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,8BACC,CAAC;AAExD,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQlE,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,GACjB,eAAe,CAAC,QAAQ,CAAC,CAK3B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAG,OAAO,EAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,QAAQ,GACjB,eAAe,CAAC,QAAQ,CAAC,CAE3B;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGvF"}
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,8BACC,CAAC;AAExD,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASlE,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AA2BD,8EAA8E;AAC9E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,MAAM,CAsDR;AAsBD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,GACjB,eAAe,CAAC,QAAQ,CAAC,CAK3B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAG,OAAO,EAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,QAAQ,GACjB,eAAe,CAAC,QAAQ,CAAC,CAE3B;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGvF"}

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

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/tools/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAEL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,YAAY;;;EAWhB,CAAC;AAEH,QAAA,MAAM,UAAU;;;EAGd,CAAC;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,GAAG,UAAU,EACnC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,EAC7D,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAkB3B;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,GAAG,UAAU,EACnC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,EAC7D,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAsC3B;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CA+F9F"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/tools/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAEL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,YAAY;;;EAWhB,CAAC;AAEH,QAAA,MAAM,UAAU;;;EAOd,CAAC;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,GAAG,UAAU,EACnC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,EAC7D,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAkB3B;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,GAAG,UAAU,EACnC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,EAC7D,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAsC3B;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CA+F9F"}

package/dist/tools/hoisted.d.ts

@@ -23,6 +23,19 @@ export interface ToolSurfaceFlags {
     hoistWrite: boolean;
     hoistEdit: boolean;
     hoistGrep: boolean;
+    /**
+     * Mirrors the user's `restrict_to_project_root` AFT config (Pi default
+     * `false`). When false, the user has explicitly opted into "no
+     * restriction" — Pi has no host-level external_directory allow-list, so
+     * a `ui.confirm` prompt has no policy to consult and would only annoy
+     * the user. When true, Rust hard-rejects out-of-root paths before the
+     * plugin layer sees them anyway, so the prompt is also unreachable. We
+     * pass this through so `assertExternalDirectoryPermission` can skip the
+     * prompt in the false case (the common one) and the helper stays in
+     * place as a safety net for unusual contexts that opt into restriction
+     * but still want a chance to allow a one-off external write.
+     */
+    restrictToProjectRoot: boolean;
 }
 /** Details surfaced to both renderer and agent message stream. */
 interface FileMutationDetails {

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

@@ -1 +1 @@
-{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAGlB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2EjD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kEAAkE;AAClE,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAsMN;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAAC,mBAAmB,CAAC,CAiGtC;AAyJD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B3D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,mBAAmB,EAAE,OAAO,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAgBR"}
+{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAGlB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA8JjD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,kEAAkE;AAClE,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CA4MN;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAAC,mBAAmB,CAAC,CAiGtC;AA0JD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B3D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,mBAAmB,EAAE,OAAO,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAgBR"}

package/dist/tools/navigate.d.ts

@@ -1,17 +1,19 @@
 /**
  * aft_navigate — call-graph navigation across files.
- * Ops: call_tree, callers, trace_to, impact, trace_data.
+ * Ops: call_tree, callers, trace_to, trace_to_symbol, impact, trace_data.
  */
 import type { AgentToolResult, ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
 import type { PluginContext } from "../types.js";
 import { type RenderContextLike } from "./render-helpers.js";
 declare function navigateParamsSchema(): Type.TObject<{
-    op: Type.TUnsafe<"callers" | "trace_to" | "trace_data" | "impact" | "call_tree">;
+    op: Type.TUnsafe<"callers" | "trace_to" | "trace_to_symbol" | "trace_data" | "impact" | "call_tree">;
     filePath: Type.TString;
     symbol: Type.TString;
     depth: Type.TOptional<Type.TAny>;
     expression: Type.TOptional<Type.TString>;
+    toSymbol: Type.TOptional<Type.TString>;
+    toFile: Type.TOptional<Type.TString>;
 }>;
 type NavigateArgs = Static<ReturnType<typeof navigateParamsSchema>>;
 /** Exported for renderer unit tests. */

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

@@ -1 +1 @@
-{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/tools/navigate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAQL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,iBAAS,oBAAoB;;;;;;GAY5B;AAED,KAAK,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AA6CpE,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CA+FV;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,yCAS9F;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA8B/E"}
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/tools/navigate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAQL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,iBAAS,oBAAoB;;;;;;;;GA4B5B;AAED,KAAK,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AA6CpE,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAoHV;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,yCAU9F;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAmC/E"}

package/dist/tools/reading.d.ts

@@ -8,12 +8,19 @@ import type { PluginContext } from "../types.js";
 import { type RenderContextLike } from "./render-helpers.js";
 declare const OutlineParams: Type.TObject<{
     target: Type.TUnion<[Type.TString, Type.TArray<Type.TString>]>;
+    files: Type.TOptional<Type.TBoolean>;
 }>;
 declare const ZoomParams: Type.TObject<{
     filePath: Type.TOptional<Type.TString>;
     url: Type.TOptional<Type.TString>;
-    symbol: Type.TOptional<Type.TString>;
-    symbols: Type.TOptional<Type.TArray<Type.TString>>;
+    symbols: Type.TOptional<Type.TUnion<[Type.TString, Type.TArray<Type.TString>]>>;
+    targets: Type.TOptional<Type.TUnion<[Type.TObject<{
+        filePath: Type.TString;
+        symbol: Type.TString;
+    }>, Type.TArray<Type.TObject<{
+        filePath: Type.TString;
+        symbol: Type.TString;
+    }>>]>>;
     contextLines: Type.TOptional<Type.TNumber>;
 }>;
 export interface ReadingSurface {
@@ -54,5 +61,6 @@ export declare function registerReadingTools(pi: ExtensionAPI, ctx: PluginContex
  * `@cortexkit/aft-bridge` so the agent sees the same shape across hosts.
  */
 export declare function formatZoomBatchResult(targetLabel: string, symbols: string[], responses: Record<string, unknown>[]): ZoomBatchResult;
+export declare function formatOutlineFilesText(response: Record<string, unknown>): string;
 export {};
 //# sourceMappingURL=reading.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAOL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,aAAa;;EAKjB,CAAC;AAEH,QAAA,MAAM,UAAU;;;;;;EAkBd,CAAC;AAWH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAOzE;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAwFV;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,aAAa,CAAC,EAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAQ3B;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAI3B;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAa3B;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAI3B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,GACtB,IAAI,CAiJN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACnC,eAAe,CAyBjB"}
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAOL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,aAAa;;;EAWjB,CAAC;AAOH,QAAA,MAAM,UAAU;;;;;;;;;;;;EAwBd,CAAC;AAWH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAOzE;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAwFV;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,aAAa,CAAC,EAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAQ3B;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAI3B;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAuB3B;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAI3B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,GACtB,IAAI,CAwPN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACnC,eAAe,CAyBjB;AA0BD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA2ChF"}

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

@@ -1 +1 @@
-{"version":3,"file":"refactor.d.ts","sourceRoot":"","sources":["../../src/tools/refactor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAOL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,cAAc;;;;;;;;;;EAUlB,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAiCV;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACnC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAU3B;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACnC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAsD/E"}
+{"version":3,"file":"refactor.d.ts","sourceRoot":"","sources":["../../src/tools/refactor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAOL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,cAAc;;;;;;;;;;EAYlB,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAiCV;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACnC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAU3B;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,cAAc,CAAC,EACnC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAsD/E"}

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

@@ -1 +1 @@
-{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/tools/safety.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAQL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,YAAY;;;;;EAehB,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,EACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CA4EV;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,EACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAO3B;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,EACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwD7E"}
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/tools/safety.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAQL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,YAAY;;;;;EAkBhB,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,EACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CA4EV;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,EACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAO3B;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,YAAY,CAAC,EACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwD7E"}

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

@@ -1 +1 @@
-{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/tools/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAKL,KAAK,iBAAiB,EAIvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,eAAe;;;;;;;;;;;;;;EAgCnB,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAiBV;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,EACpC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAW3B;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,EACpC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwChF"}
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/tools/structure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAKL,KAAK,iBAAiB,EAIvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,eAAe;;;;;;;;;;;;;;EAkCnB,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAiBV;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,EACpC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,yCAW3B;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,eAAe,CAAC,EACpC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,sFAO3B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAwChF"}

package/dist/workflow-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CA8DzE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,IAAI,CAYf;AAMD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CA8BN"}
+{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CA+DzE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,IAAI,CAYf;AAMD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CA8BN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-pi",
-  "version": "0.30.3",
+  "version": "0.31.1",
   "type": "module",
   "description": "Pi coding agent extension for Agent File Tools (AFT) — tree-sitter and LSP-powered code analysis",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@cortexkit/aft-bridge": "0.30.3",
+    "@cortexkit/aft-bridge": "0.31.1",
     "@xterm/headless": "^5.5.0",
     "comment-json": "^5.0.0",
     "diff": "^8.0.4",
@@ -30,12 +30,12 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.30.3",
-    "@cortexkit/aft-darwin-x64": "0.30.3",
-    "@cortexkit/aft-linux-arm64": "0.30.3",
-    "@cortexkit/aft-linux-x64": "0.30.3",
-    "@cortexkit/aft-win32-arm64": "0.30.3",
-    "@cortexkit/aft-win32-x64": "0.30.3"
+    "@cortexkit/aft-darwin-arm64": "0.31.1",
+    "@cortexkit/aft-darwin-x64": "0.31.1",
+    "@cortexkit/aft-linux-arm64": "0.31.1",
+    "@cortexkit/aft-linux-x64": "0.31.1",
+    "@cortexkit/aft-win32-arm64": "0.31.1",
+    "@cortexkit/aft-win32-x64": "0.31.1"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "*",