@psiclawops/hypermem 0.8.3 → 0.8.5

package/dist/compaction-fence.js

@@ -48,17 +48,38 @@ export function ensureCompactionFenceSchema(db) {
  * This prevents a short compose window from accidentally exposing
  * already-compacted messages.
  */
-export function updateCompactionFence(db, conversationId, oldestVisibleMessageId) {
+export function updateCompactionFence(db, conversationId, oldestVisibleMessageId, opts = {}) {
     const now = new Date().toISOString();
+    const minTailMessages = typeof opts.minTailMessages === 'number' && Number.isFinite(opts.minTailMessages)
+        ? Math.max(1, Math.floor(opts.minTailMessages))
+        : undefined;
+    const oldestRecentRow = minTailMessages != null
+        ? db.prepare(`
+          SELECT id FROM messages
+          WHERE conversation_id = ?
+            AND role != 'system'
+          ORDER BY message_index DESC
+          LIMIT 1 OFFSET ?
+        `).get(conversationId, minTailMessages - 1) ?? db.prepare(`
+          SELECT id FROM messages
+          WHERE conversation_id = ?
+            AND role != 'system'
+          ORDER BY message_index ASC
+          LIMIT 1
+        `).get(conversationId)
+        : undefined;
+    const clampedMessageId = oldestRecentRow
+        ? Math.min(oldestVisibleMessageId, oldestRecentRow.id)
+        : oldestVisibleMessageId;
     const existing = db.prepare('SELECT fence_message_id FROM compaction_fences WHERE conversation_id = ?').get(conversationId);
     if (!existing) {
         // First fence for this conversation
-        db.prepare('INSERT INTO compaction_fences (conversation_id, fence_message_id, updated_at) VALUES (?, ?, ?)').run(conversationId, oldestVisibleMessageId, now);
+        db.prepare('INSERT INTO compaction_fences (conversation_id, fence_message_id, updated_at) VALUES (?, ?, ?)').run(conversationId, clampedMessageId, now);
         return;
     }
     // Monotone progress: fence only moves forward
-    if (oldestVisibleMessageId > existing.fence_message_id) {
-        db.prepare('UPDATE compaction_fences SET fence_message_id = ?, updated_at = ? WHERE conversation_id = ?').run(oldestVisibleMessageId, now, conversationId);
+    if (clampedMessageId > existing.fence_message_id) {
+        db.prepare('UPDATE compaction_fences SET fence_message_id = ?, updated_at = ? WHERE conversation_id = ?').run(clampedMessageId, now, conversationId);
     }
 }
 /**

package/dist/compositor.js

@@ -2495,7 +2495,7 @@ export class Compositor {
             `).get(conversation.id, historyMsgCount - 1);
                         if (oldestIncluded) {
                             ensureCompactionFenceSchema(db);
-                            updateCompactionFence(db, conversation.id, oldestIncluded.id);
+                            updateCompactionFence(db, conversation.id, oldestIncluded.id, { minTailMessages: 8 });
                         }
                     }
                 }

package/dist/cross-agent.d.ts

@@ -27,7 +27,7 @@ export interface OrgRegistry {
  * Default fleet org structure.
  *
  * ── EXAMPLE DATA ──────────────────────────────────────────────────────────
- * The agent names below (agent1, agent2, director1, etc.) are PLACEHOLDERS.
+ * The agent names below (alice, bob, director1, etc.) are PLACEHOLDERS.
  * Replace them with your own agent IDs to match your fleet configuration.
  *
  * Single-agent installs: you don't need to edit this. Your agent ID is

package/dist/cross-agent.js

@@ -21,7 +21,7 @@ import { FleetStore } from './fleet-store.js';
  * Default fleet org structure.
  *
  * ── EXAMPLE DATA ──────────────────────────────────────────────────────────
- * The agent names below (agent1, agent2, director1, etc.) are PLACEHOLDERS.
+ * The agent names below (alice, bob, director1, etc.) are PLACEHOLDERS.
  * Replace them with your own agent IDs to match your fleet configuration.
  *
  * Single-agent installs: you don't need to edit this. Your agent ID is
@@ -34,27 +34,27 @@ import { FleetStore } from './fleet-store.js';
  */
 export function defaultOrgRegistry() {
     const agents = {
-        agent1: { agentId: 'agent1', tier: 'council' },
-        agent2: { agentId: 'agent2', tier: 'council' },
+        alice: { agentId: 'alice', tier: 'council' },
+        bob: { agentId: 'bob', tier: 'council' },
         agent4: { agentId: 'agent4', tier: 'council' },
-        agent3: { agentId: 'agent3', tier: 'council' },
-        agent6: { agentId: 'agent6', tier: 'council' },
-        agent5: { agentId: 'agent5', tier: 'council' },
-        director1: { agentId: 'director1', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
-        director2: { agentId: 'director2', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
-        director3: { agentId: 'director3', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
-        director4: { agentId: 'director4', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
-        director5: { agentId: 'director5', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
-        director6: { agentId: 'director6', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
-        director7: { agentId: 'director7', tier: 'director', org: 'agent3-org', councilLead: 'agent3' },
-        director8: { agentId: 'director8', tier: 'director', org: 'agent3-org', councilLead: 'agent3' },
+        dave: { agentId: 'dave', tier: 'council' },
+        carol: { agentId: 'carol', tier: 'council' },
+        oscar: { agentId: 'oscar', tier: 'council' },
+        director1: { agentId: 'director1', tier: 'director', org: 'alice-org', councilLead: 'alice' },
+        director2: { agentId: 'director2', tier: 'director', org: 'alice-org', councilLead: 'alice' },
+        director3: { agentId: 'director3', tier: 'director', org: 'alice-org', councilLead: 'alice' },
+        director4: { agentId: 'director4', tier: 'director', org: 'bob-org', councilLead: 'bob' },
+        director5: { agentId: 'director5', tier: 'director', org: 'bob-org', councilLead: 'bob' },
+        director6: { agentId: 'director6', tier: 'director', org: 'bob-org', councilLead: 'bob' },
+        director7: { agentId: 'director7', tier: 'director', org: 'dave-org', councilLead: 'dave' },
+        director8: { agentId: 'director8', tier: 'director', org: 'dave-org', councilLead: 'dave' },
         specialist1: { agentId: 'specialist1', tier: 'specialist' },
         specialist2: { agentId: 'specialist2', tier: 'specialist' },
     };
     const orgs = {
-        'agent1-org': ['agent1', 'director1', 'director2', 'director3'],
-        'agent2-org': ['agent2', 'director4', 'director5', 'director6'],
-        'agent3-org': ['agent3', 'director7', 'director8'],
+        'alice-org': ['alice', 'director1', 'director2', 'director3'],
+        'bob-org': ['bob', 'director4', 'director5', 'director6'],
+        'dave-org': ['dave', 'director7', 'director8'],
     };
     return { orgs, agents };
 }

package/dist/dreaming-promoter.d.ts

@@ -67,7 +67,7 @@ export interface DreamerResult {
 }
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace-council/{agentId}/
+ * Council agents live at ~/.openclaw/workspace/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export declare function resolveAgentWorkspacePath(agentId: string): Promise<string | null>;

package/dist/dreaming-promoter.js

@@ -31,12 +31,12 @@ export const DEFAULT_DREAMER_CONFIG = {
 // ─── Workspace path resolution ───────────────────────────────────────────────
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace-council/{agentId}/
+ * Council agents live at ~/.openclaw/workspace/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export async function resolveAgentWorkspacePath(agentId) {
     const home = os.homedir();
-    const councilPath = path.join(home, '.openclaw', 'workspace-council', agentId);
+    const councilPath = path.join(home, '.openclaw', 'workspace', agentId);
     const workspacePath = path.join(home, '.openclaw', 'workspace', agentId);
     try {
         await fs.access(councilPath);

package/dist/index.d.ts

@@ -126,8 +126,8 @@ export interface StartupFleetSeedResult {
  *
  * Usage:
  *   const hm = await hypermem.create({ dataDir: '~/.openclaw/hypermem' });
- *   await hm.record('agent1', 'agent:agent1:webchat:main', userMsg);
- *   const result = await hm.compose({ agentId: 'agent1', sessionKey: '...', ... });
+ *   await hm.record('alice', 'agent:alice:webchat:main', userMsg);
+ *   const result = await hm.compose({ agentId: 'alice', sessionKey: '...', ... });
  */
 export declare class HyperMem {
     readonly dbManager: DatabaseManager;
@@ -185,7 +185,7 @@ export declare class HyperMem {
     /**
      * List archived or forked contexts for an agent.
      *
-     * Operator-safe enumeration path. This is the approved archived-context
+     * operator-safe enumeration path. This is the approved archived-context
      * listing surface. Active composition remains separate.
      */
     listArchivedContexts(agentId: string, opts?: {

package/dist/index.js

@@ -97,7 +97,7 @@ const DEFAULT_CONFIG = {
     cache: {
         keyPrefix: 'hm:',
         sessionTTL: 14400, // 4 hours — system/identity/meta slots
-        historyTTL: 604800, // 7 days — extended for ClawCanvas display
+        historyTTL: 604800, // 7 days — extended for canvas display
     },
     compositor: {
         // TUNE-010 (2026-04-02): Raised from 65000 → 90000.
@@ -217,7 +217,7 @@ function mergeStartupCandidate(target, partial) {
 function discoverStartupFleetCandidates(dbManager, opts = {}) {
     const homeDir = process.env.HOME || os.homedir();
     const workspaceRoots = opts.workspaceRoots ?? [
-        path.join(homeDir, '.openclaw', 'workspace-council'),
+        path.join(homeDir, '.openclaw', 'workspace'),
         path.join(homeDir, '.openclaw', 'workspace'),
     ];
     const candidates = new Map();
@@ -331,8 +331,8 @@ function discoverStartupFleetCandidates(dbManager, opts = {}) {
  *
  * Usage:
  *   const hm = await hypermem.create({ dataDir: '~/.openclaw/hypermem' });
- *   await hm.record('agent1', 'agent:agent1:webchat:main', userMsg);
- *   const result = await hm.compose({ agentId: 'agent1', sessionKey: '...', ... });
+ *   await hm.record('alice', 'agent:alice:webchat:main', userMsg);
+ *   const result = await hm.compose({ agentId: 'alice', sessionKey: '...', ... });
  */
 export class HyperMem {
     dbManager;
@@ -531,7 +531,7 @@ export class HyperMem {
     /**
      * List archived or forked contexts for an agent.
      *
-     * Operator-safe enumeration path. This is the approved archived-context
+     * operator-safe enumeration path. This is the approved archived-context
      * listing surface. Active composition remains separate.
      */
     listArchivedContexts(agentId, opts) {

package/dist/seed.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'alice' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/seed.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'alice' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/session-flusher.d.ts

@@ -33,8 +33,8 @@ export interface FlushSessionResult {
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "agent1")
- * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "alice")
+ * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export declare function flushSession(cache: CacheLayer, agentId: string, sessionKey: string, opts?: FlushSessionOptions): Promise<FlushSessionResult>;

package/dist/session-flusher.js

@@ -18,8 +18,8 @@
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "agent1")
- * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "alice")
+ * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export async function flushSession(cache, agentId, sessionKey, opts = {}) {

package/dist/spawn-context.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:agent1:webchat:main',
+ *     parentSessionKey: 'agent:alice:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/spawn-context.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:agent1:webchat:main',
+ *     parentSessionKey: 'agent:alice:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/topic-store.js

@@ -12,12 +12,12 @@
 const KNOWN_NAMES = {
     hypermem: 'HyperMem',
     hyperbuilder: 'HyperBuilder',
-    clawcanvas: 'ClawCanvas',
-    clawdash: 'ClawDash',
-    clawdispatch: 'ClawDispatch',
+    canvas: 'canvas',
+    dashboard: 'dashboard',
+    dispatch: 'dispatch',
     clawtext: 'ClawText',
-    clawtomation: 'ClawTomation',
-    clawcouncil: 'ClawCouncil',
+    automation: 'automation',
+    council: 'council',
     openclaw: 'OpenClaw',
     clawhub: 'ClawHub',
 };

package/dist/topic-synthesizer.js

@@ -35,7 +35,7 @@ function keystoneScore(msg) {
     const backtickMatches = text.match(/`[^`]+`/g) || [];
     score += backtickMatches.length * 0.2;
     // Agent mentions (known patterns)
-    const agentMentions = text.match(/\b(agent1|agent2|agent4|agent3|agent5|agent6|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
+    const agentMentions = text.match(/\b(alice|bob|agent4|dave|oscar|carol|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
     score += agentMentions.length * 0.25;
     // Quoted content
     const quotedMatches = text.match(/"[^"]{10,}"/g) || [];

package/dist/trigger-registry.d.ts

@@ -39,7 +39,7 @@ export interface CollectionTrigger {
 export declare const TRIGGER_REGISTRY_VERSION = "1.0.0";
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from agent6's spec.
+ * Covers the core ACA offload use case from carol's spec.
  */
 export declare const TRIGGER_REGISTRY: CollectionTrigger[];
 /** Backward-compat alias — same reference as TRIGGER_REGISTRY */

package/dist/trigger-registry.js

@@ -13,7 +13,7 @@ import { createHash } from 'node:crypto';
 export const TRIGGER_REGISTRY_VERSION = '1.0.0';
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from agent6's spec.
+ * Covers the core ACA offload use case from carol's spec.
  */
 export const TRIGGER_REGISTRY = [
     {
@@ -61,7 +61,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 800,
         maxChunks: 2,
-        owner: 'agent1',
+        owner: 'alice',
         category: 'operations',
         description: 'Agent operational procedures: boot sequence, heartbeat, work queue, session startup',
     },
@@ -98,7 +98,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1500,
         maxChunks: 4,
-        owner: 'agent1',
+        owner: 'alice',
         category: 'memory',
         description: 'Decision history: past choices, previously agreed approaches, recalled context',
     },
@@ -124,7 +124,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1200,
         maxChunks: 3,
-        owner: 'agent1',
+        owner: 'alice',
         category: 'operations',
         description: 'Agent tooling reference: CLI commands, config paths, deployment procedures, quick reference',
     },

package/dist/types.d.ts

@@ -70,7 +70,7 @@ export type FactScope = 'agent' | 'session' | 'user';
 /**
  * Memory visibility levels:
  * - private:  Only the owning agent can read. Identity, SOUL, personal reflections.
- * - org:      Agents in the same org (e.g., agent1's directors: Pylon, Vigil, Plane).
+ * - org:      Agents in the same org (e.g., alice's directors: Hank, Jack, Irene).
  * - council:  All council seats can read.
  * - fleet:    Any agent in the fleet can read.
  */
@@ -400,7 +400,7 @@ export interface ProviderMessage {
  * to identify high-signal unprocessed messages.
  *
  * Stored in Redis (hm:{a}:s:{s}:cursor) with dual-write to SQLite for
- * durability across Redis eviction (agent2 Gate 2).
+ * durability across Redis eviction (bob Gate 2).
  */
 export interface SessionCursor {
     /** StoredMessage.id of the newest message included in the last window */

package/docs/TUNING.md

@@ -1,6 +1,6 @@
 # hypermem Tuning Guide
 
-Configuration reference for operators and agents. All settings are optional, but the installer now writes a fully-expanded `config.json` so operators can see every default in one place.
+Configuration reference for operators and agents. All settings are optional. The recommended install path writes a starter `config.json` with an explicit lightweight embedding choice and a declarative baseline compositor profile. Tune from that verified baseline, not from guesswork.
 
 Config lives in `~/.openclaw/hypermem/config.json` (takes effect on gateway restart) or is passed programmatically via `HyperMem.create()`:
 
@@ -23,6 +23,16 @@ Resolution order is:
 2. `~/.openclaw/hypermem/config.json`
 3. code defaults
 
+## Before you tune
+
+Do not tune an install that is only staged. Verify these first:
+
+1. `openclaw plugins list` shows `hypercompositor` and `hypermem` loaded
+2. `openclaw logs --limit 50 | grep hypermem` shows `hypermem initialized`
+3. after a real agent message, logs show `[hypermem:compose]`
+
+If any of those are missing, go back to `INSTALL.md`. That is an install-path problem, not a tuning problem.
+
 ---
 
 ## Token Cost Philosophy
@@ -577,7 +587,7 @@ Large T0 results (>40k chars) at high context pressure (>80%) get head-and-tail
 
 **When `deferToolPruning: true`**: hypermem skips its own gradient when OpenClaw's native `contextPruning` is active. The native pruner handles tool result trimming on those providers. The gradient remains active as fallback for other providers.
 
-> **Recommended:** disable OpenClaw's context pruning entirely (`openclaw config set agents.defaults.contextPruning.mode off`) and let HyperMem manage all context pressure. The two systems do not coordinate and can fight each other, causing unpredictable context loss. See INSTALL.md "OCPlatform Platform Settings" for the full recommended config.
+> **Recommended:** disable OpenClaw's context pruning entirely (`openclaw config set agents.defaults.contextPruning.mode off`) and let HyperMem manage all context pressure. The two systems do not coordinate and can fight each other, causing unpredictable context loss. See INSTALL.md "OpenClaw Platform Settings" for the full recommended config.
 
 **When `verboseLogging: true`**: HyperMem emits budget-source and trim-decision logs so you can see whether a turn used runtime `tokenBudget`, a manual `contextWindowOverrides` entry, or the `contextWindowSize` fallback.
 

package/install.sh

@@ -323,31 +323,31 @@ write_config() {
   "warmCacheReplayThresholdMs": 120000,
   "subagentWarming": "light",
   "compositor": {
-    "budgetFraction": 0.703,
+    "budgetFraction": 0.55,
     "reserveFraction": 0.25,
     "historyFraction": 0.4,
     "memoryFraction": 0.4,
     "defaultTokenBudget": 90000,
     "maxHistoryMessages": 500,
-    "maxFacts": 30,
+    "maxFacts": 25,
     "maxExpertisePatterns": 6,
     "maxCrossSessionContext": 4000,
     "maxTotalTriggerTokens": 4000,
     "maxRecentToolPairs": 3,
     "maxProseToolPairs": 10,
-    "warmHistoryBudgetFraction": 0.4,
+    "warmHistoryBudgetFraction": 0.27,
     "contextWindowReserve": 0.25,
     "dynamicReserveTurnHorizon": 5,
     "dynamicReserveMax": 0.5,
     "dynamicReserveEnabled": true,
-    "keystoneHistoryFraction": 0.2,
-    "keystoneMaxMessages": 15,
+    "keystoneHistoryFraction": 0.15,
+    "keystoneMaxMessages": 12,
     "keystoneMinSignificance": 0.5,
-    "targetBudgetFraction": 0.65,
+    "targetBudgetFraction": 0.50,
     "enableFOS": true,
     "enableMOD": true,
     "hyperformProfile": "standard",
-    "wikiTokenCap": 600,
+    "wikiTokenCap": 500,
     "zigzagOrdering": true
   },
   "eviction": {

package/memory-plugin/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@psiclawops/hypermem-memory",
-  "version": "0.8.3",
-  "description": "HyperMem memory plugin for OpenClaw \u2014 bridges HyperMem retrieval into the memory slot",
+  "version": "0.8.5",
+  "description": "HyperMem memory plugin for OpenClaw — bridges HyperMem retrieval into the memory slot",
   "type": "module",
   "main": "dist/index.js",
   "license": "Apache-2.0",

package/node_modules/sqlite-vec/README.md

@@ -0,0 +1 @@
+TODO

package/node_modules/sqlite-vec/index.cjs

@@ -0,0 +1,46 @@
+
+
+const { arch, platform } = require("node:process");
+
+
+const BASE_PACKAGE_NAME = "sqlite-vec";
+const ENTRYPOINT_BASE_NAME = "vec0";
+const supportedPlatforms = [["darwin","x64"],["linux","x64"],["darwin","arm64"],["win32","x64"],["linux","arm64"]];
+
+const invalidPlatformErrorMessage = `Unsupported platform for ${BASE_PACKAGE_NAME}, on a ${platform}-${arch} machine. Supported platforms are (${supportedPlatforms
+  .map(([p, a]) => `${p}-${a}`)
+  .join(",")}). Consult the ${BASE_PACKAGE_NAME} NPM package README for details.`;
+
+const extensionNotFoundErrorMessage = packageName => `Loadble extension for ${BASE_PACKAGE_NAME} not found. Was the ${packageName} package installed?`;
+
+function validPlatform(platform, arch) {
+  return (
+    supportedPlatforms.find(([p, a]) => platform === p && arch === a) !== undefined
+  );
+}
+function extensionSuffix(platform) {
+  if (platform === "win32") return "dll";
+  if (platform === "darwin") return "dylib";
+  return "so";
+}
+function platformPackageName(platform, arch) {
+  const os = platform === "win32" ? "windows" : platform;
+  return `${BASE_PACKAGE_NAME}-${os}-${arch}`;
+}
+
+function getLoadablePath() {
+  if (!validPlatform(platform, arch)) {
+    throw new Error(
+      invalidPlatformErrorMessage
+    );
+  }
+  const packageName = platformPackageName(platform, arch);
+  const loadablePath = require.resolve(packageName + "/" + ENTRYPOINT_BASE_NAME + "." + extensionSuffix(platform));
+  return loadablePath;
+}
+
+function load(db) {
+  db.loadExtension(getLoadablePath());
+}
+
+module.exports = {getLoadablePath, load};

package/node_modules/sqlite-vec/index.d.ts

@@ -0,0 +1,17 @@
+
+
+/**
+ * TODO JSDoc
+ */
+export declare function getLoadablePath(): string;
+
+
+interface Db {
+    loadExtension(file: string, entrypoint?: string | undefined): void;
+}
+
+/**
+ * TODO JSDoc
+ */
+export declare function load(db: Db): void;
+

package/node_modules/sqlite-vec/index.mjs

@@ -0,0 +1,47 @@
+
+
+import { fileURLToPath } from "node:url";
+import { arch, platform } from "node:process";
+
+
+const BASE_PACKAGE_NAME = "sqlite-vec";
+const ENTRYPOINT_BASE_NAME = "vec0";
+const supportedPlatforms = [["darwin","x64"],["linux","x64"],["darwin","arm64"],["win32","x64"],["linux","arm64"]];
+
+const invalidPlatformErrorMessage = `Unsupported platform for ${BASE_PACKAGE_NAME}, on a ${platform}-${arch} machine. Supported platforms are (${supportedPlatforms
+  .map(([p, a]) => `${p}-${a}`)
+  .join(",")}). Consult the ${BASE_PACKAGE_NAME} NPM package README for details.`;
+
+const extensionNotFoundErrorMessage = packageName => `Loadble extension for ${BASE_PACKAGE_NAME} not found. Was the ${packageName} package installed?`;
+
+function validPlatform(platform, arch) {
+  return (
+    supportedPlatforms.find(([p, a]) => platform === p && arch === a) !== undefined
+  );
+}
+function extensionSuffix(platform) {
+  if (platform === "win32") return "dll";
+  if (platform === "darwin") return "dylib";
+  return "so";
+}
+function platformPackageName(platform, arch) {
+  const os = platform === "win32" ? "windows" : platform;
+  return `${BASE_PACKAGE_NAME}-${os}-${arch}`;
+}
+
+function getLoadablePath() {
+  if (!validPlatform(platform, arch)) {
+    throw new Error(
+      invalidPlatformErrorMessage
+    );
+  }
+  const packageName = platformPackageName(platform, arch);
+  const loadablePath = fileURLToPath(import.meta.resolve(packageName + "/" + ENTRYPOINT_BASE_NAME + "." + extensionSuffix(platform)));
+  return loadablePath;
+}
+
+function load(db) {
+  db.loadExtension(getLoadablePath());
+}
+
+export {getLoadablePath, load};

package/node_modules/sqlite-vec/package.json

@@ -0,0 +1 @@
+{"name":"sqlite-vec","version":"0.1.9","author":"Alex Garcia","license":"MIT OR Apache","description":"A vector search SQLite extension.","repository":{"type":"git","url":"https://github.com/asg017/sqlite-vec","directory":null},"main":"./index.cjs","module":"./index.mjs","types":"./index.d.ts","exports":{".":{"require":"./index.cjs","import":"./index.mjs","types":"./index.d.ts"}},"files":[],"keywords":[],"optionalDependencies":{"sqlite-vec-darwin-x64":"0.1.9","sqlite-vec-linux-x64":"0.1.9","sqlite-vec-darwin-arm64":"0.1.9","sqlite-vec-windows-x64":"0.1.9","sqlite-vec-linux-arm64":"0.1.9"}}

package/node_modules/sqlite-vec-linux-x64/README.md

@@ -0,0 +1 @@
+TODO

package/node_modules/sqlite-vec-linux-x64/package.json

@@ -0,0 +1 @@
+{"name":"sqlite-vec-linux-x64","version":"0.1.9","author":"Alex Garcia","license":"MIT OR Apache","description":"A vector search SQLite extension.","repository":{"type":"git","url":"https://github.com/asg017/sqlite-vec","directory":null},"exports":{"./vec0.so":{"default":"./vec0.so"}},"files":[],"keywords":[],"os":["linux"],"cpu":["x64"]}

package/node_modules/zod/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.