@skein-js/server-kit 0.18.0 → 0.20.0

package/README.md

@@ -4,7 +4,9 @@
 
 > 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.
+Part of **[skein-js](https://github.com/skein-js/skein-js)** — 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.
+
+📖 **Docs:** [Building an adapter](https://skein-js.github.io/skein-js/building-an-adapter)
 
 This package is the common ground the framework adapters ([`@skein-js/express`](../server-express),
 [`@skein-js/fastify`](../server-fastify), [`@skein-js/nestjs`](../server-nestjs),
@@ -24,7 +26,7 @@ handler table.
 - **In-code embedding** — `embedInMemoryGraphs` / `graphMapToResolver`: build a `ProtocolDeps` around a
   compiled graph (or map of them) you already hold — **no `langgraph.json`, no CLI** — then pass
   `{ deps }` to any adapter. `overrides` swaps in production drivers/auth. See
-  [docs/embedding.md](../../docs/embedding.md).
+  [docs/embedding.md](https://skein-js.github.io/skein-js/embedding).
 - **LangGraph dev-state import** — `readLanggraphDevState` / `loadSnapshotIntoStore` /
   `describeSnapshot`, from the **`@skein-js/server-kit/dev` subpath**: read an existing
   `.langgraph_api/` directory and reconstruct skein's own `DevStateSnapshot`, so adopting skein carries
@@ -71,7 +73,7 @@ await server.listen(2024);
 ```
 
 Pass `overrides` to swap in production drivers or an auth engine while keeping the rest in-memory. See
-[docs/embedding.md](../../docs/embedding.md).
+[docs/embedding.md](https://skein-js.github.io/skein-js/embedding).
 
 ## API
 
@@ -103,7 +105,7 @@ Pass `overrides` to swap in production drivers or an auth engine while keeping t
   adapter has to remember it. Free when no logger is configured — it schedules nothing.
 - **`checkHeapHeadroom(): HeapHeadroom`** — the boot-time counterpart: compares V8's ceiling with the
   container's cgroup limit and warns when the automatic sizing does not fit (see
-  [deploy.md](../../docs/deploy.md)).
+  [deploy.md](https://skein-js.github.io/skein-js/deploy)).
 - **`describePoolPressure(runConcurrency, poolMax): string | undefined`** — warns when the worker can
   execute more runs at once than the Postgres pool can serve.
 - **`resolveMaxPageSize(explicit?, env?): number`** — the same chain for the store page bound:
@@ -133,7 +135,7 @@ Pass `overrides` to swap in production drivers or an auth engine while keeping t
   keeping them on the root barrel put a filesystem snapshot deserializer into every adapter's module
   graph. There is deliberately no root re-export — a re-export is still a static import. The
   `DevStateCounts` _type_ remains exported from the root, since `export type` is erased. See
-  [docs/bundling.md](../../docs/bundling.md).
+  [docs/bundling.md](https://skein-js.github.io/skein-js/bundling).
 
 - **CORS** — `corsFromHttpConfig` / `toCorsOptions` map a `langgraph.json` `http.cors` block to
   `cors`-style options; `allowedOrigin` / `corsResponseHeaders` / `applyNodeCors` / `sendNodePreflight`
@@ -147,8 +149,8 @@ Pass `overrides` to swap in production drivers or an auth engine while keeping t
 
 ## Learn more
 
-- [Building your own adapter](../../docs/building-an-adapter.md)
-- [skein-js overview](../../docs/index.md)
+- [Building your own adapter](https://skein-js.github.io/skein-js/building-an-adapter)
+- [skein-js overview](https://skein-js.github.io/skein-js/)
 
 ## License
 

package/dist/{chunk-5Q3G665D.js → chunk-UJZBVPYI.js}

@@ -100,7 +100,11 @@ function resolveIdempotency(raw) {
 
 // src/in-memory-deps.ts
 import { MemorySaver } from "@langchain/langgraph";
-import { cloneLangGraphCheckpoint, langGraphResolver, SkeinBaseStore } from "@skein-js/langgraph";
+import {
+  cloneLangGraphCheckpoint,
+  normalizeEmbeddableGraphs,
+  SkeinBaseStore
+} from "@skein-js/langgraph";
 import { MemoryRunEventBus, MemoryRunQueue, MemorySkeinStore } from "@skein-js/storage-memory";
 
 // src/max-page-size.ts
@@ -186,30 +190,10 @@ function resolveWebhooks(raw, options = {}) {
 }
 
 // src/in-memory-deps.ts
-function isGraphResolver(graphs) {
-  const candidate = graphs;
-  return Array.isArray(candidate.ids) && typeof candidate.load === "function";
-}
-function normalizeEmbeddableGraphs(graphs) {
-  return langGraphResolver(isGraphResolver(graphs) ? graphs : graphMapToResolver(graphs));
-}
-function graphMapToResolver(graphs) {
-  const ids = Object.keys(graphs);
-  return {
-    ids,
-    load: async (graphId) => {
-      const graph = graphs[graphId];
-      if (graph == null) {
-        const known = ids.join(", ") || "none";
-        throw new Error(
-          ids.includes(graphId) ? `Graph "${graphId}" resolved to ${String(graph)} \u2014 check its export/factory (known: ${known}).` : `Unknown graph "${graphId}" (known: ${known}).`
-        );
-      }
-      return graph;
-    },
-    schemas: async (graphId) => ({ [graphId]: { graph_id: graphId } })
-  };
-}
+import {
+  graphMapToResolver,
+  normalizeEmbeddableGraphs as normalizeEmbeddableGraphs2
+} from "@skein-js/langgraph";
 function embedInMemoryGraphs(graphs, overrides = {}) {
   const webhooks = resolveWebhooks(void 0);
   return {
@@ -361,10 +345,10 @@ export {
   resolveMaxPageSize,
   resolveMemoryBusLimits,
   resolveWebhooks,
-  normalizeEmbeddableGraphs,
-  graphMapToResolver,
   embedInMemoryGraphs,
   createInMemoryDeps,
+  graphMapToResolver,
+  normalizeEmbeddableGraphs2 as normalizeEmbeddableGraphs,
   resolveThreadTtl,
   resolveStoreTtl,
   loadInMemoryRuntime,

package/dist/{in-memory-runtime-N3GPWIA5.js → in-memory-runtime-IOQZUNLV.js}

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

package/dist/index.d.ts

@@ -7,7 +7,8 @@ import { MemoryRunEventBusOptions } from '@skein-js/storage-memory';
 import { D as DevStateSnapshot } from './dev-Zz4VRv7T.js';
 export { a as DevStateCounts } from './dev-Zz4VRv7T.js';
 import { StoreTtlConfig, ThreadTtlConfig } from '@skein-js/core';
-import { CompiledGraph } from '@langchain/langgraph';
+import { EmbeddableGraph } from '@skein-js/langgraph';
+export { EmbeddableGraph, graphMapToResolver, normalizeEmbeddableGraphs } from '@skein-js/langgraph';
 import { ServerResponse } from 'node:http';
 
 interface SkeinRuntimeCommonOptions {
@@ -532,46 +533,6 @@ declare function resolveWebhooks(raw: RawWebhooks | undefined, options?: {
     warn?: (message: string) => void;
 }): WebhookDeliveryConfig | undefined;
 
-type AnyCompiledGraph = CompiledGraph<any>;
-/**
- * The surface the engine actually drives, stated structurally.
- *
- * `CompiledGraph` is not the right bound here even though every graph is one. LangChain's own
- * `createAgent` returns a `ReactAgent`, which is graph-*like* — it streams and it has state — but is
- * not structurally a `CompiledGraph`, so requiring that type rejected the blessed way to build an
- * agent. The engine never needed it: `langGraphResolver` casts whatever it is to an `AgentGraph`, and
- * `AgentGraph` requires exactly these two methods.
- *
- * Kept narrow enough to still catch a mistake — an object with neither method is not a graph — while
- * accepting anything the runtime can genuinely drive.
- */
-interface EmbeddableAgentSurface {
-    stream(input: any, options?: any): any;
-    getState(config: any): any;
-}
-/**
- * A graph you can embed in code: any compiled LangGraph.js graph, anything `createAgent` returns, or a
- * factory that builds one per run (called with the run's `configurable`). Keys of a graph map become
- * graph ids.
- */
-type EmbeddableGraph = AnyCompiledGraph | EmbeddableAgentSurface | ((config: {
-    configurable?: Record<string, unknown>;
-}) => AnyCompiledGraph | EmbeddableAgentSurface | Promise<AnyCompiledGraph | EmbeddableAgentSurface>);
-/**
- * Accept either a ready {@link GraphResolver} or a plain graph map and return a `GraphResolver` either
- * way — the normalization every in-code embedding helper shares (`embedInMemoryGraphs` here,
- * `embedPostgresGraphs` in `@skein-js/runtime`), so the {@link isGraphResolver} discriminator lives in
- * exactly one place.
- */
-declare function normalizeEmbeddableGraphs(graphs: GraphResolver | Record<string, EmbeddableGraph>): GraphResolver;
-/**
- * Turn a map of compiled graphs (or per-config factories) into a {@link GraphResolver}. Keys become the
- * graph ids — one auto-registered assistant each. `schemas()` returns a minimal `{ graph_id }` stub:
- * enough for the assistants introspection endpoints and everything `useStream` / Agent Chat UI render.
- * Real input/output/state schema extraction stays a `langgraph.json`/config feature — it needs static
- * TypeScript analysis of the graph source, which a compiled graph object no longer carries.
- */
-declare function graphMapToResolver(graphs: Record<string, EmbeddableGraph>): GraphResolver;
 /**
  * Build a `ProtocolDeps` backed by fresh in-process drivers (store, queue, bus, checkpointer) around
  * graphs you already hold in code — no `langgraph.json`, no CLI. Pass a map of compiled graphs (or
@@ -755,4 +716,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 RawIdempotency, type RawStoreTtl, type RawThreadTtl, type RawWebhooks, type ReloadableInMemoryRuntime, type ResolvedMemoryBusLimits, type ResolvedProtocolRuntime, type ResolvedRuntimeDeps, type RuntimeCapabilities, type RuntimeMemorySnapshot, type RuntimeSignalSubscription, type SkeinRuntimeCommonOptions, type SkeinRuntimeOptions, allowedOrigin, applyNodeCors, checkHeapHeadroom, consoleMountFromHttpConfig, corsFromHttpConfig, corsPreflightHeaders, corsResponseHeaders, createConsoleLogger, createInMemoryDeps, describeError, describeHeapHeadroom, describePoolPressure, detectRuntimeCapabilities, disabledRoutesFromHttpConfig, embedInMemoryGraphs, formatLogMeta, graphMapToResolver, joinList, loadInMemoryRuntime, loadReloadableInMemoryRuntime, normalizeEmbeddableGraphs, readContainerMemoryLimit, resolveCronTickMs, resolveHeapPressureOptions, resolveIdempotency, resolveMaxPageSize, resolveMemoryBusLimits, resolveProtocolRuntime, resolveRunConcurrency, resolveRunTimeoutMs, resolveRuntimeDeps, resolveShutdownGraceMs, resolveStoreTtl, resolveThreadTtl, resolveWebhooks, 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 FileReader, HEAP_REARM_MARGIN_PERCENT, HEAP_REARM_PERCENT, type HeapHeadroom, type HeapPressureContext, type HeapPressureMonitor, type HeapPressureMonitorOptions, type InMemoryRuntimeConfig, type IntervalHandle, type LanggraphCorsConfig, type RawIdempotency, type RawStoreTtl, type RawThreadTtl, type RawWebhooks, type ReloadableInMemoryRuntime, type ResolvedMemoryBusLimits, type ResolvedProtocolRuntime, type ResolvedRuntimeDeps, type RuntimeCapabilities, type RuntimeMemorySnapshot, type RuntimeSignalSubscription, type SkeinRuntimeCommonOptions, type SkeinRuntimeOptions, allowedOrigin, applyNodeCors, checkHeapHeadroom, consoleMountFromHttpConfig, corsFromHttpConfig, corsPreflightHeaders, corsResponseHeaders, createConsoleLogger, createInMemoryDeps, describeError, describeHeapHeadroom, describePoolPressure, detectRuntimeCapabilities, disabledRoutesFromHttpConfig, embedInMemoryGraphs, formatLogMeta, joinList, loadInMemoryRuntime, loadReloadableInMemoryRuntime, readContainerMemoryLimit, resolveCronTickMs, resolveHeapPressureOptions, resolveIdempotency, resolveMaxPageSize, resolveMemoryBusLimits, resolveProtocolRuntime, resolveRunConcurrency, resolveRunTimeoutMs, resolveRuntimeDeps, resolveShutdownGraceMs, resolveStoreTtl, resolveThreadTtl, resolveWebhooks, routeMatcherFor, routesFromHttpConfig, runFailureIdentity, sendNodeError, sendNodePreflight, sendNodeResponse, startHeapPressureMonitor, stripBasePath, toCorsOptions };

package/dist/index.js

@@ -18,7 +18,7 @@ import {
   resolveWebhooks,
   routesFromHttpConfig,
   toCorsOptions
-} from "./chunk-5Q3G665D.js";
+} from "./chunk-UJZBVPYI.js";
 import "./chunk-JUBBCC7R.js";
 
 // src/resolve-runtime.ts
@@ -168,7 +168,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, channels: options.channels } : await (await import("./in-memory-runtime-N3GPWIA5.js")).loadInMemoryRuntime(options.config, options.importModule);
+  const loaded = options.deps ? { deps: options.deps, cors: void 0, routes: skeinRoutes, channels: options.channels } : await (await import("./in-memory-runtime-IOQZUNLV.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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/server-kit",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "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,22 +49,22 @@
     "cors": "^2.8.5",
     "superjson": "^2.2.6",
     "zod": "^3.25.76",
-    "@skein-js/agent-protocol": "0.18.0",
-    "@skein-js/config": "0.18.0",
-    "@skein-js/core": "0.18.0",
-    "@skein-js/langgraph": "0.18.0",
-    "@skein-js/storage-memory": "0.18.0"
+    "@skein-js/agent-protocol": "0.20.0",
+    "@skein-js/config": "0.20.0",
+    "@skein-js/core": "0.20.0",
+    "@skein-js/langgraph": "0.20.0",
+    "@skein-js/storage-memory": "0.20.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",
-    "@skein-js/channels": "0.18.0"
+    "@skein-js/channels": "0.20.0"
   },
   "devDependencies": {
     "@langchain/core": "^1.2.9",
     "@langchain/langgraph": "^1.4.0",
     "@langchain/langgraph-sdk": "^1.9.0",
     "@types/cors": "^2.8.17",
-    "@skein-js/channels": "0.18.0"
+    "@skein-js/channels": "0.20.0"
   },
   "publishConfig": {
     "access": "public"