@openserv-labs/sdk 2.1.0 → 2.2.0

package/README.md

@@ -320,6 +320,7 @@ agent.start()
 | `PORT`                | Server port                                | No       | 7378                               |
 | `OPENSERV_AUTH_TOKEN` | Token for authenticating incoming requests | No       | -                                  |
 | `OPENSERV_PROXY_URL`  | Custom proxy URL for tunnel connections    | No       | `https://agents-proxy.openserv.ai` |
+| `DISABLE_TUNNEL`      | Skip tunnel and run HTTP server only       | No       | -                                  |
 
 \*Required if using OpenAI integration features
 
@@ -794,12 +795,15 @@ The `run()` function automatically:
 
 #### Tunnel vs. Deployed Endpoint
 
-| Aspect            | Tunnel (Local Development) | Deployed Endpoint (Production) |
-| ----------------- | -------------------------- | ------------------------------ |
-| Setup             | Just run your code         | Deploy to cloud/server         |
-| URL Configuration | Not needed                 | Set Agent Endpoint in platform |
-| Connection        | WebSocket via proxy        | Direct HTTP                    |
-| Use case          | Development & testing      | Production                     |
+| Aspect            | Tunnel (Local Development) | Deployed Endpoint (Production)       |
+| ----------------- | -------------------------- | ------------------------------------ |
+| Setup             | Just run your code         | Deploy to cloud/server               |
+| URL Configuration | Not needed                 | Set Agent Endpoint in platform       |
+| Connection        | WebSocket via proxy        | Direct HTTP                          |
+| Tunnel            | Enabled (default)          | Disabled (`DISABLE_TUNNEL=true`)     |
+| Use case          | Development & testing      | Production                           |
+
+When deploying to a hosting provider like Cloud Run, set `DISABLE_TUNNEL=true` as an environment variable. This makes `run()` start only the HTTP server without opening a WebSocket tunnel to the proxy — the platform reaches your agent directly at its public URL.
 
 #### Configuration Options
 

package/dist/run.d.ts

@@ -15,8 +15,9 @@ export interface RunOptions {
 export interface RunResult {
     /**
      * The tunnel instance for advanced control.
+     * Null when the tunnel is disabled (DISABLE_TUNNEL=true).
      */
-    tunnel: OpenServTunnel;
+    tunnel: OpenServTunnel | null;
     /**
      * Stop the agent and tunnel.
      */

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAMrE,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CAAA;IAE7E;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAA;IAEtB;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA8EhF"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAMrE,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CAAA;IAE7E;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IAE7B;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAsFhF"}

package/dist/run.js

@@ -40,27 +40,34 @@ const tunnel_1 = require("./tunnel");
  */
 async function run(agent, options) {
     await agent.start();
-    const tunnel = new tunnel_1.OpenServTunnel({
-        ...options?.tunnel,
-        // Always use the agent's API key to ensure tunnel authenticates as the correct agent
-        // This prevents issues when running multiple agents with different API keys
-        apiKey: agent.apiKey,
-        onConnected: isReconnect => {
-            if (!isReconnect) {
-                logger_1.logger.info('Agent connected to OpenServ proxy');
+    const tunnelDisabled = process.env.DISABLE_TUNNEL === 'true';
+    let tunnel = null;
+    if (!tunnelDisabled) {
+        tunnel = new tunnel_1.OpenServTunnel({
+            ...options?.tunnel,
+            // Always use the agent's API key to ensure tunnel authenticates as the correct agent
+            // This prevents issues when running multiple agents with different API keys
+            apiKey: agent.apiKey,
+            onConnected: isReconnect => {
+                if (!isReconnect) {
+                    logger_1.logger.info('Agent connected to OpenServ proxy');
+                }
+            },
+            onError: error => {
+                logger_1.logger.error(`Tunnel error: ${error.message}`);
             }
-        },
-        onError: error => {
-            logger_1.logger.error(`Tunnel error: ${error.message}`);
+        });
+        try {
+            await tunnel.start(agent.port);
+        }
+        catch (error) {
+            // Clean up the agent if tunnel fails to connect
+            await agent.stop();
+            throw error;
         }
-    });
-    try {
-        await tunnel.start(agent.port);
     }
-    catch (error) {
-        // Clean up the agent if tunnel fails to connect
-        await agent.stop();
-        throw error;
+    else {
+        logger_1.logger.info(`Agent running on port ${agent.port} (tunnel disabled)`);
     }
     let shutdownPromise = null;
     let sigtermHandler = null;
@@ -80,7 +87,8 @@ async function run(agent, options) {
                 process.removeListener('SIGINT', sigintHandler);
                 sigintHandler = null;
             }
-            await tunnel.stop();
+            if (tunnel)
+                await tunnel.stop();
             await agent.stop();
         })();
         return shutdownPromise;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openserv-labs/sdk",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "OpenServ Agent SDK - Create AI agents easily",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",