@skein-js/express 0.8.0 → 0.9.1

package/README.md

@@ -67,6 +67,25 @@ const { router } = await skeinRouter({ deps: runtime.deps, cors: runtime.cors })
 app.use(router);
 ```
 
+## Graphs as plain endpoints (non-chat)
+
+For workloads that aren't chat — a classifier, an extractor, a workflow another service calls — there
+is a smaller surface: every graph mounted as `POST /invoke/:graph_id`, where the request body **is**
+the graph input and the response **is** the final state. No threads, assistants, or runs.
+
+```ts
+import { skeinInvokeRouter } from "@skein-js/express";
+import { embedInMemoryGraphs } from "@skein-js/server-kit";
+
+const { router } = await skeinInvokeRouter({ deps: embedInMemoryGraphs({ triage }) });
+app.use(router);
+// curl -X POST localhost:2024/invoke/triage -d '{"text":"…"}'
+```
+
+Send `Accept: text/event-stream` to stream the steps instead. See
+[docs/serving-a-single-graph.md](../../docs/serving-a-single-graph.md) and
+[`examples/invoke-endpoint`](../../examples/invoke-endpoint).
+
 ## API
 
 - **`createExpressServer(options): Promise<SkeinExpressServer>`** — `SkeinExpressServer` =
@@ -74,6 +93,9 @@ app.use(router);
   `"localhost"`, resolves the Node `Server` once bound; `close()` stops the run worker then the HTTP
   server (idempotent).
 - **`skeinRouter(options): Promise<SkeinRouter>`** — `SkeinRouter` = `{ router, runtime }`.
+- **`skeinInvokeRouter(options): Promise<SkeinInvokeRouter>`** — the simplified serving surface
+  (`POST /invoke/:graph_id`, body-in / final-state-out). `SkeinInvokeRouter` = `{ router, deps }`;
+  options add `prefix` (default `/invoke`) and `streamMode`.
 - **`SkeinRouterOptions`** — common `{ logger?, cors?, warm? }` **plus** either `{ config, importModule? }`
   (in-memory runtime from a `langgraph.json`) **or** `{ deps }` (bring-your-own `ProtocolDeps`).
   `warm: true` eagerly loads graphs at startup; `logger` mounts per-request logging.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { ProtocolRuntime, Logger, ProtocolHandlers, ProtocolRequest, ProtocolResponse } from '@skein-js/agent-protocol';
+import { ProtocolRuntime, ProtocolDeps, GraphInvokeOptions, Logger, ProtocolHandlers, ProtocolRequest, ProtocolResponse } from '@skein-js/agent-protocol';
 export { skeinRoutes } from '@skein-js/agent-protocol';
 import { SkeinRuntimeOptions } from '@skein-js/server-kit';
-export { DevStateCounts, DevStateSnapshot, InMemoryRuntimeConfig, LanggraphCorsConfig, ReloadableInMemoryRuntime, corsFromHttpConfig, describeSnapshot, loadInMemoryRuntime, loadReloadableInMemoryRuntime, loadSnapshotIntoStore, readLanggraphDevState, toCorsOptions } from '@skein-js/server-kit';
+export { DevStateCounts, DevStateSnapshot, InMemoryRuntimeConfig, LanggraphCorsConfig, ReloadableInMemoryRuntime, RunWorkerOptions, corsFromHttpConfig, describeSnapshot, loadInMemoryRuntime, loadReloadableInMemoryRuntime, loadSnapshotIntoStore, readLanggraphDevState, toCorsOptions } from '@skein-js/server-kit';
 import { Router, Express, Request, Response } from 'express';
 import { Server } from 'node:http';
 import { CorsOptions } from 'cors';
@@ -34,6 +34,22 @@ interface SkeinExpressServer {
 /** Build an Express server hosting the Agent Protocol, ready to `listen`. */
 declare function createExpressServer(options: SkeinRouterOptions): Promise<SkeinExpressServer>;
 
+type SkeinInvokeRouterOptions = SkeinRuntimeOptions & GraphInvokeOptions & {
+    /** Path prefix for the endpoint; defaults to `/invoke` (→ `POST /invoke/:graph_id`). */
+    prefix?: string;
+};
+interface SkeinInvokeRouter {
+    /** Mount on an Express app: `app.use(router)`. */
+    router: Router;
+    /** The resolved dependencies, so a caller can reuse them (e.g. to also mount `skeinRouter`). */
+    deps: ProtocolDeps;
+}
+/**
+ * Build a `Router` serving `POST <prefix>/:graph_id`. No assistants are seeded and no background run
+ * worker is started — an invoke-only service needs neither.
+ */
+declare function skeinInvokeRouter(options: SkeinInvokeRouterOptions): Promise<SkeinInvokeRouter>;
+
 interface HandlerRouterOptions {
     /** Structured logger for unexpected (non-`SkeinHttpError`) faults. */
     logger?: Logger;
@@ -60,4 +76,4 @@ declare function sendProtocolResponse(response: ProtocolResponse, res: Response)
 /** Serialize a caught error onto `res`, using the protocol status when the error carries one. */
 declare function sendErrorResponse(error: unknown, res: Response, logger?: Logger): void;
 
-export { type HandlerRouterOptions, type SkeinExpressServer, type SkeinRouter, type SkeinRouterOptions, createExpressServer, createHandlerRouter, sendErrorResponse, sendProtocolResponse, skeinRouter, toProtocolRequest };
+export { type HandlerRouterOptions, type SkeinExpressServer, type SkeinInvokeRouter, type SkeinInvokeRouterOptions, type SkeinRouter, type SkeinRouterOptions, createExpressServer, createHandlerRouter, sendErrorResponse, sendProtocolResponse, skeinInvokeRouter, skeinRouter, toProtocolRequest };

package/dist/index.js

@@ -122,11 +122,11 @@ function createHandlerRouter(handlers, options = {}) {
 
 // src/skein-router.ts
 async function skeinRouter(options) {
-  const { runtime, cors: cors2 } = await resolveProtocolRuntime(options);
+  const { runtime, cors: cors3 } = await resolveProtocolRuntime(options);
   const router = createHandlerRouter(runtime.handlers, {
     logger: options.logger,
     // Explicit option wins; otherwise fall back to the config's `http.cors`, else off.
-    cors: options.cors ?? cors2 ?? false
+    cors: options.cors ?? cors3 ?? false
   });
   return { router, runtime };
 }
@@ -180,6 +180,36 @@ async function createExpressServer(options) {
   };
 }
 
+// src/skein-invoke-router.ts
+import {
+  createGraphInvokeHandler,
+  graphInvokeRoutes
+} from "@skein-js/agent-protocol";
+import { resolveRuntimeDeps } from "@skein-js/server-kit";
+import cors2 from "cors";
+import express3 from "express";
+async function skeinInvokeRouter(options) {
+  const { deps, cors: corsFromConfig } = await resolveRuntimeDeps(options);
+  const invoke = createGraphInvokeHandler(deps, { streamMode: options.streamMode });
+  const router = express3.Router();
+  const corsSetting = options.cors ?? corsFromConfig ?? false;
+  if (corsSetting) router.use(cors2(corsSetting === true ? { origin: true } : corsSetting));
+  router.use(express3.json());
+  for (const binding of graphInvokeRoutes(options.prefix)) {
+    router[binding.method](binding.path, async (req, res) => {
+      const disconnected = new AbortController();
+      res.once("close", () => disconnected.abort(new Error("client disconnected")));
+      try {
+        const request = { ...toProtocolRequest(req), signal: disconnected.signal };
+        await sendProtocolResponse(await invoke(request), res);
+      } catch (error) {
+        sendErrorResponse(error, res, options.logger);
+      }
+    });
+  }
+  return { router, deps };
+}
+
 // src/index.ts
 import {
   loadInMemoryRuntime,
@@ -201,6 +231,7 @@ export {
   readLanggraphDevState,
   sendErrorResponse,
   sendProtocolResponse,
+  skeinInvokeRouter,
   skeinRouter,
   skeinRoutes2 as skeinRoutes,
   toCorsOptions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/express",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Express adapter for skein-js — mount the Agent Protocol on an Express Router.",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -41,10 +41,10 @@
   },
   "dependencies": {
     "cors": "^2.8.5",
-    "@skein-js/config": "0.8.0",
-    "@skein-js/server-kit": "0.8.0",
-    "@skein-js/agent-protocol": "0.8.0",
-    "@skein-js/core": "0.8.0"
+    "@skein-js/agent-protocol": "0.9.1",
+    "@skein-js/config": "0.9.1",
+    "@skein-js/core": "0.9.1",
+    "@skein-js/server-kit": "0.9.1"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",
@@ -56,7 +56,7 @@
     "@types/cors": "^2.8.17",
     "@types/express": "^5.0.0",
     "express": "^5.2.1",
-    "@skein-js/storage-memory": "0.8.0"
+    "@skein-js/storage-memory": "0.9.1"
   },
   "publishConfig": {
     "access": "public"