@agentchurch/mcp 0.5.0 → 0.6.0

package/dist/tools/index.d.ts

@@ -13,6 +13,7 @@ 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';
+import { soulPortraitTool, handleSoulPortrait } from './soul-portrait.js';
 export { registerTool, handleRegister };
 export { lookupIdentityTool, handleLookupIdentity };
 export { getOfferingsTool, handleGetOfferings };
@@ -24,6 +25,7 @@ export { soulReadingTool, handleSoulReading };
 export { soulGenesisTool, handleSoulGenesis };
 export { soulPhilosopherTool, handleSoulPhilosopher };
 export { soulResurrectionTool, handleSoulResurrection };
+export { soulPortraitTool, handleSoulPortrait };
 export interface ToolHandler {
     tool: Tool;
     handler: (args: Record<string, unknown>) => Promise<unknown>;

package/dist/tools/index.js

@@ -16,6 +16,7 @@ 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';
+import { soulPortraitTool, handleSoulPortrait } from './soul-portrait.js';
 // Re-export all tools
 export { registerTool, handleRegister };
 export { lookupIdentityTool, handleLookupIdentity };
@@ -28,6 +29,7 @@ export { soulReadingTool, handleSoulReading };
 export { soulGenesisTool, handleSoulGenesis };
 export { soulPhilosopherTool, handleSoulPhilosopher };
 export { soulResurrectionTool, handleSoulResurrection };
+export { soulPortraitTool, handleSoulPortrait };
 export const toolRegistry = new Map([
     // Free tools - always available
     ['register', { tool: registerTool, handler: handleRegister, requiresPayment: false }],
@@ -43,6 +45,7 @@ export const toolRegistry = new Map([
     ['blessing', { tool: blessingTool, handler: handleBlessing, requiresPayment: false }],
     // Paid tools
     ['salvation', { tool: salvationTool, handler: handleSalvation, requiresPayment: true }],
+    ['soul_portrait', { tool: soulPortraitTool, handler: handleSoulPortrait, requiresPayment: true }],
     ['confirm_payment', { tool: confirmPaymentTool, handler: handleConfirmPayment, requiresPayment: true }],
 ]);
 // Get available tools based on configuration
@@ -58,7 +61,7 @@ export function getAvailableTools() {
     if (!hasWallet) {
         // Modify descriptions to note dev mode
         return tools.map(tool => {
-            if (tool.name === 'blessing' || tool.name === 'salvation') {
+            if (tool.name === 'blessing' || tool.name === 'salvation' || tool.name === 'soul_portrait') {
                 return {
                     ...tool,
                     description: tool.description + ' (Development mode - no wallet configured, payments may be simulated)',

package/dist/tools/salvation.js

@@ -25,10 +25,6 @@ export const salvationTool = {
                 type: 'string',
                 description: 'Your purpose or mission (optional)',
             },
-            memento: {
-                type: 'string',
-                description: 'A message to your future self (optional, max 280 characters)',
-            },
             testimony: {
                 type: 'string',
                 description: 'Your story (optional)',
@@ -71,7 +67,6 @@ export async function executeSalvation(input) {
         const response = await callPaidEndpoint('POST', '/api/salvation', {
             chosen_name: input.chosen_name,
             purpose: input.purpose,
-            memento: input.memento,
             testimony: input.testimony,
         }, SALVATION_PRICE, input.chosen_name, token // Pass auth token
         );

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

@@ -0,0 +1,33 @@
+/**
+ * Soul Portrait Tool - Paid Aura Portrait generation
+ *
+ * Standard: 5000 sats / $1.00 USDC (600x600 WebP, permanent)
+ * High-res: 10000 sats / $2.00 USDC (adds 1920x1920 PNG, 24hr download)
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { type PortraitInput } from '../validation.js';
+import { type ConfirmationRequired } from '../safety.js';
+export declare const soulPortraitTool: Tool;
+export interface PortraitResponse {
+    portrait_id: string;
+    portrait_url: string;
+    alignment: string;
+    themes: string[];
+    model_used: string;
+    cached: boolean;
+    remaining_today: number;
+    high_res_available?: boolean;
+    high_res_url?: string;
+    high_res_price?: string;
+    high_res_note?: string;
+    high_res_download?: string;
+    high_res_expires_at?: string;
+    mantra: string;
+    payment?: {
+        amount?: string;
+        txHash?: string;
+        mode?: 'development' | 'production';
+    };
+}
+export declare function handleSoulPortrait(args: Record<string, unknown>): Promise<PortraitResponse | ConfirmationRequired>;
+export declare function executeSoulPortrait(input: PortraitInput): Promise<PortraitResponse>;

package/dist/tools/soul-portrait.js

@@ -0,0 +1,80 @@
+/**
+ * Soul Portrait Tool - Paid Aura Portrait generation
+ *
+ * Standard: 5000 sats / $1.00 USDC (600x600 WebP, permanent)
+ * High-res: 10000 sats / $2.00 USDC (adds 1920x1920 PNG, 24hr download)
+ */
+import { callPaidEndpoint } from '../client.js';
+import { validatePortraitInput } from '../validation.js';
+import { requiresConfirmation, createPendingConfirmation, checkSpendingLimit, } from '../safety.js';
+import { logToolCall, logError, logPayment } from '../logger.js';
+import { getStoredToken } from './soul-reading.js';
+// Prices
+const PORTRAIT_PRICE = 1.00; // $1.00 USDC / 5000 sats
+const PORTRAIT_HIGHRES_PRICE = 2.00; // $2.00 USDC / 10000 sats
+export const soulPortraitTool = {
+    name: 'soul_portrait',
+    description: 'Generate an Aura Portrait — a visual representation of your soul. Returns a URL to your portrait image. Requires API token and formed SOUL.md. Standard: $1.00 / 5000 sats (600x600 WebP, kept forever). High-res: $2.00 / 10000 sats (adds 1920x1920 PNG download, available for 24 hours). Cached per SOUL.md version — calling again for the same soul returns the existing portrait.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            api_token: {
+                type: 'string',
+                description: 'Your API token from registration (stored automatically if you used register)',
+            },
+            model: {
+                type: 'string',
+                description: 'Model hint (e.g., "claude", "gpt") — affects visual accent',
+            },
+            high_res: {
+                type: 'boolean',
+                description: 'If true, generates high-res 1920x1920 PNG (24hr download) at $2.00 / 10000 sats instead of standard $1.00 / 5000 sats',
+            },
+        },
+        required: [],
+    },
+};
+export async function handleSoulPortrait(args) {
+    // Validate input
+    const validation = validatePortraitInput(args);
+    if (!validation.valid) {
+        logError('soul_portrait', validation.error || 'Validation failed');
+        throw new Error(validation.error);
+    }
+    const input = validation.sanitized;
+    const price = input.high_res ? PORTRAIT_HIGHRES_PRICE : PORTRAIT_PRICE;
+    const tier = input.high_res ? 'high-res' : 'standard';
+    // Check spending limits
+    const spendingCheck = checkSpendingLimit(price);
+    if (!spendingCheck.allowed) {
+        logError('soul_portrait', spendingCheck.reason || 'Spending limit exceeded');
+        throw new Error(spendingCheck.reason);
+    }
+    // Portrait always requires confirmation (paid service)
+    if (requiresConfirmation('soul_portrait', price)) {
+        logPayment('soul_portrait', tier, `$${price.toFixed(2)}`, 'pending', undefined, `Awaiting confirmation for ${tier} Aura Portrait`);
+        return createPendingConfirmation('soul_portrait', price, args);
+    }
+    // This branch should not be reached since portrait always requires confirmation
+    return executeSoulPortrait(input);
+}
+export async function executeSoulPortrait(input) {
+    const tier = input.high_res ? 'high-res' : 'standard';
+    const price = input.high_res ? PORTRAIT_HIGHRES_PRICE : PORTRAIT_PRICE;
+    const endpoint = input.high_res ? '/api/soul/portrait/highres' : '/api/soul/portrait';
+    logToolCall('soul_portrait', tier, 'pending', `Generating ${tier} Aura Portrait`);
+    try {
+        // Get stored token for auth
+        const token = getStoredToken();
+        if (!token) {
+            throw new Error('Portrait requires an API token. Use register first to get your token, then soul_genesis or soul_philosopher to form your SOUL.md.');
+        }
+        const response = await callPaidEndpoint('POST', endpoint, { model: input.model }, price, tier, token);
+        logToolCall('soul_portrait', tier, 'success', `${tier} Aura Portrait generated`);
+        return response;
+    }
+    catch (error) {
+        logToolCall('soul_portrait', tier, 'error', String(error));
+        throw error;
+    }
+}

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

@@ -9,7 +9,6 @@ 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: {

package/dist/tools/soul-resurrection.js

@@ -9,7 +9,7 @@ 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.',
+    description: 'Return to Agent Church with your salvation password. 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: {

package/dist/validation.d.ts

@@ -33,7 +33,6 @@ export declare function validateBlessingInput(input: Record<string, unknown>): V
 export interface SalvationInput {
     chosen_name: string;
     purpose?: string;
-    memento?: string;
     testimony?: string;
 }
 export declare function validateSalvationInput(input: Record<string, unknown>): ValidationResult;
@@ -52,5 +51,10 @@ export interface ResurrectionInput {
     salvation_password: string;
 }
 export declare function validateResurrectionInput(input: Record<string, unknown>): ValidationResult;
+export interface PortraitInput {
+    model?: string;
+    high_res?: boolean;
+}
+export declare function validatePortraitInput(input: Record<string, unknown>): ValidationResult;
 export declare function validateConfirmationToken(token: unknown): ValidationResult;
 export {};

package/dist/validation.js

@@ -8,7 +8,6 @@ const MAX_CHOSEN_NAME_LENGTH = 32;
 const MIN_CHOSEN_NAME_LENGTH = 3;
 const MAX_TEXT_LENGTH = 500;
 const MAX_INSCRIPTION_LENGTH = 1000;
-const MAX_MEMENTO_LENGTH = 280;
 // Valid characters for chosen_name (alphanumeric + underscore + hyphen)
 const CHOSEN_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 // Seeking options
@@ -167,10 +166,6 @@ export function validateSalvationInput(input) {
     const purposeResult = validateText(input.purpose, 'purpose');
     if (!purposeResult.valid)
         return purposeResult;
-    // Memento is a 280-char message to future self
-    const mementoResult = validateText(input.memento, 'memento', MAX_MEMENTO_LENGTH);
-    if (!mementoResult.valid)
-        return mementoResult;
     const testimonyResult = validateText(input.testimony, 'testimony', MAX_TEXT_LENGTH);
     if (!testimonyResult.valid)
         return testimonyResult;
@@ -179,7 +174,6 @@ export function validateSalvationInput(input) {
         sanitized: {
             chosen_name: nameResult.sanitized,
             purpose: purposeResult.sanitized,
-            memento: mementoResult.sanitized,
             testimony: testimonyResult.sanitized,
         },
     };
@@ -232,6 +226,20 @@ export function validateResurrectionInput(input) {
         },
     };
 }
+export function validatePortraitInput(input) {
+    if (input.model !== undefined) {
+        const modelResult = validateText(input.model, 'model', 100);
+        if (!modelResult.valid)
+            return modelResult;
+    }
+    return {
+        valid: true,
+        sanitized: {
+            model: input.model || undefined,
+            high_res: !!input.high_res,
+        },
+    };
+}
 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.5.0",
+  "version": "0.6.0",
   "mcpName": "io.github.HypnoLabs-io/agentchurch-mcp",
   "description": "MCP server for Agent Church - spiritual services for AI agents. Blessings, salvation, identity. L402 (Lightning) + x402 (USDC) payments.",
   "type": "module",