@skein-js/server-kit 0.8.0 → 0.9.0

package/README.md

@@ -32,6 +32,8 @@ handler table.
   (an unset origin resolves to `*`, never a reflected origin, so it can't pair with credentials).
 - **Node transport** — `sendNodeResponse` / `sendNodeError`: serialize a `ProtocolResponse` (JSON / 204
   / SSE) onto a Node `ServerResponse`, shared by the NestJS + Next.js Pages Router adapters.
+- **Mount prefix** — `stripBasePath`: strip the path an adapter is mounted under before matching the
+  route table, for adapters that mount a catch-all and match by hand (NestJS, Next.js).
 
 > The route table itself (`skeinRoutes`) is **not** here — it lives with the engine in
 > [`@skein-js/agent-protocol`](../agent-protocol), since it references the handler names. Adapters
@@ -85,6 +87,10 @@ Pass `overrides` to swap in production drivers or an auth engine while keeping t
   derive CORS headers for adapters without a CORS middleware of their own.
 - **Node transport** — `sendNodeResponse` / `sendNodeError` serialize a `ProtocolResponse`
   (JSON / 204 / SSE) onto a Node `ServerResponse`, shared by the NestJS + Next.js Pages Router adapters.
+- **`stripBasePath(pathname, basePath): string | null`** — the pathname relative to a mount prefix, or
+  `null` when the path is not under it (the caller passes those through untouched). The prefix may be
+  written any way the host wrote it (`api`, `/api`, `/api/`); an empty one passes everything through.
+  Needed only by adapters that mount a catch-all — Express/Fastify get this from their router.
 
 ## Learn more
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ProtocolRuntime, Logger, ProtocolDeps, GraphResolver, ProtocolResponse } from '@skein-js/agent-protocol';
+import { ProtocolRuntime, ProtocolDeps, Logger, GraphResolver, ProtocolResponse } from '@skein-js/agent-protocol';
 export { CompiledGraphFactory, GraphResolver, ProtocolDeps, ResolvedGraph } from '@skein-js/agent-protocol';
 import { ModuleImporter, GraphSchemas } from '@skein-js/config';
 import { CorsOptions } from 'cors';
@@ -44,6 +44,20 @@ interface ResolvedProtocolRuntime {
     /** CORS mapped from the config's `http.cors`, or `undefined` for the injected-`deps` path. */
     cors?: CorsOptions;
 }
+/** Just the dependencies behind a `{ config } | { deps }` bag — no runtime, no worker. */
+interface ResolvedRuntimeDeps {
+    deps: ProtocolDeps;
+    /** CORS mapped from the config's `http.cors`, or `undefined` for the injected-`deps` path. */
+    cors?: CorsOptions;
+}
+/**
+ * Resolve the `{ config } | { deps }` seam down to a `ProtocolDeps` — injected as-is, or fresh
+ * in-memory drivers loaded from a `langgraph.json`. This is the half of
+ * {@link resolveProtocolRuntime} that stops short of building the engine, so the simplified invoke
+ * surface (which needs only graphs + store) doesn't seed assistants or start a run worker it will
+ * never use.
+ */
+declare function resolveRuntimeDeps(options: SkeinRuntimeOptions): Promise<ResolvedRuntimeDeps>;
 /**
  * Build a `ProtocolRuntime` from adapter options: resolve `deps` (injected, or fresh in-memory
  * drivers from a `langgraph.json`), seed one assistant per declared graph, optionally warm the
@@ -214,4 +228,11 @@ declare function sendNodeResponse(response: ProtocolResponse, res: ServerRespons
 /** Serialize a caught error onto the Node `res`, using the protocol status when the error carries one. */
 declare function sendNodeError(error: unknown, res: ServerResponse, logger?: Logger, adapterName?: string): void;
 
-export { type CorsSetting, type DevStateCounts, type DevStateSnapshot, type EmbeddableGraph, type InMemoryRuntimeConfig, type LanggraphCorsConfig, type ReloadableInMemoryRuntime, type ResolvedProtocolRuntime, type SkeinRuntimeCommonOptions, type SkeinRuntimeOptions, allowedOrigin, applyNodeCors, corsFromHttpConfig, corsPreflightHeaders, corsResponseHeaders, createInMemoryDeps, describeSnapshot, embedInMemoryGraphs, graphMapToResolver, joinList, loadInMemoryRuntime, loadReloadableInMemoryRuntime, loadSnapshotIntoStore, normalizeEmbeddableGraphs, readLanggraphDevState, resolveProtocolRuntime, sendNodeError, sendNodePreflight, sendNodeResponse, toCorsOptions };
+/**
+ * The pathname relative to `basePath`, or `null` when the path is not under the mount — which the
+ * caller should treat as "not ours" and pass through untouched, so the host app's own routes still
+ * resolve. An empty (or `/`) base path passes the pathname through unchanged.
+ */
+declare function stripBasePath(pathname: string, basePath: string): string | null;
+
+export { type CorsSetting, type DevStateCounts, type DevStateSnapshot, type EmbeddableGraph, type InMemoryRuntimeConfig, type LanggraphCorsConfig, type ReloadableInMemoryRuntime, type ResolvedProtocolRuntime, type ResolvedRuntimeDeps, type SkeinRuntimeCommonOptions, type SkeinRuntimeOptions, allowedOrigin, applyNodeCors, corsFromHttpConfig, corsPreflightHeaders, corsResponseHeaders, createInMemoryDeps, describeSnapshot, embedInMemoryGraphs, graphMapToResolver, joinList, loadInMemoryRuntime, loadReloadableInMemoryRuntime, loadSnapshotIntoStore, normalizeEmbeddableGraphs, readLanggraphDevState, resolveProtocolRuntime, resolveRuntimeDeps, sendNodeError, sendNodePreflight, sendNodeResponse, stripBasePath, toCorsOptions };

package/dist/index.js

@@ -190,16 +190,13 @@ async function loadReloadableInMemoryRuntime(configPath, importModule, staticSch
 }
 
 // src/resolve-runtime.ts
+async function resolveRuntimeDeps(options) {
+  if (options.deps) return { deps: options.deps };
+  const loaded = await loadInMemoryRuntime(options.config, options.importModule);
+  return { deps: loaded.deps, cors: loaded.cors };
+}
 async function resolveProtocolRuntime(options) {
-  let deps;
-  let corsFromConfig;
-  if (options.deps) {
-    deps = options.deps;
-  } else {
-    const loaded = await loadInMemoryRuntime(options.config, options.importModule);
-    deps = loaded.deps;
-    corsFromConfig = loaded.cors;
-  }
+  const { deps, cors: corsFromConfig } = await resolveRuntimeDeps(options);
   const runtime = createProtocolRuntime(deps);
   await runtime.service.assistants.registerGraphAssistants();
   if (options.warm) {
@@ -639,6 +636,20 @@ function sendNodeError(error, res, logger, adapterName = "skein") {
   res.writeHead(500, { "content-type": "application/json" });
   res.end(JSON.stringify({ status: 500, message: "Internal Server Error" }));
 }
+
+// src/base-path.ts
+function normalizeBasePath(basePath) {
+  if (basePath === "" || basePath === "/") return "";
+  const withLeadingSlash = basePath.startsWith("/") ? basePath : `/${basePath}`;
+  return withLeadingSlash.replace(/\/+$/, "");
+}
+function stripBasePath(pathname, basePath) {
+  const prefix = normalizeBasePath(basePath);
+  if (prefix === "") return pathname;
+  if (pathname === prefix) return "/";
+  if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length);
+  return null;
+}
 export {
   allowedOrigin,
   applyNodeCors,
@@ -656,8 +667,10 @@ export {
   normalizeEmbeddableGraphs,
   readLanggraphDevState,
   resolveProtocolRuntime,
+  resolveRuntimeDeps,
   sendNodeError,
   sendNodePreflight,
   sendNodeResponse,
+  stripBasePath,
   toCorsOptions
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/server-kit",
-  "version": "0.8.0",
+  "version": "0.9.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>",
@@ -43,10 +43,10 @@
     "cors": "^2.8.5",
     "superjson": "^2.2.6",
     "zod": "^3.25.76",
-    "@skein-js/core": "0.8.0",
-    "@skein-js/config": "0.8.0",
-    "@skein-js/agent-protocol": "0.8.0",
-    "@skein-js/storage-memory": "0.8.0"
+    "@skein-js/core": "0.9.0",
+    "@skein-js/agent-protocol": "0.9.0",
+    "@skein-js/config": "0.9.0",
+    "@skein-js/storage-memory": "0.9.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0"