@skein-js/runtime 0.3.0 → 0.4.0

package/README.md

@@ -20,8 +20,8 @@ import { createExpressServer } from "@skein-js/express";
 
 const runtime = await buildRuntime({
   configPath: "/abs/path/to/langgraph.json",
-  store: "postgres", // "memory" | "postgres"  (postgres reads DATABASE_URL)
-  queue: "redis", //    "memory" | "redis"     (redis reads REDIS_URL)
+  store: "postgres", // "memory" | "postgres"  (postgres reads POSTGRES_URI)
+  queue: "redis", //    "memory" | "redis"     (redis reads REDIS_URI)
 });
 
 const server = await createExpressServer({ deps: runtime.deps, cors: runtime.cors });
@@ -33,13 +33,13 @@ await runtime.dispose();
 `store` and `queue` are **required** (no defaults — the CLI supplies its own flag defaults). The
 driver branches:
 
-- **`store: "postgres"`** connects `PostgresSkeinStore` (from `DATABASE_URL`), runs its migrations,
+- **`store: "postgres"`** connects `PostgresSkeinStore` (from `POSTGRES_URI`), runs its migrations,
   and uses `PostgresSaver` as the LangGraph checkpointer.
-- **`queue: "redis"`** uses the BullMQ run queue + Redis Streams/pub-sub event bus (from `REDIS_URL`).
+- **`queue: "redis"`** uses the BullMQ run queue + Redis Streams/pub-sub event bus (from `REDIS_URI`).
 - **`store: "memory"` + `queue: "memory"`** delegates to [`@skein-js/express`](../server-express)'s
   reloadable in-memory runtime, so `skein dev`'s hot-reload and cross-restart state persistence work.
 
-A missing `DATABASE_URL` / `REDIS_URL` throws `RuntimeConfigError`; if assembly fails part-way, any
+A missing `POSTGRES_URI` / `REDIS_URI` throws `RuntimeConfigError`; if assembly fails part-way, any
 resources already created are disposed before rethrowing, so a failed build leaks nothing.
 
 Graph hot-reload (`reloadGraphs()`) works in every mode; `snapshotState`/`hydrateState` are present

package/dist/index.d.ts

@@ -13,9 +13,9 @@ interface BuildRuntimeOptions {
     configPath: string;
     /** TS-capable importer (e.g. the CLI's vite loader). Omitted for plain JS/Node resolution. */
     importModule?: ModuleImporter;
-    /** `"memory"` (default dev) or `"postgres"` (reads `DATABASE_URL`). */
+    /** `"memory"` (default dev) or `"postgres"` (reads `POSTGRES_URI`). */
     store: StoreDriver;
-    /** `"memory"` (default dev) or `"redis"` (reads `REDIS_URL`). */
+    /** `"memory"` (default dev) or `"redis"` (reads `REDIS_URI`). */
     queue: QueueDriver;
 }
 interface SkeinRuntime {

package/dist/index.js

@@ -165,9 +165,10 @@ async function buildRuntime(options) {
     await Promise.allSettled(disposers.map((dispose) => dispose()));
   };
   try {
+    const storeTtl = resolveStoreTtl(first.config.store?.ttl);
     const { skeinStore, checkpointer } = await (async () => {
       if (store === "postgres") {
-        const databaseUrl = requireEnv("DATABASE_URL", "postgres");
+        const databaseUrl = requireEnv("POSTGRES_URI", "postgres");
         const index = await resolveStoreIndex(first.config.store?.index, {
           configDir: first.configDir,
           importModule
@@ -175,6 +176,7 @@ async function buildRuntime(options) {
         const connectionOptions = postgresConnectionOptions();
         const pgStore = await PostgresSkeinStore.connect(databaseUrl, {
           ...index ? { index } : {},
+          ...storeTtl ? { ttl: storeTtl } : {},
           ...connectionOptions
         });
         disposers.push(() => pgStore.close());
@@ -184,11 +186,24 @@ async function buildRuntime(options) {
         await saver.setup();
         return { skeinStore: pgStore, checkpointer: saver };
       }
-      return { skeinStore: new MemorySkeinStore(), checkpointer: new MemorySaver() };
+      return {
+        skeinStore: new MemorySkeinStore(storeTtl ? { ttl: storeTtl } : void 0),
+        checkpointer: new MemorySaver()
+      };
     })();
+    if (storeTtl) {
+      const everyMs = (storeTtl.sweepIntervalMinutes ?? 60) * 6e4;
+      const sweeper = setInterval(() => {
+        skeinStore.store.sweepExpired().catch((error) => {
+          console.error("skein: store TTL sweep failed", error);
+        });
+      }, everyMs);
+      sweeper.unref();
+      disposers.push(async () => clearInterval(sweeper));
+    }
     const { runQueue, bus } = (() => {
       if (queue === "redis") {
-        const redisUrl = requireEnv("REDIS_URL", "redis");
+        const redisUrl = requireEnv("REDIS_URI", "redis");
         const redisQueue = new RedisRunQueue(redisUrl);
         disposers.push(() => redisQueue.dispose());
         const redisBus = new RedisRunEventBus(redisUrl);
@@ -221,6 +236,16 @@ async function buildRuntime(options) {
     throw error;
   }
 }
+function resolveStoreTtl(raw) {
+  if (!raw) return void 0;
+  const ttl = {};
+  if (typeof raw.default_ttl === "number") ttl.defaultTtl = raw.default_ttl;
+  if (typeof raw.refresh_on_read === "boolean") ttl.refreshOnRead = raw.refresh_on_read;
+  if (typeof raw.sweep_interval_minutes === "number") {
+    ttl.sweepIntervalMinutes = raw.sweep_interval_minutes;
+  }
+  return Object.keys(ttl).length > 0 ? ttl : void 0;
+}
 export {
   RuntimeConfigError,
   buildRuntime,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/runtime",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Assembles skein-js ProtocolDeps from langgraph.json + selected drivers (memory/Postgres/Redis).",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -42,12 +42,12 @@
   },
   "dependencies": {
     "cors": "^2.8.5",
-    "@skein-js/agent-protocol": "0.3.0",
-    "@skein-js/express": "0.3.0",
-    "@skein-js/config": "0.3.0",
-    "@skein-js/storage-memory": "0.3.0",
-    "@skein-js/storage-postgres": "0.3.0",
-    "@skein-js/redis": "0.3.0"
+    "@skein-js/agent-protocol": "0.4.0",
+    "@skein-js/config": "0.4.0",
+    "@skein-js/express": "0.4.0",
+    "@skein-js/storage-memory": "0.4.0",
+    "@skein-js/storage-postgres": "0.4.0",
+    "@skein-js/redis": "0.4.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",
@@ -58,7 +58,7 @@
     "@langchain/langgraph": "^1.4.0",
     "@langchain/langgraph-checkpoint-postgres": "^1.0.4",
     "@types/cors": "^2.8.17",
-    "@skein-js/test-support": "0.3.0"
+    "@skein-js/test-support": "0.4.0"
   },
   "publishConfig": {
     "access": "public"