@cortexkit/aft-opencode 0.10.1 → 0.11.0

package/dist/pool.d.ts

@@ -23,7 +23,7 @@ export declare class BridgePool {
      * The bridge's working directory is set to `directory`.
      */
     /** Get any existing bridge that is configured and alive, preferring the given directory. */
-    getAnyActiveBridge(directory: string): BinaryBridge | null;
+    getAnyActiveBridge(_directory: string): BinaryBridge | null;
     getBridge(directory: string, sessionID: string): BinaryBridge;
     /** Shut down idle bridges that haven't been used within the timeout. */
     private cleanup;

package/dist/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAY5D,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,YAAY,CAA+C;gBAGjE,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,EACzB,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAmB/C;;;;OAIG;IACH,4FAA4F;IAC5F,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAW1D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY;IAwB7D,wEAAwE;IACxE,OAAO,CAAC,OAAO;IAUf,yDAAyD;IACzD,OAAO,CAAC,QAAQ;IAgBhB,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnD,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAY5D,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,YAAY,CAA+C;gBAGjE,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,EACzB,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAmB/C;;;;OAIG;IACH,4FAA4F;IAC5F,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAW3D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY;IAwB7D,wEAAwE;IACxE,OAAO,CAAC,OAAO;IAUf,yDAAyD;IACzD,OAAO,CAAC,QAAQ;IAgBhB,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnD,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/shared/tui-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui-config.d.ts","sourceRoot":"","sources":["../../src/shared/tui-config.ts"],"names":[],"mappings":"AAoHA,wBAAgB,oBAAoB,IAAI,OAAO,CAsC9C"}
+{"version":3,"file":"tui-config.d.ts","sourceRoot":"","sources":["../../src/shared/tui-config.ts"],"names":[],"mappings":"AAmBA,wBAAgB,oBAAoB,IAAI,OAAO,CAsC9C"}

package/dist/shared/url-fetch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fetch a URL to a cached temp file. Uses disk cache with 1-day TTL.
+ * Returns the cached file path the Rust outline/zoom command can read.
+ * Throws on errors (invalid URL, network failure, unsupported content type, oversized body).
+ */
+export declare function fetchUrlToTempFile(url: string, storageDir: string): Promise<string>;
+/**
+ * Remove cache entries older than TTL. Called periodically at plugin startup.
+ */
+export declare function cleanupUrlCache(storageDir: string): void;
+//# sourceMappingURL=url-fetch.d.ts.map

package/dist/shared/url-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-fetch.d.ts","sourceRoot":"","sources":["../../src/shared/url-fetch.ts"],"names":[],"mappings":"AA4EA;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoHzF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAkCxD"}

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;AA0CjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAiJ/E"}
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0CjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuK/E"}

package/dist/types.d.ts

@@ -9,5 +9,7 @@ export interface PluginContext {
     pool: BridgePool;
     client: PluginInput["client"];
     config: AftConfig;
+    /** Absolute path to AFT's storage dir (e.g. ~/.local/share/opencode/storage/plugin/aft) */
+    storageDir: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -17,28 +17,28 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @opencode-ai/plugin && tsc --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
     "pretest": "cd ../.. && cargo build",
     "test": "bun test",
     "test:e2e": "bun test src/__tests__/e2e/",
-    "prepublishOnly": "tsc"
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@opencode-ai/plugin": "^1.2.26",
     "@opencode-ai/sdk": "^1.2.26",
-    "jsonc-parser": "^3.3.1",
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.10.1",
-    "@cortexkit/aft-darwin-x64": "0.10.1",
-    "@cortexkit/aft-linux-arm64": "0.10.1",
-    "@cortexkit/aft-linux-x64": "0.10.1",
-    "@cortexkit/aft-win32-x64": "0.10.1"
+    "@cortexkit/aft-darwin-arm64": "0.11.0",
+    "@cortexkit/aft-darwin-x64": "0.11.0",
+    "@cortexkit/aft-linux-arm64": "0.11.0",
+    "@cortexkit/aft-linux-x64": "0.11.0",
+    "@cortexkit/aft-win32-x64": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "comment-json": "^4.6.2",
     "typescript": "^5.8.0"
   },
   "exports": {

package/src/shared/tui-config.ts

@@ -1,109 +1,12 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { parse, stringify } from "comment-json";
 import { log } from "../logger.js";
 import { getOpenCodeConfigPaths } from "./opencode-config-dir.js";
 
 const PLUGIN_NAME = "@cortexkit/aft-opencode";
 const PLUGIN_ENTRY = `${PLUGIN_NAME}@latest`;
 
-function stripJsoncComments(text: string): string {
-  let result = "";
-  let i = 0;
-  let inString = false;
-  let escaped = false;
-
-  while (i < text.length) {
-    const ch = text[i];
-
-    if (inString) {
-      result += ch;
-      if (escaped) {
-        escaped = false;
-      } else if (ch === "\\") {
-        escaped = true;
-      } else if (ch === '"') {
-        inString = false;
-      }
-      i++;
-      continue;
-    }
-
-    if (ch === '"') {
-      inString = true;
-      result += ch;
-      i++;
-      continue;
-    }
-
-    if (ch === "/" && text[i + 1] === "/") {
-      i += 2;
-      while (i < text.length && text[i] !== "\n") i++;
-      continue;
-    }
-
-    if (ch === "/" && text[i + 1] === "*") {
-      i += 2;
-      while (i < text.length && !(text[i] === "*" && text[i + 1] === "/")) i++;
-      i += 2;
-      continue;
-    }
-
-    result += ch;
-    i++;
-  }
-
-  return result;
-}
-
-function stripTrailingCommas(text: string): string {
-  let result = "";
-  let i = 0;
-  let inString = false;
-  let escaped = false;
-
-  while (i < text.length) {
-    const ch = text[i];
-
-    if (inString) {
-      result += ch;
-      if (escaped) {
-        escaped = false;
-      } else if (ch === "\\") {
-        escaped = true;
-      } else if (ch === '"') {
-        inString = false;
-      }
-      i++;
-      continue;
-    }
-
-    if (ch === '"') {
-      inString = true;
-      result += ch;
-      i++;
-      continue;
-    }
-
-    if (ch === ",") {
-      let j = i + 1;
-      while (j < text.length && /\s/.test(text[j])) j++;
-      if (text[j] === "}" || text[j] === "]") {
-        i++;
-        continue;
-      }
-    }
-
-    result += ch;
-    i++;
-  }
-
-  return result;
-}
-
-function parseJsonc<T>(content: string): T {
-  return JSON.parse(stripTrailingCommas(stripJsoncComments(content))) as T;
-}
-
 function resolveTuiConfigPath(): string {
   const configDir = getOpenCodeConfigPaths({ binary: "opencode" }).configDir;
   const jsoncPath = join(configDir, "tui.jsonc");
@@ -120,7 +23,7 @@ export function ensureTuiPluginEntry(): boolean {
 
     let config: Record<string, unknown> = {};
     if (existsSync(configPath)) {
-      config = parseJsonc<Record<string, unknown>>(readFileSync(configPath, "utf-8")) ?? {};
+      config = (parse(readFileSync(configPath, "utf-8")) as Record<string, unknown>) ?? {};
     }
 
     const plugins = Array.isArray(config.plugin)
@@ -143,7 +46,7 @@ export function ensureTuiPluginEntry(): boolean {
     config.plugin = plugins;
 
     mkdirSync(dirname(configPath), { recursive: true });
-    writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
+    writeFileSync(configPath, `${stringify(config, null, 2)}\n`);
     log(`[aft-plugin] added TUI plugin entry to ${configPath}`);
     return true;
   } catch (error) {

package/src/shared/url-fetch.ts

@@ -0,0 +1,237 @@
+import { createHash } from "node:crypto";
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { join } from "node:path";
+import { log, warn } from "../logger.js";
+
+/** Max response body size (10 MB) */
+const MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
+/** Cache TTL: 1 day */
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** Fetch timeout: 30 seconds */
+const FETCH_TIMEOUT_MS = 30_000;
+
+interface CacheMeta {
+  url: string;
+  contentType: string;
+  extension: string;
+  fetchedAt: number;
+}
+
+function cacheDir(storageDir: string): string {
+  return join(storageDir, "url_cache");
+}
+
+function hashUrl(url: string): string {
+  return createHash("sha256").update(url).digest("hex").slice(0, 16);
+}
+
+function metaPath(storageDir: string, hash: string): string {
+  return join(cacheDir(storageDir), `${hash}.meta.json`);
+}
+
+function contentPath(storageDir: string, hash: string, extension: string): string {
+  return join(cacheDir(storageDir), `${hash}${extension}`);
+}
+
+/**
+ * Map a Content-Type header to a file extension AFT can parse.
+ * Returns null for unsupported types.
+ */
+function resolveExtension(contentType: string): string | null {
+  // Normalize: strip parameters (after `;`) AND pick the first value if the server
+  // echoed back a comma-separated list (GitHub API does this for /readme endpoints).
+  const lower = contentType.toLowerCase().split(";")[0].split(",")[0].trim();
+  if (
+    lower === "text/html" ||
+    lower === "application/xhtml+xml" ||
+    lower === "application/vnd.github.html" ||
+    lower === "application/vnd.github+html"
+  ) {
+    return ".html";
+  }
+  if (
+    lower === "text/markdown" ||
+    lower === "text/x-markdown" ||
+    lower === "application/markdown" ||
+    // GitHub API raw content type — returns raw markdown for README endpoints
+    lower === "application/vnd.github.raw" ||
+    lower === "application/vnd.github+raw" ||
+    lower === "application/vnd.github.v3.raw"
+  ) {
+    return ".md";
+  }
+  if (lower === "text/plain") {
+    // treat plain text as markdown so aft_outline can show headings if present
+    return ".md";
+  }
+  return null;
+}
+
+/**
+ * Fetch a URL to a cached temp file. Uses disk cache with 1-day TTL.
+ * Returns the cached file path the Rust outline/zoom command can read.
+ * Throws on errors (invalid URL, network failure, unsupported content type, oversized body).
+ */
+export async function fetchUrlToTempFile(url: string, storageDir: string): Promise<string> {
+  let parsed: URL;
+  try {
+    parsed = new URL(url);
+  } catch {
+    throw new Error(`Invalid URL: ${url}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error(`Only http:// and https:// URLs are supported, got: ${parsed.protocol}`);
+  }
+
+  const dir = cacheDir(storageDir);
+  mkdirSync(dir, { recursive: true });
+
+  const hash = hashUrl(url);
+  const metaFile = metaPath(storageDir, hash);
+
+  // Check cache
+  if (existsSync(metaFile)) {
+    try {
+      const meta = JSON.parse(readFileSync(metaFile, "utf8")) as CacheMeta;
+      const age = Date.now() - meta.fetchedAt;
+      const cached = contentPath(storageDir, hash, meta.extension);
+      if (age < CACHE_TTL_MS && existsSync(cached)) {
+        log(`URL cache hit: ${url} (${Math.round(age / 1000)}s old)`);
+        return cached;
+      }
+    } catch {
+      // corrupted meta, re-fetch
+    }
+  }
+
+  log(`Fetching URL: ${url}`);
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  let response: Response;
+  try {
+    response = await fetch(url, {
+      signal: controller.signal,
+      redirect: "follow",
+      headers: {
+        "user-agent": "aft-opencode-plugin",
+        // Prioritize markdown for content-negotiating servers (GitHub API, many docs sites).
+        // `application/vnd.github.raw` is GitHub's custom type — returns raw markdown from
+        // repo file and readme endpoints. Falls back to HTML if markdown is not available.
+        accept:
+          "application/vnd.github.raw, text/markdown, text/x-markdown, text/html;q=0.9, text/plain;q=0.5",
+      },
+    });
+  } catch (err) {
+    throw new Error(`Failed to fetch ${url}: ${(err as Error).message}`);
+  } finally {
+    clearTimeout(timer);
+  }
+
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status} ${response.statusText} fetching ${url}`);
+  }
+
+  const contentType = response.headers.get("content-type") || "text/plain";
+  const extension = resolveExtension(contentType);
+  if (!extension) {
+    throw new Error(
+      `Unsupported content type '${contentType}' for ${url}. Supported: text/html, text/markdown, text/plain`,
+    );
+  }
+
+  const lengthHeader = response.headers.get("content-length");
+  if (lengthHeader) {
+    const length = Number.parseInt(lengthHeader, 10);
+    if (Number.isFinite(length) && length > MAX_RESPONSE_BYTES) {
+      throw new Error(`Response too large: ${length} bytes (max ${MAX_RESPONSE_BYTES})`);
+    }
+  }
+
+  // Stream with size cap
+  const reader = response.body?.getReader();
+  if (!reader) {
+    throw new Error(`Failed to read response body for ${url}`);
+  }
+  const chunks: Uint8Array[] = [];
+  let total = 0;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (value) {
+      total += value.length;
+      if (total > MAX_RESPONSE_BYTES) {
+        reader.cancel().catch(() => {});
+        throw new Error(`Response exceeded ${MAX_RESPONSE_BYTES} bytes, aborted`);
+      }
+      chunks.push(value);
+    }
+  }
+
+  // Write content and meta atomically
+  const body = Buffer.concat(chunks);
+  const contentFile = contentPath(storageDir, hash, extension);
+  const tmpContent = `${contentFile}.tmp-${process.pid}`;
+  writeFileSync(tmpContent, body);
+  const { renameSync } = await import("node:fs");
+  renameSync(tmpContent, contentFile);
+
+  const meta: CacheMeta = {
+    url,
+    contentType,
+    extension,
+    fetchedAt: Date.now(),
+  };
+  const tmpMeta = `${metaFile}.tmp-${process.pid}`;
+  writeFileSync(tmpMeta, JSON.stringify(meta));
+  renameSync(tmpMeta, metaFile);
+
+  log(`URL cached (${total} bytes): ${url}`);
+  return contentFile;
+}
+
+/**
+ * Remove cache entries older than TTL. Called periodically at plugin startup.
+ */
+export function cleanupUrlCache(storageDir: string): void {
+  const dir = cacheDir(storageDir);
+  if (!existsSync(dir)) return;
+
+  let removed = 0;
+  try {
+    for (const entry of readdirSync(dir)) {
+      if (!entry.endsWith(".meta.json")) continue;
+      const metaFile = join(dir, entry);
+      try {
+        const meta = JSON.parse(readFileSync(metaFile, "utf8")) as CacheMeta;
+        const age = Date.now() - meta.fetchedAt;
+        if (age > CACHE_TTL_MS) {
+          const hash = entry.slice(0, -".meta.json".length);
+          const content = contentPath(storageDir, hash, meta.extension);
+          if (existsSync(content)) unlinkSync(content);
+          unlinkSync(metaFile);
+          removed++;
+        }
+      } catch {
+        // corrupted meta, remove it too
+        try {
+          unlinkSync(metaFile);
+          removed++;
+        } catch {}
+      }
+    }
+  } catch (err) {
+    warn(`URL cache cleanup failed: ${(err as Error).message}`);
+    return;
+  }
+  if (removed > 0) {
+    log(`URL cache cleanup: removed ${removed} stale entries`);
+  }
+}