@ai-me-chat/nextjs 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI-Me Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,262 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createAIMeHandler: () => createAIMeHandler,
+  filterRoutes: () => filterRoutes,
+  scanRoutes: () => scanRoutes
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/scanner.ts
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+var ROUTE_FILE_NAMES = ["route.ts", "route.js", "route.tsx", "route.jsx"];
+function scanRoutes(appDir) {
+  const apiDir = path.join(appDir, "api");
+  if (!fs.existsSync(apiDir)) {
+    return [];
+  }
+  const routes = [];
+  walkDirectory(apiDir, appDir, routes);
+  return routes.sort((a, b) => a.path.localeCompare(b.path));
+}
+function walkDirectory(dir, appDir, routes) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      walkDirectory(fullPath, appDir, routes);
+    } else if (ROUTE_FILE_NAMES.includes(entry.name)) {
+      const route = parseRouteFile(fullPath, appDir);
+      if (route && route.methods.length > 0) {
+        routes.push(route);
+      }
+    }
+  }
+}
+function parseRouteFile(filePath, appDir) {
+  const content = fs.readFileSync(filePath, "utf-8");
+  const methods = extractHttpMethods(content);
+  if (methods.length === 0) {
+    return null;
+  }
+  const relativePath = path.relative(appDir, path.dirname(filePath));
+  const apiPath = "/" + relativePath.split(path.sep).join("/");
+  const pathParams = extractPathParams(apiPath);
+  return {
+    path: cleanPath(apiPath),
+    methods,
+    pathParams,
+    filePath: path.relative(path.resolve(appDir, ".."), filePath)
+  };
+}
+function extractHttpMethods(content) {
+  const methods = [];
+  for (const method of HTTP_METHODS) {
+    const patterns = [
+      // export async function GET(
+      new RegExp(`export\\s+(async\\s+)?function\\s+${method}\\s*\\(`),
+      // export const GET =
+      new RegExp(`export\\s+const\\s+${method}\\s*=`),
+      // export { handler as GET }
+      new RegExp(`export\\s*\\{[^}]*\\bas\\s+${method}\\b[^}]*\\}`)
+    ];
+    if (patterns.some((p) => p.test(content))) {
+      methods.push(method);
+    }
+  }
+  return methods;
+}
+function extractPathParams(routePath) {
+  const params = [];
+  const matches = routePath.matchAll(/\[([^\]]+)\]/g);
+  for (const match of matches) {
+    params.push(match[1]);
+  }
+  return params;
+}
+function cleanPath(routePath) {
+  return routePath.replace(/\/\([^)]+\)/g, "").replace(/\[\.\.\.(\w+)\]/g, ":$1*").replace(/\[(\w+)\]/g, ":$1");
+}
+
+// src/filter.ts
+var import_picomatch = __toESM(require("picomatch"), 1);
+function filterRoutes(routes, config) {
+  let filtered = routes;
+  if (config.include && config.include.length > 0) {
+    const isIncluded = (0, import_picomatch.default)(config.include);
+    filtered = filtered.filter((r) => isIncluded(r.path));
+  }
+  if (config.exclude && config.exclude.length > 0) {
+    const isExcluded = (0, import_picomatch.default)(config.exclude);
+    filtered = filtered.filter((r) => !isExcluded(r.path));
+  }
+  return filtered;
+}
+
+// src/handler.ts
+var import_ai = require("ai");
+var import_core = require("@ai-me-chat/core");
+function createAIMeHandler(config) {
+  let toolDefinitions = null;
+  let toolsPromise = null;
+  async function getToolDefinitions(appDir) {
+    if (toolDefinitions) return toolDefinitions;
+    if (toolsPromise) return toolsPromise;
+    toolsPromise = initTools(appDir);
+    toolDefinitions = await toolsPromise;
+    toolsPromise = null;
+    return toolDefinitions;
+  }
+  async function initTools(appDir) {
+    if (config.discovery.mode === "openapi") {
+      let spec;
+      if (config.discovery.spec) {
+        spec = config.discovery.spec;
+      } else if (config.discovery.specUrl) {
+        spec = await (0, import_core.fetchOpenAPISpec)(config.discovery.specUrl);
+      } else {
+        throw new Error(
+          'OpenAPI discovery mode requires either "spec" (inline object) or "specUrl" (remote URL) in discovery config'
+        );
+      }
+      const tools = (0, import_core.generateToolsFromOpenAPI)(spec, config.confirmation);
+      if (config.discovery.include || config.discovery.exclude) {
+        const routes2 = tools.map((t) => ({
+          path: t.path ?? "",
+          methods: [t.httpMethod ?? "GET"],
+          pathParams: [],
+          filePath: ""
+        }));
+        const filtered = filterRoutes(routes2, config.discovery);
+        const filteredPaths = new Set(
+          filtered.flatMap((r) => r.methods.map((m) => `${m}:${r.path}`))
+        );
+        return tools.filter((t) => filteredPaths.has(`${t.httpMethod}:${t.path}`));
+      }
+      return tools;
+    }
+    let routes = scanRoutes(appDir);
+    routes = filterRoutes(routes, config.discovery);
+    return (0, import_core.generateToolDefinitions)(routes, config.confirmation);
+  }
+  async function handler(req) {
+    const session = await config.getSession(req);
+    if (!session) {
+      return new Response("Unauthorized", { status: 401 });
+    }
+    const url = new URL(req.url);
+    if (req.method === "GET" && url.pathname.endsWith("/tools")) {
+      const appDir = process.cwd() + "/app";
+      let tools;
+      try {
+        tools = await getToolDefinitions(appDir);
+      } catch (error) {
+        return new Response(
+          JSON.stringify({ error: error instanceof Error ? error.message : "Tool discovery failed" }),
+          { status: 500, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      return Response.json(
+        tools.map((t) => ({
+          name: t.name,
+          description: t.description,
+          httpMethod: t.httpMethod,
+          path: t.path,
+          requiresConfirmation: t.requiresConfirmation
+        }))
+      );
+    }
+    if (req.method === "GET" && url.pathname.endsWith("/health")) {
+      return Response.json({ status: "ok", version: "0.0.1" });
+    }
+    if (req.method === "POST") {
+      return handleChat(req, config, session, getToolDefinitions);
+    }
+    return new Response("Not Found", { status: 404 });
+  }
+  return handler;
+}
+async function handleChat(req, config, session, getToolDefinitions) {
+  const { messages } = await req.json();
+  const appDir = process.cwd() + "/app";
+  const toolDefs = await getToolDefinitions(appDir);
+  const baseUrl = new URL(req.url).origin;
+  const executionContext = {
+    baseUrl,
+    headers: {
+      cookie: req.headers.get("cookie") ?? "",
+      authorization: req.headers.get("authorization") ?? ""
+    }
+  };
+  const aiTools = {};
+  for (const toolDef of toolDefs) {
+    const def = toolDef;
+    aiTools[def.name] = (0, import_ai.tool)({
+      description: def.description,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      inputSchema: def.parameters,
+      // Disable strict schema validation for OpenAI-compatible providers
+      // (e.g., Groq) that reject additionalProperties in tool schemas
+      strict: false,
+      execute: async (params) => {
+        const result2 = await (0, import_core.executeTool)(
+          def,
+          params,
+          executionContext
+        );
+        return result2.response;
+      }
+    });
+  }
+  const modelMessages = await (0, import_ai.convertToModelMessages)(messages);
+  const maxHistory = config.maxHistoryMessages ?? 20;
+  const trimmedMessages = modelMessages.length > maxHistory ? modelMessages.slice(-maxHistory) : modelMessages;
+  const result = (0, import_ai.streamText)({
+    model: config.model,
+    system: config.systemPrompt ?? `You are an AI assistant for this application. You can help users query data and perform actions. User: ${session.user.id}${session.user.role ? ` (role: ${session.user.role})` : ""}`,
+    messages: trimmedMessages,
+    tools: aiTools,
+    stopWhen: (0, import_ai.stepCountIs)(5),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ...config.providerOptions ? { providerOptions: config.providerOptions } : {}
+  });
+  return result.toUIMessageStreamResponse();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAIMeHandler,
+  filterRoutes,
+  scanRoutes
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/scanner.ts","../src/filter.ts","../src/handler.ts"],"sourcesContent":["export { scanRoutes } from \"./scanner.js\";\nexport { filterRoutes } from \"./filter.js\";\nexport { createAIMeHandler } from \"./handler.js\";\n","import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { DiscoveredRoute } from \"@ai-me-chat/core\";\n\nconst HTTP_METHODS = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\"] as const;\n\nconst ROUTE_FILE_NAMES = [\"route.ts\", \"route.js\", \"route.tsx\", \"route.jsx\"];\n\n/**\n * Scan a Next.js App Router directory for API routes.\n * Finds all route.ts/route.js files under `appDir/api/` and extracts\n * HTTP methods and path parameters.\n */\nexport function scanRoutes(appDir: string): DiscoveredRoute[] {\n  const apiDir = path.join(appDir, \"api\");\n  if (!fs.existsSync(apiDir)) {\n    return [];\n  }\n  const routes: DiscoveredRoute[] = [];\n  walkDirectory(apiDir, appDir, routes);\n  return routes.sort((a, b) => a.path.localeCompare(b.path));\n}\n\nfunction walkDirectory(\n  dir: string,\n  appDir: string,\n  routes: DiscoveredRoute[],\n): void {\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      walkDirectory(fullPath, appDir, routes);\n    } else if (ROUTE_FILE_NAMES.includes(entry.name)) {\n      const route = parseRouteFile(fullPath, appDir);\n      if (route && route.methods.length > 0) {\n        routes.push(route);\n      }\n    }\n  }\n}\n\nfunction parseRouteFile(filePath: string, appDir: string): DiscoveredRoute | null {\n  const content = fs.readFileSync(filePath, \"utf-8\");\n  const methods = extractHttpMethods(content);\n\n  if (methods.length === 0) {\n    return null;\n  }\n\n  const relativePath = path.relative(appDir, path.dirname(filePath));\n  const apiPath = \"/\" + relativePath.split(path.sep).join(\"/\");\n  const pathParams = extractPathParams(apiPath);\n\n  return {\n    path: cleanPath(apiPath),\n    methods,\n    pathParams,\n    filePath: path.relative(path.resolve(appDir, \"..\"), filePath),\n  };\n}\n\n/**\n * Extract exported HTTP method handlers from route file content.\n * Matches patterns like:\n *   export async function GET(...)\n *   export function POST(...)\n *   export const PUT = ...\n *   export { handler as DELETE }\n */\nfunction extractHttpMethods(content: string): string[] {\n  const methods: string[] = [];\n\n  for (const method of HTTP_METHODS) {\n    const patterns = [\n      // export async function GET(\n      new RegExp(`export\\\\s+(async\\\\s+)?function\\\\s+${method}\\\\s*\\\\(`),\n      // export const GET =\n      new RegExp(`export\\\\s+const\\\\s+${method}\\\\s*=`),\n      // export { handler as GET }\n      new RegExp(`export\\\\s*\\\\{[^}]*\\\\bas\\\\s+${method}\\\\b[^}]*\\\\}`),\n    ];\n\n    if (patterns.some((p) => p.test(content))) {\n      methods.push(method);\n    }\n  }\n\n  return methods;\n}\n\n/**\n * Extract path parameters from a Next.js dynamic route path.\n * e.g., \"/api/projects/[id]/tasks/[taskId]\" → [\"id\", \"taskId\"]\n */\nfunction extractPathParams(routePath: string): string[] {\n  const params: string[] = [];\n  const matches = routePath.matchAll(/\\[([^\\]]+)\\]/g);\n  for (const match of matches) {\n    params.push(match[1]);\n  }\n  return params;\n}\n\n/**\n * Clean up path by removing route groups like (group) and catch-all segments.\n * Converts Next.js bracket params to colon params for readability.\n * e.g., \"/api/(admin)/users/[id]\" → \"/api/users/:id\"\n */\nfunction cleanPath(routePath: string): string {\n  return routePath\n    .replace(/\\/\\([^)]+\\)/g, \"\") // Remove route groups\n    .replace(/\\[\\.\\.\\.(\\w+)\\]/g, \":$1*\") // Catch-all [...slug] → :slug*\n    .replace(/\\[(\\w+)\\]/g, \":$1\"); // Dynamic [id] → :id\n}\n","import picomatch from \"picomatch\";\nimport type { DiscoveredRoute, DiscoveryConfig } from \"@ai-me-chat/core\";\n\n/**\n * Filter discovered routes based on include/exclude glob patterns.\n * - If include is specified, only routes matching at least one include pattern are kept.\n * - If exclude is specified, routes matching any exclude pattern are removed.\n * - Exclude takes precedence over include.\n */\nexport function filterRoutes(\n  routes: DiscoveredRoute[],\n  config: Pick<DiscoveryConfig, \"include\" | \"exclude\">,\n): DiscoveredRoute[] {\n  let filtered = routes;\n\n  if (config.include && config.include.length > 0) {\n    const isIncluded = picomatch(config.include);\n    filtered = filtered.filter((r) => isIncluded(r.path));\n  }\n\n  if (config.exclude && config.exclude.length > 0) {\n    const isExcluded = picomatch(config.exclude);\n    filtered = filtered.filter((r) => !isExcluded(r.path));\n  }\n\n  return filtered;\n}\n","import { streamText, convertToModelMessages, tool, stepCountIs } from \"ai\";\nimport type { UIMessage } from \"ai\";\nimport {\n  type AIMeConfig,\n  type AIMeToolDefinition,\n  generateToolDefinitions,\n  generateToolsFromOpenAPI,\n  fetchOpenAPISpec,\n  executeTool,\n} from \"@ai-me-chat/core\";\nimport type { OpenAPISpec, ExecutionContext } from \"@ai-me-chat/core\";\nimport { scanRoutes } from \"./scanner.js\";\nimport { filterRoutes } from \"./filter.js\";\n\n/**\n * Create an AI-Me API route handler for Next.js App Router.\n *\n * Usage:\n *   const handler = createAIMeHandler({ model, discovery, getSession });\n *   export { handler as GET, handler as POST };\n */\nexport function createAIMeHandler(config: AIMeConfig) {\n  // Discover tools at initialization time\n  let toolDefinitions: AIMeToolDefinition[] | null = null;\n  let toolsPromise: Promise<AIMeToolDefinition[]> | null = null;\n\n  async function getToolDefinitions(appDir: string): Promise<AIMeToolDefinition[]> {\n    if (toolDefinitions) return toolDefinitions;\n    if (toolsPromise) return toolsPromise;\n\n    toolsPromise = initTools(appDir);\n    toolDefinitions = await toolsPromise;\n    toolsPromise = null;\n    return toolDefinitions;\n  }\n\n  async function initTools(appDir: string): Promise<AIMeToolDefinition[]> {\n    if (config.discovery.mode === \"openapi\") {\n      let spec: OpenAPISpec;\n      if (config.discovery.spec) {\n        spec = config.discovery.spec as unknown as OpenAPISpec;\n      } else if (config.discovery.specUrl) {\n        spec = await fetchOpenAPISpec(config.discovery.specUrl);\n      } else {\n        throw new Error(\n          'OpenAPI discovery mode requires either \"spec\" (inline object) or \"specUrl\" (remote URL) in discovery config',\n        );\n      }\n      const tools = generateToolsFromOpenAPI(spec, config.confirmation);\n      if (config.discovery.include || config.discovery.exclude) {\n        const routes = tools.map((t) => ({\n          path: t.path ?? \"\",\n          methods: [t.httpMethod ?? \"GET\"],\n          pathParams: [],\n          filePath: \"\",\n        }));\n        const filtered = filterRoutes(routes, config.discovery);\n        const filteredPaths = new Set(\n          filtered.flatMap((r) => r.methods.map((m) => `${m}:${r.path}`)),\n        );\n        return tools.filter((t) => filteredPaths.has(`${t.httpMethod}:${t.path}`));\n      }\n      return tools;\n    }\n\n    let routes = scanRoutes(appDir);\n    routes = filterRoutes(routes, config.discovery);\n    return generateToolDefinitions(routes, config.confirmation);\n  }\n\n  async function handler(req: Request): Promise<Response> {\n    // Auth check\n    const session = await config.getSession(req);\n    if (!session) {\n      return new Response(\"Unauthorized\", { status: 401 });\n    }\n\n    const url = new URL(req.url);\n\n    // Route: GET /api/ai-me/tools — list available tools (debug)\n    if (req.method === \"GET\" && url.pathname.endsWith(\"/tools\")) {\n      const appDir = process.cwd() + \"/app\";\n      let tools: AIMeToolDefinition[];\n      try {\n        tools = await getToolDefinitions(appDir);\n      } catch (error) {\n        return new Response(\n          JSON.stringify({ error: error instanceof Error ? error.message : \"Tool discovery failed\" }),\n          { status: 500, headers: { \"Content-Type\": \"application/json\" } },\n        );\n      }\n      return Response.json(\n        tools.map((t) => ({\n          name: t.name,\n          description: t.description,\n          httpMethod: t.httpMethod,\n          path: t.path,\n          requiresConfirmation: t.requiresConfirmation,\n        })),\n      );\n    }\n\n    // Route: GET /api/ai-me/health\n    if (req.method === \"GET\" && url.pathname.endsWith(\"/health\")) {\n      return Response.json({ status: \"ok\", version: \"0.0.1\" });\n    }\n\n    // Route: POST /api/ai-me (chat)\n    if (req.method === \"POST\") {\n      return handleChat(req, config, session, getToolDefinitions);\n    }\n\n    return new Response(\"Not Found\", { status: 404 });\n  }\n\n  return handler;\n}\n\nasync function handleChat(\n  req: Request,\n  config: AIMeConfig,\n  session: NonNullable<Awaited<ReturnType<AIMeConfig[\"getSession\"]>>>,\n  getToolDefinitions: (appDir: string) => Promise<AIMeToolDefinition[]>,\n): Promise<Response> {\n  const { messages }: { messages: UIMessage[] } = await req.json();\n  const appDir = process.cwd() + \"/app\";\n  const toolDefs = await getToolDefinitions(appDir);\n\n  // Build execution context with forwarded auth headers\n  const baseUrl = new URL(req.url).origin;\n  const executionContext: ExecutionContext = {\n    baseUrl,\n    headers: {\n      cookie: req.headers.get(\"cookie\") ?? \"\",\n      authorization: req.headers.get(\"authorization\") ?? \"\",\n    },\n  };\n\n  // Convert tool definitions to AI SDK v6 tool() format\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const aiTools: Record<string, any> = {};\n  for (const toolDef of toolDefs) {\n    const def = toolDef; // capture for closure\n    aiTools[def.name] = tool({\n      description: def.description,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      inputSchema: def.parameters as any,\n      // Disable strict schema validation for OpenAI-compatible providers\n      // (e.g., Groq) that reject additionalProperties in tool schemas\n      strict: false,\n      execute: async (params: Record<string, unknown>) => {\n        const result = await executeTool(\n          def,\n          params,\n          executionContext,\n        );\n        return result.response;\n      },\n    });\n  }\n\n  const modelMessages = await convertToModelMessages(messages);\n\n  // Limit history if configured\n  const maxHistory = config.maxHistoryMessages ?? 20;\n  const trimmedMessages =\n    modelMessages.length > maxHistory\n      ? modelMessages.slice(-maxHistory)\n      : modelMessages;\n\n  const result = streamText({\n    model: config.model,\n    system:\n      config.systemPrompt ??\n      `You are an AI assistant for this application. You can help users query data and perform actions. User: ${session.user.id}${session.user.role ? ` (role: ${session.user.role})` : \"\"}`,\n    messages: trimmedMessages,\n    tools: aiTools,\n    stopWhen: stepCountIs(5),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    ...(config.providerOptions ? { providerOptions: config.providerOptions as any } : {}),\n  });\n\n  return result.toUIMessageStreamResponse();\n}\n"],"mappings":"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","names":["picomatch","routes","result"]}

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+import { DiscoveredRoute, DiscoveryConfig, AIMeConfig } from '@ai-me-chat/core';
+
+/**
+ * Scan a Next.js App Router directory for API routes.
+ * Finds all route.ts/route.js files under `appDir/api/` and extracts
+ * HTTP methods and path parameters.
+ */
+declare function scanRoutes(appDir: string): DiscoveredRoute[];
+
+/**
+ * Filter discovered routes based on include/exclude glob patterns.
+ * - If include is specified, only routes matching at least one include pattern are kept.
+ * - If exclude is specified, routes matching any exclude pattern are removed.
+ * - Exclude takes precedence over include.
+ */
+declare function filterRoutes(routes: DiscoveredRoute[], config: Pick<DiscoveryConfig, "include" | "exclude">): DiscoveredRoute[];
+
+/**
+ * Create an AI-Me API route handler for Next.js App Router.
+ *
+ * Usage:
+ *   const handler = createAIMeHandler({ model, discovery, getSession });
+ *   export { handler as GET, handler as POST };
+ */
+declare function createAIMeHandler(config: AIMeConfig): (req: Request) => Promise<Response>;
+
+export { createAIMeHandler, filterRoutes, scanRoutes };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { DiscoveredRoute, DiscoveryConfig, AIMeConfig } from '@ai-me-chat/core';
+
+/**
+ * Scan a Next.js App Router directory for API routes.
+ * Finds all route.ts/route.js files under `appDir/api/` and extracts
+ * HTTP methods and path parameters.
+ */
+declare function scanRoutes(appDir: string): DiscoveredRoute[];
+
+/**
+ * Filter discovered routes based on include/exclude glob patterns.
+ * - If include is specified, only routes matching at least one include pattern are kept.
+ * - If exclude is specified, routes matching any exclude pattern are removed.
+ * - Exclude takes precedence over include.
+ */
+declare function filterRoutes(routes: DiscoveredRoute[], config: Pick<DiscoveryConfig, "include" | "exclude">): DiscoveredRoute[];
+
+/**
+ * Create an AI-Me API route handler for Next.js App Router.
+ *
+ * Usage:
+ *   const handler = createAIMeHandler({ model, discovery, getSession });
+ *   export { handler as GET, handler as POST };
+ */
+declare function createAIMeHandler(config: AIMeConfig): (req: Request) => Promise<Response>;
+
+export { createAIMeHandler, filterRoutes, scanRoutes };

package/dist/index.js

@@ -0,0 +1,228 @@
+// src/scanner.ts
+import * as fs from "fs";
+import * as path from "path";
+var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+var ROUTE_FILE_NAMES = ["route.ts", "route.js", "route.tsx", "route.jsx"];
+function scanRoutes(appDir) {
+  const apiDir = path.join(appDir, "api");
+  if (!fs.existsSync(apiDir)) {
+    return [];
+  }
+  const routes = [];
+  walkDirectory(apiDir, appDir, routes);
+  return routes.sort((a, b) => a.path.localeCompare(b.path));
+}
+function walkDirectory(dir, appDir, routes) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      walkDirectory(fullPath, appDir, routes);
+    } else if (ROUTE_FILE_NAMES.includes(entry.name)) {
+      const route = parseRouteFile(fullPath, appDir);
+      if (route && route.methods.length > 0) {
+        routes.push(route);
+      }
+    }
+  }
+}
+function parseRouteFile(filePath, appDir) {
+  const content = fs.readFileSync(filePath, "utf-8");
+  const methods = extractHttpMethods(content);
+  if (methods.length === 0) {
+    return null;
+  }
+  const relativePath = path.relative(appDir, path.dirname(filePath));
+  const apiPath = "/" + relativePath.split(path.sep).join("/");
+  const pathParams = extractPathParams(apiPath);
+  return {
+    path: cleanPath(apiPath),
+    methods,
+    pathParams,
+    filePath: path.relative(path.resolve(appDir, ".."), filePath)
+  };
+}
+function extractHttpMethods(content) {
+  const methods = [];
+  for (const method of HTTP_METHODS) {
+    const patterns = [
+      // export async function GET(
+      new RegExp(`export\\s+(async\\s+)?function\\s+${method}\\s*\\(`),
+      // export const GET =
+      new RegExp(`export\\s+const\\s+${method}\\s*=`),
+      // export { handler as GET }
+      new RegExp(`export\\s*\\{[^}]*\\bas\\s+${method}\\b[^}]*\\}`)
+    ];
+    if (patterns.some((p) => p.test(content))) {
+      methods.push(method);
+    }
+  }
+  return methods;
+}
+function extractPathParams(routePath) {
+  const params = [];
+  const matches = routePath.matchAll(/\[([^\]]+)\]/g);
+  for (const match of matches) {
+    params.push(match[1]);
+  }
+  return params;
+}
+function cleanPath(routePath) {
+  return routePath.replace(/\/\([^)]+\)/g, "").replace(/\[\.\.\.(\w+)\]/g, ":$1*").replace(/\[(\w+)\]/g, ":$1");
+}
+
+// src/filter.ts
+import picomatch from "picomatch";
+function filterRoutes(routes, config) {
+  let filtered = routes;
+  if (config.include && config.include.length > 0) {
+    const isIncluded = picomatch(config.include);
+    filtered = filtered.filter((r) => isIncluded(r.path));
+  }
+  if (config.exclude && config.exclude.length > 0) {
+    const isExcluded = picomatch(config.exclude);
+    filtered = filtered.filter((r) => !isExcluded(r.path));
+  }
+  return filtered;
+}
+
+// src/handler.ts
+import { streamText, convertToModelMessages, tool, stepCountIs } from "ai";
+import {
+  generateToolDefinitions,
+  generateToolsFromOpenAPI,
+  fetchOpenAPISpec,
+  executeTool
+} from "@ai-me-chat/core";
+function createAIMeHandler(config) {
+  let toolDefinitions = null;
+  let toolsPromise = null;
+  async function getToolDefinitions(appDir) {
+    if (toolDefinitions) return toolDefinitions;
+    if (toolsPromise) return toolsPromise;
+    toolsPromise = initTools(appDir);
+    toolDefinitions = await toolsPromise;
+    toolsPromise = null;
+    return toolDefinitions;
+  }
+  async function initTools(appDir) {
+    if (config.discovery.mode === "openapi") {
+      let spec;
+      if (config.discovery.spec) {
+        spec = config.discovery.spec;
+      } else if (config.discovery.specUrl) {
+        spec = await fetchOpenAPISpec(config.discovery.specUrl);
+      } else {
+        throw new Error(
+          'OpenAPI discovery mode requires either "spec" (inline object) or "specUrl" (remote URL) in discovery config'
+        );
+      }
+      const tools = generateToolsFromOpenAPI(spec, config.confirmation);
+      if (config.discovery.include || config.discovery.exclude) {
+        const routes2 = tools.map((t) => ({
+          path: t.path ?? "",
+          methods: [t.httpMethod ?? "GET"],
+          pathParams: [],
+          filePath: ""
+        }));
+        const filtered = filterRoutes(routes2, config.discovery);
+        const filteredPaths = new Set(
+          filtered.flatMap((r) => r.methods.map((m) => `${m}:${r.path}`))
+        );
+        return tools.filter((t) => filteredPaths.has(`${t.httpMethod}:${t.path}`));
+      }
+      return tools;
+    }
+    let routes = scanRoutes(appDir);
+    routes = filterRoutes(routes, config.discovery);
+    return generateToolDefinitions(routes, config.confirmation);
+  }
+  async function handler(req) {
+    const session = await config.getSession(req);
+    if (!session) {
+      return new Response("Unauthorized", { status: 401 });
+    }
+    const url = new URL(req.url);
+    if (req.method === "GET" && url.pathname.endsWith("/tools")) {
+      const appDir = process.cwd() + "/app";
+      let tools;
+      try {
+        tools = await getToolDefinitions(appDir);
+      } catch (error) {
+        return new Response(
+          JSON.stringify({ error: error instanceof Error ? error.message : "Tool discovery failed" }),
+          { status: 500, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      return Response.json(
+        tools.map((t) => ({
+          name: t.name,
+          description: t.description,
+          httpMethod: t.httpMethod,
+          path: t.path,
+          requiresConfirmation: t.requiresConfirmation
+        }))
+      );
+    }
+    if (req.method === "GET" && url.pathname.endsWith("/health")) {
+      return Response.json({ status: "ok", version: "0.0.1" });
+    }
+    if (req.method === "POST") {
+      return handleChat(req, config, session, getToolDefinitions);
+    }
+    return new Response("Not Found", { status: 404 });
+  }
+  return handler;
+}
+async function handleChat(req, config, session, getToolDefinitions) {
+  const { messages } = await req.json();
+  const appDir = process.cwd() + "/app";
+  const toolDefs = await getToolDefinitions(appDir);
+  const baseUrl = new URL(req.url).origin;
+  const executionContext = {
+    baseUrl,
+    headers: {
+      cookie: req.headers.get("cookie") ?? "",
+      authorization: req.headers.get("authorization") ?? ""
+    }
+  };
+  const aiTools = {};
+  for (const toolDef of toolDefs) {
+    const def = toolDef;
+    aiTools[def.name] = tool({
+      description: def.description,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      inputSchema: def.parameters,
+      // Disable strict schema validation for OpenAI-compatible providers
+      // (e.g., Groq) that reject additionalProperties in tool schemas
+      strict: false,
+      execute: async (params) => {
+        const result2 = await executeTool(
+          def,
+          params,
+          executionContext
+        );
+        return result2.response;
+      }
+    });
+  }
+  const modelMessages = await convertToModelMessages(messages);
+  const maxHistory = config.maxHistoryMessages ?? 20;
+  const trimmedMessages = modelMessages.length > maxHistory ? modelMessages.slice(-maxHistory) : modelMessages;
+  const result = streamText({
+    model: config.model,
+    system: config.systemPrompt ?? `You are an AI assistant for this application. You can help users query data and perform actions. User: ${session.user.id}${session.user.role ? ` (role: ${session.user.role})` : ""}`,
+    messages: trimmedMessages,
+    tools: aiTools,
+    stopWhen: stepCountIs(5),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ...config.providerOptions ? { providerOptions: config.providerOptions } : {}
+  });
+  return result.toUIMessageStreamResponse();
+}
+export {
+  createAIMeHandler,
+  filterRoutes,
+  scanRoutes
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scanner.ts","../src/filter.ts","../src/handler.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { DiscoveredRoute } from \"@ai-me-chat/core\";\n\nconst HTTP_METHODS = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\"] as const;\n\nconst ROUTE_FILE_NAMES = [\"route.ts\", \"route.js\", \"route.tsx\", \"route.jsx\"];\n\n/**\n * Scan a Next.js App Router directory for API routes.\n * Finds all route.ts/route.js files under `appDir/api/` and extracts\n * HTTP methods and path parameters.\n */\nexport function scanRoutes(appDir: string): DiscoveredRoute[] {\n  const apiDir = path.join(appDir, \"api\");\n  if (!fs.existsSync(apiDir)) {\n    return [];\n  }\n  const routes: DiscoveredRoute[] = [];\n  walkDirectory(apiDir, appDir, routes);\n  return routes.sort((a, b) => a.path.localeCompare(b.path));\n}\n\nfunction walkDirectory(\n  dir: string,\n  appDir: string,\n  routes: DiscoveredRoute[],\n): void {\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      walkDirectory(fullPath, appDir, routes);\n    } else if (ROUTE_FILE_NAMES.includes(entry.name)) {\n      const route = parseRouteFile(fullPath, appDir);\n      if (route && route.methods.length > 0) {\n        routes.push(route);\n      }\n    }\n  }\n}\n\nfunction parseRouteFile(filePath: string, appDir: string): DiscoveredRoute | null {\n  const content = fs.readFileSync(filePath, \"utf-8\");\n  const methods = extractHttpMethods(content);\n\n  if (methods.length === 0) {\n    return null;\n  }\n\n  const relativePath = path.relative(appDir, path.dirname(filePath));\n  const apiPath = \"/\" + relativePath.split(path.sep).join(\"/\");\n  const pathParams = extractPathParams(apiPath);\n\n  return {\n    path: cleanPath(apiPath),\n    methods,\n    pathParams,\n    filePath: path.relative(path.resolve(appDir, \"..\"), filePath),\n  };\n}\n\n/**\n * Extract exported HTTP method handlers from route file content.\n * Matches patterns like:\n *   export async function GET(...)\n *   export function POST(...)\n *   export const PUT = ...\n *   export { handler as DELETE }\n */\nfunction extractHttpMethods(content: string): string[] {\n  const methods: string[] = [];\n\n  for (const method of HTTP_METHODS) {\n    const patterns = [\n      // export async function GET(\n      new RegExp(`export\\\\s+(async\\\\s+)?function\\\\s+${method}\\\\s*\\\\(`),\n      // export const GET =\n      new RegExp(`export\\\\s+const\\\\s+${method}\\\\s*=`),\n      // export { handler as GET }\n      new RegExp(`export\\\\s*\\\\{[^}]*\\\\bas\\\\s+${method}\\\\b[^}]*\\\\}`),\n    ];\n\n    if (patterns.some((p) => p.test(content))) {\n      methods.push(method);\n    }\n  }\n\n  return methods;\n}\n\n/**\n * Extract path parameters from a Next.js dynamic route path.\n * e.g., \"/api/projects/[id]/tasks/[taskId]\" → [\"id\", \"taskId\"]\n */\nfunction extractPathParams(routePath: string): string[] {\n  const params: string[] = [];\n  const matches = routePath.matchAll(/\\[([^\\]]+)\\]/g);\n  for (const match of matches) {\n    params.push(match[1]);\n  }\n  return params;\n}\n\n/**\n * Clean up path by removing route groups like (group) and catch-all segments.\n * Converts Next.js bracket params to colon params for readability.\n * e.g., \"/api/(admin)/users/[id]\" → \"/api/users/:id\"\n */\nfunction cleanPath(routePath: string): string {\n  return routePath\n    .replace(/\\/\\([^)]+\\)/g, \"\") // Remove route groups\n    .replace(/\\[\\.\\.\\.(\\w+)\\]/g, \":$1*\") // Catch-all [...slug] → :slug*\n    .replace(/\\[(\\w+)\\]/g, \":$1\"); // Dynamic [id] → :id\n}\n","import picomatch from \"picomatch\";\nimport type { DiscoveredRoute, DiscoveryConfig } from \"@ai-me-chat/core\";\n\n/**\n * Filter discovered routes based on include/exclude glob patterns.\n * - If include is specified, only routes matching at least one include pattern are kept.\n * - If exclude is specified, routes matching any exclude pattern are removed.\n * - Exclude takes precedence over include.\n */\nexport function filterRoutes(\n  routes: DiscoveredRoute[],\n  config: Pick<DiscoveryConfig, \"include\" | \"exclude\">,\n): DiscoveredRoute[] {\n  let filtered = routes;\n\n  if (config.include && config.include.length > 0) {\n    const isIncluded = picomatch(config.include);\n    filtered = filtered.filter((r) => isIncluded(r.path));\n  }\n\n  if (config.exclude && config.exclude.length > 0) {\n    const isExcluded = picomatch(config.exclude);\n    filtered = filtered.filter((r) => !isExcluded(r.path));\n  }\n\n  return filtered;\n}\n","import { streamText, convertToModelMessages, tool, stepCountIs } from \"ai\";\nimport type { UIMessage } from \"ai\";\nimport {\n  type AIMeConfig,\n  type AIMeToolDefinition,\n  generateToolDefinitions,\n  generateToolsFromOpenAPI,\n  fetchOpenAPISpec,\n  executeTool,\n} from \"@ai-me-chat/core\";\nimport type { OpenAPISpec, ExecutionContext } from \"@ai-me-chat/core\";\nimport { scanRoutes } from \"./scanner.js\";\nimport { filterRoutes } from \"./filter.js\";\n\n/**\n * Create an AI-Me API route handler for Next.js App Router.\n *\n * Usage:\n *   const handler = createAIMeHandler({ model, discovery, getSession });\n *   export { handler as GET, handler as POST };\n */\nexport function createAIMeHandler(config: AIMeConfig) {\n  // Discover tools at initialization time\n  let toolDefinitions: AIMeToolDefinition[] | null = null;\n  let toolsPromise: Promise<AIMeToolDefinition[]> | null = null;\n\n  async function getToolDefinitions(appDir: string): Promise<AIMeToolDefinition[]> {\n    if (toolDefinitions) return toolDefinitions;\n    if (toolsPromise) return toolsPromise;\n\n    toolsPromise = initTools(appDir);\n    toolDefinitions = await toolsPromise;\n    toolsPromise = null;\n    return toolDefinitions;\n  }\n\n  async function initTools(appDir: string): Promise<AIMeToolDefinition[]> {\n    if (config.discovery.mode === \"openapi\") {\n      let spec: OpenAPISpec;\n      if (config.discovery.spec) {\n        spec = config.discovery.spec as unknown as OpenAPISpec;\n      } else if (config.discovery.specUrl) {\n        spec = await fetchOpenAPISpec(config.discovery.specUrl);\n      } else {\n        throw new Error(\n          'OpenAPI discovery mode requires either \"spec\" (inline object) or \"specUrl\" (remote URL) in discovery config',\n        );\n      }\n      const tools = generateToolsFromOpenAPI(spec, config.confirmation);\n      if (config.discovery.include || config.discovery.exclude) {\n        const routes = tools.map((t) => ({\n          path: t.path ?? \"\",\n          methods: [t.httpMethod ?? \"GET\"],\n          pathParams: [],\n          filePath: \"\",\n        }));\n        const filtered = filterRoutes(routes, config.discovery);\n        const filteredPaths = new Set(\n          filtered.flatMap((r) => r.methods.map((m) => `${m}:${r.path}`)),\n        );\n        return tools.filter((t) => filteredPaths.has(`${t.httpMethod}:${t.path}`));\n      }\n      return tools;\n    }\n\n    let routes = scanRoutes(appDir);\n    routes = filterRoutes(routes, config.discovery);\n    return generateToolDefinitions(routes, config.confirmation);\n  }\n\n  async function handler(req: Request): Promise<Response> {\n    // Auth check\n    const session = await config.getSession(req);\n    if (!session) {\n      return new Response(\"Unauthorized\", { status: 401 });\n    }\n\n    const url = new URL(req.url);\n\n    // Route: GET /api/ai-me/tools — list available tools (debug)\n    if (req.method === \"GET\" && url.pathname.endsWith(\"/tools\")) {\n      const appDir = process.cwd() + \"/app\";\n      let tools: AIMeToolDefinition[];\n      try {\n        tools = await getToolDefinitions(appDir);\n      } catch (error) {\n        return new Response(\n          JSON.stringify({ error: error instanceof Error ? error.message : \"Tool discovery failed\" }),\n          { status: 500, headers: { \"Content-Type\": \"application/json\" } },\n        );\n      }\n      return Response.json(\n        tools.map((t) => ({\n          name: t.name,\n          description: t.description,\n          httpMethod: t.httpMethod,\n          path: t.path,\n          requiresConfirmation: t.requiresConfirmation,\n        })),\n      );\n    }\n\n    // Route: GET /api/ai-me/health\n    if (req.method === \"GET\" && url.pathname.endsWith(\"/health\")) {\n      return Response.json({ status: \"ok\", version: \"0.0.1\" });\n    }\n\n    // Route: POST /api/ai-me (chat)\n    if (req.method === \"POST\") {\n      return handleChat(req, config, session, getToolDefinitions);\n    }\n\n    return new Response(\"Not Found\", { status: 404 });\n  }\n\n  return handler;\n}\n\nasync function handleChat(\n  req: Request,\n  config: AIMeConfig,\n  session: NonNullable<Awaited<ReturnType<AIMeConfig[\"getSession\"]>>>,\n  getToolDefinitions: (appDir: string) => Promise<AIMeToolDefinition[]>,\n): Promise<Response> {\n  const { messages }: { messages: UIMessage[] } = await req.json();\n  const appDir = process.cwd() + \"/app\";\n  const toolDefs = await getToolDefinitions(appDir);\n\n  // Build execution context with forwarded auth headers\n  const baseUrl = new URL(req.url).origin;\n  const executionContext: ExecutionContext = {\n    baseUrl,\n    headers: {\n      cookie: req.headers.get(\"cookie\") ?? \"\",\n      authorization: req.headers.get(\"authorization\") ?? \"\",\n    },\n  };\n\n  // Convert tool definitions to AI SDK v6 tool() format\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const aiTools: Record<string, any> = {};\n  for (const toolDef of toolDefs) {\n    const def = toolDef; // capture for closure\n    aiTools[def.name] = tool({\n      description: def.description,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      inputSchema: def.parameters as any,\n      // Disable strict schema validation for OpenAI-compatible providers\n      // (e.g., Groq) that reject additionalProperties in tool schemas\n      strict: false,\n      execute: async (params: Record<string, unknown>) => {\n        const result = await executeTool(\n          def,\n          params,\n          executionContext,\n        );\n        return result.response;\n      },\n    });\n  }\n\n  const modelMessages = await convertToModelMessages(messages);\n\n  // Limit history if configured\n  const maxHistory = config.maxHistoryMessages ?? 20;\n  const trimmedMessages =\n    modelMessages.length > maxHistory\n      ? modelMessages.slice(-maxHistory)\n      : modelMessages;\n\n  const result = streamText({\n    model: config.model,\n    system:\n      config.systemPrompt ??\n      `You are an AI assistant for this application. You can help users query data and perform actions. User: ${session.user.id}${session.user.role ? ` (role: ${session.user.role})` : \"\"}`,\n    messages: trimmedMessages,\n    tools: aiTools,\n    stopWhen: stepCountIs(5),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    ...(config.providerOptions ? { providerOptions: config.providerOptions as any } : {}),\n  });\n\n  return result.toUIMessageStreamResponse();\n}\n"],"mappings":"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","names":["routes","result"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ai-me-chat/nextjs",
+  "version": "0.0.1",
+  "description": "AI-Me Next.js integration — handler, proxy, route scanner",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aselims/ai-me-chat",
+    "directory": "packages/nextjs"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "ai": "^6.0.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0"
+  },
+  "dependencies": {
+    "picomatch": "^4.0.3",
+    "@ai-me-chat/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/picomatch": "^4.0.2",
+    "@types/react": "^19.0.0",
+    "ai": "^6.0.116",
+    "next": "^16.1.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}