promptscout 1.1.0

package/dist/storage/config-repo.d.ts

@@ -0,0 +1,11 @@
+import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+export declare class ConfigRepo {
+    private db;
+    constructor(db: BetterSQLite3Database);
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    delete(key: string): boolean;
+    getSystemPrompt(): string;
+    getModelHfUri(): string;
+    getModelContextSize(): number;
+}

package/dist/storage/config-repo.js

@@ -0,0 +1,42 @@
+import { eq } from "drizzle-orm";
+import { config } from "./schema.js";
+import { DEFAULT_SYSTEM_PROMPT, SYSTEM_PROMPT_KEY, MODEL_HF_URI, MODEL_HF_URI_KEY, MODEL_CONTEXT_SIZE_KEY, LLM_CONTEXT_SIZE, } from "../constants.js";
+export class ConfigRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    get(key) {
+        const row = this.db
+            .select()
+            .from(config)
+            .where(eq(config.key, key))
+            .get();
+        return row?.value;
+    }
+    set(key, value) {
+        this.db
+            .insert(config)
+            .values({ key, value })
+            .onConflictDoUpdate({ target: config.key, set: { value } })
+            .run();
+    }
+    delete(key) {
+        const result = this.db
+            .delete(config)
+            .where(eq(config.key, key))
+            .run();
+        return result.changes > 0;
+    }
+    getSystemPrompt() {
+        return this.get(SYSTEM_PROMPT_KEY) ?? DEFAULT_SYSTEM_PROMPT;
+    }
+    getModelHfUri() {
+        return this.get(MODEL_HF_URI_KEY) ?? MODEL_HF_URI;
+    }
+    getModelContextSize() {
+        const val = this.get(MODEL_CONTEXT_SIZE_KEY);
+        return val ? Number(val) : LLM_CONTEXT_SIZE;
+    }
+}
+//# sourceMappingURL=config-repo.js.map

package/dist/storage/config-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-repo.js","sourceRoot":"","sources":["../../src/storage/config-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,EAAyB;QAAzB,OAAE,GAAF,EAAE,CAAuB;IAAG,CAAC;IAEjD,GAAG,CAAC,GAAW;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,MAAM,EAAE;aACR,IAAI,CAAC,MAAM,CAAC;aACZ,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;aAC1B,GAAG,EAAE,CAAC;QACT,OAAO,GAAG,EAAE,KAAK,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAa;QAC5B,IAAI,CAAC,EAAE;aACJ,MAAM,CAAC,MAAM,CAAC;aACd,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;aACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;aAC1D,GAAG,EAAE,CAAC;IACX,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,MAAM,CAAC,MAAM,CAAC;aACd,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;aAC1B,GAAG,EAAE,CAAC;QACT,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,qBAAqB,CAAC;IAC9D,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,YAAY,CAAC;IACpD,CAAC;IAED,mBAAmB;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC7C,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC9C,CAAC;CAEF"}

package/dist/storage/database.d.ts

@@ -0,0 +1,4 @@
+import Database from "better-sqlite3";
+import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+export declare function getDatabase(): Database.Database;
+export declare function getDrizzle(): BetterSQLite3Database;

package/dist/storage/database.js

@@ -0,0 +1,54 @@
+import Database from "better-sqlite3";
+import { drizzle } from "drizzle-orm/better-sqlite3";
+import { resolveDbPath } from "../utils/paths.js";
+import { DEFAULT_SYSTEM_PROMPT, SYSTEM_PROMPT_KEY } from "../constants.js";
+let db = null;
+let drizzleDb = null;
+function migrate(database) {
+    const version = database.pragma("user_version", { simple: true });
+    if (version < 1) {
+        database.exec(`
+      CREATE TABLE IF NOT EXISTS history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        directory TEXT NOT NULL,
+        raw_input TEXT NOT NULL,
+        improved_output TEXT NOT NULL,
+        final_output TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS config (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+
+      PRAGMA user_version = 1;
+    `);
+        database
+            .prepare("INSERT OR IGNORE INTO config (key, value) VALUES (?, ?)")
+            .run(SYSTEM_PROMPT_KEY, DEFAULT_SYSTEM_PROMPT);
+    }
+    if (version < 2) {
+        database.exec(`
+      ALTER TABLE history ADD COLUMN model_name TEXT;
+      PRAGMA user_version = 2;
+    `);
+    }
+}
+export function getDatabase() {
+    if (db)
+        return db;
+    const dbPath = resolveDbPath();
+    db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    migrate(db);
+    return db;
+}
+export function getDrizzle() {
+    if (drizzleDb)
+        return drizzleDb;
+    const sqlite = getDatabase();
+    drizzleDb = drizzle({ client: sqlite });
+    return drizzleDb;
+}
+//# sourceMappingURL=database.js.map

package/dist/storage/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/storage/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,IAAI,EAAE,GAA6B,IAAI,CAAC;AACxC,IAAI,SAAS,GAAiC,IAAI,CAAC;AAEnD,SAAS,OAAO,CAAC,QAA2B;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;IAE5E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;KAgBb,CAAC,CAAC;QAEH,QAAQ;aACL,OAAO,CAAC,yDAAyD,CAAC;aAClE,GAAG,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC;;;KAGb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,SAAS,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/storage/history-repo.d.ts

@@ -0,0 +1,10 @@
+import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+import type { HistoryEntry } from "../types.js";
+export declare class HistoryRepo {
+    private db;
+    constructor(db: BetterSQLite3Database);
+    create(entry: Omit<HistoryEntry, "id" | "created_at">): HistoryEntry;
+    list(directory?: string, limit?: number): HistoryEntry[];
+    findById(id: number): HistoryEntry | undefined;
+    clear(): void;
+}

package/dist/storage/history-repo.js

@@ -0,0 +1,48 @@
+import { eq, desc } from "drizzle-orm";
+import { history } from "./schema.js";
+import { DEFAULT_HISTORY_LIMIT } from "../constants.js";
+export class HistoryRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(entry) {
+        const result = this.db
+            .insert(history)
+            .values({
+            directory: entry.directory,
+            raw_input: entry.raw_input,
+            improved_output: entry.improved_output,
+            final_output: entry.final_output,
+            model_name: entry.model_name,
+        })
+            .run();
+        return this.db
+            .select()
+            .from(history)
+            .where(eq(history.id, Number(result.lastInsertRowid)))
+            .get();
+    }
+    list(directory, limit = DEFAULT_HISTORY_LIMIT) {
+        const query = this.db
+            .select()
+            .from(history)
+            .orderBy(desc(history.created_at))
+            .limit(limit);
+        if (directory) {
+            return query.where(eq(history.directory, directory)).all();
+        }
+        return query.all();
+    }
+    findById(id) {
+        return this.db
+            .select()
+            .from(history)
+            .where(eq(history.id, id))
+            .get();
+    }
+    clear() {
+        this.db.delete(history).run();
+    }
+}
+//# sourceMappingURL=history-repo.js.map

package/dist/storage/history-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-repo.js","sourceRoot":"","sources":["../../src/storage/history-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAO,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,EAAyB;QAAzB,OAAE,GAAF,EAAE,CAAuB;IAAG,CAAC;IAEjD,MAAM,CAAC,KAA8C;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC;YACN,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;aACD,GAAG,EAAE,CAAC;QAET,OAAO,IAAI,CAAC,EAAE;aACX,MAAM,EAAE;aACR,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;aACrD,GAAG,EAAkB,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,SAAkB,EAAE,QAAgB,qBAAqB;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE;aAClB,MAAM,EAAE;aACR,IAAI,CAAC,OAAO,CAAC;aACb,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;aACjC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEhB,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,EAAoB,CAAC;QAC/E,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,EAAoB,CAAC;IACvC,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,EAAE;aACX,MAAM,EAAE;aACR,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;aACzB,GAAG,EAA8B,CAAC;IACvC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/storage/schema.d.ts

@@ -0,0 +1,183 @@
+export declare const history: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "history";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "history";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        directory: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "directory";
+            tableName: "history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        raw_input: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "raw_input";
+            tableName: "history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        improved_output: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "improved_output";
+            tableName: "history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        final_output: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "final_output";
+            tableName: "history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        model_name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "model_name";
+            tableName: "history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+export declare const config: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "config";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "key";
+            tableName: "config";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        value: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "value";
+            tableName: "config";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;

package/dist/storage/schema.js

@@ -0,0 +1,16 @@
+import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
+import { sql } from "drizzle-orm";
+export const history = sqliteTable("history", {
+    id: integer("id").primaryKey({ autoIncrement: true }),
+    directory: text("directory").notNull(),
+    raw_input: text("raw_input").notNull(),
+    improved_output: text("improved_output").notNull(),
+    final_output: text("final_output").notNull(),
+    model_name: text("model_name"),
+    created_at: text("created_at").default(sql `(datetime('now'))`),
+});
+export const config = sqliteTable("config", {
+    key: text("key").primaryKey(),
+    value: text("value").notNull(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/storage/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE;IAC5C,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACrD,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACtC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACtC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE;IAClD,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC5C,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;IAC9B,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,mBAAmB,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE;IAC1C,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE;IAC7B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;CAC/B,CAAC,CAAC"}

package/dist/tools/implementations.d.ts

@@ -0,0 +1,6 @@
+import type { Ignore } from "ignore";
+export declare function fileFinder(query: string, dir: string, ig: Ignore): string;
+export declare function sectionFinder(query: string, dir: string, ig: Ignore): string;
+export declare function definitionFinder(query: string, dir: string, ig: Ignore): string;
+export declare function importTracer(query: string, dir: string, ig: Ignore): string;
+export declare function gitHistory(query: string, dir: string): string;

package/dist/tools/implementations.js

@@ -0,0 +1,96 @@
+import { escapeRegex, filterLines, stripDirPrefix, grepSync, gitSync, } from "./search-utils.js";
+const MAX_FILES = 10;
+const MAX_LINES = 20;
+const MAX_COMMITS = 10;
+// Multi-language definition patterns:
+// JS/TS: export, function, class, interface, type, const, enum
+// Python: def, class, async def
+// Go: func, type, var, const
+// Rust: pub fn, pub struct, pub enum, pub type, pub trait, fn, struct, enum, trait
+// Swift: func, class, struct, enum, protocol
+// Ruby: def, class, module
+// Java/Kotlin: public class, public interface, abstract class
+const DEFINITION_PATTERN = "(export\\s+(default\\s+)?)?(pub\\s+)?(async\\s+)?" +
+    "(function|class|interface|type|const|enum|struct|trait|protocol|module|def|func|fn|var|let|val)\\s+";
+function scoreFilePath(filePath, lowerQuery) {
+    const lower = filePath.toLowerCase();
+    const basename = lower.split("/").pop() ?? "";
+    let score = 1; // base score for content match
+    if (basename.includes(lowerQuery))
+        score += 3;
+    else if (lower.includes(lowerQuery))
+        score += 1;
+    return score;
+}
+export function fileFinder(query, dir, ig) {
+    const escaped = escapeRegex(query);
+    const output = grepSync(["-rli", "-E", escaped, dir], dir);
+    if (!output)
+        return "No matching files found.";
+    const filtered = filterLines(output.split("\n"), dir, ig);
+    if (filtered.length === 0)
+        return "No matching files found.";
+    const lowerQuery = query.toLowerCase();
+    const scored = filtered
+        .map((l) => ({ path: stripDirPrefix(l, dir), score: scoreFilePath(l, lowerQuery) }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, MAX_FILES);
+    return scored.map((s) => s.path).join("\n");
+}
+export function sectionFinder(query, dir, ig) {
+    const escaped = escapeRegex(query);
+    const output = grepSync(["-rni", "-E", escaped, dir], dir);
+    if (!output)
+        return "No matching code found.";
+    const filtered = filterLines(output.split("\n"), dir, ig);
+    if (filtered.length === 0)
+        return "No matching code found.";
+    const lowerQuery = query.toLowerCase();
+    const scored = filtered
+        .map((l) => ({ line: stripDirPrefix(l, dir), score: scoreFilePath(l, lowerQuery) }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, MAX_LINES);
+    return scored.map((s) => s.line).join("\n");
+}
+export function definitionFinder(query, dir, ig) {
+    const output = grepSync(["-rnE", DEFINITION_PATTERN, dir], dir);
+    if (!output)
+        return "No definitions found.";
+    const lowerQuery = query.toLowerCase();
+    const filtered = filterLines(output.split("\n"), dir, ig)
+        .filter((line) => line.toLowerCase().includes(lowerQuery))
+        .slice(0, MAX_LINES);
+    if (filtered.length === 0)
+        return "No matching definitions found.";
+    return filtered.map((l) => stripDirPrefix(l, dir)).join("\n");
+}
+export function importTracer(query, dir, ig) {
+    const escaped = escapeRegex(query);
+    const output = grepSync(["-rnE", `(import|from|require|include|use).*${escaped}`, dir], dir);
+    if (!output)
+        return "No matching imports found.";
+    const lines = filterLines(output.split("\n"), dir, ig).slice(0, MAX_LINES);
+    if (lines.length === 0)
+        return "No matching imports found.";
+    return lines.map((l) => stripDirPrefix(l, dir)).join("\n");
+}
+export function gitHistory(query, dir) {
+    const output = gitSync(["log", "--format=>> %h %s", "--name-only", "-n", String(MAX_COMMITS), "-S", query], dir);
+    if (!output)
+        return "No commits found matching this keyword.";
+    const commits = [];
+    for (const line of output.split("\n")) {
+        if (line.startsWith(">> ")) {
+            commits.push({ header: line.slice(3), files: [] });
+        }
+        else if (line && commits.length > 0) {
+            commits[commits.length - 1].files.push(line);
+        }
+    }
+    return commits
+        .map((c) => c.files.length > 0
+        ? `${c.header}\n  ${c.files.join("\n  ")}`
+        : c.header)
+        .join("\n");
+}
+//# sourceMappingURL=implementations.js.map

package/dist/tools/implementations.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,24 @@
+import type { Ignore } from "ignore";
+export { loadIgnoreFilter } from "./search-utils.js";
+export interface ToolCall {
+    name: string;
+    arguments: Record<string, string>;
+}
+export declare function executeToolCall(call: ToolCall, dir: string, ig: Ignore): Promise<string>;
+export declare const TOOL_DEFINITIONS: {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+}[];

package/dist/tools/index.js

@@ -0,0 +1,119 @@
+import { fileFinder, sectionFinder, definitionFinder, importTracer, gitHistory, } from "./implementations.js";
+export { loadIgnoreFilter } from "./search-utils.js";
+export async function executeToolCall(call, dir, ig) {
+    switch (call.name) {
+        case "file_finder":
+            return fileFinder(call.arguments.query, dir, ig);
+        case "section_finder":
+            return sectionFinder(call.arguments.query, dir, ig);
+        case "definition_finder":
+            return definitionFinder(call.arguments.query, dir, ig);
+        case "import_tracer":
+            return importTracer(call.arguments.query, dir, ig);
+        case "git_history":
+            return gitHistory(call.arguments.query, dir);
+        default:
+            return `Unknown tool: ${call.name}`;
+    }
+}
+export const TOOL_DEFINITIONS = [
+    {
+        type: "function",
+        function: {
+            name: "file_finder",
+            description: "Find files matching a keyword. Returns file paths. " +
+                "Pair with section_finder using a different keyword to also get code snippets.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "A single keyword to search for in file contents. Use concise, specific terms " +
+                            "(e.g., 'camera', 'auth', 'Router'). Avoid multi-word phrases.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "section_finder",
+            description: "Find code snippets matching a keyword. Returns file:line:code entries. " +
+                "Use alongside file_finder with a different keyword for complete context.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "A single keyword to find in source code. Use specific identifiers " +
+                            "(e.g., 'handleSubmit', 'CameraView', 'fetchUser'). Case-insensitive.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "definition_finder",
+            description: "Find function, class, type, interface, struct, enum, and other definition declarations " +
+                "matching a keyword. Works across languages (JS/TS, Python, Go, Rust, Swift, Ruby, Java). " +
+                "Returns up to 15 results. Use this to find where something is defined, not where it is used.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "A single keyword matching the name of a function, class, type, or other definition " +
+                            "(e.g., 'Camera', 'UserService', 'parse_config'). Case-insensitive.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "import_tracer",
+            description: "Find import, require, include, and use statements that reference a module or keyword. " +
+                "Shows the dependency graph — which files depend on the given module. " +
+                "Returns up to 15 results. Use this to understand how modules are connected.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "A module name or keyword to search for in import statements " +
+                            "(e.g., 'camera', 'utils', 'express'). Case-sensitive for import paths.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "git_history",
+            description: "Search git commit history for the 10 most recent commits that added or removed " +
+                "code containing the given keyword. Use this when the user references a recent change, " +
+                "regression, or wants to understand what changed recently related to a topic.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "A keyword to search in commit diffs (e.g., 'camera', 'auth'). " +
+                            "Git searches for commits where this string was added or removed.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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