@skein-js/nextjs 0.6.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,67 @@
+# @skein-js/nextjs
+
+> Next.js adapter for skein-js — serve the [Agent Protocol](https://github.com/langchain-ai/agent-protocol) from Next.js API routes.
+
+Part of **[skein-js](../../README.md)** — a TypeScript Agent Protocol server for [LangGraph.js](https://github.com/langchain-ai/langgraphjs), and a drop-in replacement for the LangGraph CLI.
+
+A thin transport shim over the framework-agnostic [`@skein-js/agent-protocol`](../agent-protocol)
+handler table — it adds no protocol logic. Mount the protocol **same-origin** inside an existing
+Next.js app (no separate server, no CORS), ideal for small/medium graphs shipped alongside your
+frontend. Supports both the **App Router** and the **Pages Router**.
+
+## Install
+
+```bash
+npm i @skein-js/nextjs @langchain/langgraph
+```
+
+## App Router (recommended)
+
+A catch-all route re-exports the per-method handlers:
+
+```ts
+// app/api/[...path]/route.ts
+import { createSkeinRouteHandlers } from "@skein-js/nextjs";
+
+export const runtime = "nodejs"; // the background run worker needs a long-lived Node process
+export const { GET, POST, PUT, PATCH, DELETE, OPTIONS } = createSkeinRouteHandlers({
+  config: "./langgraph.json",
+});
+```
+
+Point a browser client at the same origin — no CORS needed:
+
+```ts
+import { useStream } from "@langchain/langgraph-sdk/react";
+const thread = useStream({ apiUrl: "/api", assistantId: "agent" });
+```
+
+## Pages Router
+
+```ts
+// pages/api/[...path].ts
+import { createSkeinPagesHandler } from "@skein-js/nextjs";
+
+// Let Next know this route settles the response itself (needed for SSE streaming).
+export const config = { api: { bodyParser: true, externalResolver: true } };
+export default createSkeinPagesHandler({ config: "./langgraph.json" });
+```
+
+Both entry points accept the shared `{ config } | { deps }` seam, an optional `cors` (off by default),
+and a `basePath` (defaults to `/api`, matching the mount above).
+
+## Deployment caveat
+
+The background run worker and the in-memory driver need a **long-lived Node process** — fine on
+`next start` with `runtime = "nodejs"`. For serverless/edge deploys, back skein with the
+[Redis queue](../runtime-redis) + [Postgres store](../storage-postgres) (pass `{ deps }` from
+[`@skein-js/runtime`](../runtime)'s `buildRuntime`) so state and runs don't depend on one process.
+
+## Learn more
+
+- [`@skein-js/express`](../server-express) — the reference adapter
+- [Building your own adapter](../../docs/building-an-adapter.md) · [skein-js overview](../../docs/index.md)
+
+## License
+
+[Apache-2.0](../../LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { SkeinRuntimeOptions, ResolvedProtocolRuntime } from '@skein-js/server-kit';
+export { SkeinRuntimeOptions, sendNodeError, sendNodeResponse } from '@skein-js/server-kit';
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { ProtocolResponse, Logger } from '@skein-js/agent-protocol';
+
+/** Options for the App Router handlers: the shared runtime options plus where the catch-all is mounted. */
+type SkeinRouteHandlerOptions = SkeinRuntimeOptions & {
+    /**
+     * The path the catch-all route is mounted at, stripped before matching the protocol route table.
+     * Defaults to `/api` (i.e. `app/api/[...path]/route.ts`). Set to `""` or `/` if you mount the
+     * catch-all at the app root.
+     */
+    basePath?: string;
+};
+/** A single Route Handler: takes the Web `Request` and returns a Web `Response`. */
+type SkeinRouteHandler = (request: Request) => Promise<Response>;
+interface SkeinRouteHandlers {
+    GET: SkeinRouteHandler;
+    POST: SkeinRouteHandler;
+    PUT: SkeinRouteHandler;
+    PATCH: SkeinRouteHandler;
+    DELETE: SkeinRouteHandler;
+    OPTIONS: SkeinRouteHandler;
+}
+/** Build the App Router Route Handlers for the given options. */
+declare function createSkeinRouteHandlers(options: SkeinRouteHandlerOptions): SkeinRouteHandlers;
+
+/** Options for the Pages Router handler: shared runtime options plus the catch-all mount path. */
+type SkeinPagesHandlerOptions = SkeinRuntimeOptions & {
+    /** The path the catch-all is mounted at (stripped before matching). Defaults to `/api`. */
+    basePath?: string;
+};
+/** The subset of a Next.js API request the adapter reads (structural, so no `next` type dependency). */
+type SkeinPagesRequest = IncomingMessage & {
+    body?: unknown;
+    query?: Partial<Record<string, string | string[]>>;
+};
+/** A Next.js API route handler. Assignable to Next's `NextApiHandler`. */
+type SkeinPagesHandler = (req: SkeinPagesRequest, res: ServerResponse) => Promise<void>;
+/** Build the Pages Router API handler for the given options. */
+declare function createSkeinPagesHandler(options: SkeinPagesHandlerOptions): SkeinPagesHandler;
+
+type RuntimePromise = Promise<ResolvedProtocolRuntime>;
+/** Resolve (once) the runtime for these options, reusing the cached promise across module reloads. */
+declare function getSkeinRuntime(options: SkeinRuntimeOptions): RuntimePromise;
+
+/** Serialize a `ProtocolResponse` into a Web `Response`, merging any `extraHeaders` (e.g. CORS). */
+declare function toWebResponse(response: ProtocolResponse, extraHeaders?: Record<string, string>): Response;
+/** Map a thrown error onto a Web `Response` — `SkeinHttpError` to its status, else a logged 500. */
+declare function webErrorResponse(error: unknown, extraHeaders?: Record<string, string>, logger?: Logger): Response;
+
+export { type SkeinPagesHandler, type SkeinPagesHandlerOptions, type SkeinPagesRequest, type SkeinRouteHandler, type SkeinRouteHandlerOptions, type SkeinRouteHandlers, createSkeinPagesHandler, createSkeinRouteHandlers, getSkeinRuntime, toWebResponse, webErrorResponse };

package/dist/index.js

@@ -0,0 +1,291 @@
+// src/create-route-handlers.ts
+import { foldThreadId, matchSkeinRoute } from "@skein-js/agent-protocol";
+import { SkeinHttpError } from "@skein-js/core";
+
+// src/runtime-singleton.ts
+import {
+  resolveProtocolRuntime
+} from "@skein-js/server-kit";
+var CONFIG_CACHE_KEY = /* @__PURE__ */ Symbol.for("skein.nextjs.configRuntimeCache");
+var DEPS_CACHE_KEY = /* @__PURE__ */ Symbol.for("skein.nextjs.depsRuntimeCache");
+function configCache() {
+  const store = globalThis;
+  store[CONFIG_CACHE_KEY] ??= /* @__PURE__ */ new Map();
+  return store[CONFIG_CACHE_KEY];
+}
+function depsCache() {
+  const store = globalThis;
+  store[DEPS_CACHE_KEY] ??= /* @__PURE__ */ new WeakMap();
+  return store[DEPS_CACHE_KEY];
+}
+function resolveOnce(cache, key, options) {
+  let resolved = cache.get(key);
+  if (!resolved) {
+    resolved = resolveProtocolRuntime(options).catch((error) => {
+      cache.delete(key);
+      throw error;
+    });
+    cache.set(key, resolved);
+  }
+  return resolved;
+}
+function getSkeinRuntime(options) {
+  if (typeof options.config === "string") {
+    return resolveOnce(configCache(), options.config, options);
+  }
+  return resolveOnce(depsCache(), options.deps, options);
+}
+
+// src/send-web-response.ts
+import { SSE_HEADERS } from "@skein-js/agent-protocol";
+import { isSkeinHttpError, serializeWireJson } from "@skein-js/core";
+function sseStream(events) {
+  const iterator = events[Symbol.asyncIterator]();
+  const encoder = new TextEncoder();
+  return new ReadableStream({
+    async pull(controller) {
+      try {
+        const next = await iterator.next();
+        if (next.done) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(encoder.encode(next.value));
+      } catch (error) {
+        controller.error(error);
+      }
+    },
+    async cancel() {
+      await iterator.return?.(void 0);
+    }
+  });
+}
+function toWebResponse(response, extraHeaders = {}) {
+  switch (response.kind) {
+    case "json":
+      return new Response(serializeWireJson(response.body), {
+        status: response.status,
+        headers: { "content-type": "application/json", ...extraHeaders }
+      });
+    case "empty":
+      return new Response(null, { status: response.status, headers: extraHeaders });
+    case "sse":
+      return new Response(sseStream(response.events), {
+        status: response.status,
+        headers: { ...SSE_HEADERS, ...extraHeaders }
+      });
+  }
+}
+function webErrorResponse(error, extraHeaders = {}, logger) {
+  const headers = { "content-type": "application/json", ...extraHeaders };
+  if (isSkeinHttpError(error)) {
+    return new Response(
+      JSON.stringify({
+        status: error.status,
+        message: error.message,
+        ...error.code !== void 0 ? { code: error.code } : {},
+        ...error.details !== void 0 ? { details: error.details } : {}
+      }),
+      { status: error.status, headers }
+    );
+  }
+  logger?.error("Unhandled error in the skein Next.js adapter.", error);
+  return new Response(JSON.stringify({ status: 500, message: "Internal Server Error" }), {
+    status: 500,
+    headers
+  });
+}
+
+// src/web-cors.ts
+import { corsPreflightHeaders, corsResponseHeaders } from "@skein-js/server-kit";
+function corsHeaders(request, cors) {
+  return corsResponseHeaders(request.headers.get("origin") ?? void 0, cors);
+}
+function preflightResponse(request, cors) {
+  const headers = corsPreflightHeaders(
+    request.headers.get("origin") ?? void 0,
+    request.headers.get("access-control-request-headers") ?? void 0,
+    cors
+  );
+  return new Response(null, { status: 204, headers });
+}
+
+// src/create-route-handlers.ts
+function stripBasePath(pathname, basePath) {
+  if (basePath === "" || basePath === "/") return pathname;
+  if (pathname === basePath) return "/";
+  if (pathname.startsWith(`${basePath}/`)) return pathname.slice(basePath.length);
+  return null;
+}
+function toQuery(url) {
+  const query = {};
+  for (const key of new Set(url.searchParams.keys())) {
+    const all = url.searchParams.getAll(key);
+    query[key] = all.length > 1 ? all : all[0];
+  }
+  return query;
+}
+async function toProtocolRequest(request, url, skeinPathname, params) {
+  let body;
+  if (request.method !== "GET" && request.method !== "HEAD") {
+    const text = await request.text();
+    try {
+      body = text ? JSON.parse(text) : {};
+    } catch {
+      throw SkeinHttpError.badRequest("Request body is not valid JSON.");
+    }
+  }
+  return {
+    method: request.method,
+    // Report the skein-relative absolute URL (mount prefix stripped) so auth handlers see the same
+    // path shape the other adapters produce.
+    url: `${url.origin}${skeinPathname}${url.search}`,
+    params,
+    query: toQuery(url),
+    body,
+    headers: Object.fromEntries(request.headers)
+  };
+}
+function createSkeinRouteHandlers(options) {
+  const basePath = options.basePath ?? "/api";
+  const logger = options.logger;
+  const dispatchRequest = async (request) => {
+    const url = new URL(request.url);
+    const skeinPathname = stripBasePath(url.pathname, basePath);
+    if (skeinPathname === null) return new Response(null, { status: 404 });
+    let resolved;
+    try {
+      resolved = await getSkeinRuntime(options);
+    } catch (error) {
+      return webErrorResponse(error, {}, logger);
+    }
+    const cors = options.cors ?? resolved.cors;
+    if (request.method === "OPTIONS") {
+      return cors ? preflightResponse(request, cors) : new Response(null, { status: 404 });
+    }
+    const extraHeaders = cors ? corsHeaders(request, cors) : {};
+    const match = matchSkeinRoute(request.method, skeinPathname);
+    if (!match) {
+      return new Response(JSON.stringify({ status: 404, message: "Not Found" }), {
+        status: 404,
+        headers: { "content-type": "application/json", ...extraHeaders }
+      });
+    }
+    try {
+      const request_ = await toProtocolRequest(request, url, skeinPathname, match.params);
+      const invoke = resolved.runtime.handlers[match.binding.handler];
+      const response = await invoke(
+        match.binding.foldThreadIdIntoBody ? foldThreadId(request_) : request_
+      );
+      return toWebResponse(response, extraHeaders);
+    } catch (error) {
+      return webErrorResponse(error, extraHeaders, logger);
+    }
+  };
+  return {
+    GET: dispatchRequest,
+    POST: dispatchRequest,
+    PUT: dispatchRequest,
+    PATCH: dispatchRequest,
+    DELETE: dispatchRequest,
+    OPTIONS: dispatchRequest
+  };
+}
+
+// src/create-pages-handler.ts
+import { foldThreadId as foldThreadId2, matchSkeinRoute as matchSkeinRoute2 } from "@skein-js/agent-protocol";
+import {
+  applyNodeCors,
+  sendNodeError,
+  sendNodePreflight,
+  sendNodeResponse
+} from "@skein-js/server-kit";
+function stripBasePath2(pathname, basePath) {
+  if (basePath === "" || basePath === "/") return pathname;
+  if (pathname === basePath) return "/";
+  if (pathname.startsWith(`${basePath}/`)) return pathname.slice(basePath.length);
+  return null;
+}
+function toQuery2(url) {
+  const query = {};
+  for (const key of new Set(url.searchParams.keys())) {
+    const all = url.searchParams.getAll(key);
+    query[key] = all.length > 1 ? all : all[0];
+  }
+  return query;
+}
+function toSingleValueHeaders(headers) {
+  const flattened = {};
+  for (const [name, value] of Object.entries(headers)) {
+    flattened[name] = Array.isArray(value) ? value[0] : value;
+  }
+  return flattened;
+}
+function createSkeinPagesHandler(options) {
+  const basePath = options.basePath ?? "/api";
+  const logger = options.logger;
+  return async (req, res) => {
+    const host = req.headers.host ?? "localhost";
+    let url;
+    try {
+      url = new URL(req.url ?? "/", `http://${host}`);
+    } catch {
+      res.writeHead(400).end();
+      return;
+    }
+    const skeinPathname = stripBasePath2(url.pathname, basePath);
+    if (skeinPathname === null) {
+      res.writeHead(404).end();
+      return;
+    }
+    let resolved;
+    try {
+      resolved = await getSkeinRuntime(options);
+    } catch (error) {
+      sendNodeError(error, res, logger, "skein Next.js");
+      return;
+    }
+    const cors = options.cors ?? resolved.cors;
+    if ((req.method ?? "GET").toUpperCase() === "OPTIONS") {
+      if (cors) sendNodePreflight(req.headers, res, cors);
+      else res.writeHead(404).end();
+      return;
+    }
+    if (cors) applyNodeCors(req.headers, res, cors);
+    const match = matchSkeinRoute2(req.method ?? "GET", skeinPathname);
+    if (!match) {
+      res.writeHead(404, { "content-type": "application/json" });
+      res.end(JSON.stringify({ status: 404, message: "Not Found" }));
+      return;
+    }
+    try {
+      const request = {
+        method: req.method ?? "GET",
+        url: `${url.origin}${skeinPathname}${url.search}`,
+        params: match.params,
+        query: toQuery2(url),
+        body: req.body,
+        headers: toSingleValueHeaders(req.headers)
+      };
+      const invoke = resolved.runtime.handlers[match.binding.handler];
+      const response = await invoke(
+        match.binding.foldThreadIdIntoBody ? foldThreadId2(request) : request
+      );
+      await sendNodeResponse(response, res);
+    } catch (error) {
+      sendNodeError(error, res, logger, "skein Next.js");
+    }
+  };
+}
+
+// src/index.ts
+import { sendNodeResponse as sendNodeResponse2, sendNodeError as sendNodeError2 } from "@skein-js/server-kit";
+export {
+  createSkeinPagesHandler,
+  createSkeinRouteHandlers,
+  getSkeinRuntime,
+  sendNodeError2 as sendNodeError,
+  sendNodeResponse2 as sendNodeResponse,
+  toWebResponse,
+  webErrorResponse
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@skein-js/nextjs",
+  "version": "0.6.1",
+  "description": "Next.js adapter for skein-js — serve the Agent Protocol from App Router or Pages Router API routes.",
+  "license": "Apache-2.0",
+  "author": "Maina Wycliffe <wmmaina7@gmail.com>",
+  "homepage": "https://github.com/mainawycliffe/skein-js/tree/main/packages/server-nextjs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mainawycliffe/skein-js.git",
+    "directory": "packages/server-nextjs"
+  },
+  "bugs": {
+    "url": "https://github.com/mainawycliffe/skein-js/issues"
+  },
+  "keywords": [
+    "typescript",
+    "nextjs",
+    "langgraph",
+    "agent-protocol",
+    "sse"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@skein-js/core": "0.6.1",
+    "@skein-js/server-kit": "0.6.1",
+    "@skein-js/agent-protocol": "0.6.1"
+  },
+  "peerDependencies": {
+    "@langchain/langgraph": "^1.4.0",
+    "next": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@langchain/core": "^1.2.0",
+    "@langchain/langgraph": "^1.4.0",
+    "@skein-js/storage-memory": "0.6.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}