@felan-ai/ext-codebase-memory 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felan contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,16 @@
+@felan-ai/ext-codebase-memory
+
+This package adapts selected MIT-licensed behavior and prompt guidance from
+pi-cbm 1.2.1 at commit 921a749d5cea74bda8f647542627ef9518fec272
+(https://github.com/alexykn/pi-cbm). Copyright (c) 2026 alexykn.
+
+The runtime integration targets codebase-memory-mcp 0.10.8 at commit
+46ae198fc11cda80e817acbc5f5908d7c2de7032
+(https://github.com/DeusData/codebase-memory-mcp), licensed under MIT.
+
+This package uses TypeBox 1.1.38 from https://github.com/sinclairzx81/typebox,
+licensed under the MIT License. Copyright (c) 2017-2026 Haydn Paterson.
+
+Felan's portable AgentRuntime implementation, binary gating, explicit installer,
+bounded grep augmentation, cache policy, and four-tool model surface are Felan
+changes. The optional binary is never bundled with this npm package.

package/README.md

@@ -0,0 +1,81 @@
+# @felan-ai/ext-codebase-memory
+
+Portable structural code exploration for Felan, backed by the reviewed
+`codebase-memory-mcp` 0.10.8 native executable.
+
+## Behavior
+
+When the exact reviewed binary is available, the extension registers exactly
+four model tools:
+
+- `codebase_memory` proxies the bounded structural query surface and performs
+  an explicit `index_repository` refresh for the active git repository.
+- `read_symbol` resolves and reads one named symbol.
+- `search_and_read_symbols` searches symbols and reads a bounded set of likely
+  matches.
+- `search_code` searches indexed source text.
+
+The extension indexes once at session startup. It has no file watcher or
+periodic refresh. After edits, the model can call
+`codebase_memory({ command: "index_repository" })`, and local users can run
+`/codebase-memory refresh`. Direct file reads, grep, compiler output, and tests
+remain authoritative because an index can be stale.
+
+Grep and ripgrep calls made through `bash` or Codex `exec_command` receive a
+best-effort Codebase Memory appendix by default. Augmentation has its own
+1.5-second deadline, never replaces the original command result, and emits
+hit/error telemetry only through a host-supplied callback.
+
+## Availability and installation
+
+The package never bundles or installs a binary automatically. If the binary is
+missing, it registers no tools, capability instructions, or model prompt. A
+local interactive session shows one installation hint; a cloud host receives a
+hard error log while session startup continues without Codebase Memory.
+
+Local installation is always explicit through `/dependencies` or
+`/codebase-memory install`. Felan downloads a commit-pinned upstream installer,
+verifies its SHA-256 digest, requests the pinned 0.10.8 release, passes
+`--skip-config`, and installs only into `AgentRuntime.storage('agent')`. It
+never edits agent or repository configuration. Cloud hosts must place the exact
+reviewed binary on `PATH` in the execution image.
+
+## Cache and limits
+
+Codebase Memory data is rooted at
+`AgentRuntime.storage('agent')/codebase-memory/cache`, so root sessions and
+subagents using the same runtime coordinate through one index. No tenant key is
+added inside that already scoped runtime storage.
+
+- Query timeout: 60 seconds
+- Index timeout: 20 minutes
+- Combined process output: 5 MiB
+- Maximum symbol read: 220 lines
+- Cache LRU: 2 GiB for host runtimes; 500 MiB for Docker and Daytona
+
+Set `extensionConfig.codebaseMemory.maxCacheBytes` to a positive integer to
+override the runtime cache limit. The persisted default `0` means “use the
+runtime-specific limit”; it is not a zero-byte cache.
+
+## Public API
+
+The default export is the portable extension. Hosts may also use:
+
+- `createCodebaseMemoryExtension({ telemetry, log })`
+- `CODEBASE_MEMORY_CONFIG`
+- `inspectCodebaseMemoryRuntime(runtime)`
+- `installManagedCodebaseMemory(runtime, onStatus)`
+- `MANAGED_CODEBASE_MEMORY_VERSION`
+
+The binary client, project coordination, and symbol services are internal
+implementation details. The package intentionally provides no LSP integration.
+
+## Development
+
+```sh
+pnpm --filter @felan-ai/ext-codebase-memory build
+pnpm --filter @felan-ai/ext-codebase-memory type-check
+pnpm --filter @felan-ai/ext-codebase-memory test
+```
+
+See [NOTICE](NOTICE) for the immutable upstream baselines and licensing.

package/dist/cache.d.ts

@@ -0,0 +1,13 @@
+import type { AgentRuntime } from '@felan-ai/agent-core';
+export type CodebaseMemoryTelemetry = (event: string, fields: Record<string, unknown>) => void;
+export declare class CacheManager {
+    #private;
+    private readonly runtime;
+    private readonly telemetry;
+    private readonly onEvict;
+    private readonly measureBytes?;
+    readonly maxBytes: number;
+    constructor(runtime: AgentRuntime, maxBytes?: number, telemetry?: CodebaseMemoryTelemetry, onEvict?: (project: string) => Promise<void>, measureBytes?: (() => Promise<number>) | undefined);
+    record(project: string, bytes: number, lastAccessedAt?: number): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AASzD,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAK/F,qBAAa,YAAY;;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAPhC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGP,OAAO,EAAE,YAAY,EACtC,QAAQ,SAAyE,EAChE,SAAS,GAAE,uBAAkC,EAC7C,OAAO,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAkB,EAC5D,YAAY,CAAC,GAAE,MAAM,OAAO,CAAC,MAAM,CAAC,aAAA;IAKvD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,SAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CA6EnF"}

package/dist/cache.js

@@ -0,0 +1,97 @@
+import { createHash } from 'node:crypto';
+const HOST_MAX_CACHE_BYTES = 2 * 1024 * 1024 * 1024;
+const CLOUD_MAX_CACHE_BYTES = 500 * 1024 * 1024;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+const MAX_MANIFEST_BYTES = 1024 * 1024;
+const cacheControls = new Map();
+export class CacheManager {
+    runtime;
+    telemetry;
+    onEvict;
+    measureBytes;
+    maxBytes;
+    constructor(runtime, maxBytes = runtime.kind === 'host' ? HOST_MAX_CACHE_BYTES : CLOUD_MAX_CACHE_BYTES, telemetry = () => { }, onEvict = async () => { }, measureBytes) {
+        this.runtime = runtime;
+        this.telemetry = telemetry;
+        this.onEvict = onEvict;
+        this.measureBytes = measureBytes;
+        this.maxBytes = maxBytes;
+    }
+    record(project, bytes, lastAccessedAt = Date.now()) {
+        return this.#run(async () => {
+            const manifest = await this.#readManifest();
+            const entries = manifest.entries.filter((entry) => entry.project !== project);
+            entries.push({ project, bytes: Math.max(0, bytes), lastAccessedAt });
+            entries.sort((left, right) => left.lastAccessedAt - right.lastAccessedAt);
+            let total = this.measureBytes
+                ? await this.measureBytes()
+                : entries.reduce((sum, entry) => sum + entry.bytes, 0);
+            while (total > this.maxBytes && entries.length > 0) {
+                const evicted = entries.shift();
+                if (!evicted)
+                    break;
+                await this.onEvict(evicted.project);
+                await this.runtime.storage('agent').remove(`codebase-memory/cache/${projectStorageKey(evicted.project)}`, { recursive: true }).catch(() => { });
+                total = this.measureBytes ? await this.measureBytes() : total - evicted.bytes;
+                this.telemetry('cache_eviction', {
+                    projectKey: projectStorageKey(evicted.project),
+                    bytes: evicted.bytes,
+                    maxBytes: this.maxBytes,
+                });
+            }
+            await this.runtime.storage('agent').mkdir('codebase-memory', { recursive: true });
+            if (entries.some((entry) => entry.project === project)) {
+                const storageKey = projectStorageKey(project);
+                await this.runtime.storage('agent').mkdir(`codebase-memory/cache/${storageKey}`, { recursive: true });
+                await this.runtime.storage('agent').writeFile(`codebase-memory/cache/${storageKey}/.felan-lru`, encoder.encode(String(lastAccessedAt)));
+            }
+            await this.runtime.storage('agent').writeFile('codebase-memory/lru.json', encoder.encode(JSON.stringify({ version: 1, entries })));
+            this.telemetry('cache_size', { bytes: total, maxBytes: this.maxBytes, projects: entries.length });
+        });
+    }
+    async #readManifest() {
+        try {
+            const parsed = JSON.parse(decoder.decode(await this.runtime.storage('agent').readFile('codebase-memory/lru.json', { maxBytes: MAX_MANIFEST_BYTES })));
+            if (parsed.version !== 1 || !Array.isArray(parsed.entries))
+                return { version: 1, entries: [] };
+            const entries = parsed.entries.filter((value) => {
+                if (typeof value !== 'object' || value === null || Array.isArray(value))
+                    return false;
+                const entry = value;
+                return typeof entry.project === 'string'
+                    && entry.project.length > 0
+                    && typeof entry.bytes === 'number'
+                    && Number.isSafeInteger(entry.bytes)
+                    && entry.bytes >= 0
+                    && typeof entry.lastAccessedAt === 'number'
+                    && Number.isSafeInteger(entry.lastAccessedAt)
+                    && entry.lastAccessedAt >= 0;
+            });
+            return { version: 1, entries };
+        }
+        catch {
+            return { version: 1, entries: [] };
+        }
+    }
+    async #run(operation) {
+        const key = this.runtime.storage('agent').root;
+        const previous = cacheControls.get(key) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => { release = resolve; });
+        cacheControls.set(key, current);
+        await previous;
+        try {
+            await operation();
+        }
+        finally {
+            release();
+            if (cacheControls.get(key) === current)
+                cacheControls.delete(key);
+        }
+    }
+}
+function projectStorageKey(project) {
+    return createHash('sha256').update(project).digest('hex');
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,35 @@
+import type { AgentRuntime } from '@felan-ai/agent-core';
+export declare const CODEBASE_MEMORY_VERSION = "0.10.8";
+export declare const QUERY_TIMEOUT_MS = 60000;
+export declare const INDEX_TIMEOUT_MS: number;
+export declare const MAX_OUTPUT_BYTES: number;
+export interface CbmInvocation {
+    readonly command: string;
+    readonly version: string;
+    readonly source: 'managed' | 'path';
+}
+export type CbmDetection = {
+    readonly available: true;
+    readonly invocation: CbmInvocation;
+} | {
+    readonly available: false;
+    readonly reason: string;
+};
+export interface CbmCallOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export interface CbmCallResult {
+    readonly data: unknown;
+    readonly stderr: string;
+}
+export declare class CbmClient {
+    private readonly runtime;
+    readonly invocation: CbmInvocation;
+    readonly cacheRoot: string;
+    readonly runtimeRoot: string;
+    constructor(runtime: AgentRuntime, invocation: CbmInvocation);
+    call(command: string, args: Record<string, unknown>, options?: CbmCallOptions): Promise<CbmCallResult>;
+}
+export declare function detectCbm(runtime: AgentRuntime): Promise<CbmDetection>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,sBAAsB,CAAC;AAGrE,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAChD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,eAAO,MAAM,gBAAgB,QAAc,CAAC;AAC5C,eAAO,MAAM,gBAAgB,QAAkB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,UAAU,EAAE,aAAa;IALpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAGV,OAAO,EAAE,YAAY,EAC7B,UAAU,EAAE,aAAa;IAM9B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;CAqBjH;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA2B5E"}

package/dist/client.js

@@ -0,0 +1,108 @@
+import { joinRuntimePath, shellQuote } from './runtime-path.js';
+export const CODEBASE_MEMORY_VERSION = '0.10.8';
+export const QUERY_TIMEOUT_MS = 60_000;
+export const INDEX_TIMEOUT_MS = 20 * 60_000;
+export const MAX_OUTPUT_BYTES = 5 * 1024 * 1024;
+export class CbmClient {
+    runtime;
+    invocation;
+    cacheRoot;
+    runtimeRoot;
+    constructor(runtime, invocation) {
+        this.runtime = runtime;
+        this.invocation = invocation;
+        this.cacheRoot = joinRuntimePath(runtime.storage('agent').root, 'codebase-memory/cache');
+        this.runtimeRoot = joinRuntimePath(runtime.storage('agent').root, 'codebase-memory/runtime');
+    }
+    async call(command, args, options = {}) {
+        const timeout = options.timeoutMs ?? (command === 'index_repository' ? INDEX_TIMEOUT_MS : QUERY_TIMEOUT_MS);
+        await this.runtime.storage('agent').mkdir('codebase-memory/runtime', { recursive: true });
+        const encoded = JSON.stringify(args);
+        const shellCommand = [
+            shellQuote(this.invocation.command),
+            'cli',
+            '--json',
+            shellQuote(command),
+            shellQuote(encoded),
+        ].join(' ');
+        const result = await this.runtime.shell(shellCommand, {
+            cwd: this.runtime.cwd,
+            env: { CBM_CACHE_DIR: this.cacheRoot, CBM_RUNTIME_DIR: this.runtimeRoot },
+            maxOutputBytes: MAX_OUTPUT_BYTES,
+            shellFlavor: 'posix',
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            timeout,
+        });
+        return parseResult(command, result);
+    }
+}
+export async function detectCbm(runtime) {
+    const candidates = [
+        {
+            command: joinRuntimePath(runtime.storage('agent').root, 'codebase-memory/bin/codebase-memory-mcp'),
+            source: 'managed',
+        },
+        { command: 'codebase-memory-mcp', source: 'path' },
+    ];
+    for (const candidate of candidates) {
+        let result;
+        try {
+            result = await runtime.exec(candidate.command, ['--version'], {
+                cwd: runtime.cwd,
+                maxOutputBytes: 64 * 1024,
+                timeout: 5_000,
+            });
+        }
+        catch {
+            continue;
+        }
+        if (result.code !== 0 || result.killed)
+            continue;
+        const version = `${result.stdout}\n${result.stderr}`.match(/\b(\d+\.\d+\.\d+)\b/u)?.[1];
+        if (version && isCompatibleVersion(version))
+            return { available: true, invocation: { ...candidate, version } };
+    }
+    return {
+        available: false,
+        reason: `Compatible codebase-memory-mcp ${CODEBASE_MEMORY_VERSION} is not installed.`,
+    };
+}
+function isCompatibleVersion(version) {
+    return version === CODEBASE_MEMORY_VERSION;
+}
+function parseResult(command, result) {
+    if (result.killed)
+        throw new Error(`${command} timed out or was cancelled`);
+    if (result.truncated)
+        throw new Error(`${command} exceeded the ${MAX_OUTPUT_BYTES}-byte output limit`);
+    if (result.code !== 0)
+        throw new Error(sanitize(result.stderr || result.stdout || `${command} exited ${result.code}`));
+    const trimmed = result.stdout.trim();
+    if (!trimmed)
+        throw new Error(`${command} produced no JSON output`);
+    let envelope;
+    try {
+        envelope = JSON.parse(trimmed);
+    }
+    catch {
+        const candidate = trimmed.split(/\r?\n/u).reverse().find((line) => line.trim().startsWith('{'));
+        if (!candidate)
+            throw new Error(`${command} produced invalid JSON output`);
+        envelope = JSON.parse(candidate);
+    }
+    const text = envelope.content?.find((block) => block.type === 'text' && typeof block.text === 'string')?.text;
+    if (text === undefined)
+        throw new Error(`${command} returned an envelope with no text content`);
+    let data = text;
+    try {
+        data = JSON.parse(text);
+    }
+    catch { /* Preserve non-JSON upstream text. */ }
+    if (envelope.isError)
+        throw new Error(sanitize(typeof data === 'string' ? data : JSON.stringify(data)));
+    return { data, stderr: sanitize(result.stderr) };
+}
+function sanitize(value) {
+    return value.replace(/\u001b\[[0-?]*[ -/]*[@-~]/gu, '').replace(/[\u0000-\u001f\u007f]/gu, ' ').trim().slice(0, 1_000);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+export declare const CODEBASE_MEMORY_CONFIG: import("@felan-ai/agent-core").ExtensionConfigDefinition<{
+    readonly maxCacheBytes: import("@felan-ai/agent-core").ExtensionConfigField<number>;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB;;EAYjC,CAAC"}

package/dist/config.js

@@ -0,0 +1,15 @@
+import { configField, defineExtensionConfig } from '@felan-ai/agent-core';
+export const CODEBASE_MEMORY_CONFIG = defineExtensionConfig({
+    id: 'codebaseMemory',
+    title: 'Codebase Memory',
+    fields: {
+        maxCacheBytes: configField.number({
+            default: 0,
+            description: 'Maximum bytes retained by the Codebase Memory LRU cache; 0 uses the runtime default',
+            validate: (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0
+                ? undefined
+                : 'must be a non-negative integer',
+        }),
+    },
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;IAC1D,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,iBAAiB;IACxB,MAAM,EAAE;QACN,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC;YAChC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,qFAAqF;YAClG,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;gBAClG,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,gCAAgC;SACrC,CAAC;KACH;CACF,CAAC,CAAC"}

package/dist/grep-augmentation.d.ts

@@ -0,0 +1,6 @@
+import type { FelanExtensionAPI } from '@felan-ai/agent-core';
+import type { CodebaseMemoryTelemetry } from './cache.js';
+import type { CbmClient } from './client.js';
+import type { ProjectService } from './services.js';
+export declare function registerGrepAugmentation(pi: FelanExtensionAPI, client: CbmClient, projects: ProjectService, telemetry: CodebaseMemoryTelemetry): void;
+//# sourceMappingURL=grep-augmentation.d.ts.map

package/dist/grep-augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep-augmentation.d.ts","sourceRoot":"","sources":["../src/grep-augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,iBAAiB,EACrB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,uBAAuB,GACjC,IAAI,CAiDN"}

package/dist/grep-augmentation.js

@@ -0,0 +1,103 @@
+const GREP_AUGMENT_TIMEOUT_MS = 1_500;
+const COMMAND_TOOLS = ['bash', 'exec_command'];
+export function registerGrepAugmentation(pi, client, projects, telemetry) {
+    const patterns = new Map();
+    pi.on('tool_call', (event) => {
+        if (!COMMAND_TOOLS.includes(event.toolName))
+            return;
+        const command = readCommand(event.toolName, event.input);
+        const pattern = command ? grepPattern(command) : undefined;
+        if (pattern)
+            patterns.set(event.toolCallId, { pattern, tool: event.toolName });
+    });
+    pi.on('tool_result', async (event, _ctx) => {
+        const pending = patterns.get(event.toolCallId);
+        if (!pending)
+            return undefined;
+        patterns.delete(event.toolCallId);
+        if (event.isError)
+            return undefined;
+        const startedAt = Date.now();
+        try {
+            const project = await projects.project(undefined, remainingMs(startedAt));
+            const result = await client.call('search_code', {
+                project,
+                pattern: pending.pattern,
+                context: 2,
+                limit: 20,
+                max_symbol_lines: 220,
+            }, { timeoutMs: remainingMs(startedAt) });
+            const text = typeof result.data === 'string' ? result.data : JSON.stringify(result.data, null, 2);
+            const hit = hasResults(result.data);
+            telemetry('grep_augmentation', {
+                tool: pending.tool,
+                hit,
+                durationMs: Date.now() - startedAt,
+                deadlineMs: GREP_AUGMENT_TIMEOUT_MS,
+            });
+            if (!hit)
+                return undefined;
+            return {
+                content: [
+                    ...event.content,
+                    { type: 'text', text: `Codebase Memory augmentation (possibly stale; grep remains authoritative):\n${text}` },
+                ],
+            };
+        }
+        catch {
+            telemetry('grep_augmentation', {
+                tool: pending.tool,
+                hit: false,
+                error: true,
+                durationMs: Date.now() - startedAt,
+                deadlineMs: GREP_AUGMENT_TIMEOUT_MS,
+            });
+            return undefined;
+        }
+    });
+}
+function remainingMs(startedAt) {
+    return Math.max(1, GREP_AUGMENT_TIMEOUT_MS - (Date.now() - startedAt));
+}
+function readCommand(tool, input) {
+    const value = tool === 'exec_command' ? input.cmd : input.command;
+    return typeof value === 'string' ? value : undefined;
+}
+function grepPattern(command) {
+    const segment = command.split(/(?:&&|;|\|\|)/u).find((part) => /(?:^|\s)(?:grep|rg)(?:\s|$)/u.test(part));
+    if (!segment)
+        return undefined;
+    const tokens = segment.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/gu) ?? [];
+    const index = tokens.findIndex((token) => token === 'grep' || token === 'rg');
+    const optionsWithValues = new Set([
+        '-A', '-B', '-C', '-f', '-g', '-j', '-m', '-t', '-T',
+        '--after-context', '--before-context', '--context', '--encoding', '--engine',
+        '--file', '--glob', '--iglob', '--max-count', '--sort', '--sortr', '--threads',
+        '--type', '--type-not',
+    ]);
+    for (let position = index + 1; position < tokens.length; position += 1) {
+        const token = tokens[position];
+        if (token === '-e' || token === '--regexp')
+            return unquote(tokens[position + 1]);
+        if (optionsWithValues.has(token)) {
+            position += 1;
+            continue;
+        }
+        if (token.startsWith('-'))
+            continue;
+        return unquote(token);
+    }
+    return undefined;
+}
+function unquote(token) {
+    return token?.replace(/^(['"])(.*)\1$/u, '$2');
+}
+function hasResults(value) {
+    if (typeof value === 'string')
+        return value.trim().length > 0;
+    if (!value || typeof value !== 'object')
+        return false;
+    const results = Reflect.get(value, 'results');
+    return Array.isArray(results) ? results.length > 0 : true;
+}
+//# sourceMappingURL=grep-augmentation.js.map

package/dist/grep-augmentation.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { type FelanExtension } from '@felan-ai/agent-core';
+import { type CodebaseMemoryTelemetry } from './cache.js';
+export declare const CODEBASE_MEMORY_CAPABILITY_INSTRUCTIONS = "Use Codebase Memory for structural code exploration before broad raw searches: read_symbol reads a known symbol, search_and_read_symbols finds and reads likely implementations, search_code searches indexed text, and codebase_memory proxies other structural queries or refreshes with {command:\"index_repository\"}. The index is built at startup and refreshed only when the model calls index_repository or the user invokes /codebase-memory. It may be stale after edits. Direct reads, grep, compiler output, and tests remain authoritative; grep output can include bounded Codebase Memory augmentation. Keep symbol reads focused and at no more than 220 lines per symbol.";
+export interface CodebaseMemoryExtensionOptions {
+    readonly telemetry?: CodebaseMemoryTelemetry;
+    readonly log?: (level: 'error' | 'info', message: string, fields: Record<string, unknown>) => void;
+}
+export declare function createCodebaseMemoryExtension(options?: CodebaseMemoryExtensionOptions): FelanExtension;
+declare const codebaseMemoryExtension: FelanExtension;
+export default codebaseMemoryExtension;
+export { CODEBASE_MEMORY_CONFIG } from './config.js';
+export { CODEBASE_MEMORY_VERSION as MANAGED_CODEBASE_MEMORY_VERSION, detectCbm as inspectCodebaseMemoryRuntime, } from './client.js';
+export { installManagedCbm as installManagedCodebaseMemory } from './installer.js';
+//# 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,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAQ1D,eAAO,MAAM,uCAAuC,gqBAA8pB,CAAC;AAEntB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACpG;AAED,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,8BAAmC,GAAG,cAAc,CAyE1G;AAiBD,QAAA,MAAM,uBAAuB,gBAAkC,CAAC;AAChE,eAAe,uBAAuB,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,uBAAuB,IAAI,+BAA+B,EAC1D,SAAS,IAAI,4BAA4B,GAC1C,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,IAAI,4BAA4B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,102 @@
+import { associateExtensionConfig, } from '@felan-ai/agent-core';
+import {} from './cache.js';
+import { CbmClient, detectCbm } from './client.js';
+import { CODEBASE_MEMORY_CONFIG } from './config.js';
+import { registerGrepAugmentation } from './grep-augmentation.js';
+import { installManagedCbm } from './installer.js';
+import { ProjectService, SymbolService } from './services.js';
+import { registerTools } from './tools.js';
+export const CODEBASE_MEMORY_CAPABILITY_INSTRUCTIONS = `Use Codebase Memory for structural code exploration before broad raw searches: read_symbol reads a known symbol, search_and_read_symbols finds and reads likely implementations, search_code searches indexed text, and codebase_memory proxies other structural queries or refreshes with {command:"index_repository"}. The index is built at startup and refreshed only when the model calls index_repository or the user invokes /codebase-memory. It may be stale after edits. Direct reads, grep, compiler output, and tests remain authoritative; grep output can include bounded Codebase Memory augmentation. Keep symbol reads focused and at no more than 220 lines per symbol.`;
+export function createCodebaseMemoryExtension(options = {}) {
+    const log = options.log ?? ((level, message, fields) => {
+        if (level === 'error')
+            console.error(`[codebase-memory] ERROR ${message}`, fields);
+        else
+            console.info(`[codebase-memory] ${message}`, fields);
+    });
+    const extension = async (pi) => {
+        const telemetry = options.telemetry ?? ((event, fields) => {
+            if (pi.runtime.kind !== 'host')
+                log('info', `telemetry.${event}`, fields);
+        });
+        let detection = await detectCbm(pi.runtime);
+        let hintShown = false;
+        let projects;
+        const activate = (available) => {
+            const client = new CbmClient(pi.runtime, available.invocation);
+            const configured = pi.config.maxCacheBytes;
+            const maxCacheBytes = typeof configured === 'number' && configured > 0 ? configured : undefined;
+            projects = new ProjectService(pi.runtime, client, maxCacheBytes, telemetry);
+            const symbols = new SymbolService(client, projects);
+            pi.registerCapability({ id: 'codebase-memory', instructions: CODEBASE_MEMORY_CAPABILITY_INSTRUCTIONS });
+            registerTools(pi, client, projects, symbols);
+            registerGrepAugmentation(pi, client, projects, telemetry);
+        };
+        if (detection.available)
+            activate(detection);
+        else if (pi.runtime.kind !== 'host') {
+            log('error', 'Compatible codebase-memory-mcp binary is unavailable; extension disabled nonfatally.', {
+                runtimeKind: pi.runtime.kind,
+                reason: detection.reason,
+            });
+        }
+        pi.registerCommand('codebase-memory', {
+            description: 'Refresh the repository index or explicitly install Codebase Memory',
+            handler: async (args, ctx) => {
+                const action = args.trim().toLowerCase();
+                if (action && action !== 'install' && action !== 'refresh') {
+                    ctx.ui.notify('Usage: /codebase-memory [refresh|install]', 'warning');
+                    return;
+                }
+                if (action === 'install') {
+                    if (!await ctx.ui.confirm('Install Codebase Memory', 'Download the pinned reviewed installer and Codebase Memory 0.10.8 binary into Felan agent storage?'))
+                        return;
+                    detection = await installManagedCbm(pi.runtime, (message) => ctx.ui.setStatus('codebase-memory', `… ${message}`));
+                    ctx.ui.setStatus('codebase-memory', undefined);
+                    ctx.ui.notify(detectionMessage(detection), detection.available ? 'info' : 'error');
+                    return;
+                }
+                if (!projects) {
+                    ctx.ui.notify(detection.available
+                        ? 'Codebase Memory was installed after this session started. Restart Felan to activate it.'
+                        : `${detection.reason} Use /codebase-memory install to install it.`, 'warning');
+                    return;
+                }
+                await refresh(projects, ctx);
+            },
+        });
+        pi.on('session_start', async (_event, ctx) => {
+            if (!projects) {
+                if (pi.runtime.kind === 'host' && ctx.hasUI && !hintShown) {
+                    hintShown = true;
+                    ctx.ui.notify('Codebase Memory is unavailable. Run /codebase-memory install to install the reviewed binary.', 'info');
+                }
+                return;
+            }
+            await refresh(projects, ctx);
+        });
+    };
+    associateExtensionConfig(extension, CODEBASE_MEMORY_CONFIG);
+    return extension;
+}
+function detectionMessage(detection) {
+    return detection.available ? 'Codebase Memory installed. Restart Felan to activate it.' : detection.reason;
+}
+async function refresh(projects, ctx) {
+    ctx.ui.setStatus('codebase-memory', '… Indexing repository');
+    try {
+        await projects.index(ctx.signal);
+        ctx.ui.setStatus('codebase-memory', '✓ Codebase Memory indexed');
+    }
+    catch (error) {
+        ctx.ui.setStatus('codebase-memory', undefined);
+        if (ctx.hasUI)
+            ctx.ui.notify(`Codebase Memory index failed: ${error instanceof Error ? error.message : String(error)}`, 'warning');
+    }
+}
+const codebaseMemoryExtension = createCodebaseMemoryExtension();
+export default codebaseMemoryExtension;
+export { CODEBASE_MEMORY_CONFIG } from './config.js';
+export { CODEBASE_MEMORY_VERSION as MANAGED_CODEBASE_MEMORY_VERSION, detectCbm as inspectCodebaseMemoryRuntime, } from './client.js';
+export { installManagedCbm as installManagedCodebaseMemory } from './installer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/installer.d.ts

@@ -0,0 +1,4 @@
+import type { AgentRuntime } from '@felan-ai/agent-core';
+import { type CbmDetection } from './client.js';
+export declare function installManagedCbm(runtime: AgentRuntime, onStatus?: (message: string) => void): Promise<CbmDetection>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAQpF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,QAAQ,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,GAC7C,OAAO,CAAC,YAAY,CAAC,CAiCvB"}

package/dist/installer.js

@@ -0,0 +1,50 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { CODEBASE_MEMORY_VERSION, detectCbm } from './client.js';
+import { joinRuntimePath } from './runtime-path.js';
+const INSTALLER_COMMIT = '46ae198fc11cda80e817acbc5f5908d7c2de7032';
+const INSTALLER_SHA256 = '2fdd4d6563fc8e540bb32e233c5fdef22ecf05d7ebd5a80657cd4fec953b3475';
+const INSTALLER_URL = `https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/${INSTALLER_COMMIT}/install.sh`;
+const RELEASE_URL = `https://github.com/DeusData/codebase-memory-mcp/releases/download/v${CODEBASE_MEMORY_VERSION}`;
+export async function installManagedCbm(runtime, onStatus = () => { }) {
+    const session = runtime.storage('session');
+    const relative = `codebase-memory/install-${randomUUID()}.sh`;
+    const script = joinRuntimePath(session.root, relative);
+    const binDir = joinRuntimePath(runtime.storage('agent').root, 'codebase-memory/bin');
+    await session.mkdir('codebase-memory', { recursive: true });
+    await runtime.storage('agent').mkdir('codebase-memory/bin', { recursive: true });
+    try {
+        onStatus('Downloading the pinned Codebase Memory installer...');
+        const downloaded = await runtime.exec('curl', [
+            '--proto', '=https', '--tlsv1.2', '--fail', '--silent', '--show-error', '--location',
+            '--max-filesize', String(128 * 1024), INSTALLER_URL, '--output', script,
+        ], { cwd: runtime.cwd, timeout: 30_000, maxOutputBytes: 64 * 1024 });
+        if (!successful(downloaded))
+            return unavailable(downloaded.stderr || downloaded.stdout || 'download failed');
+        const bytes = await session.readFile(relative, { maxBytes: 128 * 1024 + 1 });
+        if (createHash('sha256').update(bytes).digest('hex') !== INSTALLER_SHA256) {
+            return unavailable('Installer SHA-256 mismatch; refusing to execute it.');
+        }
+        onStatus(`Installing Codebase Memory ${CODEBASE_MEMORY_VERSION} in Felan agent storage...`);
+        const installed = await runtime.shell(`/bin/bash '${script.replaceAll("'", `'"'"'`)}' --dir '${binDir.replaceAll("'", `'"'"'`)}' --skip-config`, {
+            cwd: runtime.cwd,
+            env: { CBM_DOWNLOAD_URL: RELEASE_URL },
+            maxOutputBytes: 5 * 1024 * 1024,
+            shellFlavor: 'posix',
+            timeout: 180_000,
+        });
+        if (!successful(installed))
+            return unavailable(installed.stderr || installed.stdout || 'installer failed');
+        return detectCbm(runtime);
+    }
+    catch (error) {
+        return unavailable(error instanceof Error ? error.message : String(error));
+    }
+    finally {
+        await session.remove(relative).catch(() => { });
+    }
+}
+function successful(result) { return result.code === 0 && !result.killed; }
+function unavailable(reason) {
+    return { available: false, reason: `Managed Codebase Memory installation failed: ${reason.slice(0, 500)}` };
+}
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

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

package/dist/runtime-path.d.ts

@@ -0,0 +1,3 @@
+export declare function joinRuntimePath(root: string, ...parts: string[]): string;
+export declare function shellQuote(value: string): string;
+//# sourceMappingURL=runtime-path.d.ts.map

package/dist/runtime-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-path.d.ts","sourceRoot":"","sources":["../src/runtime-path.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAKxE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/runtime-path.js

@@ -0,0 +1,10 @@
+export function joinRuntimePath(root, ...parts) {
+    const separator = root.includes('\\') && !root.includes('/') ? '\\' : '/';
+    return [root.replace(/[\\/]+$/u, ''), ...parts.map((part) => part.replace(/^[\\/]+|[\\/]+$/gu, ''))]
+        .filter(Boolean)
+        .join(separator);
+}
+export function shellQuote(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+//# sourceMappingURL=runtime-path.js.map

package/dist/runtime-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-path.js","sourceRoot":"","sources":["../src/runtime-path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,GAAG,KAAe;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC;SACjG,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;AAC/C,CAAC"}

package/dist/services.d.ts

@@ -0,0 +1,21 @@
+import type { AgentRuntime } from '@felan-ai/agent-core';
+import { type CodebaseMemoryTelemetry } from './cache.js';
+import { CbmClient } from './client.js';
+export declare class ProjectService {
+    #private;
+    private readonly runtime;
+    private readonly client;
+    constructor(runtime: AgentRuntime, client: CbmClient, maxCacheBytes: number | undefined, telemetry: CodebaseMemoryTelemetry);
+    gitRoot(signal?: AbortSignal, timeout?: number): Promise<string>;
+    index(signal?: AbortSignal): Promise<unknown>;
+    project(signal?: AbortSignal, timeoutMs?: number): Promise<string>;
+}
+export declare class SymbolService {
+    private readonly client;
+    private readonly projects;
+    constructor(client: CbmClient, projects: ProjectService);
+    read(params: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
+    searchAndRead(params: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
+}
+export declare function asRecord(value: unknown): Record<string, unknown>;
+//# sourceMappingURL=services.d.ts.map

package/dist/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAgB,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAI1D,qBAAa,cAAc;;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,SAAS,EAClC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,SAAS,EAAE,uBAAuB;IAO9B,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAgC7C,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYzE;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAa,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAA5C,MAAM,EAAE,SAAS,EAAmB,QAAQ,EAAE,cAAc;IAEnF,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAmC7E,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAoB7F;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhE"}

package/dist/services.js

@@ -0,0 +1,179 @@
+import { CacheManager } from './cache.js';
+import { CbmClient, INDEX_TIMEOUT_MS } from './client.js';
+const activeIndexes = new Map();
+export class ProjectService {
+    runtime;
+    client;
+    #cache;
+    #project;
+    constructor(runtime, client, maxCacheBytes, telemetry) {
+        this.runtime = runtime;
+        this.client = client;
+        this.#cache = new CacheManager(runtime, maxCacheBytes, telemetry, async (project) => {
+            await client.call('delete_project', { project }).catch(() => { });
+        }, () => this.#cacheSize());
+    }
+    async gitRoot(signal, timeout = 10_000) {
+        const result = await this.runtime.exec('git', ['rev-parse', '--show-toplevel'], {
+            cwd: this.runtime.cwd,
+            maxOutputBytes: 64 * 1024,
+            ...(signal === undefined ? {} : { signal }),
+            timeout,
+        });
+        return result.code === 0 && !result.killed ? result.stdout.trim() || this.runtime.cwd : this.runtime.cwd;
+    }
+    async index(signal) {
+        const root = await this.gitRoot(signal);
+        const key = `${this.client.cacheRoot}\u0000${root}`;
+        const existing = activeIndexes.get(key);
+        if (existing)
+            return existing;
+        const request = this.client.call('index_repository', { repo_path: root, mode: 'full' }, {
+            ...(signal === undefined ? {} : { signal }),
+            timeoutMs: INDEX_TIMEOUT_MS,
+        }).then(async ({ data }) => {
+            const record = asRecord(data);
+            const project = typeof record.project === 'string' ? record.project : projectName(root);
+            this.#project = project;
+            await this.#cache.record(project, 0);
+            return data;
+        }).finally(() => { activeIndexes.delete(key); });
+        activeIndexes.set(key, request);
+        return request;
+    }
+    async #cacheSize() {
+        try {
+            const listed = await this.client.call('list_projects', {});
+            const projects = arrayProperty(listed.data, 'projects');
+            return projects.reduce((sum, project) => {
+                const bytes = asRecord(project).size_bytes;
+                return typeof bytes === 'number' && Number.isFinite(bytes) ? sum + bytes : sum;
+            }, 0);
+        }
+        catch {
+            return this.#cache.maxBytes + 1;
+        }
+    }
+    async project(signal, timeoutMs) {
+        if (this.#project)
+            return this.#project;
+        const root = await this.gitRoot(signal, timeoutMs);
+        const listed = await this.client.call('list_projects', {}, {
+            ...(signal === undefined ? {} : { signal }),
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+        });
+        const projects = Array.isArray(asRecord(listed.data).projects) ? asRecord(listed.data).projects : [];
+        const match = projects.map(asRecord).find((candidate) => candidate.root_path === root);
+        this.#project = typeof match?.name === 'string' ? match.name : projectName(root);
+        return this.#project;
+    }
+}
+export class SymbolService {
+    client;
+    projects;
+    constructor(client, projects) {
+        this.client = client;
+        this.projects = projects;
+    }
+    async read(params, signal) {
+        const project = await this.projects.project(signal);
+        const search = await this.client.call('search_graph', {
+            project,
+            ...(params.qualified_name === undefined
+                ? { query: params.name }
+                : { qn_pattern: params.qualified_name }),
+            format: 'json',
+            limit: 10,
+        }, signal === undefined ? {} : { signal });
+        const candidates = searchCandidates(search.data);
+        const matches = candidates.filter((item) => {
+            const candidate = asRecord(item);
+            const qualifiedName = typeof candidate.qualified_name === 'string' ? candidate.qualified_name : '';
+            const requestedName = typeof params.name === 'string' ? params.name : undefined;
+            return (!requestedName
+                || candidate.name === requestedName
+                || qualifiedName.split('.').at(-1) === requestedName)
+                && (!params.qualified_name || qualifiedName === params.qualified_name)
+                && (!params.file_path || String(candidate.file_path ?? '').includes(String(params.file_path)));
+        });
+        if (matches.length > 1) {
+            return {
+                project,
+                candidates: matches,
+                error: 'Symbol lookup is ambiguous; retry with qualified_name or file_path.',
+            };
+        }
+        const selected = matches[0];
+        const qualifiedName = asRecord(selected).qualified_name;
+        if (typeof qualifiedName !== 'string')
+            return { project, candidates, error: 'No matching symbol found' };
+        const snippet = await this.client.call('get_code_snippet', { project, qualified_name: qualifiedName }, signal === undefined ? {} : { signal });
+        return { project, symbol: selected, snippet: boundSnippet(snippet.data, params.max_symbol_lines) };
+    }
+    async searchAndRead(params, signal) {
+        const project = await this.projects.project(signal);
+        const search = await this.client.call('search_graph', {
+            project,
+            query: params.query,
+            file_pattern: params.file_pattern,
+            limit: params.limit ?? 20,
+            format: 'json',
+        }, signal === undefined ? {} : { signal });
+        const candidates = searchCandidates(search.data);
+        const readLimit = clampInt(params.read_limit, 1, 12, 6);
+        const symbols = [];
+        for (const candidate of candidates.slice(0, readLimit)) {
+            const qualifiedName = asRecord(candidate).qualified_name;
+            if (typeof qualifiedName !== 'string')
+                continue;
+            const snippet = await this.client.call('get_code_snippet', { project, qualified_name: qualifiedName }, signal === undefined ? {} : { signal });
+            symbols.push({ symbol: candidate, snippet: boundSnippet(snippet.data, params.max_symbol_lines) });
+        }
+        return { project, candidates, symbols };
+    }
+}
+export function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : {};
+}
+function arrayProperty(value, key) {
+    const candidate = asRecord(value)[key];
+    return Array.isArray(candidate) ? candidate : [];
+}
+function searchCandidates(value) {
+    const results = arrayProperty(value, 'results');
+    if (results.length > 0)
+        return results;
+    const record = asRecord(value);
+    if (!Array.isArray(record.cols) || !Array.isArray(record.rows))
+        return [];
+    const columns = record.cols.filter((column) => typeof column === 'string');
+    return record.rows.filter(Array.isArray).map((row) => Object.fromEntries(columns.map((column, index) => [column === 'qn' ? 'qualified_name' : column, row[index]])));
+}
+function projectName(path) {
+    return path.replaceAll('\\', '/').split('/').filter(Boolean).at(-1)?.replace(/[^A-Za-z0-9._-]/gu, '-') || 'project';
+}
+function clampInt(value, min, max, fallback) {
+    return typeof value === 'number' && Number.isSafeInteger(value) ? Math.max(min, Math.min(max, value)) : fallback;
+}
+function boundSnippet(value, requestedLines) {
+    const maxLines = clampInt(requestedLines, 1, 220, 220);
+    if (typeof value === 'string')
+        return boundText(value, maxLines);
+    const record = asRecord(value);
+    for (const field of ['code', 'source', 'snippet']) {
+        if (typeof record[field] !== 'string')
+            continue;
+        const bounded = boundText(record[field], maxLines);
+        if (typeof bounded === 'string')
+            return value;
+        return { ...record, [field]: bounded.text, truncated: true, original_lines: bounded.originalLines };
+    }
+    return value;
+}
+function boundText(value, maxLines) {
+    const lines = value.split(/\r?\n/u);
+    if (lines.length <= maxLines)
+        return value;
+    return { text: lines.slice(0, maxLines).join('\n'), originalLines: lines.length };
+}
+//# sourceMappingURL=services.js.map

package/dist/services.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,5 @@
+import type { FelanExtensionAPI } from '@felan-ai/agent-core';
+import type { CbmClient } from './client.js';
+import type { ProjectService, SymbolService } from './services.js';
+export declare function registerTools(pi: FelanExtensionAPI, client: CbmClient, projects: ProjectService, symbols: SymbolService): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,sBAAsB,CAAC;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgBnE,wBAAgB,aAAa,CAC3B,EAAE,EAAE,iBAAiB,EACrB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,aAAa,GACrB,IAAI,CA2EN"}

package/dist/tools.js

@@ -0,0 +1,98 @@
+import { Type } from 'typebox';
+const MaxSymbolLines = Type.Optional(Type.Integer({ minimum: 1, maximum: 220, default: 220 }));
+const ProxyCommand = Type.Union([
+    Type.Literal('index_repository'),
+    Type.Literal('search_graph'),
+    Type.Literal('query_graph'),
+    Type.Literal('trace_path'),
+    Type.Literal('get_graph_schema'),
+    Type.Literal('get_architecture'),
+    Type.Literal('index_status'),
+    Type.Literal('check_index_coverage'),
+    Type.Literal('detect_changes'),
+]);
+const PROXY_COMMANDS = new Set(ProxyCommand.anyOf.map((entry) => entry.const));
+export function registerTools(pi, client, projects, symbols) {
+    const tools = [
+        {
+            name: 'codebase_memory',
+            label: 'codebase_memory',
+            description: 'Proxy a Codebase Memory structural query or explicitly refresh the current repository with command index_repository.',
+            promptSnippet: 'Structural code query or explicit repository index refresh',
+            parameters: Type.Object({
+                command: ProxyCommand,
+                arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+            }, { additionalProperties: false }),
+            execute: async (_id, params, signal) => {
+                const input = params;
+                if (!PROXY_COMMANDS.has(input.command)) {
+                    throw new Error(`Unsupported Codebase Memory command: ${input.command}`);
+                }
+                const args = input.arguments ?? {};
+                const data = input.command === 'index_repository'
+                    ? await projects.index(signal)
+                    : (await client.call(input.command, {
+                        ...args,
+                        project: await projects.project(signal),
+                    }, signal === undefined ? {} : { signal })).data;
+                return toolResult(data);
+            },
+        },
+        {
+            name: 'read_symbol',
+            label: 'read_symbol',
+            description: 'Resolve and read one function, method, class, type, route, or other named symbol.',
+            promptSnippet: 'Resolve and read a named code symbol',
+            parameters: Type.Object({
+                name: Type.Optional(Type.String()),
+                qualified_name: Type.Optional(Type.String()),
+                file_path: Type.Optional(Type.String()),
+                max_symbol_lines: MaxSymbolLines,
+            }, { additionalProperties: false }),
+            execute: async (_id, params, signal) => toolResult(await symbols.read(params, signal)),
+        },
+        {
+            name: 'search_and_read_symbols',
+            label: 'search_and_read_symbols',
+            description: 'Find likely symbols and return focused source for the best matches.',
+            promptSnippet: 'Search for symbols and read the best matches',
+            parameters: Type.Object({
+                query: Type.String(),
+                file_pattern: Type.Optional(Type.String()),
+                limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 50, default: 20 })),
+                read_limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 12, default: 6 })),
+                max_symbol_lines: MaxSymbolLines,
+            }, { additionalProperties: false }),
+            execute: async (_id, params, signal) => toolResult(await symbols.searchAndRead(params, signal)),
+        },
+        {
+            name: 'search_code',
+            label: 'search_code',
+            description: 'Search indexed code for literal or regular-expression text with graph-aware context.',
+            promptSnippet: 'Search indexed source text',
+            parameters: Type.Object({
+                pattern: Type.String(),
+                file_pattern: Type.Optional(Type.String()),
+                path_filter: Type.Optional(Type.String()),
+                regex: Type.Optional(Type.Boolean()),
+                context: Type.Optional(Type.Integer({ minimum: 0, maximum: 20, default: 2 })),
+                limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 100, default: 20 })),
+                max_symbol_lines: MaxSymbolLines,
+            }, { additionalProperties: false }),
+            execute: async (_id, params, signal) => {
+                const input = params;
+                const project = await projects.project(signal);
+                return toolResult((await client.call('search_code', { ...input, project }, signal === undefined ? {} : { signal })).data);
+            },
+        },
+    ];
+    for (const tool of tools)
+        pi.registerTool(tool);
+}
+function toolResult(data) {
+    return {
+        content: [{ type: 'text', text: typeof data === 'string' ? data : JSON.stringify(data, null, 2) }],
+        details: { data },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@felan-ai/ext-codebase-memory",
+  "version": "0.0.0",
+  "description": "Portable Codebase Memory tools and grep augmentation for Felan",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/felan-ai/felan.git",
+    "directory": "packages/ext-codebase-memory"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "typebox": "1.1.38"
+  },
+  "peerDependencies": {
+    "@felan-ai/agent-core": "^0.5.0"
+  },
+  "devDependencies": {
+    "@felan-ai/agent-core": "0.5.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}