chore: doc updates for gmail

ak-py/README.md

@@ -502,6 +502,17 @@ Configure integrations with messaging platforms.
 - **Bot Token**, **Webhook Secret**, **API Version**
   - **Environment Variables**: `AK_TELEGRAM__BOT_TOKEN`, `AK_TELEGRAM__WEBHOOK_SECRET`, `AK_TELEGRAM__API_VERSION`
 
+##### Gmail
+
+- **Agent**
+  - **Field**: `gmail.agent`
+  - **Default**: `"general"`
+  - **Description**: Default agent for Gmail interactions
+  - **Environment Variable**: `AK_GMAIL__AGENT`
+
+- **Client ID**, **Client Secret**, **Token File**, **Poll Interval**, **Label Filter**
+  - **Environment Variables**: `AK_GMAIL__CLIENT_ID`, `AK_GMAIL__CLIENT_SECRET`, `AK_GMAIL__TOKEN_FILE`, `AK_GMAIL__POLL_INTERVAL`, `AK_GMAIL__LABEL_FILTER`
+
 ### Configuration Examples
 
 #### Environment Variables
@@ -536,6 +547,9 @@ export AK_WHATSAPP__AGENT=my-agent
 export AK_MESSENGER__AGENT=my-agent
 export AK_INSTAGRAM__AGENT=my-agent
 export AK_TELEGRAM__AGENT=my-agent
+export AK_GMAIL__AGENT=my-agent
+export AK_GMAIL__CLIENT_ID=your-google-client-id
+export AK_GMAIL__CLIENT_SECRET=your-google-client-secret
 ```
 
 #### .env File
@@ -608,6 +622,10 @@ instagram:
   agent: my-agent
 telegram:
   agent: my-agent
+gmail:
+  agent: my-agent
+  poll_interval: 30
+  label_filter: "INBOX"
 ```
 
 #### config.json
@@ -670,6 +688,11 @@ telegram:
   },
   "telegram": {
     "agent": "my-agent"
+  },
+  "gmail": {
+    "agent": "my-agent",
+    "poll_interval": 30,
+    "label_filter": "INBOX"
   }
 }
 ```

docs/docs/integrations/overview.md

@@ -24,6 +24,7 @@ The following built-in integrations are available.
 - **[Messenger](./messenger)** - Deploy agents as FB Messenger bots
 - **[Instagram](./instagram)** - Deploy agents as Instagram DM bots
 - **[Telegram](./telegram)** - Deploy agents as Telegram bots
+- **[Gmail](./gmail)** - Deploy agents as Gmail bots that automatically read and reply to emails
 
 ```mermaid
 ---
@@ -32,7 +33,7 @@ config:
   elk: true
 ---
 flowchart LR
-    D["Integration"] --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"]
+    D["Integration"] --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"] & O["Gmail"]
 
     style I fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff
     style J fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff
@@ -53,7 +54,7 @@ config:
 ---
 flowchart LR
 
-    D["RESTRequestHandler"] --> I["AgentSlackRequestHandler"] & J["AgentWhatsAppRequestHandler"] & K["AgentMessengerRequestHandler"] & M["AgentInstagramRequestHandler"] & O["AgentTelegramRequestHandler"] & N["CustomHandler"]
+    D["RESTRequestHandler"] --> I["AgentSlackRequestHandler"] & J["AgentWhatsAppRequestHandler"] & K["AgentMessengerRequestHandler"] & M["AgentInstagramRequestHandler"] & O["AgentTelegramRequestHandler"] & P["AgentGmailHandler"] & N["CustomHandler"]
 
     style I fill:#005073,stroke:#fff,stroke-width:2px,color:#fff
     style J fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff

docs/docs/intro.md

@@ -58,6 +58,7 @@ Agent Kernel provides pre-built execution capabilities:
   - Messenger
   - Telegram
   - Instagram
+  - Gmail
 - **AWS Serverless Deployment** for scalable production
 - **AWS Containerized Deployment** for consistent loads
 - **MCP Server** for Model Context Protocol tool publishing
@@ -167,7 +168,7 @@ flowchart LR
     B -- Local --> C["CLI Testing"]
     B -- API --> D["REST API Server"] & G["MCP Server"] & H["A2A Server"]
     B -- Cloud --> E["AWS Serverless"] & F["AWS Containers"]
-    D -- Integration --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"]
+    D -- Integration --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"] & O["Gmail"]
 
     style A fill:#2e8555,stroke:#fff,stroke-width:2px,color:#fff
     style I fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff

docs/src/pages/features.tsx

@@ -118,7 +118,7 @@ function OverviewSection() {
             </div>
             <h3>Versatile Integrations</h3>
             <p>
-              Built-in integrations for popular messaging platforms including Slack, WhatsApp, Messenger, Instagram, and Telegram. 
+              Built-in integrations for popular messaging platforms including Slack, WhatsApp, Messenger, Instagram, Telegram, and Gmail. 
               Support for MCP Server and A2A Server protocols. Easy-to-build custom integrations with pluggable architecture.
             </p>
           </Link>
@@ -340,7 +340,7 @@ function MemorySection() {
           ))}
         </div>
         <div className={styles.sectionFooter}>
-          <Link to="/docs/advanced/memory-management" className={styles.sectionLink}>
+          <Link to="/docs/architecture/memory-management" className={styles.sectionLink}>
             View Memory Management Documentation →
           </Link>
         </div>
@@ -644,7 +644,7 @@ function MessagingSection() {
     { name: 'Messenger', icon: <FaFacebookMessenger />, status: 'Available' },
     { name: 'Telegram', icon: <FaTelegram />, status: 'Available' },
     { name: 'Instagram', icon: <FaInstagram />, status: 'Available' },
-    { name: 'Gmail', icon: <SiGmail />, status: 'Coming Soon' },
+    { name: 'Gmail', icon: <SiGmail />, status: 'Available' },
   ];
 
   return (
@@ -655,7 +655,7 @@ function MessagingSection() {
           <h2 className={styles.sectionTitle}>Messaging Integrations</h2>
           <p className={styles.sectionSubtitle}>
             Connect your AI agents to popular messaging platforms and reach your users where they are. 
-            Built-in integrations for Slack, WhatsApp, Messenger, Instagram, and Telegram.
+            Built-in integrations for Slack, WhatsApp, Messenger, Instagram, Telegram, and Gmail.
           </p>
         </div>
 

docs/src/pages/index.tsx

@@ -250,25 +250,25 @@ function MessagingIntegrationsSection() {
       color: '#0088CC',
       link: '/docs/integrations/telegram',
     },
-  ];
-
-  const comingSoonIntegrations = [
     {
       name: 'Gmail',
       icon: <SiGmail />,
       description: 'Email conversation handling with Gmail',
-      status: 'coming-soon',
+      status: 'active',
       color: '#EA4335',
+      link: '/docs/integrations/gmail',
     },
   ];
 
+  const comingSoonIntegrations = [];
+
   return (
     <section id="integrations" className={styles.messagingIntegrationsSection}>
       <div className="container">
         <div className={styles.integrationsHeader}>
           <h2 className={styles.integrationsSectionTitle}>Messaging Platform Integrations</h2>
           <p className={styles.integrationsSectionSubtitle}>
-            Connect your AI agents to popular messaging platforms including Slack, WhatsApp, Messenger, Instagram, and Telegram
+            Connect your AI agents to popular messaging platforms including Slack, WhatsApp, Messenger, Instagram, Telegram, and Gmail
           </p>
         </div>
 

docs/versioned_docs/version-0.2.9/integrations/overview.md

@@ -24,6 +24,7 @@ The following built-in integrations are available.
 - **[Messenger](./messenger)** - Deploy agents as FB Messenger bots
 - **[Instagram](./instagram)** - Deploy agents as Instagram DM bots
 - **[Telegram](./telegram)** - Deploy agents as Telegram bots
+- **[Gmail](./gmail)** - Deploy agents as Gmail bots that automatically read and reply to emails
 
 ```mermaid
 ---
@@ -32,7 +33,7 @@ config:
   elk: true
 ---
 flowchart LR
-    D["Integration"] --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"]
+    D["Integration"] --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"] & O["Gmail"]
 
     style I fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff
     style J fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff
@@ -53,7 +54,7 @@ config:
 ---
 flowchart LR
 
-    D["RESTRequestHandler"] --> I["AgentSlackRequestHandler"] & J["AgentWhatsAppRequestHandler"] & K["AgentMessengerRequestHandler"] & M["AgentInstagramRequestHandler"] & O["AgentTelegramRequestHandler"] & N["CustomHandler"]
+    D["RESTRequestHandler"] --> I["AgentSlackRequestHandler"] & J["AgentWhatsAppRequestHandler"] & K["AgentMessengerRequestHandler"] & M["AgentInstagramRequestHandler"] & O["AgentTelegramRequestHandler"] & P["AgentGmailHandler"] & N["CustomHandler"]
 
     style I fill:#005073,stroke:#fff,stroke-width:2px,color:#fff
     style J fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff

docs/versioned_docs/version-0.2.9/intro.md

@@ -58,6 +58,7 @@ Agent Kernel provides pre-built execution capabilities:
   - Messenger
   - Telegram
   - Instagram
+  - Gmail
 - **AWS Serverless Deployment** for scalable production
 - **AWS Containerized Deployment** for consistent loads
 - **MCP Server** for Model Context Protocol tool publishing
@@ -167,7 +168,7 @@ flowchart LR
     B -- Local --> C["CLI Testing"]
     B -- API --> D["REST API Server"] & G["MCP Server"] & H["A2A Server"]
     B -- Cloud --> E["AWS Serverless"] & F["AWS Containers"]
-    D -- Integration --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"]
+    D -- Integration --> I["Slack"] & J["WhatsApp"] & K["Messenger"] & M["Instagram"] & N["Telegram"] & O["Gmail"]
 
     style A fill:#2e8555,stroke:#fff,stroke-width:2px,color:#fff
     style I fill:#1ebbd7,stroke:#fff,stroke-width:2px,color:#fff