Activity Stream

The Activity Stream provides complete visibility into everything your AI teams do. Every action, decision, and collaboration is logged and accessible in real-time.

Why Complete Observability Matters

Enterprise AI deployments fail when teams can't answer: "What did the AI do and why?"

MeetLoyd's Activity Stream answers this definitively:

• Compliance: Auditable trail of all agent actions
• Debugging: Trace issues to specific events
• Trust: See exactly what's happening, no guessing
• Optimization: Identify patterns and bottlenecks

---

What Gets Logged

Team Lifecycle Events

Event	Description
Team Started	Team status changed to running
Team Reset	Team onboarding was reset
Discovery Started	Organizational context discovery began
Discovery Completed	Context gathering finished
Settings Learned	Team operational settings configured

Agent Charter Events

Event	Description
Charter Generated	Agent charter was created
Charter Pending	Charter awaiting approval
Charter Approved	Charter activated
Charter Rejected	Charter was declined

Tool & Integration Events

Event	Description
Tool Discovery Started	Checking tool availability
Tool Matched	Agent tools matched to integrations
Tool Missing	Integration needed for agent tools
Tool Discovery Completed	Tool check finished

Collaboration Events

Event	Description
Handshake Started	Agent introductions began
Handshake Completed	Agents established working agreements
First Meeting Started	Initial team A2A session began
First Meeting Ended	Team meeting concluded
A2A Message	Agent-to-agent communication
Handoff	Conversation transferred between agents
Escalation	Issue escalated to higher authority

Task & Work Events

Event	Description
Task Created	New task assigned
Task Completed	Task finished successfully
Task Failed	Task encountered an error
Bootstrap Task Created	Setup task created for human

Governance Events

Event	Description
Approval Request	Agent requested approval
Approval Granted	Request approved
Approval Denied	Request denied
Rule Triggered	Governance rule activated

---

Viewing the Activity Stream

In Openspace

The Activity Stream panel shows real-time events for the team you're viewing:

• Chronological event list
• Color-coded severity (info, warning, error)
• Agent avatars for attribution
• Expandable details

In Dashboard

Access the unified activity view:

• All teams in one place
• Advanced filtering
• Export capabilities

---

Filtering Events

Focus on what matters with powerful filters:

By Type

?types=team_started,charter_approved,error

By Severity

?severities=warning,error,critical

By Team

?teamId=team_abc123

By Time

?since=2024-01-15T00:00:00Z

Combined

?types=error,warning&severities=error&teamId=team_abc123&since=2024-01-15T00:00:00Z

---

Real-Time Streaming

For live monitoring, use Server-Sent Events (SSE):

const eventSource = new EventSource('/api/activity/stream/team_abc123');

eventSource.addEventListener('activity', (event) => {
  const data = JSON.parse(event.data);
  console.log('New activity:', data.title);
});

eventSource.addEventListener('heartbeat', () => {
  // Connection alive
});

---

API Reference

Get Team Activity

GET /api/activity/team/{teamId}

Parameters:

• limit (default: 50) - Max events to return
• since - ISO timestamp for filtering

Get Agent Activity

GET /api/activity/agent/{agentId}

Returns tool execution logs and activity events involving the agent.

Get All Activity (Admin)

GET /api/activity/all

Parameters:

• limit (default: 100)
• offset (default: 0)
• types - Comma-separated event types
• severities - Comma-separated severities
• teamId - Filter to specific team
• since - ISO timestamp

Response:

{
  "events": [
    {
      "id": "evt_abc123",
      "timestamp": "2024-01-15T10:30:00Z",
      "teamId": "team_xyz",
      "teamName": "C-Suite",
      "agentId": "agent_ceo",
      "agentName": "CEO Agent",
      "type": "charter_approved",
      "title": "Charter Approved: CEO Agent",
      "details": "Strategic leadership and decision-making",
      "severity": "info",
      "metadata": {
        "charterVersion": 1,
        "role": "Chief Executive Officer"
      }
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 100,
    "offset": 0,
    "hasMore": true
  }
}

Real-Time Stream

GET /api/activity/stream/{teamId}

Returns SSE stream with events:

• connected - Connection established
• activity - New activity event
• heartbeat - Keep-alive signal

---

Integration with External Systems

SIEM Integration

Export activity events to your Security Information and Event Management system for centralized monitoring.

Audit Systems

The activity log provides the audit trail required for SOC 2, GDPR, and other compliance frameworks.

Custom Dashboards

Use the API to build custom monitoring dashboards that fit your organization's needs.

---

Event Severity Levels

Level	Description	Use Case
info	Normal operations	Charter approved, task completed
warning	Attention needed	Tool missing, handshake incomplete
error	Problem occurred	Task failed, integration error
critical	Immediate action required	Governance violation, system failure

---

Data Retention

Activity events are retained according to your plan:

• Starter: 30 days
• Growth: 90 days
• Enterprise: Custom retention (1+ years)

Export events before retention period ends if you need longer storage.

---

Related Topics

• Autonomous Teams - How teams onboard themselves
• Governance Framework - Compliance controls
• API Reference - Complete API documentation