@gencode/agents 0.0.1

package/dist/memory/config.js

@@ -0,0 +1,46 @@
+export const DEFAULT_MEMORY_SEARCH_CONFIG = {
+    chunkTokens: 400,
+    chunkOverlap: 80,
+    maxResults: 6,
+    minScore: 0.35,
+    embedding: {},
+    experimental: {
+        sessionMemory: false,
+    },
+    sources: ["memory"],
+    store: {
+        vector: {
+            enabled: true,
+        },
+    },
+    hybrid: {
+        enabled: true,
+        vectorWeight: 0.7,
+        textWeight: 0.3,
+        candidateMultiplier: 4,
+        mmr: {
+            enabled: false,
+            lambda: 0.7,
+        },
+        temporalDecay: {
+            enabled: false,
+            halfLifeDays: 30,
+        },
+    },
+    cache: {
+        enabled: true,
+        maxEntries: 50000,
+    },
+    sync: {
+        onSessionStart: true,
+        onSearch: true,
+        watch: true,
+        watchDebounceMs: 1500,
+        sessions: {
+            deltaBytes: 100_000,
+            deltaMessages: 50,
+        },
+    },
+    citations: "auto",
+};
+//# sourceMappingURL=config.js.map

package/dist/memory/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAiDA,MAAM,CAAC,MAAM,4BAA4B,GAAuB;IAC9D,WAAW,EAAE,GAAG;IAChB,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,EAAE;IACb,YAAY,EAAE;QACZ,aAAa,EAAE,KAAK;KACrB;IACD,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,KAAK,EAAE;QACL,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;SACd;KACF;IACD,MAAM,EAAE;QACN,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,GAAG;QACjB,UAAU,EAAE,GAAG;QACf,mBAAmB,EAAE,CAAC;QACtB,GAAG,EAAE;YACH,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,GAAG;SACZ;QACD,aAAa,EAAE;YACb,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,EAAE;SACjB;KACF;IACD,KAAK,EAAE;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,KAAK;KAClB;IACD,IAAI,EAAE;QACJ,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,IAAI;QACX,eAAe,EAAE,IAAI;QACrB,QAAQ,EAAE;YACR,UAAU,EAAE,OAAO;YACnB,aAAa,EAAE,EAAE;SAClB;KACF;IACD,SAAS,EAAE,MAAM;CAClB,CAAC"}

package/dist/memory/embedding-registry.d.ts

@@ -0,0 +1,37 @@
+import type { EmbeddingProvider } from "./embeddings.js";
+export type EmbeddingProviderContext = {
+    dataDir: string;
+    memoryDir: string;
+    pluginId?: string;
+    config?: Record<string, unknown>;
+    rootDir?: string;
+    source?: string;
+};
+export type EmbeddingProviderFactory = (ctx: EmbeddingProviderContext) => EmbeddingProvider;
+export type EmbeddingProviderRegistration = {
+    id: string;
+    pluginId?: string;
+    create: EmbeddingProviderFactory;
+    config?: Record<string, unknown>;
+    rootDir?: string;
+    source?: string;
+};
+export declare function registerEmbeddingProvider(params: {
+    pluginId: string;
+    create: EmbeddingProviderFactory;
+    id?: string;
+    config?: Record<string, unknown>;
+    rootDir?: string;
+    source?: string;
+}): string;
+export declare function resolveEmbeddingProvider(params: {
+    providerId?: string;
+    pluginId?: string;
+    dataDir: string;
+    memoryDir: string;
+}): {
+    provider: EmbeddingProvider;
+    registration: EmbeddingProviderRegistration;
+} | null;
+export declare function resetEmbeddingProviderRegistryForTests(): void;
+//# sourceMappingURL=embedding-registry.d.ts.map

package/dist/memory/embedding-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-registry.d.ts","sourceRoot":"","sources":["../../src/memory/embedding-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,wBAAwB,KAAK,iBAAiB,CAAC;AAE5F,MAAM,MAAM,6BAA6B,GAAG;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA8BF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,wBAAwB,CAAC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAWT;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,QAAQ,EAAE,iBAAiB,CAAC;IAAC,YAAY,EAAE,6BAA6B,CAAA;CAAE,GAAG,IAAI,CAkBtF;AAED,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D"}

package/dist/memory/embedding-registry.js

@@ -0,0 +1,56 @@
+class EmbeddingProviderRegistry {
+    providers = new Map();
+    byPluginId = new Map();
+    register(params) {
+        this.providers.set(params.id, params);
+        if (params.pluginId) {
+            this.byPluginId.set(params.pluginId, params.id);
+        }
+    }
+    getById(id) {
+        return this.providers.get(id);
+    }
+    getByPluginId(pluginId) {
+        const id = this.byPluginId.get(pluginId);
+        return id ? this.providers.get(id) : undefined;
+    }
+    clear() {
+        this.providers.clear();
+        this.byPluginId.clear();
+    }
+}
+const REGISTRY = new EmbeddingProviderRegistry();
+export function registerEmbeddingProvider(params) {
+    const id = params.id?.trim() || params.pluginId;
+    REGISTRY.register({
+        id,
+        pluginId: params.pluginId,
+        create: params.create,
+        config: params.config,
+        rootDir: params.rootDir,
+        source: params.source,
+    });
+    return id;
+}
+export function resolveEmbeddingProvider(params) {
+    const providerId = params.providerId?.trim();
+    const pluginId = params.pluginId?.trim();
+    const registration = (providerId ? REGISTRY.getById(providerId) : undefined) ??
+        (pluginId ? REGISTRY.getByPluginId(pluginId) : undefined);
+    if (!registration) {
+        return null;
+    }
+    const provider = registration.create({
+        dataDir: params.dataDir,
+        memoryDir: params.memoryDir,
+        pluginId: registration.pluginId,
+        config: registration.config,
+        rootDir: registration.rootDir,
+        source: registration.source,
+    });
+    return { provider, registration };
+}
+export function resetEmbeddingProviderRegistryForTests() {
+    REGISTRY.clear();
+}
+//# sourceMappingURL=embedding-registry.js.map

package/dist/memory/embedding-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-registry.js","sourceRoot":"","sources":["../../src/memory/embedding-registry.ts"],"names":[],"mappings":"AAsBA,MAAM,yBAAyB;IACZ,SAAS,GAAG,IAAI,GAAG,EAAyC,CAAC;IAC7D,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExD,QAAQ,CAAC,MAAqC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;AAEjD,MAAM,UAAU,yBAAyB,CAAC,MAOzC;IACC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC;QAChB,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAKxC;IACC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,YAAY,GAChB,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,MAAM,EAAE,YAAY,CAAC,MAAM;KAC5B,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,sCAAsC;IACpD,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/memory/embeddings.d.ts

@@ -0,0 +1,11 @@
+export type EmbeddingProvider = {
+    id: string;
+    model: string;
+    embedQuery: (text: string) => Promise<number[]>;
+    embedBatch: (texts: string[]) => Promise<number[][]>;
+};
+export declare function createMockEmbeddingProvider(params?: {
+    model?: string;
+    dimensions?: number;
+}): EmbeddingProvider;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/memory/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/memory/embeddings.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACtD,CAAC;AAkCF,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,iBAAiB,CAUpB"}

package/dist/memory/embeddings.js

@@ -0,0 +1,40 @@
+import crypto from "node:crypto";
+const DEFAULT_DIMENSIONS = 384;
+function tokenize(text) {
+    const tokens = text.toLowerCase().match(/[\p{L}\p{N}_]+/gu) ?? [];
+    return tokens.filter(Boolean);
+}
+function hashToken(token) {
+    const hash = crypto.createHash("sha256").update(token).digest();
+    return hash.readUInt32BE(0);
+}
+function buildEmbedding(text, dims = DEFAULT_DIMENSIONS) {
+    const vec = new Array(dims).fill(0);
+    const tokens = tokenize(text);
+    if (tokens.length === 0) {
+        return vec;
+    }
+    for (const token of tokens) {
+        const h = hashToken(token);
+        const idx = h % dims;
+        vec[idx] += 1;
+    }
+    const norm = Math.sqrt(vec.reduce((sum, v) => sum + v * v, 0));
+    if (norm > 0) {
+        for (let i = 0; i < vec.length; i += 1) {
+            vec[i] = vec[i] / norm;
+        }
+    }
+    return vec;
+}
+export function createMockEmbeddingProvider(params) {
+    const model = params?.model?.trim() || "mock-embedding-v1";
+    const dimensions = params?.dimensions ?? DEFAULT_DIMENSIONS;
+    return {
+        id: "external-mock",
+        model,
+        embedQuery: async (text) => buildEmbedding(text, dimensions),
+        embedBatch: async (texts) => texts.map((text) => buildEmbedding(text, dimensions)),
+    };
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/memory/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/memory/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AASjC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAChE,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,IAAI,GAAG,kBAAkB;IAC7D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAG3C;IACC,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;IAC3D,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,kBAAkB,CAAC;IAE5D,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,KAAK;QACL,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC;QAC5D,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/memory/fs-utils.d.ts

@@ -0,0 +1,12 @@
+import type { Stats } from "node:fs";
+export type RegularFileStatResult = {
+    missing: true;
+} | {
+    missing: false;
+    stat: Stats;
+};
+export declare function isFileMissingError(err: unknown): err is NodeJS.ErrnoException & {
+    code: "ENOENT";
+};
+export declare function statRegularFile(absPath: string): Promise<RegularFileStatResult>;
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/memory/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/memory/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,MAAM,qBAAqB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAExF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,MAAM,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAOnD;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAcrF"}

package/dist/memory/fs-utils.js

@@ -0,0 +1,24 @@
+import fs from "node:fs/promises";
+export function isFileMissingError(err) {
+    return Boolean(err &&
+        typeof err === "object" &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+export async function statRegularFile(absPath) {
+    let stat;
+    try {
+        stat = await fs.lstat(absPath);
+    }
+    catch (err) {
+        if (isFileMissingError(err)) {
+            return { missing: true };
+        }
+        throw err;
+    }
+    if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error("path required");
+    }
+    return { missing: false, stat };
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/memory/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/memory/fs-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIlC,MAAM,UAAU,kBAAkB,CAChC,GAAY;IAEZ,OAAO,OAAO,CACZ,GAAG;QACD,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACZ,GAAsC,CAAC,IAAI,KAAK,QAAQ,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,IAAI,IAAW,CAAC;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/memory/hybrid.d.ts

@@ -0,0 +1,43 @@
+import { type MMRConfig, DEFAULT_MMR_CONFIG } from "./mmr.js";
+import { type TemporalDecayConfig, DEFAULT_TEMPORAL_DECAY_CONFIG } from "./temporal-decay.js";
+export type HybridSource = string;
+export { type MMRConfig, DEFAULT_MMR_CONFIG };
+export { type TemporalDecayConfig, DEFAULT_TEMPORAL_DECAY_CONFIG };
+export type HybridVectorResult = {
+    id: string;
+    path: string;
+    startLine: number;
+    endLine: number;
+    source: HybridSource;
+    snippet: string;
+    vectorScore: number;
+};
+export type HybridKeywordResult = {
+    id: string;
+    path: string;
+    startLine: number;
+    endLine: number;
+    source: HybridSource;
+    snippet: string;
+    textScore: number;
+};
+export declare function buildFtsQuery(raw: string): string | null;
+export declare function bm25RankToScore(rank: number): number;
+export declare function mergeHybridResults(params: {
+    vector: HybridVectorResult[];
+    keyword: HybridKeywordResult[];
+    vectorWeight: number;
+    textWeight: number;
+    memoryRoot?: string;
+    mmr?: Partial<MMRConfig>;
+    temporalDecay?: Partial<TemporalDecayConfig>;
+    nowMs?: number;
+}): Promise<Array<{
+    path: string;
+    startLine: number;
+    endLine: number;
+    score: number;
+    snippet: string;
+    source: HybridSource;
+}>>;
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/memory/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../src/memory/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAEL,KAAK,mBAAmB,EACxB,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,OAAO,EAAE,KAAK,SAAS,EAAE,kBAAkB,EAAE,CAAC;AAC9C,OAAO,EAAE,KAAK,mBAAmB,EAAE,6BAA6B,EAAE,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CACT,KAAK,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC,CACH,CA4EA"}

package/dist/memory/hybrid.js

@@ -0,0 +1,80 @@
+import { applyMMRToHybridResults, DEFAULT_MMR_CONFIG } from "./mmr.js";
+import { applyTemporalDecayToHybridResults, DEFAULT_TEMPORAL_DECAY_CONFIG, } from "./temporal-decay.js";
+export { DEFAULT_MMR_CONFIG };
+export { DEFAULT_TEMPORAL_DECAY_CONFIG };
+export function buildFtsQuery(raw) {
+    const tokens = raw
+        .match(/[\p{L}\p{N}_]+/gu)
+        ?.map((t) => t.trim())
+        .filter(Boolean) ?? [];
+    if (tokens.length === 0) {
+        return null;
+    }
+    const quoted = tokens.map((t) => `"${t.replaceAll('"', "")}"`);
+    return quoted.join(" AND ");
+}
+export function bm25RankToScore(rank) {
+    const normalized = Number.isFinite(rank) ? Math.max(0, rank) : 999;
+    return 1 / (1 + normalized);
+}
+export async function mergeHybridResults(params) {
+    const byId = new Map();
+    for (const r of params.vector) {
+        byId.set(r.id, {
+            id: r.id,
+            path: r.path,
+            startLine: r.startLine,
+            endLine: r.endLine,
+            source: r.source,
+            snippet: r.snippet,
+            vectorScore: r.vectorScore,
+            textScore: 0,
+        });
+    }
+    for (const r of params.keyword) {
+        const existing = byId.get(r.id);
+        if (existing) {
+            existing.textScore = r.textScore;
+            if (r.snippet && r.snippet.length > 0) {
+                existing.snippet = r.snippet;
+            }
+        }
+        else {
+            byId.set(r.id, {
+                id: r.id,
+                path: r.path,
+                startLine: r.startLine,
+                endLine: r.endLine,
+                source: r.source,
+                snippet: r.snippet,
+                vectorScore: 0,
+                textScore: r.textScore,
+            });
+        }
+    }
+    const merged = Array.from(byId.values()).map((entry) => {
+        const score = params.vectorWeight * entry.vectorScore + params.textWeight * entry.textScore;
+        return {
+            path: entry.path,
+            startLine: entry.startLine,
+            endLine: entry.endLine,
+            score,
+            snippet: entry.snippet,
+            source: entry.source,
+        };
+    });
+    const temporalDecayConfig = { ...DEFAULT_TEMPORAL_DECAY_CONFIG, ...params.temporalDecay };
+    const decayed = await applyTemporalDecayToHybridResults({
+        results: merged,
+        temporalDecay: temporalDecayConfig,
+        memoryRoot: params.memoryRoot,
+        nowMs: params.nowMs,
+    });
+    const sorted = decayed.slice().sort((a, b) => b.score - a.score);
+    const mmrConfig = { ...DEFAULT_MMR_CONFIG, ...params.mmr };
+    if (mmrConfig.enabled) {
+        return applyMMRToHybridResults(sorted, mmrConfig);
+    }
+    return sorted;
+}
+//# sourceMappingURL=hybrid.js.map

package/dist/memory/hybrid.js.map

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

package/dist/memory/internal.d.ts

@@ -0,0 +1,28 @@
+export type MemoryFileEntry = {
+    path: string;
+    absPath: string;
+    mtimeMs: number;
+    size: number;
+    hash: string;
+};
+export type MemoryChunk = {
+    startLine: number;
+    endLine: number;
+    text: string;
+    hash: string;
+};
+export declare function ensureDir(dir: string): string;
+export declare function normalizeRelPath(value: string): string;
+export declare function isMemoryPath(relPath: string): boolean;
+export declare function listMemoryFiles(memoryRoot: string): Promise<string[]>;
+export declare function hashText(value: string): string;
+export declare function buildFileEntry(absPath: string, memoryRoot: string): Promise<MemoryFileEntry | null>;
+export declare function chunkMarkdown(content: string, chunking: {
+    tokens: number;
+    overlap: number;
+}): MemoryChunk[];
+export declare function remapChunkLines(chunks: MemoryChunk[], lineMap: number[] | undefined): void;
+export declare function parseEmbedding(raw: string): number[];
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export declare function runWithConcurrency<T>(tasks: Array<() => Promise<T>>, limit: number): Promise<T[]>;
+//# sourceMappingURL=internal.d.ts.map

package/dist/memory/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/memory/internal.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CASrD;AAuBD,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6C3E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA2BjC;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,WAAW,EAAE,CA8Ef;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAQ1F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBjE;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,EAAE,CAAC,CA8Bd"}