@starascendin/lifeos-mcp 0.7.15 → 0.7.17

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.15";
-export declare const BUILD_TIME = "2026-02-21T01:01:33.105Z";
+export declare const VERSION = "0.7.17";
+export declare const BUILD_TIME = "2026-02-21T15:55:59.051Z";

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Regenerated on every build.
-export const VERSION = "0.7.15";
-export const BUILD_TIME = "2026-02-21T01:01:33.105Z";
+export const VERSION = "0.7.17";
+export const BUILD_TIME = "2026-02-21T15:55:59.051Z";

package/dist/index.js

@@ -2572,8 +2572,8 @@ const TOOLS = [
     },
     // ==================== COACHING Tools ====================
     {
-        name: "get_coaching_profiles",
-        description: "List all AI coaching profiles (coach personas). Each profile defines a coaching methodology, focus areas, and which LifeOS tools the coach can use.",
+        name: "get_coach_profile",
+        description: "Get the strategic coach profile: durable context about who you are, your values, strengths, constraints, and current life season.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2585,8 +2585,8 @@ const TOOLS = [
         },
     },
     {
-        name: "get_coaching_profile",
-        description: "Get a single coaching profile by ID or slug with full details including instructions and enabled tools.",
+        name: "upsert_coach_profile",
+        description: "Create or update the strategic coach profile. Use this when the coach learns durable truths that should persist across sessions.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2594,81 +2594,94 @@ const TOOLS = [
                     type: "string",
                     description: "Override the default user ID (optional)",
                 },
-                profileIdOrSlug: {
+                preferredName: {
                     type: "string",
-                    description: "Profile ID or slug like 'executive-coach' (required)",
+                    description: "Preferred name or nickname (optional)",
                 },
-            },
-            required: ["profileIdOrSlug"],
-        },
-    },
-    {
-        name: "create_coaching_profile",
-        description: "Create a new AI coaching profile with a unique slug, system prompt, focus areas, and tool access.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                userId: {
+                identitySummary: {
                     type: "string",
-                    description: "Override the default user ID (optional)",
+                    description: "Compact identity summary (optional)",
                 },
-                name: {
+                currentSeason: {
                     type: "string",
-                    description: "Coach display name (required)",
+                    description: "Current life season/context (optional)",
                 },
-                slug: {
+                strategicVision: {
                     type: "string",
-                    description: "Unique slug like 'executive-coach' (required)",
+                    description: "Current strategic life direction narrative (optional)",
                 },
-                instructions: {
-                    type: "string",
-                    description: "System prompt / coaching methodology (required)",
+                values: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Core values list (optional)",
                 },
-                focusAreas: {
+                strengths: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Focus areas like ['career', 'leadership'] (required)",
+                    description: "Perceived strengths (optional)",
                 },
-                enabledTools: {
+                growthEdges: {
                     type: "array",
                     items: { type: "string" },
-                    description: "LifeOS tool names this coach can use (required)",
+                    description: "Growth edges / development areas (optional)",
                 },
-                model: {
+                constraints: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Active constraints and tradeoffs (optional)",
+                },
+                decisionHeuristics: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Decision principles to use as guardrails (optional)",
+                },
+                motivationStyle: {
                     type: "string",
-                    description: "LLM model ID, e.g. 'anthropic/claude-sonnet-4-5-20250929' (required)",
+                    description: "How the user responds best to accountability/coaching (optional)",
                 },
-                greeting: {
+                coachingPreferences: {
                     type: "string",
-                    description: "Opening greeting for new sessions (optional)",
+                    description: "Preferred coaching style and boundaries (optional)",
                 },
-                sessionCadence: {
+                updatedBy: {
                     type: "string",
-                    enum: ["daily", "weekly", "biweekly", "monthly", "ad_hoc"],
-                    description: "Suggested session cadence (optional)",
+                    enum: ["coach", "user", "system"],
+                    description: "Who is updating the profile (optional)",
                 },
-                color: {
+            },
+        },
+    },
+    {
+        name: "get_coach_diagnostics",
+        description: "Get strategic diagnostic history (time-series assessments) so the coach can see patterns and trajectory over time.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
                     type: "string",
-                    description: "Hex color for UI (optional)",
+                    description: "Override the default user ID (optional)",
                 },
-                icon: {
+                assessmentType: {
                     type: "string",
-                    description: "Emoji icon (optional)",
+                    enum: [
+                        "baseline",
+                        "session_reflection",
+                        "weekly_review",
+                        "monthly_review",
+                        "pattern_alert",
+                    ],
+                    description: "Filter by diagnostic type (optional)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default 20, max 100)",
                 },
             },
-            required: [
-                "name",
-                "slug",
-                "instructions",
-                "focusAreas",
-                "enabledTools",
-                "model",
-            ],
         },
     },
     {
-        name: "update_coaching_profile",
-        description: "Update a coaching profile's settings.",
+        name: "create_coach_diagnostic",
+        description: "Create a strategic diagnostic snapshot. Use this to persist synthesized patterns, risks, opportunities, and strategic focus after coaching sessions.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2676,69 +2689,70 @@ const TOOLS = [
                     type: "string",
                     description: "Override the default user ID (optional)",
                 },
-                profileId: {
+                sessionId: {
                     type: "string",
-                    description: "Coaching profile ID (required)",
+                    description: "Related coaching session ID (optional)",
                 },
-                name: {
+                assessmentType: {
                     type: "string",
-                    description: "Updated name (optional)",
+                    enum: [
+                        "baseline",
+                        "session_reflection",
+                        "weekly_review",
+                        "monthly_review",
+                        "pattern_alert",
+                    ],
+                    description: "Diagnostic type (required)",
+                },
+                title: {
+                    type: "string",
+                    description: "Diagnostic title (required)",
                 },
-                instructions: {
+                summary: {
                     type: "string",
-                    description: "Updated system prompt (optional)",
+                    description: "Diagnostic summary in markdown/plain text (required)",
+                },
+                confidence: {
+                    type: "number",
+                    description: "Confidence score, usually 0-100 (optional)",
                 },
-                focusAreas: {
+                keyPatterns: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Updated focus areas (optional)",
+                    description: "Key recurring patterns (optional)",
                 },
-                enabledTools: {
+                strengths: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Updated enabled tools (optional)",
-                },
-                model: {
-                    type: "string",
-                    description: "Updated model (optional)",
+                    description: "Strengths surfaced in this diagnostic (optional)",
                 },
-                greeting: {
-                    type: "string",
-                    description: "Updated greeting (optional)",
-                },
-                sessionCadence: {
-                    type: "string",
-                    enum: ["daily", "weekly", "biweekly", "monthly", "ad_hoc"],
-                    description: "Updated cadence (optional)",
+                risks: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Risks or derailers (optional)",
                 },
-                color: {
-                    type: "string",
-                    description: "Updated color (optional)",
+                opportunities: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Opportunities to leverage (optional)",
                 },
-                icon: {
-                    type: "string",
-                    description: "Updated icon (optional)",
+                strategicFocus: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Suggested focus areas for next horizon (optional)",
                 },
-            },
-            required: ["profileId"],
-        },
-    },
-    {
-        name: "delete_coaching_profile",
-        description: "Delete a coaching profile and cascade-delete all related sessions and action items.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                userId: {
-                    type: "string",
-                    description: "Override the default user ID (optional)",
+                sourceNotes: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Supporting citations/notes (optional)",
                 },
-                profileId: {
+                createdBy: {
                     type: "string",
-                    description: "Coaching profile ID to delete (required)",
+                    enum: ["coach", "user", "system"],
+                    description: "Who authored the diagnostic (optional)",
                 },
             },
-            required: ["profileId"],
+            required: ["assessmentType", "title", "summary"],
         },
     },
     {
@@ -3803,7 +3817,7 @@ const TOOLS = [
     // ==================== Life Direction Composite Tools ====================
     {
         name: "get_life_direction_summary",
-        description: "START HERE for any coaching or life direction session. Returns a comprehensive snapshot of the user's current life direction state in one call: North Stars (active/exploring visions), Pillars (core life areas with latest pulse ratings), active Curiosities (top 10), pending Action Items from coaching, and all Working Memory sections. This replaces the need to call get_north_stars, get_pillars, get_pillar_pulse_latest, get_curiosities, get_coaching_action_items, and get_working_memory separately.",
+        description: "START HERE for strategic coaching. Returns a comprehensive snapshot in one call: North Stars, Pillars + pulse, active Curiosities, pending coaching action items, working memory sections, strategic coach profile, and recent diagnostics.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -3863,6 +3877,78 @@ const TOOLS = [
             required: ["title", "summary"],
         },
     },
+    // ==================== LLM Council Tools ====================
+    {
+        name: "llm_council_deliberate",
+        description: "Run a full LLM Council deliberation (Karpathy's 3-stage process). Stage 1: Multiple models answer your query in parallel. Stage 2: Each model anonymously peer-reviews and ranks the others' responses. Stage 3: A chairman model synthesizes the best answer from all responses and rankings. Returns the complete deliberation with all 3 stages. This is a long-running operation (2-10 minutes depending on tier).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "The question or prompt to deliberate on",
+                },
+                tier: {
+                    type: "string",
+                    enum: ["normal", "pro"],
+                    description: "Model tier. 'normal' uses GPT-4o, Claude Sonnet 4, Gemini 2.5 Pro, Grok 3. 'pro' uses GPT-5.2 Pro, Claude Opus 4.5, Gemini 3 Pro, Grok 4. Default: normal",
+                },
+                title: {
+                    type: "string",
+                    description: "Optional title for the conversation (auto-generated from query if not provided)",
+                },
+                councilModels: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            modelId: { type: "string" },
+                            modelName: { type: "string" },
+                        },
+                        required: ["modelId", "modelName"],
+                    },
+                    description: "Optional custom council models (overrides tier selection)",
+                },
+                chairmanModel: {
+                    type: "object",
+                    properties: {
+                        modelId: { type: "string" },
+                        modelName: { type: "string" },
+                    },
+                    required: ["modelId", "modelName"],
+                    description: "Optional custom chairman model (overrides tier selection)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "llm_council_list_conversations",
+        description: "List past LLM Council conversations. Returns conversation IDs, titles, models used, and timestamps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Max conversations to return (default: 20)",
+                },
+            },
+        },
+    },
+    {
+        name: "llm_council_get_deliberation",
+        description: "Get the full details of a past LLM Council deliberation, including all 3 stages: individual responses, peer evaluations with rankings, and chairman synthesis.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                conversationId: {
+                    type: "string",
+                    description: "The conversation ID to retrieve",
+                },
+            },
+            required: ["conversationId"],
+        },
+    },
     // MCP Server Info
     {
         name: "get_version",
@@ -4141,12 +4227,12 @@ const PROMPTS = [
     },
     {
         name: "coaching-overview",
-        description: "Dashboard of coaching profiles, recent sessions, and pending action items across all coaches.",
+        description: "Strategic coaching dashboard: profile state, recent diagnostics, session momentum, and active action items.",
         arguments: [],
     },
     {
         name: "coaching-action-items",
-        description: "Review and manage coaching action items across all coaches. Can mark items complete.",
+        description: "Review and manage strategic coaching action items. Can mark items complete.",
         arguments: [
             {
                 name: "action",
@@ -4157,7 +4243,7 @@ const PROMPTS = [
     },
     {
         name: "coaching-session-review",
-        description: "Deep-dive into a specific coaching session's summary, key insights, and action items.",
+        description: "Deep-dive into a specific coaching session's summary, insights, and action plan.",
         arguments: [
             {
                 name: "session",
@@ -4921,15 +5007,17 @@ Convert all amounts from cents to dollars. Format as currency.`,
                     type: "text",
                     text: `Show me a coaching dashboard. Use the LifeOS MCP tools:
 
-1. Call get_coaching_profiles to list all coach personas
-2. Call get_coaching_sessions with limit=10 for recent sessions across all coaches
-3. Call get_coaching_action_items with status "pending" for outstanding action items
+1. Call get_coach_profile for durable profile context
+2. Call get_coach_diagnostics with limit=5 for recent strategic assessments
+3. Call get_coaching_sessions with limit=10 for recent session history
+4. Call get_coaching_action_items with status "pending" for outstanding action items
 
 Present a coaching overview:
-- **Coaches**: List each coach profile with name, focus areas, and session cadence
-- **Recent Sessions**: Show recent sessions grouped by coach, with title, date, and status
-- **Pending Action Items**: Count of pending items per coach, with the top 3 most urgent items shown
-- **Insights**: Which coaches are most active, any overdue action items, suggested next sessions
+- **Profile**: Who the user is right now (season, values, strengths, constraints)
+- **Recent Diagnostics**: Main patterns, risks, opportunities, and strategic focus areas
+- **Session Momentum**: Recent session cadence and any gaps
+- **Pending Action Items**: Most urgent next actions and likely blockers
+- **Strategic Guidance**: What to focus on this week vs this month
 
 Keep it concise and actionable.`,
                 },
@@ -4948,10 +5036,10 @@ Keep it concise and actionable.`,
                     text: `Review my coaching action items. Use the LifeOS MCP tools:
 
 1. Call get_coaching_action_items to get all action items
-2. Call get_coaching_profiles to get coach names for grouping
+2. Call get_coach_diagnostics with limit=3 to understand current strategic focus
 
-Present action items grouped by coach:
-- **Per Coach**: Show coach name, then list action items with status, priority, due date
+Present action items grouped by strategic theme:
+- **By Focus Area**: Group by likely strategic area based on item text + latest diagnostics
 - **Overdue**: Highlight any items past their due date
 - **Summary**: Total pending, in-progress, completed counts
 - **Suggestions**: Which items to prioritize next${actionClause}`,
@@ -4961,7 +5049,7 @@ Present action items grouped by coach:
     },
     "coaching-session-review": (args) => {
         const sessionClause = args.session
-            ? `Look up session: "${args.session}". If it looks like an ID, call get_coaching_session directly. If it looks like a coach slug, call get_coaching_profile first, then get_coaching_sessions filtered by that coach to find the most recent one.`
+            ? `Look up session: "${args.session}". If it looks like an ID, call get_coaching_session directly. Otherwise call get_coaching_sessions with limit=10 and pick the closest title/date match.`
             : "Call get_coaching_sessions with limit=1 to get the most recent session.";
         return [
             {
@@ -4974,11 +5062,13 @@ Present action items grouped by coach:
 2. Call get_coaching_session with the session ID for full details including summary and action items
 
 Present a session review:
-- **Session Info**: Coach name, date, duration, mood at start
+- **Session Info**: Date, duration, mood at start
 - **Summary**: The session's AI-generated summary
 - **Key Insights**: List all key insights from the session
 - **Action Items**: All action items with their current status
-- **Follow-up**: Suggest what to discuss in the next session based on insights and pending items`,
+- **Follow-up**: Suggest what to discuss in the next session based on insights and pending items
+
+If the session summary reveals a durable pattern shift, recommend creating a new diagnostic via create_coach_diagnostic.`,
                 },
             },
         ];
@@ -5189,6 +5279,39 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     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,
+                }),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`LLM Council error (${response.status}): ${errorText}`);
+            }
+            const result = await response.json();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
         // Handle local-only tools (no Convex call needed)
         if (name === "get_version") {
             return {

package/package.json

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