Skip to content

viewer: expose app-status v1 for the live OpenWorlds surface #481

Description

@100yenadmin

Summary

Expose a machine-readable read-only status probe for the actual OpenWorlds viewer that the native app and harness are driving.

Interface

  • GET /app-status
  • GET /__worldos/app-status.json

Both return schema worldos.app-status.v1.

Required fields

  • build: SHA and app/version string
  • viewer: port, repo root, state root, provider, transcript/chat paths, chat line count
  • art: art repo root, private image root, private-root-present boolean
  • live session: attached campaign id, viewed campaign id, active session id, run id, move path, whether moves are writable, can_act, active actor id/name/kind, enabled action IDs/count
  • endpoints: app-status, session-surface, campaign catalog, move, chat, activity, image

Acceptance criteria

  • Route is read-only and never writes snapshot.json, move logs, chat logs, or provider state.
  • Alias route returns the same payload as /app-status.
  • Viewer config advertises the app-status endpoint.
  • Static/route tests prove a live campaign returns actor, run id, enabled actions, and endpoint metadata.
  • qa/ui_playtest_app.sh captures launcher and minted app-status snapshots as native evidence.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesttier-1Tier 1: Claude Code plugin

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions