@contextstream/mcp-server 0.3.22 → 0.3.24

package/dist/index.js

@@ -4629,6 +4629,14 @@ var globalCache = new MemoryCache();
 
 // src/client.ts
 var uuidSchema = external_exports.string().uuid();
+function unwrapApiResponse(result) {
+  if (!result || typeof result !== "object") return result;
+  const maybe = result;
+  if (typeof maybe.success === "boolean" && "data" in maybe) {
+    return maybe.data;
+  }
+  return result;
+}
 var ContextStreamClient = class {
   constructor(config) {
     this.config = config;
@@ -4696,8 +4704,9 @@ var ContextStreamClient = class {
     const suffix = query.toString() ? `?${query.toString()}` : "";
     return request(this.config, `/workspaces${suffix}`);
   }
-  createWorkspace(input) {
-    return request(this.config, "/workspaces", { body: input });
+  async createWorkspace(input) {
+    const result = await request(this.config, "/workspaces", { body: input });
+    return unwrapApiResponse(result);
   }
   updateWorkspace(workspaceId, input) {
     uuidSchema.parse(workspaceId);
@@ -4716,9 +4725,10 @@ var ContextStreamClient = class {
     const suffix = query.toString() ? `?${query.toString()}` : "";
     return request(this.config, `/projects${suffix}`);
   }
-  createProject(input) {
+  async createProject(input) {
     const payload = this.withDefaults(input);
-    return request(this.config, "/projects", { body: payload });
+    const result = await request(this.config, "/projects", { body: payload });
+    return unwrapApiResponse(result);
   }
   updateProject(projectId, input) {
     uuidSchema.parse(projectId);
@@ -5102,6 +5112,38 @@ var ContextStreamClient = class {
         context.workspace_error = String(e);
       }
     }
+    if (!workspaceId && !params.allow_no_workspace) {
+      const folderDisplayName = rootPath?.split("/").pop() || "this folder";
+      context.ide_roots = ideRoots;
+      context.folder_name = folderDisplayName;
+      if (rootPath) {
+        context.folder_path = rootPath;
+      }
+      context.suggested_project_name = folderDisplayName;
+      try {
+        const workspaces = await this.listWorkspaces({ page_size: 50 });
+        const items = Array.isArray(workspaces.items) ? workspaces.items : [];
+        if (items.length > 0) {
+          context.status = "requires_workspace_selection";
+          context.workspace_candidates = items.map((w) => ({
+            id: w.id,
+            name: w.name,
+            description: w.description
+          }));
+          context.message = `This folder is not associated with a workspace yet. Please select which workspace to use, or create a new one.`;
+          return context;
+        }
+        context.status = "requires_workspace_name";
+        context.workspace_source = "none_found";
+        context.message = `No workspaces found for this account. Ask the user for a name for a new workspace, then create a project for "${folderDisplayName}".`;
+        return context;
+      } catch (e) {
+        context.status = "requires_workspace_selection";
+        context.workspace_error = String(e);
+        context.message = `Unable to resolve a workspace automatically (${String(e)}). Please provide workspace_id, or create one with workspace_bootstrap.`;
+        return context;
+      }
+    }
     if (!projectId && workspaceId && rootPath && params.auto_index !== false) {
       const projectName = rootPath.split("/").pop() || "My Project";
       try {
@@ -5171,6 +5213,9 @@ var ContextStreamClient = class {
     context.workspace_name = workspaceName;
     context.project_id = projectId;
     context.ide_roots = ideRoots;
+    if (!workspaceId) {
+      context.workspace_warning = "No workspace was resolved for this session. Workspace-level tools (memory/search/graph) may not work until you associate this folder with a workspace.";
+    }
     if (workspaceId) {
       try {
         const batchedContext = await this._fetchSessionContextBatched({
@@ -6548,8 +6593,11 @@ Access: ${accessLabel}${accessLabel === "PRO" ? ` (upgrade: ${upgradeUrl2})` : "
         const errorMessage = error?.message || String(error);
         const errorDetails = error?.body || error?.details || null;
         const errorCode = error?.code || error?.status || "UNKNOWN_ERROR";
+        const isPlanLimit = String(errorCode).toUpperCase() === "FORBIDDEN" && String(errorMessage).toLowerCase().includes("plan limit reached");
+        const upgradeHint = isPlanLimit ? `
+Upgrade: ${upgradeUrl2}` : "";
         const serializedError = new Error(
-          `[${errorCode}] ${errorMessage}${errorDetails ? `: ${JSON.stringify(errorDetails)}` : ""}`
+          `[${errorCode}] ${errorMessage}${upgradeHint}${errorDetails ? `: ${JSON.stringify(errorDetails)}` : ""}`
         );
         throw serializedError;
       }
@@ -7482,7 +7530,8 @@ This does semantic search on the first message. You only need context_smart on s
         context_hint: external_exports.string().optional().describe("RECOMMENDED: Pass the user's first message here for semantic search. This finds relevant context from ANY time, not just recent items."),
         include_recent_memory: external_exports.boolean().optional().describe("Include recent memory events (default: true)"),
         include_decisions: external_exports.boolean().optional().describe("Include recent decisions (default: true)"),
-        auto_index: external_exports.boolean().optional().describe("Automatically create and index project from IDE workspace (default: true)")
+        auto_index: external_exports.boolean().optional().describe("Automatically create and index project from IDE workspace (default: true)"),
+        allow_no_workspace: external_exports.boolean().optional().describe("If true, allow session_init to return connected even if no workspace is resolved (workspace-level tools may not work).")
       })
     },
     async (input) => {
@@ -7501,7 +7550,46 @@ This does semantic search on the first message. You only need context_smart on s
       if (sessionManager) {
         sessionManager.markInitialized(result);
       }
-      return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+      const status = typeof result.status === "string" ? result.status : "";
+      const workspaceWarning = typeof result.workspace_warning === "string" ? result.workspace_warning : "";
+      let text = formatContent(result);
+      if (status === "requires_workspace_name") {
+        const folderPath = typeof result.folder_path === "string" ? result.folder_path : typeof input.folder_path === "string" ? input.folder_path : "";
+        text = [
+          "Action required: no workspaces found for this account.",
+          "Ask the user for a name for the new workspace, then run `workspace_bootstrap`.",
+          folderPath ? `Recommended: workspace_bootstrap(workspace_name: "<name>", folder_path: "${folderPath}")` : 'Recommended: workspace_bootstrap(workspace_name: "<name>", folder_path: "<your repo folder>")',
+          "",
+          "--- Raw Response ---",
+          "",
+          formatContent(result)
+        ].join("\n");
+      } else if (status === "requires_workspace_selection") {
+        const folderName = typeof result.folder_name === "string" ? result.folder_name : typeof input.folder_path === "string" ? input.folder_path.split("/").pop() || "this folder" : "this folder";
+        const candidates = Array.isArray(result.workspace_candidates) ? result.workspace_candidates : [];
+        const lines = [];
+        lines.push(`Action required: select a workspace for "${folderName}" (or create a new one).`);
+        if (candidates.length > 0) {
+          lines.push("");
+          lines.push("Available workspaces:");
+          candidates.slice(0, 25).forEach((w, i) => {
+            const name = w.name || "Untitled";
+            const id = w.id ? ` (${w.id})` : "";
+            const desc = w.description ? ` - ${w.description}` : "";
+            lines.push(`  ${i + 1}. ${name}${id}${desc}`);
+          });
+        }
+        lines.push("");
+        lines.push("Then run `workspace_associate` with the selected workspace_id and your folder_path.");
+        lines.push("");
+        lines.push("--- Raw Response ---");
+        lines.push("");
+        lines.push(formatContent(result));
+        text = lines.join("\n");
+      } else if (workspaceWarning) {
+        text = [`Warning: ${workspaceWarning}`, "", formatContent(result)].join("\n");
+      }
+      return { content: [{ type: "text", text }], structuredContent: toStructured(result) };
     }
   );
   registerTool(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.3.22",
+  "version": "0.3.24",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",