kobako 0.15.0-aarch64-linux → 0.16.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00df75af1fd85b3c4d3729d456148a282ab904f26162e6930ecd8ad003bcd9df
-  data.tar.gz: 34533660556ce44eddbc76831b973ed10217e5a3801affbb5b7a991e15069c3a
+  metadata.gz: e913ffb24d91b9fa9da48c73682cea2f988a8cb0e1260cb225a4771ba78e8dc6
+  data.tar.gz: 53bb553c8ad0c9aa6ceab60804c177ca7bd7c9a2748afc432824d5f1558dd079
 SHA512:
-  metadata.gz: 34250f5db8642efbab2654993df69316be3cdb581bafacc07ac6993e072ea5addf3c04bae86d41ad5412c182b3f22e9aa158b9e9cb27d86571a7cf01ad38a674
-  data.tar.gz: ac5d4d68b447714f78412acd554c842cbd52f8bfab46794ffa7fabe1dcc6a169bb4d04a3caf10e88bf16ff41b4312ab30626687ee46b31530514b5fa4ac93242
+  metadata.gz: f644ac3b93d75565dd83e299315f2149c9835b29f479b60dc6d7059e94fac9c0590969e0c472af907539916f9217452bc2b406e35df8bbd740622a7adc7b86b8
+  data.tar.gz: c68877ffb43417a9c8484d2beed4f328d76abc055bffe3a43a65ddfd10b7a7b940cb2a7230a281dfd70e8a6a95f04febac93e995e4f86f19e15490fea29d6bea

data/.release-please-manifest.json

@@ -1 +1 @@
-{".":"0.15.0","wasm/kobako-core":"0.9.0","wasm/kobako-mruby":"0.9.0","wasm/kobako-io":"0.9.0","wasm/kobako-json":"0.9.0","wasm/kobako-regexp":"0.9.0","wasm/kobako-baker":"0.9.0","crates/kobako-codec":"0.9.0","crates/kobako-runtime":"0.9.0","crates/kobako-wasmtime":"0.9.0","crates/kobako":"0.9.0"}
+{".":"0.16.0","wasm/kobako-core":"0.10.0","wasm/kobako-mruby":"0.10.0","wasm/kobako-io":"0.10.0","wasm/kobako-json":"0.10.0","wasm/kobako-regexp":"0.10.0","wasm/kobako-baker":"0.10.0","crates/kobako-codec":"0.10.0","crates/kobako-runtime":"0.10.0","crates/kobako-wasmtime":"0.10.0","crates/kobako":"0.10.0"}

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.16.0](https://github.com/elct9620/kobako/compare/v0.15.0...v0.16.0) (2026-07-12)
+
+
+### Features
+
+* **sandbox:** add the Extension install mechanism ([ad8e4da](https://github.com/elct9620/kobako/commit/ad8e4da703e4ceee85959663d77bb1e26c26791a))
+* **sdk:** add the Extension install mechanism to the Rust host SDK ([4043f76](https://github.com/elct9620/kobako/commit/4043f764b7038619a30c16542ed38d566e4a72a9))
+* **tasks:** break each module down by language in stats:<slug> ([b496e3c](https://github.com/elct9620/kobako/commit/b496e3cb23150f8f073cc1b972978cfbebfbb1e6))
+* **tasks:** report code sizes per publishable module in stats:all ([f554930](https://github.com/elct9620/kobako/commit/f554930e669a82bed0c7305c5cbbab96c3ae79da))
+* **tasks:** split impl vs inline test per module in stats:all ([cefa38d](https://github.com/elct9620/kobako/commit/cefa38d96ff79509b947269ea5c361ead0610bfa))
+
+
+### Bug Fixes
+
+* **tasks:** count Rust inline tests in the stats code-to-test ratio ([134c970](https://github.com/elct9620/kobako/commit/134c9704a5a9bb6fb01c1aa7968f907d1436e5f2))
+
 ## [0.15.0](https://github.com/elct9620/kobako/compare/v0.14.0...v0.15.0) (2026-07-11)
 
 

data/README.md

@@ -69,7 +69,7 @@ The host embeds the sandbox and owns the SPEC wire codec. Choose by your host la
 | Frontend | Package | Add it | Best for |
 |----------|---------|--------|----------|
 | Ruby gem | `kobako` (RubyGems) | `gem install kobako` | A Ruby host — Services, Handles, snippets, and pooling out of the box |
-| Rust SDK | `kobako` (crates.io) | `kobako = "0.8"` | A Rust host — the same behavior contract behind an idiomatic Rust API |
+| Rust SDK | `kobako` (crates.io) | `kobako = "0.9"` | A Rust host — the same behavior contract behind an idiomatic Rust API |
 | Low-level crates | `kobako-wasmtime` + `kobako-runtime` + `kobako-codec` | Cargo deps | A custom host, or driving the wire directly in another language |
 
 The Rust crates are documented on [crates.io](https://crates.io/crates/kobako); the Ruby gem is this README. Two runnable Rust hosts show the choice: [`plugin-rs`](examples/plugin-rs) builds on the SDK, and [`wire-rs`](examples/wire-rs) assembles a host by hand on the low-level crates.

data/crates/kobako-runtime/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.10.0](https://github.com/elct9620/kobako/compare/kobako-runtime-v0.9.0...kobako-runtime-v0.10.0) (2026-07-12)
+
+
+### Miscellaneous Chores
+
+* **kobako-runtime:** Synchronize kobako crates versions
+
 ## [0.9.0](https://github.com/elct9620/kobako/compare/kobako-runtime-v0.8.0...kobako-runtime-v0.9.0) (2026-07-11)
 
 

data/crates/kobako-runtime/README.md

@@ -26,7 +26,7 @@ map the neutral types onto their own language surface.
 
 ```toml
 [dependencies]
-kobako-runtime = "0.9.0" # x-release-please-version
+kobako-runtime = "0.10.0" # x-release-please-version
 ```
 
 ## License

data/crates/kobako-wasmtime/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.10.0](https://github.com/elct9620/kobako/compare/kobako-wasmtime-v0.9.0...kobako-wasmtime-v0.10.0) (2026-07-12)
+
+
+### Miscellaneous Chores
+
+* **kobako-wasmtime:** Synchronize kobako crates versions
+
 ## [0.9.0](https://github.com/elct9620/kobako/compare/kobako-wasmtime-v0.8.0...kobako-wasmtime-v0.9.0) (2026-07-11)
 
 

data/crates/kobako-wasmtime/README.md

@@ -24,7 +24,7 @@ SDK consumes the same surface.
 
 ```toml
 [dependencies]
-kobako-wasmtime = "0.9.0" # x-release-please-version
+kobako-wasmtime = "0.10.0" # x-release-please-version
 ```
 
 ## License

data/lib/kobako/catalog/extensions.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Kobako
+  module Catalog
+    # Kobako::Catalog::Extensions — per-Sandbox registry of installed
+    # Extensions. Composes each Extension onto the sibling registries at
+    # install time (its +source+ into +Catalog::Snippets+, its +backend+
+    # path into +Catalog::Services+), asserts declared dependencies are
+    # present when the Sandbox seals, and resolves each callable-backed
+    # path to a fresh object at the start of every invocation.
+    #
+    # Sealing and the reject-after-install guard are governed by the owning
+    # Sandbox through +Catalog::Services#sealed?+, the shared seal signal;
+    # this registry only records entries and enforces the Extension-shape
+    # and dependency rules.
+    class Extensions
+      def initialize
+        @entries = [] # : Array[untyped]
+        @asserted = false
+      end
+
+      # Install +extension+: validate its shape, register its +source+ as a
+      # preloaded snippet, and — when it carries a +backend+ — reserve the
+      # backend path in +services+. A callable provider reserves the path
+      # with a placeholder the per-invocation refresh replaces; a fixed
+      # provider binds its object directly. Raises +ArgumentError+ on a
+      # malformed Extension; a malformed +name+ or +backend.path+ surfaces
+      # through the +snippets+ / +services+ registration it routes to.
+      def install(extension, snippets:, services:)
+        validate!(extension)
+        snippets.register(code: extension.source, name: extension.name)
+        backend = extension.backend
+        services.bind(backend.path, initial_object(backend.provider)) if backend
+        @entries << extension
+        self
+      end
+
+      # Assert every installed Extension's +depends_on+ names a fellow
+      # installed Extension. Runs once, when the Sandbox first seals; an
+      # unmet dependency raises +ArgumentError+ naming the gap, before the
+      # guest runs. Idempotent across later invocations.
+      def seal!
+        return self if @asserted
+
+        @asserted = true
+        assert_dependencies!
+        self
+      end
+
+      # Resolve each callable-backed path to this invocation's object and
+      # refresh it behind its already-sealed path in +services+. Distinct
+      # providers yield distinct objects; one provider shared by several
+      # Extensions is invoked once and its result shared, so provider
+      # identity is resource identity. Fixed providers are left untouched —
+      # they stay the object bound at install.
+      def refresh_backends!(services)
+        resolved = {} # : Hash[untyped, untyped]
+        resolved.compare_by_identity
+        @entries.each { |extension| refresh_backend(extension, services, resolved) }
+        self
+      end
+
+      private
+
+      # Resolve one Extension's callable-backed path against the shared
+      # per-invocation +resolved+ cache (keyed by provider identity) and
+      # refresh it in +services+. A fixed provider is skipped — its object
+      # stays as bound at install.
+      def refresh_backend(extension, services, resolved)
+        backend = extension.backend
+        return unless backend
+
+        provider = backend.provider
+        return unless callable?(provider)
+
+        object = resolved.fetch(provider) { resolved[provider] = provider.call }
+        services.refresh(backend.path, object)
+      end
+
+      # Enforce the Extension-shape checks +#preload+ / +#bind+ do not: a
+      # mandatory String +source+ (the install/bind boundary) and a
+      # +backend+ that, when present, exposes +path+ and +provider+.
+      def validate!(extension)
+        source = extension.source
+        raise ArgumentError, "Extension #source must be a String, got #{source.class}" unless source.is_a?(String)
+
+        backend = extension.backend
+        return if backend.nil?
+        return if backend.respond_to?(:path) && backend.respond_to?(:provider)
+
+        raise ArgumentError, "Extension #backend must expose #path and #provider"
+      end
+
+      def assert_dependencies!
+        names = @entries.map(&:name)
+        @entries.each do |extension|
+          (extension.depends_on || []).each do |dependency|
+            next if names.include?(dependency)
+
+            raise ArgumentError,
+                  "Extension #{extension.name.inspect} depends on #{dependency.inspect}, which is not installed"
+          end
+        end
+      end
+
+      def callable?(provider) = provider.respond_to?(:call)
+
+      # A callable provider reserves its path with a placeholder that the
+      # per-invocation refresh replaces before any dispatch; a fixed
+      # provider is the bound object itself.
+      def initial_object(provider) = callable?(provider) ? nil : provider
+    end
+  end
+end

data/lib/kobako/catalog/services.rb

@@ -65,6 +65,18 @@ module Kobako
         @bindings[target_str]
       end
 
+      # Replace the object bound at an already-registered +path+ without the
+      # collision or seal checks +#bind+ applies. +Catalog::Extensions+ calls
+      # this during +begin_invocation!+ to swap a callable backend provider's
+      # per-invocation result behind a path whose Frame 1 membership was
+      # fixed at the seal. A path that was never registered is left untouched,
+      # so the sealed key set can never grow here.
+      def refresh(path, object)
+        key = path.to_s
+        @bindings[key] = object if @bindings.key?(key)
+        self
+      end
+
       # Encode the preamble as msgpack bytes for stdin Frame 1 delivery —
       # a flat array of the bound constant paths, in bind order:
       # +["MyService::KV", "File"]+. Routes through Kobako::Codec::Encoder

data/lib/kobako/catalog.rb

@@ -3,13 +3,15 @@
 require_relative "catalog/handles"
 require_relative "catalog/services"
 require_relative "catalog/snippets"
+require_relative "catalog/extensions"
 
 module Kobako
   # Kobako::Catalog — Sandbox-level configuration and per-invocation
-  # allocation tables. Houses the three host-side registries the Sandbox
-  # owns: +Catalog::Services+ (path→Service binding registry),
-  # +Catalog::Snippets+ (preloaded source / bytecode entries), and
-  # +Catalog::Handles+ (per-invocation Handle ID allocator).
+  # allocation tables. Houses the host-side registries the Sandbox owns:
+  # +Catalog::Services+ (path→Service binding registry),
+  # +Catalog::Snippets+ (preloaded source / bytecode entries),
+  # +Catalog::Extensions+ (installed Extensions, composed onto Services /
+  # Snippets), and +Catalog::Handles+ (per-invocation Handle ID allocator).
   #
   # See {SPEC.md Refinement → Internal Concepts}[link:../../SPEC.md] for
   # how Catalog fits alongside Transport and Runtime.

data/lib/kobako/extension.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Kobako
+  # Kobako::Extension — a guest idiom paired with an optional host backend,
+  # installed on a Sandbox via +Sandbox#install+. It composes the existing
+  # +#preload+ (the guest +source+) and +#bind+ (the +backend+) verbs into
+  # one setup unit, so guest code sees a native-style constant whose pure
+  # methods run in-guest and whose privileged methods dispatch to the
+  # backend.
+  #
+  # The four readers form the contract +#install+ duck-types on:
+  #
+  #   * +name+ — a Symbol matching +/\A[A-Z]\w*\z/+, the preloaded snippet's
+  #     canonical backtrace name and the +depends_on+ match key. Independent
+  #     of any bound path.
+  #   * +source+ — the mruby idiom as a String; always present, since an
+  #     Extension always carries a guest idiom. A host object with no idiom
+  #     is bound with +#bind+ directly.
+  #   * +backend+ — an +Extension::Backend+ or +nil+ for a pure-guest
+  #     Extension.
+  #   * +depends_on+ — Symbol names of Extensions that must also be
+  #     installed, checked for presence at the first invocation.
+  #
+  # +Kobako::Extension+ is the bundled value type; any object exposing the
+  # four readers is equally valid, so a Host App or gem may supply its own.
+  class Extension < Data.define(:name, :source, :backend, :depends_on)
+    # Kobako::Extension::Backend — the host attachment of an Extension,
+    # pairing +path+ (the constant path the backend binds at, single-segment
+    # +"File"+ or nested +"MyApp::Store"+, spelling the guest constant the
+    # idiom routes to) with +provider+ (the source of the bound object).
+    #
+    # A +provider+ that is not itself callable is the bound object, resolved
+    # once for the Sandbox's life; a callable provider is invoked once per
+    # invocation to yield that invocation's object, so a fresh object backs
+    # the path every invocation. Callability is the sole discriminator — a
+    # fixed backend that is itself callable is supplied through a
+    # non-callable wrapper.
+    class Backend < Data.define(:path, :provider)
+    end
+
+    # +backend+ and +depends_on+ default to absent so the common
+    # pure-idiom and single-backend shapes stay terse.
+    def initialize(name:, source:, backend: nil, depends_on: [])
+      super
+    end
+  end
+end

data/lib/kobako/sandbox.rb

@@ -48,29 +48,21 @@ module Kobako
     # so use +#stdout_truncated?+ to observe overflow. Populated on every
     # outcome — including a rescued +TrapError+, after which it holds the
     # bytes written before the trap fired — mirroring +#usage+.
-    def stdout
-      @stdout_capture.bytes
-    end
+    def stdout = @stdout_capture.bytes
 
     # Returns the bytes the guest wrote to stderr during the most recent
     # invocation as a UTF-8 String, clipped at +stderr_limit+. Empty before
     # any invocation. Mirror of +#stdout+.
-    def stderr
-      @stderr_capture.bytes
-    end
+    def stderr = @stderr_capture.bytes
 
     # Returns +true+ iff stdout capture during the most recent invocation
     # exceeded +stdout_limit+. Resets to +false+ at the start of the next
     # invocation.
-    def stdout_truncated?
-      @stdout_capture.truncated?
-    end
+    def stdout_truncated? = @stdout_capture.truncated?
 
     # Returns +true+ iff stderr capture during the most recent invocation
     # exceeded +stderr_limit+. Mirror of +#stdout_truncated?+.
-    def stderr_truncated?
-      @stderr_capture.truncated?
-    end
+    def stderr_truncated? = @stderr_capture.truncated?
 
     # Returns the +Kobako::Usage+ value object for the most recent
     # invocation. Carries +wall_time+ (Float seconds the guest export call spent
@@ -102,6 +94,7 @@ module Kobako
       @handler = Catalog::Handles.new
       @services = Kobako::Catalog::Services.new(handler: @handler)
       @snippets = Catalog::Snippets.new
+      @extensions = Catalog::Extensions.new
       @runtime = build_runtime!
       install_dispatch_proc!
       reset_invocation_state!
@@ -121,6 +114,22 @@ module Kobako
       self
     end
 
+    # Install one or more Extensions — each a guest idiom (+source+) paired
+    # with an optional host +backend+, composed onto the Sandbox through
+    # +#preload+ and +#bind+. An Extension is any object exposing
+    # +name+ / +source+ / +backend+ / +depends_on+; +Kobako::Extension+ is
+    # the bundled value type. Returns +self+.
+    #
+    # Raises +ArgumentError+ for a malformed Extension, a call after the
+    # first invocation seals registration, or — at that first invocation —
+    # an unmet +depends_on+.
+    def install(*extensions)
+      raise ArgumentError, "cannot install after first Sandbox invocation" if @services.sealed?
+
+      extensions.each { |extension| @extensions.install(extension, snippets: @snippets, services: @services) }
+      self
+    end
+
     # Register a snippet on this Sandbox in one of two forms:
     #
     #   * +preload(code: source, name: Name)+ — +source+ is mruby source
@@ -241,14 +250,18 @@ module Kobako
       end
     end
 
-    # Per-invocation prologue. Seals the Service / snippet registries on
-    # first call (idempotent) and zeros the per-invocation capability
+    # Per-invocation prologue. Seals the Service / snippet / Extension
+    # registries on first call (idempotent — asserting Extension
+    # dependencies then), refreshes each callable Extension backend to this
+    # invocation's fresh object, and zeros the per-invocation capability
     # state — capture buffers, truncation predicates, and the
     # +Catalog::Handles+ counter — before the guest runs. The
     # +Catalog::Handles+ itself is held as +@handler+ and never exposed
     # beyond this class — it is not part of the Host App's surface.
     def begin_invocation!
       @services.seal!
+      @extensions.seal!
+      @extensions.refresh_backends!(@services)
       @handler.reset!
       reset_invocation_state!
     end

data/lib/kobako/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kobako
-  VERSION = "0.15.0"
+  VERSION = "0.16.0"
 end

data/lib/kobako.rb

@@ -10,6 +10,7 @@ rescue LoadError
 end
 
 require_relative "kobako/errors"
+require_relative "kobako/extension"
 require_relative "kobako/transport"
 require_relative "kobako/catalog"
 require_relative "kobako/runtime"

data/sig/kobako/catalog/extensions.rbs

@@ -0,0 +1,25 @@
+module Kobako
+  module Catalog
+    class Extensions
+      def initialize: () -> void
+
+      def install: (untyped extension, snippets: Kobako::Catalog::Snippets, services: Kobako::Catalog::Services) -> self
+
+      def seal!: () -> self
+
+      def refresh_backends!: (Kobako::Catalog::Services services) -> self
+
+      private
+
+      def refresh_backend: (untyped extension, Kobako::Catalog::Services services, Hash[untyped, untyped] resolved) -> void
+
+      def validate!: (untyped extension) -> void
+
+      def assert_dependencies!: () -> void
+
+      def callable?: (untyped provider) -> bool
+
+      def initial_object: (untyped provider) -> untyped
+    end
+  end
+end

data/sig/kobako/catalog/services.rbs

@@ -9,6 +9,8 @@ module Kobako
 
       def lookup: (Symbol | String target) -> untyped
 
+      def refresh: (Symbol | String path, untyped object) -> self
+
       def encode: () -> String
 
       def seal!: () -> self

data/sig/kobako/extension.rbs

@@ -0,0 +1,20 @@
+module Kobako
+  class Extension < Data
+    attr_reader name: Symbol
+    attr_reader source: String
+    attr_reader backend: Kobako::Extension::Backend?
+    attr_reader depends_on: Array[Symbol]
+
+    def self.new: (name: Symbol, source: String, ?backend: Kobako::Extension::Backend?, ?depends_on: Array[Symbol]) -> Kobako::Extension
+
+    def initialize: (name: Symbol, source: String, ?backend: Kobako::Extension::Backend?, ?depends_on: Array[Symbol]) -> void
+
+    class Backend < Data
+      attr_reader path: String
+      attr_reader provider: untyped
+
+      def self.new: (path: String, provider: untyped) -> Kobako::Extension::Backend
+                  | (String path, untyped provider) -> Kobako::Extension::Backend
+    end
+  end
+end

data/sig/kobako/sandbox.rbs

@@ -31,6 +31,8 @@ module Kobako
 
     def bind: (Symbol | String path, untyped object) -> Kobako::Sandbox
 
+    def install: (*untyped extensions) -> Kobako::Sandbox
+
     def preload: (code: String, name: Symbol | String) -> Kobako::Sandbox
                | (binary: String) -> Kobako::Sandbox
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kobako
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: aarch64-linux
 authors:
 - Aotokitsuruya
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-07-11 00:00:00.000000000 Z
+date: 2026-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: msgpack
@@ -50,6 +50,7 @@ files:
 - lib/kobako/4.0/kobako.so
 - lib/kobako/capture.rb
 - lib/kobako/catalog.rb
+- lib/kobako/catalog/extensions.rb
 - lib/kobako/catalog/handles.rb
 - lib/kobako/catalog/services.rb
 - lib/kobako/catalog/snippets.rb
@@ -62,6 +63,7 @@ files:
 - lib/kobako/codec/state.rb
 - lib/kobako/codec/utils.rb
 - lib/kobako/errors.rb
+- lib/kobako/extension.rb
 - lib/kobako/fault.rb
 - lib/kobako/handle.rb
 - lib/kobako/outcome.rb
@@ -88,6 +90,7 @@ files:
 - sig/kobako.rbs
 - sig/kobako/capture.rbs
 - sig/kobako/catalog.rbs
+- sig/kobako/catalog/extensions.rbs
 - sig/kobako/catalog/handles.rbs
 - sig/kobako/catalog/services.rbs
 - sig/kobako/catalog/snippets.rbs
@@ -100,6 +103,7 @@ files:
 - sig/kobako/codec/state.rbs
 - sig/kobako/codec/utils.rbs
 - sig/kobako/errors.rbs
+- sig/kobako/extension.rbs
 - sig/kobako/fault.rbs
 - sig/kobako/handle.rbs
 - sig/kobako/outcome.rbs