context-vault 2.6.1 → 2.7.1

package/node_modules/@context-vault/core/src/server/types.js

@@ -0,0 +1,78 @@
+/**
+ * types.js — JSDoc type definitions for ctx shapes across modes.
+ *
+ * These typedefs document the context object passed through tool handlers,
+ * index, retrieve, and sync layers.
+ */
+
+/**
+ * @typedef {Object} VaultConfig
+ * @property {string} vaultDir - Root vault directory path
+ * @property {string} dbPath - SQLite database file path
+ * @property {string} dataDir - Data directory for embeddings, models, etc.
+ * @property {string} devDir - Dev/config directory
+ * @property {number} eventDecayDays - Recency decay window for event entries
+ * @property {string} [configPath] - Path to resolved config file
+ * @property {boolean} [vaultDirExists] - Whether the vault directory exists on disk
+ * @property {string} [resolvedFrom] - How the config was resolved (env, flag, default, etc.)
+ */
+
+/**
+ * @typedef {Object} PreparedStatements
+ * @property {import('better-sqlite3').Statement} insertEntry
+ * @property {import('better-sqlite3').Statement} insertEntryEncrypted
+ * @property {import('better-sqlite3').Statement} updateEntry
+ * @property {import('better-sqlite3').Statement} upsertByIdentityKey
+ * @property {import('better-sqlite3').Statement} getEntryById
+ * @property {import('better-sqlite3').Statement} getByIdentityKey
+ * @property {import('better-sqlite3').Statement} getRowid
+ * @property {import('better-sqlite3').Statement} getRowidByPath
+ * @property {import('better-sqlite3').Statement} deleteEntry
+ */
+
+/**
+ * Core context properties present in all modes.
+ *
+ * @typedef {Object} BaseCtx
+ * @property {import('better-sqlite3').Database} db - SQLite database instance
+ * @property {VaultConfig} config - Resolved vault configuration
+ * @property {PreparedStatements} stmts - Prepared SQL statements
+ * @property {(text: string) => Promise<Float32Array|null>} embed - Generate embedding vector for text
+ * @property {(rowid: number, embedding: Float32Array) => void} insertVec - Insert vector embedding
+ * @property {(rowid: number) => void} deleteVec - Delete vector embedding
+ */
+
+/**
+ * Context for local (CLI/MCP) mode. Extends BaseCtx with graceful shutdown tracking.
+ *
+ * @typedef {BaseCtx & LocalCtxExtensions} LocalCtx
+ */
+
+/**
+ * @typedef {Object} LocalCtxExtensions
+ * @property {{ count: number }} [activeOps] - In-flight operation counter for graceful shutdown
+ */
+
+/**
+ * Context for hosted (multi-tenant) mode. Extends BaseCtx with auth and encryption.
+ *
+ * @typedef {BaseCtx & HostedCtxExtensions} HostedCtx
+ */
+
+/**
+ * @typedef {Object} HostedCtxExtensions
+ * @property {string} userId - Authenticated user ID
+ * @property {string} [teamId] - Team ID for team-scoped vaults
+ * @property {{ count: number }} [activeOps] - In-flight operation counter for graceful shutdown
+ * @property {(entry: { title?: string, body: string, meta?: object }) => Promise<{ body_encrypted: string, title_encrypted?: string, meta_encrypted?: string, iv: string }>} [encrypt] - Encrypt entry fields
+ * @property {(row: { body_encrypted: string, title_encrypted?: string, meta_encrypted?: string, iv: string }) => Promise<{ body: string, title?: string, meta?: object }>} [decrypt] - Decrypt entry fields
+ * @property {() => { entryCount: number, storageMb: number, maxEntries: number, maxStorageMb: number }} [checkLimits] - Check tier usage limits
+ */
+
+/**
+ * Shared utilities passed alongside ctx to tool handlers.
+ *
+ * @typedef {Object} ToolShared
+ * @property {() => Promise<void>} ensureIndexed - Ensure auto-reindex has completed
+ * @property {boolean} reindexFailed - Whether auto-reindex failed after max attempts
+ */

package/node_modules/@context-vault/core/src/sync/sync.js

@@ -14,7 +14,7 @@ import { indexEntry } from "../index/index.js";
 /**
  * Build a manifest of local vault entries (id → { id, created_at, kind, title }).
  *
- * @param {{ db, stmts }} ctx
+ * @param {import('../server/types.js').BaseCtx} ctx
  * @returns {Map<string, { id: string, created_at: string, kind: string, title: string|null }>}
  */
 export function buildLocalManifest(ctx) {
@@ -107,7 +107,7 @@ export function computeSyncPlan(local, remote) {
 /**
  * Execute a sync plan: push local entries to remote, pull remote entries to local.
  *
- * @param {object} ctx - Vault context
+ * @param {import('../server/types.js').BaseCtx & Partial<import('../server/types.js').HostedCtxExtensions>} ctx
  * @param {{ hostedUrl: string, apiKey: string, plan: SyncPlan, onProgress?: (phase: string, current: number, total: number) => void }} opts
  * @returns {Promise<{ pushed: number, pulled: number, failed: number, errors: string[] }>}
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-vault",
-  "version": "2.6.1",
+  "version": "2.7.1",
   "type": "module",
   "description": "Persistent memory for AI agents — saves and searches knowledge across sessions",
   "bin": {
@@ -56,7 +56,7 @@
     "@context-vault/core"
   ],
   "dependencies": {
-    "@context-vault/core": "^2.5.1",
+    "@context-vault/core": "^2.7.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "better-sqlite3": "^12.6.2",
     "sqlite-vec": "^0.1.0"