@waynesutton/agent-memory 0.0.1

package/dist/component/schema.d.ts

@@ -0,0 +1,278 @@
+export declare const memoryTypeValidator: import("convex/values").VUnion<"instruction" | "learning" | "reference" | "feedback" | "journal", [import("convex/values").VLiteral<"instruction", "required">, import("convex/values").VLiteral<"learning", "required">, import("convex/values").VLiteral<"reference", "required">, import("convex/values").VLiteral<"feedback", "required">, import("convex/values").VLiteral<"journal", "required">], "required", never>;
+export declare const scopeValidator: import("convex/values").VUnion<"project" | "user" | "org", [import("convex/values").VLiteral<"project", "required">, import("convex/values").VLiteral<"user", "required">, import("convex/values").VLiteral<"org", "required">], "required", never>;
+export declare const syncDirectionValidator: import("convex/values").VUnion<"push" | "pull", [import("convex/values").VLiteral<"push", "required">, import("convex/values").VLiteral<"pull", "required">], "required", never>;
+export declare const historyEventValidator: import("convex/values").VUnion<"created" | "updated" | "archived" | "restored" | "merged", [import("convex/values").VLiteral<"created", "required">, import("convex/values").VLiteral<"updated", "required">, import("convex/values").VLiteral<"archived", "required">, import("convex/values").VLiteral<"restored", "required">, import("convex/values").VLiteral<"merged", "required">], "required", never>;
+export declare const feedbackSentimentValidator: import("convex/values").VUnion<"positive" | "negative" | "very_negative", [import("convex/values").VLiteral<"positive", "required">, import("convex/values").VLiteral<"negative", "required">, import("convex/values").VLiteral<"very_negative", "required">], "required", never>;
+export declare const ingestEventValidator: import("convex/values").VUnion<"updated" | "added" | "deleted" | "skipped", [import("convex/values").VLiteral<"added", "required">, import("convex/values").VLiteral<"updated", "required">, import("convex/values").VLiteral<"deleted", "required">, import("convex/values").VLiteral<"skipped", "required">], "required", never>;
+declare const _default: import("convex/server").SchemaDefinition<{
+    memories: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        userId?: string | undefined;
+        agentId?: string | undefined;
+        sessionId?: string | undefined;
+        paths?: string[] | undefined;
+        priority?: number | undefined;
+        source?: string | undefined;
+        lastSyncedAt?: number | undefined;
+        embeddingId?: import("convex/values").GenericId<"embeddings"> | undefined;
+        accessCount?: number | undefined;
+        lastAccessedAt?: number | undefined;
+        positiveCount?: number | undefined;
+        negativeCount?: number | undefined;
+        archived: boolean;
+        scope: "project" | "user" | "org";
+        memoryType: "instruction" | "learning" | "reference" | "feedback" | "journal";
+        projectId: string;
+        title: string;
+        content: string;
+        tags: string[];
+        checksum: string;
+    }, {
+        projectId: import("convex/values").VString<string, "required">;
+        scope: import("convex/values").VUnion<"project" | "user" | "org", [import("convex/values").VLiteral<"project", "required">, import("convex/values").VLiteral<"user", "required">, import("convex/values").VLiteral<"org", "required">], "required", never>;
+        userId: import("convex/values").VString<string | undefined, "optional">;
+        agentId: import("convex/values").VString<string | undefined, "optional">;
+        sessionId: import("convex/values").VString<string | undefined, "optional">;
+        title: import("convex/values").VString<string, "required">;
+        content: import("convex/values").VString<string, "required">;
+        memoryType: import("convex/values").VUnion<"instruction" | "learning" | "reference" | "feedback" | "journal", [import("convex/values").VLiteral<"instruction", "required">, import("convex/values").VLiteral<"learning", "required">, import("convex/values").VLiteral<"reference", "required">, import("convex/values").VLiteral<"feedback", "required">, import("convex/values").VLiteral<"journal", "required">], "required", never>;
+        tags: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        paths: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+        priority: import("convex/values").VFloat64<number | undefined, "optional">;
+        source: import("convex/values").VString<string | undefined, "optional">;
+        lastSyncedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        checksum: import("convex/values").VString<string, "required">;
+        archived: import("convex/values").VBoolean<boolean, "required">;
+        embeddingId: import("convex/values").VId<import("convex/values").GenericId<"embeddings"> | undefined, "optional">;
+        accessCount: import("convex/values").VFloat64<number | undefined, "optional">;
+        lastAccessedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        positiveCount: import("convex/values").VFloat64<number | undefined, "optional">;
+        negativeCount: import("convex/values").VFloat64<number | undefined, "optional">;
+    }, "required", "archived" | "scope" | "memoryType" | "projectId" | "userId" | "agentId" | "sessionId" | "title" | "content" | "tags" | "paths" | "priority" | "source" | "lastSyncedAt" | "checksum" | "embeddingId" | "accessCount" | "lastAccessedAt" | "positiveCount" | "negativeCount">, {
+        by_project: ["projectId", "archived", "memoryType", "_creationTime"];
+        by_project_scope: ["projectId", "scope", "userId", "archived", "_creationTime"];
+        by_project_title: ["projectId", "title", "_creationTime"];
+        by_type_priority: ["projectId", "memoryType", "priority", "_creationTime"];
+        by_agent: ["projectId", "agentId", "archived", "_creationTime"];
+        by_session: ["projectId", "sessionId", "archived", "_creationTime"];
+        by_source: ["projectId", "source", "archived", "_creationTime"];
+        by_last_accessed: ["projectId", "lastAccessedAt", "_creationTime"];
+    }, {
+        search_content: {
+            searchField: "content";
+            filterFields: "archived" | "scope" | "memoryType" | "projectId";
+        };
+        search_title: {
+            searchField: "title";
+            filterFields: "memoryType" | "projectId";
+        };
+    }, {}>;
+    embeddings: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        memoryId: import("convex/values").GenericId<"memories">;
+        embedding: number[];
+        model: string;
+        dimensions: number;
+    }, {
+        memoryId: import("convex/values").VId<import("convex/values").GenericId<"memories">, "required">;
+        embedding: import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">;
+        model: import("convex/values").VString<string, "required">;
+        dimensions: import("convex/values").VFloat64<number, "required">;
+    }, "required", "memoryId" | "embedding" | "model" | "dimensions">, {
+        by_memory: ["memoryId", "_creationTime"];
+    }, {}, {
+        by_embedding: {
+            vectorField: "embedding";
+            dimensions: number;
+            filterFields: never;
+        };
+    }>;
+    projects: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        description?: string | undefined;
+        projectId: string;
+        name: string;
+        settings: {
+            embeddingModel?: string | undefined;
+            embeddingDimensions?: number | undefined;
+            factExtractionPrompt?: string | undefined;
+            updateDecisionPrompt?: string | undefined;
+            decayEnabled?: boolean | undefined;
+            decayHalfLifeDays?: number | undefined;
+            apiRateLimit?: {
+                requestsPerWindow: number;
+                windowMs: number;
+            } | undefined;
+            autoSync: boolean;
+            syncFormats: string[];
+        };
+    }, {
+        projectId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        description: import("convex/values").VString<string | undefined, "optional">;
+        settings: import("convex/values").VObject<{
+            embeddingModel?: string | undefined;
+            embeddingDimensions?: number | undefined;
+            factExtractionPrompt?: string | undefined;
+            updateDecisionPrompt?: string | undefined;
+            decayEnabled?: boolean | undefined;
+            decayHalfLifeDays?: number | undefined;
+            apiRateLimit?: {
+                requestsPerWindow: number;
+                windowMs: number;
+            } | undefined;
+            autoSync: boolean;
+            syncFormats: string[];
+        }, {
+            autoSync: import("convex/values").VBoolean<boolean, "required">;
+            syncFormats: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+            embeddingModel: import("convex/values").VString<string | undefined, "optional">;
+            embeddingDimensions: import("convex/values").VFloat64<number | undefined, "optional">;
+            factExtractionPrompt: import("convex/values").VString<string | undefined, "optional">;
+            updateDecisionPrompt: import("convex/values").VString<string | undefined, "optional">;
+            decayEnabled: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            decayHalfLifeDays: import("convex/values").VFloat64<number | undefined, "optional">;
+            apiRateLimit: import("convex/values").VObject<{
+                requestsPerWindow: number;
+                windowMs: number;
+            } | undefined, {
+                requestsPerWindow: import("convex/values").VFloat64<number, "required">;
+                windowMs: import("convex/values").VFloat64<number, "required">;
+            }, "optional", "requestsPerWindow" | "windowMs">;
+        }, "required", "autoSync" | "syncFormats" | "embeddingModel" | "embeddingDimensions" | "factExtractionPrompt" | "updateDecisionPrompt" | "decayEnabled" | "decayHalfLifeDays" | "apiRateLimit" | "apiRateLimit.requestsPerWindow" | "apiRateLimit.windowMs">;
+    }, "required", "projectId" | "name" | "description" | "settings" | "settings.autoSync" | "settings.syncFormats" | "settings.embeddingModel" | "settings.embeddingDimensions" | "settings.factExtractionPrompt" | "settings.updateDecisionPrompt" | "settings.decayEnabled" | "settings.decayHalfLifeDays" | "settings.apiRateLimit" | "settings.apiRateLimit.requestsPerWindow" | "settings.apiRateLimit.windowMs">, {
+        by_projectId: ["projectId", "_creationTime"];
+    }, {}, {}>;
+    syncLog: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        userId?: string | undefined;
+        projectId: string;
+        checksum: string;
+        memoryId: import("convex/values").GenericId<"memories">;
+        direction: "push" | "pull";
+        targetFormat: string;
+        targetPath: string;
+        syncedAt: number;
+    }, {
+        projectId: import("convex/values").VString<string, "required">;
+        userId: import("convex/values").VString<string | undefined, "optional">;
+        memoryId: import("convex/values").VId<import("convex/values").GenericId<"memories">, "required">;
+        targetFormat: import("convex/values").VString<string, "required">;
+        targetPath: import("convex/values").VString<string, "required">;
+        syncedAt: import("convex/values").VFloat64<number, "required">;
+        checksum: import("convex/values").VString<string, "required">;
+        direction: import("convex/values").VUnion<"push" | "pull", [import("convex/values").VLiteral<"push", "required">, import("convex/values").VLiteral<"pull", "required">], "required", never>;
+    }, "required", "projectId" | "userId" | "checksum" | "memoryId" | "direction" | "targetFormat" | "targetPath" | "syncedAt">, {
+        by_project_user: ["projectId", "userId", "syncedAt", "_creationTime"];
+    }, {}, {}>;
+    memoryHistory: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        previousContent?: string | undefined;
+        newContent?: string | undefined;
+        previousTitle?: string | undefined;
+        newTitle?: string | undefined;
+        projectId: string;
+        memoryId: import("convex/values").GenericId<"memories">;
+        event: "created" | "updated" | "archived" | "restored" | "merged";
+        actor: string;
+        timestamp: number;
+    }, {
+        memoryId: import("convex/values").VId<import("convex/values").GenericId<"memories">, "required">;
+        projectId: import("convex/values").VString<string, "required">;
+        previousContent: import("convex/values").VString<string | undefined, "optional">;
+        newContent: import("convex/values").VString<string | undefined, "optional">;
+        previousTitle: import("convex/values").VString<string | undefined, "optional">;
+        newTitle: import("convex/values").VString<string | undefined, "optional">;
+        event: import("convex/values").VUnion<"created" | "updated" | "archived" | "restored" | "merged", [import("convex/values").VLiteral<"created", "required">, import("convex/values").VLiteral<"updated", "required">, import("convex/values").VLiteral<"archived", "required">, import("convex/values").VLiteral<"restored", "required">, import("convex/values").VLiteral<"merged", "required">], "required", never>;
+        actor: import("convex/values").VString<string, "required">;
+        timestamp: import("convex/values").VFloat64<number, "required">;
+    }, "required", "projectId" | "memoryId" | "event" | "previousContent" | "newContent" | "previousTitle" | "newTitle" | "actor" | "timestamp">, {
+        by_memory: ["memoryId", "timestamp", "_creationTime"];
+        by_project: ["projectId", "timestamp", "_creationTime"];
+    }, {}, {}>;
+    memoryFeedback: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        comment?: string | undefined;
+        projectId: string;
+        memoryId: import("convex/values").GenericId<"memories">;
+        actor: string;
+        timestamp: number;
+        sentiment: "positive" | "negative" | "very_negative";
+    }, {
+        memoryId: import("convex/values").VId<import("convex/values").GenericId<"memories">, "required">;
+        projectId: import("convex/values").VString<string, "required">;
+        sentiment: import("convex/values").VUnion<"positive" | "negative" | "very_negative", [import("convex/values").VLiteral<"positive", "required">, import("convex/values").VLiteral<"negative", "required">, import("convex/values").VLiteral<"very_negative", "required">], "required", never>;
+        comment: import("convex/values").VString<string | undefined, "optional">;
+        actor: import("convex/values").VString<string, "required">;
+        timestamp: import("convex/values").VFloat64<number, "required">;
+    }, "required", "projectId" | "memoryId" | "actor" | "timestamp" | "sentiment" | "comment">, {
+        by_memory: ["memoryId", "timestamp", "_creationTime"];
+        by_project: ["projectId", "timestamp", "_creationTime"];
+    }, {}, {}>;
+    memoryRelations: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        metadata?: {
+            confidence?: number | undefined;
+            createdBy?: string | undefined;
+        } | undefined;
+        projectId: string;
+        timestamp: number;
+        fromMemoryId: import("convex/values").GenericId<"memories">;
+        toMemoryId: import("convex/values").GenericId<"memories">;
+        relationship: string;
+    }, {
+        projectId: import("convex/values").VString<string, "required">;
+        fromMemoryId: import("convex/values").VId<import("convex/values").GenericId<"memories">, "required">;
+        toMemoryId: import("convex/values").VId<import("convex/values").GenericId<"memories">, "required">;
+        relationship: import("convex/values").VString<string, "required">;
+        metadata: import("convex/values").VObject<{
+            confidence?: number | undefined;
+            createdBy?: string | undefined;
+        } | undefined, {
+            confidence: import("convex/values").VFloat64<number | undefined, "optional">;
+            createdBy: import("convex/values").VString<string | undefined, "optional">;
+        }, "optional", "confidence" | "createdBy">;
+        timestamp: import("convex/values").VFloat64<number, "required">;
+    }, "required", "projectId" | "timestamp" | "fromMemoryId" | "toMemoryId" | "relationship" | "metadata" | "metadata.confidence" | "metadata.createdBy">, {
+        by_from: ["fromMemoryId", "relationship", "_creationTime"];
+        by_to: ["toMemoryId", "relationship", "_creationTime"];
+        by_project: ["projectId", "relationship", "_creationTime"];
+    }, {}, {}>;
+    apiKeys: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        rateLimitOverride?: {
+            requestsPerWindow: number;
+            windowMs: number;
+        } | undefined;
+        lastUsedAt?: number | undefined;
+        expiresAt?: number | undefined;
+        projectId: string;
+        name: string;
+        keyHash: string;
+        permissions: string[];
+        revoked: boolean;
+    }, {
+        keyHash: import("convex/values").VString<string, "required">;
+        projectId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        permissions: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        rateLimitOverride: import("convex/values").VObject<{
+            requestsPerWindow: number;
+            windowMs: number;
+        } | undefined, {
+            requestsPerWindow: import("convex/values").VFloat64<number, "required">;
+            windowMs: import("convex/values").VFloat64<number, "required">;
+        }, "optional", "requestsPerWindow" | "windowMs">;
+        lastUsedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        expiresAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        revoked: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "projectId" | "name" | "keyHash" | "permissions" | "rateLimitOverride" | "lastUsedAt" | "expiresAt" | "revoked" | "rateLimitOverride.requestsPerWindow" | "rateLimitOverride.windowMs">, {
+        by_key: ["keyHash", "_creationTime"];
+        by_project: ["projectId", "revoked", "_creationTime"];
+    }, {}, {}>;
+    rateLimitTokens: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        keyHash: string;
+        windowStart: number;
+        tokenCount: number;
+    }, {
+        keyHash: import("convex/values").VString<string, "required">;
+        windowStart: import("convex/values").VFloat64<number, "required">;
+        tokenCount: import("convex/values").VFloat64<number, "required">;
+    }, "required", "keyHash" | "windowStart" | "tokenCount">, {
+        by_key_window: ["keyHash", "windowStart", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,6ZAM/B,CAAC;AAEF,eAAO,MAAM,cAAc,qPAI1B,CAAC;AAEF,eAAO,MAAM,sBAAsB,kLAGlC,CAAC;AAEF,eAAO,MAAM,qBAAqB,+YAMjC,CAAC;AAEF,eAAO,MAAM,0BAA0B,mRAItC,CAAC;AAEF,eAAO,MAAM,oBAAoB,oUAKhC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,wBAmKG"}

package/dist/component/schema.js

@@ -0,0 +1,161 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+export const memoryTypeValidator = v.union(v.literal("instruction"), v.literal("learning"), v.literal("reference"), v.literal("feedback"), v.literal("journal"));
+export const scopeValidator = v.union(v.literal("project"), v.literal("user"), v.literal("org"));
+export const syncDirectionValidator = v.union(v.literal("push"), v.literal("pull"));
+export const historyEventValidator = v.union(v.literal("created"), v.literal("updated"), v.literal("archived"), v.literal("restored"), v.literal("merged"));
+export const feedbackSentimentValidator = v.union(v.literal("positive"), v.literal("negative"), v.literal("very_negative"));
+export const ingestEventValidator = v.union(v.literal("added"), v.literal("updated"), v.literal("deleted"), v.literal("skipped"));
+export default defineSchema({
+    // Core memory documents — each row is one markdown memory
+    memories: defineTable({
+        projectId: v.string(),
+        scope: scopeValidator,
+        userId: v.optional(v.string()),
+        agentId: v.optional(v.string()),
+        sessionId: v.optional(v.string()),
+        title: v.string(),
+        content: v.string(),
+        memoryType: memoryTypeValidator,
+        tags: v.array(v.string()),
+        paths: v.optional(v.array(v.string())),
+        priority: v.optional(v.float64()),
+        source: v.optional(v.string()),
+        lastSyncedAt: v.optional(v.float64()),
+        checksum: v.string(),
+        archived: v.boolean(),
+        embeddingId: v.optional(v.id("embeddings")),
+        // Access tracking for relevance decay
+        accessCount: v.optional(v.float64()),
+        lastAccessedAt: v.optional(v.float64()),
+        // Feedback aggregation
+        positiveCount: v.optional(v.float64()),
+        negativeCount: v.optional(v.float64()),
+    })
+        .index("by_project", ["projectId", "archived", "memoryType"])
+        .index("by_project_scope", ["projectId", "scope", "userId", "archived"])
+        .index("by_project_title", ["projectId", "title"])
+        .index("by_type_priority", ["projectId", "memoryType", "priority"])
+        .index("by_agent", ["projectId", "agentId", "archived"])
+        .index("by_session", ["projectId", "sessionId", "archived"])
+        .index("by_source", ["projectId", "source", "archived"])
+        .index("by_last_accessed", ["projectId", "lastAccessedAt"])
+        .searchIndex("search_content", {
+        searchField: "content",
+        filterFields: ["projectId", "memoryType", "scope", "archived"],
+    })
+        .searchIndex("search_title", {
+        searchField: "title",
+        filterFields: ["projectId", "memoryType"],
+    }),
+    // Vector embeddings for semantic search
+    embeddings: defineTable({
+        memoryId: v.id("memories"),
+        embedding: v.array(v.float64()),
+        model: v.string(),
+        dimensions: v.float64(),
+    })
+        .index("by_memory", ["memoryId"])
+        .vectorIndex("by_embedding", {
+        vectorField: "embedding",
+        dimensions: 1536,
+        filterFields: [],
+    }),
+    // Project registry
+    projects: defineTable({
+        projectId: v.string(),
+        name: v.string(),
+        description: v.optional(v.string()),
+        settings: v.object({
+            autoSync: v.boolean(),
+            syncFormats: v.array(v.string()),
+            embeddingModel: v.optional(v.string()),
+            embeddingDimensions: v.optional(v.float64()),
+            // Custom prompts for intelligent ingest
+            factExtractionPrompt: v.optional(v.string()),
+            updateDecisionPrompt: v.optional(v.string()),
+            // Relevance decay settings
+            decayEnabled: v.optional(v.boolean()),
+            decayHalfLifeDays: v.optional(v.float64()),
+            // Read-only API rate limiting
+            apiRateLimit: v.optional(v.object({
+                requestsPerWindow: v.float64(),
+                windowMs: v.float64(),
+            })),
+        }),
+    }).index("by_projectId", ["projectId"]),
+    // Sync log — tracks push/pull sync events
+    syncLog: defineTable({
+        projectId: v.string(),
+        userId: v.optional(v.string()),
+        memoryId: v.id("memories"),
+        targetFormat: v.string(),
+        targetPath: v.string(),
+        syncedAt: v.float64(),
+        checksum: v.string(),
+        direction: syncDirectionValidator,
+    }).index("by_project_user", ["projectId", "userId", "syncedAt"]),
+    // Memory history — audit trail of all changes
+    memoryHistory: defineTable({
+        memoryId: v.id("memories"),
+        projectId: v.string(),
+        previousContent: v.optional(v.string()),
+        newContent: v.optional(v.string()),
+        previousTitle: v.optional(v.string()),
+        newTitle: v.optional(v.string()),
+        event: historyEventValidator,
+        actor: v.string(), // userId, agentId, "mcp", "cli", "system", "ingest"
+        timestamp: v.float64(),
+    })
+        .index("by_memory", ["memoryId", "timestamp"])
+        .index("by_project", ["projectId", "timestamp"]),
+    // Memory feedback — quality signals from agents/users
+    memoryFeedback: defineTable({
+        memoryId: v.id("memories"),
+        projectId: v.string(),
+        sentiment: feedbackSentimentValidator,
+        comment: v.optional(v.string()),
+        actor: v.string(),
+        timestamp: v.float64(),
+    })
+        .index("by_memory", ["memoryId", "timestamp"])
+        .index("by_project", ["projectId", "timestamp"]),
+    // Memory relations — graph connections between memories
+    memoryRelations: defineTable({
+        projectId: v.string(),
+        fromMemoryId: v.id("memories"),
+        toMemoryId: v.id("memories"),
+        relationship: v.string(), // e.g. "contradicts", "extends", "replaces", "related_to"
+        metadata: v.optional(v.object({
+            confidence: v.optional(v.float64()),
+            createdBy: v.optional(v.string()),
+        })),
+        timestamp: v.float64(),
+    })
+        .index("by_from", ["fromMemoryId", "relationship"])
+        .index("by_to", ["toMemoryId", "relationship"])
+        .index("by_project", ["projectId", "relationship"]),
+    // API keys — for read-only HTTP API access
+    apiKeys: defineTable({
+        keyHash: v.string(), // SHA-256 hash of the plaintext key
+        projectId: v.string(),
+        name: v.string(), // human-readable label
+        permissions: v.array(v.string()), // allowed endpoints: "list", "get", "search", "context", "export", "history", "relations"
+        rateLimitOverride: v.optional(v.object({
+            requestsPerWindow: v.float64(),
+            windowMs: v.float64(),
+        })),
+        lastUsedAt: v.optional(v.float64()),
+        expiresAt: v.optional(v.float64()),
+        revoked: v.boolean(),
+    })
+        .index("by_key", ["keyHash"])
+        .index("by_project", ["projectId", "revoked"]),
+    // Rate limit tracking — fixed-window token counting per API key
+    rateLimitTokens: defineTable({
+        keyHash: v.string(),
+        windowStart: v.float64(),
+        tokenCount: v.float64(),
+    }).index("by_key_window", ["keyHash", "windowStart"]),
+});
+//# 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":"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"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,11 @@
+export interface McpServerConfig {
+    convexUrl: string;
+    projectId: string;
+    readOnly: boolean;
+    disabledTools: string[];
+    embeddingApiKey?: string;
+    llmApiKey?: string;
+    llmModel?: string;
+}
+export declare function startMcpServer(config: McpServerConfig): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAioB3E"}