Skip to content

docs(blog): add agentOS execution API for JavaScript and Python post - #5495

Merged
NathanFlurry merged 1 commit into
mainfrom
agent/agentos-execution-api-launch
Jul 28, 2026
Merged

docs(blog): add agentOS execution API for JavaScript and Python post#5495
NathanFlurry merged 1 commit into
mainfrom
agent/agentos-execution-api-launch

Conversation

@NathanFlurry

Copy link
Copy Markdown
Member
  • Adds the agentOS execution API launch post for JavaScript and Python
  • Covers evaluate, execute, inputs, retained contexts, type checking, npm and pip installs, background processes and web servers, and the Linux-compatible environment
  • Uses Jacques Linard's "Still Life with Shells and Coral" (public domain) as the hero, uploaded to R2
  • Validated with a full website build; post renders at /changelog/2026-07-28-introducing-agentos-execution-api-for-javascript-and-python/

@railway-app
railway-app Bot temporarily deployed to rivet-frontend / rivet-pr-5495 July 28, 2026 08:47 Destroyed
@claude

claude Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Review

This PR adds a single blog/changelog post (page.mdx) announcing the agentOS execution API for JavaScript and Python. No application code changes, so the review focuses on content accuracy and consistency of the code samples.

Frontmatter / conventions - all good:

  • author, category, published, image: { file: "image.png?v=2" } all match the schema in website/src/content.config.ts and the .claude/reference/content-frontmatter.md conventions.
  • agentOS spelling and rivet.dev / agentos-sdk.dev domains are used consistently per the root CLAUDE.md terminology rules.
  • @nocheck usage is appropriate since @rivet-dev/agentos's execution API doesn't exist in this repo yet (matches the documented exception in website/CLAUDE.md).

Issues found in the code samples:

  1. Networking example won't work as written - in "A full Linux-compatible environment underneath" (both the JavaScript and Python tabs), the snippet fetches http://localhost:8000/ but this block creates a brand new AgentOs.create(...) and never spawns anything listening on port 8000 within it (unlike the earlier "Background processes and web servers" section, which explicitly spawns a server before hitting it). A reader copy-pasting this exact block will get a connection failure instead of the commented // 200. Either spawn a quick listener in this snippet too, or note that it continues from the previous section's server.

  2. Minor API-surface inconsistency in "Keep state between calls": context creation is a top-level shorthand (await runtime.createContext("analysis")), but cleanup is namespaced (await runtime.contexts.delete("analysis")). If that split is intentional (common op gets a shorthand, less-common ops live under .contexts), might be worth a one-line justification since it reads as an inconsistent surface otherwise.

  3. Minor naming asymmetry in "Install packages programmatically": npm install is namespaced (runtime.javascript.npm.install(...)), while pip install is not (runtime.python.install(...) rather than something like runtime.python.pip.install(...)). Likely intentional since Python doesn't have competing package managers the way JS does, but worth double-checking against the real SDK surface before this ships.

Not verified: I couldn't reach the network from this sandbox to confirm the R2-hosted hero image (https://assets.rivet.dev/website/blog/2026-07-28-introducing-agentos-execution-api-for-javascript-and-python/image.png?v=2) actually resolves - worth a quick manual check before merge if that wasn't already done as part of the "full website build" validation mentioned in the PR description.

Overall this is a well-structured, on-convention changelog post; the flagged items are all sample-code polish rather than blockers.

@NathanFlurry
NathanFlurry marked this pull request as ready for review July 28, 2026 09:06
@NathanFlurry
NathanFlurry merged commit 345575c into main Jul 28, 2026
16 of 17 checks passed
@NathanFlurry
NathanFlurry deleted the agent/agentos-execution-api-launch branch July 28, 2026 09:06
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