Forward chatbox token + workspace to Convex /stream (shared chatbox) (#1873)

Author: Vu-John

mcpjam-inspector/server/routes/web/__tests__/chat-v2.hosted.test.ts

@@ -174,6 +174,37 @@ describe("web routes — chat-v2 hosted mode", () => {
     );
   });
 
+  it("passes shared chatbox link context into the hosted model handler", async () => {
+    const { app, token } = createWebTestApp();
+
+    const response = await postJson(
+      app,
+      "/api/web/chat-v2",
+      {
+        workspaceId: "workspace-1",
+        selectedServerIds: ["server-1"],
+        chatboxToken: "chatbox-shared-token",
+        surface: "share_link",
+        chatSessionId: "chat-session-shared",
+        messages: [{ role: "user", content: "hello from guest" }],
+        model: {
+          id: "anthropic/claude-opus-4.6",
+          provider: "anthropic",
+          name: "Claude Opus 4.6",
+        },
+      },
+      token,
+    );
+
+    expect(response.status).toBe(200);
+    expect(handleMCPJamFreeChatModelMock).toHaveBeenCalledWith(
+      expect.objectContaining({
+        chatboxToken: "chatbox-shared-token",
+        workspaceId: "workspace-1",
+      }),
+    );
+  });
+
   it("forwards directVisibility for hosted direct chats", async () => {
     const { app, token } = createWebTestApp();
 

mcpjam-inspector/server/routes/web/chat-v2.ts

@@ -351,6 +351,8 @@ chatV2.post("/", async (c) => {
         temperature: resolvedTemperature,
         tools: allTools as ToolSet,
         authHeader: c.req.header("authorization"),
+        chatboxToken,
+        workspaceId: hostedBody.workspaceId,
         mcpClientManager: manager,
         selectedServers: selectedServerIds,
         requireToolApproval,

mcpjam-inspector/server/utils/mcpjam-stream-handler.ts

@@ -77,6 +77,8 @@ export interface MCPJamHandlerOptions {
   temperature?: number;
   tools: ToolSet;
   authHeader?: string;
+  chatboxToken?: string;
+  workspaceId?: string;
   mcpClientManager: MCPClientManager;
   selectedServers?: string[];
   requireToolApproval?: boolean;
@@ -98,6 +100,8 @@ interface StepContext {
   toolDefs: ToolDefinition[];
   tools: ToolSet;
   authHeader?: string;
+  chatboxToken?: string;
+  workspaceId?: string;
   modelId: string;
   systemPrompt: string;
   temperature?: number;
@@ -877,6 +881,8 @@ async function processOneStep(
     toolDefs,
     tools,
     authHeader,
+    chatboxToken,
+    workspaceId,
     modelId,
     systemPrompt,
     temperature,
@@ -933,6 +939,8 @@ async function processOneStep(
       systemPrompt,
       ...(temperature !== undefined ? { temperature } : {}),
       tools: toolDefs,
+      ...(chatboxToken ? { chatboxToken } : {}),
+      ...(workspaceId ? { workspaceId } : {}),
     }),
   });
 
@@ -1237,6 +1245,8 @@ export async function handleMCPJamFreeChatModel(
     temperature,
     tools,
     authHeader,
+    chatboxToken,
+    workspaceId,
     mcpClientManager,
     selectedServers,
     requireToolApproval,
@@ -1300,6 +1310,8 @@ export async function handleMCPJamFreeChatModel(
             toolDefs,
             tools,
             authHeader,
+            chatboxToken,
+            workspaceId,
             modelId,
             systemPrompt,
             temperature,