# Agents, chat, voice, skills, tools, and approvals

## Agent types and lifecycle

- List all, public, accessible, hidden, connected, and unassigned agents.
- Create Presence/supervisor agents and worker/performer agents.
- Support Presence subtypes: member, movement, mission, proposal, BIG avatar, operator, elector, and ally.
- Configure name, handle, tagline, description, role, tone, access level, wallet owner, platform/context, status, parent Presence(s), system prompt, prompt template, knowledge bases, tools, skills, and templates.
- Check handle availability and offer valid alternatives.
- View an agent and its workers; edit all configurable fields.
- Set/unset primary member and set/unset ally.
- Add/remove multiple worker parents and expose unassigned workers.
- Publish, unpublish, archive, delete, pause, and resume an agent.
- Hide/unhide members; connect/disconnect members; list connection details.
- Generate agent description, tagline, role, or system-prompt content with AI.
- Create predefined Bluesky and executive avatars, list linked accounts, switch Bluesky account, and prefill executive-avatar data.
- Create, inspect, and remove member-to-tool mappings.

## Chat and conversation state

- Create, list, retrieve, and archive chat sessions.
- Send messages synchronously or through streaming responses.
- Directly process/stream against a Presence without a pre-created session.
- Use v2/deep-agent streaming and event mapping.
- Retrieve conversation messages, provider options, and chat-service status.
- List a user’s conversations, open a Presence/user conversation, clear messages, or delete the conversation.
- Summarize long history and cache conversation summaries.
- Show tool calls, partial output, approvals, errors, cancellation, and final output as distinct timeline events.

## Voice

- Check voice health and capabilities.
- Open a Gemini Live/WebSocket voice session.
- Capture microphone audio, stream it, play returned audio, bridge agent tools, and close/recover the session.
- List active voice sessions and expose connection, speaking, listening, tool, and error states.

## Skills and automations

- Generate skill content from a name, trigger, natural-language “when,” natural-language “then,” and selected tools.
- Trigger types: event, time, condition, and command.
- Parse natural-language schedules into cron expressions with timezone.
- Configure polling intervals and structured condition parameters.
- Mark a skill as approval-required.
- Create, list, edit, delete, activate/pause, run now, and cancel execution.
- Inspect all running executions, a skill’s running execution, execution trace, statistics, history, success/failure, duration, next run, and scheduler diagnostics.
- Store generated `SKILL.md`, source template, wallet ownership, and attached tool list.

## Tools and integrations

- Discover available tools and their capabilities.
- Verify credentials/configuration, test a tool, and show connection status.
- Discover MCP servers and server-provided tools; refresh the agent tool catalog.
- Save a connection globally, by wallet, or to a worker; list saved connections; remove a connection.
- Start and complete provider OAuth.
- Aggregate global tools, MCP tools, worker tools, and platform data for agent execution.
- Intended connector families represented in code/docs: Bluesky/Twitter, Telegram, Discord, email/Gmail, calendar, Notion, Slack, GitHub, Google Drive, and arbitrary MCP tools.

## Approval workflow

- Create a pending approval when a skill/tool/agent action is sensitive.
- List approvals with filters and view approval details/action preview.
- Show approval counts/statistics.
- Approve, reject, retry, expire, and record execution result/error.
- Associate approval with agent, worker, tool, conversation, skill/execution, user wallet, and serialized action data.
- Notify the user and return the result to the originating agent timeline.

## New UI requirements

- Use one consistent agent information architecture for create, view, edit, publish, pause, archive, and delete.
- Always distinguish Presence, worker, predefined avatar, ally, and member profile.
- Show inheritance/ownership for parent Presence, prompt, wisdom, tools, skills, and templates.
- Expose agent access/publication state independently from active/paused execution state.
- Provide a single action timeline across chat, voice, tool calls, approvals, and skill runs.
- Give integrations clear connection scope: global, wallet, platform, Presence, worker, or member mapping.
- Include safe retry/cancel, credential-expiry, rate-limit, provider-down, partial-success, and audit states.

