--- a/intentmademanifest/api.py	Sun Apr 07 03:29:48 2013 -0700
+++ b/intentmademanifest/api.py	Sun Apr 07 13:51:29 2013 -0700
@@ -21,5 +21,17 @@
 
     def state(self):
         """
-        current state
+        current state;
+        returns the current state object
         """
+
+class State(object):
+    """a state"""
+
+    def __init__(self, *transitions):
+
+    def available():
+        """avalable transitions"""
+
+    def transit():
+        """invoke a transition"""