Index: oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java
===================================================================
--- oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java	(revision 0)
+++ oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java	(working copy)
@@ -0,0 +1,31 @@
+package org.apache.jackrabbit.oak.api;
+
+/**
+ * This exception can be thrown by implementers of this API to signal an error
+ * condition caused by an invalid state of the repository.
+ * <p>
+ * It's up to the implementation to distinguish between recoverable and
+ * unrecoverable error conditions. In case of recoverable error conditions, it's
+ * appropriate for an implementation to create a subclass of this exception and
+ * expose that subclass as part of its public API. This way, clients of the
+ * Content Repository API can catch specific failures, provided that they also
+ * want to introduce a dependency to the implementation's API.
+ */
+public class IllegalRepositoryStateException extends RuntimeException {
+
+    public IllegalRepositoryStateException() {
+    }
+
+    public IllegalRepositoryStateException(String message) {
+        super(message);
+    }
+
+    public IllegalRepositoryStateException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    public IllegalRepositoryStateException(Throwable cause) {
+        super(cause);
+    }
+
+}
Index: oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java
===================================================================
--- oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java	(revision 1718612)
+++ oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java	(working copy)
@@ -18,7 +18,7 @@
 /**
  * Oak repository API
  */
-@Version("3.0.0")
+@Version("3.1.0")
 @Export(optional = "provide:=true")
 package org.apache.jackrabbit.oak.api;