@hexis-ai/engram-server 0.1.0 → 0.1.2

package/dist/adapters/postgres.d.ts

@@ -8,6 +8,8 @@ import { type StorageAdapter } from "../storage";
  */
 export interface SqlClient {
     <T = Record<string, unknown>>(strings: TemplateStringsArray, ...values: unknown[]): Promise<T[]>;
+    /** Raw query for DDL / multi-statement strings. */
+    unsafe: (query: string) => Promise<unknown>;
 }
 export interface PostgresAdapterOptions {
     /** Workspace scope baked into every row. Required for multi-tenant isolation. */
@@ -20,9 +22,7 @@ export declare class PostgresAdapter implements StorageAdapter {
     constructor(opts: PostgresAdapterOptions);
     /**
      * Create the schema. Call once at boot. Safe to invoke repeatedly.
-     * Postgres pg-tag template clients accept multi-statement strings via
-     * `sql.unsafe()` in the real driver; for portability we issue them
-     * separately so any tagged-template impl works.
+     * Uses `sql.unsafe()` to ship the multi-statement DDL as a single batch.
      */
     ensureSchema(): Promise<void>;
     createSession(init: SessionInit & {

package/dist/adapters/postgres.js

@@ -34,16 +34,10 @@ export class PostgresAdapter {
     }
     /**
      * Create the schema. Call once at boot. Safe to invoke repeatedly.
-     * Postgres pg-tag template clients accept multi-statement strings via
-     * `sql.unsafe()` in the real driver; for portability we issue them
-     * separately so any tagged-template impl works.
+     * Uses `sql.unsafe()` to ship the multi-statement DDL as a single batch.
      */
     async ensureSchema() {
-        const stmts = SCHEMA_SQL.split(/;\s*\n/).map((s) => s.trim()).filter(Boolean);
-        for (const stmt of stmts) {
-            // Tagged-template invocation with no interpolations.
-            await this.sql([stmt + ";"]);
-        }
+        await this.sql.unsafe(SCHEMA_SQL);
     }
     async createSession(init) {
         await this.sql `

package/dist/main.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    port: number;
+    fetch: (request: Request, Env?: unknown, executionCtx?: import("hono").ExecutionContext) => Response | Promise<Response>;
+};
+export default _default;

package/dist/main.js

@@ -0,0 +1,53 @@
+/**
+ * Production entrypoint.
+ *
+ * Reads configuration from environment:
+ *
+ *   ENGRAM_API_KEY      required        single bearer key. Multi-tenant deploys
+ *                                       should swap this for a real key store.
+ *   PORT                default 8080    HTTP listen port.
+ *   DATABASE_URL        optional        if set, uses PostgresAdapter; otherwise
+ *                                       falls back to InMemoryAdapter (NOT
+ *                                       durable across restarts).
+ *   DATABASE_SOCKET_PATH optional       Cloud SQL Auth Proxy unix socket dir.
+ *                                       When set, postgres connects via
+ *                                       `host=<DATABASE_SOCKET_PATH>`.
+ *   ENGRAM_WORKSPACE_ID default "default"
+ *                                       workspace id baked into the postgres
+ *                                       adapter for this single-tenant deploy.
+ */
+import { createServer } from "./server";
+import { InMemoryAdapter } from "./adapters/memory";
+import { PostgresAdapter } from "./adapters/postgres";
+const PORT = Number(process.env.PORT ?? 8080);
+const API_KEY = process.env.ENGRAM_API_KEY;
+const WORKSPACE_ID = process.env.ENGRAM_WORKSPACE_ID ?? "default";
+const DATABASE_URL = process.env.DATABASE_URL;
+const DATABASE_SOCKET_PATH = process.env.DATABASE_SOCKET_PATH;
+if (!API_KEY) {
+    console.error("[engram-server] ENGRAM_API_KEY is required");
+    process.exit(1);
+}
+const storage = await (async () => {
+    if (!DATABASE_URL) {
+        console.warn("[engram-server] DATABASE_URL not set — using InMemoryAdapter (data is volatile)");
+        return new InMemoryAdapter();
+    }
+    // postgres is a peer dep so we import it lazily; absence is a hard error here.
+    const { default: postgres } = await import("postgres");
+    const sql = DATABASE_SOCKET_PATH
+        ? postgres(DATABASE_URL, { host: DATABASE_SOCKET_PATH })
+        : postgres(DATABASE_URL);
+    const adapter = new PostgresAdapter({
+        workspaceId: WORKSPACE_ID,
+        sql: sql,
+    });
+    await adapter.ensureSchema();
+    console.log(`[engram-server] postgres adapter ready (workspace=${WORKSPACE_ID})`);
+    return adapter;
+})();
+const app = createServer({
+    auth: (key) => (key === API_KEY ? { workspaceId: WORKSPACE_ID, storage } : null),
+});
+console.log(`[engram-server] listening on :${PORT}`);
+export default { port: PORT, fetch: app.fetch };

package/dist/server.js

@@ -5,6 +5,19 @@ export function createServer(opts) {
     const defaultLimit = opts.defaultListLimit ?? 100;
     const maxLimit = opts.maxListLimit ?? 500;
     const app = new Hono();
+    // Unauthenticated service info. Useful for browser sanity checks and
+    // health probes (Cloud Run, k8s, uptime monitors).
+    app.get("/", (c) => c.json({
+        service: "@hexis-ai/engram-server",
+        ok: true,
+        routes: {
+            sessions: "POST/GET /v1/sessions",
+            sessionById: "GET /v1/sessions/:id",
+            events: "POST /v1/sessions/:id/events",
+            search: "POST /v1/search",
+        },
+    }));
+    app.get("/healthz", (c) => c.json({ ok: true }));
     app.use("/v1/*", async (c, next) => {
         const auth = c.req.header("authorization");
         const m = auth?.match(/^Bearer\s+(.+)$/i);

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@hexis-ai/engram-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Engram server: ingest agent session events, persist via a pluggable adapter, expose search.",
   "keywords": ["engram", "agents", "search", "hono", "postgres", "server"],
-  "homepage": "https://github.com/hexis-ai/engram#readme",
+  "homepage": "https://github.com/hexis-ltd/engram#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hexis-ai/engram.git",
+    "url": "git+https://github.com/hexis-ltd/engram.git",
     "directory": "packages/server"
   },
-  "bugs": "https://github.com/hexis-ai/engram/issues",
+  "bugs": "https://github.com/hexis-ltd/engram/issues",
   "author": "hexis ltd.",
   "license": "MIT",
   "type": "module",
@@ -41,8 +41,8 @@
     "dev": "bun --hot src/dev.ts"
   },
   "dependencies": {
-    "@hexis-ai/engram-core": "workspace:*",
-    "@hexis-ai/engram-sdk": "workspace:*",
+    "@hexis-ai/engram-core": "^0.1.2",
+    "@hexis-ai/engram-sdk": "^0.1.2",
     "hono": "^4.6.0"
   },
   "peerDependencies": {
@@ -51,6 +51,9 @@
   "peerDependenciesMeta": {
     "postgres": { "optional": true }
   },
+  "devDependencies": {
+    "postgres": "^3.4.0"
+  },
   "publishConfig": {
     "access": "public"
   }