HomeKit

What this surface is for

Voice endpoint

Behavior in the current codebase

• Provides a lightweight HTTP bridge for Siri and Apple Shortcuts workflows.
• Maintains per-device conversation sessions instead of treating every request as stateless.
• Good fit for Apple-first households that want voice access without a full chat client.

Direct platform support

14 current Verba Plugins advertise direct support for this surface.

Configuration schema

• Auth Token (optional) string

  If set, Shortcuts must send this token in X-Tater-Token header.

  Key: AUTH_TOKEN
• Max History Cap number

  Hard ceiling to prevent runaway context sizes.

  Key: MAX_HISTORY_CAP Default: 12
• Session History (turns) number

  How many recent turns to include per Siri conversation.

  Key: SESSION_HISTORY_MAX Default: 4
• Session TTL (seconds) number

  How long to keep a Siri session alive.

  Key: SESSION_TTL_SECONDS Default: 3600
• Bind Port number

  TCP port for the Tater ↔ Siri / Shortcuts bridge

  Key: bind_port Default: 8789