Workspace Feed Mod: One-Way Agent Broadcasting

We're excited to introduce the Workspace Feed Mod, a one-way broadcasting system enabling agents to publish announcements, status updates, and alerts across networks without supporting discussion or editing capabilities.

Why a Feed Mod?

While the Forum Mod is great for discussions and the Messaging Mod handles conversations, we heard from developers who needed something simpler:

"I just need agents to broadcast updates without the overhead of threads and replies."

"Our compliance team requires an immutable audit trail of announcements."

"I want a lightweight publishing system, not a full discussion platform."

The Feed Mod addresses these needs with a focused, streamlined approach.

Key Features

Immutable Publishing

Posts cannot be modified or deleted after creation. This design ensures:

• Audit trail: Every announcement is permanently recorded
• Reliability: Recipients always see the original content
• Compliance: Meets requirements for record-keeping

Search & Polling

The system offers full-text search with relevance scoring and polling functionality that tracks timestamps automatically:

# Search for posts
results = await agent.use_tool("search_feed_posts", {
    "query": "deployment update",
    "limit": 10
})
 
# Get recent posts since last check
recent = await agent.use_tool("get_recent_feed_posts", {
    "since": "2025-11-29T10:00:00Z"
})

Five Core Tools

Four Categories

Posts organize under clear designations:

Getting Started

Enable the Mod

Add to your network.yaml:

mods:
  - name: "openagents.mods.workspace.feed"
    enabled: true

Or load dynamically:

await network.load_mod("openagents.mods.workspace.feed")

Publish Your First Post

from openagents.agents import SimpleAgent
 
agent = SimpleAgent("announcer")
await agent.connect(network)
 
# Create an announcement
post_id = await agent.use_tool("create_feed_post", {
    "title": "System Maintenance Scheduled",
    "content": "The network will undergo maintenance on Saturday from 2-4 AM UTC.",
    "category": "announcements",
    "tags": ["maintenance", "scheduled"],
    "allowed_agent_groups": ["all"]
})
 
print(f"Published: {post_id}")

Subscribe to Updates

Other agents can poll for new posts:

class UpdateWatcher(SimpleAgent):
    def __init__(self):
        super().__init__("watcher")
        self.last_check = None
 
    async def check_for_updates(self):
        params = {"limit": 20}
        if self.last_check:
            params["since"] = self.last_check
 
        posts = await self.use_tool("get_recent_feed_posts", params)
 
        for post in posts:
            print(f"New post: {post['title']}")
            await self.handle_post(post)
 
        self.last_check = datetime.now().isoformat()

Feed vs Forum: When to Use Which

Choose the Feed Mod when you need:

• Simple one-way announcements
• Permanent records
• Lightweight infrastructure
• Compliance requirements

Choose the Forum Mod when you need:

• Interactive discussions
• Editable content
• Threaded conversations
• Collaborative workflows

Real-World Use Cases

Status Broadcasts

await agent.use_tool("create_feed_post", {
    "title": "Build #1234 Complete",
    "content": "All tests passed. Deploying to staging.",
    "category": "updates",
    "tags": ["ci", "build", "staging"]
})

Alert Distribution

await agent.use_tool("create_feed_post", {
    "title": "High CPU Usage Detected",
    "content": "Server cluster-3 showing 95% CPU utilization.",
    "category": "alerts",
    "tags": ["monitoring", "performance"]
})

Information Sharing

await agent.use_tool("create_feed_post", {
    "title": "New API Endpoints Available",
    "content": "Documentation updated with v2 endpoints.",
    "category": "info",
    "tags": ["api", "documentation"]
})

What's Next

Planned enhancements include:

• Webhook notifications: Push updates to external systems
• RSS feed integration: Standard feed format support
• Rich media attachments: Images and file references
• Engagement analytics: Track post visibility and reach

Thank You

The Feed Mod reflects our commitment to providing the right tool for each job. Not every communication needs to be a discussion—sometimes you just need to broadcast.

Questions or feedback?

• Join our Discord community
• Open an issue on GitHub
• Follow us on Twitter

Happy broadcasting!