@skein-js/config 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -53,6 +53,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         index: z.ZodOptional<z.ZodObject<{
             embed: z.ZodOptional<z.ZodString>;
@@ -67,6 +89,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         index: z.ZodOptional<z.ZodObject<{
             embed: z.ZodOptional<z.ZodString>;
@@ -81,6 +125,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, z.ZodTypeAny, "passthrough">>>;
     /** Checkpointer backend; `"default"` == Postgres, absent == in-memory. */
     checkpointer: z.ZodOptional<z.ZodObject<{
@@ -134,6 +200,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         index: z.ZodOptional<z.ZodObject<{
             embed: z.ZodOptional<z.ZodString>;
@@ -148,6 +236,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         index: z.ZodOptional<z.ZodObject<{
             embed: z.ZodOptional<z.ZodString>;
@@ -162,6 +272,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, z.ZodTypeAny, "passthrough">>>;
     /** Checkpointer backend; `"default"` == Postgres, absent == in-memory. */
     checkpointer: z.ZodOptional<z.ZodObject<{
@@ -215,6 +347,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         index: z.ZodOptional<z.ZodObject<{
             embed: z.ZodOptional<z.ZodString>;
@@ -229,6 +383,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         index: z.ZodOptional<z.ZodObject<{
             embed: z.ZodOptional<z.ZodString>;
@@ -243,6 +419,28 @@ declare const langgraphJsonSchema: z.ZodObject<{
             dims: z.ZodOptional<z.ZodNumber>;
             fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, z.ZodTypeAny, "passthrough">>>;
+        ttl: z.ZodOptional<z.ZodObject<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+            default_ttl: z.ZodOptional<z.ZodNumber>;
+            /** Extend an item's expiry when it is read (default true). */
+            refresh_on_read: z.ZodOptional<z.ZodBoolean>;
+            /** How often the background sweeper runs, in minutes (default 60). */
+            sweep_interval_minutes: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
     }, z.ZodTypeAny, "passthrough">>>;
     /** Checkpointer backend; `"default"` == Postgres, absent == in-memory. */
     checkpointer: z.ZodOptional<z.ZodObject<{
@@ -315,6 +513,13 @@ interface LoadConfigOptions {
      * analyses the TypeScript source and never executes the module.
      */
     importModule?: ModuleImporter;
+    /**
+     * Precomputed graph schemas, keyed by graph id — supplied by `skein build`/`skein start` for a
+     * pre-compiled production image. When present, `schemas(id)` returns these instead of statically
+     * analysing TypeScript source: the image ships bundled JS with no `.ts` to introspect, and this
+     * also keeps `getStaticGraphSchema` (and its `worker_threads` parser) out of the runtime entirely.
+     */
+    staticSchemas?: Record<string, GraphSchemas>;
 }
 declare function loadConfig(options?: LoadConfigOptions): Promise<SkeinConfig>;
 

package/dist/index.js

@@ -69,6 +69,14 @@ var storeIndexSchema = z.object({
   dims: z.number().optional(),
   fields: z.array(z.string()).optional()
 }).passthrough();
+var storeTtlSchema = z.object({
+  /** Default item lifetime in minutes when a `put` doesn't specify its own `ttl`. */
+  default_ttl: z.number().optional(),
+  /** Extend an item's expiry when it is read (default true). */
+  refresh_on_read: z.boolean().optional(),
+  /** How often the background sweeper runs, in minutes (default 60). */
+  sweep_interval_minutes: z.number().optional()
+}).passthrough();
 var langgraphJsonSchema = z.object({
   /** REQUIRED: map of graph id → "path:export". */
   graphs: z.record(z.string()),
@@ -77,7 +85,7 @@ var langgraphJsonSchema = z.object({
   /** `.env` path or an inline map, loaded into `process.env` at boot. */
   env: z.union([z.string(), z.record(z.string())]).optional(),
   /** Long-term memory store config. */
-  store: z.object({ index: storeIndexSchema.optional() }).passthrough().optional(),
+  store: z.object({ index: storeIndexSchema.optional(), ttl: storeTtlSchema.optional() }).passthrough().optional(),
   /** Checkpointer backend; `"default"` == Postgres, absent == in-memory. */
   checkpointer: z.object({ type: z.string() }).passthrough().optional(),
   /** Server customization (CORS, route toggles) applied by the framework adapter. */
@@ -126,7 +134,7 @@ async function loadConfig(options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const configPath = path2.resolve(cwd, options.configPath ?? "langgraph.json");
   const configDir = path2.dirname(configPath);
-  const { importModule } = options;
+  const { importModule, staticSchemas } = options;
   const config = parseLanggraphJson(await readJsonFile(configPath));
   const specs = /* @__PURE__ */ new Map();
   for (const [graphId, spec] of Object.entries(config.graphs)) {
@@ -159,6 +167,12 @@ async function loadConfig(options = {}) {
       return memoize(graphCache, graphId, () => loadGraph(spec, importModule));
     },
     async schemas(graphId) {
+      if (staticSchemas) {
+        specFor(graphId);
+        const baked = staticSchemas[graphId];
+        if (!baked) throw new SkeinConfigError(`No precomputed schema for graph "${graphId}".`);
+        return baked;
+      }
       const spec = specFor(graphId);
       return memoize(schemaCache, graphId, () => getStaticGraphSchema(spec));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/config",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "langgraph.json parser and graph loader (path:export) for skein-js.",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -42,7 +42,7 @@
   "dependencies": {
     "@langchain/langgraph-api": "^1.4.0",
     "zod": "^3.25.76",
-    "@skein-js/core": "0.3.0"
+    "@skein-js/core": "0.5.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",