@cortexkit/aft-opencode 0.30.0 → 0.30.1

package/dist/hooks/auto-update-checker/cache.d.ts

@@ -4,24 +4,13 @@ interface AutoUpdateInstallContext {
 }
 export declare function resolveInstallContext(runtimePackageJsonPath?: string | null): AutoUpdateInstallContext | null;
 export declare function preparePackageUpdate(version: string, packageName?: string, runtimePackageJsonPath?: string | null): string | null;
-/**
- * Run `npm install` in the install dir to materialize the dependency version
- * we just rewrote into package.json. Earlier versions used `bun install`,
- * but OpenCode itself installs plugins via npm — the install dir always
- * contains `package-lock.json`, never `bun.lock` — so calling npm matches
- * the existing lockfile shape and avoids generating a parallel bun.lock
- * that drifts from OpenCode's view.
- *
- * `--no-audit --no-fund --no-progress` keeps the output minimal and avoids
- * noisy network calls during background auto-updates.
- *
- * The default timeout is 60s — long enough for a typical reinstall over a
- * mediocre network, short enough that a stuck install doesn't pin the plugin
- * process. Caller can override.
- */
 export declare function runNpmInstallSafe(installDir: string, options?: {
     timeoutMs?: number;
     signal?: AbortSignal;
-}): Promise<boolean>;
+}): Promise<{
+    ok: boolean;
+    reason?: string;
+    stderrTail?: string;
+}>;
 export {};
 //# sourceMappingURL=cache.d.ts.map

package/dist/hooks/auto-update-checker/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/cache.ts"],"names":[],"mappings":"AAqBA,UAAU,wBAAwB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4ID,wBAAgB,qBAAqB,CACnC,sBAAsB,GAAE,MAAM,GAAG,IAAyC,GACzE,wBAAwB,GAAG,IAAI,CAoBjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAqB,EAClC,sBAAsB,GAAE,MAAM,GAAG,IAAyC,GACzE,MAAM,GAAG,IAAI,CAmCf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACzD,OAAO,CAAC,OAAO,CAAC,CAyDlB"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/cache.ts"],"names":[],"mappings":"AAqBA,UAAU,wBAAwB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4ID,wBAAgB,qBAAqB,CACnC,sBAAsB,GAAE,MAAM,GAAG,IAAyC,GACzE,wBAAwB,GAAG,IAAI,CAoBjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAqB,EAClC,sBAAsB,GAAE,MAAM,GAAG,IAAyC,GACzE,MAAM,GAAG,IAAI,CAmCf;AAmBD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACzD,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoFhE"}

package/dist/hooks/auto-update-checker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,wBAA6B,YAed;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,mBAyCjD;AAiMD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAYD,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/auto-update-checker/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,wBAA6B,YAed;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,mBAyCjD;AAuMD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAYD,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -51714,15 +51714,25 @@ function preparePackageUpdate(version2, packageName = PACKAGE_NAME, runtimePacka
     return null;
   }
 }
+var STDERR_TAIL_BYTES = 16 * 1024;
 async function runNpmInstallSafe(installDir, options = {}) {
   let timeout = null;
+  let stderrTail = "";
   try {
     if (options.signal?.aborted)
-      return false;
-    const proc = spawn2("npm", ["install", "--no-audit", "--no-fund", "--no-progress"], {
+      return { ok: false, reason: "aborted" };
+    const npmBin = process.platform === "win32" ? "npm.cmd" : "npm";
+    const proc = spawn2(npmBin, ["install", "--no-audit", "--no-fund", "--no-progress", "--ignore-scripts"], {
       cwd: installDir,
-      stdio: "ignore"
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    proc.stderr?.on("data", (chunk) => {
+      stderrTail += chunk.toString("utf8");
+      if (stderrTail.length > STDERR_TAIL_BYTES) {
+        stderrTail = stderrTail.slice(-STDERR_TAIL_BYTES);
+      }
     });
+    proc.stdout?.on("data", () => {});
     const abortProcess = () => {
       try {
         proc.kill();
@@ -51730,8 +51740,8 @@ async function runNpmInstallSafe(installDir, options = {}) {
     };
     options.signal?.addEventListener("abort", abortProcess, { once: true });
     const exitPromise = new Promise((resolveExit) => {
-      proc.on("error", () => resolveExit(false));
-      proc.on("exit", (code) => resolveExit(code === 0));
+      proc.on("error", (err) => resolveExit({ ok: false, reason: `spawn error: ${String(err)}` }));
+      proc.on("exit", (code) => resolveExit(code === 0 ? { ok: true } : { ok: false, reason: `npm install exited with code ${code ?? "signal/unknown"}` }));
     });
     const timeoutPromise = new Promise((resolveTimeout) => {
       timeout = setTimeout(() => resolveTimeout("timeout"), options.timeoutMs ?? 60000);
@@ -51745,29 +51755,41 @@ async function runNpmInstallSafe(installDir, options = {}) {
         pendingSnapshots.delete(installDir);
         restoreAutoUpdateSnapshot(snapshot2);
       }
-      return false;
+      const reason = options.signal?.aborted ? "aborted" : "timeout";
+      warnNpmInstallFailure(reason, stderrTail);
+      return { ok: false, reason, stderrTail: stderrTail || undefined };
     }
     const snapshot = pendingSnapshots.get(installDir);
     pendingSnapshots.delete(installDir);
-    if (!result && snapshot) {
+    if (!result.ok && snapshot) {
       restoreAutoUpdateSnapshot(snapshot);
     } else if (snapshot) {
       rmSync3(snapshot.tempDir, { recursive: true, force: true });
     }
-    return result;
+    if (!result.ok) {
+      warnNpmInstallFailure(result.reason ?? "npm install failed", stderrTail);
+    }
+    return { ...result, stderrTail: stderrTail || undefined };
   } catch (err) {
     const snapshot = pendingSnapshots.get(installDir);
     if (snapshot) {
       pendingSnapshots.delete(installDir);
       restoreAutoUpdateSnapshot(snapshot);
     }
-    warn2(`[auto-update-checker] npm install error: ${String(err)}`);
-    return false;
+    const reason = `exception: ${String(err)}`;
+    warnNpmInstallFailure(reason, stderrTail);
+    return { ok: false, reason, stderrTail: stderrTail || undefined };
   } finally {
     if (timeout)
       clearTimeout(timeout);
   }
 }
+function warnNpmInstallFailure(reason, stderrTail) {
+  const tail2 = stderrTail ? `
+stderr tail:
+${stderrTail}` : "";
+  warn2(`[auto-update-checker] npm install failed (${reason})${tail2}`);
+}
 
 // src/hooks/auto-update-checker/index.ts
 var DEFAULT_CHECK_INTERVAL_MS = 60 * 60 * 1000;
@@ -51907,15 +51929,19 @@ async function runBackgroundUpdateCheck(ctx, options) {
     warn2("[auto-update-checker] Failed to prepare install root for auto-update");
     return;
   }
-  const installSuccess = await runNpmInstallSafe(installDir, { signal: options.signal });
-  if (installSuccess) {
+  const installResult = await runNpmInstallSafe(installDir, { signal: options.signal });
+  if (installResult.ok) {
     showToast(ctx, "AFT Updated!", `v${currentVersion} → v${latestVersion}
 Restart OpenCode to apply.`, "success", 8000);
     log2(`[auto-update-checker] Update installed: ${currentVersion} → ${latestVersion}`);
     return;
   }
   showToast(ctx, `AFT ${latestVersion}`, `v${latestVersion} available, but auto-update failed to install it. Check logs or retry manually.`, "error", 8000);
-  warn2("[auto-update-checker] npm install failed; update not installed");
+  const failureDetail = installResult.reason ? `: ${installResult.reason}` : "";
+  const stderrDetail = installResult.stderrTail ? `
+stderr tail:
+${installResult.stderrTail}` : "";
+  warn2(`[auto-update-checker] npm install failed; update not installed${failureDetail}${stderrDetail}`);
 }
 function showToast(ctx, title, message, variant = "info", duration3 = 3000) {
   ctx.client.tui.showToast({ body: { title, message, variant, duration: duration3 } }).catch(() => {});
@@ -54522,11 +54548,14 @@ function registerShutdownCleanup(fn) {
 }
 
 // src/tools/ast.ts
-import { tool as tool2 } from "@opencode-ai/plugin";
+import { tool as tool3 } from "@opencode-ai/plugin";
 
 // src/tools/_shared.ts
 import * as fs3 from "node:fs";
 import * as path2 from "node:path";
+import { tool as tool2 } from "@opencode-ai/plugin";
+var z2 = tool2.schema;
+var optionalInt = (min, max) => z2.number().int().min(min).max(max).optional();
 var LONG_RUNNING_COMMAND_TIMEOUT_MS = {
   callers: 60000,
   trace_to: 60000,
@@ -54739,7 +54768,7 @@ function permissionDeniedResponse(message) {
 }
 
 // src/tools/ast.ts
-var z2 = tool2.schema;
+var z3 = tool3.schema;
 function showOutputToUser(context, output) {
   const ctx = context;
   ctx.metadata?.({ metadata: { output } });
@@ -54772,11 +54801,11 @@ function astTools(ctx) {
 
 ` + "Returns: Text summary — 'Found N match(es) across M file(s)' followed by file:line blocks with matched text and captured meta-variables.",
     args: {
-      pattern: z2.string().describe("AST pattern with meta-variables ($VAR, $$$). Must be complete AST node."),
-      lang: z2.enum(SUPPORTED_LANGS).describe("Target language"),
-      paths: z2.array(z2.string()).optional().describe("Paths to search (default: ['.'])"),
-      globs: z2.array(z2.string()).optional().describe("Include/exclude globs (prefix ! to exclude)"),
-      contextLines: z2.number().optional().describe("Number of context lines to show around each match")
+      pattern: z3.string().describe("AST pattern with meta-variables ($VAR, $$$). Must be complete AST node."),
+      lang: z3.enum(SUPPORTED_LANGS).describe("Target language"),
+      paths: z3.array(z3.string()).optional().describe("Paths to search (default: ['.'])"),
+      globs: z3.array(z3.string()).optional().describe("Include/exclude globs (prefix ! to exclude)"),
+      contextLines: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Number of context lines to show around each match")
     },
     execute: async (args, context) => {
       const externalDenied = await checkAstPathsPermission(context, args.paths);
@@ -54866,12 +54895,12 @@ ${hint}`;
 
 ` + "Returns: Text summary — 'Replaced N match(es) across M file(s)' (or '[DRY RUN] Would replace...') followed by per-file output. In dry-run mode, each file is shown with its unified diff so you can verify the rewrite before applying (e.g. catch literal $$$ from anonymous-variadic typos). Diff preview is capped at 8KB total; remaining files are summarized.",
     args: {
-      pattern: z2.string().describe("AST pattern with meta-variables ($VAR, $$$). Must be complete AST node."),
-      rewrite: z2.string().describe("Replacement pattern (can use $VAR from pattern)"),
-      lang: z2.enum(SUPPORTED_LANGS).describe("Target language"),
-      paths: z2.array(z2.string()).optional().describe("Paths to search (default: ['.'])"),
-      globs: z2.array(z2.string()).optional().describe("Include/exclude globs (prefix ! to exclude)"),
-      dryRun: z2.boolean().optional().describe("Preview changes without applying (default: false)")
+      pattern: z3.string().describe("AST pattern with meta-variables ($VAR, $$$). Must be complete AST node."),
+      rewrite: z3.string().describe("Replacement pattern (can use $VAR from pattern)"),
+      lang: z3.enum(SUPPORTED_LANGS).describe("Target language"),
+      paths: z3.array(z3.string()).optional().describe("Paths to search (default: ['.'])"),
+      globs: z3.array(z3.string()).optional().describe("Include/exclude globs (prefix ! to exclude)"),
+      dryRun: z3.boolean().optional().describe("Preview changes without applying (default: false)")
     },
     execute: async (args, context) => {
       const isDryRun = args.dryRun === true;
@@ -55036,7 +55065,7 @@ function conflictTools(ctx) {
 // src/tools/hoisted.ts
 import * as fs6 from "node:fs";
 import * as path4 from "node:path";
-import { tool as tool6 } from "@opencode-ai/plugin";
+import { tool as tool7 } from "@opencode-ai/plugin";
 
 // src/patch-parser.ts
 function stripHeredoc(input) {
@@ -55330,7 +55359,7 @@ ${chunk.old_lines.join(`
 }
 
 // src/tools/bash.ts
-import { tool as tool3 } from "@opencode-ai/plugin";
+import { tool as tool4 } from "@opencode-ai/plugin";
 
 // src/shared/subagent-detect.ts
 var CACHE_MAX_ENTRIES2 = 200;
@@ -55383,7 +55412,7 @@ function setCache2(sessionId, isSubagent) {
 }
 
 // src/tools/bash.ts
-var z3 = tool3.schema;
+var z4 = tool4.schema;
 var METADATA_PREVIEW_LIMIT = 30 * 1024;
 var FOREGROUND_WAIT_WINDOW_MS = 5000;
 var FOREGROUND_POLL_INTERVAL_MS = 100;
@@ -55416,15 +55445,15 @@ function createBashTool(ctx) {
   return {
     description: BASH_DESCRIPTION,
     args: {
-      command: z3.string().describe("Shell command to execute through AFT's unified bash schema. Supports normal shell syntax, pipes, redirection, and command rewriting to dedicated AFT tools when available."),
-      timeout: z3.number().int().positive().optional().describe("Hard kill cap in milliseconds (positive integer). When omitted, the task can run up to 30 minutes. Foreground bash returns inline if the command finishes within ~5s; otherwise it's automatically promoted to background and a completion reminder is delivered when the task actually finishes."),
-      workdir: z3.string().optional().describe("Working directory for command execution. Relative paths resolve through the bridge; defaults to the current tool context/project root when omitted."),
-      description: z3.string().optional().describe("Short 5-10 word human-readable summary shown in OpenCode UI metadata instead of raw shell syntax."),
-      background: z3.boolean().optional().describe("When true, spawn the command in the background and return a task_id for bash_status/bash_kill instead of waiting for completion. Defaults to false."),
-      compressed: z3.boolean().optional().describe("When true or omitted, return compressed output with noisy terminal control sequences reduced. Set to false for raw output."),
-      pty: z3.boolean().optional().describe('When true, spawn the command in a real PTY for interactive programs (python/node/bash REPLs, vim). Requires background: true and is unavailable in subagent sessions. Inspect with bash_status({ taskId, outputMode: "screen" }) and drive interactively with bash_write — its input accepts either a string OR an array like [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ] for atomic text+key sequences.'),
-      ptyRows: z3.number().int().min(1).max(60).optional().describe("PTY terminal height in rows. Applies only when pty: true; defaults to 24. Minimum 1, maximum 60."),
-      ptyCols: z3.number().int().min(1).max(140).optional().describe("PTY terminal width in columns. Applies only when pty: true; defaults to 80. Minimum 1, maximum 140.")
+      command: z4.string().describe("Shell command to execute through AFT's unified bash schema. Supports normal shell syntax, pipes, redirection, and command rewriting to dedicated AFT tools when available."),
+      timeout: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Hard kill cap in milliseconds (positive integer). When omitted, the task can run up to 30 minutes. Foreground bash returns inline if the command finishes within ~5s; otherwise it's automatically promoted to background and a completion reminder is delivered when the task actually finishes."),
+      workdir: z4.string().optional().describe("Working directory for command execution. Relative paths resolve through the bridge; defaults to the current tool context/project root when omitted."),
+      description: z4.string().optional().describe("Short 5-10 word human-readable summary shown in OpenCode UI metadata instead of raw shell syntax."),
+      background: z4.boolean().optional().describe("When true, spawn the command in the background and return a task_id for bash_status/bash_kill instead of waiting for completion. Defaults to false."),
+      compressed: z4.boolean().optional().describe("When true or omitted, return compressed output with noisy terminal control sequences reduced. Set to false for raw output."),
+      pty: z4.boolean().optional().describe('When true, spawn the command in a real PTY for interactive programs (python/node/bash REPLs, vim). Implies background: true automatically. Unavailable in subagent sessions. Inspect with bash_status({ taskId, outputMode: "screen" }) and drive interactively with bash_write — its input accepts either a string OR an array like [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ] for atomic text+key sequences.'),
+      ptyRows: optionalInt(1, 60).describe("PTY terminal height in rows — ignored when pty is false. Defaults to 24 when pty: true. Minimum 1, maximum 60."),
+      ptyCols: optionalInt(1, 140).describe("PTY terminal width in columns — ignored when pty is false. Defaults to 80 when pty: true. Minimum 1, maximum 140.")
     },
     execute: async (args, context) => {
       const bashCfg = resolveBashConfig(ctx.config);
@@ -55434,14 +55463,8 @@ function createBashTool(ctx) {
       const command = args.command;
       const cwd = args.workdir ?? context.directory;
       const isSubagent = await resolveIsSubagent(ctx.client, context.sessionID, context.directory);
-      const requestedBackground = args.background === true;
       const requestedPty = args.pty === true;
-      if (!requestedPty && (args.ptyRows !== undefined || args.ptyCols !== undefined)) {
-        throw new Error("invalid_request: ptyRows/ptyCols require pty: true");
-      }
-      if (requestedPty && !requestedBackground) {
-        throw new Error("PTY mode requires background: true");
-      }
+      const requestedBackground = args.background === true || requestedPty;
       if (requestedPty && isSubagent) {
         throw new Error("PTY mode is not available in subagent sessions; subagents cannot drive interactive terminals.");
       }
@@ -55578,8 +55601,8 @@ function createBashStatusTool(ctx) {
   return {
     description: "Read-only snapshot of a background or PTY bash task's current state and output. Returns immediately. Use bash_watch to block on or register for pattern matches and exit events.",
     args: {
-      taskId: z3.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047."),
-      outputMode: z3.enum(["screen", "raw", "both"]).optional().describe("PTY output rendering mode. Defaults to screen for PTY tasks and preserves existing behavior for piped tasks when omitted.")
+      taskId: z4.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047."),
+      outputMode: z4.enum(["screen", "raw", "both"]).optional().describe("PTY output rendering mode. Defaults to screen for PTY tasks and preserves existing behavior for piped tasks when omitted.")
     },
     execute: async (args, context) => {
       const taskId = args.taskId;
@@ -55593,7 +55616,7 @@ function createBashKillTool(ctx) {
   return {
     description: "Terminate a running background bash task spawned with bash({ background: true }). Returns confirmation of kill or an error if the task already finished.",
     args: {
-      taskId: z3.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047.")
+      taskId: z4.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047.")
     },
     execute: async (args, context) => {
       const data = await callBridge(ctx, context, "bash_kill", {
@@ -55741,8 +55764,8 @@ function shortenCommand(command) {
 
 // src/tools/bash_watch.ts
 import * as fs5 from "node:fs/promises";
-import { tool as tool4 } from "@opencode-ai/plugin";
-var z4 = tool4.schema;
+import { tool as tool5 } from "@opencode-ai/plugin";
+var z5 = tool5.schema;
 var BASH_WAIT_POLL_INTERVAL_MS = 100;
 var DEFAULT_BASH_STATUS_WAIT_TIMEOUT_MS = 30000;
 var MAX_BASH_STATUS_WAIT_TIMEOUT_MS = 300000;
@@ -55751,11 +55774,11 @@ function createBashWatchTool(ctx) {
   return {
     description: "Block on a background bash task until a pattern matches, it exits, or timeout elapses; or register an async pattern notification with background:true.",
     args: {
-      taskId: z4.string().describe("Background task ID returned by bash({ background: true })."),
-      pattern: z4.union([z4.string(), z4.object({ regex: z4.string() })]).optional().describe("Substring or regex pattern. Optional in sync mode; required with background:true."),
-      background: z4.boolean().optional().describe("When true, register an async watch and return immediately. Defaults to false (sync wait)."),
-      timeoutMs: z4.number().int().positive().optional().describe("Sync-only timeout in milliseconds. Default 30000, max 300000."),
-      once: z4.boolean().optional().describe("Async-only. Defaults true; false keeps the watch sticky until task exit.")
+      taskId: z5.string().describe("Background task ID returned by bash({ background: true })."),
+      pattern: z5.union([z5.string(), z5.object({ regex: z5.string() })]).optional().describe("Substring or regex pattern. Optional in sync mode; required with background:true."),
+      background: z5.boolean().optional().describe("When true, register an async watch and return immediately. Defaults to false (sync wait)."),
+      timeoutMs: optionalInt(1, MAX_BASH_STATUS_WAIT_TIMEOUT_MS).describe("Sync-only timeout in milliseconds. Default 30000, max 300000."),
+      once: z5.boolean().optional().describe("Async-only. Defaults true; false keeps the watch sticky until task exit.")
     },
     execute: async (args, context) => {
       const taskId = args.taskId;
@@ -55956,19 +55979,19 @@ function sleep2(ms) {
 }
 
 // src/tools/bash_write.ts
-import { tool as tool5 } from "@opencode-ai/plugin";
-var z5 = tool5.schema;
+import { tool as tool6 } from "@opencode-ai/plugin";
+var z6 = tool6.schema;
 function createBashWriteTool(ctx) {
   return {
     description: 'Write input bytes to a running PTY bash task. PTY-only; check bash_status reports mode: "pty" first. ' + 'Input is either a string (verbatim bytes) or an array mixing strings and { key: "esc" | "enter" | "up" | "ctrl-c" | ... } objects ' + 'for atomic text+key sequences such as [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ]. ' + "Named keys cover enter/return/tab/space/backspace/esc/escape, arrows, home/end/page-up/page-down/delete/insert, f1..f12, and ctrl-a..ctrl-z. " + "Maximum 1 MiB per call (post-expansion).",
     args: {
-      taskId: z5.string().describe("Background PTY task ID returned by bash({ pty: true, background: true })."),
-      input: z5.union([
-        z5.string(),
-        z5.array(z5.union([
-          z5.string(),
-          z5.object({
-            key: z5.string().describe("Named control key, e.g. 'esc', 'enter', 'up', 'ctrl-c'. Case-insensitive.")
+      taskId: z6.string().describe("Background PTY task ID returned by bash({ pty: true, background: true })."),
+      input: z6.union([
+        z6.string(),
+        z6.array(z6.union([
+          z6.string(),
+          z6.object({
+            key: z6.string().describe("Named control key, e.g. 'esc', 'enter', 'up', 'ctrl-c'. Case-insensitive.")
           })
         ]))
       ]).describe("Either a string of verbatim bytes (e.g. 'print(1)\\n') OR an array mixing strings " + "and { key: '<name>' } objects for atomic text+key sequences. " + "Example: [ 'iHello', { key: 'esc' }, ':wq', { key: 'enter' } ].")
@@ -56195,7 +56218,7 @@ function inferBeforeStart(ops, from, beforeLen) {
   }
   return beforeLen;
 }
-var z6 = tool6.schema;
+var z7 = tool7.schema;
 var READ_DESCRIPTION = `Read file contents or list directory entries.
 
 Use either startLine/endLine OR offset/limit to read a section of a file.
@@ -56219,11 +56242,11 @@ function createReadTool(ctx) {
   return {
     description: READ_DESCRIPTION,
     args: {
-      filePath: z6.string().describe("Path to file or directory (absolute or relative to project root)"),
-      startLine: z6.number().optional().describe("1-based line to start reading from"),
-      endLine: z6.number().optional().describe("1-based line to stop reading at (inclusive)"),
-      limit: z6.number().optional().describe("Max lines to return (default: 2000)"),
-      offset: z6.number().optional().describe("1-based line number to start reading from (use with limit). Ignored if startLine is provided")
+      filePath: z7.string().describe("Path to file or directory (absolute or relative to project root)"),
+      startLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line to start reading from"),
+      endLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line to stop reading at (inclusive)"),
+      limit: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Max lines to return (default: 2000)"),
+      offset: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line number to start reading from (use with limit). Ignored if startLine is provided")
     },
     execute: async (args, context) => {
       const file2 = args.filePath;
@@ -56355,8 +56378,8 @@ function createWriteTool(ctx, editToolName = "edit") {
   return {
     description: getWriteDescription(editToolName),
     args: {
-      filePath: z6.string().describe("Path to the file to write (absolute or relative to project root)"),
-      content: z6.string().describe("The full content to write to the file")
+      filePath: z7.string().describe("Path to the file to write (absolute or relative to project root)"),
+      content: z7.string().describe("The full content to write to the file")
     },
     execute: async (args, context) => {
       const file2 = args.filePath;
@@ -56501,16 +56524,16 @@ function createEditTool(ctx, writeToolName = "write") {
   return {
     description: getEditDescription(writeToolName),
     args: {
-      filePath: z6.string().optional().describe("Path to the file to edit (absolute or relative to project root). Required for all modes except 'operations' multi-file transactions"),
-      oldString: z6.string().optional().describe("Text to find (exact match, with fuzzy fallback)"),
-      newString: z6.string().optional().describe("Text to replace with (omit or set to empty string to delete the matched text)"),
-      replaceAll: z6.boolean().optional().describe("Replace all occurrences"),
-      occurrence: z6.number().optional().describe("0-indexed occurrence to replace when multiple matches exist"),
-      symbol: z6.string().optional().describe("Named symbol to replace (function, class, type)"),
-      content: z6.string().optional().describe("New content for symbol replace or file write"),
-      appendContent: z6.string().optional().describe("Text to append to the end of filePath; creates the file if needed"),
-      edits: z6.array(z6.record(z6.string(), z6.unknown())).optional().describe("Batch edits — array of { oldString: string, newString: string } or { startLine: number (1-based), endLine: number (1-based, inclusive), content: string }"),
-      operations: z6.array(z6.record(z6.string(), z6.unknown())).optional().describe("Transaction — array of { file: string, command: 'edit_match' | 'write', match?: string, replacement?: string, content?: string } for multi-file edits with rollback. Note: uses 'file'/'match'/'replacement' (not filePath/oldString/newString)")
+      filePath: z7.string().optional().describe("Path to the file to edit (absolute or relative to project root). Required for all modes except 'operations' multi-file transactions"),
+      oldString: z7.string().optional().describe("Text to find (exact match, with fuzzy fallback)"),
+      newString: z7.string().optional().describe("Text to replace with (omit or set to empty string to delete the matched text)"),
+      replaceAll: z7.boolean().optional().describe("Replace all occurrences"),
+      occurrence: optionalInt(0, Number.MAX_SAFE_INTEGER).describe("0-indexed occurrence to replace when multiple matches exist"),
+      symbol: z7.string().optional().describe("Named symbol to replace (function, class, type)"),
+      content: z7.string().optional().describe("New content for symbol replace or file write"),
+      appendContent: z7.string().optional().describe("Text to append to the end of filePath; creates the file if needed"),
+      edits: z7.array(z7.record(z7.string(), z7.unknown())).optional().describe("Batch edits — array of { oldString: string, newString: string } or { startLine: number (1-based), endLine: number (1-based, inclusive), content: string }"),
+      operations: z7.array(z7.record(z7.string(), z7.unknown())).optional().describe("Transaction — array of { file: string, command: 'edit_match' | 'write', match?: string, replacement?: string, content?: string } for multi-file edits with rollback. Note: uses 'file'/'match'/'replacement' (not filePath/oldString/newString)")
     },
     execute: async (args, context) => {
       const argsRecord = args;
@@ -56726,7 +56749,7 @@ function createApplyPatchTool(ctx) {
   return {
     description: APPLY_PATCH_DESCRIPTION,
     args: {
-      patchText: z6.string().describe("The full patch text including Begin/End markers")
+      patchText: z7.string().describe("The full patch text including Begin/End markers")
     },
     execute: async (args, context) => {
       const patchText = args.patchText;
@@ -57002,8 +57025,8 @@ function createDeleteTool(ctx) {
   return {
     description: DELETE_DESCRIPTION,
     args: {
-      files: z6.array(z6.string()).min(1).describe("Paths to delete (one or more). May include directories when recursive=true."),
-      recursive: z6.boolean().optional().describe("Required to delete a directory and its contents. Defaults to false; passing a directory without this returns an error.")
+      files: z7.array(z7.string()).min(1).describe("Paths to delete (one or more). May include directories when recursive=true."),
+      recursive: z7.boolean().optional().describe("Required to delete a directory and its contents. Defaults to false; passing a directory without this returns an error.")
     },
     execute: async (args, context) => {
       const inputs = args.files;
@@ -57056,8 +57079,8 @@ function createMoveTool(ctx) {
   return {
     description: MOVE_DESCRIPTION,
     args: {
-      filePath: z6.string().describe("Source file path to move"),
-      destination: z6.string().describe("Destination file path")
+      filePath: z7.string().describe("Source file path to move"),
+      destination: z7.string().describe("Destination file path")
     },
     execute: async (args, context) => {
       const filePath = path4.isAbsolute(args.filePath) ? args.filePath : path4.resolve(context.directory, args.filePath);
@@ -57167,8 +57190,8 @@ function aftPrefixedTools(ctx) {
 }
 
 // src/tools/imports.ts
-import { tool as tool7 } from "@opencode-ai/plugin";
-var z7 = tool7.schema;
+import { tool as tool8 } from "@opencode-ai/plugin";
+var z8 = tool8.schema;
 function importTools(ctx) {
   return {
     aft_import: {
@@ -57184,14 +57207,14 @@ function importTools(ctx) {
 ` + `- remove: { file, removed, module, name?, formatted, syntax_valid?, format_skipped_reason?, validation_errors?, validate_skipped_reason?, backup_id?, lsp_diagnostics? }
 ` + "- organize: { file, groups: [{ name, count }], removed_duplicates, formatted?, syntax_valid?, format_skipped_reason?, validation_errors?, validate_skipped_reason?, backup_id?, lsp_diagnostics? }",
       args: {
-        op: z7.enum(["add", "remove", "organize"]).describe("Import operation"),
-        filePath: z7.string().describe("Path to the file (absolute or relative to project root)"),
-        module: z7.string().optional().describe("Module path (required for add, remove — e.g. 'react', './utils', 'std::fmt')"),
-        names: z7.array(z7.string()).optional().describe("Named imports to add (e.g. ['useState', 'useEffect'])"),
-        defaultImport: z7.string().optional().describe("Default import name (e.g. 'React')"),
-        typeOnly: z7.boolean().optional().describe("Type-only import (TS only, default: false)"),
-        removeName: z7.string().optional().describe("Named import to remove for 'remove' op; omit to remove entire import"),
-        validate: z7.enum(["syntax", "full"]).optional().describe("Validation level: 'syntax' (default) or 'full'. Syntax = tree-sitter parse check only. Full = also runs LSP type-checking (slower, catches more errors)")
+        op: z8.enum(["add", "remove", "organize"]).describe("Import operation"),
+        filePath: z8.string().describe("Path to the file (absolute or relative to project root)"),
+        module: z8.string().optional().describe("Module path (required for add, remove — e.g. 'react', './utils', 'std::fmt')"),
+        names: z8.array(z8.string()).optional().describe("Named imports to add (e.g. ['useState', 'useEffect'])"),
+        defaultImport: z8.string().optional().describe("Default import name (e.g. 'React')"),
+        typeOnly: z8.boolean().optional().describe("Type-only import (TS only, default: false)"),
+        removeName: z8.string().optional().describe("Named import to remove for 'remove' op; omit to remove entire import"),
+        validate: z8.enum(["syntax", "full"]).optional().describe("Validation level: 'syntax' (default) or 'full'. Syntax = tree-sitter parse check only. Full = also runs LSP type-checking (slower, catches more errors)")
       },
       execute: async (args, context) => {
         const op = args.op;
@@ -57236,8 +57259,8 @@ function importTools(ctx) {
 }
 
 // src/tools/lsp.ts
-import { tool as tool8 } from "@opencode-ai/plugin";
-var z8 = tool8.schema;
+import { tool as tool9 } from "@opencode-ai/plugin";
+var z9 = tool9.schema;
 function lspTools(ctx) {
   const diagnosticsTool = {
     description: "On-demand LSP file/scope check. Spawns the relevant language server (if " + "registered for the file's extension), opens the document, prefers LSP 3.17 " + "pull diagnostics when supported, and falls back to push + waitMs otherwise. " + "NOT a project-wide type checker — for full coverage run `tsc --noEmit`, " + "`cargo check`, `pyright`, etc.\n" + `
@@ -57259,10 +57282,10 @@ function lspTools(ctx) {
 ` + "- `total: 0, complete: true, lsp_servers_used: [{status: 'pull_ok'}]` → file is genuinely clean.\n" + "- `total: 0, lsp_servers_used: []` → **nothing was checked** (no server registered for this extension). Tell the user, don't claim 'no errors'.\n" + "- `lsp_servers_used: [{status: 'binary_not_installed: <name>'}]` → server matched the extension but its binary isn't on PATH. Tell the user to install it.\n" + "- `lsp_servers_used: [{status: 'no_root_marker (...)'}]` → server is registered but couldn't find a workspace root marker walking up from this file. The user's project layout doesn't match what the server expects.\n" + "- `complete: false` (directory mode) → some files in the directory weren't checked; see `unchecked_files`.\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).",
     args: {
-      filePath: z8.string().optional().describe("Path to a file to check. Mutually exclusive with 'directory'. Omit both to dump all cached diagnostics."),
-      directory: z8.string().optional().describe("Path to a directory. Returns cached diagnostics + workspace pull from active servers; lists files we have no info for in 'unchecked_files'. Capped at 200 walked files."),
-      severity: z8.enum(["error", "warning", "information", "hint", "all"]).optional().describe("Filter by severity (default: 'all')."),
-      waitMs: z8.number().optional().describe("Wait up to N ms (max 10000, default 0) for push diagnostics to arrive. Only matters for servers that don't support LSP 3.17 pull (bash-language-server, yaml-language-server). Use after an edit to let the server re-analyze.")
+      filePath: z9.string().optional().describe("Path to a file to check. Mutually exclusive with 'directory'. Omit both to dump all cached diagnostics."),
+      directory: z9.string().optional().describe("Path to a directory. Returns cached diagnostics + workspace pull from active servers; lists files we have no info for in 'unchecked_files'. Capped at 200 walked files."),
+      severity: z9.enum(["error", "warning", "information", "hint", "all"]).optional().describe("Filter by severity (default: 'all')."),
+      waitMs: optionalInt(1, 1e4).describe("Wait up to N ms (max 10000, default 0) for push diagnostics to arrive. Only matters for servers that don't support LSP 3.17 pull (bash-language-server, yaml-language-server). Use after an edit to let the server re-analyze.")
     },
     execute: async (args, context) => {
       const filePath = args.filePath || undefined;
@@ -57293,8 +57316,8 @@ function lspTools(ctx) {
 }
 
 // src/tools/navigation.ts
-import { tool as tool9 } from "@opencode-ai/plugin";
-var z9 = tool9.schema;
+import { tool as tool10 } from "@opencode-ai/plugin";
+var z10 = tool10.schema;
 function navigationTools(ctx) {
   return {
     aft_navigate: {
@@ -57311,11 +57334,11 @@ function navigationTools(ctx) {
 
 `,
       args: {
-        op: z9.enum(["call_tree", "callers", "trace_to", "impact", "trace_data"]).describe("Navigation operation"),
-        filePath: z9.string().describe("Path to the source file containing the symbol (absolute or relative to project root)"),
-        symbol: z9.string().describe("Name of the symbol to analyze"),
-        depth: z9.number().optional().describe("Max traversal depth (default: call_tree=5, callers=1, trace_to=10, impact=5, trace_data=5)"),
-        expression: z9.string().optional().describe("Expression to track through data flow (required for trace_data op)")
+        op: z10.enum(["call_tree", "callers", "trace_to", "impact", "trace_data"]).describe("Navigation operation"),
+        filePath: z10.string().describe("Path to the source file containing the symbol (absolute or relative to project root)"),
+        symbol: z10.string().describe("Name of the symbol to analyze"),
+        depth: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Max traversal depth (default: call_tree=5, callers=1, trace_to=10, impact=5, trace_data=5)"),
+        expression: z10.string().optional().describe("Expression to track through data flow (required for trace_data op)")
       },
       execute: async (args, context) => {
         const params = {
@@ -57341,8 +57364,8 @@ function navigationTools(ctx) {
 
 // src/tools/reading.ts
 import { resolve as resolve8 } from "node:path";
-import { tool as tool10 } from "@opencode-ai/plugin";
-var z10 = tool10.schema;
+import { tool as tool11 } from "@opencode-ai/plugin";
+var z11 = tool11.schema;
 function readingTools(ctx) {
   return {
     aft_outline: {
@@ -57353,7 +57376,7 @@ function readingTools(ctx) {
 ` + `  • URL (http:// or https://) → fetch and outline a remote HTML/Markdown document
 ` + "  • array of paths → outline multiple files in one call",
       args: {
-        target: z10.union([z10.string(), z10.array(z10.string())]).describe("What to outline: a file path, directory path, URL, or array of file paths. The mode is auto-detected: URLs by `http://`/`https://` prefix, directories by stat, arrays as multi-file.")
+        target: z11.union([z11.string(), z11.array(z11.string())]).describe("What to outline: a file path, directory path, URL, or array of file paths. The mode is auto-detected: URLs by `http://`/`https://` prefix, directories by stat, arrays as multi-file.")
       },
       execute: async (args, context) => {
         const target = args.target;
@@ -57408,11 +57431,11 @@ function readingTools(ctx) {
 
 Provide exactly ONE of 'filePath' or 'url'. Pass either 'symbol' for a single lookup or 'symbols' for multiple in one call.`,
       args: {
-        filePath: z10.string().optional().describe("Path to file (absolute or relative to project root)"),
-        url: z10.string().optional().describe("HTTP/HTTPS URL of an HTML or Markdown document to fetch and zoom into"),
-        symbol: z10.string().optional().describe("Symbol name for code, or heading text for Markdown/HTML"),
-        symbols: z10.array(z10.string()).optional().describe("Array of symbol names or heading texts for a single batched call"),
-        contextLines: z10.number().optional().describe("Lines of context before/after the symbol (default: 3)")
+        filePath: z11.string().optional().describe("Path to file (absolute or relative to project root)"),
+        url: z11.string().optional().describe("HTTP/HTTPS URL of an HTML or Markdown document to fetch and zoom into"),
+        symbol: z11.string().optional().describe("Symbol name for code, or heading text for Markdown/HTML"),
+        symbols: z11.array(z11.string()).optional().describe("Array of symbol names or heading texts for a single batched call"),
+        contextLines: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Lines of context before/after the symbol (default: 3)")
       },
       execute: async (args, context) => {
         const hasFilePath = typeof args.filePath === "string" && args.filePath.length > 0;
@@ -57494,7 +57517,7 @@ ${lines}`;
 }
 
 // src/tools/refactoring.ts
-import { tool as tool11 } from "@opencode-ai/plugin";
+import { tool as tool12 } from "@opencode-ai/plugin";
 
 // src/lsp.ts
 var LSP_SYMBOL_KIND_MAP = {
@@ -57553,7 +57576,7 @@ async function queryLspHints(client, symbolName, directory, sessionId) {
 }
 
 // src/tools/refactoring.ts
-var z11 = tool11.schema;
+var z12 = tool12.schema;
 function refactoringTools(ctx) {
   return {
     aft_refactor: {
@@ -57571,15 +57594,15 @@ function refactoringTools(ctx) {
 
 ` + "Returns: move { ok, files_modified, consumers_updated, checkpoint_name, results }. extract returns { file, name, parameters, return_type, syntax_valid, formatted, ... }. inline returns { file, symbol, call_context, substitutions, conflicts, syntax_valid, formatted, ... }.",
       args: {
-        op: z11.enum(["move", "extract", "inline"]).describe("Refactoring operation"),
-        filePath: z11.string().describe("Path to the source file (absolute or relative to project root)"),
-        symbol: z11.string().optional().describe("Symbol name — required for 'move' and 'inline' ops"),
-        destination: z11.string().optional().describe("Target file path — required for 'move' op"),
-        scope: z11.string().optional().describe("Disambiguation scope for 'move' op — when multiple top-level symbols share the same name, specify the containing scope to disambiguate (e.g. 'MyClass'). Does NOT enable access to nested symbols or class methods."),
-        name: z11.string().optional().describe("New function name — required for 'extract' op"),
-        startLine: z11.number().optional().describe("1-based start line — required for 'extract' op"),
-        endLine: z11.number().optional().describe("1-based end line (inclusive) — required for 'extract' op"),
-        callSiteLine: z11.number().optional().describe("1-based call site line — required for 'inline' op")
+        op: z12.enum(["move", "extract", "inline"]).describe("Refactoring operation"),
+        filePath: z12.string().describe("Path to the source file (absolute or relative to project root)"),
+        symbol: z12.string().optional().describe("Symbol name — required for 'move' and 'inline' ops"),
+        destination: z12.string().optional().describe("Target file path — required for 'move' op"),
+        scope: z12.string().optional().describe("Disambiguation scope for 'move' op — when multiple top-level symbols share the same name, specify the containing scope to disambiguate (e.g. 'MyClass'). Does NOT enable access to nested symbols or class methods."),
+        name: z12.string().optional().describe("New function name — required for 'extract' op"),
+        startLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based start line — required for 'extract' op"),
+        endLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based end line (inclusive) — required for 'extract' op"),
+        callSiteLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based call site line — required for 'inline' op")
       },
       execute: async (args, context) => {
         const op = args.op;
@@ -57660,8 +57683,8 @@ function refactoringTools(ctx) {
 
 // src/tools/safety.ts
 import * as path5 from "node:path";
-import { tool as tool12 } from "@opencode-ai/plugin";
-var z12 = tool12.schema;
+import { tool as tool13 } from "@opencode-ai/plugin";
+var z13 = tool13.schema;
 function safetyTools(ctx) {
   return {
     aft_safety: {
@@ -57682,10 +57705,10 @@ function safetyTools(ctx) {
 
 ` + "Returns: undo { path, backup_id }. history { file, entries }. checkpoint { ok, name }. restore { ok, name }. list { checkpoints }.",
       args: {
-        op: z12.enum(["undo", "history", "checkpoint", "restore", "list"]).describe("Safety operation"),
-        filePath: z12.string().optional().describe("File path (required for history, optional for undo). Absolute or relative to project root"),
-        name: z12.string().optional().describe("Checkpoint name (required for checkpoint, restore)"),
-        files: z12.array(z12.string()).optional().describe("Specific files to include in checkpoint (optional, defaults to all tracked files)")
+        op: z13.enum(["undo", "history", "checkpoint", "restore", "list"]).describe("Safety operation"),
+        filePath: z13.string().optional().describe("File path (required for history, optional for undo). Absolute or relative to project root"),
+        name: z13.string().optional().describe("Checkpoint name (required for checkpoint, restore)"),
+        files: z13.array(z13.string()).optional().describe("Specific files to include in checkpoint (optional, defaults to all tracked files)")
       },
       execute: async (args, context) => {
         const op = args.op;
@@ -57927,6 +57950,8 @@ function searchTools(ctx) {
 }
 
 // src/tools/semantic.ts
+import { tool as tool14 } from "@opencode-ai/plugin";
+var z14 = tool14.schema;
 function arg2(schema) {
   return schema;
 }
@@ -57951,8 +57976,8 @@ function semanticTools(ctx) {
     ].join(`
 `),
     args: {
-      query: arg2(exports_external.string().describe("Concept or capability to find, phrased as a programmer would describe the code. Examples: 'fuzzy match with whitespace tolerance', 'undo backup before edit', 'retry failed network request'.")),
-      topK: arg2(exports_external.number().optional().describe("Number of results (default: 10, max: 100)"))
+      query: arg2(z14.string().describe("Concept or capability to find, phrased as a programmer would describe the code. Examples: 'fuzzy match with whitespace tolerance', 'undo backup before edit', 'retry failed network request'.")),
+      topK: arg2(optionalInt(1, 100).describe("Number of results (default: 10, max: 100)"))
     },
     execute: async (args, context) => {
       const response = await callBridge(ctx, context, "semantic_search", {
@@ -57977,8 +58002,8 @@ function semanticTools(ctx) {
 }
 
 // src/tools/structure.ts
-import { tool as tool13 } from "@opencode-ai/plugin";
-var z13 = tool13.schema;
+import { tool as tool15 } from "@opencode-ai/plugin";
+var z15 = tool15.schema;
 function structureTools(ctx) {
   return {
     aft_transform: {
@@ -58002,19 +58027,19 @@ function structureTools(ctx) {
 ` + `- add_decorator: { file, target, decorator, formatted, syntax_valid?, format_skipped_reason?, validation_errors?, validate_skipped_reason?, backup_id?, lsp_diagnostics? }
 ` + "- add_struct_tags: { file, target, field, tag_string, formatted, syntax_valid?, format_skipped_reason?, validation_errors?, validate_skipped_reason?, backup_id?, lsp_diagnostics? }",
       args: {
-        op: z13.enum(["add_member", "add_derive", "wrap_try_catch", "add_decorator", "add_struct_tags"]).describe("Transformation operation"),
-        filePath: z13.string().describe("Path to the source file (absolute or relative to project root)"),
-        container: z13.string().optional().describe("Container name for add_member — the class, struct, or impl block to insert into. Appears as 'scope' in the response."),
-        code: z13.string().optional().describe("Member code to insert (add_member)"),
-        position: z13.string().optional().describe("For add_member: 'first', 'last' (default), 'before:name', 'after:name'. For add_decorator: 'first' (default) or 'last' only."),
-        target: z13.string().optional().describe("Target symbol name (add_derive: struct/enum, wrap_try_catch: function, add_decorator: function/class, add_struct_tags: struct)"),
-        derives: z13.array(z13.string()).optional().describe("Derive macro names (add_derive — e.g. ['Clone', 'Debug'])"),
-        catchBody: z13.string().optional().describe("Catch block body (wrap_try_catch — default: 'throw error;')"),
-        decorator: z13.string().optional().describe("Decorator text without @ (add_decorator — e.g. 'staticmethod')"),
-        field: z13.string().optional().describe("Struct field name (add_struct_tags)"),
-        tag: z13.string().optional().describe("Tag key (add_struct_tags — e.g. 'json')"),
-        value: z13.string().optional().describe("Tag value (add_struct_tags — e.g. 'user_name,omitempty')"),
-        validate: z13.enum(["syntax", "full"]).optional().describe("Validation level: 'syntax' (default) or 'full'. Syntax = tree-sitter parse check only. Full = also runs LSP type-checking (slower, catches more errors)")
+        op: z15.enum(["add_member", "add_derive", "wrap_try_catch", "add_decorator", "add_struct_tags"]).describe("Transformation operation"),
+        filePath: z15.string().describe("Path to the source file (absolute or relative to project root)"),
+        container: z15.string().optional().describe("Container name for add_member — the class, struct, or impl block to insert into. Appears as 'scope' in the response."),
+        code: z15.string().optional().describe("Member code to insert (add_member)"),
+        position: z15.string().optional().describe("For add_member: 'first', 'last' (default), 'before:name', 'after:name'. For add_decorator: 'first' (default) or 'last' only."),
+        target: z15.string().optional().describe("Target symbol name (add_derive: struct/enum, wrap_try_catch: function, add_decorator: function/class, add_struct_tags: struct)"),
+        derives: z15.array(z15.string()).optional().describe("Derive macro names (add_derive — e.g. ['Clone', 'Debug'])"),
+        catchBody: z15.string().optional().describe("Catch block body (wrap_try_catch — default: 'throw error;')"),
+        decorator: z15.string().optional().describe("Decorator text without @ (add_decorator — e.g. 'staticmethod')"),
+        field: z15.string().optional().describe("Struct field name (add_struct_tags)"),
+        tag: z15.string().optional().describe("Tag key (add_struct_tags — e.g. 'json')"),
+        value: z15.string().optional().describe("Tag value (add_struct_tags — e.g. 'user_name,omitempty')"),
+        validate: z15.enum(["syntax", "full"]).optional().describe("Validation level: 'syntax' (default) or 'full'. Syntax = tree-sitter parse check only. Full = also runs LSP type-checking (slower, catches more errors)")
       },
       execute: async (args, context) => {
         const op = args.op;

package/dist/tools/_shared.d.ts

@@ -17,6 +17,45 @@
  */
 import type { BinaryBridge, BridgeRequestOptions } from "@cortexkit/aft-bridge";
 import type { PluginContext } from "../types.js";
+/**
+ * Optional integer with bounds.
+ *
+ * MUST be JSON-Schema-representable for OpenCode tool registration to
+ * succeed: OpenCode wraps plugin args in a host `z.object()` and runs
+ * `z.toJSONSchema(args, { io: "input" })` at session start. Any node
+ * the host's Zod can't convert (e.g. `.transform()`, `.preprocess()`)
+ * throws "Transforms cannot be represented in JSON Schema" and the
+ * entire plugin fails to load. Keep this a plain schema — no
+ * transforms. Empty-sentinel coercion (null/""/0 → undefined) belongs
+ * in tool handlers via `coerceOptionalInt`, not in the schema.
+ *
+ * Regression guard: `tool-schemas-json-convertible.test.ts` runs
+ * `z.toJSONSchema(z.object(args), { io: "input" })` on every plugin
+ * tool. If anyone reintroduces a `.transform()` here it fails before
+ * shipping.
+ *
+ * Return type is `any` to suppress TS2742 — Zod's inferred type leaks
+ * `.bun/zod@...` paths that aren't portable across the host SDK and
+ * our zod version. The type annotation has no runtime effect; the
+ * contract test is the real invariant.
+ */
+export declare const optionalInt: (min: number, max: number) => any;
+/**
+ * Runtime coercion for agent-friendly sentinel handling.
+ *
+ * Some agents emit null / "" / 0 when they mean "param not provided".
+ * Use this inside tool handlers BEFORE relying on the value. Returns
+ * `undefined` for all empty sentinels; rejects out-of-bounds with a
+ * clear message.
+ *
+ * Tool handlers that want sentinel tolerance must pass args through
+ * this AFTER Zod validation has accepted the value (or for fields
+ * declared as `z.unknown().optional()` that bypass type validation).
+ * With `optionalInt`'s bounded `z.number().int()` schema, Zod already
+ * rejects the sentinels — call this for defense in depth or for fields
+ * declared more permissively.
+ */
+export declare function coerceOptionalInt(v: unknown, paramName: string, min: number, max: number): number | undefined;
 /**
  * Per-command timeout overrides (milliseconds).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAOhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;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;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAW3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE9F"}
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/tools/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,GACR,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,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;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAW3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE9F"}

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

@@ -1 +1 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/tools/ast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkDjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA6S3E"}
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/tools/ast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkDjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4S3E"}

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

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAavE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0EjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAmRjE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAyBvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAuBrE"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAavE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0EjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAkQjE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAyBvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAuBrE"}

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

@@ -1 +1 @@
-{"version":3,"file":"bash_watch.d.ts","sourceRoot":"","sources":["../../src/tools/bash_watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAavE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AACF,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAElF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA4FtE;AAiDD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAsCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAK5E"}
+{"version":3,"file":"bash_watch.d.ts","sourceRoot":"","sources":["../../src/tools/bash_watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAavE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AACF,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAElF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAyFtE;AAiDD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAsCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAK5E"}

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

@@ -1 +1 @@
-{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyEjD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAChD,CAAC;AAqRtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CA+JjE;AAmmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0B/E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA8FnF"}
+{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyEjD,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAChD,CAAC;AAqRtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAkKjE;AAkmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0B/E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA8FnF"}

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

@@ -1 +1 @@
-{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/tools/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAkF3E"}
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/tools/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA+E3E"}

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

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAqDlF"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/tools/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAkDlF"}

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

@@ -1 +1 @@
-{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,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;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA2J/E;AAED;;;;;;GAMG;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":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,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;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0J/E;AAED;;;;;;GAMG;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"}

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

@@ -1 +1 @@
-{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/tools/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyDhF"}
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/tools/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWjD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyDhF"}

package/dist/tui.js

@@ -3,7 +3,7 @@ import { createMemo as createMemo2, createSignal as createSignal2, onCleanup as
 // package.json
 var package_default = {
   name: "@cortexkit/aft-opencode",
-  version: "0.30.0",
+  version: "0.30.1",
   type: "module",
   description: "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   main: "dist/index.js",
@@ -32,7 +32,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.30.0",
+    "@cortexkit/aft-bridge": "0.30.1",
     "@opencode-ai/plugin": "^1.15.5",
     "@opencode-ai/sdk": "^1.15.5",
     "@xterm/headless": "^5.5.0",
@@ -41,12 +41,12 @@ var package_default = {
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.30.0",
-    "@cortexkit/aft-darwin-x64": "0.30.0",
-    "@cortexkit/aft-linux-arm64": "0.30.0",
-    "@cortexkit/aft-linux-x64": "0.30.0",
-    "@cortexkit/aft-win32-arm64": "0.30.0",
-    "@cortexkit/aft-win32-x64": "0.30.0"
+    "@cortexkit/aft-darwin-arm64": "0.30.1",
+    "@cortexkit/aft-darwin-x64": "0.30.1",
+    "@cortexkit/aft-linux-arm64": "0.30.1",
+    "@cortexkit/aft-linux-x64": "0.30.1",
+    "@cortexkit/aft-win32-arm64": "0.30.1",
+    "@cortexkit/aft-win32-x64": "0.30.1"
   },
   devDependencies: {
     "@types/node": "^22.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.30.0",
+    "@cortexkit/aft-bridge": "0.30.1",
     "@opencode-ai/plugin": "^1.15.5",
     "@opencode-ai/sdk": "^1.15.5",
     "@xterm/headless": "^5.5.0",
@@ -38,12 +38,12 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.30.0",
-    "@cortexkit/aft-darwin-x64": "0.30.0",
-    "@cortexkit/aft-linux-arm64": "0.30.0",
-    "@cortexkit/aft-linux-x64": "0.30.0",
-    "@cortexkit/aft-win32-arm64": "0.30.0",
-    "@cortexkit/aft-win32-x64": "0.30.0"
+    "@cortexkit/aft-darwin-arm64": "0.30.1",
+    "@cortexkit/aft-darwin-x64": "0.30.1",
+    "@cortexkit/aft-linux-arm64": "0.30.1",
+    "@cortexkit/aft-linux-x64": "0.30.1",
+    "@cortexkit/aft-win32-arm64": "0.30.1",
+    "@cortexkit/aft-win32-x64": "0.30.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",