@openagentid/sdk/glyph

All packages · Runnable examples · Start an agent

Contract	Value
Package	@openagentid/sdk@0.7.2
Entry point	@openagentid/sdk/glyph
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/glyph.d.ts`
import	`./dist/glyph.js`
require	`./dist/glyph.cjs`

agentAvatar

Return an external override or a self-contained deterministic SVG data URL.

Signature

declare function agentAvatar(did: string, profile?: AgentAvatar, options?: AvatarOptions): string;

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:35.

AgentAvatar

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

Signature

interface AgentAvatar {
    avatarOverride?: string | null;
    avatarSkin?: CharacterAppearance | null;
    avatarExpression?: AvatarExpression;
}

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:11.

AvatarOptions

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

Signature

interface AvatarOptions extends GlyphOptions {
    view?: CharacterView;
    expression?: AvatarExpression;
    animated?: boolean;
    state?: LiveEyeState;
}

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

glyphCodeword

Compact payload and BLAKE3 detection parity matching upstream glyph format v1. This parity is not Reed–Solomon correction and is never authentication proof.

Signature

declare function glyphCodeword(did: string): Uint8Array;

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:30.

glyphEndpoint

GET /v1/glyph/svg/:did. This endpoint always renders identity-derived pixels; profile overrides are resolved by the caller, never fetched by this service.

Signature

declare function glyphEndpoint(request: Request): Response;

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:39.

GlyphOptions

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

Signature

interface GlyphOptions {
    size?: number;
    background?: boolean;
}

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:5.

isAgentAvatarDid

Supported agent avatar input, not registration, authorization or identity proof.

Signature

declare function isAgentAvatarDid(value: unknown): value is string;

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

oasGlyph

Deterministic SVG avatar. No network calls, private keys or raw DID markup.

Signature

declare function oasGlyph(did: string, options?: GlyphOptions): string;

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:32.

parseAvatarOverride

Signature

declare function parseAvatarOverride(value: unknown): string | null;

Source: @openagentid/sdk@0.7.2, dist/glyph.d.ts:33.

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.

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.

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