@cortexkit/aft-opencode 0.2.0

package/dist/downloader.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * AFT (Agent File Toolkit) plugin for OpenCode.
+ *
+ * Config is loaded from two levels (project overrides user):
+ * - User:    ~/.config/opencode/aft.jsonc (or .json)
+ * - Project: <project>/.opencode/aft.jsonc (or .json)
+ *
+ * Tools organized into groups:
+ * - Reading: aft_outline, aft_zoom
+ * - Editing: aft_edit
+ * - Safety: aft_safety
+ * - Imports: aft_import
+ * - Structure: aft_transform
+ * - Navigation: aft_navigate
+ * - Refactoring: aft_refactor
+ * - AST Search: aft_ast_search, aft_ast_replace\n * - LSP: aft_lsp_diagnostics, aft_lsp_hover, aft_lsp_goto_definition, aft_lsp_find_references, aft_lsp_prepare_rename, aft_lsp_rename
+ */
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAelD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,MAAM,EAAE,MAgCb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,62 @@
+import { loadAftConfig } from "./config.js";
+import { BridgePool } from "./pool.js";
+import { findBinary } from "./resolver.js";
+import { astTools } from "./tools/ast.js";
+import { editingTools } from "./tools/editing.js";
+import { importTools } from "./tools/imports.js";
+import { lspTools } from "./tools/lsp.js";
+import { navigationTools } from "./tools/navigation.js";
+import { readingTools } from "./tools/reading.js";
+import { refactoringTools } from "./tools/refactoring.js";
+import { safetyTools } from "./tools/safety.js";
+import { structureTools } from "./tools/structure.js";
+/**
+ * AFT (Agent File Toolkit) plugin for OpenCode.
+ *
+ * Config is loaded from two levels (project overrides user):
+ * - User:    ~/.config/opencode/aft.jsonc (or .json)
+ * - Project: <project>/.opencode/aft.jsonc (or .json)
+ *
+ * Tools organized into groups:
+ * - Reading: aft_outline, aft_zoom
+ * - Editing: aft_edit
+ * - Safety: aft_safety
+ * - Imports: aft_import
+ * - Structure: aft_transform
+ * - Navigation: aft_navigate
+ * - Refactoring: aft_refactor
+ * - AST Search: aft_ast_search, aft_ast_replace\n * - LSP: aft_lsp_diagnostics, aft_lsp_hover, aft_lsp_goto_definition, aft_lsp_find_references, aft_lsp_prepare_rename, aft_lsp_rename
+ */
+const plugin = async (input) => {
+    const binaryPath = await findBinary();
+    // Load config: ~/.config/opencode/aft.jsonc → <project>/.opencode/aft.jsonc
+    const aftConfig = loadAftConfig(input.directory);
+    // Build config overrides for the Rust binary (strip undefined values)
+    const configOverrides = {};
+    if (aftConfig.format_on_edit !== undefined)
+        configOverrides.format_on_edit = aftConfig.format_on_edit;
+    if (aftConfig.validate_on_edit !== undefined)
+        configOverrides.validate_on_edit = aftConfig.validate_on_edit;
+    if (aftConfig.formatter !== undefined)
+        configOverrides.formatter = aftConfig.formatter;
+    if (aftConfig.checker !== undefined)
+        configOverrides.checker = aftConfig.checker;
+    const pool = new BridgePool(binaryPath, {}, configOverrides);
+    const ctx = { pool, client: input.client, config: aftConfig };
+    return {
+        tool: {
+            ...readingTools(ctx),
+            ...editingTools(ctx),
+            ...safetyTools(ctx),
+            ...importTools(ctx),
+            ...structureTools(ctx),
+            ...navigationTools(ctx),
+            ...astTools(ctx),
+            ...refactoringTools(ctx),
+            ...lspTools(ctx),
+        },
+        dispose: () => pool.shutdown(),
+    };
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,GAAW,KAAK,EAAE,KAAK,EAAE,EAAE;IACrC,MAAM,UAAU,GAAG,MAAM,UAAU,EAAE,CAAC;IAEtC,4EAA4E;IAC5E,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEjD,sEAAsE;IACtE,MAAM,eAAe,GAA4B,EAAE,CAAC;IACpD,IAAI,SAAS,CAAC,cAAc,KAAK,SAAS;QACxC,eAAe,CAAC,cAAc,GAAG,SAAS,CAAC,cAAc,CAAC;IAC5D,IAAI,SAAS,CAAC,gBAAgB,KAAK,SAAS;QAC1C,eAAe,CAAC,gBAAgB,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAChE,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS;QAAE,eAAe,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IACvF,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS;QAAE,eAAe,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;IAEjF,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,UAAU,EAAE,EAAE,EAAE,eAAe,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAE7E,OAAO;QACL,IAAI,EAAE;YACJ,GAAG,YAAY,CAAC,GAAG,CAAC;YACpB,GAAG,YAAY,CAAC,GAAG,CAAC;YACpB,GAAG,WAAW,CAAC,GAAG,CAAC;YACnB,GAAG,WAAW,CAAC,GAAG,CAAC;YACnB,GAAG,cAAc,CAAC,GAAG,CAAC;YACtB,GAAG,eAAe,CAAC,GAAG,CAAC;YACvB,GAAG,QAAQ,CAAC,GAAG,CAAC;YAChB,GAAG,gBAAgB,CAAC,GAAG,CAAC;YACxB,GAAG,QAAQ,CAAC,GAAG,CAAC;SACjB;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;KAC/B,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/lsp.d.ts

@@ -0,0 +1,32 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+/** Wire format for a single LSP symbol hint sent to the binary. */
+interface LspSymbolHint {
+    name: string;
+    file: string;
+    line: number;
+    kind?: string;
+}
+/** Wire format for the lsp_hints field in bridge requests. */
+export interface LspHints {
+    symbols: LspSymbolHint[];
+}
+/**
+ * Maps LSP SymbolKind numbers to AFT kind strings.
+ * Only kinds relevant to AFT disambiguation are included.
+ * @see https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#symbolKind
+ */
+export declare const LSP_SYMBOL_KIND_MAP: Record<number, string>;
+/**
+ * Query the OpenCode LSP for workspace symbols matching `symbolName`.
+ *
+ * Returns formatted hints for the binary's `lsp_hints` field, or `undefined` if:
+ * - No LSP server is connected
+ * - The API call fails
+ * - No symbols match
+ *
+ * Failures are silent at the caller level — the binary falls back to
+ * tree-sitter-only disambiguation when `lsp_hints` is absent.
+ */
+export declare function queryLspHints(client: PluginInput["client"], symbolName: string, directory?: string): Promise<LspHints | undefined>;
+export {};
+//# sourceMappingURL=lsp.d.ts.map

package/dist/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../src/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,mEAAmE;AACnE,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAgD/B"}

package/dist/lsp.js

@@ -0,0 +1,71 @@
+/** Prefix for diagnostic messages. */
+const TAG = "[aft-plugin]";
+/**
+ * Maps LSP SymbolKind numbers to AFT kind strings.
+ * Only kinds relevant to AFT disambiguation are included.
+ * @see https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#symbolKind
+ */
+export const LSP_SYMBOL_KIND_MAP = {
+    5: "class",
+    6: "method",
+    10: "enum",
+    11: "interface",
+    12: "function",
+    23: "struct",
+};
+/**
+ * Query the OpenCode LSP for workspace symbols matching `symbolName`.
+ *
+ * Returns formatted hints for the binary's `lsp_hints` field, or `undefined` if:
+ * - No LSP server is connected
+ * - The API call fails
+ * - No symbols match
+ *
+ * Failures are silent at the caller level — the binary falls back to
+ * tree-sitter-only disambiguation when `lsp_hints` is absent.
+ */
+export async function queryLspHints(client, symbolName, directory) {
+    try {
+        // Check if any LSP server is connected
+        const statusResult = await client.lsp.status();
+        const servers = statusResult.data;
+        if (!servers || !servers.some((s) => s.status === "connected")) {
+            return undefined;
+        }
+        // Query workspace symbols
+        const query = { query: symbolName };
+        if (directory) {
+            query.directory = directory;
+        }
+        const symbolsResult = await client.find.symbols({ query });
+        const symbols = symbolsResult.data;
+        if (!symbols || symbols.length === 0) {
+            return undefined;
+        }
+        // Map to wire format
+        const hints = [];
+        for (const sym of symbols) {
+            // Strip file:// prefix from URIs
+            let file = sym.location.uri;
+            if (file.startsWith("file://")) {
+                file = file.slice(7);
+            }
+            const hint = {
+                name: sym.name,
+                file,
+                line: sym.location.range.start.line,
+            };
+            const kind = LSP_SYMBOL_KIND_MAP[sym.kind];
+            if (kind) {
+                hint.kind = kind;
+            }
+            hints.push(hint);
+        }
+        return { symbols: hints };
+    }
+    catch (err) {
+        console.warn(`${TAG} LSP query failed for "${symbolName}": ${err.message}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=lsp.js.map

package/dist/lsp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.js","sourceRoot":"","sources":["../src/lsp.ts"],"names":[],"mappings":"AAEA,sCAAsC;AACtC,MAAM,GAAG,GAAG,cAAc,CAAC;AAe3B;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,WAAW;IACf,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA6B,EAC7B,UAAkB,EAClB,SAAkB;IAElB,IAAI,CAAC;QACH,uCAAuC;QACvC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,EAAE,CAAC;YAC/D,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,0BAA0B;QAC1B,MAAM,KAAK,GAA0C,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC3E,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,qBAAqB;QACrB,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,iCAAiC;YACjC,IAAI,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;YAED,MAAM,IAAI,GAAkB;gBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI;gBACJ,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;aACpC,CAAC;YAEF,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,0BAA0B,UAAU,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/pool.d.ts

@@ -0,0 +1,33 @@
+import { BinaryBridge, type BridgeOptions } from "./bridge";
+export interface PoolOptions extends BridgeOptions {
+    maxPoolSize?: number;
+    idleTimeoutMs?: number;
+}
+/**
+ * Manages a pool of BinaryBridge instances, one per project directory.
+ * Handles idle cleanup and LRU eviction when at capacity.
+ */
+export declare class BridgePool {
+    private readonly bridges;
+    private readonly binaryPath;
+    private readonly maxPoolSize;
+    private readonly idleTimeoutMs;
+    private readonly bridgeOptions;
+    private readonly configOverrides;
+    private cleanupTimer;
+    constructor(binaryPath: string, options?: PoolOptions, configOverrides?: Record<string, unknown>);
+    /**
+     * Get or create a bridge for the given directory.
+     * Each directory gets its own binary process that auto-configures on first use.
+     */
+    getBridge(directory: string): BinaryBridge;
+    /** Shut down idle bridges that haven't been used within the timeout. */
+    private cleanup;
+    /** Evict the least recently used bridge to make room. */
+    private evictLRU;
+    /** Shut down all bridges and stop the cleanup timer. */
+    shutdown(): Promise<void>;
+    /** Number of active bridges in the pool. */
+    get size(): number;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +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;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,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;IAU/C;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAuB1C,wEAAwE;IACxE,OAAO,CAAC,OAAO;IAUf,yDAAyD;IACzD,OAAO,CAAC,QAAQ;IAgBhB,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/pool.js

@@ -0,0 +1,86 @@
+import { BinaryBridge } from "./bridge";
+const _TAG = "[BridgePool]";
+const DEFAULT_IDLE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_MAX_POOL_SIZE = 8;
+const CLEANUP_INTERVAL_MS = 60 * 1000; // check every minute
+/**
+ * Manages a pool of BinaryBridge instances, one per project directory.
+ * Handles idle cleanup and LRU eviction when at capacity.
+ */
+export class BridgePool {
+    bridges = new Map();
+    binaryPath;
+    maxPoolSize;
+    idleTimeoutMs;
+    bridgeOptions;
+    configOverrides;
+    cleanupTimer = null;
+    constructor(binaryPath, options = {}, configOverrides = {}) {
+        this.binaryPath = binaryPath;
+        this.maxPoolSize = options.maxPoolSize ?? DEFAULT_MAX_POOL_SIZE;
+        this.idleTimeoutMs = options.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        this.bridgeOptions = { timeoutMs: options.timeoutMs, maxRestarts: options.maxRestarts };
+        this.configOverrides = configOverrides;
+        this.cleanupTimer = setInterval(() => this.cleanup(), CLEANUP_INTERVAL_MS);
+    }
+    /**
+     * Get or create a bridge for the given directory.
+     * Each directory gets its own binary process that auto-configures on first use.
+     */
+    getBridge(directory) {
+        const normalized = directory.replace(/\/+$/, "");
+        const existing = this.bridges.get(normalized);
+        if (existing) {
+            existing.lastUsed = Date.now();
+            return existing.bridge;
+        }
+        // Evict LRU if at capacity
+        if (this.bridges.size >= this.maxPoolSize) {
+            this.evictLRU();
+        }
+        const bridge = new BinaryBridge(this.binaryPath, normalized, this.bridgeOptions, this.configOverrides);
+        this.bridges.set(normalized, { bridge, lastUsed: Date.now() });
+        return bridge;
+    }
+    /** Shut down idle bridges that haven't been used within the timeout. */
+    cleanup() {
+        const now = Date.now();
+        for (const [dir, entry] of this.bridges) {
+            if (now - entry.lastUsed > this.idleTimeoutMs) {
+                entry.bridge.shutdown().catch(() => { });
+                this.bridges.delete(dir);
+            }
+        }
+    }
+    /** Evict the least recently used bridge to make room. */
+    evictLRU() {
+        let oldestDir = null;
+        let oldestTime = Infinity;
+        for (const [dir, entry] of this.bridges) {
+            if (entry.lastUsed < oldestTime) {
+                oldestTime = entry.lastUsed;
+                oldestDir = dir;
+            }
+        }
+        if (oldestDir) {
+            const entry = this.bridges.get(oldestDir);
+            entry?.bridge.shutdown().catch(() => { });
+            this.bridges.delete(oldestDir);
+        }
+    }
+    /** Shut down all bridges and stop the cleanup timer. */
+    async shutdown() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        const shutdowns = Array.from(this.bridges.values()).map((e) => e.bridge.shutdown());
+        this.bridges.clear();
+        await Promise.allSettled(shutdowns);
+    }
+    /** Number of active bridges in the pool. */
+    get size() {
+        return this.bridges.size;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

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

package/dist/resolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Map the current `process.platform` and `process.arch` to the npm platform
+ * package suffix (e.g. `"darwin-arm64"`, `"linux-x64"`).
+ *
+ * Exported for testability — agents and scripts can call this directly to
+ * verify the platform mapping without running the full resolver.
+ *
+ * @throws {Error} with the exact `process.platform` and `process.arch` values
+ *   when the combination is unsupported.
+ */
+export declare function platformKey(platform?: string, arch?: string): string;
+/**
+ * Locate the `aft` binary synchronously by checking (in order):
+ * 1. Cached binary from previous auto-download (~/.cache/aft/bin/)
+ * 2. npm platform package via `require.resolve(@cortexkit/aft-<platform>/bin/aft)`
+ * 3. PATH lookup via `which aft` (or `where aft` on Windows)
+ * 4. ~/.cargo/bin/aft (Rust cargo install location)
+ *
+ * Returns the absolute path to the first binary found, or null if none found.
+ */
+export declare function findBinarySync(): string | null;
+/**
+ * Locate the `aft` binary, with auto-download as a last resort.
+ *
+ * Resolution order:
+ *   1. Cached binary (~/.cache/aft/bin/)
+ *   2. npm platform package (@cortexkit/aft-<platform>)
+ *   3. PATH lookup (which aft)
+ *   4. ~/.cargo/bin/aft
+ *   5. Auto-download from GitHub releases
+ *
+ * Returns the absolute path to the binary.
+ * Throws a descriptive error with install instructions if all sources fail.
+ */
+export declare function findBinary(): Promise<string>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAaA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,GAC1B,MAAM,CAgBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAkC9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CA8BlD"}

package/dist/resolver.js

@@ -0,0 +1,122 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { ensureBinary, getCachedBinaryPath } from "./downloader.js";
+/** Supported platform package mapping: `process.platform`-`process.arch` → npm package suffix. */
+const PLATFORM_MAP = {
+    darwin: { arm64: "darwin-arm64", x64: "darwin-x64" },
+    linux: { arm64: "linux-arm64", x64: "linux-x64" },
+    win32: { x64: "win32-x64" },
+};
+/**
+ * Map the current `process.platform` and `process.arch` to the npm platform
+ * package suffix (e.g. `"darwin-arm64"`, `"linux-x64"`).
+ *
+ * Exported for testability — agents and scripts can call this directly to
+ * verify the platform mapping without running the full resolver.
+ *
+ * @throws {Error} with the exact `process.platform` and `process.arch` values
+ *   when the combination is unsupported.
+ */
+export function platformKey(platform = process.platform, arch = process.arch) {
+    const archMap = PLATFORM_MAP[platform];
+    if (!archMap) {
+        throw new Error(`Unsupported platform: ${platform} (arch: ${arch}). ` +
+            `Supported platforms: ${Object.keys(PLATFORM_MAP).join(", ")}`);
+    }
+    const key = archMap[arch];
+    if (!key) {
+        throw new Error(`Unsupported architecture: ${arch} on platform ${platform}. ` +
+            `Supported architectures for ${platform}: ${Object.keys(archMap).join(", ")}`);
+    }
+    return key;
+}
+/**
+ * Locate the `aft` binary synchronously by checking (in order):
+ * 1. Cached binary from previous auto-download (~/.cache/aft/bin/)
+ * 2. npm platform package via `require.resolve(@cortexkit/aft-<platform>/bin/aft)`
+ * 3. PATH lookup via `which aft` (or `where aft` on Windows)
+ * 4. ~/.cargo/bin/aft (Rust cargo install location)
+ *
+ * Returns the absolute path to the first binary found, or null if none found.
+ */
+export function findBinarySync() {
+    const ext = process.platform === "win32" ? ".exe" : "";
+    // 1. Check cached binary from auto-download
+    const cached = getCachedBinaryPath();
+    if (cached)
+        return cached;
+    // 2. Check npm platform package
+    try {
+        const key = platformKey();
+        const packageBin = `@cortexkit/aft-${key}/bin/aft${ext}`;
+        const resolved = require.resolve(packageBin);
+        if (existsSync(resolved))
+            return resolved;
+    }
+    catch {
+        // npm package not installed or resolution failed
+    }
+    // 3. Check PATH
+    try {
+        const whichCmd = process.platform === "win32" ? "where aft" : "which aft";
+        const result = execSync(whichCmd, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        if (result)
+            return result;
+    }
+    catch {
+        // not in PATH
+    }
+    // 4. Check ~/.cargo/bin/aft
+    const cargoPath = join(homedir(), ".cargo", "bin", `aft${ext}`);
+    if (existsSync(cargoPath))
+        return cargoPath;
+    return null;
+}
+/**
+ * Locate the `aft` binary, with auto-download as a last resort.
+ *
+ * Resolution order:
+ *   1. Cached binary (~/.cache/aft/bin/)
+ *   2. npm platform package (@cortexkit/aft-<platform>)
+ *   3. PATH lookup (which aft)
+ *   4. ~/.cargo/bin/aft
+ *   5. Auto-download from GitHub releases
+ *
+ * Returns the absolute path to the binary.
+ * Throws a descriptive error with install instructions if all sources fail.
+ */
+export async function findBinary() {
+    // Try synchronous resolution first (fast path)
+    const syncResult = findBinarySync();
+    if (syncResult)
+        return syncResult;
+    // 5. Auto-download from GitHub releases
+    console.error("[aft-plugin] Binary not found locally, attempting auto-download...");
+    const downloaded = await ensureBinary();
+    if (downloaded)
+        return downloaded;
+    // All sources exhausted
+    throw new Error([
+        "Could not find the `aft` binary.",
+        "",
+        "Attempted sources:",
+        "  - Cache directory (~/.cache/aft/bin/)",
+        "  - npm platform package (@cortexkit/aft-<platform>)",
+        "  - PATH lookup (which aft)",
+        "  - ~/.cargo/bin/aft",
+        "  - Auto-download from GitHub releases (failed)",
+        "",
+        "Install it using one of these methods:",
+        "  npm install @cortexkit/aft-opencode        # installs platform-specific binary via npm",
+        "  cargo install aft             # from crates.io",
+        "  cargo build --release         # from source (binary at target/release/aft)",
+        "",
+        "Or add the aft directory to your PATH.",
+    ].join("\n"));
+}
+//# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

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

package/dist/tools/ast.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tool definitions for AST pattern search and replace using ast-grep.
+ * Supports meta-variables ($VAR for single node, $$$ for multiple nodes).
+ * Patterns must be complete AST nodes (valid code fragments).
+ */
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import type { PluginContext } from "../types.js";
+export declare function astTools(ctx: PluginContext): Record<string, ToolDefinition>;
+//# sourceMappingURL=ast.d.ts.map

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

@@ -0,0 +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;AA8BjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAgE3E"}

package/dist/tools/ast.js

@@ -0,0 +1,102 @@
+/**
+ * Tool definitions for AST pattern search and replace using ast-grep.
+ * Supports meta-variables ($VAR for single node, $$$ for multiple nodes).
+ * Patterns must be complete AST nodes (valid code fragments).
+ */
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+const SUPPORTED_LANGS = [
+    "bash",
+    "c",
+    "cpp",
+    "csharp",
+    "css",
+    "elixir",
+    "go",
+    "haskell",
+    "html",
+    "java",
+    "javascript",
+    "json",
+    "kotlin",
+    "lua",
+    "nix",
+    "php",
+    "python",
+    "ruby",
+    "rust",
+    "scala",
+    "solidity",
+    "swift",
+    "typescript",
+    "tsx",
+    "yaml",
+];
+export function astTools(ctx) {
+    return {
+        aft_ast_search: {
+            description: "Search code patterns across filesystem using AST-aware matching. Supports 25 languages. " +
+                "Use meta-variables: $VAR (single node), $$$ (multiple nodes). " +
+                "IMPORTANT: Patterns must be complete AST nodes (valid code). " +
+                "For functions, include params and body: 'export async function $NAME($$$) { $$$ }' not 'export async function $NAME'. " +
+                "Examples: 'console.log($MSG)', 'def $FUNC($$$):', 'async function $NAME($$$)'",
+            args: {
+                pattern: z
+                    .string()
+                    .describe("AST pattern with meta-variables ($VAR, $$$). Must be complete AST node."),
+                lang: z.enum(SUPPORTED_LANGS).describe("Target language"),
+                paths: z.array(z.string()).optional().describe("Paths to search (default: ['.'])"),
+                globs: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Include/exclude globs (prefix ! to exclude)"),
+                context: z.number().optional().describe("Context lines around match"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const params = {
+                    pattern: args.pattern,
+                    lang: args.lang,
+                };
+                if (args.paths)
+                    params.paths = args.paths;
+                if (args.globs)
+                    params.globs = args.globs;
+                if (args.context !== undefined)
+                    params.context = Number(args.context);
+                const response = await bridge.send("ast_search", params);
+                return JSON.stringify(response);
+            },
+        },
+        aft_ast_replace: {
+            description: "Replace code patterns across filesystem with AST-aware rewriting. Dry-run by default. " +
+                "Use meta-variables in rewrite to preserve matched content. " +
+                "Example: pattern='console.log($MSG)' rewrite='logger.info($MSG)'",
+            args: {
+                pattern: z.string().describe("AST pattern to match"),
+                rewrite: z.string().describe("Replacement pattern (can use $VAR from pattern)"),
+                lang: z.enum(SUPPORTED_LANGS).describe("Target language"),
+                paths: z.array(z.string()).optional().describe("Paths to search"),
+                globs: z.array(z.string()).optional().describe("Include/exclude globs"),
+                dryRun: z.boolean().optional().describe("Preview changes without applying (default: true)"),
+            },
+            execute: async (args, context) => {
+                const bridge = ctx.pool.getBridge(context.directory);
+                const params = {
+                    pattern: args.pattern,
+                    rewrite: args.rewrite,
+                    lang: args.lang,
+                };
+                if (args.paths)
+                    params.paths = args.paths;
+                if (args.globs)
+                    params.globs = args.globs;
+                // Default to dry_run=true for safety
+                params.dry_run = args.dryRun !== false;
+                const response = await bridge.send("ast_replace", params);
+                return JSON.stringify(response);
+            },
+        },
+    };
+}
+//# sourceMappingURL=ast.js.map

package/dist/tools/ast.js.map

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