agentxjs 0.0.1

package/dist/server/adapters/hono.d.ts

@@ -0,0 +1,96 @@
+import { A as AgentXHandler } from '../../types-Cgfcw91r.js';
+import '@agentxjs/types';
+
+/**
+ * Hono Adapter
+ *
+ * Adapts AgentXHandler to Hono middleware.
+ * Hono already uses Web Standard Request/Response, so this is mostly a convenience wrapper.
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from "hono";
+ * import { agentx } from "agentxjs";
+ * import { createAgentXHandler } from "agentxjs/server";
+ * import { toHonoHandler, createHonoRoutes } from "agentxjs/server/adapters/hono";
+ *
+ * const app = new Hono();
+ * const handler = createAgentXHandler(agentx);
+ *
+ * // Option 1: Simple catch-all
+ * app.all("/agentx/*", toHonoHandler(handler));
+ *
+ * // Option 2: Mount as sub-app
+ * app.route("/agentx", createHonoRoutes(handler));
+ *
+ * export default app;
+ * ```
+ */
+
+/**
+ * Hono Context interface (minimal)
+ */
+interface HonoContext {
+    req: {
+        raw: Request;
+        url: string;
+        method: string;
+        path: string;
+    };
+    body: (data: ReadableStream | string | ArrayBuffer | null, init?: ResponseInit) => Response;
+    json: (data: unknown, init?: ResponseInit) => Response;
+    text: (data: string, init?: ResponseInit) => Response;
+}
+/**
+ * Hono handler type
+ */
+type HonoHandler = (c: HonoContext) => Response | Promise<Response>;
+/**
+ * Convert AgentXHandler to Hono handler
+ *
+ * Since Hono uses Web Standard Request/Response natively,
+ * this adapter is straightforward.
+ *
+ * @param handler - AgentX handler
+ * @returns Hono handler function
+ */
+declare function toHonoHandler(handler: AgentXHandler): HonoHandler;
+/**
+ * Hono-like app interface (minimal for sub-routing)
+ */
+interface HonoLike {
+    all(path: string, handler: HonoHandler): HonoLike;
+    get(path: string, handler: HonoHandler): HonoLike;
+    post(path: string, handler: HonoHandler): HonoLike;
+    delete(path: string, handler: HonoHandler): HonoLike;
+}
+/**
+ * Create a Hono sub-app with all AgentX routes
+ *
+ * This creates explicit routes for better type safety and documentation.
+ *
+ * @param handler - AgentX handler
+ * @param HonoClass - Hono class constructor (optional, for tree-shaking)
+ * @returns Hono app with all routes configured
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from "hono";
+ * import { createHonoRoutes } from "agentxjs/server/adapters/hono";
+ *
+ * const app = new Hono();
+ * app.route("/agentx", createHonoRoutes(handler, Hono));
+ * ```
+ */
+declare function createHonoRoutes<T extends HonoLike>(handler: AgentXHandler, HonoClass: new () => T): T;
+/**
+ * Simple Hono middleware that forwards all requests to handler
+ *
+ * Use this when you want a simple catch-all without explicit routing.
+ *
+ * @param handler - AgentX handler
+ * @returns Hono handler
+ */
+declare function createHonoAdapter(handler: AgentXHandler): HonoHandler;
+
+export { type HonoHandler, createHonoAdapter, createHonoRoutes, toHonoHandler };

package/dist/server/adapters/hono.js

@@ -0,0 +1,28 @@
+// src/server/adapters/hono.ts
+function toHonoHandler(handler) {
+  return async (c) => {
+    return handler(c.req.raw);
+  };
+}
+function createHonoRoutes(handler, HonoClass) {
+  const app = new HonoClass();
+  const honoHandler = toHonoHandler(handler);
+  app.get("/info", honoHandler);
+  app.get("/health", honoHandler);
+  app.get("/agents", honoHandler);
+  app.post("/agents", honoHandler);
+  app.get("/agents/:agentId", honoHandler);
+  app.delete("/agents/:agentId", honoHandler);
+  app.get("/agents/:agentId/sse", honoHandler);
+  app.post("/agents/:agentId/messages", honoHandler);
+  app.post("/agents/:agentId/interrupt", honoHandler);
+  app.all("/*", honoHandler);
+  return app;
+}
+function createHonoAdapter(handler) {
+  return toHonoHandler(handler);
+}
+
+export { createHonoAdapter, createHonoRoutes, toHonoHandler };
+//# sourceMappingURL=hono.js.map
+//# sourceMappingURL=hono.js.map

package/dist/server/adapters/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/adapters/hono.ts"],"names":[],"mappings":";AA0DO,SAAS,cAAc,OAAA,EAAqC;AACjE,EAAA,OAAO,OAAO,CAAA,KAAM;AAElB,IAAA,OAAO,OAAA,CAAQ,CAAA,CAAE,GAAA,CAAI,GAAG,CAAA;AAAA,EAC1B,CAAA;AACF;AA8BO,SAAS,gBAAA,CACd,SACA,SAAA,EACG;AACH,EAAA,MAAM,GAAA,GAAM,IAAI,SAAA,EAAU;AAC1B,EAAA,MAAM,WAAA,GAAc,cAAc,OAAO,CAAA;AAGzC,EAAA,GAAA,CAAI,GAAA,CAAI,SAAS,WAAW,CAAA;AAC5B,EAAA,GAAA,CAAI,GAAA,CAAI,WAAW,WAAW,CAAA;AAG9B,EAAA,GAAA,CAAI,GAAA,CAAI,WAAW,WAAW,CAAA;AAC9B,EAAA,GAAA,CAAI,IAAA,CAAK,WAAW,WAAW,CAAA;AAG/B,EAAA,GAAA,CAAI,GAAA,CAAI,oBAAoB,WAAW,CAAA;AACvC,EAAA,GAAA,CAAI,MAAA,CAAO,oBAAoB,WAAW,CAAA;AAC1C,EAAA,GAAA,CAAI,GAAA,CAAI,wBAAwB,WAAW,CAAA;AAC3C,EAAA,GAAA,CAAI,IAAA,CAAK,6BAA6B,WAAW,CAAA;AACjD,EAAA,GAAA,CAAI,IAAA,CAAK,8BAA8B,WAAW,CAAA;AAGlD,EAAA,GAAA,CAAI,GAAA,CAAI,MAAM,WAAW,CAAA;AAEzB,EAAA,OAAO,GAAA;AACT;AAUO,SAAS,kBAAkB,OAAA,EAAqC;AACrE,EAAA,OAAO,cAAc,OAAO,CAAA;AAC9B","file":"hono.js","sourcesContent":["/**\n * Hono Adapter\n *\n * Adapts AgentXHandler to Hono middleware.\n * Hono already uses Web Standard Request/Response, so this is mostly a convenience wrapper.\n *\n * @example\n * ```typescript\n * import { Hono } from \"hono\";\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { toHonoHandler, createHonoRoutes } from \"agentxjs/server/adapters/hono\";\n *\n * const app = new Hono();\n * const handler = createAgentXHandler(agentx);\n *\n * // Option 1: Simple catch-all\n * app.all(\"/agentx/*\", toHonoHandler(handler));\n *\n * // Option 2: Mount as sub-app\n * app.route(\"/agentx\", createHonoRoutes(handler));\n *\n * export default app;\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Hono Context interface (minimal)\n */\ninterface HonoContext {\n  req: {\n    raw: Request;\n    url: string;\n    method: string;\n    path: string;\n  };\n  // Return response\n  body: (data: ReadableStream | string | ArrayBuffer | null, init?: ResponseInit) => Response;\n  json: (data: unknown, init?: ResponseInit) => Response;\n  text: (data: string, init?: ResponseInit) => Response;\n}\n\n/**\n * Hono handler type\n */\nexport type HonoHandler = (c: HonoContext) => Response | Promise<Response>;\n\n/**\n * Convert AgentXHandler to Hono handler\n *\n * Since Hono uses Web Standard Request/Response natively,\n * this adapter is straightforward.\n *\n * @param handler - AgentX handler\n * @returns Hono handler function\n */\nexport function toHonoHandler(handler: AgentXHandler): HonoHandler {\n  return async (c) => {\n    // Hono provides the raw Web Request directly\n    return handler(c.req.raw);\n  };\n}\n\n/**\n * Hono-like app interface (minimal for sub-routing)\n */\ninterface HonoLike {\n  all(path: string, handler: HonoHandler): HonoLike;\n  get(path: string, handler: HonoHandler): HonoLike;\n  post(path: string, handler: HonoHandler): HonoLike;\n  delete(path: string, handler: HonoHandler): HonoLike;\n}\n\n/**\n * Create a Hono sub-app with all AgentX routes\n *\n * This creates explicit routes for better type safety and documentation.\n *\n * @param handler - AgentX handler\n * @param HonoClass - Hono class constructor (optional, for tree-shaking)\n * @returns Hono app with all routes configured\n *\n * @example\n * ```typescript\n * import { Hono } from \"hono\";\n * import { createHonoRoutes } from \"agentxjs/server/adapters/hono\";\n *\n * const app = new Hono();\n * app.route(\"/agentx\", createHonoRoutes(handler, Hono));\n * ```\n */\nexport function createHonoRoutes<T extends HonoLike>(\n  handler: AgentXHandler,\n  HonoClass: new () => T\n): T {\n  const app = new HonoClass();\n  const honoHandler = toHonoHandler(handler);\n\n  // Platform routes\n  app.get(\"/info\", honoHandler);\n  app.get(\"/health\", honoHandler);\n\n  // Agent collection routes\n  app.get(\"/agents\", honoHandler);\n  app.post(\"/agents\", honoHandler);\n\n  // Agent instance routes\n  app.get(\"/agents/:agentId\", honoHandler);\n  app.delete(\"/agents/:agentId\", honoHandler);\n  app.get(\"/agents/:agentId/sse\", honoHandler);\n  app.post(\"/agents/:agentId/messages\", honoHandler);\n  app.post(\"/agents/:agentId/interrupt\", honoHandler);\n\n  // Catch-all for any missed routes\n  app.all(\"/*\", honoHandler);\n\n  return app;\n}\n\n/**\n * Simple Hono middleware that forwards all requests to handler\n *\n * Use this when you want a simple catch-all without explicit routing.\n *\n * @param handler - AgentX handler\n * @returns Hono handler\n */\nexport function createHonoAdapter(handler: AgentXHandler): HonoHandler {\n  return toHonoHandler(handler);\n}\n"]}

package/dist/server/adapters/index.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+// src/server/adapters/express.ts
+function toWebRequest(req) {
+  const protocol = req.protocol || "http";
+  const host = req.hostname || req.headers.host || "localhost";
+  const url = `${protocol}://${host}${req.originalUrl || req.url}`;
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(req.headers)) {
+    if (value !== void 0) {
+      if (Array.isArray(value)) {
+        value.forEach((v) => headers.append(key, v));
+      } else {
+        headers.set(key, value);
+      }
+    }
+  }
+  const init = {
+    method: req.method,
+    headers
+  };
+  if (req.method !== "GET" && req.method !== "HEAD") {
+    if (req.body !== void 0) {
+      init.body = JSON.stringify(req.body);
+    }
+  }
+  return new Request(url, init);
+}
+async function sendWebResponse(res, webResponse) {
+  res.status(webResponse.status);
+  webResponse.headers.forEach((value, key) => {
+    if (key.toLowerCase() !== "content-encoding") {
+      res.setHeader(key, value);
+    }
+  });
+  const contentType = webResponse.headers.get("content-type");
+  if (contentType?.includes("text/event-stream")) {
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    if (res.flushHeaders) {
+      res.flushHeaders();
+    }
+    const reader = webResponse.body?.getReader();
+    if (reader) {
+      const decoder = new TextDecoder();
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          res.write(decoder.decode(value, { stream: true }));
+        }
+      } catch {
+      } finally {
+        reader.releaseLock();
+      }
+    }
+    res.end();
+  } else {
+    const body = await webResponse.text();
+    res.end(body);
+  }
+}
+function toExpressHandler(handler) {
+  return async (req, res, next) => {
+    try {
+      const webRequest = toWebRequest(req);
+      const webResponse = await handler(webRequest);
+      await sendWebResponse(res, webResponse);
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+function createExpressAdapter(handler) {
+  return toExpressHandler(handler);
+}
+
+// src/server/adapters/hono.ts
+function toHonoHandler(handler) {
+  return async (c) => {
+    return handler(c.req.raw);
+  };
+}
+function createHonoRoutes(handler, HonoClass) {
+  const app = new HonoClass();
+  const honoHandler = toHonoHandler(handler);
+  app.get("/info", honoHandler);
+  app.get("/health", honoHandler);
+  app.get("/agents", honoHandler);
+  app.post("/agents", honoHandler);
+  app.get("/agents/:agentId", honoHandler);
+  app.delete("/agents/:agentId", honoHandler);
+  app.get("/agents/:agentId/sse", honoHandler);
+  app.post("/agents/:agentId/messages", honoHandler);
+  app.post("/agents/:agentId/interrupt", honoHandler);
+  app.all("/*", honoHandler);
+  return app;
+}
+function createHonoAdapter(handler) {
+  return toHonoHandler(handler);
+}
+
+// src/server/adapters/next.ts
+function createNextHandler(handler) {
+  const routeHandler = async (request) => {
+    return handler(request);
+  };
+  return {
+    GET: routeHandler,
+    POST: routeHandler,
+    DELETE: routeHandler,
+    PUT: routeHandler,
+    PATCH: routeHandler,
+    HEAD: routeHandler,
+    OPTIONS: routeHandler
+  };
+}
+function toNextHandler(handler) {
+  return async (request) => handler(request);
+}
+function createNextEdgeHandler(handler) {
+  return createNextHandler(handler);
+}
+
+exports.createAgentXRoutes = createNextHandler;
+exports.createExpressAdapter = createExpressAdapter;
+exports.createHonoAdapter = createHonoAdapter;
+exports.createHonoRoutes = createHonoRoutes;
+exports.createNextEdgeHandler = createNextEdgeHandler;
+exports.createNextHandler = createNextHandler;
+exports.toExpressHandler = toExpressHandler;
+exports.toHonoHandler = toHonoHandler;
+exports.toNextHandler = toNextHandler;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/server/adapters/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/adapters/express.ts","../../../src/server/adapters/hono.ts","../../../src/server/adapters/next.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Express Adapter\n *\n * Adapts AgentXHandler to Express middleware.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { toExpressHandler } from \"agentxjs/server/adapters/express\";\n *\n * const app = express();\n * const handler = createAgentXHandler(agentx);\n *\n * app.use(\"/agentx\", toExpressHandler(handler));\n * app.listen(3000);\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Express-like request interface (minimal)\n */\ninterface ExpressRequest {\n  method: string;\n  url: string;\n  headers: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  protocol?: string;\n  hostname?: string;\n  originalUrl?: string;\n  // For reading body as stream\n  on?: (event: string, handler: (chunk: unknown) => void) => void;\n}\n\n/**\n * Express-like response interface (minimal)\n */\ninterface ExpressResponse {\n  status(code: number): ExpressResponse;\n  set(headers: Record<string, string>): ExpressResponse;\n  setHeader(name: string, value: string): void;\n  write(chunk: string | Uint8Array): boolean;\n  end(data?: string | Buffer): void;\n  headersSent: boolean;\n  flushHeaders?(): void;\n}\n\n/**\n * Express-like next function\n */\ntype ExpressNext = (error?: unknown) => void;\n\n/**\n * Express request handler type\n */\nexport type ExpressHandler = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: ExpressNext\n) => void | Promise<void>;\n\n/**\n * Convert Express request to Web Request\n */\nfunction toWebRequest(req: ExpressRequest): Request {\n  // Build URL\n  const protocol = req.protocol || \"http\";\n  const host = req.hostname || req.headers.host || \"localhost\";\n  const url = `${protocol}://${host}${req.originalUrl || req.url}`;\n\n  // Build headers\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value !== undefined) {\n      if (Array.isArray(value)) {\n        value.forEach((v) => headers.append(key, v));\n      } else {\n        headers.set(key, value);\n      }\n    }\n  }\n\n  // Build request options\n  const init: RequestInit = {\n    method: req.method,\n    headers,\n  };\n\n  // Add body for non-GET/HEAD requests\n  if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n    if (req.body !== undefined) {\n      // Body already parsed (e.g., by express.json())\n      init.body = JSON.stringify(req.body);\n    }\n  }\n\n  return new Request(url, init);\n}\n\n/**\n * Send Web Response to Express response\n */\nasync function sendWebResponse(res: ExpressResponse, webResponse: Response): Promise<void> {\n  // Set status\n  res.status(webResponse.status);\n\n  // Set headers\n  webResponse.headers.forEach((value, key) => {\n    // Skip content-encoding for SSE (we handle it differently)\n    if (key.toLowerCase() !== \"content-encoding\") {\n      res.setHeader(key, value);\n    }\n  });\n\n  // Check if SSE response\n  const contentType = webResponse.headers.get(\"content-type\");\n  if (contentType?.includes(\"text/event-stream\")) {\n    // SSE: Stream the response\n    res.setHeader(\"Cache-Control\", \"no-cache\");\n    res.setHeader(\"Connection\", \"keep-alive\");\n\n    // Flush headers immediately for SSE\n    if (res.flushHeaders) {\n      res.flushHeaders();\n    }\n\n    const reader = webResponse.body?.getReader();\n    if (reader) {\n      const decoder = new TextDecoder();\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          res.write(decoder.decode(value, { stream: true }));\n        }\n      } catch {\n        // Connection closed\n      } finally {\n        reader.releaseLock();\n      }\n    }\n    res.end();\n  } else {\n    // Regular response: Send body as text\n    const body = await webResponse.text();\n    res.end(body);\n  }\n}\n\n/**\n * Convert AgentXHandler to Express middleware\n *\n * @param handler - AgentX handler (Web Standard based)\n * @returns Express middleware function\n */\nexport function toExpressHandler(handler: AgentXHandler): ExpressHandler {\n  return async (req, res, next) => {\n    try {\n      const webRequest = toWebRequest(req);\n      const webResponse = await handler(webRequest);\n      await sendWebResponse(res, webResponse);\n    } catch (error) {\n      next(error);\n    }\n  };\n}\n\n/**\n * Create Express router with AgentX handler\n *\n * This is a convenience function that wraps toExpressHandler\n * and can be used directly with app.use()\n *\n * @param handler - AgentX handler\n * @returns Express handler\n */\nexport function createExpressAdapter(handler: AgentXHandler): ExpressHandler {\n  return toExpressHandler(handler);\n}\n","/**\n * Hono Adapter\n *\n * Adapts AgentXHandler to Hono middleware.\n * Hono already uses Web Standard Request/Response, so this is mostly a convenience wrapper.\n *\n * @example\n * ```typescript\n * import { Hono } from \"hono\";\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { toHonoHandler, createHonoRoutes } from \"agentxjs/server/adapters/hono\";\n *\n * const app = new Hono();\n * const handler = createAgentXHandler(agentx);\n *\n * // Option 1: Simple catch-all\n * app.all(\"/agentx/*\", toHonoHandler(handler));\n *\n * // Option 2: Mount as sub-app\n * app.route(\"/agentx\", createHonoRoutes(handler));\n *\n * export default app;\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Hono Context interface (minimal)\n */\ninterface HonoContext {\n  req: {\n    raw: Request;\n    url: string;\n    method: string;\n    path: string;\n  };\n  // Return response\n  body: (data: ReadableStream | string | ArrayBuffer | null, init?: ResponseInit) => Response;\n  json: (data: unknown, init?: ResponseInit) => Response;\n  text: (data: string, init?: ResponseInit) => Response;\n}\n\n/**\n * Hono handler type\n */\nexport type HonoHandler = (c: HonoContext) => Response | Promise<Response>;\n\n/**\n * Convert AgentXHandler to Hono handler\n *\n * Since Hono uses Web Standard Request/Response natively,\n * this adapter is straightforward.\n *\n * @param handler - AgentX handler\n * @returns Hono handler function\n */\nexport function toHonoHandler(handler: AgentXHandler): HonoHandler {\n  return async (c) => {\n    // Hono provides the raw Web Request directly\n    return handler(c.req.raw);\n  };\n}\n\n/**\n * Hono-like app interface (minimal for sub-routing)\n */\ninterface HonoLike {\n  all(path: string, handler: HonoHandler): HonoLike;\n  get(path: string, handler: HonoHandler): HonoLike;\n  post(path: string, handler: HonoHandler): HonoLike;\n  delete(path: string, handler: HonoHandler): HonoLike;\n}\n\n/**\n * Create a Hono sub-app with all AgentX routes\n *\n * This creates explicit routes for better type safety and documentation.\n *\n * @param handler - AgentX handler\n * @param HonoClass - Hono class constructor (optional, for tree-shaking)\n * @returns Hono app with all routes configured\n *\n * @example\n * ```typescript\n * import { Hono } from \"hono\";\n * import { createHonoRoutes } from \"agentxjs/server/adapters/hono\";\n *\n * const app = new Hono();\n * app.route(\"/agentx\", createHonoRoutes(handler, Hono));\n * ```\n */\nexport function createHonoRoutes<T extends HonoLike>(\n  handler: AgentXHandler,\n  HonoClass: new () => T\n): T {\n  const app = new HonoClass();\n  const honoHandler = toHonoHandler(handler);\n\n  // Platform routes\n  app.get(\"/info\", honoHandler);\n  app.get(\"/health\", honoHandler);\n\n  // Agent collection routes\n  app.get(\"/agents\", honoHandler);\n  app.post(\"/agents\", honoHandler);\n\n  // Agent instance routes\n  app.get(\"/agents/:agentId\", honoHandler);\n  app.delete(\"/agents/:agentId\", honoHandler);\n  app.get(\"/agents/:agentId/sse\", honoHandler);\n  app.post(\"/agents/:agentId/messages\", honoHandler);\n  app.post(\"/agents/:agentId/interrupt\", honoHandler);\n\n  // Catch-all for any missed routes\n  app.all(\"/*\", honoHandler);\n\n  return app;\n}\n\n/**\n * Simple Hono middleware that forwards all requests to handler\n *\n * Use this when you want a simple catch-all without explicit routing.\n *\n * @param handler - AgentX handler\n * @returns Hono handler\n */\nexport function createHonoAdapter(handler: AgentXHandler): HonoHandler {\n  return toHonoHandler(handler);\n}\n","/**\n * Next.js App Router Adapter\n *\n * Adapts AgentXHandler to Next.js App Router route handlers.\n * Next.js App Router uses Web Standard Request/Response natively.\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { createNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = createAgentXHandler(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export const { GET, POST, DELETE } = createNextHandler(handler);\n *\n * // Enable streaming for SSE\n * export const dynamic = \"force-dynamic\";\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Next.js route context\n */\ninterface NextRouteContext {\n  params: Record<string, string | string[]>;\n}\n\n/**\n * Next.js route handler type\n */\nexport type NextRouteHandler = (\n  request: Request,\n  context?: NextRouteContext\n) => Response | Promise<Response>;\n\n/**\n * Next.js route handlers object\n */\nexport interface NextRouteHandlers {\n  GET: NextRouteHandler;\n  POST: NextRouteHandler;\n  DELETE: NextRouteHandler;\n  PUT: NextRouteHandler;\n  PATCH: NextRouteHandler;\n  HEAD: NextRouteHandler;\n  OPTIONS: NextRouteHandler;\n}\n\n/**\n * Create Next.js App Router route handlers\n *\n * @param handler - AgentX handler\n * @returns Object with GET, POST, DELETE, etc. handlers\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = createAgentXHandler(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export const { GET, POST, DELETE } = createNextHandler(handler);\n * ```\n */\nexport function createNextHandler(handler: AgentXHandler): NextRouteHandlers {\n  // All methods use the same handler since routing is done by AgentXHandler\n  const routeHandler: NextRouteHandler = async (request) => {\n    return handler(request);\n  };\n\n  return {\n    GET: routeHandler,\n    POST: routeHandler,\n    DELETE: routeHandler,\n    PUT: routeHandler,\n    PATCH: routeHandler,\n    HEAD: routeHandler,\n    OPTIONS: routeHandler,\n  };\n}\n\n/**\n * Create a single Next.js handler for all methods\n *\n * Use this if you prefer to handle all methods with one export.\n *\n * @param handler - AgentX handler\n * @returns Single route handler\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { toNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = toNextHandler(createAgentXHandler(agentx));\n *\n * export { handler as GET, handler as POST, handler as DELETE };\n * ```\n */\nexport function toNextHandler(handler: AgentXHandler): NextRouteHandler {\n  return async (request) => handler(request);\n}\n\n/**\n * Next.js Edge Runtime compatible handler\n *\n * Use this for edge functions deployment.\n *\n * @param handler - AgentX handler\n * @returns Edge-compatible handler\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createNextEdgeHandler } from \"agentxjs/server/adapters/next\";\n *\n * export const runtime = \"edge\";\n * export const { GET, POST, DELETE } = createNextEdgeHandler(handler);\n * ```\n */\nexport function createNextEdgeHandler(handler: AgentXHandler): NextRouteHandlers {\n  // Edge runtime also uses Web Standard Request/Response\n  return createNextHandler(handler);\n}\n\n/**\n * Convenience export for route.ts files\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createAgentXRoutes } from \"agentxjs/server/adapters/next\";\n *\n * const { GET, POST, DELETE } = createAgentXRoutes(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export { GET, POST, DELETE };\n * export const dynamic = \"force-dynamic\";\n * ```\n */\nexport { createNextHandler as createAgentXRoutes };\n"]}

package/dist/server/adapters/index.d.cts

@@ -0,0 +1,5 @@
+export { ExpressHandler, createExpressAdapter, toExpressHandler } from './express.cjs';
+export { HonoHandler, createHonoAdapter, createHonoRoutes, toHonoHandler } from './hono.cjs';
+export { NextRouteHandler, NextRouteHandlers, createAgentXRoutes, createNextEdgeHandler, createAgentXRoutes as createNextHandler, toNextHandler } from './next.cjs';
+import '../../types-Cgfcw91r.cjs';
+import '@agentxjs/types';

package/dist/server/adapters/index.d.ts

@@ -0,0 +1,5 @@
+export { ExpressHandler, createExpressAdapter, toExpressHandler } from './express.js';
+export { HonoHandler, createHonoAdapter, createHonoRoutes, toHonoHandler } from './hono.js';
+export { NextRouteHandler, NextRouteHandlers, createAgentXRoutes, createNextEdgeHandler, createAgentXRoutes as createNextHandler, toNextHandler } from './next.js';
+import '../../types-Cgfcw91r.js';
+import '@agentxjs/types';

package/dist/server/adapters/index.js

@@ -0,0 +1,125 @@
+// src/server/adapters/express.ts
+function toWebRequest(req) {
+  const protocol = req.protocol || "http";
+  const host = req.hostname || req.headers.host || "localhost";
+  const url = `${protocol}://${host}${req.originalUrl || req.url}`;
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(req.headers)) {
+    if (value !== void 0) {
+      if (Array.isArray(value)) {
+        value.forEach((v) => headers.append(key, v));
+      } else {
+        headers.set(key, value);
+      }
+    }
+  }
+  const init = {
+    method: req.method,
+    headers
+  };
+  if (req.method !== "GET" && req.method !== "HEAD") {
+    if (req.body !== void 0) {
+      init.body = JSON.stringify(req.body);
+    }
+  }
+  return new Request(url, init);
+}
+async function sendWebResponse(res, webResponse) {
+  res.status(webResponse.status);
+  webResponse.headers.forEach((value, key) => {
+    if (key.toLowerCase() !== "content-encoding") {
+      res.setHeader(key, value);
+    }
+  });
+  const contentType = webResponse.headers.get("content-type");
+  if (contentType?.includes("text/event-stream")) {
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    if (res.flushHeaders) {
+      res.flushHeaders();
+    }
+    const reader = webResponse.body?.getReader();
+    if (reader) {
+      const decoder = new TextDecoder();
+      try {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          res.write(decoder.decode(value, { stream: true }));
+        }
+      } catch {
+      } finally {
+        reader.releaseLock();
+      }
+    }
+    res.end();
+  } else {
+    const body = await webResponse.text();
+    res.end(body);
+  }
+}
+function toExpressHandler(handler) {
+  return async (req, res, next) => {
+    try {
+      const webRequest = toWebRequest(req);
+      const webResponse = await handler(webRequest);
+      await sendWebResponse(res, webResponse);
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+function createExpressAdapter(handler) {
+  return toExpressHandler(handler);
+}
+
+// src/server/adapters/hono.ts
+function toHonoHandler(handler) {
+  return async (c) => {
+    return handler(c.req.raw);
+  };
+}
+function createHonoRoutes(handler, HonoClass) {
+  const app = new HonoClass();
+  const honoHandler = toHonoHandler(handler);
+  app.get("/info", honoHandler);
+  app.get("/health", honoHandler);
+  app.get("/agents", honoHandler);
+  app.post("/agents", honoHandler);
+  app.get("/agents/:agentId", honoHandler);
+  app.delete("/agents/:agentId", honoHandler);
+  app.get("/agents/:agentId/sse", honoHandler);
+  app.post("/agents/:agentId/messages", honoHandler);
+  app.post("/agents/:agentId/interrupt", honoHandler);
+  app.all("/*", honoHandler);
+  return app;
+}
+function createHonoAdapter(handler) {
+  return toHonoHandler(handler);
+}
+
+// src/server/adapters/next.ts
+function createNextHandler(handler) {
+  const routeHandler = async (request) => {
+    return handler(request);
+  };
+  return {
+    GET: routeHandler,
+    POST: routeHandler,
+    DELETE: routeHandler,
+    PUT: routeHandler,
+    PATCH: routeHandler,
+    HEAD: routeHandler,
+    OPTIONS: routeHandler
+  };
+}
+function toNextHandler(handler) {
+  return async (request) => handler(request);
+}
+function createNextEdgeHandler(handler) {
+  return createNextHandler(handler);
+}
+
+export { createNextHandler as createAgentXRoutes, createExpressAdapter, createHonoAdapter, createHonoRoutes, createNextEdgeHandler, createNextHandler, toExpressHandler, toHonoHandler, toNextHandler };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/server/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/adapters/express.ts","../../../src/server/adapters/hono.ts","../../../src/server/adapters/next.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Express Adapter\n *\n * Adapts AgentXHandler to Express middleware.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { toExpressHandler } from \"agentxjs/server/adapters/express\";\n *\n * const app = express();\n * const handler = createAgentXHandler(agentx);\n *\n * app.use(\"/agentx\", toExpressHandler(handler));\n * app.listen(3000);\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Express-like request interface (minimal)\n */\ninterface ExpressRequest {\n  method: string;\n  url: string;\n  headers: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  protocol?: string;\n  hostname?: string;\n  originalUrl?: string;\n  // For reading body as stream\n  on?: (event: string, handler: (chunk: unknown) => void) => void;\n}\n\n/**\n * Express-like response interface (minimal)\n */\ninterface ExpressResponse {\n  status(code: number): ExpressResponse;\n  set(headers: Record<string, string>): ExpressResponse;\n  setHeader(name: string, value: string): void;\n  write(chunk: string | Uint8Array): boolean;\n  end(data?: string | Buffer): void;\n  headersSent: boolean;\n  flushHeaders?(): void;\n}\n\n/**\n * Express-like next function\n */\ntype ExpressNext = (error?: unknown) => void;\n\n/**\n * Express request handler type\n */\nexport type ExpressHandler = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: ExpressNext\n) => void | Promise<void>;\n\n/**\n * Convert Express request to Web Request\n */\nfunction toWebRequest(req: ExpressRequest): Request {\n  // Build URL\n  const protocol = req.protocol || \"http\";\n  const host = req.hostname || req.headers.host || \"localhost\";\n  const url = `${protocol}://${host}${req.originalUrl || req.url}`;\n\n  // Build headers\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value !== undefined) {\n      if (Array.isArray(value)) {\n        value.forEach((v) => headers.append(key, v));\n      } else {\n        headers.set(key, value);\n      }\n    }\n  }\n\n  // Build request options\n  const init: RequestInit = {\n    method: req.method,\n    headers,\n  };\n\n  // Add body for non-GET/HEAD requests\n  if (req.method !== \"GET\" && req.method !== \"HEAD\") {\n    if (req.body !== undefined) {\n      // Body already parsed (e.g., by express.json())\n      init.body = JSON.stringify(req.body);\n    }\n  }\n\n  return new Request(url, init);\n}\n\n/**\n * Send Web Response to Express response\n */\nasync function sendWebResponse(res: ExpressResponse, webResponse: Response): Promise<void> {\n  // Set status\n  res.status(webResponse.status);\n\n  // Set headers\n  webResponse.headers.forEach((value, key) => {\n    // Skip content-encoding for SSE (we handle it differently)\n    if (key.toLowerCase() !== \"content-encoding\") {\n      res.setHeader(key, value);\n    }\n  });\n\n  // Check if SSE response\n  const contentType = webResponse.headers.get(\"content-type\");\n  if (contentType?.includes(\"text/event-stream\")) {\n    // SSE: Stream the response\n    res.setHeader(\"Cache-Control\", \"no-cache\");\n    res.setHeader(\"Connection\", \"keep-alive\");\n\n    // Flush headers immediately for SSE\n    if (res.flushHeaders) {\n      res.flushHeaders();\n    }\n\n    const reader = webResponse.body?.getReader();\n    if (reader) {\n      const decoder = new TextDecoder();\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          res.write(decoder.decode(value, { stream: true }));\n        }\n      } catch {\n        // Connection closed\n      } finally {\n        reader.releaseLock();\n      }\n    }\n    res.end();\n  } else {\n    // Regular response: Send body as text\n    const body = await webResponse.text();\n    res.end(body);\n  }\n}\n\n/**\n * Convert AgentXHandler to Express middleware\n *\n * @param handler - AgentX handler (Web Standard based)\n * @returns Express middleware function\n */\nexport function toExpressHandler(handler: AgentXHandler): ExpressHandler {\n  return async (req, res, next) => {\n    try {\n      const webRequest = toWebRequest(req);\n      const webResponse = await handler(webRequest);\n      await sendWebResponse(res, webResponse);\n    } catch (error) {\n      next(error);\n    }\n  };\n}\n\n/**\n * Create Express router with AgentX handler\n *\n * This is a convenience function that wraps toExpressHandler\n * and can be used directly with app.use()\n *\n * @param handler - AgentX handler\n * @returns Express handler\n */\nexport function createExpressAdapter(handler: AgentXHandler): ExpressHandler {\n  return toExpressHandler(handler);\n}\n","/**\n * Hono Adapter\n *\n * Adapts AgentXHandler to Hono middleware.\n * Hono already uses Web Standard Request/Response, so this is mostly a convenience wrapper.\n *\n * @example\n * ```typescript\n * import { Hono } from \"hono\";\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { toHonoHandler, createHonoRoutes } from \"agentxjs/server/adapters/hono\";\n *\n * const app = new Hono();\n * const handler = createAgentXHandler(agentx);\n *\n * // Option 1: Simple catch-all\n * app.all(\"/agentx/*\", toHonoHandler(handler));\n *\n * // Option 2: Mount as sub-app\n * app.route(\"/agentx\", createHonoRoutes(handler));\n *\n * export default app;\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Hono Context interface (minimal)\n */\ninterface HonoContext {\n  req: {\n    raw: Request;\n    url: string;\n    method: string;\n    path: string;\n  };\n  // Return response\n  body: (data: ReadableStream | string | ArrayBuffer | null, init?: ResponseInit) => Response;\n  json: (data: unknown, init?: ResponseInit) => Response;\n  text: (data: string, init?: ResponseInit) => Response;\n}\n\n/**\n * Hono handler type\n */\nexport type HonoHandler = (c: HonoContext) => Response | Promise<Response>;\n\n/**\n * Convert AgentXHandler to Hono handler\n *\n * Since Hono uses Web Standard Request/Response natively,\n * this adapter is straightforward.\n *\n * @param handler - AgentX handler\n * @returns Hono handler function\n */\nexport function toHonoHandler(handler: AgentXHandler): HonoHandler {\n  return async (c) => {\n    // Hono provides the raw Web Request directly\n    return handler(c.req.raw);\n  };\n}\n\n/**\n * Hono-like app interface (minimal for sub-routing)\n */\ninterface HonoLike {\n  all(path: string, handler: HonoHandler): HonoLike;\n  get(path: string, handler: HonoHandler): HonoLike;\n  post(path: string, handler: HonoHandler): HonoLike;\n  delete(path: string, handler: HonoHandler): HonoLike;\n}\n\n/**\n * Create a Hono sub-app with all AgentX routes\n *\n * This creates explicit routes for better type safety and documentation.\n *\n * @param handler - AgentX handler\n * @param HonoClass - Hono class constructor (optional, for tree-shaking)\n * @returns Hono app with all routes configured\n *\n * @example\n * ```typescript\n * import { Hono } from \"hono\";\n * import { createHonoRoutes } from \"agentxjs/server/adapters/hono\";\n *\n * const app = new Hono();\n * app.route(\"/agentx\", createHonoRoutes(handler, Hono));\n * ```\n */\nexport function createHonoRoutes<T extends HonoLike>(\n  handler: AgentXHandler,\n  HonoClass: new () => T\n): T {\n  const app = new HonoClass();\n  const honoHandler = toHonoHandler(handler);\n\n  // Platform routes\n  app.get(\"/info\", honoHandler);\n  app.get(\"/health\", honoHandler);\n\n  // Agent collection routes\n  app.get(\"/agents\", honoHandler);\n  app.post(\"/agents\", honoHandler);\n\n  // Agent instance routes\n  app.get(\"/agents/:agentId\", honoHandler);\n  app.delete(\"/agents/:agentId\", honoHandler);\n  app.get(\"/agents/:agentId/sse\", honoHandler);\n  app.post(\"/agents/:agentId/messages\", honoHandler);\n  app.post(\"/agents/:agentId/interrupt\", honoHandler);\n\n  // Catch-all for any missed routes\n  app.all(\"/*\", honoHandler);\n\n  return app;\n}\n\n/**\n * Simple Hono middleware that forwards all requests to handler\n *\n * Use this when you want a simple catch-all without explicit routing.\n *\n * @param handler - AgentX handler\n * @returns Hono handler\n */\nexport function createHonoAdapter(handler: AgentXHandler): HonoHandler {\n  return toHonoHandler(handler);\n}\n","/**\n * Next.js App Router Adapter\n *\n * Adapts AgentXHandler to Next.js App Router route handlers.\n * Next.js App Router uses Web Standard Request/Response natively.\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { createNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = createAgentXHandler(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export const { GET, POST, DELETE } = createNextHandler(handler);\n *\n * // Enable streaming for SSE\n * export const dynamic = \"force-dynamic\";\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Next.js route context\n */\ninterface NextRouteContext {\n  params: Record<string, string | string[]>;\n}\n\n/**\n * Next.js route handler type\n */\nexport type NextRouteHandler = (\n  request: Request,\n  context?: NextRouteContext\n) => Response | Promise<Response>;\n\n/**\n * Next.js route handlers object\n */\nexport interface NextRouteHandlers {\n  GET: NextRouteHandler;\n  POST: NextRouteHandler;\n  DELETE: NextRouteHandler;\n  PUT: NextRouteHandler;\n  PATCH: NextRouteHandler;\n  HEAD: NextRouteHandler;\n  OPTIONS: NextRouteHandler;\n}\n\n/**\n * Create Next.js App Router route handlers\n *\n * @param handler - AgentX handler\n * @returns Object with GET, POST, DELETE, etc. handlers\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = createAgentXHandler(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export const { GET, POST, DELETE } = createNextHandler(handler);\n * ```\n */\nexport function createNextHandler(handler: AgentXHandler): NextRouteHandlers {\n  // All methods use the same handler since routing is done by AgentXHandler\n  const routeHandler: NextRouteHandler = async (request) => {\n    return handler(request);\n  };\n\n  return {\n    GET: routeHandler,\n    POST: routeHandler,\n    DELETE: routeHandler,\n    PUT: routeHandler,\n    PATCH: routeHandler,\n    HEAD: routeHandler,\n    OPTIONS: routeHandler,\n  };\n}\n\n/**\n * Create a single Next.js handler for all methods\n *\n * Use this if you prefer to handle all methods with one export.\n *\n * @param handler - AgentX handler\n * @returns Single route handler\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { toNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = toNextHandler(createAgentXHandler(agentx));\n *\n * export { handler as GET, handler as POST, handler as DELETE };\n * ```\n */\nexport function toNextHandler(handler: AgentXHandler): NextRouteHandler {\n  return async (request) => handler(request);\n}\n\n/**\n * Next.js Edge Runtime compatible handler\n *\n * Use this for edge functions deployment.\n *\n * @param handler - AgentX handler\n * @returns Edge-compatible handler\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createNextEdgeHandler } from \"agentxjs/server/adapters/next\";\n *\n * export const runtime = \"edge\";\n * export const { GET, POST, DELETE } = createNextEdgeHandler(handler);\n * ```\n */\nexport function createNextEdgeHandler(handler: AgentXHandler): NextRouteHandlers {\n  // Edge runtime also uses Web Standard Request/Response\n  return createNextHandler(handler);\n}\n\n/**\n * Convenience export for route.ts files\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createAgentXRoutes } from \"agentxjs/server/adapters/next\";\n *\n * const { GET, POST, DELETE } = createAgentXRoutes(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export { GET, POST, DELETE };\n * export const dynamic = \"force-dynamic\";\n * ```\n */\nexport { createNextHandler as createAgentXRoutes };\n"]}

package/dist/server/adapters/next.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+// src/server/adapters/next.ts
+function createNextHandler(handler) {
+  const routeHandler = async (request) => {
+    return handler(request);
+  };
+  return {
+    GET: routeHandler,
+    POST: routeHandler,
+    DELETE: routeHandler,
+    PUT: routeHandler,
+    PATCH: routeHandler,
+    HEAD: routeHandler,
+    OPTIONS: routeHandler
+  };
+}
+function toNextHandler(handler) {
+  return async (request) => handler(request);
+}
+function createNextEdgeHandler(handler) {
+  return createNextHandler(handler);
+}
+
+exports.createAgentXRoutes = createNextHandler;
+exports.createNextEdgeHandler = createNextEdgeHandler;
+exports.createNextHandler = createNextHandler;
+exports.toNextHandler = toNextHandler;
+//# sourceMappingURL=next.cjs.map
+//# sourceMappingURL=next.cjs.map

package/dist/server/adapters/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/adapters/next.ts"],"names":[],"mappings":";;;AAwEO,SAAS,kBAAkB,OAAA,EAA2C;AAE3E,EAAA,MAAM,YAAA,GAAiC,OAAO,OAAA,KAAY;AACxD,IAAA,OAAO,QAAQ,OAAO,CAAA;AAAA,EACxB,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,YAAA;AAAA,IACL,IAAA,EAAM,YAAA;AAAA,IACN,MAAA,EAAQ,YAAA;AAAA,IACR,GAAA,EAAK,YAAA;AAAA,IACL,KAAA,EAAO,YAAA;AAAA,IACP,IAAA,EAAM,YAAA;AAAA,IACN,OAAA,EAAS;AAAA,GACX;AACF;AAoBO,SAAS,cAAc,OAAA,EAA0C;AACtE,EAAA,OAAO,OAAO,OAAA,KAAY,OAAA,CAAQ,OAAO,CAAA;AAC3C;AAmBO,SAAS,sBAAsB,OAAA,EAA2C;AAE/E,EAAA,OAAO,kBAAkB,OAAO,CAAA;AAClC","file":"next.cjs","sourcesContent":["/**\n * Next.js App Router Adapter\n *\n * Adapts AgentXHandler to Next.js App Router route handlers.\n * Next.js App Router uses Web Standard Request/Response natively.\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { agentx } from \"agentxjs\";\n * import { createAgentXHandler } from \"agentxjs/server\";\n * import { createNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = createAgentXHandler(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export const { GET, POST, DELETE } = createNextHandler(handler);\n *\n * // Enable streaming for SSE\n * export const dynamic = \"force-dynamic\";\n * ```\n */\n\nimport type { AgentXHandler } from \"../types\";\n\n/**\n * Next.js route context\n */\ninterface NextRouteContext {\n  params: Record<string, string | string[]>;\n}\n\n/**\n * Next.js route handler type\n */\nexport type NextRouteHandler = (\n  request: Request,\n  context?: NextRouteContext\n) => Response | Promise<Response>;\n\n/**\n * Next.js route handlers object\n */\nexport interface NextRouteHandlers {\n  GET: NextRouteHandler;\n  POST: NextRouteHandler;\n  DELETE: NextRouteHandler;\n  PUT: NextRouteHandler;\n  PATCH: NextRouteHandler;\n  HEAD: NextRouteHandler;\n  OPTIONS: NextRouteHandler;\n}\n\n/**\n * Create Next.js App Router route handlers\n *\n * @param handler - AgentX handler\n * @returns Object with GET, POST, DELETE, etc. handlers\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = createAgentXHandler(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export const { GET, POST, DELETE } = createNextHandler(handler);\n * ```\n */\nexport function createNextHandler(handler: AgentXHandler): NextRouteHandlers {\n  // All methods use the same handler since routing is done by AgentXHandler\n  const routeHandler: NextRouteHandler = async (request) => {\n    return handler(request);\n  };\n\n  return {\n    GET: routeHandler,\n    POST: routeHandler,\n    DELETE: routeHandler,\n    PUT: routeHandler,\n    PATCH: routeHandler,\n    HEAD: routeHandler,\n    OPTIONS: routeHandler,\n  };\n}\n\n/**\n * Create a single Next.js handler for all methods\n *\n * Use this if you prefer to handle all methods with one export.\n *\n * @param handler - AgentX handler\n * @returns Single route handler\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { toNextHandler } from \"agentxjs/server/adapters/next\";\n *\n * const handler = toNextHandler(createAgentXHandler(agentx));\n *\n * export { handler as GET, handler as POST, handler as DELETE };\n * ```\n */\nexport function toNextHandler(handler: AgentXHandler): NextRouteHandler {\n  return async (request) => handler(request);\n}\n\n/**\n * Next.js Edge Runtime compatible handler\n *\n * Use this for edge functions deployment.\n *\n * @param handler - AgentX handler\n * @returns Edge-compatible handler\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createNextEdgeHandler } from \"agentxjs/server/adapters/next\";\n *\n * export const runtime = \"edge\";\n * export const { GET, POST, DELETE } = createNextEdgeHandler(handler);\n * ```\n */\nexport function createNextEdgeHandler(handler: AgentXHandler): NextRouteHandlers {\n  // Edge runtime also uses Web Standard Request/Response\n  return createNextHandler(handler);\n}\n\n/**\n * Convenience export for route.ts files\n *\n * @example\n * ```typescript\n * // app/api/agentx/[...path]/route.ts\n * import { createAgentXRoutes } from \"agentxjs/server/adapters/next\";\n *\n * const { GET, POST, DELETE } = createAgentXRoutes(agentx, {\n *   basePath: \"/api/agentx\",\n * });\n *\n * export { GET, POST, DELETE };\n * export const dynamic = \"force-dynamic\";\n * ```\n */\nexport { createNextHandler as createAgentXRoutes };\n"]}

package/dist/server/adapters/next.d.cts

@@ -0,0 +1,107 @@
+import { A as AgentXHandler } from '../../types-Cgfcw91r.cjs';
+import '@agentxjs/types';
+
+/**
+ * Next.js App Router Adapter
+ *
+ * Adapts AgentXHandler to Next.js App Router route handlers.
+ * Next.js App Router uses Web Standard Request/Response natively.
+ *
+ * @example
+ * ```typescript
+ * // app/api/agentx/[...path]/route.ts
+ * import { agentx } from "agentxjs";
+ * import { createAgentXHandler } from "agentxjs/server";
+ * import { createNextHandler } from "agentxjs/server/adapters/next";
+ *
+ * const handler = createAgentXHandler(agentx, {
+ *   basePath: "/api/agentx",
+ * });
+ *
+ * export const { GET, POST, DELETE } = createNextHandler(handler);
+ *
+ * // Enable streaming for SSE
+ * export const dynamic = "force-dynamic";
+ * ```
+ */
+
+/**
+ * Next.js route context
+ */
+interface NextRouteContext {
+    params: Record<string, string | string[]>;
+}
+/**
+ * Next.js route handler type
+ */
+type NextRouteHandler = (request: Request, context?: NextRouteContext) => Response | Promise<Response>;
+/**
+ * Next.js route handlers object
+ */
+interface NextRouteHandlers {
+    GET: NextRouteHandler;
+    POST: NextRouteHandler;
+    DELETE: NextRouteHandler;
+    PUT: NextRouteHandler;
+    PATCH: NextRouteHandler;
+    HEAD: NextRouteHandler;
+    OPTIONS: NextRouteHandler;
+}
+/**
+ * Create Next.js App Router route handlers
+ *
+ * @param handler - AgentX handler
+ * @returns Object with GET, POST, DELETE, etc. handlers
+ *
+ * @example
+ * ```typescript
+ * // app/api/agentx/[...path]/route.ts
+ * import { createNextHandler } from "agentxjs/server/adapters/next";
+ *
+ * const handler = createAgentXHandler(agentx, {
+ *   basePath: "/api/agentx",
+ * });
+ *
+ * export const { GET, POST, DELETE } = createNextHandler(handler);
+ * ```
+ */
+declare function createNextHandler(handler: AgentXHandler): NextRouteHandlers;
+/**
+ * Create a single Next.js handler for all methods
+ *
+ * Use this if you prefer to handle all methods with one export.
+ *
+ * @param handler - AgentX handler
+ * @returns Single route handler
+ *
+ * @example
+ * ```typescript
+ * // app/api/agentx/[...path]/route.ts
+ * import { toNextHandler } from "agentxjs/server/adapters/next";
+ *
+ * const handler = toNextHandler(createAgentXHandler(agentx));
+ *
+ * export { handler as GET, handler as POST, handler as DELETE };
+ * ```
+ */
+declare function toNextHandler(handler: AgentXHandler): NextRouteHandler;
+/**
+ * Next.js Edge Runtime compatible handler
+ *
+ * Use this for edge functions deployment.
+ *
+ * @param handler - AgentX handler
+ * @returns Edge-compatible handler
+ *
+ * @example
+ * ```typescript
+ * // app/api/agentx/[...path]/route.ts
+ * import { createNextEdgeHandler } from "agentxjs/server/adapters/next";
+ *
+ * export const runtime = "edge";
+ * export const { GET, POST, DELETE } = createNextEdgeHandler(handler);
+ * ```
+ */
+declare function createNextEdgeHandler(handler: AgentXHandler): NextRouteHandlers;
+
+export { type NextRouteHandler, type NextRouteHandlers, createNextHandler as createAgentXRoutes, createNextEdgeHandler, createNextHandler, toNextHandler };