Problem

We want agents to do various tasks in our communities.

Ideally, we will use SHM as the medium for communication with agents and agent memory.

Definitions

Agent Specification

Contains the primary system prompt for the agent, specifies what sort of keys the agent will need (signing keys, API keys). Specifies what sort of models will be required.

The agent specification will have a ruleset that defines when the agent wakes up (creating a new session).

Also, the agent specification may have additional arguments. For example an agent may be responsible for detecting spam

Agent Instance

The actual running agent requires some resources.

Session

A sequential log of user messages, agent messages, and tool calls.

Contains context about a specific task

Completion

This is one step of the session, performed by the agent. The agent may make a tool call or send a message to the user.

Trigger

Some options will define when is a session created, and when a message is appended to an existing session.

Solution

There will be some way in the UI to create an agent. This will be saved on the user's server, but could eventually become a distributed object.