Add AgentOS daemon control plane and maintenance tooling

.agents/skills/rivetkit/reference/actors/testing.md

@@ -0,0 +1,51 @@
+# Testing
+
+> Source: `src/content/docs/actors/testing.mdx`
+> Canonical URL: https://rivet.dev/docs/actors/testing
+> Description: Rivet provides a straightforward testing framework to build reliable and maintainable applications. This guide covers how to write effective tests for your actor-based services.
+
+---
+## Setup
+
+To set up testing with Rivet:
+
+```bash
+# Install Vitest
+npm install -D vitest
+
+# Run tests
+npm test
+```
+
+## Basic Testing Setup
+
+Rivet includes a test helper called `setupTest` that starts your registry in test mode and returns a client connected to it. This allows for fast, isolated tests without external dependencies.
+
+## Testing Actor State
+
+State persists within each test, allowing you to verify that your actor correctly maintains state between operations.
+
+## Testing Events
+
+For actors that emit events, you can verify events are correctly triggered by subscribing to them:
+
+## Testing Schedules
+
+Rivet's schedule functionality can be tested by scheduling work and waiting for it to run:
+
+Use a short real-time delay to wait for scheduled work to run. `setupTest` does not install fake timers, so if you want to use `vi.useFakeTimers()` you must enable it yourself and confirm it works with your selected runtime.
+
+## Best Practices
+
+1. **Isolate tests**: Each test should run independently, avoiding shared state.
+2. **Test edge cases**: Verify how your actor handles invalid inputs, concurrent operations, and error conditions.
+3. **Test scheduled operations**: Use short real-time delays to wait for scheduled work to run.
+4. **Use realistic data**: Test with data that resembles production scenarios.
+
+`setupTest` starts the registry and disposes the returned client when the test finishes, so you can focus on writing effective tests for your business logic.
+
+## API Reference
+
+- [`setupTest`](/typedoc/functions/rivetkit.test_mod.setupTest.html) - Test setup helper function
+
+_Source doc path: /docs/actors/testing_