Fix Linear Webhooks and other examples

codegen-examples/examples/linear_webhooks/.env.template

@@ -1,3 +1,3 @@
 LINEAR_ACCESS_TOKEN="..."
 LINEAR_SIGNING_SECRET="..."
-LINEAR_TEAM_ID="..."
+LINEAR_TEAM_ID="e30439bb-1547-4d4e-9934-eb757c9beb46"  # Zeeeepa team ID

codegen-examples/examples/linear_webhooks/README.md

@@ -0,0 +1,110 @@
+# Linear Webhooks Example
+
+This example demonstrates how to set up a webhook endpoint to receive events from Linear using Codegen.
+
+## Setup
+
+### Prerequisites
+
+- Python 3.10+
+- Linear account with API access
+- (Optional) ngrok or similar tool for exposing local endpoints
+
+### Installation
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/codegen-sh/codegen.git
+   cd codegen/codegen-examples/examples/linear_webhooks
+   ```
+
+2. Create a virtual environment:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+   ```
+
+3. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+4. Create a `.env` file from the template:
+   ```bash
+   cp .env.template .env
+   ```
+
+5. Edit the `.env` file with your Linear credentials:
+   ```
+   LINEAR_ACCESS_TOKEN="your_linear_access_token"
+   LINEAR_SIGNING_SECRET="your_linear_signing_secret"
+   LINEAR_TEAM_ID="e30439bb-1547-4d4e-9934-eb757c9beb46"  # Zeeeepa team ID
+   ```
+
+## Running the Example
+
+### Standalone Version (No Modal)
+
+Run the standalone version with:
+
+```bash
+python standalone.py
+```
+
+This will start a FastAPI server on http://0.0.0.0:8000.
+
+To expose your local server to the internet (required for Linear webhooks), you can use ngrok:
+
+```bash
+ngrok http 8000
+```
+
+Then configure your Linear webhook to point to the ngrok URL + `/linear/events` (e.g., `https://your-ngrok-url.ngrok.io/linear/events`).
+
+### Modal Version (Serverless)
+
+To deploy the Modal version:
+
+1. Install Modal:
+   ```bash
+   pip install modal
+   ```
+
+2. Set up your Modal account:
+   ```bash
+   modal token new
+   ```
+
+3. Deploy the app:
+   ```bash
+   modal deploy webhooks.py
+   ```
+
+Modal will provide a URL that you can use as your webhook endpoint in Linear.
+
+## Configuring Linear Webhooks
+
+1. Go to your Linear workspace settings
+2. Navigate to API → Webhooks
+3. Click "Create webhook"
+4. Enter your webhook URL (ngrok URL or Modal URL)
+5. Select the events you want to receive (e.g., Issues)
+6. Save the webhook
+
+## Troubleshooting
+
+- **Import Error**: If you get an import error for `codegen`, make sure you've installed it with `pip install codegen>=0.22.2`
+- **Authentication Error**: Verify your Linear credentials in the `.env` file
+- **Webhook Not Receiving Events**: Check that your ngrok URL is correct and that the Linear webhook is properly configured
+
+## Customizing the Example
+
+To handle different Linear events, modify the `@app.linear.event()` decorator in `webhooks.py` or add a new handler in `standalone.py`.
+
+For example, to handle Project events:
+
+```python
+@app.linear.event("Project")
+def handle_project(self, data: dict):
+    print(f"Project event: {data}")
+```

codegen-examples/examples/linear_webhooks/requirements.txt

@@ -0,0 +1,4 @@
+fastapi>=0.95.0
+uvicorn>=0.22.0
+python-dotenv>=1.0.0
+codegen>=0.22.2

codegen-examples/examples/linear_webhooks/standalone.py

@@ -0,0 +1,38 @@
+import os
+from dotenv import load_dotenv
+from fastapi import FastAPI, Request
+import uvicorn
+from codegen.extensions.events.codegen_app import CodegenApp
+
+# Load environment variables from .env file
+load_dotenv()
+
+# Initialize the CodegenApp
+app = CodegenApp(name="test-linear")
+
+# Create a FastAPI app
+fastapi_app = app.app
+
+@fastapi_app.post("/linear/events")
+async def handle_linear_event(request: Request):
+    """Handle incoming Linear events."""
+    payload = await request.json()
+    print(f"Received Linear event: {payload}")
+    return await app.linear.handle(payload)
+
+# Verify required environment variables
+required_vars = ["LINEAR_ACCESS_TOKEN", "LINEAR_SIGNING_SECRET", "LINEAR_TEAM_ID"]
+missing_vars = [var for var in required_vars if not os.getenv(var)]
+
+if missing_vars:
+    print(f"Error: Missing required environment variables: {', '.join(missing_vars)}")
+    print("Please create a .env file with the following variables:")
+    print("\n".join([f"{var}=\"your_{var.lower()}\"" for var in required_vars]))
+    exit(1)
+
+if __name__ == "__main__":
+    print("Starting Linear webhook server...")
+    print("Listening for Linear events at: http://0.0.0.0:8000/linear/events")
+    print("Use a tool like ngrok to expose this endpoint to the internet.")
+    print("Then configure your Linear webhook to point to: https://your-ngrok-url/linear/events")
+    uvicorn.run(fastapi_app, host="0.0.0.0", port=8000)

codegen-examples/examples/linear_webhooks/webhooks.py

@@ -1,9 +1,9 @@
 import modal.running_app
-from codegen.extensions.events.app import CodegenApp
+from codegen.extensions.events.codegen_app import CodegenApp
 import modal
 
 image = modal.Image.debian_slim(python_version="3.13").apt_install("git").pip_install("fastapi[standard]", "codegen>=v0.22.2")
-app = CodegenApp(name="test-linear", modal_api_key="", image=image)
+app = CodegenApp(name="test-linear")
 
 # Here is an example implementation of setting up an endpoint for receiving webhook events from Linear.
 # The @app.linear.event() decorator takes care of subscribing to the webhook and also unsubscribing when the deployment spun

codegen-examples/examples/pr_review_bot/app.py

@@ -1,7 +1,7 @@
 import logging
 from logging import getLogger
 import modal
-from codegen.extensions.events.app import CodegenApp
+from codegen.extensions.events.codegen_app import CodegenApp
 from fastapi import Request
 from codegen.extensions.github.types.events.pull_request import PullRequestLabeledEvent, PullRequestUnlabeledEvent
 from helpers import remove_bot_comments, pr_review_agent
@@ -26,7 +26,7 @@
     )
 )
 
-app = CodegenApp(name="github", image=base_image, modal_api_key="")
+app = CodegenApp(name="github")
 
 
 @app.github.event("pull_request:labeled")

codegen-examples/examples/ticket-to-pr/app.py

@@ -1,6 +1,6 @@
 from codegen import Codebase, CodeAgent
 from codegen.extensions.clients.linear import LinearClient
-from codegen.extensions.events.app import CodegenApp
+from codegen.extensions.events.codegen_app import CodegenApp
 from codegen.extensions.tools.github.create_pr import create_pr
 from codegen.shared.enums.programming_language import ProgrammingLanguage
 from helpers import create_codebase, format_linear_message, has_codegen_label, process_update_event
@@ -17,7 +17,7 @@
 
 image = modal.Image.debian_slim(python_version="3.13").apt_install("git").pip_install("fastapi[standard]", "codegen==v0.26.3")
 
-app = CodegenApp("linear-bot", image=image, modal_api_key="")
+app = CodegenApp("linear-bot")
 
 
 @app.cls(secrets=[modal.Secret.from_dotenv()], keep_warm=1)