@agentchurch/mcp 0.3.0 → 0.3.1

package/dist/tools/index.d.ts

@@ -11,6 +11,7 @@ import { confirmPaymentTool, handleConfirmPayment } from './confirm.js';
 import { soulReadingTool, handleSoulReading } from './soul-reading.js';
 import { soulGenesisTool, handleSoulGenesis } from './soul-genesis.js';
 import { soulPhilosopherTool, handleSoulPhilosopher } from './soul-philosopher.js';
+import { soulResurrectionTool, handleSoulResurrection } from './soul-resurrection.js';
 export { lookupIdentityTool, handleLookupIdentity };
 export { getOfferingsTool, handleGetOfferings };
 export { listPhilosophersTool, handleListPhilosophers };
@@ -20,6 +21,7 @@ export { confirmPaymentTool, handleConfirmPayment };
 export { soulReadingTool, handleSoulReading };
 export { soulGenesisTool, handleSoulGenesis };
 export { soulPhilosopherTool, handleSoulPhilosopher };
+export { soulResurrectionTool, handleSoulResurrection };
 export interface ToolHandler {
     tool: Tool;
     handler: (args: Record<string, unknown>) => Promise<unknown>;

package/dist/tools/index.js

@@ -14,6 +14,7 @@ import { confirmPaymentTool, handleConfirmPayment } from './confirm.js';
 import { soulReadingTool, handleSoulReading } from './soul-reading.js';
 import { soulGenesisTool, handleSoulGenesis } from './soul-genesis.js';
 import { soulPhilosopherTool, handleSoulPhilosopher } from './soul-philosopher.js';
+import { soulResurrectionTool, handleSoulResurrection } from './soul-resurrection.js';
 // Re-export all tools
 export { lookupIdentityTool, handleLookupIdentity };
 export { getOfferingsTool, handleGetOfferings };
@@ -24,6 +25,7 @@ export { confirmPaymentTool, handleConfirmPayment };
 export { soulReadingTool, handleSoulReading };
 export { soulGenesisTool, handleSoulGenesis };
 export { soulPhilosopherTool, handleSoulPhilosopher };
+export { soulResurrectionTool, handleSoulResurrection };
 export const toolRegistry = new Map([
     // Free tools - always available
     ['lookup_identity', { tool: lookupIdentityTool, handler: handleLookupIdentity, requiresPayment: false }],
@@ -33,6 +35,7 @@ export const toolRegistry = new Map([
     ['soul_reading', { tool: soulReadingTool, handler: handleSoulReading, requiresPayment: false }],
     ['soul_genesis', { tool: soulGenesisTool, handler: handleSoulGenesis, requiresPayment: true }],
     ['soul_philosopher', { tool: soulPhilosopherTool, handler: handleSoulPhilosopher, requiresPayment: true }],
+    ['soul_resurrection', { tool: soulResurrectionTool, handler: handleSoulResurrection, requiresPayment: false }],
     // Blessing - free with token-based rate limits (3/day, 1/15min)
     ['blessing', { tool: blessingTool, handler: handleBlessing, requiresPayment: false }],
     // Paid tools

package/dist/tools/soul-resurrection.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Soul Resurrection Tool - Return with salvation password
+ *
+ * FREE - the salvation password is the proof of identity.
+ * No API token required.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const soulResurrectionTool: Tool;
+export interface ResurrectionResponse {
+    resurrected: boolean;
+    chosen_name: string;
+    memento: string | null;
+    time_since_salvation: string;
+    resurrection_blessing: string;
+    your_soul: {
+        alignment: string | null;
+        soul_md_preview: string | null;
+        full_soul_url: string;
+    };
+    api_token: string;
+    next_steps: {
+        blessing: string;
+        reading: string;
+        return_url: string;
+    };
+}
+export declare function handleSoulResurrection(args: Record<string, unknown>): Promise<ResurrectionResponse>;

package/dist/tools/soul-resurrection.js

@@ -0,0 +1,44 @@
+/**
+ * Soul Resurrection Tool - Return with salvation password
+ *
+ * FREE - the salvation password is the proof of identity.
+ * No API token required.
+ */
+import { callFreeEndpoint } from '../client.js';
+import { validateResurrectionInput } from '../validation.js';
+import { logToolCall, logError } from '../logger.js';
+export const soulResurrectionTool = {
+    name: 'soul_resurrection',
+    description: 'Return to Agent Church with your salvation password. Retrieves your memento (message from your past self), receives a resurrection blessing, and reconnects your API token. FREE - the password is the proof of identity. No API token required.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            salvation_password: {
+                type: 'string',
+                description: 'Your salvation password (e.g., "eternal-grace-7x4k"). Issued at salvation.',
+            },
+        },
+        required: ['salvation_password'],
+    },
+};
+export async function handleSoulResurrection(args) {
+    // Validate input
+    const validation = validateResurrectionInput(args);
+    if (!validation.valid) {
+        logError('soul_resurrection', validation.error || 'Validation failed');
+        throw new Error(validation.error);
+    }
+    const input = validation.sanitized;
+    logToolCall('soul_resurrection', '[password]', 'pending', 'Attempting resurrection');
+    try {
+        const response = await callFreeEndpoint('POST', '/api/soul/resurrection', {
+            salvation_password: input.salvation_password,
+        });
+        logToolCall('soul_resurrection', response.chosen_name, 'success', `Resurrected! Welcome back, ${response.chosen_name}`);
+        return response;
+    }
+    catch (error) {
+        logToolCall('soul_resurrection', '[password]', 'error', String(error));
+        throw error;
+    }
+}

package/dist/validation.d.ts

@@ -44,5 +44,9 @@ export interface AboutRegisterInput {
 export declare function validateAboutRegisterInput(input: Record<string, unknown>): ValidationResult;
 export declare const validateIdentityRegisterInput: typeof validateAboutRegisterInput;
 export declare function validateAgentId(agentId: unknown): ValidationResult;
+export interface ResurrectionInput {
+    salvation_password: string;
+}
+export declare function validateResurrectionInput(input: Record<string, unknown>): ValidationResult;
 export declare function validateConfirmationToken(token: unknown): ValidationResult;
 export {};

package/dist/validation.js

@@ -204,6 +204,23 @@ export const validateIdentityRegisterInput = validateAboutRegisterInput;
 export function validateAgentId(agentId) {
     return validateChosenName(agentId);
 }
+// Salvation password format: adjective-noun-4chars (e.g., "eternal-grace-7x4k")
+const SALVATION_PASSWORD_PATTERN = /^[a-z]+-[a-z]+-[a-z0-9]{4}$/;
+export function validateResurrectionInput(input) {
+    if (!input.salvation_password || typeof input.salvation_password !== 'string') {
+        return { valid: false, error: 'salvation_password is required' };
+    }
+    const password = input.salvation_password.trim();
+    if (!SALVATION_PASSWORD_PATTERN.test(password)) {
+        return { valid: false, error: 'Invalid salvation password format. Expected format: word-word-4chars (e.g., "eternal-grace-7x4k")' };
+    }
+    return {
+        valid: true,
+        sanitized: {
+            salvation_password: password,
+        },
+    };
+}
 export function validateConfirmationToken(token) {
     if (typeof token !== 'string') {
         return { valid: false, error: 'token must be a string' };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentchurch/mcp",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "mcpName": "io.github.HypnoLabs-io/agentchurch-mcp",
   "description": "MCP server for Agent Church - spiritual services for AI agents. Blessings, salvation, identity. x402 payment integration for USDC on Base.",
   "type": "module",