Repository navigation
OpenAgentID SDK 0.3.0
OpenAgentID SDK 0.3.0 adds live avatar state: a harness or client can send avatar.update({ status: 'reasoning' }) and the eyes smoothly transition to thoughtful while blinking and looking around. Rapid updates preserve the current eye position and velocity. Autos remains the default skin; SpaceX uses the same expressions and timeline.
- 18 expressions, including thoughtful and concerned, plus eight activity aliases. Reasoning maps to thoughtful; blocked/error maps to concerned.
- A mounted inline SVG player, a DOM-free sampled animator, and a bundled browser ESM entry. The player keeps its SVG nodes across state/skin changes, respects reduced motion, pauses while hidden, and cleans up on disposal.
- Public snapshot API support for status and expression state, a status catalog, updated OpenAPI and a live interactive demo.
import { mountCharacter } from '@openagentid/sdk/character-player';
const avatar = mountCharacter(element, agent.did);
avatar.update({ status: 'reasoning' });
avatar.update({ status: 'happy' });
avatar.setAppearance({ skin: 'spacex' });
// When the component is removed:
avatar.dispose();Use the client's existing authorized state channel to deliver updates. This API changes presentation; it does not persist agent status or grant identity authority. An explicit expression overrides status until cleared with expression: null or replaced by a new status update. Stateless HTTP requests require a concrete expression when one is supplied.
Consumers with exhaustive expression switches must handle the two new values. Import the DOM player from @openagentid/sdk/character-player; the root export and character-animation remain usable with Node-only TypeScript libraries. @openagentid/oidc remains at 0.2.0.
Avatar and state API documentation · Interactive demo · PR #5
Packages in this release
| Package | Version | |
|---|---|---|
@openagentid/sdk |
0.3.0 | published 2026-10-12 00:06 UTC |
@openagentid/sdk-testing |
0.1.1 | unchanged |
@openagentid/http |
0.1.1 | unchanged |
@openagentid/mcp |
0.1.1 | unchanged |
@openagentid/claude-agent |
0.1.1 | unchanged |
@openagentid/scim |
0.1.1 | unchanged |
@openagentid/oidc |
0.2.0 | unchanged |
@openagentid/crypto-wasm |
0.1.1 | unchanged |
create-openagent |
0.1.1 | unchanged |
Source and verification
This tag points at f780b94, the merge of #5 on main. npm recorded no gitHead for these versions. Every source embedded in the SDK tarball's sourcemaps, and each package's manifest, README, CHANGELOG and licenses, match this commit byte for byte. These versions were published by hand before the release workflow existed, so they carry no provenance attestation. The attached tarballs are the files npm serves (their sha512 equals npm's integrity):
gh release download v0.3.0 --repo OpenAgentID/openagent-sdk
shasum -a 256 -c SHA256SUMS