@openagentid/sdk/character-player

All packages · Runnable examples · Start an agent

Contract	Value
Package	@openagentid/sdk@0.7.2
Entry point	@openagentid/sdk/character-player
Availability	Current integration path
Reference source	Published TypeScript declarations
Package engines	node >=20

Before integrating

The published VERSION constant is still the literal "0.6.0" in the 0.7.2 archive. Use package metadata or your lockfile to identify the installed release; do not use VERSION as a release check.

When using @openagentid/crypto-wasm 0.1.1 for ACT verification, call the SDK verifier builder .atTime(Math.floor(Date.now() / 1000)) on every verification. The default WASM system-clock path traps in Node. Supply trusted receiver current epoch seconds; never token-supplied time or a timestamp captured once at startup. The complete ACT example covers this requirement.

In SDK 0.7.2, withAct and requireActExpress do not expose a verification-clock option. The raw crypto-wasm 0.1.1 binding alone therefore traps for these wrappers; use the tested fluent .atTime(...) example, or qualify a binding adapter that supplies fresh trusted receiver time on every verification.

This reference is generated from the integrity-verified npm archive for this exact version. Signatures describe the public contract; they are not standalone programs. Complete examples are checked separately.

Import conditions

Use the public entry point above. The package resolves it to these shipped files; do not import its internal files directly.

Condition	Published file
types	`./dist/character-player.d.ts`
import	`./dist/character-player.js`
require	`./dist/character-player.cjs`

CharacterAppearanceUpdate

Type-only declaration; it is not a runtime value.

Signature

interface CharacterAppearanceUpdate {
    readonly skin?: CharacterSkin;
    readonly shape?: CharacterShape | null;
    readonly size?: number;
    readonly finish?: CharacterFinish;
    readonly eyePlacement?: CharacterEyePlacement;
    readonly view?: CharacterView;
    readonly accessories?: readonly CharacterAccessory[];
}

Source: @openagentid/sdk@0.7.2, dist/character-player.d.ts:12.

CharacterMotionPreference

A mounted inline-SVG character; importing this module does not require a DOM.

Type-only declaration; it is not a runtime value.

Signature

type CharacterMotionPreference = boolean | 'system';

Source: @openagentid/sdk@0.7.2, dist/character-player.d.ts:6.

CharacterPlayer

Type-only declaration; it is not a runtime value.

Signature

interface CharacterPlayer {
    update(state: CharacterStateUpdate): CharacterRuntimeState;
    setAppearance(appearance: CharacterAppearanceUpdate): void;
    setReducedMotion(preference: CharacterMotionPreference): void;
    getState(): CharacterRuntimeState;
    dispose(): void;
}

Source: @openagentid/sdk@0.7.2, dist/character-player.d.ts:23.

CharacterPlayerOptions

Type-only declaration; it is not a runtime value.

Signature

interface CharacterPlayerOptions extends CharacterOptions {
    readonly transitionMs?: number;
    readonly reducedMotion?: CharacterMotionPreference;
}

Source: @openagentid/sdk@0.7.2, dist/character-player.d.ts:7.

mountCharacter

Hosts deliver authorized state updates; this renderer never writes an agent profile.

Signature

declare function mountCharacter(element: Element, did: string, options?: CharacterPlayerOptions): CharacterPlayer;

Source: @openagentid/sdk@0.7.2, dist/character-player.d.ts:31.

Supporting declarations

These package-owned declarations are referenced by the exports above. Their presence here does not make them importable from this entry point. Import only the names in Exports.

AgentActivity

Type-only declaration; it is not a runtime value.

Signature

type AgentActivity = 'idle' | 'listening' | 'reasoning' | 'working' | 'speaking' | 'success' | 'blocked' | 'error';

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:4.

AvatarExpression

Type-only declaration; it is not a runtime value.

Signature

type AvatarExpression = typeof CHARACTER_EXPRESSIONS[number];

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:3.

AvatarStatus

Type-only declaration; it is not a runtime value.

Signature

type AvatarStatus = AvatarExpression | AgentActivity;

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:5.

CHARACTER_EXPRESSIONS

Portable presentation state. Status never grants identity or application authority.

Signature

declare const CHARACTER_EXPRESSIONS: readonly [
    "neutral",
    "attentive",
    "surprised",
    "excited",
    "happy",
    "laughing",
    "angry",
    "sad",
    "scared",
    "suspicious",
    "confused",
    "curious",
    "proud",
    "shy",
    "unimpressed",
    "sleepy",
    "thoughtful",
    "concerned"
];

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:2.

CharacterAccessory

Independent, package-owned wearables in the shared face coordinate space.

Type-only declaration; it is not a runtime value.

Signature

type CharacterAccessory = 'glasses' | 'headphones';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:6.

CharacterAppearance

Type-only declaration; it is not a runtime value.

Signature

interface CharacterAppearance {
    readonly skin: CharacterSkin;
    readonly skinVersion?: 1;
    readonly eyeStyle?: CharacterEyeStyle;
    readonly finish?: CharacterFinish;
    readonly eyePlacement?: CharacterEyePlacement;
    readonly shape?: CharacterShape;
    readonly accessories?: readonly CharacterAccessory[];
}

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:29.

CharacterEyePlacement

Type-only declaration; it is not a runtime value.

Signature

type CharacterEyePlacement = 'face' | 'raised';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:27.

CharacterEyeStyle

Type-only declaration; it is not a runtime value.

Signature

type CharacterEyeStyle = 'live-v1';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:26.

CharacterFinish

One self-contained material for every package-owned silhouette.

Type-only declaration; it is not a runtime value.

Signature

type CharacterFinish = 'plush' | 'flat';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:19.

CharacterOptions

Type-only declaration; it is not a runtime value.

Signature

interface CharacterOptions extends Omit<CharacterAppearance, 'skin'> {
    readonly skin?: CharacterSkin;
    readonly expression?: AvatarExpression;
    readonly view?: CharacterView;
    readonly size?: number;
    readonly animated?: boolean;
    readonly state?: LiveEyeState;
}

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:41.

CharacterRuntimeState

Type-only declaration; it is not a runtime value.

Signature

interface CharacterRuntimeState {
    readonly status: AvatarStatus;
    readonly expression: AvatarExpression;
    readonly blink: number;
    readonly gaze: {
        readonly x: number;
        readonly y: number;
    };
}

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:18.

CharacterShape

Type-only declaration; it is not a runtime value.

Signature

type CharacterShape = 'standard' | 'slender' | 'wide' | 'circle' | 'pebble' | 'squircle' | 'capsule' | 'triangle' | 'hexagon' | 'cloud' | 'droplet' | 'kite' | 'fan' | 'bud' | 'leaf' | 'drop' | 'wave' | 'comet' | 'satellite' | 'mitt' | 'hood' | 'crystal' | 'obelisk' | 'spring' | 'bellows' | 'vase' | 'teapot' | 'flame' | 'curl' | 'radio' | 'beacon' | 'tower' | 'arch' | 'pom' | 'bear' | 'pumpkin' | 'ghost' | 'bat' | 'witch-hat' | 'candy-corn' | 'turkey' | 'acorn' | 'squash' | 'pie' | 'corn' | 'light' | 'tree' | 'snowman' | 'ornament' | 'gift';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:28.

CharacterSkin

Type-only declaration; it is not a runtime value.

Signature

type CharacterSkin = 'autos' | 'spacex' | 'fold' | 'sprig' | 'ripple' | 'halo' | 'purl' | 'prism' | 'coil' | 'kiln' | 'wisp' | 'relay' | 'cairn' | 'tuft' | 'halloween' | 'thanksgiving' | 'christmas';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:24.

CharacterStateUpdate

A status update clears the previous override; null restores the status expression.

Type-only declaration; it is not a runtime value.

Signature

interface CharacterStateUpdate extends Omit<LiveEyeState, 'expression'> {
    readonly expression?: AvatarExpression | null;
}

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:28.

CharacterView

Type-only declaration; it is not a runtime value.

Signature

type CharacterView = 'avatar' | 'full';

Source: @openagentid/sdk@0.7.2, dist/characters.d.ts:25.

LiveEyeState

Type-only declaration; it is not a runtime value.

Signature

interface LiveEyeState {
    readonly status?: AvatarStatus;
    readonly expression?: AvatarExpression;
    readonly blink?: number;
    readonly gaze?: {
        readonly x: number;
        readonly y: number;
    };
}

Source: @openagentid/sdk@0.7.2, dist/character-state.d.ts:6.

Package requirements

Dependencies

Package	Published range
zod	`^3.23.8`
jose	`^5.10.0`
@noble/hashes	`^1.8.0`
@scure/base	`^1.2.6`

Peer dependencies

Package	Published range	Optional
@openagentid/aegis-sdk	`^0.1.0`	Yes
@openagentid/arsenal-sdk	`^0.1.0`	Yes
@openagentid/crypto-wasm	`^0.1.0`	Yes
@openagentid/oas-sdk	`^1.0.2`	Yes

Archive verification

Pinned integrity:

SHA-512 integrity

sha512-9YlDb02di8sGffhuMOwNAQa/M3oBrhaqPc7t+qBltdoQRCqlxDmYB/nTRSB4eZgwE4lvM4TKzI72nJtJSVm/ww==

Machine-readable API manifest · Coverage

On this page