@kya-os/mcp-i 0.1.0-alpha.2.9 → 0.1.0-alpha.3.0

package/dist/esm/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @kya-os/mcp-i - Optimized MCP Identity with production features
+ *
+ * Enable any MCP server to get a verifiable identity with just 2 lines of code:
+ *
+ * ```typescript
+ * import "@kya-os/mcp-i/auto";  // That's it! Your server now has identity
+ * ```
+ */
+import { MCPIdentityOptions, Challenge, ChallengeResponse, MCPICapabilities, SignedResponse, MCPMiddleware, DirectoryPreference } from './types';
+import { KeyRotationResult, KeyHealth } from './rotation';
+export * from './types';
+export * from './vercel-adapter';
+export { RegistryFactory, REGISTRY_TIERS, resolveRegistries } from './registry';
+export { LoggerFactory, ConsoleLogger, SilentLogger } from './logger';
+export { StorageFactory, MemoryStorage, FileStorage } from './storage';
+export { TransportFactory, RuntimeDetector } from './transport';
+export { KeyRotationManager } from './rotation';
+export { initWithDevExperience, showAgentStatus } from './dev-helper';
+export declare class MCPIdentity {
+    readonly did: string;
+    readonly publicKey: string;
+    private privateKey;
+    private timestampTolerance;
+    private enableNonceTracking;
+    private usedNonces;
+    private nonceCleanupInterval?;
+    private encryptionPassword?;
+    private decryptedPrivateKey?;
+    private directories;
+    private storage;
+    private transport;
+    private logger;
+    private rotationManager?;
+    private precomputed;
+    private constructor();
+    /**
+     * Initialize MCP Identity - the main entry point
+     */
+    static init(options?: MCPIdentityOptions): Promise<MCPIdentity>;
+    /**
+     * Enable automatic key rotation
+     */
+    enableAutoRotation(policy?: {
+        maxAge?: number;
+        maxSignatures?: number;
+    }): Promise<void>;
+    /**
+     * Manually rotate keys
+     */
+    rotateKeys(reason?: string): Promise<KeyRotationResult>;
+    /**
+     * Check key health
+     */
+    checkKeyHealth(): KeyHealth | null;
+    /**
+     * Get decrypted private key (lazy decryption)
+     */
+    private getPrivateKey;
+    /**
+     * Sign a message with caching
+     */
+    sign(message: string | Buffer): Promise<string>;
+    /**
+     * Request edit access with claim URL support
+     */
+    requestEditAccess(): Promise<{
+        editUrl: string;
+        claimUrl?: string;
+    }>;
+    /**
+     * Verify a signature
+     */
+    verify(message: string | Buffer, signature: string, publicKey?: string): Promise<boolean>;
+    /**
+     * Respond to an MCP-I challenge
+     */
+    respondToChallenge(challenge: Challenge): Promise<ChallengeResponse>;
+    /**
+     * Get MCP-I capabilities for advertisement
+     */
+    getCapabilities(): MCPICapabilities;
+    /**
+     * Sign an MCP response with identity metadata
+     */
+    signResponse<T = any>(response: T): Promise<SignedResponse<T>>;
+    /**
+     * Generate a new nonce for challenges
+     */
+    static generateNonce(): string;
+    /**
+     * Get directory preferences
+     */
+    getDirectories(): DirectoryPreference;
+    /**
+     * Clean up old nonces periodically to prevent memory leaks
+     */
+    private startNonceCleanup;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+    /**
+     * Helper to extract agent name from DID
+     */
+    private extractAgentName;
+    /**
+     * Helper to extract agent ID
+     */
+    private extractAgentId;
+    /**
+     * Helper to extract agent slug
+     */
+    private extractAgentSlug;
+    /**
+     * Persist full identity (for key rotation)
+     */
+    private persistIdentity;
+}
+/**
+ * Enable MCP Identity for any MCP server
+ */
+export declare function enableMCPIdentity(options?: MCPIdentityOptions): Promise<MCPIdentity>;
+/**
+ * Create MCP middleware for manual integration
+ */
+export declare function createMCPMiddleware(identity: MCPIdentity): MCPMiddleware;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

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