eve-memory-pg 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present <PLACEHOLDER>
+
+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.

package/README.md

@@ -0,0 +1,53 @@
+# eve-memory-pg
+
+Postgres/pgvector storage adapter for [`eve-memory`](https://www.npmjs.com/package/eve-memory) — durable cross-session memory for [Vercel eve](https://vercel.com/eve) agents.
+
+```bash
+pnpm add eve-memory eve-memory-pg pg
+```
+
+Your database needs the [pgvector](https://github.com/pgvector/pgvector) extension available (Neon, Supabase, RDS, and Vercel-integrated Postgres all ship it). The adapter runs an idempotent migration at startup.
+
+## Usage
+
+```ts
+import { defineMemory } from "eve-memory";
+import { gatewayEmbedder } from "eve-memory/adapters";
+import { pgMemoryAdapter } from "eve-memory-pg";
+
+export default defineMemory({
+  adapter: pgMemoryAdapter({
+    connectionString: process.env.DATABASE_URL!,
+    dimensions: 1536, // must match your embedding model
+  }),
+  embedder: gatewayEmbedder({ model: "openai/text-embedding-3-small" }),
+  semanticRecall: { topK: 5, scope: "resource" },
+  workingMemory: { template: "- name:\n- preferences:" },
+});
+```
+
+### Bring your own client
+
+Anything with a `query(sql, params) => Promise<{ rows }>` works — a `pg.Pool`, Neon's serverless driver, or PGlite in tests:
+
+```ts
+pgMemoryAdapter({ client: myPool, dimensions: 1536 });
+```
+
+With `connectionString`, the adapter creates a `pg.Pool` and closes it on `memory.dispose()`. With `client`, you own the lifecycle.
+
+### Options
+
+| Option | Required | Description |
+|---|---|---|
+| `dimensions` | ✅ | Embedding dimension of the `vector` column (e.g. 1536 for `openai/text-embedding-3-small`, 128 for `stubEmbedder`) |
+| `client` or `connectionString` | ✅ one of | How to reach Postgres |
+| `tablePrefix` | | Table name prefix, default `eve_memory` |
+
+## Tables
+
+`<prefix>_entries` (id, resource_id, thread_id, content, `vector` embedding, seq, created_at) and `<prefix>_working` (scope, resource_id, thread_id, content, updated_at). Search uses pgvector cosine distance (`<=>`).
+
+## License
+
+MIT

package/dist/cjs/index.js

@@ -0,0 +1,158 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.pgMemoryAdapter = void 0;
+var _effect = require("effect");
+var _eveMemory = require("eve-memory");
+/** eve-memory-pg — Postgres/pgvector storage adapter for eve-memory */
+
+const EntryRow = /*#__PURE__*/_effect.Schema.Struct({
+  id: _effect.Schema.String,
+  resource_id: _effect.Schema.String,
+  thread_id: _effect.Schema.String,
+  content: _effect.Schema.String,
+  created_at: /*#__PURE__*/_effect.Schema.Union(_effect.Schema.DateFromSelf, _effect.Schema.Date)
+});
+const SearchRow = /*#__PURE__*/_effect.Schema.Struct({
+  ...EntryRow.fields,
+  score: _effect.Schema.Number
+});
+const WorkingMemoryRow = /*#__PURE__*/_effect.Schema.Struct({
+  content: _effect.Schema.String
+});
+const decodeEntryRows = /*#__PURE__*/_effect.Schema.decodeUnknown(/*#__PURE__*/_effect.Schema.Array(EntryRow));
+const decodeSearchRows = /*#__PURE__*/_effect.Schema.decodeUnknown(/*#__PURE__*/_effect.Schema.Array(SearchRow));
+const decodeWorkingMemoryRows = /*#__PURE__*/_effect.Schema.decodeUnknown(/*#__PURE__*/_effect.Schema.Array(WorkingMemoryRow));
+const toEntry = row => ({
+  id: row.id,
+  resourceId: row.resource_id,
+  threadId: row.thread_id,
+  content: row.content,
+  createdAt: row.created_at
+});
+/** pgvector accepts the JSON array literal syntax for vector values. */
+const toVectorLiteral = embedding => JSON.stringify(embedding);
+/**
+ * One statement per entry: PGlite (and other extended-protocol clients)
+ * reject multi-statement strings, and every statement is idempotent.
+ */
+const migrationStatements = (prefix, dimensions) => [`CREATE EXTENSION IF NOT EXISTS vector`, `CREATE TABLE IF NOT EXISTS ${prefix}_entries (
+    id text PRIMARY KEY,
+    resource_id text NOT NULL,
+    thread_id text NOT NULL,
+    content text NOT NULL,
+    embedding vector(${dimensions}) NOT NULL,
+    seq bigint GENERATED ALWAYS AS IDENTITY,
+    created_at timestamptz NOT NULL
+  )`, `CREATE INDEX IF NOT EXISTS ${prefix}_entries_scope_idx
+    ON ${prefix}_entries (resource_id, thread_id)`, `CREATE TABLE IF NOT EXISTS ${prefix}_working (
+    scope text NOT NULL,
+    resource_id text NOT NULL,
+    thread_id text NOT NULL,
+    content text NOT NULL,
+    updated_at timestamptz NOT NULL,
+    PRIMARY KEY (scope, resource_id, thread_id)
+  )`];
+/** Working-memory rows use thread_id = '' for resource scope, keeping one natural key. */
+const workingMemoryParams = key => [key.scope, key.resourceId, key.scope === "resource" ? "" : key.threadId];
+const acquireClient = options => "client" in options ? _effect.Effect.succeed(options.client) : _effect.Effect.acquireRelease(_effect.Effect.promise(async () => {
+  const {
+    default: pg
+  } = await import("pg");
+  return new pg.Pool({
+    connectionString: options.connectionString
+  });
+}), pool => _effect.Effect.promise(() => pool.end()));
+/**
+ * Postgres storage adapter backed by pgvector cosine distance. The layer
+ * runs an idempotent migration at construction; connection and migration
+ * failures are configuration errors and fail fast (die).
+ */
+const pgMemoryAdapter = options => _effect.Layer.scoped(_eveMemory.Memory, _effect.Effect.gen(function* () {
+  const prefix = options.tablePrefix ?? "eve_memory";
+  if (!/^[a-z_][a-z0-9_]*$/.test(prefix)) {
+    return yield* _effect.Effect.dieMessage(`eve-memory-pg: invalid tablePrefix "${prefix}" — use lowercase letters, digits, underscores`);
+  }
+  const entries = `${prefix}_entries`;
+  const working = `${prefix}_working`;
+  const client = yield* acquireClient(options);
+  const run = (operation, sql, params) => _effect.Effect.tryPromise({
+    try: () => client.query(sql, params),
+    catch: cause => new _eveMemory.MemoryStorageError({
+      operation,
+      cause
+    })
+  });
+  const decoded = (operation, decoder) => rows => decoder(rows).pipe(_effect.Effect.mapError(cause => new _eveMemory.MemoryStorageError({
+    operation,
+    cause
+  })));
+  yield* _effect.Effect.forEach(migrationStatements(prefix, options.dimensions), statement => _effect.Effect.promise(() => client.query(statement))).pipe(_effect.Effect.orDie);
+  const neighborsOf = (entry, range) => _effect.Effect.gen(function* () {
+    if (range <= 0) return [];
+    const result = yield* run("search", `WITH thread AS (
+               SELECT id, resource_id, thread_id, content, created_at,
+                      row_number() OVER (ORDER BY seq) AS rn
+               FROM ${entries}
+               WHERE resource_id = $1 AND thread_id = $2
+             ), anchor AS (
+               SELECT rn FROM thread WHERE id = $3
+             )
+             SELECT t.id, t.resource_id, t.thread_id, t.content, t.created_at
+             FROM thread t, anchor a
+             WHERE t.rn BETWEEN a.rn - $4 AND a.rn + $4 AND t.id <> $3
+             ORDER BY t.rn`, [entry.resourceId, entry.threadId, entry.id, range]);
+    const rows = yield* decoded("search", decodeEntryRows)(result.rows);
+    return rows.map(toEntry);
+  });
+  return {
+    store: input => _effect.Effect.gen(function* () {
+      const now = yield* _effect.Clock.currentTimeMillis;
+      const entry = {
+        id: `mem_${crypto.randomUUID()}`,
+        resourceId: input.resourceId,
+        threadId: input.threadId,
+        content: input.content,
+        createdAt: new Date(now)
+      };
+      yield* run("store", `INSERT INTO ${entries} (id, resource_id, thread_id, content, embedding, created_at)
+               VALUES ($1, $2, $3, $4, $5::vector, $6)`, [entry.id, entry.resourceId, entry.threadId, entry.content, toVectorLiteral(input.embedding), entry.createdAt]);
+      return entry;
+    }),
+    search: input => _effect.Effect.gen(function* () {
+      const result = yield* run("search", `SELECT id, resource_id, thread_id, content, created_at,
+                      1 - (embedding <=> $1::vector) AS score
+               FROM ${entries}
+               WHERE resource_id = $2
+                 AND ($3::text IS NULL OR thread_id = $3)
+                 AND 1 - (embedding <=> $1::vector) >= $4
+               ORDER BY embedding <=> $1::vector
+               LIMIT $5`, [toVectorLiteral(input.embedding), input.resourceId, input.scope === "thread" ? input.threadId : null, input.threshold, input.topK]);
+      const rows = yield* decoded("search", decodeSearchRows)(result.rows);
+      const matches = [];
+      for (const row of rows) {
+        const entry = toEntry(row);
+        matches.push({
+          entry,
+          score: row.score,
+          neighbors: yield* neighborsOf(entry, input.messageRange)
+        });
+      }
+      return matches;
+    }),
+    remove: id => run("remove", `DELETE FROM ${entries} WHERE id = $1`, [id]).pipe(_effect.Effect.asVoid),
+    getWorkingMemory: key => _effect.Effect.gen(function* () {
+      const result = yield* run("getWorkingMemory", `SELECT content FROM ${working} WHERE scope = $1 AND resource_id = $2 AND thread_id = $3`, workingMemoryParams(key));
+      const rows = yield* decoded("getWorkingMemory", decodeWorkingMemoryRows)(result.rows);
+      return _effect.Option.fromNullable(rows[0]?.content);
+    }),
+    setWorkingMemory: (key, content) => run("setWorkingMemory", `INSERT INTO ${working} (scope, resource_id, thread_id, content, updated_at)
+             VALUES ($1, $2, $3, $4, now())
+             ON CONFLICT (scope, resource_id, thread_id)
+             DO UPDATE SET content = EXCLUDED.content, updated_at = now()`, [...workingMemoryParams(key), content]).pipe(_effect.Effect.asVoid)
+  };
+}));
+exports.pgMemoryAdapter = pgMemoryAdapter;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_effect","require","_eveMemory","EntryRow","Schema","Struct","id","String","resource_id","thread_id","content","created_at","Union","DateFromSelf","Date","SearchRow","fields","score","Number","WorkingMemoryRow","decodeEntryRows","decodeUnknown","Array","decodeSearchRows","decodeWorkingMemoryRows","toEntry","row","resourceId","threadId","createdAt","toVectorLiteral","embedding","JSON","stringify","migrationStatements","prefix","dimensions","workingMemoryParams","key","scope","acquireClient","options","Effect","succeed","client","acquireRelease","promise","default","pg","Pool","connectionString","pool","end","pgMemoryAdapter","Layer","scoped","Memory","gen","tablePrefix","test","dieMessage","entries","working","run","operation","sql","params","tryPromise","try","query","catch","cause","MemoryStorageError","decoded","decoder","rows","pipe","mapError","forEach","statement","orDie","neighborsOf","entry","range","result","map","store","input","now","Clock","currentTimeMillis","crypto","randomUUID","search","threshold","topK","matches","push","neighbors","messageRange","remove","asVoid","getWorkingMemory","Option","fromNullable","setWorkingMemory","exports"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dts/index.d.ts

@@ -0,0 +1,38 @@
+/** eve-memory-pg — Postgres/pgvector storage adapter for eve-memory */
+import { Layer } from "effect";
+import { Memory } from "eve-memory";
+/**
+ * The minimal query surface the adapter needs. Structurally satisfied by
+ * `pg.Pool`, `pg.Client`, Neon's serverless driver, and PGlite — pass
+ * whichever client your deployment already has.
+ */
+export interface PgQuerier {
+    readonly query: (sql: string, params?: Array<unknown>) => Promise<{
+        rows: Array<unknown>;
+    }>;
+}
+export type PgConnection = 
+/** Use an existing client/pool. The caller owns its lifecycle. */
+{
+    readonly client: PgQuerier;
+}
+/** Create a `pg.Pool` from a connection string. Requires `pg` installed; closed on dispose. */
+ | {
+    readonly connectionString: string;
+};
+export type PgMemoryAdapterOptions = PgConnection & {
+    /**
+     * Embedding dimension of the `vector` column — must match your embedder
+     * (e.g. 1536 for openai/text-embedding-3-small).
+     */
+    readonly dimensions: number;
+    /** Table name prefix (default "eve_memory"). Lowercase letters, digits, underscores. */
+    readonly tablePrefix?: string;
+};
+/**
+ * Postgres storage adapter backed by pgvector cosine distance. The layer
+ * runs an idempotent migration at construction; connection and migration
+ * failures are configuration errors and fail fast (die).
+ */
+export declare const pgMemoryAdapter: (options: PgMemoryAdapterOptions) => Layer.Layer<Memory>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EAAiB,KAAK,EAAoC,MAAM,QAAQ,CAAA;AAC/E,OAAO,EAAE,MAAM,EAAsB,MAAM,YAAY,CAAA;AAQvD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CAC5F;AAED,MAAM,MAAM,YAAY;AACtB,kEAAkE;AAChE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE;AAChC,+FAA+F;GAC7F;IAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzC,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG;IAClD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AA4ED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAuIjF,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,150 @@
+/** eve-memory-pg — Postgres/pgvector storage adapter for eve-memory */
+import { Clock, Effect, Layer, Option, Schema } from "effect";
+import { Memory, MemoryStorageError } from "eve-memory";
+const EntryRow = /*#__PURE__*/Schema.Struct({
+  id: Schema.String,
+  resource_id: Schema.String,
+  thread_id: Schema.String,
+  content: Schema.String,
+  created_at: /*#__PURE__*/Schema.Union(Schema.DateFromSelf, Schema.Date)
+});
+const SearchRow = /*#__PURE__*/Schema.Struct({
+  ...EntryRow.fields,
+  score: Schema.Number
+});
+const WorkingMemoryRow = /*#__PURE__*/Schema.Struct({
+  content: Schema.String
+});
+const decodeEntryRows = /*#__PURE__*/Schema.decodeUnknown(/*#__PURE__*/Schema.Array(EntryRow));
+const decodeSearchRows = /*#__PURE__*/Schema.decodeUnknown(/*#__PURE__*/Schema.Array(SearchRow));
+const decodeWorkingMemoryRows = /*#__PURE__*/Schema.decodeUnknown(/*#__PURE__*/Schema.Array(WorkingMemoryRow));
+const toEntry = row => ({
+  id: row.id,
+  resourceId: row.resource_id,
+  threadId: row.thread_id,
+  content: row.content,
+  createdAt: row.created_at
+});
+/** pgvector accepts the JSON array literal syntax for vector values. */
+const toVectorLiteral = embedding => JSON.stringify(embedding);
+/**
+ * One statement per entry: PGlite (and other extended-protocol clients)
+ * reject multi-statement strings, and every statement is idempotent.
+ */
+const migrationStatements = (prefix, dimensions) => [`CREATE EXTENSION IF NOT EXISTS vector`, `CREATE TABLE IF NOT EXISTS ${prefix}_entries (
+    id text PRIMARY KEY,
+    resource_id text NOT NULL,
+    thread_id text NOT NULL,
+    content text NOT NULL,
+    embedding vector(${dimensions}) NOT NULL,
+    seq bigint GENERATED ALWAYS AS IDENTITY,
+    created_at timestamptz NOT NULL
+  )`, `CREATE INDEX IF NOT EXISTS ${prefix}_entries_scope_idx
+    ON ${prefix}_entries (resource_id, thread_id)`, `CREATE TABLE IF NOT EXISTS ${prefix}_working (
+    scope text NOT NULL,
+    resource_id text NOT NULL,
+    thread_id text NOT NULL,
+    content text NOT NULL,
+    updated_at timestamptz NOT NULL,
+    PRIMARY KEY (scope, resource_id, thread_id)
+  )`];
+/** Working-memory rows use thread_id = '' for resource scope, keeping one natural key. */
+const workingMemoryParams = key => [key.scope, key.resourceId, key.scope === "resource" ? "" : key.threadId];
+const acquireClient = options => "client" in options ? Effect.succeed(options.client) : Effect.acquireRelease(Effect.promise(async () => {
+  const {
+    default: pg
+  } = await import("pg");
+  return new pg.Pool({
+    connectionString: options.connectionString
+  });
+}), pool => Effect.promise(() => pool.end()));
+/**
+ * Postgres storage adapter backed by pgvector cosine distance. The layer
+ * runs an idempotent migration at construction; connection and migration
+ * failures are configuration errors and fail fast (die).
+ */
+export const pgMemoryAdapter = options => Layer.scoped(Memory, Effect.gen(function* () {
+  const prefix = options.tablePrefix ?? "eve_memory";
+  if (!/^[a-z_][a-z0-9_]*$/.test(prefix)) {
+    return yield* Effect.dieMessage(`eve-memory-pg: invalid tablePrefix "${prefix}" — use lowercase letters, digits, underscores`);
+  }
+  const entries = `${prefix}_entries`;
+  const working = `${prefix}_working`;
+  const client = yield* acquireClient(options);
+  const run = (operation, sql, params) => Effect.tryPromise({
+    try: () => client.query(sql, params),
+    catch: cause => new MemoryStorageError({
+      operation,
+      cause
+    })
+  });
+  const decoded = (operation, decoder) => rows => decoder(rows).pipe(Effect.mapError(cause => new MemoryStorageError({
+    operation,
+    cause
+  })));
+  yield* Effect.forEach(migrationStatements(prefix, options.dimensions), statement => Effect.promise(() => client.query(statement))).pipe(Effect.orDie);
+  const neighborsOf = (entry, range) => Effect.gen(function* () {
+    if (range <= 0) return [];
+    const result = yield* run("search", `WITH thread AS (
+               SELECT id, resource_id, thread_id, content, created_at,
+                      row_number() OVER (ORDER BY seq) AS rn
+               FROM ${entries}
+               WHERE resource_id = $1 AND thread_id = $2
+             ), anchor AS (
+               SELECT rn FROM thread WHERE id = $3
+             )
+             SELECT t.id, t.resource_id, t.thread_id, t.content, t.created_at
+             FROM thread t, anchor a
+             WHERE t.rn BETWEEN a.rn - $4 AND a.rn + $4 AND t.id <> $3
+             ORDER BY t.rn`, [entry.resourceId, entry.threadId, entry.id, range]);
+    const rows = yield* decoded("search", decodeEntryRows)(result.rows);
+    return rows.map(toEntry);
+  });
+  return {
+    store: input => Effect.gen(function* () {
+      const now = yield* Clock.currentTimeMillis;
+      const entry = {
+        id: `mem_${crypto.randomUUID()}`,
+        resourceId: input.resourceId,
+        threadId: input.threadId,
+        content: input.content,
+        createdAt: new Date(now)
+      };
+      yield* run("store", `INSERT INTO ${entries} (id, resource_id, thread_id, content, embedding, created_at)
+               VALUES ($1, $2, $3, $4, $5::vector, $6)`, [entry.id, entry.resourceId, entry.threadId, entry.content, toVectorLiteral(input.embedding), entry.createdAt]);
+      return entry;
+    }),
+    search: input => Effect.gen(function* () {
+      const result = yield* run("search", `SELECT id, resource_id, thread_id, content, created_at,
+                      1 - (embedding <=> $1::vector) AS score
+               FROM ${entries}
+               WHERE resource_id = $2
+                 AND ($3::text IS NULL OR thread_id = $3)
+                 AND 1 - (embedding <=> $1::vector) >= $4
+               ORDER BY embedding <=> $1::vector
+               LIMIT $5`, [toVectorLiteral(input.embedding), input.resourceId, input.scope === "thread" ? input.threadId : null, input.threshold, input.topK]);
+      const rows = yield* decoded("search", decodeSearchRows)(result.rows);
+      const matches = [];
+      for (const row of rows) {
+        const entry = toEntry(row);
+        matches.push({
+          entry,
+          score: row.score,
+          neighbors: yield* neighborsOf(entry, input.messageRange)
+        });
+      }
+      return matches;
+    }),
+    remove: id => run("remove", `DELETE FROM ${entries} WHERE id = $1`, [id]).pipe(Effect.asVoid),
+    getWorkingMemory: key => Effect.gen(function* () {
+      const result = yield* run("getWorkingMemory", `SELECT content FROM ${working} WHERE scope = $1 AND resource_id = $2 AND thread_id = $3`, workingMemoryParams(key));
+      const rows = yield* decoded("getWorkingMemory", decodeWorkingMemoryRows)(result.rows);
+      return Option.fromNullable(rows[0]?.content);
+    }),
+    setWorkingMemory: (key, content) => run("setWorkingMemory", `INSERT INTO ${working} (scope, resource_id, thread_id, content, updated_at)
+             VALUES ($1, $2, $3, $4, now())
+             ON CONFLICT (scope, resource_id, thread_id)
+             DO UPDATE SET content = EXCLUDED.content, updated_at = now()`, [...workingMemoryParams(key), content]).pipe(Effect.asVoid)
+  };
+}));
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Clock","Effect","Layer","Option","Schema","Memory","MemoryStorageError","EntryRow","Struct","id","String","resource_id","thread_id","content","created_at","Union","DateFromSelf","Date","SearchRow","fields","score","Number","WorkingMemoryRow","decodeEntryRows","decodeUnknown","Array","decodeSearchRows","decodeWorkingMemoryRows","toEntry","row","resourceId","threadId","createdAt","toVectorLiteral","embedding","JSON","stringify","migrationStatements","prefix","dimensions","workingMemoryParams","key","scope","acquireClient","options","succeed","client","acquireRelease","promise","default","pg","Pool","connectionString","pool","end","pgMemoryAdapter","scoped","gen","tablePrefix","test","dieMessage","entries","working","run","operation","sql","params","tryPromise","try","query","catch","cause","decoded","decoder","rows","pipe","mapError","forEach","statement","orDie","neighborsOf","entry","range","result","map","store","input","now","currentTimeMillis","crypto","randomUUID","search","threshold","topK","matches","push","neighbors","messageRange","remove","asVoid","getWorkingMemory","fromNullable","setWorkingMemory"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": []
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "eve-memory-pg",
+  "version": "0.1.0",
+  "description": "Postgres/pgvector storage adapter for eve-memory",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/katungi/eve-memory.git",
+    "directory": "packages/adapter-pg"
+  },
+  "sideEffects": [],
+  "dependencies": {
+    "effect": "^3.10.7"
+  },
+  "peerDependencies": {
+    "pg": "^8.11.0",
+    "eve-memory": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    }
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/dts/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/dts/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/cjs/index.js"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,251 @@
+/** eve-memory-pg — Postgres/pgvector storage adapter for eve-memory */
+
+import { Clock, Effect, Layer, Option, type ParseResult, Schema } from "effect"
+import { Memory, MemoryStorageError } from "eve-memory"
+import type {
+  MemoryEntry,
+  MemorySearchResult,
+  SearchMemoryInput,
+  WorkingMemoryKey
+} from "eve-memory"
+
+/**
+ * The minimal query surface the adapter needs. Structurally satisfied by
+ * `pg.Pool`, `pg.Client`, Neon's serverless driver, and PGlite — pass
+ * whichever client your deployment already has.
+ */
+export interface PgQuerier {
+  readonly query: (sql: string, params?: Array<unknown>) => Promise<{ rows: Array<unknown> }>
+}
+
+export type PgConnection =
+  /** Use an existing client/pool. The caller owns its lifecycle. */
+  | { readonly client: PgQuerier }
+  /** Create a `pg.Pool` from a connection string. Requires `pg` installed; closed on dispose. */
+  | { readonly connectionString: string }
+
+export type PgMemoryAdapterOptions = PgConnection & {
+  /**
+   * Embedding dimension of the `vector` column — must match your embedder
+   * (e.g. 1536 for openai/text-embedding-3-small).
+   */
+  readonly dimensions: number
+  /** Table name prefix (default "eve_memory"). Lowercase letters, digits, underscores. */
+  readonly tablePrefix?: string
+}
+
+type Operation = ConstructorParameters<typeof MemoryStorageError>[0]["operation"]
+
+const EntryRow = Schema.Struct({
+  id: Schema.String,
+  resource_id: Schema.String,
+  thread_id: Schema.String,
+  content: Schema.String,
+  created_at: Schema.Union(Schema.DateFromSelf, Schema.Date)
+})
+
+const SearchRow = Schema.Struct({ ...EntryRow.fields, score: Schema.Number })
+
+const WorkingMemoryRow = Schema.Struct({ content: Schema.String })
+
+const decodeEntryRows = Schema.decodeUnknown(Schema.Array(EntryRow))
+const decodeSearchRows = Schema.decodeUnknown(Schema.Array(SearchRow))
+const decodeWorkingMemoryRows = Schema.decodeUnknown(Schema.Array(WorkingMemoryRow))
+
+const toEntry = (row: typeof EntryRow.Type): MemoryEntry => ({
+  id: row.id,
+  resourceId: row.resource_id,
+  threadId: row.thread_id,
+  content: row.content,
+  createdAt: row.created_at
+})
+
+/** pgvector accepts the JSON array literal syntax for vector values. */
+const toVectorLiteral = (embedding: ReadonlyArray<number>) => JSON.stringify(embedding)
+
+/**
+ * One statement per entry: PGlite (and other extended-protocol clients)
+ * reject multi-statement strings, and every statement is idempotent.
+ */
+const migrationStatements = (prefix: string, dimensions: number): ReadonlyArray<string> => [
+  `CREATE EXTENSION IF NOT EXISTS vector`,
+  `CREATE TABLE IF NOT EXISTS ${prefix}_entries (
+    id text PRIMARY KEY,
+    resource_id text NOT NULL,
+    thread_id text NOT NULL,
+    content text NOT NULL,
+    embedding vector(${dimensions}) NOT NULL,
+    seq bigint GENERATED ALWAYS AS IDENTITY,
+    created_at timestamptz NOT NULL
+  )`,
+  `CREATE INDEX IF NOT EXISTS ${prefix}_entries_scope_idx
+    ON ${prefix}_entries (resource_id, thread_id)`,
+  `CREATE TABLE IF NOT EXISTS ${prefix}_working (
+    scope text NOT NULL,
+    resource_id text NOT NULL,
+    thread_id text NOT NULL,
+    content text NOT NULL,
+    updated_at timestamptz NOT NULL,
+    PRIMARY KEY (scope, resource_id, thread_id)
+  )`
+]
+
+/** Working-memory rows use thread_id = '' for resource scope, keeping one natural key. */
+const workingMemoryParams = (key: WorkingMemoryKey) => [
+  key.scope,
+  key.resourceId,
+  key.scope === "resource" ? "" : key.threadId
+]
+
+const acquireClient = (options: PgMemoryAdapterOptions) =>
+  "client" in options
+    ? Effect.succeed(options.client)
+    : Effect.acquireRelease(
+      Effect.promise(async () => {
+        const { default: pg } = await import("pg")
+        return new pg.Pool({ connectionString: options.connectionString })
+      }),
+      (pool) => Effect.promise(() => pool.end())
+    )
+
+/**
+ * Postgres storage adapter backed by pgvector cosine distance. The layer
+ * runs an idempotent migration at construction; connection and migration
+ * failures are configuration errors and fail fast (die).
+ */
+export const pgMemoryAdapter = (options: PgMemoryAdapterOptions): Layer.Layer<Memory> =>
+  Layer.scoped(
+    Memory,
+    Effect.gen(function*() {
+      const prefix = options.tablePrefix ?? "eve_memory"
+      if (!/^[a-z_][a-z0-9_]*$/.test(prefix)) {
+        return yield* Effect.dieMessage(
+          `eve-memory-pg: invalid tablePrefix "${prefix}" — use lowercase letters, digits, underscores`
+        )
+      }
+      const entries = `${prefix}_entries`
+      const working = `${prefix}_working`
+
+      const client = yield* acquireClient(options)
+
+      const run = (operation: Operation, sql: string, params?: Array<unknown>) =>
+        Effect.tryPromise({
+          try: () => client.query(sql, params),
+          catch: (cause) => new MemoryStorageError({ operation, cause })
+        })
+
+      const decoded = <A>(
+        operation: Operation,
+        decoder: (rows: unknown) => Effect.Effect<A, ParseResult.ParseError>
+      ) =>
+      (rows: Array<unknown>) =>
+        decoder(rows).pipe(
+          Effect.mapError((cause) => new MemoryStorageError({ operation, cause }))
+        )
+
+      yield* Effect.forEach(
+        migrationStatements(prefix, options.dimensions),
+        (statement) => Effect.promise(() => client.query(statement))
+      ).pipe(Effect.orDie)
+
+      const neighborsOf = (entry: MemoryEntry, range: number) =>
+        Effect.gen(function*() {
+          if (range <= 0) return [] as ReadonlyArray<MemoryEntry>
+          const result = yield* run(
+            "search",
+            `WITH thread AS (
+               SELECT id, resource_id, thread_id, content, created_at,
+                      row_number() OVER (ORDER BY seq) AS rn
+               FROM ${entries}
+               WHERE resource_id = $1 AND thread_id = $2
+             ), anchor AS (
+               SELECT rn FROM thread WHERE id = $3
+             )
+             SELECT t.id, t.resource_id, t.thread_id, t.content, t.created_at
+             FROM thread t, anchor a
+             WHERE t.rn BETWEEN a.rn - $4 AND a.rn + $4 AND t.id <> $3
+             ORDER BY t.rn`,
+            [entry.resourceId, entry.threadId, entry.id, range]
+          )
+          const rows = yield* decoded("search", decodeEntryRows)(result.rows)
+          return rows.map(toEntry)
+        })
+
+      return {
+        store: (input) =>
+          Effect.gen(function*() {
+            const now = yield* Clock.currentTimeMillis
+            const entry: MemoryEntry = {
+              id: `mem_${crypto.randomUUID()}`,
+              resourceId: input.resourceId,
+              threadId: input.threadId,
+              content: input.content,
+              createdAt: new Date(now)
+            }
+            yield* run(
+              "store",
+              `INSERT INTO ${entries} (id, resource_id, thread_id, content, embedding, created_at)
+               VALUES ($1, $2, $3, $4, $5::vector, $6)`,
+              [entry.id, entry.resourceId, entry.threadId, entry.content, toVectorLiteral(input.embedding), entry.createdAt]
+            )
+            return entry
+          }),
+
+        search: (input: SearchMemoryInput) =>
+          Effect.gen(function*() {
+            const result = yield* run(
+              "search",
+              `SELECT id, resource_id, thread_id, content, created_at,
+                      1 - (embedding <=> $1::vector) AS score
+               FROM ${entries}
+               WHERE resource_id = $2
+                 AND ($3::text IS NULL OR thread_id = $3)
+                 AND 1 - (embedding <=> $1::vector) >= $4
+               ORDER BY embedding <=> $1::vector
+               LIMIT $5`,
+              [
+                toVectorLiteral(input.embedding),
+                input.resourceId,
+                input.scope === "thread" ? input.threadId : null,
+                input.threshold,
+                input.topK
+              ]
+            )
+            const rows = yield* decoded("search", decodeSearchRows)(result.rows)
+            const matches: Array<MemorySearchResult> = []
+            for (const row of rows) {
+              const entry = toEntry(row)
+              matches.push({
+                entry,
+                score: row.score,
+                neighbors: yield* neighborsOf(entry, input.messageRange)
+              })
+            }
+            return matches
+          }),
+
+        remove: (id) => run("remove", `DELETE FROM ${entries} WHERE id = $1`, [id]).pipe(Effect.asVoid),
+
+        getWorkingMemory: (key) =>
+          Effect.gen(function*() {
+            const result = yield* run(
+              "getWorkingMemory",
+              `SELECT content FROM ${working} WHERE scope = $1 AND resource_id = $2 AND thread_id = $3`,
+              workingMemoryParams(key)
+            )
+            const rows = yield* decoded("getWorkingMemory", decodeWorkingMemoryRows)(result.rows)
+            return Option.fromNullable(rows[0]?.content)
+          }),
+
+        setWorkingMemory: (key, content) =>
+          run(
+            "setWorkingMemory",
+            `INSERT INTO ${working} (scope, resource_id, thread_id, content, updated_at)
+             VALUES ($1, $2, $3, $4, now())
+             ON CONFLICT (scope, resource_id, thread_id)
+             DO UPDATE SET content = EXCLUDED.content, updated_at = now()`,
+            [...workingMemoryParams(key), content]
+          ).pipe(Effect.asVoid)
+      }
+    })
+  )