Skip to content

feat(agentos): standalone @rivet-dev/agentos umbrella package#5310

Open
NathanFlurry wants to merge 2 commits into
feat/agent-os-integrationfrom
feat/agentos-package
Open

feat(agentos): standalone @rivet-dev/agentos umbrella package#5310
NathanFlurry wants to merge 2 commits into
feat/agent-os-integrationfrom
feat/agentos-package

Conversation

@NathanFlurry

@NathanFlurry NathanFlurry commented Jun 21, 2026

Copy link
Copy Markdown
Member

Extracts the rivetkit ./agent-os integration into a standalone, separately published package @rivet-dev/agentos, modeled on RivetKit's export structure. Re-export only — no fork. Still calls into core Rust via the published @rivet-dev/agent-os-* deps, unchanged.

Export boundaries (strict)

Subpath Surface
@rivet-dev/agentos (root) server only: agentOs(), config schema, domain/event types, nodeModulesMount (== what rivetkit/agent-os exports today)
@rivet-dev/agentos/client re-exports rivetkit/client (createClient, handles, conns); browser export condition preserved
@rivet-dev/agentos/react re-exports @rivetkit/react (createRivetKit, hooks)

The root is kept clean of client exports (does not copy RivetKit's own src/mod.ts createClientWithDriver leak), so server/Node code importing the root never pulls the browser/react bundle.

Verification

  • build ✅ (tsup: mod/client/react × esm+cjs+dts)
  • check-types
  • all exports targets exist ✅
  • /client exposes createClient, /react exposes createRivetKit, root exports only agentOs/AgentOsEvents/nodeModulesMount (no client leak) ✅

Decisions

  • Version lockstep with rivetkit/@rivetkit/react at 2.3.0-rc.12; re-export, don't fork.
  • Typing: agent-os actor actions (client.vm.*) and AgentOsEvents are dispatched by the Rust factory and are any-typed at the TS surface today. This package ships them as-is (option a), consistent with "re-export, don't fork". A typed facade over the actions (sendPrompt, createSession, …) and event map is a possible follow-up if typed DX is wanted.

Base branch is feat/agent-os-integration (the integration this builds on is not yet on main). Do not merge until reviewed.

…nt-os 0.0.0-main.8794200

Full e2e (examples/agent-os-e2e) green: filesystem, processes, preview URL, and
live Pi agent session.

- rivetkit-agent-os actor + napi binding driving the agent-os sidecar via
  agent-os-client; examples + wrapper pinned to published agent-os
  0.0.0-main.8794200 and @agent-os-pkgs/@secure-exec software packages (common
  uses the wasm-bundled @rivet-dev/agent-os-common).
- preview proxy: route signed-preview URLs through rivetkit's raw-actor-HTTP
  '/request' path so the gateway dispatches to the actor's proxy_preview
  (was 404 NotFound); accept the (port, ttlSeconds) arg pair.
- Pi session: give the agent a clean dependency closure via
  AGENT_OS_MODULE_ACCESS_CWD (.agent-modules, generated by
  scripts/prepare-agent-modules.mjs) so minimatch's brace-expansion@>=2 named
  export resolves (the monorepo hoists brace-expansion@1).
- surface previously-swallowed errors (ensure_vm / create_session / write_file
  / preview token) at error level for diagnosability.
Extracts the rivetkit ./agent-os integration into a standalone, separately
published package named @rivet-dev/agentos, modeled on RivetKit's export
structure. Re-exports only (no fork); still calls into core Rust via the
published @rivet-dev/agent-os-* deps (unchanged).

Export boundaries:
- '.'        server only: agentOs(), config schema, domain/event types,
             nodeModulesMount (== what rivetkit/agent-os exports today).
             No client/browser/react on the root.
- './client' re-exports rivetkit/client (createClient, handles, conns);
             browser export condition preserved.
- './react'  re-exports @rivetkit/react (createRivetKit, hooks).

Version kept in lockstep with rivetkit/@rivetkit/react (2.3.0-rc.12).

Typing: client.vm.* actions and AgentOsEvents are dispatched by the Rust
factory and are 'any'-typed at the TS surface today; this package re-exports
as-is (per 're-export, don't fork'). A typed facade is a possible follow-up.
@NathanFlurry NathanFlurry force-pushed the feat/agentos-package branch from 0c2b631 to 47a0b2c Compare June 21, 2026 01:10
@NathanFlurry NathanFlurry changed the title feat(agentos): extract standalone @rivet-dev/agentos package feat(agentos): standalone @rivet-dev/agentos umbrella package Jun 21, 2026
@NathanFlurry NathanFlurry force-pushed the feat/agent-os-integration branch from c62506a to c44621f Compare June 22, 2026 11:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant