Changelog

Changelog

Latest releases and updates for DeviceSDK

May 2026

  • @devicesdk/mcp (new) — Model Context Protocol stdio server that exposes 7 DeviceSDK tools to AI coding agents (Claude Desktop, Claude Code, Cursor, Continue.dev, Windsurf). See /docs/mcp/ for install snippets per host.
  • AI-agent friendliness pass:
    • devicesdk init now scaffolds AGENTS.md, CLAUDE.md, .cursor/rules/devicesdk.mdc, .mcp.json, and a project README.md.
    • @devicesdk/core ships AGENTS.md and the full docs/ folder inside the npm tarball; JSDoc with runnable @example blocks added to every method on DeviceSenderInterface.
    • Public docs site now publishes /llms.txt, /llms-full.txt, and per-page Markdown mirrors at <page-url>/index.md.
    • CLI commands gained a --json flag (whoami, status, logs, env list, env set, env unset, deploy); logs --tail --json emits NDJSON. DEVICESDK_OUTPUT=json works as a global toggle.
    • Auth errors now carry stable code and docs fields. See the new error reference.
    • Branded ID types (ProjectId, DeviceId, …), an OnboardLED constant, and literal-union pin types (PicoGpioPin, Esp32C3GpioPin, …) added to @devicesdk/core for type-safer device code.
    • DeviceSender now validates pin/range/I2C/SPI/UART/WS2812 arguments synchronously — bad calls throw a typed error (code: "invalid_argument") with a docs URL instead of silently round-tripping.
    • New cookbook at /docs/recipes/ with 10 task-shaped recipes.
    • URL change: /docs/resources/changelog/ is now /docs/changelog/ (the old URL 301s).

April 11, 2026

  • Home Assistant integration — expose DeviceSDK devices as native Home Assistant entities (sensors, switches, lights). Declare entities in devicesdk.ts under ha.entities; run devicesdk deploy to publish them. See the Home Assistant guide.
  • Generic watch WebSocket — new GET /v1/projects/:projectId/devices/:deviceId/watch endpoint delivers real-time status, log, and structured state events over a persistent WebSocket connection. The dashboard now uses this endpoint in place of the legacy SSE log stream. See the Real-Time Watch guide.
  • emitState SDK method — publish structured state values from device scripts with this.env.DEVICE.emitState(entity_id, value). Feeds custom telemetry into Home Assistant entities. See the Emit State concept.
  • SSE log stream endpoint (GET /logs/stream) is deprecated in favor of the watch WebSocket.

December 27, 2025

  • Private Beta milestone: expanded access and onboarding for early teams
  • Pico W and Pico 2W are the officially supported hardware targets
  • ESP32 support tracked as next hardware platform