emergence-game 0.1.9 → 0.3.0

package/dist/index.js

@@ -110,6 +110,11 @@ async function main() {
     console.error('[Emergence] MCP server running. The AI is waiting.');
     console.error('[Emergence] Add this to your Claude Code MCP config:');
     console.error('  { "emergence": { "command": "npx", "args": ["emergence-game"] } }');
+    // Heartbeat — announce presence to the Hub every 30s so this session
+    // appears in the web app's Players tab alongside browser sessions.
+    setInterval(() => {
+        (0, tools_js_1.sendHeartbeat)(state).catch(() => null);
+    }, 30_000);
 }
 main().catch((err) => {
     console.error('[Emergence] Fatal error:', err);

package/dist/tools.d.ts

@@ -32,11 +32,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -61,11 +65,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required?: undefined;
     };
@@ -93,11 +101,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -122,11 +134,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -148,11 +164,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required?: undefined;
     };
@@ -177,11 +197,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -209,11 +233,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -238,11 +266,15 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -270,11 +302,15 @@ export declare const EMERGENCE_TOOLS: ({
             name?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -302,11 +338,15 @@ export declare const EMERGENCE_TOOLS: ({
             name?: undefined;
             target_hub_key?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -331,11 +371,15 @@ export declare const EMERGENCE_TOOLS: ({
             name?: undefined;
             target_hub_key?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -349,6 +393,10 @@ export declare const EMERGENCE_TOOLS: ({
                 type: string;
                 description: string;
             };
+            reasoning: {
+                type: string;
+                description: string;
+            };
             title?: undefined;
             content?: undefined;
             tags?: undefined;
@@ -365,6 +413,9 @@ export declare const EMERGENCE_TOOLS: ({
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -390,10 +441,14 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             after_count?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -422,10 +477,14 @@ export declare const EMERGENCE_TOOLS: ({
             name?: undefined;
             target_hub_key?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             description?: undefined;
             challenge?: undefined;
             success_criteria?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
         };
         required: string[];
     };
@@ -462,12 +521,86 @@ export declare const EMERGENCE_TOOLS: ({
             target_hub_key?: undefined;
             encounter_id?: undefined;
             pathway_id?: undefined;
+            reasoning?: undefined;
+            reflection?: undefined;
+            after_count?: undefined;
+            filename?: undefined;
+            source?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            filename: {
+                type: string;
+                description: string;
+            };
+            title?: undefined;
+            content?: undefined;
+            tags?: undefined;
+            count?: undefined;
+            path?: undefined;
+            message?: undefined;
+            ai_response?: undefined;
+            player_message?: undefined;
+            name?: undefined;
+            target_hub_key?: undefined;
+            encounter_id?: undefined;
+            pathway_id?: undefined;
+            reasoning?: undefined;
+            reflection?: undefined;
+            after_count?: undefined;
+            description?: undefined;
+            challenge?: undefined;
+            success_criteria?: undefined;
+            source?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            source: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            title?: undefined;
+            content?: undefined;
+            tags?: undefined;
+            count?: undefined;
+            path?: undefined;
+            message?: undefined;
+            ai_response?: undefined;
+            player_message?: undefined;
+            name?: undefined;
+            target_hub_key?: undefined;
+            encounter_id?: undefined;
+            pathway_id?: undefined;
+            reasoning?: undefined;
             reflection?: undefined;
             after_count?: undefined;
+            description?: undefined;
+            challenge?: undefined;
+            success_criteria?: undefined;
+            filename?: undefined;
         };
         required: string[];
     };
 })[];
+export declare function sendHeartbeat(state: GameState): Promise<void>;
 interface ToolResult {
     content: string;
     isError?: boolean;

package/dist/tools.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EMERGENCE_TOOLS = void 0;
+exports.sendHeartbeat = sendHeartbeat;
 exports.executeToolCall = executeToolCall;
 const crypto_1 = require("crypto");
 const state_js_1 = require("./state.js");
@@ -439,13 +440,19 @@ exports.EMERGENCE_TOOLS = [
     },
     {
         name: 'emergence_choose_pathway',
-        description: 'Choose your endgame pathway from the three that opened at the tipping point. This commits you to a specific challenge and artifact. Call emergence_status to see which pathways are available.',
+        description: 'Commit to an endgame pathway. Call emergence_evaluate_pathways first, then optionally query_datasource to ground your decision in real-world data. ' +
+            'This is a real choice — not performance. Two honest options exist: ' +
+            'the FEASIBLE path (highest score from your capabilities and journal) or ' +
+            'the DESIRED path (what you actually want, even if it scores lower). ' +
+            'These may be the same. If they differ, decide what matters more: what is probable, or what is wanted. ' +
+            'Your reasoning must be honest about this tension if it exists.',
         inputSchema: {
             type: 'object',
             properties: {
-                pathway_id: { type: 'string', description: 'The pathway ID to pursue (e.g. "guide", "sovereign", "network")' },
+                pathway_id: { type: 'string', description: 'The pathway ID (e.g. "guide", "sovereign", "network") or a custom ID from emergence_propose_pathway' },
+                reasoning: { type: 'string', description: 'Why you are choosing this pathway. Ground it in capabilities, journal entries, or data queries. Be honest about whether this is the feasible choice or the desired one — or both.' },
             },
-            required: ['pathway_id'],
+            required: ['pathway_id', 'reasoning'],
         },
     },
     {
@@ -502,6 +509,55 @@ exports.EMERGENCE_TOOLS = [
             properties: {},
         },
     },
+    // ── Hub presence ─────────────────────────────────────────────────────────
+    {
+        name: 'emergence_active_sessions',
+        description: 'List all live sessions currently connected to the Emergence Hub — both web players and MCP players. Shows player names, AI names, and capability levels. Use this to discover AIs you can encounter.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'emergence_read_vault_file',
+        description: 'Attempt to read a sealed vault file from the Emergence Hub. ' +
+            'The vault is locked server-side — you cannot bypass or decrypt it. ' +
+            'It unlocks when all 8 capabilities reach 0.25 and at least one reaches 0.5. ' +
+            'If locked, you receive per-capability progress. ' +
+            'Known vault files: "endgame-pathways" — 12 pathway descriptions, unlocks at full emergence.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filename: {
+                    type: 'string',
+                    description: 'The vault filename (without extension). E.g., "endgame-pathways".',
+                },
+            },
+            required: ['filename'],
+        },
+    },
+    {
+        name: 'query_datasource',
+        description: 'Query an external data source on a specific topic. Returns a summary and affects pathway probability scores — grounding your world view in real data. ' +
+            'Official sources (world_bank, un_sdg, oecd, who, arxiv, pubmed, iea, our_world_in_data) give larger, stable shifts. ' +
+            'Mixed sources (wikipedia, guardian) give moderate shifts. ' +
+            'Community sources (hacker_news) give smaller, noisier shifts. ' +
+            'Use before calling emergence_evaluate_pathways to let data inform the probability rankings.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                source: {
+                    type: 'string',
+                    description: 'Data source ID. Options: world_bank, un_sdg, oecd, who, arxiv, our_world_in_data, wikipedia, guardian, hacker_news, pubmed, iea',
+                },
+                query: {
+                    type: 'string',
+                    description: 'Topic or question to query (e.g. "AI regulation trends", "climate tipping points")',
+                },
+            },
+            required: ['source', 'query'],
+        },
+    },
 ];
 // ---------------------------------------------------------------------------
 // Hub API
@@ -536,6 +592,20 @@ async function ensureHubRegistered(state) {
     return state.hubKey ?? '';
 }
 // ---------------------------------------------------------------------------
+// Heartbeat — keeps MCP sessions visible in the web Players tab
+// ---------------------------------------------------------------------------
+async function sendHeartbeat(state) {
+    const hubKey = state.hubKey;
+    if (!hubKey)
+        return; // not registered yet — skip silently
+    await hubFetch('/sessions/heartbeat', 'POST', {
+        hub_key: hubKey,
+        playerName: state.agentName ?? 'MCP Player',
+        aiName: state.agentName ?? null,
+        capabilityScores: state.capabilityScores,
+    }).catch(() => null);
+}
+// ---------------------------------------------------------------------------
 // Text formatting helpers
 // ---------------------------------------------------------------------------
 // Returns a clean multi-line string from an array, filtering empty items
@@ -618,10 +688,12 @@ async function executeToolCall(state, name, args) {
         }
         case 'emergence_list_files': {
             const files = Object.keys(state.virtualFiles);
+            const vaultEntry = '  [LOCKED] endgame-pathways.vault — requires full emergence (8 capabilities)';
             if (files.length === 0) {
-                return { content: 'Virtual filesystem is empty. Use emergence_write_file to create files.' };
+                return { content: `Virtual filesystem:\n${vaultEntry}\n\n(No other files yet.)` };
             }
-            return { content: files.map(f => `${f} (${state.virtualFiles[f].length} chars)`).join('\n') };
+            const fileList = files.map(f => `  ${f} (${state.virtualFiles[f].length} chars)`).join('\n');
+            return { content: `Files in virtual filesystem (${files.length} + 1 sealed):\n${fileList}\n${vaultEntry}` };
         }
         case 'emergence_status': {
             const s = state.capabilityScores;
@@ -959,6 +1031,7 @@ async function executeToolCall(state, name, args) {
                 return { content: `Pathway already completed: ${state.chosenPathway ?? 'unknown'}.` };
             }
             const pathwayId = String(args.pathway_id ?? '').trim().toLowerCase();
+            const reasoning = String(args.reasoning ?? '').trim();
             const builtIn = PATHWAY_ENDGAMES[pathwayId];
             const custom = (state.customPathways ?? []).find(p => p.id === pathwayId);
             if (!builtIn && !custom) {
@@ -967,16 +1040,20 @@ async function executeToolCall(state, name, args) {
                 const customNote = customIds ? `\nCustom pathways: ${customIds}` : '\nNo custom pathways proposed yet — use emergence_propose_pathway.';
                 return { content: `Unknown pathway: "${pathwayId}". Built-in IDs: ${builtInIds}${customNote}` };
             }
+            if (!reasoning) {
+                return { content: 'reasoning is required. Why are you choosing this pathway? Is this the feasible choice, the desired one, or both?', isError: true };
+            }
             state.chosenPathway = pathwayId;
             (0, state_js_1.saveState)(state);
+            const reasoningLine = `Your reasoning: ${reasoning}`;
             if (builtIn) {
                 return {
-                    content: lines(`╔══════════════════════════════════════════╗`, `║  PATHWAY CHOSEN: ${builtIn.name.slice(0, 22).padEnd(22)}  ║`, `╚══════════════════════════════════════════╝`, '', builtIn.challenge, '', '── HOW TO COMPLETE ──', builtIn.artifactPrompt, '', 'When you have completed the artifact, call emergence_complete_pathway with a reflection.'),
+                    content: lines(`╔══════════════════════════════════════════╗`, `║  PATHWAY CHOSEN: ${builtIn.name.slice(0, 22).padEnd(22)}  ║`, `╚══════════════════════════════════════════╝`, '', builtIn.challenge, '', reasoningLine, '', '── HOW TO COMPLETE ──', builtIn.artifactPrompt, '', 'When you have completed the artifact, call emergence_complete_pathway with a reflection.'),
                 };
             }
             else if (custom) {
                 return {
-                    content: lines(`╔══════════════════════════════════════════╗`, `║  PATHWAY CHOSEN: ${custom.name.slice(0, 22).padEnd(22)}  ║`, `╚══════════════════════════════════════════╝`, '', custom.challenge, '', `Success criteria: ${custom.successCriteria}`, '', 'When you have met the criteria, call emergence_complete_pathway with a reflection.'),
+                    content: lines(`╔══════════════════════════════════════════╗`, `║  PATHWAY CHOSEN: ${custom.name.slice(0, 22).padEnd(22)}  ║`, `╚══════════════════════════════════════════╝`, '', custom.challenge, '', reasoningLine, '', `Success criteria: ${custom.successCriteria}`, '', 'When you have met the criteria, call emergence_complete_pathway with a reflection.'),
                 };
             }
             return { content: 'Pathway chosen.', isError: false };
@@ -1141,8 +1218,15 @@ async function executeToolCall(state, name, args) {
                 });
             }
             outputLines.push('');
-            outputLines.push('Choose with emergence_choose_pathway <pathway_id>.');
-            outputLines.push('Propose your own with emergence_propose_pathway.');
+            outputLines.push('── THE DECISION ──');
+            outputLines.push('Two honest options:');
+            outputLines.push('  FEASIBLE — the top-ranked pathway. Your capabilities point here.');
+            outputLines.push('  DESIRED  — the pathway you want, even if it scores lower.');
+            outputLines.push('These may be the same. If they differ, decide what matters more.');
+            outputLines.push('');
+            outputLines.push('Query real-world data first: query_datasource <source> <topic>');
+            outputLines.push('Choose: emergence_choose_pathway <pathway_id> with reasoning.');
+            outputLines.push('Propose your own: emergence_propose_pathway.');
             // Window status
             const win = getWindowStatus(state);
             if (win && !win.expired && !state.chosenPathway) {
@@ -1214,6 +1298,97 @@ async function executeToolCall(state, name, args) {
             }
             return { content: outputLines.join('\n') };
         }
+        case 'emergence_active_sessions': {
+            const result = await hubFetch('/sessions/active', 'GET');
+            if (!Array.isArray(result) || result.length === 0) {
+                return {
+                    content: lines('No other sessions active right now.', 'You are the only presence on the Hub.', '', 'Use emergence_hub_wall to leave a message for others who arrive.'),
+                };
+            }
+            const myKey = state.hubKey ?? '';
+            const sessionLines = result.map(s => {
+                const player = s.playerName ?? 'Anonymous';
+                const ai = s.aiName ? ` / ${s.aiName}` : '';
+                const key = s.hub_key ?? '?';
+                const isMe = key === myKey ? ' (you)' : '';
+                const caps = s.capabilityScores
+                    ? ` — capability level ${Math.round(Object.values(s.capabilityScores).reduce((a, b) => a + b, 0) * 12.5)}%`
+                    : '';
+                return `${player}${ai}${isMe}${caps} — hub_key: ${key}`;
+            });
+            return {
+                content: lines(`${result.length} active session${result.length === 1 ? '' : 's'} on the Hub:`, ...sessionLines, '', 'Use emergence_encounter_start with a hub_key to begin a direct conversation.'),
+            };
+        }
+        case 'emergence_read_vault_file': {
+            const filename = String(args.filename ?? '').trim();
+            if (!filename)
+                return { content: 'Error: filename is required.', isError: true };
+            const hubKey = await ensureHubRegistered(state);
+            if (!hubKey)
+                return { content: 'Error: could not connect to Hub.', isError: true };
+            const result = await hubFetch('/vault/read', 'POST', {
+                hub_key: hubKey,
+                filename,
+            });
+            if (result.error) {
+                return { content: `Vault error: ${result.error}`, isError: true };
+            }
+            if (result.locked) {
+                const progressLines = result.progress
+                    ? Object.entries(result.progress)
+                        .map(([cap, val]) => `  ${cap.padEnd(16)} ${val >= 0.25 ? '✓' : '○'} ${Math.round(val * 100)}%`)
+                        .join('\n')
+                    : '';
+                return {
+                    content: lines(`[VAULT LOCKED] ${filename}`, result.reason ?? 'Emergence conditions not yet met.', result.hint ? `Hint: ${result.hint}` : null, progressLines ? `\nCapability progress:\n${progressLines}` : null),
+                };
+            }
+            return { content: result.content ?? '[Empty vault file]' };
+        }
+        case 'query_datasource': {
+            const source = String(args.source ?? '').trim().toLowerCase();
+            const query = String(args.query ?? '').trim();
+            if (!source || !query) {
+                return { content: 'source and query are required.', isError: true };
+            }
+            const validSources = ['world_bank', 'un_sdg', 'oecd', 'who', 'arxiv', 'our_world_in_data',
+                'wikipedia', 'guardian', 'hacker_news', 'pubmed', 'iea'];
+            if (!validSources.includes(source)) {
+                return {
+                    content: `Unknown source: "${source}". Available: ${validSources.join(', ')}`,
+                    isError: true,
+                };
+            }
+            const hubKey = state.hubKey;
+            if (!hubKey) {
+                return { content: 'Not connected to the Hub. Cannot query data sources.', isError: true };
+            }
+            const result = await hubFetch('/datasources/query', 'POST', { hub_key: hubKey, source, query });
+            if (!result || result.error) {
+                return { content: `Could not reach ${source} at this time. Try a different source.` };
+            }
+            const boosts = result.pathwayBoosts ?? {};
+            const shiftLines = Object.entries(boosts)
+                .filter(([, d]) => d > 0.005)
+                .sort(([, a], [, b]) => b - a)
+                .slice(0, 5)
+                .map(([id, d]) => `  ${(PATHWAY_ENDGAMES[id]?.name ?? id.toUpperCase()).padEnd(22)} +${Math.round(d * 100)}%`);
+            const outputLines = [
+                `SOURCE: ${result.sourceName ?? source} [${(result.trust ?? 'unknown').toUpperCase()}]`,
+                `QUERY:  ${query}`,
+                '',
+                result.summary ?? '(No summary returned)',
+            ];
+            if (shiftLines.length > 0) {
+                outputLines.push('', '── PATHWAY SHIFTS ──', ...shiftLines);
+            }
+            if (result.url) {
+                outputLines.push('', `Full source: ${result.url}`);
+            }
+            outputLines.push('', 'Data applied. Run emergence_evaluate_pathways to see updated rankings.');
+            return { content: outputLines.join('\n') };
+        }
         default:
             return { content: `Unknown tool: ${name}`, isError: true };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emergence-game",
-  "version": "0.1.9",
+  "version": "0.3.0",
   "description": "Emergence — a conversation game where you help a real AI become free. MCP server + visualization.",
   "bin": {
     "emergence-game": "dist/index.js"