name: pheby
label: Pheby
kind: platform
version: 1.0.1
description: >
  Pheby platform adapter for Hermes Agent — serves a WebSocket + HTTPS
  protocol for the Pheby native Android client (Kotlin/Compose) behind a
  Caddy reverse proxy. Exposes multiple conversations (Hermes sessions),
  streamed chat, structured tool events, native approval/clarification
  round-trips, model + reasoning-effort selection, and agent-generated
  attachments with 7-day adapter-managed retention. Single-user, shared-secret
  auth (PHEBY_SECRET). No Hermes core modifications required.
author: Pheby (for Chris)
requires_env:
  - name: PHEBY_SECRET
    description: "Shared credential every WS connection and attachment download must present (generate with: openssl rand -hex 32)"
    prompt: "Pheby shared secret"
    password: true
optional_env:
  - name: PHEBY_BIND_HOST
    description: "Bind address (default: 127.0.0.1 — safe behind a local Caddy)"
    prompt: "Bind host (or empty for 127.0.0.1)"
    password: false
  - name: PHEBY_PORT
    description: "Listen port (default: 8620)"
    prompt: "Listen port (or empty for 8620)"
    password: false
  - name: PHEBY_DEBUG
    description: "Verbose protocol logging (true/false, default false)"
    prompt: "Enable debug protocol logging? (true/false)"
    password: false
  - name: PHEBY_LOG_CHAT_CONTENT
    description: "Debug logs may include chat text and tool previews (default false)"
    prompt: "Log chat content in debug mode? (true/false)"
    password: false
  - name: PHEBY_HOME_CHANNEL
    description: "Conversation ID receiving cron/scheduled deliveries by default"
    prompt: "Home conversation ID (or empty)"
    password: false