@starascendin/lifeos-mcp 0.7.49 → 0.7.50

package/README.md

@@ -72,6 +72,12 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 
 ## Available Tools
 
+### Council
+- **run_council** - Run the shared LifeOS council engine used by AI Panel and ZeroClaw skills
+- **llm_council_deliberate** - Run the separate long-running LLM Council workflow
+- **llm_council_list_conversations** - List saved LLM Council conversations
+- **llm_council_get_deliberation** - Get a saved LLM Council deliberation
+
 ### Project Management
 - **get_projects** - List all projects with stats
 - **get_tasks** - Get tasks with filters (project, status, priority)
@@ -118,6 +124,16 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 - **create_client** - Create a new client
 - **update_client** - Update client details
 
+## Shared Council Architecture
+
+`run_council` calls the Convex `POST /council-skill` endpoint. That is the same shared council core used by:
+
+- AI Panel council mode on Convex-backed models
+- ZeroClaw's `council` skill
+- MCP runtimes through `run_council`
+
+This keeps council orchestration in one place instead of duplicating it per runtime.
+
 ## CLI Help
 
 ```bash

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.49";
-export declare const BUILD_TIME = "2026-03-07T20:23:38.830Z";
+export declare const VERSION = "0.7.50";
+export declare const BUILD_TIME = "2026-03-08T00:49:23.344Z";

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Regenerated on every build.
-export const VERSION = "0.7.49";
-export const BUILD_TIME = "2026-03-07T20:23:38.830Z";
+export const VERSION = "0.7.50";
+export const BUILD_TIME = "2026-03-08T00:49:23.344Z";

package/dist/index.js

@@ -3483,6 +3483,64 @@ const TOOLS = [
             required: ["conversationId"],
         },
     },
+    {
+        name: "run_council",
+        description: "Run the shared LifeOS council deliberation engine and return the synthesized final answer plus council stage details. This is the same council used by the AI panel and claw council skill.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
+                    type: "string",
+                    description: "Override the default user ID (optional)",
+                },
+                query: {
+                    type: "string",
+                    description: "The question or prompt to deliberate on",
+                },
+                tier: {
+                    type: "string",
+                    enum: ["normal", "pro"],
+                    description: "Council tier. Defaults to normal.",
+                },
+                councilModels: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            modelId: { type: "string" },
+                            modelName: { type: "string" },
+                        },
+                        required: ["modelId", "modelName"],
+                    },
+                    description: "Optional custom council roster",
+                },
+                chairmanModel: {
+                    type: "object",
+                    properties: {
+                        modelId: { type: "string" },
+                        modelName: { type: "string" },
+                    },
+                    required: ["modelId", "modelName"],
+                    description: "Optional custom chairman model",
+                },
+                pageContext: {
+                    type: "object",
+                    properties: {
+                        type: { type: "string" },
+                        id: { type: "string" },
+                        title: { type: "string" },
+                        toolCategories: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                    },
+                    required: ["type", "id", "title", "toolCategories"],
+                    description: "Optional page context to bias stage 0 tool gathering",
+                },
+            },
+            required: ["query"],
+        },
+    },
     // ==================== AI COACHING ====================
     {
         name: "get_coach_profile",
@@ -5501,6 +5559,22 @@ async function callConvexTool(tool, params) {
     }
     return result.result;
 }
+async function callConvexJsonEndpoint(path, body) {
+    const url = `${CONVEX_URL}${path}`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": API_KEY,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Convex API error (${response.status}): ${errorText}`);
+    }
+    return await response.json();
+}
 // Create the MCP server
 const server = new Server({
     name: "lifeos-pm",
@@ -5539,28 +5613,36 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         // Handle LLM Council deliberation (special endpoint, long-running)
         if (name === "llm_council_deliberate") {
-            const url = `${CONVEX_URL}/llm-council/mcp-deliberate`;
             const params = args || {};
-            const response = await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    "X-API-Key": API_KEY,
-                },
-                body: JSON.stringify({
-                    userId: USER_ID,
-                    query: params.query,
-                    tier: params.tier,
-                    title: params.title,
-                    councilModels: params.councilModels,
-                    chairmanModel: params.chairmanModel,
-                }),
+            const { userId: overrideUserId } = params;
+            const result = await callConvexJsonEndpoint("/llm-council/mcp-deliberate", {
+                userId: overrideUserId || USER_ID,
+                query: params.query,
+                tier: params.tier,
+                title: params.title,
+                councilModels: params.councilModels,
+                chairmanModel: params.chairmanModel,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        if (name === "run_council") {
+            const params = args || {};
+            const { userId: overrideUserId } = params;
+            const result = await callConvexJsonEndpoint("/council-skill", {
+                userId: overrideUserId || USER_ID,
+                query: params.query,
+                tier: params.tier,
+                councilModels: params.councilModels,
+                chairmanModel: params.chairmanModel,
+                pageContext: params.pageContext,
             });
-            if (!response.ok) {
-                const errorText = await response.text();
-                throw new Error(`LLM Council error (${response.status}): ${errorText}`);
-            }
-            const result = await response.json();
             return {
                 content: [
                     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starascendin/lifeos-mcp",
-  "version": "0.7.49",
+  "version": "0.7.50",
   "description": "MCP server for LifeOS Project Management - manage projects, tasks, notes, and contacts via AI assistants",
   "type": "module",
   "main": "dist/index.js",