Eve library

@oshun/embodiment-psyche

Other

Revision 1

On this page

Canonical Psyche embodiment adapter contracts for OSHUN.

This package defines the product-facing real-time embodiment interface that OSHUN uses when it needs persona-linked voice/avatar packs, low-latency session planning, turn-taking, disclosure overlays, conferencing bridges, translation, and live multimodal session state.

It deliberately normalizes the fragmentation that already exists across Psyche:

  • the orchestrator owns raw session, pipeline, and multiparty runtime state
  • persona-service owns persona identity plus avatar/voice asset linkage
  • conferencing libraries own meeting bridge transport details
  • translation and avatar quality libraries own stream and render performance

The adapter contract exposes one canonical embodiment profile, one live session state model, one disclosure contract, and one session-planning surface for OSHUN shell and admin integration work.

Scope#

  • canonical embodiment profile, capability, live-session, disclosure, and quality DTOs
  • low-level adapter interface for Psyche persona, session, participant, pipeline, conference, and translation primitives
  • canonical adapter factory (createCanonicalPsycheEmbodimentAdapter) that wraps an injected low-level Psyche adapter
  • normalization helpers that align raw Psyche runtime states with OSHUN session contracts

Usage#

ts
import { createCanonicalPsycheEmbodimentAdapter } from '@oshun/embodiment-psyche';

const psyche = createCanonicalPsycheEmbodimentAdapter({ apiAdapter });

const session = await psyche.startEmbodiedSession({
  consumer: 'assistant',
  personaId: 'guide-1',
  requestedModalities: ['text', 'voice', 'avatar'],
  sessionKind: 'voice',
});