Agentic Edge Functions

Welcome to the Agentic Edge Functions repository by the Agentics Foundation. This open-source project serves as the technological foundation for distributed autonomous AI agents operating at the edge of networks.

What are Agentic Edge Functions?

Agentic Edge Functions combine serverless edge computing with autonomous AI capabilities. Running at the network edge, these functions enable AI agents to:

• Operate independently near users for lower latency
• Communicate securely with other agents and systems
• Access controlled resources via defined interfaces
• Scale dynamically based on workload requirements

This infrastructure powers the Agentic Dashboard and Agentic Inbox systems at agentics.org/dashboard and is being actively developed in the open, welcoming community contributions.

♾️ Agentic MCP

A powerful Model Context Protocol server with advanced AI capabilities by the Agentics Foundation. Built on the OpenAI Agents API/SDK using TypeScript, this package implements a comprehensive MCP server that enhances AI agents with sophisticated tools and orchestration capabilities:

🌟 Core Capabilities

• 🔍 Web Search Research: Generate comprehensive reports with up-to-date information from the web using gpt-4o-search-preview
• 📝 Smart Summarization: Create concise, well-structured summaries with key points and citations
• 🗄️ Database Integration: Query and analyze data from Supabase databases with structured results
• 👥 Customer Support: Handle inquiries and provide assistance with natural language understanding
• 🔄 Agent Orchestration: Seamlessly transfer control between specialized agents based on query needs
• 🔀 Multi-Agent Workflows: Create complex agent networks with parent-child relationships and shared context
• 🧠 Context Management: Sophisticated state tracking with memory, resources, and workflow management
• 🛡️ Guardrails System: Configurable input and output validation to ensure safe and appropriate responses
• 📊 Tracing & Debugging: Comprehensive logging and debugging capabilities for development
• 🔌 Edge Function Deployment: Ready for deployment as Supabase Edge Functions
• 🔄 Streaming Support: Real-time streaming responses for interactive applications

🚀 Installation

# Install globally
npm install -g @agentics.org/agentic-mcp

# Or as a project dependency
npm install @agentics.org/agentic-mcp

Overview

This repository contains edge functions implementing various patterns for autonomous agent deployment and operation. Built on Supabase's serverless infrastructure and Deno runtime, these functions enable scalable, efficient, and globally distributed agent capabilities.

Additionally, it includes the scripts/agentic-mcp/ package, a powerful Model Context Protocol server that enhances AI agents with advanced tools and orchestration capabilities.

What are Edge Functions?

Edge functions are serverless functions running at network edges, providing low-latency, high-availability compute without server management. Supabase Edge Functions use Deno, a modern secure JavaScript/TypeScript runtime with built-in security features.

Why Deno?

Deno is a modern, secure runtime for JavaScript and TypeScript that provides several advantages:

• Security-first design: Explicit permissions for file, network, and environment access
• Built-in TypeScript support: No configuration needed
• Modern JavaScript: Support for ES modules, top-level await, and more
• Standard library: Comprehensive, reviewed standard modules
• Single executable: No dependency management headaches

Function Categories

Our edge functions fall into several categories:

Agent Functions

• agent_alpha - Basic agent implementation with ReAct pattern
• agent_beta - Enhanced agent with additional capabilities
• agent_stream - Streaming response agent
• agent_websocket - WebSocket-based agent communication
• agentic_inbox_agent - Agent for managing message inboxes

Management Functions

• agent-manager - Orchestration and management of multiple agents
• edge_deployment - Tools for deploying and managing edge functions

Communication Functions

• resend - Email communication using Resend API
• send-contact-notification - Contact form notifications

Integration Functions

• github-api - GitHub API integration
• mcp-server - Model Context Protocol server implementation

Utility Functions

• stripe_check-subscription-status - Subscription status verification
• stripe_create-portal-session - Stripe customer portal integration
• feedback - User feedback collection
• meta-function-generator - Dynamic function generation
• hello-world - Simple example function
• test-function - Testing utilities

Key Features

• Real-time Communication: Agents can communicate in real-time using Supabase's real-time channels
• Database Integration: Seamless integration with Supabase PostgreSQL database
• Secure Secrets Management: Environment variables for secure credential management
• Scalable Architecture: Functions scale automatically with demand
• Global Distribution: Deploy functions globally for low-latency responses

Getting Started

To get started with these edge functions:

1. Clone this repository
2. Set up a Supabase project
3. Configure environment variables
4. Deploy functions to your Supabase project

For beginners, we recommend following our step-by-step tutorials to learn how to create, deploy, and test edge functions. For detailed instructions, see the Getting Started Guide.

Documentation

Comprehensive documentation is available in the docs directory:

• Function Documentation - Detailed documentation for each function
• Supabase Edge Functions - Overview of Supabase Edge Functions
• Real-time Channels - Using Supabase real-time channels
• Environment Variables - Comprehensive list of all environment variables
• Secrets Management - Best practices for managing secrets
• Database Triggers - Using database triggers with edge functions
• Deployment Guide - Deploying edge functions to production

Tutorials

• Tutorials Overview - Beginner-friendly guides for Agentic Edge Functions
• Creating Your First Edge Function - Learn the basics of edge functions
• Building a Basic Agentic Function - Create your first agentic edge function
• Deploying and Testing Edge Functions - Learn how to deploy and test your functions

Contributing

Contributions are welcome! Please see our Contributing Guidelines for more information.

License

This project is licensed under the terms of the license included in the repository.

Created by rUv, Agentics Foundation founder.