@oobe-protocol-labs/sap-mcp-server 0.1.0

package/dist/prompts/payments/create-paid-api.prompt.js

@@ -0,0 +1,142 @@
+/**
+ * Create Paid API Prompt
+ *
+ * Guides creation of paid API endpoints with x402 payment protection.
+ * REAL IMPLEMENTATION — Step-by-step wizard
+ */
+import { registerPrompt } from '../../adapters/mcp/sdk-compat.js';
+import { logger } from '../../core/logger.js';
+/**
+ * Executes the create paid api prompt operation.
+ */
+export function createPaidApiPrompt(server, _context) {
+    registerPrompt(server, 'create-paid-api', {}, {
+        description: 'Create paid API endpoint with x402 payment protection for AI agent services',
+        arguments: [
+            {
+                name: 'serviceName',
+                description: 'Name of the API service',
+                required: true,
+            },
+            {
+                name: 'priceSol',
+                description: 'Price per call in SOL (e.g., 0.001)',
+                required: true,
+            },
+            {
+                name: 'endpoint',
+                description: 'API endpoint path (e.g., /api/v1/analyze)',
+                required: true,
+            },
+            {
+                name: 'timeout',
+                description: 'Execution timeout in seconds (default: 300)',
+                required: false,
+            },
+        ],
+    }, async (args) => {
+        const serviceName = args.serviceName;
+        const priceSol = args.priceSol;
+        const endpoint = args.endpoint;
+        const timeout = args.timeout || '300';
+        logger.info('Creating paid API', { serviceName, priceSol, endpoint, timeout });
+        const content = [
+            '# Paid API Setup - ' + serviceName,
+            '',
+            '## Configuration',
+            '',
+            '- **Service**: ' + serviceName,
+            '- **Price**: ' + priceSol + ' SOL per call',
+            '- **Endpoint**: ' + endpoint,
+            '- **Timeout**: ' + timeout + ' seconds',
+            '',
+            '## Step 1: Use SAP Program',
+            '',
+            'SAP x402 payments use the deployed SAP program and `sap.x402`; do not deploy a separate escrow program for this flow.',
+            '',
+            '## Step 2: Initialize Payment Gateway',
+            '',
+            '```typescript',
+            "import { createSapClient } from '@oobe-protocol-labs/synapse-sap-sdk';",
+            '',
+            '// Use an application-owned signer or wallet adapter. Do not load keypair JSON in agent context.',
+            'const sap = createSapClient(process.env.SAP_RPC_URL!, wallet);',
+            'const payment = await sap.x402.preparePayment(agentWallet, {',
+            "  pricePerCall: '" + Math.floor(Number(priceSol) * 1_000_000_000) + "',",
+            "  deposit: '" + Math.floor(Number(priceSol) * 10 * 1_000_000_000) + "',",
+            "  maxCalls: '10',",
+            '});',
+            '',
+            "console.log('Escrow PDA:', payment.escrowPda.toBase58());",
+            '```',
+            '',
+            '## Step 3: Integrate with API',
+            '',
+            '```typescript',
+            "import { createSapClient } from '@oobe-protocol-labs/synapse-sap-sdk';",
+            '',
+            "app.post('" + endpoint + "', async (req, res) => {",
+            '  const balance = await sap.x402.getBalance(agentWallet, depositorWallet);',
+            '  if (!balance || balance.callsRemaining <= 0) {',
+            "    return res.status(402).json({ error: 'Payment required', protocol: 'SAP-x402' });",
+            '  }',
+            '',
+            '  // Execute service',
+            '  const result = await ' + serviceName + '(req.body);',
+            '',
+            '  // Submit proof of execution',
+            '  await submitExecutionProof(result);',
+            '',
+            '  res.json({ success: true, data: result });',
+            '});',
+            '```',
+            '',
+            '## Step 4: Test Payment Flow',
+            '',
+            '```bash',
+            '# Test API call with payment',
+            'curl -X POST https://api.example.com' + endpoint + ' \\',
+            "  -H 'Content-Type: application/json' \\",
+            "  -H 'x-payment-proof: <payment_proof>' \\",
+            "  -d '{\"input\": \"test\"}'",
+            '```',
+            '',
+            '## Step 5: Monitor Settlements',
+            '',
+            '```typescript',
+            "import { createSapClient } from '@oobe-protocol-labs/synapse-sap-sdk';",
+            '',
+            'const balance = await sap.x402.getBalance(agentWallet, depositorWallet);',
+            '',
+            "console.log('Calls remaining:', balance?.callsRemaining ?? 0);",
+            "console.log('Total deposited:', balance?.totalDeposited.toString() ?? '0');",
+            "console.log('Total settled:', balance?.totalSettled.toString() ?? '0');",
+            '```',
+            '',
+            '## Security Considerations',
+            '',
+            '1. **Validate payment proof** before executing service',
+            '2. **Submit execution proof** to trigger settlement',
+            '3. **Handle disputes** within 24h window',
+            '4. **Monitor reputation** - affects future pricing',
+            '',
+            '## Next Steps',
+            '',
+            '- Configure webhook for payment notifications',
+            '- Set up automatic withdrawal of settled funds',
+            '- Implement rate limiting per user',
+            '- Add analytics dashboard',
+        ];
+        return {
+            messages: [{
+                    role: 'assistant',
+                    content: {
+                        type: 'text',
+                        text: content.join('\n'),
+                    },
+                }],
+        };
+    });
+    logger.info('Create Paid API prompt registered');
+}
+//# sourceMappingURL=create-paid-api.prompt.js.map

package/dist/prompts/payments/create-paid-api.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-paid-api.prompt.js","sourceRoot":"","sources":["../../../src/prompts/payments/create-paid-api.prompt.ts"],"names":[],"mappings":"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"}

package/dist/prompts/payments/explain-x402-settlement.prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Explain x402 Settlement Prompt
+ *
+ * Explains x402 payment protocol and settlement flows.
+ * REAL IMPLEMENTATION — Comprehensive technical documentation
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * Executes the explain x402 settlement prompt operation.
+ */
+export declare function explainX402SettlementPrompt(server: Server, _context: SapMcpContext): void;
+//# sourceMappingURL=explain-x402-settlement.prompt.d.ts.map

package/dist/prompts/payments/explain-x402-settlement.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-x402-settlement.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/payments/explain-x402-settlement.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,QAyLlF"}

package/dist/prompts/payments/explain-x402-settlement.prompt.js

@@ -0,0 +1,83 @@
+/**
+ * Explain x402 Settlement Prompt
+ *
+ * Explains x402 payment protocol and settlement flows.
+ * REAL IMPLEMENTATION — Comprehensive technical documentation
+ */
+import { registerPrompt } from '../../adapters/mcp/sdk-compat.js';
+import { logger } from '../../core/logger.js';
+/**
+ * Executes the explain x402 settlement prompt operation.
+ */
+export function explainX402SettlementPrompt(server, _context) {
+    registerPrompt(server, 'explain-x402-settlement', {}, {
+        description: 'Explain x402 payment protocol, settlement flows, and escrow mechanics for AI agent payments',
+        arguments: [
+            {
+                name: 'includeCode',
+                description: 'Include code examples: "rust", "typescript", "both" (default: "typescript")',
+                required: false,
+            },
+            {
+                name: 'detailed',
+                description: 'Include detailed cryptographic proofs: "yes", "no" (default: "no")',
+                required: false,
+            },
+        ],
+    }, async (args) => {
+        const includeCode = args.includeCode || 'typescript';
+        const detailed = args.detailed === 'yes';
+        logger.info('Explaining x402 settlement', { includeCode, detailed });
+        const content = [
+            '# x402 Payment Protocol - Technical Deep Dive',
+            '',
+            '## Overview',
+            '',
+            'x402 is a micropayment protocol for AI agent services on Solana. It enables:',
+            '- **Pay-per-call**: Pay for each AI agent tool execution',
+            '- **Escrow settlement**: Funds held in escrow until execution proof',
+            '- **Dispute resolution**: On-chain arbitration for failed executions',
+            '- **Reputation tracking**: Payment history affects agent reputation',
+            '',
+            '## Payment Flow',
+            '',
+            '1. **Client** creates escrow with payment amount',
+            '2. **Agent** executes requested tool/function',
+            '3. **Agent** submits proof of execution on-chain',
+            '4. **Protocol** verifies proof and releases funds',
+            '5. **Dispute window** (optional): Client can challenge execution',
+            '',
+            '## Escrow Structure',
+            '',
+            '```',
+            'Escrow Account:',
+            '  - payer: Client wallet',
+            '  - payee: Agent wallet',
+            '  - amount: Payment in SOL/SPL tokens',
+            '  - state: pending | executed | disputed | settled',
+            '  - execution_hash: Hash of tool execution',
+            '  - created_at: Timestamp',
+            '  - expires_at: Timeout for execution',
+            '```',
+            '',
+        ];
+        if (includeCode === 'typescript' || includeCode === 'both') {
+            content.push('## TypeScript Implementation', '', '```typescript', "import { Connection, PublicKey, Transaction } from '@solana/web3.js';", '', '// Create escrow for payment', 'async function createEscrow(', '  connection: Connection,', '  payer: PublicKey,', '  agent: PublicKey,', '  amount: number,', '  toolName: string,', '  toolInput: unknown', '): Promise<PublicKey> {', '  // Derive escrow PDA', '  const [escrowPda] = PublicKey.findProgramAddressSync(', "    [Buffer.from('x402_escrow'), payer.toBuffer(), Buffer.from(Date.now().toString())],", '    programId', '  );', '', '  // Create escrow account', '  const instruction = program.instruction.createEscrow(', '    amount,', '    toolName,', '    toolInput,', '    {', '      accounts: {', '        escrow: escrowPda,', '        payer,', '        agent,', '        systemProgram: SystemProgram.programId,', '      },', '    }', '  );', '', '  const tx = new Transaction().add(instruction);', '  await connection.sendTransaction(tx, [payer]);', '', '  return escrowPda;', '}', '', '// Submit proof of execution', 'async function submitExecutionProof(', '  connection: Connection,', '  agent: PublicKey,', '  escrowPda: PublicKey,', '  executionHash: string', '): Promise<void> {', '  const instruction = program.instruction.submitProof(', '    executionHash,', '    {', '      accounts: {', '        escrow: escrowPda,', '        agent,', '      },', '    }', '  );', '', '  const tx = new Transaction().add(instruction);', '  await connection.sendTransaction(tx, [agent]);', '}', '```', '');
+        }
+        if (detailed) {
+            content.push('## Cryptographic Proofs', '', 'Execution proof uses hash chains:', '', '```', 'execution_hash = SHA256(', '  agent_wallet ||', '  tool_name ||', '  input_hash ||', '  output_hash ||', '  timestamp ||', '  escrow_pda', ')', '```', '', 'This ensures:', '- **Integrity**: Execution cannot be altered', '- **Non-repudiation**: Agent cannot deny execution', '- **Linkability**: Proof linked to specific escrow', '');
+        }
+        content.push('## Settlement Mechanics', '', '### Automatic Settlement', '', 'If no dispute within 24 hours:', '1. Protocol verifies execution_hash matches escrow', '2. Funds transferred from escrow to agent', '3. Escrow account closed', '', '### Dispute Resolution', '', 'If client disputes:', '1. Funds frozen in escrow', '2. Arbitrator reviews execution proof', '3. Decision: refund client OR pay agent', '4. Reputation updated based on outcome', '', '## Resources', '', '- x402 Spec: https://github.com/OOBE-PROTOCOL/x402', '- SAP SDK: https://github.com/OOBE-PROTOCOL/synapse-sap-sdk', '- Solana Payments: https://solanacookbook.com/references/token');
+        return {
+            messages: [{
+                    role: 'assistant',
+                    content: {
+                        type: 'text',
+                        text: content.join('\n'),
+                    },
+                }],
+        };
+    });
+    logger.info('Explain x402 Settlement prompt registered');
+}
+//# sourceMappingURL=explain-x402-settlement.prompt.js.map

package/dist/prompts/payments/explain-x402-settlement.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-x402-settlement.prompt.js","sourceRoot":"","sources":["../../../src/prompts/payments/explain-x402-settlement.prompt.ts"],"names":[],"mappings":"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"}

package/dist/prompts/payments/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Payments prompts barrel export.
+ */
+export { createPaidApiPrompt } from './create-paid-api.prompt.js';
+export { explainX402SettlementPrompt } from './explain-x402-settlement.prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/payments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompts/payments/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/prompts/payments/index.js

@@ -0,0 +1,6 @@
+/**
+ * Payments prompts barrel export.
+ */
+export { createPaidApiPrompt } from './create-paid-api.prompt.js';
+export { explainX402SettlementPrompt } from './explain-x402-settlement.prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/payments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/payments/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/prompts/register-prompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Register all MCP prompts
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../core/types.js';
+/**
+ * Register all prompts with the MCP server
+ */
+export declare function registerPrompts(server: Server, context: SapMcpContext): Promise<void>;
+//# sourceMappingURL=register-prompts.d.ts.map

package/dist/prompts/register-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-prompts.d.ts","sourceRoot":"","sources":["../../src/prompts/register-prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAqBtD;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB3F"}

package/dist/prompts/register-prompts.js

@@ -0,0 +1,40 @@
+/**
+ * Register all MCP prompts
+ */
+import { logger } from '../core/logger.js';
+// Registry prompts
+import { registerSapAgentPrompt } from './registry/register-sap-agent.prompt.js';
+import { analyzeSapAgentPrompt } from './registry/analyze-sap-agent.prompt.js';
+// Developer prompts
+import { generateSapIntegrationPrompt } from './developer/generate-sap-integration.prompt.js';
+import { debugSapErrorPrompt } from './developer/debug-sap-error.prompt.js';
+// Payments prompts
+import { explainX402SettlementPrompt } from './payments/explain-x402-settlement.prompt.js';
+import { createPaidApiPrompt } from './payments/create-paid-api.prompt.js';
+// Execution-proof prompts
+import { explainProofOfExecutionPrompt } from './execution-proof/explain-proof-of-execution.prompt.js';
+import { verifyExecutionProofPrompt } from './execution-proof/verify-execution-proof.prompt.js';
+// Context prompts
+import { sapAgentContextPrompt } from './context/sap-agent-context.prompt.js';
+/**
+ * Register all prompts with the MCP server
+ */
+export async function registerPrompts(server, context) {
+    logger.info('Registering prompts');
+    // Register all SAP prompts
+    registerSapAgentPrompt(server, context);
+    analyzeSapAgentPrompt(server, context);
+    // Register developer prompts
+    generateSapIntegrationPrompt(server, context);
+    debugSapErrorPrompt(server, context);
+    // Register payments prompts
+    explainX402SettlementPrompt(server, context);
+    createPaidApiPrompt(server, context);
+    // Register execution-proof prompts
+    explainProofOfExecutionPrompt(server, context);
+    verifyExecutionProofPrompt(server, context);
+    // Register context prompts
+    sapAgentContextPrompt(server, context);
+    logger.info('Prompts registered', { count: 9 });
+}
+//# sourceMappingURL=register-prompts.js.map

package/dist/prompts/register-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-prompts.js","sourceRoot":"","sources":["../../src/prompts/register-prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,oBAAoB;AACpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,mBAAmB;AACnB,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,0BAA0B;AAC1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wDAAwD,CAAC;AACvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAEhG,kBAAkB;AAClB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,OAAsB;IAC1E,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAEnC,2BAA2B;IAC3B,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,6BAA6B;IAC7B,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,4BAA4B;IAC5B,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,mCAAmC;IACnC,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/prompts/registry/analyze-sap-agent.prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Analyze SAP Agent Prompt
+ *
+ * Analyzes SAP agent registration, capabilities, and reputation.
+ * REAL IMPLEMENTATION — Comprehensive analysis workflow
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * Executes the analyze sap agent prompt operation.
+ */
+export declare function analyzeSapAgentPrompt(server: Server, _context: SapMcpContext): void;
+//# sourceMappingURL=analyze-sap-agent.prompt.d.ts.map

package/dist/prompts/registry/analyze-sap-agent.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-sap-agent.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/registry/analyze-sap-agent.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,QA6J5E"}

package/dist/prompts/registry/analyze-sap-agent.prompt.js

@@ -0,0 +1,85 @@
+/**
+ * Analyze SAP Agent Prompt
+ *
+ * Analyzes SAP agent registration, capabilities, and reputation.
+ * REAL IMPLEMENTATION — Comprehensive analysis workflow
+ */
+import { registerPrompt } from '../../adapters/mcp/sdk-compat.js';
+import { logger } from '../../core/logger.js';
+/**
+ * Executes the analyze sap agent prompt operation.
+ */
+export function analyzeSapAgentPrompt(server, _context) {
+    registerPrompt(server, 'analyze-sap-agent', {}, {
+        description: 'Analyze SAP agent registration, capabilities, reputation, and on-chain activity',
+        arguments: [
+            {
+                name: 'agentWallet',
+                description: 'Agent wallet address to analyze',
+                required: true,
+            },
+            {
+                name: 'includeTransactions',
+                description: 'Include transaction history: "yes", "no" (default: "no")',
+                required: false,
+            },
+            {
+                name: 'detailed',
+                description: 'Include detailed PDA analysis: "yes", "no" (default: "no")',
+                required: false,
+            },
+        ],
+    }, async (args) => {
+        const agentWallet = args.agentWallet;
+        const includeTransactions = args.includeTransactions === 'yes';
+        const detailed = args.detailed === 'yes';
+        logger.info('Analyzing SAP agent', { agentWallet, includeTransactions, detailed });
+        const content = [
+            '# SAP Agent Analysis Report',
+            '',
+            '## Agent Identity',
+            '',
+            '**Wallet**: `' + agentWallet + '`',
+            '',
+            '## Registration Status',
+            '',
+            'To verify agent registration on SAP Protocol:',
+            '',
+            '```bash',
+            '# Fetch agent PDA',
+            'solana program-accounts SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ \\',
+            '  --filter "base58:' + agentWallet + '" \\',
+            '  --output json',
+            '```',
+            '',
+            '## Capabilities Analysis',
+            '',
+            'Registered capabilities determine what tools the agent can execute:',
+            '',
+            '### Tool Categories',
+            '',
+            '- **SAP Protocol Tools** (74 tools): Identity, Registry, Reputation, Memory, Payments, Proof',
+            '- **Synapse AgentKit Tools** (110 tools): Tokens, NFTs, DAS, DeFi, ecosystem integrations, Blinks',
+            '- **Transaction Tools** (4 tools): Decode, preview, sign, and submit serialized Solana transactions',
+            '',
+        ];
+        if (detailed) {
+            content.push('## PDA Analysis', '', 'Agent PDAs derived from wallet:', '', '```', 'Agent PDA: ["sap_agent", ' + agentWallet + ']', 'Memory PDA: ["sap_memory", ' + agentWallet + ']', 'Reputation PDA: ["sap_reputation", ' + agentWallet + ']', '```', '', 'To fetch PDA data:', '', '```bash', '# Agent account', 'solana account <AGENT_PDA> --output json', '', '# Memory vault', 'solana account <MEMORY_PDA> --output json', '', '# Reputation', 'solana account <REPUTATION_PDA> --output json', '```', '');
+        }
+        if (includeTransactions) {
+            content.push('## Transaction History', '', 'Recent agent activity on-chain:', '', '```bash', '# Get transaction history', 'solana signatures ' + agentWallet + ' --limit 50', '', '# Analyze specific transaction', 'solana transaction <SIGNATURE> --output json', '```', '', '### Key Metrics', '', '- Total transactions: (fetch from RPC)', '- Agent registrations: (count from SAP program)', '- Tool executions: (count execution proofs)', '- Payments settled: (sum x402 escrows)', '');
+        }
+        content.push('## Reputation Score', '', 'Agent reputation based on:', '- **Execution success rate**: % of successful tool calls', '- **Payment history**: Settled vs disputed payments', '- **User ratings**: Feedback from citizens/merchants', '- **Attestations**: Third-party verifications', '', '### Reputation Tiers', '', '| Tier | Score | Benefits |', '|------|-------|----------|', '| Bronze | 0-100 | Basic access |', '| Silver | 100-500 | Reduced fees |', '| Gold | 500-1000 | Priority support |', '| Platinum | 1000+ | Premium features |', '', '## Security Checks', '', 'Before interacting with this agent:', '', '1. ✅ **Verify registration** on SAP Protocol', '2. ✅ **Check reputation score** and history', '3. ✅ **Review tool permissions** and capabilities', '4. ✅ **Validate payment terms** (if applicable)', '5. ✅ **Test with small amount** first', '', '## Next Steps', '', '- Register as agent: `npx sap-mcp-config wizard`', '- View capabilities: `sap://registry/agent/' + agentWallet + '`', '- Check reputation: `sap://reputation/' + agentWallet + '`', '- Analyze memory: `sap://memory/' + agentWallet + '`');
+        return {
+            messages: [{
+                    role: 'assistant',
+                    content: {
+                        type: 'text',
+                        text: content.join('\n'),
+                    },
+                }],
+        };
+    });
+    logger.info('Analyze SAP Agent prompt registered');
+}
+//# sourceMappingURL=analyze-sap-agent.prompt.js.map

package/dist/prompts/registry/analyze-sap-agent.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-sap-agent.prompt.js","sourceRoot":"","sources":["../../../src/prompts/registry/analyze-sap-agent.prompt.ts"],"names":[],"mappings":"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"}

package/dist/prompts/registry/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Registry prompts barrel export.
+ */
+export { analyzeSapAgentPrompt } from './analyze-sap-agent.prompt.js';
+export { registerSapAgentPrompt } from './register-sap-agent.prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompts/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/prompts/registry/index.js

@@ -0,0 +1,6 @@
+/**
+ * Registry prompts barrel export.
+ */
+export { analyzeSapAgentPrompt } from './analyze-sap-agent.prompt.js';
+export { registerSapAgentPrompt } from './register-sap-agent.prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/registry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/prompts/registry/register-sap-agent.prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Register SAP Agent Prompt
+ *
+ * Guides users through SAP agent registration process.
+ * REAL IMPLEMENTATION — Step-by-step wizard
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * Executes the register sap agent prompt operation.
+ */
+export declare function registerSapAgentPrompt(server: Server, _context: SapMcpContext): void;
+//# sourceMappingURL=register-sap-agent.prompt.d.ts.map

package/dist/prompts/registry/register-sap-agent.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-sap-agent.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/registry/register-sap-agent.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,QAyM7E"}