Goal

Stabilize the current @openclaw/sdk happy path for real external app clients.

OpenMeow is a useful dogfood client because it exercises the core app-SDK flow without requiring future managed/cloud features.

Happy path to validate

1. Connect to Gateway.
2. Discover agents/models.
3. Create or resume a session.
4. Send a run.
5. Stream normalized events.
6. Wait for a result.
7. Cancel/stop an active run.
8. Surface approvals.

Acceptance criteria

• SDK APIs for agents/sessions/runs are documented as supported today.
• Run.wait() semantics clearly distinguish wait deadline from runtime timeout.
• Run.cancel() has reliable identifiers and result semantics for UI clients.
• Normalized run events are stable enough for app UI state.
• Unsupported future fields continue to throw explicit unsupported errors.

Dogfood packet

• Review brief: https://github.com/OpenCoven/open-meow-sdk/blob/main/docs/peter-review-brief.md
• OpenMeow adapter shape: https://github.com/OpenCoven/open-meow-sdk/blob/main/docs/openmeow-sdk-adapter-shape.md
• OpenMeow tracking issue: P0: Dogfood @openclaw/sdk from OpenMeow OpenCoven/open-meow-sdk#1