@limrun/api 0.61.0 → 0.63.0

package/resources/android-instances.d.ts

@@ -55,9 +55,9 @@ export declare namespace AndroidInstance {
          */
         hardTimeout?: string;
         /**
-         * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-         * instance. Creation fails while that tunnel is offline, and the instance
-         * becomes ready only after the tunnel attaches.
+         * Names a private tunnel, created in the console (Network) or the API, that
+         * serves this instance. Creation fails while no connector (`lim tunnel run`)
+         * holds it, and the instance becomes ready only after the tunnel attaches.
          */
         tunnel?: string;
     }
@@ -188,9 +188,9 @@ export declare namespace AndroidInstanceCreateParams {
         region?: string;
         sandbox?: Spec.Sandbox;
         /**
-         * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-         * instance. Creation fails while that tunnel is offline, and the instance
-         * becomes ready only after the tunnel attaches.
+         * Names a private tunnel, created in the console (Network) or the API, that
+         * serves this instance. Creation fails while no connector (`lim tunnel run`)
+         * holds it, and the instance becomes ready only after the tunnel attaches.
          */
         tunnel?: string;
     }

package/resources/ios-instances.d.mts

@@ -55,9 +55,9 @@ export declare namespace IosInstance {
          */
         hardTimeout?: string;
         /**
-         * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-         * instance. Creation fails while that tunnel is offline, and the instance
-         * becomes ready only after the tunnel attaches.
+         * Names a private tunnel, created in the console (Network) or the API, that
+         * serves this instance. Creation fails while no connector (`lim tunnel run`)
+         * holds it, and the instance becomes ready only after the tunnel attaches.
          */
         tunnel?: string;
     }
@@ -157,7 +157,8 @@ export declare namespace IosInstanceCreateParams {
          */
         jurisdiction?: 'us' | 'eu' | 'as';
         /**
-         * The Apple Simulator model. iPhone Duo requires Xcode 27.1 and iOS 27.1 or newer. Default is iphone.
+         * The Apple Simulator model. iPhone Duo requires Xcode 27.1 and runs iOS 27, see
+         * the OSVersion clue. Default is iphone.
          */
         model?: 'iphone' | 'iphone-duo' | 'ipad' | 'watch';
         /**
@@ -181,21 +182,26 @@ export declare namespace IosInstanceCreateParams {
          */
         region?: string;
         /**
-         * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-         * instance. Creation fails while that tunnel is offline, and the instance
-         * becomes ready only after the tunnel attaches.
+         * Names a private tunnel, created in the console (Network) or the API, that
+         * serves this instance. Creation fails while no connector (`lim tunnel run`)
+         * holds it, and the instance becomes ready only after the tunnel attaches.
          */
         tunnel?: string;
     }
     namespace Spec {
         interface Clue {
-            kind: 'ClientIP' | 'ClientLocation';
+            kind: 'ClientIP' | 'ClientLocation' | 'OSVersion';
             clientIp?: string;
             /**
              * Required for ClientLocation. Both coordinates must be finite and within their
              * ranges. This location takes precedence over ClientIP.
              */
             clientLocation?: Clue.ClientLocation;
+            /**
+             * The major version of iOS, "26" or "27". iphone runs both, iphone-duo runs 27,
+             * ipad and watch run 26. Default is 26, or 27 on iphone-duo.
+             */
+            osVersion?: string;
         }
         namespace Clue {
             interface ClientLocation {

package/resources/ios-instances.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ios-instances.d.mts","sourceRoot":"","sources":["../src/resources/ios-instances.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,+BAA2B;AAE1E,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAK1F;;OAEG;IACH,IAAI,CACF,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,iBAAiB,EAAE,WAAW,CAAC;IAI9C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAO9D;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;CAGnE;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC;IAE/B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;IAEvB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B;AAED,yBAAiB,WAAW,CAAC;IAC3B,UAAiB,QAAQ;QACvB,EAAE,EAAE,MAAM,CAAC;QAEX,SAAS,EAAE,MAAM,CAAC;QAElB,cAAc,EAAE,MAAM,CAAC;QAEvB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAEnC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAED,UAAiB,IAAI;QACnB;;;;WAIG;QACH,iBAAiB,EAAE,MAAM,CAAC;QAE1B;;;WAGG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,MAAM;QACrB;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;QAEpE,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAE9B,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QAEjC;;;;;;;;;;;WAWG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC;IAE5C;;OAEG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC,IAAI,CAAC;CACrC;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,QAAQ;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACpC;IAED,UAAiB,IAAI;QACnB;;;WAGG;QACH,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzB;;;;WAIG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;;WAIG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEzC;;;;;;;WAOG;QACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QAElC;;WAEG;QACH,KAAK,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;QAEnD;;;;;;;;;;;;;;;;;;WAkBG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,IAAI;YACnB,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAAC;YAEpC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAElB;;;eAGG;YACH,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC;SACtC;QAED,UAAiB,IAAI,CAAC;YACpB,UAAiB,cAAc;gBAC7B;;mBAEG;gBACH,QAAQ,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,SAAS,EAAE,MAAM,CAAC;aACnB;SACF;QAED,UAAiB,YAAY;YAC3B,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;YAEzB,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;YAExC,OAAO,CAAC,EAAE,MAAM,CAAC;YAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;YAEnB;;;eAGG;YACH,aAAa,CAAC,EAAE,MAAM,CAAC;YAEvB;;eAEG;YACH,UAAU,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;YAEzD,GAAG,CAAC,EAAE,MAAM,CAAC;SACd;KACF;CACF;AAED,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}
+{"version":3,"file":"ios-instances.d.mts","sourceRoot":"","sources":["../src/resources/ios-instances.ts"],"names":[],"mappings":"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"}

package/resources/ios-instances.d.ts

@@ -55,9 +55,9 @@ export declare namespace IosInstance {
          */
         hardTimeout?: string;
         /**
-         * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-         * instance. Creation fails while that tunnel is offline, and the instance
-         * becomes ready only after the tunnel attaches.
+         * Names a private tunnel, created in the console (Network) or the API, that
+         * serves this instance. Creation fails while no connector (`lim tunnel run`)
+         * holds it, and the instance becomes ready only after the tunnel attaches.
          */
         tunnel?: string;
     }
@@ -157,7 +157,8 @@ export declare namespace IosInstanceCreateParams {
          */
         jurisdiction?: 'us' | 'eu' | 'as';
         /**
-         * The Apple Simulator model. iPhone Duo requires Xcode 27.1 and iOS 27.1 or newer. Default is iphone.
+         * The Apple Simulator model. iPhone Duo requires Xcode 27.1 and runs iOS 27, see
+         * the OSVersion clue. Default is iphone.
          */
         model?: 'iphone' | 'iphone-duo' | 'ipad' | 'watch';
         /**
@@ -181,21 +182,26 @@ export declare namespace IosInstanceCreateParams {
          */
         region?: string;
         /**
-         * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-         * instance. Creation fails while that tunnel is offline, and the instance
-         * becomes ready only after the tunnel attaches.
+         * Names a private tunnel, created in the console (Network) or the API, that
+         * serves this instance. Creation fails while no connector (`lim tunnel run`)
+         * holds it, and the instance becomes ready only after the tunnel attaches.
          */
         tunnel?: string;
     }
     namespace Spec {
         interface Clue {
-            kind: 'ClientIP' | 'ClientLocation';
+            kind: 'ClientIP' | 'ClientLocation' | 'OSVersion';
             clientIp?: string;
             /**
              * Required for ClientLocation. Both coordinates must be finite and within their
              * ranges. This location takes precedence over ClientIP.
              */
             clientLocation?: Clue.ClientLocation;
+            /**
+             * The major version of iOS, "26" or "27". iphone runs both, iphone-duo runs 27,
+             * ipad and watch run 26. Default is 26, or 27 on iphone-duo.
+             */
+            osVersion?: string;
         }
         namespace Clue {
             interface ClientLocation {

package/resources/ios-instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ios-instances.d.ts","sourceRoot":"","sources":["../src/resources/ios-instances.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ios-instances.d.ts","sourceRoot":"","sources":["../src/resources/ios-instances.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,8BAA2B;AAE1E,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAK1F;;OAEG;IACH,IAAI,CACF,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,iBAAiB,EAAE,WAAW,CAAC;IAI9C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAO9D;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;CAGnE;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC;IAE/B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;IAEvB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;CAC5B;AAED,yBAAiB,WAAW,CAAC;IAC3B,UAAiB,QAAQ;QACvB,EAAE,EAAE,MAAM,CAAC;QAEX,SAAS,EAAE,MAAM,CAAC;QAElB,cAAc,EAAE,MAAM,CAAC;QAEvB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAEnC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAED,UAAiB,IAAI;QACnB;;;;WAIG;QACH,iBAAiB,EAAE,MAAM,CAAC;QAE1B;;;WAGG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,MAAM;QACrB;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;QAEpE,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAE9B,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QAEjC;;;;;;;;;;;WAWG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC;IAE5C;;OAEG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC,IAAI,CAAC;CACrC;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,QAAQ;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACpC;IAED,UAAiB,IAAI;QACnB;;;WAGG;QACH,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzB;;;;WAIG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;;WAIG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEzC;;;;;;;WAOG;QACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QAElC;;;WAGG;QACH,KAAK,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;QAEnD;;;;;;;;;;;;;;;;;;WAkBG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,IAAI;YACnB,IAAI,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC;YAElD,QAAQ,CAAC,EAAE,MAAM,CAAC;YAElB;;;eAGG;YACH,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC;YAErC;;;eAGG;YACH,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB;QAED,UAAiB,IAAI,CAAC;YACpB,UAAiB,cAAc;gBAC7B;;mBAEG;gBACH,QAAQ,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,SAAS,EAAE,MAAM,CAAC;aACnB;SACF;QAED,UAAiB,YAAY;YAC3B,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;YAEzB,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;YAExC,OAAO,CAAC,EAAE,MAAM,CAAC;YAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;YAEnB;;;eAGG;YACH,aAAa,CAAC,EAAE,MAAM,CAAC;YAEvB;;eAEG;YACH,UAAU,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;YAEzD,GAAG,CAAC,EAAE,MAAM,CAAC;SACd;KACF;CACF;AAED,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/src/destination-tunnel-dialer.ts

@@ -70,7 +70,7 @@ export interface DestinationTcpTunnelOptions {
   onInspectionError?: DestinationTunnelInspectionErrorCallback;
   /** Per-flow receive window in bytes. Defaults to 1 MiB. */
   window?: number;
-  /** Persistent tunnel this session serves; the instance reports it in tunnel status. */
+  /** Private tunnel this session serves; the instance reports it in tunnel status. */
   name?: string;
   logLevel?: LogLevel;
   maxConnections?: number;

package/src/destination-tunnel.ts

@@ -136,7 +136,7 @@ export type DestinationTunnelClientMessage =
       inspection: DestinationTunnelInspectionConfig;
       /** Default per-flow receive window this client grants. */
       window: number;
-      /** Persistent tunnel this session serves. The instance only echoes it in status. */
+      /** Private tunnel this session serves. The instance only echoes it in status. */
       name?: string;
     }
   | {
@@ -162,7 +162,7 @@ export type DestinationTunnelServerMessage =
       tunnelId: string;
       selectors: DestinationTunnelSelectorReport[];
       configHash: string;
-      /** The persistent tunnel name the client sent in start, echoed back. */
+      /** The private tunnel name the client sent in start, echoed back. */
       name?: string;
     }
   | {

package/src/internal/destination-tunnel-management.ts

@@ -17,7 +17,7 @@ import {
 export interface DestinationTunnelStatus {
   active?: {
     tunnelId: string;
-    /** Persistent tunnel the session serves, absent for a one-instance tunnel. */
+    /** Private tunnel the session serves, absent for a one-instance tunnel. */
     name?: string;
     state: 'starting' | 'ready' | 'stopping';
     selectors: DestinationTunnelSelectorReport[];

package/src/internal/destination-tunnel-url.ts

@@ -29,7 +29,7 @@ export function deriveDestinationTunnelURL(apiUrl: string): string {
   return webSocketURL(deriveEndpointURL(apiUrl, 'tunnel'));
 }
 
-/** The control WebSocket of a persistent tunnel, under the Limrun API base URL. */
+/** The control WebSocket of a private tunnel, under the Limrun API base URL. */
 export function deriveTunnelConnectURL(baseURL: string, organizationId: string, name: string): string {
   return webSocketURL(
     deriveEndpointURL(

package/src/ios-client.ts

@@ -287,6 +287,8 @@ export type DeviceInfo = {
   screenHeight: number;
   /** Device model name */
   model: string;
+  /** Simulator OS version, e.g. "26.4" */
+  osVersion?: string;
 };
 
 export type AppInstallationResult = {
@@ -895,7 +897,8 @@ export type InstanceClient = {
    * On Duo, follows native display activity and fits each panel into the initial
    * canvas without stretching. Pass display to keep recording one panel.
    * When provided, `quality` must be one of `5`, `6`, `7`, `8`, `9`, or `10`.
-   * The server default is `5`.
+   * The server default is `5`. Touch ripples and drag trails are enabled while
+   * recording by default. Set `touchIndicators: false` to omit them.
    * With `persist`, the completed recording is uploaded to Limrun's bucket
    * when the recording stops or the instance terminates; list it with
    * `iosInstances.listRecordings`.
@@ -904,6 +907,7 @@ export type InstanceClient = {
     quality?: RecordingQuality;
     persist?: PersistOption;
     display?: DuoDisplay;
+    touchIndicators?: boolean;
   }) => Promise<void>;
 
   /**
@@ -1419,6 +1423,7 @@ type ServerResponse = {
   screenWidth?: number;
   screenHeight?: number;
   model?: string;
+  osVersion?: string;
   // Simctl streaming fields
   stdout?: string;
   stderr?: string;
@@ -1936,6 +1941,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
         screenWidth: msg.screenWidth!,
         screenHeight: msg.screenHeight!,
         model: msg.model!,
+        osVersion: msg.osVersion,
       }),
       openUrlResult: () => undefined,
       appInstallationResult: (msg) => ({
@@ -2559,27 +2565,18 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       );
     };
 
-    const startRecording = async (opts?: {
-      quality?: RecordingQuality;
-      persist?: PersistOption;
-      display?: DuoDisplay;
-    }): Promise<void> => {
-      const request: {
-        quality?: RecordingQuality;
-        persist?: boolean;
-        ttlSeconds?: number;
-        display?: DuoDisplay;
-      } = {
-        ...persistFields(opts?.persist),
-      };
+    const startRecording: InstanceClient['startRecording'] = async (opts) => {
       if (opts?.quality !== undefined) {
         if (!Number.isInteger(opts.quality) || opts.quality < 5 || opts.quality > 10) {
           throw new Error('quality must be one of: 5, 6, 7, 8, 9, 10');
         }
-        request.quality = opts.quality;
       }
-      if (opts?.display !== undefined) request.display = opts.display;
-      await sendRequest<void>('startVideoRecording', request);
+      await sendRequest<void>('startVideoRecording', {
+        ...persistFields(opts?.persist),
+        quality: opts?.quality,
+        display: opts?.display,
+        touchIndicators: opts?.touchIndicators,
+      });
     };
 
     const startAppLogCapture = async (opts: { bundleId: string; persist?: PersistOption }): Promise<void> => {

package/src/resources/android-instances.ts

@@ -90,9 +90,9 @@ export namespace AndroidInstance {
     hardTimeout?: string;
 
     /**
-     * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-     * instance. Creation fails while that tunnel is offline, and the instance
-     * becomes ready only after the tunnel attaches.
+     * Names a private tunnel, created in the console (Network) or the API, that
+     * serves this instance. Creation fails while no connector (`lim tunnel run`)
+     * holds it, and the instance becomes ready only after the tunnel attaches.
      */
     tunnel?: string;
   }
@@ -250,9 +250,9 @@ export namespace AndroidInstanceCreateParams {
     sandbox?: Spec.Sandbox;
 
     /**
-     * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-     * instance. Creation fails while that tunnel is offline, and the instance
-     * becomes ready only after the tunnel attaches.
+     * Names a private tunnel, created in the console (Network) or the API, that
+     * serves this instance. Creation fails while no connector (`lim tunnel run`)
+     * holds it, and the instance becomes ready only after the tunnel attaches.
      */
     tunnel?: string;
   }

package/src/resources/ios-instances.ts

@@ -90,9 +90,9 @@ export namespace IosInstance {
     hardTimeout?: string;
 
     /**
-     * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-     * instance. Creation fails while that tunnel is offline, and the instance
-     * becomes ready only after the tunnel attaches.
+     * Names a private tunnel, created in the console (Network) or the API, that
+     * serves this instance. Creation fails while no connector (`lim tunnel run`)
+     * holds it, and the instance becomes ready only after the tunnel attaches.
      */
     tunnel?: string;
   }
@@ -213,7 +213,8 @@ export namespace IosInstanceCreateParams {
     jurisdiction?: 'us' | 'eu' | 'as';
 
     /**
-     * The Apple Simulator model. iPhone Duo requires Xcode 27.1 and iOS 27.1 or newer. Default is iphone.
+     * The Apple Simulator model. iPhone Duo requires Xcode 27.1 and runs iOS 27, see
+     * the OSVersion clue. Default is iphone.
      */
     model?: 'iphone' | 'iphone-duo' | 'ipad' | 'watch';
 
@@ -239,16 +240,16 @@ export namespace IosInstanceCreateParams {
     region?: string;
 
     /**
-     * Names a persistent tunnel (`lim tunnel run --name`) that serves this
-     * instance. Creation fails while that tunnel is offline, and the instance
-     * becomes ready only after the tunnel attaches.
+     * Names a private tunnel, created in the console (Network) or the API, that
+     * serves this instance. Creation fails while no connector (`lim tunnel run`)
+     * holds it, and the instance becomes ready only after the tunnel attaches.
      */
     tunnel?: string;
   }
 
   export namespace Spec {
     export interface Clue {
-      kind: 'ClientIP' | 'ClientLocation';
+      kind: 'ClientIP' | 'ClientLocation' | 'OSVersion';
 
       clientIp?: string;
 
@@ -257,6 +258,12 @@ export namespace IosInstanceCreateParams {
        * ranges. This location takes precedence over ClientIP.
        */
       clientLocation?: Clue.ClientLocation;
+
+      /**
+       * The major version of iOS, "26" or "27". iphone runs both, iphone-duo runs 27,
+       * ipad and watch run 26. Default is 26, or 27 on iphone-duo.
+       */
+      osVersion?: string;
     }
 
     export namespace Clue {

package/src/tunnel-connector.ts

@@ -51,13 +51,13 @@ const ATTACH_GIVE_UP_MS = 5 * 60_000;
 const TAKEN_OVER_MESSAGE = 'another connector for this tunnel took the instance over';
 /** A token this close to its expiry is not dialed with; the hub refreshes it at half its life. */
 const TOKEN_EXPIRY_MARGIN_MS = 5_000;
-/** How long before its key expires the connector starts warning, and how often. */
-const KEY_WARNING_WINDOW_MS = 14 * 24 * 60 * 60_000;
-const KEY_WARNING_EVERY_MS = 24 * 60 * 60_000;
+/** How long before its token expires the connector starts warning, and how often. */
+const TOKEN_WARNING_WINDOW_MS = 14 * 24 * 60 * 60_000;
+const TOKEN_WARNING_EVERY_MS = 24 * 60 * 60_000;
 
 export interface TunnelConnectorOptions {
-  /** The tunnel's own key, or an admin's credential. */
-  apiKey: string;
+  /** The tunnel's token; no other credential connects. */
+  token: string;
   /** Limrun API base URL, such as https://api.limrun.com. */
   baseURL: string;
   organizationId: string;
@@ -82,8 +82,8 @@ export interface TunnelConnectorOptions {
 export type TunnelConnectorEvent =
   /** This connector holds the tunnel; emitted once per session and control connection. */
   | { type: 'active'; sessionId: string; name: string }
-  /** The connector's key expires within two weeks; emitted once a day until it does. */
-  | { type: 'keyExpiring'; expiresAt: string }
+  /** The connector's tunnel token expires within two weeks; emitted once a day until it does. */
+  | { type: 'tokenExpiring'; expiresAt: string }
   /** Another connector holds the name; emitted once per holder. */
   | { type: 'standby'; holder: { hostname: string; since?: string } }
   | { type: 'attached'; instanceId: string; tunnelId: string }
@@ -115,7 +115,7 @@ type ControlClientMessage =
   | { type: 'bye' };
 
 type ControlServerMessage =
-  | { type: 'active'; sessionId: string; leaseSeconds: number; name: string; keyExpiresAt?: string }
+  | { type: 'active'; sessionId: string; leaseSeconds: number; name: string; tokenExpiresAt?: string }
   | { type: 'standby'; holder: { hostname: string; since?: string } }
   | {
       type: 'attach';
@@ -152,7 +152,7 @@ interface InstanceAttachment {
 }
 
 /**
- * Serve a persistent tunnel: hold it through one control WebSocket to the
+ * Serve a private tunnel: hold it through one control WebSocket to the
  * Limrun API and open a destination tunnel to every instance created with
  * `spec.tunnel` set to its name, with a short-lived token the API hands out
  * for each. Instance tunnels stay up while the control channel reconnects,
@@ -181,7 +181,7 @@ export function runTunnel(options: TunnelConnectorOptions): TunnelConnector {
   let leaseExpiresAt = 0;
   // The tunnel's name, from the first active; instances set it in spec.tunnel.
   let tunnelName: string | undefined;
-  let lastKeyWarning = 0;
+  let lastTokenWarning = 0;
   let announcedSession: string | undefined;
   let announcedHolder: string | undefined;
 
@@ -362,7 +362,7 @@ export function runTunnel(options: TunnelConnectorOptions): TunnelConnector {
     // A token past its life is refused; the API sends a fresh one at half
     // life, so this only waits while the control channel is down.
     if (!tokenUsable(attachment)) {
-      retryAfterFailure(instanceId, attachment, 'token_expired', 'waiting for a fresh tunnel token');
+      retryAfterFailure(instanceId, attachment, 'token_expired', 'waiting for a fresh attach token');
       return;
     }
     let tunnel: DestinationTcpTunnel;
@@ -443,12 +443,12 @@ export function runTunnel(options: TunnelConnectorOptions): TunnelConnector {
         }
         const now = Date.now();
         if (
-          message.keyExpiresAt !== undefined &&
-          Date.parse(message.keyExpiresAt) - now < KEY_WARNING_WINDOW_MS &&
-          now - lastKeyWarning >= KEY_WARNING_EVERY_MS
+          message.tokenExpiresAt !== undefined &&
+          Date.parse(message.tokenExpiresAt) - now < TOKEN_WARNING_WINDOW_MS &&
+          now - lastTokenWarning >= TOKEN_WARNING_EVERY_MS
         ) {
-          lastKeyWarning = now;
-          emit({ type: 'keyExpiring', expiresAt: message.keyExpiresAt });
+          lastTokenWarning = now;
+          emit({ type: 'tokenExpiring', expiresAt: message.tokenExpiresAt });
         }
         return;
       }
@@ -565,7 +565,7 @@ export function runTunnel(options: TunnelConnectorOptions): TunnelConnector {
     if (stopped) return;
     const proxyAgent = nodeProxyTransport.getWebSocketAgent(controlURL);
     const socket = new WebSocket(controlURL, {
-      headers: { Authorization: `Bearer ${options.apiKey}` },
+      headers: { Authorization: `Bearer ${options.token}` },
       ...(proxyAgent ? { agent: proxyAgent } : {}),
       perMessageDeflate: false,
       // A stalled upgrade, such as after a laptop wakes, would otherwise
@@ -698,7 +698,7 @@ function decodeControlServerMessage(value: unknown): ControlServerMessage | unde
         sessionId: readNonEmptyString(message, 'sessionId'),
         leaseSeconds: readPositiveInteger(message, 'leaseSeconds'),
         name: readNonEmptyString(message, 'name'),
-        ...readOptionalString(message, 'keyExpiresAt'),
+        ...readOptionalString(message, 'tokenExpiresAt'),
       };
     }
     case 'standby': {
@@ -752,7 +752,7 @@ function revokedMessage(reason: string): string {
     case 'deleted':
       return 'the tunnel was deleted';
     case 'credential':
-      return 'the API key was revoked';
+      return 'its tunnel token was rotated, revoked or has expired';
     default:
       return `the tunnel was revoked (${reason})`;
   }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.61.0'; // x-release-please-version
+export const VERSION = '0.63.0'; // x-release-please-version

package/tunnel-connector.d.mts

@@ -1,8 +1,8 @@
 import { type DestinationTunnelInspectionConfig } from "./destination-tunnel.mjs";
 import { type LogLevel } from "./tunnel.mjs";
 export interface TunnelConnectorOptions {
-    /** The tunnel's own key, or an admin's credential. */
-    apiKey: string;
+    /** The tunnel's token; no other credential connects. */
+    token: string;
     /** Limrun API base URL, such as https://api.limrun.com. */
     baseURL: string;
     organizationId: string;
@@ -30,9 +30,9 @@ export type TunnelConnectorEvent =
     sessionId: string;
     name: string;
 }
-/** The connector's key expires within two weeks; emitted once a day until it does. */
+/** The connector's tunnel token expires within two weeks; emitted once a day until it does. */
  | {
-    type: 'keyExpiring';
+    type: 'tokenExpiring';
     expiresAt: string;
 }
 /** Another connector holds the name; emitted once per holder. */
@@ -77,7 +77,7 @@ export interface TunnelConnector {
     close: () => Promise<void>;
 }
 /**
- * Serve a persistent tunnel: hold it through one control WebSocket to the
+ * Serve a private tunnel: hold it through one control WebSocket to the
  * Limrun API and open a destination tunnel to every instance created with
  * `spec.tunnel` set to its name, with a short-lived token the API hands out
  * for each. Instance tunnels stay up while the control channel reconnects,

package/tunnel-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tunnel-connector.d.mts","sourceRoot":"","sources":["src/tunnel-connector.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,iCAAiC,EAEvC,iCAA6B;AAC9B,OAAO,EAAiB,KAAK,QAAQ,EAAE,qBAAiB;AAyBxD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACxD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,oBAAoB;AAC9B,wFAAwF;AACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrD,sFAAsF;GACpF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC5C,iEAAiE;GAC/D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC5D,6CAA6C;GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACxE,mFAAmF;GACjF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uFAAuF;IACvF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAoDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA+gB1E"}
+{"version":3,"file":"tunnel-connector.d.mts","sourceRoot":"","sources":["src/tunnel-connector.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,iCAAiC,EAEvC,iCAA6B;AAC9B,OAAO,EAAiB,KAAK,QAAQ,EAAE,qBAAiB;AAyBxD,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACxD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,oBAAoB;AAC9B,wFAAwF;AACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrD,+FAA+F;GAC7F;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC9C,iEAAiE;GAC/D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC5D,6CAA6C;GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACxE,mFAAmF;GACjF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uFAAuF;IACvF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAoDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA+gB1E"}

package/tunnel-connector.d.ts

@@ -1,8 +1,8 @@
 import { type DestinationTunnelInspectionConfig } from "./destination-tunnel.js";
 import { type LogLevel } from "./tunnel.js";
 export interface TunnelConnectorOptions {
-    /** The tunnel's own key, or an admin's credential. */
-    apiKey: string;
+    /** The tunnel's token; no other credential connects. */
+    token: string;
     /** Limrun API base URL, such as https://api.limrun.com. */
     baseURL: string;
     organizationId: string;
@@ -30,9 +30,9 @@ export type TunnelConnectorEvent =
     sessionId: string;
     name: string;
 }
-/** The connector's key expires within two weeks; emitted once a day until it does. */
+/** The connector's tunnel token expires within two weeks; emitted once a day until it does. */
  | {
-    type: 'keyExpiring';
+    type: 'tokenExpiring';
     expiresAt: string;
 }
 /** Another connector holds the name; emitted once per holder. */
@@ -77,7 +77,7 @@ export interface TunnelConnector {
     close: () => Promise<void>;
 }
 /**
- * Serve a persistent tunnel: hold it through one control WebSocket to the
+ * Serve a private tunnel: hold it through one control WebSocket to the
  * Limrun API and open a destination tunnel to every instance created with
  * `spec.tunnel` set to its name, with a short-lived token the API hands out
  * for each. Instance tunnels stay up while the control channel reconnects,

package/tunnel-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tunnel-connector.d.ts","sourceRoot":"","sources":["src/tunnel-connector.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,iCAAiC,EAEvC,gCAA6B;AAC9B,OAAO,EAAiB,KAAK,QAAQ,EAAE,oBAAiB;AAyBxD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACxD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,oBAAoB;AAC9B,wFAAwF;AACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrD,sFAAsF;GACpF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC5C,iEAAiE;GAC/D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC5D,6CAA6C;GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACxE,mFAAmF;GACjF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uFAAuF;IACvF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAoDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA+gB1E"}
+{"version":3,"file":"tunnel-connector.d.ts","sourceRoot":"","sources":["src/tunnel-connector.ts"],"names":[],"mappings":"AA0BA,OAAO,EAGL,KAAK,iCAAiC,EAEvC,gCAA6B;AAC9B,OAAO,EAAiB,KAAK,QAAQ,EAAE,oBAAiB;AAyBxD,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACxD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,oBAAoB;AAC9B,wFAAwF;AACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrD,+FAA+F;GAC7F;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC9C,iEAAiE;GAC/D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC5D,6CAA6C;GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACxE,mFAAmF;GACjF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uFAAuF;IACvF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAoDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA+gB1E"}