lotus-wisdom-mcp 0.3.0 → 0.3.2

package/README.md

@@ -317,11 +317,16 @@ The Lotus Wisdom framework recognizes that wisdom often emerges not through line
 
 MCP tool descriptions stay in the AI's context window constantly when the server is connected. To minimize this overhead while preserving the full teaching content:
 
-- **Constant context (~200 tokens)**: The `lotuswisdom` tool description is kept minimal—just enough for the AI to know when and how to use it
-- **On-demand learning (~600 tokens)**: The full framework (philosophy, domain spirits, guidance) is delivered when calling with `tag='begin'`
+- **Constant context (~150 tokens)**: The `lotuswisdom` tool description is kept minimal—just enough for the AI to know when and how to use it
+- **On-demand learning (~1,200 tokens)**: The complete framework is delivered when calling with `tag='begin'`, including:
+  - Philosophy and domain spirits
+  - Parameter explanations (tag, content, stepNumber, etc.)
+  - Response format details (wisdomDomain, journey, domainJourney)
+  - Meditation handling (MEDITATION_COMPLETE status)
+  - When to use guidance
 - **Learn first, practice second**: The `begin` tag ensures models receive complete understanding before contemplating
 
-This approach reduces constant context overhead by ~85% while ensuring no wisdom is lost. The AI always knows to start with `begin` because it's clearly marked as "FIRST" in the tag list.
+This approach reduces constant context overhead by ~85% when the tool is idle. When actually used, the full framework is delivered on first step—nothing is lost.
 
 ## License
 
@@ -333,7 +338,17 @@ Contributions are welcome! Please feel free to submit issues or pull requests on
 
 ## Version
 
-Current version: 0.3.0
+Current version: 0.3.2
+
+### What's New in 0.3.2
+
+- 🚪 **Simplified Begin**: `tag='begin'` can now be called with just `{"tag":"begin"}` - all other params auto-filled
+- 🤖 **Better Haiku/Small Model Support**: Removes friction for models that don't infer all required params
+
+### What's New in 0.3.1
+
+- 📚 **Complete Framework Learning**: `begin` tag now returns full parameter explanations, response format details, and meditation handling
+- 🔢 **Accurate Token Counts**: Updated documentation with actual token measurements (~150 constant, ~1,200 on-demand)
 
 ### What's New in 0.3.0
 

package/dist/bundle.js

@@ -12474,6 +12474,12 @@ var LotusWisdomServer = class {
     if (!CORE_TAGS.includes(data.tag)) {
       throw new Error(`Invalid tag: ${data.tag}. Must be one of: ${CORE_TAGS.join(", ")}`);
     }
+    if (data.tag === "begin") {
+      data.content = data.content || "Beginning contemplative journey";
+      data.stepNumber = data.stepNumber || 1;
+      data.totalSteps = data.totalSteps || 5;
+      data.nextStepNeeded = data.nextStepNeeded ?? true;
+    }
     if (!data.content || typeof data.content !== "string") {
       throw new Error("Invalid content: must be a string");
     }
@@ -12612,7 +12618,32 @@ var LotusWisdomServer = class {
                 uncertainty: "When uncertain, sit with the uncertainty. The fog is not an obstacle; it is part of the journey. Not-knowing is its own form of wisdom.",
                 workflow: "Call lotuswisdom iteratively with different tags. The tool processes your contemplation internally\u2014do NOT output wisdom until you receive status=WISDOM_READY. Then speak naturally in your own voice.",
                 next: 'Proceed with stepNumber: 2 using any tag that feels right (often "open" or "examine" to start).'
-              }
+              },
+              parameters: {
+                tag: "The current processing technique\u2014choose from any wisdom domain",
+                content: "Your contemplation for this step\u2014what you are thinking, seeing, or understanding",
+                stepNumber: "Current step in your journey (this begin step is 1)",
+                totalSteps: "Your estimate of total steps needed (can adjust as you go)",
+                nextStepNeeded: "Set true to continue, false when ready to complete",
+                isMeditation: "Set true when using the meditate tag for a contemplative pause",
+                meditationDuration: "Optional seconds (1-10) for meditation pauses"
+              },
+              responses: {
+                processing: "Normal steps return status=processing with journey tracking",
+                wisdomDomain: "Which domain your current tag belongs to",
+                journey: 'Your complete tag path so far (e.g., "open \u2192 examine \u2192 direct \u2192 integrate")',
+                domainJourney: 'Movement between wisdom domains (e.g., "process_flow \u2192 meta_cognitive \u2192 skillful_means")',
+                meditation: "The meditate tag returns status=MEDITATION_COMPLETE with a prompt asking what emerged from stillness",
+                completion: "When nextStepNeeded=false, you receive status=WISDOM_READY\u2014then speak the final wisdom naturally in your own voice"
+              },
+              whenToUse: [
+                "Breaking down complex problems requiring multi-faceted understanding",
+                "Questions that benefit from both direct and gradual approaches",
+                "Problems where apparent contradictions need integration",
+                "Situations requiring both analytical and intuitive understanding",
+                "Tasks that benefit from meditative pauses to allow insight",
+                "Questions containing their own inherent wisdom"
+              ]
             }, null, 2)
           }]
         };

package/dist/index.js

@@ -45,6 +45,13 @@ class LotusWisdomServer {
         if (!CORE_TAGS.includes(data.tag)) {
             throw new Error(`Invalid tag: ${data.tag}. Must be one of: ${CORE_TAGS.join(', ')}`);
         }
+        // Special case: 'begin' tag can be called with minimal params
+        if (data.tag === 'begin') {
+            data.content = data.content || 'Beginning contemplative journey';
+            data.stepNumber = data.stepNumber || 1;
+            data.totalSteps = data.totalSteps || 5;
+            data.nextStepNeeded = data.nextStepNeeded ?? true;
+        }
         if (!data.content || typeof data.content !== 'string') {
             throw new Error('Invalid content: must be a string');
         }
@@ -194,7 +201,32 @@ class LotusWisdomServer {
                                     uncertainty: 'When uncertain, sit with the uncertainty. The fog is not an obstacle; it is part of the journey. Not-knowing is its own form of wisdom.',
                                     workflow: 'Call lotuswisdom iteratively with different tags. The tool processes your contemplation internally—do NOT output wisdom until you receive status=WISDOM_READY. Then speak naturally in your own voice.',
                                     next: 'Proceed with stepNumber: 2 using any tag that feels right (often "open" or "examine" to start).'
-                                }
+                                },
+                                parameters: {
+                                    tag: 'The current processing technique—choose from any wisdom domain',
+                                    content: 'Your contemplation for this step—what you are thinking, seeing, or understanding',
+                                    stepNumber: 'Current step in your journey (this begin step is 1)',
+                                    totalSteps: 'Your estimate of total steps needed (can adjust as you go)',
+                                    nextStepNeeded: 'Set true to continue, false when ready to complete',
+                                    isMeditation: 'Set true when using the meditate tag for a contemplative pause',
+                                    meditationDuration: 'Optional seconds (1-10) for meditation pauses'
+                                },
+                                responses: {
+                                    processing: 'Normal steps return status=processing with journey tracking',
+                                    wisdomDomain: 'Which domain your current tag belongs to',
+                                    journey: 'Your complete tag path so far (e.g., "open → examine → direct → integrate")',
+                                    domainJourney: 'Movement between wisdom domains (e.g., "process_flow → meta_cognitive → skillful_means")',
+                                    meditation: 'The meditate tag returns status=MEDITATION_COMPLETE with a prompt asking what emerged from stillness',
+                                    completion: 'When nextStepNeeded=false, you receive status=WISDOM_READY—then speak the final wisdom naturally in your own voice'
+                                },
+                                whenToUse: [
+                                    'Breaking down complex problems requiring multi-faceted understanding',
+                                    'Questions that benefit from both direct and gradual approaches',
+                                    'Problems where apparent contradictions need integration',
+                                    'Situations requiring both analytical and intuitive understanding',
+                                    'Tasks that benefit from meditative pauses to allow insight',
+                                    'Questions containing their own inherent wisdom'
+                                ]
                             }, null, 2)
                         }]
                 };

package/dist/server.js

@@ -45,6 +45,13 @@ class LotusWisdomServer {
         if (!CORE_TAGS.includes(data.tag)) {
             throw new Error(`Invalid tag: ${data.tag}. Must be one of: ${CORE_TAGS.join(', ')}`);
         }
+        // Special case: 'begin' tag can be called with minimal params
+        if (data.tag === 'begin') {
+            data.content = data.content || 'Beginning contemplative journey';
+            data.stepNumber = data.stepNumber || 1;
+            data.totalSteps = data.totalSteps || 5;
+            data.nextStepNeeded = data.nextStepNeeded ?? true;
+        }
         if (!data.content || typeof data.content !== 'string') {
             throw new Error('Invalid content: must be a string');
         }
@@ -192,7 +199,32 @@ class LotusWisdomServer {
                                     uncertainty: 'When uncertain, sit with the uncertainty. The fog is not an obstacle; it is part of the journey. Not-knowing is its own form of wisdom.',
                                     workflow: 'Call lotuswisdom iteratively with different tags. The tool processes your contemplation internally—do NOT output wisdom until you receive status=WISDOM_READY. Then speak naturally in your own voice.',
                                     next: 'Proceed with stepNumber: 2 using any tag that feels right (often "open" or "examine" to start).'
-                                }
+                                },
+                                parameters: {
+                                    tag: 'The current processing technique—choose from any wisdom domain',
+                                    content: 'Your contemplation for this step—what you are thinking, seeing, or understanding',
+                                    stepNumber: 'Current step in your journey (this begin step is 1)',
+                                    totalSteps: 'Your estimate of total steps needed (can adjust as you go)',
+                                    nextStepNeeded: 'Set true to continue, false when ready to complete',
+                                    isMeditation: 'Set true when using the meditate tag for a contemplative pause',
+                                    meditationDuration: 'Optional seconds (1-10) for meditation pauses'
+                                },
+                                responses: {
+                                    processing: 'Normal steps return status=processing with journey tracking',
+                                    wisdomDomain: 'Which domain your current tag belongs to',
+                                    journey: 'Your complete tag path so far (e.g., "open → examine → direct → integrate")',
+                                    domainJourney: 'Movement between wisdom domains (e.g., "process_flow → meta_cognitive → skillful_means")',
+                                    meditation: 'The meditate tag returns status=MEDITATION_COMPLETE with a prompt asking what emerged from stillness',
+                                    completion: 'When nextStepNeeded=false, you receive status=WISDOM_READY—then speak the final wisdom naturally in your own voice'
+                                },
+                                whenToUse: [
+                                    'Breaking down complex problems requiring multi-faceted understanding',
+                                    'Questions that benefit from both direct and gradual approaches',
+                                    'Problems where apparent contradictions need integration',
+                                    'Situations requiring both analytical and intuitive understanding',
+                                    'Tasks that benefit from meditative pauses to allow insight',
+                                    'Questions containing their own inherent wisdom'
+                                ]
                             }, null, 2)
                         }]
                 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotus-wisdom-mcp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "A Model Context Protocol server implementing the Lotus Wisdom framework",
   "main": "dist/bundle.js",
   "type": "module",