convex-agent-knowledge 0.0.1

package/dist/component/schema.js

@@ -0,0 +1,140 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+const sourceValidator = v.object({
+    type: v.string(),
+    id: v.optional(v.string()),
+    url: v.optional(v.string()),
+    title: v.optional(v.string()),
+});
+const memoryStatus = v.union(v.literal("active"), v.literal("deleted"), v.literal("pending"));
+const syncStatus = v.union(v.literal("pending"), v.literal("running"), v.literal("succeeded"), v.literal("failed"));
+const vectorRowFields = {
+    namespace: v.string(),
+    memoryId: v.id("memories"),
+    chunkId: v.id("chunks"),
+    agentId: v.string(),
+    kind: v.string(),
+    embedding: v.array(v.float64()),
+};
+function vectorTable(dimensions) {
+    return defineTable(vectorRowFields)
+        .index("by_memory", ["memoryId"])
+        .index("by_chunk", ["chunkId"])
+        .vectorIndex("by_embedding", {
+        vectorField: "embedding",
+        dimensions,
+        filterFields: ["namespace", "agentId", "kind"],
+    });
+}
+export default defineSchema({
+    namespaces: defineTable({
+        namespace: v.string(),
+        metadata: v.optional(v.any()),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    }).index("by_namespace", ["namespace"]),
+    memories: defineTable({
+        namespace: v.string(),
+        key: v.optional(v.string()),
+        agentId: v.optional(v.string()),
+        text: v.string(),
+        contentHash: v.string(),
+        source: v.optional(sourceValidator),
+        metadata: v.optional(v.any()),
+        status: memoryStatus,
+        importance: v.number(),
+        observationScore: v.number(),
+        embeddingDimension: v.number(),
+        chunkCount: v.number(),
+        entityCount: v.number(),
+        relationshipCount: v.number(),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+        deletedAt: v.optional(v.number()),
+    })
+        .index("by_namespace", ["namespace"])
+        .index("by_namespace_key", ["namespace", "key"])
+        .index("by_namespace_hash", ["namespace", "contentHash"])
+        .index("by_agent", ["namespace", "agentId"]),
+    chunks: defineTable({
+        namespace: v.string(),
+        memoryId: v.id("memories"),
+        agentId: v.optional(v.string()),
+        order: v.number(),
+        text: v.string(),
+        summary: v.optional(v.string()),
+        tokenCount: v.optional(v.number()),
+        metadata: v.optional(v.any()),
+        createdAt: v.number(),
+    })
+        .index("by_memory", ["memoryId", "order"])
+        .index("by_namespace", ["namespace"]),
+    entities: defineTable({
+        namespace: v.string(),
+        memoryId: v.id("memories"),
+        chunkId: v.optional(v.id("chunks")),
+        externalId: v.string(),
+        name: v.string(),
+        type: v.string(),
+        description: v.optional(v.string()),
+        aliases: v.optional(v.array(v.string())),
+        confidence: v.number(),
+        metadata: v.optional(v.any()),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_memory", ["memoryId"])
+        .index("by_namespace_name", ["namespace", "name"])
+        .index("by_external_id", ["namespace", "externalId"]),
+    relationships: defineTable({
+        namespace: v.string(),
+        memoryId: v.id("memories"),
+        fromEntityExternalId: v.string(),
+        toEntityExternalId: v.string(),
+        type: v.string(),
+        description: v.optional(v.string()),
+        confidence: v.number(),
+        weight: v.number(),
+        metadata: v.optional(v.any()),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_memory", ["memoryId"])
+        .index("by_from", ["namespace", "fromEntityExternalId"])
+        .index("by_to", ["namespace", "toEntityExternalId"]),
+    observations: defineTable({
+        namespace: v.string(),
+        memoryId: v.id("memories"),
+        query: v.string(),
+        outcome: v.union(v.literal("helpful"), v.literal("not_helpful"), v.literal("neutral")),
+        feedback: v.optional(v.string()),
+        metadata: v.optional(v.any()),
+        createdAt: v.number(),
+    })
+        .index("by_memory", ["memoryId"])
+        .index("by_namespace", ["namespace"]),
+    graphSyncJobs: defineTable({
+        namespace: v.string(),
+        memoryId: v.optional(v.id("memories")),
+        operation: v.union(v.literal("upsert_memory"), v.literal("delete_memory"), v.literal("promote_memory")),
+        status: syncStatus,
+        attempts: v.number(),
+        payload: v.any(),
+        lastError: v.optional(v.string()),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_status", ["status", "createdAt"])
+        .index("by_memory", ["memoryId"]),
+    vectors_128: vectorTable(128),
+    vectors_256: vectorTable(256),
+    vectors_384: vectorTable(384),
+    vectors_512: vectorTable(512),
+    vectors_768: vectorTable(768),
+    vectors_1024: vectorTable(1024),
+    vectors_1536: vectorTable(1536),
+    vectors_2048: vectorTable(2048),
+    vectors_3072: vectorTable(3072),
+    vectors_4096: vectorTable(4096),
+});
+//# sourceMappingURL=schema.js.map

package/dist/component/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAE9F,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CACxB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EACtB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CACpB,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAChC,CAAC;AAEF,SAAS,WAAW,CAAC,UAAkB;IACrC,OAAO,WAAW,CAAC,eAAe,CAAC;SAChC,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;SAChC,KAAK,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;SAC9B,WAAW,CAAC,cAAc,EAAE;QAC3B,WAAW,EAAE,WAAW;QACxB,UAAU;QACV,YAAY,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC;KAC/C,CAAC,CAAC;AACP,CAAC;AAED,eAAe,YAAY,CAAC;IAC1B,UAAU,EAAE,WAAW,CAAC;QACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;IAEvC,QAAQ,EAAE,WAAW,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;QACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC5B,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAClC,CAAC;SACC,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;SACpC,KAAK,CAAC,kBAAkB,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;SAC/C,KAAK,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;SACxD,KAAK,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE9C,MAAM,EAAE,WAAW,CAAC;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;SACzC,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;IAEvC,QAAQ,EAAE,WAAW,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;SAChC,KAAK,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;SACjD,KAAK,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEvD,aAAa,EAAE,WAAW,CAAC;QACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;QAC1B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;QAChC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;SAChC,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;SACvD,KAAK,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAEtD,YAAY,EAAE,WAAW,CAAC;QACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;QAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtF,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;SAChC,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;IAEvC,aAAa,EAAE,WAAW,CAAC;QACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QACtC,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,EAC1B,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,EAC1B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAC5B;QACD,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;QAChB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;SAC3C,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;IAEnC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;IAC7B,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC;CAChC,CAAC,CAAC"}

package/dist/component/validators.d.ts

@@ -0,0 +1,158 @@
+export declare const supportedEmbeddingDimensions: readonly [128, 256, 384, 512, 768, 1024, 1536, 2048, 3072, 4096];
+export type SupportedEmbeddingDimension = (typeof supportedEmbeddingDimensions)[number];
+export declare const sourceValidator: import("convex/values").VObject<{
+    id?: string;
+    url?: string;
+    title?: string;
+    type: string;
+}, {
+    type: import("convex/values").VString<string, "required">;
+    id: import("convex/values").VString<string | undefined, "optional">;
+    url: import("convex/values").VString<string | undefined, "optional">;
+    title: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "type" | "id" | "url" | "title">;
+export declare const entityInputValidator: import("convex/values").VObject<{
+    description?: string;
+    aliases?: string[];
+    confidence?: number;
+    metadata?: any;
+    name: string;
+    type: string;
+    externalId: string;
+}, {
+    externalId: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string, "required">;
+    type: import("convex/values").VString<string, "required">;
+    description: import("convex/values").VString<string | undefined, "optional">;
+    aliases: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    confidence: import("convex/values").VFloat64<number | undefined, "optional">;
+    metadata: import("convex/values").VAny<any, "optional", string>;
+}, "required", "name" | "type" | "description" | "aliases" | "confidence" | "metadata" | `metadata.${string}` | "externalId">;
+export declare const relationshipInputValidator: import("convex/values").VObject<{
+    description?: string;
+    confidence?: number;
+    weight?: number;
+    metadata?: any;
+    type: string;
+    fromEntityExternalId: string;
+    toEntityExternalId: string;
+}, {
+    fromEntityExternalId: import("convex/values").VString<string, "required">;
+    toEntityExternalId: import("convex/values").VString<string, "required">;
+    type: import("convex/values").VString<string, "required">;
+    description: import("convex/values").VString<string | undefined, "optional">;
+    confidence: import("convex/values").VFloat64<number | undefined, "optional">;
+    weight: import("convex/values").VFloat64<number | undefined, "optional">;
+    metadata: import("convex/values").VAny<any, "optional", string>;
+}, "required", "type" | "description" | "confidence" | "weight" | "fromEntityExternalId" | "toEntityExternalId" | "metadata" | `metadata.${string}`>;
+export declare const chunkInputValidator: import("convex/values").VObject<{
+    metadata?: any;
+    summary?: string;
+    tokenCount?: number;
+    text: string;
+    embedding: number[];
+}, {
+    text: import("convex/values").VString<string, "required">;
+    embedding: import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">;
+    summary: import("convex/values").VString<string | undefined, "optional">;
+    tokenCount: import("convex/values").VFloat64<number | undefined, "optional">;
+    metadata: import("convex/values").VAny<any, "optional", string>;
+}, "required", "metadata" | "text" | "embedding" | `metadata.${string}` | "summary" | "tokenCount">;
+export declare const memoryCardValidator: import("convex/values").VObject<{
+    key?: string;
+    agentId?: string;
+    source?: {
+        id?: string;
+        url?: string;
+        title?: string;
+        type: string;
+    };
+    metadata?: any;
+    semanticScore?: number;
+    graphScore?: number;
+    entities: {
+        description?: string;
+        name: string;
+        type: string;
+        confidence: number;
+        externalId: string;
+    }[];
+    relationships: {
+        description?: string;
+        type: string;
+        confidence: number;
+        weight: number;
+        fromEntityExternalId: string;
+        toEntityExternalId: string;
+    }[];
+    importance: number;
+    text: string;
+    namespace: string;
+    memoryId: string;
+    score: number;
+}, {
+    memoryId: import("convex/values").VString<string, "required">;
+    namespace: import("convex/values").VString<string, "required">;
+    key: import("convex/values").VString<string | undefined, "optional">;
+    agentId: import("convex/values").VString<string | undefined, "optional">;
+    text: import("convex/values").VString<string, "required">;
+    score: import("convex/values").VFloat64<number, "required">;
+    semanticScore: import("convex/values").VFloat64<number | undefined, "optional">;
+    graphScore: import("convex/values").VFloat64<number | undefined, "optional">;
+    importance: import("convex/values").VFloat64<number, "required">;
+    source: import("convex/values").VObject<{
+        id?: string;
+        url?: string;
+        title?: string;
+        type: string;
+    } | undefined, {
+        type: import("convex/values").VString<string, "required">;
+        id: import("convex/values").VString<string | undefined, "optional">;
+        url: import("convex/values").VString<string | undefined, "optional">;
+        title: import("convex/values").VString<string | undefined, "optional">;
+    }, "optional", "type" | "id" | "url" | "title">;
+    metadata: import("convex/values").VAny<any, "optional", string>;
+    entities: import("convex/values").VArray<{
+        description?: string;
+        name: string;
+        type: string;
+        confidence: number;
+        externalId: string;
+    }[], import("convex/values").VObject<{
+        description?: string;
+        name: string;
+        type: string;
+        confidence: number;
+        externalId: string;
+    }, {
+        externalId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        type: import("convex/values").VString<string, "required">;
+        description: import("convex/values").VString<string | undefined, "optional">;
+        confidence: import("convex/values").VFloat64<number, "required">;
+    }, "required", "name" | "type" | "description" | "confidence" | "externalId">, "required">;
+    relationships: import("convex/values").VArray<{
+        description?: string;
+        type: string;
+        confidence: number;
+        weight: number;
+        fromEntityExternalId: string;
+        toEntityExternalId: string;
+    }[], import("convex/values").VObject<{
+        description?: string;
+        type: string;
+        confidence: number;
+        weight: number;
+        fromEntityExternalId: string;
+        toEntityExternalId: string;
+    }, {
+        fromEntityExternalId: import("convex/values").VString<string, "required">;
+        toEntityExternalId: import("convex/values").VString<string, "required">;
+        type: import("convex/values").VString<string, "required">;
+        description: import("convex/values").VString<string | undefined, "optional">;
+        confidence: import("convex/values").VFloat64<number, "required">;
+        weight: import("convex/values").VFloat64<number, "required">;
+    }, "required", "type" | "description" | "confidence" | "weight" | "fromEntityExternalId" | "toEntityExternalId">, "required">;
+}, "required", "entities" | "relationships" | "key" | "agentId" | "source" | "metadata" | "importance" | "text" | "namespace" | "memoryId" | `metadata.${string}` | "source.type" | "source.id" | "source.url" | "source.title" | "score" | "semanticScore" | "graphScore">;
+export declare function vectorTableForDimension(dimension: number): "vectors_128" | "vectors_256" | "vectors_384" | "vectors_512" | "vectors_768" | "vectors_1024" | "vectors_1536" | "vectors_2048" | "vectors_3072" | "vectors_4096";
+//# sourceMappingURL=validators.d.ts.map

package/dist/component/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/component/validators.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,4BAA4B,kEAE/B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,eAAO,MAAM,eAAe;;;;;;;;;;+CAK1B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;6HAQ/B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;oJAQrC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;mGAM9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2QA+B9B,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,sKA2BxD"}

package/dist/component/validators.js

@@ -0,0 +1,90 @@
+import { v } from "convex/values";
+export const supportedEmbeddingDimensions = [
+    128, 256, 384, 512, 768, 1024, 1536, 2048, 3072, 4096,
+];
+export const sourceValidator = v.object({
+    type: v.string(),
+    id: v.optional(v.string()),
+    url: v.optional(v.string()),
+    title: v.optional(v.string()),
+});
+export const entityInputValidator = v.object({
+    externalId: v.string(),
+    name: v.string(),
+    type: v.string(),
+    description: v.optional(v.string()),
+    aliases: v.optional(v.array(v.string())),
+    confidence: v.optional(v.number()),
+    metadata: v.optional(v.any()),
+});
+export const relationshipInputValidator = v.object({
+    fromEntityExternalId: v.string(),
+    toEntityExternalId: v.string(),
+    type: v.string(),
+    description: v.optional(v.string()),
+    confidence: v.optional(v.number()),
+    weight: v.optional(v.number()),
+    metadata: v.optional(v.any()),
+});
+export const chunkInputValidator = v.object({
+    text: v.string(),
+    embedding: v.array(v.float64()),
+    summary: v.optional(v.string()),
+    tokenCount: v.optional(v.number()),
+    metadata: v.optional(v.any()),
+});
+export const memoryCardValidator = v.object({
+    memoryId: v.string(),
+    namespace: v.string(),
+    key: v.optional(v.string()),
+    agentId: v.optional(v.string()),
+    text: v.string(),
+    score: v.number(),
+    semanticScore: v.optional(v.number()),
+    graphScore: v.optional(v.number()),
+    importance: v.number(),
+    source: v.optional(sourceValidator),
+    metadata: v.optional(v.any()),
+    entities: v.array(v.object({
+        externalId: v.string(),
+        name: v.string(),
+        type: v.string(),
+        description: v.optional(v.string()),
+        confidence: v.number(),
+    })),
+    relationships: v.array(v.object({
+        fromEntityExternalId: v.string(),
+        toEntityExternalId: v.string(),
+        type: v.string(),
+        description: v.optional(v.string()),
+        confidence: v.number(),
+        weight: v.number(),
+    })),
+});
+export function vectorTableForDimension(dimension) {
+    switch (dimension) {
+        case 128:
+            return "vectors_128";
+        case 256:
+            return "vectors_256";
+        case 384:
+            return "vectors_384";
+        case 512:
+            return "vectors_512";
+        case 768:
+            return "vectors_768";
+        case 1024:
+            return "vectors_1024";
+        case 1536:
+            return "vectors_1536";
+        case 2048:
+            return "vectors_2048";
+        case 3072:
+            return "vectors_3072";
+        case 4096:
+            return "vectors_4096";
+        default:
+            throw new Error(`Unsupported embedding dimension ${dimension}. Supported dimensions: ${supportedEmbeddingDimensions.join(", ")}`);
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/component/validators.js.map

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

package/dist/node/index.d.ts

@@ -0,0 +1,3 @@
+export { createNeo4jGraphStore } from "./neo4j.js";
+export type { Neo4jGraphStoreOptions } from "./neo4j.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/node/index.js

@@ -0,0 +1,2 @@
+export { createNeo4jGraphStore } from "./neo4j.js";
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/node/neo4j.d.ts

@@ -0,0 +1,5 @@
+import type { GraphStore, GraphSyncJob, Neo4jConfig } from "../client/types.js";
+export type Neo4jGraphStoreOptions = Neo4jConfig;
+export declare function createNeo4jGraphStore(options: Neo4jGraphStoreOptions): GraphStore;
+export type { GraphStore, GraphSyncJob };
+//# sourceMappingURL=neo4j.d.ts.map

package/dist/node/neo4j.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.d.ts","sourceRoot":"","sources":["../../src/node/neo4j.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAmBjF;AAmLD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC"}

package/dist/node/neo4j.js

@@ -0,0 +1,147 @@
+import neo4j from "neo4j-driver";
+export function createNeo4jGraphStore(options) {
+    return {
+        async syncJob(job) {
+            await withNeo4j(options, async (session) => {
+                if (job.operation === "upsert_memory") {
+                    await upsertMemoryGraph(session, job.payload);
+                }
+                else if (job.operation === "delete_memory") {
+                    await deleteMemoryGraph(session, job.payload);
+                }
+                else if (job.operation === "promote_memory") {
+                    await promoteMemoryGraph(session, job.payload);
+                }
+                else {
+                    throw new Error(`Unsupported graph sync operation ${job.operation}`);
+                }
+            });
+        },
+        async expand(input) {
+            return await expandGraph(options, input);
+        },
+    };
+}
+async function withNeo4j(config, fn) {
+    const driver = neo4j.driver(config.uri, neo4j.auth.basic(config.user, config.password));
+    const session = driver.session(config.database ? { database: config.database } : undefined);
+    try {
+        return await fn(session);
+    }
+    finally {
+        await session.close();
+        await driver.close();
+    }
+}
+async function upsertMemoryGraph(session, payload) {
+    const graphPayload = payload;
+    await session.executeWrite((tx) => tx.run(`
+      MERGE (m:Memory {id: $memory.id})
+      SET m.namespace = $memory.namespace,
+          m.key = $memory.key,
+          m.agentId = $memory.agentId,
+          m.text = $memory.text,
+          m.importance = $memory.importance,
+          m.updatedAt = timestamp()
+      WITH m
+      UNWIND $entities AS entity
+      MERGE (e:Entity {id: entity.externalId})
+      SET e.namespace = $memory.namespace,
+          e.name = entity.name,
+          e.type = entity.type,
+          e.description = entity.description,
+          e.confidence = coalesce(entity.confidence, 0.75),
+          e.updatedAt = timestamp()
+      MERGE (m)-[mention:MENTIONS]->(e)
+      SET mention.namespace = $memory.namespace,
+          mention.updatedAt = timestamp()
+      `, {
+        memory: graphPayload.memory,
+        entities: graphPayload.entities ?? [],
+    }));
+    await session.executeWrite((tx) => tx.run(`
+      UNWIND $relationships AS relationship
+      MATCH (from:Entity {id: relationship.fromEntityExternalId})
+      MATCH (to:Entity {id: relationship.toEntityExternalId})
+      MERGE (from)-[r:RELATED {namespace: $namespace, type: relationship.type}]->(to)
+      SET r.description = relationship.description,
+          r.confidence = coalesce(relationship.confidence, 0.75),
+          r.weight = coalesce(relationship.weight, 0.5),
+          r.memoryId = $memoryId,
+          r.updatedAt = timestamp()
+      `, {
+        namespace: graphPayload.memory.namespace,
+        memoryId: graphPayload.memory.id,
+        relationships: graphPayload.relationships ?? [],
+    }));
+}
+async function deleteMemoryGraph(session, payload) {
+    const graphPayload = payload;
+    await session.executeWrite((tx) => tx.run(`
+      MATCH (m:Memory {id: $memoryId, namespace: $namespace})
+      DETACH DELETE m
+      `, graphPayload));
+}
+async function promoteMemoryGraph(session, payload) {
+    const graphPayload = payload;
+    await session.executeWrite((tx) => tx.run(`
+      MATCH (m:Memory {id: $memoryId, namespace: $namespace})
+      SET m.importance = $importance,
+          m.observationScore = $observationScore,
+          m.updatedAt = timestamp()
+      `, graphPayload));
+}
+async function expandGraph(config, input) {
+    const seedMemoryIds = input.seedMemoryIds;
+    const entityHints = input.entityHints ?? [];
+    if (seedMemoryIds.length === 0 && entityHints.length === 0) {
+        return [];
+    }
+    const safeHops = Math.min(Math.max(Math.trunc(input.hops ?? 2), 1), 4);
+    const limit = Math.min(Math.max(input.limit ?? 32, 1), 128);
+    return await withNeo4j(config, async (session) => {
+        const result = seedMemoryIds.length > 0
+            ? await session.executeRead((tx) => tx.run(`
+              MATCH (seed:Memory {namespace: $namespace})
+              WHERE seed.id IN $seedMemoryIds
+              MATCH path = (seed)-[:MENTIONS]->(:Entity)-[:RELATED*1..${safeHops}]-(:Entity)<-[:MENTIONS]-(related:Memory {namespace: $namespace})
+              WHERE NOT related.id IN $seedMemoryIds
+              RETURN related.id AS memoryId, count(path) AS graphScore
+              ORDER BY graphScore DESC
+              LIMIT $limit
+              `, {
+                namespace: input.namespace,
+                seedMemoryIds,
+                limit: neo4j.int(limit),
+            }))
+            : await session.executeRead((tx) => tx.run(`
+              MATCH (seed:Entity {namespace: $namespace})
+              WHERE toLower(seed.name) IN $entityHints
+              MATCH path = (seed)-[:RELATED*0..${safeHops}]-(:Entity)<-[:MENTIONS]-(related:Memory {namespace: $namespace})
+              RETURN related.id AS memoryId, count(path) AS graphScore
+              ORDER BY graphScore DESC
+              LIMIT $limit
+              `, {
+                namespace: input.namespace,
+                entityHints: entityHints.map((hint) => hint.toLowerCase()),
+                limit: neo4j.int(limit),
+            }));
+        return result.records.map((record) => ({
+            memoryId: record.get("memoryId"),
+            graphScore: toNumber(record.get("graphScore")),
+        }));
+    });
+}
+function toNumber(value) {
+    if (typeof value === "number") {
+        return value;
+    }
+    if (value &&
+        typeof value === "object" &&
+        "toNumber" in value &&
+        typeof value.toNumber === "function") {
+        return value.toNumber();
+    }
+    return Number(value);
+}
+//# sourceMappingURL=neo4j.js.map

package/dist/node/neo4j.js.map

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

package/dist/shared/ranking.d.ts

@@ -0,0 +1,17 @@
+export type RankedMemoryCard = {
+    memoryId: string;
+    score: number;
+    semanticScore?: number;
+    graphScore?: number;
+    importance?: number;
+};
+export declare function clamp(value: number, min?: number, max?: number): number;
+export declare function fuseMemoryScores<T extends RankedMemoryCard>(semanticCards: T[], graphCards: T[], options?: {
+    semanticWeight?: number;
+    graphWeight?: number;
+    importanceWeight?: number;
+    limit?: number;
+}): (T & {
+    score: number;
+})[];
+//# sourceMappingURL=ranking.d.ts.map

package/dist/shared/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../../src/shared/ranking.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,GAAG,SAAI,UAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,aAAa,EAAE,CAAC,EAAE,EAClB,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;KA2CF"}