@zauso-ai/capstan-router 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { scanRoutes } from "./scanner.js";
+export { matchRoute } from "./matcher.js";
+export { generateRouteManifest } from "./manifest.js";
+export type { RouteEntry, RouteManifest, MatchedRoute, RouteType } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { scanRoutes } from "./scanner.js";
+export { matchRoute } from "./matcher.js";
+export { generateRouteManifest } from "./manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,14 @@
+import type { RouteManifest } from "./types.js";
+export interface AgentApiRoute {
+    method: string;
+    path: string;
+    filePath: string;
+}
+/**
+ * Extract API route information from a full RouteManifest for use by the
+ * agent surface layer. Each API route is expanded into one entry per HTTP method.
+ */
+export declare function generateRouteManifest(manifest: RouteManifest): {
+    apiRoutes: AgentApiRoute[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,GACtB;IAAE,SAAS,EAAE,aAAa,EAAE,CAAA;CAAE,CA0BhC"}

package/dist/manifest.js

@@ -0,0 +1,29 @@
+/**
+ * Extract API route information from a full RouteManifest for use by the
+ * agent surface layer. Each API route is expanded into one entry per HTTP method.
+ */
+export function generateRouteManifest(manifest) {
+    const apiRoutes = [];
+    for (const route of manifest.routes) {
+        if (route.type !== "api") {
+            continue;
+        }
+        const methods = route.methods ?? ["GET"];
+        for (const method of methods) {
+            apiRoutes.push({
+                method,
+                path: route.urlPattern,
+                filePath: route.filePath,
+            });
+        }
+    }
+    // Sort for deterministic output
+    apiRoutes.sort((a, b) => {
+        const pathCmp = a.path.localeCompare(b.path);
+        if (pathCmp !== 0)
+            return pathCmp;
+        return a.method.localeCompare(b.method);
+    });
+    return { apiRoutes };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAuB;IAEvB,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC;gBACb,MAAM;gBACN,IAAI,EAAE,KAAK,CAAC,UAAU;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAClC,OAAO,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,15 @@
+import type { MatchedRoute, RouteManifest } from "./types.js";
+/**
+ * Match a URL path and HTTP method against the route manifest.
+ *
+ * Returns the best matching route (most specific) along with extracted parameters,
+ * or null if no route matches.
+ *
+ * Matching priority:
+ * 1. Static segments are preferred over dynamic segments
+ * 2. Dynamic segments are preferred over catch-all
+ * 3. Page routes match any method (they serve GET by convention)
+ * 4. API routes must match the given HTTP method
+ */
+export declare function matchRoute(manifest: RouteManifest, method: string, urlPath: string): MatchedRoute | null;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA+E9D;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,IAAI,CA0ErB"}

package/dist/matcher.js

@@ -0,0 +1,141 @@
+/**
+ * Normalize a URL path by removing trailing slashes (except for root "/")
+ * and collapsing repeated slashes.
+ */
+function normalizePath(urlPath) {
+    // Collapse repeated slashes
+    let normalized = urlPath.replace(/\/+/g, "/");
+    // Remove trailing slash (unless it IS the root)
+    if (normalized.length > 1 && normalized.endsWith("/")) {
+        normalized = normalized.slice(0, -1);
+    }
+    // Ensure leading slash
+    if (!normalized.startsWith("/")) {
+        normalized = "/" + normalized;
+    }
+    return normalized;
+}
+/**
+ * Attempt to match a URL path against a single route pattern.
+ * Returns extracted params and a specificity score, or null if no match.
+ *
+ * Specificity is measured as the number of static segments — more static segments
+ * means a more specific match. Catch-all routes get the lowest specificity.
+ */
+function tryMatch(pattern, urlPath) {
+    const patternParts = pattern === "/" ? [""] : pattern.split("/");
+    const urlParts = urlPath === "/" ? [""] : urlPath.split("/");
+    const params = {};
+    let staticSegments = 0;
+    for (let i = 0; i < patternParts.length; i++) {
+        const patternPart = patternParts[i];
+        // Catch-all: matches the rest of the URL
+        if (patternPart === "*") {
+            // Collect remaining URL segments (everything from this position onward)
+            const rest = urlParts.slice(i).join("/");
+            // For catch-all stored in params, we need the param name from the route.
+            // We store under a generic key here; the caller maps it to the real name.
+            params["*"] = rest;
+            // Catch-all gets lowest specificity bonus
+            return { params, specificity: staticSegments };
+        }
+        // If we've run out of URL segments but still have pattern segments, no match
+        if (i >= urlParts.length) {
+            return null;
+        }
+        const urlPart = urlParts[i];
+        if (patternPart.startsWith(":")) {
+            // Dynamic segment
+            const paramName = patternPart.slice(1);
+            params[paramName] = decodeURIComponent(urlPart);
+        }
+        else {
+            // Static segment — must match exactly
+            if (patternPart !== urlPart) {
+                return null;
+            }
+            staticSegments++;
+        }
+    }
+    // If there are remaining URL segments that weren't consumed, no match
+    if (urlParts.length > patternParts.length) {
+        return null;
+    }
+    return { params, specificity: staticSegments };
+}
+/**
+ * Match a URL path and HTTP method against the route manifest.
+ *
+ * Returns the best matching route (most specific) along with extracted parameters,
+ * or null if no route matches.
+ *
+ * Matching priority:
+ * 1. Static segments are preferred over dynamic segments
+ * 2. Dynamic segments are preferred over catch-all
+ * 3. Page routes match any method (they serve GET by convention)
+ * 4. API routes must match the given HTTP method
+ */
+export function matchRoute(manifest, method, urlPath) {
+    const normalizedPath = normalizePath(urlPath);
+    const upperMethod = method.toUpperCase();
+    let best = null;
+    for (const route of manifest.routes) {
+        // Skip layout and middleware entries — they are not directly routable
+        if (route.type === "layout" || route.type === "middleware") {
+            continue;
+        }
+        // For API routes, check that the method is supported
+        if (route.type === "api" && route.methods && !route.methods.includes(upperMethod)) {
+            continue;
+        }
+        const result = tryMatch(route.urlPattern, normalizedPath);
+        if (result === null) {
+            continue;
+        }
+        // Resolve catch-all param name: replace the generic "*" key with the actual param name
+        if ("*" in result.params && route.params.length > 0) {
+            const catchAllParamName = route.params[route.params.length - 1];
+            result.params[catchAllParamName] = result.params["*"];
+            delete result.params["*"];
+        }
+        const candidate = {
+            match: { route, params: result.params },
+            specificity: result.specificity,
+            isCatchAll: route.isCatchAll,
+        };
+        if (best === null) {
+            best = candidate;
+            continue;
+        }
+        // Determine if this candidate is better than the current best.
+        //
+        // Priority order:
+        // 1. Non-catch-all beats catch-all
+        // 2. Higher specificity (more static segments) beats lower
+        // 3. At equal specificity and catch-all status, prefer the route type
+        //    that best matches the HTTP method:
+        //    - For GET requests, prefer page routes over api routes
+        //    - For non-GET requests, prefer api routes over page routes
+        if (!candidate.isCatchAll && best.isCatchAll) {
+            best = candidate;
+        }
+        else if (candidate.isCatchAll === best.isCatchAll) {
+            if (candidate.specificity > best.specificity) {
+                best = candidate;
+            }
+            else if (candidate.specificity === best.specificity) {
+                const preferApi = upperMethod !== "GET";
+                const candidateIsApi = candidate.match.route.type === "api";
+                const bestIsApi = best.match.route.type === "api";
+                if (preferApi && candidateIsApi && !bestIsApi) {
+                    best = candidate;
+                }
+                else if (!preferApi && !candidateIsApi && bestIsApi) {
+                    best = candidate;
+                }
+            }
+        }
+    }
+    return best?.match ?? null;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"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"}

package/dist/scanner.d.ts

@@ -0,0 +1,6 @@
+import type { RouteManifest } from "./types.js";
+/**
+ * Scan a routes directory and produce a RouteManifest describing every route file found.
+ */
+export declare function scanRoutes(routesDir: string): Promise<RouteManifest>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,aAAa,EAAa,MAAM,YAAY,CAAC;AAoKvE;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2H1E"}

package/dist/scanner.js

@@ -0,0 +1,257 @@
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Determine the route type from a filename.
+ * Returns null if the file is not a recognized route file.
+ */
+function classifyFile(filename) {
+    if (filename === "_layout.tsx")
+        return "layout";
+    if (filename === "_middleware.ts")
+        return "middleware";
+    if (filename.endsWith(".page.tsx"))
+        return "page";
+    if (filename.endsWith(".api.ts"))
+        return "api";
+    return null;
+}
+/**
+ * Convert a filename to its URL segment contribution.
+ *
+ *   index.page.tsx   -> "" (index routes map to the directory itself)
+ *   about.page.tsx   -> "about"
+ *   [id].page.tsx    -> ":id"
+ *   [...rest].page.tsx -> "*"
+ *   index.api.ts     -> ""
+ *   [id].api.ts      -> ":id"
+ */
+function fileToSegment(filename) {
+    // Strip the suffix to get the base name
+    let base;
+    if (filename.endsWith(".page.tsx")) {
+        base = filename.slice(0, -".page.tsx".length);
+    }
+    else if (filename.endsWith(".api.ts")) {
+        base = filename.slice(0, -".api.ts".length);
+    }
+    else {
+        return { segment: "", params: [], isCatchAll: false };
+    }
+    if (base === "index") {
+        return { segment: "", params: [], isCatchAll: false };
+    }
+    // Catch-all: [...rest]
+    const catchAllMatch = base.match(/^\[\.\.\.(\w+)\]$/);
+    if (catchAllMatch) {
+        return { segment: "*", params: [catchAllMatch[1]], isCatchAll: true };
+    }
+    // Dynamic segment: [param]
+    const dynamicMatch = base.match(/^\[(\w+)\]$/);
+    if (dynamicMatch) {
+        return { segment: `:${dynamicMatch[1]}`, params: [dynamicMatch[1]], isCatchAll: false };
+    }
+    // Static segment
+    return { segment: base, params: [], isCatchAll: false };
+}
+/**
+ * Convert a directory path relative to the routes root into URL segments.
+ * Each directory named as a dynamic segment (e.g. `[orgId]`) is converted.
+ */
+function dirToSegments(relativeDir) {
+    if (relativeDir === "" || relativeDir === ".") {
+        return { segments: [], params: [] };
+    }
+    const parts = relativeDir.split(path.sep);
+    const segments = [];
+    const params = [];
+    for (const part of parts) {
+        const catchAllMatch = part.match(/^\[\.\.\.(\w+)\]$/);
+        if (catchAllMatch) {
+            segments.push("*");
+            params.push(catchAllMatch[1]);
+            continue;
+        }
+        const dynamicMatch = part.match(/^\[(\w+)\]$/);
+        if (dynamicMatch) {
+            segments.push(`:${dynamicMatch[1]}`);
+            params.push(dynamicMatch[1]);
+            continue;
+        }
+        segments.push(part);
+    }
+    return { segments, params };
+}
+/**
+ * Collect all _layout.tsx files from the routes root down to the given directory,
+ * ordered from outermost to innermost.
+ */
+function collectLayouts(routesDir, relativeDir) {
+    const layouts = [];
+    const parts = relativeDir === "" || relativeDir === "." ? [] : relativeDir.split(path.sep);
+    // Check the root directory first
+    layouts.push(path.join(routesDir, "_layout.tsx"));
+    // Then each nested directory
+    let current = routesDir;
+    for (const part of parts) {
+        current = path.join(current, part);
+        layouts.push(path.join(current, "_layout.tsx"));
+    }
+    return layouts;
+}
+/**
+ * Collect all _middleware.ts files from the routes root down to the given directory,
+ * ordered from outermost to innermost.
+ */
+function collectMiddlewares(routesDir, relativeDir) {
+    const middlewares = [];
+    const parts = relativeDir === "" || relativeDir === "." ? [] : relativeDir.split(path.sep);
+    middlewares.push(path.join(routesDir, "_middleware.ts"));
+    let current = routesDir;
+    for (const part of parts) {
+        current = path.join(current, part);
+        middlewares.push(path.join(current, "_middleware.ts"));
+    }
+    return middlewares;
+}
+/**
+ * Recursively walk a directory, returning all files as paths relative to the root.
+ */
+async function walkDir(dir, root) {
+    const files = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+        return files;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            const nested = await walkDir(fullPath, root);
+            files.push(...nested);
+        }
+        else if (entry.isFile()) {
+            files.push(path.relative(root, fullPath));
+        }
+    }
+    return files;
+}
+/**
+ * Filter layout/middleware candidate paths to only those that actually exist as
+ * files discovered during the scan.
+ */
+function filterExisting(candidates, existingAbsolute) {
+    return candidates.filter((p) => existingAbsolute.has(p));
+}
+/**
+ * Scan a routes directory and produce a RouteManifest describing every route file found.
+ */
+export async function scanRoutes(routesDir) {
+    const resolvedRoot = path.resolve(routesDir);
+    // Verify the directory exists
+    try {
+        const s = await stat(resolvedRoot);
+        if (!s.isDirectory()) {
+            return {
+                routes: [],
+                scannedAt: new Date().toISOString(),
+                rootDir: resolvedRoot,
+            };
+        }
+    }
+    catch {
+        return {
+            routes: [],
+            scannedAt: new Date().toISOString(),
+            rootDir: resolvedRoot,
+        };
+    }
+    const relativePaths = await walkDir(resolvedRoot, resolvedRoot);
+    // Build a set of all absolute paths for existence checks
+    const absolutePathSet = new Set(relativePaths.map((rp) => path.join(resolvedRoot, rp)));
+    const routes = [];
+    for (const relPath of relativePaths) {
+        const filename = path.basename(relPath);
+        const routeType = classifyFile(filename);
+        if (routeType === null) {
+            // Not a recognized route file — skip
+            continue;
+        }
+        const relativeDir = path.dirname(relPath);
+        const absoluteFilePath = path.join(resolvedRoot, relPath);
+        // Build URL pattern
+        const dirInfo = dirToSegments(relativeDir);
+        if (routeType === "layout" || routeType === "middleware") {
+            // Layouts and middlewares don't get their own URL pattern —
+            // they are referenced by other routes. But we still include them
+            // in the manifest so they can be discovered.
+            const urlParts = dirInfo.segments;
+            const urlPattern = "/" + urlParts.join("/");
+            routes.push({
+                filePath: absoluteFilePath,
+                type: routeType,
+                urlPattern: urlPattern === "/" ? "/" : urlPattern.replace(/\/$/, ""),
+                layouts: [],
+                middlewares: [],
+                params: dirInfo.params,
+                isCatchAll: false,
+            });
+            continue;
+        }
+        // Page or API route
+        const fileInfo = fileToSegment(filename);
+        const allParams = [...dirInfo.params, ...fileInfo.params];
+        const urlParts = [...dirInfo.segments];
+        if (fileInfo.segment !== "") {
+            urlParts.push(fileInfo.segment);
+        }
+        const urlPattern = "/" + urlParts.join("/");
+        // Collect parent layouts and middlewares (only those that actually exist on disk)
+        const layoutCandidates = collectLayouts(resolvedRoot, relativeDir);
+        const middlewareCandidates = collectMiddlewares(resolvedRoot, relativeDir);
+        const layouts = filterExisting(layoutCandidates, absolutePathSet);
+        const middlewares = filterExisting(middlewareCandidates, absolutePathSet);
+        const entry = {
+            filePath: absoluteFilePath,
+            type: routeType,
+            urlPattern: urlPattern === "/" ? "/" : urlPattern.replace(/\/$/, ""),
+            layouts,
+            middlewares,
+            params: allParams,
+            isCatchAll: fileInfo.isCatchAll,
+        };
+        if (routeType === "api") {
+            // API routes support all standard HTTP methods by default.
+            // The actual exported methods are determined at runtime.
+            entry.methods = ["GET", "POST", "PUT", "DELETE", "PATCH"];
+        }
+        routes.push(entry);
+    }
+    // Sort for deterministic output:
+    // 1. By URL pattern alphabetically
+    // 2. By type (layout < middleware < page < api)
+    // 3. By file path as tiebreaker
+    const typeOrder = {
+        layout: 0,
+        middleware: 1,
+        page: 2,
+        api: 3,
+    };
+    routes.sort((a, b) => {
+        const patternCmp = a.urlPattern.localeCompare(b.urlPattern);
+        if (patternCmp !== 0)
+            return patternCmp;
+        const typeCmp = typeOrder[a.type] - typeOrder[b.type];
+        if (typeCmp !== 0)
+            return typeCmp;
+        return a.filePath.localeCompare(b.filePath);
+    });
+    return {
+        routes,
+        scannedAt: new Date().toISOString(),
+        rootDir: resolvedRoot,
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+export type RouteType = "page" | "api" | "layout" | "middleware";
+export interface RouteEntry {
+    /** Absolute file path */
+    filePath: string;
+    /** Route type determined by file suffix */
+    type: RouteType;
+    /** URL path pattern, e.g. "/tickets/:id" */
+    urlPattern: string;
+    /** HTTP methods this route handles (for api routes) */
+    methods?: string[];
+    /** Parent layout file paths (from outermost to innermost) */
+    layouts: string[];
+    /** Middleware file paths (from outermost to innermost) */
+    middlewares: string[];
+    /** Dynamic parameter names */
+    params: string[];
+    /** Whether this is a catch-all route */
+    isCatchAll: boolean;
+}
+export interface RouteManifest {
+    routes: RouteEntry[];
+    /** Timestamp of last scan */
+    scannedAt: string;
+    /** Root directory that was scanned */
+    rootDir: string;
+}
+export interface MatchedRoute {
+    route: RouteEntry;
+    params: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@zauso-ai/capstan-router",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "description": "File-based routing for Capstan — .page.tsx, .api.ts, _layout.tsx, _middleware.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/barry3406/capstan.git",
+    "directory": "packages/router"
+  },
+  "license": "MIT",
+  "author": "barry3406",
+  "homepage": "https://github.com/barry3406/capstan",
+  "keywords": [
+    "capstan",
+    "ai-agent",
+    "full-stack",
+    "framework",
+    "mcp",
+    "a2a",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}