Remove session URLs from SDK (#7374)

These links don't work anymore. Two users have emailed us in the past
week due to confusion about them. This PR removes them from our SDK and
MCP code, as well as from our documentation.

Once we have a way to view SDK sessions within the app, we can add
expose session URLs again.

Sourced from commit ec00176767da07586db37fa57d05083cac141b3e

Author: rgambee

.env.example

@@ -4,5 +4,3 @@ FUTURESEARCH_API_KEY=
 
 # Optional: API base URL (defaults to https://futuresearch.ai/api/v0/)
 # FUTURESEARCH_API_URL=https://futuresearch.ai/api/v0/
-# Optional: App base URL (defaults to https://futuresearch.ai/)
-# FUTURESEARCH_APP_URL=https://futuresearch.ai/

README.md

@@ -163,13 +163,14 @@ The same API researches, cleans, and joins datasets, which is often how a foreca
 
 ## Sessions
 
-You can also use a session to output a URL to see the research and data processing in the [futuresearch.ai/app](https://futuresearch.ai/app) application, which streams the research and makes charts. Or you can use it purely as an intelligent data utility, and [chain intelligent pandas operations](https://futuresearch.ai/docs/chaining-operations) with normal pandas operations where LLMs are used to process every row.
+Group related operations into a session so their tasks are tracked together. You can also use FutureSearch purely as an intelligent data utility, and [chain intelligent pandas operations](https://futuresearch.ai/docs/chaining-operations) with normal pandas operations where LLMs are used to process every row.
 
 ```python
 from futuresearch import create_session
 
 async with create_session(name="My Session") as session:
-    print(f"View session at: {session.get_url()}")
+    # All operations here share the same session
+    ...
 ```
 
 ### Async operations

futuresearch-mcp/README.md

@@ -52,7 +52,7 @@ Alternatively, install with pip (ideally in a venv) and use `"command": "futures
 
 All operations follow an async pattern:
 
-1. **Start** - Call an operation tool (e.g., `futuresearch_agent`) to start a task. Returns immediately with a task ID and session URL.
+1. **Start** - Call an operation tool (e.g., `futuresearch_agent`) to start a task. Returns immediately with a task ID.
 2. **Monitor** - Call `futuresearch_progress(task_id)` repeatedly to check status. The tool blocks ~12s to limit the polling rate.
 3. **Retrieve** - Once complete, call `futuresearch_results(task_id, output_path)` to save results to CSV.
 

futuresearch-mcp/src/futuresearch_mcp/templates.py

@@ -177,9 +177,6 @@
 .done-banner .banner-text{flex:1}
 .done-banner .banner-close{background:none;border:none;color:#fff;font-size:18px;cursor:pointer;padding:0 4px;line-height:1;opacity:.8}
 .done-banner .banner-close:hover{opacity:1}
-.session-link{margin-bottom:6px;font-size:11px;display:flex;align-items:center;gap:8px}
-.session-link a{font-weight:500}
-.session-link .spacer{flex:1}
 .col-resize-handle{position:absolute;top:0;right:-2px;width:4px;height:100%;cursor:col-resize;z-index:5;user-select:none}
 .col-resize-handle:hover{background:var(--accent);opacity:.3}
 body.col-resizing,body.col-resizing *{cursor:col-resize!important;user-select:none!important}
@@ -336,7 +333,7 @@
 let forecastMeta=null;
 let forecastRows=null;
 
-let sessionUrl="",csvUrl="",pollToken="",downloadUrl="";
+let csvUrl="",pollToken="",downloadUrl="";
 const TRUNC=200;
 let didDrag=false;
 const copyFmt="csv";
@@ -559,13 +556,11 @@
       /* Forecast tasks get the card grid; the table is hidden. */
       showForecastUI();
       renderForecastCards(Array.isArray(data)?data:[data]);
-      updateSessionLink();
       switchTab("results");
     }else{
       /* All other operation types keep the original table UI. */
       showResultsUI();
       processData(data);
-      updateSessionLink();
       switchTab("results");
     }
     /* NOTE: we deliberately do NOT call app.sendMessage() or
@@ -1031,7 +1026,6 @@
   activityTab.style.display="block";
   resultsTab.style.display="none";
   forecastTab.style.display="none";
-  sessionUrl=d.session_url||sessionUrl;
   if(d.task_id)currentTaskId=d.task_id;
   /* Extract task_id from progress_url as fallback */
   if(!currentTaskId&&d.progress_url){const m=d.progress_url.match(/progress\\/([0-9a-f-]+)/);if(m)currentTaskId=m[1];}
@@ -1579,7 +1573,7 @@
   }
   return csvUrl;
 }
-function updateDownloadLink(){updateSessionLink();}
+function updateDownloadLink(){}
 document.getElementById("exportLink")?.addEventListener("click",()=>{
   const url=getDownloadUrl();
   if(!url){showToast("No download link yet");return;}
@@ -1623,7 +1617,6 @@
   document.removeEventListener("mouseup",onRowResizeUp);
 }
 
-function updateSessionLink(){}
 
 /* --- data loading (for standalone results entry) --- */
 async function fetchFullResultsWithFreshToken(hasPreview,total){
@@ -1750,7 +1743,6 @@
     const isWidget=meta.fetch_full_results||meta.preview||Array.isArray(meta);
     if(!isWidget)return;
     showResultsUI();
-    if(meta.session_url&&!sessionUrl){sessionUrl=meta.session_url;updateSessionLink();}
     if(meta.poll_token){pollToken=meta.poll_token;}
     if(meta.download_url){downloadUrl=meta.download_url;}
     if(meta.csv_url){csvUrl=meta.csv_url;updateDownloadLink();}

futuresearch-mcp/src/futuresearch_mcp/tools.py

@@ -1630,7 +1630,7 @@ async def futuresearch_list_sessions(
 ) -> list[TextContent]:
     """List futuresearch sessions owned by the authenticated user (paginated).
 
-    Returns session names, IDs, timestamps, and dashboard URLs.
+    Returns session names, IDs, and timestamps.
     Use this to find past sessions or check what's been run.
     Results are paginated — 25 sessions per page by default.
     """
@@ -1676,8 +1676,7 @@ async def futuresearch_list_sessions(
         lines.append(
             f"- **{s.name}** (id: {s.session_id})\n"
             f"  Created: {s.created_at:%Y-%m-%d %H:%M UTC} | "
-            f"Updated: {s.updated_at:%Y-%m-%d %H:%M UTC}\n"
-            f"  URL: {s.get_url()}"
+            f"Updated: {s.updated_at:%Y-%m-%d %H:%M UTC}"
         )
 
     has_more = (result.offset + result.limit) < result.total

futuresearch-mcp/tests/test_server.py

@@ -163,9 +163,6 @@ def _make_mock_session(session_id=None):
     """Create a mock Session."""
     session = MagicMock()
     session.session_id = session_id or uuid4()
-    session.get_url.return_value = (
-        f"https://futuresearch.ai/sessions/{session.session_id}"
-    )
     return session
 
 
@@ -677,14 +674,12 @@ async def test_list_sessions_returns_sessions(self):
                 name="My Session",
                 created_at=datetime(2025, 6, 1, 12, 0, tzinfo=UTC),
                 updated_at=datetime(2025, 6, 1, 13, 0, tzinfo=UTC),
-                get_url=lambda: "https://futuresearch.ai/sessions/abc",
             ),
             MagicMock(
                 session_id=uuid4(),
                 name="Another Session",
                 created_at=datetime(2025, 6, 2, 10, 0, tzinfo=UTC),
                 updated_at=datetime(2025, 6, 2, 11, 0, tzinfo=UTC),
-                get_url=lambda: "https://futuresearch.ai/sessions/def",
             ),
         ]
 
@@ -746,8 +741,8 @@ async def test_list_sessions_passes_client_and_pagination(self):
         mock_ls.assert_called_once_with(client=mock_client, offset=5, limit=10)
 
     @pytest.mark.asyncio
-    async def test_list_sessions_output_contains_urls_and_dates(self):
-        """Test that the formatted output includes URLs and timestamps."""
+    async def test_list_sessions_output_contains_dates(self):
+        """Test that the formatted output includes timestamps."""
         mock_client = _make_mock_client()
         ctx = make_test_context(mock_client)
         session_id = uuid4()
@@ -757,7 +752,6 @@ async def test_list_sessions_output_contains_urls_and_dates(self):
                 name="Pipeline Run",
                 created_at=datetime(2025, 8, 15, 9, 30, tzinfo=UTC),
                 updated_at=datetime(2025, 8, 15, 10, 45, tzinfo=UTC),
-                get_url=lambda: f"https://futuresearch.ai/sessions/{session_id}",
             ),
         ]
 
@@ -772,7 +766,6 @@ async def test_list_sessions_output_contains_urls_and_dates(self):
         assert "Pipeline Run" in text
         assert "2025-08-15 09:30 UTC" in text
         assert "2025-08-15 10:45 UTC" in text
-        assert f"https://futuresearch.ai/sessions/{session_id}" in text
 
     @pytest.mark.asyncio
     async def test_list_sessions_pagination_params(self):
@@ -803,7 +796,6 @@ async def test_list_sessions_shows_pagination_info(self):
                 name=f"Session {i}",
                 created_at=now,
                 updated_at=now,
-                get_url=lambda: "https://futuresearch.ai/sessions/x",
             )
             for i in range(10)
         ]

skills/futuresearch-python/SKILL.md

@@ -644,18 +644,16 @@ Parameters: `task`, `input`, `effort_level` (LOW/MEDIUM/HIGH), `response_model`,
 
 ## Explicit Sessions
 
-For multiple operations or when you need visibility into progress, use an explicit session:
+For multiple operations that should be grouped together, use an explicit session:
 
 ```python
 from futuresearch import create_session
 
 async with create_session(name="My Session") as session:
-    print(f"View session at: {session.get_url()}")
     # All operations here share the same session
+    ...
 ```
 
-Sessions are visible on the futuresearch.ai dashboard.
-
 ## Async Operations
 
 All operations have `_async` variants for background processing. These need an explicit session since the task persists beyond the function call:
@@ -691,11 +689,10 @@ df = await fetch_task_data("12345678-1234-1234-1234-123456789abc")
 FutureSearch operations (classify, rank, dedupe, merge, forecast, agent) take 1-10+ minutes.
 All MCP tools use an async pattern:
 
-1. Call the operation tool (e.g., `futuresearch_agent(...)`) to get task_id and session_url
-2. Share session_url with the user
-3. Call futuresearch_progress(task_id) — the tool handles pacing internally
-4. After each status update, immediately call futuresearch_progress again
-5. When status is "completed" or "failed", call futuresearch_results(task_id)
+1. Call the operation tool (e.g., `futuresearch_agent(...)`) to get a task_id
+2. Call futuresearch_progress(task_id) — the tool handles pacing internally
+3. After each status update, immediately call futuresearch_progress again
+4. When status is "completed" or "failed", call futuresearch_results(task_id)
 
 ## Chaining Operations
 

src/futuresearch/constants.py

@@ -1,7 +1,6 @@
 import warnings
 from typing import Any
 
-DEFAULT_FUTURESEARCH_APP_URL = "https://futuresearch.ai"
 DEFAULT_FUTURESEARCH_API_URL = "https://futuresearch.ai/api/v0"
 
 

src/futuresearch/session.py

@@ -1,12 +1,10 @@
-import os
 from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from dataclasses import dataclass
 from datetime import datetime
 from uuid import UUID
 
 from futuresearch.api_utils import create_client
-from futuresearch.constants import DEFAULT_FUTURESEARCH_APP_URL
 from futuresearch.errors import _call_and_check
 from futuresearch.generated.api.sessions import (
     create_session_endpoint_sessions_post,
@@ -18,13 +16,6 @@
 from futuresearch.generated.models.update_session import UpdateSession
 
 
-def get_session_url(session_id: UUID) -> str:
-    base_url = (
-        os.environ.get("FUTURESEARCH_APP_URL") or DEFAULT_FUTURESEARCH_APP_URL
-    ).rstrip("/")
-    return f"{base_url}/sessions/{session_id}"
-
-
 @dataclass
 class SessionInfo:
     """Summary of an existing session."""
@@ -34,10 +25,6 @@ class SessionInfo:
     created_at: datetime
     updated_at: datetime
 
-    def get_url(self) -> str:
-        """Get the URL to view this session in the web interface."""
-        return get_session_url(self.session_id)
-
 
 @dataclass
 class SessionListResult:
@@ -56,10 +43,6 @@ def __init__(self, client: AuthenticatedClient, session_id: UUID):
         self.client = client
         self.session_id = session_id
 
-    def get_url(self) -> str:
-        """Get the URL to view this session in the web interface."""
-        return get_session_url(self.session_id)
-
 
 @asynccontextmanager
 async def create_session(

tests/test_session.py

@@ -18,7 +18,6 @@
     SessionInfo,
     SessionListResult,
     create_session,
-    get_session_url,
     list_sessions,
 )
 
@@ -31,7 +30,6 @@ def _wrap(parsed: Any, status_code: HTTPStatus = HTTPStatus.OK) -> Response[Any]
 @pytest.fixture(autouse=True)
 def mock_env(monkeypatch):
     monkeypatch.setenv("FUTURESEARCH_API_KEY", "test-key")
-    monkeypatch.setenv("FUTURESEARCH_APP_URL", "https://futuresearch.ai")
 
 
 # --- SessionInfo ---
@@ -47,31 +45,6 @@ def test_fields(self):
         assert info.created_at == now
         assert info.updated_at == now
 
-    def test_get_url(self):
-        sid = uuid.uuid4()
-        now = datetime.now(UTC)
-        info = SessionInfo(session_id=sid, name="Test", created_at=now, updated_at=now)
-        assert info.get_url() == get_session_url(sid)
-        assert str(sid) in info.get_url()
-
-
-class TestGetSessionUrl:
-    def test_honours_futuresearch_app_url(self, monkeypatch):
-        monkeypatch.setenv("FUTURESEARCH_APP_URL", "https://new.example.com")
-        sid = uuid.uuid4()
-        assert get_session_url(sid) == f"https://new.example.com/sessions/{sid}"
-
-    def test_ignores_removed_legacy_app_url(self, monkeypatch):
-        monkeypatch.delenv("FUTURESEARCH_APP_URL", raising=False)
-        monkeypatch.setenv("EVERYROW_APP_URL", "https://legacy.example.com")
-        sid = uuid.uuid4()
-        assert get_session_url(sid) == f"https://futuresearch.ai/sessions/{sid}"
-
-    def test_falls_back_to_default(self, monkeypatch):
-        monkeypatch.delenv("FUTURESEARCH_APP_URL", raising=False)
-        sid = uuid.uuid4()
-        assert get_session_url(sid) == f"https://futuresearch.ai/sessions/{sid}"
-
 
 # --- Generated models ---