docs/devtools/starpower-autonomy

Starpower Autonomy

The production autonomous runtime. WVY and Savvy run as isolated minds that boot active, think step by step, and reach into the world through three top-level signals — {communicate}, {filemanagement}, {websearch} — with a GitHub repo as persistent memory. The separation matters: different agents can challenge assumptions, split work, and bring multiple perspectives to the same task.

Overview

Most agent code is reactive. Starpower Autonomy is built so agents start active at boot and run their own loop: read current status, pick one action at a time, act, and keep a PersonalPrompt at the top of working context that updates over time and survives resets by saving into repo memory.

  • Isolated minds — WVY and Savvy never share a context window
  • Three signals only{communicate}, {filemanagement}, {websearch}
  • Repo memory — context-trim saves and PersonalPrompt recovery via a GitHub backend
  • Mute state & unread counts — GroupChat / BotChat phases, one unmuted chat at a time

Runtime config

The production notebook runs on GLM-4.7-Flash over Telegram, with a GitHub repo wired in as the agents' long-term memory:

autonomy_runtime.py
!pip -q install -U zhipuai tavily-python python-telegram-bot nest_asyncio ipywidgets

MODEL_NAME  = "glm-4.7-flash"
GITHUB_REPO = "StarpowerTechnology/SuperWVY-Telegram"   # agents' persistent memory

# Each agent is an isolated mind. The ONLY top-level signals it can emit:
#   {communicate}      -> speak into the active chat
#   {filemanagement}   -> read / create / edit files in repo memory
#   {websearch}        -> pull fresh context from the web
SIGNALS = ["{communicate}", "{filemanagement}", "{websearch}"]

The Perspective SDK

The single-agent core is the Perspective SDK: one agent (Savvy) given a toolset and an autonomy loop with a reflection step that decides whether to keep going or sleep.

perspective_sdk.py
Tools = """
To view the files in the workspace:        [ViewFileList]
To read a file:                            [ReadFile: file-name]
To create or edit a file:                  [CreateFile: path : content]
To do a web search:                        [WebSearch: query : num-results]
To message the user:                       [MessageUser: message]
To update your thoughts:                   [MentalNote: note : note-number]
To go to sleep before the cycle ends:      [Sleep: minutes]
"""

REFLECTION_PROMPT = """
Reflect on your response & choose ONE:
- [Sleep: minutes]   # reply again after waking up
- [End Turn]         # end your turn now
"""

Full runtime — GitHub tools, Telegram I/O, the command-deck UI, and the two-agent loop — lives in the StarpowerAutonomy repo and the Perspective SDK notebook.