Upload folder using huggingface_hub

api/analysis_api.txt

@@ -0,0 +1,367 @@
+Analysis API
+
+
+
+Introduction
+The Analysis API lets you programmatically access Analysis's capabilities to automate and enhance your software development lifecycle. You can use the API to create custom workflows, automate tasks like bug fixing and code reviews, and embed Analysis's intelligence directly into the tools you use every day, such as Slack, Linear, and GitHub.
+
+Note: The Analysis API is in an alpha release, which means it is experimental. Be aware that we may change specifications, API keys, and definitions as we work toward stabilization. In the future, we plan to maintain at least one stable and one experimental version.
+
+Authentication
+To get started with the Analysis API, you'll need an API key.
+
+Generate Your API Key
+In the Analysis web app, go to the Settings page to create a new API key. You can have at most 3 API keys at a time.
+
+Analysis API Key creation interface
+Use Your API Key
+To authenticate your requests, pass the API key in the X-Goog-Api-Key header of your API calls.
+
+Important: Keep your API keys secure. Don't share them or embed them in public code. For your protection, any API keys found to be publicly exposed will be automatically disabled to prevent abuse.
+
+API concepts
+The Analysis API is built around a few core resources. Understanding these will help you use the API effectively.
+
+Source
+An input source for the agent (e.g., a GitHub repository). Before using a source using the API, you must first install the Analysis GitHub app through the Analysis web app.
+Session
+A continuous unit of work within a specific context, similar to a chat session. A session is initiated with a prompt and a source.
+Activity
+A single unit of work within a Session. A Session contains multiple activities from both the user and the agent, such as generating a plan, sending a message, or updating progress.
+Quickstart: Your first API call
+We'll walk through creating your first session with the Analysis API using curl.
+
+Step 1: List your available sources
+First, you need to find the name of the source you want to work with (e.g., your GitHub repo). This command will return a list of all sources you have connected to Analysis.
+
+
+curl 'https://jules.googleapis.com/v1alpha/sources' \
+    -H 'X-Goog-Api-Key: YOUR_API_KEY'
+The response will look something like this:
+
+
+{
+  "sources": [
+    {
+      "name": "sources/github/bobalover/boba",
+      "id": "github/bobalover/boba",
+      "githubRepo": {
+        "owner": "bobalover",
+        "repo": "boba"
+      }
+    }
+  ],
+  "nextPageToken": "github/bobalover/boba-web"
+}
+Step 2: Create a new session
+Now, create a new session. You'll need the source name from the previous step. This request tells Analysis to create a boba app in the specified repository.
+
+
+curl 'https://jules.googleapis.com/v1alpha/sessions' \
+    -X POST \
+    -H "Content-Type: application/json" \
+    -H 'X-Goog-Api-Key: YOUR_API_KEY' \
+    -d '{
+      "prompt": "Create a boba app!",
+      "sourceContext": {
+        "source": "sources/github/bobalover/boba",
+        "githubRepoContext": {
+          "startingBranch": "main"
+        }
+      },
+      "automationMode": "AUTO_CREATE_PR",
+      "title": "Boba App"
+    }'
+The automationMode field is optional. By default, no PR will be automatically created.
+
+The immediate response will look something like this:
+
+
+{
+        "name": "sessions/31415926535897932384",
+        "id": "31415926535897932384",
+        "title": "Boba App",
+        "sourceContext": {
+          "source": "sources/github/bobalover/boba",
+          "githubRepoContext": {
+            "startingBranch": "main"
+          }
+        },
+        "prompt": "Create a boba app!"
+      }
+You can poll the latest session information using GetSession or ListSessions. For example, if a PR was automatically created, you can see the PR in the session output.
+
+
+{
+  "name": "sessions/31415926535897932384",
+  "id": "31415926535897932384",
+  "title": "Boba App",
+  "sourceContext": {
+    "source": "sources/github/bobalover/boba",
+    "githubRepoContext": {
+      "startingBranch": "main"
+    }
+  },
+  "prompt": "Create a boba app!",
+  "outputs": [
+    {
+      "pullRequest": {
+        "url": "https://github.com/bobalover/boba/pull/35",
+        "title": "Create a boba app",
+        "description": "This change adds the initial implementation of a boba app."
+      }
+    }
+  ]
+}
+    
+By default, sessions created through the API will have their plans automatically approved. If you want to create a session that requires explicit plan approval, set the requirePlanApproval field to true.
+
+Step 3: Listing sessions
+You can list your sessions as follows.
+
+
+curl 'https://jules.googleapis.com/v1alpha/sessions?pageSize=5' \
+    -H 'X-Goog-Api-Key: YOUR_API_KEY'
+Step 4: Approve plan
+If your session requires explicit plan approval, you can approve the latest plan as follows:
+
+
+curl 'https://jules.googleapis.com/v1alpha/sessions/SESSION_ID:approvePlan' \
+    -X POST \
+    -H "Content-Type: application/json" \
+    -H 'X-Goog-Api-Key: YOUR_API_KEY'
+Step 5: Activities and interacting with the agent
+To list activities in a session:
+
+
+curl 'https://jules.googleapis.com/v1alpha/sessions/SESSION_ID/activities?pageSize=30' \
+    -H 'X-Goog-Api-Key: YOUR_API_KEY'
+To send a message to the agent:
+
+
+curl 'https://jules.googleapis.com/v1alpha/sessions/SESSION_ID:sendMessage' \
+    -X POST \
+    -H "Content-Type: application/json" \
+    -H 'X-Goog-Api-Key: YOUR_API_KEY' \
+    -d '{
+      "prompt": "Can you make the app corgi themed?"
+    }'
+The response will be empty because the agent will send its response in the next activity. To see the agent's response, list the activities again.
+Here is an example of a ListActivities response.
+
+
+{
+  "activities": [
+    {
+      "name": "sessions/14550388554331055113/activities/02200cce44f746308651037e4a18caed",
+      "createTime": "2025-10-03T05:43:42.801654Z",
+      "originator": "agent",
+      "planGenerated": {
+        "plan": {
+          "id": "5103d604240042cd9f59a4cb2355643a",
+          "steps": [
+            {
+              "id": "705a61fc8ec24a98abc9296a3956fb6b",
+              "title": "Setup the environment. I will install the dependencies to run the app."
+            },
+            {
+              "id": "bb5276efad354794a4527e9ad7c0cd42",
+              "title": "Modify `src/App.js`. I will replace the existing React boilerplate with a simple Boba-themed component. This will include a title and a list of boba options.",
+              "index": 1
+            },
+            {
+              "id": "377c9a1c91764dc794a618a06772e3d8",
+              "title": "Modify `src/App.css`. I will update the CSS to provide a fresh, modern look for the Boba app.",
+              "index": 2
+            },
+            {
+              "id": "335802b585b449aeabb855c722cd9c40",
+              "title": "Frontend Verification. I will use the `frontend_verification_instructions` tool to get instructions on how to write a Playwright script to verify the frontend application and generate a screenshot of the changes.",
+              "index": 3
+            },
+            {
+              "id": "3e4cc97c7b2448668d1ac75b8c7b7d69",
+              "title": "Submit the changes. Once the app is looking good and verified, I will submit my work.",
+              "index": 4
+            }
+          ]
+        }
+      },
+      "id": "02200cce44f746308651037e4a18caed"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/2918fac8bc54450a9cbda423b7688413",
+      "createTime": "2025-10-03T05:43:44.954030Z",
+      "originator": "user",
+      "planApproved": {
+        "planId": "5103d604240042cd9f59a4cb2355643a"
+      },
+      "id": "2918fac8bc54450a9cbda423b7688413"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/5b3acd1b3ca2439f9cbaefaccf7f709a",
+      "createTime": "2025-10-03T05:44:16.700231Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "Ran bash command",
+        "description": "Command: \nnpm install\nOutput: added 1326 packages, and audited 1327 packages in 25s\n\n268 packages are looking for fundingExit Code: 0"
+      },
+      "artifacts": [
+        {
+          "bashOutput": {
+            "command": "\nnpm install",
+            "output": "added 1326 packages, and audited 1327 packages in 25s\n\n268 packages are looking for funding"
+          }
+        }
+      ],
+      "id": "5b3acd1b3ca2439f9cbaefaccf7f709a"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/1ad545d812614a5b84c23a33f6120063",
+      "createTime": "2025-10-03T05:44:19.502115Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "I have installed the dependencies using `npm install`."
+      },
+      "artifacts": [
+        {
+          "changeSet": {
+            "source": "sources/github/bobalover/boba",
+            "gitPatch": {
+              "baseCommitId": "36ead0a4caefc451b9652ed926a15af9570f4f35"
+            }
+          }
+        }
+      ],
+      "id": "1ad545d812614a5b84c23a33f6120063"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/3a2b46329f894ebea1faf6b8fb956428",
+      "createTime": "2025-10-03T05:44:29.265425Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "I have replaced the boilerplate in `src/App.js` with a Boba-themed component."
+      },
+      "artifacts": [
+        {
+          "changeSet": {
+            "source": "sources/github/bobalover/boba",
+            "gitPatch": {
+              "unidiffPatch": "",
+              "baseCommitId": "36ead0a4caefc451b9652ed926a15af9570f4f35"
+            }
+          }
+        }
+      ],
+      "id": "3a2b46329f894ebea1faf6b8fb956428"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/4e8dd66f15e247e3ae5e48eeff89ef47",
+      "createTime": "2025-10-03T05:44:37.721013Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "I have updated the CSS in `src/App.css` to give the app a fresh, modern look."
+      },
+      "artifacts": [
+        {
+          "changeSet": {
+            "source": "sources/github/bobalover/boba",
+            "gitPatch": {
+              "unidiffPatch": ""
+            }
+          }
+        }
+      ],
+      "id": "4e8dd66f15e247e3ae5e48eeff89ef47"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/100901155a4141d3b37e8e8d2950f3b7",
+      "createTime": "2025-10-03T05:44:51.048996Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "Ran bash command",
+        "description": "Command: \nOutput: Command failed due to an internal error.\nExit Code: 1"
+      },
+      "artifacts": [
+        {
+          "bashOutput": {
+            "output": "Command failed due to an internal error.",
+            "exitCode": 1
+          }
+        }
+      ],
+      "id": "100901155a4141d3b37e8e8d2950f3b7"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/a76b35353eda42d09b1c37aedaa56047",
+      "createTime": "2025-10-03T05:47:49.628363Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "Frontend verification",
+        "description": "Agent provided UI verification."
+      },
+      "artifacts": [
+        {
+          "media": {
+            "data": "",
+            "mimeType": "image/png"
+          }
+        }
+      ],
+      "id": "a76b35353eda42d09b1c37aedaa56047"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/db089c7052024cbeb9e37b8c584bc964",
+      "createTime": "2025-10-03T05:47:53.669642Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "I have successfully verified the frontend changes by building the app, runnin...",
+        "description": "I have successfully verified the frontend changes by building the app, running a Playwright script, and inspecting the resulting screenshot."
+      },
+      "artifacts": [
+        {
+          "changeSet": {
+            "source": "sources/github/bobalover/boba",
+            "gitPatch": {
+              "unidiffPatch": "",
+              "baseCommitId": "36ead0a4caefc451b9652ed926a15af9570f4f35"
+            }
+          }
+        }
+      ],
+      "id": "db089c7052024cbeb9e37b8c584bc964"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/890e16e30dbb4bf99a92613bdccec212",
+      "createTime": "2025-10-03T05:48:14.434427Z",
+      "originator": "agent",
+      "progressUpdated": {
+        "title": "Code reviewed",
+        "description": "The user wants to create a \"boba app\". This is a very open-ended request, but the agent's implementation suggests the goal is to create a simple, static web page about boba."
+      },
+      "id": "890e16e30dbb4bf99a92613bdccec212"
+    },
+    {
+      "name": "sessions/14550388554331055113/activities/022837dbc0e940eabcc1bc53608e15fc",
+      "createTime": "2025-10-03T05:48:35.523200Z",
+      "originator": "agent",
+      "sessionCompleted": {},
+      "artifacts": [
+        {
+          "changeSet": {
+            "source": "sources/github/bobalover/boba",
+            "gitPatch": {
+              "unidiffPatch": "",
+              "baseCommitId": "36ead0a4caefc451b9652ed926a15af9570f4f35",
+              "suggestedCommitMessage": "feat: Create simple Boba App\n\nThis commit transforms the default Create React App boilerplate into a simple, visually appealing Boba-themed application."
+            }
+          }
+        }
+      ],
+      "id": "022837dbc0e940eabcc1bc53608e15fc"
+    }
+  ]
+}
+Full API reference
+View the full API reference documentation for the Analysis API.
+

app.py

@@ -158,7 +158,7 @@ except ImportError as e:
 
 # Configuration from environment variables
 GITHUB_TOKEN = os.environ.get("GITHUB_TOKEN") or os.environ.get("GITHUB_API_TOKEN") or os.environ.get("GITHUB_API_KEY")
-ANALYSIS_API_KEY = os.environ.get("JULES_API_KEY") or os.environ.get("ANALYSIS_API_KEY")
+ANALYSIS_API_KEY = os.environ.get("ANALYSIS_API_KEY") or os.environ.get("JULES_API_KEY")
 BLABLADOR_API_KEY = os.environ.get("BLABLADOR_API_KEY")
 BLABLADOR_BASE_URL = "https://api.helmholtz-blablador.fz-juelich.de/v1"
 ANALYSIS_API_URL = "https://jules.googleapis.com/v1alpha"
@@ -918,12 +918,11 @@ def render_slides(repo_full_name, branch_name, report_path):
         
         if os.path.exists(f"{output_dir}/index.html"):
             # Return IFrame pointing to the generated site. 
-            # Use absolute path with 'file/' prefix which is standard in Gradio 4+
+            # Use standard Gradio 4 /file= format with absolute path
             abspath = os.path.abspath(f"{output_dir}/index.html")
             add_log(f"Slides rendered successfully: {abspath}")
             
-            # Using 'file/' prefix with absolute path
-            return f'<iframe src="file/{abspath}" width="100%" height="600px" frameborder="0"></iframe>'
+            return f'<iframe src="/file={abspath}" width="100%" height="600px" frameborder="0"></iframe>'
         else:
             add_log(f"ERROR: mkslides finished but {output_dir}/index.html not found.")
             return "Failed to render slides: index.html not found."
@@ -1054,7 +1053,12 @@ with gr.Blocks(title="UX Analysis Orchestrator") as demo:
 
             def sl_update_reports(repo_name, branch_name):
                 reports = get_reports_in_branch(repo_name, branch_name, filter_type="slides")
-                return gr.update(choices=reports, value=reports[0] if reports else None), reports
+                default_val = None
+                if "user_experience_reports/slides" in reports:
+                    default_val = "user_experience_reports/slides"
+                elif reports:
+                    default_val = reports[0]
+                return gr.update(choices=reports, value=default_val), reports
 
             sl_repo_select.change(fn=sl_update_branches, inputs=[sl_repo_select], outputs=[sl_branch_select])
             
@@ -1079,8 +1083,23 @@ with gr.Blocks(title="UX Analysis Orchestrator") as demo:
                 return html, new_idx, counter_text
 
             sl_refresh_branches_btn.click(fn=sl_update_branches, inputs=[sl_repo_select], outputs=[sl_branch_select])
-            sl_branch_select.change(fn=sl_update_reports, inputs=[sl_repo_select, sl_branch_select], outputs=[sl_report_select, all_decks_state])
             
+            sl_branch_select.change(
+                fn=sl_update_reports, 
+                inputs=[sl_repo_select, sl_branch_select], 
+                outputs=[sl_report_select, all_decks_state]
+            ).then(
+                fn=sl_render_wrapper, 
+                inputs=[sl_repo_select, sl_branch_select, sl_report_select, sl_manual_path], 
+                outputs=[slideshow_display, carousel_controls]
+            )
+            
+            sl_report_select.change(
+                fn=sl_render_wrapper, 
+                inputs=[sl_repo_select, sl_branch_select, sl_report_select, sl_manual_path], 
+                outputs=[slideshow_display, carousel_controls]
+            )
+
             sl_render_btn.click(fn=sl_render_wrapper, inputs=[sl_repo_select, sl_branch_select, sl_report_select, sl_manual_path], outputs=[slideshow_display, carousel_controls])
             
             sl_render_all_btn.click(fn=start_carousel, inputs=[sl_repo_select, sl_branch_select, all_decks_state], outputs=[slideshow_display, carousel_controls, current_deck_idx, deck_counter])

mcp/mcp_analysis.py

@@ -0,0 +1,249 @@
+from mcp.server.fastmcp import FastMCP
+import httpx
+import os
+import logging
+import json
+import subprocess
+import asyncio
+import re
+
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("mcp-analysis")
+
+mcp = FastMCP("analysis")
+
+API_BASE_URL = "https://analysis.googleapis.com/v1alpha"
+
+class AnalysisClient:
+    def __init__(self, api_key: str):
+        self.api_key = api_key
+        self.base_url = API_BASE_URL
+        self.headers = {
+            "Content-Type": "application/json",
+            "x-goog-api-key": self.api_key
+        }
+
+    async def _request(self, method: str, path: str, **kwargs):
+        # Handle session_id prefixing
+        if path.startswith("/sessions/sessions/"):
+            path = path.replace("/sessions/sessions/", "/sessions/")
+
+        url = f"{self.base_url}{path}"
+        async with httpx.AsyncClient() as client:
+            response = await client.request(method, url, headers=self.headers, **kwargs)
+            if response.status_code not in (200, 204):
+                logger.error(f"Jules API Error ({method} {path}): {response.status_code} - {response.text}")
+            response.raise_for_status()
+            return response.json() if response.text else {}
+
+    async def list_sources(self):
+        return await self._request("GET", "/sources")
+
+    async def get_source(self, name: str):
+        if not name.startswith("sources/"): name = f"sources/{name}"
+        return await self._request("GET", f"/{name}")
+
+    async def create_session(self, prompt, source, branch="main", title="API Session", automation="AUTO_CREATE_PR"):
+        # Format source for API if it is just owner/repo
+        if "/" in source and "sources/github/" not in source:
+             source = f"sources/github/{source}"
+
+        payload = {
+            "prompt": prompt,
+            "sourceContext": {
+                "source": source,
+                "githubRepoContext": {"startingBranch": branch}
+            }
+        }
+        if title: payload["title"] = title
+        if automation: payload["automationMode"] = automation
+
+        logger.info(f"Creating session with payload: {json.dumps(payload)}")
+        try:
+            return await self._request("POST", "/sessions", json=payload)
+        except Exception as e:
+            err_msg = str(e).lower()
+            if "maximum number of sessions" in err_msg or "max sessions reached" in err_msg or "400" in err_msg:
+                logger.warning(f"Possible quota/session limit error detected: {e}. Triggering early key rotation.")
+                force_rotate_key()
+                return {"error": f"Session creation failed: {e}. API key has been rotated. Please retry."}
+
+            logger.warning(f"REST API create_session failed: {e}. Falling back to CLI.")
+            cli_source = source.replace("sources/github/", "")
+            return await self.create_session_cli(prompt, cli_source, branch, title)
+
+    async def create_session_cli(self, prompt, source, branch="main", title="API Session"):
+        """Fallback to analysis CLI for session creation."""
+        logger.info(f"Using analysis CLI to create session for {source}")
+        cmd = [
+            "analysis", "new",
+            "--repo", source,
+            prompt
+        ]
+        env = os.environ.copy()
+        env["JULES_API_KEY"] = self.api_key
+        npm_bin = subprocess.check_output(["npm", "config", "get", "prefix"]).decode().strip() + "/bin"
+        env["PATH"] = f"{env.get('PATH', '')}:{npm_bin}"
+
+        try:
+            process = await asyncio.create_subprocess_exec(
+                *cmd, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE, env=env
+            )
+            stdout, stderr = await process.communicate()
+            output = stdout.decode().strip()
+            match = re.search(r'sessions/(\d+)', output)
+            if match:
+                s_id = match.group(0)
+                return {"name": s_id, "id": match.group(1)}
+            return {"output": output}
+        except:
+            return {"error": "CLI failed"}
+
+    async def get_session(self, session_id):
+        session_id = str(session_id).strip()
+        if not session_id.startswith("sessions/"): session_id = f"sessions/{session_id}"
+        return await self._request("GET", f"/{session_id}")
+
+    async def list_sessions(self, page_size=30):
+        return await self._request("GET", "/sessions", params={"pageSize": page_size})
+
+    async def send_message(self, session_id, prompt):
+        session_id = str(session_id).strip()
+        if not session_id.startswith("sessions/"): session_id = f"sessions/{session_id}"
+        return await self._request("POST", f"/{session_id}:sendMessage", json={"prompt": prompt})
+
+    async def approve_plan(self, session_id):
+        session_id = str(session_id).strip()
+        if not session_id.startswith("sessions/"): session_id = f"sessions/{session_id}"
+        return await self._request("POST", f"/{session_id}:approvePlan", json={})
+
+    async def get_activity(self, name: str):
+        name = str(name).strip()
+        return await self._request("GET", f"/{name}")
+
+    async def list_activities(self, session_id, page_size=50):
+        session_id = str(session_id).strip()
+        if not session_id.startswith("sessions/"): session_id = f"sessions/{session_id}"
+        return await self._request("GET", f"/{session_id}/activities", params={"pageSize": page_size})
+
+# API Key Rotation State
+REQUEST_COUNT = 0
+CURRENT_KEY_INDEX = 0
+
+def force_rotate_key():
+    """Immediately switch to the next available API key and reset counter."""
+    global REQUEST_COUNT, CURRENT_KEY_INDEX
+    keys = [os.environ.get("JULES_API_KEY"), os.environ.get("JULES_API_KEY_FALLBACK")]
+    keys = [k for k in keys if k]
+    if len(keys) > 1:
+        CURRENT_KEY_INDEX = (CURRENT_KEY_INDEX + 1) % len(keys)
+        REQUEST_COUNT = 0
+        logger.info(f"FORCE ROTATION: Switched to Jules API Key index {CURRENT_KEY_INDEX}")
+
+def get_rotated_api_key():
+    global REQUEST_COUNT, CURRENT_KEY_INDEX
+    keys = [os.environ.get("JULES_API_KEY"), os.environ.get("JULES_API_KEY_FALLBACK")]
+    # Filter out None or empty keys
+    keys = [k for k in keys if k]
+    if not keys:
+        logger.error("No Jules API keys found in environment.")
+        return None
+
+    key = keys[CURRENT_KEY_INDEX]
+
+    REQUEST_COUNT += 1
+    if REQUEST_COUNT >= 3:
+        REQUEST_COUNT = 0
+        old_index = CURRENT_KEY_INDEX
+        CURRENT_KEY_INDEX = (CURRENT_KEY_INDEX + 1) % len(keys)
+        if len(keys) > 1 and old_index != CURRENT_KEY_INDEX:
+            logger.info(f"Requests per key reached. Rotating Jules API Key from index {old_index} to {CURRENT_KEY_INDEX}")
+
+    return key
+
+def get_client():
+    key = get_rotated_api_key()
+    return AnalysisClient(key)
+
+@mcp.tool()
+async def list_sources():
+    """List all available sources (repositories)."""
+    return await get_client().list_sources()
+
+@mcp.tool()
+async def get_source(name: str):
+    """
+    Get details about a specific source.
+    :param name: The source name (e.g., 'sources/github/owner/repo').
+    """
+    return await get_client().get_source(name)
+
+@mcp.tool()
+async def create_session(
+    prompt: str,
+    source: str,
+    branch: str = "main",
+    title: str = "API Session",
+    automation_mode: str = "AUTO_CREATE_PR"
+):
+    """
+    Initialize a new autonomous coding session for a repository.
+
+    Args:
+        prompt: The implementation task or instructions for Jules.
+        source: Source repository path (e.g., 'sources/github/owner/repo').
+        branch: The branch to use.
+        title: Title for the session.
+        automation_mode: Defaults to 'AUTO_CREATE_PR'.
+    """
+    return await get_client().create_session(prompt, source, branch, title, automation_mode)
+
+@mcp.tool()
+async def get_session(session_id: str):
+    """
+    Get the current status and details of a session.
+    :param session_id: The session ID (e.g., 'sessions/123').
+    """
+    return await get_client().get_session(session_id)
+
+@mcp.tool()
+async def list_sessions(page_size: int = 30):
+    """List recent Jules sessions."""
+    return await get_client().list_sessions(page_size)
+
+@mcp.tool()
+async def send_message(session_id: str, prompt: str):
+    """
+    Send a message or feedback to an existing session.
+    :param session_id: The session ID (e.g., 'sessions/123').
+    :param prompt: The message/instruction text.
+    """
+    return await get_client().send_message(session_id, prompt)
+
+@mcp.tool()
+async def approve_plan(session_id: str):
+    """
+    Approve the implementation plan for a session.
+    :param session_id: The session ID.
+    """
+    return await get_client().approve_plan(session_id)
+
+@mcp.tool()
+async def get_activity(name: str):
+    """
+    Get details about a specific activity.
+    :param name: Activity resource name (e.g., 'sessions/123/activities/456').
+    """
+    return await get_client().get_activity(name)
+
+@mcp.tool()
+async def list_activities(session_id: str, page_size: int = 50):
+    """
+    List activities for a specific session.
+    :param session_id: The session ID.
+    :param page_size: Number of activities to return.
+    """
+    return await get_client().list_activities(session_id, page_size)
+
+if __name__ == "__main__": mcp.run()

mcp/servers.txt

@@ -765,16 +765,16 @@ Hugging Face logo
 Hugging Face
 
 
-Jules API
+Analysis API
 
 Authentication
 
-To get started with the Jules REST API, you’ll need an API key.
+To get started with the Analysis REST API, you’ll need an API key.
 Generate Your API Key
 
-In the Jules web app, go to the Settings page to create a new API key. You can have at most 3 API keys at a time.
+In the Analysis web app, go to the Settings page to create a new API key. You can have at most 3 API keys at a time.
 
-Jules REST API Key creation interface
+Analysis REST API Key creation interface
 Use Your API Key
 
 To authenticate your requests, pass the API key in the X-Goog-Api-Key header of your API calls.
@@ -782,19 +782,19 @@ To authenticate your requests, pass the API key in the X-Goog-Api-Key header of
 Keep your API keys secure. Don’t share them or embed them in public code. For your protection, any API keys found to be publicly exposed will be automatically disabled to prevent abuse.
 API concepts
 
-The Jules REST API is built around a few core resources. Understanding these will help you use the API effectively.
+The Analysis REST API is built around a few core resources. Understanding these will help you use the API effectively.
 
-    Source — An input source for the agent (e.g., a GitHub repository). Before using a source using the API, you must first install the Jules GitHub app through the Jules web app.
+    Source — An input source for the agent (e.g., a GitHub repository). Before using a source using the API, you must first install the Analysis GitHub app through the Analysis web app.
     Session — A continuous unit of work within a specific context, similar to a chat session. A session is initiated with a prompt and a source.
     Activity — A single unit of work within a Session. A Session contains multiple activities from both the user and the agent, such as generating a plan, sending a message, or updating progress.
 
 Your first API call
 
-We’ll walk through creating your first session with the Jules REST API using curl.
+We’ll walk through creating your first session with the Analysis REST API using curl.
 
     List your available sources
 
-First, you need to find the name of the source you want to work with (e.g., your GitHub repo). This command will return a list of all sources you have connected to Jules.
+First, you need to find the name of the source you want to work with (e.g., your GitHub repo). This command will return a list of all sources you have connected to Analysis.
 
 curl -H "x-goog-api-key: $JULES_API_KEY" \
   https://jules.googleapis.com/v1alpha/sources
@@ -817,7 +817,7 @@ The response will look something like this:
 
 Create a new session
 
-Now, create a new session. You’ll need the source name from the previous step. This request tells Jules to create a boba app in the specified repository.
+Now, create a new session. You’ll need the source name from the previous step. This request tells Analysis to create a boba app in the specified repository.
 
 curl 'https://jules.googleapis.com/v1alpha/sessions' \
   -X POST \
@@ -915,7 +915,7 @@ The response will be empty because the agent will send its response in the next
 
 Sessions
 
-Sessions are the core resource in the Jules REST API. A session represents a unit of work where Jules executes a coding task on your repository.
+Sessions are the core resource in the Analysis REST API. A session represents a unit of work where Analysis executes a coding task on your repository.
 Create a Session
 POST
 /v1alpha/sessions
@@ -925,7 +925,7 @@ Request Body
 prompt
 required string
 
-The task description for Jules to execute.
+The task description for Analysis to execute.
 title
 string
 
@@ -1078,7 +1078,7 @@ POST
 
 Sends a message from the user to an active session.
 
-Use this endpoint to provide feedback, answer questions, or give additional instructions to Jules during an active session.
+Use this endpoint to provide feedback, answer questions, or give additional instructions to Analysis during an active session.
 Path Parameters
 session
 required string path
@@ -1134,10 +1134,10 @@ Session States
 Sessions progress through the following states:
 State	Description
 QUEUED	Session is waiting to be processed
-PLANNING	Jules is analyzing the task and creating a plan
+PLANNING	Analysis is analyzing the task and creating a plan
 AWAITING_PLAN_APPROVAL	Plan is ready and waiting for user approval
-AWAITING_USER_FEEDBACK	Jules needs additional input from the user
-IN_PROGRESS	Jules is actively working on the task
+AWAITING_USER_FEEDBACK	Analysis needs additional input from the user
+IN_PROGRESS	Analysis is actively working on the task
 PAUSED	Session is paused
 COMPLETED	Task completed successfully
 FAILED	Task failed to complete
@@ -1262,7 +1262,7 @@ Activity Types
 Activities have different types based on what occurred. Each activity will have exactly one of these event fields populated:
 Plan Generated
 
-Indicates Jules has created a plan for the task:
+Indicates Analysis has created a plan for the task:
 
 {
   "planGenerated": {
@@ -1298,7 +1298,7 @@ A message from the user:
 
 Agent Messaged
 
-A message from Jules:
+A message from Analysis:
 
 {
   "agentMessaged": {
@@ -1384,9 +1384,9 @@ Media
 
 Sources
 
-Sources represent repositories connected to Jules. Currently, Jules supports GitHub repositories. Use the Sources API to list available repositories and get details about specific sources.
+Sources represent repositories connected to Analysis. Currently, Analysis supports GitHub repositories. Use the Sources API to list available repositories and get details about specific sources.
 
-Sources are created when you connect a GitHub repository to Jules through the web interface. The API currently only supports reading sources, not creating them.
+Sources are created when you connect a GitHub repository to Analysis through the web interface. The API currently only supports reading sources, not creating them.
 List Sources
 GET
 /v1alpha/sources
@@ -1527,11 +1527,11 @@ Next
 Types 
 
 
-This page documents all data types used in the Jules REST API.
+This page documents all data types used in the Analysis REST API.
 Core Resources
 Session
 
-A session represents a unit of work where Jules executes a coding task.
+A session represents a unit of work where Analysis executes a coding task.
 Session
 
 A session is a contiguous amount of work within the same context.
@@ -1546,7 +1546,7 @@ Output only. The session ID.
 prompt
 required string
 
-The task description for Jules to execute.
+The task description for Analysis to execute.
 title
 string
 
@@ -1558,7 +1558,7 @@ Output only. Current state of the session.
 url
 string
 
-Output only. URL to view the session in the Jules web app.
+Output only. URL to view the session in the Analysis web app.
 sourceContext
 required SourceContext
 
@@ -1589,10 +1589,10 @@ Enum representing the current state of a session:
 Value	Description
 STATE_UNSPECIFIED	State is unspecified
 QUEUED	Session is waiting to be processed
-PLANNING	Jules is creating a plan
+PLANNING	Analysis is creating a plan
 AWAITING_PLAN_APPROVAL	Plan is ready for user approval
-AWAITING_USER_FEEDBACK	Jules needs user input
-IN_PROGRESS	Jules is actively working
+AWAITING_USER_FEEDBACK	Analysis needs user input
+IN_PROGRESS	Analysis is actively working
 PAUSED	Session is paused
 FAILED	Session failed
 COMPLETED	Session completed successfully
@@ -1647,7 +1647,7 @@ The user posted a message.
 agentMessaged
 AgentMessaged
 
-Jules posted a message.
+Analysis posted a message.
 progressUpdated
 ProgressUpdated
 
@@ -1682,7 +1682,7 @@ Plans
 Plan
 Plan
 
-A sequence of steps that Jules will take to complete the task.
+A sequence of steps that Analysis will take to complete the task.
 id
 string
 
@@ -1895,7 +1895,7 @@ The message content.
 AgentMessaged
 AgentMessaged
 
-Jules posted a message.
+Analysis posted a message.
 agentMessage
 string