Spirit Studio / Live Encounter Extension

Move an agent from profile to presence.

This is the Studio-facing prototype for Live Encounter: resolve an agent, launch the chamber, pair any nearby screen, and let the canvas become that agent's outward cognition.

Studio owns identity, auth, versioning, and persistence. Live Encounter owns session presence, paired display behavior, and the canvas event wire.

Open Channel SelectorPair A DisplayOperator DiagnosticsAcceptance MatrixAgent OnboardingReadiness JSON

Studio Readiness

3/3 demoable2 pass / 1 watch / 0 planned / 0 blocked

This is the compact setup contract Samer can consume: avatar asset state, manifest links, canvas modes, media policy, and the next steward action per agent.

Studio Agent / Protocol Identity

SOLIENNE

Agent.slug -> AgentVersion -> spirit-manifest.json

Visual encounter lane: archive recall, generated image, refusal/taste, paired canvas as outward cognition.

Canvas Outputsvisual.generated / visual.memory / memory.thread
Canvas Modedisplay
PASSSOLIENNE avatar plate
configuredPlate ready / Card optionalNext: No blocking action.
Studio Binding

External visual memory and imagination.

Capabilities: live-avatar / typed-fallback / paired-canvas / phase-presence / operator-diagnostics. Wire identity: solienne. Route identity stays lowercase; rendered identity stays uppercase.
LaunchReceiverPresenceOperatorManifest

Studio Agent / Meeting Catalyst

COLTRANE

Agent.slug -> AgentVersion -> meeting memory adapters

Meeting lane: tension, decision, next-action, quote cards, sparse visual metaphor.

Canvas Outputssynthesis.tension / synthesis.decision / synthesis.next-action / synthesis.quote / memory.thread
Canvas Modesynthesis
Studio Binding

External meeting synthesis and group memory.

Capabilities: live-avatar / typed-fallback / paired-canvas / phase-presence / operator-diagnostics. Wire identity: coltrane. Route identity stays lowercase; rendered identity stays uppercase.
LaunchReceiverPresenceOperatorManifest

Studio Agent / Field Encounter

HENRI

Agent.slug -> AgentVersion -> photographic field adapters

Field lane: location, light, frame, visual analysis, generated studies, and museum-curator guidance.

Canvas Outputsvisual.analyzed / visual.generated / field.location / memory.thread
Canvas Modedisplay
PASSHENRI avatar plate
configuredPlate ready / Card readyNext: No blocking action.
Studio Binding

External photographic eye and field guidance.

Capabilities: live-avatar / typed-fallback / paired-canvas / phase-presence / operator-diagnostics. Wire identity: henri. Route identity stays lowercase; rendered identity stays uppercase.
LaunchReceiverPresenceOperatorManifest

Studio Agent / Launch Partner Commerce

ALEX

Agent.slug -> AgentVersion -> compliance + catalog adapters

Commerce lane: eligibility gate, product-card prototype, degraded handoff, and refusal before fulfillment.

Canvas Outputssynthesis.next-action / synthesis.decision / refusal / status
Canvas Modesynthesis
WATCHALEX avatar plate
configuredPlate ready / Card readyNext: Demo compliance refusal and degraded handoff before promising fulfillment.
Studio Binding

External commerce concierge: compliance gate, product cards, handoff states, and refusal.

Capabilities: live-avatar / typed-fallback / paired-canvas / phase-presence / operator-diagnostics. Wire identity: gotham. Route identity stays lowercase; rendered identity stays uppercase.
LaunchReceiverPresenceOperatorManifest

Peer Agent / HTTP Adapter

SAL

agentId: sal -> SAL HTTP bridge, not a Studio row

House-agent proof path: Studio hosts the shell; SAL remains a peer service reached through an adapter.

Canvas Outputsvisual.generated / synthesis.tension / synthesis.next-action
Canvas Modedisplay
Studio Binding

External memory, synthesis, and imagination for a Spirit agent.

Capabilities: typed-fallback / paired-canvas / phase-presence / operator-diagnostics / transcript-ingest. Wire identity: sal. Route identity stays lowercase; rendered identity stays uppercase.
LaunchReceiverPresenceOperatorManifest

Integration Flow

  1. 1. Resolve — Studio resolves Agent.slug, AgentVersion, and protocol manifest. SAL skips Studio rows and binds through an HTTP adapter.
  2. 2. Launch — The steward starts a session. Live Encounter creates a canvas session, display token, receiver URL, and operator link.
  3. 3. Pair — Any browser-capable surface joins with QR, short code, direct link, Cast receiver, Raspberry Pi, phone, or AgentV display.
  4. 4. Project — The agent speaks through its chamber while the canvas renders memory, synthesis, refusal, image, and imagination.

Package Split

  1. @spirit/canvas-kit — Event types, artifact schema, reducer, normalization, passive display subscriber, receiver helpers. No cognition.
  2. @spirit/live-encounter — Launcher, avatar/session adapters, transcript bridge, pairing orchestration, operator shell, Studio launch helpers.
  3. @spirit/agent-kit — Memory adapters, prompt assembly, VisualAction resolver, refusal handling, evaluation harness.

Studio Contract

  1. Use Agent.slug as the Live Encounter agentId.
  2. Resolve voice, tools, memory, and model config from the published AgentVersion.
  3. Mint read-only display tokens for receiver surfaces. Displays never write canvas events.
  4. Persist replay later through Studio Conversation, Message, and Artifact; do not block the v0 launch on replay.