kobako 0.30.0 → 0.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (266) hide show
  1. checksums.yaml +4 -4
  2. data/.release-please-manifest.json +1 -1
  3. data/CHANGELOG.md +335 -0
  4. data/Cargo.lock +469 -11
  5. data/README.md +43 -3
  6. data/ROADMAP.md +1 -1
  7. data/crates/kobako-runtime/CHANGELOG.md +219 -0
  8. data/crates/kobako-runtime/Cargo.toml +51 -3
  9. data/crates/kobako-runtime/README.md +7 -4
  10. data/crates/kobako-runtime/src/cred.rs +124 -0
  11. data/crates/kobako-runtime/src/dispatch.rs +4 -5
  12. data/crates/kobako-runtime/src/endpoint/buffer.rs +153 -44
  13. data/crates/kobako-runtime/src/endpoint/dispatch.rs +80 -41
  14. data/crates/kobako-runtime/src/endpoint/invoke.rs +23 -36
  15. data/crates/kobako-runtime/src/endpoint.rs +137 -36
  16. data/crates/kobako-runtime/src/errno.rs +391 -0
  17. data/crates/kobako-runtime/src/error.rs +31 -10
  18. data/crates/kobako-runtime/src/filesystem/anon_inodes.rs +52 -0
  19. data/crates/kobako-runtime/src/filesystem/bind/lookup.rs +52 -14
  20. data/crates/kobako-runtime/src/filesystem/bind/walk.rs +19 -20
  21. data/crates/kobako-runtime/src/filesystem/bind.rs +437 -245
  22. data/crates/kobako-runtime/src/filesystem/overlay/file.rs +6 -6
  23. data/crates/kobako-runtime/src/filesystem/overlay/path.rs +43 -65
  24. data/crates/kobako-runtime/src/filesystem/overlay/stack/copy_up.rs +9 -16
  25. data/crates/kobako-runtime/src/filesystem/overlay/stack/dir.rs +47 -72
  26. data/crates/kobako-runtime/src/filesystem/overlay/stack/namei.rs +12 -12
  27. data/crates/kobako-runtime/src/filesystem/overlay/stack/readdir.rs +4 -7
  28. data/crates/kobako-runtime/src/filesystem/overlay/stack.rs +121 -37
  29. data/crates/kobako-runtime/src/filesystem/overlay.rs +302 -343
  30. data/crates/kobako-runtime/src/filesystem/pipe.rs +12 -9
  31. data/crates/kobako-runtime/src/filesystem/rdir.rs +15 -32
  32. data/crates/kobako-runtime/src/filesystem/tmpfs/seed.rs +32 -0
  33. data/crates/kobako-runtime/src/filesystem/tmpfs/tmpfile.rs +3 -3
  34. data/crates/kobako-runtime/src/filesystem/tmpfs/whiteout.rs +57 -35
  35. data/crates/kobako-runtime/src/filesystem/tmpfs/xattr.rs +2 -2
  36. data/crates/kobako-runtime/src/filesystem/tmpfs.rs +172 -160
  37. data/crates/kobako-runtime/src/filesystem/wrap.rs +36 -52
  38. data/crates/kobako-runtime/src/filesystem.rs +6 -3
  39. data/crates/kobako-runtime/src/fork.rs +96 -0
  40. data/crates/kobako-runtime/src/grant.rs +3 -0
  41. data/crates/kobako-runtime/src/hashtable.rs +4 -2
  42. data/crates/kobako-runtime/src/lib.rs +18 -7
  43. data/crates/kobako-runtime/src/limits.rs +195 -0
  44. data/crates/kobako-runtime/src/locking.rs +10 -0
  45. data/crates/kobako-runtime/src/memcg.rs +383 -0
  46. data/crates/kobako-runtime/src/mount.rs +67 -9
  47. data/crates/kobako-runtime/src/net/backends.rs +43 -0
  48. data/crates/kobako-runtime/src/net/connections.rs +179 -0
  49. data/crates/kobako-runtime/src/net/credential.rs +125 -0
  50. data/crates/kobako-runtime/src/net/egress.rs +160 -0
  51. data/crates/kobako-runtime/src/net/family.rs +181 -0
  52. data/crates/kobako-runtime/src/net/http.rs +2733 -0
  53. data/crates/kobako-runtime/src/net/lookup.rs +285 -0
  54. data/crates/kobako-runtime/src/net/mock.rs +251 -0
  55. data/crates/kobako-runtime/src/net/namespace.rs +1366 -0
  56. data/crates/kobako-runtime/src/net/reactor.rs +531 -0
  57. data/crates/kobako-runtime/src/net/resolv/darwin.rs +275 -0
  58. data/crates/kobako-runtime/src/net/resolv/stub/tests.rs +469 -0
  59. data/crates/kobako-runtime/src/net/resolv/stub.rs +536 -0
  60. data/crates/kobako-runtime/src/net/resolv/windows.rs +248 -0
  61. data/crates/kobako-runtime/src/net/resolv.rs +227 -0
  62. data/crates/kobako-runtime/src/net/socket.rs +870 -0
  63. data/crates/kobako-runtime/src/net/tcp.rs +1588 -0
  64. data/crates/kobako-runtime/src/net/tls.rs +58 -0
  65. data/crates/kobako-runtime/src/net/transport.rs +279 -0
  66. data/crates/kobako-runtime/src/net/udp.rs +1003 -0
  67. data/crates/kobako-runtime/src/net.rs +42 -0
  68. data/crates/kobako-runtime/src/network/builder.rs +177 -0
  69. data/crates/kobako-runtime/src/network/ruleset.rs +777 -0
  70. data/crates/kobako-runtime/src/network.rs +551 -0
  71. data/crates/kobako-runtime/src/policy.rs +16 -0
  72. data/crates/kobako-runtime/src/profile.rs +29 -144
  73. data/crates/kobako-runtime/src/runtime.rs +3 -5
  74. data/crates/kobako-runtime/src/sched.rs +130 -29
  75. data/crates/kobako-runtime/src/security/entry_policy.rs +22 -0
  76. data/crates/kobako-runtime/src/{vfs/cred.rs → security/hooks.rs} +52 -144
  77. data/crates/kobako-runtime/src/security/mount_policy.rs +158 -0
  78. data/crates/kobako-runtime/src/security.rs +101 -196
  79. data/crates/kobako-runtime/src/snapshot.rs +121 -2
  80. data/crates/kobako-runtime/src/vfs/attr.rs +5 -5
  81. data/crates/kobako-runtime/src/vfs/dentry.rs +143 -89
  82. data/crates/kobako-runtime/src/vfs/file.rs +199 -203
  83. data/crates/kobako-runtime/src/vfs/inode.rs +41 -45
  84. data/crates/kobako-runtime/src/vfs/kern_path.rs +38 -42
  85. data/crates/kobako-runtime/src/vfs/mount.rs +10 -9
  86. data/crates/kobako-runtime/src/vfs/namei.rs +829 -700
  87. data/crates/kobako-runtime/src/vfs/namespace.rs +162 -0
  88. data/crates/kobako-runtime/src/vfs/open_files.rs +69 -0
  89. data/crates/kobako-runtime/src/vfs/openat2.rs +3 -3
  90. data/crates/kobako-runtime/src/vfs/path.rs +6 -6
  91. data/crates/kobako-runtime/src/vfs/readdir.rs +6 -6
  92. data/crates/kobako-runtime/src/vfs/stat.rs +159 -23
  93. data/crates/kobako-runtime/src/vfs/super_block.rs +18 -14
  94. data/crates/kobako-runtime/src/vfs/utimes.rs +37 -27
  95. data/crates/kobako-runtime/src/vfs.rs +9 -6
  96. data/crates/kobako-runtime/src/wait.rs +356 -0
  97. data/crates/kobako-transport/CHANGELOG.md +31 -0
  98. data/crates/kobako-transport/Cargo.toml +1 -1
  99. data/crates/kobako-transport/README.md +3 -4
  100. data/crates/kobako-transport/src/abi.rs +78 -72
  101. data/crates/kobako-transport/src/envelope/bytes.rs +17 -6
  102. data/crates/kobako-transport/src/envelope/call.rs +32 -4
  103. data/crates/kobako-transport/src/envelope/error_record.rs +21 -0
  104. data/crates/kobako-transport/src/envelope/name.rs +99 -0
  105. data/crates/kobako-transport/src/envelope/outcome.rs +9 -9
  106. data/crates/kobako-transport/src/envelope/preamble.rs +24 -21
  107. data/crates/kobako-transport/src/envelope/reply.rs +27 -27
  108. data/crates/kobako-transport/src/envelope/unsupported.rs +10 -10
  109. data/crates/kobako-transport/src/envelope.rs +13 -8
  110. data/crates/kobako-wasmtime/CHANGELOG.md +161 -0
  111. data/crates/kobako-wasmtime/Cargo.toml +26 -7
  112. data/crates/kobako-wasmtime/README.md +3 -2
  113. data/crates/kobako-wasmtime/build/preview2.rs +1339 -0
  114. data/crates/kobako-wasmtime/build.rs +16 -0
  115. data/crates/kobako-wasmtime/src/abi.rs +17 -37
  116. data/crates/kobako-wasmtime/src/ambient.rs +33 -18
  117. data/crates/kobako-wasmtime/src/cache.rs +23 -15
  118. data/crates/kobako-wasmtime/src/config.rs +52 -68
  119. data/crates/kobako-wasmtime/src/driver.rs +48 -63
  120. data/crates/kobako-wasmtime/src/exports.rs +143 -17
  121. data/crates/kobako-wasmtime/src/guest.rs +12 -6
  122. data/crates/kobako-wasmtime/src/guest_binary.rs +14 -0
  123. data/crates/kobako-wasmtime/src/imports.rs +42 -18
  124. data/crates/kobako-wasmtime/src/instance_pre.rs +4 -4
  125. data/crates/kobako-wasmtime/src/invocation.rs +74 -12
  126. data/crates/kobako-wasmtime/src/lib.rs +5 -3
  127. data/crates/kobako-wasmtime/src/limiter.rs +70 -5
  128. data/crates/kobako-wasmtime/src/preview1/descriptors.rs +309 -0
  129. data/crates/kobako-wasmtime/src/preview1/differential/mount.rs +5 -15
  130. data/crates/kobako-wasmtime/src/preview1/differential.rs +27 -31
  131. data/crates/kobako-wasmtime/src/preview1/errno.rs +55 -66
  132. data/crates/kobako-wasmtime/src/preview1/fd.rs +327 -296
  133. data/crates/kobako-wasmtime/src/preview1/memory.rs +21 -12
  134. data/crates/kobako-wasmtime/src/preview1/mount_view/wrap.rs +34 -53
  135. data/crates/kobako-wasmtime/src/preview1/mount_view.rs +231 -217
  136. data/crates/kobako-wasmtime/src/preview1/path.rs +56 -121
  137. data/crates/kobako-wasmtime/src/preview1/poll.rs +244 -120
  138. data/crates/kobako-wasmtime/src/preview1/sock.rs +10 -8
  139. data/crates/kobako-wasmtime/src/preview1/testsuite.rs +5 -15
  140. data/crates/kobako-wasmtime/src/preview1.rs +46 -42
  141. data/crates/kobako-wasmtime/src/preview2/abi.rs +227 -0
  142. data/crates/kobako-wasmtime/src/preview2/error.rs +118 -0
  143. data/crates/kobako-wasmtime/src/preview2/filesystem.rs +122 -0
  144. data/crates/kobako-wasmtime/src/preview2/host.rs +3959 -0
  145. data/crates/kobako-wasmtime/src/preview2/http.rs +1503 -0
  146. data/crates/kobako-wasmtime/src/preview2/io.rs +315 -0
  147. data/crates/kobako-wasmtime/src/preview2/sockets.rs +379 -0
  148. data/crates/kobako-wasmtime/src/preview2/table.rs +305 -0
  149. data/crates/kobako-wasmtime/src/preview2.rs +57 -0
  150. data/crates/kobako-wasmtime/src/trap.rs +24 -9
  151. data/crates/kobako-wasmtime/src/wasi.rs +210 -81
  152. data/crates/kobako-wasmtime/wit/deps/cli.wit +233 -0
  153. data/crates/kobako-wasmtime/wit/deps/clocks.wit +162 -0
  154. data/crates/kobako-wasmtime/wit/deps/filesystem.wit +589 -0
  155. data/crates/kobako-wasmtime/wit/deps/http.wit +733 -0
  156. data/crates/kobako-wasmtime/wit/deps/io.wit +299 -0
  157. data/crates/kobako-wasmtime/wit/deps/random.wit +92 -0
  158. data/crates/kobako-wasmtime/wit/deps/sockets.wit +949 -0
  159. data/data/kobako.wasm +0 -0
  160. data/ext/kobako/Cargo.toml +1 -1
  161. data/ext/kobako/src/{runtime/errors.rs → errors.rs} +34 -26
  162. data/ext/kobako/src/{runtime/escape.rs → escape.rs} +42 -11
  163. data/ext/kobako/src/{runtime/filesystem → filesystem}/grants.rs +30 -26
  164. data/ext/kobako/src/{runtime/filesystem → filesystem}/ruby.rs +149 -168
  165. data/ext/kobako/src/{runtime/filesystem.rs → filesystem.rs} +24 -15
  166. data/ext/kobako/src/gvl.rs +306 -0
  167. data/ext/kobako/src/lib.rs +64 -3
  168. data/ext/kobako/src/network/mock.rs +187 -0
  169. data/ext/kobako/src/network.rs +591 -0
  170. data/ext/kobako/src/runtime/bridge.rs +30 -29
  171. data/ext/kobako/src/runtime/snapshot.rs +4 -4
  172. data/ext/kobako/src/runtime.rs +221 -143
  173. data/ext/kobako/src/wire.rs +42 -0
  174. data/lib/kobako/catalog/extensions.rb +14 -2
  175. data/lib/kobako/catalog/flags.rb +3 -5
  176. data/lib/kobako/catalog/grants.rb +5 -4
  177. data/lib/kobako/catalog/handles.rb +5 -27
  178. data/lib/kobako/catalog/mount.rb +11 -3
  179. data/lib/kobako/catalog/network.rb +35 -0
  180. data/lib/kobako/catalog/replacements.rb +28 -0
  181. data/lib/kobako/catalog/services.rb +5 -19
  182. data/lib/kobako/catalog/snippets.rb +3 -18
  183. data/lib/kobako/catalog.rb +3 -0
  184. data/lib/kobako/codec/{utils.rb → boundary.rb} +4 -2
  185. data/lib/kobako/codec/decoder.rb +4 -4
  186. data/lib/kobako/codec/ext_types.rb +3 -3
  187. data/lib/kobako/codec/handle_walk.rb +3 -43
  188. data/lib/kobako/codec/value_budget.rb +132 -40
  189. data/lib/kobako/codec.rb +1 -1
  190. data/lib/kobako/context.rb +24 -11
  191. data/lib/kobako/errors.rb +15 -12
  192. data/lib/kobako/extension.rb +3 -2
  193. data/lib/kobako/filesystem.rb +9 -2
  194. data/lib/kobako/handle.rb +2 -2
  195. data/lib/kobako/names.rb +28 -0
  196. data/lib/kobako/network.rb +210 -0
  197. data/lib/kobako/outcome.rb +7 -7
  198. data/lib/kobako/pool.rb +45 -23
  199. data/lib/kobako/runtime.rb +3 -2
  200. data/lib/kobako/sandbox.rb +92 -35
  201. data/lib/kobako/sandbox_options.rb +41 -106
  202. data/lib/kobako/transport/argument_wrap.rb +64 -0
  203. data/lib/kobako/transport/block_failure.rb +1 -1
  204. data/lib/kobako/transport/dispatcher.rb +6 -6
  205. data/lib/kobako/transport/exposure.rb +26 -15
  206. data/lib/kobako/transport/reflection.rb +21 -4
  207. data/lib/kobako/transport/run.rb +8 -23
  208. data/lib/kobako/transport/yielder.rb +2 -9
  209. data/lib/kobako/transport.rb +1 -0
  210. data/lib/kobako/version.rb +1 -1
  211. data/lib/kobako.rb +6 -2
  212. data/release-please-config.json +15 -0
  213. data/sig/core/thread.rbs +6 -0
  214. data/sig/kobako/catalog/extensions.rbs +2 -0
  215. data/sig/kobako/catalog/grants.rbs +7 -4
  216. data/sig/kobako/catalog/handles.rbs +0 -2
  217. data/sig/kobako/catalog/mount.rbs +3 -1
  218. data/sig/kobako/catalog/network.rbs +20 -0
  219. data/sig/kobako/catalog/replacements.rbs +14 -0
  220. data/sig/kobako/catalog/services.rbs +0 -4
  221. data/sig/kobako/catalog/snippets.rbs +0 -2
  222. data/sig/kobako/codec/{utils.rbs → boundary.rbs} +2 -2
  223. data/sig/kobako/codec/handle_walk.rbs +0 -6
  224. data/sig/kobako/codec/value_budget.rbs +47 -4
  225. data/sig/kobako/context.rbs +3 -1
  226. data/sig/kobako/errors.rbs +4 -4
  227. data/sig/kobako/filesystem.rbs +21 -3
  228. data/sig/kobako/network.rbs +115 -0
  229. data/sig/kobako/outcome.rbs +1 -1
  230. data/sig/kobako/pool.rbs +7 -3
  231. data/sig/kobako/runtime.rbs +32 -3
  232. data/sig/kobako/sandbox.rbs +19 -2
  233. data/sig/kobako/sandbox_options.rbs +29 -38
  234. data/sig/kobako/transport/argument_wrap.rbs +15 -0
  235. data/sig/kobako/transport/error.rbs +1 -1
  236. data/sig/kobako/transport/exposure.rbs +2 -4
  237. data/sig/kobako/transport/reflection.rbs +10 -0
  238. data/sig/kobako/transport/run.rbs +0 -2
  239. data/sig/kobako/transport/yielder.rbs +0 -3
  240. data/sig/kobako/transport.rbs +1 -1
  241. data/sig/kobako.rbs +13 -0
  242. metadata +84 -35
  243. data/crates/kobako-runtime/src/endpoint/capture.rs +0 -115
  244. data/crates/kobako-runtime/src/endpoint/memory_cap.rs +0 -238
  245. data/crates/kobako-runtime/src/filesystem/path.rs +0 -21
  246. data/crates/kobako-runtime/src/vfs/errno.rs +0 -153
  247. data/crates/kobako-runtime/tests/linux_baseline/calls.rs +0 -171
  248. data/crates/kobako-runtime/tests/linux_baseline/concurrent.rs +0 -276
  249. data/crates/kobako-runtime/tests/linux_baseline/kobako.rs +0 -323
  250. data/crates/kobako-runtime/tests/linux_baseline/linux-baseline-expected.txt +0 -16
  251. data/crates/kobako-runtime/tests/linux_baseline/linux.rs +0 -449
  252. data/crates/kobako-runtime/tests/linux_baseline/main.rs +0 -611
  253. data/crates/kobako-runtime/tests/linux_baseline/permissions.rs +0 -236
  254. data/crates/kobako-wasmtime/src/descriptors.rs +0 -200
  255. data/crates/kobako-wasmtime/tests/integration/compile_posture.rs +0 -43
  256. data/crates/kobako-wasmtime/tests/integration/guest_file.rs +0 -1085
  257. data/crates/kobako-wasmtime/tests/integration/main.rs +0 -29
  258. data/crates/kobako-wasmtime/tests/integration/preamble_flags.rs +0 -70
  259. data/crates/kobako-wasmtime/tests/integration/snippet_compile.rs +0 -95
  260. data/crates/kobako-wasmtime/tests/integration/support/mod.rs +0 -30
  261. data/crates/kobako-wasmtime/tests/integration/unanswered_call.rs +0 -86
  262. data/crates/kobako-wasmtime/tests/integration/unsupported_call.rs +0 -51
  263. data/ext/kobako/src/runtime/gvl.rs +0 -147
  264. data/lib/kobako/constant_name.rb +0 -8
  265. data/sig/kobako/constant_name.rbs +0 -3
  266. /data/ext/kobako/src/{runtime/pinned_value.rs → pinned_value.rs} +0 -0
@@ -1,9 +1,10 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- require_relative "../constant_name"
4
3
  require_relative "../handle"
4
+ require_relative "../names"
5
5
  require_relative "../codec"
6
6
  require_relative "../payload"
7
+ require_relative "argument_wrap"
7
8
 
8
9
  module Kobako
9
10
  module Transport
@@ -11,7 +12,7 @@ module Kobako
11
12
  # legitimately holds one.
12
13
  class Run < Data.define(:entrypoint, :args, :kwargs) # :nodoc:
13
14
  def initialize(entrypoint:, args: [], kwargs: {})
14
- entrypoint = normalize_entrypoint(entrypoint)
15
+ entrypoint = Kobako.to_constant_name(entrypoint, "entrypoint")
15
16
  validate_args(args)
16
17
  validate_kwargs(kwargs)
17
18
  super
@@ -23,42 +24,26 @@ module Kobako
23
24
  # is counted from.
24
25
  def encode_payload(handles)
25
26
  Payload::Arguments.new(
26
- args: Codec::HandleWalk.deep_wrap(args, handles, 1),
27
- kwargs: Codec::HandleWalk.deep_wrap(kwargs, handles, 1)
27
+ args: ArgumentWrap.wrap(args, handles, 1),
28
+ kwargs: ArgumentWrap.wrap(kwargs, handles, 1)
28
29
  ).encode
29
30
  end
30
31
 
31
32
  private
32
33
 
33
- # A target of the wrong type raises TypeError, a Host App programming
34
- # error caught before the run reaches the guest.
35
- def normalize_entrypoint(target)
36
- unless target.is_a?(Symbol) || target.is_a?(String)
37
- raise TypeError, "entrypoint must be a Symbol or String, got #{target.class}"
38
- end
39
-
40
- target_str = target.to_s
41
- unless CONSTANT_NAME.match?(target_str)
42
- raise ArgumentError,
43
- "entrypoint must match #{CONSTANT_NAME.inspect} (got #{target.inspect})"
44
- end
45
-
46
- target_str.to_sym
47
- end
48
-
49
34
  def validate_args(args)
50
- raise ArgumentError, "arguments must be an Array" unless args.is_a?(Array)
35
+ raise TypeError, "arguments must be an Array" unless args.is_a?(Array)
51
36
  raise ArgumentError, forged_handle_message("arguments") if args.any?(Kobako::Handle)
52
37
  end
53
38
 
54
39
  # Checked here so the Host App sees the host-side message before any
55
40
  # encode boundary.
56
41
  def validate_kwargs(kwargs)
57
- raise ArgumentError, "keyword arguments must be a Hash" unless kwargs.is_a?(Hash)
42
+ raise TypeError, "keyword arguments must be a Hash" unless kwargs.is_a?(Hash)
58
43
 
59
44
  bad_keys = kwargs.each_key.grep_v(Symbol)
60
45
  unless bad_keys.empty?
61
- raise ArgumentError,
46
+ raise TypeError,
62
47
  "keyword argument keys must be Symbols (got #{bad_keys.inspect})"
63
48
  end
64
49
  raise ArgumentError, forged_handle_message("keyword argument values") if kwargs.each_value.any?(Kobako::Handle)
@@ -11,18 +11,15 @@ module Kobako
11
11
  @break_tag = break_tag
12
12
  @handles = handles
13
13
  @failure = failure
14
- @active = true
15
14
  end
16
15
 
17
16
  # The ok value is consumed by the host Service, so a Capability Handle
18
17
  # in it is restored. A block exit stays in the guest, so the Service
19
18
  # is only unwound.
20
19
  def yield(*args)
21
- raise LocalJumpError, "guest block invoked after host dispatch frame returned" unless @active
22
-
23
- arm, body, klass = @guest_yielder.call(encode_args(args))
20
+ arm, body, class_name = @guest_yielder.call(encode_args(args))
24
21
  raise UnsupportedError, "the Sandbox runtime does not support yielding to a block" if arm == :unsupported
25
- raise @failure.remember(BlockError.new(body, klass: klass)) if arm == :error
22
+ raise @failure.remember(BlockError.new(body, class_name: class_name)) if arm == :error
26
23
 
27
24
  throw @break_tag if arm == :break
28
25
 
@@ -33,10 +30,6 @@ module Kobako
33
30
  method(:yield).to_proc
34
31
  end
35
32
 
36
- def invalidate
37
- @active = false
38
- end
39
-
40
33
  private
41
34
 
42
35
  # Restated so the Service reads a refusal of its own argument rather
@@ -1,6 +1,7 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  require_relative "transport/call"
4
+ require_relative "transport/argument_wrap"
4
5
  require_relative "transport/run"
5
6
  require_relative "transport/block_failure"
6
7
  require_relative "transport/yielder"
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Kobako
4
- VERSION = "0.30.0"
4
+ VERSION = "0.31.0"
5
5
  end
data/lib/kobako.rb CHANGED
@@ -23,8 +23,10 @@
23
23
  #
24
24
  # [A type sits at the lowest tier that needs it]
25
25
  # Kobako::Handle sits at the root, for Codec.
26
- # [A native-defined handle that needs nothing in +lib/+ sits at the root]
27
- # Kobako::Filesystem sits at the root, for the Catalog.
26
+ # [A native piece sits at the tier of the constant it registers on]
27
+ # Kobako::Filesystem and Kobako::Network sit at the root, for the
28
+ # Catalog, and so do the name rules on Kobako itself, for the Catalog and
29
+ # Transport; Kobako::Runtime sits with the Sandbox that drives it.
28
30
  # [Outcome may require <tt>transport/error.rb</tt>]
29
31
  # The gem contract fixes the class name.
30
32
  # [<tt>Codec.track_handles</tt> wraps only the decode call]
@@ -44,7 +46,9 @@ rescue LoadError
44
46
  end
45
47
 
46
48
  require_relative "kobako/filesystem"
49
+ require_relative "kobako/network"
47
50
  require_relative "kobako/errors"
51
+ require_relative "kobako/names"
48
52
  require_relative "kobako/unresolved"
49
53
  require_relative "kobako/extension"
50
54
  require_relative "kobako/transport"
@@ -115,6 +115,11 @@
115
115
  "path": "/wasm/kobako-baker/Cargo.lock",
116
116
  "jsonpath": "$.package[?(@.name=='kobako-baker')].version"
117
117
  },
118
+ {
119
+ "type": "toml",
120
+ "path": "/wasm/kobako-baker/Cargo.toml",
121
+ "jsonpath": "$.dependencies['kobako-transport'].version"
122
+ },
118
123
  {
119
124
  "type": "generic",
120
125
  "path": "/wasm/kobako-baker/README.md"
@@ -140,6 +145,11 @@
140
145
  "path": "/wasm/Cargo.lock",
141
146
  "jsonpath": "$.package[?(@.name=='kobako-transport')].version"
142
147
  },
148
+ {
149
+ "type": "toml",
150
+ "path": "/wasm/kobako-baker/Cargo.lock",
151
+ "jsonpath": "$.package[?(@.name=='kobako-transport')].version"
152
+ },
143
153
  {
144
154
  "type": "generic",
145
155
  "path": "/crates/kobako-transport/README.md"
@@ -160,6 +170,11 @@
160
170
  "path": "/wasm/Cargo.lock",
161
171
  "jsonpath": "$.package[?(@.name=='kobako-codec')].version"
162
172
  },
173
+ {
174
+ "type": "toml",
175
+ "path": "/crates/kobako-codec/Cargo.toml",
176
+ "jsonpath": "$.dependencies['kobako-transport'].version"
177
+ },
163
178
  {
164
179
  "type": "generic",
165
180
  "path": "/crates/kobako-codec/README.md"
@@ -0,0 +1,6 @@
1
+ # The block form rbs 4.2.0 leaves out. ruby/rbs types it after that release
2
+ # (7c396890); this goes once a release carrying it is the floor.
3
+ class Thread
4
+ def self.handle_interrupt: [T] (Hash[Class, :immediate | :on_blocking | :never] hash) { (nil) -> T } -> T
5
+ | ...
6
+ end
@@ -17,6 +17,8 @@ module Kobako
17
17
 
18
18
  def validate: (untyped extension) -> void
19
19
 
20
+ def validate_dependencies: (untyped dependencies) -> void
21
+
20
22
  def unmet_dependency: () -> [untyped, untyped]?
21
23
 
22
24
  def symbolize: (untyped name) -> untyped
@@ -1,13 +1,16 @@
1
1
  module Kobako
2
2
  module Catalog
3
3
  class Grants
4
- def initialize: () -> void
4
+ type key = [Symbol, String]
5
+
6
+ type grant = Mount | Network
5
7
 
6
- def register: (Mount grant) -> nil
8
+ def initialize: () -> void
7
9
 
8
- def include?: (Mount grant) -> bool
10
+ def register: (grant grant) -> nil
9
11
 
10
- def entries: (?Hash[String, Mount] overrides) -> Array[Mount::tuple]
12
+ def include?: (grant grant) -> bool
13
+ def entries: (?Hash[key, grant] overrides) -> [Array[Mount::tuple], Array[Network::tuple]]
11
14
  end
12
15
  end
13
16
  end
@@ -13,8 +13,6 @@ module Kobako
13
13
 
14
14
  private
15
15
 
16
- def reject_unwrappable: (untyped object) -> void
17
-
18
16
  def ensure_capacity: () -> void
19
17
 
20
18
  def require_bound: (Integer id) -> void
@@ -14,7 +14,9 @@ module Kobako
14
14
 
15
15
  def self.new: (at: untyped, access: untyped, filesystem: untyped, policy: policy?) -> Mount
16
16
 
17
- def key: () -> String
17
+ def initialize: (at: untyped, access: untyped, filesystem: untyped, policy: policy?) -> void
18
+
19
+ def key: () -> Grants::key
18
20
 
19
21
  def conflict: (Mount other) -> String?
20
22
 
@@ -0,0 +1,20 @@
1
+ module Kobako
2
+ module Catalog
3
+ class Network < Data
4
+ type tuple = [String, untyped]
5
+
6
+ attr_reader name: String
7
+ attr_reader entry: untyped
8
+
9
+ def self.new: (name: untyped, entry: untyped) ?{ (Kobako::Network::Builder) -> void } -> Network
10
+
11
+ def initialize: (name: untyped, entry: untyped) ?{ (Kobako::Network::Builder) -> void } -> void
12
+
13
+ def key: () -> Grants::key
14
+
15
+ def conflict: (Mount | Network other) -> String?
16
+
17
+ def to_native: () -> tuple
18
+ end
19
+ end
20
+ end
@@ -0,0 +1,14 @@
1
+ module Kobako
2
+ module Catalog
3
+ class Replacements
4
+ @grants: Grants
5
+ @replaced: Hash[Grants::key, Grants::grant]
6
+
7
+ def initialize: (Grants grants) -> void
8
+
9
+ def replace: (Grants::grant grant, String refusal) -> nil
10
+
11
+ def entries: () -> [Array[Mount::tuple], Array[Network::tuple]]
12
+ end
13
+ end
14
+ end
@@ -1,8 +1,6 @@
1
1
  module Kobako
2
2
  module Catalog
3
3
  class Services
4
- RESERVED_NAMESPACE: String
5
-
6
4
  def initialize: () -> void
7
5
 
8
6
  def bind: (Symbol | String path, untyped object) -> self
@@ -17,8 +15,6 @@ module Kobako
17
15
 
18
16
  def validate_path: (Symbol | String path) -> String
19
17
 
20
- def reserved?: (String path) -> bool
21
-
22
18
  def collision?: (String path) -> bool
23
19
  end
24
20
  end
@@ -22,8 +22,6 @@ module Kobako
22
22
  def register_binary: (String bytes) -> nil
23
23
 
24
24
  def entry_tuple: (entry) -> tuple
25
-
26
- def normalize_name: (Symbol | String name) -> Symbol
27
25
  end
28
26
  end
29
27
  end
@@ -1,9 +1,9 @@
1
1
  module Kobako
2
2
  module Codec
3
- module Utils
3
+ module Boundary
4
4
  def self.assert_utf8: (String string, String label) -> void
5
5
 
6
- def self.with_boundary: [T] () { () -> T } -> T
6
+ def self.within: [T] () { () -> T } -> T
7
7
  end
8
8
  end
9
9
  end
@@ -5,16 +5,10 @@ module Kobako
5
5
 
6
6
  def self.representable?: (untyped value, ?Integer depth) -> bool
7
7
 
8
- def self.deep_wrap: (untyped value, Kobako::Codec::_HandleTable handles, ?Integer depth) -> untyped
9
-
10
8
  def self.deep_restore: (untyped value, Kobako::Codec::_HandleTable handles) -> untyped
11
9
 
12
10
  private
13
11
 
14
- def self.guard_nesting: (Integer depth) -> void
15
-
16
- def self.deep_wrap_hash: (Hash[untyped, untyped] hash, Kobako::Codec::_HandleTable handles, Integer depth) -> Hash[untyped, untyped]
17
-
18
12
  def self.primitive_type?: (untyped value) -> bool
19
13
 
20
14
  def self.container_representable?: (untyped value, Integer depth) -> bool
@@ -9,15 +9,58 @@ module Kobako
9
9
 
10
10
  UINT: Hash[Integer, String]
11
11
 
12
+ FLOAT_FORMATS: Hash[Integer, String]
13
+
14
+ FLOATS: Regexp
15
+
16
+ NAN_ENTRY: Integer
17
+
12
18
  def self.assert_within: (String bytes, Integer? budget) -> void
13
19
 
14
- private
20
+ class Count
21
+ class OpenContainer < Struct[untyped]
22
+ attr_accessor held: Integer
23
+ attr_accessor keyed: bool
24
+ attr_accessor read: Integer
25
+ attr_accessor nan_keys: Integer
26
+ attr_accessor holds_nan: bool
27
+
28
+ def self.new: (Integer held, bool keyed, Integer read, Integer nan_keys, bool holds_nan) -> OpenContainer
29
+ end
30
+
31
+ @bytes: String
32
+ @budget: Integer
33
+ @remaining: Integer
34
+ @open: Array[OpenContainer]
35
+
36
+ @ended: bool
37
+
38
+ def initialize: (String bytes, Integer budget) -> void
39
+
40
+ def run: () -> void
15
41
 
16
- def self.step: (String bytes, Integer pos) -> [Integer?, Integer]
42
+ private
17
43
 
18
- def self.step_framed:(String bytes, Integer pos, Integer marker) -> [Integer?, Integer]
44
+ def count_value: (Integer pos, Integer children, bool keyed) -> void
45
+
46
+ def close_value: (bool holds_nan) -> void
47
+
48
+ def charge_key: (OpenContainer map) -> void
49
+
50
+ def spend: (Integer values) -> void
51
+
52
+ def nan?: (Integer pos) -> bool
53
+
54
+ def step: (Integer pos) -> [Integer?, Integer, bool]
55
+
56
+ def step_framed: (Integer pos, Integer marker) -> [Integer?, Integer, bool]
57
+
58
+ def uint: (Integer pos, Integer width) -> Integer
59
+ end
60
+
61
+ private
19
62
 
20
- def self.uint: (String bytes, Integer pos, Integer width) -> Integer
63
+ def self.within_by_size?: (String bytes, Integer budget) -> bool
21
64
  end
22
65
  end
23
66
  end
@@ -2,7 +2,7 @@ module Kobako
2
2
  class Context
3
3
  type preamble = [Array[String], Array[Kobako::Catalog::Snippets::tuple], Array[Kobako::Catalog::Flags::tuple]]
4
4
 
5
- @mounts: Hash[String, Kobako::Catalog::Mount]?
5
+ @replacements: Kobako::Catalog::Replacements
6
6
 
7
7
  def initialize: (
8
8
  runtime: Kobako::Runtime,
@@ -16,6 +16,8 @@ module Kobako
16
16
 
17
17
  def mount: (String at, Kobako::Filesystem::mountable filesystem, ?access: Kobako::Filesystem::access) ?{ (String path, Kobako::Filesystem::access access) -> boolish } -> self
18
18
 
19
+ def network: (Symbol | String name, ?untyped entry) ?{ (Kobako::Network::Builder) -> void } -> self
20
+
19
21
  def lookup: (Symbol | String path) -> Kobako::Transport::Exposure
20
22
 
21
23
  def eval: (String code) ?{ (Kobako::Context) -> void } -> Kobako::Execution
@@ -21,18 +21,18 @@ module Kobako
21
21
  class SetupError < Error
22
22
  end
23
23
 
24
- class ModuleNotBuiltError < SetupError
24
+ class GuestBinaryNotFoundError < SetupError
25
25
  end
26
26
 
27
27
  module Diagnosable : Error
28
28
  attr_reader origin: String?
29
- attr_reader klass: String?
29
+ attr_reader class_name: String?
30
30
  attr_reader backtrace_lines: Array[String]?
31
31
 
32
32
  def initialize: (
33
33
  String message,
34
34
  ?origin: String?,
35
- ?klass: String?,
35
+ ?class_name: String?,
36
36
  ?backtrace_lines: Array[String]?
37
37
  ) -> void
38
38
  end
@@ -81,7 +81,7 @@ module Kobako
81
81
  ?name: Symbol?,
82
82
  ?available: Array[Symbol],
83
83
  ?origin: String?,
84
- ?klass: String?,
84
+ ?class_name: String?,
85
85
  ?backtrace_lines: Array[String]?
86
86
  ) -> void
87
87
  end
@@ -4,14 +4,21 @@ module Kobako
4
4
 
5
5
  type access = :read | :read_write
6
6
 
7
+ def self.validate_mount: (untyped at, untyped access, untyped filesystem) -> nil
8
+
7
9
  # What a Filesystem written in Ruby answers to be mounted. One that
8
10
  # also answers _Listable lists its directories, and one answering
9
11
  # _Writable takes changes too; each method it lacks is refused alone.
12
+ # One answering _Exclusive vouches only the guest changes it.
10
13
  interface _Readable
11
14
  def open: (String path, Integer flags) -> _File
12
15
  def stat: (String path) -> _Stat
13
16
  end
14
17
 
18
+ interface _Exclusive
19
+ def exclusive?: () -> boolish
20
+ end
21
+
15
22
  interface _Listable
16
23
  def children: (String path) -> Array[String]
17
24
  end
@@ -58,8 +65,9 @@ module Kobako
58
65
 
59
66
  # What a Filesystem written in Ruby's +stat+ answers, as +File::Stat+
60
67
  # does; an +ino+ of zero names no identity. One that also answers
61
- # _StatDevice names the device its +ino+ belongs to, and _StatKind says
62
- # a special file is one.
68
+ # _StatDevice names the device its +ino+ belongs to, _StatKind says a
69
+ # special file is one, _StatTimes gives its times, and _StatLinks its
70
+ # count of names.
63
71
  interface _Stat
64
72
  def directory?: () -> boolish
65
73
  def size: () -> Integer
@@ -74,6 +82,16 @@ module Kobako
74
82
  def ftype: () -> String
75
83
  end
76
84
 
85
+ interface _StatTimes
86
+ def atime: () -> Time
87
+ def mtime: () -> Time
88
+ def ctime: () -> Time
89
+ end
90
+
91
+ interface _StatLinks
92
+ def nlink: () -> Integer
93
+ end
94
+
77
95
  class Tmpfs
78
96
  # A bare <tt>"path" => contents</tt> arrives as keywords, which RBS
79
97
  # cannot key by String; a Symbol keyword past +size+ and +nr_inodes+
@@ -82,7 +100,7 @@ module Kobako
82
100
  end
83
101
 
84
102
  class Bind
85
- def initialize: (String path) -> void
103
+ def initialize: (String path, ?exclusive: bool) -> void
86
104
  end
87
105
 
88
106
  class Overlay
@@ -0,0 +1,115 @@
1
+ module Kobako
2
+ module Network
3
+ type protocol = :http | :tcp | :udp
4
+
5
+ UNWRITTEN: Object
6
+
7
+ def self.normalize_endpoint: (untyped host, untyped port, Hash[Symbol, untyped] written) ->
8
+ [String, Integer, protocol, Array[Symbol | String | IPAddr], Array[HttpRule]]
9
+
10
+ def self.normalize_rule: (bool allow, untyped method, untyped path) -> [bool, String?, String]
11
+
12
+ def self.normalize_credential: (Symbol | String placement, untyped placeholder) -> String
13
+
14
+ def self.validate_name: (String name) -> nil
15
+
16
+ class Mock
17
+ def initialize: (?local_addresses: Array[String]?) -> void
18
+
19
+ def resolve: (String name, to: String | Array[String]) -> nil
20
+
21
+ def route: (String address, Integer port, to: [String, Integer], ?protocol: :tcp | :udp) -> nil
22
+
23
+ def refuse: (String address, Integer port, singleton(SystemCallError) errno, ?protocol: :tcp | :udp) -> nil
24
+
25
+ def hold: [T] (String name) { () -> T } -> T
26
+
27
+ def lookups: () -> Array[String]
28
+
29
+ def dialed_addresses: () -> Array[[String, Integer]]
30
+ end
31
+
32
+ class Endpoint < Data
33
+ attr_reader host: String
34
+ attr_reader port: Integer
35
+ attr_reader protocol: protocol
36
+ attr_reader addresses: Array[Symbol | String | IPAddr]
37
+ attr_reader rules: Array[HttpRule]
38
+
39
+ def self.new: (host: untyped, port: untyped, ?protocol: untyped, ?addresses: untyped, ?rules: untyped) -> Endpoint
40
+
41
+ def initialize: (host: untyped, port: untyped, ?protocol: untyped, ?addresses: untyped, ?rules: untyped) -> void
42
+ end
43
+
44
+ class Connection < Data
45
+ attr_reader host: String
46
+ attr_reader port: Integer
47
+ attr_reader protocol: protocol
48
+
49
+ def self.new: (host: String, port: Integer, protocol: protocol) -> Connection
50
+ end
51
+
52
+ class HttpRule
53
+ @allow: bool
54
+
55
+ def allow?: () -> bool
56
+ attr_reader method: String?
57
+ attr_reader path: String
58
+
59
+ def initialize: (allow: boolish, method: untyped, path: untyped) -> void
60
+ end
61
+
62
+ class Rules
63
+ @rules: Array[HttpRule]
64
+
65
+ def initialize: () -> void
66
+
67
+ def allow: (untyped method, untyped path) -> self
68
+
69
+ def deny: (untyped method, untyped path) -> self
70
+
71
+ def to_a: () -> Array[HttpRule]
72
+ end
73
+
74
+ class Credential
75
+ @source: ^(Request) -> String?
76
+
77
+ attr_reader placement: Symbol | String
78
+ attr_reader placeholder: String
79
+
80
+ def initialize: (Symbol | String placement, placeholder: untyped) ?{ (Request) -> String? } -> void
81
+
82
+ def value: (Request request) -> String?
83
+ end
84
+
85
+ class Request
86
+ attr_reader host: String
87
+ attr_reader port: Integer
88
+ attr_reader method: String
89
+ attr_reader scheme: String
90
+ attr_reader path: String
91
+ attr_reader header_names: Array[String]
92
+
93
+ def initialize: ([String, Integer] authority, String method, String scheme, String path, Array[String] header_names) -> void
94
+ end
95
+
96
+ class Builder
97
+ HOOKS: Array[Symbol]
98
+
99
+ @entry: untyped
100
+ @endpoints: Array[Endpoint]
101
+ @policies: Hash[Symbol, Array[^(untyped) -> boolish]]
102
+ @credentials: Array[Credential]
103
+
104
+ def initialize: (?untyped entry) -> void
105
+
106
+ def credential: (Symbol | String placement, placeholder: untyped) ?{ (Request) -> String? } -> self
107
+
108
+ def endpoint: (untyped host, port: untyped, ?protocol: untyped, ?addresses: untyped) ?{ (Rules) -> void } -> self
109
+
110
+ def policy: (Symbol hook) ?{ (untyped) -> boolish } -> self
111
+
112
+ def to_native: () -> [untyped, Array[Endpoint], Array[Credential], Hash[Symbol, Array[^(untyped) -> boolish]]]
113
+ end
114
+ end
115
+ end
@@ -12,7 +12,7 @@ module Kobako
12
12
 
13
13
  def self.panic_error: (panic_fields panic, Symbol? entrypoint) -> (SandboxError | ServiceError)
14
14
 
15
- def self.error_class: (String origin, String klass) -> (singleton(SandboxError) | singleton(ServiceError))
15
+ def self.error_class: (String origin, String class_name) -> (singleton(SandboxError) | singleton(ServiceError))
16
16
 
17
17
  def self.decode_value: (String payload) -> Kobako::Codec::wire_value
18
18
 
data/sig/kobako/pool.rbs CHANGED
@@ -2,7 +2,9 @@ module Kobako
2
2
  class Pool
3
3
  DEFAULT_CHECKOUT_TIMEOUT_SECONDS: Float
4
4
 
5
- @slots: Integer
5
+ DEPRECATION: String
6
+
7
+ @size: Integer
6
8
  @checkout_timeout: Float?
7
9
  @sandbox_options: Hash[Symbol, untyped]
8
10
  @setup: ^(Kobako::Sandbox) -> void | nil
@@ -12,7 +14,7 @@ module Kobako
12
14
  @slot_freed: Thread::ConditionVariable
13
15
 
14
16
  def initialize: (
15
- slots: Integer,
17
+ size: Integer,
16
18
  ?checkout_timeout: (Float | Integer)?,
17
19
  **untyped sandbox_options
18
20
  ) ?{ (Kobako::Sandbox) -> void } -> void
@@ -29,13 +31,15 @@ module Kobako
29
31
 
30
32
  def construct_slot: () -> Kobako::Sandbox
31
33
 
34
+ def build_slot: () -> Kobako::Sandbox
35
+
32
36
  def checkin: (Kobako::Sandbox sandbox) -> void
33
37
 
34
38
  def release_capacity: () -> void
35
39
 
36
40
  def monotonic_now: () -> Float
37
41
 
38
- def validate_slots: (untyped slots) -> void
42
+ def validate_size: (untyped size) -> void
39
43
 
40
44
  def normalize_checkout_timeout: ((Float | Integer)? checkout_timeout) -> Float?
41
45
  end