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

package/dist/config/setup.js

@@ -0,0 +1,173 @@
+import { existsSync, writeFileSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { dirname, join } from 'path';
+import { mkdirSync } from 'fs';
+import { Keypair } from '@solana/web3.js';
+import { defaultGeneratedWalletPath, ensureConfigDirectories } from './paths.js';
+import { defaults } from './defaults.js';
+import { getProfileConfigPath, loadProfileConfig, saveProfileConfig, setActiveProfile } from './profiles.js';
+const PROFILE_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function parseWizardMode(mode) {
+    if (mode === 'readonly'
+        || mode === 'local-dev-keypair'
+        || mode === 'external-signer'
+        || mode === 'delegated-session'
+        || mode === 'hosted-api') {
+        return mode;
+    }
+    throw new Error(`Unsupported SAP MCP mode: ${mode}`);
+}
+function parseLogLevel(logLevel) {
+    if (logLevel === 'debug' || logLevel === 'info' || logLevel === 'warn' || logLevel === 'error') {
+        return logLevel;
+    }
+    throw new Error(`Unsupported SAP MCP log level: ${logLevel}`);
+}
+/**
+ * Normalizes and validates wizard profile names before they are used for file paths.
+ */
+function resolveWizardProfileName(profileName) {
+    const normalized = profileName?.trim().toLowerCase();
+    if (!normalized) {
+        throw new Error('Profile name is required. Use a descriptive name such as "gianni-market-nft-agent".');
+    }
+    if (normalized === 'default') {
+        throw new Error('The wizard requires a named profile. Use a descriptive name instead of "default".');
+    }
+    if (!PROFILE_NAME_PATTERN.test(normalized)) {
+        throw new Error('Profile name may contain lowercase letters, numbers, and single hyphens between words.');
+    }
+    return normalized;
+}
+/**
+ * Expands user-friendly wallet paths before saving them into profile config.
+ */
+function normalizeWizardPath(path) {
+    if (!path) {
+        return undefined;
+    }
+    if (path === '~') {
+        return homedir();
+    }
+    if (path.startsWith('~/')) {
+        return join(homedir(), path.slice(2));
+    }
+    return path;
+}
+/**
+ * Writes a new dedicated Solana keypair if the target wallet path does not already exist.
+ */
+function writeGeneratedWallet(walletPath) {
+    if (existsSync(walletPath)) {
+        return;
+    }
+    mkdirSync(dirname(walletPath), { recursive: true, mode: 0o700 });
+    const keypair = Keypair.generate();
+    writeFileSync(walletPath, JSON.stringify(Array.from(keypair.secretKey)), {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+    chmodSync(walletPath, 0o600);
+}
+/**
+ * Converts wizard answers into a complete, schema-valid runtime config object.
+ */
+export function buildWizardConfig(input) {
+    const now = new Date().toISOString();
+    const mode = parseWizardMode(input.mode);
+    const logLevel = parseLogLevel(input.logLevel);
+    const profileName = resolveWizardProfileName(input.profileName);
+    const walletPath = input.createNewWallet
+        ? defaultGeneratedWalletPath(profileName)
+        : normalizeWizardPath(input.walletPath);
+    return {
+        mode,
+        rpcUrl: input.rpcUrl,
+        commitment: defaults.commitment,
+        programId: defaults.programId,
+        maxRetries: defaults.maxRetries,
+        retryDelayMs: defaults.retryDelayMs,
+        walletPath,
+        walletEncrypted: false,
+        externalSignerUrl: input.externalSignerUrl,
+        externalSignerTimeoutMs: defaults.externalSignerTimeoutMs,
+        enableHttp: input.enableHttp ?? mode === 'hosted-api',
+        httpPort: input.httpPort ?? defaults.httpPort,
+        httpHost: defaults.httpHost,
+        maxTxValueSol: input.maxTxValueSol,
+        requireApprovalAboveSol: Math.min(defaults.requireApprovalAboveSol, input.maxTxValueSol || defaults.requireApprovalAboveSol),
+        dailyLimitSol: input.dailyLimitSol,
+        allowedTools: 'all',
+        logLevel,
+        logFormat: defaults.logFormat,
+        enableMetrics: input.enableMetrics,
+        metricsPort: defaults.metricsPort,
+        enableCache: defaults.enableCache,
+        cacheTtlSeconds: defaults.cacheTtlSeconds,
+        enableRateLimit: defaults.enableRateLimit,
+        rateLimitPerMinute: defaults.rateLimitPerMinute,
+        bento: {
+            enabled: input.enableBento,
+            apiKey: input.enableBento ? input.bentoApiKey : undefined,
+            agentId: input.enableBento ? input.bentoAgentId : undefined,
+        },
+        policy: {
+            mode: input.enableBento ? 'hybrid' : 'local-only',
+            failOpen: false,
+            logging: true,
+        },
+        $security: {
+            requireApprovalFor: ['mode', 'walletPath', 'externalSignerUrl', 'maxTxValueSol', 'dailyLimitSol'],
+            approvalTimeout: 300,
+            maxChangesPerDay: 10,
+            requireMultiSig: false,
+        },
+        $audit: {
+            enabled: true,
+            retentionDays: 90,
+            submitToOracle: false,
+        },
+        $meta: {
+            version: '1.0.0',
+            createdAt: now,
+            updatedAt: now,
+            lastHash: '',
+        },
+    };
+}
+/**
+ * Persists wizard output to the preferred config directory and creates a dedicated wallet when requested.
+ */
+export async function saveWizardSetup(input) {
+    ensureConfigDirectories();
+    const profileName = resolveWizardProfileName(input.profileName);
+    const walletPath = input.createNewWallet
+        ? defaultGeneratedWalletPath(profileName)
+        : normalizeWizardPath(input.walletPath);
+    const walletCreated = Boolean(input.createNewWallet && walletPath && !existsSync(walletPath));
+    if (input.createNewWallet && walletPath) {
+        writeGeneratedWallet(walletPath);
+    }
+    const config = buildWizardConfig({ ...input, walletPath });
+    // Extract and store agent pubkey
+    if (walletPath && existsSync(walletPath)) {
+        try {
+            const { loadKeypairFromFile } = await import('../signer/load-keypair.js');
+            const keypair = loadKeypairFromFile(walletPath);
+            config.agentPubkey = keypair.publicKey.toBase58();
+        }
+        catch (error) {
+            console.warn('Could not load pubkey from wallet:', error instanceof Error ? error.message : error);
+        }
+    }
+    await saveProfileConfig(profileName, config);
+    setActiveProfile(profileName);
+    const savedConfig = loadProfileConfig(profileName) ?? config;
+    return {
+        config: savedConfig,
+        configPath: getProfileConfigPath(profileName),
+        walletPath,
+        walletCreated,
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/config/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/config/setup.ts"],"names":[],"mappings":"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"}

package/dist/config/wizard.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * SAP MCP Server - Configuration Wizard
+ *
+ * Interactive wizard for initial configuration setup.
+ * Guides users through secure configuration with explanations.
+ *
+ * Usage:
+ *   npx sap-mcp-config wizard
+ */
+/**
+ * Executes the run wizard operation.
+ */
+export declare function runWizard(): Promise<void>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/config/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/config/wizard.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAwyCH;;GAEG;AACH,wBAAsB,SAAS,kBAmG9B"}