convex-agent-knowledge 0.0.1

package/dist/client/index.js

@@ -0,0 +1,194 @@
+import { embed, embedMany } from "ai";
+import { chunkText } from "./chunking.js";
+import { extractKnowledge } from "./extraction.js";
+import { stableHash } from "./hash.js";
+import { fuseMemoryScores } from "../shared/ranking.js";
+export class AgentKnowledge {
+    component;
+    options;
+    constructor(component, options) {
+        this.component = component;
+        this.options = options;
+    }
+    async remember(ctx, input) {
+        const chunks = input.chunks ?? chunkText(input.text, this.options.chunking);
+        if (chunks.length === 0) {
+            throw new Error("Cannot remember empty text");
+        }
+        const embeddedChunks = await this.embedChunks(chunks);
+        const extracted = input.extracted ??
+            (this.options.extract
+                ? await this.options.extract({
+                    namespace: input.namespace,
+                    text: input.text,
+                    chunks,
+                })
+                : await extractKnowledge({
+                    namespace: input.namespace,
+                    text: input.text,
+                    model: this.options.extractionModel,
+                }));
+        const mutationArgs = {
+            namespace: input.namespace,
+            ...(input.key === undefined ? {} : { key: input.key }),
+            ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+            text: input.text,
+            contentHash: stableHash(`${input.namespace}:${input.text}`),
+            ...(input.source === undefined ? {} : { source: input.source }),
+            ...(input.metadata === undefined ? {} : { metadata: input.metadata }),
+            ...(input.importance === undefined ? {} : { importance: input.importance }),
+            embeddingDimension: this.options.embeddingDimension,
+            chunks: embeddedChunks,
+            entities: extracted.entities,
+            relationships: extracted.relationships,
+        };
+        const result = await ctx.runMutation(this.component.mutations.remember, mutationArgs);
+        if (this.options.graph) {
+            await this.syncGraph(ctx, { limit: 10 });
+        }
+        return result;
+    }
+    async recall(ctx, input) {
+        const searchType = input.searchType ?? "hybrid";
+        const limit = input.limit ?? 10;
+        const queryEmbedding = input.queryEmbedding ??
+            (searchType === "graph" ? undefined : await this.embedQuery(input.query));
+        const semanticResult = searchType === "graph"
+            ? { results: [] }
+            : (await ctx.runAction(this.component.actions.recall, {
+                namespace: input.namespace,
+                query: input.query,
+                ...(queryEmbedding === undefined ? {} : { queryEmbedding }),
+                embeddingDimension: this.options.embeddingDimension,
+                searchType,
+                limit,
+                ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+            }));
+        const graph = input.graph ?? this.options.graph;
+        if (!graph || searchType === "semantic") {
+            return semanticResult;
+        }
+        const graphScores = await graph.expand({
+            namespace: input.namespace,
+            seedMemoryIds: semanticResult.results.map((card) => card.memoryId),
+            hops: 2,
+            limit: Math.max(limit * 4, 16),
+            ...(input.entityHints === undefined ? {} : { entityHints: input.entityHints }),
+        });
+        const graphCards = graphScores.length === 0
+            ? []
+            : (await ctx.runQuery(this.component.queries.fetchMemoryCards, {
+                matches: graphScores.map((score) => ({
+                    memoryId: score.memoryId,
+                    score: score.graphScore,
+                    graphScore: score.graphScore,
+                })),
+            }));
+        return {
+            results: fuseMemoryScores(semanticResult.results, graphCards, { limit }),
+        };
+    }
+    async observe(ctx, input) {
+        return await ctx.runMutation(this.component.mutations.observe, {
+            namespace: input.namespace,
+            memoryId: input.memoryId,
+            query: input.query,
+            outcome: input.outcome,
+            ...(input.feedback === undefined ? {} : { feedback: input.feedback }),
+            ...(input.metadata === undefined ? {} : { metadata: input.metadata }),
+        });
+    }
+    async promote(ctx, input) {
+        return (await ctx.runMutation(this.component.mutations.promote, {
+            namespace: input.namespace,
+            ...(input.limit === undefined ? {} : { limit: input.limit }),
+        }));
+    }
+    async deleteByKey(ctx, input) {
+        return (await ctx.runMutation(this.component.mutations.deleteByKey, {
+            namespace: input.namespace,
+            key: input.key,
+        }));
+    }
+    async getMemory(ctx, input) {
+        return (await ctx.runQuery(this.component.queries.getMemory, {
+            memoryId: input.memoryId,
+        }));
+    }
+    async listMemories(ctx, input) {
+        return (await ctx.runQuery(this.component.queries.listMemories, {
+            namespace: input.namespace,
+            ...(input.limit === undefined ? {} : { limit: input.limit }),
+            ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+        }));
+    }
+    async syncGraph(ctx, input) {
+        const graph = input?.graph ?? this.options.graph;
+        if (!graph) {
+            return { succeeded: 0, failed: 0 };
+        }
+        const jobs = (await ctx.runQuery(this.component.queries.listPendingGraphSyncJobs, {
+            limit: input?.limit ?? 10,
+        }));
+        let succeeded = 0;
+        let failed = 0;
+        for (const job of jobs) {
+            await ctx.runMutation(this.component.mutations.markGraphSyncJobRunning, {
+                jobId: job.jobId,
+            });
+            try {
+                await graph.syncJob(job);
+                await ctx.runMutation(this.component.mutations.markGraphSyncJobSucceeded, {
+                    jobId: job.jobId,
+                });
+                succeeded += 1;
+            }
+            catch (error) {
+                await ctx.runMutation(this.component.mutations.markGraphSyncJobFailed, {
+                    jobId: job.jobId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                failed += 1;
+            }
+        }
+        return { succeeded, failed };
+    }
+    async embedChunks(chunks) {
+        if (!this.options.textEmbeddingModel) {
+            throw new Error("AgentKnowledge requires textEmbeddingModel to remember text");
+        }
+        const result = await embedMany({
+            model: this.options.textEmbeddingModel,
+            values: chunks.map((chunk) => chunk.text),
+        });
+        return chunks.map((chunk, index) => {
+            const embedding = result.embeddings[index];
+            if (!embedding) {
+                throw new Error(`Missing embedding for chunk ${index}`);
+            }
+            if (embedding.length !== this.options.embeddingDimension) {
+                throw new Error(`Embedding dimension ${embedding.length} does not match configured dimension ${this.options.embeddingDimension}`);
+            }
+            return {
+                ...chunk,
+                embedding,
+            };
+        });
+    }
+    async embedQuery(query) {
+        if (!this.options.textEmbeddingModel) {
+            throw new Error("AgentKnowledge requires textEmbeddingModel for semantic or hybrid recall");
+        }
+        const result = await embed({
+            model: this.options.textEmbeddingModel,
+            value: query,
+        });
+        if (result.embedding.length !== this.options.embeddingDimension) {
+            throw new Error(`Embedding dimension ${result.embedding.length} does not match configured dimension ${this.options.embeddingDimension}`);
+        }
+        return result.embedding;
+    }
+}
+export { chunkText } from "./chunking.js";
+export { extractKnowledge, heuristicExtractKnowledge } from "./extraction.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,126 @@
+export type SearchType = "semantic" | "graph" | "hybrid";
+export type MemorySource = {
+    type: string;
+    id?: string;
+    url?: string;
+    title?: string;
+};
+export type ExtractedEntity = {
+    externalId: string;
+    name: string;
+    type: string;
+    description?: string;
+    aliases?: string[];
+    confidence?: number;
+    metadata?: unknown;
+};
+export type ExtractedRelationship = {
+    fromEntityExternalId: string;
+    toEntityExternalId: string;
+    type: string;
+    description?: string;
+    confidence?: number;
+    weight?: number;
+    metadata?: unknown;
+};
+export type ExtractedKnowledge = {
+    entities: ExtractedEntity[];
+    relationships: ExtractedRelationship[];
+};
+export type ChunkInput = {
+    text: string;
+    summary?: string;
+    tokenCount?: number;
+    metadata?: unknown;
+};
+export type EmbeddedChunkInput = ChunkInput & {
+    embedding: number[];
+};
+export type Neo4jConfig = {
+    uri: string;
+    user: string;
+    password: string;
+    database?: string;
+};
+export type GraphSyncJob = {
+    jobId: string;
+    namespace: string;
+    operation: "upsert_memory" | "delete_memory" | "promote_memory";
+    attempts: number;
+    payload: unknown;
+};
+export type GraphMemoryScore = {
+    memoryId: string;
+    graphScore: number;
+};
+export type GraphExpandInput = {
+    namespace: string;
+    seedMemoryIds: string[];
+    entityHints?: string[];
+    hops?: number;
+    limit?: number;
+};
+export type GraphStore = {
+    syncJob: (job: GraphSyncJob) => Promise<void>;
+    expand: (input: GraphExpandInput) => Promise<GraphMemoryScore[]>;
+};
+export type MemoryCard = {
+    memoryId: string;
+    namespace: string;
+    key?: string;
+    agentId?: string;
+    text: string;
+    score: number;
+    semanticScore?: number;
+    graphScore?: number;
+    importance: number;
+    source?: MemorySource;
+    metadata?: unknown;
+    entities: Array<{
+        externalId: string;
+        name: string;
+        type: string;
+        description?: string;
+        confidence: number;
+    }>;
+    relationships: Array<{
+        fromEntityExternalId: string;
+        toEntityExternalId: string;
+        type: string;
+        description?: string;
+        confidence: number;
+        weight: number;
+    }>;
+};
+export type AgentKnowledgeComponent = {
+    actions: {
+        recall: unknown;
+    };
+    mutations: {
+        remember: unknown;
+        observe: unknown;
+        promote: unknown;
+        deleteByKey: unknown;
+        markGraphSyncJobRunning: unknown;
+        markGraphSyncJobSucceeded: unknown;
+        markGraphSyncJobFailed: unknown;
+    };
+    queries: {
+        getMemory: unknown;
+        listMemories: unknown;
+        fetchMemoryCards: unknown;
+        listPendingGraphSyncJobs: unknown;
+    };
+};
+export type ConvexActionCtx = {
+    runAction: (functionReference: unknown, args: Record<string, unknown>) => Promise<any>;
+    runMutation: (functionReference: unknown, args: Record<string, unknown>) => Promise<any>;
+    runQuery: (functionReference: unknown, args: Record<string, unknown>) => Promise<any>;
+};
+export type ConvexMutationCtx = {
+    runMutation: (functionReference: unknown, args: Record<string, unknown>) => Promise<any>;
+};
+export type ConvexQueryCtx = {
+    runQuery: (functionReference: unknown, args: Record<string, unknown>) => Promise<any>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

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

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/component/_generated/api.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type * as actions from "../actions.js";
+import type * as mutations from "../mutations.js";
+import type * as queries from "../queries.js";
+import type * as validators from "../validators.js";
+import type { ApiFromModules, FilterApi, FunctionReference } from "convex/server";
+declare const fullApi: ApiFromModules<{
+    actions: typeof actions;
+    mutations: typeof mutations;
+    queries: typeof queries;
+    validators: typeof validators;
+}>;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export declare const api: FilterApi<typeof fullApi, FunctionReference<any, "public">>;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export declare const internal: FilterApi<typeof fullApi, FunctionReference<any, "internal">>;
+export declare const components: {};
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/component/_generated/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,QAAA,MAAM,OAAO,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,UAAU,CAAC;CAC/B,CAAiB,CAAC;AAEnB;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,EAAE,SAAS,CACzB,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CACjB,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAC9B,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnB,CAAC;AAElB,eAAO,MAAM,UAAU,EAAqC,EAAE,CAAC"}

package/dist/component/_generated/api.js

@@ -0,0 +1,31 @@
+/* eslint-disable */
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import { anyApi, componentsGeneric } from "convex/server";
+const fullApi = anyApi;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export const api = anyApi;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export const internal = anyApi;
+export const components = componentsGeneric();
+//# sourceMappingURL=api.js.map

package/dist/component/_generated/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAYH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,OAAO,GAKR,MAAa,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAGZ,MAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAGjB,MAAa,CAAC;AAElB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAmB,CAAC"}