@codemem/core 0.0.0 → 0.20.0-alpha.2

package/dist/vectors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Vector store operations for semantic search.
+ *
+ * Ports codemem/store/vectors.py — backfill and on-insert vector writes
+ * against the sqlite-vec `memory_vectors` virtual table.
+ *
+ * All functions accept a raw better-sqlite3 Database so they work outside
+ * the MemoryStore class.  Embedding is async; callers await then write
+ * synchronously (matches the runtime-topology decision: main thread owns DB).
+ */
+import type { Database } from "./db.js";
+export interface BackfillVectorsResult {
+    checked: number;
+    embedded: number;
+    inserted: number;
+    skipped: number;
+}
+export interface BackfillVectorsOptions {
+    limit?: number | null;
+    since?: string | null;
+    project?: string | null;
+    activeOnly?: boolean;
+    dryRun?: boolean;
+    memoryIds?: number[] | null;
+}
+/**
+ * Embed and store vectors for a single memory item.
+ * No-op when embeddings are disabled or the client is unavailable.
+ */
+export declare function storeVectors(db: Database, memoryId: number, title: string, bodyText: string): Promise<void>;
+/**
+ * Backfill vectors for memories that don't have them yet.
+ * Matches Python's `backfill_vectors()` in store/vectors.py.
+ */
+export declare function backfillVectors(db: Database, opts?: BackfillVectorsOptions): Promise<BackfillVectorsResult>;
+export interface SemanticSearchResult {
+    id: number;
+    kind: string;
+    title: string;
+    body_text: string;
+    confidence: number;
+    tags_text: string;
+    metadata_json: string | null;
+    created_at: string;
+    updated_at: string;
+    session_id: number;
+    score: number;
+    distance: number;
+}
+/**
+ * Search for memories by vector similarity (KNN via sqlite-vec MATCH).
+ * Returns an empty array when embeddings are disabled or unavailable.
+ *
+ * Matches Python's `_semantic_search()` in store/search.py.
+ */
+export declare function semanticSearch(db: Database, query: string, limit?: number, filters?: {
+    project?: string | null;
+} | null): Promise<SemanticSearchResult[]>;
+//# sourceMappingURL=vectors.d.ts.map

package/dist/vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../src/vectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAcxC,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5B;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CACjC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAqBf;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACpC,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE,sBAA2B,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAiGhC;AAMD,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CACnC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,EACV,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAC1C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoDjC"}

package/package.json

@@ -1 +1,41 @@
-{"name":"@codemem/core","version":"0.0.0","description":"codemem core library"}
+{
+  "name": "@codemem/core",
+  "version": "0.20.0-alpha.2",
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "typescript": "^5.8.2",
+    "vite": "^8.0.0",
+    "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "drizzle-orm": "^0.45.1",
+    "hono": "^4.7.10",
+    "sqlite-vec": "0.1.7-alpha.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kunickiaj/codemem.git",
+    "directory": "packages/core"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm exec vite build && pnpm exec tsc --emitDeclarationOnly",
+    "typecheck": "pnpm exec tsc --noEmit"
+  }
+}