@skein-js/server-kit 0.12.0 → 0.13.1

package/README.md

@@ -1,5 +1,7 @@
 # @skein-js/server-kit
 
+[![npm](https://img.shields.io/npm/v/%40skein-js%2Fserver-kit?logo=npm&color=cb3837)](https://www.npmjs.com/package/@skein-js/server-kit) [![downloads](https://img.shields.io/npm/dm/%40skein-js%2Fserver-kit?color=blue)](https://www.npmjs.com/package/@skein-js/server-kit) [![license](https://img.shields.io/npm/l/%40skein-js%2Fserver-kit?color=green)](../../LICENSE)
+
 > Shared, framework-agnostic building blocks for skein-js HTTP adapters.
 
 Part of **[skein-js](../../README.md)** — the open-source alternative to LangGraph Platform for TypeScript: a self-hosted [Agent Protocol](https://github.com/langchain-ai/agent-protocol) server for [LangGraph.js](https://github.com/langchain-ai/langgraphjs), and a drop-in replacement for the LangGraph CLI.
@@ -107,9 +109,16 @@ Pass `overrides` to swap in production drivers or an auth engine while keeping t
 - **`resolveMaxPageSize(explicit?, env?): number`** — the same chain for the store page bound:
   explicit `maxPageSize` → `SKEIN_MAX_PAGE_SIZE` → `DEFAULT_MAX_PAGE_SIZE` (1000). Every driver applies
   it to list/search, including when the caller asks for no limit.
+- **`resolveStoreTtl(raw?)` / `resolveThreadTtl(raw?)`** — map the `langgraph.json` `store.ttl` and
+  `checkpointer.ttl` blocks (snake_case, minutes) onto the drivers' camelCase `StoreTtlConfig` /
+  `ThreadTtlConfig`; `undefined` when unset, so nothing expires unless asked. Plus the raw input types
+  `RawStoreTtl` / `RawThreadTtl`. They live here rather than in `@skein-js/runtime` because **both**
+  assembly paths need them and neither owns the other — resolving a block in only one is how a TTL
+  came to work under `skein start` and silently do nothing under `skein dev`.
 - **`loadInMemoryRuntime` / `loadReloadableInMemoryRuntime`** — assemble a `ProtocolDeps` from a
-  `langgraph.json` using in-process drivers. The reloadable variant adds `reloadGraphs` /
-  `snapshotState` / `hydrateState` (what powers `skein dev`'s hot reload + cross-restart persistence).
+  `langgraph.json` using in-process drivers, reading both TTL blocks itself. The reloadable variant
+  adds `reloadGraphs` / `snapshotState` / `hydrateState` (what powers `skein dev`'s hot reload +
+  cross-restart persistence).
 - **`readLanggraphDevState` / `loadSnapshotIntoStore` / `describeSnapshot`** — read an existing
   `.langgraph_api/` directory and reconstruct a `DevStateSnapshot`, so adopting skein carries local
   state over losslessly.

package/dist/{chunk-QOHYARHD.js → chunk-LJGZJ5L7.js}

@@ -155,6 +155,27 @@ function embedInMemoryGraphs(graphs, overrides = {}) {
 }
 var createInMemoryDeps = embedInMemoryGraphs;
 
+// src/ttl-config.ts
+function resolveThreadTtl(raw) {
+  if (!raw) return void 0;
+  const ttl = {};
+  if (typeof raw.default_ttl === "number") ttl.defaultTtl = raw.default_ttl;
+  if (typeof raw.sweep_interval_minutes === "number") {
+    ttl.sweepIntervalMinutes = raw.sweep_interval_minutes;
+  }
+  return Object.keys(ttl).length > 0 ? ttl : void 0;
+}
+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;
+}
+
 // src/in-memory-runtime.ts
 function toGraphResolver(graphs) {
   return {
@@ -185,7 +206,13 @@ async function loadReloadableInMemoryRuntime(configPath, importModule, staticSch
     load: (graphId) => current.load(graphId),
     schemas: async (graphId) => await current.schemas(graphId)
   };
-  const store = new MemorySkeinStore2({ maxPageSize: resolveMaxPageSize() });
+  const threadTtl = resolveThreadTtl(first.config.checkpointer?.ttl);
+  const storeTtl = resolveStoreTtl(first.config.store?.ttl);
+  const store = new MemorySkeinStore2({
+    maxPageSize: resolveMaxPageSize(),
+    ...threadTtl ? { threadTtl } : {},
+    ...storeTtl ? { ttl: storeTtl } : {}
+  });
   const checkpointer = new MemorySaver2();
   const deps = {
     store,
@@ -196,6 +223,8 @@ async function loadReloadableInMemoryRuntime(configPath, importModule, staticSch
     bus: new MemoryRunEventBus2(resolveMemoryBusLimits()),
     checkpointer,
     auth: await loadAuthEngine(first.config.auth, { configDir: first.configDir, importModule }),
+    // Present only when configured — its presence is what starts the thread TTL sweeper.
+    ...threadTtl ? { threadTtl } : {},
     ...extraDeps
   };
   return {
@@ -232,6 +261,8 @@ export {
   graphMapToResolver,
   embedInMemoryGraphs,
   createInMemoryDeps,
+  resolveThreadTtl,
+  resolveStoreTtl,
   loadInMemoryRuntime,
   loadReloadableInMemoryRuntime
 };

package/dist/{in-memory-runtime-32UYJRVJ.js → in-memory-runtime-KII6KQ4U.js}

@@ -1,7 +1,7 @@
 import {
   loadInMemoryRuntime,
   loadReloadableInMemoryRuntime
-} from "./chunk-QOHYARHD.js";
+} from "./chunk-LJGZJ5L7.js";
 import "./chunk-JUBBCC7R.js";
 export {
   loadInMemoryRuntime,

package/dist/index.d.ts

@@ -6,9 +6,9 @@ export { CorsOptions } from 'cors';
 import { MemoryRunEventBusOptions } from '@skein-js/storage-memory';
 import { D as DevStateSnapshot } from './dev-BfYYRfEB.js';
 export { a as DevStateCounts } from './dev-BfYYRfEB.js';
+import { StoreTtlConfig, ThreadTtlConfig } from '@skein-js/core';
 import { CompiledGraph } from '@langchain/langgraph';
 import { ServerResponse } from 'node:http';
-import '@skein-js/core';
 
 interface SkeinRuntimeCommonOptions {
     /**
@@ -454,6 +454,32 @@ declare function loadReloadableInMemoryRuntime(configPath: string, importModule?
  */
 extraDeps?: Partial<Omit<ProtocolDeps, "graphs">>): Promise<ReloadableInMemoryRuntime>;
 
+/** The raw `checkpointer.ttl` block as `langgraph.json` spells it. */
+interface RawThreadTtl {
+    default_ttl?: number;
+    strategy?: "delete";
+    sweep_interval_minutes?: number;
+}
+/**
+ * Map the raw block to {@link ThreadTtlConfig}, or `undefined` when nothing is set — so threads never
+ * expire unless asked to, and no sweeper is started.
+ *
+ * `strategy` is read only to be validated by the config schema: `"delete"` is the only thing an
+ * expired thread can become, so there is nothing for the drivers to branch on.
+ */
+declare function resolveThreadTtl(raw: RawThreadTtl | undefined): ThreadTtlConfig | undefined;
+/** The raw `store.ttl` block as `langgraph.json` spells it. */
+interface RawStoreTtl {
+    default_ttl?: number;
+    refresh_on_read?: boolean;
+    sweep_interval_minutes?: number;
+}
+/**
+ * Map the raw `store.ttl` block to {@link StoreTtlConfig}, or `undefined` when nothing is set — so
+ * store items never expire unless asked to.
+ */
+declare function resolveStoreTtl(raw: RawStoreTtl | undefined): StoreTtlConfig | undefined;
+
 type AnyCompiledGraph = CompiledGraph<any>;
 /**
  * A graph you can embed in code: any compiled LangGraph.js graph, or a factory that builds one per run
@@ -649,4 +675,4 @@ type RuntimeGlobal = typeof globalThis & {
 /** Detect Node, Bun, or Deno without importing a runtime-specific module. */
 declare function detectRuntimeCapabilities(scope?: RuntimeGlobal): RuntimeCapabilities;
 
-export { type ConsoleLogLevel, type ConsoleLoggerOptions, type CorsSetting, DEFAULT_HEAP_SAMPLE_MS, DEFAULT_HEAP_WARN_PERCENT, DevStateSnapshot, type EmbeddableGraph, type FileReader, HEAP_REARM_MARGIN_PERCENT, HEAP_REARM_PERCENT, type HeapHeadroom, type HeapPressureContext, type HeapPressureMonitor, type HeapPressureMonitorOptions, type InMemoryRuntimeConfig, type IntervalHandle, type LanggraphCorsConfig, type ReloadableInMemoryRuntime, type ResolvedMemoryBusLimits, type ResolvedProtocolRuntime, type ResolvedRuntimeDeps, type RuntimeCapabilities, type RuntimeMemorySnapshot, type RuntimeSignalSubscription, type SkeinRuntimeCommonOptions, type SkeinRuntimeOptions, allowedOrigin, applyNodeCors, checkHeapHeadroom, corsFromHttpConfig, corsPreflightHeaders, corsResponseHeaders, createConsoleLogger, createInMemoryDeps, describeError, describeHeapHeadroom, describePoolPressure, detectRuntimeCapabilities, disabledRoutesFromHttpConfig, embedInMemoryGraphs, formatLogMeta, graphMapToResolver, joinList, loadInMemoryRuntime, loadReloadableInMemoryRuntime, normalizeEmbeddableGraphs, readContainerMemoryLimit, resolveCronTickMs, resolveHeapPressureOptions, resolveMaxPageSize, resolveMemoryBusLimits, resolveProtocolRuntime, resolveRunConcurrency, resolveRunTimeoutMs, resolveRuntimeDeps, resolveShutdownGraceMs, routeMatcherFor, routesFromHttpConfig, runFailureIdentity, sendNodeError, sendNodePreflight, sendNodeResponse, startHeapPressureMonitor, stripBasePath, toCorsOptions };
+export { type ConsoleLogLevel, type ConsoleLoggerOptions, type CorsSetting, DEFAULT_HEAP_SAMPLE_MS, DEFAULT_HEAP_WARN_PERCENT, DevStateSnapshot, type EmbeddableGraph, type FileReader, HEAP_REARM_MARGIN_PERCENT, HEAP_REARM_PERCENT, type HeapHeadroom, type HeapPressureContext, type HeapPressureMonitor, type HeapPressureMonitorOptions, type InMemoryRuntimeConfig, type IntervalHandle, type LanggraphCorsConfig, type RawStoreTtl, type RawThreadTtl, type ReloadableInMemoryRuntime, type ResolvedMemoryBusLimits, type ResolvedProtocolRuntime, type ResolvedRuntimeDeps, type RuntimeCapabilities, type RuntimeMemorySnapshot, type RuntimeSignalSubscription, type SkeinRuntimeCommonOptions, type SkeinRuntimeOptions, allowedOrigin, applyNodeCors, checkHeapHeadroom, corsFromHttpConfig, corsPreflightHeaders, corsResponseHeaders, createConsoleLogger, createInMemoryDeps, describeError, describeHeapHeadroom, describePoolPressure, detectRuntimeCapabilities, disabledRoutesFromHttpConfig, embedInMemoryGraphs, formatLogMeta, graphMapToResolver, joinList, loadInMemoryRuntime, loadReloadableInMemoryRuntime, normalizeEmbeddableGraphs, readContainerMemoryLimit, resolveCronTickMs, resolveHeapPressureOptions, resolveMaxPageSize, resolveMemoryBusLimits, resolveProtocolRuntime, resolveRunConcurrency, resolveRunTimeoutMs, resolveRuntimeDeps, resolveShutdownGraceMs, resolveStoreTtl, resolveThreadTtl, routeMatcherFor, routesFromHttpConfig, runFailureIdentity, sendNodeError, sendNodePreflight, sendNodeResponse, startHeapPressureMonitor, stripBasePath, toCorsOptions };

package/dist/index.js

@@ -11,9 +11,11 @@ import {
   requirePositiveInteger,
   resolveMaxPageSize,
   resolveMemoryBusLimits,
+  resolveStoreTtl,
+  resolveThreadTtl,
   routesFromHttpConfig,
   toCorsOptions
-} from "./chunk-QOHYARHD.js";
+} from "./chunk-LJGZJ5L7.js";
 import "./chunk-JUBBCC7R.js";
 
 // src/resolve-runtime.ts
@@ -162,7 +164,7 @@ function resolveLogger(option, injected, frameworkLogger) {
   return option ?? frameworkLogger;
 }
 async function resolveRuntimeDeps(options, frameworkLogger) {
-  const loaded = options.deps ? { deps: options.deps, cors: void 0, routes: skeinRoutes } : await (await import("./in-memory-runtime-32UYJRVJ.js")).loadInMemoryRuntime(options.config, options.importModule);
+  const loaded = options.deps ? { deps: options.deps, cors: void 0, routes: skeinRoutes } : await (await import("./in-memory-runtime-KII6KQ4U.js")).loadInMemoryRuntime(options.config, options.importModule);
   const logger = resolveLogger(options.logger, loaded.deps.logger, frameworkLogger);
   if (logger && !loaded.deps.logger) loaded.deps.logger = logger;
   return { deps: loaded.deps, cors: loaded.cors, routes: loaded.routes, logger };
@@ -680,6 +682,8 @@ export {
   resolveRunTimeoutMs,
   resolveRuntimeDeps,
   resolveShutdownGraceMs,
+  resolveStoreTtl,
+  resolveThreadTtl,
   routeMatcherFor,
   routesFromHttpConfig,
   runFailureIdentity,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/server-kit",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Shared, framework-agnostic building blocks for skein-js HTTP adapters — in-memory dev runtime, LangGraph dev-state import, and langgraph.json CORS mapping.",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -49,10 +49,10 @@
     "cors": "^2.8.5",
     "superjson": "^2.2.6",
     "zod": "^3.25.76",
-    "@skein-js/agent-protocol": "0.12.0",
-    "@skein-js/config": "0.12.0",
-    "@skein-js/storage-memory": "0.12.0",
-    "@skein-js/core": "0.12.0"
+    "@skein-js/core": "0.13.1",
+    "@skein-js/storage-memory": "0.13.1",
+    "@skein-js/config": "0.13.1",
+    "@skein-js/agent-protocol": "0.13.1"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0"