@mcpmesh/sdk 0.8.0-beta.1

package/dist/response-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parser.js","sourceRoot":"","sources":["../src/response-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,6DAA6D;IAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACrE,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,mEAAmE;IACnE,+CAA+C;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAClE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,kEAAkE;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACpE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,OAAe,EACf,KAAa,EACb,QAAgB,EAChB,SAAiB;IAEjB,gEAAgE;IAChE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAoB;IAElC;;;;OAIG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;IAC/B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAe;QACnB,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,OAAuB,CAAC;QACjC,CAAC;QAED,4BAA4B;QAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,kBAAkB,CAC1B,sEAAsE,EACtE,OAAO,CACR,CAAC;QACJ,CAAC;QAED,aAAa;QACb,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,kBAAkB,CAC1B,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACnE,OAAO,CACR,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,kBAAkB,CAC1B,6BAA6B,MAAM,EAAE,EACrC,OAAO,EACP,MAAM,CAAC,KAAK,CACb,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAe;QACtB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAmB;IAEnB,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAe;IAC1D,kEAAkE;IAClE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAA4B,CAAC;IAEhG,kCAAkC;IAClC,IAAI,UAAU,CAAC,WAAW,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACzE,OAAO,UAAU,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,8CAA8C;IAC9C,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,UAAU,CAAC,UAAqD,CAAC;QACpF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACjD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,SAAS,GAAI,IAAI,CAAC,IAAe,IAAI,SAAS,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,OAAO,GAAG,KAAK,SAAS,GAAG,SAAS,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,2BAA2B;IAC3B,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,MAAM;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/route.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Express route handler with mesh dependency injection.
+ *
+ * Provides `mesh.route()` for injecting mesh dependencies into Express routes.
+ * Similar to Python's `@mesh.route` decorator for FastAPI.
+ *
+ * When `mesh.route()` is first called, the API runtime automatically schedules
+ * itself to start via `process.nextTick()`. This allows all routes to be
+ * registered before connecting to the mesh.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { mesh } from "@mcpmesh/sdk";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * // mesh.route() triggers auto-init - no meshExpress() or start() needed!
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     const result = await calculator({ a: req.body.a, b: req.body.b });
+ *     res.json({ result });
+ *   }
+ * ));
+ *
+ * app.listen(3000);
+ * ```
+ */
+import type { Request, Response, NextFunction, RequestHandler } from "express";
+import type { DependencySpec, McpMeshAgent, DependencyKwargs } from "./types.js";
+/**
+ * Dependencies object passed to route handlers.
+ * Keys are capability names, values are proxy instances (or null if unavailable).
+ */
+export type RouteDependencies = Record<string, McpMeshAgent | null>;
+/**
+ * Route handler function with dependency injection.
+ *
+ * @param req - Express request object
+ * @param res - Express response object
+ * @param deps - Resolved dependencies as an object (keys are capability names)
+ */
+export type MeshRouteHandler = (req: Request, res: Response, deps: RouteDependencies) => void | Promise<void>;
+/**
+ * Extended route handler with next function for middleware chaining.
+ */
+export type MeshRouteHandlerWithNext = (req: Request, res: Response, deps: RouteDependencies, next: NextFunction) => void | Promise<void>;
+/**
+ * Configuration for a mesh route.
+ */
+export interface MeshRouteConfig {
+    /** Dependencies to inject */
+    dependencies: DependencySpec[];
+    /** Per-dependency configuration (indexed by position) */
+    dependencyKwargs?: DependencyKwargs[];
+}
+/**
+ * Internal route metadata stored in RouteRegistry.
+ */
+export interface RouteMetadata {
+    /** Route identifier (METHOD:path) */
+    routeId: string;
+    /** HTTP method */
+    method: string;
+    /** Route path pattern */
+    path: string;
+    /** Normalized dependencies */
+    dependencies: Array<{
+        capability: string;
+        tags: string[];
+        version?: string;
+    }>;
+    /** Per-dependency kwargs */
+    dependencyKwargs?: DependencyKwargs[];
+}
+/**
+ * Global registry for mesh routes.
+ * Tracks all routes created with mesh.route() for dependency resolution.
+ */
+export declare class RouteRegistry {
+    private static instance;
+    private routes;
+    private resolvedDeps;
+    private routeIdMapping;
+    private routeCounter;
+    private constructor();
+    static getInstance(): RouteRegistry;
+    /**
+     * Reset the registry (mainly for testing).
+     */
+    static reset(): void;
+    /**
+     * Register a route with its dependencies.
+     * Returns a unique route ID for dependency resolution.
+     */
+    registerRoute(method: string, path: string, dependencies: DependencySpec[], dependencyKwargs?: DependencyKwargs[]): string;
+    /**
+     * Get all registered routes.
+     */
+    getRoutes(): RouteMetadata[];
+    /**
+     * Get a route by ID.
+     * Handles lookup with old route IDs that have been remapped after introspection.
+     */
+    getRoute(routeId: string): RouteMetadata | undefined;
+    /**
+     * Resolve a route ID to its current ID (after any remapping).
+     */
+    resolveRouteId(routeId: string): string;
+    /**
+     * Update resolved dependency for a route.
+     * Handles old route IDs that have been remapped after introspection.
+     */
+    setDependency(routeId: string, depIndex: number, proxy: McpMeshAgent): void;
+    /**
+     * Remove resolved dependency for a route.
+     * Handles old route IDs that have been remapped after introspection.
+     */
+    removeDependency(routeId: string, depIndex: number): void;
+    /**
+     * Get resolved dependency for a route.
+     * Handles old route IDs that have been remapped after introspection.
+     */
+    getDependency(routeId: string, depIndex: number): McpMeshAgent | null;
+    /**
+     * Get all resolved dependencies for a route as an object.
+     * Keys are capability names for easy destructuring in handlers.
+     * Handles remapped route IDs (e.g., route_0_UNKNOWN:UNKNOWN -> GET:/time).
+     */
+    getDependenciesForRoute(routeId: string): RouteDependencies;
+    /**
+     * Clear all resolved dependencies (e.g., on registry disconnect).
+     */
+    clearAllDependencies(): void;
+    /**
+     * Update route metadata with proper method and path.
+     * Called after Express route introspection.
+     */
+    updateRouteInfo(routeId: string, method: string, path: string): void;
+}
+/**
+ * Reset auto-detection flag (for testing).
+ */
+export declare function resetAutoDetection(): void;
+/**
+ * Create an Express middleware that injects mesh dependencies.
+ *
+ * @param dependencies - Array of dependency specifications
+ * @param handler - Route handler receiving (req, res, deps)
+ * @returns Express middleware
+ *
+ * @example
+ * ```typescript
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     if (!calculator) {
+ *       return res.status(503).json({ error: "Calculator service unavailable" });
+ *     }
+ *     const result = await calculator({ a: req.body.a, b: req.body.b });
+ *     res.json({ result });
+ *   }
+ * ));
+ * ```
+ */
+export declare function route(dependencies: DependencySpec[], handler: MeshRouteHandler | MeshRouteHandlerWithNext, options?: {
+    dependencyKwargs?: DependencyKwargs[];
+}): RequestHandler;
+/**
+ * Alternative API: route with config object.
+ *
+ * @example
+ * ```typescript
+ * app.post("/compute", mesh.routeWithConfig({
+ *   dependencies: [{ capability: "calculator" }],
+ *   dependencyKwargs: [{ timeout: 60 }],
+ * }, async (req, res, { calculator }) => {
+ *   // ...
+ * }));
+ * ```
+ */
+export declare function routeWithConfig(config: MeshRouteConfig, handler: MeshRouteHandler | MeshRouteHandlerWithNext): RequestHandler;
+//# sourceMappingURL=route.d.ts.map

package/dist/route.d.ts.map

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

package/dist/route.js

@@ -0,0 +1,310 @@
+/**
+ * Express route handler with mesh dependency injection.
+ *
+ * Provides `mesh.route()` for injecting mesh dependencies into Express routes.
+ * Similar to Python's `@mesh.route` decorator for FastAPI.
+ *
+ * When `mesh.route()` is first called, the API runtime automatically schedules
+ * itself to start via `process.nextTick()`. This allows all routes to be
+ * registered before connecting to the mesh.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { mesh } from "@mcpmesh/sdk";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * // mesh.route() triggers auto-init - no meshExpress() or start() needed!
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     const result = await calculator({ a: req.body.a, b: req.body.b });
+ *     res.json({ result });
+ *   }
+ * ));
+ *
+ * app.listen(3000);
+ * ```
+ */
+import { normalizeDependency } from "./proxy.js";
+import { getApiRuntime, introspectExpressRoutes } from "./api-runtime.js";
+/**
+ * Global flag to track if Express auto-detection has been performed.
+ * We only need to do this once on first request.
+ */
+let expressAutoDetected = false;
+/**
+ * Global registry for mesh routes.
+ * Tracks all routes created with mesh.route() for dependency resolution.
+ */
+export class RouteRegistry {
+    static instance = null;
+    routes = new Map();
+    resolvedDeps = new Map();
+    routeIdMapping = new Map(); // old ID → new ID
+    routeCounter = 0;
+    constructor() { }
+    static getInstance() {
+        if (!RouteRegistry.instance) {
+            RouteRegistry.instance = new RouteRegistry();
+        }
+        return RouteRegistry.instance;
+    }
+    /**
+     * Reset the registry (mainly for testing).
+     */
+    static reset() {
+        RouteRegistry.instance = null;
+    }
+    /**
+     * Register a route with its dependencies.
+     * Returns a unique route ID for dependency resolution.
+     */
+    registerRoute(method, path, dependencies, dependencyKwargs) {
+        // Generate unique route ID
+        const routeId = `route_${this.routeCounter++}_${method}:${path}`;
+        const normalizedDeps = dependencies.map(normalizeDependency);
+        this.routes.set(routeId, {
+            routeId,
+            method,
+            path,
+            dependencies: normalizedDeps,
+            dependencyKwargs,
+        });
+        return routeId;
+    }
+    /**
+     * Get all registered routes.
+     */
+    getRoutes() {
+        return Array.from(this.routes.values());
+    }
+    /**
+     * Get a route by ID.
+     * Handles lookup with old route IDs that have been remapped after introspection.
+     */
+    getRoute(routeId) {
+        // Check if this is an old ID that's been remapped
+        const actualId = this.routeIdMapping.get(routeId) || routeId;
+        return this.routes.get(actualId);
+    }
+    /**
+     * Resolve a route ID to its current ID (after any remapping).
+     */
+    resolveRouteId(routeId) {
+        return this.routeIdMapping.get(routeId) || routeId;
+    }
+    /**
+     * Update resolved dependency for a route.
+     * Handles old route IDs that have been remapped after introspection.
+     */
+    setDependency(routeId, depIndex, proxy) {
+        // Resolve to current route ID in case this is an old ID from Rust core
+        const actualId = this.routeIdMapping.get(routeId) || routeId;
+        const depKey = `${actualId}:dep_${depIndex}`;
+        this.resolvedDeps.set(depKey, proxy);
+    }
+    /**
+     * Remove resolved dependency for a route.
+     * Handles old route IDs that have been remapped after introspection.
+     */
+    removeDependency(routeId, depIndex) {
+        // Resolve to current route ID in case this is an old ID from Rust core
+        const actualId = this.routeIdMapping.get(routeId) || routeId;
+        const depKey = `${actualId}:dep_${depIndex}`;
+        this.resolvedDeps.delete(depKey);
+    }
+    /**
+     * Get resolved dependency for a route.
+     * Handles old route IDs that have been remapped after introspection.
+     */
+    getDependency(routeId, depIndex) {
+        // Resolve to current route ID in case this is an old ID from Rust core
+        const actualId = this.routeIdMapping.get(routeId) || routeId;
+        const depKey = `${actualId}:dep_${depIndex}`;
+        return this.resolvedDeps.get(depKey) ?? null;
+    }
+    /**
+     * Get all resolved dependencies for a route as an object.
+     * Keys are capability names for easy destructuring in handlers.
+     * Handles remapped route IDs (e.g., route_0_UNKNOWN:UNKNOWN -> GET:/time).
+     */
+    getDependenciesForRoute(routeId) {
+        // Use getRoute to handle remapped IDs
+        const route = this.getRoute(routeId);
+        if (!route)
+            return {};
+        // Use the resolved route ID for dependency lookup
+        const resolvedId = route.routeId;
+        const deps = {};
+        route.dependencies.forEach((dep, idx) => {
+            deps[dep.capability] = this.getDependency(resolvedId, idx);
+        });
+        return deps;
+    }
+    /**
+     * Clear all resolved dependencies (e.g., on registry disconnect).
+     */
+    clearAllDependencies() {
+        this.resolvedDeps.clear();
+    }
+    /**
+     * Update route metadata with proper method and path.
+     * Called after Express route introspection.
+     */
+    updateRouteInfo(routeId, method, path) {
+        const route = this.routes.get(routeId);
+        if (route) {
+            // Create new route ID with proper method:path
+            const newRouteId = `${method}:${path}`;
+            // Store mapping for old→new ID (for dependency events from Rust core)
+            this.routeIdMapping.set(routeId, newRouteId);
+            // Update the route metadata
+            route.method = method;
+            route.path = path;
+            route.routeId = newRouteId;
+            // Re-register with new ID
+            this.routes.delete(routeId);
+            this.routes.set(newRouteId, route);
+            // Migrate any resolved dependencies to new key
+            for (let i = 0; i < route.dependencies.length; i++) {
+                const oldKey = `${routeId}:dep_${i}`;
+                const newKey = `${newRouteId}:dep_${i}`;
+                const dep = this.resolvedDeps.get(oldKey);
+                if (dep) {
+                    this.resolvedDeps.set(newKey, dep);
+                    this.resolvedDeps.delete(oldKey);
+                }
+            }
+        }
+    }
+}
+/**
+ * Perform auto-detection of Express app, port, and routes on first request.
+ * This eliminates the need for mesh.bind() - everything is detected automatically.
+ *
+ * @param req - Express request object (provides access to app and socket)
+ */
+function performExpressAutoDetection(req) {
+    try {
+        // Extract port from the socket
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const socket = req.socket || req.connection;
+        const port = socket?.localPort || 0;
+        // Get Express app from request
+        const app = req.app;
+        if (app) {
+            // Introspect routes to get proper METHOD:path names
+            const routeCount = introspectExpressRoutes(app);
+            // Update runtime with detected info
+            getApiRuntime().updateExpressInfo(port, routeCount);
+        }
+    }
+    catch (err) {
+        // Don't fail the request if auto-detection fails
+        console.warn("Express auto-detection failed:", err);
+    }
+}
+/**
+ * Reset auto-detection flag (for testing).
+ */
+export function resetAutoDetection() {
+    expressAutoDetected = false;
+}
+/**
+ * Create an Express middleware that injects mesh dependencies.
+ *
+ * @param dependencies - Array of dependency specifications
+ * @param handler - Route handler receiving (req, res, deps)
+ * @returns Express middleware
+ *
+ * @example
+ * ```typescript
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     if (!calculator) {
+ *       return res.status(503).json({ error: "Calculator service unavailable" });
+ *     }
+ *     const result = await calculator({ a: req.body.a, b: req.body.b });
+ *     res.json({ result });
+ *   }
+ * ));
+ * ```
+ */
+export function route(dependencies, handler, options) {
+    const registry = RouteRegistry.getInstance();
+    // We don't know the method/path yet since this is called before app.get/post/etc
+    // So we'll register with placeholder and update when the middleware is called
+    // Use a ref object so introspection can update it and the middleware sees the change
+    const routeRef = {
+        id: registry.registerRoute("UNKNOWN", // Will be determined at runtime from req.method
+        "UNKNOWN", // Will be determined at runtime from req.path
+        dependencies, options?.dependencyKwargs),
+    };
+    // Trigger auto-init of API runtime on first route() call
+    // Uses process.nextTick() to wait until all routes are registered
+    if (dependencies.length > 0) {
+        getApiRuntime().scheduleStart();
+    }
+    // Store normalized deps for the handler
+    const normalizedDeps = dependencies.map(normalizeDependency);
+    // Return Express middleware
+    const middleware = async (req, res, next) => {
+        try {
+            // Auto-detect Express app, port, and routes on first request
+            // This eliminates the need for mesh.bind()
+            if (!expressAutoDetected) {
+                expressAutoDetected = true;
+                performExpressAutoDetection(req);
+            }
+            // Get resolved dependencies as object (use ref to get current ID after introspection)
+            const deps = registry.getDependenciesForRoute(routeRef.id);
+            // Also try to resolve by capability name if route-specific resolution isn't available yet
+            // This handles the case where dependencies were resolved before the route was registered
+            for (const dep of normalizedDeps) {
+                if (deps[dep.capability] === undefined) {
+                    deps[dep.capability] = null;
+                }
+            }
+            // Call handler with dependencies
+            if (handler.length === 4) {
+                // Handler accepts next function
+                await handler(req, res, deps, next);
+            }
+            else {
+                await handler(req, res, deps);
+            }
+        }
+        catch (error) {
+            next(error);
+        }
+    };
+    // Attach metadata for introspection
+    // Use routeRef so introspection can update the ID and middleware sees the change
+    middleware._meshRouteId = routeRef.id;
+    middleware._meshRouteRef = routeRef;
+    middleware._meshDependencies = normalizedDeps;
+    return middleware;
+}
+/**
+ * Alternative API: route with config object.
+ *
+ * @example
+ * ```typescript
+ * app.post("/compute", mesh.routeWithConfig({
+ *   dependencies: [{ capability: "calculator" }],
+ *   dependencyKwargs: [{ timeout: 60 }],
+ * }, async (req, res, { calculator }) => {
+ *   // ...
+ * }));
+ * ```
+ */
+export function routeWithConfig(config, handler) {
+    return route(config.dependencies, handler, {
+        dependencyKwargs: config.dependencyKwargs,
+    });
+}
+//# sourceMappingURL=route.js.map

package/dist/route.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SSE (Server-Sent Events) parsing utilities for MCP responses.
+ *
+ * FastMCP stateless HTTP stream returns responses in SSE format:
+ * ```
+ * event: message
+ * data: {"jsonrpc":"2.0","id":123,"result":{...}}
+ * ```
+ *
+ * This module provides utilities to parse these responses.
+ */
+/**
+ * Parse a response that may be in SSE format or plain JSON.
+ *
+ * @param responseText - Raw response text from HTTP request
+ * @returns Parsed JSON object
+ * @throws Error if no data found in SSE response or JSON parse fails
+ *
+ * @example
+ * ```typescript
+ * // SSE format
+ * const sse = "event: message\ndata: {\"result\":42}\n";
+ * const result = parseSSEResponse(sse);
+ * // => { result: 42 }
+ *
+ * // Plain JSON (passed through)
+ * const json = '{"result":42}';
+ * const result = parseSSEResponse(json);
+ * // => { result: 42 }
+ * ```
+ */
+export declare function parseSSEResponse<T = unknown>(responseText: string): T;
+/**
+ * Check if a response text is in SSE format.
+ */
+export declare function isSSEResponse(responseText: string): boolean;
+/**
+ * Extract all data payloads from an SSE stream.
+ * Useful when multiple events are expected.
+ *
+ * @param responseText - Raw SSE response text
+ * @returns Array of parsed JSON objects from each data line
+ */
+export declare function parseSSEStream<T = unknown>(responseText: string): T[];
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,CAsBrE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,EAAE,CAcrE"}

package/dist/sse.js

@@ -0,0 +1,77 @@
+/**
+ * SSE (Server-Sent Events) parsing utilities for MCP responses.
+ *
+ * FastMCP stateless HTTP stream returns responses in SSE format:
+ * ```
+ * event: message
+ * data: {"jsonrpc":"2.0","id":123,"result":{...}}
+ * ```
+ *
+ * This module provides utilities to parse these responses.
+ */
+/**
+ * Parse a response that may be in SSE format or plain JSON.
+ *
+ * @param responseText - Raw response text from HTTP request
+ * @returns Parsed JSON object
+ * @throws Error if no data found in SSE response or JSON parse fails
+ *
+ * @example
+ * ```typescript
+ * // SSE format
+ * const sse = "event: message\ndata: {\"result\":42}\n";
+ * const result = parseSSEResponse(sse);
+ * // => { result: 42 }
+ *
+ * // Plain JSON (passed through)
+ * const json = '{"result":42}';
+ * const result = parseSSEResponse(json);
+ * // => { result: 42 }
+ * ```
+ */
+export function parseSSEResponse(responseText) {
+    // Check if it's SSE format (starts with "event:")
+    if (responseText.startsWith("event:")) {
+        const lines = responseText.split("\n");
+        let jsonData = "";
+        // Extract the last "data:" line (in case of multiple events)
+        for (const line of lines) {
+            if (line.startsWith("data: ")) {
+                jsonData = line.slice(6); // Remove "data: " prefix
+            }
+        }
+        if (!jsonData) {
+            throw new Error("No data found in SSE response");
+        }
+        return JSON.parse(jsonData);
+    }
+    // Plain JSON - parse directly
+    return JSON.parse(responseText);
+}
+/**
+ * Check if a response text is in SSE format.
+ */
+export function isSSEResponse(responseText) {
+    return responseText.startsWith("event:");
+}
+/**
+ * Extract all data payloads from an SSE stream.
+ * Useful when multiple events are expected.
+ *
+ * @param responseText - Raw SSE response text
+ * @returns Array of parsed JSON objects from each data line
+ */
+export function parseSSEStream(responseText) {
+    const results = [];
+    const lines = responseText.split("\n");
+    for (const line of lines) {
+        if (line.startsWith("data: ")) {
+            const jsonData = line.slice(6);
+            if (jsonData.trim()) {
+                results.push(JSON.parse(jsonData));
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAc,YAAoB;IAChE,kDAAkD;IAClD,IAAI,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,6DAA6D;QAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB;YACrD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;IACnC,CAAC;IAED,8BAA8B;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAM,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,OAAO,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAc,YAAoB;IAC9D,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}