docs: add Stripe World to the environment catalog

docs/source/_toctree.yml

@@ -163,6 +163,8 @@
     title: Sophistry Bench Sprint
   - local: environments/ortools
     title: OR-Tools
+  - local: environments/stripe_world
+    title: Stripe World
   title: Environments
 - isExpanded: false
   sections:

docs/source/environments.md

@@ -353,6 +353,14 @@ The OpenEnv community has built a catalog of ready-to-run environments that cove
         <a href="https://huggingface.co/spaces/reasoning-core/reasoning-core-openenv" class="!no-underline border dark:border-gray-700 px-3 py-1 rounded text-sm hover:shadow">🤗 HF</a>
       </div>
     </div>
+    <div class="border dark:border-gray-700 p-5 rounded-lg shadow">
+      <div class="font-bold mb-2">Stripe World</div>
+      <p class="text-sm">Stateful copy of Stripe's Billing and Payments API with Stripe's MCP tools, a private account per episode, and a row-level change log in the state for grading.</p>
+      <div class="flex gap-2 mt-3">
+        <a href="environments/stripe_world" class="!no-underline border dark:border-gray-700 px-3 py-1 rounded text-sm hover:shadow">📄 Docs</a>
+        <a href="https://huggingface.co/spaces/scosman/stripe_world" class="!no-underline border dark:border-gray-700 px-3 py-1 rounded text-sm hover:shadow">🤗 HF</a>
+      </div>
+    </div>
     <div class="border dark:border-gray-700 p-5 rounded-lg shadow">
       <div class="font-bold mb-2">FineEnvs</div>
       <p class="text-sm">End-to-end environment projects (LaTeX OCR, watercolour painting, GeoGuessr, multilingual, simulation) with their datasets, models and training runs.</p>

docs/source/environments/stripe_world.md

@@ -0,0 +1,110 @@
+# Stripe World
+
+Stripe World is a stateful copy of Stripe's Billing and Payments API that runs as an OpenEnv
+environment. Agents act through the same tools as Stripe's MCP server. Every connection gets its
+own private Stripe account, which can start from a saved state, and every database row the episode
+changed is returned by `state()` for grading.
+
+The environment is maintained outside this repository:
+
+- Hugging Face Space: [scosman/stripe_world](https://huggingface.co/spaces/scosman/stripe_world)
+- Source: [Kiln-AI/stripe_world](https://github.com/Kiln-AI/stripe_world)
+
+It is built with [Seahaven](https://github.com/Kiln-AI/Seahaven). Stripe World is not affiliated
+with Stripe.
+
+## What it models
+
+- **API surface:** 155 Stripe API operations across 25 tables, pinned to Stripe API version
+  `2026-08-26.dahlia`. Object shapes follow Stripe's OpenAPI spec.
+- **Resources:** customers, payment methods, products, prices, coupons, promotion codes, tax rates,
+  payment intents, charges, refunds, disputes, setup intents, balance and balance transactions,
+  payouts, subscriptions, subscription items and schedules, invoices, invoice items, credit notes,
+  customer balance transactions and events.
+- **Billing behaviour:** subscription status transitions, trials and cancellation; invoices that
+  move from draft to open to paid, void or uncollectible; proration; dunning; credit notes; and a
+  balance ledger. Stripe's test cards and tokens (`tok_visa`,
+  `tok_visa_chargeDeclinedInsufficientFunds`, ...) succeed, decline and dispute as they do in
+  Stripe's test mode.
+- **Agent tools:** 8 of the 10 tools on Stripe's MCP server: `list_available_accounts_or_orgs`,
+  `get_stripe_account_info`, `manage_stripe_accounts`, `stripe_analytics`, `stripe_api_read`,
+  `stripe_api_write`, `stripe_api_search` and `stripe_api_details`.
+
+Webhook delivery and the parts of Stripe outside Billing and Payments are not modelled.
+
+## Episodes and grading
+
+- `reset()` creates a fresh account. Pass `fixture` to start from a saved state (see
+  [Fixtures](#fixtures)) and `seed` to make ids and timestamps reproducible. Without a fixture the
+  account is empty and in live mode; pass `startup={"livemode": False}` for a test-mode account.
+- `step()` takes `list_tools` and `call_tool` actions.
+- The environment does not compute a reward. `state()` returns the change log of the episode
+  under `["state"]["db"]["log"]`: one entry per changed row, with its table, operation, and the
+  row before and after. Grade the episode from those rows.
+
+## Fixtures
+
+Stripe World ships three fixtures, all frozen at `2026-09-01T14:00:00Z`:
+
+- **`empty`:** an account with no history, in live mode.
+- **`small_co`:** Wrenfield Labs, a two-person company selling booking and payment tools to
+  tutors, music teachers and coaches. A test-mode account with 45 hand-written customers, from a
+  private beta through a public launch, with renewals, a failed payment in dunning, refunds and a
+  dispute.
+- **`big_co`:** Ostrander Systems, a company selling field-service software to HVAC, plumbing and
+  electrical contractors. A test-mode account with about 380 simulated business customers over 18
+  months, with per-technician seat plans, annual contracts invoiced on terms, sales tax, dunning,
+  refunds, disputes and credit notes. Suited to tasks that need pagination, search and
+  aggregation.
+
+Select one with `env.reset(fixture="small_co", seed=7)`. A fixture opens in the mode it was saved
+in, so leave out `startup={"livemode": ...}`: asking for the other mode is refused.
+[docs/fixtures.md](https://github.com/Kiln-AI/stripe_world/blob/main/docs/fixtures.md) describes
+each company's catalog and its scripted loose ends, with queries that find them.
+
+## Quick start
+
+Connect to the Space with OpenEnv's generic client. Only the `openenv` package is needed on the
+client side:
+
+```python
+from openenv import AutoEnv
+
+with AutoEnv.from_hub("scosman/stripe_world", skip_install=True) as env:
+    env.reset(seed=7, startup={"livemode": False})
+    tools = env.step({"type": "list_tools"}).observation["tools"]
+    account = env.step(
+        {"type": "call_tool", "tool_name": "list_available_accounts_or_orgs", "arguments": {}}
+    ).observation["result"]["accounts"][0]
+    created = env.step(
+        {
+            "type": "call_tool",
+            "tool_name": "stripe_api_write",
+            "arguments": {
+                "stripe_api_operation_id": "PostCustomers",
+                "parameters": {"email": "jenny@example.com"},
+                "stripe_context": account["stripe_context"],
+                "livemode": account["livemode"],
+            },
+        }
+    ).observation
+    print(created["result"], env.state())
+```
+
+Pass `skip_install=True`. Without it, `from_hub` tries to install the Space's repository as a
+Python package, which fails for this environment. For a server you run yourself, add
+`base_url="http://localhost:8000"`.
+
+## Running the server locally
+
+```bash
+git clone https://github.com/Kiln-AI/stripe_world.git
+cd stripe_world
+uv sync
+uv run --extra serve seahaven serve
+```
+
+The server listens on port 8000. Open `http://127.0.0.1:8000/console` to drive an instance by
+hand. The [Stripe World README](https://github.com/Kiln-AI/stripe_world#readme) has
+an async example with the typed `SeahavenClient` that runs and grades 100 episodes in parallel,
+and shows how to save your own fixtures.