Skip to content

kumoba v0.2.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 06:35
· 14 commits to main since this release

Added

  • kumoba CLI, built for people and for agents. It has no commands of its own: it reads the daemon's catalog and builds every command, argument check and help page from it. Ships natively with the daemon (install.sh, release tarballs, cargo install kumobad) and through npm (npx kumoba). exec and run exit with the guest command's status.
  • GET /v1/commands: every route with a JSON Schema for its input, so clients and agents can discover the API.
  • POST /v1/run and Kumoba.run(): one command in a fresh sandbox that is deleted when it ends.
  • POST /v1/sandboxes/{id}/desktop: starts the desktop and returns a link to a live noVNC view.
  • Browser previews on a separate loopback listener (KUMOBAD_PREVIEW_LISTEN, default 127.0.0.1:7789), so exposed web apps and the desktop render in a browser while staying off the API's origin. Preview and desktop responses carry a full url.

Changed

  • With no configuration kumobad also listens on 127.0.0.1:7788, and on 127.0.0.1:7789 for previews; either is skipped if its port is taken.
  • A bare program name in exec or run (python3) is looked up on the guest's PATH instead of being rejected.
  • The SDK reports an unreachable daemon with the error code unreachable.
  • Dependencies: sha2 0.11 with hmac 0.13, base64 0.23, libloading 0.9, TypeScript 7, vitest 5, and newer GitHub Actions.

Fixed

  • Previews no longer wait on a guest server that keeps its connection open: responses are read to their declared length, and plain requests reach the guest as one-shot HTTP/1.0. Page loads through a preview dropped from about 5 s per file to milliseconds.
  • Redirects from a preview stay inside that preview: the guest's location is resolved with a URL parser and anything leaving the guest origin is dropped.
  • The desktop's accessibility tree retries while the AT-SPI bus is still starting, instead of failing right after desktop.start().

Install

curl -fsSL https://raw.githubusercontent.com/Parassharmaa/kumoba/main/scripts/install.sh | KUMOBA_VERSION=0.2.0 bash
npm install kumoba@0.2.0

The installer puts the kumobad daemon, the kumoba CLI, kumoba-worker and the default image into ~/.kumoba; npx kumoba gives the same CLI through npm; on macOS install libkrun first with brew tap slp/krun && brew install slp/krun/libkrun slp/krun/libkrunfw zstd. cargo install kumobad@0.2.0 builds the daemon and worker from crates.io instead, and the Rust library is cargo add kumoba@0.2.0.

The files below are the host tarballs (Linux ones bundle the patched libkrun and libkrunfw; the macOS worker is signed for Hypervisor.framework), the default and test guest images for each architecture, and SHA256SUMS. Guest images from an earlier release must be replaced when the protocol version changes.

Full Changelog: v0.1.0...v0.2.0