feat: add python SDK examples and CLI tool for managing them

Author: bchampp

.github/model/lambda.json

@@ -2750,8 +2750,8 @@
         "DurableExecutionName":{"shape":"DurableExecutionName"},
         "FunctionArn":{"shape":"FunctionArn"},
         "Status":{"shape":"ExecutionStatus"},
-        "StartDate":{"shape":"ExecutionTimestamp"},
-        "StopDate":{"shape":"ExecutionTimestamp"}
+        "StartTimestamp":{"shape":"ExecutionTimestamp"},
+        "EndTimestamp":{"shape":"ExecutionTimestamp"}
       }
     },
     "ExecutionStatus":{
@@ -3676,7 +3676,6 @@
       },
       "documentation":"<p>Response to GetFunctionConfiguration request.</p>"
     },
-    "Integer":{"type":"integer"},
     "InvalidCodeSignatureException":{
       "type":"structure",
       "members":{
@@ -6319,9 +6318,9 @@
         "FunctionArn":{"shape":"FunctionArn"},
         "InputPayload":{"shape":"InputPayload"},
         "Status":{"shape":"ExecutionStatus"},
-        "StartDate":{"shape":"ExecutionTimestamp"},
-        "StopDate":{"shape":"ExecutionTimestamp"},
-        "ResultPayload":{"shape":"ResultPayload"},
+        "StartTimestamp":{"shape":"ExecutionTimestamp"},
+        "EndTimestamp":{"shape":"ExecutionTimestamp"},
+        "Result":{"shape":"ResultPayload"},
         "ErrorPayload":{"shape":"ErrorPayload"}
       }
     },
@@ -6451,12 +6450,6 @@
         "Error":{"shape":"ErrorObject"}
       }
     },
-    "WaitCancelledDetails":{
-      "type":"structure",
-      "members":{
-        "Error":{"shape":"EventError"}
-      }
-    },
     "WaitDetails":{
       "type":"structure",
       "members":{

.github/workflows/deploy-examples.yml

@@ -29,3 +29,6 @@ dist/
 .kiro/
 .idea
 .env
+
+examples/build/*
+examples/*.zip

.gitignore

@@ -121,6 +121,47 @@ Mimic the package structure in the src/aws_durable_execution_sdk_python director
 Name your module so that src/mypackage/mymodule.py has a dedicated unit test file
 tests/mypackage/mymodule_test.py
 
+## Examples and Deployment
+
+The project includes a unified CLI tool for managing examples, deployment, and AWS account setup:
+
+### Bootstrap AWS Account
+```bash
+# Set up IAM role and KMS key for durable functions
+export AWS_ACCOUNT_ID=your-account-id
+hatch run examples:bootstrap
+```
+
+### Build and Deploy Examples
+```bash
+# Build all examples with dependencies
+hatch run examples:build
+
+# Generate SAM template for all examples
+hatch run examples:generate-sam
+
+# List available examples
+hatch run examples:list
+
+# Deploy specific example (when durable functions are available)
+hatch run examples:deploy "Hello World"
+```
+
+### Other CLI Commands
+```bash
+# Invoke deployed function
+hatch run examples:invoke function-name --payload '{}'
+
+# Get execution details
+hatch run examples:get execution-arn
+
+# Get execution history
+hatch run examples:history execution-arn
+
+# Clean build artifacts
+hatch run examples:clean
+```
+
 ## Coverage
 ```
 hatch run test:cov