@contextstream/mcp-server 0.4.9 → 0.4.11

package/README.md

@@ -323,9 +323,10 @@ Set **one** of:
 
 | Variable | Description |
 |----------|-------------|
-| `CONTEXTSTREAM_CONSOLIDATED` | `true` (default in v0.4.x) uses consolidated domain tools |
-| `CONTEXTSTREAM_PROGRESSIVE_MODE` | Enables Router mode (~2 meta-tools) |
-| `CONTEXTSTREAM_TOOLSET` | Legacy granular tool bundle: `light` / `standard` / `complete` (only when consolidated is off) |
+| `CONTEXTSTREAM_CONSOLIDATED` | `true` (default in v0.4.x) uses consolidated domain tools |
+| `CONTEXTSTREAM_PROGRESSIVE_MODE` | Enables Router mode (~2 meta-tools) |
+| `CONTEXTSTREAM_CONTEXT_PACK` | Enable Context Pack for `context_smart` (code + graph + distill). Defaults to `true` |
+| `CONTEXTSTREAM_TOOLSET` | Legacy granular tool bundle: `light` / `standard` / `complete` (only when consolidated is off) |
 | `CONTEXTSTREAM_TOOL_ALLOWLIST` | Comma-separated tool names to expose (legacy granular mode) |
 | `CONTEXTSTREAM_SCHEMA_MODE` | Reduce schema verbosity; e.g., `compact` |
 | `CONTEXTSTREAM_OUTPUT_FORMAT` | Output formatting; e.g., `compact` / `pretty` |

package/dist/index.js

@@ -4052,6 +4052,13 @@ var NEVER = INVALID;
 
 // src/config.ts
 var DEFAULT_API_URL = "https://api.contextstream.io";
+function parseBooleanEnv(value) {
+  if (value === void 0) return void 0;
+  const normalized = value.trim().toLowerCase();
+  if (["1", "true", "yes", "on"].includes(normalized)) return true;
+  if (["0", "false", "no", "off"].includes(normalized)) return false;
+  return void 0;
+}
 var configSchema = external_exports.object({
   apiUrl: external_exports.string().url().default(DEFAULT_API_URL),
   apiKey: external_exports.string().min(1).optional(),
@@ -4059,7 +4066,8 @@ var configSchema = external_exports.object({
   defaultWorkspaceId: external_exports.string().uuid().optional(),
   defaultProjectId: external_exports.string().uuid().optional(),
   userAgent: external_exports.string().default("contextstream-mcp/0.1.0"),
-  allowHeaderAuth: external_exports.boolean().optional()
+  allowHeaderAuth: external_exports.boolean().optional(),
+  contextPackEnabled: external_exports.boolean().default(true)
 });
 var MISSING_CREDENTIALS_ERROR = "Set CONTEXTSTREAM_API_KEY or CONTEXTSTREAM_JWT for authentication (or CONTEXTSTREAM_ALLOW_HEADER_AUTH=true for header-based auth).";
 function isMissingCredentialsError(err) {
@@ -4070,6 +4078,9 @@ function isMissingCredentialsError(err) {
 }
 function loadConfig() {
   const allowHeaderAuth = process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "1" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "true" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "yes";
+  const contextPackEnabled = parseBooleanEnv(
+    process.env.CONTEXTSTREAM_CONTEXT_PACK ?? process.env.CONTEXTSTREAM_CONTEXT_PACK_ENABLED
+  );
   const parsed = configSchema.safeParse({
     apiUrl: process.env.CONTEXTSTREAM_API_URL,
     apiKey: process.env.CONTEXTSTREAM_API_KEY,
@@ -4077,7 +4088,8 @@ function loadConfig() {
     defaultWorkspaceId: process.env.CONTEXTSTREAM_WORKSPACE_ID,
     defaultProjectId: process.env.CONTEXTSTREAM_PROJECT_ID,
     userAgent: process.env.CONTEXTSTREAM_USER_AGENT,
-    allowHeaderAuth
+    allowHeaderAuth,
+    contextPackEnabled
   });
   if (!parsed.success) {
     const missing = parsed.error.errors.map((e) => e.path.join(".")).join(", ");
@@ -6552,6 +6564,8 @@ var ContextStreamClient = class {
     const withDefaults = this.withDefaults(params);
     const maxTokens = params.max_tokens || 800;
     const format = params.format || "minified";
+    const usePackDefault = this.config.contextPackEnabled !== false && !!withDefaults.project_id;
+    const mode = params.mode || (usePackDefault ? "pack" : "standard");
     if (!withDefaults.workspace_id) {
       return {
         context: "[NO_WORKSPACE]",
@@ -6560,6 +6574,38 @@ var ContextStreamClient = class {
         sources_used: 0
       };
     }
+    try {
+      const apiResult = await request(this.config, "/context/smart", {
+        body: {
+          user_message: params.user_message,
+          workspace_id: withDefaults.workspace_id,
+          project_id: withDefaults.project_id,
+          max_tokens: maxTokens,
+          format,
+          mode,
+          distill: params.distill
+        }
+      });
+      const data = unwrapApiResponse(apiResult);
+      let versionNotice2 = null;
+      try {
+        versionNotice2 = await getUpdateNotice();
+      } catch {
+      }
+      return {
+        context: String(data?.context ?? ""),
+        token_estimate: Number(data?.token_estimate ?? Math.ceil(String(data?.context ?? "").length / 4)),
+        format: String(data?.format ?? format),
+        sources_used: Number(data?.sources_used ?? 0),
+        workspace_id: withDefaults.workspace_id,
+        project_id: withDefaults.project_id,
+        ...versionNotice2 ? { version_notice: versionNotice2 } : {},
+        ...Array.isArray(data?.errors) ? { errors: data.errors } : {}
+      };
+    } catch (err) {
+      const message2 = err instanceof Error ? err.message : String(err);
+      console.warn(`[ContextStream] context_smart remote failed, using local fallback: ${message2}`);
+    }
     const message = params.user_message.toLowerCase();
     const keywords = this.extractKeywords(message);
     const items = [];
@@ -7288,6 +7334,131 @@ W:${wsHint}
     uuidSchema.parse(params.reminder_id);
     return request(this.config, `/reminders/${params.reminder_id}`, { method: "DELETE" });
   }
+  // ============================================
+  // Plans & Tasks
+  // ============================================
+  /**
+   * Create a new implementation plan
+   */
+  async createPlan(params) {
+    const withDefaults = this.withDefaults(params);
+    if (!withDefaults.workspace_id) {
+      throw new Error("workspace_id is required for creating plans");
+    }
+    return request(this.config, "/plans", { body: withDefaults });
+  }
+  /**
+   * List plans with optional filters
+   */
+  async listPlans(params) {
+    const withDefaults = this.withDefaults(params || {});
+    const query = new URLSearchParams();
+    if (withDefaults.workspace_id) query.set("workspace_id", withDefaults.workspace_id);
+    if (withDefaults.project_id) query.set("project_id", withDefaults.project_id);
+    if (params?.status) query.set("status", params.status);
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.offset) query.set("offset", String(params.offset));
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return request(this.config, `/plans${suffix}`, { method: "GET" });
+  }
+  /**
+   * Get a plan by ID, optionally including its tasks
+   */
+  async getPlan(params) {
+    uuidSchema.parse(params.plan_id);
+    const query = new URLSearchParams();
+    if (params.include_tasks !== false) query.set("include_tasks", "true");
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return request(this.config, `/plans/${params.plan_id}${suffix}`, { method: "GET" });
+  }
+  /**
+   * Update an existing plan
+   */
+  async updatePlan(params) {
+    uuidSchema.parse(params.plan_id);
+    const { plan_id, ...updates } = params;
+    return request(this.config, `/plans/${plan_id}`, { method: "PATCH", body: updates });
+  }
+  /**
+   * Delete a plan
+   */
+  async deletePlan(params) {
+    uuidSchema.parse(params.plan_id);
+    return request(this.config, `/plans/${params.plan_id}`, { method: "DELETE" });
+  }
+  /**
+   * Get tasks for a specific plan
+   */
+  async getPlanTasks(params) {
+    uuidSchema.parse(params.plan_id);
+    return request(this.config, `/plans/${params.plan_id}/tasks`, { method: "GET" });
+  }
+  /**
+   * Create a task within a plan
+   */
+  async createPlanTask(params) {
+    uuidSchema.parse(params.plan_id);
+    const { plan_id, ...taskData } = params;
+    return request(this.config, `/plans/${plan_id}/tasks`, { body: taskData });
+  }
+  /**
+   * Reorder tasks within a plan
+   */
+  async reorderPlanTasks(params) {
+    uuidSchema.parse(params.plan_id);
+    return request(this.config, `/plans/${params.plan_id}/tasks/reorder`, {
+      method: "PATCH",
+      body: { task_ids: params.task_ids }
+    });
+  }
+  /**
+   * Create a standalone task (optionally linked to a plan)
+   */
+  async createTask(params) {
+    const withDefaults = this.withDefaults(params);
+    if (!withDefaults.workspace_id) {
+      throw new Error("workspace_id is required for creating tasks");
+    }
+    return request(this.config, "/tasks", { body: withDefaults });
+  }
+  /**
+   * List tasks with optional filters
+   */
+  async listTasks(params) {
+    const withDefaults = this.withDefaults(params || {});
+    const query = new URLSearchParams();
+    if (withDefaults.workspace_id) query.set("workspace_id", withDefaults.workspace_id);
+    if (withDefaults.project_id) query.set("project_id", withDefaults.project_id);
+    if (params?.plan_id) query.set("plan_id", params.plan_id);
+    if (params?.status) query.set("status", params.status);
+    if (params?.priority) query.set("priority", params.priority);
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.offset) query.set("offset", String(params.offset));
+    const suffix = query.toString() ? `?${query.toString()}` : "";
+    return request(this.config, `/tasks${suffix}`, { method: "GET" });
+  }
+  /**
+   * Get a task by ID
+   */
+  async getTask(params) {
+    uuidSchema.parse(params.task_id);
+    return request(this.config, `/tasks/${params.task_id}`, { method: "GET" });
+  }
+  /**
+   * Update an existing task
+   */
+  async updateTask(params) {
+    uuidSchema.parse(params.task_id);
+    const { task_id, ...updates } = params;
+    return request(this.config, `/tasks/${task_id}`, { method: "PATCH", body: updates });
+  }
+  /**
+   * Delete a task
+   */
+  async deleteTask(params) {
+    uuidSchema.parse(params.task_id);
+    return request(this.config, `/tasks/${params.task_id}`, { method: "DELETE" });
+  }
 };
 
 // src/tools.ts
@@ -7345,6 +7516,8 @@ v0.4.x uses **~11 consolidated domain tools** for ~75% token reduction vs previo
 
 **NO EXCEPTIONS.** Do not skip even if you think you have enough context.
 
+**Context Pack (Pro+):** If enabled, use \`context_smart(..., mode="pack", distill=true)\` for code/file queries. If unavailable, omit \`mode\` and use standard \`context_smart\`.
+
 ---
 
 ## Consolidated Domain Tools Architecture
@@ -7408,6 +7581,18 @@ If context still feels missing, use \`session(action="recall", query="...")\` fo
 
 ---
 
+### Index & Graph Preflight (REQUIRED for code/file search)
+
+Before searching files or code, confirm the project is indexed and the graph is available:
+
+1. \`project(action="index_status")\` for the current project
+2. If missing/stale:
+   - Local repo: \`project(action="ingest_local", path="<cwd>")\`
+   - Otherwise: \`project(action="index")\`
+3. If graph queries are empty/unavailable: \`graph(action="ingest")\`
+
+Only after this preflight, proceed with search/analysis below.
+
 ### Search & Code Intelligence (ContextStream-first)
 
 **Search order:**
@@ -7488,6 +7673,8 @@ v0.4.x uses ~11 consolidated domain tools for ~75% token reduction vs previous v
 | **Before risky work** | \`session(action="get_lessons", query="<topic>")\` |
 | **On user frustration** | \`session(action="capture_lesson", title="...", trigger="...", impact="...", prevention="...")\` |
 
+**Context Pack (Pro+):** If enabled, use \`context_smart(..., mode="pack", distill=true)\` for code/file queries. If unavailable, omit \`mode\`.
+
 ### Quick Reference: Domain Tools
 
 | Tool | Common Usage |
@@ -7505,6 +7692,7 @@ v0.4.x uses ~11 consolidated domain tools for ~75% token reduction vs previous v
 
 - **First message**: Always call \`session_init\` with context_hint
 - **Every message after**: Always call \`context_smart\` BEFORE responding (semantic search for relevant context)
+- **Before searching files/code**: Check \`project(action="index_status")\`; if missing/stale run \`project(action="ingest_local", path="<cwd>")\` or \`project(action="index")\`, and use \`graph(action="ingest")\` if needed
 - **For discovery**: Use \`session(action="smart_search")\` or \`search(mode="hybrid")\` before local repo scans
 - **For code analysis**: Use \`graph(action="dependencies")\` or \`graph(action="impact")\` for call/dependency analysis
 - **After completing work**: Always capture decisions/insights with \`session(action="capture")\`
@@ -7630,7 +7818,12 @@ var TOOL_CATALOG = [
       { name: "get_lessons", hint: "learn" },
       { name: "capture_lesson", hint: "mistake" },
       { name: "get_user_context", hint: "prefs" },
-      { name: "smart_search", hint: "deep-find" }
+      { name: "smart_search", hint: "deep-find" },
+      // Plan actions
+      { name: "capture_plan", hint: "save-plan" },
+      { name: "get_plan", hint: "get-plan" },
+      { name: "update_plan", hint: "edit-plan" },
+      { name: "list_plans", hint: "list-plans" }
     ]
   },
   {
@@ -7653,7 +7846,14 @@ var TOOL_CATALOG = [
       { name: "search", hint: "find" },
       { name: "decisions", hint: "choices" },
       { name: "timeline", hint: "history" },
-      { name: "distill_event", hint: "extract" }
+      { name: "distill_event", hint: "extract" },
+      // Task actions
+      { name: "create_task", hint: "new-task" },
+      { name: "get_task", hint: "get-task" },
+      { name: "update_task", hint: "edit-task" },
+      { name: "delete_task", hint: "rm-task" },
+      { name: "list_tasks", hint: "list-tasks" },
+      { name: "reorder_tasks", hint: "sort-tasks" }
     ]
   },
   {
@@ -11478,6 +11678,9 @@ Format options:
 
 Type codes: W=Workspace, P=Project, D=Decision, M=Memory, I=Insight, T=Task, L=Lesson
 
+Context Pack:
+- mode='pack' adds code context + distillation (higher credit cost)
+
 Example usage:
 1. User asks "how should I implement auth?"
 2. AI calls context_smart(user_message="how should I implement auth?")
@@ -11490,7 +11693,9 @@ This saves ~80% tokens compared to including full chat history.`,
         workspace_id: external_exports.string().uuid().optional(),
         project_id: external_exports.string().uuid().optional(),
         max_tokens: external_exports.number().optional().describe("Maximum tokens for context (default: 800)"),
-        format: external_exports.enum(["minified", "readable", "structured"]).optional().describe("Context format (default: minified)")
+        format: external_exports.enum(["minified", "readable", "structured"]).optional().describe("Context format (default: minified)"),
+        mode: external_exports.enum(["standard", "pack"]).optional().describe("Context pack mode (default: pack when enabled)"),
+        distill: external_exports.boolean().optional().describe("Use distillation for context pack (default: true)")
       })
     },
     async (input) => {
@@ -11511,7 +11716,9 @@ This saves ~80% tokens compared to including full chat history.`,
         workspace_id: workspaceId,
         project_id: projectId,
         max_tokens: input.max_tokens,
-        format: input.format
+        format: input.format,
+        mode: input.mode,
+        distill: input.distill
       });
       const footer = `
 ---
@@ -12344,7 +12551,7 @@ Use this to remove a reminder that is no longer relevant.`,
       "session",
       {
         title: "Session",
-        description: `Session management operations. Actions: capture (save decision/insight), capture_lesson (save lesson from mistake), get_lessons (retrieve lessons), recall (natural language recall), remember (quick save), user_context (get preferences), summary (workspace summary), compress (compress chat), delta (changes since timestamp), smart_search (context-enriched search), decision_trace (trace decision provenance).`,
+        description: `Session management operations. Actions: capture (save decision/insight), capture_lesson (save lesson from mistake), get_lessons (retrieve lessons), recall (natural language recall), remember (quick save), user_context (get preferences), summary (workspace summary), compress (compress chat), delta (changes since timestamp), smart_search (context-enriched search), decision_trace (trace decision provenance). Plan actions: capture_plan (save implementation plan), get_plan (retrieve plan with tasks), update_plan (modify plan), list_plans (list all plans).`,
         inputSchema: external_exports.object({
           action: external_exports.enum([
             "capture",
@@ -12357,14 +12564,19 @@ Use this to remove a reminder that is no longer relevant.`,
             "compress",
             "delta",
             "smart_search",
-            "decision_trace"
+            "decision_trace",
+            // Plan actions
+            "capture_plan",
+            "get_plan",
+            "update_plan",
+            "list_plans"
           ]).describe("Action to perform"),
           workspace_id: external_exports.string().uuid().optional(),
           project_id: external_exports.string().uuid().optional(),
           // Content params
           query: external_exports.string().optional().describe("Query for recall/search/lessons/decision_trace"),
           content: external_exports.string().optional().describe("Content for capture/remember/compress"),
-          title: external_exports.string().optional().describe("Title for capture/capture_lesson"),
+          title: external_exports.string().optional().describe("Title for capture/capture_lesson/capture_plan"),
           event_type: external_exports.enum(["decision", "preference", "insight", "task", "bug", "feature", "correction", "lesson", "warning", "frustration", "conversation"]).optional().describe("Event type for capture"),
           importance: external_exports.enum(["low", "medium", "high", "critical"]).optional(),
           tags: external_exports.array(external_exports.string()).optional(),
@@ -12395,7 +12607,22 @@ Use this to remove a reminder that is no longer relevant.`,
             pr_url: external_exports.string().url().optional(),
             issue_url: external_exports.string().url().optional(),
             slack_thread_url: external_exports.string().url().optional()
-          }).optional()
+          }).optional(),
+          // Plan-specific params
+          plan_id: external_exports.string().uuid().optional().describe("Plan ID for get_plan/update_plan"),
+          description: external_exports.string().optional().describe("Description for capture_plan"),
+          goals: external_exports.array(external_exports.string()).optional().describe("Goals for capture_plan"),
+          steps: external_exports.array(external_exports.object({
+            id: external_exports.string(),
+            title: external_exports.string(),
+            description: external_exports.string().optional(),
+            order: external_exports.number(),
+            estimated_effort: external_exports.enum(["small", "medium", "large"]).optional()
+          })).optional().describe("Implementation steps for capture_plan"),
+          status: external_exports.enum(["draft", "active", "completed", "archived", "abandoned"]).optional().describe("Plan status"),
+          due_at: external_exports.string().optional().describe("Due date for plan (ISO timestamp)"),
+          source_tool: external_exports.string().optional().describe("Tool that generated this plan"),
+          include_tasks: external_exports.boolean().optional().describe("Include tasks when getting plan")
         })
       },
       async (input) => {
@@ -12559,6 +12786,68 @@ Use this to remove a reminder that is no longer relevant.`,
             });
             return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
           }
+          // Plan actions
+          case "capture_plan": {
+            if (!input.title) {
+              return errorResult("capture_plan requires: title");
+            }
+            if (!workspaceId) {
+              return errorResult("capture_plan requires workspace_id. Call session_init first.");
+            }
+            const result = await client.createPlan({
+              workspace_id: workspaceId,
+              project_id: projectId,
+              title: input.title,
+              content: input.content,
+              description: input.description,
+              goals: input.goals,
+              steps: input.steps,
+              status: input.status || "draft",
+              tags: input.tags,
+              due_at: input.due_at,
+              source_tool: input.source_tool || "mcp"
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "get_plan": {
+            if (!input.plan_id) {
+              return errorResult("get_plan requires: plan_id");
+            }
+            const result = await client.getPlan({
+              plan_id: input.plan_id,
+              include_tasks: input.include_tasks !== false
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "update_plan": {
+            if (!input.plan_id) {
+              return errorResult("update_plan requires: plan_id");
+            }
+            const result = await client.updatePlan({
+              plan_id: input.plan_id,
+              title: input.title,
+              content: input.content,
+              description: input.description,
+              goals: input.goals,
+              steps: input.steps,
+              status: input.status,
+              tags: input.tags,
+              due_at: input.due_at
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "list_plans": {
+            if (!workspaceId) {
+              return errorResult("list_plans requires workspace_id. Call session_init first.");
+            }
+            const result = await client.listPlans({
+              workspace_id: workspaceId,
+              project_id: projectId,
+              status: input.status,
+              limit: input.limit
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
           default:
             return errorResult(`Unknown action: ${input.action}`);
         }
@@ -12568,7 +12857,7 @@ Use this to remove a reminder that is no longer relevant.`,
       "memory",
       {
         title: "Memory",
-        description: `Memory operations for events and nodes. Event actions: create_event, get_event, update_event, delete_event, list_events, distill_event. Node actions: create_node, get_node, update_node, delete_node, list_nodes, supersede_node. Query actions: search, decisions, timeline, summary.`,
+        description: `Memory operations for events and nodes. Event actions: create_event, get_event, update_event, delete_event, list_events, distill_event. Node actions: create_node, get_node, update_node, delete_node, list_nodes, supersede_node. Query actions: search, decisions, timeline, summary. Task actions: create_task (create task, optionally linked to plan), get_task, update_task, delete_task, list_tasks, reorder_tasks.`,
         inputSchema: external_exports.object({
           action: external_exports.enum([
             "create_event",
@@ -12586,7 +12875,14 @@ Use this to remove a reminder that is no longer relevant.`,
             "search",
             "decisions",
             "timeline",
-            "summary"
+            "summary",
+            // Task actions
+            "create_task",
+            "get_task",
+            "update_task",
+            "delete_task",
+            "list_tasks",
+            "reorder_tasks"
           ]).describe("Action to perform"),
           workspace_id: external_exports.string().uuid().optional(),
           project_id: external_exports.string().uuid().optional(),
@@ -12622,7 +12918,18 @@ Use this to remove a reminder that is no longer relevant.`,
             file_path: external_exports.string(),
             symbol_id: external_exports.string().optional(),
             symbol_name: external_exports.string().optional()
-          })).optional()
+          })).optional(),
+          // Task-specific params
+          task_id: external_exports.string().uuid().optional().describe("Task ID for get_task/update_task/delete_task"),
+          plan_id: external_exports.string().uuid().optional().describe("Parent plan ID for create_task/list_tasks"),
+          plan_step_id: external_exports.string().optional().describe("Which plan step this task implements"),
+          description: external_exports.string().optional().describe("Description for task"),
+          task_status: external_exports.enum(["pending", "in_progress", "completed", "blocked", "cancelled"]).optional().describe("Task status"),
+          priority: external_exports.enum(["low", "medium", "high", "urgent"]).optional().describe("Task priority"),
+          order: external_exports.number().optional().describe("Task order within plan"),
+          task_ids: external_exports.array(external_exports.string().uuid()).optional().describe("Task IDs for reorder_tasks"),
+          blocked_reason: external_exports.string().optional().describe("Reason when task is blocked"),
+          tags: external_exports.array(external_exports.string()).optional().describe("Tags for task")
         })
       },
       async (input) => {
@@ -12776,6 +13083,94 @@ Use this to remove a reminder that is no longer relevant.`,
             });
             return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
           }
+          // Task actions
+          case "create_task": {
+            if (!input.title) {
+              return errorResult("create_task requires: title");
+            }
+            if (!workspaceId) {
+              return errorResult("create_task requires workspace_id. Call session_init first.");
+            }
+            const result = await client.createTask({
+              workspace_id: workspaceId,
+              project_id: projectId,
+              title: input.title,
+              content: input.content,
+              description: input.description,
+              plan_id: input.plan_id,
+              plan_step_id: input.plan_step_id,
+              status: input.task_status,
+              priority: input.priority,
+              order: input.order,
+              code_refs: input.code_refs,
+              tags: input.tags
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "get_task": {
+            if (!input.task_id) {
+              return errorResult("get_task requires: task_id");
+            }
+            const result = await client.getTask({
+              task_id: input.task_id
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "update_task": {
+            if (!input.task_id) {
+              return errorResult("update_task requires: task_id");
+            }
+            const result = await client.updateTask({
+              task_id: input.task_id,
+              title: input.title,
+              content: input.content,
+              description: input.description,
+              status: input.task_status,
+              priority: input.priority,
+              order: input.order,
+              plan_step_id: input.plan_step_id,
+              code_refs: input.code_refs,
+              tags: input.tags,
+              blocked_reason: input.blocked_reason
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "delete_task": {
+            if (!input.task_id) {
+              return errorResult("delete_task requires: task_id");
+            }
+            const result = await client.deleteTask({
+              task_id: input.task_id
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "list_tasks": {
+            if (!workspaceId) {
+              return errorResult("list_tasks requires workspace_id. Call session_init first.");
+            }
+            const result = await client.listTasks({
+              workspace_id: workspaceId,
+              project_id: projectId,
+              plan_id: input.plan_id,
+              status: input.task_status,
+              priority: input.priority,
+              limit: input.limit
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
+          case "reorder_tasks": {
+            if (!input.plan_id) {
+              return errorResult("reorder_tasks requires: plan_id");
+            }
+            if (!input.task_ids || input.task_ids.length === 0) {
+              return errorResult("reorder_tasks requires: task_ids (array of task IDs in new order)");
+            }
+            const result = await client.reorderPlanTasks({
+              plan_id: input.plan_id,
+              task_ids: input.task_ids
+            });
+            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
+          }
           default:
             return errorResult(`Unknown action: ${input.action}`);
         }
@@ -13046,19 +13441,30 @@ Use this to remove a reminder that is no longer relevant.`,
             if (!input.path) {
               return errorResult("ingest_local requires: path");
             }
+            if (!projectId) {
+              return errorResult("ingest_local requires: project_id");
+            }
             const validPath = await validateReadableDirectory(input.path);
             if (!validPath.ok) {
               return errorResult(validPath.error);
             }
-            const files = await readAllFilesInBatches(validPath.resolvedPath, async (batch) => {
-              await client.ingestLocalFiles({
-                project_id: projectId,
-                files: batch,
+            let totalFiles = 0;
+            let batches = 0;
+            for await (const batch of readAllFilesInBatches(validPath.resolvedPath, { batchSize: 50 })) {
+              if (batch.length === 0) continue;
+              await client.ingestFiles(projectId, batch, {
                 overwrite: input.overwrite,
                 write_to_disk: input.write_to_disk
               });
-            });
-            const result = { files_ingested: files, project_id: projectId };
+              totalFiles += batch.length;
+              batches += 1;
+            }
+            const result = {
+              project_id: projectId,
+              files_ingested: totalFiles,
+              batches,
+              path: validPath.resolvedPath
+            };
             return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
           }
           default:
@@ -15231,6 +15637,7 @@ function buildContextStreamMcpServer(params) {
   if (params.toolset === "router") {
     env.CONTEXTSTREAM_PROGRESSIVE_MODE = "true";
   }
+  env.CONTEXTSTREAM_CONTEXT_PACK = params.contextPackEnabled === false ? "false" : "true";
   if (IS_WINDOWS) {
     return {
       command: "cmd",
@@ -15252,6 +15659,7 @@ function buildContextStreamVsCodeServer(params) {
   if (params.toolset === "router") {
     env.CONTEXTSTREAM_PROGRESSIVE_MODE = "true";
   }
+  env.CONTEXTSTREAM_CONTEXT_PACK = params.contextPackEnabled === false ? "false" : "true";
   if (IS_WINDOWS) {
     return {
       type: "stdio",
@@ -15342,6 +15750,8 @@ async function upsertCodexTomlConfig(filePath, params) {
   const envMarker = "[mcp_servers.contextstream.env]";
   const toolsetLine = params.toolset === "router" ? `CONTEXTSTREAM_PROGRESSIVE_MODE = "true"
 ` : "";
+  const contextPackLine = `CONTEXTSTREAM_CONTEXT_PACK = "${params.contextPackEnabled === false ? "false" : "true"}"
+`;
   const commandLine = IS_WINDOWS ? `command = "cmd"
 args = ["/c", "npx", "-y", "@contextstream/mcp-server"]
 ` : `command = "npx"
@@ -15355,7 +15765,7 @@ args = ["-y", "@contextstream/mcp-server"]
 [mcp_servers.contextstream.env]
 CONTEXTSTREAM_API_URL = "${params.apiUrl}"
 CONTEXTSTREAM_API_KEY = "${params.apiKey}"
-` + toolsetLine;
+` + toolsetLine + contextPackLine;
   if (!exists) {
     await fs5.writeFile(filePath, block.trimStart(), "utf8");
     return "created";
@@ -15365,10 +15775,14 @@ CONTEXTSTREAM_API_KEY = "${params.apiKey}"
     return "updated";
   }
   if (!existing.includes(envMarker)) {
-    await fs5.writeFile(filePath, existing.trimEnd() + "\n\n" + envMarker + `
+    await fs5.writeFile(
+      filePath,
+      existing.trimEnd() + "\n\n" + envMarker + `
 CONTEXTSTREAM_API_URL = "${params.apiUrl}"
 CONTEXTSTREAM_API_KEY = "${params.apiKey}"
-`, "utf8");
+` + toolsetLine + contextPackLine,
+      "utf8"
+    );
     return "updated";
   }
   const lines = existing.split(/\r?\n/);
@@ -15376,12 +15790,14 @@ CONTEXTSTREAM_API_KEY = "${params.apiKey}"
   let inEnv = false;
   let sawUrl = false;
   let sawKey = false;
+  let sawContextPack = false;
   for (const line of lines) {
     const trimmed = line.trim();
     if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
       if (inEnv && trimmed !== envMarker) {
         if (!sawUrl) out.push(`CONTEXTSTREAM_API_URL = "${params.apiUrl}"`);
         if (!sawKey) out.push(`CONTEXTSTREAM_API_KEY = "${params.apiKey}"`);
+        if (!sawContextPack) out.push(`CONTEXTSTREAM_CONTEXT_PACK = "${params.contextPackEnabled === false ? "false" : "true"}"`);
         inEnv = false;
       }
       if (trimmed === envMarker) inEnv = true;
@@ -15398,11 +15814,17 @@ CONTEXTSTREAM_API_KEY = "${params.apiKey}"
       sawKey = true;
       continue;
     }
+    if (inEnv && /^\s*CONTEXTSTREAM_CONTEXT_PACK\s*=/.test(line)) {
+      out.push(`CONTEXTSTREAM_CONTEXT_PACK = "${params.contextPackEnabled === false ? "false" : "true"}"`);
+      sawContextPack = true;
+      continue;
+    }
     out.push(line);
   }
   if (inEnv) {
     if (!sawUrl) out.push(`CONTEXTSTREAM_API_URL = "${params.apiUrl}"`);
     if (!sawKey) out.push(`CONTEXTSTREAM_API_KEY = "${params.apiKey}"`);
+    if (!sawContextPack) out.push(`CONTEXTSTREAM_CONTEXT_PACK = "${params.contextPackEnabled === false ? "false" : "true"}"`);
   }
   const updated = out.join("\n");
   if (updated === existing) return "skipped";
@@ -15643,6 +16065,11 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
     console.log("  Tip: Change later by setting CONTEXTSTREAM_CONSOLIDATED=true|false");
     const toolsetChoice = normalizeInput(await rl.question("Choose [1/2] (default 1): ")) || "1";
     const toolset = toolsetChoice === "2" ? "router" : "consolidated";
+    console.log("\nContext Pack (Pro+ plans):");
+    console.log("  Fast indexed code + graph context with optional distillation.");
+    console.log("  Uses more operations/credits; can be disabled in settings or via env.");
+    const contextPackChoice = normalizeInput(await rl.question("Enable Context Pack? [Y/n]: "));
+    const contextPackEnabled = !(contextPackChoice.toLowerCase() === "n" || contextPackChoice.toLowerCase() === "no");
     const editors = ["codex", "claude", "cursor", "windsurf", "cline", "kilo", "roo", "aider"];
     console.log('\nSelect editors to configure (comma-separated numbers, or "all"):');
     editors.forEach((e, i) => console.log(`  ${i + 1}) ${EDITOR_LABELS[e]}`));
@@ -15699,9 +16126,9 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
     const mcpChoiceDefault = hasCodex && !hasProjectMcpEditors ? "1" : "3";
     const mcpChoice = normalizeInput(await rl.question(`Choose [${hasCodex && !hasProjectMcpEditors ? "1/2" : "1/2/3/4"}] (default ${mcpChoiceDefault}): `)) || mcpChoiceDefault;
     const mcpScope = mcpChoice === "2" && hasCodex && !hasProjectMcpEditors ? "skip" : mcpChoice === "4" ? "skip" : mcpChoice === "1" ? "global" : mcpChoice === "2" ? "project" : "both";
-    const mcpServer = buildContextStreamMcpServer({ apiUrl, apiKey, toolset });
-    const mcpServerClaude = buildContextStreamMcpServer({ apiUrl, apiKey, toolset });
-    const vsCodeServer = buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset });
+    const mcpServer = buildContextStreamMcpServer({ apiUrl, apiKey, toolset, contextPackEnabled });
+    const mcpServerClaude = buildContextStreamMcpServer({ apiUrl, apiKey, toolset, contextPackEnabled });
+    const vsCodeServer = buildContextStreamVsCodeServer({ apiUrl, apiKey, toolset, contextPackEnabled });
     const needsGlobalMcpConfig = mcpScope === "global" || mcpScope === "both" || mcpScope === "project" && hasCodex;
     if (needsGlobalMcpConfig) {
       console.log("\nInstalling global MCP config...");
@@ -15715,7 +16142,7 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
               console.log(`- ${EDITOR_LABELS[editor]}: would update ${filePath}`);
               continue;
             }
-            const status = await upsertCodexTomlConfig(filePath, { apiUrl, apiKey, toolset });
+            const status = await upsertCodexTomlConfig(filePath, { apiUrl, apiKey, toolset, contextPackEnabled });
             writeActions.push({ kind: "mcp-config", target: filePath, status });
             console.log(`- ${EDITOR_LABELS[editor]}: ${status} ${filePath}`);
             continue;
@@ -15749,7 +16176,8 @@ Detected plan: ${planLabel} (graph: ${graphTierLabel})`);
             }
             console.log("- Claude Code: global MCP config is best done via `claude mcp add --transport stdio ...` (see docs).");
             const envHint = toolset === "router" ? " --env CONTEXTSTREAM_PROGRESSIVE_MODE=true" : "";
-            console.log(`  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=...${envHint} -- npx -y @contextstream/mcp-server`);
+            const packHint = contextPackEnabled === false ? " --env CONTEXTSTREAM_CONTEXT_PACK=false" : " --env CONTEXTSTREAM_CONTEXT_PACK=true";
+            console.log(`  macOS/Linux: claude mcp add --transport stdio contextstream --scope user --env CONTEXTSTREAM_API_URL=... --env CONTEXTSTREAM_API_KEY=...${envHint}${packHint} -- npx -y @contextstream/mcp-server`);
             console.log("  Windows (native): use `cmd /c npx -y @contextstream/mcp-server` after `--` if `npx` is not found.");
             continue;
           }
@@ -15956,6 +16384,7 @@ Applying to ${projects.length} project(s)...`);
       const toolsetDesc = toolset === "router" ? "~2 meta-tools (router mode)" : "~11 domain tools (consolidated)";
       console.log(`Toolset: ${toolset} (${toolsetDesc})`);
       console.log(`Token reduction: ~75% compared to previous versions.`);
+      console.log(`Context Pack: ${contextPackEnabled ? "enabled" : "disabled"}`);
     }
     console.log("\nNext steps:");
     console.log("- Restart your editor/CLI after changing MCP config or rules.");
@@ -15964,6 +16393,7 @@ Applying to ${projects.length} project(s)...`);
     if (toolset === "router") {
       console.log("- Router mode uses 2 meta-tools (session_init + context_smart) for ultra-minimal token usage.");
     }
+    console.log("- Toggle Context Pack with CONTEXTSTREAM_CONTEXT_PACK=true|false (and in dashboard settings).");
     console.log("");
     console.log("You're set up! Now try these prompts in your AI tool:");
     console.log('  1) "session summary"');
@@ -16032,6 +16462,7 @@ Environment variables:
   CONTEXTSTREAM_ROUTER_MODE   Router pattern: true|false (default: false, exposes only 2 meta-tools)
   CONTEXTSTREAM_OUTPUT_FORMAT Output verbosity: compact|pretty (default: compact, ~30% fewer tokens)
   CONTEXTSTREAM_CONSOLIDATED  Consolidated domain tools: true|false (default: true in v0.4.x, ~75% token reduction)
+  CONTEXTSTREAM_CONTEXT_PACK  Enable Context Pack in context_smart: true|false (default: true)
   CONTEXTSTREAM_PRO_TOOLS     Optional comma-separated PRO tool names (default: AI tools)
   CONTEXTSTREAM_UPGRADE_URL   Optional upgrade URL shown for PRO tools on Free plan
   CONTEXTSTREAM_ENABLE_PROMPTS Enable MCP prompts list (default: true)

package/dist/test-server.js

@@ -4052,6 +4052,13 @@ var NEVER = INVALID;
 
 // src/config.ts
 var DEFAULT_API_URL = "https://api.contextstream.io";
+function parseBooleanEnv(value) {
+  if (value === void 0) return void 0;
+  const normalized = value.trim().toLowerCase();
+  if (["1", "true", "yes", "on"].includes(normalized)) return true;
+  if (["0", "false", "no", "off"].includes(normalized)) return false;
+  return void 0;
+}
 var configSchema = external_exports.object({
   apiUrl: external_exports.string().url().default(DEFAULT_API_URL),
   apiKey: external_exports.string().min(1).optional(),
@@ -4059,11 +4066,15 @@ var configSchema = external_exports.object({
   defaultWorkspaceId: external_exports.string().uuid().optional(),
   defaultProjectId: external_exports.string().uuid().optional(),
   userAgent: external_exports.string().default("contextstream-mcp/0.1.0"),
-  allowHeaderAuth: external_exports.boolean().optional()
+  allowHeaderAuth: external_exports.boolean().optional(),
+  contextPackEnabled: external_exports.boolean().default(true)
 });
 var MISSING_CREDENTIALS_ERROR = "Set CONTEXTSTREAM_API_KEY or CONTEXTSTREAM_JWT for authentication (or CONTEXTSTREAM_ALLOW_HEADER_AUTH=true for header-based auth).";
 function loadConfig() {
   const allowHeaderAuth = process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "1" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "true" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "yes";
+  const contextPackEnabled = parseBooleanEnv(
+    process.env.CONTEXTSTREAM_CONTEXT_PACK ?? process.env.CONTEXTSTREAM_CONTEXT_PACK_ENABLED
+  );
   const parsed = configSchema.safeParse({
     apiUrl: process.env.CONTEXTSTREAM_API_URL,
     apiKey: process.env.CONTEXTSTREAM_API_KEY,
@@ -4071,7 +4082,8 @@ function loadConfig() {
     defaultWorkspaceId: process.env.CONTEXTSTREAM_WORKSPACE_ID,
     defaultProjectId: process.env.CONTEXTSTREAM_PROJECT_ID,
     userAgent: process.env.CONTEXTSTREAM_USER_AGENT,
-    allowHeaderAuth
+    allowHeaderAuth,
+    contextPackEnabled
   });
   if (!parsed.success) {
     const missing = parsed.error.errors.map((e) => e.path.join(".")).join(", ");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
   "type": "module",
   "license": "MIT",