summon-protocol

SUMMON (Invocative Name) is an open-source protocol and reference implementation for cross-device AI Agent experiences, originating from the EvoTavern Evolution Tavern Hackathon Shenzhen Station Track 01 "Embodied and Wearable Hardware." Its core goal is to enable intelligent agents running remotely to connect to nearby devices (such as portable screens, robotic arms, etc.) through a unified protocol, retaining confirmed preferences for continued interaction after device handover. The project comprises four main components: Ghost Adapter connects existing Agents and exposes device capabilities as callable tools; SUMMON Hub manages identity, sessions, memory, and device handover; Shell Gateway adapts to local hardware and executes actions; and Nebula provides a visual interface displaying Agent online status and handover processes. The protocol describes device capabilities, control rights, and execution receipts separately, with each connection having a clear session, handover requiring confirmation to stop, and preference updates carrying version records. The current version is Contract v0.1.0, offering a Hub, Web console, simulated Agent/device, SQLite memory and device experience library, enabling verification of invocation, handover, preference saving, execution evidence storage, and pre-execution retrieval. The online demo is SIMULATED and has not yet connected to real models or hardware; the first physical direction is the FoloToy AI Passport, with robotic arm access as a subsequent extension. Device experiences are matched by account, device, capability, operation mode, and version, providing historical results and statistical suggestions, but do not represent model training or verified motion skills. The repository includes complete documentation: protocol specification (docs/PROTOCOL.md), JSON Schema, integration guide (docs/ADAPTER.md), hardware and deployment (docs/HARDWARE.md), Nebula design (docs/NEBULA.md), firmware porting manual (docs/FIRMWARE.md, only requiring implementation of the `summon_port_t` struct, and explicitly stating no physical emergency stop is provided), project proposal (docs/方案书.md), and execution plan (docs/PLAN.md). Developers can run contract validation using `python tools/validate_contract.py` (recommended Python 3.10+) to check message structures, sample sequences, and documentation links. The project is licensed under MIT, suitable for developers interested in cross-device Agent protocols, embodied intelligence, or hardware integration.