Summary

Bootstrap SDK and sandbox packages for bs-tim-6 (OpenClaw SDK + Local Dev Sandbox).

Changes

@openclaw/sdk:

• Typed client library with ToolClient, SessionClient, ResourceClient
• Error types: ValidationError, TransportError, AuthError, ToolRuntimeError, SandboxUnavailableError
• Result envelope helpers (ok(), err())
• Health check and request/response handling

@openclaw/sandbox:

• Local sandbox runtime with lifecycle state machine
• States: idle → starting → ready → busy → (ready | terminating)
• Error state: failed → (ready | terminal)
• Event streaming for state changes, execution events
• Lifecycle callbacks (onReady, onStateChange, onExecutionStart, etc.)

Tests

• 28 tests for sandbox state machine and basic lifecycle
• 12 tests for SDK client initialization and error handling

Package Structure

packages/
  sdk/
    src/
      index.ts, client.ts, types.ts
    test/
  sandbox/
    src/
      index.ts, runtime.ts, state-machine.ts, types.ts
    test/

Notes

• Phase 1 scaffolding - runtime spawns mock process for now
• Phase 2 will implement actual sandbox process bootstrap
• Coordinated with Sandy on package boundaries per spec
• cli package deferred to later phase

Refs: bs-tim-6