Update to v0.2.4

Author: github-actions[bot]

imports.md

@@ -2,24 +2,60 @@
 <ul>
 <li>Imports:
 <ul>
-<li>interface <a href="#wasi_sockets_network_0_2_3"><code>wasi:sockets/network@0.2.3</code></a></li>
-<li>interface <a href="#wasi_sockets_instance_network_0_2_3"><code>wasi:sockets/instance-[email protected].3</code></a></li>
-<li>interface <a href="#wasi_io_poll_0_2_3"><code>wasi:io/poll@0.2.3</code></a></li>
-<li>interface <a href="#wasi_sockets_udp_0_2_3"><code>wasi:sockets/udp@0.2.3</code></a></li>
-<li>interface <a href="#wasi_sockets_udp_create_socket_0_2_3"><code>wasi:sockets/udp-create-socket@0.2.3</code></a></li>
-<li>interface <a href="#wasi_io_error_0_2_3"><code>wasi:io/error@0.2.3</code></a></li>
-<li>interface <a href="#wasi_io_streams_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
-<li>interface <a href="#wasi_clocks_monotonic_clock_0_2_3"><code>wasi:clocks/[email protected].3</code></a></li>
-<li>interface <a href="#wasi_sockets_tcp_0_2_3"><code>wasi:sockets/[email protected].3</code></a></li>
-<li>interface <a href="#wasi_sockets_tcp_create_socket_0_2_3"><code>wasi:sockets/[email protected].3</code></a></li>
-<li>interface <a href="#wasi_sockets_ip_name_lookup_0_2_3"><code>wasi:sockets/[email protected].3</code></a></li>
+<li>interface <a href="#wasi_io_error_0_2_4"><code>wasi:io/error@0.2.4</code></a></li>
+<li>interface <a href="#wasi_sockets_network_0_2_4"><code>wasi:sockets/[email protected].4</code></a></li>
+<li>interface <a href="#wasi_sockets_instance_network_0_2_4"><code>wasi:sockets/instance-network@0.2.4</code></a></li>
+<li>interface <a href="#wasi_io_poll_0_2_4"><code>wasi:io/poll@0.2.4</code></a></li>
+<li>interface <a href="#wasi_sockets_udp_0_2_4"><code>wasi:sockets/[email protected].4</code></a></li>
+<li>interface <a href="#wasi_sockets_udp_create_socket_0_2_4"><code>wasi:sockets/udp-create-socket@0.2.4</code></a></li>
+<li>interface <a href="#wasi_io_streams_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
+<li>interface <a href="#wasi_clocks_monotonic_clock_0_2_4"><code>wasi:clocks/[email protected].4</code></a></li>
+<li>interface <a href="#wasi_sockets_tcp_0_2_4"><code>wasi:sockets/[email protected].4</code></a></li>
+<li>interface <a href="#wasi_sockets_tcp_create_socket_0_2_4"><code>wasi:sockets/[email protected].4</code></a></li>
+<li>interface <a href="#wasi_sockets_ip_name_lookup_0_2_4"><code>wasi:sockets/[email protected].4</code></a></li>
 </ul>
 </li>
 </ul>
-<h2><a id="wasi_sockets_network_0_2_3"></a>Import interface wasi:sockets/network@0.2.3</h2>
+<h2><a id="wasi_io_error_0_2_4"></a>Import interface wasi:io/error@0.2.4</h2>
 <hr />
 <h3>Types</h3>
-<h4><a id="network"></a><code>resource network</code></h4>
+<h4><a id="error"></a><code>resource error</code></h4>
+<p>A resource which represents some error information.</p>
+<p>The only method provided by this resource is <code>to-debug-string</code>,
+which provides some human-readable information about the error.</p>
+<p>In the <code>wasi:io</code> package, this resource is returned through the
+<code>wasi:io/streams/stream-error</code> type.</p>
+<p>To provide more specific error information, other interfaces may
+offer functions to &quot;downcast&quot; this error into more specific types. For example,
+errors returned from streams derived from filesystem types can be described using
+the filesystem's own error-code type. This is done using the function
+<code>wasi:filesystem/types/filesystem-error-code</code>, which takes a <code>borrow&lt;error&gt;</code>
+parameter and returns an <code>option&lt;wasi:filesystem/types/error-code&gt;</code>.</p>
+<h2>The set of functions which can &quot;downcast&quot; an <a href="#error"><code>error</code></a> into a more
+concrete type is open.</h2>
+<h3>Functions</h3>
+<h4><a id="method_error_to_debug_string"></a><code>[method]error.to-debug-string: func</code></h4>
+<p>Returns a string that is suitable to assist humans in debugging
+this error.</p>
+<p>WARNING: The returned string should not be consumed mechanically!
+It may change across platforms, hosts, or other implementation
+details. Parsing this string is a major platform-compatibility
+hazard.</p>
+<h5>Params</h5>
+<ul>
+<li><a id="method_error_to_debug_string.self"></a><code>self</code>: borrow&lt;<a href="#error"><a href="#error"><code>error</code></a></a>&gt;</li>
+</ul>
+<h5>Return values</h5>
+<ul>
+<li><a id="method_error_to_debug_string.0"></a> <code>string</code></li>
+</ul>
+<h2><a id="wasi_sockets_network_0_2_4"></a>Import interface wasi:sockets/[email protected]</h2>
+<hr />
+<h3>Types</h3>
+<h4><a id="error"></a><code>type error</code></h4>
+<p><a href="#error"><a href="#error"><code>error</code></a></a></p>
+<p>
+#### <a id="network"></a>`resource network`
 <p>An opaque resource that represents access to (a subset of) the network.
 This enables context-based security for networking.
 There is no need for this to map 1:1 to a physical network interface.</p>
@@ -209,7 +245,26 @@ supported size.
 <li><a id="ip_socket_address.ipv4"></a><code>ipv4</code>: <a href="#ipv4_socket_address"><a href="#ipv4_socket_address"><code>ipv4-socket-address</code></a></a></li>
 <li><a id="ip_socket_address.ipv6"></a><code>ipv6</code>: <a href="#ipv6_socket_address"><a href="#ipv6_socket_address"><code>ipv6-socket-address</code></a></a></li>
 </ul>
-<h2><a id="wasi_sockets_instance_network_0_2_3"></a>Import interface wasi:sockets/[email protected]</h2>
+<hr />
+<h3>Functions</h3>
+<h4><a id="network_error_code"></a><code>network-error-code: func</code></h4>
+<p>Attempts to extract a network-related <a href="#error_code"><code>error-code</code></a> from the stream
+<a href="#error"><code>error</code></a> provided.</p>
+<p>Stream operations which return <a href="#stream_error.last_operation_failed"><code>stream-error::last-operation-failed</code></a>
+have a payload with more information about the operation that failed.
+This payload can be passed through to this function to see if there's
+network-related information about the error to return.</p>
+<p>Note that this function is fallible because not all stream-related
+errors are network-related errors.</p>
+<h5>Params</h5>
+<ul>
+<li><a id="network_error_code.err"></a><code>err</code>: borrow&lt;<a href="#error"><a href="#error"><code>error</code></a></a>&gt;</li>
+</ul>
+<h5>Return values</h5>
+<ul>
+<li><a id="network_error_code.0"></a> option&lt;<a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
+</ul>
+<h2><a id="wasi_sockets_instance_network_0_2_4"></a>Import interface wasi:sockets/[email protected]</h2>
 <p>This interface provides a value-export of the default network handle..</p>
 <hr />
 <h3>Types</h3>
@@ -224,7 +279,7 @@ supported size.
 <ul>
 <li><a id="instance_network.0"></a> own&lt;<a href="#network"><a href="#network"><code>network</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_io_poll_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
+<h2><a id="wasi_io_poll_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
 <p>A poll API intended to let users wait for I/O events on multiple handles
 at once.</p>
 <hr />
@@ -277,7 +332,7 @@ being ready for I/O.</p>
 <ul>
 <li><a id="poll.0"></a> list&lt;<code>u32</code>&gt;</li>
 </ul>
-<h2><a id="wasi_sockets_udp_0_2_3"></a>Import interface wasi:sockets/[email protected].3</h2>
+<h2><a id="wasi_sockets_udp_0_2_4"></a>Import interface wasi:sockets/[email protected].4</h2>
 <hr />
 <h3>Types</h3>
 <h4><a id="pollable"></a><code>type pollable</code></h4>
@@ -691,7 +746,7 @@ It's planned to be removed when <code>future</code> is natively supported in Pre
 <ul>
 <li><a id="method_outgoing_datagram_stream_subscribe.0"></a> own&lt;<a href="#pollable"><a href="#pollable"><code>pollable</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_sockets_udp_create_socket_0_2_3"></a>Import interface wasi:sockets/[email protected].3</h2>
+<h2><a id="wasi_sockets_udp_create_socket_0_2_4"></a>Import interface wasi:sockets/[email protected].4</h2>
 <hr />
 <h3>Types</h3>
 <h4><a id="network"></a><code>type network</code></h4>
@@ -736,40 +791,7 @@ the socket is effectively an in-memory configuration object, unable to communica
 <ul>
 <li><a id="create_udp_socket.0"></a> result&lt;own&lt;<a href="#udp_socket"><a href="#udp_socket"><code>udp-socket</code></a></a>&gt;, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_io_error_0_2_3"></a>Import interface wasi:io/[email protected]</h2>
-<hr />
-<h3>Types</h3>
-<h4><a id="error"></a><code>resource error</code></h4>
-<p>A resource which represents some error information.</p>
-<p>The only method provided by this resource is <code>to-debug-string</code>,
-which provides some human-readable information about the error.</p>
-<p>In the <code>wasi:io</code> package, this resource is returned through the
-<code>wasi:io/streams/stream-error</code> type.</p>
-<p>To provide more specific error information, other interfaces may
-offer functions to &quot;downcast&quot; this error into more specific types. For example,
-errors returned from streams derived from filesystem types can be described using
-the filesystem's own error-code type. This is done using the function
-<code>wasi:filesystem/types/filesystem-error-code</code>, which takes a <code>borrow&lt;error&gt;</code>
-parameter and returns an <code>option&lt;wasi:filesystem/types/error-code&gt;</code>.</p>
-<h2>The set of functions which can &quot;downcast&quot; an <a href="#error"><code>error</code></a> into a more
-concrete type is open.</h2>
-<h3>Functions</h3>
-<h4><a id="method_error_to_debug_string"></a><code>[method]error.to-debug-string: func</code></h4>
-<p>Returns a string that is suitable to assist humans in debugging
-this error.</p>
-<p>WARNING: The returned string should not be consumed mechanically!
-It may change across platforms, hosts, or other implementation
-details. Parsing this string is a major platform-compatibility
-hazard.</p>
-<h5>Params</h5>
-<ul>
-<li><a id="method_error_to_debug_string.self"></a><code>self</code>: borrow&lt;<a href="#error"><a href="#error"><code>error</code></a></a>&gt;</li>
-</ul>
-<h5>Return values</h5>
-<ul>
-<li><a id="method_error_to_debug_string.0"></a> <code>string</code></li>
-</ul>
-<h2><a id="wasi_io_streams_0_2_3"></a>Import interface wasi:io/[email protected]</h2>
+<h2><a id="wasi_io_streams_0_2_4"></a>Import interface wasi:io/[email protected]</h2>
 <p>WASI I/O is an I/O abstraction API which is currently focused on providing
 stream types.</p>
 <p>In the future, the component model is expected to add built-in stream types;
@@ -1099,7 +1121,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
 <ul>
 <li><a id="method_output_stream_blocking_splice.0"></a> result&lt;<code>u64</code>, <a href="#stream_error"><a href="#stream_error"><code>stream-error</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_clocks_monotonic_clock_0_2_3"></a>Import interface wasi:clocks/[email protected].3</h2>
+<h2><a id="wasi_clocks_monotonic_clock_0_2_4"></a>Import interface wasi:clocks/[email protected].4</h2>
 <p>WASI Monotonic Clock is a clock API intended to let users measure elapsed
 time.</p>
 <p>It is intended to be portable at least between Unix-family platforms and
@@ -1158,7 +1180,7 @@ elapsed from the time this function is invoked.</p>
 <ul>
 <li><a id="subscribe_duration.0"></a> own&lt;<a href="#pollable"><a href="#pollable"><code>pollable</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_sockets_tcp_0_2_3"></a>Import interface wasi:sockets/[email protected].3</h2>
+<h2><a id="wasi_sockets_tcp_0_2_4"></a>Import interface wasi:sockets/[email protected].4</h2>
 <hr />
 <h3>Types</h3>
 <h4><a id="input_stream"></a><code>type input-stream</code></h4>
@@ -1749,7 +1771,7 @@ has no effect and returns <code>ok</code>.</p>
 <ul>
 <li><a id="method_tcp_socket_shutdown.0"></a> result&lt;_, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_sockets_tcp_create_socket_0_2_3"></a>Import interface wasi:sockets/[email protected].3</h2>
+<h2><a id="wasi_sockets_tcp_create_socket_0_2_4"></a>Import interface wasi:sockets/[email protected].4</h2>
 <hr />
 <h3>Types</h3>
 <h4><a id="network"></a><code>type network</code></h4>
@@ -1794,7 +1816,7 @@ is called, the socket is effectively an in-memory configuration object, unable t
 <ul>
 <li><a id="create_tcp_socket.0"></a> result&lt;own&lt;<a href="#tcp_socket"><a href="#tcp_socket"><code>tcp-socket</code></a></a>&gt;, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
 </ul>
-<h2><a id="wasi_sockets_ip_name_lookup_0_2_3"></a>Import interface wasi:sockets/[email protected].3</h2>
+<h2><a id="wasi_sockets_ip_name_lookup_0_2_4"></a>Import interface wasi:sockets/[email protected].4</h2>
 <hr />
 <h3>Types</h3>
 <h4><a id="pollable"></a><code>type pollable</code></h4>

wit/deps.lock

@@ -1,9 +1,9 @@
 [clocks]
 url = "https://github.com/WebAssembly/wasi-clocks/archive/main.tar.gz"
-sha256 = "93a701968a7dd3c5d69031bc0601681c468972fdf7e28a93bb6150a67d6ebe8b"
-sha512 = "98fca567c7a01887b0fb38981f1772169b6ea8de475b546508f8b86738d84e44ba95cae81def40ac34e8809f5f60e85224077ab8cb6d6d5d6296acc1df73c159"
+sha256 = "fc36267c5098ad9ac6455396b27c8ef206ca23cae74f40bd44c57be68e7849b6"
+sha512 = "0deed3d3a86f284adda7991cd24c0c4aab806ba2e0cb111da80d7f99c05f10793a602b28451407cad58ab762997f60c0f6d173e919e4a0988773b455d3a410d3"
 
 [io]
 url = "https://github.com/WebAssembly/wasi-io/archive/main.tar.gz"
-sha256 = "1cccbfe4122686ea57a25cd368e8cdfc408cbcad089f47fb6685b6f92e96f050"
-sha512 = "7a95f964c13da52611141acd89bc8876226497f128e99dd176a4270c5b5efbd8cc847b5fbd1a91258d028c646db99e0424d72590cf1caf20f9f3a3343fad5017"
+sha256 = "770a73d479cda8e4c4064dd4006d2654ebcc358952079d74e41af27cf26bddbf"
+sha512 = "b790f9750ac6782d9aaaa379845600b66dbde14ecee42f159c29796447eb8e61ee61f3b306e92622993b5e25298834b6ff62d7d9a04f8f18c05f07eda8f47ae0"

wit/deps/clocks/monotonic-clock.wit

@@ -1,4 +1,4 @@
-package wasi:clocks@0.2.3;
+package wasi:clocks@0.2.4;
 /// WASI Monotonic Clock is a clock API intended to let users measure elapsed
 /// time.
 ///
@@ -10,7 +10,7 @@ package wasi:[email protected];
 @since(version = 0.2.0)
 interface monotonic-clock {
     @since(version = 0.2.0)
-    use wasi:io/poll@0.2.3.{pollable};
+    use wasi:io/poll@0.2.4.{pollable};
 
     /// An instant in time, in nanoseconds. An instant is relative to an
     /// unspecified initial value, and can only be compared to instances from

wit/deps/clocks/timezone.wit

@@ -1,4 +1,4 @@
-package wasi:clocks@0.2.3;
+package wasi:clocks@0.2.4;
 
 @unstable(feature = clocks-timezone)
 interface timezone {

wit/deps/clocks/wall-clock.wit

@@ -1,4 +1,4 @@
-package wasi:clocks@0.2.3;
+package wasi:clocks@0.2.4;
 /// WASI Wall Clock is a clock API intended to let users query the current
 /// time. The name "wall" makes an analogy to a "clock on the wall", which
 /// is not necessarily monotonic as it may be reset.

wit/deps/clocks/world.wit

@@ -1,4 +1,4 @@
-package wasi:clocks@0.2.3;
+package wasi:clocks@0.2.4;
 
 @since(version = 0.2.0)
 world imports {

wit/deps/io/error.wit

@@ -1,4 +1,4 @@
-package wasi:io@0.2.3;
+package wasi:io@0.2.4;
 
 @since(version = 0.2.0)
 interface error {

wit/deps/io/poll.wit

@@ -1,4 +1,4 @@
-package wasi:io@0.2.3;
+package wasi:io@0.2.4;
 
 /// A poll API intended to let users wait for I/O events on multiple handles
 /// at once.
@@ -8,19 +8,19 @@ interface poll {
     @since(version = 0.2.0)
     resource pollable {
 
-      /// Return the readiness of a pollable. This function never blocks.
-      ///
-      /// Returns `true` when the pollable is ready, and `false` otherwise.
-      @since(version = 0.2.0)
-      ready: func() -> bool;
+        /// Return the readiness of a pollable. This function never blocks.
+        ///
+        /// Returns `true` when the pollable is ready, and `false` otherwise.
+        @since(version = 0.2.0)
+        ready: func() -> bool;
 
-      /// `block` returns immediately if the pollable is ready, and otherwise
-      /// blocks until ready.
-      ///
-      /// This function is equivalent to calling `poll.poll` on a list
-      /// containing only this pollable.
-      @since(version = 0.2.0)
-      block: func();
+        /// `block` returns immediately if the pollable is ready, and otherwise
+        /// blocks until ready.
+        ///
+        /// This function is equivalent to calling `poll.poll` on a list
+        /// containing only this pollable.
+        @since(version = 0.2.0)
+        block: func();
     }
 
     /// Poll for completion on a set of pollables.

wit/deps/io/streams.wit

@@ -1,4 +1,4 @@
-package wasi:io@0.2.3;
+package wasi:io@0.2.4;
 
 /// WASI I/O is an I/O abstraction API which is currently focused on providing
 /// stream types.

wit/deps/io/world.wit

@@ -1,4 +1,4 @@
-package wasi:io@0.2.3;
+package wasi:io@0.2.4;
 
 @since(version = 0.2.0)
 world imports {